Przejdź do treści

Poczta

Zestaw akcji do automatycznej obsługi poczty e-mail w procedurach obiegu i pod przyciskami na formularzach. Akcje pozwalają wysyłać wiadomości, odpowiadać na nie i przekazywać je dalej, a także synchronizować skrzynki i przetwarzać pobrane wiadomości. Ogólne zasady konfigurowania akcji opisano w artykule Akcje systemowe.

Dostępne akcje:

Akcja Do czego służy
Wyślij Tworzy i wysyła nową wiadomość
Odpowiedz Wysyła odpowiedź na odebraną wiadomość
Przekaż Przekazuje odebrane wiadomości do innych adresatów
Wyślij zgodnie ze schematem powiadomienia Wysyła wiadomość przygotowaną na podstawie schematu powiadomienia
Kopiuj załączniki do powiązanego obiektu Kopiuje załączniki wiadomości do obiektu, z którym wiadomość jest powiązana
Synchronizuj skrzynkę Pobiera nowe wiadomości ze wskazanej skrzynki
Zmień wartość pól Zmienia wartości pól na formularzu wiadomości
Pobierz załączniki Ponownie pobiera z serwera załączniki wiadomości

Wartości parametrów

Wartość każdego parametru akcji można wskazać na kilka sposobów:

  • pole formularza: wartość zostanie pobrana z pola dokumentu, dla którego uruchomiono akcję (na przykład pole z adresem e-mail kontrahenta),
  • zmienna systemowa: na przykład Id dokumentu, Id użytkownika (osoba wykonująca działanie) lub Id załączników (wszystkie pliki dołączone do dokumentu w sekcji załączników),
  • wartość z listy: na przykład konkretna skrzynka pocztowa, typ dokumentu czy schemat powiadomienia.

Parametry Temat i Treść są polami SQL. Można w nich wpisać zwykły tekst albo zapytanie SQL zwracające kolumnę VALUE, na przykład:

SELECT 'Dokument ' + Do.DocumentNumber + ' czeka na akceptację' AS VALUE
FROM Do
WHERE Do.ID = @DocumentID

Parametry zapytania (takie jak @DocumentID) przypisuje się do pól formularza lub zmiennych systemowych tak samo jak w innych zapytaniach SQL w systemie. Treść może zawierać znaczniki HTML.

Nadawca wiadomości

Wiadomość zawsze wychodzi z adresu skrzynki pocztowej, przez którą jest wysyłana. Parametr Użytkownik wskazuje jedynie osobę, która w Navigatorze będzie widoczna jako autor wiadomości. Nie zmienia nadawcy.

Wyślij

Akcja tworzy nową wiadomość i wysyła ją przez wskazaną skrzynkę. Wiadomość jest zapisywana w Navigatorze jako dokument wybranego typu i trafia na listę wysłanych wiadomości. Wysyłka odbywa się w tle. Jeżeli się nie powiedzie, system ponawia próbę (zobacz Konfiguracja skrzynki e-mail).

Parametr Opis
Profil email Skrzynka pocztowa, przez którą zostanie wysłana wiadomość. Jeżeli parametr pozostanie pusty, wiadomość zostanie wysłana przez skrzynkę domyślną.
Typ dokumentu Typ dokumentu, jaki otrzyma wysłana wiadomość. Typ musi należeć do grupy e-mail. Jeżeli parametr pozostanie pusty, zostanie użyty domyślny typ e-maila wysłanego ze skrzynki.
Do Adresy odbiorców. Pole wymagane. Kilka adresów należy rozdzielić średnikiem.
DW Adresy odbiorców kopii. Adresy są widoczne dla wszystkich odbiorców.
UDW Adresy odbiorców ukrytej kopii. Adresy nie są widoczne dla pozostałych odbiorców.
Temat Temat wiadomości: tekst lub zapytanie SQL.
Treść Treść wiadomości: tekst lub zapytanie SQL.
Użytkownik Użytkownik widoczny w Navigatorze jako autor wiadomości.
Tabela Tabela obiektu, z którym ma zostać powiązana wiadomość (na przykład dokumenty).
Obiekt Identyfikator obiektu, z którym ma zostać powiązana wiadomość, zwykle Id dokumentu.
Załączniki Pliki dołączane do wiadomości. Można wskazać pole typu pliki na formularzu lub zmienną systemową Id załączników, aby dołączyć wszystkie załączniki dokumentu.

Powiązanie wiadomości z obiektem (parametry Tabela i Obiekt) pozwala później skorzystać z akcji Kopiuj załączniki do powiązanego obiektu.

Odpowiedz

Akcja wysyła odpowiedź na odebraną wiadomość. Odpowiedź jest wysyłana przez tę samą skrzynkę, do której trafiła oryginalna wiadomość. Adresatem jest nadawca oryginalnej wiadomości, a temat otrzymuje prefiks odpowiedzi.

