グローバルマネージャー (ホストされたコントロール)

[アーティクル]
03/06/2017

公開日: 2016年11月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

グローバルマネージャー にホストされたコントロールの種類が Unified Service Desk のコアであり、このホストされたコントロールのインスタンスは Unified Service Desk によって要求されます。このホストされたコントロールは、アプリケーションの起動時に Microsoft Dynamics 365 から Unified Service Desk のすべての構成データをロードして読み込み、ウィンドウのナビゲーション規則を解釈し、ツールバーのコンポーネントとエージェントのスクリプトにデータを提供し、セッションデータを管理します。[グローバルマネージャー] にホストされたコントロールの種類の 1 つインスタンスだけを読み込むことができます。

重要

Unified Service Desk、New Environment、CRM Web Client、およびInteractive Service Hubの 3 つのサンプルアプリケーションパッケージは、Global Managerホストされたコントロール種類のそれぞれのインスタンスで事前構成されるようになりました。サンプルアプリケーションの詳細については、TechNet: Package Deployer を使用したサンプル Unified Service Desk アプリケーションの CRM サーバーへの展開を参照してください。

[グローバルマネージャー] にホストされたコントロールの種類は、Unified Service Desk のほとんどの関数を解釈するほかに、システムの多言語機能も提供しており、アプリケーションの UI 文字列とメッセージを複数の言語でローカライズすることができます。詳細については、「エージェントアプリケーションの多言語サポートの追加」を参照してください。また、検索プロバイダーを提供します。これは、汎用性があり、構成を通して適応するように設計されています。

このトピックの内容

グローバルマネージャーにホストされたコントロールの作成

事前定義 UII アクション

定義済みのイベント

グローバルマネージャーにホストされたコントロールの作成

新しいホストされたコントロールを作成中、[新しいホストされたコントロールを] 画面は、作成するホストされたコントロールの種類により異なります。このセクションは、[グローバルマネージャー] にホストされたコントロールのタイプに固有の特定のフィールドに関する情報を提供します。ホストされたコントロールの作成方法の詳細については、「ホストされたコントロールの作成または編集」を参照してください。

グローバルマネージャーのホストされたコントロール

[新しいホストされたコントロール] 画面の [Unified Service Desk] 領域で、[グローバルマネージャー] を [USD コンポーネントの種類] ドロップダウンリストから選択します。また、このホストされたコントロールの [並べ替え順序] が [2] に設定されていることを確認します。これにより、接続マネージャーのホストされたコントロールを使用して Dynamics 365 との接続が確立された後すぐに、エージェントアプリケーションでロードされるようにします。その他の [全般] フィールドについては、「ホストされたコントロールの作成または編集」を参照してください。

レコードを保存した後、[言語サービス] 領域が利用可能になります。この領域で、エージェントアプリケーションの UI のローカライズされた文字列を追加するためのリソースを追加します。言語リソースを追加する方法については、「エージェントアプリケーションの多言語サポートの追加」を参照してください。

事前定義 UII アクション

グローバルマネージャーは、Web サービスを通じて Dynamics 365 レコードのデータの操作を可能にする、一連の定義済みのアクションを提供します。これらを構成時に使用して、Dynamics 365 で高度な機能を実行することができます。

次の定義済み UII アクションを、[グローバルマネージャー] にホストされたコントロールの種類で利用できます。

監査

監査エントリをUnified Service Desk 監査ログに追加します。詳細については、「Technet: Unified Service Deskの監査の構成」を参照してください

パラメーター	説明
名前	監査エントリの名前。値を 1 に設定したオプション領域 (設定 > Unified Service Desk > オプション (アクセス方法))にオプションを追加する必要があります。
アクション	監査されるアクションを表す文字列。
TargetApplication	監査の対象アプリケーションを表す文字列。
CustomerId	顧客 ID を表す文字列。
ContextId	コンテキスト ID を表す文字列。
ApplicationId	監査のホストされたコントロールの GUID。
AgentState	エージェントの状態を表す文字列。
ActionData	これは監査エントリを書き込むためのデータです。このパラメーターが明示的に指定されていない場合、アクションコール定義のデータフィールドの残りのすべての行が使用されます。

