Software API SARTORIUS Sim

Specifiche

• Nome prodotto: Guida SimApi
• Data di rilascio: 5 settembre 2024
• Scopo: fornire dati ai prodotti Umetrics Suite

Istruzioni per l'uso del prodotto

Introduzione a SimApis

• Le SimApi vengono utilizzate per recuperare dati per la creazione di progetti e la costruzione di modelli nei prodotti Umetrics Suite.

Ottenere SimApis

• Per ottenere SimApis, fare riferimento alla documentazione ufficiale o contattare l'assistenza clienti per ricevere assistenza.

Caratteristiche SimApi

• SimApis fornisce dati in tempo reale per il monitoraggio, il controllo e la creazione di modelli in SIMCA e SIMCA-online.

Solo utilizzo dati corrente

• Per ottenere prestazioni ottimali, si consiglia di utilizzare solo dati correnti ed evitare dati storici.

Preparazione per l'installazione di SimApi

• Prima dell'installazione, assicurarsi che il sistema soddisfi i requisiti minimi specificati nel manuale dell'utente.

Installazione di una SimApi

• Seguire le istruzioni dettagliate fornite nel manuale utente per installare SimApi sul sistema.

Impostazione di SimApi per SIMCA

• Configurare le impostazioni SimApi in SIMCA secondo le linee guida fornite.

Impostazione di SimApi per SIMCA-online

• Impostare SimApi per operazioni di recupero e scrittura dei dati in tempo reale in SIMCA-online.

Test e risoluzione dei problemi

• Dopo l'installazione, esegui dei test per assicurarti che funzioni correttamente. In caso di problemi, fai riferimento alla sezione relativa alla risoluzione dei problemi nella guida utente.

Test da SIMCA-online

• Testare l'integrazione SimApi da SIMCA-online per verificare il recupero dei dati.

Risoluzione dei problemi con il registro Files

• Utilizzare il registro SimApi file per identificare e risolvere eventuali problemi di installazione e funzionamento.

Configurazione dell'account di servizio

• Assicurare la corretta configurazione dell'account del servizio SIMCA-online per un funzionamento senza interruzioni.

Dettagli tecnici

• Per informazioni tecniche approfondite su SimApis, fare riferimento alla sezione 7 del manuale utente.

Introduzione a SimApis

• Una SimApi è un'interfaccia software tra il software Umetrics® Suite e una fonte dati. Lo scopo principale di una SimApi è fornire dati a SIMCA®-online o SIMCA®.
• Sartorius Stedim Data Analytics AB sviluppa SimApis per numerose fonti di dati diverse, come gli storici dei processi e i database di uso generale.
• Questo documento mostra cos'è una SimApi e come viene utilizzata nei prodotti Umetrics Suite. Imparerai come pianificare e installare una SimApi, come risolvere i problemi e come testare la tua installazione. Il capitolo finale contiene dettagli tecnici di SimApis rivolti agli sviluppatori.

Scopo di SimApi: fornire dati ai prodotti Umetrics Suite

• Lo scopo principale di una SimApi è fornire dati a SIMCA-online o SIMCA da una fonte dati. La fonte dati non fa parte di SIMCA-online ma può essere uno storico dei processi o un altro sistema che conserva e gestisce i dati.
• Una SimApi espone una gerarchia di nodi, corrispondenti alle cartelle in un file sistema. Ogni nodo può contenere altri nodi, oppure tags. UN tag corrisponde a una variabile. Per questi tags, i dati possono essere ottenuti. L'immagine mostra un tag, Temp, selezionato nel nodo
• BakersYeastControlGood in una fonte dati in SIMCA-online. Mostra anche gli ultimi valori presi dalla fonte dati.

Utilizzo di SimApi nella suite Umetrics

• Il software desktop SIMCA può utilizzare una SimApi per recuperare dati per la creazione di progetti e la costruzione di modelli, come illustrato nell'immagine seguente.
• SIMCA-online utilizza SimApis per ottenere dati in tempo reale per il monitoraggio e il controllo, nonché per riscrivere i dati sulla fonte dati. L'immagine seguente mostra dove si trova SimApi in un sistema costituito da una fonte dati, un server SIMCA-online e client.

SimApis comunemente usati

• Le SimApi più utilizzate sono:
• PI AF SimApi per la connessione ai sistemi PI di Aveva (in precedenza OSIsoft).
• L'OPC UA SimApi
• ODBC SimApi – per l'accesso generale a database come SQL Server o Oracle
• Tutte le SimApi disponibili sono elencate insieme alle loro caratteristiche nel paragrafo 3.

DBMaker SimApi per i dati di simulazione

• DBMaker è un'applicazione fornita con l'installazione del server SIMCA-online. Simula una fonte dati, come uno storico dei processi, utilizzando una tabella dati precaricata in cui le osservazioni vengono fornite una alla volta a SIMCA-online tramite DBMaker SimApi.
• DBMaker è utilizzato solo per scopi dimostrativi e non può essere utilizzato in produzione con dati live da una fonte dati. Consulta la guida integrata per saperne di più su DBMaker.

Documentazione aggiuntiva

• Il presente documento fa parte di una serie di documenti correlati, ciascuno con un focus e un pubblico di riferimento diversi:

Fonte	Che cosa	Dove
SIMCA-online web pagina	Informazioni introduttive e download	sartorius.com/umetrics-simca- in linea

SIMCA-online Leggimi e installazione.pdf	Installazione e come iniziare con SIMCA - dati demo online	Nello zip di installazione file
Guida all'implementazione SIMCA-online	Descrive le funzionalità di SIMCA-online, le mette in relazione con altri software Umetrics Suite, descrive i requisiti e le best practice per un'implementazione di successo e fornisce istruzioni di installazione dettagliate.	sartorius.com/umetrics-simca- in linea
Guida SimApi	Preparazione ed esecuzione delle installazioni SimApi, inclusa la risoluzione dei problemi. Contiene anche dettagli tecnici su SimApis per sviluppatori.	sartorius.com/umetrics-simapi
Guide per l'utente di SimApi	Documentazione per ogni SimApi pubblicata con funzionalità, istruzioni di installazione e specifiche di configurazione.	sartorius.com/umetrics-simapi
Guida tecnica SIMCA-online	Riferimenti tecnici per la pianificazione dell'installazione del server SIMCA-online, la risoluzione dei problemi e una spiegazione dettagliata del funzionamento di SIMCA-online.	sartorius.com/umetrics-simca-in linea
Aiuto online SIMCA	Web-assistenza su come utilizzare SIMCA-online e sul funzionamento di SIMCA-online.	Nel software stesso e su sartorius.com/umetrics-simca
SIMCA-online Web Guida all'installazione del client	Descrive l'installazione del SIMCA-online Web Cliente.	sartorius.com/umetrics-simca-in linea
Base di conoscenza Umetrics	Database consultabile con articoli su ciascuna versione software rilasciata, articoli tecnici e problemi noti nei prodotti Umetrics Suite.	sartorius.com/umetrics-kb
Guida utente/aiuto SIMCA	Come utilizzare SIMCA desktop per creare progetti e modellare dati.	In SIMCA e su sartorius.com/umetrics-simca
Supporto web pagina	Come ottenere supporto tecnico.	sartorius.com/umetrics-support

