端点 tagging

简介

The goal of this feature is to allow dashboard definitions that can be used across multiple facilities, or even different clients, without the need to create independent copies. To achieve this, endpoint tags, or tags on the devices that contain them, are used to reference endpoints indirectly. The current option (reference to a specific endpoint) is maintained, and the ability to reference endpoints or groups of endpoints indirectly through tags is added.

The goal is to allow dashboard definitions that can be used across multiple facilities, or even different clients, without the need to create copies that involve additional effort and are then difficult to maintain.

选择ing an endpoint

To 选择 an endpoint in a widget, the following methods are available:

• Individual endpoint 选择ion (current method). In this case, a specific endpoint is chosen from the list, as is currently done. The widget is bound to the endpoint at dashboard design time, and will always refer to the specified endpoint. This type of 选择ion must not be allowed in global dashboards.
• Indirect 选择ion by tags (additional new method). In this case, a list of one or more tags is 输入ed, and the chosen endpoint is determined at runtime on the back-end (when viewing the dashboard) based on the 选择ed facility. The algorithm for choosing the endpoint to use is as follows:

1. First endpoint containing the specified tag, of the appropriate type, belonging to the current facility.
2. First endpoint containing the specified tag, of the appropriate type, belonging to any facility of the current client that the user has permission to access.
3. First endpoint containing the specified tag, of the appropriate type, belonging to any client that the user has permission to access.

NOTE: When "first endpoint" is mentioned in the paragraphs 上方, it refers to the first one meeting the condition, sorted by 端点 ID.

示例

1. 仪表盘 1 (any facility)
2. 小部件 1 - 传感器 containing the tag "temperature-sensor".
3. 小部件 2 - 传感器 containing the tag "humidity-sensor"
4. 小部件 3 - 传感器 containing the tag "people-counter"
5. Then, in each facility, only the appropriate tags need to be assigned:

• Assign the tag "temperature-sensor" to the temperature sensors in all 3 facilities.
• Assign the tag "humidity-sensor" to the humidity sensors in all 3 facilities.
• Assign the tag "people-counter" to the people counters in all 3 facilities.

By implementing the dashboard this way, the same dashboard can be used in any facility, and the dashboard content will automatically adapt when switching from one facility to another. Additionally, if an endpoint is removed and replaced by another in any facility, the dashboard will continue to work normally as long as the new endpoint receives the appropriate tags.