Inhibition et désinhibition des actifs
L'inhibition des actifs est le processus consistant à bloquer toute communication entre un objet et la plateforme, ce qui signifie que Les messages que la plateforme aurait besoin de transmettre à l'objet ne sont ni envoyés, ni conservés. De même, tout message que l'objet tenterait d'envoyer à la plateforme est bloqué et n'est pas conservé.
La possibilité d'inhiber des objets est utile dans différents cas d'utilisation métier. La plateforme peut déployer des objets qui ne communiquent pas fréquemment et peuvent envoyer des messages inexacts ou inutiles. Par exemple, si le volume de données qu'un agent envoie ou la fréquence de ses communications avec la plateforme sont préoccupants, l'inhibition de l'objet peut apporter une réponse immédiate. L'inhibition de l'objet arrête les messages à destination et en provenance de l'objet, ce qui laisse aux administrateurs de la plateforme le temps de résoudre les problèmes liés aux schémas de communication, au volume de données et aux taux de transmission.
La fonctionnalité d'inhibition ou de désinhibition des objets s'applique uniquement aux objets distants basés sur Axeda qui sont créés à l'aide des modèles d'objet AxedaBaseModel ou de ses modèles d'objet dérivés. Pour plus d'informations sur les modèles d'objet Axeda, consultez la rubrique ACE Thing Templates.
• Les utilisateurs peuvent inhiber ou désinhiber les objets créés à l'aide des modèles d'objet AxedaStandaloneModel et AxedaEMessageGatewayModel. Lorsqu'un objet de passerelle est inhibé ou désinhibé, ses appareils gérés le seront aussi automatiquement.
• L'inhibition ou la désinhibition ne sont pas prises en charge pour les appareils gérés à l'aide du modèle d'objet AxedaManagedModel. L'inhibition ou la désinhibition d'un appareil géré doit être effectuée via son objet de passerelle.
• La forme d'objet "Mutable" sera automatiquement implémentée pour les objets distants basés sur Axeda et créés à l'aide des modèles d'objet AxedaBaseModel. Pour tous les autres objets, l'implémentation de la forme d'objet "Mutable" lèvera une exception.
Pour utiliser les fonctionnalités d'inhibition et de désinhibition, utilisez ThingWorx 9.7.0 et Axeda Compatibility Package 2.6.0 (y compris eMessage Server, Axeda Compatibility Extension et Remote Access Extension). Pour plus d'informations sur les versions compatibles, consultez Release Advisor.
Inhibition et désinhibition de l'objet distant basé sur Axeda
Pour inhiber ou désinhiber un objet, procédez comme suit :
• Services :
Deux services sont disponibles pour les objets distants basés sur Axeda, via la forme d'objet "Mutable".
◦ Mute : ce service inhibe l'objet et bloque toute communication entre un objet et la plateforme. Si l'objet est une passerelle, le service inhibe également tous les objets gérés.
◦ Unmute : ce service désinhibe l'objet et autorise toute communication entre un objet et la plateforme. Si l'objet est une passerelle, le service désinhibe également tous les objets gérés.
• Interface utilisateur de Composer
L'utilisateur peut inhiber ou désinhiber l'objet en cochant la case de la page Informations générales pour les appareils Axeda uniquement.
 |
