FastReport .NET'ten Erişilebilir PDF'ye Bir Rapor Nasıl Dışa Aktarılır (PDF/UA-1)

Engelli bireyler için erişilebilirlik yalnızca bir trend değil, birçok ülkede yasal bir zorunluluktur. Amerika Birleşik Devletleri'nde Engelli Amerikalılar Yasası (ADA) yürürlükte olup, Avrupa Birliği'nde ise Erişilebilirlik Direktifi (EN 301 549 standardı ile desteklenmektedir) geçerlidir. Her iki belge de kamu kurumlarını ve özel şirketleri, yardımcı teknolojiler tarafından algılanabilen formatlarda bilgi sağlamakla yükümlü kılıyor.

Erişilebilirlik hususları olmayan standart bir PDF, yalnızca bir sayfadaki görsel öğelerden oluşan bir koleksiyondur. Ekran okuyucular (ekran içeriğini seslendiren ve görme bozukluğu olan kişiler tarafından kullanılan programlar) başlıkları, tabloları veya dekoratif çerçeveleri ayırt edemez. Bu sorunu çözmek için Uluslararası Standardizasyon Örgütü (ISO), resmi olarak ISO 14289-1 olarak adlandırılan PDF/UA (Evrensel Erişilebilirlik için PDF) standardını geliştirdi. Bu, ISO tarafından yayımlanan ilk tam erişilebilir standarttır ve dağıtılan belgenin kendisi PDF/UA ile uyumludur.

FastReport .NET rapor oluşturucusunda 2027.1 sürümünden itibaren PDF/UA-1 desteği uygulanarak geliştiricilerin üçüncü taraf araçlara ihtiyaç duymadan erişilebilir belgeler oluşturması sağlandı.

Bu yazıda şunları yapacağız:

• PDF/UA-1'in ne olduğunu ve erişilebilir bir PDF'nin standart bir PDF'den nasıl farklı olduğunu inceleyin;
• FastReport .NET'te rapor dışa aktarımını kullanıcı arabirimi ve C# kodu aracılığıyla PDF/UA-1'e nasıl yapılandıracağınızı gösterin;
• FastReport'un otomatik olarak hangi belge yapısını oluşturduğunu ve nelerin manuel olarak yapılandırılması gerektiğini açıklayın;
• Oluşturulan dosyanın standarda uygunluğunu doğrulamak için kullanılan araçları listeleyin.

PDF/UA-1 nedir?

Görsel olarak, PDF/UA belgesi standart bir PDF'den ayırt edilemez: aynı sayfaları, yazı tiplerini, renkleri ve görselleri içerir. Aradaki fark dosyanın içindedir—bir "yapısal omurga" içerir: ekran okuyucuya bir başlığın veya tablonun nerede olduğunu, belirli hücrelerde hangi içeriğin bulunduğunu, görüntünün nerede olduğunu ve neyi tasvir ettiğini, bağlantının nerede başlayıp bittiğini ve belgenin hangi sırada olduğunu bildiren bir etiket yapısı okunmalı. Çizgiler, çerçeveler ve sayfa arka planları gibi dekoratif öğeler ayrı olarak işaretlenir; böylece ekran okuyucu bunları seslendirmek yerine görmezden gelir.

Kullanıcı Arayüzü üzerinden dışa Aktarma

Bir raporu PDF olarak dışa aktarmak için tasarımcı araç çubuğundaki "Kaydet" düğmesini kullanın ve açılır menüden "Adobe Acrobat..." seçeneğini belirleyin.

Dışa aktarma iletişim kutusunda üç parametre yapılandırılmalıdır:

1. "Seçenekler" sekmesi, "PDF Uyumluluğu" alanı — açılır listeden PDF/UA'yı seçin. Dışa aktarma işlemi PDF/UA-1 standardına (ISO 14289-1:2014) uygun bir belge oluşturur. Diğer iletişim kutusu parametreleri (yazı tipi gömme, görüntü sıkıştırma vb.) her zamanki gibi çalışır.

2. "Bilgi" sekmesi, "Başlık" alanı — belgenin adı. Bu, PDF/UA için zorunlu bir alandır; başlık olmadan belge, PAC (PDF Erişilebilirlik Denetleyicisi) gibi denetleyiciler tarafından doğrulama sırasında başarısız olur.
3. "Bilgi" sekmesi, "Belge dili" alanı — belgenin dili en-US, de-DE vb. şeklinde biçimlendirilmiştir. Bu alan yalnızca PDF/UA standardı seçildiğinde etkindir, çünkü dil belirtmek standardın zorunlu bir gerekliliğidir. Boş bırakılırsa geçerli sistem dili kullanılır, ancak dilin açıkça tanımlanması şiddetle tavsiye edilir.

