Adicionar linhas a Excel em Power Automate: JSON para Excel com PDF4me

PDF4me Excel - Adicionar linhas é um Power Automate ação que insere um JSON objeto ou matriz como novas linhas em um Excel planilha, tanto no modo baseado em tabelas com correspondência automática de cabeçalhos quanto no modo baseado em coordenadas com posicionamento exato de células. Use-a para registrar resultados de consultas de banco de dados, envios de formulários ou API respostas diretamente em um Excel relatório.

O que esta ação faz

PDF4me Excel - Adicionar linhas escreve JSON Insere dados de linhas em uma planilha existente, combinando propriedades com cabeçalhos quando o Nome da Tabela está definido ou posicionando os dados em coordenadas exatas quando o campo está vazio. As opções Converter Numérico e Data, Padrão de Formato de Data, Padrão de Formato Numérico e Nome da Cultura controlam como os valores inseridos são digitados e formatados.

Artigos relacionados no blogue

Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.

Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.

Visite o blogue →

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 Excel Solicitações de inserção de linhas de forma segura.

Get your API Key

Fatos importantes que você não deve perder

O nome da tabela é a chave seletora de modo.

Um nome de tabela não vazio ativa a inserção baseada em tabela com correspondência de cabeçalho e número da linha do Excel para a posição. Deixe-o vazio para inserção baseada em coordenadas usando Inserir da Linha e Inserir da Coluna. Misturar ambos os conjuntos de parâmetros em uma única chamada retorna um erro.

O campo de dados está rotulado. JSON Dados da linha

Aceita um único JSON Um objeto para uma linha ou uma matriz de objetos para inserir várias linhas em uma única chamada. Os nomes das propriedades controlam a correspondência do cabeçalho no modo de tabela.

A conversão de tipo requer que a opção esteja ativada.

Os padrões de formato de data, formato numérico e nome da cultura só têm efeito quando a opção "Converter em Numérico e Data" está ativada. Caso contrário, todos os valores são gravados como texto simples.

Mapeie o conteúdo e o nome do arquivo, defina os dados da linha JSON, escolha um nome de tabela ou insira a partir de uma linha/coluna e, em seguida, expanda os parâmetros avançados para conversão de tipo e formatação.

Parâmetros

Obrigatório: O conteúdo do arquivo, o nome do arquivo e os dados da linha JSON devem sempre ser fornecidos. O nome da tabela e o número da linha do Excel aplicam-se somente à inserção baseada em tabela. As opções "Inserir da linha" e "Inserir da coluna" aplicam-se somente à inserção baseada em coordenadas e serão rejeitadas se o nome da tabela também for definido.

Parâmetro	Obrigatório	O que faz	Exemplo
File Content	Required	Base64 content of the source Excel workbook, mapped from SharePoint, OneDrive, or another prior action.	[File Content from Get File]
File Name	Required	Excel filename including extension (.xlsx or .xls), used for processing and output identification.	data.xlsx
JSON Row Data	Required	JSON object or array of objects to insert. Each object becomes one row, property names match table headers in table mode.	[{"Name":"John","Age":30}]
Worksheet Name	Optional	Name of the worksheet to insert into. Defaults to Sheet1 if left blank.	Sheet1
Table Name	Optional	Name of an Excel table for table-based insertion. Leave empty to use coordinate-based insertion instead.	SalesTable
Excel Row Number	Conditional	1-based position within the table, table mode only. Ignored in coordinate mode.	5
Insert From Row	Conditional	1-based worksheet row where insertion starts, coordinate mode only. Errors if Table Name is also set.	10
Insert From Column	Conditional	1-based worksheet column where insertion starts, coordinate mode only. Errors if Table Name is also set.	3
Convert Numeric And Date	Optional	Enables automatic conversion of JSON numbers to Excel numeric values and date-like strings to Excel dates. Default true.	true
Date Format Pattern	Optional	Excel date format applied when Convert Numeric And Date is enabled. Default yyyy-MM-dd.	MM/dd/yyyy
Numeric Format Pattern	Optional	Excel numeric format applied when Convert Numeric And Date is enabled. Default N2.	#,##0.00
Ignore Null Values	Optional	Skips inserting a value for any JSON property that is null when enabled. Default false, which inserts nulls as empty cells.	false
Ignore Attribute Titles	Optional	Makes JSON property name matching case-insensitive against table headers when enabled. Default false.	true
Culture Name	Optional	Culture code used to parse incoming date and number strings before conversion. Default en-US.	en-US

