---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

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

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

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

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

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

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

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

### 始める前に

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

### 手順

1. 移動先 すべてシステムの拡張点UI の拡張ポイント.
2. UI 拡張ポイント \[sys_ui_extension-point\] テーブルで、カスタム UI マクロを登録する拡張ポイントを選択します。  
   注:  
   このリストには、作成した UI 拡張ポイントと、Now Platform 機能 (カスタマーサービス管理 (CSM) や フィールドサービス管理 (FSM)) に埋め込まれた事前定義済みの UI 拡張ポイントが含まれます。

   事前定義済みの拡張ポイントを含む機能の詳細については、[拡張ポイントを使用してアプリケーション機能を拡張する](https://servicenow-prod.fluidtopics.net/3tYjfUPEr40jR3jBpM3xrQ "拡張ポイントを使用して、元のアプリケーションコードを変更せずにアプリケーションの機能を拡張します。選択した Now Platform アプリケーションで使用可能な既存の拡張ポイントを使用できます。また、自分のインスタンスでカスタムアプリケーションを開発する場合は、拡張ポイントを追加できます。") の関連トピックのリンクを参照してください。
3. UI 拡張ポイントレコードで、\[実装を作成\] 関連リンクをクリックして新しいカスタム UI マクロを作成し、選択した UI 拡張ポイントに登録します。
4. UI マクロフォームで、カスタムコードを作成します。  
   UI マクロの作成の詳細については、「[UI マクロ](https://servicenow-prod.fluidtopics.net/SDbTtd8ZzXr9cfP3Pv3NlQ#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=xanadu&pubname=xanadu-application-development&ft:locale=en-US)」および「[委託開発と展開](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-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/SDbTtd8ZzXr9cfP3Pv3NlQ#c_UIMacros "UI マクロは、アドミニストレーターがユーザーインターフェイスに追加できる個別のスクリプト化されたコンポーネントです。")
* [拡張ポイントを使用してアプリケーション機能を拡張する](https://servicenow-prod.fluidtopics.net/3tYjfUPEr40jR3jBpM3xrQ "拡張ポイントを使用して、元のアプリケーションコードを変更せずにアプリケーションの機能を拡張します。選択した Now Platform アプリケーションで使用可能な既存の拡張ポイントを使用できます。また、自分のインスタンスでカスタムアプリケーションを開発する場合は、拡張ポイントを追加できます。")