Parametr Opis
Mail Identyfikator odebranej wiadomości, na którą wysyłana jest odpowiedź. Jeżeli akcja działa w obiegu wiadomości e-mail, należy wskazać Id dokumentu.
Odpowiedz wszystkim Tak/Nie. Wartość Tak dodaje do adresatów odpowiedzi także pozostałych odbiorców oryginalnej wiadomości (pola Do i DW). Można wskazać pole logiczne z formularza.
Treść Treść odpowiedzi: tekst lub zapytanie SQL.
Użytkownik Użytkownik widoczny w Navigatorze jako autor odpowiedzi.
Załączniki Pliki dołączane do odpowiedzi: pole typu pliki lub zmienna systemowa Id załączników.

Przekaż

Akcja przekazuje jedną lub kilka odebranych wiadomości do wskazanych adresatów. Każda wiadomość jest przekazywana osobno, przez skrzynkę, do której trafiła. Przekazana wiadomość zawiera nagłówek oryginału (nadawca, adresaci, data, temat), jego treść oraz wszystkie załączniki. Treści przekazywanej wiadomości nie można zmienić.

Parametr Opis
Maile do przekazania Identyfikatory przekazywanych wiadomości. Można wskazać jedną lub kilka wiadomości.
Do Adresy odbiorców. Pole wymagane.
DW Adresy odbiorców kopii.
UDW Adresy odbiorców ukrytej kopii.
Użytkownik Użytkownik widoczny w Navigatorze jako autor przekazanej wiadomości.

Wyślij zgodnie ze schematem powiadomienia

Akcja wysyła wiadomość przygotowaną na podstawie wcześniej zdefiniowanego schematu powiadomienia. Adresaci, temat, treść i załączniki są wyliczane ze schematu dla wskazanego obiektu. Wiadomość jest wysyłana natychmiast, a harmonogram zdefiniowany w schemacie nie jest brany pod uwagę.

Parametr Opis
Obiekt Identyfikator obiektu, dla którego jest przygotowywane powiadomienie, zwykle Id dokumentu.
Schemat powiadomienia Schemat powiadomienia, na podstawie którego powstanie wiadomość.
Zachowaj ID w Pole formularza, w którym zostanie zapisany identyfikator wysłanej wiadomości. Parametr opcjonalny.

Kopiuj załączniki do powiązanego obiektu

Akcja kopiuje wszystkie załączniki wiadomości do obiektu, z którym wiadomość jest powiązana. Powiązanie powstaje, gdy wiadomość została wysłana akcją Wyślij z uzupełnionymi parametrami Tabela i Obiekt lub akcją Wyślij zgodnie ze schematem powiadomienia. Wiadomość bez powiązanego obiektu jest pomijana.

Parametr Opis
Mail Identyfikator wiadomości, z której kopiowane są załączniki.

Synchronizuj skrzynkę

Akcja uruchamia pobieranie nowych wiadomości ze wskazanej skrzynki. Pobieranie odbywa się w tle, więc akcja kończy się bez czekania na jego wynik. Akcja przydaje się na przykład pod przyciskiem, gdy skrzynka nie ma włączonego automatycznego pobierania.

Parametr Opis
Skrzynka pocztowa Skrzynka, z której mają zostać pobrane wiadomości. Pole wymagane.
Użytkownik Użytkownik, w imieniu którego wykonywane jest pobieranie.
Pobierz e-maile z okresu (dni) Liczba dni wstecz, z których mają zostać pobrane wiadomości. Jeżeli parametr pozostanie pusty, pobierane są wiadomości nowsze od ostatnio pobranej. Wiadomości już zapisane w Navigatorze nie są pobierane ponownie.

Zmień wartość pól

Akcja zmienia wartości pól na formularzu wiadomości e-mail. Działa tak samo jak akcja Zmień wartość pól dla dokumentów (zobacz Akcje systemowe: Dokument).

Parametr Opis
Poczta Identyfikator wiadomości, której pola mają zostać zmienione.
Użytkownik Użytkownik, w imieniu którego wykonywana jest zmiana.
Wartości pól Pola formularza wiadomości i zapytania SQL wyliczające ich nowe wartości.

Pobierz załączniki

Akcja ponownie pobiera z serwera poczty oryginalną wiadomość i zapisuje jej załączniki w Navigatorze. Przydaje się, gdy przy synchronizacji skrzynki nie udało się zapisać załączników. Akcja działa dla skrzynek połączonych przez SMTP/IMAP, Microsoft Graph API i Exchange Web Service, pod warunkiem że wiadomość nadal znajduje się na serwerze.

Parametr Opis
Mail Identyfikator odebranej wiadomości.
Użytkownik Użytkownik, w imieniu którego zapisywane są załączniki.