Supporto tecnico

• Il team di supporto online Sartorius risponde alle domande tecniche su SimApis e può anche inoltrare le richieste di miglioramento di SimApis alle persone appropriate. Scopri di più su sartorius.com/umetrics-support.

Ottenere SimApis

• Forniamo la documentazione per le SimApi disponibili e i link ai programmi di installazione su sartorius.com/umetrics-simapi.
• Ogni SimApi è documentata nella sua Guida per l'utente.
• La Guida SimApi che stai leggendo ora integra tali informazioni con informazioni complementari su SimApi per quanto riguarda la pianificazione, l'installazione e la risoluzione dei problemi di SimApi.

Caratteristiche SimApi

• Non tutte le fonti di dati sono uguali. Una SimApi non deve implementare tutte le funzioni nella specifica. Per queste ragioni, diverse SimApi offrono funzionalità diverse. La seguente matrice elenca le SimApi disponibili e le loro funzionalità.
• Le funzionalità sono spiegate di seguito. Nota che la tabella ha colonne separate per mostrare quali funzionalità sono disponibili rispettivamente in SIMCA-online e SIMCA.

Caratteristica	Scopo	Utilizzo SIMCA-online	Utilizzo SIMCA
Dati attuali	Leggere una singola osservazione con il valore più recente dalla fonte dati.	Esecuzione normale in tempo reale	–
Dati storici	Leggi più osservazioni contemporaneamente con dati storici provenienti dalla fonte dati.	Recuperare e prevedere i dati passati, creare progetti utilizzando File > Nuovo	Procedura guidata di importazione del database per importare i dati di processo per la creazione del modello.
Dati discreti	Leggere i dati di laboratorio/IPC dalla fonte dati. Molte osservazioni per batch.	Per progetti batch con fasi o condizioni batch configurate per il recupero di dati discreti.	–
Dati batch	Leggere le condizioni del lotto e gli attributi di qualità finale (o	Condizioni batch o centratura locale.	Procedura guidata di importazione del database per leggere le condizioni batch per

Caratteristica	Scopo	Utilizzo SIMCA-online	Utilizzo SIMCA
	altri dati di tipo MES). Un'osservazione per lotto.		creazione di modelli a livello di batch.
Nodo batch	Specificare l'ora di inizio e l'ora di fine (vuota per un batch attivo) per un batch specifico. Enumera tutti i lotti esistenti in un intervallo di tempo.	Necessario per l'esecuzione di configurazioni batch.	Procedura guidata di importazione del database per selezionare i batch da importare.
Riscrivi – dati continui	Riscrivere i dati continui, come le previsioni, nella fonte dati.	Riscrivi i dati dal livello di evoluzione del batch, per Control Advisor o per configurazioni continue	–
Riscrivi – discreto	Riscrivere i dati discreti, come le previsioni, nella fonte dati.	Riscrivi per le configurazioni batch a livello di evoluzione batch per le fasi configurate per il recupero di dati discreti	–
Riscrivi – dati batch	Riscrivere i dati a livello di batch, come previsioni o attributi di qualità finale, nella fonte dati.	Riscrivi per la configurazione batch a livello batch	–
Gerarchia dei nodi	SimApi supporta una gerarchia di nodi, in modo simile a un file sistema. Ogni nodo può contenere tags e altri nodi. La gerarchia rende più facile gestire un gran numero di nodi e tags.	Supportato in tutti i luoghi dove tags vengono utilizzati.
Vettore tag espansione	Una matrice tag memorizza più valori. SimApi espande l'array tag a molti individui tags, uno per ogni elemento dell'array.	Supportato dove tags vengono utilizzati per dati continui. Ogni espanso tag deve essere mappato su una variabile nel progetto SIMCA.
Molteplici fonti di dati	SimApi può connettersi a più di una singola fonte di dati o supportare più istanze di se stessa con impostazioni e registri individuali fileper ogni istanza.	Connettersi a diverse fonti di dati dello stesso tipo.	–
Resilienza della connessione	Se SimApi si disconnette dalla fonte dati, tenterà di ristabilire la connessione automaticamente.	Non è necessario riavviare SimApi per ristabilire le connessioni alla fonte dati.	–
Sviluppato internamente	SimApi è sviluppato, fornito e supportato da

Non è consigliabile avere solo dati correnti, senza dati storici

• Alcune SimApi, in particolare OPC DA, supportano solo la lettura dei dati correnti e non di quelli storici.
• Una SimApi che supporta solo dati correnti non può essere utilizzata in SIMCA desktop, perché non sarà in grado di leggere i dati storici su cui costruire i modelli.
• Per SIMCA-online, consigliamo vivamente una fonte dati e SimApi che forniscano non solo dati correnti per l'esecuzione in tempo reale, ma anche dati storici per poter prevedere e recuperare i dati passati. SIMCA-online passa automaticamente tra dati in tempo reale e dati storici in base alle necessità e questa opzione non può essere disattivata.
• Una fonte dati che fornisce solo dati correnti, ma non dati storici, può funzionare per progetti continui in SIMCA-online, ma per progetti batch sono richiesti dati storici.

Preparazione per l'installazione di SimApi

• Questa sezione descrive informazioni importanti per un'installazione corretta di una SimApi.

SimApis a 64 bit o 32 bit

• Esistono versioni a 32 bit e a 64 bit di ciascuna SimApi.
• SIMCA-online e SIMCA sono a 64 bit e richiedono le varianti SimApis a 64 bit. Le SimApis legacy a 32 bit sono ancora disponibili per le installazioni più vecchie.

Posizione per il registro file e impostazioni

• Una SimApi memorizza il suo registro files nella cartella nascosta Dati programma1:
  %programdata%\Umetrics\SimApi, dove %programdata% corrisponde alla cartella effettiva sul tuo computer. Di default è C:\ProgramData.
• Ogni SimApi in genere utilizza il proprio registro file, che in modo simile al registro del server SIMCA-online file conterrà più o meno dati a seconda dell'impostazione del livello di registro. Questo file è utile per la risoluzione dei problemi. Il registro file è nominato
  .log dove è la SimApi che stai installando, ad esempioample PIAFSimApi. Vedere anche la sezione successiva per i nomi delle istanze SimApi SIMCA-online.
• Questa cartella contiene anche le impostazioni SimApi in un file XML file nominato .xml.
• La maggior parte delle SimApi ha interfacce utente grafiche che modificano le impostazioni nell'xml file, ma per alcuni inserisci le modifiche direttamente nell'XML file con un editor di testo, come Notepad. Consulta la guida utente per ogni SimApi.

