THotPDF.AddXFAPacket Method (XFA forms container)

THotPDF.AddXFAPacket / ClearXFAPackets / XFAPacketCount

THotPDF XFA forms container (v2.119.51)

Regista um pacote XFA (XML Forms Architecture) com nome para emissão dentro da entrada AcroForm /XFA do documento. PDF 1.7 §12.7.6 + §12.7.8 permite que um AcroForm transporte uma matriz /XFA juntamente com (ou em vez de) a matriz /Fields estática, viabilizando fluxos de trabalho híbridos AcroForm + XFA ou formulários XFA dinâmicos puros

Delphi syntax:

procedure AddXFAPacket(const PacketName: AnsiString; const XMLBytes: TBytes);

procedure ClearXFAPackets;

function XFAPacketCount: Integer;

Descrição

Cada chamada a AddXFAPacket regista um pacote nomeado. Nomes típicos (segundo a especificação XFA 3.3 e a Tabela 234 da PDF 1.7 §12.7.8):

template - form layout + scripts (the largest packet in most XFA documents).

datasets - data binding (the XML payload the template renders against).

config - viewer configuration.

connectionSet - external data connections.

localeSet - locale-specific formatting rules.

stylesheet - XSLT or CSS styling.

xfdf - XFDF form data overlay.

xmpmeta - XMP metadata.

signature - signature-related XFA data.

sourceSet - source-side data definitions.

Em EndDoc, cada pacote registado torna-se um objeto stream indireto comprimido com FlateDecode, e a matriz AcroForm /XFA alterna strings PDF com o nome do pacote e referências de stream pela ordem de registo, pelo que o layout é byte-deterministic. ClearXFAPackets remove todos os pacotes registados (útil para reutilizar uma instância THotPDF em vários documentos). XFAPacketCount devolve a contagem atual

Container-level support only

O HotPDF não analisa o XML XFA, não implementa o motor de layout dinâmico XFA, não executa FormCalc nem JavaScript dentro do template XFA e não valida a estrutura do template. O chamador cria o XML XFA por si próprio (normalmente através do Adobe LiveCycle Designer ou manualmente com base na especificação XFA 3.3) e o HotPDF emite os bytes verbatim

Os leitores consumidores com um motor XFA (Acrobat / Reader mais antigos, FormsCentral, alguns produtos de kiosk) renderizam o formulário; os leitores sem motor XFA (Adobe Reader DC a partir de 2017, a maioria dos leitores open-source) mostram os campos AcroForm de recurso se o documento for um fluxo híbrido AcroForm + XFA

PDF/A and PDF/X compliance gates

ISO 19005-1 §6.4.2 / ISO 19005-2 §6.4.2 / ISO 19005-3 §6.4.2 proíbem explicitamente formulários XFA (o motor de layout dinâmico não é arquivável de forma determinística). Os fluxos de prepress ISO 15930 rejeitam formulários interativos na totalidade. AddXFAPacket levanta de imediato sob qualquer PDFACompliance ou PDFXCompliance não vazio com a referência de especificação relevante. Nomes de pacote duplicados levantam. PacketName vazio ou XMLBytes vazio levantam. RequirePDFVersion(pdf15) promove automaticamente a versão do documento

AcroForm dictionary emission

A matriz AcroForm é emitida quando ou /Fields tem pelo menos uma entrada ou quando tiver sido registado pelo menos um pacote XFA. Os chamadores anteriores à v2.119.51 que não registem pacotes mantêm saída /AcroForm idêntica bit a bit

Typical workflow (pure XFA dynamic form)

PDF.BeginDoc;

TemplateBytes := TFile.ReadAllBytes('form-template.xml');

DataBytes := TFile.ReadAllBytes('form-data.xml');

PDF.AddXFAPacket('xdp:xdp', BytesOf('<xdp:xdp xmlns:xdp="http://ns.adobe.com/xdp/">'));

PDF.AddXFAPacket('template', TemplateBytes);

PDF.AddXFAPacket('datasets', DataBytes);

PDF.AddXFASignaturePacket(SigBytes); { caller-generated XAdES }

PDF.AddXFAPacket('/xdp:xdp', BytesOf('</xdp:xdp>'));

PDF.EndDoc;

XDP wrapper, single-stream, dynamic, and signed XFA

A matriz /XFA form tem de abrir e fechar com pacotes wrapper xdp:xdp, como o exemplo agora mostra (ISO 32000-1 §12.7.8). APIs XFA relacionadas: SetXFADocument escreve todo o documento XFA/XDP como um único fluxo /XFA, em exclusão mútua com AddXFAPacket; XFANeedsRendering define a flag do Catalog /NeedsRendering (ISO 32000-1 §7.7.2) para que um visualizador regenere um formulário XFA dinâmico na primeira abertura; AddXFASignaturePacket incorpora uma assinatura XAdES / XML-DSig gerada pelo chamador como o pacote signature. O HotPDF nunca gera nem analisa a assinatura - o chamador produz-na com uma biblioteca criptográfica XML sobre os conjuntos de dados XFA

XFA-to-AcroForm flattening

ApplyXFAAsAcroForm mapeia bytes XDP/XFA fornecidos pelo chamador para a página atual como widgets AcroForm nativos e gráficos de página simples. FlattenLoadedXFA executa a mesma conversão para um PDF carregado que já transporte um pacote /XFA incorporado. Passe Editable=False para tornar os widgets gerados só de leitura e inspecione XFAFlattenWarnings para elementos que não puderam ser mapeados