--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Enregistrer des macros d'interface utilisateur personnalisées par rapport aux points d'extension d'interface utilisateur # Enregistrer des macros d'interface utilisateur personnalisées par rapport aux points d'extension d'interface utilisateur {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture Enregistrez les macros d'interface utilisateur personnalisées par rapport à un point d'extension d'interface utilisateur sélectionné dans le code d'application. En inscrivant des macros d'interface utilisateur personnalisées, vous créez un enregistrement d'instance d'extension qui relie la définition du point d'extension d'interface utilisateur à son implémentation dans la macro d'interface utilisateur personnalisée. ## Enregistrer une macro d'interface utilisateur personnalisée {#ariaid-title2} Créez une macro d'interface utilisateur personnalisée et codez-la lorsque vous l'inscrivez par rapport à un point d'extension d'interface utilisateur sélectionné. ### Avant de commencer Rôle requis : développeur spécifique à l'application, administrateur spécifique à l'application ou admin Remarque : Pour en savoir plus sur les rôles d'administrateur spécifiques aux applications et le développement délégué, consultez [Règles de contrôle d'accès dans les applications d'administration d'application](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) et [Développement délégué et déploiement](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). ### Procédure 1. Accédez à la ToutPoints d'extension systèmePoints d'extension d'interface utilisateur. 2. Dans la table Point d'extension d'interface utilisateur \[sys_ui_extension-point\], sélectionnez le point d'extension par rapport auquel vous souhaitez enregistrer une macro d'interface utilisateur personnalisée. Remarque : Cette liste inclut les points d'extension d'interface utilisateur que vous avez créés et tous les points d'extension d'interface utilisateur prédéfinis incorporés dans Now Platform les fonctions (par exemple, Gestion du service clientèle et Gestion des services sur site). Pour en savoir plus sur les fonctions qui contiennent des points d'extension prédéfinis, reportez-vous aux liens Rubriques connexes de la section [Utilisation de points d'extension pour étendre les fonctionnalités de l'application](https://servicenow-prod.fluidtopics.net/0wDcVZnGhtozUm870D~ecA "Utilisez des points d’extension pour étendre les fonctionnalités d’une application sans modifier le code d’application d’origine. Vous pouvez utiliser des points d’extension préexistants disponibles dans les applications sélectionnées Now Platform , ou vous pouvez ajouter des points d’extension lorsque vous développez des applications personnalisées dans votre propre instance."). 3. Dans l'enregistrement du point d'extension d'interface utilisateur, cliquez sur le lien connexe Créer une implémentation pour créer une macro d'interface utilisateur personnalisée et l'enregistrer par rapport au point d'extension d'interface utilisateur sélectionné. 4. Dans le formulaire Macro d'interface utilisateur, créez le code personnalisé. Pour en savoir plus sur la création de macros d'interface utilisateur, reportez-vous à la section [Macros d'interface utilisateur](https://servicenow-prod.fluidtopics.net/f7JQ0eK1ge1upDu5SGB4fg#c_UIMacros "Les macros d'interface utilisateur sont des composants scriptés discrets que les administrateurs peuvent ajouter à l'interface utilisateur."). 5. Cliquez sur Mettre à jour. {#register-custom-ui-macros-ui-ext-pt__steps_tkt_jtq_qfb} ### Résultats La macro d'interface utilisateur personnalisée est créée et enregistrée par rapport au point d'extension d'interface utilisateur. ## Examiner les instances d'extension d'interface utilisateur {#ariaid-title3} Passez en revue la liste des macros d'interface utilisateur personnalisées enregistrées par rapport à un point d'extension d'interface utilisateur. Les instances d'extension indiquent le périmètre de l'application dans lequel les macros d'interface utilisateur personnalisées enregistrées sont utilisées et fournissent un lien vers chacune d'elles. Vous pouvez également activer ou désactiver une instance d'extension. ### Avant de commencer Rôle requis : admin ou le rôle spécifique du développeur ou de l'administrateur de l'application Remarque : Pour en savoir plus sur les rôles d'administrateur spécifiques aux applications et le développement délégué, consultez [Règles de contrôle d'accès dans les applications d'administration d'application](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) et [Développement délégué et déploiement](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). ### Procédure 1. Accédez à la ToutPoints d'extension systèmePoints d'extension d'interface utilisateur. 2. Dans la table Point d'extension d'interface utilisateur \[sys_ui_extension_point\], sélectionnez le point d'extension d'interface utilisateur pour lequel vous souhaitez afficher les instances étendues. 3. Dans la liste connexe Implémentations de l'enregistrement Point d'extension d'interface utilisateur, sélectionnez une instance d'extension d'interface utilisateur. Le système affiche l'enregistrement de l'instance d'extension d'interface utilisateur.{#review-ui-extension-instances__table_r32_ytq_qfb__entry__2} | Champ | Description | |-|-| | Point | Nom unique pour le point d'extension d'interface utilisateur. Le nom peut comporter jusqu'à 100 caractères alphanumériques, y compris les caractères spéciaux. | | Classe | Macro d'interface utilisateur dans le code de l'application dans laquelle le point d'extension d'interface utilisateur est implémenté. | | Application | Périmètre de l'application par rapport auquel le point d'extension est affecté. Ceci est affecté par le système et ne peut pas être modifié. Pour en savoir plus sur les protections offertes par l'utilisation de la définition du champ d'application, reportez-vous à la section [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). | | Actifs | Point d'extension actif dans l'instance actuelle. Pour désactiver un point d'extension, décochez la case. | [Tableau 1. Enregistrement d'instance d'extension d'interface utilisateur] {#review-ui-extension-instances__table_r32_ytq_qfb} 4. Cliquez sur Envoyer. {#review-ui-extension-instances__steps_q32_ytq_qfb} **Concepts associés** * [Macros d'interface utilisateur](https://servicenow-prod.fluidtopics.net/f7JQ0eK1ge1upDu5SGB4fg#c_UIMacros "Les macros d'interface utilisateur sont des composants scriptés discrets que les administrateurs peuvent ajouter à l'interface utilisateur.") * [Utilisation de points d'extension pour étendre les fonctionnalités de l'application](https://servicenow-prod.fluidtopics.net/0wDcVZnGhtozUm870D~ecA "Utilisez des points d’extension pour étendre les fonctionnalités d’une application sans modifier le code d’application d’origine. Vous pouvez utiliser des points d’extension préexistants disponibles dans les applications sélectionnées Now Platform , ou vous pouvez ajouter des points d’extension lorsque vous développez des applications personnalisées dans votre propre instance.")