SARTORIUS PI AF SimApi-Benutzerhandbuch

Stellen Sie vor der Verwendung der PI AF SimApi sicher, dass die durch die PI-zu-PI-Schnittstellenkonfiguration verursachten Echtzeitverzögerungen minimiert werden.

Installation und Setup

Greifen Sie in der SimApi-Schnittstelle auf das Einstellungsmenü zu.
Passen Sie die erforderlichen Parameter basierend auf Ihrer Datenquelle an.

Ereignisrahmen-Filtereinstellungen

Navigieren Sie in der SimApi-Schnittstelle zum Abschnitt „Event Frame Filter“.
Definieren Sie die Kriterien zum Filtern von Ereignisrahmen basierend auf Start- und Stoppzeiten.

Zur SIMCA-online Projektabwicklung und PI AF

Zur Durchführung von Projekten zur SIMCA-Online- und PI AF-Integration.

Stellen Sie eine ordnungsgemäße Synchronisierung zwischen SIMCA-Online und PI AF sicher.
Überprüfen Sie den Datenfluss zwischen den Projekten, um eine genaue Analyse zu gewährleisten.

Unterstützung

Weitere Hilfe oder Unterstützung erhalten Sie im Benutzerhandbuch oder beim Kundensupport von Sartorius Stedim Data Analytics.

Einführung

Dieses Dokument ist das Benutzerhandbuch für die PI AF SimApi von Sartorius Stedim Data Analytics.
Eine SimApi ist die Verbindung zwischen der Umetrics Suite und externen Datenquellen.
Die in diesem Dokument beschriebene PI AF SimApi ist die Verbindung zwischen einem Aveva (ehemals OSIsoft) PI Asset Framework-System und der SIMCA®-Online-Lösung sowie der SIMCA®-Lösung für multivariate Datenanalyse.
Eine detaillierte Liste der Änderungen in verschiedenen Versionen dieser SimApi finden Sie in der Version Info.txt file die mit der Installation geliefert wird. Weitere Informationen zu SimApis finden Sie unter sartorius.com/umetrics-simapi.

Bedingungen

Aveva PI-Name	SIMCA-online Terminologie
Ereignisrahmen (EF)	Ein Batch mit einer Start- und Stoppzeit. Batches befinden sich in einem Batch-Knoten in SIMCA-online. Es kann sich auch um eine Phase mit einer Start- und Stoppzeit handeln.
Ereignisrahmenattribut	A tag die Batch-Daten enthält (eine Beobachtung pro Batch)
Asset Framework-Element	Einheit, ein physisches Objekt wie ein bestimmter Tank oder ein logisches Objekt wie ein Standort oder ein Gebäude.
Ein Elementattribut, ein Attribut eines Elements, kann ein PI-Punkt mit Prozessdaten oder Metadaten sein, die das Element beschreiben.
Asset Framework-Elementvorlage (gibt die Attribute an, die ein aus dieser Vorlage generierter Ereignisrahmen haben kann)	Entspricht grob einer Einheitengruppe
PI-Punkt	Tag

Merkmale

Die SimApi implementiert die folgenden SimApi-Funktionen: Siehe sartorius.com/umetrics-simapi um mehr über die allgemeinen SimApi-Funktionen zu erfahren.
Verbindung zu einem Aveva PI-Server mit Unterstützung für numerische (analoge oder diskrete) Werte und Textwerte
Stellen Sie eine Verbindung zu einem PI AF-Server her, um die Verwendung von Event Frames und der Elementhierarchie zu ermöglichen
Verwenden Sie die bereitgestellten Anmeldeinformationen oder das Konto des aufrufenden Prozesses (z. B. das SIMCA-Online-Dienstkonto).
Aktuelle und historische kontinuierliche Daten für PI-Punkte und Elementattribute
Punkteknoten der obersten Ebene, der alle Prozessdaten-PI-Punkte enthält
Batchdaten, teilweise Unterstützung
Zurückschreiben – kontinuierliche Daten für PI-Punkte (nicht für Elementattribute)
Zurückschreiben – Batchdaten, teilweise Unterstützung
Optionale Knotenhierarchie der PI AF-Elemente, die einem Elementkategorienfilter entsprechen. Wird im Elementknoten der obersten Ebene angezeigt.
Ein Batchknoten im Ereignisrahmenknoten der obersten Ebene, der Ereignisrahmen anzeigt, die sich im Stammverzeichnis von PI AF befinden.
Optionale Ereignisrahmenfilter, die SIMCA-online basierend auf den von Ihnen angegebenen Kriterien eine Teilmenge von Ereignisrahmen (Batches) zur Verfügung stellen.
Sie können nach Element, Ereignisrahmenname, Ereignisrahmenvorlage, Ereignisrahmenkategorie und Ereignisrahmenattributen filtern.
Synthetische Prozess-Batch-Daten tags, wodurch eine einfache Batch-Projektausführung in SIMCA-Online ermöglicht wird.
Mehrere Instanzen der SimApi können auf demselben SIMCA-Online-Server ausgeführt werden
Verbindungsstabilität – Die SimApi stellt die Verbindung zur Datenquelle nach einer Trennung automatisch wieder her. Einige dieser Funktionen werden weiter unten erläutert.
Das folgende Bild dient zur Veranschaulichung der Konzepte, wobei die hervorgehobenen Knoten den fettgedruckten Elementen in der obigen Funktionsliste entsprechen.

