Elementy karty obiegu

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.

 

Wskazówka
Istnieje możliwość zmiany numeracji dla dokumentów z numeracji w obrębie miesiąca na numerację w obrębie roku – aby zobaczyć, w jaki sposób, przejdź do artykułu Czy można przestawić numerację dla dokumentów z numeracji w obrębie miesiąca na numerację w obrębie roku?

 

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

 

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

  • przy tworzeniu nowego dokumentu – zapisuje wartości kontrolek w sekcji karta obiegu i dokument jest przekazywany do etapu „Początkowy”.
  • funkcjonalność Zapis – przy modyfikacji danych na utworzonym dokumencie – zapisuje tylko zmiany w wartościach kontrolek z sekcji karta obiegu.

 

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

 

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

 

Komunikat wyświetlany przy próbie usunięcia dokumentu

 

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

 

Ustawianie możliwości wywoływania danego raportu na szczegółach dokumentu

 

Wybór raportu do wyświetlenia w kontekście szczegółów dokumentu

 

A:\---- Z PULPITU ----\Grafika 2017\! NOD 2017.1.0\Ikony\Command-Undo.png [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 [Diagram] – ikona prezentująca zdefiniowany schemat (diagram) procesu,

 

[ChatERP] – przycisk dodany w wersji 2024.3.0; otwiera okno ChatERP (zob. Korzystanie z ChatERP w aplikacji desktop Comarch DMS).

 

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

 

powrót prawo duzy [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 Diagram i podglądu załącznika.

 

Szczegóły dokumentu – prezentacja w trybie pełnoekranowym, zakładka Przekazanie

 

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.

 

 

Karta obiegu prezentowana w powiększeniu 120%

 

 

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)

 

Formatka kalendarza z możliwością modyfikacji daty i godziny

 

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.

Pola „Zatwierdzenie merytoryczne dokumentu” i „Zatwierdzenie formalno-rachunkowe dokumentu” są widoczne tylko wtedy, jeśli na definicji obiegu na zakładce „Schemat obiegu”, po kliknięciu na wybrany etap i przejściu do sekcji „Kontrolki” zostaną zaznaczone checkboxy w ramach kolumny „Widoczna” obok pól „[Nazwa danej kontrolki] (zatwierdzenie merytoryczne)” i „[Nazwa danej kontrolki] (zatwierdzenie formalno-rachunkowe)”, a następnie zmiany zostaną zapisane.

 

Ustawianie widoczności checkboxów do zatwierdzenia merytorycznego i formalno-rachunkowego dokumentu dodanego w kontrolce „Dokument ERP XL”

 

Uwaga

Operator natywny może zatwierdzać dokumenty ERP XL pod względem merytorycznym i formalno-rachunkowym, jeśli na karcie pracownika na zakładce „Uprawnienia”  w polach Zatwierdzanie dokumentu – merytorycznie i Zatwierdzanie dokumentu – formalno-rachunkowo wybrano opcję „Tak” i zapisano zmiany.

Operator zaimportowany z Comarch ERP XL ma uprawnienie do zatwierdzenia dokumentu pod względem merytorycznym  i formalno-rachunkowym w ramach kontrolki typu Dokument elektroniczny lub Dokument ERP XL, jeśli w Comarch ERP XL w module Administrator na karcie danego operatora w zakładce „Księgowe” w sekcji „Parametry” zaznaczono parametry „Zatwierdzanie dokumentów pod względem merytorycznym” oraz „Zatwierdzanie dokumentów pod względem formalno-rachunkowym” i zapisano zmiany.

Jeśli operatorowi zostaną odebrane te uprawnienia w Comarch ERP XL, wówczas checkboxy służące do zatwierdzania dokumentu pod względem merytorycznym i formalno-rachunkowym w Comarch DMS są wyszarzone i nieaktywne.

Nadawanie uprawnień do zatwierdzania dokumentów pod względem merytorycznym i formalno-rachunkowym w Comarch ERP XL

 

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

 

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

 




Załącznik – skan dokumentu

Za pomocą ikonki Add32 „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”.

 

 

Okno „Skanowanie”

 

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

 

Wybór urządzenia skanującego

 

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

 

Wybór opcji "Automatyczny podajnik dokumentów (ADF)"

 

Wybór opcji "Skanowanie dwustronne"

 

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.

 

Wybór formatu skanowanego pliku

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łącznik z dysku

Za pomocą ikonki Add32 „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.

 

Wybór opcji „Z dysku”

 

Po wybraniu opcji „Z dysku” wyświetlane jest okno „Otwieranie” pozwalające na wybranie pliku z dysku.

 

Wybór pliku załącznika 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).

 

Podgląd załącznika

 




Załącznik z Managera dokumentów

