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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    カスタムウィジェット

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