การตรวจสอบการปฏิบัติตามข้อกำหนดแบบกลุ่มผ่าน Connect

ภาพรวมโดยสรุป

ใช้สูตรนี้เพื่อตรวจสอบ PDF จำนวนมากเทียบกับนโยบายที่ระบุชื่อไว้ตั้งแต่หนึ่งรายการขึ้นไปในการเรียกครั้งเดียว สูตรนี้เรียกเครื่องมือตรวจสอบการปฏิบัติตามข้อกำหนดแบบกลุ่มผ่านทรานสปอร์ตของ Connect เครื่องมือนี้เป็น ระดับ Enterprise: การตรวจสอบด้วย class_exists() จะพบเครื่องมือนี้ และจะลงทะเบียนเฉพาะเมื่อมีการติดตั้ง nextpdf/premium ควบคู่กับเซิร์ฟเวอร์ เครื่องมือนี้ตรวจสอบแต่ละเอกสารเทียบกับทุกนโยบายในคำขอ แล้วส่งคืนรายงานรวมที่แยกตามเอกสารและนโยบาย

เช่นเดียวกับการตรวจสอบเอกสารเดียว ผลลัพธ์ “pass” รายนโยบายหมายความเพียงว่าเครื่องมือได้ตรวจสอบกฎที่รองรับเท่านั้น ผลลัพธ์นี้ไม่ใช่การรับรองความสอดคล้องโดยอิสระ ตัวตรวจสอบความถูกต้องเป็นผู้พิจารณาความสอดคล้อง

การติดตั้ง

composer require nextpdf/server

ตรวจสอบว่าเครื่องมือแบบกลุ่มระดับ Enterprise มีอยู่ด้วยการเรียก tools/list ดู /connect/tool-catalog/

ภาพรวมเชิงแนวคิด

มาตรฐานกำหนดข้อกำหนดสำหรับเอกสารแต่ละฉบับ และตัวตรวจสอบจะประเมินเอกสารแต่ละฉบับเทียบกับข้อกำหนดเหล่านั้น (PDF/A-4 §6.2.3) ความสอดคล้องถูกพิจารณาเทียบกับข้อกำหนด ไม่ใช่จากคำยืนยันของผู้ผลิต (PDF/A-4 §6.7.3) สำหรับนโยบายที่เกี่ยวกับลายเซ็น ระดับพื้นฐานของ PDF Advanced Electronic Signatures (PAdES) แตกต่างกัน และระดับ B-LT/B-LTA (validation material, archive time-stamp) เป็นความสามารถเฉพาะระดับ Enterprise เท่านั้น (ETSI EN 319 142-2 §5.5) ผลลัพธ์แบบกลุ่มใช้ความหมายแคบแบบเดียวกันกับทั้งชุดเอกสาร คือ “ไม่มีกฎที่รองรับล้มเหลว”

ขอบเขตของ API

ตรวจสอบชื่อเครื่องมือเทียบกับรีจิสทรีที่กำลังทำงานด้วย tools/list แคตตาล็อกอ้างอิงคือ /connect/tool-catalog/ สูตรนี้ไม่ทำซ้ำรายละเอียดจำนวนเครื่องมือ

ตัวอย่างโค้ด — เริ่มต้นใช้งานอย่างรวดเร็ว

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

ตัวอย่างโค้ด — การใช้งานจริง

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; }

การตอบกลับประกอบด้วย batch id จำนวนรวมของ pass/fail และอาร์เรย์ checks แบบรายเอกสาร ซึ่งมีผลลัพธ์รายนโยบายและเหตุผลของการล้มเหลว ให้กรองรายการที่ล้มเหลว แก้ไขรายการเหล่านั้น แล้วส่งใหม่เฉพาะเอกสารที่ได้รับผลกระทบ

กรณีพิเศษและข้อควรระวัง

sources หรือ policies ที่ว่างเปล่า จะส่งคืนข้อผิดพลาดพารามิเตอร์ไม่ถูกต้อง
ไฟล์ที่หายไป จะปรากฏเป็นข้อผิดพลาดรายผลลัพธ์ แทนที่จะทำให้ทั้งกลุ่มล้มเหลว ให้ตรวจสอบฟิลด์ error ในแต่ละผลลัพธ์
การเกินขีดจำกัดขนาดของกลุ่ม จะส่งคืนข้อผิดพลาดอย่างชัดเจน ให้แบ่งงานออกเป็นกลุ่มที่เล็กลง
id ของนโยบายที่ไม่รู้จัก เป็นข้อผิดพลาดมาตรฐานที่ไม่รู้จักซึ่งระบุชื่อตัวระบุที่รู้จักได้ นโยบายลายเซ็นที่อ้างอิงถึง B-LT/B-LTA มีความหมายเฉพาะในการติดตั้งใช้งานระดับ Enterprise ที่สามารถสร้างวัสดุดังกล่าวได้
ไม่มีเครื่องมือ หากไม่มี nextpdf/premium เครื่องมือแบบกลุ่มระดับ Enterprise จะไม่ถูกลงทะเบียน การเรียกจะล้มเหลวพร้อมข้อผิดพลาดเครื่องมือที่ไม่รู้จัก

