Struktura plików synchronizacyjnych z bazy mobilnej

Sekcja informacyjna (INFOBLOK)

Tabela 1 Sekcja informacyjna i odpowiednik pól w tabelach bazy ERP XL

Kontrahenci (KNTI)

Tabela 2 Sekcja z kontrahentami i odpowiednik pól w tabelach bazy ERP XL

Adresy kontrahenta (KNAI)

Tabela 3 Sekcja z adresami kontrahenta i odpowiednik pól w tabelach bazy ERP XL

Osoby kontrahenta (KNSI)

Tabela 4 Sekcja z osobami kontrahenta i odpowiednik pól w tabelach bazy ERP XL

Atrybuty kontrahenta (ATRI*)

Tabela 5 Sekcja z atrybutami kontrahenta i odpowiednik pól w tabelach bazy ERP XL

Załączniki kontrahenta (DABI*)

Tabela 6 Sekcja z załącznikami kontrahenta i odpowiednik pól w tabelach bazy ERP XL

Zamówienia (ZANI)

Tabela 7 Sekcja z zamówieniami i odpowiednik pól w tabelach bazy ERP XL

Elementy zamówienia (ZAEI)

Tabela 8 Sekcja z elementami zamówienia i odpowiednik pól w tabelach bazy ERP XL

Dokumenty handlowe (TRNI)

Tabela 9 Sekcja z dokumentami handlowymi i odpowiednik pól w tabelach bazy ERP XL

Elementy dokumentu handlowego (TREI)

Tabela 10 Sekcja z elementami dokumentu handlowego i odpowiednik pól w tabelach bazy ERP XL

Dokumenty magazynowe (MANI)

Tabela 11 Sekcja z dokumentami magazynowymi i odpowiednik pól w tabelach bazy ERP XL

Element dokumentu magazynowego (MAE)

Tabela 12 Sekcja z elementem dokumentu magazynowego i odpowiednik pól w tabelach bazy ERP XL

Subelement elementu dokumentu magazynowego (MAS)

Tabela 13 Sekcja z subelementem dokumentu magazynowego i odpowiednik pól w tabelach bazy ERP XL

Reklamacje (RLNI)

Tabela 14 Sekcja z reklamacjami i odpowiednik pól w tabelach bazy ERP XL

Elementy reklamacji (RLEI)

Tabela 15 Sekcja z elementami reklamacji i odpowiednik pól w tabelach bazy ERP XL

Wizyty Handlowe (CWNI)

Tabela 16 Sekcja z wizytami handlowymi i odpowiednik pól w tabelach bazy ERP XL

Element wizyty handlowej (CWE)

Tabela 17 Sekcja z elementem wizyty handlowej i odpowiednik pól w tabelach bazy ERP XL

sekcja zwracająca obiekty dla wizyty, jak np. Załączniki (CWOI)

Dokument powiązany z elementem wizyty (CDL)

Tabela 18 Sekcja z dokumentem powiązanym z elementem wizyty i odpowiednik pól w tabelach bazy ERP XL

Raporty (KRPI)

Tabela 19 Sekcja z raportami kasowymi i odpowiednik pól w tabelach bazy ERP XL

Zapisy kasowe/bankowe (KAZI)

Tabela 20 Sekcja z zapisami kasowymi i odpowiednik pól w tabelach bazy ERP XL

Rozliczenia (ROZI)

Tabela 21 Sekcja z rozliczeniami i odpowiednik pól w tabelach bazy ERP XL

Spis treści

Informacje ogólne

Sprzedaż

Zamówienia

SAD

Zakończenie

 

Informacje ogólne

Testy integralności z zakresu modułu: Logistyka, służą do monitorowania poprawności, spójności, przejrzystości bazy pod kątem danych logistycznych, do koordynowania prawidłowości relacji między odpowiednimi tabelami. W przypadku istniejących nieprawidłowości, testy zgłaszają w logu błędy, ostrzeżenia i zwracają rekordy, będące efektem błędogennej sytuacji w bazie, bądź będące skutkiem czynności wykonywanych przez Użytkownika w sposób niepoprawny (powodujących zaburzenia w utrzymaniu spójności danych).

Poniższy rysunek przedstawia listę dostępnych standardowych testów integralności z logistyki

Poza wymienionymi, istnieje również możliwość definiowania odpowiednich testów, w zależności od potrzeb Użytkownika, przy wykorzystaniu wyrażenia SQL (zakładka: Testy definiowane).

Ponadto, można określić zakres czasowy, dla którego będzie wykonywany test i tym samym otrzymania wyników odnoszących się właśnie dla tego przedziału czasowego. Takich ustawień, jak również parametryzacji zapuszczanych testów integralności związanych np. z poziomem szczegółowości loga, dokonuje się na zakładce: Ogólne, okna: Testy integralności.

Celem niniejszego biuletynu jest analiza testów integralności oscylujących wokół zagadnień logistycznych, w kontekście zwracanych przez test typowych błędnych rekordów. Skoncentrowano się głównie na propozycjach napraw, potencjalnie mogących wystąpić, niepoprawnych zdarzeń w bazie. Omówiono testy z grupy:

• Poprawność danych kart kontrahentów i towarów
• Zgodność magazynu
• Zgodność transakcji
• Zgodność dostaw
• Zgodność inwentaryzacji

Sprzedaż

Poprawność danych kontrahentów

Sprawdza poprawność danych kart kontrahentów. Obejmuje też poprawność adresów kontrahentów

(tabele cdn.KntKarty, cdn.KntAdresy).

Porównywane są pola:

Knt_GIDNumer, KnA_KntNumer

Pojawiające się komunikaty:

Poprawność danych grup kontrahentów

Sprawdza poprawność grup kontrahentów (tabela cdn.KntGrupy).

Pojawiające się komunikaty:

Poprawność danych towarów

Sprawdza poprawność danych kart towarowych (tabela cdn.TwrKarty).

Pojawiające się komunikaty:

Poprawność danych grup towarów

Sprawdza poprawność zapisanych w bazie informacji o grupach towarów (tabela cdn.TwrGrupy).

Pojawiające się komunikaty:

Poprawność zamknięcia dokumentów VAT

Sprawdzana jest poprawność stanu zapisanych w bazie dokumentów (tabela cdn.TraNag).

Pojawiające się komunikaty:

Sprawdzenie duplikacji kodów EAN

Sprawdzana jest unikalność zapisanych w bazie kodów EAN (tabele cdn.TwrKarty, cdn.TwrZasoby, cdn.Dostawy, cdn.TwrJM)

Porównywane są pola:

Twr_Ean, TwZ_Ean, Dst_Ean, TwJ_EAN

Pojawiające się komunikaty:

Należy też sprawdzić czy w: Konfiguracja->Sprzedaż->Kody EAN zaznaczona jest opcja Kontroluj unikalność numerów EAN. Po jej zaznaczeniu program będzie automatycznie pilnował unikalności wprowadzanych kodów EAN.

Zgodność magazynu

Zgodność kosztów księgowego i rzeczywistego oraz stanu handlowego

Sprawdzana jest zgodność kosztu księgowego i rzeczywistego oraz stanu handlowego zapisanego na elemencie i subelemencie dokumentu (tabela cdn.TraSElem, cdn.TraElem).

Porównywane są pola:

TrS_ilość, TrE_KosztKsiegowy, TrE_KosztRzeczywisty, TrS_Ilość, TrS_KosztKsiegowy, TrS_KosztRzeczywisty.

Pojawiające się komunikaty:

Poprawa błędów może się odbyć przy użyciu funkcji „Naprawa stanów towarów”, może się jednakokazać, że poprawa będzie się musiała odbyć z poziomu bazy.

Zgodność stanu magazynowego

Sprawdzana jest ilość zapisana na dokumencie magazynowym oraz zasobie. (tabele cdn.TwrZasoby, cdn.MagSElem)

Porównywane są pola:

TwZ_Ilmag, MaS_Ilosc

Pojawiające się komunikaty:

Należy uruchomić funkcję specjalną Naprawa stanów towarów. Może się jednak okazać, że konieczna będzie poprawa z poziomu bazy.

Zgodność ilości i kosztów w elementach transakcji z wartościami w subelementach

Zgodność w transakcjach rozchodowych

Sprawdzana jest zgodność kosztu księgowego i rzeczywistego oraz stanu handlowego zapisanego na elemencie i subelemencie dokumentów rozchodowych (tabele cdn.TraElem, cdn.Traselem).

Porównywane są pola:

TrE_Ilosc, TrE_KosztKsiegowy, TrE_KosztRzeczywisty, TrS_IloscP, TrS_IloscR, TrS_KosztKsiegowyP, TrS_KosztRzeczywistyP, TrS_KosztKsiegowyR, TrS_KosztRzeczywistyR, TrN_Stan, TrN_NettoP, TrN_NettoR

Pojawiające się komunikaty:

• Niezgodność, ilość w elemencie ilość w subelementach – niezgodność ilości towaru zapisanej na pozycji dokumentu oraz na subelemencie dokumentu.
• Niezgodność, koszt rzeczywisty różnica w elemencie koszt w subelementach - niezgodność kosztu rzeczywistego zapisanego na pozycji dokumentu oraz na subelemencie dokumentu.
• Niezgodność, koszt księgowy rozchodu w elemencie koszt w subelementach - niezgodność kosztu księgowego zapisanego na pozycji dokumentu oraz na subelemencie dokumentu.

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność w transakcjach przychodowych

Sprawdzana jest zgodność kosztu księgowego i rzeczywistego oraz stanu handlowego zapisanego na elemencie i subelemencie dokumentów przychodowych (tabele cdn.TraElem, cdn.Traselem).

Porównywane są pola:

TrE_Ilosc, TrE_KosztKsiegowy, TrE_KosztRzeczywisty, TrS_IloscP, TrS_IloscR, TrS_KosztKsiegowyP, TrS_KosztRzeczywistyP, TrS_KosztKsiegowyR, TrS_KosztRzeczywistyR, TrN_Stan, TrN_NettoP, TrN_NettoR

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność w transakcjach międzymagazynowych

Sprawdzana jest zgodność kosztu księgowego i rzeczywistego zapisanego na elemencie i subelemencie dokumentów przychodowych (tabele cdn.TraElem, cdn.Traselem).

Porównywane są pola:

TrE_KosztKsiegowy, TrE_KosztRzeczywisty, TrS_KosztKsiegowyP, TrS_KosztRzeczywistyP, TrS_KosztKsiegowyR, TrS_KosztRzeczywistyR, TrN_Stan, TrN_NettoP, TrN_NettoR

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność transakcji

Zgodność ilości dostępnej na zasobie z ilościami wynikającymi z dokumentów

Sprawdzana jest zgodność ilości dostępnej na zasobie oraz wynikająca z dokumentów zarejestrowanych w programie (Tabele cdn.TwrZasoby, cdn.TraSElem, cdn.MagSElem).

Porównywane są pola:

Trs_ilosc, Mas_ilosc, Twz_ilosc

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność nagłówka z tabelą VAT, poprawny rejestr VAT

Sprawdza zgodność zapisanej informacji o wartości VAT na nagłówku i tabeli VAT dla dokumentów (tabele cdn.TraNag, cdn.TraVat).

Porównywane są pola:

TrN_NettoP, TrV_NettoP, TrN_NettoR, TrV_NettoR, TrN_VatP, TrV_VatP, TrN_VatR, TrV_VatR, TrN_VatRejestr, TrN_VatTyp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność nagłówka z pozycjami dokumentu

Test zgodności danych zapisanych na pozycjach dokumentu i nagłówkiem (tabele cdn.TraNag, cdn.TraElem).

Porównywane są pola:

TrN_WartoscWal, TrE_WartoscPoRabacie, TrE_KsiegowaNetto, TrE_KsiegowaBrutto,

TrN_NettoP, TrN_NettoR, TrN_VatP, TrN_VatR

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność daty pomiędzy nagłówkiem i pozycjami

Test zgodności dat zapisanych na pozycjach dokumentu i nagłówkiem (tabele cdn.TraNag, cdn.TraElem).

Porównywane są pola:

TrN_DataMag , TrN_Data3, TrE_TrnTStamp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność z płatnościami

Test zgodności danych o płatnościach zapisanych na dokumencie i w tabeli Płatności (tabele cdn.TraNag, cdn.TraPlat).

Porównywane są pola:

TrN_WartoscWal, TrN_VatR, TrN_KursM, TrN_KursL, TrN_NettoP, TrN_VatP

TrP_Kwota, TrP_KursM, TrP_KursL

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność kontrahenta z nagłówka z kontrahentem na płatności

Test zgodności danych o kontrahencie zapisanych na dokumencie i w tabeli Płatności (tabele cdn.TraNag, cdn.TraPlat).

Porównywane są pola:

trp_kntnumer, trn_knpnumer

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Poprawność płatności do spinaczy

Sprawdza czy dla płatności zapisanej w bazie istnieje spinacz który jest nią rozliczony (tabela TraPlat).

Porównywane są pola:

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Poprawność nagłówków spinaczy

Sprawdzana jest poprawność nagłówków spinaczy (tabela cdn.TraNag).

Porównywane są pola:

TrN_GID, TrN_SpiGID

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność magazynów w przesunięciach magazynowych

Sprawdzana jest zgodność magazynów na dokumentach przesunięć międzymagazynowych zapisanych na nagłówku dokumentu i na subelementach (Tabele cdn.TraNag, cdn.TraSElem).

Porównywane są pola:

TrS_MagGID, TrN_MagZGID, TrN_MagDGID

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Poprawność wystawienia transakcji z kontrahentem jednorazowym

Sprawdzana jest poprawność transakcji z kontrahentem Jednorazowym (tabela cdn.TraNag).

Porównywane są pola:

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność wartości TrE_RzeczywistaNetto, TrE_KsiegowaNetto na dokumentach pochodzących z zamówień

Sprawdzana jest zgodność wartości rzeczywistej netto oraz wartości księgowej netto zapisanej na dokumencie handlowym pochodzącym z zamówienia oraz na zamówieniu (tabele cdn.TraNag, cdn.TraElem)

Porównywane są pola:

TrE_KsiegowaNetto, TrE_ RzeczywistaNetto

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Sprawdzenie równania Ilość*Cena = Wartość

Sprawdzana jest poprawność wyliczonej wartości na dokumentach handlowych (tabela cdn.TraElem).

Porównywane są pola:

TrE_Cena, TrE_Ilosc, TrE_KsiegowaNetto, TrE_KsiegowaBrutto

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność dat transakcji

Transakcje z datą wyprzedzające

Sprawdzana jest poprawność dat zapisanych na pozycjach dokumentów (Tabela cdn.TraELem).

Porównywane są pola:

TrE_TrnTStamp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Transakcje z data wsteczną (antydatowane)

Sprawdzana jest poprawność dat zapisanych na pozycjach dokumentów (Tabela cdn.TraELem).

Porównywane są pola:

TrE_TrnTStamp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Transakcje przyjęcia przed datą dostawy

Sprawdzana jest poprawność dat zapisanych na nagłówkach dokumentów przychodowych oraz na związanych z nimi dostawach(tabele cdn.TraSElem, cdn.TwrDostawy)

Porównywane są pola:

TrS_TrNTStamp, Dst_DstTStamp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Transakcje rozchodu przed datą dostawy

Sprawdzana jest poprawność dat zapisanych na nagłówkach dokumentów rozchodowych oraz na związanych z nimi dostawach (tabele TraSElem, TwrDostawy).

Porównywane są pola:

TrS_TrNTStamp, Dst_DstTStamp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Korekty wystawione przed datą oryginału

Sprawdzana jest poprawność dat na oryginale dokumentu oraz na korekcie z nim związanym (tabele cdn.TraNag, cdn.TraSElem).

Porównywane są pola:

TrS_TrNTStamp, TrN_DataMag

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność transakcji magazynowych z handlowymi

Zgodność ilości dostawy i magazynu

Sprawdzana jest ilość towaru wynikająca z zapisów na dostawie oraz na dokumentach magazynowych (tabel cdn.TraSElem, cdn.MagSElem).

Porównywane są pola:

TrS_Ilosc, Mas_Ilosc, mas_dsttyp, mas_dstnumer, trs_dsttyp, trs_dstnumer, mas_magtyp, mas_magnumer, trs_magtyp, trs_magnumer

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Sprawdzenie istnienia transakcji handlowej dla transakcji magazynowej

Sprawdzane jest czy dla dokumentów magazynowych które powinny zawierać dokumenty handlowe, istnieją poprawnie wygenerowane dokumenty (tabele cdn.MagSElem, cdn.TraSElem).

Porównywane są pola:

TrS_GIDTyp, TrS_GIDFirma , TrS_GIDNumer, TrS_GIDLp, Mas_ZrdTyp , Mas_ZrdFirma, Mas_ZrdNumer, Mas_ZrdLp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność transakcji magazynowych z zamówieniami

Zgodność ilości zamówienia i magazynu

Sprawdzana jest zgodność ilości zapisana na elemencie zamówienia oraz na powiązanych z nimi dokumentach magazynowych (tabele cdn.MagSElem, cdn.ZamElem).

Porównywane są pola:

MaS_Ilosc, ZaE_Ilosc

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność dostaw

Zgodność kosztu księgowego i rzeczywistego z wartością na transakcjach zakładających

Sprawdzana jest zgodność kosztu księgowego oraz rzeczywistego pomiędzy dostawami oraz pozycjami dokumentów. (tabele cdn.TraSElem, CDN.twrdostawy).

Porównywane są pola:

TrS_KosztKsiegowy, TrS_KosztRzeczywisty, Dst_KsiegowaNetto, Dst_RzeczywistaNetto

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Istnienie dokumentów zakładających dostawy

(tabele cdn.TraSElem, cdn.TwrDostawy, CDN.ImpElem)

Porównywane są pola:

Trs_TrnTyp, Trs_TrnFirma, Trs_TrnNumer, Trs_TrnLp, Trs_SubGIDLp, ImE_GIDNumer, mas_gidfirma, mas_gidnumer, mas_gidtyp, mas_gidlp, mas_subgidlp

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność inwentaryzacji

Istnienie dokumentów PW i RW inwentaryzacyjnych

Sprawdzane jest czy dla dokumentu inwentaryzacyjnego (z którego wynikają różnice w ilości towaru na magazynie) zostały wygenerowane dokumenty PW i RW (tabele cdn.InwNag, cdn.TraNag)

Porównywane są pola:

InN_RWTyp, Inn_RWNumer, InN_PWTyp, Inn_PWNumer, Trn_GIDTyp, TrN_GIDNumer

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność ilości na arkuszach i dokumentach PW i RW inwentaryzacyjnych

Sprawdzane jest czy dla dokumentu inwentaryzacyjnego (z którego wynikają różnice w ilości towaru na magazynie) zostały poprawnie wygenerowane dokumenty PW i RW (tabele cdn.InwTwr, cdn.InwArkTwr, CDN.TraSElem).

Porównywane są pola:

INT_iloscmag, IAT_iloscinw, TrS_ilosc

Pojawiające się komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zamówienia

Zgodność rezerwacji dla zamówienia

Sprawdzane są założone rezerwacje na zamawianych towarach.

Tabele biorące udział w analizie:

cdn.Rezerwacje, cdn.ZamNag, cdn.ZamElem, cdn.TraNag, cdn.TraElem, cdn.TraSElem, cdn.MagNag, cdn.MagSElem, cdn.SadElem

Pojawiające się komunikaty:

Dokument ma ustawioną flagę Aktywny- zamówienie posiada ustawioną flagę Aktywny.

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność pozycji zamówienia z tabelą VAT

Sprawdzane jest czy nagłówek na zamówieniu (cdn.Zamnag) jest zgodny z tabelą VAT (cdn.ZamVat).

Tabele biorące udział w analizie:

cdn.ZamNag, cdn.ZamVat, cdn.ZamElem

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność relacji stan-typ zamówienia

Sprawdzenie poprawności stanu zamówienia w zależności od jego typu.

Tabele biorące udział w analizie:

cdn.ZamNag

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Poprawność zamówień wewnętrznych

Sprawdzanie poprawności statusu zamówienia wewnętrznego z wystawionymi do niego dokumentami handlowymi. Jeśli do zamówienia istnieją wystawione dokumenty handlowe inne niż MMW wykazywany jest błąd.

Tabele biorące udział w analizie:

cdn.ZamNag, cdn.TraNag, cdn.ImpNag, cdn.MagNag

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność ilości dla zrealizowanego zamówienia wewnętrznego

Sprawdzenie dla stanu zrealizowany, czy pokrywa się ilość towaru na takim dokumencie z sumą ilości na MMW wystawionych z niego.

Tabele biorące udział w analizie:

cdn.ZamNag, cdn.ZamElem, cdn.TraNag, cdn.TraElem

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Sprawdzenie poprawności wypełnienia nowych pól

Sprawdzenie poprawności nowo dodanych pól po wykonaniu konwersji bazy danych.

Tabele biorące udział w analizie:

cdn.ZamNag, cdn.Rezerwacje

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

SAD

Zgodność wartości dostawy SAD/FWS z FAI

Sprawdzenie dla każdej pozycji SAD czy suma kwot wartości dostawy dla tej pozycji jest równa wartości pozycji FAI, z której pochodzi.

Tabele biorące udział w analizie:

cdn.ImpNag, cdn.ImpElem, cdn.SadNag, cdn.SadElem, cdn.SadSElem

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność VAT’u dla dokumentów SAD

Sprawdzenie, czy suma podstawy VATu z kwot elementów SADu jest równa wartości netto z tabeli VAT (grupowanie po poszczególnych stawkach VAT), natomiast suma kwot VAT z elementów równa wartości VAT z tabeli VAT.

Tabele biorące udział w analizie:

cdn.SadNag, cdn.SeSKwoty, cdn.TraVat

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność kwot na dokumentach SAD/FWS

Sprawdzenie, czy poszczególne kwoty w nagłówku SADu są równe sumom kwot elementów.

Tabele biorące udział w analizie:

cdn.SadNag, cdn.SadKwoty, cdn.SaEKwoty

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zgodność wartości FAI z płatnościami

Sprawdzenie, czy suma wszystkich pozycji FAI równa się sumie płatności tego dokumentu.

Tabele biorące udział w analizie:

cdn.ImpNag, cdn.ImpElem, cdn.TraPlat

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Sprawdzenie ilości na dostawach dla faktur importowych

Sprawdzana jest zgodność pomiędzy Dostawami, a elementami Faktury importowej.

Tabele biorące udział w analizie:

cdn.ImpNag, cdn.ImpElem, cdn.Dostawy

Możliwe komunikaty:

Poprawa niezgodności wymaga interwencji z poziomu bazy.

Zakończenie

Systematyczne koordynowanie spójności bazy danych stanowi podstawowy warunek utrzymania poprawności danych. Testy integralności są kluczowym narzędziem pomocnym w analizie problemów zaburzających prawidłowość danych, dlatego Użytkownik Systemu powinien być świadomy faktu, że regularne ich uruchamianie i natychmiastowa reakcja na występujące problemy stanowią podstawę otrzymania rzetelnego obrazu transakcji handlowych.

Wykorzystanie parametrów dynamicznych

Parametry dynamiczne to zmienne, zdefiniowane przez Użytkownika, wykorzystywane w trakcie pracy z programem poprzez ich wstawienie w definicje zmiennych. W zależności od rodzaju tekstu, którym definiowane są parametry istnieją parametry dynamiczne:

Składnia parametrów dynamicznych

Uwagi ogólne

Ogólna składnia parametru dynamicznego jest następująca:

?@[H]Picture[(_Q|_NQ)]|[Nazwa|]Prompt:Default[@?]                                        (PD)

albo

?@EOL                                                                                                                         (PD)

albo

?@ABC(‘Tekst’)                                                                                                            (PD)

gdzie:

@[H]Picture – format parametru. Jeśli w formacie zostanie użyty opcjonalny przełącznik ukrycia parametru (H), wówczas kontrolka odpowiadająca parametrowi nie jest kreowana, a wartość parametru pozostaje stała (dziedziczona lub Default – owa). Przełącznik ukrycia parametru H jest dostępny zawsze dla wszystkich formatów (dla uproszczenia – w dokumencie będzie on pomijany).

Dostępne formaty

@X – check

@O(RadioPrompt:RadioValue{[|RadioPrompt:RadioValue]…}) – option

@LsXXX(Biblioteka.dll|CallLookupFunkcjaU[(ParametryCallLookupFunkcjaU)]) lub

@LnXXX(Biblioteka.dll|CallLookupFunkcjaU[(ParametryCallLookupFunkcjaU)]) – lookup

@R(Zapytanie)

Elementy składni

Opcjonalna sekwencja zakończenia parametru: @?

W przypadku braku sekwencji zakończenia parametru (@?) należało przyjąć jakieś inne kryterium zakończenia. Kryterium to jest następujące:

Jako koniec parametru dynamicznego w przypadku braku sekwencji zakończenia przyjmujemy:

Spacja; ‘)’; ‘}’; ‘+’; ‘-‘; ‘*’; ‘/’; ‘,’; ‘%’; ‘=’; ‘|’; ‘<13,10>’,                                                   (SZ 1)

znalezionych po rozpoczęciu Default-u i niewystępujących wewnątrz literału stringowego (‘…’) albo w przypadku braku takiego wystąpienia:

Modyfikatory otaczania apostrofami _Q i _NQ

Wymuszają otaczanie (_Q) lub nieotaczanie (_NQ) wstawianej wartości parametru apostrofami.

Jeśli parametr jest stringowy (@Picture=@S…) – jego wartość przy wstawianiu zostaje domyślnie otoczona apostrofami. Chcąc z tego zrezygnować używamy modyfikatora _NQ (użycie w tym przypadku modyfikatora _Q jest ignorowane).

