Конфигурирование расширения Windchill DPT
1. Импортируйте расширение и проверьте примеры объектов и привязок ThingWorx.
a. Windchill_Digital_Product_Traceability-extension - импортируйте этот ZIP-файл в ThingWorx Platform. Убедитесь, что в ThingWorx Composer после импорта расширения DPT существуют следующие объекты:
 |
Версия продукта Windchill в импортированном расширении отображается в следующем формате:
xx.x.xxx
Здесь первые четыре цифры представляют выпуск Windchill, а последние две цифры представляют номер выпуска критического набора исправлений (CPS).
Например, выпуск CPS 03 для выпуска Windchill 12.0.0 в расширении представляется как 12.0.003.
|
|
Объект
|
Описание
|
Тип
|
||
|---|---|---|---|---|
|
OslcDataServicesThing
|
Эта вещь содержит сервисы для ресурса OSLC, которые вызываются из Windchill.
|
Thing
|
||
|
OslcFlowsThing
|
Эта вещь содержит сервисы процесса, которые вызывают данные из удаленной системы OSLC с помощью ThingWorx Flow.
|
Thing
|
||
|
OslcValidationFlowThing
|
Эта вещь содержит стандартную вещь рабочего процесса проверки.
|
Thing
|
||
|
OslcValidationServicesThing
|
Эта вещь содержит сервисы процесса для ресурсов OSLC, которые вызываются из Windchill.
|
Thing
|
||
|
PTC-PLM
|
• Тег модели PTC-PLM:TRACELINKS используется, чтобы пометить все объекты, доступные в расширении. Дополнительные сведения см. в разделе "Теги" справки в справочном центре ThingWorx Platform.
• PTC-PLM: тег модели TRACELINKS-DPT-EXTENSION-PROPERTIES по умолчанию включает расширение Windchill DPT для использования DPTExtensionPropertiesExampleConfigThing.
• Тег модели PTC-PLM:TRACELINKS ROOT SELECTION DIALOG при добавлении в вещь конфигурации отображает корневой узел в таблице Выбрать контекст. Если этот тег не добавлен, в таблице Выбрать контекст отображается полная структура дерева. Этот тег является специфичным для Windchill Modeler.
• Тег модели PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH при добавлении в вещь конфигурации использует средство выбора поиска внешних ресурсов для отображения внешнего ресурса OSLC. Если этот тег не добавлен, в диалоговом окне выбора отображается внешний ресурс OSLC. В поставляемой версии тег PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH добавлен в объекты ModelerExampleConfigThing и CodebeamerExampleThing.
• Тег модели PTC-PLM:TRACELINKS-OSLC-QUERY-SELECT-ALL необходимо задать для конфигурации примера вещи IBM Rational Doors NG, когда используется тег PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH.
|
ModelTagVocabulary
|
||
|
PTC-PLM-VALIDATION-FLOWS
|
Тег моделирования PTC-PLM-VALIDATION:modeler используется для определения вещи процесса проверки. Дополнительные сведения см. в разделе "Теги" справки в справочном центре ThingWorx Platform.
|
ModelTagVocabulary
|
||
|
PTC.PLM.TraceLinks.AttributeMappingConfigDataShape
|
Эта структура данных используется в OSLCResourceAttributeMappingConfigTable для сопоставления атрибутов.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.DPTExtensionPropertiesThingTemplate
|
Содержит свойства конфигурации для Windchill_Digital_Product_Traceability-extension.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingShape
|
Этот профиль вещи содержит контракт сервиса, определенный для Windchill.
|
ThingShape
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingTemplate
|
Этот шаблон вещи содержит сервисы данных, определенные для Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcFlowsTemplate
|
Этот шаблон вещи содержит сервисы процесса.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate
|
Этот шаблон вещи используется для создания вещи конфигурации для каждой внешней системы.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcValidationServicesThingTemplate
|
Этот шаблон вещи содержит сервисы процесса для Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.ResourceShapeAttributeMappingDataShape
|
Эта структура данных используется в таблице OSLCResourceShapeConfigTable для сопоставления атрибутов.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.SearchAttributeMappingConfigDataShape
|
Эта структура данных используется в таблице OSLCSearchResultConfigTable для сопоставления атрибутов.
|
DataShape
|
||
|
TRACELINKS
|
Тег модели TRACELINKS:OSLC-FLOWS используется, чтобы пометить все объекты, доступные в расширении. Дополнительные сведения см. в разделе "Теги" справки в справочном центре ThingWorx Platform.
|
ModelTagVocabulary
|
||
|
Windchill_Digital_Product_Traceability-12.1.205.jar
|
Этот ресурс является частью Windchill_Digital_Product_Traceability-extension.
|
Ресурс
|
|
|
Убедитесь в правильности разрешений, включенных для перечисленных выше объектов. См. раздел Разрешения для объектов ThingWorx Platform.
|
|
|
Тег модели состоит из словаря и терминов. Например, в теге PTC-PLM-ValidationFlows:modeler атрибут PTC-PLM-ValidationFlows представляет словарь, а modeler является значением для терминов. Значение тега модели является уникальным для вещи.
|
b. Windchill_Digital_Product_Traceability_Config_Things - распакуйте папку, а затем импортируйте каждый XML-файл в ThingWorx Platform. Используйте примеры вещей как справочный материал для конфигурирования вещей. Убедитесь, что были импортированы следующие XML-файлы:
|
Объекты
|
Описание
|
||||||
|---|---|---|---|---|---|---|---|
|
DoorsExampleConfigThing
|
Этот пример вещи содержит справочную конфигурацию для IBM Rational Doors NG.
|
||||||
|
ModelerExampleConfigThing
|
Этот пример вещи содержит справочную конфигурацию для Windchill Modeler.
|
||||||
|
WRVSExampleConfigThing
|
Этот пример вещи содержит справочную конфигурацию для Windchill RV&S.
|
||||||
|
CodebeamerExampleThing
|
Этот пример вещи содержит справочную конфигурацию для Codebeamer.
|
||||||
|
DPTExtensionPropertiesExampleConfigThing
|
При наличии тега модели TRACELINKS-DPT-EXTENSION-PROPERTIES расширение Windchill DPT может использовать следующие определенные свойства:
• CACHE-EXPIRY - определяет достоверность записей кэша. Значение по умолчанию: 5 минут.
• SCHEDULER-INTERVAL - определяет частоту автоматической очистки записей кэша. Значение по умолчанию: 30 минут.
• CACHE-USERS - определяет число пользователей в записях кэша. Значение по умолчанию: 200.
• CACHE-RESOURCES - определяет число ресурсов, которые могут кэшироваться каждым пользователем. Значение по умолчанию: 100.
• LARGE-PREVIEW-SHOW-DIMENSIONS - определяет, показывать ли большое окно предварительного просмотра в новой вкладке. Если задано значение No, большое окно просмотра открывается по умолчанию в новой вкладке. Если задано значение Yes, предварительный просмотр открывается во всплывающем окне.
• OSLC-QUERY-PAGESIZE- определяет число удаленных объектов, которые должны отображаться на странице. В стандартной версии задано значение 50.
• DEFINE-RESOURCETYPE-ATTRIBUTE - указывает имя атрибута сервера Windchill Modeler OSLC, который возвращает значение типа ресурса. Значение по умолчанию: ptc_im_am:dynamicUmlClassName.
|
||||||
|
ModelerValidationFlowThing
|
Этот пример вещи содержит ссылку для настройки процесса проверки для Windchill Modeler. Администратор может настроить вещь процесса проверки в соответствии с бизнес-требованием.
|
2. В ThingWorx Flow используйте следующие инструкции и создайте новое соединение для системы OSLC, с которой требуется интеграция. См. раздел "Создание соединений и управление ими" в справочном центре ThingWorx Platform.
a. Создайте Соединение для системы OSLC.
▪ Для базовой аутентификации выберите тип соединения OSLC, базовое.
▪ Для конфигурации SSO создайте соединение OAuth.
|
|
Необходимо принять предоставление разрешения для объекта соединения сессии OSLC OAuth. Дополнительные сведения см. в разделе Создание клиентского соединения OAuth для ThingWorx.
|
b. Введите следующую информацию в окне Добавить соединение:
▪ Метка соединения - введите наименование соединения. Указанное здесь наименование соединения используется в вещи конфигурации.
▪ URL-адрес каталога - введите URL-адрес каталога внешнего сервера OSLC. См. Windchill RV&S OSLC Client guide (12.3.0.0 onwards) (Руководство клиента OSLC (12.3.0.0 и выше)) в справочных документах и разделы "OSLC integration with Integrity Modeler" (Интеграция OSLC с Integrity Modeler) и "OSLC integration with IBM Rational DOORS Next Generation" (Интеграция OSLC с IBM Rational DOORS Next Generation) в справочном центре Windchill Modeler (на английском языке).
|
|
См. документацию для вашей поддерживаемой версии приложений Windchill RV&S и Windchill Modeler.
|
▪ Учетные данные для входа в служебную учетную запись внешней системы, чтобы получить доступ к серверу OSLC.
▪ Параллельные запросы - количество одновременных запросов ресурсов, вызываемых из ThingWorx Flow. Значение по умолчанию: 5.
Администраторы могут изменять число запросов в соответствии с конфигурацией сервера.
c. Сохраните соединение.
d. Щелкните Закрыть.
3. Сконфигурируйте ThingWorx Platform для интеграции с серверами OSLC внешней системы. В ThingWorx Platform создайте вещь конфигурации и проверки.
a. Создание вещи конфигурации:
i. Выполните команды > и укажите значения атрибутов. Выберите PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate как Базовый шаблон вещи.
ii. На вкладке Конфигурация настройте сопоставления, как описано в следующих таблицах. Можно использовать профиль WRVSExampleConfigThing как пример, чтобы ввести сведения для системы OSLC.
▪ OSLCServerMappingConfigTable
|
Атрибут
|
Описание
|
|---|---|
|
Сервер
|
Имя внешнего сервера OSLC.
|
|
BaseURL
|
Базовый URL-адрес внешнего сервера OSLC.
|
|
ConnectionObject
|
Наименование соединения, созданного для внешнего сервера OSLC.
|
|
Тег
|
Значение опции Термины, определенное в словаре тегов модели PTC-PLM-Validation-Flows для идентификации удаленного сервера.
Этот шаг не является обязательным. Этот шаг требуется только при использовании процесса проверки.
Дополнительные сведения о добавлении тегов см. в разделе "Теги" справки в справочном центре ThingWorx Platform.
|
▪ OSLCResourceMappingConfigTable
|
Атрибут
|
Описание
|
|---|---|
|
WindchillType
|
Внутреннее наименование ресурса требования или архитектуры из управления типами в Windchill. Связь отслеживания создается для этого ресурса.
|
|
OSLCResourceType
|
Тип ресурса требований, ресурса архитектуры или их подтипов, определенных на внешнем сервере OSLC. Значение OSLCResourceType представляет имена ресурсов и их подтипов, сконфигурированные на внешнем сервере OSLC. Например, в Windchill Modeler задача определяется как подтип ресурса домена архитектуры. Пользователь может определить наименование как Resource|Activity, где задача является подтипом для типа ресурса OSLC, который принадлежит домену архитектуры. Наименование, указанное для типа ресурса архитектуры, должно отделяться символом вертикальной черты "|".
|
Дополнительные сведения о внутреннем наименовании ресурса требования или архитектуры см. в подразделе "Типы и атрибуты" раздела Совместимость и требования к системе.
 |