CallDoAction

別のホストされたコントロールのアクションを呼び出します。

パラメーター	説明
パネル	これは、アプリケーションが指定されていない場合、アクティブなアプリケーションを見つけるためのパネルです。
アクション	これは、ホストされたコントロール上で呼び出されるアクションです。
data	これは、アクションに渡されるデータパラメーターです。
アプリケーション	これは、アクションコールを実行するホストされたコントロール名です。これを指定する場合は、[パネル] パラメーターは無視されます。

ClearAppBar

指定したホストされたコントロールを、クライアントアプリケーションから固定解除します。

パラメーター	説明
ApplicationName	固定解除するホストされたコントロールの名前。このパラメータが指定されない場合、クライアントアプリケーションのメインウィンドウは固定解除されます。

ClearEntityList

累積された検索結果の一覧をクリアし、[DoSearch] アクションを呼び出す前に、常に呼び出されます。

パラメーター	説明
global	グローバルセッションに関連付けられている検索結果をクリアする場合は、True。検索結果はシステムによって自動的にクリアされないので、グローバルセッションで検索結果を保存するときは、注意する必要があります。この場合、[DoSearch] アクションを呼び出す前に [ClearEntityList] アクションを呼び出す必要があります。

global

グローバルセッションに関連付けられている検索結果をクリアする場合は、True。検索結果はシステムによって自動的にクリアされないので、グローバルセッションで検索結果を保存するときは、注意する必要があります。この場合、[DoSearch] アクションを呼び出す前に [ClearEntityList] アクションを呼び出す必要があります。

閉じる

ホストされたコントロールを閉じます。CloseActive アクションとは違い、このタブが複数のページに表示されている場合、エージェントアプリケーション内のタブに表示されているすべてのページが閉じられます。

CloseActive

指定されたパネルのアクティブなホストされたコントロールを閉じます。

パラメーター	内容
	アクション呼び出しの最初の行には、アクティブなアプリケーションを特定するためのパネルの名前を含める必要があります。パラメーターが指定されていない場合は、MainPanel が指定されたものと見なされます。

CopyToClipboard

記事 URL をクリップボードにコピーまたは追加します。

パラメーター	説明
data	コピーするデータです。置換パラメーターも使用できます。例: data=[[$context.title]]
追加	クリップボードにデータを追加するかどうかを示します。falseまたは trueを設定します。例: append=false。

CopyToContext

値または一連の値をコンテキスト変数にコピーします。コンテキスト変数は、セッションでシリアル化できます。このアクションでは、一連の名前と値のペアを使用します。この名前は、コンテキスト変数の名前です。

CopyLogicalEntityToContext

データパラメーターのセクション全体の値をコンテキストへコピーします。

パラメーター	内容
LogicalName	値のコピー元のデータパラメーターの種類またはセクション。

CloseActivity

Dynamics 365の活動レコードを閉じます。

パラメーター	内容
ID	閉じる活動レコードの GUID。
LogicalName	閉じる活動の論理名。
StatusCode	アクティビティが閉じられたの後の最終的なステータスコードの表示名。
StateCode	アクティビティが閉じられたの後の最終的な状態コードの表示名。

たとえば、電話の活動を閉じるには、次の項目を指定する必要があります。

Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed

活動レコードが閉じられたあと、$Return システム置換パラメーターに、活動が成功したかどうかを示すブール値が設定されます。

CreateEntity

Dynamics 365に新しいレコードを作成します。

パラメーター	内容
LogicalName	作成するエンティティの論理名

パラメーターリストの以降の各行には、作成時に設定される他のフィールドを定義する、一連の名前と値のペアが含まれています。

エンティティ参照は次のように記述できます。

Param=EntityReference(“logicalname”, “id”)

OptionSetValue は次のように指定できます。

Param=OptionSetValue(value)

ブール値は次のように記述できます。

