Software SARTORIUS Sim Api

Specifikace

• Název produktu: SimApi Guide
• Datum vydání: 5. září 2024
• Účel: Poskytování dat produktům Umetrics Suite

Návod k použití produktu

Úvod do SimApis

• SimApis se používají k získávání dat pro tvorbu projektů a modelování v produktech Umetrics Suite.

Získání SimApis

• Chcete-li získat SimApis, podívejte se na oficiální dokumentaci nebo kontaktujte zákaznickou podporu.

Vlastnosti SimApi

• SimApis poskytuje data v reálném čase pro monitorování, řízení a vytváření modelů v SIMCA a SIMCA-online.

Pouze aktuální využití dat

• Pro optimální výkon se doporučuje používat pouze aktuální data a vyhnout se historickým datům.

Příprava na instalaci SimApi

• Před instalací se ujistěte, že váš systém splňuje minimální požadavky uvedené v uživatelské příručce.

Instalace SimApi

• Při instalaci SimApi do vašeho systému postupujte podle pokynů krok za krokem v uživatelské příručce.

Nastavení SimApi pro SIMCA

• Nakonfigurujte nastavení SimApi v SIMCA podle poskytnutých pokynů.

Nastavení SimApi pro SIMCA-online

• Nastavte SimApi pro operace načítání dat a zpětného zápisu v reálném čase v SIMCA-online.

Testování a odstraňování problémů

• Po instalaci proveďte testování, abyste zajistili správnou funkčnost. V případě problémů nahlédněte do části odstraňování problémů v uživatelské příručce.

Testování od SIMCA-online

• Otestujte integraci SimApi ze SIMCA-online a ověřte načítání dat.

Odstraňování problémů s Log Files

• Použijte protokol SimApi file k identifikaci a řešení jakýchkoli instalačních nebo provozních problémů.

Konfigurace účtu služby

• Pro bezproblémový provoz zajistěte správnou konfiguraci účtu služby SIMCA-online.

Technické detaily

• Podrobné technické informace o SimApis najdete v části 7 uživatelské příručky.

Úvod do SimApis

• SimApi je softwarové rozhraní mezi softwarem Umetrics® Suite a zdrojem dat. Primárním účelem SimApi je poskytovat data SIMCA®-online nebo SIMCA®.
• Sartorius Stedim Data Analytics AB vyvíjí SimApis pro mnoho různých zdrojů dat, jako jsou historiky procesů a univerzální databáze.
• Tento dokument ukazuje, co je SimApi a jak se používá v produktech Umetrics Suite. Dozvíte se, jak naplánovat a nainstalovat SimApi, jak odstraňovat problémy a jak instalaci otestovat. Poslední kapitola obsahuje technické detaily SimApis zaměřené na vývojáře.

Účel SimApi: poskytování dat produktům Umetrics Suite

• Primárním účelem SimApi je poskytovat data SIMCA-online nebo SIMCA ze zdroje dat. Zdroj dat není součástí SIMCA-online, ale může to být procesní historik nebo jiný systém, který data uchovává a spravuje.
• SimApi odhaluje hierarchii uzlů odpovídající složkám v a file systém. Každý uzel může obsahovat další uzly, popř tags. A tag odpovídá proměnné. Pro tyto tagslze získat data. Obrázek ukazuje a tag, Temp, vybrané v uzlu
• BakersYeastControlGood ve zdroji dat v SIMCA-online. Zobrazuje také nejnovější hodnoty převzaté ze zdroje dat.

Použití SimApi v Umetrics Suite

• Desktopový software SIMCA může použít SimApi k načtení dat pro tvorbu projektů a modelování, jak ukazuje následující obrázek.
• SIMCA-online využívá SimApis k získávání dat v reálném čase pro monitorování a řízení, stejně jako zpětný zápis dat do zdroje dat. Následující obrázek ukazuje, kde je SimApi v systému sestávajícím ze zdroje dat, SIMCA-online serveru a klientů.

Běžně používaný SimApis

• Nejpoužívanější SimApis jsou:
• PI AF SimApi pro připojení k Aveva (dříve OSIsoft) PI Systems.
• OPC UA SimApi
• ODBC SimApi – pro obecný přístup k databázím, jako je SQL Server nebo Oracle
• Všechny dostupné SimApis jsou uvedeny spolu s jejich funkcemi v odstavci 3.

DBMaker SimApi pro data simulace

• DBMaker je aplikace dodávaná s instalací SIMCA-online serveru. Simuluje zdroj dat, jako je historik procesů, pomocí předem nahrané datové tabulky, kde jsou pozorování poskytována jedno po druhém do SIMCA-online prostřednictvím DBMaker SimApi.
• DBMaker se používá pouze pro demonstrační účely a nelze jej použít v produkci s živými daty ze zdroje dat. Další informace o DBMakeru naleznete ve vestavěné nápovědě.

Další dokumentace

• Tento dokument je jedním ze sady souvisejících dokumentů, z nichž každý má jiné zaměření a cílovou skupinu:

Zdroj	Co	Kde
SIMCA-online web strana	Úvodní informace a stahování	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe a instalace.pdf	Instalace a jak začít s SIMCA- online demo data	V instalačním zipu file
SIMCA-online Implementační příručka	Nastiňuje funkcionalitu SIMCA online, uvádí ji do kontextu s dalším softwarem Umetrics Suite, popisuje požadavky a osvědčené postupy pro úspěšné nasazení a podrobné pokyny k instalaci.	sartorius.com/umetrics-simca- online
Průvodce SimApi	Příprava a provádění instalací SimApi, včetně odstraňování problémů. Také obsahuje technické podrobnosti o SimApis pro vývojáře.	sartorius.com/umetrics-simapi
Uživatelské příručky SimApi	Dokumentace pro každé publikované SimApi s funkcemi, pokyny k instalaci a specifikací konfigurace.	sartorius.com/umetrics-simapi
SIMCA-online technický průvodce	Technická reference pro plánování instalace serveru SIMCA-online, řešení problémů a podrobné informace o tom, jak SIMCA-online funguje.	sartorius.com/umetrics-simca-online
SIMCA-online nápověda	Web-založená nápověda o tom, jak používat SIMCA-online a jak SIMCA-online funguje.	V samotném softwaru a dále sartorius.com/umetrics-simca
SIMCA-online Web Průvodce instalací klienta	Popisuje instalaci SIMCA-online Web Klient.	sartorius.com/umetrics-simca-online
Umetrics znalostní báze	Prohledávatelná databáze s články o každé vydané verzi softwaru, technickými články a známými problémy v produktech Umetrics Suite.	sartorius.com/umetrics-kb
Nápověda/uživatelská příručka SIMCA	Jak používat desktop SIMCA pro vytváření projektů a modelování dat.	V SIMCA a dál sartorius.com/umetrics-simca
Podpora web strana	Jak získat technickou podporu.	sartorius.com/umetrics-support

