使用功能區傳遞參數至 URL
發行︰ 2017年1月
適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
工作區動作定義於 <CommandDefinition> (RibbonDiffXml) 元素的 <Actions> (RibbonDiffXml) 元素中。 有數種方法可以透過使用功能區來傳送關聯的 Microsoft Dynamics 365 資訊做為查詢字串參數，並送至一個 URL 中。
使用 <Url> (RibbonDiffXml) 元素。 在 Url 元素中，請使用 PassParams 屬性。
使用 <CrmParameter> (RibbonDiffXml) 元素同時搭配 <Url> (RibbonDiffXml) 元素。 使用來自 Url 的元素，必須設定名稱屬性值。
使用 <CrmParameter> (RibbonDiffXml) 元素同時搭配 <JavaScriptFunction> (RibbonDiffXml) 元素。
使用 PassParams 屬性設定動態值
傳遞參數至目標 URL 使用 PassParams 屬性資訊提供關於相關紀錄或使用者的內容資料給目標應用程式。 如果功能區控制項使用 PassParams 來設定參數，即可傳遞所有參數。 下表列出傳出的參數。
參數 |
名稱 |
描述 |
|---|---|---|
typename |
實體名稱 |
實體的名稱。 針對自訂實體，包括自訂首碼，例如 new_entityname。 |
type |
實體類型代碼 |
整數可唯一識別目前組織的實體。 注意 Entity Type Code 值是由實體在組織中建立的順序所決定。 通常不同組織中自訂實體的Entity Type Codes也會不同。 |
id |
物件 GUID |
代表記錄的全域唯一識別碼 (GUID)。 |
orgname |
組織名稱 |
組織的唯一名稱。 |
userlcid |
使用者語言碼 |
目前使用者使用的語言識別代碼。 |
orglcid |
組織語言碼 |
語言識別代碼，代表組織的基礎語言。 |
語言碼是四位數或五位數的地區設定識別碼。 您可以在地區設定識別碼 (LCID) 表找到有效的地區設定識別碼值。
注意
建議您使用實體名稱而不是類型代碼，因為 Microsoft Dynamics 365 安裝之間實體的實體類型代碼可能不同。
範例
下列範例顯示不使用參數的 URL：
http://myserver/mypage.aspx
以下範例顯示當功能區控制項為帳戶實體呈現時包含的參數，針對一個名為「AdventureWorksCycle」的組織，當使用者的語言設定和組織機主語言為英文時，帳戶紀錄的 GUID 為 DBD5DBFB-0666-DC11-A5D9-0003FF9CE217：
http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D
在 URL 使用 Querystring 參數
您可以在 URL 屬性中包括一個 querystring 參數。 如果您試圖使用 使用 URL 開啟表單、檢視表、對話方塊和報表 開啟特定 Microsoft Dynamics 365 記錄或檢視，這會非常有用。
注意
如果 URL 包含用來分隔 URL 中的多個 querystring 參數的「&」符號與字元，您將無法匯入功能區。 此字元會讓 XML 無效。 您必須用「&」在 URL 屬性值中逸出此符號字元。
正在讀取傳遞的參數
傳遞的參數通常會在目標 .aspx 頁面中讀取，使用的是 HttpRequest.QueryString 屬性。其他資訊：HttpRequest.QueryString 屬性
注意
若 URL 目標是 Web 資源，將只能收到在主題 將參數傳遞至 HTML Web 資源 識別的參數。 唯一用來傳遞自訂值的機會為將這些項目納入 data 參數中。 如要在單一參數中包括多個值，則需要一些特殊處理。其他資訊：範例：透過資料參數傳遞多個值到一個 Web 資源中
另請參閱
自訂命令和功能區
使用 URL 開啟表單、檢視表、對話方塊和報表
<Url> (RibbonDiffXml)
定義功能區索引標籤顯示規則
範例：匯出功能區定義
Microsoft Dynamics 365
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權