Pular para o conteúdo principal

Excel Popule em Power Automate

O que esta ação faz

PDF4me Excel - Popular funde um JSON carga útil em um Excel modelo que contém Marcador Inteligente Aspose campos e retorna um valor preenchido .xlsx Pronto para anexar, armazenar ou enviar. Mapeie o modelo de SharePoint, OneDriveou Dataverse, cole ou construa o JSON a partir de conteúdo dinâmico e encaminhar a planilha preenchida para SharePoint Criar arquivo, Outlook Enviar um e-mail, OneDrive Criar arquivo, Adicionar uma nova linha ao Dataverse, ou Equipes Publicar uma mensagemPastas de trabalho com várias planilhas, recálculo de fórmulas e formatação de números/datas com reconhecimento de localidade são tratados em uma única ação.

Artigos relacionados no blogue(1)

Antes de executar esta ação: autor um Excel modelo com campos de marcador inteligente como &=Itens.NomeDoItemA gramática completa (modificadores, layout de várias folhas, aninhamento) JSON caminhos, manipulação de fórmulas, formatação de culturas) além de modelos de amostra para download e JSON As cargas úteis estão no Excel Preencher sintaxe do modelo página de referência.

Autenticando seu API Solicitar

O PDF4me Conecte o conector em Power Automate requer um válido conexão segurando o seu PDF4me API Chave. Crie a conexão uma vez durante o tempo de projeto do fluxo e, em seguida, a cada PDF4me A ação em seu inquilino a reutiliza.

Fatos importantes que você não deve perder

JSON As chaves de dados devem corresponder aos nomes da fonte de dados do marcador.
Um marcador &=Itens.NomeDoItem requer o JSON conter um Unid matriz de objetos com um Nome do item propriedade. Os nomes dos campos diferenciam maiúsculas de minúsculas (nomeDoItem Não corresponderá Nome do item).
Os índices das planilhas são baseados em 1 e separados por vírgula.
Deixe os índices das planilhas vazios para preencher todas as planilhas. Passe 2 para preencher apenas a segunda planilha, ou 1,3 Para preencher a primeira e a terceira planilhas. Útil para modelos com várias planilhas, onde um sistema upstream possui apenas parte da pasta de trabalho.
As fórmulas são recalculadas por padrão.
A opção Calcular Fórmulas tem como padrão Sim Assim, os totais, somas e células dependentes estarão corretos no momento em que o destinatário abrir o arquivo. Defina para Não Se você quiser recalcular posteriormente e economizar tempo.
Excel - Ação "Preencher" no Power Automate. O conteúdo do arquivo é mapeado a partir de uma etapa "Obter conteúdo do arquivo" do SharePoint. Os dados JSON mostram uma matriz de itens com três registros (A123, B456, C789), cada um contendo ItemName, Qtd e UnitPrice. O nome do arquivo é Populate.xlsx. O número de índices da planilha é 2.

O Excel - Preencher ação configurada em um Power Automate fluxo com o arquivo mapeado de SharePoint, um em linha JSON Matriz de itens e índices de planilha que restringem a mesclagem à planilha 2.

Parâmetros

Obrigatório: Conteúdo do arquivo, JSON Dados. Recomendado: Nome do arquivo (o padrão é Populate.xlsx) e índices de planilha quando o modelo tiver mais de uma planilha. Avançado: Estrito JSON Cadeias de caracteres, configurações de cultura e idioma, calcular fórmulas, prefixo de aspas para estilo.

