HermesSQL

  1. Strona główna
  2. Docs
  3. HermesSQL
  4. Środowisko rozszerzeń SQL
  5. Broker

Broker

Wydrukuj dokument

Broker jest faktycznie Hermesem pracującym w trybie zdalnego sterowania. To, co może zrobić operator jest ograniczone tylko do jednego formularza obsługującego m.in. wprowadzanie parametrów potrzebnych do komunikacji z systemem wewnętrznym, zatrzymywanie i wznawianie nasłuchu, oglądanie logów. Obsługa Hermesa, m.in. dodawanie i edycja niektórych dokumentów, uzyskiwanie danych, odbywa się za pomocą poleceń w języku XML, które Hermes otrzymuje od aplikacji zewnętrznej, z którą się komunikuje. Aplikację tę będziemy dalej nazywać klientem. Opis tych poleceń dostępny jest z poziomu Hermesa (Administracja -> Przegląd poleceń Brokera). Efekt wykonania polecenia i ewentualne informacje o błędach odsyłane są również w formacie XML.
Ponieważ Broker jest faktycznie Hermesem obsługującym otrzymywane polecenia, sekwencja otrzymywania niektórych poleceń nie może być dowolna. Oczywiście można pobrać dane artykułów, kontrahentów lub inne w dowolnej kolejności, ale np. dodanie dokumentu wymaga wysłania kolejno poleceń dodania nagłówka dokumentu, potem pozycji a na końcu polecenia zamykającego dokument (tak jak w Hermesie niemożliwa jest jednoczesna edycja dwóch dokumentów). Oczywiście pomiędzy tymi poleceniami mogą się pojawić inne, nie zaburzające sekwencji dodawania dokumentu (np. pobranie danych artykułu), ale już np. odebranie polecenia dodania kolejnego dokumentu przed zamknięciem właśnie dodawanego skończy się informacją o błędzie wysłaną do klienta.
Tak jak Hermes nie pracuje bez zalogowanego operatora do określonej firmy, tak samo Broker potrzebuje informacji o operatorze i firmie. Można je podać jako parametry podczas uruchamiania programu, klient może też mieć własny mechanizm logowania, wykorzystujący odpowiednie polecenia Brokera.
Do komunikacji z klientami wykorzystywany jest mechanizm gniazd (socket). Umożliwia on otwarcie kanału komunikacyjnego pomiędzy Brokerem a klientem. Każde gniazdo posiada adres IP oraz numer portu. Broker nasłuchuje, czy na porcie pojawia się kolejne polecenie od klienta. Jeżeli tak, interpretuje je i wykonuje, a wyniki odsyła, korzystając z informacji o adresie IP i numerze portu, na którym nasłuchuje klient.
Lista poleceń, jakie możemy wysyłać do Brokera jest z dnia na dzień rozszerzana, co z każdą chwilą coraz bardziej zwiększa możliwości integracji z innymi systemami.
Aby lepiej wyobrazić sobie funkcje jaką pełni broker, możemy go przyrównać do wirtualnego pracownika który np.: przyjmuje zamówienia z portalu B2B i wprowadza je do programu Hermes SQL.

Poniżej znajduje się schemat blokowy użycia brokera, który może pomóc zrozumieć czym jest broker.

Należy pamiętać ze wykorzystanie modułu brokera, czyli mechanizmu umożliwiającego dostęp do informacji programu Hermes SQL w zakresie pobierania i zapisywania informacji w systemie zgodnie z jego logiką przy wykorzystaniu wbudowanych funkcji m.in tworzenia dokumentów, pobierania informacji o asortymencie, kontrahentach itp. jest obecnie najbardziej wskazaną i najbezpieczniejszą z punktu widzenia spójności danych metodą integracji.

Broker jako pośrednik umożliwiający komunikację, pomiędzy Hermesem SQL a innymi aplikacjami umieszczonymi w strukturze rozproszonej wykorzystywany jest do działania takich aplikacji  Humansoft jak Portal pracowniczy, B2B, aplikacje mobilne. W celu uruchomienia brokera, poza samym modułem wymagana jest  jedna stacja kliencka.
Moduł jest stale rozwijany o kolejne funkcje, w zależności od potrzeb jakie się pojawią zarówno od klientów i od partnerów.

8.1. Wywołanie brokera

Wywołanie brokera:
“<<sciezka do pliku exe>>hermes_sql.exe” “<<symbol firmy>>” “<<symbol operatora>>” “<<hasło>>” “<<stacja>>” <<czy broker>> “<<IP klienta brokera>>” <<port klienta brokera>>” “<<powiadomienia>>” “<<IP brokera>>” “<<port brokera>>” “<<podtrzymanie połączenia>>” “<<szyfrowanie SSL>>” “<<echo>>” “<<log>>”

Przykład:

  • Wywołanie brokera należy napisać w notatniku a następnie zapisać z rozszerzeniem *.BAT, np. Wywołanie_brokera.bat.
  • Tylko w przypadku systemowego operatora SZEF należy poprzedzić symbol podkreśleniem „_” → ”_SZEF”. W każdym innym operatorze stworzonym przez użytkownika, podkreślenia nie stosujemy np. ABC.
  • Jeśli chcemy, żeby broker łączył się nie tylko z jednym klientem, zamiast IP klienta i Port klienta, należy wstawić symbol # za każde z nich.
  • Adres IP brokera ma sens tylko w przypadku komputerów z wieloma kartami sieciowymi, pozwala wymusić komunikację przez jedną z nich.
  • W przypadku braku hasła do konta operatora należy zamiast hasła wstawić symbol #. Jednak zalecamy stosowanie hasła.
  • *Cztery ostatnie cyfry to informacja czy dany checkbox ma być zaznaczony; 0 = nie zaznaczony, 1 = zaznaczony. Cyfry oznaczają kolejno (od lewej): Podtrzymywanie połączenia, SSL, Echo, Rejestracja logu

8.2. Polecenia brokera

Polecenia brokera można przejrzeć z poziomu systemu w menu Admin -> Przegląd dostępnych Poleceń brokera.