Configuración de la extensión de DPT de Windchill
1. Importe la extensión junto con las cosas de configuración de referencia de PTC necesarias y verifique las entidades de ThingWorx.
a. Windchill_Digital_Product_Traceability-extension: importe este fichero ZIP en ThingWorx Platform. Verifique que las entidades siguientes existen en ThingWorx Composer después de importar la extensión DPT:
 |
La versión del producto Windchill en la extensión importada se muestra con el siguiente formato: xx.x.xxx. Los primeros cuatro dígitos representan la versión de Windchill y los dos últimos dígitos representan el número de versión del conjunto de parches críticos (CPS).
Por ejemplo, una versión CPS 03 de Windchill 12.0.0 se representa como 12.0.003 en la extensión.
|
|
Entidad
|
Descripción
|
Tipo
|
||
|---|---|---|---|---|
|
DPTAdminConfigThing
|
Esta cosa de configuración incluye el servicio para crear DPTEndUserGroup y DPTConfiguratorGroup, y para asignar los permisos necesarios a las entidades de ThingWorx Platform.
|
ConfigThing
|
||
|
OslcDataServicesThing
|
Esta cosa contiene los servicios para el recurso de OSLC que se invocan desde Windchill.
|
Cosa
|
||
|
OslcFlowsThing
|
Esta cosa contiene los servicios de flujo que extraen datos del sistema de OSLC remoto mediante ThingWorx Flow.
|
Cosa
|
||
|
OslcValidationFlowThing
|
Esta cosa contiene la cosa de flujo de validación por defecto.
|
Cosa
|
||
|
OslcValidationServicesThing
|
Esta cosa contiene servicios de validación para los recursos de OSLC que se invocan desde Windchill.
|
Cosa
|
||
|
PTC-PLM
|
• La etiqueta de modelo PTC-PLM:TRACELINKS se utiliza para etiquetar todas las entidades disponibles en la extensión. Para obtener más información, consulte las etiquetas de los temas de ayuda en el Centro de ayuda de ThingWorx Platform.
• La etiqueta de modelo PTC-PLM:TRACELINKS-DPT-EXTENSION-PROPERTIES, por defecto, permite que la extensión de DPT de Windchill utilice DPTExtensionPropertiesConfigThing.
• La etiqueta de modelo PTC-PLM:TRACELINKS ROOT SELECTION DIALOG, cuando se añade a una cosa de configuración, muestra la raíz en la tabla Seleccionar contexto. Cuando no se añade la etiqueta, se muestra toda la estructura del árbol en la tabla Seleccionar contexto. Esta etiqueta es específica de PTC Modeler.
• La etiqueta de modelo PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH, cuando se añade a la cosa de configuración, utiliza el selector de búsquedas de recursos externos para mostrar el recurso de OSLC externo. Cuando no se añade esta etiqueta, en el cuadro de diálogo de selección se muestra el recurso de OSLC externo. De fábrica, la etiqueta PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH se añade a PTCModelerConfigThing. PTC no recomienda añadir la etiqueta PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH a PTCPolarionConfigThing.
• Se debe especificar la etiqueta de modelo PTC-PLM:TRACELINKS-OSLC-QUERY-SELECT-ALL para la cosa de configuración de referencia IBM Rational Doors NG al utilizar la etiqueta PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH.
|
ModelTagVocabulary
|
||
|
PTC-PLM-VALIDATION-FLOWS
|
La etiqueta de modelo PTC-PLM-VALIDATION:modeler se utiliza para identificar una cosa de flujo de validación. Para obtener más información, consulte las etiquetas de temas en el Centro de ayuda de ThingWorx Platform.
|
ModelTagVocabulary
|
||
|
PTC.PLM.TraceLinks.AttributeMappingConfigDataShape
|
Esta definición de datos se utiliza en OSLCResourceAttributeMappingConfigTable para la asignación de atributos.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.DPTExtensionPropertiesThingTemplate
|
Esta plantilla de cosa contiene las propiedades de configuración de Windchill_Digital_Product_Traceability-extension.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingShape
|
En esta definición de cosa se incluye el contrato de servicios definido para Windchill.
|
ThingShape
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingTemplate
|
Esta plantilla de cosa contiene servicios de datos definidos para Windchill
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcFlowsTemplate
|
Esta plantilla de cosa contiene los servicios de flujo.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate
|
Esta plantilla de cosa se utiliza para crear una cosa de configuración para cada sistema externo.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcValidationServicesThingTemplate
|
Esta plantilla de cosa contiene servicios de validación para Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.ResourceShapeAttributeMappingDataShape
|
Esta definición de datos se utiliza en OSLCResourceShapeConfigTable para la asignación de atributos.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.SearchAttributeMappingConfigDataShape
|
Esta definición de datos se utiliza en OSLCSearchResultConfigTable para la asignación de atributos.
|
DataShape
|
||
|
TRACELINKS
|
La etiqueta de modelo TRACELINKS:OSLC-FLOWS se utiliza para etiquetar todas las entidades disponibles en la extensión. Para obtener más información, consulte las etiquetas de temas en el Centro de ayuda de ThingWorx Platform.
|
ModelTagVocabulary
|
||
|
Windchill_Digital_Product_Traceability-xx.x.xxx.jar
|
Este recurso forma parte de Windchill_Digital_Product_Traceability-extension.
|
Recurso
|
|
|
Asegúrese de que los permisos correctos estén activados en las entidades de la lista anterior. Para obtener más información, consulte Permisos por defecto para entidades de ThingWorx Platform.
|
|
|
Una etiqueta de modelo está formada por Vocabulario y Términos. El valor de una etiqueta de modelo es único para una cosa.
|
b. Windchill_Digital_Product_Traceability_Config_Things : extraiga la carpeta e importe la cosa de configuración de referencia de PTC necesaria junto con DPTExtensionPropertiesConfigThing a ThingWorx Platform. Utilice las cosas de configuración de referencia importadas como referencia para las configuraciones estándar soportadas y validadas.
|
Entidades
|
Descripción
|
||||||||
|---|---|---|---|---|---|---|---|---|---|
|
PTCDoorsConfigThing
|
Esta cosa de configuración contiene configuraciones de referencia para IBM Rational Doors NG, incluidas todas las Windchill para asignaciones y configuraciones de datos de OSLC de IBM Rational Doors NG.
|
||||||||
|
PTCModelerConfigThing
|
Esta cosa de configuración contiene configuraciones de referencia para PTC Modeler, incluidas todas las Windchill para asignaciones y configuraciones de datos de OSLC de PTC Modeler.
|
||||||||
|
PTCRVSConfigThing
|
Esta cosa de configuración contiene configuraciones de referencia para PTC RV&S, incluidas todas las Windchill para asignaciones y configuraciones de datos de OSLC de PTC RV&S.
|
||||||||
|
PTCCodebeamerConfigThing
|
Esta cosa de configuración contiene configuraciones de referencia para Codebeamer, incluidas todas las Windchill para asignaciones y configuraciones de datos de OSLC de Codebeamer.
|
||||||||
|
PTCPolarionConfigThing
|
Esta cosa de configuración contiene configuraciones de referencia para Siemens Polarion, incluidas todas las Windchill para asignaciones y configuraciones de datos de OSLC de Siemens Polarion.
|
||||||||
|
PTCJiraConfigThing
|
Esta cosa de configuración contiene configuraciones de referencia para Jira (SodiusWillert), incluidas todas las Windchill para asignaciones y configuraciones de datos de OSLC de Jira.
|
||||||||
|
PTCCatiaConfigThing
|
Esta cosa de configuración contiene configuraciones de referencia para CATIA Magic Collaboration Studio, incluidas todas las Windchill para asignaciones y configuraciones de datos de OSLC de CATIA Magic Collaboration Studio.
|
||||||||
|
DPTExtensionPropertiesConfigThing
|
Cuando se etiqueta con una etiqueta de modelo TRACELINKS-DPT-EXTENSION-PROPERTIES, la extensión de DPT de Windchill puede utilizar las siguientes propiedades definidas.
• CACHE-EXPIRY: permite determinar la validez de las entradas de la caché. El valor por defecto es 5 minutos.
• SCHEDULER-INTERVAL: permite determinar la frecuencia con la que las entradas de la caché se depuran automáticamente. El valor por defecto es 30 minutos.
• CACHE-USERS: permite determinar el número de usuarios en las entradas de la caché. El valor por defecto es 200.
• CACHE-RESOURCES: permite determinar el número de recursos que se pueden almacenar en caché por usuario. El valor por defecto es 100.
• LARGE-PREVIEW-SHOW-DIMENSIONS: permite determinar si se debe mostrar una vista previa grande en una nueva ficha. Cuando se define en No, el valor por defecto, la vista previa grande se abre en una nueva ficha. Cuando se define en Yes, la vista previa se abre en una ventana emergente.
• OSLC-QUERY-PAGESIZE: permite determinar el número de objetos remotos que se deben mostrar por página. De fábrica, se define en 50.
• DEFINE-RESOURCETYPE-ATTRIBUTE: permite especificar el nombre de atributo del servidor de OSLC de PTC Modeler que devuelve el valor del tipo de recurso. El valor por defecto es ptc_im_am:dynamicUmlClassName.
|
c. Ejecute el servicio DPTAdminConfigThing siguiendo estos pasos:
i. Inicie sesión en ThingWorx Platform como administrador.
ii. Vaya a la ficha > > > .
iii. Pulse en Ejecutar.
Después de ejecutar correctamente el servicio, aparece el siguiente mensaje: "Permissions applied successfully"
iv. Verifique que DPTEndUserGroup y DPTConfiguratorGroup se hayan creado en > . Asegúrese de que los permisos necesarios estén asignados a las entidades de ThingWorx Platform.
Para obtener más información, consulte Permisos por defecto para entidades de ThingWorx Platform.
|
|
• El servicio PostDPTExtensionImport solo lo puede ejecutar un administrador de ThingWorx.
• Los miembros y permisos existentes de DPTEndUserGroup y DPTConfiguratorGroup se conservan después de ejecutar el servicio.
|
2. En ThingWorx Flow, utilice las siguientes instrucciones y cree una nueva conexión para el sistema de OSLC con el que se requiere la integración. Consulte el tema Creación y gestión de conexiones en el Centro de ayuda de ThingWorx Platform.
a. Cree una Conexión para el sistema de OSLC.
▪ Para la autenticación básica, seleccione el tipo de conexión Básica de OSLC.
▪ Para la configuración de SSO, cree una conexión OAuth.
Antes de crear una conexión de OAuth, asegúrese de que se haya configurado un proveedor de OAuth en ThingWorx Flow. Para obtener más información, consulte Creating and Managing OAuth providers y Configuring and Loading OAuths en el Centro de ayuda de ThingWorx Flow.
|
|
Se debe aceptar la aprobación de concesión para el objeto de conexión de sesión OAuth de OSLC. Para obtener más información, consulte Creación de conexiones de cliente de OAuth para ThingWorx.
|
b. Introduzca la siguiente información en la ventana Añadir conexión:
▪ Rótulo de conexión: permite introducir un nombre para la conexión. El nombre de conexión especificado aquí se utiliza en la cosa de la configuración.
▪ URL del catálogo: escriba el URL del catálogo del servidor de OSLC del sistema externo. Consulte PTC RV&S OSLC Client guide (12.3.0.0 en adelante) de en los documentos de referencia, OSLC integration with Integrity Modeler y OSLC integration with IBM Rational DOORS Next Generation en el Centro de ayuda de PTC Modeler.
|
|
Consulte la documentación de su versión soportada de las aplicaciones PTC RV&S y PTC Modeler.
|
▪ Credenciales de conexión a la cuenta de servicio del sistema externo para acceder al servidor de OSLC.
▪ Solicitudes simultáneas: permite especificar el número de solicitudes de recursos simultáneas que se han invocado desde ThingWorx Flow. El valor por defecto es 5.
Los administradores pueden modificar el número de solicitudes en función de la configuración del servidor.
c. Guarde la conexión.
d. Pulse en Cerrar.
 |
