注释

注释可在设计调查时提供进一步的信息和说明。 注释可以包含文本、图像、视频或音频。

HTML 样式

将样式应用于注释有助于突出显示重要信息。 您还可以使用超链接来提供电话号码和电子邮件的链接。 以下示例将在您的调查中显示为链接;选择该链接时,将获得用户电话号码。

<a href="tel:555-555-5555">555-555-5555</a>

如果设备不是电话,则系统将转而提示用户选择其已安装的电话应用程序。 这是显示紧急号码等情况的理想之选。

同样,您也可以链接到电子邮件地址。 例如,选择此链接将打开设备选择的电子邮件客户端,并发送电子邮件到引用的地址。

<a href="mailto:example@example.com">Email</a>

有关支持的标签的详细信息,请参阅设置调查样式

动态标注

通过使用格式 ${field_name} 在文本中引用问题名称,调查中的注释、标注和提示可以显示另一个问题的内容。 这对于显示不需要以其他方式公开的字段内容非常有用,例如基于先前答案的计算,或者在下一个问题的标注中,根据先前问题调查的人员姓名。

无法在标注或提示中执行计算。 要显示计算结果,确保计算位于问题中。

警告:

选择列表不支持动态标注。

视觉合并注释

XLSForm 格式仅允许从各类媒体(图像、视频或音频)中择一添加到注释问题。 要解决此限制,后续注释将在视觉上合并在一起,以便在您的表单中将其显示为一个注释。 这意味着您可以在调查中逐一包括多个注释字段。 查看表单时,注释将显示为单个注释。

要素图层中的注释

根据在 XLSForm 中配置注释的方式,问题在调查发布时会有不同的表现。

如果为注释提供了名称,则将为注释创建字符串字段。 在 Survey123 外业应用程序中填写您的调查的用户不能向此字段输入任何内容,但其中保存的任何默认值或计算值都将被提交给要素图层。 通过将 bind::esri:fieldType 设置为 null,也可以从要素图层中忽略具有名称的注释问题。

如果注释没有名称,则不会在要素图层中为该注释生成任何字段。 仅用于显示表单中的只读文本。 将使用 generated_note_ 前缀和字段类型将注释问题显示在方案选项卡中。

如果重新发布的调查将向要素图层中添加字段,则系统会警告您此更改将会添加一个字段。

您可以添加特殊的注释问题来自定义表单 UI 的元素。 这些注释使用 generated_note_ 前缀命名,在发布调查时,不会在要素图层中为这些注释创建字段。 有关详细信息,请参阅自定义表单元素

注:

Survey123 网站中创建的调查中,注释问题名称前会附上 generated_note_ 前缀,以确保注释在要素图层中不会获得任何字段。 这些前缀字段名称不得移除或重命名,并且问题不应将 bind::esri:fieldType 设置为 null,因为这样会导致网站冲突。

自定义表单元素

您可以使用具有特定名称的注释问题自定义表单 UI 的元素。 可以自定义的元素包括感谢画面、表单标题和页脚。 问题名称如下:

问题名称表单元素
generated_note_form_title

表单标题和调查描述

generated_note_form_submit_text

提交按钮文本

generated_note_form_footer

调查页脚

generated_note_prompt_submitted

致谢屏幕内容

generated_note_prompt_captcha

CAPTCHA 验证文本

以下示例演示了如何在调查中自定义表单元素。 表单标题和致谢屏幕使用 visitor_name 问题进行个性化。

自定义表单元素示例

自定义表单元素时,请考虑以下内容:

  • 所有这些元素在 Survey123 Web 应用程序中均可见,而在 Survey123 外业应用程序中仅表单标题可见。
  • 您可以提供 generated_note_ 问题的译文。 有关详细信息,请参阅翻译表单元素
  • 除了 generated_note_form_submit_text,所有这些注释都支持 HTML 内容。
  • 您可以使用 ${question_name} 语法将调查响应中的值包含在这些注释中。
  • generated_note_form_title 注释问题的标注中指定表单标题。
  • generated_note_form_title 注释问题的提示中指定调查描述。
  • 如果调查具有 generated_note_form_title 注释问题,则 settings 工作表上的 form_title 将被忽略。
  • 如果调查包含 generated_note_prompt_submitted 注释问题,则在 Survey123 Web 设计器中设置的感谢画面内容将被忽略。
  • 包含 generated_note_ 前缀的注释问题不会在表单中显示为注释,在发布调查时,也不会在要素图层中为这些问题创建字段。

注:

先前可以在名为 generated_note_form_descriptiongenerated_note_surveyHeadergenerated_note_surveyDescription 的注释问题中自定义调查标题和描述。 具有这些名称的任何问题将不再自定义调查标题和描述,并将显示为标准注释问题。 可以在 generated_note_form_title 问题的标注和提示中自定义调查标题和描述。

名为 generated_group_coverPage 组时由 Web 设计者为包含页面的调查创建的,以用于 Web 应用程序。将在外业应用程序和 Survey123 Connect 中忽略这些组。