Schneider Electric EcoStruxure Augmented Operator Advisor - Runtime Manuale utente

Runtime

Scopo del documento

Questo documento descrive il EcoStruxure Augmented Operator Advisor Runtime e il

EcoStruxure Augmented Operator Advisor Manager integrato.

Leggere la EcoStruxure Augmented Operator Advisor Quick Start Guide per una panoramica di EcoStruxure Augmented Operator Advisor prima di utilizzare questo documento.

Si consiglia di seguire un corso di formazione di EcoStruxure Augmented Operator Advisor prima di utilizzare il prodotto.

Nota di validità

Questo documento è valido per la Versione 2.9 di EcoStruxure Augmented Operator

Advisor.

Marchi commerciali registrati:

• EcoStruxure

™

, Vijeo

™ e Harmony

™ sono marchi registrati di Schneider Electric.

• Chrome

™

, Google Pixel C

™ e Android

™ sono marchi registrati di Google LLC.

• Microsoft Edge

™ e Windows

™ sono marchi registrati di Microsoft Corporation.

• Firefox

™

è un marchio registrato di The Mozilla Foundation.

• iOS

™ e iPad

™ sono marchi registrati di Apple.

• Samsung Galaxy

™

è un marchio registrato di Samsung Electronics Co Ltd.

• Intel

Core

™

è un marchio registrato di Intel Corporation.

• Linux

è un marchio registrato di Linus Torvalds.

EIO0000003610.08

Runtime

Documenti correlati

Titolo della documentazione

EcoStruxure Augmented Operator Advisor Quick Start

Guide

EcoStruxure Augmented Operator Advisor Builder

User Manual

EcoStruxure Augmented Operator Advisor App User

Manual

Codice di riferimento

EIO0000003000 (ING)

EIO0000003001 (FRA)

EIO0000003002 (TED)

EIO0000003003 (SPA)

EIO0000003004 (ITA)

EIO0000003005 (CIN)

EIO0000003032 (GIA)

EIO0000003563 (COR)

EIO0000003006 (ING)

EIO0000003007 (FRA)

EIO0000003008 (TED)

EIO0000003009 (SPA)

EIO0000003010 (ITA)

EIO0000003011 (CIN)

EIO0000003033 (GIA)

EIO0000003564 (COR)

EIO0000003598 (ING)

EIO0000003599 (FRA)

EIO0000003600 (TED)

EIO0000003601 (SPA)

EIO0000003602 (ITA)

EIO0000003603 (CIN)

EIO0000003604 (GIA)

EIO0000003605 (COR)

È possibile scaricare tutta la documentazione tecnica disponibile, incluso questo documento, ed altre informazioni tecniche dal sito web www.se.com/en/download/ .

10 EIO0000003610.08

Runtime

Informazioni relative al prodotto

L'applicazione di questo prodotto richiede esperienza di progettazione e funzionamento dei sistemi di controllo.

AVVERTIMENTO

PERDITA DI CONTROLLO

• Il progettista degli schemi di controllo deve prendere in considerazione le potenziali modalità di errore dei vari percorsi di controllo e, per alcune funzioni di controllo particolarmente critiche, deve fornire i mezzi per raggiungere uno stato di sicurezza durante e dopo un errore di percorso. Funzioni di controllo critiche sono ad esempio l'arresto di emergenza e di oltrecorsa.

• Per le funzioni di controllo critiche occorre prevedere sequenze separate o ridondanti di controllo e monitoraggio.

• Le sequenze di controllo e monitoraggio del sistema possono includere link di comunicazione. È necessario tenere presente le possibili implicazioni di ritardi di trasmissione imprevisti o di errori del collegamento.

• Non utilizzare EcoStruxure Augmented Operator Advisor come mezzo principale di monitoraggio delle funzioni di controllo critiche.

• Ogni implementazione di EcoStruxure Augmented Operator Advisor deve essere testata a fondo individualmente per verificare il buon funzionamento prima di metterla in servizio.

Il mancato rispetto di queste istruzioni può provocare morte, gravi infortuni o danni alle apparecchiature.

AVVERTIMENTO

FUNZIONAMENTO ANOMALO DELL'APPARECCHIATURA

• Solo a personale autorizzato esperto nella progettazione e nel funzionamento dei sistemi di controllo è consentito programmare, installare, modificare e applicare questo prodotto.

• Rispettare la regolamentazione e le norme locali e nazionali sulla sicurezza.

Il mancato rispetto di queste istruzioni può provocare morte, gravi infortuni o danni alle apparecchiature.

EIO0000003610.08

Runtime

Accesso a EcoStruxure Augmented Operator Advisor Manager, pagina 16

ATTENZIONE

FALSO RILEVAMENTO DELLA SCENA

• Utilizzare i tag nei casi in cui ambienti e/o apparecchiature simili possono determinare un falso rilevamento della scena.

• Apporre i tag saldamente all'apparecchiatura con sufficiente protezione da danni o deterioramento.

Il mancato rispetto di queste istruzioni può provocare infortuni o danni alle apparecchiature.

AVVISO

ACCESSO OPERATORE NON AUTORIZZATO

• Mantenere nomi utente e password segreti.

• Proteggere l'accesso a tablet e dispositivo Runtime con una password o altro meccanismo di sicurezza.

• Non condividere l'accesso con altri.

• Cambiare le password predefinite alla prima connessione.

• Aggiornare le password con regolarità.

• Applicare le relative regole IT locali.

• Non salvare informazioni riservate in post-it o notebook.

