CRM 頁面 (託管控制項)

 

發行︰ 2016年11月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

使用 [CRM 頁面] 託管控制項型別，從 Dynamics 365 載入 URL 或頁面。Dynamics 365 頁面載入到這個型別的託管控制項內時，它將自動在頁面上掃描實體的資料，並自動填入取代參數。

這個託管控制項型別會公開一些對處理 Dynamics 365 視窗是唯一、預先定義的 UII 動作和事件，包括清單操作動作，以及顯示快速搜尋或進階搜尋頁面的尋找動作。

本主題內容

建立 CRM 頁面託管控制項

預先定義的 UII 動作

預先定義的事件

建立 CRM 頁面託管控制項

建立新的託管控制項時，[新增託管控制項] 畫面的欄位會根據您想要建立的託管控制項型別而不同。 本節提供 CRM 頁面託管控制項型別專屬特定欄位的資訊。 如需有關建立託管控制項的詳細資訊，請參閱建立或編輯託管控制項。

在 [新增託管控制項] 畫面：

• 在 [Unified Service Desk] 區域中，從 [USD 元件類型] 下拉式清單選取 [CRM 頁面]。

• 從 [允許多個頁面] 下拉式清單徵選取 [否] (預設)，會取代目前顯示的 Dynamics 365 頁面，並且在 Unified Service Desk 收到瀏覽動作呼叫或頁面路由傳送至索引標籤時，更新瀏覽器歷程記錄。 選取 [是] 以便在呼叫第二個 URL 或視窗導覽規則將頁面導向至索引標籤時，自動建立下拉式清單。 這會讓使用者在附加到此控制項的 Dynamics 365 頁面之間快速搜尋。 同樣地，當您選取 [是]，就會出現一個可用的額外欄位 [瀏覽器上限]，您可在此指定下拉式清單中顯示的頁面數目上限。

• [代管類型] 下拉式清單可讓您指定要託管這個控制項的方式。 您可以選擇 [IE 處理序] (預設值) 或 [內部 WPF]。 如需詳細資訊，請參閱選取控制項的代管方法。

• 在 [通用屬性] 區域中，選取 [應用程式是全域的] 核取方塊，將託管控制項設定為全域。 全域託管控制項可以顯示在客戶工作階段以外。 例如客服專員的儀表板、留言板或搜尋等控制項，是全域託管控制項的常見用法。 全域工作階段並沒有工作階段特定的狀態，因此當您變更工作階段時，這些相同的全域託管仍會保留。 如果未選取此核取方塊，託管控制項就會成為工作階段型。 工作階段型控制項存在於客戶工作階段的內容。 如果使用者變更為另一個工作階段，從先前工作階段的所有工作階段頁面都會隱藏。

• [顯示群組] 欄位會顯示此託管控制項將顯示的面板。MainPanel 最常用於此託管控制項型別。 如需有關Unified Service Desk中不同面板的資訊，請參閱Unified Service Desk 的面板、面板型別及面板配置。

如需其他 [一般] 欄位的一般資訊，請參閱建立或編輯託管控制項。

預先定義的 UII 動作

下列預先定義的動作適用於這個託管控制項型別。

AssociatedView

此動作載入 Dynamics 365 特定相關檢視表。 通常是在導覽列上，按一下實體記錄名稱旁的向下箭號，然後選取相關實體，存取這些檢視表。

參數	描述
navItemName	想要顯示的相關實體。 範例：案例
識別碼	顯示相關實體記錄的主要實體記錄的識別碼。
tabset	Dynamics 365 的區域。 範例：areaSales 或 areaService。

如需關於這個動作的詳細資訊，請參閱逐步解說 7：在客服專員應用程式中設定客服專員底稿中的步驟 5。

關閉

這個動作用來關閉託管控制項。 不同於 CloseActive 動作，如果此索引標籤 (託管控制項) 顯示多個頁面，它會關閉在您的客服專員應用程式索引標籤上顯示的所有頁面。

CloseActive

這個動作用來關閉此託管控制項中的使用中視窗。 如果使用中視窗是託管控制項中唯一顯示的視窗，將會關閉託管控制項本身。 如果是不允許多個頁面 (允許多個頁面 = 否) 的 CRM 頁面類型的託管控制項，這個動作相當於 Close 動作。

CloseAndPrompt

這個動作會託管控制項，但在關閉之前提示使用者儲存或放棄變更。

DisableToolbarButton

此動作停用在客服專員應用程式工具列上的指定工具列按鈕。

參數	描述
	停用的工具列按鈕的名稱。

EnableToolbarButton

此動作啟用在客服專員應用程式工具列上的指定工具列按鈕。

參數	描述
	啟用的工具列按鈕的名稱。

尋找

巡覽至指定之實體的快速尋找清單檢視。

參數	描述
	資料參數應該指定要顯示之快速尋找清單檢視的實體邏輯名稱。 有一些特殊案例值： 使用 case 或 incident 顯示案例的快速尋找清單檢視表。 使用 advfind 顯示進階尋找檢視表。 使用 activities 或 activity 顯示活動的快速尋找清單檢視表。

