SARTORIUS Sim Api Software

Technische Daten

• Produktname: SimApi Guide
• Veröffentlichungsdatum: 5. September 2024
• Zweck: Bereitstellung von Daten für Umetrics Suite-Produkte

Anweisungen zur Produktverwendung

Einführung in SimApis

• SimApis werden zum Abrufen von Daten für die Projekterstellung und den Modellaufbau in Umetrics Suite-Produkten verwendet.

Bezug von SimApis

• Informationen zum Erhalt von SimApis finden Sie in der offiziellen Dokumentation oder beim Kundensupport.

SimApi-Funktionen

• SimApis liefern Echtzeitdaten für die Überwachung, Steuerung und Modellerstellung in SIMCA und SIMCA-Online.

Nur aktuelle Datennutzung

• Für eine optimale Leistung wird empfohlen, nur aktuelle Daten zu verwenden und historische Daten zu vermeiden.

Vorbereitung einer SimApi-Installation

• Stellen Sie vor der Installation sicher, dass Ihr System die im Benutzerhandbuch angegebenen Mindestanforderungen erfüllt.

Installieren einer SimApi

• Befolgen Sie die Schritt-für-Schritt-Anweisungen im Benutzerhandbuch, um SimApi auf Ihrem System zu installieren.

Einrichten von SimApi für SIMCA

• Konfigurieren Sie die SimApi-Einstellungen in SIMCA gemäß den bereitgestellten Richtlinien.

Einrichten von SimApi für SIMCA-online

• Richten Sie die SimApi für Echtzeit-Datenabruf und Rückschreibvorgänge in SIMCA-online ein.

Testen und Fehlerbehebung

• Führen Sie nach der Installation Tests durch, um die ordnungsgemäße Funktion sicherzustellen. Bei Problemen lesen Sie bitte den Abschnitt zur Fehlerbehebung im Benutzerhandbuch.

Tests von SIMCA-online

• Testen Sie die SimApi-Integration von SIMCA-online, um den Datenabruf zu überprüfen.

Fehlerbehebung mit Log Files

• Verwenden des SimApi-Protokolls file um etwaige Installations- oder Betriebsprobleme zu identifizieren und zu beheben.

Dienstkontokonfiguration

• Sorgen Sie für eine reibungslose Funktion für die korrekte Konfiguration des SIMCA-Online-Service-Kontos.

Technische Details

• Ausführliche technische Informationen zu SimApis finden Sie in Abschnitt 7 des Benutzerhandbuchs.

Einführung in SimApis

• Eine SimApi ist eine Softwareschnittstelle zwischen der Umetrics® Suite Software und einer Datenquelle. Der Hauptzweck einer SimApi besteht darin, Daten an SIMCA®-online oder SIMCA® bereitzustellen.
• Sartorius Stedim Data Analytics AB entwickelt SimApis für viele verschiedene Datenquellen, wie z. B. Prozesshistoriker und allgemeine Datenbanken.
• Dieses Dokument zeigt, was eine SimApi ist und wie sie in den Produkten der Umetrics Suite verwendet wird. Sie erfahren, wie Sie eine SimApi planen und installieren, Fehler beheben und Ihre Installation testen. Das letzte Kapitel enthält technische Details zu SimApis für Entwickler.

Zweck der SimApi: Bereitstellung von Daten für Umetrics Suite-Produkte

• Der Hauptzweck einer SimApi besteht darin, Daten aus einer Datenquelle an SIMCA-online oder SIMCA bereitzustellen. Die Datenquelle ist nicht Teil von SIMCA-online, sondern kann ein Prozessarchiv oder ein anderes System sein, das die Daten speichert und verwaltet.
• Eine SimApi stellt eine Hierarchie von Knoten bereit, die Ordnern in einem file System. Jeder Knoten kann andere Knoten enthalten oder tags. A tag entspricht einer Variable. Für diese tagskönnen Daten abgerufen werden. Das Bild zeigt eine tag, Temp, ausgewählt im Knoten
• BakersYeastControlGood in einer Datenquelle in SIMCA-online. Es werden auch die neuesten Werte aus der Datenquelle angezeigt.

SimApi-Nutzung in der Umetrics Suite

• Die Desktopsoftware SIMCA kann eine SimApi verwenden, um Daten zur Projekterstellung und zum Modellaufbau abzurufen, wie das folgende Bild zeigt.
• SIMCA-online verwendet SimApis, um Daten in Echtzeit für die Überwachung und Steuerung abzurufen und Daten an die Datenquelle zurückzuschreiben. Das folgende Bild zeigt, wo sich die SimApi in einem System befindet, das aus einer Datenquelle, einem SIMCA-online-Server und Clients besteht.

Häufig verwendete SimApis

• Die am häufigsten verwendeten SimApis sind:
• Die PI AF SimApi zur Verbindung mit Aveva (ehemals OSIsoft) PI-Systemen.
• Die OPC UA SimApi
• Die ODBC SimApi – für den allgemeinen Zugriff auf Datenbanken wie SQL Server oder Oracle
• Alle verfügbaren SimApis sind zusammen mit ihren Funktionen in Abschnitt 3 aufgelistet.

Die DBMaker SimApi für Simulationsdaten

• DBMaker ist eine Anwendung, die mit der SIMCA-online-Serverinstallation bereitgestellt wird. Sie simuliert eine Datenquelle, z. B. einen Prozesshistoriker, mithilfe einer vorinstallierten Datentabelle, in der Beobachtungen einzeln über die DBMaker-SimAPI an SIMCA-online übermittelt werden.
• DBMaker dient ausschließlich zu Demonstrationszwecken und kann nicht in der Produktion mit Livedaten aus einer Datenquelle eingesetzt werden. Weitere Informationen zu DBMaker finden Sie in der integrierten Hilfe.

Zusätzliche Dokumentation

• Dieses Dokument ist eines aus einer Reihe verwandter Dokumente, jedes mit einem anderen Schwerpunkt und einer anderen Zielgruppe:

Quelle	Was	Wo
SIMCA-online web Seite	Einführungsinformationen und Downloads	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe und Installation.pdf	Installation und erste Schritte mit SIMCA – Online-Demodaten	In der Installations-ZIP file
SIMCA-online Implementierungshandbuch	Beschreibt die SIMCA-Online-Funktionalität, stellt sie in Kontext mit anderer Umetrics Suite-Software, beschreibt Anforderungen und Best Practices für eine erfolgreiche Bereitstellung und bietet schrittweise Installationsanweisungen.	sartorius.com/umetrics-simca- online
SimApi-Handbuch	Vorbereiten und Durchführen von SimApi-Installationen, einschließlich Fehlerbehebung. Enthält auch technische Details zu SimApis für Entwickler.	sartorius.com/umetrics-simapi
SimApi-Benutzerhandbücher	Dokumentation für jede veröffentlichte SimApi mit Funktionen, Installationsanweisungen und Konfigurationsdetails.	sartorius.com/umetrics-simapi
Technisches Handbuch SIMCA-online	Technische Referenz zur Planung der SIMCA-Online-Serverinstallation, Fehlerbehebung und detaillierte Informationen zur Funktionsweise von SIMCA-Online.	sartorius.com/umetrics-simca-online
SIMCA-Onlinehilfe	Web-basierte Hilfe zur Nutzung von SIMCA-online und zur Funktionsweise von SIMCA-online.	In der Software selbst und auf sartorius.com/umetrics-simca
SIMCA-online Web Client-Installationshandbuch	Beschreibt die Installation des SIMCA-online Web Klient.	sartorius.com/umetrics-simca-online
Umetrics Wissensdatenbank	Durchsuchbare Datenbank mit Artikeln zu jeder veröffentlichten Softwareversion, technischen Artikeln und bekannten Problemen in Produkten der Umetrics Suite.	sartorius.com/umetrics-kb
SIMCA-Hilfe/Benutzerhandbuch	So verwenden Sie Desktop-SIMCA zum Erstellen von Projekten und Modellieren von Daten.	In SIMCA und auf sartorius.com/umetrics-simca
Unterstützung web Seite	So erhalten Sie technischen Support.	sartorius.com/umetrics-support

Technische Unterstützung

• Das Sartorius Online-Support-Team beantwortet technische Fragen zu SimApis und leitet auch Anfragen zur Verbesserung von SimApis an die entsprechenden Ansprechpartner weiter. Erfahren Sie mehr unter sartorius.com/umetrics-support.