PI-Elementhierarchie

Bei Verbindung mit einem AF-Server listet die SimApi alle Elemente auf, die dem Elementkategorienfilter entsprechen, den Sie bei der Konfiguration der SimApi angeben.
Zum Filtern der Elemente können mehrere Elementkategorien verwendet werden. Trennen Sie die Kategorien durch ein Semikolon (;). Es werden nur Elemente angezeigt, die einer bestimmten Kategorie angehören.
Sie können auch * angeben, um alle Elemente anzuzeigen. Dies kann sich jedoch negativ auf die Startleistung auswirken, wenn viele Elemente vorhanden sind. Ein leerer Kategoriefilter bedeutet, dass keine Elemente angezeigt werden.
Die entsprechenden Elemente werden unter dem obersten Knoten „Elemente“ angezeigt. Dabei wird die gleiche Struktur wie im PI System Explorer verwendet.
Beachten Sie, dass zur Offenlegung des Syntheseprozesses tags Für ein Element (siehe unten) muss es dem Elementkategorienfilter entsprechen. Andernfalls wird das Element nur als Container von untergeordneten Elementen ohne Attribute angezeigt.

Elementattribute

Elementattribute werden angezeigt als tags im Elementknoten in SIMCA-online.
Attribute, die in PI ausgeblendet oder ausgeschlossen sind, werden nicht angezeigt.
Hierarchische Attribute werden mit ihrem relativen Pfad benannt, getrennt durch Pipe (|), vom enthaltenden Element aus gesehen. Zum Beispielample, das Attribut „Temperature|Attribute1“ im Screenshot oben.

PI-Punkte

Wenn Sie beim Konfigurieren der SimApi angeben, dass eine Verbindung zu einem PI-Server hergestellt werden soll, werden die PI-Punkte dieses Servers im Knoten der obersten Ebene „Punkte“ angezeigt.
Punkte entsprechen Daten tags in SIMCA-online oder Variablen in SIMCA und werden zum Lesen von Prozessdaten für die Projektausführung verwendet.

Informationen zum Lesen und Schreiben von Batchdaten

Batchdaten sind wie ein Ereignisrahmenattribut, wenn der Ereignisrahmen einen Batch beschreibt. Ereignisrahmenattribute werden derzeit jedoch nicht von der PI AF SimApi unterstützt.
Stattdessen funktioniert die SimApi wie folgt (entsprechend der Implementierung der AF SimApi durch Aveva):
Batchdaten werden als PI-Punkt gelesen, wobei die Startzeit des Batches gemäß dem Ereignisrahmen verwendet wird, um zu wissen, für welchen Zeitpunkt die Daten gelesen werden sollen.
Batchdaten werden in einen vom Benutzer definierten PI-Punkt mit der Zeit st geschriebenamp der Batch-Startzeit, wie sie im Ereignisrahmen angegeben ist.

Ereignisrahmen

PI-Ereignisrahmen entsprechen für die SimApi Stapeln oder Phasen im Prozess.
Wenn ein Ereignisrahmen einen Stapel darstellt, gibt er die Start- und Stoppzeit des Stapels an und wird als Stapelknoten in SIMCA-online verwendet, wodurch die Überwachung von Ereignisrahmen in diesem Knoten in SIMCA-online ermöglicht wird. Sie können auch mit der rechten Maustaste darauf klicken, um darin übereinstimmende Stapel zu finden, wie dieser Screenshot zeigt:
Wenn ein Ereignisrahmen eine Phase darstellt, gibt er die Start- und Stoppzeiten einer Phase an.
Wenn Sie alle Phasen der Charge in SIMCA-online überwachen möchten, können Sie in PI eine Hierarchie konfigurieren, sodass Chargenereignisrahmen die Phasen umfassen, die zur Charge gehören.
Anschließend verwenden Sie den Batch-Ereignisrahmen als Batch-Knoten in SIMCA-Online.
Ereignisrahmen werden von der SimApi in der Elementknotenhierarchie, dem Ereignisrahmen-Knoten der obersten Ebene und allen konfigurierten Ereignisrahmenfilterknoten angezeigt.

Synthetisches Verfahren tags für Ereignisrahmen (Charge/Phase/Schritt) Name und Dauer

Synthetisches Verfahren tags werden von der SimApi erstellt, um die Projektausführung zu vereinfachen.
Diese Funktion funktioniert nicht mit gleichzeitigen (parallelen) Ereignisrahmen. Daher darf zu jedem Zeitpunkt nur ein Ereignisrahmen im Batchknoten aktiv sein.
Synthetik tags werden für den Ereignisrahmenknoten der obersten Ebene, alle Elementknoten, die dem Elementkategorienfilter entsprechen, und alle Ereignisrahmenfilterknoten erstellt (siehe nächsten Abschnitt).

Synthetik tag Name

Zweck

Der Name des aktuellsten aktiven Ereignisrahmens im Knoten zum angegebenen Zeitpunkt.

Die Dauer des letzten aktiven Ereignisrahmens im Knoten zu einem bestimmten Zeitpunkt.

Die Dauer wird jeweils auf Sekunden, Minuten, Stunden und Tage skaliert, sodass Sie diejenige auswählen können, die Ihren Modellierungsanforderungen entspricht.

