SharePoint Listesinden PDF Oluşturmayı Otomatikleştirme: Handlebars Şablonu ve HTML'den PDF'ye Fatura İş Akışı

PDF4me Tekli Belge Oluştur Bu, Handlebars HTML şablonunu ve bir JSON verisini tamamlanmış bir HTML belgesine dönüştüren bir Power Automate eylemidir; ardından eşleştirilmiş HTML'yi PDF'ye Dönüştür eylemi bunu A4 boyutunda sayfalara ayırır. Yeni bir SharePoint liste satırı akışı başlatır, Compose JSON'u bir araya getirir ve Dropbox, fatura numarasına göre adlandırılmış fatura PDF'sini depolar. Premium bağlantı yok, kod yok.

Her finans ekibi Power Automate'te aynı engelle karşılaşıyor. Dosyayı Dönüştür Bu işlem, premium lisans gerektirir ve HTML şablonuna dokunmayı reddeder. Adobe PDF Hizmetleri ücretlidir. Encodian ücretlidir. matthewdevaney'in popüler çözümü HTML'yi tamamen atlar ve sizi Power Apps'e kilitler. Aşağıdaki model, SERP'te ilk on arasında yer alan hiç kimsenin baştan sona göstermediği modeldir: bir SharePoint liste sütun kümesi, gerçek bir JSON yüküne dönüşür. Gidon şablonu dosya şurada yaşıyor /Shared Documents/Ayrıca, PDF4me'nin iki işlemi, ücretsiz bağlantı katmanı maliyeti karşılığında görüntüleme ve sayfalama işlemlerini gerçekleştirir.

Handlebars şablon oluşturma: PDF4me ve alternatifleri​

Her Power Automate mimarının fatura PDF'leri için bir bağlayıcı seçmeden önce yaptığı karşılaştırma:

Neden Odaklı Soru-Cevap​

Neler Alacaksınız?​

Giriş: adlı bir SharePoint listesi Invoices (sütunlar: Başlık, Fatura Tarihi, Son Ödeme Tarihi, Müşteri Adı, Müşteri Adresi, Müşteri E-postası, Para Birimi, Ara Toplam, Vergi Oranı, Vergi Tutarı, Genel Toplam, Notlar) artı tek bir Handlebars şablonu /Shared Documents/invoice_template.html. Çıktı: Dropbox'ta her satırda bir A4 PDF dosyası olacak şekilde adlandırılmış {Title}.pdf (INV-1005, INV-1005.pdf haline gelir).

İhtiyacınız Olanlar​

Akışa Genel Bakış​

1. Bir öğe oluşturulduğunda (SharePoint tetikleyicisi açık) Invoices liste).
2. Bestelemek İç içe geçmiş JSON veri paketi (fatura / müşteri / ürünler / toplamlar / notlar).
3. Yol kullanarak dosya içeriğini al için /Shared Documents/invoice_template.html.
4. PDF - Belge Oluştur (Tekli) Şablon gövdesi ve JSON ile birlikte, çıktı türü HTML.
5. HTML'yi PDF'ye dönüştür A4 dikey format, 0.8 ölçek, 40 piksel kenar boşlukları, baskı arka planları Evet.
6. Dosya oluştur Dropbox'ta /, dosya adı {Title}.pdf.

Akışın genel görünümü​

Baştan sona çalışma. 11 saniyelik HTML'den PDF'ye dönüştürme işlemi sayfalama işlemidir, geri kalan her şey yarım saniyenin altındadır.

Adım 1: Yeni bir SharePoint faturasında Power Automate akışını nasıl tetiklersiniz?​

Şu ana kadarki akış: Akış buradan başlıyor.

SharePoint tetikleyicisini fatura satırlarınızı içeren siteye ve listeye yönlendirin. Her sütun, aşağı akışta dinamik içerik haline gelir.