ParâmetroObrigatórioO que fazExemplo
File ContentYesExcel template (.xlsx) as binary dynamic content from a prior step: SharePoint Get file content, OneDrive Get file content, Dataverse Download file, Outlook Get attachments. The template must contain Smart Marker cells.@triggerOutputs()?['body']
File NameNoTemplate filename including .xlsx extension. Defaults to Populate.xlsx. Used for tracking and as the basis for Output File Name.Populate.xlsx
JSON DataYesJSON object whose top-level keys match the data source names in your markers. May be pasted inline, built from a Compose step, or mapped from a Parse JSON / HTTP step.{"Items":[{"ItemName":"A123","Qty":"55","UnitPrice":"3.05"}]}
Worksheet IndexesNoComma-separated 1-based sheet indexes to populate. Empty = all sheets. Pass 2 for sheet 2 only, 1,3 for sheets 1 and 3.2
Strict JSON StringsNoYes (default) preserves quoted JSON string primitives as text in the Excel cell. No coerces quoted numeric-looking strings into typed numeric values during merge.Yes
Culture & Language SettingsNoStandard culture name controlling number, date, and currency formatting written into cells. Defaults to en-US. Examples: fr-FR, de-DE, ja-JP.en-US
Calculate FormulasNoYes (default) recalculates the workbook after the merge so totals are accurate on open. No skips recalculation to save time when a downstream step will recalc.Yes
Quote Prefix To StyleNoApplies the Excel quote-prefix flag to styled values so cells that look numeric but should stay text (account numbers, ZIP codes with leading zeros) render as text.Yes
Painel de parâmetros avançados da ação Preencher do Excel: Cadeias JSON rígidas: Sim, Configurações de cultura e idioma: inglês (EUA), Calcular fórmulas: Sim, Prefixo de aspas para estilo: Sim

O painel de parâmetros avançados de Excel - A população expõe o Estrito JSON Configurações de texto, cultura e idioma, fórmulas de cálculo e prefixo de aspas para estilo.

Saída

Campo de conteúdo dinâmicoTipoO que contém
Output File ContentBinaryThe populated Excel workbook. Pass into SharePoint Create file, OneDrive Create file, Outlook Send an email with attachment, Dataverse Add a new row, or Teams Post a message with file.
Output File NameStringThe output filename, based on File Name with the .xlsx extension.
SuccessBooleantrue on successful population, false on failure. Use in a Condition step for retry / branching logic.
Error MessageStringShort error description on failure. Empty when Success is true.
Error Details ItemArrayItemised error messages when the engine encountered multiple issues. Empty when Success is true.
Excel - Preencher seletor de conteúdo dinâmico exibindo Conteúdo do Arquivo de Saída, Nome do Arquivo de Saída, Sucesso, Mensagem de Erro e Detalhes do Erro.

Gere conteúdo dinâmico do Excel - ação "Preencher", pronto para ser mapeado em fluxos subsequentes. Microsoft 365 ações.

Forma da resposta bruta

Para referência (ou ao chamar a função subjacente). REST (diretamente no endpoint), o corpo da ação se parece com isto em caso de sucesso:

Resposta HTTP bruta da ação "Preencher" do Excel. Código de status 200, Content-Type application/json. O corpo contém um campo de documento com o arquivo XLSX codificado em Base64, nome do arquivo "Populate.xlsx" e valor de sucesso "true".

Código de status 200, Tipo de conteúdo aplicativo/jsonO corpo carrega documento (Base64 XLSX), nome_do_arquivo, e sucesso. mensagem de erro e o Erros Os arrays só estão presentes em execuções com falha.

Amostra rápida (experimente em 3 minutos)

Duas combinações prontas para uso correspondem às capturas de tela acima. Baixe cada par, arraste o arquivo XLSX para a pasta Conteúdo do Arquivo e cole o conteúdo. JSON em JSON Dados e execução.

Combinação A: Itens simples (corresponde à captura de tela do parâmetro)

Usos modelo.xlsx com Índices de planilhas = 2 (A Planilha2 contém os marcadores de Itens simples usados na captura de tela dos parâmetros). Combine com os Itens planos correspondentes. JSON.

Combo B: fatura detalhada com Excel Mesa

Utiliza a folha de fatura de modelo.xlsx com aninhamento &=RootData.Items.* marcadores, fórmulas de referência estruturadas em um Fatura Simples Tabela, subtotal + imposto + total.

Combinação C: planilha com várias folhas

Modelo de três planilhas demonstrando diferentes fontes de dados em cada planilha. A ordem das planilhas no arquivo é Itens, Funcionários, Produtos.

