ポータルウィジェットの使用

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:5分
  • ウィジェットは、ポータルページのコンテンツを定義するものです。サービスポータル で提供されるベース システム ウィジェットを使用するか、ウィジェットのクローンを作成して変更するか、または独自のニーズに合うカスタム ウィジェットを開発することができます。

    サービスポータル Designer でページを作成または更新する場合、ウィジェットフィルターで検索してウィジェットをページにドラッグすることで、ウィジェットを簡単に追加できます。プラットフォームからすべてのウィジェットレコードにアクセスすることもできます。 すべて > サービスポータル > ウィジェット.

    ベースシステムウィジェット

    サービスポータル に含まれるベースシステムウィジェットを使用して、ポータルページの構成を開始できます。 ベースシステムウィジェットは読み取り専用であるため、将来の更新から恩恵を受けることができます。ただし、ページに追加するベースシステムウィジェットのインスタンスごとに、そのウィジェットで使用可能なインスタンスオプションを設定できます。

    ベースシステムウィジェットのリストとそのインスタンスオプションについては、 ウィジェット ライブラリを参照してください。

    ウィジェットインスタンス

    サービス ポータル デザイナーを使用してページにウィジェットを追加すると、ウィジェット インスタンスが作成されます。ウィジェットインスタンスは、そのインスタンスに固有の場所、プロパティ、 CSS を含むウィジェットへの参照です。同じページに同じウィジェットを複数回追加すると、複数のインスタンスが作成されます。

    すべてのウィジェット インスタンスは 1 つのウィジェットを示します。そのウィジェットを編集すると、そのすべてのウィジェットインスタンスもその変更を受け取ります。ウィジェットインスタンスに固有の変更を加えて、そのウィジェットインスタンスのみが影響を受けるようにすることもできます。

    たとえば、次の画像には、各インスタンスに固有の異なる構成を持つベースシステム アイコン リンク ウィジェット の 4 つのインスタンスが含まれています。

    図 : 1. アイコン リンク ウィジェット
    インスタンスごとに異なるアイコンとタイトルが表示されているサービスポータルホームページのアイコンリンクウィジェット
    注:
    デフォルトで情報を含まないウィジェットの場合、ポータル ページに表示するには、ウィジェット インスタンスのオプションを構成する必要があります。

    ウィジェット コンテキストメニュー

    レンダリングされたサービスポータルページから、ウィジェットを CTRL+右クリックすると、コンテキストメニューにその他の構成オプションが表示されます。

    たとえば、 サービスポータル > サービスポータルホーム をクリックして、サンプルポータルページを開きます。Ctrl を押しながらそのページのナレッジベースを右クリックします。

    図 : 2. ウィジェット コンテキストメニュー
    アイコンリンクウィジェットのコンテキストメニュー
    注:
    ウィジェット コンテキストメニューを表示するには、admin または sp_admin ロールが必要です。これらのいずれかのロールを持たないユーザーに偽装しても、メニューは引き続き表示されます。ただし、これらのロールなしでサインインした通常のユーザーは、メニューを表示できません。
    表 : 1. ウィジェット コンテキストメニュー オプション
    オプション 説明
    ウィジェットのパフォーマンス ウィジェットの読み込みにかかる時間です。
    インスタンス オプション ウィジェットのインスタンスを指定します。ウィジェットインスタンスのオプションは、選択したウィジェットによって異なります。たとえば、クール クロック ウィジェットのインスタンス オプションには、各インスタンスの異なるタイム ゾーンが含まれているため、同じクロックをページ上で 4 回、すべて異なるタイム ゾーンで使用することができます。
    ページ エディターのインスタンス ページ エディターでウィジェットのインスタンスを開きます。
    ページ デザイナー ウィジェットをサービス ポータル デザイナーで開きます。これにより、コンテナ、列、ウィジェットを追加することができます。サービスポータルデザイナーからウィジェットまたはウィジェットが存在するページにスタイリングを追加できます。
    ウィジェットのカスタマイズを表示 ページの問題を診断できるように、ページ上のウィジェットのカスタマイズレベルを表示します。詳細については、「ウィジェット診断」を参照してください。
    コンテナの背景を編集 ウィジェットが配置されているレイアウトを編集します。
    ウィジェットオプションスキーマ ウィジェットのインスタンスに対して選択できるオプションを定義します。独自のインスタンス オプションの設定の詳細については、「ウィジェット オプション スキーマ」を参照してください。
    ウィジェットのフォームモーダル ウィジェットフォームをポップアップウィンドウで開き、ウィジェットにすばやく変更を加えることができます。
    エディターのウィジェット ウィジェット エディターでウィジェットを開きます。ウィジェット エディターを使用して、ウィジェットの HTML テンプレート、CSS、クライアント スクリプト、サービス スクリプト、およびデモ データを設定できます。
    コンソールにログを記録:$scope.data $scope.data オブジェクトは、サーバーからクライアント側のコントローラーにデータを渡します。console.logメッセージやアラートをコントローラーコードに追加する代わりに、$scope.data オブジェクトをブラウザーコンソールに記録し、そこでデータを表示できます。
    コンソールにログを記録:$scope $scope.data オブジェクトと似ていますが、$scope のすべてをコンソールに記録する点が異なります。

    カスタムウィジェット

    ベースシステムウィジェットは読み取り専用であるため、将来の更新から恩恵を受けることができます。変更を加えるには、基本システム ウィジェットをクローンできます。ただし、クローンされたウィジェットはカスタムと見なされ、クローン元のウィジェットの将来の更新から恩恵を受けることはありません。 ウィジェットを最初から作成することもできます。ウィジェットのクローン作成または作成の詳細については、「カスタムウィジェットの開発」を参照してください。