Métodos de conector de tabela

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 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 em Design studio de RPA para desktop. Por exemplo, tarefas como obter uma tabela, obter dados de uma linha e remover linhas vazias.

    Configurável

    Insere uma tabela no fluxo de trabalho. O método configurável deve ser usado antes de você executar outras operações em uma tabela de dados. Você deve fornecer o objeto de tabela que precisa ser definido.
    Tabela 1. Parâmetros configuráveis
    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
    		 Dados em Tabela de dados

    Adicionar coluna

    Adiciona uma coluna a uma tabela. A posição da coluna é determinada pelo valor de índice da coluna especificado. Você deve fornecer o nome da nova coluna e o índice de coluna ao qual a nova coluna precisa ser adicionada.
    Tabela 2. Adicionar parâmetros de coluna
    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. Inteiro

    Adicionar colunas

    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 na tabela de dados.
    Tabela 3. Parâmetros Adicionar colunas
    Nome do Parâmetro Descrição Tipo de dados
    Nomes Aceita nomes de colunas na forma de matriz, lista de matriz ou lista.
    Exemplo
    "OrderId", "CustomerName", "OrderDate", "Status";
    		 IEnumerable

    Adicionar linha

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

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

    1. Clique no ícone de configurações do componente ( Ícone de configurações do componente.).
    2. Clique no ícone Adicionar índice ( Ícone Adicionar índice.).
    3. Insira o índice.
    4. Repita as etapas para adicionar vários índices.
    5. Clique em OK.
      Nota:
      Uma Porta de dados é adicionada a cada linha que você adiciona.
    Tabela 4. Parâmetros de Adicionar linha
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Índice de linha Índice da linha à qual a nova linha precisa ser adicionada. Dados em Inteiro

    Obter tabela

    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 de 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

    Limpar colunas

    Limpa todos os valores de coluna de uma tabela.

    ClearRows

    Limpa todos os valores de linha de uma tabela.

    Excluir ColumnByIndex

    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 Index.
    Tabela 6. Parâmetros Excluir ColumnByIndex
    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. Dados em Inteiro

    ExcluteColumnByName

    Exclui uma coluna com base no nome especificado. Você deve fornecer o nome da coluna que precisa ser excluída.
    Tabela 7. Parâmetros Excluir ColumnByName
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Nome Nome da coluna que deve ser excluída. Dados em 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 Excluir linha
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Índice Índice da linha que precisa ser excluída. Dados em Inteiro

    FiltereClassificar

    Filtra e classifica a tabela com base em uma expressão especificada. Você deve fornecer a expressão para calcular o valor de uma coluna, o nome da coluna a ser classificado em SortColumnName 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 FilterAnd Sort
    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.
    		 Dados em Cadeia de caracteres
    ClasseColumnName Nome da coluna pela qual o método classificará os dados.
    Exemplo
    Data - O método classificará os dados com base na coluna Data.
    		 Dados em Cadeia de caracteres
    Ordem Ordem do nome da coluna Dados em 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 Inteiro

    FiltePorRegEx

    Filtra os dados da tabela com base em uma expressão regular ou RegEx especificada. 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. Dados em Inteiro
    RegExpression Expressão regular que é usada como uma lógica de filtragem. Dados em Cadeia de caracteres
    Retornar Retorna uma DataTable que contém dados filtrados do objeto DataTable subjacente. Saída de dados Tabela de dados
    RowsCount Retorna o número de linhas disponíveis com base no filtro que usa RegExpression. Saída de dados Inteiro

    Texto encontrado

    Encontra 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 a partir da qual a pesquisa deve começar em StartPosition e o tipo de correspondência necessária.
    Tabela 11. Parâmetros de 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"
    		 Dados em Cadeia de caracteres
    Posição inicial Posição da coluna de onde a pesquisa deve começar. Dados em Inteiro
    MatchType 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 do texto especificado deve corresponder ao caso do texto pesquisado.
    • Contém : O texto especificado deve conter um ou mais caracteres do texto pesquisado.
    		 Dados em MatchType
    CellValue Retorna o valor na célula com base na pesquisa. Saída de dados Objeto
    ColIndex Retorna o índice da coluna que tem o texto pesquisado. Saída de dados Inteiro
    Índice de linha Retorna o índice da linha que tem o texto pesquisado. Saída de dados Inteiro

    Valor de célula

    Retorna o valor em uma célula com base nos valores de índice de linha e coluna especificados. 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 da linha da célula necessária. Dados em Inteiro
    Coluna Número da coluna da célula necessária. Dados em Inteiro
    Retornar Retorna o tipo de objeto que representa o valor da célula do objeto DataTable subjacente. Saída de dados Objeto

    IfIfValorCellHas

    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 determinada linha 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 Configurações de método ( Ícone de configurações de método.).
    2. Clique no ícone Adicionar índice de linha ( Adicionar índice de linha.).
    3. Atualize o tipo de dados do valor de índice de linha.
    4. Insira o valor do índice de 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"
    		 Dados em Cadeia de caracteres
    SearchColumnIndex Índice da coluna na qual o texto precisa ser pesquisado. Dados em Inteiro
    Índice de linha inicial Linha inicial a partir da qual a pesquisa precisa ser realizada. Dados em Inteiro
    Encontrado Retorna verdadeiro se o texto corresponder. Saída de dados Booliano

    Valores das cé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 Configurações de método ( Ícone de configurações de método.).
    2. Clique no ícone Adicionar índice de linha ( Adicionar índice de linha.).
    3. Atualize o tipo de dados do valor de índice de linha.
    4. Insira o valor do índice de linha.
    5. Clique em OK.
    Tabela 14. Parâmetros GetCellValue
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Índice de linha Índice da linha cujo valor de célula é necessário. Dados em Inteiro

    GetCount

    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 Inteiro
    Coluna Retorna a contagem total de colunas criadas. Saída de dados Inteiro

    GetRowData

    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
    Índice de linha Valor de índice da linha da qual os dados precisam ser recuperados. Dados em Inteiro
    Retornar Retorna a lista do tipo de objeto que representa dados de linha do objeto DataTable subjacente. . IEnumerable o tipo de dados aceita os dados do valor da linha como matriz, lista ou lista de matriz e retorna como objeto. Saída de dados IEnumerable

    GetTabelaAsCSV

    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/Cliente data.csv
    		 Dados em Cadeia de caracteres
    Delimitador Delimitador que separa os dados da tabela.
    Exemplo
    Vírgula (",")
    		 Dados em Cadeia de caracteres

    GetTableAsHTML

    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. Dados em 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. Dados em Cadeia de caracteres

    CarregoDeExcel

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

    Coluna de correspondência

    Corresponde as colunas de outra tabela de dados com a coluna da tabela atual com base no índice de 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 de Coluna de correspondência
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Tabela de dados Tabela de dados cujas colunas precisam ser correspondidas. Dados em Tabela de dados
    ColumnIndex Índice da coluna com a qual ele deve ser correspondido. Dados em Inteiro
    Retornar Retorna um valor verdadeiro ou falso que indica se a coluna especificada corresponde. Saída de dados Booliano

    RemoveEmptyColunas

    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

    Valor de cé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. Definir parâmetros CellValue
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Linha Número do índice da linha que o método usará para preencher dados. Dados em Inteiro
    Coluna Número do índice da coluna que o método usará para preencher dados. Dados em Inteiro
    Valor Valor que deve ser definido na célula. Dados em Objeto

    SetCellValueIfRowHas

    Define o(s) valor(es) de célula de uma linha específica se a linha contiver 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 a esse parâmetro é o valor real que será definido para a linha da tabela.
    Tabela 25. SetCellValueIfRowHas parâmetros
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    SearchText Texto a ser pesquisado na linha. Dados em Cadeia de caracteres
    SearchColumnIndex Índice da coluna na qual o texto precisa ser pesquisado. Dados em Inteiro
    Índice de linha inicial Linha inicial a partir da qual o texto precisa ser pesquisado. Dados em Inteiro
    Encontrado Retorna verdadeiro se o texto corresponder. Saída de dados Booliano

    SetColumnName

    Atualiza um nome de coluna com base no índice de coluna e no nome que você especificar. Primeiro, você deve criar ou importar uma tabela usando o método configurável.
    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. Dados em Inteiro
    Nome Novo nome da coluna. Dados em Cadeia de caracteres

    SetJson

    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 de 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. Dados em Cadeia de caracteres

    Setlist

    Converte uma lista em uma tabela de dados. Forneça a lista de dados que precisa ser convertida em tabela.
    Tabela 28. Parâmetros de 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. . IEnumerable o tipo de dados de entrada aceita os dados como matriz, lista ou lista de matriz.
    "OrderId": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "Enviado";
    		 Dados em IEnumerable

    SetRowData

    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 Dados.
    Tabela 29. Parâmetros SetRowData
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Índice de linha Número do índice da linha que precisa ser modificada. Dados em Inteiro
    Dados Dados em uma linha inserida em uma tabela de dados. . IEnumerable o tipo de dados de entrada aceita os dados como matriz, lista ou lista de matriz.
    "OrderId": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "Enviado";
    		 Dados em IEnumerable

    ParList

    Converte a tabela especificada em uma lista.
    Tabela 30. ParParâmetros da lista
    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. . IEnumerable o tipo de dados aceita os dados como matriz, lista ou lista de matriz e retorna a lista. Saída de dados IEnumerable

    VLookUp

    Obtém valores de célula de uma linha específica se a linha contiver texto especificado.

    Para inserir os valores, execute as seguintes ações:
    1. Clique no ícone de configurações de método ( Ícone de configurações do componente.).
    2. Clique em Ícone Adicionar valor..
    3. Insira os valores.
    4. Clique em OK.
    Tabela 31. Parâmetros do VLookUp
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Nome da porta Nome da porta do componente. Dados em Cadeia de caracteres
    SearchText Texto que o método pesquisará nas linhas e colunas. Dados em 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. Dados em Inteiro
    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. Dados em Inteiro
    Índice de linha inicial 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. Dados em Inteiro

    VLookUpSet

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

    Para inserir os valores, execute as seguintes ações:
    1. Clique no ícone de configurações de método ( Ícone de configurações do componente.).
    2. Clique em Ícone Adicionar valor..
    3. Insira os valores.
    4. Clique em OK.
    Tabela 32. Parâmetros do VLookUpSet
    Nome do Parâmetro Descrição Tipo de porta de dados Tipo de dados
    Nome da porta Nome da porta do componente. Dados em Cadeia de caracteres
    SearchText Texto que o método pesquisará nas linhas e colunas. Dados em 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. Dados em Inteiro
    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. Dados em Inteiro
    Índice de linha inicial 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. Dados em Inteiro