File nomi quando le istanze denominate vengono utilizzate con SIMCA-online

• In SIMCA-online, ogni istanza SimApi ottiene la propria configurazione file e accedi file per lavorare con più istanze di ogni SimApi. I nomi di queste filesono preceduti dal nome dell'istanza, come indicato nella scheda SimApi nella finestra di dialogo Opzioni server SIMCA-online.
• Il seguente esempioample mostra la denominazione di questi files, dove deve essere sostituito con il nome SimApi.
• Nome della configurazione fornito quando viene aggiunta l'istanza: OmegaServer
• Configurazione file nome: OmegaServer.xml
• Tronco d'albero file nome: OmegaServer.log
• Si noti che il generico file .tronco d'albero file viene comunque creato. Questo registro file contiene voci che per motivi tecnici non possono essere indirizzate al registro file delle istanze..
• Questa cartella è nascosta in Windows per impostazione predefinita. Per vederla in File Explorer lo configuri mostra nascosto files. Nota che puoi navigare verso una cartella nascosta digitando un indirizzo in File Barra degli indirizzi di Explorer.
• Si noti che SIMCA non supporta più istanze di SimApi e pertanto utilizza i nomi senza nome istanza come descritto sopra.

Pianificazione della rete

• Dovresti posizionare il server SIMCA-online vicino alla fonte dati nella rete. Questo assicura una connessione veloce tra SIMCA-online e la sua fonte dati.
• Le apparecchiature di rete potrebbero interferire con la connessione tra SIMCA-online e la sorgente dati.

Account utente e autorizzazioni per le origini dati

• Le fonti di dati solitamente controllano l'accesso ai propri dati. Questo avviene solitamente con nomi utente e password, ma possono essere utilizzate anche restrizioni basate su indirizzo IP o DNS (ad es.ample PI si affidano al sistema Aveva PI).
• Il nome utente e la password possono essere forniti alla fonte dati in diversi modi:
• Una SimApi viene eseguita come utente Windows dell'utente che esegue SIMCA desktop o l'account di servizio SIMCA-online sul computer server. La SimApi può connettersi all'origine dati utilizzando questo account. Ecco come funzionano OPC I e PI SimApi, e ODBC se non si forniscono credenziali durante la configurazione.
• Per ODBC generico è possibile utilizzare l'applicazione ODBC Data Sources Administrator, disponibile nel menu Start di Windows.
• Alcuni provider di database forniscono i propri driver e strumenti per i loro database. I database Oracle, ad esempioample, utilizzare Oracle Data Access Components (ODAC).
• Alcune SimApi, come PI AF e ODBC, hanno finestre di dialogo di configurazione che memorizzano le credenziali crittografate nella configurazione XML SimApi file.
• PI ha anche varie opzioni di sicurezza disponibili in PI System Management Tools sul computer server PI. Per saperne di più, leggi la PI AF SimApi User Guide. Questa guida è utile anche se utilizzi la vecchia OSIsoft PI SimApi.
• OPC DA e HDA utilizzano DCOM come trasporto tra una sorgente dati e SimApi. DCOM è configurato con lo strumento Component Services (DCOMCNFG.EXE) in Windows e utilizza l'autenticazione di Windows.
• Per la vecchia OSIsoft PI SimApi (non per la più recente AF SimApi), viene utilizzata l'applicazione OSIsoft AboutPI-SDK (PISDKUtility.exe) per impostare la connessione al server PI.

Verifica della connettività della fonte dati
Quando si desidera installare una SimApi su un computer, può essere utile verificare la connettività da quel computer alla fonte dati con un altro strumento:

• ODBC Data Sources in Windows è utilizzato per configurare e testare ODBC generico. Nota che ci sono due versioni di questo strumento su Windows a 64 bit: una per le applicazioni a 32 bit e una per quelle a 64 bit. Utilizza il pulsante Test Data Source alla fine della configurazione guidata ODBC per verificare la connettività al database. Ti consigliamo di configurare le tue origini dati come DSN di sistema.
• Uno strumento di connessione specifico al database fornito dal fornitore del database, ad esempio Oracle Data Access Components.
• PI System Explorer può essere utilizzato per testare la connettività al server PI AF. Fa parte del PI AF Client, che è un prerequisito per PI AF SimApi.
• OPC UA Expert di Unified Automation – UaExpert è un client di test multipiattaforma per server OPC UA.
• L'applicazione PI-SDK (PISDKUtility.exe) può essere utilizzata per testare la connettività e per view eventuali messaggi di errore che potrebbero essere stati registrati quando SIMCA-online tenta di connettersi al server PI. Questo è utilizzato solo per la vecchia OSIsoft SimApi, non per PIAF.
• Gli strumenti di gestione del sistema PI vengono utilizzati sul computer server PI per la risoluzione dei problemi da quel lato. Ad esempioample, per cercare problemi di sicurezza che impediscono l'accesso dal server SIMCA-online. Scopri di più sulla risoluzione dei problemi del sistema PI in questo video di YouTube.
• Excel può essere utilizzato per ottenere dati da una connessione ODBC e dalla maggior parte degli altri sistemi, se è installato un plug-in adatto.
• Matrikon OPC Explorer per Ior HDA (sono strumenti separati) può essere utilizzato per testare la connettività OPC, e Matrikon OPC Analyzer può essere utilizzato per diagnosticare i problemi di connettività OPC. Scarica questi strumenti gratuiti da https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (per DInd HDA) dall'OPC Training Institute web sito "consente agli utenti di diagnosticare facilmente problemi di comunicazione e sicurezza e di ripararli all'istante con la semplice pressione di un pulsante. Tutto questo può essere fatto senza dover mai imparare a configurare DCOM"

Installazione di una SimApi

Ecco come installare una SimApi su un PC:

1. Leggi la Guida utente per la SimApi che stai installando. Contiene specifiche per quella SimApi che completano le istruzioni generali che stai leggendo ora.
2. Installare e configurare tutti i prerequisiti menzionati nella Guida utente SimApi (ad esempioampi driver del database o SDK)
3. Esegui il programma di installazione per installare SimApi. Installa la versione a 64 bit (x64) o a 32 bit (x86) che corrisponde al software in cui verrà eseguita.
4. Configurare SimApi in SIMCA-online o SIMCA come descritto nelle sezioni seguenti e fare riferimento alla guida utente di SimApi per la descrizione delle impostazioni disponibili.
5. Avviare il server SIMCA-online. Notare che questo può richiedere del tempo, perché quando SimApi viene inizializzato, enumererà tutti tags nella fonte dei dati.
6. Prova la SimApi ottenendo alcuni dati. Per SIMCA-online, puoi usare File > Estrarre come descritto in 6.1.
7. Se SimApi non funziona come previsto, fare riferimento al registro SimApi fileper la risoluzione dei problemi e alla guida utente di SimApi.

