Her dosyayı PDF/A-1b diye işaretleyen bir dönüştürücü yayınlıyorsunuz, müşterinin kayıt sistemi bunları bir yıl boyunca içeri alıyor ve sonra bir denetim tüm partiyi veraPDF'den geçirince dosyaların üçte biri uyumsuz dönüyor. Hiçbir şey çökmemiş, istisna fırlatılmamış, dosyalar masanızdaki bütün görüntüleyicilerde gayet iyi açılmıştır. Sadece üzerlerine bastığınız standarda gerçekte uymuyorlardır. Arşiv PDF'lerinde olağan hata modu budur ve bu yüzden "bayrağı ayarladık" demek asla "doğrulandı" demekle aynı şey değildir
PDFium ve PDF/A hakkında bilinmesi gereken ilk şey, işin motorun dışında gerçekleştiğidir. PDFium PDF'i render eder, ayrıştırır ve yazar; ama genel arayüzünde ConvertToPDFA yoktur, OutputIntent yazan bir API yoktur, XMP API'si yoktur. Arşiv uygunluğunun her parçası — XMP paketi, ICC profiline sahip OutputIntent, katalog işaretleri, doğrulama — PDFiumPas'ın içinde, kaydedilen baytları ayrıştırıp bir incremental update üzerinden yeniden yazan, kabaca 2.000 satırlık saf Pascal bir birimde (FPdfPdfa.pas) yaşar. İşin nerede gerçekleştiğini bilmek, bir arşiv doğrulamayı geçemediğinde nereye bakacağınızı söyler; cevap PDFium değildir
PDF/A gerçekte ne ister ve nerede sorun çıkarır
PDF/A tek bir biçim değildir. ISO 19005 üç bölüm tanımlar (PDF/A-1, -2, -3) ve her birinin içinde farklı sözler veren uyumluluk seviyeleri vardır. B seviyesi (basic), yalnızca görsel görünümün yeniden üretilebilir olduğunu garanti eder. A seviyesi (accessible), B'nin üzerine etiketli yapı ağacı ve Unicode eşlemesi ekler. Yalnızca 2. ve 3. bölümlerde bulunan U seviyesi ise bunların arasında yer alır: tam yapı ağacı olmadan güvenilir Unicode metin. ISO 19005-1'de U seviyesi yoktur ve kütüphane bu kısıtı doğrudan kodlar
Biçimin kuralları arasında pratikte gerçekten can yakan birkaç tanesi vardır. Şifreleme açıkça yasaktır (ISO 19005-1 §6.1.3 ve devamı): bir PDF/A dosyası /Encrypt sözlüğü taşıyamaz. Belge, geçerli bir ICC profiline işaret eden OutputIntent aracılığıyla bir çıktı işleme koşulu bildirmelidir (§6.2.3.2). Uygunluk iddiasının kendisi, PDF/A identification schema altındaki XMP metadata içinde görünmelidir. A seviyesi ayrıca belgeyi makinece okunabilir yapan §6.8 logical structure, yani tag tree gerektirir. Bunlardan herhangi biri eksikse, dosya kusursuz çizilse bile bir uyumluluk doğrulayıcısı dosyayı reddeder
Arşiv üreten tek çağrı
PDFiumPas, TPdf.SaveAsPdfA arkasındaki bütün hattı dışarı açar. Basit aşırı yükleme hedef uyumluluğu alır ve varsayılan olarak PDF/A-1b seçer; "bunu sonsuza kadar görüntülenebilir yap" biçimindeki yaygın kullanım için doğru varsayılan budur
var
Pdf: TPdf;
begin
Pdf := TPdf.Create(nil);
try
Pdf.FileName := 'invoice.pdf';
Pdf.Active := True;
// Varsayılan uyumluluk pac1b'dir (PDF/A-1b)
if Pdf.SaveAsPdfA('invoice_archive.pdf') then
// dosya artık XMP, sRGB OutputIntent ve katalog işaretleri taşır
else
raise Exception.Create('PDF/A save failed');
finally
Pdf.Free;
end;
end;
Arka planda bu iki aşamalı bir hamledir. SaveAsPdfA önce PDFium'dan belgeyi FPDF_SaveAsCopy ile serileştirmesini ister, ardından bu bayt akışını InjectPdfAMarkers yöntemine verir; o da XMP metadata'yı, gömülü ICC profiline sahip sRGB OutputIntent'i ve yeniden yazılmış catalog'u incremental update olarak ekler. Kaynak sıfır konumundan okunur, hedef sıfır konumundan yazılır; özgün nesne ağacı bozulmadan kalır ve işaretler mevcut %%EOF sonrasına eklenir. Dosya yerine baytları istiyorsanız, SaveAsPdfAToStream bir TStream ve aynı seçenekleri alır
Options record ile uyumluluk seçimi
Belirli bir bölüm ve seviyeyi hedeflemek için bir TPdfASaveOptions kaydı geçin. Bunun Conformance alanı bir TPdfAConformance değeri alır. Enum, geçerli bütün birleşimleri kapsar ve bunun dışında hiçbir şey kapsamaz: 1. bölüm için pac1b, pac1a; 2. bölüm için pac2b, pac2u, pac2a; 3. bölüm için pac3b, pac3u, pac3a; ayrıca doğrulama tarafı için pacUnknown ve pacNone. pac1u yoktur, çünkü standartta böyle bir seviye yoktur
var
Pdf: TPdf;
Opts: TPdfASaveOptions;
begin
Pdf := TPdf.Create(nil);
try
Pdf.FileName := 'report.pdf';
Pdf.Active := True;
Opts := TPdfASaveOptions.Default;
Opts.Conformance := pac2u; // PDF/A-2u: güvenilir Unicode metin
Opts.Title := 'Quarterly Report 2026';
Opts.Author := 'Finance';
// Yerleşik sRGB IEC61966-2.1 profilini kullanmak için IccProfileData alanını boş bırakın
if not Pdf.SaveAsPdfA('report_a2u.pdf', Opts) then
raise Exception.Create('PDF/A-2u save failed');
finally
Pdf.Free;
end;
end;
Kaydın büyük kısmı boş bırakılabilir. Title, Author, Subject, Keywords, Creator ve Producer alanlarını boş bırakırsanız SaveAsPdfA bunları FPDF_GetMetaText aracılığıyla belgenin Info dictionary'sinden otomatik doldurur. CreationDate ile ModDate alanlarını boş bırakırsanız XMP tarihleri için mevcut UTC zamanını kullanır. DocumentId ile InstanceId alanlarını boş bırakırsanız, kütüphane bunları FPDF_GetFileIdentifier içinden önceden doldurur ve kaynak baytlardan türetilen deterministik bir ID'ye düşer. Bilinçli olarak geçersiz kılmak isteyebileceğiniz tek alan IccProfileData alanıdır: boş bırakılırsa paketlenmiş sRGB IEC61966-2.1 profili kullanılır, ancak CMYK ya da gri tonlamalı iş akışı kendi profilini vermelidir
A seviyesinin neden düşürüldüğü ve bunun neden dürüst seçim olduğu
Burada, bir bayrağın garanti anlamına gelmesini bekleyenleri şaşırtan incelik vardır. Etiket ağacı olmayan bir belge için pac1a isteyebilirsiniz, ancak PDF/A-1a §6.8 logical structure gerektirir ve kütüphane etiketsiz bir PDF'den yapı ağacı üretemez. SaveAsPdfA, A seviyesini iddia edip gerçekte başaramayan bir dosya üretmek yerine, gerçek bir etiketli yapı arar (/StructTreeRoot ile /MarkInfo ve /Marked true); bu yoksa iddiayı düşürür: pac1a, pac1b olur; pac2a, pac2b olur; aynı şey üç bölümün tamamında geçerlidir. İç yardımcılar PdfAIsLevelA ile PdfADowngradeToLevelB adlarını taşır
Gerekçeyi açıkça söylemeye değer: gerçekten karşıladığı seviyeyi dürüstçe ilan eden dosya, karşılamadığı bir seviyeyi yalan söyleyerek ilan eden dosyadan daha kullanışlıdır. U seviyesi farklı ele alınır. Gerçek Unicode kapsamını saptamak, meşru belgeleri gereksiz yere düşüren saf bir "/ToUnicode var mı" testini gerektirir (WinAnsi ve benzeri kodlamalar muaf tutulur); bu yüzden kaydetme tarafı U iddiasını çağıranın belirttiği gibi yazar ve olası uyuşmazlığın doğrulama tarafında işaretlenmesine izin verir. Garantili bir A seviyesi arşiv istiyorsanız, dönüştürmeden önce belgeyi etiketleyin; dönüştürücü orada olmayan yapıyı icat etmez
Yalnızca gerçek doğrulayıcının yakaladığı ICC tuzağı
Bu, öz denetimin geçip veraPDF'in — ISO 19005 referans doğrulayıcısının — dosyayı reddettiği bir tuzaktır. PDF/A, OutputIntent'in hedef profilinin geçerli bir ICCBased akışı olmasını ister ve §6.2.3.2, doğrulayıcının bu akışı bir renk uzayı olarak doğrulamasını zorunlu kılar. ICCBased bir akış, renk bileşeni sayısı olan /N'yi bildirmek zorundadır. Yalnızca /Length yazılıp /N yazılmayan bir ICC akış sözlüğü, veraPDF tarafından "The N entry (value null)... is missing" hatasıyla reddedilir
Sinsi yapan taraf, reddin yalnızca PDF/A-1b ve -1a için tetiklenmesidir. 2. ve 3. bölüm uyumluluk modelleri hedef profil üzerinde o belirli denetimi çalıştırmaz; dolayısıyla özdeş enjekte edilmiş yapı pac2b, pac3b ve pac2u altında doğrulanırken, pac1b altında sırf pdfaid:part değeri yüzünden başarısız olur. Akış sözlüğünün içine bakmadan yalnızca /DestOutputProfile anahtarının varlığını teyit eden bir denetleyici bunu asla görmez
PDFiumPas bunu IccComponentCount ile halleder; bu yordam ICC başlığının 16. ofsetindeki veri renk uzayı imzasını okur ve bileşen sayısına eşler: GRAY için 1, RGB , Lab ve XYZ için 3, CMYK için 4; bilinmeyen profilde varsayılan 3 alınır. Bu sayı akış sözlüğüne /N olarak yazılır. Değer hesaplanır, 3'e sabitlenmez; böylece IccProfileData üzerinden CMYK veya gri tonlama profili veren çağıran da doğru değeri alır. Daha geniş ders yöntemseldir: kütüphane içi denetleyicinin ve otoriter bir doğrulayıcının her birinin kör noktaları vardır ve PDF/A çıktısı, öz denetimlere güvenmek yerine veraPDF gibi bir referans uygulamaya karşı uçtan uca test edilmelidir. Temiz arşivlerin arkasındaki aynı incremental-update disiplini sıkıştırılmış nesne ve xref stream doğrulaması makalesinde anlatılır; bu önemlidir, çünkü enjektörün tükettiği modern PDF'ler çoğu zaman cross-reference stream üzerine kuruludur
Şifreleme, xref stream'ler ve diğer kenarlar
ISO 19005 şifrelemeyi yasakladığı için kaydetme yolu, yazmadan önce bunu kaldırır. SaveAsPdfA serileştirme sırasında FPDF_REMOVE_SECURITY uygular; böylece şifreli bir kaynak (parolasıyla yüklenmişse) arşive giderken şifresi çözülmüş olarak yazılır. Şifrelenmemiş bir belgede bu no-op olur ve hiçbir şeyi değiştirmez. Sonuç aynı kısıttır; HotPDF de bunu ters yönden uygular: tek bir dosya hem şifreli hem de PDF/A olamaz. Bir iş akışı ikisini de gerektiriyorsa cevap iki artefakttır: dağıtım için şifreli kopya ve arşiv için ayrı temiz kopya
Bir başka kenar da vurana kadar görünmez: saf cross-reference stream kullanan ve trailer anahtar sözcüğünü taşımayan PDF 1.5+ belgeleri. Enjektör, kaynak /Info değerini bulup incremental update'i eklemek için trailer'ı okur ve xref-stream biçimini kabul etmek zorundadır; aksi halde böyle bir belge, işaretler sessizce düşürülmüş biçimde kopyalanırdı. ISO 32000-1 §7.5.6 açıkça, klasik trailer incremental update'in xref-stream belgesinin arkasından gelmesine izin verir; /Prev xref-stream ofsetini işaret eder ve enjektör tam olarak bu yapıyı üretir. PDFium'un kendi FPDF_SaveAsCopy yordamı her zaman klasik trailer yazar; bu yüzden normal hatta enjektör saf xref-stream kaynakla karşılaşmaz, ancak dışarıdan gelen belgeler için okuma yolu bunu yine de destekler
İddiaya güvenmeden önce doğrulama
Kütüphane, TPdf.ValidatePdfA adlı bayt düzeyinde bir denetleyiciyle gelir; bu yordam bir TPdfAValidationResult döndürür. Bunun Conformance alanı algılanan seviyeyi bildirir ve Issues alanı bir TPdfAValidationIssue değer kümesidir; kolaylık yöntemi IsCompliant ise yalnızca gerçek bir seviye algılandığında ve sorun kümesi boş olduğunda true olur. Bunu bir batch içinde hızlı ilk kapı olarak çalıştırın
var
Pdf: TPdf;
Res: TPdfAValidationResult;
Issue: TPdfAValidationIssue;
begin
Pdf := TPdf.Create(nil);
try
Pdf.FileName := 'invoice_archive.pdf';
Pdf.Active := True;
Res := Pdf.ValidatePdfA;
if Res.IsCompliant then
Writeln('Conformant: detected level ', Ord(Res.Conformance))
else
for Issue in Res.Issues do
Writeln('Issue: ', Ord(Issue));
finally
Pdf.Free;
end;
end;
Bunun size ne kazandırdığını bilin. Bayt düzeyindeki denetleyici yapısal sorunları — eksik OutputIntent, yasaklı bir eylem, mevcut bir /Encrypt, 1. bölümün yasakladığı şeffaflık — yüksek güvenle yakalar; yazı tipi gömme saptaması ise glif başına kapsamı kovalamak yerine bilinçli olarak yalnızca yüksek güvenli sinyal bildiren bir sayım sezgisine dayanır. Tam bir içerik ayrıştırıcısı gerektiren içerik akışı operatör analizi ise tasarım gereği kapsam dışıdır. Yayın kapısı için kütüphane içi denetleyiciyi veraPDF ile eşleyin: denetleyici anlıktır ve DLL olmadan her yerde çalışır, veraPDF ise otoriterdir. Bu eşleştirmeyi bir batch koşusuna bağlamak batch preflight report CLI konusudur; gerçek arşiv iş akışında bu doğrulamanın yeri orasıdır
Burada gösterilen SaveAsPdfA, InjectPdfAMarkers ve ValidatePdfA API'leri, Delphi, C++Builder ve Lazarus/FPC için PDFium Component ile birlikte sunulur. Ürün sayfası, tam uyumluluk enum'u ve bu örneklerin arkasındaki options record da dahil olmak üzere eksiksiz API başvurusuna bağlantı verir