Czy Subiekt GT wspiera integrację z Firebase?

Integracja Subiekt GT z Firebase jest możliwa pośrednio poprzez dedykowane narzędzia łączące API obu platform.

Brak bezpośredniego połączenia Subiekt GT z Firebase

Subiekt GT nie udostępnia standardowej, wbudowanej funkcji konfiguracji Firebase jako zewnętrznej bazy danych, magazynu dokumentów ani modułu synchronizacji. Oznacza to, że samo zainstalowanie Subiekta GT nie tworzy połączenia z usługami Firebase, takimi jak Cloud Firestore czy Realtime Database. Integracja jest możliwa pośrednio, gdy pomiędzy programem handlowym a usługą Firebase działa dodatkowa aplikacja, skrypt albo dedykowane narzędzie integracyjne.

Taki pośrednik musi odczytać dane z Subiekta GT za pomocą mechanizmu udostępnionego dla tego programu, przygotować je do wymaganego formatu, a następnie wysłać do odpowiedniej usługi Firebase przez jej interfejs programistyczny. W odwrotnym kierunku pośrednik pobiera dane z Firebase i przekazuje je do Subiekta GT zgodnie z regułami obsługiwanymi przez konkretną instalację oraz użyty moduł integracyjny. Firebase nie zastępuje w tym układzie programu sprzedażowego, a Subiekt GT nie staje się natywną bazą Firebase.

Rola Sfery i aplikacji pośredniczącej

W środowisku Subiekt GT dostęp do danych i operacji wykonywanych przez zewnętrzną aplikację może być realizowany przy użyciu Sfery dla Subiekta GT, jeżeli jest ona dostępna i właściwie skonfigurowana w danej instalacji. Sfera jest interfejsem programistycznym przeznaczonym do rozszerzania pracy z programami firmy InsERT. Konkretne możliwości zależą od posiadanych licencji, wersji oprogramowania, konfiguracji podmiotu oraz zakresu funkcji, które integrator chce wykorzystać.

Aplikacja pośrednicząca może na przykład pobierać wybrane informacje o towarach, kontrahentach lub dokumentach, mapować pola Subiekta GT na strukturę danych Firebase i zapisywać wynik w kolekcjach Firestore albo w strukturze Realtime Database. Przy imporcie trzeba wykonać operację odwrotną: sprawdzić dane wejściowe, dopasować identyfikatory, zweryfikować wymagane pola i dopiero wtedy utworzyć lub zmienić rekord w Subiekcie GT. Nie należy zakładać, że identyczna nazwa towaru, kontrahenta lub dokumentu wystarczy do bezpiecznego powiązania danych. Stabilna integracja powinna wykorzystywać jednoznaczne identyfikatory oraz rejestrować wynik każdej operacji.

Synchronizacja danych między Subiektem GT a usługami Firebase

Firebase udostępnia różne mechanizmy przechowywania i wymiany danych, dlatego projekt integracji powinien najpierw określić, która usługa jest potrzebna. Cloud Firestore przechowuje dane w dokumentach i kolekcjach, natomiast Realtime Database wykorzystuje strukturę drzewa danych synchronizowaną w czasie rzeczywistym. Wybór pomiędzy nimi wpływa na sposób modelowania danych, zapytania, reguły dostępu oraz działanie aplikacji korzystającej z zapisanych informacji.

Warstwa pośrednia może komunikować się z Firebase przez oficjalny Admin SDK albo przez interfejsy HTTP, zależnie od użytej technologii i sposobu wdrożenia. Konieczne jest również ustalenie kierunku synchronizacji. Eksport z Subiekta GT do Firebase może służyć aplikacji mobilnej, panelowi odczytowemu lub własnemu obiegowi informacji. Import z Firebase do Subiekta GT wymaga większej ostrożności, ponieważ dane mogą wpływać na towary, ceny, stany magazynowe, kontrahentów albo dokumenty handlowe. Należy zdefiniować, które źródło jest nadrzędne, jak rozpoznawane są zmiany oraz co dzieje się przy konflikcie, braku rekordu lub powtórzeniu tej samej operacji.

Co zweryfikować przed uruchomieniem integracji

Przed wdrożeniem należy sprawdzić, czy konkretna instalacja Subiekta GT ma wymagany interfejs programistyczny, odpowiednią licencję oraz dostęp do podmiotu, z którego będą pobierane dane. Po stronie Firebase trzeba określić używaną usługę, strukturę dokumentów lub rekordów, sposób uwierzytelniania aplikacji oraz reguły odczytu i zapisu. Dane dostępowe nie powinny być umieszczane bezpośrednio w kodzie aplikacji ani udostępniane użytkownikom końcowym.

Diagnostyka problemu z integracją powinna rozdzielać trzy obszary: komunikację z Subiektem GT, przetwarzanie danych w aplikacji pośredniej oraz komunikację z Firebase. Błąd połączenia z jednym systemem nie musi oznaczać awarii drugiego. Warto rejestrować identyfikator operacji, typ synchronizowanego obiektu, kierunek przepływu, wynik walidacji i odpowiedź interfejsu, bez zapisywania haseł oraz kluczy uwierzytelniających. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i podzespołów, a przy problemach z takim środowiskiem może pomóc ustalić, czy przyczyną jest komputer, lokalna konfiguracja programu czy działanie dodatkowego narzędzia integracyjnego.