• Non allegare ai progetti documenti confidenziali o riservati relativi agli utenti.

Il mancato rispetto di queste istruzioni può provocare danni alle apparecchiature.

12 EIO0000003610.08

Introduzione

Runtime

Introduzione a EcoStruxure Augmented Operator

Advisor Runtime

EcoStruxure Augmented Operator Advisor Runtime è installato su un PC Harmony GTU

Open Box, Harmony iPC / PC industriale o PC Windows standard (vedere EcoStruxure

Augmented Operator Advisor, Guida di riferimento rapido).

EcoStruxure Augmented Operator Advisor Runtime raccoglie tutte le informazioni da visualizzare nei punti di interesse e le invia per la visualizzazione dall'EcoStruxure

Augmented Operator Advisor App. Gestisce inoltre il database contenente le fotografie delle scene e dell'apparecchiatura contenute nel progetto caricato.

Prima di installare EcoStruxure Augmented Operator Advisor Runtime, devono essere rispettati i prerequisiti seguenti:

• Deve essere installato Microsoft .NET Framework, versione 4.7.2 o successive.

• L'accesso fisico al dispositivo runtime deve essere protetto tramite installazione in un armadio chiuso presso il proprio sito o edificio.

• EcoStruxure Augmented Operator Advisor Runtime deve essere installato solo da un utente con autorizzazioni di amministratore sul dispositivo di runtime.

• Tutte le cartelle e i file installati e utilizzati dal software devono trovarsi in un'ubicazione in cui sono richieste autorizzazioni di amministrazione.

• L'unità disco rigido su cui è installato il EcoStruxure Augmented Operator Advisor

Runtime deve essere crittografato per proteggere il database utente, ad esempio, con

BitLocker.

• Solo agli utenti autorizzati è consentito distribuire il progetto. Autorizzazioni di installazione per limitare l'accesso alla cartella dati del progetto sul dispositivo runtime.

EIO0000003610.08

Runtime

Interfaccia EcoStruxure Augmented Operator

Advisor Runtime

Introduzione

7 8

Augmented Operator Advisor – Runtime Versione x.y

Progetto

Documenti

Impostazioni

Node-RED

Lingua

AOA Manager

Augmented Operator Advisor

Versione x.y

Stato licenza

Attivato

Server avviato

Progetto — importare il file .zip compilato di un progetto, creato in EcoStruxure

Augmented Operator Advisor Builder. Vengono visualizzate le informazioni sul progetto importato.

Documenti — importare un file .zip per ospitare i documenti in EcoStruxure

Augmented Operator Advisor Runtime, oppure configurare un accesso remoto all'ubicazione dei documenti. Viene visualizzato il numero di documenti supportati o l'indirizzo URL della rispettiva ubicazione.

Impostazioni — configurare le impostazioni della porta di EcoStruxure Augmented

Operator Advisor Runtime e la connessione con EcoStruxure Machine Advisor (vedere

EcoStruxure Augmented Operator Advisor, Guida di riferimento rapido)

Node-RED — configurare la connessione con Node-RED

Lingua — selezionare la lingua di EcoStruxure Augmented Operator Advisor Runtime

Guida — consultare la documentazione utente di EcoStruxure Augmented Operator

Advisor

Informazioni su — vengono visualizzate la versione del prodotto e le informazioni sulla licenza

14 EIO0000003610.08

Introduzione

Aggiunta di documenti

Runtime

Nella scheda Documenti , è possibile aggiungere i documenti ospitati, importati in precedenza in EcoStruxure Augmented Operator Advisor Builder.

È possibile aggiungere i documenti ospitati in due modi diversi, in base all'ubicazione di memorizzazione: locale e remota.

I documenti locali sono memorizzati in EcoStruxure Augmented Operator Advisor

Runtime. In questo modo sono sempre accessibili all'EcoStruxure Augmented Operator

Advisor App senza occupare la memoria del tablet. Utilizzare questa opzione se non si dispone di un'infrastruttura IT per ospitare i documenti.

Se si dispone di un'infrastruttura IT, è possibile utilizzare l'opzione Documenti remoti per configurare il reindirizzamento o un proxy per il file server.

Prerequisiti: prima di aggiungere documenti, configurare e aggiornare la protezione antivirus aziendale sul dispositivo runtime e sul file server.

Per importare i Documenti locali dal file .zip importato in EcoStruxure Augmented Operator

Advisor Builder:

1. Avviare EcoStruxure Augmented Operator Advisor Runtime e fare clic sulla scheda

Documenti .

2. Selezionare Documenti locali .

3. Fare clic su Sfoglia e selezionare il file .zip da importare.

NOTA: EcoStruxure Augmented Operator Advisor utilizza il code page 437.

Quando si crea il file .zip, utilizzare l'opzione Unicode (UTF-8) se i nomi dei file contenuti nello .zip non vengono visualizzati correttamente dopo l'importazione.

4. Fare clic su Applica .

Risultato : viene visualizzato il numero di documenti supportati.

NOTA: In alternativa, se sono presenti solo pochi documenti da aggiungere, è possibile copiare i documenti supportati direttamente in Start > EcoStruxure Augmented

Operator Advisor > Cartella documenti runtime .

Per configurare l'accesso ai Documenti remoti :

1. Avviare EcoStruxure Augmented Operator Advisor Runtime e fare clic sulla scheda

Documenti .

2. Selezionare Documenti remoti .

3. Selezionare Reindirizzamento o Proxy e immettere l'indirizzo URL dell'ubicazione dei documenti.

