Data Selector
The data point selector shows all data points available in the project, grouped under their respective master data point structures. For ease of handling, the respective data point type is shown beside the address. Selecting one data point will open the selection for available widgets. Not all widgets are usable for all data point types (e.g.: only the label widget can be used for string data types).
In a distributed system not all search requests within the Dashboard Data Selector will return the expected results. In some case existing data points (elements) are not returned.
The search function in the Data Selector will take one or multiple of the following parameters:
- pattern
- The search pattern. If this does not contain a '*' or '?', the pattern will be enclosed in asterisks (e. g. "*pattern*")
- areas (optional)
- An array of areas where search should be done. The search will be done in the
order of the values in the array, which can be one or more of:
- "DP"
- search in data point and data point element names (case insensitive)
- "alias"
- search in data point aliases (case sensitive)
- "CNS"
- search in CNS IDs and descriptions (case insensitive)
- default
- all areas in the following order: [ "DP", "alias", "CNS" ]
- maxResults (optional)
- The maximum number of results to return (default: 500)
- internal (optional)
- If this paramter is given as true, the data point and data point element name search will also include internal data points.
- locale
- The locale of the CNS names which will be searched and returned. This is required if "areas" includes "CNS.
The result will contain one result array per area in the request. In addition, if the result contains "DP", it will also contain "DPT" which contains all data point types used by the data points listed in "DP". If the result contains "alias", it will also contain "DPT_alias", which contains all data point types for the data points listed in "alias".