Technická podpora

• Tým online podpory Sartorius odpovídá na technické otázky o SimApis a může také předávat požadavky na vylepšení SimApis příslušným lidem. Více se dozvíte na sartorius.com/umetrics-support.

Získání SimApis

• Poskytujeme dokumentaci k dostupným SimApis a odkazy na instalační programy na sartorius.com/umetrics-simapi.
• Každé SimApi je zdokumentováno v jeho uživatelské příručce.
• Průvodce SimApi, který právě čtete, doplňuje tyto informace o doplňující informace SimApi, pokud jde o plánování, instalaci a odstraňování problémů SimApi.

Funkce SimApi

• Ne všechny zdroje dat jsou stejné. SimApi nemusí implementovat všechny funkce ve specifikaci. Z těchto důvodů nabízejí různé SimApis různé funkce. Následující matice uvádí dostupné SimApis a jejich funkce.
• Funkce jsou vysvětleny níže. Všimněte si, že tabulka má samostatné sloupce, které ukazují, které funkce jsou dostupné v SIMCA-online a SIMCA.

Funkce	Účel	SIMCA-online použití	Využití SIMCA
Aktuální data	Přečtěte si jedno pozorování s nejnovější hodnotou ze zdroje dat.	Normální provádění v reálném čase	–
Historická data	Přečtěte si mnoho pozorování najednou s historickými daty ze zdroje dat.	Dohánět a předvídat minulá data, vytvářet projekty pomocí File > Nové	Průvodce importem databáze pro import procesních dat pro vytvoření modelu.
Diskrétní data	Přečtěte si laboratorní/IPC data ze zdroje dat. Mnoho pozorování na várku.	Pro dávkové projekty s fázemi nebo dávkovými podmínkami nakonfigurovanými pro diskrétní načítání dat.	–
Údaje o dávkách	Přečtěte si podmínky šarže a konečné atributy kvality (příp	Dávkové podmínky nebo místní centrování.	Průvodce importem databáze pro čtení podmínek dávky

Funkce	Účel	SIMCA-online použití	Využití SIMCA
	jiná data typu MES). Jedno pozorování na šarži.		tvorba modelu na úrovni dávky.
Dávkový uzel	Zadejte čas zahájení a čas ukončení (prázdný pro aktivní dávku) pro konkrétní dávku. Vyjmenujte všechny dávky, které existovaly v časovém rozsahu.	Vyžadováno pro provádění dávkových konfigurací.	Průvodce importem databáze pro výběr dávek k importu.
Zpětný zápis – průběžná data	Zapisujte souvislá data, jako jsou předpovědi, zpět do zdroje dat.	Zapište zpět data z úrovně vývoje dávky, pro Control Advisor nebo pro nepřetržité konfigurace	–
Odepište – diskrétně	Zapisujte diskrétní data, jako jsou předpovědi, zpět do zdroje dat.	Zpětný zápis pro dávkové konfigurace na úrovni vývoje dávky pro fáze konfigurované pro diskrétní načítání dat	–
Zpětný zápis – dávková data	Zapište zpět data na úrovni dávky, jako jsou předpovědi nebo atributy konečné kvality, do zdroje dat.	Odepište pro konfiguraci dávky na úrovni dávky	–
Hierarchie uzlů	SimApi podporuje hierarchii uzlů, podobně jako a file systém. Každý uzel může obsahovat tags a další uzly. Hierarchie usnadňuje správu velkého počtu uzlů a tags.	Podporováno na všech místech tags se používají.
Pole tag rozšíření	Pole tag ukládá více hodnot. SimApi rozšiřuje pole tag mnoha jednotlivcům tags, jeden pro každý prvek v poli.	Podporováno kde tags se používají pro průběžná data. Každá se rozšířila tag musí být namapována na proměnnou v projektu SIMCA.
Více zdrojů dat	SimApi se může připojit k více než jednomu zdroji dat nebo podporuje více instancí sebe sama s individuálním nastavením a protokolem files pro každý případ.	Připojte se k několika různým zdrojům dat stejného druhu.	–
Odolnost připojení	Pokud se SimApi odpojí od zdroje dat, pokusí se automaticky obnovit připojení.	SimApi není nutné restartovat, aby se obnovilo připojení ke zdroji dat.	–
Vyvinuto in-house	SimApi vyvíjí, poskytuje a podporuje

Nedoporučujeme pouze aktuální data bez historických dat

• Některé SimApisy, zejména OPC DA, podporují pouze čtení aktuálních dat, nikoli historických dat.
• SimApi, které podporuje pouze aktuální data, nelze použít v desktopové SIMCA, protože nebude schopno číst historická data, na kterých by bylo možné stavět modely.
• Pro SIMCA-online důrazně doporučujeme zdroj dat a SimApi, které poskytují nejen aktuální data pro provádění v reálném čase, ale také historická data, aby bylo možné předvídat a dohánět minulá data. SIMCA-online podle potřeby automaticky přepíná mezi daty v reálném čase a historickými daty a nelze to vypnout.
• Zdroj dat, který poskytuje pouze aktuální data, ale ne historická data, může fungovat pro kontinuální projekty v SIMCA-online, ale pro dávkové projekty jsou historická data vyžadována.

Příprava na instalaci SimApi

• Tato část popisuje důležité informace pro úspěšnou instalaci SimApi.

64bitový nebo 32bitový SimApis

• Existují 32bitové a 64bitové verze každého SimApi.
• SIMCA-online a SIMCA jsou 64bitové a vyžadují 64bitové varianty SimApis. Starší 32bitové SimApis jsou stále k dispozici pro starší instalace.

Místo pro log file A nastavení

• SimApi ukládá svůj protokol files ve skryté složce Program Data1:
  %programdata%\Umetrics\SimApi, kde %programdata% se mapuje do skutečné složky ve vašem počítači. Výchozí je C:\ProgramData.
• Každé SimApi obvykle používá svůj vlastní protokol file, který podobně jako log serveru SIMCA-online file bude obsahovat více či méně dat v závislosti na nastavení úrovně protokolu. Tento file je užitečné při odstraňování problémů. Protokol file se jmenuje
  .log kde je SimApi, které instalujete, napřample PIAFsimApi. V další části naleznete také názvy instancí SIMCA-online SimApi.
• Tato složka také obsahuje nastavení SimApi v XML file jmenoval .xml.
• Většina SimApis má grafické uživatelské rozhraní, které mění nastavení v xml file, ale u některých zadáváte změny přímo do XML file pomocí textového editoru, jako je Poznámkový blok. Viz uživatelská příručka pro každé SimApi.

