Personalización avanzada > Uso de componentes reutilizables
  
Uso de componentes reutilizables
Resumen
En este tema se proporciona un breve resumen de los componentes reutilizables BETA de ThingWorx Navigate, que se basa en las directrices y prácticas recomendadas para la creación de componentes de ThingWorx.
Al crear aplicaciones, es eficaz reutilizar los componentes estándar. Estos componentes reutilizables se convierten en la base de la aplicación y se pueden configurar y personalizar para que se adapten a su caso de negocio.
Para obtener más información general sobre los componentes reutilizables, consulte la sección Creación de aplicaciones de ThingWorx mediante componentes reutilizables en el centro de ayuda de ThingWorx.
En este tema se proporciona información sobre lo siguiente:
Componentes reutilizables en ThingWorx Navigate
Inclusión de componentes reutilizables en el mashup
Configuración de componentes reutilizables
Personalización de componentes reutilizables
Componentes reutilizables en ThingWorx Navigate
En ThingWorx Navigate 8.5 se introducen los componentes reutilizables BETA. Los componentes reutilizables mejoran y simplifican el desarrollo de tareas porque proporcionan componentes de fábrica listos para montarse en tareas personalizadas.
* 
Estos componentes se publican como BETA con documentación limitada y están disponibles para pruebas y evaluación. No se recomienda su uso en un entorno de producción.
La primera selección de componentes reutilizables se ha creado para el desarrollo de la tarea Mis tareas. Esta tarea es la primera de la serie de tareas de ThingWorx Navigate Contribute.
Cuando se inserta un componente reutilizable en un mashup, el componente tiene una configuración por defecto. En general, la configuración por defecto no tiene ninguna funcionalidad inherente y el componente reutilizable requiere una configuración adicional para poder trabajar. Algunos componentes reutilizables también tienen una o varias configuraciones predefinidas disponibles, lo que permite utilizar estos componentes para aplicaciones especializadas con una configuración adicional mínima. Por ejemplo, el componente Lista de elementos tiene cuatro configuraciones predefinidas: lista de tareas, lista de adjuntos, lista de elementos afectados y lista de actividades. Cada una de ellas es una configuración especializada del componente Lista de elementos.
Las configuraciones predefinidas se conectan a Windchill como su sistema back-end. Toda la configuración de control de acceso, las configuraciones de visibilidad de atributos y los rótulos de seguridad configurados en Windchill se respetan en ThingWorx Navigate. Como resultado, los usuarios solo pueden ver lo que las reglas de Windchill les permiten ver.
Consulte la sección Configuración de componentes reutilizables a continuación para obtener más información sobre la configuración de componentes reutilizables y la selección de configuraciones predefinidas.
En el diagrama y la tabla siguientes se proporciona un resumen de los componentes reutilizables existentes y sus configuraciones predefinidas. Los componentes reutilizables se basan en el sistema de diseño de PTC para garantizar la coherencia. En algunos de los componentes reutilizables se incluyen otros componentes reutilizables integrados. Por ejemplo, en el componente Lista de elementos se incluye el componente Barra de acciones.
Componente
Descripción
Tipo
Configuraciones predefinidas
Lista de elementos
Permite mostrar un conjunto de datos como una lista en formato de cuadrícula. Se incluyen funciones de clasificación, filtrado, búsqueda, así como funciones avanzadas adicionales.
Mashup contenido
Lista de tareas, lista de adjuntos, lista de elementos afectados, lista de actividades
Atributo
Permite mostrar los datos en forma de pares de nombre y valor. Se puede integrar en un panel de identidad del elemento.
Widget
Ninguno
Mosaico
Permite mostrar un conjunto de mosaicos que contienen datos en forma de par de nombre y valor.
Widget
Ninguno
Barra de acciones
Permite mostrar las acciones disponibles. Se puede integrar en un panel de lista de elementos o identidad del elemento para activar acciones dentro de estos componentes.
Widget
Ninguno
Identidad del elemento
Permite mostrar información de identidad básica sobre un elemento específico, incluidos los atributos de título e identidad.
Widget
Identidad de la tarea
Progreso de la tarea
Permite mostrar un resumen del progreso de la tarea, incluidos los votos de los miembros y el número de miembros que ya han realizado la acción.
Widget
Ninguno
Inclusión de componentes reutilizables en el mashup
1. En Mashup Builder, busque el componente deseado.
a. Para los componentes reutilizables que son widgets, vaya al panel Widgets y seleccione Beta del menú desplegable Categoría.
b. Para el componente reutilizable Lista de elementos, vaya al panel Mashups y busque PTC.ItemListMashup.
2. Arrastre el componente al mashup.
3. Configure el componente. Consulte la siguiente sección para obtener más información.
Configuración de componentes reutilizables
Los componentes reutilizables están en modo BETA a partir de ThingWorx Navigate 8.5. Como resultado, solo se pueden configurar los componentes editando sus ficheros de configuración JSON. En este punto, estos temas son la extensión del soporte disponible para la configuración de componentes reutilizables.
Para configurar un componente reutilizable, siga estos pasos:
1. Seleccione un componente reutilizable existente del mashup.
2. Pulse en de la parte superior derecha del panel Propiedades del widget. Aparece la ventana Configurar parámetros del mashup.
3. Si el componente reutilizable seleccionado tiene configuraciones predefinidas, está visible el menú desplegable Tipo de configuración. Se puede seleccionar una configuración predefinida del menú.
4. El componente reutilizable se puede configurar editando el fichero JSON en el cuadro Configuración.
* 
Se puede utilizar el botón Restaurar a valores por defecto para restaurar la configuración de fábrica. Se debe tener en cuenta que este botón no restaura la última configuración guardada.
5. Pulse en Terminado para guardar el trabajo. Cuando haya terminado de trabajar en Mashup Builder, pulse en Guardar de la parte superior de la página.
Personalización de componentes reutilizables
Un componente de ThingWorx Navigate 8.5 consta de una capa de interfaz de usuario y una capa de lógica empresarial. La capa de lógica empresarial del componente se puede personalizar. La parte personalizable del componente se denomina modelo de componente. Para personalizar el modelo de componente, siga estos pasos:
1. Herede la plantilla de cosa del modelo de componente.
2. Sustituya los servicios necesarios.
3. Cree una nueva cosa a partir de la plantilla de cosa.
4. Añada la cosa al valor de la propiedad de configuración modelThingName del componente.
Una vez que se hayan completado estos pasos, el componente utiliza el código personalizado del modelo en lugar del código de modelo de fábrica.