Pular para o conteúdo principal

Preencha o Excel no Zapier

Excel - Preencher é uma ação do Zapier que preenche um modelo .xlsx com dados JSON e retorna a planilha preenchida, preservando todos os estilos de célula, fórmulas e regiões mescladas. Use-a quando você já tiver um layout do Excel personalizado e quiser inserir novos dados automaticamente. A ação recebe um arquivo de modelo e uma carga útil JSON e retorna uma planilha preenchida. .xlsxAssim, você pode enviar por e-mail, fazer upload ou arquivar sem precisar colar manualmente.

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 sua solicitação de API

Cada módulo do PDF4me no Zapier requer uma conexão válida. Crie ou selecione uma conexão que contenha sua chave de API do PDF4me.

Fatos importantes que você não deve perder

O layout do modelo é preservado exatamente.
A função "Preencher" opera nos valores das células, não nos estilos. Fontes, cores, bordas, células mescladas, alturas de linhas, larguras de colunas, imagens e fórmulas definidas no modelo são mantidas. Somente as células que você selecionar para preenchimento serão alteradas.
O modelo precisa de marcadores inteligentes ou de uma tabela.
O PDF4me grava JSON em células que contêm marcadores inteligentes da Aspose, como por exemplo... &=Itens.NomeDoItem ou então, insira uma planilha do Excel cujos cabeçalhos de coluna correspondam aos nomes dos campos JSON. Uma planilha em branco produz uma saída vazia.
O campo "Modelo" espera um arquivo, não uma URL.
Mapa 2. Arquivo A partir de uma etapa "Obter arquivo" do Dropbox/Google Drive/OneDrive. O URL do modelo é válido apenas para modelos públicos servidos por HTTPS e permanece em branco sempre que você estiver passando um arquivo mapeado.
Zapier Excel - Ação de preenchimento: guia Configurar mostrando o Modelo mapeado para 2. Arquivo, URL do Modelo vazia, Nome do Modelo montado a partir de 2. Nome do Arquivo mais 2. Extensão do Arquivo .xlsx e Dados JSON contendo uma matriz de Itens com objetos que possuem os campos ItemName, Qty e UnitPrice.

Na parte superior da tela de Configuração, mapeie o modelo a partir do arquivo de saída da etapa anterior e, em seguida, construa o nome do modelo concatenando o nome do arquivo e a extensão do arquivo. Os dados JSON são a carga útil que o PDF4me grava no modelo.

O que é o recurso "Preencher Excel" no Zapier?

O recurso "Preencher" do Zapier é uma ação do PDF4me que preenche um modelo .xlsx predefinido com dados de um payload JSON. Ele aceita um arquivo de modelo e um objeto JSON, retornando uma planilha preenchida. Ao contrário de um conversor online de JSON para Excel que transforma tudo em uma grade simples, o recurso "Preencher" preserva o layout do modelo, permitindo que relatórios, faturas e dashboards personalizados sejam gerados a cada acionamento sem alterações na formatação.

Parâmetros

ParâmetroObrigatórioO que fazExemplo
TemplateConditionalThe .xlsx template file. Map from a Dropbox / Drive / OneDrive Get File step. Required unless Template URL is set.2. File
Template URLConditionalPublic HTTPS URL to fetch the template. Used only when Template is blank.https://example.com/tpl.xlsx
Template NameRequiredFilename with extension. Used for output naming and downstream mapping. Typically built by concatenating File Name and File Ext from the prior step.Items.xlsx
JSON DataRequiredData payload to write into the template. Object keys must match Smart Markers or table column headers.{"Items":[{"ItemName":"A123","Qty":"55","UnitPrice":"3.05"}]}
Strict JSON StringsOptionalWhen True, quoted numbers stay as strings in the output cells. When False, they auto-convert to numeric cells.True
Culture & Language SettingsOptionalLocale used to parse date and numeric cells. Does not modify stored values.en-US
Calculate FormulasOptionalWhen True, formulas in the template are evaluated after population so totals open pre-computed.True
Worksheet IndexesOptional1-based index of the worksheet(s) to populate. Comma-separated for multiple sheets in one call.1 (or 1,3)
Quote Prefix To StyleOptionalWhen True, cells beginning with a single quote are styled as text rather than treated as a prefix character.False
No Zapier Excel, a guia "Configurar" foi exibida com a opção "Strings JSON rígidas" definida como "Verdadeiro", "Configurações de cultura e idioma" como "en-US", "Calcular fórmulas" como "Verdadeiro", "Índices da planilha" como 1 e "Prefixo de citação para estilo" como "Falso".

