交互式通信可集中管理个性化交互式信函的创建、集合和交付。 利用打印作为Web的主控渠道,您可以在创建交互式通信的Web输出时最大限度地减少重复工作。
以下是创建交互式通信的先决条件:
登录到AEM创作实例并导航到 Adobe Experience Manager > Forms > Forms和文档.
点按 创建 并选择 交互式通信. 此时会显示“创建交互式通信”页。
输入以下信息。 :
标题:输入交互式通信的标题。
名称:交互式通信的名称派生自您输入的标题。 根据需要进行编辑。
描述:输入有关交互式通信的描述。
表单数据模型:浏览并选择表单数据模型。 有关表单数据模型的详细信息,请参阅 AEM Forms数据集成.
预填充服务:选择预填充服务以检索数据并预填充交互式通信。
后处理类型:您可以选择AEM或Forms工作流,以便在提交交互式通信时触发。 选择要触发的工作流的类型。
后处理:选择要触发的工作流的名称。 选择AEM Workflow时,请提供“附件路径”、“布局路径”、“PDF路径”、“打印数据路径”和“Web数据路径”。
标记:选择要应用于交互式通信的标记。 您还可以键入新的/自定义标记名称并按Enter键以创建它。
作者:作者名称自动从登录用户的用户名中获取。
发布日期: 输入发布交互式通信的日期。
取消发布日期:输入取消发布交互式通信的日期。
点按 下一个. 此时将显示用于指定打印和Web渠道详细信息的屏幕。
输入以下内容:
打印:选择此选项可生成交互式通信的打印渠道。
打印模板:浏览并选择XDP作为打印模板。
Web:选择此选项可生成Web渠道或交互式通信的响应式输出。
交互式通信Web模板:浏览并选择Web模板。
主题 和 选择主题:浏览并选择主题以设置交互式通信的Web渠道的样式。 有关更多信息,请参阅 AEM Forms中的主题.
对Web Channel使用“打印为主控”:选择此选项可创建与打印渠道同步的Web渠道。 将打印渠道用作Web渠道的主控选项可确保从打印渠道派生Web渠道的内容和数据绑定,并且当您点按“同步”时,在打印渠道中所做的更改将反映在Web渠道中。 但是,作者可以根据需要中断Web渠道中特定组件的继承。 有关更多信息,请参阅 将Web渠道与打印渠道同步.
如果您选择 对Web Channel使用“打印为主控” 选项,您可以选择以下任意模式来生成Web渠道:
有关打印渠道和Web渠道的详细信息,请参阅 打印渠道和Web渠道.
点按创建。此时会创建交互式通信并出现一个警报框。 点按 编辑 开始构建交互式通信的内容,如中所述 使用交互式通信创作用户界面添加内容. 或者,您可以点按 完成 并选择稍后编辑交互式通信。
创建交互式通信后,可以使用交互式通信创作界面来构建其内容。
有关交互式通信创作界面的详细信息,请参阅 交互式通信创作简介.
点按编辑时,会启动交互式通信创作界面,如中所述 创建交互式通信. 或者,您也可以导航到AEM上现有的交互式通信资产,选择该资产,然后点按 编辑 以启动交互式通信创作界面。
默认情况下,将显示交互式通信的打印渠道,除非交互式通信是仅限Web渠道的。 交互式通信的打印渠道显示目标区域,如在选定的XDP/打印渠道模板中可用。 在这些目标区域和字段中,您可以添加组件或资源。
选择打印渠道后,选择 组件 选项卡。 打印渠道中提供了以下组件:
Component | 功能 |
---|---|
图表 | 添加可在交互式通信中使用的图表,用于显示检索自表单数据模型集合的二维数据。 有关更多信息,请参阅 在交互式通信中使用图表. |
文档片段 | 允许向交互式通信添加可重复使用的组件,如文本、列表或条件。 添加的组件可以基于表单数据模型,也可以不使用表单数据模型。 |
图像 | 可让您插入图像。 |
将组件拖放到交互式通信中,并根据需要进行配置。
在为“打印”和“Web”渠道创作交互式通信时,也可以使用撤消和重做操作。
使用撤消操作可放弃上次执行的操作,使用重做操作可再次合并已放弃的操作。 例如,如果在交互式通信中插入了图像或创建了数据绑定,并且需要将其丢弃,则使用撤消操作。
撤消和重做选项显示在创作UI页面工具栏上。 撤消选项仅在执行操作后显示。 仅在执行撤消操作后,重做选项才会显示在页面工具栏上。 在刷新页面时,将重置这些操作。
选择打印渠道后,转到 资产 选项卡并应用过滤器,以仅显示要查看的资源。
使用资产浏览器,您还可以直接将资产拖放到交互式通信目标区域。
将文档片段拖放到交互式通信中。 以下是您可以在交互式通信的打印渠道中使用的文档片段类型。
文档片段类型 | 示例用途 |
文本 | 用于添加地址、收件人电子邮件和信件正文的文本 |
条件 | 根据策略类型向通信添加相应标头图像的条件: Standard或Premium。 |
列表 | 文档片段组,包括文本、条件、其他列表和图像。 |
您还可以使用将新片段拖放到目标区域上,以替换目标区域和文档片段之间的绑定。 资产 选项卡。 拖动片段时目标区域的蓝色阴影表示文档片段可以拖放到目标区域。
有关文档片段的更多信息,请参阅 文档片段.
创作界面使您能够区分交互式通信中未绑定和已绑定的字段和变量。 界面使用橙色边框突出显示未绑定的字段和变量。
此外,当您将鼠标悬停在这些元素上时,会显示工具提示,其中显示“字段”(Unbound)或“变量”(Variable)(Unbound)消息。
文档片段中使用的未绑定变量有时可能不会显示在创作界面上。 这种情况可能由于文档片段中的内联文本规则或条件片段而发生。 在这种情况下,以蓝色突出显示的工具提示将显示为文档片段的一部分。 工具提示显示文档片段中使用的未绑定变量的数量。
点按文档片段,点按 (配置),然后点按 属性 互动式交流的副手。 此 变量和数据模型对象 部分列出了变量,包括隐藏变量以及文档片段中使用的数据模型对象。 使用
每个数据模型对象或变量旁边的(编辑)图标以编辑属性。
要设置变量的绑定,请点击变量并选择 (配置),然后在侧栏的“属性”面板中设置绑定属性。
导航到 变量和数据模型对象 在文档片段中设置隐藏变量的绑定。
您还可以拖放数据源元素或文本文档片段以设置变量的绑定。 要创建与任何数据源元素的绑定,请选择 数据源 选项卡,并将元素拖放到变量名称中。 数据源元素和变量的类型必须相同,才能成功设置绑定。 如果将数据源元素拖放到已绑定的变量中,则新元素会替换上一个元素,从而使用变量创建新绑定。 同样,选择 资产 制表符并将文本文档片段拖放到变量名称以设置它们之间的绑定。 文本文档片段不得包含任何变量。
要添加表格,并在选定打印渠道的情况下,在 资产 选项卡应用过滤器以仅显示布局片段。 将所需的布局片段拖放到交互式通信中。 布局片段基于XDP,可用于在交互式通信中创建图形布局或填充了动态数据的静态和动态表。
示例:一个布局表,用于显示旧策略和新策略的毛溢价、忠诚度折扣百分比以及紧急路边协助可用性。
有关布局片段的更多信息,请参阅 文档片段.
选择打印渠道后,在 资产 选项卡应用过滤器以显示图像。 将所需的图像拖放到交互式通信中,例如公司徽标。
此外,在交互式通信中管理以下内容:
切换到 Web渠道. Web渠道显示在交互式通信编辑器中。 首次从打印渠道切换到Web渠道时,将自动进行同步。 有关更多信息,请参阅 从打印渠道同步Web渠道.
由于在本例中,我们对Web使用“打印为主控”,因此打印渠道占位符、内容和数据绑定将同步到Web渠道。 但是,您可以更改和自定义Web渠道中的特定内容。 取消继承 已使用打印渠道生成的目标区域和变量可进行自定义。
点按文档片段,点按 (配置),然后点按 属性 互动式交流的副手。 此 变量和数据模型对象 部分列出了变量,包括隐藏变量以及文档片段中使用的数据模型对象。 使用
每个数据模型对象或变量旁边的(编辑)图标以编辑属性。 此外,对于已 自动生成 在使用打印渠道的Web渠道中,使用
(取消继承)图标可将每个数据模型对象和变量旁边的 取消继承 并且能够编辑它们。
要在Web渠道中添加其他组件(在选择了Web渠道的情况下),请点按 组件. 根据需要将组件拖放到交互式通信的Web渠道中,然后继续配置它们。
组件 | 功能 |
---|---|
图表 | 添加可在交互式通信中使用的图表,用于显示检索自表单数据模型集合的二维数据。 有关更多信息,请参阅 使用图表组件. |
文档片段 | 允许向交互式通信添加可重复使用的组件、文本、列表或条件。 添加到交互式通信的可重用组件可以基于表单数据模型,也可以不使用表单数据模型。 |
图像 | 可让您插入图像。 |
面板 | 允许您添加 面板 到交互式通信。 |
表 | 添加表格以便按行和列整理数据。 |
目标区域 | 在Web渠道中插入目标区域以组织特定于Web渠道的组件。 Target area是一个普通容器,可用于对Web渠道特定的组件进行分组。 |
文本 | 向交互式通信的Web渠道添加富文本。 文本还可以利用表单数据模型对象使内容动态化。 |
按钮 | 允许您添加 按钮 到交互式通信。 您可以使用按钮组件导航到其他交互式通信、自适应表单、其他资产(如图像或文档片段)或外部URL。 |
分隔符 | 允许在交互式通信中插入水平线。 使用此组件可区分通信中的节。 例如,您可以使用分隔符组件区分信用卡对帐单中的“客户详细信息”和“信用卡详细信息”部分。 |
根据需要,在Web渠道中插入资产。
您可以 预览交互式通信 查看交互式通信的打印和Web输出外观,并根据需要进行更改。
您可以使用 预览选项 评估交互式通信的外观。 交互式通信的Web渠道还提供了为各种设备模拟交互式通信体验的选项。 例如,iPhone、iPad和桌面。 您可以同时使用两者 预览 和 模拟器 用于预览不同屏幕大小设备的Web输出的选项相互结合。 预览中的示例数据是从指定的表单数据模型中填充的。
选择要预览的(打印或Web)渠道,然后点按预览。 出现“Interactive Communication(交互式通信)”。
对于Web渠道,请使用 查看交互式通信在各种设备上的外观。
此外,您还可以 使用代理UI准备和发送交互式通信.
在Print channel中,您可以配置附件和库访问权限,以允许Agent管理交互式通信的Agent UI中的附件:
在打印渠道中,突出显示文档容器并点按 属性.
“属性”面板将显示在侧栏中。
展开 附件 和指定以下属性:
允许库访问:选择此项可在代理UI中为代理启用库访问权限。 如果启用,Agent可以在准备交互式通信时从库添加文件。
允许对附件重新排序:选择此项可允许代理通过交互式通信对附件重新排序。
允许的最大附件数量:指定交互式通信允许的最大附件数。
要附加的文件:点按 添加 和浏览以选择要附加的文件,并指定以下内容:
点按完成。
编辑交互式通信的打印渠道时,将鼠标悬停在打印渠道模板中构建的字段上,然后选择 (配置)。
“属性”对话框显示在侧栏中。
指定以下内容:
名称:JCR节点名称。
标题:输入代理在代理UI和文档容器树中对代理可见的标题。
绑定类型:为字段选择以下绑定类型之一。
默认值:默认值可确保指定数据模型对象或文本片段未提供值时的字段不为空。 如果数据绑定类型为none,则默认值会预填充到字段中。
显示模式:您还可以定义字段的显示格式。 从中选择任何预定义选项 类型 下拉列表,用于将显示格式应用于字段。 选择 自定义 定义列表中不可用的显示模式。 有关更多信息,请参阅 数据显示模式
可由代理编辑:选择可允许代理在代理UI中编辑字段中的值。 如果绑定类型为文本片段,则此设置不适用。
标签:指定在代理UI中向代理显示带有字段的文本字符串。 如果绑定类型为文本片段,则此设置不适用。
工具提示:输入文本字符串,鼠标悬停在代理UI中的代理上时将显示该字符串。 如果绑定类型为文本片段,则此设置不适用。
必需:选择以将该字段设为代理的必填字段。 如果绑定类型为文本片段,则此设置不适用。
允许多行:选择此字段可允许多行文本作为字段中的条目。 如果绑定类型为文本片段,则此设置不适用。
点按 .
通过创作界面,您可以定义在为打印和Web渠道创建交互式通信时可用的字段、变量和表单数据模型元素的数据显示模式。
要配置数据显示模式,请点按元素,选择 (配置)并设置中的显示模式 属性 面板中。 从中选择任何预定义的选项 类型 下拉列表以查看与选定类型关联的模式。 选择 自定义 从 类型 下拉列表,以定义列表中不可用的模式。 编辑中的值 图案 字段自动将类型修改为 自定义.
要应用显示模式,在“模式”字段中定义的字符数或数字数必须与字段、变量和表单数据模型元素的值中定义的字符数或数字数匹配或超过该值。 有关更多信息,请参阅 示例.
从打印渠道生成Web内容后,您可以为字段、变量或表单数据模型元素重新定义显示模式。 因此,元素可以具有为打印和Web通道定义的不同显示模式。 如果您没有为打印渠道中的元素定义显示模式并使用打印渠道自动生成Web内容,则为打印渠道中的元素定义的数据绑定将定义 类型 下拉列表。 如果没有为元素定义绑定,则元素的数据类型将定义可用的显示模式选项。 例如,如果为打印渠道中的元素创建Number类型的数据绑定,则在 类型 下拉列表是各种格式的“数字”类型。
切换到 预览 模式或打开代理UI以查看应用于这些元素的显示模式。
下表列出了在设置变量的数据显示模式后显示的值的示例:
类型 | 默认值 | 显示模式 | 显示值 | 描述 |
---|---|---|---|---|
社会安全号码 | 123456789 | 文本 | 123-45-6789 | 默认值字段中的位数与“模式”字段中的位数匹配。 基于模式的值显示成功。 |
社会安全号码 | 1234567 | 文本 | 1-23-4567 | 默认值字段中的位数小于“模式”字段中的位数。 该模式适用于7个可用数字。 |
社会安全号码 | 1234567890 | 文本 | 1234567890 | 默认值字段中的位数大于“模式”字段中的位数。 因此,显示值没有变化。 |
如果没有为变量或表单数据模型元素指定显示模式,则 全局文档片段配置 默认使用。
如果不将显示模式应用于number数据类型的变量,打印预览将根据全局文档片段配置显示模式。 如果将更改应用于默认全局文档片段配置,代理UI仍会根据为区域设置定义的默认分隔符显示模式。
同样,对于字段,如果未指定显示模式,则在创建打印模板(XDP)时定义的模式将应用于该字段。 如果在创建打印模板时没有模式,则将基于XFA规范的默认模式应用于字段。
此外,如果指定的显示模式不正确或无法应用,则将基于XFA规范的默认模式应用于字段、变量或表单数据模型元素。
要在交互式通信中条件化组件或内容,请点按组件/内容并选择 (创建规则)以启动规则编辑器。
有关更多信息,请参阅:
您可以使用布局片段在交互式通信中添加动态表。 以下步骤使用信用卡语句的示例来说明如何使用布局片段在交互式通信中创建动态表。
确保创建表所需的布局片段在AEM中可用。
在交互式通信的打印渠道中,将布局片段(带有多列表)从资产浏览器拖放到目标区域中。
交互式通信布局区域中将显示一个表。
为表的每个单元格指定数据绑定。 要创建可重复行,请在属于公用集合属性的行中插入表单数据模型属性。
点按表中的单元格并选择 (配置)。
“属性”对话框显示在侧栏中。
配置属性:
名称:JCR节点名称。
标题:输入将在交互式通信编辑器中可见的标题。
绑定类型:为字段选择以下绑定类型之一。
数据模型对象:表单数据模型属性,其值填充在字段中。
默认值:默认值可确保指定数据模型对象未提供值时的字段不为空。 默认值会预填充到字段中。
可由代理编辑:选择可允许代理在代理UI中编辑字段中的值。
点按 .
预览交互式通信以查看使用数据呈现的表。
点按Web模板中的根面板,然后点按 + 添加 表 交互通信组件。 在交互式通信中插入包含两行的表。 表的第一行表示表标题。
要添加或删除列,请执行以下操作:
要添加或删除行,请执行以下操作:
答: 添加行 B. 删除行 C. 上移 D. 下移
您可以使用类型集合的数据模型属性,在交互式通信中创建仅限Web渠道的动态表。 此类表是集合属性的子属性的表示形式。 您只能编辑表中各种单元格的格式属性。
您可以在交互式通信中根据表中的任意列对数据进行排序。 列中的值可以按升序或降序排序。
排序可应用于包含以下内容的表列:
要启用排序,请执行以下操作:
选择表并点按 (配置)。 您还可以使用选择表 内容 交互通信中的浏览器。
选择 启用排序。
点按 以保存表属性。 列标题中的排序图标(向上箭头和向下箭头)表示已启用排序。
切换到 预览 模式以查看输出。 该表会根据表的第一列自动排序。
单击列标题可根据列对值进行排序。
带向上箭头的列标题表示:
同样,带向下箭头的列标题表示列中的值以降序显示。
创建交互式通信后,可在以后编辑其属性。
使用 属性 页面至:
要访问 属性 页面:
执行以下步骤,为现有的交互式通信添加Web渠道:
在 属性 页面上,选择 渠道 选项卡。
选择 Web 复选框,然后选择Web渠道模板。
选择 对Web Channel使用“打印为主控” 启用Web渠道和打印渠道之间的同步。
点按 保存并关闭 以保存更改。
同样,您可以点按 Web 上的复选框 渠道 选项卡,从交互式通信中删除Web渠道。
您可以将按钮作为组件添加到交互式通信的Web渠道中。 使用定义规则 规则编辑器 点按按钮可导航到其他交互式通信、自适应表单、其他资产(如图像或文档片段)或外部URL。
要添加按钮并对其定义规则,请执行以下操作:
点按Web模板中的根面板,然后点按 + 以添加 按钮 交互通信组件。
点按按钮组件并点按 以定义点击按钮的规则。
在 时间 部分,选择 已单击 从按钮下拉列表的状态中。
在 则 部分:
从下拉列表中选择一个操作。 例如,选择 导航到 作为操作类型。
指定交互式通信、自适应表单、资产或网页的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渠道选择“打印为主控”,则Web渠道将与“打印”渠道同步创建,并且Web渠道的内容和数据绑定从打印渠道派生,而且当您点按“同步”时,在打印渠道中所做的更改会反映在Web渠道中。
但是,作者可以根据需要中断Web渠道中的组件继承。
如果您选择 对Web Channel使用“打印为主控” 选项,您可以选择以下任意模式来生成Web渠道:
同步渠道仅将文档片段、图像、条件、列表和布局片段从打印渠道同步到Web渠道。 包含此类元素的子表单或父节点不会同步。
如果在创建交互式通信时选择“打印为主控”,但未选择“自动同步”选项,则还可以将“打印渠道”元素拖放到Web渠道创作界面。
导航到 数据源 > 主控内容 查看Print channel元素。 将目标区域、字段或表拖放到Web渠道创作界面。 元素名称旁边的蓝色圆圈图标表示Print channel元素已包含在Web channel中。
在Web渠道中,组件嵌入到目标区域中。
将鼠标悬停在Web渠道中的相关目标区域或变量上,然后选择 (取消继承),然后在“取消继承”对话框中,点按 是.
目标区域内组件的继承将被取消,现在您可以根据需要编辑它们。
在Web渠道中,如果已取消组件的继承,则可以重新启用它。 要重新启用继承,请将鼠标悬停在相关目标区域(包括组件)的边界上,然后点按 .
将显示“还原继承”对话框。
如果需要,请选择 在恢复继承后同步页面. 选择此选项可同步整个交互式通信。 如果不选择此选项,则在恢复继承时,将仅同步相关的目标区域。
点按 是.
如果您对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);