Connect üzerinden uygunluk modu seçin

Sınır. Bir uygunluk modu ayarlamak, ilgili standardın gerektirdiği katalog ve meta veri bağlantılarını kurar. Motorun, o standarda uygun olması amaçlanan çıktıyı üretmesini sağlar. Belgeyi “uygun” hâle getirmez. veraPDF gibi bir doğrulayıcı, uygunluk durumuna karar verir. Bu sayfadaki her “uygunluk” ifadesini şöyle okuyun: “uygun olması amaçlanır; sonucu doğrulayıcı belirler”.

Bir bakışta

Bir belge yalnızca bir uygunluk ayırt edicisi taşır: düz mod, etiketli/PDF-UA modu veya PDF/A modu. Bu ayırt edici, yazıcıya hangi katalog, yapı ve meta veri bağlantılarının üretileceğini bildirir. Ayırt ediciyi Connect aktarımları üzerinden ayarlamak için bu reçeteyi kullanın. Etiketli mod ayarlayıcısı çekirdeğe dahildir. PDF/A-4 modu ayarlayıcısı kalıcı olarak Premium katmanındadır (ADR-011) ve yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydolur.

Her iki ayarlayıcıyı da çağırırsanız, her iki özellik yığını katmanlanır. Tek değerli ayırt edici yine de son yazan kazanır kuralına göre çözümlenir ve araçların bu üzerine yazmayı gözlemleyebilmesi için motor bir üzerine yazma uyarısı üretir.

Kurulum

composer require nextpdf/server

PDF/A modu ayarlayıcısının kullanılabilir olduğunu bir tools/list çağrısıyla doğrulayın. Bkz. /connect/tool-catalog/.

Kavramsal genel bakış

Uygunluk işaretçisi amaçlanan uygunluğu bildirir. Gerçek uygunluğu bir doğrulayıcı belirler (PDF/A-4 §6.7.3). Uygunluk, standardın gereksinimlerine göre belirlenir; belgeyi üreten yazılım tarafından ileri sürülmez (PDF/A-4 §6.7.3). Etiketli mod, yapı ağacını ve mark-info katalog girdilerini bağlar (ISO 32000-2 §14.7).

Mod değişimi bir bağlama işlemidir. Belgeyi, standarda göre yapılacak bir denetime hazırlar. Tek başına bir uygunluk sonucu değildir.

API yüzeyi

Araç adları, çalışma zamanı kayıt defterine göre tools/list aracılığıyla doğrulanır. Resmî katalog /connect/tool-catalog/ adresindedir. Bu reçete araç sayısını yinelemez. Ayırt ediciyi ilk içerik çağrısından önce seçin. Yazıcı, modu ilk sayfa üretilirken dondurur.

Kod örneği — Hızlı başlangıç

Bir belge oluşturun, ardından belgeyi etiketli/PDF-UA moduna geçirin:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

Yanıt, yazıcının her üretim noktasında denetlediği etkin mod yüklemlerini (etiketli / erişilebilirlik / arşivleme) bildirir. Eklenen katalog bağlantılarını da içerir. Yüklemler yazıcının ne üreteceğini gösterir; sonucun uygun olduğunu ileri sürmezler.

Kod örneği — Üretim

PDF/A-4’e geçin (Premium katmanı), ardından denetimi çalıştırın. Başarısız durumu, incelenecek normal bir sonuç olarak ele alın:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

Her iki ayarlayıcıyı da çağırırsanız, ayırt edici son yazan kazanır kuralına göre çözümlenir ve motor bir üzerine yazma uyarısı üretir. Özellik yığını bağlı kalmış her çeşit için standartlar denetimini çalıştırın, çünkü tek ayırt edici toplamsal değildir; ancak bağlantılar toplamsaldır.

Uç durumlar ve tuzaklar

İlk sayfadan sonra mod ayarlama, donmuş mod hatasıyla reddedilir. Modu, belgeyi oluşturduktan hemen sonra ayarlayın.
Premium olmadan PDF/A ayarlayıcısı başarısız olur — kalıcı olarak Premium katmanındadır (ADR-011). Düz bir PDF 2.0 belgesi, PDF/A moduna gerek duymaz.
Bilinmeyen enum durumu reddedilir. Desteklenen arşivleme durumu PDF/A-4’tür (eski PDF/A profilleri kullanımdan kaldırıldı).
Arşivleme modunun yasakladığı işlem (örneğin gömülü JavaScript), arşivleme yüklemi etkinken reddedilir.
Denetimde çeşit/mod uyumsuzluğu, uygun olmayan işaretçi bulgusu döndürür. Etkin moda karşılık gelen çeşidi geçirin veya her iki yığın da bağlıysa her ikisini geçirin.

Performans

Frontmatter bütçesi bir belgeleme üst sınırıdır. Mod bağlama, ölçülebilir ayrı bir aşama eklemez.

Güvenlik notları

Genel Connect aktarım kılavuzunun ötesinde ek bir not yoktur.

Uygunluk

İddia	Madde	reference_id
Uygunluk işaretçisi amaçlanan uygunluğu bildirir; bir doğrulayıcı karar verir	PDF/A-4 §6.7.3
Uygunluk, gereksinimlere göre belirlenir; üretici tarafından ileri sürülmez	PDF/A-4 §6.7.3
Etiketli mod, yapı ağacını ve mark-info girdilerini bağlar	ISO 32000-2 §14.7

Bir uygunluk modu seçmek, motorun uygun olması amaçlanan çıktı üretmesini sağlar. Bu bir uygunluk sertifikası değildir. Sonucu bir doğrulayıcı belirler.

Ticari bağlam

PDF/A-4 modu ayarlayıcısı kalıcı olarak Premium katmanındadır (ADR-011) ve yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydolur. Etiketli mod ayarlayıcısı çekirdek yetenektir.

Connect ayrıntıları

Aktarım kullanılabilirliği (MCP / REST / gRPC)

Mod ayarlayıcıları ve denetim; MCP tools/call, REST araç uç noktası ve gRPC hizmeti üzerinden aynı paylaşılan araç yürütücüsüyle çağrılır.

HITL risk katmanı

Mod ayarlayıcıları dikkat düzeyindedir. Denetim salt okunurdur. Varsayılan olarak hiçbiri approval_required değildir. Bir operatör geçersiz kılması yalnızca riski yükseltebilir. Bkz. /connect/hitl-risk-tiers/.

Onay geçidi JSON zarfı

Bir operatör geçersiz kılması bunlardan birini approval_required seviyesine yükseltmediği sürece, bu araçlar geçidi tetiklemez. Zarf ve tek kullanımlık belirteç sözleşmesi /connect/hitl-risk-tiers/ adresindedir.

Ayrıca bkz.

/cookbook/connect/compliance-check/ — etkin standarda göre doğrulayın.
/cookbook/connect/tagged-pdf-tutorial/ — uçtan uca etiketli PDF anlatımı.
/connect/tool-catalog/ — katman başına araç kümesi hesaplaması.
/connect/hitl-risk-tiers/ — risk modeli ve geçit.