4. Fare clic su Applica .

EIO0000003610.08

Runtime

Utilizzo di EcoStruxure Augmented Operator

Advisor Manager

Il EcoStruxure Augmented Operator Advisor Runtime include EcoStruxure Augmented

Operator Advisor Manager, che viene installato automaticamente quando EcoStruxure

Augmented Operator Advisor Runtime è installato (vedere EcoStruxure Augmented

Operator Advisor, Guida di riferimento rapido).

Con il software EcoStruxure Augmented Operator Advisor Manager è possibile:

• Gestire credenziali di utenti (runtime/manager e operatori) e visualizzare un elenco di tutti gli utenti (aggiunti, eliminati o modificati) nella scheda UTENTI .

• Visualizzare un elenco di tutte le procedure completate dagli operatori nell'EcoStruxure

Augmented Operator Advisor App nella scheda PROCEDURE .

• Visualizzare un elenco di tutte le note nelle scene create dagli operatori nell'EcoStruxure Augmented Operator Advisor App nella scheda NOTE .

Avvio di EcoStruxure Augmented Operator

Advisor Manager

Prima di avviare EcoStruxure Augmented Operator Advisor Manager, verificare che

EcoStruxure Augmented Operator Advisor Runtime sia installato sul dispositivo runtime, che il firewall sia configurato e che il controllo porte sia stato completato correttamente

(vedere EcoStruxure Augmented Operator Advisor, Guida di riferimento rapido).

NOTA: Solo gli utenti con autorizzazioni di amministratore possono accedere al software EcoStruxure Augmented Operator Advisor Manager.

Per lanciare EcoStruxure Augmented Operator Advisor Manager:

16 EIO0000003610.08

Runtime

Passo

Azione

Aprire EcoStruxure Augmented Operator Advisor Runtime e fare clic su AOA Manager .

Risultato: EcoStruxure Augmented Operator Advisor Manager si apre nel browser Web predefinito.

NOTA:

• La licenza viene attivata all'avvio del software per la prima volta e viene visualizzato il numero di giorni rimasti della licenza se si utilizza la versione di prova.

• È necessario lasciare EcoStruxure Augmented Operator Advisor Runtime in esecuzione in background. Se EcoStruxure Augmented Operator Advisor Runtime non

è in esecuzione, non sarà possibile accedere a EcoStruxure Augmented Operator

Advisor Manager.

Accedere con nome utente e password predefiniti (admin/admin).

Augmented Operator Advisor Manager

Lingua

Password Password

3 Nella finestra visualizzata, immettere una nuova password amministratore e seguire le istruzioni.

NOTA:

• Registrare la password in un'ubicazione sicura e fornire una protezione appropriata.

• Per ripristinare una password dimenticata, è necessario rivolgersi al supporto tecnico.

Gestione utente

Panoramica

Esistono tre tipi di utenti di EcoStruxure Augmented Operator Advisor:

• Utenti di Builder

EIO0000003610.08

Runtime

• Amministratori Runtime/Manager

• Utenti operatori

Gli utenti di Builder sono coloro che hanno accesso a EcoStruxure Augmented Operator

Advisor Builder. Gli utenti senza credenziali possono registrarsi nella schermata di accesso di Builder.

Gli amministratori Runtime/Manager sono responsabili della configurazione di utenti e impostazioni di sicurezza per l'uso di EcoStruxure Augmented Operator Advisor Manager.

Agli amministratori Runtime/Manager devono avere autorizzazioni di amministratore

(massimo livello di sicurezza).

Gli utenti operatori sono coloro che utilizzeranno l'EcoStruxure Augmented Operator

Advisor App. In base alle proprie autorizzazioni utente (livello di sicurezza) hanno accesso a diversi oggetti nella app. Nel progetto di Builder, gli oggetti sono attribuiti con un valore numerico del livello di sicurezza. Gli utenti operatori con valore numerico del livello di sicurezza uguale o maggiore del livello di sicurezza degli oggetti possono visualizzare e interagire con l'oggetto. In caso contrario, l'oggetto è nascosto o non accessibile.

NOTA:

• EcoStruxure Augmented Operator Advisor Manager può gestire (creare / modificare / eliminare) solo gli utenti (Runtime e Operatore). Non è possibile creare utenti di Builder.

• Non è possibile eliminare il gruppo amministratore.

Creazione di gruppi

EcoStruxure Augmented Operator Advisor Manager sul dispositivo runtime consente di creare/modificare/eliminare i gruppi e configurarne le impostazioni di protezione.

Gli utenti operatore sono organizzati in gruppi. Un gruppo consente di:

• condividere l'attività fra operatori;

• definire un livello di sicurezza per fornire o limitare l'accesso a contenuto specifico nel progetto.

Ad esempio, un gruppo creato per utenti operatori che lavorano per una linea di produzione specifica. Ciò consente agli operatori di non essere disturbati dall'attività di un altro gruppo.

In EcoStruxure Augmented Operator Advisor App, gli utenti operatori nello stesso gruppo visualizzano le stesse informazioni e condividono la cronologia delle loro attività. Ogni utente operatore può visualizzare le ultime scene e procedure o quelle più utilizzate degli altri utenti che appartengono allo stesso gruppo.

Questa procedura spiega come creare gruppi in EcoStruxure Augmented Operator Advisor

Manager:

18 EIO0000003610.08

Passo

Azione

Fare clic sulla scheda UTENTI .

Runtime

