Broker jest faktycznie systemem 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” systemu, m.in. dodawanie i edycja niektórych dokumentów, uzyskiwanie danych, odbywa się za pomocą poleceń w języku XML, które system 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 systemu (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 systemem 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 Coraxie 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 Corax 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 Corax.
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 Corax 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 coraxem 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.
5.1. Wywołanie brokera
Wywołanie brokera:
“<<sciezka do pliku exe>>corax.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
5.2. Polecenia brokera
Polecenia brokera można przejrzeć z poziomu systemu w menu Admin -> Przegląd dostępnych Poleceń brokera.