[AEM Forms]{class="badge positive" title="适用于AEM Forms。"}

为关联UI配置绑定变量和未绑定变量

Text​组件中的绑定变量和未绑定变量允许关联者在关联UI中输入或确认值。 绑定的变量​链接到表单数据模型中的字段。 在文档中定义了​未绑定的变量,该变量未绑定到数据模型。

作者在​ Text ​组件或单个变量上启用了与​ 允许通过关联 ​进行编辑的关联编辑 — 并非两者都在同一​ Text ​组件中。

优势
作者(交互式通信设计器)
选择是在预览中关联内联编辑,还是在数据输入面板中关联逐字段编辑。
关联(服务代表)
在工作流中输入最适合通信的数据 — 内联编辑或结构化面板输入。

开始之前

在为关联UI配置变量之前,在交互式通信上启用​关联视图。 请参阅交互式通信编辑器中的关联UI

关联必须是​ forms-associates ​组的成员。

绑定变量

绑定变量映射到表单数据模型中的字段(例如,GMFletter下的deptName)。

  • 通过将字段从​ 数据模型 ​面板拖到​ 文本 ​组件中插入。
  • 字段​属性面板显示​名称显示类型​和​绑定

未绑定的变量

未绑定的变量直接在​ Text ​组件中创建,未链接到表单数据模型(例如,unboundvar)。

  • 字段​属性面板显示​名称显示类型​和​绑定
  • 在​ 关联属性 ​下,您可以配置​ 工具提示 ​和​验证

在文档预览中编辑整个文本组件

在​ 文本 ​组件上打开​允许由关联编辑,并为文本内的每个绑定和未绑定变量保留该设置。 在“关联视图”中,关联将在文档预览中选择文本块。 整个​ 文本 ​组件以紫色边界和格式工具栏显示。

配置

  1. 在​ 设计 ​选项卡上的交互式通信编辑器中打开交互式通信。

  2. 在​ 组件层次结构 ​面板中,选择包含绑定和未绑定变量的​ Text ​组件 — 例如​Text7

  3. 确认文本包含绑定变量和未绑定变量。 例如:

    • 数据绑定: deptName
    • 未绑定: unboundvar

    选择具有绑定和未绑定变量的文本组件

  4. 在​ 文本 ​属性面板中,确认​ 允许由关联编辑 ​对于文本内的每个绑定和未绑定变量为​

  5. 在仍然选择​ 文本 ​组件时,在​ 文本 ​属性面板中打开​ 允许通过关联 ​进行编辑。

  6. 单击​ 保存 ​并发布交互式通信。

在关联UI中验证

  1. 在​ 关联视图 ​中打开交互式通信。

  2. 在文档预览中选择文本块。 确认显示的​ 文本 ​组件具有紫色边界和格式工具栏。

  3. 直接在预览中编辑内容 — 例如,更新​数据绑定: APP Department,并在​ 取消绑定: ​后输入一个值。 确认绑定变量和未绑定变量已就地更新。

    在关联UI中编辑内嵌全文本组件

  4. (可选)选择​ 打印预览 ​以确认生成的输出与预览匹配。

在数据输入面板中编辑单个变量

关闭​ 文本 ​组件上的​ 允许关联 ​编辑。 为要关联编辑的每个绑定或未绑定变量启用此功能。 在关联视图中,每个启用的变量在左侧数据输入面板中都显示为单独的字段。

配置

  1. 在​ 设计 ​选项卡上的交互式通信编辑器中打开交互式通信。

  2. 在​ 组件层次结构 ​面板中,选择绑定的变量 — 例如,deptName[1]

  3. 在​ 字段 ​属性面板中:

    • 确认​ Name ​设置为deptName
    • 根据需要设置​显示类型(例如,无模式)。
    • 打开​ 允许由关联 ​编辑。

    为关联UI配置绑定变量deptName

  4. 在​ 组件层次结构 ​面板中,选择未绑定的变量,例如​unboundvar

  5. 在​ 字段 ​属性面板中:

    • 确认​ Name ​设置为unboundvar
    • 打开​ 允许由关联 ​编辑。
    • 可以选择在​ 关联属性 ​下配置​ 工具提示 ​和​验证

    为关联UI配置未绑定的变量unboundvar

  6. 确认父​ 文本 ​组件上的​ 允许关联编辑 ​为​

  7. 单击​ 保存 ​并发布交互式通信。