Bezug von SimApis

• Wir bieten Dokumentationen zu verfügbaren SimApis und Links zu Installationsprogrammen unter sartorius.com/umetrics-simapi.
• Jede SimApi ist in ihrem Benutzerhandbuch dokumentiert.
• Der SimApi-Leitfaden, den Sie gerade lesen, ergänzt diese Informationen durch SimApi-ergänzende Informationen zur SimApi-Planung, -Installation und -Fehlerbehebung.

SimApi-Funktionen

• Nicht alle Datenquellen sind gleich. Eine SimApi muss nicht alle Funktionen der Spezifikation implementieren. Aus diesen Gründen bieten verschiedene SimApis unterschiedliche Funktionalitäten. Die folgende Matrix listet die verfügbaren SimApis und ihre Funktionen auf.
• Die Funktionen werden unten erläutert. Beachten Sie, dass die Tabelle separate Spalten hat, um anzuzeigen, welche Funktionen in SIMCA-online bzw. SIMCA verfügbar sind.

Besonderheit	Zweck	SIMCA-online Nutzung	SIMCA-Nutzung
Aktuelle Daten	Lesen Sie eine einzelne Beobachtung mit dem aktuellsten Wert aus der Datenquelle.	Normale Ausführung in Echtzeit	–
Historische Daten	Lesen Sie viele Beobachtungen gleichzeitig mit historischen Daten aus der Datenquelle.	Aufholen und Vorhersagen von Daten aus der Vergangenheit, Erstellen von Projekten mit File > Neu	Datenbankimport-Assistent zum Importieren von Prozessdaten für die Modellerstellung.
Diskrete Daten	Labor-/IPC-Daten aus der Datenquelle lesen. Viele Beobachtungen pro Charge.	Für Batchprojekte mit Phasen oder Batchbedingungen, die für den diskreten Datenabruf konfiguriert sind.	–
Chargendaten	Lesen Sie die Chargenbedingungen und die endgültigen Qualitätsattribute (oder	Batch-Bedingungen oder lokale Zentrierung.	Datenbankimport-Assistent zum Lesen von Batch-Bedingungen für

Besonderheit	Zweck	SIMCA-online Nutzung	SIMCA-Nutzung
	andere MES-Typdaten). Eine Beobachtung pro Charge.		Modellerstellung auf Batchebene.
Batch-Knoten	Geben Sie die Startzeit und die Endzeit (leer für einen aktiven Stapel) für einen bestimmten Stapel an. Zählen Sie alle Stapel auf, die in einem bestimmten Zeitraum vorhanden waren.	Erforderlich für die Ausführung von Batchkonfigurationen.	Datenbankimport-Assistent zum Auswählen zu importierender Stapel.
Rückschreiben – kontinuierliche Daten	Schreiben Sie kontinuierliche Daten, beispielsweise Vorhersagen, zurück in die Datenquelle.	Rückschreiben von Daten aus der Batch-Evolutionsebene, für Control Advisor oder für kontinuierliche Konfigurationen	–
Zurückschreiben – diskret	Schreiben Sie diskrete Daten, beispielsweise Vorhersagen, zurück in die Datenquelle.	Rückschreiben für Batchkonfigurationen auf Batchentwicklungsebene für Phasen, die für den diskreten Datenabruf konfiguriert sind	–
Zurückschreiben – Batchdaten	Schreiben Sie Daten auf Batchebene, wie beispielsweise Vorhersagen oder endgültige Qualitätsattribute, zurück in die Datenquelle.	Rückschreiben für die Batchkonfiguration auf Batchebene	–
Knotenhierarchie	Die SimApi unterstützt eine Hierarchie von Knoten, ähnlich einer file System. Jeder Knoten kann enthalten tags und andere Knoten. Die Hierarchie erleichtert die Verwaltung einer großen Anzahl von Knoten und tags.	Unterstützt überall dort, wo tags verwendet.
Anordnung tag Erweiterung	Ein Array tag speichert mehrere Werte. Die SimApi erweitert das Array tag zu vielen einzelnen tags, eines für jedes Element im Array.	Unterstützt wo tags werden für kontinuierliche Daten verwendet. Jeder erweiterte tag muss einer Variablen im SIMCA-Projekt zugeordnet werden.
Mehrere Datenquellen	Die SimApi kann sich mit mehr als einer Datenquelle verbinden oder unterstützt mehrere Instanzen mit individuellen Einstellungen und Protokollen. files für jede Instanz.	Stellen Sie eine Verbindung zu mehreren unterschiedlichen Datenquellen derselben Art her.	–
Verbindungsstabilität	Wenn die Verbindung zwischen SimApi und der Datenquelle getrennt wird, versucht sie, die Verbindung automatisch wiederherzustellen.	Die SimApi muss nicht neu gestartet werden, um die Verbindung zur Datenquelle wiederherzustellen.	–
Eigene Entwicklung	Die SimApi wird entwickelt, bereitgestellt und unterstützt von

Nur aktuelle Daten, ohne historische Daten, werden nicht empfohlen

• Einige SimApis, insbesondere OPC DA, unterstützen nur das Lesen aktueller Daten, nicht aber historischer Daten.
• Eine SimApi, die nur aktuelle Daten unterstützt, kann nicht in der Desktop-SIMCA verwendet werden, da sie keine historischen Daten lesen kann, auf deren Grundlage die Modelle erstellt werden könnten.
• Für SIMCA-online empfehlen wir dringend eine Datenquelle und SimApi, die nicht nur aktuelle Daten für die Echtzeitausführung, sondern auch historische Daten bereitstellen, um vergangene Daten vorhersagen und nachholen zu können. SIMCA-online wechselt bei Bedarf automatisch zwischen Echtzeitdaten und historischen Daten und dies kann nicht deaktiviert werden.
• Eine Datenquelle, die nur aktuelle Daten, aber keine historischen Daten bereitstellt, kann für kontinuierliche Projekte in SIMCA-online funktionieren, für Batch-Projekte sind jedoch historische Daten erforderlich.

Vorbereitung einer SimApi-Installation

• Dieser Abschnitt beschreibt wichtige Informationen für eine erfolgreiche Installation einer SimApi.

64-Bit- oder 32-Bit-SimApis

• Es gibt 32-Bit- und 64-Bit-Versionen jeder SimApi.
• SIMCA-online und SIMCA sind 64-Bit-Versionen und erfordern die 64-Bit-Varianten von SimApis. Die älteren 32-Bit-Varianten von SimApis sind für ältere Installationen weiterhin verfügbar.

Speicherort für Protokoll file und Einstellungen

• Eine SimApi speichert ihr Log files im versteckten Programmdatenordner1:
  %programdata%\Umetrics\SimApi, wobei %programdata% dem tatsächlichen Ordner auf Ihrem Computer entspricht. Der Standardwert ist C:\ProgramData.
• Jede SimApi verwendet normalerweise ihr eigenes Protokoll file, das ähnlich wie das SIMCA-Online-Serverprotokoll file enthält je nach Einstellung der Protokollebene mehr oder weniger Daten. Dies file ist hilfreich bei der Fehlerbehebung. Das Protokoll file heißt
  .log wobei ist die SimApi, die Sie installieren, zum Beispielample PIAFSimApi. Siehe auch den nächsten Abschnitt für SIMCA-online SimApi-Instanznamen.
• Dieser Ordner enthält auch die SimApi-Einstellungen in einer XML file namens .xml.
• Die meisten SimApis verfügen über grafische Benutzeroberflächen, die die Einstellungen in der XML-Datei ändern file, aber für einige geben Sie die Änderungen direkt in die XML ein file mit einem Texteditor wie Notepad. Weitere Informationen finden Sie im Benutzerhandbuch für jede SimApi.

File Namen bei Verwendung benannter Instanzen mit SIMCA-online

