เลือกโหมดความสอดคล้องผ่าน Connect

ขอบเขต การตั้งค่าโหมดความสอดคล้องจะเชื่อมต่อ catalog และ metadata ตามที่มาตรฐานที่เกี่ยวข้องกำหนดไว้ โหมดนี้ทำให้เอนจินสร้างเอาต์พุต ที่ มุ่งให้สอดคล้อง กับมาตรฐานนั้น แต่ ไม่ได้ ทำให้ เอกสาร “สอดคล้อง” Validator เช่น veraPDF เป็นผู้ตัดสิน ความสอดคล้อง ให้อ่านทุกข้อความที่กล่าวถึง “ความสอดคล้อง” ในหน้านี้ว่า “มุ่งให้สอดคล้อง โดย validator เป็นผู้กำหนดผลลัพธ์”

ภาพรวมโดยสังเขป

เอกสารหนึ่งฉบับมีตัวระบุความสอดคล้องได้เพียงหนึ่งค่าเท่านั้น ได้แก่ แบบธรรมดา โหมด tagged/PDF-UA หรือโหมด PDF/A ตัวระบุดังกล่าวจะบอก writer ว่าต้องสร้างการเชื่อมต่อ catalog โครงสร้าง และ metadata แบบใด ใช้สูตรนี้เพื่อตั้งค่าตัวระบุผ่านทรานสปอร์ตของ Connect ตัวตั้งค่าโหมด tagged เป็นความสามารถระดับ core ตัวตั้งค่าโหมด PDF/A-4 อยู่ในระดับ Premium อย่างถาวร (ADR-011) และจะลงทะเบียนก็ต่อเมื่อติดตั้ง nextpdf/premium ควบคู่ไปกับเซิร์ฟเวอร์เท่านั้น

หากคุณเรียกตัวตั้งค่าทั้งสอง สแตกฟีเจอร์ทั้งสองจะวางซ้อนกัน ตัวระบุที่มีค่าเดียวยังคงยุบตามกฎ last-wins และเอนจินจะส่งคำเตือน clobber เพื่อให้เครื่องมือตรวจพบการเขียนทับ

การติดตั้ง

composer require nextpdf/server

ยืนยันว่ามีตัวตั้งค่าโหมด PDF/A ด้วยการเรียก tools/list ดู /connect/tool-catalog/

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

ตัวมาร์กความสอดคล้องประกาศความสอดคล้องที่ มุ่งหมาย ไว้ Validator เป็นผู้กำหนดความสอดคล้องที่แท้จริง (PDF/A-4 §6.7.3) ความสอดคล้องกำหนดจากการเทียบกับข้อกำหนดของมาตรฐาน ไม่ใช่การยืนยันโดยซอฟต์แวร์ที่สร้างเอกสาร (PDF/A-4 §6.7.3) โหมด tagged จะเชื่อมต่อ structure tree และรายการ mark-info ใน catalog (ISO 32000-2 §14.7)

การสลับโหมดเป็นการดำเนินการ เชื่อมต่อ ซึ่งเตรียมเอกสารให้พร้อมสำหรับการตรวจสอบเทียบกับมาตรฐาน แต่ตัวการดำเนินการเองไม่ใช่ผลความสอดคล้อง

พื้นผิว API

ชื่อเครื่องมือจะถูกตรวจสอบเทียบกับ registry ที่กำลังทำงานผ่าน tools/list Catalog อ้างอิงคือ /connect/tool-catalog/ สูตรนี้ไม่ได้ระบุจำนวนเครื่องมือซ้ำ ให้เลือกตัวระบุก่อนการเรียกเนื้อหาครั้งแรก Writer จะตรึงโหมดไว้เมื่อสร้างหน้าแรก

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

สร้างเอกสาร แล้วสลับเอกสารไปเป็นโหมด tagged/PDF-UA:

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

การตอบกลับจะรายงานเพรดิเคตของโหมดที่ใช้งานอยู่ (tagged / accessibility / archival) ซึ่ง writer ตรวจสอบ ณ ทุกจุดที่สร้างเอาต์พุต และรายงานการเชื่อมต่อ catalog ที่เพิ่มเข้ามาด้วย เพรดิเคตแสดงสิ่งที่ writer จะสร้างออกมา แต่ไม่ได้ยืนยันว่าผลลัพธ์สอดคล้อง

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

สลับไปเป็น PDF/A-4 (ระดับ Premium) แล้วเรียกใช้การตรวจสอบ ให้ถือว่าสถานะที่ไม่ใช่สำเร็จเป็นผลลัพธ์ปกติที่ต้องตรวจสอบ:

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

