Brukerveiledning for SARTORIUS Sim Api-programvare

SARTORIUS Sim Api-programvare

Spesifikasjoner

• Produktnavn: SimApi Guide
• Utgivelsesdato: 5. september 2024
• Formål: Gi data til Umetrics Suite-produkter

Produktbruksinstruksjoner

Introduksjon til SimApis

• SimAPI-er brukes til å hente data for prosjektoppretting og modellbygging i Umetrics Suite-produkter.

Skaffe SimApis

• For å få tak i SimApis, se den offisielle dokumentasjonen eller kontakt kundestøtte for å få hjelp.

SimApi-funksjoner

• SimApi-er gir sanntidsdata for overvåking, kontroll og modellbygging i SIMCA og SIMCA-online.

Kun gjeldende databruk

• Det anbefales å kun bruke gjeldende data og unngå historiske data for optimal ytelse.

Forberedelse til en SimApi-installasjon

• Før installasjon må du sørge for at systemet oppfyller minimumskravene som er spesifisert i brukerhåndboken.

Installere en SimApi

• Følg de trinnvise instruksjonene i brukerhåndboken for å installere SimApi på systemet ditt.

Sette opp SimApi for SIMCA

• Konfigurer SimApi-innstillingene i SIMCA i henhold til de oppgitte retningslinjene.

Sette opp SimApi for SIMCA-online

• Sett opp SimApi for sanntids datainnhenting og tilbakeskrivingsoperasjoner i SIMCA-online.

Testing og feilsøking

• Etter installasjon, utfør testing for å sikre at den fungerer som den skal. Ved problemer, se feilsøkingsdelen i brukerhåndboken.

Testing fra SIMCA-online

• Test SimApi-integrasjonen fra SIMCA-online for å bekrefte datahenting.

Feilsøking med logg Files

• Bruk SimApi-loggen file for å identifisere og løse eventuelle installasjons- eller driftsproblemer.

Konfigurasjon av tjenestekonto

• Sørg for riktig konfigurasjon av SIMCA-online-tjenestekontoen for sømløs drift.

Tekniske detaljer

• Se avsnitt 7 i brukerhåndboken for detaljert teknisk informasjon om SimApis.

Introduksjon til SimApis

• En SimApi er et programvaregrensesnitt mellom Umetrics® Suite-programvaren og en datakilde. Hovedformålet med en SimApi er å levere data til SIMCA®-online eller SIMCA®.
• Sartorius Stedim Data Analytics AB utvikler SimApi-er for mange forskjellige datakilder, som prosesshistorikere og generelle databaser.
• Dette dokumentet viser hva en SimApi er, og hvordan den brukes i Umetrics Suite-produkter. Du lærer hvordan du planlegger og installerer en SimApi, hvordan du feilsøker og hvordan du tester installasjonen. Det siste kapittelet inneholder tekniske detaljer om SimApis rettet mot utviklere.

SimApi-formål: levere data til Umetrics Suite-produkter

• Hovedformålet med en SimApi er å levere data til SIMCA-online eller SIMCA fra en datakilde. Datakilden er ikke en del av SIMCA-online, men kan være en prosesshistoriker eller et annet system som lagrer og administrerer dataene.
• En SimApi eksponerer et hierarki av noder, som korresponderer med mapper i en file system. Hver node kan inneholde andre noder, eller tags. EN tag tilsvarer en variabel. For disse tags, kan data innhentes. Bildet viser en tag, Temp, valgt i noden
• BakersYeastControlGood i en datakilde i SIMCA-online. Den viser også de nyeste verdiene hentet fra datakilden.

SimApi-bruk i Umetrics Suite

• Desktop-programvaren SIMCA kan bruke en SimApi for å hente data for prosjektoppretting og modellbygging, slik bildet nedenfor illustrerer.
• SIMCA-online bruker SimApis for å innhente data i sanntid for overvåking og kontroll, samt skrive tilbake data til datakilden. Følgende bilde viser hvor SimApi er i et system som består av en datakilde, SIMCA-online server og klienter.

Vanlig brukte SimAPI-er

• De mest brukte SimApis er:
• PI AF SimApi for tilkobling til Aveva (tidligere OSIsoft) PI Systems.
• OPC UA SimApi
• ODBC SimApi – for generell tilgang til databaser som SQL Server eller Oracle
• Alle tilgjengelige SimApis er oppført sammen med funksjonene deres i avsnitt 3.

DBMaker SimApi for simuleringsdata

• DBMaker er et program som følger med SIMCA-online-serverinstallasjonen. Det simulerer en datakilde, for eksempel en prosesshistoriker, ved å bruke en forhåndslastet datatabell der observasjoner leveres én etter én til SIMCA-online via DBMaker SimApi.
• DBMaker brukes kun til demonstrasjonsformål og kan ikke brukes i produksjon med livedata fra en datakilde. Se den innebygde hjelpen for å lære mer om DBMaker.

Ytterligere dokumentasjon

• Dette dokumentet er ett av en rekke relaterte dokumenter, hvert med et ulikt fokus og målgruppe:

Kilde	Hva	Hvor
SIMCA-online web side	Introduksjonsinformasjon og nedlastinger	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe og installasjon.pdf	Installasjon og hvordan komme i gang med SIMCA – online demodata	I installasjons zip file
SIMCA-online implementeringsveiledning	Skisserer SIMCA-online-funksjonalitet, setter den i sammenheng med annen Umetrics Suite-programvare, beskriver krav og beste praksis for vellykket distribusjon, og trinnvise installasjonsinstruksjoner.	sartorius.com/umetrics-simca- online
SimApi-veiledning	Forberede og utføre SimApi-installasjoner, inkludert feilsøking. Inneholder også tekniske detaljer om SimApis for utviklere.	sartorius.com/umetrics-simapi
SimApi brukerveiledninger	Dokumentasjon for hver publiserte SimApi med funksjoner, installasjonsinstruksjoner og konfigurasjonsspesifikasjoner.	sartorius.com/umetrics-simapi
SIMCA-online teknisk veiledning	Teknisk referanse for planlegging av SIMCA-online-serverinstallasjon, feilsøking og grundig analyse av hvordan SIMCA-online fungerer.	sartorius.com/umetrics-simca-online
SIMCA-online hjelp	Web-basert hjelp om hvordan du bruker SIMCA-online og hvordan SIMCA-online fungerer.	I selve programvaren, og på sartorius.com/umetrics-simca
SIMCA-online Web Klientinstallasjonsveiledning	Beskriver installasjonen av SIMCA-online Web Klient.	sartorius.com/umetrics-simca-online
Kunnskapsbase for umetrics	Søkbar database med artikler om hver utgitt programvareversjon, tekniske artikler og kjente problemer i Umetrics Suite-produkter.	sartorius.com/umetrics-kb
SIMCA hjelp/brukerveiledning	Hvordan bruke desktop SIMCA for å lage prosjekter og modellere data.	I SIMCA og videre sartorius.com/umetrics-simca
Støtte web side	Hvordan få teknisk støtte.	sartorius.com/umetrics-support

