Operacje wiadomości e-mail

Aby uzyskać dostęp do operacji wiadomości e-mail, wybrany typ obiektu dla skryptu musi mieć wartość Email Message.

Wpisz emailmessage. w wierszu skryptu, aby wyświetlić dostępne operacje, które zostały opisane w poniższej tabeli.

Operacja Opis
attachments
Zwraca tablicę obiektów metadanych załącznika z każdym elementem zawierającym następujące właściwości:
  • id
  • nazwa_wstępnie nazwanego pliku
  • typ presented_content_type
  • suggested_filename
  • sugestywny typ content_type
  • id_content_id
  • wielkość
  • wstawiane

Właściwości prefiksu "presented_" (które mogą mieć wartość Brak) odzwierciedlają szczegóły pliku zdefiniowane przez nagłówki wiadomości e-mail.

Właściwości prefiksu "suggested_" (które zawsze mają wartość) odzwierciedlają szczegóły pliku obliczone po sprawdzeniu przez e-mail ingester.

Właściwość wstawiana wskazuje, czy załącznik został znaleziony jako wstawiany w treści wiadomości e-mail (prawda), czy w oddzielnym załączniku do pliku (Fałsz).

Obiekty metadanych załącznika nie są widoczne w przypadku automatycznego uzupełniania edytora skryptów.

body

Zwraca treść wiadomości e-mail jako zwykły tekst. Wszystkie znaczniki HTML są usuwane.

cc
to

Zwraca tablicę obiektów reprezentujących odbiorców znajdujących się w polu DW lub Do wiadomości e-mail. Każdy element definiuje obowiązkową wartość adresu z opcjonalną wartością nazwy.

from

Zwraca pojedynczy obiekt reprezentujący odbiorcę w polu From (Z) wiadomości e-mail. Ten obiekt definiuje obowiązkową wartość adresu z opcjonalną wartością nazwy.

getBodyHtmlRaw()

Zwraca treść wiadomości e-mail, w tym język znaczników HTML. Zwrócony łańcuch jest łańcuchem unicode.

headers

Zwraca odwzorowanie (słownik) nagłówków zdefiniowanych w wiadomości e-mail. Nazwa nagłówka pełni rolę klucza mapy, a odpowiadająca jej wartość dla każdego klucza nagłówka to tablica, która może zawierać jeden lub wiele elementów. Zarówno nazwa nagłówka, jak i elementy w odpowiedniej tablicy wartości nagłówka są wyrażane jako łańcuchy.

id

Zwraca numer identyfikatora przypisany do wiadomości e-mail, która jest wyświetlana na stronie Skrzynka odbiorczy poczty.

inbound_mailbox

Zwraca nazwę przychodzącego połączenia poczty elektronicznej skonfigurowanego w aplikacji Orchestration & Automation (harmonizacja i automatyzacja). Przychodzące skrzynki pocztowe można wyświetlić na karcie Organizacja w obszarze Ustawienia administratora.

received_date

Zwraca datę odebrania wiadomości e-mail.

sent_date

Zwraca datę wysłania wiadomości e-mail.

subject

Zwraca temat wiadomości e-mail.

associateWithIncident(incident)

Tworzy powiązanie wiadomości e-mail z incydentem określonym przez produkt helper.findIncidents(). Nie zwraca ona wartości, ale ustawia zmienną incydentu najwyższego poziomu.

createAssociatedIncident(name, owner_handle)

Tworzy incydent na podstawie wiadomości e-mail. Nie zwraca ona wartości, ale ustawia zmienną incydentu najwyższego poziomu.

Użyj opcji name , aby podać nazwę incydentu.

Użyj opcji owner_handle , aby określić odwołanie do właściciela nowego incydentu. W przypadku pojedynczego użytkownika wprowadź ID użytkownika lub adres e-mail. W przypadku grupy wprowadź identyfikator grupy lub nazwę grupy.

Można również użyć programu incident.owner_id w celu przypisania incydentu do użytkownika lub grupy.

Poniższy przykładowy skrypt python 3 dodaje wszystkie informacje nagłówkowe jako notatkę w powiązanym incydencie:
headers = ""
for header in emailmessage.headers:
    headers += "\n'" + header + "': ["
    for i, value in enumerate(emailmessage.headers[header]):
        if i > 0:
            headers += ", "
        headers += "'{}'".format(value)
    headers += "]"
incident.addNote("=== EMAIL HEADERS ===" + headers)

Przykład użycia wiadomości e-mail zawiera sekcja Wiązanie wiadomości e-mail z incydentami.