文档片段

文档片段

文档片段是通信的可重用部分/组件,您可以使用它来编写字母/通信。 文档片段有以下类型:

  • 文本:文本资产是由一个或多个文本段落组成的内容。段落可以是静态的或动态的。
  • 列表:列表是一组文档片段,包括文本、列表、条件和图像。列表元素的顺序可以固定或编辑。 在创建字母时,您可以使用部分或全部列表元素来复制元素的可重用模式。
  • 条件:条件允许您根据提供的数据定义在相应创建时包含的内容。该条件用控制变量来描述。 控制变量可以是数据字典元素或占位符。
  • 布局片段:布局片段是可在一个或多个字母中使用的布局。布局片段用于创建可重复的模式,特别是动态表。 布局可包含“地址”和“引用编号”等典型表单字段。 它还包含表示目标区域的空子表单。 布局(XDP)在Designer中创建,然后上传到AEM Forms。

文本

文本资产是由一个或多个文本段落组成的内容。 段落可以是静态的或动态的。 动态段落包含对数据元素的引用,其值在运行时提供。 例如,字母问候语中的客户名称可以是动态数据元素,其值在运行时可用。 通过更改这些值,可以使用相同的字母模板为不同的客户生成字母。

对应管理解决方案支持两种动态数据项(可变数据):

  • 数据字典元素:这些元素绑定到数据字典并从提供的数据源获取其值。数据字典变量可以受到保护或不受保护。 在对应创建过程中,用户可以修改不受保护数据字典变量的默认值,但不能修改受保护的变量。
  • 占位符:这些变量不绑定到后端数据源。它们要求用户在创建通信时填写值。 默认情况下,占位符不受保护。
注意

在创建占位符时,“对应管理”模板不会强制您创建唯一名称。 如果创建两个名称相同的占位符(如文本和条件),并在字母模板中同时使用它们,则最后插入的占位符的值将用于这两个占位符。 如果两个占位符具有相同的名称,则比较其类型。 如果类型不同,则其类型将变为字符串。 但是,在模块中,不能创建多个同名占位符。

