Jak Wypełnić Pola Formularza PDF w Node.js

Jakie są Wymagania do Wypełniania Formularzy PDF w Node.js?

Przed uruchomieniem poniższych przykładów kodu potwierdź, że są spełnione trzy rzeczy: obsługiwana wersja Node.js, klucz licencji IronPDF i plik binarny IronPdfEngine.

Wersja Node.js: IronPDF wymaga Node.js 18 lub nowszej. Pobierz aktualne wydanie LTS z oficjalnej strony internetowej Node.js. Biblioteka używa asynchronicznego I/O Node.js dla wszystkich operacji PDF, więc await lub łańcuch obietnic jest standardowym wzorcem w całym zakresie. Starsze wersje Node.js nie są obsługiwane, ponieważ pakiet zależy od funkcji natywnego ESM i async_hooks, które wymagają Node.js 18+.

Klucz licencyjny: Aktywny klucz licencyjny IronPDF odblokowuje pełny API. Rozpocznij bezpłatny okres próbny, aby uzyskać klucz na potrzeby rozwoju i testowania, lub kup licencję do użytku produkcyjnego. Dla opcji wdrożeniowych (zmienne środowiskowe, pliki konfiguracyjne, menedżery tajemnic) zobacz Korzystanie z Kluczy Licencyjnych.

IronPdfEngine: Pakiet Node.js zawiera IronPdfEngine, wieloplatformowy silnik renderowania, który obsługuje rzeczywistą manipulację PDF. Ustawienia i uwagi specyficzne dla platformy (Windows, Linux, macOS) znajdują się w dokumentacji Użyj IronPdfEngine.

: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;

Jak zainstalować IronPDF for Node.js?

Instalacja IronPDF dla Node.js wymaga pojedynczej komendy npm. Uruchom ją w katalogu swojego projektu:

//: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

Pakiet zawiera deklaracje typów TypeScript, więc projekty TypeScript otrzymują pełne wsparcie IntelliSense bez oddzielnego pakietu @types. Pliki binarne specyficzne dla platformy dla Windows, Linux i macOS są pobierane automatycznie podczas instalacji. Pakiet @Iron Software/ironpdf na npm listuje wszystkie opublikowane wersje i zależności koleżeńskie.

Dla instrukcji jak dodać IronPDF do istniejącego monorepo lub workflowu opartego na Dockerze, zobacz dokumentację IronPDF dla Node.js.

Jak wypełnić formularze PDF programowo?

Ładowanie PDF i wpisywanie wartości do jego pól wymaga trzech asynchronicznych wywołań: PdfDocument.fromFile(), setFormFieldValue(), i saveAs(). Poniższy przykład wypełnia formularz aplikacji wielopolowej i opcjonalnie go spłaszcza, aby wartości nie mogły zostać zmienione po dostarczeniu.

Jak Wygląda Kompletny Przykład Wypełniania Formularzy?

Poniższy przykład ładuje PDF z kilkoma typami pól, wypełnia je i zapisuje wynik. Dla skupionego spojrzenia na tworzenie formularzy zamiast ich wypełniania, zobacz stronę przykładów PDF Forms.

//: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");

    // Pole wyboru 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");

    // Pole wyboru 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

Po wywołaniu getFormFieldNames(), zwrócona tablica informuje, które nazwy pól użył autor PDF. Jest to najszybszy sposób, aby uniknąć literówek w nazwach pól podczas integracji z formularzami, które nie stworzyłeś.

PoradyWywołać getFormFieldNames() raz podczas tworzenia, aby wydrukować dokładne nazwy pól w twoim PDF. Hardkodowanie złej nazwy jest najczęstszą przyczyną pustych pól po setFormFieldValue().

---

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak Obsługiwać Różne Typy Pól Formularza?

IronPDF obsługuje standardowe typy pól AcroForm: pola tekstowe, przyciski wyboru, rozwijane listy, listy i pola do podpisu. Metoda setFormFieldValue() akceptuje wartości tekstowe dla wszystkich typów; dla pól poczyw mych i radio, akceptowane wartości zależą od określenia pola w PDF.

Poniższa tabela pokazuje format wartości dla każdego typu pola:

//: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");

    // Pole wyboru
    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");

    // Pole wyboru
    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);

Jak zlikwidować pola formularza PDF po ich wypełnieniu?

Likwidacja formularza PDF łączy wszystkie wartości pól z treścią statyczną strony, usuwając warstwę interaktywną. Wynikowy dokument nie może być dalej edytowany, co zapobiega przypadkowym zmianom podczas dystrybucji i zapewnia spójne renderowanie we wszystkich przeglądarkach PDF.

Wywołać flattenAllFormFields() na załadowanym dokumencie po ustawieniu wszystkich wartości pól, a przed zapisaniem.

//: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);

Likwidacja jest odpowiednia dla ostatecznych dostaw -- umów po podpisaniu, certyfikatów po wydaniu lub faktur po zatwierdzeniu. Dla dokumentów, które wymagają dalszego przeglądu przed finalizacją, pominąć flattenAllFormFields() i zapisać bez niego.

Jakie są powszechne przypadki użycia automatyzacji formularzy PDF?

Automatyczne wypełnianie formularzy usuwa ręczne wprowadzanie danych z wysokowydajnych przepływów dokumentów. W poniższych scenariuszach omówiono najczęstsze wzorce wdrażane przez programistów z IronPDF.

Przetwarzanie aplikacji: Pobierz dane wnioskodawcy z bazy danych lub API REST i wypełnij formularze PDF dla usług finansowych, ubezpieczeniowych lub procesów przyjmowania w instytucjach rządowych. Połącz wypełnione formularze za pomocą przykładu Łączenie PDF, aby stworzyć jeden wielostronicowy pakiet zgłoszeniowy.

Generowanie faktur i paragonów: Wypełnij szablony faktur danymi z pozycji, danymi klienta i obliczonymi sumami. Dodaj nagłówki i stopki stron za pomocą technik pokazanych w przykładzie HTML Nagłówki i Stopki.

Generowanie certyfikatów i poświadczeń: Personalizuj szablony certyfikatów z nazwiskami odbiorców, datami ukończenia i tytułami kursów. Dodaj zabezpieczenie za pomocą przykładu Podpisy Cyfrowe, aby zapobiec manipulacji po wydaniu. Standard PDF/A jest często wymagany do długoterminowej archiwizacji certyfikatów w przemysłach regulowanych.

Generowanie raportów: Wypełniaj szablony raportów danymi analitycznymi lub wynikami ankiet. W przypadkach, gdy potrzebujesz zbudować układ PDF od podstaw, zamiast wypełniać istniejący formularz, zobacz samouczek HTML do PDF.

Jakie są kolejne kroki w wypełnianiu formularzy PDF w Node.js?

Ten przewodnik pokazał ładowanie PDF, wypełnianie pól tekstowych, pól wyboru, list rozwijanych i przycisków radiowych, likwidację formularza w celu zablokowania wartości i zapisanie ukończonego dokumentu. Ta sama instancja PdfDocument obsługuje dalsze operacje — dodawanie podpisów cyfrowych, kompresowanie wyniku lub wydobywanie tekstu — bez ponownego ładowania pliku.

Rozpocznij bezpłatny okres próbny, aby przetestować IronPDF w swoim projekcie lub zobacz opcje licencjonowania, aby znaleźć plan, który pasuje do Twojego wdrożenia.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź pełną kolekcję samouczków Node.js tutaj: HTML to PDF in Node.js