Node.js'de PDF Form Alanları Nasıl Doldurulur

Node.js'de PDF Formlarını Doldurmak İçin Hangi Ön Koşullara İhtiyacım Var?

Aşağıdaki kod örneklerini çalıştırmadan önce üç şeyin yerinde olduğundan emin olun: desteklenen bir Node.js sürümü, bir IronPDF lisans anahtarı ve IronPdfEngine ikili dosyası.

Node.js sürümü: IronPDF, Node.js 18 veya daha yüksek bir sürüm gerektirir. resmi Node.js web sitesinden mevcut LTS sürümünü indirin. Kütüphane, tüm PDF işlemleri için Node.js asenkron I/O kullanır, bu nedenle await veya Promise zincirleme, tüm kodda standart desendir. Paket, Node.js 18+'ı gerektiren native ESM ve async_hooks özelliklerine bağlı olduğundan, eski Node.js sürümleri desteklenmez.

Lisans anahtarı: Aktif bir IronPDF lisans anahtarı, tam API'yi kullanıma açar. Ücretsiz denemenizi başlatın ve geliştirme ve test için bir anahtar alın ya da üretim kullanımı için bir lisans satın alın. Dağıtım seçenekleri (ortam değişkenleri, yapılandırma dosyaları, gizli yöneticiler) için bkz. Lisans Anahtarlarını Kullanma kılavuzu.

IronPdfEngine: Node.js paketi, gerçek PDF manipülasyonunu yöneten çapraz platform bir düzenleme motoru olan IronPdfEngine içerir. Kurulum ve platforma özel notlar (Windows, Linux, macOS) IronPdfEngine Kullanımı belgelerinde yer alır.

:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/license-setup.js

const { IronPdfGlobalConfig } = require("@ironsoftware/ironpdf");

// Apply once at startup -- before any PdfDocument operations
IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

Node.js için IronPDF'yi Nasıl Yüklerim?

IronPDF for Node.js'i kurmak için tek bir npm komutu yeterlidir. Proje dizininde çalıştırın:

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/install-full.sh
npm install @ironsoftware/ironpdf

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/install-full.sh
npm install @ironsoftware/ironpdf

Paket, TypeScript tür deklarasyonları ile birlikte gelir, bu yüzden TypeScript projeleri ayrı bir @types paketine ihtiyaç duymadan tam IntelliSense desteği alır. Windows, Linux ve macOS için platforma özel ikili dosyalar, kurulum sırasında otomatik olarak indirilir. npm üzerinde @Iron Software/ironpdf paketi, yayınlanan tüm sürümleri ve eş bağımlılıkları listeler.

Mevcut bir monorepo veya Docker tabanlı iş akışına IronPDF eklemek için talimatlar, IronPDF for Node.js dokümantasyonu'nda bulunabilir.

PDF Formlarını Programlı Olarak Nasıl Doldururum?

Bir PDF yüklemek ve form alanlarına değerler yazmak üç asenkron çağrı gerektirir: PdfDocument.fromFile(), setFormFieldValue() ve saveAs(). Aşağıdaki örnek, çok alanlı bir başvuru formunu doldurur ve isteğe bağlı olarak düzleştirerek teslimattan sonra değerlerin değiştirilememesini sağlar.

Tam Form Doldurma Örneği Nasıl Görünür?

Aşağıdaki örnek, çeşitli alan türlerine sahip bir PDF'yi yükler, doldurur ve sonucu kaydeder. Formlar oluşturmaya odaklanmak için PDF Formları örnek sayfasını inceleyin.

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/fill-pdf-form.js
const { PdfDocument, IronPdfGlobalConfig } = require("@ironsoftware/ironpdf");

IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

async function fillApplicationForm() {
    // Load the PDF containing form fields
    const pdf = await PdfDocument.fromFile("./forms/application-form.pdf");

    // Discover available field names before filling
    const fieldNames = await pdf.getFormFieldNames();
    console.log("Form fields:", fieldNames);

    // Text fields
    await pdf.setFormFieldValue("firstName", "Jane");
    await pdf.setFormFieldValue("lastName", "Doe");
    await pdf.setFormFieldValue("email", "jane.doe@example.com");
    await pdf.setFormFieldValue("phone", "+1-555-987-6543");

    // Date field
    await pdf.setFormFieldValue("dateOfBirth", "03/22/1988");

    // Onay Kutusu fields -- pass "true" or "false" as strings
    await pdf.setFormFieldValue("agreeToTerms", "true");
    await pdf.setFormFieldValue("subscribeNewsletter", "false");

    // Dropdown / select field
    await pdf.setFormFieldValue("country", "United States");

    // Multi-line text area
    await pdf.setFormFieldValue("comments", "Application submitted via automated workflow.");

    // Flatten the form to lock values -- prevents further editing
    // await pdf.flattenAllFormFields();

    await pdf.saveAs("./output/filled-application.pdf");
    console.log("Form saved.");
}