创建文本

  1. 选择​Forms > 文档片段

  2. 点按​创建 > 文本​或选择文本资产,然后点按​编辑

  3. 为文本指定以下信息:

    • 标题:(可选) 输入文本资产的标题。标题不必是唯一的,可以有特殊字符和非英语字符。 文本由其标题(如果可用)引用,例如在缩略图和资产属性中。
    • 名称: 文本资产的唯一名称。任何状态中都不能存在两个资产(文本、条件或列表),且其名称相同。 在“名称”字段中,只能输入英语字符、数字和连字符。 名称字段会根据标题字段自动填充。 在“标题”字段中输入的特殊字符、空格、数字和非英语字符将替换为“名称”字段中的连字符。 尽管标题字段中的值会自动复制到名称中,但您可以编辑该值。
    • 描述:键入资产的描述。
    • 数据字典:(可选)选择要在其中映射的数据字典。此属性允许您在文本资产中添加对数据字典元素的引用。
    • 标记:(可选)要创建自定义标记,请在文本字段中输入值,然后按Enter。您可以在标记文本字段下看到标记。 保存此文本时,还会创建新添加的标记。
  4. 点按​下一步。 “对应管理”显示“编辑器”页,您可以在该页向文本添加文本段落和数据元素。

    浏览器中的默认拼写检查器在文本编辑器中检查拼写。 要管理拼写和语法检查,您可以编辑浏览器的拼写检查器设置或安装浏览器插件/加载项来检查拼写和语法。

    您还可以使用文本编辑器中的各种键盘快捷键来管理、编辑和设置文本格式。 有关“对应管理键盘快捷键”中文本编辑器键盘快捷键的详细信息。

  5. 将打开文本编辑器,输入文本。 使用页面顶部的工具栏设置文本、插入条件、链接和分页符的格式。

    工具栏

    • 链接:在文 本中插入超文本链接。
    • 重复:重复使用分隔符打印数据字典中的收集元素。
    • 条件:点按以插入条件。根据条件插入文本。 如果条件为true,则文本以字母显示,否则不显示。
    • 添加描述:向文本添加注释。这是作者可见的元数据,但不是所创建字母的一部分。
    • 分页符:如果将文本模块的分页属性设置为false,则文本模块不会跨页分页。

    将打开文本编辑器。 输入文本。 工具栏会根据您选择进行的编辑类型而更改:段落、对齐方式或列表:

    选择工具栏类型

    选择工具栏类型:段落、对齐方式或列表

    段落工具栏

    段落工具栏
    对齐工具栏对齐工具栏

    列表工具栏

    列表工具栏(单击可打开全尺寸图像)

  6. 要重复使用其他应用程序中存在的文本的一个或多个段落,例如从MS Word或HTML页面复制文本并粘贴到文本编辑器中。 复制的文本的格式将保留在文本编辑器中。

    您可以在可编辑的文本模块中复制和粘贴一个或多个文本段落。 例如,您可能有一个MS Word文档,带有一个项目符号列表,表示可接受的居住验证,如下所示:

    巴斯德文本word-1

    您可以直接将MS Word文档中的文本复制并粘贴到可编辑的文本模块。 项目符号列表、字体和文本颜色等格式将保留在文本模块中。

    粘贴文本文本模块

    注意

    但是,粘贴文本的格式有一些限制

  7. 如果需要,请在文档片段中插入特殊字符。 例如,您可以使用“特殊字符”调板插入:

    • 货币符号,如€、¥和英镑
    • 数学符号,如∑、√、√、|和^
    • 标点符号,‟如和

    specialcharacters-1

    Commendergence Management内置了210个特殊字符。 管理员可以通过自定义添加对更多/自定义特殊字符的支持。

  8. 要在可编辑的内嵌模块中突出显示\突出显示部分文本,请选择文本,然后点按高亮颜色。

    应用了textbackgroundcolor

    您可以直接点按“基本颜色”调色板中存在的基本颜色**[A]**,或在使用滑块**[B]**选择​后点按​选择<a2/>以选择相应的颜色阴影。

    或者,您也可以转到高级选项卡,选择适当的色相、明度和饱和度**[C]**以创建精确的颜色,然后点按选择**[D]**以应用颜色以高亮显示文本。

    textbackgroundcolor-1

  9. 在数据面板中,将数据字典元素和占位符元素拖放到文本中。

    收件人:

    • 在文本中添加数据字典元素,从列表中选择数据元素,然后点按插入(插入)。 如果选择“受保护”,则数据字典元素为只读并显示在字母编辑器中,但不显示在“创建对应”用户界面或“对应创建器”中。
    • 在文本中添加占位符元素,在“数据元素”面板中点按新建,输入新数据元素的详细信息,然后点按创建,将新元素添加到列表。 新占位符可以以与数据字典元素相同的方式插入到文本中。 要编辑占位符,请选择占位符,然后点按编辑。

    占位符元素

    数据字典的示例数据文件中指定的占位符元素

    字母中的占位符元素

    CCR视图中从数据字典变量填充的占位符元素值(如示例数据文件中指定)

    还可以使用@符号搜索数据字典和占位符元素并将其添加到文本编辑器。 将光标放在要插入元素的位置。 键入@ ,后跟搜索字符串。 文本编辑器对文本文档片段中可用的所有数据字典和占位符元素执行搜索操作。 搜索操作将检索包含搜索字符串的元素并将其显示为下拉列表。 在搜索结果中导航,然后单击要在光标位置插入的元素。 按Esc可隐藏搜索结果。

  10. 您可以使用内联条件并重复,使您的字母具有高度的情境性和良好的结构。 有关内联条件和重复的详细信息,请参阅内联条件和以字母重复。

  11. 点按​保存

执行以下步骤以在文本资产中创建超链接:

  1. 在文本编辑器中选择文本或数据模型对象。

  2. 点按​链接。 点按​替代文本​字段,删除现有数据模型对象名称或文本。

  3. 指定URL并点按保存

在文本资产中创建超链接

搜索并替换文本

处理包含大量文本正文的文本元素时,需要搜索特定文本字符串。 您可能还需要将特定文本字符串替换为替代字符串。

“查找并替换”功能允许您搜索(和替换)文本元素中的任何文本字符串。 该功能还包括强大的常规表达式搜索。

