Autoryzacja API

Zakładka „Autoryzacja API” pozwala na określenie domyślnego operatora Comarch ERP XL oraz domyślnej bazy danych.

Parametry te są wykorzystywane przez operatorów natywnych Comarch DMS do realizacji operacji takich jak:

  • podnoszenie formatek dokumentów Comarch ERP XL,
  • generowanie dokumentów Comarch ERP XL,
  • podnoszenie formatek list dokumentów i kontrahentów w systemie Comarch ERP XL z poziomu Comarch DMS.

 

zapisz32 [Zapisz] – przycisk służący do zapisu wprowadzonych lub zmodyfikowanych danych.

 

Pola dostępne na zakładce „Autoryzacja API”:

  • Nazwa firmy – (przed wersją 2024.0.2 pole „Baza danych”) nazwa firmy Comarch ERP XL;
  • Domyślny login operatora ERPlogin operatora Comarch ERP XL wykorzystywany przez operatorów natywnych Comarch DMS do wykonywania operacji w systemie Comarch ERP XL z poziomu Comarch DMS;
  • Hasłohasło operatora Comarch ERP XL.

 

Okno autoryzacji API

 

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!




Połączenia z ERP

Po włączeniu wielofirmowego trybu pracy w Comarch DMS poprzez zmianę wartości klucza „MultiCompany=true” w pliku konfiguracyjnym Web.config, zakładka „Autoryzacja API” zostaje zastąpiona zakładką „Połączenia z ERP”, na której definiowane są spółki.

W ramach zakładki dostępne są następujące przyciski:

 

[Dodaj] – opcja dodania nowej spółki

 

zapisz32 [Zapisz] – opcja zapisu danych

 

D:\---- Z PULPITU ----\Grafika\& NOD Webowy 29-12-2014\Ikonki\Garbage-Closed32.png [Usuń] – opcja umożliwiająca usunięcie zdefiniowanej spółki (po uprzednim kliknięciu na nią)

 

Widoczna jest również lista dodanych spółek. Po kliknięciu na nazwę danej spółki na liście informacje o tej spółce są pokazywane na prawym panelu.

 

Lista utworzonych spółek

 

Definicja spółki

 

 

Definiowanie nowej spółki

Nową spółkę operator dodaje po przyciśnięciu ikony. Na prawym panelu pojawia się lista pól do wypełnienia danymi nowej spółki.

 

wybór trybu pracy spółki (Comarch ERP XL, Optima, Altum, Enterprise, Standalone)

 

definicja nazwy spółki

 

skrót nazwy spółki (max 5 znaków)

 

definicja połączenia do bazy systemu Comarch ERP XL. Po przyciśnięciu linku „zmień” pojawia się formatka połączenia.

 

– pole, w którym operator wprowadza nazwę klucza licencyjnego

 

– nazwa zmapowanej bazy Comarch ERP XL (nazwa firmy)

 

lista wyboru domyślnego centrum ze struktury podległościowej z systemu Comarch ERP XL. Lista jest automatycznie inicjowana po zdefiniowaniu poprawnego połączenia z bazą w polu „Połączenie”.

 

login operatora Comarch ERP XL wykorzystywany przez operatorów natywnych Comarch DMS do wykonywania operacji typu: podniesienie formatek listy dokumentów, listy kontrahentów, generowanie dokumentu z kontrolki Dokument ERP XL.

 

hasło operatora Comarch ERP XL

 

– po zaznaczeniu tego checkboxa możliwe jest logowanie operatora  przez domenę (zob. Domena)

 

– w tym polu możliwy jest wybór właściwej domeny z listy po zaznaczeniu parametru „Używaj domeny”

 

– w ramach tego pola możliwy jest wybór z listy określonej grupy z danej domeny

 

– pole dodane w wersji 2024.0.0; w ramach tego pola należy wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF;

 

– pole dodane w wersji 2024.0.0; w ramach tego pola należy wprowadzić token uwierzytelniający w KSeF

Istnieje możliwość wygenerowania tokenu KSeF z poziomu Comarch DMS. W tym celu należy kliknąć w link [Wygeneruj token] znajdujący się obok pola „Token KSeF”, a następnie w oknie „Wybierz certyfikat” wybrać odpowiedni certyfikat uwierzytelniający. Po wyborze certyfikatu zostanie wygenerowany token KSeF, który zostanie automatycznie wprowadzony w ramach pola „Token KSeF”.

 

Uwaga

W wersji 2024.0.1 w pliku Web.config w folderze aplikacji serwerowej (dawnej web) dodano klucz add key=”KSeFWorkMode” value=”Demo” /> – klucz umozliwia określenie, czy Firma testuje funkcjonalność wysyłania faktur do KSeF, czy korzysta z niej produkcyjnie.

Klucz może przybierać jedną z następujących wartości:

1.Demowartość domyślna; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo;

2.Production – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu;

3.Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym.

W kwestii różnic pomiędzy powyższymi trybami zob. Przełączanie trybu pracy z KSeF

 

Uwaga
Aby wygenerować token konieczne jest zainstalowanie kwalifikowanego podpisu/pieczęci, za pomocą którego możliwe jest uwierzytelnienie się na stronach ministerstwa.

 

Wybór certyfikatu po kliknięciu w link „Wygeneruj token”

Aby wygenerować token uwierzytelniający, należy najpierw uzupełnić pole „NIP Firmy”. Jeżeli użytkownik nie uzupełni pola „NIP Firmy” i naciśnie link [Wygeneruj token], wówczas zostanie wyświetlony następujący komunikat:

Komunikat wyświetlany, jeśli nie wpisano numeru NIP w polu „NIP Firmy”, ale naciśnięto link „Wygeneruj token”

 

W dolnej części ekranu w osobnej sekcji definiowane są ustawienia konfiguracyjne wspólne dla wszystkich spółek. Oznacza to, że wszystkie bazy systemu Comarch ERP XL powinny pracować na tej samej wersji API.

Ustawienie wartości „Tak” dla właściwości „Generowanie dokumentów z opisem analitycznym” umożliwia pracę z kontrolką typu Dokument ERP XL w każdej ze spółek.

 

– lista wyboru wersji API

 

– lista, w której określany jest tryb pracy aplikacji w zakresie kontrolki typu Dokument ERP XL

 

 

Wprowadzone dane należy zapisać, używając przycisku dyskietki zapisz32 [Zapisz].

 

Przykładowe okno z właściwościami dodanej spółki




Serwer pocztowy

Informacje ogólne

Zakładka „Serwer pocztowy” służy do zdefiniowania domyślnego konta pocztowego, z którego wysyłane są powiadomienia typu: przekazanie dokumentu (zob. Właściwości etapu – zakładka Mail), przypomnienia o przeterminowanych dokumentach (zob. Dokumenty przeterminowane), itp.

 

W wersji 2022.0.3 dla Comarch DMS, który pracuje na bazie MSSQL, udostępniono komponent MailKit. Administrator systemu może dokonać wyboru pomiędzy:

  • Wysyłaniem wiadomości email przez serwer SQL
  • Wysyłaniem wiadomości email przez MailKit

 

MailKit to samodzielny komponent, który znajduje się na serwerze IIS i współpracuje z bazą danych. Umożliwia wysyłanie wiadomości email razem z załącznikami, w przeciwieństwie do profilu mailowego na MSSQL.

Jeśli do wysyłania maili został wybrany MailKit, wówczas procedura SendMail nie wysyła wiadomości, a tylko zapisuje dane do tabeli, z której MailKit pobiera i wysyła wiadomości email. Komponent MailKit sprawdza obecność w tabelach ProcessMails oraz ProcessMailsAttachment wiadomości i załączników, które nie zostały wysłane.

 

W wersji 2022.0.3 w zakładce Serwer pocztowy dodano pole Do wysyłania wiadomości email zastosuj z dwiema dostępnymi opcjami:

  • Profil na serwerze SQL
  • Komponent mailowy na serwerze IIS

 

Wybór opcji w ramach pola „Do wysyłania wiadomości email zastosuj”

 

Zakładka „Serwer pocztowy”  (w zależności od opcji wybranej w polu „Do wysyłania wiadomości zastosuj”) składa się z dwóch lub trzech sekcji.

Jeśli  w polu „Do wysyłania wiadomości zastosuj” wybrano opcję „Profil na serwerze SQL”, wówczas w ramach zakładki dostępne są trzy sekcje:

  • Profil na serwerze SQL
  • Ustawienia konta pocztowego
  • Wyślij testową wiadomość email

 

Jeśli natomiast w polu „Do wysyłania wiadomości zastosuj” wybrano opcję „Komponent mailowy na serwerze IIS”, wówczas w ramach zakładki dostępne są dwie sekcje:

  • Ustawienia konta pocztowego
  • Wyślij testową wiadomość email

 

 

Profil na serwerze SQL

 

Wybrana opcja „Profil na serwerze SQL”

 

Aby możliwe było wysyłanie maili, należy zapisać  dane wprowadzone w sekcji Ustawienia konta pocztowego za pomocą przycisku  zapisz32 [Zapisz].

