Disattivazione e riattivazione degli asset
La disattivazione degli asset è il processo che blocca tutte le comunicazioni tra un oggetto e la piattaforma. Se un oggetto viene disattivato, i messaggi dalla piattaforma all'oggetto non vengono inviati, né conservati. Allo stesso modo, anche i messaggi dall'oggetto alla piattaforma vengono bloccati e non vengono conservati.
La possibilità di disattivare gli oggetti è utile per vari casi aziendali. La piattaforma potrebbe distribuire oggetti che non comunicano frequentemente e potrebbero inviare messaggi imprecisi o non necessari. Ad esempio, in caso di problemi relativi al volume di dati inviati da un agente o alla frequenza delle sue comunicazioni con la piattaforma, disattivare l'oggetto può essere una soluzione immediata. La disattivazione di un oggetto comporta l'interruzione dei messaggi da e verso l'oggetto per consentire agli amministratori della piattaforma di risolvere i problemi relativi ai modelli di comunicazione, al volume di dati e alle velocità di trasmissione.
La funzionalità di disattivazione o riattivazione degli oggetti è applicabile solo per gli oggetti remoti basati su Axeda creati utilizzando i modelli di oggetto AxedaBaseModel o i relativi modelli di oggetto derivati. Per ulteriori informazioni sui modelli di oggetto Axeda, vedere Modelli di oggetto ACE.
• Gli utenti possono disattivare o riattivare gli oggetti creati utilizzando i modelli di oggetto AxedaStandaloneModel, AxedaEMessageGatewayModel. Quando si disattiva o si riattiva un oggetto gateway, la disattivazione o la riattivazione dei dispositivi gestiti avviene automaticamente.
• La disattivazione o la riattivazione non è supportata per i dispositivi gestiti utilizzando il modello di oggetto AxedaManagedModel. La disattivazione o la riattivazione di un dispositivo gestito deve essere eseguita tramite il relativo oggetto gateway.
• La thing shape Mutable viene implementata automaticamente per gli oggetti remoti basati su Axeda creati utilizzando i modelli di oggetto AxedaBaseModel. Per tutti gli altri oggetti, l'implementazione della thing shape Mutable genera un'eccezione.
Per utilizzare la funzionalità di disattivazione e riattivazione, utilizzare ThingWorx 9.7.0 e Axeda Compatibility Package 2.6.0 (inclusi eMessage Server, Axeda Compatibility Extension e Remote Access Extension). Per ulteriori informazioni sulle versioni compatibili, vedere Release Advisor.
 |
