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ś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 Liczba całkowita i jej właściwości

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ą 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 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 „Liczba” w polu „Inicjowanie” wybrano opcję „SQL ERP” oraz na definicji kontrolki „Liczba 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 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).

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!

Powrót do początku artykułu

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ś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 typu Liczba rzeczywista i jej właściwości

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

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.

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

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!

Powrót do początku artykułu

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 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ś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 typu Liczba stałoprzecinkowa i jej właściwości

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”

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.

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

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!

Powrót do początku artykułu

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.

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, SQL ERP 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” lub „SQL ERP”, lista pozycji jest inicjowana w oparciu o zapytanie SQL działające na bazie Comarch DMS lub Comarch ERP XL.
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 ERP” oraz na definicji kontrolki „Lista 2” w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytań

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

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 np. sposób dostawy zdefiniowany w bazie systemu Comarch ERP XL.

Została oprogramowana funkcjonalność inicjowania kontrolki domyślnym elementem słownika.

Operator może wskazać domyślny element poprzez zaznaczenie parametru „Prezentuj wartość domyślną” i wskazanie elementu.

Kontrolka Lista i jej właściwości – zaznaczony parametr „Prezentuj wartość domyślną”

Wskazówka

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

select 1, 'abcd’

union

select 2, ‘xyz’

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

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

Separator

Kontrolka typu „Separator” służy do poprawy przejrzystości karty obiegu.

Dodanie tej kontrolki powoduje wstawienie pustego miejsca na karcie obiegu.

Zaznaczenie wartości prezentowania na całej szerokości umożliwia wprowadzenie odstępu jednego wiersza na karcie obiegu.

Na podglądzie karty obiegu kontrolka typu „Separator” prezentowana jest jako prostokąt obramowany przerywaną linią. Kontrolka nie posiada nazwy i innych właściwości.

Kontrolka typu Separator na karcie obiegu

We właściwościach kontrolki typu „Separator” możemy wybrać opcję:

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

Kontrolki typu Separator na definicji obiegu „Faktury sprzedaży” – gdy te oraz sąsiadujące kontrolki mają zaznaczoną opcję „Ustaw kontrolkę na początku wiersza”

Widok dokumentu w ramach obiegu „Faktury sprzedaży” – za pomocą strzałek wskazano miejsca, w których znajdują się separatory

Kontrolki typu Separator na definicji obiegu „Faktury zakupu 2” – gdy te oraz sąsiadujące kontrolki nie mają zaznaczonej opcji „Ustaw kontrolkę na początku wiersza”

Widok dokumentu w ramach obiegu „Faktury zakupu 2” – za pomocą strzałek wskazano miejsca, w których znajdują się separatory

Kontrolki typu Separator na definicji obiegu „Faktury sprzedaży” – gdy mają zaznaczoną opcję „Prezentuj na całej szerokości”

Widok dokumentu w ramach obiegu „Faktury sprzedaży” – separatory oddzielają na szerokość wiersza kontrolki „Numer dokumentu”, „Data wystawienia” i „Załącznik”

Tekst

