交互式通信集中管理个性化的交互式信函的创建、汇编和传递。 利用打印作为Web的主控渠道,可最大程度地减少在创建交互式通信的Web输出时的工作重复。
以下是创建交互式通信的先决条件:
登录到AEM创作实例,然后导航到Adobe Experience Manager > Forms > Forms和文档。
点按创建,然后选择交互式通信。 “创建交互式通信”页面。
输入以下信息。 :
标题:输入交互式通信的标题。
名称:交互式通信的名称是从您输入的标题派生的。根据需要编辑它。
描述:输入有关交互式通信的描述。
表单数据模型:浏览并选择表单数据模型。有关表单数据模型的更多信息,请参阅AEM Forms数据集成。
预填充服务:选择预填充服务以检索数据并预填充交互式通信。
后处理类型:您可以选择在提交交互式通信时触发的AEM或Forms工作流。选择要触发的工作流的类型。
后处理:选择要触发的工作流的名称。选择AEM工作流时,提供“附件路径”、“布局路径”、“PDF路径”、“打印数据路径”和“Web数据路径”。
标记:选择要应用于交互式通信的标记。您还可以键入新/自定义标记名称,然后按Enter以创建该名称。
作者:作者姓名自动取自已登录用户的用户名。
发布日期: 输入发布交互式通信的日期。
取消发布日期:输入取消发布交互式通信的日期。
点按Next。 将显示用于指定打印和Web渠道详细信息的屏幕。
输入以下内容:
打印:选择此选项可生成交互式通信的打印渠道。
打印模板:浏览并选择XDP作为打印模板。
Web:选择此选项可生成交互式通信的Web渠道或响应式输出。
交互式通信Web模板:浏览并选择Web模板。
选择 主题:浏览并选择主题以设置交互式通信的Web渠道的样式。有关更多信息,请参阅AEM Forms🔗中的主题。
将“打印为主控”用于Web渠道:选择此选项可创建与打印渠道同步的Web渠道。将打印渠道用作Web渠道的主控,可确保Web渠道的内容和数据绑定是从打印渠道派生的,并且在点按“同步”时,在打印渠道中所做的更改会反映在Web渠道中。 但是,作者可以根据需要中断Web渠道中特定组件的继承。 有关更多信息,请参阅将Web通道与打印通道同步。
如果选择Use Print As 主控 for Web Channel选项,则可以选择以下任何模式以生成Web渠道:
有关打印渠道和Web渠道的更多信息,请参阅打印渠道和Web渠道。
点按创建。将创建交互式通信,并出现一个警报框。 点按编辑以开始构建交互式通信的内容,如使用交互式通信创作用户界面添加内容中所述。 或者,您也可以点按Done,然后选择稍后编辑交互式通信。
创建交互式通信后,可以使用交互式通信创作界面来构建其内容。
有关交互式通信创作界面的更多信息,请参阅交互式通信创作简介。
按照创建交互式通信中所述,点按编辑,即会启动交互式通信创作界面。 或者,您也可以导航到AEM上的现有交互式通信资产,将其选中,然后点按编辑以启动交互式通信创作界面。
默认情况下,将显示交互式通信的打印渠道,除非交互式通信是仅限Web渠道。 交互式通信的打印渠道显示目标区域,如所选XDP/打印渠道模板中所示。 在这些目标区域和字段中,您可以添加组件或资产。
选择打印渠道后,选择组件选项卡。 打印渠道中提供以下组件:
组件 | 功能 |
---|---|
图表 | 添加一个图表,可在交互式通信中使用该图表,以可视方式表示从表单数据模型集合中检索的二维数据。 有关更多信息,请参阅在交互式通信中使用图表。 |
文档片段 | 允许您向交互式通信添加可重用的组件,如文本、列表或条件。 添加的组件可以是基于表单数据模型的组件,也可以是没有表单数据模型的组件。 |
图像 | 允许插入图像。 |
将组件拖放到交互式通信中,并根据需要对其进行配置。
在为打印和Web渠道创作交互式通信时,您还可以使用撤消和重做操作。
使用撤消操作可放弃上次执行的操作,使用重做操作可再次合并已放弃的操作。 例如,如果您在交互式通信中插入了图像或创建了数据绑定,并且需要放弃它,则使用撤消操作。
撤消和重做选项显示在创作UI页面工具栏上。 只有在执行操作后,才会显示撤消选项。 只有在执行撤消操作后,重做选项才会显示在页面工具栏上。 刷新页面时会重置这些操作。
选择打印渠道后,转到Assets选项卡,然后应用过滤器以仅显示您想要查看的资产。
使用资产浏览器,您还可以直接将资产拖放到交互式通信目标区域。
将文档片段拖放到交互式通信中。 以下是可在交互式通信的打印渠道中使用的文档片段类型。
文档片段类型 | 示例用途 |
文本 | 用于添加地址、收件人电子邮件和信件正文文本的文本 |
条件 | 根据策略类型向通信添加相应标头图像的条件:Standard或Premium。 |
列表 | 文档片段的组,包括文本、条件、其他列表和图像。 |
您还可以通过使用Assets选项卡将新片段拖放到目标区域上,来替换目标区域和文档片段之间的绑定。 拖动片段时目标区域的蓝色底纹表示文档片段可以拖放到目标区域。
有关文档片段的更多信息,请参阅文档片段。
通过创作界面,您可以区分未绑定和绑定字段以及交互式通信中的变量。 界面使用橙色边框突出显示未绑定的字段和变量。
此外,当将鼠标悬停在这些元素上时,将显示工具提示,其中包含字段(未绑定)或变量(未绑定)消息。
文档片段中使用的未绑定变量有时可能不会显示在创作界面上。 这可能是由于文档片段中的内嵌文本规则所致,或者是由于条件片段所致。 在这种情况下,以蓝色突出显示的工具提示会作为文档片段的一部分显示。 工具提示显示文档片段中使用的未绑定变量的数量。
点按文档片段,点按(配置),然后点按交互式通信Sidekick中的属性。 变量和数据模型对象部分列出了变量,包括隐藏变量以及文档片段中使用的数据模型对象。 使用每个数据模型对象或变量旁边的
(编辑)图标来编辑属性。
要设置变量绑定,请点按变量并选择(Configure),然后在侧栏的“属性”面板中设置绑定属性。
导航到变量和数据模型对象以设置文档片段中隐藏变量的绑定。
您还可以拖放数据源元素或文本文档片段以设置变量绑定。 要使用任何数据源元素创建绑定,请选择数据源选项卡,然后将该元素拖放到变量名称中。 数据源元素和变量必须具有相同的类型,才能成功设置绑定。 如果将数据源元素拖放到已绑定的变量,则新元素会替换前一个元素,以使用该变量创建新绑定。 同样,选择Assets选项卡,并将文本文档片段拖放到变量名称中,以设置它们之间的绑定。 文本文档片段不得包含任何变量。
要添加表格,并选择打印渠道,请在Assets选项卡中应用过滤器以仅显示布局片段。 将所需的布局片段拖放到交互式通信中。 布局片段基于XDP,可用于在交互式通信中创建图形布局或使用动态数据填充的静态和动态表。
示例:一个布局表,用于显示旧政策和新政策的毛额溢价、忠诚度折扣%以及紧急路边援助可用性。
有关布局片段的更多信息,请参阅文档片段。
选择打印渠道后,在Assets选项卡中,应用过滤器来显示图像。 将所需的图像拖放到交互式通信中,如公司徽标。
此外,在交互式通信中管理以下内容:
切换到Web渠道。 Web渠道显示在交互式通信编辑器中。 首次从“打印”渠道切换到Web渠道时,会进行自动同步。 有关更多信息,请参阅从打印渠道同步Web渠道。
由于在本例中,我们将“打印”用作Web的主控,因此“打印”渠道占位符、内容和数据绑定会同步到Web渠道。 但是,您可以更改和自定义Web渠道中的特定内容。 取消 对使用打印渠道生成的目标区域和变量的继承,以便能够自定义内容。
点按文档片段,点按(配置),然后点按交互式通信Sidekick中的属性。 变量和数据模型对象部分列出了变量,包括隐藏变量以及文档片段中使用的数据模型对象。 使用每个数据模型对象或变量旁边的
(编辑)图标来编辑属性。 此外,对于已在使用打印渠道的Web渠道中自动生成🔗的文档片段,请使用每个数据模型对象和变量旁边的
(取消继承)图标取消继承并能够编辑它们。
要在Web渠道中添加其他组件,并选择Web渠道,请点按组件。 根据需要将组件拖放到交互式通信的Web渠道中,然后继续配置这些组件。
组件 | 功能 |
---|---|
图表 | 添加一个图表,可在交互式通信中使用该图表,以可视方式表示从表单数据模型集合中检索的二维数据。 有关更多信息,请参阅使用图表组件。 |
文档片段 | 允许向交互式通信添加可重用的组件、文本、列表或条件。 您添加到交互式通信的可重用组件可以是基于表单数据模型的组件,也可以是没有表单数据模型的组件。 |
图像 | 允许插入图像。 |
面板 | 用于向交互式通信添加Panel。 |
表 | 添加表格以便按行和列整理数据。 |
目标区域 | 在Web渠道中插入目标区域以组织特定于Web渠道的组件。 目标区域是一个纯容器,用于对特定于Web渠道的组件进行分组。 |
文本 | 向交互式通信的Web渠道中添加富文本。 文本还可以利用表单数据模型对象来使内容动态。 |
按钮 | 用于向交互式通信添加Button。 您可以使用按钮组件导航到其他交互式通信、自适应表单、其他资产(如图像或文档片段)或外部URL。 |
分隔符 | 用于在交互式通信中插入水平线。 使用此组件可区分通信中的各个部分。 例如,您可以使用“分隔符”组件在信用卡对帐单中区分“客户详细信息”和“信用卡详细信息”部分。 |
根据需要,在您的Web渠道中插入资产。
您可以预览交互式通信以查看交互式通信的打印和Web输出,并根据需要继续进行更改。
可以使用预览选项评估交互式通信的外观。 交互式通信的Web渠道还提供了用于模拟各种设备的交互式通信体验的选项。 例如,iPhone、iPad和Desktop。 您可以将预览和模拟器 选项结合使用,以预览不同屏幕大小设备的Web输出。 预览中的示例数据是从指定的表单数据模型填充的。
选择(打印或Web)渠道以预览和点按预览。 出现“Interactive Communication(交互式通信)”。
对于Web渠道,使用查看交互式通信在各种设备上的显示方式。
此外,您还可以使用代理UI🔗准备和发送交互式通信。
在“打印”渠道中,您可以配置附件和库访问权限,以允许代理在代理UI中管理用于交互式通信的附件:
在“打印”渠道中,突出显示文档容器,然后点按属性。
“属性”面板将显示在侧栏中。
展开附件并指定以下属性:
允许库访问:选择以在代理UI中启用代理的库访问。如果启用,则代理可在准备交互式通信时从库添加文件。
允许重新排序附件:选择以使代理使用交互式通信重新排序附件。
允许的最大附件数:指定交互式通信允许的最大附件数。
要附加的文件:点按 添加并浏览以选择要附加的文件,并指定以下内容:
点按完成。
在编辑交互式通信的打印渠道时,将鼠标悬停在打印渠道模板中构建的字段上,然后选择(Configure)。
“属性”(Properties)对话框显示在侧栏中。
指定以下内容:
名称:JCR节点名称。
标题:在代理UI和文档容器树中输入代理可见的标题。
绑定类型:为字段选择以下绑定类型之一。
默认值:默认值可确保当指定的数据模型对象或文本片段没有提供任何值时,该字段不为空。如果数据绑定类型为“无”,则会在字段中预填充默认值。
显示模式:您还可以为字段定义显示格式。从类型下拉列表中选择任何预定义选项,以将显示格式应用于字段。 选择Custom以定义列表中不可用的显示模式。 有关更多信息,请参阅数据显示模式
可由代理编辑:选择以允许代理编辑代理UI中字段中的值。如果“绑定类型”为“文本片段”,则此设置不适用。
标签:在代理UI中为代理指定随字段一起显示的文本字符串。如果“绑定类型”为“文本片段”,则此设置不适用。
工具提示:在Agent UI中,输入一个文本字符串,该字符串将在鼠标悬停在Agent上时可见。如果“绑定类型”为“文本片段”,则此设置不适用。
必需:选择以使该字段对座席为必填字段。如果“绑定类型”为“文本片段”,则此设置不适用。
允许多行:选择此字段可允许在字段中输入多行文本。如果“绑定类型”为“文本片段”,则此设置不适用。
点按。
通过创作界面,您可以为在为打印和Web渠道创建交互式通信时可用的字段、变量和表单数据模型元素定义数据显示模式。
要配置数据显示模式,请点按该元素,选择(Configure),然后在侧栏的Properties面板中设置显示模式。 从类型下拉列表中选择任何预定义选项,以查看与选定类型关联的模式。 从类型下拉列表中选择Custom以定义列表中不可用的模式。 编辑Pattern字段中的值会自动将类型修改为Custom。
要应用显示模式,“模式”字段中定义的字符或位数必须匹配或超过字段、变量和表单数据模型元素值中定义的字符或位数。 有关更多信息,请参阅example。
在从打印渠道生成Web内容后,可以为字段、变量或表单数据模型元素重新定义显示模式。 因此,元素可以为打印和Web渠道定义不同的显示模式。 如果没有为打印渠道中的元素定义显示模式,并且使用打印渠道自动生成Web内容,则为打印渠道中的元素定义的数据绑定定义了Type下拉列表中可用的显示模式选项。 如果没有为元素定义绑定,则元素的数据类型将定义可用的显示模式选项。 例如,如果为打印渠道中的元素创建Number类型的数据绑定,则Type下拉列表中可用的显示模式选项将以各种格式为Number类型。
切换到预览模式或打开代理UI以查看应用于这些元素的显示模式。
下表列出了在为变量设置数据显示模式时显示的值示例:
类型 | 默认值 | 显示图案 | 显示值 | 描述 |
---|---|---|---|---|
社会安全号码 | 123456789 | text | 123-45-6789 | 默认值字段中的位数与“模式”字段中的位数匹配。 成功显示基于模式的值。 |
社会安全号码 | 1234567 | text | 1-23-4567 | 默认值字段中的位数少于“模式”字段中的位数。 该模式适用于7位可用数字。 |
社会安全号码 | 1234567890 | text | 1234567890 | 默认值字段中的位数大于“模式”字段中的位数。 因此,显示值没有变化。 |
如果未为变量或表单数据模型元素指定显示模式,则默认使用全局文档片段配置。
如果未将显示模式应用于数字数据类型的变量,则“打印”预览会根据全局文档片段配置显示该模式。 如果对默认全局文档片段配置应用更改,代理UI仍会根据为区域设置定义的默认分隔符来显示模式。
同样,对于字段,如果未指定显示模式,则创建打印模板(XDP)时定义的模式将应用于该字段。 如果在创建打印模板时没有模式,则基于XFA规范的默认模式将应用于这些字段。
此外,如果指定的显示模式不正确或无法应用,则基于XFA规范的默认模式将应用于字段、变量或表单数据模型元素。
要在交互式通信中条件化组件或内容,请点按组件/内容段,然后选择(创建规则)以启动规则编辑器。
有关更多信息,请参阅:
您可以在交互式通信中使用布局片段添加动态表。 以下步骤使用信用卡报表的示例来说明如何使用布局片段在交互式通信中创建动态表。
确保创建表所需的布局片段在AEM中可用。
在交互式通信的打印渠道中,从资产浏览器将布局片段(包含多列表)拖放到目标区域中。
“交互式通信”布局区域中会显示一个表。
为表的每个单元格指定数据绑定。 要创建可重复行,请在属于公共集合属性的行中插入表单数据模型属性。
点按表中的单元格,然后选择(Configure)。
“属性”(Properties)对话框显示在侧栏中。
配置属性:
名称:JCR节点名称。
标题:输入将在交互式通信编辑器中显示的标题。
绑定类型:为字段选择以下绑定类型之一。
数据模型对象:其值在字段中填充的表单数据模型属性。
默认值:默认值可确保当指定的数据模型对象没有提供值时,该字段不为空。默认值会预填充在字段中。
可由代理编辑:选择以允许代理编辑代理UI中字段中的值。
点按。
预览交互式通信以查看使用数据呈现的表。
点按Web模板中的根面板,然后点按+ ,以将Table组件添加到交互式通信。 在交互式通信中插入包含两行的表。 表的第一行表示表标题。
添加或删除列:
要添加或删除行,请执行以下操作:
A. 添加行 B. 删除行 C. 向上 移动D. 向下移动
您可以使用类型集合的数据模型属性在交互式通信中创建仅Web渠道动态表。 此类表是集合属性的子属性的表示形式。 您只能编辑表中各单元格的格式属性。
您可以根据交互式通信中表格中的任意列对数据进行排序。 列中的值可以按升序或降序排序。
排序可应用于包含以下项的表列:
要启用排序,请执行以下操作:
选择表,然后点按(Configure)。 您还可以使用交互式通信Sidekick中的Content浏览器选择表。
选择启用排序。
点按以保存表属性。 列标题中的排序图标(上箭头和下箭头)表示排序已启用。
切换到预览模式以查看输出。 表格会根据表格的第一列自动排序。
单击列标题可根据列对值进行排序。
带有向上箭头的列标题表示:
同样,带有向下箭头的列标题表示列中的值以降序显示。
创建交互式通信后,您可以在以后的阶段编辑其属性。
使用Properties页可以:
要访问Properties页面,请执行以下操作:
执行以下步骤为现有交互式通信添加Web渠道:
在属性页面上,选择渠道选项卡。
选中Web复选框并为Web渠道选择模板。
选择使用Web通道的主控打印以启用Web通道与打印通道之间的同步。
点按保存并关闭以保存更改。
同样,您也可以点按渠道选项卡上的Web复选框,以从交互式通信中删除Web渠道。
您可以将按钮作为组件添加到交互式通信的Web渠道中。 使用规则编辑器定义规则,以便能够导航到其他交互式通信、自适应表单、其他资产(如图像或文档片段),或点按按钮时的外部URL。
要添加按钮并在其上定义规则,请执行以下操作:
点按Web模板中的根面板,然后点按+ ,以将Button组件添加到交互式通信。
点按按钮组件,然后点按 ,以在点按按钮时定义规则。
在When部分中,从按钮的状态下拉列表中选择clicked。
在Then部分中:
从下拉列表中选择一个操作。 例如,选择导航到作为操作类型。
指定交互式通信、自适应表单、资产或网页的URL。 例如,以下格式指定URL以导航到另一个交互式通信:https://<server-name>:<port>/editor.html/content/forms/af/<Interactive Communication name>/channels/<channel name - print or web>.html
指定在同一选项卡、新选项卡或新窗口中打开资产的选项。
点按完成,然后点按关闭以保存规则。
同样,您也可以从操作类型下拉列表中选择其他可用选项,例如调用服务和提交表单。 有关更多信息,请参阅规则编辑器。
预览交互式通信,然后点按按钮以查看在步骤4(b)中指定的交互式通信、自适应表单、资产或网页。
面板组件是用于将其他组件分组在一起的占位符,可控制在交互式通信中如何布局一组组件(如折叠面板和选项卡)。 面板组件还允许您使一组组件可重复用于最终用户,例如在填写教育凭据所需的多个条目中。
执行以下步骤以将面板组件添加到Web渠道:
使用以下任一选项在Web渠道中插入面板组件:
点按某个组件,点按+并选择面板组件。
从组件浏览器面板中,将面板组件拖放到交互式通信中。
点按内容浏览器面板中的面板,然后点按添加子面板。 选择添加子面板选项将显示添加子面板对话框。 输入面板组件的标题以及可选描述和名称。
从内容浏览器中点按面板,以对面板执行其他操作,如配置、编辑规则、复制、删除和插入组件。
您还可以在Content浏览器中拖放面板,以在右侧窗格中反映交互式通信结构的更改。
在创建交互式通信时,如果选择“打印为Web渠道的主控”,则会创建与“打印”渠道同步的Web渠道,并且Web渠道的内容和数据绑定从打印渠道派生,并且当您点按“同步”时,在打印渠道中所做的更改可能会反映在Web渠道中。
但是,作者可以根据需要中断Web渠道中组件的继承。
如果选择Use Print As 主控 for Web Channel选项,则可以选择以下任何模式以生成Web渠道:
同步渠道仅同步从打印渠道到Web渠道的文档片段、图像、条件、列表和布局片段。 不会同步包含此类元素的子表单或父节点。
如果在创建交互式通信时选择打印为主控,并且没有选择自动同步选项,则还可以将打印渠道元素拖放到Web渠道创作界面。
导航到数据源 > 主控内容以查看打印渠道元素。 将目标区域、字段或表拖放到Web渠道创作界面中。 元素名称旁边的蓝色圆图标表示“打印”渠道元素已包含在Web渠道中。
在Web渠道中,组件嵌入到目标区域中。
将鼠标悬停在Web渠道中的相关目标区域或变量上,然后选择(取消继承),然后在“取消继承”对话框中,点按Yes。
目标区域内组件的继承将被取消,现在您可以根据需要对其进行编辑。
在Web渠道中,如果已取消组件的继承,则可以重新启用该组件。 要重新启用继承,请将鼠标悬停在相关目标区域(包括该组件)的边界上,然后点按。
此时会出现“还原继承”对话框。
如果需要,请选择在还原继承后同步页面。 选择此选项可同步整个交互式通信。 如果不选择此选项,则只有在恢复继承时同步相关目标区域。
点按Yes。
如果您将“打印为Web渠道的主控”并对“打印”渠道进行更改,则可以同步内容以将新所做的更改引入Web渠道。
要将Web渠道与打印渠道同步,请切换到Web渠道,然后点按更多选项图标。
点按以下任一项:
使用同步选项在Web渠道中自动生成内容后,您可以对组件执行更多操作,而无需取消继承。
点按组件可查看以下选项:
复制: 复制组件并将其粘贴到交互式通信中的其他位置。
剪切: 在交互式通信中将组件从一个位置移动到另一个位置。
插入组件: 在选定组件上方插入组件。
粘贴: 使用上述选项粘贴您剪切或复制的组件。
组: 如果要剪切、复制或粘贴多个组件,请选择多个组件。
父项: 选择组件的父项。
查看SOM表达式: 查看组 件 的SOM表达式。
在面板中对象分组: 在面板中对组件分组,以便能够同时对这些组件执行操作。有关详细信息,请参阅面板🔗中的组对象。
取消继承: 取消目 标区域中组件的继承以对其进行编辑。
Web渠道创作界面便于将面板中的组件分组以便能够同时对这些组件执行操作。 内容选项卡将分组的组件列为内容树中面板的子元素。
点按某个组件并选择“组”()操作。
选择多个组件,然后点按面板中的组对象。
在面板中的对象组对话框中,输入面板的名称。
为面板输入可选标题和描述。
单击。
分组的组件在内容树中显示为面板的子元素。
使用PrintChannel API为交互式通信的打印渠道定义输出格式。 如果不定义输出格式,则AEM Forms将生成PDF格式的输出。
//options for rendering print channel of a multi-channel document
PrintChannelRenderOptions renderOptions = new PrintChannelRenderOptions();
PrintDocument printDocument = printChannel.render(renderOptions);
要以任何其他格式生成输出,请指定输出格式类型。 有关支持的输出格式类型列表,请参阅PrintChannel API。
例如,您可以使用以下示例将PCL定义为交互式通信的输出格式:
//options for rendering print channel of a multi-channel document
PrintChannelRenderOptions renderOptions = new PrintChannelRenderOptions();
renderOptions.setRenderFormat(PrintConfig.HP_PCL_5e);
PrintDocument printDocument = printChannel.render(renderOptions);