Carregando dados de CSV usando atividades em lote

Visão geral do tutorial

As atividades em lote aceitam e retornam um List<T> de registros de entidade como entrada e saída para criar, atualizar ou excluir vários itens.

Essas atividades podem aceitar até 1.000 registros em uma única chamada, e cada chamada de atividade será contada como uma chamada em relação à sua cota de uso do serviço.

Para entender como usar atividades em lote no Data Service, baixe o exemplo abaixo e siga as etapas neste tutorial. O exemplo cria 50 registros para uma entidade por meio de 2 chamadas de atividade em lote.

Baixe o exemplo

Para executar o exemplo baixado:

• Conecte-se à sua organização no UiPath.
• Certifique-se de que o Data Service esteja habilitado em seu tenant.
• Crie a entidade a partir do exemplo.
• Conecte o tenant do Orchestrator correspondente ao UiPath Robot.

Os fluxos de trabalho que contêm atividades em lote normalmente incluem um loop For Each para iterar pela lista de registros e para preencher a variável de lista List<T>. A variável é então passada para a atividade em lote como entrada.

Coletando dados

O arquivo States.csv contém os registros que a atividade em lote adiciona à sua entidade do Data Service.

Para executar a atividade em lote, crie uma entidade que tem os mesmos campos que seus dados.

Criando a entidade

1. Vá para a instância do Data Service do seu tenant.
2. Crie uma nova entidade chamada Estados dos EUA com os seguintes campos:
   
   

   

   
   

Projetando o fluxo de trabalho

1. Abra o Studio e inicie um novo processo.
   Observação: Certifique-se de que o tenant habilitado do Data Service esteja conectado ao UiPath Robot.
2. Instale o pacote UiPath.DataService.Activities.
3. Importe a entidade Estados dos EUA criada anteriormente para dentro do seu fluxo de trabalho no Studio.
4. Para ler os dados do arquivo States.CSV em uma tabela de dados, arraste e solte a atividade Read CSV.
   • No campo Ler do arquivo, insira o nome do arquivo CSV.
   • No campo Saída em, defina um nome para a tabela de dados.
5. Defina uma variável para armazenar o tamanho do lote (ou seja, quantos registros alterar em uma chamada). Use a atividade Assign.
   Nota: O tamanho do lote é limitado em 1.000 registros. Para alterar mais de 1.000 entradas, defina o tamanho do lote como 1.000.
6. Defina uma variável para armazenar a lista de registros (por exemplo, listUSStates). Use a atividade Assign e inicialize o tipo de lista em New <List(Of USStates)>. Isso cria uma lista vazia, pronta para ser preenchida com os dados do arquivo CSV.
   
   

   

   
   
7. Para iterar por todas as linhas na tabela de dados criada anteriormente (etapa 4), use a atividade For Each Row in Data Table.
8. Para cada linha na tabela de dados, crie uma nova variável (ou seja, currState = New USStates) e defina os valores para os campos da entidade dos Estados dos EUA (ou seja, State, DateofAdmission, Population). Use a atividade Multiple Assign.
9. Para adicionar o estado atual à lista listUSStates, use a atividade Add To Collection.
   
   

   

   
   
10. Após cada adição, verifique se o tamanho da lista se tornou igual ao tamanho do lote que você definiu na etapa 5. Use a atividade If com a condição listUSStates.Count = batchSize. O fluxo de trabalho continua adicionando registros até a Condição If ser atendida.
11. Quando o tamanho da lista corresponder ao tamanho do lote, crie os registros usando a atividade Create Multiple Entity Records. Em nosso exemplo, isso cria 25 registros usando uma única chamada.
12. Limpe a coleção após cada lote de registros, para que a contagem para o próximo lote comece em zero.
    
    

    

    
    
13. Fora do loop For Each, verifique se há quaisquer registros restantes na coleção e os crie.

    Essa etapa final é importante para casos em que a contagem de registros não é um múltiplo do tamanho do lote. Por exemplo, se a coleção contém 80 registros, a Condição If na etapa 10 é satisfeita para 25, 50 e 75 registros (múltiplos de 25, o tamanho do lote do exemplo). Os 5 registros restantes são resolvidos pela última Condição If, fora do loop For Each.