UI 拡張ポイントの作成と追加

アプリケーションを開発する場合は、UI 拡張ポイントを作成して、基本アプリケーションコード内のサーバー側 HTML 拡張などの UI マクロまたは UI ページに追加します。

UI スクリプト拡張ポイントを使用して、データまたはオブジェクトを登録済みのカスタム UI マクロに送信でき、返された結果を処理する特定の場所を指定します。

UI 拡張ポイントの作成

アプリケーションコード内で、HTML 拡張などの UI マクロに配置できる UI 拡張ポイントを作成します。UI 拡張ポイントを配置することで、データまたはオブジェクトをカスタマイズに送信可能でデータが返されるポイントになる、アプリケーションコード内の特定の場所を指定します。

始める前に

必要なロール：admin、またはアプリケーションの開発者またはアドミニストレーター向けの特定のロール

注:

アプリケーション固有のアドミンロールと委託開発については、「アプリケーション管理アプリのアクセス制御ルール」および「委託開発と展開」を参照してください。

このタスクについて

定義 拡張ポイントのコンテンツと構造。この定義では、カスタマイズの構成方法、アプリケーションコードとのやり取りの方法、および拡張ポイントでカスタマイズによって返されるデータを処理する方法について説明します。

適切な定義を作成することによって、拡張の機能の構造を指定できます。

手順

1. 移動先 すべて > システムの拡張点 > UI の拡張ポイント.
2. [新規] をクリックします。
3. フォームのフィールドに入力します。

   表 : 1. UI 拡張ポイントのフォーム

   フィールド	説明
   名前	拡張ポイントの一意の名前。名前は最長 100 文字の英数字 (特殊文字を含む) です。
   API 名	拡張ポイント API の名前。適用先のアプリケーションスコープが先頭に付加されます。これはシステムによって割り当てられた名前であり、変更することはできません。
   アプリケーション	拡張ポイントがアサインされているアプリケーションスコープ。これはシステムによって割り当てられ、変更することはできません。スコーピングを使用することで提供される保護の詳細については、「Application scope」を参照してください。
   このスコープに制限	拡張ポイントをアプリケーションスコープのみに制限するためのオプション。
   AJAX/REST 経由のアクセスを許可	AJAX または REST を介した UI 拡張ポイントへのアクセスを有効または無効にするためのオプション。 これらの開発アーキテクチャとテクニックの詳細については、「AJAX」と「REST API」を参照してください。
   説明	カスタムスクリプトの要件 UI マクロ、 UI スクリプトの構成方法やアプリケーションコードでの動作方法などが含まれます。
   例	カスタム UI マクロの例 この拡張ポイントとやり取りする場合は、アプリケーションコードで動作するように構成する必要があります。

4. [送信] をクリックします。

基本アプリケーションコードに UI 拡張ポイントを追加する

基本アプリケーションコードの UI マクロまたは HTML 拡張に UI 拡張ポイントを追加します。拡張ポイントを追加するには、登録されたカスタムアーティファクトが実行される場所を特定する API コールを配置します。

始める前に

必要なロール：admin、またはアプリケーションの開発者またはアドミニストレーター向けの特定のロール

アプリケーションコードに UI マクロまたは UI ページを追加する前に、UI 拡張ポイントを作成する必要があります。

注:

アプリケーション固有のアドミンロールと委託開発については、「アプリケーション管理アプリのアクセス制御ルール」および「委託開発と展開」を参照してください。

手順

1. アプリケーションコードで、スクリプト拡張ポイントを追加する既存の UI マクロにアクセスするか、新しい UI マクロを作成します。
   Jelly タグを使用した UI マクロの作成の詳細については、「UI マクロ」と「Jelly のタグ」を参照してください。
2. UI マクロで、カスタム UI マクロ出力を収集して処理する予定の場所に jelly タグとコード行を追加します。
   通常、このコード行には以下が含まれます。

   • カスタム UI マクロが登録されている UI 拡張ポイントの名前を特定する call_extension コマンド (例：extension="global.KMArticle.ViewHeader")。
   • レンダリング時に UI マクロに渡される引数。たとえば、ナレッジベース記事では、knowledgerecord="${knowledgeRecord}"は、現在のナレッジレコードを渡します。
   • (オプション) この拡張ポイントの実装が複数ある場合は、limit コマンドを使用して、x 個の実装を返すように指定します (例：limit="1")。この図は、これらのコマンドを含む UI マクロを示しています。