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 版本中均可用。