Używając ikonki Add32 [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.

Uwaga

Funkcjonalność elektronicznego podpisywania dokumentów nie jest dostępna dla:

  • Dokumentów w Managerze dokumentów
  • Dokumentów dodawanych z Managera dokumentów jako załączniki do dokumentu w module Workflow

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

  • w pliku web.config  w kluczu „UseRepository”  wpisana była wartość „false”
  • podczas definiowania obiegu dokumentów w ustawieniach kontrolki typu załącznik , w zakładce „Archiwa” został zaznaczony checkbox „Manager dokumentów”

 

Zaznaczanie checkboxa „Manager dokumentów” w ustawieniach kontrolki typu załącznik

 

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

 

Opcja „Z managera dokumentów” w ramach kontrolki typu załącznik

 

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.

 

Dodawanie pliku z Managera dokumentów do kontrolki typu załącznik

 

Załącznik dodany z Managera dokumentów

 

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




Podgląd załącznika w karcie obiegu

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.

 

Podgląd załącznika pdf w karcie obiegu na szczegółach dokumentu

 

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 90o

 

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:

  • podgląd wbudowany
  • podgląd za pomocą DevExpress
  • podgląd za pomocą domyślnej aplikacji zewnętrznej

 

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.

 

Podgląd wbudowany załącznika graficznego

 

Podgląd załącznika graficznego za pomocą DevExpress




Zmiana daty utworzenia dokumentu

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.

 

Nadawanie uprawnienia „Zmiana daty utworzenia dokumentu”

 

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

 

Uwaga
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 tworzenia dokumentu jest możliwa również w ramach zakładki „Automatyczne generowanie dokumentów” (zob. Zmiana daty utworzenia dokumentu ).

 

Zmiana daty utworzenia dokumentu

 

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

 




Wyświetlanie spółki na karcie obiegu, automatyczny wybór spółki

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.

 

Klucz „CombinationCompanies”

 

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.

 

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

 




Parametry dynamiczne w kontrolkach

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

  • Inicjowanie kontrolki,
  • Zmiana wartości kontrolki na podstawie wartości innej kontrolki,
  • Kontrolka własna akcja.

Rodzaje parametrów:

  • Predefiniowane:
    • @^UserId@ – ID operatora,
    • @^DocumentId@ – ID/nr dokumentu,
    • @^WorkflowId@ – ID typu obiegu,
    • @^StageId@ – ID etapu,
    • @^DocumentCompanyId@ – ID spółki (w trybie wielospółkowym)
  • @Nazwa (identyfikator) kontrolki@ – identyfikator kontrolki. Parametr zwraca wartość kontrolki, za wyjątkiem kontrolek: Dokument elektroniczny, Kontrahent, Towar, Dokument ERP XL, dla których zwraca GidTyp:GidNumer.
  • Identyfikator obiektu ERP XL (dotyczy kontrolek: Dokument elektroniczny, Kontrahent, Towar, Dokument ERP XL, Dane tabelaryczne):
    • @nazwa (identyfikator)@ – zwraca GidTyp:GidNumer obiektu,
    • @nazwa (identyfikator)_Id@ – zwraca GidNumer obiektu,
    • @nazwa (identyfikator)_IdType@ – zwraca GidTyp obiektu.
  • W edytorze zapytań SQL dla wszystkich kontrolek jest dostępny parametr @^SenderControlName@, który dla każdego zdarzenia przyjmuje nazwę identyfikatora kontrolki, która znajduje się na najniższym poziomie obserwacji w grupie kontrolek, w której nastąpiła zdarzenie.
    • W edytorze kodu C# parametr ten jest dostępny jako Globals.Common.SenderControlName.
  • W edytorze zapytań SQL dla wszystkich kontrolek jest dostępny parametr @^InitSenderControlName@, który dla każdego zdarzenia przyjmuje nazwę identyfikatora kontrolki, która zdarzenie wygenerowała. Wyjątkiem jest zdarzenie inicjowania wartości kontrolki podczas otwierania formatki, wtedy wartość tego parametru wynosi NULL.

 

Parametr „@^UserId@” w przykładowym zapytaniu

 

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

 

Przyklad
select Wartosc from Dane where id=@DocumentId@

 

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

 

Uwaga
Nie jest zalecane użycie parametru “wartość” kontrolki, jeżeli wartość kontrolki użytej, jako parametr została zainicjowana poprzez zapytanie SQL!




Funkcjonalność komunikatów przechwytujących typu trycatch

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)
  • 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.

 

Przyklad

Na poniższym rysunku zostało zaprezentowane zapytanie, w którym może zaistnieć przypadek dzielenia przez zero. Sytuację taką można obsłużyć mechanizmem Try-Catch i wyświetlić użytkownikowi zdefiniowany komunikat.

 


 

Poniższy zrzut prezentuje efekt działania mechanizmu Try-Catch.

 


 

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.

 

Przyklad

ALTER PROCEDURE [do].[OnDocumentPropagation]

@WorkflowId as int = NULL, — DSH_ID z tabeli DF_ConfDSHead

@StageId as int = NULL,– DDS_ID z tabeli DF_ConfDSDictionary

@DocumentId as int = NULL, — DWD_ID z tabeli DF_Work

@PropagatedById as int = NULL, — DCD_ID z tabeli DF_ConfOSDictionary

@DocumentOwnerId as int = NULL, — DWD_DCDOwnerId z tabeli DF_Work

@IsAutomaticPropagation as bit = NULL

AS

BEGIN

begin try

