Расширенная настройка > Использование повторно используемых компонентов > Доступные повторно используемые компоненты > Идентификация элементов
  
Идентификация элементов
Определение и использование
Повторно используемый компонент "Идентификация элементов" - это виджет, позволяющий отображать для конкретного элемента базовую информацию, также называемую идентифицирующей информацией. Эта информация отображается на панели, как правило, в верхней части страницы элемента. Панель содержит основной заголовок, дополнительный заголовок и различные атрибуты реквизитов элемента. Она также содержит встроенную панель действий, отображающую действия, которые можно выполнить с данным элементом. Панель "Идентификация элементов" можно развернуть или свернуть с помощью стрелки в верхней левой части панели. Если панель свернута, видны только основной заголовок и панель действий.
Можно сконфигурировать повторно используемый компонент "Идентификация элементов" следующими способами.
• Задать атрибуты идентификации, которые должны отображаться
• Сконфигурировать действия, доступные на встроенной панели действий
• Задать основной и дополнительный заголовки
На приведенном ниже изображении показан повторно используемый компонент "Идентификация элементов".
Реквизиты задания - единственная предопределенная конфигурация, доступная для повторно используемого компонента "Идентификация элементов". Дополнительные сведения и пример конфигурации см. в разделе "Реквизиты задания".
Свойства привязки
Для компонента "Идентификация элементов" существует два свойства, доступных для привязки:
• Input - этот объект JSON представляет собой ИД входного параметра, для которого необходимо получить данные из серверной системы. Эта информация должна быть указана в формате CCO (Common Communication Object). Ниже приведен пример:
{
"version":"1.0.0",
"data":[
{
"adapter":{
"thingName":"PTC.WCAdapter",
"instanceName":"windchill"
},
"itemListsData":[
{
"objectType":"PTC.ChangeMgmt.ChangeRequest",
"items":[
{
"id":{
"value":"OR:wt.change2.WTChangeRequest2:439476"
}
}
]
}
]
}
]
}
• TailoringName - эта строка представляет собой имя экземпляра компонента. Оно тесно связано с процессом настройки. TailoringName - используется для получения сохраненной информации о настройке для каждого компонента.
Поля конфигурации
В следующей таблице приведены поля JSON, используемые для конфигурирования этого компонента.
Имя свойства
Описание
Тип
Значение по умолчанию
Обязательное или необязательное
attributes
Наименования свойств, для которых ожидается поступление данных из серверной системы. См. подсвойства:
MultiValueSelector
Н/Д
Необязательное
id
ИД наименования свойства атрибута в серверной системе. Например: “Category#Display”.
Строка
""
Обязательное
ordinal
Порядок, в котором атрибуты отображаются в компоненте. 0 обозначает самую левую начальную позицию.
Целое число
Н/Д
Необязательное
objectType
Тип объекта, для которого необходимо получить атрибуты.
Строка
""
Обязательное
adapter
Исходная конфигурация для серверной системы. См. подсвойства:
JSON
Н/Д
Обязательное
instanceName
Экземпляр соединителя, то есть соединитель, который должен использоваться для соединения с серверной системой.
Строка
""
Обязательное
thingName
Наименование серверной системы или адаптера, из которого загружаются данные.
Строка
""
Обязательное
inTailoring
Показывает, доступен ли компонент "Идентификация элементов" для настройки на странице настройки. Опции: true, false.
Логический
false
Необязательное
title
Основной заголовок, который отображается в верхней части панели "Идентификация элементов". См. подсвойства:
Н/Д
Н/Д
Обязательное
pattern
Строка, которая отображается как основной заголовок в интерфейсе пользователя компонента. Массив содержит числовые идентификаторы, которые заменяются динамически. Каждый числовой идентификатор в строке соответствует одному из наименований свойств, заданных в поле id.
Строка
""
Обязательное
id
ИД наименования свойства атрибута в серверной системе. Например: “Subject|SubjectName”.
Строка
""
Обязательное
numericIdentifier
Для каждого id существует числовой идентификатор. Числовой идентификатор заменяется в строке массива значением, загруженным для id.
Целое число
1
Обязательное
objectType
Тип объекта, для которого необходимо получить атрибуты.
Строка
""
Обязательное
adapter
Исходная конфигурация для серверной системы. См. подсвойства:
adapter
Н/Д
Обязательное
instanceName
Экземпляр соединителя, то есть соединитель, который должен использоваться для соединения с серверной системой.
Строка
""
Обязательное
thingName
Наименование серверной системы или адаптера, из которого загружаются данные.
Строка
""
Обязательное
secondaryTitle
Дополнительный заголовок, который отображается под основным заголовком на панели "Реквизиты объекта". См. подсвойства:
Н/Д
Н/Д
Обязательное
pattern
Строка, которая отображается как дополнительный заголовок в интерфейсе пользователя компонента. Массив содержит числовые идентификаторы, которые заменяются динамически. Каждый числовой идентификатор в строке соответствует одному из наименований свойств, заданных в поле id.
Строка
""
Обязательное
id
ИД наименования свойства атрибута в серверной системе. Например: “Activity|Name”.
Строка
""
Обязательное
numericIdentifier
Для каждого id существует числовой идентификатор. Числовой идентификатор заменяется в строке массива значением, загруженным для id.
Целое число
1
Обязательное
objectType
Тип объекта, для которого необходимо получить атрибуты.
Строка
""
Обязательное
adapter
Исходная конфигурация для серверной системы. См. подсвойства:
adapter
Н/Д
Обязательное
instanceName
Экземпляр соединителя, то есть соединитель, который должен использоваться для соединения с серверной системой.
Строка
""
Обязательное
thingName
Наименование серверной системы или адаптера, из которого загружаются данные.
Строка
""
Обязательное
modelThing
См. подсвойства:
Н/Д
Н/Д
Обязательное
entityName
Наименование вещи модели, получающей эти данные.
Строка
"PTC.ItemIdentity
ModelThing"
Обязательное
version
Версия конфигурации.
Строка
"1.0.0"
Необязательное
actions
Действия, которые должны отображаться на панели действий в интерфейсе пользователя. Дополнительные сведения, в том числе о подсвойствах, см. в описании повторно используемого компонента Панель действий.
Н/Д
Н/Д
Необязательное
Пример конфигурации
В следующем примере конфигурации JSON используется конфигурация по умолчанию компонента "Идентификация элементов".
{
"secondaryTitle": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": ""
}
],
"objectType": ""
},
{
"items": [
{
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
},
"inTailoring": true
},
"title": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"actions": {
"maxItemsToShow": {
"value": 2
},
"modelThingName": {
"entityName": "PTC.ActionBarModel.Thing"
},
"actions": {
"selectedValues": {
"data": [
{
"itemListsData": [],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
}
},
"modelThing": {
"entityName": "PTC.ItemIdentityModelThing",
"version": "1.0.0"
}
}