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 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 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.
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 Enterprise.
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
Gdy parametr „Prezentuj wartość domyślną” pozostanie odznaczony, wówczas na karcie obiegu w kontrolce domyślnie będzie wyświetlana pusta wartość (1), po rozwinięciu listy zostaną wyświetlone zdefiniowane wartości. Zaznaczenie parametru spowoduje, że domyślnie w kontrolce będzie wyświetlana zaznaczona wartość (2).
Wygląd listy, gdy parametr „Prezentuj wartość domyślną” nie jest zaznaczony
Wygląd listy, gdy parametr „Prezentuj wartość domyślną” jest zaznaczony
Parametr „Inicjuj przy każdym otwarciu dokumentu”
Wskazówka
Przykład zapytania SQL dla kontrolki typu “Lista”:
select 1, 'abcd’
union
select 2, ‘xyz’
Rodzaj identyfikatora – pole umożliwia operatorowi określenie rodzaju identyfikatorów kolejnych pozycji na liście. Przyjmuje wartości:
Int – gdy identyfikatory kolejnych pozycji na liście określone są liczbą. Dla metody inicjowania listy słownikiem, rodzaj identyfikatora to zawsze int.
Text – gdy identyfikatory kolejnych pozycji na liście określone są wartością tekstową (np. GUID).
W przypadku, gdy w kontrolce lista określono rodzaj identyfikatora jako int, w edytorze zapytań SQL w mechanizmach inicjowania i obserwowania wyświetlane będą parametry:
<identyfikator_kontrolki_typu_lista>_Id
<identyfikator_kontrolki_typu_lista>_Text
W przypadku, gdy w kontrolce lista określono rodzaj identyfikatora jako text, w edytorze zapytań SQL w mechanizmach inicjowania i obserwowania wyświetlane będą parametry:
<identyfikator_kontrolki_typu_lista>_IdText
<identyfikator_kontrolki_typu_lista>_Text
Pole Tryb pracy przyjmuje wartości:
Lista – wypełnia kontrolkę pełną listą pozycji zdefiniowanych w oparciu o zapytanie SQL.
Właściwości kontrolki typu Lista, tryb pracy „Lista”
Kontrolka typu Lista przy ustawieniu „Tryb pracy: Lista”
Wyszukiwanie – inicjuje kontrolkę listą pozycji spełniających kryteria wyszukiwania wprowadzone przez operatora. W trybie pracy Wyszukiwanie umożliwiono szukanie wartości po dowolnym ciągu znaków. Taki tryb pracy uzależniony jest od wartości parametru ‘Szukaj po dowolnym ciągu znaków’. Jeżeli parametr jest wyłączony, wówczas wyszukiwanie odbywa się po początkowych znakach danej wartości. W przypadku, gdy tryb pracy kontrolki zostanie ustawiony na Lista, parametr jest niedostępny.
Właściwości kontrolki typu Lista, tryb pracy „Wyszukiwanie”, zaznaczony parametr trybu pracy kontrolki: „Szukaj po dowolnym ciągu znaków”
Kontrolka typu lista, zawężanie wartości do dowolnego ciągu znaków
Właściwości kontrolki typu Lista, tryb pracy „Wyszukiwanie”, odznaczony parametr trybu pracy kontrolki: „Szukaj po dowolnym ciągu znaków”
Kontrolka typu lista, wyszukiwanie według frazy początkowej
Kontrolka typu „Lista” może być wykorzystywana, jako kontrolka, z której użytkownik wybiera na karcie obiegu zdefiniowane wartości z konfiguracji kontrolki np. formy płatności. Jeżeli w konfiguracji tej kontrolki wprowadzone jest zapytanie SQL-owe, można na jego podstawie z bazy pobrać konkretną listę wartości, którą aplikacja automatycznie wprowadzi do pola kontrolki.
Przyklad
Na bazie Comarch DMS utworzono dodatkową tabelę (do.wdrKontrahenci), w której przechowywane będą dane kontrahentów:
Na definicji typu obiegu dodano kontrolkę typu lista:
Wartości w kontrolce typu lista będą inicjowane zapytaniem SQL:
Na podstawie zapytania w kontrolce Kontrahent na karcie obiegu dostępna będzie lista wszystkich kontrahentów znajdujących się w tabeli:
Kontrolka typu „Lista” na Karcie obiegu wypełniana jest wartością domyślną, jeżeli w danym etapie dla tej kontrolki nie została zapisana wartość. Operator może edytować i zmieniać domyślną wartość na dokumencie. Wprowadzona wartość zostanie zapisana i zapamiętana.
Dla kontrolek typu lista została oprogramowana możliwość ponownego inicjowania wartości na kolejnych etapach. Jeżeli dla kontrolki została zaznaczona (na kilku etapach) właściwość „Inicjalizacja SQL” to na każdym etapie kontrolka zostanie zainicjonowana ponownie wartością domyślną.
Umożliwiono odwołanie się do nazwy oraz pozycji wybranego elementu w kontrolce typu „Lista”.
Kontrolka Lista i jej właściwości
Przyklad
Administrator chce, aby można było w prosty sposób dodać do kontrolki typu Dokumenty w obiegu dokumenty pochodzące z różnych typów obiegów w Comarch DMS.
W tym celu dodaje 3 kontrolki:
kontrolkę typu Lista o nazwie „Typ obiegu” (identyfikator: Typ_obiegu)
kontrolkę typu Lista o nazwie ” Dokumenty wybranego obiegu” (identyfikator: wybrany_obieg), która obserwuje kontrolkę „Typ obiegu”
kontrolkę typu Dokumenty w obiegu o nazwie „Dowiązane dokumenty” (identyfikator: Dowiazane), która obserwuje kontrolkę ” Dokumenty wybranego obiegu”
Następnie we właściwościach kontrolki „Typ obiegu” w polu „Inicjowanie” wybiera „SQL OD” i klika w link „Ustaw”. W ramach otwartego okna wpisuje następujące zapytanie:
select DFH_Id, DFH_Name from do.RO_ObjectsTypes
where DFH_Archives = 0
Inicjowanie kontrolki „Typ obiegu”
Później administrator we właściwościach kontrolki „Dokumenty wybranego obiegu” w polu „Inicjowanie” wybiera „SQL OD” i klika w link „Ustaw”. W ramach otwartego okna wpisuje następujące zapytanie:
select dwd_id, DWD_FullNumber
from do.RO_Documents
where DFH_Id = @Typ_obiegu_Id@
Wprowadzanie zapytania w kontrolce „Dokumenty wybranego obiegu” – konieczne jest, aby w ramach pola „Kontrolki powiązane” została dodana kontrolka „Typ obiegu”
Potem zaś administrator we właściwościach kontrolki „Dowiązane dokumenty” w polu „Wzór na wartość” wybiera „SQL OD” i klika w link „Ustaw”. W ramach otwartego okna wpisuje następujące zapytanie:
select @wybrany_obieg_Id@
Wprowadzanie zapytania w kontrolce „Dowiązane dokumenty” – konieczne jest, aby w ramach pola „Kontrolki powiązane” została dodana kontrolka „Dokumenty wybranego obiegu”
Następnie administrator zapisuje zmiany.
Od tej pory operator na nowym dokumencie może wybrać typ obiegu dokumentów w kontrolce „Typ obiegu”, a następnie w kontrolce „Dokumenty wybranego obiegu” – numery dokumentów z tego typu obiegu – wówczas wybrane dokumenty zostaną dodane do kontrolki ” Dowiązane dokumenty”. Możliwe jest wybranie kolejno różnych dokumentów z różnych typów obiegu.
Kontrolka „Typ obiegu” – kontrolka typu Lista
Kontrolka „Dokumenty wybranego obiegu” – kontrolka typu Lista
Dodawanie dokumentów do kontrolki typu Dokumenty w obiegu za pomocą kontrolek typu Lista
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”
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.”
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).
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 na karcie obiegu dodawana jest poprzez przycisk [Dodaj].
Prezentowana jest nazwa linku, a nie adres strony WWW.
Zmiana wartości dokonywana jest za pomocą przycisku [Zmień]. Link można usunąć 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
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 „Towar” umożliwia wczytywanie towaru z listy towarów zdefiniowanych w programie Comarch ERP Enterprise.
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 Enterprise. W ramach wyszukiwarki należy wpisać nazwę towaru, jego akronim lub ich fragment.
Przykładowa lista towarów z programu Comarch ERP Enterprise, otwierana po kliknięciu na kontrolkę typu Towar i wyszukaniu słowa „rower”
Gdy towar został już dodany w ramach kontrolki, np. – w kontrolce prezentowane są przyciski [Zmień] wywołujący listę towarów z Comarch ERP Enterprise 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.
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 = 4
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
Od tej pory na każdym nowoutworzonym dokumencie w kontrolce „Towar” automatycznie wyświetlany towar, którego Id = 4 – choć w razie potrzeby operator może na danym dokumencie zmienić towar na inny.
Nowy dokument – w kontrolce „Towar” automatycznie dodany został towar „Książka”
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 .
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
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ę, 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”
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”
Kontrolka „Właściciel” umożliwia zmianę właściciela dokumentu.
Właścicielem dokumentu domyślnie jest osoba tworząca dokument.
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 typu Właściciel i jej właściwości
Funkcjonalność właściciela dokumentu wprowadzona została w aplikacji na potrzeby funkcjonalności stanowisk powiązanych ze strukturą organizacyjną.
Operator, który jest właścicielem dokumentu jest zarazem punktem odniesienia w strukturze organizacyjnej, od którego należy zacząć wyszukiwanie najbliższego przełożonego, posiadającego określone uprawnienie typu Stanowisko powiązane ze strukturą organizacyjną, np. Kierownik (zob. Stanowisko powiązane ze strukturą).
Właścicielem dokumentu staje się domyślnie operator, który utworzył dokument. Istnieją dwa sposoby na zmianę właściciela dokumentu:
Zmiana poprzez kontrolkę „Właściciel” – właściciela dokumentu można zmienić ręcznie na każdym etapie zmieniając operatora w kontrolce typu „Właściciel” (warunek: kontrolka nie podlega w danym etapie właściwościom Tylko do odczytu i jest widoczna). Aby zmienić operatora, należy wpisać odpowiednią frazę w kontrolce i wybrać operatora z wyświetlanej listy.
Zmiana operatora w kontrolce typu Właściciel
W ramach kontrolki typu Właściciel na karcie danego dokumentu po wpisaniu frazy można wybrać z listy jednego z pracowników lub działów, które zdefiniowano w zakładce „Struktura organizacyjna” (zob. Informacje ogólne). Przy nazwiskach pracowników widoczne jest oznaczenie (P), zaś przy nazwach działów (D). W przypadku pracy w trybie wielospółkowym w nawiasach kwadratowych obok oznaczenia (P) lub (D) znajduje się skrót nazwy spółki.
Lista wyświetlana w kontrolce typu Właściciel – widoczne oznaczenia (P) (pracownik) i (D) (dział)
Automatyczna zmiana właściciela dokumentu – właściciel dokumentu może zostać zmieniony automatycznie podczas przekazywania dokumentu do etapu, na którym została ustawiona właściwość „Automatyczna zmiana właściciela dokumentu”. Musi być tu spełniony jeden warunek – dostęp do dokumentu na tym etapie może posiadać tylko jeden operator. Takie uprawnienie można ustawić w konfiguracji typu obiegu (uprawnienia statyczne) lub wybrać na szczegółach dokumentu podczas przekazywania dokumentu (uprawnienia dynamiczne). Jeśli parametr „Automatyczna zmiana właściciela dokumentu” został zaznaczony, a na szczegółach dokumentu podczas przekazywania dokumentu dodano więcej niż jednego operatora uprawnionego do dokumentu w następnym etapie, wówczas przekazanie dokumentu nie jest możliwe i wyświetlany jest komunikat informujący o przyczynie problemu z przekazaniem.
Ustawianie automatycznej zmiany właściciela dokumentu dla danego etapu
Komunikat wyświetlany przy próbie przekazania dokumentu do następnego etapu, gdy jest do niego uprawniony więcej niż jeden operator, a parametr „Automatyczna zmiana właściciela dokumentu” jest zaznaczony
Jeżeli na typie obiegu zostanie zdefiniowana kontrolka „Właściciel”, to nie można na żadnym etapie tego typu obiegu zaznaczyć właściwości „Automatyczna zmiana właściciela dokumentu” i odwrotnie. Błędna konfiguracja typu obiegu skutkuje komunikatem ostrzegawczym przy próbie zapisu:
Komunikat wyświetlany przy próbie zapisu typu obiegu, gdy konfiguracja typu obiegu jest niezgodna z wymaganiami kontrolki typu Właściciel
Uwaga
Dla funkcjonalności właściciela dokumentu nie ma możliwości zdefiniowania w jednym typie obiegu: kontrolki typu “Właściciel” na karcie obiegu oraz aktywowania parametru “Automatyczna zmiana właściciela dokumentu”, znajdującego się na właściwościach któregokolwiek etapu.
Jeżeli operator inicjujący nie wskaże w kontrolce typu „Właściciel” (na karcie obiegu) innego operatora to, po zapisie zmian wprowadzonych na dokumencie lub po przekazaniu do kolejnego etapu, aplikacja wstawi domyślnego operatora (w tym wypadku inicjującego dokument).
Właściwości kontrolki typu Załącznik są podzielone na dwie sekcje:
Ogólne
Archiwa
W ramach sekcji „Ogólne” 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.
Podpisy elektroniczne PDF – checkbox dodany w wersji 2023.0.0; po jego zaznaczeniu przy załącznikach formacie PDF dostępny jest przycisk do podpisywania dokumentów (zob. Podpisy elektroniczne dokumentów PDF).
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”.
Wersjonowanie pliku – opcja „Tak” umożliwia podpięcie kilku wersji tego samego pliku o takiej samej nazwie pod jedną kontrolkę. Każdy nowo dodany plik zawiera na końcu nazwy kolejny numer wersji podany w nawiasach. Domyślną opcją jest „Nie”.
Zakładka typu Załącznik, sekcja „Ogólne”
W ramach sekcji „Archiwa” dostępne są następujące pola:
Manager dokumentów – umożliwia załączanie plików umieszczonych w managerze dokumentów albo „Współpraca z Repozytorium” – jeśli współpraca z Repozytorium jest włączona.
Nazwa spółki – parametr dostepny w trybie wielospółkowym, w parametrze należy wskazać spółkę, w której będą zapisywane załączniki.
Lokalizacja – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; lokalizacja w Repozytorium, do której powinny być przesyłane pliki
Podczas zapisu załącznika w Repozytorium stosuj – jedno z dwóch pól dostępnych od 2024.2.0 zamiast pola ‘Zastosuj login operatora Repozytorium’; pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; w tym polu należy wybrać operatora, w którego imieniu załączniki będą zapisywane w Repozytorium.
Podczas pracy z załącznikiem z Repozytorium stosuj – jedno z dwóch pól dostępnych od 2024.2.0 zamiast pola ‘Zastosuj login operatora Repozytorium’; pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; w tym polu należy wybrać operatora, w którego imieniu będzie odbywać się praca z załącznikami w Repozytorium.
przycisk ‘Dodaj’ w sekcji ” Ustawienia typów dokumentów” – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; pod napisem ‘Typy’ powinny zostać wybrane takie właściwości jak:
typ dokumentów, który będzie przypisywany do przesłanych plików, a także określony typ domyślny
po kliknięciu „Dodaj”, a następnie wyborze konkretnych atrybutów i kliknięciu „Ustaw” – kontrolki DMS, które zostaną zmapowane do atrybutów
Etap mapowania – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; etap obiegu dokumentu, na którym wartości kontrolek zostaną zmapowane do atrybutów, a także typ dokumentu będzie zmapowany na plik przesłany do Repozytorium
„Brak spółki – baza OD” – załączniki są zapisywane do bazy Comarch DMS,
„Brak spółki – IBARD” – załączniki są zapisywane w usłudze Comarch IBARD.
Wartość “Brak spółki” dla kontrolki typu Załącznik
Kontrolka typu Załącznik, sekcja „Archiwa” – gdy włączona jest współpraca z Managerem dokumentów
Kontrolka typu Załącznik, sekcja „Archiwa”, gdy włączono współpracę z modułem Repozytorium – przykład
Obok nazwy załączonego pliku prezentowana jest:
w przypadku załącznika dodanego z dysku lub ze skanu:
ikona podpisu elektronicznego (jeśli w ustawieniach kontrolki typu załącznik zaznaczono parametr „Podpis elektroniczny PDF i jeśli dodany załącznik jest w formacie PDF)
ikona zapisu załącznika (umożliwia zapisanie pliku na dysk lokalny)
ikona kosza (umożliwia odpięcie pliku od dokumentu). Ikona kosza jest nieaktywna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”.
w przypadku załącznika dodanego z modułu Repozytorium:
ikona podpisu elektronicznego (po zapisaniu dokumentu w Comarch DMS – jeśli w ustawieniach kontrolki typu załącznik zaznaczono parametr „Podpis elektroniczny PDF i jeśli dodany załącznik jest w formacie PDF)
ikona zapisu załącznika (umożliwia zapisanie pliku na dysk lokalny)
ikona kosza (umożliwia odpięcie pliku od dokumentu). Ikona kosza jest nieaktywna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”
ikona zmiany typu dokumentu (umożliwia zmianę typu dokumentu w Repozytorium na jeden z dostępnych w ustawieniach danej kontrolki typu załącznik. Ikona jest niewidoczna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”.
Dwie kontrolki typu załącznik na nowym dokumencie w Comarch DMS – do kontrolki „Załącznik” dodano plik PDF i graficzny z dysku, a do kontrolki „Załącznik 2” – z Repozytorium
W pliku Web.config znajduje się klucz: <add key=”DestinationAttachmentsWorkflow” value=”” />.
Wartość klucza definiuje bazę, w której będą przechowywane załączniki dodawane do dokumentów.
Klucz <add key=”DestinationAttachmentsWorkflow” value=”” /> przyjmuje wartości:
„DO” – baza danych DMS,
„XL” – baza danych ERP XL,
„IBARD” – usługa IBARD.
Załączniki z Managera dokumentów
Załączanie plików przechowywanych w managerze dokumentów dostępne jest dla pracowników posiadających uprawnienie do pracy z modułem Manager dokumentów (zob. Dostęp do modułu Manager dokumentów), w tych typach obiegów, w których na kontrolce typu Załącznik zaznaczono parametr „Manager dokumentów”.
Możliwe jest przesyłanie załączników z managera dokumentów na dysk lokalny. Lokalizację przechowywania plików przesłanych do managera dokumentów określa klucz:
<add key=”DestinationAttachmentsRepository” value=”DO” />. Przyjmuje wartości:
„DO” – baza danych DMS
„IBARD” – usługa IBARD.
Operator posiadający uprawnienia do Managera dokumentów, podczas dodawania plików w kontrolce typu Załącznik będzie miał dostępną do wyboru opcję „Z managera dokumentów”
Menu wyboru źródła, z którego zostanie załączony plik do dokumentu DMS, widoczna pozycja „Z managera dokumentów”.
Operator może do kontrolki typu Załącznik dodać wyłącznie te pliki, do których posiada przynajmniej uprawnienie do podglądu.
Okno Managera dokumentów wywołane z kontrolki typu Załącznik
Plik zostanie załączony po podświetleniu w wywołanym oknie managera dokumentów i kliknięciu w ikonę lub po podwójnym kliknięciu w wiersz, w którym wyświetlane są informacje o pliku.
Załączniki w Comarch DMS Repozytorium
W przypadku, gdy spółka korzysta z funkcjonalności Comarch DMS Repozytorium, załączniki przesyłane do Repozytorium mogą być przechowywane w bazie MongoDB lub w usłudze IBARD. Dokumentacja dotycząca funkcjonalności Repozytorium znajduje się na indywidualnych stronach partnerów oraz na stronach pomocowych pod adresem Comarch DMS – Repozytorium – Baza Wiedzy programu Comarch DMS.
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?