File jména při použití pojmenovaných instancí se SIMCA-online

• V SIMCA-online má každá instance SimApi svou vlastní konfiguraci file a log file pracovat s více instancemi každého SimApi. Jména těchto files jsou doplněny názvem instance, jak je uvedeno na záložce SimApi v dialogu SIMCA-online Server Options.
• Následující example ukazuje pojmenování těchto files, kde je třeba nahradit názvem SimApi.
• Název konfigurace zadaný při přidání instance: OmegaServer
• Konfigurace file jméno: OmegaServer.xml
• Log file jméno: OmegaServer.log
• Všimněte si, že generický file .log file je stále vytvořen. Tento protokol file obsahuje záznamy, které z technických důvodů nelze přesměrovat do logu file z případů..
• 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.
• Všimněte si, že SIMCA nepodporuje více instancí SimApi, a proto používá názvy bez názvu instance, jak je popsáno výše.

Plánování 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é vybavení může rušit spojení mezi SIMCA-online a zdrojem dat.

Uživatelské účty a oprávnění ke zdrojům dat

• Zdroje dat obvykle řídí přístup ke svým datům. To se obvykle provádí pomocí uživatelských jmen a hesel, ale lze také použít omezení na základě IP adresy nebo DNS (např.ample PI důvěřuje systému Aveva PI).
• Uživatelské jméno a heslo lze poskytnout zdroji dat různými způsoby:
• SimApi se spouští jako uživatel systému Windows uživatele, který na počítači se serverem používá desktopovou SIMCA nebo SIMCA-online servisní účet. SimApi se může připojit ke zdroji dat pomocí tohoto účtu. Takto fungují OPC I a PI SimApi a ODBC, pokud při konfiguraci nezadáte přihlašovací údaje.
• Pro generické ODBC můžete použít aplikaci ODBC Data Sources Administrator, kterou najdete na Start ve Windows.
• Někteří poskytovatelé databází poskytují své vlastní ovladače a nástroje pro své databáze. Oracle databáze, napřamppoužijte komponenty Oracle Data Access Components (ODAC).
• Některé SimApis, jako je PI AF a ODBC, mají konfigurační dialogy, které ukládají zašifrované přihlašovací údaje v konfiguraci SimApi XML. file.
• PI má také různé možnosti zabezpečení dostupné v nástrojích PI System Management Tools na počítači serveru PI. Přečtěte si více v uživatelské příručce PI AF SimApi. Tato příručka je užitečná, i když používáte starší OSIsoft PI SimApi.
• OPC DA a HDA používají DCOM jako přenos mezi zdrojem dat a SimApi. DCOM je konfigurován pomocí nástroje Component Services (DCOMCNFG.EXE) v systému Windows a používá ověřování systému Windows.
• Pro starší OSIsoft PI SimApi (nikoli novější AF SimApi) se k nastavení připojení k serveru PI používá aplikace OSIsoft AboutPI-SDK (PISDKUtility.exe).

Ověření připojení zdroje dat
Pokud chcete nainstalovat SimApi do počítače, může být užitečné ověřit připojení z tohoto počítače ke zdroji dat pomocí jiného nástroje:

• Zdroje dat ODBC ve Windows se používají ke konfiguraci a testování generického ODBC. Všimněte si, že v 64bitovém systému Windows existují dvě verze tohoto nástroje: jedna pro 32bitové aplikace a jedna pro 64bitové. Pomocí tlačítka Testovat zdroj dat na konci průvodce konfigurací ODBC ověřte připojení k databázi. Doporučujeme nakonfigurovat zdroje dat jako systémové DSN.
• Nástroj pro připojení k databázi od poskytovatele databáze, jako jsou komponenty Oracle Data Access Components.
• PI System Explorer lze použít k testování připojení k serveru PI AF. Je součástí klienta PI AF, který je nezbytným předpokladem pro PI AF SimApi.
• OPC UA Expert od Unified Automation – UaExpert je multiplatformní testovací klient pro OPC UA servery.
• Aplikaci PI-SDK (PISDKUtility.exe) lze použít k testování konektivity a k view jakékoli chybové zprávy, které mohly být zaznamenány, když se SIMCA-online pokusila připojit k serveru PI. Toto se používá pouze pro starší OSIsoft SimApi, nikoli PIAF.
• Nástroje pro správu systému PI se používají na počítači serveru PI pro odstraňování problémů z této strany. Napřample, hledat bezpečnostní problémy bránící přístupu ze SIMCA-online serveru. Další informace o odstraňování problémů se systémem PI naleznete v tomto videu YouTube.
• Excel lze použít k získání dat z připojení ODBC a většiny ostatních systémů, pokud je nainstalován vhodný plugin.
• Matrikon OPC Explorer pro Ior HDA (toto jsou samostatné nástroje) lze použít k testování OPC konektivity a Matrikon OPC Analyzer lze použít k diagnostice problémů s OPC konektivitou. Stáhněte si tyto bezplatné nástroje z https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (pro DInd HDA) z OPC Training Institute web site „umožňuje uživatelům snadno diagnostikovat komunikační a bezpečnostní problémy a okamžitě je opravit stisknutím tlačítka. To vše lze provést, aniž byste se museli učit konfigurovat DCOM“

Instalace SimApi

Zde je návod, jak nainstalovat SimApi na PC:

1. Přečtěte si uživatelskou příručku pro SimApi, které instalujete. Obsahuje specifika pro toto SimApi, která doplňují obecné pokyny, které právě čtete.
2. Nainstalujte a nakonfigurujte všechny předpoklady uvedené v uživatelské příručce SimApi (napřampovladače databáze nebo sady SDK)
3. Spusťte instalační program a nainstalujte SimApi. Nainstalujte 64bitovou (x64) nebo 32bitovou (x86) verzi, která odpovídá softwaru, ve kterém ji budete spouštět.
4. Nakonfigurujte SimApi v SIMCA-online nebo SIMCA, jak je popsáno v následujících částech a v uživatelské příručce k SimApi najdete popis dostupných nastavení.
5. Spusťte SIMCA-online server. Všimněte si, že to může chvíli trvat, protože když je SimApi inicializováno, vyjmenuje všechny tags ve zdroji dat.
6. Otestujte SimApi získáním dat. Pro SIMCA-online můžete použít File > Extrahujte podle popisu v 6.1.
7. Pokud SimApi nefunguje podle očekávání, podívejte se do protokolu SimApi files pro odstraňování problémů a do uživatelské příručky SimApi.

Nastavení SimApi pro použití v SIMCA