Opções avançadas. JSON estrito ativado e Calcular fórmulas ativado são as duas configurações padrão que você quase nunca deve alterar. Ajuste os índices da planilha somente se a área de dados do modelo estiver em uma planilha diferente da primeira.

Saída

CampoTipoO que contém
FileBinaryThe populated .xlsx workbook. Map into a Dropbox / Drive / OneDrive Upload File step, or attach it in Gmail / Outlook Send Email.
File NameStringThe Template Name you provided in the Configure tab. Useful when the upload step needs both file bytes and a filename separately.

Como funciona a função "Preencher Excel" no Zapier?

O Zapier envia os bytes do arquivo de modelo e a carga útil JSON para o PDF4me. /api/v2/PopulateExcelTemplate O endpoint. O PDF4me abre o modelo com o Aspose Cells, resolve cada marcador inteligente ou vinculação de tabela ao JSON, avalia quaisquer fórmulas dependentes e retorna o arquivo .xlsx preenchido como um fluxo de bytes codificado em Base64 que o Zapier exibe como o File saída. De acordo com o Documentação do Zapier sobre campos de arquivo, que o arquivo de saída pode ser inserido em qualquer ação subsequente que aceite um arquivo como entrada, sem a necessidade de uma etapa manual de codificação ou decodificação.

Perguntas frequentes

Quais tipos de arquivo posso usar com o Excel - Preencher?+
O modelo deve ser um arquivo .xlsx (Excel 2007 ou posterior). Os dados são fornecidos em formato JSON, seja colados diretamente no campo "Dados JSON" ou mapeados a partir de uma etapa anterior que gera JSON. Modelos .xls antigos devem ser salvos novamente como .xlsx antes do uso.
Como faço para converter JSON para Excel no Zapier?+
Crie um modelo .xlsx com os Marcadores Inteligentes da Aspose (como &=Itens.NomeDoItem) ou uma tabela cujos cabeçalhos de coluna correspondam aos nomes dos campos JSON, use o Excel - Preencher para gravar as linhas JSON nesse modelo. A saída preserva todos os estilos, fórmulas e regiões mescladas do modelo. Veja o Referência dos Marcadores Inteligentes Aspose para a sintaxe exata do marcador.
Qual o custo em créditos do Excel - Populate?+
Excel - A função Preencher consome um crédito PDF4me por execução, independentemente do número de linhas que o payload JSON contém. As contas gratuitas incluem uma franquia diária de créditos; os planos pagos aumentam esse limite. Consulte a página de preços para a alocação atual por nível.
Posso preencher várias planilhas ao mesmo tempo?+
Sim. Defina os índices da planilha como uma lista separada por vírgulas, como por exemplo: 1,3 e formata a carga útil JSON como uma matriz de matrizes, uma para cada planilha de destino. Uma única chamada preenche todas as planilhas listadas em uma única solicitação do PDF4me, economizando créditos e tempo de uso da tarefa do Zapier.
Por que a função "Preencher" do Excel está retornando uma planilha vazia?+
O modelo não possui marcadores inteligentes Aspose nem uma tabela do Excel com cabeçalhos de coluna correspondentes. O PDF4me preenche os dados combinando os nomes dos campos JSON com os marcadores do modelo. Abra o modelo e adicione marcadores como: &=Itens.NomeDoItem na primeira linha da área de dados, ou converta o intervalo de dados em uma tabela cujos cabeçalhos de coluna correspondam às chaves JSON.