Disattivazione e riattivazione degli asset
La disattivazione di un asset consiste nel bloccare tutte le comunicazioni tra un oggetto e la piattaforma, il che significa che qualsiasi messaggio che la piattaforma tenta di inviare all'oggetto non viene né inviato né conservato. Allo stesso modo, i messaggi che l'oggetto prova a inviare alla piattaforma vengono bloccati e non 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 disattivabile 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 disattivabile genererà 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.
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 disattivabile.
◦ 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, è necessario attendere qualche istante prima di visualizzare il campo Disattivato nella pagina Informazioni generali dell'oggetto. Dopo avere atteso, per visualizzare il campo Disattivato, chiudere o riaprire l'oggetto (entità) oppure aggiornare Composer.
• Se l'oggetto non è un dispositivo Axeda e si prova ad aggiungere una thing shape modificabile, a impostare la casella di controllo Disattivato su true o a salvare l'oggetto, viene generato un errore.
• L'attivazione e la riattivazione dei dispositivi è supportata solo tramite i servizi di disattivazione e riattivazione e l'interfaccia utente di Composer. È consigliabile non modificare la configurazione di disattivazione durante l'importazione XML.
• Per le 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 disattivabile) 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 l'errore 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 l'errore 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.