Po kliknięciu w przycisk wyświetlone zostanie okno, w którym należy uzupełnić:

  • w polu „Login” – login administratora serwera – login, za pomocą którego administrator loguje się do bazy SQL
  • w polu „Hasło” – hasło administratora serwera – hasło, za pomocą którego administrator loguje się do bazy SQL

i kliknąć przycisk „Ok„. Zostaną wówczas zapisane profil oraz ustawienia konta pocztowego na serwerze SQL.

 

Uwaga
Aby móc korzystać z konta Office365 w Comarch DMS do wysyłania powiadomień mailowych, konieczne jest, żeby w polu „Do wysyłania wiadomości email zastosuj” wybrać opcję „Komponent mailowy na serwerze IIS”.

Nie jest możliwe korzystanie z konta Office365, jeśli wybrano opcję „Profil na serwerze SQL”.

 

Wprowadzanie danych do zapisania konta pocztowego na serwerze SQL

 

Jeżeli wprowadzono błędne dane, wyświetlany jest następujący komunikat:

 

Komunikat o błędnych danych logowania do Serwera MS SQL

 

W takim przypadku należy kliknąć „Ok” w oknie komunikatu, znów wybrać przycisk zapisz32[Zapisz]poprawić błędne dane i ponownie nacisnąć „Ok„. Jeżeli dane są poprawne, zostanie wyświetlony następujący komunikat:

 

Komunikat wyświetlany,. gdy poprawnie uzupełniono login i hasło, a następnie wybrano „Ok”

 

Jeżeli operator chce usunąć profil i ustawienia konta pocztowego, wówczas powinien kliknąć na ikonę [Usuń] i w otwartym oknie uzupełnić:

  • w polu „Login” – login administratora serwera – login, za pomocą którego administrator loguje się do bazy SQL
  • w polu „Hasło” – hasło administratora serwera – hasło, za pomocą którego administrator loguje się do bazy SQL

i kliknąć przycisk „Ok”. Zostaną wówczas usunięte: profil oraz ustawienia konta pocztowego na serwerze SQL.

 

Wprowadzanie danych do usunięcia konta pocztowego na serwerze SQL

 

Jeżeli wprowadzone dane są poprawne, zostanie wyświetlony następujący komunikat:

 

Komunikat wyświetlany,. gdy poprawnie uzupełniono login i hasło, a następnie wybrano „Ok”

 

W wersji 2022.0.3 w ramach okien, które są wyświetlane w zakładce „Ustawienia” w zakładce „Serwer pocztowy” po wyborze opcji „Profil na serwerze SQL” i po kliknięciu ikony zapisz32 [Zapisz] lub  [Usuń], dodano przycisk  [Anuluj].

 

Sekcja „Profil na serwerze SQL”

W sekcji znajdują się następujące parametry:

    • Nazwanazwa profilu serwera SQL obsługującego operacje wysyłania maili. Dane bez możliwości edycji.
    • Opisdodatkowy opis profilu. Dane bez możliwości edycji.  Jeżeli prawidłowo zapisano profil, pod tym polem powinien znajdować się napis „Profil istnieje”- zmiana może być widoczna dopiero po wyjściu z zakładki „Ustawienia” i powrocie na nią 

 

Sekcja „Profil na serwerze SQL”

 

Uwaga

W wersji 2022.0.3 w obrębie zakładki Ustawienia, Serwer pocztowy nastąpiło przeniesienie opcji Włącz wysyłanie wiadomości email z sekcji Profil na serwerze SQL do sekcji Ustawienia konta pocztowego.

 

Parametr “Włącz wysyłanie wiadomości email” w sekcji “Ustawienia konta pocztowego”

 

 

Sekcja „Ustawienia konta pocztowego”

W sekcji znajdują się następujące parametry:

    • Włącz wysyłanie wiadomości email – parametr aktywujący funkcjonalność wysyłania maili – w tym celu użytkownik powinien wybrać opcję „Tak„.
    • Nazwa kontanazwa konta mailowego na serwerze pocztowym, np. Comarch DMS.
    • Email (wychodzący)adres mailowy skrzynki pocztowej, z której wychodzi korespondencja, np. urszulakowal@domena.com
    • Nazwa wyświetlananazwa konta mailowego, np. Comarch DMS – powiadomienia – nazwa jest widoczna w mailu jako nazwa nadawcy.
    • Adres zwrotnyopcjonalny adres mailowy, np. urszulakowal@domena.com – może być inny niż wychodzący.
    • Opisopis konta pocztowego.
    • Typ serwera – domyślnie SMTP – bez możliwości edycji.
    • Nazwa serweranazwa serwera pocztowego, np. smtp.domena.com.
    • Portport wykorzystywany przez protokół wysyłający maile, np. 587.
    • Logindane do logowania do skrzynki pocztowej.
    • Hasłohasło do logowania do skrzynki pocztowej.
    • SSLopcja szyfrowania maila: do wyboru opcja „Tak” lub „Nie”.

 

Sekcja „Ustawienia konta pocztowego”

 

Sekcja „Wyślij testową wiadomość email”

 

Sekcja „Wyślij testową wiadomość email”

 

W sekcji znajdują się następujące parametry:

    • Adres email odbiorcy – pole, w którym wpisuje się adres mailowy, na który ma trafić wiadomość testowa 
    • Temat – pole, w którym należy wpisać tekst, który ma się znajdować w rubryce „Temat” w wysłanej wiadomości
    • Treść wiadomości – w tym polu należy wpisać tekst, który ma stanowić treść wiadomości

 

Po uzupełnieniu danych należy kliknąć na przycisk [Wyślij wiadomość]. Mail zostanie wówczas wysłany i wyświetli się następujący komunikat:

 

Wiadomość wyświetlana po wysłaniu wiadomości testowej

 

Przykładowa wiadomość testowa

Przykładowa wiadomość testowaNadawca wpisał na zakładce Serwer pocztowy w Comarch DMS w sekcji Ustawienia konta pocztowego w polu Nazwa wyświetlana - Nazwa maila, a w sekcji Wyślij testową wiadomość email w polu Temat - Próba, zaś w polu Treść wiadomości - Próbna wiadomość email

 

Uwaga
Aby wiadomość testowa została wysłana, konieczne jest:

  •  poprawne wypełnienie pól w sekcji „Ustawienia konta pocztowego”
  • zapisanie profilu i ustawień konta pocztowego na serwerze SQL za pomocą przycisku zapisz32 [Zapisz](zob. powyżej)
  • wpisanie adresu email oraz tematu maila w sekcji „Wyślij testową wiadomość email”

 

Komponent mailowy na serwerze IIS

Jeżeli natomiast operator wybrał Komponent mailowy na serwerze IIS, wtedy wiadomości email są wysyłane za pomocą komponentu MailKit. Dzięki niemu możliwe jest wysyłanie maili razem z załącznikami.

Jeśli wybrano opcję Komponent mailowy na serwerze IIS, sekcja Profil na serwerze SQL nie jest wyświetlana, brak również przycisku [Kosz] – nie jest on istotny dla serwera IIS.

 

Wybór opcji „Komponent mailowy na serwerze IIS”

 

Kiedy wybrano opcję Komponent mailowy na serwerze IIS, wówczas operator powinien:

  • Uzupełnić dane w ramach sekcji Ustawienia konta pocztowego
  • Kliknąć w ikonę zapisz32 [Zapisz], aby zapisać ustawienia – w odróżnieniu od wcześniejszych wersji oraz od opcji  Profil na serwerze SQL nie zostaje wtedy wyświetlone okno do wpisywania danych logowania do bazy MSSQL ani nie pojawia się napis Konto istnieje.
  • Po wyborze przycisku  zapisz32[Zapisz] zostaje wyświetlony następujący komunikat informujący o zapisaniu danych:

 

Informacja o zapisaniu danych

 

Sekcja „Ustawienia konta pocztowego”

W sekcji znajdują się następujące parametry:

  • Włącz wysyłanie wiadomości emailparametr aktywujący funkcjonalność wysyłania maili – w tym celu użytkownik powinien wybrać opcję „Tak„.
  • Nazwa kontanazwa konta mailowego na serwerze pocztowym, np. Comarch DMS.
  • Email (wychodzący)adres mailowy skrzynki pocztowej, z której wychodzi korespondencja, np. urszulakowal@domena.com
  • Nazwa wyświetlananazwa konta mailowego, np. Comarch DMS – powiadomienia – nazwa jest widoczna w mailu jako nazwa nadawcy.
  • Adres zwrotnyopcjonalny adres mailowy, np. urszulakowal@domena.com – może być inny niż wychodzący.
  • Opisopis konta pocztowego.
  • Typ serwera – domyślnie SMTP – bez możliwości edycji
  • Nazwa serweranazwa serwera pocztowego, np. smtp.domena.com.
  • Portport wykorzystywany przez protokół wysyłający maile, np. 587.
  • Metoda szyfrowania – w wersji 2022.0.3 wprowadzono zmianę w sekcji Ustawienia konta pocztowego po wyborze opcji Komponent mailowy na serwerze IIS – zamiast pola SSL udostępniono pole, w ramach którego możliwy jest wybór odpowiedniej metody szyfrowania wiadomości mailowych. Domyślną wartością jest „Brak”.
  • Metoda uwierzytelniania – pole dodane w wersji 2022.0.4 w celu umożliwienia obsługi kont pocztowych Office 365; w ramach tego pola można wybrać jedną z dwóch opcji:
    • Login i hasło – dla skrzynek pocztowych, które nie są w usłudze Microsoft Office 365
    • OAuth2 – dla kont pocztowych w usłudze Microsoft Office 365
  • Login login użytkownika do logowania do skrzynki pocztowej
  • Hasło hasło użytkownika do skrzynki pocztowej (pole dostępne, jeśli w polu „Metoda uwierzytelniania” wybrano opcję „Login i hasło”).

 

