在电子报告中设计多语言报告

概述

作为业务用户，您可以使用电子报告 (ER) 框架根据各个国家或地区的法律要求配置必须生成的传出文档的格式。 当这些要求需要针对不同国家或地区以不同语言生成传出文档时，您可以配置一个包含语言相关资源的 ER 格式。 这样，您可以重用此格式来生成各个国家或地区的传出文档。 您可能还希望使用一个 ER 格式为相应的客户、供应商、子公司或任何其他方生成不同语言的传出文档。

您可以将 ER 数据模型和模型映射配置为已配置的 ER 格式的数据源，来定义指定将哪些应用程序数据放入生成的文档的数据流。 作为 ER 配置提供者，您可以发布配置的数据模型、模型映射和格式作为 ER 解决方案的组成部分，来生成特定的传出文档。 您还可以允许客户上载已发布的 ER 解决方案，以便可以使用和定制该解决方案。 如果您希望客户讲其他语言，则可以配置 ER 组件，使其包含语言相关资源。 以此方式，可在设计时以客户的用户首选语言呈现可编辑 ER 组件的内容。

您可以将语言相关资源配置为 ER 标签。 然后，可以使用这些标签来配置 ER 组件以用于以下目的：

• 在设计时：

  • 以用户首选语言呈现已配置的 ER 组件的内容。

• 在运行时：

  • 为传出文档生成语言相关内容。
  • 以用户首选语言提供警告和错误消息。
  • 以用户首选语言提示必填字段。

可以在包含不同组件的每个 ER 配置中配置 ER 标签。 可以独立于 ER 数据模型、ER 模型映射和 ER 格式组件的已配置逻辑来维护标签。

每个 ER 标签由一个 ID 标识，该 ID 在保留该标签的 ER 配置范围内是唯一的。 每个标签可以包含 Microsoft Dynamics 365 Finance 的当前实例中支持的每种语言的标签文本。 这些受支持的语言包括已部署的自定义项的语言。

条目

在设计 ER 数据模型、ER 模型映射或 ER 格式时，每当您选择一个可能包含可翻译上下文的字段时，就会显示翻译选项。 选择此选项时，可以将所选字段链接到文本翻译窗格上的 ER 标签。 您可以选择现有 ER 标签，也可以添加新 ER 标签（如果尚不可用）。 选择或添加 ER 标签时，可以为当前 Finance 实例支持的每种语言添加相关文本。

下图显示了如何在可编辑 ER 数据模型中完成此翻译。 在此示例中，可编辑发票模型的 PurchaseOrder 字段的描述属性被翻译为奥地利德语 (DE-AT) 和日语 (JA) 语言。

只能翻译位于可编辑 ER 组件中的标签的标签文本。 例如，如果为 ER 模型映射数据源的标签属性选择翻译，然后选择位于父 ER 数据模型中的 ER 标签，则会看到标签的内容，但是无法更改。 在这些情况下，已翻译的文本字段不可用，如下图所示。

注释

您无法使用设计器删除已在可编辑 ER 组件中输入的标签。

作用域

ER 标签可以在 ER 组件的几个可翻译属性中引用。

数据模型组件

配置 ER 数据模型时，可以为其添加 ER 标签。 可以将模型项目的标签和描述属性、每个模型的字段以及每个模型枚举值链接到一个已添加到 ER 数据模型中的 ER 标签。

当以这种方式配置 ER 数据模型时，其内容将以每个用户的首选语言呈现给 ER 数据模型设计器的用户。 因此，简化了模型维护。 下图说明了将 DE-AT 和 JA 设置为首选语言的用户如何使用此功能。

模型映射组件

因为 ER 模型映射基于 ER 数据模型，所以所引用的数据模型元素的标签在模型映射设计器中以用户的首选语言显示。 下图显示了如何通过使用已添加到已配置数据模型中的描述属性的标签，在可编辑模型映射中解释 PurchaseOrder 字段的含义。 请注意，此标签以用户的首选语言（在此示例中为 DE-AT）呈现。

当将用户输入参数数据源的标签属性配置为链接到 ER 标签时，与此数据源对应的参数字段将在运行时在用户对话框中以用户首选语言呈现给用户。

格式组件

配置 ER 格式时，可以为其添加 ER 标签。 可以将每个已配置数据源的标签和帮助文本属性链接到添加到 ER 格式的 ER 标签。 每个格式枚举值的标签和描述属性也可以链接到可从可编辑 ER 格式访问的 ER 标签。

注释

您还可以将这些属性链接到父 ER 数据模型的一个 ER 标签，该标签可以重用为此 ER 数据模型配置的每种 ER 格式的模型标签。

当以这种方式配置 ER 格式时，格式的内容将以每个用户的首选语言呈现给 ER 操作设计器的用户。 因此，简化了配置逻辑的格式维护和分析。

因为 ER 格式基于 ER 数据模型，所以将在 ER 格式设计器中以用户首选语言呈现数据模型元素中引用的标签。

当将用户输入参数数据源的标签属性配置为链接到 ER 标签时，在运行时与用户对话框中的参数相对应的字段将作为提示呈现给用户。 下图显示了如何在设计时将用户输入参数数据源的标签属性链接到 ER 标签，以便在运行时以不同的用户首选语言向用户提示参数（为美国英语 (EN-US) 和 DE-AT 语言显示）。

表达式

要在 ER 表达式中使用标签，必须使用语法 @"GER_LABEL:X"，其中前缀 @ 表示操作数引用标签，GER_LABEL 表示引入了 ER 标签，X 是 ER 标签 ID。

要引用系统（应用程序）标签，请使用语法 @"X"，其中前缀 @ 表示操作数引用标签，X 是系统标签 ID。

模型映射

可以使用标签来配置 ER 模型映射的表达式。 当运行来生成传出文档的 ER 格式调用此映射时，执行的上下文将包括语言代码。 配置的表达式标签将使用为该上下文的语言配置的标签文本填充。

如果引用的标签没有对调用模型映射的格式执行上下文的语言的翻译，将改用 EN-US 语言的标签文本。

格式

可以使用标签来配置 ER 格式的 ER 表达式。 当运行此格式来生成传出文档时，执行的上下文将包括语言代码。 配置的表达式标签将使用为该上下文的语言配置的标签文本填充。

您可以配置 ER 格式的文件组件来以用户的首选语言生成报告。

如果以这种方式配置 ER 格式，将使用 ER 标签的相应文本生成报告。 下图显示了 EN-US 和 DE-AT 用户语言的报告示例。

如果引用的标签没有对格式执行上下文的语言的翻译，将改用 EN-US 语言的标签文本。

提示

您可以使用可编辑 ER 格式的文件夹和不同类型的文件组件指定出站文件的生成方式。 要命名生成的文件，请为组件的 File name 参数配置 ER 表达式。 您可以在配置的表达式中使用标签。 由于默认情况下 File name 参数与语言无关，所以您在此表达式中引用的所有标签的文本在运行时都会以默认的 EN-US 语言公开。 但是，在 10.0.28 及更高版本中，您可以启用将“语言首选项”参数应用于“文件名”表达式功能。 然后，文件名表达式在计算时将考虑 Language preferences 参数。

语言

ER 支持多种为生成的报告指定语言的方式。 在格式选项卡上的语言首选项字段中，您可以选择以下值：

• 公司首选项 – 使用公司指定的语言生成报告。

  

• 用户首选项 – 使用用户首选语言生成报告。

• 明确定义 – 使用在设计时指定的语言生成报告。

  

• 运行时定义 – 使用在运行时指定的语言生成报告。 如果选择此值，请在语言字段中配置返回语言的语言代码的 ER 表达式，如相应客户的语言。

  

区域性特定格式

ER 支持多种为生成的报表指定区域性的方式。 因此，正确的区域性特定格式可以用于日期、时间和数字值。 设计 ER 格式时，在格式选项卡上的区域性首选项字段中，可以为常见\文件、Excel\文件、PDF\文件或 PDF\合并器类型的每个格式组件选择以下值之一：

• 用户首选项 – 根据用户的首选区域性确定值的格式。 该区域性在用户选项页首选项选项卡上的日期、时间和数字格式字段中定义。

  

• 明确定义 – 根据设计时指定的区域性确定值的格式。

  

• 运行时定义 – 根据运行时指定的区域性确定值的格式。 如果选择此值，在映射选项卡上的日期、时间和数字格式字段中，配置一个 ER 表达式，以返回该区域性的区域性代码，如相应客户的区域性。

  

注释

您为其定义特定区域性的 ER 组件可能包含配置为填充文本值的子 ER 组件。 默认情况下，父组件的区域性用于确定那些组件的值的格式。 您可以使用以下内置 ER 函数为那些组件配置绑定，并为值格式应用替代区域性：

• DATEFORMAT
• DATETIMEFORMAT
• NUMBERFORMAT

在版本 10.0.20 及更高版本中，常见\文件和 Excel\文件类型的格式组件的区域设置用于在生成文档的 PDF 转换期间确定值的格式。

译文

您可以将所需的 ER 标签添加到可编辑 ER 组件中。 添加 ER 标签后，可以通过两种方式进行翻译：手动和自动。

手动翻译

在文本翻译窗格上添加 ER 标签时，可以将其手动翻译为当前 Finance 实例支持的所有语言。 您可以在系统语言或用户语言部分的语言字段中选择首选语言，并在相应的已翻译的文本字段中输入适当的文本，然后选择翻译。 对于每种必需的语言和添加的每个标签，必须重复此流程。