在文本模块中搜索文本

  1. 在文本编辑器中打开文本模块。

  2. 点按查找并替换。

  3. 在“查找”文本框中输入要搜索的文本,然后按“查找”。 搜索文本在文本模块中高亮显示。

  4. 要搜索文本的下一个实例,请再次按“查找”。

    如果继续按“查找”按钮,搜索将继续在页面下方进行。 在找到文本的最后一个实例后,消息​已到达模块​的末尾表示找不到更多搜索结果。

    但是,如果在文本模块中找不到搜索文本的实例,则显示的消息为:找不到匹配

  5. 如果再次按“查找”,则搜索将在页面顶部继续。

搜索选项

匹配大小 写:搜索返回的结果仅具有相同大小写。

全字:搜 索只返回整字。

注意

如果在“查找”文本框中输入任何特殊字符,则禁用“全字”选项。

Reg ex:使 用常规表达式搜索。例如,以下常规表达式在文本模块中搜索电子邮件地址:

[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}

在文本模块中搜索并替换文本

  1. 在文本编辑器中打开文本模块。

  2. 点按查找并替换。

  3. 在“查找”文本框中输入要搜索的文本,并输入要将查找文本替换为的文本,然后按“替换”。

  4. 如果找到搜索文本,则文本将替换为替换文本。

    • 如果找到搜索文本的另一个实例,该实例将在文本模块中高亮显示。 如果再次按Replace键,则高亮显示的实例将被替换,并且光标向前移动(如果找到第三个实例)。
    • 如果找不到另一个实例,则光标将停止在最后一个被替换的实例。
  5. 如果再次按“查找”,则搜索将在页面顶部继续。

    使用“全部替换”选项替换文本模块中文本的所有实例。 执行“”操作时,替换项的数量将在“查找并替换”对话框中显示为一条消息。

文本模块的最佳实践/提示与技巧

  • 使用一致的命名约定来避免重复。

  • 在文本模块中使用适当的数据字典绑定。

  • 更改文本资产时,使用文本编辑器时适用以下规则:

    • 添加变量:允
    • 删除变量:允
    • 属性更新:允
    • 更改数据字典: 在不使用数据字典元素之前允许。更新时无法更改数据字典。

列表

列表是一组文档片段,包括文本、(其他)列表、条件和图像。 列表元素的顺序可以固定或编辑。 在创建字母时,您可以使用部分或全部列表元素来复制元素的可重用模式。 列表基本上就像可嵌套在其他目标中的目标一样。

实施列表

实施列表包括两个步骤:

  1. 定义核心属性,如名称、说明、数据字典。
  2. 属于列表的内容部分,然后设置列表的锁定顺序和库访问等属性。

创建列表

