Wybór trybu zgodności w Connect

Wybór trybu zgodności przez Connect

Granica. Ustawienie trybu zgodności okabluje katalog i metadane wymagane przez odpowiedni standard. Dzięki temu silnik produkuje dane wyjściowe przeznaczone do zgodności z tym standardem. Nie sprawia, że dokument staje się „zgodny”. O zgodności decyduje walidator, taki jak veraPDF. Każde zdanie o „zgodności” na tej stronie należy czytać jako „przeznaczone do zgodności; o wyniku decyduje walidator”.

W skrócie

Dokument zawiera dokładnie jeden dyskryminator zgodności: tryb zwykły, tagged/PDF-UA albo PDF/A. Ten dyskryminator wskazuje modułowi zapisu, jakie okablowanie katalogu, struktury i metadanych ma wyemitować. Użyj tego przepisu, aby ustawić dyskryminator przez transporty Connect. Setter trybu tagged jest dostępny w edycji core. Setter trybu PDF/A-4 jest trwale w warstwie Premium (ADR-011) i rejestruje się tylko wtedy, gdy wraz z serwerem zainstalowano nextpdf/premium.

Jeśli wywołasz oba settery, oba stosy funkcji zostają nałożone. Jednowartościowy dyskryminator nadal sprowadza się do reguły „wygrywa ostatni”, a silnik emituje ostrzeżenie o nadpisaniu, aby narzędzia mogły to nadpisanie zaobserwować.

Instalacja

composer require nextpdf/server

Sprawdź obecność settera trybu PDF/A wywołaniem tools/list. Zobacz /connect/tool-catalog/.

Przegląd koncepcyjny

Znacznik zgodności deklaruje zgodność zamierzoną. Rzeczywistą zgodność ustala walidator (PDF/A-4 §6.7.3). Zgodność ustala się względem wymagań standardu, a nie potwierdza jej oprogramowanie generujące (PDF/A-4 §6.7.3). Tryb tagged okabluje drzewo struktury oraz wpisy mark-info w katalogu (ISO 32000-2 §14.7).

Przełączenie trybu to operacja okablowania. Przygotowuje dokument do sprawdzenia względem standardu. Samo w sobie nie jest wynikiem zgodności.

Powierzchnia API

Nazwy narzędzi są weryfikowane względem aktywnego rejestru za pomocą tools/list. Katalogiem referencyjnym jest /connect/tool-catalog/. Ten przepis nie powtarza liczby narzędzi. Wybierz dyskryminator przed pierwszym wywołaniem dotyczącym treści. Moduł zapisu zamraża tryb przy emisji pierwszej strony.

Przykład kodu — szybki start

Utwórz dokument, a następnie przełącz go w tryb tagged/PDF-UA:

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

Odpowiedź raportuje aktywne predykaty trybu (tagged / dostępność / archiwizacja), które moduł zapisu sprawdza w każdym punkcie emisji. Raportuje też dodane okablowanie katalogu. Predykaty pokazują, co moduł zapisu wyemituje; nie potwierdzają zgodności wyniku.

Przykład kodu — produkcja

Przełącz na PDF/A-4 (warstwa Premium), a następnie uruchom sprawdzenie. Status różny od powodzenia potraktuj jako normalny wynik wymagający sprawdzenia:

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

Jeśli wywołasz oba settery, dyskryminator zostaje rozstrzygnięty zgodnie z regułą „wygrywa ostatni”, a silnik emituje ostrzeżenie o nadpisaniu. Uruchom sprawdzenie standardów dla każdego wariantu, którego stos funkcji pozostaje okablowany, ponieważ okablowanie jest addytywne, mimo że pojedynczy dyskryminator nie jest addytywny.

Przypadki brzegowe i pułapki

• Ustawienie trybu po pierwszej stronie jest odrzucane z błędem zamrożonego trybu. Ustaw tryb bezpośrednio po utworzeniu dokumentu.
• Setter PDF/A bez Premium kończy się niepowodzeniem — należy on trwale do warstwy Premium (ADR-011). Zwykły dokument PDF 2.0 nie potrzebuje trybu PDF/A.
• Nieznany przypadek wyliczenia jest odrzucany. Obsługiwany przypadek archiwizacji to PDF/A-4 (starsze profile PDF/A zostały wycofane).
• Operacja zabroniona przez tryb archiwizacji (na przykład osadzony JavaScript) jest odrzucana, dopóki predykat archiwizacji jest aktywny.
• Niezgodność wariantu/trybu przy sprawdzeniu zwraca ustalenie wskazujące niezgodny znacznik. Przekaż wariant pasujący do aktywnego trybu albo oba, gdy oba stosy są okablowane.

Wydajność

Budżet określony we frontmatter to limit dokumentacyjny. Okablowanie trybu nie dodaje mierzalnej, osobnej fazy.

Uwagi dotyczące bezpieczeństwa

Nie dotyczy poza ogólnymi wskazówkami dla transportu Connect.

Zgodność

Twierdzenie	Klauzula	reference_id
Znacznik zgodności deklaruje zgodność zamierzoną; decyduje walidator	PDF/A-4 §6.7.3
Zgodność jest ustalana względem wymagań, a nie potwierdzana przez producenta	PDF/A-4 §6.7.3
Tryb tagged okabluje drzewo struktury i wpisy mark-info	ISO 32000-2 §14.7

Wybór trybu zgodności sprawia, że silnik produkuje dane wyjściowe przeznaczone do zgodności. Nie jest to certyfikacja zgodności. O wyniku decyduje walidator.

Kontekst komercyjny

Setter trybu PDF/A-4 jest trwale w warstwie Premium (ADR-011) i rejestruje się tylko wtedy, gdy wraz z serwerem zainstalowano nextpdf/premium. Setter trybu tagged jest funkcją edycji core.

Szczegóły Connect

Dostępność transportu (MCP / REST / gRPC)

Settery trybu oraz sprawdzenie są wywoływane identycznie przez MCP tools/call, punkt końcowy narzędzia REST oraz usługę gRPC za pośrednictwem współdzielonego egzekutora narzędzi.

Poziom ryzyka HITL

Settery trybu mają poziom ostrożności. Sprawdzenie jest tylko do odczytu. Domyślnie żadne z nich nie jest approval_required. Nadpisanie przez operatora może jedynie podnieść ryzyko. Zobacz /connect/hitl-risk-tiers/.

Koperta JSON bramki potwierdzenia

Te narzędzia nie wyzwalają bramki, chyba że nadpisanie przez operatora podniesie któreś z nich do approval_required. Koperta oraz kontrakt jednorazowego tokenu znajdują się w /connect/hitl-risk-tiers/.

Zobacz także

• /cookbook/connect/compliance-check/ — walidacja względem aktywnego standardu.
• /cookbook/connect/tagged-pdf-tutorial/ — pełny przewodnik tagged-PDF.
• /connect/tool-catalog/ — obliczanie zestawu narzędzi dla danej warstwy.
• /connect/hitl-risk-tiers/ — model ryzyka i bramka.