
SARTORIUS PI AF SimApi

Produktinformation
Specifikationer
- Produktnavn: PI AF SimApi
- Fabrikant: Sartorius Stedim Data Analytics
- Forbindelse: Umetrics Suite til eksterne datakilder
Produktbrugsvejledning
Forudsætninger
Før du bruger PI AF SimApi, skal du sørge for, at realtidsforsinkelser forårsaget af PI til PI-grænsefladekonfigurationen minimeres.
Installation og opsætning
- Få adgang til indstillingsmenuen i SimApi-grænsefladen.
- Juster de nødvendige parametre baseret på din datakilde.
Indstillinger for filter til begivenhedsrammer
- Naviger til sektionen Event Frame Filter i SimApi-grænsefladen.
- Definer kriterierne for filtrering af begivenhedsrammer baseret på start- og sluttidspunkter.
Om SIMCA-online projektudførelse og PI AF
Til udførelse af projekter på SIMCA-online og PI AF integration.
- Sørg for korrekt synkronisering mellem SIMCA-Online og PI AF.
- Bekræft dataflowet mellem projekterne for at sikre nøjagtig analyse.
Støtte
For yderligere hjælp eller support, se brugervejledningen eller kontakt kundesupport hos Sartorius Stedim Data Analytics.
Indledning
- Dette dokument er brugervejledningen til PI AF SimApi fra Sartorius Stedim Data Analytics.
- En SimApi er forbindelsen mellem Umetrics Suite og eksterne datakilder.
- Den PI AF SimApi, der beskrives i dette dokument, er forbindelsen mellem et Aveva (tidligere OSIsoft) PI Asset Framework-system og SIMCA®-online-løsningen og SIMCA® Multivariate Data Analysis Solution.
- For en detaljeret liste over ændringer i forskellige versioner af denne SimApi, se Version Info.txt file der følger med installationen. For mere information om SimApis, se sartorius.com/umetrics-simapi.
Vilkår
| Aveva PI-navn | SIMCA-online terminologi |
| Hændelsesramme (EF) | En batch med et start- og et stoptidspunkt. Batches findes i en batch-node i SIMCA-online.
Det kan også være en fase med et start- og et sluttidspunkt. |
| Attributten Event Frame | A tag der indeholder batchdata (én observation pr. batch) |
| Element i aktivrammen | Enhed, en fysisk ting såsom en bestemt tank, eller en logisk ting såsom en placering eller en bygning. |
| Elementattribut, en attribut på et element, kan være et PI-punkt med procesdata eller metadata, der beskriver elementet. | |
| Skabelon til element for aktivramme (angiver de attributter, som en hændelsesramme genereret fra den skabelon kan have) | Svarer løst til en enhedsgruppe |
| PI-punkt | Tag |
Funktioner
- SimApi implementerer følgende SimApi-funktioner: Se sartorius.com/umetrics-simapi for at lære mere om de generelle SimApi-funktioner.
- Opret forbindelse til en Aveva PI-server med understøttelse af numeriske (analoge eller diskrete) værdier og tekstværdier
- Opret forbindelse til en PI AF-server, hvilket muliggør brugen af Event Frames og Element-hierarkiet
- Brug de angivne loginoplysninger, eller brug kontoen for opkaldsprocessen (f.eks. SIMCA-online-tjenestekontoen)
- Aktuelle og historiske kontinuerlige data for PI-punkter og elementattributter
- Topniveau-punkter, der indeholder alle procesdata-PI-punkter
- Batchdata, delvis understøttelse
- Tilbageskrivning – kontinuerlige data for PI-punkter (ikke for elementattributter)
- Skriv tilbage – batchdata, delvis understøttelse
- Valgfrit nodehierarki for PI AF-elementer, der matcher et elementkategorifilter. Vises i elementnoden på øverste niveau.
- En batchnode i den øverste node for begivenhedsrammer, der viser begivenhedsrammer, der findes i roden i PI AF.
- Valgfrie hændelsesrammer-filtre, der eksponerer et delmængde af hændelsesrammer (batches) for SIMCA-online, baseret på kriterier, du angiver.
- Du kan filtrere efter element, navn på begivenhedsramme, skabelon for begivenhedsramme, kategori for begivenhedsramme og attributter for begivenhedsramme.
- Syntetiske procesbatchdata tags, hvilket muliggør nem udførelse af batchprojekter i SIMCA-Online.
- Flere instanser af SimApi kan køres på den samme SIMCA-Online-server
- Forbindelsesrobusthed – SimApi'en genetablerer automatisk forbindelsen til datakilden efter afbrydelse. Nogle af disse funktioner forklares yderligere nedenfor.
- Følgende billede bruges til at illustrere koncepterne, hvor de fremhævede noder svarer til fede elementer i funktionslisten ovenfor.

