SARTORIUS Sim Api-softwarebrugervejledning

SARTORIUS Sim Api Software User Guide

sartorius-logo

SARTORIUS Sim Api-software

SARTORIUS-Sim-Api-Software-PRODUCT

Specifikationer

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

Produktbrugsvejledning

Introduktion til SimApis

  • SimApis bruges til at hente data til projektoprettelse og modelbygning i Umetrics Suite-produkter.

At få SimApis

  • For at få SimApis, se den officielle dokumentation eller kontakt kundesupport for at få hjælp.

SimApi funktioner

  • SimApis leverer realtidsdata til overvågning, kontrol og modelbygning i SIMCA og SIMCA-online.

Kun aktuelt dataforbrug

  • Det anbefales kun at bruge aktuelle data og undgå historiske data for optimal ydeevne.

Forberedelse til en SimApi-installation

  • Før installationen skal du sikre dig, at dit system opfylder de minimumskrav, der er angivet i brugervejledningen.

Installation af en SimApi

  • Følg trin-for-trin instruktionerne i brugervejledningen for at installere SimApi på dit system.

Opsætning af SimApi til SIMCA

  • Konfigurer SimApi-indstillingerne i SIMCA i henhold til retningslinjerne.

Opsætning af SimApi til SIMCA-online

  • Konfigurer SimApi til datahentning og tilbageskrivning i realtid i SIMCA-online.

Test og fejlfinding

  • Efter installationen skal du udføre test for at sikre korrekt funktionalitet. I tilfælde af problemer henvises til afsnittet om fejlfinding i brugervejledningen.

Test fra SIMCA-online

  • Test SimApi-integrationen fra SIMCA-online for at bekræfte datahentning.

Fejlfinding med Log Files

  • Brug SimApi-loggen file at identificere og løse eventuelle installations- eller driftsproblemer.

Tjenestekontokonfiguration

  • Sørg for den korrekte konfiguration af SIMCA-online-tjenestekontoen for problemfri drift.

Tekniske detaljer

  • Se afsnit 7 i brugervejledningen for dybdegående teknisk information om SimApis.

Introduktion til SimApis

  • En SimApi er en softwaregrænseflade mellem Umetrics® Suite-softwaren og en datakilde. Det primære formål med en SimApi er at levere data til SIMCA®-online eller SIMCA®.
  • Sartorius Stedim Data Analytics AB udvikler SimApis til mange forskellige datakilder, såsom proceshistorikere og generelle databaser.
  • Dette dokument viser, hvad en SimApi er, og hvordan den bruges i Umetrics Suite-produkter. Du lærer, hvordan du planlægger og installerer en SimApi, hvordan du fejlfinder, og hvordan du tester din installation. Det sidste kapitel indeholder tekniske detaljer om SimApis rettet mod udviklere.

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

  • Det primære formål med en SimApi er at levere data til SIMCA-online eller SIMCA fra en datakilde. Datakilden er ikke en del af SIMCA-online, men kan være en proceshistoriker eller et andet system, der opbevarer og administrerer dataene.
  • En SimApi afslører et hierarki af noder, svarende til mapper i en file system. Hver node kan indeholde andre noder, eller tags. EN tag svarer til en variabel. For disse tags, kan data indhentes. Billedet viser en tag, Temp, valgt i noden
  • BakersYeastControlGod i en datakilde i SIMCA-online. Den viser også de seneste værdier taget fra datakilden.SARTORIUS-Sim-Api-Software-FIG-1

SimApi-brug i Umetrics Suite

  • Desktopsoftwaren SIMCA kan bruge en SimApi til at hente data til projektoprettelse og modelbygning, som det følgende billede illustrerer.SARTORIUS-Sim-Api-Software-FIG-2
  • SIMCA-online bruger SimApis til at indhente data i realtid til overvågning og kontrol, samt skrive data tilbage til datakilden. Det følgende billede viser, hvor SimApi er i et system bestående af en datakilde, SIMCA-online server og klienter. SARTORIUS-Sim-Api-Software-FIG-3

Almindeligt brugt SimApis

  • De mest udbredte SimApis er:
  • PI AF SimApi til tilslutning til Aveva (tidligere OSIsoft) PI-systemer.
  • OPC UA SimApi
  • ODBC SimApi – til generel adgang til databaser som SQL Server eller Oracle
  • Alle tilgængelige SimApis er listet sammen med deres funktioner i afsnit 3.

DBMaker SimApi til simuleringsdata

  • DBMaker er en applikation, der følger med SIMCA-online serverinstallationen. Det simulerer en datakilde, såsom en proceshistoriker, ved at bruge en forudindlæst datatabel, hvor observationer leveres én efter én til SIMCA-online gennem DBMaker SimApi.
  • DBMaker bruges kun til demonstrationsformål og kan ikke bruges i produktion med live data fra en datakilde. Se den indbyggede hjælp for at lære mere om DBMaker.

Yderligere dokumentation

  • Dette dokument er et af et sæt af relaterede dokumenter, hver med forskellig fokus og målgruppe:
Kilde Hvad Hvor
SIMCA-online web side Introduktionsinformation og downloads sartorius.com/umetrics-simca- online
SIMCA-online ReadMe og Installation.pdf Installation og hvordan du kommer i gang med SIMCA-online demodata I installations zip file
SIMCA-online implementeringsvejledning Skitserer SIMCA-online-funktionalitet, sætter den i sammenhæng med anden Umetrics Suite-software, beskriver krav og bedste praksis for vellykket implementering og trinvise installationsinstruktioner. sartorius.com/umetrics-simca- online
SimApi guide Forberedelse til og udførelse af SimApi installationer, herunder fejlfinding. Indeholder også tekniske detaljer om SimApis for udviklere. sartorius.com/umetrics-simapi
SimApi brugervejledninger Dokumentation for hver udgivet SimApi med funktioner, installationsinstruktioner og konfigurationsspecifikationer. sartorius.com/umetrics-simapi
SIMCA-online teknisk vejledning Teknisk reference til SIMCA-online serverinstallationsplanlægning, fejlfinding og dybdegående, hvordan SIMCA-online fungerer. sartorius.com/umetrics-simca-online
SIMCA-onlinehjælp Web-baseret hjælp til, hvordan du bruger SIMCA-online, og hvordan SIMCA-online fungerer. I selve softwaren og videre sartorius.com/umetrics-simca
SIMCA-online Web Klientinstallationsvejledning Beskriver installationen af ​​SIMCA-online Web Klient. sartorius.com/umetrics-simca-online
Umetrics vidensbase Søgbar database med artikler om hver frigivet softwareversion, tekniske artikler og kendte problemer i Umetrics Suite-produkter. sartorius.com/umetrics-kb
SIMCA hjælp/brugervejledning Sådan bruger du desktop SIMCA til at oprette projekter og modellere data. I SIMCA og videre sartorius.com/umetrics-simca
Støtte web side Sådan får du teknisk support. sartorius.com/umetrics-support

