Prácticas recomendadas de modelo y datos de ThingWorx > Silenciamiento y reactivación de activos
Silenciamiento y reactivación de activos
El silenciamiento de activos es el proceso de bloquear toda la comunicación entre una cosa y la plataforma. Cuando se silencia una cosa, los mensajes de la plataforma a la cosa no se envían ni se conservan. Del mismo modo, los mensajes que la cosa envíe a la plataforma también se bloquean y no se conservan.
La capacidad de silenciar cosas es valiosa para distintos casos de negocio. La plataforma puede implementar cosas que no se comunican con frecuencia y pueden enviar mensajes inexactos o innecesarios. Por ejemplo, si hay preocupaciones sobre el volumen de datos que envía un agente o la frecuencia de sus comunicaciones con la plataforma, silenciar la cosa puede proporcionar un alivio inmediato. Al silenciar la cosa, se detienen los mensajes hacia y desde ella, lo que permite a los administradores de la plataforma tener tiempo para solucionar problemas de patrones de comunicación, volumen de datos y velocidades de transmisión.
La funcionalidad de silenciar o reactivar cosas solo se aplica a las cosas remotas basadas en Axeda que se crean mediante plantillas de cosa AxedaBaseModel o sus plantillas de cosa derivadas. Para obtener más información sobre las plantillas de cosa de Axeda, consulte ACE Thing Templates.
Los usuarios pueden silenciar o reactivar las cosas creadas mediante plantillas de cosa AxedaStandaloneModel, AxedaEMessageGatewayModel. Cuando una cosa de gateway está silenciada o se ha reactivado, sus dispositivos gestionados se silenciarán o reactivarán automáticamente.
El silenciamiento o la reactivación no se soporta en dispositivos gestionados mediante la plantilla de cosa AxedaManagedModel. El silenciamiento o la reactivación de un dispositivo gestionado se debe realizar a través de su cosa de gateway.
La definición de cosa que se puede silenciar se implementará automáticamente para las cosas remotas basadas en Axeda creadas mediante las plantillas de cosa AxedaBaseModel. Para todas las demás cosas, la implementación de la definición de cosa variable producirá una excepción.
Para utilizar la funcionalidad de silenciar y reactivar, utilice ThingWorx 9.7.0 y Axeda Compatibility Package 2.6.0 (incluidos eMessage Server, Axeda Compatibility Extension y Remote Access Extension). Para obtener más información sobre las versiones compatibles, consulte Release Advisor.
* 
Para crear manualmente o mediante programación cosas basadas en la plantilla de cosa AxedaBaseModel o sus plantillas de cosa derivadas, se deben tener permisos de visibilidad para las definiciones de cosa Mutable, MutableGateway y MutableManagedDevice.
Silenciamiento y reactivación de la cosa remota basada en Axeda
Para silenciar o reactivar una cosa, utilice los siguientes métodos:
Servicios:
Hay dos servicios disponibles para cosas remotas basadas en Axeda, a través de la definición de cosa variable.
Mute: este servicio silencia la cosa y bloquea toda la comunicación entre una cosa y la plataforma. Si la cosa es una gateway, también silencia todas las cosas gestionadas.
Unmute: este servicio reactiva la cosa y permite toda la comunicación entre una cosa y la plataforma. Si la cosa es una gateway, también se reactivan todas las cosas gestionadas.
Interfaz de usuario de Composer
El usuario puede silenciar o reactivar la cosa con la casilla de la página Información general solo para dispositivos Axeda.
* 
Al crear una cosa utilizando las plantillas de activo de Axeda por primera vez, es posible que el campo Silenciado no aparezca inmediatamente en la página Información general de la cosa. Para ver el campo, espere unos instantes y, a continuación, renueva Composer o cierre y vuelva a abrir la cosa (entidad).
Si la cosa no es un dispositivo Axeda, se producirá un error al añadir la definición de cosa variable, al definir la casilla Silenciado en true e intentar guardar la cosa.
El silenciamiento y la reactivación solo se soportan a través de los servicios de silenciar y reactivar o la interfaz de usuario de Composer. Se recomienda no cambiar la configuración de silencio a través de la importación xml.
Los siguientes mensajes de error están disponibles cuando se utiliza la funcionalidad de silenciar y reactivar:
Al intentar silenciar una cosa remota que no es de Axeda: Muting/Unmuting is not supported for this Thing.
Al intentar silenciar una cosa gestionada: Muting/Unmuting of managed Things is not supported.
Al ejecutar una gateway, si la cosa gestionada no se silencia: An error occurred while Muting/Unmuting managed devices. Retry Mute/Unmute on the Gateway.
Comprobación del silenciamiento o reactivación del activo
Para comprobar si una cosa está silenciada o se ha reactivado, utilice los siguientes métodos:
Servicios
Con ThingWorx y las extensiones más recientes de ThingWorx, el servicio IsMuted está disponible (a través de la definición de cosa variable) para cosas remotas basadas en Axeda.
IsMuted: este servicio permite mostrar si la cosa está silenciada o no.
Composer
En Supervisión, en la página Cosas remotas, el usuario puede ver una nueva columna Silenciado. Si la cosa está silenciada, mostrará , si la cosa no está silenciada, mostrará No, y si hay cosas que no son de Axeda, mostrará N/D en la respuesta.
En Supervisión, en la página Cosas remotas, utilice el filtro Silenciado para ver qué cosas están silenciadas o reactivadas.
En la página Información general de la cosa, la casilla Silenciado estará visible.
Comportamiento para silenciar y reactivar el activo
Gateway
Si la gateway se ha silenciado, las cosas gestionadas asociadas con ella se silenciarán automáticamente.
Si la gateway se ha silenciado, la cosa gestionada no se puede reactivar.
Si la gateway se reactiva, se reactivarán automáticamente las cosas gestionadas asociadas con ella.
Si la gateway se ha reactivado, la cosa gestionada no se puede silenciar.
Propiedades de la cosa remota basada en Axeda
Cuando una cosa está silenciada, cualquier actualización de propiedad con la propiedad remota fallará con AssetMutedException.
Por ejemplo, aparece un error Thing is Muted, Unable to update <NombrePropiedad> on <NombreCosa>.
Servicio de la cosa remota basada en Axeda
Cuando una cosa está silenciada, el intento de ejecutar cualquier servicio remoto fallará con AssetMutedException.
Por ejemplo, aparece un error Thing is Muted, Unable to invoke <NombreServicio> on <NombreCosa>.
Operaciones de transferencia de ficheros
Si la cosa está silenciada, las nuevas operaciones de transferencia de ficheros fallarán con AssetMutedException.
Las operaciones de transferencia de ficheros activas siguen funcionando incluso para las cosas silenciadas.
Sesiones remotas
Si la cosa está silenciada, las nuevas sesiones remotas fallarán con una excepción.
Por ejemplo:You are not allowed to start a remote session on a muted asset <name>.
Las sesiones remotas activas seguirán funcionando incluso si la cosa está silenciada.
Permisos de usuario para el silenciamiento y la reactivación
Se ha añadido un grupo de usuarios de fábrica denominado MuteUnmuteUsers que permite a un grupo de usuarios seleccionado silenciar y reactivar los activos. Seguirá el paradigma de permisos de ThingWorx, en lo que respecta a los permisos de servicio. Para obtener más información, consulte Grupos de usuarios.
Registros de auditoría
Si los registros de auditoría están activados, se registran las siguientes entradas de registro:
Tipo de acción: silenciar o reactivar.
Nombre de la cosa afectada.
La fecha y hora de la acción.
Tipo de usuario que ha realizado la acción.
¿Fue esto útil?