创建工程后，可以使用图形界面或 JSON 编辑器在 ArcGIS QuickCapture 设计器中对其进行配置。 您可以配置以下操作：
- 工程设置
- Groups
- 按钮
可以在工程的图形界面中编辑以下内容：
- 常规 - 设置所需或建议的位置精度、距离阈值，显示首选项、位置编辑首选项、坐标记法格式和捕获的照片质量。
- 图层 - 管理工程使用的图层。 将图层设置为默认图层后，添加到工程中的所有新按钮都将使用该图层的字段。 对于工程中使用的所有图层，您还可以为每个图层中的所有字段设置默认值和变量。
- 地图 - 选择工程要使用的地图。 默认情况下，将使用组织默认底图。 或者，可选择其他在线底图、web 地图、移动地图包，切片包或矢量切片包。 在平板设备上横向查看工程时，请选择将地图与按钮并排显示。 仅支持使用 Web 墨卡托空间参考的地图。
- 工程详细信息 - 编辑工程缩略图（使用纵横比为 3:2 的横向图像）、标题、数据恢复电子邮件、摘要、描述和使用条款。 可以在工程描述中使用超链接。
- 专属组 - 将多个线、面或流式点按钮放在一个组中，从而防止它们同时捕获数据。 任何时候组中均仅有一个按钮可处于活动状态。
- 工程用户输入 - 管理工程用户输入。 排列工程用户输入在工程中的显示顺序、创建、编辑或删除工程用户输入，以及可视化为所选工程用户输入分配的按钮。 您还可以在按钮的数据选项卡创建工程用户输入。
- Webhook - 配置工程中使用的 webhook，并指定名称、目标要素图层、webhook URL 以及要包含在负载中的信息。 您可以在一个工程中添加多个 webhook，并将每个 webhook 的状态设置为打开或关闭。
可以在图形界面中为各组编辑以下内容：
- 标注 - 工程中为该组显示的标注。
- 列数 - 组中的列数。
- 使组可折叠 - 显示组的首选项。 如果设置为可折叠，则默认状态为展开。
- 颜色 - 组的轮廓颜色，以 HTML 十六进制值表示。
可通过将组图标拖动到工程预览上来创建组。
提示：
您可以一次编辑多个组。 在工程预览中选择组的同时按 Shift 键可以选择多项。 您在侧面板中所做的编辑将应用于所有所选组。
可以使用按钮来捕获数据或启动 URL。 可以在图形界面中为按钮编辑以下内容：
- 外观 - 配置工程中按钮的外观。
- 标注 - 按钮标注和文本大小：小（默认值）、中和大。
- 大小 - 按钮大小。 使用滑块在最小到最大之间选择。
- 形状 - 按钮的形状可以是矩形或圆角矩形。
- 颜色 - 按钮背景和轮廓的颜色，以 HTML 十六进制值表示。
- 图像 - 按钮图像。 使用浏览图库从图标库中选择图像，或选择上传新图像以上传您自己的图像。 在选择图像时，请考虑按钮的大小。 按钮图像限于 1 MB。
- 数据 - 点击按钮时将为每个字段采集的数据类型。
- 链接 - 按下按钮后将启动的专用 URL。
提示：
您可以一次编辑多个按钮。 在工程预览中选择按钮的同时按 Shift 键可以选择多项。 您在侧面板中所做的编辑将应用于所有所选按钮。
可通过在工程预览上拖动按钮图标来创建用于捕获数据的按钮。 新按钮将具有默认图层的字段。 如果尚未为工程设置默认图层，则作者必须通过在按钮侧面板的数据选项卡上选择按钮来添加按钮的数据源。
注：
只有可编辑字段显示在数据选项卡上。 无法在设计器中配置不可编辑字段。
要添加启动 URL 的按钮，请在工程预览上拖动链接图标。 在链接选项卡上，选择 URL 手动定义 URL 或选择 Survey123 外业应用程序以选择要链接的调查。
可以复制或删除现有按钮。 在工程预览中选择按钮，然后在按钮侧面板的外观选项卡上选择复制或删除按钮。
可以通过更改工程 JSON 来编辑这些属性以及其他属性。 您可以在 QuickCapture 设计器和您首选的 JSON 编辑器之间复制和粘贴代码，或直接在设计器中对其进行编辑。 设计器中的语法检查非常有限，因此在进行编辑时请务必小心。 在在线 JSON 验证器中检查代码片段可能会很有帮助。
在工程 JSON 中编辑十进制类型的属性时，应始终使用句点 (.) 作为小数分隔符。 其他小数分隔符将不起作用。
以下部分提供了关于对工程最常进行的自定义操作的详细信息。
流式点
工程作者可以将点按钮配置为连续捕获，其操作方式类似于线和面按钮。 当您要记录 GNSS 元数据和其他数据（例如沿路径的每个折点的速度）时，流式点捕获非常有用。 路径的每个折点都由一个点表示，且可以连续自动发送到 ArcGIS。
如果将按钮用户输入应用于点按钮，则无法在该按钮上启用流模式。 如果已经为点按钮选择了流模式，则按钮用户输入无法应用于该按钮。
流式点捕获无法用于主动追踪移动工作人员的位置。
有关详细信息，请参阅位置共享。
捕获后显示地图
工程作者可以配置点按钮以在捕获后显示地图。 在此地图上，移动工作人员可以直观地确认捕获的位置，还可以平移地图以捕获更准确的位置。
启用地图后，工程作者还可以自定义地图标题或地图提示，为移动工作人员提供指导或说明。
固定值
当按下按钮时，可以将固定值应用于字段。 该固定文本由作者定义，并受到字段类型和长度的限制。 例如，整型字段无法接受十进制值或文本值。
设备变量
设备变量用于自动填充具有常用 GIS 属性的 QuickCapture 字段。 并非所有变量都可应用于所有类型的字段。 例如，时间戳变量仅适用于日期类型的字段。
一些变量将自动分配给具有特定名称的按钮字段。 您可以选择在要素图层中手动创建这些指定字段，也可在 ArcGIS Online 中创建要素图层或在 ArcGIS Enterprise 中创建要素图层时选择捕获 GPS 接收器信息。
设备信息
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
工程名称 变量名称：projectName 用于捕获记录的工程名称。 | 文本 | 点、线、面 | - |
安装 UUID 变量名称：installUUID 安装时创建的移动应用程序的唯一标识符。 此变量可用于唯一标识设备。 | 文本 | 点、线、面 | - |
应用程序版本 变量名称：appVersion QuickCapture 版本。 | 字符串 | 点、线、面 | - |
操作系统 变量名称：operatingSystem 平台和操作系统版本。 | 字符串 | 点、线、面 | - |
会话 ID 变量名称：sessionId 每次打开位置共享时都会生成一个唯一 ID。 | 字符串 | 点、线、面 | - |
电源 变量名称：powerSource 电源类别。 可能结果包括未知 (0)、交流 (1)、USB (2)、无线 (3) 和电池 (4)。 | 整型 | 点 | - |
电池状态 变量名称：batteryState 电池状态类别。 可能结果包括未知 (0)、未插入 (1)、正在充电 (2)、已插入并已充满电 (3)、已插入但未充电 (4)。 | 整型 | 点 | - |
电池电量 变量名称：batteryLevel 电池电量百分比 (0-100)。 | 整型 | 点 | - |
磁偏角 变量名称：magneticDeclination 以十进制度表示的磁北和正北之间的角度。 | 双精度 | 点 | - |
方位角 (°) 变量名称：azimuth 捕获记录时设备的罗盘方位，北为 0，东为 90，南为 180，西为 270。 | 双精度 | 点 | esrisnsr_azimuth |
仰俯角 (°) 变量名称：pitch 捕获记录时设备的俯仰角，其中 0 表示设备正面朝上，90 表示设备垂直于地面倾斜。 | 双精度 | 点 | - |
转动 (°) 变量名称：roll 捕获记录时设备的滚动角，其中 0 表示设备面向上，90 表示设备向右滚动，-90 表示设备向左滚动，而 180表示设备面向下。 | 双精度 | 点 | - |
注：
手动编辑点后，magneticDeclination、azimuth、pitch 和 roll 变量将被清除。
用户信息
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
用户名 变量名称：username 当前登录用户名。 | 文本 | 点、线、面 | - |
全名 变量名称：fullName 当前登录的用户全名。 | 文本 | 点、线、面 | - |
名字 变量名称：firstName 当前登录的用户名字。 | 文本 | 点、线、面 | - |
姓氏 变量名称：lastName 当前登录的用户姓氏。 | 文本 | 点、线、面 | - |
电子邮件 变量名称：email 当前登录的用户电子邮件。 | 文本 | 点、线、面 | - |
位置
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
捕获时间(UTC) 变量名称：captureTime 以 UTC 表示的捕获时间。 | 日期 | 点 | esrignss_fixdatetime |
纬度(DD) 变量名称：latitude 以十进制度表示的纬度。 | 双精度 | 点 | esrignss_latitude |
经度(DD) 变量名称：longitude 以十进制度表示的经度。 | 双精度 | 点 | esrignss_longitude |
高度(m) 变量名称：altitude 以米为单位的海拔高度或大地高度。 | 双精度 | 点 | esrignss_altitude |
水平精度(m) 变量名称：horizontalAccuracy 以米为单位的 x,y 坐标水平精度。 | 双精度 | 点 | esrignss_h_rms |
垂直精度(m) 变量名称：verticalAccuracy 以米为单位的 z 坐标垂直精度。 | 双精度 | 点 | esrignss_v_rms |
位置 DMS 变量名称：DMS 以空格分隔的字符串形式的位置，以度、分、秒为单位。 | 文本 | 点 | - |
位置 DDM 变量名称：DDM 以空格分隔的字符串形式的位置，以度和十进制分为单位。 | 文本 | 点 | - |
位置 USNG 变量名称：USNG 以美国国家格网表示的位置。 | 文本 | 点 | - |
位置 MGRS 变量名称：MGRS 军事格网参考系中的位置。 | 文本 | 点 | - |
注：
手动编辑点后，sensorName、altitude、horizontalAccuracy 和 verticalAccuracy 变量将被清除。
行驶
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
速度(m/s) 变量名称：speedMS 以米/秒为单位的地面速度。 | 双精度 | 点 | - |
速度(km/h) 变量名称：speedKPH 以千米/小时为单位的地面速度。 | 双精度 | 点 | esrignss_speed |
速度(mi/h) 变量名称：speedMPH 以英里/小时为单位的地面速度。 | 双精度 | 点 | - |
速度(节) 变量名称：speedKTS 以节为单位的地面速度。 | 双精度 | 点 | - |
verticalSpeedMS 以米/秒为单位的垂直速度。 | 双精度 | 点 | - |
变量名称：verticalSpeedKPH 以千米/小时为单位的垂直速度。 | 双精度 | 点 | - |
变量名称：verticalSpeedMPH 以英里/小时为单位的垂直速度。 | 双精度 | 点 | - |
变量名称：verticalSpeedKTS 以节为单位的垂直速度。 | 双精度 | 点 | - |
行驶方向(°) 变量名称：direction 以北为基准方向按顺时针进行测量的行驶方向（以十进制度表示）。 | 双精度 | 点 | - |
4 个主方向的行驶方向 变量名称：directionCardinal4 行驶方向概化为四个基本方向之一。 可能产生的结果为 N、E、S 和 W。 | 文本 | 点 | - |
8 个主方向的行驶方向 变量名称：directionCardinal8 行驶方向概化为八个基本方向之一。 可能产生的结果为 N、NE、E、SE、S、SW、W 和 NW。 | 文本 | 点 | - |
活动类型 变量名称：activityType 用户活动类型：Unknown (0)、Stationary (1)、Walking (2)、Running (3)、Cycling (4) 和 Automotive (5) | 文本 | 点 | - |
开始时间 变量名称：startTime 激活按钮的日期和时间。 | 日期 | 线、面 | - |
结束时间 变量名称：endTime 停用按钮的日期和时间。 | 日期 | 线、面 | - |
长度 (m) 变量名称：lengthM 以米为单位的大地测量长度。 | 双精度 | 线、面 | - |
长度 (km) 变量名称：lengthKM 以公里为单位的大地测量长度。 | 双精度 | 线、面 | - |
长度 (mi) 变量名称：lengthMI 以英里为单位的大地测量长度。 | 双精度 | 线、面 | - |
面积 (m2) 变量名称：areaM2 以平方米为单位的面积，仅适用于面图层。 | 双精度 | 面 | - |
面积 (km2) 变量名称：areaKM2 以平方千米为单位的面积，仅适用于面图层。 | 双精度 | 面 | - |
面积 (mi2) 变量名称：areaMI2 以平方英里为单位的面积，仅适用于面图层。 | 双精度 | 面 | - |
注：
垂直速度不能分配给 Web 设计器 GUI 中的按钮字段，但可以在编辑工程 JSON 时使用变量名称创建。
手动编辑点后，speedMS、speedKPH、speedMPH、speedKTS、verticalSpeedMS、verticalSpeedMPH、verticalSpeedKPH、verticalSpeedKTS、direction、directionCardinal4 和 directionCardinal8 变量将被清除。
照片
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
照相机朝向 (°) 变量名称：camHeading 拍摄照片时设备后置摄像头的罗盘方位，北为 0，东为 90，南为 180，西为 270。 其也将保存至 EXIF 标签 GPSImgDirection。 请注意如果拍摄照片时 camRoll 大于 ±10 度，则 camHeading 不可靠。 | 双精度 | 点 | - |
照相机仰俯角 (°) 变量名称：camPitch 拍摄照片时设备后置摄像头的俯仰角，其中 0 表示摄像头朝地面向下看，而 90 表示设备垂直于地面向前看。 | 双精度 | 点 | - |
照相机转动 (°) 变量名称：camRoll 拍摄照片时设备后置摄像头的滚动角，其中 0 表示不滚动，90 表示设备向右滚动，-90表示摄像头向左滚动。 滚动角超过 ±45 度将导致设备方向从纵向切换为横向，并且 camHeading、camPitch 和 camRoll 角度将相应调整。 | 双精度 | 点 | - |
水平视域 (°) 变量名称：hfov 照相机镜头的水平视域，以度为单位。 根据照片 EXIF 标签 FocalLength35mmFilm 计算此变量。 如果缺少 EXIF 标签，则返回的值为空。 | 双精度 | 点 | - |
垂直视域 (°) 变量名称：vfov 照相机镜头的垂直视域，以度为单位。 根据照片 EXIF 标签 FocalLength35mmFilm 计算此变量。 如果缺少 EXIF 标签，则返回的值为空。 | 双精度 | 点 | - |
照片纬度 (DD) 变量名称：photoLatitude 拍摄照片时的纬度（以十进制度为单位）。 其也将保存至 EXIF 标签 GPSLatitude。 | 双精度 | 点 | - |
照片经度 (DD) 变量名称：photoLongitude 拍摄照片时的经度（以十进制度为单位）。 其也将保存至 EXIF 标签 GPSLongitude。 | 双精度 | 点 | - |
注：
对于支持多张照片的按钮，不会计算照相机设备变量。
下表中的变量通常仅在直接连接到外部 GNSS 接收器时可用，但是，在通过模拟位置提供程序连接外部接收器时，Android 上标有 * 的变量也可以使用。
GNSS
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
位置源类型* 变量名称：positionSourceType 位置源的类别。 可能产生的结果分为以下几种：Unknown (0)、User (1)、System Location (2)、External Device (3) 和 Network Device (4)。 | 整型 | 点、线、面 | esrignss_positionsourcetype |
修复类型* 变量名称：fixType 坐标的定位类型。 可能产生的结果分为以下几种：NoFix (0)、GPS (1)、DifferentialGPS (2)、PrecisePositioningService (3)、RTKFixed (4)、RTKFloat (5)、Estimated (6)、Manual (7)、Simulator (8) 和 SBAS (9)。 | 整型 | 点 | esrignss_fixtype |
设备地址 变量名称：deviceAddress 通常，此地址为设备的蓝牙 MAC 地址，例如 0C:00:0A:BB:28:FC。 但是，在 iOS 上，蓝牙 MAC 不可用，因此会返回唯一设备标识符，例如 3f89ecd0-bbe5-11ea-8b6e-0800200c9a66。 | 文本 | 点 | - |
位置传感器名称* 变量名称：sensorName 使用集成位置提供程序时，名称为 AppStudio-CoreLocation。 使用外部接收器时，它将为外部硬件报告的接收器名称。 | 文本 | 点 | esrignss_receiver |
位置传感器连接类型 变量名称：deviceType 外部设备的类型。 可能产生的结果为：Unknown (-1)、Bluetooth (0)、Serial Port (1) 和 Bluetooth LE (2)。 | 整型 | 点 | - |
网络名称 变量名称：networkName 这仅适用于网络位置提供商。 | 文本 | 点 | - |
网络地址 变量名称：networkAddress 这仅适用于网络位置提供商。 | 文本 | 点 | - |
网络端口 变量名称：networkPort 这仅适用于网络位置提供商。 | 整型 | 点 | - |
正高* 变量名称：geoidSeparationCustom 用户在应用程序设置中定义的 WGS84 地球椭圆体与平均海平面之间的差异。 这适用于所有位置提供商类型。 | 双精度 | 点 | - |
天线高度 变量名称：antennaHeight 从高度值中减去天线到地表的距离（以米为单位）。 | 双精度 | 点 | - |
高度类型* 变量名称：altitudeType 可能的结果为平均海平面 (0) 上方的高度和椭圆体 (1) 上方的高度。 | 整型 | 点 | - |
大地水准面分离* 变量名称：geoidSeparation 通过 GNSS 接收器报告的 WGS84 地球椭圆体与平均海平面之间的差异（以米为单位）。 这有时也被称为正高。 | 双精度 | 点 | - |
精度类型 (RMS v DOP)* 变量名称：accuracyType 由 horizontalAccuracy 和 verticalAccuracy 属性报告的精度类型。 可能产生的结果为 RMS (0) 和 DOP (1)。 RMS 为均方根精度。 该结果根据接收器提供的 GST 语句中报告的纬度、经度和高度误差的 68％ 置信区间计算得出。 如果接收器不支持 GST，请使用 DOP。 DOP 为基于精度的精度衰减因子。 它使用恒定的用户估算范围误差 (UERE) 值来估算水平和垂直精度。 | 整型 | 点 | - |
精度置信度* 变量名称：confidenceLevelType 可能产生的结果为 68% (0) 和 95% (1)。 | 整型 | 点 | - |
平均径向球面误差 变量名称：positionAccuracy 平均径向球面误差(以米为单位)。 其中包括水平和垂直误差。 | 双精度 | 点 | - |
GST 纬度 1-sigma 误差 变量名称：latitudeError 纬度 1-sigma 错误的值（以米为单位）。 仅当您的定位设备支持 NMEA 流中的 GST 语句时，才会填充此属性。 | 双精度 | 点 | - |
GST 经度 1-sigma 误差 变量名称：longitudeError 经度 1-sigma 错误的值（以米为单位）。 仅当您的定位设备支持 NMEA 流中的 GST 语句时，才会填充此属性。 | 双精度 | 点 | - |
GST 高度 1-sigma 误差 变量名称：altitudeError 高度 1-sigma 错误的值（以米为单位）。 仅当您的定位设备支持 NMEA 流中的 GST 语句时，才会填充此属性。 | 双精度 | 点 | - |
HDOP* 变量名称：hdop 位置数据的水平精度衰减因子。 | 双精度 | 点 | esrignss_hdop |
VDOP* 变量名称：vdop 位置数据的垂直精度衰减因子。 | 双精度 | 点 | esrignss_vdop |
PDOP* 变量名称：pdop 位置数据的位置精度衰减因子。 用于确定 PDOP 的公式为 PDOP^2 = HDOP^2 + VDOP^2。 | 双精度 | 点 | esrignss_pdop |
差分龄期* 变量名称：differentialAge 差分信号的期限和 GPS 接收器用于差分校正位置的校正（以秒为单位）。 | 双精度 | 点 | esrignss_correctionage |
参考站 ID* 变量名称：referenceStationId GPS 接收器使用的站的差分参考站 ID (DSID)。 | 整型 | 点 | esrignss_stationid |
可见卫星 变量名称：satellitesVisible 位置捕获时可见的定位卫星数。 | 整型 | 点 | - |
使用中卫星 变量名称：satellitesInUse 用于返回位置数据的定位卫星数。 | 整型 | 点 | esrignss_numsats |
注：
手动编辑点时，将清除所有外部 GNSS 变量。
专属组
专属组用于确保该组中仅有一个按钮在任何时候都处于活动状态。 请考虑捕获用于表示人行道变化情况的一系列线。 当您沿路径行进时，该情况可能为极好、好或较差。 点击极好按钮开始捕获表示人行道极好部分的线。 当情况发生变化时，请立即点击较差按钮。 系统随即停止捕获极好的线，然后开始捕获较差的线。
尽管专属组通常应用于折线和面按钮，但是您也可以添加启用了流模式的点按钮。 可以将来自不同模板组的按钮包含在单个专属组中，并且可将多个专属组应用于工程。
工程用户输入变量
工程用户输入变量值将由应用程序用户填充，且可以应用于工程中的一个或多个按钮。 尽管将由应用程序用户输入该值；但是，工程作者必须对变量将应用到的按钮和字段进行定义。
以下内容适用于工程用户输入：
- 最多可以为每个工程定义三个工程用户输入变量。
- 其值将由用户在按下按钮之前完成输入。 如果根据需要设置了用户输入，则在启动工程时系统会提示用户输入该值，但用户可以随时编辑该值。
- 可将其值应用于任何按钮中的任何文本字段。
- 可以将其值应用于配置了编码值属性域的文本或整型字段。
- 不可以将其值应用于配置了范围属性域的文本字段。
工程用户输入变量的属性如下：
- 标注 - 将显示为应用程序中工程用户输入页面标题的文本。
- 输入类型 - 可以是单行文本、多行文本或选项列表。 可以添加、删除和重新排序选项。 或者，您也可以允许在选项列表中输入自由文本。
- 应用提示 - 在应用程序的工程用户输入页面上显示提示文本。
- 应用输入掩码 - 通过使用字符和符号定义输入掩码来定义数据输入的格式。
- 必需 - 指定移动应用程序用户在按下任何按钮之前，是否必须提供用户输入值。 如果不需要，则用户可根据需要通过选择编辑按钮（位于屏幕顶部显示的用户输入值旁边）并键入一个值来输入用户输入值。
注：
为了避免出现提交错误，在将用户输入值应用于具有必填字段的要素图层时，请确保将其必填属性设置为 true。
- 显示 QR 码扫描仪 - 使用输入对话框中的 QR 码扫描仪进行文本字段输入。
注：
支持以下格式：QR CODE、UPC A、UPC E、EAN 8、EAN 13、CODE 39 和 CODE 128。
工程用户输入由工程作者在每个字段的数据选项卡上或在工程用户输入菜单项中创建和配置。
要将工程用户输入变量分配给按钮的捕获字段，请从数据选项卡上捕获字段的下拉菜单中选择工程用户输入。
在移动应用程序中，将阻止用户输入超出数据字段长度的文本。
按钮用户输入变量
在工程中按下按钮后，应用程序用户会填充按钮用户输入变量值。 尽管将由应用程序用户输入该值；但是，工程作者必须对按钮变量将应用到的按钮和字段进行定义。
按钮用户输入变量与工程用户输入变量不同，因为值是用户在按下按钮后输入的。 每个工程按钮最多可以应用三个按钮用户输入，每个输入可以更新一个指定的字段。
按钮用户输入变量的属性如下：
- 标注 - 将显示为应用程序中工程用户输入页面标题的文本。
- 输入类型 - 可以是单行文本、多行文本、日期时间或选择列表。 可以添加、删除和重新排序选项。 或者，您也可以允许在选项列表中输入自由文本。 您可以使用数据时间输入类型指定默认值和日期范围。
- 应用提示 - 在应用程序的工程用户输入页面上显示提示文本。在配置范围或编码值属性域时不适用。
- 应用输入掩码 - 通过使用字符和符号定义输入掩码来定义数据输入的格式。
- 必需 - 指定移动应用程序用户在按下某个按钮之后，是否必须提供用户输入值。
注：
为了避免出现提交错误，在将用户输入应用于具有必填字段的要素图层时，请确保将其必填属性设置为 true。
- 显示 QR 码扫描仪 - 使用输入对话框中的 QR 码扫描仪进行文本字段输入。
注：
支持以下格式：QR CODE、UPC A、UPC E、EAN 8、EAN 13、CODE 39 和 CODE 128。
- 显示用户输入对话框 - 指定按钮用户输入是在数据捕获的开始还是结束时显示。 这适用于捕获线和面要素的按钮；但不适用于点按钮。
根据字段类型，可以使用不同的用户输入变量参数：
- 字符串 - 必填的用户输入标注，显示为多行、单行或选项列表、提示、输入掩码。
- 整型 - 必填的用户输入标注。
- 双精度 - 必填的用户输入标注。
- 日期 - 必填的用户输入标注。
按钮用户输入可以由工程作者在数据选项卡上为每个按钮进行配置。 要将按钮用户输入变量分配给按钮的捕获字段，请从数据选项卡上捕获字段的下拉菜单中选择按钮用户输入，然后选择新建。
如果为具有（编码值或范围）属性域的字段创建按钮用户输入，则这些选择将作为单选列表显示给用户。 当存在编码值属性域时，将无法输入自由文本。 当存在范围属性域时，数据输入将受到范围的限制。
输入掩膜
输入掩码通过将字符和符号用作工程或按钮的用户输入变量的一部分来定义数据输入的格式。 如果将输入掩膜应用到用户输入变量，则用户输入的值必须遵照由输入掩膜定义的特定模式。
要将输入掩膜应用到用户输入变量，需要在 userInputs.domain.inputMask 属性中定义掩膜。
下表列出了输入掩码中可使用的字符和符号：
| 字符 | 含义 |
|---|---|
A | 必须为 ASCII 字母字符。 字符可以为 A 到 Z 以及 a 到 z。 |
a | 允许为 ASCII 字母字符，但不是必需的。 |
N | 必须为 ASCII 字母数字字符。 字符可以为 A 到 Z、a 到 z 以及 0 到 9。 |
n | 允许为 ASCII 字母数字字符，但不是必需的。 |
X | 必须为任意字符。 |
x | 允许为任意字符，但不是必需的。 |
9 | 必须为 ASCII 数字。 数字可以为 0 到 9。 |
0 | 允许为 ASCII 数字，但不是必需的。 |
D | 必须为 ASCII 数字。 数字可以为 1 到 9。 |
d | 允许为 ASCII 数字，但不是必需的。 数字可以为 1 到 9。 |
# | 允许为 ASCII 数字或者加号/减号，但不是必需的。 |
H | 必须为十六进制字符。 字符可以为 A 到 F、a 到 f 以及 0 到 9。 |
h | 允许为十六进制字符，但不是必需的。 |
B | 必须为二进制字符。 字符可以为 0 到 1。 |
b | 允许为二进制字符，但不是必需的。 |
> | 以下所有字母字符均为大写。 |
< | 以下所有字母字符均为小写。 |
! | 关闭大小写转换。 |
\ | 避免以上列出的特殊字符以将其用作分隔符。 |
掩码由字符和分隔符字符串构成，也可以后跟分号和用于空格的字符。 编辑后，通常会从文本中移除空格字符。 下表列出了示例掩码：
| 示例掩码 | 描述 |
|---|---|
>A<xxxxxxxxxxxx | 以大写字母开头，后跟任意小写字符的文本。 |
AAA-AAA-AAA;_ | 此类唯一标识符使用短划线作为分隔符，并使用下划线来表示要完成的每个字符。 |
B9.99;- | 表示 pH 值。 限制数值只能以 0 或 1 开头，并且只能包含 2 个小数位。 短划线用于表示要完成的每个字符。 |
999-99-9999 | 美国社会安全号码。 |
(999) 999-9999 | 美国电话号码。 |
900 kg | 重量，以公斤为单位，范围为 0 到 999。 |
99999 | 美国 5 位邮政编码。 |
AAA | IATA 机场代码。 |
Webhook
Webhook 是一种受到广泛支持的方法，可允许多个应用程序彼此间进行交互，同时使用 HTTP POST 请求在这些应用程序之间传递回调。 有关详细信息，请参阅 webhook 上的 Wikipedia 页面。 webhook 的常见用途包括通过电子邮件或 SMS 发送通知、向社交媒体发布消息、自动将记录写入电子表格，以及更新企业级数据库。
在 QuickCapture 中，可以在提交记录时设置和激活 webhook。 例如，在向要素图层成功提交信息后，可以调用 webhook 并触发另一个操作，例如发送通知电子邮件、将记录追加到电子表格以及发送警告。
尽管您的工作场所可能有自己的 webhook 提供程序，但同时还有各种各样的第三方工作流服务可供使用，例如 Make、Microsoft Power Automate、Zapier 和 tray.io。 可以使用上述所有服务来整合 QuickCapture，以触发更大的自动化过程。 具体来说，Make 具有 QuickCapture 模块，使您可以轻松将 QuickCapture 集成到您的 webhook 工作流中，而无需在 QuickCapture 设计器中配置 webhook 或输入负载 URL。
您可通过多种方式将 QuickCapture 用作您工作流中的触发器。 首先，您可以使用 Make 模板在电子邮件通知中包含附件、向电子表格添加记录和创建日历项。 有关详细信息，请参阅使用 Integromat 自动化工作流。
注：
Make 中的默认 QuickCapture 模块是为托管在 ArcGIS Online 中的工程构建的。 要将 Make 与 ArcGIS Enterprise 中的托管工程配合使用，需要设置自定义连接。 有关详细信息，请参阅将 Integromat 连接到 ArcGIS Enterprise 实例。
在 QuickCapture 设计器中，可以通过选择 Webhook 菜单项 
来配置 webhook。 创建 webhook 时，请提供以下参数。
- 名称 - 设置 webhook 的名称（在工程中是唯一的）。
- 目标要素图层 - 选择单个要素图层。 每次将记录提交到此图层时，都会将负载发送至配置的 webhook URL。
- Webhook URL - 指定发送工程信息的位置。 内部 webhook 提供程序必须提供此参数。
- 事件数据 - 选择负载中将包括的信息，包含工程详细信息、用户信息、门户和已提交记录，以及服务器响应。
- 状态 - 确定在保存工程时是否将启用此 webhook。
工程验证
当打开、保存或共享工程时，将执行分析以帮助验证数据并诊断您的工程配置。 提供用于解决消息窗格中错误或警告的指导。 单击错误或警告消息以查找问题。
可以保存带有警告的工程。 但是，在所有错误得到纠正之前，将无法保存工程。 可能阻止保存的问题包括以下方面：
- 无效数据源 - 已删除或取消共享的要素图层和地图。
- 空必填字段 - 标记为必填的字段必须已定义设备变量、用户输入或固定值。 将用户输入分配至必填字段时，请确保用户输入变量也标记为必填。
- 无效工程设置 - 与建议和要求的水平精度不兼容的值，标记为必需的设置必须具有有效输入，无效 webhook 配置或未配置任何按钮的工程。
定向影像
在 ArcGIS 中，可以配置 QuickCapture 以自动捕获启用定向影像应用的照片元数据。 通过启用具有定向影像的 QuickCapture 工程，您可以更好地管理和可视化非倾斜影像。 在工程上启用定向影像不会导致移动用户体验发生改变，但是能够为 ArcGIS 用户提供以下功能。
- 选择一个位置或资产，然后查看覆盖其的照片。
- 选择一个照片并查看其覆盖区。
- 查看地面要素（地图上）与图像要素之间的相关性。
要在设计器中启用定向影像，您需要一个配置为拍摄照片的 QuickCapture 工程。 请按照以下步骤启用定向影像：
- 单击管理工程图层菜单项
。 - 选择将向其提交照片的点要素图层的菜单，然后单击启用定向影像。
QuickCapture 将保存您的工程并将字段添加到所选要素图层，然后自动将设备变量映射到工程中的这些字段。 这些字段用于存储元数据，例如水平和垂直视域、照相机朝向、俯仰和滚动。
启用定向影像将创建一个具有读访问权限的要素图层视图，供用户浏览定向影像。 还会创建定向影像目录 (OIC) 项目，其中包含的信息包括对要素图层视图的引用，以及设置和默认值的范围。 诸如 Experience Builder、ArcGIS Pro 等客户端和自定义 Web 应用程序将这些项目与定向影像配合使用。
- 配置每个将采集定向影像的按钮以最多捕获一张照片，并确保启用为捕获的记录使用照片位置。
捕获多张照片的按钮不完全支持定向影像功能。 QuickCapture 应用程序仅为第一张捕获的照片计算照相机朝向、仰俯角、滚动和照片经纬度等设备变量，并将其存储到字段中。
- 单击保存。
在启用定向影像后，该移动应用程序将在捕获每张照片时计算照相机朝向、滚动和俯仰。
要使用 Orientated Imagery 应用程序可视化和利用照片，单击管理工程图层菜单项 ，打开图层菜单，然后单击查看定向影像。
注：
要在 Experience Builder、ArcGIS Pro 或 Orientated Imagery 应用程序中与其他人共享捕获的照片，必须共享 OIC 项目和引用的要素图层视图。
在 ArcGIS Enterprise 中使用托管要素图层时，您必须从门户手动添加 OIC 才能可视化和使用照片。 在 Oriented Imagery 应用程序中，指定您的门户 URL 和详细登录信息。 登录后，选择目标 OIC 并将其添加到应用程序中。
ArcGIS Enterprise 中包含非托管要素图层的定向影像
在 ArcGIS Enterprise 中使用托管要素图层时，定向影像体验与在 ArcGIS Online 中相同（如上所述）。
在 ArcGIS Enterprise 中使用非托管要素图层时，将不会创建要素图层视图，且当您在 QuickCapture 工程中启用定向影像时，必填字段不会自动添加到要素图层。 以下字段必须手动添加到非托管要素图层。 如果这些字段名称已被使用，则在启用定向影像时，变量将自动映射到工程中。
| 字段名 | 显示名称 | 类型 |
|---|---|---|
camheading | 相机朝向（正北） | 双精度 |
campitch | 相机仰俯角 | 双精度 |
camroll | 相机转动 | 双精度 |
hfov | HFOV | 双精度 |
vfov | VFOV | 双精度 |
fardist | 远距离 | 双精度 |
neardist | 近距离 | 双精度 |
avghtag | 相机高于地面的高度 | 双精度 |
acquisitiondate | 采集日期 | 日期 |
位置共享
位置共享是一种组织范围内的功能，允许您记录移动工作人员当前和之前所在位置。 当您启用位置共享后，组织中的许可用户可以使用 QuickCapture 移动应用程序将其位置上传到位置共享图层。 轨迹在位置共享图层中是安全的：移动工作人员只能看到自己的轨迹，需要其他权限才能查看他人的轨迹。 启用位置共享后，管理员可以使用 Track Viewer web 应用程序通过创建轨迹视图将上次已知位置和轨迹数据共享给组织中的其他用户。
要了解有关在组织中启用位置共享的详细信息，请参阅在 ArcGIS Online 中启用位置共享和在 ArcGIS Enterprise 中启用位置共享，或参阅使用 QuickCapture 实施指南部署位置共享解决方案。
要在工程中启用位置共享，请选择位置共享菜单项 
。 启用位置共享时，可以选择以下内容：
- 必需项 - 当追踪为必需项时，移动工作人员无法禁用追踪。
- 最后已知位置更新间隔 - 在移动应用上报告代表最后已知位置的单个位置的间隔。可以选择 1 分钟、15 分钟或 1 小时。 默认值为 1 分钟。
- 最后已知位置类别 - 将写入最后已知位置图层的类别字段的值。 它可以是工程名称、固定值或工程用户输入。 默认设置为工程名称。
- 轨迹上传间隔 - 位置上传到轨迹图层的间隔。 默认设置为关闭（禁用）。 关闭后，仅会上传最后已知位置。 要启用轨迹上传，请将此间隔设置为 10 分钟。
- 轨迹类别 - 将写入轨迹图层的类别字段的值 它可以是工程名称、固定值或工程用户输入。 默认设置为工程名称。
有关详细信息，请参阅针对工程作者的常见问题解答和针对移动工作人员的常见问题解答。