Personalizzare la modalità di visualizzazione dei dati dai server OPC UA da parte della soluzione di fabbrica connessaCustomize how the connected factory solution displays data from your OPC UA servers

La soluzione di fabbrica connessa aggrega e visualizza dati dai server OPC UA connessi alla soluzione.The connected factory solution aggregates and displays data from the OPC UA servers connected to the solution. È possibile individuare e inviare comandi ai server OPC UA nella soluzione.You can browse and send commands to the OPC UA servers in your solution. Per altre informazioni su OPC UA, vedere le domande frequenti sulla soluzione di connected factory.For more information about OPC UA, see the Connected factory FAQ.

Gli esempi di dati aggregati nella soluzione includono i valori OEE (Overall Equipment Efficiency) e gli indicatori KPI visualizzabili nel dashboard a livello di fabbrica, linea e stazione.Examples of aggregated data in the solution include the Overall Equipment Efficiency (OEE) and Key Performance Indicators (KPIs) that you can view in the dashboard at the factory, line, and station levels. Lo screenshot seguente mostra i valori OEE e gli indicatori KPI per la stazione Assemblaggio nella Linea di produzione 1 di uno stabilimento a Monaco:The following screenshot shows the OEE and KPI values for the Assembly station, on Production line 1, in the Munich factory:

Esempio di valori OEE e indicatori KPI nella soluzione

Questa soluzione consente di visualizzare informazioni dettagliate su dati specifici dai server OPC UA, chiamati stazioni.The solution enables you to view detailed information from specific data items from the OPC UA servers, called stations. La schermata seguente mostra i tracciati del numero di articoli prodotti da una stazione specifica:The following screenshot shows plots of the number of manufactured items from a specific station:

Tracciati del numero di articoli prodotti

Facendo clic su uno dei grafici è possibile esplorare ulteriormente i dati tramite Time Series Insights (TSI):If you click one of the graphs, you can explore the data further using Time Series Insights (TSI):

Esplorare i dati con Time Series Insights

L'articolo illustra:This article describes:

  • Come i dati vengono resi disponibili per le diverse visualizzazioni nella soluzione.How the data is made available to the various views in the solution.
  • Come è possibile personalizzare il modo in cui la soluzione visualizza i dati.How you can customize the way the solution displays the data.

Origini datiData sources

La soluzione di fabbrica connessa visualizza dati dai server OPC UA connessi alla soluzione.The connected factory solution displays data from the OPC UA servers connected to the solution. L'installazione predefinita include diversi server OPC UA che eseguono una simulazione di fabbrica.The default installation includes several OPC UA servers running a factory simulation. È possibile aggiungere i propri server OPC UA che si connettono tramite un gateway alla soluzione.You can add your own OPC UA servers that connect through a gateway to your solution.

È possibile anche esplorare gli elementi dei dati che un server OPC UA connesso può inviare alla soluzione nel dashboard:You can browse the data items that a connected OPC UA server can send to your solution in the dashboard:

  1. Passare alla vista Selezionare un server OPC UA:Navigate to the Select an OPC UA server view:

    Passare alla vista Selezionare un server OPC UA

  2. Selezionare un server e fare clic su Connetti.Select a server and click Connect. Fare clic su Procedi quando viene visualizzato l'avviso di sicurezza.Click Proceed when the security warning appears.

    Nota

    L'avviso viene visualizzato una sola volta per ciascun server e stabilisce una relazione di trust tra quest'ultimo e il dashboard della soluzione.This warning only appears once for each server and establishes a trust relationship between the solution dashboard and the server.

  3. È ora possibile esplorare gli elementi dei dati che il server può inviare alla soluzione.You can now browse the data items that the server can send to the solution. Gli elementi che vengono inviati alla soluzione hanno un segno di spunta verde:Items that are being sent to the solution have a green check mark:

    Elementi pubblicati

  4. Se si è un amministratore nella soluzione, è possibile scegliere di pubblicare un elemento di dati per renderlo disponibile nella soluzione di fabbrica connessa.If you are an Administrator in the solution, you can choose to publish a data item to make it available in the connected factory solution. L'amministratore può anche modificare il valore degli elementi di dati e chiamare i metodi nel server OPC UA.As an Administrator, you can also change the value of data items and call methods in the OPC UA server.

Eseguire il mapping di datiMap the data

