What are Smart Markers and how do I use them in Excel?

Smart Markers are placeholder strings you place in Excel cells that the PDF4me Populate module replaces with live data at run time. Use the format &=ObjectName.FieldName for scalar values or &=ArrayName.FieldName to expand an array row by row. For example, &=Items.ItemName in a cell is replaced by the ItemName value from a JSON array named Items.

What does the Calculate Formulas option do?

When Calculate Formulas is set to Yes (the default), the module recalculates all formulas in the workbook after inserting the JSON data. This ensures that SUM, VLOOKUP, and other formulas reflect the newly populated values. Set it to No only if you want to preserve the formula results from before population, or if recalculation is handled downstream.

How do I target specific worksheets for population?

Enter comma-separated 1-based worksheet indexes in the Worksheet Indexes field: for example 1,3 to populate the first and third sheets only. Leave the field empty to populate all worksheets in the workbook. This is useful when your template contains both data sheets with Smart Markers and static reference sheets you do not want to modify.

What does Strict JSON Strings control?

When Strict JSON Strings is Yes (the default), string values in the JSON payload are inserted into Excel cells as plain text, preserving their exact string representation. Set it to No to coerce quoted string primitives, allowing numeric strings like '55' to be treated as numbers in Excel rather than text. Use No when downstream formulas depend on numeric types.

Doldurmak Excel içinde Make

Q: How do I auto populate an Excel template with data in Make?

Use the PDF4me Excel - Populate module in Make. Create an Excel template with Smart Marker placeholders such as &=Items.ItemName, then pass a matching JSON payload in the JSON Data field. The module replaces every placeholder with the corresponding value from your JSON, row-expanding arrays automatically, and returns a fully populated Excel file.

Q: What does Quote Prefix To Style do?

Quote Prefix To Style controls whether Excel quote-prefix formatting (a hidden attribute that forces text interpretation) is converted to visible style formatting in the output. Leave it set to Empty (the default) for standard behavior. Set Yes only if your template uses quote-prefix styling and you need that behavior reflected in the output cell styles.

Doldurmak Excel bir PDF4me modül için Make bir Excel Canlı özelliklere sahip Akıllı İşaretleyici yer tutucuları içeren çalışma kitabı JSON Verileri otomatik olarak işler, dizileri satır satır genişletir ve formülleri tek bir işlemde yeniden hesaplar. Doldurulmuş fatura şablonları, dinamik raporlar veya veri odaklı sonuçlar oluşturmak için kullanın. Excel herhangi birinden gelen çıktılar JSON Senaryonuzda manuel veri girişi gerektirmeyen kaynak.

Bu modülün işlevi

PDF4me ExcelNüfuslandırın kabul eder Excel Akıllı İşaretleyici yer tutucuları ve bir şablon içeren bir şablon. JSON veri yükünü alır ve tamamen doldurulmuş bir liste döndürür. Excel çalışma kitabınızda Make Senaryodaki diziler. JSON Otomatik olarak satırlara genişler, formüller eklendikten sonra yeniden hesaplanır ve dizine göre belirli çalışma sayfalarını hedefleyebilirsiniz. Sonuç, dağıtıma hazır bir üründür. Excel Bu rapor, tamamen sizin senaryonuzdaki verilerden oluşturulmuştur ve hiçbir manuel giriş içermez.

İlgili Blog Yazıları

Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.

Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.

Blogu ziyaret edin →

Kimliğinizi Doğrulama API Rica etmek

Her PDF4me modül içinde Make geçerli bir belge gerektirir Bağlantı. İçeriğinizi barındıran birini oluşturun veya seçin. PDF4me API Senaryonun kimlik doğrulamasını yapabilmesi için anahtar. Excel Nüfus taleplerini güvenli bir şekilde karşılayın.

Get your API Key

Kaçırmamanız Gereken Önemli Bilgiler

Akıllı İşaretleyici adları eşleşmelidir. JSON anahtarlar tam olarak

Alan adlarınız JSON Veri yükü, Akıllı İşaretleyici yer tutucularıyla eşleşmelidir. Excel Şablonu tam olarak, büyük/küçük harf duyarlılığı da dahil olmak üzere. Bir işaretleyici. &=Öğeler.ÖğeAdı gerektirir JSON adı verilen dizi Öğeler içinde nesneler bulunan Ürün Adı Özellik. Uyumsuzluk durumunda yer tutucu çıktıda değiştirilmeden kalır. Senaryoyu çalıştırmadan önce her zaman anahtar adlarını doğrulayın.

Diziler otomatik olarak satır satır aşağı doğru genişler.