• In SIMCA-online erhält jede SimApi-Instanz ihre eigene Konfiguration file und log file um mit mehreren Instanzen jeder SimApi zu arbeiten. Die Namen dieser files werden mit dem Namen der Instanz angehängt, der auf der Registerkarte „SimApi“ im Dialogfeld „SIMCA-online-Serveroptionen“ angegeben ist.
• Das folgende Beispielample zeigt die Benennung dieser files, wobei muss durch den SimApi-Namen ersetzt werden.
• Beim Hinzufügen der Instanz angegebener Konfigurationsname: OmegaServer
• Konfiguration file Name: OmegaServer.xml
• Protokoll file Name: OmegaServer.log
• Beachten Sie, dass die generische file .Protokoll file wird noch erstellt. Dieses Protokoll file enthält Einträge, die aus technischen Gründen nicht ins Logbuch eingeordnet werden können file der Instanzen..
• Dieser Ordner ist in Windows standardmäßig ausgeblendet. Um ihn anzuzeigen in File Explorer konfigurieren Sie es zeigen versteckte files. Beachten Sie, dass Sie zu einem versteckten Ordner navigieren können, indem Sie eine Adresse eingeben File Adressleiste des Explorers.
• Beachten Sie, dass SIMCA keine mehreren Instanzen der SimApi unterstützt und daher die Namen ohne Instanznamen verwendet, wie oben beschrieben.

Netzwerkplanung

• Sie sollten den SIMCA-online-Server möglichst nahe an der Datenquelle im Netzwerk platzieren. Dadurch wird eine schnelle Verbindung zwischen SIMCA-online und seiner Datenquelle gewährleistet.
• Netzwerkgeräte können die Verbindung zwischen SIMCA-online und der Datenquelle stören.

Benutzerkonten und Datenquellenberechtigungen

• Datenquellen kontrollieren typischerweise den Zugriff auf ihre Daten. Dies geschieht üblicherweise über Benutzernamen und Passwörter, es können aber auch IP-Adress- oder DNS-basierte Einschränkungen verwendet werden (z. B.ampdie PI Trusts im Aveva PI System).
• Benutzername und Passwort können der Datenquelle auf unterschiedliche Weise übermittelt werden:
• Eine SimApi wird als Windows-Benutzer des Benutzers ausgeführt, der die Desktop-SIMCA oder das SIMCA-Online-Dienstkonto auf dem Server-Computer ausführt. Die SimApi kann sich über dieses Konto mit der Datenquelle verbinden. So funktionieren die OPC I- und die PI-SimApi sowie ODBC, wenn Sie bei der Konfiguration keine Anmeldeinformationen angeben.
• Für generisches ODBC können Sie die Anwendung „ODBC Data Sources Administrator“ verwenden, die Sie unter „Start“ in Windows finden.
• Einige Datenbankanbieter stellen eigene Treiber und Tools für ihre Datenbanken zur Verfügung. Oracle-Datenbanken zum BeispielampVerwenden Sie hierzu die Oracle Data Access Components (ODAC).
• Einige SimApis, wie z. B. PI AF und ODBC, verfügen über Konfigurationsdialoge, die die verschlüsselten Anmeldeinformationen in der SimApi-XML-Konfiguration speichern file.
• PI bietet außerdem verschiedene Sicherheitsoptionen in den PI System Management Tools auf dem PI-Servercomputer. Weitere Informationen finden Sie im PI AF SimApi-Benutzerhandbuch. Dieses Handbuch ist auch hilfreich, wenn Sie die ältere OSIsoft PI SimApi verwenden.
• OPC DA und HDA verwenden DCOM als Transportmittel zwischen einer Datenquelle und SimApi. DCOM wird mit dem Component Services Tool (DCOMCNFG.EXE) in Windows konfiguriert und verwendet die Windows-Authentifizierung.
• Für die ältere OSIsoft PI SimApi (nicht die neuere AF SimApi) wird die OSIsoft AboutPI-SDK-Anwendung (PISDKUtility.exe) verwendet, um die Verbindung zum PI-Server einzurichten.

Überprüfen der Datenquellenkonnektivität
Wenn Sie eine SimApi auf einem Computer installieren möchten, kann es hilfreich sein, die Konnektivität von diesem Computer zur Datenquelle mit einem anderen Tool zu überprüfen:

• ODBC-Datenquellen in Windows dienen zum Konfigurieren und Testen von generischem ODBC. Beachten Sie, dass es für 64-Bit-Windows zwei Versionen dieses Tools gibt: eine für 32-Bit-Anwendungen und eine für 64-Bit-Anwendungen. Verwenden Sie die Schaltfläche „Datenquelle testen“ am Ende des ODBC-Konfigurationsassistenten, um die Verbindung zur Datenbank zu überprüfen. Wir empfehlen, Ihre Datenquellen als System-DSNs zu konfigurieren.
• Ein datenbankspezifisches Verbindungstool vom Anbieter der Datenbank, beispielsweise die Oracle Data Access Components.
• Mit dem PI System Explorer können Sie die Konnektivität zum PI AF-Server testen. Er ist Teil des PI AF-Clients, der Voraussetzung für die PI AF SimApi ist.
• OPC UA Expert von Unified Automation – UaExpert ist ein plattformübergreifender Testclient für OPC UA-Server.
• Die PI-SDK-Anwendung (PISDKUtility.exe) kann zum Testen der Konnektivität und zum view alle Fehlermeldungen, die möglicherweise protokolliert wurden, als SIMCA-online versuchte, eine Verbindung zum PI-Server herzustellen. Dies wird nur für die ältere OSIsoft SimApi verwendet, nicht für PIAF.
• PI System Management Tools werden auf dem PI-Server-Computer zur Fehlerbehebung von dieser Seite aus verwendet. Zum Beispielample, um nach Sicherheitsproblemen zu suchen, die den Zugriff vom SIMCA-Online-Server verhindern. Weitere Informationen zur Fehlerbehebung beim PI-System finden Sie in diesem YouTube-Video.
• Mit Excel können Daten über eine ODBC-Verbindung und die meisten anderen Systeme abgerufen werden, wenn ein entsprechendes Plug-In installiert ist.
• Mit Matrikon OPC Explorer für Ior HDA (dies sind separate Tools) können Sie die OPC-Konnektivität testen, und mit Matrikon OPC Analyzer können Sie Probleme mit der OPC-Konnektivität diagnostizieren. Laden Sie diese kostenlosen Tools herunter von https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (für DInd HDA) vom OPC Training Institute web Die Website „ermöglicht es Benutzern, Kommunikations- und Sicherheitsprobleme einfach zu diagnostizieren und sofort per Knopfdruck zu beheben. Und das alles, ohne dass sie sich mit der Konfiguration von DCOM auskennen müssen.“

Installieren einer SimApi

So installieren Sie eine SimApi auf einem PC:

1. Lesen Sie das Benutzerhandbuch für die SimApi, die Sie installieren. Es enthält spezifische Informationen zu dieser SimApi, die die allgemeinen Anweisungen ergänzen, die Sie gerade lesen.
2. Installieren und konfigurieren Sie alle im SimApi-Benutzerhandbuch genannten Voraussetzungen (z. B.ample Datenbanktreiber oder SDKs)
3. Führen Sie das Setup-Programm aus, um die SimApi zu installieren. Installieren Sie die 64-Bit-Version (x64) oder die 32-Bit-Version (x86), die zu der Software passt, in der Sie sie ausführen möchten.
4. Konfigurieren Sie die SimApi in SIMCA-online oder SIMCA wie in den folgenden Abschnitten beschrieben und lesen Sie die Beschreibung der verfügbaren Einstellungen im Benutzerhandbuch der SimApi.
5. Starten Sie den SIMCA-Online-Server. Beachten Sie, dass dies einige Zeit dauern kann, da die SimApi bei der Initialisierung alle tags in der Datenquelle.
6. Testen Sie die SimApi, indem Sie Daten erfassen. Für SIMCA-online können Sie File > Extrahieren wie in 6.1 beschrieben.
7. Wenn die SimApi nicht wie erwartet funktioniert, lesen Sie das SimApi-Protokoll. files zur Fehlerbehebung und zum SimApi-Benutzerhandbuch.

Einrichten der SimApi für die Verwendung in SIMCA

So verwenden Sie die SimApi in SIMCA:

1.  Starten Sie den Datenbankimport auf eine der folgenden Arten:
   • a. So erstellen Sie ein neues Projekt in SIMCA: File > Neues reguläres Projekt oder Neues Batch-Projekt. Wählen Sie auf der Registerkarte „Start“ die Option „Aus Datenbank“.
   • b. So importieren Sie einen Datensatz in ein vorhandenes Projekt in SIMCA: Aus dem Datensatz auf der Registerkarte „Daten“ eines geöffneten SIMCA-Projekts.
