使用用户输入参数数据源指定报表的参数
当您设计电子报告 (ER) 模型映射和 ER 格式组件时，您可以使用用户输入参数类型的数据源，以获取可在运行时在对话框数据输入字段中指定的必需值，然后开始执行 ER 格式。 本文介绍了当前支持的用户输入参数数据源。
必需属性
必须为每个用户输入参数类型的数据源指定以下属性：
- 在名称字段中，输入数据源的内部名称。 您可以在配置的模型映射或格式组件的其他表达式和绑定中使用此名称。
可选属性
（可选）可以为用户输入参数类型的数据源指定以下属性：
在标签字段中，指定运行时用于对话框中相关数据输入字段的标签。 您可以通过激活标签字段，然后选择翻译，为不同的语言代码添加不同的标签文本。
在帮助字段中，如果选择了用户输入参数类型的可编辑数据源，则指定设计时在格式设计器页面或模型映射设计器页面底部显示的帮助文本。 此文本可能会提供有关数据源的其他详细信息，以帮助用户配置可编辑格式或模型映射组件。 您可以通过选择翻译为不同的语言代码添加不同的帮助文本。
注释
翻译按钮可用于添加特定于语言的标签和文本，只有在添加数据源、保存更改 ，然后重新打开要编辑的数据源后才可使用此按钮。
在只读字段中，配置一个返回布尔值的表达式。
- 如果配置的表达式在运行时返回 True 值，则相关数据输入字段在对话框中显示为灰色，并且您无法更改其值。
- 如果配置的表达式在运行时返回 False 值，或者未配置表达式，则相关数据输入字段在对话框中可用，并且您无法更改其值。
在默认值字段中，配置返回所引用参数类型的值的表达式。 此值可用于在运行时填写对话框中的相关数据输入字段的默认值。
当您运行 ER 格式时，运行时在对话框的相关数据输入字段中输入的值将作为先前使用的值保存在内存中。 分别为每个字段、运行的 ER 格式、当前用户和当前组织（公司）保存了以前使用的值。
- 如果默认值表达式返回的值应始终用作默认值，那么无论以前使用的值如何，请将始终重置为默认值选项设置为是。
- 如果仅在缺少以前使用的值时才应将默认值表达式值返回的值用作默认值，请将始终重置为默认值选项设置为是。
注释
如果将始终重置为默认值选项设置为是，则必须在默认值字段中配置表达式。
如果将允许多选选项设置为是，则可以在运行时为配置的参数选择多个值。 如果将其设置为否，则只能选择一个值。
注释
此选项不适用于所有用户输入参数类型。 在设计时，会引发异常以通知用户配置的用户输入参数不支持多选，并且只能选择或输入一个值。
如果将允许多选选项设置为是，并且您在默认值字段中指定了一个表达式，则该表达式只能用于设置一个默认值。
选择编辑可见性选项以指定是否应在运行时将配置的参数显示在对话框中。
注释
用户输入参数类型的数据源的默认可见性取决于保存它们的 ER 组件。
- 如果在格式组件中配置了数据源，则默认情况下该数据源可见。
- 如果在模型映射组件中配置了数据源，则仅当运行 ER 组件时数据源的值影响结果的情况下，此数据源才可见。 例如，您添加了一个数据源，但没有在当前模型映射组件的表达式和绑定中使用它。 在这种情况下，运行时相关数据输入字段默认不会显示在对话框中。
在公式设计器页面上的公式字段中，配置一个返回布尔值的表达式。
- 如果配置的表达式在运行时返回 True 值，或者未配置表达式，则运行时相关数据输入字段在对话框中可见。
- 如果配置的表达式返回 False 值，则运行时对话框中将隐藏相关数据输入字段。 当它在运行时被其他表达式调用时，它会根据其他设置返回默认值、先前使用的值或当前数据类型值的默认值。
特定于类型的属性
应用相关的用户输入参数
使用常规>用户输入参数类型的数据源，以获取为 Microsoft Dynamics 365 Finance 应用程序的当前实例指定的数据类型的一个或多个必需值。 当您将此类型的数据源添加到 ER 组件时，请指定以下属性：
- 在 Operations 数据类型名称(EDT，枚举) 字段中，选择应用程序扩展数据类型 (EDT) 或应用程序枚举。
注释
建议您查看在此用户输入参数类型的可编辑数据源中更改 Operations 数据类型名称(EDT，枚举)引用时在只读和默认值字段中配置的表达式。
下图显示了在 Instat XML (DE) ER 格式配置中配置的 $TaxRegNum 数据源的属性。 此数据源配置为使用说明 EDT 在运行时在对话框中提供税务登记编号数据输入字段。
下图显示了运行 Instat XML (DE) ER 格式配置以生成内部统计声明时，在运行时显示的对话框。 请注意，已配置的税务登记编号字段可用于数据输入。
数据模型枚举用户输入参数
使用数据模型>枚举用户输入参数类型的数据源，以获取单个数据模型枚举所需的一个或多个值。 当您将此类型的数据源添加到 ER 组件时，请指定以下属性：
在模型字段中，指定对基础数据模型的引用。
在模型枚举字段中，指定对引用的数据模型枚举的引用。
在版本字段中，选择包含引用模型枚举的 ER 数据模型组件的修订编号。
提示
在设计时，您可以将版本字段留空，以访问位于相应 ER 数据模型配置草稿版本中的引用数据模型组件的枚举列表。 这样，您可以同时编辑模型映射或格式组件的草稿版本，以及基础数据模型组件的草稿版本。
但是，请注意，版本字段只能在模型映射或格式组件的草稿版本中留空。 当您将 ER 模型映射或格式配置的状态从草稿更改为已完成时，此字段将自动填写当前 Finance 实例中可用的最高模型修订编号。 如果您在基础数据模型的草稿版本中引入新枚举或新枚举值，并在可编辑模型映射或格式组件中引用它，请在您的 ER 模型映射或格式配置的草稿版本完成之前，完成基础数据模型配置的草稿版本。 否则，当您将模型映射或格式配置的状态从草稿更改为已完成时，将引发“找不到路径”异常。 该消息将通知您基本数据模型中缺少引用的枚举或枚举值。
下图显示了在 Instat XML (DE) Contoso ER 格式配置中配置的 $ReportDirection 数据源的属性。 已从 Instat XML (DE) 配置中派生Instat XML (DE) Contoso 配置。 此数据源配置为使用 ReportDirection 模型枚举在运行时在对话框中提供适当的查找字段。
格式枚举用户输入参数
使用格式枚举>枚举用户输入参数类型的数据源，以获取单个格式枚举所需的一个或多个值。 当您将此类型的数据源添加到 ER 组件时，请指定以下属性：
- 在格式枚举字段中，指定可编辑格式的枚举。
注释
这种类型的数据源只能在可编辑格式组件的范围内进行配置。