Liczba całkowita

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.

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

Inicjowanie wartości

Pole Inicjowanie 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 w języku C#, który będzie inicjował wartości w kontrolce.
Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQL OD 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.

Liczba rzeczywista

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.

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

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak lub SQL OD.

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

W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu w języku C#, który będzie inicjował wartości w kontrolce.
Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQL OD 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.

Formatka Zapytanie SQL wspólna dla wszystkich kontrolek opartych o zapytanie SQL

Liczba stałoprzecinkowa

Kontrolka typu „Liczba stałoprzecinkowa” umożliwia wprowadzenie do aplikacji wartości, które wymagają precyzji z dokładnością do dwóch miejsc po przecinku, np. ceny.

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.

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

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak lub SQL OD.

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”

W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu w języku C#, który będzie inicjował wartości w kontrolce.
Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQL OD 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..

Lista

Kontrolka typu „Lista” umożliwia wybór jednej pozycji z rozwijalnej listy wartości 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”.
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.

Dostępna jest opcja definiowania nowej wartości i ikonka usunięcia jej 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.
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.

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

Właściwości kontrolki typu Lista, parametr trybu pracy kontrolki: Szukaj po dowolnym ciągu znaków.

W przypadku, gdy tryb pracy kontrolki zostanie ustawiony na Lista, parametr jest niedostępny.

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

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.

Wskazówka

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

select 1, 'abcd’

union

select 2, ‘xyz’

Separator

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

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 separator na karcie obiegu

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”.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD 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.
Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie 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.

Wskazówka

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

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

Inicjowanie wartości

Pole Inicjowanie 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”
W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu w języku C#, który będzie inicjował wartości w kontrolce.
Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQL OD 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.
.

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

URL

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

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

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 Wartość logiczna i jej właściwości

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 kontrolek znajdujących się na karcie obiegu oznaczone znakami „@” na początku i na końcu nazwy.

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

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@

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

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.

Kontrolka typu Własna akcja wywołująca na karcie obiegu kalkulator

W konfiguracji kontrolki możliwe jest włączenie komunikatu z pytaniem, czy uruchomić daną akcję, pytanie wyświetlane jest po kliknięciu w przycisk wywołujący zdefiniowaną akcję.

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