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

FZ – prefix, 18- kolejny numer, 10- miesiąc, w którym wystawiono dokument, 2022 – 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. Ten przycisk umożliwia również uzyskanie informacji technicznych o dokumencie (zob. Okno z informacjami o dokumencie).

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

Po kliknięciu na ikonę usuwania dokumentu pojawia się komunikat informujący o próbie usunięcia dokumentu – jeżeli operator nadal chce usunąć dokument, wówczas powinien nacisnąć „Tak”, jeśli zaś naciśnie „Nie” lub kliknie poza oknem komunikatu – dokument nie zostanie usunięty.

[Wydruk] – ikona umożliwia wykonanie wydruku standardowego karty obiegu (zob. Wydruk szczegółów dokumentu) oraz (jeżeli tak zdefiniowano w zakładce Kreator raportów i dashboardów w sekcji Uprawnienia) umożliwia wyświetlenie raportu/wydruku sPrint 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.

Formatka podzielona jest na trzy panele:

1. W pierwszym panelu (Karta obiegu) prezentowane są kontrolki wynikające z budowy schematu, które wypełniane są podczas tworzenia dokumentu.

2. Drugi panel (Przebieg) dotyczy graficznej prezentacji przebytych etapów obiegu.

3.Trzeci panel (Przekazanie) dotyczy zasad przekazywania dokumentu.

Istnieje także możliwość podglądu diagramu i podglądu załącznika.

Panel Karta obiegu

– 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 (zob. Szczegóły dokumentu ).

– Na karcie obiegu została udostępniona funkcjonalność skalowania widoku karty obiegu. Możliwe jest powiększanie i pomniejszanie karty obiegu za pomocą ikon i umieszczonych w prawym dolnym rogu karty obiegu.

Przykładowe kontrolki

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

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

– kontrolka typu tekst (zob. Tekst). Wartości wprowadzane są ręcznie przez operatora lub pochodzą z zapytania SQL lub C# zdefiniowanego na formatce Inicjowanie lub Wzór na wartość.

– kontrolka typu data i godzina (zob. Data i godzina). Możliwość zmiany daty za pomocą rozwijanej formatki z kalendarzem  (YYYY-MM-DD hh:mm:ss)

– kontrolka typu Dokument elektroniczny z danymi zaczytanymi z programu Comarch ERP XL (zob. Dokument elektroniczny). 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 (zob. Załącznik). Prezentowana jest nazwa załącznika,  ikona umożliwiająca usunięcie pliku oraz ikona zapisu załącznika na dysk.

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.

W wersji 2023.0.0 uległa zmianie ikona załącznika w formacie PDF, zarówno w aplikacji serwerowej (dawny web) , jak i w aplikacji desktop. Aktualna ikona dla załącznika PDF to ikona 

– kontrolka typu wartość logiczna (zob. Wartość logiczna). Prezentuje wartości: Tak/Nie.

– kontrolka typu lista (zob. Lista). Wartości kontrolki definiowane są na jej właściwościach lub pochodzą z zapytania SQL lub C# zdefiniowanego na formatce Inicjowanie.

– kontrolka typu Dokument związany (zob. Dokumenty związane). Prezentuje wiązania wszystkich dokumentów z systemu Comarch ERP XL, do których dowiązany jest aktualny dokument z aplikacji Comarch DMS. Przycisk wywołuje listę dokumentów z systemu Comarch ERP XL, użytkownik ma możliwość podglądu szczegółów dokumentu oraz zmiany dokumentu na inny. Przycisk odpina dokument  z kontrolki. Jednocześnie operacja ta usuwa wiązania z tabeli cdn.dokzwiazane.