Impostazione di SimApi per l'utilizzo in SIMCA

Ecco come utilizzare SimApi in SIMCA:

1.  Avviare l'importazione del database in uno dei seguenti modi:
   • a. Per creare un nuovo progetto in SIMCA: File > Nuovo progetto regolare o Nuovo progetto batch. Seleziona Da database nella scheda Home.
   • b. Per importare un set di dati in un progetto esistente in SIMCA: dal set di dati nella scheda Dati di un progetto SIMCA aperto.
2. Fare clic su Aggiungi nuova origine dati
3. Selezionare SimApi come tipo di connessione, fare clic sul pulsante … e individuare .dll nella cartella di installazione e fare clic su Apri.
4. Fare clic su Configura e fare riferimento alla Guida utente SimApi specifica per sapere come effettuare le impostazioni.
5. Fai clic su Test data source connection per verificare che tu possa connetterti al database. Ciò potrebbe richiedere molto tempo se ci sono molti tags nella fonte dei dati.
6. Fare clic su OK per completare la configurazione.
7. Per informazioni su come lavorare con i dati importati, consultare la guida SIMCA.

Impostazione di SimApi per l'utilizzo in SIMCA-online

• Importante: per poter utilizzare una SimApi, è richiesta una licenza server SIMCA-online. Un'installazione demo di SIMCA-online non consente l'utilizzo di SimApi.
• Per aggiungere una SimApi al sistema, esegui SIMCA-online Server Options sul PC server. Scopri i passaggi dettagliati nell'argomento della guida SICMA-online Add and configure a SimApi on server.
• Suggerimento: se si apportano modifiche a una SimApi, è possibile riavviare la SimApi separatamente da Opzioni server senza riavviare l'intero server.
• Per configurare più istanze di questa SimApi, ripeti i passaggi precedenti e usa nomi univoci per ogni istanza. Leggi di più sui diversi registri e configurazioni files per le istanze in 4.2.

Test e risoluzione dei problemi di una SimApi

• Questo capitolo riguarda il test e la risoluzione dei problemi di un'installazione SimApi.

Test di una SimApi da SIMCA-online

• Una volta avviato correttamente il server SIMCA-online, puoi testare la tua SimApi in SIMCA-online (se il server non si avvia, vedi 6.2):
• Accedi al server nel client SIMCA-online e vai su Estrai su File tab. Extract ti aiuta a testare SimApi ottenendo dati tramite esso:
• I nodi ("cartelle") della SimApi vengono visualizzati nella casella di sinistra. Tags per il nodo selezionato vengono visualizzati in alto a destra.
• I dati correnti possono essere testati rapidamente semplicemente cliccando view> su tags che forniscono dati di processo continui (vedere lo screenshot)
• Fai clic con il pulsante destro del mouse su un nodo per trovare batch in un intervallo di tempo. Il nodo deve essere un nodo batch che conosce i batch.
• Selezionare tags in Estrai, fai clic su Avanti e completa la procedura guidata per ottenere i dati utilizzando le diverse modalità di recupero dati: dati correnti, storici, batch e discreti.
• Confronta i dati estratti con ciò che vedi nella tua fonte dati usando i suoi strumenti. Scopri di più su come testare e convalidare tutte le funzionalità di una SimApi in 7.13.

Risolvere i problemi di SimApi utilizzando il registro di SimApi file

• Se il server non si avvia, SimApi non funziona come previsto o l'estrazione fallisce, è necessario consultare il registro SimApi file che ti dice qual è il problema. Abilita il logging a livello di debug nel log SimApi per ottenere tutti i dettagli. Vedi 4.2.
• Nota: i log del server SIMCA-online non sono molto utili qui. Mostreranno come SimApi è stato caricato e inizializzato dal server, ma i dettagli specifici di SimApi sono nel suo log file.

Utilizzare il giusto account di servizio SIMCA-online

• Quando si verifica l'accesso all'origine dati, tenere presente che si è effettuato l'accesso come utente specifico sul computer server (in genere il proprio account utente in un dominio Windows), ma che l'account del servizio server SIMCA-online è un account diverso, per impostazione predefinita LocalSystem, che ha diritti di accesso diversi rispetto al proprio account utente.
• Per questo motivo, non è raro che i test funzionino se eseguiti con il proprio account, ma che SIMCA-online non riesca a connettersi alla fonte dati.
• Per risolvere questo problema, l'accesso deve essere concesso per l'account utilizzato dal servizio server SIMCA-online. In genere, si modifica LocalSystem in un account di servizio di dominio specifico e si concedono diritti a tale account. Si noti che ciò non si applica se SimApi utilizza credenziali impostate nella configurazione SimApi, perché tali credenziali hanno la precedenza.

Dettagli tecnici su SimApis

• Questo capitolo fornisce dettagli tecnici su come funziona una SimApi. È principalmente rivolto agli sviluppatori che vogliono comprendere le SimApi per implementare una SimApi per una fonte di dati.
• Gli sviluppatori dovrebbero leggere anche le parti precedenti di questo documento per un'introduzione a SimApis e alle descrizioni di alto livello delle funzionalità.

Quando prendere in considerazione lo sviluppo di una SimApi e quando no?

Prima di considerare lo sviluppo di una SimApi per una fonte di dati:

1. Verifica se esiste già una SimApi che puoi usare. Forse puoi abilitare qualche funzionalità nella tua fonte dati per usare una delle SimApi esistenti, come OPC UA.
2. Esamina attentamente questo documento e i suoi riferimenti e verifica se la tua fonte dati soddisfa i requisiti: ad esempioampdeve essere sufficientemente veloce e fornire non solo dati attuali, ma anche dati storici.

• Per queste ragioni, non consigliamo di sviluppare una SimApi che si collega a hardware o strumenti di basso livello. È meglio collegare quegli strumenti a uno storico di processo come Aveva PI System e lasciare che ottenga dati dallo strumento e li storicizzi. Quindi la SimApi PIAF può essere utilizzata per ottenere dati da PI al prodotto Umetrics.

Sviluppo SimApi e specifiche SimApi

• La specifica SimApi, SimApi-v2, contiene la documentazione per tutte le funzioni C in SimApi che una DLL SimApi deve implementare, nonché alcune indicazioni su come sviluppare una SimApi.
• Nella maggior parte dei casi, l'implementazione di una SimApi tramite C o C++ avviene a un livello inutilmente basso.
• Il modo consigliato e più semplice per implementare una SimApi è basarla su Exampcodice sorgente leSimApi che forniamo. È un exampl'implementazione SimApi che gestisce l'interfaccia C e la traduce in .NET Framework dove viene realizzata l'implementazione effettiva. Ha anche codice framework per la registrazione, le impostazioni, la GUI di configurazione e altro codice framework.
• Per sviluppare una SimApi, il team di sviluppatori deve avere esperienza nello sviluppo Windows, .NET Framework, C o C++. È richiesta anche una buona conoscenza della fonte dati a cui la SimApi deve connettersi, perché lo scopo di una SimApi è tradurre le richieste dati da SIMCA-online o SIMCA all'API della fonte dati. Un'implementazione di SimApi non è mai un progetto una tantum, ma in genere necessita di supporto continuo e manutenzione occasionale.

