次の方法で共有

Unified Service Desk でのウィンドウ ナビゲーションの規則の使用

  • [アーティクル]

ウィンドウ ナビゲーション ルールは Unified Service Desk のさまざまなコントロール間の対話を定義します。 このルールを使用して、ホストされたコントロールまたはエンティティ検索から呼び出されたときの、Unified Service Desk クライアント アプリケーションに表示される、セッションまたはモデル駆動型アプリのページの場所を定義することができます。 Unified Service Desk のホストされたコントロールおよびエンティティ検索の詳細については、Unified Service Desk のホストされたコントロール および Unified Service Desk のエンティティ検索を使用したデータ検索 を参照してください。

注意

Windows ナビゲーション ルールは、標準 Web アプリケーションでは機能しません。

ウィンドウのナビゲーション ルールの作成または編集

Unified Service Desk のウィンドウ ナビゲーション ルールは、指定された番号順と条件により実行されます。 この順序は、1 つ以上のルールが、コントロールを表示する条件に適用されるときに特に重要です。 たとえば、他のルールが適用されない場合に一致する、既定のハンドラーを作成できます。 このような既定のハンドラーは、より具体的なハンドラーの後に置く必要があります。そうでなければ、この特定のハンドラーは決して使用されることはありません。

ウィンドウ ナビゲーション ルールを作成または編集する

  1. Unified Service Desk 管理者にサインインします。

  2. 基本設定 から ウィンドウ ナビゲーション ルール を選択します。 ページに、システムのすべての既存のナビゲーション ルールが表示されます。

  3. 新規 を選択して新しいナビゲーション ルールを作成するか、既存のナビゲーション ルールを選択して編集します。

  4. 新しいナビゲーション ルールを作成、または既存のナビゲーション ルールをそれぞれ編集する場合は、ナビゲーション ルールの定義のページで、次の値を指定または変更します。 必須フィールドには、赤いアスタリスクが付けられています。

    フィールド 内容
    名前 これは、ウィンドウのナビゲーション ルールの名前です。
    受注 これは、実行の順序を制御するルールの番号順です。 最初に、小さい方の値から一致します。 より具体的なルールの値は小さくし、より一般的なルールまたは既定のルールの値は小さくする必要があります。
    差出人 ナビゲーションまたはルーティングの要求が発生する、ホストされたコントロールを選択します。 注: ホストされたコントロールの CTI デスクトップ マネージャーの種類を発生元リストから選択する場合、このページのインターフェイスが変更されて CTI 検索を定義できるようになります。 ウィンドウのナビゲーション ルールを使用した CTI 検索の構成の詳細については、CTI search を参照してください。
    検索元 関連エンティティからデータを表示する OnLoad ルーティング タイプの規則 (後で説明) を起動するエンティティ検索名を選択します。 フォームに表示されていないデータにアクセスするとき、エンティティ検索を使用できます。 エンティティ検索が完了してデータを返すとき、OnLoad ルーティング タイプの規則が実行されて、関連するエンティティを読み込みことができます。 エンティティ検索の詳細については、Unified Service Desk のエンティティ検索を使用したデータ検索 を参照してください。
    エンティティ ウィンドウのナビゲーション ルールで情報が表示されるアプリのエンティティの名前を選択します。
    URL このフィールドは通常、 Microsoft Dataverse エンティティを表さない、または標準の Web URL であるウィンドウに使用されます。 このフィールドは、エンティティフィールドの代わりに使用されますが、特定の状況では、エンティティフィールドといっしょに使用できます。 このフィールドのアスタリスク (*) は、 **From** フィールドから発生するすべてのポップアップ ウィンドウに適用されるデフォルトのルールを作成するために使用されます。

  5. 結果のタブを選択します。

    フィールド 説明
    ルーティングの種類 - ポップアップ: ポップアップ ウィンドウの処理方法を決定するために使用します。
    - OnLoad: エンティティの検索、モデル駆動型アプリのページ、または外部 Web ページを、それらの読み込み後に処理する方法を決定するために使用されます。
    - 一括: モデル駆動型アプリのフォームの一括移行または読み込みを処理する方法を決定するために使用します。 たとえば、モデル駆動型アプリの取引先企業ページの取引先担当者名を選択すると、取引先担当者情報が、取引先企業情報が表示された同じフレームに読み込まれます。
    - 選択されたメニュー: ナビゲーション バーのレコード名の横の矢印を選択し、メニュー一覧から項目を選択するとき、メニュー項目の選択を処理する方法を決定するために使用します。 たとえば、取引先担当者、営業案件、サポート案件などのアイテムを選択するためにモデル駆動型アプリのアプリの取引先企業ページのナビゲーション バーにある取引先企業名の横のドロップダウン矢印をクリックした場合。
    フィールド ウィンドウ ナビゲーション ルールをトリガーする必要があるフィルターを示します。 値は、エンティティ ページからの属性名である必要があります。 ウィンドウ ナビゲーション ルールは、複数の検索があるページに適用できますが、フィールド フィルターを使用して、特定の検索にルールを適用することができます。
    作成先 - タブルーティングの種類で選択する項目は、タブを対象にする必要があります。これにより、対象のタブとタブの表示フィールドが有効になります。
    - エンティティの検索: ルーティングの種類で選択する項目は、Dataverse への Web サービス呼び出しを使用してデータを検索するエンティティ検索を対象にする必要があります。 これは、置換パラメーターで使用できるように、Unified Service Desk データを設定します。
    Action - セッションの作成 : ポップアップルーティングの種類だけに適用されます。 このアクションは、ポップアップに含まれているエンティティに基づいて、セッションを読み込みます。 たとえば、発生元が「Queues」、エンティティが「incident」、ルーティングの種類が「Popup」、アクションが「Create Session」に設定されている場合、キュー内のインシデントをダブルクリックすると、セッションが作成され、対象のタブフィールドで特定されるタブにポップアップが読み込まれます。
    - ウィンドウのルーティング : ウィンドウを同じセッション内の別のタブに移動させます。 これは、ウィンドウのルーティングの最も基本的なフォームです。
    - 外側に表示 : このルールと一致した場合、クライアント アプリケーションの外側にポップアップ ウィンドウが表示されます。 この新しいウィンドウはもはや Unified Service Desk の制御下にはなく、統合サービス デスクのセッション管理に関与しません。 これは、2 番目のモニターにウィンドウを表示したり、別の Unified Service Desk セッションの別のタブに対して、または別のウィンドウに対してウィンドウを比較する場合に役立ちます。
    - なし : アクションが実行されません。
    対象のタブ この規則に一致する場合、これがウィンドウの移動先になります。 対象のタブ (ホストされたコントロール) が動的なコントロールである場合、そのタブは自動的に読み込まれ、そのタブにウィンドウが表示されます。 このフィールドが グローバル マネージャー に、アクション が セッションの作成 に設定されている場合、システムは規則を再評価して、タブ内でのウィンドウの実際の場所を決定します。 これは、特定のウィンドウからポップアップする可能性のあるすべてのルーティングの種類に対して、セッションの作成の規則を作成しないようにする場合に役立ちます。 対象のタブフィールドを空のままにした場合、ポップアップからのエンティティの種類に一致する最初のエンティティの検索を使用して、エンティティの検索が実行されます。
    タブの表示 このフィールドは、アクションの実行後に、特定のタブをアクティブにするために使用されます。
    エンティティ検索 これは、データの検索に使用されるエンティティ検索 (FetchXML ベースのWebサービス定義) です。 これは、呼び出しで収集されたフィールドを持つセッションのデータ フィールドに設定されます。 エンティティ検索の詳細については、Unified Service Desk のエンティティ検索を使用したデータ検索 を参照してください。
    コマンド バーの非表示 これにより、Unified Service Desk は、ウィンドウが新しいタブに表示された後、モデル駆動型アプリのコマンド バーを非表示にします。
    ナビゲーション バーの非表示 これにより、Unified Service Desk は、ウィンドウが新しいタブに表示されると、ウィンドウの左側のモデル駆動型アプリのナビゲーション バーを非表示にします。

  6. 詳細 タブを選択し、条件を指定します。

    条件フィールドは、true または false の結果を生み出す javascript 式です。
    ウィンドウ ナビゲーション ルールは、実行時に条件式が true として検証された場合のみ実行されます。 標準の置換パラメーターに加え、条件で [[url]] を置換パラメーターとして使用できます。 [[url]] 置換パラメーターは、実行時にターゲット ページの URL に置き換えられます。
    条件式は任意で、ウィンドウ ナビゲーション ルールの検証には影響しません。
    ただし、正しくない条件式では、ウィンドウ ナビゲーション ルールが失敗します。

  7. 保存 を選択して、ウィンドウ ナビゲーション ルールを作成または変更します。

関連項目

チュートリアル 4: エージェント アプリケーション内のセッションにレコードを表示する
チュートリアル 7: エージェント アプリケーションでエージェントスクリプトを構成する
チュートリアル: CTI イベントに対して汎用リスナー アダプターを使用する
Unified Service Desk の使用について