Działanie dotyczące e-mail
Przed wdrożeniem każdej akcji poczty e-mail należy skonfigurować serwer, który będzie obsługiwać żądania. Akcje Pobierania wiadomości e-mail i Przetwarzania wiadomości e-mail wymagają serwera IMAP, a akcja Wyślij wiadomość e-mail wymaga serwera SMTP.
Typowe porty IMAP:
- 143 (nieszyfrowane i TLS)
- 993 (zabezpieczone IMAP)
Typowe serwery IMAP:
- imap-mail.outlook.com (Outlook.com)
- outlook.office365.com (Office365.com)
- imap.mail.yahoo.com (poczta Yahoo)
- imap.gmail.com (poczta Google)
Typowe porty SMTP:
- 25 (Niezaszyfrowane)
- 587 (nieszyfrowane i TLS)
- 465 (SSL)
Typowe serwery SMTP:
- smtp-mail.outlook.com (Outlook.com)
- smtp.office365.com (Office365.com)
- smtp.mail.yahoo.com (poczta Yahoo)
- smtp.gmail.com (poczta Google)
Aby pobrać wiadomości e-mail spełniające określone kryteria, użyj akcji Pobierz wiadomości e-mail. Poniższy przykład pobiera tylko nieprzeczytane wiadomości z skrzynki odbiorczej.
Filtr dodatkowo określa, że e-mail powinien pochodzić z b.friday, temat powinien zawierać słowo Raport, a treść powinna zawierać Wtorek. W akcji zostaną zapisane lokalnie wszystkie załączniki, które spełniają określone kryteria.
Zarządzaj wiadomościami e-mail za pomocą akcji Przetwórz wiadomości e-mail, która wymaga zmiennej utworzonej przez akcję Pobieranie wiadomości e-mail. Możesz wybrać przeniesienie, usunięcie lub zaznaczenia wiadomości e-mail jako przeczytanych/nieprzeczytanych.
Poniższa akcja Wyślij wiadomość e-mail na poniższej ilustracji wysyła wiadomość e-mail od N. Varga do B. Friday z fakturą w polu UDW. Temat i treść zawierają zmienną %ReportID%, a załącznik to plik, który został wcześniej przetworzony przez przepływ.
Pobierz wiadomości e-mail
Pobiera wiadomości e-mail z serwera IMAP.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | opis |
|---|---|---|---|---|
| IMAP server | Nie | Wartość tekstowa | Adres serwera IMAP (np. imap.gmail.com) | |
| Port | Tak | Wartość liczbowa | 993 | Port, który ma być używany dla serwera IMAP. Zwykle jest to port 993 |
| Enable SSL | Brak | Wartość logiczna | Prawda | Określ, czy do komunikowania się z serwerem IMAP ma być używane bezpieczne połączenie. |
| User name | Nie | Wartość tekstowa | Nazwa użytkownika umożliwiająca dostęp do konta e-mail | |
| Password | Nie. | Bezpośrednie wprowadzanie zaszyfrowanego tekstu lub wartości tekstowej | Hasło umożliwiające dostęp do konta e-mail | |
| Accept untrusted certificates | Nie dotyczy | Wartość logiczna | Fałsz | Określ, czy niezaufane certyfikaty będą akceptowane |
| Mail folder | Nie | Wartość tekstowa | Nazwa folderu poczty IMAP (nazywanego także „skrzynką pocztową”), z którego mają zostać pobrane wiadomości | |
| Retrieve | Nie dotyczy | Wszystkie wiadomości e-mail, Tylko nieprzeczytane wiadomości e-mail, Tylko przeczytane wiadomości e-mail | Wszystkie wiadomości e-mail | Określ, czy mają być pobierane wszystkie wiadomości z folderu, czy tylko nieprzeczytane |
| Mark As read | Nie dotyczy | Wartość logiczna | Prawda | Określ, czy pobrane wiadomości mają być oznaczane jako przeczytane, czy mają pozostać niezmienione |
| "From" field contains | Tak | Wartość tekstowa | Pełny adres e-mail nadawcy, którego wiadomości zostaną pobrane. Pozostaw ten atrybut pusty, aby pobrać wszystkie wiadomości niezależnie od nadawcy | |
| "To" field contains | Tak | Wartość tekstowa | Pełne adresy e-mail adresatów (oddzielone spacją, jeśli jest ich więcej niż jeden) dla wiadomości, które zostaną pobrane. Pozostaw ten atrybut pusty, aby pobrać wszystkie wiadomości niezależnie od adresatów | |
| "Subject" contains | Tak | Wartość tekstowa | Fraza kluczowa do znalezienia w temacie wiadomości e-mail. Pozostaw ten atrybut pusty, aby pobrać wszystkie wiadomości e-mail niezależnie od ich tematu | |
| 'Body' contains | Tak | Wartość tekstowa | Fraza kluczowa do znalezienia w treści wiadomości e-mail. Pozostaw ten atrybut pusty, aby pobrać wszystkie wiadomości e-mail niezależnie od ich zawartości | |
| Save attachments | Nie dotyczy | Zapisz załączniki, Nie zapisuj załączników | Nie zapisuj załączników | Określ, czy załączniki pobranych wiadomości e-mail mają być zapisywane, czy nie |
| Save attachments into | Nie. | Folder | Folder, w którym mają być zapisywane załączniki |
Utworzone zmienne
| Argument | Type | opis |
|---|---|---|
| RetrievedEmails | Listawiadomości e-mail | Pobrane wiadomości e-mail, które będą przetwarzane później, jako lista obiektów wiadomości e-mail |
Wyjątki
| Wyjątek | Opis |
|---|---|
| Nie można nawiązać połączenia z serwerem IMAP | Wskazuje, że wystąpił problem podczas nawiązywania połączenia z serwerem IMAP |
| Nie można uwierzytelnić na serwerze IMAP | Wskazuje problem podczas uwierzytelniania na określonym serwerze IMAP |
| Określony folder poczty nie istnieje | Wskazuje, że nie znaleziono określonego folderu poczty |
| Nie można zapisać załączników | Wskazuje problem podczas zapisywania załączników |
| Nie można pobrać wiadomości e-mail | Wskazuje problem podczas pobierania wiadomości e-mail |
Przetwórz wiadomości e-mail
Przenosi, usuwa lub zaznacza jako nieprzeczytaną wiadomość e-mail (lub listę wiadomości e-mail) pobraną przez akcję Pobierz wiadomości e-mail.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | opis |
|---|---|---|---|---|
| IMAP server | Nie | Wartość tekstowa | Adres serwera IMAP (np. imap.gmail.com) | |
| Port | Tak | Wartość liczbowa | 993 | Port, który ma być używany dla serwera IMAP. Zwykle jest to port 993 |
| Enable SSL | Brak | Wartość logiczna | Prawda | Określ, czy do komunikowania się z serwerem IMAP ma być używane bezpieczne połączenie. |
| Username | Nie | Wartość tekstowa | Nazwa użytkownika umożliwiająca dostęp do konta e-mail | |
| Password | Nie. | Bezpośrednie wprowadzanie zaszyfrowanego tekstu lub wartości tekstowej | Hasło umożliwiające dostęp do konta e-mail | |
| Accept Untrusted Certificates | Nie dotyczy | Wartość logiczna | Fałsz | Określ, czy niezaufane certyfikaty będą akceptowane |
| Email(s) to process | Nie | Listawiadomości e-mail | Wiadomość e-mail lub lista wiadomości e-mail do przetworzenia. Ten parametr powinien zawierać zmienną wypełnioną akcją Pobieranie wiadomości e-mail | |
| Działanie | Nie dotyczy | Usuń wiadomości e-mail z serwera, Oznacz wiadomości e-mail jako nieprzeczytane, Przenieś wiadomości e-mail do folderu poczty, Oznacz wiadomości e-mail jako nieprzeczytane i przenieś je do folderu poczty | Przenieś wiadomości e-mail do folderu poczty | Operacja, którą chcesz wykonać na określonych wiadomościach e-mail |
| Mail folder | Nie | Wartość tekstowa | Nazwa folderu poczty, do którego zostaną przeniesione wiadomości e-mail |
Utworzone zmienne
Ta akcja nie wywołuje żadnych zmiennych.
Wyjątki
| Wyjątek | opis |
|---|---|
| Nie można nawiązać połączenia z serwerem IMAP | Wskazuje, że wystąpił problem podczas nawiązywania połączenia z serwerem IMAP |
| Określony folder poczty nie istnieje | Wskazuje, że nie znaleziono określonego folderu poczty |
| Nie można przetworzyć wiadomości e-mail | Wskazuje problem z przetwarzaniem określonych wiadomości e-mail |
Wyślij wiadomość e-mail
Tworzy i wysyła nową wiadomość e-mail.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | opis |
|---|---|---|---|---|
| SMTP server | Nie | Wartość tekstowa | Adres serwera SMTP | |
| Server port | Tak | Wartość liczbowa | 25 | Port, który ma być używany dla serwera. Zwykle jest to port 25 |
| Enable SSL | Brak | Wartość logiczna | Fałsz | Określ, czy komunikacja z serwerem ma odbywać się za pomocą bezpiecznego połączenia |
| SMTP Server needs authentication | Nie dotyczy | Wartość logiczna | Fałsz | Określ, czy serwer wymaga uwierzytelnienia |
| User name | Nie | Wartość tekstowa | Nazwa użytkownika umożliwiająca dostęp do konta e-mail | |
| Password | Nie. | Bezpośrednie wprowadzanie zaszyfrowanego tekstu lub wartości tekstowej | Hasło umożliwiające dostęp do konta e-mail | |
| Accept untrusted certificates | Nie dotyczy | Wartość logiczna | Fałsz | Określ, czy niezaufane certyfikaty będą akceptowane |
| From | Nie | Wartość tekstowa | Adres e-mail nadawcy | |
| Sender display name | Tak | Wartość tekstowa | Nazwa wyświetlana nadawcy | |
| To | Nie | Wartość tekstowa | Adresy e-mail adresatów. Jeśli wprowadzono więcej niż jeden adres e-mail, lista adresów powinna być oddzielona średnikami | |
| CC | Tak | Wartość tekstowa | Adres(y) e-mail adresata/-ów DW. Jeśli wprowadzono więcej niż jeden adres e-mail, lista adresów powinna być oddzielona średnikami | |
| BCC | Tak | Wartość tekstowa | Adres(y) e-mail adresata/-ów UDW (ukryte). Jeśli wprowadzono więcej niż jeden adres e-mail, lista adresów powinna być oddzielona średnikami | |
| Subject | Tak | Wartość tekstowa | Temat wiadomości e-mail | |
| Body | Tak | Wartość tekstowa | Treść wiadomości e-mail | |
| Body Is HTML | Nie dotyczy | Wartość logiczna | Fałsz | Określ, czy treść wiadomości e-mail będzie interpretowana jako kod HTML |
| Attachment(s) | Tak | Listaplików | Pełna ścieżka wszelkich załączników, pliku lub listy plików. Wiele plików należy ująć w podwójne cudzysłowy (") i oddzielić spacją |
Utworzone zmienne
Ta akcja nie wywołuje żadnych zmiennych.
Wyjątki
| Wyjątek | opis |
|---|---|
| Nieprawidłowy adres e-mail | Wskazuje, że określony adres e-mail jest nieprawidłowy |
| Nie można wysłać wiadomości e-mail | Wskazuje problem podczas wysyłania wiadomości e-mail |
| Nie znaleziono załącznika | Wskazuje, że nie znaleziono określonych załączników |