Processeurs

Les processeurs fournissent un point de terminaison d’URL personnalisable qui peut exécuter du code JavaScript arbitraire côté serveur et produire une sortie telle 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 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, veillez à 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, tel que 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 (entre 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 ne sont laissées qu’aux sous-traitants existants.

Formulaire de processeur

Champ	Description
Nom	Nom unique du processeur.
Type	Langage de programmation du script du 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, à moins que l’instance n’utilise un jeton CSRF.
Description	Description de la fonction ou du but 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 communs 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 casser d’autres fonctionnalités, car le processeur gagne 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 d'accès	Chemin d’accès de l’URI utilisé pour appeler ce processeur. Appelez un processeur à partir de l’URL en tant que : https://<nom d’instance >.service-now.com/<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 : Aucun Lecture seule Protégé

• Composants de l’API du processeur
  Les processeurs ont accès à des classes, des objets et des méthodes 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éation d’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 multitable qui signale le nombre de lignes d’une table sur votre instance. Cette fonctionnalité est obsolète.
• Créer un processeur personnalisé
  Créez un processeur personnalisé pour exécuter un script à partir d’une requête d’URL. Cette fonctionnalité est obsolète.