Fare clic su Aggiungi gruppo per creare un nuovo gruppo di utenti.

Assegnare un nome al gruppo e immettere un livello di sicurezza.

Il livello di sicurezza è un numero compreso tra 0 e 65535. Ai numeri più alti corrispondono più autorizzazioni di sicurezza. Le autorizzazioni di amministratore corrispondono ad un livello di sicurezza massimo 65535. Tutti gli utenti in un gruppo hanno il livello di sicurezza del gruppo.

Fare clic su Convalida per confermare la creazione del gruppo.

EIO0000003610.08

Runtime

Creazione di utenti operatori

EcoStruxure Augmented Operator Advisor Manager nel dispositivo runtime consente di creare/modificare/eliminare utenti operatori.

Per accedere a un progetto in EcoStruxure Augmented Operator Advisor App, occorre prima creare un gruppo, quindi i relativi utenti operatori che vi appartengono.

Questa procedura spiega come creare utenti operatori in EcoStruxure Augmented Operator

Advisor Manager:

Passo

Azione

Fare clic sulla scheda UTENTI , quindi su Aggiungi utente per creare un nuovo utente.

Immettere nome utente e password.

Scegliere il gruppo a cui appartiene l'utente.

Fare clic su Convalida per confermare la creazione dell'utente.

NOTA: è possibile assegnare autorizzazioni di esperto a un utente selezionando la casella di controllo Modalità Esperto . L'utente Esperto può saltare passaggi in una procedura, mentre un utente non esperto deve seguire i passaggi nell'ordine corretto.

EIO0000003610.08

Modifica della password utente Runtime/Manager

Runtime

Fare clic sui dettagli dell'utente Runtime/Manager collegato disponibile nell'angolo superiore destro della pagina e selezionare il Profilo dal menu a discesa per cambiare la password.

Gestione note

Scheda Note

In questa scheda, è possibile vedere l'elenco di tutte le Note create dagli operatori nell'App.

Gli operatori possono creare le proprie Note nelle scene o scene secondarie quando eseguono l'App sul tablet. Le informazioni specificate dagli operatori nelle Note possono essere utili per apportare miglioramenti al progetto. La lista è limitata alle 1000 voci più recenti.

1 2 3 4 5 admin Augmented Operator Advisor Manager

UTENTI PROCEDURE NOTE

NOTE

A admin

Sostituzione filtro - Sostituzione filtro. Ultima sostituzione nel 2019 admin

Pressione bassa - Pressione bassa pneumatici anteriori admin

Problema1 - Il filtro non è stato installato correttamente alla sostituzione precedente

4 minuti fa

6 minuti fa un'ora fa

Pressione bassa

Pressione bassa pneumatici anteriori

Spiders.pdf

Ultimo utente che ha modificato

Modificato admin

10/05/2021, 15:50:39

Data eliminazione Mai

Progetto Excav1

Area AR1

Scena Ponte di Dev

EIO0000003610.08

Runtime

1. Elenco delle note in ordine cronologico. Le note nuove o modificate non ancora consultate vengono visualizzate in grassetto. Ciascuna voce dell'elenco contiene:

• Una casella di controllo;

• Il nome dell'utente che ha creato o modificato la nota;

• Il nome e la descrizione della nota;

• Il tempo trascorso dalla creazione o modifica della nota.

Fare clic su una voce dell'elenco per visualizzare i dettagli della nota e gli allegati a destra. La data e l'ora sono visualizzate nel fuso orario locale di EcoStruxure

Augmented Operator Advisor App.

2. Esportazione selezione. Le note contenenti allegati sono esportate senza gli allegati.

L'esportazione viene memorizzata in formato .csv, con la virgola come separatore.

3. Eliminare la selezione in modo permanente da EcoStruxure Augmented Operator

Advisor Manager.

Ricarica — sincronizzare l'elenco con EcoStruxure Augmented Operator Advisor

Runtime.

5. Indicatore verde/grigio — verde indica che la nota è disponibile in EcoStruxure

Augmented Operator Advisor App. Grigio indica che la nota è stata rimossa dall'App ed

è disponibile solo in EcoStruxure Augmented Operator Advisor Manager.

6. Visualizzato quando la nota contiene un allegato.

NOTA: L'aggiunta di allegati alle note è possibile da EcoStruxure Augmented

Operator Advisor Runtime V2.8. Se si utilizza una versione precedente, è possibile solo creare note senza allegati.

Gestione procedure

Scheda Procedure

In questa scheda, è possibile vedere un elenco di tutte le procedure seguite dagli operatori in EcoStruxure Augmented Operator Advisor App. È possibile vedere il nome del progetto, oltre a data e ora in cui sono state seguite le procedure, i singoli passi fatti e il nome dell'utente che ha seguito la procedura. La lista è limitata alle 1000 voci più recenti.

22 EIO0000003610.08

1 2 3 4

Augmented Operator Advisor Manager

UTENTI PROCEDURE

CRONOLOGIA

NOTE admin

Sostituzione (10/5/2021 15:12:20)

A admin Sostituzione (10/5/2021 15:54:12) 0 minuti un minuto fa

A admin Sostituzione (10/5/2021 15:53:52) 0 minuti 2 minuti fa

A admin Filtri (10/5/2021 15:53:13) 2 minuti 2 minuti fa

A admin Pneumatici (10/5/2021 15:50:49) 1 minuto 5 minuti fa

A admin

Data di inizio 10/05/2021, 15:08:41

Data di fine 10/05/2021, 15:12:20

