Processeurs

Les processeurs fournissent un point de terminaison d’URL personnalisable qui peut exécuter du code JavaScript arbitraire côté serveur et produire des résultats tels que TEXT ou JSON. La création de processeurs personnalisés est déconseillée.

Remarque :

Cette fonctionnalité est obsolète. Bien que les processeurs personnalisés existants continuent d’être pris en charge, la création de nouveaux processeurs personnalisés a été déconseillée. Au lieu de cela, utilisez le Scripted REST APIsfichier .

Avertissement :

Lors de la création d’un processeur, assurez-vous d’utiliser des noms de paramètres spécifiques à votre processeur. Par exemple, si votre processeur exporte une liste d’enregistrements juridiques et qu’un paramètre nécessaire est l’adresse e-mail du destinataire, n’utilisez pas « e-mail » comme nom de paramètre. Créez un nom de paramètre plus spécifique au processeur, par exemple legal_export_recipient_email. Le non-respect de cette consigne et l’utilisation de noms de paramètres d’instance tels que id, table, sys_id, service, catalog_id ou vue (et autres) peuvent entraîner des résultats inattendus.

Quand créer des processeurs

Ne créez pas de processeurs personnalisés. Cette fonctionnalité est obsolète. Veuillez utiliser les API REST au lieu de créer des processeurs personnalisés. Les informations restantes sont réservées aux processeurs existants.

Formulaire de processeur

Champ	Description
Nom	Nom unique du processeur.
Type	Langage de programmation du script de processeur. Les options incluent : Java : ne sélectionnez pas cette option script
Application	Application contenant cet enregistrement.
Actif	Marqueur pour activer ou désactiver l’enregistrement.
Protection CSRF	Option permettant de protéger le processeur de l’exécution, sauf si l’instance utilise un jeton CSRF.
Description	Description de la fonction ou de l’objectif du sous-traitant.
Paramètres	Liste des paramètres d’entrée disponibles. Spécifiez les valeurs des paramètres dans l’URL sous la forme <parameter name>=<parameter value>. Remarque : Les noms de paramètres doivent être spécifiques au processeur. Ne choisissez pas de noms de paramètres courants qu’un autre processeur pourrait utiliser. Si vous utilisez un nom de paramètre commun, tel que id, sys_id ou table dans un processeur, cela peut interrompre d’autres fonctionnalités, car le processeur l’emporte lorsque ce paramètre existe dans une URL. Par exemple, un processeur avec un paramètre id , quelle que soit la valeur Path dans le même enregistrement, interrompt le , qui dépend de ce paramètre pour l’identification de la Portail de servicespage.
Chemin	Chemin d’accès de l’URI utilisé pour appeler ce processeur. Appelez un processeur à partir de l’URL en tant que : https://&lt;nom d’instance>.service-now.com/&lt;Chemin>.do
Script	Expression de fonction immédiatement invoquée à exécuter lorsque le système appelle ce processeur. La fonction fournit automatiquement des paramètres d’entrée pour les objets API suivants. g_request g_response g_processor
Politique de protection	Politique à utiliser pour protéger le script de cet enregistrement. Les options incluent : Néant Lecture seule Protégé

• Composants de l’API du processeur
  Les processeurs ont accès à des classes, des objets et des méthodes d’API dédiés.
• Sécuriser et protéger un processeur
  Vous pouvez protéger votre processeur contre toute utilisation non autorisée en utilisant des restrictions de rôle et le protéger en exigeant un jeton CSRF.
• Créer un processeur simple
  Créez un processeur simple pour exécuter un script à partir d’une requête d’URL. Cette fonctionnalité est obsolète.
• Créer un processeur multi-tables
  Créez un processeur multi-tables qui signale le nombre de lignes d’une table sur votre instance. Cette fonctionnalité est obsolète.
• Créer un processeur personnalisé
  Vous pouvez créer un processeur personnalisé pour exécuter un script à partir d’une requête d’URL. Cette fonctionnalité est obsolète.