LlosLab Yazılım Geliştirme BloguPDF, Delphi ve belge yazılımı geliştiricileri için mühendislik notları.

Teknik makale

HotPDF: Delphi'de PDF/A, PDF/X ve PDF/UA doğrulaması

HotPDF Component

HotPDF, harici bir PDF runtime kurmadan doğrudan PDF oluşturma ve düzenleme, formlar, notlar, şifreleme, dijital imzalar, Unicode yazı tipleri, standart odaklı çıktı ve preflight raporları gereken Delphi ve C++Builder uygulamaları için yerel bir VCL PDF kütüphanesidir.

Bu yazı teams that deliver archival, print, or accessibility-sensitive PDF output from Delphi applications için hazırlanmıştır. PDF/A, PDF/X, and PDF/UA validation konusunu tek bir bileşen çağrısı olarak değil, üretim düzeyinde belge mühendisliği olarak ele alır.

Pratik risk şudur: a document can pass a visual review while missing fonts, output intents, tagged structure, metadata, or accessibility semantics required by the target standard. Bu nedenle akışın yazılı sözleşmeye, gözlemlenebilir tanılara ve gerçekçi regresyon dosyalarına ihtiyacı vardır.

Mimari kararlar

Select the standard before generating pages. target profile and conformance level for each output channel / font embedding, color profile, metadata, and transparency policy

  • target profile and conformance level for each output channel
  • font embedding, color profile, metadata, and transparency policy
  • tagging, reading order, alternate text, and artifact treatment
  • whether validation warnings block release or require documented waivers

Uygulama akışı

Use preflight findings as engineering requirements. Aşağıdaki sıra, iş akışını Delphi ve C++Builder ekipleri için incelenebilir tutar.

  1. select the compliance profile before creating the first page object
  2. configure fonts, images, color spaces, metadata, and tagging around that profile
  3. run preflight after generation and parse findings into actionable categories
  4. fix the document source instead of patching the PDF when the issue is template-owned
  5. save the validation report with the output package or support evidence

Doğrulama kanıtı

Validation artifacts for release and support. Bu alanları çıktı veya destek kaydıyla birlikte saklayın.

  • profile name, validator version, pass or fail status, and issue severity counts
  • font, color, metadata, tag-structure, and annotation findings
  • waiver owner and business reason for every accepted warning
  • sample output opened in the target archive, print, or accessibility workflow

Compliance choices affect layout and content

PDF/A, PDF/X, and PDF/UA optimize for different guarantees. A single document may not satisfy every profile without tradeoffs in color management, interactivity, transparency, tagging, or embedded content.

Operational metrics to watch

The first release should expose enough metrics to prove the workflow is healthy under real files, not only under curated samples.

  • count and rate for profile name, validator version, pass or fail status, and issue severity counts
  • warning trend for interactive forms and JavaScript may conflict with archival profiles
  • latency of the stage that must select the compliance profile before creating the first page object
  • profile usage for target profile and conformance level for each output channel

Mühendislik inceleme notları: PDF/A, PDF/X, and PDF/UA validation

Özelliğin bir demoyu aşıp sürüm, destek ve müşteri eskalasyonu sırasında savunulabilir olduğunu doğrulamak için bu inceleme notlarını kullanın.

  • Karar: target profile and conformance level for each output channel. Uygulama baskı noktası: configure fonts, images, color spaces, metadata, and tagging around that profile. Kabul kanıtı: waiver owner and business reason for every accepted warning. Regresyon tetikleyicisi: third-party template assets often introduce fonts or transparency outside policy
  • Karar: font embedding, color profile, metadata, and transparency policy. Uygulama baskı noktası: run preflight after generation and parse findings into actionable categories. Kabul kanıtı: sample output opened in the target archive, print, or accessibility workflow. Regresyon tetikleyicisi: interactive forms and JavaScript may conflict with archival profiles

Sınır durumları

  • interactive forms and JavaScript may conflict with archival profiles
  • print-ready color requirements do not automatically satisfy accessibility needs
  • tagged PDF repair late in the process is expensive and error-prone
  • third-party template assets often introduce fonts or transparency outside policy

Delphi / C++Builder notes

HotPDF Component should sit behind a small service boundary that receives files, streams, profiles, and credentials, then returns output paths, warnings, metrics, and validation status. Important terms include PDF/A, PDF/X, PDF/UA, preflight, output intent, tagged PDF.

Delphi kod örneği

Aşağıdaki Delphi taslağı bu konu için pratik bir servis sınırını gösterir. Politika kontrollerini, günlüklemeyi ve doğrulamayı dar ürün çağrısı bölümünün dışında tutarak akışı test edilebilir bırakın.

procedure ExportStandardsAwarePdf(const OutputFile: string; const ProfileName: string);
var
  Pdf: THotPDF;
  Report: string;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.FileName := OutputFile;
    ConfigureStandardsProfile(Pdf, ProfileName);
    Pdf.BeginDoc;
    WriteTaggedContent(Pdf);
    Pdf.EndDoc;
    Report := Pdf.CreatePreflightReport(OutputFile);
    FailBuildOnPreflightErrors(Report);
  finally
    Pdf.Free;
  end;
end;

Üretim kontrol listesi

  • İş akışını boş bir dosyada, normal bir müşteri dosyasında ve en kötü durum dosyasında çalıştırın
  • Oluşturulan PDF'yi hedef görüntüleyici, doğrulayıcı, yazıcı veya aşağı akış uygulamasıyla açın
  • Ürün sürümünü, profil sürümünü, giriş karmasını, çıktı yolunu, geçen süreyi ve uyarı sayısını kaydedin
  • Parolaları, sertifikaları, geçici dosyaları ve müşteri verilerini açık saklama kuralları altında tutun
  • Bir müşteri dosyası yeni bir uç durum ortaya çıkardığında regresyon belgeleri ekleyin

Ürün belgeleri

HotPDF Component

Ek kod örnekleri

Pdf.PDFXCompliance := 'X-1a';
Pdf.Trapped := 'Unknown';        // mandatory key under ISO 15930
ICC := TFileStream.Create('FOGRA39.icc', fmOpenRead);
try
  Pdf.AddPDFXOutputIntent('FOGRA39 (ISO 12647-2:2004)', '', ICC, 4, 'DeviceCMYK');
finally
  ICC.Free;
end;
Pdf.BeginDoc;
// draw with CMYK-safe colors, no transparency, no encryption
Pdf.EndDoc;
Pdf.PDFUACompliance := True;     // auto-enables tagged PDF
Pdf.Lang := 'en-US';             // set explicitly; empty falls back to 'en'
Pdf.BeginDoc;

Root := Pdf.AddStructureElement(sstDocument, nil);
H1 := Pdf.EmitTaggedHeading(1, Root, 50, 700, 'Quarterly Report');
Para := Pdf.BeginTaggedContent('P', Root);
Pdf.CurrentPage.TextOut(50, 650, 0, 'Revenue grew in all regions.');
Pdf.EndTaggedContent;

Pdf.EndDoc;