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.
• Connectez le locataire Orchestrator correspondant au robot^UiPath® .

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).

   Remarque :

   Assurez-vous que le locataire activé pour Data Service est connecté au robot^UiPath® .

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 .

   • 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 .

   Remarque :

   La taille du lot est limitée à 1 000 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 .

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 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é . 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).