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

交互式通信编辑器中的未绑定变量组件

​1. 简介

交互式通信(IC)编辑器中的​ 未绑定变量 ​组件允许您放置其值未绑定到任何外部数据模型或架构节点的字段。 而是通过脚本、基于规则的计算或静态默认值提供该值,这样,当您需要并非直接来自绑定数据源的计算或中间显示值时,便可正确选择此组件。

由于未绑定变量未连接到表单数据模型,因此它可以在设计时和运行时完全控制该值。 您可以使用它来显示计算总数、动态生成的参考编号、中间公式结果或规则引擎生成的任何其他值。

该组件支持所有四种数据类型​TextNumericDate​和​Date/Time,并且活动数据类型确定应用哪些显示模式语法和图片子句符号。

​2. 显示模式

您可以使用与文本框、数值字段、日期字段和日期/时间字段组件相同的显示模式控件,将​ 显示模式 ​分配给​ 属性 ​面板中的未绑定变量字段。 这允许在画布预览和生成的输出中以格式表示计算值或引用值。

配置的模式将立即反映在画布预览中,并在保存和重新加载周期内保留。

配置显示模式

  1. 在设计画布上选择未绑定变量组件。
  2. 打开​ 属性 ​面板。
  3. 在​ 显示模式 ​部分中,选择预定义的模式或输入自定义图片子句。
  4. 在画布上预览格式化值。

选择正确的模式

由于未绑定变量可以保存任何数据类型,因此使用的picture子句语法必须与字段配置的数据类型匹配:

字段数据类型
模式语法
示例输出
引用
文本
text{…}
(555) 123-4567
文本框 — 显示模式
数字
num{…}
$1,234.21
数值字段 — 显示模式
日期
date{…}
01/04/2007
日期字段 — 显示模式
日期/时间
date{…} time{…}
04/01/2007 14:30
日期/时间字段 — 显示模式
NOTE
如果字段的数据类型为“日期”或“日期/时间”,则基础值必须符合​ ISO 8601 ​格式(YYYY-MM-DDYYYY-MM-DDTHH:MM)。 不遵循此格式的值按原样显示,而不应用显示模式。

​3. 属性

未绑定的变量组件与其他字段组件共享一个公共属性集,有一个关键区别:它没有外部数据绑定选项,因为按照定义,其值未与任何数据源绑定。

3.1基本字段

  • 名称:​变量的唯一标识符。 用于在IC内的规则、脚本和表达式中引用它。

  • 数据类型:​指定此变量包含​文本数值日期​或​ 日期/时间 ​的值的类型。 所选的数据类型确定应用哪些显示模式语法以及如何验证值。

  • 题注:​与画布上的字段一起显示的标签(例如,“计算总数”或“参考编号”)。

  • 值:​字段中显示的默认值或计算值。 在大多数情况下,这是使用规则编辑器或脚本以编程方式设置的,而不是手动键入。

  • 保留:​当没有计算值可用时显示的回退值,对于不能接受空白字段的纯打印或只读输出很有用。

  • 外观:​字段容器的视觉样式预设(无、实心框或下划线)。

3.2排版规则

控制显示值的样式设置:

  • 字体变量:​选择与周围内容匹配的字体系列、粗细(常规、粗体)和样式(斜体)。

  • 字体大小:​默认情况下通常设置为10 pt;调整以保持与通信的其余部分在视觉上的一致性。

3.3位置

定义元件在画布上的位置:

  • X和Y坐标:​设置精确的水平和垂直位置。

  • 宽度和高度:​指定以毫米为单位的尺寸以与相邻元素对齐。

3.4利润

定义元件边界周围的间距:

  • 上(上)

  • 下(下)

3.5外观

设置字段容器的样式:

  • 填充:​字段的背景颜色。

  • 笔触:​字段周围的边框,具有以下选项:

    • 宽度:​边框粗细。

    • 样式:​实线、虚线或点线。

    • Edge:​圆角或尖角。

3.6存在

控制运行时的可见性:

  • 可见:​字段已显示并占用布局空间。

  • 隐藏(保留空间):​字段不可见,但保留其布局空间,在使用规则编辑器动态切换可见性时非常有用。

​4. 用途

当要显示的值为:

  • 由规则或脚本计算 — 例如,运行总计、计税或从其他字段值派生的折扣金额。

  • 以编程方式生成 — 例如,在运行时由后端逻辑分配的参考号或跟踪代码。

  • 在数据模型​中不可用 — 例如,在屏幕上有意义但不作为架构字段存在的中间结果。

  • 有条件地可见 — 仅在满足特定条件时才显示计算消息或值,并使用规则编辑器一起设置可见性和值。

您可以将“未绑定变量”放置在子表单、布局容器中,或直接放置在设计画布上。 将其与规则编辑器相结合,以编写基于IC中其他绑定字段计算其值的表达式。

​5. 最佳做法

  • 设置有意义的保留值,以便在计算值不可用时,打印输出和只读预览绝不显示空白字段。

  • 将数据类型与输出匹配 — 如果您要计算货币金额,请将数据类型设置为“数值”并应用数字显示模式;如果计算日期,请将其设置为“日期”并确保输入ISO 8601。

  • 使用清晰标题 — 由于该值已计算并且无法从标签中直接识别,因此使用描述性标题(例如“小计(已计算)”)可以防止审阅者和最终用户混淆。

  • 避免对属于模型​的数据过度使用未绑定变量 — 如果可以合理地向表单数据模型添加值,则最好绑定一个标准字段。 为真正的瞬态或派生值保留未绑定变量。

  • 记录您的表达式 — 在规则编辑器中添加一条注释,说明每个未绑定变量的计算内容,以便以后编辑IC时逻辑保持可维护状态。

另请参阅

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