Processeurs

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • 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 API REST basées sur un scriptfichier .
    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é