Param=Boolean(value)

関係者リスト (電子メールで使用) は次のように記述できます。

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

任意の数の email エントリと er エントリを使用して、それぞれ電子メールアドレスとエンティティ参照を表すことができます。

文字列値などの他の値は次のように指定できます。

Param=value

レコードが作成されると、新しく作成されたレコードの GUID で $Return 値が設定されます。

CreateSession

セッションを作成します。

DeleteEntity

Dynamics 365のレコードを削除します。

パラメーター	内容
ID	削除する値の ID。これは、削除するレコードの GUID である必要があります。
LogicalName	削除するエンティティの論理名。

DoRoute

特定のホストされたコントロールからのポップアップウィンドウをシミュレーションすることにより、ウィンドウナビゲーションルールをテストするために使用されます。これを運用環境で使用して、必要に応じて手動でウィンドウナビゲーションルールを開始することができます。

パラメーター	説明
名前	queueItemの対象となるエンティティの ID
エンティティ	ポップアップウィンドウに表示されるエンティティの論理名。
id	ポップアップウィンドウに表示されるエンティティのID。
フレーム	ポップアップの発生元のフレーム。

DoSearch

Unified Service Deskのエンティティ検索として定義された FetchXML を使用して Dynamics 365 Web サービスを呼び出します。エンティティ検索の定義の詳細については、「統合サービスデスクのエンティティ検索を使用したデータ検索」を参照してください。

パラメーター	内容
name	レコードの検索に使用するエンティティ検索の名前。
global	グローバルセッションに関連付けられている検索結果をクリアする場合は、True。検索結果はシステムによって自動的にクリアされないので、グローバルセッションで検索結果を保存するときは、注意する必要があります。この場合、このアクションを呼び出す前に [ClearEntityList] アクションを呼び出す必要があります。
maxcount	この呼び出しで EntityList 結果に格納するレコードの最大数。

注意

既定で、結果セットのページ数 (ページごとのレコード数) は 50 に設定されます。これは、50 を超えるレコードが戻される場合、それがページに表示されることを意味します。DoSearch アクションに別のページ数の値を指定する場合は、EntitySearchPageCount オプションで新しい値を指定します。詳細:TechNet: Unified Service Desk のオプションを管理する

DoSearch アクションを呼び出す場合、$Return 置換パラメーターには、この検索の結果として、EntityList で見つけられ格納されるレコードの数が表示されます。詳細:$Return。

DisplayMessage

ユーザーに対してメッセージボックスを表示します。

パラメーター	説明
テキスト	これはメッセージボックスに表示するテキストです。このパラメーターを指定しない場合、残りのテキスト (パラメーターの残りの部分) または空の文字列が使用されます。
caption	これはメッセージボックスに表示するキャプションです。キャプションが指定されていない場合は、Dynamics 365 Message が使用されます。

ExecuteOnDataAvailable

指定した一連の置換パラメーターが使用可能になるまで、サブアクションの実行を遅らせます。置換パラメーターが使用可能になるまでの待機時間を制限するため、タイムアウト値を指定する場合があります。タイムアウトが指定されない場合、永久に待機、またはセッションが終了するまで待機します。詳細:ブログ: 特別なアクション、ExecuteOnTimeout、ExecuteOnDataAvailable、ExecuteOnExpressionTrue の使用方法

パラメーター	内容
milliseconds	このアクションが時間切れになりキャンセルされるまでの待機時間を示す、ミリ秒単位の時間です。残りのパラメーターには、サブアクションを実行できるようになるまで存在する必要がある置換パラメーターを含める必要があります。データパラメーターの例: milliseconds=5000 [[account.Id]] [[incident.Id]]

milliseconds

このアクションが時間切れになりキャンセルされるまでの待機時間を示す、ミリ秒単位の時間です。残りのパラメーターには、サブアクションを実行できるようになるまで存在する必要がある置換パラメーターを含める必要があります。

データパラメーターの例:

milliseconds=5000
[[account.Id]]
[[incident.Id]]