列表是一组相关内容,可以在字母模板中作为单个单元使用。 任何类型的内容都可以添加到列表。 列表也可以嵌套。 列表模块可以指定为:

  • 订购:在“创建对应”运行时中无法更改顺序。
  • 库访问:用户可以向列表添加模块。此标志指定是否启用库访问。 如果启用(打开),则用户在预览信件时可向列表添加模块。
  • 创建列表时,可以指定类型,如:
  • 简单:不会对列表应用其他样式格式。
  • 项目符号:用简单项目符号格式化的列表。
  • 编号:选择标准(1,2,…)、大写罗马字(I,II,…)和下罗马字(i,ii,…)的数字列表。
  • Lettered:字母列表,选择小写(a,b,…)和大写(A,B,…)字母。
  • 自定义:您可以创建任何已编号/已字母类型以及所选前缀和后缀值。
  1. 选择​Forms > 文档片段

  2. 选择​创建 > 列表

  3. 为列表指定以下信息:

    • 标题(可选):输 入列表的标题。标题不需要唯一,并且可以有特殊字符和非英语字符。 列表通过其标题(如果可用)引用,如缩略图和资产属性。
    • 名称: 列表的唯一名称。任何状态中都不能存在两个资产(文本、条件或列表),且其名称相同。 在“名称”字段中,只能输入英语字符、数字和连字符。 名称字段会自动填充标题字段中的值。 在“标题”字段中输入的特殊字符、空格、数字和非英语字符将替换为“名称”字段中的连字符。 尽管标题字段中的值会自动复制到名称中,但您可以编辑该值。
    • 说明(可选):键入资产的描述。
    • 数据字典(可选):或者,选择要连接的数据字典。只能向列表添加与列表使用相同数据字典的资产,或未分配数据字典的资产。 为列表分配数据字典使创建字母模板的人员能更轻松地找到相应的列表。
    • 标记(可选):选择要应用的标记。您还可以键入新标记的名称并创建它。 (点按​保存​时将创建新标记。)
  4. 点按​下一步

  5. 点按​添加资产

  6. 要向列表添加资产,请在选择资产页面中选择资产,然后点按​完成

    选择要添加到列表的资产

  7. 资产会添加到“列表项目”页面。
    要更改列表中资产的顺序,请点按住箭头图标(dragndrop)并拖放。 当用户在“创建对应”用户界面中打开字母模板时,内容将按您在此处定义的顺序进行组合。

    在列表中重新排序和配置资产

  8. 您可以选择以下选项以指定列表在CCR用户界面中的行为:

    • 库访问:要启用用于添加资产的库访问,请点按库访问。启用“库访问”后,声明调整器可向列表添加更多内容。 否则,索赔调整程序仅限于您为列表定义的内容。

    • 锁定顺序:要在列表中锁定资产的顺序,以便索赔调整者无法更改顺序,请点按锁定顺序。如果不选择此选项,“索赔调整者”可以更改列表项的顺序。

    • 添加项目符号:使用此选项可将项目符号或编号样式应用于模块。您可以使用预先设计的列表样式或自定义样式。 您还可以指定在每个列表项之前和之后显示的文本。

    • 分页符:选择此选项 (break)可在列表内容之间添加分页符。如果未选择此选项(nobreak),则如果列表的内容溢出到下一页,则整个列表将移至下一页,而不是在列表之间的页中断。

    • 分配配置:使用此选项可指定可添加到列表的最小和最大资产数。

  9. 您可以选择以下选项以指定列表中每个资产在运行时的行为:

    • 可编辑: 选择此选项后,可以在“创建对应”用户界面中编辑内容。(此选项不适用于列表和图像模块。)
    • 必需: 选择此选项后,“创建对应”用户界面中将需要内容。
    • 选择:选 择此选项后,将在“创建对应用户界面”中预先选择内容。
    • 跳过样式: 选择此选项后,内容将跳过“创建对应”用户界面中的项目符号和编号。(此选项对图像模块不可用。 此外,在“跳过样式”、“复合”和“忽略列表样式”之间,只能将其中一个选项应用于模块。 当您为模块选择“添加项目符号”时,这些选项之一可用于模块。)
    • 缩进: 可以更改作为列表的一部分选择的每个模块/内容的缩进级别。缩进是按“级别”(从零开始)指定的,因此每个缩进级别对应于36pts的填充。
    • 复合: 选择该选项后,复合编号将应用为外部(父列表)的样式和它自己的样式的组合。此嵌套列表上的复合编号基于此嵌套列表在外部列表中的显示顺序。
    • 忽略列表样 式:如果取消选择“复合编号”选项,则启用“忽略列表样式”选项。此选择将忽略嵌套列表自己的样式,并且编号从外部列表继续。 因此,嵌套列表的模块将视为外部列表本身的一部分,而不理会在嵌套列表上指定的任何样式。 如果为嵌套列表取消选择“忽略列表样式”选项,则作为该嵌套列表一部分的模块具有自己的编号样式。
    • 与下一步保 持一致:设置列表中包含的资产的分页符。如果将列表的某个资产的“与下一个资产保持同步”属性设置为​On,则该资产和下一个资产将保留在同一页面上。 这意味着所选资产和下一个资产的内容不会跨页面中断。
  10. 点按​保存

最佳实践/提示与技巧

  • 使用一致的命名约定来避免重复。

  • 使用适当的数据字典绑定

  • 使用列表编辑器更改列表时,适用以下规则:

    • 属性更新:允许
    • 更改数据字典: 在没有使用数据字典的项与它关联之前允许。更新时无法更改数据字典。

条件

条件允许您根据提供的数据定义在相应/信件创建时包含的内容。 该条件用控制变量来描述。 添加条件时,您可以根据控制变量的值选择包含资产。

根据您选择的选项,只评估根据当前条件变量找到的第一个表达式符或所有条件。 在“创建通信(CCR)”中填写字母时,条件表现为“白框”。 如果某个条件导致列表,则输出所有列表的必选和预选项目。 如果这些项目中的任何一项是条件或列表本身,则其生成的内容也会以自上而下的深度优先顺序输出为文本和图像内容的平面列表。 条件结果可以是任何类型(文本、列表、条件或图像)。

