ガイド付きツアーの有効化

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:4分
  • サービスポータルページのガイド付きツアーと標準のプラットフォーム UI を有効にします。

    始める前に

    必要なロール:admin

    このタスクについて

    この ガイド付きツアーデザイナー は、 Jakarta リリースで初めて導入されました。Jakarta 以降に作成された新しいインスタンスの場合、ガイド付きツアーはデフォルトでアクティブになっています。事前Jakartaに由来するインスタンスの場合、ガイド付きツアーはデフォルトで無効になっています。

    Yokohamaリリースでは、サービスポータルページでガイド付きツアーを実行できるようにすることもできます。インスタンスを Yokohama にアップグレードすると、次の結果になります。
    • Yokohama の新機能のインスタンスの場合、サービスポータル機能のガイド付きツアーはデフォルトで有効になっています。
    • Yokohama にアップグレードする事前Yokohamaインスタンスの場合、サービスポータル 機能のガイド付きツアーはデフォルトで無効になっています。
    注:
    サービスポータルアプリケーションは、ユーザーがカスタムコンテキストで特定のプラットフォーム機能にアクセスできるように、ポータルをカスタマイズできるフレームワークを提供します。サービスポータルページのガイド付きツアーを作成して、そのコンテンツのコンテンツを順を追ってユーザーをガイドすることができます。

    手順

    1. アプリケーションナビゲーターで、「sys_properties.list」と入力します。
    2. [システムのプロパティ] リストから、次のプロパティを見つけて、その値を True に設定します。
      プロパティ 説明
      com.snc.guided_tours.standard_ui.enable インスタンス全体のガイド付きツアーを標準プラットフォームの UI とワークスペースで実行できるようにします。
      com.snc.guided_tours.sp.enable インスタンス全体のガイド付きツアーをサービスポータルページで実行できます。このプロパティ設定に関係なく、標準 UI ページのツアーを作成して公開できます。
      com.snc.guided_tours.custom_ui.enable カスタム UI ページでインスタンス全体のガイド付きツアーを実行できるようにします。

    タスクの結果

    標準プラットフォーム UI 要素と、 サービスポータル ページ上のカスタム UI 要素を参照するツアーの両方を参照するガイド付きツアーを作成、更新、および再生できます。ユーザーはこれらのツアーをプレイできます。

    次のタスク

    ガイド付きツアーの計画、概要説明、およびドラフトの作成を開始します。ガイド付きツアー サービスポータル ドラフトを作成している場合は、次の項目を参照してください。
    アイテム 詳細
    ガイド付きツアーの吹き出し手順 ガイド付きツアーは、要素に吹き出しステップを作成した後にその要素を見つけることができるように、指し示すすべての要素を認識できる必要があります。したがって、サービスポータルページの作成者は、作成するすべてのカスタム要素に、データベース内のレコードとしての検証に役立つ一意の名前を付ける必要があります。たとえば、サービスポータルページに 2 つのウィジェットを作成する場合は、Widget1 や Widget2 などの一意の名前を割り当てる必要があります。

    HTML に追加の属性を追加し、プロパティに一意の値を追加することで、要素をさらにカスタマイズできます。たとえば、システムでは現在、 data-gtd-eid 属性と data-id 属性を使用して要素を一意として識別します。

    サービスポータル ページ

    ベースシステムでは、SP ヘッダーメニューを使用するページからのみツアーを起動できます。手動で起動したチュートリアルは、カスタムヘッダーメニューのあるページには表示されません。

    ガイド付きツアーが SP ヘッダーメニューを使用しない サービスポータル ページにある場合は、ツアーがユーザーに表示されるように自動起動用に構成する必要があります。このタイプのツアーがユーザーに表示されるようにするには、「 ガイド付きツアーの自動起動を構成する」を参照してください。

    サービスポータルでページルートマップを使用している場合、ツアーが想定どおりに表示されないことがあります。たとえば、ツアーがリダイレクトされたページ用に構成されている場合、ユーザーに想定どおりにツアーが表示されないことがあります。詳しくは、 ページ ID への参照のリダイレクト を参照してください。

    サービスポータルのブランディング サービスポータルページのブランディングを更新すると、それに応じてそのページのガイド付きツアーの吹き出しも更新されます。例: サービスポータル パネルのテーマの背景色を黄色に更新し、そのプライマリ色を赤に更新します。結果:ガイド付きツアーの吹き出しパネルの背景が黄色になり、吹き出しテキストフィールドが赤色に変わります。
    サービスポータル ガイド付きツアー吹き出しの色
    ガイド付きツアーの吹き出しの色をカスタマイズするか、ガイド付きツアーのデフォルトを使用できます。
    パラメーター デフォルト カスタム
    ガイド付きツアーの吹き出しでは、次の サービスポータル プロパティを使用します。 サービスポータルの色とは独立して吹き出しの色を設定するには、次の CSS 変数を適用します。
    吹き出しの背景色 パネルの背景色 $gtd-callout-background
    吹き出しテキストの色 テキストの色 $gtd-callout-content-color
    吹き出し番号の色 (例:2/5) 控え目に示すテキスト $gtd-callout-number-color
    吹き出しの閉じるボタン (X) の色 控え目に示すテキスト $gtd-callout-close-color
    吹き出しプライマリボタンの色 プライマリーボタンの背景色 $gtd-callout-active-color