Exemplos de fluxo

Padrões de fluxo comuns do Power AutomateTypical ways to chain Excel - Populate into a flow.
Lista do SharePoint para planilha de faturas
  1. SharePoint Quando um item é criado, um gatilho é acionado na lista de Pedidos.
  2. SharePoint A opção "Obter itens" extrai os itens correspondentes da lista de Itens do Pedido.
  3. Compose constrói o JSON Carga útil de dados com uma matriz de itens provenientes dos itens de linha.
  4. SharePoint A opção "Obter conteúdo do arquivo" carrega a fatura. Excel modelo.
  5. Excel - Preencher modelo de mesclagem plus JSON.
  6. Outlook Enviar um e-mail ao cliente com o conteúdo do arquivo de saída em anexo.
Relatório mensal de inventário programado
  1. O gatilho de recorrência é acionado no primeiro dia de cada mês às 09:00.
  2. A lista de linhas do Dataverse exibe o estoque atual.
  3. Compose transforma o resultado em um JSON objeto com um array de Produtos.
  4. SharePoint A opção "Obter conteúdo do arquivo" carrega o modelo de 3 folhas.
  5. Excel - Preencher as execuções com os Índices da Planilha definidos como 2 (somente na planilha Produtos).
  6. OneDrive Criar arquivo arquivado com o relatório; o Teams publica uma mensagem com links para ele.
Formulários em resposta à lista de funcionários
  1. No Microsoft Forms, um gatilho é acionado quando uma nova resposta é enviada.
  2. A função "Listar linhas" do Dataverse extrai os funcionários e departamentos relacionados.
  3. Compose constrói o JSON Dados com uma matriz de funcionários.
  4. Excel - Preencher as informações de mesclagem no modelo de lista de RH, com a Cultura definida para a localidade na resposta do Formulário.
  5. Outlook O envio por e-mail entrega a planilha preenchida ao gerente de RH.

Perguntas frequentes

What is the JSON Data field expected to contain?+
A JSON object whose top-level keys match the data source names used in the Smart Markers of your Excel template. For markers like &=Items.ItemName, the JSON must contain an Items array of objects with an ItemName field. Field names are case sensitive.
What syntax do the cells in the Excel template use?+
Aspose Smart Markers. Cells use &=DataSource.FieldName as the marker. Optional modifiers in parentheses control layout: (dynamic), (horizontal), (noadd), (skip:N), (copystyle), (shift), (repeat). See the Excel Populate Template Syntax page for the full grammar with examples.
What does Worksheet Indexes do?+
Restricts the merge to specific sheets. The value is comma-separated 1-based sheet indexes (for example 1,3 to populate the first and third sheet). Leave it empty to populate every sheet in the workbook.
Does Excel Populate recalculate formulas?+
Yes by default. Calculate Formulas is Yes by default so the workbook arrives with totals and aggregates already accurate. Set it to No when you intend to recalculate later in your own pipeline and want to skip the cost.
What does Strict JSON Strings do?+
Yes (default) preserves quoted JSON string primitives as text in the Excel cell. Set No to coerce quoted numeric-looking strings into typed numeric values during the merge. Use the default unless you have a specific reason to convert string primitives.
My template has a sheet I do not want populated. How do I exclude it?+
Use Worksheet Indexes. If your workbook has sheets in order Cover, Data, Notes (indexes 1, 2, 3) and you only want Data populated, pass 2. Cover and Notes stay untouched.
How big can the JSON payload be?+
Practical limits are bounded by the Power Automate action body size cap plus Excel cell limits. For larger payloads, write the JSON to a SharePoint or OneDrive file and reference it via a custom dispatcher pattern, or split the work into one call per sheet using Worksheet Indexes.
Does this work in Power Automate Desktop?+
PDF4me Connect is a cloud connector available in Power Automate (the web flow designer). For Power Automate Desktop, call the Excel Populate REST endpoint with the HTTP action.

Ações relacionadas

Obtenha ajuda