Oprogramowanie SARTORIUS Sim Api

Specyfikacje

• Nazwa produktu: SimApi Guide
• Data wydania: 5 września 2024 r.
• Cel: Dostarczanie danych do produktów Umetrics Suite

Instrukcje użytkowania produktu

Wprowadzenie do SimApis

• SimApis służą do pobierania danych na potrzeby tworzenia projektów i budowania modeli w produktach Umetrics Suite.

Uzyskiwanie SimApis

• Aby uzyskać SimApis, zapoznaj się z oficjalną dokumentacją lub skontaktuj się z działem obsługi klienta, aby uzyskać pomoc.

Funkcje SimApi

• SimApis dostarczają danych w czasie rzeczywistym do monitorowania, sterowania i tworzenia modeli w systemach SIMCA i SIMCA-online.

Tylko bieżące wykorzystanie danych

• Aby uzyskać optymalną wydajność, zaleca się korzystanie wyłącznie z bieżących danych i unikanie danych historycznych.

Przygotowanie do instalacji SimApi

• Przed instalacją upewnij się, że Twój system spełnia minimalne wymagania określone w instrukcji użytkownika.

Instalowanie SimApi

• Aby zainstalować SimApi w swoim systemie, postępuj zgodnie z instrukcjami krok po kroku zawartymi w podręczniku użytkownika.

Konfigurowanie SimApi dla SIMCA

• Skonfiguruj ustawienia SimApi w SIMCA zgodnie z podanymi wytycznymi.

Konfigurowanie SimApi dla SIMCA-online

• Skonfiguruj SimApi do pobierania danych w czasie rzeczywistym i operacji zapisu wstecznego w SIMCA-online.

Testowanie i rozwiązywanie problemów

• Po instalacji wykonaj testy, aby upewnić się, że funkcjonalność jest prawidłowa. W przypadku problemów zapoznaj się z sekcją rozwiązywania problemów w podręczniku użytkownika.

Testowanie z SIMCA-online

• Przetestuj integrację SimApi z SIMCA-online, aby zweryfikować pobieranie danych.

Rozwiązywanie problemów z dziennikiem Files

• Użyj dziennika SimApi file aby zidentyfikować i rozwiązać wszelkie problemy związane z instalacją lub działaniem.

Konfiguracja konta usługi

• Upewnij się, że konto usługi SIMCA-online jest prawidłowo skonfigurowane, aby zapewnić bezproblemową pracę.

Szczegóły techniczne

• Aby uzyskać szczegółowe informacje techniczne na temat SimApis, zapoznaj się z sekcją 7 podręcznika użytkownika.

Wprowadzenie do SimApis

• SimApi to interfejs programowy pomiędzy oprogramowaniem Umetrics® Suite a źródłem danych. Podstawowym celem SimApi jest dostarczanie danych do SIMCA®-online lub SIMCA®.
• Sartorius Stedim Data Analytics AB opracowuje SimApis dla wielu różnych źródeł danych, takich jak bazy danych historycznych procesów i bazy danych ogólnego przeznaczenia.
• Ten dokument pokazuje, czym jest SimApi i jak jest używany w produktach Umetrics Suite. Dowiesz się, jak zaplanować i zainstalować SimApi, jak rozwiązywać problemy i jak testować instalację. Ostatni rozdział zawiera szczegóły techniczne SimApi przeznaczone dla deweloperów.

Cel SimApi: dostarczanie danych do produktów Umetrics Suite

• Podstawowym celem SimApi jest dostarczanie danych do SIMCA-online lub SIMCA ze źródła danych. Źródło danych nie jest częścią SIMCA-online, ale może być historykiem procesów lub innym systemem, który przechowuje i zarządza danymi.
• SimApi udostępnia hierarchię węzłów odpowiadającą folderom w file system. Każdy węzeł może zawierać inne węzły lub tags. A tag odpowiada zmiennej. Dla tych tags, dane mogą być uzyskane. Na zdjęciu widać tag, Temp, wybrane w węźle
• BakersYeastControlGood w źródle danych w SIMCA-online. Pokazuje również najnowsze wartości pobrane ze źródła danych.

Wykorzystanie SimApi w pakiecie Umetrics Suite

• Oprogramowanie komputerowe SIMCA może używać interfejsu SimApi do pobierania danych w celu tworzenia projektów i budowania modeli, jak pokazano na poniższym rysunku.
• SIMCA-online używa SimApis do uzyskiwania danych w czasie rzeczywistym do monitorowania i kontroli, a także do zapisywania danych z powrotem do źródła danych. Poniższy rysunek pokazuje, gdzie znajduje się SimApi w systemie składającym się ze źródła danych, serwera SIMCA-online i klientów.

Często używane SimApis

• Do najpopularniejszych SimApisów należą:
• PI AF SimApi do łączenia się z systemami PI firmy Aveva (dawniej OSIsoft).
• OPC UA SimApi
• ODBC SimApi – do ogólnego dostępu do baz danych, takich jak SQL Server lub Oracle
• Wszystkie dostępne SimApi są wymienione wraz z ich funkcjami w paragrafie 3.

DBMaker SimApi dla danych symulacyjnych

• DBMaker to aplikacja dostarczana z instalacją serwera SIMCA-online. Symuluje źródło danych, takie jak historyk procesów, za pomocą wstępnie załadowanej tabeli danych, w której obserwacje są dostarczane jedna po drugiej do SIMCA-online za pośrednictwem DBMaker SimApi.
• DBMaker jest używany wyłącznie w celach demonstracyjnych i nie może być używany w produkcji z danymi na żywo ze źródła danych. Zobacz wbudowaną pomoc, aby dowiedzieć się więcej o DBMaker.

Dodatkowa dokumentacja

• Niniejszy dokument jest jednym z zestawu powiązanych ze sobą dokumentów, z których każdy ma inny cel i jest skierowany do innego odbiorcy:

Źródło	Co	Gdzie
SIMCA-online web strona	Informacje wprowadzające i pliki do pobrania	sartorius.com/umetrics-simca- w sieci

SIMCA-online ReadMe i Instalacja.pdf	Instalacja i rozpoczęcie korzystania z danych demonstracyjnych online SIMCA	W pliku instalacyjnym zip file
Przewodnik wdrażania SIMCA-online	Omówienie funkcjonalności SIMCA-online, porównanie jej z innym oprogramowaniem Umetrics Suite, omówienie wymagań i najlepszych praktyk dla pomyślnego wdrożenia oraz instrukcje instalacji krok po kroku.	sartorius.com/umetrics-simca- w sieci
Przewodnik SimApi	Przygotowanie i przeprowadzanie instalacji SimApi, w tym rozwiązywanie problemów. Zawiera również szczegóły techniczne na temat SimApi dla deweloperów.	sartorius.com/umetrics-simapi
Podręczniki użytkownika SimApi	Dokumentacja każdego opublikowanego SimApi zawierająca opis funkcji, instrukcje instalacji i szczegóły konfiguracji.	sartorius.com/umetrics-simapi
SIMCA-online Przewodnik techniczny	Informacje techniczne dotyczące planowania instalacji serwera SIMCA-online, rozwiązywania problemów i szczegółowego opisu działania SIMCA-online.	sartorius.com/umetrics-simca-w sieci
Pomoc SIMCA-online	Web-pomoc dotycząca korzystania z serwisu SIMCA-online i sposobu jego działania.	W samym oprogramowaniu i na sartorius.com/umetrics-simca
SIMCA-online Web Instrukcja instalacji klienta	Opisuje instalację SIMCA-online Web Klient.	sartorius.com/umetrics-simca-w sieci
Baza wiedzy Umetrics	Przeszukiwalna baza danych zawierająca artykuły o każdej wydanej wersji oprogramowania, artykuły techniczne i znane problemy w produktach Umetrics Suite.	sartorius.com/umetrics-kb
Pomoc/instrukcja użytkownika SIMCA	Jak używać stacjonarnego oprogramowania SIMCA do tworzenia projektów i modelowania danych.	W SIMCA i na sartorius.com/umetrics-simca
Wsparcie web strona	Jak uzyskać pomoc techniczną.	sartorius.com/umetrics-support

