Connect üzerinden toplu standart denetimi

Bir bakışta

Tek bir çağrıda çok sayıda PDF’yi bir veya daha fazla adlandırılmış politikaya göre denetlemek için bu tarifi kullanın. Tarif, toplu uyumluluk aracını Connect taşıma katmanları üzerinden çağırır. Bu araç Enterprise katmanında yer alır: bir class_exists() yoklaması aracı algılar ve araç yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydedilir. Araç her belgeyi istekteki her politikaya göre denetler, ardından belge ve politika başına birleştirilmiş bir rapor döndürür.

Tek belge denetiminde olduğu gibi, her politika için “geçti” sonucu yalnızca aracın uyguladığı kuralları denetlediği anlamına gelir. Bu, bağımsız bir uygunluk sertifikası değildir. Uygunluk kararını bir doğrulayıcı verir.

Kurulum

composer require nextpdf/server

Enterprise toplu aracının varlığını bir tools/list çağrısıyla doğrulayın. Bkz. /connect/tool-catalog/.

Kavramsal genel bakış

Bir standart her belge için gereksinimleri belirler ve denetleyici her belgeyi bu gereksinimlere göre değerlendirir (PDF/A-4 §6.2.3). Uygunluk, üretici tarafından beyan edilmez; gereksinimlere göre belirlenir (PDF/A-4 §6.7.3). İmzayla ilgili politikalar için, PDF Gelişmiş Elektronik İmzalar (PAdES) temel düzeyleri birbirinden farklıdır ve B-LT/B-LTA düzeyleri (doğrulama materyali, arşiv zaman damgası) yalnızca Enterprise’a özgü bir yetenektir (ETSI EN 319 142-2 §5.5). Toplu sonuç, belge kümesinin tamamı için aynı dar anlamı taşır: “uygulanan hiçbir kural başarısız olmadı”.

API yüzeyi

Araç adlarını çalışan kayıt defterine göre tools/list ile doğrulayın. Resmi kayıt kataloğu /connect/tool-catalog/. Bu tarif araç sayısını tekrarlamaz.

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

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "batch_compliance_check",
    "arguments": {
      "sources": ["/data/q1.pdf", "/data/q2.pdf"],
      "policies": ["pdfa-4"]
    }
  }
}

Kod örneği — üretim

curl -sS -X POST https://connect.example.com/v1/tools/batch_compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sources":["/data/q1.pdf","/data/q2.pdf"],"policies":["pdfa-4"]}' \
  -o /tmp/batch.json -w '%{http_code}' > /tmp/batch-status || {
    echo "transport failure invoking batch_compliance_check" >&2; exit 1; }

Yanıt, bir toplu işlem kimliği, toplam pass/fail sayıları, politika başına sonuçlar ve başarısızlık nedenleriyle birlikte belge başına bir checks dizisi içerir. Başarısız olanları filtreleyin, düzeltin ve yalnızca etkilenen belgeleri yeniden gönderin.

Sınır durumları ve dikkat edilmesi gerekenler

Boş sources veya policies, geçersiz parametreler hatası döndürür.
Eksik bir dosya, tüm toplu işlemi başarısız kılmak yerine her sonuçta bir hata olarak görünür. Her sonuçta hata alanı olup olmadığını denetleyin.
Toplu işlem boyutu sınırının aşılması açık bir hata döndürür. İşi daha küçük toplu işlemlere bölün.
Bilinmeyen politika kimliği, tanınan tanımlayıcıları belirten bir bilinmeyen standart hatası üretir. B-LT/B-LTA düzeylerine başvuran imza politikaları yalnızca bu materyali üretebilen bir Enterprise dağıtımında anlamlıdır.
Araç yok. nextpdf/premium olmadan Enterprise toplu aracı kaydedilmez; çağrı bilinmeyen araç hatasıyla başarısız olur.

Performans

Ön bilgi niteliğindeki bütçe, dokümantasyon amaçlı bir üst sınırdır. Araç, belgeleri sunucu tarafında işler ve her belge önemli miktarda çalışma belleği kullanabilir. Genel bir zaman aşımını artırmak yerine toplu işlemi ana makinenin belleğine göre boyutlandırın.

Güvenlik notları

Kaynak yollarını veya raporun tamamını dışarıya aktarılan bir günlük düzeyinde kaydetmeyin. Yalnızca toplu işlem kimliğini ve toplam pass/fail sayılarını günlüğe kaydedin. Her politika için “geçti” sonucu, bir güvenlik veya yasal garanti değil, uygulanan kural kümesini tanımlar.

Uygunluk

İddia	Madde	reference_id
Standart gereksinimleri belirtir; denetleyici her belgeyi değerlendirir	PDF/A-4 §6.2.3
Uygunluk, üretici tarafından beyan edilmez; gereksinimlere göre belirlenir	PDF/A-4 §6.7.3
B-LT/B-LTA doğrulama materyali ekler; ayrı ve yalnızca Enterprise düzeyleridir	ETSI EN 319 142-2 §5.5

Toplu standart denetimi desteği bir uygunluk sertifikası değildir. Uygunluk kararını her belge için bağımsız bir doğrulayıcı verir.

Ticari bağlam

Toplu uyumluluk aracı Enterprise katmanındadır ve yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydedilir.

Connect ayrıntıları

Taşıma katmanı kullanılabilirliği (MCP / REST / gRPC)

Aracı, paylaşılan araç yürütücüsü aracılığıyla Model Context Protocol (MCP) tools/call, REST araç uç noktası veya gRPC hizmeti üzerinden aynı şekilde çağırın.

HITL risk katmanı

Toplu denetim salt okunurdur ve varsayılan olarak approval_required değildir. Operatörün geçersiz kılması yalnızca risk düzeyini yükseltebilir. Ayrıntılar için bkz. /connect/hitl-risk-tiers/.

Onay kapısı JSON zarfı

Operatörün geçersiz kılması düzeyi approval_required seviyesine yükseltmediği sürece araç kapıyı tetiklemez. Zarf ve tek kullanımlık jeton sözleşmesi şurada bulunur: /connect/hitl-risk-tiers/.

Ayrıca bkz.

/cookbook/connect/compliance-check/ — tek belge standart denetimi.
/cookbook/connect/ai-ready-certification/ — daha kapsamlı yapay zekâ hazırlık denetimi.
/connect/tool-catalog/ — katman başına araç kümesi hesabı.
/connect/hitl-risk-tiers/ — risk modeli ve kapı davranışı.