– numer dokumentu aplikacji Comarch DMS. Numer składa się z 4 części:

FZE – prefix, 1- kolejny numer, 3- miesiąc, w którym wystawiono dokument, 2017 – rok.

[Nawiguj wstecz (Powrót)] – powrót na listę dokumentów,

[Zapisz] – funkcjonalność zapisu zmian lub zatwierdzenia nowododanej pozycji:

[Tryb pełnoekranowy] – Przyciski włączenia/ wyłączenia prezentacji karty obiegu w trybie pełnoekranowym.

[Usuń] – umożliwia usunięcie wskazanego dokumentu. Dokument może usunąć tylko operator z odpowiednimi uprawnieniami. Dokument po usunięciu znika z interfejsu, pozostaje jednak w bazie jako archiwalny. Istnieje możliwość przywrócenia takiego dokumentu. Nie ma możliwości usunięcia dokumentu na innym etapie, niż przypisany do zalogowanego operatora oraz dokumentu z zakończonym obiegiem.

Podczas usuwania dokumentu pojawia się komunikat informujący operatora o tym, że dokument jest usuwany.

[Wydruk] – ikona umożliwia wykonanie wydruku standardowego karty obiegu oraz jeżeli zdefiniowano, umożliwia wyświetlenie raportu w kontekście szczegółów dokumentu.

[Cofnij dokument] – ikona umożliwia cofnięcie dokumentu do wcześniejszego etapu. Ikona nie jest prezentowana podczas inicjowania dokumentu i na etapie początkowym.

[Diagram] – ikona prezentująca zdefiniowany schemat (diagram) procesu,

[Dodaj] – opcja dodania nowego elementu pola, w którym ikona została wyświetlona

[Przejdź do następnego etapu] – ikona przenosi dokument do wskazanego etapu.

Okno dokumentu w standardowym widoku podzielone jest na dwa panele. W pierwszym (Karta obiegu) prezentowane są kontrolki wynikające z definicji karty obiegu, które wypełniane są podczas tworzenia dokumentu. Drugi panel (Przebieg) dotyczy graficznej prezentacji przebytych etapów obiegu i zasad przekazywania dokumentu. Istnieje także możliwość podglądu diagramu i podglądu załącznika.

– sekcja dokumentu. Każda utworzona na dokumencie sekcja może być zwinięta lub rozwinięta – sposób prezentacji sekcji uzależniony jest od ustawienia parametru ‘Prezentacja sekcji’ w panelu użytkownika.

[Zmiana daty utworzenia] – funkcjonalność zmiany daty utworzenia dokumentu. Zmiana daty wpływa w sposób pośredni na numeru dokumentu.

– kontrolka typu liczba (rzeczywista/całkowita/stałoprzecinkowa). Wartości wprowadzane są ręcznie przez operatora lub pochodzą z zapytania SQL zdefiniowanego na formatce Zapytanie SQL lub Wzór na wartość.

– kontrolka typu tekst. Wartości wprowadzane są ręcznie przez operatora lub pochodzą z zapytania SQL zdefiniowanego na formatce Zapytanie SQL lub Wzór na wartość.

– kontrolka typu data i godzina. Możliwość zmiany daty za pomocą rozwijanej formatki z kalendarzem oraz scrollem myszki po ustawieniu kursora na elemencie wymagającym zmiany (YYYY-MM-DD hh:mm:ss)

– kontrolka typu Dokument elektroniczny z danymi zaczytanymi z programu Comarch ERP XL. Przycisk wywołuje listę ofert zakupu, użytkownik ma możliwość podglądu szczegółów dokumentu oraz zmiany dokumentu na inny. Przycisk odpina dokument elektroniczny z kontrolki.

– kontrolka typu załącznik. Prezentowana jest nazwa załącznika, data dodania, ikona umożliwiająca usunięcie pliku oraz ikona zapisu załącznika. Gdy jest włączona opcja wersjonowania załączników, obok nazwy załącznika wyświetlana jest cyfra określająca liczbę wersji pliku załącznika.

– kontrolka typu wartość logiczna. Prezentuje wartości: Tak/Nie.

– kontrolka typu lista. Wartości kontrolki definiowane są na jej właściwościach lub pochodzą z zapytania SQL zdefiniowanego na formatce Zapytanie SQL lub Wzór na wartość.

– kontrolka typu Dokument związany. Prezentuje wiązania wszystkich dokumentów z systemu Comarch ERP XL, do których dowiązany jest aktualny dokument z aplikacji Comarch DMS. Ikona umożliwia odwiązanie dokumentu. Jednocześnie operacja ta usuwa wiązania z tabeli cdn.dokzwiazane.

