Een PDF-formulier invullen met NextPDF Connect (Pro)

In één oogopslag

Vul interactieve PDF-formuliervelden met NextPDF Connect met XML Forms Data Format (XFDF). De tool voor ondertekening en formulieren heet fill_form. De Pro-toolprovider registreert new FillFormTool(), met fill_form als protocolnaam. fill_form is een tool op Pro-niveau. Tijdens het opstarten controleert de server met class_exists() of het Pro-pakket aanwezig is en registreert de tool alleen wanneer het pakket aanwezig is. Als alleen Core is geïnstalleerd, ontbreekt fill_form in het register.

Installeren

composer require nextpdf/server
composer require nextpdf/pro

Bind een transport. Controleer vervolgens met diagnostic.capabilities of de tool bestaat (zie environment-diagnostics). Ga niet uit van een vaste set tools.

Conceptueel overzicht

XFDF koppelt veldnamen aan waarden met <field>-elementen. Elke naam moet overeenkomen met een AcroForm-veld dat al in het doeldocument bestaat. De velddictionary van het interactieve formulier bevat elk veld (ISO 32000-2 §12.7), en de opgegeven waarde wordt de waarde van het veld (ISO 32000-2 §12.7). Als een naam met geen enkel veld overeenkomt, slaat de tool die over in plaats van dit als fout te behandelen. De tool rapporteert hoeveel velden zijn ingevuld en hoeveel zijn overgeslagen.

API-oppervlak

Tool	Tier	Rol	Risiconiveau
`create_pdf`	Core	De sessie openen	Safe
`fill_form`	Pro	XFDF-waarden toepassen op AcroForm-velden	Caution
`output_pdf`	Core	De PDF renderen en retourneren	Approval Required / Review (base64)

Toolnamen zijn de protocolnamen van het register. De toolcatalogus is de officiële catalogus. De geïnstalleerde tier bepaalt welke tools beschikbaar zijn. Pro-tools verschijnen alleen wanneer het Pro-pakket is geïnstalleerd.

Codevoorbeeld — Snelstart

create_pdf (of laad een sjabloon dat al formuliervelden bevat).
fill_form met xfdf_data, waarmee veldnamen aan waarden worden gekoppeld.
output_pdf → base64.

Het resultaat rapporteert fields_filled, fields_skipped en de overeenkomende veldnamen.

Codevoorbeeld — Productie

Gebruik een sjabloon met AcroForm-veldnamen die u beheert. Valideer de XFDF tegen het XFDF-schema voordat u deze verstuurt. Controleer fields_skipped en de geretourneerde namenlijst om naamafwijkingen te detecteren (namen zijn hoofdlettergevoelig). Blijf bij grote invulopdrachten onder de XFDF-groottelimiet en splits de gegevens indien nodig.

Randgevallen en valkuilen

Onjuist opgemaakte XFDF. Een parsefout identificeert de problematische locatie. Escape XML-entiteiten en neem de xmlns op.
Naamafwijking. Een niet-overeenkomende veldnaam wordt stilzwijgend overgeslagen en fields_skipped wordt verhoogd. Namen zijn hoofdlettergevoelig.
Geen formuliervelden. Een document zonder AcroForm levert nul ingevulde velden op.
XFDF te groot. De server weigert gegevens die de groottelimiet overschrijden. Splits de gegevens of verwijder overbodige witruimte.
Pro afwezig. Als alleen Core is geïnstalleerd, is fill_form niet geregistreerd en retourneert een aanroep een unknown-tool-fout. Controleer dit eerst met diagnostic.capabilities.

Prestaties

Invullen gaat snel vergeleken met renderen. De uitvoer varieert van een paar KB tot tientallen KB, afhankelijk van het aantal velden en de lettertype-inbedding. Het profiel is structural.

Beveiligingsnotities

Veldwaarden worden documentinhoud. Plaats geen geheimen in formuliervelden als u de PDF vervolgens via een niet-vertrouwd kanaal retourneert. Het base64-pad heeft geen neveneffecten op het bestandssysteem. Bestandsuitvoer is afgeschermd.

Conformiteit

Bewering	Spec	Clausule	reference_id
Een formulierveld wordt bewaard in de velddictionary van het interactieve formulier.	ISO 32000-2	§12.7
De opgegeven gegevens worden de waarde van het veld.	ISO 32000-2	§12.7

Commerciële context

fill_form is een tool op Pro-niveau. De server registreert deze alleen wanneer het Pro-pakket bij het opstarten kan worden gevonden (de class_exists()-controle). Core-implementaties stellen de tool niet beschikbaar.

Transportbeschikbaarheid

Transport	Beschikbaar	Notities
MCP (stdio)	Ja (Pro)	Alleen aanwezig wanneer Pro is geïnstalleerd.
REST	Ja (Pro)	Hetzelfde.
gRPC	Ja (Pro)	Hetzelfde.

HITL-risiconiveau

fill_form is Caution omdat het een omkeerbare inhoudsmutatie is. output_pdf is Approval Required en wordt in base64-modus afgewaardeerd naar Review (HITL-risiconiveaus).

JSON-envelop van de bevestigingsgate

Base64-uitvoer:

{ "allowed": true }

Bestandsuitvoer retourneert de challenge-envelop die wordt beschreven in output-approval.