AddPDFA3AssociatedFileFromString

Dokumenteigenschaften

Beschreibung

Erstellt aus Speicherbytes einen Stream für eine eingebettete Datei, fügt die Dateispezifikation zum Namensbaum der Dokumentanhänge hinzu und registriert sie für PDF/A-3-Abläufe im Katalogarray /AF

Syntax

Delphi

Function TPDFlib.AddPDFA3AssociatedFileFromString(Const FileName, MIMEType, Description, Relationship: WideString; Const FileBytes: AnsiString): Integer;

Parameter

FileName	Der angezeigte Dateiname des Anhangs, beispielsweise `invoice.xml`
MIMEType	Der in den eingebetteten Dateistream geschriebene MIME-Typ, beispielsweise `text/xml` oder `application/xml`
Description	Der optionale Text `/Desc`, der in die Dateispezifikation geschrieben wird
Relationship	Der Wert `/AFRelationship`, üblicherweise `Source`, `Data`, `Alternative`, `Supplement` oder `Unspecified`
FileBytes	Die im Stream der eingebetteten Datei zu speichernden Rohbytes

Rückgabewerte

0	Kein aktives Dokument, ungültige Parameter oder das aktuelle Dokument befindet sich nicht in einem PDF/A-3-Modus
Non-zero	Das Objekthandle der neu erstellten Dateispezifikation

Anmerkungen

Die Datei ist in der Anlagenliste des Dokuments sichtbar und wird außerdem vom Katalogarray /AF referenziert, das für PDF/A-3-zugeordnete Dateien erforderlich ist

Für Standardrechnungs-XML nach Factur-X, ZUGFeRD oder XRechnung sollte AddFacturXAssociatedFileFromString verwendet werden, damit Rechnungsmetadaten und Profilprüfungen einheitlich geschrieben werden

Beispiel

// Attach source XML to a PDF/A-3b document
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);
  PDF.NewDocument;
  FileID := PDF.AddPDFA3AssociatedFileFromString(
    'invoice.xml',
    'text/xml',
    'Invoice source data',
    'Source',
    InvoiceXML);
  if FileID = 0 then Exit;
  PDF.SaveToFile('archive.pdf');
end;

Siehe auch

AddFacturXAssociatedFileFromString, SetPDFAMode, SetEmbeddedFileAFRelationship, AddEmbeddedFile