Zde je návod, jak používat SimApi v SIMCA:

1.  Spusťte import databáze jedním z následujících způsobů:
   • a. Chcete-li vytvořit nový projekt v SIMCA: File > Nový pravidelný projekt nebo nový dávkový projekt. Na kartě Domů vyberte z databáze.
   • b. Import datové sady do existujícího projektu v SIMCA: Z datové sady na kartě Data v otevřeném projektu SIMCA.
2. Klikněte na Přidat nový zdroj dat
3. Vyberte SimApi jako typ připojení, klikněte na tlačítko … a vyhledejte .dll v instalační složce a klepněte na Otevřít.
4. Klikněte na Konfigurovat a podívejte se do uživatelské příručky SimApi, jak provést nastavení.
5. Klepnutím na tlačítko Test připojení zdroje dat ověřte, zda se můžete připojit k databázi. Pokud je jich mnoho, může to trvat dlouho tags ve zdroji dat.
6. Klepnutím na tlačítko OK dokončete konfiguraci.
7. Informace o tom, jak pracovat s importovanými daty, najdete v nápovědě SIMCA.

Nastavení SimApi pro použití v SIMCA-online

• Důležité: Abyste mohli používat SimApi, je vyžadována SIMCA-online serverová licence. Demo instalace SIMCA-online neumožňuje používat SimApis.
• Chcete-li přidat SimApi do systému, spusťte SIMCA-online Server Options na serverovém PC. Přečtěte si podrobné kroky v tématu nápovědy online SICMA Přidání a konfigurace SimApi na serveru.
• Tip: Pokud provedete změny pro SimApi, můžete toto SimApi restartovat nezávisle na Možnosti serveru, aniž byste restartovali celý server.
• Chcete-li nakonfigurovat více instancí tohoto SimApi, opakujte výše uvedené kroky a pro každou instanci použijte jedinečné názvy. Přečtěte si více o různých protokolech a konfiguraci files pro případy v 4.2.

Testování a odstraňování problémů se SimApi

• Tato kapitola je o testování a odstraňování problémů s instalací SimApi.

Testování SimApi od SIMCA-online

• Po úspěšném spuštění serveru SIMCA-online můžete otestovat své SimApi v SIMCA-online (pokud se server nespustí, viz 6.2):
• Přihlaste se k serveru v SIMCA-online klientovi a přejděte na Extract na File tab. Extract vám pomůže otestovat SimApi tím, že přes něj získáte data:
• V levém poli jsou zobrazeny uzly („složky“) SimApi. Tags pro vybraný uzel jsou zobrazeny vpravo nahoře.
• Aktuální data lze rychle otestovat pouhým kliknutím view> zapnuto tags které poskytují nepřetržitá procesní data (viz snímek obrazovky)
• Kliknutím pravým tlačítkem na uzel vyhledáte dávky v časovém rozsahu. Uzel musí být dávkový uzel, který ví o dávkách.
• Vybrat tags v Extrahovat a klikněte na Další a dokončete průvodce pro získání dat pomocí různých režimů získávání dat: aktuální-, historická-, dávková- a diskrétní data.
• Porovnejte extrahovaná data s tím, co vidíte ve svém zdroji dat pomocí jeho nástrojů. Zjistěte více o testování a ověřování všech funkcí SimApi v 7.13.

Odstraňte problémy se SimApi pomocí protokolu SimApi file

• Pokud se server nespustí, SimApi nefunguje podle očekávání nebo selže extrahování, musíte se podívat do protokolu SimApi file který vám řekne, v čem je problém. Chcete-li získat úplné podrobnosti, povolte protokolování na úrovni ladění v protokolu SimApi. Viz 4.2.
• Poznámka: protokoly SIMCA-online serveru zde nejsou tak užitečné. Zobrazují, jak bylo SimApi načteno a inicializováno serverem, ale konkrétní podrobnosti SimApi jsou v jeho protokolu file.

Použijte správný účet SIMCA-online služby

• Když testujete přístup ke zdroji dat, pamatujte, že jste na serveru přihlášeni jako konkrétní uživatel (obvykle váš vlastní uživatelský účet v doméně Windows), ale že účet služby SIMCA-online serveru je jiný účet, ve výchozím nastavení LocalSystem, který má jiná přístupová práva než váš uživatelský účet.
• Z tohoto důvodu není neobvyklé, že testy fungují, když jsou spuštěny jako váš účet, ale SIMCA-online se nedokáže připojit ke zdroji dat.
• K vyřešení tohoto problému musí být udělen přístup pro účet používaný službou SIMCA-online server. Obvykle změníte LocalSystem na konkrétní účet služby domény a udělíte tomuto účtu práva. Všimněte si, že to neplatí, pokud SimApi používá přihlašovací údaje, které jsou nastaveny v konfiguraci SimApi, protože tyto přihlašovací údaje mají přednost.

Technické detaily na SimApis

• Tato kapitola poskytuje technické podrobnosti o tom, jak SimApi funguje. Je zaměřen hlavně na vývojáře, kteří chtějí porozumět SimApis k implementaci SimApi pro zdroj dat.
• Vývojáři by si také měli přečíst dřívější části tohoto dokumentu, kde najdete úvod do SimApis a popis funkcí na vysoké úrovni.

Kdy uvažovat o vývoji SimApi a kdy ne?

Před zvažováním vývoje SimApi pro zdroj dat:

1. Zjistěte, zda již existuje SimApi, které můžete použít. Možná můžete povolit nějakou funkci ve vašem zdroji dat pro použití některého ze stávajících SimApis, jako je OPC UA.
2. Pečlivě si projděte tento dokument a jeho odkazy a prozkoumejte, zda váš zdroj dat splňuje požadavky: napřample, musí být dostatečně rychlý, poskytovat nejen aktuální data, ale i historická data.

• Z těchto důvodů nedoporučujeme vyvíjet SimApi, které se připojuje k hardwaru nebo nástrojům nízké úrovně. Je lepší připojit tyto přístroje k procesnímu historiku, jako je Aveva PI System, a nechat jej získat data z přístroje a historizovat je. Poté lze PIAF SimApi použít k získání dat z PI do produktu Umetrics.

Vývoj SimApi a specifikace SimApi