实施条件

条件编辑器附带有表达式生成器用户界面,它支持使用多个占位符和数据字典元素创建表达式。 您可以在此类表达式中使用常用操作数和本地/全局函数。 每个表达式都可以与某些内容关联,并且(可选)如果没有一个表达式的计算结果为true,则可能会有一个默认部分。 所有表达式将按定义它们的顺序进行评估,并选择返回true的第一个表达式,并且该条件模块返回其相关内容。

例如,如果字母中的条款和条件文本因客户所处的状态而有所不同,且数据字典包含一个名为“state”的元素,则可以按如下方式添加条件:
· state = NY, select T&C_NY text paragraph
·状态= NC,选择T&C_NC文本段落

条件编辑器允许您指定默认条件。 如果控件变量的值与任何条件都不匹配,则使用与默认条件关联的内容。 按照上一个示例,您可以添加此条件行:
·默认,选择T&C_Rest

创建条件

  1. 选择​Forms > 文档片段

  2. 选择​创建>条件

  3. 为列表指定以下信息:

    • 标题(可选): 输入条件的标题。标题不需要唯一,并且可以有特殊字符和非英语字符。 条件由其标题(如果可用)引用,如缩略图和资产属性。
    • 名称: 条件的唯一名称。任何状态中都不能存在两个资产(文本、条件或列表),且其名称相同。 在“名称”字段中,只能输入英语字符、数字和连字符。 名称字段会根据标题字段自动填充。 在“标题”字段中输入的特殊字符、空格、数字和非英语字符将替换为“名称”字段中的连字符。 尽管标题字段中的值会自动复制到名称中,但您可以编辑该值。
    • 说明(可选) 键入条件的说明。
    • 数据字典(可选):或者,选择要连接的数据字典。只能将使用与条件相同的数据字典的资产,或未分配数据字典的资产添加到列表。 为列表分配数据字典使创建字母模板的人员能更轻松地找到相应条件。
    • 标记(可选):(可选)选择要应用的标记。您还可以键入新标记的名称并创建它。 (点按​保存​时将创建新标记。)
  4. 点按​下一步

  5. 点按​添加资产

  6. 要将资产添加到条件,请在选择资产页面中选择它,然后点按​完成。 资产会添加到表达式窗格。

  7. 您可以选择以下选项以指定条件在运行时的行为方式:

    • 禁用多个结果评估\启用多个结果评估:启用此选项(显示为“启用多个……”)后,将评估所有条件,结果是所有真实条件的总和。如果禁用此选项(显示为“禁用多个……”),则只计算发现为true的第一个条件,并成为该条件的输出。
    • 分页符:选择此选项 (break)可在条件的模块之间添加分页符。如果未选择此选项(nobreak),则如果条件溢出到下一页,则整个条件将移到下一页,而不是在条件之间的页中断。
  8. 要更改条件中资产的顺序,请点按住箭头图标(dragndrop)并拖放。 当用户在“创建对应”用户界面中打开字母模板时,内容将按您在此处定义的顺序进行组合。

  9. 点按​删除​以删除行。 如果为默认行点按删除,则仅清除资产信息。

  10. 点按​复制​以重复行。

  11. 点按​编辑​以更改资产或编辑表达式。

    进一步:

    • 要更新资产,请点按资产列下的文件夹图标。
    • 要打开表达式生成器以插入表达式,请点按表达式列下的文件夹图标。 有关表达式生成器的详细信息,请参阅表达式生成器

最佳实践/提示与技巧

  • 使用一致的命名约定轻松搜索并避免重复。

  • 条件的行为方式与大小写语句相似,因此条件的顺序很重要。 返回第一个匹配。

  • 使用适当的数据字典绑定

  • 使用条件编辑器编辑条件时,适用以下规则:

    • 添加变量:允
    • 删除变量:允
    • 属性更新:允
    • 更改数据字典: 在不使用数据字典元素之前允许。

布局片段

布局片段基于在Designer中创建的XDP。 要创建布局片段,您需要创建XDP并将它们上传到AEM Forms

