Elektroniczne składanie dokumentów

W skrócie

NextPDF Enterprise optymalizuje plik PDF do postaci artefaktu dostarczanego, odpowiedniego do składania w e-sądzie / urzędach państwowych zgodnie z konfiguracją profilu jurysdykcji, i dzieli go na segmenty ograniczone rozmiarem, gdy zostanie przekroczony limit rozmiaru profilu. Przygotowuje formaty do składania zgodnie z konfiguracją; nie gwarantuje, że jakikolwiek dokument zostanie przyjęty przez sąd lub rejestr.

Dostępność i licencjonowanie

Ta funkcja jest dostarczana w NextPDF Enterprise (nextpdf/enterprise) i aktywuje się przy kopercie licencyjnej poziomu Enterprise. Wdrożenie bez tego uprawnienia nie ładuje klas tej funkcji. Porównaj edycje i uzyskaj licencję.

Instalacja

composer require nextpdf/enterprise:^3

Przegląd koncepcyjny

EFilingOptimizer uruchamia względem wejściowego pliku PDF potok o ustalonej kolejności:

1. Sanityzacja. Aktywna treść (JavaScript oraz akcje) jest usuwana przez silnik rozbrojenia i rekonstrukcji treści (content-disarm-and-reconstruction).
2. Linearyzacja. Dokument jest linearyzowany na potrzeby szybkiego podglądu w sieci.
3. Sprawdzenie rozmiaru i podział. Jeśli wynik przekracza limit rozmiaru profilu, SizeAwareSplitter dzieli go na segmenty, z których każdy się mieści, używając wyszukiwania binarnego po liczbie stron do wyboru punktów podziału.

Profil jurysdykcji (EFilingProfile) niesie ograniczenia: maksymalny rozmiar pliku na segment, jakość rekompresji JPEG, spłaszczanie formularzy, usuwanie kodu JavaScript, linearyzację oraz kompresję strumieni obiektów. Wbudowane profile obejmują US PACER (limit 25 MiB), EU e-Justice (limit 10 MiB) oraz Taiwan Judicial Yuan (limit 10 MiB). Wynik (EFilingResult) raportuje segmenty, pierwotny i zoptymalizowany rozmiar, zastosowane optymalizacje oraz ewentualne ostrzeżenia.

Wynik składania elektronicznego to artefakt dostarczany, a nie stan cyklu życia dokumentu. Zoptymalizowany lub podzielony plik PDF jest ostateczny na potrzeby transmisji i nie może ponownie wejść do potoku podpisywania ani archiwizacji, ponieważ ponowne przetworzenie zerwałoby łańcuchy skrótów oraz integralność dowodową.

Co ten moduł deklaruje, a czego nie deklaruje

Ten moduł przygotowuje formaty na potrzeby składania w e-sądzie / urzędach państwowych zgodnie z konfiguracją. Nie gwarantuje przyjęcia przez jakikolwiek sąd, rejestr ani portal składania. Zasady portali, akceptowane formaty, limity rozmiaru oraz wymagania proceduralne różnią się w zależności od jurysdykcji i ulegają zmianom w czasie. Wbudowane profile kodują dla wygody powszechnie publikowane ograniczenia; sprawdź je względem aktualnych zasad rejestru docelowego przed złożeniem.

Dlaczego działa to w ten sposób

Potok działa w jednej ustalonej kolejności — sanityzacja, linearyzacja, sprawdzenie rozmiaru — ponieważ każdy etap konsumuje wynik poprzedniego. Rozbrojenie i rekonstrukcja treści działa jako pierwsze, ponieważ wejścia do składania pochodzą od niezaufanych stron i muszą zostać rozbrojone przed przepisaniem. Linearyzacja poprzedza sprawdzenie rozmiaru, ponieważ zmienia układ bajtów, a tym samym rozmiar, który moduł podziału musi respektować. splitByMaxSize() weryfikuje następnie każdy wytworzony segment względem limitu maxFileSizeBytes profilu, zamiast ufać szacunkowi średniej strony. Pojedyncza strona, która nadal przekracza limit, jest niepodzielna, więc pojawia się jako ostrzeżenie, a nie jest odrzucana. Artefakt dostarczany jest wyłączony z ponownego podpisywania i ponownej archiwizacji, ponieważ ponowne przetworzenie złożonych bajtów zerwałoby dowodowe łańcuchy skrótów.

