DOKUMENTACJA TECHNICZNA KAMSOFT S.A. 40-235 Katowice ul. 1-Maja 133 Tel. (032) 2090705, Fax. (032) 2090715 http://www.kamsoft.pl, e-mail: 5420@kamsoft.pl SYSTEM INFORMATYCZNY NR KATALOGOWY 2334PI06.00 WYDANIE 2015.00.0.0 Katowice, 2015 r. Strona 1 z 20
DOKUMENTACJA TECHNICZNA SPIS ZAWARTOŚCI 1. Komunikacja z aptekami... 3 1.1. Generowanie ofert... 3 2. Komunikacja z KAMSOFT... 5 2.1. Pobieranie i aktualizacja bazy BLOZ dla wersji 2014.02.x.x lub nowszej.... 7 2.1.1. Weryfikacja poprawności przyjęcia bazy BLOZ.... 12 2.2. Pobieranie i aktualizacja bazy BLOZ dla wersji 2014.01.x.x lub starszej.... 13 2.2.1 Weryfikacja poprawności przyjęcia bazy BLOZ.... 18 2.3. Pobieranie i aktualizacja komunikatów GIF i BLUR... 18 Strona 2 z 20
DOKUMENTACJA TECHNICZNA W poniższym dokumencie opisana została funkcjonalności i jej konfiguracja w zakresie współpracy z systemem hurtowym KAMSOFT KS-HFW. 1. KOMUNIKACJA Z APTEKAMI W rozdziale tym opisano konfigurację funkcjonalności po stronie systemu dotyczącą usług przeznaczonych głównie dla aptek. 1.1. Generowanie ofert Obecnie proces generowania ofert został zdefiniowany jako dwa zadania harmonogramowe w systemie. W celu uruchomienia generowania ofert należy wybrać zakładkę Zadania. Zakładka Zadania umożliwia uruchomienie zadań harmonogramowych w systemie KS-JOBS z poziomu Administratora WWW Przycisk Dodaj umożliwia dodanie do listy zadań nowego zadania. Przykładowe okna, w którym możemy zdefiniować Generowanie ofert indywidualnych oraz Generowanie ofert ogólnych, wyglądają tak: Okna umożliwiają konfigurację harmonogramu zgodnie w własnymi preferencjami. Po dokonaniu odpowiednich ustawień oraz zaznaczeniu opcji jako Aktywne generowanie ofert będzie się odbywać zgodnie z preferencjami. Strona 3 z 20
DOKUMENTACJA TECHNICZNA W celu poprawnej obsługi generowania ofert należy jeszcze w opcji DST_DEF_DESTINATION dla zlecenia RECV_OFT jako wartość zdefiniować KSHOST: Tak skonfigurowane zadania będą zapisywać pliki ofert do katalogu elektronicznej wymiany danych zdefiniowanym w opcji DST_HST_DIR. Szczegółowe ścieżki zapisu dla ofert indywidualnych i ogólnej znajduje się odpowiednio w opcjach DST_HST_OFR_DIR oraz DST_HST_OFR_CMN_DIR. Dodatkowo istnieje możliwość skonfigurowania powiadomień e-mail informujących o stanie wykonania poszczególnych zleceń. Aby uruchomić taką funkcjonalność należy skonfigurować poniższe opcje: DST_EMAIL_FROM - Adres e-mail, który będzie ustawiany jako adres wysyłającego e-mail DST_EMAIL_SMTP_PASS - Hasło do autoryzacji na serwerze SMTP DST_EMAIL_SMTP_URL - Adres serwera SMTP, z którego będą wysyłanie wiadomości e-mail DST_EMAIL_SMTP_USER - Użytkownik do autoryzacji na serwerze SMTP ALT_EMAIL_TO - Adres e-mail, na który mają zostać przesyłane powiadomienia. W przypadku zdefiniowania kilku adresów, jako separator na należy stosować średnik TSK_ALERT_SEND - Określa, czy wysłać alert po błędnym wykonaniu zlecenia (TAK/NIE) należy ustawić w kontekście konkretnego zlecenia np. RECV_OFT TSK_INFO_SEND - Określa, czy wysłać powiadomienie po poprawnym wykonaniu zlecenia (TAK/NIE) należy ustawić w kontekście konkretnego zlecenia np. RECV_OFT. Pozostałe opcje dotyczące ustawień generowania ofert są dostępne w kategorii Usługi KS-HFW : UWAGA Opcję w kategorii Usługi KS-HFW posiadają wartości domyślne pozwalające na generowanie ofert zgodnie z aktualnymi ustawieniami w systemie KS-HFW. Strona 4 z 20
DOKUMENTACJA TECHNICZNA 2. KOMUNIKACJA Z KAMSOFT W rozdziale tym opisano konfigurację funkcjonalności po stronie systemu dotyczącą usług wymagającej komunikacji z KAMSOFT. W celu zapewnienia poprawnej konfiguracji komunikacji z KAMSOFT należy zdefiniować widok: CREATE OR REPLACE VIEW V_JOB_KAM ( NWBR ) AS select '000002' NWBR from dual / gdzie '000002' jest przykładowym NWBR kontrahenta KAMSOFT Następnie w opcji SRC_JOB_NWBR_VIEW należy dla zleceń SEND_RQST_BLZ, SEND_RQST_GIF oraz SEND_RQST_BLR wskazać wartość V_JOB_KAM: Strona 5 z 20
DOKUMENTACJA TECHNICZNA Następnie w zakładce Kartoteki należy założyć kontrahenta o NWBR zgodnym z widokiem V_JOB_KAM (w tym przypadku 000002) jak przedstawiono na poniższym rysunku: Strona 6 z 20
DOKUMENTACJA TECHNICZNA 2.1. Pobieranie i aktualizacja bazy BLOZ dla wersji 2014.02.x.x lub nowszej. DO URUCHOMIENIA TEJ METODY WYMAGANA JEST SYSTEM KS-HFW W WERSJI CO NAJMNIEJ 2014.09.0.0. Obecnie proces pobierania i aktualizacji bazy BLOZ został zdefiniowany jako zadanie harmonogramowe z systemie. W celu uruchomienia generowania ofert należy wybrać zakładkę Zadania. Przy pomocy przycisku Dodaj wybieramy zadanie Aktualizacja BLOZ. Spowoduje to otwarcie okna umożliwiającego konfigurację harmonogramu zgodnie w własnymi preferencjami: Po dokonaniu odpowiednich ustawień oraz zaznaczeniu opcji jako Aktywne pobierania i aktualizacji bazy BLOZ będzie się odbywać zgodnie z preferencjami. W celu poprawnej obsługi aktualizacji bazy BLOZ należy jeszcze: Włączyć zadanie archiwizacji raz dziennie w nocy. Strona 7 z 20
DOKUMENTACJA TECHNICZNA Ustawić wartość opcji SRC_DEL_FILES_AFTER_FINISH na TAK Ustawić opcję TSK_DEL_FILES_AFTER_FINISH dla zlecenia RECV_BLZ na TAK Strona 8 z 20
DOKUMENTACJA TECHNICZNA W opcji DST_DEF_DESTINATION dla zlecenia SEND_RQST_BLZ jako wartość zdefiniować OSOZWS. W tej samej opcji DST_DEF_DESTINATION dla innego zlecenia RECV_BLZ jako wartość zdefiniować KSHRT. Strona 9 z 20
DOKUMENTACJA TECHNICZNA W opcji DST_PKE_PASS ustawić hasło. W polu wartość wpisujemy hasło do inauguracji. W opcji DST_OSOZ_SERVICE_URL dla zlecenia SEND_RQST_BLZ jako wartość wpisać adres https://www.osoz.pl/ws-broker-server-bloz/services/servicebrokeranonymous Dla zleceń SEND_RQST_BLZ oraz RECV_BLZ proszę ustawić opcję TSK_WAIT_TIME na wartość 7200. Strona 10 z 20
DOKUMENTACJA TECHNICZNA UWAGA Jeśli podczas pobierania lub aktualizacji bazy BLOZ, w zleceniu RECV_BLZ wystąpi błąd typu Out Of Memory należy zmienić ilość przydzielonej pamięci. Dokonujemy tego poprzez edycję pliku Catalina (C:\KS\Tomcat\4.1.x\bin\Catalina.bat) modyfikując wartość parametru Xmx na wartość 1400m (-Xmx 1400m ). JEŚLI SYSTEM KORZYSTA Z WERSJI XE BAZY DANYCH ORACLE, NALEŻY DODATKWO USTAWIĆ DWIE OPCJE: Opcję ARCH_DELETE_ROWS na TAK Opcja określa, czy proces archiwizacji wierszy z tabel ma je przenosić do archiwum, czy też usuwać. Domyślną wartością tej opcji jest NIE. Wprowadzenie wartości TAK dla tej opcji spowoduje, iż proces archiwizacji, zamiast przenosić wpisy z tabel głównych do tabel przechowujących wpisy archiwalne, spowoduje ich usunięcie. Strona 11 z 20
DOKUMENTACJA TECHNICZNA Opcję ARCH_VALIDITY na wartość 14 lub 7. Opcja określająca, po jakim czasie, wpisy z tabeli zleceń, mają zostać przeniesione do archiwum. Wartość tej opcji należy podawać w dniach. Wartością domyślną jest liczba 30 co powoduje, iż po uruchomieniu zadania archiwizacji wszystkie starsze (niż 30 dni) rekordy tabeli zostaną przeniesione do archiwum. Jeśli system korzysta z wersji XE bazy danych Oracle zaleca się ustawić 14 lub 7 dni. 2.1.1. Weryfikacja poprawności przyjęcia bazy BLOZ. W celu zweryfikowania poprawności przyjęcia bazy BLOZ należy uruchomić zadanie Aktualizacja BLOZ. W tym celu wchodzimy w zadania i klikamy ikonkę Uruchom teraz. Następnie po uruchomieniu zadania Aktualizacja BLOZ przechodzimy do zakładki Zlecenia. W zakładce tej oba typy zleceń SEND_RQST_BLZ oraz następujące po nim RECV_BLZ powinno zakończy się powodzeniem co symbolizuje symbol w kolumnie Status. Dodatkowo, na liście dla zleceń SEND_RQST_BLZ oraz RECV_BLZ można kliknąć na ikonę lupki w kolumnie Akcja i tym samym przejść do szczegółów zlecenia, dodatkowo weryfikując czy nie pojawił się żaden błąd bezpośrednio w logach konkretnego zlecenia. Strona 12 z 20
DOKUMENTACJA TECHNICZNA 2.2. Pobieranie i aktualizacja bazy BLOZ dla wersji 2014.01.x.x lub starszej. TĄ METODĄ MOŻNA POBIERAĆ BAZĘ BLOZ TYLKO DO KOŃCA GRUDNIA 2014 ROKU, PO TYM OKRESIE MOŻLIWE BĘDZIE POBIERANIE TYLKO ZA POMOCĄ METODY OPISANEJ W PODPUNKCIE 2.1 Obecnie proces pobierania i aktualizacji bazy BLOZ został zdefiniowany jako zadanie harmonogramowe z systemie. W celu uruchomienia generowania ofert należy wybrać zakładkę Zadania. Przy pomocy przycisku Dodaj wybieramy zadanie Aktualizacja BLOZ. Spowoduje to otwarcie okna umożliwiającego konfigurację harmonogramu zgodnie w własnymi preferencjami: Po dokonaniu odpowiednich ustawień oraz zaznaczeniu opcji jako Aktywne pobierania i aktualizacji bazy BLOZ będzie się odbywać zgodnie z preferencjami. W celu poprawnej obsługi aktualizacji bazy BLOZ należy jeszcze: Włączyć zadanie archiwizacji raz dziennie w nocy. Strona 13 z 20
DOKUMENTACJA TECHNICZNA Ustawić wartość opcji SRC_DEL_FILES_AFTER_FINISH na TAK Ustawić opcję TSK_DEL_FILES_AFTER_FINISH dla zlecenia RECV_BLZ na TAK Strona 14 z 20
DOKUMENTACJA TECHNICZNA W opcji DST_DEF_DESTINATION dla zlecenia SEND_RQST_BLZ jako wartość zdefiniować KSEWD. W tej samej opcji DST_DEF_DESTINATION dla innego zlecenia RECV_BLZ jako wartość zdefiniować KSHRT. Strona 15 z 20
DOKUMENTACJA TECHNICZNA Dla zleceń SEND_RQST_BLZ oraz RECV_BLZ proszę ustawić opcję TSK_WAIT_TIME na wartość 7200 UWAGA Jeśli podczas pobierania lub aktualizacji bazy BLOZ, w zleceniu RECV_BLZ wystąpi błąd typu Out Of Memory należy zmienić ilość przydzielonej pamięci. Dokonujemy tego poprzez edycję pliku Catalina (C:\KS\Tomcat\4.1.x\bin\Catalina.bat) modyfikując wartość parametru Xmx na wartość 1400m (-Xmx 1400m ). Strona 16 z 20
DOKUMENTACJA TECHNICZNA JEŚLI SYSTEM KORZYSTA Z WERSJI XE BAZY DANYCH ORACLE, NALEŻY DODATKWO USTAWIĆ DWIE OPCJE: Opcję ARCH_DELETE_ROWS na TAK Opcja określa, czy proces archiwizacji wierszy z tabel ma je przenosić do archiwum, czy też usuwać. Domyślną wartością tej opcji jest NIE. Wprowadzenie wartości TAK dla tej opcji spowoduje, iż proces archiwizacji, zamiast przenosić wpisy z tabel głównych do tabel przechowujących wpisy archiwalne, spowoduje ich usunięcie. Opcję ARCH_VALIDITY na wartość 14 lub 7. Opcja określająca, po jakim czasie, wpisy z tabeli zleceń, mają zostać przeniesione do archiwum. Wartość tej opcji należy podawać w dniach. Wartością domyślną jest liczba 30 co powoduje, iż po uruchomieniu zadania archiwizacji wszystkie starsze(niż 30 dni) rekordy tabeli zostaną przeniesione do archiwum. Jeśli system korzysta z wersji XE bazy danych Oracle zaleca się ustawić 14 lub 7 dni. Strona 17 z 20
DOKUMENTACJA TECHNICZNA 2.2.1 Weryfikacja poprawności przyjęcia bazy BLOZ. W celu zweryfikowania poprawności najlepiej wyczyścić całą tabelę BLZ na schemacie HURT używając polecenia: TRUNCATE TABLE BLZ; Następnie należy uruchomić zadanie Aktualizacja BLOZ. W tym celu wchodzimy w zadania i klikamy ikonkę Uruchom teraz. Następnie po uruchomieniu zadania Aktualizacja BLOZ przechodzimy do zakładki Zlecenia. W zakładce tej oba typy zleceń SEND_RQST_BLZ oraz następujące po nim RECV_BLZ powinno zakończy się powodzeniem co symbolizuje symbol w kolumnie Status. Dodatkowo, na liście dla zleceń SEND_RQST_BLZ oraz RECV_BLZ można kliknąć na ikonę lupki w kolumnie Akcja i tym samym przejść do szczegółów zlecenia, dodatkowo weryfikując czy nie pojawił się żaden błąd bezpośrednio w logach konkretnego zlecenia. 2.3. Pobieranie i aktualizacja komunikatów GIF i BLUR Obecnie proces pobierania komunikatów GIF i BLUR został zdefiniowany jako zadanie harmonogramowe z systemie. W celu uruchomienia pobierania komunikatów GIF oraz BLUR należy wybrać zakładkę Zadania. Obecnie proces pobierania komunikatów GIF i BLUR został zdefiniowany jako zadania harmonogramowe z systemie. W celu uruchomienia pobierania komunikatów GIF oraz BLUR należy wybrać zakładkę Zadania. Strona 18 z 20
DOKUMENTACJA TECHNICZNA Przy pomocy przycisku Dodaj wybieramy zadania Pobieranie komunikatów GIF, a później Pobieranie komunikatów BLUR. Spowoduje to otwarcie okien umożliwiającego konfigurację harmonogramu zgodnie w własnymi preferencjami: Po dokonaniu odpowiednich ustawień oraz zaznaczeniu opcji jako Aktywne pobierania komunikatów GIF i BLUR będzie się odbywać zgodnie z preferencjami. W celu poprawnej obsługi pobierania komunikatów należy jeszcze w opcji DST_DEF_DESTINATION dla zlecenia SEND_RQST_GIF i SEND_RQST_BLR oraz jako wartość zdefiniować KSEWD: Strona 19 z 20
DOKUMENTACJA TECHNICZNA W tej samej opcji DST_DEF_DESTINATION dla zleceń RECV_BLR oraz RECV_GIF jako wartość zdefiniować KSHRT. Strona 20 z 20