自动翻译

ER 组件的配置是在可编辑 ER 组件所在的 ER 配置的草稿版本中完成的。

如本文前面所述，您可以将所需的 ER 标签添加到可编辑 ER 组件中。 这样，您可以用 EN-US 语言指定 ER 标签的文本。 然后，您可以使用内置的 ER 函数导出 ER 组件的标签。 选择包含可编辑的 ER 组件的 ER 配置的草稿版本，然后选择交换 > 导出标签。

您可以导出所有标签，也可以导出在导出开始时指定的一种语言的标签。 标签将导出为包含 XML 文件的 zip 文件。 每个 XML 文件包含一种语言的标签。

此格式用于通过外部翻译服务自动翻译标签，如 Dynamics 365 Translation Service。 收到翻译的标签后，可以将它们重新导入到包含拥有这些标签的 ER 组件的 ER 配置的草稿版本中。 选择包含可编辑的 ER 组件的 ER 配置的草稿版本，然后选择交换 > 加载标签。

翻译的标签将导入到所选的 ER 配置中。 此 ER 配置中存在的翻译的标签将被替换。 如果 ER 配置中缺少任何翻译的标签，将追加。

生命周期

可以编辑的 ER 组件的标签以及该组件的其他内容都保存在相应版本的 ER 配置中。

基本 ER 组件的标签可以在您创建以引入修改的 ER 组件的派生版本中引用。

提示

当您设计 ER 解决方案时，您可以从所提供的解决方案派生您自己的 ER 数据模型组件。 在此派生的数据模型中，您可以引入自己的 ER 标签，并以所有将数据模型用作数据源的 ER 格式使用它们。 然后，您可以通过选择派生的 ER 数据模型而不是提供的模型，从提供的组件中派生您自己的 ER 格式组件。 在版本 10.0.28 及更高版本中，您可以启用 增强对升序电子报告数据模型的标签的访问功能，以访问派生 ER 格式组件中的升序 ER 数据模型标签，即使当您为派生的 ER 组件选择的 ER 数据模型不同于基础 ER 组件中所使用的 ER 数据模型时也是如此。

当您的派生组件及其升序组件中使用相同的标签名称时，您对该标签的翻译将用作最相关的标签。

ER 版本控制将控制向 ER 组件中的任何属性的标签分配。 对标签分配的更改将记录在已创建为所提供 ER 组件的派生版本的可编辑 ER 组件的更改列表（增量）中。 将派生版本重定为新的基本版本时，将验证这些更改。

功能

内置的 LISTOFFIELDS ER 函数可以访问为某些 ER 组件项目配置的 ER 标签。

如本文前面所述，每个模型或格式 ER 枚举的值的标签和描述属性，可以链接到可在适当的 ER 组件中访问的 ER 标签。 您可以使用 ER 枚举作为参数来配置调用 LISTOFFIELDS函数的 ER 表达式。 此表达式将返回一个列表，其中包含已定义为此函数的参数的 ER 枚举的每个值的记录。 每个记录均包含链接到 ER 枚举值的 ER 标签的值：

• 链接到标签属性的 ER 标签的值存储在返回记录的标签字段中。
• 链接到描述属性的 ER 标签的值存储在返回记录的描述字段中。

性能

当您配置 ER 格式组件，以便生成首选语言的报表或导入其中的内容使用首选语言解析的传入文档时，我们建议您在功能管理工作区中启用为 ER 运行高速缓存当前用户的首选语言功能。 此功能有助于改进性能，尤其是对于其中包含对 ER 公式和绑定的多个引用以及用于使用您的首选语言生成用户消息的大量验证规则的 ER 格式组件。

当您将 ER 配置版本的状态从草稿更改为已完成时，如果配置版本包含 ER 标签，这些标签将存储在应用程序数据库中。 存储架构取决于加速 ER 标签存储功能的状态：

• 如果未启用此功能，所有标签都将作为单个 XML 片段存储在 ERSOLUTIONVERSIONTABLE 表的 LABELXML 字段中。
• 如果已启用此功能，将为 ERSOLUTIONVERSIONLABELSTABLE 表中的每种语言创建单独的记录。 此表的内容字段作为压缩的 XML 片段存储每种语言的标签。

我们建议您在功能管理工作区启用加速 ER 标签存储功能。 此功能有助于提高网络带宽利用率和整体系统性能，因为在大多数情况下，当您使用单个 ER 配置时，会使用单个语言的 ER 标签。

要应用所选存储架构以保留当前 Finance 实例中所有 ER 配置的标签，请完成以下步骤。

1. 转到组织管理>定期>为所有 ER 配置应用选定的标签存储架构。
2. 选择确定。

其他资源

• 电子申报概览
• 电子报告功能