Durata 4 minuti

A admin Sostituzione (10/5/2021 15:12:20) 4 minuti 43 minuti fa admin Sostituzione (10/5/2021 15:08:05) 0 minuti un'ora fa

A admin Pneumatici (10/5/2021 15:02:19) 2 minuti un'ora fa

INIZIO

10/05/2021

15:12:03 step1 admin

5 Ott, 2021 15:12 (43 minuti fa)

Progetto Excav 1

Area AR1

3 minuti, 22 secondi

Modalità esperto

Runtime

10/05/2021

15:12:20

FINE admin

1. Elenco delle procedure in ordine cronologico. Ciascuna voce dell'elenco contiene:

• Una casella di controllo;

• Il nome dell'utente che ha seguito la procedura,

• Il nome della procedura e la data e ora in cui è stata seguita,

• La durata della procedura,

• Il tempo trascorso da quando è stata seguita la procedura.

Fare clic su una voce dell'elenco per visualizzare i dettagli della procedura a destra. Se la procedura contiene un allegato, fare clic sull'allegato per visualizzarlo a schermo intero.

2. Esportazione selezione. L'esportazione viene memorizzata in formato .csv, con la virgola come separatore.

3. Eliminare la selezione in modo permanente da EcoStruxure Augmented Operator

Advisor Manager.

Ricarica — sincronizzare l'elenco con EcoStruxure Augmented Operator Advisor

Runtime.

EIO0000003610.08

Runtime

Utilizzo di Node-RED

Gestione di Node-RED

Introduzione

Node-RED è uno strumento open source di programmazione visuale che richiede poche o addirittura nessuna conoscenza di programmazione. Utilizza blocchi preprogrammabili riutilizzabili di codice denominati nodi. I nodi sono collegati tra loro per creare flussi di dati. È possibile collegare flussi Node-RED ai punti di interesse per visualizzare i valori del database SQL nelle applicazioni di realtà aumentata.

Se si deve utilizzare Node-RED, scaricarlo da nodered.org e installarlo sul dispositivo runtime.

EcoStruxure Augmented Operator Advisor Runtime è compatibile con Node.js 14.

x LTS, come raccomandato da Node-RED.

I nodi EcoStruxure Augmented Operator Advisor sono disponibili in Start > EcoStruxure

Augmented Operator Advisor > Cartella Nodi runtime

Configurazione e impostazione dell'autenticazione utente avvengono direttamente in Node-

RED. Per ulteriori informazioni, consultare la documentazione di Node-RED.

Impostazioni

Nella scheda Node-RED di EcoStruxure Augmented Operator Advisor Runtime, è possibile configurare il collegamento tra Node-RED e EcoStruxure Augmented Operator Advisor

Runtime.

24 EIO0000003610.08

Progetto

Documenti

Impostazioni

Runtime

Augmented Operator Advisor – Runtime Versione x.y

Porta Node-RED

Stato su porta 1880

Versione

Percorso

Avvio automatico

1880

C:\Users\user12345\AppData\Roa

Applica

Arrestato

0.20.1

Node-RED Avvio 7

1 Il numero di porta definito durante l'installazione di Node-RED sul dispositivo runtime.

2 Fare clic per applicare il numero di porta se è stato modificato.

3 Avviato / Arrestato . Mostra lo stato Node-RED (se Node-RED è in esecuzione o meno).

4 Mostra la versione di Node-RED in uso.

5 Fare clic sul pulsante Sfoglia e selezionare la cartella in cui si trova lo script di avvio utilizzato di Node-RED e convalidare, viene visualizzato il Percorso della cartella selezionata.

6 Selezionare, eventualmente, la casella di controllo Avvio automatico se si desidera avviare automaticamente Node-RED al successivo avvio di EcoStruxure Augmented

Operator Advisor Runtime (il campo Percorso deve essere specificato correttamente).

7 Avvia / Arresta . Fare clic per avviare o arrestare manualmente Node-RED (il campo

Percorso deve essere specificato correttamente).

Esempi per integrare i dati da un database MySQL in EcoStruxure Augmented Operator Advisor

Panoramica

È possibile integrare i dati di MySQL in EcoStruxure Augmented Operator Advisor. Di seguito vengono forniti due esempi della procedura.

EIO0000003610.08

Runtime

Esempio per principiante

L'esempio di seguito illustra l'integrazione di variabili SQL in EcoStruxure Augmented

Operator Advisor. Dopo aver richiamato SQL, il database MySQL torna a un array a due righe contenente un nome di variabile e il valore associato. Ogni nome di variabile proveniente dal database MySQL è associato a una variabile EcoStruxure Augmented

Operator Advisor.

Distribuzione del flusso di esempio per principiante in

Node-RED

Per distribuire questo flusso in Node-RED:

Primo, copiare il codice seguente.

