Uživatelská příručka SARTORIUS ODBC SimApi

ODBC SimApi

Specifikace

• Produkt: ODBC SimApi
• Výrobce: Sartorius Stedim Data Analytics
• Konektivita: ODBC (Open Database Connectivity)
• Kompatibilita: Pracuje s Umetrics Suite a externími daty
  zdrojů

Návod k použití produktu

Předpoklady

Před použitím ODBC SimApi se ujistěte, že:

• Mějte strukturovaný zdroj dat ODBC jako relační
  databáze
• Zdroj dat by se měl chovat jako dobrý historik procesních dat
• Zajistěte, aby nedocházelo ke zpoždění při získávání dat ve zdroji dat
• Data ve zdroji by měla odrážet aktuální stav
  proces
• Zdroj dat musí rychle reagovat na požadavky v reálném čase
  sledování

Instalace a nastavení

1. Nainstalujte si do systému software ODBC SimApi.
2. Nakonfigurujte zdroj dat ODBC pro připojení k požadovanému
   databáze.
3. Podrobné pokyny k nastavení najdete v uživatelské příručce
   na vašem používání softwaru.

Často kladené otázky (FAQ)

Otázka: Co je SimApi?

A: SimApi je spojení mezi Umetrics Suite a
externí datové zdroje, konkrétně připojení k datovým zdrojům ODBC
jako relační databáze.

Otázka: Jak mohu použít funkci ID dávky syntetického procesu?

A: Chcete-li použít funkci ID dávky syntetického procesu, nakonfigurujte
Identifikátor šarže tag být id dávky uzlu dávky na
Stránka podmínek provedení v SIMCA-online.

Otázka: Lze ODBC SimApi používat se souběžnými dávkami?

Odpověď: Funkce ID dávky syntetického procesu nefunguje
souběžné dávky. V dávce by měla být aktivní pouze jedna dávka
uzel v libovolném okamžiku.

Loading PDF…

−+Fit width100%View FullscreenDownload PDFPrint PDF

×

Loading PDF…

Chyba! Pomocí karty Domů použijte Headline_1 (Nadpisy) na text, který zde chcete zobrazit.
Uživatelská příručka ODBC SimApi
24. října 2024

Zavedení
Obsah
1 Úvod……………………………………………………………………………………………………………………….. 3
1.1 Vlastnosti ………………………………………………………………………………………………………………………………………………………………………………….. 3 1.1.1 ID šarže syntetického procesu …………………………………………………………………………………………………………………………………………. 4 1.1.2 ID dávky generovaného syntetického procesu tags; jeden na jedinečné ID jednotky …………………………………………….. 4 1.1.3 Dávkový uzel s podporou filtrování ………………………………………………………………………………………………………………….. 4 1.1.4 Údaje o dávce Views…………………………………………………………………………………………………………………………………………… 5 1.1.5 Samostatná data………………………………………………………………………………………………………………………………………………………………… 6 1.1.6 Souběžný přístup k SimApi…………………………………………………………………………………………………………………………………. 7
2 Předpoklady ………………………………………………………………………………………………………………… 7
2.1 Požadavky na strukturu databáze ………………………………………………………………………………………………………………………………………… 7 2.2 Úvahy o výkonu databáze…………………………………………………………………………………………………………………………. 7 2.3 Úvahy o vytváření sítí …………………………………………………………………………………………………………………………………………. 8 2.4 Ovladače ODBC……………………………………………………………………………………………………………………………………………………………………………….. 8 2.5 Ověření databáze ………………………………………………………………………………………………………………………………………………………… 8 2.6 Visual C++ Redistribuovatelné ……………………………………………………………………………………………………………………………………………….. 8
3 Instalace a nastavení ………………………………………………………………………………………….. 9
3.1 Konfigurace připojení zdroje dat ODBC ve Windows pro použití SimApi ………………………………… 9 3.2 Výběr mezi dvěma způsoby přístupu k procesním datům……………………………………………………………………………………………… 10 3.3 Konfigurace XML file a log file umístění………………………………………………………………………………………………………………….. 11 3.4 Globální nastavení připojení ……………………………………………………………………………………………………………………………………………. 11 3.5 Přímý režim pro kontinuální/procesní views ………………………………………………………………………………………………………………. 11 3.6 Vyhledávání View Režim pro kontinuální/procesní views……………………………………………………………………………………………………….. 12
3.6.1 PNR views a HDB views ………………………………………………………………………………………………………………………….. 13 3.7 Uzel šarže……………………………………………………………………………………………………………………………………………………………………………….. 14 3.8 Údaje šarže Views ………………………………………………………………………………………………………………………………………………………………. 15
3.8.1 Instance syntetických dávkových dat tags ……………………………………………………………………………………………………………….. 16 3.8.2 ID dávky syntetického procesu tags filtrováno podle hodnot sloupců………………………………………………………………….. 16 3.9 Diskrétní uzly ………………………………………………………………………………………………………………………………………………………………………… 16 3.9.1 Diskrétní Tag Definice View…………………………………………………………………………………………………………………………. 17 3.9.2 Diskrétní data, jak je vidí SIMCA-online ………………………………………………………………………………………………………. 18 3.10 Několik poznámek k SIMCA-online Write Back ………………………………………………………………………………………………………………………… 18 3.11 Konfigurace XML File ………………………………………………………………………………………………………………………………………… ………… 19
4 Podpora …………………………………………………………………………………………………………………………..22

