Конфигурирование расширения Windchill DPT
1. Импортируйте расширение вместе с требуемыми PTC ссылочными вещами конфигурации и проверьте объекты 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.
|
|
Объект
|
Description
|
Тип
|
||
|---|---|---|---|---|
|
DPTAdminConfigThing
|
Эта вещь конфигурации включает сервис для создания групп DPTEndUserGroup и DPTConfiguratorGroup и назначения необходимых разрешений для сущностей ThingWorx Platform.
|
ConfigThing
|
||
|
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 при добавлении в вещь конфигурации отображает корневой узел в таблице Выбрать контекст. Если этот тег не добавлен, в таблице Выбрать контекст отображается полная структура дерева. Этот тег является специфичным для PTC Modeler.
• Тег модели PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH при добавлении в вещь конфигурации использует средство выбора поиска внешних ресурсов для отображения внешнего ресурса OSLC. Если этот тег не добавлен, в диалоговом окне выбора отображается внешний ресурс OSLC. В стандартной конфигурации тег PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH добавлен в файл PTCModelerConfigThing. PTC не рекомендует добавлять тег PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH в PolarionReferenceConfigThing.
• Тег модели 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-xx.x.xxx.jar
|
Этот ресурс является частью Windchill_Digital_Product_Traceability-extension.
|
Ресурс
|
|
|
Убедитесь в правильности разрешений, включенных для перечисленных выше объектов. Дополнительные сведения см. в разделе Разрешения по умолчанию для объектов ThingWorx Platform.
|
|
|
Тег модели состоит из словаря и терминов. Значение тега модели является уникальным для вещи.
|
b. Windchill_Digital_Product_Traceability_Config_Things - распакуйте папку и импортируйте требуемую вещь ссылочной конфигурации PTC вместе с вещью DPTExtensionPropertiesReferenceConfigThing в ThingWorx Platform. Используйте импортированные вещи ссылочной конфигурации в качестве справочной информации для стандартных поддерживаемых и проверенных конфигураций.
|
Объекты
|
Description
|
||||||||
|---|---|---|---|---|---|---|---|---|---|
|
PTCDoorsConfigThing
|
Эта вещь конфигурации содержит ссылочные конфигурации для IBM Rational Doors NG, включая все сопоставления данных и конфигурации Windchill для IBM Rational Doors NG OSLC.
|
||||||||
|
PTCModelerConfigThing
|
Эта вещь конфигурации содержит ссылочные конфигурации для PTC Modeler, включая все сопоставления данных и конфигурации Windchill для PTC Modeler OSLC.
|
||||||||
|
PTCRVSConfigThing
|
Эта вещь конфигурации содержит ссылочные конфигурации для PTC RV&S, включая все сопоставления данных и конфигурации Windchill для PTC RV&S OSLC.
|
||||||||
|
PTCCodebeamerConfigThing
|
Эта вещь конфигурации содержит ссылочные конфигурации для Codebeamer, включая все сопоставления данных и конфигурации Windchill для Codebeamer OSLC.
|
||||||||
|
PTCPolarionConfigThing
|
Эта вещь конфигурации содержит ссылочные конфигурации для Siemens Polarion, включая все сопоставления данных и конфигурации Windchill для Siemens Polarion OSLC.
|
||||||||
|
PTCJiraConfigThing
|
Эта вещь конфигурации содержит ссылочные конфигурации для Jira (SodiusWillert), включая все сопоставления данных и конфигурации Windchill для Jira OSLC.
|
||||||||
|
PTCCatiaConfigThing
|
Эта вещь конфигурации содержит ссылочные конфигурации для CATIA Magic Collaboration Studio, включая все сопоставления данных и конфигурации Windchill для CATIA Magic Collaboration Studio OSLC.
|
||||||||
|
DPTExtensionPropertiesConfigThing
|
При наличии тега модели 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 - указывает имя атрибута сервера PTC Modeler OSLC, который возвращает значение типа ресурса. Значение по умолчанию: ptc_im_am:dynamicUmlClassName.
|
c. Выполните сервис DPTAdminConfigThing с помощью следующих шагов.
i. Войдите в платформу ThingWorx в качестве администратора.
ii. Перейдите на вкладку > > > .
iii. Выполнить.
После успешного выполнения сервиса появится следующее сообщение: "Разрешения успешно применены"
iv. Убедитесь, что группы DPTEndUserGroup и DPTConfiguratorGroup созданы в разделе > . Убедитесь, что необходимые разрешения назначены объектам ThingWorx Platform.
Дополнительные сведения см. в разделе Разрешения по умолчанию для объектов ThingWorx Platform.
|
|
• Сервис PostDPTExtensionImport может выполняться только администратором ThingWorx.
• Существующие участники и разрешения групп DPTEndUserGroup и DPTConfiguratorGroup сохраняются после выполнения сервиса.
|
2. В ThingWorx Flow используйте следующие инструкции и создайте новое соединение для системы OSLC, с которой требуется интеграция. См. раздел "Создание соединений и управление ими" в справочном центре ThingWorx Platform.
a. Создайте Соединение для системы OSLC.
▪ Для базовой аутентификации выберите тип соединения OSLC, базовое.
▪ Для конфигурации SSO создайте соединение OAuth.
Перед созданием соединения с OAuth убедитесь, что поставщик OAuth был сконфигурирован в ThingWorx Flow. Дополнительные сведения см. в разделах Создание поставщиков OAuth и управление ими и Конфигурирование и загрузка OAuth в справочном центре ThingWorx Flow.
|
|
Необходимо принять предоставление разрешения для объекта соединения сессии OSLC OAuth. Дополнительные сведения см. в разделе Создание клиентского соединения OAuth для ThingWorx.
|
b. Введите следующую информацию в окне Добавить соединение:
▪ Метка соединения - введите наименование соединения. Указанное здесь наименование соединения используется в вещи конфигурации.
▪ URL-адрес каталога - введите URL-адрес каталога внешнего сервера OSLC. См. PTC 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) в справочном центре PTC Modeler (на английском языке).
|
|
См. документацию для вашей поддерживаемой версии приложений PTC RV&S и PTC Modeler.
|
▪ Учетные данные для входа в служебную учетную запись внешней системы, чтобы получить доступ к серверу OSLC.
▪ Параллельные запросы - количество одновременных запросов ресурсов, вызываемых из ThingWorx Flow. Значение по умолчанию: 5.
Администраторы могут изменять число запросов в соответствии с конфигурацией сервера.
c. Сохраните соединение.
d. Щелкните Закрыть.
 |
