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 hérités continuent d’être pris en charge, la création de nouveaux processeurs personnalisés est déconseillée. Utilisez plutôt 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, 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 sont laissées aux processeurs existants uniquement.

Formulaire de processeur

Champ	Description
Nom	Nom unique du processeur.
Type	Langage de programmation du script de processeur. Les options incluent : Java : ne pas sélectionner cette option script
Demande	Application contenant cet enregistrement.
Actif	Marqueur pour activer ou désactiver l’enregistrement.
Protection CSRF	Option pour protéger le processeur de l’exécution, à moins que l’instance n’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 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 interrompre 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 Chemin d’accès dans le même enregistrement, rompt la Portail de services, qui dépend de ce paramètre pour l’identification de la page.
Chemin d'accès	Chemin d’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	Immédiatement invoqué Expression de fonction à 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 à l’aide de 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 multitable qui signale le nombre de lignes de n’importe quelle 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.