Wsparcie techniczne

• Zespół wsparcia online Sartorius odpowiada na pytania techniczne dotyczące SimApis i może również przekazywać prośby o udoskonalenie SimApis odpowiednim osobom. Dowiedz się więcej na stronie sartorius.com/umetrics-support.

Uzyskiwanie SimApis

• Udostępniamy dokumentację dostępnych SimApis i łącza do programów instalacyjnych na stronie sartorius.com/umetrics-simapi.
• Każdy SimApi jest opisany w Podręczniku użytkownika.
• Przewodnik SimApi, który właśnie czytasz, uzupełnia te informacje o informacje uzupełniające SimApi w zakresie planowania, instalacji i rozwiązywania problemów z SimApi.

Funkcje SimApi

• Nie wszystkie źródła danych są takie same. SimApi nie musi implementować wszystkich funkcji w specyfikacji. Z tych powodów różne SimApi oferują różne funkcjonalności. Poniższa macierz zawiera listę dostępnych SimApi i ich funkcji.
• Funkcje są wyjaśnione poniżej. Zwróć uwagę, że tabela ma oddzielne kolumny, aby pokazać, które funkcje są dostępne odpowiednio w SIMCA-online i SIMCA.

Funkcja	Zamiar	Korzystanie z SIMCA-online	Wykorzystanie SIMCA
Aktualne dane	Odczytaj pojedynczą obserwację z najnowszą wartością ze źródła danych.	Wykonywanie normalne w czasie rzeczywistym	–
Dane historyczne	Odczytuj wiele obserwacji na raz, korzystając z danych historycznych ze źródła danych.	Nadrabianie i przewidywanie danych z przeszłości, tworzenie projektów przy użyciu File > Nowy	Kreator importu bazy danych umożliwiający import danych procesowych w celu utworzenia modelu.
Dane dyskretne	Odczyt danych laboratoryjnych/IPC ze źródła danych. Wiele obserwacji na partię.	Dla projektów wsadowych z fazami lub warunkami wsadowymi skonfigurowanymi do pobierania danych dyskretnych.	–
Dane wsadowe	Odczytaj warunki partii i końcowe atrybuty jakości (lub	Warunki wsadowe lub centrowanie lokalne.	Kreator importu bazy danych umożliwiający odczyt warunków wsadowych

Funkcja	Zamiar	Korzystanie z SIMCA-online	Wykorzystanie SIMCA
	inne dane typu MES). Jedna obserwacja na partię.		tworzenie modeli na poziomie wsadowym.
Węzeł wsadowy	Określ godzinę rozpoczęcia i godzinę zakończenia (puste w przypadku aktywnej partii) dla konkretnej partii. Wymień wszystkie partie, które istniały w określonym przedziale czasowym.	Wymagane do wykonania konfiguracji wsadowych.	Kreator importu bazy danych umożliwiający wybranie partii do zaimportowania.
Zapis zwrotny – dane ciągłe	Zapisuj ciągłe dane, takie jak prognozy, z powrotem do źródła danych.	Zapisuj dane z poziomu ewolucji wsadowej dla Control Advisor lub dla konfiguracji ciągłych	–
Odpisz – dyskretnie	Zapisuj dyskretne dane, takie jak prognozy, z powrotem do źródła danych.	Zapis zwrotny dla konfiguracji wsadowych na poziomie ewolucji wsadowej dla faz skonfigurowanych do pobierania danych dyskretnych	–
Zapis zwrotny – dane wsadowe	Zapisuj dane wsadowe, takie jak prognozy lub ostateczne atrybuty jakości, w źródle danych.	Zapis zwrotny konfiguracji wsadowej na poziomie wsadowym	–
Hierarchia węzłów	SimApi obsługuje hierarchię węzłów, podobnie jak file system. Każdy węzeł może zawierać tags i inne węzły. Hierarchia ułatwia zarządzanie dużą liczbą węzłów i tags.	Obsługiwane wszędzie tam, gdzie tags są używane.
Szyk tag ekspansja	Tablica tag przechowuje wiele wartości. SimApi rozszerza tablicę tag do wielu osób tags, po jednym dla każdego elementu tablicy.	Obsługiwane gdzie tags są używane do danych ciągłych. Każde rozszerzone tag musi zostać zamapowana na zmienną w projekcie SIMCA.
Wiele źródeł danych	SimApi może łączyć się z więcej niż jednym źródłem danych lub obsługiwać wiele wystąpień samego siebie z indywidualnymi ustawieniami i dziennikiem files dla każdego wystąpienia.	Połącz się z kilkoma różnymi źródłami danych tego samego typu.	–
Odporność połączenia	Jeśli SimApi zostanie rozłączony ze źródłem danych, automatycznie spróbuje nawiązać połączenie ponownie.	Nie ma potrzeby ponownego uruchamiania SimApi w celu ponownego nawiązania połączeń ze źródłem danych.	–
Opracowano wewnętrznie	SimApi jest rozwijany, dostarczany i obsługiwany przez

Nie zaleca się stosowania wyłącznie bieżących danych bez danych historycznych

• Niektóre SimApi, zwłaszcza OPC DA, obsługują wyłącznie odczyt bieżących danych, a nie danych historycznych.
• SimApi obsługujący wyłącznie bieżące dane nie może być używany w stacjonarnym systemie SIMCA, ponieważ nie będzie w stanie odczytać danych historycznych, na podstawie których można budować modele.
• W przypadku SIMCA-online zdecydowanie zalecamy źródło danych i SimApi, które dostarczają nie tylko bieżące dane do wykonania w czasie rzeczywistym, ale także dane historyczne, aby móc przewidywać i nadrabiać dane z przeszłości. SIMCA-online automatycznie przełącza się między danymi w czasie rzeczywistym a danymi historycznymi w razie potrzeby i nie można tego wyłączyć.
• Źródło danych, które udostępnia wyłącznie dane bieżące, ale nie dane historyczne, może działać w przypadku projektów ciągłych w ramach SIMCA-online, natomiast w przypadku projektów wsadowych wymagane są dane historyczne.

Przygotowanie do instalacji SimApi

• W tej sekcji opisano ważne informacje dotyczące pomyślnej instalacji SimApi.

SimApis 64-bitowy lub 32-bitowy

• Istnieją wersje 32-bitowe i 64-bitowe każdego SimApi.
• SIMCA-online i SIMCA są 64-bitowe i wymagają 64-bitowych wariantów SimApis. Starsze 32-bitowe SimApis są nadal dostępne dla starszych instalacji.

Lokalizacja dla dziennika file i ustawień

• SimApi przechowuje swój dziennik files w ukrytym folderze Program Data1:
  %programdata%\Umetrics\SimApi, gdzie %programdata% mapuje się na rzeczywisty folder na komputerze. Domyślnie jest to C:\ProgramData.
• Każdy SimApi zazwyczaj używa własnego dziennika file, który podobnie jak serwer SIMCA-online loguje się file będzie zawierać więcej lub mniej danych w zależności od ustawienia poziomu logowania. To file jest przydatny do rozwiązywania problemów. Dziennik file jest nazwany
  .log gdzie to jest SimApi, który instalujesz, np.ample PIAFSimApi. Zobacz także następną sekcję dotyczącą nazw instancji SIMCA-online SimApi.
• Ten folder zawiera również ustawienia SimApi w formacie XML file nazwany Plik .xml.
• Większość SimApi ma graficzne interfejsy użytkownika, które zmieniają ustawienia w pliku xml file, ale w niektórych przypadkach zmiany wprowadzasz bezpośrednio do pliku XML file za pomocą edytora tekstu, takiego jak Notatnik. Zobacz instrukcję użytkownika dla każdego SimApi.