Ne zaman JSON Akıllı İşaretleyiciye bağlı değer bir dizidir; modül, işaretleyici hücrenin altına her bir öğe için bir satır ekler ve mevcut satırları aşağı kaydırır. Beklenen satır sayısı için şablonu önceden boyutlandırmaya gerek yoktur. Bu, Doldurma modülünü faturalar, sipariş listeleri ve veri satır sayısının çalışma zamanında değiştiği herhangi bir rapor için uygun hale getirir.

Sıkı Ayarla JSON Sayısal formüller için "Hayır" olarak ayarlanmış dizeler

Sıkı bir şekilde JSON Metinler "Evet" (varsayılan), sayısal değerler ise tırnak içinde belirtilir. JSON örneğin "55" metin olarak eklenir ExcelEğer sonraki bir SUM veya başka bir formülün bunları sayı olarak ele alması gerekiyorsa, Strict ayarını yapın. JSON Bu modül, tırnak içinde belirtilen sayısal dizeleri sayısal değerlere dönüştürür. Excel Popülasyon öncesi hücre değerleri.

PDF4me Excel Doldurma modülünü, Bağlantı alanını, Dosya alanını Dropbox - Dosya İndir olarak ve ItemName, Qty ve UnitPrice alanlarını içeren Items dizisine sahip JSON Veri metin alanını gösterecek şekilde oluşturun. — Harita **Bağlantı**, ayarlamak **Dosya** ile Dropbox veya Harita ve geçin JSON Anahtarları, sizin Smart Marker alan adlarıyla eşleşen yük Excel şablon.

Parametreler

Gerekli: Bağlantı, Dosya (kaynak) ve JSON Verilerin girilmesi zorunludur. Diğer tüm alanlar isteğe bağlıdır. Akıllı İşaretleyici sözdizimi referansı için bkz. Aspose Cells WorkbookDesigner dokümantasyonuKültür kodları için bkz. Microsoft BCP 47 kültür adı referansı.

Parametre	Gerekli	Ne işe yarar?	Örnek
Connection	Required	PDF4me Excel API connection. Click Add and paste your API key if connecting for the first time.	`My PDF4me Excel connection`
File	Required	File 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 Name	Optional	Excel 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`
Document	Required	Binary 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 Data	Required	JSON 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 Strings	No	Yes (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 Settings	No	BCP 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 Formulas	No	Yes (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 Indexes	No	Comma-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 Style	No	Yes: 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`

PDF4me Excel'i Gelişmiş Ayarlar'da şu şekilde yapılandırın: Katı JSON Dizeleri Evet, Kültür ve Dil Ayarları en-US, Formülleri Hesapla Evet, Çalışma Sayfası İndeksleri 1 ve Stil İçin Alıntı Öneki Boş. — İsteğe bağlı ayarlar: **Sıkı JSON Dizeler**, **Kültür ve Dil Ortamları**, **Formülleri Hesapla**, **Çalışma Sayfası Dizinleri**, Ve **Stile Önek Ekleme**. Ayarlamak **Formülleri Hesapla: Evet** Bu nedenle çalışma kitabındaki formüller, girilen verileri yansıtır.

Çıktı

Alan	Tip	İçeriğinde neler var?
document	`Base64 String`	The 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.
FileName	`String`	Output 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.
Success	`Boolean`	True 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.

Hızlı örnek (3 dakika sonra deneyin)

Yukarıdaki ekran görüntülerine uyan iki kullanıma hazır kombinasyon mevcuttur. Her bir çifti indirin ve XLSX dosyasını ilgili yapıya dönüştürün. Belge (veya kullanın) Dropbox dosya modu), yapıştırın JSON içine JSON Verive senaryoyu bir kez çalıştırın.

Kombinasyon A: Basit Ürünler (ekran görüntüsündeki parametreyle eşleşir)