Ustawienia konta pocztowego dla opcji „Komponent mailowy na serwerze IIS”- wybór metody szyfrowania

 

Jeśli w polu „Metoda uwierzytelniania” wybrano opcję „Login i hasło”, wówczas w polach „Login” i „Hasło” należy wpisać login oraz hasło użytkownika skrzynki pocztowej.

 

Ustawienia serwera pocztowego – zakładka „Serwer pocztowy”, gdy w polu „Metoda uwierzytelniania” wybrano opcję „Login i hasło”

 

Jeśli natomiast w polu „Metoda uwierzytelniania” wybrano opcję „OAuth2”, wówczas pod polem „Login” pojawia się przycisk [Autoryzacja], który należy nacisnąć po poprawnym uzupełnieniu pozostałych pól.

 

Ustawienia serwera pocztowego – zakładka „Serwer pocztowy”, gdy w polu „Metoda uwierzytelniania” wybrano opcję „OAuth2”

 

Wówczas zostanie otwarta domyślna przeglądarka w systemie Windows, z oknem logowania do usługi office 365. W oknie należy uzupełnić hasło i nacisnąć przycisk „Zaloguj”.

 

Przykładowe okno logowania do usługi Office 365

 

Jeżeli użytkownik nie przyznał wcześniej uprawnień do pracy z Comarch DMS dla danego konta pocztowego (np. w punkcie konfiguracyjnym ACD współpracującym ze skrzynką pocztową), wtedy w ramach przeglądarki zostaje otwarte okno, w którym należy wyrazić zgodę na dostęp aplikacji Comarch DMS do skrzynki pocztowej.

Aby możliwe było korzystanie ze skrzynki pocztowej w ramach usługi Office 365 należy wybrać przycisk „Tak”.

 

Okno zgody na dostęp Comarch DMS do skrzynki pocztowej

 

Wówczas w przeglądarce zostaje wyświetlone okno informujące o zalogowaniu. Jeśli uprawnienia dla Comarch DMS były już wcześniej przyznane, przejście do tego ekranu następuje bezpośrednio po logowaniu.

 

Okno informujące o zalogowaniu

 

Jeżeli autoryzacja przebiegła pomyślnie, wówczas po zamknięciu okna przeglądarki w aplikacji Comarch DMS zostaje wyświetlony komunikat „Zalogowano użytkownika [login użytkownika poczty]”.

 

Przykładowy komunikat wyświetlany, gdy autoryzacja przebiegła pomyślnie

 

Kiedy użytkownik zostanie zalogowany, autoryzacja w usłudze Office 365 będzie wykonywana za pomocą tokenów, które będą przekazywane przez API.

 

Uwaga
Jeśli tokeny wygasną, może być konieczne ponowne zalogowanie się użytkownika w usłudze Office 365, aby móc znów korzystać z autoryzacji z zastosowaniem tokenów.

 

Jeżeli logowanie do konta pocztowego zakończy się niepowodzeniem, w oknie ustawień serwera pocztowego w Comarch DMS zostanie wyświetlony komunikat: „Nie udało się zalogować do konta użytkownika [login użytkownika poczty]”.

 

Przykładowy komunikat wyświetlany, jeśli próba logowania do usługi Office 365 zakończy się niepowodzeniem

 

 

Sekcja „Wyślij testową wiadomość email”

 

Sekcja „Wyślij testową wiadomość email”

 

W sekcji znajdują się następujące parametry:

        • Adres email odbiorcy – pole, w którym wpisuje się adres mailowy, na który ma trafić wiadomości testowa
        • Temat – pole, w którym należy wpisać tekst, który ma się znajdować w rubryce „Temat” w wysłanej wiadomości
        • Treść wiadomości – w tym polu należy wpisać tekst, który ma stanowić treść wiadomości
        • Załącznik – od wersji 2022.0.3 po wyborze opcji Komponent mailowy na serwerze IIS w sekcji Wyślij testową wiadomość email możliwe jest dodanie załącznika do wiadomości – w tym celu należy kliknąć w znak „+” i wybrać plik ze skanu lub z dysku.

 

Wybór załącznika do wiadomości testowej

 

Po uzupełnieniu danych należy kliknąć na przycisk [Wyślij wiadomość]. Mail zostanie wówczas wysłany i wyświetli się następujący komunikat:

 

Wiadomość wyświetlana po wysłaniu wiadomości testowej

 

Przykładowa wiadomość testowa

Przykładowa wiadomość testowaNadawca wpisał na zakładce Serwer pocztowy w Comarch DMS w sekcji Ustawienia konta pocztowego w polu Nazwa wyświetlana - Nazwa maila, a w sekcji Wyślij testową wiadomość email w polu Temat - Próba, zaś w polu Treść wiadomości - Próba. Dodał także załącznik, klikając + w polu Załącznik i wybierając plik z dysku.

 

Wskazówka
Błędy występujące podczas wysyłania wiadomości email oraz załączników są zapisywane do tabeli DF_WorkLogEntries.

 

Parametr DeleteMailsAfterSending – możliwość usuwania lub zachowania wiadomości po ich wysłaniu

W wersji 2022.0.3 w ramach pliku web.config został dodany parametr <DeleteMailsAfterSending>. W tym parametrze operator powinien określić, co powinno dziać się z wiadomościami email po ich wysłaniu .

 

Parametr „DeleteMailsAfterSending”

 

Jeśli:

      • <add key = „DeleteMailsAfterSending” value=”True” />– wówczas zarówno maile, jak i załączniki zostają usunięte po wysłaniu
      • <add key = „DeleteMailsAfterSending” value=”False” />– wtedy zarówno maile, jak I załączniki zostają zarchiwizowane w tabelach po wysłaniu

 

Uwaga

Jeśli użytkownik po pewnym czasie zmieni wartość w kluczu z „False” na „True”, w takim przypadku:

      • wiadomości email wysłane przed dokonaniem zmiany pozostają zarchiwizowane w tabeli
      • wiadomości email wysłane po dokonaniu zmiany są usuwane

 




Przykłady konfiguracji poczty


Spis treści artykułu

 

Poczta WP

Informacje potrzebne do poprawnej konfiguracji można znaleźć na stronie https://pomoc.wp.pl/jak-skonfigurowac-program-pocztowy

 

Uwaga
W razie wątpliwości w polu „Metoda szyfrowania” należy wybrać opcję „Automatyczne”.

 

Informacje potrzebne do poprawnej konfiguracji Poczty WP

 

Przyklad

Użytkownik Jan Kowalski posiada konto pocztowe na portalu wp.pl.

Jego adres email to jankowalski@wp.pl, login to jankowalski, a hasło do poczty brzmi Konwalia369!.

Użytkownik Jan Kowalski chce, aby z tego konta pocztowego można było wysyłać powiadomienia z Comarch DMS.

W tym celu loguje się do aplikacji Comarch DMS, klika na zakładkę [Ustawienia], a następnie na zakładkę „Serwer pocztowy” i na sekcję „Ustawienia konta pocztowego”. Następnie uzupełnia pola znajdujące się w tej sekcji w następujący sposób:

  • Włącz wysyłanie wiadomości email – użytkownik wybiera „Tak”;
  • Nazwa konta – użytkownik wpisuje Comarch DMS;
  • Email (wychodzący) – użytkownik wpisuje swój adres email: jankowalski@wp.pl;
  • Nazwa wyświetlana – użytkownik wpisuje Comarch DMS – powiadomienia;
  • Adres zwrotny – użytkownik wpisuje swój adres email: jankowalski@wp.pl;
  • Opis – użytkownik wpisuje Konto do wysyłania powiadomień Comarch DMS;
  • Typ serwera – użytkownik pomija pole – nie można go edytować;
  • Nazwa serwera – użytkownik wpisuje smtp.wp.pl;
  • Port – użytkownik wpisuje 587;
  • Metoda szyfrowania – użytkownik wybiera „Automatyczne”;
  • Metoda uwierzytelniania – użytkownik wybiera opcję „Login i hasło”
  • Login – użytkownik wpisuje jankowalski;
  • Hasło – użytkownik wpisuje Konwalia369!

 

