Processeurs

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Les processeurs fournissent un point de terminaison URL personnalisable qui peut exécuter du code JavaScript arbitraire côté serveur et produire une sortie telle que TEXTE 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 fichier API REST basées sur un script.
    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. Ne pas les respecter et utiliser des noms de paramètres d’instance, tels que id, table, sys_id, service, catalog_id ou vue (entre autres) peut 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
    Application Application contenant cet enregistrement.
    Actives Marqueur pour activer ou désactiver l’enregistrement.
    Protection CSRF Option pour empêcher le processeur de s’exécuter, à moins que l’instance n’utilise un jeton CSRF.
    Description Description de la fonction ou de la finalité du processeur.
    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, casse 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.

    Appeler 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 :

    • Néant
    • Lecture seule
    • Protégé