SARTORIUS PI AF SimApi User Guide

Navigate à a sezzione Filtru di Frame di l'Eventu in l'interfaccia SimApi.
Definite i criteri per filtrà i frame di l'eventi basati nantu à l'ora di iniziu è di fine.

À propositu di l'esecuzione di u prughjettu SIMCA-online è PI AF

Per l'esecuzione di prughjetti nantu à l'integrazione di SIMCA-online è PI AF.

Assicurà una sincronizazione curretta trà SIMCA-Online è PI AF.
Verificate u flussu di dati trà i prughjetti per una analisi precisa.

Supportu

Per qualsiasi altra assistenza o supportu, riferitevi à a guida di l'utente o cuntattate l'assistenza clienti di Sartorius Stedim Data Analytics.

Introduzione

Stu documentu hè a guida di l'utente per PI AF SimApi di Sartorius Stedim Data Analytics.
Un SimApi hè a cunnessione trà a Suite Umetrics è fonti di dati esterni.
U PI AF SimApi discrittu in questu documentu hè u cunnettore trà un sistema Aveva (prima OSIsoft) PI Asset Framework è a suluzione SIMCA®-online è a suluzione SIMCA® Multivariate Data Analysis.
Per una lista dettagliata di i cambiamenti in e diverse versioni di sta SimApi, vede a Versione Infurmazione.txt file chì vene cù l'installazione. Per più infurmazioni nantu à SimApis, vede sartorius.com/umetrics-simapi.

Termini

Nome Aveva PI	SIMCA-online terminologia
Quadru di l'Eventu (EF)	Un batch cù un tempu d'iniziu è di fine. I batch sò in un nodu Batch in SIMCA-online. Pò ancu esse una fase cù un tempu di principiu è di fine.
Attributu di u quadru di l'eventu	A tag chì cuntene dati in batch (una osservazione per batch)
Elementu di u quadru di l'assi	Unità, una cosa fisica cum'è un tank particulare, o una logica cum'è un locu, o un edifiziu.
L'attributu di l'elementu, un attributu nantu à un elementu, pò esse un puntu PI cù dati di prucessu o metadati chì descrivenu l'elementu.
Template di l'elementu di u quadru di l'assi (specifica l'attributi chì un quadru di l'eventu generatu da quellu mudellu pò avè)	Currisponde vagamente à un gruppu d'unità
Puntu PI	Tag

Features