Kullanım Alanları şablon.xlsx ile Çalışma Sayfası Dizinleri = 2 (Sheet2'de parametre ekran görüntüsünde kullanılan basit Öğeler işaretleyicileri bulunmaktadır). Eşleşen düz Öğelerle eşleştirin. JSON.

şablon.xlsx (Belge)
sayfa23-veri.json (JSON Veri)
Ayarlamak Çalışma Sayfası Dizinleri ile 2

B Kombinasyonu: zengin içerikli fatura Excel Masa

Fatura sayfasını kullanır. şablon.xlsx iç içe geçmiş ile &=RootData.Items.* işaretleyiciler, yapılandırılmış referans formülleri Basit Fatura Tablo, ara toplam + vergi + toplam hesaplaması.

şablon.xlsx (Belge)
sayfa1-veri.json (JSON Veri)
Ayarlamak Çalışma Sayfası Dizinleri ile 1 Fatura sayfası için

Combo C: çok sayfalı çalışma kitabı

Üç sayfadan oluşan şablon, her sayfada farklı veri kaynaklarını göstermektedir. Dosyadaki sayfa sırası şu şekildedir: Ürünler, Çalışanlar, Ürünler.

şablon-3-sayfa.xlsx
Öğeleri / Çalışanları / Ürünleri tek bir pakette birleştirin. JSON nesne (bakınız) çok sayfalı bölüm)
Ayrılmak Çalışma Sayfası Dizinleri üçünü de doldurmak için boş

Bir veri tabanını nasıl doldurursunuz? Excel Şablon içinde Make

Açın Excel Şablonu kullanın ve verilerin görünmesi gereken hücrelere Akıllı İşaretleyici yer tutucuları yerleştirin: &=ObjectName.FieldName skalar değerler için ve &=ArrayName.FieldName Satır satır genişleyen diziler için.
Eklemek PDF4me Excel senin Make senaryo ve seçin Excel - Doldur.
Birini seçin veya oluşturun Bağlantı sizinle PDF4me API anahtar.
Ayarlamak Dosya ile Harita ve bağlan Dosya adı Ve Belge bir Google Drive, SharePoint, veya Dropbox Modülü indirin. Veya Dosyayı şu şekilde ayarlayın: Dropbox - Dosya İndir Şablonu doğrudan çekmek için.
Harita JSON Veri önceki bir modülden üreten JSON dizeyi yapıştırın veya statik bir şey yapıştırın JSON Kelime kelime eşleşme. Her anahtarın şablondaki ilgili Akıllı İşaretleyici alan adıyla eşleştiğinden emin olun.
Ayarlamak Formülleri Hesapla ile Evet Şablon, doldurulmuş değerlere bağlı formüller içeriyorsa. Çalışma Sayfası Dizinleri Yalnızca belirli sayfaları hedeflemek veya tümü için boş bırakmak.
Tıklamak Kaydetmek ve çalıştır. Şifreyi çöz. belge çıktıyı bulut depolama alanına yüklemeye, e-postaya veya yönlendirmeye yönlendirin. API Gerektiği gibi.

Populate özelliğini ne zaman kullanmalıyım? Excel içinde Make?

Make'te Excel Dosyalarını Doldurma özelliğini ne zaman kullanmalıyım?Common Make automation patterns using the Populate Excel module.

Sipariş verilerinden otomatik olarak fatura oluşturun.

Bir webhook, müşteri bilgilerini ve ürün kalemlerini içeren yeni bir sipariş verisi alır. JSON sıralamak.
Bu senaryo, markalı bir fatura şablonunu indiriyor. Google Drive.
Doldurmak Excel sırayı haritalar JSON Şablondaki Akıllı İşaretleyicilere, her satır öğesi için bir satır genişletilerek ve toplam formülü yeniden hesaplanarak uygulanır.
Oluşturulan fatura müşteriye e-posta ile gönderilir ve müşteri klasörüne yüklenir. SharePoint.

Veritabanından haftalık KPI raporlarını doldurun. API

Haftalık olarak planlanmış bir tetikleyici devreye girer ve bir çağrı yapar. REST API En son KPI ölçümlerini almak için JSON.
Bu senaryo, bir KPI rapor şablonunu şuradan çekiyor: Dropbox yerleşik olanı kullanarak Dropbox dosya modu.
Doldurmak Excel Metrik değerleri şablon hücrelerine yerleştirir ve trend formüllerini yeniden hesaplar.
Tamamlanan rapor bir Slack kanalına gönderilir ve tarihli bir arşiv klasörüne kaydedilir. Google Drive.

Müşteri bazında doldur Excel özetlerden CRM ihracat

A CRM Bir anlaşma "kazanıldı" olarak işaretlendiğinde webhook tetiklenir ve müşteri ve anlaşma verilerini sağlar. JSON.
Bu senaryo, bir anlaşma özeti şablonunu indirir. SharePoint Yalnızca Çalışma Sayfası Dizini 1'i hedefliyor.
Doldurmak Excel Şablona müşteri adını, işlem değerini ve ürün kalemlerini girer.
Oluşturulan özet, müşteri klasörüne yüklenir ve proje yönetim aracında hesap ekibi için bir görev oluşturulur.

Sıkça Sorulan Sorular

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.