Zavedení
1 Úvod
Tento dokument je uživatelskou příručkou pro ODBC SimApi od Sartorius Stedim Data Analytics.
SimApi je spojení mezi Umetrics Suite a externími datovými zdroji.
Toto SimApi se připojuje ke zdroji dat ODBC (Open Database Connectivity), jako je relační databáze. Zdroj dat musí být strukturován tak, jak je popsáno v tomto dokumentu.
Chcete-li použít SimApi v SIMCA-online, které se používá pro monitorování v reálném čase, je důležité, aby se zdroj dat choval jako dobrý procesní historik dat: Ve zdroji dat nesmí docházet k prodlevám při získávání dat: aktuální data ve zdroji dat by měla odrážet aktuální stav procesu, aby dobře fungovala v SIMCA-online. Zdroj dat musí také rychle reagovat na požadavky na data, aby byl server schopen držet krok s realizací projektů v reálném čase.
Podrobný seznam změn v různých verzích tohoto SimApi naleznete v souboru Version Info.txt file který je dodáván s instalací.
Toto SimApi může používat SIMCA nebo SIMCA-online nebo jiný software, který může používat SimApis.
Další informace o dostupných SimApis najdete na sartorius.com/umetrics-simapi.
1.1 Vlastnosti
· Podporuje dialekty SQL pro Microsoft SQL Server, Oracle, Microsoft Access, IBM db2, Denodo, MySQL, PostgreSQL a standardní SQL.
· Ověření připojovacího řetězce ODBC pomocí poskytnutého uživatelského jména a hesla, ověření systému Windows nebo pověření zadaných v připojení ODBC ve Windows ODBC Data Sources.
· Přístup k více tabulkám popř views pro čtení nepřetržitých procesních dat (aktuálních i historických). Dva režimy; vyhledávání view režim a přímý režim (čtení přímo z databáze view).
· Vícenásobné dávkové uzly, definující životnost dávek. Obsahuje jeden řádek pro každou dávku s časy začátku a konce.
· Čtení dávkových dat (dávkových podmínek) z dalších sloupců v dávkových uzlech nebo z dávkových dat Views, které ukládají dávkové podmínky v úzké tabulce pouze se dvěma sloupci (tag jméno a hodnota).
· Podpora diskrétních dat: čtení diskrétních dat jednoho nebo více uzlů, které mohou mít různé názvy sloupců. · Zpětný zápis ze SIMCA-online: historická procesní data a data dávek. · Pracuje s číselnými daty nebo textovými (kvalitativními) daty. · ID dávky syntetického procesu v uzlu dávky, které lze použít při provádění fáze SIMCA online
podmínky, pokud data procesu nemají ID dávky tag. · ID dávky syntetického procesu tags v Batch Data Views, které lze filtrovat podle jiných sloupců. Lze použít
ve fázových podmínkách, kdy ID dávky jinak není v procesních datech dostupné. · Dávkové uzly s podporou filtrování. Podpora filtrování je užitečná, když máte dávkový uzel s hlavním serverem
seznam šarží pro celý váš systém, ale chcete mít možnost jej filtrovat, aby se zobrazily pouze šarže v části systému (jako jsou šarže běžící v jedné jednotce nebo šarže určitého materiálu nebo typu). · Instance syntetických dávkových dat tags zpracovat více měření dat šarže na šarži. Užitečné, pokud chcete mít možnost vytvářet modely na úrovni dávky, které používají dvě nebo více měření každé proměnné podmínky dávky na dávku. · Více instancí ODBC SimApi pro konfiguraci a použití ze stejného SIMCA-online serveru. To vám umožní připojit se k více databázím na jednom nebo více databázových serverech. · Odolnost připojení SimApi se automaticky znovu připojí ke zdroji dat poté, co byl odpojen (napřample po závadě sítě). · Souběžný přístup bezpečný pro vlákna. SimApi pracuje s funkcí souběžného přístupu SimApi zavedenou se serverem SIMCA-online 18, která může zlepšit výkon a odezvu. · Podporuje data uložená jako místní čas nebo UTC v databázi.
Každá funkce (kontinuální, dávková nebo diskrétní) může být konfigurována a používána samostatně a všechny funkce jsou volitelné. Funkce nemusíte konfigurovat, pokud je nepotřebujete.

Zavedení
1.1.1 ID dávky syntetického procesu
V dávkovém projektu musí mít data procesu ID dávky tag (sloupec), který je uveden na stránce Podmínky provedení v konfiguraci projektu v SIMCA-online. Tento tag se porovnává s dávkovým uzlem, aby věděl, zda se má fáze provést.
Pokud data procesu nemají ID dávky tag, lze použít ID dávky syntetického procesu funkce ODBC SimApi. Generuje ID dávky dat procesu pomocí dat z uzlu dávky.
Chcete-li použít tuto funkci, přejděte na stránku Podmínky provedení a nakonfigurujte identifikátor dávky tag být ID dávky uzlu dávky. Kdykoli server načte ID dávky pro procesní data, vrátí se syntetické ID dávky z uzlu dávky a zajistí, že se jednotka spustí.
Všimněte si, že tato funkce nefunguje se souběžnými (paralelními) dávkami. V daném čase tedy musí být v uzlu dávky aktivní pouze jedna dávka.
1.1.2 Vygenerované ID dávky syntetického procesu tags; jeden na jedinečné ID jednotky
Tato funkce staví na výše popsaném ID dávky syntetického procesu, ale používá další sloupec v uzlu dávky, který obsahuje ID jednotky. Uzel dávky je rozdělen do tříd dávek, které sdílejí stejnou hodnotu ve sloupci UnitID. Funguje to jako pro dávky v uzlu dávky, které mají určitou hodnotu pro UnitID.
Pro každou jedinečnou hodnotu ve sloupci UnitID (hledá se v celém uzlu dávky) vytvoří SimApi syntetický tag v uzlu dávky s názvem BatchID_Unit_[Value].
Napřample: pokud jsou hodnoty 1 a 2 dvě jedinečné hodnoty ve sloupci UnitID, výsledkem budou dvě syntetické tags; BatchID_Unit_1 a BatchID_Unit_2. Čtení procesních dat ze syntetického ID dávky tag BatchID_Unit_1 vrátí pouze ID dávek pro dávky, jejichž sloupec UnitID má hodnotu 1. Dávky s 2 ve sloupci UnitID budou ignorovány.
Chcete-li to použít, nakonfigurujte identifikátor dávky tag na stránce Execution Conditions pro každou jednotku k použití syntetického BatchID_Unit_[Value] tags.
Název sloupce ID jednotky je nakonfigurován v XML file.
Omezení
· Pokud jde o běžné syntetické ID dávky popsané výše, toto rozšíření nefunguje se souběžnými (paralelními) dávkami sdílejícími stejnou hodnotu UnitID (souběžné dávky s různými UnitID fungují dobře).
· Všechna ID jednotek musí být specifikována v uzlu dávky před spuštěním SimApi (syntetický tags se vytvářejí při spuštění). Tip: můžete předvyplnit tabulku jednou fiktivní dávkou v uzlu dávky pro každé ID jednotky, které bude vyžadováno.
· ID dávek musí být v uzlu dávky jedinečné a pro každé ID dávky může být pouze jeden řádek. Každá dávka tedy může mít pouze jednu hodnotu UnitID.
· Hodnota UnitID se nesmí pro konkrétní dávku během její životnosti změnit.
Poznámka: Alternativou k použití ID dávky syntetického procesu filtrovaného pomocí UnitID, jako je tato, je použití více uzlů dávky; jeden pro každou jedinečnou hodnotu UnitID. V případě více uzlů dávky může být stejné ID dávky samozřejmě přítomno v mnoha uzlech dávky (na rozdíl od použití filtru UnitID), takže v některých případech je preferovaným řešením více uzlů dávky.
1.1.3 Dávkový uzel s podporou filtrování
K provádění dávkových projektů je v SIMCA-online potřeba dávkový uzel.
Filtrování je užitečné, když máte uzel šarže s hlavním seznamem šarží pro celý systém, ale chcete jej filtrovat tak, aby zobrazoval pouze šarže v části systému (například šarže běžící v jedné jednotce nebo produkt určitého materiálu nebo typu).

Zavedení

Filtrování je volitelné a chcete-li jej použít, musíte určit sloupec, podle kterého se má filtrovat, a zadat seznam platných hodnot pro tento sloupec. Pro každou nakonfigurovanou hodnotu vytvoří SimApi samostatný uzel obsahující pouze dávky s touto hodnotou ve sloupci filtru.

Tady je example dávky view, nazvaný BatchNode v databázi, se sloupcem Unit, který lze použít k filtrování dávek.

Čas spuštění BatchID

Čas zastavení

Jednotka (sloupec filtru) Proměnná stavu dávky 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

Nakonfigurováno pro jednotku A a B by poskytlo dva dávkové uzly s názvem BatchNode_A a BatchNode_B. Každý z těchto dávkových uzlů by vrátil pouze dávky, které odpovídají jejich hodnotě filtru, takže pro BatchNode_A by byly vráceny Batch1, Batch3 a Batch4 a pro BatchNode_B by byly vráceny Batch2 a Batch5. Poslední sloupec je example proměnné podmínky dávky, která bude k dispozici v tomto uzlu dávky pro čtení dat na úrovni dávky.

