Pular para o conteúdo principal

Popular Excel em Make

Popular Excel é um PDF4me módulo para Make que preenche um Excel Planilha contendo marcadores inteligentes com funções em tempo real. JSON Processa dados automaticamente, expandindo matrizes linha por linha e recalculando fórmulas em uma única operação. Use-o para gerar modelos de faturas preenchidos, relatórios dinâmicos ou relatórios baseados em dados. Excel saídas de qualquer JSON fonte em seu cenário sem entrada manual de dados.

O que este módulo faz

PDF4me Excel, Popular aceita um Excel modelo com marcadores inteligentes e um JSON carga útil de dados e retorna uma lista totalmente preenchida. Excel caderno de exercícios dentro do seu Make cenário. Matrizes no JSON Expande-se automaticamente em linhas, as fórmulas são recalculadas após a inserção e você pode direcionar planilhas específicas por índice. O resultado é um documento pronto para distribuição. Excel Relatório gerado inteiramente a partir de dados do seu cenário, sem nenhuma entrada manual.

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

Autenticando seu API Solicitar

Todo PDF4me módulo em Make requer um válido ConexãoCrie ou selecione um que contenha o seu PDF4me API chave para que o cenário possa ser autenticado Excel solicitações da população de forma segura.

Fatos importantes que você não deve perder

Os nomes dos Smart Markers devem corresponder. JSON chaves exatamente
Os nomes dos campos em seu JSON A carga útil deve corresponder aos marcadores inteligentes no Excel Modelo exatamente, incluindo maiúsculas e minúsculas. Um marcador. &=Itens.NomeDoItem requer um JSON matriz chamada Unid contendo objetos com um Nome do item propriedade. Uma incompatibilidade deixa o marcador de posição sem substituição na saída. Sempre verifique os nomes das chaves antes de executar o cenário.
As matrizes se expandem automaticamente linha por linha para baixo.
Quando o JSON Se o valor associado a um Marcador Inteligente for uma matriz, o módulo insere uma linha por elemento abaixo da célula do marcador, deslocando as linhas existentes para baixo. Não é necessário pré-dimensionar o modelo para a quantidade esperada de linhas. Isso torna o módulo Preencher adequado para faturas, listas de pedidos e qualquer relatório em que o número de linhas de dados varie em tempo de execução.
Definir como estrito JSON Alterar a opção "Não" para fórmulas numéricas
Com rigor JSON Strings em Sim (o padrão), valores numéricos entre aspas no JSON como "55" são inseridos como texto em ExcelSe uma fórmula SUM subsequente ou outra fórmula precisar tratá-los como números, defina como Estrito. JSON Strings para Não, portanto, o módulo converte strings numéricas entre aspas em números. Excel Valores das células antes da população.
Crie um módulo PDF4me Excel para preencher arquivos, exibindo o campo Conexão, o arquivo definido como Dropbox - Baixar um arquivo e uma área de texto com dados JSON contendo um array de itens com os campos NomeDoItem, Quantidade e PreçoUnitário.

Mapa Conexão, definir Arquivo para Dropbox ou Mapa, e passe um JSON carga útil cujas chaves correspondem aos nomes dos campos do Smart Marker em seu Excel modelo.

Parâmetros

Obrigatório: Conexão, Arquivo (origem) e JSON Os dados devem ser fornecidos. Todos os outros campos são opcionais. Para obter uma referência da sintaxe do Smart Marker, consulte o Documentação do Aspose Cells WorkbookDesignerPara códigos culturais, consulte o Referência de nome de cultura Microsoft BCP 47.

