Studio TCS.net jest zbudowany w architekturze zorientowanej na usługi (SOA): interfejs, logika biznesowa i baza danych to osobne warstwy, a moduły i systemy zewnętrzne komunikują się z nimi przez REST API. Ten artykuł opisuje warstwy systemu, zasady działania API, jego zabezpieczenia i typowe scenariusze integracji.
Schemat na górze strony pokazuje centralną bazę Microsoft SQL Server, warstwę REST API i klientów, którzy z niej korzystają: aplikację webową w przeglądarce, terminale i smartfony z Androidem oraz systemy ERP i CRM. Cała komunikacja między klientami a API odbywa się po HTTPS.
Warstwy systemu i technologie
| Warstwa | Technologia | Rola |
|---|---|---|
| Interfejs webowy | Vue.js 3, aplikacja jednostronicowa (SPA) | Praca w przeglądarce bez instalacji |
| Aplikacja mobilna | Android, praca także bez zasięgu | Skanowanie kodów i RFID w magazynie i w terenie |
| Usługi i logika biznesowa | Microsoft .NET 8 LTS (planowana migracja do .NET 10), serwer IIS | Reguły systemu i REST API dla klientów i integracji |
| Dane | Microsoft SQL Server | Transakcyjne przechowywanie kartotek, dokumentów i historii |
Aktualność stosu i cykl wsparcia wersji .NET opisuje artykuł o końcu wsparcia .NET 8 i migracji do .NET 10.
Co daje architektura SOA
W architekturze SOA interfejs użytkownika nie łączy się bezpośrednio z bazą danych. Wszystkie operacje - wydanie narzędzia, zgłoszenie awarii, import kartotek - przechodzą przez usługi, które sprawdzają uprawnienia i reguły biznesowe. Z tego wynikają trzy praktyczne skutki:
- Te same reguły dla każdego klienta - wydanie z przeglądarki, z terminala i z systemu zewnętrznego przechodzi tę samą kontrolę, np. blokadę narzędzia po terminie kalibracji.
- Rozbudowa modułami - narzędziownia, magazyn BHP, CMMS czy analiza AI korzystają z jednej bazy i wspólnych słowników, a nowy moduł dochodzi bez przebudowy działających.
- Integracje bez dostępu do bazy - systemy zewnętrzne wymieniają dane przez API, a nie przez bezpośrednie zapytania do tabel, więc zmiana struktury bazy nie psuje integracji.
REST API w praktyce
REST API Studio TCS.net wymienia dane w formacie JSON po HTTPS. Obsługuje standardowe metody HTTP: GET do odczytu, POST do tworzenia, PUT do aktualizacji i DELETE do usuwania, więc integrację można napisać w dowolnym języku programowania. Przez API przechodzą m.in.:
- kartoteki narzędzi, części i środków ochrony z ERP,
- pracownicy, stanowiska i MPK z systemu kadrowo-płacowego,
- stany magazynowe i dokumenty operacji,
- zgłoszenia awarii i zlecenia z modułu CMMS.
Menu importu kartotek łączy dwa sposoby zasilania bazy: jednorazowy import z plików CSV i XLS oraz stałą wymianę przez API z systemami ERP, np. SAP, Comarch czy Microsoft Dynamics. Import z pliku sprawdza się przy starcie systemu, a API - gdy dane mają być aktualne na bieżąco.
Bezpieczeństwo integracji
- Szyfrowanie - wszystkie połączenia z API są szyfrowane protokołem TLS (HTTPS).
- Tokeny - każda integracja ma własny profil i token uwierzytelniający generowany przez administratora.
- Uprawnienia klucza - token ma dostęp tylko do punktów końcowych i operacji przypisanych do profilu integracji.
- Logowanie użytkowników - konta mogą korzystać z Active Directory lub Azure AD w trybie Single Sign-On.
- Ślad operacji - operacje wykonane przez integrację są zapisywane w historii tak samo jak operacje użytkowników.
Typowe scenariusze integracji
| System | Kierunek | Dane |
|---|---|---|
| ERP (SAP, Comarch, Microsoft Dynamics) | ERP → TCS.net i z powrotem | Kartoteki, ceny, dostawcy, MPK, koszty zużycia |
| System kadrowo-płacowy | Kadry → TCS.net | Pracownicy, stanowiska, zatrudnienie i zwolnienia |
| WMS, WCS, automaty wydawcze | Dwukierunkowo | Wydania, zwroty, stany urządzeń wydawczych |
| MES | MES → TCS.net | Zlecenia produkcyjne powiązane z wydaniem narzędzi |
Przykłady konkretnych połączeń opisują artykuły o integracji z SAP, ERP i WCS, o integracji z WAPRO ERP oraz o ewidencji narzędzi z RFID i integracji SAP.
Baza danych Microsoft SQL Server
Wszystkie moduły korzystają z jednej relacyjnej bazy Microsoft SQL Server. Transakcje gwarantują, że dokument zapisuje się w całości albo wcale, indeksy przyspieszają wyszukiwanie w dużych kartotekach, a kopie zapasowe wykonuje się bez zatrzymywania pracy. W modelu SaaS bazę utrzymuje SoftwareStudio, a przy instalacji na serwerze firmy potrzebna jest licencja SQL Server. Szczegóły opisuje artykuł o bazie danych SQL Server w narzędziowni.
Jak zintegrować zewnętrzny system ERP z REST API TCS.net
Poradnik techniczny opisujący proces konfiguracji i bezpiecznego połączenia zewnętrznego oprogramowania z interfejsem REST API systemu Studio TCS.net.
Co jest potrzebne
- Panel zarządzania integracjami Studio TCS.net
- Środowisko testowe zewnętrznej aplikacji lub systemu ERP
- Certyfikat HTTPS i dostęp do konfiguracji sieciowej
-
Generowanie kluczy dostępu i tokenów autoryzacyjnych
Administrator systemu loguje się do panelu zarządzania Studio TCS.net, tworzy nowy profil integracji i generuje unikalne tokeny uwierzytelniające dla zewnętrznej aplikacji.
-
Konfiguracja bezpiecznego połączenia HTTPS
Ustawienie parametrów sieciowych w systemie integrowanym, w tym wskazanie adresu docelowego punktu końcowego API oraz implementacja nagłówków autoryzacyjnych z wykorzystaniem protokołu HTTPS.
-
Mapowanie pól danych i testy przesyłania komunikatów JSON
Przeprowadzenie testowych zapytań metodą GET oraz POST w celu weryfikacji poprawności mapowania kartotek towarowych, struktur JSON oraz obsługi kodów odpowiedzi serwera.
-
Uruchomienie synchronizacji produkcyjnej
Włączenie automatycznych harmonogramów wymiany danych w trybie produkcyjnym oraz aktywacja monitoringu logów błędów interfejsu API.
Pełne zestawienie parametrów technicznych i integracji zawiera specyfikacja techniczna.