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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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

    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 Plan d’action, sélectionnez Entrées.
      Vous devrez peut-être créer une entrée pour fournir un nom de table ou une adresse 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 Plan d’action sous Entrées, sélectionnez l’icône Ajouter une nouvelle étape ( icône Ajouter une nouvelle étape) et sélectionnez 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 la 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 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 Hub d'intégration, consultez Étape RESTet REST dans IntegrationHub.
    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 Valeur, sélectionnez la pastille de données pour la sortie Corps de la 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 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 doté d’une propriété nommée data. 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é label détermine le mode d’affichage de l’option de valeur de modèle 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 est tronqué lors du retour.
        Définir l’objet des sorties
        Définissez l’objet outputs afin de 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 du script doit être JSON.
    7. Dans 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 de modification.
      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 de l’é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 de l’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é de données au format approprié.
    9. Cliquez sur Publier pour rendre l’action disponible pour 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 s’affichent 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.