PI-elementernes hierarki
- Når SimApi er tilsluttet en AF-server, vil den opregne alle elementer, der matcher filteret Elementkategorier, som du angav, når du konfigurerede SimApi.
- Mere end én elementkategori kan bruges til at filtrere elementerne. Adskil kategorier med et semikolon (;). Elementer, der tilhører en given kategori, vil blive vist.
- Du kan også angive * for at vise alle elementer, men dette kan påvirke opstartsydelsen negativt, hvis der er mange elementer. Et tomt kategorifilter betyder, at ingen elementer vil blive eksponeret.
- De matchende elementer vises under den øverste node Elementer. Den samme struktur bruges som i PI System Explorer.
- Bemærk at for at eksponere syntetisk proces tags For et element (se nedenfor) skal det matche filteret for elementkategorier. Ellers vises elementet blot som en beholder med underordnede elementer uden attributter.
Elementattributter
- Elementattributter vises som tags i Element-noden i SIMCA-online.
- Attributter, der er skjulte eller ekskluderede i PI, vises ikke.
- Hierarkiske attributter navngives ved hjælp af deres relative sti adskilt af en linje (|), set fra det indeholdte element. For eksempelample, attributten Temperature|Attribute1 i skærmbilledet ovenfor.
PI-point
- Hvis du angiver at oprette forbindelse til en PI-server, når du konfigurerer SimApi, vises den pågældende servers PI-punkter i den øverste node for punkter.
- Punkter svarer til data tags i SIMCA-online, eller variabler i SIMCA, og bruges til at læse procesdata til projektudførelse.
Om hvordan batchdata læses og skrives
- Batchdata er som en Event Frame-attribut, når Event Frame beskriver en batch. Event Frame-attributter understøttes dog i øjeblikket ikke af PI AF SimApi.
- I stedet fungerer SimApi'en som følger (svarende til hvordan Aveva implementerede deres AF SimApi):
- Batchdata læses som et PI-punkt ved hjælp af starttidspunktet for batchen, som angivet af Event Frame, for at vide, for hvilket tidspunkt data skal læses.
- Batchdata skrives til et PI-punkt defineret af brugeren med tidslinjen stamp af batchstarttidspunktet som angivet af Event Frame.
Begivenhedsrammer
- PI-hændelsesrammer for SimApi'en svarer til batches eller faser i processen.
- Når en eventframe repræsenterer en batch, angiver den start- og stoptidspunktet for batchen og bruges som en batchnode i SIMCA-online, hvilket muliggør overvågning af eventframes i den pågældende node i SIMCA-online, hvor du også kan højreklikke på den for at finde matchende batches i den, som dette skærmbillede illustrerer:

- Når en hændelsesramme repræsenterer en fase, angiver den start- og stoptidspunkterne for en fase.
- Hvis du vil overvåge alle faser af batchen i SIMCA-online, kan du konfigurere et hierarki i PI, så batch-hændelsesrammer omfatter de faser, der tilhører batchen.
- Derefter bruger du batch-hændelsesrammen som batchnode i SIMCA-Online.
- Hændelsesrammer eksponeres af SimApi'en i elementnodehierarkiet, den øverste node i hændelsesrammer og alle konfigurerede noder i hændelsesrammefilteret.
Syntetisk proces tags for navn og varighed af begivenhedsramme (batch/fase/trin)
- Syntetisk proces tags er oprettet af SimApi'en for at forenkle projektudførelsen.
- Denne funktion fungerer ikke med samtidige (parallelle) Event Frames. Derfor må der på et givet tidspunkt kun være én Event Frame aktiv i batchnoden.
- Syntetisk tags oprettes for den øverste node for eventframes, alle elementnoder, der matcher filteret Elementkategorier, og alle noder for eventframefilter (se næste afsnit).
| Syntetisk tag navn | Formål |
| Navnet på den seneste aktive hændelsesramme i noden på det givne tidspunkt. | |
| Varigheden af den seneste aktive hændelsesramme i noden på et givet tidspunkt.
Varigheden skaleres til henholdsvis sekunder, minutter, timer og dage, så du kan vælge den, der matcher dine modelleringsbehov. |
- Note: Syntetisk batch tags generere et overhead i SimApi'en, hvilket kan føre til lavere ydeevne, især under indhentning og forudsigelse af tidligere færdige batches i SIMCA-online.
Brug af den syntetiske proces tags til batchprojektudførelse i SIMCA-Online
- I et batchprojekt skal procesdataene for hver fase have et batch-identifikator tagData læst i dette tag matches med batcherne i den angivne batchnode for at vide, om en fase skal udføres.
- Hvis procesdataene ikke har et batch-ID tag, den syntetiske proces tags kan bruges i stedet, da dataene for disse genereres ud fra viden om hændelsesrammen (batch).
- For at bruge denne funktion skal du gå til siden Udførelsesbetingelser i projektkonfigurationen i SIMCA-online-klienten og konfigurere batch-identifikatoren. tag at være det syntetiske batch-ID tag af batchnoden.
- Når serveren læser batch-ID'et for procesdataene, returneres batch-ID'et fra batchnoden, hvilket sikrer, at enheden kan udføres (faseudførelsesbetingelsen skal også være sand, som normalt i SIMCA-online).