ParâmetroObrigatórioO que fazExemplo
ConnectionRequiredPDF4me Excel API connection. Click Add and paste your API key if connecting for the first time.My PDF4me Excel connection
FileRequiredFile source mode. Map supplies the Excel template binary from a prior module output. Dropbox - Download a File pulls directly from Dropbox, reducing the number of modules needed.Map
File NameOptionalExcel template filename including extension (.xlsx). Map from the prior module file name output or enter a static value. Used to identify the template and name the output file.invoice-template.xlsx
DocumentRequiredBinary content of the Excel template workbook. Map from a Google Drive download, SharePoint file, email attachment, or HTTP response. Must be the raw file buffer.1. Data
JSON DataRequiredJSON string whose keys match the Smart Marker placeholders in the Excel template. Arrays expand row by row. Scalar values fill single cells. Pass as a mapped string from a prior module or a static JSON literal.{"Items":[{"ItemName":"A123","Qty":"55","UnitPrice":"3.05"}]}
Strict JSON StringsNoYes (default): inserts quoted string values as text in Excel. No: coerces quoted numeric strings to numeric cell values so formulas can operate on them. Empty behaves like Yes.Yes
Culture & Language SettingsNoBCP 47 locale code controlling date and number formatting in the output. Defaults to en-US (MM/DD/YYYY, period decimal). Change to match your data source locale: de-DE, fr-FR, and so on.en-US
Calculate FormulasNoYes (default): recalculates all workbook formulas after JSON data is inserted. No: skips recalculation. Enable when the template contains SUM, VLOOKUP, or other formulas that depend on the populated values.Yes
Worksheet IndexesNoComma-separated 1-based indexes of worksheets to populate. Enter 1 for the first sheet only, 1,3 for first and third. Leave empty to populate all worksheets in the workbook.1
Quote Prefix To StyleNoYes: converts Excel quote-prefix formatting to visible cell style. No: removes it. Empty (default): preserves existing quote-prefix behavior without conversion. Use Empty unless your template specifically requires style conversion.Empty
Criar PDF4me Excel: Preencher configurações avançadas mostrando Strings JSON estritas: Sim, Configurações de cultura e idioma: en-US, Calcular fórmulas: Sim, Índices da planilha: 1 e Prefixo de citação para estilo: Vazio

Configurações opcionais: Estrito JSON Cordas, Contextos culturais e linguísticos, Fórmulas de cálculo, Índices de planilhas, e Prefixo de citação para estilo. Definir Calcular fórmulas: Sim Assim, as fórmulas da planilha refletem os dados inseridos.

Saída

CampoTipoO que contém
documentBase64 StringThe fully populated Excel workbook encoded as Base64. Decode it with a Make Tools module, then pass the binary to a Google Drive upload, email attachment, Dropbox create-file, or HTTP POST to distribute the report.
FileNameStringOutput filename for the populated workbook, derived from the input template name. Use this as the target filename when saving to cloud storage to preserve the original naming convention.
SuccessBooleanTrue if the template was populated without errors. Add a Make filter on this field before routing the output to avoid processing incomplete results from failed runs.

Amostra rápida (experimente em 3 minutos)

Duas combinações prontas para uso correspondem às capturas de tela acima. Baixe cada par e mapeie o arquivo XLSX para... Documento (ou use) Dropbox modo de arquivo), cole o JSON em JSON DadosE execute o cenário uma vez.

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.

Como preencher um Excel Modelo em Make

  1. Abra o seu Excel Use um modelo e insira marcadores inteligentes nas células onde os dados devem aparecer: &=ObjectName.FieldName para valores escalares e &=ArrayName.FieldName para matrizes que se expandem linha por linha.
  2. Adicionar PDF4me Excel para o seu Make cenário e selecionar Excel - Popular.
  3. Selecione ou crie um Conexão com o seu PDF4me API chave.
  4. Definir Arquivo para Mapa e conectar Nome do arquivo e Documento de um Google Drive, SharePoint, ou Dropbox Baixe o módulo. Ou defina o arquivo para Dropbox - Baixar um arquivo Para extrair o modelo diretamente.
  5. Mapa JSON Dados de um módulo anterior que produz um JSON string, ou cole um estático JSON literal. Certifique-se de que cada chave corresponda ao nome do campo Smart Marker correspondente no modelo.
  6. Definir Fórmulas de cálculo para Sim Se o modelo contiver fórmulas que dependem de valores preenchidos, insira-as. Índices de planilhas Para selecionar apenas planilhas específicas ou deixar todas em branco.
  7. Clique Salvar e corra. Decodifique o documento saída e direcioná-la para um upload de armazenamento em nuvem, e-mail ou API Conforme necessário.

