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

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

L’utilisation de points d’extension vous permet d’intégrer des personnalisations sans modifier les composants de base du code d’application. Les points d’extension peuvent empêcher vos interactions de code personnalisé de se casser, 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 :

Impossible de modifier ou de désactiver certaines règles de requête CSM configurées prêtes à l’emploi, car elles sont également utilisées dans les constantes d’une règle métier.

Types de points d’extension

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 les fonctions JavaScript et les classes d’objets. Pour en savoir plus sur les includes de scripts et sur l’implémentation de points d’extension scriptés dans l’application et le code personnalisé, consultez :

• Includes de script
• Création et ajout d’un point d’extension scripté
• Utilisation de points d'extension pour étendre les fonctionnalités de l'application

Points d’extension de l’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. Ils vous permettent d’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 standard Base de connaissances View (kb_view) dans laquelle les articles de la base de connaissances apparaissent.

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
• Création et ajout d’un point d’extension d’interface utilisateur
• Utilisation de points d'extension pour étendre les fonctionnalités de l'application

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 regrouper 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
• Création et ajout d’un point d’extension client
• Utilisation de points d'extension pour étendre les fonctionnalités de l'application

Lorsque vous utilisez des points d’extension pour traiter les 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 personnalisés côté serveur, les macros d’interface utilisateur telles que les extensions HTML et les scripts d’interface utilisateur côté client sont tous externes au code de l’application et n’interagissent avec celui-ci qu’aux points d’extension spécifiés.

Code d’application

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

Code d’application standard

Code d’application standard ou de base qui comprend le ServiceNow AI Platform.

Des points d’extension prédéfinis sont déjà intégrés dans certaines applications, telles que Gestion du service client et Gestion des services sur site. Pour en savoir plus sur les ServiceNow AI Platform applications qui contiennent des points d’extension prédéfinis, consultez les rubriques suivantes :

Application	Rubrique de point d’extension
Coaching	Dépannage de Coaching
Continual Improvement Management	Amélioration avec d’autres applications
Gestion du service client	Points d’extension dans Customer Service Management
	Création de rôles d'utilisateurs personnalisés
	Intégration de CSM à Change Management
	Intégration de CSM à Incident Management
	Intégration de CSM à Problem Management
	Intégration de CSM à Request Management
Gestion des services sur site	Points d’extension dans Field Service Management
Gestion des connaissances	Utiliser des points d’extension pour Gestion des connaissances
Orchestration	Réseau d’extension de distribution de logiciel client Installé avec Distribution de logiciel client
Réinitialisation du mot de passe	Includes de script de Réinitialisation du mot de passe

Applications personnalisées développées en interne pour votre entreprise

Vous pouvez ajouter des points d’extension pour gérer l’inscription des 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 avec des points d’extension spécifiques. L’ajout de points d’extension permet d’intégrer les personnalisations futures sans avoir à modifier votre code de base.

Création d’un point d’extension dans le code d’application

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 hautement définie pour les extensions de fonctionnalités.

Lorsque vous créez un point d’extension, vous pouvez limiter 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 champs d’application 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 des points d’extension dans le code d’application pour prendre en charge les includes de script, les macros d’interface utilisateur ou les scripts d’interface utilisateur personnalisés.
• Déterminer Contenu et structure d’un point d’extension. Cette définition doit décrire la façon dont une personnalisation doit être structurée, comment elle interagit avec le code d’application et comment les données renvoyées par une personnalisation au point d’extension sont traitées.

Pour créer des points d’extension et les intégrer dans le code d’application, procédez comme suit :

1. Créez un point d’extension et définissez son interface personnalisée. Ceci est un exemple de point d’extension scripté.

   

2. Désignez des emplacements spécifiques dans le code d’application où les données ou les 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 : dans le champ d’application 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.

   

Activation du débogage et de la connexion

Lorsque vous créez un point d’extension, vous devez également activer le débogage et la journalisation. 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 chacun. Il comprend également le nombre total de demandes qui n’ont pas pu s’exécuter et l’heure à laquelle chaque instance d’extension a échoué.

Remarque :

Pour en savoir plus sur l’activation et le fonctionnement du débogage, consultez :

• Débogueur de script et Journal de la session
• Débogage d’applications
• Écriture dans le journal des débogages

Enregistrement d’un artefact personnalisé par rapport à un point d’extension

Lorsque vous personnalisez une application, vous étendez la fonctionnalité de base à l’aide d’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 qui sont incorporés dans les ServiceNow AI Platform fonctions.
   • Chaque liste comprend des informations sur un point d’extension dans le code de l’application qui appelle un artefact personnalisé et sur les données ou les objets qui doivent lui être renvoyés.
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 d’utilisation de l’artefact avec le code personnalisé et l’emplacement de l’artefact dans le code de l’application de base.
4. Créez l’artefact et le code personnalisés lorsque vous les enregistrez par rapport au point d’extension sélectionné. Grâce à 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é.

Comment les artefacts personnalisés enregistrés sont traités

Lorsque le code de l’application s’exécute et trouve 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 les objets appropriés aux artefacts personnalisés enregistrés.
3. Collecte la sortie renvoyée à partir de chaque artefact personnalisé.
4. Traite et intègre les résultats renvoyés dans l’application de base.

• Utilisation de points d'extension scriptés dans des scripts côté serveur
  Utilisez les points d’extension scriptés dans les includes de script côté serveur qui stockent les fonctions JavaScript et les classes d’objets. L’utilisation de points d’extension vous permet d’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
  Utilisez des 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. À l’aide des points d’extension de l’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
  Utilisez des points d’extension clients dans les scripts d’interface utilisateur côté client pour modifier les formulaires afin de n’avoir 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.