Od Sfery COM do REST API: Ewolucja Integracji z Subiektem
Integracja autorskich aplikacji z systemami Subiekt GT oraz Subiekt nexo PRO przez lata kojarzyła się deweloperom z koniecznością operowania w zamkniętym środowisku Windows oraz utrzymywaniem długu technologicznego.
Oficjalne interfejsy programistyczne dostarczane przez producenta – Sfera dla Subiekta GT (oparta na architekturze COM/OLE) oraz Sfera dla nexo PRO (wymagająca dedykowanych zestawów SDK w .NET) – narzucają surowe ograniczenia technologiczne. Uniemożliwiają one natywną komunikację z nowoczesnymi mikrousługami pisanymi w Node.js, Pythonie, Go czy PHP i uruchamianymi w kontenerach Docker na serwerach Linux.
Wprowadzenie warstwy pośredniczącej SubiektBridge zmienia ten paradygmat, przekształcając monolityczną logikę Sfery w eleganckie, szyfrowane REST API Subiekt GT nexo ze specyfikacją OpenAPI 3.0.
Porównanie architektoniczne: Sfera Native vs. SubiektBridge REST API
| Cecha / Parametr | Natywna Sfera (COM / nexo SDK) | SubiektBridge (REST API + OpenAPI) |
| Sposób wywołania | Bezpośrednie obiekty dwójkowe w C# / C++ | Zapytania HTTP REST z payloadem JSON |
| System operacyjny | Wyłącznie Windows Server / Windows 10/11 | Dowolny (Linux, macOS, Docker, Serverless) |
| Język programowania | Ograniczony do C#, C++, VB.NET | Dowolny (Node.js, Python, PHP, Go, Ruby, Dart) |
| Dokumentacja API | Pliki pomocy CHM, dokumenty PDF | Interaktywna specyfikacja Swagger UI / OpenAPI |
| Generowanie SDK | Ręczne mapowanie obiektów biznesowych | Automatyczne (OpenAPI Generator CLI) |
| Obsługa błędów | Wyjątki COM, kody HRESULT | Standardowe kody HTTP (200, 400, 401, 500) + JSON |
Jak SubiektBridge automatyzuje pracę ze Sferą?
Usługa SubiektBridge instalowana jest w sieci lokalnej jako lekka usługa tła (.NET 8). Zarządza ona cyklem życia obiektów Sfery, zapobiega wyciekom pamięci operacyjnej i pośredniczy w bezpiecznym zapisie danych do bazy MS SQL.
Korzyści dla zespołów programistycznych:
- Generowanie kodu w kilka sekund: Dzięki zgodności ze standardem OpenAPI 3.0, deweloperzy mogą jednym poleceniem w CLI wygenerować kompletnego klienta API dla swojego projektu.
- Testowanie bez uruchamiania środowiska ERP: Dostęp do wbudowanego panelu Swagger UI pozwala sprawdzać strukturę zapytań i odpowiedzi bezpośrednio w przeglądarce internetowej.
- Jednolita warstwa danych: Zapytanie o dodanie zamówienia czy odczyt stanu magazynowego wygląda identycznie niezależnie od tego, czy pod spodem pracuje Subiekt GT, czy Subiekt nexo PRO.
Najczęściej zadawane pytania (FAQ)
Czy korzystanie z SubiektBridge wyklucza wymóg posiadania licencji Sfery?
Nie. SubiektBridge wykonuje wszystkie operacje modyfikacji bazy danych za pośrednictwem oficjalnego modułu Sfera dla Subiekt GT lub Sfera dla nexo PRO. Gwarantuje to pełną spójność relacyjną danych oraz zachowanie gwarancji producenta.
Czy REST API umożliwia pobieranie gotowych wydruków dokumentów?
Tak. API udostępnia dedykowane punkty końcowe generujące faktury sprzedaży oraz wydruki magazynowe w postaci strumienia plików PDF lub ciągu znaków zakodowanego w formacie Base64.