CheckFileComplianceA

Uyumluluk, Belge inceleme

Açıklama

Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış CheckFileCompliance ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır

Harici bir PDF dosyasını okur ve seçilen ISO uyumluluk standardına göre doğrular. Döndürülen değer sıfır (dosya seçilen testi hatasız geçer) veya 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 üst üste ve insan tarafından okunabilir bir iletiden oluşur — tam olarak GetPDFUADiagnostics tarafından kullanılan kod biçimi. Sonucu GetStringListCount ve GetStringListItem ile numaralandırın

PDF/A testi altı uygunluk modunun tümünü (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) kapsar ve uygulanacak kural kümesini belirlemek için pdfaid:part/pdfaid:conformance XMP girdilerini okur

PDF/UA-1 testi (v3.56.0 sürümünde eklendi), harici bir PDF'yi ISO 14289-1'e göre denetler ve 10xxx aralığında tanılama kodları yayar; böylece bunlar PDF/A 00xxx kodlarından görsel olarak ayrı kalır

Sözdizimi

Delphi

Function DLCheckFileComplianceA(InstanceID: Integer; InputFileName, Password: PAnsiChar; ComplianceTest, Options: Integer): Integer;

DLL

int DLCheckFileComplianceA(int InstanceID, const char * InputFileName, const char * 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 teslimden önce hızlı bir öz denetim olarak tasarlanmıştır. Dosyayı doğrudan uygunsuz kılan belge düzeyi sorunlarını yakalar (yanlış PDF sürümü, eksik OutputIntent, A düzeyinde eksik yapı ağacı, şifreleme, PDF/A-1 içindeki katmanlar). Her içerik akışı işlecini dolaşmaz ve boyanan her nesne için yazı tipi gömme veya renk uzayı başvurularını doğrulamaz — bu doğrulamalar özel bir PDF/A doğrulayıcısı (veraPDF gibi) gerektirir. Bu işlevi ilk denetim ve derleme işlem hatlarında regresyon kapısı olarak kullanın. Kitaplığın sorun listelerini yeniden kullanılabilir bir metin raporu olarak biçimlendirmesini istediğinizde CreatePreflightReport veya SavePreflightReport kullanın. Metin, JSON, HTML veya CSV rapor çıktısı için CreatePreflightReportEx ya da SavePreflightReportEx kullanın; eksiksiz rapor iş akışı için Preflight Raporları bölümüne bakın

Tamamlayıcı API GetPDFUADiagnostics, harici bir dosya yerine o anda bellekte oluşturulmakta olan belge üzerinde PDF/UA-1 (ISO 14289-1) için benzer denetimler gerçekleştirir

Bu kitaplıkla PDF/A çıktısı oluştururken herhangi bir içerik eklemeden önce SetPDFAMode çağrısını yapın. SetPDFAMode içindeki oluşturma tarafı koruması, seçilen bölümün yasakladığı işlemleri engeller; bu nedenle bu şekilde oluşturulan bir belge normalde CheckFileCompliance denetimini otomatik olarak 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