หากคุณเรียกตัวตั้งค่าทั้งสอง ตัวระบุจะยุบตามกฎ last-wins และเอนจินจะส่งคำเตือน clobber ให้เรียกใช้การตรวจสอบมาตรฐานสำหรับ flavour ทุกตัว ที่สแตกฟีเจอร์ยังคงเชื่อมต่ออยู่ เพราะการเชื่อมต่อเป็นแบบเพิ่มสะสม แม้ว่าตัวระบุค่าเดียวจะไม่เป็นเช่นนั้น

กรณีขอบและข้อควรระวัง

การตั้งค่าโหมดหลังจากหน้าแรก จะถูกปฏิเสธพร้อมข้อผิดพลาด frozen-mode ตั้งค่าโหมดทันทีหลังจากสร้างเอกสาร
ตัวตั้งค่า PDF/A โดยไม่มี Premium จะล้มเหลว — เนื่องจากอยู่ในระดับ Premium อย่างถาวร (ADR-011) เอกสาร PDF 2.0 แบบธรรมดาไม่จำเป็นต้องใช้โหมด PDF/A
กรณี enum ที่ไม่รู้จัก จะถูกปฏิเสธ กรณี archival ที่รองรับคือ PDF/A-4 (โปรไฟล์ PDF/A รุ่นเก่าถูกยกเลิกแล้ว)
การดำเนินการที่ถูกห้ามโดยโหมด archival (ตัวอย่างเช่น JavaScript ที่ฝังอยู่) จะถูกปฏิเสธในขณะที่เพรดิเคต archival ทำงานอยู่
ความไม่ตรงกันของ flavour/mode ในการตรวจสอบ จะคืนผลการตรวจพบว่ามาร์กไม่สอดคล้อง ส่ง flavour ที่ตรงกับโหมดที่ใช้งานอยู่ หรือส่งทั้งสองเมื่อเชื่อมต่อสแตกทั้งสองแล้ว

ประสิทธิภาพ

งบประมาณใน frontmatter เป็นเพดานระดับเอกสาร การเชื่อมต่อโหมดไม่ได้เพิ่มเฟสแยกต่างหากที่วัดได้

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

ไม่มีข้อกำหนดเพิ่มเติมนอกเหนือจากคำแนะนำทั่วไปเกี่ยวกับทรานสปอร์ตของ Connect

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

ข้อกล่าวอ้าง	ข้อกำหนด	รหัสอ้างอิง (reference_id)
ตัวมาร์กความสอดคล้องประกาศความสอดคล้องที่มุ่งหมาย โดย validator เป็นผู้ตัดสิน	PDF/A-4 §6.7.3
ความสอดคล้องกำหนดจากการเทียบกับข้อกำหนด ไม่ใช่การยืนยันโดยผู้ผลิต	PDF/A-4 §6.7.3
โหมด tagged เชื่อมต่อ structure tree และรายการ mark-info	ISO 32000-2 §14.7

การเลือกโหมดความสอดคล้องทำให้เอนจินสร้างเอาต์พุตที่ มุ่งให้สอดคล้อง การเลือกโหมดนี้ไม่ใช่การรับรองความสอดคล้อง Validator เป็นผู้กำหนดผลลัพธ์

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

ตัวตั้งค่าโหมด PDF/A-4 อยู่ในระดับ Premium อย่างถาวร (ADR-011) และจะลงทะเบียนก็ต่อเมื่อติดตั้ง nextpdf/premium ควบคู่ไปกับเซิร์ฟเวอร์เท่านั้น ตัวตั้งค่าโหมด tagged เป็นความสามารถระดับ core

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

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

ตัวตั้งค่าโหมดและการตรวจสอบถูกเรียกใช้ในรูปแบบเดียวกันผ่าน MCP tools/call เอนด์พอยต์เครื่องมือ REST และบริการ gRPC โดยใช้ tool executor ร่วมกัน

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

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

JSON envelope ของเกตยืนยัน

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

ดูเพิ่มเติม

/cookbook/connect/compliance-check/ — ตรวจสอบเทียบกับมาตรฐานที่ใช้งานอยู่
/cookbook/connect/tagged-pdf-tutorial/ — คู่มือทีละขั้นตอนแบบครบวงจรสำหรับ tagged-PDF
/connect/tool-catalog/ — การคำนวณชุดเครื่องมือต่อระดับ
/connect/hitl-risk-tiers/ — โมเดลความเสี่ยงและเกต