U takto nakonfigurovaných uzlů dávek jsou podporována ID dávek syntetických procesů.

1.1.4 Údaje o dávkách Views
Údaje o dávce view je databáze view nebo tabulka pro uložení hodnot pro dávkové podmínky. Měl by mít tři sloupce: Identifikátor dávky, Tag jméno a hodnotu. V tom jedna řada view ukládá hodnotu pro konkrétní tag a šarže. V tomto bude mnoho řádků view pro každou dávku, pokud existuje mnoho proměnných podmínek dávky.
Tady je bývalýample dat o dávce view v databázi se třemi sloupci:

BatchID

Tag jméno

Hodnota

Dávka7

Výtěžek

0.95

Dávka7

Kvalita produktu

Vynikající

Dávka8

Výtěžek

0.90

Dávka8

Kvalita produktu

Chudý

Tato data šarže view budou vystaveny prostřednictvím SimApi jako dva tags Výnos a kvalita produktu. Čtení hodnot pro ně tags pro Batch8 by vedly k hodnotám 0.90 a „Špatné“.

Poznámka: Pokud existuje více řádků pro stejné BatchID a Tag kombinace jmen v databázi view, SimApi vrátí hodnotu z posledního z těchto řádků.

V datech dávky nejsou žádné sloupce s časy zahájení nebo ukončení dávky views, takže je nelze použít jako dávkové uzly.

Můžete nakonfigurovat mnoho různých dat dávek views.

Tip: Jako alternativa k Batch Data Views, data stavu dávky mohou být také uložena v uzlu dávky. V takovém případě je potřeba jeden sloupec pro každou proměnnou dávkových podmínek. Pro každou dávku tedy bude v uzlech dávky pouze jeden řádek, ale je potřeba více sloupců.

Zavedení

Důležité pro funkci extrahování SIMCA-online: Pro extrahování dat z dat dávky view musíte také jednu zahrnout tag (jako je Identifikátor dávky tag) z dávkového uzlu, takže SIMCA-online může znát dávky pro extrakci dat.

1.1.4.1 Instance syntetických dávkových dat tags Údaje o dávce se vždy skládají z jednoho pozorování na dávku1.
Ale co když hodnoty dávkových dat tag se může změnit (napřample protože znovu spustíte nějaké měření) a pokud chcete použít více měření na dávku v modelu SIMCA-online na úrovni dávky?
Potom můžete použít volitelnou instanci syntetických dávkových dat tags. Toto jsou tags které jsou přidány jako další tags v datech šarže view, každé mapování na konkrétní instanci dat dávky pro tag.
Tady je bývalýampten:

BatchID

TimeColumn

Tag jméno

Hodnota

Dávka7

2015-06-23 09:00 Yield

0.90

Dávka7

2015-06-23 17:00 Yield

0.99

SimApi poté zobrazí tato dávková data view se dvěma tags; Yield_1 a Yield_2. Když jsou načtena data pro dávku Batch7, výsledkem budou hodnoty 0.90 pro Yield_1 a 0.99 pro Yield_2.

Všimněte si, že v tomto ex je přidán nový TimeColumnample, s timestamp pro každý řádek. Tento sloupec je vyžadován pro instanci syntetických dat dávky tag funkce, aby SimApi vědělo, jak seřadit hodnoty pro tags do instance tags.

1.1.4.2 ID dávky syntetického procesu tags filtrováno podle hodnot sloupců Tato funkce je jako ID dávky generovaného syntetického procesu tags; jedno na jedinečné ID jednotky s tím rozdílem, že se čte z dat dávky view a ID dávky lze filtrovat na více sloupcích.
Tady je bývalýampten:

BatchID

TimeColumn

Tag jméno Hodnota

Jednotka

Čára

Dávka7

2015-06-23 09:00 Yield

0.90

A

1

Dávka8

2015-06-23 09:00 Yield

0.95

B

2

Pokud filtrujeme BatchID na sloupcích Unit a Line, dostaneme jedno syntetické ID dávky tag pro každou jedinečnou kombinaci hodnot ze sloupců Unit a Line.

Syntetický tags vytvořeno by bylo: BatchID_A_1, BatchID_B_2

Přečtení BatchID_A_1 pro čas v tabulce by tedy dalo hodnotu Batch7, pro stejnou dobu by BatchID_B_2 dalo hodnotu Batch8.

Všimněte si, že sloupec času s časemamp pro každý řádek je pro tuto funkci vyžadováno.

1.1.5 Diskrétní data
Diskrétní data jsou zřídka měřená data, která mezi měřeními nemají žádné logické hodnoty. Obvykle jakoample se užívá z každé šarže v polopravidelných intervalech (například jednou denně). Tato sample je pak odeslán do laboratoře, která provádí analýzu na sample a později stage se vrátil se zprávou o sample pro požadované proměnné. Ten se pak zanese do databáze v diskrétní datové tabulce.
Více se o tom dozvíte v SimApi Guide a SIMCA-online Technical Guide.

1 Další informace o různých režimech získávání dat, z nichž jedním jsou dávková data, najdete v SimApi Guide.pdf.

Předpoklady
1.1.5.1 Syntetické stáří šarže tags pro diskrétní datové uzly Pro diskrétní datové uzly existují čtyři syntetické tags s názvem $BatchAge(d), $BatchAge(h), $BatchAge(m), $BatchAge(s). Při čtení jejich hodnot bude stáří dávky jako číslo s plovoucí desetinnou čárkou pro každé sample ve čtyřech různých velikostech: dny, hodiny, minuty a sekundy. Tyto tags lze použít jako splatnost v modelu SIMCA, což snižuje potřebu explicitně je přidávat a naplňovat tags do diskrétních datových tabulek.
1.1.6 Souběžný přístup k SimApi
Souběžný přístup k SimApi je volitelná funkce zavedená se serverem SIMCA-online 18, která může zlepšit výkon a odezvu serveru a klientů.
ODBC SimApi je bezpečný pro vlákna a používá fond připojení k serveru. Velikost fondu je konfigurovatelná pomocí nastavení DatabaseConnectionPoolSize v konfiguraci file (výchozí hodnota je 10). To řídí, kolik souběžných požadavků na databázi je povoleno. Další souběžné požadavky jsou zařazeny do fronty a prováděny po dokončení dřívějších požadavků.
Různé databázové stroje a různé databázové servery mohou podporovat různý počet souběžných vláken. Pro optimální výkon může být nutné upravit velikost fondu připojení.
Další informace o tom, jak to povolit, se dozvíte v online nápovědě SIMCA pro Concurrent SimApi Access.
2 Předpoklady
Aby toto SimApi fungovalo, musí být splněny požadavky jak na PC se systémem SimApi, tak na samotný zdroj dat týkající se struktury a výkonu databáze.
2.1 Požadavky na strukturu databáze
Databáze může samozřejmě obsahovat téměř jakákoli data s libovolnou strukturou. ODBC SimApi je vytvořen pro získávání procesních dat pro použití v SIMCA-online a SIMCA.
Aby SimApi fungovalo, databáze musí mít konkrétní strukturu nebo design, jak je popsáno níže.
Zde jsou obecné požadavky:
· Všechny použité tabulky mají jedinečný primární klíč. · Většina tabulek v databázi vyžaduje sloupce data/času, aby SimApi dokázalo identifikovat časamp
pro každý řádek dat. Tento sloupec by měl být v databázi indexován, aby neutrpěl výkon. · SimApi podporuje dva datové typy pro datové sloupce: buď numerické reálné hodnoty (plovoucí nebo jiné
číselný datový typ) nebo textové řetězce (napřample varchar v databázi). Pro datové sloupce jsou také povoleny chybějící hodnoty (null). · Termín view a tabulka se v tomto dokumentu používají zaměnitelně a znamenají totéž. · Pokud vytvoříte a view ve zdroji dat a chcete jej použít v SimApi, dávejte pozor, abyste nezaznamenali problémy s výkonem: the view musí být rychlý přístup přes SimApi. To znamená, že obvykle nemůžete vytvořit komplex view který agreguje data z mnoha dalších tabulek a provádí složitou obchodní logiku pro výpočet výsledků. Takový a view nebude splňovat požadavky na výkon uživatelů SimApi, jako je SIMCA-online používaný pro monitorování procesu v reálném čase.
SimApi má mnoho funkcí a každá funkce má různá požadovaná nastavení, která je třeba provést, jak je popsáno v kapitole 3.
2.2 Úvahy o výkonu databáze
Pro použití SimApi v SIMCA-online, které se používá pro monitorování v reálném čase, je důležité, aby se zdroj dat choval jako dobrý historik procesních dat.
· Ve zdroji dat nesmí docházet k žádným prodlevám při získávání dat: aktuální data ve zdroji dat by měla odrážet aktuální stav procesu, aby dobře fungoval v SIMCA-online.

