場所の定義の追加および構成

場所の定義ステップでは、ジョブで作業を行う必要がある場所を特定できます。 位置には、既存のフィーチャ サービス、ArcGIS Pro プロジェクト、または ArcGIS Workflow Manager Web アプリの Web マップ内のポイント、ライン、またはポリゴンを指定することができます。

ステップが Workflow Manager Web アプリで実行され、位置決定方法に [マップ] が選択された場合、ステップで構成された Web マップがジョブ タイルに表示されます。 ステップにヘルプ テキストが構成されている場合、ジョブ タイルの下部に表示されます。 選択可能レイヤーがマップ上に表示され、ジョブの位置レイヤーを除くすべての追加レイヤーが読み取り専用になります。 [レイヤーの管理] ウィジェット を使用して、個々のレイヤーの表示設定を変更し、[フィーチャの描画] または [フィーチャの選択] ウィジェットを使用して、ジョブの位置を定義します。

注意:

ジョブの位置がすでに定義されている場合、編集はできないものの、新しいフィーチャを描画または選択することで置き換えることができます。

ステップが ArcGIS Pro で実行され、選択方法に [マップ] が選択された場合、ステップが実行された際にステップで構成されたマップにジョブの位置レイヤーが追加され、[フィーチャの作成] ウィンドウにジョブ位置レイヤーが表示されます。 ステップにヘルプ テキストが構成されている場合、ジョブ タイルの下部に表示されます。 [フィーチャの作成] ウィンドウを使用して、ジョブの位置を定義します。

ジョブの位置に使用されるジオメトリのタイプは、ステップで構成されたジオメトリのタイプに基づいています。 ジョブの位置を定義する際は以下の条件を考慮してください。

• 正しいジオメトリ タイプを持つフィーチャのみが、ジョブの位置として保存できます。
• 正しいジオメトリ タイプの複数のポリゴンまたは複数のライン フィーチャが選択された場合、その位置はマルチパート フィーチャとして保存されます。
• Workflow Manager Web アプリで位置を描画すると既存の選択セットが削除され、フィーチャを選択すると描画した位置が削除されます。

位置決定方法に [マップ] を選択した場合、ステップの実行時に次のアクションを行うことができます

• ジョブの位置を定義できます。
• The step can be cancelled by clicking Cancel.
• The step can be finished by clicking Proceed.

位置決定方法に [ジオメトリ] を選択した場合、ステップの実行時にジョブの位置が自動的に定義され、ステップが自動的に完了します。 Arcade 式で返されたジオメトリが NULL または無効な場合、ステップは失敗します。 Arcade 式で返されたジオメトリ タイプが、ステップで構成されたジオメトリ タイプと一致しない場合、ステップは失敗します。

ステップの構成

To configure the step, do the following:

1. Create or edit a workflow diagram to access the Step Library panel.
2. [場所の定義] を [ステップのライブラリ] パネルからワークフロー キャンバス上のステップの接続矢印にドラッグします。

   Learn more about adding steps to a workflow diagram

   The Step Details panel appears.

3. Provide a name for the step in the Step Name text box.
4. Optionally, add the message you want to appear when the step is run in the User Prompt text box.

   If the user prompt contains plain text and Arcade expressions, you'll need to format the text as follows:

   'This job is currently assigned to ' + JobOwner($Job) + '.'

   ヒント:

   Click the This input supports Arcade Expressions button and choose an ArcGIS Arcade expression to add it to its associated text box.

5. [ジオメトリ タイプ] ドロップダウン矢印をクリックし、ジョブの位置のジオメトリ選択タイプを選択します。

   You can also use ArcGIS Arcade expressions to provide a dynamic value.

6. 次のオプションの中から 1 つを選択します。
   • [マップ] - マップ上でジョブの位置を定義することができます。
   • [ジオメトリ] - Esri JSON 形式の座標を使用して、ジョブの位置を自動的に定義します。