一个或多个布局片段可以构成字母的一部分并定义这些部分的图形布局。 布局片段可以包含典型的表单字段(如地址和引用编号)和表示目标区域的空子表单。 此外,布局片段允许您创建表并将其插入字母中。

一个常见用例是在字母中找到可重复使用的布局模式,并为它们创建布局片段。 例如,字母的问候、地址和主题部分,它以同一顺序显示多个字母。 另一个示例可以是一个表,它的行数和列数与多个字母中使用的行数和列数相似。

您可以基于现有XDP创建布局片段。 布局片段可以由字段和目标区域或一个或多个表组成。 布局中的表可以是静态的或动态的。 XDP在Designer中创建,并且上传到AEM Forms。 XDP可以形成布局片段或字母的结构。 有关布局设计的详细信息。

使用绑定到目标区域的片段,可以在创作时更改字母。 可以创建具有不同维度的布局片段,并将相应的片段绑定到目标区。 布局片段还允许您自定义一些表属性:

  1. 您可以增加行和列数。
  2. 可以为更多行和列指定页眉和页脚文本。
  3. 可以定义表列宽的比率。 运行时表列会根据定义的比率和可用空间调整大小。 宽度比之和必须为100。 否则,它不适用。
  4. 如果表是占位符(仅包含单个空白单元格),则可定义新列的类型(目标区/字段)。
  5. 可以隐藏页眉和页脚行。

在执行此过程之前,请使用Designer创建XFA片段。 片段可包含用于组织字段和目标区域的表。 设计器允许创建两种类型的表:静态和动态。 静态表包含固定数量的行。 静态表可以包含目标区域和字段。 这些目标区域和字段不能绑定到重复的DDE。 动态表也可以有单行。 绑定到表单元格的数据确定动态表的行数。 动态表只能包含字段。 DDE可以是重复的,也可以是非重复的。

设计表时请考虑以下几点:

  1. 可在创建布局片段时自定义表。 但是,仅当表的父子表单被流动时,才启用“自定义”选项。
  2. 对于动态表,所有字段、可重复行和表使用“使用名称”绑定来正确合并数据。
  3. 对于动态表,绑定到表字段的所有重复DDE都属于同一层次结构。 对于非重复DDE,不存在此类限制。
  4. 在将布局片段合并到父目标区表时,会根据可用空间调整大小,但是,仅当布局片段直接在顶级子表单中不包含任何目标区或字段时,才会调整大小。 允许目标区域和表中的字段。
  5. 可创建占位符表。 占位符表只有一个空白单元格。
  • 对于占位符表,您可以在创建片段时自定义以下属性。

    • 行计数
    • 列计数
    • 每列的页眉和页脚
    • 每列的类型(目标区域/字段)
    • 每列宽比
  • 对于非占位符表,可以自定义以下属性:

    • 行计数
    • 列计数
    • 附加列的页眉和页脚
    • 每列宽比

您可以将片段嵌套在字母中。 这意味着您可以在片段中添加片段。 Corresponcement Management解决方案在一个字母中支持多达四个嵌套级别:字母->片段->片段->片段->片段。

有关在布局片段中使用静态和动态表的详细示例,请参见示例文件:在字母中使用静态和动态表。

