AddPDFA3AssociatedFileFromString

Document properties

Description

Tạo một dòng tệp nhúng từ các byte bộ nhớ, thêm đặc tả tệp vào cây tên tệp đính kèm tài liệu, và đăng ký nó trong mảng Catalog /AF cho các quy trình công việc PDF/A-3

Syntax

Delphi

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

Parameters

FileNameTên tệp hiển thị cho tệp đính kèm, chẳng hạn như invoice.xml
MIMETypeLoại MIME được ghi vào luồng tệp nhúng, chẳng hạn như text/xml hoặc application/xml
DescriptionVăn bản /Desc tùy chọn được ghi vào đặc tả tệp
RelationshipGiá trị /AFRelationship, thường là Source, Data, Alternative, Supplement, hoặc Unspecified
FileBytesCác byte thô cần lưu trữ trong luồng tệp nhúng

Return values

0Không có tài liệu hoạt động, tham số không hợp lệ, hoặc tài liệu hiện tại không ở chế độ PDF/A-3
Non-zeroHandle đối tượng của đặc tả tệp mới được tạo

Remarks

Tệp có thể nhìn thấy trong danh sách đính kèm tài liệu và cũng được tham chiếu bởi mảng Catalog /AF do các tệp liên kết PDF/A-3 yêu cầu

Đối với hóa đơn XML chuẩn Factur-X, ZUGFeRD, hoặc XRechnung, nên ưu tiên dùng AddFacturXAssociatedFileFromString để siêu dữ liệu hóa đơn và các kiểm tra cấu hình được ghi nhất quán

Example

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

See also

AddFacturXAssociatedFileFromString, SetPDFAMode, SetEmbeddedFileAFRelationship, AddEmbeddedFile