SARTORIUS ODBC SimApi brugervejledning

ODBC SimApi

Specifikationer

• Produkt: ODBC SimApi
• Producent: Sartorius Stedim Data Analytics
• Forbindelse: ODBC (Open Database Connectivity)
• Kompatibilitet: Fungerer med Umetrics Suite og eksterne data
  kilder

Produktbrugsvejledning

Forudsætninger

Før du bruger ODBC SimApi, skal du sikre dig følgende:

• Har en struktureret ODBC-datakilde som en relationel
  database
• Datakilden bør opføre sig som en god procesdatahistoriker
• Sørg for, at der ikke er forsinkelser i dataindsamlingen i datakilden
• Data i kilden skal afspejle den aktuelle tilstand
  behandle
• Datakilden skal reagere hurtigt på anmodninger i realtid
  overvågning

Installation og opsætning

1. Installer ODBC SimApi-softwaren på dit system.
2. Konfigurer ODBC-datakilden til at oprette forbindelse til den ønskede
   database.
3. Se brugervejledningen for detaljerede opsætningsinstruktioner baseret
   på dit softwarebrug.

Ofte stillede spørgsmål (FAQ)

Q: Hvad er en SimApi?

A: En SimApi er forbindelsen mellem Umetrics Suite og
eksterne datakilder, der specifikt forbinder til ODBC-datakilder
som relationelle databaser.

Sp: Hvordan kan jeg bruge den syntetiske proces-batch-id-funktion?

A: For at bruge den syntetiske proces batch-id-funktion skal du konfigurere
Batch-id tag at være batch-id'et for batchnoden på
Udførelsesbetingelser side i SIMCA-online.

Q: Kan ODBC SimApi bruges med samtidige batches?

A: Den syntetiske proces batch-id-funktion fungerer ikke med
samtidige partier. Kun én batch bør være aktiv i batchen
node på ethvert givet tidspunkt.

Loading PDF…

−+Fit width100%View FullscreenDownload PDFPrint PDF

×

Loading PDF…

Fejl! Brug fanen Hjem til at anvende Overskrift_1 (overskrifter) på den tekst, du vil have vist her.
ODBC SimApi brugervejledning
24. oktober 2024

Indledning
Indhold
1 Introduktion………………………………………………………………………………………………………………………….. 3
1.1 Funktioner ………………………………………………………………………………………………………………………………………………………………………………….. 3 1.1.1 Syntetisk proces batch-id …………………………………………………………………………………………………………………………………………. 4 1.1.2 Genereret syntetisk procesbatch-id tags; en pr. unikt enheds-id ………………………………………………….. 4 1.1.3 Batchnode med filtreringsunderstøttelse ………………………………………………………………………………………………………………………….. 4 1.1.4 Batchdata Views……………………………………………………………………………………………………………………………………………………………………… 5 1.1.5 Diskrete data………………………………………………………………………………………………………………………………………………………………… 6 1.1.6 Samtidig SimApi-adgang…………………………………………………………………………………………………………………………………. 7
2 Forudsætninger ………………………………………………………………………………………………………………………… 7
2.1 Databasestrukturkrav ………………………………………………………………………………………………………………………………… 7 2.2 Databaseydelsesovervejelser…………………………………………………………………………………………………………………………………. 7 2.3 Netværksovervejelser ………………………………………………………………………………………………………………………………………………………. 8 2.4 ODBC-drivere……………………………………………………………………………………………………………………………………………………………………………….. 8 2.5 Databasegodkendelse ………………………………………………………………………………………………………………………………………………………………… 8 2.6 Visual C++ Redistributable ……………………………………………………………………………………………………….
3 Installation og opsætning ………………………………………………………………………………………………………….. 9
3.1 Konfiguration af en ODBC-datakildeforbindelse i Windows til brug af SimApi ………………………………… 9 3.2 Vælg mellem to måder at få adgang til procesdata……………………………………………………………………………………… 10 3.3 XML-konfiguration file og log file lokationer………………………………………………………………………………………………………………….. 11 3.4 Globale forbindelsesindstillinger …………………………………………………………………………………………………………………………………………………………. 11 3.5 Direkte tilstand for kontinuerlig/proces views ………………………………………………………………………………………………………………………. 11 3.6 Opslag View Mode for kontinuerlig/proces views……………………………………………………………………………………………………….. 12
3.6.1 FBF views og HDB views ……………………………………………………………………………………………………………………………………….. 13 3.7 Batch node………………………………………………………………………………………………………………………………………………………………………………………….. 14 3.8 Batchdata Views ………………………………………………………………………………………………………………………………………………………………………………. 15
3.8.1 Syntetisk batchdataforekomst tags ……………………………………………………………………………………………………………………….. 16 3.8.2 Syntetisk proces batch-id tags filtreret på kolonneværdier………………………………………………………………….. 16 3.9 Diskrete noder ………………………………………………………………………………………………………………………………………………………………………… 16 3.9.1 Diskrete Tag Definition View…………………………………………………………………………………………………………………………………………. 17 3.9.2 Diskrete data set af SIMCA-online ………………………………………………………………………………………………………. 18 3.10 Nogle bemærkninger om SIMCA-online Write Back ………………………………………………………………………………………………………………… 18 3.11 XML-konfiguration File ………………………………………………………………………………………………………………………………………………………… ……… 19
4 Support …………………………………………………………………………………………………………………………..22

