---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

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

# UI 拡張ポイントの作成と追加 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

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

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

## UI 拡張ポイントの作成 {#ariaid-title2}

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

### 始める前に

必要なロール：admin、またはアプリケーションの開発者またはアドミニストレーター向けの特定のロール  
注:  
アプリケーション固有のアドミンロールと委託開発については、「[アプリケーション管理アプリのアクセス制御ルール](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=australia&pubname=australia-application-development&ft:locale=en-US)」および「[委託開発と展開](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=australia&pubname=australia-application-development&ft:locale=en-US)」を参照してください。

### このタスクについて

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

適切な定義を作成することで、拡張の機能の構造を提供できます。

### 手順

1. 移動先 すべてシステム拡張ポイントUI 拡張ポイント.
2. \[New\] をクリックします。
3. フォームのフィールドに入力します。  
   {#create-ui-ext-pt__table_tqn_cfv_s1b__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | 拡張ポイントの一意の名前。名前は最長 100 文字の英数字 (特殊文字を含む) です。 |
   | API 名 | 拡張ポイント API の名前。適用先のアプリケーションスコープが先頭に付加されます。これはシステムによって割り当てられた名前であり、変更することはできません。 |
   | アプリケーション | 拡張ポイントがアサインされているアプリケーションスコープ。これはシステムによって割り当てられ、変更することはできません。スコーピングを使用することで提供される保護の詳細については、「[Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=australia&pubname=australia-application-development&ft:locale=en-US)」を参照してください。 |
   | このスコープに制限 | 拡張ポイントをアプリケーションスコープのみに制限するためのオプション。 |
   | AJAX/REST 経由のアクセスを許可 | AJAX または REST を介した UI 拡張ポイントへのアクセスを有効または無効にするためのオプション。 これらの開発アーキテクチャと手法の詳細については、「 [AJAX](https://servicenow-prod.fluidtopics.net/82ANTS2mB_w5JMwoFO0zVw#p_AJAX "AJAX (非同期 JavaScript および XML) は、非同期 Web アプリケーションの作成に使用される、相互に関連するクライアントサイド開発手法の集まりです。") と [REST API](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 |
   | 説明 | カスタムスクリプトの要件 UI マクロ、 UI スクリプトの構成方法やアプリケーションコードでの動作方法などが含まれます。 |
   | 例 | カスタム UI マクロの例 この拡張ポイントとやり取りする場合は、アプリケーションコードで動作するように構成する必要があります。 |
   [表 : 1. UI 拡張ポイントフォーム]

   {#create-ui-ext-pt__table_tqn_cfv_s1b}
4. \[送信\] をクリックします。
{#create-ui-ext-pt__steps_mfs_mgn_pdb}

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

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

### 始める前に

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

アプリケーションコードで UI マクロまたは UI ページに追加する前に、まず UI 拡張ポイントを作成する必要があります。  
注:  
アプリケーション固有のアドミンロールと委託開発については、「[アプリケーション管理アプリのアクセス制御ルール](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=australia&pubname=australia-application-development&ft:locale=en-US)」および「[委託開発と展開](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=australia&pubname=australia-application-development&ft:locale=en-US)」を参照してください。

### 手順

1. アプリケーションコードで、スクリプト拡張ポイントを追加する既存の UI マクロにアクセスするか、新しい UI マクロを作成します。  
   jelly タグを使用した UI マクロの作成の詳細については、「 [UI マクロ](https://servicenow-prod.fluidtopics.net/Mr675lXi8W2G5FeUekvQUQ#c_UIMacros "UI マクロは、アドミニストレーターがユーザーインターフェイスに追加できる個別のスクリプト化されたコンポーネントです。") と [Jelly のタグ](https://servicenow-prod.fluidtopics.net/q1uCncxG1~cGILzWcTn0sQ "Jelly を使用して XML を HTML に変換します。")」を参照してください。
2. UI マクロで、カスタム UI マクロ出力を収集して処理する場所にコード行を含む jelly タグを追加します。  
   通常、このコード行には次のものが含まれます。
   * UI 拡張ポイントの名前を識別する `call_extension` コマンド ( `例:extension="global.KMArticle.ViewHeader"`) で、カスタム UI マクロが登録されます。
   * レンダリング時に UI マクロに渡される引数。たとえば、 ナレッジベース 記事の場合、 `knowledgerecord="${knowledgeRecord}"` は現在のナレッジレコードを渡します。{#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb}
   {#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb}
   * (オプション)この拡張ポイントの実装が複数ある場合、 `limit` コマンドを使用して、x 個の実装を返すように指定します ( `たとえば、limit="1"`)。この図は、これらのコマンドを含む UI マクロを示しています。

   {#add-ui-ext-pt-base-ui-macro__ul_gxz_4zv_bgb}

{#add-ui-ext-pt-base-ui-macro__steps_mfs_mgn_pdb}