Informacje ogólne

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, Dane tabelaryczne) – umożliwiają wiązanie dokumentów, kontrahenta lub towaru z programu Comarch ERP Optima, Comarch ERP XL lub Comarch ERP Altum do aplikacji Comarch DMS (jeśli ustawiono współpracę z którymś z tych programów w trybie wielospółkowym).
  • 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 kontrolki oraz 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ładowe właściwości 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 kontrolki nie może zawierać więcej niż 128 znaków.
  • 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, C# lub 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 wprowadzi zapytania, 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 OD”, ale nie wprowadzono zapytania

  • 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.
  • 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.
  • 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.
  • C# Script – właściwość kontrolki typu Własna akcja w wersji Comarch DMS Premium, 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ę kontrolek powią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 C#.
  • Wersjonowanie pliku – właściwość kontrolki typu Załącznik. Umożliwia podpięcie na dokumencie kilku wersji tego samego pliku, z zaznaczeniem kolejności wersji.
  • 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.
  • 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.
  • Pogrubione pola we właściwościach kontrolek są polami wymaganymi i muszą zostać uzupełnione w celu zapisania typu obiegu.
  • 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
  • Zapisz do Repozytorium – parametr dostępny na zakładce „Archiwa” we właściwościach kontrolki typu Załącznik, jeśli współpraca z modułem Comarch DMS Repozytorium jest aktywna,  zaznaczenie parametru umożliwia dodanie załącznika do modułu Comarch DMS Repozytorium (zob. Konfiguracja kontrolki typu Załącznik w ramach integracji modułu Repozytorium z modułem Workflow);
  • 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?

Sprawdź Szkolenia Comarch DMS!

 




Dane tabelaryczne

 

Kontrolka typu dane tabelaryczne jest wielokolumnową kontrolką z możliwością wprowadzenia nieograniczonej liczby wierszy.

Wskazówka
Od wersji 2023.1.0 istnieje możliwość obserwowania przez kontrolkę typu Lista kontrolki typu Dane tabelaryczne (zob. przykład Obserwacja kontrolki typu Dane tabelaryczne przez kontrolkę typu lista).

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
  • Dokumenty w obiegu
  • Liczba całkowita
  • Liczba rzeczywista
  • Liczba stałoprzecinkowa
  • Lista
  • Tekst
  • Wartość logiczna

 

Przykład kontrolki 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 – oznaczenie 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”.

  • Ilość prezentowanych wierszyliczba 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

 

 

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

 

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 kontrolceparametr 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’ ‘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

 

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.
      • Listysł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

 

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.
      • Wybór wierszy –  w ramach parametru można wybrać wartość „TAK” .lub „NIE”. Parametr ma zastosowanie w przypadku uzupełniania wartości formatki typu Dokument ERP XL wartościami z kontrolki tabelarycznej (zob. Uzupełnianie wartości formatki Dokument ERP XL wartościami z kontrolki tabelarycznej)

 

Kontrolka typu Dane tabelaryczne, zakładka „Ogólne”, kolumna typu wartość logiczna

 

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:

  • Nazwanazwa słownika listy;
  • Inicjowaniesposób inicjowania listy: Słownik, SQL OD, C# Script;
  • 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ą.

Uwaga
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
  • Nazwa spółki – pole dostępne w wielofirmowym trybie pracy, umożliwia wybór spółki;
  • 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”, inicjowanie kontrolki zapytaniem SQL z bazy obiegu,
  • wartość „C# Script”, inicjowanie kontrolki kodem 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 wprowadzi zapytania, 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

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:

1. pierwsze dwie kolumny zawierają parametry dotyczące blokady dodawania i usuwania wierszy.

2. pozostałe kolumny to kolejne kolumny zdefiniowanej kontrolki typu Dane tabelaryczne.

3. 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 kalkulacyjnym rozpocząć 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 kalkulacyjnym dodać tabelę z co najmniej 1 kolumną i co najwyżej 20 kolumnami
  • W kontrolce typu Dane tabelaryczne dodać 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)
    • Dokumenty w obiegu – typ danych w Excelu: liczba, tekst
    • 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
    • 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.

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. Utworzenie nowego dokumentu możliwe jest wyłącznie wtedy, gdy w definicji kolumny typu Dokumenty w obiegu wskazano dokładnie jeden typ 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

 