Leggere o scrivere dati

• Una SimApi ha il compito principale di fornire dati da una fonte dati. Questo è definito lettura dei dati.
• La maggior parte delle implementazioni SimApi supporta anche la scrittura di dati. Ciò significa riscrivere i dati tramite SimApi sulla fonte dati. La scrittura di dati è una funzionalità opzionale in SIMCA-online.

Tags e nodi

• A tag è un identificatore di una colonna o "variabile" in una sorgente dati. Un tagIl nome viene utilizzato per identificare il tag. I nomi all'interno del nodo devono essere univoci. SIMCA-online 18 è la prima versione a supportare un nodo che contiene un sotto-nodo e tag con lo stesso nome. Per esempioample: il nodo Parent potrebbe avere un sotto-nodo chiamato Batch e un tag denominato Batch.
• Un nodo è un contenitore di tagsUn nodo può anche contenere altri nodi, in modo simile a come un file il sistema ha cartelle nelle cartelle.
• Come in un file sistema, il nodo e tag i nomi possono essere combinati in un percorso completo che identifica in modo univoco un tag. IL tag i percorsi vengono utilizzati in SIMCA-online o SIMCA quando si seleziona tags da usare. Un tag il percorso inizia con un nome di istanza SimApi seguito dalla struttura del nodo e termina con tag nome, ogni elemento separato da due punti (:). Ad esempioampil “:ODBCSQLServer:Nodo:SensoreTag1".

La SimApi enumera tags e nodi all'avvio

• Un'implementazione SimApi esplora il server per i nodi e tags nella sorgente dati quando SimApi viene inizializzata e ne tiene traccia in modo che le varie funzioni SimApi utilizzate per l'enumerazione tags e il nodo può essere implementato.
• L'inizializzazione di SimApi non avviene solo all'avvio del server, ma può anche essere riattivata da un utente in SIMCA-online con la funzionalità Aggiorna SimApi.

Sensibilità alle maiuscole/minuscole di tag- e nomi dei nodi

• Tag i nomi e i nomi dei nodi sono sensibili alle maiuscole e alle minuscole.
• Quindi, un tag chiamato "tag1” non è la stessa cosa di “Tag1” a causa della diversa maiuscola della “T”. Si sconsiglia di utilizzare tags o nomi di nodi che differiscono solo per le maiuscole e le minuscole.

Nodo di processo continuo 

• Quando un nodo contiene tags con dati di processo continui, può essere definito nodo di processo. I due screenshot seguenti mostrano una rappresentazione tabulare di un nodo di processo con dati seguita da un'immagine che mostra come appare il nodo quando si seleziona tags in SIMCA-online.

I nodi di processo continui devono essere indipendenti da batch, esecuzioni o tempo

• Per funzionare bene in una SimApi, un nodo deve essere indipendente da batch, esecuzioni o tempo. Avere un nodo che contiene dati per un batch specifico o un intervallo di tempo non funzionerebbe bene in SIMCA-online perché la configurazione del progetto potrebbe quindi leggere solo i dati per quel batch e non essere utilizzata per altri batch.
• Al contrario, un nodo dovrebbe essere mappato su una o più unità fisiche nel processo in cui vengono eseguite le misurazioni.

ID lotto tag richiesto nei nodi di processo continuo per l'esecuzione di progetti batch

• Ogni processo continuo deve avere un tag (variabile) contenente l'identificativo del batch per ogni osservazione. Questo identificativo del batch è utilizzato da SIMCA o SIMCA-online per sapere a quale batch appartiene ogni osservazione.
• Il $BatchID tag negli screenshot in 7.4.3 è un esempio del genereamplui.
  Sebbene non sia obbligatorio, si consiglia di averne uno tag nel nodo del processo che mostra la fase o il passaggio corrente del processo. Questo tag può quindi essere utilizzato in condizioni di esecuzione di fase in SIMCA-online o in SIMCA durante l'importazione dei dati. I valori per questo tag può essere per esempioampla “fase1”, “pulizia”, “fase2”.

Nodo di contesto batch

• Un nodo batch è un nodo che tiene traccia dei batch; i loro identificatori batch, orari di inizio e di fine. È un requisito per l'esecuzione di progetti batch in SIMCA-online. Una fonte dati può avere più di un nodo batch che espone i batch in modi diversi. L'utente seleziona il nodo batch che si applica alla sua applicazione. Questa esample espone batch che si estendono su due unità diverse:
• /Factory1 – lotti con durate aggregate sia per Unit1 che per Unit2.
• /Factory1/Unit1 – batch con durata solo in Unit1
• /Factory1/Unit2 – batch con durata solo in Unit2
• Se non hai un nodo batch nella tua fonte dati, puoi usare il Batch Context Generator in SIMCA-online. Consulta la guida integrata.
• Dati batch facoltativi
• Un nodo batch può anche contenere dati batch; dati per i quali esiste una sola osservazione per l'intero batch. Nota che tags con dati batch non devono essere in un nodo che ha la piena funzionalità di un nodo batch. È sufficiente che SimApi supporti la lettura di dati batch per il tagsScopri di più sui dati batch nella versione 7.6.
• Ecco un example di un nodo batch:
• Nota: lo screenshot qui sopra è tratto da DBMaker, in bundle con SIMCA-online. Per vederlo tu stesso in DBMaker, clicca su View Pulsante Dati nel database Bakers Yeast per visualizzare due finestre, una delle quali è il nodo batch e l'altra i dati del processo.

Tipi di dati: dati numerici, dati di testo e dati mancanti

• Per ogni tag, una SimApi può supportare tre tipi di dati: numerici, di testo e mancanti:
• I dati numerici sono in genere valori reali dei parametri di processo, ad esempioample 6.5123. SimApi può gestire solo valori in virgola mobile a precisione singola a 32 bit. Formato in virgola mobile a precisione singola - Wikipedia. Tutti gli altri tipi di dati numerici in una sorgente dati devono essere convertiti in float. In quanto tali, possono gestire sia valori grandi che piccoli, ma con solo circa 6 o 7 cifre significative. Scopri di più nella Guida tecnica.
• Ciò può portare a una perdita di precisione per numeri interi grandi o per numeri reali che sono sia grandi che hanno decimali. Per maggiori informazioni, vedere la Guida tecnica.
• I dati di testo/stringa vengono utilizzati per gli ID batch, le condizioni di esecuzione di fase o per le variabili qualitative. I valori per il testo tag i dati sono sensibili alle maiuscole e alle minuscole. Ciò significa che il valore "running" non è lo stesso di
  “IN ESECUZIONE”. Le variabili datetime non sono supportate direttamente da SimApi, ma possono essere restituite come una stringa formattata come AA-MM-GG HH:MM (ad esempioample “2020-09-07 13:45”).