Przykład uzupełnienia sekcji „Ustawienia konta pocztowego” dla konta pocztowego w ramach Poczty WP

 

Po uzupełnieniu pól Jan Kowalski zapisuje zmiany, klikając na ikonę dyskietki w lewej górnej części zakładki „Serwer pocztowy”.

 

Zapisywanie dokonanych zmian

 

Po wyborze przycisku  zapisz32 [Zapisz] zostaje wyświetlony następujący komunikat informujący o zapisaniu danych, w ramach którego Jan Kowalski naciska „Ok”. Okno zostaje zamknięte.

 

Informacja o zapisaniu danych

 

Następnie, chcąc sprawdzić, czy konfiguracja przebiegła pomyślnie, Jan Kowalski klika na sekcję „Wyślij testową wiadomość email” i wpisuje:

  • Adres email odbiorcy – swój adres email: jankowalski@wp.pl;
  • Temat – tekst Wiadomość testowa 1;
  • Treść wiadomości – tekst Wiadomość testowa – treść

oraz w ramach pola:

  • Załącznik – klika w znak „+” i dodaje z dysku przykładowy plik Faktura_zakupu_FZ4_23

 

Sekcja „Wyślij testową wiadomość email” z uzupełnionymi polami

 

Następnie Jan Kowalski naciska przycisk [Wyślij wiadomość]. Zostaje wyświetlony następujący komunikat:

 

Wiadomość wyświetlona po wysłaniu wiadomości testowej

 

Jan Kowalski naciska „Ok” i okno komunikatu zostaje zamknięte. Później sprawdza swoją pocztę email – wiadomość dotarła, a zatem konfiguracja przebiegła pomyślnie.

 

Odebrana wiadomość testowa w przykładowym programie pocztowym (Thunderbird)

 

Odebrana wiadomość testowa na koncie pocztowym na stronie poczta.wp.pl

Onet Poczta

Informacje potrzebne do poprawnej konfiguracji można znaleźć na stronie https://pomoc.poczta.onet.pl/baza-wiedzy/adresy-serwerow-potrzebne-do-konfiguracji/

 

Uwaga
W razie wątpliwości w polu „Metoda szyfrowania” należy wybrać opcję „Automatyczne”.

 

Informacje potrzebne do poprawnej konfiguracji poczty Onet

 

Przyklad

Użytkowniczka Anna Nowak posiada konto pocztowe na portalu onet.pl.

Jej adres email to annanowak@op.pl, login to annanowak@op.pl, a hasło do poczty brzmi Pierwiosnek479%.

Użytkowniczka Anna Nowak chce, aby z tego konta pocztowego można było wysyłać powiadomienia z Comarch DMS.

W tym celu loguje się do aplikacji Comarch DMS, klika na zakładkę [Ustawienia], a następnie na zakładkę „Serwer pocztowy” i na sekcję „Ustawienia konta pocztowego”. Następnie uzupełnia pola znajdujące się w tej sekcji w następujący sposób:

  • Włącz wysyłanie wiadomości email – użytkownik wybiera „Tak”;
  • Nazwa konta – użytkownik wpisuje Comarch DMS;
  • Email (wychodzący) – użytkownik wpisuje swój adres email: annanowak@op.pl;
  • Nazwa wyświetlana – użytkownik wpisuje Comarch DMS – powiadomienia;
  • Adres zwrotny – użytkownik wpisuje swój adres email: annanowak@op.pl;
  • Opis – użytkownik wpisuje Konto do wysyłania powiadomień Comarch DMS;
  • Typ serwera – użytkownik pomija pole – nie można go edytować;
  • Nazwa serwera – użytkownik wpisuje smtp.poczta.onet.pl;
  • Port – użytkownik wpisuje 465;
  • Metoda szyfrowania – użytkownik wybiera „Automatyczne”;
  • Metoda uwierzytelniania – użytkownik wybiera opcję „Login i hasło”
  • Login – użytkownik wpisuje annanowak@op.pl
  • Hasło – użytkownik wpisuje Pierwiosnek479%

 

Przykład uzupełnienia sekcji „Ustawienia konta pocztowego” dla konta pocztowego w ramach Poczty Onet

 

Po uzupełnieniu pól Anna Nowak zapisuje zmiany, klikając na ikonę dyskietki w lewej górnej części zakładki „Serwer pocztowy”.

 

Zapisywanie dokonanych zmian

 

Po wyborze przycisku  zapisz32 [Zapisz] zostaje wyświetlony następujący komunikat informujący o zapisaniu danych, w ramach którego Anna Nowak naciska „Ok”. Okno zostaje zamknięte.

 

Informacja o zapisaniu danych

 

Następnie, chcąc sprawdzić, czy konfiguracja przebiegła pomyślnie, Anna Nowak klika na sekcję „Wyślij testową wiadomość email” i wpisuje:

  • Adres email odbiorcy – swój adres email: annanowak@op.pl;
  • Temat – tekst Wiadomość próbna 1;
  • Treść wiadomości – tekst Wiadomość próbna-treść

oraz w ramach pola:

  • Załącznik – klika w znak „+” i dodaje z dysku przykładowy plik Faktura_zakupu_FZ-2_23_20230512_14-58-10

 

Sekcja „Wyślij testową wiadomość email” z uzupełnionymi polami

 

Następnie Anna Nowak naciska przycisk [Wyślij wiadomość]. Zostaje wyświetlony następujący komunikat:

 

Wiadomość wyświetlona po wysłaniu wiadomości testowej

 

Anna Nowak naciska „Ok” i okno komunikatu zostaje zamknięte. Później sprawdza swoją pocztę email – wiadomość dotarła, a zatem konfiguracja przebiegła pomyślnie.

 

Odebrana wiadomość testowa w przykładowym programie pocztowym (Thunderbird)

 

Odebrana wiadomość testowa na koncie pocztowym na stronie poczta.onet.pl

Poczta Google

Informacje potrzebne do poprawnej konfiguracji można znaleźć pod następującym linkiem: Wysyłanie e-maili z drukarki, skanera lub aplikacji – Administrator Google Workspace – Pomoc

 

Uwaga
W razie wątpliwości w polu „Metoda szyfrowania” należy wybrać opcję „Automatyczne”.

 

Uwaga
W celu poprawnego skonfigurowania poczty należy dodać aplikację DMS w ustawieniach konta Google, jak pokazano w poniższym przykładzie.

 

Informacje potrzebne do poprawnej konfiguracji poczty Gmail

 

Przyklad

Użytkowniczka Anna Nowa posiada konto pocztowe na portalu gmail.com.

Jej adres email to annanowa@gmail.com, login to annanowa@gmail.com, a hasło do poczty brzmi Lawenda458!.

Użytkowniczka Anna Nowa chce, aby z tego konta pocztowego można było wysyłać powiadomienia z Comarch DMS.

W tym celu najpierw loguje się na swoje konto na portalu gmail.com i kilka na przycisk z literą A (od jej imienia) znajdujący się w prawym górnym rogu okna.

 

Wybór przycisku w ramach okna poczty gmail w przeglądarce

 

Następnie Anna Nowa klika w przycisk „Zarządzaj kontem Google”.

 

Wybór przycisku „Zarządzaj kontem Google”

 

Następnie klika na zakładkę „Bezpieczeństwo”, a następnie w ramach sekcji „Sposób logowania się w Google” w polu „Weryfikacja dwuetapowa” naciska na strzałkę w prawo.

 

Wybór zakładki „Bezpieczeństwo” i strzałki w polu „Weryfikacja dwuetapowa”

 

W ramach wyświetlonego okna potwierdza swoją tożsamość, wpisując hasło Lawenda458! I klikając [Dalej].

 

Wybór przycisku „Dalej” po wpisaniu hasła do konta Gmail

 

Następnie przewija stronę w dół i klika w strzałkę w prawo na polu „Hasła do aplikacji”.

 

Wybór strzałki na polu „Hasła do aplikacji”

 

Następnie w ramach pola „Wybierz aplikację” wybiera opcję „Inna opcja (własna nazwa).

 

Wybór opcji „Inna opcja”

 

Następnie w ramach udostępnionego użytkownikowi pola wpisuje Comarch DMS i klika w przycisk Wygeneruj.

 

Wybór przycisku „Wygeneruj” po wpisaniu nazwy „Comarch DMS”

 

Wówczas zostaje otwarte okno z wygenerowanym 16 – cyfrowym hasłem dla aplikacji Comarch DMS. Anna kopiuje i zachowuje hasło – w tym przypadku hasło to pvlianprlvvrnrrn – i klika „Gotowe”.

 

Okno z wygenerowanym hasłem, które należy wykorzystać w aplikacji Comarch DMS

 