Jeśli parametr jest niestringowy (@Picture<>@S…) – jego wartość przy wstawianiu nie zostaje domyślnie otoczona apostrofami. Chcąc wymusić otoczenie apostrofami takiego parametru używamy modyfikatora _Q (użycie w tym przypadku modyfikatora _NQ jest ignorowane).

Wstawianie pustych linii pomiędzy parametrami

Jeśli chcemy wstawić linię przerwy pomiędzy kontrolkami parametrów – można w tym celu zadeklarować pomiędzy nimi specjalny, ukryty parametr (może być to również parametr, który nie będzie nigdzie indziej używany). Ukrycie należy wprowadzić wykorzystując deklarację parametru z opcją ukrycia @H[IDE]. Opcja ukrycia powinna być w tym przypadku bezparametrowa (@HIDE()) lub zawierać wyrażenie ewaluujące się zawsze do prawdy (np. @HIDE(1=1)).

Powyższe rozwiązanie ma wadę w postaci pojawiania się na moment kontrolki parametru a także ze względu na konieczność wpisywania członów składni, które nigdzie nie są wykorzystywane.

Wobec powyższego rozwiązanie to należy traktować jako przestarzałe.

Aby łatwo wstawić pustą linię, należy zastosować drugi wariant składni (PD), a więc: ?@EOL, jak w przykładzie 3:

Powtarzanie parametrów w tekście

Jeśli w tekście mamy kilka wystąpień parametru o takiej samej nazwie – wszystkie one generują jeden, wspólny parametr (wiązanie po nazwie), którego wartość za każdym razem jest wstawiana we wszystkie miejsca definicji tego parametru. Wartość domyślna parametru jest zczytywana z pierwszego wystąpienia.

Wobec powyższego powtarzanie pełnej definicji parametru w tekście jest zbyteczne. Aby uprościć wstawianie w kilku miejscach tego samego parametru została zaimplementowana składnia tzw. odwołań skróconych.

Zagnieżdżanie parametrów

Niedopuszczalne.

Typy parametrów

Każdy parametr ma określony typ. O typie decyduje człon: Picture, definicji parametru. W zależności od typu dla parametru, kreowana jest jedna lub więcej kontrolek, których ustawienia są standardowe (generyczne). Ustawienia te można zmienić, używając odpowiednich opcji w deklaracji parametru (poza obrębem jego definicji).

Typ stringowy S (typ standardowy CW)

Składnia

?@[H]S… – gdzie: …, oznacza odpowiedni fragment każdego clarionowego członu: Picture, odpowiedniego typu.

Kontrolki

PROMPT + ENTRY

Atrybuty standardowe:

Rozwinięcie

Wartość otoczona apostrofami (lub nieotoczona apostrofami, jeśli użyto modyfikatora _NQ).

Typ numeryczny N (typ standardowy CW)

Składnia

?@[H]N… – gdzie: …, oznacza odpowiedni fragment każdego clarionowego członu: Picture, odpowiedniego typu.

Kontrolki

PROMPT + SPIN

Atrybuty standardowe dla kontrolki SPIN:

INS, RIGHT, STEP=1, RANGELOW = (9999999999999|0), RANGEHIGH=9999999999999.

Akcje standardowe kontrolki SPIN: brak.

Rozwinięcie

Wartość (dodatkowo otoczona apostrofami, jeśli użyto modyfikatora _Q).

Typ datownikowy D (typ standardowy CW)

Składnia

?@[H]D… – gdzie: …, oznacza odpowiedni fragment każdego clarionowego członu: Picture, odpowiedniego typu.

Kontrolki

PROMPT + SPIN

Atrybuty standardowe dla kontrolki SPIN:

INS, RIGHT, STEP=1, RANGELOW=Date(1,1,1900), RANGEHIGH= Date(1,1,2100).

Akcje standardowe kontrolki SPIN:

Rozwinięcie

W zależności od kontekstu:

Typ czasowy T (typ standardowy CW)

Składnia

?@[H]T… – gdzie: …, oznacza odpowiedni fragment każdego clarionowego członu: Picture, odpowiedniego typu.

Kontrolki

PROMPT + SPIN

Atrybuty standardowe dla kontrolki SPIN:

INS, RIGHT, STEP= 60*100(1 min.), RANGELOW=1 (północ), RANGEHIGH=24*3600 (północ).

Akcje standardowe kontrolki SPIN:

brak.

Rozwinięcie

W zależności od kontekstu:

Typ dataczasowy DT (typ dodatkowy)

Składnia

?@[H]DT

Wartość początkowa

Może być podana w postaci YYYY-MM-DD HH:MM:SS lub YYYYMMDDHHMMSS (bez separatorów i spacji). Można też użyć wyrażenia zawierającego zabindowane funkcje; najczęściej używanym w tym kontekście funkcjami są:

Przypadek zachodzący, gdy długość przekazanego jako pierwszy parametr ciągu znaków przekracza 4. Zwraca podaną parametrami datę i czas w postaci YYYY-MM-DD HH:MM:SS z tym, że data jest obliczana z wyrażenia: _DateExpr a dwa następne parametry są ignorowane.

Przykłady

Ustalony moment: @PAR ?@DT|dt1|Termin &ostateczny:2003-03-25 16:30:00 @? PAR@ lub

@PAR ?@DT|dt1|Termin &ostateczny:20030325163000 @?

Bieżący moment: @PAR ?@DT|dt2|&Teraz:{Now()} @? PAR@

Ustalony moment: @PAR ?@ DT|dt3|t&3:2003-03-20 18:00:00@? PAR@

Początek m-ca o 7.15: @PAR ?@DT|dtm1|&Pocz.mc.7.15:{DT({DateClwFirstDay(‘M’)}, 0, 0, 7, 15, 0)} @? PAR@

Koniec m-ca o 16.30: @PAR ?@DT|dtm2|&Kon.mc.16.30:{DT({DateClwLastDay(‘M’)}, 0, 0, 16, 30, 0)} @? PAR@

Początek roku, północ: @PAR ?@DT|dty1|&Początek roku:{DT({DateClwFirstDay(‘Y’)}, 0, 0, 0, 0, 0)} @? PAR@

Koniec roku, północ: @PAR ?@DT|dty2|&Koniec roku:{DT({DateClwLastDay(‘Y’)}, 0, 0, 0, 0, 0)} @? PAR@

15. nast. m-ca o 13.45: @PAR ?@DT|dtx|&15. nast. m-ca o 13.45:{DT({Date(Month(Today())+1, 15,

Year(Today()))}, 0, 0, 13, 45, 0)} @? PAR@

Kontrolki

PROMPT + ENTRY

Atrybuty standardowe kontrolki ENTRY:

INS, LEFT, format @P####-##-## ##:##:##P (YYYY-MM-DD HH:MM:SS), INS, RIGHT.

Akcje standardowe kontrolki ENTRY:

Rozwinięcie

W zależności od kontekstu:

jeśli wstawiamy parametr do dowolnego tekstu w XL-u albo do filtra TPS z KF lub parametrów wydruku RW w CDN Optima, albo

Typ logiczny X (typ dodatkowy)

Składnia

?@[H]X

Wartość początkowa

Jedna z wartości {0, 1}. Jeśli nie podano – zostanie podstawione 0.

Kontrolki

CHECK

Atrybuty standardowe kontrolki CHECK:

TRUEVALUE=1, FALSEVALUE=0.

Akcje standardowe kontrolki CHECK:

brak.

Rozwinięcie

Wybrana wartość TRUEVALUE lub FALSEVALUE.

Typ wyboru opcji O (typ dodatkowy)

Składnia

@O(RadioPrompt:RadioValue{[|rPrompt:rValue]…})

Wartość początkowa

Jedna z wartości: RadioValue – jeśli nie podano, żadne radio nie będzie podświetlone, chyba że któreś z nich ma przypisaną wartość zero lub pustą.

Kontrolki

OPTION{RADIO,…}

Atrybuty standardowe kontrolki OPTION:

BOXED.

Akcje standardowe kontrolki OPTION:

brak.

Rozwinięcie

Wartość wybranej opcji: rValue (dodatkowo otoczona apostrofami, jeśli użyto modyfikatora _Q).

Uwagi

Zaleca się używać list rozwijanych zamiast opcji; jest to podyktowane tym, iż kontrolka opcji zajmuje dużo miejsca na ekranie (w pionie tyle, co dwa inne parametry) i teksty radio są najczęściej obcinane z powodu braku miejsca. Customizować można tylko całą kontrolkę OPTION (zmiana właściwości kontrolek RADIO nie jest przewidywana).

Typ wyboru z listy rozwijanej R (typ dodatkowy)

Składnia

@R(Zapytanie) – gdzie Zapytanie musi być tak zbudowane, aby zwracało przynajmniej dwie kolumny. Te dwie pierwsze kolumny mogą być stringowe lub całkowite w układach Str-Int lub Int-Str; najczęściej zwracają one odpowiednio Id i Kod (albo Kod i Id) pobranych rekordów. W dropdownie wyświetlana jest kolumna stringowa, a jako wartość parametru wstawiana jest kolumna całkowita.

Zapytanie nie zawsze musi odwoływać się do jakiegokolwiek obiektu w bazie SQL; dropdowny można z powodzeniem wykorzystywać zamiast „ekranożernych” opcji, np.: @PAR ?@R(SELECT 1, ‘Radio1’ UNION SELECT 2, ‘Radio2’ UNION SELECT 3, ‘Radio3’)|DD|&DD:Radio2 @? PAR@

Wartość początkowa

Wartość jest postaci: Id|Kod.

Jeśli defaultowy Kod odpowiada istniejącemu w recordsecie rekordowi, wtedy zostanie pobrany odpowiedni Id.

Jeśli defaultowe Id odpowiada istniejącemu w recordsecie rekordowi, wtedy zostanie pobrany odpowiedni Kod.

Jeśli recordset zawiera choć jeden rekord, wtedy zostanie pobrany Kod i Id pierwszego rekordu.

Jeśli jako Kod zostanie podstawiona wartość: brak, wtedy jako Id – wartość pusta.

Kontrolki

PROMPT + DROPDOWN

Atrybuty standardowe kontrolki DROPDOWN:

DROP=5, VSCROLL, LEFT, FROM=kolejka wynikowa recordsetu Zapytania.

Akcje standardowe kontrolki DROPDOWN:

brak.

Rozwinięcie

Jeśli nie użyto modyfikatora – wstawiana jest wartość Id wybranej pozycji rValue (dodatkowo otoczona apostrofami, jeśli użyto modyfikatora _Q). Użycie modyfikatora _RES2_ powoduje wstawienie wartości pola Kod.

Typ wyboru z listy wywoływanej L – LOOKUP (typ dodatkowy)

Składnia

@L(s|n)…(Biblioteka.dll|CallLookupFunkcjaU[(ParametryCallLookupFunkcjaU)])

Typ odpowiada lookupowi do funkcji Funkcja z użyciem przesiadki CallLookupFunkcjaU z biblioteki Biblioteka.dll, która to przesiadka dostaje parametry określające typ akcji (‘INIT’|‘BUTTON’|’ENTRY’), ID (zwykłe ID, GID itp.) i kod (string określający obiekt w sposób jednoznaczny, najczęściej kod, akronim itp.) obiektu i na podstawie tych parametrów wywołuje funkcję wyświetlającą odpowiednią listę w trybie lookup a następnie zwraca wartości dotyczące wybranego przez użytkownika rekordu (szczegóły – analogicznie, jak w rozdziale Lookupy).

Wybór s|n decyduje jedynie o formie wyświetlania wartości parametru (ENTRY|SPIN).

Wartość początkowa

Jest postaci Id|Kod. Jeśli defaultowy Kod odpowiada istniejącemu w bazie rekordowi – zostanie pobrany odpowiedni Id, w przeciwnym razie zostanie wykonana próba pobrania rekordu o podanym Id. Jeśli rekord zostanie znaleziony – zostanie podstawiony odpowiedni Kod, jeśli nie – obiekt zasygnalizuje błąd (to przy inicjalizacji kontrolki parametru, natomiast przy akceptacji nieznalezionej wartości wywoła lookup).

Jeśli chcemy z aplikacji wysłać zmienną dynamiczną inicjalizującą wartość początkową parametru typu lookup to możemy, ale nie musimy użyć składni [Id]|[Kod] (z pipem). Podanie samego Id jest też poprawne (klasa wykresów w przypadku stwierdzenia braku pipe-a w wartości związanej z parametrem typu lookup doklei go na koniec wartości, a więc zainicjalizuje parametr wartością:’|Id’).

Kontrolki

PROMPTBUTTON + (ENTRY|SPIN)

Atrybuty standardowe kontrolki ENTRY/SPIN:

takie, jak dla standardowego typu stringowego/numerycznego.

Akcje standardowe kontrolki PROMPTBUTTON:

Rozwinięcie

Jeśli nie użyto modyfikatora – wstawiana jest bieżąca wartość: Id (dodatkowo otoczona apostrofami, jeśli użyto modyfikatora _Q). Użycie modyfikatora _RES2_ powoduje wstawienie wartości pola Kod.

Typ wyboru pliku lub katalogu F – FILE(DIR)DIALOG (typ dodatkowy)

Składnia

@Fs…(F[ile]|D[irectory]][,[O[pen]|S[ave]][,Maski][,MaskaDomyslna][,Flagi])

Typ odpowiada dialogowi systemowemu pozwalającemu wybrać plik lub katalog.

Kontrolki

PROMPTBUTTON + ENTRY – gdzie znaczenie opcjonalnych atrybutów jest następujące:

OFN_ALLOWMULTISELECT EQUATE(00000200h)

OFN_CREATEPROMPT EQUATE(00002000h)

OFN_ENABLEHOOK EQUATE(00000020h)

OFN_ENABLETEMPLATE EQUATE(00000040h)

OFN_ENABLETEMPLATEHANDLE EQUATE(00000080h)

OFN_EXPLORER EQUATE(00080000h)

OFN_EXTENSIONDIFFERENT EQUATE(00000400h)

OFN_FILEMUSTEXIST EQUATE(00001000h)

OFN_HIDEREADONLY EQUATE(00000004h)

OFN_LONGNAMES EQUATE(00200000h)

OFN_NOCHANGEDIR EQUATE(00000008h)

OFN_NODEREFERENCELINKS EQUATE(00100000h)

OFN_NOLONGNAMES EQUATE(00040000h)

OFN_NONETWORKBUTTON EQUATE(00020000h)

OFN_NOREADONLYRETURN EQUATE(00008000h)

OFN_NOTESTFILECREATE EQUATE(00010000h)

OFN_NOVALIDATE EQUATE(00000100h)

OFN_OVERWRITEPROMPT EQUATE(00000002h)

OFN_PATHMUSTEXIST EQUATE(00000800h)

OFN_SHOWHELP EQUATE(00000010h)

OFN_SHAREAWARE EQUATE(00004000h)

OFN_SHAREFALLTHROUGH EQUATE(2)

OFN_SHARENOWARN EQUATE(1)

OFN_SHAREWARN EQUATE(0)

Jeśli nie podano – przyjmuje się OFN_NOCHANGEDIR + OFN_PATHMUSTEXIST + OFN_FILEMUSTEXIST – dla otwierania pliku, OFN_NOCHANGEDIR + OFN_PATHMUSTEXIST – dla zapisu pliku i OFN_NOCHANGEDIR + OFN_PATHMUSTEXIST dla otwarcia katalogu.

Atrybuty standardowe kontrolki ENTRY:

jak dla standardowego typu stringowego.

Akcje standardowe kontrolki PROMPTBUTTON:

File Dialog lub Dir Dialog

Akcje standardowe kontrolki ENTRY:W trybie wyboru katalogu doklejanie backslash-a na końcu wartości, jeśli wartość kończy się innym znakiem.

Rozwinięcie

Wartość otoczona apostrofami (lub nieotoczona apostrofami, jeśli użyto modyfikatora _NQ).

Przykłady

@PAR ?@Fs255(File, Open, ‘Pliki tekstowe (*.txt)|*.txt|Wszystkie pliki (*.*)|*.*’, *.txt)|FileOpen|&File open:d:\app @? PAR@

@PAR ?@Fs255(, , ‘Pliki tekstowe (*.txt)|*.txt|Wszystkie pliki (*.*)|*.*’, *.txt)|FileOpen|&File open:d:\app@?

@PAR ?@Fs255(File,Save)|FileSave|&File save:d:\app @? PAR@

@PAR ?@Fs255(Dir)|Dir|&Dir:d:\app @? PAR@

Typ pusty EOL – wstawienie wolnego miejsca (typ dodatkowy)

Składnia

?@EOL

Parametr tego typu jest interpretowany tylko w procesie wyświetlania kontrolek parametrów dynamicznych. Jego deklaracja jest usuwana z tekstu, a używanie odwołań – niemożliwe (brak nazwy parametru).

Kontrolki

brak

Rozwinięcie

Usunięcie deklaracji z tekstu.

Typ tekstowy ABC – wstawienie zadanego tekstu na oknie (typ dodatkowy)

Składnia

?@ABC(‘Tekst do wyświetlenia’)

Parametr tego typu jest interpretowany tylko w procesie wyświetlania kontrolek parametrów dynamicznych. Jego deklaracja jest usuwana z tekstu, a używanie odwołań – niemożliwe (brak nazwy parametru).

Kontrolki

brak

Rozwinięcie

Usunięcie deklaracji z tekstu.

Uwagi

Jeśli parametr ma być przez całą szerokość panelu – należy umieścić go po lewej stronie, a po prawej stronie (jako sąsiadujący parametr) wstawić parametr EOL.

Przykłady

@PAR ?@ABC(‘To jest tylko taki testowy tekst żeby wypróbować nowy typ parametru dynamicznego (typ ”ABC”).’)@? PAR@

Odwołania do parametrów, rozwijanie parametrów

Rozwijanie parametrów, to wstawianie ich aktualnych wartości w miejsce odwołań do tych parametrów.

Istnieją dwa rodzaje odwołań do parametru:

Należy mieć na uwadze fakt, że pomimo tego, iż w tekście istnieje kilka wystąpień tego samego parametru (a więc parametru o takiej samej nazwie Nazwa), to i tak będzie wykreowana tylko jedna kontrolka, a jej ustawienia będą zgodne z pierwszym wystąpieniem parametru (jeśli to wystąpienie posiada znacznik ukrycia H – kontrolka parametru nie będzie w ogóle wykreowana). Ustawienia następnych wystąpień są ignorowane.

??[(_Q|_NQ)][Modyfikator…]Nazwa                                                                                    (PD2)

przy czym Nazwa nie może zawierać spacji z Modyfikator. Modyfikator ustala niestandardowe rozwijanie parametru i może być równy jednemu z poniższych ciągów znaków:

_RES2_ (wymuszenie wstawiania ‘kodu’ zamiast ‘ID’ dla parametrów typu DROPDOWN i LOOKUP),

_YMD_ (wstawianie wartości datownikowego parametru w formacie YYYY-MM-DD)

_HMS_ (wstawianie wartości czasowego parametru w formacie HH:MM:SS)

_ YMDHMS_ (wstawianie wartości datowoczasowego parametru w formacie YYYY-MM-DD HH:MM:SS)

_ DQ_ (dublowanie apostrofów wewnątrz wartości).

Zalecanym odwołaniem jest odwołanie skrócone – jest ono prostsze w użyciu a zarazem daje większe możliwości (modyfikatory). Odwołanie pełne (poprzez definicję parametru) jest pozostawione jedynie dla kompatybilności wstecz. Zalecanym sposobem jest utworzenie w jednym miejscu deklaracji wszystkich parametrów, a następnie stosowanie w dowolnych miejscach tylko odwołań skróconych.

Jest to zdecydowanie bardziej ergonomiczny sposób: nie musimy wpisywać wiele razy ustawień parametru, które i tak (poza pierwszym) będą zignorowane. Ustawienia będą oczywiście pobrane z pierwszego wystąpienia parametru o nazwie Nazwa, zgodnego z pełną składnią (PD).

Ponadto tylko w odwołaniach skróconych można stosować modyfikatory. Ograniczeniem tego rozwiązania jest niedopuszczenie spacji w Nazwie parametru.