La soluzione di fabbrica connessa mappa e aggrega gli elementi di dati pubblicati dal server OPC UA alle varie viste nella soluzione.The connected factory solution maps and aggregates the published data items from the OPC UA server to the various views in the solution. La soluzione di fabbrica connessa viene distribuita nell'account Azure dell'utente quando ne viene effettuato il provisioning.The connected factory solution deploys to your Azure account when you provision the solution. Le informazioni di mapping sono contenute in un file JSON nella soluzione di fabbrica connessa Visual Studio.A JSON file in the Visual Studio connected factory solution stores this mapping information. È possibile visualizzare e modificare questo file di configurazione JSON nella soluzione di fabbrica connessa Visual Studi.You can view and modify this JSON configuration file in the connected factory Visual Studio solution. È possibile ridistribuire la soluzione dopo aver apportato una modifica.You can redeploy the solution after you make a change.

È possibile usare il file di configurazione per:You can use the configuration file to:

  • Modificare le stazioni, le linee di produzione e gli stabilimenti simulati esistenti.Edit the existing simulated factories, production lines, and stations.
  • Eseguire il mapping di dati dai server OPC UA effettivi che si connettono alla soluzione.Map data from real OPC UA servers that you connect to the solution.

Per clonare una copia della soluzione di fabbrica connessa Visual Studio, usare il comando git seguente:To clone a copy of the connected factory Visual Studio solution, use the following git command:

git clone https://github.com/Azure/azure-iot-connected-factory.git

Il file ContosoTopologyDescription.json definisce il mapping dagli elementi di dati del server OPC UA alle visualizzazioni nel dashboard della soluzione di fabbrica connessa.The file ContosoTopologyDescription.json defines the mapping from the OPC UA server data items to the views in the connected factory solution dashboard. Il file di configurazione si trova nella cartella Contoso\Topology all'interno del progetto WebApp soluzione Visual Studio.You can find this configuration file in the Contoso\Topology folder in the WebApp project in the Visual Studio solution.

Il contenuto del file JSON è organizzato come una gerarchia di nodi di stabilimento, linea di produzione e stazione,The content of the JSON file is organized as a hierarchy of factory, production line, and station nodes. la quale definisce la gerarchia di navigazione nel dashboard di fabbrica connessa.This hierarchy defines the navigation hierarchy in the connected factory dashboard. I valori in ogni nodo della gerarchia determinano le informazioni visualizzate nel dashboard.Values at each node of the hierarchy determine the information displayed in the dashboard. Ad esempio, il file JSON contiene i valori seguenti per lo stabilimento di Monaco:For example, the JSON file contains the following values for the Munich factory:

"Guid": "73B534AE-7C7E-4877-B826-F1C0EA339F65",
"Name": "Munich",
"Description": "Braking system",
"Location": {
    "City": "Munich",
    "Country": "Germany",
    "Latitude": 48.13641,
    "Longitude": 11.57754
},
"Image": "munich.jpg"

Nome, descrizione e posizione vengono visualizzati nel dashboard:The name, description, and location appear on this view in the dashboard:

Dati di Monaco nel dashboard

Ogni stabilimento, linea di produzione e stazione ha una proprietà immagine.Each factory, production line, and station have an image property. Questi file JPEG si trovano nella cartella Content\img all'interno del progetto WebAppYou can find these JPEG files in the Content\img folder in the WebApp project. e vengono visualizzati nel dashboard fabbrica connessa.These image files display in the connected factory dashboard.

Ogni stazione include diverse proprietà dettagliate che definiscono il mapping dagli elementi di dati OPC UA.Each station includes several detailed properties that define the mapping from the OPC UA data items. Queste proprietà sono descritte nelle sezioni seguenti:These properties are described in the following sections:

OpcUriOpcUri

Il valore OpcUri è l'URI dell'applicazione OPC UA che identifica in modo univoco il server OPC UA.The OpcUri value is the OPC UA Application URI that uniquely identifies the OPC UA server. Ad esempio, il valore OpcUri per la stazione di assemblaggio nella linea di produzione 1 a Monaco ha l'aspetto seguente: urn:scada2194:ua:munich:productionline0:assemblystation.For example, the OpcUri value for the assembly station on production line 1 in Munich looks like the following: urn:scada2194:ua:munich:productionline0:assemblystation.

È possibile visualizzare gli URI dei server OPC UA connessi nel dashboard della soluzione:You can view the URIs of the connected OPC UA servers in the solution dashboard:

Visualizzare gli URI dei server OPC UA

SimulazioneSimulation

Le informazioni contenute nel nodo Simulazione si riferiscono in modo specifico alla simulazione OPC UA eseguita nei server OPC UA di cui è stato eseguito il provisioning per impostazione predefinita.The information in the Simulation node is specific to the OPC UA simulation that runs in the OPC UA servers that are provisioned by default. Non vengono usate per un server OPC UA reale.It is not used for a real OPC UA server.