Następnie Anna Nowa loguje się do aplikacji Comarch DMS, klika na zakładkę [Ustawienia], a następnie na zakładkę „Serwer pocztowy” i na sekcję „Ustawienia konta pocztowego”. Następnie uzupełnia pola znajdujące się w tej sekcji w następujący sposób:

  • Włącz wysyłanie wiadomości email – użytkowniczka wybiera „Tak”;
  • Nazwa konta – użytkowniczka wpisuje Comarch DMS;
  • Email (wychodzący) – użytkowniczka wpisuje swój adres email: annanowa@gmail.com;
  • Nazwa wyświetlana – użytkowniczka wpisuje Comarch DMS – powiadomienia;
  • Adres zwrotny – użytkowniczka wpisuje swój adres email: annanowa@gmail.com;
  • Opis – użytkowniczka wpisuje Konto do wysyłania powiadomień Comarch DMS;
  • Typ serwera – użytkowniczka pomija pole – nie można go edytować;
  • Nazwa serwera – użytkowniczka wpisuje smtp.gmail.com;
  • Port – użytkowniczka wpisuje 465;
  • Metoda szyfrowania – użytkownik wybiera „Automatyczne”;
  • Metoda uwierzytelniania – użytkownik wybiera opcję „Login i hasło”
  • Login – użytkowniczka wpisuje annanowa@gmail.com
  • Hasło – użytkowniczka wkleja wygenerowane na koncie Google 16-cyfrowe hasłopvlianprlvvrnrrn

 

Przykład uzupełnienia sekcji „Ustawienia konta pocztowego” dla konta pocztowego w ramach Poczty Google

 

Po uzupełnieniu pól Anna Nowa zapisuje zmiany, klikając na ikonę dyskietki w lewej górnej części zakładki „Serwer pocztowy”.

 

Zapisywanie dokonanych zmian

 

Po wyborze przycisku  zapisz32 [Zapisz] zostaje wyświetlony następujący komunikat informujący o zapisaniu danych, w ramach którego Anna Nowa naciska „Ok”. Okno zostaje zamknięte.

 

Informacja o zapisaniu danych

 

Następnie, chcąc sprawdzić, czy konfiguracja przebiegła pomyślnie, Anna Nowa klika na sekcję „Wyślij testową wiadomość email” i wpisuje:

  • Adres email odbiorcy – swój adres email: annanowa@gmail.com;
  • Temat – tekst Wiadomość -test;
  • Treść wiadomości – tekst Wiadomość-test

oraz w ramach pola:

  • Załącznik – klika w znak „+” i dodaje z dysku przykładowy plik 106144FS320knt2023_2023

 

Sekcja „Wyślij testową wiadomość email” z uzupełnionymi polami

 

Następnie Anna Nowa naciska przycisk [Wyślij wiadomość]. Zostaje wyświetlony następujący komunikat:

 

Wiadomość wyświetlona po wysłaniu wiadomości testowej

 

Anna Nowa naciska „Ok” i okno komunikatu zostaje zamknięte. Później sprawdza swoją pocztę email – wiadomość dotarła, a zatem konfiguracja przebiegła pomyślnie.

 

Odebrana wiadomość testowa w przykładowym programie pocztowym (Thunderbird)

 

Odebrana wiadomość testowa na koncie pocztowym na stronie mail.google.com




EMAIL

 

Informacje ogólne

Zakładka oferuje możliwość zdefiniowania wzorców maila.

Wzorce maili są wykorzystywane w funkcjonalności wysyłania powiadomień, którą operator może ustawić w ustawieniach danego obiegu, na wybranym etapie, w zakładce „Mail” (zob. Właściwości etapu – zakładka Mail).

 

Uwaga
Aby mozliwe było wysyłanie maili do użytkowników, konieczne jest, aby oprócz włączenia funkcjonalności wysyłania powiadomień administrator poprawnie uzupełnił i zapisał pola w zakładce „Serwer pocztowy” (zob. Serwer pocztowy).

 

Zgodnie z rodzajami dostępnych powiadomień mailowych,  zakładka „Email” składa się z 6 predefiniowanych szablonów wiadomości e-mail:

  • Otrzymany dokument każdorazowo
  • Otrzymany dokument zbiorczo
  • Przeterminowany dokument
  • Przypominający
  • Dla obserwatora każdorazowo
  • Dla obserwatora zbiorczo

 

Nad  listą wzorców znajduje się przycisk zapisz32 [Zapisz], służący do zapisu wprowadzonych lub zmodyfikowanych danych.

Pod przyciskiem „Zapisz” dostępne jest pole URL Prefix, w którym należy zdefiniować adres URL na potrzeby maski {WebDocumentUrl}.

 

Uwaga
Poprawny zapis adresu URL w polu „URL Prefix” jest konieczny dla poprawnego przeniesienia odbiorcy maila do dokumentu w aplikacji serwerowej Comarch DMS (dawna web) po kliknięciu w numer dokumentu w wiadomości mailowej.

 

W ramach każdego z szablonów dostepne są dwa pola:

  • Temat maila – temat maila wysyłanego do operatora,
  • Treść maila – treść maila wysyłanego do operatora

 

Nazwa nadawcy maila jest zależna od treści znajdującej się w polu „Nazwa wyświetlana” w zakładce „Serwer pocztowy” (zob. Serwer pocztowy).

 

Okno szablonu wiadomości e-mail

 

Wzorzec „Otrzymany dokument każdorazowo”

Wzorzec wykorzystywany w wiadomości email, jeśli w definicji danego typu obiegu w ramach zakładki „Schemat obiegu„, po kliknięciu zakładki  „Mail” na danym etapie w sekcji „E-mail do uprawnionego operatora” zaznaczono parametry: „Wyślij e-mail do osób powiązanych z etapem”  i „każdorazowo po przekazaniu dokumentu„.

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego operatora każdorazowo po przekazaniu dokumentów

 

W szablonie stosowane są maski, dzięki którym możliwe jest wstawienie w treści maila określonych danych:

  • {Origin} powód, dla którego dokument trafił do danego operatora (źródło) – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Źródło” (zob. Właściwości etapu – zakładka Ogólne),
  • {Proceeding}wytyczne dla operatora dotyczące realizacji etapu – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Postępowanie” (zob. Właściwości etapu – zakładka Ogólne),
  • {WebDocumentUrl}link URL do szczegółów danego dokumentu aplikacji serwerowej (dawna web),
  • {DocumentNumber}numer danego dokumentu,
  • {WorkflowName}nazwa danego typu obiegu,
  • {StageName}nazwa danego etapu, w którym znajduje się dany dokument

 

Wzorzec maila „Otrzymany dokument każdorazowo” – zaznaczono maski

 

Pola „Żródło” i Postępowanie” w ramach schematu obiegu – przykład

 

Wiadomość email – z informacjami pochodzącymi z przykładowego uzupełnienia pól : „Źródło” i”Postępowanie” na poprzedniej ilustracji

 

Istnieje możliwość wprowadzania modyfikacji w treści maila w stosunku do pierwotnego wzorca – poniżej pokazano, która część tekstu we wzorcu odpowiada której części tekstu w wiadomości mailowej. Wprowadzone zmiany należy zapisać za pomocą przycisku zapisz32 [Zapisz].

 

Wzorzec maila „Otrzymany dokument każdorazowo” z zaznaczonymi fragmentami tekstu, które mozna zmodyfikować

 

Mail wysłany do operatora – numery nad zaznaczonymi fragmentami tekstu odpowiadają tak samo oznaczonym fragmentom tekstu ze wzorca na poprzedniej ilustracji

 

Wprowadzanie zmian we wzorcu maila  „Otrzymany dokument każdorazowo” i zapisywanie zmian

 

Mail wysłany do operatora, po dokonaniu powyższych zmian

 

Wzorzec „Otrzymany dokument zbiorczo”

Wzorzec wykorzystywany w wiadomości email, jeśli w definicji danego typu obiegu w ramach zakładki „Schemat obiegu„, po kliknięciu zakładki  „Mail” na danym etapie w sekcji „E-mail do uprawnionego operatora” zaznaczono parametry: „Wyślij e-mail do osób powiązanych z etapem”  i  ” co [liczba] dzień” lub „w [dzień tygodnia] o godzinie [godzina] „.

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego operatora zbiorczo co określoną liczbę dni

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego operatora zbiorczo w określonym dniu tygodnia

 

W szablonie stosowane są maski, dzięki którym możliwe jest wstawienie w treści maila określonych danych:

  • {WorkflowName}nazwa danego typu obiegu
  • {StageName}nazwa danego etapu, w którym znajduje się dany dokument
  • {Origin}powód, dla którego dokumenty trafiły do danego operatora (źródło) – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Źródło” (zob. Właściwości etapu – zakładka Ogólne i powyżej w podpunkcie Wzorzec „Otrzymany dokument każdorazowo”),
  • {Proceeding}wytyczne dla operatora dotyczące realizacji etapu – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Postępowanie” (zob. Właściwości etapu – zakładka Ogólne i powyżej w podpunkcie Wzorzec „Otrzymany dokument każdorazowo”)
  • {WebDocumentUrl}link URL do szczegółów danego dokumentu w aplikacji serwerowej (dawna web),
  • {DocumentNumber}numer danego dokumentu
  • {PropagationDate}data przekazania danego dokumentu

 