• Specifikace SimApi, SimApi-v2, obsahuje dokumentaci pro všechny C-funkce v SimApi, které musí SimApi DLL implementovat, stejně jako některé pokyny pro vývoj SimApi.
• Implementace SimApi pomocí C nebo C++ je ve většině případů na zbytečně nízké úrovni.
• Doporučený a jednodušší způsob implementace SimApi je založit jej na ExampZdrojový kód leSimApi, který poskytujeme. Je to example Implementace SimApi, která zpracovává C-rozhraní a převádí je do.NET Framework, kde se provádí skutečná implementace. Má také rámcový kód pro protokolování, nastavení, konfigurační GUI a další rámcový kód.
• K vývoji SimApi potřebuje tým vývojářů zkušenosti s vývojem Windows, .NET Framework, C nebo C++. Vyžaduje se také dobrá znalost zdroje dat, ke kterému se má SimApi připojit, protože účelem SimApi je překládat požadavky na data ze SIMCA-online nebo SIMCA do API zdroje dat. Implementace SimApi není nikdy jednorázový projekt, ale obvykle potřebuje průběžnou podporu a občasnou údržbu.

Čtení nebo zápis dat

• Hlavním úkolem SimApi je poskytovat data ze zdroje dat. To se nazývá čtení dat.
• Většina implementací SimApi také podporuje zápis dat. To znamená zpětný zápis dat přes SimApi do zdroje dat. Zápis dat je volitelná funkce v SIMCA-online.

Tags a Uzly

• A tag je identifikátor sloupce nebo „proměnné“ ve zdroji dat. A tagjméno se používá k identifikaci tag. Názvy v rámci uzlu musí být jedinečné. SIMCA-online 18 je první verzí, která podporuje uzel, který obsahuje poduzel a tag se stejným jménem. Napřample: uzel Parent může mít poduzel nazvaný Batch a a tag s názvem Batch.
• Uzel je kontejner tags. Uzel může také obsahovat další uzly, podobně jako a file systém má složky ve složkách.
• Jako v a file systém, uzel a tag jména lze kombinovat do úplné cesty, která jednoznačně identifikuje a tag. The tag cesty se používají v SIMCA-online nebo SIMCA při výběru tags používat. A tag cesta začíná názvem instance SimApi následovaným strukturou uzlu a končí tag název, každá položka oddělená dvojtečkou (:). Napřample “:ODBCSQLServer:Node:SensorTag1“.

SimApi vyjmenovává tags a uzly při spuštění

• Implementace SimApi prohledává server a hledá uzly a tags ve zdroji dat, když je SimApi inicializováno, a sleduje je, aby různé funkce SimApi, které se používají k výčtu tags a uzel lze implementovat.
• Inicializace SimApi neprobíhá pouze při startu serveru, ale může být znovu spuštěna uživatelem v SIMCA-online pomocí funkce Refresh SimApi.

Citlivost na velká a malá písmena tag- a názvy uzlů

• Tag jména a názvy uzlů rozlišují velká a malá písmena.
• Tedy a tag s názvem "tag1“ není totéž jako „Tag1“ z důvodu odlišného případu „T“. Doporučujeme nepoužívat tags nebo názvy uzlů, které se liší pouze velikostí písmen.

Uzel kontinuálního procesu 

• Když uzel obsahuje tags u spojitých procesních dat jej lze označit jako procesní uzel. Následující dva snímky obrazovky ukazují tabulkovou reprezentaci uzlu procesu s daty, za nimiž následuje obrázek ukazující, jak uzel vypadá při výběru tags v SIMCA-online.

Uzly kontinuálního procesu musí být nezávislé na dávkách, běhech nebo čase

• Aby v SimApi dobře fungoval uzel, musí být nezávislý na dávkách, běhech nebo čase. Mít uzel, který obsahuje data pro konkrétní dávku nebo časový rozsah, by v SIMCA-online nefungovalo dobře, protože konfigurace projektu by pak mohla číst data pouze pro danou dávku a nemohla by být použita pro jiné dávky.
• Místo toho by měl být uzel mapován na jednu nebo více fyzických jednotek v procesu, kde se provádějí měření.

ID šarže tag požadované v uzlech kontinuálního procesu pro provádění dávkového projektu

• Každý kontinuální proces musí mít a tag (proměnná) uchovávající identifikátor dávky pro každé pozorování. Tento identifikátor šarže používá SIMCA nebo SIMCA-online, aby věděl, do které šarže každé pozorování patří.
• $BatchID tag na screenshotech v 7.4.3 je takový example.
  I když to není nutné, doporučuje se mít a tag v uzlu procesu, který ukazuje aktuální fázi nebo krok procesu. Tento tag lze pak použít v podmínkách provádění fáze v SIMCA-online nebo v SIMCA při importu dat. Hodnoty pro toto tag může být napřample „fáze 1“, „čištění“, „fáze 2“.

Dávkový kontextový uzel

• Dávkový uzel je uzel, který sleduje dávky; jejich identifikátory dávek, časy zahájení a časy ukončení. Je to požadavek na dávkové provádění projektu v SIMCA-online. Zdroj dat může mít více než jeden uzel dávky, který zpřístupňuje dávky různými způsoby. Uživatel vybere dávkový uzel, který se vztahuje na jeho aplikaci. Tento example odhaluje dávky, které zahrnují dvě různé jednotky:
• /Factory1 – dávky s agregovanou životností v Unit1 i Unit2.
• /Factory1/Unit1 – dávky s životností pouze v Unit1
• /Factory1/Unit2 – dávky s životností pouze v Unit2
• Pokud ve zdroji dat nemáte dávkový uzel, můžete použít dávkový kontextový generátor v SIMCA-online. Viz vestavěná nápověda.
• Nepovinná data šarže
• Dávkový uzel může také obsahovat dávková data; údaje, pro které existuje pouze jedno pozorování pro celou dávku. Všimněte si toho tags s dávkovými daty nemusí být v uzlu, který má plnou funkčnost dávkového uzlu. Stačí, že SimApi podporuje čtení dávkových dat pro tags. Další informace o datech dávek v 7.6.
• Tady je example dávkového uzlu:
• Poznámka: Výše ​​uvedený snímek obrazovky je převzat z DBMaker, který je součástí SIMCA-online. Chcete-li to sami vidět v DBMakeru, klikněte na View Tlačítko Data v databázi Bakers Yeast pro zobrazení dvou oken, z nichž jedno je uzel šarže a druhé data procesu.

Datové typy: číselná data, textová data a chybějící data

