Sprawdzanie dostępności strukturalnej w NextPDF Connect (Pro)

W skrócie

Uruchom analizę dostępności strukturalnej w NextPDF Connect. Użyj narzędzia check_accessibility, sprawdzanego względem dostawcy narzędzi Pro, który rejestruje new CheckAccessibilityTool() pod nazwą protokołu check_accessibility. Opis narzędzia określa jego zakres: analizuje dostępność strukturalną pliku PDF — nagłówki, tabele, obrazy oraz wskaźniki kolejności odczytu. Zwraca wskaźniki i wskazówki naprawcze. Nie poświadcza zgodności z Portable Document Format/Universal Accessibility (PDF/UA) ani z Web Content Accessibility Guidelines (WCAG). Takiego ustalenia dokonuje walidator zgodności, taki jak veraPDF lub narzędzie testowe PDF/UA. check_accessibility to narzędzie w warstwie Pro. NextPDF sprawdza jego dostępność za pomocą class_exists() podczas uruchamiania i rejestruje je tylko wtedy, gdy pakiet Pro jest zainstalowany.

Instalacja

composer require nextpdf/server
composer require nextpdf/pro

Powiąż transport, a następnie potwierdź dostępność narzędzia za pomocą diagnostic.capabilities.

Przegląd koncepcyjny

Dostępność strukturalna zależy od dwóch rzeczy: logicznego drzewa struktury złożonego z elementów struktury (ISO 32000-2 §14.7) oraz zadeklarowanego języka dokumentu, ustawionego przez wpis Lang w katalogu (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility bada te wskaźniki strukturalne i zwraca ustalenia wraz z ważnością oraz wskazówkami naprawczymi. Każdy wynik liczbowy lub wartość pass/fail w raporcie traktuj jako podsumowanie wskaźników, a nie poświadczenie. Używaj raportu do wstępnej selekcji.

Powierzchnia API

Narzędzie	Warstwa	Rola	Poziom ryzyka
`create_pdf`, `add_text`	Core	Tworzenie treści do zbadania	Bezpieczne / Ostrożność
`check_accessibility`	Pro	Analiza dostępności strukturalnej	Bezpieczne
`output_pdf`	Core	Renderowanie i zwracanie pliku PDF	Wymagana zgoda / Przegląd (base64)

Nazwy narzędzi są nazwami protokołów z rejestru. Wiążącym katalogiem jest katalog narzędzi. Zainstalowana warstwa decyduje, które narzędzia są dostępne.

Przykład kodu — szybki start

create_pdf → dodaj treść za pomocą add_text.
check_accessibility z użyciem document_id.
Przejrzyj ustalenia: ważność, wskaźnik, stronę, której dotyczy ustalenie, oraz wskazówkę naprawczą.
Opcjonalnie output_pdf (base64) do ręcznego przeglądu wraz z raportem.

Przykład kodu — produkcja

Traktuj raport jako materiał do wstępnej selekcji, a nie jako werdykt. Przypisz każde ustalenie do konkretnej poprawki: włącz wyjście otagowane, ustaw język dokumentu oraz dodaj strukturę nagłówków. W bramce zgodności uruchom zewnętrzny walidator. Za miarodajny uznaj jego werdykt, a nie wynik tego narzędzia. Uruchom sprawdzenie przed output_pdf z destroy: true; w przeciwnym razie sprawdzenie nie zobaczy dokumentu.

Przypadki brzegowe i pułapki

Brak treści. Pusty dokument zwraca ustalenie o braku treści, a nie poświadczenie zgodności.
Duży dokument. Limit czasu ogranicza analizę; podziel duże dane wejściowe albo ogranicz ich zakres.
Zniszczona sesja. Uruchom sprawdzenie, zanim wygenerowanie wyjścia zniszczy sesję.
Zaszyfrowane źródło. Podaj hasło.
Brak pakietu Pro. Z samym Core check_accessibility nie jest rejestrowane.

Wydajność

Limit czasu w budżecie ogranicza analizę. Profil ma wartość semantic: raport jest wynikiem analizy strukturalnej, więc porównuj ustalenia, a nie wyjście bajtowe.

Uwagi dotyczące bezpieczeństwa

Raport opisuje strukturę, a nie poufne dane zawarte w treści. Analizowany dokument może mimo to zawierać wrażliwe informacje, więc przechowuj go w granicach własnego obszaru zaufania. Ścieżka analizy nie zapisuje danych w systemie plików.

Zgodność

Stwierdzenie	Specyfikacja	Klauzula
Struktura logiczna to drzewo elementów struktury.	ISO 32000-2	§14.7
Język dokumentu jest deklarowany za pomocą wpisu `Lang`.	ISO 32000-2	§14.9
Język naturalny musi być określony podczas tworzenia dostępnych treści.	PDF/UA-2	§8.4.4

check_accessibility zgłasza wskaźniki strukturalne, które wspierają tworzenie dostępnych treści. Nie potwierdza zgodności z PDF/UA ani z WCAG. O tym decyduje niezależny walidator.

Kontekst komercyjny

check_accessibility to narzędzie w warstwie Pro. NextPDF rejestruje je tylko wtedy, gdy pakiet Pro da się rozwiązać podczas uruchamiania serwera.

Mapowanie PDF/UA-2

Wskaźniki strukturalne badane przez to narzędzie odpowiadają wymaganiom dotyczącym tworzenia treści PDF/UA-2: otagowanemu drzewu struktury (ISO 32000-2 §14.7) oraz zadeklarowanemu językowi dokumentu (PDF/UA-2 §8.4.4). Narzędzie zgłasza, czy te wskaźniki są obecne, czy nieobecne. Zgodność z PDF/UA-2 ustala walidator PDF/UA, a nie raport narzędzia.

Odsyłacz tag → ISO 32000-2 §14

Ustalenia dotyczące nagłówków i tabel odpowiadają elementom struktury logicznej w drzewie struktury ISO 32000-2 §14.7. Ustalenie dotyczące języka odpowiada wpisowi Lang z §14.9. Narzędzie zgłasza, czy te punkty odniesienia struktury są obecne. Nie waliduje każdej reguły tagów z §14; to zadanie walidatora.

Mapowanie WCAG 2.2

Ustalenia dotyczące kontrastu i kolejności odczytu odnoszą się do kryteriów sukcesu WCAG, takich jak kontrast i sensowna kolejność. Narzędzie zgłasza wartości wskaźników, takie jak zmierzony współczynnik kontrastu. Twierdzenie o zgodności z WCAG wymaga pełnej oceny WCAG, której to narzędzie nie wykonuje ani nie potwierdza.

Dostępność transportu

Transport	Dostępny	Uwagi
MCP (stdio)	Tak (Pro)	Raport jest wynikiem narzędzia.
REST	Tak (Pro)	Raport jest treścią odpowiedzi.
gRPC	Tak (Pro)	Unarne; raport w komunikacie odpowiedzi.

Poziom ryzyka HITL

check_accessibility ma poziom Bezpieczne (analiza tylko do odczytu) i nigdy nie uruchamia bramki. output_pdf do pliku to Wymagana zgoda, a tryb base64 to Przegląd (poziomy ryzyka HITL).

Koperta JSON bramki potwierdzenia

Analiza nigdy nie uruchamia bramki:

{ "allowed": true }