[{"id":"90aecf00.2d5e3","type":"debug","z":"4a407662.78a494","name":"Optional help node for debugging the Augmented Operator result","active":true,"tosidebar":true,"console": false,"complete":"statusCode","x":830,"y":500,"wires":[]},

{"id":"56ad79c5.7a0d98","type":"Augmented-Operatorserver","z":"4a407662.78a494","arserverport":"8082","arservermethod":"PUT","arserverbufferinterval":"0","x":760,"y":460,"wires":

[["90aecf00.2d5e3"]]},{"id":"93b1903e.49d6d","type":"Augmented-

Operatorvariable","z":"4a407662.78a494","arservervarnamespace":"","arservervarname":"ARvar2","arserverdatatype":"String","arservervalueType":"msg","arservervalue":"payload","x":580,"y":420,"wires":

[["56ad79c5.7a0d98"]]},{"id":"f6f6007e.2ccff","type":"Augmented-

Operatorvariable","z":"4a407662.78a494","arservervarnamespace":"","arser-

26 EIO0000003610.08

Runtime vervarname":"ARvar1","arserverdatatype":"String","arservervalueType":"msg","arservervalue":"payload","x":580,"y":380,"wires":

[["56ad79c5.7a0d98"]]},{"id":"cc9333f9.

d89d8","type":"change","z":"4a407662.78a494","name":"","rules":

[{"t":"set","p":"payload","pt":"msg","to":"payload.

value","tot":"msg"},

{"t":"set","p":"topic","pt":"msg","to":"","tot":"str"}],"action":"","property":"","from":"","to":"","reg": false,"x":420,"y":360,"wires":[["93b1903e.49d6d"]]},

{"id":"3ffbe32c.1d252c","type":"function","z":"4a407662.78a494","name":"Error mgnt","func":"var msg1 = {};\nvar msg2 = {};\nif (msg.

status.text == \"connection refused\" || msg.status.text == \"Error

\" || msg.status.text == \"ETIMEDOUT\" || msg.status.text == \"not yet connected\" || msg.status.text == \"ER_ACCESS_DENIED_ERROR\")

{\n msg1.ar_datamodel_quality = \"bad\";\n msg1.ar_datamodel_

name = \"ARvar1\";\n msg1.ar_datamodel_value = \"\";\n msg1.

ar_datamodel_type = \"String\";\n

\"bad\";\n msg2.ar_datamodel_quality = msg2.ar_datamodel_name = \"ARvar2\";\n msg2.ar_

datamodel_value = \"\";\n return [msg1, msg2]; msg2.ar_datamodel_type = \"String\";\n

\n}","outputs":2,"noerr":0,"x":400,"y":460,"wires":

[["f6f6007e.2ccff"],["93b1903e.49d6d"]]},{"id":"5f0845cd.

f3e794","type":"change","z":"4a407662.78a494","name":"","rules":

[{"t":"set","p":"payload","pt":"msg","to":"payload.

value","tot":"msg"},

{"t":"set","p":"topic","pt":"msg","to":"","tot":"str"}],"action":"","property":"","from":"","to":"","reg": false,"x":420,"y":320,"wires":[["f6f6007e.2ccff"]]},

{"id":"1fd8516b.749863","type":"switch","z":"4a407662.78a494","name":"","property":"payload.name","propertyType":"msg","rules":

[{"t":"eq","v":"sqlVar1","vt":"str"},

{"t":"eq","v":"sqlVar2","vt":"str"}],"checkall":"false","outputs":2,"x":350,"y":280,"wires":[["5f0845cd.f3e794"],["cc9333f9.

d89d8"]]},{"id":"4b5f5f41.

bc5f9","type":"status","z":"4a407662.78a494","name":"","scope":

["5bc4cfc.4e291f"],"x":360,"y":440,"wires":[["3ffbe32c.1d252c"]]},

{"id":"f654da85.781e58","type":"split","z":"4a407662.78a494","name":"","splt":"","x":310,"y":240,"wires":[["1fd8516b.749863"]]},

{"id":"5bc4cfc.4e291f","type":"mysql","z":"4a407662.78a494","mydb":"f330429e.16cc","name":"Mysql localhost testdb","x":230,"y":200,"wires":[["f654da85.781e58"]]},

{"id":"1325a0b0.35b78f","type":"function","z":"4a407662.78a494","name":"SQL Select","func":"msg.topic=\"select name,value from testtable where name in ('sqlVar1', 'sqlVar2')\";\nreturn msg;","outputs":1,"noerr":0,"x":170,"y":160,"wires":

[["5bc4cfc.4e291f"]]},{"id":"b5677935.

c8f01","type":"inject","z":"4a407662.78a494","name":"every

EIO0000003610.08

Runtime

second","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"x":130,"y":120,"wires":

[["1325a0b0.35b78f"]]},

{"id":"f330429e.16cc","type":"MySQLdatabase","z":"","host":"127.0.0.1","port":"3306","db":"testdb","tz":""}]

In Node-RED, nell'angolo superiore destro dello schermo, fare clic sull'icona , quindi scegliere Importa > Appunti per incollare il codice.

Se si è copiato il codice di esempio da un file PDF, sarà necessario eliminare eventuali interruzioni di riga prima di procedere con il passaggio successivo.

Fare clic su Importa per creare il flusso.

Esempio intermedio

L'esempio di seguito illustra l'integrazione di variabili SQL in EcoStruxure Augmented

Operator Advisor. Questo esempio differisce da quello precedente perché consente l'integrazione di diverse variabili SQL senza aggiungere nuovi nodi.

Distribuzione del flusso di esempio intermedio in Node-

RED

Per distribuire questo flusso in Node-RED:

Primo, copiare il codice seguente.

[{"id":"82287384.fcd2e8","type":"subflow","name":"Write SQL variables to Augmented Operator","info":"","in":

[{"x":40,"y":80,"wires":[{"id":"860c4ff9.0252f"}]}],"out":

[{"x":460,"y":160,"wires":[{"id":"fc909389.37f018","port":0}]}]},

{"id":"860c4ff9.0252f","type":"function","z":"82287384.

28 EIO0000003610.08

Runtime fcd2e8","name":"Variable producing","func":"\nif (! msg.

SQLARassociationTable[msg.payload.name]){\n node.error(\"Error:

The variable SQL:'\" + msg.payload.name + \"' does not exists in

SQL to AR association table!\");\n} else{\n //Setup the msg specific entry ('ar_datamodel_name','ar_datamodel_type','ar_ datamodel_value') for AR variable producing:\n msg.ar_datamodel_

name = msg.SQLARassociationTable[msg.payload.name].name;\n msg.

ar_datamodel_type = msg.SQLARassociationTable[msg.payload.name].

type;\n msg.ar_datamodel_value = msg.payload.value;\n msg.

topic = msg.payload.name;\n return msg;\n}\nnode.error(\"Could not send the msg properly. Please check your flow!\");\nreturn msg;","outputs":1,"noerr":0,"x":170,"y":80,"wires":

[["b39542af.112ba8"]]},{"id":"b39542af.112ba8","type":"Augmented-

Operator-variable","z":"82287384.

fcd2e8","arservervarnamespace":"","arservervarname":"","arserverdatatype":"String","arservervalueType":"msg","arservervalue":"payload","x":230,"y":120,"wires":[["fc909389.37f018"]]},

{"id":"fc909389.37f018","type":"Augmented-Operatorserver","z":"82287384.

fcd2e8","arserverport":"8082","arservermethod":"PUT","arserverbufferinterval":"0","x":320,"y":160,"wires":[[]]},

{"id":"e94fdc14.677f9","type":"mysql","z":"ac2dce00.6e948","mydb":"2f8ee0b8.083b","name":"Mysql localhost testdb","x":350,"y":160,"wires":[["3cc7c810.d30728"]]},

{"id":"dd8448f7.41a148","type":"inject","z":"ac2dce00.6e948","name":"every minute","topic":"select name,value from testtable where name in ('sqlVar1',

'sqlVar2')","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"x":290,"y":120,"wires":[["e94fdc14.677f9"]]},

{"id":"537d55bf.43727c","type":"debug","z":"ac2dce00.6e948","name":"Optional help node for debugging the Augmented Operator result","active": true,"console":"false","complete":"statusCode","x":590,"y":320,"wires":[]},{"id":"3cc7c810.

d30728","type":"split","z":"ac2dce00.6e948","name":"Split each rows returned into multiple msg","splt":"","x":440,"y":200,"wires":

[["ce0e683e.de3758"]]},{"id":"ce0e683e.

de3758","type":"function","z":"ac2dce00.6e948","name":"EDIT HERE your SQL/AR variables association table","func":"//Set of Augmented

Operator Advisor types:\n//========================Do not change

Begin.========================\nconst AR_TYPES= {\n\"String\":

\"String\",\n\"WString\":\"WString\",\n\"Boolean\":\"Boolean\",\n

\"Int8\" :\"Int8\",\n\"Int16\" :\"Int16\",\n\"Int32\" :\"Int32\",\n

\"UInt8\" :\"UInt8\",\n\"UInt16\" :\"UInt16\",\n\"UInt32\" :

\"UInt32\",\n\"Float\" :\"Float\",\n\"Double\" :\"Double\",\n

\"SByte\" :\"SByte\",\n\"Byte\" :\"Byte\",\n\"Time\" :\"Time\",\n

\"Date\" :\"Date\",\n\"DateTime\":\"DateTime\",\n\"TimeOfDay\":

\"TimeOfDay\"\n};\n//========================Do not change End.

EIO0000003610.08

Runtime

========================\n\n/*Association table that associates SQL variables with AR ones:\nOne entry per variables. Each entry must follow this model:\n\"SQL_variable_name\": {\n name:\"AR_variable_ name\",\n type: AR_TYPES[\"<types>\"] // <= choose <types> under AR_TYPES\n \n },\n \ni.e: The folowing association table contains two entry:\nIn this exemple:\n-Entry 1: The SQL variable

\"sqlVar1\" is associated to an AR variable \"ARvar1\" of type

\"String\"\n-Entry 2: The SQL variable \"sqlVar2\" is associated to an AR variable \"ARvar2\" of type \"Int32\"\n*/\nmsg.

SQLARassociationTable = {\n //----------Entry 1 begin----------\n

\"sqlVar1\": {\n name:\"ARvar1\",\n type: AR_TYPES[\"String\"]\n },

\n //----------Entry 1 end----------\n //----------Entry 2 begin----------\n \"sqlVar2\": {\n name:\"ARvar2\",\n type: AR_

TYPES[\"Int32\"]\n }\n //----------Entry 2 end----------\n};\n\n

\n//========================Do not change from here=============================\nreturn msg;","outputs":1,"noerr":0,"x":500,"y":240,"wires":[["4837af90.

ab286"]]},

{"id":"5d8695ae.320bdc","type":"comment","z":"ac2dce00.6e948","name":"Write SQL variables to Augmented

Operator","info":"","x":490,"y":80,"wires":[]},{"id":"78478719.

cb0c78","type":"status","z":"ac2dce00.6e948","name":"","scope":

["e94fdc14.677f9"],"x":120,"y":160,"wires":[["576d2b7b.725b64"]]},

{"id":"576d2b7b.725b64","type":"function","z":"ac2dce00.6e948","name":"Error mgnt","func":"if (msg.status.text == \"connection refused\" || msg.status.text == \"Error\" || msg.status.text ==

\"ETIMEDOUT\" || msg.status.text == \"not yet connected\" || msg.

status.text == \"ER_ACCESS_DENIED_ERROR\"){\n msg.payload = [{name:

\"sqlVar1\",value:\"\"},{name:\"sqlVar2\",value:\"\"}];\n msg.ar_

datamodel_quality = \"bad\";\n return msg; \n}

\n","outputs":1,"noerr":0,"x":150,"y":200,"wires":[["3cc7c810.

d30728"]]},{"id":"4837af90.ab286","type":"subflow:82287384.

fcd2e8","z":"ac2dce00.6e948","x":490,"y":280,"wires":

[["537d55bf.43727c"]]},

{"id":"2f8ee0b8.083b","type":"MySQLdatabase","z":"","host":"127.0.0.1","port":"3306","db":"testdb","tz":""}]

In Node-RED, nell'angolo superiore destro dello schermo, fare clic sull'icona , quindi scegliere Importa > Appunti per incollare il codice.

Se si è copiato il codice di esempio da un file PDF, sarà necessario eliminare eventuali interruzioni di riga prima di procedere con il passaggio successivo.

Fare clic su Importa per creare il flusso.

30 EIO0000003610.08

Esempio di scrittura dei dati da EcoStruxure

Augmented Operator Advisor in un database

MySQL

Runtime

Panoramica

I dati, rappresentati come variabili, possono essere recuperati da EcoStruxure Augmented

Operator Advisor per aggiornare righe specifiche in una tabella specifica in un database

MySQL.

Esempio da EcoStruxure Augmented Operator Advisor a

MySQL

Distribuzione del flusso da EcoStruxure Augmented

Operator Advisor a MySQL in Node-RED

Per distribuire questo flusso in Node-RED:

Primo, copiare il codice seguente.

[{"id":"a0324778.c46a68","type":"subflow","name":"Read Augmented

Operator variables","info":"","in":[{"x":60,"y":40,"wires":

[{"id":"f4336d.17329c9"}]}],"out":[{"x":380,"y":40,"wires":

[{"id":"f4336d.17329c9","port":0}]}]},

{"id":"f4336d.17329c9","type":"Augmented-Operatorserver","z":"a0324778.

EIO0000003610.08

Runtime

c46a68","arserverport":"8082","arservermethod":"GET","arserverbufferinterval":"0","x":220,"y":40,"wires":[[]]},

{"id":"86b03067.4a069","type":"mysql","z":"b2a4893f.279948","mydb":"4245994d.cf0238","name":"Mysql localhost testdb","x":570,"y":620,"wires":[["8ae7a977.6d8148"]]},

{"id":"2c5bfb31.025954","type":"inject","z":"b2a4893f.279948","name":"every minute","topic":"","payload":"ARvar1,

ARvar2","payloadType":"str","repeat":"","crontab":"","once": false,"x":230,"y":460,"wires":[["27f48cc7.5d36b4"]]},

{"id":"fb4ea7ae.03f268","type":"function","z":"b2a4893f.279948","name":"EDIT HERE your AR/SQL variables association table","func":"/

*Association table that associates SQL variables with AR ones:\nOne entry per variables. Each entry must follow this model:\n\"AR_ variable_name\": {\n name:\"SQL_variable_name\"\n },\n

\ni.e: The folowing association table contains two entry:\nIn this exemple:\n-Entry 1: The AR variable \"ARvar1\" is associated to an

SQL variable \"sqlVar1\"\n-Entry 2: The AR variable \"ARvar2\" is associated to an SQL variable \"sqlVar2\"\n*/\ nARSQLassociationTable = {\n begin----------\n

//----------Entry 1

\"ARvar1\": {\n name:\"sqlVar1\",\n

\n }, \n //----------Entry 1 end----------\n

//----------Entry 2 begin----------\n \"ARvar2\": {\n name:\"sqlVar2\",\n }\n //----------Entry 2 end----------\n};

\n\nmsg.topic = \"UPDATE testtable SET value = '<VALUE>' WHERE name

= '<NAME>';\".replace(\"<VALUE>\",msg.payload.value).replace

(\"<NAME>\", ARSQLassociationTable[msg.parts.key].name);

\n//========================Do not change from here=============================\nreturn msg;","outputs":1,"noerr":0,"x":440,"y":580,"wires":

[["86b03067.4a069"]]},

{"id":"8ae7a977.6d8148","type":"debug","z":"b2a4893f.279948","name":"Optional help node for debug the MySQL server result","active":true,"console":"false","complete":"payload.

message","x":720,"y":660,"wires":[]},

{"id":"e46fd4ee.2f7318","type":"split","z":"b2a4893f.279948","name":"","splt":"","x":530,"y":540,"wires":[["fb4ea7ae.03f268"]]},

{"id":"b5bb57a3.

d9eb38","type":"json","z":"b2a4893f.279948","name":"","x":410,"y":540,"wires":[["e46fd4ee.2f7318"]]},

{"id":"27f48cc7.5d36b4","type":"subflow:a0324778.

c46a68","z":"b2a4893f.279948","name":"","x":390,"y":500,"wires":

[["b5bb57a3.d9eb38"]]},

{"id":"704bcb69.9c7f24","type":"comment","z":"b2a4893f.279948","name":"Write Augmented Operator variables to

SQL","info":"","x":450,"y":420,"wires":[]},{"id":"4245994d.

cf0238","type":"MySQLdatabase","z":"","host":"127.0.0.1","port":"3306","db":"testdb","tz":""}]

32 EIO0000003610.08