Métodos do conector de tabela

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 17 min. de leitura

    • O conector de tabela fornece vários métodos que executam várias ações em dados tabulares como parte de uma automação Fluxo de trabalho no Design studio de RPA para desktop. Por exemplo, tarefas como obter uma tabela, obter dados de linha e remover linhas vazias.

    Definir tabela

    Insere uma tabela no fluxo de trabalho. O método SetTable deve ser usado antes de executar qualquer outra operação em uma tabela de dados. Você deve fornecer o objeto de tabela que precisa ser definido.
    Tabela 1. Parâmetros SetTable
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Tabela Nome da tabela que você deseja adicionar ou modificar.
    Exemplo
    Tabela de dados
    		 Entrada de dados Tabela de dados

    AdicionarColuna

    Adiciona uma coluna a uma tabela. A posição da coluna é determinada pelo valor de índice da coluna que você especifica. Você deve fornecer o nome da nova coluna e o índice da coluna na qual a nova coluna precisa ser adicionada.
    Tabela 2. Parâmetros AddColumn
    Nome do Parâmetro Descrição Tipo de dados
    Nome Nome da nova coluna que você deseja adicionar.
    Exemplo
    Dados do cliente
    		 Cadeia de caracteres
    ColumnIndex Índice da coluna em que a nova coluna precisa ser adicionada. Por padrão, -1 é o valor de índice que você pode atualizar. Por exemplo, 0, 1, 2 podem indicar as posições das colunas da esquerda para a direita. Números inteiros

    AdicionarColunas

    Adiciona várias colunas a uma tabela aceitando nomes de coluna de outro método ou componente. Para exibir as colunas adicionadas, use o método GetTable. Você deve fornecer uma lista de nomes de novas colunas que precisam ser adicionadas à tabela de dados.
    Tabela 3. Parâmetros AddColumns
    Nome do Parâmetro Descrição Tipo de dados
    Nomes Aceita nomes de colunas na forma de uma matriz, lista de matrizes ou lista.
    Exemplo
    { "OrderID", "CustomerName", "OrderDate", "Status"};
    		 IEnumerable

    AdicionarLinha

    Adiciona uma linha e seu conteúdo no índice especificado. Você deve fornecer o RowIndex no qual a linha precisa ser adicionada.

    Para definir os valores de índice nos quais você adiciona o conteúdo da linha, execute as seguintes ações:

    1. Clique no ícone de configurações do componente ( ícone Configurações do componente).
    2. Clique no ícone de adição de índice ( ícone de adição de índice).
    3. Insira o índice.
    4. Repita as etapas para adicionar vários índices.
    5. Clique em OK.
      Nota:
      Uma porta de entrada de dados é adicionada a cada linha adicionada.
    Tabela 4. Parâmetros AddRow
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    ÍndiceDeLinha Índice de linha no qual a nova linha precisa ser adicionada. Entrada de dados Números inteiros

    ObterTabela

    Retorna a tabela que você criou com os métodos AddColumn, AddColumns e AddRow.
    Nota:
    Você deve executar este método depois de executar os métodos AddColumn, AddColumns e AddRow.
    Tabela 5. Parâmetros GetTable
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Tabela de dados Retorna o tipo DataTable que representa o objeto DataTable subjacente. Saída de dados Tabela de dados

    LimparColunas

    Limpa todos os valores de coluna de uma tabela.

    LimparRinhas

    Limpa todos os valores de linha de uma tabela.

    DeleteColumnByIndex

    Exclui uma coluna com base no valor de índice especificado. Você deve fornecer o índice da coluna a ser excluída para o parâmetro Índice.
    Tabela 6. Parâmetros DeleteColumnByIndex
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Índice Valor de índice da coluna que deve ser excluída. Entrada de dados Números inteiros

    DeleteColumnByName

    Exclui uma coluna com base no nome especificado. Você deve fornecer o nome da coluna que precisa ser excluída.
    Tabela 7. Parâmetros DeleteColumnByName
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Nome Nome da coluna que deve ser excluída. Entrada de dados Cadeia de caracteres

    Excluir linha

    Exclui uma linha com base no valor de índice fornecido. Antes de executar este método, você deve atribuir valores de índice personalizados às linhas. Você deve fornecer o índice da linha que precisa ser excluída.
    Tabela 8. Parâmetros DeleteRow
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Índice Índice da linha que precisa ser excluída. Entrada de dados Números inteiros

    Filtrar e classificar

    Filtra e classifica a tabela com base em uma expressão que você especifica. Você deve fornecer a expressão para calcular o valor de uma coluna, o nome da coluna a ser classificado em "SorColumnName" e "Ordem". Ele retorna a contagem das linhas disponíveis com base no conjunto de critérios e também retorna a tabela de dados completa.
    Tabela 9. Parâmetros FilterAndSort
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Expressão Expressão para calcular o valor de uma coluna.
    Exemplo
    "Status = 'Pendente'" - com base nesta expressão de consulta, os dados são filtrados.
    		 Entrada de dados Cadeia de caracteres
    ClassificarNomeDaColuna Nome da coluna pela qual o método classificará os dados.
    Exemplo
    Data - O método classificará os dados com base na coluna Data.
    		 Entrada de dados Cadeia de caracteres
    Ordem Ordem do nome da coluna Entrada de dados Cadeia de caracteres
    Tabela de dados Retorna a tabela de dados que contém dados filtrados do objeto DataTable subjacente. Saída de dados Tabela de dados
    Contagem Retorna a contagem de linhas após a classificação. Saída de dados Números inteiros

    FiltrarPorRegistro

    Filtra os dados da tabela com base em uma expressão regular ou RegEx que você especificar. Você deve fornecer o índice de coluna para o parâmetro ColumnIndex e a expressão regular para o parâmetro RegExpression, que são usados para filtragem. Este método retorna a contagem de linhas e a tabela de dados.
    Tabela 10. Parâmetros FilterByRegEx
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    ColumnIndex Índice da coluna na qual a lógica de filtragem precisa ser aplicada. O valor de índice padrão é -1 para a primeira coluna. O fornecimento de um valor de índice personalizado é opcional. Se o campo não receber nenhum valor de índice personalizado, o método definirá automaticamente a ordem das colunas. Entrada de dados Números inteiros
    RegExpression Expressão regular que é usada como lógica de filtragem. Entrada de dados Cadeia de caracteres
    Retornar Retorna uma DataTable que contém dados filtrados do objeto DataTable subjacente. Saída de dados Tabela de dados
    Contagem de linhas Retorna o número de linhas disponíveis com base no filtro que usa RegExpression. Saída de dados Números inteiros

    LocalizarTexto

    Localiza o texto na tabela que você especifica com base em um ou mais critérios e retorna o valor da célula. Você deve fornecer o texto a ser pesquisado no parâmetro SearchText, a posição em que a pesquisa deve começar em StartPosition e o tipo de correspondência necessário.
    Tabela 11. Parâmetros FindText
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    SearchText Texto a ser pesquisado na tabela.
    Exemplo
    "John Doe"
    		 Entrada de dados Cadeia de caracteres
    PosiçãoInicial Posição da coluna de onde a pesquisa deve começar. Entrada de dados Números inteiros
    Tipo de correspondência Tipo de correspondência do texto:
    • ExactMatch: o texto especificado e o texto pesquisado devem corresponder exatamente. Este é um valor padrão.
    • MatchCase: o caso de texto especificado deve corresponder ao caso do texto pesquisado.
    • Contém: o texto especificado deve conter um ou mais caracteres do texto pesquisado.
    		 Entrada de dados Tipo de correspondência
    ValorCélula Retorna o valor na célula com base na pesquisa. Saída de dados Objeto
    ColIndex Retorna o índice da coluna que tem esse texto pesquisado. Saída de dados Números inteiros
    ÍndiceDeLinha Retorna o índice da linha que tem esse texto pesquisado. Saída de dados Números inteiros

    ObterValorCélula

    Retorna o valor em uma célula com base nos valores de índice de linha e coluna que você especificar. Você deve fornecer o número da linha e o número da coluna da célula da qual o valor precisa ser recuperado.
    Tabela 12. Parâmetros GetCellValue
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Linha Número de linha da célula necessária. Entrada de dados Números inteiros
    Coluna Número da coluna da célula necessária. Entrada de dados Números inteiros
    Retornar Retorna o tipo de objeto que representa o valor da célula do objeto DataTable subjacente. Saída de dados Objeto

    ObterValorDeCélulaSeRowHas

    Retorna verdadeiro se o método encontrar o texto especificado e os valores de linha com base nos valores de índice especificados. Você deve fornecer o texto a ser pesquisado. Execute a pesquisa em uma coluna específica fornecida por SearchColumnIndex e comece a pesquisar o texto de uma linha específica fornecida para StartRowIndex. O valor padrão é 1, o que significa a primeira linha da tabela.

    Para especificar os valores de linha, você deve configurar o método.

    1. Clique no ícone de configurações de método ( ícone de configurações de método).
    2. Clique no ícone para adicionar índice de linha ( Adicionar índice de linha).
    3. Atualize o tipo de dados do valor do índice de linha.
    4. Insira o valor do índice da linha.
    5. Clique em OK.
    Tabela 13. Parâmetros GetCellValueIfRowHas
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    SearchText Texto a ser pesquisado na linha.
    Exemplo
    "John Doe"
    		 Entrada de dados Cadeia de caracteres
    SearchColumnIndex Índice da coluna na qual o texto precisa ser pesquisado. Entrada de dados Números inteiros
    StartRowIndex Linha inicial a partir da qual a pesquisa precisa ser realizada. Entrada de dados Números inteiros
    Encontrado Retorna verdadeiro se o texto corresponder. Saída de dados Booliano

    ObterValoresCélulas

    Retorna valores de várias células com base nos valores de índice especificados. Você deve fornecer o índice de linha da célula cujo valor precisa ser recuperado. Índices de linha adicionais também podem ser adicionados para obter esses valores de célula usando a janela de configuração.

    Para configurar, execute as seguintes ações:

    1. Clique no ícone de configurações de método ( ícone de configurações de método).
    2. Clique no ícone para adicionar índice de linha ( Adicionar índice de linha).
    3. Atualize o tipo de dados do valor do índice de linha.
    4. Insira o valor do índice da linha.
    5. Clique em OK.
    Tabela 14. Parâmetros GetCellValue
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    ÍndiceDeLinha Índice da linha cujo valor de célula é necessário. Entrada de dados Números inteiros

    ObterContagem

    Retorna a contagem total de linhas e colunas de uma tabela de dados.

    Tabela 15. Parâmetros GetCount
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Linha Retorna a contagem total de linhas criadas. Saída de dados Números inteiros
    Coluna Retorna a contagem total de colunas criadas. Saída de dados Números inteiros

    ObterDadosDaLinha

    Retorna dados de linha com base no valor de índice especificado. Você deve fornecer o valor de índice da linha da qual os dados precisam ser recuperados.
    Tabela 16. Parâmetros GetRowData
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    ÍndiceDeLinha Valor de índice da linha da qual os dados precisam ser recuperados. Entrada de dados Números inteiros
    Retornar Retorna a lista do tipo de objeto que representa os dados de linha do objeto DataTable subjacente. O tipo de dados IEnumerable aceita os dados do valor da linha como matriz, lista ou lista de matrizes e retorna como objeto. Saída de dados IEnumerable

    ObterTabelaComoCSV

    Salva os dados da tabela no formato CSV na unidade local. Você deve fornecer o caminho do arquivo no qual o arquivo CSV precisa ser gravado e também fornecer o separador entre os dois registros.
    Tabela 17. Parâmetros GetTableAsCSV
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Caminho do arquivo Caminho da pasta na unidade local em que o método salva os dados da tabela como CSV. No caminho do arquivo, você deve incluir o nome do arquivo.
    Exemplo
    D:\Projetos\Dados do cliente.csv
    		 Entrada de dados Cadeia de caracteres
    Delimitador Delimitador que separa os dados da tabela.
    Exemplo
    Vírgula (",")
    		 Entrada de dados Cadeia de caracteres

    ObterTabelaComoHTML

    Retorna os dados da tabela em um formato de arquivo HTML. Antes de executar este método, você deve criar colunas, linhas e dados e executá-los com o método GetTable.
    Tabela 18. Parâmetros GetTableAsHTML
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Retornar Retorna os dados tabulares no formato HTML. Entrada de dados Cadeia de caracteres

    GetTableAsJson

    Retorna os dados da tabela em um formato de arquivo JSON. Antes de executar este método, você deve criar colunas, linhas e dados e executá-los com o método GetTable.
    Tabela 19. Parâmetros GetTableAsJson
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Retornar Retorna os dados tabulares como um objeto JSON. Entrada de dados Cadeia de caracteres

    CarregarDoExcel

    Importa a planilha ou os dados do arquivo do Excel especificado para a tabela de dados. Você deve fornecer o caminho do arquivo do Excel a partir do qual os dados precisam ser carregados. Forneça o nome da planilha ou forneça uma consulta ao parâmetro SheetOrQuery. Se uma consulta for fornecida, defina o Booliano IsQuery como Verdadeiro e, se um nome de folha for fornecido, defina o Booliano IsQuery como Falso. Você pode testar se os dados foram importados corretamente com o método GetTable.
    Tabela 20. Parâmetros LoadFromExcel
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Caminho do arquivo Caminho para o arquivo do Excel do qual os dados são importados.
    D:\Projetos\Vendas\Dados de vendas.xlsx
    		 Entrada de dados Cadeia de caracteres
    PlanilhaOuConsulta Indica se os dados são importados de uma planilha no arquivo do Excel ou por meio de uma consulta ao arquivo. Entrada de dados Cadeia de caracteres
    ÉConsulta Valor booliano para indicar se os dados são carregados por meio de uma consulta. Entrada de dados Booliano

    Corresponder coluna

    Corresponde às colunas de outra tabela de dados com a coluna da tabela atual com base no índice da coluna. Você deve fornecer a tabela de dados cujas colunas precisam ser correspondidas fornecidas em dtTable com o índice da coluna na tabela atual no parâmetro ColumnIndex. Antes de executar este método, você deve executar o método GetTable.
    Tabela 21. Parâmetros MatchColumn
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    dtTable Tabela de dados cujas colunas precisam ser correspondidas. Entrada de dados Tabela de dados
    ColumnIndex Índice da coluna com a qual ele deve ser correspondido. Entrada de dados Números inteiros
    Retornar Retorna um valor verdadeiro ou falso indicando se a coluna especificada é correspondida. Saída de dados Booliano

    RemoverColunasVazias

    Remove todas as colunas vazias na tabela e retorna a tabela de dados após a operação.
    Tabela 22. Parâmetros RemoveEmptyColumns
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Retornar Retorna a tabela de dados após remover as colunas vazias. Saída de dados Tabela de dados

    RemoveEmptyRows

    Remove todas as linhas vazias na tabela e retorna a tabela de dados após a operação.
    Tabela 23. Parâmetros RemoveEmptyRows
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Retornar Retorna a tabela de dados após remover as linhas vazias. Saída de dados Tabela de dados

    DefinirValorCélula

    Adiciona dados a uma célula com base nos valores de índice de coluna e linha. Você deve fornecer o número da linha, o número da coluna e o valor no parâmetro Valor que precisa ser definido.

    Antes de executar este método, você deve criar colunas, linhas e dados e executá-los com o método GetTable.

    Tabela 24. Parâmetros SetCellValue
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Linha Número de índice da linha que o método usará para preencher os dados. Entrada de dados Números inteiros
    Coluna Número de índice da coluna que o método usará para preencher os dados. Entrada de dados Números inteiros
    Valor Valor que deve ser definido na célula. Entrada de dados Objeto

    DefinirValorDeCélulaSeRowHas

    Define o(s) valor(es) de célula de uma linha específica se a linha contiver o texto especificado. Você deve fornecer o índice de linha na caixa de diálogo de configuração do índice de linha. O nome do parâmetro de índice de linha adicionado é considerado para definir o valor e o valor fornecido para esse parâmetro é o valor real que será definido para a linha da tabela.
    Tabela 25. Parâmetros SetCellValueIfRowHas
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    SearchText Texto a ser pesquisado na linha. Entrada de dados Cadeia de caracteres
    SearchColumnIndex Índice da coluna na qual o texto precisa ser pesquisado. Entrada de dados Números inteiros
    StartRowIndex Linha inicial a partir da qual o texto precisa ser pesquisado. Entrada de dados Números inteiros
    Encontrado Retorna verdadeiro se o texto corresponder. Saída de dados Booliano

    DefinirNomeDaColuna

    Atualiza um nome de coluna com base no índice e no nome da coluna especificados. Você deve primeiro criar ou importar uma tabela usando o método SetTable.
    Tabela 26. Parâmetros SetColumnName
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    ColumnIndex Índice da coluna que precisa ser nomeada. Entrada de dados Números inteiros
    Nome Novo nome da coluna. Entrada de dados Cadeia de caracteres

    DefinirJSON

    Converte um objeto JSON em uma DataTable. Forneça dados JSON que precisam ser convertidos em DataTable.
    Dica:
    Para criar um objeto JSON, use o método GetTableAsJson e passe os valores para o método SetJson.
    Tabela 27. Parâmetros SetJson
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    JSON O objeto JSON precisa ser convertido em uma DataTable. Entrada de dados Cadeia de caracteres

    Definir lista

    Converte uma lista em uma DataTable. Forneça a lista de dados que precisa ser convertida em tabela.
    Tabela 28. Parâmetros SetList
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Dados Dados do tipo de lista que precisam ser convertidos em tabela. O tipo de dados de entrada IEnumerable aceita os dados como matriz, lista ou lista de matrizes.
    { "OrderID": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "Enviado" };
    		 Entrada de dados IEnumerable

    DefinirDadosDaLinha

    Insere os dados de linha especificados em uma tabela de dados. Você deve fornecer o número de índice da linha para o parâmetro RowIndex e os dados que precisam ser adicionados à linha para o parâmetro Data.
    Tabela 29. Parâmetros SetRowData
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    ÍndiceDeLinha Número de índice da linha que precisa ser modificada. Entrada de dados Números inteiros
    Dados Dados em uma linha que são inseridos em uma tabela de dados. O tipo de dados de entrada IEnumerable aceita os dados como matriz, lista ou lista de matrizes.
    { "OrderID": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "Enviado" };
    		 Entrada de dados IEnumerable

    Para lista

    Converte a tabela especificada em uma lista.
    Tabela 30. Parâmetros ToList
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Retornar Retorna um IEnumerable que representa um objeto DataTable convertido em uma lista. O tipo de dados IEnumerable aceita os dados como matriz, lista ou lista de matrizes e retorna a lista. Saída de dados IEnumerable

    VPesquisar

    Obtém valor(es) de célula de uma linha específica se a linha contiver o texto especificado.

    Para inserir os valores, execute as seguintes ações:
    1. Clique no ícone de configurações do método ( ícone Configurações do componente).
    2. Clique no ícone Adicionar valor..
    3. Insira os valores.
    4. Clique em OK.
    Tabela 31. Parâmetros VLookUp
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Nome da porta Nome da porta do componente. Entrada de dados Cadeia de caracteres
    SearchText Texto que o método pesquisará nas linhas e colunas. Entrada de dados Cadeia de caracteres
    DataColumnIndex Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira coluna. O fornecimento de um valor de índice personalizado é opcional. Se o campo não receber nenhum valor de índice personalizado, o método definirá automaticamente a ordem das colunas. Entrada de dados Números inteiros
    SearchColumnIndex Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira coluna. O fornecimento de um valor de índice personalizado é opcional. Se o campo não receber nenhum valor de índice personalizado, o método definirá automaticamente a ordem das colunas. Entrada de dados Números inteiros
    StartRowIndex Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira linha. O fornecimento de um valor de índice personalizado é opcional. Se o campo não receber nenhum valor de índice personalizado, o método definirá automaticamente a ordem das colunas. Entrada de dados Números inteiros

    VLookUpSet

    Define o(s) valor(es) de célula de uma linha específica se a linha contiver o texto especificado.

    Para inserir os valores, execute as seguintes ações:
    1. Clique no ícone de configurações do método ( ícone Configurações do componente).
    2. Clique no ícone Adicionar valor..
    3. Insira os valores.
    4. Clique em OK.
    Tabela 32. Parâmetros VLookUpSet
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Nome da porta Nome da porta do componente. Entrada de dados Cadeia de caracteres
    SearchText Texto que o método pesquisará nas linhas e colunas. Entrada de dados Cadeia de caracteres
    DataColumnIndex Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira coluna. O fornecimento de um valor de índice personalizado é opcional. Se o campo não receber nenhum valor de índice personalizado, o método definirá automaticamente a ordem das colunas. Entrada de dados Números inteiros
    SearchColumnIndex Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira coluna. O fornecimento de um valor de índice personalizado é opcional. Se o campo não receber nenhum valor de índice personalizado, o método definirá automaticamente a ordem das colunas. Entrada de dados Números inteiros
    StartRowIndex Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira linha. O fornecimento de um valor de índice personalizado é opcional. Se o campo não receber nenhum valor de índice personalizado, o método definirá automaticamente a ordem das colunas. Entrada de dados Números inteiros