File nazwy, gdy nazwane wystąpienia są używane z SIMCA-online

• W SIMCA-online każda instancja SimApi otrzymuje własną konfigurację file i loguj file do pracy z wieloma wystąpieniami każdego SimApi. Nazwy tych fileDo nazw instancji dołączona jest sufiks w postaci nazwy podanej na karcie SimApi w oknie dialogowym Opcje serwera SIMCA-online.
• Następujący example pokazuje nazewnictwo tych files, gdzie należy zastąpić nazwą SimApi.
• Nazwa konfiguracji podana podczas dodawania instancji: OmegaServer
• Konfiguracja file nazwa: OmegaServer.xml
• Dziennik file nazwa: OmegaServer.log
• Należy pamiętać, że ogólne file .dziennik file jest nadal tworzony. Ten dziennik file zawiera wpisy, których ze względów technicznych nie można skierować do dziennika file przypadków..
• Ten folder jest domyślnie ukryty w systemie Windows. Aby go zobaczyć w File Eksplorator, który konfigurujesz, pokazuje ukryte files. Należy pamiętać, że można przejść do ukrytego folderu, wpisując adres w File Pasek adresu Eksploratora.
• Należy pamiętać, że SIMCA nie obsługuje wielu wystąpień SimApi, dlatego też używa nazw bez nazwy wystąpienia, jak opisano powyżej.

Planowanie sieci

• Powinieneś umieścić serwer SIMCA-online blisko źródła danych w sieci. Zapewnia to szybkie połączenie między SIMCA-online a jego źródłem danych.
• Sprzęt sieciowy może zakłócać połączenie między SIMCA-online i źródłem danych.

Konta użytkowników i uprawnienia do źródeł danych

• Źródła danych zazwyczaj kontrolują dostęp do swoich danych. Zazwyczaj odbywa się to za pomocą nazw użytkowników i haseł, ale można również stosować ograniczenia oparte na adresie IP lub DNS (np.ampLe PI Trusts w systemie Aveva PI).
• Nazwę użytkownika i hasło można przekazać źródłu danych na różne sposoby:
• SimApi jest uruchamiany jako użytkownik Windows użytkownika uruchamiającego pulpit SIMCA lub konto usługi SIMCA-online na komputerze serwera. SimApi może połączyć się ze źródłem danych za pomocą tego konta. W ten sposób działają OPC I i PI SimApi oraz ODBC, jeśli nie podasz poświadczeń podczas konfiguracji.
• W przypadku ogólnego zastosowania ODBC można skorzystać z aplikacji Administrator źródeł danych ODBC, która znajduje się w menu Start systemu Windows.
• Niektórzy dostawcy baz danych zapewniają własne sterowniki i narzędzia dla swoich baz danych. Bazy danych Oracle, np.ampnp. użyj Oracle Data Access Components (ODAC).
• Niektóre SimApi, takie jak PI AF i ODBC, mają okna dialogowe konfiguracji, w których zaszyfrowane dane uwierzytelniające są przechowywane w konfiguracji XML SimApi file.
• PI ma również różne opcje zabezpieczeń dostępne w PI System Management Tools na komputerze serwera PI. Przeczytaj więcej w PI AF SimApi User Guide. Ten przewodnik jest pomocny nawet jeśli używasz starszego OSIsoft PI SimApi.
• OPC DA i HDA używają DCOM jako transportu między źródłem danych a SimApi. DCOM jest konfigurowany za pomocą narzędzia Component Services (DCOMCNFG.EXE) w systemie Windows i używa uwierzytelniania systemu Windows.
• W przypadku starszej wersji OSIsoft PI SimApi (nie nowszej AF SimApi) do nawiązania połączenia z serwerem PI służy aplikacja OSIsoft AboutPI-SDK (PISDKUtility.exe).

Weryfikacja łączności ze źródłem danych
Jeśli chcesz zainstalować SimApi na komputerze, przydatne może okazać się sprawdzenie łączności tego komputera ze źródłem danych przy użyciu innego narzędzia:

• Źródła danych ODBC w systemie Windows służą do konfigurowania i testowania ogólnego ODBC. Należy pamiętać, że istnieją dwie wersje tego narzędzia w systemie Windows 64-bitowym: jedna dla aplikacji 32-bitowych i jedna dla aplikacji 64-bitowych. Użyj przycisku Testuj źródło danych na końcu kreatora konfiguracji ODBC, aby sprawdzić łączność z bazą danych. Zalecamy skonfigurowanie źródeł danych jako systemowych DSN.
• Narzędzie do łączenia się z konkretną bazą danych, pochodzące od dostawcy bazy danych, np. Oracle Data Access Components.
• PI System Explorer można użyć do testowania łączności z serwerem PI AF. Jest częścią PI AF Client, który jest warunkiem wstępnym dla PI AF SimApi.
• OPC UA Expert od Unified Automation – UaExpert to wieloplatformowy klient testowy dla serwerów OPC UA.
• Aplikację PI-SDK (PISDKUtility.exe) można wykorzystać do testowania łączności i view wszelkie komunikaty o błędach, które mogły zostać zarejestrowane, gdy SIMCA-online próbuje połączyć się z serwerem PI. Jest to używane tylko w przypadku starszego OSIsoft SimApi, nie PIAF.
• Narzędzia PI System Management Tools są używane na komputerze serwera PI do rozwiązywania problemów z tej strony. Na przykładample, aby wyszukać problemy z bezpieczeństwem uniemożliwiające dostęp z serwera SIMCA-online. Dowiedz się więcej o rozwiązywaniu problemów z systemem PI w tym filmie na YouTube.
• Program Excel można wykorzystać do pobierania danych z połączenia ODBC i większości innych systemów po zainstalowaniu odpowiedniej wtyczki.
• Matrikon OPC Explorer dla Ior HDA (są to osobne narzędzia) można użyć do testowania łączności OPC, a Matrikon OPC Analyzer można użyć do diagnozowania problemów z łącznością OPC. Pobierz te bezpłatne narzędzia z https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (dla DInd HDA) z OPC Training Institute web strona „umożliwia użytkownikom łatwą diagnozę problemów z komunikacją i bezpieczeństwem oraz natychmiastową naprawę za pomocą jednego przycisku. Wszystko to można zrobić bez konieczności uczenia się konfiguracji DCOM”

Instalowanie SimApi

Oto jak zainstalować SimApi na komputerze:

