E メール通知の送信

E メール通知サービスを使用して、実行したベースラインの完了状況を通知する自動 E メール通知を送信できます。

始める前に

E メール通知を送信するには、通知サービスをセットアップおよび構成する必要があります。

このタスクについて

通知サービスをインストールおよび構成した後、ベースラインの完了状況を通知する E メール通知を送信できます。

E メールを通知を送信するには、以下のステップを実行します。

手順

  1. 通知サービスを使用するために、 2245 「Sample Task: Send an Email Notification」の変更済みコピーを、通知を送信するポイントでにコンポーネントとして追加します。例えば、が完了したときに E メール通知を送信する場合、の最後のコンポーネントとしてを追加します。をコピーして、以下のように変更します。
    • 2245 「Sample Task: Send an Email Notification using Static Action Script Content」をコピーします。
    • アクション・スクリプト内の詳細を変更して、以下のキーに対して具体的な設定を含めることで、のコピーを変更します。以下の例に含まれているキーは、通知を送信するために最低限必要なキーを表しています。 
      // NOTIFICATION_START 
// to: "< your comma separated list of recepient email addresses goes here >"
// from: "< your single email address that will be shown as the sender of 
            the email goes here >" 
// subject: "< your email title goes here >" 
// body: "< your main email detail content goes here >" 
// NOTIFICATION_END
      キーの完全なリストを以下の表に示します。
      表 1. 通知のキー
      キー 説明
      to 通知の送信先の E メール・アドレス。有効な値は、有効な E メール・アドレスのコンマ (,) 区切りリストです。これは必須キーです。
      from

      通知 E メールの送信者として表示される E メール・アドレス。この E メール・アドレスは存在する必要はありませんが、指定する値は有効な E メール・アドレス形式でなければなりません。これは必須キーです。
      subject

      E メールの件名として表示される通知の要約。任意のテキストがこのキーに対して有効な入力です。入力するテキストには、実行時に置換されるトークンを含めることができます。これは必須フィールドです。
      body

      E メールのメインの通知テキスト・コンテンツ。実行時に置換されるトークンを含む、任意のテキストをこのキーに対して入力できます。これは必須フィールドです。
      failure-trigger

      通知が送信されることになる失敗の回数を定義します。このキーを指定すると、指定した数の失敗が発生したときに通知が送信されます。このキーを省略すると、通知は完了時に送信されます。0 より大きい整数を入力してください。これはオプションのキーです。
      scope

      アクションが失敗したか正常に完了したかを判別する際に、結果状況についてどのアクションを検査するかを決定します。このキーを省略すると、これらの通知コンポーネントを含むアクションの結果が検査されます。有効な値は parent です。これは、通知コンポーネントを含むアクションの代わりに、親の結果を検査することを意味します。これはオプションのキーです。
    • 変更したのコピーを保存します。
    • 変更済みのコピーを、E メール通知送信の対象であるに追加します。
    の変更方法に関する完全な情報についての説明をレビューして、に含めます。サンプルが以下の「サンプル」セクションに記載されています。
  2. を実行します。が完了すると、指定した E メール・アドレスに E メール通知が送信されます。

例

以下のサンプルは、キーの使用方法を示しています。
以下の通知コメントを設定したタスクをコンポーネントとしてベースラインに追加すると、このタスク (コンポーネント) の完了時に E メールが送信されます (例えば、ベースラインの中間に追加すると役に立ちます)。
// NOTIFICATION_START 
// to: "me@me.com, you@you.com"
// from: "noreply@bigfixteam.mycompany.com" 
// subject: "Basline component '{actionName}' has completed successfully" 
// body: "Baseline is 50% complete now" 
// NOTIFICATION_END
以下の通知コメントで構成されたをコンポーネントとしてに追加すると、その全体が完了したときに E メールが送信されます。
// NOTIFICATION_START 
// to: "me@me.com, you@you.com"
// from: "noreply@bigfixteam.mycompany.com" 
// subject: "Basline '{actionName}' with ID {actionID} has completed successfully" 
// body: "The Baseline is complete!" 
// scope: "parent"
// NOTIFICATION_END

上記 2 つのサンプルは、静的にターゲット設定されたベースラインにのみ追加できます。グループ、プロパティー、または名前リストによりターゲット設定されたベースラインでは、通知の送信が有効になりません。

静的または動的にターゲット設定されるベースラインでは、以下のサンプルを指定できます。
// NOTIFICATION_START 
// to: "me@me.com, you@you.com"
// from: "noreply@bigfixteam.mycompany.com" 
// subject: "Basline '{actionName}' with ID {actionID} has failed on 5 or more computers" 
// body: "Review the results of Baseline '{actionName}' (ID: {actionID})" 
// failure-trigger: "5"
// scope: "parent"
// NOTIFICATION_END