• Pro každého tagSimApi může podporovat tři typy dat: numerická, textová, ta chybějící:
• Číselná data jsou typicky reálné hodnoty parametrů procesu, napřample 6.5123. SimApi dokáže zpracovat pouze 32bitové hodnoty s jednoduchou přesností s plovoucí desetinnou čárkou. Formát s plovoucí desetinnou čárkou s jednou přesností – Wikipedie. Všechny ostatní numerické datové typy ve zdroji dat by měly být převedeny na float. Jako takové mohou pracovat s velkými i malými hodnotami, ale pouze s asi 6 nebo 7 platnými číslicemi. Více se dozvíte v Technické příručce.
• To může vést ke ztrátě přesnosti pro velká celá čísla nebo pro reálná čísla, která jsou velká a mají desetinná místa. Další informace naleznete v Technické příručce.
• Textová/řetězcová data se používají pro ID dávek, podmínky provádění fáze nebo pro kvalitativní proměnné. Hodnoty pro text tag data rozlišují velká a malá písmena. To znamená, že hodnota „běh“ není stejná jako
  "BĚH". Proměnné datum a čas nejsou podporovány přímo SimApi, ale mohou být vráceny jako řetězec ve formátu YY-MM-DD HH:MM (např.ample “2020-09-07 13:45”).
• Chybějící hodnoty znamenají, že neexistuje žádná hodnota k vrácení, tj. žádná data.
• Jaký typ se vrátí, záleží na implementaci SimApi. SimApi ví o datech ve zdroji dat a měl by vrátit datový typ, který nejlépe vyhovuje.

Tři režimy získávání dat: Continuous, Batc,h a Discrete

• Specifikace SimApi definuje tři režimy získávání dat, tj. tři různé způsoby, jak může SimApi poskytovat data tags ve zdroji dat (nebo v opačném směru: zapisovat data do tags ve zdroji dat).
• Nepřetržité načítání dat – to se vztahuje k nepřetržitému čtení dat a sekvenčnímu sledování na pozorování, jak se dávka nebo proces vyvíjí. Data se odečítají pro aktuální čas nebo pro určitý rozsah v pravidelných intervalech mezi pozorováními. Napřample, všechna data mezi 09:00:00 a 10:00:00 sampvedeno každých 60 sekund, což má za následek 61 pozorování, včetně koncových bodů.
• Dávkové získávání dat – jedná se o jedno pozorování s daty pro celou dávku (není spojeno s konkrétní splatností nebo časovým bodem). Atributy dávek a data lokálního centrování se v SIMCA-online čtou jako data dávek. Dávkové podmínky se normálně čtou také jako dávková data (pokud nejsou nakonfigurovány pro diskrétní načítání dat).
• Získávání diskrétních dat – diskrétní data se mohou skládat z několika pozorování pro mnoho splatností. Na rozdíl od spojitých dat se však diskrétní data nečtou postupně, ale všechna data najednou pro určitou fázi dávky. Data nemusí být rozložena s pravidelnými intervaly proměnné splatnosti. Všechna data jsou znovu načtena pokaždé, když jsou data požadována, v nakonfigurovaném intervalu.
• Pro jakoukoli danou tag data lze vyžádat v kterémkoli ze tří režimů, ale typicky SimApi bude pro jednotlivce podporovat pouze jeden z těchto režimů. tag. Stejně tak se nechá promíchat tags v rámci uzlu, ale obvykle všechny tags v rámci konkrétního uzlu podporují stejný režim načítání dat.
• Pro spojitá data (nikoli však pro dávková nebo diskrétní data2) lze zadávat požadavky na aktuální data nebo historická data, což je téma následující části.
• Ne všechny SimApis podporují všechny režimy. Viz matici funkcí výše a SimApi web stránku pro podrobnosti.

Aktuální a historická nepřetržitá data prostřednictvím SimApi

• Nepřetržitá data se týkají procesních dat, která se v čase mění.

Aktuální data

• Čtení aktuálních dat znamená dotazování zdroje dat na nejnovější hodnoty tags v době dotazování. Všimněte si, že zde není použit čas externího zdroje dat.
• Data načtená jako aktuální data SIMCA-online zobrazí jako živá data. Z tohoto důvodu je důležité, aby ve zdroji dat nedocházelo ke zbytečným prodlevám. Aktuální data by měla být co nejaktuálnější, aby dobře fungovala v SIMCA-online.
• Zdroj dat může využít své znalosti dat a doby platnosti hodnot a rozhodnout se vrátit chybějící data, když jsou nezpracovaná data pro určitý časový bod příliš stará. Napřample: data jsou požadována v 15:00:00, ale nejnovější datový bod ve zdroji dat je z 03:00:00. V tomto případě jsou data stará 12 hodin, takže se SimApi může rozhodnout vrátit chybějící hodnotu (žádná data).

Historická data

• Čtení historických dat znamená dotazování zdroje dat na hodnoty jedné nebo více tags pro určité časové rozmezí s určitým intervalem mezi pozorováními. Všimněte si, že zde je k nalezení dat použit místní čas zdroje dat. Proto je důležitá časová synchronizace mezi zdrojem dat a servery.
• Historická data se skládají z matice dat. Je na implementaci SimApi, aby si vyžádala data ze zdroje dat a sampponechte jej v zadaném intervalu a vytvořte matici dat, která vrátí:
• Někdy má samotný zdroj dat agregační funkce pro vrácení zpracovaných dat nebo sampling funkcí, které lze použít k vrácení správných dat.
• U ostatních zdrojů dat musí SimApi požadovat všechna data v časovém rozsahu a poté sample správná pozorování k sestavení matice.
• Data musí být vrácena pro časové období, i když v časovém rozsahu nemusí být nezpracovaná data, ale pouze těsně před časem zahájení. Napřample: data existují ve zdroji dat v časových bodech 10 a 20. SimApi požaduje data pro čas 15 a 17. V tomto případě by hodnoty pro časový bod 10 měly být vráceny SimApi, ale timestamped jako čas 15 a 17, protože to byly v té době nejnovější datové body. Hodnoty pro tags v čase 10 se označují jako mezní hodnoty pro požadovaný rozsah. Pro hlubší vysvětlení hodnot mezí viz napřampdokumentaci pro returnBounds v UA Část 11: Historický přístup – 6.4.3 Struktura ReadRawModifiedDetails
  (opcfoundation.org)
• Interpolace by se nikdy neměla používat k výpočtu hodnot pro budoucí časové body, protože data nebudou odpovídat tomu, co se čte v reálném čase jako aktuální data. Pro example z předchozí odrážky: pokud by data pro 15 a 17 měla být interpolována pomocí hodnot pro položky 10 a 20, efektivně by používaly hodnoty z budoucnosti, což není povoleno.
• Zdroj dat může využít své znalosti dat a toho, jak dlouho jsou hodnoty platné, a rozhodnout se vrátit chybějící data, když jsou nezpracovaná data pro určitý časový bod stará. Napřample: data jsou požadována pro 15:00:00, ale nejnovější datový bod ve zdroji dat je z 03:00:00. V tomto případě jsou data stará 12 hodin, takže se SimApi může rozhodnout vrátit chybějící hodnotu (žádná data).

