arcade

Arcade

Arcade はプロファイルごとにスコープが異なり、バージョンによって使用可否が変わります。同じ式でも、あるプロファイルでは有効で、別のプロファイルでは意味をなさないことがあります。また、ある Arcade バージョンに存在する関数が、それより前のバージョンには存在しないこともあります。コードを書く前に、両方を確認してください。

最初にプロファイルを特定する

プロファイルごとに公開されるグローバル変数が異なり、戻り値の型も異なります。プロファイルを確認せずに書くと、作成者の頭の中では動いていてもアプリでは失敗する式になります。たとえば、ポップアップ用の式を属性ルールに貼り付けると、そのプロファイルには存在しないグローバル変数を参照してしまいます。

• ポップアップ — $feature、$map、$datastore などのグローバル変数を使用し、表示用のテキストまたは辞書を返します。
• ラベリング — 各フィーチャのラベル文字列を返します。
• フィールド計算 — 対象フィールドに書き込む値を返します。
• 属性ルール（計算、制約、検証）— $originalFeature などの編集コンテキストのグローバル変数を使用します。ルールの種類ごとに異なる戻り値が必要です。

式を作成する前に、対象となるプロファイルを確認してください。

Arcade のバージョンを固定する

Arcade で使用できる関数は、バージョンによって異なります。Arcade のバージョンは ArcGIS Maps SDK for JavaScript のバージョンによって固定され、そのバージョンは ArcGIS Enterprise のリリース（または ArcGIS Online）によって固定されます。「最新」と仮定するのではなく、Esri の最新のバージョンマトリックス https://developers.arcgis.com/javascript/latest/version-matrix/ で対象を確認してください。これにより、公開されている最新の対応表に基づいて毎回再確認できます。

すべてのグローバル変数と関数を検証する

式を公開する前に、arcgis-docs-lookup を使用して、式で使うすべてのグローバル変数と関数が対象の Arcade バージョンにおける対象プロファイルで使用できることを確認してください。後の Arcade リリースで追加された関数は、古い Enterprise ではエラーなく動作しなくなります。

完了条件

プロファイルが特定され、戻り値の型がそのプロファイルに一致し、使用するすべてのグローバル変数と関数が対象の Arcade バージョンで使用可能だと確認できていること。