Inicjowanie kontrolki tabelarycznej zapytaniem SQL

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 zamieszczanym 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 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 dokumentu.

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 kontrolkiTyp kolumny SELECTPrzykład
Tekstvarchar (900)'Uwagi do płatności'
Data i godzinadatetime'20170926' - format 'YYYYMMDD'
Liczba całkowitaint123
Liczba stałoprzecinkowadecimal (22,4)1000.55
Liczba rzeczywstareal2000.55
Listaint1 - id pozycji
Wartość logicznaint0 - Nie
1 - Tak

 

Przyklad

Jeżeli w kontrolce dane tabelaryczne zostały zdefiniowane cztery kolumny o następujących typach:

1) Tekst

2) Data

3)liczba stałoprzecinkowa

4) lista,

zapytanie select może wyglądać następująco:

 

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">Kolumny

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">1

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">4

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">2

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">3

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Tekst

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Data

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Liczba stałoprzecinkowa

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Id listy

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Tryb

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">SELECT

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Monitor 23”,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">20170923,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">123.50,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">3,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">2

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">UNION

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">SELECT

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Klawiatura QWERTY,

<p style="text-align: center;
vertical-align: middle;
margin: 0 auto">20170508,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">348.00,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">2,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">2

 

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 etapzakł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".

 

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?

Sprawdź Szkolenia Comarch DMS!




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ć 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 wierszaparametr 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.

 

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

  • nie można używać nawiasów kwadratowych
  • nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

Sekcja Inicjowanie wartości

  • Inicjowanie – pole może przyjąć wartość: Brak, SQL OD 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” 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”.

 

Kontrolka Data i godzina, 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 wprowadzi zapytania, 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 OD”, ale nie wprowadzono zapytania

  • Inicjuj przy każdym otwarciu  – parametr widoczny, jeśli w polu „Inicjowanie” wybrano „SQLOD” 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”:

select GetDate()

 

Sekcja Zmiana wartości (Obserwator)

Możliwe jest wypełnianie wartości kontrolki typu Data i godzina na podstawie wartości kontrolek powiązanych, za pomocą zapytania SQL lub używając kodu C# (zob. Wypełnianie wartości kontrolki w oparciu o wartości innej kontrolki).




Dokumenty w obiegu

Kontrolka typu „Dokumenty w obiegu” służy do prezentacji numerów dokumentów z aplikacji Comarch DMS oraz do podglądu dokumentów.

Do kontrolki można podpiąć dowolną liczbę numerów dokumentów.

W kontrolce dostępny jest każdy zapisany na liście aktywny 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 wybranego 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 wierszaparametr 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.

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

  • nie można używać nawiasów kwadratowych
  • nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

  • 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




Etykieta

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

 

Kontrolka Etykieta i jej właściwości

 

Etykieta na dokumencie




Komunikat

Kontrolka typu komunikat służy do wyświetlania komunikatów na karcie obiegu pod wpływem danego zdarzenia.

Na definicji kontrolki dostępne są następujące pola:

  • Nazwa wyświetlana – nazwa kontrolki widoczna wyłącznie na liście kontrolek na definicji obiegu.
  • 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.
  • Tytuł – treść wyświetlana na belce nagłówkowej komunikatu.
  • Kontrolki powiązane – pole, w którym należy wskazać kontrolkę, której zachowanie będzie obserwowane przez kontrolkę typu Komunikat.
  • Wzór na wartość – możliwe wartości: SQL OD, SQL ERP, C# Script. Określa czy komunikat zostanie zdefiniowany za pomocą zapytania SQL czy kodu w języku C#.
  • 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, kontrahent, towar. Mechanizm jest aktywowany dla każdego etapu, dla którego została zaznaczona widoczność kontrolki.
  • Po otworzeniu dokumentu.

Wskazówka

Składnia definiowania komunikatu zapytaniem SQL:

Select Top 1 ‘Komunikat’, 1

  • Pierwszy parametr typu varchar(max) to tekst wyświetlany w komunikacie („Komunikat”)
  • Drugi parametr typu int umożliwia zablokowanie przekazania dokumentu do kolejnego etapu („1”).

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ą




Liczba całkowita

Uwaga
Zakres wartości dla kontrolki typu Liczba całkowita to -2,147,483,648 – 2,147,483,647

 

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

  • Pokaż na liścieparametr 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.

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

  • nie można używać nawiasów kwadratowych
  • nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

Kontrolka Liczba całkowita i jej właściwości

 

Sekcja Inicjowanie wartości

  • Inicjowanie – pole może przyjąć wartość: Brak, SQL OD 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” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą inicjowane wartości w kontrolce na karcie obiegu.

 

Parametr „Inicjuj przy każdym otwarciu dokumentu”

 