Per creare manualmente o a livello di programmazione oggetti in base al modello di oggetto AxedaBaseModel o ai relativi modelli di oggetto derivati, è necessario disporre dei permessi di visibilità per le thing shape Mutable, MutableGateway e MutableManagedDevice.
|
Disattivazione e riattivazione dell'oggetto remoto basato su Axeda
Per disattivare o riattivare un oggetto, utilizzare i metodi seguenti:
• Servizi
Sono disponibili due servizi per gli oggetti remoti basati su Axeda, tramite la thing shape Mutable.
◦ Mute: questo servizio disattiva l'oggetto e blocca tutte le comunicazioni tra un oggetto e la piattaforma. Se l'oggetto è un gateway, disattiva anche tutti gli oggetti gestiti.
◦ Unmute: questo servizio riattiva l'oggetto e consente tutte le comunicazioni tra un oggetto e la piattaforma. Se l'oggetto è un gateway, riattiva anche tutti gli oggetti gestiti.
• Interfaccia utente di Composer
L'utente può disattivare o riattivare l'oggetto con la casella di controllo nella pagina Informazioni generali solo per i dispositivi Axeda.
|
|
• Quando si crea un oggetto utilizzando i modelli di asset Axeda per la prima volta, il campo Disattivato potrebbe non essere visualizzato immediatamente nella pagina Informazioni generali dell'oggetto. Per visualizzare il campo, attendere alcuni istanti, quindi aggiornare Composer o chiudere e riaprire l'oggetto (entità).
Se l'oggetto non è un dispositivo Axeda e si prova ad aggiungere una thing shape Mutable, a impostare la casella di controllo Disattivato su true o a salvare l'oggetto, viene generato un errore.
• La disattivazione e la riattivazione sono supportate solo tramite i rispettivi servizi o l'interfaccia utente di Composer. È consigliabile non modificare la configurazione di disattivazione durante l'importazione XML.
• In caso di utilizzo delle funzionalità di disattivazione e riattivazione sono disponibili i messaggi di errore seguenti:
◦ Durante il tentativo di disattivare un oggetto remoto non Axeda: Muting/Unmuting is not supported for this Thing.
◦ Durante il tentativo di disattivare un oggetto gestito: Muting/Unmuting of managed Things is not supported.
◦ Durante l'esecuzione di un gateway, se non è possibile disattivare l'oggetto gestito: An error occurred while Muting/Unmuting managed devices. Retry Mute/Unmute on the Gateway.
|
Verifica dell'attivazione o disattivazione dell'asset
Per verificare se un oggetto è attivato o disattivato, utilizzare i metodi seguenti:
• Servizi
Con la versione più recente di ThingWorx e delle estensioni ThingWorx, il servizio IsMuted è disponibile (tramite la thing shape Mutable) per gli oggetti remoti basati su Axeda.
IsMuted: questo servizio mostra se l'oggetto è disattivato o meno.
• Composer
◦ In Monitoraggio, nella pagina Oggetti remoti, l'utente può visualizzare la nuova colonna Disattivato. Se l'oggetto è disattivato, viene visualizzato Sì, se viene riattivato viene visualizzato, No e se sono presenti oggetti non Axeda, nella risposta viene indicato N/D.
◦ In Monitoraggio, nella pagina Oggetti remoti, utilizzare il filtro Disattivato per vedere quali oggetti sono disattivati e riattivati.
◦ Nella pagina Informazioni generali dell'oggetto è visibile la casella di controllo Disattivato.
Comportamento per la disattivazione e la riattivazione degli asset
Gateway
◦ Se il gateway viene disattivato, vengono disattivati automaticamente anche gli oggetti gestiti associati al gateway.
◦ Se il gateway viene disattivato, non è possibile riattivare l'oggetto gestito.
◦ Se il gateway viene riattivato, gli oggetti gestiti associati al gateway verranno riattivati automaticamente.
◦ Se il gateway viene riattivato, non è possibile disattivare l'oggetto gestito.
Proprietà dell'oggetto remoto basato su Axeda
Quando un oggetto viene disattivato, qualsiasi aggiornamento della proprietà con la proprietà remota ha esito negativo e viene restituito il messaggio AssetMutedException.
Ad esempio, viene visualizzato l'errore Thing is Muted, Unable to update <Nomeproprietà> on <Nomeoggetto>.
Servizio dell'oggetto remoto basato su Axeda
Quando un oggetto viene disattivato, il tentativo di eseguire qualsiasi servizio remoto ha esito negativo e viene restituito il messaggio AssetMutedException.
Ad esempio, viene visualizzato l'errore Thing is Muted, Unable to invoke <NomeServizio> on <Nomeoggetto>.
Operazioni di trasferimento file
Se l'oggetto viene disattivato, le nuove operazioni di trasferimento file hanno esito negativo e viene restituito l'errore AssetMutedException.
Le operazioni attive di trasferimento file continuano a funzionare anche per gli oggetti disattivati.
Sessioni remote
◦ Se l'oggetto viene disattivato, le nuove sessioni remote hanno esito negativo e viene restituita un' eccezione.
Ad esempio: You are not allowed to start a remote session on a muted asset <name>.
◦ Le sessioni remote attive continueranno a funzionare anche se l'oggetto è disattivato.
Permessi utente per la disattivazione e la riattivazione
È stato aggiunto un gruppo di utenti predefinito denominato MuteUnmuteUsers, che consente a un gruppo selezionato di utenti di disattivare e riattivare gli asset. Per quanto riguarda i permessi per i servizi, seguirà il paradigma dei permessi ThingWorx. Per ulteriori informazioni, vedere Gruppi di utenti.
Log verifiche
Se i log verifiche sono attivati, vengono registrate le voci di log seguenti:
• Il tipo di azione: disattivazione o riattivazione.
• Nome dell'oggetto interessato.
• Data e ora dell'azione.
• Il tipo di utente che ha eseguito l'azione.
