AddFacturXAssociatedFileFromString

Document properties

Description

فایل XML فاکتور الکترونیکی را به عنوان فایل مرتبط PDF/A-3 می‌نویسد و متادیتای مورد نیاز XMP فاکتور الکترونیکی را برای پروفایل‌های Factur-X، ZUGFeRD و XRechnung تولید می‌کند

Syntax

Delphi

Function TPDFlib.AddFacturXAssociatedFileFromString(Const XMLBytes: AnsiString; Const ConformanceLevel, FileName, Description, Relationship, Version, CountryCode: WideString): Integer;

Parameters

XMLBytes	بایت‌های خام XML با کدگذاری UTF-8 جهت جاسازی
ConformanceLevel	سطح پروفایل فاکتور، مانند `MINIMUM`، `BASIC WL`، `BASIC`، `EN16931`، `EXTENDED`، `XRECHNUNG`، `EXTENDED-CTC-FR`، یا `EXTENDED-B2B-FR`
FileName	نام فایل XML پیوست‌شده، معمولاً `factur-x.xml`، `xrechnung.xml`، `zugferd-invoice.xml`، یا `ZUGFeRD-invoice.xml`؛ یک مقدار خالی به طور پیش‌فرض به `factur-x.xml` تغییر می‌یابد
Description	متن اختیاری `/Desc` نوشته‌شده در مشخصات فایل
Relationship	مقدار `/AFRelationship`؛ یک مقدار خالی به طور پیش‌فرض به `Alternative` تغییر می‌یابد
Version	نسخه پروفایل فاکتور؛ یک مقدار خالی به طور پیش‌فرض به `1.0` تغییر می‌یابد
CountryCode	یک کد پروفایل کشور اختیاری، مانند یک رشته خالی، `DE` یا `FR`

Return values

0	سند در حالت PDF/A-3 نیست، ترکیب XML یا پروفایل نامعتبر است، یا XML فاکتور از قبل اضافه شده است
Non-zero	دستگیره شیء برای مشخصات فایل تازه ایجاد شده

Remarks

این متد نام فایل، سطح انطباق، نسخه، پروفایل کشور و /AFRelationship را قبل از نوشتن پیوست اعتبارسنجی می‌کند

COMFORT is accepted only with ZUGFeRD-invoice.xml and version 1.0; zugferd-invoice.xml selects the ZUGFeRD 2.0 profile, and xrechnung.xml selects the XRECHNUNG profile

این متد فیلدهای XMP شامل DocumentFileName، DocumentType، Version و ConformanceLevel را می‌نویسد و بررسی می‌کند که شناسه راهنمای XML با پروفایل انتخاب‌شده مطابقت داشته باشد؛ محتوای صفحه فاکتور قابل مشاهده معمولی همچنان توسط فراخواننده قبل از ذخیره ایجاد می‌شود

Example

// Add EN 16931 invoice XML to a PDF/A-3b document
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);
  PDF.NewDocument;
  FileID := PDF.AddFacturXAssociatedFileFromString(
    InvoiceXML,
    'EN16931',
    'factur-x.xml',
    'Factur-X invoice XML',
    'Alternative',
    '1.0',
    '');
  if FileID = 0 then Exit;
  PDF.SaveToFile('factur-x.pdf');
end;