- Her er batch-nodesiden i konfigurationen, der viser, at den er den samme.
Filternoden, der bruges som batchnode:
- Læs mere om udførelseslogik i SIMCA-online Teknisk Guide.
Filtre til begivenhedsrammer
- Hændelsesrammefiltre er valgfrie og skal konfigureres, før de vises af SimApi'en. Du kan tilføje så mange filtre, som du ønsker; hvert filtre konfigureres individuelt.
- En filternode for eventframes bruges som en batchnode i SIMCA-Online til at styre projektudførelsen. Filternoden eksponerer eventframes (batches), der opfylder specificerede filterkriterier.
- Filternoder udfylder også værdier for den syntetiske tags der kan bruges i batchprojektudførelse som beskrevet tidligere.
- Du kan filtrere efter referenceelement, navn på begivenhedsramme, skabelon for begivenhedsramme og enten begivenhedsrammekategori eller begivenhedsrammeattributter.
F.eksample, du kan oprette filtre til eventframes for:
- Hændelsesrammer, der har attributten productType med værdien 42 under elementet “Sweden_Site”.
- Hændelsesrammer med navnet "b" og hændelsesrammekategorien "SIMCAonlineBatches".
Her er en eksampmetode til at finde batches i SIMCA-online i en af noderne, der indeholder Event Frames:
Forudsætninger
Denne SimApi blev oprindeligt udviklet til PI System version 2012 og er på skrivende tidspunkt blevet testet på forskellige PI Server-versioner op til PI Server 2018 SP3 Patch 5.
For at bruge SimApi på en computer, skal den have følgende software installeret:
- Aveva PI AF1 SDK. Det er inkluderet i PI AF Client, som du får fra Aveva. SimApi blev udviklet med version PI AF Client 2018 SP3 Patch-5 (version 2.10.11.2717).
- Installer denne version eller den nyeste tilgængelige version. https://techsupport.osisoft.com/Products/PI-Server/PI-AF/Overview
- Microsoft Visual C++ Redistributable til Visual Studio 2015-2022. Disse er ofte allerede installeret på en computer (f.eks.ample, de installeres automatisk af SIMCA eller SIMCA-online), men hvis SimApi ikke starter på grund af dette, skal du downloade og installere den seneste version fra https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads
Aveva PI-systemsikkerhed
- PI bruger følgende koncepter til at kontrollere adgang.
- PI kan bruge Windows-godkendelse, hvilket betyder, at Active Directory-konti bruges til at konfigurere sikkerheden.
- Denne metode anbefales af Aveva og Sartorius Stedim Data Analytics, da det er den eneste metode til godkendelse mod Asset Framework SDK.
- PI-brugere er brugere med adgangskoder, der er oprettet på PI-serveren. Grupper kan bruges til at gruppere brugere.
- PI-trusts bestemmer, hvilke computere der har tilladelse til at oprette forbindelse til PI-serveren. Trusts er IP-baserede og er derfor afhængige af DNS.
- SIMCA-online-serveren skal tilføjes til PI-trusten, ellers kan den ikke oprette forbindelse til PI-serveren.
- Derudover skal netværksfirewalls muligvis også konfigureres for at tillade SimApi at oprette forbindelse til eksterne servere.
- Disse emner er forklaret detaljeret nedenfor. Se PI-dokumentationen for yderligere oplysninger.
Windows sikkerhed
- Windows-sikkerhedsprincipper (grupper eller brugerkonti) kan bruges til at konfigurere adgang til PI-serveren.
- Du skal kende den brugerkonto, der bruges til at køre SimApi. For SIMCA betyder det den brugerkonto, der er logget ind på computeren, men for SIMCA-online betyder det den servicekonto, der bruges af SIMCA-online-servertjenesten (konfigureret i kontrolpanelet Tjenester i Windows). Bemærk, at standardindstillingen for en SIMCA-online-server er at bruge servicekontoen Lokalt System. Denne skal ændres til en domænebrugerservicekonto for at kunne konfigurere adgang til den i PI.
- Hvis du af en eller anden grund ikke kan ændre den brugerkonto, der bruges til at køre SimApi, kan du også indstille brugerkontoen fra SimApi-konfigurationsdialogboksen.
- Dette gør det muligt at bruge en anden konto til at oprette forbindelse til PI end servicekontoen til SIMCA-online.
- Når du kender brugerkontoen, konfigurerer du PI til at tillade denne konto at oprette forbindelse til PI-serveren.
- Dette kan gøres ved at sikre, at brugeren (eller en gruppe, hvor brugeren er medlem) er inkluderet under Sikkerhedskortlægninger i PI-systemstyringsværktøjerne.
PI-servere i et andet domæne end SIMCA-online-serveren
- Hvis PI-systemet sidder på et andet domæne end SIMCA-online-serveren, tillader implementeringen dig muligvis ikke at oprette en Windows-tillid mellem de forskellige domæner.
- En løsning i dette tilfælde er at oprette en lokal Windows-konto på både PI AF-serveren og SIMCA-online-serveren, da den så kan løse og godkende ".\Brugernavn", der sendes fra én maskine til den anden på tværs af domæner.
PI Trust
- PI Trust er en anden måde at give adgang til PI til programnavne, IP-numre eller navne på computere. Dette gøres i PI System Management Tools under Sikkerhed.
Trusts, hvor du kan angive:
- Applikationsnavn: Et specifikt programnavn kan bruges til at oprette en tillid.
- For SIMCA er det simca.exe (og simpler.exe for SIMCA før version 15).
- Note at denne SimApi ikke fungerer med det ældre OSIsoft PI Batch SDK (kun PI AF som beskrevet ovenfor). Hvis dit PI-system kun understøtter PI Batch, skal du bruge den PI SimApi, der er udviklet af Aveva/OSIsoft.
- For SIMCA-online er navnet SIMCAonlineserver.exe og SIMCAonlineconfig.exe (SIMCA-online Server Options, som bruges til at foretage SimApi-konfigurationen).
- IP-oplysninger: Du kan definere en tillid baseret på IP-oplysningerne for den computer, der kører den PI SimApi, du vil have tillid til. Du kan angive IP-oplysninger som en netværkssti eller IP-adresse og netmaske:
- Netværkssti: Det fuldt kvalificerede domænenavn. For eksempelample, min_bærbar.mit_firma.com
- IP-adresse: IP-adressen på den computer, der kører PI AF SimApi.
- Netmaske: Hvis du angiver en IP-adresse, skal du også eksplicit angive en netmaske. Hvis du ikke gør det, vil der opstå en fejl. Hvis du har brug for et præcist match på en IP-adresse, skal du angive netmasken som 255.255.255.255. Hvis du angiver et Klasse C-undernet, skal du angive netmasken som 255.255.255.0 og det fjerde felt i IP-adressen som 0.
Windows-kontooplysninger
- Windows-domæne: Windows-domænet for den bruger, der kører programmet.
- Windows-konto: Windows-brugernavn på den bruger, der kører programmet.
- Det er muligt at bruge et dollartegn ($) som brugernavn for et bestemt domæne; så kan brugere på det pågældende domæne oprette forbindelse via denne tillid til eksisterende PI-brugere med samme navn som den Windows-bruger, der kører applikationen.
- Dette kaldes en dollartegnsfond.
- For at konfigurere en dollartegns trust importerer du typisk først dine Windows-brugernavne og -adgangskoder som PI-brugere.
- Se Importér Windows-brugere i dokumentationen til PI System Management Tools for PI. (Dollartegnet er en gyldig værdi for både domænet og brugernavnet.)
- Her er alle tre forskellige måder at konfigurere en PI-trust på blevet brugt i kombination, selvom kun én er nødvendig.
- Denne exampLe Trust tillader tilladelser til SIMCA-online fra maskinen computer.sartorius.com.