Poznámka: SIMCA-online obvykle během běžné realizace projektu nepožaduje více než sto pozorování v jedné výzvě. Při extrakci v SIMCA-online nebo při spuštění desktopové SIMCA lze provádět větší požadavky na data. Ty mohou trvat dlouho, což se dá očekávat.

Aktuální data a historická data se musí shodovat

• Někdy mohou existovat rozdíly, když jsou data čtena jako aktuální data v reálném čase nebo historická data. To způsobuje problémy v SIMCA-online, protože server podle potřeby automaticky přepíná mezi aktuálními a historickými daty.

Sběr dat s nízkou latencí

• Když SIMCA-online používá zdroj dat v reálném čase, je důležité, aby data ve zdroji dat byla aktuální. Při získávání dat ve zdroji dat by nemělo docházet ke zbytečným prodlevám. Průběžná procesní data pro všechny proměnné musí být k dispozici ve stejnou dobu pro každé pozorování. Data, která u některých proměnných přijdou pozdě, SIMCA-online nevyzvedne.

Data lze číst kdykoli 

• Když SIMCA-online požádá o hodnotu a tag pro čas t obdrží hodnotu ze zdroje dat od času t, nebo poslední pozorování ve zdroji dat před časem t, nebo interpolovanou hodnotu pro čas t. Server tedy vždy získá hodnotu pokaždé, když o ni požádá, i když pozorování pro tento přesný časový bod nemusí ve zdroji dat existovat.
• Časamps v SimApi jsou vždy UTC. SIMCA-online klienti a SIMCA prezentují čas jako místní čas.

Navlékání závitů 

• SimApi je ve výchozím nastavení voláno jedním vláknem uživatelem SimApi. To platí pro všechny verze SIMCA a SIMCA-online až do verze 17.
• SIMCA-online 18 podporuje příznak funkce pro zapnutí vícevláknového přístupu přes SimApi. Přečtěte si více v tématu nápovědy Souběžný přístup k SimApi.
• To znamená, že SimApis by se měl připravit na multi-threading, pokud je to možné, zajištěním implementačního vlákna SimApi a zdokumentovat toto a jakékoli úvahy pro uživatele SimApi.

Log file

• SimApi by mělo zaznamenávat akce, chybové zprávy a varování do svého protokolu file pomoci při odstraňování problémů. Použijte různé úrovně protokolování k označení důležitosti protokolování.
• Pro funkce, které nebyly implementovány v SimApi, se doporučuje zaznamenat „Neimplementováno“.

Zpracování chyb

• Když SimApi nemůže splnit požadavek ze zdroje dat, může tento problém vyřešit jedním ze dvou způsobů; vrácením chybějících hodnot (žádná data) nebo signalizací chyby SimApi:
• Vrácení chybějících hodnot volajícímu a signalizace úspěchu umožňuje volajícímu pokračovat jako obvykle (ale samozřejmě bez jakýchkoli dat). Toto je doporučený postup pro dílčí chyby, například když lze získat data pro některé, ale ne pro všechny, tags v žádosti.
• Signalizace chyby SimApi umožňuje volajícímu (napřampna SIMCA-online server), abyste to okamžitě viděli a mohli jednat. Toto je doporučený postup pro požadavky, které zcela selžou a nemohou vrátit vůbec žádná data.
• SIMCA-online zpracovává chybějící hodnoty nebo chybové kódy odlišně, jak je popsáno v technické příručce SIMCA-online.

Požadavky na výkon SimApi

• K získávání dat se používají funkce v SimApi.
• Pokud je přístup k datům pomalý, SimApi nebude fungovat dobře, což napřample ukazuje: Pokud SIMCA-online požaduje data každou sekundu, ale jejich získání trvá dvě sekundy, SIMCA-online server nikdy nebude schopen držet krok v reálném čase, ale postupně bude stále více zaostávat.
• V podsekcích si ukážeme, jak SIMCA a SIMCA-online využívají funkce SimApi pro přístup k datům a jak často budou funkce SimApi volány. To může pomoci při nastavení požadavků na výkon pro implementaci SimApi.

Využití funkcí SimApi SIMCA

• Když desktopová SIMCA nebo jiné offline produkty používají SimApi k získávání dat, budou se tyto požadavky týkat dávek a procesních dat pro sadu proměnných v určitém časovém rozsahu.
• Vzhledem k tomu, že tyto požadavky jsou iniciovány ručně uživatelem, nestávají se příliš často a nezpůsobují významné zatížení zdroje dat.
• K získání dat se používají tyto funkce SimApi:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-online použití funkcí SimApi

• SIMCA-online se používá pro monitorování procesu v reálném čase, a proto v pravidelných intervalech vyžaduje data prostřednictvím SimApi. Nejkratší interval provádění, který lze použít, je 1 sekunda. Nějaký exampintervaly provádění jsou 10 s, 1 minuta nebo 10 minut.
• Na serveru může běžet více projektů současně.
• Aby se snížil počet volání API prostřednictvím SimApi, server optimalizuje požadavky na data seskupením mnoha souběžných menších požadavků do jednoho většího požadavku pro všechny proměnné současně (další informace naleznete v tématu nápovědy „Optimalizované čtení ze zdrojů dat zlepšuje výkon“).
• Prováděcí algoritmus serveru funguje takto, když požaduje data pomocí funkcí SimApi uvedených níže:
• Všechny fáze, které se provádějí ve stejném intervalu, jsou seskupeny do jediného volání SimApi, aby se snížil počet volání. Server čte nejnovější data pro všechny proměnné používané všemi modely, které sdílejí interval, tj. toto volání povede k široké datové řadě, kterou pak používají všechny projekty.
  • simapi2_connectionReadCurrentData
• Pro každý dávkový projekt server také potřebuje vědět, které dávky jsou aktivní. To se také musí stát pokaždé, když se projekt spustí:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes se volá méně často.
• SIMCA-online navíc vyžaduje také historická data. Tyto požadavky se stávají pouze v případě potřeby, jako je dohnat začátek dávky, která začala před spuštěním SIMCA-online, nebo když server zaostává a potřebuje přečíst blok dat:
  • simapi2_connectionReadHistoricalDataEx
• Volitelně některé konfigurace projektu používají funkce, které používají dávková data nebo diskrétní data, která vedou k volání SimApi:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Volitelně některé konfigurace projektu používají zpětný zápis k odeslání dat zpět do zdroje dat:
  • simapi2_connectionWriteHistoricalDataEx (a odpovídající funkce pro dávková data, diskrétní data)
• Je důležité, aby každé volání základních funkcí pro získávání dat, readCurrentData, getActiveBatches/getBatchTimes, bylo rychlé a nebylo to výpočetně náročné pro samotný zdroj dat, vzhledem k tomu, jak často může SIMCA-online tyto funkce volat.