Quando devo usar o recurso "Preencher"? Excel em Make?

Quando devo usar a função "Preencher Excel" no Make?Common Make automation patterns using the Populate Excel module.
Gere faturas automaticamente a partir dos dados do pedido.
  1. Um webhook recebe uma nova carga útil de pedido contendo detalhes do cliente e itens de linha como um JSON variedade.
  2. O cenário baixa um modelo de fatura personalizado de Google Drive.
  3. Popular Excel mapeia a ordem JSON para Marcadores Inteligentes no modelo, expandindo uma linha por item e recalculando a fórmula total.
  4. A fatura preenchida é enviada por e-mail ao cliente e carregada na pasta do cliente em SharePoint.
Preencher relatórios semanais de KPIs a partir de um banco de dados API
  1. Um gatilho programado semanalmente é acionado e chama um REST API para recuperar as métricas de KPI mais recentes como JSON.
  2. O cenário extrai um modelo de relatório de KPIs de Dropbox usando o recurso integrado Dropbox modo de arquivo.
  3. Popular Excel Insere os valores das métricas nas células do modelo e recalcula as fórmulas de tendência.
  4. O relatório finalizado é publicado em um canal do Slack e salvo em uma pasta de arquivo com data. Google Drive.
Preencher por cliente Excel resumos de CRM exportações
  1. A CRM O webhook é acionado quando um negócio é marcado como fechado e ganho, fornecendo dados do cliente e do negócio como JSON.
  2. O cenário baixa um modelo de resumo de negócio de SharePoint Visando apenas o Índice da Folha de Trabalho 1.
  3. Popular Excel Preenche o modelo com o nome do cliente, o valor do negócio e os itens da linha de produtos.
  4. O resumo preenchido é carregado na pasta do cliente e uma tarefa é criada na ferramenta de gerenciamento de projetos para a equipe da conta.

Perguntas frequentes

How do I auto populate an Excel template with data in Make?+
Use the PDF4me Excel - Populate module. Create an Excel template with Smart Marker placeholders such as &=Items.ItemName, then pass a matching JSON string in the JSON Data field. The module replaces every placeholder with the corresponding value from the JSON, expands arrays into rows, and returns the filled workbook ready for distribution.
What are Smart Markers and how do I write them in Excel?+
Smart Markers are placeholder strings placed in Excel cells that the Populate module replaces with live JSON data at run time. Write them as &=ObjectName.FieldName for scalar values or &=ArrayName.FieldName for arrays. For example, placing &=Items.ItemName in a cell tells the module to insert the ItemName property from each element of the Items JSON array, one per row.
What does Calculate Formulas do and when should I enable it?+
Calculate Formulas: Yes (the default) triggers a full workbook formula recalculation after the JSON data is inserted. Enable it whenever the template contains SUM, VLOOKUP, IF, or other formulas that reference the populated cells, so the formula results reflect the new data. Set it to No only if formula recalculation is unnecessary or handled downstream.
How do I populate only specific worksheets and not the whole workbook?+
Enter the 1-based worksheet indexes as a comma-separated list in the Worksheet Indexes field: for example 1 for the first sheet only, or 1,3 for the first and third. Leave the field empty to populate all worksheets. This is useful when the template contains data sheets with Smart Markers alongside static reference or chart sheets you do not want the module to modify.
What is the difference between Strict JSON Strings Yes and No?+
With Strict JSON Strings set to Yes (the default), string values in the JSON such as '55' are inserted into Excel cells as text. With No, quoted numeric strings are coerced to numeric Excel values. Choose No when downstream formulas such as SUM need to treat those values as numbers rather than text strings.
What does Quote Prefix To Style do?+
Quote Prefix To Style controls whether Excel quote-prefix cell formatting (a hidden attribute that forces text interpretation of cell content) is converted to a visible cell style in the output workbook. Leave it at Empty (the default) for standard behavior. Set Yes only if your template uses quote-prefix styling and you need that to appear as a visible format in the populated output.

Módulos relacionados

Obtenha ajuda