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 Now Platform , ou ajouter des points d’extension lorsque vous développez des applications personnalisées dans votre propre instance.

Utilisation des points d’extension

L’utilisation des points d’extension vous permet d’intégrer des personnalisations sans modifier réellement les composants principaux du code d’application. Les points d’extension peuvent empêcher l’interruption des interactions avec votre code personnalisé, ce qui se produit souvent après une mise à niveau si vous incorporez directement le code personnalisé dans le code de l’application.

Les points d’extension incorporés dans le code de l’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

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 script includes côté serveur qui stockent les fonctions JavaScript et les classes d’objets. Pour en savoir plus sur les scripts includes et comment implémenter des points d’extension scriptés dans l’application et le code personnalisé, consultez :

• Script includes
• 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 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 pouvez les utiliser 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 Vue (kb_view) standard Base de connaissances dans laquelle les articles de la base de connaissances apparaissent.

Pour en savoir plus sur les macros d’interface utilisateur et comment implémenter des 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 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 comment implémenter des points d’extension clients dans une application et du code 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 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 script includes 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 interagissent avec celui-ci uniquement à des 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 Now Platformfichier .

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

Application	Rubrique du point d’extension
Coaching	Dépannage de Coaching
Gestion de l'amélioration continue	Amélioration avec d’autres applications
Gestion du service clientèle	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 la distribution de logiciel client
Réinitialisation du mot de passe	Script includes de Réinitialisation du mot de passe

Des 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 inscrivent 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 de l’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 les fonctionnalités 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 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 sur le point d’extension ne peuvent s’exécuter que dans le périmètre de l’application désigné. Avant de concevoir et de créer 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 script includes 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 façon dont une personnalisation doit être structurée, la façon dont elle interagit avec le code de l’application et la façon dont les données renvoyées par une personnalisation au niveau du point d’extension sont traitées.

Pour créer des points d’extension et les incorporer 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. Voici un exemple de point d’extension scripté.

   

2. Désignez des endroits spécifiques dans le code de l’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 script include, une macro d’interface utilisateur ou un script d’interface utilisateur, qui appelle la GlideScriptedExtensionPoint : inclus dans le périmètre 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 des script includes, des macros d’interface utilisateur ou des scripts d’interface utilisateur. Consultez les journaux pour afficher 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. Cela inclut également le nombre total d’échecs d’exécution et l’heure à laquelle chaque instance d’extension a échoué.

Remarque :

Pour en savoir plus sur la façon d’activer le débogage et son fonctionnement, consultez :

• Débogueur de script et Journal de la session
• Débogage des applications
• Écrire 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 script includes 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.
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 personnalisé et codez-le lorsque vous l’inscrivez 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é.

Mode de traitement des artefacts personnalisés enregistré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 auprès de 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 incorpore 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 script includes côté serveur qui stockent les fonctions JavaScript et les classes d’objets. L’utilisation des points d’extension vous permet d’intégrer des personnalisations sans modifier réellement les composants principaux du code d’application.
• Utilisation de points d'extension d'interface utilisateur dans des macros d'IU 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’utilisation de points d’extension d’interface utilisateur vous permet d’intégrer des personnalisations sans modifier réellement les composants principaux 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 un scripting d’interface utilisateur côté client pour modifier les formulaires, de sorte de ne pas avoir à modifier directement le formulaire. En utilisant des points d’extension clients, vous pouvez intégrer des personnalisations sans modifier réellement les composants principaux du code d’application.