Creación de una tarea personalizada
Para crear una tarea personalizada es necesario disponer de los conocimientos previos que se mencionan en el tema
Personalización de ThingWorx Navigate.
Componentes de una tarea
Una tarea de ThingWorx Navigate se compone de varias partes básicas:
• Mashup: la interfaz de usuario de la tarea.
• Servicios de ThingWorx Navigate: Java o JavaScript que realiza las acciones. Hay varios servicios disponibles en el conector de integración ptc-windchill-OData-connector.
• Windchill: el origen de los datos.
• Servicios REST de Windchill, también conocidos como WRS.
|
En este ejemplo se utiliza Windchill REST Services (WRS) para acceder a los datos de Windchill. WRS se basa en OData y es el enfoque recomendado para la personalización de ThingWorx Navigate. Los servicios RestEasy se quedarán obsoletos en una versión futura. Para obtener información sobre cómo utilizar y extender WRS, consulte la sección sobre personalización de la instalación de Windchill.
|
ThingWorx Navigate 9.0 presenta componentes reutilizables. Aunque estos componentes están disponibles para crear mashups de y se pueden utilizar en tareas personalizadas, no se tratan en este tema.
• Para ver un tutorial en el que se muestra cómo utilizar estos componentes para crear un mashup, consulte el tema
Tutorial de configuración.
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 deberán presentar 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 extremos, como
getPart (/ProdMgmt/Parts GET) y
createPartinParts (/ProdMgmt/Parts POST), ya están disponibles en los dominios de WRS. Estos servicios se utilizarán en el siguiente ejemplo. Para obtener más información sobre la creación de servicios propios, empiece por el tema
Servicios de cosa en el centro de ayuda de . También se pueden encontrar pasos para algunos de los servicios que se utilizan con frecuencia en el
Centro de ayuda de Windchill REST Services.
Para crear esta tarea personalizada, siga estos pasos en ThingWorx Composer:
1. Crear el proyecto
Cree un proyecto para organizar todas las entidades que formarán parte de la tarea personalizada.
1. Cree un proyecto nuevo e introduzca un nombre para el proyecto.
2. Guarde el proyecto.
2. Crear la definición de datos
Cree una definición de datos para representar los datos.
Para obtener más información sobre las definiciones de datos, consulte el tema
Definiciones de datos en el centro de ayuda de .
1. Cree una nueva definición de datos. Introduzca un nombre y, en Proyecto, añada el nombre del proyecto creado en el paso anterior.
2. Acceda a la ficha Definiciones de campo.
3. Añada las siguientes definiciones de campo, cada una con un Tipo base de STRING:
◦ PartNumber
◦ PartName
◦ PartVersion
◦ PartID
Estas definiciones de campo corresponden a los datos que se mostrarán en la tarea personalizada.
4. Guarde la definición de datos.
3. Configurar el conector OData
Configure una instancia del conector OData para proporcionar el origen de los datos que se mostrarán en la tarea.
En este paso, se configurará el conector OData y, en el siguiente paso, se creará la asignación de API y el servicio de distribución para los datos. Antes de seleccionar el extremo en
ThingWorx Composer, 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. Consulte el
Centro de ayuda de Windchill REST Services para obtener más información.
1. Cree un nuevo conector de integración en ThingWorx Composer. En la ventana Elegir plantilla, seleccione ODataConnector y pulse en Aceptar. Introduzca un nombre y, en Proyecto, añada el nombre del proyecto creado anteriormente.
3. En
Configuración de conexión de OData Connector, añada un
URL relativo de la raíz del servicio con el formato
/<Versión de dominio>/<Identificador de dominio>, donde
/<Versión de dominio> es opcional. En este caso, el identificador de dominio es
ProdMgmt, pero asegúrese de utilizar el identificador de dominio correcto para su dominio. Para obtener más información, consulte el tema
OData Services as Domains en el centro de ayuda de Windchill REST Services.
4. Guarde el conector de integración.
5. Si lo desea, puede validar la conexión para verificar que se ha realizado correctamente. Pulse en la ficha Servicios y ejecute el servicio ValidateConnection. En la salida se muestra un Estado y un Mensaje en el que se indica el estado de la conexión.
4. Crear la asignación de API y el servicio de distribución
Cree la asignación de API, que asocia los atributos del sistema back-end a los atributos de la definición de datos. A continuación, cree el servicio de distribución para que el mashup pueda consumir los datos.
1. En el conector de integración que se ha creado en el paso anterior, vaya a la ficha Asignaciones de API. Pulse en Añadir.
2. En ID de asignación, se debe introducir un nombre para la asignación de API. Se puede utilizar cualquier valor para este campo
3. En Seleccionar definición de datos, seleccione la definición de datos que se ha creado anteriormente. La tabla Definición de datos se rellena con las definiciones de campo creadas anteriormente.
4. En Extremo, seleccione el extremo. Aquí se seleccionará getParts (/ProdMgmt/Parts GET). Después de seleccionar el extremo, la tabla de API se rellena con atributos.
5. Arrastre y suelte atributos de la tabla de API a sus definiciones de campo correspondientes. Aquí se utilizan los atributos de nivel superior Número, Nombre, Versión e ID.
| Contraiga los elementos de la tabla de API para facilitar la búsqueda de los atributos deseados. |
6. Seleccione la casilla Crear un servicio desde esta asignación para crear un servicio de distribución. Aquí el nombre por defecto del servicio es getParts. Si lo desea, puede cambiar el nombre del servicio.
7. Pulse en Terminado y guarde el conector de integración.
5. Crear el mashup
Cree el mashup, que sirve de interfaz de usuario para la tarea.
Como se ha mencionado anteriormente, para crear el mashup tiene la opción de utilizar widgets de o componentes de ThingWorx Navigate, o bien una combinación de ambos.
• Para obtener más información sobre la creación de mashups, consulte la sección
Mashup Builder en el centro de ayuda de .
• Para obtener más información sobre el uso de los widgets de , consulte la sección
Widgets del centro de ayuda de .
1. Cree un nuevo mashup. Introduzca un nombre y, en Proyecto, añada el nombre del proyecto creado anteriormente.
2. Añada la etiqueta TWXNavigate:AppMashup al mashup.
3. Pulse en la ficha Diseñar y configure el esquema del mashup. Aquí se utilizan cinco contenedores. Cuatro de los contenedores se utilizan para crear un borde de 30 píxeles y un contenedor se encuentra en el centro.
4. Añada los widgets necesarios. Aquí se añade el widget de Cuadrícula avanzada al contenedor central.
5. Añada un nuevo origen de datos pulsando en
![](../../ThingWorx_Navigate/images/plus_icon.png)
en el panel
Datos.
6. En Tipo de entidad, seleccione Conectores de integración. En Entidad, seleccione el conector de integración creado anteriormente.
7. Seleccione el servicio de distribución creado anteriormente. Aquí el nombre del servicio es
getParts. Pulse en
![](../../ThingWorx_Navigate/images/arrow_button.png)
o arrastre y suelte para añadir el servicio a la tabla
Servicios seleccionados.
8. Seleccione la casilla Ejecutar al cargar y pulse en Terminado.
9. En la ficha Datos, expanda getParts y expanda Datos devueltos. Seleccione Todos los datos y enlace esta opción con la propiedad Data del widget de Cuadrícula avanzada.
10. Guarde el mashup.
11. Pulse en Ver mashup. La tarea personalizada se abre en una ventana nueva.
Ahora se puede añadir la tarea a la página de aterrizaje de
ThingWorx Navigate y personalizarla. Consulte el tema,
Adición de una tarea personalizada a la página de inicio.