Dados e Transformações

Dados tabulares com DataFrames Pandas

Criar DataFrame

data.create_dataframe

Cria DataFrame vazio ou a partir de dados

Como usar

Cria uma tabela de dados (DataFrame) vazia, com as colunas informadas, ou a partir de uma lista de linhas ou de dicionários.

Exemplo: Crie {df} com as colunas Pedido, Cliente e Status para ir acumulando o resultado.

Campos

Campo	Tipo	Padrão	Detalhes
Dados (vazio = tabela vazia)	Texto		Lista de dicionários (ex.: o resultado de Ler CSV ou Para Dicionário) ou lista de listasEx.: `{linhas}`
Colunas	Lista
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Filtrar Linhas

data.filter_rows

Filtra linhas por condição

Como usar

Mantém só as linhas em que a coluna atende à condição (igual, maior, contém, vazio...). O resultado pode substituir a tabela ou ir para outra variável.

Exemplo: Filtre {df} onde Situação é igual a "Pendente" em {pendentes}.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Coluna *	Texto
Condição	Opção	`Igual a`	Opções: Igual a, Diferente de, Maior que, Maior ou igual, Menor que, Menor ou igual, Contém, Não contém, Começa com, Termina com, Está vazio, Não está vazio
Valor	Texto		Só quando «Condição» = «Igual a» ou «Diferente de» ou «Maior que» ou «Maior ou igual» ou «Menor que» ou «Menor ou igual» ou «Contém» ou «Não contém» ou «Começa com» ou «Termina com»
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Selecionar Colunas

data.select_columns

Seleciona colunas específicas

Como usar

Mantém só as colunas escolhidas, na ordem informada.

Exemplo: Selecione Pedido, Cliente e Valor de {df} antes de exportar.

Campos

Campo	Tipo	Padrão
DataFrame *	Variável	`df`
Colunas *	Lista
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Adicionar Coluna

data.add_column

Adiciona nova coluna com expressão

Como usar

Cria uma coluna com um valor fixo ou calculada linha a linha com uma expressão, usando row["coluna"].

Exemplo: Adicione Total com o cálculo row["Qtd"] * row["Preço"].

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Nova coluna *	Texto
Preencher com	Opção	`O mesmo valor em todas as linhas`	Opções: O mesmo valor em todas as linhas, Um cálculo por linha
Valor	Texto		Só quando «Preencher com» = «O mesmo valor em todas as linhas»
Cálculo (row["coluna"]) *	Expressão		Expressão Python calculada em cada linha; row["coluna"] lê os valores da linhaEx.: `row["preco"] * row["quantidade"]`Só quando «Preencher com» = «Um cálculo por linha»
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Remover Coluna

data.remove_column

Remove coluna

Como usar

Remove uma ou mais colunas da tabela.

Exemplo: Remova as colunas Observação e Código interno antes de enviar ao cliente.

Campos

Campo	Tipo	Padrão
DataFrame *	Variável	`df`
Colunas *	Lista
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Ordenar

data.sort

Ordena por uma ou mais colunas

Como usar

Ordena a tabela por uma ou mais colunas, em ordem crescente ou decrescente.

Exemplo: Ordene {df} por Vencimento, do mais antigo para o mais novo.

Campos

Campo	Tipo	Padrão
DataFrame *	Variável	`df`
Colunas *	Lista
Crescente (A→Z, 0→9)	Sim/Não	`Sim`
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Agrupar por

data.group_by

Agrupa e agrega dados

Como usar

Agrupa as linhas pelas colunas escolhidas e calcula totais por grupo (soma, média, contagem, mínimo, máximo).

Exemplo: Agrupe por Cliente com Valor → sum para ter o total vendido a cada cliente.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Agrupar pelas colunas *	Lista
Totais (coluna → função)	Pares chave e valor		Funções: soma, média, mediana, contagem, mínimo, máximo, primeiro, último, únicos. Vazio = conta as linhas
Salvar resultado na variável *	Variável de saída	`df_grouped`

Resultado: guardado na variável df_grouped (Tabela (DataFrame)).

Mesclar / Juntar

data.merge

Junta dois DataFrames

Como usar

Junta duas tabelas pelas colunas em comum, como um PROCV ou JOIN: inner mantém só o que casa; left mantém tudo da esquerda; outer mantém tudo. Se as chaves tiverem nomes diferentes, informe cada lado.

Exemplo: Junte {pedidos} e {clientes} pela coluna CNPJ (left) para trazer o e-mail de cada cliente.

Campos

Campo	Tipo	Padrão	Detalhes
Tabela da esquerda *	Variável	`df`
Tabela da direita *	Variável	`df2`
Colunas em comum (chaves)	Lista
Manter	Opção	`Só as linhas que combinam`	Opções: Só as linhas que combinam, Todas as linhas da esquerda, Todas as linhas da direita, Todas as linhas das duas
Salvar resultado na variável *	Variável de saída	`df_merged`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Chaves na esquerda (nomes diferentes)	Lista
Chaves na direita	Lista