Tło projektowe: Sanityzacja niezaufanych plików PDF: rozbrojenie i rekonstrukcja treści.

Powierzchnia API

Klasa	Odpowiedzialność
EFilingOptimizer	Uruchom potok sanityzacja → linearyzacja → podział według rozmiaru.
EFilingProfile	Profil ograniczeń jurysdykcji (pacer(), euJustice(), taiwan() lub własny).
SizeAwareSplitter	Podziel plik PDF na segmenty poniżej limitu bajtów.
EFilingSegment	Pojedynczy segment wyjściowy: bajty, zakres stron, rozmiar, indeks.
EFilingResult	Agregat: segmenty, rozmiary, optymalizacje, ostrzeżenia.

Przykład kodu — szybki start

use NextPDF\Enterprise\Document\EFiling\EFilingOptimizer;
use NextPDF\Enterprise\Document\EFiling\EFilingProfile;

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::pacer());

Przykład kodu — produkcja

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::euJustice());

foreach ($result->warnings as $warning) {
    $logger->warning('efiling.warning', ['message' => $warning]);
}

foreach ($result->segments as $segment) {
    $store->put("filing/{$segment->segmentIndex}.pdf", $segment->pdfData);
}
// Confirm the destination registry's current rules before submitting.

Przypadki brzegowe i pułapki

• Dokument już poniżej limitu profilu zwraca pojedynczy segment, niezmieniony pod względem rozmiaru.
• Pojedyncza strona przekraczająca limit nie może zostać dalej podzielona; jest zwracana jako jeden segment przekraczający limit wraz z ostrzeżeniem. Zmniejsz jakość obrazu we własnym profilu lub przetwórz stronę wstępnie.
• Jeśli sanityzacja odrzuci wejście, zapisywane jest ostrzeżenie, a pierwotne bajty są zachowywane; sprawdź ostrzeżenia przed złożeniem.
• Limity wbudowanych profili odzwierciedlają powszechnie publikowane wartości, a nie strumień aktualnych danych z każdego portalu. Traktuj je jako wartości domyślne do potwierdzenia.

Wydajność

Koszt skaluje się wraz z rozmiarem dokumentu i liczbą stron. Podział wykonuje wyszukiwanie binarne po liczbie stron, więc liczba prób podziału jest logarytmiczna względem liczby stron. Linearyzacja i rekompresja dominują w czasie zegarowym dla dużych dokumentów bogatych w obrazy.

Uwagi dotyczące bezpieczeństwa

Aktywna treść jest usuwana przed dostarczeniem przez rozbrojenie i rekonstrukcję treści. Traktuj wejściowe pliki PDF od niezaufanych stron jako wrogie; krok sanityzacji jest środkiem ograniczającym, a nie gwarancją bezpieczeństwa dla systemów niżej w potoku.

Rezydencja danych i środki ograniczające dla danych osobowych (PII)

Składane dokumenty często zawierają dane osobowe oraz dane sprawy. Przetwarzanie odbywa się w obrębie procesu, lokalnie; moduł nie wykonuje żadnych wychodzących wywołań sieciowych. Zastosuj własne kontrole retencji do segmentów oraz do oryginału.

Bezpieczna telemetria i czyszczenie logów

Ostrzeżenia i zapisy optymalizacji opisują działania potoku, a nie treść dokumentu. Unikaj logowania ścieżek plików lub identyfikatorów spraw z otaczającego kodu do współdzielonych ujść.

Zgodność ze standardami

Zachowanie	Odniesienie	Status
Semantyka relacji pliku powiązanego	ISO 19005-3:2012 §6.7.8	Honorowane tam, gdzie mają zastosowanie nośniki
Wymagania nośnika pliku osadzonego	ISO 19005-4:2020 Annex A	Honorowane tam, gdzie mają zastosowanie nośniki

Ta tabela rejestruje specyfikacje, względem których zbudowano otaczającą obsługę PDF/A. Nie jest stwierdzeniem przyjęcia przez jakikolwiek sąd lub rejestr.

Zachowanie w trybie FIPS

Ten moduł nie wykonuje żadnych operacji kryptograficznych.