Teknisk support

  • Sartorius online supportteam besvarer tekniske spørgsmål om SimApis og kan også videresende anmodninger om forbedring af SimApis til de relevante personer. Lær mere på sartorius.com/umetrics-support.

At få SimApis

  • Vi leverer dokumentation for tilgængelige SimApis og links til installationsprogrammer på sartorius.com/umetrics-simapi.
  • Hver SimApi er dokumenteret i dens brugervejledning.
  • SimApi Guiden, som du læser no,w supplerer den information med SimApi, der supplerer information, når det kommer til SimApi planlægning, installation og fejlfinding.

SimApi funktioner

  • Ikke alle datakilder er ens. En SimApi behøver ikke implementere alle funktioner i specifikationen. Af disse grunde tilbyder forskellige SimApis forskellige funktioner. Følgende matrix viser tilgængelige SimApis og deres funktioner.SARTORIUS-Sim-Api-Software-FIG-4
  • Funktionerne er forklaret nedenfor. Bemærk, at tabellen har separate kolonner for at vise, hvilke funktioner der er tilgængelige i henholdsvis SIMCA-online og SIMCA.
Feature Formål SIMCA-online brug SIMCA brug
Aktuelle data Læs en enkelt observation med den seneste værdi fra datakilden. Normal udførelse i realtid
Historiske data Læs mange observationer på én gang med historiske data fra datakilden. Indhent og forudsige tidligere data, opret projekter ved hjælp af File > Nyt Database Import Wizard til at importere procesdata til modeloprettelse.
Diskrete data Læs laboratorie-/IPC-data fra datakilden. Mange observationer pr. batch. Til batchprojekter med faser eller batchbetingelser konfigureret til diskret datahentning.
Batch data Læs batchbetingelser og endelige kvalitetsattributter (eller Batchforhold eller lokal centrering. Database Import Wizard til at læse batchbetingelser for
Feature Formål SIMCA-online brug SIMCA brug
  andre MES-type data). En observation pr. batch.   skabelse af model på batchniveau.
Batch node Angiv starttidspunktet og sluttidspunktet (tomt for en aktiv batch) for en specifik batch.

Opregn alle batches, der eksisterede i et tidsinterval.

Nødvendig til udførelse af batch-konfigurationer. Database Import Wizard til at vælge batches til import.
Skriv tilbage – løbende data Skriv kontinuerlige data, såsom forudsigelser, tilbage til datakilden. Skriv data tilbage fra batchudviklingsniveauet, til Control Advisor eller for kontinuerlige konfigurationer
Skriv tilbage – diskret Skriv diskrete data, såsom forudsigelser, tilbage til datakilden. Skriv tilbage for batchkonfigurationer på batchudviklingsniveau for faser konfigureret til diskret datahentning
Skriv tilbage – batchdata Skriv batch-niveau data, såsom forudsigelser eller endelige kvalitetsattributter, tilbage til datakilden. Skriv tilbage for batchkonfiguration på batchniveau
Node hierarki SimApi understøtter et hierarki af noder, på samme måde som en file system. Hver node kan indeholde tags og andre noder. Hierarkiet gør det nemmere at administrere et stort antal noder og tags. Understøttes alle steder hvor tags bruges.  
Array tag udvidelse En række tag gemmer flere værdier. SimApi udvider arrayet tag for mange individer tags, en for hvert element i arrayet. Understøttet hvor tags bruges til løbende data. Hver udvidet tag skal kortlægges til en variabel i SIMCA-projektet.  
Flere datakilder SimApi kan oprette forbindelse til mere end en enkelt datakilde eller understøtter flere forekomster af sig selv med individuelle indstillinger og log files for hver instans. Opret forbindelse til flere forskellige datakilder af samme slags.
Forbindelse modstandsdygtighed Hvis SimApi'en bliver afbrudt fra datakilden, vil den forsøge at genetablere forbindelsen automatisk. SimApi behøver ikke at blive genstartet for at genetablere forbindelser til datakilden.
Udviklet internt SimApi er udviklet, leveret og understøttet af    

Kun aktuelle data, uden historiske data, anbefales ikke

  • Nogle SimApis, især OPC DA, understøtter kun læsning af aktuelle data og ikke historiske data.
  • En SimApi, der kun understøtter aktuelle data, kan ikke bruges i desktop SIMCA, fordi den ikke vil være i stand til at læse historiske data, som modellerne kan bygges på.
  • Til SIMCA-online anbefaler vi kraftigt en datakilde og SimApi, der ikke kun leverer aktuelle data til realtidsudførelse, men også historiske data for at kunne forudsige og indhente tidligere data. SIMCA-online skifter automatisk mellem realtidsdata og historiske data efter behov, og dette kan ikke slås fra.
  • En datakilde, der kun leverer aktuelle data, men ikke historiske data, kan fungere til kontinuerlige projekter i SIMCA-online, men for batchprojekter kræves historiske data.

Forberedelse til en SimApi installation

  • Dette afsnit beskriver vigtig information for en vellykket installation af en SimApi.

64-bit eller 32-bit SimApis

  • Der er 32-bit og 64-bit versioner af hver SimApi.
  • SIMCA-online og SIMCA er 64-bit og kræver 64-bit SimApis-varianterne. De ældre 32-bit SimApis er stadig tilgængelige til ældre installationer.

Placering for log file og indstillinger

  • En SimApi gemmer sin log files i den skjulte Program Data-mappe1:
    %programdata%\Umetrics\SimApi, hvor %programdata% mapper til den faktiske mappe på din computer. Den er som standard C:\ProgramData.
  • Hver SimApi bruger typisk sin egen log file, som på samme måde som SIMCA-online serverlog file vil indeholde flere eller færre data afhængigt af en logniveauindstilling. Denne file er nyttig til fejlfinding. Loggen file er navngivet
    .log hvor er den SimApi, som du installerer, f.eksample PIAFSimApi. Se også næste afsnit for SIMCA-online SimApi-forekomstnavne.
  • Denne mappe indeholder også SimApi-indstillingerne i en XML file navngivet .xml.
  • De fleste SimApis har grafiske brugergrænseflader, der ændrer indstillingerne i xml file, men for nogle indtaster du ændringerne direkte i XML file med en teksteditor, såsom Notesblok. Se brugervejledningen til hver SimApi.

