Join Data Tables

UiPath.Core.Activities.JoinDataTables

Description

Combina linhas de duas tabelas usando valores comuns entre elas de acordo com uma regra de Junção, especificada na propriedade TipoDeJunção.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração multiplataforma

• Tabela de dados 1 — a primeira tabela que você deseja usar na operação de Junção, armazenada em uma variável DataTable . Esse campo é compatível apenas com variáveis DataTable .

• Tabela de dados 2 — a segunda tabela que você deseja usar na operação de Junção, armazenada em uma variável DataTable . Esse campo é compatível apenas com variáveis DataTable .

Observação: a ordem em que as duas tabelas são fornecidas é muito importante, porque influencia a estrutura da tabela resultante, conforme a opção selecionada no campo da propriedade TipoDeJunção.

• TipoDeJunção — o tipo de operação de Junção que você deseja usar. As seguintes opções estão disponíveis:

  • Interna — mantenha todas as linhas da TabelaDeDados1 e da TabelaDeDados2 que atendem à regra de Junção. Quaisquer linhas que não atendem à regra são removidas da tabela resultante.
  • Esquerda — mantenha todas as linhas da TabelaDeDados1 e apenas os valores que atendem à regra de Junção da TabelaDeDados2. São inseridos valores nulos na coluna para as linhas da TabelaDeDados1 que não têm uma correspondência nas linhas da TabelaDeDados2.

  • Completa — mantém todas as linhas da TabelaDeDados1 e da TabelaDeDados2, independentemente de a condição de Junção ser atendida ou não. São adicionados valores nulos nas linhas de ambas as tabelas que não têm uma correspondência.

    Observação: se uma coluna da TabelaDeDados2 compartilha o mesmo nome que uma coluna da TabelaDeDados1, então o nome da coluna da TabelaDeDados2 é alterado para [ColumnName]_1 na tabela resultante. Se uma coluna com o nome [ColumnName]_1 já existir, será usado o número consecutivo que ainda não estiver em uso. Por exemplo, se a TabelaDeDados1 tiver colunas com os nomes ID, ID_1 e ID_2, e a TabelaDeDados2 tiver uma coluna com o nome ID, após a junção, a coluna na TabelaDeDados2 receberá o nome de ID_3.

• Regras de Junção — As condições para unir as tabelas. A seleção do campo abre um Construtor de Filtros simples, no qual você pode adicionar regras que compõem o filtro.

Windows - Legada, Configuração do Windows

Painel de Propriedades

Comum

• NomeDeExibição - o nome de exibição da atividade.

Entrada

• TabelaDeDados1 — a primeira tabela que você deseja usar na operação de Junção, armazenada em uma variável DataTable. Este campo é compatível apenas com variáveis DataTable.
• TabelaDeDados2 — a segunda tabela que você deseja usar na operação de Junção, armazenada em uma variável DataTable. Este campo é compatível apenas com variáveis DataTable.
  Observação: a ordem em que as duas tabelas são fornecidas é muito importante, porque influencia a estrutura da tabela resultante, conforme a opção selecionada no campo da propriedade TipoDeJunção.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• TipoDeJunção — o tipo de operação de Junção que você deseja usar. As seguintes opções estão disponíveis:

  • Interna — mantenha todas as linhas da TabelaDeDados1 e da TabelaDeDados2 que atendem à regra de Junção. Quaisquer linhas que não atendem à regra são removidas da tabela resultante.
  • Esquerda — mantenha todas as linhas da TabelaDeDados1 e apenas os valores que atendem à regra de Junção da TabelaDeDados2. São inseridos valores nulos na coluna para as linhas da TabelaDeDados1 que não têm uma correspondência nas linhas da TabelaDeDados2.

  • Completa — mantém todas as linhas da TabelaDeDados1 e da TabelaDeDados2, independentemente de a condição de Junção ser atendida ou não. São adicionados valores nulos nas linhas de ambas as tabelas que não têm uma correspondência.

    Observação: se uma coluna da TabelaDeDados2 compartilha o mesmo nome que uma coluna da TabelaDeDados1, então o nome da coluna da TabelaDeDados2 é alterado para [ColumnName]_1 na tabela resultante. Se uma coluna com o nome [ColumnName]_1 já existir, será usado o número consecutivo que ainda não estiver em uso. Por exemplo, se a TabelaDeDados1 tiver colunas com os nomes ID, ID_1 e ID_2, e a TabelaDeDados2 tiver uma coluna com o nome ID, após a junção, a coluna na TabelaDeDados2 receberá o nome de ID_3.

Saída

• TabelaDeDados — a tabela com os valores unidos, armazenada em uma variável DataTable. Este campo é compatível apenas com variáveis DataTable.

