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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 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éez 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 Hub d'intégration module d'extension.

    Procédure

    1. Accédez à la Tout > 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 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 des 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) et sélectionnez l’étape REST .
      1. Dans les détails de la connexion, sélectionnez un alias de connexion ou définissez un inline de connexion.
        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, fournir un chemin d’accès à la ressource, sélectionner une méthode HTTP et fournir les paramètres de requête éventuels.
        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 REST et REST dans Centre d’intégration.
    6. Dans le plan d’action de 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 Valeur d’entrée, 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 des 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 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é d’étiquette détermine la façon dont l’option de valeur de 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 appelé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 pas afficher plus de 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 du rendu.
        Définir l’objet des sorties
        Définissez l’objet des sorties pour qu’il retourne votre objet JSON de modèle dynamique.
      4. Dans Variables en 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 d’é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 à 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.