ประสิทธิภาพ

งบประมาณใน front-matter เป็นเพดานที่ระบุไว้เพื่อการจัดทำเอกสาร เครื่องมือนี้ประมวลผลเอกสารฝั่งเซิร์ฟเวอร์ และเอกสารแต่ละฉบับอาจใช้หน่วยความจำในการทำงานในระดับที่มีนัยสำคัญ ให้กำหนดขนาดของกลุ่มให้เหมาะกับหน่วยความจำของโฮสต์แทนการเพิ่มค่า timeout แบบรวม

หมายเหตุด้านความปลอดภัย

อย่าบันทึกพาธของแหล่งที่มาหรือรายงานฉบับเต็มในระดับ log ที่ส่งออกภายนอก ให้บันทึกเฉพาะ batch id และจำนวนรวมของ pass/fail เท่านั้น ผลลัพธ์ “pass” รายนโยบายอธิบายชุดกฎที่รองรับ ไม่ใช่การรับประกันด้านความปลอดภัยหรือทางกฎหมาย

ความสอดคล้อง

ข้อกล่าวอ้าง	ข้อกำหนด	รหัสอ้างอิง (reference_id)
มาตรฐานระบุข้อกำหนด และตัวตรวจสอบประเมินเอกสารแต่ละฉบับ	PDF/A-4 §6.2.3
ความสอดคล้องถูกพิจารณาเทียบกับข้อกำหนด ไม่ใช่จากคำยืนยันของผู้ผลิต	PDF/A-4 §6.7.3
B-LT/B-LTA เพิ่ม validation material เป็นระดับที่แตกต่างกันและเฉพาะระดับ Enterprise เท่านั้น	ETSI EN 319 142-2 §5.5

การรองรับการตรวจสอบการปฏิบัติตามข้อกำหนดแบบกลุ่มไม่ใช่การรับรองความสอดคล้อง ตัวตรวจสอบความถูกต้องอิสระเป็นผู้พิจารณาความสอดคล้องแบบรายเอกสาร

บริบทเชิงพาณิชย์

เครื่องมือตรวจสอบการปฏิบัติตามข้อกำหนดแบบกลุ่มอยู่ในระดับ Enterprise และจะลงทะเบียนเฉพาะเมื่อมีการติดตั้ง nextpdf/premium ควบคู่กับเซิร์ฟเวอร์

รายละเอียดเฉพาะของ Connect

ความพร้อมใช้งานของทรานสปอร์ต (MCP / REST / gRPC)

เรียกใช้เครื่องมือด้วยวิธีเดียวกันผ่าน Model Context Protocol (MCP) tools/call เอนด์พอยต์เครื่องมือ REST และบริการ gRPC โดยใช้ตัวดำเนินการเครื่องมือที่ใช้ร่วมกัน

ระดับความเสี่ยง HITL

การตรวจสอบแบบกลุ่มเป็นแบบอ่านอย่างเดียวและไม่ใช่ approval_required โดยค่าเริ่มต้น การลบล้างค่าโดยผู้ดำเนินการสามารถยกระดับความเสี่ยงให้สูงขึ้นได้เท่านั้น ดู /connect/hitl-risk-tiers/ สำหรับรายละเอียด

ซองข้อมูล JSON ของ confirmation gate

เครื่องมือนี้จะไม่เรียกใช้ gate เว้นแต่การลบล้างค่าโดยผู้ดำเนินการจะยกระดับเป็น approval_required รายละเอียดซองข้อมูลและสัญญา single-use token อยู่ใน /connect/hitl-risk-tiers/

ดูเพิ่มเติม

/cookbook/connect/compliance-check/ — การตรวจสอบมาตรฐานเอกสารเดียว
/cookbook/connect/ai-ready-certification/ — การตรวจสอบความพร้อมด้าน AI ในวงกว้างขึ้น
/connect/tool-catalog/ — การคำนวณชุดเครื่องมือรายระดับ
/connect/hitl-risk-tiers/ — โมเดลความเสี่ยงและพฤติกรรมของ gate