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 ajouter des points d’extension lorsque vous développez des applications personnalisées dans votre propre instance.
Utilisation de points d’extension
En utilisant des points d’extension, vous pouvez intégrer des personnalisations sans réellement 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 incorporez directement le code personnalisé dans le code d’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.
Types de points d’extension
- 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 script et sur l’implémentation de points d’extension scriptés dans l’application et le code personnalisé, consultez :
- 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 des points d’extension d’interface utilisateur dans l’application et le code personnalisé, consultez : - 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 des points d’extension client dans le code d’application et personnalisé, consultez :
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 d’application et n’interagissent avec lui qu’aux points d’extension spécifiés.
Code d’application
- Code d’application standard
- Code d’application standard ou de base qui comprend le ServiceNow AI Platform fichier .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 du point d’extension Coaching Résoudre les problèmes de Coaching Gestion de l'amélioration continue Amélioration avec d’autres applications Gestion du service client Points d’extension dans Gestion du service client Création de rôles d’utilisateur personnalisés Intégration CSM à Gestion des changements Intégration de CSM à Gestion des incidents Intégration de CSM à Gestion des problèmes Intégration CSM à Gestion des requêtes 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’enregistrement 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 à 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
Assurez-vous 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.
- Identifiez où placer les points d’extension dans le code d’application pour prendre en charge les includes de script personnalisés, les macros d’interface utilisateur ou les scripts d’interface utilisateur.
- 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.
- Créez un point d’extension et définissez son interface personnalisée. Ceci est un exemple de point d’extension scripté.
- 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.
- Créez un artefact, tel qu’une inclusion de script, une macro d’interface utilisateur ou un script d’interface utilisateur, qui appelle la GlideScriptedExtensionPoint : délimité 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.
Activer le débogage et la journalisation
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 tâches qui n’ont pas pu s’exécuter et l’heure à laquelle chaque instance d’extension a échoué.
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 créer des artefacts personnalisés, procédez comme suit :
- Passez en revue la liste des points d’extension disponibles qui conviennent au type spécifique d’artefact personnalisé que vous créez.
- Ces listes incluent les points d’extension que vous avez créés et 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 d’application qui appelle un artefact personnalisé et sur les données ou les objets qui doivent y être renvoyés.
- Sélectionnez un point d’extension.
- 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 d’application de base.
- Créez l’artefact et le code personnalisés lorsque vous l’enregistrez par rapport au point d’extension sélectionné. Par le biais de 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
- Utilise le point d’extension dans l’appel d’API pour déterminer quels artefacts personnalisés sont enregistrés par rapport à celui-ci.
- Envoie les données ou les objets appropriés aux artefacts personnalisés enregistrés.
- Collecte la sortie renvoyée par chaque artefact personnalisé.
- Traite et intègre les résultats renvoyés dans l’application de base.