電子メールの送信ステップでは、ステップが実行されると、1 人または複数の受信者に電子メール通知が送信されます。 このステップ タイプを使用すると、ステップやジョブが完了した場合や、ステップが正常に完了しなかった場合に、ユーザーに通知することができます。
電子メールの送信ステップを使用して電子メール通知を送信する前に、以下を行う必要があります。
- ArcGIS Workflow Manager 用に電子メール設定を構成する必要があります。
- ArcGIS Arcade 式を使用して組織メンバーの電子メール アドレスを取得するには、必要に応じてカスタム ロールを変更する必要があります。
ステップの構成
ステップを構成するには、次の手順に従います。
- ワークフロー ダイアグラムを作成または編集し、[ステップ ライブラリ] パネルにアクセスします。
- [電子メールの送信] を [ステップのライブラリ] パネルからワークフロー キャンバス上のステップの接続矢印にドラッグします。
[ステップの詳細] パネルが表示されます。
- [ステップ名] テキスト ボックスにステップの名前を入力します。
- 必要に応じて [To]、[CC]、[BCC] テキスト ボックスにセミコロンで区切った電子メール アドレスを入力するか、受信者の動的なリストを作成する ArcGIS Arcade 式を使用します。
1 つの電子メール アドレス
user1@test.com
複数の電子メール アドレス
user1@test.com;user2@test.com;user3@test.com;user4@test.com
1 つの Arcade 式
"GetUser($CurrentPortal, JobOwner($Job))['Email']"
複数の Arcade 式
"GetUser($CurrentPortal, JobOwner($Job))['Email']";"GetUser($CurrentPortal)['Email']";"GetUser($CurrentPortal, LastRunner($Job, 'f50d740d-cc04-9296-4ce3-181e82604465'))['Email']"
電子メール アドレスと Arcade 式
user1@test.com;"GetUser($CurrentPortal, JobOwner($Job))['Email']";user3@test.com;"GetUser($CurrentPortal)['Email']"
注意:
少なくとも 1 つの有効な電子メール アドレスまたは Arcade 式を、[To]、[CC]、[BCC] テキスト ボックスに入力する必要があります。
ヒント:
[この入力は Arcade 式をサポートします]
をクリックし、ArcGIS Arcade 式を選択して関連するテキスト ボックスに追加します。 - 電子メール通知の件名を [件名] テキスト ボックスに入力します。
ArcGIS Arcade 式を使用して、件名の動的な値を入力することもできます。 件名にプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定します。
JobName($Job) + 'is ready' - 電子メール通知のメッセージ テキストを [本文] テキスト ボックスに入力します。
ArcGIS Arcade 式を使用して、本文の動的な値を入力することもできます。
本文にプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定します。
'<b>' + JobName($Job) + '</b>, created by <b>' + JobCreator($Job) + '</b>, was started on <b>' + Text(Date(JobStartDate($Job)), 'dddd, MMMM D, Y') + '</b>.'注意:
[本文] テキスト ボックスで HTML タグを使用するには、HTML 通知オプションを有効にする必要があります。
- ジョブにアタッチメントが含まれている場合は、必要に応じて、[アタッチメントを含める] の下にあるオプションを使用して電子メール通知にそのアタッチメントを含めます。
- [なし] - 電子メール通知にジョブ アタッチメントを含めません。
- [すべて] - 電子メール通知にすべてのジョブ アタッチメント フォルダーを含めます。
- [フォルダー別] - [フォルダー別] テキスト ボックスにジョブ アタッチメント フォルダー名のカンマ区切りリストを入力して、電子メール通知に含めるジョブ アタッチメント フォルダーを指定します。
注意:
ジョブ アタッチメント フォルダーは、ワークフロー アイテムに含まれるため、ファイル システム パスではありません。
注意:
ジョブに複数のアタッチメントが含まれている場合、1 つの .zip ファイルとして送信され、ジョブのアタッチメント フォルダー構造は維持されます。
- 必要に応じて、[電子メールのプレビュー] をクリックし、電子メールをプレビューします。
注意:
電子メールにジョブ固有の Arcade 式が含まれている場合は、Arcade 式をプレビューする前に、[電子メールのプレビュー] テキスト ボックスに有効なジョブ ID を入力する必要があります。 電子メールにステップの出力値の Arcade 式が含まれている場合は、出力値をプレビューする前にステップが完了している必要があります。
[電子メールのプレビュー] ウィンドウが開き、受信者のリストおよび件名と本文のプレビューが表示されます。
- [オプション] タブをクリックします。
- 必要に応じて、[ステップ オプション] を構成します。
- [手動] - 手動でステップを実行します。
- [オプション] - ステップを実行しないで終了できるようにします。
- [自動] - アクティブになり次第、ステップを実行します
注意:
ワークフロー ダイアグラムがデータ品質の評価ステップまたはジオプロセシング サービスの実行ステップを含む一連のステップを自動的に実行するように構成されている場合、一連のステップを開始したユーザー トークンの有効期限が切れた後に実行を試みるステップは、自動的に実行されません。 手動操作なしで、さらなる自動ステップの実行を継続するには、ArcGIS Workflow Manager Server Advanced ロールのライセンスが必要です。
- [スケジュールに沿って実行] - 設定したスケジュールに従ってステップを実行します。
- [手動] - 手動でステップを実行します。
- 必要に応じて、[ステップ ヘルプ] テキスト ボックスにステップのヘルプ テキストを入力します。
ArcGIS Arcade 式を使用して、ステップ ヘルプの動的な値を入力することもできます。 ステップ ヘルプにプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定する必要があります。
'For further assistance, please contact' + JobCreator($Job) + '.' - 必要に応じて、[スタイル] タブをクリックし、ステップの形状と色を変更します。
- 必要に応じて、[情報] タブをクリックし、[ステップの説明] テキストボックスにステップの説明を入力します。
ヒント:
[情報] タブには、ステップの出力を取得するために動的なジョブ プロパティで使用できるステップ ID も含まれています。 ステップ ID をクリップボードにコピーするには、[ステップ ID をコピー]
をクリックします。
戻り値
ステップが完了すると、その戻り値が格納され、ステップの結果を示します。 パスを使用して戻り値をすぐに評価し、ワークフロー内の次のステップを決定できます。 ArcGIS Arcade 式を使用して、ワークフロー全体を通じて完了したステップの戻り値を取得することもできます。 次の表は、ステップの戻り値を示しています。
| 戻り値 | 説明 |
|---|---|
| S000001 | ステップが正常に完了しました。 |
F000001 | ステップを正常に完了できませんでした。 |