共用方式為

取代參數

  • 發行項

 

發行︰ 2016年11月

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

取代參數可用於整個應用程式，從應用程式執行期間所擷取、擴充且包括Unified Service Desk內容的資料元素 (稱為資料參數) 提取資料。 內容是由名稱/值字串組所組成，會隨著使用應用程式時透過不同的方法發現資料而經常變更。 取代參數適用於各種不同的工作，例如指定 URL 查詢字串、產生 scriptlet 中的指令碼輸出、指定實體搜尋的搜尋值、電腦電話整合 (CTI)，以及為其他託管控制項上呼叫的動作指定輸入。 取代參數是關鍵的元素，在Unified Service Desk中啟用高度設定或自訂，而不需使用程式碼。

如需如何使用取代參數來設定客服專員應用程式的資訊，請參閱使用取代參數來設定 Unified Service Desk。

注意

有時候取代參數可與資料參數交替使用，因為取代參數基本上是資料參數的表示。

本主題內容

在 Unified Service Desk 中檢視取代參數

系統取代參數

在 Unified Service Desk 中檢視取代參數

在用戶端應用程式的偵錯工具控制項可用來在任何時間檢視可用的取代參數清單。

  1. 啟動Unified Service Desk用戶端，並登入已安裝範例套件的 Microsoft Dynamics 365。

  2. 在Unified Service Desk用戶端的主畫面，按一下右上角齒輪旁邊的向下箭號，然後選取 [偵錯]。 偵錯工具隨即出現。

    開啟偵錯工具的偵錯選項

  3. 在偵錯工具中，按一下 [資料參數] 檢視取代參數。

    [資料參數] 索引標籤上的取代參數

樹狀檢視用來表示可使用的變數。 當指定變數時，指定根層級名稱，後面接著句點 (.)，然後是清單中的名稱。 以下列出一些範例：

  • [[$Session.IsGlobal]]

  • [[$User.fullname]]

這些值會隨著使用者在Unified Service Desk用戶端中互動而變更。 動作呼叫會挑選目前值，並在其參數清單中或在其他可使用的任何位置使用它。 當變數在任何時間更新時，基底控制項中會引發 NotifyContextChange 事件，即使Unified Service Desk內容本身沒有變更。 這可讓功能 (例如工作階段行) 重新檢查取代參數的值，以查看它是否需要更新其顯示。

系統取代參數

系統取代參數是由系統所定義及填入的取代參數，而且名稱開頭為 $，以便與使用者定義的取代參數保持區隔。 例如：$Global。Unified Service Desk 有下列取代參數：

  • $Context

  • $Debug

  • $Global

  • $Panel

  • $Resources

  • $Return

  • $Session

  • $Settings

  • $Subject

  • $SystemParameters

  • $User

$Context

本節包含 User Interface Integration (UII) 工作階段內容的內容，並提供方便方式在 Unified Service Desk 應用程式中使用 UII 工作階段變數。

注意

全域管理員託管控制項提供可讓您從其他取代參數複製值到內容的動作。 當轉接電話或儲存工作階段供稍後解除凍結時，這可能很有用。 在這些情況下，內容可以使用標準 UII 機制來儲存至伺服器。

$Debug

這是只有在 Scriptlet 中使用的特殊取代值，用來決定偵錯視窗是否呼叫它。 特別是當 scriptlet 造成系統上執行的動作，我們會測試這個參數，來判斷是否應該略過程式碼區塊，以避免偵錯時的副作用。 下列的 scriptlet 會啟動 Account 託管控制項，並在偵錯視窗開啟時顯示索引標籤。

CRMGlobalManager.GetApp(“Account”);

這是因為指令碼都是在目前內容中執行，以決定在目前系統狀態中它們的值。 若要避免這個副作用發生，請執行下列程式碼。

If ([[$Debug]]!= true) CRMGlobalManager.GetApp(“Account”);

這會避免副作用，並仍然對偵錯工具提供有用的資訊。

$Global

此區段會自動加入，以顯示在 Dynamics 365 選項中設定的所有選項和它們的值。 這讓選項更容易存取，可用於控制執行，或控制工作流程或動作呼叫中所建立的行為。 所有的稽核旗標會自動顯示在此區段。

$Panel

