工程用户输入变量

工程用户输入变量值将由应用程序用户填充,且可以应用于工程中的一个或多个按钮。 尽管将由应用程序用户输入该值;但是,工程作者必须对变量将应用到的按钮和字段进行定义。

以下信息适用于工程用户输入变量:

  • 最多可以为每个工程定义三个工程用户输入变量。
  • 其值将由用户在按下按钮之前完成输入。 如果根据需要设置了用户输入,则在启动工程时系统会提示用户输入该值,但用户可以随时编辑该值。
  • 可将其值应用于任何按钮中的任何文本字段。
  • 可以将其值应用于配置了编码值属性域的文本或整型字段。
  • 不可以将其值应用于配置了范围属性域的文本字段。

工程用户输入变量的属性如下:

  • 标注 - 将显示为应用程序中工程用户输入页面标题的文本。
  • 输入类型 - 可以是单行文本、多行文本或选项列表。 对于选择列表,可定义多个值并允许输入自由文本。 使用动态选择列表可填充添加至工程的查询图层或表中的字段值。
  • 应用提示 - 在应用程序的工程用户输入页面上显示提示文本。
  • 应用输入掩码 - 通过使用字符和符号定义输入掩码来定义数据输入的格式。
  • 显示条形码扫描仪 - 在输入对话框上使用条形码扫描仪进行文本字段输入。
    注:

    支持以下格式:QR CODE、UPC A、UPC E、EAN 8、EAN 13、CODE 39 和 CODE 128。

  • 必需 - 指定移动应用程序用户在按下任何按钮之前,是否必须提供用户输入值。 如果不需要,则用户可根据需要通过选择编辑按钮(位于屏幕顶部显示的用户输入值旁边)并键入一个值来输入用户输入值。
    注:

    为了避免出现提交错误,在将用户输入值应用于具有必填字段的要素图层时,请确保将其必填属性设置为 true。

工程用户输入变量由工程作者在每个字段的数据选项卡上或在工程用户输入菜单项中创建和配置。

要将工程用户输入变量分配给按钮的捕获字段,请从数据选项卡上捕获字段的下拉菜单中选择工程用户输入

为文本字段选择工程用户输入。

在移动应用程序中,将阻止用户输入超出数据字段长度的文本。

动态选项列表

工程用户输入可以使用动态选项列表填充,方法是将其与现有的要素图层或表关联。 可将要素图层或表格设置为可编辑或只读。 作者通过配置列表的属性,可以控制列表的内容。

要在工程用户输入中使用动态选择列表,必须先将其作为查询图层或表格添加至工程:

  1. 在主菜单上,单击管理工程图层 Manage project layers
  2. 图层面板上选择查询选项卡。
  3. 单击添加
  4. 选择将填充动态选择列表的图层,然后单击添加

如果查询图层存在,则可以将其添加至按钮:

  1. 单击工程按钮以显示按钮面板,然后选择数据选项卡。
  2. 针对 Capture 字段选择工程用户输入,该字段将存储从动态选择列表中选择的值。
  3. Capture 字段下拉菜单中,选择新建
  4. 输入工程用户输入的标注。 此标注将显示在动态选择列表上方。
  5. 对于输入类型,选择动态选择列表
  6. 选择您在上述步骤中创建的要素图层或表格。

    最后创建的查询图层默认处于选中状态。

  7. 完成剩余属性,然后单击创建

    将自动为 Capture 字段设置此新创建的工程用户输入。

注:

当进行保存时,将从工程中移除未使用的查询图层。 在保存该工程之前,请确保至少向一个按钮添加查询图层。

动态选项列表的属性如下所示:

  • 显示字段 - 移动应用程序中显示的值。
  • 值字段 - 图层中存储的值。
  • 排序字段 - 用于对动态选项列表进行排序的字段。
  • 排序顺序 - 升序或降序。
  • 更新模式 - 手动或自动。 设置为手动时,如果用户输入设置为必填,则仅在第一次打开工程时更新列表。 仅当用户向下拖动列表时,才会执行后续更新。 设置为自动时,如果用户输入设置为必填,则在打开工程或编辑用户输入时,列表会更新。
  • 过滤器 - 用于限制动态选项列表中显示的值的查询。 在为 WHERE 子句构建条件时,可使用这些选项选择设备变量(usernamefullNamefirstNamelastNameemail)或选定图层中的字段。 例如,假定所选图层中的 canvasser 字段包含用户名,要将列表过滤为仅包含与当前登录到应用程序的调查员的用户名匹配的值,请输入表达式 Canvasser='${username}'

    WHERE 子句的条件表达式,用于过滤动态选择列表

移动应用程序仅会返回列表第一页的结果,对于 ArcGIS Online 要素服务而言,默认为 2000 条记录。

在移动应用程序中查看动态选择列表后,该列表即可离线使用。要获取列表更新,在重新加载列表时设备必须为在线状态。


在本主题中
  1. 动态选项列表