

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tabela de dados
<a name="actions-data-tables"></a>

As ações da tabela de dados permitem que você trabalhe com dados estruturados em formato de tabela. Essas ações permitem que você crie, transforme e produza dados tabulares em suas automações.

## Tabela de classificação
<a name="sort-table"></a>

Ordena uma tabela por coluna. Usado para organizar seus dados em ordem crescente ou decrescente.

**Propriedades:**
+ **Tabela de dados** (obrigatória): a variável da tabela a ser classificada (por exemplo,`my_table`)
+ **Nome da coluna a ser classificada** (obrigatório): nome da coluna pela qual classificar (por exemplo, “Valor total”)
+ **Ordem de classificação** (lista suspensa): escolha “Crescente” (menor primeiro) ou “Decrescente” (maior primeiro) - padrão: Decrescente
+ **Tabela ordenada** (saída): nome da variável para a nova tabela ordenada

## Tabela de filtros
<a name="filter-table"></a>

Mantém as linhas que correspondem a um critério. Usado para extrair linhas relevantes de um conjunto de dados maior.

**Propriedades:**
+ **Tabela de dados** (obrigatória): a variável da tabela a ser filtrada (por exemplo,`my_table`)
+ **Expressão de filtro** (obrigatório): expressão booleana usando nomes e operadores de colunas (==, >, <,\$1 =). Combine as condições com & (AND) ou \$1 (OR). Use aspas simples para nomes de colunas com espaços e valores de texto (por exemplo, “'Equipe' == 'Vendas' e 'Valor total' > 100")
+ **Tabela filtrada** (saída): nome da variável para a tabela filtrada

Filtros de exemplo:

```
# Column 'amount' is greater than 25
"amount > 25"

# Column 'team' equals text 'Sales'
"team == 'Sales'"

# Multiple conditions
"amount > 25 & status == 'active'"

# Grouped conditions
"(amount > 25 & team == 'Sales') | (amount > 50 & team == 'Marketing')"

# Column 'title' contains text 'Director'
"title.str.contains('Director')"

# Column 'Customer No' equals a variable customer_id
"`Customer No` == " + str(customer_id)

# Column 'ProfitCenter' equals variable profitCenter
"`ProfitCenter` == '" + str(profitCenter) + "'"
```

## Valor de pesquisa
<a name="lookup-value"></a>

Pesquisa um valor em uma tabela. Usado para pesquisar um valor em uma coluna e obter o valor correspondente de outra coluna na mesma linha.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela para pesquisar (por exemplo,`my_table`)
+ **Nome da coluna a ser pesquisada** (obrigatório): coluna contendo o valor da pesquisa (por exemplo, “ID do funcionário”)
+ **Valor a ser pesquisado** (obrigatório): o valor a ser encontrado (por exemplo, “12345")
+ **Nome da coluna para saída** (obrigatório): Coluna da qual recuperar o resultado (por exemplo, “Data da contratação”)
+ **Valor da célula** (saída): variável que armazena o valor encontrado. Retorna a primeira partida ou está vazia se não for encontrada.

## Adicionar colunas
<a name="add-columns"></a>

Cria novas colunas em uma tabela. As colunas recém-adicionadas são anexadas ao final da tabela existente.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela a ser modificada (por exemplo,`my_table`)
+ **Nomes de colunas a serem adicionados** (obrigatório): matriz de novos nomes de colunas (por exemplo, ["Nome”, “Endereço"])
+ **Valor padrão** (opcional): valor inicial para todas as células em novas colunas (por exemplo, “N/A”)
+ **Tabela atualizada** (saída): nome da variável para a tabela modificada

## Remover colunas
<a name="remove-columns"></a>

Exclui colunas de uma tabela. Produz uma tabela com todas as colunas restantes.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela a ser modificada (por exemplo,`my_table`)
+ **Colunas a serem removidas** (obrigatório): matriz de nomes de colunas ou números de índice. Os números de índice começam em 0 e podem ser números específicos (por exemplo, [0,1,2]) ou intervalos (por exemplo, intervalo (0,2))
+ **Tabela atualizada** (saída): nome da variável para a tabela modificada

## Mantenha as colunas
<a name="keep-columns"></a>

Elimina colunas extras de uma tabela. Usado para selecionar um subconjunto específico de colunas que você deseja manter.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela a ser modificada (por exemplo,`my_table`)
+ **Colunas a serem mantidas** (obrigatório): matriz de nomes de colunas a serem retidas (por exemplo, ["Nome”, “Endereço"])
+ **Tabela atualizada** (saída): nome da variável para a tabela modificada

## Adicionar nova linha
<a name="add-new-row"></a>

Acrescenta uma nova linha a uma tabela. A nova linha pode ser criada com valores específicos ou como uma linha em branco e é adicionada à parte inferior da tabela.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela a ser modificada (por exemplo,`my_table`)
+ **Valores de linha** (opcional): matriz de valores para a nova linha, começando pela primeira coluna (por exemplo, ["Q1", “Vendas”, 100]). Se estiver vazio, adiciona uma linha em branco. Valores ausentes resultam em células em branco.
+ **Tabela atualizada** (saída): nome da variável para a tabela modificada

## Remover linhas
<a name="remove-rows"></a>

Exclui linhas de uma tabela. Produz uma tabela com todas as linhas restantes.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela a ser modificada (por exemplo,`my_table`)
+ **Linhas a serem removidas** (obrigatório): matriz de posições de linha (indexação baseada em 0). Os números de índice começam em 0 e podem ser números específicos (por exemplo, [0,1,2]) ou intervalos (por exemplo, intervalo (0,2))
+ **Tabela atualizada** (saída): nome da variável para a tabela modificada

## Remover duplicatas
<a name="remove-duplicates"></a>

Exclui linhas duplicadas. Usado para criar um conjunto de dados de linhas exclusivas com base em colunas específicas.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela a ser limpa (por exemplo,`my_table`)
+ **Colunas a serem verificadas** (opcional): matriz de nomes de colunas para detecção de duplicatas (por exemplo, ["Nome”, “Endereço"]). Se estiver vazio, verifica a exclusividade de linhas inteiras. As duplicatas são identificadas por valores combinados em colunas especificadas.
+ **Duplicar linha para manter** (lista suspensa): escolha “Primeira” ou “Última” ocorrência a ser retida (padrão: Primeira)
+ **Tabela atualizada** (saída): nome da variável para a tabela modificada

## Anexar tabelas
<a name="append-tables"></a>

Combina as linhas de duas tabelas. Usado para adicionar dados de uma tabela a outra.

**Propriedades:**
+ **Tabela a ser anexada** (obrigatório): tabela principal recebendo linhas adicionais (por exemplo,) `main_table`
+ **Tabela a ser adicionada** (obrigatória): tabela de origem fornecendo linhas a serem anexadas (por exemplo,) `new_data`
+ **Lidar com diferenças de coluna** (menu suspenso):
  + “Adicionar”: mantenha todas as colunas de ambas as tabelas
  + “Ignorar”: mantenha apenas as colunas correspondentes à tabela primária
  + “Erro”: Exigir correspondências exatas de coluna
+ **Tabela combinada** (saída): nome da variável para a tabela mesclada

## Criar nova tabela
<a name="create-new-table"></a>

Cria uma tabela vazia. Usado para configurar uma tabela com as colunas necessárias para adicionar linhas nas etapas subsequentes. A nova tabela não tem linhas.

**Propriedades:**
+ **Nomes de colunas** (opcional): matriz de nomes de colunas para a nova tabela (por exemplo, ["Nome”, “Endereço"]). Se estiver vazio, cria uma tabela sem colunas.
+ **Nova tabela** (saída): nome da variável para a tabela recém-criada

## Converter texto em tabela
<a name="convert-text-to-table"></a>

Transforma texto delimitado em uma tabela estruturada.

**Propriedades:**
+ **Texto a ser convertido** (obrigatório): texto delimitado contendo dados da tabela (por exemplo, “Ano, quantidade de 2001.100")
+ **Separador de valores** (opcional): valores de separação de caracteres em linhas (padrão: “,”)
+ **Separador de nova linha** (opcional): caracteres separando linhas (padrão: "“)
+ **Tem cabeçalhos** (caixa de seleção): se a primeira linha contém nomes de colunas. Se Verdadeiro, usa a primeira linha como cabeçalhos; se Falso, gera nomes padrão (Coluna0, Coluna1, etc.)
+ **Nova tabela** (saída): nome da variável para a tabela recém-criada

## Converter tabela em HTML
<a name="convert-table-to-html"></a>

Cria uma tabela formatada em HTML. Usado para gerar sua tabela como texto formatado para um documento, e-mail e muito mais.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela a ser formatada (por exemplo,`my_table`)
+ **Texto formatado da tabela** (saída): variável que armazena o texto formatado em HTML

## Exemplos
<a name="data-tables-examples"></a>

**Percorrer as linhas em uma tabela**

Para percorrer as linhas em uma tabela de dados, use a ação “Percorrer itens” em “Fluxo do processo”. Forneça a variável da tabela de dados como entrada para “Coleção de itens”. Atualize a “Referência do item” para que `row` cada item represente uma única linha da tabela.

**Usar ou atualizar valores de células em uma linha**

Ao percorrer as linhas em uma tabela, consulte os valores de células individuais usando a sintaxe de `row["column name"]` onde o nome da coluna é substituído pelo nome da coluna da célula específica.

Para atualizar o valor de uma célula em uma linha, use a ação “Salvar valor” em “Geral”. O “Valor a ser salvo” é o valor com o qual você deseja atualizar a célula. O “Nome da variável” é a referência à célula usando a mesma sintaxe acima,`row["column name"]`.