Předpoklady
· Zdroj dat musí také rychle reagovat na požadavky na data, aby server byl schopen držet krok s realizací projektů v reálném čase.
To má několik důsledků:
· Datové sklady nebo databáze, které provádějí agregaci dat, nemusí správně fungovat se SIMCA-online pro realizaci projektů v reálném čase, protože mohou způsobit zpoždění při získávání dat.
· Databáze viewS, které provádějí složité a časově náročné dotazy, hrozí, že budou příliš pomalé pro použití v SIMCA-online.
2.3 Úvahy o vytváření sítí
SIMCA-online server byste měli umístit blízko zdroje dat v síti. To zajišťuje rychlé spojení mezi SIMCA-online a jejím zdrojem dat. Síťová zařízení, jako jsou firewally, mohou rušit spojení mezi SIMCA-online a zdrojem dat. V tomto případě může být nutné upravit pravidla brány firewall. Ověřte připojení z PC, na kterém je spuštěno SimApi, ke zdroji dat pomocí napřample tlačítko Testovat připojení ve zdrojích dat ODBC.
2.4 Ovladače ODBC
SimApi vyžaduje, aby byly ovladače ODBC pro váš zdroj dat nainstalovány na PC, kde je nainstalováno SimApi. Ovladače ODBC získáte od výrobce databáze. Stáhněte a nainstalujte nejnovější dostupnou verzi. Ovladače pro Microsoft SQL Server jsou často již nainstalovány na většině počítačů se systémem Windows. Potřebujete ovladače, které odpovídají platformě SimApi. Obvykle to znamená, že 64bitové ovladače x64 lze použít s 64bitovými Windows a SIMCA a SIMCA-online. Pro staré 32bitové verze SIMCA jsou vyžadovány 32bitové ovladače ODBC.
2.5 Autentizace databáze
Databáze vyžadují autentizaci, aby SimApi mohlo přistupovat k datům, aby bylo možné přistupovat pouze k datům, která SimApi potřebuje. Správci databáze omezují přístup k databázi na konkrétního uživatele používaného SimApi. Ověření uživatele lze pomocí ODBC SimApi provést jedním ze tří způsobů:
1. Zadání uživatelského jména a hesla v dialogovém okně Konfigurace SimApi. Pověření jsou uložena v zašifrovaném formátu na PC.
2. Zadání uživatelského jména a hesla v ODBC připojení vytvořeném ve zdrojích dat ODBC (viz níže). Toto uloží pověření ve Windows.
3. Nespecifikujte pověření explicitně, ale místo toho použijte ověřování Windows a uživatelský účet, který spouští SimApi. Pro desktopovou SIMCA to znamená uživatel se systémem SIMCA a pro SIMCA-online to znamená účet služby SIMCA-online nakonfigurovaný ve službách Windows.
Kapitola 3 ukazuje, jak nakonfigurovat SimApi.
2.6 Redistribuovatelný Visual C++
Chcete-li používat SimApi na počítači, musí mít nainstalovaný následující software:
· Microsoft Visual C++ Redistributable for Visual Studio 2015-2022. To je již k dispozici na všech počítačích s nejnovějšími verzemi SIMCA nebo SIMCA-online. Chcete-li spustit SimApi v jiných kontextech, nejnovější verzi najdete na https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vcredist?view=msvc-170#visual-studio-2015-2017-2019-and-2022

Instalace a nastavení
3 Instalace a nastavení
Průvodce SimApi ke stažení z webu sartorius.com/umetrics-simapi obsahuje dobré základní informace o SimApis, jak nainstalovat, konfigurovat, odstraňovat problémy a testovat SimApi. Možná budete chtít nahlédnout do tohoto dokumentu, kde se dozvíte více o různých tématech. Chcete-li nainstalovat a nakonfigurovat toto SimApi, proveďte tyto kroky:
1. Nainstalujte ovladače ODBC pro váš databázový stroj (viz kapitola 2). 2. Nastavte připojení k databázi ODBC ve Windows ODBC Data Sources a otestujte jej
práce (podrobné kroky v další části). 3. Nainstalujte SimApi na PC pomocí jeho instalačního programu: (podrobné pokyny naleznete v kapitole 5 v
průvodce SimApi): a. Před instalací nové verze začněte odinstalováním jakékoli předchozí verze v aplikacích a funkcích systému Windows. b. Rozepněte zip file, podívejte se do souboru Version Info.txt file a uživatelskou příručku (kterou právě čtete…). C. Spusťte instalační exe file k instalaci SimApi.
4. Pokud Visual C++ Redistributable na PC není aktuální, nainstalujte nejnovější verzi (viz 2.6). 5. Přidejte SimApi do SIMCA nebo SIMCA-online, jak je popsáno v kapitole 5 v průvodci SimApi.
A. Když kliknete na tlačítko pro konfiguraci SimApi, zobrazí se tento dialog pro zadání přihlašovacích údajů k použití (informace o možnostech v předchozí kapitole):
b. Všechna ostatní nastavení pro toto SimApi se provádějí ručně v XML file pomocí textového editoru. Jak nakonfigurovat jednotlivé funkce je popsáno dále v této kapitole.
6. Otestujte SimApi. Viz kapitola 6 v průvodci SimApi.
3.1 Konfigurace připojení zdroje dat ODBC ve Windows pro použití SimApi
Aby SimApi fungovalo, vyžaduje nakonfigurované připojení zdroje dat ODBC. To vytvoříte v ovládacím panelu Zdroje dat ODBC ve Windows. Na 64bitových Windows existují dvě verze tohoto nástroje: jedna pro 32bitové aplikace a jedna pro 64bitové. Použijte ten, který odpovídá SimApi, který používáte, obvykle 64bitový, protože všechny nejnovější verze SIMCA-online a SIMCA jsou 64bitové a vyžadují 64bitové varianty SimApis. Tento snímek obrazovky ukazuje tuto aplikaci ve Windows. V tomto příkladu jsou tři různá databázová připojeníample. Níže uvedený dialog zobrazuje první stránku průvodce konfigurací pro připojení SQL serveru k serveru se01wssuite01:

Instalace a nastavení
Pokyny k použití: · Doporučujeme nakonfigurovat zdroje dat jako systémové DSN, jak je zobrazeno na snímku obrazovky. To zajišťuje, že jsou dostupné pro všechny uživatele PC včetně služeb jako SIMCA-online. · Klepnutím na Přidat přidáte nové připojení. Vyberte ovladač, který jste nainstalovali podle popisu v předchozí kapitole a který odpovídá vaší databázi, a proklikejte se průvodcem a nakonfigurujte nastavení pro připojení k vašemu databázovému serveru. · Na konci průvodce můžete vyzkoušet připojení k databázi pomocí tlačítka Testovat zdroj dat. To samozřejmě nebude fungovat, pokud zadáte uživatelské jméno a heslo v samotném ODBC (viz předchozí kapitola).
3.2 Výběr mezi dvěma způsoby přístupu k procesním datům
Existují dva způsoby přístupu k procesním datům v tomto SimApi: 1. Přímý režim. V tomto režimu určíte view jména, která by měla být vystavena prostřednictvím SimApi. Každý view se stane uzlem v SimApi a všechny sloupce v a view stát se tags. Přímý režim se doporučuje, protože jeho použití je relativně jednoduché.

Instalace a nastavení

2. Vyhledávání View Režim. Tento režim je složitější a vyžaduje specifické view v databázi zvané Lookup View. Tento view definuje tags které by měly být vystaveny prostřednictvím SimApi, ale data jsou převzata z dalších souvisejících views specifikované pro každý řádek dat ve vyhledávání view.
Níže se dozvíte více o tom, jak nastavit tyto a všechny další funkce SimApi. Vraťte se do kapitoly 1.1 a přečtěte si více o funkcích tohoto SimApi, které konfigurujete níže.

3.3 Konfigurace XML file a log file umístění
SimApi ukládá svůj protokol files ve skryté složce Program Data2: %programdata%UmetricsSimApi, kde %programdata% mapuje skutečnou složku ve vašem počítači. Výchozí je C:ProgramData.
Toto obsahuje nastavení SimApi v XML file s názvem ODBCSimApi_ .xml. Toto můžete upravit file ručně pomocí textového editoru, jako je Poznámkový blok, k provedení změn.
Každé SimApi obvykle používá svůj vlastní protokol file, který podobně jako log serveru SIMCA-online file bude obsahovat data v závislosti na nastavení úrovně protokolu. Tento file je užitečné při odstraňování problémů.
Protokol file se jmenuje ODBCSimApi_ .log.
je název instance SimApi, kterou jste přidali v SIMCA-online Server Options nebo Default pro desktop SIMCA. Napřample, pokud jste přidali pojmenovanou instanci „MyDB“ log file název bude ODBCSimApi_MyDB.log. Více se o tom dozvíte v 4.2 4.3 v průvodci SimApi.

3.4 Globální nastavení připojení
První část konfigurace XML file je nastavení připojení, které popisuje, jak se připojit k databázi.

Požadovaná nastavení jsou:

· DSN

název zdroje dat. Měl by odpovídat názvu systémového DSN ve Windows

Zdroje dat ODBC, které jste nakonfigurovali výše.

· SQLDialect

nastavte tak, aby odpovídala databázovému serveru, který používáte.

Možná budete muset nastavit nastavení LeftPunctuation a RightPunctuation, pokud jako názvy identifikátorů používáte vyhrazená klíčová slova SQL nebo používáte mezery v názvech identifikátorů vašeho views/tabulky/sloupce v databázi.

Ostatní nastavení připojení jsou volitelná.

Tato a všechna další nastavení mají také popis v tabulce na konci kapitoly.

Důležité: Některé databáze rozlišují velká a malá písmena, pokud jde o názvy databází, tabulek, views, sloupce, takže se ujistěte, že používáte správné casing použité ve vaší databázi v XML file.

3.5 Přímý režim pro kontinuální/procesní views
Každý řádek v přímém režimu view je pozorování.
Sloupce v view představují proměnné:
· Musí existovat jeden sloupec s datem a časem. Tento sloupec by měl být primární klíč a nemůže obsahovat hodnoty null. Název tohoto sloupce by měl odpovídat nakonfigurovanému nastavení TimeField v konfiguraci file. Hodnoty pro tento sloupec jsou čas stamp za postřehy.
· Sloupec datum/čas musí být typu datetime nebo datetime2. · Zbývající sloupce budou odhaleny prostřednictvím SimApi jako tags se stejnými názvy jako sloupec
jména. Hodnoty pro tyto sloupce jsou data procesu.

2 Tato složka je ve výchozím nastavení ve Windows skrytá. Abyste to viděli v File Průzkumník, který nakonfigurujete, se zobrazí skrytý files. Všimněte si, že do skryté složky můžete přejít zadáním adresy File Adresní řádek průzkumníka.

Instalace a nastavení
· Zpětný zápis je podporován pro všechny tags, ale ve zdroji dat ODBC musí být nastavena správná oprávnění. Aby bylo možné zapsat chybějící hodnoty, musí být pro sloupec podporovány hodnoty null.
Konfigurace v XML file je přímo vpřed: views a Přímý režim views: –> “/>
Poznámka: SimApi vyjmenovává sloupce pouze při spuštění. To znamená, že pokud jsou přidány nové sloupce do a view aby je SimApi odhalilo, musí být restartováno.

Obrázek 1. Tabulka přímého režimu example.
3.6 Vyhledávání View Režim pro kontinuální/procesní views
Tento view lze použít místo nebo navíc k přímému režimu viewjak je popsáno výše. Vyhledávání View je nepřímý způsob určení, které datové sloupce v ostatních views, které by měly být zkompilovány a vystaveny prostřednictvím SimApi. Ostatní views jsou buď zdroje HDB (historická data) nebo zdroje PDB (aktuální data). Zdroj PDB je volitelný. Data vystavená vyhledáváním View je prezentován SimApi jako uzel, který se vždy nazývá ODBCProcess:

Každý řádek ve vyhledávání view definuje jeden tag být vystaven prostřednictvím SimApi a které další views k tomu převzít data tag. Vyhledávání view bude tedy obsahovat mnoho řádků. Rovněž specifikuje, zda a tag je zapisovatelný, tj. pokud by SIMCA-online měla být schopna zapisovat hodnoty zpět do tohoto tag.

Z vyhledávání může být použito více zdrojů PDB a více zdrojů HDB View. ODBC SimApi tedy může agregovat data z více views do jednoho uzlu s tags které jsou vystaveny prostřednictvím SimApi.

Vyhledávání view musí obsahovat následující sloupce (v konfiguraci označované jako pole file):

· Jméno

Jméno a tag (Primární klíč, varchar, ne null).

· PDB_Source

Název view který obsahuje aktuální data pro tag (varchar). Pokud toto

obsahuje prázdnou hodnotu, program načte všechna data z HDB_Source.

· PDB_Field

Název sloupce tag ve zdroji PNR view (varchar). Pokud

Hodnota PDB_Source je vynechána, tento sloupec nebude načten.

· Zdroj HDB

Název view který obsahuje historická data pro tag (varchar).

· HDB_Field

Název sloupce tag ve zdroji HDB view (varchar).

Instalace a nastavení

· Možnost zápisu

