Métodos de conector de tabela

Configurável

Insere uma tabela no fluxo de trabalho. O método configurável deve ser usado antes de 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 DataTable	Dados em	DataTable

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 no 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 à 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 matrizes 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:

Clique no ícone Configurações do componente ( ).
Clique no ícone adicionar índice ( ).
Insira o índice.
Repita as etapas para adicionar vários índices.
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
Índice de linha	Índice da linha em que a nova linha precisa ser adicionada.	Dados em	Inteiro

GetTable

Retorna a tabela que você criou com os métodos AddColumn, AddColumns e AddRow.

Nota:

Este método deve ser executado 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
DataTable	Retorna o tipo DataTable que representa o objeto DataTable subjacente.	Saída de dados	DataTable

Limpar Colunas

Limpa todos os valores de coluna de uma tabela.

ClearRows

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 de í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.	Dados em	Inteiro

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

ExcluirLinha

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.	Dados em	Inteiro

FilterAndSort

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. 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 "Pendente" - Com base nesta expressão de consulta, os dados são filtrados.	Dados em	Cadeia de caracteres
SortColumnName	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
DataTable	Retorna a tabela de dados que contém dados filtrados do objeto DataTable subjacente.	Saída de dados	DataTable
Contagem	Retorna a contagem de linhas após a classificação.	Saída de dados	Inteiro

FilterPorRegEx

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. Fornecer 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	DataTable
RowsCount	Retorna o número de linhas disponíveis com base no filtro usando RegExpression.	Saída de dados	Inteiro

Texto de destino

Encontra o texto na tabela especificada 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 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

GetCellValue

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

ObterCellValueIfRowHas

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 pelo SearchColumnIndex e comece a pesquisar o texto de uma linha específica fornecida ao StartRow Index. 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.

Clique no ícone Configurações de método ( ).
Clique no ícone adicionar índice de linha ( ).
Atualize o tipo de dados do valor de índice de linha.
Insira o valor de índice de linha.
Clique em OK.

Tabela 13. Parâmetros GetCellValueIfRow
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
StartRow Index	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

GetCellValues

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:

Clique no ícone Configurações de método ( ).
Clique no ícone adicionar índice de linha ( ).
Atualize o tipo de dados do valor de índice de linha.
Insira o valor de índice de linha.
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 da 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

ObrowData

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 GetRow Data
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

LoadFromExcel

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. 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 planilha for fornecido, defina o booliano IsQuery como falso. Você pode testar se os dados foram importados corretamente com o método GetTable.

Tabela 20. LoadFromparâmetros do Excel
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/vendas data.xlsx	Dados em	Cadeia de caracteres
SheetOrQuery	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
IsQuery	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 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 de Coluna de correspondência
Nome do Parâmetro	Descrição	Tipo de porta de dados	Tipo de dados
Tabela de tabela	Tabela de dados cujas colunas precisam ser correspondidas.	Dados em	DataTable
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

RemoveEmptyColumns

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	DataTable

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	DataTable

SetCellValue

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 do índice da linha que o método usará para preencher os 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 os valores 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. Parâmetros SetCellValueIfRow
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
StartRow Index	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 SetJson
Nome do Parâmetro	Descrição	Tipo de porta de dados	Tipo de dados
JSON	O objeto JSON precisa ser convertido em uma tabela de dados.	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 matrizes. "OrderId": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "Enviado";	Dados em	IEnumerable

SetRow Data

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 de SetRow Data
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 que são inseridos em uma tabela de dados. . IEnumerable o tipo de dados de entrada aceita os dados como matriz, lista ou lista de matrizes. "OrderId": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "Enviado";	Dados em	IEnumerable

ToList

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

Clique no ícone Configurações de método ( ).
Clique em .
Insira os valores.
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. Fornecer 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. Fornecer 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
StartRow Index	Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira linha. Fornecer 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 os valores de célula de uma linha específica se a linha contiver texto especificado.

Para inserir os valores, execute as seguintes ações:

Clique no ícone Configurações de método ( ).
Clique em .
Insira os valores.
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. Fornecer 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. Fornecer 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
StartRow Index	Valor inteiro que indica a ordem da coluna a partir da esquerda. O valor de índice padrão é -1 para a primeira linha. Fornecer 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