Wykorzystanie funkcjonalności: Procesy

W systemie 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:

Uwaga

Jeżeli parametr zostanie wyłączony w momencie, gdy procesy są uruchomione, będzie możliwe wykonanie bieżącej akcji, jednak jej wykonanie nie spowoduje przejścia do następnego etapu (zadania) procesu.

Uwaga

Wykorzystanie funkcjonalności procesów wymaga zaznaczenia osobnej opcji w kluczu sprzętowym (opcja licencji).

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

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

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

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

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.

Uwaga

Parametr “Uruchom ponownie gdy jest już zakończony” pozwala na ponowne wykonanie tego procesu i czynności pomimo tego, że już taki proces dla zadanego obiektu był wykonany.

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.

Uwaga

Przedstawione powyżej to przykład zastosowania opisanej funkcjonalności, nie ma sensu biznesowego, zwraca ostatnio dodany TrN_GIDNumer i TrN_GIDTyp faktury sprzedaży.

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:

Przyklad

Treść zakładki: Parametry, która umożliwia wysłanie wiadomości e-mail na adres podany na karcie kontrahenta, o zamówieniu obsługiwanym przez proces: <DO>!@SQL('Select KNT_EMail From CDN.KntKarty (NOLOCK) join CDN.ZAMNAG (NOLOCK) on ZaN_KntNumer = Knt_GIDNumer where ZaN_GIDNumer='&@OBINUMER)</DO> <TEMAT>test</TEMAT> <TRESC>!'Dokument:'&@SQL('Select CDN.NumerDokumentu(CDN.DokMapTypDokumentu(ZAN_GIDTyp,ZAN_ZamTyp, ZAN_Rodzaj),0,0,ZAN_ZamNumer, ZAN_ZamRok, ZaN_ZamSeria,0) From CDN.ZamNAg (NOLOCK) Where ZaN_GidNumer='&@OBINumer)</TRESC>

Przyklad

Zastosowanie tekstu z zapytaniem SQL wewnątrz treści: <TRESC>!'Witaj '&@SQL('Select trn_kntnumer From cdn.TraNAg (NOLOCK) Where Trn_GidNumer='&@OBINumer) &' dalsza treść, numer dokumentu @NumerDokumentu zakończenie' </TRESC> Efekt: Witaj 1 dalsza treść, numer dokumentu FS-3/23/04 zakończenie

Przyklad

Zapytania wymagające użycia wartości typu string w zapytaniu muszą być otoczone apostrofem podwójnie, np. standardowo w zapytaniu stosujemy '1800-12-28', w procesie należy zapisać ''1800-12-28''  : <TRESC>!'Faktura '&@SQL ('select DATEADD(day,trn_data3,CONVERT(DATETIME,''1800-12-28'',120)) from cdn.TraNag where TrN_GIDNumer = @OBINumer')</TRESC> Efekt: Faktura 27.04.2023

Przyklad

Zastosowanie wylistowania wyników zapytania: A) <TRESC>!@SQL('list "" select ZaE_Twrkod + CHAR(9) + CHAR(9) + CHAR(9) +convert(varchar(10), ZaE_Ilosc) + CHAR(13) + CHAR(10) from cdn.zamElem where ZaE_GIDNumer = '&@OBINumer)</TRESC> Efekt: T1     1.0000 T2     1.0000 T3     1.0000 B) <TRESC>!@SQL('list ", " select zae_Twrkod + CHAR(9) + convert(varchar(10), ZaE_Ilosc) from cdn.zamElem where zae_gidnumer = '&@OBINumer)</TRESC> Efekt: T1           1.0000, T2          1.0000, T3          1.0000

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.

Przyklad

Za pomocą akcji kluczowych, predefiniowanych dla zamówień sprzedaży możliwe jest określenie pełnej ścieżki obiegu dokumentów – od wygenerowania zamówienia sprzedaży, poprzez jego potwierdzenie, wygenerowanie dokumentu handlowego z zamówienia i zakończenie procesu. Ponadto, aby uwzględnić możliwe opcje tego obiegu, w definicji procesu można również uwzględnić takie czynności, jak: otwarcie zamówienia, jego odrzucenie lub anulowanie (którym odpowiadają akcje kluczowe). Kondtrukcja procesu umożliwia automatyczne przechodzenie do następnej czynności po wykonaniu poprzedniej.

Uwaga

W kolejnych wersjach systemu ERP XL, planowana jest rozbudowa procesów o obsługę kolejnych dokumentów, za pomocą akcji kluczowych.

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:

Uwaga

Definicje procesów zaimportowane z XL w wersji na MSSQL nie będą działać poprawnie na ERP XL działającym na PostgreSQL

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

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

Uwaga

Obecnie nie obsługujemy automatycznego uruchamiania procesu, proces zawsze musi zostać uruchomiony ręcznie.

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”.

Obsługa Planu Produkcji

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

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

W systemie 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:

Generowanie dokumentów magazynowych w procesach w oparciu o parametry

W procesach dostępnych dla dokumentów handlowych do akcji kluczowej służącej do generowania dokumentów magazynowych, została dodana zakładka [Parametry], gdzie należy określić, jaki typ dokumentu w danym kroku powinien powstać, czyli czy ma to być PM/WM, AWD/ZWM czy ich odpowiedniki dla magazynów WMS. Jest to działanie analogiczne do generowania dokumentów handlowych w procesach, gdzie na definicji akcji jest możliwość ustawienia za pomocą parametrów, czy generowanym dokumentem ma być np. FZ czy PZ.

Uwaga

Aby w każdym przypadku tworzenie dokumentów magazynowych zadziałało poprawnie, to wpisane na zakładce symbole muszą być oddzielone przecinkiem, ale bez dodatkowej spacji pomiędzy nimi. Tak też celowo zostało to ujęte w treści do tego punktu.

Oczywiście nadal zachowana jest zasada, że dla danej konfiguracji w Systemie nie będzie możliwe utworzenie np. dokumentów WM/PM na magazyny WMS, więc użytkownicy powinni odpowiednio zdefiniować swój proces warunkując wykonanie danego zadania od rodzaju magazynu na dokumencie źródłowym.

W konwersji dotychczasowych procesów, w których występuje zadania generowania dokumentów magazynowych parametry zostały ustawione tak, aby zachowane było dotychczasowe działanie Systemu. Oznacza to, że symbole dokumentów uzupełnione zostaną zależnie od typu dokumentów źródłowych, dla których akcja została dodana:

Jako pierwsze zostaną ustawione symbole dokumentów PM i WM, ponieważ dotychczas to one były generowane w akcjach ręcznych lub automatycznych, więc zachowane zostanie dotychczasowe działanie dla istniejących procesów.

Wskazówka

Pomimo tego, że dokumenty przychodu czy rozchodu wskazują jednoznacznie na dokumenty magazynowe przychodowe lub rozchodowe, to zostaną dodane zawsze wszystkie typy magazynowych, aby dla korekt możliwe było wystawianie dokumentów magazynowych o przeciwnych kierunkach przepływu.

Należy pamiętać o tym, że ustawienie w definicji procesu określonego parametru wpływa również na inne operacje w Systemie, jak opisano poniżej.

Wskazówka

W bazie są dwa rodzaje magazynów: zwykłe i WMS. Chcemy, aby dla magazynów zwykłych generowały się dokumenty PM lub WM, ale dla magazynów WMS też powstawały odpowiednie dla nich dokumenty magazynowe. Gdyby do kroku procesu, w którym jest generowany dokument magazynowy dodać w parametrach: WM,ZWM, to nie utworzy się dokument magazynowy dla magazynów WMS. Jeśli parametry zapiszemy w odwrotnej kolejności: ZWM,WM, to nie utworzy się dokument magazynowy WM dla magazynów zwykłych. Konieczne jest więc dodanie do czynności procesu warunku na rodzaj magazynu.

Należy wiec zdefiniować kolejne kroki procesu, np:

- Dodanie dokumentu

- Potwierdzenie dokumentu, po którym ma nastąpić generowanie dokumentu magazynowego, więc tutaj musi zostać dodany warunek na rodzaj magazynu i w zależności od niego będzie wykonany jeden z poniższych kroków:

- Wygenerowanie dokumentu magazynowego z parametrem WM

- Wygenerowanie dokumentu magazynowego z parametrem ZWM.

Szczególnym przypadkiem jest generowanie dokumentów magazynowych, jeśli na źródłowym dokumencie handlowym są różne magazyny. W takich sytuacjach System będzie dążył do wygenerowania w jednym zadaniu wszystkich dokumentów magazynowych możliwych do utworzenia i dopiero wtedy zadanie zostanie uznane za wykonane. Jeśli np. z powodu braku ilości na magazynie nie powstanie dokument do jakichś pozycji, ale przy generowaniu zostanie utworzony chociaż jeden dokument, to zadanie trafi do wykonanych. A tylko wtedy, gdy nie będzie możliwe utworzenie żadnego dokumentu, to będzie ono nadal do wykonania. Mogą tu wystąpić następujące scenariusze:

Proces jako usługa

Od wersji 2017.0 działa mechanizm, który będzie tworzył działającą usługę XLWFLService 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 i pracy w trybie wsadowym. Podczas tworzenia usługi moduł musi być uruchomiony jako administrator (prawy przycisk myszy > "Uruchom jako administrator").

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.

Obsługa operacji KSeF w Procesach

Od wersji 2024.0 komunikacja z KSeF została obsłużona w definiowanych Procesach. Za ich pomocą można dokonać:

Jak w przypadku każdej metody komunikacji z KSeF, również w Procesach do dokonania ww. operacji konieczne jest uwierzytelnienie w KSeF. W przypadku Procesu uruchomionego w trybie wsadowym jedynym narzędziem uwierzytelnienie jest token. Uwierzytelnienie odbędzie się więc wyłącznie, jeżeli Operator ma włączone prawo do używania tokena i token został przypisany na pieczątce firmy.

W przypadku Procesów działających w trybie interakcyjnym uwierzytelnianie odbywa się w sposób standardowy tj., jeżeli Operator ma włączone prawo do używania tokena, wówczas na podstawie tokena z pieczątki firmy, jeżeli Operator nie ma tego prawa, wówczas za pomocą wskazanego przez niego certyfikatu.

Obsługa wysyłki faktur oraz pobrania UPO w Procesach

Lista akcji kluczowych definiowalnych procesów została wzbogacona o dwie nowe akcje:

Ww. akcje dostępne są dla dokumentów, które podlegają wysyłce do KSeF, a więc dla faktur sprzedaży, faktur eksportowych, faktur zaliczkowych sprzedaży oraz korekt tych dokumentów.

Warunkowa wysyłka faktur do KSeF

Użytkownicy, którzy rejestrują zarówno faktury podlegające wysyłce do KSeF jak i takie, które rejestrowane są poza systemem KSeF mogą korzystać z akcji wysyłania faktury w sposób warunkowy. Poniżej umieszczono propozycje definicji procesu na okoliczność ww. scenariuszy:

Akcja pobrania UPO

Podczas akcji pobrania UPO wywołanej w kontekście konkretnego dokumentu System pobiera UPO dla tego dokumentu oraz innych dokumentów wysłanych w ramach danej sesji KSeF, a co za tym idzie wykonuje w ten sposób również zadania pobrania UPO dla tych pozostałych faktur, jeżeli takowe zostały wygenerowane i jeżeli Operator ten jest opiekunem takich zadań.

Przyklad

W ramach sesji XXX wysłano do KSeF: FS-1; FS-6, FS-12, FSE-15; FSL-16. Zgodnie z definicją procesu wygenerowane zostały zadania j.n. których opiekunem jest operator OPE_1 i Automat:

- Zad1: Pobranie UPO dla FS-1

- Zad2: Pobranie UPO dla FS-6

- Zad3: Pobranie UPO dla FS-12

- Zad4: Pobranie UPO dla FSE-15

- Zad5: Pobranie UPO dla FSL-16

Operator OPE_1(lub Automat) wykonuje zadanie Zad3, w wyniku czego System pobiera UPO do wszystkich ww. dokumentów, a co za tym idzie wszystkie ww. zadania zostają wykonane.

Obsługa pobierania faktur z KSeF

Dodana została akcja kluczowa Pobieranie faktur z KSeF, dostępna dla procesów definiowanych w gałęzi Inne procesy/Proces bez obiektu. Za pomocą tej akcji można dokonać importu z KSeF faktur, na których Nabywcą jest Firma będąca Użytkownikiem Systemu. Operacja dokonywana jest wg zasad jak dla opcji Nowe dokonywanej z interfejsu, tj. System importuje faktury z datą przyjęcia w KSeF równą i większą od największej z dat dotąd zaimportowanych dokumentów, a jeżeli dotąd takiego importu nie dokonano, wówczas z datą przyjęcia w KSeF należącą do bieżącego miesiąca i miesiąca go poprzedzającego.

Podczas kreacji i konwersji bazy System dodaje predefiniowany proces, służący do dokonywania takiego importu Aby z takiego procesu skorzystać wystarczy go aktywować, włączając parametr Aktywny. Jeżeli Użytkownik zechce go zmodyfikować zmieniając np. godzinę wykonywania czynności wystarczy takie proces wyeksportować, a następnie zaimportować i na tak utworzonym nowym procesie dowolnie zmieniać jego parametry.

Ww. akcja Pobieranie faktur z KSeF traktowana jest pod kątem prawa do jej wykonania w standardowy sposób tj., jeżeli aktywny jest proces z akcją pobrania faktur z KSeF, wówczas System kontroluje, aby Użytkownik inny niż przypisany do takiej akcji nie mógł wykonać operacji Import/Nowe, czy to poprzez próbę wykonania zadania procesu, czy to opcją na liście faktur zakupu z KSeF. Dla akcji importu Za okres oraz importu konkretnego numeru KSeF operacja nie jest blokowana. Jako akcja procesu Pobierania faktur z KSeF rozumiana jest wyłącznie operacja Nowe. Jeżeli więc w Firmie uruchomiony jest ww. proces i dany Operator ma mieć możliwość wykonywania operacji importu/nowe, wówczas Operatora tego należy dodać do aktywnego procesu pobierania faktur jako wykonującego tą czynność.

Jeżeli utworzone zostało zadanie Pobieranie faktur z KSeF na konkretny dzień/godzinę i uprawniony do tego Operator dokona operacji import/nowe przed tą datą/godziną, wówczas zadanie procesu nadal pozostaje do wykonania. Dzięki temu operacja importu dokonywana jest automatycznie o określonej godzinie, nawet, jeżeli taka operacja została wykonywana przez jakiegoś Użytkownika w trakcie dnia. Jeżeli zaś Operator wykona zadanie procesu w danym terminie, czy też po nim, wówczas zadanie procesu zostaje wykonane i pojawia się kolejne np. na kolejny dzień i określoną godzinę, jeżeli tak ten proces zdefiniowano.

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:

Przyklad

Zdefiniowany filtr zawęża listę kontrahentów do mających siedzibę w konkretnym mieście. Aby dla każdego miasta nie definiować osobnego filtra, można zdefiniować jeden filtr, zawierający parametr dynamiczny określający miasto. Po wybraniu przez Użytkownika takiego filtra i naciśnięciu przycisku lejka – zostanie wyświetlone dodatkowe okno, służące wpisaniu wartości - nazwy miasta i zastosowaniu filtra na liście. Po zaakceptowaniu zapisu, program wstawia do filtra, w miejsce definicji parametru dynamicznego, wprowadzoną wartość (nazwę miasta) i stosuje filtr na liście.

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).

Uwaga

Zastosowanie przełącznika H powoduje bezwarunkowe ukrycie parametru, w związku z czym, dla takiego parametru nie jest alokowane miejsce na ekranie.

 

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

Uwaga

Ponieważ nazwa parametru jest kluczowa i wewnętrznie w klasie nie może być pusta – w przypadku jej pominięcia następuje podstawienie Nazwy wartością Promptu. Należy jednak zwrócić uwagę na to, że jeśli w prompcie występuje akcelerator - jest on także wstawiany do nazwy. W związku z tym np. w tekście Kolumna1=?@n3|&Parametr:1 OR Kolumna2=??Parametr, ciąg ??Parametr nie zostanie podstawiony wartością parametru Parametr (należy użyć ??&Parametr).

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:

Uwaga

Jeśli Default dla parametrów stringowych bez sekwencji zakończenia, zawiera którykolwiek ze znaków wymienionych wyżej (w szczególności spację), musi być otoczony apostrofami, np. ?@s20|Akronim|&Akronim:’A B’ (z sekwencją zakończenia można tak: ?@s20|Akronim|&Akronim:A B@?, Lub tak: ?@s20|Akronim|&Akronim:’A B’@?).

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).

Przyklad

Tekst, w którym jest umieszczony parametr stanowi filtr, do którego chcemy dokleić (AND) filtr FiltrApp przekazywany z aplikacji, osadzamy parametr: ?@s255_NQ|FiltrApp|Filtr aplikacji:@?. Zastosowanie modyfikatora _NQ pozwoliło wstawić fragment filtra bez otaczających apostrofów, mimo stringowego formatu parametru. Wstawienie apostrofów prowadziłoby do błędu, np. uzyskalibyśmy filtr końcowy postaci: ... AND ‘BNa_BnaID>10’.

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).

Przyklad

Tekst, w którym jest umieszczony parametr stanowi wywołanie procedury, której drugim parametrem jest parametr stringowy, odpowiadający numerowi rachunku bankowego: OP_KASAI.DLL|CALLBRPLISTA('BRA',?@n6_Q|RachunekID|Rachunek:0@?). Umieszczenie całego parametru w apostrofach spowoduje, że parametr ten nie będzie „widziany” przez parser.

Uwaga

Stosowanie modyfikatorów ma sens tylko dla samodzielnych definicji parametrów (tzw. stara składnia), stanowiących jednocześnie deklarację parametru i odwołanie do jego wartości. Jeśli definicja jest częścią deklaracji @PAR … PAR@, to stosowanie modyfikatorów nie ma sensu – deklaracje są w całości usuwane z tekstu. W tym przypadku modyfikatory należy umieszczać w odwołaniach do wartości parametrów (np. ??_QNazwa).

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)).

Przyklad

Przykład 1: (poprawne ale nieefektywne wstawienie pustej linii pomiędzy kontrolki parametrów: ??Akronim i ??SprawdzajDaty) @PAR ?@s20|Akronim|&Akronim:@? PAR@ @PAR ?@n1|PustaLinia|Pusta linia:@? @HIDE() PAR@ @PAR ?@X|SprawdzajDaty|&Sprawdzaj daty:1@? PAR@ Przykład 2: (linia nie będzie wstawiona) @PAR ?@s20|Akronim|&Akronim:@? PAR@ @PAR ?@Hn1|PustaLinia|Pusta linia:@? PAR@ @PAR ?@X|SprawdzajDaty|&Sprawdzaj daty:1@? PAR@

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:

Przyklad

Przykład 3: (poprawne i zalecane wstawienie pustej linii pomiędzy kontrolki parametrów ??Akronim i ??SprawdzajDaty). @PAR ?@s20|Akronim|&Akronim:@? PAR@ @PAR ?@EOL PAR@ @PAR ?@X|SprawdzajDaty|&Sprawdzaj daty:1@? PAR@

 

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@

Uwaga

Aby walidować parametry typu DT – należy używać modyfikatorów _Q: Ustalony moment z walidacją: @PAR ?@DT|dt4|t&4:2003-03-22 10:00:00@? @COND(??_Qdt4 >= ??_Qdt3) @CONDMSG(dataczas ''Do'' nie może być mniejsza niż dataczas ''Od'') PAR@ Rozwinięcia: …WHERE CRK_TerminOd <= ??dt1 … WHERE YMDHMS(CRK_TerminOd) <= ??_YMDHMS_dt1 …

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’).

Uwaga

Opcjonalne parametry ParametryCallLookupFunkcjaU mogą zawierać odwołania do wartości innych parametrów dynamicznych; jest to jedyny obsługiwany przypadek zagnieżdżania parametrów (obsługiwany tylko w wyższej warstwie, tj. przez klasę operującą na kontrolkach). Składnia odwołania jest następująca:

?#[_Q]NazwaInnegoParametru#?.

Przykład: BZp_BRpID=?@Ls30_NQ(OP_KASAI.DLL|CALLLOOKUPBRPLISTA({_Q'BRA,'&?#_QRachunekID#?}))|RaportID|&Raport:0|@?.

  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).

Uwaga

W tekście należy używać zawsze pełnej deklaracji parametru (@PAR … PAR@), a nie samej definicji. W zasadzie użycie apostrofów ograniczających jest konieczne tylko, gdy w tekście do wyświetlenia występują nawiasy (), {} lub inne zastrzeżone sekwencje specjalne. Jednak dla większego bezpieczeństwa zaleca się zawsze używać apostrofów ograniczających. Jeśli w wyświetlanym tekście mają być apostrofy – w deklaracji należy je zdublować.

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:  

Przyklad

Kolumna1 = ?@n3|MójParametr|&Mój parametr:255@? OR Kolumna2 = ?@n3|MójParametr|&Mój parametr:255@?

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.

Przyklad

Kolumna1 = ?@n3|MójParametr|&Mój parametr:255@? OR Kolumna2 = ??MójParametr

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:

Przyklad

Można to wykorzystać np. przy ustalaniu warunku na daty z zakresu dat: warunek COND(??DataOd<=??DataDo) zakładamy tylko na DataDo. Jeśli założylibyśmy warunek na obie daty to przy zmianie zakresu 01.01.2003 – 31.01.2003 na 01.02.2003 – 28.01.2003 musielibyśmy najpierw zmienić datę końcową, a potem początkową, co jest niewygodne.

Uwaga

Jeśli mają zostać walidowane parametry typu DT – należy używać modyfikatorów _Q: @PAR ?@DT|dt4|t&4:2003-03-22 10:00:00@? @COND(??_Qdt4 >= ??_Qdt3) @CONDMSG(dataczas ''Do'' nie może być mniejsza niż dataczas ''Od'') PAR@

  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.

Przyklad

W poniższym przykładzie Akronim jest zawsze UPPER a ponadto jest disablowany za każdym razem gdy Numer > 10. Z kolei Numer to spin o zakresie (–100; 100) i skoku 2, disablowany w przypadku gdy Akronim = ‘D’. Wreszcie spin Hide jest ukrywany, jeśli Numer=30. Parametr DataDo musi mieć wartość nie mniejszą od wartości parametru DataOd a przynajmniej jeden z checków FA, PA musi być zaznaczony. @PAR ?@S20|Akronim|&Akronim:ALA@? @U(), @D(??Numer > 10) @MSG(Akronim kontrahenta) @TIP(=MSG) PAR@ @PAR ?@N-15.2|Numer|&Numer:20.0@? @RL(-100) @RH(100) @S(2) @D(??Akronim = 'D') PAR@ @PAR ?@N-15.2|Hide|&Hide:1.0@? @H(??Numer = 30) PAR@ @PAR ?@N-3|Do|&Do:10@? @RL(??Od) @RH(??Od + 10) PAR@ @PAR ?@D17|DataDo|&Do:{Today()+1}@? @COND(??DataDo >= ??DataOd) @CONDMSG(Data Do nie może być wcześniejsza niż data Od) PAR@ @PAR ?@X|PA|&Paragony:1@? @COND(??FA + ??PA > 0) @CONDMSG(Przynajmniej jeden typ dokumentu musi być zaznaczony) PAR@

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 plik 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 XL API z systemem Comarch ERP 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  XL API połączyć się z systemem Comarch ERP 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  XL API.

Uwaga

W przypadku wielokrotnego wywoływania tej samej funkcji API (np. dodawanie wielu pozycji do FS) konieczne jest czyszczenie struktury (zmienne typu Long należy wypełnić 0, zmienne typu String - pustym ciągiem ””) wykorzystywanej w funkcji każdorazowo po jej użyciu. Jest to konieczne, ponieważ w niektórych polach struktury zwracane są wartości, które w przypadku nie wyczyszczenia ich, będą użyte przy ponownym wykorzystaniu struktury.

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

W wersji 2024.1 dokonano zmian w obsłudze funkcji XLDodajPlatnoscZam w zakresie waluty ustalanej na dodawanej płatności zamówienia. Dotychczas, pomimo podawania wartości dla pola Waluta System ustalał każdorazowo na płatności walutę systemową. Niedogodność ta została usunięta i odtąd honorowana jest waluta przekazana do tej funkcji.

Uwaga

Jeżeli Użytkownik nie przekaże waluty do ww. funkcji, wówczas System ustali na płatności walutę zgodną z walutą nagłówka zamówienia.

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 XL API. Plik jest dostępny na stronie Comarch (w zasobach Comarch ERP 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 Comarch ERP XL, 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.

Debugowanie od wersji XL 2021

Od wersji 2021.0 podłączenie się pod procesy XL debugerem zostało standardowo zablokowane ze względu na zalecenia działu bezpieczeństwa.  W celu debugowania należy zastosować pakiet deweloperski dostępny na stronach walidowanych dla partnerów w sekcji dodatki dla wersji XL 2021 ( pliki z pakietu należy wgrać do katalogu XL następnie uruchomić rejestr.bat).

Funkcje API wspierające operacje KSeF

W wersji 2024.0 przygotowany został szereg funkcji API, służących do komunikacji z KSeF.

Funkcje API do komunikacji z KSeF
Nazwa funkcji	Obsługa
XLKSeFOtworzSesje	Funkcja służąca do nawiązywania sesji KSeF
XLKSeFZamknijSesje	Funkcja służąca do zamykania sesji KSeF
XLKSeFDodajDokumentyDoWyslania	Funkcje służące do wysyłania faktury/faktur do KSeF. Pierwsza z nich służy do podania listy dokumentów, które mają zostać wysłana, druga zaś do wysyłki tej listy dokumentów
XLKSeFWyslijDokumenty
XLKSeFPobierzUPO	Funkcja służąca do pobierania UPO do wskazanej sesji/dokumentu
XLKSeFUstalStatusDokumentu	Dodanie rekordu KSeFDokumenty	Funkcje służące do dodawania/modyfikacji/usuwania rekordów tabeli KSeFDokumenty, tj. zapisania w Systemie informacji o: - Dla faktur sprzedaży: o dokonanej wysyłce faktur/pobranym UPO dokonanym poza Systemem Comarch ERP XL - Dla faktur zakupu: o fakturze KSeF na podstawie której zarejestrowano dany dokument zakupu, dla przypadków, kiedy faktury te nie były importowane wprost do Systemu, ale poza nim
XLKSeFZmienStatusDokumentu	Zmiana rekordu KSeFDokumenty
XLKSeFUsunStatusDokumentu	Usunięcie rekordu KSeFDokumenty
XLKSeFSpinajZDokumentem	Funkcja służąca do spięcia faktury zaimportowanej z KSeF z dokumentem zakupu zarejestrowanym w Comarch ERP XL
XLKSeFRozłaczZDokumentem	Funkcja służąca do rozłączania faktury zaimportowanej z KSeF z dokumentem zakupu zarejestrowanym w Comarch ERP XL
XLKSeFPobierzDokumenty	Funkcja służąca do pobrania faktur zakupu z KSeF

Funkcja służąca do otwierania sesji KSeF

Za pomocą funkcji XLKSeFOtworzSesje Operator może nawiązać sesję KSeF, w ramach której po użyciu kolejnej funkcji API czy to wyśle faktury do KSeF, czy to pobierze UPO. Operator może podać Systemowi informację o sposobie w jaki ma być dokonane uwierzytelnienie w KSeF w następujący sposób:

Zachowanie Systemu w zakresie uwierzytelnienia zależne jest dodatkowo od rodzaju sesji, którą nawiązuje Operator (plik wsadowy/wysyłka interaktywna). Nawiązanie sesji wsadowej KSeF możliwe jest wyłącznie przy pomocy certyfikatu.

Funkcja służąca do zamykania sesji KSeF

Udostępniona została funkcja XLKSeFZamknijSesje pozwalająca na zamknięcie danej sesji KSeF. Jeżeli Operator poda numer sesji, wówczas to ona zostanie zamknięta, wywołanie funkcji bez podania numeru sesji będzie zaś oznaczało, że System ma zamknąć sesję utworzoną w XLKSeFOtworzSesje.

Za pomocą tej funkcji można zamknąć dowolną sesję, również innego Operatora, nawiązaną z innego modułu.

Funkcje służące do wysyłania dokumentów do KSeF

Udostępnione zostały funkcje służące do wysyłania faktury/faktur do KSeF. Funkcja XLKSeFDodajDokumentyDoWyslania służy do podania listy dokumentów, które mają zostać wysłane, funkcja XLKSeFWyslijDokumenty zaś do wysyłki tej listy dokumentów.

Aby wysłać dokumenty do KSeF Operator powinien wykonać poniższe działania:

Funkcja służąca do pobierania UPO

Pobrania UPO można dokonać za pomocą funkcji XLKSeFPobierzUPO. Użytkownik może w niej podać numer sesji, dla której ma zostać pobrane UPO lub GID dokumentu, dla którego ma zostać pobrane UPO. W tym ostatnim przypadku System samodzielnie ustali numer sesji, w ramach której został wysłany podany dokument i pobierze UPO dla tego dokumentu oraz wszystkich pozostałych dokumentów wysłanych w ramach tej sesji.

Aby możliwe było pobranie UPO dla danej sesji, taka sesja musi być zamknięta. Podczas pracy przy użyciu funkcji API System samodzielnie nie dokonuje zamknięcia sesji, dla której wywołane zostanie pobranie UPO, takiego zamknięcia musi dokonać Użytkownik. Z kolei każda komunikacja ze środowiskiem KSeF odbywa się po nawiązaniu sesji KSeF. Powyższe determinuje określony model pracy Użytkownika korzystającego z funkcji API.

Funkcje dodawania/zmiany/usuwania rekordu w tabeli KSeFDokumenty

Ideą ww. funkcji jest tworzenie/modyfikacja rekordów tabeli KSeFDokumenty, tj. zapisanie w Systemie informacji j.n.:

Na potrzeby ww. udostępnione zostały trzy funkcje:

Funkcje służące do spinania/rozłączania faktury zakupu z fakturą KSeF

Za pomocą funkcji XLKSeFSpinajZDokumentem Użytkownik może dokonać spięcia faktury zaimportowanej z KSeF z dokumentem zakupu zarejestrowanym w Comarch ERP XL, za pomocą funkcji XLRozłaczZDokumentem zaś dokonać rozłączenia tych obiektów.

Funkcja pobierania faktur z KSeF

Funkcja XLKSeFPobierzDokumenty służy do pobrania faktur zakupu z KSeF. Za jej pomocą Operator może dokonać importu tych faktur, w których Nabywcą jest firma będąca Użytkownikiem Systemu Comarch ERP XL. Import ten może się odbyć według identycznych kryteriów, jak te dostępne z interfejsu tj. można w ten sposób zaimportować fakturę o konkretnym numerze KSeF, faktury zarejestrowane w podanym okresie czasu lub dokonać importu nowych faktur tj. faktur z datą równą i większą od najpóźniejszego z dotąd zaimportowanych dokumentów.

Struktura plików synchronizacyjnych z bazy mobilnej

Sekcja informacyjna (INFOBLOK)

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

Atrybut	Opis	ERP XL
<INFOBLOK/>	Sekcja informacyjna	PicoKonfig
OddzialID	ID oddziału Mobile	PcK_PicoID
CentrumID	ID centrum będącego oddziałem	PcK_CentrumID
WersjaPliku	Wersja pliku
Kierunek	Kierunek synchronizacji (1 – plik dla oddziału, 2 – plik od oddziału)

Kontrahenci (KNTI)

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

<KNTI/>	Opis	ERP XL
<KNT/>	Sekcja z kontrahentami	KntKarty, KntOpisy
GIDTyp	Identyfikator kontrahenta	Knt_GIDTyp
GIDNumer	Identyfikator kontrahenta	-
KnANumer	Identyfikator aktualnego adresu	-
Adres	Dodatkowe pole adresu	Knt_Adres
Wojewodztwo	Nazwa województwa	Knt_Wojewodztwo
Pesel	Pesel kontrahenta	Knt_Pesel
Akwizytor	Czy kontrahent jest akwizytorem?	Knt_Akwizytor
PlatnikVAT	Czy kontrahent jest płatnikiem VAT?	Knt_PlatnikVAT
Status	Status kontrahenta Podmiot gospodarczy Odbiorca finalny	Knt_Status
Typ	Czy kontrahent jest dostawcą/odbiorcą? 08 – dostawca 16 – odbiorca 24 – dostawco-odbiorca	Knt_Typ
Oddzialowy	Czy kontrahent został przesłany do oddziału? 0 – NIE, 1 – TAK	Knt_Oddzialowy
KodP	Kod pocztowy	Knt_KodP
Miasto	Adres kontrahenta	Knt_Miasto
Ulica	Adres kontrahenta	Knt_Ulica
Regon	Nr REGON kontrahenta	Knt_Regon
Telefon1	Telefon do biura	Knt_Telefon1
Telefon2	Telefon domowy	Knt_Telefon2
Fax	Połączenia telefoniczne	Knt_Fax
Telex	Połączenia telefoniczne	Knt_Telex
Email	Adres poczty elektronicznej	Knt_Email
Modem	Połączenia telefoniczne	Knt_Modem
URL	Adres strony w internecie	Knt_URL
Symbol	Symbol waluty	Knt_Symbol
Dewizowe	Czy kontrahent dewizowy?	Knt_Dewizowe
Knt_MSTwrGrupaNumer	Identyfikator grupy towarów dla Comarch Mobile	Knt_MSTwrGrupaNumer
Nazwa1	Pierwsza część nazwy kontrahenta	Knt_Nazwa1
Nazwa2	Druga część nazwy kontrahenta	Knt_Nazwa2
Nazwa3	Trzecia część nazwy kontrahenta	Knt_Nazwa3
Cena	Rodzaj ceny sprzedaży – domyślny dla dokumentów	Knt_Cena
FormaPl	Forma płatności (sprzedaż)	Knt_FormaPl
LimitOkres	Maksymalny okres odroczenia płatności	Knt_LimitOkres
SposobDostawy	Domyślny sposób dostawy dla kontrahenta w transakcjach	Knt_SposobDostawy
CechaOpis	Opis przepisywany na dokument	Knt_CechaOpis
DataUtworzenia	Data utworzenia karty kontrahenta	Knt_DataUtworzenia
Rodzaj	Rodzaj kontrahenta	Knt_Rodzaj
Osoba	Domyślna osoba kontrahenta	Knt_Osoba
Akronim	Skrócona nazwa kontrahenta	Knt_Akronim
NipE	NIP prezentowany na ekranie	Knt_NipE
Nip	NIP bez kresek	Knt_Nip
NipPrefiks	Prefiks numeru NIP	Knt_NipPrefiks
OpeTyp	Operator zakładający kartę	Knt_OpeTyp
OpeNumer	Operator zakładający kartę	Knt_OpeNumer
FrsID	Identyfikator centrum struktury praw	Knt_FrsID
Opis	Treść opisu karty kontrahenta	KnO_Opis

Adresy kontrahenta (KNAI)

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

<KNAI/>	Opis	ERP XL
<KNA/>	Sekcja z adresami kontrahenta	KntAdresy
GIDTyp	Identyfikator zapisu	KnA_GIDTyp
GIDNumer	Identyfikator zapisu	-
Akronim	Skrócona nazwa kontrahenta	KnA_Akronim
Wysylkowy	Ten adres jest adresem wysyłkowym	KnA_Wysylkowy
Nazwa1	Pierwsza część nazwy kontrahenta	KnA_Nazwa1
Nazwa2	Druga część nazwy kontrahenta	KnA_Nazwa2
Nazwa3	Trzecia część nazwy kontrahenta	KnA_Nazwa3
KodP	Kod pocztowy	KnA_KodP
Miasto	Adres kontrahenta	KnA_Miasto
Ulica	Adres kontrahenta	KnA_Ulica
Telefon1	Telefon do biura	KnA_Telefon1
Telefon2	Telefon zastępczy	KnA_Telefon2
Fax	Połączenia telefoniczne	KnA_Fax
Telex	Połączenia telefoniczne	KnA_Telex
EMail	Adres poczty elektronicznej	KnA_Email
URL	nieużywane	-
Modem	Połączenia telefoniczne	KnA_Modem
LastModL	Data ostatniej modyfikacji lokalnej	KnA_LastModL
Domyslny	Adres domyslny	KnA_Domyslny
Nip	Nip bez kresek	KnA_Nip
NipE	Nip prezentowany na ekranie	KnA_NipE
NipPrefiks	Prefiks numeru NIP	KnA_NipPrefiks
Regon	Numer REGON kontrahenta	KnA_Regon

Osoby kontrahenta (KNSI)

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

<KNSI/>	Opis	ERP XL
<KNS>	Sekcja z opisami kontrahenta	KntOsoby
GIDNumer	Identyfikator kontrahenta,z którym zapis jest związany	-
RolaDecyzyjna	Id roli decyzyjnej osoby ze słownika “rola decyzyjna”	KnS_RolaDecyzyjna
Stanowisko	Stanowisko zajmowane przez osobę	KnS_Stanowisko
Notatki	Adnotacje o osobie	KnS_Notatki
Nazwa	Imię I nazwisko osoby	KnS_Nazwa
KntLp	Kolejny numer osoby	KnS_KntLp
Telefon	Telefon prywatny	KnS_Telefon
Email	Adres poczty elektronicznej	KnS_Email
Fax	Połączenia telefoniczne	KnS_Fax
TelefonK	Numer telefonu komórkowego	KnS_TelefonK
LastModL	Data i czas ostatniej modyfikacji	KnS_CzasModyfikacji
Archiwalny	Flaga określająca, czy osoba jest archiwalna	KnS_Archiwalny
Upowazniona	Czy osoba jest upoważniona do odbioru FA	KnS_Upowazniona
UpowaznionaZam	Czy osoba jest upoważniona do składania zamówienia	KnS_UpowaznionaZam
Dzial	Dział, w którym pracuje osoba	KnS_Dzial
Tytul	Tytuł osoby	KnS_Tytul
HasloChk	Litery kontrolne hasła	KnS_HasloChk
HasloOsoby	Hasło osoby	KnS_HasloOsoby
UpoDoK	Osoba upoważniona do kontaktów	KnS_UpoDoK
CzyDomyslna	Czy osoba jest domyślna dla kontrahenta?	-

Atrybuty kontrahenta (ATRI*)

Uwaga

Uwaga: W sekcji wysyłana jest analogiczna struktura tagów dla każdego węzła XMLa, w którym się znajdują.

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

<ATRI/>	Opis	ERP XL
<ATR>	Sekcja z atrybutami kontrahenta	Atrybuty, AtrybutyWartosci
Id	ID atrybutu
ObiTyp	GID obiektu, do którego przypisany jest atrybut	Atr_ObiTyp
ObiNumer	GID obiektu, do którego przypisany jest atrybut	-
ObiLp	GID obiektu, do którego przypisany jest atrybut	Atr_ObiLp
ObiSubLp	-	-
AtkId	Id klasy atrybutu	Atr_AtkId
Modyfikuj		-
Wartosc	Wartość atrybutu	Atr_Wartosc

Załączniki kontrahenta (DABI*)

Uwaga

Uwaga: W sekcji wysyłana jest analogiczna struktura tagów dla każdego węzła XMLa, w którym się znajdują.

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

<DABI/>	Opis	ERP XL
<DAB>	Sekcja z załącznikami kontrahenta	DaneBinarne
ZewnetrznyId	Identyfikator załącznika z Comarch Mobile	DAB_ZewnetrznyId
DAB_Id	ID załącznika w systemie	-
Id		-

Zamówienia (ZANI)

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

<ZANI/>	Opis	ERP XL
<ZAN>	Sekcja z nagłówkami zamówień	ZamNag, ZaNOpisy
DokumentNr	Numer zamówienia z oddziału	ZaN_ZamRok, ZaN_ZamMiesiac, ZaN_ZamSeria, ZaN_ZamNumer
GIDTyp	GIDTyp zamówienia	ZaN_GIDTyp
OpeNumer	Identyfikator operatora wystawiającego	ZaN_OpeNumerW
GIDNumer	Identyfikator rekordu	-
OddDokID	Identyfikator dokumentu nadany w oddziale	ZaN_OddDokID
DataWystawienia	Data wystawienia oferty/zamówienia	ZaN_DataWystawienia
GodzinaWystawienia	Godzina wystawienia dokumentu	ZaN_GodzinaWystawienia
Url	url	ZaN_Url
WgStatusu
Stan	Stan dokumentu Możliwe wartości: Stan_zrealizowane = 21 - maska_archiw + w_realizacji, Stan_odrzucone = 19 - maska_archiw + potwierdzone, Stan_anul_potwierdzone = 35 - maska_anulowane + potwierdzone, Stan_maska_archiw = 16, Stan_maska_anulowane = 32, Stan_w_realizacji = 5, Stan_zaakceptowane = 4, Stan_potwierdzone = 3, Stan_zamowienie = 2, Stan_oferta = 1, Stan_zapytanie = 0.	ZaN_Stan
Blokuj
Modyfikuj
DokumentObcy	Oznaczenie oferty/zamówienia u kontrahenta	ZaN_DokumentObcy
RodzajCeny
KntTyp	Identyfikator kontrahenta	ZaN_KntTyp
KntNumer	Identyfikator kontrahenta	ZaN_KntNumer
KnDTyp	GID odbiorcy	ZaN_KnDTyp
KnDNumer	GID odbiorcy	ZaN_KnDNumer
AdWNumer	Identyfikator adresu wysyłkowego	ZaN_AdWNumer
KnPTyp	Identyfikator płatnika	ZaN_KnPTyp
KnPNumer	Identyfikator płatnika	ZaN_KnPNumer
Rabat	Rabat globalny (% lub kwotowy)	ZaN_Rabat
FlagaNB	Flaga netto/brutto	ZaN_FlagaNB
FormaNr	Numer formy płatności 10 – Gotówka 20 – Przelew 30 – Kredyt 40 – Czek 50 – Karta 60 – Inne	ZaN_FormaNr
TerminPlatnosci	Termin płatności	ZaN_TerminPlatnosci
Waluta	Symbol waluty	ZaN_Waluta
WspolnaWaluta	Czy wspólna waluta na zamówieniach	ZaN_WspolnaWaluta
KursL	Licznik kursu	ZaN_KursL
KursM	Mianownik kursu	ZaN_KursM
ZamSeria	Seria zamówienia	ZaN_ZamSeria
ZamTyp	Typ zamówienia/oferty oferta na zakup (dostawcy), 768 - oferta sprzedaży (nasza), 1152 - zamówienie na zakup (do dostawcy), 1280 - zamówienie sprzedaży (od klienta), 2688 - zapyt. ofert. na zakup, 2816 - zapyt. ofert. na sprzedaż, Powstały w wyniku sklejenia masek: 1024 - zamówienie, 512 - oferta, 2048 - dokument pomocniczy (zapytanie lub potwierdzenie), 256 - na sprzedaż, 128 - na zakup.	ZaN_ZamTyp
ZamNumer	Numer zamówienia	ZaN_ZamNumer
ZamRok	Rok zamówienia	ZaN_ZamRok
ZamMiesiac	Miesiąc zamówienia	ZaN_ZamRok
Rodzaj	Rodzaj transakcji 0-krajowa; 1-inna zagr., VAT 0%; 2-inna zagr., VAT dowolny; 6-ww dostawa, VAT 0%; 7-ww dostawa, VAT dowolny; 8-ww dostawa trójstronna, VAT 0%; 9-ww dostawa trójstronna, VAT dowolny; 10-ww nabycie, VAT 0%; 11-ww nabycie, VAT dowolny; 12-ww nabycie trójstronne, VAT 0%; 13-ww nabycie trójstronne, VAT dowolny;	ZaN_Rodzaj
RokMiesiac	Rok i miesiąc dokumentu	ZaN_RokMiesiac
FrsID	Identyfikator miejsca w strukturze firmy	ZaN_FrsID
OpiTyp	Opiekun	ZaN_OpiTyp
OpiNumer	Opiekun	ZaN_OpiNumer
CechaOpis	Cecha zamówienia	ZaN_CechaOpis
MagTyp	Identyfikator magazynu domyślnego	ZaN_MagTyp
MagNumer	Identyfikator magazynu domyślnego	ZaN_MagNumer
DataRealizacji	Przewidywana data realizacji zamówienia	ZaN_DataRealizacji
RealWCalosci	Czy realizacja zamówienia ma być tylko w całości	ZaN_RealWCalosci
Opis	Opis zamówienia	ZnO_Opis
WtrID	Identyfikator promocj iwartościowej	ZaN_WtrID
WtrProgId	Identyfikator progu promocji wartościowej	ZaN_WtrProgId
ExpoNorm	Rodzaj transakcji 0-krajowa; 1-inna zagr., VAT 0%; 2-inna zagr., VAT dowolny; 6-ww dostawa, VAT 0%; 7-ww dostawa, VAT dowolny; 8-ww dostawa trójstronna, VAT 0%; 9-ww dostawa trójstronna, VAT dowolny; 10-ww nabycie, VAT 0%; 11-ww nabycie, VAT dowolny; 12-ww nabycie trójstronne, VAT 0%; 13-ww nabycie trójstronne, VAT dowolny;	ZaN_ExpoNorm

Elementy zamówienia (ZAEI)

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

<ZAEI/>	Opis	ERP XL
<ZAE>	Sekcja z elementami zamówienia	ZamElem
GIDTyp	Identyfikator nagłówka	ZaE_GIDTyp
Pozycja	Pozycja elementu na dokumencie	ZaE_Pozycja
OddElemId	Id elementu w oddziale	ZaE_OddElemId
GIdLp	Identyfikator nagłówka	ZaE_GIDLp
Modyfikuj
DataPotierdzeniaDostawy	Data potwierdzenia przyjęcia dostawy	ZaE_DataPotwierdzeniaDostawy
MagNumer	Identyfikator magazynu domyślnego	ZaE_MagNumer
JmZ	Jednostka pomocnicza	ZaE_JmZ
PrzeliczM	Mianownik przelicznika jednostki miary	ZaE_PrzeliczM
PrzeliczL	Licznik przelicznika jednostki miary	ZaE_PrzelicznL
TwrNumer	Identyfikator towaru	ZaE_TwrNumer
Wartosc
GrupaPod	Grupa podatku (A,B,C itd.)	ZaE_GrupaPod
StawkaPod	Stawka VAT	ZaE_StawkaPod
CenaSpr	Cena sprzedaży	ZaE_CenaSpr
Rabat	Procent udzielonego rabatu	ZaE_Rabat
CenaKatalogowa	Cena z karty towaru	ZaE_CenaKatalogowa
Ilosc	Ilość na jaką opiewa transakcja	ZaE_Ilosc
IloscJmZ
FlagaNB	Flaga NB N – linia od netto B – linia od brutto	ZaE_FlagaNB
Opis	Opis elementu zamówienia	ZnO_Opis
Gratis	Rodzaj elementu promocji pakietowej 0 – element, 1 – gratis	ZaE_Gratis
PakietID	Identyfikator promocji pakietowej	ZaE_PakietID
PakietProgID
Waluta	Symbol waluty	ZaE_Waluta
KursL		ZaE_KursL
KursM		ZaE_KursM

Dokumenty handlowe (TRNI)

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

<TRNI/>	Opis	ERP XL
<TRN>	Sekcja z nagłówkami dokumentów handlowych	TraNag
GIDTyp	Identyfikator rekordu 1521 - FZ 1529 - FZK 1489 - PZ 1497 - PZK 1490 - PZI 1498 - PKI 2033 - FS 2041 - FSK 2036 - FW 2044 - FWK 2001 - WZ 2009 - WZK 2034 - PA 2042 - PAK 2035 - RA 2043 - RAK 1968 - TF 2039 - RS 2047 - RSK 2003 - KK 2037 - FSE 2045 - FKE 2005 - WZE 2013 - WKE 1312 - FZL 1824 - FSL 1828 - FEL 1836 - KEL 1616 - RW 1624 - RWK 1617 - PW 1625 - PWK 1603 - MMW 1604 - MMP 1600 - MM	TrN_GIDTyp
GIDNumer	ID dokumentu w bazie mobilnej	TrN_GIDNumer
OddDokID	ID dokumentu w bazie mobilnej	TrN_OddDokId
SpiTyp	GID Spinacza	TrN_SpiTyp
SpiNumer	GID Spinacza	TrN_SpiNumer
Data2	Data wystawienia dokumentu	TrN_Data2
Data3	Data sprzedaży/zakupu	TrN_Data3
DataVat	-	-
DataMag	Data przyjęcia/wydania towaru	TrN_DataMag
Url	url	TrN_Url
DokumentObcy	Numer dokumentu obcego	TrN_DokumentObcy
RodzajCeny	-	-
KntTyp	GID Kontrahenta	TrN_KntTyp
KntNumer	GID Kontrahenta	TrN_KntNumer
KnDTyp	GID Kontrahenta docelowego	TrN_KnDTyp
KnDNumer	GID Kontrahenta docelowego	TrN_KnDnumer
AdWNumer	GID adresu wysyłkowego	TrN_AdWNumer
KnPTyp	GID płatnika	TrN_KnPTyp
KnPNumer	GID Płatnika	TrN_KnPNumer
FlagaNB	Flaga netto/brutto N – netto B – brutto	TrN_FlagaNB
FormaNr	Forma płatności 10 – Gotówka 20 – Przelew 30 – Kredyt 40 – Czek 50 – Karta 60 – Inne	TrN_FormaNr
Termin	Domyślny termin płatności	TrN_Termin
DokumentNr	-	-
TrNTyp	Typ transakcji 1-faktura zakupu; 2-przyjęcie zewnętrzne; 3-faktura sprzedaży; 4-wydanie zewnętrzne; 5-rozchód wewnętrzny; 6-przychód wewnętrzny; 7-przesunięcie międzymagazynowe; 10-paragon 12-AVista zakupu 13-AVista sprzedaży 19-Korekta kosztu 20-Faktura Eksportowa 21-Wydanie zewnętrzne eksportowe 22-Faktura wewnętrzna	TrN_TrNTyp
TrNSeria	Seria dokumentu	TrN_TrNSeria
TrNNumer	Numer dokumentu	TrN_TrNNumer
TrNRok	Rok dokumentu	TrN_TrNRok
TrNMiesiac	Miesiąc dokumentu	TrN_TrNMiesiac
FrsID	Identyfikator centrum-właściciela dokumentu	TrN_FrsID
Fiskalny	Czy wydrukowano fiskalnie? 0 – sprzedaż zwykła Sprzedaż na paragon fiskalny Dokument fiskalny nie wydrukowany na drukarce	TrN_Fiskalny
OpeNumer	GID operatora wystawiającego	TrN_OpeNumer
OpiTyp	Opiekun kontrahenta	TrN_OpiTyp
OpiNumer	Opiekun kontrahenta	TrN_OpiNumer
CechaOpis	Wartość cechy transakcji	TrN_CechaOpis
Waluta	Symbol waluty	TrN_Waluta
Opis	Opis dokumentu	TnO_Opis
MagazynZ	Akronim magazynu źródłowego
WtrId	Identyfikator promocji wartościowej	TrN_WtrId
WtrProgId	Identyfikator progu promocji wartościowej	TrN_WtrProgId
ExpoNorm	Rodzaj transakcji 1-krajowa; 2-inna zagr., VAT 0%; 3-inna zagr., VAT dowolny; 4-inna zagr., korekta VAT dowolny -> VAT 0%; 5-inna zagr., korekta VAT 0% -> VAT dowolny; 6-ww dostawa, VAT 0%; 7-ww dostawa, VAT dowolny; 8-ww dostawa trójstronna, VAT 0%; 9-ww dostawa trójstronna, VAT dowolny; 10-ww nabycie, VAT 0%; 11-ww nabycie, VAT dowolny; 12-ww nabycie trójstronne, VAT 0%; 13-ww nabycie trójstronne, VAT dowolny; 14-inna zagr., VAT 0%, dla FW (import usług); 15-inna zagr., VAT dowolny, dla FW (import usług); 16-ww dostawa, korekta VAT dowolny -> VAT 0%; 17-ww dostawa, korekta VAT 0% -> VAT dowolny; 18-ww dostawa trójstronna, korekta VAT dowolny -> VAT 0%; 19-ww dostawa trójstronna, korekta VAT 0% -> VAT dowolny; 20-podatnikiem jest nabywca; 21-ww dostawa, VAT dowolny, transakcja opodatkowana poza terytorium kraju; 22-tax free; 23-inna zagr., VAT dowolny, transakcja opodatkowana poza terytorium kraju;	TrN_ExpoNorm
CWENumer
ZewnetrznyId
ZewnetrznySys
CWELp

Elementy dokumentu handlowego (TREI)

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

<TREI/>	Opis	ERP XL
<TRE>	Sekcja z elementami dokumentu handlowego	TraElem, TraSElem
NiePrzeliczaj
GIDTyp	GID Elementu transakcji	TrE_GIDTyp
GIDLp	Numer kolejny elementu transakcji	TrE_GIDLp
SubGIDLp	-	-
Pozycja	Pozycja elementu na dokumencie	TrE_Pozycja
JmZ	Jednostka pomocnicza	TrE_JmZ
PrzeliczM	Mianownik przelicznika	TrE_PrzeliczM
PrzeliczL	Licznik przelicznika	TrE_PrzeliczL
TwrNumer	GID towaru	TrE_TwrNumer
Wartosc
Cena	Cena początkowa	TrE_Cena
GrupaPod	Symbol grupy podatkowej	TrE_GrupaPod
StawkaPod	Stawka podatku	TrE_StawkaPod
CenaSpr	Cena domyślna dla transakcji	TrE_CenaSpr
Poczatkowa	Cena początkowa	TrE_Poczatkowa
Rabat	Procent udzielonego rabatu	TrE_Rabat
Ilosc	Ilość na jaką opiewa transakcja	TrE_Ilosc
Opis	Opis elementu	TeO_Opis
DstNumerO	GID dostawy	TrS_Dstnumer
DstNumer	GID dostawy	TrS_DstNumer
Gratis	Rodzaj elementu promocji pakietowej 0 – element, 1 – gratis	TrE_Gratis
PakietID	Identyfikator promocji pakietowej	TrE_PakietID
PakietProgID
Zlom	Element traktowany jako odwrotne obciążenie 0 – element, 1 – odwrotne obciążenie	TrE_Zlom

Dokumenty magazynowe (MANI)

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

<MANI/>	Opis	ERP XL
<MAN>	Sekcja z nagłówkami dokumentów magazynowych	MagNag
Typ	Identyfikator rekordu	MaN_GIDTyp
GIDTyp	Identyfikator rekordu	MaN_GIDTyp
GIDNumer	GID dokumentu w bazie mobilnej	MaN_OddDokId
OddDokID	GID dokumentu w bazie mobilnej	MaN_OddDokId
MaN_ZewnetrzneId	Identyfikator dokumentu w systemie zewnętrznym	MaN_ZewnetrzneId
MaN_ZewnetrznySys	Identyfikator systemu zewnętrznego	MaN_ZewnetrznySys
Data	Data wystawienia dokumentu	MaN_Data3
Rok	Rok transakcji	MaN_TrNRok
Miesiac	Miesiąc transakcji	MaN_TrNMiesiac
Numer	Numer transakcji	MaN_TrNNumer
MAG_GIDNumer	GID magazynu docelowego	MaN_MagDNumer
Cecha	Cecha transakcji	MaN_CechaOpis
Knt_GIDNumer	Identyfikator kontrahenta	MaN_KntNumer
SER_GIDnumer	GID serii dokumentu	MaN_TrNSeria
Opis	Opis dokumentu	MnO_Opis
OpeId	Identyfikator operatora	MaN_OpeNumer
FrsID	Identyfikator centrum – właściciela dokumentu	MaN_FrsID

Element dokumentu magazynowego (MAE)

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

<MAE/>	Opis	ERP XL
	Sekcja z elementami dokumentu magazynowego	MagElem
TwrNumer	Identyfikator towaru	MaE_TwrNumer
Ilosc	Ilość w jednostce podstawowej	MaE_Ilosc
JmZ	Jednostka pomocnicza	MaE_JmZ
PrzeliczL	Licznik przelicznika	MaE_PrzeliczL
PrzeliczM	Mianownik przelicznika	MaE_PrzeliczM
Opis	Opis elementu	MnO_Opis

Subelement elementu dokumentu magazynowego (MAS)

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

<MAS/>	Opis	ERP XL
	Sekcja z subelementami dokumentu magazynowego	MagSElem, MagPElem
Ilosc	Ilość na jaką opiewa transakcja	MaS_Ilosc
DstNumer	Identyfikator dostawy	MaS_DstNumer

Reklamacje (RLNI)

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

<RLNI/>	Opis	ERP XL
<RLN>	Sekcja z nagłówkami reklamacji	ReklNag
DokumentNr		-
Id	GID reklamacji w bazie mobilnej	RLN_OddDokId
OddDokID	GID reklamacji w bazie mobilnej	RLN_OddDokId
Typ	GIDTyp reklamacji 3584 – RLS	RLN_Typ
KntTyp	Gid Kontrahenta	RLN_KntTyp
KntNumerC	GID kontrahenta	RLN_KntNumer
KnDTyp	GID Kontrahenta docelowego	RLN_KnDTyp
KnDNumer	GID kontrahenta docelowego	RLN_KnDNumer
KnDLp	GID Kontrahenta docelowego	RLN_KnDLp
AdWNumer	GID adresu wysyłkowego	RLN_AdWNumer
AdWTyp	GID adresu wysyłkowego	RLN_AdWTyp
FrsID	Identyfikator właściciela dokumentu	RLN_FrsID
DataWyst	Data wystawienia dokumentu	RLN_DataWyst
Rok	Rok reklamacji	RLN_Rok
Miesiac	Miesiąc reklamacji	RLN_Miesiac
Seria	Seria reklamacji	RLN_Seria
Numer	Numer reklamacji	RLN_Numer
Stan	Stan dokumentu 1- niepotwierdzona, 2-niepotwierdzona po reedycji, 6-reklamacja anulowana, 10- potwierdzono, 20- w realizacji, 21- w realizacji po reedycji, 30- rozpatrzona, 31- rozpatrzona po reedycji, 40- zamknięta	RLN_Stan
Status	Status reklamacji	RLN_Status
OpeNumer	GID operatora wystawiającego	RLN_OpeNumer
CechaOpis	Wartość cechy transakcji	RLN_CechaOpis
Opis	Opis transakcji	RLN_Opis
Url	url	RLN_Url
DokumentObcy	Numer dokumentu obcego	RLN_DokumentObcy

Elementy reklamacji (RLEI)

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

<RLEI/>	Opis	ERP XL
<RLE>	Sekcja z elementami reklamacji	ReklElem
Id	Id rekordu w bazie mobilnej	RLE_OddElemId
OddElemId	Id rekordu w bazie mobilnej	RLE_OddElemId
ZrdTyp	GID elementu dokumentu żródłowego na podstawie, którego reklamowany jest dany towar	RLE_ZrdTyp
ZrdNumer	GID elementu dokumentu żródłowego na podstawie, którego reklamowany jest dany towar	RLE_ZrdNumer
ZrdLp	GID elementu dokumentu żródłowego na podstawie, którego reklamowany jest dany towar	RLE_ZrdLp
DokNumer	Numer dokumentu z pól: RKE_ZrdGID lub tekst, jaki wprowadzi ręcznie operator w polu Numer.	RLE_DokNumer
TwrTyp	GID towaru	RLE_TwrTyp
TwrNumer	GID towaru	RLE_TwrNumer
Ilosc	Ilość na jaką opiewa transakcja	RLE_Ilosc
JmFormat	Miejsca po przecinku	RLE_JmFormat
Zadanie	Żądanie reklamującego	RLE_Zadanie
Status	0 – rozpatrywana, 1 – Uznana, 2- Odrzucona	RLE_Status
Przyczyna	Przyczyna reklamacji	RLe_Przyczyna
Rozpatrzenie	Rozpatrzenie reklamacji	RLE_Rozpatrzenie

Wizyty Handlowe (CWNI)

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

<CWNI/>	opis	ERP XL
<CWN>	Sekcja z nagłówkami wizyt handlowych	CRMWizytyNag
ID		-
ZewnetrznyId	Identyfikator wizyty w bazie mobilnej	CWN_ZewnetrznyId
OpeNumer	Numer operatora wystawiającego	CWN_OpeNumerW
Renumeruj		-
FrsId	Identyfikator centrum – właściciela dokumentu	CWN_FrsId
ZewnetrznySys	Identyfikator systemu zewnętrznego	CWN_ZewnetrznySys
WzNumer	Wzorzec wizyty	CWN_WzNumer
Opis	Opis wizyty	CWN_Opis
Jednorazowa	Czu wizyta jest jednorazowa 0 – NIE, 1 – TAK	CWN_Jednorazowa
CZyZMobile		-
NrKursu	Numer kursu	CWN_NrKursu
Stan	Stan wizyty 1 - Niepotwierdzona, 2 - Potwierdzona, 3 - Anulowana, 4 - Zakończona, 5 - W realizacji	CWN_Stan
Zakonczono	Czy wizyta jest zakończona 0 - nie, 1 - zakończona/wykonana, 2 - zakończona/niewykonana, 3 - zakończona/odrzucona	CWN_Zakonczono
DataWystawienia	Data wystawienia	CWN_DataWystawienia
Rok	Rok wystawienia dokumentu	CWN_Rok
Miesiac	Miesiąc dokumentu	CWN_Miesiac
TypId	Typ wizyty (wartość ze słownika kategorii)	CWN_TypId
Seria	Seria dokumentu	CWN_Seria
Nazwa	Nazwa wizyty	CWN_Nazwa
Numer	Numer dokumentu	CWN_Numer
KntNumer	Numer kontrahenta głównego	CWN_KntNumer
KntTyp	Typ kontrahenta głównego	CWN_KntTyp
KnANumer	Numer adresu kontrahenta głównego	CWN_KnANumer
KnATyp	Typ adresu kontrahenta głównego	CWN_KnATyp
KntOsobaLp	Osoba z karty kontrahenta	CWN_KntOsobaLp
TerminOd	Planowana data/godzina rozpoczęcia wizyty	CWN_TerminOd
TerminDo	Planowana data/godzina zakończenia wizyty	CWN_TerminDo
Obsluga	Identyfikator pracownika obsługującego	CWN_Obsluga
DataZakonczenia	Data/godzina zakończenia realizacji wizyty	CWN_DataZakonczenia
DataZakonczeniaOd	Data/godzina rozpoczęcia wizyty	CWN_DataZakonczeniaOd

Element wizyty handlowej (CWE)

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

<CWE/>	Opis	ERP XL
	Sekcja z elementami wizyt handlowych	CRMWizytyElem
GIDLp	GIDLp rekordu	CWE_GIDLp
Wykonano	Czy wykonano 0 nie, 1 – tak	CWE_Wykonano
Kod	Kod elementu wizyty	CWE_Kod
Nazwa	Nazwa elementu wizyty	CWE_Nazwa
Pozycja	Pozycja elementu wizyty	CWE_Pozycja
Opis	Opis elementu wizyty	CWE_Opis
Wymagany	Czy wymagany do wykonania 0 – nie, 1 tak	CWE_Wymagany
RodzajId	Identyfkator rodzaju elementu wizyty	CWE_RodzajId

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

<CDL/>	Opis	ERP XL
	Sekcja z dokumentami powiązanymi z wizytą handlową	CRMDokumentyLinki
DokTyp	GIDTyp powiązanego dokumentu	CWD_DokTyp
DokNumer		-
DokZewNumer	Numer dokumentu w bazie mobilnej	-

Raporty (KRPI)

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

<KRPI/>	opis	ERP XL
<KRP>	Sekcja z raportami kasowymi	Raporty
GIDNumer	GID raportu w bazie mobilnej	KRP_ZewnetrznyId
Rok	Rok raportu	KRP_Rok
Numer	Numer raportu	KRP_Numer
Seria	Seria (skrót nazwy kasy/banku)	KRP_Seria
RaportNr	Pełny numer raportu	-
DataOtwarcia	Data otwarcia raportu	KRP_DataOtwarcia
DataZamkniecia	Data zamknięcia raportu	KRP_DataZamkniecia
CzasOtwarcia	Data i godzina otwarcia raportu	KRP_CzasOtwarcia
CzasZamkniecia	Data i godzina zamknięcia raportu	KRP_CzasZamkniecia
OpeNumer	GID operatora księgującego raport	KRP_OpeNumerKs
OpeNumerZam	GID operatora zamykającego raport	KRP_OpeNumerZam

Zapisy kasowe/bankowe (KAZI)

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

<KAZI/>	Opis	ERP XL
<KAZ>	Sekcja z zapisami kasowymi	Zapisy
GIDNumer	GID zapisu w bazie mobilnej	KAZ_ZewnetrznyId
OpeNumer	GID operatora wpisującego do raportu	KAZ_OpeNumerRm
OpeNumerR	GID operatora wpisującego do raportu	KAZ_OpeNumerR
OpeNumerB	GID operatora wpisującego do bufora	KAZ_OpeNumerB
KntTyp	GID kontrahenta/pracownika	KAZ_KntTyp
KntNumer	GID Kontrahenta/pracownika	KAZ_KntNumer
NumerDokumentu	Numer dokumentu	KAZ_NumerDokumentu
DataZapisu	Data dokumentu kasowego	KAZ_DataZapisu
CzasZapisu	Data i czas zapisu dokumentu kasowego	KAZ_CzasZapisu
DataDokumentu	Data dokumentu źródłowego	KAZ_DataDokumentu
Kwota	Kwota zapisu	KAZ_Kwota
KRPLp	Lp LONG dla uniknięcia przepełn. buforów	KAZ_KRPLp
Opis	Opis zapisu	KAZ_Opis
Tresc	Treść zapisu	KAZ_Tresc
Seria	Seria (skrót nazwy kasy)	KAZ_Seria
RP	Rozchód/przychód	KAZ_RP

Rozliczenia (ROZI)

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

<ROZI/>	Opis	ERP XL
<ROZ>	Sekcja z rozliczeniami	Rozliczenia
ID	Identyfikator rozliczenia/rozrachunku	R2_ID
Info	-	-
Dok1Typ	GIDTyp dokumentu 1	R2_Dok1Typ
Dok1Numer	GIDnumer dokumentu 1 w bazie mobilnej	R2_Dok1Numer
Dok1NumerO	-	-
Dok1Lp	GIDLp dokumentu 1	R2_Dok1Lp
Seria1	-	-
Dok2Typ	GIDTyp dokumentu 2	R2_Dok2Typ
Dok2Numer	GIDnumer dokumentu 2 w bazie mobilnej	R2_Dok2Numer
Dok2NumerO	-	-
Dok2Lp	GIDLp dokumentu 2	R2_Dok2Lp
Seria2	-	-
Kwota	Kwota rozliczenia/rozrachunku	R2_KwotaWal1, R2_KwotaWal2, R2_KwotaSys

     

Informacje ogólne

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

Wersja Comarch ERP XL	Comarch POS
od wersji 2019.2.1 do wersji 2020.0	2019.0
od wersji 2020.1 do 2020.2.0	2019.5.1
2020.2.2	2019.5.4
2021.0	2021.0
od wersji 2021.01 do wersji 2021.0.2	2021.1
2021.1	2021.6
od wersji 2022.0 do wersji 2022.0.1	2022.0
2022.0.2	2022.1
2022.1	2022.5
2023.0	2023.0
2023.1	2023.0
2023.2	2023.5
2024.0	2024.0
2024.1	2024.5
2025.0	2024.5

Informacje o współpracy konkretnej wersji Comarch ERP XL z wersją POS udostępniane są w dokumencie Zmiany funkcjonalne wprowadzone w Comarch ERP XL do danej wersji. Comarch 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 POS

Comarch POS instaluje się z wykorzystaniem narzędzia Comarch ERP Auto Update. Instrukcja instalacji  Comarch POS znajduje się w dokumentacji na stronie https://pomoc.comarch.pl/pos/ 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 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.

Uwaga

Z jednej bazy lokalnej może korzystać tylko jedno stanowisko POS.

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

W razie potrzeby utworzenia nowej bazy POS, backup pustej bazy POS można znaleźć w katalogu Autoupdate np. https://pomoc.comarch.pl/autoupdate/ 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. Od wersji Comarch ERP XL 2021.0 oraz Comarch POS 2021.0 do współpracy między systemami konieczne będzie wykorzystywanie nowych komponentów: Comarch POS Agent oraz Comarch  POS Agent Broker. Komponenty te należy zainstalować za pomocą Comarch ERP AutoUpdate wraz z instalacją Comarch  POS. Instalacja komponentów POS Agent oraz POS Agent Broker została opisana w instrukcji dostępnej pod adresem https://pomoc.comarch.pl/pos/documentation/comarch-retail-pos-broker/

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:

Uwaga

Aby dodać usługę synchronizacji konieczne jest uruchomienie modułu Administrator oddziałów w trybie Administratora

 

  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.

Wskazówka

Od wersji Comarch ERP XL 2020.2 po wycięciu sesji usługi synchronizacji Comarch POS, co 30 sekund będzie sprawdzała czy bieżąca sesja jest aktywna, jeśli nie jest to nastąpi wylogowanie i ponowne zalogowanie wraz z utworzeniem nowej sesji.

Usługa Comarch POS Agent

Usługa Comarch POS Agent (POS Agent) dostarcza aktualne informacje o stanach magazynowych na każdym stanowisku, podczas wystawiania dokumentów. Informacje te prezentowane są z uwzględnieniem poszczególnych magazynów. Wszystkie procesy w magazynie będą mogły zachodzić w trybie off-line z centralą, dzięki czemu korzystanie z tej usługi zapewni pełną autonomię sklepu, poprzez zagwarantowanie, że stan towaru będzie zawsze aktualny. Każdy oddział Comarch POS zdefiniowany w Systemie XL musi podsiadać własną usługę POS Agent.

Usługa POS Agent to miejsce, w którym przechowywane są stany magazynowe towaru wraz z rezerwacjami zasobowymi w podziale na magazyny. Usługa POS Agent działa jako samodzielna usługa z własną bazą danych na tym samym komputerze co baza Comarch POS lub osobnym. Aktualizuje stany towarów na podstawie dokumentów wystawianych na wszystkich stanowiskach obsługiwanych przez daną usługę.

Rejestracja usługi POS Agent

Po poprawnym skonfigurowaniu POS Agent oraz POS Agent Broker należy zrestartować usługę XLDataService (Menadżer zadań/Usługi). W następnej kolejności należy zarejestrować usługę POS Agent. W tym celu należy otworzyć katalog instalacyjny POS Agent i uruchomić aplikację POSAgentConfigurator.exe. Przy pierwszym uruchomieniu pojawi się błąd informujący o tym, że usługa jest odinstalowana:

Po naciśnięciu przycisku OK otworzy się okno konfiguratora:

W konfiguratorze należy podać: Usługę instaluje się za pomocą przycisku Instaluj. Poprawność wcześniej wprowadzonych danych można zweryfikować za pomocą przycisku Sprawdź. Natomiast przycisk Rejestruj służy do rejestracji usługi POS Agent. W celu weryfikacji tego, czy proces zakończył się poprawnie, należy przejść na zakładkę [POS Agent] na oddziale w Comarch ERP XL i sprawdzić, czy zaktualizowane zostały wpisy w polach: Host, Port i GUID.

Comarch POS Agent Broker

Komponent Comarch POS Agent Broker (POS Agent Broker) wykorzystywany jest do komunikacji z usługą Comarch POS Agent (POS Agent) jako broker wiadomości. Pozwala na aktualizowanie stanów towaru oraz rezerwacji po wystawieniu w Systemie XL dokumentu wpływającego na stany towaru/rezerwacje w magazynach oddziału POS. W przypadku pracy online (połączenie z centralą) stany towaru na oddziałach POS aktualizowane są natychmiast. W przypadku pracy offline (brak połączenia z centralą) komponent agreguje kolejkę wiadomości, przekazując aktualizację stanów magazynowych do właściwego POS Agenta. Aktualizowanie informacji o stanach następuje bezpośrednio po wystawieniu dokumentów w Comarch ERP XL poprzez:

Uwaga

Aktualizacja stanów realizowana jest w oparciu o stany handlowe dostępne.

Konfigurowanie komponentu POS Agent Broker

W Konfiguracji systemu została dodana zakładka [POS], na której należy uzupełnić adres brokera wiadomości, czyli usługi POS Agent Broker.

W polu Adres usługi kolejki wiadomości należy wprowadzić adres usługi Comarch POS Agent Broker oraz numer portu. Domyślnym portem jest 80, pole przyjmuje 64 znaki W celu sprawdzenia pod jakim adresem została udostępniona usługa Comarch POS Agent Broker należy: Więcej informacji znajduje się w dokumentacji Comarch POS: https://pomoc.comarch.pl/retail/documentation/comarch-retail-pos-broker/

Uwaga

  http://localhost/POSAgentBroker jest to domyślny adres w przypadku głównego profilu programu Comarch ERP Auto Update. 

Konfiguracja Oddziału/Stanowiska POS

Kreator nowego Oddziału POS

Konfiguracja oddziału/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 Comarch 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 można ustawić na stanowisku aby raport kasowy otwierany był 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 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. Na przesłanym zapisie kasowym w opisie dodana została informacja odnośnie formy płatności.

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. Tak samo odnośnie grupy towarów.

Należy także dodać odpowiednie uprawnienia Operatorowi co szczegółowo opisane jest w Parametry operatorów (moduł Administrator). Aby dodać nowy oddział typu Comarch POS należy: Kreacja nowego oddziału Comarch POS:

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.

Uwaga

Aby kontrahenci zostali przesłani do Comarch POS oprócz wskazania odpowiedniej grupy powinni mieć ustawioną cenę oraz formę płatności która jest wysłana do POS, w przeciwnym wypadku kontrahent nie zostanie przesłany do 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.

Ustawienia oddziału Comarch POS

Zakładka [Ogólne] prezentuje Centrum powiązane z danym oddziałem, nadane ID oddziału oraz datę Ostatniej synchronizacji

Zakładka [Towary] prezentuje grupy wysyłanych towarów oraz cenę domyślną. Dodano dwie tabele, w których można zdefiniować grupy szybkiej sprzedaży, czyli grupy, które pojawią się bezpośrednio na interfejsie POS a po kliknięciu w nie wyświetlane będą towary z tej grupy oraz towary ulubione, czyli te najczęściej wybierane do sprzedaży.

Grupy szybkiej sprzedaży- Po lewej stronie znajduje się lista Grupy szybkiej sprzedaży, gdzie można dodawać grupy z listy grup wysyłanych do POS. Po wybraniu opcji Dodaj grupę zostanie wyświetlona lista grup, zawężona do grup wysyłanych do POS, czyli ta część drzewa, która jest wskazana w polu Wysyłaj towary z grupy.

Do listy tej należy dodać wszystkie grupy, które mają być prezentowane w POS jako grupy do szybkiego dostępu towarów. Towary, które mają przypisaną daną grupę jako grupę domyślna na zakładce [Grupy] będą prezentowane w POS po kliknięciu w określony kafelek prezentujący określoną grupę towarową. W konfiguracji grup do POS możliwe jest ustawienie kolejności wyświetlania grup w POS za pomocą przycisków: Przesuń o jedną pozycję w górę lub w dół  . Dodane grupy można usuwać pojedynczo lub zbiorczo zaznaczając odpowiednie pozycje. W każdym momencie można tez wzbogacić listę o nowe pozycje. Ustawiona kolejność przycisków grup przesyłana jest na wszystkie stanowiska POS przypisane do oddziału. Aby prezentacja grup w POS była wygodna i czytelna dla operatora, możliwe jest również wysłanie grafiki (obrazu), która będzie prezentowana na odpowiednim kafelku w POS. W tym celu należy na karcie grupy, na zakładce [Załączniki] dodać załącznik o typie obraz i zaznaczyć na nim parametr POS.

Ulubione towary- Po prawej stronie znajduje się lista towarów ulubionych, które w POS będą widoczne po wybraniu specjalnego kafelka o nazwie Ulubione. Do listy ulubionych można dodawać dowolne towary lub produkty, które są wysyłane do POS. Podczas dodawania towaru do listy, system sprawdza czy towar zawiera się w drzewie grup przesyłanym do POS, zgodnie z ustawieniem w polu Wysyłaj towary z grupy. Sprawdzane jest powiązanie towaru z grupą domyślną i jeśli grupa domyślna towaru nie jest wysyłana do POS, wówczas towar nie będzie mógł trafić na listę ulubionych.

Po naciśnięciu opcji Dodaj towar zostanie wyświetlona lista wszystkich towarów, gdzie można wskazać jeden lub więcej towarów i dodać je do listy. Na liście towarów ulubionych możliwe jest ustawianie kolejności wyświetlania towarów w POS za pomocą przycisków: Przesuń o jedną pozycję w dół lub w górę . Dodane towary można usuwać pojedynczo lub zbiorczo zaznaczając pozycje. W każdym momencie można też wzbogacić listę o nowe pozycje. Ustawiona kolejność towarów przesyłana jest na wszystkie stanowiska POS.

Uwaga

Po dodaniu jakiejkolwiek Grupy szybkiej sprzedaży lub Ulubionego towaru nie będzie możliwości zmiany drzewa towarów wysyłanych do POS, czyli parametr Wysyłaj towary z grupy będzie nieaktywny do zmiany. Aby zmienić zakres wysyłanych towarów do POS należy najpierw usunąć pozycje z obu list

Przesyłanie powiązania towaru z wszystkimi grupami towarów

Do tej pory towary były przesyłane na stanowiska POS wg grupy domyślnej ustawionej na karcie towaru. Aktualnie towary przesyłane są również wówczas, gdy należą do grupy lub podgrupy przesyłanej do POS bez względu na to, czy jest to grupa domyślna czy dodatkowa danego towaru. Przesyłane są również wszystkie powiązania towaru z grupami, które są przesyłane do POS. Na podglądzie towaru w POS można zobaczyć powiązanie towaru z grupami.

Dzięki przesyłaniu powiązania z wszystkimi grupami, mogą być wykorzystywane promocje na grupy inne niż domyślna. Dla towaru zostanie naliczona każda promocja na grupę, do której należy towar (o ile grupa ta jest przesyłana do POS). Na zakładce [Kontrahenci] znajduje się tylko konfiguracja związana z importem i eksportem kontrahentów.

W sekcji Kontrahenci ustawione są grupy kontrahentów, czyli wysyłanych do POS oraz importowanych z POS. W obszarze ,,Limit kredytowy'' znajdują się parametry służące do obsługi limitów kredytowych. Funkcjonalność ta jest szczegółowo opisana w rozdziale: Obsługa limitów kredytowych.

Przesyłanie maski dla kodu pocztowego

Przesyłana jest odpowiednia konfiguracja, dzięki której w POS kontrola poprawności zapisu kodu pocztowego na adresie kontrahenta odnosi się tylko do kontrahentów polskich. W przypadku wyboru kraju innego niż PL brak walidacji kodu pocztowego w formacie 00-000. 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. Od wersji Comarch ERP XL 2024.1 umożliwiono pobieranie i ustawianie kursów walut z precyzją do 10 miejsc po przecinku. Przy ustawieniu opcji Kurs z tabeli kursów, kursy pobierane są z precyzją zapisaną w tabeli kursów. Minimalnie prezentowane są 4 miejsca po przecinku, w przypadku większej precyzji, prezentowane są wszystkie cyfry znaczące. Przy ręcznym uzupełnianiu kursu możliwe jest wpisanie do 5 miejsc przed przecinkiem i do 10 miejsc po przecinku.

Aktualnie walutą domyślną jest PLN- bez możliwości zmiany. Zakładka [MMW/MMP] prezentuje ustawienia dotyczące przesunięć międzymagazynowych

Automatyczne generowanie PW/RW przy niezgodnościach podczas przyjęcia dostawy - na podstawie dokumentu PRP generowane są dokumenty PW/RW wynikające z innych ilości zrealizowanych na MMP. Maksymalna ilość towarów dla ręcznie tworzonego MM- (MMW)- maksymalna ilość pozycji na dokumencie wystawianym w Comarch POS,  zostanie wyświetlony odpowiedni komunikat dotyczący blokady dodania większej ilości elementów niż wskazana w tym parametrze. Przy konfiguracji oddziału na zakładce [Parametry] został dodany parametr: Sposób wyszukiwania dokumentów: Lokalnie/Globalnie. Wyszukiwanie globalne polega na możliwości przeszukania dokumentów w bazie Comarch ERP XL i pobranie na stanowisko POS. W przypadku, gdy po wpisaniu numeru poszukiwanego dokumentu (faktury lub paragonu) na liście dokumentów na stanowisku POS nie zostanie on odnaleziony w bazie lokalnej POS, System zadaje pytanie: Czy chcesz kontynuować wyszukiwanie również w systemie ERP?. Po wybraniu opcji Szukaj wysyłane jest zapytanie o konkretny numer dokumentu do Comarch ERP XL. W przypadku gdy dokument zostanie odnaleziony następuje jego pobranie i zapisanie w lokalnej bazie POS. Logowanie - podpowiadanie nazwy użytkownika - zaznaczenie parametru spowoduje, że podczas logowania do aplikacji Comarch 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. Logowanie za pomocą karty - W celu uaktywnienia opcji logowania za pomocą karty, w konfiguracji stanowiska POS na formularzu Oddziału Comarch POS został dodany parametr Logowanie za pomocą karty. Parametr domyślnie nie jest zaznaczony.

Aby logowanie za pomocą karty było możliwe, konieczne jest powiązanie operatora z pracownikiem oraz ustalenie numeru karty do logowania w Comarch POS. Na karcie operatora na zakładce [Ogólne] należy przypisać pracownika. System kontroluje przypisanie pracownika do operatora pracującego w POS i nie pozwala na dodanie tego samego pracownika do wielu kart operatorów. Należy pamiętać, że po przypisaniu pracownika do operatora, do Comarch POS będą wysyłane dane osobowe pracownika a nie operatora, dlatego na karcie pracownika należy uzupełnić imię i nazwisko.

Dane karty do logowania należy zdefiniować na karcie pracownika na zakładce [RCP]. Należy dodać nową kartę RCP lub skorzystać z istniejącej. Na formularzu karty należy wypełnić jej numer oraz zaznaczyć parametr Karta do logowania w Comarch POS.

Tylko jedna karta może mieć zaznaczony parametr opisany powyżej. W przypadku karty do logowania w POS ignorowane są ustawienia dotyczące okresu obowiązywania karty. Po ustawieniu powyższych danych parametr w konfiguracji oddziału dotyczący logowania oraz informacje o numerach kart pracowników przesyłane są do wszystkich stanowisk POS i operatorzy mogą logować się z wykorzystaniem czytnika kart. Obsługa inwentaryzacji - parametr odpowiedzialny za wykonanie operacji związanych z inwentaryzacją w oddziałach. Ostrzegaj podczas dodawania inwentaryzowanego towaru na dokument. Po jego zaznaczeniu, podczas wystawiania dokumentów w POS na towary znajdujące się na arkuszach inwentaryzacyjnych pojawi się stosowny komunikat informujący o trwającej inwentaryzacji. Komunikat będzie się pojawiał do czasu zatwierdzenia arkusza, na którym znajduje się towar. Należy pamiętać, że zamknięcie arkusza w Comarch POS spowoduje aktualizację stanów w POS i przesłanie arkuszy do Comarch ERP XL, natomiast po stronie systemu XL inwentaryzacja do czasu jej zamknięcia nadal będzie blokować sprzedaż i wystawianie innych dokumentów.

Blokada wystawiania faktur bez numeru NIP.  Po jego zaznaczeniu nie będzie możliwe wystawienie faktury dla podmiotu gospodarczego bez uzupełnienia numeru NIP.  Równocześnie w przypadku wystawiania faktury dla kontrahenta detalicznego pojawi się komunikat o konieczności rejestracji paragonu a następnie wystawienia faktury do paragonu. Jeśli jednak numer NIP zostanie przesłany dla kontrahenta detalicznego z XLa, możliwe będzie wystawienie faktury bezpośrednio (bez konieczności rejestrowania paragonu).

Uwaga

Funkcjonalność ta będzie dostępna od wersji 2025.0 Comarch POS.

Ignoruj termin płatności ustawiony na dokumencie ZS .Parametr dotyczący ustawiania terminu płatności na dokumentach FS lub PA wystawianych do ZS. Domyślnie jest odznaczony. Jeśli parametr zostanie zaznaczony wówczas podczas generowania faktury lub paragonu do zamówienia, termin z zamówienia zostanie zignorowany i ustawiony na podstawie ustawień karty kontrahenta. Warunkiem do ustalenia terminu na dokumencie handlowym wg powyższego jest ustawienie w konfiguracji stanowiska oddziału POS przynajmniej jednej płatności odroczonej czyli takiej, dla której nie są generowane automatyczne rozliczenia KP/KW.W Systemie Comarch POS na formularzu faktury prezentowana jest informacja o ustawionym terminie płatności. Informacja o terminie płatności przekazywana jest do Comarch ERP XL i odpowiednio zapisana na zakładce [Płatności] dokumentu handlowego. Rodzaj noty dla importowanych not debetowych- należy wybrać rodzaj noty, zgodnie z którym będzie dodawana nota po jej zaimportowaniu z POS do XL Na zakładce [Stanowiska POS] należy dodać oddzielne stanowiska dla każdego punktu sprzedaży detalicznej pracującej z wykorzystaniem Comarch 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.

Uwaga

Do ustawienia danych Operatora na zakładce Synchronizacja konieczne jest uruchomienie modułu Administrator Oddziałów w trybie Administratora. Dla każdego oddziału należy wybrać innego operatora odpowiadającego za synchronizację.

Na zakładce [POS Agent] dla każdego istniejącego oddziału Comarch POS należy zdefiniować Agenta, definiuje się również magazyny przypisane do danego oddziału Comarch POS, więcej na temat opisano w rozdziale Zmiany w konfiguracji oddziałów Comarch 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 stanowisku można przypisać tylko jeden rejestr kasowy oddziałowy, ten rejestr można przypisać do kilku form płatności. Natomiast można przypisać kilka rejestrów bankowych.

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ń.

Wybór typu aplikacji i rodzaju licencji

Na oknie konfiguracji stanowiska POS oddano dwa nowe pola związane z konfigurowaniem typu aplikacji i rodzaju licencji. W zależności od tego na jakiego typu aplikacji pracuje stanowisko istnieje możliwość wybrania rodzaju licencji pomiędzy: Po pierwszej synchronizacji stanowiska z Comarch POS następuje blokada zmiany typu aplikacji. W kontrolce Licencja użytkownik ma możliwość wyboru pomiędzy opcjami: Da nowo dodawanych stanowisk oraz stanowisk oddziałów już istniejących standardowe ustawienie to: Na zakładce [Parametry] należy ustawić parametry związane z tym konkretnym stanowiskiem POS.

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. Wprowadzono kilka udogodnień pozwalających w szybszy sposób przypisywać operatorów do POS. Aktualnie nie jest konieczne wcześniejsze dodanie operatora do centrum firmy. Na oknie stanowiska na zakładce [Operatorzy] można wybrać opcję z menu rozwijanego przy przycisku: Dodaj operatora z listy wszystkich operatorów. Po wybraniu tej opcji zostanie wyświetlona lista wszystkich operatorów bez względu na to czy zostali przypisani do powiązanego centrum firmy. Po zaznaczeniu wybranych operatorów zostaną oni dodani do Stanowiska POS i równocześnie do centrum firmy, o ile do tej pory nie byli dodani.

Podczas odpinania operatorów ze stanowiska POS, nie są oni usuwania z centrum firmy. Na karcie Operatora, na zakładce [POS] dodano podzakładkę [Stanowiska POS]. Na zakładce tej prezentowane są wszystkie stanowiska, na których może pracować operator bez względu na to, do którego Sklepu (oddziału POS) należą. Na liście prezentowane są kod i nazwa stanowiska oraz nazwa Centrum powiązanego z oddziałem POS. Z poziomu tego okna możliwe jest równoczesne przypisywanie operatora do wybranych stanowisk. Po wybraniu opcji Przypnij operatora do stanowisk POS, zostanie wyświetlona lista w formie drzewa, gdzie stanowiska POS pogrupowane są wg oddziałów. Możliwe jest zaznaczenie dowolnych stanowisk i przypisanie ich do operatora. Ctrl+A spowoduje zaznaczenie wszystkich stanowisk. Zaznaczenie linii na poziomie oddziału spowoduje zaznaczenie wszystkich stanowisk danego oddziału

Jeśli dany operator nie był jeszcze przypisany do centrum firmy, którego stanowiska są przypinane, automatycznie zostanie dodany do centrum. Jeśli będzie to jedyne centrum operatora, zostanie przypisane jako centrum domyślne. Jeśli dodawane stanowisko będzie przypisane do innego centrum, wówczas pojawi się komunikat z pytaniem czy przypisać operatora do danego centrum. Jeśli odpowiedź będzie twierdząca wówczas stanowisko POS zostanie przypięte do operatora jak również zostanie przypisane odpowiednie centrum. Po odpowiedzi NIE, stanowisko ani centrum nie zostaną przypisane do operatora. Na oknie komunikatu dodano dodatkowy parametr pozwalający na wyłączenie pytania przy dodawaniu kolejnych stanowisk. Pytanie pojawi się ponownie po kolejnym zalogowaniu do sytemu, przy wystąpieniu analogicznej sytuacji. Jeśli operator jest już powiązany z danym stanowiskiem POS, podczas dodawania stanowisk zostanie ono pominięte bez dodatkowego komunikatu. W oknie Wybór stanowisk POS wyświetlanym podczas przypisywania stanowisk POS do karty operatora, dodano pole filtra. Po wpisaniu fragmentu kodu stanowiska lista jest zawężana do pozycji spełniających warunek filtra, następnie korzystając z klawiszy <Ctrl+A> można szybko zaznaczyć stanowiska i przypisać je do karty operatora. Po dodaniu stanowisk, filtr jest czyszczony i można przystąpić do wyszukiwania kolejnych stanowisk. Z poziomu okna operatora możliwe jest też odpinanie stanowisk od operatora. Możliwe jest wskazanie wielu stanowisk i seryjne ich odpięcie. Po tej operacji operatorzy nie są usuwani z centrum firmy, do którego byli przypisani, dzięki temu można łatwej ich dodać do innego centrum (oddziału Comarch POS). Na liście Operatorów dodano przycisk Przypnij operatorów do stanowisk POS, dzięki któremu możliwe jest równoczesne przypisywanie wielu operatorów do wielu stanowisk POS. Po zaznaczeniu wybranych operatorów, należy wybrać opcje jw., a następnie wskazać stanowiska wg zasad opisanych wcześniej. Zasady wiązania operatorów ze stanowiskami POS są analogiczne jak w przypadku wykonywania tego z karty operatora, tyle, że dotyczą wielu operatorów. Na zakładce [Wydruki] znajdują się wszystkie wydruki wykorzystywane w Comarch 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.

Uwaga

Stanowisko POS, dodane na oddziale musi mieć ustawione:

• kod, nazwę i serię oddziałową
• Nazwy, rejestry i parametry dla poszczególnych form płatności (udostępnionych w Centrum POS)
• Parametry związane z operacjami kasowymi
• Ustawieni drukarki fiskalnej i szuflady
• Operatorów, którzy będą mogli logować się do POSa. Pierwsze logowanie z hasłem: admin, następnie klient może zmienić hasło z poziomu POSa
• Listę dostępnych wydruków

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_WersjaERPXL przygotowany dla instalacji Comarch 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 w zależności od wersji XL_POS_WersjaERPXL. Jeśli poprzednio był wykorzystywany profil XL_POS_WersjaERPXL należy usnąć go z listy, a następnie dodać nowy profil. Pozostawienie dwóch profili będzie wiązało się z koniecznością wyboru profilu podczas logowania do Comarch POS. Po wybraniu profilu z listy dostępnych jako Typ należy wybrać Profile POS. W przypadku używania własnych profili nie ma konieczności zmiany profilu na najnowszy, warto jednak zadbać o odkrycie w menu głównym POS kafla Back office, w celu udostępnienia opcji uzgadniania stanów towaru. Dla nowych instalacji Comarch POS aktualny profil podpowiada się domyślnie.

Wskazówka

Zakazy dotyczące dokumentów ustawia się na Wzorcu operatora

Maksymalny rabat na dokumentach sprzedaży

Wystawiając dokument w Comarch POS weryfikowane jest ustawienie z karty operatora logującego się do Comarch POS dotyczące maksymalnego rabatu na dokumentach.

Uwaga

Aby wartość dokumentów, naliczonych rabatów była zgodna, operator wskazany na synchronizacji oddziału powinien mieć zaznaczony parametr Bez ograniczeń dla Maksymalnego rabatu na dokumentach sprzedaży.

Zmiany w konfiguracji oddziałów Comarch POS

Wprowadzenie na Oddziale zakładki POS Agent

Dla każdego istniejącego oddziału Comarch POS należy zdefiniować Agenta. Aby to zrobić należy przejść do konfiguracji oddziału Comarch POS, następnie na zakładce [POS Agent] uzupełnić pole kod POS Agenta. Kod POS Agenta powinien być ciągiem znaków (litery i/lub cyfry) bez spacji. Dla każdego oddziału należy ustalić inny kod POS Agenta. W przypadku nowych oddziałów system pilnuje, aby kod został uzupełniony przed zapisaniem oddziału. Pola Host, Port oraz GUID zostaną uzupełnione automatycznie po zarejestrowaniu usługi POS Agent.

Przycisk Resetuj ustawienia POS Agenta służy do usunięcia ustawień POS Agenta w sytuacji, gdy koniczna jest jego ponowna rejestracja.

Na zakładce [POS Agent] definiuje się również magazyny przypisane do danego oddziału Comarch POS.

W przypadku nowych oddziałów na zakładce [POS Agent] pojawi się magazyn wskazany podczas kreacji oddziału. Jeśli w sklepie jest więcej niż jeden magazyn należy go przypisać do POS Agenta (wcześniej musi zostać dodany do Centrum powiązanego z oddziałem Comarch POS). W związku z powyższym przywrócono możliwość dodawania wielu magazynów do Centrum powiązanego z oddziałem Comarch POS. Magazyn przypisany do jednego POS Agenta nie może zostać przypisany do innego POS Agenta.

W przypadku gdy oddział był kreowany w poprzednich wersjach, podczas konwersji magazyn domyślny zostanie przypisany do POS Agenta. Jeśli ten sam magazyn był przypisany do wielu oddziałów Comarch POS, wówczas zostanie on usunięty z konfiguracji wszystkich oddziałów i konieczne będzie przypisanie magazynów domyślnych dla każdego oddziału na nowo.

Uwaga

Każdy oddział Comarch POS musi posiadać własny magazyn lub magazyny. Magazyn przypisany do jednego POS Agenta nie może zostać przypisany do innego POS Agenta.

Uzgadnianie stanów magazynowych w Comarch POS

Przy poprawnie zainstalowanej i działającej usłudze stany towaru są na bieżąco aktualizowane. Ponieważ stany towaru nie są już zapisywane w bazie Comarch POS, lecz w bazie POS Agent, użytkownicy, którzy posiadali oddziały Comarch POS w poprzednich wersjach Systemu muszą dokonać operacji uzgodnienia stanów. Prawo do uzgadniania stanów magazynowych zostało dodane na wzorcu operatorów na zakładce [POS]. Tylko operatorzy z zaznaczonym prawem Prawo do uzgadniania stanów magazynowych mogą aktualizować stany z poziomu Comarch POS. Operacji uzgodnienia stanów dokonuje się z poziomu aplikacji Comarch POS. Z menu głównego należy wybrać opcję Back office, a następnie przycisk Uzgadnianie stanów magazynowych.

Uzgodnienie stanów będzie również konieczne w przypadku podpięcia w konfiguracji oddziału na zakładce [POS Agent] magazynu, na którym są niezerowe stany towaru. Przycisk Uzgadniania stanów magazynowych można wykorzystać również w sytuacji, gdy z jakiegokolwiek powodu stany towaru w POS nie zgadzają się z tymi w Systemie XL. Po wykonaniu operacji stany towarów w POS będą zgodne ze stanami handlowymi dostępnymi w Systemie XL. Stany towaru w POS przechowywane są aktualnie w podziale na magazyny. Prezentowana jest również informacja o ilości rezerwacji zasobowych. Rezerwacje te wpływają na stan towaru w POS.

Sprzedaż z wielu magazynów

Comarch POS umożliwia sprzedaż towaru z kliku magazynów. Gdy na domyślnym magazynie braknie towaru, wówczas pobierany jest on z kolejnych magazynów. Możliwe jest również wskazanie konkretnego magazynu na poziomie pozycji dokumentu (wymaga zmian w konfiguracji interfejsu w POS). Informacje o tym z jakiego magazynu został pobrany towar przesyłane są na poziomie subelementów pozycji dokumentu. Informacja o magazynie/magazynach poszczególnych pozycji dokumentu jest uwzględnia podczas importu i odpowiednio zapisywana na dokumentach. W przypadku braków towaru, automatyczne PW dodaje towar do właściwego magazynu.

Podgląd stanów magazynowych w innych sklepach

W ERP XL obsłużono funkcję podglądu towaru w innych sklepach. W Comarch POS na liście towarów oraz na podglądzie towaru znajduje się przycisk Dostępność w sklepach. Standardowo przycisk ten jest ukryty, dlatego najpierw należy go odkryć z poziomu konfiguracji interfejsu w POS. Po wybraniu przycisku Dostępność w sklepach zostanie otwarte okno, w którym prezentowany jest stan danego towaru w magazynach innych sklepów Comarch POS w ramach danej instalacji. Stany towarów sprawdzane są on-line, dlatego do uruchomienia tej opcji potrzebne jest aktywne połączenie z Comarch ERP XL czyli działająca usługa XLDataService.

Konfigurowanie i przesyłanie domyślnego kontrahenta

Umożliwiono przesyłanie domyślnego kontrahenta innego niż Jednorazowy. Aby na dokumentach w POS domyślnie podpowiadał się inny kontrahent niż Jednorazowy należy na definicji dokumentu PA (w kontekście centrum powiązanego z danym oddziałem POS), na zakładce [Inne] wybrać odpowiedniego kontrahenta, który należy do grupy wysyłanej do Comarch POS. Aby przywrócić kontrahenta Jednorazowego wystarczy usunąć wskazanego wcześniej kontrahenta z definicji dokumentu PA.

Uwaga

Wskazany na definicji PA kontrahent będzie ustawiany jako domyślny zarówno dla paragonów, jak i faktur.

Obsługa podzielonej płatności – MPP

Obsługa podzielonej płatności została obsłużona w następującym zakresie:  

Import wartości atrybutów na dokument

Do POS przekazywane są klasy atrybutów związane z definicją dokumentów, jak również elementów dokumentów. Wartość dla danego atrybutu może być uzupełniona w trakcie wystawiania dokumentu w POS. Podczas importu dokumentów wartości atrybutów dokumentu i elementów dokumentu są odczytywane i odpowiednio zapisywane na transakcjach.

Przesyłanie kodów kreskowych związanych z jednostkami pomocniczymi

Jeśli dla towaru zostaną zdefiniowane dodatkowe jednostki miary i do tych jednostek zostaną przypisane kody kreskowe, to zostaną one przesłany do POS. Przesyłane kody to kody własne, które widoczne są na zakładce [Jednostki i kody]/[Kody kreskowe]. Dzięki temu możliwe będzie wyszukiwanie towarów na liście towarów oraz dodawanie do dokumentu z wykorzystaniem dodatkowego kodu EAN. Na pozycji dokumentu automatycznie ustawi się jednostka miary powiązana z danym kodem kreskowym.

Uwaga

Zdefiniowane kody kreskowe są przesyłane dla jednostek dodatkowych

Od wersji 2020.2.1 została udostępniona funkcjonalność obsługi kodów wagowych analogiczna jak w Comarch ERP XL.

Blokada zatwierdzania RA do PA z niezgodnym NIP

Został również obsłużony parametr Blokada zatw. RA do PA z niezgodnym NIP, ustawienie znajduje się na definicji dokumentu faktury sprzedaży w kontekście centrum powiązanego z oddziałem Comarch POS.

Przesyłanie informacji o domyślnej jednostce dla sprzedaży

Do POS przesyłamy ustawienia z karty towaru decydujące o tym, która jednostka ma być jednostka domyślną na transakcjach. Jeśli na karcie towaru, na zakładce [Jednostki i kody]/[Opakowanie], dla wybranej jednostki pomocniczej zostanie ustawiony parametr Ustaw jako jednostkę proponowaną: sprzedaży, jednostka ta zostanie przesłana do POS jako jednostka domyślna.

Jeśli na żadnej z jednostek pomocniczych nie zostanie ustawiony powyższy parametr, wówczas jednostką domyślną będzie jednostka podstawowa. Domyślna jednostka działa w POS nieco inaczej niż w Systemie XL. Jeśli towar ma przypisaną jednostkę domyślną inną niż podstawowa, wówczas jednostka domyślna zostanie podstawiona na elemencie dokumentu, o ile towar zostanie dodany z listy towarów, bądź wyszukany po kodzie zwykłym. W przypadku, gdy towar ma przypisany kod kreskowy podstawowy (powiązany z jednostką podstawową), podczas dodawania towaru za pomocą tego kodu kreskowego, zostanie podstawiona jednostka podstawowa, a nie domyślna. W przypadku gdy dla towaru zdefiniowano więcej jednostek pomocniczych i mają one przypisane własne kody kreskowe, podczas dodawania towarów do dokumentu za pomocą tych kodów, podstawiona zostanie jednostka powiązana z wybranym kodem, a nie domyślna.

Podgląd historii kontrahenta

W POS możliwe jest wyświetlanie historii transakcji dokonywanych z danym kontrahentem. Informacje te pobierane są z systemu Comarch ERP XL, aby mogły pojawić się wszystkie transakcje wystawione również na innych stanowiskach POS. Do uruchomienia podglądu Historii konieczna jest praca on-line, czyli musi być uruchomiona usługa XLDataService. Historia kontrahenta dostępna jest z poziomu podglądu karty kontrahenta po przyciskiem Historia Transakcji. Historia prezentowana jest wg artykułów z podaniem daty i numeru transakcji, ilości sprzedanych bądź zwróconych towarów, ceny, wartości udzielonego rabatu. Dla transakcji wystawionych na danym stanowisku możliwe jest wykonanie korekty przez wybranie opcji Korekta na wybranej pozycji historii.

Przyjmowanie towaru w POS za pomocą dokumentów przesunięć międzymagazynowych MMW/MMP

Podczas kreowania nowego oddziału Comarch POS możliwe jest wskazanie czy na stanowisku mają być wystawiane dokumenty MMW i MMP. W przypadku użytkowników, którzy posiadają już skonfigurowane oddziały Comarch POS (poprzednio Comarch POS), koniecznym jest zaznaczenie na definicji dokumentów MMW oraz MMP w centrum firmy, z którym jest powiązany oddział Comarch POS, parametru Wystawianie i edycja.

Wystawianie MMW w celu przesunięcia towarów do POS

Aby przesunąć towar z magazynu Centrali na magazyn POS należy wystawić po stronie Comarch ERP XL dokument MMW, gdzie magazynem docelowym będzie magazyn oddziału Comarch POS. Do MMW nie może być wygenerowany dokument MMP – przyjęcia towaru na magazyn POS. Aby ułatwić kontrolowanie generowania MMP, na formatce magazynu dodano parametr Generowanie MMP po stronie Comarch POS. Po zaznaczeniu tego parametru, dokument MMP nie będzie tworzony automatycznie a podczas próby jego wygenerowania pojawi się stosowny komunikat. Parametr można zaznaczyć tylko na magazynach przypisanych do POS Agenta (oddziału Comarch POS).

Przyjęcie towaru po stronie stanowiska POS

Wystawiony dokument przesunięcia magazynowego (MMW) trafia na stanowisko POS, gdzie może zostać przyjęty. Opcja przyjęcia towaru znajduje się w menu Back Office, pod przyciskiem Przyjęcie dostawy. Po wejściu na listę dostaw wyświetlają się dokumenty MMW wystawione w XLu na magazyny POS, które nie zostały jeszcze przyjęte na stan. Możliwe jest podejrzenie dokumentu MMW przyciskiem Podgląd lub przyjęcie przyciskiem Przyjmij. Użytkownik może przyjąć wszystkie pozycje w ilościach jakie zostały przesłane lub może wprowadzić ilości ręcznie zgodnie ze stanem faktycznym. Możliwe jest też skanowanie przyjmowanych pozycji za pomocą czytnika. Po zatwierdzeniu przyjęcia przyciskiem Zatwierdź, generowany jest dokument MMP (przyjęcie na magazyn POS), gdzie ilości dla pozycji są zgodne z dokumentem MMW oraz dokument PRP – protokół przyjęcia (rozbieżności), gdzie zapisano ilości rzeczywiście przyjęte na stanowisku POS. Po wygenerowaniu powyższych dokumentów, trafiają one do Comarch ERP XL. Dokument MMP widoczny jest na liście dokumentów wewnętrznych, zakładka [MMP], natomiast raport rozbieżności jest dostępny z poziomu podglądu MMP lub MMW za pomocą przycisku PRP dostępnego na prawym pasku okna jak przedstawiono poniżej.

Po wybraniu przycisku PRP wyświetlany jest raport rozbieżności dla danego przesunięcia, gdzie prezentowane są wszystkie pozycje wraz z informacjami o ilości wydanej i rzeczywiście przyjętej. Dodatkowo rozbieżności (jeśli występują) prezentowane są w kolumnach Braki lub Nadwyżki. W przypadku wystąpienia niezgodności użytkownik musi sam zdecydować w jak sposób chce skorygować powstałe niezgodności. Np. w przypadku nadwyżki może wystawić nowy dokument MMW na ilość prezentowaną w kolumnie Nadwyżka.

Dla raportu został również przygotowany wydruk prezentujący zarejestrowane rozbieżności.

MMW a partie towaru

Jeśli na MMW znajdą się towary, które pochodzą z różnych partii wówczas po stronie POS na dokumencie MMW każda partia będzie widoczna jako oddzielna pozycja. Również na dokumencie PRP towary i rozbieżności dla nich będą prezentowane oddzielnie dla każdej partii.

Atrybuty, opis dokumentu

Na dokumentach MMW i MMP wystawianych w POS można uzupełnić opis oraz wartości atrybutów nagłówka i pozycji, jeśli zostały określone do tych obiektów. Informacje te są przekazywane na importowane MMW i MMP na zasadach analogicznych jak dla innych dokumentów.

Anulowanie dokumentów magazynowych

Nie jest możliwe anulowanie dokumentów MMW wystawionych w Comarch ERP XL i wysłanych do oddziału POS. Przy próbie anulowania pojawi się komunikat: Anulowanie dokumentu MMW-8/21/10 nie jest możliwe. Nie jest możliwe anulowanie dokumentów MMP wygenerowanych podczas przyjęcia towaru w POS i przesłanych do XL. Przy próbie anulowania pojawi się stosowny komunikat. Anulowanie dokumentu MMP możliwe jest z poziomu stanowiska POS. Informacja o anulowaniu przesyłana jest do Comarch ERP XL gdzie dokument jest również anulowany. Po anulowaniu dokumentu MMP możliwe jest ponowne przyjęcie towaru na stanowisku POS.

Zwrot towaru do centrali

Aby możliwy był zwrot towarów z oddziału Comarch POS do magazynu Centrali konieczne jest przypisanie magazynów do Centrum powiązanego z oddziałem Comarch POS. Tylko magazyny przypisane do Centrum mogą być magazynami docelowymi, na które może być dokonywany zwrot towaru. Zwrot towaru realizowany jest poprzez wystawienie w Comarch POS dokumentu zwrotu w postaci MMW z magazynu sklepu do magazynu Centrali. Aby wystawić dokument przesunięcia zwrotu towaru w POS należy wybrać opcję Back Office, a następnie przycisk Wydanie towarów i kolejno opcje Przygotowanie wysyłki i Przesuniecie ręczne. Podczas dodawania zwrotu konieczne jest wskazanie magazynu źródłowego, z którego ma zostać wydany towar oraz magazynu docelowego, na który ma trafić zwracany towar. POS Agent kontroluje ilość towaru ma magazynach POS i nie pozwoli na zwrot towaru, którego nie ma na stanie magazynu POS. Po zatwierdzeniu dokumentu, MMW trafia do sytemu Comarch ERP XL a następnie jest do niego generowany dokument MMP. To, czy dokument MMP zostanie wygenerowany automatycznie, czy też nie zależy od ustawień na definicji dokumentu MMW, na zakładce [Inne] j.n. Dopiero po wygenerowaniu dokumentu MMP towar trafi na magazyn, do którego został zwrócony.

Anulowanie dokumentów zwrotu

Dokumenty MMW wystawione w POS nie mogą być anulowane z poziomu Comarch ERP XL. Przy próbie anulowania pojawi się komunikat: Anulowanie dokumentu MMW-11/21/P5/10 nie jest możliwe. Możliwe jest natomiast anulowanie MMW z poziomu stanowiska POS, gdzie taki dokument został wystawiony. Po anulowaniu w POS następuje anulowanie dokumentu po stronie XL, o ile nie ma do niego wygenerowanego dokumentu MMP. W przypadku gdy taki dokument został już wygenerowany, najpierw należy anulować MMP w XL a następnie MMW w POS.

Przesunięcia towaru między magazynami sklepu

Jeśli sklep prowadzi więcej niż jeden magazyn możliwe będzie przesuwanie towaru pomiędzy jego magazynami. Każdy magazyn sklepu musi zostać przypisany do oddziału Comarch POS na zakładce [POS Agent]. Aby wystawić dokument przesunięcia magazynowego w Comarch POS należy wybrać opcję Back Office, a następnie przycisk Przesunięcia wewnętrzne. Po wybraniu magazynu źródłowego i docelowego należy wskazać towary do przesunięcia oraz ich ilości. POS Agent kontroluje ilość towaru ma magazynach POS i nie pozwoli na przesuniecie towaru, jeśli nie ma wystarczającej ilości na stanie magazynu. Po zatwierdzeniu dokumenty MMW i MMP przesyłane są do Comarch ERP XL i można je podejrzeć z poziomu listy dokumentów – dokumenty wewnętrze.

Anulowanie przesunięć międzymagazynowych

Dokumenty MMW i MMP wystawione w POS nie mogą być anulowane z poziomu Comarch ERP XL. Przy próbie anulowania pojawi się komunikat: Anulowanie dokumentu MMW-11/21/P5/10 nie jest możliwe. Możliwe jest natomiast anulowanie dokumentów przesunięć z poziomu stanowiska POS, gdzie taki dokument został wystawiony. Po anulowaniu dokumentów w POS następuje anulowanie dokumentów MMW i MMP po stronie XL.

Przesunięcia towaru pomiędzy sklepami (oddziałami) Comarch POS

Zamówienia wewnętrzne

Zmiany w kreatorze oddziału

Podczas kreowania nowego oddziału możliwe jest wskazanie jest czy na stanowisku mają być wystawiane dokumenty ZW. W przypadku użytkowników, którzy posiadają już skonfigurowane oddziały Comarch POS, koniecznym jest zaznaczenie na definicji dokumentów ZW w Centrum firmy, z którym jest powiązany oddział Comarch POS, parametru Wystawianie i edycja.

Przyjmowanie zamówień z oddziałów Comarch POS

Obsłużono scenariusz, w którym operator POS składa zmówienie w oddziale a następnie zamówienie to trafia do Centrali w Comarch ERP XL, gdzie może zostać zrealizowane. Aby wystawić dokument zamówienia wewnętrznego w Comarch POS należy wybrać opcję Back Office, a następnie przycisk Zamówienia wewnętrzne. Podczas dodania zamówienia należy wskazać magazyn źródłowy, na który trafi składane zamówienie oraz magazyn docelowy, na który mają trafić zamawiane towary. Zamówienie przesłane z Comarch POS do Comarch ERP XL może zostać po stronie XL: Po zmianie statusu zamówienia, informacja o tym przesyłana jest do POS, gdzie zamówienie zmienia swój status na zgodny z ustawionym w XL. Zamówienia przesłane z POS nie mogą być:

Realizacja zamówień w Comarch ERP XL

Realizacja zamówienia polega na wystawieniu do niego dokumentu MMW z magazynu Centrali do magazynu POS. Zamówienie nie musi być od razu realizowane w całości. Można dokonywać częściowej realizacji zamówień, wówczas zamówienie zyskuje status w realizacji. MMW wystawione do zamówień trafiają do POS wraz z informacją, do jakich ZW zostały wygenerowane. Informacja ta widoczna jest w POS zarówno z poziomu listy zamówień wewnętrznych jaki dokumentów przyjęć magazynowych w kolumnie Dokumenty powiązane. We współpracy z Comarch POS nie jest możliwe wystawianie jednego MMW do wielu dokumentów ZW, dlatego podczas zaznaczenia wielu dokumentów ZW pochodzących z POS lub dokumentów pochodzących i niepochodzących z POS w logu pojawi się stosowna informacja: Dokument MMW nie może zostać wygenerowany. Zaznaczono więcej niż jeden dokument ZW i wygenerowanie dokumentu MMW nie powiedzie się. Zamówienia, które trafiły do XL z Comarch POS mogą być edytowane po stronie XL w zakresie zmiany ilości na pozycjach, bądź usuwania pozycji. Zmiany te przesyłane są do POS gdzie zamówienia są odpowiednio aktualizowane.

Sposoby dostawy, atrybuty, opis

Do Comarch POS przesyłana jest lista sposobów dostawy, dzięki czemu operator na etapie składania zamówienia może określić jaki sposób dostawy preferuje. Na zamówieniu można też uzupełnić opis oraz wartości atrybutów nagłówka i pozycji, jeśli zostały określone do tych obiektów. Informacje te są przekazywane na importowanych zamówieniach na zasadach analogicznych jak dla innych dokumentów.

Zamówienia sprzedaży

Zmiany w kreatorze oddziału

Podczas kreowania nowego oddziału możliwe jest wskazanie jest czy na stanowisku mają być wystawiane dokumenty ZS. W przypadku użytkowników, którzy posiadają już skonfigurowane oddziały Comarch POS, koniecznym jest zaznaczenie na definicji dokumentów ZS w Centrum firmy, z którym jest powiązany oddział Comarch POS, parametru Wystawianie i edycja. Dodatkowo na zakładce [Magazyny] należy ustawić magazyn źródłowy, z którego będą wystawiane dokumenty zamówienia sprzedaży w POS.

Uwaga

W polu Magazyn źródłowy nie należy ustawiać opcji <Wszystkie> gdyż dokumenty z nieokreślonym magazynem nie będą mogły być przesłane na inne stanowiska POS.

Uprawnienia operatorów

Na wzorcu operatora zakładka [POS] dodano dwa parametry określające prawo do ustalania/zmiany statusów realizacji i płatności na dokumentach ZS, Zmiana statusów realizacji na zamówieniu oraz Zmiana statusu płatności na zamówieniu. Przesyłane są uprawnienia do edycji, dodawania, kasowania, podglądu zamówień na podstawie zakazów ustalanych na zakładce [Zakazy] karty wzorca operatora.

Słowniki dla Zamówienia sprzedaży

W słowniku kategorii dodano dwie nowe pozycje, które wykorzystywane są na zamówieniach wystawianych w POS. Słownik ten wypełniony jest wartościami predefiniowanymi, ale można go rozbudowywać o kolejne pozycje zgodnie z potrzebami użytkownika.

Zmiany na formularzu dokumentu ZS

Na formularzu dokumentu ZS dodano nową zakładkę o nazwie [Realizacja], gdzie są prezentowane statusy realizacji zamówienia i płatności. Status realizacji zamówienia może być dowolnie zmieniany, natomiast status płatności z POS jest zawsze ustalany na stanowiskach oddziału POS i nie można go zmienić po stronie XLa.

Rodzaje zamówień/ sposoby rezerwacji towaru

Zamówienia wystawiane zarówno w XLu jak i w POS mogą w różny sposób rezerwować towar. Działanie rezerwacji na zamówieniach zależy od ustawień definicji dokumentu ZS w kontekście Centrum powiązanego z oddziałem Comarch POS. Jeśli na definicji dokumentu nie zostanie zaznaczony żadne parametr dotyczący rezerwacji, wówczas nie będą tworzone żadne rezerwacje na towar dodany do zamówienia. Jeśli na definicji dokumentu zostanie zaznaczony parametr Rezerwacje blokują towar na magazynie, wówczas rezerwacje są traktowane jako ilościowe i nie pomniejszają w POS dostępnego stanu towarów. Jeśli zaznaczono parametr Rezerwuj zasoby, wówczas rezerwacje traktowane są jako zasobowe i pomniejszają ilość dostępną towaru na magazynie. Na stanowisku POS ilość zarezerwowana jest prezentowana w kolumnie Rezerwacje na podglądzie towaru lub partii towaru pod przyciskiem Zasoby.

Synchronizacja zamówień pomiędzy systemami

Import zamówień z Comarch POS

Wszystkie zamówienia wystawiane na stanowiskach oddziałów Comarch POS, trafiają do bazy systemu Comarch ERP XL. Przenoszone są informacje o odbiorcy i nabywcy, o zarezerwowanych towarach wraz z informacją czy rezerwacja jest ilościowa, zasobowa lub jest to zamówienie bez rezerwacji, ustalona forma płatności, termin realizacji zamówienia i płatności, statusy realizacji i płatności, atrybuty pozycji i nagłówka oraz opis. Zamówienie wystawione na jednym stanowisku POS może być przesłane na inne stanowiska sprzedaży. Zamówienie trafia na listę zamówień sprzedaży na innym stanowisku POS po naciśnięciu przycisku Odśwież oraz w trakcie wykonywania pełnej synchronizacji.

Eksport zamówień do Comarch POS

Zamówienia wystawione w Comarch ERP XL również mogą być wysyłane na stanowiska POS. Warunkiem przesłania zamówienia do systemu Comarch POS jest ustawienie na zamówieniu magazynu wykorzystywanego w danym oddziale Comarch POS, czyli dodanym na oknie konfiguracji oddziału na zakładce [POS Agent]. Magazyn POS musi być ustawiony zarówno na nagłówku jak i elementach, i rezerwacjach zamówienia. Do POS przesyłane są zamówienia Potwierdzone, natomiast nie są wysyłane zamówienia Niepotwierdzone oraz zamówienia Odrzucone. Zamówienia wystawione w innej walucie niż systemowa, również nie będą wysyłane do POS. Comarch ERP XL pilnuje również czy kontrahenci i towary ustawione na zamówieniu są przesyłane do POS. Jeśli nie są, wówczas całe zamówienie nie jest przesyłane.

Wskazówka

Do POS nie będą wysyłane zamówienia, gdzie dla jednej pozycji towaru zostało utworzonych wiele rezerwacji z różnymi partiami towaru. Jeśli zaistnieje potrzeba wystawiania i wysyłania takiego zamówienia do POS, to dla każdej partii towaru o różnych wartościach należy utworzyć odrębne pozycje zamówienia.

Aby zamówienie wystawione w XLu pojawiło się na danym stanowisku POS należy na liście zamówień w POS nacisnąć przycisk Odśwież. Zamówienie importowane są również podczas wykonywania pełnej synchronizacji na danym stanowisku POS.

Modyfikacja zamówień oraz ich realizacja

Zamówienia sprzedaży mogą być modyfikowane zarówno na stanowiskach POS jak i w centrali, czyli w systemie Comarch ERP XL. Modyfikacje realizowane w POS trafiają automatycznie do bazy XLa, zamówienia modyfikowane po stronie XLa są aktualizowane na stanowiskach POS naciśnięciu przycisku Odśwież na liście zamówień lub podczas pełnej synchronizacji. Podczas otwierania zamówienia w POS, zmiany statusów, zamykania, anulowania czy realizacji zamówienia następuje sprawdzenia stanu zamówienia on-line w bazie XLa. Jeśli zamówienie jest otwarte w systemie XL lub na innym stanowisku, wówczas wyświetlana jest stosowna informacja i system nie pozwala na wykonanie żadnej akcji na tym zamówieniu. Dodatkowo dzięki usłudze sprawdzania zamówień on-line, przed jego modyfikacją pobierana zawsze aktualna wersja zamówienia, tak aby wykonywana modyfikacja czy realizacja zamówienia odbywała się zawsze na aktualnej wersji dokumentu. Zamówienie może być realizowane zarówno po stronie POS jak i po stronie XLa za pomocą faktury lub paragonu. W Comarch POS faktura czy paragon mogą być wystawiane tylko do jednego zamówienia, a zamówienie nie musi być realizowane w całości, lecz wieloma dokumentami sprzedaży. Po wystawieniu faktury lub paragonu do zamówienia, dokument sprzedaży wysyłany jest do XLa a dokument zamówienia jest aktualizowany (status w realizacji lub zrealizowany). Dokumenty ZS i FS lub PA są ze sobą powiązane co widoczne jest zarówno po stronie XLa jak i POS. Informacja o stanie realizacji zamówienia jest przekazywana również na inne stanowiska pod warunkiem wykonania tam opcji Odśwież lub pełnej synchronizacji. Podczas synchronizacji realizowanego zamówienia pochodzącego z innego stanowiska nie są przesyłane powiązane dokumenty handlowe, lecz informacja o statusie zamówienia (w realizacji lub zrealizowany).

Aktualizacja stanów

Zamówienia zasobowe wpływają na stany towaru dostępnego do sprzedaży i są widoczne na liście zasobów w kolumnie Rezerwacje. Bez względu na to czy zamówienie zasobowe ZS zostało wystawione w POS czy w XLu (na magazyn POS), zamówienia od razu wpływają na stany towaru. Dzięki usłudze Comarch POS Agent, aktualna dostępna ilość towaru jest widoczna od razu na wszystkich stanowiskach bez konieczności synchronizacji tych dokumentów na inne stanowiska. Aby zamówienia wystawiane w XLu również na bieżąco aktualizowały stany towaru w POS Agencie, konieczne jest skorzystanie z usługi Comarch POS Agent Broker. Zamówienia ilościowe oraz zamówienia bez rezerwacji nie wpływają na stany dostępne w POS.

Korekty zasobów na stanowisku Comarch POS- RW/PW

Funkcja korekty zasobów umożliwia ręczną aktualizację stanów magazynowych przy pomocy rozchodu wewnętrznego (RW) i przychodu wewnętrznego (PW). Korektę zasobów przy użyciu dokumentów PW i RW dokumentów można zastosować np. w przypadkach: Aby wystawianie dokumentów PW i RW w POS było możliwe wprowadzono szereg zmian, które opisano poniżej.

Zmiany w kreatorze oddziału RW/PW

Podczas kreowania nowego oddziału możliwe jest wskazanie czy na stanowisku mogą być wystawiane dokumenty PW oraz RW. Odpowiednie typy dokumentów należy zaznaczyć w kroku 1 kreacji nowego oddziału.

W przypadku użytkowników, którzy posiadają już skonfigurowane oddziały Comarch POS, koniecznym jest zaznaczenie na definicji dokumentów PW i RW w centrum firmy, z którym jest powiązany oddział Comarch POS, parametru Wystawianie i edycja.

Informacje o możliwości wystawiania dokumentów PW i RW są przekazywane do POS wraz z:

Wystawianie dokumentów PW i RW na stanowisku POS

Aby dokonać korekty zasobów na stanowisku POS za pomocą dokumentów PW lub RW w Comarch POS należy wybrać opcję Back Office, a następnie przycisk Korekty zasobów. Po wybraniu opcji Nowa korekta zasobów należy wybrać opcję wystawienia RW lub PW. Opcja korekty zasobów dostępna jest też na podglądzie konkretnych artykułów pod przyciskiem Nowa korekta zasobów. Podczas tworzenia dokumentu PW i RW należy wskazać magazyn, dla którego będzie wykonywana korekta zasobów oraz powód wystawienia takiej korekty. Określenie magazynu oraz powodu korekty jest obowiązkowe. Korekty zasobów mogą być realizowane w kontekście magazynów danego oddziału, czyli tych magazynów, które zostały określone na zakładce [POS Agent] na formatce Oddziału Comarch POS w XL. Aby możliwe było określenie powodu korekty w Comarch ERP XL został wprowadzony nowy słownik kategorii, który jest przesyłany do oddziałów POS.

Import dokumentów do Comarch ERP XL

Dokumenty wystawione na stanowisku POS są importowane do XLa. Na dokumentach RW pobierane są dostępne zasoby i partie wskazane podczas wystawiania dokumentu w POS. Przy imporcie dokumentów PW cena nie jest przekazywana, dlatego na pozycjach dokumentów PW cena jest ustawiana na podstawie ostatniej ceny zakupu. Generowanie dokumentów magazynowych do PW, RW uzależnione jest od ustawień na definicji dokumentów. Na definicji dokumentu PW, na zakładce [Inne] należy wybrać opcję Zezwalaj dla ustawienia: Zatwierdzanie dokumentów z pozycjami o wartości zerowej. W przeciwnym wypadku, dokument może nie zostać zaimportowany, jeśli w XLu nie zapisano ceny zakupu (nie było dostaw towaru).

Dokumenty PW i RW wystawione w POS nie mogą być anulowane w Comarch ERP XL, natomiast mogą być anulowane w Comarch POS a informacja o tym jest przesyłana do XL, gdzie następuje również anulowanie dokumentu.

Przyczyna korekty, atrybuty, opis

Do Comarch POS przesyłana jest lista przyczyn korekty (wystawienia PW, RW), dzięki czemu operator może określić przyczynę podczas wystawiania dokumentów. Informacja o przyczynie korekty przesyłana jest do XL i zapisywana na zakładce [Nagłówek], w sekcji Transakcja w polu Cecha. Na zamówieniu można też uzupełnić opis oraz wartości atrybutów nagłówka i pozycji, jeśli klasy atrybutów zostały przypisane do tych obiektów. Informacje te są przekazywane na importowanych dokumentach na zasadach analogicznych jak dla innych dokumentów.

Dodawanie nowego słownika kategorii

W module Administrator w menu Listy/Słowniki kategorii w gałęzi Transakcje dodano nowy słownik Przyczyna wystawienia PW, RW w POS. Lista domyślnie nie zawiera żadnych wpisów, dlatego przed wystawieniem pierwszego dokumentu PW lub RW w POS należy dodać przynajmniej jedną pozycję do listy. Przyczyna wystawienia korekty może być przeznaczona tylko dla PW, tylko dla RW lub dla obu dokumentów. Można o tym decydować przez zaznaczenie odpowiednich opcji na formatce przyczyny.

Przyjmowanie dostaw bezpośrednio na stanowisku POS za pomocą dokumentów PZ

W określonych branżach czy sklepach istnieje potrzeba przyjmowanie towarów bezpośrednio na stanowisku POS bez konieczności oczekiwania na przyjęcie towaru w Centrali. Czasami towar trafia bezpośrednio do sklepu, dlatego umożliwiono wprowadzanie dokumentów PZ bezpośrednio na stanowiskach Comarch POS. Aby móc korzystać z opcji wystawiania dokumentów PZ, podczas dodawania nowego oddziału POS należy zaznaczyć opcję obsługi dokumentów PZ w danym oddziale.

Jeśli użytkownicy mają już zdefiniowane oddziały POS, aby umożliwić wystawianie dokumentów PZ na stanowiskach POS konieczne jest zaznaczenie opcji Wystawianie i edycja na definicji dokumentu PZ w kontekście centrum powiązanego z oddziałem POS.

Na definicji dokumentu PZ automatycznie ustawiane są następujące parametry:

Dla dokumentów PZ wysyłane są następujące dane:

Wystawianie dokumentów PZ w POS

Po zaznaczeniu parametru Wystawianie i edycja na definicji PZ w XLu, w Comarch POS w menu Back Office/Przyjęcie dostawy pojawi się przycisk Dodaj ręczny PZ.  

Podczas wystawiania dokumentów PZ w POS możliwe jest:

Bony we współpracy z POS

Opis działania bonów

Opis konfigurowania, generowania i obrotu bonami został opisany w punkcie: Obsługa bonów towarowych. Rodzaje bonów, które mogą być obsługiwane w Comarch POS muszą zostać przypisane do Centrum powiązanego z oddziałem Comarch POS na zakładce [Rodzaje bonów]. Tylko bony z przypisanych rodzajów zostaną przesłane do oddziału Comarch POS. Do POS będą przesyłane bony, które mogą być sprzedane (stan: przyjęte na stan) lub wykorzystywane do rozliczenia (stan: wydane lub w realizacji). Nie zostaną przesłane bony zrealizowane oraz zablokowane.

Uwaga

Należy zwrócić uwagę czy karta towaru o typie bon powiązana z rodzajem przesyłanych bonów jest wysyłana do POS, czyli czy zawiera się w drzewie grup towarów wysyłanych do PO

Przesyłanie do POS nowej formy płatności: bon

Aby płatność Bon została przesłana do Comarch POS konieczne jest zaznaczenie na płatności na definicji Centrum powiązanego z oddziałem Comarch POS, na zakładce [Formy Płatności], parametru Dostępna w oddziale. Na definicji każdego stanowiska POS konieczne jest powiązanie formy płatności Bon z rejestrem kasowo- bankowym. Możliwe jest wskazanie tego samego rejestru, który jest wykorzystywany dla gotówki lub dodanie nowego rejestru przeznaczonego tylko dla płatności bonem. Oznaczenie parametru Bez KP/KW będzie oznaczało, że dla płatności kartą nie będą tworzone dokumenty wpłat. Oznaczenie parametru Wyczyść po zamknięciu sesji będzie oznaczało, że kwoty z zapłaty bonami nie będą się kumulować, lecz będą zerowane po każdym zamknięciu sesji. Podczas przypisywania rejestru kasowego/bankowego do płatności typu Bon sprawdzane jest ustawienie parametru Bony na operacji przychodowej przypisywanej do rejestru. Do wybieranego rejestru musi być przypisana przynajmniej jedna operacja przychodowa z zaznaczonym parametrem Bony. Jeśli warunek nie zostanie spełniony, rejestr nie będzie mógł być przypisany. Należy wówczas wybrać inny rejestr lub zmienić ustawienie powyższego parametru.

Sprzedaż bonów

Bony towarowe mogą być sprzedawane na dokumentach handlowych (fakturze lub paragonie) lub za pomocą not memoriałowych. To czy bon będzie sprzedawany za pomocą dokumentów handlowych czy też za pomocą not memoriałowych zależy od tego czy na rodzaju bonu został przypisany rodzaj noty. Aby bon mógł być sprzedany w POS musi nastąpić przyjęcie towaru i partii odpowiadającej numerowi bonu. Można to zrobić na kilka sposobów:

Sprzedaż za pomocą faktury lub paragonu

Jeśli do rodzaju bonu nie został przypisany rodzaj noty wówczas standardowo sprzedaż bonów będzie realizowana wybranym dokumentem handlowym. Do sprzedaży bonów konieczne jest połączenie on-line z Comarch ERP XL. W przypadku gdy takiego połączenia nie ma, system POS wyświetli komunikat: Brak połączenia z serwisem bonów. W momencie sprzedaży bonu serwis bonów sprawdza stan bonu. Do sprzedaży może być przekazany tylko bon o stanie: Przyjęty na stan. Dodatkowo sprawdzany jest stan ilościowy dla partii odpowiadającej numerowi bonu i jeśli na magazynie, z którego wystawiana jest faktura/paragon brak ilości dla bonu, sprzedaż również nie będzie możliwa. Informacja o sprzedaży bonu trafia do XL wraz z zaimportowanym dokumentem sprzedaży. Po zaimportowaniu dokumentu do XL, stan bonu zmienia się na Wydany.

Sprzedaż za pomocą not memoriałowych

Aby możliwa była sprzedaż za pomocą not memoriałowych konieczne jest odpowiednie skonfigurowanie systemu. Na definicji oddziału Comarch POS, na zakładce [Parametry] należy wybrać rodzaj noty, zgodnie z którym będzie dodawana nota po jej zaimportowaniu z POS do XL. Jeśli podczas sprzedaży zostanie wybrany bon o rodzaju powiązanym z definicją not, wówczas system POS automatycznie ustawi podczas sprzedaży tego bonu rodzaj dokumentu – nota memoriałowa NM. Po zatwierdzeniu okna sprzedaży do listy dokumentów zostanie dodana nota. Jeśli na dokumencie sprzedaży znajda się towary i bony lub bony powiązane i niepowiązane z notami, wówczas podczas zatwierdzania sprzedaży system automatycznie wygeneruje dwa dokumenty: Dla takiej sprzedaży płatność będzie wspólna odpowiednio rozliczona na obu dokumentach. Wystawione noty trafią do Comarch ERP XL na listę not memoriałowych w menu Księgowość/Noty memoriałowe. W polu rodzaj dokumentu zostanie ustawiony rodzaj noty przypisany na zakładce [Parametry] oddziału Comarch POS. Seria zostanie ustawiona zgodnie z serią zdefiniowaną na stanowisku POS. Dla każdego wydanego bonu zostanie dodana oddzielna pozycja, gdzie na zakładce [Ogólne] zarejestrowany będzie numer wydanego bonu.

Płatność za pomocą bonu

Do rozliczenia płatności mogą być wykorzystywane bony, które posiadają stan Wydany lub W realizacji, które równocześnie nie są przeterminowane. Do zapłaty bonem konieczne jest połączenie on-line z Comarch ERP XL, gdyż serwis bonów sprawdza w momencie zapłaty stan bonu w XL. W przypadku braku takiego połączenia, po wpisaniu numeru bonu zostanie wyświetlony komunikat: Brak połączenia z serwisem bonów i zapłata bonem nie będzie możliwa. Serwis bonów sprawdza stan bonu, jego wartość (lub wartość pozostałą do wykorzystania), oraz termin ważności. Jeśli bo nie może zostać wykorzystany do zapłaty jest to sygnalizowane odpowiednim komunikatem. Podczas zapłaty bonem należy wskazać formę płatności Bon oraz wpisać numer bonu. Jeśli bon jest możliwy do wykorzystania zostaje przypisany do płatności typu Bon. W przypadku bonu jednorazowego, po jego wykorzystaniu na płatności dokumentu, staje się on bonem zrealizowanym i nie może być użyty powtórnie, nawet wówczas, gdy płatność opiewała na wartość mniejszą niż wartość bonu. W przypadku bonów wielokrotnych po wpisaniu numeru bonu i dodaniu go do płatności, wyświetlana jest informacja o pozostałej kwocie bonu. Bon może zostać wykorzystany w kolejnych transakcjach. Po zaimportowaniu dokumentów sprzedaży do XL następuje aktualizacja stanu bonu. Możliwe stany to: W realizacji (bon wielokrotny, wykorzystany częściowo), Zrealizowany (jednokrotny lub wielokrotny rozliczony w całości). Jeśli zgodnie z konfiguracją płatności na stanowisku POS, w XL zostanie utworzony zapis kasowy lub bankowy do płatności typu bon, na zapisie zostanie dodana informacja o numerze bonu wykorzystanym na płatności. Numer bonu widoczny będzie na zapisie w polu: Bon na zakładce [Ogólne]. Informacja o numerze bonu zapisywana jest również na Płatności do dokumentu w polu: Bon na zakładce [Ogólne].

Aktualizacja stanu bonu w momencie jego wykorzystania podczas zapłaty za dokument w POS

Wprowadzono usługę, która aktualizuje stan bonu on-line czyli od razu w momencie zapłaty w POS. Bon jednorazowy zostaje od razu ustawiony jako zrealizowany natomiast dla bonu wielokrotnego jest ustalana nowa wartość pomniejszona o kwotę użytą podczas rozliczenia. Tak wiec, zanim dokument sprzedaży, który został opłacony bonem trafi do XLa, bon jest zaktualizowany i nie istnieje ryzyko, aby został użyty ponownie.

Obsługa usług

Umożliwiono przesyłanie kart towarowych o typie usługa. Dla usług przesyłane są również cenniki, jednostki pomocnicze, kody kreskowe, atrybuty oraz zdjęcia.

Obsługa klawiatury numerycznej w POS

Na stanowisku POS dodano nowy parametr Obsługa klawiatury numerycznej, który odpowiada za włączenie odpowiedniej obsługi po stronie Comarch POS. Po zaznaczeniu parametru i synchronizacji ustawień, na oknie sprzedaży na stanowisku POS dostępna będzie numeryczna klawiatura ekranowa, która umożliwia łatwe wpisywanie danych liczbowych za pomocą ekranów dotykowych.

Uwaga

Klawiatura numeryczna nie jest dostępna w sytuacji gdy użytkownik równocześnie zaznaczy parametr: Domyślnie korzystaj z przycisków szybkiej sprzedaży.

Synchronizacja towarów powiązanych i zamienników

Towary powiązane i zamienniki są to obiekty rejestrowane na kartach towarów, na zakładce [Zamienniki]. Jest to rodzaj powiązania pomiędzy towarami, które pozwala na lepsze zarządzenie sprzedażą, proponowanie dodatkowych towarów bądź zamienników. Rodzaje powiązań pomiędzy towarami można definiować w słownikach kategorii w module Administrator. Wszystkie rodzaje powiazań (łącznie z zamiennikami) wysyłane są do Comarch POS.

Warunki przesyłania towarów powiązanych i zamienników

Do Comarch POS przesyłane są te powiązania, które na zakładce [Miejsca w strukturze firmy] mają dodane centrum powiązane z oddziałem Comarch POS lub centrum nadrzędne w stosunku do powyższego.

Do POS przesyłane są zamienniki towaru, które spełniają następujące warunki:

Po usunięciu lub modyfikacji zamiennika/towaru powiązanego w Comarch ERP XL, zmiany przesyłane są do POS i aktualizowane.

Widoczność towarów powiązanych i zamienników w POS

Z listy widocznych towarów powiązanych można wybrać dowolny produkt i dodać go do dokumentu sprzedaży.

Obsługa limitów kredytowych

Wprowadzono możliwość obsługi limitów kredytowych we współpracy z Comarch POS. Limity są wysyłane na poszczególne stanowiska POS i kontrolowane podczas sprzedaży. Kontrahenci mogą mieć limit nieograniczony, ograniczony do określonej wysokości lub mogą korzystać z limitów innego kontrahenta. Obsłużono również możliwość korzystania z opcji kontroli limitów akwizytora.

Konfiguracja działania limitów we współpracy z POS

Na oknie konfiguracji oddziału Comarch POS, na zakładce [Kontrahenci] dodano następujące parametry:

Przesyłanie ustawień związanych z limitami

Wymagane płatności bezgotówkowe

Aby działały funkcjonalności związane z limitami konieczne jest przesyłanie na stanowisko POS przynajmniej jednej płatności, która nie jest płatnością gotówkową, czyli nie tworzy zapisów kasowo-bankowych podczas zatwierdzania dokumentu. Tylko dla takich płatności stosowane są zabezpieczenia przed przekroczeniem limitu.

Na stanowisku POS należy dodać przynajmniej jedną płatność, która ma zaznaczoną opcję w kolumnie Bez KP/KW jak przedstawiono poniżej.

Czy w limicie uwzględniać dokumenty nie generujące płatności

To ustawienie przesyłane jest na podstawie definicji dokumentu FS w centrum głównym. W Comarch POS ustawienie to jest wspólne dla wszystkich dokumentów oraz dla wyświetlania na karcie kontrahenta. W Comarch ERP XL jest definiowane dla każdego dokumentu oddzielnie. Ze względu na fakt, że limity mają najczęściej zastosowanie na fakturach, przyjęto, że ustawienie to będzie pobierane z definicji faktury sprzedaży.

Sposób reakcji na przekroczenie limitu

To ustawienie przesyłane jest na podstawie definicji poszczególnych dokumentów (FS, PA) w centrum powiązanym z oddziałem Comarch POS. W zależności od ustawienia parametrów jak niżej podczas zatwierdzania dokumentu forma płatności niegotówkową może pojawić się ostrzeżenie lub nastąpić blokada zatwierdzenia dokumentu. Możliwe jest również pomijanie informacji o limicie w przypadku wybrania opcji Zezwalaj.

Przesyłanie limitów

Dla każdego kontrahenta wysyłane są wszystkie aktualne ustalone dla niego limity kredytowe. Nie są wysyłane limity, które są już przeterminowane. Każda zmiana wielkości limitu jest aktualizowana a usunięcie limitu powoduje jego usunięcie na stanowisku POS.

Uwaga

Limit płatnika będzie obsługiwany tylko wówczas, gdy płatnikiem będzie kontrahent. W sytuacji, gdy płatnikiem będzie bank, urząd, pracownik lub centrala, limit płatnika nie będzie uwzględniany. W takiej sytuacji limit będzie pobierany z kontrahenta.

Kontrola on-line limitów

Bardzo ważne jest, aby podczas sprzedaży możliwe było ustalenie najbardziej aktualnego wykorzystania limitu kredytowego, gdyż limit może być wykorzystany na innym stanowisku lub w systemie Comarch ERP XL. W momencie wyświetlenia danych kontrahenta w POS limit zostanie pobrany z XLa i wyświetlana zostanie aktualna wartość całkowita oraz dostępna limitu. Podobnie podczas wystawiania dokumentów sprzedaży prezentowany będzie dostępny i całkowity limit kontrahenta lub jego płatnika a przy zatwierdzaniu dokumentu FS czy PA z płatnością niegotówkową nastąpi kontrola bądź ostrzeżenie w przypadku przekroczenia limitu lub jego braku.

Jeśli z jakiegokolwiek powodu połączenie on-line nie będzie możliwe, wówczas z limitu można korzystać przez określony czas, którego długość ustala się w konfiguracji oddziału.

Limity akwizytora

Jeśli w Konfiguracji na zakładce [Sprzedaż]/[Parametry2] zostanie zaznaczony parametr: Sprawdzaj limit akwizytora, wówczas do POS będą wysyłane limity ustawione na karcie kontrahenta oznaczonego jako akwizytor, na zakładce [Limity akwizytora]. Limit akwizytora ustalany jest oddzielnie dla każdego centrum, dlatego, aby limit trafił do oddziału Comarch POS musi zostać przypisany do odpowiedniego centrum powiązanego z danym oddziałem.

Aby dla danego kontrahenta zadziałał limit akwizytora, konieczne jest przypisanie akwizytora na karcie kontrahenta, na zakładce [Inne]. Akwizytor musi być wybrany z listy kontrahentów (nie może być pracownikiem).

Limit akwizytora traktowany jest jak limit innego płatnika, to znaczy, że jeśli do kontrahenta zostanie przypisany akwizytor, a na karcie akwizytora zostanie ustalony limit, to na karcie kontrahenta oraz podczas sprzedaży dla tego kontrahenta, będzie sprawdzany limit przypisanego akwizytora.

W przypadku stosowania limitów akwizytora (włączony parametr Sprawdzaj limit akwizytora), nie są obsługiwane inne limity kontrahentów.

Zasady przesyłania, kontroli i kontroli on-line limitów akwizytora są takie same jak limitów kontrahenta/płatnika.

Wyszukiwanie kontrahentów w GUS i VIES

Umożliwiono wyszukiwanie i weryfikowanie kontrahentów w serwisach GUS i VIES. W tym celu przekazywany jest do systemu Comarch POS zaszyfrowany numer klucza ustawionego na definicji Usługi synchronizacji z POS. Aby wyszukiwanie w GUS i VIES było możliwe, serwis klucza musi być aktywny a klucz musi posiadać ważną gwarancję.

Rozliczanie płatności w walucie obcej z równoczesnym wydaniem reszty w PLN (w walucie systemowej)

W Comarch POS możliwe jest przyjmowanie zapłaty za fakturę lub paragon w walucie obcej. Jeśli płatność walutowa zostanie przyjęta formą płatności gotówkową, wówczas system automatycznie wyliczy kwotę do wydania klientowi w walcie systemowej, czyli w PLN. Przy imporcie tak rozliczonych dokumentów do Comarch ERP XL tworzone są dwie płatności – jedna jako należność w wysokości wpłaty walutowej a druga jako zobowiązanie na wartość stanowiąca różnicę pomiędzy zapłatą w walucie obcej przeliczoną na PLN a wartością dokumentu (reszta wydana klientowi w PLN). To, czy do płatności zostaną wygenerowane dokumenty zapłaty (rozliczenia) zależy od ustawienia parametru Bez KP/KW na definicji płatności na stanowisku POS. Wyliczenie kwoty do zwrotu (reszty) realizowane jest po stronie Comarch POS wg określonego kursu (ustawienia kursu dla Comarch POS dostępne są na definicji Oddziału POS na zakładce [Waluty]).

Inwentaryzacja

Wprowadzono możliwość realizowania inwentaryzacji we współpracy z Comarch POS, gdzie odczyty (spis towarów z natury) mogą być realizowane na stanowiskach POS. Dodanie dokumentu inwentaryzacji będzie realizowane po stronie XLa. Następnie do dokumentu inwentaryzacji należy wygenerować arkusze inwentaryzacyjne, które zostaną przesłane na stanowiska POS. Po stronie stanowisk POS będą generowane odczyty, które po zamknięciu arkuszy w POS trafią do XLa. Zatwierdzenie całej inwentaryzacji i wykonanie korekt inwentaryzacyjnych realizowane będzie po stronie Comarch ERP XL.

Ustawienia i uprawnienia

Na oknie konfiguracji oddziału Comarch POS oraz w kreatorze oddziału dodano nowe parametry związane z inwentaryzacją. Aby móc wykonywać operacje związane z inwentaryzacją w oddziałach Comarch POS konieczne jest zaznaczenie parametru Obsługa inwentaryzacji. Dodatkowo dodano parametr Ostrzegaj podczas dodawania inwentaryzowanego towaru na dokument. Po jego zaznaczeniu, podczas wystawiania dokumentów w POS na towary znajdujące się na arkuszach inwentaryzacyjnych pojawi się stosowny komunikat informujący o trwającej inwentaryzacji. Komunikat będzie się pojawiał do czasu zatwierdzenia arkusza, na którym znajduje się towar. Należy pamiętać, że zamknięcie arkusza w Comarch POS spowoduje aktualizację stanów w POS i przesłanie arkuszy do Comarch ERP XL, natomiast po stronie systemu XL inwentaryzacja do czasu jej zamknięcia nadal będzie blokować sprzedaż i wystawianie innych dokumentów. Na wzorcu operatora na zakładce [POS] również dodano parametry związane z inwentaryzacją. Są to parametry związane z uprawnieniami operatorów.

Typy inwentaryzacji

Przed przystąpieniem do pierwszej inwentaryzacji należy dodać odpowiedni typ inwentaryzacji w POS. W tym celu w module Administrator należy przejść do opcji Listy/ Słowniki Kategorii/ Transakcje/ Typy inwentaryzacji POS. W słowniku tym należy dodać przynajmniej jeden typ inwentaryzacji, który jest niezbędny przy realizowaniu inwentaryzacji w Comarch POS. Na każdym z typów możliwe jest określenie kodu i nazwy typu oraz parametrów dotyczących sposobu realizacji inwentaryzacji. Jeden z typów można ustawić jako domyślny, wówczas automatycznie zostanie ustawiony no nowej inwentaryzacji. Można również dezaktywować wybrany typ za pomocą odznaczenia parametru Aktywny.

Przygotowanie inwentaryzacji w Comarch ERP XL

Inwentaryzację należy dodać standardowo w module Sprzedaż w menu Zestawienia/Inwentaryzacja. Następnie należy wybrać jeden z magazynów POS, dla którego ma być przeprowadzona inwentaryzacja. Dla każdego magazynu inwentaryzacja musi być przeprowadzona oddzielnie tzn. należy wygenerować oddzielny dokument inwentaryzacyjny. Po dodaniu magazynu POS, zostanie aktywowany parametr Realizuj w Comarch POS. Po jego zaznaczeniu w polu Typ inwentaryzacji POS ustawi się domyślny typ inwentaryzacji. Jeśli żaden z typów nie został określony jako domyślny, obowiązkowo należy wybrać typ inwentaryzacji. Dla inwentaryzacji realizowanych po stronie POS konieczne jest przekazanie numeru dokumentu. W tym celu dodano pole Nazwa/Numer, którego uzupełnienie jest wymagane tylko w przypadku inwentaryzacji realizowanych w Comarch POS.

Parametry inwentaryzacji

Na oknie inwentaryzacji niektóre parametry nie są dostępne do edycji i ich ustawienie jest domyślne.

Dodawanie arkuszy inwentaryzacji

Aby inwentaryzacja została przesłana do Comarch POS należy wygenerować przynajmniej jeden arkusz. Podczas dodawania towarów do arkusza, system pilnuje, aby dodawane towary należały do grupy towarów wysyłanych do danego oddziału POS. Jeśli zostaną wskazane towary nie wysyłane do danego oddziału POS, z którego pochodzi magazyn na inwentaryzacji, nie zostaną one dodane do arkusza. Można również przygotować puste arkusze, wówczas towary można będzie dodawać podczas wykonywania spisu towarów na stanowiskach POS. Po zapisaniu formularza inwentaryzacji może on zostać przesłany do POS. Pobranie dokumentu inwentaryzacji inicjowane jest po stronie stanowiska POS podczas wejścia na listę dokumentów inwentaryzacji i wybranie opcji Odśwież. Po dodaniu kolejnych arkuszy, zostaną one dodane do inwentaryzacji w POS po odświeżeniu listy. Arkusze przekazane do Comarch POS nie mogą być usuwane ani aktualizowane w systemie XL, nie mogą być też dodawane do nich odczyty. Spisywanie towarów i generowanie odczytów możliwe będzie po stronie stanowisk POS.

Realizacja inwentaryzacji na stanowiskach POS

Dokument inwentaryzacji oraz przesłane arkusze mają ustawiony stan otwarty i są gotowe do spisywania towaru. Do każdego arkusza może być generowanych wiele raportów (odczytów). Stany spisywanych towarów są sumowane lub nadpisywane w zależności od typu inwentaryzacji. Podczas spisywania towarów możliwe jest dodanie towaru, którego nie ma na arkuszu, w takim przypadku towar zostanie dodany do arkusza zarówno w POS jak i w XLu. Po skończonym spisie towarów należy zamknąć arkusz na stanowisku POS. Po jego zamknięciu arkusz wraz z odczytami zostanie przesłany do systemu XL i nie będzie możliwości kontynuowania spisu towarów będących na danym arkuszu. Odczyty przygotowywane na stanowiskach POS otrzymują nazwę wg schematu: Kod stanowiska_data i godzina dodania odczytu.

Zamykanie inwentaryzacji

Po zamknięciu i przesłaniu do XLa wszystkich arkuszy można zamknąć inwentaryzację w systemie Comarch ERP XL. Zamknięcie inwentaryzacji w XLu spowoduje wygenerowanie dokumentów różnicowych na braki i nadwyżki zgodnie ze standardowym działaniem inwentaryzacji w Comarch ERP XL. Przed zamknięciem system zapyta czy na pewno proces inwentaryzacji po stronie Comarch POS został zakończony i czy na pewno zamknąć inwentaryzację.

Sprzedaż i inne dokumenty wpływające na stan towaru podczas inwentaryzacji

Istnieje różnica pomiędzy działaniem inwentaryzacji w Comarch ERP XL a Comarch POS polegająca na tym, że w XLu nie można wystawiać dokumentów na inwentaryzowane towary, podczas gdy w POS jest to możliwe. Oznacza to, że dokumenty wystawione na stanowiskach POS na inwentaryzowane towary lub na cały magazyn podlegający inwentaryzacji nie będą mogły być zaimportowane do czasu zamknięcia inwentaryzacji. Jeśli na dokumencie inwentaryzacji został zaznaczony opcja Inwentaryzacja blokuje cały magazyn, wówczas żadne dokument nie zostanie zaimportowany. Jeśli zostanie wybrana opcja Inwentaryzacja blokuje tylko inwentaryzowane towary, wówczas nie zostaną zaimportowane tylko te dokumenty, na których znajdą się inwentaryzowane towary. Blokada dotyczy magazynu, którego dotyczy inwentaryzacja. Na pozostałych magazynach można dokonywać sprzedaży czy wystawiać inne dokumenty. Przy włączonym parametrze Ostrzegaj podczas dodawania inwentaryzowanego, podczas dodawania towaru na dokument pojawi się stosowne ostrzeżenie o trwającej inwentaryzacji.

Uwaga

Nie zaleca się dokonywania sprzedaży i rejestrowania innych dokumentów w POS na magazynach, na których trwa inwentaryzacja. Dokumenty te nie trafią do bazy systemu Comarch ERP XL, do czasu zamknięcia inwentaryzacji. Po zamknięciu inwentaryzacji dokumenty zostaną zaimportowane, ale czas ich importu może być bardzo długi, ze względu na ilość nagromadzonych dokumentów.

Uwaga

 Może też wystąpić rozbieżność w stanach towarowych pomiędzy bazami Comarch POS a Comarch ERP XL wynikająca z faktu, że XL nie aktualizuje stanów towaru podczas trwania inwentaryzacji, lecz dopiero po jej zamknięciu. Generowane są wówczas dokumenty na różnice inwentaryzacyjne odnoszące się do stanów z momentu wygenerowania arkuszy inwentaryzacyjnych (czyli nie uwzględniających dokumentów wystawiony w trakcie inwentaryzacji).

Uzgadnianie stanów towarów podczas trwania inwentaryzacji w POS

W Comarch POS istnieje funkcjonalność polegająca na uzgodnieniu stanów towarów na podstawie stanów w Comarch ERP XL. Po wybraniu opcji Uzgadnianie stanów magazynowych w menu Aktualizacja danych stany towarów są ustalane na zgodne ze stanami w bazie systemu Comarch ERP XL. W trakcie trwania inwentaryzacji stany w Comarch POS aktualizowane są po zamknięciu arkusza, natomiast w Comarch ERP XL standardowo dopiero po zamknięciu inwentaryzacji i wygenerowaniu dokumentów na różnice inwentaryzacyjne. Wykonanie akcji Uzgodnienie stanów magazynowych doprowadziłoby do przywrócenia stanów sprzed rozpoczęcia inwentaryzacji. Nie należy wykonywać akcji Uzgodnienie stanów magazynowych podczas trwania inwentaryzacji w POS, gdyż doprowadzi to do niezgodności w stanach magazynowych pomiędzy systemami. Dodano wydruki do Inwentaryzacji (Inwentaryzacja, Wykaz rozbieżności inwentaryzacji, Arkusz inwentaryzacji, Raport inwentaryzacji). Wydruki widoczne są na formularzu stanowiska POS na zakładce [Wydruki].

Wyszukiwanie globalne dokumentów w POS oraz możliwość wystawienia do nich korekt i reklamacji

Globalne wyszukiwanie dokumentów na stanowiskach POS

Obsłużono parametr globalne wyszukiwanie dokumentów na stanowiskach POS wg ustawienia na konfiguracji oddziału POS, zakładka [Parametry]. Wyszukiwanie globalne polega na możliwości przeszukania dokumentów w bazie Comarch ERP XL i pobranie na stanowisko POS. W przypadku, gdy po wpisaniu numeru poszukiwanego dokumentu (faktury lub paragonu) na liście dokumentów na stanowisku POS nie zostanie on odnaleziony w bazie lokalnej POS, System zadaje pytanie: Czy chcesz kontynuować wyszukiwanie również w systemie ERP?. Po wybraniu opcji Szukaj wysyłane jest zapytanie o konkretny numer dokumentu do Comarch ERP XL. W przypadku gdy dokument zostanie odnaleziony następuje jego pobranie i zapisanie w lokalnej bazie POS.

Pobieranie dokumentów handlowych (faktur i paragonów) wystawionych na innych stanowiskach POS

Wskazówka

Jeśli w poszczególnych sklepach wykorzystywane są różne typy cen, wówczas w celu poprawnego przesyłania dokumentów pomiędzy sklepami konieczne jest dodanie cenników innych sklepów w konfiguracji Centrów powiązanych z oddziałami POS.

Wskazówka

Jeśli w poszczególnych sklepach wykorzystywane są różne waluty, wówczas w celu poprawnego przesyłania dokumentów pomiędzy sklepami konieczne jest dodanie walut wykorzystywanych w innych sklepach na oknie konfiguracji oddziału POS.

Dokument wyszukany bazie Xla, automatycznie jest pobierany i zapisywany na liście dokumentów w POS. Jeśli do paragonu wystawiono fakturę, jest ona również pobierana. Dotyczy to również faktur wystawionych do tych dokumentów w Systemie Comarch ERP XL. Na liście dokumentów pojawi się zarówno paragon jak i faktura wraz z informacją o powiązaniu tych dokumentów. W przypadku paragonów z wystawionymi do nich fakturami wyszukiwanie może być realizowane zarówno po numerze paragonu jak i faktury. Paragony i faktury, do których wystawiono korekty pobierane są wraz z korektami, które są powiązane i widoczne na liście dokumentów w POS. Dotyczy to również korekt wystawionych do tych dokumentów w Systemie Comarch ERP XL. Wyjątkiem jest sytuacja gdy w XLu wystawiono korektę wartościową lub stawki VAT. Wówczas paragon czy faktura nie zostaną przekazane do Comarch POS, gdyż nie byłoby możliwe uwzględnienie tych korekt w dalszym procesie wystawiania dokumentów (kolejne zwroty lub faktura).

Uwaga

Na stanowisko POS możliwe jest pobranie dokumentów wystawionych na innych stanowiskach danego oddziału POS oraz w innych oddziałach POS. Nie ma możliwości pobierania dokumentów wystawionych w Centrali czyli bezpośrednio w bazie w Comarch ERP XL. Jest to związane z możliwościami wystawiania w Systemie XL faktur i paragonów, gdzie na jednej pozycji dokumentu może być pobranych wiele różnych partii i dostaw, podczas gdy do Comarch POS konieczne jest wskazanie jednej konkretnej partii dla każdej pozycji.

Uwaga

Nie są wyszukiwane dokumenty wystawione dla kontrahentów niezarejestrowanych w bazie POS, na którym realizowane jest wyszukiwanie ani dokumenty z pozycjami niesprzedawanymi w danym sklepie.

Wystawianie korekt i reklamacji do dokumentów pobranych z innych stanowisk i oddziałów

Do pobranego paragonu możliwe będzie wygenerowanie faktury, wystawienie korekty oraz wystawienie dokumentu reklamacji na takich samych zasadach jak dla dokumentów wystawionych lokalnie. Do pobranych faktur możliwe będzie wystawienie korekty lub reklamacji na takich samych zasadach jak dla dokumentów wystawionych lokalnie.

Współpraca z Comarch webPOS

Comarch webPOS jest wysoce skalowalnym rozwiązaniem, hostowanym w Comarch Cloud. Zadaniem aplikacji jest realizacja procesów biznesowych sprzedaży detalicznej. Aplikacja przeznaczona jest dla sprzedawców pracujących na stanowiskach kasowych. Jej głównym zadaniem jest wykonanie operacji związanych z obsługą klienta. Od wersji 2024.0 umożliwiono integrację Comarch ERP XL ze stanowiskami obsługi klienta Comarch webPOS. Aby możliwa była praca na stanowiskach webPOS, w konfiguracji Oddziału POS na zakładce [POS] dodano pole do wpisania kodu webPOS. Kod webPOS może być dowolnym ciągiem znaków, który posłuży do identyfikacji bazy danych, na której zarejestrowane są oddziały POS ze stanowiskami webPOS.

Logowanie do Comarch webPOS

W Comarch webPOS wykorzystywany jest adres e-mail operatora do powiązania użytkowników z kontem SSO, gdzie adres e-mail jest loginem. Oznacza to, że dla każdego operatora należy przesyłać adres mailowy. W tym celu zostanie wykorzystany adres e-mail pracownika powiązanego z operatorem przesyłanym do webPOS. W związku z powyższym wymaganiem należy każdemu operatorowi, który może pracować na wersji webowej POS przypisać konto pracownika, na którym należy uzupełnić adres mailowy w polu E-mail na zakładce [Ogólne]. Podczas przypisywania pracownika do operatora system pilnuje, aby ten sam pracownik nie został przypisany do kilku operatorów wykorzystywanych w oddziałach POS, dlatego nie istnieje ryzyko, że ten sam pracownik zostanie dodany do kilku operatorów. Każdy pracownik powinien mieć przypisany inny adres mailowy, pole to nie jest walidowane w systemie XL, dlatego należy zwrócić uwagę, aby adresy e-mail były unikalne.

Nowy typ stanowiska

W konfiguracji Oddziałów Comarch POS dodano możliwość definiowania stanowisk z przeznaczeniem do pracy na platformie webPOS. Podczas dodawania stanowiska pojawiła się możliwość wskazania w polu Typ aplikacji opcji webPOS. Po wybraniu typu aplikacji webPOS, w polu Licencja automatycznie ustawi się opcja FrontOffice, bez możliwości zmiany, ze względu na to, że webowa wersja Comarch POS umożliwia na chwilę obecną obsługę sprzedaży i kasy. Stanowiska webowe mogą być mieszane z innymi typami aplikacji, tak więc w ramach jednego oddziału mogą pracować stanowiska POS, mPOS i webPOS. Podczas synchronizacji z platformą webPOS wysyłane są dane związane z wszystkimi stanowiskami webPOS dodanymi w dowolnym oddziale zarejestrowanym w XLu. Dokumenty wystawiane po stronie webPOS trafiają automatycznie do bazy XLa, po ich wystawieniu na stanowiskach webPOS.

Inne zmiany

Uwaga

Zmiany w imporcie faktur do paragonów oraz korekt paragonów i faktur. W polu Faktura na zakładce [Nagłówek] zapisywany jest numer dokumentu przesłany z Comarch POS. W przypadku faktur będących spinaczami paragonu, w XLu symbol dokumentu to RA natomiast w Comarch POS numeracja jest jednolita i wszystkie faktury posiadają symbol FS. Podobnie jest w przypadku korekt gdzie w XLu dokumenty posiadają oznaczenie FSK lub PAK, natomiast w POS odpowiednio FS i PA. Aby zachować zgodność numeracji przy wysyłce do JPK_VAT7, w polu Faktura zapisywany jest numer dokumentu z oznaczeniem jakie zostało wydrukowane na dokumencie w Comarch POS.

Uwaga

Zmiany w przesyłaniu magazynu powiązanego z definicją dokumentów FS i PA. Jeśli na formatce magazynu, na zakładce [Dokumenty] zostanie odznaczony parametr dotyczący wystawiania FS lub PA, wówczas nie będzie możliwe wystawianie tych dokumentów w POS na magazyn, który ma odznaczony dany typ dokumentu.

Import korekty wystawionej do faktury wystawionej do paragonu

Umożliwiono przesyłanie do Comarch ERP XL korekt wystawionych do faktury, która została wystawiona do paragonu w Comarch POS. Korekta do faktur wystawionej do paragonu tworzona jest jako spinacz RAK. Aby możliwe było utworzenie korekty po stronie Comarch ERP XL spinacza korekty do faktury, generowany jest po stronie XLa dokument korekty do paragonu a następnie tworzony spinacz korekty, spinający korektę. Korekta paragonu wystawiana jest po stronie systemu XL w centrum głównym. Numer dokumentu nadawany jest po stronie XLa, zgodnie z ustawieniami centrum głównego.

Przesyłanie pełnej nazwy kontrahenta

Umożliwiono przesyłanie wszystkich trzech linii nazwy kontrahenta do Comarch POS, jak również zapisywanie nazwy przesłanej z POS do Comarch ERP XL we wszystkich liniach aż do wyczerpania miejsca. Po stronie XLa nazwa może zostać zapisana w trzech liniach (2 linie po 50 znaków, w trzeciej linii 250 znaków). Podczas wysyłania kontrahentów do Comarch POS zawartość poszczególnych linii łączona jest przy pomocy spacji, podczas importu do Comarch ERP XL dane zapisywane są tak, aby słowa nie zostały podzielone w środku.

Przesłanie numeru karty kontrahenta

W Comarch ERP XL na karcie towaru na zakładce [Ogólne] znajduje się pole Karta, w którym można zapisać numer karty kontrahenta. Wraz z uzupełnieniem numeru karty wybierany jest też typ karty. Jeśli nie zostanie wybrany typ karty, wówczas domyślnie zostanie ustawiona opcja Własna karta. Numery kart będą wysyłane wraz z typem do Comarch POS, dzięki czemu możliwe będzie wyszukiwanie kontrahentów wg numeru karty. Jeśli dla danego numeru karty kontrahenta zostanie wygenerowany kod kreskowy i przygotowana fizycznie karta, wówczas wyszukiwanie kontrahenta możliwe będzie z użyciem czytnika kodów kreskowych.

Uwaga

Zmiana numeru karty na karcie kontrahenta spowoduje zmianę w Comarch POS. Jeśli jednak kod zostanie usunięty z pola Karta na karcie kontrahenta, nie zostanie on usunięty w Comarch POS. Nadal możliwe będzie wyszukiwanie po tym kodzie. Dodanie tego samego kodu na innej karcie spowoduje wysłanie go do POS. Podczas wyszukiwania kontrahentów zostanie odszukany kontrahent z obecnie ustawionym numerem karty oraz ten, dla którego numer był ustawiony wcześniej. Dlatego nie zaleca się usuwania numeru karty, dla kontrahentów wysyłanych do POS.

Przesyłanie jednostek wagi i miary towaru

Dla każdej jednostki miary towaru możliwe jest określenie wagi i objętości. Aby objętość lub waga towaru zostały wysłane do Comarch POS dla poszczególnych towarów, konieczne jest dodanie do listy jednostek w Comarch ERP XL, jednostek zgodnie z oznaczeniami, które są wykorzystywane do określenia wagi lub objętości. Dla każdej jednostki miary towaru możliwe jest określenie wagi i objętości. Aby objętość lub waga towaru zostały wysłane do Comarch POS dla poszczególnych towarów, konieczne jest dodanie do listy jednostek w Comarch ERP XL, jednostek zgodnie z oznaczeniami, które są wykorzystywane do określenia wagi lub objętości.

Wystarczy dodać tylko te jednostki miary lub objętości, które w rzeczywistości są wykorzystywane do określenia wagi lub objętości na towarach wysyłanych do Comarch POS. W powyższym przypadku, konieczne jest dodanie do listy jednostek, jednostek o symbolach: Gram, Kg i cm3. Po dodaniu jednostek do listy, zostaną one przesłane do Comarch POS. Informacje te nie są prezentowane w interfejsie systemu, można je wykorzystać np. do raportowania.

Uruchomienie stanowiska POS

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

Uwaga

Przed uruchomieniem Comarcg POS wymagane jest uruchomienie Usługi w Menadzerze zadań

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 POS po wybraniu opcji: Aktualizacja danych.

Uwaga

Przed uruchomieniem aplikacji należy zweryfikować czy konto domenowe, na którym działa usługa ma uprawnienia do logowania się w trybie usługi. (Zasady zabezpieczeń lokalnych, folder zasady lokalne - przypisywanie praw użytkownika - logowanie w trybie usługi) Zalecane jest, żeby użytkownik, na którym działa usługa, miał uprawnienia administracyjne Windows.

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)

Uwaga

• Dokumenty handlowe - POS można wystawiać tylko faktury i paragony, korekty do nich oraz spinacze do paragonów
• Faktury mogą być wystawiane od netto (zależne od definicji dokumentu )
• Numeracja dokumentów jest zgodna z ustawieniami w XL i zawsze z serią przypisaną do stanowiska (wspólna numeracja dla dokumentów i korekt!)
• Zapisy kasowe – wpłaty i wypłaty ręczne, dokumenty otwarcia i zamknięcia dnia, automatyczne KP/KW do dokumentów tworzone po stronie Xla (ustawienie na stanowisku POS)
• Sprzedaż poniżej stanów – możliwa jeśli zaznaczony jest parametr -automatyczne tworzenie PW
• Sprzedaż wg partii – towar widoczny kilka razy na liście towarów.

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

Rabaty przesyłane do Comarch POS

Uwaga

Przesyłanie informacji czy towar podlega rabatowaniu uzależnione jest od ustawienia parametru, który znajduje się na karcie towaru na zakładce Upusty, Nie stosuj żadnych upustów.

Aktualnie możliwe rabaty do przeslania to: Ogólne zasady przesyłania promocji (rabatów) Do oddziału Comarch POS mogą zostać przesłane rabaty zdefiniowane dla Centrum powiązanego z oddziałem Comarch 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 Comarch 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

Uwaga

W Comarch POS rabaty na grupy kontrahentów wyliczane są inaczej niż Comarch ERP XL. Naliczany jest tylko ten rabat, który został zdefiniowany dla grupy ustawionej na karcie kontrahenta jako grupa domyślna, podczas gdy w XLu rabaty pochodzące z różnych grup są sumowane. Należy zwrócić uwagę na ten fakt podczas definiowania promocji, które mają być wysyłane do Comarch POS.

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 Comarch 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 Comarch POS lub grup jej podrzędnych.

Uwaga

Jeśli promocja ma być zastosowana dla wszystkich towarów np. jest to promocja na Grupę Główną, natomiast w konfiguracji oddziału Comarch POS jest wskazana inna grupa, wówczas konieczne jest dodanie tej grupy do promocji na zakładce [Towary].

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

Uwaga

W Comarch POS rabaty na grupy towarów wyliczane są inaczej niż Comarch ERP XL. Naliczany jest tylko ten rabat, który został zdefiniowany dla grupy ustawionej na towarze jako grupa domyślna, podczas gdy w XLu rabaty pochodzące z różnych grup są sumowane. Należy zwrócić uwagę na ten fakt podczas definiowania promocji, które mają być wysyłane do Comarch POS.

Promocja na towary: przesyłane będą tylko te rabaty, na definicji których przynajmniej jeden dodany towar jest wysyłany do Comarch 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 ComarchPOS 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 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 Comarch 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 Comarch 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 Comarch POS, konieczne jest wskazanie na zakładce [Kontrahenci] grupy zdefiniowanej jako grupa do eksportu kontrahentów do oddziału POS.

Uwaga

 W przypadku rabatów WTR nie są przesyłane infromacje o gratisach.

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 POS nie wszystkie elementy rabatów będą mogły zostać wysłane. Do Comarch 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 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.

Uwaga

W przypadku rabatów progowych dla każdego progu tego samego towaru musi być ustawiony ten sam typ rabatu: wartościowy lub procentowy. W przypadku nie zastosowania powyższej zasady promocja nie zostanie wysłana do POS.

Promocja pakietowa stała i elastyczna

Wprowadzono możliwość przesyłania promocji pakietowych stałych i elastycznych do systemu Comarch POS. Naliczanie promocji pakietowych w Comarch POS będzie analogiczne jak w Comarch ERP XL, przy czym w POS nie ma możliwości wyboru promocji pakietowych, lecz zostanie naliczony pierwszy pakiet spełniający warunku wg ustawień kolejności na liście promocji pakietowych. Nie wszystkie ustawienia promocji mogą zostać przesłane do Comarch POS ze względu na różnice w działaniu modułów rabatowych w obu systemach, co zostało opisane w kolejnych punktach.

Warunki przesyłania promocji pakietowych

Do Comarch POS przesyłamy promocje pakietowe stałe i elastyczne pod określonymi warunkami. Do Comarch POS przesyłane są promocje pakietowe, które:

Automatyczne naliczanie promocji pakietowych

To czy promocja zostanie naliczona automatycznie na dokumentach wystawianych na stanowisku POS czy też będzie konieczne wybranie przycisku Nalicz promocje zależy od parametru, który ustawiany jest na oknie Konfiguracji oddziału Comarch POS na zakładce [Parametry].

Przy zaznaczonym powyższym parametrze, podczas wystawiania dokumentów promocje będą naliczane automatycznie po spełnieniu określonych warunków. Wybierana jest zawsze pierwsza promocja (wg kolejności na liście promocji w Comarch ERP XL), dla której spełnione są warunki na dodanych pozycjach. W przypadku, gdy parametr nie będzie zaznaczony, wówczas po dodaniu pozycji można wybrać przycisk Nalicz promocje. Zasady naliczania promocji będą takie same jak przy automatycznych promocjach, jednak system nie będzie wyszukiwał promocji po dodaniu każdej pozycji do dokumentu. Jeśli dla pakietu zostały zdefiniowane gratisy, to po zatwierdzeniu dokumentu system przypomni o możliwości skorzystania z opcji gratisu dla promocji.

Kolejność naliczania promocji na stanowisku POS

W Systemie Comarch ERP XL możliwe jest ustalanie kolejności promocji pakietowych za pomocą przycisków Przesuń w dół pozycję na liście i Przesuń w górę pozycję na liście. Kolejność promocji możliwa jest do ustalenia osobno w obrębie promocji pakietowych i osobno w obrębie promocji PRM. Ustalenie kolejności promocji pakietowych jest przesyłane do Comarch POS, nie ma natomiast wpływu na wyświetlanie kolejności promocji podczas wystawiania dokumentów w Comarch ERP XL.

Kolejność promocji pakietowych ma znaczenie w naliczaniu promocji na dokumentach wystawianych na stanowiskach POS. Jeśli dane pozycje na dokumencie będą spełniały warunki więcej niż jednej promocji, wówczas zostanie naliczona ta promocja, która w Comarch ERP XL jest wyżej na liście (ma wyższy Priorytet2).

Wskazówka

Promocje pakietowe wysyłane są do Comarch POS zawsze z priorytetem 0, dlatego nie należy ustawiać priorytetu 0 dla innych promocji.

Informacje dodatkowe

Z powodu różnic pomiędzy działaniem promocji pakietowych w Comarch ERP XL a działaniem modułu rabatowego w Comarch POS mogą występować pewne odstępstwa w naliczaniu promocji. W Comarch ERP XL dla promocji pakietowych możliwy jest do ustawienia parametr Max ilość pakietów ogółem lub dla kontrahenta. W module rabatowym wykorzystywanym w Comarch POS nie ma możliwości przesłania analogicznych ustawień, dlatego ustawienie to będzie ignorowane. Oznacza to, że jeśli na pakiecie zostanie ustawiony limit, to nie będzie on respektowany na stanowiskach POS. Warto rozważyć, czy pakiet z ustalonymi limitami wysyłać do oddziału POS i ustawić odpowiednie centra na zakładce [Miejsca w strukturze firmy], jeśli promocja taka nie powinna być wysyłana. Bez względu na ustawienie parametru Pomiń rabaty nagłówka (GLO) na definicji promocji pakietowej, w Comarch POS rabaty nagłówka są zawsze pomijane. Promocje pakietowe nie łączą się z innymi rabatami. W module rabatowym POS brak dla gratisów odpowiednika opcji Mnóż. Wszystkie gratisy będą traktowane tak, jakby opcja Mnóż był zaznaczona. Brak w module rabatowym również opcji Edycja ilości wydawanych gratisów, dlatego opcja ta będzie ignorowana. Brak opcji Wymagany w Comarch ERP XL, która jest dostępna w Comarch POS, jest natomiast parametr Domyślny. Parametr Domyślny będzie traktowany w Comarch POS jako wymagany, czyli do spełnienia warunków pakietu konieczne będzie dodanie do koszyka gratisu określonego jako domyślny. Gratis, który nie będzie oznaczony jako domyślny nie będzie konieczny do naliczenia pakietu. Pakiet nie zostanie naliczony, gdy towar zostanie dodany w innej jednostce niż podstawowa. Pakiet zostanie naliczony, ale nie zostaną uwzględnione przeliczniki towaru, co oznacza, że stała cena dla jednostki pomocniczej będzie taka sama jak dla podstawowej, a próg będzie spełniony przy analogicznej ilości jednostek pomocniczych jak podstawowych. Zaznaczenie parametru Wymagany na pozycji promocji elastycznej nie będzie respektowane w Comarch POS, to oznacza, że promocja zostanie naliczona nawet wówczas, gdy wymagany towar nie zostanie dodany do dokumentu.

Informacja o pakiecie na dokumentach importowanych z Comarch POS

Na dokumentach importowanych z POS widoczna będzie informacja o zastosowanym pakiecie, a pozycje wchodzące w skład pakietu będą stosownie oznaczone. Również w oknie Struktura udzielonego rabatu prezentowana będzie informacja o pakietach oraz strukturze rabatu.

Przesyłanie promocji progowych typu stała cena

Umożliwiono przesyłanie rabatów progowych typu stała cena, czyli promocji, gdzie dla danego towaru ustalono różne ceny w zależności od progu. Nie jest jednak możliwe przesyłanie promocji mieszanych, czyli takich, gdzie dla jednego progu ustalono rabat a dla innego stałą cenę w ramach tej samej promocji. Dla poszczególnych progów typ ceny powinien być taki sam, jeśli na jednym z progów zostanie ustawiony typ netto a na innym brutto to dla wszystkich cen stałych w tej promocji zostanie ustalony typ jak na pierwszej pozycji. Ograniczenia te wynikają z różnic w działaniu modułu rabatowego w obu systemach.

Naliczanie rabatów od promocji typu stała cena

Istnieje możliwość naliczania dodatkowych rabatów do promocji typu stała cena. Zależy to od parametru globalnego ustawianego w konfiguracji systemu System/ Konfiguracja /Sprzedaż /Rabaty i promocje Naliczaj inne promocje/ rabaty.

Jeśli parametr nie zostanie zaznaczony wówczas ustalona stała cena, będzie ceną ostateczną i nie będą miały do niej zastosowania inne promocje. Jeśli parametr zostanie zaznaczony wówczas naliczanie kolejnych promocji będzie uzależnione od ustawienia parametru Pomiń następne promocje dostępnego na zakładce [Ogólne] promocji.

Uwaga

Do Comarch POS nie są wysyłane informacje na temat Limitów oraz Wymaganego progu transakcji zapisane na elementach promocji. Rabat taki zadziała na stanowisku Comarch POS bez względu na ustawienia tych parametrów. Jeśli ustawienia te są wymagane, wówczas nie należy wysyłać takich rabatów do oddziału Comarch POS.

Pytania i odpowiedzi

Czy można wystawić korektę do Paragonu do którego jest wystawiona Faktura? Rozwiązanie do wersji wcześniejszych niż ERP XL 2024. 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. Można skorzystać z rozwiązania zastępczego: Sposób A  Sposób B Sposób C Na tę okoliczność można zdefiniować rejestr K/B o nazwie Rejestr zwrotów na POS i w nim rejestrować zwroty kasy Klientowi – dodać opis w polityce rachunkowości Czy z poziomu POS można zafiskalizować fakturę? Jeśli istnieje konieczność zafiskalizowania FS w POS należy zmodyfikować procedurę aby zwracała True dla tego parametru. Ustawienie jest przesyłane z procedury [CDN].[POS_EksportUstawienia], pole cast('False' as nvarchar(max)) as [PrintInvoicesOnReceiptPrinter], jest ustawione na sztywno jako False. Czy POS we współpracy z XL obsługuje artykuły typu- usługa? Aby zwykły towar był widoczny w POS musi mieć założoną partię. natomiast od wersji ERP XL 2022.1 umożliwiono przesyłanie kart towarowych o typie usługa. 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. Blokada sprzedaży z cena 0,00. Blokada synchronizacji bazy przez inne stanowisko Została nałożona blokada synchronizacji z bazą Comarch POS, która była już używana przez inne stanowisko, pole PSA_GUID w tabeli cdn.PicoStanowiska. 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. 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 Zmiana mechanizmu pobierania zasobów pomiędzy Comrch POS-ERP XL Dodano ustawialne w CDN.Konfig w polu i Kon_Numer = -153, w przypadku wartości 0 System działa na dotychczasowych zasadach, gdy wartość zostanie zmieniona System będzie pobierał zasoby według ustawienia z karty towaru FIFO/LIFO, będą ignorowane partie wskazane w Comarch POS.

Numer błędu i komunikat	Przyczyna	Rozwiązanie
XLDodajRaport zwróciła błąd:-1	Najprawdopodobniej została wycięta sesja operatora, na którego założona na którego ustawiona jest synchronizacja	W tabeli Documents.TradeDocumentsdla pola WasSentToERP ustawić wartość 0 dla tych dokumentów które nie przeszły i wykonać restart usługi synchronizacji.
XLOtworzRaport zwróciła błąd:8148	błędna data otwarcia pokrywa się z innym raportem	Należy zmodyfikować daty na raporcie
XLZamknijRaport zwróciła błąd:8034	komunikat wskazuje, że raport został już zamknięty	Należy otworzyć raport, aby dokumenty przeszły do XLa
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/
XLLogin zwrócił błąd:-3	Niepoprawnie wystartowała usługa do synchronizacji Nie podano nazwy programu	Można ponownie podłączyć bazę w Menedżerze Baz, uruchamiając CDNMGR spod prawego jako administrator, kolejno podłączyć bazę po autoryzacji na serwerze sql, dostępną dla wszystkich użytkowników. Należy usunąć usługę i dodać ją ponownie.
XLLogin zwróciła błąd:-6	Niepoprawnie wystartowała usługa do synchronizacji Nie podano hasła lub brak operatora -na stanowisku nie było logowania do XLa na operatora do synchronizacji, a w między czasie mogło zostać zmienione hasło do Xla (związane z błędem w TFS=432188, gdy usługa tworzona jest na inne konto domenowe niż zalogowany użytkownik) -TFS=443789 błąd w działaniu jednej usługi na kilku oddziałach	- błędne hasło na operatorze do synchronizacji przy tworzeniu usługi i na operatorze na oddziale zakładka Synchronizacja -błędna ścieżka w Path - centrum domyślne wskazane jako centrum oddziałowe, a powinno być centrum XL nie powiązane z oddziałem
XLNowyDokument zwróciła błąd:-39	- Wystąpił niezidentyfikowany Błąd najprawdopodobniej jest spowodowany złym działaniem otoczenia programu, niestandardowe triggery lub dodatki.	Należy zweryfikować niestandardowe triggery i dodatki na bazie oraz ponowić synchronizacje dokumentu
XLNowyDokument zwróciła błąd:33	Nie udało się wymusić numeru dokumentu. Numer dokumentu, który wyświetlany jest w POS (seria i numeru) może jest już dodany do XL Usługa synchronizacji ustawiona jest dla kilku oddziałów, na zakładce synchronizacja dla każdego oddziału powinna mieć wskazanego innego operatora, jeśli będzie ten sam pojawi się komunikat w logach XLNowyDokument zwróciła błąd:33	Nazwy dokumentów w POS znajdują się w NumberString w tabeli Documents.TradeDocuments. W XL można odfiltrować cdn.TraNag po serii POSowej w TrN_TrNSeria i numerze TrN_TrNNumer . Zmiana operatora na oddziale zakładka synchronizacja, moduł musi zostać uruchomiony jako administrator, aby zmienić operatora i hasło
XLNowyDokument zwróciła błąd:66	-Próba wystawienia korekty do dokumentu, który nie może być korygowany, błąd	Do takiego dokumentu nie można wygenerować korekty
XLNowyDokument zwróciła błąd:71	-Oryginał korekty w buforze	Należy sprawdzić czy dokument do którego generowana jest korekta w XLu nie jest w buforze, jeśli tak i płatność została dodana można taki dokument zatwierdzić w XLu i ponowić synchronizacje korekty
XLNowyDokument zwróciła błąd:81	-Brak licencji (nie udało się pobrać licencji a wymagana przez procedurę)	Należy sprawdzić czy są dostępne licencje na kluczu następnie wykonać restart usługi synchronizacji
XLNowyDokument zwróciła błąd:234	-Brak uprawnień do wystawiania tego typu dokumentu (NowyDokument-234). - Brak uprawnień; ustawienie na definicji dokumentu, problem z magazynem lub serią. - Zakaz na operatorze do wystawiania dokumentu	Należy sprawdzić wskazane uprawnienia
XLOtworzDokument zwróciła błąd:122	- Dokument jest edytowany na innym stanowisku	Należy sprawdzić czy dokument nie jest wyświetlony na czerwono w XLu
XLOtworzDokument zwróciła błąd:339	Błąd podczas ponownej fiskalizacji dokumentu handlowego - Niezidentyfikowany błąd (problem związany z ponowną fiskalizacją)	Wykonano ponowna fiskalizację dokumentu
XLZamknijDokument zwróciła błąd:-1	Błąd może mieć różne przyczyny: -Wskazuje na błąd wersji API bądź API nie zostało aktywowane - problem z fiskalizacją, jeżeli fiskalizacja z jakichś powodów się nie powiedzie Błąd TFS=403898 W przypadku, gdy była wykonana ponowa fiskalizacja dokumentu w POS, pojawiał się komunikat w logach Wystąpił błąd podczas ponownej fiskalizacji dokumentu handlowego	Sprawdzić ścieżkę Path czy na pierwszym miejscu jest do tej wersji, z której aktualnie korzystamy (jeśli nastąpi zmiana ścieżki wymagany jest restart komputera) TFS nieprawidłowość naprawiona w wersji od 2020.1.0
XLZamknijDokument zwróciła błąd:106	-Wystąpił DeadLock (błąd DeadLock zgłaszany jest przez serwer bazy danych, gdy nie może zrealizować zleconego zadania obsługa tego typu błędu polega najczęściej na ponownym wywołaniu procedury)	Należy ponowić synchronizacje dokumentu
XLDodajPozycje zwróciła błąd:17	Zabrakło ilości (przy trybie wsadowym musi być w pełni zaspokojona) Brak ilości na dany towar	-Aby dokument przeszedł do XL na oddziale należy zaznaczyć Generuj PW na brakujące towary - należy zwrócić uwagę czy towar nie ma wprowadzonej daty ważności. Zasób z inną datą ważności jest inną partią, co widać w tabeli cdn.TwrPartie, gdzie pozycje o różnym TPa_DataW są oddzielnie wykazane. - czy są dostępne ilości handlowe-partie na te towary z paragonów, czyli z uwzględnieniem cechy, EAN-u, daty ważności
XL ZmienAdres zwróciła błąd:53	Podano niepoprawny kod pocztowy. Dla kontrahenta krajowego kod pocztowy powinien mieć postać ##-### Wskazuje na błędny format kodu pocztowego. Nie można zapisać dokumentu bez miasta NIPu i nazwy	Jeśli będą wpisy; że nie odnaleziono aby taki kontrahent miał taki GUID, należy np. na jednym z tych dokumentów, który nie przechodzi sprawdzić jaki jest wybrany kontrahent potem w cdn.KntKarty wykonać update na ten guid który jest podany w logu pola KnT_GuidDane (jeśli dokument jest w XLu w buforze to go usunąć i wykonać dla tego dokumentu update na tabeli Documents.TradeDocuments WasSenttoERP=0)

Inne błędy :

1. Błąd przy pierwszej synchronizacji Brak kodu stanowiska w konfiguracji

08:32:48.7414 ERROR ---------EXCEPTION OCCURED---------: Brak kodu stanowiska w konfiguracji. Comarch.POS.Library.Errors.RetailInvalidPosStationException w Comarch.POS.Presentation.Base.ViewModels.StartScreen.StartScreenViewModel.ValidatePosCode() w Comarch.POS.Presentation.Base.ViewModels.StartScreen.StartScreenViewModel.InitialAsyncOperations(CancellationToken token, Object o) w Comarch.POS.Library.Models.Async`1.<>c__DisplayClass28_0.MvW8ZbA6l2() w System.Threading.Tasks.Task`1.InnerInvoke() w System.Threading.Tasks.Task.Execute() --------------------- 08:33:08.8110 INFO [NOTIFICATION] Uzyskano połączenie z usługą danych POS, kod stanowiska jest poprawny 08:33:23.1080 INFO [SETTINGS] Changes confirmed(Login was set to sa; ) 08:33:23.1080 INFO Closing view DbConfigurationView Należy zweryfikować:

2. Przy wyłączonym parametrze generuj PW na brakujące towary mimo dostępnej ilości towaru generuje się PW:

Należy zweryfikować:

3. Wystąpił błąd podczas importu dokumentu handlowego (…). W bazie XL nie znaleziono kontrahenta. Knt_GuidDane=…

Należy zweryfikować: update Entities.Customers set WasSentToERP=0, IsDefault=0 where Id=… update Addresses.AddressHeaders set WasSentToERP=0, IsDefault=0 where Id=… update Documents.TradeDocuments set WasSentToERP=0 where Id=…

4. Brak widoczności przyczyn korekty sprzedaży w POS

Należy zweryfikować:

Wykresy – uwagi ogólne

Wykresy umożliwiają stworzenie jednolitego, spójnego mechanizmu pozwalającego m.in. na wygodne definiowanie wykresów (inaczej: analiz) prezentujących graficznie i/albo tabelarycznie wybrane dane z bazy, podłączanie wykresów w przewidzianych (przez programistę) punktach programu i wykonywanie. Wykresy posiadają cechę aktywności.

Integracja modułu wykresów z resztą systemu polega na udostępnieniu przez moduł wykresów mechanizmu podobnego, jak w przypadku wydruków. Przyciski związane z wykresami działają kontekstowo: w momencie wykonania na nich akcji przez użytkownika najpierw zostają odczytane aktualne dane kontekstu wywołania, a następnie, w oparciu o te dane, zostaje wykonana akcja.

Z punktu widzenia użytkownika wykresy są zwykle dostępne w tych samych punktach programu (tzw. punkty wywołania wykresów, w skrócie: wywołania), co wydruki. Do każdego wywołania można podłączyć dowolną ilość wykresów (tzw. wykresów startowych), z których jeden jest domyślny (domyślność wykresów można zmieniać przez przełączanie specjalnej flagi określonej na poziomie podłączenia a w przypadku nie ustawienia tej flagi na żadnym z wykresów startowych domyślnym wykresem jest pierwszy w kolejności lp. – kolejność tą można zmieniać wykorzystując mechanizm bąbelkowania).

Wykresy mogą być zagnieżdżane tzn. każdy wykres może mieć dowolną ilość podłączonych do niego (pod)wykresów (dzieci). Z drugiej strony ten sam wykres może być równocześnie podłączony do dowolnej ilości (nad)wykresów (ojcowie). Zagnieżdżanie wykresów może zawierać zapętlenia, tzn. wykres A może mieć podwykres B, który z kolei posiada podwykres A (co więcej, wykres może być podłączony nawet do samego siebie).

Edycja (dodawanie, modyfikacja, testowanie, usuwanie) wykresów, ich podłączanie (także warunkowe) do wywołań oraz do siebie nawzajem, ustalanie domyślności i kolejności, a także różne inne operacje są dostępne z poziomu specjalnego drzewa hierarchii wykresów.

Wykresy, podobnie jak wydruki, są podzielone na dwie grupy:

To czy wykres jest wykresem standardowym czy użytkownika określamy mianem: bazy wykresu.

Edycja wykresów standardowych przez użytkownika jest bardzo ograniczona – sprowadza się do zmiany dostępności wykresu (globalny / operatora lub stanowiska), zmiany ustawień opcji wysyłania wyniku oraz przełączania domyślności wykresów.

Wyniki wykonania wykresów (ich graficzna postać i/albo dane tabelaryczne składające się na serie danych wykresu) są umieszczane na specjalnym oknie wynikowym analiz. Okno to stanowi dla użytkownika właściwe środowisko pracy z analizami. To tu użytkownik widzi wyniki analizy, może zmieniać parametry i przeliczać wykres, tu także może nawigować po grafie wykresów (eksplorować wykresy, czyli przechodzić do podwykresów i wracać z powrotem) i wykonywać inne, pomocnicze operacje (np. drukowanie wyników, ich zapis do pliku w wybranym formacie czy wysyłanie wyników do innych programów).

Wykresy – cechy

Aktywność

Aktywność wykresu polega na możliwości jego interakcji z użytkownikiem, w tym także na możliwości wykonania wykresu podrzędnego po kliknięciu przez użytkownika w wybrany punkt. Interakcja następuje po wykonaniu przez użytkownika odpowiedniej akcji na bieżącym wykresie i może mieć postać:

Wykresy startowe, domyślny i bieżący wykres startowy

Do każdego wywołania można podłączyć dowolną ilość wykresów – są to tzw. wykresy startowe danego wywołania. Wykresy te są odpowiednio posortowane (wg lp) a jeden z nich jest domyślnym wykresem startowym danego wywołania. Domyślność wykresu oznacza dla użytkownika najprostszą możliwość wykonania wykresu – poprzez jeden klik lewym przyciskiem myszy w główny przycisk analiz. Każdy inny wykres startowy w tym punkcie może być wykonany tylko poprzez jego wybór z menu kontekstowego.

Określanie domyślnego wykresu startowego danego punktu wywołania przebiega wg następującego algorytmu:

1.Sprawdzamy czy do wywołania (np. kontekstu) jest podłączony wykres użytkownika z zaznaczoną flagą: Domyślny. Jeśli tak – wykres ten jest domyślnym wykresem startowym – kończymy poszukiwanie.

Jeśli nie:

2.Sprawdzamy czy do kolejnych gałęzi nadrzędnych wywołania (np. procedury, potem roota) jest podłączony wykres użytkownika z zaznaczoną flagą: Domyślny. Jeśli tak – wykres ten jest domyślnym wykresem startowym – kończymy poszukiwanie.

Jeśli nie:

3. Sprawdzamy czy do wywołania (np. kontekstu) jest podłączony wykres standardowy z zaznaczoną flagą: Domyślny. Jeśli tak – wykres ten jest domyślnym wykresem startowym – kończymy poszukiwanie.

Jeśli nie:

4. Sprawdzamy czy do kolejnych gałęzi nadrzędnych wywołania (np. procedury, potem roota) jest podłączony wykres standardowy z zaznaczoną flagą: Domyślny. Jeśli tak – wykres ten jest domyślnym wykresem startowym – kończymy poszukiwanie.

Jeśli nie:

5. Pobieramy pierwszy w kolejności lp wykres startowy użytkownika podłączony do wywołania, a w przypadku jego braku do kolejnych gałęzi nadrzędnych wywołania. Jeśli taki wykres znajdziemy – wykres ten jest domyślnym wykresem startowym – kończymy poszukiwanie.

Jeśli nie:

6. Pobieramy pierwszy w kolejności lp wykres startowy standardowy podłączony do wywołania, a w przypadku jego braku do kolejnych gałęzi nadrzędnych wywołania. Jeśli taki wykres znajdziemy – wykres ten jest domyślnym wykresem startowym – kończymy poszukiwanie.

Obsługa przycisków wykresu jest analogiczna jak w przypadku wydruków; do wyboru są trzy akcje:

Po wykonaniu domyślnego lub wybranego wykresu startowego jest otwierane okno wynikowe analiz. Obiekt wykresu po aktywacji (otwarcie okna z wykresem) widzi tylko węzeł narysowanego wykresu a więc, mimo że do danego wywołania możemy mieć podłączoną dowolną ilość wykresów startowych – tylko jeden z nich jest bieżącym wykresem startowym.

Wykresy startowe mogą być filtrowane przez zastosowanie dynamicznych warunków, które decydują czy w danej sytuacji (przy bieżących ustawieniach przez aplikację zmiennych występujących w warunku podłączenia wykresu) dany wykres startowy ma być widoczny w danym kontekście czy też nie. W warunkach można umieszczać zmienne i funkcje zabindowane przez aplikację (moduł wykresów nie robi PUSHBIND) a także standardowe funkcje Clariona (np. Today()).

Zagnieżdżanie wykresów

Każdy wykres (w szczególności także wykresy startowe dla danego wywołania) może mieć dowolną ilość wykresów podrzędnych (podwykresów), podłączonych do niego w uporządkowany sposób; jeden z tych podwykresów jest traktowany jako domyślny (decyduje ustawienie flagi: Domyślny podłączenia a w przypadku jej wyzerowania dla wszystkich podwykresów - kolejność podwykresów wg lp; kolejność tą można zmieniać na drzewie hierarchii wykresów używając mechanizmu bąbelkowania).

Z drugiej strony każdy wykres może być podłączony do dowolnej ilości wykresów nadrzędnych w stosunku do niego.

Nie ma tu ograniczenia, aby wykresy „nie zapętlały się” tzn. aby dla żadnego łańcucha wykresów nie zachodziła sytuacja, że jakiś wykres występuje w tym łańcuchu więcej niż jeden raz.

Graf wykresów – nawigacja w czasie wykonywania

Ciąg wykonań wykresów danego punktu wywołania, począwszy od bieżącego wykresu startowego nazywamy historią wykonań wykresów. Zapis wykonania wykresu do historii następuje przy wczytywaniu bieżącego wykresu startowego a następnie przy wykonywaniu akcji: Eksploruj. W odpowiednich zmiennych zapamiętywane są dane pozwalające odtworzyć wyświetlony uprzednio wykres w niezmienionej postaci (z dokładnością do zmian wynikających z odświeżenia wyników); dane te, to oczywiście zapytanie i wartości parametrów ostatnio użyte w tych zapytaniach oraz ostatnie wartości parametrów graficznych. Na każdym wykresie (poza bieżącym startowym dla opcji: Na początek), na specjalnych przyciskach, są dostępne dodatkowo cztery opcje: Na początek (powrót do bieżącego wykresu startowego), Wstecz (powrót do poprzednio wykonanego wykresu), Wprzód (przejście do następnego „historycznie” wykresu) i Na koniec (przejście do ostatniego „historycznie” wykresu).

Opcja: Wstecz (także: Na początek) nie pojawia się w przypadku, gdy jesteśmy na bieżącym wykresie startowym. Wszystkie parametry wykresu (z zapytania i graficzne), do którego się cofamy są odtwarzane na podstawie odpowiednich zmiennych, ale dane wykresu są przeładowywane.

Analogiczne uwagi dotyczą opcji: Wprzód, którą dodatkowo trzeba odróżniać od opcji: Eksploruj, także w tym sensie, że nawet, jeśli opcja: Wprzód, powoduje przejście do podrzędnego wykresu (tak jak opcja: Eksploruj), to po pierwsze niekoniecznie jest to ten sam wykres podrzędny (jeśli jest ich więcej) a po drugie opcja: Eksploruj, dotyczy klikniętego w momencie jej wybrania punktu, a opcja: Wprzód, bierze pod uwagę punkt poprzednio kliknięty, tj. kliknięty w trakcie wykonywania opcji: Eksploruj, które wprowadziło dany wykres do historii.

Uwaga

Zapisujemy do kolejki historii tylko bieżący wykres startowy i eksploracje (każdą). Cofanie ani posuwanie się wprzód nie dopisuje do kolejki rekordów, a tylko przesuwa pointer wskazujący bieżącą pozycję. Eksploracja usuwa wszystkie rekordy z kolejki historii będące „po rekordzie” odpowiadającym eksplorowanemu wykresowi, dopisuje rekord docelowego podwykresu i ustawia na nim pointer. Powoduje to „zapominanie” części historii po wykonaniu eksploracji, ale jest to standardowe zachowanie

Edycja wykresów

Do wygodnego podłączania wykresów startowych do wywołań oraz wykresów do wykresów (zagnieżdżanie) zostało utworzone specjalne wielopoziomowe drzewo (korzeń, procedura, kontekst, wykresy startowe, wykresy podrzędne). Poza podstawowymi operacjami takimi jak dodawanie, podłączanie i odłączanie wykresów, ich edycja (w tym testowanie) i usuwanie dostępne są także różne funkcje pomocnicze, np. włączanie/wyłączanie flagi domyślności, bąbelkowanie, szukanie wykresu zawierającego w definicji podany ciąg znaków i inne.

Źródła danych do wykresów

Zapytanie SQL i dane w bazie

Jest to podstawowy rodzaj źródła danych dla wykresów.

Przez zapytanie rozumiemy tu ciąg dowolnych (niezmieniających struktury ani zawartości bazy danych) instrukcji T-SQL, w którym ostatnią jest instrukcja SELECT o strukturze zgodnej ze strukturą specjalnej kolejki z danymi, predefiniowanej w module Prefix_GRPH:

t_op_qWykresyDane QUEUE,TYPE

Id LONG !ID punktu, służy do jednoznacznej identyfikacji punktu wykresu

nX DECIMAL(20,4) !Wartość X punktu (dla wykresów nie ‘XY’ równa ID)

sNazwa STRING(50) !Nazwa punktu (dla wykresów ‘XY’ równa nX)

nY DECIMAL(20,4) !Wartość Y punktu

sW1 STRING(255) !Inne dane punktu, wartość 1

...

sW20 STRING(255) !Inne dane punktu, wartość 20

END

Struktura ta, w przypadku gdy mamy do czynienia z prawdziwym wykresem a nie tylko z tabelą wynikową, nakłada pewne ograniczenia na typy i zawartość pierwszych trzech kolumn zapytania:

W przypadku wykresów typu: tylko tabela, powyższe ograniczenia nie obowiązują.

Zapytanie nie musi zwracać wszystkich wartości w kolejce t_op_qWykresyDane - ważna jest tylko zgodność typów poszczególnych kolumn (z dokładnością do clarionowej konwersji typów) i zgodność merytoryczna (np. druga kolumna zapytania powinna określać wartości na osi X a czwarta – wartości na osi Y, chyba, że w parametrach graficznych umieszczono jawnie parametr /@Series określający kolumnę/kolumny zapytania stanowiącą/ce źródło wartości osi Y).

Przyklad

Zapytanie SELECT BRa_Akronim, BRa_BraID, Bra_SaldoBO, Bra_Symbol FROM cdn.BnkRachunki spowoduje, że wartości akronimów zostaną wpisane do kolumny typu LONG a jako wartości punktów zostanie podstawione zero (konwersja Bra_Symbol do DECIMAL(20,4)).

Wszystkie kolumny zwracane przez SELECT muszą być nazwane. Jeśli więc w liście tej występują agregaty lub stałe – należy koniecznie użyć aliasów (np. SELECT PunktID=1, TrN_TrNID, TrN_NumerPelny, RazemNetto=SUM(TrE_WartoscNetto) FROM ... ).

Zapytanie jest wykonywane przez ADO. Rezygnacja z klasy SqlQuery na rzecz ADO ma miejsce z dwóch powodów:

W tekście zapytania w definicji wykresu mogą występować tzw. parametry dynamiczne, których wartości są wyliczane i wstawiane w miejsce definicji (odwołań do) tych parametrów przed przesłaniem wynikowego zapytania na serwer. Poza parametrami dynamicznymi w zapytaniu można umieszczać wyrażenia, zmienne tekstowe, wstawki tekstowe i wiele innych konstrukcji, które przed podaniem zapytania do serwera SQL są rozwijane bądź wyliczane i podstawiane wartościami. Język użyty w zapytaniu wykresu jest połączeniem T-SQL i specjalnego języka obsługi parametrów dynamicznych, tzw. DPL.

Wynika stąd wiele możliwości, np. komentarze w zapytaniu wykresu mogą być wstawiane jako komentarze SQL-owe: -- (jednak język DPL nie interpretuje komentarzy SQL-owych stąd też np. wstawienie odwołania do parametru dynamicznego w komentarzu SQL spowoduje wstawienie wartości tego parametru do zapytania przed wysłaniem go na serwer ale nie ma to oczywiście wpływu na wynik zapytania).

Kolejka globalna wypełniona przez aplikację

Dane serii wykresu mogą także pochodzić ze specjalnych kolejek globalnych wypełnianych przez aplikację w różny sposób. Ma to miejsce w przypadkach, gdy aplikacja dysponuje już danymi (często uzyskanymi w inny sposób niż wykonanie instrukcji SQL-owych; np. niektóre browsy po kolejce). Kolejki te są wypełniane przez aplikację a następnie przepisywane przez obiekt wykresu do wewnętrznej kolejki wynikowej (property wskaźnika na kolejkę o strukturze t_op_qWykresyDane) przed wykonaniem wykresu.

Wywołanie procedury

Wykonanie wykresu może polegać nie tylko na uzyskaniu wyników i ich graficznej i/albo tabelarycznej prezentacji (wykresy normalne / wykresy typu: tylko tabela), ale także na wywołaniu procedury (tzw. drill-trough). W tym przypadku składnia zapytania nie ma nic wspólnego z SQL-em – wywołanie procedury następuje zgodnie ze składnią języka DPL.

Parametry dynamiczne wykresów

Parametrem dynamicznym wykresu (w skrócie: parametrem) nazywamy zmienną występującą w zapytaniu lub parametrach graficznych (można np. sparametryzować tytuł wykresu), której wartość jest ustalana i wstawiana w miejsce definicji parametru w czasie wykonywania wykresu (tzw. runtime).

Przed wykonaniem bieżącego wykresu startowego lub potomnego po raz pierwszy w danej sesji wywołania obiekt przeszukuje zapytanie i parametry graficzne wykresu w poszukiwaniu parametrów dynamicznych. Po znalezieniu wszystkich parametrów, przed wykonaniem wykresu obiekt stara się ustalić ich wartości:

Wszystkie parametry danego wykresu, łącznie z ustalonymi wartościami zapisywane są w odpowiedniej kolejce. Na podstawie tej kolejki kreowane są dynamicznie kontrolki parametrów i od razu rysowany wykres.

Przed wykonaniem wykresu, który już wcześniej został wczytany (Na początek, Wstecz, Wprzód Na koniec, Odśwież) następuje wykreowanie kontrolek parametrów tego wykresu z wartościami ostatnio użytymi i narysowanie wykresu w oparciu o te wartości. Teraz użytkownik może manipulować wartościami parametrów poprzez kontrolki – wartości te są zapisywane do kolejki w momencie wykonania akcji: Odśwież.

Zmienne dynamiczne przekazywane z aplikacji do bieżącego wykresu startowego

Zmienne dynamiczne mają za zadanie zainicjalizować wybrane parametry dynamiczne wykresu wartościami przekazanymi z aplikacji. Wartości tych zmiennych są ustalane w czasie wykonywania programu (runtime) i przesyłane do bieżącego wykresu startowego.

Klasa wykresów korzysta z przekazanych jej zmiennych dynamicznych przy ustalaniu wartości początkowych parametrów dynamicznych zapytania i grafiki bieżącego wykresu startowego (nadpisanie wartości początkowych odczytanych z definicji parametru). Wiązanie parametru ze zmienną odbywa się po nazwie.

 

Przyklad

Zmienne dynamiczne są podstawiane pod parametry dynamiczne tylko dla bieżącego wykresu startowego (nie dotyczą podwykresów – tam występuje dziedziczenie wartości parametrów o zgodnej nazwie)

Wyrażenia

Wyrażenia to ciągi znaków występujące w zapytaniach oraz w parametrach graficznych wykresu ewaluowane (czyli takie, których wartości są obliczane) clarionową instrukcją EVALUATE przed wykonaniem wykresu. W wyrażeniach mogą występować m.in. odwołania do parametrów dynamicznych, a także funkcje systemowe clarionowe oraz zabindowane w Clarionie zmienne i funkcje. Wyrażeń używa bardzo często do określania wartości początkowych parametrów dynamicznych (np. bieżąca data).

Składnia wyrażenia jest następująca:

{ciąg_znaków} (W)

Makra

Przed parsowaniem zapytania i parametrów graficznych wykresu w poszukiwaniu parametrów dynamicznych jest przeprowadzany tzw. preparsing polegający na znalezieniu i rozwinięciu makr występujących w zapytaniu. Makro jest specjalnym ciągiem znaków, który jest rozpoznawany przez preparser i zamieniany na tzw. rozwinięcie makra. Najczęściej makra są rozwijane do definicji parametrów dynamicznych, szczególnie do lookupów. Pozwala to w prosty, szybki i standardowy sposób definiować podobne lub identyczne parametry w różnych zapytaniach. Obecnie jednak do tworzenia deklaracji/definicji lookupów (oraz innych parametrów dynamicznych) zamiast makr zalecane jest stosowanie wizardów.

Preparser jest w praktyce metodą klasy operującej na parametrach dynamicznych. Metoda ta jest wirtualna, co pozwala rozwijać makra w sposób zależny od różnych uwarunkowań, np. od projektu (Optima, XL itp.). Ze względu na wirtualność preparsera nie można zdefiniować ogólnej składni makra – może ona być różna dla różnych przegięć metody. Możemy jednak podać składnię makra, jaka obowiązuje w preparserze Opt!my:

@MAKRO(Typ,Kod,Default) (MD)

Makra z Szybkich Raportów

Przed rozwijaniem makr opisanych poprzednio zapytanie wykresu jest przeszukiwane pod kątem występowania w nim specjalnych sekwencji używanych przez Szybkie Raporty XL. Sekwencje te są odpowiednio rozwijane:

{FILTRSQL} Jest rozwijane do wartości wpisanej przez programistę w template GraphButton-a i przechowywanej w dodatkowym property GraphManagerClass.sFiltrSQL (jeśli puste – rozwija się do ‘1=1’)

{FILTRLINK} Jest rozwijane do wartości wpisanej przez programistę w template GraphButton-a i przechowywanej w dodatkowym property GraphManagerClass.sFiltrLink (jeśli puste – rozwija się do ‘1=1’)

{OPCJEAPP} Jest rozwijane do wartości wpisanej przez programistę w template GraphButton-a i przechowywanej w dodatkowym property GraphManagerClass.cOpcjeApp.

Oczywiście rozwijanie makr SR nie ma większego sensu w przypadku podwykresów (szybkich raportów nie można było zagnieżdżać). Jednak, jeśli ktoś świadomie umieścił takie makro w zapytaniu to trzeba je rozwinąć (na odpowiedzialność użytkownika).

Predefiniowane wstawki tekstowe

Wstawki tekstowe

Stosując predefiniowane wstawki tekstowe, zmiana jakiejkolwiek własności kontrolki powoduje zmianę w jednym miejscu (nie ma potrzeby dokonywania zmian we wszystkich odpowiednich wykresach). Dzięki temu powtarzające się w wielu miejscach analogiczne kontrolki występują tak samo. Podobnie ma się rzecz, jeśli chodzi o parametry graficzne, które, poza tytułem, typem wykresu i wyborem serii powinny być w zasadzie identyczne dla wszystkich wykresów.

Wyodrębnienie wspólnych części wykresów polega na tym, że jeżeli mamy kilka wykresów o bardzo podobnej konstrukcji (różniących się tylko detalami) to za pomocą predefiniowanych wstawek tekstowych można jak gdyby stworzyć jedną, sparametryzowaną definicję wykresu. Oczywiście, formalnie rzecz biorąc, definicji będzie kilka, tyle tylko, że będą one posiadały jedynie wywołanie odpowiedniej, wspólnej wstawki z różnymi parametrami.

Pierwszą czynnością, jaką wykonuje moduł wykresów po wczytaniu definicji wykresu z bazy, jeszcze przed podaniem tekstów (zapytanie i grafika) do preparsingu, jest poszukiwanie w tych tekstach deklaracji predefiniowanych wstawek tekstowych (PWT) i ich rozwijanie.

Deklaracja PWT w tekście zapytania bądź grafiki ma następującą składnię:

@INS Nazwa||[Parametry] [ParametryX] INS@ (PWT0)

gdzie Nazwa jest unikalną (w ramach bazy wykresu) nazwą wstawki (NO CASE) a opcjonalne człony Parametry i ParametryX posiadają następującą składnię:

Parametr[, Parametr...] (PWTP)

^NazwaParametruX=WartoscParametruX [^NazwaParametruX=WartoscParametruX,...] (PWTPX)

gdzie Parametr jest dowolnym ciągiem znaków (NO CASE) , niezawierającym przecinka (seperator parametrów), znaku ^ (definicja parametru typu X) ani ciągu znaków ‘ INS@’ (spacja, INS@ - terminator PWT). Parametry typu X muszą występować po parametrach zwykłych i nie mogą być z nimi wymieszane. Zostaną one omówione w dalszej części tego rozdziału.

Parametry są przekazywane do definicji wstawki i decydują o wstawianiu do niej tekstów warunkowych (patrz następny rozdział) i wstawek podrzędnych (tzw. podwstawek).

Definicja wstawki jest traktowana jak normalny tekst – wynika stąd, że wstawki mogą być zagnieżdżone. Deklaracja (pod)wstawki we wstawce ma postać:

@INS Nazwa|[Warunek]|[Parametry] INS@ (PPWT)

gdzie Nazwa jest unikalną (w ramach bazy wykresu) nazwą wstawki podrzędnej (NO CASE), a opcjonalny człon Warunek posiada następującą składnię:

Segment[,Segment...] (PWTW)

gdzie Segment jest dowolnym ciągiem znaków (NO CASE), nie zawierającym przecinka (seperator segmentów) ani ciągu znaków ‘INS@’ (spacja, INS@ - terminator PWT). Ponieważ podwstawka może zostać wywołana z parametrami (deklaracja w tekście nadrzędnym) – sprawdzamy czy parametry te spełniają Warunek wstawienia podwstawki. Jeśli Warunek jest spełniony - następuje zamiana deklaracji podwstawki na jej rozwinięcie, jeśli nie – usunięcie deklaracji podwstawki. Walidacja warunku odbywa się w następujący sposób:

jeśli Warunek jest pusty – uznaje się, że jest spełniony jeśli Warunek nie jest pusty – uznaje się, że jest spełniony, jeśli dla co najmniej jednego z jego członów (Segment) istnieje odpowiednik (równość NO CASE) wśród przekazanych do podwstawki parametrów zwykłych (nie typu X).

Uwaga

Przy rozwijaniu wstawki jej rozwinięcie pobierane jest z tej bazy (wykresów standardowych lub użytkownika), z której pobrano definicję wykresu. W przypadku nie znalezienia wstawki o podanej nazwie, jeśli mamy do czynienia z wykresem użytkownika, wstawka jest następnie poszukiwana w bazie wykresów standardowych

.

Teksty warunkowe

Tekst warunkowy jest dowolnym ciągiem znaków, który może zostać wstawiony do definicji wstawki przy spełnieniu określonych warunków.

Tekst warunkowy może występować jedynie w definicji predefiniowanej wstawki tekstowej a jego składnia jest następująca:

@IF(Warunek) Tekst IF@(TW)

gdzie Warunek jest analogiczny jak w definicji (PPWT) a Tekst jest dowolnym ciągiem znaków nie zawierającym sekwencji zakończenia ‘IF@’ (spacja, IF@). Ponieważ TW może występować jedynie w definicji PWT – są określone parametry przekazane do definicji PWT z jej deklaracji w tekście nadrzędnym. Parametry te pozwalają na walidację warunku Warunek (mechanizm dokładnie taki sam jak w przypadku PPWT).

Uzupełniającym elementem składni tekstu warunkowego jest zaprzeczony tekst warunkowy:

@IFNOT(Warunek) Tekst IFNOT@(TWNOT)

różni się on od TW tylko tym, że tekst jest wstawiany jeśli warunek jest pusty albo żaden jego człon nie ma odpowiednika wśród przekazanych parametrów.

Uwaga

Warto zwrócić uwagę na fakt, że przed sekwencją kończącą IF@ (IFNOT@) musi występować, co najmniej jedna spacja, zatem deklaracja: @IF(FAPA) xxx IF@ nie jest poprawna, gdyż bezpośrednio przed końcowym IF@ występuje enter zamiast spacji

Analogicznie do powyższych zostały wprowadzone teksty warunkowe:

@IFAND(Warunek) Tekst IFAND@ (TWAND)

oraz

@IFANDNOT(Warunek) Tekst IFANDNOT@ (TWANDNOT)

różniące się od opisanych jedynie sposobem sprawdzania Warunku, który w tym przypadku uważa się za spełniony tylko wtedy, gdy jest pusty lub dla wszystkich jego członów (Segment) istnieje odpowiednik (równość NO CASE) wśród przekazanych do podwstawki parametrów zwykłych (nie typu X).

Rozszerzone parametry tekstowe (parametry typu X)

Opisany wyżej mechanizm nie pozwala na parametryzowanie wstawek tekstowych. Przypuśćmy, że chcemy zdefiniować wstawkę wstawiającą zakres dat. Wstawki tej chcemy użyć zarówno w analizie a1 gdzie wartości domyślne dat mają być odpowiednio Today() i Today()+1 i w analizie a2 z wartościami domyślnymi Date(Month(Today()), 1, Year(Today())) i Today(). Aby wstawka mogła zrealizować oba te zadania – musi obsługiwać parametry rozszerzone.

Składnia rozszerzonego parametru tekstowego wstawianego do wstawki jest następująca:

@INSP(Nazwa) (INSP)

gdzie Nazwa jest nazwą parametru przekazanego z tekstu nadrzędnego (zapytania, grafiki bądź podwstawki).

Składnia przekazania w/w parametru tekstowego jest określona przez (PWTPX). We wzorze tym NazwaParametruX odpowiada Nazwie w (INSP) (równość jest typu NO CASE). Wartość parametru może być ustalona, ale może też zawierać element @INSP().

Parametry graficzne wykresu

Aby nie zmieniać struktury tabeli z wykresami przy dodawaniu w przyszłości obsługi kolejnych parametrów graficznych wprowadzamy jedną, parsowaną kolumnę stringową ParametryGraficzne. Kolumna ta powinna zawierać ustawienia wszystkich potrzebnych parametrów graficznych danego wykresu w postaci:

/@SymbolGr[=WartoscGr(BezApostrofów)] (PG)

gdzie SymbolGr jest nazwą parametru graficznego a WartoscGr jego wartością początkową. Kolumna ParametryGraficzne jest parsowana przez klasę przy wczytywaniu definicji wykresu i składana przy zapisie.

Opcjonalna wartość WartoscGr jest wartością parametru, z którą wykres jest rysowany pierwszy raz; wartość ta może zostać zmieniona w trakcie oglądania wykresu przez edycję odpowiedniej kontrolki dynamicznej, wykreowanej na podstawie parametru dynamicznego wykresu dotyczącego wartości danego parametru graficznego. Wartość WartoscGr może bowiem zawierać parametry dynamiczne.

W wartościach parametrów graficznych obu typów mogą występować wyrażenia.

Oto najważniejsze symbole dostępnych parametrów graficznych:

SymbolGr	Znaczenie	Wartości	D	PD	D(*)	PD(*)
HeaderName	Tytuł wykresu			1		1
XAxisName	Tytuł osi X			1		1
YAxisName	Tytuł osi Y			1		1
Type	Typ wykresu	1 – kolumnowy, 2 – liniowy, 4 – kołowy,...	1	1	1	1
Depth	Głębokość 3D	0 – wykres 2D, >0 – wykres 3D	0	1	100	1
LineWidth	Grubość linii	1-10 (dotyczy typu 2)	2	1		0
PointWidth	Grubość słupka	1-10 (dotyczy typu 1)		0		0
ShowDataLabels	Wyświetla wartości punktów	0 – nie pokazuje, 1 – pokazuje	1	1	1	1
Series	Definicje serii	Kol,...,Kol gdzie Kol,...,Kol - numery kolumn zapytania (4<=Kol<=11).	4	1	4	1
NoHeadOnCols	Wykaz kolumn, które mają nie mieć headera	Kol,...,Kol gdzie Kol,...,Kol - numery kolumn zapytania (1<=Kol<=11).		0		0
HideCols	Wykaz kolumn, które mają być ukryte (zerowej szerokości)	Kol,...,Kol gdzie Kol,...,Kol - numery kolumn zapytania (1<=Kol<=11).		0		0
AutoRefresh	Automatyczne odświeżanie	0 – nie, 1 – tak	0	1	1	1
SkipFirstExec	Nie wykonywanie akcji (zapytania, procedury) za pierwszym razem, dopiero po odświeżeniu. Dotyczy tylko wykresu startowego.	0 – wykonuj akcję także przy pierwszym wykonaniu wykresu, 1 – nie wykonuj akcji przy pierwszym wykonaniu wykresu (np. nie chcemy wykonywać zapytania z domyślnymi wartościami parametrów)	0	1	1	1

Default jest wartością, która jest podstawiana, gdy w parametrach graficznych dany parametr w ogóle nie występuje i PodstawDefault=1. Gdy w parametrach graficznych dany parametr w ogóle nie występuje i PodstawDefault=0, to wartość parametru nie jest w ogóle podstawiana. Default(*) jest wartością, która jest podstawiana, gdy w parametrach graficznych dany parametr występuje, ale nie ma podstawionej wartości (np. /@3D, /@PokazujEtykietyDanych) i PodstawDefault(*)=1. Gdy w parametrach graficznych dany parametr występuje, ale nie ma podstawionej wartości i PodstawDefault(*)=0, to wartość parametru nie jest w ogóle podstawiana. Boldem zaznaczono parametry graficzne niemające swoich odpowiedników we własnościach obiektu Insight.

Uwaga

Parametry NoHeadOnCols, HideCols, mimo że formalnie przynależą do parametrów graficznych – dotyczą tabeli z wynikami, a nie wykresu. Stąd nie należy się dziwić, że wykres typu: tylko tabela, ma aktywne pole z parametrami graficznymi.

Graficzne stałe symboliczne

Graficzne stałe symboliczne to stałe postaci @NAZWASTAŁEJ, występujące w parametrach graficznych wykresu, których wartości podstawiane są do parametrów graficznych przed narysowaniem wykresu, ale już po załadowaniu wyników. Poniższa tabela zawiera wszystkie obsługiwane w tej chwili stałe:

Nazwa stałej	Opis (wartość)
RECORDS	Zwraca ilość rekordów wyniku zapytania. Przykład użycia: /@ShowXLabelsEvery={@Records/3}

Uwaga

Nazwy stałych graficznych są CASE SENSITIVE.

Przekazywanie do wykresów zaznaczonych pozycji

Moduł analiz posiada możliwość odwoływania się do pozycji zaznaczonych na liście. Mogą to być nie tylko zaznaczenia na konkretnej liście, ale dowolny ciąg identyfikatorów rekordów, które to identyfikatory w dalszej części będziemy nazywać zaznaczeniami. Idea obsługi zaznaczeń jest następująca:

MANAGER WYKRESÓW.

Jeśli wykres jest zbudowany w oparciu o tabelę zaznaczeń (flaga na definicji wykresu), przed wykonaniem zapytania (w metodzie .Wykonaj) generuje unikalny, 50-znakowy GUID i zapisuje przekazane wcześniej z aplikacji zaznaczenia do SQL-owej tabeli WkrZaznaczenia2.

Wszystkie zapisywane rekordy mają ustawiony wspólny (wygenerowany wyżej) GUID (WkZ2_GUID). Wartość ta jest także przekazywana do wykresu za pośrednictwem parametru dynamicznego ZazGUID.

Identyfikator zaznaczonego rekordu zapisuje się w polach WkZ2_GIDTyp, WkZ2_GIDFirma, WkZ2_GIDNumer i WkZ2_GIDLp. W zależności od potrzeb można podstawić pełny GID (XL) lub tylko ID (Opt!ma); w tym drugim przypadku ID zaznaczonego rekordu podstawia się pod WkZ2_GIDNumer.

Po wykonaniu wykresu odpowiednie rekordy z tabeli WkrZaznaczenia2 są usuwane.

W procedurze, która dopuszcza obsługę wykresów z zaznaczeniami (najczęściej listy), przed wykonaniem wykresu (np. w przegięciu metody GraphButtonClass.ObliczParametry), następuje wywołanie metody:

GraphManagerClass.WypelnijKolejkeZaznaczen(ZaznaczoneQueue _qZaz)

z podaniem kolejki identyfikatorów (kolejka ta to najczęściej templatowa kolejka zaznaczeń browse’a).

PROGRAMISTA w tempalte GraphButton-a wpisuje nazwę kolejki z zaznaczeniami (dokładnie na takiej samej zasadzie jak w przypadku wydruków).

UŻYTKOWNIK ustawia na wykresie flagę: Wykres oparty o tabelę zaznaczeń (nowe pole w tabelach WkrDefinicje i WkrDefinicje2) oraz w definicji wykresu:

Deklaruje ukryty parametr dynamiczny @PAR ?@Hs50|ZazGUID|ZazGUID:’’ PAR@

W zapytaniu wykonuje JOIN do tabeli WkrZaznaczenia2 (np. ... JOIN WkrZaznaczenia2 ON BNa_BNaID = WkZ2_GIDNumer ...).

W filtrze zapytania umieszcza warunek na (odziedziczony ze zmiennej dynamicznej) GUID (WkZ2_GUID = ??_QZazGUID)

Wysyłanie wyników wykresu

Wyniki wykonania analizy (wykres w postaci graficznej oraz tabela z wynikami) są zawsze (o ile nie jest to wynik skalarny) zapisywane do pliku. Plik ten (tzw. plik wynikowy) może mieć jeden z następujących formatów:

COMMA (dane tabelaryczne)

Excel (dane tabelaryczne)

XML (dane tabelaryczne)

Jest tu możliwość zastosowania podanego szablonu XSL.

WMF (grafika)

W przypadku formatu COMMA istnieje możliwość dopisywania danych do istniejącego pliku.

W/w plik jest zapisywany z podaną nazwą (lub systemową nazwą tymczasową, jeśli nie podano nazwy docelowej) i w podanym katalogu (lub systemowym katalogu tymczasowym, jeśli nie podano katalogu docelowego).

Edycja wykresów

Formularz wykresu

Do edycji wykresu służy formularz definicji wykresu.

W oknie znajdują się przyciski:

[Testuj wykres] - służy do testowania edytowanego wykresu. Dokładniej przycisk ten służy do wykonania testu edytowanego wykresu z zastosowaniem bieżących ustawień na formularzu. Po jego naciśnięciu jest wykonywany w trybie testowym edytowany wykres. Tryb testowy polega na tym, że bezpośrednio przed przesłaniem zapytania na serwer zapytanie to (ze wstawionymi bieżącymi wartościami parametrów dynamicznych) jest podawane do edycji użytkownika. Po wykonaniu wykresu jest możliwa normalna nawigacja począwszy od węzła odpowiadającego edytowanemu wykresowi. Wykonaniu każdego wykresu w trybie testowym towarzyszy okno pozwalające na edycję zapytania przed przesłaniem go do serwera.

.

Uwaga

W trybie testowym nie są oczywiście przesyłane do wykresu żadne zmienne dynamiczne, które normalnie aplikacja przesyła dla potrzeb inicjalizacji niektórych parametrów dynamicznych wykresu – wszystkie te parametry zostają więc zainicjalizowane swoimi wartościami domyślnymi, określonymi w deklaracji lub definicji (inaczej jest w przypadku normalnego wykonania wykresu).

[Zabezpiecz wykres] - służy do założenia hasła blokującego zmiany w definicji wykresu dla użytkowników nieznających hasła. Przy wejściu na formularz tak zabezpieczonego wykresu nie mamy możliwości dokonania jakichkolwiek zmian chyba, że wciśniemy przycisk z kluczykiem i wpiszemy poprawne hasło

W takim przypadku definicja zostanie odblokowana i będzie również możliwa zmiana hasła (w tym jego wyczyszczenie, czyli odbezpieczenie definicji).

Pozostałe kontrolki są albo standardowe albo ich opis w pełni wyjaśnia zastosowanie. Dlatego tutaj ograniczymy się tylko do nadmienienia o jednej istotnej sprawie. Mianowicie w celu ułatwienia posługiwania się językiem stosowanym w definicji wykresu (połączenie SQL i języka parametrów dynamicznych) opracowano system zagnieżdżonych wizardów. Wizardy te pozwalają tworzyć i edytować deklaracje i odwołania do parametrów dynamicznych, wyrażenia, zmienne tekstowe, szablon zapytania SQL itp. Są one dostępne po kliknięciu prawym klawiszem myszy tekstu zapytania lub parametrów graficznych wykresu.

Poniżej przedstawiono dwie pozostałe zakładki formularza.

Lista wykresów

Do wyboru wykresu, który chcemy podłączyć, jak również do edycji wykresów zaimplementowano listy wykresów (Rysunek 5 przedstawia listę wykresów standardowych; wykresy użytkownika posiadają analogiczną listę). Lista ta może służyć również do edycji wykresów niepodłączonych do żadnego wywołania.

Lista wstawek tekstowych do wykresów

Do edycji wstawek tekstowych służą listy wstawek tekstowych do wykresów (Rysunek 6 przedstawia listę wstawek do wykresów standardowych; wstawki użytkownika posiadają analogiczną listę).

Formularz wstawki tekstowej do wykresu

Formularz wstawki tekstowej do wykresu wygląda następująco (Rysunek 7 przedstawia formularz wstawki standardowej; wstawki użytkownika posiadają analogiczny formularz).

Okno operacyjne wykresów

Głównym elementem modułu wykresów jest tzw. okno operacyjne wykresów. Okno to, zaraz po otwarciu, wyświetla wykres startowy, a następnie pozwala na nawigację po grafie wykresów i zmianę parametrów dynamicznych wykonywanych wykresów.

Głównym elementem okna jest kontrolka REGION zawierająca wykres. Pod wykresem dostępne są przyciski nawigacyjne, przycisk odświeżania wykresu oraz panel z kontrolkami parametrów dynamicznych.

Na drugiej zakładce umieszczone zostały kontrolki dynamicznych parametrów graficznych wykresu (jeśli ich brak – zakładka ta nie pokazuje się) a na trzeciej – lista z danymi serii wykresu przedstawionymi w formie tabelarycznej. Czwarta zakładka w całości dotyczy opcji wysyłania danych wynikowych. Na toolbarze okna są dostępne przyciski obsługujące wydruki wykresu i eksport danych do Excela. Wydruk z poziomu pierwszych dwóch zakładek produkuje plik .wmf (którego link jest wstawiany do definicji wydruku) a z trzeciej i czwartej zakładki – kolejkę z danymi serii wykresu (wydruk tu podłączony powinien więc operować na kolejce).

Eksport danych do Excela obejmuje dane serii wykresu, a więc dane z listy na trzeciej zakładce.

Jedną z podstawowych akcji wykonywanych na wykresie jest eksploracja do wykresu podrzędnego. Następuje to przez kliknięcie lewym klawiszem myszy w wybrany punkt wykresu (wykonanie podwykresu domyślnego) lub kliknięcie prawym klawiszem myszy w wybrany punkt wykresu i wybór z menu podwykresu, który chcemy wykonać.

Umieszczone pod wykresem przyciski nawigacyjne służą do poruszania się po historii wykonanych wykresów od startowego począwszy. Odpowiada to analogicznym przyciskom w internetowych browserach. Należy jednak zwrócić uwagę, że wykonanie każdej akcji nawigacji (Wstecz, Wprzód itp.) wiąże się z odświeżeniem danych (powtórne załadowanie – brak cache’owania wyniku).

Jak powiedziano wcześniej, bieżący wykres startowy zostaje po raz pierwszy wykonany z wartościami początkowymi parametrów dynamicznych (nadpisanymi ewentualnie wartościami zmiennych dynamicznych przekazanych z aplikacji). Po zmianie któregokolwiek z parametrów przycisk odświeżenia zmienia ikonę na: , co ma sygnalizować, że dane na wykresie nie odpowiadają bieżącym nastawom parametrów. Aby uzgodnić dane z parametrami należy wykonać odświeżenie. Sytuacja taka nie występuje, jeśli w parametrach graficznych wykresu użyto parametru /@AutoRefresh – wówczas dane odświeżają się automatycznie po każdej zmianie dowolnego parametru.

Uwaga

Od wersji XL2019.0 zalecamy prezentację daty w ERP XL jako tekst, jest to związane z różnicami jakie wynikają z użycia nowszych wersji SQL serwer oraz sterowników ODBC ( SQL Native Client). Datę można przekazać jako tekst według przykładu: select lp = 1, cast(DATEADD(DAY, ZN.ZaN_DataWystawienia ,CONVERT(DATE,'1800-12-28',120)) as varchar) AS [Data wystawienia], ZN.ZaN_DataWystawienia from cdn.ZamNag zn

Komunikaty definiowalne

W Comarch ERP XL istnieje możliwość dodawania  definiowalnych komunikatów wyświetlanych przez aplikację pochodzących z triggerów w bazie MSSQL.

Dotychczas komunikaty wyświetlane na skutek działania triggerów były błędami krytycznymi. W większości przypadków komunikat zwracany przez trigger znajdował się na zakładce Przyczyna. Powodowało to spore utrudnienie w odnalezieniu właściwego komunikatu z serwera MSSQL. Często intencją autora triggera było wyświetlenie innego komunikatu niż błąd krytyczny oraz umieszczenie odpowiedniej treści w głównym oknie komunikatu.

Definiowalne komunikaty umożliwiają określenie priorytetu oraz zdefiniowanie treści komunikatu, a także informacji wyświetlanej na zakładkach Przyczyna oraz Remedium.

Uwaga

Zdefiniowany komunikat nie daje możliwości określenia ważności (severity) wyzwolonego komunikatu. System Comarch ERP XL wyświetla komunikaty o ważności nie mniejszej niż 16.

Definiowanie komunikatu w triggerze

Komunikaty w triggerze jest wyświetlany za pomocą funkcji RAISERROR(). Funkcja ta generuje komunikat oraz błąd na podstawie zadanych parametrów. Błąd ten jest przechwytywany przez system, który wyświetla odpowiedni komunikat, zawierający w swej treści komunikat błędu wygenerowany przez serwer MSSQL. W dotychczasowym działaniu użytkownik nie miał żadnego wpływu na typ oraz treść wyświetlanego komunikatu. Definiowanie komunikatu będzie polegało na umieszczeniu w jego treści, konkretnie w wywołaniu funkcji RAISERROR(), odpowiednich znaczników określających priorytet komunikatu (informacja, błąd, błąd krytyczny), znaczników określających treść komunikatu oraz treść zakładki Przyczyna i Remedium.

Znaczniki określające priorytet komunikatu

Znacznikami określającymi priorytet komunikatu są:

Znaczniki te mogą być umieszczone w dowolnym miejscu w treści komunikatu. Dla zwiększenia czytelności kodu proponujemy umieszczanie tych znaczników na początku treści.

Znaczniki określające treść komunikatu

Komunikat podzielony jest na treść właściwą oraz zakładki Przyczyna i Remedium. Definiowana treść powinna zaczynać się od jednego z poniższych znaczników:

Znacznikiem kończącym treść danej części komunikatu są znaki /#.

Przykłady

Poniżej przedstawiono przykładowe wywołanie funkcji RAISERROR() z definiowanym komunikatem:

Przykład triggera ze zdefiniowanym komunikatem

Poniżej został przedstawiony prosty trigger blokujacy zmianę nazwy towaru, ze zdefiniowanym komunikatem.

SET ANSI_NULLS ON

GO

SET QUOTED_IDENTIFIER ON

GO

CREATE TRIGGER CDN.ZmianaNazwyTowaru

ON CDN.TwrKarty

FOR UPDATE

AS

BEGIN

SET NOCOUNT ON

IF UPDATE(Twr_Nazwa)

BEGIN

IF EXISTS (SELECT * FROM deleted WHERE deleted.Twr_Nazwa<>'')

BEGIN

RAISERROR('#CDN_BLAD/# #CDN_1=Próba zmiany nazwy indeksu towarowego!/# #CDN_2=Nie masz uprawnień do wykonania tej operacji./# #CDN_3=Skontaktuj się z Twoim administratorem./#',16,1)

ROLLBACK TRAN

RETURN

END

END

END

SET NOCOUNT OFF

GO

SET QUOTED_IDENTIFIER OFF

GO

SET ANSI_NULLS ON

GO

Jako informacja ogólna pojawi się komunikat: Próba zmiany nazwy indeksu towarowego!

W informacjach szczegółowych będą widniały następujące treści:

Mała Hydra

Przez Małą Hydrę rozumiemy mechanizm, który pozwala na ukrycie, wyłączenie lub ustawienie wymagalności dla kontrolek na istniejących oknach. Callbacki zarówno Małej jak i Dużej Hydry są widoczne na Liście dodatków. Lista ta umożliwia importowanie i eksportowanie callbacków, zmianę ich stanu, dodawanie, usuwanie oraz edycję.

Na liście dodatków znajdują się następujące przyciski:

Nowy dodatek – użycie funkcji rozpocznie proces dodawania nowego callbacka.

Importuj – funkcja umożliwia zaimportowanie zdefiniowanego callbacka ze wskazanej lokalizacji.

Eksportuj - funkcja umożliwia wyeksportowanie callbacka do wskazanej lokalizacji.

Odśwież – odświeżenie listy dodatków.

Odśwież w programie - funkcja odświeżania w całym programie, np. w przypadku usunięcia callbacka, zostanie on usunięty ze struktury firmy i innych obiektów w systemie dopiero po jej użyciu.

Dodaj - funkcja aktywna po dodaniu callbacka. Umożliwia jego szczegółowe zdefiniowanie.

Edytuj - umożliwia edycję zdefiniowanego callbacka.

Usuń – usuwa callbacka zaznaczonego na liście.

Aby dodać nowy dodatek Małej Hydry należy uruchomić funkcję Nowy dodatek. Zostanie podniesione okno Edycja dodatku.

Nazwa - w polu należy wprowadzić nazwę callbacka.

Wersja - wersja „Hydry”, w jakiej został utworzony callback; pole wypełniane jest automatycznie.

Przeznaczony dla wersji - wersja systemu Comarch ERP XL, w której callback będzie funkcjonował; pole wypełniane automatycznie.

Autor - autor callbacka; pole wypełniane automatycznie - wartością wprowadzaną domyślnie będzie zalogowany operator.

Data utworzenia - data utworzenia callbacka; pole wypełniane automatycznie.

Data dodania - data dodania callbacka do systemu; pole wypełniane automatycznie.

Operator - operator dodający callback do systemu; pole wypełniane automatycznie.

Stan - zaznaczenie wybranej opcji zadecyduje o aktywności callbacka w systemie. Aby callback funkcjonował w systemie, musi mieć zaznaczoną opcję: Aktywny.

Opis - w polu można wprowadzić opis callbacka.

Aby skonfigurować callbacka należy zaznaczyć dodatek i uruchomić funkcję Dodaj. W efekcie zostanie podniesione okno Edycja grupy procedur. W tym miejscu istnieje możliwość zdefiniowania dodatkowego warunku, na zakładanym callbacku. Warunek musi być zdefiniowany zgodnie ze składnią języka C# i musi zwracać wartość logiczną. W przypadku zwrócenia wartości true callback zostanie wykonany, w przypadku zwrócenia wartości false działanie callbacka zostanie zablokowane. W programie możemy definiować dwa rodzaje złożonych warunków callbacka:

Warunek oparty o zmienne słownikowe – warunek można skonstruować w oparciu o zmienne zawarte w ConfigurationDictionary.

Warunek oparty o bufor tabeli – warunek może być oparty o dane zawarte w buforze tabeli.

Przyklad

Przykładowy warunek callbacka na zalogowanego operatora: if (Runtime.ConfigurationDictionary.NumerOperatora == 1) {return false;}

Przyklad

Przykładowy warunek na stan towaru: if (TwrKarty.Twr_Typ==1) {return false;} else {return true;}

Uwaga

Warunek callbacka Małej Hydry jest sprawdzany tylko w momencie uruchamiania formatki.

Uwaga

Aby warunek oparty o bufor tabeli działał prawidłowo, należy wyłączyć na operatorze Otwieranie okien w trybie zaawansowanym. W przeciwnym wypadku operator będzie miał możliwość przechodzenia między obiektami (np. dokumentami) bez ponownego sprawdzania warunku callbacka.

Przyklad

Dodatkowo warunki można definiować za pomocą sqlQuery, nazwy pól, tabel oraz wielkość znaków powinny być takie same jak w bazie danych. string sqlQuery = "select case when "+ZamNag.ZaN_Stan+" = 4 AND "+ZamNag._ZaN_OpeNumerZ+" = 1 then 1/0 else 0 end"; if (Runtime.ConfigurationDictionary.ExecSql(sqlQuery, true) == 1) return true; else return false;

W ostatnim kroku należy zdefiniować zmienioną obsługę kontrolek. W tym celu należy na liście dodatków zaznaczyć dodaną procedurę i wywołać funkcję Dodaj. Zostanie podniesione okno Edycja akcji na kontrolce. W tym miejscu należy wskazać za pomocą znacznika odpowiednią kontrolkę na oknie, a następnie zdefiniować właściwą akcję:

Ukryj – ukrycie kontrolki na oknie

Dezaktywuj – dezaktywacja kontrolki na oknie

Wymagaj – ustawienie wymagalności kontrolki – nie będzie możliwe zamknięcie okna do czasu wprowadzenia wartości w kontrolce.

Pogrub – pogrubia czcionkę etykiety (pogrubiona czcionka zwykle służy do wizualnego oznaczenia pól wymaganych na formularzu)

Uwaga

Akcja Wymagaj może być użyta tylko dla wybranych kontrolek. Dotyczy przede wszystkim kontrolek, dla których istnieje stan „bez wartości” np. kontrolek tekstowych. Akcja nie może być natomiast wykorzystana np. dla kontrolki check, gdyż kontrolka zawsze przyjmuje wartość (0 lub 1).

Aby dodatek był aktywny w systemie należy go dodać do właściwego centrum w strukturze praw. W tym celu należy uruchomić okno Edycja struktury firmy i dodać zdefiniowanego callbacka na zakładce Dodatki.

Duża Hydra - informacje ogólne

Callbacki

Callbacki Dużej Hydry są mechanizmem, który służy do dodawania nowej funkcjonalności, bez potrzeby modyfikacji binariów programu. Od strony technicznej callbacki są zrealizowane jako plik dll eksportujący określony zestaw funkcji, podzielonych na funkcje plikowe i okienkowe.

Funkcje plikowe są wywoływane przez program podczas uruchamiania lub zamykania formatki - wówczas każda akcja użytkownika powoduje wywołanie pary zdarzeń: poprzedzających akcję i następujących po niej. Callbacki z tej grupy są najczęściej wykorzystywane do kontroli poprawności zapisywanych danych oraz do zaawansowanej kontroli uprawnień operatora.

Funkcje okienkowe są wykorzystywane w celu modyfikacji wyglądu i zachowania formatek. Składają się na nie trzy funkcje: wywoływane podczas inicjalizacji okna, przy każdym zdarzeniu okna oraz przed zamknięciem okna. Callbacki z tej grupy są najczęściej wykorzystywane do ukrywania lub uniemożliwiania edycji niektórych pól na formatkach lub do dodawania elementów interfejsu.

Zdarzenia obu grup są bardzo często używane łącznie.

Uwaga

Od wersji systemu Comarch ERP XL 2020 Hydra używa wersji Microsoft .NET Framework 4.5.1

Kod obsługujący zdarzenia należy umieścić w specjalnie przygotowanym module .NET’owym. Moduł taki musi zostać opisany za pomocą atrybutu CallbackAssemblyDescription w następujący sposób:

Przygotowanie Callbacka

[assembly:CallbackAssemblyDescription("Nazwa callbacka","Opis callbacka",”Autor callbacka","wersja callbacka","wersja systemu, dla której callback jest przeznaczony","data utworzenia callbacka w formacie dd-mm-rrrr”)]

Aby obsłużyć zdarzenia plikowe i okienkowe, należy dodać do modułu publiczną klasę dziedziczącą po klasie Callback, zdefiniowaną w assembly CdnHydra.dll. Klasę taką należy opisać atrybutem SubscribeProcedure w następujący sposób:

[SubscribeProcedure(Procedura z enumeracji Procedures,"Opis subskrypcji")]

Klasa Callback jest abstrakcyjna, więc do skompilowania assembly będzie konieczne zdefiniowanie metod Init i Cleanup. Zdefiniowanie tych metod umożliwia użytkownikowi wykonanie kodu odpowiednio inicjującego i kończącego pracę z procedurą. Uwaga – nie należy umieszczać takiego kodu wewnątrz konstruktora ani metody Dispose, ponieważ jedna instancja klasy może być wykorzystywana wielokrotnie (każde kolejne uruchomienie przez użytkownika procedury będzie powodowało uruchomienie metody Init, ale nie konstruktora, podobnie z metodą Cleanup). W metodzie Init należy określić zainteresowanie zdarzeniami w procedurze. W przypadku zdarzeń plikowych subskrypcja powinna mieć postać:

AddFileActionSubscription(bool BeforeAction,

FileActionTypes ActionType,

FileActionDelegate ActionDelegate)

gdzie

BeforeAction – określa czy obsługa ma być wywoływana przed czy po zdarzeniu

FileActionTypes – określa typ zdarzenia plikowego, którego dotyczy subskrypcja

ActionDelegate – określa delegat wywoływany w odpowiedzi na zdarzenie

W przypadku zdarzeń okienkowych subskrypcja powinna mieć postać:

AddSubscription(bool BeforeHandling,

int ControlId,

Events EventId,

TakeEventDelegate EventDelegate)

gdzie

BeforeHandling – określa czy obsługa ma być wywoływana przed czy po zdarzeniu

ControlId – określa ID kontrolki (wartość 0 w przypadku ID okna)

EventId – określa zdarzenie, którego dotyczy subskrypcja

EventDelegate – określa delegat wywoływany w odpowiedzi na zdarzenie

Subskrypcje na zdarzenia mogą zostać usunięte za pomocą instrukcji:

RemoveFileActionSubscription(bool BeforeAction,

FileActionTypes ActionType,

FileActionDelegate ActionDelegate)

RemoveSubscription(bool BeforeHandling,

int ControlId,

Events EventId,

TakeEventDelegate EventDelegate)

Deklaracje delegatów dla zdarzeń plikowych i okienkowych powinny mieć odpowiednio postać:

public delegate bool FileActionDelegate (Procedures ProcedureId,

GID GID,

ADODB._Recordset Attributes);

gdzie

ProcedureId – id procedury, której dotyczy zdarzenie

GID – identyfikator rekordu, którego dotyczy zdarzenie

Attributes – zestaw atrybutów powiązanych z edytowanym rekordem

public delegate bool TakeEventDelegate (Procedures ProcedureId,

int ControlId,

Events EventId);

gdzie

ProcedureId – id procedury, której dotyczy zdarzenie

ControlId – id kontrolki, której dotyczy zdarzenie

EventId – id zdarzenia

Kod znajdujący się w callbacku ma dostęp do kontekstu, w którym został uruchomiony za pośrednictwem własności klasy ConfigurationManager. W ramach tej klasy są przechowywane następujące informacje:

- Baza string

- BazaHurtowni string

- BazaOLAP string

- Centra ADODB._Recordset

- DomyslnyMagazynSprzedazy string

- DomyslnyMagazynZakupu string

- DomyslnyRejestrBankowy string

- DomyslnySkladCelny string

- IdCentrumKosztowego int

- IdCentrumPodleglosciowego int

- IdCentrumWlasciwego int

- IdFirmy int

- KasaTransakcjiGotowkowych string

- KatalogProgramu string

- KoniecOkresuObrachunkowego datetime

- KontoDostawcow string

- KontoOdbiorcow string

- LoginZintegrowany bool

- MagazynDocelowyKompletacji string

- Magazyny ADODB._Recordset

- MagazynZrodlowyKompletacji string

- NumerOperatora int

- PieczatkaEmail string

- PieczatkaMiasto string

- PieczatkaNazwa string

- PieczatkaNIP string

- PieczatkaNIPPrefiks string

- PoczatekOkresuObrachunkowego datetime

- RabatyOdCeny bool

- RejestryBankowe ADODB._Recordset

- SciezkaWStrukturze string

- Serie ADODB._Recordset

- SerieOddzialowe ADODB._Recordset

- Serwer string

- SerwerOLAP string

- TypNaliczaniaMarzy Hydra.TypMarzy

- TypyKlasAtrybutow ADODB._Recordset

- WalutaSystemowa string

- Waluty ADODB._Recordset

Procedury HASPa:

- HASPDataAplikacji datetime

- HASPDataDealera datetime

- HASPLicencje ADODB._Recordset

- HASPLiczbaBaz int

- HASPNazwaUzytkownika string

- HASPNumerBazyDanych int- HASPNumerKlucza int

- HASPOpcje int

- HASPPlatforma int

- HASPStanKlucza int

Operacje na kontrolkach

Kod znajdujący się w callbacku może wykonywać operacje na interfejsie (dodawać, przesuwać i ukrywać kontrolki, wypełniać je itp.) za pośrednictwem własności i metod klasy ClaWindow. Instancję klasy ClaWindow można uzyskać za pomocą metody GetWindow klasy Callback (w celu uzyskania głównego okna procedury) lub GetControl (w celu uzyskania kontrolki).

Klasa ClaWindow jest wykorzystywana do operowania na oknach i kontrolkach Clarionowych. Każda instancja klasy ClaWindow jest powiązana z kontrolką lub oknem, na którym operuje.

Kolekcja AllChildren przechowuje wszystkie kontrolki znajdujące się na oknie. Można ją wykorzystać do odnalezienia poszukiwanej kontrolki. Pozostałe własności klasy odpowiadają własnościom kontrolek Clarionowych, które zostały opisane w dalszej części biuletynu.

Zdarzenia do kontrolki mogą być wysyłane za pośrednictwem metody:

public void PostEvent(Events EventId)

gdzie:

EventId – identyfikator zdarzenia, które ma zostać wysłane do kontrolki

Bardzo często zdarzenia do kontrolki są wysyłane parami – po wysłaniu określonego zdarzenia wymagane jest wysłanie zdarzenia Accepted w celu zatwierdzenia wprowadzonej wartości.

Podstawowe zdarzenia dla kontrolek:

OpenWindow/JustAfterWindowOpening – otwarcie okna

ResizeWindow – zmiana wielkości okna

NewSelection – kliknięcie w spin, przejście do innej zakładki

Accepted – akceptacja wprowadzenia nowej wartości do pola (odpowiednik wyjścia z kontrolki za pomocą tabulatora), kliknięcie przycisku.

ScrollDown/ScrollUp – scrollowanie listy

Podstawowe kontrolki

Główne właściwości kontrolek

Visible – (true/false) – widoczność kontrolki

Disable – kontrolka nieaktywna

Skip – kontrolka jest pomijana podczas przechodzenia tabulatorem

TextRaw – tekst widoczny na kontrolce

Bounds – współrzędne kontrolki

FontSizeRaw – wielkość czcionki

FontColorRaw – kolor czcionki

BackgroundRaw – kolor tła

Uwaga

Lista możliwych kolorów została przedstawiona w pliku kolory.txt w załącznikach do biuletynu. Przed przypisaniem wartości należy przekonwertować kody kolorów z notacji szesnastkowej do postaci dziesiętnej.

FontStyleRaw – format tekstu

Uwaga

Możliwe wartości dla wybranych formatów:

100 – cienki tekst, 400 – zwykły tekst, 700 – pogrubiony tekst, 4096 – kursywa, 8192 –

podkreślenie, 16384 – tekst przekreślony

LeftRaw/RightRaw/CenterRaw – wyrównywanie tekstu w kontrolce

TipRaw – tekst wyświetlany w tooltipie kontrolki

MsgRaw – opis wyświetlany w stopce okna podczas aktywności kontrolki

Box

Kontrolka typu Box definiuje ramkę na oknie (prostokątny obszar).

ColorRaw – kolor ramki

RoundRaw – zaokrąglenie ramki

FillRaw – kolor wypełnienia

LineWidthRaw – grubość ramki

Panel

Kontrolka typu Panel definiuje obszar na oknie.

BevelRaw – efekt 3D dla ramki

Image

Kontrolka typu Image pozwala umieścić rysunek na oknie.

TextRaw – ścieżka do pliku z rysunkiem

Button

Kontrolka typu Button dodaje przycisk na oknie

IconRaw – przypisanie ikony do przycisku np. "~EXPORT20.ICO"

Uwaga

W przypadku przypisywania ikony na podstawie pliku należy podać pełną ścieżkę do ikony w formacie: @”C:\WINDOWS\msnms.ico”. W przypadku przypisywania standardowej ikony ERP XL należy podać nazwę ikony w formacie: „~EXPORT20.ICO”. Pełna lista istniejących ikon nie jest dostępna na zewnątrz.

ReqRaw – naciśnięcie przycisku spowoduje sprawdzenie czy wszystkie pola Entry na oknie, które mają ustawiony parametr Req są wypełnione. Jeżeli nie są wypełnione to kursor zostanie przeniesiony do odpowiedniego pola Entry.FlatRaw – określenie czy przycisk jest płaski (wymagane jest przypisanie ikony do przycisku)

ImmRaw – moment wyzwolenia akcji na kontrolce. W przypadku przekazania do właściwości wartości „1” akcja zostanie wywołana w momencie kliknięcia przycisku, ale przed zwolnieniem przycisku myszy. W przypadku przekazania wartości „0” akcja zostanie wykonana po naciśnięciu i zwolnieniu przycisku myszy.

TextRaw – etykieta przycisku

Uwaga

Jeżeli w etykiecie dodamy znak & to pojawi się możliwość wywołania przycisku z klawiatury zgodnie z kolejną literą. Przykładowo przycisk o etykiecie &nazwa pozwoli na wywołanie kliknięcia poprzez alt+n.

StdRaw – przypisanie do przycisku standardowej akcji

Menu

Kontrolka dodaje dodatkową opcję w Menu okna. Aby zbudować menu należy posłużyć się dwoma

typami kontrolek: Menu i Item. Poniżej zaprezentowano przykład działania Menu:

Przyklad

parent = GetWindow(); menu1 = parent.AllChildren.Add(ControlTypes.menu); menu1.Visible = true; menu1.TextRaw = "Nowe menu"; menu2 = menu1.AllChildren.Add(ControlTypes.menu); menu2.Visible = true; menu2.TextRaw = "Menu poziom 2"; item1 = menu1.AllChildren.Add(ControlTypes.item); item1.Visible = true; item1.TextRaw = "Element 1"; item2 = menu1.AllChildren.Add(ControlTypes.item); item2.Visible = true; item2.TextRaw = "Element 2"; item3 = menu2.AllChildren.Add(ControlTypes.item); item3.Visible = true; item3.TextRaw = "Element 3";

Group

Kontrolka pozwala zgrupować na oknie inne kontrolki. Możliwe jest narysowanie ramki dla grupy i nadanie jej nazwy.

BoxedRaw – czy ma być wyświetlana ramka dla grupy (0 – nie, 1 – tak)

TextRaw – nazwa grupy

Text

Kontrolka typu Text dodaje pole tekstowe na oknie.

ToolTipRaw – tekst w tooltipie

SkipRaw – pole jest ignorowane podczas przechodzenia między kontrolkami za pomocą przycisku

Tabulatora

ReadOnlyRaw – pole ma status „tylko do odczytu”

TextRaw – domyślna wartość w polu tekstowym

List

Kontrolka typu List dodaje listę na oknie.

FromRaw – wypełnienie listy wartościami gdzie kolejne rekordy powinny być oddzielone od siebie

znakiem |. Jeżeli taki znak ma zostać wpisany jako wartość pozycji to należy wpisać ||. Pustą wartość

można uzyskać wpisując | |

VScrollRaw – umieszczenie pionowego paska przewijania na liście

FormatRaw – zdefiniowanie kolumn listy

SelectedRaw – numer zaznaczonego elementu na liście

Uwaga

Aby przejść do kolejnego elementu listy można wykorzystać zdarzenie ScrollDown: Runtime.WindowController.PostEvent(idkontrolki, Events.ScrollDown); Ewentualnie może zajść potrzeba wkliknięcia się w daną listę za pomocą zdarzenia SelectControl: Runtime.WindowController.SelectControl(i);

Progress

Kontrolka Progress definiuje pasek postępu. Określenie postępu dla kontrolki określa się za pomocą parametru ProgressRaw.

Region

Kontrolka typu Region dodaje „interaktywny” obszar (Panel) na oknie.

ImmRaw – ustawienie parametru pozwala na obsługę zdarzeń typu MouseIn/MouseOut. Ponieważ właściwość może mieć wpływ na prędkość otwierania formatki należy ją definiować jedynie w przypadku wykorzystania dodatkowych zdarzeń.

DragIDRaw/DropIDRaw – obsługa zdarzeń typu Drag i Drop na obszarze.

Spin

RangeLowRaw – minimalna wartość dla kontrolki

RangeHighRaw – maksymalna wartość dla kontrolki

ScreenTextRaw – domyślna wartość dla kontrolki

FromRaw – lista możliwych wartości dla kontrolki oddzielonych od siebie znakiem |

TextRaw – określenie formatu pola

Przyklad

Przykładowe ustawienia dla pól typu data zostały przedstawione w pliku daty.txt w załącznikach. Data powinna być przekazana w formacie Clariona, czas w formacie Timestamp.

ValueRaw – określenie wartości domyślnej w polu (wymagane ustawienie UseRaw=”1”) Zmiana wartości w kontrolce: Runtime.WindowController.Change(kontrolka.Id, "wartość")

Przyklad

Przykład na zmianę wartości rabatu na dokumencie ZS: Runtime.WindowController.Change(Parent.AllChildren["?ZaN:Rabat"].Id, "50"); Runtime.WindowController.PostEvent(Parent.AllChildren["?ZaN:Rabat"].Id , Events.Accepted);

.Check

Kontrolka typu Check pozwala na zwrócenie wartości z przedziału {0,1}

CheckedRaw – domyślna wartość kontrolki (1 – zaznaczony, 0 – odznaczony)

UseRaw – wartość w kontrolce przy odczycie

Uwaga

Generalnie właściwości CheckedRaw oraz UseRaw powinny przyjmować wartości 0 oraz 1, jednak odczyt wartości kontrolek poprzez Hydrę zwraca wartości ustawione z poziomu zbudowania okna dlatego mogą pojawić się inne wartości np. wartość 2 dla zaznaczonej kontrolki. W przypadku gdy dana kontrolka zwraca wartość inną niż 0 wówczas ma wartość TRUE. Przy ustawianiu wartości kontrolek z poziomu Dużej Hydry zalecamy używanie wartości 0 i 1.

DropCombo

Kontrolka typu DropCombo jest połączeniem dwóch kontrolek: List oraz Entry. Kontrolka pozwala na wybranie wartości z listy jednocześnie umożliwiając dopisanie/zmianę wartości.

FromRaw – wypełnienie listy wartościami gdzie kolejne rekordy powinny być oddzielone od siebie znakiem |. Jeżeli taki znak ma zostać wpisany jako wartość pozycji to należy wpisać ||. Pustą wartość można uzyskać wpisując | |

VScrollRaw – umieszczenie pionowego paska przewijania na liście.

DropRaw – liczba wierszy wyświetlanych na liście.

VCRRaw – pasek szybkiego przechodzenia po liście wartości

UprRaw – wpisanie wartości do pola będzie skutkowało automatyczną zmianą tekstu na duże znaki

SelectedRaw – wybranie pozycji na liście wartości

ScreenTextRaw – wpisanie wartości do pola entry

 

Przyklad

Przykładowy kod na obsłużenie kontrolki o typie dropcombo: ClaWindow combo = Parent.Children.Add(ControlTypes.dropcombo); combo.Visible = true; combo.Bounds = new Rectangle(200, 255, 70, 10); combo.FromRaw = "wartosc1|wartosc2|wartosc3"; combo.SelectedRaw = "2"; combo.ScreenTextRaw = "wartosc2"; AddSubscription(true, combo.Id, Events.NewSelection,new TakeEventDelegate(komunikat));

Droplist

Kontrolka typu Droplist pozwala na wybór wartości z rozwijanej listy bez możliwości jej edycji lub wprowadzania nowych wartości. Właściwości kontrolki w większości pozostają analogiczne jak na kontrolce Dropcombo.

Wyświetlanie komunikatów (dotyczy wyłącznie wersji SE)

Komunikat można wyświetlić za pomocą polecenia MessageBox.Show(string) po uprzednim odblokowaniu wątku. Właściwa obsługa wątków jest również konieczna na przykład w przypadku wywoływania okna .net’owego.

Przyklad

Runtime.WindowController.LockThread(); Runtime.WindowController.UnlockThread(); MessageBox.Show("Tekst komunikatu");

Ogólne wskazówki związane z tworzeniem callbacków

Odczytanie nazwy kontrolki

Nazwę danej kontrolki można odczytać korzystając z konstruktora Małej Hydry. W przypadku modułu Detal nazwy procedur rozpoczynają się od słowa Detal, a nazwy kontrolek w większości są zgodne z analogicznymi kontrolkami w innych modułach.

Bufor Tabeli

W wielu miejscach programu mamy możliwość odwołania się do wartości przechowywanych w buforze tabeli. Przykładowo z poziomu formatki dokumentu możemy odczytać informacje na temat jego nagłówka bez konieczności otwierania połączenia do bazy. Aby wykonać taki odczyt należy wskazać nazwę tabeli wraz z nazwą kolumny w bazie np. TraNag.TrN_GIDNumer.

Warto zwrócić uwagę że w buforze pliku jest przechowywany tylko jeden, aktualny rekord. Dodatkowo bufory plików mogą być wykorzystywane przez główny kod programu na różne sposoby – np. mogą być modyfikowane w odpowiedzi na zdarzenia na oknie. Dlatego warto ograniczyć poleganie na informacjach znajdujących się w buforach plików do niezbędnego minimum, wszelkie dodatkowe informacje odczytując samodzielnie np. przy użyciu ADO.NET. Modyfikowanie buforów plików jest możliwe, ale jest to działanie, które absolutnie odradzamy – może prowadzić do powstania trudnych do wykrycia i usunięcia błędów w bazie danych.

Identyfikator błędu w przypadku zdarzeń plikowych

W przypadku zdarzeń plikowych istnieje możliwość zareagowanie na ewentualny błąd np. nieudaną aktualizację rekordu. W tym celu obok standardowej subskrypcji AddFileActionSubscription jest udostępniona funkcja AddFileActionErrSubscription. W ramach tej subskrypcji jest dodany delegat FileActionErrDelegate, do którego będzie przekazywany kod błędu. Delegat jest wołany tylko na zdarzeniach typu after.

Oba typy subskrypcji mogą działać równocześnie. Wówczas Hydra najpierw wywołuje delegata z przekazanym kodem błędu, a później stary delegat.

W materiałach dodatkowych zostały udostępnione callbacki przedstawiające wykorzystanie zdarzeń plikowych. Są to odpowiednio callback_plikowy.cs (dla AddFileActionSubscripion) i callback_plikowy_err.cs (dla AddFileActionErrSubscription).

Obsługa list z poziomu Hydry

W przypadku tworzenia nowych list za pomocą Hydry, pierwszym etapem jest ustalenie prawidłowej definicji listy. Aby prawidłowo utworzyć listę należy się posłużyć dokumentacją Clariona, gdzie szczegółowo opisano działanie poszczególnych parametrów definicji listy. Jeżeli nie dysponujemy dokładnym opisem, to można odczytać i ewentualnie zmodyfikować format innej, istniejącej już listy w programie.

Uwaga

Dla wersji SE systemu Comarch ERP XL zalecamy dokumentację Clariona w wersji 5.5, natomiast dla wersji z nowym interfejsem w wersji 8).

Kolejnym etapem jest proces wypełniania listy danymi. Aby prawidłowo wypełnić listę należy określić parametr FormatRaw wcześniej zdefiniowanym łańcuchem znaków. Stopniowa inkrementacja wartości parametru w pętli nie jest w tym przypadku zalecana, gdyż powoduje znaczne wydłużenie procesu wypełniania kontrolki. Poniższy fragment kodu prezentuje w jaki sposób powinno wyglądać prawidłowe wypełnianie listy:

 

Przyklad

string tekst = ""; // ******** Zalecana konstrukcja: ***************** int y = 0; while (y < 5000) { tekst += "wartosc " + y + "|"; y++; } polelist.FromRaw = tekst; //********* Niezalecana konstrukcja: ************** int y = 0; while (y < 5000) { polelist.FromRaw += "wartosc " + y + "|"; y++; }

 

W przypadku nowej listy istnieje możliwość określenia kolorów dla każdego rekordu. Aby pojawiła się taka możliwość należy dodać znak * w definicji danej listy. Poniżej zaprezentowano fragment kodu dodającego nową listę. Dla każdej wartości został zdefiniowany zestaw 4 kolorów oznaczających kolejno: kolor tekstu, kolor tła, kolor tekstu po podświetleniu wiersza, kolor tła po podświetleniu wiersza. W przypadku pozostawienia wartości -1 zostanie pobrany domyślny kolor zdefiniowany dla listy.

Przyklad

polelist = zakladka.AllChildren.Add(ControlTypes.list); polelist.Visible = true; polelist.Bounds = new Rectangle(20, 20, 260, 260); polelist.FormatRaw = "160L*~Naglowek~@s40@#1#"; string tekst = ""; tekst = "wartosc1|32768|-1|-1|-1|";  

W przypadku list istniejących nie możemy odczytać kolejki danych wysyłanych do kontrolki i w związku z tym, nie mamy możliwości zmiany koloru poszczególnych pozycji.

Zmiana wartości w kontrolce Check

Poniżej zaprezentowano przykład na zmianę wartości kontrolki typu Check.

Przyklad

if (polecheck.UseRaw == "0") { Runtime.WindowController.Change(polecheck.Id, "1"); } else { Runtime.WindowController.Change(polecheck.Id, "0"); } Runtime.WindowController.PostEvent(polecheck.Id, Events.Accepted);

Zasady działania głównych funkcji Dużej Hydry

Podczas tworzenia dodatków należy pamiętać, iż metoda Init() wykonuje się przed zbudowaniem okna. Metoda Cleanup() jest wykonywana przed zamknięciem okna. Okno jeszcze istnieje, ale już nie obsługuje zdarzeń. Metoda Exit() wykonuje się po zamknięciu okna, po zwolnieniu lokalnych obiektów (wszystkich łącznie z oknem i kontrolkami). Można tą metodę przeciążać – dlatego właśnie została udostępniona, trzeba tylko nie odwoływać się do zwolnionych obiektów.

Przykłady

Zdefiniowanie połączenia do bazy bez potrzeby podawania ConnectionStringa.

Nie ma potrzeby definiowania Connection Stringa przy wywoływaniu połączenia do bazy danych. W to miejsce można zastosować intrukcję: Runtime.ActiveRuntime.Repository.Connection; która zwróci pełny ConnectionString dla połączenia XL-owego.

Uwaga

Od wersji systemu Comarch ERP XL 2020.0.0 zmieniony zostanie obiekt Hydra.ActiveRuntime.Repository.Connection z SQLConnection na interfejs IDbConnection

Uwaga

Od wersji systemu Comarch ERP XL 2021.0.0 zalecane jest tworzenie własnego Connection Stringa za pomocą zmiany definicji funkcji bazodanowej : CDN.PodajDodatkowyConnectString; obiekt: Runtime.ActiveRuntime.Repository.Connection i zwracany przez niego Connection String mogą zostać wycofany z udostępnienia w przyszłych wersjach ze względów bezpieczeństwa. Dostęp do samodzielnie zdefiniowanego Connestion Stringa w Hydrze jest poprzez pole: Runtime.ActiveRuntime.Repository.ConnectionString;

 

Wywołanie zapytania na bazie bez potrzeby otwierania nowego połączenia do bazy.

Do klasy Config została dodana metoda ExecSQL, która pozwala na wywołanie zapytania SQL bez potrzeby otwierania nowego połączenia do bazy. Wykonanie zapytania odbywa się w tym przypadku na połączeniu XLa i służy wykonaniu instrukcji bez zwracania jej wyniku. W związku z tym jest ona przeznaczona przede wszystkim do uruchamiania procedur SQL lub instrukcji insert/update/delete na bazie danych. Na chwilę obecną nie ma możliwości wykorzystania instrukcji w celu zwrócenia wartości select.

Instrukcja ma postać: Runtime.Config.ExecSql (string Sql, bool Transakcja) gdzie parametr Sql - zapytanie SQL parametr Transakcja (true lub false) - czy zapytanie ma być wykonane w transakcji (true) lub nie (false)

Aktualna data i godzina

Informacje na temat aktualnej daty i godziny można uzyskać korzystając z klasy ConfigurationDictionary:

Runtime.ConfigurationDictionary.Today()

Runtime.ConfigurationDictionary.TimeStamp()

Uwaga

Powyższe funkcje zwracają aktualną datę ustawioną w programie. Jeżeli data zostanie zmieniona w programie, to również zmieniona zostanie zwrócona przez funkcję.

Odczyt zaznaczonych pozycji

Na listach została udostępniona możliwość odczytu zaznaczonych pozycji. Przykład tego rozwiązania można odnaleźć w materiałach dodatkowych w pliku listazaznaczonych.cs.

Odczyt wartości atrybutu

W materiałach dodatkowych w pliku atrybuty.cs można odnaleźć przykład odczytania wartości atrybutu na dokumencie FS. Odczytanie wartości nie jest możliwe za pomocą mechanizmu Hydry, więc w tym celu zostało wykorzystane odwołanie bezpośrednio do bazy danych. Aby callback zadziałał prawidłowo należy zdefiniować atrybut z opcją automatycznego zapisu wartości w bazie.

Zmiana wartości pola tekstowego

Aby zmienić wartość istniejącego pola tekstowego należy zmienić odpowiednią właściwość danej kontrolki, a następnie odświeżyć kontrolkę.

ClaWindow Parent = GetWindow();

ClaWindow miasto = Parent.AllChildren["?Knt:Miasto"];

miasto.ScreenTextRaw = "miasto";

Runtime.WindowController.PostEvent(Parent.AllChildren["?Knt:Miasto"].Id,Events.Accepted);

Odświeżanie zawartości okna

Jeżeli wykonujemy operacje dla całego okna, a nie konkretnej kontrolki to w miejsce id kontrolki powinna zostać ustawiona wartość 0. Przykładowo, aby odświeżyć zawartość okna należy wywołać zdarzenie FullRefresh bez wskazania na konkretną kontrolkę:

Runtime.WindowController.PostEvent(0, Events.FullRefresh);

Podniesienie do edycji wybranego okna

Istnieje możliwość wywołania funkcji XLUruchomFormatkeWgGID bez konieczności wykorzystania w tym celu zewnętrznych funkcji API. Należy w tym celu wykorzystać wbudowaną funkcję:

public Hydra.GID UruchomFormatkeWgGID(short GIDTyp, int GIDFirma, int GIDNumer, short GIDLp,Hydra.Request request)

Przyklad

Przykładowe podniesienie formatki może mieć postać: GID gid = Runtime.ConfigurationDictionary.UruchomFormatkeWgGID (gidtyp, gidfirma, gidnumer, gidlp, Hydra.Request.ViewRecord); gdzie: gidtyp, gidfirma, gidnumer, gidlp – zmienne liczbowe przekazane z aplikacji Hydra.Request – określenie trybu podniesienia formatki. Możliwe tryby to: ChangeRecord, DeleteRecord, InsertRecord, SelectRecord, ViewRecord

 

W przypadku wystąpienia błędów do pola Typ klasy GID zostaje zwrócony numer błędu zgodny z analogiczną funkcją dostępną w API, a do pozostałych pól (Firma, Numer, Lp) zostaje zwrócona wartość -1.

Ukrycie kolumny na liście

W programie Comarch ERP XL nie ma możliwości, aby ukryć lub dodać kolumnę do listy z poziomu Hydry, gdyż wiązałoby się to z koniecznością zmiany sposobu wypełniania takiej listy danymi, nad czym z poziomu Hydry nie mamy kontroli. Aby ukryć kolumnę można za pomocą Hydry zmniejszyć jej szerokość tak, aby operator nie był w stanie zobaczyć jej zawartości. Efekt taki można osiągnąć modyfikując definicję danej listy poprzez zmianę właściwości FormatRaw. Przykładowy kod można odnaleźć w załącznikach w pliku UkrywanieKolumny.cs, który przedstawia sposób na ukrycie kolumny z ceną na liście towarów.

Uwaga

Załączony przykład ukrywa kolumnę na liście jednak może okazać się konieczne dodatkowe zabezpieczenie przed możliwością rozszerzenia kolumny przez operatora.

Debugowanie kodu z poziomu Visual Studio

Istnieje możliwość debugowania stworzonego callbacka. Aby przeprowadzić ten proces z poziomu Visual Studio należy wstawić w kodzie odpowiedni breakpoint, a następnie ustawić we właściwościach projektu, aby przy starcie została uruchomiona zewnętrzna aplikacja (w naszym przypadku moduł Comarch ERP XL). Właściwości projektu można ustawić z poziomu menu Project -> Properties. Konieczne jest również zaimportowanie aktualnego callbacka do ERP XL.

Przy powyższych ustawieniach w momencie uruchamiania debugowania zostanie uruchomiony moduł wskazany w linii ‘start external program’, a działanie programu zostanie przerwane przy dojściu do pierwszego breakpointa.

Uwaga

Funkcjonalność wywołania zewnętrznego programu w przedstawiony sposób podczas uruchamiania debugowania nie jest dostępna w Visual Studio w wersji Express.

Reakcja na zamknięcie okna

Aby zareagować na zamknięcie formatki najczęściej wykorzystuje się zdarzenie CloseWindow. Zdarzenie to ma jednak podstawowe ograniczenie, gdyż pozwala jedynie na reakcję przed zamknięciem formatki. Aby zareagować na moment „po zamknięciu” należy zadeklarować metodę Exit. Należy również zwrócić uwagę na brak blokowania wątku podczas wywoływania komunikatu.

Przyklad

public override void Exit() { base.Exit(); MessageBox.Show("komunikat");}

Ctrl+ins na dokumencie

Comarch ERP XL oferuje możliwość dodania nowych obiektów do bazy jak również skopiowanie istniejących za pomocą kombinacji Ctrl+ins. Aby z poziomu Hydry wykryć w jaki sposób nowy obiekt został dodany do bazy należy zapiąć się na zdarzenie plikowe before InsertInit. Jeżeli dodawany jest nowy obiekt do bazy, to w gidnumerze zostanie zwrócona wartość 0. W przypadku kopiowania obiektu zostanie zwrócony gidnumer kopiowanego elementu.

Zmiana kontrahenta na dokumencie

W przypadku zmiany kontrahenta lub towaru na dokumencie dostępne są dwie ścieżki postępowania – wartość może zostać wpisana w polu z klawiatury lub wybrana z podniesionej listy. Aby obsłużyć przedstawioną sytuację należy założyć dwie subskrypcje. Jedna z nich na wypełnienie wartości z klawiatury (zdarzenie before Accepted), druga na kliknięcie przycisku (zdarzenie after Accepted).

Przyklad

ClaWindow Kontrahent = ParentOkno.Children["?cKop_Knt:Akronim"]; ClaWindow Kontrahent2 = ParentOkno.Children["?Kontrahent:Button"]; AddSubscription(true, Kontrahent.Id, Events.Accepted, new TakeEventDelegate( OnOpenWindow2)); AddSubscription(false, Kontrahent2.Id, Events.Accepted, new TakeEventDelegate( OnOpenWindow2));

Przechodzenie między oknami w trybie zaawansowanym

Jeżeli na karcie operatora ustawiono otwieranie okien w trybie zaawansowanym, to pojawia się możliwość przechodzenia między dokumentami. Aby wykryć taką operację z poziomu Hydry należy zapiąć subskrypcję na kliknięcie strzałki, a następnie poczekać na pierwsze wysłanie zdarzenia FullRefresh do okna. Po wystąpieniu tego zdarzenia należy zdjąć subskrypcję na zdarzenie FullRefresh, aby uniknąć wyzwalania callbacka przy standardowym odświeżeniu danych.

Uwaga

W przypadku niektórych list należy uwzględnić sytuację, gdy przechodzenie następuje pomiędzy różnymi dokumentami – przykładowo dokumenty korekt mają inne IdProcedury niż oryginalne dokumenty.

Wykonanie wydruku

Z poziomu Hydry możliwe jest wykonanie wydruków. W tym celu w ConfigrationDictionary udostępniono metodę WykonajWydruk().

public int WykonajWydruk(int ProceduraID, int Kontekst, int Zrodlo, int Wydruk, int Format, string Zmienne, string FiltrTPS, string FiltrSQL, string Sortowanie, short Urzadzenie)

Przykład tego rozwiązania można odnaleźć w materiałach dodatkowych w pliku WykonajWydruk.cs.

Odczyt naciśniętego klawisza

Od wersji 2014.1 jest możliwe odczytywanie za pomocą Hydry, jaki klawisz klawiatury został naciśniety. W tym celu dodano metodę GetKeyCode do klasy WindowController.

Przykład tego rozwiązania można odnaleźć w materiałach dodatkowych w pliku OdczytKlawisza.cs.

Modyfikacja menu kontekstowego

Od wersji 2017.0 istnieje możliwość modyfikacji menu kontekstowych (tzw. PopupMenu) wyświetlanych w Comarch ERP XL. Służą do tego klasy XLPopup oraz XLPopupItem, które reprezentują odpowiednio menu oraz pojedynczą pozycję z menu.

W klasie WindowController dostępne są metody pomocnicze:

SetPopup – ustawia wygląd popup menu

SetPopupChoice – wybiera pozycję z popup menu związanym ze wskazaną kontrolką

GetPopup – zwraca definicję popup menu związanego z daną kontrolką

GetPopupChoice – zwraca numer pozycji ostatnio wybranej z popup menu

GetPopupItem – zwraca definicję pozycji ostatnio wybranej z popup menu

Aby modyfikować popup menu należy dodać subskrypcję przed zdarzeniem Events.XLPopup i w niej dokonać modyfikacji popup menu, natomiast na subskrypcji po tym zdarzeniu należy dodać obsługę wybranej pozycji.

Przyklad

public bool OpenWindow(Procedures ProcId, int ControlId, Events Event) { AddSubscription(true, GetWindow().AllChildren["?ListaZam"].Id, Events.XLPopup, new TakeEventDelegate(BeforePopup)); AddSubscription(false, GetWindow().AllChildren["?ListaZam"].Id, Events.XLPopup, new TakeEventDelegate(AfterPopup)); return true; } public bool BeforePopup(Procedures ProcId, int ControlId, Events Event) { XLPopup crPopup = Runtime.WindowController.GetPopup(); //Dodanie nowej pozycji do menu na końcu lNowaPozPos = crPopup.lstItems.Count; crPopup.lstItems.Add(new XLPopupItem() { sText = "-", lPosition = lNowaPozPos, lLevel = 0, sIcon = "" }); //Separator crPopup.lstItems.Add(new XLPopupItem() { sText = "Nowa pozycja", lPosition = lNowaPozPos+1, lLevel = 0, sIcon = ".\\icons\\prod\\Wozek.ico" }); //Dodanie ikony do istniejącej pozycji oraz deaktywacja usuwania try { crPopup.lstItems.Find(pi => pi.sText.Equals("Dodaj kolumny")).sIcon = ".\\icons\\prod\\Narzedzie.ico"; crPopup.lstItems.Find(pi => pi.sText.Equals("&Formaty listy")).sIcon = ".\\icons\\prod\\Narzedzie.ico"; crPopup.lstItems.Find(pi => pi.sText.Equals("Usuń")).bDisabled = true; }catch{} Runtime.WindowController.SetPopup(crPopup); return true; } public bool AfterPopup(Procedures ProcId, int ControlId, Events Event) { XLPopupItem crPopupItem = Runtime.WindowController.GetPopupItem(ControlId); if (crPopupItem.lPosition == lNowaPozPos+1) { MessageBox.Show(crPopupItem.ToString()); return false; } return true; }

Uwaga: Można dodawać i usuwać pozycje menu z dowolnego miejsca, ale jeżeli nie są to pozycje ostatnie to trzeba zadbać o przenumerowanie wyboru użytkownika tak aby dla standardowych pozycji zwracać ich pierwotne numery.

Odczyt nazwy kontrolki z pomocą dodatku Dużej Hydry

W przypadku gdy nazwy kontrolki nie da się odczytać za pomocą małej hydry można skorzystać z możliwości dużej hydry tworząc oddzielny dodatek. Wówczas należy skorzystać z metody Runtime.WindowController.GetControlName().

Przyklad

public bool OnOpenWindow(Procedures ProcID, int ControlID, Events Event) { for (int i = 1; i < 20; i++) { nazwaKontrolki = Runtime.WindowController.GetControlName(i).ToString();   MessageBox.Show("Nazwa kontrolki : " + nazwaKontrolki); }   return true; }

Format czasu w kontrolce spin

Umieszczając kontrolkę spin zdarza się potrzeba umieszczenia danych w formacie czasu np. hh:mm. W tym celu należy dodać odpowiedni parametr TextRaw = "@T1" oraz odpowiedni krok StepRaw = "6000". Format @T1 to GG:MM, czyli z dokładnością do minuty. Wartości w spinie natomiast to standardowy czas, czyli liczba setnych sek. od godziny 00:00:00. Domyślnym krokiem jest 1, więc gdy przewijamy w górę to kontrolka zaokrągla czas do pełnych minut zgodnie z formatem więc wartość się nie zmienia (np. 10:11:00.00 zmienia się na 10:11:00.01,więc w formacie @T1 nadal jest 10:11), gdy przewijamy w dół robi tak samo, ale teraz już minuty się zmieniły bo np. z 10:11:00.00 zrobi się 10:10:59.59.

Przyklad

Godzina_Spin = ClaInfoOkienkoLogistyczneGroup_Group.Children.Add(ControlTypes.spin); Godzina_Spin.TextRaw = "@T1"; Godzina_Spin..Bounds = new Rectangle(20, 20, 50, 10) Godzina_Spin.RangeLowRaw = "0000000"; Godzina_Spin.RangeHighRaw = "8640000"; Godzina_Spin.ValueRaw = "1"; Godzina_Spin.Visible = true; Godzina_Spin.StepRaw = "6000";

Znane problemy w Hydrze

Współpraca API z oknami .net’owymi (dotyczy wyłącznie wersji SE)

Mechanizm Hydry umożliwia wywołanie okienek .net’owych co przyczynia się do znacznego zwiększenia jej możliwości, jednak oznacza to równocześnie próbę pogodzenia ze sobą dwóch różnych technologii. Dosyć często takie formatki pośredniczą pomiędzy XL-em, a funkcjami API – przykładowo zachodzi taka sytuacja gdy z poziomu programu zostaje zawołane okno .net’owe, a następnie na podstawie zebranych danych wywołujemy funkcje API. Przy klasycznej konstrukcji callbacka, gdy w ramach danego frame’a wywołujemy funkcje API dosyć często pojawiają się błędy obsługi pamięci. Jedynym rozwiązaniem jest wówczas wywołanie funkcji API poza oknem .net’owym. Najprościej uzyskać taki efekt tworząc osobną aplikację wywoływaną z poziomu linii poleceń z odpowiednimi parametrami. Dzięki temu udaje się ominąć problemy z obsługą pamięci.

Wywoływanie funkcji API z poziomu danego dokumentu

Niestety nie ma możliwości wywołania większości funkcji API z poziomu edytowanego dokumentu. Najczęściej stosuje się podobne próby w sytuacji, gdy podczas wystawiania jednego dokumentu zachodzi potrzeba wystawienia innego dokumentu. Z technicznego punktu widzenia taka sytuacja jest możliwa do obsłużenia, tzn. z poziomu jednego dokumentu możemy wywołać dodanie innego dokumentu. Najczęściej nie jest jednak wtedy możliwe prawidłowe zamknięcie pierwszego dokumentu, który pozostanie w bazie jako aktywny. Jest to spowodowane współdzieleniem przez obie sesje (XLa i API) informacji w tabeli ObiektyObce. Wówczas konieczne jest wywołanie nowego dokumentu dopiero po zamknięciu pierwszego.

Ograniczenia callbacków plikowych

Stosowanie callbackow plikowych ma swoje ograniczenia. Aby callback został wykonany niezbędne jest podniesienie danej formatki. Ma to istotne znaczenie zwłaszcza w przypadku obsługi menu kontekstowego i opcji pociągających za sobą update na elemencie. Przykładowo potwierdzenie lub anulowanie dokumentu handlowego nie spowoduje wyzwolenia callbacka zapiętego na akcję updateaction gdyż modyfikacja odbywa się bez otwierania danego okna. Inaczej natomiast wygląda sytuacja z usuwaniem takiego dokumentu z listy – w tym przypadku jest to obsłużone przez mechanizm Clariona, który podnosi okno w tle i dzięki temu callback zostanie wykonany.

Hydra i nowy interfejs

 

Pliki do pobrania:

ERPXL_Hydra    

Błąd podczas dodawania atrybutów dla towaru: (Violation of PRIMARY KEY constraint ‘PK_Attachments’. Cannot insert duplicate key in object ‘CDN.Attachments’. The duplicate key value is (213)

Komunikat informuje nas o tym, iż do e-Sklepu wysyłany jest zduplikowany załącznik o ID 213.

Opis zdarzenia:|Błąd podczas eksportu danych: Wystąpił nieoczekiwany błąd podczas wysyłania danych:Synchronization_ImportProductsRelated 14, 1 2627: Violation of PRIMARY KEY constraint 'PK__#Product__DCE249BD17CE2A6B'. Cannot insert duplicate key in object 'dbo.#ProductsRelated'. The duplicate key value is (1, 5649, 8373, -2).

The statement has been terminated.|

Komunikat pojawia się po stronie loga automatycznej synchronizacji i informuje o tym, że do e-Sklepu wysyłane są zduplikowane zamienniki. W powyższym przypadku dla towaru o ID 5649 kilkukrotnie wysyłany jest zamiennik o ID 8373.

Remedium: Należy zweryfikować, czy na karcie towaru dany zamiennik znajduje się więcej, niż jeden raz.

Opis zdarzenia:|Błąd podczas eksportu danych: Wystąpił nieoczekiwany błąd podczas wysyłania danych:Synchronization_ImportProductsRelated 14, 1 2627: Violation of PRIMARY KEY constraint 'PK__#Product__DCE249BD17CE2A6B'. Cannot insert duplicate key in object 'dbo.#ProductsRelated'. The duplicate key value is (2, 5649, 8373, -2).

The statement has been terminated.|

Komunikat pojawia się po stronie loga automatycznej synchronizacji i informuje o tym, że do e-Sklepu wysyłane są zduplikowane komplety. W powyższym przypadku dla towaru o ID 5649 kilkukrotnie wysyłany jest komplet o ID 8373.

Remedium: Należy zweryfikować, czy na karcie towaru dany komplet znajduje się więcej, niż jeden raz.

Duplikacja kontrahenta o ID: 5516

Komunikat pojawia się w sytuacji, gdy do e-Sklepu wysyłanych jest wielu kontrahentów o adresie e-mail podanym na kontrahencie o ID 5516.

Remedium: Zmienić powtarzające się adresy e-mail na kontrahentach wysyłanych do e-Sklepu

Błąd podczas eksportu danych: Wystąpił błąd:[HRESULT=”0x80040e57” Description=”Wykonywanie instrukcji zostało przerwane.”HRESULT=”0x80040e57” Description=”Dane w postaci ciągu lub dane binarne zostaną obcięte.”]

Komunikat informuje o tym, iż w polach na wysyłanych towarach przekroczone zostały zakresy zmiennych dopuszczalnych w procedurach eksportujących dane do e-Sklepu.

Remedium: Najczęstszym powodem pojawiania się takiego komunikatu jest zbyt długa nazwa załączanego do synchronizacji z e-Sklepem pliku. Należy odszukać załącznik i skrócić nazwę lub też dokonać modyfikacji procedury CDN.ESKLEP_EksportTwr DABKOD zwiększając ilość znaków z 40. do 99.

Błąd podczas eksportu danych: Wystąpił nieoczekiwany błąd podczas wysyłania danych-5:CDN.Synchronization_ImportXML 16, 1 50000: Synchronizacja już trwa na innym stanowisku (Synchronization id already in progres)

Remedium: Wymagany jest kontakt z asystą e-Sklepu, Komunikat pojawi się w sytuacji, w której automat rozpoczyna synchronizacje w momencie gdy poprzednia synchronizacja jeszcze nie została zakończona lub wykonywanie ręcznej synchronizacji w momencie gdy włączony jest automat synchronizacji.

Błąd podczas eksportu danych: Błąd podczas tworzenia pliku XML:Wystąpił błąd [HRESULT=”0x80004005” Description=”Cannot continue the execution because the session is the kill state.”]

Remedium: Przyczyną może być wykonanie synchronizacji w trakcie restartu serwera

Synchronizacja danych z Comarch e-Sklep do Comarch ERP XL

Błąd podczas dodawnia zamówienia o ID=24481 - Kontrahent nie istnieje - <ZAM ID="24481" Typ="2" DataWystawienia="78941" DataWys="540386763" FormaPlID="2" FormaPl="PayU" SposobDostawy="Przesyłka kurierska [UPS] - Przelew" KosztPrzesylki="13.99" TypTransakcji="1" KodKraju="" Waluta="PLN" KntID="465" KntNazwa1="Beata Stawiarska" KntNazwa2="Marsh sp. z oo" KntNazwa3="" KntUlica="Niemcewicza" KntNrBudynek="26" KntNrLokal="66"KntKodP="02-306"KntMiasto="Warszawa" KntWojewodztwo="mazowieckie" KntNIP="" KntNIPUE=

Komunikat może świadczyć o nieprawidłowości w mapowaniu kontrahenta w Comarch ERP XL oraz w Comarch e-Sklep i tym samym braku wpisu w tabeli cdn.PicoLog, w której znajdują się powiązania GIDNumerów obiektów w bazie systemu z ID obiektów w bazie e-Sklepu.

Remedium:

W razie braku wpisu na danego kontrahenta należy wykonać update wedle poniższego wzoru:

INSERT INTO CDN.PicoLog

VALUES

(PcL_ID, ID oddziału e-Sklep, 32,  GIDNumer kontrahenta w bazie systemu, KntID, null, 'Kontrahent-KntNazwa1', '', DATEDIFF(s,convert(datetime,'1990-01-01',120),'2017-02-28 15:50:09.000'))

Można również zweryfikować czy w tabeli cdn.PicoLog znajduje się wpis dla danego kontrahenta. W przypadku braku wpisu należy dodać wpis w PicoLog (po uprzednim wykonaniu backupu bazy danych) poprzez odpowiedni insert. Przy samym insercie trzeba zwrócić uwagę na 3 pola: Pcl_ObiektID - id kontrahenta w e-Sklepie PcL_Obinumer - GIDnumer kontrahenta w bazie XL PcL_PcKID – ID Oddziału esklepu (należy zwrócić uwagę czy został utworzony nowy oddział w tym czasie)

Poniżej przykładowy wpis dla kontrahenta o GIDnumerze 25, ID 17 w sklepie dla oddziału sklepu o ID 9.

Błąd podczas dodawania nagłówka zamówienia o ID=1-XLNowyDokumentZam(33) <ZAM ID=”1”Typ=”2”DataWystawienia=”77977”(…)

Komunikat zwracany przez API XLNowyDokumentZam(33) świadczy o tym, iż operator wykonujący synchronizację ręczną/zalogowany do automatu synchronizacji/zalogowany do usługi synchronizacji nie posiada uprawnień do modułu Zamówień jak również sytuację, w której operator ma uprawnienia, lecz w momencie logowania do systemu licencja na ten moduł nie był dostępna na kluczu i nie została pobrana.

Remedium: Należy zaznaczyć moduł Zamówienia na operatorze, opcjonalnie przelogować moduł Administratora Oddziałów. Jeżeli operator posiada zaznaczony moduł Zamówień, należy zweryfikować czy na kluczu znajduje się wolna licencja.

Błąd podczas dodawania kontrahenta ESKL2_19 – NowyKontrahentSQL(61) - <KNT ID=”19” GIDNumer=”-1”(…)

Komunikat zwracany przez API NowyKontrahentSQL(61) zwracany jest w przypadku utraty sesji na operatorze wykonującym synchronizację ręczną/zalogowanym do automatu lub usługi.

Remedium: Należy ponownie zalogować operatora poprzez ponowne uruchomienie CDNSynchro bądź Administratora Oddziałów.

Błąd podczas dodawania nagłówka zamówienia o ID=605 – XLNowyDokumentZam(51) <ZAM ID=”605”Typ=”2”(…)

Komunikat zwracany przez API XLNowyDokumentZam(51) zwracany jest w przypadku gdy do systemu próbuje się zaimportować zamówienie złożone na kontrahenta archiwalnego.

Remedium: Odznaczyć archiwalność kontrahenta w celu wczytania dokumentu.

Błąd podczas dodawnia nagłówka zamówienia o ID=68 - XLNowyDokumentZam(2) <ZAM ID="68" Typ="1" DataWystawienia="78972" DataWys="543072806" FormaPlID="3" FormaPl="Przelew bankowy" SposobDostawy="Przesyłka kurierska" KosztPrzesylki="20.00" TypTransakcji="1" KodKraju="" Waluta="PLN" KntID="541" KntNazwa1="Aflofarm Farmacja Polska" KntNazwa2="" KntNazwa3="" KntUlica="Partyzancka" KntNrBudynek="133" KntNrLokal="151/" KntKodP="95-200" KntMiasto="Pabianice" KntWojewodztwo="łódzkie" KntNIP="7311821205" KntNIPUE=""

Komunikat może być powiązany z komunikatem NowyAdres(2) oznaczającym- Wystąpił błąd przy próbie zablokowania tabel dla wykonania transakcji.

Problem występuje podczas insertu na bazę danych podczas importu z e-Sklepu. Przyczyna: brak uprawnień użytkowników od strony serwera SQL bądź dodatkowe rozwiązania.

Błąd podczas dodawnia nagłówka zamówienia o ID=15250 BŁĘDY [Brak praw do dokumentu. (NowyDokumentZam-41)

Rozwiązaniem problemu może być wykonanie update na bazie:

Update cdn.konfig set kon_wartosc=0 where kon_numer=-143.

Błąd podczas importu danych – Procedura CDN.XLNowaReklamacja zwróciła błąd nr 3

Remedium: Numer 3 wskazuje na brak dokumentu reklamowanego lub towaru. Należy wykonać zmianę statusu reklamacji w panelu administracyjnym e-Sklepu oraz ponowić synchronizację.

Błąd. Błąd podczas dodawania towaru: Niepoprawna struktura danych – niepoprawny status dostępności towaru

Komunikat  świadczy o braku lub niepoprawności ustawienia statusu dostępności w systemie ERP. Przykładowo: na kartotece towarowej w systemie ERP XL na zakładce Aplikacje jest ustawiony status: Dostępny, natomiast status dostępności pozostaje pusty.

Dodatkowo dla masowej zmiany wartości wskazanych ustawień na karcie towaru można wykorzystać update na bazie danych, wskazaną zmianę należy w pierwszej kolejności wykonać na kopi zapasowej bazy danych. (obinumertowaru należy podstawić gidnumer karty towarowej, możliwe wartości dla kolumn TAP_status oraz TAP_Dostepnosc zostały opisane w dokumentacji tabel)

Synchronization_ImportBinaryData Dane binarne zawierają dane skompresowane, skontaktuj się z Asystą Comarch ERP

W przypadku komunikatu o skompresowanych danych należy zweryfikować czy dla załącznika pola DAB_TypId=326 (typ obraz) w tabeli ERP XL cdn.danebinarne oraz czy DAB_Rozmiar=0 w tej samej tabeli. Jeśli DAB_Rozmiar jest różny od 0 należy zmienić ustawienia dla typu załącznika obraz zgodnie ze zrzutem, następnie usunąć załącznik i dodać ponownie.

Po dokonanych zmianach należy dokonać pełnej synchronizacji. Dodatkowo dla optymalizacji załączników można skorzystać za aplikacji poprawiającej załączniki. Pod wskazanym adresem znajduje się opis oraz instrukcja dla aplikacji:

https://spolecznosc.comarch.pl/index.php/viewpost/post28780/Obrazki-w-Comarch-e-Sklep-Comarch-B2B-ERP  

Problemy techniczne

Komunikaty związane z wystąpieniem Timeout podczas automatycznej synchronizacji danych mogą być związane ze zbyt dużą ilością danych, które system próbuje wysłać w zbyt krótkim czasie. W takiej sytuacji należy zweryfikować, jaki typ synchronizacji cennika został wybrany na definicji oddziału. W razie wystąpienia problemu należy wybrać eksport różnicowy:

Pomimo prawidłowo zdefiniowanej usługi synchronizacji dla oddziału e-Sklepu synchronizacja danych nie wykonuje się.

Remedium: Należy zweryfikować, czy w zmiennej środowiskowej %PATH% podano ścieżkę do jednej tylko, aktualnie zainstalowanej wersji XL-a, w której baza współpracuje z aplikacją Comarch ERP e-Sklep.

Przyklad

1. Wersją zainstalowaną jest wersja 2019.1 Następnie pobrano kompilację w wersji aktualnej i na niej wykreowano/bądź podniesiono bazę współpracującą z Comarch ERP e-Sklep. W takiej sytuacji usługa może nie zadziałać.

Przyklad

2. Jeżeli na jednym serwerze na bazie A, na oddziale o ID=1 zdefiniujemy usługę do synchronizacji z MOS, a na bazie B, na oddziale o ID=1 zdefiniujemy usługę do synchronizacji z e-Sklepem to usługa synchronizacji z e-Sklepem nie zadziała.

Najczęściej zadawane pytania

Czy można zasilić Comarch e-Sklep innym sposobem, niż synchronizacja z systemem ERP?

Comarch e-Sklep można zasilić wyłącznie poprzez synchronizację z systemem ERP tj. XL, Altum, Optima, XT oraz Enterprise. W przyszłości planowane jest również funkcjonowanie e-Sklepu jako standalone.

Synchronizacja z Comarch e-Sklep przebiega bezbłędnie, jednak po stronie e-Sklepu nie widać żadnych towarów.

Należy zweryfikować, czy na towarach, które mają być wysyłane do e-Sklepu zaznaczono parametr dostępności w aplikacji. Ponadto grupa wybrana na oddziale e-Sklepu musi posiadać podgrupy towarowe.

W jaki sposób uruchomić synchronizację automatyczną z e-Sklepem?

W celu uruchomienia synchronizacji automatycznej należy na oddziale e-Sklepu zaznaczyć parametr Synchronizacja automatyczna oraz z poziomu katalogu XL-a uruchomić komponent CDNSynchro.

W jaki sposób uruchomić synchronizację z e-Sklepem przy pomocy usługi?

W celu uruchomienia synchronizacji przy pomocy usługi należy na oddziale e-Sklepu zaznaczyć parametr Synchronizuj z wykorzystaniem usługi. Należy ponadto zdefiniować odpowiednią usługę z poziomu Administratora oddziałów.

Na definicji załącznika został zaznaczony parametr dostępności w e-Sklepie. Na karcie towarowej, w zakładce Załączniki również został zaznaczony parametr dostępności w e-Sklepie dla danego załącznika. Mimo to zdjęcie główne nie jest wysyłane do e-Sklepu.

Należy zweryfikować jaką pozycję na liście załączników przypiętych do towaru zajmuje to zdjęcie. Jako zdjęcie główne wysyłane jest pierwsze zdjęcie z listy załączników.

W jaki sposób prawidłowo udostępnić załącznik towaru do e-Sklepu?

Załącznik dodajemy na karcie towarowej, w zakładce załączniki, wykorzystując przycisk import z pliku , załącznik musi spełnić wymagania co do rozmiaru, typu pliku oraz wymiarów. Dostępność w e-Sklepie zatwierdzamy poprzez zaznaczenie na zakładce Ogólne załącznika przycisku e-Sklep. Jeżeli przycisk nie był zaznaczony a wykonaliśmy synchronizację, ważne jest również aby upewnić się, że dostępność e-sklep jest także zaznaczona w zakładce Obiekty.

Ogólna struktura mechanizmu wydruków

Wydruki kodów kreskowych w programie ERP XL, realizowane są przy pomocy funkcjonalności tak zwanych wydruków XML. Całość instrukcji dotyczących definicji wydruków zawarta jest w pliku o rozszerzeniu XPT, który jest importowany do programu ERP XL. Dla lepszego zobrazowania posłużono się przykładem pliku Wydruk.xpt przeznaczonego dla drukarki Datamax.

Struktura pliku XPT

Plik o rozszerzeniu XPT składa się z dwóch części. Pierwszej [SQL] zawierającej zapytania SQL, oraz drugiej [XSL]. Przykładowy plik Wydruk.xpt wygląda następująco:

[SQL]

select Twr_Kod,Twr_EAN FROM cdn.TwrKarty WHERE ?@Hs200_NQ|Filtr:''@?

[XSL]

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

<xsl:output omit-xml-declaration="yes"/>

<xsl:preserve-space elements="*"/>

<xsl:template match="/">

<xsl:for-each select="ROOT">

<xsl:apply-templates select="RECORDSET1"/>

</xsl:for-each>

</xsl:template>

<xsl:template match="RECORDSET1">

<xsl:apply-templates select="RECORD"/>

</xsl:template>

<xsl:template match="RECORD">

&#02;&#10;H07&#10;D11&#10;m&#10;1911008000800041&#10;<xsl:value-of select="@Twr_Kod" />&#10;3a6210000000050&#10;<xsl:value-of select="@Twr_EAN" />&#10;PCS&#10;E&#10;

</xsl:template>

</xsl:stylesheet>

Sekcja SQL

Sekcja ta zawiera zapytania SQL (w przypadku naszego przykładu jedno zapytanie), które zostaną zadane do bazy i na podstawie zwróconych odpowiedzi utworzony zostanie plik XML o określonej strukturze.

Uwaga

Zalecane jest, aby nie korzystać z zapytań typu select *. Przy wpisywaniu nazw kolumn należy zwrócić uwagę na wielkość liter gdyż XML jest ‘case sensitive’

Zastosowanie w sekcji WHERE wyrażenia ?@s200H_NQ|Filtr:''@? spowoduje wstawienie w jego miejsce filtru przekazanego z programu. Jest to tak zwany parametr dynamiczny. Struktura pliku XML otrzymanego w wyniku zapytań SQL wygląda następująco:

<ROOT>

<RECORDSET1>

<RECORD NazwaKolumny1=”wartość kolumny 1” NazwaKolumny2=”Wartość kolumny 2” />

<RECORD NazwaKolumny1=”wartość kolumny 1” NazwaKolumny2=”Wartość kolumny 2” />

</RECORDSET1>

<RECORDSET2>

<RECORD NazwaKolumny1=”wartość kolumny 1” NazwaKolumny2=”Wartość kolumny 2” />

<RECORD NazwaKolumny1=”wartość kolumny 1” NazwaKolumny2=”Wartość kolumny 2” />

</RECORDSET2>

……

</ROOT>

Każdy XML wygenerowany z zapytań z sekcji [SQL] rozpoczyna się od Tagu <ROOT>. Tagi <RECORDSETn> odpowiadają kolejnym zapytaniom select tzn. pierwszy select generuje <RECORDSET1> itd. Każdy wiersz z odpowiedzi przedstawiony jest w formie Tagu <RECORD>. Każdy z nich posiada tyle atrybutów, ile kolumn zwraca zapytanie. Nazwa atrybutu odpowiada nazwie kolumny a wartość atrybutu wartości kolumny.

Plik XML dla naszego przykładu może więc wyglądać następująco:

<ROOT>

<RECORDSET1>

<RECORD Twr_Kod=”MAG770T” Twr_EAN=”8” />

</RECORDSET1>

</ROOT>

Sekcja XSL

Sekcja zawiera schemat, który jest „nakładany” na XML z danymi. Tłumaczy plik XML na język poleceń drukarki. W naszym przykładzie dla Tagu <RECORD> zdefiniowany został zestaw instrukcji dla drukarki:

&#02;&#10;H07&#10;D11&#10;m&#10;1911008000800041&#10;<xsl:value-of select="@Twr_Kod" />&#10;3a6210000000050&#10;<xsl:value-of select="@Twr_EAN" />&#10;PCS&#10;E&#10;

W instrukcjach sterujących drukarką osadzone zostały instrukcje xsl-a, pozwalające na wykorzystanie danych uzyskanych z zapytania SQL.

W przypadku innych typów drukarek należy przeczytać dokumentację producenta w celu zapoznania się ze składnią instrukcji sterujących dla drukarki.

Uwaga

W przypadku niektórych drukarek język instrukcji sterujących drukarką jest dość skomplikowany np. drukarki DYMO. Dlatego w ich przypadku należy posłużyć się zestawem obiektów COM, dostarczanych przez producenta.

Struktura pliku XPT będzie więc różnić się od przedstawionej w przykładzie. Przykładowy plik XPT zawierający instrukcje sterujące dla drukarki DYMO wygląda następująco:

[SQL]

select Twr_Kod,Twr_Nazwa,Twr_GrupaPod,Twr_EAN FROM cdn.TwrKarty where ?@Hs200_NQ|Filtr:''@?

[XSL]

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:ms="urn:schemas-microsoft-com:xslt" xmlns:usr="urn:the-xml-files:xslt" version="1.0">

<xsl:output omit-xml-declaration="yes" method="html"/>

<ms:script language="VBScript" implements-prefix="usr">

<![CDATA[

Function PrintEan(Ean)

Dim DymoAddIn, DymoLabel

Set DymoAddIn = CreateObject("DYMO.DymoAddIn")

Set DymoLabel = CreateObject("DYMO.DymoLabels")

DymoAddIn.Open "C:\Program Files\Dymo Label\Label Files\Barcode Label (30252, 30320).LWL"

DymoLabel.SetField "Barcode",Ean

DymoAddIn.Print 1, TRUE

PrintEan=""

End Function

]]>

</ms:script>

<xsl:output omit-xml-declaration="yes"/>

<xsl:preserve-space elements="*"/>

<xsl:template match="/">

<xsl:for-each select="ROOT">

<xsl:apply-templates select="RECORDSET1"/>

</xsl:for-each>

</xsl:template>

<xsl:template match="RECORDSET1">

<xsl:apply-templates select="RECORD"/>

</xsl:template>

<xsl:template match="RECORD">

<xsl:value-of select="usr:PrintEan(123456)"/>

</xsl:template>

</xsl:stylesheet>

W przypadku drukarek DYMO najwygodniej posłużyć się językiem skryptowym. W naszym przykładzie jest to VBscript.

<ms:script language="VBScript" implements-prefix="usr">

Dzięki temu można łatwo zdefiniować funkcje, w których można wykorzystać obiekty COM, dostarczone przez producenta.

Założenia ogólne

Wszystkie liczby określające położenie i rozmiar obiektów są podane w jednostkach 1/10 mm. Tworzenie elementów w określonej przez opis kolejności, pozwali otrzymać prawidłowy wygląd elementów.

Obszar wydruku

Przyjęcie poniższych wartości pozwala na uzyskanie poprawnego wydruku na wszystkich drukarkach atramentowych (mają one mniejszy obszar drukowania niż laserowe)

Marginesy ustawiane w wydrukach standardowych:

Zmniejszenie marginesów lewego i prawego pozwala na umożliwienie automatycznego przesunięcia wydruku, tak by nadawał się on do wpięcia do skoroszytu. W trybie landscape można zmniejszyć margines lewy albo prawy do wielkości 7 mm – wydruk zostanie automatycznie dostosowany do trybu landscape jaki supportuje drukarka (90 lub 270 stopni)

Standard prezentacji danych

Ogólne założenia co do wyglądu elementów wydruku: • Opisy elementów – czcionka normalnej grubości, Times New Roman CE • Kluczowe elementy (wartości liczbowe, daty itp.) - czcionka pogrubiona, Courier New CE • Opisy kolumn list – w ramce o grubości 10; bez pionowych linii dzielących na kolumny, oddalone o 10 jednostek w pionie od poprzedniego elementu

Wydruk typu „Lista”

Obiekty o numerach 1, 2, 3, 4 umieszczamy w sekcji „PAGE HEADER”

Obiekty 5, 6, 7 umieszczamy w sekcji „GRAND TOTALS”

Obiekt 1. [Ramka pieczątki firmy]

Ramka pieczątki firmy:

BOX(Black, White, 275, 5, No, 920, 0, 10) - „Send to back”

BOX(Black, Black, 275, 5, No, 920, 10, 20) - „Send to back”

Obiekt 2. [Elementy pieczątki firmy]

Elementy pieczątki firmy przekazywane są poprzez parametry: CDN_FIRMA1, CDN_FIRMA2, CDN_FIRMA3, CDN_FMIASTO, CDN_FULICA

Pieczątkę firmy drukujemy czcionką: TIMES NEW ROMAN; rozmiar = 10, normalna grubość

Pola pieczątki firmy umieszczamy jedne po drugimi w odstępie 50 jednostek, począwszy od punktu o współrzędnych (10,20). Wszystkie pola wyrównujemy do współrzędnej X=10. Szerokość wszystkich elementów ustawiamy na 900 jednostek.

Obiekt 3. [Tytuł wydruku]

Tytuł wydruku jest odpowiednim, polem tekstowym sformatowanym wg poniższego przykładu:

STRING(Silver, Times New Roman CE, 14, Black, Bold, No, No, No, 0, Center, ‘Plan Kont’, No, 930, 940, 10)

LANDSCAPE: do współrzędnej X dodajemy 685

Obiekt 4. [Listwa z numerem strony]

BOX(Default, Silver, 55, 0, No, 930, 940, 240) – „Send to Back”

STRING(Silver, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Right, ‘Strona:’, No, 145, 1675, 242)

Zmienna z numerem strony: PG#(Silver,,Times New Roman CE, 10, Black, Normal, No, No, No, 0, Left, @n3, No, No, 80, 1795, 242)

LANDSCAPE: do współrzędnej X dodajemy 685

Obiekt 5. [Listwa z opisem wydruku]

Sekcja kończąca wydruk rozpoczyna się podkreśleniem elementów oraz umieszczoną pod nim listwą z opisem wydruku (operator drukujący, liczba stron, data sporządzenia wydruku). Dane operatora drukującego są przekazywane do wydruku poprzez zmienną CDN_OPERATOR.

Współrzędna Y wszystkich elementów obiektu są zależne od wcześniej umieszczonych elementów zmiennych wydruku (np. Podsumowania) – dlatego w opisie właściwości obiektów są one zastąpione napisem „YYY”. Na

tej współrzędnej położone jest podkreślenie, współrzędne Y pozostałych obiektów podane są jako przesunięcie w stosunku do położenia podkreślenia (np. YYY+8) – dotyczy to także elementów składających się na obiekt nr.6

HLINE(Black, 10, 1873, 0, YYY)

BOX(Default, Silver, 55, 0, No, 1873, 0, YYY+5) – „Send to back”

STRING(Silver, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘Operator drukujący:’, No, 290, 4, YYY+8)

FIELD(Silver, CDN_Operator, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 660, 300, YYY+8)

STRING(Silver, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘Liczba stron:’, No, 185, 1600, YYY+8)

PG#( Silver,,Times New Roman CE, 10, Black, Normal, No, No, No, 0, Left, @n3, No, No, 80, 1790, YYY+8)

Jeżeli data wydruku nie została umieszczona w sekcji „PAGE HEADER”, to umieszczamy ja na listwie z opisem wydruku, wg poniższych danych: Datę wydruku obliczamy wyrażeniem „TODAY()” – dla jasności opisu formułę zawierającą to wyrażenie nazwę „DZISIAJ”

STRING(Silver, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘Data wydruku:’, No, 215, 970, YYY+8)

FIELD(Silver, DZISIAJ, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Left, @d10, No, No, 230, 1190, YYY+8)

LANDSCAPE: Dla obiektów o pełnej szerokości strony (HLINE i BOX) zwiększamy szerokość o 685;

Obiekt ‘Liczba stron:’ ustawiamy na wsp. X =2290

Obiekt ‘PG#’ ustawiamy na wsp. X=2480

Obiekt ‘Data wydruku: ‘ ustawiamy na wsp. X=1780

Obiekt ‘DZISIAJ’ ustawiamy na wsp. X=2000

Obiekt 6. [Zastosowany Filtr]

Do wydruku przy pomocy parametru CDN_Filtr przekazywany jest filtr jaki został zastosowany w momencie jego uruchomienia. Ponieważ może on być stosunkowo długi, rozkładamy go na 3 części, tworząc następujące formuły:

FILTR_P1: IF CDN_FILTR<>’’ THEN ‘Zastosowano filtr: ‘&SUB(CDN_FILTR,1,85) ELSE ‘’

FILTR_P2: SUB(CDN_FILTR,86,85)

FILTR_P3: SUB(CDN_FILTR,172,85)

Rozmieszczenie formuł na wydruku:

FIELD(Default, FILTR_P1, Courier New CE, 8, Black, Normal, Yes, No, No, 0, Default, @s115, Yes, No, 1873, 0, YYY +66)

FIELD(Default, FILTR_P2, Courier New CE, 8, Black, Normal, Yes, No, No, 0, Default, @s115, Yes, No, 1873, 0, YYY +103)

FIELD(Default, FILTR_P2, Courier New CE, 8, Black, Normal, Yes, No, No, 0, Default, @s115, Yes, No, 1873, 0, YYY +140)

Jeżeli w wydruku stosujemy własne parametry, mające wpływ na filtr to poniżej umieszczamy napis ‘GDZIE’ oraz kolejno opis tych parametrów ( <nazwa> = <wartość> ):

STRING(Default, Courier New CE, 8, Black, Normal, Yes, No, No, 0, Deafult, ‘Gdzie: ‘, 120, 0, YYY+177)

Wszystkie opisy zmiennych drukujemy takim samym fontem jak filtr. Opisy te wyrównujemy do lewej do współrzędnej X=130

LANDSCAPE: W tym trybie ustawiamy szerokość pól na 2565 jednostek

Obiekt 7. [Listwa kończąca wydruk]

Współrzędne Y elementów tego obiektu zależą od ilości danych umieszczonych w obiekcie nr. 6. Odległość od ostatniego elementu obiektu 6 ustalmy na 10 jednostek. Dla czytelności zapisu zamiast wsp. Y wpisany będzie napis „YYY”

BOX(Default, Silver, 55, 0, No, 1873, 0, YYY)

STRING(Silver, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘*** Koniec Wydruku ***’, No, 290, 4, YYY+3)

Dodajemy jeszcze pole identyfikujące aplikacje drukującą. Wstawiamy tutaj tekst wg zasady: jeżeli jednoznacznie możemy określić z jakiego modułu pochodzi wydruk, drukujemy napis „CDN XL” + nazwa modułu (np. „CDN XL Księgowość”); W przeciwnym wypadku drukujemy sam napis „CDN XL”

STRING((Silver, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Right, ‘CDN XL ...’, No, 420, 1450, YYY+3)

LANDSCAPE: Elementowi BOX ustawiamy szerokość na 2565 Pole identyfikujące aplikację umieszczamy na wsp. X=2135

Wygląd dokumentów handlowych (Faktury)

Obiekt 1. [Ramka pieczątki firmy]

GROUP(White, Yes, Times New Roman CE, 10, Black, Normal, No, No, No, 330,’Sprzedawca’, 920, 0,0) – „Send to back”

BOX(White, White, 310, 0, No, 920, 0,20) – „Send to back”

BOX(Black, Black, 310, 0, No, 920, 13,35) – „Send to back”

Obiekt 2. [Elementy pieczątki firmy]

Elementy pieczątki firmy przekazywane są poprzez parametry: CDN_FIRMA1, CDN_FIRMA2, CDN_FIRMA3, CDN_FMIASTO, CDN_FULICA, CDN_FNIP

Pieczątkę firmy drukujemy czcionką: TIMES NEW ROMAN; rozmiar = 10, Bold

Pola pieczątki firmy (oprócz CDN_FNIP) umieszczamy jedne po drugimi w odstępie 45 jednostek, począwszy od punktu o współrzędnych (10,40). Wszystkie pola wyrównujemy do współrzędnej X=10. Szerokość wszystkich elementów ustawiamy na 900 jednostek.

Numer NIP:

STRING(Default, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, ‘NIP:’, 85, 10, 265)

FIELD(Default, CDN_FNIP, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s13, No, No, 365, 95, 265)

Obiekt 3. [Nagłówek dokumentu]

Tytuł dokumentu: W tytule dokumentu umieszczamy formułę (nazwijmy ją „DOK_TYTUL”), która zwraca nam konkatenację typu dokumentu (Faktura VAT, Rachunek Uproszczony itp.) i odpowiednio sformatowanego numeru dokumentu (np. „Faktura VAT nr. 1245/99/CDX”).

FIELD(Silver, DOK_TYTUL, Times New Roman CE, 14, Black, Bold, 0, Center, @s40, No, No, 925, 940,10)

Listwa z numerem strony i oznaczeniem kopii:

BOX(Default, Silver, 65, 0, No, 925, 240, 280) – „Send to back”

STRING(Silver, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Right, ’Strona’, 105, 1665, 288)

Zmienna z numerem strony: PG#(Silver,,Times New Roman CE, 10, Black, Normal, No, No, No, 0, Left, @n3, No, No, 80, 1790, 288)

Poprzez parametr CDN_NRKOPII przekazywany jest do wydruku numer drukowanej kopii. Pozwala to na wydrukowanie od razu oryginału i kopii dokumentu. Realizujemy to formułą: ORYGINAL_KOPIA: CHOOSE(CDN_nrKopii>0,' KOPIA',' ORYGINAŁ')

Umieszczoną wg danych: FIELD(Silver, ORYGINAL_KOPIA, Times New Roman CE, 12, Black, Bold, No, No, No, 0, Left, @s10, No, No, 300,940,280)

Zawartość nagłówka oryginału:

STRING(Default, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘Data wystawienia:’, 280, 1355, 110)

STRING(Default, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘Data sprzedaży’, 280, 1355, 165)

FIELD(Default, TRN_Data2, Courier New CE, 10, Black, Bold, No, No, No, 0, Right, @d10, No, No, 220, 1645, 110) FIELD(Default, TRN_Data3, Courier New CE, 10, Black, Bold, No, No, No, 0, Right, @d10, No, No, 220, 1645, 165)

Obiekt 4. [Dane nabywcy–odbiorcy / sprzedawcy-dostawcy]

Napis „Nabywca” („Sprzedawca” dla dokumentów zakupu) STRING(Default, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘Nabywca:’, 220, 10, 350)

Napis „Odbiorca” („Dostawca” dla dokumentów zakupu) STRING(Default, Times New Roman CE, 10, Black, Normal, No, No, No, 0, Default, ‘Odbiorca’, 220, 930, 350)

Adres nabywcy/sprzedawcy (pobrany z tabeli KntAdresy standardowo połączonej z tabelą TraNag)

FIELD(Default, KnA:Kna_Nazwa1, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 40, 400)

FIELD(Default, KnA:Kna_Nazwa2, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 40, 445)

FIELD(Default, KnA:Kna_Nazwa3, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 40, 490)

Kod pocztowy łączymy z miastem kontrahenta formułą KNTMIASTO: IF KnA:KnA_KodP='00-000' THEN KnA:KnA_Miasto ELSE KnA:KnA_KodP&' '& KnA:KnA_Miasto

FIELD(Default, KNTMIASTO, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 40, 535)

FIELD(Default, KnA:Kna_Ulica, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s30, No, No, 0, 40, 580)

NIP kontrahenta drukujemy za pomocą formuły KNTNIP: 'NIP: ' & KnA:KnA_NipE FIELD(Default, KNTNIP, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s30, No, No, 0, 40, 625)

Adres odbiorcy/dostawcy (pobrany z aliasu KntAdresy połączonego z tabelą TraNag poprzez Trn_AdWGID – GID adresu wysyłkowego)

FIELD(Default, KnAA:Kna_Nazwa1, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 950, 400)

FIELD(Default, KnAA:Kna_Nazwa2, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 950, 445)

FIELD(Default, KnAA:Kna_Nazwa3, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 950, 490)

Kod pocztowy łączymy z miastem kontrahenta formułą ODBMIASTO: IF KnAA:KnA_KodP='00-000' THEN KnAA:KnA_Miasto ELSE KnAA:KnA_KodP&' '& KnAA:KnA_Miasto

FIELD(Default, ODBMIASTO, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s50, No, No, 0, 950, 535)

FIELD(Default, KnAA:Kna_Ulica, Times New Roman CE, 10, Black, Bold, No, No, No, 0, Default, @s30, No, No, 0, 950, 580)

Obiekt 5. [Opis dokumentu]

W skład tego obiektu wchodzi opis sposobu dostawy i opis dokumentu (tytuły i wartości). Tytuły tych pól realizujemy formułami: SPOSOBDOSTAWY: IF TrN:TrN_SposobDostawy='' THEN '' ELSE 'Sposób dostawy: '

OPISDOKUMENTU: IF TnO:TnO_Opis='' THEN '' ELSE 'Opis dokumentu: '

FIELD(Default, SPOSOBDOSTAWY, Times New Roman CE, 9, Black, Normal, No, No, No, 0, Center, @s16, 300, 10, 685)

FIELD(Default, OPISDOKUMENTU, Times New Roman CE, 9, Black, Normal, No, No, No, 0, Center, @s16, 300, 10, 730)

FIELD(Default, TrN:TrN_SposobDostawy, Times New Roman CE, 9, Black, Bold, No, No, No, 0,Default, @s20, 570, 315, 685)

FIELD(Default, TnO:TnO_Opis, Times New Roman CE, 9, Black, Bold, No, No, No, 0,Default, @s255, 1550, 315, 730)

Obiekt 6. [Harmonogram płatności]

Umieszczony jest w sekcji „GRAND TOTALS”

BOX (Default, Silver, 50, 10, No, 918, 0, 0) HLINE(Black, 10, 918,0,50)

STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘Forma płatności’, Yes, 257, 4, 1) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘Termin’, Yes, 177, 335, 1) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘Forma’, Yes, 117, 750, 1)

Kolumna form płatności: od współrzędnej (4,54) 4 wiersze co 45 jednostek; picture @s15, szerokość =0 Kolumna terminów płatności: od współrzędnej (335,54) 4 wiersze co 45 jednostek; picture @s10, szerokość =0 Obie powyższe kolumny drukujemy czcionką Times New Roman CE; rozmiar=9 ; normalna grubość

Kolumna kwot płatności: od współrzędnej (561, 54) 4 wiersze co 45 jednostek; szerokość=307. Kwoty drukujemy czcionką Courier New CE; rozmiar=9; Bold

Obiekt 7. [Tabelka VAT]

BOX (Default, Silver, 50, 10, No, 930, 940, 0) HLINE (Black, 10, 930,940,50) HLINE (Black, 10, 930,940,105) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘Razem:’, No, 132, 940, 53) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘ W tym:’, No, 132, 940, 114) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘Stawka’, No, 130, 1063, 0) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘Brutto’, No, 108, 1286, 0) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘VAT’, No, 82, 1522, 0) STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Center, ‘Netto’, No, 90, 1760, 0)

Przy dokumencie liczonym „od brutto” kolejność kolumn tabelki VAT ulega zmianie.

Sumy tabelki VAT (nazwy formuł przyjęte dla czytelności opisu) FIELD(Default, BRUTTOTOT, Courier New CE, 9, Black, Bold, No, No, No, 0, Default, @n-14.2, No, No, 222, 1186, 53) FIELD(Default, VATTOT, Courier New CE, 9, Black, Bold, No, No, No, 0, Default, @n-14.2, No, No, 196, 1415, 53) FIELD(Default, NETTOTOT, Courier New CE, 9, Black, Bold, No, No, No, 0, Default, @n-14.2, No, No, 246, 1617, 53)

Kolumny tabelki VAT (Courier New CE, rozmiar = 9, normalna grubość) Stawka VAT – od współrzędnych (1081,114) 7 wierszy co 45 jedn. Szerokość=101 Brutto – od współrzędnych (1186,114) 7 wierszy co 45 jedn. Szerokość=222 VAT– od współrzędnych (1415,114) 7 wierszy co 45 jedn. Szerokość=196 Netto – od współrzędnych (1617,114) 7 wierszy co 45 jedn. Szerokość=246

Począwszy od wiersza 4 elementy tabelki VAT mają ustawioną właściwość „Skip if empty” na YES

Obiekt 7. [Stopka strony]

BOX (Default, Silver, 55, 0, No, 1873, 0, 3)

STRING(Silver, Times New Roman CE, 10, black, Normal, No, No, No, 0, Right, ‘Razem do zapłaty:’, No, 270, 1200, 5)

FIELD(Silver, BRUTTOTOT, Times New Roman CE, 10, black, Bold, , No, No, No, Right,@n-14.2, No, No, 340, 1475, 5) STRING(Silver, Times New Roman CE, 10, black, Bold, No, No, No, 0, Right, ‘zł’, No, 50, 1810, 5)

FIELD(Default, KWOTASLOWNIE, Times New Roman CE, 10, black, Normal, No, No, No, 0, Right, @s255, No, No, 1873, 0, 62)

Formuła ZAPLACONO_PRINT drukuje zapłacona już kwotę faktury i pozostała do zapłaty. Jeżeli nic nie zostało zapłacone to linia jest pusta. FIELD(Default, ZAPLACONO_PRINT, Times New Roman CE, 10, black, Bold, No, No, No, 0, Right, @s255, Yes, No, 1873, 0, 118) HLINE(Black, 10, 1873, 0, 177)

Miejsca na podpisy:

HLINE(Black, 10, 665, 5, 285)

HLINE(Black, 10, 285, 1080, 285)

HLINE(Black, 10, 390, 1470, 285)

STRING(Default, Times New Roman CE, 8, Black, Normal, No, No, No, 0, Default, ‘Wystawił:’, No, 0, 115, 290) STRING(Default, Times New Roman CE, 8, Black, Normal, No, No, No, 0, Default, ‘Data odbioru:’, No, 0, 1165, 290) TEXT(No, Default, Times New Roman CE, 8, Black, Normal, No, No, No, 77, Center, Yes, ‘Podpis osoby uprawnionej <chr(13),chr(10)> do otrzymania faktury’, No, 390, 1470, 290)

Operator wystawiający dokument: FIELD(Default, Ope:Ope_Nazwisko, Times New Roman CE, 8, Black, Bold, No, No, No, 0, Center, @s50, No, No, 450, 226, 290)