fillApplicationForm().catch(console.error);

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/fill-pdf-form.js
const { PdfDocument, IronPdfGlobalConfig } = require("@ironsoftware/ironpdf");

IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

async function fillApplicationForm() {
    // Load the PDF containing form fields
    const pdf = await PdfDocument.fromFile("./forms/application-form.pdf");

    // Discover available field names before filling
    const fieldNames = await pdf.getFormFieldNames();
    console.log("Form fields:", fieldNames);

    // Text fields
    await pdf.setFormFieldValue("firstName", "Jane");
    await pdf.setFormFieldValue("lastName", "Doe");
    await pdf.setFormFieldValue("email", "jane.doe@example.com");
    await pdf.setFormFieldValue("phone", "+1-555-987-6543");

    // Date field
    await pdf.setFormFieldValue("dateOfBirth", "03/22/1988");

    // Onay Kutusu fields -- pass "true" or "false" as strings
    await pdf.setFormFieldValue("agreeToTerms", "true");
    await pdf.setFormFieldValue("subscribeNewsletter", "false");

    // Dropdown / select field
    await pdf.setFormFieldValue("country", "United States");

    // Multi-line text area
    await pdf.setFormFieldValue("comments", "Application submitted via automated workflow.");

    // Flatten the form to lock values -- prevents further editing
    // await pdf.flattenAllFormFields();

    await pdf.saveAs("./output/filled-application.pdf");
    console.log("Form saved.");
}

fillApplicationForm().catch(console.error);

JAVASCRIPT

getFormFieldNames() çağrısından sonra, döndürülen dizi size PDF yazarının kullandığı alan adlarını söyler. Formları kendiniz oluşturmadığınız zaman, alan adlarında yazım hatalarından kaçınmanın en hızlı yolu budur.

İpuçlarıgetFormFieldNames() geliştirirken PDF'inizdeki tam alan adlarını yazdırmak için bir kez çağırın. Yanlış adı sabitlemek, setFormFieldValue() sonrasında alanların boş görünmesinin en yaygın nedenidir.

---

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

Farklı Form Alanı Türlerini Nasıl Ele Alırım?

IronPDF, standart AcroForm alan türlerini destekler: metin kutuları, onay kutuları, radyo düğmeleri, açılır listeler, liste kutuları ve imza alanları. setFormFieldValue() yöntemi, tüm türler için string değerler kabul eder; onay kutuları ve radyo alanları için kabul edilen değerler PDF'deki belirli alan tanımına bağlıdır.

Aşağıdaki tablo, her alan türü için değer formatını gösterir:

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/field-types.js
const { PdfDocument, IronPdfGlobalConfig } = require("@ironsoftware/ironpdf");

IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

async function handleFieldTypes() {
    const pdf = await PdfDocument.fromFile("./forms/complex-form.pdf");

    // Radio button -- use the field's export value, not its display label
    await pdf.setFormFieldValue("gender", "Female");

    // Onay Kutusu
    await pdf.setFormFieldValue("termsAccepted", "true");

    // Dropdown
    await pdf.setFormFieldValue("preferredContact", "Email");

    // Numeric field -- pass the number as a string
    await pdf.setFormFieldValue("invoiceAmount", "1250.00");

    // Date picker
    await pdf.setFormFieldValue("appointmentDate", "2024-06-15");

    await pdf.saveAs("./output/complex-form-filled.pdf");
}

handleFieldTypes().catch(console.error);

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/field-types.js
const { PdfDocument, IronPdfGlobalConfig } = require("@ironsoftware/ironpdf");

IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

async function handleFieldTypes() {
    const pdf = await PdfDocument.fromFile("./forms/complex-form.pdf");

    // Radio button -- use the field's export value, not its display label
    await pdf.setFormFieldValue("gender", "Female");

    // Onay Kutusu
    await pdf.setFormFieldValue("termsAccepted", "true");

    // Dropdown
    await pdf.setFormFieldValue("preferredContact", "Email");

    // Numeric field -- pass the number as a string
    await pdf.setFormFieldValue("invoiceAmount", "1250.00");

    // Date picker
    await pdf.setFormFieldValue("appointmentDate", "2024-06-15");

    await pdf.saveAs("./output/complex-form-filled.pdf");
}

handleFieldTypes().catch(console.error);

PDF Form Alanlarını Doldurduktan Sonra Nasıl Düzleştiririm?

PDF formunun düzleştirilmesi, tüm alan değerlerini statik sayfa içeriğine birleştirir ve etkileşimli katmanı kaldırır. Ortaya çıkan belge daha fazla düzenlenemez, bu da dağıtım sırasında kazara değişiklikleri önler ve tüm PDF görüntüleyiciler arasında tutarlı bir render sağlar.