Pokud by SIMCA-online měla být schopna zapisovat data do tohoto tag nebo ne (bit).

Všimněte si, že pro každý sloupec výše uvedený popis také uvádí, které řádky by měly být primárním klíčem a typ dat pro každý sloupec.

Názvy sloupců jsou libovolné, protože názvy jsou uvedeny v konfiguraci file.

Obrázek 2. Přample z vyhledávání view ve formě databázové tabulky. Na snímku obrazovky uvidíte, že je použit jeden zdroj PDB a jeden zdroj HDB. Sloupec Název určuje tag názvy, které bude SimApi používat, a v tomto případě sloupce _Field používají stejné názvy sloupců. Pouze jeden tag je zapisovatelný.

3.6.1 PNR views a HDB views
Když použijete Lookup View také potřebujete alespoň jeden HDB view. The views pro historická data (HDB) a volitelné views pro aktuální data PDB mají oba stejnou datovou strukturu (sloupce).
Každý řádek v PDB nebo HDB views představuje pozorování s hodnotami pro každý z nich tag v tom PNR/HDB view jak je uvedeno ve vyhledávání view.
Rozdíly mezi PDB a HDB jsou:

· PNR view obsahuje pouze jeden řádek dat pro tags specifikované ve vyhledávání view. Měl by mít také čas svamp sloupec, kdy byl naposledy aktualizován.
· HDB view obsahuje několik řádků dat pro tags specifikované ve vyhledávací tabulce. Každá řada má čas stamp obsahující historické časyamp pro konkrétní pozorování.

PDB a HDB views by měl mít následující sloupce,

· Datum a čas

Pro PDB: Čas, kdy byla tabulka naposledy aktualizována (primární klíč, datum a čas nebo

datetime2, nikoli null).

Pro HDB: Historický čas pro tag hodnoty (primární klíč, datum a čas nebo

datetime2, nikoli null).

· [Název sloupce] Každý by měl obsahovat jeden sloupec tag který byl uveden ve vyhledávací tabulce.

Obsahuje data pro tag v každém řádku.

Všimněte si, že pro každý sloupec výše uvedený popis také uvádí, které řádky by měly být primárním klíčem a typ dat pro každý sloupec.
Názvy sloupců jsou v databázi libovolné, protože názvy jsou uvedeny v konfiguraci file.
Následující sloupce nejsou povinné, ale je užitečné je přidat, pokud jsou šarže modelovány s více fázemi a v procesu je několik jednotek:

· UnitBatchID

Jeden sloupec na jednotku, který obsahuje ID dávky v rámci určité jednotky (varchar).

Tento tag lze použít v identifikátoru dávky tag pole pro tuto jednotku na stránce Podmínky provedení

konfiguraci tohoto projektu v SIMCA-online.

Instalace a nastavení

· PhaseID

Jeden sloupec na jednotku, který obsahuje informace o fázi pro jednotku (int, float nebo varchar).

Tento tag lze použít v logickém výrazu v poli Fáze provedení podmínky v konfiguraci tohoto

projekt v SIMCA-online.

Maximální povolený počet tags (sloupců) je 255.

Obrázek 4. PNR example.
Obrázek 3. HDB example.
3.7 Dávkový uzel
Uzel dávky obsahuje metainformace o dávkách, jako je čas zahájení, čas ukončení a volitelně podmínky dávky. SIMCA-online vyžaduje dávkový uzel pro analýzu dávkových dat, ale u kontinuálního (nedávkového) projektu jej lze vynechat. Název dávkového uzlu viděný ze SIMCA-online nebo SIMCA je původní název uzlu view nebo tabulka v databázi, v tomto example "BatchData":
Každý řádek v uzlu dávky představuje jednu dávku.

Instalace a nastavení

Dávka view musí mít následující sloupce:

· BatchID

Název dávky (primární klíč, varchar, ne null).

· BatchStart

Čas zahájení dávky, když poprvé vstoupí do celého procesu (nikoli když je

začíná v jednotce (části) v procesu) (datetime nebo datetime2, nikoli null).

· BatchStop

Čas, kdy je celá dávka dokončena v systému (nikoli v jednotce), null if

nedokončeno (datetime nebo datetime2).

Všimněte si, že sloupec BatchID by měl být primární klíč.

Kromě toho mohou pro každou proměnnou dávkové podmínky existovat následující volitelné sloupce:

· [Název podmínky dávky]

Jeden sloupec pro každou dávkovou podmínku. Název sloupce bude

použit jako tag jméno. (float pro číselné hodnoty nebo varchar pro text, jako je id konfigurace).

· UnitID

Název jednotky, ke které je dávka přidružena

(varchar).

Názvy dávkového uzlu a sloupců jsou v databázi libovolné, protože názvy jsou uvedeny v konfiguraci file.

Obrázek 5. Dávkový uzel example se dvěma dávkovými podmínkami (bc1 a bc2) a sloupcem UnitID.

3.8 Údaje o dávkách Views
Údaje o každé dávce view musí mít tyto tři sloupce (další sloupce budou ignorovány):

· BatchID · Tag jméno · Hodnota
text nebo float3).

