Ap62nwin Podręcznik użytkownika Katowice 2014 Dotyczy produktu Ap62nwin w wersji 2014.0.0.7 Aktualna wersja dokumentacji (w tym instrukcja) znajduje się na serwerze FTP firmy Kamsoft: ftp://ftp.kamsoft.pl/pub/ks-zsa/dokumentacja/ KAMSOFT S.A. ul. 1 Maja 133 40-235 Katowice Telefon: (0-32) 209-07-05 Fax: (0-32) 209-07-15 WWW: E-mail: http://www.kamsoft.pl 5120@kamsoft.pl
Wstęp Program raportujący Ap62nwin jest programem służącym do komunikacji pomiędzy Apteką a centralą KS-ZSA (poprzez FTP). Program pozwala na wysyłanie min. raportów przyrostowych w każdym momencie oraz na stworzenie harmonogramu do pracy automatycznej. W menu głównego okna programu dostępne są następujące pozycje: Komunikacja - funkcje umożliwiają prace programu AP62NWIN w trybie ręcznym, Harmonogram - funkcje tej grupy sterują pracą AP62NWIN w trybie automatycznym, Konfiguracja - to definiujemy parametry pracy programu, Log - funkcja ta udostępnia przegląd historii pracy programu. Praca raportownika w trybie bezokienkowym W trybie bezokienkowym program raportujący jest wyświetlany przy zegarze systemowym w postaci ikonki. Po jej rodzaju, można się zorientować, jaki jest aktualny stan programu. Rodzaje ikon raportownika: - program działa w trybie automatu - program działa w trybie automatu i w tej chwili wykonuje zadanie - program działa w trybie automatu, ostatnio wykonywane zadanie zakończyło się niepowodzeniem - program działa w trybie ręcznym, wyłączony jest tryb filtrowania danych osobowych - program działa w trybie ręcznym, włączony jest tryb filtrowania danych osobowych - program działa w trybie automatycznym, włączony jest tryb filtrowania danych osobowych Po ustawieniu kursora myszy na ikonę, otrzymujemy informacje o aktualnie wykonywanym zadaniu. Klikając prawym przyciskiem myszy na ikonie otrzymujemy dostęp do menu podręcznego, które umożliwia: Wyświetlenie okna programu Zatrzymanie / wznowienie pracy automatu Wygenerowanie i wysłanie raportu do ZSA. Odebranie zleceń z centrali. 2
Instalacja Ap62nwin Instalację programu raportującego jest bardzo szybka i prosta. Zaczynamy od ściągnięcia najnowszej wersji z serwera FTP firmy KAMSOFT S.A. Znajduje się ona pod ścieżką: ftp://ftp.kamsoft.pl/pub/ks-zsa/ap62nwin.nobde Po ściągnięciu całego katalogu odszukujemy plik ap62inst.exe i uruchamiamy go. Przed przystąpieniem do instalacji należy zamknąć wszystkie uruchomione aplikacje Proces instalacji krok po kroku : Pojawia się pierwsze okno instalatora. Po zapoznaniu się z treścią klikamy DALEJ. Następnym krokiem jest określenie parametrów bazy danych apteki: 3
Wybieramy pomiędzy bazą Firebird lub Oracle oraz wypełniamy parametry: Serwer. nazwa bazy danych (Dla FRB localhost lub nazwa komputera (Nazwa lub IP), dla ORA SID bazy) Plik bazy danych ścieżka do bazy danych FRB. Wpis ten pojawia się tylko przy wyborze typu bazy danych Firebird Nazwa użytkownika nazwa użytkownika bazy danych. Hasło hasło do bazy danych (Przy konfigurowaniu połączenia do bazy danych Oracle należy łączyć się na użytkownika apw_user. Nie należy łączyć się na użytkownika system) Po tych czynnościach klikamy DALEJ. Instalator określa gdzie zainstalować raportownik. Najlepszą lokalizacją jest zainstalowanie Ap62nwin w katalogu programu aptecznego. Po określeniu ścieżki klikamy DALEJ. Instalator jest gotowy do instalacji programu. Należy zamknąć wszystkie uruchomione aplikacje i kliknąć DALEJ. 4
* Jeżeli instalujemy program raportujący w nowej wersji na katalog ze starą wersją instalator zapyta: W przypadku gdy zgodzimy się na podegranie nowych plików zostaną one podmienione. Po tej czynności należy ponownie stworzyć harmonogram oraz ustawić parametry konfiguracji. Aby zachować starą konfigurację oraz harmonogram należy dać na NIE. Pliki ap62nwin.ini oraz zadania.dbf nie zostaną zmienione. Gdy program zostanie zainstalowany (potrwa to kilka sekund) pojawi się ostatnie okno instalatora. 5
Po zakończeniu instalacji: 1. Powinien się stworzyć min. plik ap62nwin.ini, w którym znajduje się konfiguracja raportownika. Należy sprawdzić czy podane wyżej wpisy istnieją. Wszystkie opcje możliwe do ustawienia opisane zostały w rozdziale Usprawnienie pracy z raportownikiem Plik ap62nwin.ini 2. Powinny utworzyć się katalogi: - RAPORTY katalog gdzie będą generowane raporty - OFERTY katalog w którym przechowywana będzie oferta własna Katalogi te tworzą się TYLKO przy instalacji raportownika! 3. W późniejszym czasie powinien się również stworzyć katalog LOGI w którym przechowywane będą logi tworzone przez raportownik. Katalog ten stworzy się automatycznie w momencie gdy plik ap62nwin.log osiągnie graniczną wartość 400KB. W katalogu głównym pozostanie tylko jeden plik ap62nwin.log W obecnych instalacjach katalog ten stworzy sięw identycznej sytuacji. 6
Omówienie podstawowej funkcjonalności 1. Komunikacja Funkcje znajdujące się w menu Komunikacja służą do ręcznej obsługi programu. Po wybraniu określonego zadania wykona się ona w sposób natychmiastowy. W celu ich użycia, należy wyłączyć automat (pierwsza pozycja w menu harmonogram). W przeciwnym wypadku pojawić się może komunikat: lub zadanie zostanie dodane do harmonogramu gdzie wykona się po kilku sekundach. W menu Komunikacja mamy do wyboru następujące funkcje: Wygeneruj raport przyrostowy powoduje wygenerowanie raportu przyrostowego. Jeżeli zaznaczona jest opcja automat wtedy zostanie wygenerowany raport od daty ostatniego raportu do dnia dzisiejszego (data ostatniego raportu jest brana z pliku datadesc.ini w katalogu apteki na serwerze FTP). W przeciwnym przypadku zostaniemy zapytani o zakres dat: 7
Jeżeli apteka raportuje do więcej niż jednej centrali wówczas przy ręcznym generowaniu raportu przyrostowego zostaniemy zapytani, dla jakiej centrali ma być raport wygenerowany: W przypadku, gdy na serwerze FTP znajdują się już jakieś raporty program zapyta czy usunąć zaległe raporty: Po poprawnym wygenerowaniu raportu pojawi się komunikat: Teraz zostaje już tylko wysłanie raportu. Należy skorzystać z innej funkcji w tym menu a mianowicie Wyślij raporty. Po tej operacji pojawi się komunikat: Wygeneruj raport pełny powoduje wygenerowanie raportu pełnego dla konkretnej apteki. Funkcja ta jest nieaktywna dla aptek dosowych oraz przy włączonym automacie. Po wygenerowaniu takiego raportu należy wysłać na serwer FTP (identycznie jak w przypadku raportów przyrostowych) Wyślij raporty funkcja ta pozwala na wysłanie wygenerowanych raportów na serwer FTP. Pobierz zlecenia odbiera wszystkie zlecenia z serwera FTP (z katalogu danej apteki), które się na nim znajdują. Po pobraniu zleceń otrzymujemy komunikat: 8
Przegląd zlecenia z centrali pozwala na przeglądanie wszystkich zleceń z centrali. Funkcja ta jest dostępna tylko dla aptek dosowych. Sprawdź aktualizację - sprawdza dostępność nowszej wersji programu Ap62nwin i jeżeli jest dostępna, wykonuje aktualizację - automatycznie lub pyta czy dokonać aktualizacji. W przypadku braku nowszej wersji dostaniemy komunikat: Kartoteka centralna funkcja ta pozwala na pobieranie i wczytywanie pełnej kartoteki centralnej. Są dostępne dwie opcje: Wczytaj pełną kartotekę centralną Pobierz i wczytaj pełną kartotekę centralną 2. Harmonogram Menu Harmonogram służy do stworzenia listy zadań do cyklicznego wykonywania przez raportownik. Harmonogram taki można również stworzyć w centrali ZSA ( patrz Centralne zarządzanie harmonogramem ap62nwin z poziomu KS-ZSA. ) W menu Harmonogram mamy do wyboru następujące funkcje: Automat funkcja ta zmienia tryb pracy raportownika (automat/tryb ręczny) 9
Dodaj zadanie funkcja ta umożliwia dodanie nowego zadania do harmonogramu Przy dodawaniu zadania do harmonogramu określamy następujące dane: Zadanie do wykonania mamy do wyboru następujące zadania: Wygeneruj i wyślij raport - utworzy raport zawierający odpowiedni zakres danych i wyśle na serwer(y) FTP lub skopiuje do lokalnego katalogu. W przypadku wystąpienia problemów z wysłaniem i włączeniu opcji wysyłaj aż do skutku będzie ponawiał transmisję co 5 minut. Odbierz zlecenia z centrali - odbierze zlecenia z ZSA i przekaże je do apteki. Usuń wykonane zadania - w celu optymalizacji szybkości działania można dodać takie zadanie np. raz w tygodniu, które usunie wykonane zadania (nie zaburzy to w żaden sposób pracy automatu). Gdy jest ustawiony parametrw pliku INI CleanSKFN=1 wtedy to zadanie również czyści tabelę SKFN Wyślij raporty - wszystkie przygotowane raporty zostaną wysłane do centrali KS-ZSA. Wygeneruj raport - odpowiedni raport zostanie wygenerowany i pozostawiony w katalogu z raportami i będzie czekał na wysyłkę. Wygeneruj i wyślij raport pełny - zadanie to utworzy raport zawierający pełne dane i wyśle je na serwer(y) FTP lub skopiuje do lokalnego katalogu. Pobierz i wczytaj kartoteki centralne - zadanie to pobiera i wczytuje dostępne kartoteki centralne Pobierz i wczytaj pełne kartoteki centralne - zadanie to pobiera i wczytuje dostępne pełne kartoteki centralne Pobierz ofertę stworzoną ręcznie - zadanie to pozwala na pobieranie ofert stworzonych ręcznie w ZSA. Zadanie to pojawia się dopiero w przypadku gdy zaznaczymy w konfiguracji opcję Zezwalaj na import ręcznie tworzonych ofert. Oblicz aktualny stan magazynu zadanie to oblicza aktualny stan magazynu apteki i przesyła go do ZSA. (na FTP pojawia się plik stm..zip). Zadanie to pojawia się dopiero gdy w pliku ap62nwin.ini dodamy wpis do sekcji LOCAL o treści ObliczStanMag=1 Wyślij faktury XML - typuje wszystkie nowo wprowadzone dokumenty, które posiadają dodatkowo powiązany z nimi dokument w formacie KS-XML. Dokumenty takie zostają pobrane z systemu KS-EDE (za pomocą unikalnego numeru GID) i następnie przesłane do centrali w postaci archiwum zip. Zadanie to należy zawsze dodawać po zadaniu Wygeneruj i wyślij raport 10
Data wykonania opcja ta określa datę wykonania wybranego zadania. W przypadku zadań powtarzalnych (np. codziennie) określa godzinę o której każdego dnia zadanie ma się wykonać (przy włączonym automacie). Przy wyborze daty możemy pomóc sobie korzystając z kalendarza: Powtarzalne daje możliwość utworzenia zadania powtarzalnego. Mamy tu do wyboru następujące opcje: codziennie co tydzień co miesiąc co 3 miesiące co pół roku co rok zdanie ciągłe - opcja zadanie ciągłe równoznaczna jest z zaznaczeniem okienka Ciągłe i na odwrót. Zadanie powtarzalne po dodaniu go do harmonogramu zostaje oznaczone Ciągłe - ciągłość wykonywania zadania oznacza częstość jego wykonywania większą niż codziennie, która określana jest poprzez parametr w konfiguracji Zadania ciągłe co... minut Zadanie ciągłe po dodaniu go do harmonogramu zostaje oznaczone Centrala Farmanet parametr ten określa do której centrali zadanie ma się odnosić. Zatwierdzamy przyciskiem OK Usuń zadanie umożliwia usunięcie zadania z harmonogramu. Usuń wykonane zadania umożliwia usuwanie zadań które zostały już wykonane przez program. Stworzony harmonogram zostaje zapisany w pliku zadania.dbf. Dodatkowo zostaje utworzony plik zadania_backup.dbf który jest kopią pliku zadania.dbf. W momencie awarii lub uszkodzenia pliku zadania.dbf zostaje on odtworzony z kopii. Plik zadania_backup tworzy się i uaktualnia w momencie wykonywania następujących zadań: - wygeneruj i wyślij raport - pobierz i wczytaj kartoteki centralne - pobierz i wczytaj pełne kartoteki centralne - wygeneruj raport (pełny lub przyrostowy) - wyślij raporty 11
3. Konfiguracja definiujemy parametry pracy programu. Konfigurację programu tworzymy na początku pracy z programem Konfiguracja programu Ap62nwin została podzielona na 5 zakładek. Są to kolejno: Centrala (Ctrl+1) opcje dotyczące centrali KS-ZSA do której będziemy raportować: 12
Centrala (Ctrl+1) - dostępne opcje: Centrala Farmanet - ten parametr wybieramy z listy, a określa on do jakiej centrali ZSA będziemy raportować - możliwe jest raportowanie do wielu central ZSA. Aby dodać nową centralę ZSA należy kliknąć przycisk "[F2] Dodaj" u dołu okna i wybrać pozycję Centralę Farmanet lub skorzystać ze skrótu klawiszowego Ctrl+F2. Usuwania centrali dokonujemy za pomocą przycisku "[F8] Usuń" i pozycji Centralę Farmanet. Można też użyć skrótu Ctrl+F8. Katalog gener. rap. - parametr określający ścieżkę do katalogu, w którym zapisywane będą wygenerowane raporty Katalog lokalny (FN) - jest to lokalny katalog, do którego trafiać będą gotowe raporty. Katalog ten należy wprowadzić tylko w przypadku, gdy apteka, z której raportujemy, pracuje w tej samej sieci lokalnej co ZSA, do którego ma raportować. Przy komunikacji przez FTP pozycja musi pozostać pusta!!! Ostatni raport dnia - parametr określający jak sama nazwa wskazuje datę ostatniego raportu. W automatycznym trybie pracy data ta zmienia się po każdorazowym wygenerowaniu raportu na aktualną datę. Baza (Ctrl+2) parametry dotyczące bazy danych apteki: Baza (Ctrl+2) - dostępne opcje: Typ bazy danych - ten parametr określa rodzaj bazy danych. Do wyboru mamy FRB lub ORA Serwer. nazwa bazy danych (Dla FRB localhost lub nazwa komputera (Nazwa lub IP), dla ORA SID bazy) Plik bazy danych ścieżka do bazy danych Firebird. Wpis ten pojawia się tylko przy wyborze typu bazy danych Firebird Nazwa użytkownika nazwa użytkownika bazy danych. Hasło hasło do bazy danych. (Przy konfigurowaniu połączenia do bazy danych Oracle należy łączyć się na użytkownika apw_user. Nie należy łączyć się na użytkownika system) Katalog licencji ścieżka do licencji aptecznej. (Przy konfigurowaniu połączenia do bazy danych Oracle należy łączyć się na użytkownika apw_user. Nie należy łączyć się na użytkownika system) 13
FTP (Ctrl+3) Parametry związane z serwer FTP: FTP (Ctrl+3) - dostępne opcje: Serwer FTP - z tej listy wybieramy, który z wprowadzonych serwerów FTP będziemy zmieniać. Serwery można dodawać i usuwać przyciskami "[S+F2] Dodaj serwer FTP" oraz "[S+F8] Usuń serwer FTP". Adres serwera FTP - adres serwera FTP, za pomocą którego kontaktujemy się z centralą. Nazwa użytkownika - parametr określający nazwę użytkownika na serwerze FTP Hasło - parametr specyfikujący hasło użytkownika Katalog na serwerze - parametr ten oznacza podkatalog wymiany danych z ZSA. Pamiętać należy, aby każda apteka miała swój własny podkatalog. Katalog znaczników - parametr ten określa ścieżkę do katalogu na serwerze FTP. Po odebraniu zleceń z centrali w katalogu tym raportownik zapisze pliki *.rsp, które są znacznikami dla centrali KS-ZSA, że dane zlecenia zostało odebrane (zlecenie wysłane, potwierdzone ). Gdy nie podamy ścieżki do katalogu znaczników AP62NWIN domyślnie będzie wysyłał pliki do katalogu głównego na serwerze FTP. Bardzo istotną kwestią jest, aby ścieżki do katalogu znaczników były takie same po stronie ZSA i raportownika, w przeciwnym wypadku w centrali nadawanie zleceniom znacznika wysłane, potwierdzone nie będzie miało miejsca. Katalog baz centralnych FTP - Ścieżka do katalogu na serwerze FTP, z której ściągane są pliki aktualizujące kartoteki centralne apteki. Nr portu - serwery FTP domyślnie działają na porcie 21, ale jeżeli istnieje konieczność użycia innego portu, wówczas uzupełniamy to pole. F5 Proxy możliwość ustawień proxy Próba nawiązania połączenia ilość prób podłączenia do FTP. Co interwał czasu nawiązywania podłączenia do FTP. Autorozłączenie - parametr ten specyfikuje dla połączeń internetowych, nie stałych rozłączenie bądź jego brak po wykonaniu zadania. Pasywny - parametr ten specyfikuje tryb połączenia z serwerem FTP UWAGA Niektóre serwery FTP rozróżniają wielkość liter w nazwach należy pamiętać aby ścieżki wpisywać w taki sam sposób jak na serwerze FTP. 14
Opcje (Ctrl+4) parametry specyfikujące dodatkowe opcje raportownika: Opcje (Ctrl+4) - dostępne opcje: Katalog ofert własn. - parametr określa ścieżkę do katalogu, w którym raportownik zapisywać będzie odebrane z centrali ZSA pliki z ofertą własną. Zadania ciągłe co - interwał czasu dla zadań ciągłych Wysyłaj raporty SAP - parametr specyfikujący - znak V / jego brak - czy raporty SAP będą/nie będą wysyłane do centrali KS-ZSA. Aby wysłać taki raport należy go najpierw stworzyć w aptece - patrz moduł APW21 -> FK -> Przekazanie raportu SAP. Tylko wybrane towary - - jest to parametr określający czy raporty mają uwzględniać tylko towary określone na tzw. ograniczonej liście asortymentowej - puste okienko, czy też wszystkie towary mają być brane pod uwagę - znak V w okienku. Listę towarów monitorowanych stworzyć należy w aptece w module APW44 - Komunikacja lub w centrali ZSA w module NET52 - Kartoteki. Wysyłaj pliki refundacyjne włączenie opcji powoduje przekazanie plików refundacyjnych do centrali KS-ZSA za pomocą raportownika. Przy wykonywaniu zadania Wyślij raporty ap62nwin sprawdza czy w katalogu generowania raportów znajdują się pliki refundacyjne (np.rsp00222.xml) i jeśli są to zostają wysłane na serwer FTP. Na serwerze FTP pojawi się plik np. 04041122.zip oraz plik potwierdzający 04041122.ptr Zabezpiecz hasłem - określa on poziom bezpieczeństwa w pracy z programem Ap62NWin. Niektóre z operacji tj. zmiana konfiguracji, dodawanie zadania, itp. mogą być zabezpieczane hasłem. Zezwalaj na import ręcznie tworzonych ofert - zaznaczenie tego parametru pozwala na dodawanie do harmonogramu z poziomu raportownika zadania Pobierz ofertę stworzoną ręcznie 15
Aktualizacja (Ctrl+5) parametry dotyczące aktualizacji programu: Aktualizacja (Ctrl+5) - dostępne opcje: Aktualizacja automatyczna - parametr określa czy program ma sam się aktualizować co pewien czas ( bez pytania o potwierdzenie). Interwał - parametr określający, co jaki czas program będzie szukał nowszej wersji na serwerze FTP. Nr.Portu - parametr ten określa numer portu, na którym działa serwer FTP. Pasywny - określa tryb połączenia z FTP. 4. Log Program raportujący Ap62nwin podczas swojej pracy rejestruje wszystkie zdarzenia które miały miejsce w programie. Możemy min. odszukać błąd który wyskoczył podczas generowania raportu. Zdarzenia te można podejrzeć w pliku ap62nwin.log (znajduje się on w katalogach programu raportującego) oraz w dzienniku zdarzeń (z poziomu programu). 16
Usprawnienie pracy z raportownikiem 1. Plik ap62nwin.ini W pliku Ap62nwin.ini znajdują się wpisy służące do ustawień samego programu oraz wpisy bezpośrednio związane z konfiguracją raportownika. Większość tych wpisów odpowiada konkretnym ustawieniom z konfiguracji programu (patrz rozdział: Omówienie podstawowej funkcjonalności -> Konfiguracja). Plik ten pomaga w konfigurowaniu raportownika włączania. Spis parametrów się mogących wystąpić w pliku ap62nwin.ini: LOCAL: TMRK =... - interwał czasu. Parametr określający czas po jakim raportownik sprawdzi czy apteka dodała jakieś zadanie. First run =... - parametr ustawiony na 1 oznacza pierwsze uruchomienie raportownika, przy każdym następnym będzie 0. Baza Dir =... - parametr określający w jakim katalogu znajduje się baza apteki z której raportujemy lub do której przesyłamy zlecenia. Oferty Dir =... - parametr określa ścieżkę do katalogu, w którym raportownik zapisywać będzie odebrane z centrali ZSA pliki z ofertą własną. AliasAOW =... - alias apteki WinSys =... - określa rodzaj systemu aptecznego (Windows - 1, DOS - 0) AutoDisconnect =... - parametr ten specyfikuje dla połączeń internetowych, nie stałych rozłączenie bądź jego brak po wykonaniu zadania IleFN =... - ilość zdefiniowanych central w konfiguracji. Opoznienie =... - parametr ten określa po jakim czasie wznowić wysyłanie w przypadku niepowodzenia. OpoznienieStartu= - parametr ten powoduje iż raportownik uruchomi się z pewnym opóźnieniem (podajemy wartość w minutach) tak aby uruchomił się po starcie bazy. AutoRun =... - gdy jest ustawiony na 0 oznacza iż po zamknięciu programu zostanie usunięty wpis z rejestru i raportownik nie będzie się uruchamiał przy następnym starcie systemu. MAskaFTp =... - parametr wykorzystywany podczas pobierania listy plików z serwera FTP. UsunTxtZlec =... - podczas zadania "Odbierz zlecenia" jeżeli ustawiony na 1 usuwa zlecenia tekstowe starsze niż 30 dni (1- usuwa zlecenia, 0 - nie usuwa zleceń) Priorytet =... - ustawienie priorytetu procesu Ap62NWin (dostępne wartości to 0, -1, -2) (-2 oznacza najniższy priorytet) CleanSKFN =... - podczas zadania "Usuń wykonane zadania" usuwa zawartość tabeli SKFN z bazy (liczba dni określająca ile danych należy pozostawić - domyślnie jest to 30 dni) PominSKFN =... - pomija dodawanie pliku SKFN.db do generowanego pakietu (1 - plik jest pomijany; 0 - plik nie jest pomijany) - domyślnie = 0. PassivFTPAkt =... - określa tryb połączenia z FTP. PortFTPAkt =... - numer portu serwera FTP. Harmonogram =... - możliwe poziomy: 0 - raportownik nie będzie co 1h sprawdzał i pobierał harmonogramu, 1 - raportownik będzie co 1h sprawdzał i pobierał harmonogram. AutoAkt =.. - parametr określający czy program będzie się sam aktualizował ( 1- Tak, 0 - Nie ) AutoAktStop= wyłącza sprawdzanie czy jest nowa wersja raportownika - użyteczne w sieciach VPN bez dostępu do serwera ftp.kamsoft.pl AutoAktInterval =... - parametr określający co jaki czas ( w minutach ) program będzie szukał nowej wersji na serwerze FTP. ObliczStanMag =... - parametr ten gdy jest ustawiony na 1 powoduje dodanie się do harmonogramu raportownika zadania Oblicz aktualny stan magazynu (gdy parametr 17
ustawiony jest na 1 a harmonogram zostanie usunięty program doda takie zadanie na godzinę 23.50). [FTP - plik STM.zip oraz identyczny STM.ptr] PominTabele =... - parametr ten pozwala na pomijanie określonych tabel podczas generowania raportu (tabele należy rozdzielić przecinkiem) OfertaReczna =... - parametr ten informuje czy w konfiguracji raportownika jest zaznaczona opcja Zezwalaj na import ręcznie tworzonych ofert ( 1- włączona, 0 - wyłączona ) DodajSapPref =... - parametr ten ustawiony na 1 aktywuje opcję która umożliwia zmianę nazwy archiwum zawierającego raporty SAP. Nazwa archiwum będzie miała format idapteki_mmddhhnnss (idapteki_miesiąc, dzień, godzina, minuta, sekunda) KSEDEDIR= - katalog systemu KS-EDE. W przypadku, gdy raportownik jest uruchamiany z innej lokalizacji niż standardowa (...\APW\Ap62nwin\) czyli poza katalogiem programu KS-AOW konieczne będzie poprawienie opcji. Opcja w takim przypadku powinna wskazywać główny katalog systemu KS-EDE. KSEDELOGIN= opcja służąca do elektronicznej wymiany dokumentów. Należy wpisać login użytkownika WysylajFakturyXml= opcja ta ustawiona 1 umożliwiającą wysyłanie plików zawierających faktury XML w ramach zadania automatycznego generowania i wysyłania raportu. Domyślnie funkcja jest nieaktywna. DB_USER = użytkownik bazy DB_PASS = zakodowane hasło do bazy DB_PROVIDER = typ bazy danych (Firebird lub Oracle) DB_SERWER = dla bazy Firebird nazwa komputera np. localhost, dla Oracle alias z tnsnames DB_PATH = ścieżka do bazy danych. WPIS TYLKO DLA BAZY FIREBIRD GodzinaRestartu= - wartość określająca godzinę, po której nastąpi restart raportownika w celu zwolnienia zasobów. Aby wyłączyć mechanizm restartu należy wpisać GodzinaRestartu=OFF FDODB= - parametr określający czy właczyć/wyłączyć filtrowanie danych odbiorców przy 2 poziomie filtrowania danych osobowych/identyfikacyjnych. Wartość domyślna = 1 (1 włączenie, 0 wyłączenie) USTAWIENIA CENTRALI (są to ustawienia centrali ustawiane w konfiguracji): Name - centrala ZSA LokalDir - lokalny katalog (FN) RaportDir - katalog generowania raportów LastRaport - ostatni raport dnia Tries - próba nawiązania połączenia SAP - wysyłaj raporty SAP REF - wysyłaj pliki refundacyjne OGR - tylko wybrane towary PMins - zadania ciągłe co... IleFTP - ilość serwerów FTP 18
USTAWIENIA FTP (są to ustawienia serwera FTP ustawiane w konfiguracji) : Name - serwer FTP Host - adres serwera FTP User - nazwa użytkownika Pass - hasło Dir - katalog na serwerze Znaczniki - katalog znaczników Port - nr. portu Passiv - tryb pracy BazyCentralneDir - katalog baz centralnych FTP Ustawienia Proxy - PxHost, PxUser, PxPass, PxPort, PxTyp 2. Rodzaje plików trafiających na FTP. Podczas komunikacji na linii ZSA Raportownik na serwerze FTP pojawiają się różnego rodzaju pliki. W zdecydowanej większości przypadków posiadają one dwa formaty: *.zip archiwum z danymi *.ptr plik potwierdzający (ta sama nazwa inne rozszerzenie) Stałym plikiem w katalogu danej firmy na serwerze FTP jest plik dtrange.txt. W pliku tym znajduje się data końcowa zakresu danych w ZSA. Przykład wpisu w pliku dtrange.txt: [ZAKRESDANYCH] BRAKDANYCHOD=2010.05.19 Inny plik o takim samym wpisie to dctrange.txt. Jest to plik z datą końcową zaczytanych kartotek centralnych Rodzaje plików na FTP: Rodzaj opis (rozszerzenie) NW... raport z danymi (zip/ptr) NA zlecenia do aptek (zip/ptr) STM... aktualne stany magazynowe apteki (zip/ptr) Dbenterp kartoteki centralne (zip/ptr) requ plik żądające wysłania brakujących danych z apteki (zip/ptr) Oferta plik z ofertą własną. (DB) Ofertaręczna plik z ofertą ręczną (zip/ptr) R potwierdzenie odebrania zlecenia (trafia do głównego katalogu lub do katalogu ustawionego w Ap62nwin katalog znaczników.(rsp) 19
3. Centralne zarządzanie harmonogramem ap62nwin z poziomu KS-ZSA. W celu wygodniejszej kontroli nad raportownikami istnieje możliwość tworzenia dla nich harmonogramów w centrali KS-ZSA i rozsyłania po aptekach. Harmonogram centralny zastąpi aktualnie działający w aptece. Mechanizm centralnego sterowania raportownikami znacząco przyspiesza proces konfiguracji raportowania i ułatwia jego dostrajanie. Funkcja obsługi centralnych harmonogramów dla programów raportujących stworzyć znajduje się w KS-ZSA w module 61.ADMIN: Pełna instrukcja dotycząca tworzenia, rozsyłania i działania centralnych harmonogramów znajduje się w instrukcji użytkownika KS-ZSA: Rozdział 15 61 Administrator 11. Dodatkowe funkcje 11.1Centralne zarządzanie pracą programów ap62nwin.exe. Aktualna wersja instrukcji KS-ZSA znajduje się na serwerze FTP firmy KAMSOFT S.A w poniższej lokalizacji ftp://ftp.kamsoft.pl/pub/ks-zsa/dokumentacja/ 20
4. Sterowanie raportownikiem od strony AOW Aby przyspieszyc prace z raportownikiem w programie aptecznym jest możliwość częściowego sterowania zadaniami raportownika Funkcja ta znajduje się w prawie każdym module AOW (Program Komunikacja z centralą [CTRL+ALT+K]) Po dodaniu zadania pojawia się ono w raportowniku z dopiskiem (APW): Można dodawać zadania: - Test komunikacji - Wygeneruj i wyślij raport - Odbierz zlecenia z centrali - Pobierz i wczytaj kartoteki centralne - Pobierz i wczytaj pełne kartoteki centralne - Wyślij faktury XML - Pobierz znaczniki zamawiania - Włącznie / Wyłącznie automatu 21
5. Filtrowanie danych osobowych Filtrowanie danych pozwala dostosować proces przesyłania danych z apteki do centrali KS-ZSA do wymogów a) Ustawy o Ochronie Danych Osobowych b) Ustawa o zmianie ustawy o świadczeniach opieki zdrowotnej finansowanych ze środków publicznych oraz niektórych innych ustaw z dnia 24 sierpnia 2007 Dz.U. z 2007r. Nr 166, poz. 1172 Filtrowanie danych osobowych można włączyć tylko z poziomu centrali (centralne zarządzanie harmonogramem ap62nwin z poziomu KS-ZSA). W celu włączenie filtrowania danych osobowych oraz zapoznania się z celem działania tych filtrów należy zapoznać się z dokumentem (KS-ZSA-uruchomienie_filtrowania_danych) na serwerze FTP firmy KAMSOFT S.A. pod ścieżką: ftp://ftp.kamsoft.pl/pub/ks-zsa/dokumentacja/ks-zsa-uruchomienie_filtrowania_danych.pdf Gdy włączymy filtrowanie danych osobowych w raportownikach, wtedy w dolnej części okna pojawi się komunikat o poziomie filtrowania: 22
6. Instalacja klienta komunikacyjnego KS-OMNIPHARM Od czerwca 2012 roku raportownika ma możliwość zainstalowania narzędzia komunikacyjnego systemu KS-OMNIPHARM. Aby tego dokonać należy: Dokonać integracji z systemem KS-OMNIPHARM Należy tego dokonać w module 61.ADMIN Dodać do centralnego harmonogramu programu raportującego zadania INSTALUJ KOMUNIKATOR KS-OMNIPHARM 61.ADMIN Centralne Sterowanie Centralne Harmonogramy 23
Wysłać centralny harmonogram do wybranych aptek Pojawi się odpowiedni znacznik przy harmonogramie W Ap62nwin zadanie zostanie wykonane i odpowiednie programowanie zostanie zainstalowane. Harmonogram programu raportującego zostaje odświeżony co godzinę lub w momencie wykonania zadania Wyślij raporty 24
Spis Treści: Wstęp....2 Praca raportownika w trybie bezokienkowym.. 2 Instalacja Ap62nwin...3 Proces instalacji krok po kroku... 3 Omówienie podstawowej funkcjonalności.....7 Komunikacja..7 Harmonogram....9 Konfiguracja....12 Log... 16 Usprawnienie pracy z raportownikiem.....17 Plik ap62nwin.ini 17 Rodzaje plików trafiających na FTP 19 Centralne zarządzanie harmonogramem ap62nwin z poziomu KS-ZSA....20 Sterowanie raportownikiem od strony AOW..21 Filtrowanie danych osobowych......22 Instalacja klienta komunikacyjnego KS-OMNIPHARM..23 25