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 wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „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.
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?
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”.
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 wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „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 parametruoznacza, ż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.
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?
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”
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 wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „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 parametruoznacza, ż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 tylkodla współpracy z Comarch ERP XL.
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Na 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 wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „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
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
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”.
Właściwości kontrolki typu Separator
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.
Kontrolka typu Tekst 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 wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „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.
Zaznaczanie etapu, na którym ma nastąpić inicjalizacja kontrolki „Ulica”
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, Numermieszkania, 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):
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, Numermieszkania, 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):
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, Numermieszkania, 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.
Kontrolka typu Towar i jej właściwości
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 wprowadzizapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.
W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak”albo wprowadzić brakujące zapytanie.
W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu„Inicjowanie” tej kontrolki.
Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „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.
Parametr „Inicjuj przy każdym otwarciu dokumentu”
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.
Zaznaczanie etapu, na którym ma nastąpić inicjalizacja kontrolki „Towar”
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.
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”.
Kontrolka typu URL i jej właściwości
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
Adres URL dodany 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.
Kontrolka typu Wartość logiczna na dokumencie
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?”
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:
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.
Włączanie opcji „Potwierdzenie wykonania akcji” i „Pytaj przed uruchomieniem”