Web リクエストの送信の追加および構成—Workflow Manager Server

ライセンス:

この機能には、ArcGIS Workflow Manager Server Advanced ロールのライセンスが必要です。

Web リクエストの送信ステップでは、REST エンドポイントにリクエストを送信してデータを取得したり、更新情報を投稿したりすることができます。 REST エンドポイントのレスポンスをカスタム出力値として構成し、ファイルとして保存して、ジョブに添付することができます。カスタム出力値は、後続の REST 呼び出しのトークンの取得やワークフローパスの指示に使用したり、他のステップの入力値として使用したりすることができます。

ステップが実行されると、ステップで定義された REST エンドポイントに Web リクエストが送信されます。

ステップは、[ステップの完了] Complete Step をクリックすることで完了できます。

ステップの構成

ステップを構成するには、次の手順に従います。

注意:

セキュリティの脆弱性を低減するには、信頼できる Web ページや Web アプリに対してのみ Web リクエストの送信ステップを構成してください。

ワークフローダイアグラムを作成または編集し、[ステップライブラリ] パネルにアクセスします。
[Web リクエストの送信] を [ステップのライブラリ] パネルからワークフローキャンバス上のステップの接続矢印にドラッグします。
ワークフローダイアグラムにステップを追加する方法の詳細

[ステップの詳細] パネルが表示されます。
[ステップ名] テキストボックスにステップの名前を入力します。
[引数] セクションで [編集] をクリックします。
[URL] ドロップダウン矢印をクリックし、送信するリクエストのタイプを選択します。
[URL] テキストボックスに REST エンドポイントの URL を入力します。
必要に応じて、次の構文を使用して URL にパス変数を追加します。
```
https://gisserver.domain.com/webadaptorname/apps/workflowmanager/:pathVariable/
```
パス変数が [パス変数] セクションに表示されます。
必要に応じ、Web リクエストにクエリパラメーターを追加します。
1. [クエリパラメーター] セクションで [キーと値の追加] をクリックします。
2. [キー] テキストボックスにキーを入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
3. [値] テキストボックスに値を入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
4. [有効] チェックボックスはオンのままにしておきます。
5. キー値ペアをさらに追加するには、サブステップ a ～ d を繰り返します。
URL にパス変数を追加した場合は、[パス変数] セクションで各変数の値を入力します。
ArcGIS Arcade 式を使用して動的な値を入力することもできます。
ヒント:
[この入力は Arcade 式をサポートします] をクリックし、ArcGIS Arcade 式を選択して関連するテキストボックスに追加します。
[認証] タブをクリックします。
REST エンドポイントの認証方法を選択し、必要に応じて認証情報を入力します。
注意:
ステップで入力する認証情報は暗号化されません。情報を安全に格納するには、動的なジョブプロパティを使用してステップ内で参照可能な暗号化されたユーザー定義設定を追加します。
注意:
[フェデレーショントークン] オプションを使用すると、ステップを実行するユーザーとして Web リクエストを承認できます。 [フェデレーショントークン] オプションは、Workflow Manager と同じ Enterprise サイトに公開されているサービスとのみ互換性があります。
1. [API キー] または [ベアラートークン] オプションを選択した場合は、必要に応じて、[または、エンドポイントからトークンを生成する] をクリックします。
  [エンドポイントからのトークンの生成] ダイアログボックスが表示されます。
2. トークン設定を構成して、Web リクエストのトークンを生成します。
必要に応じて、[ヘッダー] タブをクリックし、カスタムヘッダーのキー値ペアを Web リクエストに追加します。
1. [カスタムヘッダー] セクションで [キーと値の追加] をクリックします。
2. [キー] テキストボックスにキーを入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
3. [値] テキストボックスに値を入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
4. [有効] チェックボックスはオンのままにしておきます。
5. キー値ペアをさらに追加するには、サブステップ a ～ d を繰り返します。
必要に応じて、[本文] タブをクリックして、Web リクエストにデータを追加します。
リクエストの本文は、フォームデータのキー値ペア、URL エンコードされたキー値ペア、および JSON 形式またはプレーンテキスト形式の未加工データをサポートしています。
ヒント:
また、ArcGIS Arcade 式を使用して、ユーザー定義設定を取得したり、本文テキストに動的な値を入力したりすることもできます。
必要に応じて、ArcGIS Workflow Manager Server Advanced ロールのライセンスが付与されている場合は、ステップの出力設定を構成することができます。
必要に応じて [テスト] タブをクリックし、[応答のテスト] をクリックして、構成済みのリクエストを送信し、その応答を表示します。
Web リクエストにジョブ固有の Arcade 条件式が含まれている場合、[ジョブ ID を含める] をオンにし、[ジョブ ID] テキストボックスにジョブ ID を入力して、リクエストの書式を適切に設定する必要があります。
[保存] をクリックして、[Web リクエストの構成] ダイアログボックスを閉じます。
[オプション] タブをクリックします。
必要に応じて、[ステップオプション] を構成します。
- [手動] - 手動でステップを実行します。
  - [オプション] - ステップを実行しないで終了できるようにします。