FireEvent

從此託管控制項引發使用者定義的事件。

參數	描述
名稱	使用者定義事件的名稱。

所有後續 name=value 組會變成事件參數。 如需建立使用者定義事件的詳細資訊，請參閱建立使用者定義的事件。

GetSelectedIds

這個動作用來從清單中擷取選取的識別碼。

參數	描述
	資料參數應指定要擷取所選取識別碼的清單名稱。

傳回值包含以分號分隔的識別碼清單，包含選取的項目。

GetSelectedCount

這個動作擷取已選取的項目數。 使用 GetSelectedIds 動作，為實體取得實際的識別碼清單。

參數	描述
	資料參數應指定要擷取所選取識別碼的清單名稱。

傳回值包含數字，代表選取的項目數量。

GoHome

這個動作會移至指定給此瀏覽器執行個體的初始 URL。

GoBack

這個動作就相當於在瀏覽器執行個體上按一下 [上一頁] 按鈕。

GoForward

這個動作就相當於在瀏覽器執行個體上按一下 [下一頁] 按鈕。

LoadArea

此動作會從 Dynamics 365 載入特定區域。 這相當於在導覽窗格中選取區域 (例如 [銷售]、[服務] 和 [行銷])。 唯一參數是按一下的區域名稱。 例如：areaService。

參數	描述
框架	作用的框架名稱。 如果未指定名稱，便會自動以頁面中的第一個找到的框架做為目標。

LookupInfo

顯示 Dynamics 365 查閱資訊對話方塊，讓您從清單中選取實體。

參數	描述
AllowFilterOff	“0”，“1”表示允許使用者關閉篩選
DefaultType	預設顯示的邏輯名稱。 這應該是 objecttypes 參數中指定的其中一個數值。
DefaultViewId	“0”，“1”表示顯示預設檢視
DisableQuickFind	“0”，“1”表示顯示快速尋找欄位
DisableViewPicker	“0”，“1”表示顯示檢視選取器
LookupStyle	Single 或 Multiple
ShowNewButton	“0”，“1”表示顯示 [新增] 按鈕
ShowPropButton	“0”，“1”表示顯示 [屬性] 按鈕
瀏覽	“0”，“1”表示使用瀏覽模式。 下列是這個參數設定為“1”。
Currentid	目前值的 Guid
objecttypes	要顯示的物件型別的清單。 這些是 Dynamics 365 的 etc 類型。 範例：“1,2”來顯示客戶及連絡人。

MoveToPanel

此動作會在執行階段將 CRM 頁面託管控制項移至不同的面板。

參數	描述
	資料參數應該指定要將託管控制項移至其中的目標面板名稱。 例如：FloatingPanel。

巡覽

這個動作用來瀏覽至 Dynamics 365 URL。

參數	描述
URL	瀏覽至的 URL。 這是必要參數。
Noscan	如果提供這個參數且設為 True，不會從頁面擷取資料參數。
HideCommandBar	如果提供這個參數且設為 True，則會改為顯示內部框架，而不會載入 Dynamics 365 命令列。
HideNavigationBar	如果提供這個參數且設為 True，則會改為顯示表單，而不會載入 Dynamics 365 導覽列。
框架	當在網頁有框架時，這個參數會指定要瀏覽的框架的名稱，而不是瀏覽主視窗。
postdata	隨 HTTPPOST 交易一併傳送至伺服器的資料。POST 交易通常用於傳送 HTML 頁面收集的資料。 在 Unified Service Desk，可從使用 "http://event/?" 觸發的所有事件接收此資料。 範例：[[postdata]+] 或者，資料可當做編碼字串與其標頭類型 (預定格式) 傳送。
標頭	字串值，包含要傳送至伺服器的其他 HTTP 標頭。 當 postdata 參數用於 Navigate 動作時，您也應該指定 header 參數的適當值。 範例：Content-Type:application/x-www-form-urlencoded 如果 Unified Service DeskPOST 事件觸發 Navigate 動作，此參數的預設值必須是 header=[[header]+]

New_CRM_Page

建立頁面，用來建立指定之實體的新 Dynamics 365 記錄，並將此頁面視為來自指定的託管控制項的快顯畫面。 視窗導覽規則會進行評估，決定建立實體記錄的頁面顯示的位置。

參數	描述
LogicalName	要建立新執行個體的實體邏輯名稱。

注意

其餘的參數應該包含名稱=值組。 這些是在建立指定之實體的新記錄的表單中其他預先填入的值。 如需關於這個動作的詳細資訊，請參閱逐步解說 7：在客服專員應用程式中設定客服專員底稿中的步驟 4。

Open_CRM_Page

開啟由 ID 所識別之指定實體的現有執行個體，並將此頁面視為來自指定的託管控制項的快顯畫面。 會評估視窗導覽規則，以判斷應該顯示快顯畫面的位置。

參數	描述
LogicalName	要開啟之實體的邏輯名稱。
id	要開啟之實體記錄的 ID。

快顯