Не следует повторно сопоставлять тип ресурса OSLC с типом объекта Windchill, если тип ресурса OSLC уже сопоставлен с типом объекта Windchill. Повторное сопоставление типа объекта Windchill с типом ресурса OSLC, первоначально определенным в ThingWorx, после отслеживания объекта в Windchill может привести к повреждению данных.
|
▪ OSLCResourceAttributeMappingConfigTable
|
Атрибут
|
Описание
|
|---|---|
|
WindchillTableId22222
|
Идентификатор таблицы в Windchill, в которой отображаются данные с внешнего сервера OSLC.
|
|
WindchillType
|
Внутреннее наименование ресурса требования или архитектуры из утилиты Управление типами и атрибутами в Windchill.
|
▪ Сопоставление атрибутов для OSLCResourceAttributeMappingConfigTable
|
Атрибут
|
Описание
|
||
|---|---|---|---|
|
WindchillAttribute
|
Наименование атрибута Windchill, который будет отображаться в таблице Windchill.
|
||
|
OSLCResourceAttribute
|
Наименование атрибута ресурса OSLC.
|
||
|
WindchillAttributeDataType
|
Тип данных атрибута Windchill. Значения типов данных, поддерживаемых в стандартной версии: String, Timestamp и RTF.
|
||
|
IsPreview
|
Если для атрибута выбрано значение IsPreview, он отображает представление HTML отслеживаемого удаленного объекта так, как оно представлено внешним сервером OSLC.
Установите флажок IsPreview для включения малого и большого предварительных просмотров.
Значение IsPreview доступно для атрибутов с типом данных Строка и RTF. Для обоих типов данных отображается малый предварительный просмотр, однако большой предварительный просмотр доступен только для атрибутов с типом данных Строка.
|
▪ OSLCResourceShapeConfigTable
|
Атрибут
|
Описание
|
|---|---|
|
OSLCResourceType
|
Поддерживаются типы ресурсов домена требований, домена архитектуры или домена изменений, определенные на внешнем сервере OSLC. Значение OSLCResourceType представляет имена ресурсов, сконфигурированные на внешнем сервере OSLC.
|
|
OSLCResourceShapeURI
|
URI структуры ресурса OSLC для серверов OSLC, которые не предоставляют структуру ресурса с помощью сервиса запросов OSLC, но предоставляют структуру ресурса с другим сервисом. Например, сервер IBM Rational Doors NG OSLC предоставляет структуру ресурса с помощью сервиса Creation Factory.
|
▪ Сопоставление атрибутов для OSLCResourceShapeConfigTable
|
Атрибут
|
Описание
|
|---|---|
|
WindchillAttribute
|
Наименование атрибута Windchill, которое будет отображаться на панели Критерии фильтра средства выбора внешних ресурсов.
|
|
OSLCResourceAttribute
|
Чтобы добавить значение для атрибута OSLC, следуйте правилам именования prefix:propertyName. Здесь prefix - это добавление перед наименованием свойства, а propertyName - наименование атрибута, определенное сервером OSLC. Например, для атрибута state, предоставленного сервером Windchill RV&S OSLC, атрибут OSLCResourceAttribute имеет значение dcterms:state.
|
|
OSLCAttributeDataType
|
Тип данных ресурса OSLC. Поддерживаемыми значениями типов данных OSLC являются String, LangString, XMLLiteral, Boolean, DateTime, Decimal, Double, Float и Integer.
|
▪ OSLCSearchResultConfigTable
|
Атрибут
|
Описание
|
|---|---|
|
WindchillType
|
Поддерживаются типы ресурсов Windchill для домена требований, домена архитектуры или домена изменений.
|
▪ Сопоставление атрибутов для OSLCSearchResultConfigTable
|
Атрибут
|
Описание
|
||
|---|---|---|---|
|
WindchillAttribute
|
Наименование атрибута Windchill, которое будет отображаться на панели таблицы Результат поиска средства выбора внешних ресурсов.
|
||
|
OSLCResourceAttribute
|
Наименование атрибута ресурса OSLC.
|
||
|
WindchillAttributeDataType
|
Тип данных атрибута Windchill. Значения типов данных, поддерживаемых в стандартной версии: String, Timestamp и RTF.
|
iii. Щелкните Сохранить и продолжить.
b. Вещь процесса проверки включает сервисы процесса, которые проверяют, соответствует ли выбранный тип ресурса Windchill выбранному типу ресурса OSLC в диалоговом окне делегата OSLC. Тип ресурса Windchill доступен в меню Тип в окне Добавить отслеживания. ModelerValidationFlowThing является примером стандартной доступной вещи Flow. На приведенном ниже рисунке показан рабочий процесс проверки.
Чтобы создать вещь процесса проверки, выполните следующие шаги. Импорт примера вещи ModelerValidationFlowThing является необходимым условием для создания вещи процесса проверки.
i. Выберите ModelerValidationFlowThing и щелкните Дублировать.
ii. На вкладке Общая информация укажите значение атрибутов Наименование и Теги.
Тег получает значение опции Термины, созданное в словаре тегов PTC-PLM-Validation-Flows модели для идентификации внешнего сервера. В теге PTC-PLM-Validation-Flows укажите в опции Термины значение для внешнего сервера, с которым нужно выполнить интеграцию. Укажите то же значение Термины в поле Тег в OSLCServerMappingConfigTable.
iii. Щелкните Сохранить
Дополнительные сведения о предварительных условиях, требуемых для конфигурирования расширения DPT в ThingWorx Platform, см. в разделе Предварительные условия.
Дополнительные сведения о разрешениях, требуемых профилями пользователей ThingWorx, см. в разделе Разрешения для объектов ThingWorx Platform.