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

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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 les 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, entrez 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 les Créer une action de collecte de données pour obtenir les noms de champs pour obtenir les 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 sélectionnez l’étape REST .
      1. Dans les détails de 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, fournir un chemin d’accès à la ressource, sélectionnez une méthode HTTP et fournissez tous les 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 , consultez Centre d'intégrationÉtape RESTet REST dans 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), puis 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 valeur de la variable d’entrée, sélectionnez la pastille de données pour la sortie Corps de réponse de l’étape REST.
      3. Dans Script, entrez 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 JSON - Global pour transformer la variable d’entrée d’une chaîne en objet JSON.
        Créer un objet JSON mis en forme 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é de données 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 la façon dont l’option de valeur du modèle apparaît dans l’action. La propriété name 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 jusqu’à 5 000 valeurs de modèle de champ. 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 outputs 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 variable de sortie du 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 le nom de 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 de 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 de la sortie contient la propriété de données au format approprié.
    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.