Notiz: Synthetische Charge tags einen Overhead in der SimApi erzeugen, der zu einer geringeren Leistung führen kann, insbesondere beim Aufholen und Vorhersagen von vergangenen abgeschlossenen Batches in SIMCA-online.

Mit dem synthetischen Verfahren tags zur Batch-Projektausführung in SIMCA-Online

In einem Batch-Projekt müssen die Prozessdaten für jede Phase eine Batch-Kennung haben tag. Daten gelesen in diesem tag wird mit den Batches im angegebenen Batchknoten abgeglichen, um zu wissen, ob eine Phase ausgeführt werden soll.
Wenn die Prozessdaten keine Batch-ID haben tag, der synthetische Prozess tags kann stattdessen verwendet werden, da die Daten hierfür aus dem Wissen über den Ereignisrahmen (Batch) generiert werden.
Um diese Funktion zu nutzen, gehen Sie zur Seite Ausführungsbedingungen der Projektkonfiguration im SIMCA-Online-Client und konfigurieren Sie die Batch-Kennung tag als synthetische Batch-ID tag des Batchknotens.
Immer wenn der Server die Batch-ID für die Prozessdaten liest, wird die Batch-ID vom Batch-Knoten zurückgegeben, um sicherzustellen, dass die Einheit ausgeführt werden kann (die Bedingung für die Phasenausführung muss, wie in SIMCA-online üblich, ebenfalls erfüllt sein).
Hier ist die Batch-Knotenseite der Konfiguration, die zeigt, dass es sich um dieselbe handelt.

Der Filterknoten, der als Batchknoten verwendet wird:

Weitere Informationen zur Ausführungslogik finden Sie im technischen Handbuch von SIMCA-online.

Ereignisrahmenfilter

Ereignisrahmenfilter sind optional und müssen konfiguriert werden, bevor sie von der SimAPI bereitgestellt werden. Sie können beliebig viele Filter hinzufügen; jeder wird einzeln konfiguriert.
Ein Ereignisrahmen-Filterknoten dient als Batch-Knoten in SIMCA-Online zur Steuerung der Projektausführung. Der Filterknoten stellt Ereignisrahmen (Batches) bereit, die bestimmte Filterkriterien erfüllen.
Filterknoten füllen auch Werte für die synthetische tags die wie zuvor beschrieben bei der Batch-Projektausführung verwendet werden können.
Sie können nach Referenzelement, Ereignisrahmenname, Ereignisrahmenvorlage und entweder Ereignisrahmenkategorie oder Ereignisrahmenattributen filtern.

Zum Beispielample können Sie Ereignisrahmenfilter erstellen für:

Ereignisrahmen, die unter dem Element „Sweden_Site“ das Attribut „productType“ mit dem Wert 42 haben.
Ereignisrahmen, deren Name mit „b“ beginnt und deren Ereignisrahmenkategorie „SIMCAonlineBatches“ ist.

Hier ist ein ExampMöglichkeit, Batches in SIMCA-online in einem der Knoten zu finden, die Event Frames enthalten:

Voraussetzungen

Diese SimApi wurde ursprünglich für die PI-Systemversion 2012 entwickelt und zum Zeitpunkt des Schreibens auf verschiedenen PI-Serverversionen bis hin zu PI Server 2018 SP3 Patch 5 getestet.

Um die SimApi auf einem Computer verwenden zu können, muss die folgende Software installiert sein:

Das Aveva PI AF1 SDK. Es ist im PI AF Client enthalten, den Sie von Aveva erhalten. Die SimApi wurde mit der Version PI AF Client 2018 SP3 Patch-5 (Version 2.10.11.2717) entwickelt.
Installieren Sie diese Version oder die neueste verfügbare Version. https://techsupport.osisoft.com/Products/PI-Server/PI-AF/Overview
Die Microsoft Visual C++ Redistributable für Visual Studio 2015-2022. Oftmals sind diese bereits auf einem Computer installiert (z.B.ample, sie werden automatisch von SIMCA oder SIMCA-online installiert), aber wenn die SimApi deshalb nicht startet, laden Sie die neueste Version herunter und installieren Sie sie von https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads

Sicherheit des Aveva PI-Systems

PI verwendet die folgenden Konzepte zur Zugriffskontrolle.
PI kann die Windows-Authentifizierung verwenden, was bedeutet, dass Active Directory-Konten zum Konfigurieren der Sicherheit verwendet werden.
Diese Methode wird von Aveva und Sartorius Stedim Data Analytics empfohlen, da es die einzige Methode zur Authentifizierung gegenüber dem Asset Framework SDK ist.
PI-Benutzer sind Benutzer mit Passwörtern, die auf dem PI-Server erstellt werden. Gruppen können zum Gruppieren von Benutzern verwendet werden.
PI Trusts legen fest, welche Computer eine Verbindung zum PI-Server herstellen dürfen. Trusts sind IP-basiert und daher auf DNS angewiesen.
Der SIMCA-Online-Server muss zum PI-Trust hinzugefügt werden, da er sonst keine Verbindung zum PI-Server herstellen kann.
Darüber hinaus müssen möglicherweise auch Netzwerk-Firewalls konfiguriert werden, um der SimApi die Verbindung zu Remote-Servern zu ermöglichen.
Diese Themen werden im Folgenden ausführlich erläutert. Weitere Informationen finden Sie in der PI-Dokumentation.