Indledning
1 Indledning
Dette dokument er brugervejledningen til ODBC SimApi fra Sartorius Stedim Data Analytics.
En SimApi er forbindelsen mellem Umetrics Suite og eksterne datakilder.
Denne SimApi opretter forbindelse til en ODBC (Open Database Connectivity) datakilde såsom en relationsdatabase. Datakilden skal være struktureret som beskrevet i dette dokument.
For at bruge en SimApi i SIMCA-online, som bruges til overvågning i realtid, er det vigtigt, at datakilden opfører sig som en god procesdatahistoriker: Der må ikke være dataindsamlingsforsinkelser i datakilden: aktuelle data i datakilden bør afspejle den aktuelle tilstand af processen for at fungere godt i SIMCA-online. Datakilden skal også reagere hurtigt på forespørgsler om data, så serveren vil kunne følge med i realtids eksekvering af projekter.
For en detaljeret liste over ændringer i forskellige versioner af denne SimApi, se Version Info.txt file der følger med installationen.
Denne SimApi kan bruges af SIMCA eller SIMCA-online eller anden software, der kan bruge SimApis.
For mere information om tilgængelige SimApis, se sartorius.com/umetrics-simapi.
1.1 Funktioner
· Understøtter SQL-dialekter til Microsoft SQL Server, Oracle, Microsoft Access, IBM db2, Denodo, MySQL, PostgreSQL og standard SQL.
· ODBC-forbindelsesstrenggodkendelse med et angivet brugernavn og adgangskode, Windows-godkendelse eller de legitimationsoplysninger, der er angivet i ODBC-forbindelsen i Windows ODBC-datakilder.
· Adgang til flere tabeller eller views til læsning af kontinuerlige procesdata (aktuelle og historiske). To tilstande; Opslag view mode og Direct Mode (læser direkte fra en database view).
· Flere batch noder, definerer levetiden for batches. Indeholder en enkelt række for hver batch med start- og sluttider.
· Læsning af batchdata (batchbetingelser) fra yderligere kolonner i batchnoder eller fra batchdata Views, der gemmer batchbetingelser i en smal tabel med kun to kolonner (tag navn og værdi).
· Diskret dataunderstøttelse: læsning af diskrete data en eller flere noder, der kan have forskellige kolonnenavne. · Skriv tilbage fra SIMCA-online: historiske procesdata og batchdata. · Arbejder med numeriske data eller tekst (kvalitative) data. · Syntetisk proces batch id i batch noden, som kan bruges i SIMCA-online fase eksekvering
betingelser, hvis procesdataene ikke har et batch-id tag. · Syntetisk proces batch-id tags i batchdata Views, der kan filtreres af andre kolonner. Kan bruges
i faseforhold, når batch-id'et ellers ikke er tilgængeligt i procesdataene. · Batch noder med filtreringsunderstøttelse. Filtreringsunderstøttelse er nyttig, når du har en batchnode med en master
liste over batches for hele dit system, men ønsker at kunne filtrere det til kun at vise batches i en del af systemet (såsom batches, der kører i en enkelt enhed, eller en batch af et bestemt materiale eller type). · Syntetisk batchdataforekomst tags håndtere flere målinger af batchdata pr. batch. Nyttigt, hvis du vil være i stand til at oprette batchniveaumodeller, der bruger to eller flere målinger af hver batchtilstandsvariabel pr. batch. · Flere forekomster af ODBC SimApi skal konfigureres og bruges fra den samme SIMCA-onlineserver. Dette lader dig oprette forbindelse til flere databaser på en eller flere databaseservere. · Forbindelsesmodstandsdygtighed SimApi genopretter automatisk forbindelse til en datakilde, efter at den er blevet afbrudt (f.eks.ample efter en netværksfejl). · Trådsikker samtidig adgang. SimApi arbejder med Concurrent SimApi-adgangsfunktionen introduceret med SIMCA-online 18-serveren, som kan forbedre ydeevne og reaktionsevne. · Understøtter datoer gemt som lokale tider eller UTC i databasen.
Hver funktion (kontinuerlig, batch eller diskret) kan konfigureres og bruges hver for sig, og alle funktioner er valgfrie. Du behøver ikke konfigurere funktioner, medmindre du har brug for dem.