Bu, dışa aktarma yapılandırmasını tamamlar; oluşturulan dosya artık PDF/UA-1 standardıyla tamamen uyumludur.

FastReport Otomatik Olarak Ne Üretir

PDF/UA'ya dışa aktarma, rapor içeriğinden belge yapısını otomatik olarak oluşturur:

Bu yaklaşım, herhangi bir ek düzen ayarı gerektirmeden çoğu raporu kapsar; dışa aktarma iletişim kutusunda PDF/UA'yı seçmeniz yeterlidir.

Tasarımcıda Belge Yapısını Yapılandırma

Otomatik yapı makul bir minimum değeri temsil eder, ancak rapor geliştiricileri bunu iyileştirebilir. Rapor nesnesi özelliklerine iki özelliğe sahip yeni bir PDF/UA kategorisi eklendi:

• SemanticRole – Öğenin belge yapısındaki rolü.

• Alternatif Metin – Öğe için alternatif metin. Görseller için bu, gösterilen şeyin açıklamasıdır (örneğin, "2026 satış grafiği"). Açıklama sağlanmamışsa, ekran okuyucu nesnenin adını seslendirir; bu genellikle bilgilendirici olmayan bir bilgidir. Alt metin bağlantılar için de kullanılır; boş bırakılırsa bağlantı metninin kendisi seslendirilir.

Tipik kullanım durumları:

1. Rapor başlığı — metin nesnesi için SemanticRole = "H1" değerini ayarlayın.
2. Logo veya marka blok seti AltText = "Company logo".
3. Anlam taşıyan bir çizgi veya şekil (örneğin, bir grafik veya diyagram)—açıklayıcı olarak ayarlayın SemanticRole = "Figure"ve sağlayın AltText; Atanmış bir rol olmadan, şekil bir dekorasyon olarak ele alınır ve seslendirilmez.

Önemli: Bir rol açıkça tanımlanmışsa, bu rolün söz konusu nesne türü için uygunluğu doğrulanmaz. Doğru rol atamasının sorumluluğu tamamen rapor geliştiricisine aittir.

C# Kodu ile dışa Aktar

Aynı sonuç programlı olarak elde edilebilir. Aşağıdaki örnekte, iki nesne için roller ve alternatif metinle birlikte PDF / UA standardı, belge başlığı ve belge dili tanımlanmıştır:

// Raporu yükleyin
Report report = new Report();
report.Load(@"C:\Reports\Invoice.frx");
 
// Rolleri ve alternatif metni atayın
((TextObject)report.FindObject("ReportTitle")).SemanticRole = "H1";
((PictureObject)report.FindObject("Logo")).AltText = "Şirket logosu";
 
// PDF/UA'ya aktarma
PDFExport pdfExport = new PDFExport();
PDF dışa aktarma.PdfCompliance = PDFExport.PdfStandart.Pdf_UA;
PDF dışa aktarma.Title = "Başlık";
PDF dışa aktarma.Belge dili = "de-DE";
 
rapor.Prepare();
report.Export(pdfExport, "Invoice.pdf");

Sonuçların Doğrulanması

Herhangi bir PDF/UA belgesi ücretsiz doğrulama araçları kullanılarak doğrulanabilir:

• veraPDF — bir komut satırı doğrulayıcısı; PDF/UA-1 için 106 kural içeren bir profil sağlar.

• PAC (PDF Erişilebilirlik Denetleyicisi) — PDF/UA-1 ve WCAG 2.2 standartlarına uygunluk kontrolleri yapan, kaliteyi değerlendiren ve yapay zeka destekli erişilebilirlik analizi sunan daha sıkı bir doğrulayıcıdır. Yapay zeka kontrollerinin bazen yanlış pozitif sonuçlar üretebileceğini, ancak bunun belgenin PDF/UA-1 standardına gerçek uyumluluğunu etkilemeyeceğini unutmayın.

Sonuç

FastReport .NET'teki PDF/UA-1 için yerleşik destek, üçüncü taraf araçlara güvenmeden tamamen erişilebilir belgelerin oluşturulmasını sağlar. Belge yapısı etiketlemesi otomatik olarak işlenir, yani varsayılan olarak rapor geliştiricilerinin yalnızca anlamlı görüntüler için alternatif metinler sağlaması ve dışa aktarma ayarlarında PDF/UA standardını seçmesi gerekir. Gerekirse, bu etiketler doğrudan nesne özellikleri aracılığıyla daha da geliştirilebilir.