Nộp hồ sơ điện tử

Tổng quan nhanh

NextPDF Enterprise tối ưu hóa một PDF thành một tạo phẩm giao nộp phù hợp cho việc nộp hồ sơ điện tử tới tòa án / cơ quan nhà nước theo cấu hình của một hồ sơ khu vực pháp lý, và chia nó thành các đoạn bị giới hạn kích thước khi một giới hạn kích thước của hồ sơ bị vượt. Nó chuẩn bị các định dạng để nộp hồ sơ theo cấu hình; nó không bảo đảm rằng bất kỳ tài liệu nào được một tòa án hay cơ quan đăng ký chấp nhận.

Tính khả dụng & cấp phép

Năng lực này đi kèm trong NextPDF Enterprise (nextpdf/enterprise) và kích hoạt với một license envelope hạng Enterprise. Một triển khai không có quyền đó sẽ không nạp các lớp của năng lực này. So sánh các phiên bản và nhận giấy phép.

Cài đặt

composer require nextpdf/enterprise:^3

Tổng quan khái niệm

EFilingOptimizer chạy một pipeline cố định trên một PDF đầu vào:

1. Làm sạch. Nội dung chủ động (JavaScript và action) được loại bỏ thông qua engine content-disarm-and-reconstruction.
2. Tuyến tính hóa. Tài liệu được tuyến tính hóa để xem nhanh trên web.
3. Kiểm tra kích thước và chia. Nếu kết quả vượt giới hạn kích thước của hồ sơ, SizeAwareSplitter chia nó thành các đoạn mỗi đoạn đều vừa, dùng một tìm kiếm nhị phân trên số trang để chọn các điểm chia.

Một hồ sơ khu vực pháp lý (EFilingProfile) mang theo các ràng buộc: kích thước tệp tối đa cho mỗi đoạn, chất lượng nén lại JPEG, làm phẳng biểu mẫu, loại bỏ JavaScript, tuyến tính hóa, và nén object-stream. Các hồ sơ dựng sẵn bao gồm US PACER (giới hạn 25 MiB), EU e-Justice (giới hạn 10 MiB), và Taiwan Judicial Yuan (giới hạn 10 MiB). Kết quả (EFilingResult) báo cáo các đoạn, kích thước gốc và đã tối ưu, các tối ưu đã áp dụng, và mọi cảnh báo.

Kết quả nộp hồ sơ điện tử là một tạo phẩm giao nộp, không phải một trạng thái vòng đời tài liệu. Một PDF đã tối ưu hoặc đã chia là cuối cùng để truyền và không được tái nhập vào một pipeline ký hay lưu trữ, vì việc xử lý lại sẽ phá vỡ các chuỗi băm và tính toàn vẹn làm bằng chứng.

Module này tuyên bố và không tuyên bố những gì

Module này chuẩn bị các định dạng để nộp hồ sơ điện tử tới tòa án / cơ quan nhà nước theo cấu hình. Nó không bảo đảm việc chấp nhận bởi bất kỳ tòa án, cơ quan đăng ký, hay cổng nộp hồ sơ nào. Các quy tắc của cổng, các định dạng được chấp nhận, các giới hạn kích thước, và các yêu cầu thủ tục khác nhau theo khu vực pháp lý và thay đổi theo thời gian. Các hồ sơ dựng sẵn mã hóa các ràng buộc thường được công bố như một tiện ích; hãy xác minh chúng so với các quy tắc hiện hành của cơ quan đăng ký đích trước khi nộp.

Vì sao nó hoạt động theo cách này

Pipeline chạy theo một thứ tự cố định — làm sạch, tuyến tính hóa, kiểm tra kích thước — vì mỗi giai đoạn tiêu thụ đầu ra của giai đoạn trước. Content disarm and reconstruction chạy trước tiên, vì các đầu vào nộp hồ sơ đến từ các bên không tin cậy và phải được vô hiệu hóa trước khi ghi lại. Việc tuyến tính hóa đi trước kiểm tra kích thước vì nó thay đổi bố cục byte, và do đó là kích thước mà bộ chia phải tôn trọng. splitByMaxSize() sau đó xác minh mọi đoạn được tạo so với giới hạn maxFileSizeBytes của hồ sơ thay vì tin vào một ước lượng trung bình theo trang. Một trang đơn vẫn vượt giới hạn là không thể chia, nên nó xuất hiện dưới dạng một cảnh báo thay vì bị bỏ. Tạo phẩm giao nộp bị loại trừ khỏi việc ký lại và lưu trữ lại, vì việc xử lý lại các byte đã nộp sẽ phá vỡ các chuỗi băm làm bằng chứng.