Indledning
1.1.1 Syntetisk proces-batch-id
I et batchprojekt skal procesdataene have et batch-id tag (kolonne), der er angivet på siden Udførelsesbetingelser i projektkonfigurationen i SIMCA-online. Denne tag matches mod batch-noden for at vide, om en fase skal udføres.
Hvis procesdataene ikke har et batch-id tag, ODBC SimApi-funktionens syntetiske procesbatch-id kan bruges. Den genererer procesdatabatch-id'et ved hjælp af data fra batchnoden.
For at bruge denne funktion skal du gå til siden Udførelsesbetingelser og konfigurere batch-id'et tag at være batch-id'et for batchnoden. Hver gang serveren læser batch-id'et for procesdataene, returneres det syntetiske batch-id fra batch-noden, hvilket sikrer, at enheden vil køre.
Bemærk, at denne funktion ikke virker med samtidige (parallelle) batches. For et givet tidspunkt skal der således kun være én aktiv batch i batch-noden.
1.1.2 Genereret syntetisk procesbatch-id tags; en pr. unikt enheds-id
Denne funktion bygger på det syntetiske procesbatch-id beskrevet ovenfor, men bruger en ekstra kolonne i batchnoden, der indeholder UnitID. Batch-noden er segmenteret i klasser af batches, der deler den samme værdi i kolonnen UnitID. Dette fungerer som en for batches i batch-noden, der har en bestemt værdi for UnitID.
For hver unik værdi i UnitID-kolonnen (der ser i hele batch-noden) opretter SimApi en syntetisk tag i batch-noden med navnet BatchID_Unit_[Value].
F.eksample: hvis værdi 1 og 2 er de to unikke værdier i kolonnen UnitID, vil det resultere i to syntetiske tags; BatchID_Unit_1 og BatchID_Unit_2. Læsning af procesdata fra det syntetiske batch-id tag BatchID_Unit_1 returnerer kun batch-id'er for batches, hvis UnitID-kolonne har værdien 1. Batches med 2 i UnitID-kolonnen vil blive ignoreret.
For at bruge dette skal du konfigurere batch-id'et tag på siden Udførelsesbetingelser for hver enhed for at bruge den syntetiske BatchID_Unit_[Value] tags.
Navnet på enheds-id-kolonnen er konfigureret i XML file.
Begrænsninger
· Hvad angår det almindelige syntetiske batch-id beskrevet ovenfor, fungerer dette i forlængelse heraf ikke med samtidige (parallelle) batches, der deler den samme værdi af UnitID (samtidige batches med forskellige UnitID'er fungerer fint).
· Alle enheds-id'er skal angives i batch-noden, før SimApi'en startes (den syntetiske tags oprettes ved opstart). Tip: Du kan forududfylde en tabel med én dummy-batch i batch-noden for hvert enheds-id, der kræves.
· Batch-id'er skal være unikke i batch-noden, og der kan kun være én række for hvert batch-id. Derfor kan hver batch kun have én værdi af UnitID.
· Værdien af ​​UnitID må ikke ændres for en specifik batch i løbet af dens levetid.
Bemærk: et alternativ til at bruge et syntetisk proces-batch-id filtreret af UnitID som dette er at bruge flere batch-noder; en for hver unik værdi af UnitID. I tilfælde af flere batch noder kan det samme batch id naturligvis være til stede i mange batch noder (i modsætning til når UnitID filteret bruges), så i nogle tilfælde er flere batch noder den foretrukne løsning.
1.1.3 Batch node med filtreringsunderstøttelse
En batch node er nødvendig i SIMCA-online for at udføre batch projekter.
Filtrering er nyttig, når du har en batchnode med en masterliste over batches for hele dit system, men ønsker at filtrere den til kun at vise batches i en del af systemet (såsom batches, der kører i en enkelt enhed, eller produkt af et bestemt materiale eller type).

Indledning

Filtrering er valgfri, og for at bruge den skal du angive den kolonne, der skal filtreres på, og angive en liste over gyldige værdier for den kolonne. For hver konfigureret værdi oprettes en separat node af SimApi, der kun indeholder batches med denne værdi i filterkolonnen.

Her er en example af et parti view, kaldet BatchNode i databasen, med en Unit-kolonne, der kan bruges til at filtrere batches.

BatchID Starttid

Stoptid

Enhed (filterkolonne) Batchtilstandsvariabel 1

Batch1 2017-01-01 01:00 2017-01-01 11:00 A

34

Batch2 2017-01-02 02:00 2017-01-02 12:00 B

4

Batch3 2017-01-03 03:00 2017-01-01 13:00 A

12

Batch4 2017-01-04 04:00 2017-01-04 14:00 A

4

Batch5 2017-01-05 05:00 2017-01-05 15:00 B

5

Konfigureret til enhed A og B ville dette give to batch noder ved navn BatchNode_A og BatchNode_B. Hver af disse batch noder ville kun returnere batches, der svarer til deres filterværdi, så for BatchNode_A ville Batch1, Batch3 og Batch4 blive returneret, og for BatchNode_B ville Batch2 og Batch5 blive returneret. Den sidste kolonne er et example af en batchtilstandsvariabel, der vil være tilgængelig i denne batchnode til at læse batchniveaudata fra.

Syntetiske procesbatch-id'er understøttes for batchnoder konfigureret på denne måde.

1.1.4 Batchdata Views
En batch-data view er en database view eller tabel til lagring af værdier for batchforhold. Det skal have tre kolonner: Batch-id, Tag navn og værdi. En række i det view gemmer en værdi for en bestemt tag og batch. Der vil være mange rækker i dette view for hver batch, når der er mange batchtilstandsvariabler.
Her er en eksample af en batch-data view i databasen med dens tre kolonner:

BatchID

Tag navn

Værdi

Batch7

Udbytte

0.95

Batch7

Produktkvalitet

Fremragende

Batch8

Udbytte

0.90

Batch8

Produktkvalitet

Dårlig

Disse batchdata view vil blive eksponeret gennem SimApi som to tags Udbytte og produktkvalitet. Læseværdier for dem tags for Batch8 ville resultere i værdierne henholdsvis 0.90 og "Dårlig".

Bemærk: Hvis der er flere rækker for det samme BatchID og Tag navnekombination i databasen view, vil SimApi returnere værdien fra den sidste af disse rækker.

Der er ingen kolonner for batchstart eller batchsluttider i batchdata views, så de kan ikke bruges som batch noder.

Du kan konfigurere mange forskellige batchdata views.

Tip: Som et alternativ til batchdata Views kan batchtilstandsdata også gemmes i en batchnode. I så fald er der behov for en kolonne for hver batch-tilstandsvariabel. Der vil således kun være én række for hver batch i batch noder, men der skal flere kolonner til.

Indledning

Vigtigt for SIMCA-online's Udtræk funktionalitet: Til at udtrække data fra en batch data view du skal også inkludere en tag (såsom Batch Identifier tag) fra en batch-node, så SIMCA-online kan kende batchene, der skal udtrækkes data for.

1.1.4.1 Syntetisk batchdataforekomst tags Batchdata består altid af en enkelt observation pr. batch1.
Men hvad nu hvis værdierne af en batchdata tag kan ændre sig (f.eksampfordi du kører en eller anden måling igen), og hvis du vil bruge flere målinger pr. batch i en SIMCA-online batch-niveaumodel?
Derefter kan du bruge den valgfri funktion syntetiske batchdataforekomst tags. Disse er tags der tilføjes som ekstra tags i batchdataene view, hver tilknytning til en bestemt forekomst af batchdataene for tag.
Her er en eksampdet:

BatchID

Tidskolonne

Tag navn

Værdi

Batch7

2015-06-23 09:00 Yield

0.90

Batch7

2015-06-23 17:00 Yield

0.99

SimApi'en vil derefter afsløre disse batchdata view med to tags; Udbytte_1 og Udbytte_2. Når data læses for batch Batch7 vil det resultere i værdierne 0.90 for Yield_1 og 0.99 for Yield_2.

Bemærk, at der er tilføjet en ny TimeColumn i dette example, med et tidspunktamp for hver række. Denne kolonne er påkrævet for den syntetiske batchdataforekomst tag funktion, for at SimApi ved, hvordan man bestiller værdierne for tags ind i instansen tags.

1.1.4.2 Syntetisk proces-batch-id tags filtreret på kolonneværdier Denne funktion er ligesom det genererede syntetiske proces-batch-id tags; en pr. unikt Unit ID med den forskel, at dette læses fra en batchdata view og batch-id'et kan filtreres på flere kolonner.
Her er en eksampdet:

BatchID

Tidskolonne

Tag navn Værdi

Enhed

Linje

Batch7

2015-06-23 09:00 Yield

0.90

A

1

Batch8

2015-06-23 09:00 Yield

0.95

B

2

Hvis vi filtrerer BatchID'et på kolonnerne Enhed og Linje, ville det give os et syntetisk batch-id tag for hver unik kombination af værdierne fra kolonnerne Enhed og Linje.

Syntetisk tags oprettet ville være: BatchID_A_1, BatchID_B_2

Derfor ville læsning af BatchID_A_1 for tiden i tabellen give værdien Batch7, for samme tid ville BatchID_B_2 give værdien Batch8.

Læg mærke til, at en tidskolonne med en timetamp for hver række er påkrævet for denne funktion.

1.1.5 Diskrete data
Diskrete data er sjældent målte data, som ikke har nogen logiske værdier mellem målinger. Normalt, somample tages på hver batch med semi-regelmæssige intervaller (såsom en gang om dagen). Dette sample bliver derefter sendt til et laboratorium, som udfører analyse på sample og på et senere stage vendte tilbage med en rapport om sample for de nødvendige variabler. Dette indtastes derefter i databasen i den diskrete datatabel.
Lær mere om dette i SimApi Guide og SIMCA-online Technical Guide.

1 For mere information om de forskellige datahentningstilstande, hvoraf batchdata er en, se SimApi Guide.pdf.

Forudsætninger
1.1.5.1 Syntetisk batch-alder tags for diskrete data noder For diskrete data noder er der fire syntetiske tags navngivet $BatchAge(d), $BatchAge(h), $BatchAge(m), $BatchAge(s). Når de læser deres værdier, vil de være batchalderen som et flydende kommatal for hver sample i fire forskellige størrelser: henholdsvis dage, timer, minutter og sekunder. Disse tags kan bruges som modenhed i SIMCA-modellen, hvilket reducerer behovet for eksplicit at tilføje og udfylde sådanne tags til de diskrete datatabeller.
1.1.6 Samtidig SimApi-adgang
Samtidig SimApi-adgang er en valgfri funktion introduceret med SIMCA-online 18-serveren, som kan forbedre ydeevnen og reaktionsevnen for en server og klienter.
ODBC SimApi er trådsikker og bruger en pulje af forbindelser til serveren. Størrelsen på poolen kan konfigureres ved hjælp af indstillingen DatabaseConnectionPoolSize i konfigurationen file (standard til 10). Dette styrer, hvor mange samtidige anmodninger til databasen er tilladt. Yderligere samtidige anmodninger sættes i kø og udføres, efterhånden som tidligere anmodninger afsluttes.
Forskellige databasemotorer og forskellige databaseservere understøtter muligvis et forskelligt antal samtidige tråde. For optimal ydeevne skal tilslutningsbassinets størrelse muligvis justeres.
Lær flere overvejelser og hvordan du aktiverer dette i SIMCA-onlinehjælpen på Concurrent SimApi Access.
2 Forudsætninger
For at denne SimApi skal fungere, er der krav, der skal være opfyldt, både til pc'en, der kører SimApi, og til selve datakilden vedrørende databasestruktur og ydeevne.
2.1 Krav til databasestruktur
En database kan naturligvis indeholde næsten alle data med en vilkårlig struktur. ODBC SimApi er bygget til at indhente procesdata til brug i SIMCA-online og SIMCA.
For at SimApi'en kan fungere, skal databasen have en bestemt struktur eller design som beskrevet nedenfor.
Her er generelle krav:
· Alle anvendte tabeller har en unik primær nøgle. · De fleste tabeller i databasen kræver en dato/klokkeslæt kolonne, så SimApi'en kan identificere tidspunktetamp
for hver række data. Denne kolonne skal indekseres i databasen, så ydeevnen ikke lider. · SimApi understøtter to datatyper for datakolonner: enten numeriske reelle værdier (en flydende eller anden
numerisk datatype) eller tekststrenge (f.eksample varchar i databasen). Manglende værdier (nuller) er også tilladt for datakolonner. · Udtrykket view og tabel bruges i flæng i dette dokument for at betyde det samme. · Hvis du opretter en view i datakilden og ønsker at bruge det i SimApi, skal du passe på ikke at introducere ydeevneproblemer: view skal være hurtig at få adgang til af SimApi. Det betyder, at du typisk ikke kan skabe et kompleks view der samler data fra mange andre tabeller og udfører kompliceret forretningslogik til at beregne resultaterne. Sådan en view vil ikke opfylde ydeevnekravene for brugerne af SimApi, såsom SIMCA-online, der bruges til realtidsovervågning af en proces.
SimApi har mange funktioner, og hver funktion har forskellige nødvendige indstillinger, der skal foretages, som beskrevet i kapitel 3.
2.2 Databaseydelsesovervejelser
For at bruge en SimApi i SIMCA-online, som bruges til overvågning i realtid, er det vigtigt, at datakilden opfører sig som en god procesdatahistoriker.
· Der må ikke være forsinkelser i dataindsamlingen i datakilden: aktuelle data i datakilden bør afspejle den aktuelle tilstand af processen for at fungere godt i SIMCA-online.

Forudsætninger
· Datakilden skal også reagere hurtigt på forespørgsler om data, så serveren vil kunne følge med i realtids eksekvering af projekter.
Dette har flere implikationer:
· Datavarehuse eller databaser, der udfører dataaggregering, fungerer muligvis ikke godt sammen med SIMCA-online til projektudførelse i realtid, fordi de kan indføre forsinkelser i dataindsamlingen.
· Database views, der udfører komplicerede og tidskrævende forespørgsler, risikerer at blive for langsomme til brug i SIMCA-online.
2.3 Netværksovervejelser
Du bør placere SIMCA-online-serveren tæt på datakilden i netværket. Dette sikrer en hurtig forbindelse mellem SIMCA-online og dets datakilde. Netværksudstyr, såsom firewalls, kan forstyrre forbindelsen mellem SIMCA-online og datakilden. Hvis dette er tilfældet, skal firewallreglerne muligvis ændres. Bekræft forbindelsen fra den pc, der kører SimApi til datakilden ved hjælp af f.eksamptryk på knappen Test forbindelse i ODBC-datakilder.
2.4 ODBC-drivere
SimApi'en kræver ODBC-drivere for at din datakilde skal installeres på den pc, hvor SimApi'en er installeret. ODBC-drivere fås fra producenten af ​​databasen. Download og installer den seneste tilgængelige version. Drivere til Microsoft SQL Server er ofte allerede installeret på de fleste Windows-computere. Du skal bruge de drivere, der matcher SimApi-platformen. Typisk betyder dette 64-bit x64-drivere, der skal bruges med 64-bit Windows og SIMCA og SIMCA-online. For gamle 32-bit SIMCA-versioner kræves 32-bit ODBC-drivere.
2.5 Databasegodkendelse
Databaser kræver godkendelse for at SimApi'en kan få adgang til data, så kun de data, som SimApi'en har brug for, kan tilgås af den. Databaseadministratorer begrænser adgangen i databasen til en bestemt bruger, der bruges af SimApi. Brugergodkendelse kan udføres på en af ​​tre måder med ODBC SimApi:
1. Angivelse af brugernavn og adgangskode i SimApi-konfigurationsdialogen. Legitimationsoplysningerne gemmes i krypteret format på pc'en.
2. Angivelse af brugernavn og adgangskode i ODBC-forbindelsen oprettet i ODBC-datakilder (se nedenfor). Dette gemmer legitimationsoplysningerne i Windows.
3. Ikke at angive legitimationsoplysninger eksplicit, men i stedet bruge Windows Authentication og den brugerkonto, der kører SimApi. For desktop-SIMCA betyder det, at brugeren kører SIMCA, og for SIMCA-online betyder det SIMCA-online-tjenestekontoen, der er konfigureret i Windows-tjenester.
Kapitel 3 viser, hvordan SimApi konfigureres.
2.6 Visual C++ omdistribuerbar
For at bruge SimApi på en computer, skal den have følgende software installeret:
· Microsoft Visual C++ omdistribuerbar til Visual Studio 2015-2022. Dette er allerede tilgængeligt på alle computere med nyere versioner af SIMCA eller SIMCA-online. For at køre SimApi i andre sammenhænge findes den seneste version på https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vcredist?view=msvc-170#visual-studio-2015-2017-2019-and-2022

Installation og opsætning
3 Installation og opsætning
SimApi-guiden, der kan downloades fra sartorius.com/umetrics-simapi, indeholder god baggrundsinformation om SimApis, hvordan man installerer, konfigurerer, fejlfinder og tester en SimApi. Du kan eventuelt henvise til dette dokument for at lære mere om forskellige emner. For at installere og konfigurere denne SimApi skal du udføre disse trin:
1. Installer ODBC-drivere til din databasemotor (se kapitel 2). 2. Konfigurer en ODBC-databaseforbindelse i Windows ODBC-datakilder, og test den for at være sikker
virker (detaljerede trin i næste afsnit). 3. Installer SimApi på pc'en ved hjælp af dets installationsprogram: (for detaljerede instruktioner, se kapitel 5 i
SimApi-vejledningen): a. Start med at afinstallere enhver tidligere version i Windows Apps og funktioner, før du installerer den nye. b. Luk lynlåsen ud file, se Version Info.txt file og brugervejledningen (som du læser nu...). c. Kør setup exe file for at installere SimApi.
4. Hvis Visual C++ Redistributable på pc'en ikke er opdateret, skal du installere den seneste version (se 2.6). 5. Tilføj SimApi til SIMCA eller SIMCA-online, som beskrevet i kapitel 5 i SimApi Guiden.
en. Når du klikker på knappen for at konfigurere SimApi, får du denne dialogboks til at give legitimationsoplysninger til brug (lær om mulighederne i det forrige kapitel):
b. Alle andre indstillinger for denne SimApi laves manuelt i en XML file ved hjælp af en teksteditor. Hvordan man konfigurerer hver funktion er beskrevet senere i dette kapitel.
6. Test SimApi. Se kapitel 6 i SimApi-vejledningen.
3.1 Konfiguration af en ODBC-datakildeforbindelse i Windows til brug af SimApi
SimApi'en kræver en konfigureret ODBC-datakildeforbindelse for at fungere. Du opretter dette i kontrolpanelet for ODBC-datakilder i Windows. Der er to versioner af dette værktøj på 64-bit Windows: en til 32-bit applikationer og en til 64-bit. Brug den, der matcher den SimApi, du bruger, typisk 64-bit, da alle nyere versioner af SIMCA-online og SIMCA er 64-bit og kræver 64-bit SimApis-varianterne. Dette skærmbillede viser denne applikation i Windows. Der er tre forskellige databaseforbindelser i dette f.eksample. Nedenstående dialog viser den første side af konfigurationsguiden for SQL Server-forbindelsen til serveren se01wssuite01:

Installation og opsætning
Retningslinjer for brug: · Vi anbefaler, at du konfigurerer dine datakilder som system-DSN'er som vist på skærmbilledet. Dette sikrer, at de er tilgængelige for alle brugere af pc'en, inklusive tjenester som SIMCA-online. · Klik på Tilføj for at tilføje en ny forbindelse. Vælg den driver, du vil bruge, som du installerede som beskrevet i det foregående kapitel, som matcher din database, og klik gennem guiden og konfigurer indstillinger for at oprette forbindelse til din databaseserver. · I slutningen af ​​guiden kan du prøve knappen Test datakilde for at bekræfte forbindelsen til databasen. Dette virker selvfølgelig ikke, hvis du angiver brugernavnet og adgangskoden i selve ODBC'en (se forrige kapitel).
3.2 Vælg mellem to måder at få adgang til procesdata på
Der er to måder at få adgang til procesdata i denne SimApi: 1. Direkte tilstand. I denne tilstand angiver du view navne, der skal afsløres gennem SimApi. hver view bliver en node i SimApi, og alle kolonner i en view blive tags. Direkte tilstand anbefales, da det er relativt nemt at bruge.

Installation og opsætning

2. Opslag View Mode. Denne tilstand er mere kompleks og kræver en specifik view i databasen kaldet et opslag View. Denne view definerer tags der skal eksponeres gennem SimApi, men data er taget fra yderligere relaterede views angivet for hver række af data i opslag view.
Lær mere om, hvordan du opsætter disse og alle andre funktioner i SimApi nedenfor. Se tilbage til kapitel 1.1 for at læse mere om funktionerne i denne SimApi, som du konfigurerer nedenfor.