Testování a ověřování dat SimApi

• Tato část je o testování SimApi, aby se ověřilo, že data vrácená z něj odpovídají datům v samotném zdroji dat. Spouštění testů, jako je tento, je důležité po vytvoření nebo změně implementace SimApi nebo když se změní rozhraní API zdroje dat.
• V praxi se validace dat provádí pomocí SIMCA-online a její funkce Extract k vytažení dat ze zdroje dat přes SimApi a následnému porovnání s nezpracovanými daty ve zdroji dat. Desktop SIMCA nelze použít k testování aspektů SimApi v reálném čase.

Přípravy a požadavky

• Některé položky jsou volitelné, ale lze je provést, pokud to rozsah vašeho testování zahrnuje:

1. Nainstalujte SIMCA-online, jak je popsáno v ReadMe and Installation Guide.pdf, který je součástí zipu produktu.
2. Získejte licenci pro SIMCA-online server a nainstalujte jej. SimApi nebude fungovat bez licence. Článek znalostní báze pro SIMCA-online ukazuje, jak licencovat produkt. Napřample: SIMCA-online 18 (sartorius.com)
3. Nainstalujte a nakonfigurujte SimApi, které chcete otestovat. Viz kapitoly 4 – 5 tohoto dokumentu a uživatelská příručka konkrétního SimApi.
   • a. Volitelné: Ujistěte se, že uživatelská příručka je aktuální a správná.
4. Ujistěte se, že máte pro svůj zdroj dat nástroj, který můžete použít k porovnání dat SimApi.
5. V desktopovém klientovi SIMCA-online se přihlaste ke svému serveru SIMCA-online a používejte File > Extrahujte, abyste získali data přes SimApi.
6. Volitelné, pokud to váš rozsah testování zahrnuje: po dokončení testování odinstalujte SimApi a ověřte jej files jsou odstraněny.

Co testovat

• Matice funkcí v kapitole 3 uvádí všechny možné funkce, ale daná implementace SimApi může podporovat pouze podmnožinu. Měli byste otestovat všechny funkce, které jsou implementovány daným SimApi.
• Následující testy jsou společné pro většinu implementací SimApi:
• Autentizace pomocí uživatelských jmen a hesel
• Vyzkoušejte různá nastavení v konfiguraci SimApi
• Hierarchie uzlů: Uzly a tags vystavené SimApi jsou správné.
  • Musí tam být a tag vystaveny pro všechny „proměnné“, které by měly být dostupné prostřednictvím SimApi. Přamples: procesní měření, vypočtené hodnoty, konstanty.
• Odolnost připojení: pokud je zdroj dat nedostupný, způsobí to varování nebo chyby v protokolu file, ale připojení ke zdroji dat se automaticky obnoví, jakmile bude zdroj dat dostupný.
• Více instancí: že dvě instance lze konfigurovat a používat nezávisle a současně, se samostatnými protokoly files.
• Aktuální data: extrahovat aktuální data pro tags. Ujistěte se, že data jsou posledními známými hodnotami ze zdroje dat nebo že chybí kvůli špatné kvalitě nebo když jsou data příliš stará.
  • Extrahujte data každých 10 sekund (nebo tak nějak) po dobu jedné minuty.
• Historická průběžná data: extrahujte historická data pro tags.
  • Použijte časový rozsah, který odpovídá době, kdy jste extrahovali aktuální data. Ověřte, že aktuální data odpovídají historickým datům a nezpracovaným datům ve zdroji dat.
  • Vyzkoušejte různé časové rozsahy a sampling intervalech, ověřte, že data odpovídají datovému zdroji.
  • Zkuste extrahovat data každou 1 s, což je nejkratší možná sampling interval.
  • Vyzkoušejte různé druhy tags ve zdroji dat (proměnné procesu atd.) a ujistěte se, že se data shodují.
  • Poznámka: SIMCA-online může rozdělit jeden velký požadavek na historická data na několik menších částí. To bude viditelné v protokolu SimApi.
• Ověřte, že SimApi pracuje s textovými daty, číselnými daty a chybějícími daty.
• protokol SimApi file. Ověřte, zda protokol obsahuje přiměřené položky.
• Dávkový uzel: klikněte pravým tlačítkem na uzel a proveďte Najít dávky.
  • Ověřte názvy dávek, časy začátku a konce dávek.
  • Zkuste aktivní dávku, která běží ve zdroji dat. Přes SimApi by neměl mít čas ukončení.
• Identifikátor dávky procesního uzlu tag. Pokud má SimApi funkci dávkového uzlu (viz předchozí odrážka), musí mít také identifikátor dávky tag v uzlu odpovídajících procesních dat. Data k tomu tag by měl být identifikátor šarže (název šarže). Tato data jsou vyžadována pro dávkové projekty, aby bylo možné identifikovat, ke které dávce patří řádek dat.

V závislosti na tom, zda to SimApi podporuje, můžete také chtít otestovat:

• Dávková data pomocí File > Extrahovat.
• Použití diskrétních dat File > Extrahovat. Poznámka: pro testování diskrétních dat pomocí File > Extrahujte uzel, dávkový uzel a diskrétní datový uzel musí být ve stejném SimApi (když SIMCA-online provádí projekty, mohou být z různých SimApis).
• Zpětný zápis – odeslání dávky dat do zdroje dat. Chcete-li to otestovat, musíte nakonfigurovat konfiguraci projektu v SIMCA-online pro zpětný zápis datových vektorů do zdroje dat. Poté spusťte projekt v SIMCA-online a zkontrolujte data, která jsou zapsána zpět ve zdroji dat.
• Průběžná data se konfigurují na stránce Evolution Write Back v konfiguraci projektu.
• Diskrétní data jsou konfigurována na stejné stránce, ale pouze pro fázi nakonfigurovanou pro diskrétní načítání dat.
• Dávková data ze zpětného zápisu dávky

VÍCE INFORMACÍ

• 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:
• Tento návod, včetně všech součástí, je chráněn 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.

FAQ

• Otázka: Jaký je účel SimApis?
  • Odpověď: Hlavním účelem SimApis je poskytovat data produktům Umetrics Suite pro vytváření projektů a vytváření modelů.
• Otázka: Jak mohu vyřešit problémy s instalací SimApi?
  • Odpověď: Problém můžete odstranit testováním ze SIMCA-online kontrolou protokolu SimApi filea zajištění správné konfigurace účtu služby.

Dokumenty / zdroje

Software SARTORIUS Sim Api [pdfUživatelská příručka Sim Api Software, Api Software, Software

Reference

• Uživatelská příručka