• Lorsque vous créez un objet à l'aide des modèles d'objet Axeda pour la première fois, patientez un certain temps pour voir le champ Muet sur la page Informations générales de l'objet. Une fois le temps d'attente écoulé, pour afficher le champ Muet, fermez ou rouvrez l'objet (entité), ou actualisez Composer.
• Si l'objet n'est pas un appareil Axeda, une erreur sera générée si vous ajoutez la forme d'objet "Mutable", cochez la case Muet et essayez d'enregistrer l'objet.
• L'inhibition et la désinhibition des appareils sont prises en charge via les services d'inhibition et de désinhibition, ainsi que via l'interface utilisateur de Composer uniquement. Il est recommandé de ne pas modifier la configuration d'inhibition via l'importation XML.
• Les messages d'erreur suivants sont disponibles pour les fonctions d'inhibition et de désinhibition :
◦ Lorsque vous tentez d'inhiber un objet distant autre qu'Axeda : Muting/Unmuting is not supported for this thing.
◦ Lorsque vous tentez d'inhiber un objet géré : Muting/Unmuting of managed Things is not supported.
◦ Lors de l'exécution d'une passerelle, si l'inhibition de l'objet géré échoue : An error occurred while Muting/Unmuting managed devices. Retry Mute/Unmute on the Gateway.
|
Vérification de l'état inhibé ou désinhibé d'un actif
Pour vérifier si un objet est inhibé ou désinhibé, procédez comme suit :
• Services
Avec les dernières versions de ThingWorx et de ses extensions, le service IsMuted est disponible (via la forme d'objet "Mutable") pour les objets distants basés sur Axeda.
IsMuted : ce service indique si l'objet est inhibé ou non.
• Composer
◦ Sous Surveillance, sur la page Objets distants, l'utilisateur peut voir une nouvelle colonne Muet. Si l'objet est inhibé, cette colonne affiche Oui, s'il est désinhibé, elle affiche Non, et s'il existe des objets autres qu'Axeda, N/A s'affiche dans la réponse.
◦ Sous Surveillance, sur la page Objets distants, utilisez le filtre Muet pour voir quels objets sont inhibés ou désinhibés.
◦ Sur la page Informations générales de l'objet, la case à cocher Muet sera visible.
Comportement de l'inhibition et de la désinhibition des actifs
Passerelle
◦ Si la passerelle est inhibée, les objets gérés qui lui sont associés sont automatiquement inhibés.
◦ Si la passerelle est inhibée, les objets gérés qui lui sont associés ne peuvent pas être désinhibés.
◦ Si la passerelle est désinhibée, les objets gérés qui lui sont associés sont automatiquement désinhibés.
◦ Si la passerelle est désinhibée, l'objet géré ne peut pas être inhibé.
Propriétés de l'objet distant basé sur Axeda
Lorsqu'un objet est inhibé, toute mise à jour de propriété avec la propriété distante échoue (AssetMutedException).
Par exemple, une erreur Thing is Muted, Unable to update <nomPropriété> on <nomObjet> s'affiche.
Service de l'objet distant basé sur Axeda
Lorsqu'un objet est inhibé, toute tentative d'exécution d'un service à distance échoue (AssetMutedException).
Par exemple, une erreur Thing is Muted, Unable to invoke <nomService> on <nomObjet> s'affiche.
Opérations de transfert de fichiers
Si l'objet est inhibé, les nouvelles opérations de transfert de fichiers échouent (AssetMutedException).
Les opérations de transfert de fichiers actives continuent de fonctionner, même pour les objets inhibés.
Sessions distantes
◦ Si l'objet est inhibé, les nouvelles sessions distantes échouent avec une exception.
Par ex. : You are not allowed to start a remote session on a muted asset <name>.
◦ Les sessions distantes actives continueront de fonctionner même si l'objet est inhibé.
Permissions utilisateur pour l'inhibition et la désinhibition
Un groupe d'utilisateurs standard appelé MuteUnmuteUsers est ajouté, permettant à un groupe d'utilisateurs sélectionné d'inhiber et de désinhiber des actifs. Il suivra le paradigme des permissions ThingWorx, en ce qui concerne les permissions de service. Pour plus d'informations, consultez la rubrique Groupes d'utilisateurs.
Journaux d'audit
Si les journaux d'audit sont activés, les entrées suivantes sont ajoutées :
• le type d'action (inhibition ou désinhibition) ;
• le nom de l'objet concerné ;
• la date et l'heure d'exécution de l'action ;
• le type d'utilisateur qui a effectué l'action.
