Instrukcja instalacji i konfiguracji programu BIZcas 2.0 (Beta test) i

Instrukcja instalacji i konfiguracji programu BIZcas 2.0 (Beta test) i CAScale V. 2.07.
Date: 2016.08.09
Ver:1.0
Przygotował: Paweł Krajewski.
1. Instalacja
Programy BIZcas 2.0 oraz CAScale V. 2.07 są dostarczane w postaci spakowanych archiwów zip.
Sposób instalacji:
a. Na dysku c:/ założyć folder o nazwie CASPL.
W przypadku utworzenia katalogu o innej nazwie lub w innej lokalizacji, należy uwzględnić
to w czasie czynności związanych z konfiguracją programu.
Ważne:
W nazwach folderów użytych w ścieżce dostępu nie wolno używać spacji.
b. W folderze tymczasowym rozpakować zawartość archiwum zawierające pliki programu
CAScale V. 2.07.
c. Skopiować pliki uzyskane po rozpakowaniu archiwum CAScale V. 2.07 do folderu c:/CASPL.
d. W folderze tymczasowym rozpakować zawartość archiwum zawierające pliki programu
CAScale V. 2.07.
e. Skopiować pliki uzyskane po rozpakowaniu archiwum BIZcas 2.0 do folderu c:/CASPL.
W czasie kopiowania wyrazić zgodę na nadpisanie wszystkich plików.
2. Konfiguracja programu BIZcas
W katalogu c:/CASPL jest plik tekstowy bizcas.ini, który zawiera dane konfiguracyjne dla
programu BIZcas.
Dane zawarte w pliku należy skonfigurować przed włączeniem programu BIZcas2.exe.
Uwaga:
W czasie działania programu BIZcas2.exe nie będzie możliwe zapisanie zmian wprowadzonych
w pliku konfiguracyjnym bizcas.ini. Aby zapis zmian był możliwy, należy wyłączyć działanie
programu BIZcas2.exe przez zakończenie procesu w managerze zadań.
Sekcja MAPOWANIE odpowiada za odczyt poszczególnych pól z pliku .1wa do XMLa.
Zawartość pliku bizcas.ini:
[PARAMETRY_PRACY]
KATALOG_BIZERBA=C:\CASPL\DANE\
##Podać ścieżkę do folderu z plikami źródłowymi dla wag Bizerba
KATALOG_CAS=C:\CASPL\
## Podać ścieżkę do folderu programu CAScale (tu są tworzone pliki xml dla poszczególnych wag
CAS, wysyłane z pomocą programu CAScale.)
KATALOG_NIE_WYSLANE=C:\CASPL207\NIEWYSLANE\
## Podać ścieżkę do folderu gdzie zapisywane będą niewysłane pliki z danymi
INTERWAL=10
##Parametr określający częstotliwość sprawdzania zawartości folderu z plikami źródłowymi dla
wag Bizerba (w sekundach)
KASOWANIE=1
##Parametr określający czy plik źródłowy ma być kasowany po wysłaniu: 0-nie, 1-tak.
Jeżeli zostanie wybrana opcja 0-nie, to po wysłaniu danych z pliku, zostanie zmieniona nazwa
jego rozszerzenia z .1wa na .1wa_sent.
WIDOCZNY=1
##Parametr określający widoczność okna wysyłki danych z programu CAScale: 0- Nie 1- Tak
[WAGI]
ILOSC=99
##Parametr określający, Max ilość wag w systemie
[MAPOWANIE]
PLU=PLU2-6
##Parametr określający, które cyfry kodu kreskowego z pliku źródłowego, z parametru
<PLU>2635440000000</PLU>), są używane do utworzenia numeru PLU w kodzie kreskowym w
pliku wynikowym z danymi do wysyłki.
Przykład: Dla ustawienia PLU=PLU2-6 z kodu <PLU>2635440000000</PLU> numer PLU w wadze
zostanie ustalony jako 63544 i będzie on użyty przez wagę do druku kodu kreskowego według
formuły 2NNNNN0WWWWWC (N-numer PLU, W-wskazanie masy).
PLUSKL=PLU1-6
##Parametr określający, które cyfry kodu kreskowego z pliku źródłowego, z parametru
<PLU>2635440000000</PLU>), są mapowane w procesie śledzenia powiązania numeru PLU z
numerem pośredniego opisu składu (Dotyczy wag CL5500 – W wersji BIZcas 2.0 (Beta) funkcja ta
jest jeszcze nieczynna)
NAZWA01=NAZWA
##Parametr określający źródło do mapowania nazwy towaru (1 linia nazwy w wadze).
Uwaga: W przypadku mapowania nazwy skróconej określonej parametrem KRNAZWA,
znajdujący się na końcu treści nazwy znak w postaci litery C (używany tylko przez drukarki
fiskalne) jest zawsze odrzucany.
NAZWA02=KRNAZWA
##Parametr określający źródło do mapowania nazwy towaru (2 linia nazwy w wadze).
Uwaga: W przypadku mapowania nazwy skróconej określonej parametrem KRNAZWA,
znajdujący się na końcu treści nazwy znak w postaci litery C (używany tylko przez drukarki
fiskalne) jest zawsze odrzucany.
ITEMCODE=EAN
##Parametr określający źródło do mapowania numeru towaru drukowanego kodzie kresowym
jako kod towaru
UNITPRICE=CENADET
## Parametr określający źródło do mapowania wartości ceny jednostkowej.
Uwaga: Znak kropki oddzielający cyfry złotówek od cyfr groszy jest pomijany.
SELLDATE=SPOZYC_DO
## Parametr określający źródło do mapowania określenia terminu trwałości (ilość dni). W wersji
BIZcas 2.0 (Beta) funkcja ta jest jeszcze nieczynna.
SKLAD=SKLADNIKI
## Parametr określający źródło do mapowania treści opisu składu. Uwaga: Dane będą wysyłane
do poszczególnych wag jako bezpośrednie, albo jako pośrednie z wykorzystaniem z podprogramu
realizującego wysyłkę opisów pośrednich, zgodnie z konfiguracją parametru [WAGA_OPISY].
W wersji BIZcas 2.0 (Beta) funkcja ta jest jeszcze nieczynna.
PUSTY=PLU
## Dane źródłowe nie wykorzystane do mapowania w całości. Mapowana jest część znaków
określona parametrem [MAPOWANIE].
PUSTY =TYP
## Dane źródłowe nie wykorzystane.
PLUTYPE =TYP_KODU_WAGOWEGO
## Parametr określający źródło do mapowania typu towaru. Dostępne są nast. typy towarów: 1 Ważony, 2 - Sztukowy, 3 - W opakowaniach zbiorczych.
LABEL1=TYP_KODU_WAGOWEGO
## Parametr określający źródło do mapowania numeru wzorca etykiety.
BARCODE1=TYP_KODU_WAGOWEGO
## Parametr określający źródło do mapowania numeru wzorca kodu kreskowego.
PUSTY=TOWAR_WAZONY
## Dane źródłowe nie wykorzystane.
PUSTY=JM_MIARY
## Dane źródłowe nie wykorzystane.
PUSTY=GR_INDEX
## Dane źródłowe nie wykorzystane.
[KOMUNIKACJA]
TYP=TCPIP
##Parametr określający sposób komunikacji wagami
[WAGA_NUMER_IP]
1=172.168.7.33
2=172.168.7.34
3=172.168.7.35
## Parametr określający adresy IP poszczególnych wag, odpowiednio:
1- Dla wagi nr1, 2 - Dla wagi nr2 itd. (Powyżej przykładowe adresy wag)
[WAGA_NUMER_PORT]
1=20304
2=20304
3=20304
## Parametr określający numery portów komunikacyjnych poszczególnych wag, odpowiednio:
1- Dla wagi nr1, 2 - Dla wagi nr2 itd. (Nr portu: 20304 jest ustawieniem domyślnym stosowanym
w wagach CAS z linii produktowych CL5000Junior/CL5000/C5500D/CL5200)
[WAGA_TYP_WAGI]
1=CL
2=CL
3=CL
## Parametr określający typ wagi odpowiednio: 1- Dla wagi nr1, 2 - Dla wagi nr2 itd...
[WAGA_RODZAJ_WAGI]
1=CL5000
2=CL5000JR
3=CL5000
## Parametry określające rodzaj wagi (model), dla poszczególnych wag w systemie,
odpowiednio: 1- Dla wagi nr1, 2 - Dla wagi nr2 itd...
Ustawienie: CL5000 jest stosowane dla wag z linii produktowej CL5000, CL5500D i CL5200.
Ustawienie: C5000JR – jest stosowane dla wag z linii produktowej CL5000Junior.
[WAGA_OPISY]
1=P;999;510;T;
2=B;1000;300;T;N
3=P;499;1022;N;T
## Parametry określające rodzaj, ilość i długość opisu składu dostępną dla danej wagi,
odpowiednio: 1- Dla wagi nr1, 2 - Dla wagi nr2 itd...
W wersji BIZcas 2.0 (Beta) funkcja ta jest jeszcze nieczynna.
3. Konfiguracja wag CL5500
Poniżej przedstawiono zmiany w stosunku do standardowej konfiguracji wag stosowanej
dotychczas.
Z uwagi na możliwość obsługi towarów ważonych oraz sztukowych, konieczne jest następujące
zaprogramowanie wagi:
a. Wzorce kodu kreskowego
Należy zaprogramować trzy wzorce kodu kreskowego, dla poszczególnych rodzajów towarów:
ważonego (1), sprzedawanego na sztuki (2), sprzedawanego w opakowaniu zbiorczym (3).
Dla towarów sztukowych i w opakowaniu zbiorczym, proponujemy zaprogramowanie wzorców
o strukturze zbliżonej do kodów wagowych, w których ilość sztuk oznaczona literami „Q” będzie
prezentowana, na miejscu pełnych kilogramów, jak na ilustracji poniżej.
b. Wzorzec etykiety
We wzorcu etykiety należy dodać pole (fkg) nr 112 - ILOŚĆ w którym będzie drukowana wartość
ilości szt. Pole to należy umieścić we wzorcu etykiety, nakładając je na polu wskazania masy.
Zmiana treści w polu opisowym (fx) nr 172 - MASA/ILOŚĆ będzie odbywać się automatycznie,
w zależności od rodzaju sprzedawanego towaru, dlatego tu nie trzeba wprowadzać zmian.
4. Działanie programu BIZcas
Program sprawdza katalog KATALOG_BIZERBA i okresowo kontroluje, czy znajdują się w nim pliki
o rozszerzeniu .1wa.
Parametr INTERWAL określa w sekundach, co jaki czas katalog jest sprawdzany.
Jeżeli plik w katalogu istnieje, wtedy program konwertuje go na kodowanie UTF8 tak aby móc
poprawnie zaczytać zawartość pliku. Następnie tworzy plik out.xml, który jest przekazywany do
programu CAScale, znajdujący się w ścieżce: KATALOG_CAS.
Parametr KASOWANIE, określa czy plik należy skasować po wysyłce.
Jeżeli jest parametr ustawiony na 0, wtedy plik nie jest kasowany i do rozszerzenia jego nazwy
na koniec dodawany jest string "_sent", tak aby przy ponownym sprawdzaniu katalogu ten plik
nie został wysłany ponownie.
Sekcja MAPOWANIE odpowiada za odczyt danych z poszczególnych pól z pliku .1wa do XMLa.
BIZcas na tę chwilę jest aplikacją Windows, a nie usługą Windows.
Usługa działa trochę na innej zasadzie (działa nawet wtedy kiedy użytkownik nie jest zalogowany
do systemu) i nie ma możliwości z poziomu usługi włączenia aplikacji okienkowej jaką jest
CASCALE.
Propozycja informatyka piszącego program, to opakowanie programu w taki sposób, aby
uruchamiał się przy włączeniu komputera w formie zminimalizowanej do zasobnika
systemowego (ikony obok zegara). Można wtedy zrobić prosty interfejs który pokazuje co
zostało wysłane, jakie były błędy itp.
Prosimy o przekazanie uwag, dotyczących powyższej kwestii.
5. Uruchomienie programu BIZcas i wysyłka danych
BIZAcas2 nie jest w obecnej chwili aplikacją okienkową, ponieważ jest napisany tak, aby działać
w tle. Z tego powodu po włączeniu aplikacji BIZcas2.exe, informacja, że jest ona uruchomiona
będzie znajdować się w menadżerze zadań.
Informacja o błędach powodujących brak możliwości przetwarzania pliku źródłowego jest
zapisywana w pliku tekstowym bizcas2.log.
Uwaga:
Przyczyną powodującą brak możliwości przetwarzania pliku źródłowego, która wystąpiła
w przypadku przetwarzania dostarczonych plików testowych było użycie w treści opisu nazwy
towaru znaku &.
Prosimy o nie używanie w treści opisów nazw towarów, znaków stosowanych w składni
plików tekstowych xml.
Po włączeniu aplikacji BIZcas2.exe zawartość katalogu z danymi źródłowymi jest cyklicznie
sprawdzana. W przypadku pojawienia się pliku źródłowego z danymi jest on przetwarzany,
i zawarte w nim dane są wysyłane do wag zdefiniowanych w pliku bizcas.ini.
W razie celu udzielenia dodatkowych wyjaśnień lub przekazania uwag prosimy po kontakt:
Paweł Krajewski
Product Manager
Tel. 22 255 90 00, Tel. Kom. 607 190 174
e-mail: [email protected];