Analisar CSV para JSON em Power Automate com PDF4me

PDF4me CSV - Converter para JSON é um Power Automate ação que converte um CSV arquivo em uma estrutura JSON array com um sistema de prioridade de cabeçalho de três níveis e delimitador configurável. Use-o para alimentar CSV exporta para bancos de dados, REST APIs, ou Excel, sem precisar escrever um analisador personalizado em seu fluxo.

O que esta ação faz

PDF4me CSV - Converter para JSON lê um CSV arquivo e retorna um Base64-codificado JSON Matriz de objetos, com cabeçalhos de coluna, opção "Ignorar primeira linha" e nome da cultura controlando como as linhas e os cabeçalhos são interpretados. Qualquer delimitador funciona e linhas malformadas são tratadas corretamente, sem interromper o fluxo.

Como faço para autenticar minha conta? Power Automate Fluxo?

Todo PDF4me ação em Power Automate Requer uma conexão válida. Crie ou selecione uma que mantenha sua conexão ativa. PDF4me API chave para que o fluxo possa autenticar CSV Analisando solicitações com segurança.

Get your API Key

Fatos importantes que você não deve perder

O tratamento de cabeçalhos possui uma prioridade estrita de 3 níveis.

Os cabeçalhos de coluna são selecionados se fornecidos (todos). CSV (A linha se torna dados). Caso contrário, "Ignorar primeira linha" (definido como verdadeiro) usa a primeira linha. CSV linha como cabeçalhos. Se ambos estiverem vazios, os cabeçalhos serão gerados automaticamente como Coluna1, Coluna2 e assim por diante.

O nome da cultura é um parâmetro avançado que pode passar despercebido.

Oculto em Parâmetros avançados, ao lado de Cabeçalhos de coluna e Ignorar primeira linha, o Nome da cultura define a localidade usada para interpretar formatos de número e data específicos da região. CSV.

A análise sintática é permissiva, não estrita.

Linhas com menos valores do que cabeçalhos recebem strings vazias, linhas com mais valores têm os valores extras ignorados e dados malformados retornam uma matriz vazia em vez de gerar um erro.

Parâmetros

Obrigatório: Conteúdo do arquivo, nome do arquivo e CSV É necessário fornecer um delimitador. Os parâmetros avançados opcionais incluem Cabeçalhos de coluna, Ignorar primeira linha e Nome da cultura.

Parâmetro	Obrigatório	O que faz	Exemplo
File Content	Required	Base64 content of the source CSV file, mapped from SharePoint, OneDrive, or an email attachment.	`[File Content from Get File]`
File Name	Required	CSV filename including extension, used for processing and output identification.	`data.csv`
CSV Delimiter	Required	Character or short string separating columns. Comma, semicolon, tab, and pipe are all supported, as are multi-character delimiters.	`,`
Column Headers	Optional	Comma-separated custom header names. When provided, every CSV line including the first is treated as data and Skip First Line is ignored.	`FullName,Age,Email`
Skip First Line	Optional	When true and Column Headers is empty, uses the first CSV line as headers and starts data from the second line. Default false.	`true`
Culture Name	Optional	Locale used to interpret region-specific number and date formats in the CSV content.	`en-US`

Campos de saída

Campo	Tipo	O que contém
`document`	Base64	The parsed JSON array, UTF-8 encoded and Base64 wrapped.
`FileName`	String	Fixed output filename, "parsed_data.json".
`Success`	Boolean	true if parsing completed, false if the action failed.
`ErrorMessage`	String	Error description, null when Success is true.
`Errors`	Array	Detailed error objects with Code and Message, empty when Success is true.

O que significam as mensagens de erro comuns?

Mensagem de erro	Causa	Solução
Request is empty	Request object is null.	Provide a valid request object.
Document is empty	Document object is null or CSV content is null.	Provide valid CSV file content.
Encoding exceptions	CSV content is not UTF-8 encoded.	Re-save or export the CSV file as UTF-8.
Empty array output	CSV content is empty or contains only a header row.	Provide a CSV file with at least one data row.

Como faço para configurar o Parse? CSV em Power Automate?

