Opis komunikacji na potrzeby integracji z systemem klienta (12 kwiecień, 2007)

Opis komunikacji na potrzeby integracji z systemem klienta (12 kwiecień, 2007) Copyright 2004 Anica System S.A., Lublin, Poland

Poniższy dokument, jak również informacje w nim zawarte są całkowitą własnością firmy Anica System S.A.. Zawarte tu pomysły, procedury, opisy procesów, koncepcje, bez względu na formę przedstawienia stanowią tajemnicę handlową firmy Anica System S.A. Wszystkie elementy wymienione powyżej są prawnie chronione, dlatego też wszelkie prawa, w szczególności prawo do kopiowania i rozpowszechniania jak również prawo do tłumaczenia niniejszej pracy są zastrzeżone. Opracowanie, skład i produkcja: Anica System S.A., ul. Bartosza Głowackiego 13, Lublin, Poland Copyright 2004 Anica System S.A., Lublin, Poland wersja dokumentu kwiecień 2007

Spis treści Wstęp... 4 1. Opis techniczny... 4 1.1. Definicja pojęć... 4 1.2. Modele komunikacji systemu... 4 1.3. Opis komunikacji... 5 1.3.1. Punkt styku aplikacji klienta... 5 1.3.2. Funkcje aplikacji klienta... 6 1.3.3. Kontrola gotowości danych do przesłania... 6 2. Aplikacja klienta EBI Connector Client... 7 2.1. Wymagania klienta... 7 2.2. Procedura instalacji... 7 2.3. Czynności poinstalacyjne... 10 3

4 WSTĘP Dokument zawiera opis mechanizmów komunikacyjnych i transmisji danych na potrzeby intregracji systemu EBI i systemu centralnego u klienta. 1. OPIS TECHNICZNY 1.1. Definicja pojęć Serwer element systemu komunikacyjnego znajdujący się po stronie systemu EBI. Klient element systemu komunikacyjnego znajdujący się po stronie systemu dystrybutora. EBICC aplikacja EBI Connector Client realizująca funkcje transmisji danych. Punkt styku jest fizycznym miejscem przeznaczenia określonej informacji, w którym kończy się zakres działania systemu EBICC lub klienta usługi ftp. 1.2. Modele komunikacji systemu Możliwe są trzy sposoby komunikacji: 1. Komunikacja dwukierunkowa klient-serwer (klient EBICC) Wymiana danych realizowana jest przy pomocy klienta EBI Connector Client. 1.1. połączenie inicjowane jest przez stronę klienta, 1.2. wymiana komunikatów może być dwukierunkowa, wielomagazynowa, 1.3. wymaga posiadania stałego połączenia do sieci Internet. 2. Komunikacja dwukierunkowa klient-serwer (z użyciem protokołu ftp/tls) Komunikacja do Klienta jest zestawiona z użyciem własnych mechanizmów używających protokołu ftp. 2.1. połączenie jest zawsze inicjowane od strony systemu klienta, 2.2. klient we własnym zakresie zapewnia oprogramowanie do zestawienia wymiany komunikatów zapewniające bezpieczną komunikację i integralność danych, 2.3. wymaga posiadania stałego połączenia do sieci Internet. EBICC_Komunikacja_2007-04-10 2004 Anica System S.A.

5 3. Komunikacja dwukierunkowa serwer-klient (z użyciem protokołu ftp/tls) Wymiana danych realizowana jest przy pomocy protokołu ftp/tls do serwera ftp znajdującego się w siedzibie klienta. 3.1. połączenie jest zawsze inicjowane od strony serwera, 3.2. wymaga posiadania statycznego adresu IP po stronie Klienta, 3.3. pożądane jest, aby serwer ftp umożliwiał szyfrowanie sesji. 1.3. Opis komunikacji Na potrzeby komunikacji Anica System S.A. może dostarczyć aplikację EBI Connector Client, realizującą wszystkie funkcje związane z transmisją danych pomiędzy serwerem a klientem. Aplikacja ma możliwość obsłużenia modelu komunikacji, opisanego w punkcie 1. Model opisany w punkcie 2 wymaga zastosowania własnego rozwiązania opracowanego przez klienta. Model opisany w punkcie 3 realizowany jest przez aplikacje działające po stronie Anica System S.A., wymaga działającego serwera ftp po stronie klienta. 1.3.1. Punkt styku aplikacji klienta Punktem styku dla aplikacji klienta jest określona struktura katalogów na dysku lokalnym. Istnieje możliwość zdefiniowania innych punktów styku niż przedstawiona w przykładzie, w przypadku określonych wymagań ze strony systemu klienta. Opis punktu styku musi być zgłoszony do osoby reprezentującej Anica System S.A. w celu poprawnej konfiguracji klienta. Wymaganą strukturę katalogów po stronie systemu klienta definiuje poniższy schemat. Ilość podkatalogów dla magazynów należy dostosować do ilości magazynów (oddziałów) klienta, które będą obsługiwane przez system (w przypadku tylko jednego magazynu powinien być jeden podkatalog): KATALOG GŁÓWNY magazyn1 export import recv sent magazyn2 export import recv sent Przeznaczenie poszczególnych katalogów: import pliki otrzymane z systemu EBI do pobrania przez system magazynowy export pliki otrzymane z systemu magazynowego do pobrania przez aplikację klienta