– kontrolka typu Dokument ERP XL (zob. 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. Od wersji 2024.1.0 umożliwiono również obsługę tabeli VAT na formatce Dokument ERP XL dla typów dokumentów: (A)Faktura zakupu i (A) Korekta faktury zakupu (zob. Obsługa Tabeli VAT na formatce Dokument ERP XL dla dokumentów typu (A)Faktura zakupu oraz (A) Korekta faktury zakupu)

– kontrolka typu dane tabelaryczne (zob. Dane tabelaryczne). Możliwość dodawania nieograniczonej ilość wierszy.

Typ i ilość kolumn jest określana na właściwościach kontrolki podczas definicji typu obiegu.

Wartości kontrolki mogą być wprowadzane ręcznie przez operatora, definiowane na jej właściwościach, pobierane z systemu Comarch ERP XL lub pochodzić z funkcjonalności inicjowania kontrolek zapytaniami SQL, kodem C# lub wyrażeniem.

Od wersji 2024.1.0 istnieje możliwość importu danych do kontrolki typu Dane tabelaryczne z arkusza kalkulacyjnego (zob. Import danych z arkusza Excel do kontrolki typu Dane tabelaryczne)

– kontrolka typu ‘Dokument elektroniczny’ (zob. 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.

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

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.

Po wyborze przycisku [Ustawienia skanera] dostępne są dwie dodatkowe opcje:

• Automatyczny podajnik dokumentów (ADF) -  jego zaznaczenie umożliwia współpracę ze skanerami obsługującymi automatyczny podajnik dokumentów
• Skanowanie dwustronne -  jego zaznaczenie umożliwia pracę w trybie „duplex”, czyli skanowania dwustronnego

Po zaznaczeniu opcji należy nacisnąć przycisk "Zapisz", aby zmiany zostały zachowane, zaś aby zrezygnować ze zmian - przycisk "Anuluj".

Na formatce „Skanowanie” możliwe jest nadanie własnej nazwy dodawanego załącznika i określenie jego typu. W polu "Format pliku" 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” (zob. Podgląd załącznika). Aplikacja zapamiętuje i prezentuje rozszerzenie z ostatnio zeskanowanego dokumentu.

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” (zob. Podgląd załącznika).

Używając ikonki [Dodaj], która jest dostępna w ramach kontrolki typu załącznik, można dodać do dokumentu pliki dowolnego formatu. Po kliknięciu ikonki „Dodaj” możliwy jest wybór źródła pliku – również pliku z Managera dokumentów.

Aby możliwe było dodanie pliku z Managera dokumentów konieczne jest, aby:

Jeżeli powyższe warunki zostaną spełnione i zmiany zostaną zapisane,  to przy próbie dodania nowego dokumentu po kliknięciu ikonki  [Dodaj] w ramach kontrolki typu załącznik widoczna jest dodatkowa opcja – „Z managera dokumentów”

Kiedy użytkownik wybierze opcję „Z managera dokumentów”, wówczas otworzy się okno Managera dokumentów. Aby dodać plik z Managera dokumentów jako załącznik należy kliknąć na dany plik, a następnie na ikonkę [Załącz wybrane pliki]. Wówczas plik zostanie dodany do kontrolki typu załącznik na danym dokumencie.

W ramach otwartego okna Managera dokumentów dostępne są następujące ikony:

[Załącz wybrane pliki] –  po wyborze tej ikonki do kontrolki typu załącznik zostanie dołączony plik, na który przedtem kliknął użytkownik, przycisk jest wyszarzony do czasu  wyboru pliku z Managera dokumentów.

[Zamknij] –  po kliknięciu tej ikonki okno Managera dokumentów zostaje zamknięte, a załącznik nie jest dodawany

[Nowy dokument] –  po kliknięciu ikony zostaje otwarte okno, w którym możliwe jest dodanie z dysku nowego dokumentu do Managera dokumentów

[Nowy katalog] –  naciśnięcie tej ikonki powoduje otwarcie okna, w ramach którego w Managerze dokumentów można dodać nowy katalog

[Szukaj] – wyszukiwarka, w której użytkownik może wyszukiwać dokumenty po frazie – wyszukiwane są również dokumenty znajdujące się  w katalogach

[Filtry] – po kliknięciu tej ikonki wyświetlony zostaje checkbox [Ukryj katalogi] – jeśli operator zaznaczy checkbox, katalogi nie są widoczne na liście dokumentów w oknie Managera dokumentów

[Usuń filtry] – po naciśnięciu tej ikonki zostaje usunięty filtr i katalogi są znów widoczne w oknie Managera dokumentów

[Wyświetlaj listę] – kliknięcie tej ikonki sprawia, że dokumenty wyświetlane są w formie listy, wraz z datą modyfikacji i nazwą użytkownika, który dokonał modyfikacji

[Wyświetlaj duże ikony] –  po naciśnięciu tego przycisku w ramach okna Managera dokumentów wyświetlane są duże ikony dokumentów i katalogów oraz ich nazwy

– przycisk widoczny w prawej części okna Managera dokumentów, obok nazwy katalogu, dzięki niemu możliwe jest przejście do katalogu nadrzędnego

– przyciski dostępne nad drzewem katalogów, pozwalają zmienić kolejność katalogów, które są wyświetlane w ramach katalogu nadrzędnego.

Po kliknięciu prawym przyciskiem myszy na katalog otwierane jest menu kontekstowe katalogu, a na dokument – menu kontekstowe dokumentu (zob. Okno Managera dokumentów).

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

Wskazówka

Takie uprawnienie jest nadawane poprzez zaznaczenie przez administratora systemu na karcie danego pracownika w zakładce Uprawnienia, w sekcji Praca z dokumentem opcji „Tak”  w polu „Zmiana daty utworzenia dokumentu” i zapisanie zmian ikoną dyskietki.

 

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

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

Zmiana daty tworzenia dokumentu jest możliwa również w ramach zakładki „Automatyczne generowanie dokumentów” (zob. Zmiana daty utworzenia dokumentu ).

W Comarch DMS w pliku web.config udostępniono 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’.

\

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:

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.

Opis funkcjonalności

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 samym 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 kontrolki 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 zwracają:

Obserwacja kontrolki typu URL przez inne kontrolki

W wersji 2023.1.0 dodano możliwość obserwowania kontrolki typu URL przez inne kontrolki. Możliwe jest obserwowanie:

Kontrolki „Nazwa strony firmy” i „Adres firmy”  zostają uzupełnione wartościami z kontrolki typu Url „Strona firmy” – jak pokazano na poniższym filmie:

Obserwacja kontrolki typu Dane tabelaryczne przez kontrolkę typu lista

Od wersji 2023.1.0 również kontrolka typu Dane tabelaryczne może być obserwowana przez kontrolkę typu Llsta.

Przykład:

Użytkownik chce, aby:

W tym celu:

1. w ramach kontrolki „Lista towarów” w ramach pola „Kontrolki powiązane” dodał kontrolkę „Tabela” (Multiline1), aby była obserwowana przez kontrolkę „Lista towarów”;

2. w kontrolce „Lista towarów” w polu „inicjowanie” wybrał „SQL OD” oraz „Text” w polu „Rodzaj identyfikatora” i po kliknięciu przycisku „Ustaw” wpisał następujące zapytanie:

select nazwa_towaru, nazwa_towaru from  @Multiline1@

a później nacisnął przycisk „ Zapisz”;

3. następnie w ramach kontrolki „Lista wartości” w ramach pola „Kontrolki powiązane” dodał kontrolkę „Tabela” (Multiline1), aby była obserwowana przez kontrolkę „Lista wartości”;

4. w kontrolce „Lista wartości” w polu „inicjowanie” wybrał „SQL OD” oraz „Int” w polu „Rodzaj identyfikatora” i po kliknięciu przycisku „Ustaw” wpisał następujące zapytanie:

select war3, war3 from  @Multiline1@

a później nacisnął przycisk „ Zapisz”;

5. Następnie użytkownik zapisał zmiany za pomocą ikony [Zapisz] i utworzył nowy dokument. W tabeli „Tabela” dodał 3 wersy:

• w polu „Nazwa towaru wpisał:
  • W wersie 1: jabłko
  • W wersie 2: gruszka
  • W wersie 3: cytryna
• w polu „Wartość 3” wpisał:
  • W wersie 1: 2
  • W wersie 2: 4
  • W wersie 3: 6

Zgodnie z ustawieniami kontrolek typu lista:

• W kontrolce „Lista produktów” widoczne są wartości:
  • jabłko
  • gruszka
  • cytryna

 

 

• w kontrolce „Lista wartości” widoczne są wartości:
  • 2
  • 4
  • 6

Wraz ze zmianą wartości w polach „Nazwa produktu” i „Wartość 3” również wartości w kontrolkach typu lista będą ulegać zmianie – jak pokazano na poniższym filmie: