CreatePreflightReportEx
Zgodność, Inspekcja dokumentu
Wybór profilu czytnika PDF/UA
Kontrole PDF/UA wybierają część 2, gdy XMP wskazuje pdfuaid:part=2, a w przeciwnym razie zachowują kontrole części 1; opisane tu starsze kontrole PDF/UA-1 nie obejmują automatycznie części 2
Profil PDF/UA-2 implementuje podstawowe kontrole identyfikacji, przestrzeni nazw, ról i struktury; raporty strukturalne używają PDF/UA-2 i ISO 14289-2 oraz ujawniają fullCertification=false i niezweryfikowany zakres
Użyj CheckFilePDFUACompliance lub RunPDFUAValidationPipelineTask, aby wymusić część docelową, oraz GetPDFUAReadValidationCoverageJSON, aby obejrzeć limity możliwości
Opis
Tworzy raport kontroli wstępnej dla zewnętrznego pliku PDF i przekształca go do żądanego formatu wyjściowego. Jest to świadomy formatu odpowiednik funkcji CreatePreflightReport, która zawsze zwraca raport tekstowy.
Składnia
Delphi
Function TPDFlib.CreatePreflightReportEx(Const InputFileName, Password: WideString; ComplianceTests, Options, ReportFormat: Integer): WideString;Parametry
| InputFileName | Pełna ścieżka pliku PDF do zweryfikowania. Plik jest otwierany tylko do odczytu i nie jest modyfikowany. |
|---|---|
| Password | Hasło używane do otwarcia pliku. Dla dokumentów niezaszyfrowanych przekaż pusty ciąg. |
| ComplianceTests | Maska bitowa wybierająca kontrole: 1 dla PDF/A, 2 dla PDF/UA, 3 lub 0 dla obu. |
| Options | Flagi bitowe przekazywane do każdej wybranej kontroli zgodności. Przekaż 1, aby zatrzymać każdą kontrolę po pierwszym problemie. |
| ReportFormat | Selektor formatu wyjściowego. 0 — zwykły tekst. 1 — obiekt JSON z polami nagłówka, sekcjami poszczególnych kontroli, tablicami problemów i polami podsumowania. 2 — samodzielny dokument HTML zawierający raport tekstowy ze znakami ucieczki. 3 — wiersze CSV z metadanymi, wybranymi kontrolami, kodami i komunikatami problemów oraz końcowymi wierszami podsumowania. |
Wartość zwracana
Zwraca wygenerowany raport w wybranym formacie. Nieznane wartości ReportFormat powodują użycie formatu tekstowego.
Uwagi
Formaty JSON, HTML i CSV są generowane z tego samego raportu tekstowego co CreatePreflightReport, dlatego stan powodzenia lub niepowodzenia oraz liczba problemów pozostają spójne we wszystkich formatach raportu.
Obiekt JSON udostępnia pola nagłówka, tablicę sections, tablice ciągów problemów i obiekt summary. Postać HTML jest samodzielnym dokumentem, który umieszcza raport tekstowy ze znakami ucieczki w bloku tekstu preformatowanego. Postać CSV używa stałych kolumn kind,section,status,code,message i rozdziela metadane, stan kontroli, wiersze problemów i podsumowania na potrzeby analizy w arkuszu kalkulacyjnym lub CI.
Pełną umowę formatów raportów i przykłady wiersza poleceń wersji demonstracyjnej opisano w Preflight Reports.
Przykład
JsonReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 1);
HtmlReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 2);
CsvReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 3);Zobacz również
Preflight Reports, CreatePreflightReport, SavePreflightReportEx, ComparePreflightReports, CheckFileCompliance