Bối cảnh thiết kế: Làm sạch các PDF không tin cậy: content disarm and reconstruction.

Bề mặt API

Lớp	Trách nhiệm
EFilingOptimizer	Chạy pipeline làm sạch → tuyến tính hóa → chia theo kích thước.
EFilingProfile	Hồ sơ ràng buộc khu vực pháp lý (pacer(), euJustice(), taiwan(), hoặc tùy chỉnh).
SizeAwareSplitter	Chia một PDF thành các đoạn dưới một giới hạn byte.
EFilingSegment	Một đoạn đầu ra: byte, dải trang, kích thước, chỉ số.
EFilingResult	Tổng hợp: các đoạn, kích thước, các tối ưu, cảnh báo.

Mẫu mã — Bắt đầu nhanh

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

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

Mẫu mã — Sản phẩm

$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.

Trường hợp biên & điều cần lưu ý

• Một tài liệu đã ở dưới giới hạn của hồ sơ sẽ trả về một đoạn duy nhất, không thay đổi về mặt kích thước.
• Một trang đơn vượt giới hạn không thể chia nhỏ hơn; nó được trả về dưới dạng một đoạn vượt giới hạn kèm một cảnh báo. Hãy giảm chất lượng ảnh trong một hồ sơ tùy chỉnh hoặc tiền xử lý trang.
• Nếu việc làm sạch từ chối đầu vào, một cảnh báo được ghi lại và các byte gốc được giữ; hãy kiểm tra các cảnh báo trước khi nộp.
• Các giới hạn của hồ sơ dựng sẵn phản ánh các giá trị thường được công bố, không phải một nguồn cấp dữ liệu trực tiếp từ mỗi cổng. Hãy coi chúng là các giá trị mặc định cần xác nhận.

Hiệu năng

Chi phí tỷ lệ với kích thước tài liệu và số trang. Việc chia thực hiện một tìm kiếm nhị phân trên số trang, nên số lần thử chia là logarit theo số trang. Việc tuyến tính hóa và nén lại chi phối thời gian thực thi cho các tài liệu lớn nhiều ảnh.

Lưu ý bảo mật

Nội dung chủ động được loại bỏ trước khi giao nộp thông qua content disarm and reconstruction. Hãy coi các PDF đầu vào từ các bên không tin cậy là độc hại; bước làm sạch là một biện pháp giảm thiểu, không phải một bảo đảm an toàn cho các hệ thống phía sau.

Lưu trú dữ liệu & biện pháp giảm thiểu PII

Các tài liệu được nộp thường chứa dữ liệu cá nhân và dữ liệu vụ việc. Việc xử lý là trong tiến trình và cục bộ; module không thực hiện cuộc gọi mạng đi nào. Hãy áp dụng các biện pháp kiểm soát lưu giữ của riêng bạn cho các đoạn và cho bản gốc.

Đo từ xa an toàn & làm sạch nhật ký

Các cảnh báo và bản ghi tối ưu mô tả các hành động của pipeline, không phải nội dung tài liệu. Hãy tránh ghi nhật ký các đường dẫn tệp hay mã định danh vụ việc từ mã xung quanh của bạn tại các đích chung.

Tính phù hợp

Hành vi	Tham chiếu	Trạng thái
Ngữ nghĩa quan hệ associated-file	ISO 19005-3:2012 §6.7.8	Được tôn trọng ở nơi các carrier áp dụng
Các yêu cầu carrier tệp nhúng	ISO 19005-4:2020 Annex A	Được tôn trọng ở nơi các carrier áp dụng

Bảng này ghi lại các đặc tả mà việc xử lý PDF/A xung quanh được xây dựng theo. Nó không phải là một tuyên bố về việc chấp nhận bởi bất kỳ tòa án hay cơ quan đăng ký nào.

Hành vi ở chế độ FIPS

Module này không thực hiện thao tác mã hóa nào.

Mô hình mối đe dọa

Các PDF đầu vào không tin cậy mang theo nội dung chủ động là đầu vào chính. Biện pháp giảm thiểu: content disarm and reconstruction trước khi tuyến tính hóa và giao nộp; tạo phẩm giao nộp bị loại trừ khỏi việc ký lại và lưu trữ lại để bảo vệ tính toàn vẹn làm bằng chứng.

