文档片段 document-fragments

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

文档片段 document-fragments-1

文档片段是通信中可重复使用的部件/组件,您可以使用这些部件/组件来撰写信件/通信。 文档片段的类型如下:

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

文本 text

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

通信管理解决方案支持两种类型的动态数据项(变量数据):

  • 数据字典元素:这些元素绑定到数据字典,并从提供的数据源获取其值。 数据字典变量可以受到保护或不受保护。 在通信创建过程中,用户可以修改不受保护的数据字典变量的默认值,但无法修改受保护的数据字典变量。
  • 占位符:这些是未绑定到后端数据源的变量。 它们要求用户在通信创建期间填写值。 默认情况下,占位符不受保护。
NOTE
创建占位符时,通信管理模板不会强制您创建唯一的名称。 如果创建两个具有相同名称的占位符(如文本和条件),并在信件模板中同时使用它们,则最后插入的占位符的值将同时用于这两个占位符。 如果两个占位符具有相同的名称,则会比较其类型。 如果类型不同,则其类型将变为字符串。 但是,在模块中,不能创建具有相同名称的多个占位符。

创建文本 create-text

  1. 选择 Forms > 文档片段.

  2. 点按 创建 > 文本。 或者,选择文本资产并点按 编辑.

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

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

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

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

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

    工具栏

    图: 工具栏

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

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

    选择工具栏类型

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

    段落工具栏

    图: 段落工具栏

    对齐工具栏

    图: 对齐工具栏

    列表工具栏

    图: 列表工具栏

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

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

    pastetextword

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

    pastetexttextmodule

    note note
    NOTE
    但是,粘贴文本的格式有一些 限制.
  7. 如果需要,在文档片段中插入特殊字符。 例如,您可以使用“特殊字符”面板插入:

    • 货币符号,如€、¥和£
    • 数学符号,如∑、√、∂和^
    • 标点符号,如"和"

    特殊字符

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

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

    textbackgroundcolorappled

    您可以直接点按基本颜色 [A] 在“基本颜色”调板中显示或点按 选择 使用滑块后 [B] 来选择相应的颜色阴影。

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

    textbackgroundcolor

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

    收件人:

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

    占位符元素

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

    信件中的占位符元素

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

  10. 您可以使用内联条件并重复上述步骤,使您的信件具有高度的上下文和良好的结构。 有关内联条件和重复的更多信息,请参阅 内联条件和以字母形式重复.

  11. 点按 保存.

搜索和替换文本 searching-and-replacing-text

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

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

在文本模块中搜索文本 to-search-text-in-a-text-module

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

  2. 点按查找并替换。

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

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

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

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

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

搜索选项 search-options

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

全字: 搜索仅返回整个词。

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

注册表: 使用正则表达式进行搜索。 例如,以下正则表达式会在文本模块中搜索电子邮件地址:

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

在文本模块中搜索和替换文本 to-search-and-replace-text-in-a-text-module

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

  2. 点按查找并替换。

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

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

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

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

文本模块的最佳实践/提示和技巧 best-practices-tips-and-tricks-for-text-modules

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

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

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

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

列表 list

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

实施列表 implementing-lists

实施列表包括两个步骤:

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

创建列表 create-a-list

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

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

  2. 选择 创建 > 列表.

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

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

  5. 点按 添加资产.

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

    选择要添加到列表的资产

  7. 资产会添加到列表项页面。

    要更改列表中资产的顺序,请点按并按住箭头图标( dragndrop )和拖放。 当用户在“创建通信”用户界面中打开信件模板时,内容会按您在此处定义的顺序进行组装。

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

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

    • 库访问:要启用用于添加资产的库访问权限,请点按库访问。 启用“库访问”后,声明调整器可以向列表添加更多内容。 否则,“索赔调整器”将仅限于您为列表定义的内容。
    • 锁定顺序:要锁定列表中资产的顺序,以便索赔调整者无法更改顺序,请点按锁定顺序。 如果不选择此选项,“索赔调整器”可以更改列表项的顺序。
    • 添加项目符号:使用此选项可将项目符号或编号样式应用于模块。 您可以使用预先设计的列表样式或自定义列表样式。 您还可以指定要在每个列表项目之前和之后显示的文本。
    • 分页:选择此选项( 中断 )在列表内容之间添加分页符。 未选择此选项时( nobreak ),则当列表内容溢出到下一页时,整个列表会移到下一页,而不是在列表之间的页面中断开。
    • 分配配置:使用此选项可指定可添加到列表的资产的最小和最大数量。
  9. 您可以选择以下选项来指定列表中每个资产在运行时的行为方式:

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

最佳实践/提示和技巧 best-practices-tips-and-tricks

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

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

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

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

条件 conditions

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

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

实施条件 implementing-conditions

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

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

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

创建条件 create-a-condition

  1. 选择 Forms > 文档片段.

  2. 选择 创建>条件.

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

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

  5. 点按 添加资产.

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

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

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

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

  10. 点按 复制 复制行。

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

    进一步:

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

