文档AEM GuidesAEM Guides 文档

PDF 输出中的变量

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined
  • undefined

变量是用作可重用信息的名称-值对数据。 这使您的内容易于移植且易于更新。 修改变量或其值时，该变量或值的每次匹配项都会更新。

创建新变量

执行以下步骤可创建变量：

创建新变量

创建变量并为其定义值。

  1. 在Web编辑器中，转到​ 输出 ​选项卡。

  2. 选择​ 变量 左侧面板中的 变量图标 {width="25"}。

  3. 选择​ 编辑 编辑铅笔图标 {width="25"}以打开​ 变量 ​编辑器。
    变量按字母顺序列出。

  4. 在“名称”列中 ​输入变量名称，在“值​ ”列中 ​输入其值。

    note tip
    TIP
    您可以将任何HTML内容用作变量值，以特定格式显示变量值。 例如，您可以向变量值添加<b>标记，以粗体显示值​ Experience Manager Guides。 您还可以将存储库中的图像添加为值。

  5. 选择​ 添加变量 “添加”图标 {width="25"}以添加新变量。 不能创建与现有变量同名的变量。 显示错误。

    note note
    NOTE
    如果不选择​ 添加变量 “添加”图标 {width="25"}，未创建变量并将其添加到列表。

这样，您便可以创建具有默认值的变量。 例如：

  • 产品名称：Experience Manager Guides
  • 版本号：2300
  • 发行日期： 2023年1月1日

编辑变量

您可以通过两种方式编辑变量：

从左侧的“变量”面板​ ​

  1. 在​ 变量 ​面板中选择一个变量。
  2. 将鼠标悬停在变量上以查看​ 选项 ​菜单，然后选择​ 编辑 ​选项。
  3. 在​ 编辑变量 ​对话框中，可以编辑所选变量的默认值。
  4. 单击​ 完成。

通过变量编辑器​ ​

  1. 选择​ 变量 左侧面板中的 变量图标 {width="25"}。

  2. 选择​ 编辑 编辑铅笔图标 {width="25"} 以打开 变量 编辑器。

  3. 在变量​ 编辑器中，可以编辑所选变量的值。

您需要保存从变量编辑器所做的​ 任何更改，才能在 ​左侧的“变量​ ”面板中查看 ​它们。

NOTE
如果您编辑任何变量值，Adobe Experience Manager Guides 会在适用的情况下同时更新所有引用。

搜索和预览变量

您可以搜索和预览变量的值。 在​ 变量 ​面板的搜索框中输入字符串。 它同时根据变量名称及其值执行搜索。
您可以通过两种方式预览变量：

变量的预览显示默认值。 例如，如果您已将ProductName变量的默认值定义为“Adobe Experience Manager Guides”，则它会在预览中显示此值。

从左侧的“变量”面板​ ​

  1. 在​ 变量 ​面板中选择一个变量。
  2. 将鼠标悬停在变量上以查看​ 选项 ​菜单，然后选择​ 预览 ​选项。

从变量面板 预览变量 {width="550"}

预览变量的默认值。

通过变量编辑器​ ​

  1. 将鼠标悬停在列表中的变量上以查看​ 选项 ​菜单。
  2. 选择​ 预览。

复制变量

您可以根据需要复制变量并修改值。

  1. 将鼠标悬停在列表中的变量上以查看“ 选项 ”菜单。
  2. 选择“复制​ ”。

变量的默认名称为<selected variable name>（如“示例”）。 您可以根据自己的要求更改名称。

删除变量

您可以通过两种方式删除变量：

从左侧的“变量”面板​ ​

  1. 在​ 变量 ​面板中选择一个变量。
  2. 将鼠标悬停在变量上以查看​ 选项 ​菜单，然后选择​ 删除 ​选项。

通过变量编辑器​ ​

  1. 将鼠标悬停在列表中的变量上以查看​ 选项 ​菜单。
  2. 选择​ 删除 ​选项。

将从所有变量集中删除该变量。

输出预设的变量集

