Étape du générateur de charge utile

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • Activez les designers d'actions pour créer facilement des paires nom-valeur dans les charges utiles JSON et XML à l'aide de données dynamiques.

    Rôles et disponibilité

    Disponible en tant qu’étape d’action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.
    Remarque :
    Pour JSON, cette étape est obsolète et remplacée par le Étape du générateur JSON fichier .

    Champs

    Champs Description
    Paires nom-valeur

    Les paires nom-valeur à inclure dans la charge utile. Cliquez sur l’icône plus pour ajouter des paires nom-valeur. Faites glisser des pastilles de données dans l’un des champs pour produire des charges utiles dynamiques.

    Le nom devient une clé en JSON et un élément en XML. Par exemple, supposons que vous créiez cette paire nom-valeur.
    • Nom : short_description
    • Valeur : [action]->[short_description]
    Lorsque le système formate la paire nom-valeur au format JSON :
    "short_description": "[action]->[short_description]"

    Lorsque le système formate la paire nom-valeur en XML :

    <short_description>[action]->[short_description]</short_description>
    Omettre si vide Option permettant d’exclure une paire nom-valeur si la valeur est vide ou nulle.
    Remarque :
    Ce champ n’est visible qu’après avoir cliqué sur la flèche vers le bas pour afficher les options avancées.
    Format de sortie Format de fichier de charge utile.
    • JSON : sélectionnez cette option pour formater la charge utile en tant que document JSON.
    • XML : sélectionnez cette option pour formater la charge utile en tant que document XML.
    Espace de noms Espace de noms XML à appliquer à chaque élément. Par exemple, lorsque l’espace de noms est défini sur incident :
    <incident:short_description>[action]->[short_description]</incident:short_description>
    Remarque :
    Ce champ n’est visible que lorsque le format de sortie est défini sur XML.
    Inclure la structure extérieure

    Option permettant d’inclure ou d’exclure un conteneur de niveau supérieur approprié au format de sortie. Lorsque le format de sortie est JSON, les accolades contiennent les paires nom-valeur. Lorsque le format de sortie est XML, un élément XML spécifié contient les paires nom-valeur.

    Par exemple, lorsque le système formate la paire nom-valeur au format JSON :

    {
  "short_description": "[action]->[short_description]"
}

    Lorsque le système formate la paire nom-valeur en XML :

    <xml>
  <short_description>[action]->[short_description]</short_description>
</xml>
    Envoyer une structure vide

    Option permettant d’envoyer des structures JSON ou XML valides lorsque la charge utile est vide. Activez cette option pour inclure du texte structurel JSON ou XML dans la charge utile.

    Par exemple, lorsque le système formate une structure vide au format JSON :
    {}

    Lorsque le système formate une structure vide au format XML :

    <xml></xml>

    Désactivez cette option pour produire une charge utile vide.

    Des charges utiles vides peuvent se produire lorsque vous sélectionnez l’option Omettre si vide pour chaque paire nom-valeur, et toutes les paires nom-valeur de la charge utile produisent des valeurs vides.
    Nœud parent Nom de l’élément XML qui contient les paires nom-valeur. L’élément de nœud parent par défaut est xml.
    Remarque :
    Ce champ n’est visible que lorsque le format de sortie est défini sur XML et que l’option Inclure la structure extérieure est activée.
    Aperçu La charge utile en lecture seule produite par l’étape.

    Évaluation des erreurs d’action

    En cas d'échec de cette étape
    Type de données : Choice

    Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Pour utiliser le code d’état d’étape ou le message pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation de l’erreur d’action.