交互式通信中的文本

概述

文本文档片段由一个或多个文本段落组成。 段落可以是静态的或动态的。 动态段落可以包含表单数据模型属性和变量。 您还可以应用规则并在文本文档片段中重复。 例如，称呼中的客户名称可以是表单数据模型(FDM)属性，其值在运行时可用。 通过更改这些值，可以使用相同的交互式通信来为使用代理用户界面的不同客户准备交互式通信。

交互式通信中的文本文档片段支持以下类型的动态数据：

• 数据模型对象:数据属性使用后端数据源。
• 基于规则的内容:根据规则显示或隐藏的文本中的部分内容。规则也可以基于表单数据模型属性和变量。
• 变量:在文本文档片段中，变量未绑定到后端数据源。代理在准备交互式通信以将其提交到帖子进程时，会填写/选择变量中的值，或将变量绑定到数据源。
• 重复:您的交互式通信中可能包含动态信息，例如信用卡对帐单中的交易，其发生次数可能会随着每个生成的交互式通信而不断变化。使用重复，可以格式化和构建此类动态信息。 有关更多信息，请参阅内联条件和重复。

创建文本

1. 选择​Forms > 文档片段。

2. 选择​创建 > 文本。

3. 指定以下信息：

   • 标题:（可选）输入文本文档片段的标题。标题不必是唯一的，并且可以包含特殊字符和非英语字符。 文本由其标题（如果可用）引用，例如在缩略图和属性中。

   • 名称:文本在文件夹中的唯一名称。任何状态中的两个文档片段（文本、条件或列表）都不能在文件夹中以相同的名称存在。 在“名称”字段中，您只能输入英语字符、数字和连字符。 “名称”字段会根据“标题”字段自动填充。 在“标题”字段中输入的特殊字符、空格、数字和非英文字符将在“名称”字段中替换为连字符。 尽管标题字段中的值会自动复制到名称中，但您可以编辑该值。

   • 描述:键入文本的描述。

   • 表单数据模型:（可选）选择“表单数据模型”单选按钮，以基于表单数据模型创建文本。选择“表单数据模型”单选按钮时，将显示​表单数据模型​字段。 浏览并选择表单数据模型。 在为交互式通信创建文本和条件时，请确保使用打算在交互式通信中使用的相同数据模型。 有关表单数据模型的更多信息，请参阅数据集成。

   • 标记:（可选）要创建自定义标记，请在文本字段中输入值，然后按Enter。保存此文本时，会创建新添加的标记。

4. 点按​Next。

   “创建文本”页面。 如果已选择创建基于表单数据模型的文本，则表单数据模型属性将显示在左窗格中。

5. 在文本中键入，并使用以下选项来设置格式、设置条件以及在文本中插入表单数据模型属性和变量：

   • 表单数据模型

   • 变量

   • 规则编辑器

   • 格式选项

     • 从其他应用程序中复制粘贴格式文本

     • 突出显示部分文本

   • 重复

   • 特殊字符

   • 搜索和替换文本

   • 键盘快捷键

   注意

   您可以在文本编辑器中使用@符号添加表单数据模型元素、数据字典元素和变量。 在文本编辑器中输入以@开头的字符串时，将搜索所有数据模型元素、数据字典元素和变量，并显示包含搜索字符串的元素或变量。 您可以在搜索结果中导航并选择一个元素或变量。 如果没有匹配结果，则会显示​未找到匹配结果​消息。

6. 点按​保存。

   将创建文本。 现在，您可以在创建交互式通信时继续将文本用作构建基块。

编辑文本

您可以使用以下步骤编辑现有的文本文档片段。 您还可以选择在交互式通信编辑器中编辑文本文档片段。

1. 选择​Forms > 文档片段。
2. 导航到文本文档片段并将其选中。
3. 点按​编辑。
4. 进行所需的更改。 有关文本中选项的更多信息，请参阅创建文本。
5. 点按​保存，然后点按​关闭。

使用表单数据模型属性个性化文本文档片段

您可以通过插入表单数据模型属性来个性化文本文档片段。 通过将表单数据模型属性插入文本，您可以在预览交互式通信时，从关联的数据源获取并填充特定于收件人的数据。 有关表单数据模型的更多信息，请参阅AEM Forms数据集成。

如果在创建文本时指定了表单数据模型，则表单数据模型中的属性将显示在文本编辑器的左窗格中。 对于文本文档片段以及包含该文本文档片段的交互式通信，指定的表单数据模型应该相同。

• 要将表单数据模型属性插入文本，请将光标放在要插入该属性的位置，然后点按左窗格中的​[A]​属性，然后点按​[B]添加选定的。 您也只需双击该属性即可将其插入到​[C]​光标位置。 表单数据模型属性以褐色背景色突出显示。

或者，您也可以使用文本编辑器中的@符号搜索和添加表单数据模型属性。 将光标放在要插入属性的位置。 键入@ ，然后键入搜索字符串。 对文档片段中可用的所有表单数据模型属性和变量执行搜索操作。 将检索包含搜索字符串的属性或变量，并将其显示为下拉列表。 在搜索结果中导航，然后单击要在光标位置插入的属性。 按Esc可隐藏搜索结果。

• 要允许代理在代理UI中编辑表单数据模型属性的值，同时使用代理UI准备和发送交互式通信，请点按该属性的​[D]​锁定图标，并确保该属性处于解锁状态。 属性的默认状态已锁定，且代理无法在代理UI中编辑该属性。

您还可以使用表单数据模型属性来构建用于显示或隐藏部分内容的规则。 有关更多信息，请参阅在文本中创建规则 。