$Panel 取代參數包含所有託管控制項以及其表示為索引鍵/值組的目前面板名稱，這些名稱已在您上次啟動 Unified Service Desk 用戶端後移至其他面板。 只有當至少一個託管控制項在您上次啟動 Unified Service Desk 用戶端後變更了面板時，才可以使用取代參數。 所有其他託管控制項及其目前已載入於 Agent Desktop 的現有面板都無法在取代參數中使用。

$Resources

全域管理員會使用語言識別碼填入這個取代參數的集合。 在全域管理員託管控制項的設定中，您可以指定不同的語言資源。 這些資源採用 .resx 檔案形式，但會上載至 web 資源做為 XML 檔案。 在應用程式載入時，Unified Service Desk會從 Dynamics 365 讀取目前的語言設定，然後在此全域管理員的語言清單中尋找語言。 如果列出項目，語言識別碼的資源會載入至這個 $Resources 集合。

當您想要在輸出的任何地方提供中性語言文字時，就可以改用這個 $Resources 集合中的取代參數。 例如，您可以對按鈕文字使用下列。

[[$Resources.MyButtonName]+]

視使用者的選取語言，會使用適當的當地語系化文字。

也務必要注意這些取代參數 (以及載入的 .resx 檔案) 可能會包含取代參數語法本身。 取代 $Resources 值之後，會重複檢查值是否有其他取代參數。 如此一來，即使您提供語言特定的字串，您也可以將應用程式其餘部分的資料代入這個字串。

如需如何新增當地語系化的資源來設定Unified Service Desk的相關資訊，請參閱為您的客服專員應用程式加入多語系支援。

$Return

某些動作會傳回字串值。 此字串值使用動作呼叫名稱，放入 $Return 取代參數中。 它會遵循這個模式：

[[$Return.ActionCallName]]

這個範例會呼叫全域管理員上的 CreateEntity。 這將在 Dynamics 365 中建立一筆記錄，並傳回新記錄的 GUID。 這個新的 GUID 會在 $Return 取代參數清單中，而且可以做為下一個動作的輸入。

$Session

$Session 區段公開動作呼叫所需的實用變數，例如工作階段計數、使用中工作階段是否全域、目前使用中工作階段 ID。StartTime 值可用來將開始時間寫入活動中。 這是自動填入的區段。

$Settings

此區段提供只會套用到目前使用者的使用者設定。 這些設定會在啟動時自動載入，且在執行階段可透過使用動作呼叫來讀取。 這些通常包含使用者的佈景主題選項的設定，但可用來存取設定者想要提供的任何使用者特定設定。

在設定Unified Service Desk時，在 Dynamics 365 中的 [使用者設定] 區域 ([設定] > [使用者設定]) 定義這些使用者設定。

這些設定可以像系統中任何其他取代參數一樣地使用。 全域管理員託管控制項提供動作 SaveSetting，它會將使用者設定寫入到伺服器 (假設使用者具有寫入權限)。 這可以用來儲存使用者特定的喜好設定，例如佈景主題選項和版面配置。

注意

使用者設定可以儲存到 Dynamics 365 伺服器 (如果使用者具有寫入權限)。

$Subject

Unified Service Desk的有用功能是，在代表使用者建立的新案例中自動填入主旨樹狀結構。 有時您會想要自動填入主旨欄位，但您必須知道要使用的正確值 (可能因系統不同而變更)。

有了此項目，您可以在建立案例時使用下列取代參數，參照特定的主旨。

[[$Subject.Default Subject.Id]][[$Subject.Default Subject.LogicalName]]

$SystemParameters

本節包含變數，稱為 HighContrast，會顯示 Windows 中的高對比模式是否啟用 (true/false)。 您可以使用這個變數決定要啟用一般自訂色彩或系統色彩 (與高對比設定相容)，當您自訂用戶端中的佈景主題時。其他資訊：Customize themes for High Contrast settings

$User

這個取代參數群組會以 Dynamics 365 中目前使用者的記錄內容自動填入。 例如，如果系統管理員延伸 Dynamics 365 系統使用者實體以包含客服專員識別碼，此客服專員識別碼就會出現在此清單中。 這可用來設定特殊使用者設定。

另請參閱

使用取代參數來設定 Unified Service Desk
在 Unified Service Desk 使用 scriptlet 執行指令碼
使用 Unified Service Desk 的實體搜尋以搜尋資料
了解如何使用 Unified Service Desk
全域管理員 (託管控制項)

Unified Service Desk 2.0

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