Parameter Dashboard Item
The Parameter Dashboard Item is used to dynamically modify the data displayed by linked Retrievals in a Dashboard.
For example, a Traceability Parameter can be used to dynamically filter data to a particular shift, machine, or operator.
Settings
| Setting | Description |
|---|---|
| Label | The text to display next to the input control. |
| Script ID | Identifies how this item is referenced in Dashboard Scripts. |
| Type | The type of control to display. |
| Retrievals | Which Retrievals should be affected when the parameter's value is changed. |
| Filter | For Filter parameters, the Filter field to filter the data or standards. |
| Date | Whether Date parameters should display a single date or date range. Single Day date parameters will retrieve all data from the selected day, using the Global Setting for Start of Day Offset. Range date parameters allow the user to select the exact date and time range for retrieved data. |
Filter Parameters
Selecting Filter as the Parameter Type allows creating an additional filter which modifies how data is retrieved.
If no value has been selected for a Parameter, it will not modify the retrieval.
Standard Filters
If the field to filter by is Part, Process, or Characteristic, the Parameter will modify the Standard field of the selected retrievals.
Static Standards
When specific standards have been selected on a Retrieval, Parameters which filter by the same standard type will replace the selected standards.
For example, consider a Retrieval with the following Standards:
- 3" Bolt Part
- Final Inspection Process
If a Filter Parameter is set to filter by Part, and the user selects 5" Bolt , the Retrieval will return data matching:
- 5" Bolt Part
- Final Inspection Process
Filtered Standards
If the Retrieval is set to use a Standard Filter instead of selecting specific standards, data retrieved must match both the existing retrieval filter and the filter set on the Parameter.
Data Filters
All non-Standard filter fields act as an additional Data Filter. If a retrieval has an existing data filter set on it, data retrieved must match both the existing filter and the filter set on the Parameter.
For example, consider a Retrieval with an existing filter to retrieve data for:
- Cavity 4
- Machine HX 2000
If a Filter Parameter is set to filter by Shift, and the user selects Shift 1, the Retrieval will only return data matching all three conditions:
- Cavity 4
- Machine HX 2000
- Shift 1
Date Parameters
The Date Parameter type allows directly modifying the date of the retrieval. A Date parameter will always replace the date set on the Retrieval.
If the Date Type is set to Single Day, data will be shown for the entire day selected. This respects the Start of Day Offset.
If the Date Type is set to Range, the selected dates will be applied exactly as they input from by the User, with no modifications made for the Start of Day Offset.
Custom Parameters
Custom Parameters are used in Dashboards to gather custom input from the user, either as a free-form input or a dropdown list. Unlike other Parameter types, Custom Parameters do not automatically affect Retrievals. Instead, their values can be used in Dashboard scripts to implement custom behavior.
