Schritt für Schritt – callas-Produkte optimal nutzencallas pdfToolboxQuick FixQuick Fix Konfigurationsgrundlagen: String Vergleichsoperatoren und Seitenauswahl-Ausdrücke

Quick Fix Konfigurationsgrundlagen: String Vergleichsoperatoren und Seitenauswahl-Ausdrücke

Generale Überlegungen

QuickFixes sind optimiert für Geschwindigkeit. Zum Beispiel werden alle Änderungen durchgeführt auf eine PDF-Datei in Form eines "inkrementalen Speichervorganges" – Änderungen umgesetzt und dabei an das Ende der Datei geschrieben, Verweise bleiben relativ vorhanden und werden nicht 'physikalisch' überschieben oder entfernt. Während die PDF leicht größer werden könnte, ist es nicht erforderlich, diese komlett neu zu schreiben – diese ist eine entschiedene Zeiteinsparung besonders bei sehr großen PDFs. 

Darüberhinaus, führt die QuickFix-Engine eine inkrementelle Speicheroption pro QuickFix Schritt im Prozessplan aus und kombiniert QuickFixes des selben Types – z.B umbennen von einzelnen Sonderfarben oder verändert unterschiedliche Seitenrahmen in unterschiedlichen Seitenbereichen – mit einem Aufruf. Als Folge darauf – wann immer mehrere QuickFix Features angewendet werden auf eine PDF-Datei – ist es ratsam all erfolderlichen QuickFix Features in einen QuickFix Schritt innerhalb des Prozessplans zu kombinieren, als zahlreiche QuickFix basierte Prozessplanschritte zu verwenden.

Die Reihenfolge der Ausführung folgt immer der Reihenfolge wie die QuickFix Verarbeitungsschritte definiert sind im QuickFix selbst. Das kann sehr wichtig sein zum Beispiel bei Umbenennung von Sonderfarben – besondere Anweisungen könnten zuerst definiert werden und darauf folgende Anweisungen könten die verbleibenden Sonderfarben auf übliche Art und Weise anders benennen.

Wichtige Konfigurationsoptionen

Viele QuickFixes verwenden zwei Typen der Konfigurationsoptionen, diese sind in vielen Fällen sehr entscheidend für eine wirksme Ausführung.

String-Vergleichsoperatoren

Für einige QuickFix Features – zum Beispiel, Sonderfarben umbenennen – ist flexibles handling von Zeichenketten sehr wichtig. Aus diesem Grund werden folgende String-Operatoren angeboten innerhalb der QuickFix-Konfigurationen:

  • “noop”
  • "regex"
  • "begins_with"
  • "contains"
  • "does_not_begin_with"
  • "does_not_contain"
  • "does_not_end_with"
  • "ends_with"
  • "equal_to"
  • "is_contained_in"
  • "is_not_contained_in"
  • "unequal_to"

Diese Vergleichsoperatoren funktionieren genauso, wie die (ähnlich benamten) Vergleichsoperatoren in Prüfungen und Korrekturen.

Seitenauswahl

Für einige QuickFix Features – zum Beispiel, Seitenrahmen anpassen – ist es sehr wichtig eine flexible Option zu haben, um zu bestimmen welche Seiten verarbeitet werden sollen und welche nicht (z.B. ausschließlich die ersten zwei und die letzten, oder nur gerade Seiten, oder jede 4. Seite, usw.). Für diesen Zweck wird eine flexible Syntax verwendet um die Seiten oder Seitenbereiche auszudrücken. Dies ist die selbe Syntax wie verwendet im Split Schema (--splitscheme=<expression>) für das "Split and merge" Feature – siehe Split and merge für weitere Details.

Split Schema

Ein Split Schema Ausdruck kann eine Zahl sein mit einem Sternchen "*" oder einer noch komplexeren Zeichenkette. Wenn es sich um eine Zahl handelt mit einem Sternchen "*" erzeugt es Gruppen von Seiten wobei jede Gruppe eine bestimmte Anzahl von Seiten hat. Z.B. der Ausdruck "3*" würde PDFs erzeugen von je immer 3 Seiten.

Ausdrücke
Type
Syntax
Beispiel

Einfache
Ausdrücke
number[-number]
1-5
Seite 1 bis 5:
[1,2,3,4,5]


5-1
Seite 5 bis 1:
[5,4,3,2,1]


8
Ausschließlich Seite 8


-1
Letzte Seite


-3--1
Letzte 3 Seiten:
[n, n-1, n-2]


-1--3
Letzte 3 Seiten
in umgekehrter
Reihenfolge: [n-2,
n-1, n]


-1-3
Letzte n - 2
Seiten in
umgekehrter Reihenfolge:
[n, n-1, ... ,3]


*2(2)
[2][4][6]...
Einfache
Ausdrücke
mit einfachen
Bereich
number[-number]_
number[-number]
1-2_-2--1
Erste und letzte 2
Seiten: [1,2,n-
1,n]


1-2_-2--1,$
Erste und letzte 2 Seiten
[1,2,n-1,n]
und restliche
Seiten dazwischen
[3, ... ,n-2]


1_1_1_1
4 mal Seiten
1: [1,1,1,1]
Type
Syntax
Beispiel

Mehrseiten- ausdrücke
even_pages
even
even
Alle geraden Seiten
(same as
*2(2))

uneven_pages
uneven
odd
uneven
Alle ungeraden
Seiten (same
as *2(1))

Package
number*
[(start_page)]
5*
Pakete zu je 5
Seiten


5*(2)
Pakete zu je 5
Seiten, angefangen
bei Seite 2

Intervall
*number
[(start_page)]
*5
Jede 5. Seite


*5(2)
Jede 5. Seite, angefangen
bei Seite 2


*5(-20)
Jede 5. Seite
der letzten
20 Seiten vom Dokument
(insgesamt 4
Seiten)
Einfache Liste von
Ausdrücken
simple_expression
{","
simple_expression}
[ "," joker ]
1-5,8,-3--1
1 PDF mit
Seite 1-5, Seite
8 und die letzten
3 Seiten der Eingabe-PDF


1-5,8,-1--3
1 PDF mit
Seite 1-5, Seite
8 und die letzten
3 Seiten der Eingabe-PDF, aber die letzten 3 Seiten in umgekehrter Reihenfolge


5*(2)
Pakete zu 5 Seiten, angefangen
bei Seite 2


*5(2)
Jede 5. Seite, angefangen
bei Seite 2


*5(-20)
Jede 5. Seite
der letzten
20 Seiten von einem PDF
(insgesamt 4
Seiten)
Joker
<expression>,$

Kann kombiniert werden mit anderen Ausdrücken (sollte jedoch immer am Ende stehen innerhalb der Aufzählung) zum bestimmen der Gruppe aller Seiten, die nicht bereits eines anderen Ausdrucks definierter eigener Gruppe sind.

Example

1-5,8,-3--1,$

Dies würde somit zunächst eine Gruppe erzeugen der Seiten 1-5, als nächstes getrennt Seite 8, eine neue Gruppe der letzten 3 Seiten, sowie den übrigen Rest verbliebener Seiten von der PDF.