Assistente de Associação

Este assistente ajuda a configurar as propriedades da atividade Join Data Tables. Ele pode ser aberto usando o botão do Assistente de Junção no corpo da atividade no painel Designer.

Na seção superior do assistente, você pode selecionar ambas as variáveis DataTable que você deseja usar na operação, o tipo de Junção e a variável de saída, utilizando os seguintes campos:

• TabelaDeDados1 de Entrada — a variável DataTable que contém a primeira tabela que você deseja usar.
• TabelaDeDados2 de Entrada — a variável DataTable que contém a segunda tabela que você deseja usar.
• TabelaDeDados de Saída — a variável DataTable em que você deseja armazenar a tabela resultante.
• Tipo de Junção — o tipo de operação de Junção que você deseja usar. As seguintes opções estão disponíveis:
• Interna — mantenha todas as linhas da TabelaDeDados1 e da TabelaDeDados2 que atendem à regra de Junção. Quaisquer linhas que não atendem à regra são removidas da tabela resultante.
• Esquerda — mantenha todas as linhas da TabelaDeDados1 e apenas os valores que atendem à regra de Junção da TabelaDeDados2. São inseridos valores nulos na coluna para as linhas da TabelaDeDados1 que não têm uma correspondência nas linhas da TabelaDeDados2.
• Completa — mantém todas as linhas da TabelaDeDados1 e da TabelaDeDados2, independentemente de a condição de Junção ser atendida ou não. São adicionados valores nulos nas linhas de ambas as tabelas que não têm uma correspondência.

Na seção inferior do assistente, você pode configurar a estrutura da tabela resultante, adicionando expressões que indicam relações entre colunas. Cada uma dessas expressões possui três elementos, como mostrado a seguir:

• Coluna da Tabela 1 — o nome da coluna na primeira tabela. Este campo é compatível apenas com variáveis String que contêm o nome da coluna, variáveis Int32 que contêm o índice da coluna ou variáveis ExcelColumn.

• Operação — a operação que define a relação entre as colunas. As seguintes opções estão disponíveis:

  • = — igual a
  • != — não é igual a
  • > - Maior que
  • < - menor que
  • >= - Maior ou igual a
  • <= - Menor ou igual a
• Coluna da Tabela 2 — o nome da coluna na segunda tabela. Este campo é compatível apenas com variáveis String que contêm o nome da coluna, variáveis Int32 que contêm o índice da coluna ou variáveis ExcelColumn.

Exemplo de uso da atividade Join Data Tables

Para exemplificar como usar esta atividade, criamos um projeto que junta duas planilhas de uma pasta de trabalho em outra planilha dessa pasta de trabalho. A primeira planilha contém detalhes sobre pedidos, enquanto a segunda planilha contém detalhes sobre clientes. As duas planilhas têm uma coluna em comum, a CustomerID, que é usada para a operação de junção. O projeto pode ser baixado aqui.

1. Crie um Projeto em branco.
2. Arraste um contêiner Sequência para um painel Designer.
3. Arraste uma atividade Excel Application Scope e coloque o caminho da pasta de trabalho do Excel na propriedade Caminho da Pasta de Trabalho.
4. Crie duas variáveis DataTable, uma para a planilha Customers e outra para a planilha Orders.
5. Dentro da atividade Excel Application Scope, arraste duas atividades Read Range.
6. Defina duas atividades Read Range para ler cada uma das planilhas na pasta de trabalho do Excel e armazene elas em suas variáveis correspondentes.
7. Crie uma variável DataTable para armazenar a tabela resultante.
8. Arraste uma atividade Join Data Tables para o contêiner do escopo.
9. Clique no botão do Assistente de Junção no corpo da atividade. O Assistente de Junção de Tabelas de Dados será aberto.
10. Defina a variável que contém a planilha Customers no campo TabelaDeDados1 de Entrada.
11. Defina a variável que contém a planilha Orders no campo TabelaDeDados2 de Entrada.
12. Defina a variável criada para armazenar a tabela resultante no campo TabelaDeDados de Saída.
13. No menu suspenso Tipo de Junção, selecione Interna.
14. No campo Coluna da Tabela 1, insira a coluna que corresponde à coluna CustomerID na planilha Customers.
15. No menu suspenso Operação, selecione =.

16. No campo Coluna da Tabela 2, insira a coluna que corresponde à coluna CustomerID na planilha Orders. O Assistente deve ficar assim:

    
    

    

    
    
17. Arraste uma atividade Write Range para o painel Designer.
18. Configure a Write Range para escrever a variável DataTable que contém a tabela resultante em uma nova planilha na pasta de trabalho inicial.

19. O fluxo de trabalho final deve ficar assim: