受信メール アクションの例

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む6読むのに数分

    • 受信メール アクションのさまざまな例を使用して、独自の受信メール アクションを構築することができます。これらの例では、メールの返信の処理、問題レコードの作成 (ログ)、変更の要求、およびインシデントの更新を行うための受信メール アクションを設定する方法を示しています。

    受信メール アクションの例：メール返信の処理

    この例では、ユーザーがインスタンスに送り返した返信を処理する受信メール アクションを設定する方法を示します。

    始める前に

    必要なロール：管理者

    このタスクについて

    受信メール アクションは、スクリプトを使用してメールを解析し、応答します。デフォルトでは、インスタンスでメールが受信されると新しいインシデントが作成され、メールの本文は [追加コメント] テキスト ボックスに追加されます。詳細に設定された受信メールアクションでは、より多くのデータを含むインシデントチケットを作成できるため、インシデント管理チームの貴重な時間を節減できます。

    通常、インスタンスから送信されたメールにユーザーが応答した場合は、受信メール アクションによってウォーターマークと既存インシデントの照合が行われ、新規レコードを作成するのではなくインシデントが更新されます。ただし、ウォーターマークが見つからない場合、この受信メール アクションでは返信と元のインシデントの照合を試みます。

    この受信メールアクションは、サンプルフローの 受信メールフローの例：メール返信の処理として フローデザイナー に複製されます。サンプルフローを表示するには、次の場所に移動します。 フローデザイナー > デザイナー.

    手順

    1. 移動先 システムポリシー > 受信アクション をクリックし、「 新規」をクリックします。
    2. 次のようにフォームに入力します。
      表 : 1. 受信アクションフィールドの値
      フィールド 値
      名前 インシデントの更新
      タイプ 返信
      ターゲットテーブル インシデント [incident]
    3. [スクリプト] で、このコードを入力します。 
      gs.include('validators');
 
//Note: current.caller_id and current.opened_by are already set to the first UserID that matches the From: email address
 
if (current.getTableName() == "incident") {
  current.comments = "reply from: " + email.origemail + "\n\n" + email.body_text;
 
  if (email.body.assign != undefined)
    current.assigned_to = email.body.assign;
 
  if (email.body.priority != undefined && isNumeric(email.body.priority))
    current.priority = email.body.priority;
 
  if (email.body.category != undefined)
    current.category = email.body.category;
 
  if (email.body.short_description != undefined)
    current.short_description = email.body.short_description;
 
  current.update();
}

    受信メール アクションの例：問題のログ記録

    この例では、受信メール アクションを設定して問題レコードを作成する方法を示します。

    始める前に

    必要なロール：管理者

    このタスクについて

    受信メール アクションにより、ユーザーは、メールを介してインスタンスでインシデントのログ記録や更新を行うことができます。受信メール アクションは、スクリプトを使用してメールを解析し、応答します。

    この受信メールアクションは、サンプルフローの受信メールフローの例：問題をログに記録として フローデザイナー に複製されます。サンプルフローを表示するには、次の場所に移動します。 フローデザイナー > デザイナー.

    手順

    1. 移動先 システムポリシー > 受信アクション をクリックし、「 新規」をクリックします。
    2. 次のようにフォームに入力します。
      フィールド エントリ
      名前 問題のログ記録
      タイプ 新規
      有効 true
      ターゲットテーブル 問題 [problem]
      条件 
      email.subject.indexOf("Problem: ") == 0
      スクリプト 
      current.description = email.body_text;
  current.short_description = email.subject.toString().substring(9);
 
  current.assignment_group.setDisplayValue("Development");
 
  if (email.body.assign != undefined)
    current.assigned_to = email.body.assign;
 
  current.insert();

    受信メール アクションの例：変更の要求

    この例では、受信メール アクションを設定して変更要求レコードを作成する方法を示します。

    始める前に

    必要なロール：管理者

    このタスクについて

    受信メール アクションにより、ユーザーは、メールを介してインスタンスでインシデントのログ記録や更新を行うことができます。受信メール アクションは、スクリプトを使用してメールを解析し、応答します。

    手順

    1. 移動先 すべて > システムポリシー > 受信アクション をクリックし、「 新規」をクリックします。
    2. 次のようにフォームに入力します。
      フィールド エントリ
      名前 変更を要求
      タイプ 新規
      有効 true
      ターゲットテーブル 変更要求 [change_request]
      条件 
      email.subject.indexOf("Change Request: ") == 0
      スクリプト 
      current.comments = email.body_text;
  current.short_description = email.subject;
 
  current.notify = 2;
 
  if (email.body_text.assign != undefined)
    current.assigned_to = email.body_text.assign;
 
  if (email.body_text.priority != undefined)
    current.priority = email.body_text.priority;
 
  if (email.body_text.category != undefined)
    current.category = email.body_text.category;
 
  current.insert();

    受信メールから自動的に設定される値

    インシデント テーブルのデフォルトの受信アクションでは、受信メールを受信すると、以下のフィールド値が自動的に設定されます。

    表 : 2. 受信メールから自動的に設定される値
    フィールド値セット 受信メールから使用される値
    current.caller_id メールアドレスが email.from 変数に一致する最初のユーザーのユーザー ID。
    current.opened_by メールアドレスが email.from 変数に一致する最初のユーザーのユーザー ID。
    複数のユーザーが同じメールアドレスを持つ場合、インスタンスではまず、メールアドレスを持つアクティブ ユーザーが検索されます。可能であれば、各ユーザー レコードに一意のメールアドレスを使用してください。一意のアドレスを使用しない場合、共有メールアドレスを持つアクティブ ユーザーを 1 人だけにすることで、インスタンスでこのアドレスからの受信メールとこのアクティブ ユーザーに常に照合することが保証されます。