Na formatce prezentowane są typy obiegów, do których operator ma dostęp lub zostały dla niego wykluczone.
Nowe typy obiegu dodawane są za pomocą linku „Dodaj”.
Dodany typ można usunąć za pomocą ikony kosza.
Wprowadzone modyfikacje należy zapisać ikoną dyskietki [Zapisz].
Zaznaczenie parametru „Dostępne” spowoduje zaprezentowanie dodanych typów obiegu na liście dokumentów.
Zaznaczenie parametru „Wykluczone” spowoduje wykluczenie dodanych pozycji typów obiegu z listy dokumentów.
Pracownicy – Typy obiegu, z zaznaczonym parametrem „Dostępne”
Pracownicy – Typy obiegu, z zaznaczonym parametrem „Wykluczone”
Jeżeli operatorowi nie zostanie nadany dostęp do typu obiegu, a operator ma prawo inicjować dokumenty w tym typie, aplikacja wyświetli komunikat:: „Operator nie ma uprawnień na liście dokumentów do następujących typów obiegów: <nazwy typów obiegu>. W ustawieniach definicji wskazanych typów obiegów jest on uprawniony do tworzenia dokumentów. Bez dostępu do wymienionych typów obiegów, operator nie będzie mógł tworzyć dokumentów.”.
Komunikat o zablokowaniu uprawnień do wymienionych typów obiegu
W ramach zakładki „Uprawnienia” można wyróżnić trzy sekcje:
Sekcja „Uprawnienia ogólne”
Sekcja „Uprawnienia ogólne”
Administrator – umożliwia nadanie operatorowi uprawnień administracyjnych.
Uwaga
Operator, który posiada nadane uprawnienia Administratora ma dostęp do wszystkich dokumentów i typów obiegu. Każdy z dokumentów może edytować, usunąć lub przekazać do kolejnego etapu.
Sekcja „Praca z dokumentem”
Sekcja „Praca z dokumentem”
Zmiana daty utworzenia dokumentu – domyślnie operator nie ma prawa do zmiany daty na dokumencie. Ustawiona wartość „Tak” umożliwia zmianę daty utworzenia dokumentu.
Usuwanie dokumentów – domyślnie operator nie ma prawa do usuwania dokumentów. Uprawnienie nadaje się poprzez wybór opcji „Tak”.
Wydruk standardowy – parametr decydujący o możliwości wykonania standardowego wydruku karty obiegu dokumentów. Gdy wartość parametru zostanie ustawiona na „Tak”, na karcie obiegu po kliknięciu w ikonę zostanie wywołany dotychczasowy wydruk karty obiegu. Jeżeli wartość parametru zostanie ustawiona na „Nie”, wówczas standardowy wydruk nie będzie dostępny i jeżeli nie zostały zdefiniowane żadne raporty, do których pracownik jest uprawniony, wówczas ikona będzie niewidoczna dla pracownika. Jeżeli parametr „Wydruk standardowy” zostanie ustawiony na „Nie” i pracownik jest uprawniony do wywołania raportu w kontekście szczegółów dokumentu, wówczas po kliknięciu w ikonę zostanie wywołany raport. Gdy w kontekście szczegółów dokumentu pracownik uprawniony jest do wywołania wielu raportów, wówczas po kliknięciu w ikonę zostanie uruchomiony pierwszy z listy dostępnych raportów. Pozostałe raporty, do których pracownik jest uprawniony w danym kontekście dostępne są na liście pod przyciskiem .
Sekcja „Funkcjonalności”
Sekcja „Funkcjonalności”
Inicjowanie obiegu na podstawie skanu dokumentu – nadane uprawnienie aktywuje funkcjonalność Skany dokumentów , dzięki czemu operator może inicjować określone typy obiegów w oparciu o skany dokumentów (zob. Konfiguracja masowego skanowania).
Automatyczne generowanie dokumentów – nadane uprawnienie aktywuje funkcjonalność automatycznego tworzenia dokumentów z wykorzystaniem narzędzia OCR (zob. dział Automatyczne generowanie dokumentów). Za pomocą narzędzia możliwe jest także inicjowanie obiegu dla dokumentów pobranych z bazy danych sql za pomocą zapytania SQL.
Wydruk książki nadawczej – uprawnienie aktywuje funkcjonalność drukowania książki nadawczej. Na liście dokumentów zostaje włączona ikona „Wydruk książki nadawczej” (zob. Wydruk listy dokumentów w formie książki nadawczej).
Eksport listy dokumentów do arkusza – uprawnienie aktywuje funkcjonalność eksportu wyświetlonej listy dokumentów do arkusza MS Excel (zob. Eksport listy dokumentów do arkusza).
Konfiguracja automatycznego trybu pracy – pole dostępne od wersji 2023.1.0; określa, czy pracownik ma dostęp do zakładki [Konfiguracja automatycznego trybu pracy] i czy może tworzyć skrypty do pracy automatycznej (zob. Konfiguracja automatycznego trybu pracy (robotyzacja procesów) ).
Kreator raportów i dashboardów – uprawnienie aktywuje funkcjonalność tworzenia raportów i dashboardów (zob. dział Raporty i dashboardy). W menu bocznym aplikacji pojawia się ikona [Kreator raportów i dashboardów].
Praca z modułem –określa czy pracownik posiada dostęp do modułu Manager dokumentów lub Repozytorium (jeśli została włączona współpraca z modułem Repozytorium).
Jeżeli w parametrze wybrano wartość ‘Obieg Dokumentów i Manager dokumentów’ lub 'Obieg Dokumentów i Repozytorium’ wówczas w menu bocznym dostępna jest ikona [Manager dokumentów/Repozytorium].
Jeśli w parametrze wybrano wartość „Obieg Dokumentów”, wówczas operator nie ma dostępu ani do modułu Manager dokumentów ani do modułu Repozytorium, nie jest także dla niego wyświetlana w menu głównym ikona .
Po zdefiniowaniu nowych spółek na formatce „Połączenia z ERP”, operator powinien utworzyć strukturę organizacyjną dla każdejze spółek na zakładce „Struktura organizacyjna”.
Dla każdej spółki operator powinien zdefiniować nowe działy/pracowników/stanowiska.
Operatorzy, działy i stanowiska, które są utworzone w jednej spółce nie są widoczne w pozostałych spółkach.
Uwaga
Uprawnienia nadane pracownikowi mają zastosowanie tylko do spółki, w ramach której zostały nadane. Wyjątkiem jest tu uprawnienie „Administrator”.
Operator z aktywnym uprawnieniem „Administrator” widzi dokumenty każdej ze spółek. Pozostali operatorzy widzą dokumenty, do których są uprawnieni.
Zdefiniowane w aplikacji typy obiegu są wspólne dla wszystkich spółek. Jednak uprawnienia dostępu lub odmowy dostępu do poszczególnych typów obiegu są uzależnione od indywidualnych ustawień operatora w każdej spółce.
Może się zdarzyć, że np. w Spółce 1, operator (sekretarka) ma dostęp do typu obiegu „Obieg 1” a w Spółce 2, ten sam pracownik ma zabroniony dostęp do tego typu obiegu.
Zmiana spółki na formatce Struktura organizacyjna
Kontrolki w trybie wielofirmowym
Wybór spółki na definicji typu obiegu
Na definicji typu obiegu została wprowadzona możliwość wyboru spółki dla kontrolek typu:
Kontrolka wyboru spółki prezentowana jest na właściwościach kontrolek typu:
Dokument elektroniczny,
Kontrahent,
Towar
Wybrana wartość spółki określa, z której bazy systemu Comarch ERP Enterprise będą pobierane wartości dla kontrolek.
Uwaga
Do kontrolki „Dokument elektroniczny” dokumenty ERP Enterprise może dowiązywać tylko operator znajdujący się w tej samej spółce, która został określona na właściwościach kontrolki lub podczas inicjowania dokumentu.
Operatorzy z innych spółek nie mogą przeglądać, dodawać lub modyfikować dokumentów ERP Enterprise. Dla operatorów uprawnionych do dokumentu DMS będących z innych spółek prezentowany jest tylko numer dokumentu ERP Enterprise.
Wybór spółki na przykładowej kontrolce typu Kontrahenta
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.
Uwaga
Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:
nie można używać nawiasów kwadratowych
nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)
Kontrolka typu 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 „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.
Uwaga
Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:
nie można używać nawiasów kwadratowych
nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)
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 „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”
Na definicji kontrolki dostępne są następujące pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
Uwaga
Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:
nie można używać nawiasów kwadratowych
nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)
Gdy w polu „Inicjowanie” wybrano opcję „Słownik”, wówczas istnieje możliwość definiowania nowej wartości po kliknięciu w link „Dodaj” i ikonka usunięcia jej z listy (ikonka kosza).
Link „Dodaj” do dodawania nowych wartości i ikonka kosza do usuwania wartości z listy
Inicjowanie wartości
Pole Inicjowanie może przyjmować wartości: Słownik, SQL OD, 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
Liczba stałoprzecinkowa
Od wersji 2024.0.0 kontrolka typu „Liczba stałoprzecinkowa” umożliwia wprowadzenie do aplikacji wartości, które wymagają precyzji z dokładnością do sześciu miejsc po przecinku.
Uwaga
Liczba w kontrolce typu Liczba stałoprzecinkowa może być prezentowana z precyzją do 18 cyfr znaczących i 6 miejsc po przecinku.
Na definicji kontrolki dostępne są następujące pola:
Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Liczba miejsc po przecinku, do której będzie zaokrąglana wartość – parametr dodany w wersji 2024.0.0; w ramach parametru administrator Comarch DMS wybiera, ile miejsc po przecinku będzie można wpisać w danej kontrolce i do ilu miejsc po przecinku będzie zaokrąglana wprowadzona wartość. Parametr przyjmuje wartości od 0 do 6; domyślnie wybrana jest wartość 2.
Uwaga
Jeśli aktualizowano bazę do bieżącej wersji, wówczas domyślnie wartość parametru Liczba miejsc po przecinku, do której będzie zaokrąglana wartość jest ustawiona na 2.
Jeśli: 1. Liczba posiada 6 miejsc po przecinku
oraz
2.Wartość tej liczby jest przekazywana do kontrolki w module Workflow/Repozytorium/innym systemie, który posiada mniejszą precyzję
wówczas wartość zostanie zaokrąglona do tej, która jest prezentowana w tej kontrolce
Jeśli: 1.Liczba posiada wybraną liczbę miejsc po przecinku
oraz
2.Wartość tej liczby jest przekazywana do kontrolki w module Workflow/Repozytorium/innym systemie, który posiada mniejszą precyzję
wówczas w tej kontrolce zostanie wyświetlona ta wartość, a brakujące miejsca po przecinku zostaną uzupełnione zerami.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią.
Uwaga
Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
Uwaga
Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:
nie można używać nawiasów kwadratowych
nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)
Kontrolka typu Liczba stałoprzecinkowa i jej właściwości
Sekcja Inicjowanie wartości
Inicjowanie – pole może przyjąć wartość: Brak, SQL OD, 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.
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.
Uwaga
Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:
nie można używać nawiasów kwadratowych
nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)
Kontrolka typu Liczba rzeczywista i jej właściwości
Sekcja Inicjowanie wartości
Inicjowanie – pole może przyjąć wartość: Brak, SQL OD, 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.
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 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.
[Zapisz].
zostanie wywołany dotychczasowy wydruk karty obiegu. Jeżeli wartość parametru zostanie ustawiona na „Nie”, wówczas standardowy wydruk nie będzie dostępny i jeżeli nie zostały zdefiniowane żadne raporty, do których pracownik jest uprawniony, wówczas ikona 
będzie niewidoczna dla pracownika. Jeżeli parametr „Wydruk standardowy” zostanie ustawiony na „Nie” i pracownik jest uprawniony do wywołania raportu w kontekście szczegółów dokumentu, wówczas po kliknięciu w ikonę 
zostanie wywołany raport. Gdy w kontekście szczegółów dokumentu pracownik uprawniony jest do wywołania wielu raportów, wówczas po kliknięciu w ikonę 
zostanie uruchomiony pierwszy z listy dostępnych raportów. Pozostałe raporty, do których pracownik jest uprawniony w danym kontekście dostępne są na liście pod przyciskiem 
.
, dzięki czemu operator może inicjować określone typy obiegów w oparciu o skany dokumentów (zob. 
(zob. dział 
(zob. 
(zob. 
[Konfiguracja automatycznego trybu pracy] i czy może tworzyć skrypty do pracy automatycznej (zob. 
[Kreator raportów i dashboardów].
[Manager dokumentów/Repozytorium].
, który otwiera listę towarów z programu Comarch ERP Enterprise. W ramach wyszukiwarki należy wpisać nazwę towaru, jego akronim lub ich fragment.
– 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ą.
[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.