- [自動] - アクティブになり次第、ステップを実行します
  注意:
  ワークフローダイアグラムがデータ品質の評価ステップまたはジオプロセシングサービスの実行ステップを含む一連のステップを自動的に実行するように構成されている場合、一連のステップを開始したユーザートークンの有効期限が切れた後に実行を試みるステップは、自動的に実行されません。手動操作なしで、さらなる自動ステップの実行を継続するには、ArcGIS Workflow Manager Server Advanced ロールのライセンスが必要です。
- [スケジュールに沿って実行] - 設定したスケジュールに従ってステップを実行します。
  スケジュールオプションの詳細
必要に応じて、[ステップヘルプ] テキストボックスにステップのヘルプテキストを入力します。
ArcGIS Arcade 式を使用して、ステップヘルプの動的な値を入力することもできます。ステップヘルプにプレーンテキストと Arcade 式が含まれている場合は、テキストを次のように書式設定する必要があります。
```
'For further assistance, please contact' + JobCreator($Job) + '.'
```
必要に応じて、[スタイル] タブをクリックし、ステップの形状と色を変更します。
必要に応じて、[情報] タブをクリックし、[ステップの説明] テキストボックスにステップの説明を入力します。
ヒント:
[情報] タブには、ステップの出力を取得するために動的なジョブプロパティで使用できるステップ ID も含まれています。ステップ ID をクリップボードにコピーするには、[ステップ ID をコピー] をクリックします。

トークン設定の構成

Web リクエストの送信先の REST エンドポイントに認証用のトークンが必要な場合、次の手順を実行して、認証用のトークンを生成するよう Web リクエストの送信ステップを構成します。

[URL] ドロップダウン矢印をクリックし、送信するリクエストのタイプを選択します。
[URL] テキストボックスに REST エンドポイントの URL を入力します。
必要に応じて、次の構文を使用して URL にパス変数を追加します。
```
https://gisserver.domain.com/webadaptorname/apps/workflowmanager/:pathVariable/
```
パス変数が [パス変数] セクションに表示されます。
必要に応じ、Web リクエストにクエリパラメーターを追加します。
1. [クエリパラメーター] セクションで [キーと値の追加] をクリックします。
2. [キー] テキストボックスにキーを入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
3. [値] テキストボックスに値を入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
4. [有効] チェックボックスはオンのままにしておきます。
5. キー値ペアをさらに追加するには、サブステップ a ～ d を繰り返します。
URL にパス変数を追加した場合は、[パス変数] セクションで各変数の値を入力します。
ArcGIS Arcade 式を使用して動的な値を入力することもできます。
ヒント:
[この入力は Arcade 式をサポートします] をクリックし、ArcGIS Arcade 式を選択して関連するテキストボックスに追加します。
必要に応じて、[ヘッダー] タブをクリックし、カスタムヘッダーのキー値ペアを Web リクエストに追加します。
1. [カスタムヘッダー] セクションで [キーと値の追加] をクリックします。
2. [キー] テキストボックスにキーを入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
3. [値] テキストボックスに値を入力します。
  ArcGIS Arcade 式を使用して動的な値を入力することもできます。
4. [有効] チェックボックスはオンのままにしておきます。
5. キー値ペアをさらに追加するには、サブステップ a ～ d を繰り返します。
必要に応じて、[本文] タブをクリックして、Web リクエストにデータを追加します。
リクエストの本文は、フォームデータのキー値ペア、URL エンコードされたキー値ペア、および JSON 形式またはプレーンテキスト形式の未加工データをサポートしています。
ヒント:
また、ArcGIS Arcade 式を使用して、ユーザー定義設定を取得したり、本文テキストに動的な値を入力したりすることもできます。
[トークン] タブをクリックします。
[トークン] セクションで [モードのテスト] 切り替えボタンをクリックします。

REST エンドポイントのレスポンスの例を [サンプルレスポンス] テキストボックスに貼り付けます。

JSON 形式によるレスポンスの例:

{"access_token": "12345abcde",
"expires_in":7199,
"spatialReference": {
  "wkid": 4326,
  "latestWkid": 4326
},
"location": [
  {
    "name": "380 New York Street",
    "extent": {
      "xmin": -117.196701,
      "ymin": 34.055489
    }
  }
]}