1. Eklemek SharePoint > Bir öğe oluşturulduğunda tetikleyici olarak.
2. Yapılandır:
   • Site Adresi: SharePoint sitesini seçin (örnekte: PDF4me Sharepoints - https://ynoox1.sharepoint.com/sites/PDF4meSharepoints).
   • Liste Adı: Invoices.
3. Kaydedin ve tetikleyicinin liste şemasını algılamasına izin verin. Aşağıdaki ekran görüntüsündeki satırlar (INV-1002, INV-1003, INV-1005), Handlebars şablonunun kullanacağı tam 12 sütunu göstermektedir.

Faturalar listesi​

SharePoint listesi, doğruluk kaynağıdır. Buradaki her sütun, Handlebars yükünün bir alanına karşılık gelir.

Tetikleyici yapılandırması​

Tetikleyici sadece iki alandan ibaret. Geri kalan her şey satırdan geliyor.

Adım 2: SharePoint satırından Handlebars JSON veri paketini nasıl oluşturursunuz?​

Şu ana kadarki akış: SharePoint tetikleyicisi.

Compose, 12 düz SharePoint sütununu, Handlebars şablonunun üzerinde yinelediği iç içe geçmiş JSON'a dönüştürür. Şablon şunları bekler: invoice, customer, BİR items sıralamak, totalsve bir notes sicim.

1. Eklemek Bestelemek.
2. İçinde GirişlerAşağıdaki JSON'u yapıştırın, ardından sayıların ve tarihlerin metin dizeleri olarak görünmesi için her değerin tırnak işaretleri arasına ilgili SharePoint dinamik içerik hapını bırakın.

{
  "invoice": {
    "number": "Title",
    "date":   "InvoiceDate",
    "dueDate": "DueDate"
  },
  "customer": {
    "name":    "CustomerName",
    "address": "CustomerAddress",
    "email":   "CustomerEmail"
  },
  "items": [
    { "description": "Item1Description", "quantity": "Item1Qty", "unitPrice": "Item1UnitPrice", "lineTotal": "Item1Amount", "currency": "Currency" },
    { "description": "Item2Description", "quantity": "Item2Qty", "unitPrice": "Item2UnitPrice", "lineTotal": "Item2Amount", "currency": "Currency" },
    { "description": "Item3Description", "quantity": "Item3Qty", "unitPrice": "Item3UnitPrice", "lineTotal": "Item3Amount", "currency": "Currency" },
    { "description": "Item4Description", "quantity": "Item4Qty", "unitPrice": "Item4UnitPrice", "lineTotal": "Item4Amount", "currency": "Currency" },
    { "description": "Item5Description", "quantity": "Item5Qty", "unitPrice": "Item5UnitPrice", "lineTotal": "Item5Amount", "currency": "Currency" }
  ],
  "totals": {
    "currency":   "Currency",
    "subTotal":   "Subtotal",
    "taxRate":    "TaxRate",
    "taxAmount":  "TaxAmount",
    "grandTotal": "GrandTotal"
  },
  "notes": "Notes"
}

Yapılandırmayı oluştur​

Kod görünümünde oluşturun. Her JSON değeri, iki tırnak işareti arasında yer alan bir SharePoint hapı şeklindedir; bu nedenle sayılar ve tarihler, Handlebars şablonunun işleyebileceği dizeler olarak gelir.

Referans: SharePoint sütunundan Handlebars yoluna​

SharePoint sütunu ile şablon içindeki tam karşılık gelen konum arasındaki eşleşme. Şemayı genişletirken bu tabloyu yer imlerinize ekleyin.

3. Adım: SharePoint'ten Handlebars şablon dosyasını nasıl yüklersiniz?​

Şu ana kadarki akış: SharePoint tetikleyicisi ve Compose.

Şablonu düz bir dosya olarak kaydedin. .html Sitenin Belgeler kitaplığındaki dosya. "Dosya içeriğini yol kullanarak al" eylemi, ham baytlarını okur, böylece "Belge Oluştur (Tekli)" bunları şablon gövdesi olarak kullanabilir.

Şablonun kendisi​

Şablon, satır içi CSS içeren sıradan HTML'den ve verilerin yerleştirildiği yerlerde Handlebars ifadelerinden oluşmaktadır. Asıl işi iki yapı yapmaktadır. {{#each items}} Her satır öğesi için tablo satırını tekrarlar ve {{#if description}} İçerideki koruma mekanizması, kullanılmayan Item4 ve Item5 sütunlarının bıraktığı boşlukları atlar.

<tbody>
  {{#each items}}
  {{#if description}}
  <tr>
    <td>{{description}}</td>
    <td class="num">{{quantity}}</td>
    <td class="num">{{currency}}{{unitPrice}}</td>
    <td class="num">{{currency}}{{lineTotal}}</td>
  </tr>
  {{/if}}
  {{/each}}
</tbody>

Geri kalan her şey doğrudan bir ikamedir: {{invoice.number}} başlıkta, {{customer.*}} fatura adresi bloğu, {{totals.*}} toplamlar tablosunda ve {{notes}} Altbilgide.

1. Eklemek SharePoint > Yol kullanarak dosya içeriğini al.
2. Yapılandır:
   • Site AdresiTetikleyiciyle aynı yer.
   • Dosya Yolu: /Shared Documents/invoice_template.html.
   • İçerik türünü çıkarımla: Yes (Varsayılan ayarları bırakın).

Yol kullanarak dosya içeriğini al​

Şablon şurada yaşıyor: /Shared Documents/ ve mutlak yol ile alınır. Sürüm geçmişi otomatik olarak oluşturulur çünkü bu sadece bir SharePoint dosyasıdır.

Adım 4: PDF - Belge Oluştur (Tekli) işlevi Handlebars şablonunu nasıl doldurur?​

Şu ana kadarki akış: SharePoint tetikleyicisi, Compose ve yol kullanarak dosya içeriğini alma.

Generate Document (Single), şablon motorudur. Handlebars kaynak kodunu okur ({{invoice.number}}, {{#each items}}...{{/each}}Bu kod, JSON verilerinden gelen değerleri değiştirir ve oluşturulmuş HTML'i döndürür. Sayfalama yapmaz. Bu, bir sonraki adımın görevidir.

1. Eklemek PDF4me PDF > PDF - Belge Oluştur (Tekli).
2. Yapılandır:
   • Şablon Dosya Türü: Html (Handlebars Syntax).
   • Şablon Dosya Adı: invoice_template.html.
   • Şablon Dosya Verileri: dinamik içerik, Body SharePoint Dosya içeriğini alma adımından.
   • Belge Veri Türü: Json.
   • Belge Verileri Metni: dinamik içerik, Body Oluşturma adımından.
   • Çıktı Türü: Html.
   • PDF şablonunu düzenlenebilir tutun.: No.

Belge Oluştur (Tekli) yapılandırması​

Çıktı Türü Html, Olumsuz Pdf. Belge Oluştur (Tekli) seçeneği, oluşturulan HTML'yi bir sonraki adıma aktarır, böylece sayfalama ayrı ve test edilebilir bir konu olarak kalır.

Adım 5: Oluşturulan HTML'yi A4 PDF'ye nasıl sayfalandırırsınız?​

Şu ana kadarki akış: SharePoint tetikleyicisi artı Oluştur artı Yol kullanarak dosya içeriğini al artı PDF - Belge Oluştur (Tekli).

HTML'yi PDF'ye Dönüştür, sayfalama motorudur. Belge Oluştur (Tekli) tarafından üretilen HTML'yi okur, sayfa boyutunu ve kenar boşluklarını uygular ve PDF baytlarını döndürür.

1. Eklemek PDF4me PDF > HTML'yi PDF'ye dönüştür.
2. Yapılandır:
   • Dosya İçeriği: dinamik içerik, Body Belge Oluştur (Tekli) adımından.
   • HTML Dosya Adı: invoice.html.
   • Sayfa Düzeni: Portrait.
   • Sayfa Boyutu: A4.
   • Ölçek: 0.8 (5 maddelik faturayı tek sayfaya sığdırır.)
   • Üst / Alt / Sol / Sağ Kenar Boşluğu: 40px her biri.
   • Arka Plan Baskısı: Yes (Toplamlar bloğunun arka plan rengini değiştirir.)

HTML'den PDF'ye dönüştürme yapılandırması​

Ölçek 0.8, beş satırlık bir faturayı tek bir A4 sayfasına sığdırır. Daha az kaleminiz varsa ve daha büyük bir yazı tipi istiyorsanız, ölçeği 0.9 veya 1.0'a yükseltin.

Adım 6: Fatura PDF dosyasını tahmin edilebilir bir isimle Dropbox'a nasıl kaydedersiniz?​

Şu ana kadarki akış: SharePoint tetikleyicisi, Oluşturma, Yol kullanarak dosya içeriğini alma, PDF - Belge Oluşturma (Tekli), HTML'yi PDF'ye dönüştürme.

Son adımda PDF dosyası, fatura numarasıyla ilişkilendirilmiş bir isimle Dropbox klasörüne bırakılıyor.

1. Eklemek Dropbox > Dosya oluştur.
2. Yapılandır:
   • Klasör Yolu: / (veya bir alt klasör gibi) /invoices/).
   • Dosya adı: dinamik içerik, Title SharePoint tetikleyicisinden, ardından da tam metin dizesi gelir. .pdfINV-1005 şu hale gelir: INV-1005.pdf.
   • Dosya İçeriği: dinamik içerik, Body HTML'yi PDF'ye dönüştürme adımından.

Dosya yapılandırması oluştur​

Dosyayı fatura numarasıyla adlandırmak, Dropbox klasörünün otomatik olarak aranabilir, yinelenen kayıtları kaldırılmış bir fatura arşivi haline gelmesini sağlar.

Akışı Çalıştırın ve Doğrulayın​

1. Kaydetmek Sağ üstteki akış.
2. Yeni bir satır ekle Invoices SharePoint listesi. Başlığı kolayca tanınabilir bir şeyle değiştirin (INV-1005) ve şablonun gerçek veriler içermesi için her sütunu doldurun.
3. Akışı açın Çalıştırma geçmişi ve en son çalıştırmayı seçin. Her kart, akış genel bakış ekran görüntüsüne benzer şekilde yeşil olmalıdır. HTML'yi PDF'ye Dönüştürme kartı en yavaş olanıdır (yaklaşık 11 saniye), çünkü sayfalama burada gerçekleşir.
4. Dropbox'ı açın ve onaylayın. INV-1005.pdf (veya Başlığınız) kök dizinde yer alıyor. İndirin, açın ve örnekle karşılaştırın.

Yeniden derlemeye gerek kalmadan ekleyebileceğiniz yaygın varyasyonlar​

Sıkça sorulan sorular​

SharePoint liste öğesinden Power Automate kullanarak PDF nasıl oluşturulur?​

SharePoint'i kullanın When an item is created tetikleyici olarak, bir Compose Satırın düz sütunlarını iç içe geçmiş bir JSON verisine dönüştürme eylemi, Get file content using path HTML şablonunuzu yüklemek için yapılacak işlem /Shared Documents/PDF4me Generate Document (Single) JSON'u şablona entegre etmek ve PDF4me kullanmak. Convert HTML to PDF Sonucu sayfalara ayırmak için. Çıktıyı herhangi bir dosya bağlayıcısına kaydedin (Dropbox, OneDrive, SharePoint). Bu zincirdeki her işlem standart bağlayıcı katmanındadır, bu nedenle Power Automate Premium lisansına ihtiyacınız yoktur.

Power Automate PDF oluşturabilir mi?​

Evet. Power Automate'in yerel sürümü HTML şablonundan kendi başına PDF oluşturamaz, ancak PDF4me Bağlayıcı, bunu mümkün kılan iki eylemi ekler: Generate Document (Single) şablon oluşturma için ve Convert HTML to PDF Sayfalama için. Her ikisi de standart seviyede ve kurulumu ücretsizdir. Birlikte, verilerin yanında saklanan düzenlenebilir bir HTML şablonu kullanarak herhangi bir SharePoint / Dataverse / Excel satırını markalı bir PDF'ye dönüştürürler.

Power Automate'te HTML'den PDF nasıl oluşturulur?​

Ekle PDF4me HTML'yi PDF'ye dönüştürüyor Akışın kapsamı HTML olan herhangi bir yerde işlem gerçekleştirin (bir Compose çıktısı, bir Get file content Body, bir Compose ifadesi, bir webhook yükü). Sayfa boyutunu yapılandırın (A4), düzen (Portrait), kenar boşlukları (40px) ve ayarla Print Background: Yes Böylece CSS arka planları korunur. Eylemin Body Çıktı, depolama işlemine verdiğiniz PDF ikili dosyasıdır. Bu, yukarıdaki 5. adımda kullanılan işlemle aynıdır.

Power Automate, premium üyelik gerektirmeden HTML'yi PDF'ye dönüştürebilir mi?​

Evet. PDF4me bağlayıcısının HTML'yi PDF'ye Dönüştürme eylemi standart bağlayıcı katmanında yer almaktadır; bu da onu, yerel sürümün gerektirdiği Premium lisans yükseltmesine gerek kalmadan herhangi bir Power Automate planına kurup kullanabileceğiniz anlamına gelir. Convert File ve Adobe PDF Hizmetleri bağlantı elemanları gerektirir. Yine de bir PDF4me API anahtarına ihtiyacınız var (ücretsiz sürüm mevcut), bunu işlemi ilk kez eklerken yapıştırıyorsunuz.

Power Automate'te şablondan PDF nasıl oluşturulur?​

Kullanmak PDF4me Belge Oluştur (Tekli) ile Template File Type: Html (Handlebars Syntax) (HTML şablonları için) veya Word (için .docx Şablonları besleyin). Şablon baytlarını şuraya aktarın: Template File Data ve bir JSON verisi içine Document Data Text. Ayarlamak Output Type: Html Eğer sonradan sayfalara ayırmanız gerekiyorsa (bu blogda olduğu gibi), veya Pdf PDF dosyasını tek adımda geri almak için. Bu işlem, Handlebars sözdiziminin tamamını destekler. {{#each}} Ve {{#if}} Satır öğeleri ve koşullu bloklar için.

Sorun giderme​

Sonraki Adımlar​

Aynı altı adımlı model (satır artı şablon artı oluşturma artı sayfalama artı ad artı depolama), HTML'de tanımlayabileceğiniz satır başına markalı herhangi bir PDF dosyasını işler.