[AEM Forms]{class="badge positive" title="适用于AEM Forms)。"}
交互式通信编辑器中的未绑定变量组件
1. 简介
交互式通信(IC)编辑器中的 未绑定变量 组件允许您放置其值未绑定到任何外部数据模型或架构节点的字段。 而是通过脚本、基于规则的计算或静态默认值提供该值,这样,当您需要并非直接来自绑定数据源的计算或中间显示值时,便可正确选择此组件。
由于未绑定变量未连接到表单数据模型,因此它可以在设计时和运行时完全控制该值。 您可以使用它来显示计算总数、动态生成的参考编号、中间公式结果或规则引擎生成的任何其他值。
该组件支持所有四种数据类型Text、Numeric、Date和Date/Time,并且活动数据类型确定应用哪些显示模式语法和图片子句符号。
2. 显示模式
您可以使用与文本框、数值字段、日期字段和日期/时间字段组件相同的显示模式控件,将 显示模式 分配给 属性 面板中的未绑定变量字段。 这允许在画布预览和生成的输出中以格式表示计算值或引用值。
配置的模式将立即反映在画布预览中,并在保存和重新加载周期内保留。
配置显示模式
- 在设计画布上选择未绑定变量组件。
- 打开 属性 面板。
- 在 显示模式 部分中,选择预定义的模式或输入自定义图片子句。
- 在画布上预览格式化值。
选择正确的模式
由于未绑定变量可以保存任何数据类型,因此使用的picture子句语法必须与字段配置的数据类型匹配:
YYYY-MM-DD或YYYY-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时逻辑保持可维护状态。
另请参阅
- 文本框组件 — 显示文本值的模式语法
- 数值字段组件 — 显示数值和货币值的模式语法
- 日期字段组件 — 显示日期的模式语法
- 日期/时间字段组件 — 显示合并日期和时间值的模式语法
- 在交互式通信编辑器中使用规则编辑器 — 编写表达式以计算未绑定变量并将值分配给未绑定变量
- 在交互式通信编辑器中配置数据绑定