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 |
|---|---|
| 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 |
|---|---|
| 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 |
|---|---|
| Identyfikator odebranej wiadomości. | |
| Użytkownik | Użytkownik, w imieniu którego zapisywane są załączniki. |