重要

このアクションはすべての種類のホストされたコントロールに適用されます。このアクションは、インスタンスの種類のホストされたコントロールを作成する際、既定では表示されません。ホストされたコントロールの種類のインスタンスで ExecuteOnDataAvailable アクションを使用するには、ExecuteOnDataAvailable という名前の UII アクションを、ホストされたコントロールの各インスタンスに明示的に追加する必要があります。詳細:ホストされたコントロールにUIIアクションを追加する

ExecuteOnTimeout

指定した時間が経過するまで、サブアクションの実行を遅らせます。サブアクションを実行すべきときを指定するには、タイムアウト値が必要です。詳細:ブログ: 特別なアクション、ExecuteOnTimeout、ExecuteOnDataAvailable、ExecuteOnExpressionTrue の使用方法

パラメーター	内容
milliseconds	サブアクションが実行されるまでの待機時間を示す、ミリ秒単位の時間です。データパラメーターの例: milliseconds=5000

milliseconds

サブアクションが実行されるまでの待機時間を示す、ミリ秒単位の時間です。

データパラメーターの例:

milliseconds=5000

重要

このアクションはすべての種類のホストされたコントロールに適用されます。このアクションは、インスタンスの種類のホストされたコントロールを作成する際、既定では表示されません。ホストされたコントロールの種類のインスタンスで ExecuteOnTimeout アクションを使用するには、ExecuteOnTimeout という名前の UII アクションを、ホストされたコントロールの各インスタンスに明示的に追加する必要があります。詳細:ホストされたコントロールにUIIアクションを追加する

ExecuteOnExpressionTrue

指定した JavaScript 式が true を戻すまで、サブアクションの実行を遅らせます。時間切れになるまで待機する時間を制限するために、タイムアウト値を指定する場合があります。タイムアウトが指定されない場合、永久に待機、またはセッションが終了するまで待機します。詳細:ブログ: 特別なアクション、ExecuteOnTimeout、ExecuteOnDataAvailable、ExecuteOnExpressionTrue の使用方法

パラメーター	内容
milliseconds	このアクションが時間切れになりキャンセルされるまでの待機時間を示す、ミリ秒単位の時間です。残りのパラメーターは評価用の JavaScript 式です。この式が true であるとき、サブアクションが実行されます。データパラメーターの例: milliseconds=5000 function IsAccountLoaded() { return “[[account.Id]$+]” != “”; } IsAccountLoaded();

milliseconds

このアクションが時間切れになりキャンセルされるまでの待機時間を示す、ミリ秒単位の時間です。残りのパラメーターは評価用の JavaScript 式です。この式が true であるとき、サブアクションが実行されます。

データパラメーターの例:

milliseconds=5000
function IsAccountLoaded()
{
return “[[account.Id]$+]” != “”;
}
IsAccountLoaded();

重要

このアクションはすべての種類のホストされたコントロールに適用されます。このアクションは、インスタンスの種類のホストされたコントロールを作成する際、既定では表示されません。ホストされたコントロールの種類のインスタンスで ExecuteOnExpressionTrue アクションを使用するには、ExecuteOnExpressionTrue という名前の UII アクションを、ホストされたコントロールの各インスタンスに明示的に追加する必要があります。詳細:ホストされたコントロールにUIIアクションを追加する

ExecuteScriptlet

指定したスクリプトレットを実行します。

パラメーター	説明
	[データ] フィールドで実行するスクリプトレットの名前を指定します。

FireEvent

このホストされたコントロールからユーザー定義イベントを発生させます。

パラメーター	説明
名前	ユーザー定義イベントの名前。

後続のすべての名前と値が等しい組み合わせは、イベントに対するパラメーターとなります。ユーザー定義イベントの作成方法の詳細については、「ユーザー定義イベントの作成」を参照してください。

GetTemplate

統合された電子メールテンプレートの内容を取得します。

パラメーター	説明
名前	取得するテンプレートの名前。
id	マージ操作のために、このテンプレートと関連付けるエンティティの ID。