File navne, når navngivne forekomster bruges med SIMCA-online

  • I SIMCA-online får hver SimApi-instans sin egen konfiguration file og log file at arbejde med flere forekomster af hver SimApi. Navnene på disse files er suffikset med navnet på forekomsten som angivet på SimApi-fanen i SIMCA-online-serverindstillinger-dialogboksen.SARTORIUS-Sim-Api-Software-FIG-5
  • Følgende example viser navngivningen af ​​disse files, hvor skal erstattes med SimApi-navnet.
  • Konfigurationsnavn givet, når instansen tilføjes: OmegaServer
  • Konfiguration file navn: OmegaServer.xml
  • Log file navn: OmegaServer.log
  • Bemærk, at den generiske file .log file er stadig oprettet. Denne log file indeholder poster, der af tekniske årsager ikke kan dirigeres til loggen file af tilfældene..
  • Denne mappe er skjult i Windows som standard. At se det i File Explorer du konfigurerer den viser skjult files. Bemærk, at du kan navigere til en skjult mappe ved at indtaste en adresse File Explorers adresselinje.
  • Bemærk, at SIMCA ikke understøtter flere forekomster af SimApi, og derfor bruger navnene uden forekomstnavn som beskrevet ovenfor.

Netværksplanlægning

  • Du bør placere SIMCA-onlineserveren tæt på datakilden i netværket. Dette sikrer en hurtig forbindelse mellem SIMCA-online og dets datakilde.
  • Netværksudstyr kan forstyrre forbindelsen mellem SIMCA-online og datakilden.

Brugerkonti og datakildetilladelser

  • Datakilder kontrollerer typisk adgangen til deres data. Dette gøres normalt med brugernavne og adgangskoder, men IP-adresse- eller DNS-baserede begrænsninger kan også bruges (f.eks.ample PI har tillid til Aveva PI-systemet).
  • Brugernavnet og adgangskoden kan gives til datakilden på forskellige måder:
  • En SimApi køres som Windows-brugeren af ​​brugeren, der kører SIMCA på skrivebordet eller SIMCA-online-tjenestekontoen på servercomputeren. SimApi kan oprette forbindelse til datakilden ved hjælp af denne konto. Sådan fungerer OPC I og PI SimApi, og ODBC, hvis du ikke angiver legitimationsoplysninger, når du konfigurerer det.
  • Til generisk ODBC kan du bruge ODBC Data Sources Administrator-applikationen, der findes på Start i Windows.
  • Nogle databaseudbydere leverer deres egne drivere og værktøjer til deres databaser. Oracle-databaser, f.eksample, brug Oracle Data Access Components (ODAC).
  • Nogle SimApi'er, såsom PI AF og ODBC, har konfigurationsdialoger, der gemmer de krypterede legitimationsoplysninger i SimApi XML-konfigurationen file.
  • PI har også forskellige sikkerhedsindstillinger tilgængelige i PI System Management Tools på PI-servercomputeren. Læs mere i brugervejledningen til PI AF SimApi. Denne vejledning er nyttig, selvom du bruger den ældre OSIsoft PI SimApi.
  • OPC DA og HDA bruger DCOM som transport mellem en datakilde og SimApi. DCOM er konfigureret med værktøjet Component Services (DCOMCNFG.EXE) i Windows og bruger Windows-godkendelse.
  • For den ældre OSIsoft PI SimApi (ikke den nyere AF SimApi) bruges OSIsoft AboutPI-SDK-applikationen (PISDKUtility.exe) til at konfigurere forbindelsen til PI-serveren.

Verifikation af datakildeforbindelse
Når du vil installere en SimApi på en computer, kan det være nyttigt at verificere forbindelsen fra den computer til datakilden med et andet værktøj:

  • ODBC-datakilder i Windows bruges til at konfigurere og teste generisk ODBC. Bemærk, at der er to versioner af dette værktøj på 64-bit Windows: en til 32-bit applikationer og en til 64-bit. Brug knappen Test datakilde i slutningen af ​​ODBC-konfigurationsguiden til at bekræfte forbindelsen til databasen. Vi anbefaler, at du konfigurerer dine datakilder som system-DSN'er.
  • Et databasespecifikt forbindelsesværktøj fra udbyderen af ​​databasen, såsom Oracle Data Access Components.
  • PI System Explorer kan bruges til at teste forbindelsen til PI AF-serveren. Det er en del af PI AF Client, som er en forudsætning for PI AF SimApi.
  • OPC UA Expert fra Unified Automation – UaExpert er en testklient på tværs af platforme til OPC UA-servere.
  • PI-SDK-applikationen (PISDKUtility.exe) kan bruges til at teste forbindelse og til view eventuelle fejlmeddelelser, der måtte være blevet logget, når SIMCA-online forsøger at oprette forbindelse til PI-serveren. Dette bruges kun til den ældre OSIsoft SimApi, ikke PIAF.
  • PI-systemstyringsværktøjer bruges på PI-servercomputeren til fejlfinding fra den side. F.eksample, for at se efter sikkerhedsproblemer, der forhindrer adgang fra SIMCA-onlineserveren. Lær mere om PI-system fejlfinding i denne YouTube-video.
  • Excel kan bruges til at hente data fra en ODBC-forbindelse og de fleste andre systemer, når et passende plugin er installeret.
  • Matrikon OPC Explorer til Ior HDA (disse er separate værktøjer) kan bruges til at teste OPC-forbindelse, og Matrikon OPC Analyzer kan bruges til at diagnosticere OPC-forbindelsesproblemer. Download disse gratis værktøjer fra https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
  • OPC Rescue (til DInd HDA) fra OPC Training Institute's web site "gør det muligt for brugere nemt at diagnosticere kommunikations- og sikkerhedsproblemer og reparere dem øjeblikkeligt med et tryk på en knap. Alt dette kan gøres uden nogensinde at skulle lære at konfigurere DCOM“

Installation af en SimApi

