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