Pierwszym krokiem tworzenia nowego typu obiegu jest dodanie kontrolek służących do wprowadzania danych.
Kontrolki dostępne w aplikacji Comarch DMS możemy podzielić na trzy typy:
Kontrolki proste (Liczba całkowita, Liczba rzeczywista, Liczba stałoprzecinkowa, Data i godzina, Tekst, Lista, Wartość logiczna).
Kontrolki elektroniczne (Dokument elektroniczny, Kontrahent, Towar, Dokumenty związane, Dokument ERP XL, Dane tabelaryczne) – umożliwiają wiązanie dokumentów, kontrahenta lub towaru z programu Comarch ERP XL do aplikacji Comarch DMS. Kontrolka Dokumenty związane prezentuje wiązanie dokumentów pomiędzy aplikacją Comarch DMS, a systemem Comarch ERP XL. Kontrolka Dokument ERP XL prezentuje numer dokumentu w systemie Comarch ERP XL, który został wygenerowany z poziomu aplikacji Comarch DMS wraz z opisem analitycznym lub dowiązany z systemu Comarch EPR XL.
Kontrolki pozostałe (Załącznik, Właściciel, Własna akcja, Separator, Etykieta)
Aby dodać kontrolkę do listy należy kliknąć przycisk[Dodaj] w panelu „Kontrolki”. Pojawi się formatka, na której z rozwijalnej listy należy wybrać typ kontrolkioraz wprowadzić nazwę. W panelu „Podgląd karty obiegu” pojawi się podgląd kontrolki.
Na poniższym filmie przedstawiono dodawanie kontrolki typu data i godzina:
Dodawanie nowej kontrolki
Przykładowy podgląd kontrolki
Lista typów kontrolek jest predefiniowana i nie można jej modyfikować. Zawiera następujące elementy (po kliknięciu na daną pozycję nastąpi przeniesienie do artykułu poświęconego danemu typowi kontrolki):
Przykładowa lista właściwości kontrolek składa się z następujących elementów:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Inicjowanie – w zależności od typu kontrolki przyjmuje wartość: Brak, SQL OD, SQL ERP, C# Scriptlub Słownik.
Uwaga
Od wersji 2023.1.2 jeżeli operator w ramach pola „Inicjowanie” wybierze wartość SQL OD, SQL ERP lub C# Script, ale nie kliknie w link „Ustaw” i nie wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „Numer dokumentu” w polu „Inicjowanie” wybrano opcję „SQL ERP”, ale nie wprowadzono zapytania
Dokument – pole występujące na kontrolkach prostych. W tym polu można wybrać dokument z kontrolki „Dokument elektroniczny”. Kontrolka będzie prezentować wartość z dokumentu z bazy Comarch ERP XL.
Pole – kontrolka występująca na kontrolkach prostych. Nazwa kolumny z tabeli Comarch ERP XL, z której ma być pobrana wartość do odczytu. Kontrolka powiązana z kontrolką Dokument.
Kontrahent – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Braklub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
Płatnik – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
Wartość netto – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości dokumentu. Istnieje możliwość przypisania kontrolki typu liczba całkowita, liczba rzeczywista, liczba stałoprzecinkowa.
Waluta – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości dokumentu. Istnieje możliwość przypisania kontrolki typu tekst i lista.
Rachunek bankowy – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolkiz karty obiegu do mapowania numeru konta bankowego. Istnieje możliwość przypisania kontrolki typu tekst i lista.
Opis – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości. Istnieje możliwość przypisania kontrolki typu tekst i lista.
Załączniki – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu typu załącznik. Funkcjonalność pozwala na podłączenie załączników z aplikacji Comarch DMS pod wygenerowany dokument w systemie Comarch ERP XL. Funkcjonalność mapowania uzależniona jest od ustawień w pliku web.config.
Pokaż na liście – wybranie wartości „Tak”wyświetli kolumnę z nazwą kontrolki i wartościami kontrolek z poszczególnych dokumentów na liście dokumentów.
Czas – wybranie opcji „Tak” umożliwia wprowadzanie godzin, minut i sekund na kontrolce typu Data i godzina.
Wartości – właściwość kontrolki typu Lista. Umożliwia zdefiniowanie słownika pozycji danej kontrolki. Wprowadzenie wartości następuje po kliknięciu klawisza Enter.
Generowanie dokumentu bez OA – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; po zaznaczeniu tej opcji system pozwoli na wygenerowanie dokumentu bez wprowadzonego opisu analitycznego
Po odwiązaniu pozostaw w dokumentach związanych – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; jeśli ta opcja jest zaznaczona, wówczas w momencie odwiązywania dokumentu informacja o związaniu dokumentów nie jest usuwana
Typ – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; lista dostępnych typów dokumentów z programu Comarch ERP XL, które zostaną wczytane do aplikacji Comarch DMS: (A)FS, (A)FZ, DP, FSE, FAI, FS, FS VAT RR, UNM, NM, , FZ, KK, OS, OZ, PA, MMP, MMW, MP, PW, PM, PZ, RS, RW, TAX FREE, Umowy, KDZ, WKA, PKA, WM, WZ, WZE, ZS, ZZ, ZOS, ZOZ, WYS, PC, Promocje, FW, RLS, RLZ, ZSR.
Max długość – właściwość kontrolki typu Tekst. Określa maksymalną długość wprowadzanego tekstu– max 900 znaków.
Tekst wielolinijkowy – właściwość kontrolki typu Tekst. Określa liczbę wierszy wyświetlanego pola tekstowego. Dopuszczalna liczba to 100 linijek.
Tryb pracy – właściwość kontrolki typu Lista. Przyjmuje wartości: Lista i Wyszukiwanie.
Tryb pracy, zakładka ERP XL – pole dostępne na właściwościach kontrolki Dokument ERP XL. Przyjmuje wartości: dla nagłówka i dla elementu. Określa, w jakim trybie będzie opisywany analitycznie dokument. Określa także czy dokument generowany w tym typie obiegu będzie miał elementy czy nie.
Dokumenty – właściwość kontrolki typu Dokumenty w obiegu. Przyjmuje wartości: Wszystkie lub Aktywne.
Plik wykonywalny – właściwość kontrolki typu Własna akcja, w której należy podać nazwę pliku wykonywalnego.
Procedura – właściwość kontrolki typu Własna akcja, w której należy podać nazwę procedury znajdującej się w bazie Comarch DMS.
Procedura ERP – właściwość kontrolki typu Własna akcja, w której należy wprowadzić nazwę procedury z bazy Comarch ERP XL.
C# Script – właściwość kontrolki typu Własna akcja, po kliknięciu w link „Ustaw”zostanie otwarte okno Skrypt C#, w którym można wpisać zapytanie w C#
Kontrolki powiązane – kontrolka prezentująca listę kontrolekpowiązanych (w tym kontrolka typu „Lista”), na podstawie których wyliczana jest wartość kontrolki wynikowej. Kontrolka wynikowa to kontrolka, na której zostało zdefiniowane wyrażenie np. arytmetyczne z użyciem kontrolek powiązanych.
Wzór na wartość – formatka, na której zdefiniowane zostało wyrażenie, na podstawie którego zostanie wyliczona wartość kontrolki wynikowej przy użyciu kontrolek powiązanych. Lista rozwijalna prezentuje wartości: Wyrażenie, SQL OD lub SQL ERP.
Wersjonowanie pliku – właściwość kontrolki typu Załącznik. Umożliwia podpięcie kilku wersji tego samego pliku do kontrolki typu Załącznik na szczegółach dokumentu
Prezentuj na całej szerokości – właściwość każdego typu kontrolki. Umożliwia zaprezentowanie kontrolki na całej szerokości karty obiegu na szczegółach dokumentu.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą a kontrolką poprzednią.
Uwaga
Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Tytuł – właściwość kontrolki typu Komunikat. Wprowadzona wartość zostanie zaprezentowana jako tytuł na oknie wyświetlonego komunikatu.
Pogrubione pola API na karcie obiegu są polami wymagalnymi i muszą zostać uzupełnione w celu zapisania dokumentu.
Wybierz centrum – właściwość kontrolki typu Dokument ERP XL. Wybrana wartość określa centrum struktury praw, w którym zostanie utworzony dokument.
Nazwa Spółki – właściwość kontrolek elektronicznych dostępna tylko podczas pracy z funkcjonalnością Wielofirmowość. Prezentuje listę zdefiniowanych spółek na zakładce Połączenia z ERP (zob. Połączenia z ERP )
Liczba prezentowanych wierszy – właściwość kontrolki typu Dane tabelaryczne; określa liczbę wierszy tabeli prezentowaną na dokumencie
Kolumny – właściwość kontrolki typu Dane tabelaryczne; po kliknięciu w link „Dodaj” możliwe jest zdefiniowanie kolejnych kolumn tabeli
Manager dokumentów – parametr dostępny na zakładce „Archiwa” we właściwościach kontrolki typu Załącznik, jeśli praca z Managerem dokumentów jest aktywna, zaznaczenie parametru umożliwia załączanie plików umieszczonych w managerze dokumentów
Liczba miejsc po przecinku, do której będzie zaokrąglana wartość – pole wprowadzone w wersji 2024.0.0; znajduje się na definicji kontrolki typu Liczba stałoprzecinkowa i służy do określenia, do ilu miejsc po przecinku będzie zaokrąglana wprowadzona liczba (od 0 do 6).
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Istnieje możliwość zdefiniowania do 20 kolumn (od wersji 2024.1. 0 – wcześniej do 10 kolumn), każda z kolumn może posiadać następujący typ:
Data i godzina
Dokument elektroniczny
Dokumenty w obiegu
Kontrahent
Liczba całkowita
Liczba rzeczywista
Liczba stałoprzecinkowa
Lista
Tekst
Towar
Wartość logiczna
Przykład kontrolki typu Dane tabelaryczne
Konfiguracja kontrolki Dane tabelaryczne – właściwości:
Zakładka Ogólne
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna karta obiegu.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Liczba prezentowanych wierszy – liczba widocznych wierszy, po przekroczeniu zadanej ilości wierszy z prawej strony kontrolki pojawi się pasek przewijania.
Kolumny z linkiem Dodaj – możliwość definicji kolejnych kolumn kontrolki (maks. 10).
Strzałki i – kliknięcie w strzałkę w górę pozwala na przesunięcie danej kolumny przed poprzednią kolumnę, zaś kliknięcie w strzałkę w dół – na przesunięcie danej kolumny na miejsce po kolejnej kolumnie
Ikona– kliknięcie w ikonę kosza powoduje usunięcie danej kolumny z tabeli
Kontrolka typu Dane tabelaryczne, zakładka Ogólne
Typy kolumn:
Data i godzina
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Czas – wartości Tak/Nie, określenie czy kontrolki data mają posiadać tylko datę czy datę i godzinę.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu data i godzina
Dokument elektroniczny – umożliwia zdefiniowanie kolumny typu dokument elektroniczny z możliwością podpinania dokumentów z systemu ERP XL.
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Nazwa spółki – pole dostępne w wielofirmowym trybie pracy, umożliwia wybór spółki, dla której będą podpinane dokumenty.
Typ – określenie typu dokumentu z systemu ERP XL, który można podpiąć do kolumny. Wybór typu nie jest obowiązkowy. Jeżeli typ nie zostanie określony w kolumnie można podpinać każdy oprogramowany w aplikacji typ dokumentu.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Dokument elektroniczny
Kontrahent – umożliwia zdefiniowanie kolumny z możliwością dowiązywanie kontrahentów z systemu ERP XL
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa.
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Nazwa spółki – pole dostępne w wielofirmowym trybie pracy, umożliwia wybór spółki, z której będą podpinani kontrahenci.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Kontrahent
Liczba całkowita
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Liczba całkowita
Liczba rzeczywista
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Liczba rzeczywista
Liczba stałoprzecinkowa
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu;
Liczba miejsc po przecinku, do której będzie zaokrąglana wartość – pole wprowadzone w wersji 2024.0.0; znajduje się na definicji kontrolki typu Liczba stałoprzecinkowa i służy do określenia, do ilu miejsc po przecinku będzie zaokrąglana wprowadzona liczba (od 0 do 6).
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Liczba stałoprzecinkowa
Lista
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa.
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Listy – słownik nazw list zdefiniowanych na zakładce „Listy”
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Lista
Tekst
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa.
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Tekst
Towar – umożliwia zdefiniowanie kolumny z możliwością dowiązywanie towarów z systemu ERP XL
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa.
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Nazwa spółki – pole dostępne w wielofirmowym trybie pracy, umożliwia wybór spółki z której będą podpinane towary.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Towar
Wartość logiczna
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu wartość logiczna
Dokumenty w obiegu
Właściwości:
Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu, dla których wyświetlana jest taka sama nazwa.
Identyfikator kolumny – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Po zapisie nie zamykaj dokumentu w kontrolce – parametr odpowiedzialny za zachowanie dokumentu wygenerowanego lub dowiązanego w ramach kolumny. Gdy parametr „Po zapisie nie zamykaj dokumentu w kontrolce” został zaznaczony, dokument podniesiony do podglądu lub dodany w ramach kontrolki / kolumny typu dokumenty w obiegu po kliknięciu w ikonę ‚Zapisz’ pozostaje wyświetlony, dopóki operator nie wycofa się z jego edycji za pomocą ikony ‚Nawiguj wstecz’ lub ‚Zamknij’ . Gdy parametr „Po zapisie nie zamykaj dokumentu w kontrolce” jest odznaczony, dokument podniesiony do podglądu lub dodany w ramach kontrolki / kolumny typu dokumenty w obiegu po kliknięciu w ikonę ‚Zapisz’ jest zamykany.
Dokument – przyjmuje wartości ‘Aktywne’ i ‘Wszystkie’, związany jest z możliwością podpięcia do tabeli tylko dokumentów przypisanych do pracownika (Aktywne) lub wszystkich dokumentów.
Typ obiegu – za pomocą przycisku ‚Dodaj’ należy określić typy obiegów dokumentów, w których można będzie tworzyć nowe i podpinać istniejące dokumenty z poziomu kontrolki Dane tabelaryczne. Jeżeli nie zostanie wskazany żaden typ obiegu, wówczas możliwe będzie podpięcie dowolnego istniejącego dokumentu. Dodanie nowego dokumentu wymaga wskazania typu obiegu, w którym dokument zostanie utworzony.
Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu Dokumenty w obiegu
Zakładka Listy
Kontrolka typu Dane tabelaryczne, zakładka „Listy”
Dodaj – możliwość definicji słowników list na potrzeby kolumn typu „Lista”
Ikona– kliknięcie w ikonę kosza powoduje usunięcie danej listy z zakładki „Listy”
Właściwości słownika list:
Nazwa – nazwa słownika listy.
Inicjowanie – sposób inicjowania listy: Słownik, SQL OD, SQL ERP, C# Script, Stawki VAT, Jednostki miary.
Rodzaj identyfikatora – pole umożliwia operatorowi określenie rodzaju identyfikatorów kolejnych pozycji na liście. Przyjmuje wartości:
Int - gdy identyfikatory kolejnych pozycji na liście określone są liczbą. Dla metody inicjowania listy słownikiem, rodzaj identyfikatora to zawsze int.
Text - gdy identyfikatory kolejnych pozycji na liście określone są wartością tekstową (np. GUID).
W przypadku, gdy w kontrolce lista określono rodzaj identyfikatora jako int, w edytorze zapytań SQL w mechanizmach inicjowania i obserwowania wyświetlane będą parametry:
<identyfikator_kontrolki_typu_lista>_Id
<identyfikator_kontrolki_typu_lista>_Text
W przypadku, gdy w kontrolce lista określono rodzaj identyfikatora jako text, w edytorze zapytań SQL w mechanizmach inicjowania i obserwowania wyświetlane będą parametry:
<identyfikator_kontrolki_typu_lista>_IdText
<identyfikator_kontrolki_typu_lista>_Text
Tryb pracy – wartości: Lista, Wyszukiwanie.
W kolumnie typu lista umożliwiono wyszukiwanie wartości po dowolnym ciągu znaków. Możliwość takiego wyszukiwania uzależniona jest od wartości parametru ‘Szukaj po dowolnym ciągu znaków’. Parametr znajduje się we właściwościach definiowanej listy, po wskazaniu trybu pracy ‘Wyszukiwanie’.
Kontrolka typu Dane tabelaryczne, zakładka "Listy", parametr "Szukaj po dowolnym ciągu znaków"
Zakładka Inicjowanie wartości
Inicjowanie – wartość „SQL OD” czyli inicjowanie kontrolki zapytaniem SQL z bazy obiegu, wartość "SQL ERP" czyli inicjowanie kontrolki zapytaniem SQL z bazy Comarch ERP XL lub wartość "C# Script" czyli inicjowanie kontrolki za pomocą kodu w języku C#.
Uwaga
Od wersji 2023.1.2 jeżeli operator w ramach pola "Inicjowanie" wybierze wartość SQL OD, SQL ERP lub C# Script, ale nie kliknie w link "Ustaw" i nie wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola "Inicjowanie" na "Brak"albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu"Inicjowanie" tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki "Tabela 1" na zakladce " Inicjowanie wartości" w polu "Inicjowanie" wybrano opcję "SQL OD", ale nie wprowadzono zapytania
Kontrolki powiązane - możliwość określenia, która kontrolka ma być obserwowana przez kontrolkę Dane tabelaryczne i na podstawie kontrolki obserwowanej zdefiniowanie wzoru na wartość kontrolki Dane tabelaryczne.
Kontrolka typu Dane tabelaryczne, zakładka "Inicjowanie wartości"
Zakładka Ograniczenie edycji
Na zakładce dostępna jest tabela, w której można określić tryb pracy poszczególnych kolumn kontrolki tabelarycznej na każdym etapie procesu.
Tabela zbudowana jest w ten sposób, że pierwsze dwie kolumny zawierają parametry dotyczące blokady dodawania i usuwania wierszy, które dotychczas były prezentowane we właściwościach kolumny na zakładce Ogólne. Pozostałe kolumny to kolejne kolumny zdefiniowanej kontrolki typu Dane tabelaryczne. Wiersze tabeli stanowią wszystkie etapy procesu.
Zaznaczenie parametru w kolumnach zablokuj usuwanie/dodawanie wierszy skutkuje brakiem możliwości usunięcia/dodania wiersza, gdy dokument przebywa w danym etapie. Zaznaczenie parametru w pozostałych kolumnach oznacza, że na danym etapie kolumna przejdzie w tryb do odczytu.
Kontrolka typu Dane tabelaryczne, zakładka "Ograniczenie edycji"
Kontrolka typu Dane tabelaryczne, kolumna "Dokument" w trybie tylko do podglądu
Import danych z arkusza Excel do kontrolki typu Dane tabelaryczne
W wersji 2024.1.0 umożliwiono import danych z arkusza Excel do kontrolki typu Dane tabelaryczne, dodano również pytanie, czy dane zostaną dopisane do istniejących danych w kontrolce typu Dane tabelaryczne, czy też wartości mają zostać nadpisane.
Aby poprawnie importować dane z arkusza Excel do kontrolki typu Dane tabelaryczne należy:
W arkuszu kalkulacyjnym, z którego mają zostać zaimportowane dane, przygotować kolumny w taki sposób, aby znajdowały się w takiej samej kolejności jak kolumny w kontrolce typu Dane tabelaryczne
Przykładowa tabela w kontrolce typu Dane tabelaryczne
Przykładowa tabela w arkuszu kalkulacyjnym – kolumny odpowiadają kolumnom znajdującym się w kontrolce typu Dane tabelaryczne
W pierwszym wierszu arkusza kalkulacyjnego umieścić nazwy wszystkich kolumn z kontrolki typu Dane tabelaryczne
W arkuszu kalkulacyjnymrozpocząć tabelę, która ma zostać zaimportowana, od pola A1
Przykładowa tabela w arkuszu kalkulacyjnym – zaznaczono pole A1, od którego należy rozpocząć tabelę
W arkuszu kalkulacyjnymdodać tabelę z co najmniej 1 kolumną i co najwyżej 20 kolumnami
W kontrolce typu Dane tabelarycznedodać kolumny z jednego lub więcej z poniższych typów kolumn:
Data i godzina (z czasem lub bez) – typ danych w Excelu: dd.mm.rrrr (bez czasu), dd.mm.rrrr gg:mm:ss (z czasem)
Dokument elektroniczny – typ danych w Excelu: tekst, liczba
Dokumenty w obiegu – typ danych w Excelu: liczba, tekst
Kontrahent – typ danych w Excelu: tekst, liczba
Liczba całkowita – typ danych w Excelu: liczba
Liczba rzeczywista – typ danych w Excelu: liczba
Liczba stałoprzecinkowa – typ danych w Excelu: liczba
Lista – typ danych w Excelu: tekst, liczba
Tekst – typ danych w Excelu: tekst
Towar – typ danych w Excelu: tekst, liczba
Wartość logiczna (z włączonym lub wyłączonym wyborem wiersza) – typ danych w Excelu: liczba
Uwaga
W arkuszu kalkulacyjnym należy pominąć kolumnę z liczbą porządkową wiersza.
Jeśli dane z arkusza kalkulacyjnego są importowane do kolumny z typów dotyczących kontrolek elektronicznych – kontrolek we współpracy z systemami ERP– wówczas dla kolumny typu:
Dokument elektroniczny – zostanie przekazany numer dokumentu
Kontrahent – zostanie przekazany akronim kontrahenta
Towar – zostanie przekazany kod towaru
Podczas importu takich danych następuje walidacja, czy dany numer/akronim/kod występuje w powiązanej bazie ERP – jeśli tak, element zostanie podpięty w kolumnie, jeśli nie – kolumna pozostanie pusta.
W wersji 2024.1.0 obok kontrolki typu Dane tabelaryczne w aplikacji desktop dodano ikonę [Import danych z arkusza kalkulacyjnego]. Ikona znajduje się obok przycisku dodawania nowego wiersza w ramach kontrolki lub, w przypadku jeśli w zakładce „Schemat obiegu” zaznaczono parametr „Odświeżanie tabeli na żądanie” dla danej kontrolki typu Dane tabelaryczne, obok ikony odświeżania kontrolki .
Szczegóły dokumentu z widoczną ikoną „Import danych z arkusza kalkulacyjnego” w aplikacji desktop – jeśli nie włączono odświeżania kontrolki typu Dane tabelaryczne
Szczegóły dokumentu z widoczną ikoną „Import danych z arkusza kalkulacyjnego” w aplikacji desktop – jeśli włączono odświeżanie kontrolki typu Dane tabelaryczne
Aby importować dane z arkusza kalkulacyjnego, operator powinien kliknąć w ikonę [Import danych z arkusza kalkulacyjnego].
Wówczas zostaje otwarte okno, w ramach którego operator powinien wybrać jeden arkusz kalkulacyjny do zaimportowania i kliknąć[Otwórz].
Wybór arkusza kalkulacyjnego do zaimportowania
Po kliknięciu w przycisk [Otwórz] dane z arkusza kalkulacyjnego zostają zaimportowane do kontrolki typu Dane tabelaryczne.
Przykładowa kontrolka typu Dane tabelaryczne z danymi zaimportowanymi z arkusza kalkulacyjnego
Jeżeli operator wybrał arkusz kalkulacyjny do zaimportowania i kliknął w przycisk [Otwórz], ale wcześniej wprowadzono już jakieś dane w danej kontrolce, wówczas zostanie wyświetlony następujący komunikat:
Komunikat wyświetlany, jeśli w ramach kontrolki wprowadzono jakieś dane przed próbą importu danych z arkusza kalkulacyjnego
Jeśli operator wybierze przycisk:
[Dopisz dane] – wówczas dane z wybranego arkusza kalkulacyjnego zostaną dodane do danych, które już znajdują się w danej kontrolce typu Dane tabelaryczne, a komunikat zostanie zamknięty
[Nadpisz dane] – wówczas dane z wybranego arkusza kalkulacyjnego zastąpią te dane, które już znajdowały się w danej kontrolce typu Dane tabelaryczne, a komunikat zostanie zamknięty
[Anuluj] – wówczas operator rezygnuje z importu danych, a komunikat zostanie zamknięty
Dodawanie istniejącego dokumentu oraz tworzenie nowego w kolumnie typu "Dokumenty w obiegu"
Wskazanie typu kolumny ‘Dokumentu w obiegu’ pozwala na dodawanie istniejącego lub utworzenie nowego dokumentu Comarch DMS.
Konfiguracja kontrolki Dane tabelaryczne, kolumna typu Dokumenty w obiegu
Aby w kontrolce Dane tabelaryczne utworzyć nowy dokument należy użyć przycisku
który wywoła listę dostępnych typów obiegu, w ramach których możliwe jest utworzenie nowego dokumentu.
Kontrolka Dane tabelaryczne – wybór typu obiegu, w którym zostanie utworzony nowy dokument
Po wybraniu typu obiegu wyświetlona zostaje karta obiegu.
Karta obiegu wywołana z kontrolki typu Dane tabelaryczne na karcie obiegu w ramach innego typu obiegu.
Aby w kolumnie typu „Dokumenty w obiegu” dodać istniejący dokument, należy wpisać kilka znaków numeru dokumentu, który ma być podpięty w kontrolce. Po wpisaniu frazy, Comarch DMS wyświetli listę dokumentów, które zawierają wpisany ciąg znaków.
Kontrolka typu Dane tabelaryczne – wskazanie dokumentu Comarch DMS
Istnieje możliwość inicjowania kontrolki tabelarycznej zapytaniem SQL. Możliwe jest uruchomienie zapytania wyłącznie na bazie obiegu. Poniżej zostały opisane zasady tworzenia zapytania SQL w zależności od zdefiniowanej ilości i typów kolumn kontrolki.
Tworząc zapytanie, które zainicjuje kontrolkę należy kierować się przykładem zamieszczonym na formatce definicji zapytania „Zapytanie SQL”. Składania zapytania oraz przykład jest tworzony dynamicznie w zależności od ilości i typu zdefiniowanych kolumn.
Formatka Zapytanie SQL
Format zapytania SQL
Inicjowanie kontrolki tabelarycznej zapytaniem SQL odbywa się poprzez zapytanie SELECT, w którym podajemy tyle parametrów i w takiej kolejności w jakiej występują kolumny zdefiniowane w kontrolce.
Kolumny ze składni select przekładają się 1:1 do kolumn zdefiniowanych w kontrolce tabelarycznej poza jednym wyjątkiem. Tym wyjątkiem jest kolumna typu dokument elektroniczny, w którym konieczne jest określenie dwóch składowych GidTyp i Id GidNumer.
Ostatnią kolumną jest zawsze tryb wprowadzania wartości instrukcją select:
1 – nadpisz (usuń istniejące wartości i zastąp nowymi),
2 – dodaj (do istniejących wartości dodaj nowe)
Zestawienie typów kolumn instrukcji SELECT:
Typ kolumny kontrolki
Typ kolumny SELECT
Przykład
Tekst
varchar (900)
'Uwagi do płatności'
Data i godzina
datetime
'20170926' - format 'YYYYMMDD'
Liczba całkowita
int
123
Liczba stałoprzecinkowa
decimal (22,4)
1000.55
Liczba rzeczywsta
real
2000.55
Lista
int
1 - id pozycji
Kontrahent
int
751 - KntNumer
Towar
int
438 - TwrNumer
Wartość logiczna
int
0 - Nie
1 - Tak
Dokument elektroniczny
int
1521 - GidTyp dokumentu
112 - Id dokumentu
Przyklad
Za pomocą zapytania SQL chcemy do istniejących wierszy w kontrolce tabelarycznej dodać dwa kolejne.
Jeżeli w kontrolce dane tabelaryczne zostały zdefiniowane 4 kolumny typu:
1) dokument elektroniczny,
2) liczba stałoprzecinkowa,
3) lista
oraz
4) data i godzina, zapytanie select może wyglądać następująco:
Kolumny dla powyższego przykładu zostały zdefiniowane w następujący sposób:
Kolumny zdefiniowane w kontrolce tabelarycznej
Zmiana wartości kontrolki na podstawie zmiany wartości innej kontrolki (Obserwator)
Od wersji Comarch DMS 2018.2.1 została zmieniona funkcjonalność odświeżania zawartości kontrolki dane tabelaryczne instrukcją SQL: select * from @Nazwa kontrolki@.
We wcześniejszych wersjach Comarch DMS wywołanie zapytania select * from @Nazwa kontrolki@ było obowiązkowe dla każdego zdarzenia. Brak instrukcji powodował usunięcie informacji z kontrolki dane tabelaryczne. Aktualnie brak tego zapytania nie spowoduje usunięcia zawartości kontrolki. Zmiana została wprowadzona po to, aby nieobsłużone zdarzenia nie powodowały wielokrotnego odświeżania kontrolki.
Do wersji 2018.2.1 zalecanym schematem pisania zapytań SQL w obsłudze zdarzeń kontrolki dane tabelaryczne był schemat, w którym zapytanie select * from @Nazwa kontrolki@ znajdowało się na końcu kodu SQL:
Przyklad
Przykład warunku:
If warunek 1
Begin
… Obsługa warunku 1
End
If warunek 2
Begin
… Obsługa warunku 2
End
select * from @Nazwa kontrolki@
Aktualnie zalecanym schematem jest:
Przyklad
Przykład warunku:
If warunek 1
Begin
… Obsługa warunku 1
select * from @Nazwa kontrolki@
End
If warunek 2
Begin
… Obsługa warunku 2
select * from @Nazwa kontrolki@
End
W przypadku wykorzystania nowego schematu warunku, brak obsługi zdarzenia nie spowoduje żadnej akcji w kontrolce dane tabelaryczne.
Uwaga
Nową zasadę można stosować gdy korzystamy z serwera MS SQL 2012 lub wyższego. W przypadku serwera MS SQL 2008 należy stosować dotychczasowe zasady!
Odświeżanie wartości w kontrolce dane tabelaryczne na żądanie
Funkcjonalność można włączyć w:
menu "Definicje typów obiegów" → zakładka "Schemat obiegu" → wybrany etap → zakładka "Kontrolki" → parametr "Odświeżanie tabeli na żądanie"
Parametr "Odświeżanie tabeli na żądanie"
Po włączeniu opcji na karcie obiegu pojawi się przycisk, który po kliknięciu będzie odświeżał wartości w tabeli.
Przycisk pozwalający na odświeżanie tabeli
W edytorze wyrażeń SQL dostępna jest obsługa zdarzenia kliknięcia w przycisk "Odśwież" w kontrolce typu dane tabelaryczne. Zdarzenia można wskazać w parametrach @^SenderControlName@ oraz @^InitSenderControlName@ poprzez wpisanie frazy złożonej z identyfikatora kontrolki tabelarycznej, następnie znaku "_" i dodatkowo słowa "Refresh". Np. dla kontrolki o identyfikatorze "Multiline1" zdarzenie kliknięcia będzie określane jako "Multiline1_Refresh".
Przyklad
Zdefiniowano kontrolkę typu dane tabelaryczne "Elementy", w której po dodaniu towaru i uzupełnieniu ilości jednostki miary i ceny wyliczana jest wartość netto wszystkich pozycji tabeli. Zdefiniowano również kontrolkę typu liczba stałoprzecinkowa "Łączna wartość netto dokumentu", w której wyliczana jest suma wartości netto z tabeli.
W kontrolce typu dane tabelaryczne zastosowano mechanizm obserwowania zmiany wartości przez samą siebie, przy czym w parametrze @^SenderControlName@ wskazano zdarzenie kliknięcia w przycisk "Odśwież" w kontrolce typu dane tabelaryczne.
W kontrolce liczbowej "Łączna wartość netto dokumentu" zastosowano mechanizm obserwowania wartości w kontrolce tabelarycznej. W zapytaniu obserwatora w parametrze @^SenderControlName@ wskazano zdarzenie kliknięcia w przycisk "Odśwież" w kontrolce "Elementy". We właściwościach etapu zaznaczono, że kontrolka typu dane tabelaryczne będzie pracować w trybie odświeżanie na żądanie.
Na dokumencie DMS po uzupełnieniu kolumn "Towar", "Ilość", "JM" i "Cena" wartości w kolumnie "Wartość netto" i w kontrolce "Łączna wartość netto dokumentu" nie są wyliczane pomimo ustawienia mechanizmu obserwacji.
Dopiero po kliknięciu w ikonę "Odśwież" wartości zostaną wyliczone i zaprezentowane w kolumnie "Wartość netto" oraz w kontrolce "Łączna wartość netto dokumentu".
Data i godzina
Kontrolka przechowuje informacje o dacie lub dacie i godzinie. Na definicji kontrolki dostępne są następujące pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalnaw ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią.
Uwaga
Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Czas – parametr odpowiadający za to czy w kontrolce będzie prezentowana godzina, ustawienie wartości parametru na „Tak”, skutkuje wyświetlaniem daty i godziny, ustawienie wartości parametru na „Nie”, skutkuje wyświetlaniem tylko daty.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
Sekcja Inicjowanie wartości
Inicjowanie – pole może przyjąć wartość: Brak, SQL OD, SQL ERP (od wersji 2023.1.0) lub C# Script.
Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
W przypadku wartości „SQL OD” lub „SQL ERP”pojawia się możliwość zdefiniowania zapytania SQL, za pomocą którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”.
Parametr „Inicjuj przy każdym otwarciu dokumentu”
Dla wartości „C# Script”możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.
Inicjowanie wartości za pomocą kodu w języku C#
Uwaga
Od wersji 2023.1.2 jeżeli operator w ramach pola „Inicjowanie” wybierze wartość SQL OD, SQL ERP lub C# Script, ale nie kliknie w link „Ustaw” i nie wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „Data 1” w polu „Inicjowanie” wybrano opcję „SQL ERP” oraz na definicji kontrolki „Data 2” w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytań
Inicjuj przy każdym otwarciu – parametr widoczny , jeśli w polu „Inicjowanie” wybrano „SQLOD”, „SQL ERP” lub „C# Script”; zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.
Dokument – pole widoczne, jeśli w polu „Inicjowanie”wybrano „Brak”; w tym polu można wybrać nazwę (identyfikator) wcześniej zdefiniowanej w danym obiegu kontrolki typu Dokument elektroniczny, z której wartość ma zostać zmapowana do kontrolki typu data i godzina (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.
Pole – pole widoczne, jeśli w polu „Inicjowanie” wybrano „Brak”; w tym polu można wybrać kolumnę z bazy danych Comarch ERP XL, której wartość zostanie zmapowana do kontrolki typu data i godzina (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.
Kontrolka typu „Data i godzina” może być wykorzystywana, jako kontrolka, w której użytkownik wprowadza na karcie obiegu na szczegółach dokumentu np. datę wpływu dokumentu.
Jeżeli w konfiguracji tej kontrolki wprowadzone jest zapytanie SQL-owe, można na jego podstawie z bazy pobrać konkretną wartość, którą aplikacja automatycznie wprowadzi do pola kontrolki.
Kontrolka Data i godzina i jej właściwości
Wskazówka
Przykład zapytania SQL dla kontrolki typu “Data i godzina”:
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu „Dokument elektroniczny” służy do prezentowania podglądu szczegółów dokumentów z programu Comarch ERP XL. Po zaczytaniu dokumentu system prezentuje numer systemowy dokumentu.
Na definicji kontrolki dostępne są następujące pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Nazwa spółki – wyświetlana, gdy DMS pracuje w trybie wielospółkowym.
Typ – parametr służący określeniu typu dokumentu Comarch ERP XL, który będzie możliwy do podpięcia w kontrolce.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
Kontrolka może być wykorzystywana do wiązania dokumentów z systemu Comarch ERP XL.
Wiązanie jest możliwe jedynie w aplikacji stacjonarnej. Odbywa się poprzez otwarcie formatki z listą dokumentów zdefiniowanego typu i wskazanie dokumentu. Funkcjonalność działa w oparciu o uprawnienia operatora Comarch ERP XL, w kontekście którego wykonywane jest wiązanie.
Wskazówka
Została wprowadzona funkcjonalność umożliwiająca dowiązanie dokumentu Faktura zakupu A-vista w widoku formatki zwykłej lub uproszczonej. Na liście typów dokumentów w kontrolce „Dokument elektroniczny” prezentowane są wartości: „Faktura zakupu a-vista” i „Faktura zakupu a-vista uproszczona”. Uproszczona formatka pojawi się, gdy aplikacja Comarch DMS współpracuje z systemem Comarch ERP XL w wersji 2016.3.3 lub wyższej.
Kontrolka Dokument elektroniczny i jej właściwości
Prezentowanie wartości pobranych z kontrolki elektronicznej w kontrolkach prostych
Aplikacja Comarch DMS umożliwia powiązanie kontrolek prostych z kontrolkami elektronicznymi. Dzięki tej funkcjonalności możliwe jest zaprezentowanie wartości pobranej z kontrolki elektronicznej (ze wskazanego pola bazy danych) w kontrolce prostej.
W kontrolce elektronicznej należy określić typ dokumentu („Typ”).
W kontrolce prostej należy pozostawić w polu „Inicjowanie” wartość „Brak”, a następnie wypełnić pole „Dokument” poprzez wybór nazwy (identyfikatora) wcześniej zdefiniowanej kontrolki elektronicznej oraz wskazać na liście („Pole”) kolumnę z bazy danych.
Wskazówka
Kolumny wyświetlane w ramach kontrolki „Pole” pochodzą z tabeli:
cdn.ImpNag (jeśli dokument elektroniczny należy do typu „Faktura importowa”),
cdn.MemNag (jeśli dokument elektroniczny należy do typu „Nota memoriałowa”, „Uproszczona nota memoriałowa”)
cdn.ZamNag (jeśli dokument elektroniczny należy do typu „Oferta na zakup”, „Oferta sprzedaży”, „Zamówienie”, „Zapytanie ofertowe na sprzedaż”, „Zapytanie ofertowe na zakup”),
cdn.WysPaczki (jeśli dokument elektroniczny należy do typu „Paczka”);
cdn.PrmKarty (jeśli dokument elektroniczny należy do typu „Promocja”)
cdn.MagNag (jeśli dokument elektroniczny należy do typu „Przesunięcie wewnątrzmagazynowe”, „Przyjęcie magazynowe”, „Wydanie magazynowe”)
cdn.ReklNag (jeśli dokument elektroniczny należy do typu „Reklamacja sprzedaży” lub „Reklamacja zakupu”)
cdn.UmwNag (jeśli dokument elektroniczny należy do typu „Umowy”)
cdn.CRMWizytyNag (jeśli dokument elektroniczny należy do typu „Wizyta handlowa”)
cdn.Wysylki (jeśli dokument elektroniczny należy do typu „Wysyłka”)
cdn.SrwZlcNag (jeśli dokument elektroniczny należy do typu „Zlecenie serwisowe”)
Na karcie dokumentu po dodaniu dokumentu z Comarch ERP XL w ramach wybranej kontrolki typu dokument elektroniczny określone w ten sposób wartości zostaną zaprezentowane w kontrolkach prostych.
Kontrolka typu „Dokument elektroniczny” z nazwą-identyfikatorem „fz”
Wybór kontrolki typu Dokument elektroniczny o nazwie (identyfikatorze) „fz” w polu „Dokument” i kolumny z bazy danych w polu „Pole”
Lista kolumn wyświetlana w polu „Pole” w kontrolce prostej po wyborze w polu „Dokument” kontrolki typu dokument elektroniczny
Kontrolki proste z wartościami pochodzącymi z dokumentu dodanego w kontrolce typu dokument elektroniczny („Faktura zakupu”)
Możliwość podpięcia korekt dokumentów PZ i PZI
W polach karty obiegu typu Dokument elektroniczny, gdy określono typ dokumentu PZ lub PZI została wprowadzona możliwość podpięcia korekt tych dokumentów. W przypadku, gdy na karcie obiegu należy podpiąć dokument PZ / PZI z bazy Comarch ERP XL, ale dokument posiada korektę, możliwe jest podpięcie dokumentu PZK / PKI.
Wybór korekty przyjęcia zewnętrznego
Korekta przyjęcia zewnętrznego dodana do kontrolki typu dokument elektroniczny
Inicjowanie wartości
Pole Inicjowanie może przyjąć wartość: Brak, SQL OD, SQL ERP (od wersji 2023.1.0) lub C# Script.
Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
W przypadku wartości „SQL OD” lub „SQL ERP” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”.
Parametr „Inicjuj przy każdym otwarciu dokumentu”
Dla wartości „C# Script” możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.
Inicjowanie kontrolki za pomocą kodu w języku C#
Zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.
Uwaga
Od wersji 2023.1.2 jeżeli operator w ramach pola „Inicjowanie” wybierze wartość SQL OD, SQL ERP lub C# Script, ale nie kliknie w link „Ustaw” i nie wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „Dokument 1” w polu „Inicjowanie” wybrano opcję „SQL ERP” oraz na definicji kontrolki „Dokument 2” w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytań
Odpinanie anulowanego dokumentu ERP XL z kontrolek elektronicznych
Istnieje funkcjonalność odpinania dokumentów, które zostały anulowane w systemie Comarch ERP XL i znajdowały się na dokumentach w Comarch DMS w kontrolkach: Dokument elektroniczny, Dokument ERP XL i Dane tabelaryczne w kolumnie ‘Dokument elektroniczny’. W sytuacji, gdy spięty dokument osiągnął stan ‘Anulowany’, na dokumencie w Comarch DMS zostaje usunięte powiązanie i numer dokumentu z Comarch ERP XL nie jest prezentowany.
Kontrolka typu „Dokument ERP XL” służy do dekretacji kosztów poprzez funkcjonalność opisu analitycznego. Funkcjonalność pozwala wygenerować dokument Comarch ERP XL na podstawie danych (kontrahent, elementy dokumentu, dekretacja kosztów na opisie analitycznym) wprowadzonych w kontrolce „Dokument ERP XL”.
Uwaga
Na karcie obiegu może znajdować się tylko jedna kontrolka typu „Dokument ERP XL”.
Zakładka Ogólne
Na właściwościach tej kontrolki można zainicjować pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.,
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu,
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”,
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”,
Nazwa spółki – wyświetlana, gdy Comarch DMS pracuje w trybie wielospółkowym,
Wybierz centrum – wybrana wartość określa centrum struktury praw, w którym zostanie utworzony dokument,
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki
Zakładka Dokument ERP XL
Zakładka Dokument ERP XLzawiera kontrolki:
Typ – kontrolka umożliwia wybranie typu dokumentu, dla którego będzie tworzony opis analityczny.
Tryb pracy – kontrolka prezentuje tryb pracy opisu analitycznego: „Dla elementu” i „Dla nagłówka”
Sposób dodawania pozycji – pole dostępne od wersji 2024.1.0, tylko jeśli w polu „Typ” wybrano opcję „(A)Faktura zakupu” lub „(A) Korekta faktury zakupu”. W ramach tego pola dostępne są dwie opcje:
Tabela elementów – jeśli wybrano tę opcję, wówczas dany rodzaj dokumentu będzie pracować jedynie na podstawie tabeli elementów, a tabela VAT nie będzie dostępna;
Generowanie dokumentu bez OA – po zaznaczeniu tej opcji system pozwoli na wygenerowanie dokumentu bez wprowadzonego opisu analitycznego
Po odwiązaniu pozostaw w dokumentach związanych – jeśli ta opcja jest zaznaczona, wówczas w momencie odwiązywania dokumentu informacja o związaniu dokumentów nie jest usuwana
W ramach sekcji „Pola API” dostępne są pola w strukturze API, które po przypisaniu kontrolek i wypełnieniu wartościami na dokumencie umożliwią wygenerowanie dokumentu w systemie Comarch ERP XL.
ZakładkaWartości mapowane
W zależności od ustawienia kontrolki „Tryb pracy”(na zakładce „Dokument ERP XL”) na zakładce „Wartości mapowane” dostępne są jedna (tryb „Dla nagłówka”) lub dwie (tryb „Dla elementu”) sekcje (dwie sekcje są także dostępne dla typu dokumentu (A)Faktura zakupu lub (A)Korekta faktury zakupu) :
Sekcja „Nagłówek”
W tej sekcji znajdują się kontrolki:
Kontrahent
Płatnik
Wartość netto
Waluta
Rachunek bankowy
Opis
oraz pole „Załączniki” z linkiem „Dodaj”, który umożliwia wybór kontrolki typu załącznik, dostępnej w danym typie obiegu, z której zostanie dodany załącznik.
Kontrolki można zmapować z kontrolkami na karcie obiegu (dostępne dla wybranych dokumentów).
Kontrolki „Kontrahent” i „Płatnik” przyjmują wartości:
wartość Brak
wartość <nazwa kontrolki typu „Kontrahent” lub „Płatnik”>
Funkcjonalność umożliwia przeniesienie wartości kontrolkiwypełnianej na karcie obiegu do pola Kontrahent na kontrolce „Dokument ERP XL”. Gdy zostanie wybrana wartość Brak, wtedy mapowanie nie zostanie wykonane.
Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Razem netto na kontrolce „Dokument ERP XL”.
Przeniesiona wartość traktowana jest przez aplikację jako wartość netto całego dokumentu = łączna wartość opisu analitycznego.
Do mapowania wartości zaleca się używanie kontrolek typu „Liczba stałoprzecinkowa”. Dla dokumentów typu A-vista wartość mapowana z Karty obiegu przenosi się do kolumny Cena lub Wartość netto.
Kontrolka „Waluta” przyjmuje wartości:
Brak
<nazwa kontrolki/ek typu „Tekst” lub „Lista”>
Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Waluta na kontrolce „Dokument ERP XL”. Gdy zostanie wybrana wartość Brak, wtedy mapowanie nie zostanie wykonane.
Kontrolka „Rachunek bankowy” (dostępna od wersji 2022.0 dla faktury zakupu w trybie nagłówkowym i elementowym, (A) faktury zakupu uproszczonej i (A) faktury zakupu) przyjmuje wartości:
Brak
<nazwa kontrolkitypu „Tekst” lub „Lista”>
Kiedy w ramach konfiguracji kontrolki ERP XL zostanie wskazana kontrolka, z której pochodzić będzie informacja o numerze rachunku bankowego do formatki ERP XL, wówczas nastąpi automatyczne wpisanie numeru rachunku do kontrolki „Rachunek bankowy” na formatce Dokument ERP XL.
Kontrolka „Opis” przyjmuje wartości:
Brak
<nazwa kontrolki typu „Tekst”>
Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Nazwa na kontrolce Dokument ERP XL. Gdy zostanie wybrana wartość ‘Brak’, wtedy mapowanie nie zostaniewykonane.
Kontrolka „Załącznik” przyjmuje wartość:
Brak
<nazwa kontrolki/ek z karty obiegu typu „Załącznik”>
Funkcjonalność pozwala na dołączenie załączników podpiętych do dokumentu w Comarch DMS do wygenerowanego na podstawie kontrolki „Dokument ERP XL” dokumentu w systemie Comarch ERP XL.
Przyklad
W Comarch DMS zdefiniowano obieg dokumentów:
Na karcie obiegu umieszczono trzy kontrolki typu załącznik: Specyfikacja, Skan dokumentu oraz Instrukcja obsługi.
We właściwościach kontrolki typu Dokument ERP XL wskazano wszystkie trzy kontrolki:
Zarejestrowano dokument w Comarch DMS, w kontrolkach typu załącznik podpięto kilka dokumentów:
W kontrolce typu Dokument ERP XL wygenerowano dokument FZ w systemie Comarch ERP XL, na dokumencie FZ na zakładce Załączniki w Comarch ERP XL prezentowane są wszystkie pliki podpięte w kontrolkach, które wskazano we właściwościach kontrolki typu Dokument ERP XL na zakładce Wartości mapowane.
Uwaga
Należy pamiętać, aby:
na kontrolkach typu Załącznik, które wybrano do mapowania w kontrolce typu Dokument ERP XL, na zakładce Archiwa ustawiono odpowiednią spółkę
oraz
na kontrolce typu Dokument ERP XL na zakładce Ogólne ustawiono spółkę analogicznie jak na wybranych kontrolkach typu Załącznik
w przeciwnym wypadku mapowanie załączników nie będzie możliwe.
W systemie Comarch ERP XL załączniki prezentowane są na zakładce Załączniki.
Uwaga
Aplikacja umożliwia wystawianie dokumentów korekt ręcznych tylko wartościowych zarówno z wartościami ujemnymi jak i dodatnimi.
Sekcja Elementy (dostępna w trybie pracy „Dla elementu”– chyba, że wybrano typ „Spinacz nagłówkowy faktury zakupu” lub „Nota memoriałowa” – oraz dla typów: (A)Faktura zakupu i (A)Korekta faktury zakupu, jeśli na zakładce „Dokument ERP XL” w polu „Sposób dodawania pozycji” wybrano opcję „Tabela elementów”)
W tej sekcji znajdują się kontrolki:
Lista elementów – w ramach tej kontrolki można wybrać kontrolkę typu Dane tabelaryczne, z której wartości będą przenoszone na zakładkę „Dokument” na kontrolce typu Dokument ERP XL
Nazwa – pole widoczne, jeśli w polu „Typ” na zakładce „Dokument ERP XL” wybrano opcję „(A)Faktura zakupu” lub „(A)Korekta faktury zakupu” – w ramach tej kontrolki można wybrać kolumnę typu Tekst z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Towar” na zakładce „Dokument” na kontrolce typu Dokument ERP XL;
Towar – w ramach tej kontrolki można wybrać kolumnę typu Towar z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Towar” i „Nazwa towaru” na zakładce „Dokument” na kontrolce typu Dokument ERP XL (pole niewidoczne dla typów: (A)Faktura zakupu i (A)Korekta faktury zakupu)
Ilość – w ramach tej kontrolki można wybrać kolumnę typu liczba stałoprzecinkowa z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Ilość” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
Jednostka miary – w ramach tej kontrolki można wybrać kolumnę typu lista z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Jm.” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
Cena – w ramach tej kontrolki można wybrać kolumnę typu liczba stałoprzecinkowa z tabeli wybranej w kontrolce „Lista elementów”– z tej kolumny zostanie przeniesiona wartość na pole „CenaN” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
Stawka VAT– w ramach tej kontrolki można wybrać kolumnę typu lista z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Stawka VAT” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
Sekcja Tabela VAT (od wersji 2024.1.0; dostępna tylko dla typów: (A)Faktura zakupu i (A)Korekta faktury zakupu, jeśli na zakładce „Dokument ERP XL” w polu „Sposób dodawania pozycji” wybrano opcję „Tabela VAT”)
W tej sekcji znajdują się kontrolki:
Kontrolka tabelaryczna – w ramach tego pola znajduje się lista kontrolek typu Dane tabelaryczne na karcie obiegu. Jeżeli nie wybrano wartości, wówczas w tym polu wyświetlana jest wartość „Brak”.
Stawka VAT – w ramach tego pola możliwe jest zmapowanie kolumny typu Stawka VAT z kontrolki typu Dane tabelaryczne, którą wybrano w polu „Kontrolka tabelaryczna”; w ramach listy kolumn operator może wybrać spośród wszystkich kolumn typu stawka VAT. Jeżeli nie wybrano wartości, wówczas w tym polu wyświetlana jest wartość „Brak”.
Wartość netto – w ramach tego pola możliwe jest zmapowanie kolumny typu Liczba stałoprzecinkowa z kontrolki, którą wybrano w polu „Kontrolka tabelaryczna”; w ramach listy kolumn operator może wybierać spośród wszystkich kolumn typu Liczba stałoprzecinkowa. Jeżeli nie wybrano wartości, wówczas w tym polu wyświetlana jest wartość „Brak”.
Wartość VAT – w ramach tego pola można zmapować kolumnę typu Liczba stałoprzecinkowa z kontrolki, którą wybrano w polu „Kontrolka tabelaryczna”; w ramach listy kolumn operator może wybierać spośród wszystkich kolumn typu Liczba stałoprzecinkowa. Jeżeli nie wybrano wartości, wówczas w tym polu wyświetlana jest wartość „Brak”.
Wartość brutto – w ramach tego pola można zmapować kolumnę typu Liczba stałoprzecinkowa z kontrolki, którą wybrano w polu „Kontrolka tabelaryczna”; w ramach listy kolumn operator może wybierać spośród wszystkich kolumn typu Liczba stałoprzecinkowa. Jeżeli nie wybrano wartości, wówczas w tym polu wyświetlana jest wartość „Brak”.
Uwaga
Jeśli operator wybrał daną kolumnę typu Liczba stałoprzecinkowa w polu „Wartość netto”, Wartość VAT” lub „Wartość brutto”, wówczas ta sama kolumna nie może zostać wybrana w pozostałych dwóch polach.
Operator powinien uzupełnić dwa z trzech pól („Wartość netto”, Wartość VAT”, „Wartość brutto”), zaś wartość w trzecim polu zostanie wyliczona na podstawie tych dwóch pól – dlatego nad tymi polami widoczna jest informacja „Wybierz dwie z poniższych wartości, trzecia zostanie automatycznie wyliczona w tabeli VAT”.
Jeśli operator uzupełni wszystkie trzy pola: Wartość netto”, Wartość VAT”, „Wartość brutto”, wówczas informacja „Wybierz dwie z poniższych wartości, trzecia zostanie automatycznie wyliczona w tabeli VAT” zostaje wyświetlona na czerwono, ponieważ wskazano już dwie wartości mapowane.
Szczegółowe informacje przedstawiono poniżej w podrozdziale Uzupełnianie wartości formatki Dokument ERP XL wartościami z kontrolki tabelarycznej.
Uzupełnianie wartości formatki Dokument ERP XL wartościami z kontrolki tabelarycznej
Istnieje możliwość przenoszenia wartości wprowadzonych do kontrolek tabelarycznych na formatkę „Dokumenty ERP XL”.
Aktualnie wszystkie mechanizmy mapujące mogą działać „online” (przenoszą dane do otwartej formatki „Dokumenty ERP XL”).
Wskazówka
W mechanizmie przenoszenia wartości z kontrolki „Dane tabelaryczne” do formatki „Dokumenty ERP XL” można włączyć tryb wskazywania wierszy.
Dzięki temu tylko oznaczone elementy zostaną przeniesione do formatki „Dokumenty ERP XL”. Mechanizm można wykorzystać np. w częściowej realizacji zamówienia.
Aby włączyć tryb wskazywania wierszy, należy dodać w kontrolce typu dane tabelaryczne, z której będą mapowane wartości, kolumnę typu Wartość logiczna (np. „Czy zatwierdzono”) i wybrać opcję „Tak” w polu Wybór wierszy. Wówczas na kontrolkę typu Dokument ERP XL zostaną zmapowane wartości tylko z tych wierszy, dla których zaznaczono checkbox w kolumnie typu Wartość logiczna.
Pole „Wybór wiersza”
Wybór wierszy, które mają zostać zmapowane do kontrolki typu Dokument ERP XL – gdy wybrano opcję „TAK” w polu „Wybór wierszy” w kontrolce typu Dane tabelaryczne
Mechanizm przenoszenia wartości z kontrolki „Dane tabelaryczne” do formatki „Dokumenty ERP XL” działa na wszystkich platformach Comarch DMS.
Mapowanie wartości z kontrolek do kontrolki typu Dokument ERP XL
Przyklad
Przykład przenoszenia wartości z wybranych kontrolek oraz z kontrolki typu dane tabelaryczne
Operator:
utworzył kontrolki Kontrahent , Waluta, Opis i Załącznik
utworzył kontrolkę typu dane tabelaryczne o nazwie Elementy z następującymi kolumnami:
Przykładowe kolumny w kontrolce typu Dane tabelaryczne
utworzył kontrolkę typu Dokument ERP XL o nazwie Faktura zakupu, w zakładce Tryb pracy wybrał opcję Dla elementu
Przykładowa kontrolka typu Comarch ERP XL- zakładka „Ogólne”
na zakładce Wartości mapowane wskazał skąd będą pobierane informacje wyświetlane w kontrolce – w sekcji Nagłówek wybrał w odpowiednich polach kontrolki Kontrahent, Waluta, Opis i Załącznik, zaś w sekcji Elementy wskazał poszczególne kolumny kontrolki tabelarycznej, na podstawie których zostaną uzupełnione wartości:
Kontrolka Dokument ERP XL, wskazanie kontrolek, z których będą mapowane wartości do tworzonego dokumentu
Kontrolka Dokument ERP XL, wskazanie elementów kontrolki tabelarycznej (kolumn), z której będą mapowane wartości do tworzonego dokumentu
następnie operator zapisał typ obiegu, utworzył nowy dokument i uzupełnił kontrolki Kontrahent, Waluta, Elementy i Opis, a także dodał załącznik do kontrolki Załącznik.
Wartości z kontrolek Kontrahent, Waluta i Elementy zostały zmapowane na odpowiednie pola na zakładce Dokument, zaś wartość z kontrolki Opis – na pole Opis na zakładce Opis analityczny, natomiast załącznik z kontrolki Załącznik zostanie dołączony do wygenerowanego dokumentu i będzie widoczny w Comarch ERP XL na karcie danego dokumentu w zakładce Załączniki.
Mapowanie wartości z kontrolek do kontrolki typu Dokument ERP XL – zakładka „Dokument” – po lewej zaznaczono kontrolki, z których mapowano wartości, a po prawej – pola, do których mapowano wartości z kontrolek
Mapowanie wartości z kontrolek do kontrolki typu Dokument ERP XL – zakładka „Opis analityczny” – po lewej zaznaczono kontrolkę, z której mapowano wartość, a po prawej – pole, do którego mapowano wartość z kontrolki
Zmapowany załącznik po wygenerowaniu dokumentu do Comarch ERP XL
W wersji 2018.1 udostępniono możliwość określania czy na danym etapie obiegu dane będą mapowanedo kontrolki ‘Dokument ERP XL’.
Na zakładce Kontrolki na etapie definiowanego procesu prezentowana jest właściwość nazwa_kontrolki (mapowanie). Zaznaczenie parametru ‘Widoczna’ powoduje, że w etapie dane będą mapowane do kontrolki, odznaczenie parametru wyłącza mapowanie na tym etapie.
Etap obiegu dokumentów, włączone mapowanie danych z karty obieg
W przypadku spinacza nagłówkowego faktury zakupu w kontrolce typu Dokument ERP XL dostępne są zakładki:
Zakładka Ogólne
Na właściwościach tej kontrolki można zainicjować pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.,
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu,
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”,
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”,
Nazwa spółki – wyświetlana, gdy DMS pracuje w trybie wielospółkowym,
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki
Zakładka Dokument ERP XL
Zakładka Dokument ERP XL zawiera kontrolki:
Typ – kontrolka umożliwia wybranie typu generowanego dokumentu
Tryb pracy – kontrolka prezentuje tryb pracy opisu analitycznego; w przypadku spinacza nagłówkowego faktury zakupu, tryb pracy zawsze będzie ustawiony ‘Dla elementu’, bez możliwości zmiany wartości
Typ dokumentu w kontrolce Dokument ERP XL: Spinacz nagłówkowy faktury zakupu
W przypadku spinaczy nagłówkowych faktur zakupu generowanie dokumentów odbywa się w oknie systemu Comarch ERP XLwywołanym z poziomu kontrolki Dokument ERP XL.
Po wybraniu ikony w kontrolce typu Dokument ERP XL wyświetlona zostaje lista dokumentów zakupowych Comarch ERP XL, na której możliwe jest dodanie dokumentu PZ i następnie:
wybranie istniejącej pary spiętych dokumentów PZ i (S)FZ.
Uwaga
W Comarch DMS prezentowane są wyłącznie takie dokumenty (S)FZ, które powstały z dokładnie jednego dokumentu PZ i nie były korygowane.
Spinacz nagłówkowy faktury zakupu (S)FZ dodawany z poziomu dokumentu Comarch DMS.
Po utworzeniu i zapisaniu spinacza i wybraniu na liście dokumentów Comarch ERP XL, dokumenty PZ i (S)FZ do którego został spięty, zostają dowiązanedo kontrolki Dokument ERP XL.
Prezentacja dokumentów PZ i (S)FZ w kontrolce typu Dokument ERP XL
Dane dokumentu spinacza nagłówkowego faktury zakupu (S)FZ zostają przeniesione na formatkę kontrolki Dokument ERPXL.
Dla dokumentu spinacza (S)FZ na formatce Dokument ERP XL w aplikacji Comarch DMS wyświetlane są trzy zakładki:
Przyjęcie zewnętrzne – zakładka, na którą przenoszone są dane z dokumentu PZ będącego elementem spinacza (S)FZ, dodanego w kontrolce Dokument ERP XL, dane z dokumentu wyświetlane są w trybie do odczytu, oznacza to, że nie ma możliwości wprowadzenia zmian na dokumencie PZ.
Formatka Dokument ERP XL, gdy w kontrolce dodano dokument spinacza nagłówkowego faktury zakupu – zakładka „Przyjęcie zewnętrzne”
Spinacz faktury – zakładka, na którą przenoszone są dane z dowiązanego dokumentu (S)FZ, dane z dokumentu wyświetlane są w trybie do odczytu, oznacza to, że nie ma możliwości wprowadzenia zmian na dokumencie (S)FZ.
Formatka Dokument ERP XL, gdy w kontrolce dodano dokument spinacza nagłówkowego faktury zakupu – zakładka „Spinacz faktury”
Opis analityczny – zakładka, na której operator ma możliwość wprowadzenia opisu analitycznego dokumentu oraz aktualizacji opisu w systemie Comarch ERP XL.
Uzupełnienie opisu analitycznego dotyczy wyłącznie dokumentu spinacza. W kolumnie Pozycja opisu analitycznego w zależności od odliczenia VAT, dostępne będą elementy:
Opis dla nagłówka dokumentu spinacza: „dokument_<rodzaj zakupu>”
Opis dla nagłówka dokumentu PZ: „1/<numer PZ>/dokument_<rodzaj zakupu>”
Opis dla VAT’u z nagłówka dokumentu spinacz: „dokument_VAT_koszt”
Opis dla elementu dokumentu PZ: „1/<numer PZ>/<kod towaru>”
Prezentowane wymiary opisu analitycznego, są wymiarami dostępnymi dla centrum w systemie Comarch ERP XL, w którym wygenerowano dokument spinacza nagłówkowego faktury zakupu.
Formatka Dokument ERP XL, gdy w kontrolce dodano dokument spinacza nagłówkowego faktury zakupu – zakładka „Opis analityczny”
W przypadku wyświetlania w kontrolce dokument ERP XL dokumentów PZ i spinacza (S)FZ, do którego został spięty, nie ma możliwości odwiązania dokumentów pojedynczo. Gdy użytkownik chciałby zmienić spięte dokumenty na inne, konieczne jest usunięcie dokumentówza pomocą ikony znajdującej się na formatce Dokument ERP XL wyświetlonej z kontrolki typu Dokument ERP XL. Zanim dokumenty zostaną usunięte z formatki Dokument ERP XL, zostanie wyświetlony komunikat:
Komunikat wyświetlany po wybraniu ikony Usuń, w celu usunięcia powiązania z dokumentem PZ i spinaczem nagłówkowym faktury zakupu, do którego spięto ten dokument
Generowanie dokumentu z poziomu formatki „Dokument ERP XL” bez opisu analitycznego
W kontrolce „Dokument ERP XL” istnieje opcja generowania dokumentów z opisem analitycznym.
Po zaznaczeniu na właściwościach kontrolki opcji „Generowanie dokumentu bez OA”, system pozwoli na wygenerowanie dokumentu bez wprowadzonego opisu analitycznego.
Jeżeli opis zostanie wprowadzony, dokument zostanie wygenerowany z opisem analitycznym.
Przy odznaczonej opcji „Generowanie dokumentu bez OA” system wymaga aby opis analityczny był wprowadzony.
Przy odwiązywaniu dokumentu z formatki „Dokument ERP XL” pozostaw w dokumentach powiązanych
Z poziomu formatki „Dokument ERP XL” istnieje możliwość odwiązania dokumentu ERP XL za pomocą przycisku .
Funkcjonalność ta jest powiązana z kontrolką typu „Dokumenty związane” oraz formatką ERP XL „Historia związanych”.
W momencie odwiązywania dokumentu usuwane są informacje o powiązaniu obu dokumentów.
Po zaznaczeniu na właściwościach kontrolki „Dokument ERP XL” opcji „Po odwiązaniu pozostaw w dokumentach związanych”, informacja o związaniu dokumentów nie jest usuwana.
Dokument ERP XL przed odwiązaniem dokumentu, przy zaznaczonym parametrze „Po odwiązaniu pozostaw w dokumentach związanych”
Dokument ERP XL po odwiązaniu dokumentu, przy zaznaczonym parametrze „Po odwiązaniu pozostaw w dokumentach związanych”
W sytuacji, gdy w kontrolce Dokument ERP XL za pomocą przycisku nastąpi próba odpięcia dokumentu wygenerowanego w systemie Comarch ERP XL, wyświetlany jest komunikat jak poniżej:
Komunikat wyświetlany w aplikacji desktop po kliknięciu w przycisk „Odwiąż dokument”
Wybranie odpowiedzi „Tak”, spowoduje odwiązanie dokumentu, wybranie odpowiedzi „Nie” lub kliknięcie poza komunikatem spowoduje zamknięcie komunikatu i powrót do edycji dokumentu.
Edycja wartości w kontrolce Dokument ERP XL
W Comarch DMS umożliwiono edycję wartości w kolumnach:
CenaN,
CenaB,
Wartość netto
Wartość brutto
na dokumencie ERP XL.
Zmiana wartości w jednej z tych kolumn powoduje przeliczenie wartościw pozostałych kolumnach.
Funkcjonalność dostępna jest dla typów dokumentów:
(A)Faktura zakupu
Faktura zakupu (w trybie elementowym)
(A)Korekta faktury zakupu
(A)Faktury sprzedaży
(A)Faktura zakupu uproszczona
Zamówienie zakupu (w trybie elementowym)
Od wersji 2024.1.0 dla typów dokumentów: (A)Faktura zakupu i (A)Korekta faktury zakupu w przypadku, jeśli w ramach pola „Sposób dodawania pozycji” na zakładce „Dokument ERP XL” wybrano opcję „Tabela VAT”, możliwa jest również edycja wartości w kolumnach:
Stawka VAT
Wartość netto
Wartość Vat
Wartość brutto
Odliczenie VAT
Dokument ERP XL – edycja wartości
Parametr ‘Cena z dokładnością do groszy’
Na dokumencie ERP XL udostępniono parametr ‘Cena z dokładnością do groszy’.
Zaznaczenie parametru powoduje zaokrąglanie wprowadzonej ceny netto i bruttodo dwóch miejsc po przecinku.
Odznaczenie parametru pozwala użytkownikowi na wprowadzenie ceny netto i ceny brutto z dokładnością do sześciu miejsc po przecinku.
W przypadku, gdy:
w Comarch ERP XL w konfiguracji (System/Konfiguracja/Sprzedaż/Rabaty i promocje) odznaczono parametr ‘Rabaty liczone od ceny’
i
w Comarch DMS odznaczono parametr ‘Cena z dokładnością do groszy’
dla dokumentów:
(A)Faktura zakupu,
Faktura zakupu (w trybie elementowym),
(A)Korekta faktury zakupu,
(A)Faktury sprzedaży
cena będąca podstawą naliczania VAT będzie zaokrąglana analogicznie jak w Systemie Comarch ERP XL.
Zaznaczenie w Comarch ERP XL parametru ‘Rabaty liczone od ceny’ umożliwiwprowadzanie wartości z dokładnością do sześciu miejsc po przecinku.
Zaznaczony parametr "Rabaty liczone od ceny" w Comarch ERP XL
Parametr "Cena z dokładnością do groszy"
Dokument ERP XL i (A)FZ gdy zaznaczono ‘Rabaty liczone od ceny’ w Comarch ERP XL i odznaczono ‘Cena z dokładnością do groszy’ w Comarch DMS
Prezentacja numeru rachunku bankowego kontrahenta w kontrolce Dokument ERP XL
Uwaga
Funkcjonalność dostępna jest w Comarch DMS w wersji 2019.0 we współpracy z Comarch ERP XL do wersji 2018.2.
Funkcjonalność jest znowu dostępna od wersji Comarch DMS 2020.2.2. we współpracy z Comarch ERP XL w wersjach nowszych niż 2019.0.
W kontrolce typu Dokument ERP XL prezentowany jest numer rachunku bankowego i adresu płatnika. Dane płatnika pobierane są na podstawie informacji zawartych na karcie kontrahenta wskazanego w polu Kontrahent.
Prezentacja numeru rachunku bankowego i adresu płatnika w kontrolce Dokument ERP XL, aplikacja desktop
Pole zawierająceRachunek bankowy/ Adres płatnika zostało udostępnione dla dokumentów: FZ, (A)FZ i dla uproszczonej (A)FZ. W polu prezentowane są informacje w następującej kolejności:
1. numer rachunku bankowego płatnika przypisany do adresu płatnika
2. nazwa płatnika
3. adres płatnika
Domyślna wartość prezentowana w polu Rachunek bankowy/ Adres płatnika pobierana jest z aktualnego adresu ustawionego na karcie płatnika w systemie Comarch ERP XL.
Gdy na karcie płatnika zdefiniowano więcej niż jeden adres, na rozwijanej liście wyświetlane są dane ze wszystkich zdefiniowanych adresów.
W przypadku, gdy na karcie kontrahenta ustawiono płatnika będącego urzędem, pracownikiem lub bankiem pole Rachunek bankowy/ Adres płatnika jest nieaktywne i nie prezentuje danych.
W przypadku, gdy do kontrolki typu Dokument ERP XL dowiązano istniejący dokumentz systemu Comarch ERP XL, pole Rachunek bankowy/ Adres płatnika jest nieaktywne i nie prezentuje danych.
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu „Dokumenty w obiegu”służy do prezentacji numerów dokumentów z aplikacji Comarch DMS oraz do ich podglądu.
Do kontrolki można podpiąć dowolnąliczbę numerów dokumentów.
W kontrolce dostępny jest każdy zapisany na liście dokument.
Numery wyświetlane są po wpisaniu do kontrolki frazy– dowolnej części numeru.
Kontrolka „Dokumenty w obiegu” z podpiętymi dokumentami
Możliwe jest usunięcie podpiętego dokumentu po kliknięciu na ikonę.
Na definicji kontrolki dostępne są następujące pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią.
Uwaga
Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Po zapisie nie zamykaj dokumentu w kontrolce – parametr odpowiadający za zachowanie dokumentu wygenerowanego lub dowiązanego w ramach kontrolki lub kolumny w kontrolce tabelarycznej.
Dokument – przyjmuje wartości ‘Wszystkie’ i ‘Aktywne’. Wartość „Wszystkie”odnosi się do wszystkich utworzonych w aplikacji dokumentów, natomiast wartość „Aktywne” tylko do tych, które są w stanie innym niż zakończone.
Typ obiegu – parametr, w którym można wskazać typ obiegu, z którego dokumenty będą mogły być podpinane w kontrolce, wartość parametru może pozostać pusta, wówczas możliwe będzie podpięcie dokumentu każdego typu.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
Kontrolki powiązane – możliwy jest wybór kontrolek, których wartości będą obserwowane przez kontrolkę typu „Dokumenty w obiegu”.
Wzór na wartość – należy wprowadzić wyrażenie lub zapytanie SQL inicjujące kontrolkę typu „Dokumenty w obiegu”.
Przyklad
Na dokumencie Comarch DMS kontrolka ta umożliwia wyszukiwanie dokumentów w oparciu o wpisaną frazę – dowolną część numeru dokumentu.
Kontrolka typu Dokumenty w obiegu na dokumencie po wpisaniu początkowej frazy numeru dokumentu
Kontrolka typu Dokumenty w obiegu na dokumencie z podpiętym dokumentem możliwym do podglądu
Podgląd dokumentu podpiętego do kontrolki typu Dokumenty w obiegu
Kontrolka typu Dokumenty w obiegu i jej właściwości
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu „Dokumenty związane” służy do prezentacji numerów dokumentów dowiązanych z systemu Comarch ERP XL.
Kontrolka prezentuje numery dokumentów, które zostały dowiązane poprzez kontrolki „Dokument elektroniczny” i „Dokument ERP XL”.
Na właściwościach tej kontrolki można zainicjować pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
Dodanie tej kontrolki na szczegółach dokumentu umożliwia prezentację wszystkich powiązanych dokumentów w jednym miejscu.
Właściwości kontrolki typu Dokumenty związane
Wiązanie dokumentu Comarch ERP XL z dokumentem Comarch DMS i prezentacja wiązania w aplikacji Comarch DMS, gdzie na karcie obiegu znajduje się: kontrolka typu Dokument elektroniczny o nazwie „Dokument elektroniczny”, kontrolka typu Dokument ERP XL o nazwie „Dokument ERP XL” i kontrolka typu „Dokumenty związane”o nazwie „Dokumenty związane”:
Kontrolkę „Dokument elektroniczny” jest pusta, natomiast dowiązano dokument z Comarch ERP XL w ramach kontrolki „Dokument ERP XL” i zapisano dokument w Comarch DMS– numer dowiązanego dokumentu zostanie zaprezentowany w oknie kontrolki „Dokumenty związane”.
Kontrolka „Dokumenty związane”, gdy dowiązano dokument w kontrolce typu Dokument ERP XL
Kontrolkę „Dokument ERP XL” jest pusta, natomiast wybrano dokument z Comarch ERP XL w ramach kontrolki „Dokument elektroniczny” i zapisano dokument w Comarch DMS – numer wybranego dokumentu zostanie zaprezentowany w oknie kontrolki „Dokumenty związane”.
Kontrolka „Dokumenty związane”, gdy wybrano dokument w kontrolce typu Dokument elektroniczny
Wypełniono kontrolkę „Dokument elektroniczny” i dowiązano inny dokument z Comarch ERP XL w ramach kontrolki „Dokument ERP XL” , a następnie zapisano dokument w Comarch DMS – numery obydwóch dokumentów zostaną zaprezentowane w oknie kontrolki „Dokumenty związane”.
Kontrolka „Dokumenty związane”, gdy wybrano dokument w kontrolce typu Dokument elektroniczny i dowiązano inny dokument w kontrolce typu Dokument ERP XL
Kontrolkę typu „Dokumenty związane” można zaprezentować tylko raz na danym dokumencie. Możliwa jest natomiast prezentacja kilku typów dokumentów związanych w jednej kontrolce.
Kontrolka typu „Etykieta” umożliwia prezentowanie danych, które nie podlegają zmianie i wprowadzone zostały podczas tworzenia typu obiegu. Na definicji kontrolki dostępne są następujące pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią.
Uwaga
Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Kontrolka może być wykorzystywana do określenia np. nazwy/typu obiegu w ramach, którego wystawiany jest bieżący dokument. Może też służyć do wizualnego oddzielenia na dokumencie różnych grup informacji, np. informacji dotyczących faktury od danych adresowych kontrahenta.
Właściwości kontrolki Etykieta
Etykieta na dokumencie
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Na właściwościach tej kontrolki można zainicjować pola:
Nazwa (identyfikator) – umożliwia wprowadzenie nazwy kontrolki, która musi być unikalna w ramach karty obiegu.
Tytuł – w tym polu można wprowadzić tekst, który ma zostać wyświetlony w tytule okna komunikatu
Kontrolki powiązane – możliwy jest wybór kontrolek, których wartości będą obserwowane przez kontrolkę typu Komunikat.
Wzór na wartość – w tym polu można wprowadzić wyrażenie inicjujące kontrolkę typu Komunikat
Ustaw – wyświetla okno edytora, do którego należy wprowadzić zapytanie lub kod definiujący komunikat.
Kontrolka typu Komunikat i jej właściwości
Mechanizm umożliwia wyświetlenie komunikatu podczas następujących zdarzeń:
po wprowadzeniu tekstu/ wyborze dokumentu elektronicznego dla mechanizmu obserwatora kontrolek typu: tekst, data i godzina, liczba całkowita, liczba rzeczywista, liczba stałoprzecinkowa, dokument elektroniczny, dokument ERP XL, kontrahent, towar. Mechanizm jest aktywowany dla każdego etapu, dla którego została zaznaczona widoczność kontrolki.
po otworzeniu dokumentu.
Wskazówka
Składnia: Select Top 1 ‘Komunikat’, 1;
Pierwszy parametr typu varchar(max) to tekst wyświetlany w komunikacie.
Drugi parametr typu int umożliwia zablokowanie przekazania dokumentu do kolejnego etapu.
Wartości:
0 – można przekazać dokument do kolejnego etapu
1 – zablokowana możliwość przekazania dokumentu do kolejnego etapu. Jest to parametr opcjonalny, domyślnie ustawiony na 0
Przyklad
Operator chce, aby nie było możliwe przekazanie dokumentu do następnego etapu, jeśli w kontrolce „Wartość netto” wpisano wartość ujemną, chce też, aby został wyświetlony komunikat, który poinformuje o przyczynie blokady przekazania.
W tym celu w definicji kontrolki typu Komunikat w polu „Kontrolki powiązane” operator dodaje do obserwacji kontrolkę „Wartość netto” (identyfikator: „netto”), a po wyborze „SQLOD” i kliknięciu w link „Ustaw” wprowadza następujące zapytanie SQL:
if @netto@ < 0 select Top 1
'Wartość wprowadzona w kontrolce "Wartość netto" jest ujemna
- popraw wartość, aby móc przejść do kolejnego etapu', 1;
Wprowadzanie zapytania SQL dla kontrolki typu Komunikat
Następnie operator zapisuje zmiany w obiegu. Kiedy użytkownik DMS będzie próbował wprowadzić wartość ujemną do kontrolki „Wartość netto”, wówczas przekazanie dokumentu do następnego etapu zostanie zablokowane i zostanie wyświetlony komunikat o treści określonej w zapytaniu SQL.
Komunikat wyświetlany po wprowadzeniu wartości ujemnej do kontrolki „Wartość netto”
Przyklad
Administrator chce, aby nie było możliwe przekazanie do kolejnego etapu dokumentu, dla którego w polu „Numer dokumentu” wprowadzono numer dokumentu identyczny z numerem dokumentu, który już został zapisany.
W tym celu w definicji kontrolki typu Komunikat w polu „Kontrolki powiązane” operator dodaje do obserwacji kontrolkę „Numer dokumentu” (identyfikator: „Numer_dokumentu”), a po wyborze „SQLOD” i kliknięciu w link „Ustaw” wprowadza następujące zapytanie SQL:
BEGIN TRY
if exists (
SELECT * from do.RO_ControlsValue c
join do.RO_Documents d on c.DWD_ID=d.DWD_ID
join do.DF_HeadDokumentFlow h on h.DFH_Id=d.DFH_Id and DFH_Name='Faktury'--nazwa typu obiegu
join do.DF_ConfCFCardDokFlow s on s.DKO_ID=c.DKO_ID
and s.DKO_Name = 'Numer_dokumentu'--identyfikator kontrolki obserwowanej
where c.Value= @Numer_dokumentu@ and d.DWD_ID <> @^DocumentId@
)
SELECT 'Nr obcy już istnieje', 1
END TRY
BEGIN CATCH
DECLARE @ErrorMessage varchar(max) = 'W zapytaniu wystąpił błąd : ' + ERROR_MESSAGE();
THROW 50001, @ErrorMessage ,1;
END CATCH
Definicja kontrolki typu Komunikat
Poniższy rysunek prezentuje przykład działania komunikatu i blokady przekazania dokumentu do kolejnego etapu.
Wykorzystanie kontrolki komunikat w pracy z aplikacją
Kontrahent
Kontrolka typu „Kontrahent” umożliwia wczytywanie na kartę obiegu Comarch DMS kontrahenta z listy kontrahentów zdefiniowanych w programie Comarch ERP XL.
Na definicji kontrolki dostępne są następujące pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalnaw ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią.
Uwaga
Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Nazwa spółki – parametr dostępny w trybie wielofirmowym. Określa spółkę, z której będzie można wskazać kontrahenta.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
Inicjowanie wartości
Pole Inicjowanie może przyjąć wartość: Brak, SQL OD, SQL ERP (od wersji 2023.1.0) lub C# Script.
Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
W przypadku wartości „SQL OD” lub „SQL ERP” pojawia się możliwość zdefiniowania zapytania SQL, za pomocą którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”.
Parametr „Inicjuj przy każdym otwarciu dokumentu”
Dla wartości „C# Script”możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.
Zaznaczenie parametru „Inicjuj przy każdym otwarciu dokumentu”powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.
Uwaga
Od wersji 2023.1.2 jeżeli operator w ramach pola „Inicjowanie” wybierze wartość SQL OD, SQL ERP lub C# Script, ale nie kliknie w link „Ustaw” i nie wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „Kontrahent 1” w polu „Inicjowanie” wybrano opcję „C#Script” oraz na definicji kontrolki „Kontrahent 2” w polu „Inicjowanie” wybrano opcję „SQL ERP”, ale nie wprowadzono zapytań
Kontrolka typu Kontrahent i jej właściwości
W sekcji „Podgląd karty obiegu” po dodaniu kontrolki typu Kontrahent prezentowany jest przycisk , który otwiera listę kontrahentów z programu Comarch ERP XL.
Dodawanie kontrahenta w ramach kontrolki typu Kontrahent
– w kontrolce prezentowane są przyciski [Zmień] wywołujący listę kontrahentów z Comarch ERP XL, na której można dokonać zmiany kontrahenta przypisanego do dokumentu oraz [Odepnij] który usunie wskazanie na kontrahenta.
Zmiana kontrahenta w ramach kontrolki typu Kontrahent
Przyklad
Administrator chce, aby po wpisaniu numeru NIP w kontrolce „NIP kontrahenta” (identyfikator: „nip_kontrahenta”) w kontrolce „Kontrahent” został wybrany kontrahent o tym numerze NIP.
W tym celu w definicji kontrolki typu Kontrahent w polu „Kontrolki powiązane” operator dodaje do obserwacji kontrolkę „NIP kontrahenta”(identyfikator: „nip_kontrahenta”), a po wyborze „SQL ERP”i kliknięciu w link „Ustaw”wprowadza następujące zapytanie SQL:
select knt_gidnumer from cdn.kntkarty where knt_nip= @nip_kontrahenta@
Definiowanie kontrolki typu Kontrahent
Następnie administrator zapisuje zmiany w obiegu. Kiedy użytkownik DMS wprowadzi numer NIP do kontrolki „NIP kontrahenta”, wówczas w kontrolce „Kontrahent” automatycznie wybrany zostanie kontrahent o danym numerze NIP (jeśli znajduje się na liście kontrahentów w Comarch ERP XL).
Automatyczny wybór kontrahenta na podstawie numeru wpisanego w kontrolce „NIP kontrahenta”
Przyklad
Administrator pragnie, aby po wyborze dokumentu z Comarch ERP XL w kontrolce typu Dokument elektroniczny o nazwie „FZ” (identyfikator:”FaZ”) w kontrolce typu Kontrahent o nazwie „Kontrahent” automatycznie był wybierany kontrahent występujący w danym dokumencie.
W tym celu w definicji kontrolki typu Kontrahent w polu „Kontrolki powiązane” operator dodaje do obserwacji kontrolkę „FZ” (identyfikator: „FaZ”), a po wyborze „SQL ERP” i kliknięciu w link „Ustaw” wprowadza następujące zapytanie SQL:
select d.Trn_KntNumer from cdn.TraNag d
where d.TrN_GIDTyp = @FaZ_IdType@ and d.TrN_GIDNumer = @FaZ_Id@
Definiowanie kontrolki typu Kontrahent
Następnie administrator zapisuje zmiany w obiegu. Kiedy użytkownik DMS doda dokument z systemu Comarch ERP XL w kontrolce „FZ”, wówczas w kontrolce „Kontrahent” automatycznie wybrany zostanie kontrahent określony na danym dokumencie.
Automatyczny wybór kontrahenta na podstawie dokumentu wybranego w kontrolce „FZ”
Wskazówka
Jeśli podczas próby dowiązania kontrahenta z systemu Comarch ERPXL do kontrolki Kontrahent:
formatka z listą kontrahentów nie podnosi się – sprawdź tutaj
pojawia się komunikat: „Baza nie jest zarejestrowana w systemie ERPXL” – sprawdź tutaj
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
[Dodaj] w panelu „Kontrolki”. Pojawi się formatka, na której z rozwijalnej listy należy wybrać typ kontrolki oraz wprowadzić nazwę. W panelu „Podgląd karty obiegu” pojawi się podgląd kontrolki.
[Import danych z arkusza kalkulacyjnego]. Ikona znajduje się obok przycisku dodawania nowego wiersza 
w ramach kontrolki lub, w przypadku jeśli w zakładce „Schemat obiegu” zaznaczono parametr „Odświeżanie tabeli na żądanie” dla danej kontrolki typu Dane tabelaryczne, obok ikony odświeżania kontrolki .
[Import danych z arkusza kalkulacyjnego].
[Otwórz].
[Otwórz] 
[Otwórz], ale 
wartości zostaną wyliczone i zaprezentowane w kolumnie "Wartość netto" oraz w kontrolce "Łączna wartość netto dokumentu".
znajdującej się na formatce Dokument ERP XL wyświetlonej z kontrolki typu Dokument ERP XL. Zanim dokumenty zostaną usunięte z formatki Dokument ERP XL, zostanie wyświetlony komunikat:
.
.
„Odwiąż” (w kwestii dowiązywania i odwiązywania dokumentów z Comarch ERP XL w Comarch DMS zob. 
, który otwiera 
– w kontrolce prezentowane są przyciski 
[Zmień] wywołujący 
[Odepnij] który 