Hợp đồng hành vi

• EFilingOptimizer chạy một pipeline cố định: content disarm and reconstruction, tuyến tính hóa, rồi một kiểm tra kích thước với việc chia bằng tìm kiếm nhị phân khi một giới hạn của hồ sơ bị vượt.
• Một tài liệu đã ở dưới giới hạn của hồ sơ sẽ trả về một đoạn duy nhất không thay đổi kích thước.
• Một trang đơn vượt giới hạn được trả về dưới dạng một đoạn vượt giới hạn kèm một cảnh báo; nó không thể chia nhỏ hơn.
• Một tạo phẩm nộp hồ sơ điện tử là cuối cùng để truyền và không được tái nhập vào một pipeline ký hay lưu trữ; việc xử lý lại sẽ phá vỡ các chuỗi băm và tính toàn vẹn làm bằng chứng.

Ranh giới xuất bản

Trang này chỉ tài liệu hóa hành vi có thể quan sát được từ bên ngoài và bề mặt API công khai được hỗ trợ. Các đường dẫn namespace nội bộ, các lớp trợ giúp, các bảng cơ chế, các tên tệp runbook, và các tiền tố ticket nằm ngoài phạm vi.

Phương án dự phòng Core

NextPDF Core không có trình tối ưu nộp hồ sơ điện tử theo hồ sơ khu vực pháp lý, không có giai đoạn làm sạch CDR, và không có bộ chia theo kích thước. Một triển khai chỉ có Core phải tự dựng mọi pipeline chuẩn bị nộp hồ sơ.

Phương án dự phòng Pro

NextPDF Pro không cung cấp trình tối ưu nộp hồ sơ điện tử theo hồ sơ khu vực pháp lý, các hồ sơ dựng sẵn PACER / EU e-Justice / Taiwan Judicial Yuan, giai đoạn làm sạch CDR, hay bộ chia theo kích thước. Một cấu hình yêu cầu việc tối ưu hóa nộp hồ sơ điện tử theo hồ sơ trong một triển khai chỉ có Pro không có thành phần Enterprise nào để thỏa mãn nó. Xem Tổng quan Enterprise để biết bề mặt Enterprise.

Lưu ý về ranh giới Enterprise

Chi tiết cơ chế nội bộ nằm trong tài liệu nội bộ của kho nguồn và nằm ngoài phạm vi của tài liệu hướng dẫn này.

Ranh giới triển khai

Các giới hạn của hồ sơ dựng sẵn mã hóa các ràng buộc thường được công bố như một tiện ích, không phải một nguồn cấp dữ liệu trực tiếp từ mỗi cổng; việc xác nhận chúng so với các quy tắc hiện hành của cơ quan đăng ký đích trước khi nộp là trách nhiệm của người nộp. Việc xử lý là trong tiến trình và cục bộ; module không thực hiện cuộc gọi mạng đi nào. Việc truyền tới một tòa án, cơ quan đăng ký, hay cổng nộp hồ sơ là bên ngoài module này.

Ranh giới tuân thủ pháp lý

NextPDF chuẩn bị các định dạng để nộp hồ sơ điện tử tới tòa án / cơ quan nhà nước theo cấu hình của một hồ sơ khu vực pháp lý. Nó không bảo đảm rằng một tài liệu sẽ được chấp nhận bởi bất kỳ tòa án, cơ quan đăng ký, hội đồng xét xử, hay cổng nộp hồ sơ nào, và không cung cấp tư vấn pháp lý. Các quy tắc nộp hồ sơ, các định dạng được chấp nhận, các giới hạn kích thước, các yêu cầu chữ ký, và các hạn chót thủ tục do cơ quan có thẩm quyền liên quan đặt ra, khác nhau theo khu vực pháp lý, và thay đổi. Việc xác minh và đáp ứng các quy tắc đó là trách nhiệm của người nộp. Hãy tham vấn cố vấn và hướng dẫn hiện hành của cơ quan đăng ký đích.

Xem thêm

• Tài liệu tham chiếu Nộp hồ sơ điện tử — toàn bộ bề mặt API công khai cho module này.
• Invoice — tạo hóa đơn có cấu trúc.
• Tổng quan Enterprise
• Ma trận tính năng Core so với Pro so với Enterprise