Kontrolka typu „Tekst” służy do wprowadzania dowolnych informacji zawartych na dokumencie, jak na przykład sposób dostawy, tytuł faktury, nazwa towaru, a także komentarzy lub uwag do 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.
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”.
Max długość – określa maksymalną długość wprowadzanego tekstu – max 900 znaków.
Tekst wielolinijkowy – określa liczbę wierszy wyświetlanego pola tekstowego. Dopuszczalna liczba to 100 linijek.
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 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.

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 „Tekst 1” w polu „Inicjowanie” wybrano opcję „SQL ERP” oraz na definicji kontrolki „Tekst 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” 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 tekst (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 tekst (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.

Przyklad

Przykład inicjowania kontrolki typu „Tekst” za pomocą zapytania SQL:

Administrator chce, aby na każdym nowym dokumencie w kontrolce typu tekst o nazwie „Ulica” domyślnie był wyświetlany tekst „ul.”. W tym celu we właściwościach kontrolki w polu „Inicjowanie” ustawia „SQLOD”, klika „ustaw” i wpisuje następujące zapytanie:

 select 'ul.'

Inicjowanie kontrolki typu tekst o nazwie „Ulica” za pomocą zapytania SQL

Następnie przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Ulica” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

Zaznaczanie etapu, na którym ma nastąpić inicjalizacja kontrolki „Ulica”

Przykład inicjowania kontrolki typu „Tekst” za pomocą kodu C#:

Administrator chce, aby na każdym nowym dokumencie w kontrolce typu tekst o nazwie „Ulica” domyślnie był wyświetlany tekst „ul.”. W tym celu we właściwościach kontrolki w polu „Inicjowanie” ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie:

 Globals.MainFrame.ulica.Text="ul."

Inicjowanie kontrolki typu tekst o nazwie „Ulica” za pomocą kodu C#

Następnie administrator klika w ramach okna na ikonkę [Kompiluj i zapisz], a potem, po zamknięciu okna, przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Ulica” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

Kontrolka „Uiica” na nowym dokumencie

Zarówno w przypadku zainicjowania kontrolki za pomocą zapytania SQL, jak i za pomocą kodu C#, od tej pory na każdym nowoutworzonym dokumencie w kontrolce „Ulica” automatycznie wyświetlany jest tekst „ul.” – operator może dopisać tekst lub, w razie potrzeby, zmienić tekst „ul.” na inny.

Nowy dokument – w kontrolce „Ulica” automatycznie wprowadzony został tekst „ul.”

Sekcja Zmiana wartości (Obserwator)

W ramach tej sekcji znajdują się następujące pola:

Kontrolki powiązane – kontrolka prezentująca listę kontrolek powiązanych, 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, SQL ERP lub C# Script .

Przyklad

Administrator dodał w definicji typu obiegu następujące kontrolki typu Tekst:

Imię (identyfikator: imie)
Nazwisko (identyfikator: nazwisko)
Ulica (identyfikator: ulica)
Numer mieszkania (identyfikator: numer_mieszkania)
Kod pocztowy (identyfikator: Kod)
Miasto (identyfikator: miasto)
Dane osobowe (łącznie) (identyfikator: Dane)

Administrator chce, aby w kontrolce Dane osobowe (łącznie) wyświetlone zostały dane z wszystkich pozostałych wymienionych kontrolek typu tekst.

W tym celu we właściwościach kontrolki Dane osobowe (łącznie) w polu Kontrolki powiązane klika w link Dodaj i kolejno wybiera kontrolki Imię, Nazwisko, Ulica, Numer mieszkania, Kod pocztowy i Miasto.

Wersja z zastosowaniem zapytania SQL

Następnie w polu „Wzór na wartość” administrator ustawia „SQLOD”, klika „Ustaw” i wpisuje następujące zapytanie (gdzie parametr @nowaLinia odpowiada za umiejscowienie następującego po nim fragmentu tekstu w nowej linijce, a ’ ’ to odstęp między kolejnymi wartościami kontrolek):

declare @nowaLinia varchar(max) = char(13) + char(10)

select  @imie@  + ' ' +  @nazwisko@ + @nowaLinia
+ @ulica@ + ' '+  @numer_mieszkania@ + @nowaLinia
+  @Kod@ + ' '+  @miasto@

Wprowadzanie zapytania SQL w kontrolce „*Dane osobowe (łącznie)”*

Następnie administrator zapisuje typ obiegu.

Od tej pory kiedy operator uzupełni kontrolki tekstowe Imię, Nazwisko, Ulica, Numer mieszkania, Kod pocztowy i Miasto, wtedy wszystkie ich wartości zostaną zapisane w kontrolce Dane osobowe (łącznie).

Kontrolka „Dane osobowe (łącznie)” uzupełniona wartościami z pozostałych kontrolek typu Tekst

Wersja z zastosowaniem kodu C#

Ten sam cel można osiągnąć za pomocą kodu C# – wówczas (po dodaniu kontrolek powiązanych) w polu „Wzór na wartość” administrator ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie (gdzie parametr Environment.NewLine odpowiada za umiejscowienie następującego po nim fragmentu tekstu w nowej linijce, a ’ ’ to odstęp między kolejnymi wartościami kontrolek):

Globals.MainFrame.dane.Text= Globals.MainFrame.imie.Text + ' ' 
+ Globals.MainFrame.nazwisko.Text
+ Environment.NewLine + Globals.MainFrame.ulica.Text +' ' 
+ Globals.MainFrame.numer_mieszkania.Text
+ Environment.NewLine + Globals.MainFrame.Kod.Text + ' ' 
+ Globals.MainFrame.miasto.Text

Wprowadzanie kodu C# w kontrolce „*Dane osobowe (łącznie)”*

Następnie administrator klika w ramach okna na ikonkę [Kompiluj i zapisz], a potem po zamknięciu okna zapisuje typ obiegu.

Od tej pory kiedy operator uzupełni kontrolki tekstowe Imię, Nazwisko, Ulica, Numer mieszkania, Kod pocztowy i Miasto, wtedy wszystkie ich wartości zostaną zapisane w kontrolce Dane osobowe (łącznie).

Towar

Kontrolka typu „Towar” umożliwia wczytywanie towaru z listy towaró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ć 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 – właściwość kontrolek elektronicznych dostępna tylko podczas pracy z funkcjonalnością Wielofirmowość. Prezentuje listę spółek zdefiniowanych na zakładce Połączenia z ERP.
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.

W sekcji „Podgląd karty obiegu” po dodaniu tej kontrolki, prezentowany jest przycisk , który otwiera listę towarów z programu Comarch ERP XL.

Przykładowa lista towarów z programu Comarch ERP XL, otwierana po kliknięciu na kontrolkę typu Towar

Gdy towar został już dodany w ramach kontrolki, np. – w kontrolce prezentowane są przyciski [Zmień] wywołujący listę towarów z Comarch ERP XL oraz [Odepnij] który usunie wskazanie na kartotekę towarową.

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”
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 „Towar 1” w polu „Inicjowanie” wybrano opcję „SQL OD” oraz na definicji kontrolki „Towar 2” w polu „Inicjowanie” wybrano opcję „SQL ERP”, ale nie wprowadzono zapytań

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

Przyklad

Administrator chce, aby w danym obiegu zawsze na nowoutworzonym dokumencie w kontrolce typu Towar wybrany był określony towar.

Baza Comarch ERP XL, z której korzysta administrator, nosi nazwę ERPXL_FirmaA.

Przykład inicjowania kontrolki typu „Towar” za pomocą zapytania SQL:

Administrator w ramach właściwości kontrolki typu Towar o nazwie „Towar” w polu „Inicjowanie” ustawia „SQLOD”, klika „Ustaw” i wpisuje następujące zapytanie:

select top 2 Twr_GIDNumer 
from ERPXL_FirmaA.cdn.TwrKarty

gdzie „ERPXL_FirmaA” to nazwa bazy Comarch ERP XL

Inicjowanie kontrolki typu towar o nazwie „Towar” za pomocą zapytania SQL

Następnie przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Towar” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

Zaznaczanie etapu, na którym ma nastąpić inicjalizacja kontrolki „Towar”

Przykład inicjowania kontrolki typu „Towar” za pomocą kodu C#

Administrator we właściwościach kontrolki w polu „Inicjowanie” ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie:

 Globals.MainFrame.Towar.Id = 2

Inicjowanie kontrolki typu towar o nazwie „Towar” za pomocą kodu C#

Następnie administrator klika w ramach okna na ikonkę [Kompiluj i zapisz], a potem, po zamknięciu okna, przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Towar” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

Kontrolka „Towar” na nowym dokumencie

Zarówno w przypadku zainicjowania kontrolki za pomocą zapytania SQL, jak i za pomocą kodu C#, od tej pory na każdym nowoutworzonym dokumencie w kontrolce „Towar” automatycznie wyświetlany towar, którego Twr_GIDNumer = 2 – choć w razie potrzeby operator może na danym dokumencie zmienić towar na inny.

Nowy dokument – w kontrolce „Towar” automatycznie dodany został „Towar 2”

Zmiana wartości (Obserwator)

W ramach tej sekcji znajdują się następujące pola:

Kontrolki powiązane – kontrolka prezentująca listę kontrolek powiązanych, 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, SQL ERP lub C# Script .

URL

Kontrolka typu „URL” służy do prezentacji linku strony WWW.

Wskazówka

Od wersji 2023.1.0 istnieje możliwość obserwowania kontrolki typu URL przez inne kontrolki (zob. przykład Obserwacja kontrolki typu URL przez inne kontrolki).

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

Na dokumencie Comarch DMS, kontrolka ta umożliwia wprowadzenie adresu strony WWW oraz jego zaprezentowanie na karcie obiegu.

Po przyciśnięciu wprowadzonego linku, aplikacja podnosi stronę w przeglądarce internetowej. Na karcie obiegu może być użyta kilkukrotnie.

Wartość w kontrolce dodawana jest poprzez przycisk [Dodaj] .

Prezentowana jest nazwa linku, a nie adres strony WWW.

Zmiana wartości dokonywana jest za pomocą przycisku [Zmień]. Link usunąć można za pomocą przycisku [Usuń].

Dodawanie adresu URL na danym dokumencie

Istnieje możliwość ustawienia dla danego obiegu stałego adresu URL, który będzie automatycznie pojawiał się w ramach kontrolki typu URL po zapisaniu dokumentu. W tym celu należy zastosować procedurę do.OnAfterDocumentSave.

Przyklad

Przykład ustawienia automatycznie wyświetlanego adresu URL w ramach danego typu obiegu dokumentów

Admiistrator w ramach typu obiegu o nazwie „Faktury” dodaje kontrolkę URL o nazwie „Link do strony pomocy” (identyfikator: „Url1”).

Po wybraniu przycisku [Zmień] w polu „Nazwa linku” wpisuje Strona pomocy Comarch DMS, a w polu „Adres” https://pomoc.comarch.pl/dms/.

Następnie klika w przycisk [Zapisz] , a później zapisuje typ obiegu za pomocą ikony [Zapisz].

Definiowanie kontrolki typu URL w ramach typu obiegu „Faktury”

Następnie w bazie Comarch DMS administrator odnajduje procedurę do.OnAfterDocumentSave (katalog Programmability/Stored Procedures) i po kliknięciu na jej nazwę prawym przyciskiem myszki wybiera „Modify”.

Baza Comarch DMS – wybór opcji „Modify” dla procedury do.OnAfterDocumentSave

Następnie wprowadza następujące zapytanie:

ALTER PROCEDURE [do].[OnAfterDocumentSave]
@DocumentId as int = NULL, -- DWD_ID z tabeli DF_Work
@SavedBy as int = NULL -- DCD_ID z tabeli DF_ConfOSDictionary
AS
If exists(
select * from do.RO_ObjectsTypes t
join do.RO_Documents d on d.DFH_Id=t.DFH_Id
where d.DWD_ID=@DocumentId and t.DFH_Name='Faktury'--nazwa typu obiegu
)

Begin
declare @dkoid INT
select @dkoid=c.DWC_DKOId from do.df_work w
join do.df_WorkCF c on w.DWD_ID= c.DWC_DWDId
join do.DF_ConfCFCardDokFlow f on c.DWC_DKOId=f.DKO_ID
where f.DKO_Name='Url1' and w.DWD_ID=@DocumentId--Nazwa kontrolki URL (identyfikator)

update do.DF_WorkCF set DWC_Number='Strona pomocy Comarch DMS' 
--nazwa wpisana w polu "Nazwa linku"
where DWC_DKOId=@dkoid and DWC_DWDId=@DocumentId

update do.DF_WorkCF set DWC_ValueString= 'https://pomoc.comarch.pl/dms/'
--link wprowadzony w polu "Adres"
where DWC_DKOId=@dkoid and DWC_DWDId=@DocumentId
END

Później administrator naciska przycisk „Execute” i powraca do Comarch DMS.

Na każdym nowym dokumencie po zapisaniu dokumentu w kontrolce „Link do strony pomocy” dostępny jest domyślnie link do strony https://pomoc.comarch.pl/dms/

Wybrany w definicji obiegu odnośnik URL na nowym dokumencie

Wartość logiczna

Kontrolka typu „Wartość logiczna” pozwala na wybranie wartości: Tak/Nie.

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.

Przykładem użycia kontrolki „Wartość logiczna” może być każde pytanie, na które możliwa jest odpowiedź w postaci wartości Tak lub Nie, np. „Czy było zamówienie?”

Kontrolka typu Wartość logiczna i jej właściwości

Przyklad

Przykład wykorzystania kontrolki typu Wartość logiczna do zablokowania przekazania dokumentu do następnego etapu

W ramach typu obiegu „Faktury” dodano kontrolkę typu Wartość logiczna o nazwie „Czy zatwierdzono?” (identyfikator: „Bool1”).

Administrator chce, aby warunkiem koniecznym do przekazania dokumentu z etapu „Rejestracja” do następnego etapu „Dekretacja” był wybór opcji „Tak” w ramach tej kontrolki.

W tym celu administrator wybrał zakładkę „Schemat obiegu”, następnie kliknął na etap „Dekretacja” i w ramach zakładki „Przekazanie” link ” Definiuj warunki”. W otwartym oknie wpisał następujący warunek:

[Bool1] = 1

Następnie zapisał typ obiegu.

Wprowadzanie warunku przekazania dokumentu do następnego etapu

Od tej pory kiedy operator DMS zapisze dokument i nie wybierze wartości w kontrolce „Czy zatwierdzono?” lub wybierze opcję Nie – przekazanie do następnego etapu nie będzie możliwe.

Blokada przekazania dokumentu do następnego etapu z powodu braku wyboru opcji w kontrolce „Czy zatwierdzono?”

Wskazówka

Kolumna typu Wartość logiczna w kontrolce typu Dane tabelaryczne może mieć dodatkowe 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).

Własna akcja

Kontrolka typu „Własna akcja” umożliwia uruchomienie z poziomu karty obiegu:

programu (exe)
procedury SQL
pliku wykonywalnego na serwerze IIS
kodu w języku C#

Na właściwościach tej kontrolki dostępne są 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”.
Plik wykonywalny – użytkownik może uruchomić aplikację typu exe. Aplikacja musi znajdować się na dysku komputera, na którym działa Comarch DMS lub w udostępnionym udziale dyskowym, do którego ma dostęp użytkownik systemu. Ścieżkę do aplikacji należy umieścić w cudzysłowie, np. „c:\windows\system32\calc.exe”.
IIS – pole umożliwia uruchomienie plików wykonywalnych na serwerze IIS.
Procedura – możliwe jest uruchomienie procedury znajdującej się w bazie obiegu. Należy wpisać nazwę procedury.
Procedura ERP – możliwe jest uruchomienie procedury znajdującej się w bazie systemu ERP. Należy wpisać nazwę procedury.
C# Script – istnieje możliwość wywołania procesu zdefiniowanego za pomocą kodu w języku C#.
Nazwa spółki – opcja dostępna w trybie wielospółkowym. Operator może wybrać spółkę z rozwijanej listy.
Potwierdzenie wykonania akcji – użytkownik może zdefiniować własny komunikat, który ma się wyświetlić na szczegółach dokumentu po wykonaniu akcji na przycisku.
Pytaj przed uruchomieniem – jeżeli parametru zostanie zaznaczony, po kliknięciu przycisku „własna akcja” system wyświetli komunikat „Czy uruchomić akcję?”.
Zapisz przed uruchomieniem – zaznaczenie parametru sprawia, że po kliknięciu w przycisk własnej akcji, dokument najpierw jest automatycznie zapisywany, a następnie wykonywane jest polecenie zapisane w konfiguracji kontrolki.

Istnieje możliwość przekazywania parametrów dynamicznych do procedury lub programu skonfigurowanego dla kontrolki „Własna akcja”.

Parametry dynamiczne to nazwy (identyfikatory) kontrolek znajdujących się na karcie obiegu oznaczone znakami „@” na początku i na końcu nazwy.

Wskazówka

Przykład zastosowania pliku wykonywalnego:
plik.exe @Wartość netto@ @Wartość brutto@

Wskazówka

Przykład zastosowania procedury składowanej:
cdn.procedura @Wartość netto@ @Wartość brutto@

Kontrolkę można również zainicjować kodem w języku C#. Dla tej opcji możliwy jest wybór miejsca wykonania skryptu: Serwer IIS lub Proces (exe).

Uwaga

Uruchomienie skryptu na niezależnym procesie exe jest zalecane w przypadku obsługi API, które nie powinno działać na procesach wielowątkowych takich jak proces IIS.

Okno definiowania procedury wywołania kontrolki typu Własna akcja w języku C#

Funkcjonalność obsługuje następujące kontrolki:

Data i godzina
Dokument elektroniczny
Dokument ERP XL
Kontrahent
Liczba rzeczywista
Liczba stałoprzecinkowa
Liczba całkowita
Lista
Tekst
Towar
Wartość logiczna

Kontrolka typu Własna akcja i jej właściwości

Uruchamianie plików wykonywalnych na serwerze IIS

Funkcjonalność dotyczy stacjonarnej wersji aplikacji Comarch DMS. Umożliwia operatorom uruchamianie tego samego pliku *.exe umieszczonego bezpośrednio na serwerze IIS.

Przygotowany plik *.exe, należy umieścić w katalogu \bin\exe w folderze, w którym zainstalowano aplikację webową. Konfigurując kontrolkę ‘Własna akcja’ należy w polu IIS wprowadzić nazwę i ścieżkę do pliku, który wywoła przygotowaną aplikację.
Nazwę i ścieżkę do pliku należy wprowadzić w cudzysłowie.

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji „IIS”

Uruchamianie plików wykonywalnych

Przyklad

Przykład pokazuje definiowanie kontrolki typu Własna akcja jako plik wykonywalny w taki sposób, aby wywoływany był kalkulator systemu Windows.

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji 'Plik wykonywalny’, tak, aby na karcie obiegu wywoływany był kalkulator

Po takim zdefiniowaniu kontrolki oraz zapisaniu zmian i typu obiegu po kliknięciu na nowym dokumencie kontrolki „Akcja” zostanie wywołany kalkulator.

Wywoływanie kalkulatora za pomocą kontrolki „Akcja”

Przyklad

Przykład pokazuje definiowanie kontrolki typu Własna akcja jako plik wykonywalny w taki sposób, aby wywoływany był notatnik.

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji 'Plik wykonywalny’, tak, aby na karcie obiegu wywoływany był notatnik

Po takim zdefiniowaniu kontrolki oraz zapisaniu zmian i typu obiegu po kliknięciu na nowym dokumencie kontrolki „Akcja” zostanie wywołany notatnik.

Wywoływanie notatnika za pomocą kontrolki „Akcja”

Uruchomienie procedury z bazy Comarch DMS

Aby uruchomić procedurę z bazy Comarch DMS, należy wybrać opcję „Procedura” i w otwartym oknie wpisać zapytanie według następującego wzoru:

exec nazwaprocedury
@pierwszy parametr z procedury = @identyfikator_kontrolki@,
@drugi parametr z procedury = @identyfikator_drugiej_kontrolki@,

itd.

Przyklad

Administrator dodał cztery kontrolki:

kontrolka typu tekst o nazwie „Nazwa działu” (identyfikator: Nazwa_dzialu)
kontrolka typu tekst o nazwie „Nazwa działu 2” (identyfikator: Nazwa_dzialu2)
kontrolka typu liczba całkowita o nazwie „Id spółki” (identyfikator: Id)
kontrolkę typu Własna akcja o nazwie „Dodaj nowy dział” (identyfikator: Akcja)

Administrator chce, aby po wpisaniu danych do kontrolek „Nazwa działu”, „Nazwa działu 2” i „Id spółki”, a następnie kliknięciu w przycisk „Dodaj nowy dział” został dodany nowy dział w zakładce „Działy” w strukturze organizacyjnej wybranej spółki w Comarch DMS.

W tym celu wybrał procedurę do.AddDepartment, w której potrzebne są trzy parametry: @Name1 (varchar), @Name2 (varchar) i @CompanyId (int), jak jest widoczne na poniższej ilustracji.

Widok procedury do.AddDepartment w bazie Comarch DMS – zaznaczono potrzebne parametry

Po utworzeniu wspomnianych czterech kontrolek administrator we właściwościach kontrolki „Dodaj nowy dział” klika w link „Ustaw” w polu „Procedura” i w otwartym oknie wprowadza nastepujące zapytanie:

exec do.AddDepartment
@Name1 = @Nazwa_dzialu@, 
@Name2 = @nazwa_dzialu2@,
@CompanyId = @Id@

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji 'Procedura’, tak, aby z poziomu dokumentu można było dodać nowy dział w strukturze organizacyjnej spółki w Comarch DMS

Administrator zapisuje okno i typ obiegu. Od tej pory, kiedy operator DMS wpisze wartości w kontrolkach „Nazwa działu”, „Nazwa działu 2” i „Id spółki”, a później kliknie w przycisk „Dodaj nowy dział” – zostanie dodany nowy dział w zakładce „Działy” w strukturze organizacyjnej wybranej spółki w Comarch DMS

W konfiguracji kontrolki możliwe jest włączenie komunikatu z pytaniem, czy uruchomić daną akcję – w tym celu należy zaznaczyć checkbox w polu „Pytaj przed uruchomieniem”. Pytanie wyświetlane jest po kliknięciu na karcie dokumentu w przycisk wywołujący zdefiniowaną akcję.

Komunikat wyświetlany użytkownikowi, gdy na kontrolce zaznaczono parametr „Pytaj przed uruchomieniem”

W konfiguracji kontrolki można również włączyć opcję wyświetlania określonego komunikatu po wykonaniu akcji – w tym celu należy zaznaczyć checkbox w polu „Potwierdzenie wykonania akcji” i wpisać treść komunikatu w pustym polu poniżej. Wówczas po kliknięciu w przycisk akcji i po jej wykonaniu zostanie wyświetlony komunikat o określonej treści.