2. Klicken Sie auf Neue Datenquelle hinzufügen
3. Wählen Sie SimApi als Verbindungstyp, klicken Sie auf die Schaltfläche … und suchen Sie die .dll im Installationsordner und klicken Sie auf „Öffnen“.
4. Klicken Sie auf „Konfigurieren“ und lesen Sie im jeweiligen SimApi-Benutzerhandbuch nach, wie Sie die Einstellungen vornehmen.
5. Klicken Sie auf Datenquellenverbindung testen, um zu überprüfen, ob eine Verbindung zur Datenbank hergestellt werden kann. Dies kann lange dauern, wenn viele tags in der Datenquelle.
6. Klicken Sie auf „OK“, um die Konfiguration abzuschließen.
7. Informationen zum Arbeiten mit importierten Daten finden Sie in der SIMCA-Hilfe.

Einrichten der SimApi für die Verwendung in SIMCA-online

• Wichtig: Um eine SimApi nutzen zu können, ist eine SIMCA-online Serverlizenz erforderlich. Eine Demoinstallation von SIMCA-online erlaubt keine Nutzung von SimApis.
• Um eine SimApi zum System hinzuzufügen, führen Sie die SIMCA-Online-Serveroptionen auf dem Server-PC aus. Die detaillierten Schritte finden Sie im SICMA-Online-Hilfethema „Eine SimApi auf dem Server hinzufügen und konfigurieren“.
• Tipp: Wenn Sie Änderungen an einer SimApi vornehmen, können Sie diese SimApi separat über die Serveroptionen neu starten, ohne den gesamten Server neu starten zu müssen.
• Um mehrere Instanzen dieser SimApi zu konfigurieren, wiederholen Sie die obigen Schritte und verwenden Sie für jede Instanz eindeutige Namen. Lesen Sie mehr über die verschiedenen Protokoll- und Konfigurationsoptionen. files für die Instanzen in 4.2.

Testen und Fehlerbeheben einer SimApi

• In diesem Kapitel geht es um das Testen und die Fehlerbehebung einer SimApi-Installation.

Testen einer SimApi von SIMCA-online

• Sobald der SIMCA-online-Server erfolgreich gestartet wurde, können Sie Ihre SimApi in SIMCA-online testen (falls der Server nicht startet, siehe 6.2):
• Melden Sie sich im SIMCA-Online-Client am Server an und navigieren Sie zu Extrahieren auf der File Mit Extract können Sie die SimApi testen, indem Sie Daten darüber abrufen:
• Im linken Feld werden die Knoten („Ordner“) der SimApi angezeigt. Tags für den ausgewählten Knoten werden oben rechts angezeigt.
• Aktuelle Daten können schnell und einfach per Klick geprüft werden view> am tags die kontinuierlich Prozessdaten liefern (siehe Screenshot)
• Klicken Sie mit der rechten Maustaste auf einen Knoten, um Batches innerhalb eines bestimmten Zeitraums zu suchen. Der Knoten muss ein Batchknoten sein, der Batches kennt.
• Wählen tags in „Extrahieren“, klicken Sie auf „Weiter“ und beenden Sie den Assistenten, um Daten mithilfe der verschiedenen Datenabrufmodi abzurufen: aktuelle, historische, Batch- und diskrete Daten.
• Vergleichen Sie die extrahierten Daten mit dem, was Sie in Ihrer Datenquelle sehen, indem Sie die Tools verwenden. Erfahren Sie mehr über das Testen und Validieren aller Funktionen einer SimApi in 7.13.

Beheben Sie SimApi-Probleme mithilfe des SimApi-Protokolls file

• Wenn der Server nicht startet, die SimApi nicht wie erwartet funktioniert oder das Extrahieren fehlschlägt, müssen Sie das SimApi-Protokoll konsultieren. file Hier erfahren Sie, wo das Problem liegt. Aktivieren Sie die Protokollierung auf Debug-Ebene im SimApi-Protokoll, um alle Einzelheiten zu erhalten. Siehe 4.2.
• Hinweis: Die SIMCA-Online-Serverprotokolle sind hier nicht so nützlich. Sie zeigen, wie die SimApi vom Server geladen und initialisiert wurde, aber die SimApi-spezifischen Details finden Sie in ihrem Protokoll. file.

Nutzen Sie das richtige SIMCA-Online-Servicekonto

• Wenn Sie den Zugriff auf die Datenquelle testen, denken Sie daran, dass Sie auf dem Server-Computer als bestimmter Benutzer angemeldet sind (normalerweise Ihr eigenes Benutzerkonto in einer Windows-Domäne), dass das Dienstkonto des SIMCA-Online-Servers jedoch ein anderes Konto ist, standardmäßig „LocalSystem“, das über andere Zugriffsrechte als Ihr Benutzerkonto verfügt.
• Aus diesem Grund kommt es nicht selten vor, dass Tests funktionieren, wenn sie mit Ihrem Konto ausgeführt werden, SIMCA-online jedoch keine Verbindung zur Datenquelle herstellen kann.
• Um dieses Problem zu beheben, muss dem vom SIMCA-Online-Serverdienst verwendeten Konto Zugriff gewährt werden. Normalerweise ändern Sie „LocalSystem“ in ein bestimmtes Domänendienstkonto und gewähren diesem Konto Berechtigungen. Dies gilt nicht, wenn die SimAPI Anmeldeinformationen verwendet, die in der SimAPI-Konfiguration festgelegt wurden, da diese Vorrang haben.

Technische Details zu SimApis

• Dieses Kapitel erläutert die Funktionsweise einer SimAPI im technischen Detail. Es richtet sich insbesondere an Entwickler, die SimAPIs verstehen möchten, um eine SimAPI für eine Datenquelle zu implementieren.
• Entwickler sollten auch die früheren Teile dieses Dokuments lesen, um eine Einführung in SimApis und die allgemeinen Beschreibungen der Funktionen zu erhalten.

Wann sollte man die Entwicklung einer SimApi in Betracht ziehen und wann nicht?

Bevor Sie die Entwicklung einer SimApi für eine Datenquelle in Betracht ziehen:

1. Prüfen Sie, ob bereits eine SimAPI vorhanden ist, die Sie nutzen können. Möglicherweise können Sie in Ihrer Datenquelle eine Funktion aktivieren, um eine der vorhandenen SimAPIs zu verwenden, z. B. OPC UA.
2. Gehen Sie dieses Dokument und seine Referenzen sorgfältig durch und prüfen Sie, ob Ihre Datenquelle die Anforderungen erfüllt: zum BeispielampDas heißt, es muss schnell genug sein und nicht nur aktuelle Daten, sondern auch historische Daten bereitstellen.

• Aus diesen Gründen empfehlen wir nicht, eine SimApi zu entwickeln, die mit Low-Level-Hardware oder -Instrumenten verbunden ist. Es ist besser, diese Instrumente mit einem Prozesshistoriker wie dem Aveva PI System zu verbinden und Daten vom Instrument abzurufen und zu historisieren. Anschließend kann die PIAF SimApi verwendet werden, um Daten von PI an das Umetrics-Produkt zu übertragen.

SimApi-Entwicklung und die SimApi-Spezifikation

• Die SimApi-Spezifikation, SimApi-v2, enthält Dokumentation für alle C-Funktionen in der SimApi, die eine SimApi-DLL implementieren muss, sowie einige Anleitungen zur Entwicklung einer SimApi.
• Die Implementierung einer SimApi mit C oder C++ erfolgt in den meisten Fällen auf einem unnötig niedrigen Niveau.
• Der empfohlene und einfachere Weg, eine SimApi zu implementieren, besteht darin, sie auf dem Ex zu basierenampleSimApi-Quellcode, den wir zur Verfügung stellen. Es ist ein BeispielampDie SimApi-Implementierung verwaltet die C-Schnittstelle und übersetzt sie in das .NET Framework, wo die eigentliche Implementierung erfolgt. Sie enthält außerdem Framework-Code für Protokollierung, Einstellungen, Konfigurations-GUI und weiteren Framework-Code.
• Für die Entwicklung einer SimApi benötigt das Entwicklerteam Erfahrung in der Windows-Entwicklung, im .NET Framework, in C oder C++. Gute Kenntnisse der Datenquelle, mit der die SimApi verbunden werden soll, sind ebenfalls erforderlich, da der Zweck einer SimApi darin besteht, Datenanfragen von SIMCA-online oder SIMCA in die API der Datenquelle zu übersetzen. Eine SimApi-Implementierung ist nie ein einmaliges Projekt, sondern erfordert in der Regel kontinuierliche Unterstützung und gelegentliche Wartung.

