NOTIFY コマンド

受信者に中継する SMTPメールサーバーに電子メール通知メッセージを送信します。

構文

認証されているコマンド構文

NOTIFY SMTP SMTPUSER SMTPアカウント名 PORT ポート番号 <ENABLESSL> USER 送信元の電子メールアドレス PASSWORD 暗号化されたパスワード MAILBOX SMTPサーバー名 ADDRESS 受信者の電子メールアドレス <CC cc受信者の電子メールアドレス> <BCC bcc受信者の電子メールアドレス> SUBJECT 件名 MESSAGE メッセージテキスト <ATTACHMENT ファイルパス>

認証されていないコマンド構文

NOTIFY USER送信元の電子メールアドレス <PASSWORD暗号化されたパスワード> MAILBOXSMTPサーバー名 ADDRESS受信者の電子メールアドレス <CCcc 受信者の電子メールアドレス> <BCCbcc 受信者の電子メールアドレス> SUBJECTメッセージの件名 MESSAGE メッセージの本文テキスト <ATTACHMENT ファイルのパス>

パラメーター

MAILBOX "smtp.example.com"

ATTACHMENT "result1.csv,result2.csv"

例

NOTIFY SMTP SMTPUSER "mail_admin@example.com" PORT 587 ENABLESSL USER "support@company.com" PASSWORD "9QZC2524830864..."MAILBOX "smtp.company.com" ADDRESS "script_admin@company.com" SUBJECT "エラーレポート" MESSAGE "スクリプトの処理に失敗しました。詳細を添付しました。"ATTACHMENT "Errors.fil,ACL_Demo.log"

NOTIFY USER "support@company.com" MAILBOX "mail.company.com" ADDRESS "script_admin@company.com" SUBJECT "エラーレポート" MESSAGE "スクリプトの処理に失敗しました。詳細を添付しました。"ATTACHMENT "Errors.fil,ACL_Demo.log"

備考

受信者と添付ファイル

NOTIFY コマンドを使用すると、1 人以上の受信者に電子メール通知メッセージを送信することができます。メッセージには、データ ファイルや Analytics プロジェクトを添付して含めることができます。

NOTIFY コマンドの一般的な使用法は、スクリプトが予期せず失敗したときに適切な担当者に警告することです。

互換性のある SMTP サーバー

NOTIFY コマンドは、SMTP（Simple Mail Transfer Protocol）をサポートするメールサーバーで使用でき、認証接続を必要とする幅広い SMTP サーバーで動作するはずです。ただし、すべての SMTP サーバーやサービスで動作するわけではありません。たとえば、NOTIFY は Gmail では動作しません。サードパーティアプリを Google アカウントに接続するには、NOTIFY がサポートするユーザー名とパスワード以上のセキュリティ構成が必要です。

一般に、NOTIFY を使用して SMTP サーバーに電子メールを正常に送信するには、 Analytics 側だけでなく SMTP サーバー側にも互換性のある構成が必要であることに注意してください。NOTIFY が接続に失敗し、電子メールを正常に送信できない場合は、IT 部門と連携して、Analytics とサーバーの間に互換性のある接続構成があることを確認してください。

暗号化されたパスワードの生成

NOTIFY コマンドの PASSWORD パラメーターとともに暗号化されたパスワード値を指定する必要があります。NOTIFY で使用するパスワードを適切に暗号化するには、Analytics のユーザーインターフェイスの［通知］ダイアログボックスにパスワードを入力する必要があります。

1. 省略可能。Analytics のコマンドラインで、SET NOTIFYRETRYATTEMPTS TO 0 と入力します

   NOTIFY の再試行を一時的にオフにすることで、暗号化されたパスワードの生成が高速化されます。

2. Analytics のメインメニューから［ツール > 電子メールによる通知Analytics］を選択します。

3. ［通知］ダイアログボックスで、必須のフィールドをすべて記入し、必要に応じて任意のフィールドに記入します。

   送信者	送信元の電子メールアドレス	必須
   パスワード	SMTP サーバーのユーザーアカウントパスワード（クリアテキスト）。 メモ パスワードが 30 文字を超えると、NOTIFY コマンドは失敗します。	必須
   メールボックス パス	SMTPサーバー名	必須
   変換先	受信者の電子メールアドレス	必須
   Cc	cc 受信者の電子メールアドレス	省略可能
   Bcc	bcc 受信者の電子メールアドレス	省略可能
   件名	メッセージの件名	必須
   テキスト	メッセージ テキスト	必須
   添付ファイル	ファイルのパス	省略可能

4. ［OK］をクリックします。

   認証を必要とする SMTP サーバーに接続しようとすると、NOTIFY コマンドが成功したように見えても、接続の試行は（予想どおり）失敗します。

5. NOTIFY コマンドをログからコピーしてスクリプトに貼り付けます。

   NOTIFY コマンドに PASSWORD の暗号化された値が格納されます。

6. スクリプトで、コピーされた NOTIFY コマンドに次のパラメーターを追加し、適切なパラメーター値を指定します。

   パラメーターは、NOTIFY キーワードの直後に挿入できます。

   • SMTP

   • SMTPUSER SMTPアカウント名

   • PORT ポート番号

   • ENABLESSL（必要な場合）

7. 以前に NOTIFY 再試行回数を 0 に指定した場合は、コマンドラインに SET NOTIFYRETRYATTEMPTS TO 5 と入力します。

   再試行回数を 5 ではなく、別の回数に設定していた場合は、その該当する回数を入力します。

8. スクリプトを実行して NOTIFY コマンドをテストします。

   SMTP メールサーバーで動作するようにすべての必須の値を正しく構成すると、NOTIFY コマンドは成功するようになります。

接続の試行に失敗した場合の Analytics の応答の仕方

Analytics をメール サーバーに接続できない場合は、接続の試行が 10 秒おきに 5 回繰り返されます。この自動再試行機能は、メールサーバーが一時的に利用できなくなった場合の問題に対応します。

すべての接続試行に失敗した場合、NOTIFY コマンドはキャンセルされ、ログにメッセージが書き込まれますが、コマンドを含むスクリプトは処理を続行します。

SET コマンドを使用すると、デフォルトの再試行動作を変更できます。以下を指定できます。

• 異なる接続試行回数

• 追加の接続試行なし

• 異なる試行間隔

• NOTIFY コマンドが接続に失敗し、キャンセルされた場合のスクリプトの失敗

SET コマンドの詳細については、SET コマンドを参照してください。

SET NOTIFYRETRYATTEMPTS TO 10

SET NOTIFYRETRYINTERVAL TO 30

SET NOTIFYFAILSTOP ON