Wzorzec maila „Otrzymany dokument zbiorczo” – zaznaczono maski

 

Istnieje możliwość wprowadzania modyfikacji w treści maila w stosunku do pierwotnego wzorca – poniżej zaznaczono,  w których częściach tekstu we wzorcu można dokonać modyfikacji. Wprowadzone zmiany należy zapisać za pomocą przycisku zapisz32 [Zapisz].

 

Elementy tekstu możliwe do zmiany we wzorcu „Otrzymany dokument zbiorczo”

 

Wzorzec „Przeterminowany dokument”

Wzorzec wykorzystywany w wiadomości email, jeśli w definicji danego typu obiegu w ramach zakładki „Schemat obiegu„, po kliknięciu zakładki  „Mail” na danym etapie w sekcji „E-mail o zaległościach” zaznaczono parametry: „Wyślij e-mail o zaległościach”   i  ” co [liczba] dzień” lub „w [dzień tygodnia] o godzinie [godzina] „.

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego operatora co określoną liczbę dni

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego operatora  w określonym dniu tygodnia

 

W szablonie stosowane są maski, dzięki którym możliwe jest wstawienie w treści maila określonych danych:

  • {ExpiredDocumentsBegin}data przekazania dokumentu/dokumentów do etapu,
  • {WebDocumentUrl}link URL do szczegółów danego dokumentu w aplikacji serwerowej (dawna web),
  • {DocumentNumber}numer danego dokumentu
  • {ExpirationTime}czas przeterminowania etapu,
  • {ExpiredDocumentsEnd}data wyjścia z etapu.

 

Wzorzec maila „Przeterminowany dokument” – zaznaczono maski

 

Istnieje możliwość wprowadzania modyfikacji w treści maila w stosunku do pierwotnego wzorca – poniżej zaznaczono,  w których częściach tekstu we wzorcu można dokonać modyfikacji. Wprowadzone zmiany należy zapisać za pomocą przycisku zapisz32 [Zapisz].

 

Elementy tekstu możliwe do zmiany we wzorcu „Przeterminowany dokument”

 

Wzorzec „Przypominający”

Wzorzec wykorzystywany w wiadomości email, jeśli w definicji danego typu obiegu w ramach zakładki „Schemat obiegu„, po kliknięciu zakładki  „Mail” na danym etapie w sekcji „E-mail przypominający” zaznaczono parametry: „Wyślij e-mail przypominający”   i  ” co [liczba] dzień” lub „w [dzień tygodnia] o godzinie [godzina] „.

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego operatora co określoną liczbę dni

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego operatora w określonym dniu tygodnia

 

W szablonie stosowane są maski, dzięki którym możliwe jest wstawienie w treści maila określonych danych:

  • {ExpiredDocumentsBegin}data przekazania dokumentu/dokumentów do etapu,
  • {WebDocumentUrl} link URL do szczegółów danego dokumentu w aplikacji serwerowej (dawna web),
  • {DocumentNumber}numer danego dokumentu,
  • {ExpirationTime}czas przeterminowania etapu,
  • {ExpiredDocumentsEnd}data wyjścia z etapu.

 

Wzorzec maila „Przypominający” – zaznaczono maski

 

Istnieje możliwość wprowadzania modyfikacji w treści maila w stosunku do pierwotnego wzorca – poniżej zaznaczono,  w których częściach tekstu we wzorcu można dokonać modyfikacji. Wprowadzone zmiany należy zapisać za pomocą przycisku zapisz32 [Zapisz].

 

Elementy tekstu możliwe do zmiany we wzorcu „Przypominający”

 

Wzorzec „Dla obserwatora każdorazowo”

Wzorzec wykorzystywany w wiadomości email, jeśli w definicji danego typu obiegu w ramach zakładki „Schemat obiegu„, po kliknięciu zakładki  „Mail” na danym etapie w sekcji „E-mail do Obserwatora” zaznaczono parametry: „Wyślij e-mail do obserwatora”  i „każdorazowo po przekazaniu dokumentu„.

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego obserwatora każdorazowo po przekazaniu dokumentów

 

W szablonie stosowane są maski, dzięki którym możliwe jest wstawienie w treści maila określonych danych:

  • {Origin}powód, dla którego dokument trafił do danego operatora (źródło) – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Źródło” (zob. Właściwości etapu – zakładka Ogólne),
  • {Proceeding}wytyczne dla operatora dotyczące realizacji etapu – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Postępowanie” (zob. Właściwości etapu – zakładka Ogólne),
  • {WebDocumentUrl}link URL do szczegółów danego dokumentu w aplikacji serwerowej (dawna web),
  • {DocumentNumber}numer danego dokumentu,
  • {WorkflowName}nazwa danego typu obiegu,
  • {StageName}nazwa danego etapu, w którym znajduje się dany dokument

 

Wzorzec maila „Dla obserwatora każdorazowo” – zaznaczono maski

 

Istnieje możliwość wprowadzania modyfikacji w treści maila w stosunku do pierwotnego wzorca – poniżej zaznaczono,  w których częściach tekstu we wzorcu można dokonać modyfikacji. Wprowadzone zmiany należy zapisać za pomocą przycisku zapisz32 [Zapisz].

 

Elementy tekstu możliwe do zmiany we wzorcu „Dla obserwatora każdorazowo”

 

Przykładowy mail do obserwatora – pierwsza linijka tekstu została zmodyfikowana we wzorcu

 

Wzorzec „Dla obserwatora zbiorczo”

Wzorzec wykorzystywany w wiadomości email, jeśli w definicji danego typu obiegu w ramach zakładki „Schemat obiegu„, po kliknięciu zakładki  „Mail” na danym etapie w sekcji „E-mail do Obserwatora” zaznaczono parametry: „Wyślij e-mail do obserwatora”  i  ” co [liczba] dzień” lub „w [dzień tygodnia] o godzinie [godzina] „.

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego obserwatora co określoną liczbę dni

 

Parametry zaznaczane, jeśli mail ma być wysyłany do uprawnionego obserwatora zbiorczo w określonym dniu tygodnia

 

W szablonie stosowane są maski, dzięki którym możliwe jest wstawienie w treści maila określonych danych:

  • {WorkflowName}nazwa danego typu obiegu,
  • {StageName}nazwa danego etapu, w którym znajduje się dany dokument,
  • {Origin}powód, dla którego dokumenty trafiły do danego operatora (źródło) – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Źródło” (zob. Właściwości etapu – zakładka Ogólne i powyżej w podpunkcie Wzorzec „Otrzymany dokument każdorazowo”),
  • {Proceeding}wytyczne dla operatora dotyczące realizacji etapu – w tym miejscu w wiadomości mailowej znajduje się tekst, który wpisano w ramach definiowania schematu danego obiegu na danym etapie w  zakładce „Ogólne” w polu „Postępowanie” (zob. Właściwości etapu – zakładka Ogólne i powyżej w podpunkcie Wzorzec „Otrzymany dokument każdorazowo”),
  • {WebDocumentUrl}link URL do szczegółów danego dokumentu aplikacji serwerowej (dawna web),
  • {DocumentNumber}numer danego dokumentu,
  • {PropagationDate}data przekazania danego dokumentu

 

Wzorzec maila „Dla obserwatora zbiorczo” – zaznaczono maski

 

Istnieje możliwość wprowadzania modyfikacji w treści maila w stosunku do pierwotnego wzorca – poniżej zaznaczono,  w których częściach tekstu we wzorcu można dokonać modyfikacji. Wprowadzone zmiany należy zapisać za pomocą przycisku zapisz32 [Zapisz].

 

Elementy tekstu możliwe do zmiany we wzorcu „Dla obserwatora zbiorczo”




Domena

 

ZakładkaDomena” jest widoczna w ustawieniach aplikacji Comarch DMS tylko w trybie jednofirmowymw trybie wielofirmowym pola pełniące analogiczną funkcję znajdują się w definicji danej spółki na zakładce „Połączenia z ERP” (zob. Połączenia z ERP).

Wypełnienie pól na zakładce „Domena” umożliwia wybranym operatorom logowanie się do Comarch DMS poprzez daną domenę.

 

Zakładka „Domena” w Comarch DMS Standalone

 

Zakładka „Domena” w Comarch DMS we współpracy z Comarch ERP (tutaj we współpracy z Comarch ERP Optima)

 

Aby możliwe było logowanie się za pomocą domeny, należy zaznaczyć checkbox „Używaj domeny”.

Następnie w ramach pola „Nazwa domeny” należy wybrać nazwę odpowiedniej domeny z rozwijanej listy.

Po wybraniu domeny konieczne jest również dokonanie wyboru grupy, w ramach której ma nastąpić logowanie. Jeżeli administrator nie chce dokonać zawężenia do jednej grupy, może wybrać opcję „Wszystkie”, znajdującą się na szczycie listy.

 

Wybór grupy w ramach danej domeny

 

Wprowadzone zmiany należy zapisać, klikając w ikonę zapisz32 [Zapisz]. Gdy dokonano zapisu, zostanie wyświetlony nastepujący komunikat:

 