创建布局片段

  1. 选择​创建 > 布局片段

  2. “对应管理”显示可用的XDP。 选择要作为布局片段基础的XDP,然后点按​下一步

  3. 指定布局的以下信息:

    • 标题(可选): 输入布局片段的标题。标题不需要唯一,并且可以有特殊字符和非英语字符。 布局片段由其标题(如果可用)引用,例如在缩略图和资产属性中。
    • 名称: 布局片段的唯一名称。任何状态中都不能存在两个资产(文本、条件或列表),且其名称相同。 在“名称”字段中,只能输入英语字符、数字和连字符。 名称字段会根据标题字段自动填充。 在“标题”字段中输入的特殊字符、空格、数字和非英语字符将替换为“名称”字段中的连字符。 尽管标题字段中的值会自动复制到名称中,但您可以编辑该值。 此名称显示在“管理资产”用户界面的列表中。
    • 说明(可选):在“管理资产”用户界面的列表中显示的说明。
    • 标记(可选):(可选)选择要应用于条件的标记。您还可以键入新标记的名称并创建它。
  4. 点按​​选项卡,并指定布局的以下信息:

    • 配置:选择要配置的表。如果表是静态表,则作为下拉列表中表名称的后缀为(静态);如果表是动态表,则作为(动态)。静态表包含固定数量的行。 静态表可以包含目标区域和字段。 这些目标区域和字段不能绑定到重复的DDE。 绑定到表单元格的数据确定动态表的行数。

    • :为布局选择行数。配置的行计数必须大于或等于原始行计数。

    • :选择布局的列数。配置的列计数必须大于或等于原始列计数。

    对于每列,都需要以下详细信息:

    • 标题:标题要显示的文本
    • 页脚:要为页脚显示的文本
    • 类型:附加列的类型。字段或目标区。 为静态占位符表启用类型。 类型可以在列级别定义,而不能在单元格级别定义。 扩展列中的所有单元格类型都相同。 对于动态表,所有列都为字段类型。 对于非占位符表,不能定义附加列的类型。 在这种情况下,扩展列中附加单元格的类型与该行中最后一列的类型相同;并且附加行中单元格的类型与该列中最后一个单元格的类型相同。
    • 宽度比: 表列宽的比率。

    有关在布局片段中使用静态和动态表的详细示例,请参见示例文件:在字母中使用静态和动态表。

  5. 点按​保存

将XDP上传到通信管理

有关将XDP上传/导入到Corresponce Management的说明,请参阅将资产导入和导出到AEM Forms

最佳实践/提示与技巧

设置默认子表单绑定

在Designer中创建目标区域时,将所有新子表单的默认绑定设置为“无”会有所帮助。

设置默认绑定:

  1. 在设计器中,点按​工具 > 选项 > 数据绑定 > 子表单绑定

  2. 在“新子表单的默认绑定”列表中,选择“无数据绑定”。

这确保默认情况下,使用“插入”>“子表单”命令或通过从对象调色板拖放插入的子表单具有“无”绑定。 这意味着,默认情况下,任何新子表单都是目标区域,除非您向其添加内容、更改其绑定设置或使用“_int”后缀命名子表单。

第508条——符合

如果使用在“创建对应”用户界面中创建的已完成字母来填写以后的工作流。 在创建布局时,请遵循与第508条相关的这些建议。 否则,字母PDF将用于显示,您可以忽略这些建议:

  • 布局中的所有目标区子表单和所有字段都有跳位顺序。
  • 默认情况下,带有字幕的字段符合508规范。 默认情况下,字段的/field/assist/speak@priority属性设置为“custom”,这意味着除非提供自定义屏幕阅读器文本,否则屏幕阅读器将读取字段的标题。
  • 无标题字段指定工具提示,并通过设置

/field/assist/speak@priority="toolTip" 和在中指定工具提示文本 /field/assist/toolTip

Designer和Asset Configuration Manager中的日期格式

在设计器中设计布局时,请确保日期字段的格式与对应管理配置属性中数据显示格式中指定的日期格式相匹配。 有关详细信息,请参阅设计器帮助中的“格式化字段值和使用模式”。

捕获日期范围

在处理日期组合(如startDate - endDate)时,请使用单个子表单以确保在完成的字母中正确对齐,并将字段数降至最低。

设置表单级绑定

当布局包含映射到单个XML元素的许多字段和目标区域时,请使用表单级绑定并为每个元素创建单独的节点。 在“对应管理”中映射数据时,将忽略表单级别上绑定的字段。

不要在主控页面中使用子表单目标区域

子表单目标区域在主控页面中不可见于“管理资产”用户界面,且数据无法映射到这些区域。

为目标区域选择适当的位置和类型

在设计布局时,请注意选择子表单。 如果布局包含单个子表单,则可以是流类型。 在子表单中放置字段后,可以将其绕排到另一个子表单中,这样封装的子表单也会流动,布局不会受到干扰。

在主控页面上放置字段

将字段放置到主控页面时,请注意以下事项:

  • 将主控页面字段的绑定设置为使用全局数据
  • 请勿将字段直接放在主控页面的根PageArea下。
  • 将字段绕排到命名子表单中,并确保将命名子表单的绑定设置为“使用名称”。

使用布局片段创建表