Adicionar PDF4me → CSV - Converter para JSON para o seu Power Automate fluxo.
Mapa Conteúdo do arquivo e Nome do arquivo de uma ação anterior (SharePoint, OneDrive(ou anexo de e-mail).
Definir Delimitador CSV para corresponder ao seu arquivo de origem (vírgula, ponto e vírgula, tabulação ou barra vertical).
Expand Parâmetros avançados e definir Cabeçalhos de coluna para nomes personalizados, ou Pular a primeira linha Para usar a própria linha de cabeçalho do arquivo.
Execute o fluxo, decodifique o documento Base64 saída, e percorra o resultado em um loop. JSON matriz com Aplicar a cada.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Power Automate flow patterns using Parse CSV.

Importação de CSV para banco de dados

A CSV O arquivo aterrissa em um SharePoint A pasta "Importações" inicia o fluxo.
O Parse CSV o converte em JSON com CSV Delimitador definido como vírgula e opção "Ignorar primeira linha" ativada.
O documento de saída é decodificado e analisado em partes individuais. JSON objetos.
O método `apply to each` percorre os registros e os insere por meio de um conector SQL.
O processado CSV é movido para uma pasta "Arquivo".

Exportação europeia para API REST

Um sistema de origem envia um e-mail delimitado por ponto e vírgula CSV exportar.
A função Parse CSV é executada com CSV Delimitador definido como ponto e vírgula e opção "Ignorar primeira linha" ativada.
Cada registro analisado é publicado em um REST API ponto final com HTTP.
Os códigos de resposta são coletados para sinalizar quaisquer registros com falha.
Um resumo é enviado por e-mail assim que o ciclo for concluído.

Conversão de CSV para Excel com cabeçalhos personalizados

Um relatório legado chega como um arquivo delimitado por tabulações. CSV Sem linha de cabeçalho.
A função Parse CSV é executada com CSV Delimitador definido como tabulação e cabeçalhos de coluna definidos explicitamente.
O resultado JSON matriz alimenta um PDF4me A ação Adicionar Linhas serve para preencher um modelo do Excel.
A planilha do Excel formatada é enviada por e-mail às partes interessadas.

Dicas práticas

Column Headers overrides Skip First Line completely

If you set Column Headers, Skip First Line is ignored and every CSV row, including what looks like a header row, is treated as data. Do not set both expecting them to combine.

Match the delimiter exactly to the export locale

European CSV exports commonly use a semicolon instead of a comma, especially when the source system uses comma as the decimal separator. Check a sample row before hardcoding the delimiter.

Decode document before parsing further

The document output is Base64-encoded JSON text, not a ready-to-use object. Decode it first, then use Parse JSON to expose individual fields for Apply to each.

Set Culture Name for non-US number formats

If the CSV uses comma as a decimal separator or day-first dates, set Culture Name to match (for example de-DE or en-GB) so downstream conversions do not misread values.

Treat empty output as a signal, not a crash

An empty array back from Parse CSV usually means the file only had a header row or was empty, not that the flow failed. Check Success and Errors before assuming the source file is fine.

Folha de dicas

Campo	Valor
Action	`CSV - Parse to JSON`
Header priority	`Column Headers > Skip First Line > auto-generated`
Common delimiters	`, (comma) / ; (semicolon) / \t (tab) / \| (pipe)`
Output filename	`parsed_data.json (fixed)`
Output format	`document (Base64 JSON array)`
Malformed data behavior	`Returns empty array, does not error`

Perguntas frequentes

How do I parse a CSV file to JSON in Power Automate?+

Add the PDF4me CSV - Parse to JSON action, map File Content and File Name from a prior action, set the CSV Delimiter, then choose Column Headers or Skip First Line for header handling. The action returns document, a Base64 JSON array you can decode and loop through.

What is the header priority order?+

Column Headers takes priority if provided, every CSV line including the first is treated as data. If Column Headers is empty and Skip First Line is true, the first CSV line becomes the headers. If both are empty, headers are auto-generated as Column1, Column2, and so on.

What happens with malformed or empty CSV data?+

CSV parsing is permissive. Rows with fewer values than headers are filled with empty strings, rows with more values than headers have the extras ignored, and empty or header-only CSV content returns an empty JSON array rather than an error.

What does the Culture Name parameter do?+

Culture Name is an advanced parameter that sets the locale used when interpreting the CSV content, useful when the source file uses region-specific number or date conventions that differ from the default parsing culture.

Can I parse semicolon or tab-delimited CSV files?+

Yes. CSV Delimiter accepts any character or short string, including semicolon for European exports, tab for TSV files, or pipe for database exports. Multi-character delimiters are also supported. See <a href="https://www.rfc-editor.org/rfc/rfc4180" target="_blank" rel="noopener noreferrer">RFC 4180, the common CSV format specification</a> and <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">the PDF4me Power Automate connector reference</a> for background.

Casos de uso e aplicações industriais

IT & System Integration
Finance & Accounting
Sales & Marketing
Human Resources
Operations & Supply Chain

Integração de sistemas legadosConverter exportações CSV de sistemas legados para JSON.
Feed de dados da APIConverter dados CSV em JSON para consumo via API REST
Migração de banco de dadosAnalisar arquivos CSV para operações de importação de banco de dados
Processamento de arquivos de logAnalisar arquivos de log em formato CSV para fins de análise.