Show Menu
主题×

内联条件,并在交互通信和字母中重复

内联条件

AEM Forms允许您在文本模块中使用内联条件,自动呈现取决于与表单数据模型(在交互通信中)或数据字典(在字母中)关联的上下文或数据的文本。 内联条件根据条件评估为true或false显示特定内容。
条件对表单数据模型/数据字典或最终用户提供的数据值执行计算。 使用内联条件,您可以节省时间并减少人为错误,同时创建高度情境化和个性化的交互式通信/字母。
有关详细信息,请参阅:

示例:使用规则在交互式通信中条件化内联文本

要在交互通信中对句子、段落或文本字符串进行条件化,可以在相应的文本文档片段中创建规则。 以下示例使用规则仅向交互通信的美国收件人显示免费电话号码。
有关详细信息,请参阅在交互通信中以文本 形式创建规则
在交互通信中包含文本片段后,代理使用代理UI准备交互通信后,将评估收件人的(表单数据模型)数据,并且该文本仅显示给美国的收件人。

示例:在字母中使用内联条件来呈现相应的地址

通过在相应的文本模块中插入内联条件,可以在字母中插入内联条件。 以下示例使用两个条件在基于DD元素“性别”的信件中评估和显示相应的地址,即Sir或Ma'am。 使用类似的步骤,您可以创建其他条件。
如果您的现有资产包含旧条件/重复表达式(6.2 SP1 CFP 4之前),则资产将显示旧的条件语法并重复。 但是,旧条件/重复可以正常工作。 新条件/重复表达式和旧条件/重复表达式相互兼容,以创建新旧条件/重复的嵌套混合。
  1. 在相关文本模块中,选择要条件化的文本部分并点按 条件
    出现“Condition(条件)”对话框,其中显示一个空条件。
    无法保存空或无效的条件表达式。 必须有有效的条件表达式才能 ${} 保存表达式。
  2. 执行以下操作以构建一个条件,用于评估所选/条件化文本是否显示在字母中,然后点按复选标记以保存表达式:
    多次点按某个DD元素以在条件中插入它。 插入相应的运算符,并在对话框中构建以下条件。
    ${DD_creditcard_Gender=="Male"}
    
    
    有关创建表达式的详细信息,请参 阅使用表达式生成器创建表达式和远 程功能 ,在 表达式生成器中。 表达式中指定的值必须支持数据字典中的元素。 有关详细信息,请参 阅数据字典
    插入条件后,您可以将鼠标悬停在条件左侧的手柄上以视图该条件。 您可以点击手柄以视图条件的弹出菜单,该菜单允许您编辑或删除条件。
  3. 通过选择文本插入类似条 Ma'am 件。
    ${DD_creditcard_Gender == "Female"}
    
    
  4. 预览相关字母,并注意文本会根据内联条件呈现。 您可以使用以下方式输入DD元素“性别”的值:
    • 在预览带有样本数据的字母时,根据相关数据字典创建的样本XML数据文件。
    • 附加到相关数据字典的XML数据文件。
    有关详细信息,请参 阅数据字典

重复

您的交互通信/信函中可能包含动态信息,如信用卡对帐单中的事务处理,其实例或发生情况可能会随每个生成的信函而不断变化。 使用重复,您可以在文本文档片段中格式化和构造此类动态信息。
此外,您可以在重复构造中指定规则/条件,以条件化在交互通信/字母中呈现的信息/条目。

示例:在交互通信中使用重复设置信用卡交易列表的格式、结构和显示

以下示例介绍了在交互通信中使用重复来构造和呈现信用卡交易记录的步骤。
  1. 在基于表单文档模型的文本片段中,插入相关表单数据模型对象(和标签所需的嵌入文本,如本例所示):
    可重复内容必须至少包含一个“集合”类型的属性。
  2. 选择要应用重复的内容。
  3. 点按重复。
    出现“Repeat(重复)”对话框。
  4. 选择分隔线作为分隔符,然后根据需要点按添加条件以创建规则。 还可以使用文本作为分隔符,并指定要用作分隔符的文本字符。
    此时将显示创建规则对话框。
  5. 创建一个规则以显示日期为2018年2月28日之后的事务处理,以便在交互通信中仅包含3月的事务处理。
    此示例假定代理将在2018年3月底创建该语句。 否则,您可以创建另一个规则,在2018年3月之前包含事务,以排除2018年3月之后的事务。
  6. 保存条件/规则,然后保存重复。 条件重复将应用于所选内容。
    在鼠标悬停时,文本文档片段将显示条件以及应用于内容的重复中使用的分隔符。
  7. 保存文本文档片段并预览相关的交互通信。 根据表单数据模型中的数据,对元素应用的重复操作将呈现与预览中以下内容类似的事务详细信息:

示例:在信函中重复使用格式、结构和显示信用卡交易列表

以下示例提供了使用重复来在信函中构造和呈现信用卡交易记录的步骤。 使用类似步骤,您可以在其他场景中使用重复。
  1. 打开(在编辑或创建时)包含DD元素的文本模块,这些元素可呈现重复/动态数据并在DD元素周围嵌入所需文本。 例如,文本模块具有以下DD元素,用于在信用卡上创建交易记录:
    {^DD_creditcard_TransactionDate^} {^DD_creditcard_TransactionAmount^}
    {^DD_creditcard_TransactionType^}
    
    
    这些DD元素将呈现信用卡上进行的事务处理的列表,其中包含以下信息:
    事务处理日期、事务处理金额和事务处理类型(借项或贷项)
  2. 将文本嵌入DD元素,使语句更易读,如:
    Date: {^DD_creditcard_TransactionDate^} Amount (USD): {^DD_creditcard_TransactionAmount^} Transaction Type: {^DD_creditcard_TransactionType^}
    
    
    然而,尚未完成格式良好的语句的呈现工作。 如果根据目前所做的工作渲染字母,则显示如下:
    要重复静态文本和DD元素,您需要应用重复,如后续步骤中所述。
  3. 选择要重复的静态文本和DD元素,如下所示:
  4. 点按 重复 。 出现“重复”对话框,其内嵌条件为空。
  5. 如果需要,插入一个条件以有选择地呈现事务,例如呈现大于50美分的事务金额:
    ${DD_creditcard_TransactionAmount > 0.5}
    
    
    否则,如果您不需要选择性地呈现信息(此处的事务),请在对话框中删除以下内容,将条件保留为空: ${} . 当重复表达式窗口为空(不需要重复时没有${})或包含有效的重复条件时,将启用保存重复表达式。
  6. 选择用于格式化动态文本的分隔符,然后点按复选标记以保存:
    • 换行 :在输出字母中的每个事务条目后插入换行符。
    • 文本 :在输出字母中的每个事务项后面插入指定的文本字符。
    插入条件后,重复文本将以红色突出显示,并在其左侧显示一个手柄。 您可以将鼠标悬停在重复项左侧的手柄上,以视图重复构造。
    您可以点击手柄以视图重复的弹出菜单,该菜单允许您编辑或删除重复构造。
  7. 预览相关信件,并注明文本会根据重复内容呈现。 可以使用以下方式输入DD元素的值:
    • 在预览带有样本数据的字母时,根据相关数据字典创建的样本XML数据文件。
    • 附加到相关数据字典的XML数据文件。
    有关详细信息,请参 阅数据字典
    静态文本与事务详细信息一起重复。 重复静态文本由此过程中对文本应用的重复而简化。 ${DD_creditcard_TransactionAmount > 0.5}的条件可确保在信函中不呈现低于USD .5的事务。
    您只能在创建或编辑相关文本模块时插入条件并重复上述操作。 在预览字母时,虽然可以编辑文本模块,但无法插入条件或重复。

使用内联条件并重复——某些用例

在条件内重复

您可能需要在某个条件中使用重复。 Commendence Management允许您在内联条件构造中使用重复。
例如,在条件中重复(以红色格式)以下内容(以绿色格式)。
当重复呈现信用卡交易时,条件${DD_creditcard_nooftransactions > 0}确保仅在至少存在一个交易时才呈现重复构造。
同样,根据您的要求,您可以创建:
  • 一个条件内的一个或多个条件
  • 重复项中的一个或多个条件
  • 条件和在条件或重复内重复的组合

内联条件为空

您可能需要插入空的内联条件,稍后嵌入文本和DD元素。 通信管理允许您这样做。
但是,建议尽可能先在文本模块中插入具有预期格式(如项目符号)的文本和DD元素,然后应用内联条件。