• I valori mancanti indicano che non c'è alcun valore da restituire, ovvero nessun dato.
• Il tipo restituito dipende dall'implementazione di SimApi. Una SimApi conosce i dati nella sorgente dati e dovrebbe restituire il tipo di dati più adatto.

Tre modalità di recupero dei dati: continuo, Batc,h e discreto

• La specifica SimApi definisce tre modalità di recupero dei dati, vale a dire tre modi diversi in cui SimApi può fornire dati da tags in una sorgente dati (o nella direzione opposta: scrivere i dati su tags in una fonte di dati).
• Recupero continuo dei dati: si riferisce ai dati letti in modo continuo e sequenziale, osservazione per osservazione man mano che il batch o il processo evolve. I dati vengono letti per il momento corrente o per un intervallo specifico, a intervalli regolari tra le osservazioni. Ad esempioample, tutti i dati tra le 09:00:00 e le 10:00:00 sampcondotto ogni 60 secondi, per un totale di 61 osservazioni quando i punti finali sono inclusi.
• Recupero dati batch: si riferisce a una singola osservazione con dati per un intero batch (non associato a una scadenza o a un punto temporale specifici). Gli attributi batch e i dati di centratura locale vengono letti come dati batch in SIMCA-online. Anche le condizioni batch vengono normalmente lette come dati batch (a meno che non siano configurate per il recupero dati discreti).
• Recupero dati discreti: i dati discreti possono consistere di diverse osservazioni per molte scadenze. Ma a differenza dei dati continui, i dati discreti non vengono letti in sequenza, bensì tutti i dati in una volta per una fase specifica di un batch. I dati non devono essere distanziati con intervalli regolari della variabile di scadenza. Tutti i dati vengono riletti ogni volta che vengono richiesti, all'intervallo configurato.
• Per qualsiasi dato tag i dati possono essere richiesti in una qualsiasi delle tre modalità, ma in genere una SimApi supporterà solo una di queste modalità per un individuo tagAllo stesso modo è consentito mescolare tags all'interno di un nodo, ma in genere tutti tags all'interno di un nodo specifico supportano la stessa modalità di recupero dati.
• Per i dati continui (ma non per i dati batch o discreti2), è possibile effettuare richieste di dati correnti o storici, argomento della prossima sezione.
• Non tutte le SimApi supportano tutte le modalità. Vedere la matrice delle funzionalità sopra e la SimApi web pagina per i dettagli.

Dati continui attuali e storici tramite SimApi

• I dati continui si riferiscono a dati di processo che cambiano nel tempo.

Dati attuali

• La lettura dei dati correnti significa chiedere alla fonte dei dati i valori più recenti di tags al momento della richiesta. Nota che l'ora della fonte dati esterna non è utilizzata qui.
• I dati letti come dati correnti sono quelli che SIMCA-online mostrerà come dati live. Per questo motivo, è importante che non ci siano ritardi non necessari nella fonte dei dati. I dati correnti devono essere il più recenti possibile per funzionare bene in SIMCA-online.
• La fonte dati può usare la sua conoscenza dei dati e di quanto a lungo i valori sono validi e decidere di restituire i dati mancanti quando i dati grezzi per un punto temporale sono troppo vecchi. Ad esempioample: i dati sono richiesti alle 15:00:00 ma il punto dati più recente nella fonte dati è delle 03:00:00. In questo caso i dati sono vecchi di 12 ore, quindi SimApi potrebbe decidere di restituire un valore mancante (nessun dato).

Dati storici

