Téléchargement de données à partir d'un fichier CSV à l'aide d'activités groupées

Présentation du didacticiel

Les activités par lots acceptent et renvoient un List<T> d'enregistrements d'entité en entrée et en sortie pour la création, la mise à jour ou la suppression de plusieurs éléments.

Ces activités peuvent accepter jusqu'à 1 000 enregistrements en un seul appel et chaque appel d'activité comptera comme un appel par rapport à votre quota d'utilisation du service.

Pour comprendre comment utiliser les activités groupées dans Data Service, téléchargez l'exemple ci-dessous et suivez les étapes de ce didacticiel. L'exemple crée 50 enregistrements pour une entité via 2 appels d'activité groupée.

Téléchargez l'exemple

Pour exécuter l'exemple téléchargé :

• Connectez-vous à votre organisation UiPath.
• Assurez-vous que Data Service est activé dans votre locataire.
• Créez l'entité à partir de l'exemple.
• Connect the corresponding Orchestrator tenant to the UiPath^® Robot.

Les workflows contenant des activités par lots incluent généralement une boucle For Each pour parcourir la liste des enregistrements et pour remplir la variable de liste List<T>. La variable est ensuite transmise à l'activité groupée en tant qu'entrée.

Collecter des données

Le fichier States.csv contient les enregistrements que l'activité groupée ajoute à votre entité Data Service.

Pour exécuter l'activité groupée, créez une entité qui a les mêmes champs que vos données.

Création de l'entité

1. Accédez à l'instance Data Service de votre locataire.
2. Créez une nouvelle entité appelée US States avec les champs suivants :
   
   

   

   
   

Conception du workflow

1. Ouvrez Studio et démarrez un nouveau Processus (Process).
   Note: Make sure the Data Service enabled tenant is connected to the UiPath^® Robot.
2. Installez le pack UiPath.DataService.Activities.
3. Importez l'entité États américains (US States) précédemment créée dans votre workflow dans Studio.
4. Pour lire les données du fichier States.CSV dans une table de données, faites glisser-déposer l'activité Lire un fichier CSV (Read CSV).
   • Dans le champ Lire à partir du fichier (Read from file), saisissez le nom du fichier CSV.
   • Dans le champ Sortie vers (Output to), définissez un nom pour la table de données.
5. Définissez une variable pour stocker la taille du lot (c'est-à-dire, combien d'enregistrements doivent être modifiés dans un appel). Utilisez l'activité Attribuer (Assign).
   Remarque: La taille du lot est limitée à 1000 enregistrements. Pour modifier plus de 1 000 entrées, définissez la taille du lot sur 1 000.
6. Définissez une variable pour stocker la liste des enregistrements (par exemple, listUSStates). Utilisez l'activité Affecter (Assign) et initialisez le type de liste sur New <List(Of USStates)>. Cela crée une liste vide, prête à être remplie avec les données du fichier CSV.
   
   

   

   
   
7. Pour parcourir chaque ligne de la table de données précédemment créée (étape 4), utilisez l'activité Pour chaque ligne de la table de données (For Each Row in Data Table).
8. Pour chaque ligne de la table de données, créez une nouvelle variable (c'est-à-dire currState = New USStates) et définissez les valeurs des champs de l'entité US States (c'est-à-dire State, DateofAdmission, Population). Utilisez l'activité Attribution multiple (Multiple Assign ).
9. Pour ajouter l'état actuel à la liste listUSStates , utilisez l'activité Ajouter des éléments à la collection .
   
   

   

   
   
10. Après chaque ajout, vérifiez si la taille de la liste est devenue égale à la taille du lot que vous avez définie à l'étape 5. Utilisez l'activité Si (If) avec la condition listUSStates.Count = batchSize. Le workflow continue d'ajouter des enregistrements jusqu'à ce que la condition If soit remplie.
11. Lorsque la taille de la liste correspond à la taille du lot, créez les enregistrements à l'aide de l'activité Créer plusieurs enregistrements d'entité (Create Multiple Entity Records). Dans notre exemple, cela crée 25 enregistrements en utilisant un seul appel.
12. Effacez la collection après chaque lot d'enregistrements, de sorte que le décompte du prochain lot reparte de zéro.
    
    

    

    
    
13. En dehors de la boucle Pour chaque (For Each), vérifiez s'il reste des enregistrements dans la collection et créez-les.

    Cette dernière étape est importante dans les cas où le nombre d'enregistrements n'est pas un multiple de la taille du lot. Par exemple, si la collection contient 80 enregistrements, la condition Si (If) à l'étape 10 est satisfaite pour 25, 50 et 75 enregistrements (multiples de 25, l'exemple de taille de lot). Les 5 enregistrements restants sont résolus par la dernière condition Si (If) en dehors de la boucle Pour chaque (For Each).