InvokeCTI

CTI イベントのシミュレーション

パラメーター	内容
種類	これは、電話や会話などの CTI イベントの種類です。
appname	このポップアップのシミュレーションに使用するデスクトップマネージャーの名前。
ani	自動番号識別 (ANI)、または呼び出し元の電話番号。
dnis	DNIS、またはダイヤルする番号。
	残りのすべてのパラメーターは、パラメーターとして、CTI イベントプロセッサに渡されます。

LaunchURL

Unified Service Desk 以外の Internet Explorer で URL を起動します。 [データ] フィールドでパラメーターとして URL を指定する必要があります。

LookupQueueItem

システムで queueitem を検索して、情報を取得します。

パラメーター	説明
ID	queueItemの対象となるエンティティの ID
EntityType	[Id] フィールドで参照されるエンティティの型名または論理名。

結果として得られるqueueitemの詳細は、queueitemの置換パラメーターに配置され、後で参照することができます。

MoveApplicationToPanel

ホストされたコントロールを、クライアントアプリケーションの指定したパネルに移動します。

パラメーター	説明
アプリ	移動するホストされたコントロールの名前。
パネル	対象パネルの名前。

MoveToPanel

ホストされたコントロールを実行時にパネル間で移動します。

パラメーター	説明
アプリ	移動するホストされたコントロールの名前。
パネル	ホストされたコントロールのターゲットパネルです。

New_CRM_Page

指定されたエンティティの新規 Dynamics 365 レコードを作成するためのページを作成し、そのページを指定したホストされたコントロールのポップアップとして扱います。エンティティレコードを作成するページが表示される場所を決定するため、ウィンドウナビゲーションルールが評価されます。

パラメーター	説明
LogicalName	新しいインスタンスを作成するためのエンティティの論理名です。

注意

残りのパラメーターは名前と値のペアで構成する必要があります。これらは、指定されたエンティティの新しいレコードを作成するための、フォーム内で事前設定される追加の値です。このアクションの使用に関する詳細については、チュートリアル 7: エージェントアプリケーションでエージェントスクリプトを構成するのステップ 4 を参照してください。

Open_CRM_Page

ID によって指定されて認識されたエンティティの既存のインスタンスを開き、指定したホストされたコントロールからポップアップとしてそのページを取り扱います。ウィンドウのナビゲーション規則が評価され、そのポップアップを表示する場所が決定されます。

パラメーター	説明
LogicalName	開くエンティティの論理名。
id	開くエンティティレコードの ID。

一時停止

メッセージの処理をブロックすることなく、アクションの実行を一時停止します。このアクションは、処理が続行できるようにするので、指定した時間の(Thread.Sleep)現在のスレッドの中断とは異なります。このアクションは、Web 操作を完了するのを待機する場合に便利です。

パラメーター	内容
milliseconds	一時停止するミリ秒数。

ポップアップ

ホストされたコントロールから URL がポップアップし、ポップアップを適切な場所にルーティングするために、URL に対してウィンドウナビゲーション規則を実行します。

パラメーター	内容
url	この URL を使用して、表示されているコントロールからの要求されたポップアップであるかのように、ホストされているコントロールからのポップアップをルーティングします。
フレーム	このポップアップの発生元のフレーム。

RealignWindow

モニタ上の指定された場所に、ホストされたコントロールを表示します。ホストされたコントロールは最大 2 台のモニタに表示できます。この操作は、USDFloatingPanel または USDFloatingToolPanel のパネルの種類に配置されるように構成されているホストされたコントロールのインスタンスに適用されます。