Campos de saída

Campo	Tipo	O que contém
document	Base64	The Excel workbook with the new rows inserted.
Success	Boolean	true if insertion 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
JSON input is required	JSON Row Data is null or empty.	Provide a valid JSON object or array.
Invalid JSON structure	Malformed JSON syntax.	Fix the JSON formatting before mapping it in.
Worksheet not found	The named worksheet does not exist in the workbook.	Use an existing worksheet name or leave it blank for the first sheet.
Table not found	The named table does not exist, table mode only.	Use an existing Excel table name.
ExcelRowNumber must be greater than 0	Excel Row Number is less than 1 in table mode.	Set Excel Row Number to 1 or higher.
InsertFromRow and InsertFromColumn are ignored when TableName is specified	Coordinate parameters were set alongside Table Name.	Clear Table Name for coordinate mode, or clear the coordinate fields for table mode.
No valid data found in JSON input	JSON Row Data was an empty array or had no parseable objects.	Provide at least one valid object in the JSON payload.

Como faço para configurar a adição de linhas em Power Automate?

1. Adicionar PDF4me → Excel - Adicionar linhas para o seu Power Automate fluxo.
2. Mapa Conteúdo do arquivo e Nome do arquivo de uma ação anterior (SharePoint, OneDriveou um conector de banco de dados).
3. Definir JSON Dados da linha ao seu objeto ou conjunto de objetos.
4. Definir Nome da tabela Para inserção baseada em tabela, ou deixe em branco e defina Inserir da linha / Inserir da coluna para inserção baseada em coordenadas.
5. Expand Parâmetros avançados para habilitar Converter valores numéricos e datas e defina a formatação. Execute o fluxo; a planilha atualizada retorna como documento.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Power Automate flow patterns using Add Rows.

Importação de dados de vendas diárias (modo tabela)

1. Um gatilho agendado executa uma consulta SQL para buscar os registros de vendas do dia.
2. Os resultados são convertidos em uma matriz JSON que corresponde aos cabeçalhos das colunas da tabela de vendas.
3. A função "Obter Arquivo" recupera o modelo de relatório de vendas com o nome de tabela "DailySales".
4. A opção Adicionar Linhas insere a matriz com a opção Converter Numérico e Data ativada e o Padrão de Formato Numérico definido para moeda.
5. O relatório atualizado é enviado por e-mail aos gerentes de vendas.

Registro de respostas de formulários (modo de coordenadas)

1. O envio de um formulário do Microsoft Forms inicia o fluxo.
2. O cenário cria um objeto JSON a partir das respostas enviadas.
3. A função Obter Arquivo recupera a planilha de registro de respostas.
4. A opção Adicionar Linhas insere dados na próxima linha disponível usando Inserir da Linha e Inserir da Coluna, deixando o Nome da Tabela em branco.
5. O registro atualizado é salvo novamente em SharePoint.

Exportação de oportunidade de CRM

1. Um gatilho semanal busca novas oportunidades em um CRM conector.
2. Os registros são convertidos em uma matriz JSON com nomes de campos flexíveis.
3. A opção Adicionar Linhas insere dados em uma tabela "Oportunidades" com a opção Ignorar Títulos de Atributos ativada para correspondência de cabeçalho sem distinção entre maiúsculas e minúsculas.
4. O relatório preenchido é distribuído à equipe de vendas.

Dicas práticas

Never set Table Name and Insert From Row together

The two parameter sets belong to different insertion modes. Setting both returns an error, clear one set before running.

JSON Row Data accepts a single object or an array

A bare object inserts one row, an array inserts one row per object. Choose the shape that matches how many rows you are writing.

Excel Row Number is 1-based within the table

Row 1 in table mode is the first data row after the header, not the header itself. Set it accordingly when targeting a specific position.

Culture Name affects parsing, not just display

Set Culture Name to match how your source data formats dates and decimals (for example de-DE for comma decimals), otherwise conversion can misread values.

Ignore Attribute Titles solves case-mismatch headaches

If your JSON property names differ in case from the Excel table headers, enable Ignore Attribute Titles instead of renaming every header or every JSON key.

Folha de dicas

Campo	Valor
Action	Excel - Add Rows
Mode switch	Table Name set = table mode, empty = coordinate mode
JSON Row Data shape	Single object or array of objects
Default worksheet	Sheet1
Type conversion toggle	Convert Numeric And Date = true (default)
Default date/numeric format	yyyy-MM-dd / N2
Default culture	en-US
Output	document (Base64 workbook) + Success + ErrorMessage + Errors