Lesen oder Schreiben von Daten

• Die Hauptaufgabe einer SimApi besteht darin, Daten aus einer Datenquelle bereitzustellen. Dies wird als Lesen von Daten bezeichnet.
• Die meisten SimApi-Implementierungen unterstützen auch das Schreiben von Daten. Das bedeutet, dass Daten über die SimApi an die Datenquelle zurückgeschrieben werden. Das Schreiben von Daten ist eine optionale Funktion in SIMCA-online.

Tags und Knoten

• A tag ist ein Bezeichner einer Spalte oder „Variable“ in einer Datenquelle. tagDer Name dient zur Identifizierung des tag. Namen innerhalb von Knoten müssen eindeutig sein. SIMCA-online 18 ist die erste Version, die einen Knoten unterstützt, der einen Unterknoten enthält und tag mit dem gleichen Namen. Zum Beispielample: Der Knoten Parent könnte einen Unterknoten namens Batch haben und einen tag Batch genannt.
• Ein Knoten ist ein Container von tagsEin Knoten kann auch andere Knoten enthalten, ähnlich wie ein file Das System hat Ordner in Ordnern.
• Wie in einem file System, der Knoten und tag Namen können zu einem vollständigen Pfad kombiniert werden, der einen tag. Der tag Pfade werden in SIMCA-online oder SIMCA bei der Auswahl verwendet tags zu verwenden. Ein tag Der Pfad beginnt mit dem Namen einer SimApi-Instanz, gefolgt von der Knotenstruktur und endet mit dem tag Name, jedes Element wird durch einen Doppelpunkt (:) getrennt. Beispiel:ample „:ODBCSQLServer:Node:SensorTag1“.

Die SimApi zählt tags und Knoten beim Start

• Eine SimApi-Implementierung durchsucht den Server nach Knoten und tags in der Datenquelle, wenn die SimApi initialisiert wird, und verfolgt sie, so dass die verschiedenen SimApi-Funktionen, die zum Aufzählen verwendet werden tags und Knoten implementiert werden können.
• Die SimApi-Initialisierung erfolgt nicht nur beim Start des Servers, sondern kann auch von einem Benutzer in SIMCA-online mit der Funktion „SimApi aktualisieren“ erneut ausgelöst werden.

Groß- und Kleinschreibung tag- und Knotennamen

• Tag Bei Namen und Knotennamen muss die Groß- und Kleinschreibung beachtet werden.
• Somit tag angerufen "tag1“ ist nicht dasselbe wie „Tag1“ wegen der unterschiedlichen Schreibweise des „T“. Wir empfehlen, nicht zu verwenden tags oder Knotennamen, die sich nur in der Groß-/Kleinschreibung unterscheiden.

Kontinuierlicher Prozessknoten 

• Wenn ein Knoten enthält tags Bei kontinuierlichen Prozessdaten kann es als Prozessknoten bezeichnet werden. Die folgenden beiden Screenshots zeigen eine tabellarische Darstellung eines Prozessknotens mit Daten, gefolgt von einem Bild, das zeigt, wie der Knoten aussieht, wenn Sie tags in SIMCA-online.

Kontinuierliche Prozessknoten müssen unabhängig von Chargen, Läufen oder Zeit sein

• Um in einer SimApi einwandfrei zu funktionieren, muss ein Knoten unabhängig von Batches, Läufen oder Zeit sein. Ein Knoten, der Daten für einen bestimmten Batch oder Zeitraum enthält, würde in SIMCA-online nicht gut funktionieren, da die Projektkonfiguration dann nur Daten für diesen Batch lesen und nicht für andere Batches verwenden könnte.
• Stattdessen sollte ein Knoten einer oder mehreren physischen Einheiten im Prozess zugeordnet werden, in dem Messungen durchgeführt werden.

Batch-ID tag erforderlich in kontinuierlichen Prozessknoten für die Batch-Projektausführung

• Jeder kontinuierliche Prozess muss eine tag (Variable) enthält die Batch-ID für jede Beobachtung. Diese Batch-ID wird von SIMCA oder SIMCA-online verwendet, um zu erkennen, zu welchem ​​Batch jede Beobachtung gehört.
• Die $BatchID tag in den Screenshots in 7.4.3 ist so ein Beispielample.
  Obwohl es nicht erforderlich ist, wird empfohlen, tag im Prozessknoten, der die aktuelle Phase oder den aktuellen Schritt des Prozesses zeigt. Dieser tag können dann in den Phasenausführungsbedingungen in SIMCA-online oder in SIMCA beim Datenimport verwendet werden. Werte für diese tag kann zum Beispiel seinample „Phase1“, „Reinigung“, „Phase2“.

Batch-Kontextknoten

• Ein Batch-Knoten ist ein Knoten, der Batches, ihre Batch-IDs, Start- und Endzeiten verfolgt. Er ist eine Voraussetzung für die Ausführung von Batch-Projekten in SIMCA-online. Eine Datenquelle kann mehr als einen Batch-Knoten haben, der Batches auf unterschiedliche Weise verfügbar macht. Der Benutzer wählt den Batch-Knoten aus, der für seine Anwendung gilt. Dieserample stellt Batches bereit, die sich über zwei verschiedene Einheiten erstrecken:
• /Factory1 – Batches mit aggregierter Lebensdauer über Unit1 und Unit2.
• /Factory1/Unit1 – Batches mit Lebensdauer nur in Unit1
• /Factory1/Unit2 – Batches mit Lebensdauer nur in Unit2
• Wenn Ihre Datenquelle keinen Batch-Knoten enthält, können Sie den Batch Context Generator in SIMCA-online verwenden. Weitere Informationen finden Sie in der integrierten Hilfe.
• Optionale Batchdaten
• Ein Batch-Knoten kann auch Batch-Daten enthalten; Daten, für die es nur eine Beobachtung für den gesamten Batch gibt. Beachten Sie, dass tags mit Batch-Daten muss nicht in einem Knoten sein, der die volle Funktionalität eines Batch-Knotens hat. Es reicht aus, dass die SimApi das Lesen von Batch-Daten für die tags. Erfahren Sie mehr über Batchdaten in 7.6.
• Hier ist ein ExampDatei eines Batch-Knotens:
• Hinweis: Der obige Screenshot stammt aus DBMaker, das mit SIMCA-online gebündelt ist. Um ihn selbst in DBMaker zu sehen, klicken Sie auf View Klicken Sie auf die Schaltfläche „Daten“ in der Bäckerhefe-Datenbank, um zwei Fenster anzuzeigen, eines davon ist der Batch-Knoten und das andere die Prozessdaten.

Datentypen: numerische Daten, Textdaten und fehlende Daten

• Für jeden tag, eine SimApi kann drei Datentypen unterstützen: numerisch, tex, t und fehlend:
• Numerische Daten sind typischerweise reale Werte von Prozessparametern, zum Beispielample 6.5123. Die SimApi kann nur 32-Bit-Gleitkommawerte mit einfacher Genauigkeit verarbeiten. Gleitkommaformat mit einfacher Genauigkeit – Wikipedia. Alle anderen numerischen Datentypen in einer Datenquelle sollten in Gleitkommazahlen konvertiert werden. Daher können sie sowohl große als auch kleine Werte verarbeiten, jedoch nur mit etwa 6 oder 7 signifikanten Ziffern. Weitere Informationen finden Sie im Technischen Handbuch.
• Dies kann zu Genauigkeitsverlusten bei großen Ganzzahlen oder bei reellen Zahlen führen, die sowohl groß als auch Dezimalstellen haben. Weitere Informationen finden Sie im Technischen Handbuch.
• Text-/String-Daten werden für Batch-IDs, Phasenausführungsbedingungen oder qualitative Variablen verwendet. Die Werte für Text tag Daten sind case-sensitiv. Das bedeutet, dass der Wert „running“ nicht dasselbe ist wie
  „LÄUFT“. Datums-/Uhrzeitvariablen werden von der SimApi nicht direkt unterstützt, können aber als Zeichenfolge im Format JJ-MM-TT HH:MM zurückgegeben werden (z. B.ample “2020-09-07 13:45”).
