Créer une action de collecte de données pour un modèle dynamique

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

    • Créez une action de collecte de données pour collecter des valeurs de champ d’enregistrement pour une entrée de modèle dynamique.

    Avant de commencer

    • Rôle requis : action_designer ou admin
    • Créer des informations d’identification et des connexions pour votre point de terminaison REST
    Remarque :
    Les entrées dynamiques ne sont pas disponibles dans le système de base. Pour utiliser des entrées dynamiques dans Studio de workflow, vous devez Demander un Centre d'intégration module d'extension.

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Concepteur de flux.
    2. Sélectionner Créer > Action.
    3. Dans le champ Nom de l’action , saisissez un nom pour votre action, choisissez le périmètre de l’application approprié, puis sélectionnez Soumettre.
    4. Facultatif : Dans le Plan d’action, sélectionnez Entrées.
      Vous devrez peut-être créer une entrée pour fournir un nom de table ou un chemin d’accès URL dynamique à votre étape REST.
      Par exemple, créez une entrée Chaîne pour stocker un nom de table. Consultez Créer une action de collecte de données pour obtenir des noms de champs pour obtenir des instructions.
    5. Dans le Plan d’action, sous Entrées, sélectionnez l’icône Ajouter une nouvelle étape (icône Ajouter une nouvelle étape), puis l’étape REST .
      1. Dans les détails de la connexion, sélectionnez un alias de connexion ou définissez une connexion en ligne.
        Un alias de connexion vous permet de mettre à jour les détails de connexion sans avoir à modifier l’action.
        Par exemple, sélectionnez un alias de connexion à votre instance locale.
      2. Pour les détails de la demande, sélectionnez une méthode pour créer une demande, fournissez un chemin d’accès à la ressource, sélectionnez une méthode HTTP et fournissez des paramètres de requête.
        Les actions de collecte de données utilisent généralement une méthode HTTP GET pour demander des données à partir d’un point de terminaison REST. Pour plus d’informations sur l’utilisation de l’étape REST dans , reportez-vous aux Centre d'intégration sections Étape RESTet REST dans le Centre d’intégration.
    6. Dans le Plan d’action sous l’étape REST, sélectionnez l’icône Ajouter une nouvelle étape (icône Ajouter une nouvelle étape) et sélectionnez l’étape Script .
      1. Dans Variables d’entrée, sélectionnez Créer une variable, puis créez une variable d’entrée pour stocker le corps de la réponse REST.
      2. Pour la variable d’entrée Value, sélectionnez la pastille de données pour la sortie Corps de la réponse de l’étape REST.
      3. Dans Script, saisissez un script pour créer une sortie JSON à partir de la variable d’entrée.
        Votre script doit effectuer ces tâches.
        Analyser la variable d’entrée au format JSON
        Vous pouvez utiliser l’API pour transformer la variable d’entrée d’une chaîne en objet JSON.
        Créer un objet JSON formaté pour un modèle dynamique
        Vous devez connaître la structure de données de la réponse REST pour mapper les valeurs de réponse aux valeurs de modèle. Votre script doit créer un objet JSON de modèle dynamique qui a une propriété nommée données. La valeur de la propriété data doit être un tableau de valeurs de modèle. Chaque valeur de modèle doit avoir une propriété d’étiquette , une propriété de nom et une propriété de valeur vide. La propriété de l’étiquette détermine le mode d’affichage de l’option de valeur de modèle dans l’action. La propriété name (nom) détermine la façon dont l’option de valeur de modèle est stockée et référencée dans le système. La propriété value est vide afin que la valeur puisse être définie dynamiquement lorsque l’action est configurée.

        Par exemple, cet objet JSON définit un tableau de valeurs de modèle à partir de la table d’incidents.

        {
    "data": [
      {
        "name": "parent",
        "label": "Parent",
        "value": ""
      },
      {
        "name": "number",
        "label": "Number",
        "value": ""
      },
      {
        "name": "state",
        "label": "State",
        "value": ""
      },
      {
        "name": "active",
        "label": "Active",
        "value": ""
      },
      {
        "name": "priority",
        "label": "Priority",
        "value": ""
      },
      {
        "name": "caller_id",
        "label": "Caller id",
        "value": ""
      },
      {
        "name": "short_description",
        "label": "Short description",
        "value": ""
      },
      {
        "name": "description",
        "label": "Description",
        "value": ""
      },
      {
        "name": "sys_id",
        "label": "Sys id",
        "value": ""
      },
      {
        "name": "urgency",
        "label": "Urgency",
        "value": ""
      },
      {
        "name": "assigned_to",
        "label": "Assigned to",
        "value": ""
      },
      {
        "name": "severity",
        "label": "Severity",
        "value": ""
      },
      {
        "name": "category",
        "label": "Category",
        "value": ""
      }
    ]
}
        Remarque :
        Une entrée de modèle dynamique ne peut afficher que 5 000 valeurs de modèle de champ maximum. Un objet JSON qui renvoie plus de 5 000 valeurs de modèle de champ sera tronqué lors de son rendu.
        Définir l’objet de sorties
        Définissez l’objet Sorties pour renvoyer votre objet JSON de modèle dynamique.
      4. Dans Variables de sortie, sélectionnez Créer une variable.
        Cette variable de sortie stocke les valeurs de modèle créées par votre script.
      5. Pour le type de variable de sortie, sélectionnez JSON.
        Le type de variable de sortie de script doit être JSON.
    7. Dans le Plan d’action, sélectionnez Sorties
      1. Sélectionnez Créer une sortie.
      2. Définissez l’étiquette de sortie et nommez la sortie.
      3. Définissez le type de sortie sur JSON.
        Remarque :
        L’action peut avoir plusieurs sorties, mais il ne peut y en avoir qu’une de type JSON.
      4. Sélectionnez Quitter le mode d’édition.
      5. En regard du champ Valeur , sélectionnez le sélecteur de pastilles de données ( Sélecteur de pastilles de données), puis sélectionnez la variable de sortie Étape Script que vous avez créée pour stocker les valeurs du modèle.
    8. Cliquez sur Enregistrer et testez l’action.
      Dans les détails d’exécution, votre action de collecte de données s’exécute avec succès si la valeur d’exécution pour la sortie contient la propriété data au bon format.
    9. Cliquez sur Publier pour mettre l’action à la disposition d’autres flux ou actions dans le même périmètre de l’application.

    Résultats

    Vous pouvez maintenant utiliser votre action de collecte de données pour renseigner les options qui apparaissent pour une entrée de modèle dynamique dans une action parente.Utilisez votre action de collecte de données pour renseigner les options d’un modèle dynamique.