Windows-Sicherheit

Mithilfe von Windows-Sicherheitsprinzipalen (Gruppen oder Benutzerkonten) kann der Zugriff auf den PI-Server konfiguriert werden.
Sie müssen das Benutzerkonto kennen, mit dem die SimAPI ausgeführt wird. Für SIMCA ist dies das Benutzerkonto, mit dem Sie am Computer angemeldet sind. Für SIMCA-online ist es das Dienstkonto, das vom SIMCA-online-Serverdienst verwendet wird (konfiguriert in der Systemsteuerung „Dienste“ in Windows). Beachten Sie, dass für einen SIMCA-online-Server standardmäßig das Dienstkonto „Lokales System“ verwendet wird. Dieses muss in ein Domänenbenutzer-Dienstkonto geändert werden, um den Zugriff in PI einrichten zu können.
Wenn Sie aus irgendeinem Grund das Benutzerkonto, das zum Ausführen der SimApi verwendet wird, nicht ändern können, können Sie das Benutzerkonto auch im SimApi-Konfigurationsdialogfeld festlegen.
Dadurch ist es möglich, für die Verbindung zu PI ein anderes Konto zu verwenden als das Servicekonto für SIMCA-online.
Wenn Sie das Benutzerkonto kennen, konfigurieren Sie PI so, dass dieses Konto eine Verbindung zum PI-Server herstellen kann.
Dies kann erreicht werden, indem sichergestellt wird, dass der Benutzer (oder eine Gruppe, deren Mitglied der Benutzer ist) unter „Sicherheitszuordnungen“ in den PI System Management Tools enthalten ist.

PI-Server in einer anderen Domäne als der SIMCA-Online-Server

Wenn sich das PI-System in einer anderen Domäne befindet als der SIMCA-Online-Server, können Sie bei der Bereitstellung möglicherweise keine Windows-Vertrauensstellung zwischen den verschiedenen Domänen einrichten.
Eine Lösung in diesem Fall besteht darin, sowohl auf dem PI AF-Server als auch auf dem SIMCA-Online-Server ein lokales Windows-Konto zu erstellen, da dieses dann in der Lage ist, den von einem Computer an den anderen über Domänen hinweg weitergegebenen „.\UserName“ aufzulösen und zu authentifizieren.

PI Trust

PI Trust ist eine weitere Möglichkeit, Anwendungsnamen, IP-Nummern oder Computernamen Zugriff auf PI zu gewähren. Dies erfolgt in den PI System Management Tools unter Sicherheit

Trusts, wo Sie Folgendes angeben können:

Anwendungsname: Zum Erstellen einer Vertrauensstellung kann ein bestimmter Anwendungsname verwendet werden.
- Für SIMCA ist es simca.exe (und simpler.exe für SIMCA vor Version 15).
Notiz Beachten Sie, dass diese SimApi nicht mit dem älteren OSIsoft PI Batch SDK funktioniert (nur PI AF, wie oben beschrieben). Wenn Ihr PI-System nur PI Batch unterstützt, müssen Sie die von Aveva/OSIsoft entwickelte PI SimApi verwenden.
- Für SIMCA-online lautet der Name SIMCAonlineserver.exe und SIMCAonlineconfig.exe (SIMCA-online-Serveroptionen, die zur Durchführung der SimApi-Konfiguration verwendet werden).
IP-Informationen: Sie können eine Vertrauensstellung basierend auf den IP-Informationen des Computers definieren, auf dem die PI SimApi ausgeführt wird, der Sie vertrauen möchten. Sie können IP-Informationen als Netzwerkpfad oder IP-Adresse und Netzmaske angeben:
Netzwerkpfad: Der vollqualifizierte Domänenname. Zum Beispielampich, mein_laptop.meine_firma.com
IP-Adresse: IP-Adresse des Computers, auf dem PI AF SimApi ausgeführt wird.
Netzmaske: Wenn Sie eine IP-Adresse angeben, müssen Sie auch explizit eine Netzmaske angeben. Andernfalls wird ein Fehler generiert. Wenn Sie eine exakte Übereinstimmung mit einer IP-Adresse benötigen, geben Sie die Netzmaske als 255.255.255.255 an. Wenn Sie ein Subnetz der Klasse C angeben, geben Sie die Netzmaske als 255.255.255.0 und das vierte Feld der IP-Adresse als 0 an.

Windows-Kontoinformationen

Windows-Domäne: Windows-Domäne des Benutzers, der die Anwendung ausführt.
Windows-Konto: Windows-Benutzername des Benutzers, der die Anwendung ausführt.
Es ist möglich, für den Benutzernamen einer bestimmten Domäne ein Dollarzeichen ($) zu verwenden. Dann können Benutzer dieser Domäne über diese Vertrauensstellung eine Verbindung zu vorhandenen PI-Benutzern mit demselben Namen wie der Windows-Benutzer herstellen, der die Anwendung ausführt.
Dies wird als Dollarzeichen-Trust bezeichnet.
Um eine Vertrauensstellung mit Dollarzeichen zu konfigurieren, importieren Sie normalerweise zuerst Ihre Windows-Benutzernamen und -Kennwörter als PI-Benutzer.
Weitere Informationen finden Sie unter „Windows-Benutzer importieren“ in der PI System Management Tools-Dokumentation für PI. (Das Dollarzeichen ist sowohl für die Domäne als auch für den Benutzernamen ein gültiger Wert.)
Hier wurden alle drei verschiedenen Möglichkeiten zum Konfigurieren eines PI-Trusts kombiniert verwendet, obwohl nur eine erforderlich ist.
Dieses Example trust ermöglicht Berechtigungen für SIMCA-online vom Rechner computer.sartorius.com.
Weitere Informationen zu PI Trusts finden Sie in der Hilfe zu den OSIsoft PI System Management Tools.

