เลือกโหมดความสอดคล้อง

ขอบเขต การตั้งค่าโหมดความสอดคล้องจะเชื่อมต่อ 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

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

ข้อกล่าวอ้าง	ข้อกำหนด
ตัวมาร์กความสอดคล้องประกาศความสอดคล้องที่มุ่งหมาย โดย 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/ — โมเดลความเสี่ยงและเกต