CheckFileCompliance

Uyumluluk, Belge inceleme

PDF/UA okuyucu profili seçimi

PDF/UA denetimleri, XMP pdfuaid:part=2 tanımlıyorsa bölüm 2'yi seçer, aksi hâlde bölüm 1 denetimlerini korur; burada anlatılan eski PDF/UA-1 denetimlerinin bölüm 2 için geçerli olduğu ima edilmez

PDF/UA-2 profili; çekirdek kimliklendirme, ad alanı, rol ve yapı denetimlerini uygular. Yapılandırılmış raporlar PDF/UA-2 ve ISO 14289-2 kullanır ve fullCertification=false ile doğrulanmamış kapsamı bildirir

Hedef bölümü zorlamak için CheckFilePDFUACompliance ya da RunPDFUAValidationPipelineTask'ı, yetenek sınırlarını incelemek için GetPDFUAReadValidationCoverageJSON'u kullanın

Açıklama

Harici bir PDF dosyasını okur ve seçilen ISO uyumluluk standardına göre doğrular. Döndürülen değer ya sıfırdır (dosya seçilen testi sorunsuz geçer) ya da algılanan her sorunu listeleyen sıfır olmayan bir StringListID tanıtıcısıdır. Listedeki her girdi kısa bir kod, iki nokta ve insan okunabilir bir iletiden oluşur — GetPDFUADiagnostics işlevinin kullandığı kod biçimiyle tam olarak aynıdır. Sonucu GetStringListCount ve GetStringListItem ile numaralandırınPDF/A testi altı uyumluluk modunun tamamını (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) kapsar ve hangi kural kümesinin uygulanacağına karar vermek için

pdfaid:part/pdfaid:conformance XMP girdilerini okurPDF/UA-1 testi (v3.56.0'da eklendi) harici bir PDF'yi ISO 14289-1'e göre denetler ve PDF/A

10xxx kodlarından görsel olarak ayrı kalmaları için tanılama kodlarını 00xxx aralığında üretir

Sözdizimi

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

Parametreler

Dönüş değerleri

PDF/A sorun kodları (ComplianceTest = 1)

PDF/UA-1 sorun kodları (ComplianceTest = 2)

Açıklamalar

PDF/A testi teslimattan önce hızlı bir özdenetim olarak tasarlanmıştır. Bir dosyayı doğrudan eler (yanlış PDF sürümü, eksik OutputIntent, A düzeyinde eksik yapı ağacı, şifreleme, PDF/A-1'de katmanlar) belge düzeyindeki sorunları yakalar. Her içerik akışı operatörünü incelemez ve boyanan her nesne için yazı tipi gömmesini veya renk uzayı başvurularını doğrulamaz — bu doğrulamalar özel bir PDF/A doğrulayıcı (veraPDF gibi) gerektirir. Bu işlevi ilk basamak denetimi ve derleme hatlarında regresyon kapısı olarak kullanın. Kitaplığın sorun listelerini yeniden kullanılabilir bir metin raporu olarak biçimlendirmesini istiyorsanız CreatePreflightReport veya SavePreflightReport işlevlerini kullanın. Metin, JSON, HTML veya CSV rapor çıktısı için CreatePreflightReportEx ya da SavePreflightReportEx işlevlerini kullanın; eksiksiz rapor iş akışı için Preflight Reports sayfasına bakınYardımcı API

GetPDFUADiagnostics, harici bir dosya yerine şu anda oluşturulan bellek içi belge üzerinde PDF/UA (ISO 14289-1) için benzer denetimler yaparBu kitaplıkla PDF/A çıktısı üretirken herhangi bir içerik eklemeden önce

SetPDFAMode işlevini çağırın. SetPDFAMode içindeki üretim tarafı koruması, seçilen bölümün yasakladığı işlemleri engeller; böylece bu şekilde oluşturulan belge normalde CheckFileCompliance testini otomatik geçer

Örnek

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

Ayrıca bkz.

Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode

Uyumluluk testi 3, PDF/X'i (ISO 15930) denetler: sürüm kimliği, çıktı niyeti, sayfa geometrisi, gömülü yazı tipleri ve yasak özellik kümesi; PDF/X-6 için ayrıca ek açıklama bayraklarını ve sabit görünümleri, AcroForm ve imza görünümlerini, XFA ve görüntüleyici üretimi görünüm dışlamalarını, eylem yerleşimini, eylem zincirlerini, izin verilen adlandırılmış eylem kümesini ve her UseBlackPtComp değerini doğrular

Uyumluluk testi 4, PDF/VT-3 kimlik meta verilerini, PDF/X-6 aile tabanını, DPartRoot ve DPart grafiğini, DPM adlarını ve değerlerini, kayıt düzeyini, sayfa sırasını ve tam yaprak kapsamını denetler; bileşik denetimler tek bir ayrıştırıcı geçişi paylaşır

Uyumluluk testi 5, PDF/R-1 işaretçi yerleşimini, sürüm ve şifrelemeyi, nesil sıfır dolaylı nesneleri, kısıtlı sözlük ve filtreleri, tek akış sayfa programlarını, sıralı raster şeritlerini, görüntü kodlamalarını, sayfa kapsamını ve etkin çözünürlüğü denetler; paylaşılan bir doğrulama hattı ayrışmasını yeniden kullanabilir

Uyumluluk testi 6, PDF/X temelini ve PDF/VCR-1 XMP kimliğini, tek doğrudan şablon kökünü, bildirilen alanları, isteğe bağlı sayfa seçim alanını ve her yaprak PassThrough değiştirme yer tutucusunu, sayfa bağlamayı, MCID ve sınırlayıcı kutuyu denetler; paylaşılan bir doğrulama hattı ayrışmasını yeniden kullanabilir

Uyumluluk testi 7, PDF/E-1 kimliğini ve yaşam döngüsü meta verilerini, trailer tanımlayıcılarını, izin verilen şifrelemeyi, çıktı niyetlerini ve aygıt renk uzaylarını, içerik işleçlerini, yazı tiplerini, ek açıklamaları, formları, isteğe bağlı içeriği, eylemleri, dış dosya başvurularını, grafik durumları ve 3B akış kısıtlarını denetler; paylaşılan bir doğrulama hattı ayrışmasını yeniden kullanabilir