- For yderligere information om PI Trusts henvises til hjælpen til OSIsoft PI System Management Tools.
Firewalls mellem SimApi og PI-serveren
- En netværksfirewall mellem SimApi'en, der kører i SIMCA, eller SIMCA-online-serveren, og PI-serveren kan begrænse netværkstrafikken, så SimApi'en ikke fungerer.
- For at aktivere PI-netværkstrafikken skal TCP-port 5450 være åben. Dette er den normale firewalladgang for PI. Derudover skal TCP-port 5457 være åben fra AF-serveren til enhver AF-klientapplikation.
- Se følgende vidensbaseartikel for yderligere oplysninger: https://techsupport.osisoft.com/Troubleshooting/KB/KB00751
- For at få mere at vide om firewallkrav til PI, se PI Server / PI-SDK-dokumentationen fra Aveva. PI AF SimApi fungerer som en PI-applikation, så søg efter det pågældende udtryk i dokumentet.
- Brug af SimApi med kun en PI AF-server (uden en PI-server konfigureret i SimApi)
- Når man kun bruger en PI AF-server, og brugeren ønsker at læse elementattributter, der er forbundet med et PI-punkt, kan SimApi ikke godkende mod PI-serveren, da der ikke er en sådan mulighed via SDK'et.
- I dette tilfælde stoler vi enten på, hvordan SIMCA-online-servertjenesten kører, eller om der er en tillidsopsætning mod SIMCAonlineserver.exe.
En årsag til fejlmeddelelsen 'Kunne ikke initialisere SimApi'
- Fejlmeddelelsen "Kunne ikke initialisere SimApi" vises, når man klikker på knappen Konfigurer i Serverindstillinger. Dette problem blev løst i PI Database Security ved at give den identitet, der er knyttet til trust-serveren, skriveadgang til PIMSGSS-tabellen.
Realtidsforsinkelser forårsaget af PI-til-PI-grænsefladekonfiguration
- Hvis dataene på PI-serveren sendes fra en anden PI-server via en PI til PI-grænseflade, kan der opstå forsinkelser i læsningen af aktuelle data, da data sendes med et bestemt tidsinterval.
- Sørg for, at det tidsinterval, der er konfigureret i PI til PI-grænsefladen, er kort nok til at registrere ændringer i din proces i realtid. Det skal være sammenligneligt med det udførelsesinterval, der bruges i SIMCA-online.
Installation og opsætning
- Se SimApi-vejledningen på sartorius.com/umetrics-simapi for generelle trinvise instruktioner, der gælder ved installation af en SimApi. Dette dokument indeholder også mange tips til fejlfinding og testning ved installation af en SimApi.
- Der er indstillinger, der skal foretages i Aveva PI for at aktivere brugen af PI AF SimApi, samt mange forskellige indstillinger, der kan foretages for selve SimApi.
- Vi anbefaler, at du involverer folk fra din virksomhed, der kender din PI-infrastruktur, når du konfigurerer denne SimApi.
- Værktøjet PI System Explorer (installeret med PI AF SDK'et) lader dig se, hvordan din PI AF er konfigureret, og hjælper dig med at foretage de nødvendige indstillinger.
Konfiguration af SimApi-indstillinger
- For at ændre indstillingerne for SimApi i SIMCA-online skal du starte Serverindstillinger-værktøjet og klikke på Konfigurer… for den SimApi-instans, du vil konfigurere, under fanen SimApi.
- De samme retningslinjer gælder for SIMCA, selvom alle skærmbilleder og eksemplerampBillederne nedenfor er for SIMCA-online.
- Følgende dialogboks vises. Konfigurer de indstillinger, du har brug for til dit miljø.
- Efter gemning og afslutning skal SIMCA-online-servertjenesten genstartes for at ændringerne kan træde i kraft.

- Følgende indstillinger er tilgængelige.
| Indstilling | Forklaring |
| PI-server | Aktiverer PI-punkter med data i Umetrics Suite. Skriv navnet på den PI-server, der skal oprettes forbindelse til, og optæl PI-punkter fra. Dette er valgfrit, men hvis du udelader dette, skal AF-server angives. |
| AF-server | Aktiverer Event Frames i Umetrics Suite. Skriv navnet på den Asset Framework-server, der skal oprettes forbindelse til. Dette er valgfrit, men hvis du udelader dette, skal PI Server angives. |
| AF-database | Dirigerer Asset Framework-serveren til en bestemt database. Skriv navnet på den Asset Framework-database, der skal bruges, inden for Asset Framework-serveren. Hvis dette felt ikke er tomt, bruger SimApi'en standarddatabasen på serveren. |
| Elementkategorier | Mere end én elementkategori kan bruges til at filtrere elementerne. Adskil kategorier med et semikolon (;). Du kan også angive * for at vise alle elementer, men dette kan påvirke opstartsydelsen negativt, hvis der er mange elementer. Hvis feltet ikke er fyldt, vil ingen elementer blive vist. |
| Brugernavn | De legitimationsoplysninger, der bruges til at oprette forbindelse til PI-serverne, er angivet ovenfor. Lad feltet stå tomt for at bruge kontoen for opkaldsprocessen, typisk SIMCA-online-tjenestekontoen. |
| Adgangskode | De legitimationsoplysninger, der bruges til at oprette forbindelse til PI-servere angivet ovenfor. Lad feltet stå tomt for at bruge kontoen for opkaldsprocessen, typisk SIMCA-online-tjenestekontoen. Adgangskoden er krypteret og gemmes ikke i klartekst i konfigurationen. file. |
| Filtre til begivenhedsrammer | Du kan oprette valgfrie filternoder ved at klikke på knappen …. Disse bruges som batchnoder til at definere batches, der udføres i SIMCA Online. Se 1.2.7 ovenfor for at få mere at vide, og se næste afsnit for de tilgængelige indstillinger, du kan kontrollere. |
| Log niveau | Styrer hvor meget information der skrives til loggen file. (Fejlfinding, Information, Advarsel, Fejl, Kritisk).
Debug hjælper med at fejlfinde problemer med SimApi'en. |
| Maksimal logstørrelse (MB) | Styrer den maksimale størrelse af loggenfile før du opretter en ny. At sætte dette til 0 betyder uendelig størrelse. |
| Avancerede indstillinger | Se beskrivelserne af disse elementer i konfigurationsværktøjet. |
Indstillinger for filter til begivenhedsrammer
Event Frame-filtre eksponerer Event Frames (batches), der opfylder filterkriterierne. De kan bruges som batchnoder i SIMCA-online som beskrevet i 1.2.7.
Du kan oprette to typer af hændelsesrammefiltre:
- Efter Event Frame-attribut – disse giver dig mulighed for at oprette logiske betingelser for en eller flere hændelsesrammeattributter.
- Efter kategori for begivenhedsramme – disse giver dig mulighed for at vælge en kategori for begivenhedsrammer.
- Begge typer filtre giver dig også mulighed for at angive et referenceelement, filtrere efter navn på begivenhedsramme og angive en skabelon for begivenhedsramme.
- Hver filternode skal have et unikt navn, som du angiver. Dette er nodenavnet, der bruges i SIMCA-online under den øverste node for Event Frame Filter-noden.
- Her er en tabel, der opsummerer de forskellige indstillinger, du kan foretage i konfigurationsdialogboksene. Se også PI AF-konfigurationsdialogboksen, som har indbygget hjælp til hver indstilling.
| Indstilling | Beskrivelse | Bruges i et filter efter Event Frame-attribut | Bruges i et filter efter kategorien Event Frame |
| Node navn | Et vilkårligt navn på noden (unikt blandt andre noder). F.eks.ample, ProduktBAtcher. | X | X |
| Navnefilter | Filter baseret på navn på begivenhedsramme. Jokertegn * og ? understøttes. | X | X |
| Referenceelement | Filter baseret på elementnavn. Jokertegn * og ? understøttes. Hændelsesrammer, der refererer til dette element, returneres af filteret. | X | X |
| Skabelon til begivenhedsramme | Filtreret baseret på en specifik skabelon for begivenhedsramme. | X | X |
| Begivenhedsrammekategori | Filtrer baseret på en specifik hændelsesrammekategori. Brug * for enhver kategori. | X | |
| Attributter | Filterbaserede attributter for hændelsesrammer. Du kan angive en eller flere attributter.
For hver attribut angiver du indstillinger, der styrer et logisk udtryk, der skal evalueres til sandt for at hændelsesrammen matcher filteret. Indstillingerne for hver attribut er: |
X | |
| Attributsti | Navnet på attributten Event Frame-skabelonen. Stien skal være relativ i forhold til den angivne Event Frame-skabelon.
Værdien for denne attribut sammenlignes med indstillingen Sammenlign værdi ved hjælp af den angivne operator. |
X | |
| Operatør | Definerer typen af sammenligning, der skal foretages. F.eks.ample, Ligemænd. | X |
| Sammenlign værdi | Den værdi, der skal sammenlignes med attributværdien for Event Frames. For strengværdier kan kun operatorerne Lige med og Ikke Lige med bruges.
Mere end én værdi kan bruges, når operatoren in bruges. Adskil værdier med et semikolon (;). |
X |
Konfiguration f.eksample
- Dette afsnit giver et examphvordan PI-systemet kan se ud, og hvordan PI AF SimApi kan konfigureres til at oprette forbindelse til det.
- PI AF SimApi er allerede installeret, og PI-systemet er konfigureret til at tillade brugeren at oprette forbindelse til serveren som beskrevet i 2.
Grundlæggende konfiguration
- Her er konfigurationen for PI AF SimApi åbnet via SIMCA-online Serverindstillinger. Som du kan se, har vi foretaget et par indstillinger, som forklares nedenfor.

- Vi har én server, ServUmVM3, som er indtastet i både PI-server- og AF-serverfelterne.
- I PI kaldes vores database Production, som du kan se på skærmbilledet nedenfor, så det er også det, vi bruger i konfigurationen.

- Vi angiver også brugernavnet og adgangskoden, som PI AF SimApi bruger til at oprette forbindelse til PI AF-serverne. Denne bruger har allerede fået adgangsrettigheder til PI.
- Vi bruger en anden servicekonto til vores SIMCA-online-server. Den er anderledes, fordi den skal kunne tilgå vores Active Directory for brugergodkendelse.
- Dette er serviceegenskaberne på SIMCA-online Server-maskinen.

Valgfrie elementkategorier
- Vi angiver elementkategorierne A_Simca_Element; Other_Category. Det betyder, at vi vil se alle elementer, der matcher en af kategorierne i SIMCA-online.
- Sådan ser elementkategorien A_Simca_Element ud på PI-serveren.

Valgfrit filter for hændelsesramme 'Efter attribut'
- Vi har konfigureret en Event Frame-filternode efter attribut som følger, så den kun ser eventframes med et tankniveau under 40:
Sådan ser vores Event Frame-skabelon ud i PI:
- Vi bruger Level-attributten i vores filternode til kun at vise Event Frames med Level under 40.
Her er den første konfigurationsside for vores filternode "By Attribute":
- Vigtig: Niveauet, som vist på skærmbilledet ovenfor, skal erstattes med den fulde sti til attributten, som du kan kopiere fra PI System Explorer.
- F.eksampdet: \\servernavn\Produktion\Niveau
Her er indstillingerne for Level-attributten:
Valgfrit filter for begivenhedsramme 'efter kategori'
Endelig har vi også konfigureret en filternode, der eksponerer eventframes baseret på eventframe-kategorien Yeast.
Hvordan ser det ud i SIMCA-online
Dette er, hvad ovenstående indstillinger resulterer i i SIMCA-online.
- Her kan Element-noderne, Event Frame Filter-noderne og Event Frames-noden bruges som batchnoder i projektkonfigurationer.
- Syntetisk tags kan bruges i udførelsesbetingelser til simpel udførelse af batchprojekter. En f.eks.ampLæs mere om dette kan findes i 1.2.6.1.
- PI-serverens PI-punkter er synlige under Points-noden. Disse tags er forbundet med variabler i fasen tags side i projektkonfigurationen.

Om SIMCA-online projektudførelse og PI AF
- Dette kapitel giver en kort introduktion til, hvad SIMCA-online skal bruge for at udføre batchprojekter, og giver nogle anbefalinger, der gælder for PI Asset Framework (AF) og PI Event Frames (EF).
- For yderligere oplysninger om SIMCA-online-udførelseslogik, se SIMCA-online teknisk vejledning.
Batch-ID'er i SIMCA-online
- SIMCA-online bruger batch-ID'er på to måder.
- Batch-ID'et er en hændelsesramme defineret i PI AF.
- I SIMCA-online fortolkes disse som batches i det, der kaldes batchnoden.
- Batchnoden bruges til at identificere færdige og aktuelt aktive batches.
- Færdige batches er dem, der både har et starttidspunkt og et sluttidspunkt.
- Aktive batches er dem, der kun indeholder et starttidspunkt, med sluttidspunktet som tomt/nul.
- Batch-ID som en proces tag:
- Hver enhed, der kan behandle en fase for en batch, kræver en separat proces tag angiver den batch, der er aktiv i den pågældende enhed.
- Værdien af batch-ID'et skal matche batchnavnet i batchnoden eller, for at bruge PI-terminologien, med navnet på hændelsesrammen i PI.
Batch-nodevalg i SIMCA-online
- I aktivrammen er der et hierarki af hændelser, der er oprettet i henhold til ISA 88-batchstandarderne.
- Batchen skal forblive aktiv i alle faser, der tilhører den. For batcher med flere faser skal batchhændelsen starte ved eller før den første fase udløses og slutte ved eller efter afslutningen af den sidste fase.
- I SIMCA-online bruges uafhængige faseudførelsesbetingelser til at definere levetiden for hver fase.
- EF-batchhændelsen bruges kun til genealogi af faser, til at kortlægge hvilke aktive enheder, der tilhører hvilke batches.
- Dette muliggør sporing af parallel og kompleks materialestrøm gennem flere enheder.
I PI har hierarkiet af enheder formen:
- Batch
- Enhed
- Fase
- Underfase
- Enhed
- I SIMCA-online er der stor fleksibilitet i, hvordan batchnoder og batcher defineres og fortolkes.
F.eksample, i kromatografi, hvor:
- Hver cyklus kan defineres som en fase,
- Hver enhedsoperation (indlæsning, ligevægt, eluering osv.) kan defineres som en underfase,
- Batchnoden i SIMCA-online kunne defineres på enhedsniveau,
- Hver cyklus kunne defineres som en hændelse i EF og en batch i SIMCA-Online, og
- Hver enhedsoperation kan defineres som en underfase i EF og en fase i SIMCA-Online.
SIMCA-online udførelseslogik
Dette beskriver den rækkefølge, SIMCA-online følger for at starte batches og faser. For den fulde algoritme med alle detaljer, se SIMCA-onlines tekniske vejledning.
- SIMCA-online bestemmer de aktive batches
- a. Anmod om EF-elementerne – måske er der en særlig anmodning om kun de aktive – fra SIMCA-onlines definerede batchnode (batchnoden kan være på server- eller enhedsniveau).
- b. Aktive batches defineres som dem, der ikke har en post for sluttidspunktet (det efterlades nul/tomt).
- c. SIMCA-online registrerer navnene på de aktive batcher.
- SIMCA-online afgør, om der er aktive faser
- a. SIMCA-online anmoder om navnet på den batch, der kører i hver fase. Navnet på batchen er den værdi, der hentes fra processen. tag konfigureret som batch-ID i enheden.
- b. SIMCA-online tjekker, om navnet på batchen er på listen over aktive batcher. Det gør de ved at kontrollere, om værdien matcher navnet på en aktiv batch.
- c. SIMCA-online evaluerer den triggerlogik, der er konfigureret i SIMCA-online, for at afgøre, om fasen er aktiv.
- SIMCA-online udtrækker snapshot-værdierne for alle tags brugt af aktive faser
Støtte
- Denne SimApi er udviklet af Sartorius Data Analytics. Besøg venligst for support sartorius.com/umetrics-support
- For spørgsmål vedrørende Aveva PI, såsom Asset Framework, Event Frames, PI-sikkerhed og lignende, anbefaler vi, at du kontakter din Aveva-repræsentant eller deres tekniske support direkte.
Ofte stillede spørgsmål
- Q: Hvad er en SimApi?
- A: En SimApi er forbindelsen mellem Umetrics Suite og eksterne datakilder.
- Q: Hvad er Event Frames i SIMCA-online?
- A: Hændelsesrammer repræsenterer batches med start- og stoptidspunkter, der findes i en batch-node i SIMCA-online.
- Q: Hvor kan jeg finde mere information om SimApis?
- A: Besøg sartorius.com/umetrics-simapi for detaljerede oplysninger om SimApis og deres funktioner.
Dokumenter/ressourcer
![]() | PI AF SimApi |
Referencer
- computer.sartorius.comcomputer.sartorius.com
- sartorius.com/umetrics-simapisartorius.com
- sartorius.com/umetrics-supportsartorius.com
- sartorius.com/umetrics-simapisartorius.com
- sartorius.com/umetrics-supportsartorius.com
- techsupport.osisoft.com/Products/PI-Server/PI-AF/Overviewtechsupport.osisoft.com
- techsupport.osisoft.com/Troubleshooting/KB/KB00751techsupport.osisoft.com
- Brugermanualmanual.tools