Komunikat wyświetlany po zapisaniu ustawień  w zakladce „Domena”

 

Aby ustawić logowanie domenowe dla wybranego operatora administrator powinien następnie:

1. Przejść na zakładkę „Struktura organizacyjna

2. Wybrać kartę danego pracownika

3. W sekcji „Ogólne” zaznaczyć checkbox w polu „Logowanie domenowe„.

4. Po zaznaczeniu checkboxa kliknąć w znajdujący się obok link „Ustaw”, a następnie w ramach pola „Lista członków domeny [nazwa członków domeny]” wpisać frazę pochodzącą z nazwy osoby, która należy do danej domeny i której dane domenowe mają zostać powiązane z danym pracownikiem.

Z wyświetlonej listy należy wybrać odpowiednią pozycję i nacisnąć przycisk [Zapisz].

 

Wybór członka domeny z listy po wpisaniu frazy pochodzącej z nazwy osoby należącej do domeny

 

Na karcie pracownika na zakładce „Ogólne”  automatycznie wprowadzone zostają :

  • w polu „Login” – wybrany login do domeny
  • w polu „Imię i nazwisko” – imię i nazwisko przypisane w ramach domeny
  • w polu „Email” – adres email związany z domeną
  • w polu „Hasło” (niewidoczne) – hasło do domeny

 

Powyższe pola nie mogą zostać edytowane do czasu odznaczenia parametru „Logowanie domenowe” na karcie pracownika.

 

Uwaga
Aby wprowadzone zmiany (zarówno włączenie, jak i wyłączenie logowania domenowego) zostały zachowane, przed opuszczeniem karty pracownika należy zapisać zmiany za pomocą ikony zapisz32 [Zapisz].

 

Uwaga
W hasłach do domeny nie należy używać polskich znaków diakrytycznych.

 

Karta pracownika, sekcja „Ogólne” po ustawieniu logowania domenowego

 

Od tej pory dany operator może logować się do Comarch DMS za pomocą tego samego loginu i hasła, jakiego używa do logowania się do danej domeny.

 

Uwaga
Jeśli:

  • operator, którego zaimportowano z Comarch ERP XL, korzysta z logowania domenowego

oraz

  • na definicji operatora w zakladce Uprawnienia,  w sekcji Uprawnienia ogólne, w ramach pola Zastosuj login ERP wybrano opcję Z konfiguracji

 

w takim przypadku podczas logowania do systemu Comarch ERP XL operator zaloguje się do Comarch ERP XL na konto domenowe (pomimo ustawienia Zastosuj login ERP z konfiguracji).

 

Logowanie operatora przez domenę – przykład




Narzędzia

W  zakładce „Narzędzia” znajduje się sekcja „Ochrona danych osobowych„, w której dostępne są dwa pola:

 

W ramach sekcji administrator może dokonać anonimizacji wybranych pól karty obiegu  i wierszy  danych tabelarycznych we wskazanych obiegach, np. danych kontrahentów.

Konfiguracja anonimizacji danych odbywa się poprzez wskazanie typu obiegu dokumentów i kontrolek, w których dane zostaną zanonimizowane.

Opis  działania pól dostępnych w zakładce „Narzędzia” i funkcjonalności anonimizacji danych dostępny jest w dziale: Ochrona danych osobowych (RODO).

 

Zakładka „Narzędzia” w menu „Ustawienia”

 

Okno, które otwiera się po kliknięciu w link „Ustaw” w polu „Ustawienia konfiguracyjne”

 

Okno, które otwiera się po kliknięciu w link „Szukaj” w polu „Dane do anonimizacji”




API

W ramach zakładki API definiowana jest lista systemów, które współpracują z Comarch DMS przez API.

Jedynie nazwy współpracujących systemów są definiowane na tej zakładce i zapisywane w odrębnej tabeli razem z wygenerowanymi w DMS unikalnymi identyfikatorami zdefiniowanych systemów.

 

Wskazówka
W ramach tej zakładki można ustawić nazwę systemu  Comarch HRM, ktory ma współpracować z Comarch DMS przez API.

 

W wersji 2022.0.3 wprowadzone zostały zmiany w ramach sekcji „API” – na liście systemów współpracujących z Comarch DMS przez API znajduje się predefiniowana wartość „Comarch HRM”.

Podczas aktualizacji do wersji 2022.0.3 do tabeli do.DF_Applications zostaje dodany wpis „Comarch HRM” w kolumnie APP_Name. Taka predefiniowana wartość może zostać usunięta z poziomu aplikacji DMS desktop.

 

Predefiniowana wartość „Comarch HRM” na zakładce „API”

Jeżeli nastąpiła aktualizacja bazy z wersji 2022.0.1 albo 2022.0.2  i na liście systemów współpracujących z Comarch DMS przez API były już dodane pozycje, wówczas predefiniowana wartość „ Comarch HRM” zostaje dodana jako kolejna na liście.
Jeżeli pozycja „Comarch HRM” została już dodana, wtedy nie zostaje dodana ponownie po aktualizacji do wersji 2022.0.3.

 

Aby dodać nazwę tworzonej aplikacji należy:

1. Wybrać przycisk [Dodaj]

2. W nowootwartym oknie wpisać nazwę tworzonej aplikacji i zatwierdzić przyciskiem [Dodaj].

Przycisk jest nieaktywny do czasu wpisania co najmniej dwóch znaków.

 

Dodawanie nazwy systemu, dla którego będzie konfigurowana współpraca przez API

 

Po wyborze przycisku [Dodaj] nazwa, którą wpisano, zostaje wyświetlona na liście systemów. Zarówno predefiniowana, jak i wprowadzone nazwy systemów będą również widoczne na liście dostępnej w polu „System współpracujący” w zakładce „API” na karcie pracownika (zob. Zakładka API na karcie pracownika – integracja Comarch DMS z Comarch HRM).

 

Jeżeli natomiast użytkownik wybierze przycisk [Anuluj], wówczas nazwa systemu nie zostaje dodana do listy, a okno dodawania nazwy zostanie zamknięte.

 

Lista nazw systemów, które współpracują z Comarch DMS przez API

 

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!




Przechowywanie plików

W zakładce „Przechowywanie plików” operator może zalogować się na konto Comarch IBARD, na które mają trafiać dokumenty z kontrolek typu załącznik lub/i z Managera dokumentów/Repozytorium.

W przypadku współpracy z modułem Comarch DMS Repozytorium możliwe jest również wskazanie, w czyim imieniu mają być przekazywane do Repozytorium dokumenty dodane do kontrolek typu załącznik, dla których  ustawiono opcję operatora dodającego załącznik Z konfiguracji”.

 

Jeżeli współpraca z Comarch DMS Repozytorium jest włączona (w pliku web.config parametr „UseRepository” = true), a „DestinationAttachmentWorkflow” = IBARD, wówczas w sekcji „Kontrolki typu Załącznik” dostępne są dwa pola:

1. Repozytorium – w tym polu w ramach opcji Login domyślnego operatora repozytorium wybrany zostaje operator, w którego imieniu pozostali operatorzy mogą przesyłać pliki do Repozytorium, jeśli w definicji kontrolki typu Załącznik w polu „Zastosuj login operatora Repozytorium” wybrano opcję „Z konfiguracji” (zob. Konfiguracja kontrolki typu Załącznik w ramach integracji modułu Repozytorium z modułem Workflow).

Wybór operatora domyślnego jest dokonywany w ramach listy operatorów DMS, która została zawężona do operatorów mających uprawnienia do pracy z modułem Repozytorium.

Jeśli aktywny jest tryb wielospółkowy, operator zostaje wskazany z listy operatorów wybranej spółki.

Operatorzy na liście są uszeregowani w kolejności alfabetycznej. Możliwe jest wyświetlenie na liście maksymalnie 11 operatorów, przy większej liczbie pojawia się pasek przewijania.

Zmiana operatora domyślnego jest możliwa po usunięciu poprzedniego po kliknięciu ikony kosza i ponownym dokonaniu wyboru z listy.

 

Ustawianie operatora domyślnego dla Repozytorium

 

2. Comarch IBARD– po wyborze w ramach tego pola przycisku „Autoryzacja” zostaje wyświetlone okno, w którym należy uzupełnić login i hasło do konta Comarch IBARD, na które mają trafiać załączniki dodane za pomocą kontrolki typu załącznik, a następnie kliknąć [Zaloguj] .

Po zalogowaniu do usługi Comarch IBARD w ramach podsekcji Comarch IBARD w sekcji Kontrolki typu Załącznik wyświetlany jest login użytkownika w Comarch IBARD, a załączniki dodane za pomocą kontrolki typu załącznik trafiają do usługi Comarch IBARD.

 