Adobe Experience Manager Guides 还支持变量集，允许您为变量分配替代值。 例如，一家公司可以销售两种产品，A 和 B。它对它们中的每一个都有不同的规格。 这些规范可能包括产品名称、版本号和发布日期。 品牌推广可能存在其他差异。 使用变量集，您可以为变量定义不同的值集。 生成输出时，选择相应的变量集并生成所需的输出。

配置变量集

在将任何变量添加到变量集之前，需要配置变量集。

  1. 选择​ 设置 “设置”图标 {width="25"}打开​ 配置变量集 ​对话框。
    配置变量集 {width="550"}
  2. 在​ 名称 ​列中输入变量集名称。
  3. 选择​ 添加变量 “添加”图标 {width="25"}以添加新变量集。 变量集按字母顺序列出。
  4. 您可以选择​ 删除 ​以删除变量集。

变量集操作

所有变量集都具有相同的变量，但可以具有不同的值。

您可以查看、编辑和预览特定变量集的值。 从​ 变量集 ​下拉列表中选择一个变量集。 根据所选变量集显示值。
编辑特定变量集中的变量值时，它会覆盖默认值并更改所选变量集的值。
例如，您可以为变量集设置以下值：Adobe集1 ​和​ Adobe集2。

变量集1： Adobe集1

  • ProductName： ProductA
  • 版本号：2311
  • 发行日期： 2023年11月2日

变量集2： Adobe集2

  • ProductName： ProductB
  • 版本号：2310
  • 发行日期： 2023年9月7日

每个新变量都会添加到所有变量集中。 当您删除或复制变量时，将会为所有变量集更新该变量。

您还可以预览变量集的值。
例如，对于变量集 Adobe集1，您已将ProductName变量的值定义为“ProductA”，然后在变量编辑器的预览中显示此值。

从变量编辑器预览 变量 {width="550"}

预览您在所选变量集中定义的值。

重置变量的值

如果编辑了该值，则还可以将变量重置为默认值。
重置 重置图标 {width="25"}针对值已更改的变量显示。
例如，您可以将ProductName变量的值重置为默认值Experience Manager Guides。

在本机PDF模板中使用变量

您可以在生成产品文档输出时添加变量，以使它们可移植且易于更新。 您可以在文档的不同页面中显示的页面布局中插入这些变量。 例如，您可以添加变量ProductName ，该变量显示在页面布局的页眉区域（或任何其他部分，如页脚或正文）中。

要在标题区域中插入诸如ProductName之类的变量，请执行以下步骤：

  1. 打开所需的页面布局进行编辑。

    note note
    NOTE
    查看自定义页面布局节，以打开页面布局进行自定义或编辑。

  2. 选择标题可使其在插入变量时处于活动状态。

  3. 可以通过两种方式插入变量：

    从左侧的“变量”面板中

    • 将变量 从“变量 ”面板拖放到标题区域。

    从工具栏

    1. 选择​ 插入变量/字段 变量图标 {width="25"}。
    2. 在​ 变量 ​对话框中，选择变量的名称以将其插入标题区域。
    3. 您还可以在文本框中输入搜索字符串。 将过滤包含给定字符串的变量名称，并将其显示在列表中。 选定的变量将插入标题区域。 您可以查看变量的默认值。
    4. 若要替换变量，请双击该变量值，然后从​ 变量 ​对话框中选择另一个变量。 变量会被替换。

使用变量生成PDF输出

可以使用其他PDF的值生成变量输出。 在生成布局之前，请从输出预设的​ 变量集 ​下拉列表中选择一个变量集以选取其值。

变量集下拉列表

从输出预设的下拉列表中选择要用于生成 PDF 输出的变量集。

NOTE
您还可以从下拉列表中选择“（默认）”以发布所有变量的默认值。

根据您选择的变量集，您将获得与变量集中定义的变量值对应的输出。 例如，如果选择变量集​ Adobe集1，则输出将显示该集中定义的变量值。

带变量的PDF输出

使用页面布局中的变量生成PDF输出。

您还可以在需要时快速更新任何变量集的值并重新生成输出。 例如，如果需要更新版本的详细信息，可以在VersionNumber变量中更新版本的值并重新生成输出。

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178