Pro edycja
Aspekty prawne
W skrócie
Dział zatytułowany „W skrócie”NextPDF Pro stosuje sekwencyjną numerację Batesa do stron dokumentu zgodnie z konfiguracją. Generuje samodzielne fragmenty strumienia zawartości PDF z konfigurowalnym prefiksem, sufiksem, dopełnieniem, pozycją oraz opcjonalną przełączalną warstwą zawartości.
Dostępność i licencjonowanie
Dział zatytułowany „Dostępność i licencjonowanie”Ta funkcja jest dostarczana w NextPDF Pro (nextpdf/pro) i aktywuje się z kopertą licencyjną poziomu Pro. Wdrożenie bez tego uprawnienia nie ładuje klas tej funkcji. Porównaj edycje i uzyskaj licencję.
Instalacja
Dział zatytułowany „Instalacja”composer require nextpdf/pro:^3Przegląd koncepcyjny
Dział zatytułowany „Przegląd koncepcyjny”Numeracja Batesa stempluje sekwencyjny identyfikator na każdej stronie, powszechnie używana do śledzenia stron w procesie produkcji dokumentów. NextPDF Pro zapewnia:
BatesNumberConfig— niezmienialny obiekt wartości konfiguracji. Ustawiasz prefiks (na przykładCASE-2024-), sufiks, numer początkowy, szerokość dopełnienia zerami, rodzinę i rozmiar czcionki, krycie, pozycję, wcięcie od krawędzi oraz to, czy umieścić oznaczenia na opcjonalnej warstwie zawartości.BatesNumberer— silnik. Mając liczbę stron i rozmiary poszczególnych stron, zwraca jeden samodzielny fragment strumienia zawartości na stronę. Każdy fragment niesie własny zapis/odtworzenieq/Q, więc dołącza się do istniejącej zawartości strony bez zaburzania innej grafiki.BatesPosition— enum sześciu predefiniowanych pozycji narożnych, każda z konfigurowalnym wcięciem od krawędzi strony. Enum oblicza współrzędne w natywnej przestrzeni PDF (początek w lewym dolnym rogu).
Opcjonalna warstwa zawartości pozwala przeglądarce włączać lub wyłączać oznaczenia Batesa, co zachowuje leżącą u podstaw zawartość strony niezmodyfikowaną.
NextPDF Pro stosuje numerację Batesa dokładnie tak, jak ją skonfigurujesz. Schemat numeracji, przechowywanie oraz wszelka obsługa dowodowa to Twoja odpowiedzialność i odpowiedzialność Twojego zespołu prawnego. NextPDF Pro nie twierdzi, że ponumerowany dokument jest dopuszczalny w sądzie, prawnie ważny ani wystarczający dla reguł ujawniania (discovery) jakiejkolwiek jurysdykcji. Skonsultuj się z zespołami prawnym i ds. zgodności w sprawie wymagań proceduralnych i dowodowych.
Dlaczego działa to w ten sposób
Dział zatytułowany „Dlaczego działa to w ten sposób”Kluczową decyzją jest to, że BatesNumberer emituje jeden samodzielny fragment strumienia zawartości na stronę, zamiast edytować stronę w miejscu. Każdy fragment owija swoje rysowanie we własny zapis i odtworzenie q/Q, opcjonalnie wewnątrz warstwy oznaczonej zawartości OCG BDC/EMC. Dzięki temu stempel dołącza się do strony bez zaburzania grafiki już tam obecnej, a leżące u podstaw bajty strony pozostają nietknięte. Ta nieniszcząca postawa czyni oznaczenia odwracalnymi: przeglądarka może wyłączyć warstwę i odzyskać oryginalną stronę. Utrzymuje też każdą stronę niezależną. Numeracja pozostaje liniowa względem liczby stron, a stempel jednej strony nie może uszkodzić stempla innej.
Tło projektowe: Aktualizacje przyrostowe i dlaczego mają znaczenie.
Powierzchnia API
Dział zatytułowany „Powierzchnia API”| Klasa | Odpowiedzialność |
|---|---|
BatesNumberConfig | Niezmienialne ustawienia wyglądu, numeracji i pozycji. |
BatesNumberer | Generuj fragmenty strumienia zawartości na stronę. |
BatesPosition | Predefiniowane pozycje narożne z wcięciem od krawędzi. |
Przykład kodu — Szybki start
Dział zatytułowany „Przykład kodu — Szybki start”use NextPDF\Pro\Legal\BatesNumberer;
$streams = BatesNumberer::generate( pageCount: 50, pageSizes: $pageSizes, prefix: 'EX-',);Przykład kodu — Produkcja
Dział zatytułowany „Przykład kodu — Produkcja”use NextPDF\Pro\Legal\BatesNumberConfig;use NextPDF\Pro\Legal\BatesNumberer;use NextPDF\Pro\Legal\BatesPosition;
$config = new BatesNumberConfig( prefix: 'CASE-2024-', suffix: '-CONFIDENTIAL', padding: 6, position: BatesPosition::BottomRight, useLayer: true,);$streams = (new BatesNumberer($config))->generateStreams($pageCount, $pageSizes);Przypadki brzegowe i pułapki
Dział zatytułowany „Przypadki brzegowe i pułapki”- Liczba zwróconych fragmentów odpowiada liczbie stron; niezgodna długość
pageSizeszawodzi szybko. - Skonfigurowana rodzina czcionek musi być dostępna w rejestrze czcionek.
- Krycie i przełączanie warstwy polegają na obsłudze opcjonalnej zawartości w konsumującej przeglądarce.
Wydajność
Dział zatytułowany „Wydajność”Generowanie jest liniowe względem liczby stron. Każdy fragment jest mały i niezależny.
Uwagi dotyczące bezpieczeństwa
Dział zatytułowany „Uwagi dotyczące bezpieczeństwa”Oznaczenia Batesa to zawartość nakładki. Nie redagują, nie szyfrują ani w inny sposób nie zmieniają leżących u podstaw danych strony. Do redakcji lub kontroli dostępu użyj modułu Security.
Konformancja
Dział zatytułowany „Konformancja”| Zachowanie | Odniesienie | Status |
|---|---|---|
| Grupy opcjonalnej zawartości (przełączalna warstwa) | ISO 32000-2 §8.11 | Aligned (paraphrased) |
Ta tabela zapisuje specyfikację, względem której zbudowano NextPDF Pro. Nie jest oświadczeniem o ważności prawnej ani dostateczności dowodowej.
Kontrakt zachowania
Dział zatytułowany „Kontrakt zachowania”BatesNumberConfigto niezmienialny obiekt wartości dla prefiksu, sufiksu, numeru początkowego, szerokości dopełnienia zerami, rodziny i rozmiaru czcionki, krycia, pozycji, wcięcia od krawędzi oraz przełącznika opcjonalnej warstwy zawartości.BatesNumbererzwraca jeden samodzielny fragment strumienia zawartości na stronę, każdy z własnym zapisem/odtworzeniemq/Q, więc dołącza się bez zaburzania innej grafiki strony. Liczba fragmentów odpowiada liczbie stron; niezgodna długośćpageSizeszawodzi szybko.BatesPositionzapewnia sześć predefiniowanych pozycji narożnych obliczanych w natywnej przestrzeni PDF (początek w lewym dolnym rogu) z konfigurowalnym wcięciem od krawędzi.- Oznaczenia Batesa to zawartość nakładki. Nie redagują, nie szyfrują ani nie zmieniają leżących u podstaw danych strony.
- Moduł stosuje numerację Batesa dokładnie zgodnie z konfiguracją. Nie twierdzi, że ponumerowany dokument jest dopuszczalny w sądzie, prawnie ważny ani wystarczający dla reguł ujawniania (discovery) jakiejkolwiek jurysdykcji.
Nota o granicy Enterprise
Dział zatytułowany „Nota o granicy Enterprise”Enterprise nie zmienia zachowania Legal. Enterprise dodaje funkcje zgodności i podpisów wyższego poziomu udokumentowane osobno; nie są one wymagane do numeracji Batesa.
Rozwiązanie awaryjne / alternatywa w Core
Dział zatytułowany „Rozwiązanie awaryjne / alternatywa w Core”Nie istnieje odpowiednik w Core dla konfigurowalnej numeracji Batesa. To dodatek Pro.
Granica publikacji
Dział zatytułowany „Granica publikacji”Ta strona dokumentuje wyłącznie zachowanie obserwowalne zewnętrznie 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.
Zobacz też
Dział zatytułowany „Zobacz też”- Merge — składaj zestawy produkcyjne przed numeracją.
- Security — redakcja i kontrola dostępu.
- Legal — Dogłębna dokumentacja — pełny kontrakt API i szczegóły zachowania.