3.3 XML-konfiguration file og log file steder
En SimApi gemmer sin log files i den skjulte Program Data-mappe2: %programdata%UmetricsSimApi, hvor %programdata% er knyttet til den faktiske mappe på din computer. Den er som standard C:ProgramData.
Dette indeholder SimApi-indstillingerne i en XML file opkaldt ODBCSimApi_ .xml. Du kan redigere dette file manuelt ved at bruge en teksteditor som f.eks. Notesblok til at foretage ændringer.
Hver SimApi bruger typisk sin egen log file, som på samme måde som SIMCA-online serverlog file vil indeholde data afhængigt af en logniveauindstilling. Denne file er nyttig til fejlfinding.
Loggen file hedder ODBCSimApi_ .log.
er navnet på den SimApi-instans, du tilføjede i SIMCA-online-serverindstillinger eller Standard for desktop SIMCA. F.eksample, hvis du tilføjede navngivet forekomsten "MyDB", loggen file navnet vil være ODBCSimApi_MyDB.log. Lær mere om dette i 4.2 4.3 i SimApi-vejledningen.

3.4 Globale forbindelsesindstillinger
Den første del af XML-konfigurationen file er forbindelsesindstillingerne, der beskriver, hvordan du opretter forbindelse til din database.

Nødvendige indstillinger er:

· DSN

datakildens navn. Det skal matche navnet på System DSN i Windows

ODBC-datakilder, som du har konfigureret ovenfor.

· SQLDialect

indstillet til at matche den databaseserver, du bruger.

Du skal muligvis også indstille indstillingerne for venstretegning og højretegnsætning, hvis du bruger reserverede SQL-nøgleord som navne på identifikatorer eller bruger mellemrum i identifikationsnavne på din views/tabeller/kolonner i databasen.

De andre tilslutningsindstillinger er valgfrie.

Disse og alle andre indstillinger har også beskrivelser i tabellen i slutningen af ​​kapitlet.

Vigtigt: Nogle databaser skelner mellem store og små bogstaver, når det kommer til navne på databaser, tabeller, views, kolonner, så sørg for at du bruger den korrekte casing brugt i din database i XML file.

3.5 Direkte tilstand for kontinuerlig/proces views
Hver række i en direkte tilstand view er en observation.
Søjlerne i view repræsentere variabler:
· Der skal være en enkelt kolonne med dato/tidsdata. Denne kolonne skal være den primære nøgle og kan ikke indeholde null-værdier. Navnet på denne kolonne skal svare til den konfigurerede TimeField-indstilling i konfigurationen file. Værdier for denne kolonne er tiden stamp for observationerne.
· Dato/klokkeslæt-kolonnen skal være af datatypen datetime eller datetime2. · De resterende kolonner vil blive eksponeret gennem SimApi as tags med samme navne som kolonnen
navne. Værdier for disse kolonner er procesdata.

2 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.

Installation og opsætning
· Skriv tilbage er understøttet for alle tags, men de korrekte tilladelser skal indstilles i ODBC-datakilden. For at kunne skrive manglende værdier tilbage, skal nulls understøttes for kolonnen.
Konfigurationen i XML file er lige frem: views, og direkte tilstand views: –> ”/>
Bemærk: SimApi'en opregner kun kolonnerne ved opstart. Det betyder, at hvis der tilføjes nye kolonner til en view SimApi'en skal genstartes for at SimApi'en kan afsløre dem.

Figur 1. Direct Mode tabel example.
3.6 Opslag View Mode for kontinuerlig/proces views
Denne view kan bruges i stedet for eller som supplement til Direct Mode views som beskrevet ovenfor. Opslaget View er en indirekte måde at angive, hvilke datakolonner i andre views, der skal kompileres og eksponeres gennem SimApi. Den anden views er henholdsvis HDB-kilder (historiske data) eller PDB-kilder (aktuelle data). PDB-kilden er valgfri. Dataene afsløret af opslag View præsenteres af SimApi som en node, der altid kaldes ODBCProcess:

Hver række i opslag view definerer en tag at blive eksponeret gennem SimApi og hvilken anden views at tage data fra for det tag. Opslaget view vil således indeholde mange rækker. Det specificerer også, om en tag er skrivbar, dvs. hvis SIMCA-online skulle kunne skrive værdier tilbage til denne tag.

Der kan være flere PDB-kilder og flere HDB-kilder i brug fra opslag View. Således kan ODBC SimApi samle data fra flere views ind i én node med tags som eksponeres gennem SimApi.

Opslaget view skal indeholde følgende kolonner (benævnt felter i konfigurationen file):

· Navn

Navnet på en tag (Primær nøgle, varchar, ikke null).

· PDB_Kilde

Navnet på view der indeholder de aktuelle data for tag (varchar). Hvis dette