• La lettura dei dati storici significa chiedere alla fonte dei dati i valori di uno o più tags per un intervallo di tempo specifico con un intervallo specifico tra le osservazioni. Nota che qui è l'ora locale della fonte dati che viene utilizzata per trovare i dati. Pertanto, la sincronizzazione oraria tra la fonte dati e i server è importante.
• I dati storici sono costituiti da una matrice di dati. Spetta all'implementazione SimApi richiedere i dati dalla fonte dati e samplascialo all'intervallo specificato e costruisci la matrice di dati da restituire:
• A volte la fonte dati stessa ha funzioni di aggregazione per restituire dati elaborati, oppureampfunzioni di elaborazione, che possono essere utilizzate per restituire i dati corretti.
• Per altre fonti di dati, SimApi deve richiedere tutti i dati nell'intervallo di tempo e quindi samplasciare le giuste osservazioni per costruire la matrice.
• I dati devono essere restituiti per un intervallo di tempo, anche se potrebbero non esserci dati grezzi nell'intervallo di tempo, ma solo appena prima dell'ora di inizio. Ad esempioample: i dati esistono nella sorgente dati nei punti temporali 10 e 20. SimApi richiede i dati per i punti temporali 15 e 17. In questo caso, SimApi dovrebbe restituire i valori per il punto temporale 10, ma timestampcome orario 15 e 17 poiché questi erano i punti dati più recenti in quei momenti. I valori per tags al tempo 10 sono indicati come valori limite per l'intervallo richiesto. Per una spiegazione più approfondita dei valori limite, vedere ad esempioampla documentazione per returnBounds in UA Parte 11: Accesso storico – 6.4.3 Struttura ReadRawModifiedDetails
  (http://opcfoundation.org/)
• L'interpolazione non dovrebbe mai essere utilizzata per calcolare valori per punti temporali futuri, perché i dati non corrisponderanno a ciò che viene letto in tempo reale come dati correnti. Ad esempioampdal punto precedente: se i dati per 15 e 17 dovessero essere interpolati utilizzando i valori per gli elementi 10 e 20, utilizzerebbero di fatto valori del futuro, il che non è consentito.
• La fonte dati può usare la sua conoscenza dei dati e di quanto a lungo i valori sono validi e decidere di restituire i dati mancanti quando i dati grezzi per un punto temporale sono troppo vecchi. Ad esempioample: i dati sono richiesti per le 15:00:00 ma il punto dati più recente nella fonte dati è delle 03:00:00. In questo caso, i dati sono vecchi di 12 ore, quindi SimApi potrebbe decidere di restituire un valore mancante (nessun dato).

Nota: SIMCA-online in genere non richiede più di cento osservazioni in una chiamata durante la normale esecuzione del progetto. Quando si esegue l'estrazione in SIMCA-online, o quando si esegue SIMCA desktop, possono essere effettuate richieste di dati più grandi. Queste possono richiedere molto tempo, il che è prevedibile.

I dati attuali e i dati storici devono corrispondere

• A volte possono esserci delle differenze quando i dati vengono letti come dati correnti in tempo reale o dati storici. Ciò causa problemi in SIMCA-online perché il server passa automaticamente tra dati correnti e storici a seconda delle necessità.

Acquisizione dati a bassa latenza

• Quando una fonte dati viene utilizzata da SIMCA-online in tempo reale, è importante che i dati nella fonte dati siano aggiornati. Non dovrebbero esserci ritardi non necessari nell'acquisizione dei dati nella fonte dati. I dati di processo continui per tutte le variabili devono essere disponibili contemporaneamente per ogni osservazione. I dati che arrivano in ritardo per alcune variabili non saranno raccolti da SIMCA-online.

I dati possono essere letti in qualsiasi momento 

• Quando SIMCA-online chiede un valore di a tag per il tempo t riceverà il valore dalla fonte dati dal tempo t, o l'ultima osservazione nella fonte dati prima del tempo t, o un valore interpolato per il tempo t. Quindi, il server otterrà sempre un valore ogni volta che lo richiede, anche se un'osservazione per questo esatto punto temporale potrebbe non esistere nella fonte dati.
• Orarioampnella SimApi sono sempre UTC. I client SIMCA-online e SIMCA presentano l'ora come ora locale.

Infilatura 

• La SimApi è, di default, chiamata da un singolo thread dall'utente della SimApi. Questo vale per tutte le versioni di SIMCA e SIMCA-online fino alla versione 17.
• SIMCA-online 18 supporta un feature flag per attivare l'accesso multi-thread tramite SimApi. Per saperne di più, leggi l'argomento della guida Accesso SimApi concorrente.
• Ciò significa che SimApis dovrebbe prepararsi al multi-threading, se possibile, rendendo sicuro il thread di implementazione di SimApi e documentando questo e qualsiasi altra considerazione per gli utenti di SimApi.

Tronco d'albero file

• Una SimApi dovrebbe registrare azioni, messaggi di errore e avvisi nel suo registro file per aiutare nella risoluzione dei problemi. Utilizzare i diversi livelli di log per indicare l'importanza della registrazione.
• Si consiglia di registrare "Non implementato" per le funzionalità che non sono state implementate in una SimApi.

Gestione degli errori

• Quando una SimApi non riesce a soddisfare una richiesta dalla fonte dati, può gestire questo problema in uno dei due modi: restituendo valori mancanti (nessun dato) o segnalando un errore SimApi:
• Restituendo i valori mancanti al chiamante e segnalando il successo, il chiamante può continuare normalmente (ma ovviamente senza dati). Questa è una pratica consigliata per errori parziali, ad esempio quando i dati potrebbero essere ottenuti per alcuni, ma non per tutti, tags in una richiesta.
• La segnalazione di un errore SimApi consente al chiamante (ad esempioampil server SIMCA-online) per vederlo immediatamente e agire. Questa è una pratica consigliata per le richieste che falliscono completamente e non possono restituire alcun dato.
• SIMCA-online gestisce i valori mancanti o i codici di errore in modo diverso, come descritto nella Guida tecnica SIMCA-online.

Requisiti di prestazioni SimApi

• Le funzioni nella SimApi vengono utilizzate per ottenere dati.
• Se l'accesso ai dati è lento, SimApi non funzionerà bene, il che è un esempioample shows: Se SIMCA-online richiede dati ogni secondo, ma impiega due secondi per ottenerli, il server SIMCA-online non sarà mai in grado di tenere il passo in tempo reale, ma rimarrà sempre più indietro.
• Nelle sottosezioni mostreremo come SIMCA e SIMCA-online utilizzano le funzioni SimApi di accesso ai dati e con quale frequenza verranno chiamate le funzioni SimApi. Questo può aiutare a impostare i requisiti di prestazioni per un'implementazione SimApi.

Utilizzo delle funzioni SimApi da parte di SIMCA

• Quando SIMCA desktop o altri prodotti offline utilizzano una SimApi per ottenere dati, queste richieste riguarderanno batch ed elaboreranno dati per un set di variabili in un determinato intervallo di tempo.
• Poiché queste richieste vengono avviate manualmente da un utente, non si verificano molto frequentemente e non causano un carico significativo per un'origine dati.
• Per ottenere i dati vengono utilizzate le seguenti funzioni SimApi:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Utilizzo delle funzioni SimApi da parte di SIMCA-online

• SIMCA-online è utilizzato per il monitoraggio in tempo reale di un processo e quindi richiede dati tramite SimApi a intervalli regolari. L'intervallo di esecuzione più breve che può essere utilizzato è 1 secondo. Alcune esampgli intervalli di esecuzione sono 10 s, 1 minuto o 10 minuti.
• Un server può avere molti progetti in esecuzione contemporaneamente.
• Per ridurre il numero di chiamate API tramite SimApi, il server ottimizza le richieste di dati raggruppando numerose richieste simultanee più piccole in un'unica richiesta più grande per tutte le variabili contemporaneamente (per saperne di più, consulta l'argomento della guida "La lettura ottimizzata dalle origini dati migliora le prestazioni").
• L'algoritmo di esecuzione del server funziona in questo modo quando richiede dati utilizzando le funzioni SimApi elencate di seguito:
• Tutte le fasi che vengono eseguite allo stesso intervallo vengono raggruppate in una singola chiamata SimApi per ridurre il numero di chiamate. Il server legge i dati più recenti per tutte le variabili utilizzate da tutti i modelli che condividono l'intervallo, ovvero questa chiamata produrrà un'ampia riga di dati che verrà quindi utilizzata da tutti i progetti.
  • simapi2_connectionLeggiDatiCorrenti
• Per ogni progetto batch il server deve anche sapere quali batch sono attivi. Ciò deve avvenire anche ogni volta che un progetto viene eseguito:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes viene chiamato meno frequentemente.
• Inoltre, SIMCA-online richiede anche dati storici. Queste richieste avvengono solo quando necessario, come per recuperare l'inizio di un batch iniziato prima dell'avvio di SIMCA-online, o quando il server è in ritardo e deve leggere un blocco di dati:
  • simapi2_connectionReadHistoricalDataEx
• Facoltativamente, alcune configurazioni di progetto utilizzano funzionalità che utilizzano dati batch o dati discreti che si traducono in chiamate SimApi a:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Facoltativamente, alcune configurazioni di progetto utilizzano la funzione write-back per riportare i dati alla fonte dati:
  • simapi2_connectionWriteHistoricalDataEx (e funzioni corrispondenti per dati batch, dati discreti)
• È importante che ogni chiamata alle funzioni principali per ottenere i dati, readCurrentData, getActiveBatches/getBatchTimes, sia veloce e non comporti difficoltà computazionali per la fonte dati stessa, data la frequenza con cui SIMCA-online può chiamare tali funzioni.

Test e convalida dei dati SimApi

