CheckFileCompliance

Zgodność, inspekcja dokumentów

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

Wczytuje zewnętrzny plik PDF i sprawdza go względem wybranego standardu zgodności ISO. Zwracana wartość to albo zero (plik przechodzi wybrany test bez zastrzeżeń), albo niezerowy uchwyt StringListID wyliczający każdy wykryty problem. Każdy wpis listy to krótki kod, dwukropek i komunikat czytelny dla człowieka — dokładnie ten sam format kodów, którego używa GetPDFUADiagnostics. Wynik wylicz za pomocą GetStringListCount i GetStringListItemTest PDF/A obejmuje wszystkie sześć trybów zgodności (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) i odczytuje wpisy XMP

pdfaid:part/pdfaid:conformance, aby rozstrzygnąć, który zestaw reguł zastosowaćTest PDF/UA-1 (dodany w v3.56.0) sprawdza zewnętrzny plik PDF względem ISO 14289-1 i generuje kody diagnostyczne w zakresie

10xxx, aby pozostawały wizualnie oddzielone od kodów PDF/A 00xxx

Składnia

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

Parametry

Wartości zwracane

Kody problemów PDF/A (ComplianceTest = 1)

Kody problemów PDF/UA-1 (ComplianceTest = 2)

Uwagi

Test PDF/A jest przeznaczony jako szybka samokontrola przed dostarczeniem. Wyłapuje problemy na poziomie dokumentu, które od razu dyskwalifikują plik (niewłaściwa wersja PDF, brak OutputIntent, brak drzewa struktury na poziomie A, szyfrowanie, warstwy w PDF/A-1). Nie przechodzi jednak przez każdy operator strumienia zawartości ani nie weryfikuje osadzenia czcionek ani referencji przestrzeni kolorów dla każdego rysowanego obiektu — te walidacje wymagają dedykowanego walidatora PDF/A (takiego jak veraPDF). Używaj tej funkcji jako kontroli pierwszej linii i jako bramki regresji w potokach budowania. Użyj CreatePreflightReport lub SavePreflightReport, jeśli chcesz, aby biblioteka sformatowała listy problemów do raportu tekstowego wielokrotnego użytku. Użyj CreatePreflightReportEx lub SavePreflightReportEx dla raportów w formacie tekstowym, JSON, HTML lub CSV, albo zobacz Preflight Reports, aby poznać pełny obieg pracy z raportamiSiostrzany interfejs API

GetPDFUADiagnostics wykonuje analogiczne sprawdzenia dla PDF/UA (ISO 14289-1) na budowanym właśnie dokumencie w pamięci, a nie na zewnętrznym plikuPrzy produkcji wyjścia PDF/A tą biblioteką wywołaj

SetPDFAMode przed dodaniem jakiejkolwiek zawartości. Strażnik po stronie generowania wewnątrz SetPDFAMode blokuje operacje zabronione przez wybraną część, więc dokument zbudowany w ten sposób zwykle przejdzie CheckFileCompliance automatycznie

Przykład

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

Zobacz również

Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode

Test zgodności 3 audytuje PDF/X (ISO 15930): identyfikację edycji, output intent, geometrię strony, osadzone fonty i zestaw cech zabronionych; dla PDF/X-6 weryfikuje też flagi adnotacji i utrwalone wyglądy, wyglądy AcroForm i podpisów, wyjątki XFA oraz wyglądów generowanych przez przeglądarkę, rozmieszczenie akcji, łańcuchy akcji, dozwolony zestaw akcji nazwanych i każdą wartość UseBlackPtComp

Test zgodności 4 audytuje metadane identyfikacyjne PDF/VT-3, jego bazę z rodziny PDF/X-6, graf DPartRoot i DPart, nazwy i wartości DPM, poziom rekordu, kolejność stron i dokładne pokrycie liści; złożone kontrole dzielą jeden przebieg parsera

Test zgodności 5 audytuje rozmieszczenie znaczników PDF/R-1, wersję i szyfrowanie, obiekty pośrednie generacji zero, ograniczone słowniki i filtry, jednostrumieniowe programy stron, uporządkowane pasma rastrowe, kodowania obrazów, pokrycie strony i skuteczną rozdzielczość; może ponownie użyć wspólnego przebiegu potoku walidacji

Test zgodności 6 audytuje podstawę PDF/X i identyfikację XMP PDF/VCR-1, pojedynczy bezpośredni korzeń szablonu, zadeklarowane pola, opcjonalne pole wyboru strony i każdy liściasty symbol zastępczy zamiany PassThrough, powiązanie strony, MCID i prostokąt otaczający; może ponownie użyć wspólnego przebiegu potoku walidacji

Test zgodności 7 audytuje identyfikację i metadane cyklu życia PDF/E-1, identyfikatory trailer, dozwolone szyfrowanie, output intenty i przestrzenie barw urządzeń, operatory treści, fonty, adnotacje, formularze, treść opcjonalną, akcje, referencje do plików zewnętrznych, stany grafiki i ograniczenia strumieni 3D; może ponownie użyć wspólnego przebiegu potoku walidacji