Jeżeli dokumenty dodane za pomocą kontrolki typu załącznik w module Workflow mają trafić także do usługi Comarch IBARD, administrator powinien:

  • w pliku Web.config (domyślna lokalizacja: C:\inetpub\wwwroot\DMS) zmienić parametr „DestinationAttachmentWorkflow”, tak, aby „DestinationAttachmentWorkflow” = IBARD.
  •  w definicji danej kontrolki typu Załącznik w ramach zakładki „Archiwa”  w ramach pola „Nazwa spółki” wybrać opcję „Brak spółki – IBARD”.

 

Wybór opcji  „Brak spółki – IBARD” w definicji kontrolki typu Załącznik

 

Jeżeli „DestinationAttachmentWorkflow” nie jest równe „IBARD”, ale współpraca z modułem Comarch DMS Repozytorium jest włączona, wówczas w ekspanderze prezentowane będzie tylko pole Repozytorium.

 

Jeśli natomiast:

  • „DestinationAttachmentWorkflow” = „IBARD” i „DestinationAttachmentsRepository” = „IBARD”, ale współpraca z modułem Comarch DMS Repozytorium nie jest aktywna, wtedy w ramach zakładki „Przechowywanie plików” jest dostępna tylko jedna sekcja „Kontrolki typu Załącznik i Manager dokumentów”. W ramach tej sekcji mozliwe jest logowanie do usługi Comarch IBARD. Po wyborze w tej sekcji przycisku „Autoryzacja” zostaje wyświetlone okno, w którym należy uzupełnić login i hasło do konta Comarch IBARD, na które mają trafiać załączniki dodane za pomocą kontrolki typu załącznik oraz pliki dodane do managera dokumentów, a następnie kliknąć [Zaloguj] . Po zalogowaniu do usługi Comarch IBARD w ramach podsekcji Comarch IBARD w sekcji „Kontrolki typu Załącznik i Manager dokumentów” wyświetlany jest login użytkownika w Comarch IBARD, a załączniki dodane za pomocą kontrolki typu Załącznik oraz pliki dodane do Managera dokumentów trafiają do usługi Comarch IBARD.

 

Sekcja  „Kontrolki typu Załącznik i Manager dokumentów”

 

  • „DestinationAttachmentWorkflow”= „IBARD” i „DestinationAttachmentsRepository” = „DO”, ale współpraca z modułem Comarch DMS Repozytorium nie jest aktywna, wtedy w ramach zakładki „Przechowywanie plików” jest dostępna tylko jedna sekcja „Kontrolki typu Załącznik”, w ramach której można zalogować się do Comarch IBARD, aby do tej usługi trafiały pliki dodane w ramach kontrolki typu załącznik

 

Sekcja „Kontrolki typu Załącznik”

 

  • „DestinationAttachmentWorkflow” = „DO” i „DestinationAttachmentsRepository” = „IBARD”, ale współpraca z modułem Comarch DMS Repozytorium nie jest aktywna, wtedy w ramach zakładki „Przechowywanie plików” jest dostępna tylko jedna sekcja „Manager dokumentów”, w ramach której można zalogować się do Comarch IBARD, aby do tej usługi trafiały pliki dodane do Managera dokumentów

 

Sekcja „Manager dokumentów”

 

Jeżeli  współpraca z modułem Repozytorium jest aktywna (w pliku web.config parametr „UseRepository” = true), a pliki dodane do Repozytorium powinny trafiać również do usługi Comarch IBARD (zob. Przechowywanie plików z Repozytorium w usłudze Comarch IBARD dla administratora), wówczas konieczne jest spełnienie trzech warunków:

1. Odpowiednie określenie connection stringa w kluczu IBARDStorageSettings w pliku appsettings.json  (zob. Repozytorium – instalacja dla administratora)

2. Wpisanie wartości „IBARD” w kluczu „DestinationAttachmentsRepository” w pliku web.config aplikacji Comarch DMS

3. Wybranie sekcji „Repozytorium” w zakładce „Przechowywanie plików” w zakładce „Ustawienia” w aplikacji desktop Comarch DMS i zalogowanie się do usługi Comarch IBARD za pomocą przycisku „Autoryzacja”.

Po naciśnięciu przycisku [Autoryzacja] zostaje wyświetlone okno, w którym należy wpisać dane logowania do usługi Comarch IBARD (login i hasło) i kliknąć [Zaloguj].

 

Wówczas połączenie z kontem Comarch IBARD zostaje nawiązane – nazwa użytkownika wyświetla się w sekcji Repozytorium obok przycisku  [Autoryzacja] w formie informacji Zalogowano użytkownika [nazwa użytkownika]. Odtąd wszystkie dokumenty przesyłane do Comarch DMS Repozytorium będą przechowywane w usłudze Comarch IBARD.

 

Uwaga
Sekcja „Repozytorium” jest widoczna dopiero po zapisaniu wartości „IBARD” w kluczu „DestinationAttachmentsRepository” w pliku web.config aplikacji Comarch DMS

 

Okno logowania do usługi Comarch IBARD w aplikacji desktopowej Comarch DMS w sekcji „Repozytorium”

 

Pliki z Comarch DMS i Comarch DMS Repozytorium w usłudze Comarch IBARD

Jeśli „DestinationAttachmentWorkflow”= „IBARD”, wtedy w ramach usługi Comarch IBARD po dodaniu pierwszego dokumentu do kontrolki typu Załącznik powstaje automatycznie nowy folder „Comarch DMS „, do którego trafiają wszystkie dokumenty dodane do kontrolki typu Załącznik.

 

Folder „Comarch DMS” w Comarch IBARD

 

Jeśli „DestinationAttachmentsRepository” = „IBARD”, a współpraca z Comarch DMS Repozytorium jest nieaktywna, wówczas w ramach usługi Comarch IBARD po dodaniu pierwszego dokumentu do Managera dokumentów powstaje  automatycznie nowy folder „Comarch DMS MD”, do którego trafiają wszystkie dokumenty dodane do Managera dokumentów, bez rozróżnienia na wewnętrzne foldery.

 

Folder „Comarch DMS MD” w Comarch IBARD

 

Jeśli „DestinationAttachmentsRepository” = „IBARD”, a współpraca z Comarch DMS Repozytorium jest aktywna, wówczas w ramach usługi Comarch IBARD po dodaniu pierwszego dokumentu do Comarch DMS Repozytorium powstaje  automatycznie nowy folder „Comarch DMS Repository”, do którego trafiają wszystkie dokumenty dodane do Comarch DMS Repozytorium, bez rozróżnienia na wewnętrzne foldery.

 

Folder „Comarch DMS Repository” w usłudze Comarch IBARD

 

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!




KSeF

W wersji 2024.0.0 dodano zakładkę „KSeF”.

Zakładka „KSeF” jest dostępna jedynie w trybie jednospółkowym i służy do wprowadzenia danych potrzebnych do uwierzytelnienia w KSeF.

W ramach zakładki dostępne są dwa pola:

  • NIP firmy – w ramach tego pola należy wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF
  • Token KSeF – w ramach tego pola należy wprowadzić token uwierzytelniający w KSeF

Uwaga
Jeśli Comarch DMS pracuje w trybie wielospółkowym, wówczas należy uzupełnić pola „NIP firmy” i „Token KSeF” na zakładce „Połączenia z ERP” (zob. przykładowo Połączenia z ERP).

Uwaga

W wersji 2024.0.1 w pliku Web.config w folderze aplikacji serwerowej (dawnej web) dodano klucz add key=”KSeFWorkMode” value=”Demo” /> – klucz umozliwia określenie, czy Firma testuje funkcjonalność wysyłania faktur do KSeF, czy korzysta z niej produkcyjnie.

Klucz może przybierać jedną z następujących wartości:

1.Demowartość domyślna; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo;

2.Production – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu;

3.Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym.

W kwestii różnic pomiędzy powyższymi trybami zob. Przełączanie trybu pracy z KSeF

 

Zakładka „KSeF”

 

Istnieje możliwość wygenerowania tokenu KSeF z poziomu Comarch DMS. W tym celu należy kliknąć w link [Wygeneruj token] znajdujący się obok pola „Token KSeF”, a następnie w oknie „Wybierz certyfikat” wybrać odpowiedni certyfikat uwierzytelniający.

Po wyborze certyfikatu zostanie wygenerowany token KSeF, który zostanie automatycznie wprowadzony w ramach pola „Token KSeF”.

Wprowadzone zmiany należy zapisać za pomocą ikony [Zapisz].

 

Uwaga
Aby wygenerować token konieczne jest zainstalowanie kwalifikowanego podpisu/pieczęci, za pomocą którego możliwe jest uwierzytelnienie się na stronach ministerstwa.

 

Wybór certyfikatu po kliknięciu w link „Wygeneruj token”

 

Zakładka „KSeF” z uzupełnionymi polami

 

Aby wygenerować token uwierzytelniający, należy najpierw uzupełnić pole „NIP Firmy”.

Jeżeli użytkownik nie uzupełni pola „NIP Firmy” i naciśnie link [Wygeneruj token], wówczas zostanie wyświetlony następujący komunikat.

Komunikat wyświetlany, jeśli nie wpisano numeru NIP w polu „NIP Firmy”, ale naciśnięto link „Wygeneruj token”