---
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


---

# Utilisation de points d'extension pour étendre les fonctionnalités de l'application

# Utilisation de points d'extension pour étendre les fonctionnalités de l'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 minutes de lecture

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.

## Utilisation de points d'extension {#extension-points__section_blc_wft_pdb}

En utilisant des points d'extension, vous pouvez intégrer des personnalisations sans modifier les composants de base du code d'application. Les points d'extension peuvent empêcher l'interruption des interactions de votre code personnalisé, ce qui se produit souvent après une mise à niveau si vous intégrez directement le code personnalisé dans le code de l'application.

Les points d'extension incorporés dans le code d'application agissent comme des points de sortie, où les données sont transmises au code personnalisé, et comme des points d'entrée qui gèrent les résultats renvoyés. Lors de la création d'une application, les données ou objets renvoyés doivent être conformes aux exigences que vous définissez pour le point d'extension.  
Remarque :  
Certaines règles de requête CSM configurées prêtes à l'emploi ne peuvent pas être modifiées ou désactivées, car elles sont également utilisées dans les constantes au sein d'une règle métier.

## Types de points d'extension {#extension-points__section_zm3_dvf_kgb}

Vous pouvez créer des points d'extension pour traiter le code personnalisé qui utilise les types d'artefacts suivants :

Points d'extension scriptés
:   Points d'extension dans les includes de script côté serveur qui stockent des fonctions JavaScript et des classes d'objets. Pour en savoir plus sur les scripts includes et sur la façon d'implémenter des points d'extension scriptés dans l'application et le code personnalisé, consultez :  
    * [Includes de script](https://servicenow-prod.fluidtopics.net/qDjWQH0TxlE89Qumy06mqg#c_ScriptIncludes "Les includes de script sont utilisés pour stocker le code JavaScript qui s’exécute sur le serveur.")
    * [Création et ajout d'un point d'extension scripté](https://servicenow-prod.fluidtopics.net/aW_XnLJSHxN2BlEKyPKChg "Lors du développement d’une application, créez des points d’extension scriptés et ajoutez-les aux includes de script dans le code de l’application. Utilisez un point d’extension scripté pour désigner l’emplacement spécifique où des données ou des objets peuvent être envoyés à un include de script personnalisé enregistré et où les résultats renvoyés sont traités.")
    * [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.")
    {#extension-points__ul_vr2_kyc_cgb}

Points d'extension d'interface utilisateur

:   Points d'extension utilisés dans les macros d'interface utilisateur côté serveur telles que les extensions HTML. Les macros d'interface utilisateur sont des composants scriptés discrets que vous pouvez ajouter à l'interface utilisateur. Vous les utilisez pour ajouter du contenu personnalisé à une page d'interface utilisateur, sans avoir à modifier directement la page. Par exemple, vous pouvez utiliser des macros d'interface utilisateur pour ajouter des en-têtes et des pieds de page à la page d'interface utilisateur d'affichage (kb_view) standard Base de connaissances dans laquelle apparaissent les articles de la base de connaissances.

    Pour en savoir plus sur les macros d'interface utilisateur et sur l'implémentation de points d'extension d'interface utilisateur dans l'application et le code personnalisé, consultez :

    * [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.")
    * [Création et ajout d'un point d'extension d'interface utilisateur](https://servicenow-prod.fluidtopics.net/pFgLwx9ggYkx2eG49lRARQ#impl-ui-ext-pts-base-code "Lors du développement d’une application, créez des points d’extension d’interface utilisateur et ajoutez-les aux macros d’interface utilisateur côté serveur, telles que les extensions HTML, ou aux pages de l’interface utilisateur dans le code de base de l’application.")
    * [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.")
    {#extension-points__ul_csp_ncd_cgb}

Points d'extension client

:   Points d'extension utilisés dans les scripts d'interface utilisateur côté client, généralement pour modifier des formulaires. Les scripts d'interface utilisateur vous permettent de conditionner JavaScript côté client dans un formulaire réutilisable, similaire à la façon dont les includes de script stockent JavaScript côté serveur. Vous pouvez créer des scripts d'interface utilisateur et les exécuter à partir de scripts clients, d'autres objets de script côté client et du code HTML.

    Pour en savoir plus sur les scripts d'interface utilisateur et sur l'implémentation de points d'extension client dans le code d'application et personnalisé, consultez :

    * [Scripts d'interface utilisateur](https://servicenow-prod.fluidtopics.net/Rl4Y5vO6npC5ps_~vJY2~g#c_UIScripts "Les scripts d’interface utilisateur fournissent un moyen de conditionner JavaScript côté client dans un formulaire réutilisable, de la même manière que les includes de script stockent JavaScript côté serveur. Les administrateurs peuvent créer des scripts d’interface utilisateur et les exécuter à partir de scripts clients et d’autres objets de script côté client, ainsi qu’à partir du code HTML.")
    * [Création et ajout d'un point d'extension client](https://servicenow-prod.fluidtopics.net/CaYmvXwXF6BhF6WfrBqjNQ "Créez des points d’extension clients et ajoutez-les aux scripts d’interface utilisateur côté client dans le code de base de l’application.")
    * [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.")
    {#extension-points__ul_yvg_rcd_cgb}

Lorsque vous utilisez des points d'extension pour traiter des personnalisations, vous créez une structure définie pour intégrer des données ou des fonctionnalités personnalisées dans une application. Les includes de script côté serveur personnalisés, les macros d'interface utilisateur telles que les extensions HTML et les scripts d'interface utilisateur côté client sont tous externes au code d'application et n'interagissent avec lui qu'aux points d'extension spécifiés.

## Code d'application {#extension-points__section_a2j_wgy_xgb}

Le terme code d'application fait référence à :

Code d'application standard
:   Code d'application standard, ou de base, qui comprend le Now Platformfichier .  
    Des points d'extension prédéfinis sont déjà intégrés dans certaines applications, telles que Gestion du service clientèle et Gestion des services sur site. Pour en savoir plus sur les Now Platform applications qui contiennent des points d'extension prédéfinis, consultez les rubriques suivantes :{#extension-points__table_qqv_xzh_zgb__entry__2}

    | Application | Rubrique du point d'extension |
    |-|-|
    | Coaching | [Dépannage de Coaching](https://www.servicenow.com/docs/access?context=coaching-troubleshooting&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US) |
    | Gestion de l'amélioration continue | [Amélioration avec d'autres applications](https://www.servicenow.com/docs/access?context=cim-integration&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US) |
    | Gestion du service clientèle | [Points d'extension dans Customer Service Management](https://www.servicenow.com/docs/access?context=extension-points-customer-service&version=xanadu&pubname=xanadu-customer-service-management&ft:locale=en-US) |
    | Gestion du service clientèle | [Création de rôles d'utilisateurs personnalisés](https://www.servicenow.com/docs/access?context=creating-custom-csm-user-roles&version=xanadu&pubname=xanadu-customer-service-management&ft:locale=en-US) |
    | Gestion du service clientèle | [Intégration de CSM à Change Management](https://www.servicenow.com/docs/access?context=csm-integration-sm-change&version=xanadu&pubname=xanadu-customer-service-management&ft:locale=en-US) |
    | Gestion du service clientèle | [Intégration de CSM à Incident Management](https://www.servicenow.com/docs/access?context=csm-integration-sm-incident&version=xanadu&pubname=xanadu-customer-service-management&ft:locale=en-US) |
    | Gestion du service clientèle | [Intégration de CSM à Problem Management](https://www.servicenow.com/docs/access?context=csm-integration-sm-problem&version=xanadu&pubname=xanadu-customer-service-management&ft:locale=en-US) |
    | Gestion du service clientèle | [Intégration de CSM à Request Management](https://www.servicenow.com/docs/access?context=csm-integration-sm-request&version=xanadu&pubname=xanadu-customer-service-management&ft:locale=en-US) |
    | Gestion des services sur site | [Points d'extension dans Field Service Management](https://www.servicenow.com/docs/access?context=extension-points-field-service&version=xanadu&pubname=xanadu-field-service-management&ft:locale=en-US) |
    | Gestion des connaissances | [Utiliser des points d'extension pour Gestion des connaissances](https://www.servicenow.com/docs/access?context=extension-points-km-plugins&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) |
    | Orchestration | [Réseau d'extension de distribution de logiciel client](https://www.servicenow.com/docs/access?context=c_CSDExtensionFramework&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) [Installé avec Distribution de logiciel client](https://www.servicenow.com/docs/access?context=r_IWClientSWDist&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) |
    | Réinitialisation du mot de passe | [Includes de script de réinitialisation du mot de passe](https://www.servicenow.com/docs/access?context=c_InstalledPasswordResetScripts&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) |
    [ ]

    {#extension-points__table_qqv_xzh_zgb}

Applications personnalisées développées en interne pour votre entreprise
:   Vous pouvez ajouter des points d'extension pour gérer l'enregistrement d'artefacts personnalisés qui sont utilisés pour modifier ou étendre les fonctionnalités d'une application. Lorsque les développeurs créent du code personnalisé, ils enregistrent ou associent des artefacts personnalisés spécifiques à des points d'extension spécifiques. L'ajout de points d'extension permet l'intégration de personnalisations futures sans avoir à modifier votre code de base.

## Création d'un point d'extension dans le code de l'application {#extension-points__section_mf1_3pg_sdb}

Vous voulez vous assurer que les applications développées en interne que vous créez pour votre entreprise peuvent être correctement personnalisées, combinées et mises à niveau selon les besoins. Les points d'extension vous permettent de modifier la fonctionnalité et l'interface utilisateur d'une application sans modifier ses composants principaux. L'utilisation de points d'extension crée également une structure très définie pour les extensions de fonctionnalités.  
Lorsque vous créez un point d'extension, vous pouvez restreindre son utilisation au périmètre de l'application dans lequel il est défini ou spécifier que le point d'extension peut s'exécuter dans tous les périmètres globalement. Si le périmètre de l'application est restreint, les personnalisations enregistrées par rapport au point d'extension ne peuvent s'exécuter que dans le périmètre de l'application désigné. Avant de concevoir et de construire une application qui inclut des points d'extension, vous devez :

* Identifiez où placer les points d'extension dans le code d'application pour accueillir des includes de script personnalisés, des macros d'interface utilisateur ou des scripts d'interface utilisateur.
* Déterminer Le contenu et la structure d'un point d'extension. Cette définition doit décrire la manière dont une personnalisation doit être structurée, la manière dont elle interagit avec le code d'application et la manière dont les données retournées par une personnalisation au niveau du point d'extension sont traitées.
{#extension-points__ul_mz5_1hj_vdb}  
Pour créer des points d'extension et les intégrer dans le code de l'application, effectuez les tâches suivantes :

1. Créez un point d'extension et définissez son interface personnalisée. Il s'agit d'un exemple de point d'extension scripté.

2. Désignez des emplacements spécifiques dans le code d'application où des données ou des objets peuvent être envoyés à une personnalisation et où les données sont renvoyées.
3. Créez un artefact, tel qu'un include de script, une macro d'interface utilisateur ou un script d'interface utilisateur, qui appelle la [GlideScriptedExtensionPoint : inclus dans le champ d'application](https://servicenow-prod.fluidtopics.net/MoEKunNkVTOKgzB0H0n7TA#GlideScriptedExtPtScopedAPI "L’API GlideScriptedExtensionPoint fournit une méthode qui renvoie les instances d’extension associées à un point d’extension spécifié.") méthode. Cette méthode identifie le point d'extension auquel les artefacts personnalisés enregistrés s'exécutent dans le code d'application.

{#extension-points__ol_ffm_c2g_pfb}

## Activation du débogage et de la journalisation {#extension-points__section_h5t_gty_xgb}

Lorsque vous créez un point d'extension, vous devez également activer le débogage et la connexion. Le débogage et la journalisation vous aident à identifier et à résoudre les problèmes liés à l'utilisation d'artefacts personnalisés avec un point d'extension. Lorsque vous activez le débogueur, vous pouvez définir des points d'arrêt dans les includes de script, les macros d'interface utilisateur ou les scripts d'interface utilisateur. Vous pouvez consulter les journaux pour voir les détails suivants :

* Lorsqu'un point d'extension trouve des instances d'extension actives, y compris le nombre total d'instances d'extension trouvées et l'heure à laquelle chaque instance d'extension a été trouvée.
* Lorsqu'un point d'extension exécute des instances d'extension, y compris le nombre total d'artefacts personnalisés exécutés et l'heure de chaque exécution. Il inclut également le nombre total d'échecs d'exécution et l'heure à laquelle chaque instance d'extension a échoué.

{#extension-points__ul_wj3_vmr_rdb}  
Remarque :  
Pour en savoir plus sur l'activation du débogage et son fonctionnement, consultez :

* [Débogueur de script et Journal de la session](https://servicenow-prod.fluidtopics.net/ZRhqgLeWABipRT2zijJLpg "Permet aux Débogueur de script utilisateurs ayant le rôle script_debugger de déboguer JavaScript côté serveur. Les utilisateurs disposant du rôle log_debugger peuvent utiliser le Journal de la session pour afficher et télécharger les journaux requis.")
* [Débogage des applications](https://servicenow-prod.fluidtopics.net/zsqrdrXEv0HjDjA5brtsCg#c_DebuggingApplications "Les développeurs d’applications peuvent afficher des messages de débogage sur les enregistrements de configuration pour les aider à résoudre les problèmes. Le module Champs d’application du débogage fournit des informations sur le système qui passe d’une application personnalisée à l’autre pour exécuter des scripts côté serveur.")
* [Écrire dans le journal des débogages](https://servicenow-prod.fluidtopics.net/mFEqgN3nNqfdg_a~pjRAYA#c_WritingToTheDebugLog "Pour écrire dans le journal de débogage de votre JavaScript côté client, ou de vos stratégies d’interface utilisateur, faites un appel à la fonction globale jslog().")
{#extension-points__ul_rzj_psy_xgb}

## Enregistrement d'un artefact personnalisé par rapport à un point d'extension {#extension-points__section_up3_thj_vdb}

Lorsque vous personnalisez une application, vous étendez la fonctionnalité de base en utilisant des artefacts personnalisés, tels que des includes de script côté serveur, des macros d'interface utilisateur ou des scripts d'interface utilisateur côté client. Pour concevoir et construire des artefacts personnalisés, effectuez les tâches suivantes :  
1. Passez en revue la liste des points d'extension disponibles qui sont appropriés au type spécifique d'artefact personnalisé que vous créez.
   * Ces listes incluent les points d'extension que vous avez créés et tous les points d'extension prédéfinis incorporés dans les Now Platform fonctions.
   * Chaque liste comprend des informations sur un point d'extension dans le code d'application qui appelle un artefact personnalisé et sur les données ou objets qui doivent lui être renvoyés.
   {#extension-points__ul_wsn_hxf_kgb}
2. Sélectionnez un point d'extension.
3. Déterminez comment structurer l'artefact personnalisé. La structure doit être basée sur les descriptions des points d'extension. Les descriptions incluent les exigences relatives à l'utilisation de l'artefact avec le code personnalisé et l'emplacement de l'artefact dans le code d'application de base.
4. Créez l'artefact personnalisé et codez-le lorsque vous l'enregistrez par rapport au point d'extension sélectionné. Via l'inscription, vous créez un enregistrement d'instance d'extension qui relie la définition du point d'extension à son implémentation dans l'artefact personnalisé.
{#extension-points__ol_xxk_nfg_pfb}

## Comment les artefacts personnalisés enregistrés sont-ils traités ? {#extension-points__section_gnb_nqy_rdb}

Lorsque le code de l'application s'exécute et détecte un appel d'API incorporé contenant un point d'extension, il :

1. Utilise le point d'extension dans l'appel d'API pour déterminer quels artefacts personnalisés sont enregistrés par rapport à celui-ci.
2. Envoie les données ou objets appropriés aux artefacts personnalisés enregistrés.
3. Collecte la sortie renvoyée à partir de chaque artefact personnalisé.
4. Traite et incorpore les résultats renvoyés dans l'application de base.
{#extension-points__ol_i1m_5vl_rdb}
* **[Utilisation de points d'extension scriptés dans des scripts côté serveur](https://servicenow-prod.fluidtopics.net/ZSLt3cUJ0aw~ia7iBQZa4A)**   
  Utilisez les points d'extension scriptés dans les includes de script côté serveur qui stockent des fonctions JavaScript et des classes d'objets. En utilisant des points d'extension, vous pouvez intégrer des personnalisations sans modifier les composants de base du code d'application.
* **[Utilisation de points d'extension d'interface utilisateur dans des macros d'interface utilisateur côté serveur](https://servicenow-prod.fluidtopics.net/Gi3ftiriBJFJHTdfvd_J5g)**   
  Utilisez les points d'extension d'interface utilisateur dans les macros d'interface utilisateur côté serveur, telles que les extensions HTML, pour ajouter du contenu personnalisé à une page d'interface utilisateur sans avoir à modifier directement la page. En utilisant des points d'extension d'interface utilisateur, vous pouvez intégrer des personnalisations sans modifier les composants de base du code d'application.
* **[Utilisation de points d'extension clients dans un scripting d'interface utilisateur côté client](https://servicenow-prod.fluidtopics.net/voRr3fVaTXFzdpm4BUxZRA)**   
  Utilisez les points d'extension client dans les scripts d'interface utilisateur côté client pour modifier les formulaires, de sorte que vous n'ayez pas à modifier directement le formulaire. En utilisant des points d'extension clients, vous pouvez intégrer des personnalisations sans modifier les composants de base du code d'application.