Teknisk støtte

• Sartorius' nettbaserte supportteam svarer på tekniske spørsmål om SimApis og kan også videresende forespørsler om forbedringer av SimApis til de riktige personene. Finn ut mer på sartorius.com/umetrics-support.

Skaffe SimApis

• Vi tilbyr dokumentasjon for tilgjengelige SimApi-er og lenker til installasjonsprogrammer på sartorius.com/umetrics-simapi.
• Hver SimApi er dokumentert i brukerhåndboken.
• SimApi-veiledningen, som du leser nå, utfyller denne informasjonen med SimApi-utfyllende informasjon når det gjelder SimApi-planlegging, installasjon og feilsøking.

SimApi-funksjoner

• Ikke alle datakilder er like. En SimApi trenger ikke implementere alle funksjonene i spesifikasjonen. Av disse grunnene tilbyr forskjellige SimApis forskjellig funksjonalitet. Følgende matrise viser tilgjengelige SimApis og deres funksjoner.
• Funksjonene er forklart nedenfor. Legg merke til at tabellen har separate kolonner for å vise hvilke funksjoner som er tilgjengelige i henholdsvis SIMCA-online og SIMCA.

Trekk	Hensikt	SIMCA-nettbruk	SIMCA-bruk
Gjeldende data	Les én enkelt observasjon med den nyeste verdien fra datakilden.	Normal utførelse i sanntid	–
Historiske data	Les mange observasjoner på en gang med historiske data fra datakilden.	Fang opp og forutsi tidligere data, lag prosjekter ved hjelp av File > Nytt	Database Import Wizard for å importere prosessdata for modelloppretting.
Diskrete data	Les laboratorie-/IPC-data fra datakilden. Mange observasjoner per batch.	For batchprosjekter med faser eller batchbetingelser konfigurert for diskret datahenting.	–
Batchdata	Les batchbetingelser og endelige kvalitetsattributter (eller	Batchforhold eller lokal sentrering.	Databaseimportveiviser for å lese batchbetingelser for

Trekk	Hensikt	SIMCA-nettbruk	SIMCA-bruk
	andre MES-typedata). En observasjon per batch.		Oppretting av modell på batchnivå.
Batch node	Angi starttidspunkt og sluttidspunkt (tomt for en aktiv batch) for en bestemt batch. List opp alle grupper som eksisterte i et tidsperiode.	Nødvendig for utførelse av batch-konfigurasjoner.	Databaseimportveiviser for å velge batcher som skal importeres.
Skriv tilbake – kontinuerlige data	Skriv kontinuerlige data, for eksempel spådommer, tilbake til datakilden.	Skriv tilbake data fra batchutviklingsnivået, for Control Advisor eller for kontinuerlige konfigurasjoner	–
Skriv tilbake – diskret	Skriv diskrete data, for eksempel spådommer, tilbake til datakilden.	Skriv tilbake for batchkonfigurasjoner på batchutviklingsnivå for faser konfigurert for diskret datahenting	–
Skriv tilbake – batchdata	Skriv tilbake data på batchnivå, for eksempel prediksjoner eller attributter for endelig kvalitet, til datakilden.	Skriv tilbake for batchkonfigurasjon på batchnivå	–
Nodehierarki	SimApi støtter et hierarki av noder, på samme måte som en file system. Hver node kan inneholde tags og andre noder. Hierarkiet gjør det enklere å administrere et stort antall noder og tags.	Støttes på alle steder hvor tags brukes.
Array tag ekspansjon	En rekke tag lagrer flere verdier. SimApi utvider arrayet tag til mange individer tags, en for hvert element i matrisen.	Støttes hvor tags brukes til kontinuerlige data. Hver utvidet tag må tilordnes til en variabel i SIMCA-prosjektet.
Flere datakilder	SimApi kan koble til mer enn én enkelt datakilde eller støtter flere forekomster av seg selv med individuelle innstillinger og logg files for hver instans.	Koble til flere forskjellige datakilder av samme type.	–
Tilkoblingsfasthet	Hvis SimApi-en kobles fra datakilden, vil den prøve å gjenopprette forbindelsen automatisk.	SimApi-en trenger ikke å startes på nytt for å gjenopprette tilkoblinger til datakilden.	–
Utviklet internt	SimApi er utviklet, levert og støttet av

Bare nåværende data, uten historiske data, anbefales ikke

• Noen SimApis, spesielt OPC DA, støtter kun lesing av gjeldende data, og ikke historiske data.
• En SimApi som kun støtter gjeldende data kan ikke brukes i stasjonær SIMCA, fordi den ikke vil kunne lese historiske data for å bygge modellene på.
• For SIMCA-online anbefaler vi på det sterkeste en datakilde og SimApi som gir ikke bare gjeldende data for sanntidsutførelse, men også historiske data for å kunne forutsi og fange opp tidligere data. SIMCA-online bytter automatisk mellom sanntidsdata og historiske data etter behov og dette kan ikke slås av.
• En datakilde som kun gir aktuelle data, men ikke historiske data, kan fungere for kontinuerlige prosjekter i SIMCA-online, men for batchprosjekter kreves historiske data.

Forbereder for en SimApi-installasjon

• Denne delen beskriver viktig informasjon for en vellykket installasjon av en SimApi.

64-bit eller 32-bit SimApi

• Det finnes 32-biters og 64-biters versjoner av hver SimApi.
• SIMCA-online og SIMCA er 64-bit og krever 64-bit SimApi-variantene. De eldre 32-bit SimApi-ene er fortsatt tilgjengelige for eldre installasjoner.

Plassering for logg file og innstillinger

• En SimApi lagrer loggen sin files i den skjulte Programdata-mappen1:
  %programdata%\Umetrics\SimApi, der %programdata% tilordnes den faktiske mappen på datamaskinen din. Standardinnstillingen er C:\ProgramData.
• Hver SimApi bruker vanligvis sin egen logg file, som på samme måte som SIMCA-online serverloggen file vil inneholde mer eller mindre data avhengig av en loggnivåinnstilling. Dette file er nyttig for feilsøking. Loggen file er navngitt
  .logg hvor er SimApi-en du installerer, for eksempelample PIAFSimApi. Se også neste avsnitt for SIMCA-online SimApi-forekomstnavn.