[出力値] テキストボックスにトークンの名前を入力します。
これは、生成されたトークンを参照するステップで使用される名前です。
応答を解析し、生成されたトークンを返す JSONPath 式を [抽出パス] テキストボックスにドット記法またはブラケット記法で入力します。
ドット記法による JSONPath の例:
```
$.access_token
```
ブラケット記法による JSONPath の例:
```
$['access_token']
```
値は [サンプル結果] 列に表示されます。
[ステップの構成に戻る] をクリックして、ステップの構成を続行します。

出力設定の構成

ライセンス:

この機能には、ArcGIS Workflow Manager Server Advanced ロールのライセンスが必要です。

REST エンドポイントのレスポンスをファイルとして保存し、ジョブに添付したり、カスタム出力値として構成したりすることができます。出力値は、ワークフローパスの指示に使用したり、他のステップの入力値として使用したりすることができます。ステップに出力値が構成されていない場合は、HTTP ステータスコードがステップの出力値として格納されます。ステップの出力設定を構成するには、次の手順を実行します。

[Web リクエストの構成] ダイアログボックスで [出力] タブをクリックします。
[Web リクエストの構成] ダイアログボックスが使用できない場合は、ワークフローキャンバス上で [Web リクエストの送信] ステップをクリックし、[ステップの詳細] パネルの [引数] セクションで [編集] をクリックします。
必要に応じて、[レスポンスの添付] セクションの [有効] 切り替えボタンをクリックし、REST エンドポイントのレスポンスをファイルとして保存して、ジョブに添付します。
必要に応じて、添付ファイル名とレスポンスの格納先のフォルダーを構成します。
1. 添付ファイルが格納されるフォルダーの名前を [フォルダー名] テキストボックスに入力します。
  フォルダー名にファイルシステムパスまたは特殊文字を含めることはできません。フォルダー名が入力されていない場合、General という名前のフォルダーが自動的に作成されます。
  注意:
  フォルダーは、ワークフローアイテム内に含まれるため、ファイルシステムパスではありません。
2. 次の [添付ファイル名] オプションのうちの 1 つを選択します。
  - [自動生成] - 構文 (<StepName>_<RunDate>_<RunTime>) に従って、添付ファイル名を自動的に付与します。
  - [カスタム] - カスタムの添付ファイル名を入力できます。
必要に応じて、REST エンドポイントのレスポンスに対するカスタム出力値を構成します。
1. [出力値] セクションの [モードのテスト] 切り替えボタンをクリックします。
2. REST エンドポイントのレスポンスの例を [サンプルレスポンス] テキストボックスに貼り付けます。
  JSON 形式によるレスポンスの例:
  {"access_token": "", "expires_in":7199, "spatialReference": { "wkid": 4326, "latestWkid": 4326 }, "location": [ { "name": "380 New York Street", "extent": { "xmin": -117.196701, "ymin": 34.055489 } } ]}
3. [出力とパスの追加] をクリックします。
4. [出力値] テキストボックスに出力値の名前を入力します。
  これは、カスタム出力値の取得に使用される値の名前です。
5. [抽出パス] テキストボックスに格納する値の JSONPath 式をドット記法またはブラケット記法で入力します。
  ドット記法による JSONPath の例:
  $.location.0.name
  ブラケット記法による JSONPath の例:
  $['location'][0]['name']
  値は [サンプル結果] 列に表示されます。
6. 必要に応じて、サブステップ c ～ e を繰り返し、さらにカスタム出力値を追加します。
[保存] をクリックして、[Web リクエストの構成] ダイアログボックスを閉じます。

戻り値

ステップが完了すると、その戻り値が格納され、ステップの結果を示します。パスを使用して戻り値をすぐに評価し、ワークフロー内の次のステップを決定できます。 ArcGIS Arcade 式を使用して、ワークフロー全体を通じて完了したステップの戻り値を取得することもできます。次の表は、ステップの戻り値を示しています。


戻り値	説明
S000001	ステップが正常に完了しました。
F000001	ステップを正常に完了できませんでした。

出力値

ライセンス:

この機能には、ArcGIS Workflow Manager Server Advanced ロールのライセンスが必要です。

ステップが完了すると、その出力値が格納され、ワークフローがたどるパスの決定に使用したり、ワークフロー全体で他のステップの入力値として使用したりできます。次の表は、ステップの出力値を示しています。


出力	説明
ステータス	ステップに出力値が構成されていない場合は、HTTP レスポンスコードを返します。
<CustomOutputValue>	ステップに構成したカスタム出力値を返します。
attachmentId	ステップに追加された添付ファイル ID の配列を返します。

ライセンス:

ステップの構成

注意:

ヒント:

注意:

注意:

ヒント:

注意:

ヒント:

トークン設定の構成

ヒント:

ヒント:

出力設定の構成

ライセンス:

注意:

戻り値

出力値

ライセンス:

関連トピック

このトピックの内容