配置表单以接收自定义查询字符串参数

使用自定义查询字符串参数,可以将预期值传递到模型驱动应用窗体,同时验证参数名称和数据类型。 本文介绍如何配置允许的参数,以便在创建记录时安全地设置默认值。

默认情况下,模型驱动应用允许将一组指定的查询字符串参数传递给表单。 在应用程序中创建新记录时,使用这些参数设置默认值。 每个参数都必须使用包含对列逻辑名称的引用的标准命名约定。 有关详细信息,请参阅 使用传递给窗体的参数设置列值。

在应用程序中,你可能希望将自定义查询字符串参数传递给窗体。 本文提供有关如何定义一组可接受特定表单的特定参数名称和数据类型的信息。

定义允许的查询字符串参数

有两种方法可以指定表单将接受的查询字符串参数:

  • 使用经典编辑器编辑窗体属性
  • 编辑表单 XML

编辑表单属性

使用新式窗体编辑器编辑窗体时,如 打开模型驱动应用窗体编辑器中所述,选择菜单中的省略号,然后选择 “切换到经典”。

  1. 在“ 开始 ”选项卡上的 “窗体 ”组中,选择“ 窗体属性”。

    经典窗体编辑器“开始”选项卡上的“窗体属性”按钮的屏幕截图。

  2. 在“ 窗体属性 ”对话框中,选择“ 参数 ”选项卡。

    “窗体属性”对话框中“参数”选项卡的屏幕截图。

    使用此选项卡可修改窗体允许的名称和数据类型。

了解有关以下方面的详细信息:

编辑 FormXml

在导出的解决方案 customizations.xml 文件中,紧跟在页脚元素之后,可以添加元素 <formparameters> 。 在元素中 <formparameters> ,添加 <querystringparameter> 元素以指定允许的参数。

下表描述了 querystringparameter 元素参数, name 以及 type:

name

每个名称列必须至少包含一个下划线 (_) 字符,但查询字符串参数的名称不能以下划线开头。 名称也不能以 crm_ 开头。 使用解决方案发布者的自定义前缀作为命名约定。 请勿将 querystringparameter 的名称与表中的列名设置为相同。 有效的 querystringparameter 名称值为 myISV_contact_specialvalue.

重要

如果元素名称不唯一 querystringparameter ,则使用其他数据类型的另一个参数定义可能会覆盖它。

Type

将数据类型值与参数值匹配,以便参数不会传递无效数据。 以下数据类型有效:

  • Boolean
  • DateTime
  • Double
  • EntityType
  • Integer
  • Long
  • PositiveInteger (在有效值范围内包括“0” )
  • SafeString
  • UniqueId
  • UnsignedInt

另见

使用传递给窗体的参数设置列值
使用 URL 打开窗体和视图
经典表单编辑器概述
模型驱动应用表单属性