Атрибуты
Определение и использование
Компонент "Атрибуты" - это виджет, отображающий пары наименование-значение. Значение всегда отображается под именем. Можно отображать значения различных типов данных. Набор атрибутов может быть представлен в виде группы с использованием имени группы.
На приведенных ниже изображениях показан компонент "Атрибуты".
Атрибуты выбранной детали или выбранного документа отображаются на панели предварительного просмотра, расположенной в правой части экрана, как показано на следующем рисунке.
Компонент "Атрибуты" можно конфигурировать следующими способами.
• Определить атрибуты, которые должны отображаться.
• Задать компоновку и связанные настройки отображения.
• Определить заголовок для группы атрибутов; эта опция доступна только для групп атрибутов с вертикальной компоновкой.
• Добавить ссылку на одно из стандартных заданий для атрибута, используя декоратор. В настоящее время поддерживается только первый декоратор, найденный в списке декораторов.
Чтобы добавить ссылку на атрибут, в конфигурации добавьте в атрибут декоратор, содержащий appId и thingName (PTC.Nav.LinkToAppDecoratorThing). Например:
 | Начиная с версии Windchill Navigate 9.4.0, ключ decoratedType перемещен в ключ decoration в разделе metadata конфигурации. |
metadata: {
Number: {
"label": "Number",
"type": "STRING",
"decoration": {
"decoratedType": "HTML",
"decorators": [{
"thingName": "PTC.Nav.LinkToAppDecoratorThing",
"parameters": {
"appId": "PTC.Nav.ViewDesignFiles"
}
}]
}
Number: {
"label": "Number",
"type": "STRING",
"decoration": {
"decoratedType": "HTML",
"decorators": [{
"thingName": "PTC.Nav.LinkToAppDecoratorThing",
"parameters": {
"appId": "PTC.Nav.ViewDesignFiles"
}
}]
}
Можно перейти к следующим заданиям, используя соответствующие идентификаторы приложений, перечисленные ниже.
Задание | Идентификатор приложения |
|---|---|
НАБОР ЗАДАНИЙ ДЛЯ ДЕТАЛЕЙ | |
Просмотр файлов конструкции | PTC.Nav.ViewDesignFiles |
Просмотр чертежа | PTC.Nav.ViewDrawing |
Просмотр и измерение в 3D | PTC.Nav.ViewAndMeasureIn3D |
Просмотр свойств детали | PTC.Nav.ViewPartProperties |
Просмотр списка деталей | PTC.Nav.ViewPartList |
Просмотр структуры детали | PTC.Nav.ViewPartStructure |
НАБОР ЗАДАНИЙ ДЛЯ ДОКУМЕНТОВ | |
Просмотр документа | PTC.Nav.ViewDocument |
Просмотр структуры документа | PTC.Nav.ViewDocumentStructure |
Базовые атрибуты - это базовая предопределенная конфигурация, доступная для компонента "Атрибуты".
Свойства привязки
Входные данные | ||
|---|---|---|
Имя свойства | Описание | Тип свойства |
Input | Используется для идентификации данных, которые должны вызываться из серверной системы. Пример JSON: { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.ChangeMgmt.ChangeRequest", "items":[ { "id":{ "value":"OR:wt.change2.WTChangeRequest2:439476" } } ] } ] } ] } | JSON в формате CCO |
TailoringName | Уникально идентифицирует экземпляр компонента "Атрибуты". Это значение используется для внутреннего поиска информации о настройке конкретного экземпляра. Используйте это свойство привязки, только если существует специальная страница настройки для пользовательского задания. | Строка |
SubComponentConfiguration | Привяжите конфигурацию к этому свойству, если этот компонент используется в качестве подкомпонента в другом компоненте или во вложенном мэшапе. Пример JSON: { "implementationThingName":"PTC.Nav.AttributesGenericBusinessLogicThing", "configuration":{ "layout":{ "selectedKey":"horizontal", "additionalData":{ }, "version":"1.0.0" }, "attributes":{ "sets":[ { "data":{ "selectedValues":{ "data":[ { "itemListsData":[ { "items":[ { "id":"Role#Display", "ordinal":0 }, { "id":"Activity|Deadline", "ordinal":5 }, { "id":"Status#Display", "ordinal":4 } ], "objectType":"PTC.Workflow.WorkItem" }, { "items":[ { "id":"Category#Display", "ordinal":1 }, { "id":"RequestPriority#Display", "ordinal":3 } ], "objectType":"PTC.ChangeMgmt.ChangeRequest" } ], "adapter":{ "instanceName":"windchill", "thingName":"PTC.WCAdapter" } } ] } } } ] } } } | JSON |
Свойства конфигурации
В следующей таблице и на изображениях показаны свойства JSON, используемые для конфигурирования этого компонента.
Дополнительные сведения о структуре конфигурации см. в разделе Структура конфигурации компонента.
Дополнительные сведения о подсвойствах см. в разделе Подсвойства и ключи контейнера.
Имя свойства | Описание | Тип свойства | Значение по умолчанию | Обязательное или необязательное | |
|---|---|---|---|---|---|
attributes | Список атрибутов, для которых необходимо вызывать данные из серверной системы. Для Windchill эти имена свойств должны соответствовать значениям, определенным в модели EDM сервисов Windchill REST. Кроме того, принимает атрибут DefaultPDFRepresentation, имеющий тип объекта PTC.DocMgmt.DocStructure:PTC.Visualization.Representation.Custom.Adapter. Если в данную конфигурацию включен атрибут DefaultPDFRepresentation, то включается и атрибут Представление. Атрибут Представление содержит ссылку для просмотра представления элемента, если это доступно. | Н/Д | Обязательное | ||
isMultiLine | Определяет, нужно ли переносить содержимое. Опции: true, false. Это свойство является подсвойством для layout и применимо, только если для layout задано значение vertical. Ключ его контейнера: isMultilineDefinition. | Н/Д | Обязательное | ||
layout | Определяет порядок расположения атрибутов в интерфейсе пользователя. Доступны следующие опции. • vertical - атрибуты размещаются друг под другом. • horizontal: атрибуты располагаются один рядом с другим. Доступные подсвойства для layout зависят от выбора vertical или horizontal. Дополнительные сведения и образцы конфигураций см. в разделе Базовые атрибуты. | Н/Д | Обязательное | ||
maxHeight | Максимальная высота для имени и значения атрибута в интерфейсе пользователя. Если содержимое превышает значение свойства maxHeight, доступна ссылка "показать больше/показать меньше". Это свойство применимо только в следующих двух случаях: • Если для layout задано значение horizontal. В этом случае это подсвойство для layout. • Если для layout задано значение vertical и для isMultiLine задано значение true. В этом случае это подсвойство для isMultiLine. Ключ его контейнера: dimensionDefinition. | Н/Д | Обязательное | ||
maxWidth | Максимальная ширина для имени и значения атрибута в интерфейсе пользователя. Это свойство применимо только в следующих двух случаях: • Если для layout задано значение horizontal. В этом случае это подсвойство для layout. • Если для layout задано значение vertical и для isMultiLine задано значение false. В этом случае это подсвойство для isMultiLine. Ключ его контейнера: dimensionDefinition. | Н/Д | Обязательное | ||
messageWhenNoAttributes | Позволяет отображать сообщение, если нет доступных атрибутов. Это значение можно оставить пустым. В этом случае сообщение не отображается и специальные местозаполнители не сохраняются. | Н/Д | Необязательное | ||
hideLabel | Управляет видимостью меток атрибутов. • Задайте для свойства значение true, чтобы скрыть метку атрибута. • Задайте для свойства значение false, чтобы показать метку атрибута. | false | Необязательное | ||
Пример конфигурации
Пример конфигурации для компонента "Атрибуты" см. в конфигурации Базовые атрибуты.
Сервисы настройки
В дополнение к конфигурации каждый компонент поддерживает расширение бизнес-логики для настройки компонента. Бизнес-логика каждого компонента включает в себя переопределяемые сервисы в шаблоне вещи, которые можно расширять и переопределять. Переопределяемые сервисы для этого компонента подробно описаны в следующей таблице.
Примеры возвращаемых значений и параметров для каждого сервиса приведены в разделе Примеры ввода/вывода для сервисов настройки.
Наименование | Описание |
|---|---|
GetConfigurations | Возвращает доступные конфигурации для реализации компонента. Параметры: нет Возвращает: JSON |
GetImplementationLabel | Возвращает локализованное наименование компонента или лексему, которые можно использовать для получения локализованного наименования. Это локализованное наименование отображается в интерфейсе пользователя Mashup Builder. Параметры: нет Возвращает: строку |
ProcessAttributesConfiguration | Обрабатывает конфигурацию атрибутов и разделяет атрибуты на стандартные атрибуты и дополнительные атрибуты. Возвращает JSON с парами "ключ-значение" в следующем виде: • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON Атрибуты разделяются на стандартные и дополнительные на основании их типа объекта. Атрибуты, имеющие тип объекта, заканчивающийся на .Custom.Adapter или Custom.Implementation, обрабатываются как дополнительные атрибуты. Все остальные атрибуты считаются стандартными атрибутами. Параметры: attributes (обязательный) - JSON со списком стандартных атрибутов и дополнительных атрибутов. configuration (необязательный) - JSON с окончательной объединенной конфигурацией, полученной из ресурса диспетчера настройки. Возвращаемые данные: JSON в формате CCO |
GetAttributesValues | Возвращает JSON с атрибутами и их значениями. Параметры: input (обязательный) - JSON в формате CCO, содержащий идентификатор входных данных, которые нужно вызвать из серверной системы, и информацию об адаптере для серверной системы. configuration (необязательный) - JSON с окончательной объединенной конфигурацией, полученной из ресурса диспетчера настройки. attributes (обязательный) - JSON со списком стандартных атрибутов и дополнительных атрибутов. Возвращаемые данные: JSON в формате CCO |
GetAdditionalAttributesValues | Возвращает JSON со значениями для дополнительных атрибутов. Этот сервис должен быть реализован в реализации компонента. Параметры: input (обязательный) - JSON в формате CCO, содержащий идентификатор входных данных, которые нужно вызвать из серверной системы, и информацию об адаптере для серверной системы. configuration (необязательный) - JSON с окончательной объединенной конфигурацией, полученной из ресурса диспетчера настройки. attributes (обязательный) - JSON со списком дополнительных атрибутов. OOTBAttributesValues (необязательный) - JSON в формате CCO со значениями стандартных атрибутов, возвращаемых действием GetAttributesValues. Эти значения можно использовать для расчета значений дополнительных атрибутов. Возвращаемые данные: JSON в формате CCO |
GetAdditionalAttributes | Возвращает список дополнительных атрибутов, которые нужно добавить в список доступных стандартных атрибутов. Параметры: нет Возвращает: JSON |
UpdateAvailableAttributes | Обновляет один или несколько атрибутов из списка атрибутов и возвращает окончательный список. Параметры: attributes (обязательный) - JSON со списком стандартных атрибутов и дополнительных атрибутов. Возвращает: JSON |
Определение реализации
Определение реализации для компонента "Атрибуты" см. в конфигурации Базовые атрибуты.