název dávky (varchar, ne null) název proměnné podmínky dávky (varchar, ne null) hodnota proměnné podmínky dávky (float pro číselné hodnoty nebo varchar pro

Kombinace BatchID a Tag název by měl být primární klíč (pokud nechcete použít funkci více dávkových instancí dat).

Údaje o každé dávce view je vystaven jako uzel pomocí SimApi. Název uzlu je view jméno v databázi. The view název a názvy sloupců se konfigurují v konfiguraci XML file pomocí atributů jednoho BatchDataView prvek jako tento:

3 Pomocí textového sloupce varchar můžete ukládat text (data pro kvalitativní proměnné v projektu SIMCA). Číselná čísla však můžete ukládat také v textovém formátu a SimApi je převede na čísla. Tímto způsobem můžete nějaké mít tags které jsou numerické a některé obsahují text.

Instalace a nastavení

<BatchDataView ViewName=”DatabázeViewOrTableName” BatchIDColumn=”BatchID” TagNameColumn=”Tag name” ValueColumn=”Value” />
Všimněte si, že zde použité hodnoty odpovídají tabulce na obrázku 5. Přidejte více dávkových dat views přidáním dalších BatchDataView prvky.

3.8.1 Instance syntetických dávkových dat tags
Chcete-li nakonfigurovat volitelnou instanci dávkových dat tags, přidáte atributy NumSyntheticBatchTags a TimeColumn do BatchDataView živel:
<BatchDataView ViewName=”DatabázeViewOrTableName” BatchIDColumn=”BatchID” TagNameColumn=”Tag name” ValueColumn=”Value” TimeColumn=”TimeColumn” NumSyntheticBatchTags="3" />
TimeColumn je název časového sloupce ve vaší databázi view. Tento sloupec musí být poskytnut pro instanci dávkových dat tags.
Povolená hodnota pro NumSyntheticBatchTags jsou číselné hodnoty mezi 1 a 10. To určuje, kolik syntetických instancí tags jsou vytvořeny na reálné tag. Napřample, pro tag „tag“nové tags „tag_1“, „tag_2“, … “tag_N” bude vytvořen, dokud N= NumSyntheticBatchTags.

3.8.2 ID dávky syntetického procesu tags filtrováno podle hodnot sloupců
Konfigurace volitelného filtru ID dávky tags které lze použít pro režim kontinuálního načítání dat, přidáte do BatchData atributy FilterColumns a TimeColumnView živel:
<BatchDataView ViewName=”DatabázeViewOrTableName” BatchIDColumn=”BatchID” TagNameColumn=”Tag název” ValueColumn=”Value” FilterColumns=”Column1|Column2″ TimeColumn=”TimeColumn”/>
FilterColumns by měl obsahovat jeden nebo více názvů sloupců v databázi view. Pokud je použito více názvů sloupců, oddělte je svislou čarou (|).
TimeColumn by měl být název časového sloupce ve vaší databázi view. Tento sloupec musí být poskytnut pro instanci dávkových dat tags.

3.9 Diskrétní uzly
Volitelné diskrétní uzly obsahují měření diskrétních dat. Každý řádek v samostatném uzlu představuje jedno měření pro dávku a tag v daném čase.

Diskrétní uzel musí mít následující sloupce:

· BatchID · TagJméno · Čas · Hodnota

Název dávky (varchar, ne null). Název tag (varchar, ne null). Doba, kdy sampsoubor byl převzat (datetime nebo datetime2, nikoli null). Naměřená hodnota (float). Diskrétní data nemohou být řetězcová data.

Všimněte si, že kombinace BatchID+TagPrimárním klíčem by měl být název+čas.

Každý nakonfigurovaný diskrétní uzel je v SimApi vystaven jako uzel. Název uzlu je view jméno v databázi, pokud není přepsáno. název uzlu, view jméno, vyhledávání viewa názvy sloupců jsou nakonfigurovány v konfiguraci XML file pomocí atributů prvku DiscreteNode, jako je tento:

<DiscreteNode NodeName=”ODBCDiscrete” ViewJméno = "Diskrétní" TagvyhledáváníView= "Diskrétní."Tags” BatchIDField=”BatchID” TimeField=”Time” TagNameField=”TagNázev” ValueField=”Value”/>

Výše uvedený example odkryje uzel s názvem ODBCDiscrete pomocí SimApi, vyjmenuje tags pomocí DiscreteTags tabulka/view. Data se čtou z diskrétní tabulky/view pomocí nakonfigurovaných sloupců.

Instalace a nastavení
Názvy diskrétního uzlu a jeho sloupců jsou v databázi libovolné, protože názvy jsou uvedeny v konfiguraci file.
Obrázek 6. Diskrétní uzel example se dvěma tags sampvedeny třikrát (v přibližně 24hodinových intervalech) na šarži.
3.9.1 Diskrétní Tag Definice View
Tato volitelná view používá SimApi k výčtu diskrétních tags který by měl být dostupný přes SimApi. To se děje při spuštění SimApi. Možná budete chtít použít toto view pro optimalizaci výkonu při načítání SimApi nebo pokud chcete ovládat co tags jsou vystaveny ze SimApi. Například pokud chcete vystavit tags který při spuštění SimApi ještě nemá žádné měření.
Obrázek 7. Jednoduchý diskrétní tag vyhledávání view který používá diskrétní tabulku.

Instalace a nastavení
3.9.2 Diskrétní data, jak je vidí SIMCA-online
Níže je uvedeno, jak diskrétní data na obrázku 6. Diskrétní uzel example se dvěma tags sampvedl třikrát (v přibližně 24hodinových intervalech) na dávku. Obrázek 6 Obrázek 2Chyba! Referenční zdroj nenalezen. Bude se hledat v SIMCAonline, když se zkombinuje s dávkami na obrázku 5.
Obrázek 8. Diskrétní data, jak je vidí SIMCA-online. Všimněte si, že vygenerovaná dávka stáří tags představují stáří šarže pro každé pozorováníample.
3.10 Několik poznámek k SIMCA-online Write Back
Zpětný zápis v SIMCA-online lze použít k zápisu dat ze SIMCA-online do zdroje dat ODBC. Podporován je zápis dat o průběžném procesu (z průběžných konfigurací, úrovně vývoje šarže nebo z Control Advisor) a dat šarží (z úrovně šarže). Nedoporučuje se zapisovat zpět do stejných uzlů, které používáte ke čtení dat, protože by se to pokusilo přidat do databáze duplicitní řádky se stejnými primárními klíči. views kvůli primárním klíčům doporučujeme ve sloupcích datum/čas a ID dávky (viz výše). Místo toho vytvořte jeden nebo více přímých režimů views pro nepřetržitá/evoluční data nebo dávkové uzly pro dávková data, která se mají použít pro zpětný zápis. Důvodem tohoto problému je, že ODBC SimApi používá příkazy SQL INSERT k přidání nového řádku dat pro každé pozorování nebo pro každou dávku na úrovni dávky.
· U průběžných dat se čas pozorování zapisuje zpět spolu s hodnotami ze SIMCAonline.
· U dat dávek je ID dávky zapsáno zpět společně s hodnotami ze SIMCA-online. · Pokud jsou chybějící hodnoty zapsány zpět, budou zapsány jako null, takže databáze musí podporovat hodnoty null
aby to fungovalo. Vzhledem k tomu, že čas pozorování nebo id dávky dávky je zapsán zpět, porušilo by to omezení primárního klíče v databázích, pokud by již byly přítomny stejné hodnoty (jak by tomu bylo, kdyby byla data čtena ze stejných uzlů). Kromě těchto rozdílů v primárním klíči platí pro uzly pro zpětný zápis stejné schéma databáze (další informace viz výše):

Instalace a nastavení

· Pro spojité uzly by měl existovat sloupec data/času a pro uzly dávky sloupec ID dávky. · Přidejte jeden datový sloupec pro každý tag který by měl být k dispozici pro odepsání. Použijte datový typ float pro
číselná data a varchar pro textová data (například při zpětném zápisu id konfigurace konfigurace). Napřample,, pokud plánujete zapsat zpět 20 různých datových vektorů ze SIMCA-online, musíte do databáze přidat 20 datových sloupců view. · Sloupce musí umožňovat hodnoty null pro podporu zpětného zápisu chybějících hodnot

3.11 Konfigurace XML File
Tato tabulka uvádí všechna nastavení v konfiguraci XML file. Tyto informace a výše uvedené popisy použijte ke konfiguraci SimApi.

Nastavení specifická pro připojení

Vysvětlení

DSN

Název zdroje dat podle nastavení v ovládacím panelu Správce ODBC systému Windows.

SQLDialect

Dialekt SQL, který se má použít. Jedna z těchto hodnot: standard, postgresql, db2, mssql, mysql, oracle, access, denodo. Pokud ponecháte prázdné, použije se standardní, ale výchozí pro nový XML-file je mssql.

Pověření

Uloženo uživatelské jméno a heslo ODBC v zašifrované podobě. Pomocí tlačítka Konfigurovat zadejte uživatelské jméno a heslo.

QueryTimeout

Čas před dotazem nebo připojením k databázi vyprší a selže.

DBSchema

Schéma databáze v databázi (pokud existuje). Databázové schéma je způsob, jak logicky seskupit objekty, jako jsou tabulky, views, uložené procedury atd. Představte si schéma jako kontejner objektů. Uživateli můžete přiřadit oprávnění k přihlášení k jednomu schématu, takže uživatel může přistupovat pouze k objektům, ke kterým má oprávnění. Schémata lze vytvářet a měnit v databázi a uživatelům lze udělit přístup ke schématu. Schéma může vlastnit jakýkoli uživatel a vlastnictví schématu je přenosné.

Levá interpunkce

Levý oddělovač specifický pro dialekt SQL používaný k oddělení identifikátorů od ostatních příkazů SQL. Výchozí hodnota je prázdná, což znamená, že není použita žádná levá interpunkce. Pokud identifikátory v databázi používají mezery nebo vyhrazená klíčová slova SQL, musíte zadat neprázdnou hodnotu. Pro SQL Server nebo Access používáte „[“, ale pro Oracle a další databáze používající standard SQL byste měli toto nastavení nastavit na „““ (toto je sekvence escape XML pro dvojité uvozovky „).

Pravá interpunkce

Oddělovač vpravo specifický pro dialekt SQL používaný k oddělení identifikátorů od příkazů SQL. Pro SQL Server nebo Access používáte „]“, ale pro Oracle a další databáze používající standard SQL byste měli toto nastavení nastavit na „““ jako pro levou interpunkci výše.

Vyberte StatementTerminator

Specifické pro SQL dialekt. Znak, který se má použít k ukončení příkazů select. U některých dialektů a verzí je nutné toto nastavit na prázdný řetězec „“. Výchozí hodnota je „;“.

DatabaseConnectionPoolSize

Maximální počet povolených souběžných připojení k databázi. Výchozí hodnota je 10. Toto nastavení může zlepšit výkon tím, že umožní více než jednomu vláknu současně přistupovat k databázi. Více se dozvíte v kapitole 1.

Instalace a nastavení

Nastavení specifické pro databázi

UseLocalTime

Určuje, zda jsou data v databázi uložena jako místní čas nebo UTC. Výchozí hodnota je „1“, což znamená, že je použit místní čas.

Specifická nastavení přímého režimu

Tabulky

Název views, která obsahuje průběžná/procesní data. Násobek views lze zadat oddělením jejich názvů svislým znakem (|). Napřampsoubor: Tabulka1|Tabulka2|Tabulka3|View1. Název TimeField musí být ve všech případech identický views.

vyhledávání view konkrétní nastavení

Vyhledávací tabulka

Název vyhledávání view nebo stůl.

TagNameField

Název sloupce, kde je tag jména jsou uvedena.

PDBTableField

Název sloupce ve vyhledávání view. Pro každý řádek tento sloupec obsahuje název PDB view. Jméno a view s údaji z PNR. Může být ponecháno prázdné, pokud ano, použije se místo něj pro aktuální data nejnovější řádek HDB.

PNRTagPole

Název sloupce v tabulce PDB, kde jsou data pro tag lze nalézt (nepoužívá se, pokud je vynecháno PDBTableField).

HDBTableField

Název sloupce ve vyhledávání view. Pro každý řádek tento sloupec obsahuje název HDB view.

HDBTagPole

Název sloupce ve vyhledávání view. Pro každý řádek tento sloupec obsahuje název a tag v HDB view.

Writeable Field

Název sloupce, který říká, zda tag je zapisovatelný nebo ne.

Přímý režim a HDB/PDB view konkrétní nastavení

TimeField

Název sloupce data/času v Průběžné/Proces View a PDB- nebo HDB-views (nebo tabulky).

Dávková nastavení konkrétního uzlu

Dávková tabulka

Název view nebo tabulka, která obsahuje data dávky. Vícenásobná dávka view lze zadat oddělením jejich názvů svislou čarou (|). Napřampsoubor: BT1|BT2|BT3. Všechny následující sloupce musí být identické views.

BatchIDField

Název sloupce ID dávky v uzlu dávky.

StartTimeField

Název sloupce počátečního času pro dávku.

StopTimeField

Název sloupce času zastavení pro dávku.

BatchIDUnitField

Název sloupce ID jednotky v uzlu dávky. Toto pole lze použít ke generování syntetického procesu ID dávky tags filtrováno podle ID jednotky.

Dávkový uzel s podporou filtrování One prvek s následujícími atributy, které řídí

nastavení

nastavení pro syntetický filtrovaný dávkový uzel.

Instalace a nastavení

ViewNázev BatchIDColumn StartTimeColumn StopTimeColumn FilterColumn
FilterValues
Údaje o dávkách view nastavení Nastavení specifická pro diskrétní uzel
Název_uzlu ViewJméno TagvyhledáváníView
BatchIDField TimeField TagNameField Protokol hodnoty pole file specifická nastavení LogFileVelikost LogLevel

Název view nebo tabulka, která obsahuje data dávky.
Název sloupce ID dávky dávky.
Název sloupce počátečního času pro dávku.
Název sloupce času zastavení pro dávku.
Název sloupce, který obsahuje hodnoty filtru v uzlu dávky. Pokud nepotřebujete funkci filtrování, můžete toto nastavení ponechat prázdné.
Hodnoty, které by měly být použity k filtrování dávek. Více hodnot filtru je odděleno znakem svislé čáry (|). Pokud filtrování nepotřebujete, ponechte prázdné. Napřample: FilterValue1| FilterValue2| FilterValue3. Tohle je exampjak by to mohlo vypadat v konfiguraci file: ViewName=”BatchNode” BatchIDColumn=”BatchID” StartTimeColumn=”StartTime” StopTimeColumn=”StopTime” FilterColumn=”Unit FilterValues=”FilterValue1| FilterValue2″ /> Vícenásobné prvky jsou podporovány. Všimněte si, že mezi dávkovými uzly můžete mít různé názvy sloupců.
Uloženo v jednom nebo víceView> prvky. Viz 3.8 Data šarže Views.
An prvek pro každý diskrétní uzel s následujícími atributy. Viz 3.9 Diskrétní .
Název uzlu, jak jej zobrazí SimApi. Pokud je ponecháno prázdné, hodnota ViewJméno bude použito.
Název view/tabulka, která obsahuje diskrétní data. Pokud je ponecháno prázdné, uzel je zakázán.
Název view/tabulka, která definuje diskrétní tags používat. Pokud ponecháte prázdné, ViewNázev bude analyzován při spuštění, aby se vyjmenovaly všechny tags tam.
Název sloupce identity měřené dávky.
Název sloupce času měření.
Název sloupce tag to bylo měřeno.
Název sloupce hodnoty měření.
Maximální povolená velikost protokolu file před file je zkrácený.
Čím vyšší hodnota, tím více informací se vytiskne do protokolu file. Maximální hodnota je 4 a minimální hodnota je 0. (0 = kritické, 1 = chyba, 2 = varování, 3 = informace, 4 = ladění).

Podpora
4 Podpora
Toto SimApi je vyvinuto společností Sartorius Data Analytics. Pro podporu navštivte prosím sartorius.com/umetrics-support.

Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Švédsko
Telefon: +46 90-18 48 00 www.sartorius.com
Informace a obrázky obsažené v tomto návodu odpovídají níže uvedenému datu verze. Sartorius si vyhrazuje právo provádět změny v technologii, vlastnostech, specifikacích a designu zařízení bez předchozího upozornění. Pro usnadnění čitelnosti těchto pokynů se používají tvary mužského nebo ženského rodu a vždy současně označují všechna pohlaví.
Upozornění na autorská práva: Tyto pokyny, včetně všech součástí, jsou chráněny autorským právem. Jakékoli použití nad rámec autorského zákona není bez našeho souhlasu povoleno. To platí zejména pro dotisk, překlad a editaci bez ohledu na typ použitého média.

Podpora