交互通信中的文本

创建和编辑要在交互通信中使用的文本文档片段——文本是用于构建交互通信的四种类型文档片段之一。 另外三个是条件、列表和布局片段。

概述

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

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

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

创建文本

1. 选择​[!UICONTROL Forms] > 文档片段。

2. 选择​[!UICONTROL Create] > 文本。

3. 指定以下信息：

   • 标题:（可选）输入文本文档片段的标题。标题不必是唯一的，可以有特殊字符和非英语字符。 文本由其标题（如果可用）引用，如缩览图和属性中。
   • 名称:文本在文件夹中的唯一名称。任何状态中都不能存在两个文档片段(文本、条件或列表)，并且文件夹中的名称相同。 在“名称”字段中，只能输入英语字符、数字和连字符。 名称字段会根据标题字段自动填充。 在“标题”字段中输入的特殊字符、空格、数字和非英语字符将替换为“名称”字段中的连字符。 尽管标题字段中的值会自动复制到名称中，但您可以编辑该值。
   • 描述:键入文本的描述。
   • 表单数据模型:（可选）选择“表单数据模型”单选按钮，以基于表单数据模型创建文本。选择“表单数据模型”单选按钮时，将显示​表单数据模型*​字段。 浏览并选择表单数据模型。 在为交互式通信创建文本和条件时，请确保您使用的数据模型与要在交互式通信中使用的数据模型相同。 有关表单数据模型的详细信息，请参阅数据集成。
   • 标记:（可选）要创建自定义标记，请在文本字段中输入值，然后按Enter。保存此文本时，将创建新添加的标记。

4. 点按​下一步。

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

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

   • 表单数据模型

   • 变量

   • 规则编辑器

   • 格式选项

     • 从其他应用程序复制粘贴格式文本
     • 高亮文本的部分

   • 重复

   • 特殊字符

   • 搜索和替换文本

   • 键盘快捷键

6. 点按​保存。

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

编辑文本

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

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

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

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

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

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

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

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

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

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

在以下情况下，可以使用变量代替表单数据模型属性：

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

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

创建变量

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

   出现“Variables（变量）”窗格。

   

2. 点按​创建。

   将出现“创建变量”窗格。

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

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

4. 点按​创建。

   变量将创建并列在“变量”窗格中。

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

   

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

6. 点按​保存。

在文本中创建规则

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

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

在文本中创建规则

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

   

2. 点按​创建规则。

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

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

   选择要评估的相应选项。

   

   

   注意

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

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

   

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

   

   根据FDM的源收件人显示选定文本的规则（如果文本的位置为US）

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

5. 点按​完成。

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

   

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

格式化文本

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

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

字体编辑工具栏

对齐工具栏

列表工具栏

突出显示／突出显示部分文本

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

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

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

粘贴格式化文本

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

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

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

在文本中插入特殊字符

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

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

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

搜索并替换文本

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

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

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

2. 点按​查找并替换。

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

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

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

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

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