No modifique el conector PTC Modeler por defecto en ThingWorx Flow.
|
3. Configure ThingWorx Platform para integrar con servidores de OSLC del sistema externo. En ThingWorx Platform, cree una cosa de configuración.
Para crear una cosa de configuración:
a. Navegue hasta > y especifique los valores de los atributos. Seleccione PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate como Plantilla de cosa base.
b. En la ficha Configuración, configure las asignaciones tal como se explica en las tablas siguientes. Se puede consultar las cosas de configuración de referencia de PTC como una referencia e introducir los detalles del sistema de OSLC.
▪ OSLCServerMappingConfigTable
|
Atributo
|
Descripción
|
||
|---|---|---|---|
|
Servidor
|
Nombre del servidor de OSLC externo.
|
||
|
BaseUrl
|
URL base del servidor de OSLC del sistema externo.
|
||
|
ConnectionObject
|
Nombre de la conexión creada para el servidor de OSLC externo.
|
||
|
Etiqueta
|
El valor de los Términos que se define en el vocabulario de la etiqueta del modelo PTC-PLM-Validation-Flows para identificar el servidor remoto.
Este paso es opcional. Este paso solo es obligatorio cuando se utiliza un flujo de validación.
Para obtener más información sobre la adición de etiquetas, consulte las etiquetas de temas en el Centro de ayuda de ThingWorx Platform.
|
▪ Asignación de atributos para OSLCResourceMappingConfigTable
|
Atributo
|
Descripción
|
|---|---|
|
WindchillType
|
Nombre interno del recurso de requisito o de arquitectura para gestión de tipos en Windchill. El vínculo de seguimiento se crea en el recurso.
|
|
OSLCResourceType
|
Tipo de recurso de requisito, recurso de arquitectura o sus subtipos definidos en el servidor de OSLC externo. El valor de OSLCResourceType es el nombre de los recursos y sus subtipos según la configuración del servidor de OSLC externo. Por ejemplo, en PTC Modeler, la actividad se define como un subtipo del recurso de dominio de arquitectura. Un usuario puede definir el nombre como Recurso|Actividad, donde la actividad es el subtipo para el recurso de tipo OSLC que pertenece al dominio de arquitectura. El nombre especificado para un tipo de recurso de arquitectura debe estar separado por la barra vertical.
|
Para obtener información sobre el nombre interno del recurso de requisito o de arquitectura, consulte Tipos y atributos en Requisitos y compatibilidad del sistema.
|
|
No reasigne un tipo de recurso de OSLC al tipo de objeto de Windchill si el tipo de recurso de OSLC ya está asignado a un tipo de objeto de Windchill. La reasignación del tipo de objeto de Windchill al tipo de recurso de OSLC, definido inicialmente en ThingWorx, una vez se haya realizado el seguimiento del objeto en Windchill, puede provocar daños en los datos.
|
▪ OSLCResourceAttributeMappingConfigTable
|
Atributo
|
Descripción
|
|---|---|
|
WindchillTableId
|
ID de tabla en Windchill, en la que se muestran los datos del servidor de OSLC del sistema externo.
Para añadir varios valores de ID de tabla, utilice una lista separada por comas.
|
|
WindchillType
|
Nombre interno del recurso de requisito o de arquitectura de Gestión de tipos y atributos en Windchill.
|
▪ Asignación de atributos para OSLCResourceAttributeMappingConfigTable
|
Atributo
|
Descripción
|
||
|---|---|---|---|
|
WindchillAttribute
|
Nombre del atributo de Windchill que se mostrará en la tabla Windchill.
|
||
|
OSLCResourceAttribute
|
Nombre del atributo de recurso de OSLC.
|
||
|
WindchillAttributeDataType
|
Tipo de datos del atributo de Windchill. String, Timestamp y RichText son los valores de tipo de datos soportados de fábrica.
|
||
|
IsPreview
|
Cuando se selecciona IsPreview para un atributo, se muestra la representación HTML del objeto remoto con seguimiento tal como la expone el servidor de OSLC externo.
Seleccione la casilla IsPreview para mostrar vistas previas pequeñas y grandes.
IsPreview está disponible en los atributos de tipo de datos String y RichText. Se muestra una vista previa pequeña para los dos tipos de datos; sin embargo, la vista previa grande solo se muestra para los atributos de tipo de datos String.
|
▪ OSLCResourceShapeConfigTable
|
Atributo
|
Descripción
|
|---|---|
|
OSLCResourceType
|
Tipos de recursos soportados de dominio Requisito, dominio Arquitectura o dominio Cambio, tal como se definen en el servidor de OSLC externo. El valor de OSLCResourceType es el nombre de los recursos, según la configuración del servidor de OSLC externo.
|
|
OSLCResourceShapeURI
|
URI de la forma del recurso de OSLC para los servidores de OSLC que no exponen la forma del recurso con el servicio de consulta de OSLC, pero exponen la forma del recurso con otro servicio. Por ejemplo, el servidor de OSLC de IBM Rational Doors NG expone la forma del recurso con el servicio Creation Factory.
|
▪ Asignación de atributos para OSLCResourceShapeConfigTable
|
Atributo
|
Descripción
|
|---|---|
|
WindchillAttribute
|
Nombre del atributo de Windchill que se mostrará en el panel Criterios de filtro del selector de búsquedas de recursos externos.
|
|
OSLCResourceAttribute
|
Para añadir un valor para un atributo de OSLC, siga la convención de asignación de nombres prefix:propertyName. Aquí, prefix es el afijo que se añade antes del nombre de la propiedad y propertyName es el nombre de atributo definido por el servidor de OSLC. Por ejemplo, para un atributo state expuesto por el servidor de OSLC de PTC RV&S, el valor de OSLCResourceAttribute es dcterms:state.
|
|
OSLCAttributeDataType
|
Tipo de datos del recurso de OSLC. String, LangString, XMLLiteral, Boolean, DateTime, Decimal, Double, Float e Integer son los valores de tipos de datos de OSLC soportados.
|
▪ OSLCSearchResultConfigTable
|
Atributo
|
Descripción
|
|---|---|
|
WindchillType
|
Tipos de recursos de Windchill soportados para el dominio Requisito, el dominio Arquitectura o el dominio Cambio.
|
▪ Asignación de atributos para OSLCSearchResultConfigTable
|
Atributo
|
Descripción
|
||
|---|---|---|---|
|
WindchillAttribute
|
Nombre del atributo de Windchill que se mostrará en el panel Tabla de resultados de búsqueda del selector de búsquedas de recursos externos.
|
||
|
OSLCResourceAttribute
|
Nombre del atributo de recurso de OSLC.
|
||
|
WindchillAttributeDataType
|
Tipo de datos del atributo de Windchill. String, Timestamp y RichText son los valores de tipo de datos soportados de fábrica.
|
▪ OSLCRemoteConfigTable
|
Atributo
|
Descripción
|
||
|---|---|---|---|
|
ReverseLookupURL
|
URL relativo del servicio de búsqueda inversa para servidores de OSLC externos. Por ejemplo, para Codebeamer, especifique /cb/api/oslc/links/traceLinkResources.
|
||
|
Método
|
Método de solicitud HTTP soportado por el servicio de búsqueda inversa. Los valores válidos son GET y POST.
|
||
|
TraceableUrlPrefix
|
Prefijo utilizado junto con el artículo o el URL del objeto con seguimiento. Por ejemplo, para Codebeamer, especifique cb:traceLinkTargetURI.
|
||
|
PageSize
|
Determina el número máximo de elementos remotos que puede obtener en una sola llamada el servicio de búsqueda inversa de OSLC.
El límite por defecto es 200 para PTC RV&S y 500 para Codebeamer.
Si el valor configurado supera el límite por defecto, la funcionalidad de búsqueda inversa falla.
|
|
|
La funcionalidad de búsqueda inversa se soporta para los servidores de OSLC PTC Modeler, PTC RV&S y Codebeamer. Asegúrese de que los valores de atributo mencionados anteriormente estén definidos solo en los ficheros de configuración de referencia de los servidores de OSLC soportados.
|
c. Pulse en Guardar y continuar.