Не изменяйте соединитель по умолчанию PTC Modeler в ThingWorx Flow.
|
3. Сконфигурируйте ThingWorx Platform для интеграции с серверами OSLC внешней системы. В ThingWorx Platform создайте вещь конфигурации.
Создание вещи конфигурации:
a. Выполните команды > и укажите значения атрибутов. Выберите PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate как Базовый шаблон вещи.
b. На вкладке Конфигурация настройте сопоставления, как описано в следующих таблицах. Можно использовать вещь WRVSReferenceConfigThing как привязку, чтобы ввести сведения для системы OSLC.
▪ OSLCServerMappingConfigTable
|
Атрибут
|
Description
|
||
|---|---|---|---|
|
Сервер
|
Имя внешнего сервера OSLC.
|
||
|
BaseURL
|
Базовый URL-адрес внешнего сервера OSLC.
|
||
|
ConnectionObject
|
Наименование соединения, созданного для внешнего сервера OSLC.
|
||
|
Тег
|
Значение опции Термины, определенное в словаре тегов модели PTC-PLM-Validation-Flows для идентификации удаленного сервера.
Этот шаг не является обязательным. Этот шаг требуется только при использовании процесса проверки.
Дополнительные сведения о добавлении тегов см. в разделе "Теги" справки в справочном центре ThingWorx Platform.
|
▪ Сопоставление атрибутов для OSLCResourceMappingConfigTable
|
Атрибут
|
Description
|
|---|---|
|
WindchillType
|
Внутреннее наименование ресурса требования или архитектуры из управления типами в Windchill. Связь отслеживания создается для этого ресурса.
|
|
OSLCResourceType
|
Тип ресурса требований, ресурса архитектуры или их подтипов, определенных на внешнем сервере OSLC. Значение OSLCResourceType представляет имена ресурсов и их подтипов, сконфигурированные на внешнем сервере OSLC. Например, в PTC Modeler задача определяется как подтип ресурса домена архитектуры. Пользователь может определить наименование как Resource|Activity, где задача является подтипом для типа ресурса OSLC, который принадлежит домену архитектуры. Наименование, указанное для типа ресурса архитектуры, должно отделяться символом вертикальной черты "|".
|
Дополнительные сведения о внутреннем наименовании ресурса требования или архитектуры см. в подразделе "Типы и атрибуты" раздела Совместимость и требования к системе.
|
|
Не следует повторно сопоставлять тип ресурса OSLC с типом объекта Windchill, если тип ресурса OSLC уже сопоставлен с типом объекта Windchill. Повторное сопоставление типа объекта Windchill с типом ресурса OSLC, первоначально определенным в ThingWorx, после отслеживания объекта в Windchill может привести к повреждению данных.
|
▪ OSLCResourceAttributeMappingConfigTable
|
Атрибут
|
Description
|
|---|---|
|
WindchillTableId
|
Идентификатор таблицы в Windchill, в которой отображаются данные с внешнего сервера OSLC.
Чтобы добавить несколько идентификаторов таблицы, используйте разделенный запятыми список.
|
|
WindchillType
|
Внутреннее наименование ресурса требования или архитектуры из утилиты Управление типами и атрибутами в Windchill.
|
▪ Сопоставление атрибутов для OSLCResourceAttributeMappingConfigTable
|
Атрибут
|
Description
|
||
|---|---|---|---|
|
WindchillAttribute
|
Наименование атрибута Windchill, который будет отображаться в таблице Windchill.
|
||
|
OSLCResourceAttribute
|
Наименование атрибута ресурса OSLC.
|
||
|
WindchillAttributeDataType
|
Тип данных атрибута Windchill. Значения типов данных, поддерживаемых в стандартной версии: String, Timestamp и RTF.
|
||
|
IsPreview
|
Если для атрибута выбрано значение IsPreview, он отображает представление HTML отслеживаемого удаленного объекта так, как оно представлено внешним сервером OSLC.
Установите флажок IsPreview для включения малого и большого предварительных просмотров.
Значение IsPreview доступно для атрибутов с типом данных Строка и RTF. Для обоих типов данных отображается малый предварительный просмотр, однако большой предварительный просмотр доступен только для атрибутов с типом данных Строка.
|
▪ OSLCResourceShapeConfigTable
|
Атрибут
|
Description
|
|---|---|
|
OSLCResourceType
|
Поддерживаются типы ресурсов домена требований, домена архитектуры или домена изменений, определенные на внешнем сервере OSLC. Значение OSLCResourceType представляет имена ресурсов, сконфигурированные на внешнем сервере OSLC.
|
|
OSLCResourceShapeURI
|
URI структуры ресурса OSLC для серверов OSLC, которые не предоставляют структуру ресурса с помощью сервиса запросов OSLC, но предоставляют структуру ресурса с другим сервисом. Например, сервер IBM Rational Doors NG OSLC предоставляет структуру ресурса с помощью сервиса Creation Factory.
|
▪ Сопоставление атрибутов для OSLCResourceShapeConfigTable
|
Атрибут
|
Description
|
|---|---|
|
WindchillAttribute
|
Наименование атрибута Windchill, которое будет отображаться на панели Критерии фильтра средства выбора внешних ресурсов.
|
|
OSLCResourceAttribute
|
Чтобы добавить значение для атрибута OSLC, следуйте правилам именования prefix:propertyName. Здесь prefix - это добавление перед наименованием свойства, а propertyName - наименование атрибута, определенное сервером OSLC. Например, для атрибута state, предоставленного сервером PTC RV&S OSLC, атрибут OSLCResourceAttribute имеет значение dcterms:state.
|
|
OSLCAttributeDataType
|
Тип данных ресурса OSLC. Поддерживаемыми значениями типов данных OSLC являются String, LangString, XMLLiteral, Boolean, DateTime, Decimal, Double, Float и Integer.
|
▪ OSLCSearchResultConfigTable
|
Атрибут
|
Description
|
|---|---|
|
WindchillType
|
Поддерживаются типы ресурсов Windchill для домена требований, домена архитектуры или домена изменений.
|
▪ Сопоставление атрибутов для OSLCSearchResultConfigTable
|
Атрибут
|
Description
|
||
|---|---|---|---|
|
WindchillAttribute
|
Наименование атрибута Windchill, которое будет отображаться на панели таблицы Результат поиска средства выбора внешних ресурсов.
|
||
|
OSLCResourceAttribute
|
Наименование атрибута ресурса OSLC.
|
||
|
WindchillAttributeDataType
|
Тип данных атрибута Windchill. Значения типов данных, поддерживаемых в стандартной версии: String, Timestamp и RTF.
|
▪ OSLCRemoteConfigTable
|
Атрибут
|
Description
|
||
|---|---|---|---|
|
ReverseLookupURL
|
Относительный URL-адрес службы обратного поиска для внешних серверов OSLC. Например, для Codebeamer укажите /cb/api/oslc/links/traceLinkResources.
|
||
|
Метод
|
Метод HTTP-запроса, поддерживаемый сервисом обратного просмотра. Допустимые значения: GET и POST.
|
||
|
TraceableUrlPrefix
|
Префикс, который используется вместе с URL-адресом детали или отслеживаемого объекта. Например, для Codebeamer укажите cb:traceLinkTargetURI.
|
||
|
PageSize
|
Определяет максимальное число удаленных элементов, которые могут быть вызваны в одном вызове сервиса обратного поиска OSLC.
Предел по умолчанию: 200 для PTC RV&S и 500 для Codebeamer.
Если настроенное значение превышает предел по умолчанию, происходит сбой функции обратного поиска.
|
|
|
Функциональность обратного поиска поддерживается только для серверов PTC Modeler, PTC RV&S и Codebeamer OSLC. Убедитесь, что значения атрибутов, упомянутые выше, определены в ссылочных файлах конфигурации только для поддерживаемых серверов OSLC.
|
c. Щелкните Сохранить и продолжить.