6 i przetransmitowania do systemu EBI sent pliki historyczne pobrane przez aplikację klienta i przetransmitowane do systemu EBI recv pliki historyczne otrzymane z systemu EBI i pobrane przez system magazynowy Zarządzanie plikami przez system magazynowy Pliki pobrane przez system magazynowy z katalogu import powinny być automatycznie przenoszone (przez interfejs systemu magazynowego) do katalogu recv. 1.3.2. Funkcje aplikacji klienta Działanie aplikacji klienta polega na: 1. pobraniu danych (plików) z określonego punktu styku po stronie systemu klienta i przetransmitowanie ich do systemu EBI, 2. odebranie danych (plików) z systemu EBI i zapisanie ich do punktu styku po stronie klienta, 3. zapewnienie poufności i integralności transmitowanych komunikatów, 4. monitorowaniu i logowaniu wszelkich obsługiwanych transakcji. 1.3.3. Kontrola gotowości danych do przesłania W celu wyeliminowania możliwości pobrania (przez aplikację klienta EBICC lub interfejs do systemu magazynowego) niepełnych danych, po stronie aplikacji eksportującej dane do EBI powinna być stosowana następująca procedura: zapisywanie plików do katalogu export pod nazwą tymczasową, najlepiej wg. schematu: <nazwa_pliku_docelowego>.tmp, np.: plik tymczasowy: 09000001.zam.tmp plik docelowy: 09000001.zam, a po pomyślnym zapisaniu pliku zmieniana jest jego nazwa z tymczasowej na docelową lub zapisywanie plików w katalogu tymczasowym na tym samym dysku co punkt styku (struktura) W przypadku braku możliwości zastosowania powyższego schematu, możliwe jest również zastosowanie weryfikacji poprawności zapisu danych przez zastosowanie mechanizmu plików kontrolnych. W tym przypadku każdy zapisany w katalogu plik powinien być dodatkowo potwierdzony zapisaniem w tym samym katalogu pliku kontrolnego, zbudowanego wg schematu: <nazwa_pliku_glownego>.ok, przy czym człon nazwa_pliku_glownego może stanowić całą nazwę pliku włącznie z rozszerzeniem lub bez rozszerzenia, np.: plik główny: 09000001.zam plik potwierdzenia: 09000001.zam.ok lub plik główny: 09000001.zam plik potwierdzenia: 09000001.ok EBICC_Komunikacja_2007-04-10 2004 Anica System S.A.

7 2. APLIKACJA KLIENTA EBI CONNECTOR CLIENT Klient EBICC jest aplikacją realizującą wszystkie funkcje związane z transmisją danych pomiędzy serwerem a systemem klienta, dostarczaną przez Anica System. 2.1. Wymagania klienta W celu uruchomienia aplikacji wymagane jest: system operacyjny Windows 98/2000/NT/XP, Linux, Solaris, inne Java Virutal Machine w wersji co najmniej 1.5 komputer klasy Pentium 166MHz lub szybszy minimum 64 MB RAM (nie dotyczy pamięci wykorzystywanej przez system operacyjny i inne aplikacje) 9 MB wolnego miejsca na dysku twardym (nie dotyczy miejsca wykorzystywanego na wymianę danych oraz JVM) środowisko graficzne możliwość nawiązywania połączeń do serwera (adres: clients.connector.ebi.pl) na porcie 443 bezpośrednio lub przez serwer proxy. 2.2. Procedura instalacji Klient EBI Connector jest dostarczany w postaci natywnego, graficznego instalatora dla MS Windows, wykonywalnego archiwum Java dla MS Windows i Linux lub archiwum zip w przypadku nieautomatycznej instalacji. 2.4.2.1 Instalator natywny MS Windows 98 Instalator przeznaczony dla systemu MS Windows 98 instaluje klienta jako samodzielną aplikację. Sterowanie aplikacją jest możliwe przy pomocy ikony w zasobniku systemowym (Systray) lub przy pomocy konsoli programu. 2.4.2.2 Instalator natywny MS Windows 2000/2003/XP Instalator przeznaczony dla systemu MS Windows 2000/2003/XP instaluje klienta jako usługę systemową, sterowanie aplikacją może odbywać się przy pomocy narzędzi systemu operacyjnego lub konsoli programu. 2.4.2.3 Instalator w postaci wykonywalnego archiwum Java dla MS Windows, Linux Uruchomienie wykonywalnego archiwum Java spowoduje uruchomienie graficznego instalatora wspólnego dla wszystkich systemów.

8 Czynności instalacyjne: 1. Uruchomienie instalatora Uruchomienie instalatora spowoduje otwarcie powitalnego okna: 2. Parametry logowania Kolejne okno pozwala wprowadzić dane autentykacyjne uzyskane od Anica Syatem S.A. EBICC_Komunikacja_2007-04-10 2004 Anica System S.A.

9 3. Okno wyboru pakietów Po wprowadzeniu danych autentykacyjnych należy zaakceptować listę niezbędnych pakietów 4. Okno wyboru ścieżki instalacji 5. Umieszczenie skrótów do programu 6. Zakończenie instalacji

10 Po zamknięciu okna informacującego o zakończeniu instalacji, należy wykonać czynnosci poinstalacyjne. 2.3. Czynności poinstalacyjne Po zakończeniu instalacji klienta EBICC, należy: 1. sprawdzić, czy usługi systemowe działają, 2. sprawdzić, czy uprawnienia użytkownika na którym działają usługi pozwalają na operacje, na plikach w strukturze punktu styku, 3. przekazać osobom prowadzącym wdrożenie dane dotyczące punktu styku i stosowania plików potwierdzeń. Konfiguracja klienta przeprowadzona zostanie zdalnie. EBICC_Komunikacja_2007-04-10 2004 Anica System S.A.

11 Copyright 2004 Anica System S.A., Lublin, Poland