Web リクエストテンプレートの作成と管理—Workflow Manager Server

ライセンス:

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

ジョブアクティビティを使用して Web リクエストテンプレートを構成すると、ワークフローで特定のジョブアクティビティが実行された際に、Web リクエストを自動的に REST エンドポイントに送信できます。たとえば、Web リクエストテンプレートを構成して、データを取得したり、ジョブが更新された際にサードパーティシステムに更新内容をポストしたりすることができます。その後、レスポンスをカスタム出力値として格納して、ワークフローパスを指示したり、ジョブプロパティを更新したりすることができます。

Web リクエストテンプレートの作成

Web リクエストテンプレートを作成するには、次の手順を実行します。

Workflow Manager Web アプリにアクセスします。
[設計] タブをクリックします。
[設計] ページが開きます。
注意:
十分な権限がない場合は、[設計] タブは使用できません。
[テンプレート] をクリックします。
注意:
十分な権限がない場合は、[テンプレート] は使用できません。
[Web リクエスト] タブをクリックします。

[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 リクエストテンプレートの出力設定を構成することができます。
注意:
テンプレートが構成されているジョブアクティビティは、Web リクエストの出力値をテストする前に完了している必要があります。
必要に応じて [テスト] タブをクリックし、[応答のテスト] をクリックして、構成済みのリクエストを送信し、その応答を表示します。
Web リクエストにジョブ固有の Arcade 条件式が含まれている場合、[ジョブ ID を含める] をオンにし、[ジョブ ID] テキストボックスにジョブ ID を入力して、リクエストの書式を適切に設定する必要があります。

トークン設定の構成

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

[認証] タブで、[API キー] または [ベアラートークン] オプションを選択し、[または、エンドポイントからトークンを生成する] をクリックします。
[エンドポイントからのトークンの生成] 設定が [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
    }
  }
]}

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

出力設定の構成

ライセンス:

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

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

[出力] タブをクリックします。
必要に応じて、[レスポンスの添付] セクションの [有効] 切り替えボタンをクリックし、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 リクエストテンプレートの編集

Web リクエストテンプレートを編集するには、次の手順を実行します。

Workflow Manager Web アプリにアクセスします。
[設計] タブをクリックします。
[設計] ページが開きます。
注意:
十分な権限がない場合は、[設計] タブは使用できません。
[テンプレート] をクリックします。
注意:
十分な権限がない場合は、[テンプレート] は使用できません。
[Web リクエスト] タブをクリックします。

[Web リクエスト] パネルが表示されます。

注意:
十分な権限がない場合は、[Web リクエスト] タブは使用できません。
[Web リクエスト] パネルで編集する Web リクエストの名前をクリックします。
ヒント:
[Web リクエストテンプレートの検索] テキストボックスに検索語句を入力することで、[Web リクエスト] パネルの Web リクエストのリストをフィルターすることができます
必要に応じて、Web リクエストを更新します。
[保存] をクリックして変更内容を保存します。

Web リクエストテンプレートの削除

Web リクエストテンプレートを削除すると元に戻せません。 Web リクエストテンプレートを削除するには、次の手順を実行します。

Workflow Manager Web アプリにアクセスします。
[設計] タブをクリックします。
[設計] ページが開きます。
注意:
十分な権限がない場合は、[設計] タブは使用できません。
[テンプレート] をクリックします。
注意:
十分な権限がない場合は、[テンプレート] は使用できません。
[Web リクエスト] タブをクリックします。

[Web リクエスト] パネルが表示されます。

注意:
十分な権限がない場合は、[Web リクエスト] タブは使用できません。
[Web リクエスト] パネルで削除する Web リクエストの名前をクリックします。
ヒント:
[Web リクエストテンプレートの検索] テキストボックスに検索語句を入力することで、[Web リクエスト] パネルの Web リクエストのリストをフィルターすることができます
[その他のアクション] をクリックし、[削除] をクリックします。
確認のメッセージが表示されます。
Web リクエストを削除する場合は [はい] をクリックし、キャンセルする場合は [いいえ] をクリックします。

ライセンス:

Web リクエスト テンプレートの作成

注意:

注意:

注意:

ヒント:

注意:

注意:

ヒント:

注意:

トークン設定の構成

ヒント:

ヒント:

出力設定の構成

ライセンス:

注意:

Web リクエスト テンプレートの編集

注意:

注意:

注意:

ヒント:

Web リクエスト テンプレートの削除

注意:

注意:

注意:

ヒント:

関連トピック

このトピックの内容

Web リクエストテンプレートの作成

Web リクエストテンプレートの編集

Web リクエストテンプレートの削除