パラメーター	説明
screen	ホストされたコントロールを表示する画面を指定します。有効な値は 1 または 2 です。このパラメーターを指定しない場合、既定で 1 が渡されます。
left	ホストされたコントロールが表示される対象モニタの画面の左からの位置を、パーセンテージで指定します。有効な値は 0 ～ 100 です。このパラメーターを指定しない場合、既定で 0 が渡されます。
top	ホストされたコントロールが表示される対象モニタの画面の右からの位置を、パーセンテージで指定します。有効な値は 0 ～ 100 です。このパラメーターを指定しない場合、既定で 0 が渡されます。
width	対象モニタに表示されるホストされたコントロールのウィンドウの幅を、パーセンテージで指定します。有効な値は 1 ～ 100 です。このパラメーターを指定しない場合、既定で 100 が渡されます。
height	対象モニタに表示されるホストされたコントロールのウィンドウの高さを、パーセンテージで指定します。有効な値は 1 ～ 100 です。このパラメーターを指定しない場合、既定で 100 が渡されます。

ReadSettings

$Settings 置換パラメーターから、以前保存した設定を読み取ります。

パラメーター	内容
readfromcache	これらの設定のローカルでキャッシュされたバージョンを読み取る場合は True です。それ以外の場合は、False または存在しません。

RedoScreenPop

最後の画面を再度ポップアップします。これは、セッションの制限に達してポップアップが成功しなかった場合や、セッションを閉じたものの追加の作業が必要になった場合に役に立ちます。このアクションには、パラメーターは必要ありません。

ResetLocalCache

Unified Service Deskの構成キャッシュをリセットします。次に Unified Service Deskが開始されると、サーバーから構成がダウンロードされます。ユーザーには、このアクションを実行するために、msdyusd_usersettings エンティティに対する書き込み権限が必要です。

RouteToQueue

エンティティを Dynamics 365 内のキューにルーティングします。

パラメーター	内容
destination	ターゲットキューの ID。これは、destinationqueuename パラメーターと相互に排他的です。
destinationqueuename	これは、エンティティのルーティング先のキューの名前です。
entitytype	これは、ルーティングされるエンティティの論理名です。
entityid	これは、キューに配置するエンティティの GUID と Id です。

SaveAll

複数のページを表示できるように ([複数ページの許可] = Yes)、すべてのフォームのホストされたコントロールを保存します。ホストされたコントロールが単一ページの表示のみを許可する場合 ([Allow Multiple Pages] = No)、[保存] アクションと同等です。

SaveSetting

ユーザー固有の設定を格納します。

パラメーター	内容
名前	設定の名前。これは $Settings 置換パラメーターに表示されます。
値	保存する設定の値。

SetTheme

テーマに適用して、ユーザーインターフェイスのコンポーネントのレイアウトや見た目を変更します。詳細:アプリケーションの外観をカスタマイズ

パラメーター	内容
clear	指定したテーマを適用する前に、現在のテーマを完全にクリアする場合は True。このパラメーターが false に指定された場合、または指定されなかった場合、現在のテーマに新しいテーマの情報が結合されます。
	残りのパラメーター (他のパラメーターの削除後も残っているもの) には、使用するテーマの名前を含める必要があります。これは、XAML ファイル (名前を XML に変更して、Web リソースとしてアップロード) の Web リソース名、匿名のアクセスサーバーからの URL、またはテーマを表す生の XAML である必要があります。

clear

指定したテーマを適用する前に、現在のテーマを完全にクリアする場合は True。このパラメーターが false に指定された場合、または指定されなかった場合、現在のテーマに新しいテーマの情報が結合されます。

残りのパラメーター (他のパラメーターの削除後も残っているもの) には、使用するテーマの名前を含める必要があります。これは、XAML ファイル (名前を XML に変更して、Web リソースとしてアップロード) の Web リソース名、匿名のアクセスサーバーからの URL、またはテーマを表す生の XAML である必要があります。

SetAppBar

クライアントアプリケーションのメインウィンドウの指定したエッジにホストされたコントロールを固定します。

パラメーター	説明
ApplicationName	固定するホストされたコントロールの名前。このパラメーターを指定する場合、このホストされたコントロールをホストする親ウィンドウが固定されます。
幅	固定されたウィンドウのピクセル単位の幅。これが指定されていない場合、現在のウィンドウ幅が使用されます。
高さ	固定されたウィンドウのピクセル単位の高さ。これが指定されていない場合、現在のウィンドウ高さが使用されます。
エッジ	固定先のエッジ。何も指定されていない場合、[上] と仮定します。[上]、[下]、[左]、または [右] のいずれかの値を指定します。

