E メール・メッセージ操作

E メール・メッセージ操作にアクセスするには、スクリプトの選択されたオブジェクト・タイプが Email Messageでなければなりません。

スクリプト行に emailmessage. と入力して、可能な操作を確認します。これについて、以下の表で説明します。

操作 説明 
attachments
添付メタデータ・オブジェクトの配列を返します。各エレメントには以下のプロパティーが含まれます。
  • ID
  • presented_filename
  • presented_content_type
  • suggested_filename
  • suggested_content_type
  • content_id
  • size
  • inline

「presented_」接頭部プロパティー (値が None の場合もある) は、E メール・ヘッダーで定義されたとおりにファイルの詳細を反映します。

「suggested_」接頭部プロパティー (これは常に値を持ちます) は、E メール・インジェスターによる検査で計算されたファイル詳細を反映します。

インライン・プロパティーは、添付ファイルが E メール本文でインラインで検出されたか (True)、別のファイル添付で検出されたか (False) を示します。

添付メタデータ・オブジェクトは、スクリプト・エディターの先行入力では表示されません。

 
body

E メール本文の内容をプレーン・テキストとして返します。 HTML マークアップはすべて削除されます。

 
cc
to

E メールの「CC」フィールドまたは「To」フィールドに存在する受信者を表すオブジェクトの配列を戻します。 各エレメントは、オプションの名前値を使用して必須のアドレス値を定義します。

 
from

E メール・メッセージの「From」フィールド内の受信者を表す単一オブジェクトを返します。 このオブジェクトは、オプションの名前値を使用して必須アドレス値を定義します。

 
getBodyHtmlRaw()

HTML マークアップを含む E メール・メッセージの内容を返します。 戻りストリングは、ユニコード・ストリングです。

 
headers

E メールに定義されているヘッダーのマップ (辞書) 表現を返します。 ヘッダー名はマップ・キーとして機能し、各ヘッダー・キーの対応する値は配列で、配列にはエレメントが含まれない場合、1 つ含まれる場合、または複数含まれる場合があります。 ヘッダー名と、対応するヘッダー値の配列内のエレメントは、いずれもストリングとして表されます。

 
id

「メール受信ボックス」ページに表示される E メール・メッセージに割り当てられた ID 番号を返します。

 
inbound_mailbox

Orchestration & Automation アプリケーションで構成されたインバウンド E メール接続の名前を返します。 インバウンド・メールボックスは、「管理者設定」の下の「組織」タブで表示できます。

 
received_date

E メール・メッセージが受信された日付を返します。

 
sent_date

E メール・メッセージが送信された日付を返します。

 
subject

E メール・メッセージの件名を返します。

 
associateWithIncident(incident)

E メール・メッセージを、helper.findIncidents() で指定されたインシデントに関連付けます。 これは、値を返しませんが、最上位のインシデント変数を設定します。

 
createAssociatedIncident(name, owner_handle)

E メール・メッセージに基づいてインシデントを作成します。 これは、値を返しませんが、最上位のインシデント変数を設定します。

name を使用して、インシデントの名前を指定します。

owner_handle を使用して、新規インシデントの所有者への参照を指定します。 個々のユーザーについて、ユーザーの ID または E メール・アドレスを入力します。 グループの場合は、グループの ID または名前を入力します。

incident.owner_id を使用して、インシデントをユーザーまたはグループに割り当てることもできます。
以下の Python 3 スクリプト例では、すべてのヘッダー情報を、関連するインシデントのメモとして追加します。
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)

E メール・メッセージの使用例については、 E メール・メッセージとインシデントの関連付けを参照してください。