if exists (

select * from do.RO_ObjectsTypes o

join do.RO_StageActive s on o.DFH_Id = s.DFH_Id

and s.DDS_Name = 'Weryfikacja kosztów’ — nazwa etapu

where o.DFH_Name = 'rozliczenie faktury’ — nazwa procesu (typu obiegu)

and s.DWD_ID = @DocumentId )

Begin

declare @KwotaNETTO decimal (24,2)

select @KwotaNETTO = c.DWC_ValueDecimal from do.RO_ControlsValueExpand c where c.DWD_ID = @DocumentId

and c.DKO_Name = 'Kwota NETTO do rozliczenia ’ — nazwa kontrolki

if @KwotaNETTO < 0

BEGIN

DECLARE @Err varchar(max) = 'Kwota netto jest mniejsza od zera!’;

THROW 50001, @Err ,1;

END

End

end try

begin catch

DECLARE @ErrorMessage varchar(max) = 'Błąd podczas przekazywania dokumentu: ’ + ERROR_MESSAGE();

THROW 50001, @ErrorMessage ,1;

end catch

END




Wypełnianie wartości kontrolki w oparciu o wartości innej kontrolki

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:

    • Kontrolka typu Data: aktualna data, data aktualna + 1 dzień,
    • Kontrolka typu Liczba rzeczywista/całkowita/stałoprzecinkowa: aktualna wartość, suma dwóch wartości, różnica dwóch wartości, iloraz dwóch wartości, iloczyn dwóch wartości,
    • Kontrolka typu Tekst: aplikacja umożliwia wiązanie następujących typów kontrolek: Data + Data, Data + Liczba, Liczba + Liczba, Liczba + Tekst, Liczba + Data, Tekst + Tekst.

 

Definicja kontrolki wynikowej „Wartość” za pomocą wyrażenia na podstawie wartości kontrolek powiązanych „Cena” i „Ilość” – iloczyn wartości kontrolek „Cena” i „Ilość”

 

Definicja kontrolki wynikowej „Ilość” za pomocą zapytania SQL na podstawie wartości kontrolek powiązanych „Wartość” i „Cena” – iloraz wartości kontrolek „Wartość” i „Cena”

 

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

 

Link „Dodaj” do dodawania kontrolek powiązanych i ikonki kosza do usuwania kontrolek powiązanych

 

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 :

    • ^Id_Operatora – ID zalogowanego operatora,
    • ^Id_NrDokumentu – ID dokumentu,
    • ^Id_TypObiegu – ID typu obiegu, w ramach którego wystawiony jest dokument,
    • ^Id_Etapu – ID etapu, w którym aktualnie znajduje się dokument.

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ą:

    • @nazwa (identyfikator)@ – GidTyp:GidNumer obiektu,
    • @nazwa (identyfikator)_Id@ – GidNumer obiektu,
    • @nazwa (identyfikator)_IdType@ – GidTyp obiektu.

 

Definicja kontrolki ze wskazaniem wyrażenia jako wzoru na wartość

 

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:

  • linku kontrolki – za pomocą parametru @IdentyfikatorKontrolki_Url@

lub

  • nazwy wyświetlanej kontrolki – za pomocą parametru @IdentyfikatorKontrolki_Display@

 

Przykładowa kontrolka typu URL obserwowana przez kontrolkę typu tekst „Nazwa strony firmy”

 

Zapytanie wprowadzone w ramach kontrolki „Nazwa strony firmy” dotyczące nazwy strony wprowadzonej w ramach kontrolki typu Url

 

Przykładowa kontrolka typu URL obserwowana przez kontrolkę typu tekst „Adres firmy”

 

Zapytanie wprowadzone w ramach kontrolki „Adres firmy” dotyczące adresu www wprowadzonego w ramach kontrolki typu Url

 

Kontrolka typu Url na nowym dokumencie – użytkownik wpisał nazwę linku i adres

 

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:

  • na liście „Lista towarów” były wyświetlane wszystkie produkty, które doda w tabeli w polu „Nazwa towaru” (identyfikator: nazwa_towaru, typ: Tekst);
  • na liście „Lista wartości” były wyświetlane wszystkie wartości, które doda w tabeli w polu „Wartość 3” (identyfikator: war3, typ: Liczba stałoprzecinkowa).

 

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”;

 

Przykładowa kontrolka typu Dane tabelaryczne”Tabela” (identyfikator: Multiline1) obserwowana przez kontrolkę typu lista „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”;

 

Wprowadzanie zapytania SQL w ramach definicji kontrolki „Lista towarów”

 

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”;

 

Przykładowa kontrolka typu Dane tabelaryczne „Tabela” (identyfikator: Multiline1) obserwowana przez kontrolkę typu lista „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”;

 

Wprowadzanie zapytania SQL w ramach definicji kontrolki „Lista wartości”

 

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

 

Widok kontrolki „Lista towarów” po uzupełnieniu pola „Nazwa towaru” w trzech wersach tabeli

 

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

 

Widok kontrolki „Lista wartości” po uzupełnieniu pola „Wartość 3” w trzech wersach tabeli

 

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:

 

 

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!