– kontrolka typu Dokument ERP XL. Prezentuje numer dokumentu w systemie Comarch ERP XL, który został wygenerowany z poziomu aplikacji Comarch DMS wraz z opisem analitycznym. W kontrolce prezentowane są także numery istniejących dokumentów z systemu Comarch ERP XL, które zostały dowiązane.

– kontrolka typu dane tabelaryczna. Możliwość dodawania nieograniczonej ilość wierszy. Typ i ilość kolumn jest określana na właściwościach kontrolki podczas definicji typu obiegu.

– kontrolka typu ‘Dokument elektroniczny’, dla kontrolki umożliwiono zatwierdzanie dokumentu pod względem merytorycznym oraz formalno – rachunkowym. Zatwierdzenie dokumentu ERP XL pod względem merytorycznym i formalno-rachunkowym może zrealizować operator natywny DMS lub operator ERP XL zalogowany do Comarch DMS. W przypadku zatwierdzenia przez operatora natywnego DMS do dokumentu ERP XL zostanie przekazany login operatora DMS.

– kontrolka ‘Dokument ERP XL”, analogicznie do kontrolki ‘Dokument elektroniczny’ umożliwiono zatwierdzanie dokumentu pod względem merytorycznym oraz formalno – rachunkowym.

Za pomocą ikonki „Dodaj” dostępnej w ramach kontrolki typu załącznik można dodać do dokumentu pliki o dowolnym formacie. Po kliknięciu ikonki „Dodaj” możliwy jest wybór źródła pliku.

Po wybraniu opcji „Z dysku” wyświetlane jest okno „Otwieranie” pozwalające na wybranie pliku z dysku. Plik zostanie załączony do dokumentu, a jego podgląd możliwy będzie w oknie „Podgląd załączników”.

Za pomocą ikonki „Dodaj” można dodać do dokumentu skan dokumentu bezpośrednio ze skanera. Warunkiem koniecznym jest podłączenie zsynchronizowanego urządzenia skanującego. Po wybraniu opcji „Skan” wyświetla się okno „Skanowanie”.

Należy wskazać urządzenie poprzez wybranie linku „Zmień”. Ustawione urządzenie skanujące zostaje zapamiętane.

Zaznaczenie kontrolki „ADF” umożliwia współprace ze skanerami obsługującymi automatyczny podajnik dokumentów. Kontrolka „Duplex” umożliwia prace w trybie „duplex”, czyli skanowania dwustronnego.

Na formatce „Skanowanie” możliwe jest nadanie własnej nazwy dodawanego załącznika i określenie jego typu. Operator może wybrać typ: .bmp, .tif, .jpg, .pdf, .png, .gif. Aplikacja podpowiada domyślną nazwę pliku i jego format. Dokument w formie skanu w wybranym typie pliku zostanie załączony do dokumentu, a jego podgląd możliwy będzie w oknie „Podgląd załącznika”. Aplikacja zapamiętuje i prezentuje rozszerzenie z ostatnio zeskanowanego dokumentu.

Funkcjonalność umożliwia jednoczesną pracę na podglądzie załącznika (skanu) i kontrolce Dokument ERP XL. Funkcjonalność dostępna jest tylko w wersji stacjonarnej aplikacji. Działanie podglądu warunkują aktywne szczegóły kontrolki typu Dokument ERP XL (podniesione szczegóły kontrolki Dokument ERP XL).

Na podglądzie działa funkcja skalowania załącznika. Po wyjściu z podglądu załącznika wracamy na kartę obiegu.

W kontrolce typu Załącznik możliwy jest obrót załączonego pliku graficznego. Wprowadzona zmiana jest zapisywana i po ponownym wejściu w załącznik dokument/plik graficzny wyświetlany jest w ostatnio ustawionej orientacji.

W oknie podglądu załącznika znajdują się ikony pozwalające na obrót załącznika w lewo lub w prawo, jednorazowe kliknięcie w ikonę powoduje obrót o 90^o

Od wersji  2021.2.0  w aplikacji stacjonarnej umożliwiono  również wybór sposobu wyświetlania podglądu załącznika w formacie PDF lub w formie plików graficznych. Podgląd załącznika może być wyświetlany jako:

Załącznik po kliknięciu automatycznie otwiera się w podglądzie wbudowanym. Aby możliwa była zmiana sposobu podglądu, na górnym panelu podglądu załącznika zostały wprowadzone dwie nowe ikony:

[Przełącz podgląd] – ikona, która pozwala na przełączanie podglądu między podglądem wbudowanym a DevExpress

[Otwórz w aplikacji zewnętrznej] – ikona, która pozwala na przełączanie podglądu do domyślnej aplikacji zewnętrznej

Ustawienie widoku podglądu jest zapamiętane  – jeżeli podgląd został zamknięty, a później otwarty ponownie, zostanie wyświetlony w ostatnio używanym typie widoku. Podobnie, kolejny załącznik w innym dokumencie także domyślnie wyświetli się w ostatnio wybranym trybie. Wyjątkiem jest podgląd w domyślnej aplikacji zewnętrznej – po ponownym otwarciu podglądu załącznika, dla którego przedtem ustawiono taki typ widoku, zostanie on otwarty w podglądzie wewnętrznym.

Funkcjonalność umożliwia modyfikację daty utworzenia dokumentu. Zmiana daty utworzenia dokumentu może wpłynąć na zmianę formatu numeru dokumentu (miesiąc i rok). Podczas inicjowania dokumentu operator z nadanym uprawnieniem „Zmiana daty utworzenia dokumentu” może edytować datę utworzenia. Domyślnie aplikacja prezentuje datę bieżącą dokumentu. Edycja daty możliwa jest tylko przed zapisem dokumentu. Po przyciśnięciu ikony , operator może wskazać w kalendarzu nową datę. Zmiana daty utworzenia nie jest możliwa na kolejnych etapach. Na dokumencie w późniejszym etapie prezentowana jest tylko informacja z datą utworzenia dokumentu.

Operator bez uprawnienia „Zmiana daty utworzenia dokumentu” podczas pracy z dokumentem widzi tylko informacje z datą utworzenia dokumentów.

Zmiana daty utworzenia dokumentu

W Comarch DMS w pliku web.config udostępniono nowy klucz:
<add key=”CombinationCompanies” value=” „/>. Klucz odpowiada za możliwość ustawienia różnych spółek dla kontrolek na definicji obiegu.

Gdy <add key=”CombinationCompanies” value=”TRUE„/> na definicji typu obiegu możliwe będzie wskazanie różnych spółek w kontrolkach. Gdy <add key=”CombinationCompanies” value=”FALSE„/> na definicji typu obiegu w kontrolkach można wskazać tą samą spółkę lub ustawić wyrażenie „Dowolna spółka ERP…” przy czym wyrażenie musi odnosić się do tego samego typu systemu ERP.

Domyślnym ustawieniem parametru CombinationCompanies jest wartość FALSE.

W przypadku, gdy w wielofirmowym trybie pracy Comarch DMS wartość parametru
<add key=”CombinationCompanies” value=”FALSE„/> na definicji typu obiegu prezentowany jest dodatkowy parametr ‘Zastosuj spółkę zalogowanego operatora podczas generowania dokumentu’.

Definicja typu obiegu, parametr „Zastosuj spółkę zalogowanego operatora podczas generowania dokumentu”

Zaznaczenie parametru ‘Zastosuj spółkę zalogowanego operatora podczas generowania dokumentu’ spowoduje, że w sytuacji, gdy na definicji określono spółkę jako ‘Dowolna spółka ERP…’, podczas dodawania dokumentu nie będzie wyświetlane pytanie o spółkę, w ramach której będzie dodawany dokument, lecz automatycznie zostanie wskazana spółka, do której zalogowany jest operator dodający dokument.

Gdy parametr ‘Zastosuj spółkę zalogowanego operatora podczas generowania dokumentu’ pozostanie odznaczony, wówczas operator podczas dodawania dokumentu otrzyma komunikat z pytaniem o spółkę, dla której rejestruje dokument.

W przypadku, gdy <add key=”CombinationCompanies” value=”TRUE„/>, na karcie obiegu będzie prezentowana spółka wyłącznie w przypadku, gdy na definicji typu obiegu, we właściwościach kontrolek wskazano tę samą spółkę. W przeciwnym wypadku, nazwa spółki nie będzie prezentowana na dokumencie.

Parametry typu @nazwa@ można zastosować do poniższych typów operacji:

Rodzaje parametrów:

Możliwa jest obsługa parametrów w mechanizmie inicjowania kontrolki poprzez zapytanie SQL. W zapytaniu SQL inicjującym wartość kontrolki możliwe jest wprowadzenie nazwy identyfikatora kontrolki poprzedzonej i zakończonej znakiem @.

Przed wykonaniem zapytania parametr @DocumentId@ zostanie zamieniony na wartość kontrolki.

We wszystkich miejscach, w których istnieje możliwość definiowania zapytań SQL, możliwa jest również obsługa „Try-Catch”. Są to: edytory kontrolek (inicjowanie oraz obserwator kontrolek), oraz wyzwalacze: OnAfterDocumentCreated, OnAfterDocumentSave, OnBeforeDocumentShow, OnDocumentPropagation. W każdym z tych miejsc jest możliwe przechwycenie wyjątku rzuconego przez zapytanie i zaprezentowanie użytkownikowi zdefiniowanego przez nas komunikatu.

Mechanizm „Try-Catch” w założeniu służy do przechwytywania wyjątków, ale można go również wykorzystać do innych celów. Bardzo przydatną funkcją, jaka można zastosować w przypadku wyzwalaczy korzystających z „Try-Catch”, jest walidacja poprawności wprowadzonych informacji na karcie obiegu. W przypadku stwierdzenia nieprawidłowości rzucenie Throw spowoduje wyświetlenie komunikatu i cofnięcie transakcji. Wszelkie informacje wprowadzone na kartę obiegu zostaną zachowane, a operator nie będzie mógł zapisać dokumentu ewentualnie przekazać dokumentu do kolejnego etapu, jeżeli nie wprowadzi poprawnych danych.

Funkcjonalność umożliwia wypełnienie wartości jednej kontrolki wynikowej (np. Wartość) na podstawie wartości kontrolek powiązanych (np. Ilość i Cena) z wykorzystaniem wyrażenia zdefiniowanego na właściwościach kontrolki wynikowej (np. Ilość*Cena = Wartość).

Przykłady definicji kontrolek wynikowych:

Modyfikacja danych w kontrolkach powiązanych powoduje zmianę wartości w kontrolce wynikowej. Aktualizacja wykonywana jest po każdej zmianie. Kontrolki, które stają się kontrolkami wynikowymi i powiązanymi podlegają tym samy właściwościom, co kontrolki „zwykłe” np. wymagalności, tylko do odczytu, widoczność itd.

Zdefiniowane kontrolki powiązane można usuwać za pomocą ikony kosza, a dodawać za pomocą linku „Dodaj”. Z kontrolek powiązanych operator może wybierać także kontroli typu „Lista”.

Wzór na wyrażenie odnosi się do zapytań SQL wykonywanych na bazie systemu ERP XL lub bazie aplikacji Comarch DMS. Dla kontrolki typu Lista umożliwiono odwołanie się do nazwy wybranego elementu.

Możliwe jest wykorzystywanie parametrów predefiniowanych na formatce Wyrażenie kontrolki: @^Id_Operatora@, @^Id_NrDokumentu@, @^Id_TypObiegu@, @^Id_Etapu@ gdzie :

Na formatce „Wyrażenie kontrolki” można także wykorzystać parametr @nazwa (identyfikator) kontrolki@, który zostanie zamieniony na wartość kontrolki.

Dla kontrolek typu: Dokument elektroniczny, Kontrahent, Towar, Dokument ERP XL, Dane tabelaryczne – parametry zwrcają zwraca:

W aplikacji desktop i web na karcie obiegu dokumentu znajduje się boczny panel, w którym wyświetlana jest lista dokumentów. Dokumenty widoczne na tej liście są w określonym typie obiegu, tym samym co otwarty dokument.  W przypadku, gdy na liście zostanie użyty filtr, po wejściu z tej listy w szczegóły dokumentu, podgląd listy dokumentów przejmie użyty filtr.

Karta obiegu z rozwiniętym panelem listy dokumentów

Panel boczny może być zwinięty i wyświetlany na żądanie operatora lub zadokowany w oknie poprzez przypięcie pinezką.

Dokowanie panelu listy dokumentów w oknie szczegółów dokumentu

Karta obiegu w standardowym widoku ze zwiniętym panelem listy dokumentów

W trybie pełnoekranowym karta obiegu prezentowana jest w formie zakładek. Tryb pełnoekranowy można włączyć klikając przycisk . Zakładka ‘Karta obiegu’ zawiera zestaw pól do uzupełnienia, na zakładce ‘Przekazanie’ udostępniono informacje o aktualnym etapie wraz z ikoną przekazania, informacje o uprawnionych do aktualnego i następnego etapu oraz diagram przebytych etapów.

Zakładka Przekazanie na karcie obiegu w trybie pełnoekranowym, ze zwiniętym panelem listy dokumentów