SimApi implementa e seguenti funzionalità SimApi: Riferitevi à sartorius.com/umetrics-simapi per sapè più nantu à e funzioni generale di SimApi.
Cunnette si à un servitore Aveva PI cù supportu per valori numerichi (analogichi o discreti) è valori di testu
Cunnette si à un servitore PI AF, chì permette l'usu di Event Frames è di a ghjerarchia di l'elementi
Aduprate l'infurmazioni d'accessu furnite, o aduprate u contu di u prucessu di chjama (cum'è u contu di serviziu SIMCA-online)
Dati cuntinui attuali è storichi per i punti PI è l'attributi di l'elementu
Nodu di punti di livellu superiore chì cuntene tutti i punti PI di dati di prucessu
Dati in batch, supportu parziale
Scrittura inversa - dati cuntinui per i punti PI (micca per l'attributi di l'elementu)
Scrittura di ritornu - dati in batch, supportu parziale
Ghjerarchia di nodi opzionale di l'elementi PI AF chì currispondenu à un filtru di Categorie d'Elementi. Visualizata in u nodu Elementi di livellu superiore.
Un nodu batch in u nodu Event Frames di livellu superiore, chì mostra i frames di eventi chì si trovanu in a root in PI AF.
Filtri di quadri d'eventi opzionali chì esponenu un sottoinsieme di quadri d'eventi (batch) à SIMCA-online, secondu i criteri chì specificate.
Pudete filtrà per elementu, nome di quadru d'eventu, mudellu di quadru d'eventu, categuria di quadru d'eventu è attributi di quadru d'eventu.
Dati di batch di prucessu sinteticu tags, chì permette una faciule esecuzione di prughjetti in batch in SIMCA-Online.
Parechje istanze di SimApi ponu esse eseguite nantu à u listessu servitore SIMCA-Online
Resilienza di cunnessione - SimApi ristabilisce automaticamente a cunnessione à a fonte di dati dopu esse stata disconnessa. Alcune di queste caratteristiche sò spiegate più in dettagliu quì sottu.
L'imagine seguente hè aduprata per illustrà i cuncetti, induve i nodi evidenziati currispondenu à elementi in neru in a lista di funzioni sopra.

Gerarchia di l'elementi PI

Quandu hè cunnessu à un servitore AF, SimApi enumerarà tutti l'elementi chì currispondenu à u filtru di categurie d'elementi chì furnite quandu cunfigurate SimApi.
Più di una categuria d'elementi pò esse aduprata per filtrà l'elementi. Separate e categurie cù un puntu è virgula (;). L'elementi chì appartenenu à una categuria specificata seranu visualizati.
Pudete ancu specificà * per mustrà tutti l'elementi, ma questu pò influenzà negativamente e prestazioni di avvio s'ellu ci sò parechji elementi. Un filtru di categuria viotu significa chì nisun elementu serà espostu.
L'elementi currispundenti sò visualizati sottu à u nodu di livellu superiore Elements. A listessa struttura hè aduprata cum'è in PI System Explorer.
Nutate bè chì per espone u prucessu sinteticu tags per un elementu (vede quì sottu), deve currisponde à u filtru di categurie d'elementi. Altrimenti, l'elementu hè solu mostratu cum'è un cuntenitore d'elementi figlioli senza attributi.

Attributi di l'Elementu

L'attributi di l'elementu sò visualizati cum'è tags in u nodu Element in SIMCA-online.
L'attributi chì sò piattati o esclusi in PI ùn sò micca visualizati.
L'attributi gerarchichi sò numinati aduprendu u so percorsu relativu separatu da una barra verticale (|), cum'è vistu da l'elementu chì u cuntene. Per esempiuampvale à dì, l'attributu Temperature|Attribute1 in a screenshot sopra.

Punti PI

Sè specificate di cunnette vi à un servitore PI quandu cunfigurate SimApi, i punti PI di quellu servitore sò visualizati in u nodu di livellu superiore Punti.
I punti currispondenu à i dati tags in SIMCA-online, o variabili in SIMCA, è sò aduprate per leghje i dati di prucessu per l'esecuzione di u prugettu.

À propositu di cumu si leghjenu è si scrivenu i dati in batch

I dati in batch sò cum'è un attributu di Event Frame quandu l'Event Frame descrive un batch. Tuttavia, l'attributi di Event Frame ùn sò micca attualmente supportati da PI AF SimApi.
Invece, SimApi funziona cusì (currisponde à cumu Aveva hà implementatu u so AF SimApi):
I dati di u batch sò letti cum'è un puntu PI aduprendu l'ora di iniziu di u batch cum'è datu da l'Event Frame per sapè per quale ora leghje i dati.
I dati in batch sò scritti in un puntu PI definitu da l'utilizatore cù u tempu stamp di l'ora di iniziu di u batch cum'è data da u Quadru di l'Eventu.

Cornici di l'eventi

I frame di eventi PI, per SimApi, currispondenu à lotti o fasi in u prucessu.
Quandu un quadru d'eventu rapprisenta un batch, specifica l'ora di iniziu è di fine di u batch è hè utilizatu cum'è un nodu di batch in SIMCA-online, chì permette di monitorà i quadri d'eventu in quellu nodu in SIMCA-online, induve pudete ancu cliccà cù u dirittu per truvà i batch currispondenti, cum'è illustra sta screenshot:
Quandu un quadru d'avvenimentu rapprisenta una fase, specifica l'ora di iniziu è di fine di una fase.
Sè vo vulete monitorà tutte e fasi di u batch in SIMCA-online, pudete cunfigurà una ghjerarchia in PI in modu chì i quadri di eventi batch abbraccianu e fasi chì appartenenu à u batch.
Dopu, aduprate u quadru di l'eventu batch cum'è u nodu batch in SIMCA-Online.
I quadri di l'eventi sò esposti da SimApi in a ghjerarchia di nodi Element, u nodu di livellu superiore di i Quadri di l'eventi, è tutti i nodi di u Filtru di i Quadri di l'eventi cunfigurati.

Prucessu sinteticu tags per u nome è a durata di u quadru di l'eventu (lottu/fase/passu)

Prucessu sinteticu tags sò creati da SimApi per aiutà à simplificà l'esecuzione di u prugettu.
Questa funzione ùn funziona micca cù Event Frames simultanei (paralleli). Cusì, per ogni mumentu datu, ci deve esse solu un Event Frame attivu in u nodu batch.
sinteticu tags sò creati per u nodu Event Frames di livellu superiore, tutti i nodi Element chì currispondenu à u filtru Element Categories, è tutti i nodi Event Frame Filter (vede a prossima sezione).

sinteticu tag nomu

Scopu

U nome di u quadru d'eventu attivu u più recente in u nodu à u mumentu datu.

A durata di u più recente Event Frame attivu in u nodu à un mumentu datu.

A durata hè scalata rispettivamente in seconde, minuti, ore è ghjorni, chì vi permettenu di sceglie quella chì currisponde à i vostri bisogni di modellazione.

Nota: Batch sinteticu tags generà un overhead in SimApi, chì pò purtà à prestazioni più basse, in particulare durante u recuperu è a previsione di lotti finiti passati in SIMCA-online.

Usendu u prucessu sinteticu tags per l'esecuzione di prughjetti in batch in SIMCA-Online

In un prughjettu batch, i dati di prucessu per ogni fase devenu avè un identificatore di batch. tagDati letti in questu tag hè paragunatu cù i batch in u nodu batch specificatu per sapè se una fase deve esse eseguita.
Sè i dati di prucessu ùn anu micca un ID di batch tag, u prucessu sinteticu tags pò esse adupratu invece, postu chì i dati per quelli sò generati da a cunniscenza di u quadru di l'eventu (batch).
Per aduprà sta funziunalità, andate à a pagina Cundizioni d'esecuzione di a cunfigurazione di u prugettu in u cliente SIMCA-online è cunfigurà l'identificatore Batch. tag esse l'ID di batch sinteticu tag di u nodu di batch.
Ogni volta chì u servitore legge l'ID batch per i dati di prucessu, l'ID batch da u nodu batch serà restituitu, assicurendu chì l'unità pò esse eseguita (a cundizione d'esecuzione di fase deve ancu esse vera, cum'è di solitu in SIMCA-online).
Eccu a pagina di u nodu Batch di a cunfigurazione, chì mostra ch'ella hè listessa.

U nodu di filtru chì hè adupratu cum'è u nodu batch:

Leghjite più nantu à a logica d'esecuzione in a Guida Tecnica SIMCA-online.

Filtri di cornice d'eventi

I filtri di u quadru di l'eventu sò facultativi è devenu esse cunfigurati prima ch'elli sianu esposti da SimApi. Pudete aghjunghje quanti filtri vulete; ognunu hè cunfiguratu individualmente.
Un nodu di filtru di frame d'eventi hè utilizatu cum'è un nodu batch in SIMCA-Online per cuntrullà l'esecuzione di u prugettu. U nodu di filtru espone i frame d'eventi (batch) chì rispondenu à criteri di filtru specificati.
I nodi di filtru pupulanu ancu i valori per u sinteticu tags chì pò esse adupratu in l'esecuzione di prughjetti in batch cum'è descrittu prima.
Pudete filtrà per elementu di riferimentu, nome di quadru d'eventu, mudellu di quadru d'eventu, è sia a categuria di quadru d'eventu sia l'attributi di quadru d'eventu.

Per esampie, pudete creà filtri di cornice d'eventi per:

Quadri d'eventi chì anu l'attributu productType cù u valore di 42 sottu à l'elementu "Sweden_Site".
Quadri d'eventi chì anu u nome chì principia cù "b" è a categuria di quadri d'eventi "SIMCAonlineBatches".

Eccu un exampmodu di truvà batch in SIMCA-online in unu di i nodi chì cuntenenu Event Frames:

Prerequisites

Questa SimApi hè stata sviluppata in origine per a versione 2012 di PI System è hè stata testata nantu à diverse versioni di PI Server finu à PI Server 2018 SP3 Patch 5, à u mumentu di a scrittura.

Per utilizà u SimApi in un computer, deve avè installatu u seguente software:

L'Aveva PI AF1 SDK. Hè inclusu in u Cliente PI AF chì uttene da Aveva. SimApi hè statu sviluppatu cù a versione PI AF Client 2018 SP3 Patch-5 (versione 2.10.11.2717).
Installate sta versione o a versione più recente dispunibile. https://techsupport.osisoft.com/Products/PI-Server/PI-AF/Overview
U Microsoft Visual C++ Redistributable per Visual Studio 2015-2022. Spessu, questi sò digià installati nant'à un urdinatore (per esempiuample, sò stallati in autumàticu da SIMCA o SIMCA-online), ma s'è u SimApi ùn manca per principià per quessa, scaricà è stallà l'ultima versione da https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads

Sicurezza di u sistema Aveva PI

PI usa i cuncetti seguenti chì cuntrolanu l'accessu.
PI pò aduprà l'autentificazione Windows, ciò chì significa chì i conti Active Directory sò aduprati per cunfigurà a sicurezza.
Stu metudu hè cunsigliatu da Aveva è Sartorius Stedim Data Analytics postu ch'ellu hè l'unicu metudu per autenticassi versu l'Asset Framework SDK.
L'utilizatori PI sò utilizatori cù password create nant'à u servitore PI. I gruppi ponu esse aduprati per raggruppà l'utilizatori.
I trust PI determinanu quali urdinatori sò autorizati à cunnette si à u servitore PI. I trust sò basati nantu à l'IP, dunque, si basanu nantu à u DNS.
U servitore SIMCA-online deve esse aghjuntu à u PI trust; altrimente, ùn puderà micca cunnette si à u servitore PI.
Inoltre, i firewall di rete puderanu ancu esse cunfigurati per permette à SimApi di cunnette si à i servitori remoti.
Questi temi sò spiegati in dettagliu quì sottu. Per i dettagli, cunsultate a ducumentazione PI.

Sicurezza di Windows

I principali di sicurezza di Windows (gruppi o conti d'utilizatori) ponu esse aduprati per cunfigurà l'accessu à u servitore PI.
Duvete cunnosce u contu utilizatore utilizatu per eseguisce SimApi. Per SIMCA questu significa u contu utilizatore chì hè cunnessu à l'urdinatore, ma per SIMCA-online significa u contu di serviziu utilizatu da u serviziu di u servitore SIMCA-online (cunfiguratu in u pannellu di cuntrollu di i Servizii in Windows). Nutate bè chì u predefinitu per un servitore SIMCA-online hè di utilizà u contu di serviziu Sistema Locale. Questu deve esse cambiatu in un contu di serviziu utilizatore di duminiu per pudè cunfigurà l'accessu per ellu in PI.
Sè ùn pudete micca, per qualsiasi ragione, cambià u contu utilizatore utilizatu per eseguisce SimApi, pudete ancu cunfigurà u contu utilizatore da a finestra di cunfigurazione SimApi.
Questu permette di utilizà un contu differente per cunnette si à PI chè u contu di serviziu per SIMCA-online.
Quandu cunniscite u contu utilizatore, cunfigurate PI per permette à questu contu di cunnette si à u servitore PI.
Questu pò esse fattu assicurendusi chì l'utilizatore (o un gruppu induve l'utilizatore hè membru) sia inclusu in Security Mappings in i PI System Management Tools.

Servitori PI in un altru duminiu chè u servitore SIMCA-online

Sè u sistema PI si trova nantu à un duminiu differente da u servitore SIMCA-online, a distribuzione puderia ùn permette micca di cunfigurà una fiducia Windows trà i diversi duminii.
Una suluzione in questu casu hè di creà un contu Windows lucale sia nant'à u servitore PI AF sia nant'à u servitore SIMCA-online, postu chì tandu hè capace di risolve è autenticà u ".\UserName" passatu da una macchina à l'altra trà i duminii.

Fiducia PI

PI Trust hè un altru modu per cuncede l'accessu à PI à i nomi di l'applicazioni, i numeri IP, o i nomi di l'urdinatori. Questu hè fattu in i Strumenti di Gestione di u Sistema PI sottu Sicurezza.

Fiducie, induve pudete specificà:

Nome di l'applicazione: Un nome d'applicazione specificu pò esse adupratu per creà una fiducia.
- Per SIMCA, hè simca.exe (è simpler.exe per SIMCA prima di a versione 15).
Nota chì sta SimApi ùn funziona micca cù u vechju SDK OSIsoft PI Batch (solu PI AF cum'è descrittu sopra). Se u vostru sistema PI supporta solu PI Batch, duvete aduprà a PI SimApi sviluppata da Aveva/OSIsoft.
- Per SIMCA-online, u nome hè SIMCAonlineserver.exe, è SIMCAonlineconfig.exe (Opzioni di u servitore SIMCA-online, chì hè aduprata per fà a cunfigurazione SimApi).
Infurmazione IP: Pudete definisce una fiducia basata annantu à l'infurmazioni IP di l'urdinatore chì esegue u PI SimApi chì vulete fidà. Pudete specificà l'infurmazioni IP cum'è un percorsu di rete o indirizzu IP è maschera di rete:
Percorsu di a rete: U nome di duminiu cumpletamente qualificatu. Per esempiuample, u mo_laptop.a_mia_cumpagnia.com
Indirizzu IP: Indirizzu IP di l'urdinatore chì esegue PI AF SimApi.
NetMask: Sè specificate un indirizzu IP, duvete ancu furnisce esplicitamente una maschera di rete. Altrimenti, si genererà un errore. Sè avete bisognu di una currispundenza esatta à un indirizzu IP, specificate a maschera di rete cum'è 255.255.255.255. Sè specificate una sotturete di Classe C, specificate a maschera di rete cum'è 255.255.255.0 è u quartu campu di l'indirizzu IP cum'è 0.

Infurmazioni di u contu Windows

Dominiu Windows: Dominiu Windows di l'utilizatore chì esegue l'applicazione.
Contu Windows: Nome d'utilizatore Windows di l'utente chì esegue l'applicazione.
Hè pussibule aduprà un segnu di dollaru ($) per u nome d'utilizatore per un duminiu particulare; tandu l'utilizatori di quellu duminiu ponu cunnette si per mezu di sta fiducia à l'utilizatori PI esistenti di u listessu nome cum'è l'utilizatore Windows chì esegue l'applicazione.
Questu hè chjamatu una fiducia di segnu di dollaru.
Per cunfigurà una fiducia basata nantu à u segnu di u dollaru, di solitu impurtate prima i vostri nomi d'utilizatore è password Windows cum'è utilizatori PI.
Vede Impurtà utilizatori Windows in a ducumentazione di PI System Management Tools per PI. (U segnu di dollaru hè un valore validu per u duminiu è ancu per u nome d'utilizatore.)
Quì tutti i trè modi diffirenti per cunfigurà un PI trust sò stati aduprati in cumbinazione, ancu s'ellu hè necessariu solu unu.
Questu example trust permette i permessi per SIMCA-online da a macchina computer.sartorius.com.
Per più infurmazioni nantu à i PI Trusts, cunsultate l'aiutu per l'OSIsoft PI System Management Tools.

Firewall trà SimApi è u servitore PI

Un firewall di rete trà u SimApi chì funziona in SIMCA, o u servitore SIMCA-online, è u servitore PI pò limità u trafficu di rete in modu chì u SimApi ùn funziona micca.
Per attivà u trafficu di a rete PI, u portu TCP 5450 deve esse apertu, questu hè l'accessu nurmale à u firewall per PI. Inoltre, da u servitore AF à qualsiasi applicazione client AF, u portu TCP 5457 deve esse apertu.
Vede l'articulu di a basa di cunniscenza seguente per più dettagli: https://techsupport.osisoft.com/Troubleshooting/KB/KB00751
Per sapenne di più nantu à i requisiti di firewall per PI, cunsultate a ducumentazione PI Server / PI-SDK di Aveva. PI AF SimApi agisce cum'è una applicazione PI, dunque cercate stu termine in quellu documentu.
Utilizendu a SimApi cù solu un servitore PI AF (senza un servitore PI cunfiguratu in a SimApi)
Quandu si usa solu u servitore PI AF è l'utilizatore vole leghje l'attributi di l'elementu cunnessi à un puntu PI, SimApi ùn pò micca autenticà si contr'à u servitore PI postu chì ùn ci hè micca una tale opzione attraversu u SDK.
In questu casu, ci basemu sia nantu à ciò chì funziona u serviziu di u servitore SIMCA-online sia nantu à s'ellu ci hè una cunfigurazione di fiducia contr'à SIMCAonlineserver.exe.

Una di e ragioni di u missaghju d'errore "Impossibile d'inizializà SimApi"

U missaghju d'errore "Impossibile d'inizializà SimApi" appare quandu si clicca nantu à u buttone Configurazione in Opzioni di u Servitore. Stu prublema hè statu risoltu in PI Database Security dendu à l'identità mappata à l'accessu di scrittura di fiducia à a tabella PIMSGSS.

Ritardi in tempu reale causati da a cunfigurazione di l'interfaccia PI-à-PI

Sè i dati nant'à u servitore PI sò mandati da un altru servitore PI via una interfaccia PI à PI, ponu accade ritardi in a lettura di i dati attuali postu chì i dati sò mandati à un intervallu di tempu specificatu.
Assicuratevi chì l'intervallu di tempu cunfiguratu in l'interfaccia PI à PI sia abbastanza cortu per rilevà i cambiamenti in u vostru prucessu in tempu reale. Deve esse paragunabile à l'intervallu d'esecuzione utilizatu in SIMCA-online.

Installazione è cunfigurazione

Consultate a Guida SimApi situata à sartorius.com/umetrics-simapi per struzzioni generali passu à passu chì s'applicanu quandu si stalla una SimApi. Stu documentu cuntene ancu parechji cunsiglii di risoluzione di prublemi è di prova quandu si stalla una SimApi.
Ci sò paràmetri chì devenu esse fatti in Aveva PI per permette l'usu di PI AF SimApi, è ancu parechji paràmetri diversi chì ponu esse fatti per SimApi stessu.
Vi cunsigliemu d'implicà persone di a vostra cumpagnia chì cunnoscenu a vostra infrastruttura PI quandu cunfigurate questu SimApi.
U strumentu PI System Explorer (installatu cù u PI AF SDK) vi permette di vede cumu hè cunfiguratu u vostru PI AF è vi aiuta à fà i paràmetri necessarii.

Configurazione di i paràmetri SimApi

Per cambià i paràmetri di SimApi in SIMCA-online, lanciate l'utilità Opzioni di u servitore, è in a tabulazione SimApi, cliccate nant'à Configurate… per l'istanza SimApi chì vulete cunfigurà.
E listesse linee guida s'applicanu à SIMCA, ancu s'è tutte e screenshots è exampI fugliali quì sottu sò per SIMCA-online.
A finestra di dialogu seguente hè visualizata. Cunfigurà i paràmetri chì avete bisognu per u vostru ambiente.
Dopu avè salvatu è esse surtitu, u serviziu di u servitore SIMCA-online deve esse riavviatu per chì i cambiamenti sianu effettivi.
I seguenti paràmetri sò dispunibili.

Paràmetru	Spiegazione
Servitore PI	Permette à i punti PI cù dati d'esse dispunibili in a Suite Umetrics. Scrivite u nome di u servitore PI à quale cunnette si è enumerà i punti PI da quì. Questu hè facultativu, ma s'ellu hè lasciatu fora, u servitore AF deve esse specificatu.
Servitore AF	Attiva l'Event Frames in a Suite Umetrics. Scrivite u nome di u servitore Asset Framework à quale cunnette si. Questu hè facultativu, ma s'ellu hè lasciatu fora, u servitore PI deve esse specificatu.
Base di dati AF	Dirige u servitore Asset Framework versu una basa di dati specifica. Scrivite u nome di a basa di dati Asset Framework in u servitore Asset Framework da aduprà. S'ellu hè lasciatu viotu, SimApi aduprerà a basa di dati predefinita nantu à u servitore.
Categorie d'elementi	Più di una categuria d'elementi pò esse aduprata per filtrà l'elementi. Separate e categurie cù un puntu è virgula (;). Pudete ancu specificà * per mustrà tutti l'elementi, ma questu pò influenzà negativamente e prestazioni di avvio s'ellu ci sò parechji elementi. S'ellu hè lasciatu viotu, nisun elementu serà espostu.
Nome d'utilizatore	L'infurmazioni d'identità aduprate per cunnette si à i servitori PI sò furnite sopra. Lasciate viotu per aduprà u contu di u prucessu di chjama, tipicamente u contu di serviziu SIMCA-online.
Codice	L'infurmazioni d'identità aduprate per cunnette si à i servitori PI furniti sopra. Lasciate viotu per aduprà u contu di u prucessu di chjama, tipicamente u contu di serviziu SIMCA-online. A password hè criptata, è ùn hè micca salvata in testu chjaru in a cunfigurazione. file.
Filtri di cornice d'eventi	Pudete creà nodi di filtru opzionali clicchendu u buttone .... Quessi sò aduprati cum'è nodi batch per definisce i batch chì si eseguenu in SIMCA Online. Vede 1.2.7 sopra per sapenne di più, è vede a prossima sezione per i paràmetri dispunibili chì pudete cuntrullà.

Livellu di log	Cuntrolla a quantità d'infurmazioni scritte in u log file. (Debug, Infurmazione, Avvertimentu, Errore, Criticu). U debug aiuta à risolve i prublemi cù SimApi.
Dimensione massima di u log (MB)	Cuntrolla a dimensione massima di u logfile prima di creà una nova. Setting this to 0 significa taglia infinita.
Configurazione avanzata	Riferitevi à e descrizzioni di sti elementi in l'utilità di cunfigurazione.

Impostazioni di u filtru di u quadru di l'eventu

I filtri di Event Frame esponenu Event Frames (batch) chì rispondenu à i criteri di filtru. Puderanu esse aduprati cum'è nodi batch in SIMCA-online cum'è descrittu in 1.2.7.

Pudete creà dui tipi di filtri di cornice d'eventi:

Per Attributu di u Frame di l'Eventu – quessi vi permettenu di creà cundizioni logiche nantu à unu o più attributi di u quadru di l'eventu.
Per Categoria di Cornice d'Eventu – questi vi permettenu di selezziunà una categuria di quadru d'eventu.
Tramindui i tipi di filtri vi permettenu ancu di specificà un elementu di riferimentu, filtrà per nome di quadru d'eventu è specificà un mudellu di quadru d'eventu.
Ogni nodu di filtru deve avè un nome unicu chì furnite. Questu hè u nome di u nodu utilizatu in SIMCA-online sottu à u nodu di livellu superiore di u nodu Event Frame Filter.
Eccu una tavula chì riassume i diversi paràmetri chì pudete fà in i dialoghi di cunfigurazione. Consultate ancu u dialogu di cunfigurazione PI AF chì hà aiutu integratu per ogni paràmetru.

Paràmetru	Descrizzione	Adupratu in un filtru per Attributu di u Quadru di l'Eventu	Adupratu in un filtru per Categoria di Cornice di l'Eventu
Node Node	Un nome arbitrariu di u nodu (unicu trà l'altri nodi). Per esempiuampe.g., ProductABatches.	X	X
Filtru di nome	Filtru basatu annantu à u nome di u quadru di l'eventu. I caratteri joker * è ? sò supportati.	X	X
Elementu di Riferimentu	Filtru basatu annantu à u nome di l'elementu. I caratteri joker * è ? sò supportati. I quadri d'eventi chì facenu riferimentu à questu elementu seranu restituiti da u filtru.	X	X
Template di cornice d'eventu	Filtratu secondu un mudellu specificu di Event Frame.	X	X
Categoria di u quadru di l'eventu	Filtru basatu annantu à una categuria specifica di quadru d'eventu. Aduprate * per qualsiasi categuria.		X
Attributi	Attributi di Event Frame basati nantu à i filtri. Pudete specificà unu o più attributi. Per ogni attributu, specificate i paràmetri chì cuntrolanu una espressione logica chì deve esse valutata cum'è vera per chì u quadru di l'eventu currisponda à u filtru. I paràmetri per ogni attributu sò:	X
Percorsu di l'attributu	U nome di l'attributu di u mudellu Event Frame. U percorsu deve esse relativu à u mudellu Event Frame specificatu. U valore di questu attributu hè paragunatu cù l'impostazione Paragunà valore utilizendu l'operatore specificatu.	X
Operatore	Definisce u tipu di paragone da fà. Per esempiuample, Uguali.	X

Paragunà u valore

U valore da paragunà cù u valore di l'attributu Event Frames. Per i valori di stringa, solu l'operatori Equal è Not Equal ponu esse aduprati.

Più di un valore pò esse adupratu quandu si usa l'operatore in. Separate i valori cù un puntu è virgula (;).

Cunfigurazione example

Questa sezione dà un exampmostra cumu pò esse u sistema PI, è cumu si pò cunfigurà u PI AF SimApi per cunnette si.
U PI AF SimApi hè digià statu installatu, è u sistema PI hè statu cunfiguratu per permette à l'utilizatore di cunnette si à u servitore cum'è descrittu in 2.

Cunfigurazione basica

Eccu a cunfigurazione per PI AF SimApi aperta via l'Opzioni di u Server SIMCA-online. Cum'è pudete vede, avemu fattu uni pochi di paràmetri chì sò spiegati quì sottu.
Avemu un servitore, ServUmVM3, chì hè inseritu in i campi di u servitore PI è di u servitore AF.
In PI, a nostra basa di dati hè chjamata Production cum'è pudete vede in a screenshot quì sottu, dunque hè ciò chì usemu ancu in a cunfigurazione.
Specificemu ancu u nome d'utilizatore è a password chì PI AF SimApi usa per cunnette si à i servitori PI AF. Questu utilizatore hà digià ricevutu i diritti per accede à PI.
Adupremu un contu di serviziu differente per u nostru servitore SIMCA-online. Hè differente perchè deve esse capace di accede à u nostru Active Directory per l'autentificazione di l'utilizatori.
Queste sò e pruprietà di serviziu nantu à a macchina di u servitore SIMCA-online.

Categorie d'elementi opzionali

Specificemu e categurie d'elementi A_Simca_Element; Other_Category. Questu significa chì videremu tutti l'elementi chì currispondenu à una di e duie categurie in SIMCA-online.
Eccu cumu si prisenta a categuria d'elementi A_Simca_Element nant'à u servitore PI.

Filtru di quadru d'eventu "Per attributu" opzionale

Avemu cunfiguratu un nodu di filtru di Quadri d'Eventu per Attributu cum'è seguita, per vede solu i quadri d'eventu cù un livellu di serbatoiu sottu à 40:

Eccu cumu si prisenta u nostru mudellu di quadru d'eventu in PI:

Useremu quellu attributu Level in u nostru nodu di filtru per mustrà solu i quadri di l'eventi cù un livellu inferiore à 40.

Eccu a prima pagina di cunfigurazione per u nostru nodu di filtru Per Attributu:

Impurtante: U Livellu cum'è furnitu in a screenshot sopra deve esse rimpiazzatu cù u percorsu cumpletu di l'attributu, chì pudete copià da PI System Explorer.
Per esampLe: \\NomeServitore\Produzione\Livellu

Eccu i paràmetri per l'attributu Level:

Filtru di quadru d'eventu "per categuria" opzionale

Infine, avemu ancu cunfiguratu un nodu di Filtru chì espone i quadri di eventi basati annantu à a Categoria di Quadri di Eventi Yeast.

À chì s'assumiglia questu in SIMCA-online

Eccu ciò chì risultanu i paràmetri sopra in SIMCA-online.

Quì, i nodi Element, i nodi Event Frame Filter è u nodu Event Frames ponu esse aduprati cum'è nodi batch in e cunfigurazioni di u prugettu.
Sinteticu tags pò esse adupratu in e Cundizioni d'Esecuzione per a simplice esecuzione di prughjetti in batch. Un exampUna parte di questu si pò truvà in 1.2.6.1.
I punti PI di u servitore PI sò visibili sottu à u nodu Punti. Quessi tags sò cunnessi à e variabili in a Fase tags pagina di cunfigurazione di u prugettu.

À propositu di l'esecuzione di u prugettu SIMCA-online è PI AF

Stu capitulu dà una breve introduzione à ciò chì SIMCA-online hà bisognu per eseguisce prughjetti in batch è dà alcune raccomandazioni chì si applicanu à PI Asset Framework (AF) è PI Event Frames (EF).
Per i dettagli cumpleti nantu à a logica d'esecuzione di SIMCA-online, cunsultate a Guida Tecnica di SIMCA-online.

ID di batch in SIMCA-online

SIMCA-online usa l'ID di batch in dui modi.
L'ID di batch hè un frame di event definitu in PI AF.
- In SIMCA-online, questi sò interpretati cum'è batch in ciò chì hè chjamatu nodu batch.
- U nodu batch hè utilizatu per identificà i batch cumpletati è attualmente attivi.
- I lotti finiti sò quelli chì anu tramindui un'ora di principiu è un'ora di fine.
- I batch attivi sò quelli chì cuntenenu solu un'ora di iniziu, cù l'ora di fine viota/nullula.
ID di batch cum'è prucessu tag:
- Ogni unità chì pò trattà una fase per un batch richiede un prucessu separatu tag indicendu u batch chì hè attivu in quella unità.
- U valore di l'ID di batch deve currisponde à u nome di u batch in u nodu di batch, o, per aduprà a terminulugia PI, à u nome di u quadru di l'eventu in PI.

Selezzione di nodi in batch in SIMCA-online

In u quadru di l'attivu, ci hè una ghjerarchia d'eventi creata seguendu i standard di batch ISA 88.
U batch deve stà attivu per a durata di tutte e fasi chì appartenenu à quellu batch. Per i batch cù parechje fasi, l'eventu batch deve cumincià à o prima chì a prima fase sia attivata è finisce à o dopu à u cumpletamentu di l'ultima fase.
In SIMCA-online, e cundizioni d'esecuzione di fasi indipendenti sò aduprate per definisce a durata di vita di ogni fase.
L'eventu batch EF hè adupratu solu per a genealogia di e fasi, per mappà quale unità attive appartenenu à quale batch.
Questu permette di seguità u flussu di materiale parallelu è cumplessu attraversu parechje unità.

In PI, a ghjerarchia di l'unità piglia a forma:

Batch
- Unità
  - Fase
  - Sottofase
In SIMCA-online, ci hè assai flessibilità in u modu in cui i nodi batch è i batch sò definiti è interpretati.

Per esampvale à dì, in Cromatografia, induve:

Ogni ciclu pò esse definitu cum'è una fase,
Ogni operazione unitaria (Caricamentu, Equilibriu, Eluzione, ecc.) pò esse definita cum'è una sottufase,
U nodu batch in SIMCA-online puderia esse definitu à u livellu di l'unità,
- Ogni ciclu puderia esse definitu cum'è un avvenimentu in EF è un batch in SIMCA-Online, è
- Ogni operazione unitaria puderia esse definita cum'è una sottufase in EF è una fase in SIMCA-Online.

Logica d'esecuzione SIMCA-online

Questu descrive a sequenza chì SIMCA-online seguita per inizià i batch è e fasi. Per l'algoritmu cumpletu cù tutti i dettagli, vedi a Guida Tecnica SIMCA-online.

SIMCA-online determina i batch attivi
- a. Richiede l'articuli EF - forse ci hè una richiesta speciale solu per quelli attivi - da u nodu batch definitu di SIMCA-online (u nodu batch puderia esse à livellu di servitore o d'unità).
- b. I batch attivi sò definiti cum'è quelli chì ùn anu micca una entrata per l'ora di fine (hè lasciata nulla/vuota).
- c. SIMCA-online registra i nomi di i batch attivi.
SIMCA-online determina s'ellu ci sò fasi attive
- a. SIMCA-online dumanda u nome di u batch in esecuzione in ogni fase. U nome di u batch hè u valore recuperatu da u prucessu. tag cunfiguratu cum'è l'ID di batch in l'unità.
- b. SIMCA-online verifica se u nome di u batch hè in a lista di i batch attivi. U face verificendu se u valore currisponde à u nome di un batch attivu.
- c. SIMCA-online valuta a logica di trigger cunfigurata in SIMCA-online per determinà se a fase hè attiva.
SIMCA-online estrae i valori di l'istantanea per tutti tags adupratu da e fasi attive

Supportu

Stu SimApi hè sviluppatu da Sartorius Data Analytics. Per supportu, visitate sartorius.com/umetrics-support
Per e dumande relative à Aveva PI cum'è l'Asset Framework, l'Event Frames, a sicurità PI è simili, vi cunsigliemu di cuntattà u vostru rappresentante Aveva o u so supportu tecnicu direttamente.

FAQs

Q: Cosa hè un SimApi?
- A: Un SimApi hè a cunnessione trà a Suite Umetrics è fonti di dati esterni.
D: Chì sò i quadri d'eventi in SIMCA-online?
- A: I quadri di eventi rapprisentanu batch cù tempi di iniziu è di fine, chì residenu in un nodu Batch in SIMCA-online.
D: Induve possu truvà più infurmazioni nantu à SimApis?
- A: Visita sartorius.com/umetrics-simapi per infurmazioni dettagliate nantu à SimApis è e so caratteristiche.

Documenti / Risorse

SARTORIUS PI AF SimApi [pdfGuida di l'utente
PI AF SimApi, AF SimApi, SimApi

Referenze

Manuale d'usu

SARTORIUS PI AF SimApi

Informazione di u produttu

Istruzzioni per l'usu di u produttu