Model zagrożeń

Głównym wejściem są niezaufane wejściowe pliki PDF niosące aktywną treść. Środek ograniczający: rozbrojenie i rekonstrukcja treści przed linearyzacją i dostarczeniem; artefakt dostarczany jest wyłączony z ponownego podpisywania i ponownej archiwizacji, aby chronić integralność dowodową.

Kontrakt zachowania

• EFilingOptimizer uruchamia potok o ustalonej kolejności: rozbrojenie i rekonstrukcja treści, linearyzacja, następnie sprawdzenie rozmiaru z podziałem metodą wyszukiwania binarnego, gdy zostanie przekroczony limit profilu.
• Dokument już poniżej limitu profilu zwraca pojedynczy segment o niezmienionym rozmiarze.
• Pojedyncza strona przekraczająca limit jest zwracana jako jeden segment przekraczający limit wraz z ostrzeżeniem; nie może zostać dalej podzielona.
• Artefakt składania elektronicznego jest ostateczny na potrzeby transmisji i nie może ponownie wejść do potoku podpisywania ani archiwizacji; ponowne przetworzenie zerwałoby łańcuchy skrótów oraz integralność dowodową.

Granica publikacji

Ta strona dokumentuje wyłącznie zachowanie obserwowalne z zewnątrz oraz obsługiwaną publiczną powierzchnię API. Wewnętrzne ścieżki przestrzeni nazw, klasy pomocnicze, tabele mechanizmów, nazwy plików runbooków oraz prefiksy zgłoszeń są poza zakresem.

Rozwiązanie awaryjne w Core

NextPDF Core nie ma optymalizatora składania elektronicznego opartego na profilach jurysdykcji, etapu sanityzacji CDR ani modułu podziału uwzględniającego rozmiar. Wdrożenie wyłącznie z Core musi samodzielnie zbudować dowolny potok przygotowania do składania.

Rozwiązanie awaryjne w Pro

NextPDF Pro nie udostępnia optymalizatora składania elektronicznego opartego na profilach jurysdykcji, wbudowanych profili PACER / EU e-Justice / Taiwan Judicial Yuan, etapu sanityzacji CDR ani modułu podziału uwzględniającego rozmiar. Konfiguracja żądająca optymalizacji składania elektronicznego opartej na profilach we wdrożeniu wyłącznie z Pro nie ma komponentu Enterprise, który by ją spełnił. Powierzchnię Enterprise opisuje przegląd Enterprise.

Uwaga o granicy Enterprise

Wewnętrzne szczegóły mechanizmów pozostają w wewnętrznej dokumentacji repozytorium źródłowego i są poza zakresem tego podręcznika.

Granica wdrożenia

Limity wbudowanych profili kodują dla wygody powszechnie publikowane ograniczenia, a nie strumień aktualnych danych z każdego portalu; potwierdzenie ich względem aktualnych zasad rejestru docelowego przed złożeniem jest obowiązkiem składającego. Przetwarzanie odbywa się w obrębie procesu, lokalnie; moduł nie wykonuje żadnych wychodzących wywołań sieciowych. Transport do sądu, rejestru lub portalu składania jest zewnętrzny względem tego modułu.

Granica zgodności prawnej

NextPDF przygotowuje formaty na potrzeby składania w e-sądzie / urzędach państwowych zgodnie z konfiguracją profilu jurysdykcji. Nie gwarantuje, że dokument zostanie przyjęty przez jakikolwiek sąd, rejestr, trybunał ani portal składania, i nie udziela porad prawnych. Zasady składania, akceptowane formaty, limity rozmiaru, wymagania dotyczące podpisu oraz terminy proceduralne są ustalane przez właściwy organ, różnią się w zależności od jurysdykcji i ulegają zmianom. Weryfikacja i spełnienie tych zasad jest obowiązkiem składającego. Skonsultuj się z doradcą prawnym oraz aktualnymi wytycznymi rejestru docelowego.

Zobacz także

• Dokumentacja Elektronicznego składania dokumentów — pełna publiczna powierzchnia API tego modułu.
• Invoice — generowanie ustrukturyzowanych faktur.
• Przegląd Enterprise
• Macierz funkcji: Core vs Pro vs Enterprise