---
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 マクロの登録

# UI 拡張ポイントに対するカスタム UI マクロの登録 {#ariaid-title1}

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

カスタム UI マクロをアプリケーションコード内の選択した UI 拡張ポイントに対して登録します。

カスタム UI マクロを登録することで、UI 拡張ポイント定義をカスタム UI マクロでの実装にリンクする拡張インスタンスレコードを作成します。

## カスタム UI マクロの登録 {#ariaid-title2}

選択した UI 拡張ポイントに対して登録するときにカスタム UI マクロとコードを作成します。

### 始める前に

必要なロール:アプリケーション固有の developer、application-specific admin、または 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. UI 拡張ポイント \[sys_ui_extension-point\] テーブルで、カスタム UI マクロを登録する拡張ポイントを選択します。  
   注:  
   このリストには、作成した UI 拡張ポイントと、 ServiceNow AI Platform 機能 ( カスタマーサービス管理 (CSM) や フィールドサービス管理 (FSM) など) に埋め込まれている事前定義された UI 拡張ポイントが含まれています。

   事前定義された拡張ポイントを含む関数の詳細については、 [拡張ポイントを使用してアプリケーション機能を拡張する](https://servicenow-prod.fluidtopics.net/G87TESYnVG~l0kK52ieKZg "拡張ポイントを使用して、元のアプリケーションコードを変更せずにアプリケーションの機能を拡張します。選択した ServiceNow AI Platform アプリケーションで利用可能な既存の拡張ポイントを使用することも、独自のインスタンスでカスタムアプリケーションを開発するときに拡張ポイントを追加することもできます。")の「関連トピック」リンクを参照してください。
3. UI 拡張ポイントレコードで、\[ 実装を作成 \] 関連リンクをクリックして新しいカスタム UI マクロを作成し、選択した UI 拡張ポイントに対して登録します。
4. \[UI マクロ\] フォームで、カスタムコードを作成します。  
   UI マクロの作成の詳細については、「 [UI マクロ](https://servicenow-prod.fluidtopics.net/Mr675lXi8W2G5FeUekvQUQ#c_UIMacros "UI マクロは、アドミニストレーターがユーザーインターフェイスに追加できる個別のスクリプト化されたコンポーネントです。")」を参照してください。
5. \[更新\] をクリックします。
{#register-custom-ui-macros-ui-ext-pt__steps_tkt_jtq_qfb}

### タスクの結果

カスタム UI マクロが作成され、UI 拡張ポイントに対して登録されます。

## UI 拡張インスタンスの確認 {#ariaid-title3}

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. UI 拡張ポイント \[sys_ui_extension_point\] テーブルで、広範なインスタンスを表示する UI 拡張ポイントを選択します。
3. UI 拡張ポイントレコードの \[実装\] 関連リストで、UI 拡張インスタンスを選択します。  
   UI 拡張インスタンスレコードが表示されます。{#review-ui-extension-instances__table_r32_ytq_qfb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | ポイント | UI 拡張ポイントの一意の名前。名前には、特殊文字を含む最大 100 文字の英数字を含めることができます。 |
   | クラス | UI 拡張ポイントが実装されているアプリケーションコード内の UI マクロ。 |
   | アプリケーション | 拡張ポイントがアサインされているアプリケーションスコープ。これはシステムによって割り当てられ、変更することはできません。スコーピングを使用することで提供される保護の詳細については、「[Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=australia&pubname=australia-application-development&ft:locale=en-US)」を参照してください。 |
   | アクティブ | 現在のインスタンスのアクティブな拡張ポイント。拡張ポイントを非アクティブ化するには、チェックボックスをオフにします。 |
   [表 : 1. UI 拡張インスタンスレコード]

   {#review-ui-extension-instances__table_r32_ytq_qfb}
4. \[送信\] をクリックします。
{#review-ui-extension-instances__steps_q32_ytq_qfb}
**関連概念**   

* [UI マクロ](https://servicenow-prod.fluidtopics.net/Mr675lXi8W2G5FeUekvQUQ#c_UIMacros "UI マクロは、アドミニストレーターがユーザーインターフェイスに追加できる個別のスクリプト化されたコンポーネントです。")
* [拡張ポイントを使用してアプリケーション機能を拡張する](https://servicenow-prod.fluidtopics.net/G87TESYnVG~l0kK52ieKZg "拡張ポイントを使用して、元のアプリケーションコードを変更せずにアプリケーションの機能を拡張します。選択した ServiceNow AI Platform アプリケーションで利用可能な既存の拡張ポイントを使用することも、独自のインスタンスでカスタムアプリケーションを開発するときに拡張ポイントを追加することもできます。")