[{"id":"a20f26ac-cd31-4e4d-9454-1e035b0f1587","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"3604b8ce-1da0-413f-8274-7df0f7173573","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"7fce7040-1bb1-4a61-9fb7-2e19d569de50","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"0eb72dd3-8f8f-4039-93a8-500bbde2301e","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"ac046cee-82b9-4edf-a642-ae6d7cb21ebf","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"75b66fd4-b740-443d-bc6e-1782048b60a6","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"dde44832-bb5c-45f3-8ebf-3badbc613cd9","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"43de3664-261b-4cf9-9945-fb519251f4c7","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"2f064d57-b088-4bc5-a628-4e0d7e1a0c65","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"f290406b-ced1-4c52-abad-979160a79f6b","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"1864834b-08ce-43f1-891b-c3cca6e04e95","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"f96cfec1-420c-4ca7-ab0a-cab482731073","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"3f2ea860-c764-43d8-ae3f-6e3b0314ce67","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"81eb70e8-f770-4384-9167-bc7c755ad052","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"d0dff477-9f56-483a-a9fc-cab648905b41","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"793a62d7-460d-4699-9304-edb2941268ac","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"2d6ebfad-f7d1-4cc5-8ba1-fdace3472056","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"c8c7b5d5-f5bd-4b68-a12f-3aae9804a844","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"577a09da-dea1-42db-812f-4eeaa9274ece","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"8ddd80d5-886f-41b8-8e3f-f73aa8146c8d","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"e0909540-8bde-4587-bb4d-02445746db2a","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"464b8e03-462d-4aed-8818-05d32ec3bf00","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"f235557b-9781-471f-bf03-38bae6e3e953","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"fd5d021d-0210-4d74-ba42-1a39ef14a385","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"548568fe-dbd1-4da5-a489-d9b3edf75329","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"a0c823ed-e22b-493b-aded-4d201c0fa480","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"d19bc9cd-ff53-4b0d-ab7e-a68c1497c4c6","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"94759fce-692f-4779-b5f3-fce5c58f242c","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"27658163-a479-432f-a192-dbed286beb3e","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]}]
When creating a parameter, its Data Type
specifies the kind of values that the parameter can contain. Any non-hidden parameters can have their values adjusted by a report reader through the Parameters Panel located in the Report Viewer component. Each data type comes with a default editor:
Boolean
parameters use radio buttons.
Date
and DateTime
parameters utilize a calendar control.
Integer
, String
, and Float
parameters use a textbox.
You have the ability to construct a custom parameters view. This will be displayed in the Parameters Panel of the Report Viewer and is managed via the Parameters
tab of the Report Designer:
When a report contains parameters, you can begin crafting the parameters view by clicking on the Generate View
button situated on the toolbar. Alternatively, you can also use the Generate
button found in the prompt:
Executing this action will establish default editors for the report parameters along with a Preview
button. From here, you're able to configure these automatically generated controls or replace them with new ones by clicking or dragging and dropping items from the sidebar.
Once these controls are integrated into the parameters view, their properties can be adjusted using the Properties panel found on the designer's right side.
Each control features Location and Size
properties that can be altered either by manually moving the control with the mouse or keyboard, or by directly inputting the Left
, Top
, Width
, and Height
values in the Properties panel.
There are two types of layouts you can construct using controls:
Free-Form Layout: This layout allows you to manually set the location and size of each control.
Vertical Stack Layout: Controls are automatically arranged from top to bottom and resized. The only variable you can set is the order of the items.
You can set the controls order for the Vertical Stack Layout by clicking the Vertical Layout
button, located on the Parameters View toolbar.
The layout type selection depends on the location of the Parameters Panel in the Report Viewer Component:
If the location is set to top
or bottom
, the Free-Form Layout will be applied.
If the location is set to default
or auto
, the Vertical Stack Layout will be utilized.
The available controls can be categorized into two groups:
Editors
are linked to parameters and are utilized to set parameter values. All editors have the Label/Text
and the Label/Display
properties that determine the content and the position of the prompt that displays alongside the editor. The properties in the Bound Parameter
values allows setting the Default Value
, Nullable
, Allow Blank(for String parameters only)
and Multiline(for String parameters only)
properties for the bound parameter. Below you can find the detailed description of available editors and their properties.
Supplemental
controls Heading
, Plain Text
, and Button
serve to display additional information and perform actions.
Simple value editors facilitate the modification of parameter values that do not have pre-set Available Values
. This allows users to input any values they desire.
The Text Editor
provides an input box that is typically used for parameters of the String
type. However, by utilizing the Binding
property, it can be associated with any type of parameter, as numbers, boolean values, and date values can all be manually inputted. The Placeholder
property is used to display a prompt within the input box when it is empty.
The Number Editor
can be bound to parameters of Integer
and Float
types. The Type
property defines the editor type, allowing you to choose between an Up-Down editor
(default) or a Slider
. The Min
, Max
, and Step
properties can be set for both types of editors, defining the minimum value, maximum value, and increment of value when the up/down buttons are clicked or the slider is moved. The Up-Down
editor also supports manual value input, and a Placeholder
property can be defined to display a prompt within the input box when it's empty. If the Round Input To Step
flag is set, any manually entered value will be rounded to the nearest multiple of the step value.
The Boolean Editor
can be bound to a Boolean
type parameter. The Type
property determines the editor type, with Toggle
, Checkbox
, or Radio
as options. For the Checkbox
, you can define the Text
to be displayed next to the checkmark. For both Toggle
and Radio
, you can set the text for the True
and False
values. Additionally, the Radio
editor's Layout
can be set to either Horizontal
or Vertical
.
The Multivalue
Editor enables manual entry of values for multi-value parameters of any type. This editor is specifically applicable for parameters that do not have Available Values
configured.
The DateTime Editor
can be associated with parameters of Date
and DateTime
types. The only available editor for these types is a calendar.
Range editors enable users to define values for two distinct parameters, which represent the lower and upper boundaries of a range.
The Number Range
editor takes the form of a slider with two handles. It includes From
and To
binding properties that can be associated with Integer
and Float
parameters. The Min
, Max
, and Step
properties allow you to specify the minimum value, maximum value, and the value increment that occurs when adjusting the slider.
The Date Range
editor is a calendar feature allowing the selection of a Start Date
and an End Date
. These can be bound to their corresponding parameter values using the From
and To
properties. Additionally, the Max Range
property stipulates the maximum duration of the range, while the View Mode
property sets the scale of the range selection, available in days (default), months, or years.
Selection Editors are elements that present a list of options to the report reader. The reader can select one or multiple values from this list, depending on the Multivalue
flag of the bound parameter. Note that these editors are only applicable when the parameter has Available values
configured.
The List
Editor organizes the Available values
into a list, which can be arranged either horizontally or vertically. The choice between horizontal and vertical orientation can be made via the Layout
property. For horizontal lists, an additional property, Columns
, exists that determines how many columns the values will be divided into.
The Dropdown
Editor offers a dropdown-style presentation of the Available values
.
Supplemental controls include Heading
, Plain text
, and Button
.
The Heading
and Plain text
controls are used to display static text. These controls allow for the selection of four different color styles: Accent
, Error
, Warning
, or Default
. Additionally, the Heading
control can include a strikethrough line, and the Plain text
control can be configured to display multiple lines.
The Button
control serves to facilitate various actions. Preview
executes the report with the parameters as currently set. Reset
reverts the parameters to their default values. Clear
removes all values from the input controls.