Arcade 式

ArcGIS Arcade を使用して、ArcGIS QuickCapture でキャプチャーしたレコードのフィールドを計算できます。 プロジェクトの作成者は、Arcade 関数、演算子、レコード値を使用する式を記述できます。

Arcade QuickCapture プロファイルには、レコード値を返すために使用できる以下の変数が含まれています。

  • $feature - 現在のレコードの属性
  • $layer - 現在のレコードと同じレイヤー内のフィーチャ
  • $datastore - 現在のレコードと同じフィーチャ サービスまたはデータベース内のレイヤー
  • $map - QuickCapture プロジェクトで使用される Web マップ内のフィーチャ サービス レイヤーのコレクション

詳細については、「QuickCapture プロファイル変数」をご参照ください。

デフォルトでは、プロジェクト Web マップにプロジェクト レイヤーが含まれていないため、名前でレイヤーを参照する式 (var layername = FeatureSetByName($map, "layer_name") など) を使用できるようにするには、QuickCapture プロジェクトの構成時に Web マップを作成するオプションを選択するか、デフォルトの Web マップを式に必要なすべてのレイヤーを含むマップに置き換える必要があります。 詳細については、「プロジェクト マップの構成」をご参照ください。

注意:

プロジェクトで Arcade 式を使用する場合、プロジェクト レイヤーと Web マップに DateOnly、TimeOnly、TimestampOffset、または BigInteger フィールド タイプがないか確認します。 これらのフィールドを除外したホスト フィーチャ レイヤー ビューを作成し、代わりにそのレイヤー ビューをプロジェクトで使用する必要があります。 これらのフィールド タイプは、QuickCapture モバイル アプリで使用されている Arcade バージョン (1.18) ではサポートされていません。

詳細については、「ArcGIS Online でのホスト フィーチャ レイヤー ビューの作成」または「ArcGIS Enterprise でのホスト フィーチャ レイヤー ビューの作成」をご参照ください。

Arcade 式として構築できる使用例を次に示します。

  • 別のフィールドの値から値を計算します。
  • 属性値を返すポイントとポリゴン クエリーを実行します。
  • キャプチャーされたポリラインの時間長を計算する関数を使用します。

QuickCapture デザイナーは、作成者が式を構築するのに役立つ式ビルダーを含み、QuickCapture プロファイルを使用します。 ユーザー入力が一度定義され、複数のボタンで使用できるのと同様の方法で、Arcade 式を一度デザイナーに保存すると、複数のボタンに割り当てることができます。

ArcGIS が管理するフィールド (OBJECTID、GlobalID、CreationDate、Creator、EditDate、Editor など) は、レコードが送信されるまでその値がわからないため、式では使用しないでください。 式にユーザー名またはレコード取得日の値が必要な場合、その式はデバイス変数が設定されたフィールドを参照する必要があります。

注意:

デバイスがオフラインのときに取得された Arcade 式を含むレコードだけが、デバイスが次にオンラインになったときに処理されてから送信されます。

Arcade の使用

フィールドの Arcade 式を構成するには、次の手順を実行します:

  1. 組織サイトにサイン インしていることを確認します。
  2. プロジェクトを開き、構成するボタンを選択します。
  3. [データ] タブで、取得フィールドのドロップダウン メニューから、[Arcade 式] を選択し、[新規作成] を選択します。

    新しい Arcade 式を作成します。

  4. [プロファイル変数][関数] メニュー アイテムを使用して式を作成します。
  5. 式のラベルを指定し、[作成] を選択します。

作成した式のラベルは、Web デザイナーの [データ] タブにある取得フィールドに表示されます。 この式は、このプロジェクト内の他のボタンの取得フィールドでも再利用できます。

ArcGIS Arcade アシスタント (ベータ版) の使用

ArcGIS Arcade アシスタント (ベータ版) は、人工知能 (AI) を使用し、自然言語で入力された指示から Arcade 式を生成します。 最適な結果を得るには、明確で平易な言語を使用し、受け取った回答を反復処理します。

QuickCaptureArcGIS Arcade アシスタント (ベータ版) を使用するには、次の手順を実行します:

  1. 組織サイトにサイン インしていることを確認します。

    AI アシスタントを使用する権限を持つロールの組織のメンバーとしてサイン インする必要があります。

  2. プロジェクトを開き、構成するボタンを選択します。
  3. [データ] タブで、取得フィールドのドロップダウン メニューから、[Arcade 式] を選択し、[新規作成] を選択します。
  4. [Arcade アシスタント] ボタン Arcade アシスタント (ベータ版) をクリックします。

    [Arcade アシスタント] ウィンドウが表示されます。

  5. アシスタントを使用するには、次のいずれかを実行します。
    • 候補をクリックして変更し、データに合ったプロンプトを構築します。
    • 優先言語で、プロンプトを入力し、Arcade 式を作成します。
  6. [生成] をクリックして、クエリーを実行します。

    ArcGIS Arcade アシスタント (ベータ版) は、[Arcade アシスタント] ウィンドウに式を示します。

    ヒント:

    [プロファイルのコンテキスト] ボタン プロファイルのコンテキスト にポインターを合わせて、レイヤー構成で提案された式が適用される場所を確認します。

  7. 提案を操作するには、次のいずれかを実行します。
    • [エディターに追加] をクリックして、式の設定ウィンドウに式を追加します。
      ヒント:

      式の設定ウィンドウでコンテンツを追加する場所にポインターを置きます。 たとえば、式の設定ウィンドウで、ポインターを移動して、既存のコード行の前をクリックします。 [Arcade アシスタント] ウィンドウの [エディターに追加] をクリックすると、提案された式は式の設定ウィンドウのポインター位置に追加されます。

    • [エディターですべてのコードを置換] エディターですべてのコードを置換 をクリックして、式の設定ウィンドウ内の既存のコンテンツを提案された式に置き換えます。
    • [クリップボードにコードをコピー] クリップボードにコードをコピー をクリックして提案された式をクリップボードにコピーします。
    • プロンプトを調整するには、テキスト エリアの前のプロンプトを編集するか、前のプロンプトをコピーして貼り付け、[調整] をクリックして修正したクエリーを送信します。
    • アシスタントのフィードバックを提供するには、[役立つ] 役立つ または [役立たない] 役立たない ボタンをクリックし、調査を完了します。 フィードバックは、さらなる開発の指針として使用されます。
  8. クエリーの履歴を消去して最初からやり直すには、随時 [やり直す] をクリックします。
注意:

ArcGIS Arcade アシスタント (ベータ版) の使用方法の詳細については、「ベスト プラクティスの理解」および「コンテキストの制限事項について」をご参照ください。