Firewalls zwischen SimApi und dem PI-Server

Eine Netzwerk-Firewall zwischen der in SIMCA oder dem SIMCA-Online-Server ausgeführten SimApi und dem PI-Server kann den Netzwerkverkehr so einschränken, dass die SimApi nicht funktioniert.
Um den PI-Netzwerkverkehr zu ermöglichen, muss TCP-Port 5450 geöffnet werden. Dies ist der normale Firewall-Zugriff für PI. Außerdem muss TCP-Port 5457 vom AF-Server zu jeder AF-Client-Anwendung geöffnet sein.
Weitere Einzelheiten finden Sie im folgenden Knowledge Base-Artikel: https://techsupport.osisoft.com/Troubleshooting/KB/KB00751
Weitere Informationen zu den Firewall-Anforderungen für PI finden Sie in der PI Server-/PI-SDK-Dokumentation von Aveva. Die PI AF SimApi verhält sich wie eine PI-Anwendung. Suchen Sie daher in diesem Dokument nach diesem Begriff.
Verwenden der SimApi nur mit einem PI AF-Server (ohne dass in der SimApi ein PI-Server konfiguriert ist)
Wenn nur der PI AF-Server verwendet wird und der Benutzer Elementattribute lesen möchte, die mit einem PI-Punkt verbunden sind, kann sich die SimApi nicht beim PI-Server authentifizieren, da es im SDK keine solche Option gibt.
In diesem Fall verlassen wir uns entweder darauf, als was der SIMCA-Online-Serverdienst ausgeführt wird, oder darauf, ob eine Vertrauensstellung gegenüber der Datei „SIMCAonlineserver.exe“ besteht.

Ein Grund für die Fehlermeldung „SimApi konnte nicht initialisiert werden“

Die Fehlermeldung „SimApi konnte nicht initialisiert werden“ erscheint beim Klicken auf die Schaltfläche „Konfigurieren“ in den Serveroptionen. Dieses Problem wurde in der PI-Datenbanksicherheit gelöst, indem der dem Trust zugeordneten Identität Schreibzugriff auf die PIMSGSS-Tabelle gewährt wurde.

Echtzeitverzögerungen durch die PI-zu-PI-Schnittstellenkonfiguration

Wenn die Daten auf dem PI-Server über eine PI-zu-PI-Schnittstelle von einem anderen PI-Server gepusht werden, kann es zu Verzögerungen beim Lesen der aktuellen Daten kommen, da die Daten in einem festgelegten Zeitintervall gepusht werden.
Stellen Sie sicher, dass das in der PI-zu-PI-Schnittstelle konfigurierte Zeitintervall kurz genug ist, um Änderungen in Ihrem Prozess in Echtzeit zu erkennen. Es muss mit dem in SIMCA-online verwendeten Ausführungsintervall vergleichbar sein.

Installation und Einrichtung

Weitere Informationen finden Sie im SimApi-Handbuch unter sartorius.com/umetrics-simapi Allgemeine Schritt-für-Schritt-Anleitungen für die Installation einer SimAPI. Das Dokument enthält außerdem zahlreiche Tipps zur Fehlerbehebung und zum Testen der SimAPI-Installation.
Es gibt Einstellungen, die in Aveva PI vorgenommen werden müssen, um die Verwendung der PI AF SimApi zu ermöglichen, sowie viele verschiedene Einstellungen, die für SimApi selbst vorgenommen werden können.
Wir empfehlen Ihnen, bei der Konfiguration dieser SimApi Personen aus Ihrem Unternehmen einzubeziehen, die Ihre PI-Infrastruktur kennen.
Mit dem Tool PI System Explorer (wird mit dem PI AF SDK installiert) können Sie sehen, wie Ihr PI AF konfiguriert ist, und die erforderlichen Einstellungen vornehmen.

Konfigurieren der SimApi-Einstellungen

Um die Einstellungen für die SimApi in SIMCA-online zu ändern, starten Sie das Dienstprogramm „Serveroptionen“ und klicken Sie auf der Registerkarte „SimApi“ auf „Konfigurieren…“ für die SimApi-Instanz, die Sie konfigurieren möchten.
Die gleichen Richtlinien gelten für SIMCA, obwohl alle Screenshots und ExampDie folgenden Dateien sind für SIMCA-online.
Der folgende Dialog wird angezeigt. Konfigurieren Sie die Einstellungen, die Sie für Ihre Umgebung benötigen.
Nach dem Speichern und Beenden muss der SIMCA-Online-Serverdienst neu gestartet werden, damit die Änderungen wirksam werden.
Folgende Einstellungen sind verfügbar.