kolonnen indeholder en tom værdi, vil programmet læse alle data fra HDB_Source.

· PDB_Felt

Kolonnenavnet på tag i FBF-kilden view (varchar). Hvis

PDB_Source værdi er udeladt, denne kolonne vil ikke blive læst.

· HDB_Kilde

Navnet på view der indeholder de historiske data for tag (varchar).

· HDB_Felt

Kolonnenavnet på tag i HDB-kilden view (varchar).

Installation og opsætning

· Skrivbar

Hvis SIMCA-online skulle kunne skrive data til denne tag eller ej (bit).

Bemærk, at for hver kolonne angiver ovenstående beskrivelse også, hvilke rækker der skal være primærnøgle og datatypen for hver kolonne.

Navnene på kolonnerne er vilkårlige, da navnene er angivet i konfigurationen file.

Figur 2. Eksample af et opslag view i form af en databasetabel. På skærmbilledet kan du se, at der bruges én PDB-kilde og én HDB-kilde. Kolonnen Navn bestemmer tag navne, som SimApi'en vil bruge, og i dette tilfælde bruger _Field-kolonnerne de samme kolonnenavne. Kun én tag er skrivbar.

3.6.1 FBF views og HDB views
Når du bruger et opslag View du har også brug for mindst én HDB view. De views for de historiske data (HDB) og de valgfrie views for nuværende data PDB har begge den samme datastruktur (kolonner).
Hver række i FBF eller HDB views repræsenterer en observation med værdier for hver tag i det FBF/HDB view som angivet i opslag view.
Forskellene mellem PDB og HDB er:

· Et FBF view indeholder kun én række data for tags angivet i opslag view. Den skal også have en gang stamp kolonne for, hvornår den sidst blev opdateret.
· En HDB view indeholder flere rækker af data for tags angivet i opslagstabellen. Hver række har en tidsmaskeamp indeholdende den historiske tidamp for en bestemt observation.

FBF og HDB views skal have følgende kolonner,

· DatoTid

For et PDB: Det tidspunkt, hvor tabellen sidst blev opdateret (Primær nøgle, datetime eller

datetime2, ikke null).

For en HDB: Den historiske tid for tag værdier (primær nøgle, datetime eller

datetime2, ikke null).

· [Kolonnenavn] Der skal være én kolonne for hver tag der blev angivet i opslagstabellen.

Indeholder data for tag i hver række.

Bemærk, at for hver kolonne angiver ovenstående beskrivelse også, hvilke rækker der skal være primærnøgle og datatypen for hver kolonne.
Navnene på kolonnerne er vilkårlige i databasen, da navnene er angivet i konfigurationen file.
Følgende kolonner er ikke obligatoriske, men er nyttige at tilføje, hvis batches er modelleret med flere faser, og der er flere enheder i processen:

· UnitBatchID

En kolonne pr. enhed, der indeholder batch-id'et inden for en bestemt enhed (varchar).

Denne tag kan bruges i Batch-identifikationen tag felt for den pågældende enhed på siden Udførelsesbetingelser for

konfigurationen af ​​dette projekt i SIMCA-online.

Installation og opsætning

· FaseID

En kolonne pr. enhed, der indeholder faseoplysningerne for enheden (int, float eller varchar).

Denne tag kan bruges i logisk udtryk i feltet Phase execution condition i konfiguration af dette

projekt i SIMCA-online.

Det maksimalt tilladte antal tags (søjler) er 255.

Figur 4. FBF example.
Figur 3. HDB example.
3.7 Batch node
En batchnode indeholder metainformation om batches såsom starttidspunkt, stoptid og eventuelt batchbetingelser. En batch node er påkrævet af SIMCA-online for at analysere batchdata, men kan udelades for et kontinuerligt (ikke-batch) projekt. Navnet på en batch node set fra SIMCA-online eller SIMCA er det originale navn på view eller tabel i databasen, i denne exampaf "BatchData":
Hver række i en batchnode repræsenterer én batch.

Installation og opsætning

Et parti view skal have følgende kolonner:

· BatchID

Batchens navn (primær nøgle, varchar, ikke null).

· BatchStart

Starttidspunktet for partiet, når det først går ind i hele processen (ikke når det

starter i en enhed (del af) i processen) (datetime eller datetime2, ikke null).

· BatchStop

Det tidspunkt, hvor hele batchen er færdiggjort i systemet (ikke i en enhed), null if

ikke afsluttet (datotid eller datotid2).

Bemærk, at kolonnen BatchID skal være den primære nøgle.

Derudover kan der være valgfrie kolonner som følger for hver batch-tilstandsvariabel:

· [Navn på batchtilstand]

En kolonne for hver batchtilstand. Kolonnenavnet bliver

bruges som tag navn. (float for numeriske værdier eller varchar for tekst såsom konfigurations-id'et).

· Enheds-ID

Navnet på den enhed, som batchen er knyttet til

(varchar).

Navnene på batchnoden og kolonnerne er vilkårlige i databasen, da navnene er angivet i konfigurationen file.

Figur 5. Batch node example med to batchbetingelser (bc1 og bc2) og en UnitID-kolonne.

3.8 Batchdata Views
Hver batch-data view skal have disse tre kolonner (yderligere kolonner vil blive ignoreret):

· BatchID · Tag navn · Værdi
tekst eller float3).