SetEventTimer

イベントタイマーを開始するように設定します。

パラメーター	内容
名前	イベントタイマーの名前。

SetSize

ホストされたコントロールの幅と高さを設定します。これは、パネルのレイアウトで「自動」を使用するときに特に有用です。

パラメーター	内容
幅	ホストされるコントロールの幅。
height	ホストされたコントロールの高さ。

SetWindowProperty

クライアントアプリケーションのメインウィンドウに、ウィンドウの状態を設定します。

パラメーター	説明
WindowState	[最大化]、[最小化]、または [通常] の値のいずれか。

ShellExecute

このアクションは、URL またはコマンドラインを起動するためのものです。ユーザーには、アプリケーションを実行する権限が必要です。

パラメーター	内容
	唯一のパラメーターは、実行するアプリケーションのコマンドラインまたは URL です。

ShowAbout

Unified Service Desk用ダイアログボックスに関する標準を表示します。これには、現在のユーザー、ユーザーが接続している Dynamics 365 サーバーおよび組織、Unified Service Desk クライアントアプリケーションのバージョン番号、およびサポートサイトの URL などの情報が含まれます。

ShowTab

エージェントアプリケーションのタブ (ホストされたコントロール) にフォーカスを設定します。

パラメーター	説明
	アクションコールの最初の行には、前面に表示するホストされたコントロールの名前を含める必要があります。ホストされたコントロールの表示名は使用しないでください。このアクションコールの使用に関する詳細については、チュートリアル 2: エージェントアプリケーションに外部 Web ページを表示するのステップ 4 を参照してください。

アクションコールの最初の行には、前面に表示するホストされたコントロールの名前を含める必要があります。ホストされたコントロールの表示名は使用しないでください。このアクションコールの使用に関する詳細については、チュートリアル 2: エージェントアプリケーションに外部 Web ページを表示するのステップ 4 を参照してください。

StopEventTimer

イベントのタイマーを停止します。

パラメーター	内容
名前	停止するイベントタイマーの名前。

Translate

Microsoft Translator を使用した言語翻訳の実行を有効にします。

パラメーター	説明
値	これは翻訳するテキストです。この値は複数行サポートではエスケープされることがあります。一部の有効例。 `value=$Escaped("my string<br>new line\\\"my text\\\"")` `value=[[myapp.myparam]^]` `value=$Escaped([[myapp.myparam]$])` これらの置換キーの詳細については、置換パラメーターを使用した統合サービスデスクの構成を参照してください。
fromlanguage	翻訳前の言語の名前。これが空の場合、翻訳する前に、翻訳するよう指定された値の言語の検知を試みます。有効な言語の値の一覧については、Translator 言語コードを参照してください。
tolanguage	翻訳後の言語の名前。有効な言語の値の一覧については、Translator 言語コードを参照してください。
clientId	翻訳サービスの Microsoft Azure から取得されたクライアント ID。Azure に登録するための詳細については、https://datamarket.azure.comを参照してください。
clientsecret	翻訳サービスの Microsoft Azure から取得されたクライアントシークレット。Azure に登録するための詳細については、https://datamarket.azure.comを参照してください。

翻訳された値は、$Return 置換パラメーターの下に表示されます。

UpdateEntity

Dynamics 365のレコードを更新します。

パラメーター	内容
ID	更新する値の ID。これは、更新するレコードの GUID である必要があります。
LogicalName	更新するエンティティの論理名

パラメーターリストの以降の各行には、更新時に設定される他のフィールドを定義する、一連の名前と値のペアが含まれています。

エンティティ参照は次のように記述できます。

Param=EntityReference(“logicalname”, “id”)

OptionSetValue は次のように指定できます。

Param=OptionSetValue(value)

ブール値は次のように記述できます。

Param=Boolean(value)

