Integracje - integracja z systemem DCS poprzez tabele wymiany SQL

Wstęp

Dokument opisuje konfigurację integracji systemu AMAGE z systemem DCS przy użyciu tabel wymiany SQL. Scenariusz pokazuje, jak przygotować mapowanie danych produkcyjnych, jak zweryfikować poprawność odczytu oraz jak kontrolować status przetwarzania rekordów.

Integracja opiera się na cyklicznym pobieraniu danych z tabeli wymiany i mapowaniu ich na parametry w systemie AMAGE. Dzięki temu odczyty z DCS mogą być automatycznie prezentowane na zasobach, punktach pomiarowych lub innych obiektach skonfigurowanych w systemie.

Założenia i przygotowanie

Przed rozpoczęciem konfiguracji upewnij się, że:

połączenie SQL do źródła danych DCS jest poprawnie skonfigurowane,
tabela wymiany zawiera rekordy z identyfikatorem obiektu i wartościami parametrów,
w systemie AMAGE istnieją parametry, które mają być aktualizowane przez integrację.

Konfiguracja mapowania krok po kroku

Przykład wykorzystuje integrację z dynamicznym określaniem danych, które zewnętrzny system przesyła. Dane deklarujemy w jednej z tabel. System zewnętrzny pobierze informację o oczekiwanych parametrach, a następnie do drugiej tabeli będzie wpisywał wartości dla tych parametrów. System AMAGE będzie cyklicznie odczytywał te dane i aktualizował parametry.

Krok 1. Definicja parametrów docelowych

Na początku zdefiniuj parametry, które będą zasilane danymi z DCS. Parametry powinny odpowiadać typom danych przesyłanym przez tabelę wymiany (np. liczba, tekst, data/czas).

Rysunek 1. Definicja parametrów, które chcemy pobierać

Wpisujemy je w sekcję aktualizacji zewnętrznej bazy danych za pomocą instrukcji INSERT. Wpisujemy do tabeli wymiany, z której nadrzędny system pobierze parametry do pobrania.

Krok 2. Definicja kodu danej produkcyjnej

Następnie skonfiguruj kod danej produkcyjnej, który będzie używany do jednoznacznego powiązania wpisu z tabeli SQL z odpowiednim parametrem lub obiektem w AMAGE.

Rysunek 2. Definicja kodu danej produkcyjnej

Krok 3. Utworzenie mapowania SQL → AMAGE

W konfiguracji integracji zdefiniuj regułę mapowania kolumn źródłowych z tabeli DCS na pola docelowe w systemie. W tym kroku określasz m.in. kolumnę z wartością, identyfikator rekordu oraz dodatkowe pola sterujące.

Rysunek 3. Mapowanie przychodzących danych SQL z systemu DCS

Krok 4. Weryfikacja listy mapowań

Po zapisaniu konfiguracji sprawdź listę mapowań przypisanych do połączenia systemowego. Pozwala to potwierdzić, że aktywne są właściwe reguły i że nie występują duplikaty.

Rysunek 4. Lista mapowań dla danego połączenia systemowego

Weryfikacja działania integracji

Krok 5. Kontrola logów integracji

Po uruchomieniu synchronizacji przejdź do logów systemowych integracji. Na tym etapie weryfikujesz, czy rekordy zostały odczytane i przetworzone bez błędów.

Rysunek 5. Przeglądanie logów systemowych integracji

Krok 6. Sprawdzenie danych w tabeli wymiany

Sprawdź zawartość tabeli wymiany po stronie SQL, aby potwierdzić obecność rekordów do pobrania oraz poprawność wartości parametrów.

Rysunek 6. Dane w tabeli wymiany - parametry pobierane

Krok 7. Weryfikacja aktualizacji statusu przetwarzania

Po wykonaniu cyklu integracji zweryfikuj, czy rekordy otrzymały oczekiwany status przetworzenia. To potwierdza, że mechanizm pobierania i potwierdzania działa poprawnie.

Rysunek 7. Dane w tabeli wymiany - parametry z aktualizacją statusu (po godzinie)

Dobre praktyki

Uruchamiaj integrację najpierw na ograniczonej próbce danych i dopiero potem zwiększaj zakres.
Loguj błędne rekordy tak, aby można było łatwo odtworzyć przyczynę odrzucenia.
Dla każdego mapowania utrzymuj jednoznaczną dokumentację kolumn SQL i odpowiadających im pól docelowych.
W przypadku wielu źródeł danych stosuj oddzielne mapowania i czytelne nazwy połączeń.

Howto powstało na bazie wersji systemu 2.0.0.0 (10.2025) oraz przedstawia funkcje, które mogą nie być dostępne w Twoim systemie. Zapytaj AMAGE o udostępnienie tej funkcjonalności.

Ze względu na ciągły rozwój systemu niektóre ekrany lub pliki konfiguracji mogą wyglądać nieznacznie inaczej, ale zachowają nadal pełną funkcjonalność tutaj opisaną. Nie wpływa to na zasadnicze funkcje opisywane w tym dokumencie.