対話型インターフェース での URL ナビゲーション

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：6分

    • URL ナビゲーション設定を使用して、チャットリンクを開く場所と方法を指定します。特定のリンクが特定のポータルで開くように設定できます。ポップアップウィンドウなどのリンクターゲットを指定することもできます。

    ベースシステムインスタンスには、特定の ServiceNow テーブルのレコードへのチャットリンクが自動的に開かれるデフォルトのポータルが用意されています。たとえば、サービスポータル は、ナレッジ [kbknowledge] テーブルのナレッジレコードと、カタログアイテム [sc_cat_item] テーブルのカタログアイテムを表示するために使用されるデフォルトのポータルです。

    チャット設定の [URL ナビゲーション] を使用して、これらのデフォルトのマッピングを変更したり、ポータル URL を指定された ServiceNow テーブルにマッピングするカスタムマッピングを定義したりします。ポータル構成は、Web クライアント、チャットチャネル、およびメッセージングチャネルに適用されます。

    URL ナビゲーションの仕組み

    チャットリンクに使用するポータルを決定するために、次の情報が、リストされている順序で評価されます。
    1. sysparm ポータルパラメーター：Web クライアントのインスタンス URL に [sysparm_portal] パラメーターを指定した場合、そのポータルが使用されます。
    2. トピックスクリプト変数：トピックスクリプト変数でポータルを指定した場合、そのポータルが使用されます。
    3. プロバイダーチャネル ID のデフォルトポータル：ビルド済みチャット統合またはカスタムチャット統合のプロバイダーチャネル ID [sys_cs_provider_application] テーブルでデフォルトポータルを指定した場合、そのポータルが使用されます。デフォルトのポータルは、プロバイダーのチャットチャネルとメッセージングチャネルに適用されます。プロバイダーチャネル ID の構成の詳細については、カスタムチャット統合フレームワークで「カスタムチャット統合のチャネル識別子を作成する」を参照してください。
    4. テーブルのデフォルトポータル：[URL ナビゲーション] チャット設定にリストされているデフォルトのポータルマッピングのポータル値を使用します。
    5. グローバルデフォルトポータル：com.glide.cs.url_redirect.default.portal システムプロパティを使用してグローバルデフォルトポータルを定義した場合、そのグローバルポータルが使用されます。
    6. サービスポータル：com.glide.cs.url_redirect.default.portal プロパティを使用してグローバルポータルを定義しなかった場合は、サービスポータル が使用されます。

    以前のリリースで定義された従来の URL マッピング (フォールバックメソッド)

    以前に com.glide.cs.portal_url_mapping.default.<portal_value>.<table_name> プロパティを追加して、デフォルトの URL マッピングの代わりに使用される URL マッピングを作成した場合、これらのプロパティは Xanadu リリースにアップグレードした後も保持されます。ただし、チャット設定の [URL ナビゲーション] または URL ナビゲーション [sys_cs_portal_url_mapping] テーブルを使用して、マッピングを表示できるようになりました。URL マッピングには 2 つのタイプがあります。

    デフォルトマッピング
    特定の ServiceNow テーブルに使用されるデフォルトのポータルを定義する、com.glide.cs.portal_url_mapping.portal.<table_name> 形式のすべてのシステムプロパティ。
    表 : 1. デフォルトの URL マッピングプロパティ
    プロパティ 説明

    com.glide.cs.portal_url_mapping.portal.kb_knowledge

    		 ナレッジベース記事に使用するデフォルトのポータルコンテキスト (URL マッピング)。
    • タイプ：文字列
    • デフォルト値：sp (Service Portal)

    com.glide.cs.portal_url_mapping.portal.sc_cat_item

    		 サービスカタログアイテムに使用するデフォルトのポータルコンテキスト (URL マッピング)。
    • タイプ：文字列
    • デフォルト値：sp (サービスポータル)

    com.glide.cs.portal_url_mapping.portal.sys_user

    		 [sys_ user] レコードのデフォルトのポータルコンテキスト (URL マッピング)。
    • タイプ：文字列
    • デフォルト値：esc (従業員サービスセンター (ESC))
    カスタムマッピング
    形式 com.glide.cs.portal_url_mapping.<portal_name>.<table_name> を使用してポータルとテーブルの組み合わせを定義するすべてのシステムプロパティ。これらのマッピングはカスタムマッピングとして保持されます。ポータルまたはテーブルが _default で指定されている場合、ポータルまたはテーブルが使用されていることを示します。
    次の値を評価して、カスタムマッピングの URL が決定されます。
    • ポータルとテーブル / 親テーブル
    • ポータルと任意のテーブル
    • 任意のポータルとテーブル / 親テーブル
    • 任意のポータルと任意のテーブル
    表 : 2. カスタム URL マッピングプロパティ
    プロパティ 説明

    com.glide.cs.portal_url_mapping._default.kb_knowledge

    ナレッジ URL マッピングのデフォルト

    • タイプ：文字列
    • Value:/{{portal}}?id=kb_article&sys_id={{data.sys_id}}

    com.glide.cs.portal_url_mapping._default.sc_cat_item

    カタログアイテム URL マッピングのデフォルト

    • タイプ：文字列
    • Value: /{{portal}}?sys_id={{data.sys_id}}&id={{data.table_name}}&table={{data.table_name}}

    com.glide.cs.portal_url_mapping._default.sys_user

    ユーザー URL マッピングのデフォルト

    • タイプ：文字列
    • Value: /{{portal}}?id=user_profile&sys_id={{data.sys_id}}

    com.glide.cs.portal_url_mapping._default._default

    ナレッジ記事、サービスカタログアイテム、人 (sys_user) レコード、公開レコード、およびタスクレコード以外のレコードのデフォルト URL マッピング。

    • タイプ：文字列
    • Value: /{{portal}}?sys_id={{data.sys_id}}&id=form&table={{data.table_name}}

    スマートリンク

    アドミンとして、指定したパターンに基づいて URL リンクのターゲットを指定できます。たとえば、すべての KB 記事を新しいウィンドウで開く場合は、一般的なチャット設定でマッピングを構成できます。詳細については、「スマートリンク設定を作成する」を参照してください。