Einstellung	Erläuterung
PI-Server	Ermöglicht die Bereitstellung von PI Datenpunkten in der Umetrics Suite. Geben Sie den Namen des PI-Servers an, mit dem eine Verbindung hergestellt und von dem aus PI Datenpunkte aufgezählt werden sollen. Dies ist optional. Wenn Sie dies jedoch weglassen, muss der AF-Server angegeben werden.
AF-Server	Aktiviert Event Frames in der Umetrics Suite. Geben Sie den Namen des Asset Framework-Servers ein, mit dem eine Verbindung hergestellt werden soll. Dies ist optional. Wenn Sie dies jedoch weglassen, muss der PI-Server angegeben werden.
AF-Datenbank	Leitet den Asset Framework-Server zu einer bestimmten Datenbank weiter. Tragen Sie den Namen der Asset Framework-Datenbank innerhalb des zu verwendenden Asset Framework-Servers ein. Wenn dieses Feld leer bleibt, verwendet die SimApi die Standarddatenbank auf dem Server.
Elementkategorien	Zum Filtern der Elemente können mehrere Elementkategorien verwendet werden. Trennen Sie Kategorien durch ein Semikolon (;). Sie können auch * angeben, um alle Elemente anzuzeigen. Dies kann jedoch bei vielen Elementen die Startleistung beeinträchtigen. Wenn Sie das Feld leer lassen, werden keine Elemente angezeigt.
Benutzername	Die Anmeldeinformationen für die Verbindung mit den PI-Servern finden Sie oben. Lassen Sie das Feld leer, um das Konto des aufrufenden Prozesses zu verwenden (normalerweise das SIMCA-Online-Dienstkonto).
Passwort	Die Anmeldeinformationen für die Verbindung mit den oben angegebenen PI-Servern. Lassen Sie das Feld leer, um das Konto des aufrufenden Prozesses zu verwenden, typischerweise das SIMCA-Online-Dienstkonto. Das Passwort wird verschlüsselt und nicht im Klartext in der Konfiguration gespeichert. file.
Ereignisrahmenfilter	Sie können optionale Filterknoten erstellen, indem Sie auf die Schaltfläche … klicken. Diese dienen als Batchknoten zur Definition von Batches, die in SIMCA Online ausgeführt werden. Weitere Informationen finden Sie unter 1.2.7 oben. Im nächsten Abschnitt finden Sie die verfügbaren Einstellungen, die Sie steuern können.

Protokollebene	Steuert, wie viele Informationen in das Protokoll geschrieben werden file. (Debug, Information, Warnung, Fehler, Kritisch). Debug hilft bei der Behebung von Problemen mit der SimApi.
Maximale Protokollgröße (MB)	Steuert die maximale Größe des Protokollsfile bevor Sie ein neues erstellen. Wenn Sie diesen Wert auf 0 setzen, bedeutet dies eine unendliche Größe.
Erweiterte Einstellungen	Beachten Sie die Beschreibungen dieser Elemente im Konfigurationsprogramm.

Einstellungen für den Ereignisrahmenfilter

Event Frame-Filter stellen Event Frames (Batches) bereit, die die Filterkriterien erfüllen. Sie können als Batch-Knoten in SIMCA-online verwendet werden, wie in 1.2.7 beschrieben.

Sie können zwei Arten von Ereignisrahmenfiltern erstellen:

Nach Ereignisrahmenattribut – diese ermöglichen Ihnen, logische Bedingungen für ein oder mehrere Ereignisrahmenattribute zu erstellen.
Nach Ereignisrahmenkategorie – hiermit können Sie eine Ereignisrahmenkategorie auswählen.
Mit beiden Filtertypen können Sie außerdem ein Referenzelement angeben, nach Ereignisrahmennamen filtern und eine Ereignisrahmenvorlage angeben.
Jeder Filterknoten muss einen eindeutigen Namen haben, den Sie angeben. Dies ist der Knotenname, der in SIMCA-online unterhalb des Knotens „Ereignisrahmenfilter“ der obersten Ebene verwendet wird.
In der folgenden Tabelle sind die verschiedenen Einstellungen zusammengefasst, die Sie in den Konfigurationsdialogen vornehmen können. Beachten Sie auch den PI AF-Konfigurationsdialog, der eine integrierte Hilfe zu jeder Einstellung bietet.

Einstellung	Beschreibung	Wird in einem Filter verwendet nach Ereignisrahmenattribut	Wird in einem Filter verwendet nach Event-Frame-Kategorie
Knotenname	Ein beliebiger Name des Knotens (eindeutig unter anderen Knoten). Zum Beispielample, ProduktABatches.	X	X
Namensfilter	Filter basierend auf dem Namen des Ereignisrahmens. Platzhalter * und ? werden unterstützt.	X	X
Referenzelement	Filter basierend auf dem Elementnamen. Platzhalterzeichen * und ? werden unterstützt. Ereignisrahmen, die auf dieses Element verweisen, werden vom Filter zurückgegeben.	X	X
Vorlage für einen Ereignisrahmen	Gefiltert basierend auf einer bestimmten Event Frame-Vorlage.	X	X
Kategorie des Ereignisrahmens	Filtern Sie nach einer bestimmten Ereignisrahmenkategorie. Verwenden Sie * für jede Kategorie.		X
Eigenschaften	Filterbasierte Ereignisrahmenattribute. Sie können ein oder mehrere Attribute angeben. Für jedes Attribut geben Sie Einstellungen an, die einen logischen Ausdruck steuern, der als „true“ ausgewertet werden muss, damit der Ereignisrahmen dem Filter entspricht. Die Einstellungen für jedes Attribut sind:	X
Attributpfad	Der Name des Ereignisrahmen-Vorlagenattributs. Der Pfad sollte relativ zur angegebenen Ereignisrahmen-Vorlage sein. Der Wert für dieses Attribut wird unter Verwendung des angegebenen Operators mit der Einstellung „Wert vergleichen“ verglichen.	X
Operator	Definiert die Art des Vergleichs. Zum Beispielample, Gleich.	X