Kpi1 e Kpi2Kpi1 and Kpi2

Questi nodi descrivono il contributo dei dati dalla stazione ai due indicatori KPI nel dashboard.These nodes describe how data from the station contributes to the two KPI values in the dashboard. In una distribuzione predefinita, questi indicatori KPI rappresentano unità all'ora e kWh all'ora.In a default deployment, these KPI values are units per hour and kWh per hour. La soluzione calcola i valori degli indicatori KPI a livello di stazione e li aggrega ai livelli di linea di produzione e di stabilimento.The solution calculates KPI vales at the level of a station and aggregates them at the production line and factory levels.

Ogni indicatore KPI ha un valore minimo, un valore massimo e un valore di destinazioneEach KPI has a minimum, maximum, and target value. e può anche definire azioni di avviso che devono essere eseguite dalla soluzione di fabbrica connessa.Each KPI value can also define alert actions for the connected factory solution to perform. Il frammento di codice seguente mostra le definizioni degli indicatori KPI per la stazione di assemblaggio nella linea di produzione 1 a Monaco:The following snippet shows the KPI definitions for the assembly station on production line 1 in Munich:

"Kpi1": {
  "Minimum": 150,
  "Target": 300,
  "Maximum": 600
},
"Kpi2": {
  "Minimum": 50,
  "Target": 100,
  "Maximum": 200,
  "MinimumAlertActions": [
    {
      "Type": "None"
    }
  ]
}

Lo screenshot seguente mostra i dati KPI nel dashboard.The following screenshot shows the KPI data in the dashboard.

Informazioni relative ai KPI nel dashboard

OpcNodesOpcNodes

I nodi OpcNodes identificano gli elementi dei dati pubblicati dal server OPC UA e ne specificano le modalità di elaborazione.The OpcNodes nodes identify the published data items from the OPC UA server and specify how to process that data.

Il valore NodeId identifica il NodeID OPC UA specifico dal server OPC UA.The NodeId value identifies the specific OPC UA NodeID from the OPC UA server. Il primo nodo nella stazione di assemblaggio per la linea di produzione 1 a Monaco ha un valore ns=2;i=385.The first node in the assembly station for production line 1 in Munich has a value ns=2;i=385. Il valore NodeId specifica l'elemento dati da leggere dal server OPC UA, mentre il valore SymbolicName fornisce un nome descrittivo da usare nel dashboard per tali dati.A NodeId value specifies the data item to read from the OPC UA server, and the SymbolicName provides a user-friendly name to use in the dashboard for that data.

Altri valori associati a ogni nodo sono riepilogati nella tabella riportata di seguito:Other values associated with each node are summarized in the following table:

ValoreValue DescrizioneDescription
PertinenzaRelevance Gli indicatori KPI e i valori OEE cui contribuiscono questi dati.The KPI and OEE values this data contributes to.
OpCodeOpCode Il modo in cui i dati vengono aggregati.How the data is aggregated.
UnitàUnits Le unità da usare nel dashboard.The units to use in the dashboard.
VisibleVisible Indica se il valore viene visualizzato nel dashboard.Whether to display this value in the dashboard. Alcuni valori vengono usati nei calcoli, ma non visualizzati.Some values are used in calculations but not displayed.
MassimaMaximum Il valore massimo che attiva un avviso nel dashboard.The maximum value that triggers an alert in the dashboard.
MaximumAlertActionsMaximumAlertActions Azione da intraprendere in risposta a un avviso.An action to take in response to an alert. Ad esempio, l'invio di un comando a una stazione.For example, send a command to a station.
ConstValueConstValue Un valore costante usato in un calcolo.A constant value used in a calculation.

Distribuire le modificheDeploy the changes

Dopo avere apportato modifiche al file ContosoTopologyDescription.json, è necessario ridistribuire la soluzione di fabbrica connessa nel proprio account Azure.When you have finished making changes to the ContosoTopologyDescription.json file, you must redeploy the connected factory solution to your Azure account.

Il repository azure-iot-connected-factory include uno script PowerShell build.ps1 che è possibile usare per ricompilare e distribuire la soluzione.The azure-iot-connected-factory repository includes a build.ps1 PowerShell script you can use to rebuild and deploy the solution.

Passaggi successiviNext Steps

Altre informazioni sulla soluzione preconfigurata di fabbrica connessa sono disponibili nei seguenti articoli:Learn more about the connected factory preconfigured solution by reading the following articles: