配置窗体以接受自定义查询字符串参数

  • 项目

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

通过使用查询字符串将值传递到网页这一功能体现了对安全性的关注。Microsoft Dynamics 365 采用了始终将作为查询字符串传递的所有参数与预期参数名和数据类型列表进行比较这一最佳实践。

默认情况下，Microsoft Dynamics 365 允许向窗体传递指定的查询字符串参数集。 在应用程序中创建新记录时，可以使用这些参数来设置默认值。 每个参数都必须使用包括对属性逻辑名称的引用的标准命名约定。 有关详细信息，请参阅使用传递给窗体的参数设置字段值。

在应用程序中，您可能要向实体窗体传递自定义查询字符串参数。 本主题提供有关如何定义特定实体窗体可以接受的一组特定参数名和数据类型的信息。

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

可通过以下两种方式来指定窗体将接受哪些查询字符串参数：

  • 编辑窗体属性

  • 编辑窗体 XML

编辑窗体属性

在编辑实体窗体时，在“主页”选项卡上的“窗体”组中，单击“窗体属性”。 在“窗体属性”对话框中，选择“参数”选项卡。

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

编辑 FormXml

在导出的解决方案 customizations.xml 文件中，可以紧跟在页脚元素的后面添加一个 <formparameters> (FormXml) 元素。 在 <formparameters> 元素中，添加 <querystringparameter> (FormXml) 元素，以指定将允许哪些参数。

下面介绍了 querystringparameter 元素属性 name 和 type：

  • 名称。 每个名称属性必须至少包含一个下划线（“_”）字符，但查询字符串参数的名称不能以下划线开头。 该名称也不能以“crm_”开头。 强烈建议您使用解决方案发布商的自定义前缀作为命名约定。 有效的 querystringparameter 名称属性值为“myISV_contact_specialvalue”。

    重要

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

  • 类型。 将数据类型值与参数值匹配，这样就不会通过参数传递无效数据。 下面是有效的数据类型：

    • Boolean

    • DateTime

    • Double

    • EntityType

    • Integer

    • Long

    • PositiveInteger

      备注

      PositiveInteger 的有效值范围中包括“0”。

    • SafeString

    • UniqueId

    • UnsignedInt

另请参阅

使用传递给窗体的参数设置字段值
使用 URL 打开窗体、视图、对话框和报表

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权