共用方式為

設定表單以接受自訂查詢字串參數

  • 發行項

 

發行︰ 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：

  • name。 每個名稱屬性都必須包含至少一個底線 ('_') 字元，但是查詢字串參數的名稱開頭不可為底線。 名稱開頭也不可以是 "crm_"。 強烈建議您使用解決方案發行者的自訂首碼做為命名慣例。 有效的 querystringparameter 名稱屬性值為 "myISV_contact_specialvalue"。

    重要

    如果 querystringparameter 項目名稱不是唯一的，則可能被另一個使用不同資料類型的參數定義覆寫。

  • 類型。 資料類型值必須與參數值相符，無效的資料才不會隨著參數傳遞。 以下是有效的資料類型：

    • Boolean

    • DateTime

    • Double

    • EntityType

    • Integer

    • Long

    • PositiveInteger

      注意

      PositiveInteger 的有效值範圍中包含 "0"。

    • SafeString

    • UniqueId

    • UnsignedInt

另請參閱

使用傳遞至表單的參數設定欄位值
使用 URL 開啟表單、檢視表、對話方塊和報表

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權