CheckDocumentPolicy

Dokumenteigenschaften, Konformität

Beschreibung

Wertet eine Liste deklarativer interner Regeln am Dokument aus und meldet, welche davon erfüllt sind.

Syntax

Delphi

Function TPDFlib.CheckDocumentPolicy(Const Rules: WideString): Integer;

Parameter

Rules	Eine Zusicherung pro Zeile im Format `Group.Key op Value`. Leerzeilen und mit `#` beginnende Zeilen werden ignoriert.

Rückgabewerte

0	Es ist kein Dokument ausgewählt oder der Regeltext ist leer.
ID	Ein Zeichenfolgenlisten-Handle für GetStringListCount und GetStringListItem; geben Sie es mit ReleaseStringList frei

Anmerkungen

Regelgegenstände beziehen sich auf den von GetDocumentFeatureReport erzeugten Funktionsbericht: Die Zeile Group,Key,Value Fonts,NotEmbedded,0 wird als Fonts.NotEmbedded angesprochen. Unterstützte Operatoren sind =, !=, <, <=, >, >= und exists; der Vergleich erfolgt numerisch, wenn beide Seiten als Zahlen analysiert werden können, andernfalls als Text ohne Beachtung der Groß-/Kleinschreibung

Jede Ergebniszeile besteht aus pass oder fail, gefolgt von der Regel und dem tatsächlichen Wert; die letzte Zeile lautet summary,N passed,M failed. Unbekannte Funktionsschlüssel, fehlerhafte Regeln und nicht unterstützte Operatoren werden als Fehler gemeldet und nicht stillschweigend ignoriert, sodass ein Tippfehler in einer Richtliniendatei ein Dokument nicht fälschlich konform erscheinen lassen kann.

Dadurch wird ein Eingangsfilter zur Konfiguration: Herausgeber, Archive und Druckereien können vollständig eingebettete Schriften, verbotene Verschlüsselung, Seitenbegrenzungen oder erforderliche Metadaten erzwingen, ohne Prüfcode zu schreiben

Beispiel

Rules:=
  'Fonts.NotEmbedded = 0'#13#10+
  'Security.Encrypted = no'#13#10+
  'Document.Pages <= 500'#13#10+
  'Document.Title exists';
ListID:= PDF.CheckDocumentPolicy(Rules);
Last:= PDF.GetStringListItem(ListID, PDF.GetStringListCount(ListID));
if Pos('0 failed', Last)= 0 then
  ShowMessage('document rejected by policy');
PDF.ReleaseStringList(ListID);

Siehe auch

GetDocumentFeatureReport, CheckDocumentStructure, CheckFileCompliance