Definiowanie punktu konfiguracyjnego

Dodawanie nowego punktu i zakładka „Tryb współpracy”

W punkcie konfiguracyjnym współpracującym ze skrzynką pocztową w trybie generowania dokumentów możliwe jest tworzenie nowych dokumentów Comarch BPM (dawniej DMS) na podstawie informacji znajdujących się w wiadomościach e-mail, pobieranych ze wskazanej skrzynki pocztowej. Możliwe jest przeniesienie do dokumentu Comarch BPM (dawniej DMS) wybranych załączników, treści maila oraz adresatów.

Aby utworzyć punkt konfiguracyjny współpracujący ze skrzynką pocztową w trybie generowania dokumentów Comarch BPM (dawniej DMS), należy w menu głównym Comarch BPM (dawniej DMS) wejść w zakładkę ACD [Automatyczne generowanie dokumentów] i za pomocą ikony dodać nowy punkt konfiguracyjny.

W oknie „Punkt konfiguracyjny” w polu „Tryb współpracy” należy wskazać typ punktu, w tym przypadku: „Współpraca ze skrzynką pocztową (generowanie dokumentów BPM)”.

W oknie Tryb współpracy należy również uzupełnić pola:

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.

Od wersji 2024.2.0 obok pola „Hasło” dostępny jest checkbox „Pokaż hasło”. Zaznaczenie parametru powoduje wyświetlenie treści wprowadzonej w polu „Hasło”, co umożliwia weryfikację poprawności hasła.

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.

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

Jeżeli użytkownik nie przyznał wcześniej uprawnień do pracy z Comarch BPM (dawniej DMS) dla danego konta pocztowego (np. w zakładce „Serwer pocztowy”), wtedy w ramach przeglądarki zostaje otwarte okno, w którym należy wyrazić zgodę na dostęp aplikacji Comarch BPM (dawniej DMS) do skrzynki pocztowej. Aby możliwe było korzystanie ze skrzynki pocztowej w ramach usługi Office 365 należy wybrać przycisk „Tak”.

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

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

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.

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

Zakładka „Ogólne”

Na zakładce „Ogólne” należy w polu:

Na zakładce Ogólne dostępne są parametry:

Zakładka „Lista”

Na zakładce „Lista” należy wskazać rodzaje kolumn, które będą wyświetlane na liście maili. Dane dotyczące maili mogą być wyświetlane w trzech kolumnach, możliwa jest prezentacja tematu wiadomości, nadawcy i daty otrzymania maila, wymagane jest wyświetlanie przynajmniej jednej z tych kolumn.

Zakładka „Kontrolki”

Po określeniu, które kolumny będą wyświetlane na liście maili, należy przejść do zakładki „Kontrolki”, na której zostanie określone mapowanie danych pochodzących z wiadomości e-mail na dokument Comarch BPM (dawniej DMS).

Na dokument w Comarch BPM (dawniej DMS) mogą być mapowane informacje o nadawcy, odbiorcy, dacie otrzymania maila, temacie i treści maila oraz załączniki. W przypadku mapowania załączników, wystarczy wskazać kontrolkę typu załącznik, do której mają zostać dodane załączniki z maila, to mapowanie jest predefiniowane i nie wymaga wprowadzania polecenia SQL.

Definicja zapytań SQL dla kontrolek opiera się na tabeli do.ML_Mails.

CREATE TABLE [do].[ML_Mails](
[MLM_Id] [int] IDENTITY(1,1) NOT NULL, — Identyfikator maila (@Id1@)
[MLM_MessageId] [int] NULL, — Identyfikator maila w skrzynce pocztowej
[MLM_Date] [datetime] NULL, — Data wysłania
[MLM_From] [varchar](255) NULL, — Od kogo
[MLM_To] [varchar](max) NULL, — Do kogo
[MLM_Cc] [varchar](max) NULL, — Do kogo – kopia
[MLM_Subject] [nvarchar](500) NULL, — Temat maila
[MLM_BodyText] [text] NULL — Treść maila

Przykłady zapytań SQL do wprowadzenia w ramach zakładki „Kontrolki”:

select MLM_Subject from do.ML_Mails 
where MLM_Id = @Id1@

select MLM_From from do.ML_Mails 
where MLM_Id = @Id1@

select MLM_BodyText from do.ML_Mails 
where MLM_Id = @Id1@

 select MLM_Date from do.ML_Mails 
where MLM_Id = @Id1@

 select MLM_Cc from do.ML_Mails 
where MLM_Id = @Id1@

Zakładka „Uprawnienia”

Na zakładce definiowane są uprawnienia do pracy z punktem konfiguracyjnym. Uprawnienia mogą być dodawane poprzez wskazanie pracowników, nie ma możliwości dodania uprawnień dla pracowników wskazanego działu czy pracowników zajmujących określone stanowisko.