Vergleichswert

Der Wert, der mit dem Attributwert „Ereignisrahmen“ verglichen werden soll. Für Zeichenfolgenwerte können nur die Operatoren „Gleich“ und „Ungleich“ verwendet werden.

Bei Verwendung des Operators „in“ können mehrere Werte verwendet werden. Trennen Sie die Werte mit einem Semikolon (;).

Konfiguration Bspample

Dieser Abschnitt gibt ein BeispielampSehen Sie, wie das PI-System aussehen kann und wie die PI AF SimApi für die Verbindung damit konfiguriert werden kann.
Die PI AF SimApi wurde bereits installiert und das PI-System wurde so konfiguriert, dass der Benutzer wie in 2 beschrieben eine Verbindung zum Server herstellen kann.

Grundkonfiguration

Hier ist die Konfiguration für die PI AF SimApi, die über die SIMCA-online Serveroptionen geöffnet wurde. Wie Sie sehen, haben wir einige Einstellungen vorgenommen, die im Folgenden erläutert werden.
Wir haben einen Server, ServUmVM3, der sowohl im PI-Server- als auch im AF-Server-Feld eingegeben ist.
In PI heißt unsere Datenbank „Production“, wie Sie im folgenden Screenshot sehen können. Diesen Namen verwenden wir also auch in der Konfiguration.
Wir geben außerdem den Benutzernamen und das Kennwort an, mit denen die PI AF SimApi eine Verbindung zu den PI AF-Servern herstellt. Diesem Benutzer wurden bereits Zugriffsrechte für PI erteilt.
Für unseren SIMCA-Online-Server verwenden wir ein anderes Dienstkonto. Der Unterschied besteht darin, dass dieses zur Benutzerauthentifizierung auf unser Active Directory zugreifen kann.
Dies sind die Diensteigenschaften auf dem SIMCA-online-Servercomputer.

Optionale Elementkategorien

Wir geben die Elementkategorien A_Simca_Element; Other_Category an. Das bedeutet, dass wir alle Elemente, die einer der beiden Kategorien entsprechen, in SIMCA-online sehen.
So sieht die Elementkategorie A_Simca_Element auf dem PI-Server aus.

Optionaler Ereignisrahmenfilter „Nach Attribut“

Wir haben einen Event Frame-Filterknoten nach Attribut wie folgt konfiguriert, um nur Event Frames mit einem Tankfüllstand unter 40 anzuzeigen:

So sieht unsere Event-Frame-Vorlage in PI aus:

Wir verwenden dieses Level-Attribut in unserem Filterknoten, um nur Event Frames mit einem Level unter 40 anzuzeigen.

Hier ist die erste Konfigurationsseite für unseren Filterknoten „Nach Attribut“:

Wichtig: Die im obigen Screenshot angegebene Ebene muss durch den vollständigen Pfad zum Attribut ersetzt werden, den Sie aus PI System Explorer kopieren können.
Zum Beispielampauf: \\Servername\Produktion\Ebene

Hier sind die Einstellungen für das Level-Attribut:

Optionaler Ereignisrahmenfilter „nach Kategorie“

Schließlich haben wir auch einen Filterknoten konfiguriert, der Ereignisrahmen basierend auf der Ereignisrahmenkategorie „Hefe“ verfügbar macht.

Wie sieht das in SIMCA-online aus

Dies ist das Ergebnis der obigen Einstellungen in SIMCA-online.

Dabei können die Elementknoten, die Event Frame Filter-Knoten und der Event Frames-Knoten als Batchknoten in Projektkonfigurationen verwendet werden.
Synthetik tags kann in Ausführungsbedingungen für die einfache Ausführung von Batch-Projekten verwendet werden. Ein BeispielampEine Anleitung hierzu finden Sie in 1.2.6.1.
Die PI Datenpunkte des PI Servers sind unter dem Knoten Punkte sichtbar. Diese tags sind mit Variablen in der Phase verbunden tags Seite der Projektkonfiguration.

Zur SIMCA-Online-Projektabwicklung und PI AF

Dieses Kapitel bietet eine kurze Einführung in die Anforderungen von SIMCA-online zur Ausführung von Batchprojekten und gibt einige Empfehlungen, die für PI Asset Framework (AF) und PI Event Frames (EF) gelten.
Ausführliche Informationen zur Ausführungslogik von SIMCA-Online finden Sie im technischen Handbuch zu SIMCA-Online.

Chargen-IDs in SIMCA-online

