Creación de una nueva tarea desde el principio para ThingWorx Navigate
Para crear una tarea personalizada es necesario disponer de los conocimientos previos que se mencionan en el tema
Antes de personalizar.
Componentes de una tarea
La tarea se compone de varias partes básicas:
• Mashup: la interfaz de usuario de la tarea.
• Servicios de ThingWorx Navigate: Java o script de Java que realiza las acciones. Los servicios están en ptc-windchill-OData-connector.
• Windchill: el origen de los datos.
• Servicios REST de Windchill, también conocidos como WRS.
|
|
• En ThingWorx Navigate 8.5 se presentan componentes reutilizables, que son nuevos elementos disponibles para generar mashups de ThingWorx. Estos componentes se publican como BETA con documentación limitada y están disponibles para pruebas. No se recomienda utilizarlos en un entorno de producción.
• Versiones anteriores de los servicios RestEasy de ThingWorx Navigate utilizados para acceder a datos de Windchill. Los servicios RestEasy son servicios heredados y quedarán obsoletos en versiones futuras. En este ejemplo se utilizan servicios REST de Windchill (WRS) basados en OData y se recomienda utilizar los mismos. Para obtener información sobre cómo utilizar WRS y cómo añadir servicios personalizados, consulte la sección de personalización de la instalación de Windchill.
|
Resumen
Se utilizará un ejemplo para mostrar cómo combinar los componentes de una tarea en un mashup de trabajo. En este ejemplo se muestra una lista de partes de Windchill y sus atributos. Este es el aspecto que tendrá al finalizar:
Es útil planificar la funcionalidad y el diseño de la tarea antes de comenzar. De este modo, se sabrá cómo se presentarán los datos en la interfaz de usuario, los paneles que se necesitan para presentar estos datos y los servicios que se utilizarán con los paneles.
Muchos puntos finales, como
getPart (/ProdMgmt/Parts GET) y
createPartinParts (/ProdMgmt/Parts POST), ya están disponibles en los dominios de WRS. En este ejemplo, se utilizarán estos servicios. Si se necesita más información sobre la creación de servicios propios, empiece por el tema de ayuda de ThingWorx:
Thing Services. También se pueden encontrar pasos para algunos de los servicios que se utilizan con frecuencia en el manual de Windchill Extension.
Creación del mashup en ThingWorx Composer
En ThingWorx Composer, cree la interfaz de usuario para mostrar los datos.
1. Cree un nuevo mashup.
2. Configure el esquema del mashup para que coincida con la imagen que se muestra en la introducción.
3. Añada los widgets necesarios.
Configuración de una instancia del conector OData para comunicarse con el servicio ProdMgmt
Una vez diseñado el mashup, es necesario proporcionar el origen de la información que se debe mostrar.
1. Cree una cosa nueva en ThingWorx denominada Windchill REST Services. En Plantilla de cosa base, seleccione ODataConnector.
2. Vaya a la ficha
Configuración de la cosa y rellene los URL base, los URL relativos y el URL de conexión. El URL base y el URL relativo forman el URL completo para conectarse al servidor. El URL de conexión se utiliza para verificar la conectividad entre los sistemas. Pulse en
Guardar.
3. Cree la definición de datos obligatoria en ThingWorx. La definición de datos se utiliza para describir las partes de datos del modelo. En este ejemplo se muestran atributos, tales como PartNumber, PartName, PartVersion y PartID. Para representar estos atributos, cree la definición de datos PartList y añada estas definiciones de campo.
Identificación del extremo que proporciona una lista de artículos y configuración de un servicio de distribución
En este paso, se añadirán los servicios de distribución para que el mashup funcione. Antes de seleccionar el extremo en
ThingWorx, es aconsejable comprender las relaciones que expone el servicio en el modelo de datos de entidad. A continuación, se muestra un ejemplo de la descripción de los tipos, las propiedades y las relaciones que el servicio expone en el dominio de gestión de productos. Como se muestra en la figura, hay un conjunto de entidades
Parts cuyo tipo de entidad es
Part. Se puede acceder a todas las propiedades de
Parts mediante el acceso a este conjunto de entidades a través de la ruta definida en los servicios OData. Para obtener más información, consulte la documentación de WRS.
1. Busque el extremo getParts (/ProdMgmt/Parts GET) en la información de distribución. Cree una nueva asignación de API seleccionando el extremo getParts.
2. Seleccione la definición de datos PartList para asignar los atributos que desea que se muestren en el mashup.
Llamada al servicio desde el mashup para cargar la lista de artículos en la rejilla
Ahora que se han creado nuevos servicios de distribución, es necesario conectar estos servicios al mashup. En este paso, se añadirá el origen de datos y los servicios que se necesitan para que el mashup funcione.
1. Vaya al mashup y pulse en la ficha Diseñar.
2. Añada un nuevo origen de datos pulsando en
de la ficha
Datos.
3. Seleccione el servicio
getPartList para mostrar la lista de artículos en el mashup. Seleccione la casilla
¿Mashup cargado? para mostrar los datos en cuanto se cargan.
Visualización de la nueva tarea
1. Pulse en Ver mashup. Se abre la nueva tarea. Enhorabuena.
