ALBECO Soft mgr inż. Piotr Berłoski ul. Warzyniaka 11 60-506 Poznań piotrber@albeco.poznan.pl.albeco.poznan.pl tel. 8420-027, fax 8420-228 PROGRAM GENERATOR Instrukcja użytkonika ersja 0.9 23.04.2004-1/8 -
Spis treści 1. Przeznaczenie programu...3 2. Postać danych...3 2.1. Dane elementarne...3 2.2. Klucze...4 2.3. Dodatkoe informacje...4 3. Podział danych na pliki...4 4. Format plikó...5 4.1. Pliki tekstoe z separatorem...5 4.2. Pliki tekstoe o stałej szerokości pól...5 4.3. Bezpośredni odczyt baz danych dbase lub Paradox...6 5. Instalacja i konfiguracja programu...7 5.1. Instalacja...7 5.2. Konfiguracja programu...7 6. Posługianie się programem...8-2/8 -
1. Przeznaczenie programu Rozporządzenie Ministra Zdroia z dnia 20 lutego 2003 r. spraie przekazyania danych dotyczących ielkości obrotu produktami leczniczymi przez hurtonie farmaceutyczne nakłada na sprzedacó oboiązek składania ministroi łaściemu do spra zdroia, kartalnych raportó dotyczących ielkości obrotu. Dla ygeneroania szczegółoego kartalnego spraozdania z obrotó potrzebne są następujące dane: liczba sprzedanych opakoań poszczególnych produktó leczniczych artość sprzedaży poszczególnych produktó leczniczych Dane te muszą być raporcie składanym postaci elektronicznej przedstaione dla każdego produktu osobno, rozbite na 3 miesiące kartału i podzielone na określonych rozporządzeniu 10 grup odbiorcó. Spraozdanie z obrotó trzeba składać postaci pliku XML. Program GENERATOR torzy plik raportu żądanym formacie na podstaie danych yeksportoanych z systemó informatycznych użyanych hurtoniach do eidencji magazynu i sprzedaży (programó magazynoo-handloych). Program umożliia rónież bezpośredni odczyt potrzebnych informacji z baz danych różnego typu oprogramoania użyającego tabel standardzie dbase (*.DBF) lub Paradox (*.DB). Program umożliia częścioe uzupełnienie danych poprzez ręczne podzielenie odbiorcó na grupy. Możlie jest rónież przystosoanie danych systemie hurtoni na potrzeby generoania raportu. Jeżeli system nie przeiduje podziału klientó na grupy można ten podział zakodoać symbolu lub innym przekazyanym do generatora polu tekstoym umieszczając nim jako da ostatnie znaki kod grupy odbiorcó. 2. Postać danych 2.1. Dane elementarne Dane te są niezbędne dla ygeneroania raportu. Umieszczenie ich szystkich jednym ierszu pliku danych lub jednym rekordzie pliku DBF daje komplet niezbędnych informacji. EAN13 13 cyfr zaierających kod toaru liczba sprzedanych opakoań na jednej fakturze lub suma sprzedaży z okresu nieprzekraczającego jednego miesiąca - liczba dziesiętna całkoita lub z separatorem dziesiętnym ; cena lub artość sprzedaży - cena netto lub artość netto sprzedaży podanej ilości - liczba dziesiętna całkoita lub z separatorem dziesiętnym data sprzedaży data doolnym formacie grupa odbiorcó liczba z przedziału 1 do 10 1 zakłady opieki zdrootnej 2 apteki ogólnodostępne 3 punkty apteczne 4 sklepy zielarsko medyczne 5 sklepy zielarsko drogeryjne 6 sklepy specjalistycznego zaopatrzenia medycznego 7 sklepy ogólnodostępne 8 sklepy zoologiczne 9 zakłady lecznicze dla zierząt oraz lekarze eterynarii 10 hurtonie farmaceutyczne Grupa może być polem o szerokości nie przekraczającej 20 znakó. Jako numer grupy będą - 3/8 -
potraktoane 2 ostatnie znaki. Przy szerokości pola iększej niż 2 znaki należy numer grupy pisać z zerem nieznaczącym np. XXX01, YYYYYYYY03, ZZ10. 2.2. Klucze W przypadku umieszczenia danych kilku plikach informacje muszą być ze sobą poiązane unikalnymi kluczami. unikalny identyfikator toaru doolny łańcuch znakó ASCII max. 20 znakó jednoznacznie identyfikujący produkt unikalny identyfikator klienta doolny łańcuch znakó ASCII max. 20 znakó jednoznacznie identyfikujący klienta unikalny identyfikator faktury doolny łańcuch znakó ASCII max. 20 znakó jednoznacznie identyfikujący fakturę sprzedaży. Określenie doolny łańcuch oznacza znaki ASCII o kodach od 32 do 255. W przypadku pliku tekstoego z separatorem, enątrz klucza nie może ystępoać znak ybrany jako separator pól. 2.3. Dodatkoe informacje W przypadku, gdy system magazynoo-handloy nie daje możliości podzielenia klientó na grupy odbiorcó podział klientó można ykonać ręcznie programie generatora. Program może przechoyać bazę danych klientó i przy kolejnych raportach trzeba będzie przydzielać do grup tylko noych klientó. W takim ariancie pliku danych należy umieścić pole z nazą klienta. Naza może mieć długość do 60 znakó. W pliku tekstoym z polami oddzielonymi separatorem należy pole z nazą otoczyć znakami cudzysłou. 3. Podział danych na pliki Dane potrzebne do zsumoania i podzielenia sprzedaży mogą być proadzone postaci plikó tekstoych lub tabel bazy danych stndardzie dbase lub Paradox. Piki tekstoe mogą być plikami z doolnym separatorem rozdzielającymi poszczególne pola danych lub plikami o stałej szerokości pól. Program może importoać dane z kilku plikó zaierających elementarne informacje i klucze poszczególnych danych. Kolejność pól poszczególnych ierszach plikó jest doolna. Pliki mogą zaierać dodatkoe, nadmiaroe informacje zbędne dla utorzenia raportu. Przykład 1 pierszym pliku mogą się znajdoać unikalne identyfikatory toaró i ich kody EAN13 drugim unikalne identyfikatory klientó i kody grupy odbiorcó trzecim data sprzedaży leku, unikalny kod toaru, ilość sprzedanych opakoań i cena sprzedaży oraz unikalny identyfikator klienta. Przykład 2 pierszym pliku mogą się znajdoać unikalne identyfikatory faktur, daty sprzedaży i unikalne identyfikatory klientó drugim pliku kody EAN13 toaru, ilość i cena oraz unikalny identyfikator faktury trzecim pliku unikalne identyfikatory klientó i nazy firm z zakodoaną grupą odbiorcó Klienci mogą zostać rónież podzieleni na grupy odbiorcó ręcznie programie generatora po uprzednim proadzeniu ich pozostałych danych. - 4/8 -
Przykład 3 pierszym pliku data sprzedaży leku, jego kod EAN13, ilość sprzedanych opakoań i cena sprzedaży oraz unikalny identyfikator klienta drugim unikalne identyfikatory klientó i kody grupy odbiorcó W każdym z tych przypadkó i innych program GENERATOR potrafi utorzyć plik raportu. Jako separator dziesiętny może ystąpić kropka albo przecinek. Dane nie muszą być yrónane do brzegu pola. 4. Format plikó 4.1. Pliki tekstoe z separatorem W plikach tekstoych może ystąpić jako separator doolny znak. (przecinek, średnik,apostrof, belka ( ) itp.) Przy konfiguroaniu importu danych programie generatora trzeba określić, których polach znajdują się potrzebne informacje. Program przyjmuje, że pola są numeroane od początku iersza. Piersze pole ma numer zero. Umieszczanie separatora za ostatnim polem nie jest konieczne. 4.2. Pliki tekstoe o stałej szerokości pól Aby skazać programoi generatora odpoiednie pole danych należy podać odstęp od początku iersza i szerokość pola. Odstęp to liczba znakó poprzedzających pierszy znak pola. Przykładoo pliku o następującej strukturze iersza (odstępy spacje dla ich uidocznienia zastąpiono znakiem # ): 1234567###ABCDEFG##HIJKLMNOPQR####STUYWZ###1234567890123 pole odstęp szerokość zaartość pola danych 0 0 10 1234567 1 10 33 ABCDEFG##HIJKLMNOPQR####STUYWZ 2 43 13 1234567890123 Spacje na początku i końcu pola zostaną obcięte nie ma potrzeby yrónyania pola do jego granicy. - 5/8 -
4.3. Bezpośredni odczyt baz danych dbase lub Paradox Program umożliia import danych z kilku różnych tabel. Przy konfiguracji importu należy skazać, które pola zaierają potrzebne informacje elementarne i klucze. Klucze mogą być zaróno liczbami jak i tekstami. Typoo będą to tabele pozycji dokumentó, kontrahentó, nagłókó dokumentó toaró i grup odbiorcó. Ponieaż nie szystkie sprzedaane toary muszą być produktami leczniczymi, nie szystkie dokumenty muszą dokumentoać sprzedaż, program ymaga podania naz pól desygnatoró poszczególnych rekordó i ich artości. - 6/8 -
Konfiguracja importu ymaga dobrej znajomości struktury bazy danych i czynność tą najlepiej poierzyć administratoroi systemu. Ponieaż jednej tabeli mogą znajdoać się zaróno pozycje dokumentó sprzedaży, które mogą mieć ujemną artość polu zaierającym ilość, jak i dokumentó zakupu, program umożliia zmianę znaku artości odczytanej z tego pola. Generator polu zaierającym informacje o grupie odbiorcó będzie poszukiał liczby z przedziału 1..10, jeśli e skazanym polu nie będzie liczby tylko tekst generator będzie usiłoał zamienić ostatnie da znaki tego tekstu na liczbę określającą grupę odbiorcó. W przypadku braku poodzenia potraktuje klienta jako odbiorcę należącego do grupy 7. 5. Instalacja i konfiguracja programu 5.1. Instalacja Po pobraniu programu z naszej strony należy go zainstaloać doolnym folderze np. domyślnie ustaionym przez instalatora. Program korzysta z silnika bazy danych BDE firmy Borland. W trakcie instalacji pojaia się okienko z żądaniem określenia miejsca zainstaloania Borland Database Engine. Sugerujemy ybranie lokalizacji domyślnej, czyli kliknięcie na OK. 5.2. Konfiguracja programu. Po pierszym uruchomieniu programu należy go skonfiguroać korzystając z kreatora uruchamianego opcji menu Ustaienia/Format importonych danych. Użytkonicy korzystający z programu ZBYT naszej firmy oraz z programó Subiekt mają zadanie bardzo ułatione. Wystarczy skazać folder, którym Generator ma szukać pliku danych yeksportoanego z systemu magazynoo-handloego. Przygotoanie danych programach Subiekt opisuje odrębna dokumentacja. Użytkonicy innych programó eksportujących pliki tekstoe muszą skazać Generatoroi lokalizację - 7/8 -
plikó i ich zaartość. UWAGA kolejność podaanych danych ma znaczenie. W najogólniejszym przypadku mogą ystąpić następujące pliki: - sprzedaży zaierający pozycje faktur - komplet danych elementarnych lub klucze umożliiające ich odnalezienie kolejnych plikach ten plik musi być proadzony jako pierszy; - faktur daty sprzedaży, grupy klientó lub klucze danych klientó jeśli ten plik ystępuje to poinien zostać opisany jako drugi; - klientó klucze klientó i ich grupy lub klucze grup trzeci lub czarty; - toaró klucze toaró i ich kody EAN13 trzeci lub czarty; - grup klientó klucze grupy klientó i ich kody (01-10) jeśli plik ystępuje to zasze jako ostatni; Wproadzenie naz plikó, ich lokalizacji i zaartości kończy konfigurację programu. W opcji ustaienia, dane łasne należy podać REGON i NIP firmy. Wpisanie łaściego klucza aplikacji zamienia ersję demo na ersję zarejestroaną - pełni funkcjonalną. 6. Posługianie się programem Po zakończeniu żmudnego etapu konfiguracji posługianie się programem jest już banalne. Naciśnięcie na klaisz Noy pooduje odczytanie plikó. Naciśnięcie na klaisz Zapisz pooduje zapisanie raportu postaci pliku XML ybranej lokalizacji Naciśnięcie na klaisz Wydruk pooduje ydrukoanie na domyślnej drukarce załącznika nr 1. - 8/8 -