Tekst

Kontrolka typu „Tekst” służy do wprowadzania dowolnych informacji zawartych na dokumencie, jak na przykład sposób dostawy, tytuł faktury, nazwa towaru, a także komentarzy lub uwag do dokumentu.

Na definicji kontrolki dostępne są następujące pola:

Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD lub C# Script

Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
W przypadku wartości „SQL OD” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą inicjowane wartości w kontrolce na karcie obiegu.

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.
Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQLOD lub C# Script). Zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjalizację SQL/C#. Odznaczenie parametru oznacza, że wartość zostanie zainicjowana raz.

Wskazówka

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

URL

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

Na definicji kontrolki dostępne są następujące pola:

Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.

Na dokumencie Comarch DMS, kontrolka ta umożliwia wprowadzenie adresu strony WWW oraz jego zaprezentowanie na karcie obiegu. Po przyciśnięciu wprowadzonego linku, aplikacja podnosi stronę w przeglądarce internetowej. Na karcie obiegu może być użyta kilkukrotnie.

Wartość w kontrolce na karcie obiegu dodawana jest poprzez przycisk [Dodaj]. Prezentowana jest nazwa linku, a nie adres strona WWW. Zmiana wartości dokonywana jest za pomocą przycisku [Zmień]. Link można usunąć za pomocą przycisku [Usuń].

Okno wprowadzenia adresu strony oraz nazwy linku.

Wartość logiczna

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

Na definicji kontrolki dostępne są następujące pola:

Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.

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

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

Własna akcja

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

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

Na właściwościach tej kontrolki dostępne są pola:

Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Plik wykonywalny – użytkownik może uruchomić aplikację typu exe. Aplikacja musi znajdować się na dysku komputera, na którym działa Comarch DMS lub w udostępnionym udziale dyskowym, do którego ma dostęp użytkownik systemu. Ścieżkę do aplikacji należy umieścić w cudzysłowie, np. „c:\windows\system32\calc.exe”.
IIS – pole umożliwia uruchomienie plików wykonywalnych na serwerze IIS.
Procedura – możliwe jest uruchomienie procedury znajdującej się w bazie obiegu. Należy wpisać nazwę procedury.
Procedura ERP – możliwe jest uruchomienie procedury znajdującej się w bazie systemu ERP. Należy wpisać nazwę procedury.
C# Script – istnieje możliwość wywołania procesu zdefiniowanego za pomocą kodu w języku C#.
Nazwa spółki – opcja dostępna w trybie wielospółkowym. Operator może wybrać spółkę z rozwijanej listy.
Potwierdzenie wykonania akcji – użytkownik może zdefiniować własny komunikat, który ma się wyświetlić na szczegółach dokumentu po wykonaniu akcji na przycisku.
Pytaj przed uruchomieniem – jeżeli parametru zostanie zaznaczony, po kliknięciu przycisku „własna akcja” system wyświetli komunikat „Czy uruchomić akcję?”.
Zapisz przed uruchomieniem – zaznaczenie parametru sprawia, że po kliknięciu w przycisk własnej akcji, dokument najpierw jest automatycznie zapisywany, a następnie wykonywane jest polecenie zapisane w konfiguracji kontrolki.

Istnieje możliwość przekazywania parametrów dynamicznych do procedury lub programu skonfigurowanego dla kontrolki „Własna akcja”. Parametry dynamiczne to nazwy kontrolek znajdujących się na karcie obiegu oznaczone znakami „@” na początku i na końcu nazwy.

Kontrolkę można również zainicjować kodem w języku C#. Dla tej opcji możliwy jest wybór miejsca wykonania skryptu: Serwer IIS lub Proces (exe). Uruchomienie skryptu na niezależnym procesie exe jest zalecane w przypadku obsługi API, które nie powinno działać na procesach wielowątkowych takich jak proces IIS.

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

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

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

Wskazówka

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

Wskazówka

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

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

Uruchamianie plików wykonywalnych na serwerze IIS

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

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

Ustawienia kontrolki ‘Własna akcja’

Uruchamianie plików wykonywalnych

Przyklad

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

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

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

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

Właściciel

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.

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.

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).
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ż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, gdy konfiguracja typu obiegu jest niezgodna z wymaganiami kontrolki 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).

Załącznik

Kontrolka typu „Załącznik” umożliwia załączanie plików z dysku lub bezpośrednio z urządzenia typu skaner lub z innych urządzeń. Kontrolka posiada możliwość uruchomienia skanera w celu wykonania skanu dokumentu. Uruchomienie skanera jest możliwe tylko w przypadku aplikacji stacjonarnej.

Uwaga

Sterownik, który jest udostępniany razem z pakietem instalacyjnym aplikacji Comarch DMS, może współpracować z następującymi modelami skanerów EPSON:

DS-40
DS-70
DS-80W
DS-310, DS-320, DS-360W
DS-410
DS-510, DS-520, DS-530, DS-535
DS-560, DS-570W, DS-575W
DS-760, DS-770, DS-775, DS-780N
DS-860, DS-870
DS-970
DS-1610, DS-1630, DS-1660W
DS-5500
DS-6500
DS-7500
DS-50000
DS-60000
DS-70000
ES-50
ES-60W
ES-200
ES-300W
ES-400

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”.
Wersjonowanie pliku – 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.
Manager dokumentów – umożliwia załączanie plików umieszczonych w Managerze dokumentów. Parametr dostępny jedynie w przypadku pracy Comarch DMS Standalone z funkcjonalnością Manager dokumentów. Jeżeli funkcjonalność Manager dokumentów jest wyłączona, a system pracuje z modułem Comarch DMS Repozytorium opcja jest niedostępna.
Nazwa spółki – w parametrze należy wskazać spółkę, w której będą zapisywane załączniki.

Obok nazwy załączonego pliku prezentowana jest ikona zapisu załącznika (umożliwia zapisanie pliku na dysk lokalny) oraz 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”.

Dla parametru „Nazwa spółki” możliwe są opcje:

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

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, w tych typach obiegów, w których na kontrolce typu Załącznik zaznaczono parametr ‘Manager dokumentów’.

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”

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.