• Fehlende Werte bedeuten, dass kein Wert zurückgegeben werden kann, also keine Daten.
• Welcher Typ zurückgegeben wird, hängt von der SimApi-Implementierung ab. Eine SimApi kennt die Daten in der Datenquelle und sollte den am besten passenden Datentyp zurückgeben.

Drei Modi des Datenabrufs: Kontinuierlich, Batch, h und Diskreter

• Die SimApi-Spezifikation definiert drei Modi zum Abrufen von Daten, d. h. drei verschiedene Möglichkeiten, wie die SimApi Daten bereitstellen kann von tags in eine Datenquelle (oder in die andere Richtung: Daten schreiben in tags in einer Datenquelle).
• Kontinuierliche Datenabfrage – hiermit werden Daten kontinuierlich und sequenziell gelesen, Beobachtung für Beobachtung, während sich der Batch oder Prozess entwickelt. Die Daten werden für den aktuellen Zeitpunkt oder für einen bestimmten Zeitraum in regelmäßigen Abständen zwischen den Beobachtungen gelesen. Zum Beispiel:ample, alle Daten zwischen 09:00:00 und 10:00:00 sampalle 60 Sekunden durchgeführt, was zu 61 Beobachtungen führt, wenn die Endpunkte inklusive sind.
• Batch-Datenabruf – hiermit ist eine einzelne Beobachtung mit Daten für einen gesamten Batch gemeint (unabhängig von einer bestimmten Reife oder einem bestimmten Zeitpunkt). Batch-Attribute und lokale Zentrierungsdaten werden in SIMCA-online als Batch-Daten gelesen. Batch-Bedingungen werden in der Regel ebenfalls als Batch-Daten gelesen (sofern sie nicht für den diskreten Datenabruf konfiguriert sind).
• Diskrete Datenabfrage – Diskrete Daten können aus mehreren Beobachtungen für verschiedene Laufzeiten bestehen. Im Gegensatz zu kontinuierlichen Daten werden diskrete Daten jedoch nicht sequenziell gelesen, sondern alle Daten für eine bestimmte Phase eines Batches auf einmal. Die Daten müssen nicht in regelmäßigen Abständen der Laufzeitvariable abgerufen werden. Alle Daten werden bei jeder Datenabfrage im konfigurierten Intervall erneut gelesen.
• Für jede gegebene tag Daten können in jedem der drei Modi angefordert werden, aber normalerweise unterstützt eine SimApi nur einen dieser Modi für eine einzelne tagEbenso ist es erlaubt, zu mischen tags innerhalb eines Knotens, aber normalerweise alle tags innerhalb eines bestimmten Knotens unterstützen denselben Modus des Datenabrufs.
• Für kontinuierliche Daten (aber nicht für Batch- oder diskrete Daten2) können Anfragen nach aktuellen Daten oder historischen Daten gestellt werden, was das Thema des nächsten Abschnitts ist.
• Nicht alle SimApis unterstützen alle Modi. Siehe die Feature-Matrix oben und die SimApi web Weitere Einzelheiten finden Sie auf der Seite.

Aktuelle und historische kontinuierliche Daten über eine SimApi

• Kontinuierliche Daten beziehen sich auf Prozessdaten, die sich im Laufe der Zeit ändern.

Aktuelle Daten

• Beim Lesen aktueller Daten fragt man die Datenquelle nach den neuesten Werten von tags zum Zeitpunkt der Abfrage. Beachten Sie, dass die Zeit der externen Datenquelle hier nicht verwendet wird.
• Die als aktuelle Daten gelesenen Daten werden von SIMCA-online als Live-Daten angezeigt. Aus diesem Grund ist es wichtig, dass es in der Datenquelle keine unnötigen Verzögerungen gibt. Aktuelle Daten sollten so aktuell wie möglich sein, damit sie in SIMCA-online gut funktionieren.
• Die Datenquelle kann ihr Wissen über die Daten und die Gültigkeitsdauer von Werten nutzen und entscheiden, fehlende Daten zurückzugeben, wenn die Rohdaten für einen Zeitpunkt zu alt sind. Zum Beispielample: Daten werden um 15:00:00 angefordert, aber der aktuellste Datenpunkt in der Datenquelle ist von 03:00:00. In diesem Fall sind die Daten 12 Stunden alt, sodass die SimApi möglicherweise beschließt, fehlende Werte (keine Daten) zurückzugeben.

Historische Daten

• Beim Lesen historischer Daten werden von der Datenquelle Werte eines oder mehrerer tags für einen bestimmten Zeitraum mit einem bestimmten Intervall zwischen den Beobachtungen. Beachten Sie, dass hier die lokale Zeit der Datenquelle zum Suchen der Daten verwendet wird. Daher ist die Zeitsynchronisierung zwischen Datenquelle und Servern wichtig.
• Historische Daten bestehen aus einer Datenmatrix. Es liegt an der SimApi-Implementierung, die Daten von der Datenquelle anzufordern, undampLassen Sie es im angegebenen Intervall laufen und konstruieren Sie die Matrix der zurückzugebenden Daten:
• Manchmal verfügt die Datenquelle selbst über Aggregatfunktionen, um verarbeitete Daten zurückzugeben, oderampling-Funktionen, mit denen die richtigen Daten zurückgegeben werden können.
• Bei anderen Datenquellen muss die SimApi alle Daten im Zeitbereich anfordern und dannampFühren Sie die richtigen Beobachtungen durch, um die Matrix zu konstruieren.
• Daten müssen für einen bestimmten Zeitraum zurückgegeben werden, auch wenn im Zeitraum möglicherweise keine Rohdaten vorliegen, sondern nur kurz vor der Startzeit. Zum Beispielample: Daten sind in der Datenquelle zu den Zeitpunkten 10 und 20 vorhanden. Die SimApi fordert Daten für die Zeitpunkte 15 und 17 an. In diesem Fall sollten die Werte für den Zeitpunkt 10 von der SimApi zurückgegeben werden, aber die Zeitampals Zeitpunkt 15 und 17, da dies die aktuellsten Datenpunkte zu diesen Zeitpunkten waren. Die Werte für tags zum Zeitpunkt 10 werden als Grenzwerte für den angeforderten Bereich bezeichnet. Eine ausführlichere Erläuterung der Grenzwerte finden Sie beispielsweise unterampLesen Sie die Dokumentation für returnBounds unter UA Teil 11: Historischer Zugriff – 6.4.3 ReadRawModifiedDetails-Struktur
  (opcfoundation.org)
• Interpolation sollte niemals zur Berechnung von Werten für zukünftige Zeitpunkte verwendet werden, da die Daten nicht mit den in Echtzeit gelesenen aktuellen Daten übereinstimmen. Zum BeispielampHinweis zum vorherigen Punkt: Wenn die Daten für 15 und 17 unter Verwendung der Werte für die Punkte 10 und 20 interpoliert würden, würden effektiv Werte aus der Zukunft verwendet, was nicht zulässig ist.
• Die Datenquelle kann ihr Wissen über die Daten und die Gültigkeitsdauer von Werten nutzen und entscheiden, fehlende Daten zurückzugeben, wenn die Rohdaten für einen Zeitpunkt zu alt sind. Zum Beispielample: Es werden Daten für 15:00:00 Uhr angefordert, der aktuellste Datenpunkt in der Datenquelle stammt jedoch von 03:00:00 Uhr. In diesem Fall sind die Daten 12 Stunden alt, sodass die SimAPI möglicherweise einen fehlenden Wert (keine Daten) zurückgibt.

Notiz: SIMCA-online fordert im normalen Projektablauf typischerweise nicht mehr als hundert Beobachtungen pro Aufruf an. Beim Extrahieren in SIMCA-online oder beim Ausführen von SIMCA auf dem Desktop können größere Datenanfragen gestellt werden. Diese können erwartungsgemäß lange dauern.

Aktuelle Daten und historische Daten müssen übereinstimmen

• Manchmal kann es zu Abweichungen kommen, wenn Daten als aktuelle Echtzeitdaten oder historische Daten eingelesen werden. Dies führt in SIMCA-online zu Problemen, da der Server bei Bedarf automatisch zwischen aktuellen und historischen Daten umschaltet.

Datenerfassung mit geringer Latenz