batchens navn (varchar, ikke null) navn på batchtilstandsvariablen (varchar, ikke null) værdien for batchtilstandsvariablen (float for numeriske værdier eller varchar for

Kombinationen af ​​BatchID og Tag navn skal være den primære nøgle (medmindre du vil bruge funktionen til flere batchdataforekomster).

Hver batch-data view er eksponeret som en node af SimApi. Navnet på noden er view navn i databasen. De view navn og kolonnenavne er konfigureret i XML-konfigurationen file ved at bruge attributterne for en enkelt BatchDataView element som dette:

3 Ved at bruge en varchar-tekstkolonne kan du gemme tekst (data for kvalitative variabler i et SIMCA-projekt). Du kan dog også gemme numeriske tal i tekstformat, og SimApi'en vil konvertere disse til tal. På denne måde kan du få nogle tags der er numeriske og nogle der indeholder tekst.

Installation og opsætning

<BatchDataView ViewNavn = "DatabaseViewOrTableName" BatchIDColumn="BatchID" TagNavnkolonne ="Tag navn” ValueColumn=”Værdi” />
Bemærk, at værdierne, der bruges her, matcher tabellen i figur 5. Tilføj flere batchdata views ved at tilføje flere BatchDataView elementer.

3.8.1 Syntetisk batchdataforekomst tags
For at konfigurere den valgfrie batchdatainstans tags, tilføjer du attributterne NumSyntheticBatchTags og TimeColumn til BatchDataView element:
<BatchDataView ViewNavn = "DatabaseViewOrTableName" BatchIDColumn="BatchID" TagNavnkolonne ="Tag navn” ValueColumn=”Value” TimeColumn=”TimeColumn” NumSyntheticBatchTags="3″ />
TimeColumn er navnet på tidskolonnen i din database view. Denne kolonne skal angives for batchdataforekomst tags.
Tilladt værdi for NumSyntheticBatchTags er numeriske værdier mellem 1 og 10. Dette styrer hvor mange syntetiske instanser tags er skabt per real tag. F.eksample, for tag "tag"nyt tags "tag_1", "tag_2”, … “tag_N” vil blive oprettet indtil N= NumSyntheticBatchTags.

3.8.2 Syntetisk proces-batch-id tags filtreret på kolonneværdier
For at konfigurere det valgfri batch-id-filter tags der kan bruges til kontinuerlig datahentningstilstand, tilføjer du attributterne FilterColumns og TimeColumn til BatchDataView element:
<BatchDataView ViewNavn = "DatabaseViewOrTableName" BatchIDColumn="BatchID" TagNavnkolonne ="Tag navn” ValueColumn=”Value” FilterColumns=”Column1|Column2″ TimeColumn=”TimeColumn”/>
FilterColumns skal være et eller flere kolonnenavne i din database view. Hvis der bruges flere kolonnenavne, adskil dem med rørtegnet (|).
TimeColumn skal være navnet på tidskolonnen i din database view. Denne kolonne skal angives for batchdataforekomst tags.

3.9 Diskrete noder
Valgfri diskrete noder indeholder diskrete datamålinger. Hver række i en diskret node repræsenterer én måling for en batch og tag på et givet tidspunkt.

En diskret node skal have følgende kolonner:

· BatchID · TagNavn · Tid · Værdi

Batchens navn (varchar, ikke null). Navnet på tag (varchar, ikke null). Det tidspunkt, hvor sample blev taget (datetime eller datetime2, ikke null). Måleværdien (float). Diskrete data kan ikke være strengdata.

Bemærk, at kombinationen af ​​BatchID+TagNavn+tid skal være den primære nøgle.

Hver konfigureret diskret node er eksponeret som en node af SimApi. Navnet på noden er view navn i databasen, medmindre det er tilsidesat. Nodenavnet, view navn, opslag view, og kolonnenavnene er konfigureret i XML-konfigurationen file ved at bruge attributterne for et DiscreteNode-element som dette:

<DiscreteNode NodeName=”ODBCDiscrete” ViewNavn = "Diskret" TagOpslagView="DiskretTags” BatchIDField=”BatchID” TimeField=”Tid” TagNameField ="TagNavn” ValueField=”Værdi”/>

Ovenstående example afslører en node ved navn ODBCDiscrete af SimApi, den opregner tags ved hjælp af den diskreteTags tabel/view. Data læses fra den diskrete tabel/view ved hjælp af de konfigurerede kolonner.

Installation og opsætning
Navnene på den diskrete node og dens kolonner er vilkårlige i databasen, da navnene er angivet i konfigurationen file.
Figur 6. Diskret node example med to tags sampled tre gange (med ca. 24 timers intervaller) pr. batch.
3.9.1 Diskret Tag Definition View
Dette valgfrit view bruges af SimApi til at opregne de diskrete tags som skulle være tilgængeligt gennem SimApi. Dette sker ved opstart af SimApi. Du vil måske bruge dette view til ydeevneoptimeringer, når du indlæser SimApi, eller hvis du vil kontrollere hvad tags er eksponeret fra SimApi. For eksempel hvis du vil eksponere tags som endnu ikke har nogen målinger, når SimApi er startet.
Figur 7. Simpel diskret tag opslag view som bruger den diskrete tabel.

Installation og opsætning
3.9.2 Diskrete data set af SIMCA-online
Det følgende er, hvordan de diskrete data i figur 6. Diskret node example med to tags sampled tre gange (med ca. 24 timers intervaller) pr. batch.Figur 6 Figur 2Fejl! Referencekilde ikke fundet. vil se i SIMCAonline, når det kombineres med batcherne i figur 5.
Figur 8. Diskrete data set af SIMCA-online. Bemærk, at den genererede batch-alder tags repræsentere partiets alder for hver observation/erample.
3.10 Nogle bemærkninger om SIMCA-online Write Back
Skriv tilbage i SIMCA-online kan bruges til at skrive data fra SIMCA-online til ODBC-datakilden. Skrivning af kontinuerlige procesdata (fra kontinuerlige konfigurationer, batchudviklingsniveauet eller fra Control Advisor) og batchdata (fra batchniveauet) understøttes. Det anbefales ikke at skrive tilbage til de samme noder, som du bruger til at læse data, da dette ville forsøge at tilføje duplikerede rækker med de samme primære nøgler i databasen views på grund af de primære nøgler anbefaler vi på dato/tid-kolonnen og batch-id-kolonner (se ovenfor). Opret i stedet en eller flere Direct Mode views for kontinuerlige / udviklingsdata, eller batch-noder til batch-data til brug til tilbageskrivning. Årsagen til dette problem er, at ODBC SimApi bruger SQL INSERT-sætninger til at tilføje en ny række data for hver observation eller for hver batch på batchniveau.
· For kontinuerlige data skrives observationstidspunktet tilbage sammen med værdierne fra SIMCAonline.
· For batchdata skrives batch-id'et tilbage sammen med værdierne fra SIMCA-online. · Hvis manglende værdier skrives tilbage, vil disse blive skrevet som null, så databasen skal understøtte null-værdier
for at dette virker. Da tidspunktet for en observation eller batch-id for en batch skrives tilbage, ville dette overtræde den primære nøglebegrænsning i databaserne, hvis de samme værdier allerede var til stede (som de ville være, hvis data blev læst fra de samme noder). Ud over disse primære nøgleforskelle gælder det samme databaseskema for noder til tilbageskrivning (se ovenfor for mere information):

Installation og opsætning

· En dato/klokkeslæt kolonne bør eksistere for kontinuerlige noder, og en batch id kolonne for batch noder. · Tilføj en datakolonne for hver tag som skulle være tilgængelig for tilbageskrivning. Brug float-datatypen til
numeriske data og varchar for tekstdata (såsom når du skriver tilbage konfigurations-id'et for en konfiguration). F.eksample,, hvis du planlægger at skrive 20 forskellige data vektorer tilbage fra SIMCA-online, skal du tilføje 20 datakolonner til databasen view. · Kolonnerne skal tillade null for at understøtte tilbageskrivning af manglende værdier

3.11 XML-konfiguration File
Denne tabel viser alle indstillinger i XML-konfigurationen file. Brug denne information og beskrivelserne ovenfor til at konfigurere SimApi.

Forbindelsesspecifikke indstillinger

Forklaring

DSN

Datakildenavn som konfigureret i Windows ODBC Administrator kontrolpanel.

SQL-dialekt

SQL-dialekten, der skal bruges. En af disse værdier: standard, postgresql, db2, mssql, mysql, oracle, access, denodo. Hvis det efterlades tomt, vil standard blive brugt, men standarden for en ny XML-file er mssql.

Akkreditiver

Gemte ODBC-brugernavnet og adgangskoden i en krypteret form. Brug knappen Konfigurer til at angive brugernavn og adgangskode.

QueryTimeout

Tiden før en forespørgsel eller forbindelse til databasen vil timeout og mislykkes.

DBSchema

Databaseskemaet i databasen (hvis relevant). Et databaseskema er en måde at logisk gruppere objekter såsom tabeller, views, lagrede procedurer osv. Tænk på et skema som en beholder af objekter. Du kan tildele en bruger-logintilladelser til et enkelt skema, så brugeren kun kan få adgang til de objekter, de har tilladelse til at få adgang til. Skemaer kan oprettes og ændres i en database, og brugere kan få adgang til et skema. Et skema kan ejes af enhver bruger, og skemaejerskab kan overføres.

Venstre tegnsætning

SQL-dialektspecifik venstre afgrænsning bruges til at adskille identifikatorer fra andre SQL-kommandoer. Standarden er tom, hvilket betyder, at der ikke bruges venstre tegnsætning. Du skal angive en ikke-tom værdi, hvis identifikatorerne i databasen bruger mellemrum eller reserverede SQL-nøgleord. Til SQL Server eller Access bruger du "[", men for Oracle og andre databaser, der bruger SQL-standarden, skal du indstille denne indstilling til """ (dette er XML-escape-sekvensen for det dobbelte anførselstegn ").

Højre tegnsætning

SQL dialekt specifik højre adskiller bruges til at adskille identifikatorer fra SQL kommandoer. Til SQL Server eller Access bruger du "]", men for Oracle og andre databaser, der bruger SQL-standarden, skal du indstille denne indstilling til """ som for Venstretegnsætning ovenfor.

Vælg StatementTerminator

SQL-dialektspecifik. Tegn, der skal bruges til at afslutte udvalgte udsagn. For nogle dialekter og versioner skal dette sættes til en tom streng "". Standard er ";".

DatabaseConnectionPoolSize

Det maksimale antal samtidige forbindelser til databasen, der er tilladt. Standarden er 10. Denne indstilling kan forbedre ydeevnen ved at tillade mere end én tråd at få adgang til databasen samtidigt. Læs mere i kapitel 1.

Installation og opsætning

Databasespecifikke indstillinger

Brug LocalTime

Angiver om datoer gemmes som lokal tid eller UTC i databasen. Standard er "1", hvilket betyder, at lokal tid bruges.

Direkte tilstandsspecifikke indstillinger

Tabeller

Navnet på views, der indeholder kontinuerlige/procesdata. Flere views kan angives ved at adskille deres navne med et rørtegn (|). F.eksample: Tabel1|Tabel2|Tabel3|View1. TimeField-navnet skal være identisk i alle views.

Opslag view specifikke indstillinger

Opslagstabel

Navnet på opslag view eller bord.

TagNavnefelt

Kolonnenavnet, hvor tag navne er givet.

PDBTableField

Navnet på en kolonne i opslag view. For hver række indeholder denne kolonne navnet på et PDB view. Navnet på en view med PDB-data. Kan efterlades tom, hvis det er tilfældet, vil den seneste række af HDB blive brugt i stedet for aktuelle data.

FBFTagFelt

Kolonnenavnet i PDB-tabellen, hvor data for tag kan findes (bruges ikke, hvis PDBTableField er udeladt).

HDBTableField

Navnet på en kolonne i opslag view. For hver række har denne kolonne et navn på en HDB view.

HDBTagFelt

Navnet på en kolonne i opslag view. For hver række har denne kolonne navnet på en tag i HDB view.

Skrivbart felt

Kolonnenavnet, der fortæller, om tag er skrivbar eller ej.

Direkte tilstand og HDB/PDB view specifikke indstillinger

Tidsfelt

Navnet på dato/klokkeslæt-kolonnen i Kontinuerlig/Proces View og FDB- eller HDB-views (eller tabeller).

Batch node specifikke indstillinger

BatchTabel

Navnet på view eller tabel, der indeholder batchdataene. Flere batch view kan specificeres ved at adskille deres navne med et rørtegn (|). F.eksample: BT1|BT2|BT3. Følgende kolonner skal være identiske i alle views.

BatchIDField

Kolonnenavnet på batch-id'et i batchnoden.

StartTimeField

Kolonnenavnet på starttidspunktet for batchen.

StopTimeField

Kolonnenavnet på stoptidspunktet for batchen.

BatchIDUnitField

Kolonnenavnet på enheds-id'et i batchnoden. Dette felt kan bruges til at generere syntetisk batch-id-proces tags filtreret efter enheds-id.

Batch node med filtreringsunderstøttelse One element med følgende attributter, der kontrollerer

indstillinger

indstillingerne for den syntetisk filtrerede batch node.

Installation og opsætning

ViewNavn BatchIDColumn StartTimeColumn StopTimeColumn FilterColumn
Filterværdier
Batch data view indstillinger Diskrete nodespecifikke indstillinger
Nodenavn ViewNavn TagOpslagView
BatchIDField TimeField TagNameField ValueField Log file specifikke indstillinger LogFileStørrelse LogLevel

Navnet på view eller tabel, der indeholder batchdataene.
Kolonnenavnet på batch-id'et for batchen.
Kolonnenavnet på starttidspunktet for batchen.
Kolonnenavnet på stoptidspunktet for batchen.
Navnet på den kolonne, der indeholder filterværdierne i batchnoden. Denne indstilling kan stå tom, hvis du ikke har brug for filtreringsfunktionen.
De værdier, der skal bruges til at filtrere batcher. Flere filterværdier er adskilt af rørtegnet (|). Lad være tom, hvis du ikke har brug for filtrering. F.eksample: FilterValue1| FilterVærdi2| FilterVærdi3. Dette er en examphvordan det kunne se ud i konfigurationen file: ViewName=”BatchNode” BatchIDColumn=”BatchID” StartTimeColumn=”StartTime” StopTimeColumn=”StopTime” FilterColumn=”Unit FilterValues=”FilterValue1| FilterValue2″ /> Multiple elementer er understøttet. Bemærk, at du kan have forskellige navne på kolonnerne mellem batch-noder.
Opbevares i en eller flereView> elementer. Se 3.8 Batchdata Views.
An element for hver diskret node med følgende attributter. Se 3.9 Diskret .
Navnet på noden, som det vil blive eksponeret af SimApi. Hvis det efterlades tomt, værdien af ViewNavn vil blive brugt.
Navnet på view/tabel, der indeholder de diskrete data. Hvis det efterlades tomt, er noden deaktiveret.
Navnet på view/tabel, der definerer den diskrete tags at bruge. Hvis det efterlades tomt ViewNavn vil blive analyseret ved opstart for at opregne alle tags der.
Kolonnenavnet på identiteten af ​​den batch, der blev målt.
Kolonnenavnet på tidspunktet for målingen.
Kolonnenavnet på tag der blev målt.
Kolonnenavnet på værdien af ​​målingen.
Den maksimalt tilladte størrelse af loggen file før file er afkortet.
Jo højere værdi, jo mere information udskrives til loggen file. Maksimal værdi er 4 og minimumværdi er 0. (0=Kritisk, 1=Fejl, 2=Advarsel, 3=Information, 4=Fejlretning).

Støtte
4 Support
Denne SimApi er udviklet af Sartorius Data Analytics. Besøg sartorius.com/umetrics-support for at få support.

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.

Støtte