许多字母模板都包含表。 表可以是静态的,如术语和条件表,其中每行表示一个条件,每个部分显示在单独的列中。 表也可以是动态的,如帐户信息,其中包含诸如客户名称、帐户ID、事务编号和事务金额等信息。

  • 静态表:有时,表会使用具有不同列数的行创建,如术语和条件表。其中,每行表示一个条件,每个条件可以具有不同的子部分。 每个部分都显示在单独的列中。
  • 动态表:布局片段提供将动态表的字段绑定到集合DDE的功能。在字母生成表行时,根据集合DDE的大小生成表行。

DD有一个集合元素Nomineed_details,它有一个包含三个基本元素的复合元素:Optimeen_name、Optimee_address和Optimeene_gender。
动态XDP也具有相同的标头。 因此,您可以将动态XDP字段与上述DD字段进行映射。

示例文件:在字母中使用静态和动态表

此示例说明如何创建动态和静态表,将动态表绑定到DDE,然后创建包含这两个表的字母。 处理此示例时,您可以从头开始创建文件或使用步骤中给出的输入文件。

  1. 创建要在示例中使用的数据字典(DD),如图形中所示。

    然后选择DD并导出示例数据。 您获得的XML文件包含Employee数据和Notimee_details的三个实例(默认情况下下载3个实例)。 您可以根据您的要求添加或删除。) 更新这些值,然后导入DD中的测试数据。 CMP文件是包,其中包含DD。 因此,将DD导入到Corresponce Management。

    有关使用数据字典和测试数据的详细信息,请参阅数据字典

    数据字典结构

    获取文件

  2. 在设计器中,创建两个XDP(布局片段):动态表和静态表。 对于这两种布局:

    • 向表列添加子表单。 确保更改表父子表单的布局以流化和删除表中子表单的绑定。
    • 向表单元格添加子表单。 确保更改表父子表单的布局以流化和删除表中子表单的绑定。

    或者,使用随此步骤附加的静态和动态XDP。

    有关使用布局片段的详细信息,请参阅布局片段
    有关设计布局的详细信息,请参阅设计器帮助

    获取文件

    获取文件

  3. 将XDP上传到AEM Forms。

  4. 根据动态XDP创建布局片段。 属性的“表”(Table)选项卡显示表是动态的(“配置”(Configuration For)字段)。 行(1)和列(3)的数量从XDP/布局片段派生。

    此布局的字段稍后将绑定到导入的DD,在字母中,根据测试数据文件(随DD附加的XML数据文件)中的记录数动态创建行数。

    创建布局片段屏幕

    单击以打开全尺寸图像

  5. 根据静态XDP创建布局片段。 属性的“表”选项卡显示表为静态(“配置”字段)。 行(1)和列(3)的数量从XDP/布局片段派生。

    您可以在此处更改列和行数。 根据您在此屏幕中选择的内容,静态表的行数和列数在使用此布局创建的字母中保持不变。
    创建布局片段屏幕

  6. 使用其中的布局片段创建字母。 在字母中插入动态XDP时,将其字段的绑定设置为数据字典的收集元素。

    有关创建字母和字母模板的详细信息,请参阅创建字母

  7. 保存信函并预览它。 预览字母时,“数据字典”中的值显示在字母中。 对于动态表,有三行。 这是因为测试数据有三条记录用于这些行。

    对于静态表,存在您在创建布局片段时指定的行和列数。

    字母中的静态表

    对于动态表,根据测试数据文件中的记录数显示这三行。 这是因为在将布局添加到字母时,您在动态表的字段和数据字典的收集元素之间创建了一个绑定。 名称、地址和性别值会从您使用的测试数据文件填充。

    字母中的动态表

创建文档片段的副本

要快速创建具有与现有文档片段类似的属性和内容的文档片段,您可以复制并粘贴该片段。

  1. 从文档片段的列表中,选择一个或多个文档片段。 UI将显示复制图标。
  2. 点按复制。UI会显示粘贴图标。 粘贴之前,还可以选择进入文件夹。 不同的文件夹可以包含名称相同的资产。 有关文件夹的详细信息,请参阅文件夹和组织资产
  3. 点按粘贴。 此时会出现“粘贴”对话框。 如果您在同一位置复制和粘贴文档片段,系统将自动为新的字母副本分配名称和标题,但您可以编辑字母的标题和名称。
  4. 如果需要,请编辑要用其保存文档片段副本的标题和名称。
  5. 点按粘贴。 将创建文档片段的副本。

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free