Sådan installeres en SimApi på en pc:

  1. Læs brugervejledningen til den SimApi, du installerer. Den indeholder detaljer for den SimApi, der supplerer de generelle instruktioner, du læser nu.
  2. Installer og konfigurer alle forudsætninger nævnt i SimApi-brugervejledningen (f.eksample databasedrivere eller SDK'er)
  3. Kør installationsprogrammet for at installere SimApi. Installer 64-bit (x64) eller 32-bit (x86) versionen, der matcher den software, du vil køre den i.
  4. Konfigurer SimApi i SIMCA-online eller SIMCA som beskrevet i de følgende afsnit, og se brugervejledningen til SimApi for beskrivelser af tilgængelige indstillinger.
  5. Start SIMCA-online-serveren. Bemærk, at dette kan tage tid, for når SimApi er initialiseret, vil det opregne alle tags i datakilden.
  6. Test SimApi ved at indhente nogle data. Til SIMCA-online kan du bruge File > Udtræk som beskrevet i 6.1.
  7. Hvis SimApi'en ikke fungerer som forventet, se SimApi-loggen files til fejlfinding og til SimApi-brugervejledningen.

Opsætning af SimApi til brug i SIMCA

Sådan bruger du SimApi i SIMCA:

  1.  Start databaseimporten på en af ​​følgende måder:
    • a. Sådan opretter du et nyt projekt i SIMCA: File > Nyt almindeligt projekt eller nyt batchprojekt. Vælg Fra database på fanen Hjem.
    • b. Sådan importeres et datasæt i et eksisterende projekt i SIMCA: Fra datasæt på fanen Data i et åbent SIMCA-projekt.
  2. Klik på Tilføj ny datakildeSARTORIUS-Sim-Api-Software-FIG-6
  3. Vælg SimApi som forbindelsestype, klik på …-knappen og find .dll i installationsmappen, og klik på Åbn.
  4. Klik på Konfigurer og se den enkelte SimApi-brugervejledning, hvordan du foretager indstillingerne.
  5. Klik på Test datakildeforbindelse for at bekræfte, at du kan oprette forbindelse til databasen. Dette kan tage lang tid, hvis der er mange tags i datakilden.
  6. Klik på OK for at fuldføre konfigurationen.
  7. Se SIMCA-hjælpen for, hvordan du arbejder med importerede data.

Opsætning af SimApi til brug i SIMCA-online

  • Vigtigt: For at kunne bruge en SimApi kræves en SIMCA-online serverlicens. En demoinstallation af SIMCA-online tillader ikke brug af SimApis.
  • For at tilføje en SimApi til systemet, kører du SIMCA-online Server Options på server-pc'en. Lær detaljeringstrinene i SICMA-onlinehjælpeemnet Tilføj og konfigurer en SimApi på serveren.
  • Tip: Hvis du foretager ændringer for en SimApi, kan du genstarte den SimApi separat fra Serverindstillinger uden at genstarte hele serveren.
  • For at konfigurere flere forekomster af denne SimApi skal du gentage ovenstående trin og bruge unikke navne for hver forekomst. Læs mere om den forskellige log og konfiguration files for tilfældene i 4.2.

Test og fejlfinding af en SimApi

  • Dette kapitel handler om test og fejlfinding af en SimApi-installation.

Test af en SimApi fra SIMCA-online

  • Når SIMCA-online-serveren er blevet startet med succes, kan du teste din SimApi i SIMCA-online (hvis serveren ikke starter, se 6.2):
  • Log ind på serveren i SIMCA-online-klienten, og naviger til Udpak på File fanen. Extract hjælper dig med at teste SimApi ved at indhente data gennem det:SARTORIUS-Sim-Api-Software-FIG-7
  • SimApi'ens noder ("mapper") vises i den venstre boks. Tags for den valgte node vises øverst til højre.
  • Aktuelle data kan testes hurtigt ved blot at klikke view> på tags der giver kontinuerlige procesdata (se skærmbilledet)
  • Højreklik på en node for at finde batches inden for et tidsinterval. Noden skal være en batch node, der kender til batches.
  • Vælge tags i Udpak og klik på Næste og afslut guiden for at få data ved hjælp af de forskellige datahentningstilstande: aktuelle, historiske, batch- og diskrete data.
  • Sammenlign de udtrukne data med det, du ser i din datakilde ved hjælp af dens værktøjer. Lær mere om test og validering af alle funktioner i en SimApi i 7.13.

Fejlfind SimApi-problemer ved hjælp af SimApi-loggen file

  • Hvis serveren ikke starter, SimApi'en ikke virker som forventet eller udtrækningen mislykkes, skal du konsultere SimApi-loggen file som fortæller dig, hvad problemet er. Aktiver logning på fejlretningsniveau i SimApi-loggen for at få alle detaljer. Se 4.2.
  • Bemærk: SIMCA-online serverlogfilerne er ikke så nyttige her. De vil vise, hvordan SimApi blev indlæst og initialiseret af serveren, men SimApi-specifikke detaljer er i dens log file.

Brug den rigtige SIMCA-online-tjenestekonto

  • Når du tester adgangen til datakilden, skal du huske, at du er logget ind som en specifik bruger på servercomputeren (typisk din egen brugerkonto i et Windows-domæne), men at SIMCA-online serverservicekontoen er en anden konto, som standard LocalSystem, som har andre adgangsrettigheder sammenlignet med din brugerkonto.
  • Af denne grund er det ikke ualmindeligt, at tests fungerer, når de køres som din konto, men at SIMCA-online ikke kan oprette forbindelse til datakilden.
  • For at løse dette problem skal der gives adgang til den konto, der bruges af SIMCA-onlineservertjenesten. Typisk ændrer du LocalSystem til en specifik domænetjenestekonto og giver rettigheder til denne konto. Bemærk, at dette ikke gælder, hvis SimApi'en bruger legitimationsoplysninger, der er indstillet i SimApi-konfigurationen, fordi disse legitimationsoplysninger har forrang.

Tekniske detaljer om SimApis

  • Dette kapitel giver tekniske detaljer om, hvordan en SimApi fungerer. Det er primært rettet mod udviklere, der ønsker at forstå SimApis, at implementere en SimApi til en datakilde.
  • Udviklere bør også læse de tidligere dele af dette dokument for en introduktion til SimApis og til beskrivelser af funktioner på højt niveau.

Hvornår skal man overveje at udvikle en SimApi, og hvornår skal man ikke?

Før du overvejer at udvikle en SimApi til en datakilde:

  1. Undersøg, om der allerede er en SimApi, som du kan bruge. Måske kan du aktivere en eller anden funktion i din datakilde for at bruge en af ​​de eksisterende SimApis, såsom OPC UA.
  2. Gennemgå dette dokument og dets referencer omhyggeligt, og undersøg, om din datakilde opfylder kravene: f.eksample, det skal være hurtigt nok, give ikke kun aktuelle data, men også historiske data.
  • Af disse grunde anbefaler vi ikke at udvikle en SimApi, der forbinder til hardware eller instrumenter på lavt niveau. Det er bedre at forbinde disse instrumenter med en proceshistoriker, såsom Aveva PI System, og lade det hente data fra instrumentet og historikere det. Så kan PIAF SimApi bruges til at hente data fra PI til Umetrics produktet.

SimApi-udvikling og SimApi-specifikationen

  • SimApi-specifikationen, SimApi-v2, indeholder dokumentation for alle C-funktioner i SimApi, som en SimApi DLL skal implementere samt en vejledning til, hvordan man udvikler en SimApi.
  • Implementering af en SimApi ved hjælp af C eller C++ er i de fleste tilfælde på et unødvendigt lavt niveau.
  • Den anbefalede og nemmere måde at implementere en SimApi på er at basere den på ExampleSimApi kildekode, som vi leverer. Det er en example SimApi implementering, der håndterer C-interfacet og oversætter det til.NET Framework, hvor selve implementeringen laves. Det har også rammekode til logning, indstillinger, konfigurations-GUI og anden rammekode.
  • For at udvikle en SimApi har teamet af udviklere brug for erfaring med Windows-udvikling, .NET Framework, C eller C++. Godt kendskab til den datakilde, som SimApi'en skal forbinde til, er også påkrævet, fordi formålet med en SimApi er at oversætte dataanmodninger fra SIMCA-online eller SIMCA til datakildens API. En SimApi-implementering er aldrig et engangsprojekt, men har typisk behov for løbende support og lejlighedsvis vedligeholdelse.

Læse eller skrive data

  • En SimApi har hovedopgaven at levere data fra en datakilde. Dette kaldes læsedata.
  • De fleste SimApi-implementeringer understøtter også skrivning af data. Dette betyder at skrive data tilbage gennem SimApi til datakilden. At skrive data er en valgfri funktion i SIMCA-online.

Tags og noder

  • A tag er en identifikator for en kolonne eller "variabel" i en datakilde. EN tag's navn bruges til at identificere tag. Navne i noden skal være unikke. SIMCA-online 18 er den første version, der understøtter en node, som indeholder en undernode og tag med samme navn. F.eksample: knudepunktet Parent kan have en undernode kaldet Batch og en tag kaldet Batch.
  • En node er en beholder af tags. En node kan også indeholde andre noder, på samme måde som en file systemet har mapper i mapper.
  • Ligesom i en file system, noden og tag navne kan kombineres til en fuld sti, der unikt identificerer en tag. De tag stier bruges i SIMCA-online eller SIMCA ved valg tags at bruge. EN tag sti starter med et SimApi-forekomstnavn efterfulgt af nodestrukturen og slutter med tag navn, hvert element adskilt med et kolon (:). F.eksample “:ODBCSQLServer:Node:SensorTag1”.

SimApi opregner tags og noder ved opstart

  • En SimApi-implementering gennemser serveren efter noder og tags i datakilden, når SimApi'en initialiseres og holder styr på dem, så de forskellige SimApi-funktioner, der bruges til at optælle tags og node kan implementeres.
  • SimApi initialisering sker ikke kun ved opstart af serveren, men kan også genudløses af en bruger i SIMCA-online med Refresh SimApi funktionaliteten.

Versalfølsomhed af tag- og nodenavne

  • Tag navne og nodenavne skelner mellem store og små bogstaver.
  • Således en tag kaldet "tag1" er ikke det samme som "Tag1" på grund af det anderledes tilfælde af "T". Vi fraråder at bruge tags eller nodenavne, der kun adskiller sig i tilfælde.

Kontinuerlig proces node 

  • Når en node indeholder tags med kontinuerlige procesdata kan det omtales som en procesknude. De følgende to skærmbilleder viser en tabelrepræsentation af en procesknude med data efterfulgt af et billede, der viser, hvordan knudepunktet ser ud, når du vælger tags i SIMCA-online.SARTORIUS-Sim-Api-Software-FIG-8

Kontinuerlige procesknuder skal være uafhængige af batches, kørsler eller tid

  • For at fungere godt i en SimApi skal en node være uafhængig af batches, kørsler eller tid. At have en node, der indeholder data for en specifik batch eller et bestemt tidsinterval, ville ikke fungere godt i SIMCA-online, fordi projektkonfigurationen så kun kunne læse data for den batch og ikke bruges til andre batches.
  • I stedet bør en node kortlægges til en eller flere fysiske enheder i den proces, hvor målinger udføres.

Batch ID tag kræves i kontinuerlige procesknudepunkter til batchprojektudførelse

  • Hver kontinuerlig proces skal have en tag (variabel) med batchidentifikationen for hver observation. Denne batchidentifikator bruges af SIMCA eller SIMCA-online til at vide, hvilken batch hver observation tilhører.
  • $BatchID tag i skærmbillederne i 7.4.3 er sådan et example.
    Selvom det ikke er nødvendigt, anbefales det at have en tag i procesknudepunktet, der viser den aktuelle fase eller trin i processen. Denne tag kan så bruges i faseudførelsesforhold i SIMCA-online eller i SIMCA ved import af data. Værdier for dette tag kan være f.eksample "fase1", "rengøring", "fase2".

Batch kontekst node

  • En batch node er en node, der holder styr på batches; deres batch-id'er, starttider og sluttider. Det er et krav for batchprojektudførelse i SIMCA-online. En datakilde kan have mere end én batchnode, der eksponerer batches på forskellige måder. Brugeren vælger den batch node, der gælder for hans eller hendes applikation. Denne example afslører batches, der spænder over to forskellige enheder:
  • /Factory1 –batches med aggregerede levetider over både Unit1 og Unit2.
  • /Factory1/Unit1 – batches med levetider kun i Unit1
  • /Factory1/Unit2 – batches med levetider kun i Unit2
  • Hvis du ikke har en batch node i din datakilde, kan du bruge Batch Context Generator i SIMCA-online. Se den indbyggede hjælp.
  • Valgfri batchdata
  • En batchnode kan også indeholde batchdata; data, for hvilke der kun er én observation for hele partiet. Bemærk det tags med batch-data behøver ikke være i en node, der har den fulde funktionalitet af en batch-node. Det er nok, at SimApi understøtter læsning af batchdata for tags. Lær mere om batchdata i 7.6.
  • Her er en example af en batch node:SARTORIUS-Sim-Api-Software-FIG-9
  • Bemærk: Ovenstående skærmbillede er taget fra DBMaker, bundtet med SIMCA-online. For at se dette selv i DBMaker, klik på View Data-knap på Bakers Yeast-databasen for at vise to vinduer, hvoraf det ene er batch-noden, og det andet procesdataene.

Datatyper: numeriske data, tekstdata og manglende data

  • For hver tag, kan en SimApi understøtte tre typer data: numerisk, tekst, t og mangler:
  • Numeriske data er typisk reelle værdier af procesparametre, f.eksample 6.5123. SimApi kan kun håndtere 32-bit enkelt præcision flydende kommaværdier. Enkelt-præcision flydende-komma-format -Wikipedia. Alle andre numeriske datatyper i en datakilde skal konverteres til float. Som sådan kan de håndtere både store og små værdier, men med kun omkring 6 eller 7 signifikante cifre. Lær mere i den tekniske vejledning.
  • Dette kan føre til tab af præcision for store heltal eller for reelle tal, der både er store og har decimaler. For mere information, se den tekniske vejledning.
  • Tekst/strengdata bruges til batch-id'er, faseudførelsesbetingelser eller til kvalitative variabler. Værdierne for tekst tag data er store og små bogstaver. Det betyder, at værdien "kører" ikke er den samme som
    "LØB". Datetime-variabler understøttes ikke direkte af SimApi, men de kan returneres som en streng formateret som ÅÅ-MM-DD TT:MM (f.eks.ample “2020-09-07 13:45”).
  • Manglende værdier betyder, at der ikke er nogen værdi at returnere, dvs. ingen data.
  • Hvilken type der returneres er op til SimApi-implementeringen. En SimApi kender til dataene i datakilden og bør returnere den datatype, der passer bedst.

Tre måder at hente data på: Kontinuerlig, Batc,h og Diskret

  • SimApi-specifikationen definerer tre måder at hente data på, dvs. tre forskellige måder, SimApi'en kan levere data fra tags i en datakilde (eller i den anden retning: skriv data til tags i en datakilde).
  • Kontinuerlig datahentning – dette refererer til data, der læses kontinuerligt og sekventielt, observation pr. observation, efterhånden som batchen eller processen udvikler sig. Data aflæses for det aktuelle tidspunkt eller for et specifikt interval med et regelmæssigt interval mellem observationerne. F.eksample, alle data mellem 09:00:00 og 10:00:00 sampled hvert 60. sekund, hvilket resulterer i 61 observationer, når slutpunkter er inklusive.
  • Batchdatahentning – dette refererer til en enkelt observation med data for en hel batch (ikke forbundet med et specifikt modenheds- eller tidspunkt). Batchattributter og lokale centreringsdata læses som batchdata i SIMCA-online. Batchbetingelser læses normalt også som batchdata (medmindre de er konfigureret til diskret datahentning).
  • Diskret datahentning – diskrete data kan bestå af flere observationer for mange løbetider. Men i modsætning til kontinuerlige data læses diskrete data ikke sekventielt, men snarere alle data på én gang for en bestemt fase af en batch. Data behøver ikke at være fordelt med regelmæssige intervaller af modenhedsvariablen. Alle data genlæses hver gang der anmodes om data, med det konfigurerede interval.
  • For enhver given tag data kan anmodes om i enhver af de tre tilstande, men typisk vil en SimApi kun understøtte en af ​​disse tilstande for en person tag. Ligeledes er det tilladt at blande tags inden for en node, men typisk alle tags inden for en specifik node understøtter den samme metode til datahentning.
  • For løbende data (men ikke for batch- eller diskrete data2) kan der anmodes om aktuelle data eller historiske data, som er emnet for næste afsnit.
  • Ikke alle SimApis understøtter alle tilstande. Se funktionsmatrixen ovenfor og SimApi web side for detaljer.

Aktuelle og historiske kontinuerlige data gennem en SimApi

  • Kontinuerlige data refererer til procesdata, der ændrer sig over tid.

Aktuelle data

  • At læse aktuelle data betyder at bede datakilden om de seneste værdier af tags på tidspunktet for spørgsmålet. Bemærk, at tidspunktet for den eksterne datakilde ikke bruges her.
  • Dataene læst som aktuelle data er, hvad SIMCA-online vil vise som live data. Af denne grund er det vigtigt, at der ikke er unødvendige forsinkelser i datakilden. Aktuelle data skal være så nye som muligt for at fungere godt i SIMCA-online.
  • Datakilden kan bruge sin viden om data og hvor længe værdier er gyldige og beslutte at returnere manglende data, når de rå data for et tidspunkt er for gamle. F.eksample: data anmodes kl. 15:00:00, men det seneste datapunkt i datakilden er fra kl. 03:00:00. I dette tilfælde er dataene 12 timer gamle, så SimApi kan beslutte at returnere manglende værdi (ingen data).

Historiske data

  • At læse historiske data betyder at bede datakilden om værdier på en eller flere tags for et bestemt tidsinterval med et bestemt interval mellem observationer. Bemærk, at her er det datakildens lokale tid, der bruges til at finde dataene. Derfor er tidssynkronisering mellem datakilde og servere vigtig.
  • Historiske data består af en matrix af data. Det er op til SimApi-implementeringen at anmode om dataene fra datakilden, og samplæg det med det angivne interval og konstruer matrixen af ​​data til at returnere:
  • Nogle gange har datakilden selv aggregeringsfunktioner til at returnere behandlede data, eller sampling-funktioner, der kan bruges til at returnere de rigtige data.
  • For andre datakilder skal SimApi anmode om alle data i tidsintervallet og derefter sampde rigtige observationer til at konstruere matrixen.
  • Data skal returneres for et tidsinterval, selvom der muligvis ikke er rådata i tidsintervallet, men kun lige før starttidspunktet. F.eksample: data eksisterer i datakilden på tidspunkterne 10 og 20. SimApi'en anmoder om data for tid 15 og 17. I dette tilfælde skal værdierne for tidspunkt 10 returneres af SimApi'en, men timetamped som tidspunkt 15 og 17, da disse var de seneste datapunkter på disse tidspunkter. Værdierne for tags på tidspunktet 10 omtales som grænseværdier for det anmodede område. For en dybere forklaring af grænseværdier, se f.eksamplæs dokumentationen for returnBounds på UA Part 11: Historical Access – 6.4.3 ReadRawModifiedDetails-struktur
    (opcfoundation.org)
  • Interpolation bør aldrig bruges til at beregne værdier for fremtidige tidspunkter, fordi data ikke vil matche det, der læses i realtid som aktuelle data. For eksample fra den forrige punktopstilling: hvis data for 15 og 17 skulle interpoleres ved hjælp af værdierne for punkt 10 og 20, ville de reelt bruge værdier fra fremtiden, hvilket ikke er tilladt.
  • Datakilden kan bruge sin viden om data og hvor længe værdier er gyldige og beslutte at returnere manglende data, når de rå data for et tidspunkt er for gamle. F.eksample: data anmodes om kl. 15:00:00, men det seneste datapunkt i datakilden er fra kl. 03:00:00. I dette tilfælde er dataene 12 timer gamle, så SimApi kan beslutte at returnere manglende værdi (ingen data).

Note: SIMCA-online anmoder typisk ikke om mere end hundrede observationer i et opkald under normal projektudførelse. Når du laver udtræk i SIMCA-online, eller når du kører desktop SIMCA, kan der foretages større anmodninger om data. Disse kan tage lang tid, hvilket må forventes.

Aktuelle data og historiske data skal matche

  • Nogle gange kan der være forskelle, når data læses som aktuelle aktuelle data eller historiske data. Dette giver problemer i SIMCA-online, fordi serveren automatisk skifter mellem aktuelle og historiske data efter behov.

Dataindsamling med lav latens

  • Når en datakilde bruges af SIMCA-online i realtid, er det vigtigt, at dataene i datakilden er aktuelle. Der bør ikke være unødvendige forsinkelser i dataindsamlingen i datakilden. Kontinuerlige procesdata for alle variable skal være tilgængelige på samme tid for hver observation. Data, der kommer for sent for nogle variabler, vil ikke blive samlet op af SIMCA-online.

Data kan læses til enhver tid 

  • Når SIMCA-online beder om en værdi på en tag for tidspunkt t vil den modtage værdien fra datakilden fra tidspunkt t, eller den seneste observation i datakilden før tidspunkt t, eller en interpoleret værdi for tidspunkt t. Serveren vil således altid få en værdi, hver gang den beder om, selvom en observation for dette nøjagtige tidspunkt muligvis ikke eksisterer i datakilden.
  • Tidligstamps i SimApi er altid UTC. SIMCA-online-klienter og SIMCA præsenterer tiden som lokal tid.

Trådning 

  • SimApi kaldes som standard af en enkelt tråd af brugeren af ​​SimApi. Dette gælder for alle SIMCA-versioner og SIMCA-online indtil version 17.
  • SIMCA-online 18 understøtter et funktionsflag til at aktivere multi-threaded-adgang via SimApi. Læs mere i hjælpeemnet Samtidig SimApi-adgang.
  • Det betyder, at SimApis bør forberede sig på multi-threading, hvis det er muligt, ved at gøre SimApi implementeringstråden sikker og dokumentere dette og eventuelle overvejelser for brugere af SimApi.

Log file

  • En SimApi skal logge handlinger, fejlmeddelelser og advarsler til sin log file for at hjælpe med fejlfinding. Brug de forskellige logniveauer til at markere vigtigheden af ​​logningen.
  • Det anbefales at logge "Ikke implementeret" for funktioner, der ikke er implementeret i en SimApi.

Fejlhåndtering

  • Når en SimApi ikke kan opfylde en anmodning fra datakilden, kan den håndtere dette problem på en af ​​to måder; ved at returnere manglende værdier (ingen data) eller ved at signalere en SimApi-fejl:
  • At returnere manglende værdier til den, der ringer og signalere succes, gør det muligt for den, der ringer, at fortsætte som normalt (men selvfølgelig uden nogen data). Dette er en anbefalet praksis for delvise fejl, såsom når data kunne indhentes for nogle, men ikke alle, tags i en anmodning.
  • Signalering af en SimApi-fejl gør det muligt for den, der ringer op (f.eksamppå SIMCA-online-serveren) for at se dette med det samme og handle. Dette er en anbefalet praksis for anmodninger, der mislykkes fuldstændigt og slet ikke kan returnere nogen data.
  • SIMCA-online håndterer manglende værdier eller fejlkoder anderledes, som det er beskrevet i SIMCA-online Technical Guide.

SimApi ydeevnekrav

  • Funktionerne i SimApi bruges til at indhente data.
  • Hvis dataadgangen er langsom, vil SimApi ikke fungere godt, hvilket dette f.eksample viser: Hvis SIMCA-online anmoder om data hvert sekund, men det tager to sekunder at få, vil SIMCA-online serveren aldrig være i stand til at følge med i realtid, men gradvist falde længere og længere bagud.
  • I underafsnittene viser vi, hvordan SIMCA og SIMCA-online bruger SimApi-funktionerne til dataadgang, og hvor ofte SimApi-funktionerne vil blive kaldt. Dette kan hjælpe med at sætte ydeevnekrav til en SimApi-implementering.

SIMCAs brug af SimApi-funktioner

  • Når desktop SIMCA eller andre offline produkter bruger en SimApi til at indhente data, vil disse anmodninger være for batches og procesdata for et sæt variabler inden for et bestemt tidsinterval.
  • Da disse anmodninger initieres manuelt af en bruger, sker de ikke særlig ofte og forårsager ikke en betydelig belastning af en datakilde.
  • Disse SimApi-funktioner bruges til at hente dataene:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes
  • simapi2_connectionReadHistoricalDataEx

SIMCA-onlines brug af SimApi funktioner

  • SIMCA-online bruges til real-time overvågning af en proces, og derfor anmoder den om data gennem SimApi med jævne mellemrum. Det korteste udførelsesinterval, der kan bruges, er 1 sekund. Nogle eks. fra den virkelige verdenamples af udførelsesintervaller er 10 s, 1 minut eller 10 minutter.
  • En server kan have mange projekter kørende på samme tid.
  • For at reducere antallet af API-kald gennem SimApi'en optimerer serveren dataanmodninger ved at gruppere mange samtidige mindre anmodninger i en enkelt større anmodning for alle variabler på samme tid (læs mere i hjælpeemnet 'Optimeret læsning fra datakilder forbedrer ydeevnen').
  • Serverens eksekveringsalgoritme fungerer sådan, når den anmoder om data ved hjælp af SimApi-funktionerne, der er anført nedenfor:
  • Alle faser, der udføres med samme interval, er grupperet i et enkelt SimApi-kald for at reducere antallet af opkald. Serveren læser de seneste data for alle variabler, der bruges af alle modeller, der deler intervallet, dvs. dette kald vil resultere i en bred datarække, som derefter bruges af alle projekter.
    • simapi2_connectionReadCurrentData
  • For hvert batchprojekt skal serveren også vide, hvilke batches der er aktive. Dette skal også ske hver gang et projekt udføres:
    • simapi2_nodeGetActiveBatches
    • simapi2_nodeGetBatchTimes kaldes sjældnere.
  • Derudover kræver SIMCA-online også historiske data. Disse anmodninger sker kun, når det er nødvendigt, som f.eks. indhente begyndelsen af ​​en batch, der startede før SIMCA-online blev startet, eller når serveren er bagud og skal læse en blok af data:
    • simapi2_connectionReadHistoricalDataEx
  • Eventuelt bruger nogle projektkonfigurationer funktioner, der bruger batchdata eller diskrete data, hvilket resulterer i SimApi-kald til:
    • simapi2_connectionReadBatchData
    • simapi2_connectionReadDiscreteEx
  • Eventuelt bruger nogle projektkonfigurationer tilbageskrivning til at skubbe data tilbage til datakilden:
    • simapi2_connectionWriteHistoricalDataEx (og tilsvarende funktioner for batchdata, diskrete data)
  • Det er vigtigt, at hvert opkald til kernefunktionerne for at få data, readCurrentData, getActiveBatches/getBatchTimes, er hurtigt, og det er ikke beregningsmæssigt svært for selve datakilden, givet hvor ofte SIMCA-online kan kalde disse funktioner.

Test og validering af SimApi-data

  • Dette afsnit handler om at teste en SimApi for at verificere, at de data, der returneres fra den, matcher data i selve datakilden. Det er vigtigt at køre test som dette efter oprettelse eller ændring af SimApi-implementering, eller når API'et for en datakilde ændres.
  • I praksis udføres datavalidering ved hjælp af SIMCA-online og dens Extract funktionalitet til at trække data fra datakilden gennem SimApi og derefter sammenligne med rådata i datakilden. Desktop SIMCA kan ikke bruges til at teste realtidsaspekterne af en SimApi.

Forberedelser og krav

  • Nogle elementer er valgfrie, men kan udføres, hvis omfanget af din test inkluderer det:
  1. Installer SIMCA-online som beskrevet i ReadMe og Installation Guide.pdf, der følger med produktets zip.
  2. Få en licens til SIMCA-online-serveren og installer den. SimApi fungerer ikke uden en licens. Vidensbaseartiklen til SIMCA-online viser, hvordan du licenserer produktet. F.eksample: SIMCA-online 18 (sartorius.com)
  3. Installer og konfigurer den SimApi, du vil teste. Se kapitel 4 – 5 i dette dokument og brugervejledningen til den specifikke SimApi.
    • a. Valgfrit: Sørg for, at brugervejledningen er opdateret og korrekt.
  4. Sørg for at have et værktøj til din datakilde, som du kan bruge til at sammenligne SimApi-dataene med.
  5. I SIMCA-online desktop-klienten skal du logge ind på din SIMCA-online-server og bruge File > Udtræk for at få data gennem SimApi.
  6. Valgfrit, hvis dit testomfang inkluderer det: efter endt test, afinstaller SimApi'en og bekræft dets files fjernes.

Hvad skal man teste

  • Funktionsmatrixen i kapitel 3 viser alle mulige funktioner, men en given SimApi-implementering understøtter muligvis kun en delmængde. Du bør teste alle funktioner, der er implementeret af den givne SimApi.
  • Følgende test er fælles for de fleste SimApi-implementeringer:
  • Autentificering med brugernavne og adgangskoder
  • Test de forskellige indstillinger i konfigurationen af ​​SimApi
  • Nodehierarki: Noderne og tags eksponeret af SimApi er korrekte.
    • Der skal være en tag eksponeret for alle "variabler", der skulle være tilgængelige gennem SimApi. Eksamples: procesmålinger, beregnede værdier, konstanter.
  • Forbindelsesstabilitet: Hvis datakilden ikke er tilgængelig, resulterer dette i advarsler eller fejl i loggen file, men at forbindelsen til datakilden genetableres automatisk, når datakilden er tilgængelig.
  • Flere forekomster: at to forekomster kan konfigureres og bruges uafhængigt og samtidigt med separate logfiler files.
  • Aktuelle data: udtræk aktuelle data for tags. Sørg for, at data er de sidst kendte værdier fra datakilden eller mangler på grund af dårlig kvalitet, eller når data er for gamle.
    • Udtræk data hvert 10. sekund (eller deromkring) i et minut.
  • Historiske kontinuerlige data: udtræk historiske data for tags.
    • Brug det tidsinterval, der passer til, da du udtrak aktuelle data. Bekræft, at aktuelle data matcher historiske data og de rå data i datakilden.
    • Prøv forskellige tidsintervaller og sampling-intervaller, skal du kontrollere, at dataene matcher datakilden.
    • Prøv at udtrække data hver 1 s, hvilket er den kortest mulige sampling interval.
    • Prøv forskellige typer tags i datakilden (procesvariabler osv.), og sørg for at data matcher.
    • Bemærk: SIMCA-online kan opdele en enkelt stor historisk dataanmodning i flere mindre bidder. Dette vil være synligt i SimApi-loggen.
  • Bekræft, at SimApi fungerer med tekstdata, numeriske data og manglende data.
  • SimApi log file. Bekræft, at loggen indeholder rimelige poster.
  • Batch node: Højreklik på en node og gør Find batches.
    • Bekræft batchnavne, starttider, sluttider for batches.
    • Prøv en aktiv batch, der kører i datakilden. Det bør ikke have et sluttidspunkt gennem SimApi.
  • Bearbejd node batch identifikator tag. Hvis SimApi har batch node funktionalitet (se forrige punkt), skal den også have en batch identifikator tag i den matchende procesdataknude. Data til dette tag skal være batch-id'et (batchnavn). Disse data er nødvendige for batchprojekter for at identificere, hvilken batch en række data tilhører.

Afhængigt af om SimApi understøtter det, kan du også prøve:

  • Batchdata ved hjælp af File > Uddrag.
  • Diskrete data vha File > Uddrag. Bemærk: til at teste diskrete data med File > Udpak noden, batchnoden og den diskrete datanode skal være i samme SimApi (når SIMCA-online udfører projekter, kan de være fra forskellige SimApis).
  • Skriv tilbage – skubber databatch til datakilden. For at teste dette skal du konfigurere en projektkonfiguration i SIMCA-online for at skrive datavektorer tilbage til datakilden. Udfør derefter projektet i SIMCA-online og tjek de data, der er skrevet tilbage i datakilden.
  • Kontinuerlige data konfigureres på Evolution Write Back-siden i projektkonfigurationen.
  • Diskrete data konfigureres på samme side, men kun for en fase, der er konfigureret til diskret datahentning.
  • Batchdata fra Batch Skriv tilbage

MERE INFO

  • Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Sverige
  • Telefon: + 46 90-18 48 00
  • www.sartorius.com
  • Oplysningerne og figurerne i denne vejledning svarer til den nedenfor angivne versionsdato.
  • Sartorius forbeholder sig retten til at foretage ændringer af udstyrets teknologi, funktioner, specifikationer og design uden varsel. Maskuline eller feminine former bruges for at lette læsbarheden i denne vejledning og angiver altid alle køn samtidigt.
    Ophavsretsmeddelelse:
  • Disse instruktioner, inklusive alle komponenter, er beskyttet af copyright.
  • Enhver brug ud over grænserne for ophavsretsloven er ikke tilladt uden vores godkendelse.
  • Dette gælder især gentryk, oversættelse og redigering uanset hvilken type medie der anvendes.

FAQ

  • Q: Hvad er formålet med SimApis?
    • Sv: Hovedformålet med SimApis er at levere data til Umetrics Suite-produkter til projektoprettelse og modelbygning.
  • Q: Hvordan kan jeg fejlfinde problemer med en SimApi-installation?
    • A: Du kan fejlfinde ved at teste fra SIMCA-online, tjekke SimApi-loggen file, og sikre den korrekte servicekontokonfiguration.

Dokumenter/ressourcer

PDF thumbnailSim Api software
User Guide · Sim Api Software, Api Software, Software

Stil et spørgsmål

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

Stil et spørgsmål

Ask about setup, compatibility, troubleshooting, or anything missing from this manual. Name and email are optional.