在文本文档片段中创建和使用变量

变量是可在创建交互式通信时绑定的占位符。 变量可以绑定到表单数据模型属性或文本片段。 变量也可留待代理填充。

在以下情况下，您可以使用变量而不是表单数据模型属性：

• 文本文档片段将用于多个交互式通信中，其中对于不同的交互式通信需要不同的绑定。
• 文本文档片段创建时没有表单数据模型。 您可以插入变量，稍后在创建交互式通信时将其绑定到表单数据模型属性。
• 您需要绑定和检索文本文档片段中的文本。 只有这些文本文档片段才能绑定到变量，而不应在中具有任何变量。

创建或编辑文本文档片段时，可以创建和插入变量。 您创建的变量显示在代理UI的“数据”选项卡中。 代理在使用代理UI准备和发送交互式通信时指定变量的值。

创建变量

1. 在左窗格中，点按​变量。

   此时将出现“变量”窗格。

   

2. 点按​创建。

   此时会出现“创建变量”窗格。

3. 输入以下信息，然后点按​创建:

   • 名称 :变量的名称。
   • 描述 :（可选）输入有关变量的描述。
   • 类型 :选择变量类型：字符串、数字、布尔值或日期。
   • 仅允许特定值 :对于字符串变量和数字变量，您可以确保代理从代理UI中占位符的特定值集中进行选择。要指定值集，请选择此选项，然后指定允许在​Values​字段中使用的逗号分隔值。

4. 点按​创建。

   随即会创建变量并在“变量”窗格中列出该变量。

5. 要在文本中插入变量，请将光标放在适当的位置，选择变量，然后点按​添加选定项。

   

   变量以浅蓝色背景颜色突出显示，而表单数据模型属性以棕色突出显示。

   或者，您也可以使用文本编辑器中的@符号搜索和添加变量。 将光标放在要插入变量的位置。 键入@ ，然后键入搜索字符串。 对文档片段中可用的所有表单数据模型属性和变量执行搜索操作。 将检索包含搜索字符串的属性和变量，并将其显示为下拉列表。 在搜索结果中导航，然后单击要在光标位置插入的变量。 按Esc可隐藏搜索结果。

6. 点按​保存。

以文本形式创建规则

使用文本中的规则编辑器，您可以创建规则以根据​预设条件​显示或隐藏文本或内容段的字符串。 这些条件可以基于：

• 字符串
• 数字
• 数学表达
• 日期
• 关联的表单数据模型的属性
• 您可能已在文本中创建的任何变量

在文本中创建规则

1. 创建或编辑文本时，请选择要使用规则条件化的文本字符串、段落或内容。

   

2. 点按​创建规则。

   此时将显示创建规则对话框。 除了字符串、数字、数学表达式和日期之外，规则编辑器中还提供以下内容以用于创建规则语句：

   • 关联的表单数据模型的属性
   • 您可能已创建的任何变量

   选择要评估的相应选项。

   

   注意

   创建规则以条件化和显示文本时不支持集合属性。

3. 选择相应的运算符以评估规则，如“等于”、“包含”和“开头”。

   

4. 插入评估表达式、值、数据模型属性或变量。

   

   规则：根据FDM的源数据，如果收件人的位置为US，则显示所选文本

   • 创建或编辑规则时，您还可以点按（调整大小）以展开创建规则/编辑规则对话框。 利用扩展的全窗口对话框，可拖放表单数据模型属性和变量以构建规则。 再次点按调整大小，以返回到创建规则对话框。
   • 您还可以在规则中创建多个条件。
   • 您还可以创建重叠规则，在该规则中，规则将应用于已应用规则的内容的一部分。

5. 点按​完成。

   将应用规则。 应用规则的文本或内容将以绿色突出显示。 将鼠标悬停在高亮显示的左手柄上时，将显示应用的规则。

   

   单击已应用规则的左句柄后，您将获得用于编辑或删除规则的选项。

设置文本格式

创建或编辑文本时，工具栏会根据您选择进行的编辑类型而发生更改：段落、对齐方式或列表：

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

字体编辑工具栏

对齐工具栏

列表工具栏

突出显示/强调部分文本

要在可编辑的文档片段中突出显示\强调部分文本，请选择文本，然后点按高亮显示颜色。

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

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

粘贴格式化文本

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

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

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

在文本中插入特殊字符

如果需要，在文档片段中插入特殊字符。 例如，您可以使用“特殊字符”面板插入：

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

文本编辑器内置了对210个特殊字符的支持。 管理员可以通过自定义🔗添加对更多/自定义特殊字符的支持。

搜索和替换文本

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

“查找和替换”功能允许您在文本文档片段中搜索（和替换）任何文本字符串。 该功能还包含功能强大的正则表达式搜索功能。

1. 打开用于编辑的文本文档片段。

2. 点按​查找并替换。

3. 在​查找​文本框中输入要搜索的文本，在​替换​文本框中输入新文本（替换文本），然后点按​替换。

4. 如果找到搜索的文本，则替换文本。

   • 如果找到搜索文本的另一个实例，则该实例会在文本文档片段中突出显示。 如果再次点按​Replace，则会替换突出显示的实例，并且光标会向前移动（如果找到第三个实例）。
   • 如果找不到其他实例，“查找并替换”对话框将显示一条消息：模块已结束。

   您还可以点按全部替换，以一次性替换所有匹配项。

   “查找并替换”还包含功能强大的正则表达式搜索功能。 要在搜索中使用正则表达式，请选择​Reg ex，然后点按​查找​或​替换。