最佳实践/提示和技巧 best-practices-tips-and-tricks-1

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

  • 条件的行为与case语句类似,因此条件的顺序很重要。 返回第一个匹配项。

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

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

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

布局片段 layoutfragments

布局片段基于在Designer中创建的XDP。 要创建布局片段,您需要创建XDP和 上传到AEM Forms.

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

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

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

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

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

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

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

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

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

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

您可以在信件中嵌套片段。 这意味着您可以在片段中添加片段。 通信管理解决方案在信件中支持多达四个级别的嵌套: 信件->片段->片段->片段->片段。

有关在布局片段中使用静态和动态表的详细示例,请参阅 示例文件:在信件中使用静态表和动态表.

创建布局片段 creating-a-layout-fragment

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

  2. 通信管理会显示可用的XDP。 选择要作为布局片段基础的XDP,然后点按 下一个.

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

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

    • 配置:选择要配置的表。 如果表是静态表,则下拉列表中表名称的后缀为(静态);如果表是动态表,则作为(动态)。 静态表包含固定数量的行。 静态表可以包含目标区域和字段。 这些目标区域和字段无法绑定到重复的DDE。 绑定到表单元格的数据确定动态表的行数。
    • :选择布局的行数。 配置的行计数必须大于或等于原始行计数。
    • :选择布局的列数。 配置的列计数必须大于或等于原始列计数。

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

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

    有关在布局片段中使用静态和动态表的详细示例,请参阅 示例文件:在信件中使用静态表和动态表.

  5. 点按 保存.

将XDP上传到通信管理 upload-an-xdp-to-correspondence-management

有关将XDP上传/导入到通信管理的说明,请参阅 将资产导入和导出到AEM Forms.

最佳实践/提示和技巧 best-practices-tips-and-tricks-2

设置默认子表单绑定 set-the-default-subform-binding

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

要设置默认绑定:

  1. 在Designer中,点按 工具 > 选项 > 数据绑定 > 子表单绑定.

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

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

第508款 — 遵守 section-compliance

如果在“创建通信”用户界面中创建的已完成信件用于填写以后的工作流。 在创建布局时,请遵循与第508节相关的建议。 否则,信件PDF将用于显示,您可以忽略以下建议:

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

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

Designer和资产配置管理器中的日期格式 date-formats-in-designer-and-asset-configuration-manager

在Designer中设计布局时,请确保日期字段的格式与 通信管理配置属性. 有关更多信息,请参阅设计器帮助中的“设置字段值格式和使用模式”。

捕获日期范围 capturing-date-ranges

处理日期组合(如startDate - endDate)时,请使用单个子表单以确保在完成的信件中正确对齐,并最大限度地减少字段数。

设置表单级绑定 setting-form-level-binding

当布局包含许多字段和目标区域(这些字段和目标区域被映射到单个XML元素)时,请使用表单级别绑定并为每个元素创建一个单独的节点。 在通信管理中映射数据时,将忽略在表单级别绑定的字段。

请勿在主控页面中使用子表单目标区域 do-not-use-subform-target-areas-in-a-master-page

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

为目标区域选择适当的位置和类型 choosing-appropriate-positions-and-types-for-target-areas

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

在主控页面上放置字段 placing-fields-on-master-pages

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

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

使用布局片段创建表 creating-tables-using-layout-fragments

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

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

DD具有一个集合元素Ontimee_details,该元素具有一个包含三个基元元素的复合元素:Optimee_name、Optimee_address和Optimee_gender。
动态XDP也具有相同的标头。 这样,您就可以将动态XDP字段与上述DD字段进行映射。

示例文件:在信件中使用静态表和动态表 examplewithsamplefiles

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

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

    然后选择DD并导出示例数据。 您获取的XML文件包含Employee数据和Notifieed_details的三个实例(默认情况下下载3个实例)。 您可以根据自己的要求添加或删除页面)。 更新值,然后导入DD中的测试数据。 CMP文件是包,其中包含DD。 因此,将DD导入通信管理。

    有关使用数据字典和测试数据的更多信息,请参阅 数据字典.

    数据字典结构

获取文件

  1. 在Designer中,创建两个XDP(布局片段):动态表和静态表。 对于这两个布局:

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

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

    有关使用布局片段的更多信息,请参阅 布局片段.

    有关设计布局的更多信息,请参阅 Designer帮助.

获取文件

获取文件

  1. 将XDP上传到AEM Forms。

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

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

    创建布局片段屏幕
    单击放大

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

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

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

    有关创建信件和信件模板的更多信息,请参阅 创建信件.

  5. 保存信件并预览它。 预览信件时,信件中会显示数据词典中的值。 对于动态表,有三行。 这是因为测试数据有这三行记录。

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

    信件中的静态表

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

    信件中的动态表

创建文档片段的副本 create-a-copy-of-a-document-fragment

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

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