W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu C#, który będzie inicjował wartości w kontrolce.

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 wprowadzi zapytania, 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 „Liczba”  w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytania

 

  • Inicjuj przy każdym otwarciu  – parametr widoczny, jeśli w polu „Inicjowanie” wybrano „SQLOD” 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 inicjalizację SQL/C#. Odznaczenie parametru oznacza, że 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 liczba całkowita (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 liczba całkowita (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.

 

Sekcja Zmiana wartości (Obserwator)

Możliwe jest wypełnianie wartości kontrolki typu Liczba całkowita na podstawie wartości kontrolek powiązanych (zob. Wypełnianie wartości kontrolki w oparciu o wartości innej kontrolki).




Liczba rzeczywista

Uwaga
Liczba w kontrolce typu Liczba rzeczywista może być prezentowana z precyzją do 7 cyfr (łącznie z miejscami po przecinku).

 

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

  • Pokaż na liścieparametr 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.

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

  • nie można używać nawiasów kwadratowych
  • nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

 

Kontrolka typu Liczba rzeczywista i jej właściwości

 

Sekcja Inicjowanie wartości

  • Inicjowanie – pole może przyjąć wartość: Brak, SQL OD 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” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie.

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 wprowadzi zapytania, 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 „Liczba”  w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytania

Parametr „Inicjuj przy każdym otwarciu dokumentu”

 

W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu C#, który będzie inicjował wartości w kontrolce.

  • Inicjuj przy każdym otwarciu  – parametr widoczny, jeśli w polu „Inicjowanie” wybrano „SQLOD” 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 inicjalizację SQL/C#. Odznaczenie parametru oznacza, że 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 liczba rzeczywista (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 liczba rzeczywista (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.

 

Sekcja Zmiana wartości (Obserwator)

Możliwe jest wypełnianie wartości kontrolki typu Liczba rzeczywista na podstawie wartości kontrolek powiązanych (zob. Wypełnianie wartości kontrolki w oparciu o wartości innej kontrolki).

 

Formatka „Wyrażenie kontrolki”  z przykładowym zapytaniem SQL




Liczba stałoprzecinkowa

Od wersji 2024.0.0 kontrolka typu „Liczba stałoprzecinkowa” umożliwia wprowadzenie do aplikacji wartości, które wymagają precyzji z dokładnością do sześciu miejsc po przecinku.

Uwaga
Liczba w kontrolce typu Liczba stałoprzecinkowa może być prezentowana z precyzją do 18 cyfr znaczących i 6 miejsc po przecinku.

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.
  • Liczba miejsc po przecinku, do której będzie zaokrąglana wartość – parametr dodany w wersji 2024.0.0; w ramach parametru administrator Comarch DMS wybiera, ile miejsc po przecinku będzie można wpisać w danej kontrolce i do ilu miejsc po przecinku będzie zaokrąglana wprowadzona wartość. Parametr przyjmuje wartości od 0 do 6; domyślnie wybrana jest wartość 2.
    Uwaga
    Jeśli aktualizowano bazę do bieżącej wersji, wówczas domyślnie wartość parametru Liczba miejsc po przecinku, do której będzie zaokrąglana wartość jest ustawiona na 2.
    Jeśli:
    1. Liczba posiada 6 miejsc po przecinku

    oraz

    2.Wartość tej liczby jest przekazywana do kontrolki w module Workflow/Repozytorium/innym systemie, który posiada mniejszą precyzję

    wówczas wartość zostanie zaokrąglona do tej, która jest prezentowana w tej kontrolce

     

    Jeśli:
    1.Liczba posiada wybraną liczbę miejsc po przecinku

    oraz

    2.Wartość tej liczby jest przekazywana do kontrolki w module Workflow/Repozytorium/innym systemie, który posiada mniejszą precyzję
    wówczas w tej kontrolce zostanie wyświetlona ta wartość, a brakujące miejsca po przecinku zostaną uzupełnione zerami.

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

  • Pokaż na liścieparametr 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.

 

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

  • nie można używać nawiasów kwadratowych
  • nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

 

Kontrolka typu Liczba stałoprzecinkowa i jej właściwości

 

Sekcja Inicjowanie wartości

  • Inicjowanie – pole może przyjąć wartość: Brak, SQL OD 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” 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”

 

W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu C#, który będzie inicjował wartości w kontrolce.

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 wprowadzi zapytania, 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 „Liczba”  w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytania

  • Inicjuj przy każdym otwarciu  – parametr widoczny, jeśli w polu „Inicjowanie” wybrano „SQLOD” 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 inicjalizację SQL/C#. Odznaczenie parametru oznacza, że 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 liczba stałoprzecinkowa (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 liczba stałoprzecinkowa (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.

 

