Использование значения типа MultiValueSelector
В ThingWorx Navigate 8.5 можно конфигурировать повторно используемые компоненты, используя файл конфигурации JSON. В файле конфигурации многих компонентов используется тип значения MultiValueSelector для некоторых полей JSON. MultiValueSelector используется для получения неполного списка данных из списка доступных опций. Данные могут представлять элементы, атрибуты, действия или другие типы данных. В некоторых компонентах также используется тип значения MultiValueSetsSelector, в котором несколько раз используется тип MultiValueSelector для получения нескольких наборов данных.
Поля конфигурации
MultiValueSelector содержит четыре поля конфигурации, которые используются для уникальной идентификации конкретного фрагмента данных: thingName и instanceName - для идентификации экземпляра серверной системы, а также objectType и id - для идентификации данных. Кроме того, он содержит еще несколько необязательных полей.
Ниже приведены обязательные поля JSON в MultiValueSelector:
• thingName - наименование вещи адаптера, которая вызывает данные из серверной системы.
• instanceName - имя серверной системы, из которой вызываются данные.
• objectType - тип объекта, для которого вызываются данные.
• id - ИД данных, полученных из серверной системы.
Ниже приведены необязательные поля JSON в MultiValueSelector:
• additionalData - разрешает использование дополнительных полей JSON для конфигурации в дальнейшем. Разрешенные поля JSON зависят от конкретного повторно используемого компонента. См. пример конфигурации повторно используемого компонента, показывающий разрешенные дополнительные поля.
• inTailoring - определяет, можно ли настроить данные на странице настройки. Входной параметр может иметь значение true или false.
Пример конфигурации
Ниже приведен пример конфигурации, показывающий структуру MultiValueSelector. В нем также показано, как можно использовать поле порядкового номера для упорядочения данных, поступающих из различных серверных систем.
{
(optional "inTailoring": true)
"version": "1.0.0",
"selectedValues": {
"data": [{
"adapter": {
"thingName": "WindchillAdapterThing",
"instanceName": "JapanWindchill"
},
"itemListsData": [{
"objectType": "WT.PART.WTPart",
"items": [{
"id": "id/name of property",
"additionalData": {JSON representation of additional data, according to another definition in properties},
"ordinal": 1
},
{
"id": "id/name of property",
"additionalData": {JSON representation of additional data, according to another definition in properties},
"ordinal": 2
}]
}
},
{
"adapter": {
"thingName": "WindchillAdapterThing",
"instanceName": "UKWindchill"
},
"itemListsData": [{
"objectType": "WT.PART.WTPart",
"items": [{
"id": "id/name of property",
"additionalData": {JSON representation of additional data, according to another definition in properties},
"ordinal": 0
},
{
"id": "id/name of property",
"additionalData": {JSON representation of additional data, according to another definition in properties},
"ordinal": 3
}]
}]
}]
}
}