SIMCA-online verwendet Batch-IDs auf zwei Arten.
Die Batch-ID ist ein in PI AF definierter Ereignisrahmen.
- In SIMCA-online werden diese als Batches im sogenannten Batch-Knoten interpretiert.
- Der Batch-Knoten wird verwendet, um abgeschlossene und derzeit aktive Batches zu identifizieren.
- Abgeschlossene Stapel sind solche, die sowohl eine Startzeit als auch eine Endzeit haben.
- Aktive Stapel sind solche, die nur eine Startzeit enthalten und deren Endzeit leer/null ist.
Batch-ID als Prozess tag:
- Jede Einheit, die eine Phase für eine Charge verarbeiten kann, erfordert einen separaten Prozess tag Gibt die Charge an, die in dieser Einheit aktiv ist.
- Der Wert der Batch-ID muss mit dem Batch-Namen im Batch-Knoten oder, um die PI-Terminologie zu verwenden, mit dem Namen des Ereignisrahmens in PI übereinstimmen.

Batch-Knotenauswahl in SIMCA-online

Im Asset-Framework gibt es eine Ereignishierarchie, die gemäß den Batch-Standards ISA 88 erstellt wurde.
Der Batch muss für die Dauer aller zugehörigen Phasen aktiv bleiben. Bei Batches mit mehreren Phasen muss das Batchereignis vor oder zum Zeitpunkt des Auslösens der ersten Phase beginnen und nach oder zum Abschluss der letzten Phase enden.
In SIMCA-online werden unabhängige Phasenausführungsbedingungen verwendet, um die Lebensdauer jeder Phase zu definieren.
Das EF-Batch-Ereignis wird nur für die Genealogie der Phasen verwendet, um abzubilden, welche aktiven Einheiten zu welchen Batches gehören.
Dies ermöglicht die Verfolgung paralleler und komplexer Materialflüsse durch mehrere Einheiten.

In PI hat die Hierarchie der Einheiten die folgende Form:

Charge
- Einheit
  - Phase
  - Unterphase
In SIMCA-online besteht große Flexibilität bei der Definition und Interpretation von Batchknoten und Batches.

Zum Beispielample, in der Chromatographie, wobei:

Jeder Zyklus kann als eine Phase definiert werden,
Jeder Einheitsvorgang (Beladung, Äquilibrierung, Elution usw.) kann als Unterphase definiert werden.
Der Batch-Knoten in SIMCA-online kann auf Einheitenebene definiert werden,
- Jeder Zyklus könnte als Ereignis in EF und als Batch in SIMCA-Online definiert werden, und
- Jeder Einheitsvorgang kann in EF als Unterphase und in SIMCA-Online als Phase definiert werden.

SIMCA-Online-Ausführungslogik

Dies beschreibt die Reihenfolge, in der SIMCA-online Batches und Phasen startet. Den vollständigen Algorithmus mit allen Details finden Sie im technischen Handbuch von SIMCA-online.

SIMCA-online ermittelt die aktiven Chargen
- a. Fordern Sie die EF-Elemente – möglicherweise gibt es eine spezielle Anforderung nur für die aktiven – vom definierten Batch-Knoten von SIMCA-online an (der Batch-Knoten kann sich auf Server- oder Unit-Ebene befinden).
- b. Als aktive Stapel gelten Stapel, die keinen Eintrag für die Endzeit aufweisen (dieser bleibt null/leer).
- c. SIMCA-online erfasst die Namen der aktiven Chargen.
SIMCA-online ermittelt, ob aktive Phasen vorhanden sind
- a. SIMCA-online fragt den Namen des in jeder Phase laufenden Batches ab. Der Name des Batches ist der aus dem Prozess abgerufene Wert tag als Batch-ID in der Einheit konfiguriert.
- b. SIMCA-online prüft, ob der Name der Charge in der Liste der aktiven Chargen enthalten ist. Dies geschieht, indem geprüft wird, ob der Wert mit dem Namen einer aktiven Charge übereinstimmt.
- c. SIMCA-online wertet die in SIMCA-online konfigurierte Triggerlogik aus, um festzustellen, ob die Phase aktiv ist.
SIMCA-online extrahiert die Snapshot-Werte für alle tags von aktiven Phasen verwendet

Unterstützung

Diese SimApi wurde von Sartorius Data Analytics entwickelt. Für Support besuchen Sie bitte sartorius.com/umetrics-support
Bei Fragen zu Aveva PI, beispielsweise zum Asset Framework, zu Event Frames, zur PI-Sicherheit und Ähnlichem, empfehlen wir Ihnen, sich direkt an Ihren Aveva-Vertreter oder den technischen Support zu wenden.

FAQs

F: Was ist eine SimApi?
- A: Eine SimApi ist die Verbindung zwischen der Umetrics Suite und externen Datenquellen.
F: Was sind Ereignisrahmen in SIMCA-online?
- A: Ereignisrahmen stellen Stapel mit Start- und Stoppzeiten dar, die sich in einem Stapelknoten in SIMCA-online befinden.
F: Wo finde ich weitere Informationen zu SimApis?
- A: Besuchen sartorius.com/umetrics-simapi für detaillierte Informationen zu SimApis und ihren Funktionen.

Dokumente / Ressourcen

SARTORIUS PI AF SimApi [pdf] Benutzerhandbuch
PI AF SimApi, AF SimApi, SimApi

Verweise

Bedienungsanleitung

SARTORIUS PI AF SimApi

Produktinformationen

Anweisungen zur Produktverwendung