• Denne mappen inneholder også SimApi-innstillingene i en XML-fil file navngitt .xml.
• De fleste SimAPI-er har grafiske brukergrensesnitt som endrer innstillingene i XML-filen. file, men for noen legger du inn endringene direkte i XML file med et tekstredigeringsprogram, for eksempel Notisblokk. Se brukerveiledningen for hver SimApi.

File navn når navngitte forekomster brukes med SIMCA-online

• I SIMCA-online får hver SimApi-instans sin egen konfigurasjon file og logg file å jobbe med flere forekomster av hver SimApi. Navnene på disse files er suffiksert med navnet på forekomsten som gitt på SimApi-fanen i SIMCA-online Server Options-dialogen.
• Følgende eksample viser navn på disse files, hvor må erstattes med SimApi-navnet.
• Konfigurasjonsnavn gitt når instansen legges til: OmegaServer
• Konfigurasjon file navn: OmegaServer.xml
• Logg file navn: OmegaServer.log
• Merk at den generiske file .logg file er fortsatt opprettet. Denne loggen file inneholder oppføringer som av tekniske årsaker ikke kan føres til loggen file av tilfellene..
• Denne mappen er skjult i Windows som standard. For å se den i File Utforsker du konfigurerer den viser skjult files. Merk at du kan navigere til en skjult mappe ved å skrive inn en adresse File Utforskerens adresselinje.
• Merk at SIMCA ikke støtter flere forekomster av SimApi, og derfor bruker navnene uten forekomstnavn som beskrevet ovenfor.

Nettverksplanlegging

• Du bør finne SIMCA-online-serveren nær datakilden i nettverket. Dette sikrer en rask forbindelse mellom SIMCA-online og datakilden.
• Nettverksutstyr kan forstyrre forbindelsen mellom SIMCA-online og datakilden.

Brukerkontoer og tillatelser til datakilder

• Datakilder kontrollerer vanligvis tilgangen til dataene sine. Dette gjøres vanligvis med brukernavn og passord, men IP-adresse- eller DNS-baserte restriksjoner kan også brukes (for eksempelample PI stoler på Aveva PI-systemet).
• Brukernavnet og passordet kan gis til datakilden på forskjellige måter:
• En SimApi kjøres som Windows-brukeren til brukeren som kjører SIMCA på skrivebordet eller SIMCA-online-tjenestekontoen på serverdatamaskinen. SimApien kan koble til datakilden ved hjelp av denne kontoen. Slik fungerer OPC I og PI SimApi, og ODBC hvis du ikke oppgir påloggingsinformasjon når du konfigurerer den.
• For generisk ODBC kan du bruke ODBC Data Sources Administrator-programmet som du finner på Start i Windows.
• Noen databaseleverandører tilbyr sine egne drivere og verktøy for databasene sine. Oracle-databaser, for eksempelample, bruk Oracle Data Access Components (ODAC).
• Noen SimAPI-er, som PI AF og ODBC, har konfigurasjonsdialoger som lagrer de krypterte legitimasjonsbeskrivelsene i SimApi XML-konfigurasjonen. file.
• PI har også diverse sikkerhetsalternativer tilgjengelig i PI System Management Tools på PI-serverdatamaskinen. Les mer i brukerhåndboken for PI AF SimApi. Denne håndboken er nyttig selv om du bruker den eldre OSIsoft PI SimApi.
• OPC DA og HDA bruker DCOM som transport mellom en datakilde og SimApi. DCOM konfigureres med Component Services-verktøyet (DCOMCNFG.EXE) i Windows og bruker Windows-autentisering.
• For den eldre OSIsoft PI SimApi (ikke den nyere AF SimApi) brukes OSIsoft AboutPI-SDK-applikasjonen (PISDKUtility.exe) til å sette opp forbindelsen til PI-serveren.

Verifiserer tilkoblingen til datakilden
Når du vil installere en SimApi på en datamaskin, kan det være nyttig å bekrefte tilkoblingen fra den datamaskinen til datakilden med et annet verktøy:

• ODBC-datakilder i Windows brukes til å konfigurere og teste generisk ODBC. Merk at det finnes to versjoner av dette verktøyet på 64-biters Windows: én for 32-biters applikasjoner og én for 64-biters. Bruk knappen Test datakilde på slutten av ODBC-konfigurasjonsveiviseren for å bekrefte tilkoblingen til databasen. Vi anbefaler at du konfigurerer datakildene dine som system-DSN-er.
• Et databasespesifikt tilkoblingsverktøy fra leverandøren av databasen, for eksempel Oracle Data Access Components.
• PI System Explorer kan brukes til å teste tilkoblingen til PI AF-serveren. Det er en del av PI AF-klienten, som er en forutsetning for PI AF SimApi.
• OPC UA Expert fra Unified Automation – UaExpert er en plattformuavhengig testklient for OPC UA-servere.
• PI-SDK-applikasjonen (PISDKUtility.exe) kan brukes til å teste tilkobling og view eventuelle feilmeldinger som kan ha blitt logget når SIMCA-online prøver å koble til PI-serveren. Dette brukes bare for den eldre OSIsoft SimApi, ikke PIAF.
• PI-systemadministrasjonsverktøy brukes på PI-serverdatamaskinen for feilsøking fra den siden. For eksempelample, for å se etter sikkerhetsproblemer som hindrer tilgang fra SIMCA-online-serveren. Lær mer om feilsøking av PI-system i denne YouTube-videoen.
• Excel kan brukes til å hente data fra en ODBC-tilkobling og de fleste andre systemer når en passende plugin er installert.
• Matrikon OPC Explorer for Ior HDA (dette er separate verktøy) kan brukes til å teste OPC-tilkobling, og Matrikon OPC Analyzer kan brukes til å diagnostisere OPC-tilkoblingsproblemer. Last ned disse gratisverktøyene fra https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (for DInd HDA) fra OPC Training Institute web nettstedet «gjør det mulig for brukere å enkelt diagnostisere kommunikasjons- og sikkerhetsproblemer, og reparere dem umiddelbart med et knappetrykk. Alt dette kan gjøres uten å måtte lære å konfigurere DCOM»

Installere en SimApi

Slik installerer du en SimApi på en PC:

1. Les brukerhåndboken for SimApi-en du installerer. Den inneholder spesifikasjoner for den SimApi-en som utfyller de generelle instruksjonene du leser nå.
2. Installer og konfigurer alle nødvendige betingelser som er nevnt i SimApi-brukerhåndboken (for eksempelamp(databasedrivere eller SDK-er)
3. Kjør installasjonsprogrammet for å installere SimApi. Installer 64-biters (x64) eller 32-biters (x86) versjonen som samsvarer med programvaren du skal kjøre den i.
4. Konfigurer SimApi i SIMCA-online eller SIMCA som beskrevet i de følgende avsnittene, og se brukerhåndboken for SimApi for beskrivelser av tilgjengelige innstillinger.
5. Start SIMCA-online-serveren. Merk at dette kan ta tid, fordi når SimApi initialiseres, vil den liste opp alle tags i datakilden.
6. Test SimApi-en ved å innhente data. For SIMCA-online kan du bruke File > Ekstraher som beskrevet i 6.1.
7. Hvis SimApi ikke fungerer som forventet, se SimApi-loggen. files for feilsøking, og til SimApi brukerveiledning.

Sette opp SimApi for bruk i SIMCA

Slik bruker du SimApi i SIMCA:

1.  Start databaseimporten på en av følgende måter:
   • a. For å opprette et nytt prosjekt i SIMCA: File > Nytt vanlig prosjekt eller Nytt batchprosjekt. Velg Fra database i Hjem-fanen.
   • b. Slik importerer du et datasett i et eksisterende prosjekt i SIMCA: Fra datasettet på Data-fanen i et åpent SIMCA-prosjekt.
2. Klikk på Legg til ny datakilde
3. Velg SimApi som tilkoblingstype, klikk på …-knappen og finn .dll i installasjonsmappen, og klikk på Åpne.
4. Klikk på Konfigurer, og se i den individuelle SimApi-brukerhåndboken hvordan du angir innstillingene.
5. Klikk på Test datakildetilkobling for å bekrefte at du kan koble til databasen. Dette kan ta lang tid hvis det er mange tags i datakilden.
6. Klikk OK for å fullføre konfigurasjonen.
7. Se SIMCA-hjelpen for hvordan du arbeider med importerte data.

Sette opp SimApi for bruk i SIMCA-online

• Viktig: For å kunne bruke en SimApi kreves en SIMCA-online serverlisens. En demoinstallasjon av SIMCA-online tillater ikke bruk av SimApis.
• For å legge til en SimApi til systemet, kjører du SIMCA-online Server Options på server-PCen. Lær detaljtrinnene i SICMA-online hjelpeemnet Legg til og konfigurer en SimApi på serveren.
• Tips: Hvis du gjør endringer for en SimApi, kan du starte den SimApi på nytt separat fra Serveralternativer uten å starte hele serveren på nytt.
• For å konfigurere flere forekomster av denne SimApi, gjenta trinnene ovenfor og bruk unike navn for hver forekomst. Les mer om den forskjellige loggen og konfigurasjonen files for tilfellene i 4.2.

Testing og feilsøking av en SimApi

• Dette kapittelet handler om testing og feilsøking av en SimApi-installasjon.

Testing av en SimApi fra SIMCA-online

• Når SIMCA-online-serveren har startet, kan du teste SimApi-en din i SIMCA-online (hvis serveren ikke starter, se 6.2):
• Logg inn på serveren i SIMCA-online-klienten, og naviger til Pakk ut på File fanen. Extract hjelper deg å teste SimApi ved å skaffe data gjennom den:
• Nodene («mappene») til SimApi vises i venstre boks. Tags for den valgte noden vises øverst til høyre.
• Gjeldende data kan testes raskt ved å klikke view> på tags som gir kontinuerlig prosessdata (se skjermbildet)
• Høyreklikk på en node for å finne grupper innenfor et tidsområde. Noden må være en gruppenode som kjenner til grupper.
• Velge tags i Pakk ut og klikk Neste og fullfør veiviseren for å hente data ved å bruke de forskjellige modusene for datainnhenting: gjeldende, historiske, batch- og diskrete data.
• Sammenlign de utpakkede dataene med det du ser i datakilden din ved å bruke verktøyene. Lær mer om testing og validering av alle funksjonene til en SimApi i 7.13.

Feilsøk SimApi-problemer ved hjelp av SimApi-loggen file

• Hvis serveren ikke starter, SimApi fungerer ikke som forventet eller uttrekk mislykkes, må du se SimApi-loggen file som forteller deg hva problemet er. Aktiver logging på feilsøkingsnivå i SimApi-loggen for å få alle detaljer. Se 4.2.
• Merk: SIMCA-online serverloggene er ikke så nyttige her. De vil vise hvordan SimApi ble lastet og initialisert av serveren, men SimApi-spesifikke detaljer er i loggen. file.

Bruk riktig SIMCA-online-tjenestekonto

• Når du tester tilgang til datakilden, husk at du er logget på som en bestemt bruker på serverdatamaskinen (vanligvis din egen brukerkonto i et Windows-domene), men at SIMCA-online-servertjenestekontoen er en annen konto, som standard LocalSystem, som har andre tilgangsrettigheter sammenlignet med brukerkontoen din.
• Av denne grunn er det ikke uvanlig at tester fungerer når de kjøres som kontoen din, men at SIMCA-online ikke klarer å koble til datakilden.
• For å løse dette problemet må tilgang gis for kontoen som brukes av SIMCA-online-servertjenesten. Vanligvis endrer du LocalSystem til en bestemt domenetjenestekonto og gir rettigheter til denne kontoen. Merk at dette ikke gjelder hvis SimApi bruker legitimasjon som er angitt i SimApi-konfigurasjonen, fordi denne legitimasjonen prioriteres.

Tekniske detaljer om SimApis

• Dette kapittelet gir tekniske detaljer om hvordan en SimApi fungerer. Det er hovedsakelig rettet mot utviklere som ønsker å forstå SimApier for å implementere en SimApi for en datakilde.
• Utviklere bør også lese de tidligere delene av dette dokumentet for en introduksjon til SimApis og til de overordnede beskrivelsene av funksjoner.

Når bør man vurdere å utvikle en SimApi, og når bør man ikke?

Før du vurderer å utvikle en SimApi for en datakilde:

1. Undersøk om det allerede finnes et SimApi du kan bruke. Kanskje du kan aktivere en funksjon i datakilden din til å bruke et av de eksisterende SimApiene, for eksempel OPC UA.
2. Gå nøye gjennom dette dokumentet og referansene, og undersøk om datakilden din oppfyller kravene: for eksempelample, det må være raskt nok, gi ikke bare gjeldende data, men også historiske data.

• Av disse grunnene anbefaler vi ikke å utvikle en SimApi som kobler seg til lavnivåmaskinvare eller instrumenter. Det er bedre å koble disse instrumentene til en prosesshistoriker som Aveva PI System, og la den hente data fra instrumentet og historisere dem. Deretter kan PIAF SimApi brukes til å hente data fra PI til Umetrics-produktet.

SimApi-utvikling og SimApi-spesifikasjonen

• SimApi-spesifikasjonen, SimApi-v2, inneholder dokumentasjon for alle C-funksjoner i SimApi som en SimApi DLL må implementere, samt veiledning for hvordan man utvikler en SimApi.
• Implementering av en SimApi ved hjelp av C eller C++ er i de fleste tilfeller på et unødvendig lavt nivå.
• Den anbefalte, og enkleste, måten å implementere en SimApi på er å basere den på ExampleSimApi kildekode som vi leverer. Det er en eksampSimApi-implementering som håndterer C-grensesnittet og oversetter det til .NET Framework, der selve implementeringen gjøres. Den har også rammeverkskode for logging, innstillinger, konfigurasjonsgrensesnitt (GUI) og annen rammeverkskode.
• For å utvikle en SimApi trenger utviklerteamet erfaring med Windows-utvikling, .NET Framework, C eller C++. God kunnskap om datakilden som SimApi-en skal koble til er også nødvendig, fordi formålet med en SimApi er å oversette dataforespørsler fra SIMCA-online eller SIMCA til API-en til datakilden. En SimApi-implementering er aldri et engangsprosjekt, men trenger vanligvis kontinuerlig støtte og sporadisk vedlikehold.

Lese eller skrive data

• En SimApi har som hovedoppgave å levere data fra en datakilde. Dette kalles å lese data.
• De fleste SimApi-implementeringer støtter også skriving av data. Dette betyr å skrive data tilbake gjennom SimApi til datakilden. Skriving av data er en valgfri funksjon i SIMCA-online.

Tags og noder

• A tag er en identifikator for en kolonne eller "variabel" i en datakilde. EN tagNavnet brukes til å identifisere tag. Navn i noden må være unike. SIMCA-online 18 er den første versjonen som støtter en node som inneholder en undernode og tag med samme navn. For eksample: noden Parent kan ha en undernode kalt Batch og en tag kalt Batch.
• En node er en beholder av tags. En node kan også inneholde andre noder, på samme måte som en file Systemet har mapper i mapper.
• Som i en file systemet, noden og tag navn kan kombineres til en fullstendig bane som unikt identifiserer en tag. De tag stier brukes i SIMCA-online eller SIMCA ved valg tags å bruke. EN tag banen starter med et SimApi-forekomstnavn etterfulgt av nodestrukturen, og slutter med tag navn, hvert element atskilt med et kolon (:). For eksample “:ODBCSQLServer:Node:SensorTag1”.

SimApi-en oppregner tags og noder ved oppstart

• En SimApi-implementering blar gjennom serveren etter noder og tags i datakilden når SimApi initialiseres og holder styr på dem slik at de ulike SimApi-funksjonene som brukes til å telle opp tags og node kan implementeres.
• SimApi-initialisering skjer ikke bare ved oppstart av serveren, men kan også utløses på nytt av en bruker i SIMCA-online med funksjonaliteten Oppdater SimApi.

Store/små bokstaver tag- og nodenavn

• Tag navn og nodenavn skiller mellom store og små bokstaver.
• Dermed en tag kalt "tag1" er ikke det samme som "Tag1" på grunn av det forskjellige tilfellet av "T". Vi anbefaler mot bruk tags eller nodenavn som bare avviker i tilfelle.

Kontinuerlig prosessnode 

• Når en node inneholder tags med kontinuerlige prosessdata kan det refereres til som en prosessnode. De følgende to skjermbildene viser en tabellrepresentasjon av en prosessnode med data etterfulgt av et bilde som viser hvordan noden ser ut når du velger tags i SIMCA-online.

Kontinuerlige prosessnoder må være uavhengige av batcher, kjøringer eller tid

• For å fungere bra i en SimApi må en node være uavhengig av batcher, kjøringer eller tid. Å ha en node som inneholder data for en bestemt batch eller et bestemt tidsområde ville ikke fungere bra i SIMCA-online fordi prosjektkonfigurasjonen da bare kunne lese data for den batchen og ikke brukes for andre batcher.
• I stedet bør en node tilordnes til én eller flere fysiske enheter i prosessen der målingene utføres.

Batch-ID tag kreves i kontinuerlige prosessnoder for batchprosjektutførelse

• Hver kontinuerlig prosess må ha en tag (variabel) som inneholder batch-identifikatoren for hver observasjon. Denne batch-identifikatoren brukes av SIMCA eller SIMCA-online for å vite hvilken batch hver observasjon tilhører.
• $BatchID-en tag i skjermbildene i 7.4.3 er et slikt eksample.
  Selv om det ikke er påkrevd, anbefales det å ha en tag i prosessnoden som viser gjeldende fase eller trinn i prosessen. Dette tag kan da brukes i faseutførelsesforhold i SIMCA-online eller i SIMCA ved import av data. Verdier for dette tag kan være for eksample "fase1", "rengjøring", "fase2".

Batch-kontekstnode

• En batchnode er en node som holder styr på batcher; deres batchidentifikatorer, starttider og sluttider. Det er et krav for batchprosjektgjennomføring i SIMCA-online. En datakilde kan ha mer enn én batchnode som eksponerer batcher på forskjellige måter. Brukeren velger batchnoden som gjelder for hans eller hennes applikasjon. Denne eksample viser batcher som spenner over to forskjellige enheter:
• /Fabrikk1 – grupper med aggregerte levetider for både Enhet1 og Enhet2.
• /Fabrikk1/Enhet1 – batcher med levetider kun i Enhet1
• /Fabrikk1/Enhet2 – batcher med levetider kun i Enhet2
• Hvis du ikke har en batchnode i datakilden din, kan du bruke Batch Context Generator i SIMCA-online. Se den innebygde hjelpen.
• Valgfrie batchdata
• En batchnode kan også inneholde batchdata; data der det kun er én observasjon for hele partiet. Merk at tags med batchdata trenger ikke være i en node som har full funksjonalitet til en batchnode. Det er nok at SimApi støtter lesing av batchdata for tagsLær mer om batchdata i 7.6.
• Her er en eksample av en batch node:
• Merk: Skjermbildet ovenfor er hentet fra DBMaker, med SIMCA-online. For å se dette selv i DBMaker, klikk på View Data-knapp på Bakers Yeast-databasen for å vise to vinduer, hvorav det ene er batchnoden, og det andre prosessdataene.

Datatyper: numeriske data, tekstdata og manglende data

• For hver tag, kan en SimApi støtte tre typer data: numeriske, tekst-, t- og manglende data:
• Numeriske data er vanligvis reelle verdier av prosessparametere, for eksempelample 6.5123. SimApi kan bare håndtere 32-bits flyttall med én presisjon. Flytallsformat med én presisjon - Wikipedia. Alle andre numeriske datatyper i en datakilde bør konverteres til flyttall. Som sådan kan de håndtere både store og små verdier, men med bare omtrent 6 eller 7 signifikante sifre. Lær mer i den tekniske veiledningen.
• Dette kan føre til tap av presisjon for store heltall eller for reelle tall som både er store og har desimaler. For mer informasjon, se den tekniske veiledningen.
• Tekst-/strengdata brukes til batch-ID-er, faseutførelsesbetingelser eller kvalitative variabler. Verdiene for tekst tag data skiller mellom store og små bokstaver. Dette betyr at verdien «running» ikke er den samme som
  «KJØRER». Dato- og klokkeslettvariabler støttes ikke direkte av SimApi, men de kan returneres som en streng formatert som ÅÅ-MM-DD TT:MM (for eksempelample “2020-09-07 13:45”).
• Manglende verdier betyr at det ikke finnes noen verdi å returnere, dvs. ingen data.
• Hvilken type som returneres er opp til SimApi-implementeringen. En SimApi kjenner til dataene i datakilden og skal returnere den datatypen som passer best.

Tre moduser for datainnhenting: Kontinuerlig, Batch-h og Diskret

• SimApi-spesifikasjonen definerer tre måter å hente data på, dvs. tre forskjellige måter SimApi kan levere data fra tags i en datakilde (eller i den andre retningen: skriv data til tags i en datakilde).
• Kontinuerlig datainnhenting – dette refererer til data som leses kontinuerlig og sekvensielt, observasjon for observasjon etter hvert som batchen eller prosessen utvikler seg. Data leses for gjeldende tidspunkt, eller for et bestemt område, med jevne mellomrom mellom observasjonene. For eksempelample, alle data mellom 09:00:00 og 10:00:00 sampledet hvert 60. sekund, noe som resulterer i 61 observasjoner når endepunktene er inkludert.
• Henting av batchdata – dette refererer til en enkelt observasjon med data for en hel batch (ikke knyttet til en spesifikk modenhet eller tidspunkt). Batchattributter og lokale sentreringsdata leses som batchdata i SIMCA-online. Batchbetingelser leses vanligvis også som batchdata (med mindre de er konfigurert for diskret datahenting).
• Diskret datainnhenting – diskrete data kan bestå av flere observasjoner for mange løpetider. Men i motsetning til kontinuerlige data leses ikke diskrete data sekvensielt, men snarere alle data samtidig for en bestemt fase av en batch. Data trenger ikke å være fordelt med regelmessige intervaller for løpetidsvariabelen. Alle data leses på nytt hver gang dataene forespurt, med det konfigurerte intervallet.
• For enhver gitt tag data kan forespørres i hvilken som helst av de tre modusene, men vanligvis vil en SimApi bare støtte en av disse modusene for en person tag. Likeledes er det lov å blande tags innenfor en node, men vanligvis alle tags innenfor en spesifikk node støtter den samme modusen for datainnhenting.
• For kontinuerlige data (men ikke for batch- eller diskrete data2), kan det gjøres forespørsler om aktuelle data eller historiske data som er temaet i neste seksjon.
• Ikke alle SimApis støtter alle moduser. Se funksjonsmatrisen ovenfor og SimApi web side for detaljer.

Gjeldende og historiske kontinuerlige data gjennom en SimApi

• Kontinuerlige data refererer til prosessdata som endres over tid.

Gjeldende data

• Å lese gjeldende data betyr å spørre datakilden om de nyeste verdiene for tags på tidspunktet for spørsmålet. Legg merke til at tidspunktet for den eksterne datakilden ikke brukes her.
• Dataene lest som gjeldende data er det SIMCA-online vil vise som live data. Av denne grunn er det viktig at det ikke oppstår unødvendige forsinkelser i datakilden. Aktuelle data bør være så ferske som mulig for å fungere godt i SIMCA-online.
• Datakilden kan bruke sin kunnskap om data og hvor lenge verdier er gyldige og bestemme seg for å returnere manglende data når rådataene for et tidspunkt er for gamle. For eksample: data forespørres klokken 15:00:00, men det siste datapunktet i datakilden er fra 03:00:00. I dette tilfellet er dataene 12 timer gamle, så SimApi kan bestemme seg for å returnere manglende verdi (ingen data).

Historiske data

• Å lese historiske data betyr å spørre datakilden om verdier på én eller flere tags for et bestemt tidsområde med et bestemt intervall mellom observasjoner. Merk at det her er datakildens lokale tid som brukes til å finne dataene. Derfor er tidssynkronisering mellom datakilde og servere viktig.
• Historiske data består av en matrise av data. Det er opp til SimApi-implementeringen å be om dataene fra datakilden, og sampla den ved det angitte intervallet og konstruer matrisen med data som skal returneres:
• Noen ganger har datakilden selv aggregeringsfunksjoner for å returnere behandlede data, ellerampling-funksjoner, som kan brukes til å returnere riktige data.
• For andre datakilder må SimApi-en be om alle data i tidsintervallet og deretterampgi de riktige observasjonene for å konstruere matrisen.
• Data må returneres for et tidsperiode, selv om det kanskje ikke finnes rådata i tidsperioden, men bare rett før starttidspunktet. For eksempelample: data finnes i datakilden på tidspunktene 10 og 20. SimApi ber om data for tidspunkt 15 og 17. I dette tilfellet skal verdiene for tidspunkt 10 returneres av SimApi, men timestamped som tid 15 og 17 siden dette var de siste datapunktene på disse tidspunktene. Verdiene for tags ved tidspunkt 10 refereres til som grenseverdier for det forespurte området. For en dypere forklaring av grenseverdier, se f.eksample dokumentasjonen for returnBounds ved UA Del 11: Historisk tilgang – 6.4.3 ReadRawModifiedDetails-struktur
  (opcfoundation.org)
• Interpolering bør aldri brukes til å beregne verdier for fremtidige tidspunkter, fordi data ikke vil samsvare med det som leses i sanntid som gjeldende data. For eksempelampfra forrige punkt: hvis data for 15 og 17 skulle interpoleres ved hjelp av verdiene for punkt 10 og 20, ville de effektivt bruke verdier fra fremtiden, noe som ikke er tillatt.
• Datakilden kan bruke sin kunnskap om data og hvor lenge verdier er gyldige og bestemme seg for å returnere manglende data når rådataene for et tidspunkt er for gamle. For eksample: data er forespurt for 15:00:00, men det nyeste datapunktet i datakilden er fra 03:00:00. I dette tilfellet er dataene 12 timer gamle, så SimApi kan bestemme seg for å returnere manglende verdi (ingen data).

Note: SIMCA-online ber vanligvis ikke om mer enn hundre observasjoner i ett kall under normal prosjektutførelse. Når man utfører uttrekk i SIMCA-online, eller når man kjører SIMCA på skrivebordet, kan større dataforespørsler gjøres. Disse kan ta lang tid, noe som er forventet.

Nåværende data og historiske data må samsvare

• Noen ganger kan det være forskjeller når data leses som gjeldende sanntidsdata eller historiske data. Dette gir problemer i SIMCA-online fordi serveren automatisk bytter mellom gjeldende og historiske data etter behov.

Datainnsamling med lav latens

• Når en datakilde brukes av SIMCA-online i sanntid, er det viktig at dataene i datakilden er aktuelle. Det skal ikke være unødvendige forsinkelser i datainnsamlingen i datakilden. Kontinuerlige prosessdata for alle variabler må være tilgjengelige samtidig for hver observasjon. Data som kommer for sent for enkelte variabler vil ikke bli plukket opp av SIMCA-online.

Data kan leses når som helst 

• Når SIMCA-online ber om en verdi på en tag For tid t vil den motta verdien fra datakilden fra tid t, eller den siste observasjonen i datakilden før tid t, eller en interpolert verdi for tid t. Dermed vil serveren alltid få en verdi hver gang den ber om den, selv om en observasjon for dette nøyaktige tidspunktet kanskje ikke finnes i datakilden.
• Tidligstamps i SimApi er alltid UTC. SIMCA-online-klienter og SIMCA presenterer tiden som lokal tid.

Tråding 

• SimApi-en kalles som standard av én enkelt tråd av brukeren av SimApi-en. Dette gjelder for alle SIMCA-versjoner og SIMCA-online frem til versjon 17.
• SIMCA-online 18 støtter et funksjonsflagg for å aktivere flertrådet tilgang gjennom SimApi. Les mer i hjelpeemnet Samtidig SimApi-tilgang.
• Dette betyr at SimApi-er bør forberede seg på flertråding, om mulig, ved å gjøre SimApi-implementasjonstråden sikker, og dokumentere dette og eventuelle hensyn for brukere av SimApi-en.

Logg file

• En SimApi skal logge handlinger, feilmeldinger og advarsler til loggen file for å hjelpe med feilsøking. Bruk de ulike loggnivåene for å angi viktigheten av loggingen.
• Det anbefales å logge «Ikke implementert» for funksjoner som ikke er implementert i en SimApi.

Feilhåndtering

• Når en SimApi ikke kan oppfylle en forespørsel fra datakilden, kan den håndtere dette problemet på en av to måter; ved å returnere manglende verdier (ingen data) eller ved å signalisere en SimApi-feil:
• Å returnere manglende verdier til innringeren og signalisere suksess lar innringeren fortsette som normalt (men selvfølgelig uten data). Dette er en anbefalt praksis for delvise feil, for eksempel når data kunne innhentes for noen, men ikke alle. tags i en forespørsel.
• Å signalisere en SimApi-feil lar den som ringer (for eksempelample SIMCA-online-serveren) for å se dette umiddelbart og handle. Dette er en anbefalt praksis for forespørsler som mislykkes fullstendig og som ikke kan returnere noen data i det hele tatt.
• SIMCA-online håndterer manglende verdier eller feilkoder annerledes, som beskrevet i SIMCA-online Technical Guide.

SimApi-ytelseskrav

• Funksjonene i SimApi brukes til å innhente data.
• Hvis datatilgangen er treg, vil ikke SimApi fungere bra, noe som denne eks.ample viser: Hvis SIMCA-online ber om data hvert sekund, men det tar to sekunder å hente, vil SIMCA-online-serveren aldri klare å holde tritt i sanntid, men gradvis falle lenger og lenger akterut.
• I underdelene viser vi hvordan SIMCA og SIMCA-online bruker SimApi-funksjonene for datatilgang og hvor ofte SimApi-funksjonene vil bli kalt opp. Dette kan hjelpe med å sette ytelseskrav for en SimApi-implementering.

SIMCAs bruk av SimApi-funksjoner

• Når stasjonære SIMCA eller andre offline-produkter bruker en SimApi for å skaffe data, vil disse forespørslene være for batcher og prosessdata for et sett med variabler i en viss tidsperiode.
• Siden disse forespørslene initieres manuelt av en bruker, skjer de ikke så ofte og forårsaker ikke en betydelig belastning på en datakilde.
• Disse SimApi-funksjonene brukes til å hente dataene:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-onlines bruk av SimApi-funksjoner

• SIMCA-online brukes til sanntidsovervåking av en prosess, og krever derfor data gjennom SimApi med jevne mellomrom. Det korteste utførelsesintervallet som kan brukes er 1 sekund. Noen ekte eksamples av utførelsesintervaller er 10 s, 1 minutt eller 10 minutter.
• En server kan ha mange prosjekter i gang samtidig.
• For å redusere antallet API-kall gjennom SimApi optimaliserer serveren dataforespørsler ved å gruppere mange samtidige mindre forespørsler til én større forespørsel for alle variabler samtidig (lær mer i hjelpeemnet «Optimalisert lesing fra datakilder forbedrer ytelsen»).
• Serverens utførelsesalgoritme fungerer slik når den ber om data ved å bruke SimApi-funksjonene som er oppført nedenfor:
• Alle faser som kjøres med samme intervall grupperes i ett enkelt SimApi-kall for å redusere antall kall. Serveren leser de nyeste dataene for alle variabler som brukes av alle modeller som deler intervallet, dvs. at dette kallet vil resultere i en bred datarad som deretter brukes av alle prosjekter.
  • simapi2_connectionReadCurrentData
• For hvert batchprosjekt må serveren også vite hvilke batcher som er aktive. Dette må også skje hver gang et prosjekt kjøres:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes kalles sjeldnere.
• I tillegg krever SIMCA-online også historiske data. Disse forespørslene skjer bare når det er nødvendig, for eksempel for å ta igjen begynnelsen av en gruppe som startet før SIMCA-online ble startet, eller når serveren henger etter og trenger å lese en datablokk:
  • simapi2_connectionReadHistoricalDataEx
• Eventuelt bruker noen prosjektkonfigurasjoner funksjoner som bruker batchdata eller diskrete data, noe som resulterer i SimApi-kall til:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Eventuelt bruker noen prosjektkonfigurasjoner tilbakeskriving for å sende data tilbake til datakilden:
  • simapi2_connectionWriteHistoricalDataEx (og tilsvarende funksjoner for batchdata, diskrete data)
• Det er viktig at hvert kall til kjernefunksjonene for å hente data, readCurrentData, getActiveBatches/getBatchTimes, er raskt og at det ikke er beregningsmessig vanskelig for selve datakilden, gitt hvor ofte SIMCA-online kan kalle disse funksjonene.

Testing og validering av SimApi-data

• Denne delen handler om å teste en SimApi for å bekrefte at dataene som returneres fra den samsvarer med data i selve datakilden. Å kjøre tester som dette er viktig etter å ha opprettet eller endret SimApi-implementering, eller når API-en til en datakilde endres.
• I praksis gjøres datavalidering ved å bruke SIMCA-online og dens Extract-funksjonalitet for å trekke data fra datakilden gjennom SimApi og deretter sammenligne med rådata i datakilden. Desktop SIMCA kan ikke brukes til å teste sanntidsaspektene til en SimApi.

Forberedelser og krav

• Noen elementer er valgfrie, men kan utføres hvis omfanget av testingen inkluderer det:

1. Installer SIMCA-online som beskrevet i ReadMe og Installation Guide.pdf som følger med i produktets zip-fil.
2. Skaff deg en lisens for SIMCA-online-serveren og installer den. SimApi-en fungerer ikke uten lisens. Kunnskapsbaseartikkelen for SIMCA-online viser hvordan du lisensierer produktet. For eksempelample: SIMCA-online 18 (sartorius.com)
3. Installer og konfigurer SimApi-en du vil teste. Se kapittel 4–5 i dette dokumentet og brukerhåndboken for den spesifikke SimApi-en.
   • a. Valgfritt: sørg for at brukerhåndboken er oppdatert og korrekt.
4. Sørg for at du har et verktøy for datakilden din som du kan bruke til å sammenligne SimApi-dataene med.
5. I SIMCA-online-skrivebordsklienten logger du deg på SIMCA-online-serveren din og bruker File > Trekk ut for å få data gjennom SimApi.
6. Valgfritt hvis testomfanget ditt inkluderer det: etter at testingen er fullført, avinstaller SimApi og bekreft den files er fjernet.

Hva som skal testes

• Funksjonsmatrisen i kapittel 3 viser alle mulige funksjoner, men en gitt SimApi-implementering støtter kanskje bare et undersett. Du bør teste alle funksjoner som er implementert av den gitte SimApi.
• Følgende tester er felles for de fleste SimApi-implementeringer:
• Autentisering med brukernavn og passord
• Test de ulike innstillingene i konfigurasjonen av SimApi
• Nodehierarki: Nodene og tags eksponert av SimApi er korrekte.
  • Det må være en tag eksponert for alle "variabler" som skal være tilgjengelige gjennom SimApi. Eksamples: prosessmålinger, beregnede verdier, konstanter.
• Tilkoblingsrobusthet: Hvis datakilden ikke er tilgjengelig, fører dette til advarsler eller feil i loggen. file, men at forbindelsen til datakilden reetableres automatisk når datakilden er tilgjengelig.
• Flere instanser: at to instanser kan konfigureres og brukes uavhengig og samtidig, med separate logger files.
• Gjeldende data: uttrekk gjeldende data for tagsSørg for at dataene er de siste kjente verdiene fra datakilden, eller at de mangler på grunn av dårlig kvalitet eller når dataene er for gamle.
  • Hent ut data hvert 10. sekund (eller så) i ett minutt.
• Historiske kontinuerlige data: uttrekk historiske data for tags.
  • Bruk tidsintervallet som samsvarer med da du hentet ut gjeldende data. Bekreft at gjeldende data samsvarer med historiske data og rådataene i datakilden.
  • Prøv forskjellige tidsintervaller og samplingintervaller, bekreft at dataene samsvarer med datakilden.
  • Prøv å trekke ut data hvert sekund, som er kortest mulig sekund.ampling intervall.
  • Prøv forskjellige typer tags i datakilden (prosessvariabler osv.), og sørg for at dataene samsvarer.
  • Merk: SIMCA-online kan dele opp en enkelt stor historisk dataforespørsel i flere mindre deler. Dette vil være synlig i SimApi-loggen.
• Bekreft at SimApi fungerer med tekstdata, numeriske data og manglende data.
• SimApi-logg fileBekreft at loggen inneholder fornuftige oppføringer.
• Batch-node: høyreklikk på en node og velg Finn grupper.
  • Bekreft batchnavn, starttider og sluttider for batcher.
  • Prøv en aktiv batch som kjører i datakilden. Den skal ikke ha en sluttid gjennom SimApi-en.
• Prosessnodebatch-identifikator tagHvis SimApi-en har batch-nodefunksjonalitet (se forrige punkt), må den også ha en batch-identifikator tag i den matchende prosessdatanoden. Data for dette tag skal være batchidentifikatoren (batchnavnet). Disse dataene kreves for batchprosjekter for å identifisere hvilken batch en rad med data tilhører.

Avhengig av om SimApi støtter det, kan det også være lurt å teste:

• Batchdata ved bruk av File > Utdrag.
• Diskrete data ved bruk av File > Trekk ut. Merk: for å teste diskrete data med File > Pakk ut noden. Batchnoden og den diskrete datanoden må være i samme SimApi (når SIMCA-online kjører prosjekter, kan de være fra forskjellige SimAPI-er).
• Skriv tilbake – sender databatch til datakilden. For å teste dette må du konfigurere en prosjektkonfigurasjon i SIMCA-online for å skrive tilbake datavektorer til datakilden. Kjør deretter prosjektet i SIMCA-online og sjekk dataene som skrives tilbake i datakilden.
• Kontinuerlige data konfigureres på Evolution Write Back-siden i prosjektkonfigurasjonen.
• Diskrete data konfigureres på samme side, men bare for en fase konfigurert for diskret datahenting.
• Batchdata fra batch-tilbakeskrivingen

MER INFO

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Sverige
• Telefon: + 46 90-18 48 00
• www.sartorius.com
• Informasjonen og figurene i disse instruksjonene samsvarer med versjonsdatoen som er spesifisert nedenfor.
• Sartorius forbeholder seg retten til å gjøre endringer i utstyrets teknologi, funksjoner, spesifikasjoner og design uten varsel. Maskuline eller feminine former brukes for å lette lesbarheten i disse instruksjonene og angir alltid alle kjønn samtidig.
  Opphavsrettserklæring:
• Disse instruksjonene, inkludert alle komponenter, er beskyttet av opphavsrett.
• Enhver bruk utover grensene for opphavsrettsloven er ikke tillatt uten vår godkjenning.
• Dette gjelder spesielt for nytrykk, oversettelse og redigering uavhengig av medietype.

FAQ

• Spørsmål: Hva er formålet med SimApis?
  • A: Hovedformålet med SimApis er å levere data til Umetrics Suite-produkter for prosjektoppretting og modellbygging.
• Spørsmål: Hvordan kan jeg feilsøke problemer med en SimApi-installasjon?
  • A: Du kan feilsøke ved å teste fra SIMCA-online, og sjekke SimApi-loggen. file, og sørge for riktig konfigurasjon av tjenestekontoen.