1. Przeczytaj Podręcznik użytkownika SimApi, który instalujesz. Zawiera on szczegóły dotyczące tego SimApi, które uzupełniają ogólne instrukcje, które teraz czytasz.
2. Zainstaluj i skonfiguruj wszystkie wymagania wstępne wymienione w Podręczniku użytkownika SimApi (np.amp(sterowniki baz danych lub zestawy SDK)
3. Uruchom program instalacyjny, aby zainstalować SimApi. Zainstaluj wersję 64-bitową (x64) lub 32-bitową (x86), która odpowiada oprogramowaniu, w którym ją uruchomisz.
4. Skonfiguruj SimApi w SIMCA-online lub SIMCA zgodnie z opisem w poniższych sekcjach. Aby uzyskać opisy dostępnych ustawień, zapoznaj się z instrukcją użytkownika SimApi.
5. Uruchom serwer SIMCA-online. Należy pamiętać, że może to potrwać, ponieważ po zainicjowaniu SimApi zostanie wyliczona cała tags w źródle danych.
6. Przetestuj SimApi, uzyskując pewne dane. W przypadku SIMCA-online możesz użyć File > Wyodrębnij zgodnie z opisem w 6.1.
7. Jeśli SimApi nie działa zgodnie z oczekiwaniami, zapoznaj się z dziennikiem SimApi fileAby uzyskać informacje na temat rozwiązywania problemów, zapoznaj się z podręcznikiem użytkownika SimApi.

Konfigurowanie SimApi do użytku w SIMCA

Oto jak używać SimApi w SIMCA:

1.  Rozpocznij importowanie bazy danych w jeden z następujących sposobów:
   • a. Aby utworzyć nowy projekt w SIMCA: File > Nowy projekt regularny lub nowy projekt wsadowy. Wybierz opcję Z bazy danych na karcie Home.
   • b. Aby zaimportować zestaw danych do istniejącego projektu w SIMCA: Ze zestawu danych na karcie Dane otwartego projektu SIMCA.
2. Kliknij Dodaj nowe źródło danych
3. Wybierz SimApi jako typ połączenia, kliknij przycisk … i znajdź .dll w folderze instalacyjnym i kliknij Otwórz.
4. Kliknij Konfiguruj i zapoznaj się z indywidualnym Podręcznikiem użytkownika SimApi, aby dowiedzieć się, jak wprowadzić ustawienia.
5. Kliknij Testuj połączenie ze źródłem danych, aby sprawdzić, czy możesz połączyć się z bazą danych. Może to potrwać długo, jeśli jest wiele tags w źródle danych.
6. Kliknij OK, aby zakończyć konfigurację.
7. Aby dowiedzieć się, jak pracować z importowanymi danymi, zapoznaj się z pomocą SIMCA.

Konfigurowanie SimApi do użytku w SIMCA-online

• Ważne: Aby móc używać SimApi, wymagana jest licencja serwera SIMCA-online. Instalacja demonstracyjna SIMCA-online nie pozwala na używanie SimApi.
• Aby dodać SimApi do systemu, uruchom opcje serwera SIMCA-online na komputerze serwera. Zapoznaj się ze szczegółowymi krokami w temacie pomocy SICMA-online Dodawanie i konfigurowanie SimApi na serwerze.
• Wskazówka: Jeśli wprowadzisz zmiany w SimApi, możesz ponownie uruchomić ten SimApi osobno, korzystając z Opcji serwera, bez konieczności ponownego uruchamiania całego serwera.
• Aby skonfigurować wiele wystąpień tego SimApi, powtórz powyższe kroki i użyj unikalnych nazw dla każdego wystąpienia. Przeczytaj więcej o różnych dziennikach i konfiguracjach files dla wystąpień w 4.2.

Testowanie i rozwiązywanie problemów SimApi

• W tym rozdziale opisano testowanie i rozwiązywanie problemów związanych z instalacją SimApi.

Testowanie SimApi z SIMCA-online

• Po pomyślnym uruchomieniu serwera SIMCA-online możesz przetestować swój SimApi w SIMCA-online (jeżeli serwer nie uruchomi się, zobacz 6.2):
• Zaloguj się do serwera w kliencie SIMCA-online i przejdź do opcji Wyodrębnij na File tab. Extract pomaga przetestować SimApi poprzez uzyskanie danych za jego pośrednictwem:
• Węzły („foldery”) SimApi są wyświetlane w polu po lewej stronie. Tags dla wybranego węzła wyświetlane są w prawym górnym rogu.
• Aktualne dane można szybko sprawdzić, po prostu klikając view> na tags które zapewniają ciągłe dane procesowe (zobacz zrzut ekranu)
• Kliknij prawym przyciskiem myszy węzeł, aby znaleźć partie w zakresie czasu. Węzeł musi być węzłem partii, który wie o partiach.
• Wybierać tags w polu Wyodrębnij kliknij Dalej i zakończ działanie kreatora, aby uzyskać dane, korzystając z różnych trybów pobierania danych: bieżących, historycznych, wsadowych i dyskretnych.
• Porównaj wyodrębnione dane z tym, co widzisz w swoim źródle danych, korzystając z jego narzędzi. Dowiedz się więcej o testowaniu i sprawdzaniu wszystkich funkcji SimApi w wersji 7.13.

Rozwiązywanie problemów z SimApi przy użyciu dziennika SimApi file

• Jeśli serwer nie uruchamia się, SimApi nie działa zgodnie z oczekiwaniami lub rozpakowywanie się nie powiedzie, należy sprawdzić dziennik SimApi file który mówi ci, jaki jest problem. Włącz rejestrowanie na poziomie debugowania w dzienniku SimApi, aby uzyskać pełne szczegóły. Zobacz 4.2.
• Uwaga: logi serwera SIMCA-online nie są tutaj zbyt przydatne. Pokażą, jak SimApi został załadowany i zainicjowany przez serwer, ale szczegółowe informacje o SimApi znajdują się w jego logu file.

Użyj właściwego konta usługi SIMCA-online

• Podczas testowania dostępu do źródła danych pamiętaj, że jesteś zalogowany jako konkretny użytkownik na komputerze serwera (zwykle na swoim własnym koncie użytkownika w domenie Windows), ale konto usługi serwera SIMCA-online to inne konto, domyślnie LocalSystem, które ma inne prawa dostępu w porównaniu do Twojego konta użytkownika.
• Z tego powodu nierzadko zdarza się, że testy działają po uruchomieniu z poziomu Twojego konta, ale SIMCA-online nie może nawiązać połączenia ze źródłem danych.
• Aby rozwiązać ten problem, należy przyznać dostęp do konta używanego przez usługę serwera SIMCA-online. Zazwyczaj zmieniasz LocalSystem na określone konto usługi domeny i przyznajesz uprawnienia do tego konta. Należy pamiętać, że nie ma to zastosowania, jeśli SimApi używa poświadczeń ustawionych w konfiguracji SimApi, ponieważ te poświadczenia mają pierwszeństwo.

Szczegóły techniczne dotyczące SimApis

• Ten rozdział zawiera szczegóły techniczne dotyczące działania SimApi. Jest on skierowany głównie do deweloperów, którzy chcą zrozumieć SimApi, aby zaimplementować SimApi dla źródła danych.
• Programiści powinni również przeczytać wcześniejsze części tego dokumentu, aby zapoznać się ze wstępem do SimApis i ogólnym opisem funkcji.

Kiedy warto rozważyć opracowanie SimApi, a kiedy nie?

Zanim rozważysz opracowanie SimApi dla źródła danych:

1. Zbadaj, czy istnieje już SimApi, którego możesz użyć. Być może możesz włączyć jakąś funkcję w swoim źródle danych, aby użyć jednego z istniejących SimApi, takiego jak OPC UA.
2. Dokładnie przejrzyj ten dokument i jego odniesienia, a następnie sprawdź, czy Twoje źródło danych spełnia wymagania, np.amptzn. musi być wystarczająco szybki, dostarczać nie tylko bieżące dane, ale także dane historyczne.

• Z tych powodów nie zalecamy tworzenia SimApi, który łączy się ze sprzętem lub instrumentami niskiego poziomu. Lepiej jest połączyć te instrumenty z historykiem procesów, takim jak Aveva PI System, i pozwolić mu uzyskać dane z instrumentu i je zhistoryzować. Następnie PIAF SimApi można użyć do uzyskania danych z PI do produktu Umetrics.

Rozwój SimApi i specyfikacja SimApi

• Specyfikacja SimApi, SimApi-v2, zawiera dokumentację wszystkich funkcji C w SimApi, które biblioteka DLL SimApi musi zaimplementować, a także wskazówki dotyczące tworzenia SimApi.
• Implementacja SimApi za pomocą języka C lub C++ odbywa się w większości przypadków na niepotrzebnie niskim poziomie.
• Zalecanym i łatwiejszym sposobem wdrożenia SimApi jest oparcie go na Exampkod źródłowy leSimApi, który udostępniamy. Jest to byłyampimplementacja SimApi, która obsługuje interfejs C i tłumaczy go na .NET Framework, gdzie wykonywana jest rzeczywista implementacja. Posiada również kod frameworka do rejestrowania, ustawień, konfiguracji GUI i inny kod frameworka.
• Aby opracować SimApi, zespół programistów musi mieć doświadczenie w programowaniu Windows, .NET Framework, C lub C++. Dobra znajomość źródła danych, z którym SimApi powinno się połączyć, jest również wymagana, ponieważ celem SimApi jest tłumaczenie żądań danych z SIMCA-online lub SIMCA na API źródła danych. Implementacja SimApi nigdy nie jest jednorazowym projektem, ale zazwyczaj wymaga stałego wsparcia i okazjonalnej konserwacji.

Odczyt lub zapis danych

• Głównym zadaniem SimApi jest dostarczanie danych ze źródła danych. Nazywa się to odczytywaniem danych.
• Większość implementacji SimApi obsługuje również zapisywanie danych. Oznacza to zapisywanie danych z powrotem przez SimApi do źródła danych. Zapisywanie danych jest opcjonalną funkcją w SIMCA-online.

Tags i węzły

• A tag jest identyfikatorem kolumny lub „zmiennej” w źródle danych. tagNazwa jest używana do identyfikacji tag. Nazwy w obrębie węzła muszą być unikalne. SIMCA-online 18 jest pierwszą wersją obsługującą węzeł, który zawiera podwęzeł i tag o tej samej nazwie. Na przykładample: węzeł Parent może mieć podwęzeł o nazwie Batch i tag nazywany Batch.
• Węzeł jest kontenerem tags. Węzeł może również zawierać inne węzły, podobnie jak file system ma foldery w folderach.
• Jak w file system, węzeł i tag nazwy można łączyć w pełną ścieżkę, która jednoznacznie identyfikuje tag. Ten tag ścieżki są używane w SIMCA-online lub SIMCA podczas wybierania tags używać. A tag ścieżka zaczyna się od nazwy instancji SimApi, po której następuje struktura węzła i kończy się tag nazwa, każdy element oddzielony dwukropkiem (:). Np.amp„:ODBCSQLServer:Node:SensorTag1”.

SimApi wylicza tags i węzły przy uruchomieniu

• Implementacja SimApi przeszukuje serwer w poszukiwaniu węzłów i tags w źródle danych, gdy SimApi jest inicjowany i śledzi je, tak aby różne funkcje SimApi, które są używane do wyliczania tags i węzeł może zostać zaimplementowany.
• Inicjalizacja SimApi nie odbywa się wyłącznie podczas uruchamiania serwera, ale może być również ponownie wywołana przez użytkownika w SIMCA-online za pomocą funkcji Odśwież SimApi.

Rozróżnianie wielkości liter tag- i nazwy węzłów

• Tag nazwy i nazwy węzłów rozróżniają wielkość liter.
• Tak więc, tag zwany "tag1” nie jest tym samym co „Tag1” ze względu na inną wielkość literki „T”. Zalecamy nieużywanie tags lub nazwy węzłów różniące się jedynie wielkością liter.

Węzeł procesu ciągłego 

• Gdy węzeł zawiera tags z ciągłymi danymi procesowymi, można go nazwać węzłem procesu. Poniższe dwa zrzuty ekranu pokazują tabelaryczną reprezentację węzła procesu z danymi, a następnie obraz pokazujący, jak węzeł wygląda po wybraniu tags w SIMCA-online.

Węzły procesów ciągłych muszą być niezależne od partii, przebiegów i czasu

• Aby dobrze działać w SimApi, węzeł musi być niezależny od partii, przebiegów lub czasu. Posiadanie węzła zawierającego dane dla określonej partii lub zakresu czasu nie działałoby dobrze w SIMCA-online, ponieważ konfiguracja projektu mogłaby wówczas odczytywać tylko dane dla tej partii i nie być używana dla innych partii.
• Zamiast tego węzeł powinien być mapowany na jedną lub więcej jednostek fizycznych w procesie, w którym wykonywane są pomiary.

Identyfikator partii tag wymagane w węzłach procesów ciągłych do realizacji projektów wsadowych

• Każdy proces ciągły musi mieć tag (zmienna) zawierająca identyfikator partii dla każdej obserwacji. Ten identyfikator partii jest używany przez SIMCA lub SIMCA-online, aby wiedzieć, do której partii należy każda obserwacja.
• Identyfikator partii tag na zrzucie ekranu w wersji 7.4.3 jest taki example.
  Choć nie jest to wymagane, zaleca się posiadanie tag w węźle procesu, który pokazuje bieżącą fazę lub krok procesu. To tag można następnie użyć w warunkach wykonania fazy w SIMCA-online lub w SIMCA podczas importowania danych. Wartości dla tego tag może być na przykładamp„faza 1”, „czyszczenie”, „faza 2”.

Węzeł kontekstu wsadowego

• Węzeł wsadowy to węzeł, który śledzi wsady; ich identyfikatory wsadowe, czasy rozpoczęcia i zakończenia. Jest to wymóg wykonania projektu wsadowego w SIMCA-online. Źródło danych może mieć więcej niż jeden węzeł wsadowy, który udostępnia wsady na różne sposoby. Użytkownik wybiera węzeł wsadowy, który ma zastosowanie do jego aplikacji. Ten przykładample udostępnia partie obejmujące dwie różne jednostki:
• /Factory1 – partie z zagregowanymi czasami życia dla Unit1 i Unit2.
• /Factory1/Unit1 – partie z okresami istnienia tylko w Unit1
• /Factory1/Unit2 – partie z okresami istnienia tylko w Unit2
• Jeśli nie masz węzła wsadowego w swoim źródle danych, możesz użyć Batch Context Generator w SIMCA-online. Zobacz wbudowaną pomoc.
• Opcjonalne dane wsadowe
• Węzeł partii może również zawierać dane partii; dane, dla których istnieje tylko jedna obserwacja dla całej partii. Należy zauważyć, że tags z danymi wsadowymi nie musi znajdować się w węźle, który ma pełną funkcjonalność węzła wsadowego. Wystarczy, że SimApi obsługuje odczyt danych wsadowych dla tags. Dowiedz się więcej o danych wsadowych w wersji 7.6.
• Oto byłyample węzła wsadowego:
• Uwaga: Powyższy zrzut ekranu pochodzi z DBMaker, dołączonego do SIMCA-online. Aby zobaczyć go samodzielnie w DBMaker, kliknij View Przycisk danych w bazie danych drożdży piekarniczych wyświetlający dwa okna, z których jedno to węzeł wsadowy, a drugie to dane procesu.

Typy danych: dane liczbowe, dane tekstowe i dane brakujące

• Dla każdego tagSimApi może obsługiwać trzy typy danych: numeryczne, tekstowe i brakujące:
• Dane liczbowe to zazwyczaj rzeczywiste wartości parametrów procesu, np.ample 6.5123. SimApi może obsługiwać tylko 32-bitowe wartości zmiennoprzecinkowe pojedynczej precyzji. Format zmiennoprzecinkowy pojedynczej precyzji -Wikipedia. Wszystkie inne typy danych liczbowych w źródle danych powinny zostać przekonwertowane na float. Jako takie mogą obsługiwać zarówno duże, jak i małe wartości, ale tylko z około 6 lub 7 znaczącymi cyframi. Dowiedz się więcej w Technical Guide.
• Może to prowadzić do utraty precyzji dla dużych liczb całkowitych lub dla liczb rzeczywistych, które są zarówno duże, jak i mają miejsca dziesiętne. Aby uzyskać więcej informacji, zobacz Technical Guide.
• Dane tekstowe/ciągowe są używane do identyfikatorów partii, warunków wykonania fazy lub zmiennych jakościowych. Wartości dla tekstu tag dane są rozróżniane wielkością liter. Oznacza to, że wartość „running” nie jest taka sama jak
  „RUNNING”. Zmienne datetime nie są bezpośrednio obsługiwane przez SimApi, ale mogą być zwracane jako ciąg sformatowany jako YY-MM-DD HH:MM (np.ample “2020-09-07 13:45”).
• Wartości brakujące oznaczają, że nie ma wartości do zwrócenia, czyli brak danych.
• To, jaki typ jest zwracany, zależy od implementacji SimApi. SimApi zna dane w źródle danych i powinien zwrócić typ danych, który najlepiej pasuje.

Trzy tryby pobierania danych: ciągły, wsadowy i dyskretny

• Specyfikacja SimApi definiuje trzy tryby pobierania danych, tj. trzy różne sposoby, w jakie SimApi może dostarczać dane z tags w źródle danych (lub w przeciwnym kierunku: zapisz dane do tags w źródle danych).
• Ciągłe pobieranie danych – odnosi się do danych odczytywanych w sposób ciągły i sekwencyjny, obserwacja po obserwacji, w miarę rozwoju partii lub procesu. Dane są odczytywane dla bieżącego czasu lub dla określonego zakresu, w regularnych odstępach czasu między obserwacjami. Na przykładample, wszystkie dane pomiędzy 09:00:00 a 10:00:00 sampprzeprowadzano co 60 sekund, co dało 61 obserwacji, gdy punkty końcowe były wliczone w cenę.
• Pobieranie danych wsadowych – odnosi się do pojedynczej obserwacji z danymi dla całego wsadu (niezwiązanego z konkretnym terminem dojrzewania lub punktem czasowym). Atrybuty wsadowe i lokalne dane centrowania są odczytywane jako dane wsadowe w SIMCA-online. Warunki wsadowe są zwykle odczytywane również jako dane wsadowe (chyba że są skonfigurowane do dyskretnego pobierania danych).
• Odzyskiwanie danych dyskretnych – dane dyskretne mogą składać się z kilku obserwacji dla wielu dojrzałości. Jednak w przeciwieństwie do danych ciągłych, dane dyskretne nie są odczytywane sekwencyjnie, ale wszystkie dane naraz dla określonej fazy partii. Dane nie muszą być rozdzielone regularnymi odstępami zmiennej dojrzałości. Wszystkie dane są odczytywane ponownie za każdym razem, gdy dane są żądane, w skonfigurowanym odstępie.
• Dla każdego podanego tag dane można zażądać w dowolnym z trzech trybów, ale zazwyczaj SimApi obsługuje tylko jeden z tych trybów dla danej osoby tagPodobnie, można mieszać tags w obrębie węzła, ale zwykle wszystkie tags w obrębie konkretnego węzła obsługują ten sam tryb pobierania danych.
• W przypadku danych ciągłych (ale nie danych wsadowych lub dyskretnych2) można żądać danych bieżących lub danych historycznych, co jest tematem następnej sekcji.
• Nie wszystkie SimApi obsługują wszystkie tryby. Zobacz macierz funkcji powyżej i SimApi web Więcej szczegółów na stronie.

Bieżące i historyczne dane ciągłe za pośrednictwem SimApi

• Dane ciągłe odnoszą się do danych procesowych, które zmieniają się w czasie.

Aktualne dane

• Odczyt bieżących danych oznacza poproszenie źródła danych o najnowsze wartości tags w momencie zadawania pytania. Należy zauważyć, że czas zewnętrznego źródła danych nie jest tutaj używany.
• Dane odczytane jako bieżące dane to te, które SIMCA-online pokaże jako dane na żywo. Z tego powodu ważne jest, aby nie było niepotrzebnych opóźnień w źródle danych. Bieżące dane powinny być tak aktualne, jak to możliwe, aby dobrze działać w SIMCA-online.
• Źródło danych może wykorzystać swoją wiedzę o danych i tym, jak długo wartości są ważne, i zdecydować o zwróceniu brakujących danych, gdy surowe dane dla punktu czasowego są zbyt stare. Na przykładample: dane są żądane o 15:00:00, ale najnowszy punkt danych w źródle danych pochodzi z 03:00:00. W tym przypadku dane mają 12 godzin, więc SimApi może zdecydować się na zwrócenie wartości brakujących (brak danych).

Dane historyczne

• Odczyt danych historycznych oznacza poproszenie źródła danych o wartości jednego lub więcej tags dla określonego przedziału czasu z określonym interwałem między obserwacjami. Zauważ, że tutaj lokalny czas źródła danych jest używany do znajdowania danych. Dlatego synchronizacja czasu między źródłem danych a serwerami jest ważna.
• Dane historyczne składają się z macierzy danych. To implementacja SimApi musi zażądać danych ze źródła danych i samppozostaw go w określonym przedziale i skonstruuj macierz danych do zwrócenia:
• Czasami samo źródło danych ma funkcje agregacji, które zwracają przetworzone dane lubampfunkcje ling, które można wykorzystać do zwracania właściwych danych.
• W przypadku innych źródeł danych SimApi musi zażądać wszystkich danych w danym przedziale czasowym, a następnieampWybierz właściwe obserwacje, aby skonstruować macierz.
• Dane muszą zostać zwrócone dla zakresu czasu, nawet jeśli nie ma surowych danych w zakresie czasu, ale tylko tuż przed czasem rozpoczęcia. Na przykładample: dane istnieją w źródle danych w punktach czasowych 10 i 20. SimApi żąda danych dla punktów czasowych 15 i 17. W tym przypadku wartości dla punktu czasowego 10 powinny zostać zwrócone przez SimApi, ale timestamped jako czas 15 i 17, ponieważ były to najnowsze punkty danych w tych czasach. Wartości dla tags w czasie 10 są określane jako wartości graniczne dla żądanego zakresu. Aby uzyskać głębsze wyjaśnienie wartości granicznych, zobacz np.amppobierz dokumentację dla returnBounds w UA Część 11: Dostęp historyczny – 6.4.3 Struktura ReadRawModifiedDetails
  (fundacja opcfoundation.org)
• Interpolacji nigdy nie należy stosować do obliczania wartości dla przyszłych punktów czasowych, ponieważ dane nie będą odpowiadać tym, które są odczytywane w czasie rzeczywistym jako bieżące dane. W przypadku np.ampz poprzedniego punktu: gdyby dane dla punktów 15 i 17 miały zostać interpolowane przy użyciu wartości dla punktów 10 i 20, w efekcie wykorzystano by wartości z przyszłości, co jest niedozwolone.
• Źródło danych może wykorzystać swoją wiedzę o danych i tym, jak długo wartości są ważne, i zdecydować o zwróceniu brakujących danych, gdy surowe dane dla punktu czasowego są zbyt stare. Na przykładample: dane są żądane dla 15:00:00, ale najnowszy punkt danych w źródle danych pochodzi z 03:00:00. W tym przypadku dane mają 12 godzin, więc SimApi może zdecydować się na zwrócenie wartości brakującej (brak danych).

Notatka: SIMCA-online zazwyczaj nie żąda więcej niż stu obserwacji w jednym wywołaniu podczas normalnego wykonywania projektu. Podczas wykonywania ekstraktu w SIMCA-online lub podczas uruchamiania pulpitu SIMCA, można składać większe żądania danych. Mogą one zająć dużo czasu, czego należy się spodziewać.

Dane bieżące i historyczne muszą być zgodne

• Czasami mogą występować różnice, gdy dane są odczytywane jako bieżące dane w czasie rzeczywistym lub dane historyczne. Powoduje to problemy w SIMCA-online, ponieważ serwer automatycznie przełącza się między danymi bieżącymi i historycznymi w razie potrzeby.

Pozyskiwanie danych o niskim opóźnieniu

• Gdy źródło danych jest używane przez SIMCA-online w czasie rzeczywistym, ważne jest, aby dane w źródle danych były aktualne. Nie powinno być niepotrzebnych opóźnień w pozyskiwaniu danych w źródle danych. Ciągłe dane procesowe dla wszystkich zmiennych muszą być dostępne w tym samym czasie dla każdej obserwacji. Dane, które nadejdą późno dla niektórych zmiennych, nie zostaną odebrane przez SIMCA-online.

Dane można odczytać w dowolnym momencie 

• Gdy SIMCA-online poprosi o podanie wartości tag dla czasu t otrzyma wartość ze źródła danych z czasu t lub ostatnią obserwację w źródle danych przed czasem t lub interpolowaną wartość dla czasu t. W ten sposób serwer zawsze otrzyma wartość w każdym momencie, o który poprosi, nawet jeśli obserwacja dla tego dokładnego punktu czasu może nie istnieć w źródle danych.
• Czasamps w SimApi są zawsze UTC. Klienci SIMCA-online i SIMCA prezentują czas jako czas lokalny.

Nawlekanie 

• SimApi jest domyślnie wywoływany przez pojedynczy wątek przez użytkownika SimApi. Dotyczy to wszystkich wersji SIMCA i SIMCA-online do wersji 17.
• SIMCA-online 18 obsługuje flagę funkcji, aby włączyć dostęp wielowątkowy przez SimApi. Więcej informacji można znaleźć w temacie pomocy Równoczesny dostęp do SimApi.
• Oznacza to, że SimApi powinny przygotować się do obsługi wielu wątków, jeśli to możliwe, poprzez zapewnienie bezpieczeństwa wątku implementacji SimApi, a także udokumentować ten fakt i wszelkie inne uwagi dla użytkowników SimApi.

Dziennik file

• SimApi powinien rejestrować działania, komunikaty o błędach i ostrzeżenia w swoim dzienniku file aby pomóc w rozwiązywaniu problemów. Użyj różnych poziomów rejestrowania, aby wskazać ważność rejestrowania.
• Zaleca się rejestrowanie statusu „Nie zaimplementowano” w przypadku funkcji, które nie zostały zaimplementowane w SimApi.

Obsługa błędów

• Jeśli SimApi nie może zrealizować żądania ze źródła danych, może rozwiązać ten problem na jeden z dwóch sposobów: zwracając brakujące wartości (brak danych) lub sygnalizując błąd SimApi:
• Zwrócenie brakujących wartości do wywołującego i zasygnalizowanie sukcesu pozwala wywołującemu kontynuować normalnie (ale oczywiście bez żadnych danych). Jest to zalecana praktyka w przypadku błędów częściowych, takich jak gdy dane można uzyskać dla niektórych, ale nie wszystkich, tags w prośbie.
• Zasygnalizowanie błędu SimApi umożliwia wywołującemu (np.ampserwer SIMCA-online) aby natychmiast to zobaczyć i podjąć działanie. Jest to zalecana praktyka w przypadku żądań, które całkowicie się nie powiodą i nie mogą zwrócić żadnych danych.
• SIMCA-online obsługuje brakujące wartości i kody błędów w inny sposób, zgodnie z opisem zamieszczonym w Podręczniku technicznym SIMCA-online.

Wymagania wydajnościowe SimApi

• Funkcje SimApi służą do pozyskiwania danych.
• Jeśli dostęp do danych jest powolny, SimApi nie będzie działać prawidłowo, co jest typowe dla tego typu aplikacji.amppokazuje: Jeżeli SIMCA-online żąda danych co sekundę, a ich pobranie zajmuje dwie sekundy, serwer SIMCA-online nigdy nie będzie w stanie nadążyć za danymi w czasie rzeczywistym, lecz będzie stopniowo coraz bardziej pozostawać w tyle.
• W podsekcjach pokażemy, jak SIMCA i SIMCA-online używają funkcji dostępu do danych SimApi i jak często funkcje SimApi będą wywoływane. Może to pomóc w ustaleniu wymagań wydajnościowych dla implementacji SimApi.

Wykorzystanie funkcji SimApi przez SIMCA

• Gdy stacjonarny SIMCA lub inne produkty offline używają SimApi do uzyskiwania danych, żądania te będą dotyczyły partii i przetwarzania danych dla zestawu zmiennych w określonym przedziale czasowym.
• Ponieważ żądania te są inicjowane ręcznie przez użytkownika, nie zdarzają się zbyt często i nie powodują znacznego obciążenia źródła danych.
• Do uzyskania danych służą następujące funkcje SimApi:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionOdczytHistorycznychDanychEx

Wykorzystanie funkcji SimApi przez SIMCA-online

• SIMCA-online służy do monitorowania procesu w czasie rzeczywistym, dlatego też żąda danych przez SimApi w regularnych odstępach czasu. Najkrótszy możliwy interwał wykonania to 1 sekunda. Niektóre rzeczywiste exampOdstępy czasu między wykonaniami wynoszą 10 s, 1 minutę lub 10 minut.
• Na serwerze może być uruchomionych wiele projektów równocześnie.
• Aby ograniczyć liczbę wywołań API za pośrednictwem SimApi, serwer optymalizuje żądania danych poprzez grupowanie wielu równoczesnych mniejszych żądań w jedno większe żądanie dotyczące wszystkich zmiennych jednocześnie (więcej informacji można znaleźć w temacie pomocy „Zoptymalizowane odczytywanie ze źródeł danych poprawia wydajność”).
• Algorytm wykonywania zadań przez serwer działa w następujący sposób, gdy żąda on danych za pomocą funkcji SimApi wymienionych poniżej:
• Wszystkie fazy wykonywane w tym samym odstępie czasu są grupowane w jednym wywołaniu SimApi, aby zmniejszyć liczbę wywołań. Serwer odczytuje najnowsze dane dla wszystkich zmiennych używanych przez wszystkie modele, które współdzielą odstęp czasu, tj. to wywołanie spowoduje szeroki wiersz danych, który następnie jest używany przez wszystkie projekty.
  • simapi2_connectionOdczytBieżącychDanych
• Dla każdego projektu wsadowego serwer musi również wiedzieć, które wsady są aktywne. Musi się to również zdarzyć za każdym razem, gdy projekt jest wykonywany:
  • simapi2_nodeGetActiveBatches
  • Funkcja simapi2_nodeGetBatchTimes jest wywoływana rzadziej.
• Ponadto SIMCA-online wymaga również danych historycznych. Te żądania pojawiają się tylko wtedy, gdy są potrzebne, np. gdy nadrabia się początek partii, która została uruchomiona przed uruchomieniem SIMCA-online, lub gdy serwer się opóźnia i musi odczytać blok danych:
  • simapi2_connectionOdczytHistorycznychDanychEx
• Opcjonalnie, niektóre konfiguracje projektu wykorzystują funkcje wykorzystujące dane wsadowe lub dane dyskretne, co skutkuje wywołaniami SimApi do:
  • simapi2_connectionOdczytDanychWsadowych
  • simapi2_connectionOdczytDyskretnyEx
• Opcjonalnie, niektóre konfiguracje projektu wykorzystują zapis zwrotny w celu przesłania danych z powrotem do źródła danych:
  • simapi2_connectionWriteHistoricalDataEx (i odpowiadające im funkcje dla danych wsadowych, danych dyskretnych)
• Ważne jest, aby każde wywołanie podstawowych funkcji służących do pobierania danych (readCurrentData, getActiveBatches/getBatchTimes) było szybkie i nie powodowało dużych obciążeń obliczeniowych dla samego źródła danych, biorąc pod uwagę częstotliwość, z jaką SIMCA-online może wywoływać te funkcje.

Testowanie i walidacja danych SimApi

• Ta sekcja dotyczy testowania SimApi w celu sprawdzenia, czy dane zwrócone z niego są zgodne z danymi w samym źródle danych. Uruchamianie takich testów jest ważne po utworzeniu lub zmianie implementacji SimApi lub po zmianie API źródła danych.
• W praktyce walidacja danych odbywa się za pomocą SIMCA-online i jego funkcji Extract, aby pobrać dane ze źródła danych przez SimApi, a następnie porównać je z danymi surowymi w źródle danych. Desktop SIMCA nie może być używany do testowania aspektów SimApi w czasie rzeczywistym.

Przygotowania i wymagania

• Niektóre elementy są opcjonalne, ale można je wykonać, jeśli zakres testów je obejmuje:

1. Zainstaluj SIMCA-online zgodnie z opisem zawartym w pliku ReadMe oraz Installation Guide.pdf dołączonym do produktu.
2. Uzyskaj licencję na serwer SIMCA-online i zainstaluj go. SimApi nie będzie działać bez licencji. Artykuł bazy wiedzy dla SIMCA-online pokazuje, jak uzyskać licencję na produkt. Na przykładample: SIMCA-online 18 (sartorius.com)
3. Zainstaluj i skonfiguruj SimApi, które chcesz przetestować. Zapoznaj się z rozdziałami 4–5 w tym dokumencie i instrukcją użytkownika konkretnego SimApi.
   • a. Opcjonalnie: upewnij się, że instrukcja obsługi jest aktualna i poprawna.
4. Upewnij się, że dysponujesz narzędziem dla swojego źródła danych, dzięki któremu będziesz mógł porównać dane SimApi.
5. W kliencie komputerowym SIMCA-online zaloguj się do serwera SIMCA-online i użyj File > Wyodrębnij, aby uzyskać dane przez SimApi.
6. Opcjonalnie, jeśli obejmuje to zakres testowania: po zakończeniu testowania odinstaluj SimApi i sprawdź jego działanie. filesą usuwane.

Co testować

• Macierz cech w rozdziale 3 zawiera listę wszystkich możliwych cech, ale dana implementacja SimApi może obsługiwać tylko podzbiór. Należy przetestować wszystkie cechy, które są implementowane przez daną SimApi.
• Poniższe testy są wspólne dla większości implementacji SimApi:
• Uwierzytelnianie za pomocą nazw użytkowników i haseł
• Przetestuj różne ustawienia w konfiguracji SimApi
• Hierarchia węzłów: Węzły i tags ujawnione przez SimApi są poprawne.
  • Musi być tag wystawione dla wszystkich „zmiennych”, które powinny być dostępne poprzez SimApi. Examples: pomiary procesów, wartości obliczone, stałe.
• Elastyczność połączenia: jeśli źródło danych jest niedostępne, w dzienniku pojawiają się ostrzeżenia lub błędy fileale połączenie ze źródłem danych zostanie automatycznie nawiązane ponownie, gdy źródło danych stanie się dostępne.
• Wiele instancji: dwie instancje można skonfigurować i używać niezależnie i jednocześnie, z oddzielnymi dziennikami files.
• Bieżące dane: wyodrębnij bieżące dane dla tags. Upewnij się, że dane są ostatnimi znanymi wartościami ze źródła danych lub że brakuje ich z powodu złej jakości lub gdy dane są zbyt stare.
  • Wyodrębniaj dane co około 10 sekund przez minutę.
• Dane historyczne ciągłe: wyodrębnij dane historyczne dla tags.
  • Użyj zakresu czasu, który pasuje do momentu wyodrębnienia bieżących danych. Sprawdź, czy bieżące dane pasują do danych historycznych i surowych danych w źródle danych.
  • Wypróbuj różne przedziały czasowe i sampinterwałach, sprawdź, czy dane są zgodne ze źródłem danych.
  • Spróbuj wyodrębnić dane co 1 s, co jest najkrótszym możliwym czasemampling interwał.
  • Wypróbuj różne rodzaje tags w źródle danych (zmienne procesu itp.), upewniając się, że dane są zgodne.
  • Uwaga: SIMCA-online może podzielić pojedyncze duże żądanie danych historycznych na kilka mniejszych fragmentów. Będzie to widoczne w dzienniku SimApi.
• Sprawdź, czy SimApi działa z danymi tekstowymi, danymi liczbowymi i danymi brakującymi.
• Dziennik SimApi file. Sprawdź, czy dziennik zawiera rozsądne wpisy.
• Węzeł wsadowy: kliknij węzeł prawym przyciskiem myszy i wybierz opcję Znajdź wsad.
  • Sprawdź nazwy partii, godziny rozpoczęcia i zakończenia partii.
  • Wypróbuj aktywną partię, która jest uruchomiona w źródle danych. Nie powinna mieć czasu zakończenia przez SimApi.
• Identyfikator partii węzła procesu tagJeśli SimApi ma funkcjonalność węzła wsadowego (patrz poprzedni punkt), musi mieć również identyfikator wsadowy tag w węźle danych procesu dopasowania. Dane dla tego tag powinien być identyfikatorem partii (nazwą partii). Te dane są wymagane dla projektów partii w celu zidentyfikowania, do której partii należy wiersz danych.

W zależności od tego, czy SimApi to obsługuje, możesz również przetestować:

• Dane wsadowe przy użyciu File > Wyciąg.
• Dane dyskretne przy użyciu File > Wyciąg. Uwaga: aby przetestować dane dyskretne za pomocą File > Wyodrębnij węzeł, węzeł wsadowy i węzeł danych dyskretnych muszą znajdować się w tym samym SimApi (gdy SIMCA-online wykonuje projekty, mogą one pochodzić z różnych SimApi).
• Write back – przesyłanie partii danych do źródła danych. Aby to przetestować, należy skonfigurować konfigurację projektu w SIMCA-online, aby zapisać wektory danych z powrotem do źródła danych. Następnie należy wykonać projekt w SIMCA-online i sprawdzić dane, które są zapisywane z powrotem w źródle danych.
• Dane ciągłe konfiguruje się na stronie Evolution Write Back w konfiguracji projektu.
• Dane dyskretne konfiguruje się na tej samej stronie, ale tylko dla fazy skonfigurowanej do pobierania danych dyskretnych.
• Dane wsadowe z zapisu wsadowego

WIĘCEJ INFORMACJI

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Szwecja
• Telefon: + 46 90-18 48 00
• www.sartorius.com
• Informacje i rysunki zawarte w niniejszej instrukcji odpowiadają dacie wersji określonej poniżej.
• Sartorius zastrzega sobie prawo do wprowadzania zmian w technologii, funkcjach, specyfikacjach i konstrukcji sprzętu bez uprzedzenia. Aby ułatwić czytelność niniejszej instrukcji, zastosowano formę męską lub żeńską i zawsze jednocześnie oznaczano wszystkie rodzaje płci.
  Informacja o prawach autorskich:
• Niniejsza instrukcja, łącznie ze wszystkimi komponentami, jest chroniona prawem autorskim.
• Jakiekolwiek użycie wykraczające poza granice prawa autorskiego jest niedozwolone bez naszej zgody.
• Dotyczy to w szczególności przedruku, tłumaczenia i redakcji, niezależnie od rodzaju użytego nośnika.

Często zadawane pytania

• P: Jaki jest cel SimApis?
  • A: Głównym celem SimApis jest dostarczanie danych do produktów Umetrics Suite na potrzeby tworzenia projektów i budowania modeli.
• P: Jak mogę rozwiązać problemy z instalacją SimApi?
  • A: Problemy można rozwiązać, testując je w SIMCA-online, sprawdzając dziennik SimApi filei zapewnienie prawidłowej konfiguracji konta usługi.

Dokumenty / Zasoby

Oprogramowanie SARTORIUS Sim Api [plik PDF] Instrukcja użytkownika Oprogramowanie Sim Api, Oprogramowanie Api, Oprogramowanie

Odniesienia

• Instrukcja obsługi