• Wenn eine Datenquelle von SIMCA-online in Echtzeit verwendet wird, ist es wichtig, dass die Daten in der Datenquelle aktuell sind. Es dürfen keine unnötigen Verzögerungen bei der Datenerfassung in der Datenquelle auftreten. Kontinuierliche Prozessdaten für alle Variablen müssen für jede Beobachtung gleichzeitig verfügbar sein. Daten, die für einige Variablen verspätet eingehen, werden von SIMCA-online nicht erfasst.

Daten können jederzeit gelesen werden 

• Wenn SIMCA-online nach einem Wert für tag für den Zeitpunkt t erhält er den Wert aus der Datenquelle vom Zeitpunkt t oder die letzte Beobachtung in der Datenquelle vor dem Zeitpunkt t oder einen interpolierten Wert für den Zeitpunkt t. Somit erhält der Server immer zu jedem angeforderten Zeitpunkt einen Wert, auch wenn in der Datenquelle möglicherweise keine Beobachtung für diesen genauen Zeitpunkt vorhanden ist.
• Zeitamps in der SimApi sind immer UTC. SIMCA-Online-Clients und SIMCA zeigen die Zeit als Ortszeit an.

Einfädeln 

• Die SimAPI wird standardmäßig vom Benutzer der SimAPI über einen einzelnen Thread aufgerufen. Dies gilt für alle SIMCA-Versionen und SIMCA-online bis Version 17.
• SIMCA-online 18 unterstützt ein Feature-Flag zum Aktivieren des Multithread-Zugriffs über SimApi. Weitere Informationen finden Sie im Hilfethema „Gleichzeitiger SimApi-Zugriff“.
• Dies bedeutet, dass SimApis sich nach Möglichkeit auf Multithreading vorbereiten sollten, indem die SimApi-Implementierung threadsicher gemacht wird, und dies sowie alle Überlegungen für Benutzer der SimApi dokumentiert werden.

Protokoll file

• Eine SimApi sollte Aktionen, Fehlermeldungen und Warnungen in ihrem Protokoll protokollieren file zur Unterstützung bei der Fehlerbehebung. Verwenden Sie die verschiedenen Protokollebenen, um die Wichtigkeit der Protokollierung zu kennzeichnen.
• Es wird empfohlen, für Funktionen, die nicht in einer SimApi implementiert wurden, „Nicht implementiert“ zu protokollieren.

Fehlerbehandlung

• Wenn eine SimApi eine Anforderung der Datenquelle nicht erfüllen kann, kann sie dieses Problem auf zwei Arten lösen: durch die Rückgabe fehlender Werte (keine Daten) oder durch die Signalisierung eines SimApi-Fehlers:
• Durch die Rückgabe fehlender Werte an den Aufrufer und die Erfolgsmeldung kann dieser wie gewohnt fortfahren (natürlich ohne Daten). Dies ist eine empfohlene Vorgehensweise bei Teilfehlern, z. B. wenn Daten für einige, aber nicht alle, abgerufen werden konnten. tags in einer Anfrage.
• Das Signalisieren eines SimApi-Fehlers ermöglicht dem Anrufer (z.B.ample den SIMCA-Online-Server), um dies sofort zu erkennen und zu handeln. Dies ist eine empfohlene Vorgehensweise für Anfragen, die vollständig fehlschlagen und überhaupt keine Daten zurückgeben können.
• SIMCA-online behandelt fehlende Werte oder Fehlercodes anders, wie im Technischen Handbuch zu SIMCA-online beschrieben.

SimApi-Leistungsanforderungen

• Zum Abrufen der Daten werden die Funktionen in der SimApi verwendet.
• Wenn der Datenzugriff langsam ist, funktioniert die SimApi nicht gut, was dieses BeispielampDie Abbildung zeigt: Wenn SIMCA-online jede Sekunde Daten anfordert, diese aber zwei Sekunden zum Abrufen benötigen, kann der SIMCA-online-Server nie in Echtzeit mithalten und gerät immer weiter in Rückstand.
• In den Unterabschnitten zeigen wir, wie SIMCA und SIMCA-online die SimApi-Funktionen für den Datenzugriff verwenden und wie häufig die SimApi-Funktionen aufgerufen werden. Dies kann beim Festlegen der Leistungsanforderungen für eine SimApi-Implementierung hilfreich sein.

SIMCAs Nutzung von SimApi-Funktionen

• Wenn Desktop-SIMCA oder andere Offlineprodukte eine SimApi zum Abrufen von Daten verwenden, beziehen sich diese Anforderungen auf Stapel und verarbeiten Daten für eine Reihe von Variablen in einem bestimmten Zeitbereich.
• Da diese Anforderungen manuell von einem Benutzer initiiert werden, treten sie nicht sehr häufig auf und verursachen keine erhebliche Belastung einer Datenquelle.
• Um die Daten abzurufen, werden folgende SimApi-Funktionen genutzt:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Nutzung der SimApi-Funktionen durch SIMCA-online

• SIMCA-online wird zur Echtzeitüberwachung eines Prozesses verwendet und fordert daher in regelmäßigen Abständen Daten über die SimApi an. Das kürzeste Ausführungsintervall, das verwendet werden kann, beträgt 1 Sekunde. Einige Beispiele aus der PraxisampDie Ausführungsintervalle betragen 10 s, 1 Minute oder 10 Minuten.
• Auf einem Server können mehrere Projekte gleichzeitig ausgeführt werden.
• Um die Anzahl der API-Aufrufe über die SimApi zu reduzieren, optimiert der Server Datenanforderungen, indem er viele gleichzeitige kleinere Anforderungen zu einer einzigen größeren Anforderung für alle Variablen gleichzeitig zusammenfasst (weitere Informationen finden Sie im Hilfethema „Optimiertes Lesen aus Datenquellen verbessert die Leistung“).
• Der Ausführungsalgorithmus des Servers funktioniert folgendermaßen, wenn er Daten mithilfe der unten aufgeführten SimApi-Funktionen anfordert:
• Alle Phasen, die im gleichen Intervall ausgeführt werden, werden in einem einzigen SimApi-Aufruf zusammengefasst, um die Anzahl der Aufrufe zu reduzieren. Der Server liest die neuesten Daten für alle Variablen, die von allen Modellen im gleichen Intervall verwendet werden. Dieser Aufruf führt somit zu einer breiten Datenzeile, die dann von allen Projekten verwendet wird.
  • simapi2_connectionReadCurrentData
• Für jedes Batchprojekt muss der Server außerdem wissen, welche Batches aktiv sind. Dies muss auch bei jeder Projektausführung geschehen:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes wird seltener aufgerufen.
• Darüber hinaus benötigt SIMCA-online auch historische Daten. Diese Abfragen erfolgen nur bei Bedarf, z. B. um den Beginn eines Batches nachzuholen, der vor dem Start von SIMCA-online gestartet wurde, oder wenn der Server in Verzug gerät und einen Datenblock lesen muss:
  • simapi2_connectionReadHistoricalDataEx
• Optional verwenden einige Projektkonfigurationen Funktionen, die Batchdaten oder diskrete Daten verwenden, was zu SimApi-Aufrufen führt, um:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Optional verwenden einige Projektkonfigurationen Writeback, um Daten zurück zur Datenquelle zu übertragen:
  • simapi2_connectionWriteHistoricalDataEx (und entsprechende Funktionen für Batchdaten, diskrete Daten)
• Es ist wichtig, dass jeder Aufruf der Kernfunktionen zum Abrufen von Daten (readCurrentData, getActiveBatches/getBatchTimes) schnell erfolgt und für die Datenquelle selbst keinen hohen Rechenaufwand darstellt, wenn man bedenkt, wie oft SIMCA-online diese Funktionen aufrufen kann.

Testen und Validieren von SimApi-Daten

• In diesem Abschnitt geht es darum, eine SimApi zu testen, um zu überprüfen, ob die von ihr zurückgegebenen Daten mit den Daten in der Datenquelle selbst übereinstimmen. Das Ausführen solcher Tests ist wichtig, nachdem eine SimApi-Implementierung erstellt oder geändert wurde oder wenn sich die API einer Datenquelle ändert.
• In der Praxis erfolgt die Datenvalidierung mithilfe von SIMCA-online und seiner Extract-Funktion, um Daten aus der Datenquelle über die SimApi abzurufen und sie dann mit den Rohdaten in der Datenquelle zu vergleichen. Desktop-SIMCA kann nicht zum Testen der Echtzeitaspekte einer SimApi verwendet werden.