Resultado: guardado na variável df_merged (Tabela (DataFrame)).

Remover Duplicados

data.remove_duplicates

Remove linhas duplicadas

Como usar

Remove linhas repetidas, comparando todas as colunas ou só as escolhidas, e mantém a primeira, a última ou nenhuma das repetidas.

Exemplo: Remova duplicados de {df} pela coluna Pedido, mantendo a última ocorrência.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Comparar as colunas (vazio = todas)	Lista
Manter	Opção	`A primeira ocorrência`	Opções: A primeira ocorrência, A última ocorrência, Nenhuma (remove todas as repetidas)
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Preencher Vazios

data.fill_missing

Preenche valores nulos

Como usar

Preenche células vazias com um valor, com o valor da linha anterior (ffill) ou da seguinte (bfill), em todas ou em algumas colunas.

Exemplo: Preencha os vazios da coluna Desconto com 0.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Preencher com	Opção	`Um valor fixo`	Opções: Um valor fixo, O valor da linha anterior, O valor da linha seguinte
Valor	Texto		Só quando «Preencher com» = «Um valor fixo»
Colunas (vazio = todas)	Lista
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Renomear Colunas

data.rename_columns

Renomeia colunas

Como usar

Troca os nomes das colunas (nome atual → novo nome).

Exemplo: Renomeie "Dt Venc" para Vencimento e "Vlr" para Valor.

Campos

Campo	Tipo	Padrão
DataFrame *	Variável	`df`
Nome atual → novo nome *	Pares chave e valor
Salvar resultado na variável *	Variável de saída	`df`

Resultado: guardado na variável df (Tabela (DataFrame)).

Obter Dimensões

data.get_shape

Retorna nº de linhas e colunas

Como usar

Guarda o número de linhas e de colunas da tabela. Use para saber se veio vazia ou para registrar quantos itens foram processados.

Exemplo: Se {row_count} == 0, registre "Nenhum pedido pendente" e encerre.

Campos

Campo	Tipo	Padrão
DataFrame *	Variável	`df`
Salvar o nº de linhas na variável *	Variável de saída	`row_count`
Salvar o nº de colunas na variável	Variável de saída	`column_count`

Resultado: guardado na variável row_count (Número).

Iterar Linhas

data.iterate_rows

Loop por cada linha do DataFrame

Como usar

Bloco de repetição que percorre cada linha da tabela; a linha atual fica na variável (por padrão {row}) e as colunas são lidas como {row.Coluna}. Os comandos ligados à saída do laço rodam uma vez por linha.

Exemplo: Para cada linha de {pendentes}, digite {row.Pedido} no sistema e grave o status.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável
Variável da linha atual *	Variável de saída	`row`

Resultado: guardado na variável row (Dicionário).

Saídas do bloco: Cada linha.

Para Dicionário

data.to_dictionary

Converte DataFrame para lista de dicts

Como usar

Converte a tabela em lista de dicionários (uma por linha) ou em dicionário de colunas, por exemplo para enviar como JSON a uma API.

Exemplo: Converta {df} em {records} e envie no corpo JSON da Requisição HTTP.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Formato	Opção	`Lista de linhas ([{coluna: valor}, ...])`	Opções: Lista de linhas ([{coluna: valor}, ...]), Dicionário de colunas ({coluna: [valores]})
Salvar resultado na variável *	Variável de saída	`records`

Resultado: guardado na variável records (Lista).

Exportar para Excel

data.export_excel

Salva DataFrame como Excel

Como usar

Salva a tabela num arquivo Excel, substituindo o arquivo ou acrescentando como nova aba.

Exemplo: Exporte {df_resumo} para resumo_{data}.xlsx na aba "Resumo".

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Arquivo Excel *	Arquivo
Planilha	Texto	`Planilha1`
Se o arquivo existir	Opção	`Substituir o arquivo`	Opções: Substituir o arquivo, Adicionar/substituir só esta planilha

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Incluir a coluna de índice	Sim/Não	`Não`

Exportar para CSV

data.export_csv

Salva DataFrame como CSV

Como usar

Salva a tabela em CSV com delimitador, separador decimal e codificação escolhidos. O padrão (ponto e vírgula, vírgula decimal e utf-8-sig) abre certo no Excel em português.

Exemplo: Exporte {df} para retorno.csv com os padrões para o Excel do financeiro.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`df`
Arquivo CSV *	Arquivo
Delimitador	Texto	`;`
Separador decimal	Opção	`Vírgula (1234,56)`	Opções: Vírgula (1234,56), Ponto (1234.56)
Codificação	Opção	`UTF-8 para Excel (com BOM)`	Opções: UTF-8 para Excel (com BOM), UTF-8, Windows (cp1252), Latin-1

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Incluir a coluna de índice	Sim/Não	`Não`