電子メールの送信ステップでは、ステップが実行されると、1 人または複数の受信者に電子メール通知が送信されます。 このステップ タイプを使用すると、ステップやジョブが完了した場合や、ステップが正常に完了しなかった場合に、通知を送信することができます。
電子メールの送信ステップを使用して電子メール通知を送信する前に、以下を行う必要があります。
- 電子メールの送信ステップを使用して電子メール通知を送信するには、ArcGIS Workflow Manager の電子メール通知設定を構成する必要があります。
- ArcGIS Arcade 式を使用してポータル メンバーの電子メール アドレスを取得するには、必要に応じてカスタム ロールを変更する必要があります。
ステップの構成
ステップを構成するには、次の手順に従います。
- ワークフロー ダイアグラムを作成または編集し、[ステップ ライブラリ] パネルにアクセスします。
- [電子メールの送信] を [ステップのライブラリ] パネルからワークフロー キャンバス上のステップの接続矢印にドラッグします。
[ステップの詳細] パネルが表示されます。
- [ステップ名] テキスト ボックスにステップの名前を入力します。
- 必要に応じて [To]、[CC]、[BCC] テキスト ボックスにセミコロンで区切った電子メール アドレスを入力するか、受信者の動的なリストを作成する ArcGIS Arcade 式を使用します。
少なくとも 1 つの有効な電子メール アドレスまたは Arcade 式を、[To]、[CC]、[BCC] テキスト ボックスに入力する必要があります。
注意:
[To]、[CC]、[BCC] テキスト ボックスの 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']"
ヒント:
[この入力は 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) + '.' - [URL] - [URL] テキストボックスで、ステップにヘルプ リソースへのリンクを構成します。
注意:
Web アプリで実行されるステップでは、HTTP、HTTPS URL 形式のみがサポートされます。 ArcGIS Pro で実行されるステップでは、HTTP、HTTPS、ファイル形式がサポートされます。
Arcade 式を使用して動的な値を入力することもできます。 URL にプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定する必要があります。
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'[Arcade の結果を自動的にエンコード] チェックボックスを構成します。
- URL に変換するときにエスケープする必要がある特殊文字 (スペースやフォワード スラッシュなど) を Arcade 式が返す場合、[Arcade の結果を自動的にエンコード] チェックボックスを必ずオンにしてください。
- ベース URL を構成するために Arcade 式が使用される場合、[Arcade の結果を自動的にエンコード] チェックボックスをオフにします。
- 必要に応じて、[スタイル] タブをクリックし、ステップの形状と色を変更します。
- 必要に応じて、[情報] タブをクリックし、[ステップの説明] テキストボックスにステップの説明を入力します。
ヒント:
[情報] タブには、ステップの出力を取得するために動的なジョブ プロパティで使用できるステップ ID も含まれています。 ステップ ID をクリップボードにコピーするには、[ステップ ID をコピー]
をクリックします。
戻り値
ステップが完了すると、その戻り値が格納され、ステップの結果を示します。 パスを使用して戻り値をすぐに評価し、ワークフロー内の次のステップを決定できます。 ArcGIS Arcade 式を使用して、ワークフロー全体を通じて完了したステップの戻り値を取得することもできます。 次の表は、ステップの戻り値を示しています。
| 戻り値 | 説明 |
|---|---|
| S000001 | ステップが正常に完了しました。 |
F000001 | ステップを正常に完了できませんでした。 |