在关联UI中验证

  1. 在​ 关联视图 ​中打开交互式通信。

  2. 确认启用了​ 允许通过关联进行编辑 ​的每个变量会显示在左侧数据输入面板中 — 例如,deptName​和​unboundvar

  3. 为​ deptName ​输入​应用部门。 将​ unboundvar ​保留为空,并确认文档预览将变量名称显示为占位符 — 例如,未绑定: unboundvar

    在“关联UI数据条目”面板中验证绑定和未绑定的变量

  4. 输入​ unboundvar ​的​未绑定变量,并实时确认文档预览更新:

    • 数据绑定: APP Department​反映为绑定变量输入的值。
    • 未绑定:未绑定变量​反映为未绑定变量输入的值。

    验证关联UI中未绑定的变量值

  5. (可选)选择​ 打印预览 ​以确认生成的输出与预览匹配。

变量名称重复(已绑定和未绑定)

当具有相同名称的绑定变量和未绑定变量出现在设计画布上的多个位置时,左侧数据输入面板中仅显示每个变量名称的一个实例。 该关联会输入每个值一次;它会自动传播到文档预览中的所有相应匹配项。

配置

  1. 在​ 设计 ​选项卡上的交互式通信编辑器中打开交互式通信。

  2. 在设计画布上添加​ 子表单 ​或其他​ 文本 ​组件,并在每个位置插入重复的绑定和未绑定的变量。 例如,添加两个分别包含的块:

    • 数据绑定: deptName
    • 未绑定: unboundvar

    在子表单中配置重复的绑定和未绑定的变量

  3. 在​ 组件层次结构 ​面板中,选择每个绑定和未绑定的变量,并在​ 字段 ​属性面板中打开​允许关联编辑

  4. 确认父​ 文本 ​组件上的​ 允许关联编辑 ​为​

  5. 单击​ 保存 ​并发布交互式通信。

在关联UI中验证

  1. 在​ 关联视图 ​中打开交互式通信。

  2. 确认左侧数据输入面板中只显示一个​ deptName ​字段和一个​ unboundvar ​字段,即使每个变量出现在设计画布上的多个位置也是如此。

  3. 为​ deptName ​输入​应用部门。 将​ unboundvar ​保留为空,并确认在文档预览更新中同时出现 — 例如,每个块显示​ 数据绑定:应用程序部门 ​和​未绑定:unboundvar

    验证关联UI中的重复变量传播

  4. (可选)选择​ 打印预览 ​以确认生成的输出与预览匹配。

注意事项

重复的变量名称(已绑定和未绑定)

当绑定变量和未绑定的变量共享相同的变量名称时:

  • 左侧数据输入面板中只显示一个实例。
  • 在文档预览中,只会更新启用了关联编辑的变量。
  • 该关联在数据输入面板中输入一次值;它会自动传播到文档预览中的所有相应匹配项。

具有相同名称但默认值不同的未绑定变量

当多个未绑定的变量共享一个变量名称但使用不同的默认值时,关联UI显示第一个变量的默认值,左侧数据输入面板中已为其启用关联编辑。

绑定具有相同名称但数据引用路径不同的变量

当多个绑定变量共享一个变量名称但使用不同的数据引用路径时,左侧数据输入面板显示第一个变量的值,其中启用了关联编辑。 关联在数据输入面板中输入或更新的任何值都会传播到具有该名称的所有变量,而不管它们的数据引用路径如何。

相互排他性

允许由Associate编辑​对​ Text ​组件及其中的单个绑定或未绑定变量进行编辑是互斥的。 为每个​ Text ​组件启用一个方法。

没有值的未绑定变量

当未绑定变量启用了关联编辑但未输入值时,文档预览可能会显示变量名称(例如,unboundvar),直到关联在数据输入面板中提供值。

常见问题解答

编辑整个文本组件与编辑单个变量之间有何区别?
在​ 文本 ​组件上启用关联编辑时,关联将在文档预览中内联编辑整个文本块(紫色边界)。在单个变量上启用关联编辑时,每个启用的变量在左侧数据输入面板中都显示为单独的字段。

为什么我无法对文本组件和单个变量启用关联编辑?
对​ Text ​组件及其内部已绑定或未绑定变量的关联编辑是互斥的。在整个文本块或单个变量上启用编辑 — 不能同时启用这两个功能。

为什么我的未绑定变量在预览中显示的是变量名称而不是值?
该关联可能尚未输入值。在单个变量上启用关联编辑并且未配置默认​ ​的情况下,预览可能会显示变量名称,直到数据输入面板中输入数据为止。

绑定变量和未绑定的变量之间有何区别?
绑定变量通过​ 绑定 ​配置链接到表单数据模型字段。未绑定的变量在文档中定义,且未绑定到数据模型。

当两个变量共享相同名称时会发生什么情况?
左侧数据输入面板中只显示一个实例。该关联在数据输入面板中一次输入值,并自动传播到文档预览中的所有相应匹配项。

另请参阅

recommendation-more-help
experience-manager-cloud-service-help-main-toc