從託管控制項快顯 URL，並對它執行視窗導覽規則，將此快顯路由到適當位置。

參數	描述
URL	使用這個 URL 從此託管控制項路由傳送快顯，就好像是從顯示的控制項要求快顯一樣。
框架	此快顯的起始框架。

RealignWindow

將託管控制項顯示於螢幕上的指定位置。 您最多可以在兩個螢幕上顯示託管控制項。 這個動作適用於以下託管控制項執行個體：已設定為要置於 USDFloatingPanel 或 USDFloatingToolPanel 面板類型上的執行個體。

參數	描述
screen	指定要顯示託管控制項的螢幕。 有效值為 1 或 2。 如果不指定此參數，預設會傳遞 1。
left	指定在應該顯示託管控制項的目標螢幕上，與螢幕左側相距的位置 (以百分比為單位)。 有效值從 0 到 100。 如果不指定此參數，預設會傳遞 0。
top	指定在應該顯示託管控制項的目標螢幕上，與螢幕頂端相距的位置 (以百分比為單位)。 有效值從 0 到 100。 如果不指定此參數，預設會傳遞 0。
width	指定託管控制項視窗在目標螢幕上的寬度 (以百分比為單位)。 有效值從 1 到 100。 如果不指定此參數，預設會傳遞 100。
height	指定託管控制項視窗在目標螢幕上的高度 (以百分比為單位)。 有效值從 1 到 100。 如果不指定此參數，預設會傳遞 100。

重新整理​​

這個動作會重新整理目前的頁面。

ReRoute

這個動作會取得目前顯示的 URL，並將其透過視窗導覽規則從目前的託管控制項當做為快顯畫面傳送。

RunScript

這個動作會將 JavaScript 插入應用程式的主框架。 您應該避免同時使用此動作與 Dynamics 365 用戶端 SDK 呼叫，請改用 RunXrmCommand 動作。

參數	描述
	資料參數是將插入表單的 JavaScript。 注意 取代參數可以用於指令碼中，而且在執行指令碼之前會被取代。

RunXrmCommand

這個動作用來將 Dynamics 365 SDK JavaScript 插入到 Dynamics 365 表單。

參數	描述
	資料參數是將插入表單的 JavaScript。 注意 取代參數可以用於指令碼中，而且在執行指令碼之前會被取代。

SetSize

這個動作會明確地設定託管控制項的高度與寬度。 在您的面板配置中使用 "auto" 時，這會特別有用。

參數	描述
width	託管控制項的寬度。
height	託管控制項的高度。

SaveAndClose

這個動作會將已變更的資料儲存在 Dynamics 365 表單上，並關閉託管控制項。

SaveAll

這個動作會在允許顯示多個頁面 (允許多個頁面 = 是) 的託管控制項上儲存所有表單。 如果託管控制項只允許顯示單一頁面 (允許多個頁面 = 否)，這相當於 Save 動作。

儲存

這個動作會儲存目前的 CRM 頁面。

ToggleRibbon

這個動作會摺疊或展開功能區。 如果您隱藏 Navigate 動作中的功能區，將不會顯示功能區，而且此動作無法運作。 只當功能區一開始已載入時，這個動作才能正常運作。

ToggleNavigation

這個動作會摺疊或展開 Dynamics 365 視窗左方面板上的導覽窗格。 巡覽必須包含導覽面板，這個動作才能正常運作。

預先定義的事件

下列預先定義事件與此託管控制項類型相關聯的。

ActiveClosed

當使用中託管控制項透過 CloseActive 動作關閉時發生。

參數	描述
URL	關閉時，在託管控制項中顯示的 URL。

BrowserDocumentComplete

當網頁完成載入時發生。 在 CRM 頁面類型的託管控制項，當資料已儲存到取代參數清單後會發生此事件。 此事件只發生一次，即使多個框架會分別引發其 BrowserDocumentComplete 事件。

參數	描述
URL	已完成載入之頁面的 URL。

PageLoadComplete

在完成載入框架的任何時間發生。 在頁面上使用 iFrame 或框架時，於每頁載入時此事件可以發生多次。 這個事件對應至程式碼中個別的 BrowserDocumentComplete 事件。

參數	描述
框架	完成載入之框架的名稱 (如果有)。
URL	完成載入之框架的 URL。

PopupRouted

系統已經路由傳送快顯畫面之後發生。

參數	描述
URL	已路由傳送的快顯的 URL。

RefreshRequested

在目前頁面上要求重新整理時發生。 可以按 F5 鍵或由應用程式呼叫重新整理動作，來要求重新整理。

參數	描述
URL	要求重新整理時顯示的 URL。

Saved

在 Dynamics 365 頁面中儲存記錄之後發生。

參數	描述
newId	指派給新建立的記錄的識別碼。

另請參閱

CRM 對話方塊 (託管控制項)
UII 動作
活動
逐步解說 3：在客服專員應用程式中顯示 Microsoft Dynamics 365 記錄
託管控制項型別和動作/事件參考
Microsoft Dynamics CRM Unified Service Desk 管理指南

Unified Service Desk 2.0

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