Sekcja Zmiana wartości (Obserwator)

Możliwe jest wypełnianie wartości kontrolki typu Liczba stałoprzecinkowa na podstawie wartości kontrolek powiązanych (zob. Wypełnianie wartości kontrolki w oparciu o wartości innej kontrolki).




Lista

Kontrolka typu „Lista” umożliwia wybór jednej pozycji z rozwijalnej listy wartości kontrolki.

Wskazówka
Od wersji 2023.1.0 istnieje możliwość obserwowania przez kontrolkę typu Lista kontrolki typu Dane tabelaryczne (zob. przykład Obserwacja kontrolki typu Dane tabelaryczne przez kontrolkę typu lista).

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

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

  • nie można używać nawiasów kwadratowych
  • nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

 

Gdy w polu „Inicjowanie” wybrano opcję „Słownik”, wówczas istnieje możliwość definiowania nowej wartości po kliknięciu w link „Dodaj” i ikonka usunięcia jej z listy (ikonka kosza).

 

Link „Dodaj” do dodawania nowych wartości i ikonka kosza do usuwania wartości z listy

 

Inicjowanie wartości

Pole Inicjowanie może przyjmować wartości: Słownik, SQL OD lub C# Script.

  • Gdy wybrana jest wartość „Słownik”, operator może zdefiniować stałą listę pozycji kontrolki i wybrać pozycję prezentowaną w kontrolce jako wartość domyślna.
  • W przypadku wartości „SQL OD” lista pozycji jest inicjowana w oparciu o zapytanie SQL działające na bazie Comarch DMS.
  • W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu w języku C#, który będzie inicjował wartości w kontrolce.

 

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 wprowadzi zapytania, 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 „Lista 1” w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytania

  • Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQL  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 inicjalizację SQL/C#. Odznaczenie parametru oznacza, że wartość zostanie zainicjowana raz.

 

Przykładowe zapytanie SQL w ramach kontrolki typu Lista

 

Kontrolka typu lista z wartościami zainicjowanymi słownikiem

 

Gdy parametr ‘Prezentuj wartość domyślną’ pozostanie odznaczony, wówczas na karcie obiegu w kontrolce domyślnie będzie wyświetlana pusta wartość (1), po rozwinięciu listy zostaną wyświetlone zdefiniowane wartości. Zaznaczenie parametru spowoduje, że domyślnie w kontrolce będzie wyświetlana zaznaczona wartość (2).

 

        1. Wygląd listy, gdy parametr „Prezentuj wartość domyślną” nie jest zaznaczony
        2. Wygląd listy, gdy parametr „Prezentuj wartość domyślną” jest zaznaczony

           

Parametr „Inicjuj przy każdym otwarciu dokumentu”

 

Wskazówka

Przykład zapytania SQL dla kontrolki typu “Lista”:

select 1, 'abcd’

union

select 2, ‘xyz’

 

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

 

Pole Tryb pracy przyjmuje wartości:

  • Lista – wypełnia kontrolkę pełną listą pozycji zdefiniowanych w oparciu o zapytanie SQL.

 

Właściwości kontrolki typu Lista, tryb pracy „Lista”

 

Kontrolka typu Lista przy ustawieniu „Tryb pracy: Lista”

 

  • Wyszukiwanie  – inicjuje kontrolkę listą pozycji spełniających kryteria wyszukiwania wprowadzone przez operatora. W trybie pracy Wyszukiwanie umożliwiono szukanie wartości po dowolnym ciągu znaków. Taki tryb pracy uzależniony jest od wartości parametru ‘Szukaj po dowolnym ciągu znaków’. Jeżeli parametr jest wyłączony, wówczas wyszukiwanie odbywa się po początkowych znakach danej wartości. W przypadku, gdy tryb pracy kontrolki zostanie ustawiony na Lista, parametr jest niedostępny.

 

Właściwości kontrolki typu Lista, tryb pracy „Wyszukiwanie”, zaznaczony parametr trybu pracy kontrolki: „Szukaj po dowolnym ciągu znaków”

 

Kontrolka typu lista, zawężanie wartości do dowolnego ciągu znaków

 

Właściwości kontrolki typu Lista, tryb pracy „Wyszukiwanie”,  odznaczony parametr trybu pracy kontrolki: „Szukaj po dowolnym ciągu znaków”

 

Kontrolka typu lista, wyszukiwanie według frazy początkowej

 