• Questa sezione riguarda il test di una SimApi per verificare che i dati restituiti corrispondano ai dati nella sorgente dati stessa. Eseguire test come questo è importante dopo aver creato o modificato l'implementazione di SimApi, o quando cambia l'API di una sorgente dati.
• In pratica, la convalida dei dati viene eseguita utilizzando SIMCA-online e la sua funzionalità Extract per estrarre i dati dalla fonte dati tramite SimApi e quindi confrontarli con i dati grezzi nella fonte dati. Desktop SIMCA non può essere utilizzato per testare gli aspetti in tempo reale di una SimApi.

Preparativi e requisiti

• Alcuni elementi sono facoltativi ma possono essere eseguiti se l'ambito del test li include:

1. Installare SIMCA-online come descritto nei file ReadMe e Installation Guide.pdf contenuti nello zip del prodotto.
2. Ottieni una licenza per il server SIMCA-online e installalo. La SimApi non funzionerà senza una licenza. L'articolo della knowledge base per SIMCA-online mostra come ottenere la licenza del prodotto. Ad esempioample: SIMCA-online 18 (sartorius.com)
3. Installa e configura la SimApi che vuoi testare. Fai riferimento ai capitoli 4 – 5 di questo documento e alla guida utente della SimApi specifica.
   • a. Facoltativo: assicurarsi che il manuale d'uso sia aggiornato e corretto.
4. Assicurati di avere uno strumento per la tua fonte dati che ti consenta di confrontare i dati SimApi.
5. Nel client desktop SIMCA-online, accedi al tuo server SIMCA-online e usa File > Estrarre per ottenere dati tramite SimApi.
6. Facoltativo se l'ambito del test lo include: dopo aver terminato il test, disinstallare SimApi e verificarne la filevengono rimossi.

Cosa testare

• La matrice delle feature nel capitolo 3 elenca tutte le feature possibili, ma una data implementazione SimApi potrebbe supportare solo un sottoinsieme. Dovresti testare tutte le feature implementate dalla data SimApi.
• I seguenti test sono comuni alla maggior parte delle implementazioni SimApi:
• Autenticazione con nomi utente e password
• Prova le varie impostazioni nella configurazione di SimApi
• Gerarchia dei nodi: i nodi e tags esposti da SimApi sono corretti.
  • Ci deve essere un tag esposto per tutte le "variabili" che dovrebbero essere disponibili tramite SimApi. Examples: misure di processo, valori calcolati, costanti.
• Resilienza della connessione: se l'origine dati non è disponibile, ciò comporta avvisi o errori nel registro file, ma che la connessione alla fonte dati venga ristabilita automaticamente quando la fonte dati è disponibile.
• Istanze multiple: due istanze possono essere configurate e utilizzate in modo indipendente e simultaneo, con registri separati files.
• Dati correnti: estrai i dati correnti per tagsAssicurati che i dati siano gli ultimi valori noti dalla fonte dati o che siano mancanti a causa della scarsa qualità o quando i dati sono troppo vecchi.
  • Estrarre i dati ogni 10 secondi (circa) per un minuto.
• Dati storici continui: estrai i dati storici per tags.
  • Utilizza l'intervallo di tempo che corrisponde a quando hai estratto i dati correnti. Verifica che i dati correnti corrispondano ai dati storici e ai dati grezzi nell'origine dati.
  • Prova diversi intervalli di tempo e sampintervalli di ling, verificare che i dati corrispondano alla fonte dati.
  • Prova a estrarre i dati ogni 1 s, che è il s più breve possibileampintervallo di tempo.
  • Prova vari tipi di tags nella fonte dati (variabili di processo, ecc.), assicurandosi che i dati corrispondano.
  • Nota: SIMCA-online può suddividere una singola richiesta di dati storici di grandi dimensioni in diversi blocchi più piccoli. Ciò sarà visibile nel registro SimApi.
• Verificare che SimApi funzioni con dati di testo, dati numerici e dati mancanti.
• Registro SimApi fileVerificare che il registro contenga voci ragionevoli.
• Nodo batch: fare clic con il pulsante destro del mouse su un nodo e scegliere Trova batch.
  • Verificare i nomi dei batch, gli orari di inizio e di fine dei batch.
  • Prova un batch attivo in esecuzione nella sorgente dati. Non dovrebbe avere un orario di fine tramite SimApi.
• Identificatore batch del nodo di processo tagSe SimApi ha funzionalità di nodo batch (vedere punto precedente), deve anche avere un identificatore batch tag nel nodo dati di processo corrispondente. I dati per questo tag dovrebbe essere l'identificatore del batch (nome del batch). Questi dati sono necessari per i progetti batch per identificare a quale batch appartiene una riga di dati.

A seconda che SimApi lo supporti, potresti anche voler testare:

• Dati batch utilizzando File > Estrai.
• Dati discreti utilizzando File > Estrai. Nota: per testare dati discreti con File > Estrarre il nodo, il nodo batch e il nodo dati discreti devono essere nella stessa SimApi (quando SIMCA-online esegue progetti, possono provenire da SimApi diverse).
• Write back: spingendo il batch di dati nella sorgente dati. Per testarlo, devi configurare una configurazione di progetto in SIMCA-online per riscrivere i vettori di dati nella sorgente dati. Quindi esegui il progetto in SIMCA-online e controlla i dati che vengono riscritti nella sorgente dati.
• I dati continui vengono configurati nella pagina Evolution Write Back nella configurazione del progetto.
• I dati discreti vengono configurati nella stessa pagina, ma solo per una fase configurata per il recupero dei dati discreti.
• Dati batch dal Batch Write back

ULTERIORI INFORMAZIONI

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Svezia
• Telefono: + 46 90-18 48 00
• www.sartorius.com
• Le informazioni e le figure contenute in queste istruzioni corrispondono alla data di versione specificata di seguito.
• Sartorius si riserva il diritto di apportare modifiche alla tecnologia, alle caratteristiche, alle specifiche e al design dell'apparecchiatura senza preavviso. Le forme maschili o femminili vengono utilizzate per facilitare la leggibilità in queste istruzioni e denotano sempre contemporaneamente tutti i generi.
  Avviso sui diritti d'autore:
• Queste istruzioni, compresi tutti i componenti, sono protette da copyright.
• Qualsiasi uso oltre i limiti della legge sul copyright non è consentito senza la nostra approvazione.
• Ciò vale in particolare per la ristampa, la traduzione e l'editing, indipendentemente dal tipo di supporto utilizzato.

Domande frequenti

• D: Qual è lo scopo di SimApis?
  • R: Lo scopo principale di SimApis è fornire dati ai prodotti Umetrics Suite per la creazione di progetti e la costruzione di modelli.
• D: Come posso risolvere i problemi relativi all'installazione di SimApi?
  • A: Puoi risolvere il problema testando da SIMCA-online, controllando il registro SimApi filee assicurando la corretta configurazione dell'account di servizio.

Documenti / Risorse

Software API SARTORIUS Sim [pdf] Guida utente Software API Sim, Software API, Software

Riferimenti

• Manuale d'uso