7. [マップ] を選択した場合、次の手順を実行します。
   1. 必要に応じて、[位置決定方法] オプションを選択します。
      • [選択] - マップ上の既存のフィーチャを選択します。
      • [描画] - ArcGIS Pro の描画ツールや Workflow Manager Web アプリのウィジェットを使用してフィーチャを作成します。
   2. [Web マップ] の下にある [マップ] セクションで、[追加] をクリックして、Workflow Manager Web アプリで操作する Web マップを追加します。

      [場所の定義ステップ] ダイアログ ボックスが表示されます。

      注意:

      Web マップは、ArcGIS Pro での位置の定義には使用できません。 ArcGIS Pro プロジェクトで位置を定義するには、操作するマップの名前を入力する必要があります。

   3. 次のオプションのいずれかを選択して、Web マップの配置先を指定します。
      • [この Enterprise] - Workflow Manager と同じポータルで使用できる Web マップを追加します。
      • [ArcGIS Online] - ArcGIS Online にあるパブリック Web マップを追加します。
      • [その他] - 別のポータルにあるパブリック Web マップを追加します。
   4. [その他] を選択した場合は、[ポータル URL] テキスト ボックスに Web マップを含むポータルの URL を入力し、Enter キーを押します。

      例: https://webadaptorhost.domain.com/webadaptorname

   5. [アイテム ID] テキスト ボックスに、Web マップのアイテム ID を入力します。
   6. [参照名] テキスト ボックスに Web マップの名前を入力します。
   7. [OK] をクリックします。

      Web マップの URL が [ステップの詳細] パネルに表示されます。

      注意:

      Web マップは、[編集] をクリックして編集したり、[削除] をクリックして削除したりすることができます。

   8. [ArcGIS Pro] テキスト ボックスに、ArcGIS Pro プロジェクトで操作するマップの名前を入力します。
   9. Web マップで [検索の有効化] が構成されている場合、必要に応じて [検索テキスト] テキスト ボックスにフィルター設定、検索テキスト、または Arcade 式を入力して、ステップが Workflow Manager Web アプリで実行される際に初期のマップ範囲がズームされるようにします。
8. [ジオメトリ] を選択した場合、以下の例に沿って、Esri JSON 形式の座標を使用してジョブの位置を定義します。

   位置の定義には、文字列、Arcade 式、または両方の組み合わせを使用できます。

   JSON 文字列を使用してポイントの位置を定義します。

   {"x" : -118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}}

   Arcade 式を使用してポイントの位置を定義します。

   '{"x":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testx') + ', "y":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testy') + ', "spatialReference" : {"wkid" : ' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'wkid') + "}}"

   GeoJSON の座標を Esri JSON 形式に変換する Arcade 式を使用して、ポイントの位置を定義します。

   {GeoJsonToEsriJson(JobExtendedProperty($Job, 'assets', 'geojson'), 'Point'), "spatialReference" : {"wkid" : 4326}}

   shape フィールドを使用して位置を定義します。

   JobExtendedProperty($Job, '<table_name>','shape')

   注意:

   shape フィールドは、拡張プロパティ テーブルからジオメトリを取得する際に使用されるフィールドの名前です。

   デフォルトの空間参照は、Web メルカトル (球体補正) (wkid 3857)です。 Arcade 式で返されたジオメトリの空間参照が異なる場合、その位置が定義され、空間参照は wkid 3857 に変換されます。

9. Click the Options tab.
10. Configure Step Options as necessary.
    • Manual—Run the step manually.
      • Optional—Allow the step to be finished without being run.
    • Automatic—Run the step as soon as it becomes active.

      注意:

      If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.

    • Run on a Schedule—Run the step according to a schedule you set.

      Learn more about scheduling options

11. Optionally, provide help text for the step in the Step Help text box.

    You can also use ArcGIS Arcade expressions to provide a dynamic value for the step help. If the step help contains plain text and Arcade expressions, you'll need to format the text as follows:

    'For further assistance, please contact ' + JobCreator($Job) + '.'

12. Optionally, click the Style tab to change the shape and color of the step.
13. Optionally, click the About tab and provide a description for the step in the Step Description text box.

    注意:

    The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.

Return value

When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:

Return values	Description
S000001	The step completed successfully.
F000001	The step failed to complete successfully.

出力値

When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:

出力	説明
<Location>	定義された位置を返します。