Adición de un controlador de notificaciones personalizado

Personalización del contenido y el acceso a la información > Adición de un controlador de notificaciones personalizado

Con ThingWorx Apps se ofrecen dos métodos de entrega de notificaciones: por correo electrónico y por mensaje de texto (SMS). Estos métodos de entrega se activan y se configuran en Instalación y configuración > Entrega de notificaciones. Por defecto, para que los usuarios individuales puedan añadirse como destinatarios de una notificación de alerta, deben tener su Preferencia de notificación configurada en Instalación y configuración > Usuarios.

Para utilizar otro método de entrega para las notificaciones, puede crear otro controlador de notificaciones y establecerlo como AdditionalAlertNotificationHandler en la página Configuración de PTC.Factory.C_LaunchPointConfigurationThing_[versión]. A continuación, se podrá añadir a cualquier usuario como destinatario en una alerta.

Procedimiento para crear un controlador de notificaciones:

1. Cree una nueva definición de datos, por ejemplo MyNotificationHandlerContent, y pulse en Guardar. En esta definición de datos es donde, si lo necesita, puede definir el contenido de la notificación. Para ver algunos ejemplos, consulte SMSContent y EmailContent.

2. Cree una plantilla de cosa nueva, por ejemplo MyNotificationHandlerTemplate, con una Plantilla de cosa base de NotificationHandler.

3. En MyNotificationHandlerTemplate, pulse en Servicios y luego en Añadir en la tabla Mis servicios para que se añada un nuevo servicio con un valor de Nombre de servicio de Notify. En Entradas, añada los parámetros de entrada siguientes:

Nombre	Tipo base	Definición de datos	Tipo de infotable
definition	NOTIFICATIONDEFINITIONNAME	—	—
event	INFOTABLE	Event	Solo infotable
config	INFOTABLE	Seleccionar la definición de datos creada en el paso 1, por ejemplo MyNotificationHandlerContent	Solo infotable

a. Pulse en Añadir bajo Entradas.

b. En la ventana Nueva entrada, indique las propiedades de un parámetro de entrada, como se muestra en la tabla.

c. Pulse en Terminado.

d. Repita los pasos del 3a al 3c para cada parámetro de entrada.

Pulse en Terminado para crear el nuevo servicio.

4. Pulse en Guardar.

5. Cree una cosa nueva, por ejemplo MyNotificationHandler, con el valor de Plantilla de cosa definido en la plantilla de la cosa creada en el paso 2. Pulse en Guardar.

6. Cree un token de localización para la cosa del controlador de notificaciones, notificationHandlers.MyNotificationHandler. Para obtener más información, consulte Tablas de localización en el Centro de ayuda de ThingWorx.

7. En el menú Más en la parte superior derecha de la cosa, seleccione Exportar para control de origen.

8. Abra el fichero exportado en un editor de texto.

9. Localice las etiquetas ConfigurationTable. Dentro de las etiquetas ConfigurationTable, busque las etiquetas Rows vacías.

10. Añada el siguiente contenido dentro de las etiquetas Rows:

Sustituya las variables como se indica a continuación:

◦ <DataShape>: Nombre de la definición de datos creada en el paso 1.

◦ <UUID>: Identificador exclusivo universal (UUID). Para generar el UUID, utilice un generador de UUID como https://www.uuidgenerator.net.

◦ <TokenName>: Token de localización creado en el paso 6.

◦ <Service>: Servicio creado en el paso 3.

Por ejemplo:

11. Guarde el fichero.

12. En ThingWorx Composer, seleccione Importar/Exportar > Importar > Desde fichero.

13. Pulse en Elegir fichero y vaya al fichero de exportación actualizado.

14. Asegúrese de que esté seleccionada la opción Entidades y pulse en Importar.

15. Pulse en Cerrar.

16. Abra PTC.Factory.C_LaunchPointConfigurationThing_[versión] y pulse en Configuración.

17. Para AdditionalAlertNotificationHandler, busque la cosa creada en el paso 7 y selecciónela (por ejemplo,MyNotificationHandler). Pulse en Guardar.

Ahora, al crear una alerta, puede seleccionarse cualquier usuario como destinatario de alerta, no solo los usuarios que tienen configurada su Preferencia de notificación. Para obtener más información, consulte Configuración de alertas.