Kontrolka typu „Lista” może być wykorzystywana, jako kontrolka, z której użytkownik wybiera na karcie obiegu zdefiniowane wartości z konfiguracji kontrolki np. formy płatności. Jeżeli w konfiguracji tej kontrolki wprowadzone jest zapytanie SQL-owe, można na jego podstawie z bazy pobrać konkretną listę wartości, którą aplikacja automatycznie wprowadzi do pola kontrolki.

 

Przyklad

Na bazie Comarch DMS utworzono dodatkową tabelę (do.wdrKontrahenci), w której przechowywane będą dane kontrahentów:

 

Na definicji typu obiegu dodano kontrolkę typu lista:

 

Wartości w kontrolce typu lista będą inicjowane zapytaniem SQL:

 

 

Na podstawie zapytania w kontrolce „Kontrahent” na karcie obiegu dostępna będzie lista wszystkich kontrahentów znajdujących się w tabeli:

 

 

Kontrolka typu „Lista” na karcie obiegu wypełniana jest wartością domyślną, jeżeli w danym etapie dla tej kontrolki nie została zapisana wartość. Operator może edytować i zmieniać domyślną wartość na dokumencie. Wprowadzona wartość zostanie zapisana i zapamiętana.

Dla kontrolek typu lista została oprogramowana możliwość ponownego inicjowania wartości na kolejnych etapach. Jeżeli dla kontrolki została zaznaczona (na kilku etapach) właściwość „Inicjalizacja SQL” to na każdym etapie kontrolka zostanie zainicjonowana ponownie wartością domyślną.

Umożliwiono odwołanie się do nazwy oraz pozycji wybranego elementu w kontrolce typu „Lista”.

 

 

Kontrolka Lista i jej właściwości

 

Przyklad

Administrator chce, aby można było w prosty sposób dodać do kontrolki typu Dokumenty w obiegu dokumenty pochodzące z różnych typów obiegów w Comarch DMS.

W tym celu dodaje 3 kontrolki:

  • kontrolkę typu Lista o nazwie „Typ obiegu” (identyfikator: Typ_obiegu)
  • kontrolkę typu Lista o nazwie ” Dokumenty wybranego obiegu” (identyfikator: wybrany_obieg), która obserwuje kontrolkę „Typ obiegu”
  • kontrolkę typu Dokumenty w obiegu o nazwie „Dowiązane dokumenty” (identyfikator: Dowiazane), która obserwuje kontrolkę ” Dokumenty wybranego obiegu”

 

Następnie  we właściwościach kontrolki „Typ obiegu” w polu „Inicjowanie” wybiera „SQL OD” i klika w link „Ustaw”. W ramach otwartego okna wpisuje następujące zapytanie:

select DFH_Id, DFH_Name from do.RO_ObjectsTypes
where DFH_Archives = 0

 

Inicjowanie kontrolki „Typ obiegu”

 

Później administrator we właściwościach kontrolki „Dokumenty wybranego obiegu” w polu „Inicjowanie” wybiera „SQL OD” i klika w link „Ustaw”. W ramach otwartego okna wpisuje następujące zapytanie:

select dwd_id, DWD_FullNumber 
from do.RO_Documents
where DFH_Id = @Typ_obiegu_Id@

 

Wprowadzanie zapytania w kontrolce „Dokumenty wybranego obiegu” – konieczne jest, aby  w ramach pola „Kontrolki powiązane” została dodana kontrolka „Typ obiegu”

 

Potem zaś administrator we właściwościach kontrolki „Dowiązane dokumenty” w polu „Wzór na wartość” wybiera „SQL OD” i klika w link „Ustaw”. W ramach otwartego okna wpisuje następujące zapytanie:

select  @wybrany_obieg_Id@

 

Wprowadzanie zapytania w kontrolce „Dowiązane dokumenty” – konieczne jest, aby  w ramach pola „Kontrolki powiązane” została dodana kontrolka „Dokumenty wybranego obiegu”

 

Następnie administrator zapisuje zmiany.

Od tej pory operator na nowym dokumencie może wybrać typ obiegu dokumentów w kontrolce „Typ obiegu”, a następnie w kontrolce „Dokumenty wybranego obiegu” –  numery dokumentów z tego typu obiegu – wówczas wybrane dokumenty zostaną dodane do kontrolki ” Dowiązane dokumenty”. Możliwe jest wybranie kolejno różnych dokumentów z różnych typów obiegu.

 

 

Kontrolka „Typ obiegu” – kontrolka typu Lista

 

 

Kontrolka „Dokumenty wybranego obiegu” – kontrolka typu Lista

 

Dodawanie dokumentów do kontrolki typu Dokumenty w obiegu za pomocą kontrolek typu Lista