Perguntas frequentes

How do I insert JSON data into Excel in Power Automate?+

Add the PDF4me Excel - Add Rows action, map File Content and File Name from a prior action, set JSON Row Data to your JSON payload, then choose Table Name for table-based insertion or Insert From Row and Insert From Column for coordinate-based insertion.

What is the difference between table-based and coordinate-based insertion?+

Table-based insertion is used when Table Name is provided, JSON property names are matched to the Excel table headers and Excel Row Number sets the position within the table. Coordinate-based insertion is used when Table Name is empty, Insert From Row and Insert From Column set the exact worksheet cell where insertion starts, with no header matching.

Can I insert more than one row at once?+

Yes. Pass a JSON array of objects in JSON Row Data and every object becomes its own inserted row. A single JSON object inserts exactly one row.

What happens if I mix table-based and coordinate-based parameters?+

Setting Insert From Row or Insert From Column while Table Name is also set returns an error, since the two parameter sets belong to different insertion modes. Use one mode's parameters at a time.

How does automatic type conversion work?+

With Convert Numeric And Date enabled, JSON numbers become Excel numeric values formatted with Numeric Format Pattern, and date-like strings become Excel DateTime values formatted with Date Format Pattern. Culture Name controls how the incoming values are parsed before conversion. See <a href="https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-numeric-format-strings" target="_blank" rel="noopener noreferrer">Microsoft's numeric format string reference</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 details.

Casos de uso e aplicações industriais

Sales & Marketing

• Relatórios de Pipeline de VendasInserir dados de oportunidades do CRM em fluxos de vendas do Excel
• Rastreamento de LeadsAdicione novos leads de formulários às planilhas de acompanhamento do Excel.
• Análise de campanhas: Preencher resultados de campanhas de marketing a partir de APIs de análise
• Listas de clientesExportar dados de clientes de bancos de dados para listas de clientes em Excel.

Finance & Accounting

• Registros de transaçõesInserir transações financeiras diárias em planilhas do Excel
• Relatórios de despesasAdicionar comprovantes de despesas de funcionários aos relatórios de despesas do Excel
• Acompanhamento do orçamentoPreencha os modelos de orçamento versus gastos reais com os dados de gastos reais.
• Geração de faturasInserir itens de linha de fatura em modelos de fatura do Excel

Human Resources

• Registros de funcionáriosAdicionar informações de novos funcionários aos bancos de dados de funcionários do Excel
• Controle de PresençaInserir dados de frequência diária em planilhas de horas do Excel
• Processamento da folha de pagamentoPreencha os formulários de folha de pagamento do Excel com as horas trabalhadas.
• Dados de desempenhoAdicione pontuações e métricas de avaliação aos rastreadores de desempenho do Excel.

Operations & Manufacturing

• Atualizações de estoqueInserir alterações nos níveis de estoque em planilhas de inventário do Excel
• Registros de ProduçãoAdicionar dados de produção aos registros de fabricação em Excel
• Métricas de QualidadeInserir os resultados do controle de qualidade em relatórios de controle de qualidade no Excel.
• Registros de manutençãoInserir dados de manutenção de equipamentos em registros de serviço do Excel

Ações relacionadas

Atualizar linhas

Modifique as linhas existentes diretamente na planilha; use esta opção em vez de "Adicionar Linhas" quando os dados já existirem na planilha.

Excluir linhas

Remova linhas obsoletas de uma planilha e combine com a opção Adicionar Linhas para gerenciar todo o ciclo de vida das linhas.

Analisar CSV

Converter um CSV exportar para JSON Primeiro, insira o resultado diretamente em Adicionar Linhas.

Mesma tarefa em outras plataformas

MakeAdicionar linhas

Mesmo JSON-para-Excel módulo de inserção para Make cenários.

n8nAdicionar linhas

Mesmo JSON-para-Excel nó de inserção para n8n fluxos de trabalho, integre-os a um ambiente auto-hospedado ou à nuvem. n8n instância.

ZapierAdicionar linhas

Mesmo JSON-para-Excel etapa de inserção para ZapierConecte-o a gatilhos de banco de dados ou formulário já existentes no seu Zap.

PDF4me APIAdicionar linhas

Chame o mesmo endpoint de inserção de linha diretamente através de REST para integrações personalizadas fora de Power Automate.

Obtenha ajuda

PDF4me ConnectGet your API KeyPower Automate Documentation