関係者リスト (電子メールで使用) は次のように記述できます。

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

任意の数の email エントリと er エントリを使用して、電子メールアドレスとエンティティ参照それぞれ表すことができます。

文字列値などの他の値は次のように指定できます。

Param=value

作業開始

このアクションは、キューからキューアイテムを選択し、リボン上で WorkOn ボタンをクリックする操作と同じです。これは、キューアイテムを、特定のエージェントで作成したものとしてマークします。

パラメーター	説明
ID	これはqueueitemの ID です。対象のエンティティの ID を取得する方法については、「LookupQueueItem」を参照してください。
アクション	WorkOn 属性を削除してキューに戻すことを、管理者が指定できるようにする省略可能なパラメーター。有効な値: Remove - WorkOn 属性を削除し、別のものが作業するキューにアイテムを返します。

これはqueueitemの ID です。対象のエンティティの ID を取得する方法については、「LookupQueueItem」を参照してください。

アクション

WorkOn 属性を削除してキューに戻すことを、管理者が指定できるようにする省略可能なパラメーター。

有効な値:

Remove - WorkOn 属性を削除し、別のものが作業するキューにアイテムを返します。

定義済みのイベント

このホストされたコントロールに関連付けられる定義済みイベントを以下に示します。

DesktopReady

デスクトップのすべての初期化が完了し、Dynamics 365 への接続が確立されたとき、起動時に発生します。このイベントは一度のみ発生します。通常、このイベントを使用して、テーマの設定および他のスタートアップアクションを実行します。

SessionActivated

セッションがアクティブにされたときに常に発生します。

パラメーター	説明
SessionId	で現在アクティブなセッションの ID。
IsGlobal	このイベントをグローバルセッションに適用するかどうかを示します。 True または False を戻します。
アクティブ化	これは true に設定されています。

SessionClosed

セッションが閉じられるときに発生します。

パラメーター	説明
SessionId	閉じられたセッションの ID です。
IsGlobal	このイベントをグローバルセッションに適用するかどうかを示します。 True または False を戻します。

SessionDeactivated

セッションが非アクティブ化されるときに発生します。

パラメーター	説明
SessionId	非アクティブなセッションの ID。
IsGlobal	このイベントをグローバルセッションに適用するかどうかを示します。 True または False を戻します。
アクティブ化	これは False に設定されています。

SessionNew

新しいセッションが作成されたときに発生します。

パラメーター	説明
SessionId	新しく作成されたセッションの ID。
IsGlobal	新しいセッションがグローバルセッションの場合は True を返します。それ以外の場合は、False を返します。

次の方法で共有

グローバル マネージャー (ホストされたコントロール)

このトピックの内容

グローバル マネージャーにホストされたコントロールの作成

事前定義 UII アクション

監査

CallDoAction

ClearAppBar

ClearEntityList

閉じる​​

CloseActive

CopyToClipboard

CopyToContext

CopyLogicalEntityToContext

CloseActivity

CreateEntity

CreateSession

DeleteEntity

DoRoute

DoSearch

DisplayMessage

ExecuteOnDataAvailable

ExecuteOnTimeout

ExecuteOnExpressionTrue

ExecuteScriptlet

FireEvent

GetTemplate

InvokeCTI

LaunchURL

LookupQueueItem

MoveApplicationToPanel

MoveToPanel

New_CRM_Page

Open_CRM_Page

一時停止

ポップアップ

RealignWindow

ReadSettings

RedoScreenPop

ResetLocalCache

RouteToQueue

SaveAll

SaveSetting

SetTheme

SetAppBar

SetEventTimer

SetSize

SetWindowProperty

ShellExecute

ShowAbout

ShowTab

StopEventTimer

Translate

UpdateEntity

作業開始

定義済みのイベント

DesktopReady

SessionActivated

SessionClosed

SessionDeactivated

SessionNew

関連項目

その他のリソース

グローバルマネージャー (ホストされたコントロール)

グローバルマネージャーにホストされたコントロールの作成

閉じる