Tüm alan değerlerini ayarladıktan ve kaydetmeden önce yüklenen belgede flattenAllFormFields() çağırın:

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/flatten-form.js
const { PdfDocument, IronPdfGlobalConfig } = require("@ironsoftware/ironpdf");

IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

async function fillAndFlattenForm() {
    const pdf = await PdfDocument.fromFile("./forms/contract.pdf");

    // Fill the required fields
    await pdf.setFormFieldValue("signerName", "Jane Doe");
    await pdf.setFormFieldValue("signatureDate", "2024-06-15");
    await pdf.setFormFieldValue("agreementAccepted", "true");

    // Flatten -- converts interactive fields to static content
    await pdf.flattenAllFormFields();

    await pdf.saveAs("./output/contract-signed.pdf");
    console.log("Contract flattened and saved.");
}

fillAndFlattenForm().catch(console.error);

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-fill-pdf-form/flatten-form.js
const { PdfDocument, IronPdfGlobalConfig } = require("@ironsoftware/ironpdf");

IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

async function fillAndFlattenForm() {
    const pdf = await PdfDocument.fromFile("./forms/contract.pdf");

    // Fill the required fields
    await pdf.setFormFieldValue("signerName", "Jane Doe");
    await pdf.setFormFieldValue("signatureDate", "2024-06-15");
    await pdf.setFormFieldValue("agreementAccepted", "true");

    // Flatten -- converts interactive fields to static content
    await pdf.flattenAllFormFields();

    await pdf.saveAs("./output/contract-signed.pdf");
    console.log("Contract flattened and saved.");
}

fillAndFlattenForm().catch(console.error);

Düzleştirme, son teslimatlar için uygundur -- imzadan sonra sözleşmeler, düzenlemeden sonra faturalar veya sertifikalar. Nihai hale getirilmeden önce ek incelemeye ihtiyaç duyan belgeler için flattenAllFormFields() atlayın ve onsuz kaydedin.

PDF Form Otomasyonu İçin Yaygın Kullanım Durumları Nelerdir?

Otomatik form doldurma, yüksek hacimli belge iş akışlarından manuel veri girişi işlemini ortadan kaldırır. Aşağıdaki senaryolar, geliştiricilerin IronPDF ile en sık uyguladıkları desenleri kapsamaktadır.

Uygulama işleme: Başvuru sahibinin verilerini bir veritabanından veya REST API'den çekip finansal hizmetler, sigorta veya hükümet kabul iş akışları için PDF formlarını doldurun. Tek bir çok sayfalı gönderim paketi oluşturmak için doldurulmuş formları PDF'leri Birleştirme örneği ile birleştirin.

Fatura ve makbuz oluşturma: Fatura şablonlarını kalem verileri, müşteri detayları ve hesaplanmış toplamlar ile doldurun. Sayfa üstbilgilerini ve altbilgilerini HTML Üstbilgileri ve Altbilgileri örneğinde gösterilen teknikleri kullanarak ekleyin.

Sertifika ve kimlik belgesi üretimi: Sertifika şablonlarını alıcı isimleri, tamamlama tarihleri ve kurs başlıkları ile kişiselleştirin. Yayımlandıktan sonra sahtecilikleri önlemek için Dijital İmzalar örneğini kullanarak güvenlik ekleyin. PDF/A standardı, düzenlenen endüstrilerde sertifikaların uzun süreli arşivlenmesi için genellikle gereklidir.

Rapor oluşturma: Rapor şablonlarını analitik veriler veya anket sonuçları ile doldurun. Mevcut bir formu doldurmak yerine PDF düzenini sıfırdan oluşturmanız gereken durumlarda, HTML'den PDF'ye dersine bakın.

Node.js'de PDF Form Doldurmanın Bir Sonraki Adımları Nelerdir?

Bu kılavuz, bir PDF'nin yüklenmesini, metin alanlarını, onay kutularını, açılır menüleri ve radyo düğmelerini doldurmayı, değerleri kilitlemek için formu düzleştirmeyi ve tamamlanmış belgeyi kaydetmeyi gösterdi. Aynı PdfDocument örneği, dosyayı yeniden yüklemeden ilave işlemleri destekler -- dijital imzalar ekleyin, çıktıyı sıkıştırın veya metin çıkarın.

Ücretsiz bir deneme başlatın ve projenizde IronPDF'yi test edin veya lisans seçeneklerini görüntüleyin ve dağıtımınıza uygun planı bulun.

Başka neler yapabileceğinizi görmek için hazır mısınız? Buradan tam Node.js ders koleksiyonuna göz atın: Node.js'de HTML'den PDF'ye