文档片段是通信中可重复使用的部件/组件,您可以使用这些部件/组件来撰写信件/通信。 文档片段的类型如下:
文本资产是包含一个或多个文本段落的内容片段。 段落可以是静态的或动态的。 动态段落包含对数据元素的引用,数据元素的值在运行时提供。 例如,信函问候语中的客户名称可以是动态数据元素,其值在运行时可用。 通过更改这些值,可以使用相同的信件模板为不同的客户生成信件。
通信管理解决方案支持两种类型的动态数据项(变量数据):
创建占位符时,通信管理模板不会强制您创建唯一的名称。 如果创建两个具有相同名称的占位符(如文本和条件),并在信件模板中同时使用它们,则最后插入的占位符的值将同时用于这两个占位符。 如果两个占位符具有相同的名称,则会比较其类型。 如果类型不同,则其类型将变为字符串。 但是,在模块中,不能创建具有相同名称的多个占位符。
选择 Forms > 文档片段.
点按 创建 > 文本 或者,选择文本资产并点按 编辑.
为文本指定以下信息:
点按 下一个. 通信管理显示“编辑器”页面,您可以在该页面中向文本添加文本段落和数据元素。
浏览器中的默认拼写检查程序在文本编辑器中检查拼写。 要管理拼写和语法检查,您可以编辑浏览器的拼写检查设置或安装浏览器插件/插件以检查拼写和语法。
您还可以使用文本编辑器中的各种键盘快捷键来管理、编辑和设置文本格式。 有关 文本编辑器 通信管理键盘快捷键中的键盘快捷键。
随即会打开文本编辑器,输入文本。 使用页面顶部的工具栏设置文本格式、插入条件、链接和分页符。
随即会打开文本编辑器。 输入文本。 工具栏会根据您选择进行的编辑类型而发生更改:段落、对齐方式或列表:
选择工具栏类型:段落、对齐方式或列表
列出工具栏(单击以打开全尺寸图像)
要重复使用其他应用程序中存在的多个文本段落之一(例如,从MS Word或HTML页面),请将文本复制并粘贴到文本编辑器中。 复制的文本的格式将保留在文本编辑器中。
您可以在可编辑的文本模块中复制并粘贴一个或多个文本段落。 例如,您可能有一个MS Word文档,其中包含可接受居住证明的项目符号列表,如下所示:
您可以直接将MS Word文档中的文本复制并粘贴到可编辑的文本模块中。 文本模块中会保留格式(如项目符号列表、字体和文本颜色)。
但是,粘贴文本的格式有一些 限制.
如果需要,在文档片段中插入特殊字符。 例如,您可以使用“特殊字符”面板插入:
通信管理内置了210个特殊字符。 管理员可以 通过自定义添加对更多/自定义特殊字符的支持.
要在可编辑的内嵌模块中突出显示\强调部分文本,请选择该文本,然后点按“高亮显示颜色”。
您可以直接点按基本颜色 **[A]**
在“基本颜色”调板中显示或点按 选择 使用滑块后 **[B]**
来选择相应的颜色阴影。
或者,您也可以转到“高级”选项卡以选择相应的“色相”、“明度”和“饱和度” **[C]**
创建精确颜色,然后点按选择 **[D]**
以应用颜色来突出显示文本。
在数据面板中,将数据字典元素和占位符元素拖放到文本中。
收件人:
在数据字典的示例数据文件中指定的占位符元素
CCR视图中的占位符元素值从数据字典变量中填充(如示例数据文件中指定)
您还可以使用@符号搜索数据字典和占位符元素,并将其添加到文本编辑器。 将光标放在要插入元素的位置。 键入@ ,然后键入搜索字符串。 文本编辑器对文本文档片段中可用的所有数据字典和占位符元素执行搜索操作。 搜索操作会检索包含搜索字符串的元素并将其显示为下拉列表。 在搜索结果中导航,然后单击要在光标位置插入的元素。 按Esc可隐藏搜索结果。
您可以使用内联条件并重复上述步骤,使您的信件具有高度的上下文和良好的结构。 有关内联条件和重复的更多信息,请参阅 内联条件和以字母形式重复.
点按保存。
执行以下步骤以在文本资产中创建超链接:
在文本编辑器中选择文本或数据模型对象。
点按 链接. 点按 替换文本 字段来删除现有数据模型对象名称或文本。
指定URL并点按 .
使用包含大量文本的文本元素时,需要搜索特定的文本字符串。 您可能还需要将特定文本字符串替换为替换字符串。
“查找和替换”功能允许您搜索(和替换)文本元素中的任何文本字符串。 该功能还包含功能强大的正则表达式搜索功能。
在文本编辑器中打开文本模块。
点按查找并替换。
在“查找”文本框中输入要搜索的文本,然后按“查找”。 在文本模块中,搜索文本会突出显示。
要搜索文本的下一个实例,请再次按“查找”。
如果继续按“查找”按钮,则搜索将继续进入页面。 在找到文本的最后一个实例后,将显示消息 模块已到达结尾 表示找不到更多搜索结果。
但是,如果在文本模块中未找到搜索文本的实例,则显示的消息为: 未找到匹配项.
如果再次按“查找”,则搜索将在页面顶部继续。
匹配大小写: 搜索仅返回大小写相同的结果。
全字: 搜索仅返回整个词。
如果在“查找”文本框中输入任何特殊字符,则“全字”选项将被禁用。
注册表: 使用正则表达式进行搜索。 例如,以下正则表达式会在文本模块中搜索电子邮件地址:
[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}
在文本编辑器中打开文本模块。
点按查找并替换。
在“查找”文本框中输入要搜索的文本,以及要将查找文本替换为的文本,然后按“替换”。
如果找到搜索文本,则该文本将被替换文本。
如果再次按“查找”,则搜索将在页面顶部继续。
使用全部替换选项替换文本模块中文本的所有实例。 当“”时,替换项的数量将在“查找并替换”对话框中显示为消息。
使用一致的命名约定来避免重复。
在文本模块中使用适当的数据字典绑定。
更改文本资产时,使用文本编辑器时应用以下规则:
列表是一组文档片段,包括文本、(其他)列表、条件和图像。 列表元素的顺序可以是固定的或可编辑的。 在创建信件时,您可以使用部分或全部列表元素来复制可重用的元素模式。 列表的行为基本上与可嵌套在其他目标中的目标一样。
实施列表包括两个步骤:
列表是一组相关内容,可在信件模板中用作单个单位。 任何类型的内容都可以添加到列表中。 列表也可以嵌套。 列表模块可指定为:
选择 Forms > 文档片段.
选择 创建 > 列表.
为列表指定以下信息:
点按 下一个.
点按 添加资产.
要将资产添加到列表,请在选择资产页面中选择资产,然后点按 完成.
资产会添加到列表项页面。
要更改列表中资产的顺序,请点按并按住箭头图标( )和拖放。 当用户在“创建通信”用户界面中打开信件模板时,内容会按您在此处定义的顺序进行组装。
您可以选择以下选项来指定列表在CCR用户界面中的行为方式:
库访问:要启用用于添加资产的库访问权限,请点按库访问。 启用“库访问”后,声明调整器可以向列表添加更多内容。 否则,“索赔调整器”将仅限于您为列表定义的内容。
锁定顺序:要锁定列表中资产的顺序,以便索赔调整者无法更改顺序,请点按锁定顺序。 如果不选择此选项,“索赔调整器”可以更改列表项的顺序。
添加项目符号:使用此选项可将项目符号或编号样式应用于模块。 您可以使用预先设计的列表样式或自定义列表样式。 您还可以指定要在每个列表项目之前和之后显示的文本。
分页:选择此选项( )在列表内容之间添加分页符。 未选择此选项时(
),则当列表内容溢出到下一页时,整个列表会移到下一页,而不是在列表之间的页面中断开。
分配配置:使用此选项可指定可添加到列表的资产的最小和最大数量。
您可以选择以下选项来指定列表中每个资产在运行时的行为方式:
点按保存。
使用一致的命名约定来避免重复。
使用适当的数据字典绑定
使用列表编辑器更改列表时,适用以下规则:
条件允许您根据提供的数据定义在通信/信件创建时包含的内容。 该条件用控制变量描述。 添加条件时,您可以选择根据控制变量具有的值包含资产。
根据您选择的选项,将仅评估基于当前条件变量的第一个找到true的表达式,或评估所有条件。 在“创建通信”(CCR)中填写信件时,条件会显示为“白框”。 如果某个条件导致出现列表,则将输出该列表的所有必需项目和预先选定的项目。 如果其中任何项目是条件或列表本身,则其生成的内容也会以自上而下的深度优先顺序输出为文本和图像内容的平面列表。 条件结果可以是任何类型(文本、列表、条件或图像)。
条件编辑器附带 表达式生成器 支持使用多个占位符和数据字典元素创建表达式的用户界面。 您可以在此类表达式中使用常用操作数和本地/全局函数。 每个表达式都可以与某些内容关联,或者,如果任何表达式的计算结果都不为true,则可能有一个默认部分。 所有表达式都将按照定义它们的顺序进行计算,并选择返回true的第一个表达式,该条件模块会返回其关联内容。
例如,如果信件中的条款和条件文本因客户所处的状态而异,并且数据字典包含一个名为“state”的元素,则可以按如下方式添加条件:·状态= NY,选择T&C_NY文本段落·状态= NC,选择T&C_NC文本段落
条件编辑器允许您指定默认条件。 如果控制变量的值与任何条件都不匹配,则使用与默认条件关联的内容。 在上一个示例之后,您可以添加此条件行:·默认,选择T&C_Rest
选择 Forms > 文档片段.
选择 创建>条件.
为列表指定以下信息:
点按 下一个.
点按 添加资产.
要将资产添加到条件,请在选择资产页面中选择该资产,然后点按 完成. 资产将添加到“表达式”窗格。
您可以选择以下选项来指定条件在运行时的行为方式:
要更改条件中资产的顺序,请点按并按住箭头图标( )和拖放。 当用户在“创建通信”用户界面中打开信件模板时,内容会按您在此处定义的顺序进行组装。
点按 删除 删除行。 如果为默认行点按删除,则仅会清除资产信息。
点按 复制 复制行。
点按 编辑 更改资产或编辑表达式。
进一步:
使用一致的命名约定进行轻松搜索并避免重复。
条件的行为与case语句类似,因此条件的顺序很重要。 返回第一个匹配项。
使用适当的数据字典绑定
使用条件编辑器编辑条件时,适用以下规则:
布局片段基于在Designer中创建的XDP。 要创建布局片段,您需要创建XDP和 上传到AEM Forms.
一个或多个布局片段可以形成信件的一部分并定义这些部分的图形布局。 布局片段可以包含典型的表单字段(如地址和引用编号)和表示目标区域的空子表单。 此外,布局片段还允许您创建表并将其插入字母中。
一个常见用例是在信件中找到可重复使用的布局模式,并为其创建布局片段。 例如,字母的称呼、地址和主题部分,按同一顺序显示多个字母。 另一个示例可以是一个表格,该表格中使用的行和列数与多个字母的行和列数相似。
您可以基于现有XDP创建布局片段。 布局片段可以由字段和目标区域或一个或多个表组成。 布局中的表可以是静态的或动态的。 在Designer和 已上传到AEM Forms. XDP可以形成布局片段或信件的结构。 有关 布局设计.
使用绑定到目标区域的片段,可在创作时更改信件。 可以创建具有不同维度的布局片段,并且可以将相应的片段绑定到目标区域。 布局片段还允许您自定义某些表属性:
在执行此过程之前,请使用Designer创建XFA片段。 片段可以包含用于组织字段和目标区域的表。 Designer允许创建两种类型的表:静态和动态。 静态表包含固定数量的行。 静态表可以包含目标区域和字段。 这些目标区域和字段无法绑定到重复的DDE。 动态表也可以有一行。 绑定到表单元格的数据确定动态表的行数。 动态表只能包含字段。 DDE可以是重复的,也可以是非重复的。
设计表时请考虑以下几点:
对于占位符表,您可以在创建片段时自定义以下属性。
对于非占位符表,可以自定义以下属性:
您可以在信件中嵌套片段。 这意味着您可以在片段中添加片段。 通信管理解决方案在信件中支持多达四个级别的嵌套: 信件->片段->片段->片段->片段。
有关在布局片段中使用静态和动态表的详细示例,请参阅 示例文件:在信件中使用静态表和动态表.
选择 创建 > 布局片段.
通信管理会显示可用的XDP。 选择要作为布局片段基础的XDP,然后点按 下一个.
指定布局的以下信息:
点按 表 选项卡,并为布局指定以下信息:
配置:选择正在配置的表。如果表是静态表,则作为下拉列表中表名的后缀为(静态);如果表是动态表,则作为表名的后缀为(动态)。 静态表包含固定数量的行。 静态表可以包含目标区域和字段。 这些目标区域和字段无法绑定到重复的DDE。 绑定到表单元格的数据确定动态表的行数。
行:选择布局的行数。 配置的行计数必须大于或等于原始行计数。
列:选择布局的列数。 配置的列计数必须大于或等于原始列计数。
对于每列,需要以下详细信息:
有关在布局片段中使用静态和动态表的详细示例,请参阅 示例文件:在信件中使用静态表和动态表.
点按保存。
有关将XDP上传/导入到通信管理的说明,请参阅 将资产导入和导出到AEM Forms.
在Designer中创建目标区域时,有助于将所有新子表单的默认绑定设置为“无”。
要设置默认绑定:
在Designer中,点按 工具 > 选项 > 数据绑定 > 子表单绑定.
在“新子表单的默认绑定”列表中,选择 无数据绑定.
这可确保默认情况下,使用“插入”>“子表单”命令或通过从对象面板拖放插入的子表单具有“无”绑定。 这意味着,默认情况下,任何新子表单都是目标区域,除非您向其添加内容、更改其绑定设置或使用“_int”后缀命名子表单。
如果在“创建通信”用户界面中创建的已完成信件用于填写以后的工作流。 在创建布局时,请遵循与第508节相关的建议。 否则,信件PDF将用于显示,您可以忽略以下建议:
/field/assist/speak@priority="toolTip"
在中指定工具提示文本 /field/assist/toolTip
.
在Designer中设计布局时,请确保日期字段的格式与 通信管理配置属性. 有关更多信息,请参阅设计器帮助中的“设置字段值格式和使用模式”。
处理日期组合(如startDate - endDate)时,请使用单个子表单以确保在完成的信件中正确对齐,并最大限度地减少字段数。
当布局包含许多字段和目标区域(这些字段和目标区域被映射到单个XML元素)时,请使用表单级别绑定并为每个元素创建一个单独的节点。 在通信管理中映射数据时,将忽略在表单级别绑定的字段。
子表单目标区域在主控页面中在管理资产用户界面中不可见,且数据无法映射到这些区域。
设计布局时,请注意选择子表单。 如果布局包含单个子表单,则可以是流类型。 在子表单中放置字段后,可以将其包裹在另一个子表单中,这样包裹的子表单也会流动,并且布局不会受到干扰。
在主控页面上放置字段时,请注意以下事项:
许多信件模板都包含表。 表可以是静态的,如术语和条件表,其中每行代表一个条件,每个部分都显示在单独的列中。 表也可以是动态的,如帐户信息,其中包含客户名称、帐户ID、交易编号和交易金额等信息。
DD具有一个集合元素Ontimee_details,该元素具有一个包含三个基元元素的复合元素:Optimee_name、Optimee_address和Optimee_gender。
动态XDP也具有相同的标头。 这样,您就可以将动态XDP字段与上述DD字段进行映射。
此示例显示如何创建动态和静态表,将动态表绑定到DDE,然后创建包含这两个表的信件。 使用此示例时,您可以从头开始创建文件,也可以使用步骤中给定的输入文件。
创建要在示例中使用的数据字典(DD),如图形中所示。
然后选择DD并导出示例数据。 您获取的XML文件包含Employee数据和Notifieed_details的三个实例(默认情况下下载3个实例)。 您可以根据自己的要求添加或删除页面)。 更新值,然后导入DD中的测试数据。 CMP文件是包,其中包含DD。 因此,将DD导入通信管理。
有关使用数据字典和测试数据的更多信息,请参阅 数据字典.
在Designer中,创建两个XDP(布局片段):动态表和静态表。 对于这两个布局:
或者,使用随此步骤附加的静态和动态XDP。
有关使用布局片段的更多信息,请参阅 布局片段.
有关设计布局的更多信息,请参阅 Designer帮助.
将XDP上传到AEM Forms。
根据动态XDP创建布局片段。 属性的“表”选项卡显示表是动态的(“配置”字段)。 行(1)和列(3)的数量是从XDP/布局片段派生的。
此布局的字段稍后会绑定到导入的DD,在信件中,行数会根据测试数据文件(随DD附加的XML数据文件)中的记录数动态创建。
单击以打开全尺寸图像
根据静态XDP创建布局片段。 属性的“表”选项卡显示表是静态的(“配置”字段)。 行(1)和列(3)的数量是从XDP/布局片段派生的。
使用其中的两个布局片段创建信件。 在信件中插入动态XDP时,将其字段的绑定设置为数据字典的收集元素。
有关创建信件和信件模板的更多信息,请参阅 创建信件.
保存信件并预览它。 预览信件时,信件中会显示数据词典中的值。 对于动态表,有三行。 这是因为测试数据有这三行记录。
对于静态表,在创建布局片段时指定的行和列数与您指定的相同。
对于动态表,根据测试数据文件中的记录数显示三行。 之所以出现这种情况,是因为在将布局添加到信件时,您在动态表的字段与数据字典的收集元素之间创建了绑定。 “名称”、“地址”和“性别”值会从您使用的测试数据文件中填充。
要快速创建具有与现有文档片段类似的属性和内容的文档片段,可以复制并粘贴该文档片段。