Ponieważ odwołanie skrócone nie posiada sekwencji zakończenia – jego koniec ustalany jest podobnie, jak w przypadku zwykłego parametru bez sekwencji zakończenia (tj. po Nazwie musi występować jeden ze znaków określonych w zbiorze automatycznej sekwencji zakończenia parametru) z tą różnicą, że terminatorem może być dodatkowo znak ‘{‘.

Deklaracje parametrów

Podana na początku składnia definicji parametru dynamicznego (PD) może zostać umieszczona wewnątrz tzw. deklaracji parametru. Składnia deklaracji parametru dynamicznego jest następująca:

@PAR Definicja Opcje PAR@                                                                                                     (PD-DEKL)

gdzie Definicja ¬oznacza definicję parametru, określoną wzorem (PD) natomiast Opcje – ciąg opcji określających dodatkowe własności kontrolki parametru, oddzielonych spacjami:

Opcje = @Opcja([WarunekLubWartosc]) [@Opcja([WarunekLubWartosc])…]                     (PD-DEKL-O)

gdzie Opcja – jedna z opcji określających dodatkowe własności kontrolki parametru, WarunekLubWartosc – wyrażenie określające warunek zastosowania Opcji (np. dla disablowania) lub wartość opcji (np. wartość tip-u). W tej chwili dostępne są następujące opcje:

Opcja = (D[ISABLE] | H[IDE] | U[PPER] | (RL|RANGE LOW) | (RH|RANGE HIGH) | S[TEP] | T[IP] | M[SG] | COND | CONDMSG)                                                                                                             (PD-DEKL-O-O)

W WarunekLubWartosc mogą występować wyrażenia. Jeśli WarunekLubWartosc nie zostanie otoczony nawiasami {} – nawiasy te zostaną automatycznie dodane, co spowoduje ewaluację WarunekLubWartosc jako wyrażenia. W przypadku pominięcia WarunekLubWartosc – uznaje się, że dana opcja ma występować bezwarunkowo lub ma wartość pustą.

Jeżeli WarunekLubWartosc dotyczy opcji COND to jest on sprawdzany w oparciu o bieżące wartości wszystkich parametrów dynamicznych.

Warunek jest sprawdzany:

Dla ułatwienia posługiwania się opcjami @M[SG] i @T[IP] wprowadzono następujący element składni:

@M[SG](=T[IP]) – przepisanie tip-u do message’a

@T[IP](=M[SG]) – przepisanie message’a do tip-u

Nie ma tu znaczenia kolejność występowania tych opcji.

Użycie deklaracji parametrów pozwala na:

Istotną różnicą pomiędzy deklaracją parametru a jego definicją jest to, że deklaracje parametrów są w całości usuwane z tekstu przed jego wykonaniem.

Jeśli dany parametr ma gdziekolwiek w tekście deklarację – zostanie ona użyta do określenia własności parametru, nawet jeśli przed deklaracją występuje pełna definicja parametru.

Przykłady zastosowań

Import dokumentu z pliku .TXT

Jest to szczególnie istotne dla firm wprowadzających bardzo długie transakcje zakupu. Często wraz z towarem jego dostawca dostarcza dyskietkę ze specyfikacją dostawy. Korzystając np. z programu Microsoft Excel można napisać prosty program wczytujący taki plik tekstowy do arkusza, a następnie łączący się poprzez CDN XL API z systemem CDN XL i generujący odpowiedni dokument zakupu.

Wsadowy import transakcji

Firmy wielooddziałowe często importują poprzez łącza modemowe transakcje ze swoich oddziałów do centrali, gdzie mają one być następnie wprowadzone do bazy danych. Program importujący transakcje może za pośrednictwem CDN XL API połączyć się z systemem CDN XL i zapisywać w jego bazie danych zaimportowane z oddziałów dokumenty.

Przykładowe kody

Poniżej przedstawione zostały przykładowe kody wykorzystujące CDN XL API.

Dadanie ZS z jednym elementem (VBA)

Sub Dodaj_Zamowienie()

Dim Sesja As Long

Dim Wynik As Long

Dim Login As XLLoginInfo_12

Dim IDDokumentu As Long

Dim Naglowek As XLDokumentZamNagInfo_12

Dim Element As XLDokumentZamElemInfo_12

Dim Zamkniecie As XLZamkniecieDokumentuZamInfo_12

Sesja = 0

IDDokumentu = 0

With Login

.Wersja = 12

.programID = "TestXL"

.Baza = "CDNXL_Test"

.OpeIdent = "ADMIN"

.OpeHaslo = ""

End With

Wynik = XLlogin_12(Login, Sesja)

If Wynik <> 0 Then

MsgBox("Błąd logowania: " & Wynik)

End If

With Naglowek

.Wersja = 12

.Typ = 6

.Akronim = "Test"

End With

Wynik = XLNowyDokumentZam_12(Sesja, IDDokumentu, Naglowek)

If Wynik <> 0 Then

MsgBox("Błąd dodawania nagłówka: " & Wynik)

End If

With Element

.Wersja = 12

.Ilosc = 10

.CenaKatalogowa = 1

.Towar = "Test"

End With

Wynik = XLDodajPozycjeZam_12(IDDokumentu, Element)

If Wynik <> 0 Then

MsgBox("Błąd dodawania pozycji: " & Wynik)

End If

With Zamkniecie

.Wersja = 12

.TrybZamkniecia = 2

End With

Wynik = XLZamknijDokumentZam_12(IDDokumentu, Zamkniecie)

If Wynik <> 0 Then

MsgBox("Błąd zamykania nagłówka: " & Wynik)

End If

Wynik = XLlogout_12(Sesja)

If Wynik <> 0 Then

MsgBox("Błąd wylogowania: " & Wynik)

End If

End Sub

Przekształcenie ZS do FS (VBA)

Public Sesja As Long

Public IDDokumentu As Long

Public Wynik As Long

Public ElemInfo As XLDokumentElemInfo_12

Sub Zaloguj()

Dim Login As XLLoginInfo_12

Sesja = 0

Wynik = 0

With Login

.Wersja = 12

.ProgramId = "X:VBA"

.Baza = "CDN_XL_Test"

.OpeIdent = ""

.OpeHaslo = ""

End With

Wynik = XLLogin_12(Login, Sesja)

If Wynik <> 0 Then

Wynik = MsgBox("Błąd logowania: " & Wynik)

Exit Sub

End If

End Sub

Sub DodajNaglowek()

Dim NagInfo As XLDokumentNagInfo_12

Worksheets("Nagłówek ZS").Select

Wersja = 12

With NagInfo

.Wersja = 12

.Typ = 4

.ZamFirma = Range("b2").Value

.ZamNumer = Range("c2").Value

.ZamTyp = Range("a2").Value

End With

Wynik = 0

Wynik = XLNowyDokument_12(Sesja, IDDokumentu, NagInfo)

If Wynik <> 0 Then

Wynik = MsgBox("Błąd dodawania nagłówka: " & Wynik)

Exit Sub

End If

End Sub

Sub ZamknijNaglowek()

Dim ZamkniecieInfo As XLZamkniecieDokumentuInfo_12

ZamkniecieInfo.Wersja = 12

ZamkniecieInfo.Tryb = 0

Wynik = 0

Wynik = XLZamknijDokument_12(IDDokumentu, ZamkniecieInfo)

If Wynik <> 0 Then

Wynik = MsgBox("Błąd zamykania nagłówka: " & Wynik)

Exit Sub

Else

Wynik = MsgBox("Poprawnie dodano dokument WZ.")

End If

End Sub

Function Pierwszy_wolny_rekord() As Integer

Dim licznik As Long

licznik = 2

Do

If Range("A" & licznik).Value = "" Then

Pierwszy_wolny_rekord = licznik

Exit Function

Else

licznik = licznik + 1

End If

Loop

Stop

End Function

Sub DodajPozycje()

Worksheets("Pozycja ZS").Select

licznik = Pierwszy_wolny_rekord()

For x = 2 To licznik - 1

With ElemInfo

.Wersja = 12

.ZamFirma = Range("b" & x).Value

.ZamTyp = Range("a" & x).Value

.ZamNumer = Range("c" & x).Value

.ZamLp = Range("d" & x).Value

End With

Wynik = 0

Wynik = XLDodajPozycje_12(IDDokumentu, ElemInfo)

If Wynik <> 0 Then

Wynik = MsgBox("Błąd dodawania pozycji: " & Wynik)

Exit Sub

End If

Next x

End Sub

Sub Wyloguj()

Wynik = 0

Wynik = XLLogout_12(Sesja)

If Wynik <> 0 Then

Wynik = MsgBox("Błąd wylogowywania: " & Wynik)

Exit Sub

End If

End Sub

Sub Przeksztalc_ZS()

Zaloguj

DodajNaglowek

DodajPozycje

ZamknijNaglowek

Wyloguj

End Sub

Dodaj Kontrahenta (.NET)

Dla programistów wykorzystujących platformę MS .NET został przygotowany plik assembly, zawierający deklaracje struktur oraz funkcji używanych w CDN XL API. Plik jest dostępny na stronie ComArch (w zasobach CDN XL). Obecna wersja jest wersją testową, ciągle rozwijaną. Plik należy dołączyć w referencjach projektu (w Microsoft Visual Studio .NET można to zrobić wybierając w menu Project/Add Reference).

using System;

using cdn_api;

namespace XLNowyKontrahent

{

class APIDodajKontrahenta

{

[STAThread]

static void Main(string[] args)

{

XLLoginInfo_12 Login = new XLLoginInfo_12();

Login.Wersja = 12;

Login.ProgramID = "API.NET";

Login.Baza = "maciek4n";

Login.OpeIdent = "ADMIN";

Login.OpeHaslo = "";

Int32 SesjaID = 0;

Int32 KontrahentID = 0;

int LoginResult = cdn_api.cdn_api.XLLogin(Login, ref

SesjaID);

if (LoginResult == 0)

{

XLKontrahentInfo_12 Kontrahent = new XLKontrahentInfo_12();

Kontrahent.Wersja = 12;

Kontrahent.Akronim = "Nowy Kontrahent";

int KontrahentResult =

cdn_api.cdn_api.XLNowyKontrahent(SesjaID,ref KontrahentID,Kontrahent);

}

cdn_api.cdn_api.XLLogout(SesjaID);

}

}

}

Wskazówki do API w C8

Ogólne wytyczne w zakresie konfiguracji

1. Do sprawdzenia są elementy związane z wymogami systemowymi.

2. Warunki związane z samym systemem ERP XL dla wszystkich systemów operacyjnych:

Użytkownik ASPNET musi być w grupie użytkownicy, użytkownik na którym działa

IIS i ASP musi mieć prawa do katalogu z systemem ERP XL - chodzi o to żeby ten

użytkownik miał uprawnienia do uruchomienia ERP XL. [/su_list]

3. Na systemach serwerowych (2003,2008, 2012) i VISTA, Win 7, 8 najlepiej utworzyć dla takiej aplikacji osobną pulę aplikacji. Użytkownik, na którym działa pula (domyślnie Usługa Sieciowa) musi mieć prawo do katalogu z systemem CDNXL, aby miał uprawnienia do uruchomienia systemu.

4. Dodatkowo funkcje API powinny być wołane w trybie wsadowym.

5. Na C8 – nowy interfejs – przed logowaniem do API trzeba zawołać poniższy kod.

//jeśli C8 wołana jest metoda z ClaRUN.dll

public class Cdnsys

{

[DllImport(“ClaRUN.dll”)]

static extern void AttachThreadToClarion(int _flag);

public void AttachThread()

{

try

{

AttachThreadToClarion(1);

}

catch (Exception){}

}

}

Powyższe AttachThreadToClarion trzeba wołać przy każdym podnoszeniu nowego wątku.

6. W zmiennej środowiskowej Path powinno być wskazanie w ścieżce na jeden folder z systemem ERP XL (jeżeli jest zawarte odwołanie do innych folderów z wcześniejszymi wersjami należy je usunąć a następnie zapisać zmiany i zrestartować komputer).

7. Trzeba wołać attachthread wg wskazań w dokumentacji (lub jak powyżej) do każdego

nowego wątku i nie używać async’a. Jeżeli XLLogin jest wołane w innym wątku niż

pozostałe funkcje API to ten wątek musi pozostać aktywny tak długo jak wołamy funkcje

API – nie można po jego zakończeniu wołać funkcji API.

8. AttachThreadToClarion woła się 1 raz po utworzeniu wątku .net ( w tymże utworzonym wątku) – czyli 1 raz na wątek (teoretycznie nie ma ograniczenia na ilość wywołań AttachThread). Po wywołaniu AttachThreadToClarion wątek .net i wątek Clariona to jest jeden i ten sam wątek, nie ma więc operacji odwrotnej do AttachThreadToClarion. Jak zakończy się wątek utworzony w .net to zakończy się również w Clarionie i obiekty wątkowe zostaną zwolnione.

Plik Konfiguracyjny

Plik konfiguracyjny aplikacji nie pojawia się automatycznie po stworzeniu projektu i należy go dodać samodzielnie. Wystarczy kliknąć prawym przyciskiem myszy na projekt, do którego chcemy dodać plik z konfiguracjami, następnie wybrać opcję “Add New Item” i w oknie wyboru typu pliku zaznaczyć “Application Configuration File”. Dalej podaje się jego nazwę – standardowo App.config i potwierdza wybór.

Logowanie do API poprzez usługę

Podczas startowania usługi ( np. realizacja zamówienia ZS dokumentem WZ) wołany jest XLLogin, czyli są ustawiane obiekty globalne m.in. kolekcje rodzajów kontrahentów, definicje dokumentów itd. (wszystkie rzeczy konfiguracyjne XL’a). Potem startuje nowy wątek, w którym są wystawiane dokumenty np. WZ. Podczas gdy startuje nowy wątek to część danych konfiguracyjnych kopiuje z wątku głównego (robiona jest kopia żeby wątki się nie blokowały na czas dostępu do danych w wątku głównym). Należy zwrócić uwagę na specyficzne zachowanie usług (jeżeli usługa zawiera metody OnStart, OnStop, AutoResetEvent, WaitOne) – przy jej uruchamianiu wołana jest metoda OnStart (jeśli w niej byłoby umieszczone logowanie do API) to wątek w którym OnStart został wywołany może być za chwilę zakończony, co pociąga za sobą zwolnienie obiektów globalnych ładowanych przy XLLogin. Od tego momentu nowo tworzone wątki generujące np. WZ nie mają skąd skopiować danych konfiguracyjnych.

Rozwiązaniem jest w metodzie OnStart uruchomienie nowego wątku, w którym jest logowanie do API i ustawienie po zalogowaniu aby wątek nie zakończył się. Można to zrobić za pomocą statycznego obiektu klasy AutoResetEvent i metody WaitOne. W metodzie OnStop usługi trzeba wtedy zawołać metodę Set na tym obiekcie (po wylogowaniu z API).

API a aplikacje działające w oparciu o webserwis

W architekturze serwera opartego o WCF i klienta, problemem dla clariona jest kończenie wątku głównego gdy proces się nie kończy – czyli z punktu widzenia systemu operacyjnego wszystko jest poprawnie, jest wątek główny samej usługi. Wątek ten nie jest jednak związany z clarionem, więc w clarionie dopiero wątek w którym następuje logowanie do API jest wątkiem głównym – po wylogowaniu wątek ten się kończy mimo iż proces nadal działa – czy z punktu widzenia clariona sytuacja niemożliwa do uzyskania – nie ma czegoś takiego jak proces bez żadnego wątku, dlatego tez z tego powodu co jakiś czas zgłaszane mogą być wyjątki.

Rozwiązaniem będzie przy starcie usługi wydzielenie jednego wątku, związanie go z clarionem (AttachThread…) i pozostawieniem aktywnym przez cały czas działania usługi. W wątku tym trzeba wywołać od razu XLLogin. I teraz można zrobić od razu XLLogout, lub pozostawić tą sesję aktywną i w niej wystawiać dokumenty z wątków tworzonych na żądanie klientów – będzie szybciej działać. Czyli teraz nie byłoby już wołania XLLogin,XLNowyDokument…, XLLogout za każdym razem, ale jedynie XLNowyDokument z ID sesji ustalonym w wątku pierwszym.

Trzeba tak zmodyfikować dodatek, żeby choć jeden wątek procesu był podłączony do wątku clarionowego, tak aby nie było sytuacji, w której proces jest aktywny a żaden wątek nie jest połączony z clarionem. To wymaganie nie dotyczy okresu aktywności przed pierwszym wywołaniem AttachThreadToClarion.

Możliwe problemy do weryfikacji:

Connection string

Po zmianach w API XLPolaczenie nie zwraca automatycznie danych odnośnie połączenia. Funkcja API zwraca niezbędne dane do połączeń w aplikacji uzupełnione w tabeli cdn.Konfig i Kon_Numer = -137, Kon_Komentarz = ‘ConnectionString’.

Od wersji 2019.0 XLPolaczenie zwraca dane z funkcji skalarnej CDN.PodajDodatokwyConnectString – co pozwala na dynamiczną weryfikację połączenia, w przeciwieństwie do stałej danej wpisanej w CDN.Konfig.

Wykorzystanie funkcjonalności: Procesy

W wersji 4.5 systemu ERP XL, wprowadzono mechanizm definiowania i obsługiwania procesów. Umożliwia on zaprogramowanie następujących po sobie czynności (tworzących proces), mających na celu osiągnięcie celu założonego przez Użytkownika. Czynności, jakie będą wykonywane w trakcie procesu, mogą być czynnościami, jakie wynikają z funkcjonalności systemu ERP XL, np. wygenerowanie zamówienia sprzedaży lub też będące „czynnościami zewnętrznymi” – np. wysłanie wiadomości e-mail, albo uruchomienie programu zewnętrznego, po spełnieniu określonego warunku, itp.

Za pomocą procesów możliwe jest również regulowanie obiegu dokumentów, wskazanie osób odpowiedzialnych za realizację wyznaczonych zadań oraz monitoring czynności wykonywanych przez podległych pracowników.

Parametry związane z obsługą procesów znajdują się w Konfiguracja, zakładka: Ogólne/Parametry2.

Definiowanie procesów:

Generowanie dokumentów w ramach obsługi procesów

Generowanie dokumentów zamówień, jako realizacja akcji kluczowych

W wersji 4.5 wprowadzono obsługę dokumentów zamówień:

Obsługa ta wyraża się w tym, że w systemie zostały predefiniowane akcje, polegające na wygenerowaniu wymienionych dokumentów. Są to tzw. akcje kluczowe.

Przyklad

Definiowany jest proces polegający na obsłudze zamówienia sprzedaży. Podczas definiowania tego procesu, określane są akcje do wykonania w jego ramach. Akcje te mogą być akcjami zdefiniowanymi przez Użytkownika, lub wybranymi z akcji predefiniowanych w systemie. Wśród akcji predefiniowanych w systemie znajduje się akcja kluczowa: Dodanie zamówienia sprzedaży. Akcji tej nie trzeba definiować – przy definiowaniu procesu polegającego na obsłudze zamówienia sprzedaży, będzie ona dostępna do wyboru z listy akcji kluczowych, właściwych ze względu na rodzaj dokumentu, który ma być obsłużony. Podobnie – jeżeli definiowany jest proces obsługi oferty zakupu, jedną z akcji kluczowych, możliwych do wybrania jest akcja kluczowa: Dodanie oferty zakupu. Lista akcji kluczowych predefiniowanych w systemie będzie wyświetlana w oknie: Definicja akcji, po nacisnięciu w wierszu: Akcja kluczowa.

Generowanie innych dokumentów

W wersji 4.5, możliwe jest również zdefiniowanie i wykonanie akcji polegającej na wygenerowaniu innych niż wymienione dokumentów. Akcje te nie są jednak predefiniowane w systemie. Z tego względu, Użytkownik musi zdefiniować je samodzielnie. Należy zwrócić uwagę, że zdefiniowanie akcji polegającej na wygenerowaniu dokumentu nie obejmuje każdego dokumentu, jaki występuje w systemie i jest ograniczone do przypadków generowania dokumentów z zamówień sprzedaży i zakupu.

Definiowanie akcji polegającej na generowaniu dokumentów

Aby zdefiniować akcję polegającą na generowaniu dokumentów, należy:

Określenie zadań w definicji procesu

Typy zadań

Zadania predefiniowane

Jak wspomniano w rozdziale: Otworzenie definicji procesu, w każdej definicji procesu znajdują się dwa zadania predefiniowane. Są to zadania: START i KONIEC. Nie możliwości modyfikacji tych zadań, ani ich usunięcia z definicji.

Do zadania START, należy przypisać czynność, która spowoduje uruchomienie procesu, natomiast zadanie: KONIEC, jest ostatnim zadaniem każdego procesu i oznacza jego zakończenie.

Zadania definiowane przez Użytkownika

Oprócz zadań predefiniowanych, w definicji procesu znajdą się zadania określone przez Użytkownika. Zadania te stanowią etapy procesu. W ich ramach definiuje się czynności, których wykonanie skutkuje przejściem procesu do następnego zadania (etapu). Liczba zadań możliwych do wprowadzenia w definicji procesu nie jest ograniczona.

Funkcjonowanie akcji kluczowych

Rodzaje akcji kluczowych

Akcje kluczowe to akcje predefiniowane w systemie. Dla każdego procesu definiowanego w systemie możliwe jest przypisanie jednej z następujących akcji kluczowych:

Określanie parametrów dla akcji kluczowych

Dla niektórych akcji konieczne jest wskazanie ich parametrów, np. dla akcji: Wysłanie wiadomości email, konieczne jest podanie w Definicji Akcji adresata wiadomości, jej tematu oraz treści. Parametry te wprowadza się na zakładce: Parametry, uaktywnianej po wybraniu odpowiedniej akcji.

Uruchomienie innego procesu

Ta akcja kluczowa pozwala na przejście do innego procesu zdefiniowanego w ERP XL. W polu Uruchamiany proces wybieramy proces, który ma zostać uruchomiony.

Na zakładce parametry powinny zostać przekazane odpowiednie dane do nowego procesu. Jest to OBITyp
i OBINumer właściwe dla nowego procesu. Przykładowo w opisanym przypadku uruchamiany jest proces wysyłający mail z fakturą sprzedaży, dlatego wynik zapytania powinien zwrócić TrN_GIDTyp = 2033 (faktura sprzedaży) oraz jego TrN_GIDNumer.

Wysłanie wiadomości e-mail

Definicja Akcji: Wysłanie wiadomości e-mail, ze zdefiniowanymi parametrami dla okna: Definicja Akcji.

Na powyższym rysunku przedstawiono sposób wprowadzania parametrów dla akcji: Wysłanie wiadomości
e-mail. Należy zwrócić uwagę na format wprowadzanych danych. Powinny one zostać zapisane zgodnie z poniższym schematem:

Na zakładce: Parametry, można również wprowadzić zapytanie w języku T-SQL, które umożliwia np. wysłanie wiadomości e-mail, na adres podany na karcie kontrahenta, dla którego wygenerowany został dokument. Aby wykorzystać tę funkcjonalność, należy wykonać następujące czynności:

Generowanie dokumentu z zamówienia zakupu/sprzedaż.

Na zakładce: Parametry, należy wprowadzić skróconą nazwę dokumentu, np. FS, FZ itd. Jeżeli dla jednej akcji: Generowanie dokumentu z zamówienia zakupu, na zakładce: Parametry, zostało wskazanych wiele dokumentów, wtedy domyślnie będzie generowany ten, który został wprowadzony jako pierwszy.

Uruchomienie programu zewnętrznego.

Na zakładce: Parametry, należy wprowadzić nazwę pliku inicjującego odpowiedni program, np. jeżeli ma zostać uruchomiony program MS Word, w Definicji Akcji: Uruchomienie programu zewnętrznego, na zakładce: Parametry, należy wprowadzić tekst: winword.exe.

Jeżeli w procesie chcemy przekazać np. FS do edycji przez aplikację zewnętrzną to można przekazać zmienne procesowanego obiektu.

Wykonanie skryptu SQL.

Na zakładce: Parametry, wprowadza się skrypt, jaki ma zostać wykonany.

Zmiana etapu dokumentu w obiegu.

Na zakładce: Parametry, wprowadza się treść statusu jaki ma mieć dany dokument w obiegu wg Słownika statusów zdefiniowanego w Obiegu dokumentów.

Zastosowanie akcji kluczowych

Akcje kluczowe ułatwiają definiowanie procesów i zapewniają im dużą wszechstronność funkcjonalną. Zdefiniowanie procesu, w trakcie którego wykorzystana będzie akcja kluczowa – Wykonywanie skryptu SQL, umożliwia wywołanie czynności, której nie przewiduje „tradycyjna” – dostępna z poziomu interfejsu, funkcjonalność ERP XL. Z kolei wysłanie wiadomości e – mail, umożliwia np. automatyczne informowanie wskazanej grupy osób (pracowników/kontrahentów) o wykonaniu danej czynności, czy o osiągnięciu przewidzianego celu (więcej w rozdziale: 2.3 Definiowanie procesu: Sprawdzenie wysokości sprzedaży).

Akcje kluczowe przypisane do dokumentów zamówień, usprawniają tok definiowania procesów i automatyzują wykonywanie poszczególnych czynności w ich ramach.

Akcje automatyczne

Dla procesów możliwe jest zdefiniowanie akcji automatycznych, np. wysłanie wiadomości e – mail, uruchomienie programu zewnętrznego, lub wykonanie skryptu SQL, które będą wykonywane przez System.
O tym, czy akcja będzie akcją automatyczną decyduje ustawienie jako Opiekuna dla Czynności, w której przewidziano wykonanie akcji automatycznej, Opiekuna automatycznego.

Podmioty odpowiedzialne za realizację procesów

Procesy stwarzają możliwość wyznaczenia osób odpowiedzialnych za realizację poszczególnych czynności. Dzięki temu, poszczególne zadania, odpowiadające czynnościom w ERP XL mogą być przekazywane wybranym pracownikom. Wykonanie czynności (akcji) przez pracownika/operatora powoduje automatyczne przejście procesu do następnego etapu (zadania). Jako odpowiedzialnego za realizację czynności w następnym zadaniu można już wyznaczyć innego pracownika/operatora.

Wyznaczanie Opiekuna odbywa się w oknie: Definicja czynności procesu, na zakładce: Opiekunowie (więcej w rozdziałach: Przypisywanie Opiekunów do Czynności: Potwierdzenie zamówienia Przypisywanie Opiekuna do Czynności: Akcja automatyczna).

XL Work Automat

Okno: XL Work Automat, pozwala określić przedział czasowy, co jaki będą wykonywane akcje automatyczne, zdefiniowane dla aktywnych procesów. Przedział ten określa się na zakładce: Parametry.

Aby uruchomić automat, należy nacisnąć przycisk: . Naciśnięcie przycisku: , spowoduje natychmiastowe uruchomienie przetwarzania zadań automatycznych.

Przykładowe definicje procesów

Uwagi ogólne

W systemie ERP XL możliwe jest zdefiniowanie procesu, skupionego wokół obiektu, przewidzianego w jego funkcjonalności, jak również procesu, który nie dotyczy żadnego z takich obiektów. Wyboru dokonuje się w oknie: Definicje procesów, w jego lewym panelu, w którym wyświetlone są foldery, skupiające obiekty w ERP XL (zgodnie z podziałem na moduły). Wybór ostatniego folderu: Inne procesy, umożliwia utworzenie definicji procesu, który nie dotyczy obiektu, przewidzianego w funkcjonalności systemu.

Poniżej przedstawiono scenariusze definiowania procesu – zarówno takiego, który dotyczy obiektu w systemie ERP XL (rozdział: 2.2 Definiowanie procesu: Obsługa zamówienia zakupu), jak i takiego, który takiego obiektu nie dotyczy (rozdział: 2.3 Definiowanie procesu: ).

Niezależnie od rodzaju, wszystkie procesy mają cechy wspólne:

Definiowanie procesu: Obsługa zamówienia zakupu

Planowany przebieg procesu

Poniżej zaprezentowano sposób określenia definicji następującego procesu, dotyczącego obsługi zamówienia zakupu.

Jako pierwsza czynność w procesie, przypisana do etapu: Start (która spowoduje jego uruchomienie), zostanie zdefiniowana: Dodanie zamówienia zakupu. Wykonanie tej czynności spowoduje przejście procesu do następnego etapu: Akceptacja zamówienia (AZ). W etapie AZ zdefiniowane będą dwie czynności: Potwierdzenie zamówienia, lub Odrzucenie zamówienia. Wykonanie jednej z tych czynności spowoduje przejście procesu do następnego etapu:

W etapie: Akceptacja zamówienia, przewidziano więc dwie sytuacje, a wybór jednej z nich zadecyduje o prowadzeniu procesu jedną z dwóch ścieżek. Jeżeli zamówienie zostanie potwierdzone (przyjęte), wtedy, jak już wspomniano, proces przejdzie do zadania (etapu): Wysłanie wiadomości e-mail o potwierdzeniu zamówienia. W etapie tym, czynnością, która zostanie wykonana, będzie wysłanie wiadomości e-mail. Dla czynności tej, jako opiekun, zostanie przypisany opiekun automatyczny, dzięki czemu czynność ta zostanie wykonana automatycznie, po przejściu procesu właśnie do tego zadania. Kolejnym etapem, po wysłaniu wiadomości e-mail, będzie etap: Generowanie dokumentu handlowego z zamówienia zakupu. Dokumentem tym będzie Faktura zakupu. Wykonanie czynności spowoduje przejście procesu do etapu: Koniec, który oznacza zakończenie procesu.

Przedstawiony proces jest dość uproszczony i służy pokazaniu mechanizmu definiowania i działania procesu. W ramach definicji może zostać ujętych znacznie więcej zadań i czynności. Należy jedynie pamiętać, że o ile do jednego zadania można przypisać wiele czynności, to wykonać można tylko jedną z nich. Przypisanie wielu czynności do jednego zadania jest przydatne, jeśli dla procesu przewidziano różne ścieżki, którymi może podążyć. Wtedy, na etapie danego zadania, wykonując jedną z czynności wybiera się właściwą ścieżkę – w zależności od okoliczności i proces toczy się dalej odpowiednio do przyjętego wyboru (wykonanie jednej z czynności w danym zadaniu, powoduje, że zadanie jest również traktowane jako wykonane i proces przechodzi do następnego etapu).

Poniżej przedstawiony został schemat procesu: Obsługa zamówienia zakupu, w którym wyraźnie widać dwie ścieżki, jakimi może podążyć proces w konsekwencji wykonania jednej z dwóch czynności: Potwierdzenia zamówienia (jego przyjęcia) bądź Odrzucenia zamówienia.

Otworzenie definicji procesu

Szczegóły każdego zdefiniowanego procesu znajdują się w oknie: Definicja procesu. Znajduje się w nim wykreowana przez Użytkownika lista zadań i czynności do wykonania w ramach zadań. Dwa zadania: START i KONIEC, są predefiniowane w systemie i nie ma możliwości ich modyfikacji i usunięcia (więcej w rozdziale: Określenie zadań w definicji procesu). Okno: Definicja procesu, otwiera się z poziomu okna: Definicje procesów.

Aby otworzyć okno definicji procesu: Obsługa zamówienia zakupu, należy:

Wyznaczenie zadań w definicji procesu: Obsługa zamówienia zakupu

Aby dodać nowe zadania o definicji procesu, należy:

W otworzonym oknie: Definicja procesu (więcej w rozdziale: Otworzenie definicji procesu), należy nacisnąć przycisk: , rozwijający menu, z którego należy wybrać opcję: Dodaj zadanie.

Zostanie otworzone okno: Definicja zadania procesu.

W oknie należy wskazać kod (skróconą nazwę zadania) i jego pełną nazwę. Aby ułatwić definiowanie procesu, okno można tymczasowo zapisać, używając przycisku: [Zapisz]. W ten sposób można wyznaczyć kolejne zadania. W podanym przykładzie, do definicji procesu, zostały dodane następujące zadania:

Zdefiniowanie zadań dla procesu stworzyło podstawowe elementy jego konstrukcji. Teraz, dla każdego zadania należy określić czynności jakie będą wykonywane w ramach poszczególnych etapów. Sposób przypisywania czynności do poszczególnych zadań został przedstawiony na przykładzie przypisania czynności do zadania: Akceptacja zamówienia (więcej w rozdziale: Przypisywanie czynności do zadania: Akceptacja zamówienia).

Po ich wprowadzeniu do definicji procesu, wyglądać ona będzie jak na rysunku poniżej.

Po zdefiniowaniu zadań w procesie należy określić dla nich parametry i przypisać czynności, jakie mają zostać wykonane w ich ramach. Kroki te zostały opisane w następnych rozdziałach.

Określenie parametrów zadania: Akceptacja zamówienia

Określenie parametrów dla zadania rozpoczyna się od wprowadzenia jego kodu (czyli skróconej nazwy) i pełnej nazwy zadania (więcej w rozdziale: Wyznaczenie zadań w definicji procesu: Obsługa zamówienia zakupu). W prezentowanym przykładzie, jako pierwsze zdefiniowano zadanie: Akceptacja zamówienia, stąd w pola: kod i Nazwa, wprowadzono odpowiednio wartości: AZ i Akceptacja zamówienia. Ponadto, dla zadania tego (tak jak dla innych zadań) możliwe jest określenie następujących parametrów:

Termin realizacji – dla każdego zadania można określić termin jego realizacji, czyli taki, w jakim ma zostać zrealizowane dane zadanie. Jest on liczony od momentu trafienia zadania do skrzynki pracownika. Termin można określić poprzez wskazanie ilości sekund, minut, godzin, dni, tygodni lub za pomocą warunku SQL. Warunek wprowadza się na zakładce: SQL, uaktywnionej po zaznaczeniu pola: SQL. Warunek ten powinien zwrócić zmienną w formacie timestamp. W prezentowanym przykładzie określono termin realizacji zadania jako 3 dni. Oznacza to, że w ciągu 3 dni od momentu wygenerowania zamówienia ma ono zostać potwierdzone lub odrzucone. Przekroczenie terminu nie uniemożliwia jednak zatwierdzenia lub odrzucenia zamówienia. Określenie terminu ma znaczenie dla monitorowania przebiegu procesu – w trakcie jego obsługi, zadania przeterminowane będą wyświetlane w skrzynce pracownika na czerwono. Dzięki temu zarówno pracownik, jak kierownik będą mieli możliwość kontrolowania terminowości wykonywania zadań.

Data realizacji – proponowana data realizacji zadania. Datę można określić poprzez wskazanie ilości sekund, minut, godzin, dni, tygodni lub za pomocą warunku SQL. Warunek wprowadza się na zakładce: SQL, uaktywnionej po zaznaczeniu pola: SQL. Warunek ten powinien zwrócić zmienną w formacie timestamp. Podobnie, jak w przypadku terminu realizacji zadania, przekroczenie wyznaczonej daty nie blokuje możliwości jego wykonania.

Czas realizacji – czas przewidziany na realizację zadania. Czas można określić poprzez wskazanie ilości sekund, minut, godzin, dni, tygodni lub za pomocą warunku SQL. Warunek wprowadza się na zakładce: SQL, uaktywnionej po zaznaczeniu pola: SQL. Warunek ten powinien zwrócić zmienną w formacie timestamp.

Zarówno data realizacji zadania, jak i czas realizacji są parametrami, które mają służyć Użytkownikowi, poprzez możliwość określania za ich pomocą harmonogramu wykonywania zadań, np. w danej jednostce określa się, że czas przewidziany na wykonanie danego zadania wynosi godzinę, a innego 1 dzień i zgodnie z tym wprowadza się odpowiednie zapisy w definicji zadania procesu.

Warunek wejścia – warunek, jaki musi zostać spełniony, aby nastąpiło wejście do danego statusu. Warunek ten określa się przez wykonanie zadań poprzedzających:

Wskazanie tego warunku może się również odbyć za pomocą warunku SQL, wprowadzanego na zakładce: SQL, uaktywnianej po zaznaczeniu w wierszu: Warunek wejścia, parametru: SQL.

W prezentowanej definicji, dla parametru: Warunek wejścia, zaznaczono opcję: Przynajmniej jedno, gdyż etap: Akceptacja zamówienia poprzedzona jest tylko jedną czynnością: Dodanie zamówienia zakupu, przypisaną do zadania: START (więcej w rozdziale: Planowany przebieg procesu).

Po określeniu opisanych parametrów, definicja zadania procesu będzie wyglądała, jak na poniższym rysunku.

Poza wymienionymi parametrami, dla zadania przypisuje się czynność, lub czynności, przewidziane do wykonania w jego ramach. Przypisywanie czynności wymaga ich zdefiniowania, dlatego zostało opisane w rozdziale: Przypisywanie czynności do zadania: Akceptacja zamówienia.

Przypisywanie czynności do zadania: Akceptacja zamówienia

Przypisanie czynności do zadania procesu polega na określeniu działań, jakie mają zostać wykonane, gdy proces przejdzie do tego zadania (etapu) oraz podmiotów odpowiedzialnych (opiekunów) za ich wykonanie.
Przypisywanie czynności do zadania odbywa się w oknie: Definicja zadania procesu, na zakładce: Czynności. Do zadania: Akceptacja zamówienia, zostaną przypisane dwie Czynności: Potwierdzenie zamówienia i Odrzucenie zamówienia. Na początek zostaje zdefiniowana Czynność: Potwierdzenie zamówienia.

Przypisanie czynności: Potwierdzenie zamówienia do zadania: Akceptacja Zamówienia

Aby przypisać czynność: Potwierdzenie zamówienia, do zadania: Akceptacja zamówienia, należy:

Określenie Akcji dla Czynności: Potwierdzenie zamówienia

Określenie Akcji następuje po naciśnięciu przycisku: . Zostanie otworzone okno: Definicja procesu (Zamówienie zakupu) z zakładką: Akcje.

W otwartym oknie, definiuje się akcję, która będzie wybrana jako Akcja do wykonania w ramach definiowanej Czynności. W tym celu należy nacisnąć przycisk: [Dodaj]. Zostanie otworzone okno: Definicja Akcji.

W oknie: Definicja Akcji, w wierszu Akcja kluczowa, znajduje się rozwijalna lista akcji predefiniowanych w systemie. Uruchamia się ją po naciśnięciu przycisku: . Z listy należy wybrać akcję: Potwierdzenie zamówienia zakupu.

Po wybraniu akcji, jej nazwa zostanie wyświetlona również w polu: Nazwa. Można ją modyfikować.

Akcja: Potwierdzenie zamówienia zakupu, została zdefiniowana, wobec tego należy ją zapisać, naciskając przycisk: [Zapisz]. Zapisana akcja zostanie wprowadzona na listę w oknie: Definicja procesu (Zamówienie zakupu).

Jeżeli akcja została wprowadzona na listę, można ją przypisać do Czynności. Aby to zrobić, należy ją zaznaczyć i nacisnąć przycisk: [Wybierz]. Wybrana akcja zostanie przypisana do Czynności.

Po określeniu Akcji, należy zdefiniować Wynik, czyli zadanie, do którego przejdzie proces po wykonaniu Akcji.

Określenie Wyniku dla Czynności: Potwierdzenie zamówienia

Wynikiem dla czynności będzie jedno ze zdefiniowanych wcześniej zadań. Ponieważ zostały one już określone, wystarczy wybrać jedno z nich. Jeżeli odpowiednie zadanie nie zostałoby zdefiniowane do tego momentu, można je określić również z poziomu okna: Definicja czynności procesu.

Określenie Wyniku Akcji następuje po naciśnięciu w oknie: Definicja czynności procesu, przycisku: . Zostanie otworzone okno: Definicja czynności procesu, z zakładką: Zadania.

W oknie wyświetlone będą zadania, jakie zostały zdefiniowane do tej pory. Jeżeli zadania, które ma być wynikiem, nie ma na tej liście, można je zdefiniować po rozwinięciu za pomocą przycisku: , menu kontekstowego i wybraniu z niego opcji: Dodaj zadanie. Uruchomiony zostanie w ten sposób proces definiowania zadania.

Jeżeli natomiast na liście znajduje się zadanie, które ma być Wynikiem dla Akcji, należy je zaznaczyć i nacisnąć przycisk: . Wybrane zadanie zostanie przypisane do Czynności jako Wynik dla Akcji.

W prezentowanym przykładzie, Wynikiem dla Akcji: Potwierdzenie zamówienia zakupu, ma być zadanie: Wysłanie wiadomości e-mail o potwierdzeniu zamówienia. Zadanie takie znajduje się na liście w oknie: Definicja procesu, zakładka: Zadania (Rys. 25). W tej sytuacji należy je zaznaczyć i nacisnąć przycisk: . Zadanie: Wysłanie wiadomości e-mail o potwierdzeniu zamówienia (WW), zostanie przypisany do Czynności, jako Wynik dla Akcji: Potwierdzenie zamówienia zakupu.

Po określeniu Akcji i wskazaniu Wyniku, należy przypisać osoby odpowiedzialne – tzw. Opiekunów, za wykonanie zadania. Opis przypisywania Opiekunów do czynności znajduje się w rozdziale: Przypisywanie Opiekunów do Czynności.

Przypisywanie Opiekunów do Czynności: Potwierdzenie zamówienia

Przypisywanie Opiekunów do Czynności odbywa się na zakładce: Opiekunowie. Aby przypisać Opiekuna, należy

Wybór opcji zadecyduje o tym, jaka lista zostanie otwarta. Z otwartej listy dokonuje się wyboru odpowiedniego podmiotu, który będzie Opiekunem dla definiowanej czynności. W prezentowanym przykładzie Opiekunem zostanie wybrane centrum ze struktury podległościowej. Dzięki temu, wszyscy pracownicy tego centrum będą mogli dokonywać potwierdzenia zamówień. Aby wybrać centrum jako Opiekuna, należy z menu kontekstowego wybrać opcję: Ze struktury firmy. Zostanie otworzone okno: Struktura firmy.

W oknie: Struktura firmy, należy zaznaczyć centrum, mające zostać Opiekunem i nacisnąć przycisk: . Wybrane centrum zostanie wprowadzone na zakładkę: Opiekunowie, w oknie: Definicja czynności procesu.

Jeżeli zostały zdefiniowane: Akcja, Wynik oraz Opiekun, definicję czynności procesu można zapisać, używając przycisku: [Zapisz zmiany]. Po zapisaniu, Czynność zostanie przypisana do zadania: Akceptacja zamówienia (na zakładce: Czynności).

Przypisanie czynności: Odrzucenie zamówienia zakupu

Przypisanie czynności: Odrzucenie zamówienia zakupu, do definicji zadania procesu [AZ] przebiega w podobny sposób, jak w przypadku przypisania czynności: Potwierdzenie zamówienia zakupu. W przypadku czynności: Odrzucenie zamówienia zakupu, zostanie jednak zdefiniowana inna akcja: Odrzucenie zamówienie zakupu, dla której wynikiem będzie status: KONIEC, oznaczający zamknięcie procesu. Sposób definiowania Akcji i Wyniku został opisany w rozdziałach: Określenie Akcji Określenie Wyniku.

Po wskazaniu elementów na Czynności, jej definicja będzie wyglądała jak na rysunku poniżej.

Po zdefiniowaniu Akcji i Wyniku, do Czynności zostanie przypisany Opiekun.

Przypisywanie czynności do innych zadań w procesie

Przypisywanie czynności do innych zadań w definicji procesu przebiega podobnie, jak w przypadku zadania: Akceptacja zamówienia (więcej w rozdziale: Przypisywanie czynności do zadania: Akceptacja zamówienia). Należy zwrócić uwagę na konieczność przypisania przynajmniej jednej czynności do każdego zadania (z wyjątkiem zadania: KONIEC) oraz pamiętać o tym, że do zadania; START ma zostać przypisana czynność, która będzie uruchamiała cały proces. Czynność do tego zadania przypisuje się z poziomu okna: Definicja procesu (Zamówienie zakupu), po jego zaznaczeniu i naciśnięciu przycisku: [Dodaj] lub wybraniu z menu kontekstowego, rozwijanego przyciskiem: , opcji: Dodaj czynność. Zostanie otworzone okno: Definicja czynności procesu, które należy wypełnić podobnie jak opisano to w rozdziale: Przypisywanie czynności do zadania: Akceptacja zamówienia, podając jako Akcję: Dodanie zamówienia zakupu, a jako Wynik – zadanie: Akceptacja zamówienia.

Po przypisaniu czynności do wszystkich zadań (zgodnie z założeniami definicji procesu opisanymi w rozdziale: Planowany przebieg procesu) definicja procesu: Obsługa zamówienia zakupu, będzie wyglądała jak na poniższym rysunku. W oknie: Definicja procesu, wyświetlone są, w układzie drzewa, zadania i przypisane do nich czynności.

Zapisanie definicji procesu

Jeżeli w definicji procesu: Obsługa zamówienia zakupu, wszystkie zadania zostały już określone i zostały do nich przypisane wszystkie wymagane czynności, można ją zapisać, używając przycisku: [Zapisz zmiany]. Zapisana definicja zostanie umieszczona w oknie: Definicje procesów.

Jak widać na powyższym rysunku, definicja procesu: Obsługa zamówienia zakupu, wyświetlona jest w kolorze szarym. Stało się tak dlatego, że definicji tej nie został nadany status aktywności – nie został zaznaczony parametr: Aktywny, w oknie: Definicja procesu. Do momentu zaznaczenia tego parametru, uruchomienie procesu w oparciu o zapisaną definicję będzie niemożliwe.

Definiowanie procesu: Sprawdzenie wysokości sprzedaży

Planowany przebieg procesu

Poniżej zostanie zaprezentowany sposób definiowania procesu, którego celem będzie wysłanie informacji za pośrednictwem poczty elektronicznej o przekroczeniu określonej wysokości sprzedaży (np. 10000 zł) w danym dniu. Na potrzeby niniejszego dokumentu, nazwa definicji tego procesu zostanie ujęta w skrócie: Sprawdzenie wysokości sprzedaży.

Pierwszą czynnością w tym procesie, przypisaną do zadania: START, będzie: Uruchomienie. Czynność ta będzie wykonywana przez wybranego pracownika i ma na celu jedynie uruchomienie procesu. Po jej wykonaniu, proces przejdzie do zadania: AKTYWNY. Do zadania tego będzie przypisana jedna czynność, w której akcją do wykonania będzie: Akcja automatyczna. W trakcie tej czynności będzie automatycznie wykonywany select, sprawdzający, czy wartość sprzedaży przekroczyła już określony próg (10000 zł) czy też nie. Dla czynności zostaną określone dwa wyniki obłożone warunkami SQL:

Pierwszy – przewidujący sytuację, gdy wartość sprzedaży przekroczy 10000 zł – wtedy Wynikiem będzie zadanie polegające na wysłaniu odpowiedniej wiadomości e-mail,

Drugi – przewidujący sytuację, gdy wartość sprzedaży nie przekroczy 10000 zł – wtedy Wynikiem będzie zadanie: Aktywny, czyli proces wejdzie ponownie w etap sprawdzania wartości sprzedaży.

Z tak zdefiniowanych warunków będzie wynikało, że proces będzie znajdował się etapie sprawdzania wartości sprzedaży, do momentu, gdy wartość ta nie zostanie przekroczona. Po jej przekroczeniu zostanie wysłana odpowiednia wiadomość e-mail.

Jeśli proces przejdzie do następnego etapu: Wysłanie wiadomości e-mail, będzie to oznaczało, że cel procesu w danym dniu został osiągnięty. Proces, po wykonaniu czynności polegającej na wysłaniu wiadomości e-mail przejdzie do zadania: Czekaj. Zadanie to polega na „czekaniu” jedną dobę na ponowne sprawdzenie wysokości sprzedaży w dniu następnym. Stąd też, następnym etapem (Zadaniem), jakie zostanie wykonane (po upływie doby) będzie znów zadanie: Aktywny, który czynność taką (sprawdzenie wartości sprzedaży) będzie uwzględniał.

Należy zwrócić uwagę, że w takiej definicji procesu nie jest wykorzystywane zadanie: KONIEC. Uruchomienie procesu spowoduje, że będzie się on toczył przez kolejne dni automatycznie, bez konieczności ingerencji Użytkownika – codziennie będzie sprawdzana wartość sprzedaży, a po jej przekroczeniu, będzie wysyłana wiadomość e-mail. Aby zamknąć proces, należy go zaznaczyć w oknie: Lista procesów i nacisnąć przycisk: [Zamknij proces].

Poniżej został przedstawiony schemat wykonywania poszczególnych czynności w procesie: Sprawdzenie wysokości sprzedaży.

Otworzenie definicji procesu

Otworzenie definicji procesu następuje w oknie: Definicje procesów. Ponieważ jest to proces bez obiektu, musi on zostać zdefiniowany z poziomu z poziomu folderu: Inne procesy i gałęzi: Proces bez obiektu.

Aby otworzyć definicje procesu: Sprawdzenie wysokości sprzedaży, należy:

w module: Administrator, wybrać z menu: Procesy, opcję: Definicje procesów.

Następnie w lewym panelu okna, rozwinąć folder: Inne procesy. Zostanie wyświetlona gałąź: Proces bez obiektu.

Po zaznaczeniu gałęzi: Proces bez obiektu, należy nacisnąć przycisk: [Dodaj]. W ten sposób zostanie otworzona definicja procesu. W oknie należy wprowadzić nazwę procesu.

Wyznaczenie zadań w procesie

Po otworzeniu definicji procesu: Sprawdzenie wysokości sprzedaży, należy określić zadania czyli etapy tego procesu. W prezentowanym przykładzie – zgodnie z przyjętym założeniem (więcej w rozdziale: Planowany przebieg procesu), zdefiniowane zostaną następujące zadania i czynności:

START – do tego zadania zostanie przypisana czynność: Uruchomienie

AKTYWNY – do tego zadania zostanie przypisana czynność automatyczna, dla której możliwe będą dwa Wyniki (w zależności od tego czy wartość sprzedaży w danym dniu przekroczyła 10000 zł czy też nie).

E – MAIL (wysłanie wiadomości e-mail) – jeżeli wartość sprzedaży w danym dniu przekroczy 10000 zł, wtedy proces przejdzie do zadania: E-MAIL, w którym zostanie wysłana odpowiednia wiadomość e-mail.

CZEKAJ – po wysłaniu wiadomości e-mail, proces w zadaniu: CZEKAJ, będzie „oczekiwał” przez wskazany czas (jedną dobę) na ponowne przejście do zadania: AKTYWNY.

Definiowanie zadań odbywa się w ten sam sposób, jak w przypadku definiowania zadań w procesie: Obsługa zamówienia zakupu (więcej w rozdziale: Wyznaczenie zadań w definicji procesu: Obsługa zamówienia zakupu).

Po wyznaczeniu zadań, definicja procesu: Sprawdzenie wysokości sprzedaży, będzie wyglądać jak poniższym rysunku.

Zdefiniowanie zadania: Czekaj

W zdefiniowaniu zadania: Czekaj, istotne jest określenie terminu jego realizacji. Z przyjętych założeń wynika, że proces w tym zadaniu oczekuje jedną dobę na ponowne uruchomienie skryptów sprawdzających wysokość sprzedaży. W związku z tym, w oknie: Definicja zadania procesu, na zakładce: Ogólne, w polu: Data realizacji, należy wskazać 1 dzień.

Należy pamiętać, że istnieje możliwość większego zoptymalizowania czasu oczekiwania na ponowne uruchomienie sprawdzenia wysokości sprzedaży. W podanym bowiem przykładzie, czas oczekiwania będzie liczony od momentu przekroczenia wysokości sprzedaży w danym dniu. Oznacza to, że jeżeli przekroczenie wysokości sprzedaży jednego dnia nastąpi o godzinie 15.00, to ponowne uruchomienie zapytań SQL, sprawdzających wysokość sprzedaży w dniu następnym, nastąpi również o godzinie 15.00.

Uruchomienie wykonywania skryptów o oznaczonej godzinie, można zdefiniować poprzez warunek SQL. W tym celu, w oknie: Definicja zadania procesu (Czekaj), należy zaznaczyć w wierszu: Data realizacji, pole: SQL i na uaktywnionej zakładce: SQL, wprowadzić odpowiedni warunek.

Przypisanie czynności do zadań

Po wyznaczeniu zadań, należy przypisać do nich czynności. Sposób przypisania czynności do zadań odbywa się tak samo, jak w przypadku przypisywania czynności do zadań definicji procesu: Obsługa zamówienia zakupu (więcej w rozdziale: Przypisywanie czynności do zadania: Akceptacja zamówienia). W niniejszym rozdziale zostanie opisany sposób definiowania czynności: Akcja automatyczna, która zostanie przypisana do zadania: AKTYWNY, który różni się od przedstawionego powyżej.

Zdefiniowanie czynności: Akcja automatyczna

W czynności: Aktywny, zostanie przewidziana akcja, wykonywana automatycznie. Jej Wynik, będzie zależał od tego, czy sprawdzana wartość wysokości sprzedaży przekroczy 10000 zł, czy też nie. Wyniki te zostaną obłożone warunkami SQL.

Otworzenie definicji czynności: Akcja automatyczna

Aby zdefiniować czynność: Akcja automatyczna, należy:

Przypisanie Akcji do Czynności: Akcja automatyczna

W oknie należy nacisnąć przycisk: . Zostanie otworzone okno: Definicja procesu, z zakładką: Akcje. W oknie tym, należy zdefiniować nową akcję – Akcję automatyczną. Odbywa się to po naciśnięciu przycisku: [Dodaj]. W otworzonym oknie: Definicja Akcji, w polu: Nazwa, wprowadzić nazwę Akcji – czyli: Akcja automatyczna. Zdefiniowaną Akcję należy zapisać, naciskając przycisk: [Zapisz].

Akcja automatyczna zostanie wyświetlona na liście akcji w oknie: Definicja procesu. Należy ją teraz zaznaczyć i nacisnąć przycisk: [Wybierz].

W ten sposób, do czynności: Akcja automatyczna, została przypisana Akcja.

Przypisanie Wyników do Czynności: Akcja automatyczna

Należy teraz określić Wyniki dla przypisanej Akcji. Ze względu na charakter Czynności, zostaną zdefiniowane dwa Wyniki – jeden dla sytuacji, gdy wysokość wartości sprzedaży przekroczy 10000 zł, drugi – dla sytuacji, gdy wartość sprzedaży nie przekroczy tej wysokości.

Aby przypisać pierwszy Wynik, należy:

W ten sposób pierwszy Wynik zostanie zdefiniowany. Należy go zapisać i przystąpić do definiowania drugiego Wyniku, przewidzianego po spełnieniu warunku, gdy wysokość wartości sprzedaży nie przekroczy 10000 zł. Wynikiem tym będzie zadanie: AKTYWNY. Definiowanie odbywa się tak, jak w przypadku pierwszego Wyniku (oczywiście z uwzględnieniem funkcji przewidzianej dla drugiego Wyniku). Po zdefiniowaniu, Wynik: Aktywny, będzie wyglądał jak na poniższym rysunku.

Po zapisaniu definicji statusu wynikowego: AKTYWNY, zostanie on przypisany do Czynności: Akcja automatyczna.

Okno Czynności: Akcja automatyczna, po przypisaniu do niej Wyników: E-MAIL i AKTYWNY, będzie wyglądało jak na poniższym rysunku.

Przypisywanie Opiekuna do Czynności: Akcja automatyczna

Dla zdefiniowanej Czynności: Akcja automatyczna, należy określić Opiekuna. Ponieważ Czynność będzie wykonywana automatycznie, należy wybrać Opiekuna automatycznego.

Definicję czynności procesu należy zapisać. Zostanie ona przypisana do zadania: AKTYWNY.

W podobny sposób definiuje się kolejne czynności dla tej definicji procesu, jednak, ze względu na to, że każda z nich przewiduje jeden Wynik, zostanie on wprowadzony w oknie definicji czynności procesu, w polu: Wynik (po naciśnięciu przycisku: ).

Po przypisaniu wszystkich przewidzianych Czynności do zadań, definicja procesu: Sprawdzenie wysokości sprzedaży, będzie wyglądała jak na poniższym rysunku:

Obsługa procesu

Obsługa procesu polega na jego uruchomieniu i wykonywaniu zadań przewidzianych w jego definicji. Definicja procesu stanowi wzór, według którego może być wykonywana nieograniczona ilość procesów. Obsługa procesów w oparciu o definicję jest możliwa, gdy:

Poniżej przedstawiono obsługę dwóch procesów wykonywanych w oparciu o definicje zaprezentowane w rozdziale: Przykładowe definicje procesów.

Obsługa procesu: Obsługa zamówienia zakupu

Uwagi ogólne

Proces dotyczący obsługi zamówienia zakupu może być uruchamiany i wykonywany z poziomu:

Obsługa z poziomu skrzynki pracownika polega na tym, że Opiekun, wybiera z listy odpowiedni proces, identyfikowany po nazwie procesu i numerze obiektu (czyli numerze zamówienia) i wykonuje akcję, przez:

wybranie przycisku: [Wykonaj akcję],

lub jeżeli w danym etapie przewidziano wykonanie jednej w wielu czynności:

rozwinięciu menu kontekstowego za pomocą przycisku: , znajdującego się obok ikony i wybraniu odpowiedniej opcji, oznaczającej wykonanie jednej z czynności.

Rys. 50 Skrzynka pracownika z rozwiniętym menu kontekstowym umożliwiającym wybór czynności do wykonania.

Kilka procesów na jednym obiekcie

Może się zdarzyć, że dla jednego obiektu – np. zamówienia zakupu, zostanie zdefiniowanych klika definicji procesu, przewidujących różne ścieżki obiegu dokumentów. W takiej sytuacji, operując konkretnym zamówieniem, o ile istnieją wspólne punkty tych procesów można wybrać definicję, według której będzie obsługiwany dalej dany obiekt.

Wyboru definicji dokonuje się w oknie: Lista zamówień. Aby wybrać jedną z definicji do obsługi konkretnego zamówienia, należy:

Po wybraniu jednej z definicji, uruchomienie przycisku: [Wykonaj akcję] spowoduje wykonanie akcji, przewidzianej dla czynności będącej elementem tej definicji. Przycisk: , rozwija menu kontekstowe z możliwymi opcjami wykonania akcji.

Uruchomienie procesu (zadanie START)

Proces rozpoczyna się w momencie, gdy podmiot przypisany jako Opiekun do Czynności: Dodanie zamówienia zakupu, wygeneruje zamówienie zakupu. Wygenerowanie zamówienia zakupu jest możliwe:

Wygenerowane zamówienie zostanie zapisane, a proces przechodzi do następnego etapu: Akceptacja zamówienia.

Proces na etapie: Akceptacja zamówienia

W tym etapie, proces pojawi się skrzynkach pracowników, którzy zostali przypisani jako Opiekunowie do czynności: Akceptacja zamówienia zakupu lub Odrzucenie zamówienia zakupu. Jeżeli ten sam podmiot jest Opiekunem do jednej i drugiej czynności, wtedy z poziomu otwartego zamówienia, lub swojej skrzynki pracownika może dokonać albo przyjęcia zamówienia, albo jego odrzucenia. Wykonanie jednej z tych czynności powoduje przejście procesu do następnego etapu:

Proces na etapie: Wysłanie wiadomości o potwierdzeniu zamówienia

Opiekunem na etapie: Wysłanie wiadomości o potwierdzeniu zamówienia, jest Opiekun automatyczny. Oznacza to, że czynność polegająca na wysłaniu do wskazanych podmiotów wiadomości za pośrednictwem poczty elektronicznej o pozytywnym potwierdzeniu zamówienia zostanie wykonana automatycznie, po przejściu procesu do tego etapu. Należy jednak pamiętać o odpowiednim zdefiniowaniu parametrów w konfiguracji, na zakładce: Ogólne/Parametry 2, dotyczące ustawień SMTP.

Po wysłaniu wiadomości e-mail, proces przejdzie automatycznie do następnego etapu: Wygenerowanie dokumentu handlowego z zamówienia, czyli znajdzie się w skrzynce tych pracowników, którzy zostali wybrani jako Opiekunowie do czynności polegającej na wygenerowaniu dokumentu handlowego z potwierdzonego zamówienia (GD).

Proces na etapie: Wygenerowanie dokumentu handlowego z zamówienia

Opiekunowie mogą wykonać czynność generowania dokumentu handlowego:

Po wykonaniu akcji, proces przejdzie do statusu KONIEC, który oznacza jego zakończenie.

Proces na etapie: KONIEC

Proces przechodzi automatycznie do statusu wynikowego: KONIEC:

Status: KONIEC, oznacza zakończenie procesu. Na tym etapie nie jest wykonywana żadna czynność.

Obsługa procesu: Sprawdzenie wysokości sprzedaży

Uwagi ogólne

Proces: Sprawdzenie wysokości sprzedaży, w przeciwieństwie do procesu: Obsługa zamówienia zakupu, nie dotyczy obiektu w ERP XL. W związku z tym, jego obsługa możliwa jest tylko z poziomu okna: Skrzynka pracownika.

Uruchomienie procesu (zadanie: START)

Uruchomienie procesu następuje z poziomu skrzynka pracownika, który jest opiekunem Czynności: Uruchomienie, przypisanej do zadania: START. Odbywa się on po naciśnięciu w oknie: Skrzynka pracownika, przycisku: [Dodaj proces], który spowoduje otworzenie okna: Procesy do uruchomienia. W oknie, należy wybrać proces: Sprawdzenie wysokości sprzedaży i nacisnąć przycisk: [Wybierz].

Po wybraniu procesu, zostanie otworzone okno: Proces, w którym podane są podstawowe dane uruchamianego procesu.

Po zapisaniu okna (przycisk: ) proces zostanie uruchomiony i przejdzie do następnego etapu: AKTYWNY.

Proces w etapie: AKTYWNY

Czynności w zadaniu: AKTYWNY, wykonywane są przez Opiekuna automatycznego. Polegają one na wykonywaniu zapytań SQL, sprawdzających czy wartość sprzedaży w danym dniu przekroczyła 10000 zł. Jeżeli warunek zostanie spełniony, wtedy proces przechodzi do etapu: E-MAIL, polegającego na wysłaniu wiadomości e-mail o przekroczeniu wartości sprzedaży 10000 zł. Jeżeli warunek nie zostanie spełniony, proces będzie dalej „wracał” do zadania: AKTYWNY, czyli zapytanie będzie dalej ponawiane.

Proces w etapie: E-MAIL

Etap: E-MAIL, polega na wysłaniu wiadomości e-mail o przekroczeniu wartości sprzedaży 10000 zł. Opiekunem dla tej czynności jest również Opiekun automatyczny, co oznacza, że zostanie ona wykonana automatycznie, po przejściu procesu do tego zadania. Treść wiadomości, jaka zostanie wysłana określona jest w definicji procesu, w oknie: Definicja Akcji, na zakładce: Parametry (więcej informacji o definiowaniu akcji: Wysłanie wiadomości e – mail znajduje się w rozdziale: Określanie parametrów dla akcji kluczowych. Po wysłaniu wiadomości, osiągnięty zostanie cel procesu. Przejdzie on zatem do etapu (zadania) CZEKAJ, w którym proces będzie „oczekiwał” 1 dobę.

Proces w etapie: Czekaj

W etapie: Czekaj, wykonywana jest akcja automatyczna, polegająca na wstrzymaniu na jedną dobę sprawdzania, czy wysokość sprzedaży została przekroczona ponad 10000 zł. Również dla tej czynności został ustalony Opiekun automatyczny, a czas oczekiwania wynika z ustawienia w oknie: Definicja zadania procesu (Czekaj), na zakładce: Ogólne, parametru: Data realizacji, na 1 dzień (więcej informacji w rozdziale: Zdefiniowanie zadania: Czekaj). Po upływie jednego dnia, proces ponownie przejdzie do zadania: AKTYWNY, w którym nastąpi sprawdzanie wysokości sprzedaży (więcej informacji w rozdziale: Proces w etapie: AKTYWNY).

Nowe funkcjonalności w procesach

Obsługa BST

W wersji 2013.5 lista obiektów Systemu obsługiwana w procesach została uzupełniona o dokument Bilansu Stanu Towarów BST. Dla obiektu tego udostępnione zostały akcje kluczowe odpowiadające operacjom dokonywanym na tym dokumencie:

Możliwe parametry:

Usuwanie bilansu stanu towarów

Akcja powinna odpowiadać operacji usuwania dokumentu z poziomu interfejsu

Oprócz akcji wynikających ze specyfiki dokumentu BST, udostępnione zostały akcje ogólne, podobnie jak dla innych obiektów Systemu:

Podczas konwersji bazy, czy też tworzenia nowej bazy System dodaje predefiniowany proces przeliczania dokumentu BST, aby z niego skorzystać, wystarczy zaznaczyć na nim parametr „Aktywny”. Po włączeniu w Systemie obsługi procesów i uruchomieniu XLWorkAutomat Użytkownik może ustawić na konkretnym dokumencie BST zadanie wykonania automatycznego przeliczenia BST w określonym czasie. Aby tego dokonać wystarczy zaznaczyć parametr „Przelicz”, ustalić żądany czas aktualizacji i zlecić jej wykonanie poprzez uruchomienie opcji „przelicz bilans”.

Rys. 56

Obsługa Planu Produkcji

W wersji 2014 lista obiektów Systemu obsługiwana w procesach została uzupełniona o dokument Planu Produkcji. Dla obiektu tego udostępnione zostały akcje kluczowe odpowiadające operacjom dokonywanym na tym dokumencie:

Dla obiektu Planu produkcji dostępne będą również akcje wspólne dla wszystkich obiektów:

Podczas konwersji bazy, czy też tworzenia nowej bazy System dodaje predefiniowany proces przeliczania dokumentu Planu produkcji, aby z niego skorzystać, wystarczy zaznaczyć na nim parametr „Aktywny”. Po włączeniu w Systemie obsługi procesów i uruchomieniu XLWorkAutomat Użytkownik może ustawić na konkretnym dokumencie Planu produkcji zadanie wykonania automatycznego przeliczenia planu w określonym czasie. Aby tego dokonać wystarczy zaznaczyć parametr „Przelicz”, ustalić żądany czas aktualizacji i zlecić jej wykonanie poprzez uruchomienie opcji „Przeliczenie Plan produkcji”.

Obsługa wiązania zasobów z rezerwacjami

Od wersji 2016.2 została udostępniona akcja kluczowa w procesach: „Rezerwowanie zasobów”, dostępna dla procesu podpiętego do gałęzi procesów bez obiektu. Akcja ta będzie wyzwalała operację przypisywania zasobów do aktywnych, ważnych rezerwacji sprzedażowych.

Podczas kreacji i konwersji bazy zostanie dodany predefiniowany proces „Przypisywanie zasobów do rezerwacji” z użyciem ww. akcji, który wystarczy aktywować (zaznaczyć checkbox „Aktywny”) oraz uruchomić (wykonać 1-wsze zadanie), aby uzyskać funkcjonalność automatycznego wiązania zasobów za pomocą procesu. Operatorem „wykonującym” zadanie Rezerwowania zasobów w ww. predefiniowanym procesie jest automat, a efekt „cykliczności” i powtarzalności ww. operacji uzyskany został na nim poprzez przypisanie jako czynności „wynikowej” dla Rezerwowania zasobów tej samej czynności. Zmiany częstotliwości powtarzania akcji Użytkownik może dokonać poprzez zmianę parametrów zadania (edycja definicji zadania, sekcja Data realizacji, Termin realizacji).

Akcję kluczową Rezerwowanie zasobów można wykorzystywać także w innych procesach. Parametrami funkcji definiowanymi na zakładce Parametry są:

Procesy w produkcji

Od wersji 2017.1 systemu Comarch ERP XL udostępniono funkcjonalność procesów dla wybranych operacji wykonywanych w module Produkcja. Dla grupy obiektów: Produkcja, dla istniejących już obiektów: Zlecenie produkcyjne i Harmonogram projektu dodane zostały nowe predefiniowane akcje kluczowe:

Przeplanowanie zlecenia produkcyjnego – Akcja odpowiada przeplanowaniu ZP z poziomu interfejsu systemu. Akcja ta wymaga dodatkowej parametryzacji. Na zakładce: Parametry, na definicji tej akcji, należy podać odpowiedni numer, oznaczający wybrany sposób przeplanowania zleceń:

Aktualizacja rezerwacji – Akcja odpowiada dostępnej z poziomu interfejsu systemu, funkcji: Aktualizacja rezerwacji

Realizacja zlecenia produkcyjnego – Akcja odpowiada wykonaniu realizacji całego dokumentu ZP.

Generowanie dokumentów ze zlecenia produkcyjnego – za pomocą akcji możliwe będzie automatyczne wygenerowanie z ZP dokumentów RW lub PW. Akcja wymaga dodatkowej parametryzacji. Na zakładce: Parametry, na definicji tej akcji, należy podać, jaki rodzaj dokumentu ma być generowany za pomocą akcji:

Rozliczanie zlecenia produkcyjnego – Akcja odpowiada funkcji: Rozliczanie zleceń, dostępnej z poziomu interfejsu systemu.

Zamykanie zlecenia produkcyjnego – Akcja odpowiada zamknięciu ZP z poziomu interfejsu systemu. Akcja ta wymaga dodatkowej parametryzacji. Na zakładce: Parametry, na definicji tej akcji należy podać odpowiedni numer, oznaczający wybrany sposób zamykania zleceń:

Uwaga! Dla obiektu : Harmonogram operacji, wprowadzono analogicznie, jak ww. akcje kluczowe. Dodatkowo udostępniono w systemie predefiniowane definicje procesów, które mogą stanowić wzór do budowania nowych procesów w Produkcji:

Od wersji 2018.1 w definicji procesów, do obiektu: Plan produkcji, dodano nową akcję kluczową: Generowanie rekomendacji na podstawie wzorca.

Akcja ta odpowiada operacji generowania rekomendacji na podstawie wzorca i jest ona parametryzowana. W oknie definicji Akcji, na zakładce [Parametry], należy podać Id wzorca, na podstawie którego mają być generowane rekomendacje. Jeśli nie zostanie wskazany nr Id wzorca, wówczas rekomendacje będą generowane na podstawie wzorca domyślnego.

Dodatkowo, dla grupy obiektów: Produkcja, w definicji procesów, wprowadzono nowe obiekty: Rekomendacja do produkcji i Rekomendacja do zakupu ze standardowymi akcjami: Uruchomienie innego procesu, Uruchomienie programu zewnętrznego, Wykonanie skryptu SQL, Wysłanie wiadomości e-mail, Zakończenie całego procesu.

Procesy na AWD i ZWM

Od wersji 2018.1 udostępniono funkcjonalność procesów dla dokumentów magazynowych: AWD, ZWM.

Do nowego obiektu poza standardowymi udostępniono nowe akcje kluczowe:

Akcje jw. przy wskazaniu na dokumencie magazynu z włączoną obsługą WMS, operują na dokumentach (W)AWD, (W)ZWM. Dla tychże dokumentów, ze względu na inną ich koncepcje, procesy powinny być trochę inaczej definiowane. Należy tu mieć na uwadze m.in.:

Generowanie spinacza

W wersji 2019.0 lista akcji kluczowych w Procesach została wzbogacona o akcję Generowanie spinacza, pozwalającą na utworzenie faktury typu spinacz z wydania zewnętrznego/przyjęcia zewnętrznego. Akcja ta jest alternatywą dla dostępnej już od wielu wersji akcji Dołączenie do spinacza. W przypadku akcji dołączenia do spinacza, jak sama nazwa akcji wskazuje System dołącza dokument do niezatwierdzonego spinacza, dopiero jeżeli takowego nie ma w Systemie, wówczas tworzy nowy spinacz. W przypadku akcji generowania spinacza System zawsze tworzy nowy spinacz dla danego dokumentu wydania/przyjęcia. Rodzaj spinacza, który ma zostać utworzony w tej akcji należy zdefiniować na zakładce [Parametry] tej akcji, przykładowo będzie to dla WZ:

Proces jako usługa

Od wersji 2017.0 działa mechanizm, który będzie tworzył działającą usługę samodzielnie przez aplikację.

Służy do tego parametr Obsługa procesów za pomocą usługi. Warunkiem jest aby Operator Systemu Operacyjnego Windows miał uprawnienia do logowania w trybie usługi.

Graficzna prezentacja definicji procesu

Od wersji 2019.0 możliwa jest graficzna prezentacja procesu. Takie wyświetlenie procesu wpłynie na czytelność

i pozwoli zweryfikować poprawność jego definicji.

Na formatkach związanych z procesami jest dostępny przycisk umożliwiający podgląd graficzny wykresu.

Podgląd graficzny wykresu umożliwia:

Graf zawiera dwie główne sekcje:

Dla wyświetlania elementów procesu przyjęto następujące zasady domyślne:

Domyślną kolorystykę można dowolnie modyfikować za pomocą panelu: Wybór kolorów, znajdującego się w dolnej części diagramu.

Podłączanie drukarki fiskalnej lokalnie

Aby podłączyć drukarkę fiskalną do systemu Comarch ERP XL należy:

Po wprowadzeniu wszystkich ustawień należy zakończyć pracę we wszystkich modułach systemu Comarch ERP XL i rozpocząć pracę na nowo.

Ustawienia portu COM

Ustawienia portów COM wprost wpływają na działanie drukarek fiskalnych w programie. Tym samym należy poprawnie ustawić port COM zgodnie z instrukcją użytkownika drukarki.

Elzab
Szybkość	9600, 19200
Parzystość	Parzyste (Even)
Liczba bitów	8
Bit stopu	1
Sterowanie	Brak, xon/xoff, Sprzętowe

Posnet (Novitus, Innova)
Szybkość	9600
Parzystość	Brak (None)
Liczba bitów	8
Bit stopu	1
Sterowanie przepływem	Brak

Właściwości portu COM są dostępne w Menedżerze urządzeń systemu Windows.

Konfiguracja sterownika, portu COM, do którego jest podłączona drukarka fiskalna oraz pozostałych parametrów

Wybranie sterownika oraz portu COM można wykonać w Menu Comarch ERP XL -> System -> Konfiguracja komputera na zakładce: Drukarka fiskalna.

Od archiwalnej już wersji 2013.5, zostały wprowadzone dodatkowe sterowniki do obsługi drukarek fiskalnych obsłużone w Konfiguracji komputera na zakładce: Drukarka fiskalna 2.

Na zakładce: Drukarka fiskalna w polu: Nazwa pliku sterowania należy wskazać sterownik. Sterownik należy wybrać po naciśnięciu ikony: [Wybierz plik]. Wymagane pliki sterowników znajdują się w katalogu, do którego został zainstalowany system Comarch ERP XL. Sterowniki te należy dobierać w zależności od typu drukarki i rodzaju pracy (stacjonarna, przez terminal).

DF300.dll	Drukarki Posnet Thermal, Emar Printo
DF300_1.dll	Drukarki zgodne z Posnet
FP600.dll	Drukarki firmy Elzab
Innova.dll	Drukarki firmy Innova
Novitus.dll	Drukarki firmy Novitus

Jeżeli drukarka fiskalna podłączana jest do portu USB, to w oknie: Parametry komputera pojawia się dodatkowy port COM z kolejnym numerem.

Następnie należy ustawić port COM, zarówno na zakładce: Drukarka fiskalna, jak i Drukarka fiskalna 2:

Po ustawieniu sterownika i portu COM należy:

• Wykonać test sterownika naciskając przycisk [Test sterownika] – po jego wykonaniu otrzymujemy informacje na temat: Nazwy, Wersji oraz Typu sterownika. Opcja ta jest dostępna jedynie na zakładce: Drukarka fiskalna;

Zdefiniować dodatkowe ustawienia, tj.:

W konfiguracji drukarki fiskalnej z zakładki : Drukarka fiskalna 2 dostępna jest opcja drukowania fiskalnego poprzez Drukarkę sieciową

Mapowanie stawek VAT

Kolejną czynnością jaką należy wykonać jest mapowanie stawek VAT. Można je wykonać z poziomu dowolnego modułu, menu System -> Konfiguracja komputera -> zakładka: Sprzedaż -> Słownik: Drukarki fiskalne.

Po naciśnięciu przycisku: [Dodaj] podnosi się okno: Drukarka fiskalna – zostanie dodana.

W oknie: Drukarka fiskalna znajduje się parametr: Nowy sterownik. Jeżeli w Konfiguracji komputera na zakładce:

Jeśli nie zostanie wybrana współpraca z zastosowaniem tzw. Nowych sterowników, to w polu: Nazwa należy wpisać nazwę wybranego wcześniej sterownika drukarki.

Jeśli zostanie wybrana współpraca z zastosowaniem tzw. Nowych sterowników, czyli zostanie zaznaczony ww. parametr: Nowy sterownik, to pole: Nazwa wypełni się automatycznie i w polu: Opis zostanie uaktywnione pole z listą drukarek, gdzie należy wskazać odpowiedni model (dla pracy w trybie terminalowym na końcu nazwy drukarki będzie słowo: Terminal):

W kolumnie: Odpowiednik wskazujemy odpowiednik literowy stawki VAT zmapowanej na drukarce fiskalnej. Aby uzyskać mapowanie stawek VAT z drukarki fiskalnej można wydrukować Raport dobowy z drukarki fiskalnej.

Zafiskalizowanie bazy danych

Jeżeli system Comarch ERP XL ma pracować z drukarką, która jest zafiskalizowana (taką drukarkę otrzymuje zwykle klient), to jego baza również musi być zafiskalizowana.

Jeżeli podłączona drukarka fiskalna nie jest zafiskalizowana (taką drukarkę zwykle udostępnia się do testów systemu), to baza systemu Comarch ERP XL również powinna być niezafiskalizowana.

Aby zafiskalizować bazę Comarch ERP XL należy uruchomić Konfigurację, przejść na zakładkę: Sprzedaż -> zakładkę: Parametry 1 i za pomocą przycisku: [Data fiskalizacji systemu] wybrać datę i zapisać Konfigurację.

Po zafiskalizowaniu bazy danych nie można jej odfiskalizować od strony interfejsu. Jeżeli istnieje potrzeba odfiskalizowania systemu, np. w sytuacji, kiedy pracowaliśmy testowo z drukarką fiskalną, to można to zrobić od strony bazy danych poniższym updatem:

update cdn.konfig set kon_wartosc = ” where kon_numer = 995

Podłączanie drukarki fiskalnej przez Terminal Services

System Comarch ERP XL posiada możliwość pracy w środowisku Terminal Services (TS). Istotnym elementem pracy tego systemu jest możliwość korzystania z drukarek fiskalnych. Przepisy wymagają od użytkownika drukarek fiskalnych umieszczenia ich na stanowisku gdzie odbywa się sprzedaż fiskalna.

W środowisku terminalowym oznacza to podłączenie drukarki fiskalnej do komputera, na którym pracuje klient terminala. W przypadku systemów Microsoft Windows Terminal Serwer do podłączenia drukarki fiskalnej do portu COM stanowiska terminalowego należy wykorzystać stworzone w ERP XL oprogramowanie tzw. sterowników terminalowych do drukarek fiskalnych. Powodem jest to, że drukarka fiskalna działa bez zarzutu przy wykorzystywaniu mapowania portów w TS na Windows 2000 w sieci LAN, natomiast w sieci WAN pojawiają się problemy. Wynika to z faktu, że domyślny timeout zapisany w sterownikach do drukarek wynosi około 2 s. W praktyce okazało się, że jest to zbyt krótki czas, aby sterownik nawiązał połączenia z drukarką przez wirtualne połączenia COM i otrzymał odpowiedź, czy też potwierdzenie od strony drukarki. Problem praktycznie nie występuje w sieciach LAN, gdzie prędkości transmisji, są zwykle w granicach 100 Mb/s, a w połączeniach przez sieć Internet mogą pojawiać się problemy.

W przypadku drukowania fiskalnego przez terminal przy użyciu pakietu tzw. sterowników terminalowych do drukarek fiskalnych, połączenie serialowe jest lokalne, tzn. sterownik, który je nawiązuje jest zainstalowany na stacji roboczej, do której podłączona jest drukarka. Komunikacja systemu Comarch ERP XL (działającego na serwerze terminali) z tym sterownikiem, odbywa się za pomocą kanału wirtualnego RDP, czyli po protokole TCP/IP.

Oprogramowanie pozwala na przekazanie do końcówki terminala danych dla drukarki fiskalnej poprzez tak zwany kanał wirtualny. Aby przekazywanie danych do drukarki mogło mieć miejsce zarówno po stronie końcówki terminala jak i po stronie serwera musi być zainstalowane odpowiednie oprogramowanie. Wymagane pakiety z oprogramowaniem można znaleźć na stronach ERP XL.

Zawartość pakietu obsługi drukarek fiskalnych po stronie klienta usługi terminalowej		Zawartość pakietu obsługi drukarek fiskalnych po stronie serwera usługi terminalowej
DF300.dll	Sterownik do drukarek Posnet	DF300T.dll	Odpowiednik sterownika DF300.dll po stronie serwera
DF300_1.dll	Sterownik do drukarek zgodnych z Posnet	DF300_1T.dll	Odpowiednik sterownika DF300_1.dll po stronie serwera
FP600.dll	Sterownik do drukarki FP600	FP600T.dll	Odpowiednik sterownika FP600.dll po stronie serwera
Innova.dll	Sterownik do drukarki Innova	InnovaT.dll	Odpowiednik sterownika Innova.dll po stronie serwera
Novitus.dll	Sterownik do drukarki Novitus	NovitusT.dll	Odpowiednik sterownika Novitus.dll po stronie serwera
RDP.dll	Sterowniki do komunikacji przez połączenie terminalowe	KFdrv.dll	Sterownik do komunikacji przez połączenie terminalowe, po stronie serwera
rdpcli.inf	Plik dla instalatora Windows dla systemów Windows 2000/XP
Rdpcli98_1.reg	Plik rejestru dla Windows 98 cz.1
Rdpcli98_2.reg	Plik rejestru dla Windows 98 cz. 2

Instalacja i konfiguracja komponentów na serwerze

Program Comarch ERP XL nawiązuje połączenie z drukarką fiskalną poprzez API udostępnione przez bibliotekę drivera fiskalnego.

W przypadku współpracy z drukarką podłączoną do konsoli klienta usługi terminalowej należy w konfiguracji programu wybrać odpowiednio zmodyfikowany driver, przeznaczonego do pracy w TS. Dodatkowe drivery oznaczone są literą T (terminal) dodaną do nazwy standardowego drivera (DF300T.dll, DF300_1T.dll, FP600T.dll, InnovaT.dll).

Wszystkie wymagane pliki powinny znajdować się w katalogu, do którego został zainstalowany system ERP XL.

Mapowanie stawek VAT powinno być wykonane tak, jak dla stacji lokalnej – mimo, iż wybieramy sterownik z literą T, to nazwa mapowania jest bez literki T.

Instalacja pakietu na stacji roboczej spełniającej rolę klienta usługi terminalowej

System Windows 7/8/10

W systemie Windows 7/8/10 można wykonać automatyczną instalację za pomocą rdpcli.inf.

Aby to zrobić należy z serwera z katalogu, do którego został zainstalowany system Comarch ERP XL skopiować pliki:

do tego samego dowolnego katalogu na stacji klienckiej. Następnie należy wskazać myszą plik rdpcli.inf, nacisnąć prawy przycisk i wybrać z menu kontekstowego opcję: Zainstaluj. Instalator dokonuje automatycznego przeniesienia plików do wymaganej lokalizacji na stacji klienckiej (C:\Windows\system32) oraz dokonuje niezbędnych wpisów w rejestrze systemu Windows.

Należy również ustawić właściwości portu COM, więcej w rozdziale: Ustawienia portu COM.

Przed nawiązaniem połączenia z serwerem terminali należy udostępnić Porty szeregowe dla połączenia terminalowego.

Konfiguracja sesji użytkownika

Do prawidłowego funkcjonowania drukarki wymagane są następujące działania, po stronie aplikacji uruchomionej w sesji terminalowej, na koncie każdego użytkownika, pracującego z drukarką fiskalną:

Najczęściej popełniane błędy konfiguracyjne

Zgodność plików KFdrv.dll i Rdp.dll

Zwykle większość problemów związanych z drukarkami fiskalnymi opiera się na niezgodności wersji pliku KFdrv.dll po stronie serwera (w katalogu, w którym został zainstalowany system Comarch ERP XL) oraz pliku rdp.dll po stronie klienta (w katalogu C:\Windows\System32). Jeżeli wersje plików są niezgodne nie istnieje komunikacja drukarki z serwerem terminali.

Jeżeli wersje plików są zgodne oraz drukarka jest prawidłowo podłączona, to test drukarki wykonany za pomocą przycisku [Test drukarki] kończy się komunikatem: Drukarka podłączona.

Przeinstalowanie systemu Comarch ERP XL

Patrz UWAGA w rozdziale Zgodność plików KFdrv.dll i rdp.dll.

Zapisy w rejestrze systemu Windows

W trakcie przygotowywania biuletynu i testów udało się uzyskać sytuację, w której brak połączenia był spowodowany faktem, iż na stacji klienckiej drukarka fiskalna została najpierw skonfigurowana lokalnie – wprowadzono ustawienia umożliwiające pracę lokalną z drukarką fiskalną.

Remedium było usunięcie z rejestru systemu Windows klucza: Fiskalne z gałęzi: HKEY_CURRENT_USER -> Software -> CDN.

Drukarka fiskalna w pracy terminalowej- nowe sterowniki

Oprogramowanie pozwala na przekazanie do końcówki terminala danych dla drukarki fiskalnej przez tak zwany kanał wirtualny. Aby przekazanie danych mogło mieć miejsce zarówno po stronie klienta, jak i po stronie serwera, musi być zainstalowane odpowiednie oprogramowanie.

Instalacja i konfiguracja komponentów na serwerze

Instalacja sterowników do obsługi drukarek fiskalnych odbywa się wraz z instalacją programu Comarch ERP XL. Konfiguracja programu do współpracy z drukarką fiskalną polega na wybraniu odpowiedniego sterownika przeznaczonego do pracy przez terminal.

W menu głównym systemu Comarch ERP XL (uruchamianym plikiem CDNXL.exe) lub w module Administrator wchodzimy do Konfiguracji komputera.

Aby skorzystać z nowych sterowników, na zakładce Drukarka fiskalna 2 zaznaczamy opcję „Używaj nowych sterowników”. W polu model drukarki wybieramy urządzenie, z którym będzie współpracował system. Przy pracy przez usługę terminalową ważne jest aby sterownik w nazwie miał dopisek „Terminal”. Następnie wybieramy numer portu, jego prędkość i sterownie przepływem (zgodnie z ustawieniami na drukarce i we właściwościach portu COM w Menedżerze urządzeń).

Instalacja i konfiguracja komponentów na końcówce terminala

Po stronie końcówki terminala, czyli komputera, na którym pracuje klient i do którego jest podłączona drukarka fiskalna, należy zainstalować komponenty zajmujące się obsługą kanału wirtualnego oraz połączeniem systemu z drukarką.

Plik instalacyjny znajduje się w głównym katalogu systemu Comarch ERP XL: onlineFP.exe

Aby zainstalować obsługę terminalową drukarek fiskalnych, należy plik przegrać na końcówkę terminala. Następnie zainstalować na końcówce. Oprogramowanie po stronie klienta składa się z plików obsługujących kanał wirtualny i ze sterowników do drukarek. Wszystkie te pliki kopiowane są do katalogu wskazanego w trakcie instalacji.

Po prawidłowo wykonanej instalacji na końcówce terminala i konfiguracji komponentów można wykonać test połączenia. W tym celu po połączeniu się z serwerem należy uruchomić system, wejść w Konfigurację komputera i na zakładce Drukarki fiskalne 2, w sekcji Test drukarki, uruchomić test odpowiednim przyciskiem.

W przypadku prawidłowego otrzymamy komunikat Drukarka podłączona. To oznacza, że drukarka jest podłączona i skonfigurowana poprawnie. Jeżeli system nie uzyska połączenia pojawi się komunikat Brak połączenia z drukarką. Należy wówczas sprawdzić poprawność podanego numeru portu, jego prędkości i sterownia przepływem, porównać je z ustawieniami na urządzeniu fiskalnym i z właściwościami portu COM w Menedżerze urządzeń.

Drukowanie fiskalne przez Drukarkę sieciową

W systemie Comarch ERP XL obsłużona została funkcja drukowania fiskalnego na drukarce podłączonej do serwera wydruków fiskalnych. Serwer wydruków fiskalnych jest oddzielną usługą w systemie Windows z którą końcówki wystawiające dokumenty fiskalne łączą się za pomocą protokołu TCP/IP, domyślnie portem na którym pracuje serwer wydruków fiskalnych to port 3500, w momencie instalacji można podać inny nr. portu dla tej usługi.

Instalacja serwera wydruków fiskalnych

Do instalacji usługi fiskalnego drukowania sieciowego służy aplikacja ComarchOnlineFPServerInstaller.exe

Parametry z jakimi uruchamiamy instalator są następujące:

/i – instalacja pakietu z domyślnymi parametrami

/w <USER_LOGIN> [<USER_PASSWORD>] – instalacja z zmianą loginu na którym pracuje usługa serwera wydruków fiskalnych

/tcp <TCP_Port> – ustawienia innego nr portu na którym pracuje usługa niż 3500

/start – uruchomienie usługi

/stop – zatrzymanie usługi

/u – odinstalowanie usługi

W systemach gdzie uruchomiona jest zapora sieciowa należy dodać wyjątek do zapory dla portu 3500 lub innego ustawionego portu, bądź dodać wyjątek dla aplikacji(usługi): Comarch ERP Fiscal Server.

Podłączenie ERP XL do serwera wydruków fiskalnych

Konfigurację stanowiska do współpracy z sieciową drukarką fiskalną wykonujemy w oknie Parametry komputera na zakładce: Drukarka fiskalna 2 po załączeniu parametru: Drukarka sieciowa , pod ikoną lupy pojawia się możliwość konfiguracji połączenia do drukarki: Ustaw parametry sieciowe.

Okno Parametry drukarki sieciowej pozwala na podanie:

Operacje fiskalne obsługiwane w systemie Comarch ERP XL

Dokumenty fiskalizowane w systemie Comarch ERP XL

W systemie Comarch ERP XL można zafiskalizować:

System umożliwia również wydrukowanie kaucji jako dodatkowych pozycji paragonu fiskalnego.

Drukowanie kaucji na paragonie fiskalnym

W Comarch ERP XL istnieje możliwość drukowania kaucji z dokumentu wydania kaucji (WKA) na drukarce fiskalnej. Aby elementy dokumentu WKA zostały wydrukowane na paragonie fiskalnym, dokument WKA musi być związany z fiskalizowanym dokumentem, np. PA. W trakcie zatwierdzania dokumentu PA, elementy tego dokumentu są drukowane na drukarce fiskalnej; po wydrukowaniu wszystkich elementów PA drukarka fiskalna drukuje kaucje z dokumentu WKA w części niefiskalnej paragonu.

Parametr Drukuj kaucje

Jeżeli drukarka fiskalna nie posiada obsługi drukowania kaucji należy odznaczyć parametr: Drukuj kaucje w Konfiguracji komputera, zakładka: {Drukarka fiskalna}.

Menu Fiskalne

Jeżeli mamy prawidłowo skonfigurowaną drukarkę, to mamy dostęp z każdego modułu do Menu Fiskalne:

Z poziomu tego Menu możemy wykonać na drukarce fiskalnej:

Powtórna fiskalizacja dokumentu

W sytuacjach, w których dokument nie został zafiskalizowany na drukarce fiskalnej, a jest dokumentem zatwierdzonym (na liście paragonów, taki dokument wyświetlony jest na żółto), to można go zafiskalizować na drukarce fiskalnej.

Aby to zrobić z Menu Fiskalne wybieramy przycisk – otwiera się okno: Fiskalizacja dokumentów. Aby wybrać dokument do powtórnej fiskalizacji należy nacisnąć przycisk: [Dokument].

W oknie Fiskalizacja dokumentu naciskamy przycisk: [Fiskalizuj dokument].

Drukuj numer NIP na paragonie

W wersji 2018.2 w konfiguracji komputera na zakładce Drukarka fiskalna 2, dodano parametr: Drukuj numer NIP. Parametr dostępny jest dla nowych sterowników fiskalnych. Zaznaczenie tego parametru ma sens tylko dla tych drukarek, które posiadają zgodnie z przepisami możliwość drukowania numeru NIP w określonym miejscu paragonu. W przypadku starszych modeli drukarek, po zaznaczeniu tego parametru podczas drukowania paragonu pojawi się błąd. Równocześnie zrezygnowano z drukowania numeru NIP w części niefiskalnej paragonu, w sytuacji, gdy zaznaczono parametr Wyświetlaj numer paragonu.

Problemy z drukowaniem fiskalnym dokumentów

Brak możliwości wydrukowania dokumentu na drukarce fiskalnej może być spowodowany m.in.:

Nieprawidłowa konfiguracja systemu

Brak połączenia z drukarką w połączeniu terminalowym

Opis znajduje się w rozdziale: Najczęściej popełniane błędy konfiguracyjne.

Ustawienia portu COM dla drukarki FP600 starej homologacji

W trakcie testów okazało się, że dla drukarek Elzab FP600 starej homologacji należy ustawić sterowanie przepływem na: Sprzętowe.

Jeżeli ustawimy sterowanie przepływem na: brak, to dokumenty fiskalizują się na drukarce fiskalnej, a w systemie Comarch ERP XL otrzymujemy komunikat o braku możliwości zamknięcia dokumentu. Tym samym otrzymujemy niezafiskalizowany dokument w Comarch ERP XL mimo, iż zafiskalizował się on na drukarce fiskalnej.

Remedium

Dla drukarek Elzab FP600 starej homologacji ustawić sterowanie przepływem na: Sprzętowe.

Nieprawidłowe mapowanie stawek VAT

Jeżeli wykonano nieprawidłowe mapowanie stawek VAT – wskazano odpowiedniki o innych stawkach niż są zmapowane w drukarce fiskalnej – to dana pozycja dokumentu może wydrukować się na drukarce fiskalnej z inną stawką podatku niż wskazana w Comarch ERP XL lub może się nie wydrukować. Brak możliwości wydrukowania może objawić się komunikatem:

oraz anulowaniem paragonu na drukarce fiskalnej – komunikat na paragonie: „paragon anulowany”.

Remedium

Należy poprawnie zamapować stawki VAT wg instrukcji z rozdziału: Mapowanie stawek VAT.

Nieprawidłowa nazwa towaru

Każda drukarka fiskalna ma określoną minimalną długość nazwy towaru oraz listę znaków specjalnych, która nie jest obsługiwana. Jeżeli nazwa towaru nie spełnia kryteriów określonych w specyfikacji drukarki fiskalnej dana pozycja nie zostanie na niej wydrukowana. Może się to objawić następującym komunikatem:

Remedium

Należy zmienić nazwę towaru w karcie towaru w taki sposób, aby spełniała wymagania specyfikacji drukarki fiskalnej. Następnie usunąć i dodać daną pozycję z dokumentu, który chcemy zafiskalizować.

W takiej sytuacji należy zmienić nazwę towaru w taki sposób, aby spełniała kryteria ze specyfikacji.

Kod autoryzacyjny drukarki

Niektóre drukarki posiadają zaimplementowany „kod autoryzacyjny” ważny w zadanym okresie czasu. Przykładowo, jeżeli drukarka posiada 30 dniowy kod autoryzacyjny tzn. po 30 dniach drukarka przestaje działać i nie drukuje jakiekolwiek paragonu, w systemie prezentowany wówczas jest następujący komunikat:

Remedium

Należy sprawdzić czy „kod autoryzacyjny” funkcjonuje na urządzeniu i czy Użytkownik bądź Serwis wprowadził taki kod, który odblokowuje drukarkę „na zawsze”.

W przypadku, gdy drukarka nie posiada kodu autoryzacyjnego, a w systemie podczas zapisu dokumentu występuje komunikat: NowyParagon 3 należy wykonać z poziomu Comarch CDN XL, menu Fiskalne-> Raport dobowy. Po wykonaniu Raportu dobowego na drukarce problem powinien ustąpić.

Niezgodność wartości elementu

Element transakcji nie zostanie zafiskalizowany na drukarce fiskalnej jeżeli nie jest spełnione równanie ilość*cena=wartość. Jeżeli równanie jest niespełnione, to możemy uzyskać następujący komunikat:

oraz na drukarce fiskalnej: „paragon anulowany”.

Remedium

Należy sprawdzić, czy są zaznaczone parametry w Elemencie transakcji:

Powyższe parametry powinny być zaznaczone dla fiskalizowanego elementu.

Następnie należy sprawdzić równanie ilość*cena=wartość. Jeżeli nie jest spełnione, to wprowadzić prawidłową wartość na element.

Zmieniona stawka podatku VAT dla danego towaru

Zmiana stawki podatku VAT w karcie towaru lub w elemencie transakcji może uniemożliwić zafiskalizowanie danej pozycji na drukarce fiskalnej. Objawia się to komunikatem:

oraz na drukarce fiskalnej: „błąd PTU paragon anulowany”.

Remedium

Rozwiązaniem jest:

Problemy sprzętowe

Jeżeli mamy wprowadzone prawidłowo wszystkie ustawienia wg tego biuletynu, a mimo to nadal nie drukują się nam dokumenty na drukarce fiskalnej, to istnieje duże prawdopodobieństwo, że jest to spowodowane problemami sprzętowymi – uszkodzeniem drukarki fiskalnej, uszkodzeniem przewodów, uszkodzeniem portu COM itp.

Remedium

W takich sytuacjach należy:

Lista komunikatów i przyczyna występowania

Sprzedaż: informacja (2092)

Patrz rozdział: Ustawienia portu COM dla drukarek FP600 starej homologacji.

Sprzedaż: informacja (2093), Szczegóły >> brak

Patrz rozdziały:

Sprzedaż: informacja (2093), Szczegóły >> Towar posiada nieprawidłową nazwę

Rysunek 33 Sprzedaż: informacja (2093), Szczegóły >> Towar posiada nieprawidłową nazwę (…)

Patrz rozdział: Nieprawidłowa nazwa towaru

Pulpit operatora

Dashboardy są to pulpity zmieniające wygląd interfejsu. Użytkownik Systemu może przygotować własny pulpit z obiektami, z których korzysta najczęściej, dzięki czemu dostęp do nich będzie szybszy, a układ spersonalizowany. Dodatkowo, poza standardowymi obiektami na pulpicie można dodać widżet z odwołaniem do dowolnej strony www, innego programu czy raportów BI. Włączenie dostępu do konfiguracji pulpitu odbywa się w: Ustawieniach użytkownika.

Pulpity predefiniowane

Wraz z możliwością kreowania własnych pulpitów dla Użytkowników, udostępnione zostały pulpity tzw. predefiniowane, stanowiące bazę jak pulpity mogą wyglądać, z przykładowymi obiektami i ułożeniem. Te predefiniowane pulpity mogą być przypisane do operatorów i w proponowanej wersji używane lub można je indywidualnie modyfikować wg własnych potrzeb i upodobań. Funkcjonalność dashboardów pozwala użytkownikowi zdefiniować własne pulpity, odrębnie do predefiniowanych.

Przypisywanie pulpitów predefiniowanych do operatora

Aby udostępnione predefiniowane pulpity, a także te pulpity, które zostały przygotowane przez administratora jako predefiniowane mogły być używane przez Użytkownika, należy Mu je przypisać. W tym celu na karcie operatora dodana została stosowna sekcja dla przypisywania predefiniowanego pulpitu. Z uwagi na możliwość korzystania z więcej niż jednego pulpitu, na liście prezentowane są wszystkie pulpity przypisane do operatora. Przypisanie pulpitu do operatora odbywa się poprzez kopiowanie rekordu w bazie z danym pulpitem predefiniowanym, a następnie uzupełnianie numeru operatora, któremu pulpit jest przypisywany. Jednocześnie udostępniona została opcja usuwania pulpitu konkretnemu operatorowi. Oznacza to usunięcie pulpitu operatora z bazy danych. Działanie jest tożsame z usunięciem pulpitu z poziomu konfiguracji.

Wskazanie predefiniowanego pulpitu jest możliwe również na wzorcu operatora. Dzięki temu można przy pomocy funkcjonalności aktualizacji kart operatorów grupowo przypisać operatorom konkretny predefiniowany pulpit. Także dodając nową kartę operatora w kontekście wzorca, można na samym początku przypisać do niego wybrany pulpit.

Obsługa pulpitu operatora

Domyślny wygląd pulpitu operatora podzielony jest na 3 sekcje:

Dodawanie nowego pulpitu

W sekcji z widokiem podłączonych pulpitów znajduje się przycisk służący do utworzenia nowego pulpitu.

Automatycznie po kliknięciu ‘Dodaj pulpit’ zostaje utworzony nowy pulpit z nazwą ‘Nowy …’. Nazwę pulpitu można zmienić poprzez kliknięcie prawym przyciskiem myszy na jego nazwie. Pojawi się lista z opcjami Usuń oraz Zmień nazwę.

Dodawanie paneli

Do każdego pulpitu można dodać dowolną ilość paneli. Nowy panel można dodać poprzez opcję ‘Dodaj panel’. Nowo utworzony panel zostaje dodany do obecnie używanego pulpitu z nazwą ‘Panel…’.

Rozmieszczenie paneli na pulpicie

Panele na pulpicie można rozmieścić na kilka różnych sposobów:

Panel przypięty – nowo utworzony panel jest dosunięty do krawędzi pulpitu. Tak przypięty panel nie zmienia wielkości po przypięciu. Można dowolnie zmienić jego wielkość. Nowo otwarte okna w programie powodują przesłonięcie panelu.

Panel pływający – panel nie dosunięty do żadnej krawędzi. Można zmieniać dowolnie jego wielkość. Otwarcie nowego okna w programie nie powoduje przesłonięcia panelu, który w takim ułożeniu widoczny będzie zawsze na wierzchu.

Panel zadokowany – panel zadokowany do krawędzi pulpitu. Podczas przesuwania panelu pokazują się opcje, gdzie można zadokować panel. Tak zadokowany panel zmienia swoją wielkość na domyślną, ale możliwa jest zmiana szerokości panelu. Taki panel jest widoczny spod otwieranych okien.

Panele połączone – panele można ze sobą łączyć w różnej konfiguracji. Jako dwa sklejone ze sobą panele lub jako zakładki, między którymi można się przełączać.

Opcja auto hide na panelach

Dla paneli została udostępniona funkcja Auto hide – autoukrywanie się panelu w postaci pinezki na nagłówku panelu. Panel, po włączeniu tej opcji, zwija się automatycznie, pozostawiając widoczny tylko nagłówek.

Ustawienia na panelach

Dla każdego panelu możliwa jest zmiana nazwy, jak i koloru. Opcje te dostępne są po wybraniu Ustawień z poziomu nagłówka panelu.

Dla paneli można ustawić kolor niestandardowy, wybierając pole z wielokropkiem.

Widżety

Na panel można dodać dowolną ilość widżetów poprzez opcję Przeciągnij i upuść. W tym celu należy wybrać interesujący nas widżet z wszystkich dostępnych w sekcji Konfiguracja i przeciągnąć go na konkretny panel. Możliwe jest również przeciągnięcie i dodanie całej grupy widżetów.

Konfiguracja widżetów

Dodane widżety można konfigurować. W tym celu należy najechać myszką na wybrany widżet i poprzez kliknięcie prawym przyciskiem myszy wybrać opcję Ustawienia.

W oknie ustawień widżetów, można odpowiednio skonfigurować widżet.

Dla każdego widżetu możliwa jest zmiana nazwy, zmiana typu, wielkości i koloru czcionki, jak również dodanie własnej ikony na widżecie lub wybranie filtra. Dla niektórych widżetów możliwy jest również wybór kontekstu. Dla każdego widżetu można indywidualnie zdefiniować kolor tła, wybierając z podanych lub wybrać niestandardowy, jak również zmienić wymiar na jeden ze zdefiniowanych.

Parametr Zliczaj służy do zliczania np. ilości dokumentów odpowiadających widżetowi. Można tam wstawić zapytanie zwracające pojedynczą wartość. Wynik tego zliczenia widoczny jest przy nazwie widżetu.

Konfiguracja widżetów niestandardowych

Na liście widżetów znajdują się widżety z ustawieniami niestandardowymi, są to m. in. Uruchom program, Zdjęcie, Przeglądarka WWW, BI Point.

Konfiguracja widżetu Uruchom program

Dla widżetu Uruchom program w ustawieniach możliwe jest określenie programu, który ma być otwierany po kliknięciu w widżet.

Po wybraniu przycisku wielokropka pojawia się okno wyboru aplikacji do podłączenia. W sekcji Parametry należy podać parametry uruchomienia programu np. jako program: C:\Windows\notepad.exe, a jako parametry: c:\mojplik.txt. Spowoduje to uruchomienie C:\Windows\notepad.ex\ mojplik.txt.

Konfiguracja widżetu Zdjęcie

Widżet Zdjęcie, to widżet służący do wyświetlanie zminiaturyzowanego zdjęcia jako ikony widżetu.

Konfiguracja widżetów BI Point i Przeglądarka www

Dodanie widżetów Przeglądarka WWW i BI Point możliwe jest tylko do panelu, dla którego nie są dodane inne widżety. Ustawienia tych widżetów dostępne są z nagłówka panelu z menu.

W ustawieniach widżetu BI Point w sekcji URL, domyślnie jest wpisany adres http://bicloud.comarch.pl.

W ustawieniach widżetu Przeglądarka WWW w sekcji URL, należy wpisać adres strony internetowej, która ma być wyświetlona.

Dla widżetu nie jest udostępniona pełna przeglądarka. Ideą tego widżetu jest możliwość wyświetlania strony, która będzie przydatna podczas pracy. By cofnąć się do poprzedniej strony, należy na stronie kliknąć prawy przycisk myszy i wybrać Wstecz.

Informacje ogólne

Od wersji 2019.2.1 została udostępniona możliwość współpracy z Comarch Retail POS.

Wersja Comarch ERP XL	Comarch Retail POS
od wersji 2019.2.1 do wersji 2020.0	2019.0
od wersji 2020.1	2019.5.1

Retail POS skonfigurowany z Comarch ERP XL, daje możliwości tworzenia stanowisk pracy detalicznej, na których mogą być wystawiane paragony lub faktury. Dokumenty wystawiane na stanowiskach POS są następnie przesyłane do centrali, czyli do bazy Comarch ERP XL Oprócz dokumentów handlowych oraz korekt do nich, możliwe jest również wystawianie zapisów kasowych KP i KW oraz dodawanie i modyfikacja kart kontrahentów.

Instalacja Comarch Retail POS

Comarch Retail POS instaluje się z wykorzystaniem narzędzia Comarch ERP Auto Update. Instrukcja instalacji POS znajduje się w dokumentacji na stronie https://pomoc.comarch.pl/retail/20190/.

Po otworzeniu narzędzia Comarch ERP Auto Update należy wskazać wybraną wersję do instalacji.

W tym celu wybieramy opcję – Akcje zaawansowane, a następnie pobranie wskazanej wersji produktu.

Po zainstalowaniu odpowiedniej wersji należy dodać komponent- Comarch Retail POS

Na zakładce Konfiguracja dodać produkt Comarch Retail.

Dla produktu Comarch Retail dodać komponent Comarch Retail POS.

Skonfigurować komponent Comarch Retail POS.Okno konfiguracji otwierane jest poprzez zaznaczenie komponentu oraz wybranie z głównego menu przycisku [Konfiguracja]. W oknie należy wprowadzić dane dotyczące połączenia bazy danych stanowiska POS.

Zapisać zmiany oraz zamknąć okno konfiguracji produktów przez wybranie odpowiednio przycisku [Zapisz], a następnie [Zamknij].

Standardowo POS instaluje się w lokalizacji:

c:\Nazwa profilu w AU\Comarch Retail\Comarch Retail POS

Aktualizacja oraz deinstalacja wersji powinna się odbyć również za pomocą Comarch Auto Update- akcje zaawansowane- odinstalowanie wskazanej wersji produktu.

Konfiguracja Stanowiska POS

Kreator nowego Oddziału POS

Konfiguracja stanowiska POS realizowana jest w module Administrator oddziałów.

Przed rozpoczęciem kreowania nowego oddziału należy dodać rejestry, które w kolejnych krokach będą przypisywane do oddziału POS.

Rejestr kasowy musi być oddziałowy. Należy także przypisać operacje – przychodowe i rozchodowe przykładowo rozchód, przychód, które także powinny mieć zaznaczony czek „oddziałowe”.

Na zakładce Raporty, przyciski są wyszarzone. Nie ma możliwości dodania raportu, ponieważ jest on tworzony samoistnie podczas dodawania operacji w systemie. Raport tworzy się gdy zsynchronizuje się pierwszy wpis do danego rejestru (KP/KW wystawione w POS) lub nastąpi synchronizacja dokumentu, który jest oznaczony jako opłacony (czyli na def. stanowiska POS nie ma zaznaczonego parametru „bez KP/KW” dla danego rejestru).

Do tej pory raporty kasowe do rejestrów oddziałowych Retail POS były otwierane podczas przesłania pierwszego zapisu kasowego i zamykane ręcznie po stronie Comarch ERP XL. Po zamknięciu raportu, przy kolejnej synchronizacji, otwierany był kolejny raport.
Aktualnie raport kasowy otwierany jest zgodnie z datą i godziną otwarcia sesji na danym stanowisku. Kolejne zapisy i rozliczenia dodawane są do otwartego raportu. W momencie zamknięcia sesji w Comarch Retail POS (zamknięcie dnia), w XL sprawdzane są zapisy kasowe i jeśli wszystkie zostały dodane do raportu, raport jest zamykany zgodnie z datą i godziną zamknięcia sesji na stanowisku POS. Podczas zamykania raportu następuje sprawdzenie czy wszystkie zapisy kasowe oraz rozliczenia dokumentów zostały dodane. Raport pozostaje niezamknięty do czasu wczytania poprawnie wszystkich zapisów z danego okresu (od otwarcia do zamknięcia sesji). Dodatkowo umożliwiono ręczne zamykanie raportów, które zostały otwarte na podstawie sesji na stanowisku POS, jednakże opcje te należy stosować awaryjnie.
W polu Numer raportu na raporcie kasowym otworzonym na podstawie sesji zapisywany jest numer sesji na stanowisku POS (wpis z tabeli SalesReports.Sessions pola Numberstring). Jeśli poprzedni raport został zamknięty ręcznie, nowy raport w polu Numer raportu będzie wyświetlał numer dokumentu.

W przypadku rejestru bankowego nie zaznaczamy czeku „oddziałowy”.

Jeśli POS ma mieć określoną inną grupę kontrahentów, należy utworzyć ją w XL. Taka grupa będzie w późniejszych krokach wskazywana w kreacji nowego oddziału POS.

Należy także dodać odpowiednie uprawnienia Operatorowi co szczegółowo opisane jest w Parametry operatorów (moduł Administrator).

Aby dodać nowy oddział typu Retail POS należy:

W pierwszym kroku kreatora należy wskazać jakie typy dokumentów mają być obsługiwane w POS – obecnie do wyboru są paragony i faktury oraz wybrać domyślny magazyn. Należy wskazać zwykły magazyn nie oddziałowy.

W drugim kroku należy ustawić parametry konfiguracyjne, które zostaną przesłane na wszystkie stanowiska POS danego oddziału.

W trzecim kroku należy określić domyślne grupy towarów i kontrahentów, z których dane będą przekazywane do oddziału POS oraz domyślny cennik. Wybranie Grup głównych spowoduje wysyłanie wszystkich towarów i kontrahentów do oddziału. Oddzielnie należy wskazać grupę, do której będą trafiać kontrahenci dodani w POS.

W kroku czwartym dodawane jest Centrum w Strukturze firmy. Przyciskiem plusa należy dodać nowe Centrum, uzupełnić nazwę, opis, przypisać odpowiednią Pieczątkę firmy. Jeśli o w oddziale POS powinny być inne dane niż w centrali wówczas należy utworzyć nową Pieczątkę firmy dedykowaną dla oddziału POS.

Następnie należy dodać wszystkie rejestry, które będą później dostępne na oddziale. Rejestry typu kasa musza być oddziałowe. Kolejna zakładka Serie- jest wyszarzona, ponieważ serię dodajmy w ustawieniach oddziału w kolejnych krokach. Ceny- należy dodać dostępne cenniki, Rejestry VAT- sprzedaż i zakup oraz kolejno możliwość wybrania magazynów i operatorów.

Przed zapisaniem Centrum konieczne jest ustalenie na zakładce [Formy płatności], które z form płatności mają być widoczne w oddziale. Należy edytować żądaną formę płatności oraz zaznaczyć parametr – Dostępna w oddziale. Po zapisaniu okna Centrum następuje powrót do kreatora i zakończenie kreacji Oddziału.

Po zakończeniu kreacji Oddziału konieczne jest zdefiniowanie kolejnych ustawień w systemie.

Przy konfiguracji oddziału na zakładce Parametry został dodany parametr:

Logowanie – podpowiadanie nazwy użytkownika – zaznaczenie parametru spowoduje, że podczas logowania do aplikacji Comarch Retail POS będzie możliwe wybieranie operatorów z listy a po rozpoczęciu wpisywania loginu będą podpowiadane kody operatorów, którzy mogą pracować na danym stanowisku.

Ustawienia oddziału Comarch Retail POS

Na zakładce [Waluty] należy ustawić walutę domyślną, w jakiej będzie pracował POS oraz waluty wraz z kursem, które będą konieczne np. w przypadku wysyłania cenników w walucie innej niż domyślna.

Aktualnie walutą domyślną jest PLN- bez możliwości zmiany.

Na zakładce [Stanowiska POS] należy dodać oddzielne stanowiska dla każdego punktu sprzedaży detalicznej pracującej z wykorzystaniem Comarch Retail POS. Jeśli uprzednio nie został dodany rejestr kasowy/bankowy należy go zdefiniować przed dodaniem stanowiska oraz ustalenie na nim na zakładce [Operacje] odpowiednich rodzajów operacji (przychodowych i rozchodowych). Rejestr bankowy nie może mieć zaznaczonego czeku „oddziałowy”.

W systemie można zdefiniować kilka stanowisk POS. Dla nowo dodanego stanowiska należy przypisać inny rejestr, który uprzednio musi być dodany w rejestrach kasowo bankowych oraz wybrany przy kreowaniu nowego oddziału w zakładce „rejestry”.

Na zakładce [Synchronizacja] należy ustawić operatora z uprawnieniami do wystawiania dokumentów, który jest konieczny do zapisywania dokumentów i innych przesłanych z POS danych. Konieczne jest również wpisanie hasła, jeśli operator je posiada. Ten sam operator musi być dodany na zakładce [Operatorzy] Centrum powiązanego z odziałem POS.

Dla każdego stanowiska POS należy ustawić, kod, nazwę, serię. Seria musi być oddziałowa. Należy również pamiętać, aby dla ustalonej serii zaznaczyć na zakładce [Dokumenty] odpowiednie pozycje, czyli FS i PA. Seria musi mieć przypisane rejestry zakupu i sprzedaży.

Należy sprawdzić czy Seria ustawiła się na centrum oraz na definicjach dokumentów FS i PA jako domyślna.

W tabeli Formy płatności dostępne są te formy, które w Centrum mają zaznaczony parametr Dostępna w oddziale. Dla każdej formy płatności można ustalić nazwę, która będzie prezentowana w POS, rejestr, do którego mają trafiać zapisy wynikające z zapłaty daną formą, ustawić parametr Bez KP/KW, który określa, czy dana forma płatności ma powodować powstawanie zapisów KP/KW oraz parametr Wyczyść po zamknięciu sesji.

Na zakładce [Parametry] należy ustawić parametry związane z tym konkretnym stanowiskiem POS.

Bez KP/KW oznacza, że do dokumentów z daną płatnością nie będą generowane dokumentu zapłaty KP/KW czyli dokument nie będzie rozliczony

Wyczyść po zamknięciu sesji powoduje zerowanie stanu kasy dla danej formy płatności po zamknięciu dnia. Zaznaczenie tego parametru jest niedostępne dla gotówki, dla której saldo zamknięcia równe jest saldu otwarcia na kolejny dzień.

Okno otwarcia dnia zostanie otworzone każdorazowo jeśli poprzednie zamknięcie aplikacji zakończyło się podsumowaniem dnia i opcją „zamknij dzień”.

Na zakładce [Urządzenia zewn.] należy wybrać rodzaj drukarki fiskalnej oraz określić, czy jest używana oraz w jaki sposób szuflada kasowa.

Na zakładce [Operatorzy] należy dodać tych operatorów, którzy będą mieli prawo pracy na danym stanowisku POS. Operator dodany do stanowiska POS automatycznie dodawany jest do Centrum powiązanego z danym oddziałem.

Na zakładce [Wydruki] znajdują się wszystkie wydruki wykorzystywane w Comarch Retail POS. Po podniesieniu wydruku możliwe jest oznaczenie, czy dany wydruk ma być wysyłany do POS.

Domyślnie parametr ten jest zaznaczony dla wydruków: Faktura sprzedaży, Paragon, Korekta ilościowa faktury sprzedaży, Korekta ilościowa paragonu, Operacje kasowe, Zamknięcie zmiany kasjera. Na zakładce tej znajduje się również parametr Drukowanie na domyślnej drukarce systemowej. Po jego zaznaczeniu nie będzie konieczności wskazywania drukarki, wydruk od razu trafi na drukarkę domyślna.

Konfiguracja Centrum

Na definicji Centrum w module Administrator, oprócz elementów zdefiniowanych podczas kreacji oddziału i dodawania stanowiska POS można dodać cenniki inne niż domyślne, oraz magazyny inne niż domyślne.

Parametry operatorów (moduł Administrator)

Prawa operatorów można przesyłać do stanowiska POS tylko w kontekście grup operatorów. W związku z tym prawa związane z operatorami należy definiować na wzorcu operatora, do którego jest przypięty. Uprawnienia operatorów zapisywane są na zakładce [POS] na wzorcu operatora.

Na zakładce tej można też przechowywać Profile POS. Profil POS, czyli własny zdefiniowany wygląd ekranu można wyeksportować z POS a następnie zapisać na liście Profili na wzorcu operatora. Dodane do listy profile wysyłane są do wszystkich operatorów przypisanych do danego wzorca.

Na karcie grupy operatorów, na zakładce POS został dodany domyślny profil o nazwie XL_POS_2019 przygotowany dla instalacji Comarch Retail POS współpracujących z Comarch ERP XL. Zdefiniowany domyślnie profil (motyw interfejsu) został tak przygotowany, aby po jego zsynchronizowaniu do POS dostępne były tylko te opcje, które mogą być realizowane w połączeniu POS z XL.
Użytkownicy, którzy wcześniej zdefiniowali własny profil, nadal pozostaną przy tym ustawieniu. Dla nich nie będzie dodawany domyślny profil XL_POS_2019.

Konfigurowanie Usługi synchronizacji POS

Synchronizacja ze stanowiskami POS odbywa się automatycznie za pomocą usługi synchronizacji POS.

Definiowanie usługi należy wykonać wybierając z Panelu głównego w module Administrator Oddziałów opcję Konfiguracja logowania automatu synchronizacji. Po wybraniu opcji j.w. należy wybrać przycisk: Synchronizacja jako usługa, który otworzy listę usług. Na liście należy wybrać opcję z menu rozwijanego przy przycisku plusa: Dodaj usługę synchronizacji POS. Na wyświetlonym oknie należy uzupełnić następujące dane:

Na zakładce [Oddziały] należy przypiąć te oddziały, które mają być synchronizowane za pomocą danej usługi. Możliwe jest dodawanie wielu usług w przypadku instalacji posiadających dużą ilość oddziałów z wieloma stanowiskami.

Uruchomienie stanowiska POS

Po zainstalowaniu aplikacji Comarch Retail POS należy uruchomić aplikację. Podczas pierwszego uruchomienia następuje łączenie stanowiska w Comarch Retail POS ze stanowiskiem POS zdefiniowanym w Comarch ERP XL.

Na oknie, które zostanie wyświetlone przy pierwszym uruchomieniu należy uzupełnić:

Po poprawnym podaniu danych następuje pierwsza synchronizacja z oddziałem zdefiniowanym w XLu a następnie system przechodzi do logowania.

Należy podać login operatora przypisanego do danego stanowiska POS oraz hasło: admin.

Hasło należy zmienić po zalogowaniu do POS. Przy każdym uruchomieniu stanowiska POS odbywa się synchronizacja danych słownikowych i konfiguracyjnych z Comarch ERP XL.

Możliwe jest też wykonywanie ręcznej synchronizacji z poziomu aplikacji Comarch Retail POS po wybraniu opcji: Aktualizacja danych.

Przesyłanie danych do stanowisk POS

Na stanowiska POS wysyłane są następujące informacje:

Odbieranie danych ze stanowisk POS

Stanowiska POS pracują w trybie on-line co oznacza, że dokumenty wystawione w POS bądź też nowo dodany kontrahent trafiają od razu do bazy Comarch ERP XL.

W przypadku braku połączenia informacje zostaną uzupełnione po ponownym nawiązaniu połączenia z XL.

Na POS współpracującym z XL można wystawiać paragony, faktury, korekty do paragonu i faktury, faktury do paragonów oraz dokumenty kasowe.

Do XL importowane są następujące dane:

Błędy dodawania zapisów do Comarch ERP XL można zobaczyć w opcji Log automatycznej synchronizacji. (Administrator Oddziałów- Ogólne)

Przesyłanie podstawowych promocji do oddziałów Retail POS

Rabaty przesyłane do Retail POS

Aktualnie możliwe rabaty do przeslania to:

Ogólne zasady przesyłania promocji (rabatów)

Do oddziału Retail POS mogą zostać przesłane rabaty zdefiniowane dla Centrum powiązanego z oddziałem Retail POS lub dla centrum nadrzędnego w stosunku do Centrum powiązanego z oddziałem POS. W szczególności przesyłane będą rabaty zdefiniowane do Centrum Głównego (tzw. roota w Strukturze firmy). Promocje, które nie są związane z konkretnym Centrum czyli KNT i KNU będą wysyłane zawsze.

Przesyłane będą te rabaty, które zdefiniowane są dla grupy wskazanej na oddziale Retail POS jako grupa do eksportu lub importu kontrahentów lub grup podrzędnych w stosunku do niej.

Ustawienie Grupy kontrahentów dla promocji przeznaczonej dla wszystkich kontrahentów

Przesyłane będą również te promocje (rabaty), które zostaną zdefiniowane dla konkretnych kontrahentów tzn. te, które na zakładce [Kontrahenci] mają przypisanego przynajmniej jednego kontrahenta wysyłanego do oddziału Retail POS.

Promocje na grupę towarów: przesyłane będą tylko te rabaty, które zdefiniowane są dla grupy towarów wskazanej w polu Eksport z grupy na oddziale Retail POS lub grup jej podrzędnych.

Konfiguracja promocji działającej na wszystkie towary w Retail POS

Promocja na towary: przesyłane będą tylko te rabaty, na definicji których przynajmniej jeden dodany towar jest wysyłany do Retail POS.

Jeśli na promocji będą wskazane konkretne formy płatności bądź sposoby dostawy, to taka promocja nie będzie wysyłana. Wysyłane będą tylko te promocje, dla których zostanie ustawiona opcja .

Jeśli na promocji na zakładce [Magazyny] będzie ustawiona opcja lub wskazany magazyn przypisany do Centrum powiązanego z oddziałem Retail POS wówczas promocja będzie wysyłana. Jeśli żaden magazyn wskazany na promocji, nie będzie przypisany do Centrum j.w., wówczas promocja nie będzie wysyłana.

Wysyłane będą tylko te rabaty, dla których w ustawieniu Rodzaj dokumentów wybrano opcję Wszystkie bądź Rozchodowe.

Nie będą wysyłane rabaty, dla których zaznaczono parametr: Powtarzać co:, gdyż moduł rabatowy nie obsługuje cykliczności działania promocji.

Przesyłanie nagłówka promocji – parametry

Dla każdej promocji będą przesyłane następujące ustawienia nagłówka:

Nie będzie przesyłana informacja o Limicie oraz Wymaganym progu transakcji, gdyż w Comarch Retail POS limity nie są obsługiwane.

Promocja KNT

Rabaty zapisywane na karcie kontrahenta na zakładce [Handlowe] zebrane są do jednej promocji o typie KNT i będą przesyłane do określonych oddziałów Retail POS. Dla promocji KNT dla każdego wskazanego w promocji kontrahenta przesyłana jest wysokość rabatu do wykorzystania w oddziale. Rabat ten dotyczy wszystkich towarów i łączy się z innymi rabatami.

Promocja WTR

Promocja na całą wartość dokumentu przesyłana jest do określonych oddziałów Retail POS po warunkami opisanymi wyżej. Promocja może być zdefiniowana dla pojedynczych kontrahentów lub dla grup kontrahentów. Aby promocja naliczała się dla wszystkich kontrahentów wysyłanych do oddziału Retail POS, konieczne jest wskazanie na zakładce [Kontrahenci] grupy zdefiniowanej jako grupa do eksportu kontrahentów do oddziału POS.

Promocja PRN i KNU

Promocje PRN i KNU są to promocje elementowe, które dotyczą konkretnych towarów lub grup towarowych i naliczane są na pozycjach dokumentów. Ze względu na wymogi modułu rabatowego Comarch Retail POS nie wszystkie elementy rabatów będą mogły zostać wysłane.

Do Comarch Retail POS wysyłane są elementy promocji, gdzie rabat ma typ procentowy, wartościowy lub typu stała cena. Nie będzie wysyłany rabat typu: Narzut na cenę zakupu, gdyż takie rabaty nie są obsługiwane w Comarch Retail POS.

Możliwe jest wysyłanie rabatów progowych procentowych i wartościowych. Jeśli na danej promocji towar będzie występował wiele razy, ale z różnymi progami, wówczas zostanie przesłany jako promocja progowa. Nie jest jednak możliwe przesyłanie rabatów różnego typu dla jednej pozycji na promocji. Nie powinno być sytuacji, że dla jednego progu towaru rabat będzie procentowy, dla innego wartościowy a dla kolejnego typu stała cena. Nie jest też możliwe wysyłanie progów dla promocji typu stała cena.

Pytania i odpowiedzi

Czy można wystawić korektę do Paragonu do którego jest wystawiona Faktura?

W POS można wystawić jedynie korektę do Faktury, inaczej niż w XL, gdzie korektę wystawiamy do Paragonu. Wystawiając więc korektę do faktury w POS nie zostanie ona przesłana do XL.

Czy POS we współpracy z XL obsługuje artykuły typu- usługa?

Nie. Aby towar był widoczny w POS musi mieć założoną partię.

Czy w POS obsługiwany jest Mechanizm Podzielonej Płatności?

Nie.

Dlaczego nie działa ikona Parking?

Parking w wersji 2019.0 POS we współpracy z XL od wersji 2019.2.1 nie jest obsłużony.

Czy z poziomu POS mogę podejrzeć zasoby?

Obecnie funkcjonalność zasobów z poziomu POS nie jest obsłużona.

Dlaczego dokumenty nie synchronizują się?

Należy w pierwszej kolejności sprawdzić ścieżkę PATH w zmiennych środowiskowych, która musi odnosić się do folderu w którym znajduje się wersja XL na której pracujemy.

Czy operator może mieć jako centrum domyślne centrum POS?

Operator wykorzystany do synchronizacji jako centrum domyślne musi mieć ustawione centrum nadrzędne w stosunku do centrum, które jest powiązane z oddziałem POS.

Co oznacza komunikat, w logu automatycznej synchronizacji – Funkcja XLDodajZapis zwróciła błąd: 8007 ?

Komunikat 8007 oznacza: nie znaleziono bieżącego okresu obrachunkowego.

Należy dodać bieżący okres obrachunkowy; System/Konfiguracja/Księgowość/Okresy obrachunkowe, oraz wskazać konto księgowe na rejestrze kasowym ; Administrator/Firma/Rejestry kasowe/Ogólne/

Gdzie sprawdzi logi błędów dotyczące braku synchronizacji np dokumentów?

Od wersji Comarch ERP XL 2020.2 zostały uszczegółowione logi dotyczące błędów przy synchronizacji w tabeli cdn.PicoLogElem, zostanie wyświetlony numer dokumentu (poprzednio był tylko GUID) oraz numer błędu z opisem którego dotyczy brak możliwości np przesynchronizowania dokumentu co ERP XL

Zastosowanie załączników

Załączniki (dane binarne) pozwalają na wprowadzenie do systemu dowolnych danych w postaci: obrazków, plików, dokumentów oraz powiązania ich z obiektami w systemie, jak np. towarami czy kontrahentami. Dzięki temu, przykładowo do karty towaru można dołączyć jego zdjęcie, a do karty kontrahenta referencje w postaci pliku MS Word. Użytkownik ma pełną dowolność w określeniu formatu, w jakim zapisane i przechowywane będą dane binarne.

Definiowanie i przypisywanie załączników do obiektów

Typy załączników

Typy załączników definiowane są w module Administrator w oknie: Słowniki kategorii, w folderze: Inne, w gałęzi: Typy załączników. W systemie predefiniowane są następujące typy:

Typy te umożliwiają przypisanie do obiektów załączników w postaci wymienionych plików. Ponadto, możliwe jest zdefiniowanie nowych typów załączników. Informacje dotyczące dodawania nowych typów załączników znajdują się w rozdziale: Definiowanie nowego typu .

O właściwościach załączników przypisywanych do obiektów w Comarch ERP XL decydują ustawienia w oknie: Typy załączników, otwieranym z poziomu okna: Słowniki kategorii.

W oknie: Typy załączników określa się pola:

Załączniki. Po naciśnięciu przycisku: zostanie otwarte okno: Lista załączników, w którym po naciśnięciu przycisku: [Dodaj] będzie można dodać nową grupę załączników

Lista załączników, zakładka: Załączniki

Okno wyświetla listę załączników wykorzystywanych w systemie COMARCH ERP XL. Aby otworzyć okno, należy z menu: Narzędzia, wybrać pozycję: Załączniki.

Rozmiar załączników

Ograniczenia w wielkości importowanych załączników zależą od wydajności komputera/serwera Użytkownika. W trakcie testów wersji starszej wersji import plików o wielkości ponad 200 MB przebiegał bez zakłóceń (zarówno przy kompresji danych jak i bez kompresji), jednak przy wielkościach plików ponad 400 MB, pojawiały się problemy z importem lub eksportem zaimportowanych załączników. W kolejnych wersjach Comarch ERP XL planowane są prace nad zwiększeniem bezproblemowego importu załączników o większej pojemności.

Osobne ograniczenia dotyczą wyświetlania załączników typu obraz bezpośrednio (bez potrzeby uruchomienia podglądu) w oknie obiektu, do którego zostały przypisane. W ten sposób mogą być wyświetlane pliki, których wielkość nie przekracza około 2 MB, a w przypadku karty załączników do 10 MB.

Ponadto, załączniki mogą być pakowane podczas zapisu, gdzie możliwe jest wykorzystanie opcji: Test, przy wykorzystaniu której możliwa jest weryfikacja wielości pliku po spakowaniu (tzn. czy jest to korzystne).

Wyświetlanie załączników

Po przypisaniu załączników do obiektów w Comarch ERP XL, możliwy jest ich podgląd. Jeżeli załączniki stanowią obraz (np.: *.bmp,*.jpg,*gif), wtedy możliwy jest bezpośredni podgląd w oknie obiektu, do którego zostały przypisane, np.: fotografia pracownika zostanie wyświetlona w oknie: Karta pracownika, po wybraniu zakładki: Załączniki. W takim przypadku musi być jednak zaznaczone pole: Automatycznie wyświetlaj, w oknie: Typy załączników (należy przy tym pamiętać o ograniczeniu wyświetlania plików do określonej wielkości – więcej w rozdziale: Rozmiar załączników ). Pozostałe typy załączników zostaną wyświetlone po naciśnięciu przycisku: [Uruchom] dotyczący podglądu załącznika w oknie obiektu, do którego zostały przypisane. Jego naciśnięcie spowoduje uruchomienie programu, umożliwiającego przegląd załączników, np. dla wyświetlenia arkusza kalkulacyjnego zostanie automatycznie uruchomiona aplikacja: MS Excel.

Podsumowując, wyświetlanie załączników odbywa się:

Automatycznie (dla plików typu: Obraz – np.: *.bmp,*.jpg,*gif), jeżeli dla typu załączników: Obraz, zaznaczono opcję: Automatycznie wyświetlaj (więcej w rozdziale: Rozmiar załączników );

Po naciśnięciu w oknie obiektu, do którego zostały przypisane załączniki, przycisku: [Uruchom] lub wybraniu z menu kontekstowego, (rozwijanego prawym klawiszem myszy) funkcji: Uruchom podgląd.

Definiowanie nowego typu załączników

W przypadku, gdy typy załączników, predefiniowanych w systemie nie odpowiadają Użytkownikowi (Użytkownik życzy sobie zaimportować plik, którego typ predefiniowany nie obejmuje) ma on możliwość zdefiniowania wybranego przez siebie typu załączników. Definiowanie nowego typu załączników odbywa się w oknie: Słowniki kategorii, dostępnym z poziomu modułu: Administrator. Sposób definiowania nowego typu załączników został przedstawiony na przykładzie dodawania typu załączników MS Visio, obejmującego skonwertowane pliki o rozszerzeniu .vsd.

Aby dodać nowy typ załączników (np.: .vsd), należy:

Po wypełnieniu pól w oknie: Typy załączników, należy je zapisać, naciskając przycisk: [Zapisz]. Nowy typ załączników zostanie wprowadzony na listę typów załączników w oknie: Słowniki kategorii.

Lista załączników

Lista załączników, zakładka: Załączniki

Załączniki, które zostały użyte w systemie prezentowane są w oknie: Lista załączników. Z poziomu tego okna możliwe jest również dodawanie, usuwanie, importowanie i eksportowanie załączników oraz przypisywanie ich od obiektów.

W oknie dostępne są pola i funkcje:

Rozmiar – filtr umożliwiający zawężenie listy wyświetlanych załączników według kryterium wielkości plików w kB.

Archiwalne – po zaznaczeniu parametru, na liście zostaną wyświetlone zarówno załączniki aktywne jak i archiwalne. Załączniki archiwalne będą wyświetlane szarym kolorem czcionki.

Typ – filtr umożliwiający zawężenie listy wyświetlanych załączników według ich typu.

Język – filtr umożliwiający zawężenie listy wyświetlanych załączników według języka.

Data utworzenia – filtr umożliwiający zawężenie listy wyświetlanych załączników do wskazanego zakresu dat w polach: Od, Do.

[Dodaj grupę] – po naciśnięciu przycisku otwiera się okno: Grupa załączników.

[Dodaj] – służy dodaniu załącznika do listy. Po naciśnięciu przycisku zostanie wyświetlone okno: Załącznik, z poziomu którego można importować oraz eksportować załączniki, a także przypisywać załączniki do obiektu. Po dodaniu łącznika kursor będzie podświetlał nowo dodany rekord na liście.

[Karta] – po naciśnięciu przycisku zostanie wyświetlone do podglądu/edycji okno: Załącznik

[Usuń] – usuwa załącznik (niepowiązaną z żadnym obiektem) z listy.

Na liście załączników wyświetlone będą automatycznie załączniki typu dziennik, które zawierają loga wygenerowanego podczas wykonywania akcji kluczowej przez XL WORK AUTOMAT w procesach.
W logach tych zawarta jest informacja o przyczynach niepowodzenia w wykonywanych akcjach.
W Konfiguracji w części Ogólne na zakładce Parametry 2 jest parametr umożliwiający konfigurację pojawiania się informacji w logu „Do procesu załączaj log tylko gdy wystąpiły błędy lub ostrzeżenia”. W przypadku jego zaznaczenia procesy powinny robić wpisy do załączników tylko w przypadku gdy w logu pojawią się błędy lub ostrzeżenia.

Po podniesieniu pojedynczego załącznika, zostaje otwarte okno: Załącznik, którego właściwości zostały opisane w punkcie: 1.1.6.

Lista załączników, zakładka: Archiwum wydruków

Zakładka Archiwum wydruków na Liście załączników jest analogiczna do zakładki Załączniki. Różnica między nimi sprowadza się do dodatkowych filtrów.

Ponadto na tej zakładce widoczne są wydruki wysyłane jako załączniki w postaci PDF programem pocztowym obok wydruków generowanych na drukarkę stacjonarną. Nazwa wydruku składa się z: <Nazwa wydruku>_<Numer dokumentu>_<Data wydruku>.pdf. Przykład: Faktura sprzedaży_FS-15/10/2010_20101210.pdf

W oknie funkcjonują następujące filtry:

Właściwości załączników

Informacje ogólne o właściwościach załączników

W Konfiguracji systemu na zakładce: Ogólne / Parametry 1 w grupie: Załączniki systemowe, czyli znajdujące się w archiwum wydruków, dla których zostały obsłużone opcje:

Nie pozwalaj na usuwanie obiektów, do których przypisane są systemowe załączniki – po zaznaczeniu tej opcji, nie będzie możliwe usuwanie obiektów (np. dokumentów, kart towarów, kontrahentów), do których przypisane są systemowe załączniki. Jeśli zostanie zaznaczona ta opcja, jednocześnie zostanie zaznaczona opcja: Nie pozwalaj na usuwanie załączników systemowych jn

Nie pozwalaj na usuwanie załączników systemowych – po zaznaczeniu tej opcji, nie będzie możliwe usuwanie załączników systemowych

Na poszczególnym obiekcie dotyczącym załącznika jest obsłużony parametr: Systemowy odnoszący się do ustawień z Konfiguracji:

Okno: Załącznik, zakładka: Ogólne

W oknie właściwości załączników, na zakładce: Ogólne określamy kod oraz nazwę załącznika, a także dokonujemy importu i eksportu pliku.

W oknie dostępne są pola i funkcje:

W systemie Comarch ERP XL istnieje możliwość opisywania załączników. Wprowadzony na załącznikach opis jest widoczny w odpowiedniej kolumnie, bezpośrednio z poziomu zakładki: Załączniki danego obiektu

Okno: Załącznik, zakładka: Historia zmian

W oknie: Historia zmian są prezentowane daty i godziny zapisywania załącznika wraz ze wskazaniem operatora, który dokonywał zmiany i opisem. Historia zmian dział w zależności od ustawień dla danego typu załącznika określonego w oknie: Typy załączników w sekcji: Wersjonowane dane, co zostało szczegółowo opisane w rozdziale: Typy załączników.

Na zakładce zostały obłożone opisane powyżej standardowe przyciski: [Podgląd], [Uruchom], [Zapisz],  [Eksport do pliku], [Usuń], [Zapisz], [Anuluj], których działanie zostało opisane powyżej.

Okno: Załącznik, zakładka: Obiekty

Na zakładce: Obiekty wyświetlona jest lista obiektów, z którymi powiązany jest załącznik. Z poziomu tego okna możliwe jest również wyświetlenie załączników zdefiniowanych jako atrybuty (klasa atrybutu o typie: Załącznik), i które jako atrybuty przypisane zostały do obiektów w systemie. Zaleta wiązania załączników z obiektami z poziomu okna: Właściwości załączników jest to, że możliwe jest tu wiązanie jednej danej z wieloma obiektami. Nie ma więc potrzeby edytowania kart kolejnych obiektów i przypisywanie im tego samego załącznika.

Z poziomu tego okna możliwe jest również dodawanie kolejnych obiektów za pomocą przycisku: [Dodaj], ich podgląd [Podgląd], [Usuń].

Ponadto, jest obsłużona funckonalność obłsużona za pomocą przycisku: dotycząca pokazywania obiektów i aplikacji, których dotyczy załącznik.

Okno: Załącznik, zakładka: Atrybuty

W oknie: Załączniki na zakładce: Atrybuty istnieje możliwość opisania załącznikowi za pomocą atrybutów. Jednak aby można było przypisać atrybut do załącznika, w pierwszej kolejności należy przypisać klasę tego atrybutu do obiektu: Załącznik.

Okno: Załącznik, zakładka: Załączniki

W oknie Załączniki na zakładce: Załączniki zostały standardowo obsłużone załączniki, które można zdefiniować dodatkowo załącznik będący załącznikiem do załącznika.

Przypisywanie załączników do obiektów

Załączniki można przypisać do większości obiektów znajdujących się systemie m.in.: Karty pracownika, Karty kontrahenta, Karty towaru, dokumentów handlowych, magazynowych, wewnętrznych, obiektów CRM itd. Dodano także  zakładkę: Dane binarne (nazwa w kolejnych wersjach została zmieniona na: Załączniki) w nagłówkach dokumentów: zapytań, ofert, zamówień, paczkach oraz wysyłkach.

Aby przypisać załączniki do obiektu, należy:

Wczytywanie bezpośrednio do załączników

W systemie Comarch ERP XL istnieje możliwość dodawania załączników poprzez udostępnienie skanowania bezpośrednio z poziomu otwartego obiektu, np. dokumentu. Dane mogą być również wczytywane z innych nośników, takich jak np. aparatu fotograficznego. Aby wczytać dane z aparatu fotograficznego na nagłówek dokumentu należy:

Wykorzystanie załączników na obiektach

Poniżej wymieniono przykłady wykorzystania załączników na obiektach występujących w systemie Comarch ERP XL. Nie jest to wyliczenie enumeratywne – załączniki, dzięki swej uniwersalności mogą mieć wszechstronne zastosowanie – adekwatne do konkretnych potrzeb Użytkownika.

Załączniki na karcie pracownika

Załączniki na karcie pracownika mogą stanowić:

Załączniki w Intranetowych Aplikacjach Pracowniczych

Załączniki – pliki zawierające fotografie o wielkości do 1 mb mogą być wyświetlane w Intranetowych Aplikacjach Pracowniczych. Wyświetlane one są na zakładce: Info, przedstawiającej podstawowe dane identyfikacyjne pracownika. Aby obraz taki został wyświetlony należy:

Załączniki na Karcie kontrahenta

Załączniki na Karcie kontrahenta mogą stanowić:

Załączniki na Karcie towaru

Załączniki na Karcie towaru mogą stanowić:

Seryjne dodawanie załączników/zdjęć

W systemie Comarch ERP XL obsłużone zostało wczytywanie zdjęć oraz innych plików do systemu wraz z automatycznym tworzeniem załączników do towarów. Funkcjonalność ta pozwala na zautomatyzowanie i przyspieszenie całego procesu dodawania zdjęć lub innych plików do towarów Dzięki takiemu rozwiązaniu użytkownik będzie mógł szybko i sprawnie przygotować ba danych np. do Comarch ERP e-Sklep.

Automatyzacja procesu dodawania zdjęć wymaga od użytkownika przygotowania odpowiedniej bazy zdjęć (lub innych plików) i takie jej opisanie aby program mógł bezbłędnie przypisać dane zdjęcie (lub inny plik) do określonego towaru.

Udostępnione zostały dwie opcje importu zdjęć/plików w zależności od tego gdzie i jak będą umieszczone zdjęcia/pliki:

Przygotowane przez użytkownika zdjęcia czy inne pliki będą mogły być równocześnie zaimportowane do bazy i powiązane ze wskazanymi towarami. Efektem importu będzie dodanie załącznika do listy załączników oraz podpięcie go do odpowiedniego towaru. Możliwe jest również dodanie wielu załączników do tego samego towaru.

Podczas importu możliwe jest określenie języka załącznika, ustalenie, do jakiej grupy powinien trafić oraz zdefiniowanie, do jakich aplikacji ma być wysyłany. Jeżeli import będzie realizowany z wykorzystaniem pliku MS Excel wówczas grupa załącznika może być określona w arkuszu.

Lista towarów – okno importu

Na liście towarów został dodany przycisk służący do wywołania operacji importu plików „Seryjny import załączników”:

Przed rozpoczęciem importu należy ustalić następujące parametry:

Rodzaj Importu

* Import plików zapisanych na dysku

* Import na podstawie arkusza MS Excel

Katalog/plik źródłowy – w zależności od wybranego rodzaju importu należy wskazać katalog w którym umieszczone są pliki do importu bądź wskazać arkusz MS Excel w którym zapisano ścieżki do plików.

Ustaw dostępność w aplikacjach – należy zaznaczyć, w których aplikacjach dodane załączniki mają być widoczne. Dotyczy wszystkich dodawanych załączników.

Ustaw grupę załączników – można wskazać jedną z istniejących grup załączników lub wybrać opcję „Grupa załączników wg pliku” wówczas grupa zostanie określona na podstawie zapisów w arkuszu.

Język – należy ustawić język dla dodawanych załączników.

Sposób zapisu do bazy – należy określić czy do załączników mają zostać dodane pliki w postaci danych binarnych czy tylko, jako linki do plików.

Import plików zapisanych na dysku

Aby móc zaimportować zdjęcia czy inne pliki zapisane na dysku muszą zostać spełnione określone warunki. Pliki zapisane na dysku muszą mieć nazwę zgodną z kodem lub z kodem kreskowym towaru. Jeśli zachodzi konieczność zaimportowania kilku plików do jednego towaru w katalogu wskazanym na oknie importu należy utworzyć katalog o kodzie (lub kodzie kreskowym) towaru i umieścić z nim pliki, które mają być dodane do towaru. W tym przypadku nazwa pliku nie ma znaczenia.

Akcja importu złączników do bazy będzie skutkowała zapisem w bazie nowego załącznika z równoczesnym podpięciem go do ustalonego towaru.

Kod i nazwa załącznika będzie ustalana na podstawie nazwy pliku. W przypadku nazw pliku dłuższych niż 40 znaków kod załącznika będzie skracany. Program podczas importu rozpozna rodzaj pliku i odpowiednio ustawi „Typ” załącznika. W przypadku zdjęć będzie to obraz. Pozostałe parametry załącznika zostaną ustalone na podstawie ustawień na oknie importu.

Import na podstawie arkusza MS Excel

Możliwe jest importowanie zdjęć umieszczonych w różnych lokalizacjach lub zdjęć zapisanych, jako URL. W tym celu należy utworzyć arkusz MS Excel, w którym zapisane będą kody (bądź kody kreskowe) towarów oraz ścieżki do plików, na podstawie, których zostaną utworzone załączniki do towarów.

W arkuszu powinny się znaleźć następujące informacje:

Przykładowy arkusz z danymi do importu:

Podczas importu na podstawie danych umieszczonych w arkuszu pliki zostaną odszukane i zaimportowane do systemu tworząc załączniki zgodnie z ustawieniami na oknie importu. W przypadku gdy w pliku zostanie uzupełniona kolumna Grupa oraz na oknie importu zostanie ustawiona opcja „Grupa załączników wg pliku” stworzone załączniki zostaną dodane do grupy wskazanej w pliku. W przypadku braku takiej grupy w systemie zostaną dodane do Grupy głównej. Pliki mogą zostać zapisane do bazy lub umieszczone tylko jako linki, jeśli podczas importu zostanie wybrana opcja „Zapis danych w postaci linków”

Załączniki jako linki

W systemie Comarch ERP XL umożliwiono dodawanie do obiektów załączników w formie linków dzięki czemu możliwe jest udostępnianie za pośrednictwem adresów URL załączników o dużych rozmiarach bez zbędnego obciążania bazy danych.

Zmiany w oknie: Załącznik

W oknie Załącznik dodane zostało pole URL, w którym można wprowadzać adres strony internetowej lub ścieżki dostępu do pliku czy folderu znajdującego się na danym nośniku.

Obok pola URL dodane zostały opcje

[Zobacz stronę], która służy do wywoływania (otwierania) załącznika oraz

[Lokalizacja pliku lub folderu], za pomocą której można wskazywać ścieżkę do załącznika.

W menu rozwijalnym obok przycisku [Lokalizacja pliku lub folderu], znajdują się opcje, za pomocą których można wskazać odpowiedni link:

Opcja: Lokalizacja pliku – umożliwia wskazanie linku do pliku. Po wybraniu opcji uruchomione zostaje okno: Wybierz plik, w którym można wskazać odpowiedni plik, do którego ścieżkę dostępu chcemy zapisać i za pomocą opcji: Otwórz uzupełnić na załączniku link do wybranego pliku:

Opcja: Lokalizacja folderu – umożliwia wskazanie linku do folderu. Po wybraniu opcji uruchomione zostaje okno: Przeglądanie w poszukiwaniu folderu, w którym można wskazać folder, do którego ścieżkę dostępu chcemy zapisać i za pomocą opcji OK uzupełnić na załączniku link do wybranego folderu:

Opcja: Adres strony internetowej – umożliwia otwarcie domyślnej przeglądarki w celu wyszukiwania odpowiednego adresu URL. Wybrany w przeglądarce adres strony internetowej można skopiować, a następnie wkleić w polu URL w oknie Załącznika

Załącznik dodany jako link można „nadpisać” poprzez wykonane na nim zmiany np. poprzez wskazanie innej ścieżki do załącznika lub wykonanie importu załącznika z pliku. Jeśli wykonany zostanie import załącznika z pliku za pomocą opcji [Import pliku] to załącznik przestanie być tylko linkiem. W takiej sytuacji wykonany zostanie standardowy zapis pliku do bazy danych.

Zmiana na zakładce: Załączniki

Na zakładce Załączniki dodana została nowa kolumna: Adres URL. W kolumnie prezentowany jest link do załącznika, wskazany w oknie: Załącznik, w polu URL. W przypadku prawidłowo podanej ścieżki dostępu/adresu strony internetowej w oknie załącznika, kliknięcie w link w kolumnie: Adres URL spowoduje otwarcie załączonego pliku folderu lub strony internetowej.

Zmiany na liście załączników

Na liście załączników dodana została nowa kolumna: Adres URL. W kolumnie prezentowany jest link do załącznika wskazany w oknie: Załącznik, w polu URL. Analogicznie jak z poziomu zakładki: Załączniki, kliknięcie w link w kolumnie adres URL na liście załączników powinno spowodować otwarcie załącznika.

Nowa kolumna: Adres URL została również uwzględniona w eksporcie do arkusza kalkulacyjnego wykonywanym z poziomu listy załączników.

Kopiowanie załączników z TP na ZP

Wprowadzono opcjonalne kopiowanie załączników, zdefiniowanych w technologiach produkcyjnych, na odpowiednie obiekty, na ZP. Kopiowanie załączników z technologii na ZP obejmuje kopiowanie załączników z materiałów/produktów w technologii na materiały/produkty, znajdujące się na realizacjach operacji, a także kopiowanie załączników z operacji w technologii na operacje planowane

Dodatkowo obsłużono kopiowanie załączników dodanych na operacjach planowanych, na odpowiednie ich realizacje. Działała ono niezależnie od jakiegokolwiek parametru, tzn., jeśli na operacji planowanej dodane będą załączniki, to podczas dodawania realizacji do tej operacji kopiowane będą wszystkie załączniki z operacji planowanej, na dodawaną do niej realizację.

Ogólna architektura

Ogólna architektura zabezpieczenia klucza HASP składa się z 5 warstw:

Warstwa 1 – klient usług zabezpieczeń – stanowią ją algorytmy w programie ERP XL, służące w ogólnym rozumieniu do zabezpieczenia programu przed nielegalnym używaniem. Klient usług zabezpieczeń dokonuje logowania i pobrania licencji z serwera zabezpieczeń (poprzez warstwę 2), odpowiada za zwrot pobranych licencji przy zamykaniu programu. Od v 2020 możliwe jest bezpośrednie połączenie warstwy 1 z warstwą 3 za pomocą protokołu http standardowo odbywa się to poprzez port 5150.

Warstwa 2 – stanowi ją MS SQL Server, na którym są zainstalowane procedury wbudowane (extended stored procedures) służące do komunikacji klienta usług zabezpieczeń z serwerem usług zabezpieczeń.

Warstwa 3 – to właściwy serwer zabezpieczeń – tzw. usługa HASP. Rolą tej usługi jest zarządzanie licencjami, czyli:

Warstwa 4 – to sprzętowy klucz HASP, który służy do przechowywania informacji o zakupionej puli licencji oraz do weryfikacji jej wykorzystania w trakcie pracy klienta (systemu ERP XL) oraz serwer zabezpieczeń (serwisu HASP)

Warstwa 5 – to połączenie do klucza wirtualnego, podczas gdy do instalacji może być podłączony jeden klucz HASP kluczy wirtualnych może być zarejestrowanych w instalacji większa ilość. Gdy do instalacji zostanie dodany klucze wirtualne warstwa 3 łączy się do serwera Comarch o adresie ml.comarch.pl – https i pobiera informacje o przypisanych do danego klucza licencjach, warstwa 3 co kilka godzin łączy się do serwera Comarch i pobiera ponownie informacje o kluczach maksymalnie czas ten może wynosić do 3 dni

Klient usług zabezpieczeń

Algorytm działania klienta usług zabezpieczeń jest następujący:

W momencie uruchomienia przez operatora programu ERP XL (dowolnego modułu), następuje zalogowanie klienta usług zabezpieczeń do serwera zabezpieczeń i pobranie wszystkich licencji przypisanych do operatora, który uruchomił system. Licencje są pobierane zgodnie z ustawieniami na zakładce {Parametry/Uprawnienia} karty operatora w module: Administrator (Rysunek 2). W celu poprawnego zalogowania aplikacji do serwera zabezpieczeń, muszą zostać pobrane wszystkie licencje ustawione dla danego operatora. Brak możliwości pobrania jakiejkolwiek licencji spowoduje, że dowolny moduł systemu, uruchomiony przez operatora będzie działał bez licencji. W takiej sytuacji zostanie wyświetlony komunikat informujący o tym, że nie udało się pobrać licencji i zalogować do serwera zabezpieczeń.

Wszystkie pobrane licencje w danej sesji są blokowane do wyłącznego użytku przez danego operatora, nawet jeśli w trakcie sesji nie uruchamia wszystkich modułów, na które pobrał licencje.

Wyjątek od powyższego opisu stanowi pobieranie licencji na moduł obsługi drukarek fiskalnych za pośrednictwem usług terminalowych. W tym przypadku licencja jest pobierana w przypadku pierwszego użycia terminalowych sterowników fiskalnych (FP600T.dll, DF300T.dll, DF300_1T.dll oraz INNOWAT.dll).

Jeżeli licencje zostały pobrane z serwera poprawnie, w trakcie pracy programu ERP XL następuje okresowa komunikacja z serwerem zabezpieczeń w celu sprawdzenia, czy serwis HASP pracuje poprawnie (np. czy ktoś nie wyjął klucza HASP z portu serwera), a także „poinformowanie” serwisu o tym, że aplikacja ERP XL nadal działa.

Po zakończeniu pracy programu następuje wylogowanie z serwisu zabezpieczeń i zwolnienie pobranych licencji.

Jeżeli przy uruchamianiu programu nie udało się pobrać licencji z klucza, praca z systemem ERP XL będzie możliwa tylko w ograniczonym zakresie, pozwalającym tylko i wyłącznie na przeglądanie danych, bez możliwości ich modyfikacji np. wystawiania i przekształcania dokumentów lub ich księgowania.

Procedury wbudowane na serwerze SQL

Warstwa ta służy w rzeczywistości do komunikowania się klienta usług zabezpieczeń z serwerem usług zabezpieczeń. Klient wywołuje procedury wbudowane, które zostały zainstalowane na serwerze SQL poprzez standardowe mechanizmy komunikacji aplikacji z serwerem bazy danych. Za pośrednictwem procedur, żądania klienta są przekazywane do serwera zabezpieczeń.

Dzięki takiemu rozwiązaniu zapewniona została bezproblemowa komunikacja sieciowa pomiędzy klientem, a serwerem usług zabezpieczeń – poprawne skonfigurowanie sieci dla potrzeb komunikacji z bazą danych gwarantuje równocześnie komunikację z serwerem zabezpieczeń.

Procedury te zwykle znajdują się na serwerze SQL, na którym znajdują się bazy danych programu ERP XL. Na tym samym komputerze co procedury wbudowane, musi znajdować się serwer zabezpieczeń. Istnieje jednakże możliwość zainstalowania procedur wbudowanych i serwera zabezpieczeń na innym komputerze niż serwer baz danych ERP XL. Warunkiem jest zainstalowanie na tym komputerze silnika bazy danych MS SQL Server (może to być bezpłatny silnik MSDE lub SQL Express). Równocześnie należy skonfigurować program ERP XL w taki sposób, aby odwoływał się do innego serwera zabezpieczeń niż serwer bazy danych. Należy to zrobić w oknie konfiguracji komputera:

W podanym powyżej przykładzie procedury wbudowane będące elementem systemu zabezpieczeń zostały zainstalowane na serwerze KASTOR.

Nazwa serwera klucza jest zapamiętywana w rejestrze systemowym, w kluczu HKEY_LOCAL_MACHINE\SOFTWARE\ERP\HASP w wartości „Serwer”.

W przypadku braku określenia nazwy serwera klucza w aplikacji ERP XL, domyślnie zakłada się, że serwerem klucza jest serwer bazy danych.

Serwer usług zabezpieczeń

Serwer usług zabezpieczeń odpowiada za zarządzanie licencjami – sprawdzanie liczby pobranych licencji, obsługę żądań zalogowania i wylogowania.

Działanie serwera usług zabezpieczeń opisuje poniższy schemat:

Po uruchomieniu serwer zabezpieczeń komunikuje się z kluczem HASP bądź z serwerem kluczy wirtualnych dla kluczy wirtualnych w celu odczytania maksymalnej puli licencji, którą dysponuje.

W momencie pobrania przez klienta licencji, serwer zapamiętuje ten fakt i „odejmuje” pobraną licencję z dostępnej puli.

W momencie wylogowania się klienta, zwalniane są pobrane wcześniej przez niego licencje.

Dla właściwego zrozumienia zachowania programu w pewnych szczególnych przypadkach, pomocne będą poniższe uwagi.

Okresowa kontrola Klucza HASP

W trakcie pracy, co pewien czas, serwer zabezpieczeń sprawdza obecność klucza HASP. Oznacza to, że jeśli w trakcie pracy serwera zabezpieczeń zostanie wyjęty klucz HASP, praca wszystkich zalogowanych do serwera aplikacji ERP XL zostanie zablokowana.

Wielokrotne logowanie

Jeżeli Użytkownik na tym samym komputerze uruchomi wielokrotnie program ERP XL (różne moduły), to pobierze z serwera każdą licencję tylko jeden raz.

Awaryjne zakończenie pracy

Jeżeli Użytkownik aplikacji ERP XL zakończy jej pracę inaczej niż poprzez wybranie opcji: Koniec pracy i nie nastąpi wylogowanie z serwera zabezpieczeń, to licencje pobrane przez tego Użytkownika będą zablokowane jeszcze przez pewien określony czas (domyślnie 1800 sekund). Po tym czasie licencje zostaną zwrócone do puli i inny Użytkownik będzie mógł je pobrać.

Blokowanie licencji dotyczy wyłącznie Użytkowników uruchamiających program ERP XL z innych komputerów. Zgodnie z zasadą opisaną w rozdziale Wielokrotne logowanie, jeżeli Użytkownik zakończy pracę programu ERP XL inaczej niż poprzez wybranie opcji: Koniec pracy, to będzie mógł na tym samym komputerze ponownie uruchomić program ERP XL, wykorzystując wcześniej pobraną licencję, która nie została jeszcze automatycznie zwolniona

Klucz HASP

Serwer zabezpieczeń komunikuje się bezpośrednio z kluczem HASP, który stanowi sprzętowe zabezpieczenie, służące do weryfikacji posiadanej puli licencji.

Zabezpieczenie może być realizowane za pomocą kluczy typu: MemoHasp lub NetHasp. Klucze te są dostępne dla portów USB lub LPT. Dostępne są również klucze na karcie PCIMCIA. Mają one zastosowanie w komputerach przenośnych stosowanych w celach prezentacyjnych lub testowych.

W przypadku klucza MemoHasp musi być on wpięty w lokalny port komputera, na którym znajduje się serwer zabezpieczeń.

Modele instalacji ERP XL z serwerem klucza HASP

Instalacja jednostanowiskowa

Instalacja sieciowa