Operazioni di messaggi email

Per accedere alle operazioni del messaggio email, il Tipo oggetto selezionato per lo script deve essere Email Message.

Immettere emailmessage. nella riga di script per visualizzare le operazioni disponibili, descritte nella seguente tabella.

Operazione	Descrizione
`attachments`	Restituisce un array di oggetti metadati dell'allegato, con ciascun elemento contenente le proprietà riportate di seguito: id nomefile_presentato tipo_contenuto_presentato nomefile_suggerito tipo_contenuto_suggerito id_contenuto dimensione interno Le proprietà del prefisso "presented_" (che può avere il valore Nessuno) riflettono i dettagli del file come definiti dalle intestazioni email. Le proprietà del prefisso "suggested_" (che hanno sempre un valore) riflettono i dettagli del file calcolati al momento dell'ispezione dall'ingester email. La proprietà inline indica se l'allegato è stato trovato inline nel corpo dell'email (True) o in un allegato file separato (False). Gli oggetti metadati dell'allegato non sono visibili nell'editor di script type ahead.
`body`	Restituisce il contenuto del corpo dell'email come testo semplice. Qualsiasi markup HTML viene rimossa.
`cc` `to`	Restituisce un array di oggetti che rappresentano i destinatari presenti nel campo CC o A dell'email. Ogni elemento definisce un valore di indirizzo obbligatorio con un valore di nome facoltativo.
`from`	Restituisce un singolo oggetto che rappresenta il destinatario nel campo Da dell'email. Questo oggetto definisce un valore di indirizzo obbligatorio con un valore di nome facoltativo.
`getBodyHtmlRaw()`	Restituisce il contenuto del messaggio email, inclusa la markup HTML. La stringa restituita è una stringa unicode.
`headers`	Restituisce una rappresentazione della mappa (dizionario) delle intestazioni definite nell'email. Il nome intestazione funge da chiave di associazione e il valore corrispondente per ogni chiave di intestazione è un array che può contenere nessuno, uno o più elementi. Il nome dell'intestazione e gli elementi nell'array corrispondente dei valori dell'intestazione sono tutti espressi come stringhe.
`id`	Restituisce il numero ID assegnato al messaggio email, visualizzato nella pagina Posta in arrivo.
`inbound_mailbox`	Restituisce il nome della connessione email in entrata configurata nell'applicazione Orchestrazione & Automazione . È possibile visualizzare le caselle di posta in entrata nella scheda Organizzazione in Impostazioni amministratore.
`received_date`	Restituisce la data in cui è stato ricevuto il messaggio email.
`sent_date`	Restituisce la data di invio del messaggio email.
`subject`	Restituisce l'oggetto del messaggio email.
`associateWithIncident(incident)`	Associa il messaggio email all'incidente specificato da helper.findIncidents(). Non restituisce un valore, ma imposta la variabile incidente di primo livello.
`createAssociatedIncident(name, owner_handle)`	Crea un incidente in base al messaggio email. Non restituisce un valore, ma imposta la variabile incidente di primo livello. Utilizzare name per fornire un nome per l'incidente. Utilizzare owner_handle per specificare un riferimento al proprietario del nuovo incidente. Per un singolo utente, immettere l'ID o l'indirizzo email dell'utente. Per un gruppo, immettere l'ID o il nome del gruppo. È anche possibile utilizzare incident.owner_id per assegnare l'incidente a un utente o a un gruppo.

Il seguente esempio di script python 3 aggiunge tutte le informazioni di intestazione come una nota sull'incidente associato:

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)

Per un esempio di utilizzo del messaggio email, consultare Associazione dei messaggi email agli incidenti.