Vorbereitungen und Voraussetzungen

• Einige Elemente sind optional, können aber ausgeführt werden, wenn der Umfang Ihrer Tests dies beinhaltet:

1. Installieren Sie SIMCA-online wie in der ReadMe-Datei und im Installationshandbuch (PDF) beschrieben, die im Produkt-Zip enthalten sind.
2. Erwerben Sie eine Lizenz für den SIMCA-Online-Server und installieren Sie ihn. Die SimAPI funktioniert ohne Lizenz nicht. Der Knowledge Base-Artikel zu SIMCA-Online zeigt, wie Sie das Produkt lizenzieren. Zum Beispiel:amplinks: SIMCA-online 18 (sartorius.com)
3. Installieren und konfigurieren Sie die SimApi, die Sie testen möchten. Lesen Sie die Kapitel 4 – 5 in diesem Dokument und das Benutzerhandbuch der jeweiligen SimApi.
   • a. Optional: Stellen Sie sicher, dass das Benutzerhandbuch aktuell und korrekt ist.
4. Stellen Sie sicher, dass Sie über ein Tool für Ihre Datenquelle verfügen, mit dem Sie die SimApi-Daten vergleichen können.
5. Melden Sie sich im SIMCA-online Desktop-Client bei Ihrem SIMCA-online Server an und verwenden Sie File > Extrahieren, um Daten über die SimApi zu erhalten.
6. Optional, falls Ihr Testumfang dies umfasst: Deinstallieren Sie nach Abschluss des Tests die SimApi und überprüfen Sie deren files werden entfernt.

Was zu testen ist

• Die Feature-Matrix in Kapitel 3 listet alle möglichen Features auf, aber eine bestimmte SimApi-Implementierung unterstützt möglicherweise nur eine Teilmenge davon. Sie sollten alle Features testen, die von der jeweiligen SimApi implementiert werden.
• Die folgenden Tests sind bei den meisten SimApi-Implementierungen üblich:
• Authentifizierung mit Benutzernamen und Passwörtern
• Testen Sie die verschiedenen Einstellungen in der Konfiguration der SimApi
• Knotenhierarchie: Die Knoten und tags Die von der SimApi bereitgestellten Werte sind korrekt.
  • Es muss eine tag für alle „Variablen“, die über die SimApi verfügbar sein sollen. BeispielampDateien: Prozessmessungen, berechnete Werte, Konstanten.
• Verbindungsstabilität: Wenn die Datenquelle nicht verfügbar ist, führt dies zu Warnungen oder Fehlern im Protokoll file, sondern dass die Verbindung zur Datenquelle automatisch wiederhergestellt wird, wenn die Datenquelle verfügbar ist.
• Mehrere Instanzen: Zwei Instanzen können unabhängig voneinander und gleichzeitig konfiguriert und verwendet werden, mit separaten Protokollen files.
• Aktuelle Daten: Aktuelle Daten extrahieren für tags. Stellen Sie sicher, dass die Daten die letzten bekannten Werte aus der Datenquelle sind oder dass sie aufgrund schlechter Qualität oder zu alter Daten fehlen.
  • Extrahieren Sie eine Minute lang etwa alle 10 Sekunden Daten.
• Historische kontinuierliche Daten: Extrahieren Sie historische Daten für tags.
  • Verwenden Sie den Zeitraum, der dem Zeitpunkt der Extraktion der aktuellen Daten entspricht. Stellen Sie sicher, dass die aktuellen Daten mit den historischen Daten und den Rohdaten in der Datenquelle übereinstimmen.
  • Probieren Sie verschiedene Zeiträume und sampÜberprüfen Sie in den Intervallen, ob die Daten mit der Datenquelle übereinstimmen.
  • Versuchen Sie, alle 1 Sekunde Daten zu extrahieren, was die kürzestmögliche Sekunde istampling-Intervall.
  • Probieren Sie verschiedene Arten von tags in der Datenquelle (Prozessvariablen usw.), um sicherzustellen, dass die Daten übereinstimmen.
  • Hinweis: SIMCA-online kann eine einzelne große historische Datenanfrage in mehrere kleinere Abschnitte aufteilen. Dies wird im SimApi-Protokoll angezeigt.
• Überprüfen Sie, ob die SimApi mit Textdaten, numerischen Daten und fehlenden Daten funktioniert.
• SimApi-Protokoll file. Überprüfen Sie, ob das Protokoll sinnvolle Einträge enthält.
• Batch-Knoten: Klicken Sie mit der rechten Maustaste auf einen Knoten und wählen Sie „Batches suchen“.
  • Überprüfen Sie Batchnamen, Startzeiten und Endzeiten für Batches.
  • Versuchen Sie es mit einem aktiven Batch, der in der Datenquelle ausgeführt wird. Es sollte keine Endzeit über die SimApi geben.
• Prozessknoten-Batch-ID tagWenn die SimApi über Batch-Node-Funktionalität verfügt (siehe vorheriger Punkt), muss sie auch eine Batch-Kennung haben tag im entsprechenden Prozessdatenknoten. Daten für diesen tag sollte die Batch-ID (Batch-Name) sein. Diese Angabe wird für Batch-Projekte benötigt, um zu identifizieren, zu welchem ​​Batch eine Datenzeile gehört.

Je nachdem, ob die SimApi dies unterstützt, möchten Sie möglicherweise auch Folgendes testen:

• Batchdaten mit File > Extrahieren.
• Diskrete Daten mit File > Extrahieren. Hinweis: Um diskrete Daten zu testen mit File > Extrahieren Sie den Knoten. Der Batch-Knoten und der diskrete Datenknoten müssen sich in derselben SimApi befinden (wenn SIMCA-online Projekte ausführt, können sie aus verschiedenen SimApis stammen).
• Zurückschreiben – Datenstapel werden in die Datenquelle übertragen. Um dies zu testen, müssen Sie in SIMCA-online eine Projektkonfiguration einrichten, um Datenvektoren in die Datenquelle zurückzuschreiben. Führen Sie anschließend das Projekt in SIMCA-online aus und überprüfen Sie die in die Datenquelle zurückgeschriebenen Daten.
• Kontinuierliche Daten werden auf der Seite „Evolution Write Back“ in der Projektkonfiguration konfiguriert.
• Diskrete Daten werden auf derselben Seite konfiguriert, jedoch nur für eine Phase, die für den Abruf diskreter Daten konfiguriert ist.
• Batchdaten aus dem Batch Writeback

WEITERE INFOS

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Schweden
• Telefon: + 46 90-18 48 00
• www.sartorius.com
• Die in dieser Anleitung enthaltenen Informationen und Abbildungen entsprechen dem unten angegebenen Ausgabestand.
• Sartorius behält sich das Recht vor, ohne Vorankündigung Änderungen an Technik, Ausstattung, Spezifikationen und Design der Geräte vorzunehmen. Um die Lesbarkeit zu erleichtern, werden in dieser Anleitung männliche bzw. weibliche Formen verwendet und bezeichnen stets alle Geschlechter gleichzeitig.
  Copyright-Hinweis:
• Diese Anleitung einschließlich aller Bestandteile ist urheberrechtlich geschützt.
• Jede Verwertung außerhalb der Grenzen des Urheberrechtsgesetzes ist ohne unsere Zustimmung unzulässig.
• Dies gilt insbesondere für Nachdruck, Übersetzung und Bearbeitung unabhängig von der Art der verwendeten Medien.

Häufig gestellte Fragen

• F: Was ist der Zweck von SimApis?
  • A: Der Hauptzweck von SimApis besteht darin, den Produkten der Umetrics Suite Daten zur Projekterstellung und zum Modellaufbau bereitzustellen.
• F: Wie kann ich Probleme mit einer SimApi-Installation beheben?
  • A: Sie können die Fehlerbehebung durchführen, indem Sie SIMCA-online testen und das SimApi-Protokoll überprüfen. fileund Sicherstellung der richtigen Konfiguration des Dienstkontos.

Dokumente / Ressourcen

SARTORIUS Sim Api Software [pdf] Benutzerhandbuch Sim-API-Software, API-Software, Software

Verweise

• Bedienungsanleitung