CTI デスクトップ マネージャー (ホストされたコントロール)

  • [アーティクル]

ホストされたコントロール タイプ CTI デスクトップ マネージャーを使用して、コンピューター電話統合 (CTI) アダプターを Unified Service Desk に接続し、画面のポップアップ表示、通話のルーティング、通話制御、および他の CTI 機能を処理します。

CTI デスクトップ マネージャーにホストされたコントロールの作成

CTI デスクトップ マネージャーの作成と対応するホストされたコントロールの構成の方法の詳細については、「CTI デスクトップ マネージャーの作成」を参照してください。

事前定義 UII アクション

これらは、このホストされたコントロール タイプの定義済みアクションです。

閉じる​​

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

CloseAndPrompt

このアクションはホストされたコントロールを終了しますが、閉じる前に保存または変更を破棄することが求められます。

DisableToolbarButton

このアクションは、エージェント アプリケーションのツール バーの指定したボタンを無効にします。

パラメーター 説明
無効にするツールバー ボタンの名前。

EnableToolbarButton

このアクションは、エージェント アプリケーションのツール バーの指定したボタンを有効にします。

パラメーター 内容
有効にするツールバー ボタンの名前。

検索

指定されたエンティティの簡易検索リスト ビューに移動します。

パラメーター 内容
データ パラメーターには、表示する簡易検索リスト ビューのエンティティの論理名を指定します。 いくつかの特殊なサポート案件の値もあります。

- サポート案件またはインシデントを使用して、サポート案件のための簡易検索一覧ビューを表示します。
- advfind を使用して高度な検索ビューを表示します。
- 活動(複数)または活動(単数)を使用して、活動に使用する簡易検索一覧ビューを表示します。

FireEvent

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

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

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

GoBack

この操作は、ブラウザー インスタンスの [戻る] ボタンをクリックすることと同じです。

GoForward

この操作は、ブラウザー インスタンスの [進む] ボタンをクリックすることと同じです。

GoHome

この操作は、ブラウザー インスタンスで指定された初期 URL に移動します。

LoadArea

このアクションはモデル駆動型アプリから特定の領域を読み込みます。 これは、ナビゲーション ウィンドウ内の領域を選択することに相当します (Sales、Service、および Marketing など)。 唯一のパラメーターはクリックする領域の名前です。 例: areaService。

パラメーター 説明
フレーム 影響するフレームの名前。 名前を指定しない場合、ページ上で最初に見つかったフレームを自動的にターゲットとします。

MoveToPanel

このアクションを使用して、ホストされたコントロールを実行時にパネル間で移動します。

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

この操作は、モデル駆動型アプリの URL に移動するために使用します。

パラメーター 説明
url 移動先のURL。 これは必須パラメーターです。
Noscan このパラメーターが指定されており、True の場合、データ パラメーターはページからキャプチャされません。
HideCommandBar このパラメーターが与えられていて、True の場合、モデル駆動型アプリのコマンド バーを読み込まなくても、内部フレームが表示されます。
HideNavigationBar このパラメーターが与えられていて、True の場合、モデル駆動型アプリのナビゲーション バーを読み込まなくても、フォームが表示されます。
フレーム ページ上にフレームが存在する場合、このパラメーターは、メイン ウィンドウを移動させるのではなく、移動するフレームの名前を指定します。
postdata HTTPPOST トランザクションの一部として、サーバーに送信されるデータ。 POST トランザクションは、通常、HTML ページによって収集されたデータの送信に使用されます。 Unified Service Desk では、このデータは、"<https://event/?>" を使用して発生したイベントから取得されます。 例: [[postdata]+]

または、データは、意図した形式のヘッダー タイプでエンコードされた文字列として渡されます。
ヘッダー サーバーに送信する追加の HTTP ヘッダーを含む文字列値。 postdata パラメーターがNavigate アクションで使用されると、header パラメーターに適切な値を指定する必要があります。 例: Content-Type:application/x-www-form-urlencoded

Unified Service Desk POST イベントが Navigate アクションをトリガーすると、このパラメーターの規定値は header=[[header]+] になります

New_CRM_Page

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

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

Note

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

Open_CRM_Page

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

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

ホストされたコントロールから 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 が渡されます。

ReRoute

このアクションは、現在表示されている URL を取得し、ポップアップとして現在のホストされたコントロールからウィンドウ ナビゲーション ルールを介してそのURLを送信します。

RunScript

このアクションは、アプリケーションのメイン フレームに JavaScript を挿入します。 このアクションでは、Microsoft Dataverse クライアント SDK 呼び出しの使用を避ける必要があります。代わりに、RunXrmCommand アクションを使用します。

パラメーター 説明
データ パラメーターは、フォームに挿入される JavaScript です。 注: 置換パラメーターは、スクリプトで使用され、スクリプトが実行される前に置き換えられます。

RunXrmCommand

このアプリケーションは、Dataverse SDK JavaScript をモデル駆動型アプリ フォームに挿入する目的で使用されます。

パラメーター 説明
データ パラメーターは、フォームに挿入される JavaScript です。 注: 置換パラメーターは、スクリプトで使用され、スクリプトが実行される前に置き換えられます。

保存

このアクションは現在のページを保存します。

SaveAll

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

SaveAndClose

このアクションはモデル駆動型アプリ フォームのダーティ データを保存し、ホストされたコントロールを終了します。

SetSize

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

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

ToggleNavigation

このアクションは、モデル駆動型アプリ ウィンドウの左側のパネルにあるナビゲーション ウィンドウを折りたたみまたは展開します。 このアクションが動作するためには、ナビゲーションにナビゲーション パネルが含まれている必要があります。

ToggleRibbon

このアクションはリボンを折りたたみまたは展開します。 移動アクションでリボンを非表示にする場合、リボンは表示されず、この操作は動作しません。 このアクションは、リボンが最初から読み込まれているときにのみ動作します。

WaitForComplete

このアクション URL の読み込みが完了するまで処理をブロックするのに使用されます。

Note

一部の Web ページ、特にモデル駆動型アプリのページには、複数のフレームがあります。 このアクションは、メインのフレームのみの完了を待ちます。

パラメーター 説明
Milliseconds タイムアウトを待機するミリ秒単位で時間を指定するオプションのパラメーター。

定義済みのイベント

これらは、このホストされたコントロール タイプの定義済みイベントです。

BrowserDocumentComplete

ページの読み込みが完了したときに発生します。

パラメーター 内容
URL 読み込みを完了したページの URL。

FrameLoadComplete

フレームの読み込みが完了したタイミングに発生します。 このイベントは、 iFrame または フレームがページで使用された際に、ページが読み込まれるたびに複数回発生します。 このイベントは、コードの個々の BrowserDocumentComplete イベントに対応します。

パラメーター 説明
フレーム 読み込みを完了したフレームの名前。
URL 読み込みを完了したフレームの URL。

PopupRouted

システムによりポップアップがルートされた後に発生します。

パラメーター 内容
URL ルートされたポップアップの URL です。

関連項目

CTI アダプターを使用して CTI システムと統合する