Innerhalb der CROSSCAP Anwendung werden Variable an vielen Stellen zur Automatisierung bzw. zur (dynamischen) Steuerung von Abläufen eingesetzt.
Neben den im Kapitel Projekteinstellungen ausführlich beschriebenen, von Ihnen selbst definierten Indexwerten existieren weitere, anwendungsweit geltende Variablen zur Ablaufsteuerung.
Am Beispiel der Definition eines Projektverzeichnisses werden hier die verfügbaren Variablen einer näheren Betrachtung unterzogen:
Bedienung des Erweiterungsmenüs
Durch Markieren eines der Einträge im Fenster Verfügbar: oder Gewählt: und Betätigung der horizontalen, grünen Pfeile können Einträge zwischen den beiden Fenstern verschoben werden, also Variable hinzugefügt (nach rechts) oder entfernt (nach links) werden.
Markiert man im rechten Fenster einen der aktiven Einträge, dann kann dieser mit Hilfe der vertikalen, grünen Pfeile auf oder ab bewegt werden. Dies verändert die Reihenfolge der späteren Abarbeitung (die Variablen werden von oben nach unten abgearbeitet).
Zur weiteren Konfiguration markieren Sie bitte die gewünschte Variable, im Fenster Gewählt:. Im darunter liegenden Eigenschaften von ... Fenster erscheinen dann die jeweiligen Detail-Optionen.
Beschreibung der verfügbaren Variablen:
Aktueller Stapelname
Erstellt ein Unterverzeichnis mit dem von Ihnen vergebenen Stapelnamen.
Barcode
Häufig finden sog. Vorblätter oder Laufzettel Verwendung, um Aufträge bzw. Stapel voneinander abzugrenzen. Werden diese Informationen zu Beginn eines Projektes eingelesen, können Sie z.B. einen auf diesem Vorblatt enthaltenen Barcode bzw. dessen Inhalt in die Verzeichnisstruktur übernehmen.
Benutzername
Repräsentiert den Namen des aktuell am Rechner angemeldeten Benutzers. Verwenden Sie diese Variable, um eine benutzerabhängige Ablage der Daten zu realisieren.
Bildinformation
Liefert technische Bildinformationen, wie z.B. Bildauflösung oder -größe. Über die Drop-Down Liste Kategorie können Sie den gewünschten Informationstyp auswählen. Falls Sie Zugriff auf mehrere Informationstypen benötigen, legen Sie einfach die Variable Bildinformation mehrfach an und variieren dabei die Kategorie.
Siehe auch Erweiterte Bildinformationen, für den Zugriff auf vom Scanner gelieferte Metadaten.
Computername
Der Computername, auch Hostname, ist die eindeutige Kennzeichnung eines Rechners im Netzwerk. Verwenden Sie diese Variable, wenn Sie die erzeugten Daten entsprechend ihrer Herkunft (auf welchem PC wurde dieses Dokument gescannt?) ablegen wollen.
Datum / Uhrzeit
Verwenden Sie diese Variable vorzugsweise dann, wenn Sie eindeutige, sich nie wiederholende Verzeichnisse oder Dateinamen erzeugen wollen. Sie können hierfür die Stapelstart-, die Stapelende-, die Scan- oder die aktuelle Zeit verwenden.
Das Format für die ausgegebenen Datums- und Uhrzeit-Werte kann entweder aus einer Liste von fertigen und gängigen Vorschlägen ausgewählt werden, zusätzlich ist aber auch eine sogenannte freie Eingabe möglich. Hier legen Sie selbst eine Formatzeichenkette fest, nach dem folgenden Schema (bitte beachten Sie die Groß bzw. Kleinschreibung):
y = Jahr
M = Monat
d = Tag
h = Stunde (im 12 Stunden Format)
H = Stunde (im 24 Stunden Format)
m = Minuten
s = Sekunden
f = Hundertstel Sekunde
Die Vorgabe yyyyMMddHHmm würde demzufolge (beispielhaft) die folgende Ausgabe hervorrufen: 201506152359.
Über diese Variable können Sie jedem Dokument einen eigenen Ordner zur Ablage zur Verfügung stellen.
CROSSCAP erlaubt die Verwendung von drei verschiedenen Arten von Seiten- bzw. Dokumentenzählern. Einen Vergleich der verschiedenen Zählertypen finden Sie im Abschnitt Zähler und Statistik.
Dokumentindex
Ist mindestens ein Dokumentindex angelegt worden, können Sie diesen in Ihrer Verzeichnisstruktur verwenden.
Domänenname
Diese Variable kann nur dann sinnvoll verwendet werden, wenn sich der Rechner, auf dem die Anwendung betrieben wird, in einer Windows-Domäne befindet. Stehen mehrere Domänen zur Anmeldung zur Verfügung, erlaubt Ihnen diese Variable die Ablage der Daten nach Domänen getrennt durchzuführen.
Endorserzeichenkette
Wenn Sie einen Endorser (Imprinter) verwenden, haben Sie die Möglichkeit, die auf dem Scangut aufgebrachten Zeichenfolgen auch hier abzurufen. Eine Endorserzeichenkette setzt sich aus diversen Variablen zusammen, die Definition der Endorserzeichenkette erfolgt in den Projekteinstellungen, Abschnitt Scannereinstellungen.
Erweiterte Bildinformation
Erlaubt den Zugriff auf Metadaten, welche vom Scanner geliefert werden. Über die Drop-Down Liste Infoname können Sie den gewünschten Informationstyp auswählen. Falls Sie Zugriff auf mehrere Informationstypen benötigen, rufen Sie einfach die Variable Erweiterte Bildinformation mehrfach auf und variieren dabei den Infonamen.
Siehe Bildinformationen, für den Zugriff auf technische Bildinformation.
Fester Text
Diese Variable ermöglicht die Definition von statischen Anteilen in Dateinamen. So können Sie beispielsweise aus Dokument001 die übersichtlichere Variante Dokument-001 erzeugen, indem Sie den Bindestrich als festen Text an der gewünschten Stelle einfügen.
Kalenderwoche
Fügt die aktuelle Kalenderwoche in den Pfad ein.
Powershell
Erlaubt über die Windows Powershell™ den Zugriff auf systemweite (also auch CROSSCAP fremde) Datenobjekte, zwecks Weiterverwendung innerhalb der CROSSCAP Stapelverarbeitung. Sollen hingegen Ergebnisse eines Powershell-Scriptes ausgegeben werden (z.B. in eine Datei), dann verwenden Sie bitte die dafür besser geeignete Export-Option Powershell-Export (siehe Abschnitt Export im Kapitel Projekteinstellungen)
Die Variable Powershell verfügt nur über einen einzigen Konfigurationspunkt, Scripttext, hinter dem sich ein Editor für das anzuwendende Powershell-Skript verbirgt (oberer Teil des unten gezeigten Fensters).
Die Variable Powershell erwartet nach Ausführung des hier hinterlegten Scripts grundsätzlich die Übergabe eines Ergebnis-Strings. Aus diesem Grund wird beim ersten Aufruf des Scripttextes eine vorbereitete return-Zeile eingefügt (siehe Abbildung oben), welche auf keinen Fall gelöscht oder umgewidmet werden sollte.
Unterhalb des Skripteditors finden Sie eine Auflistung der verfügbaren Powershell-Klassen. Wenn Sie (in der CROSSCAP Anwendung) auf den Namen einer der Klassen klicken, erhalten Sie weitere Information zu den Eigenschaften dieser Klasse, sowie zu den jeweils verfügbaren Variablen. Verwenden Sie bitte die Schaltfläche für das Zurückblättern (der kleine grüne Pfeil nach links), um in diese Auflistung zurückzukehren.
Code-Beispiel:
Der folgende Beispiel-Code bezieht sich auf die Powershell Klasse PowerShellPageNode. Das Beispiel verwendet die in dieser Klasse verfügbare Variable $CurrentImage und deren Eigenschaften PreEndorserString und IsDuplex:
# Beispiel: Der Vorderseitenendorser enthält eine Zeichenkette mit 20140512111109 # Die letzten 5 Ziffern stellen einen Zähler dar. # Aufgabe: Extrahiere den 5-stelligen Zähler aus der Zeichenkette $counter = [int]$CurrentImage.PreEndorserString.Substring(10, 5) # Addiere 1 zum Zähler $counter++ # Wurde das Bild im Duplexmode gescannt, dann nochmals 1 addieren if($CurrentImage.IsDuplex) { $counter++ } # Die Zeichenkette wieder in das ursprüngliche Format mit dem neuen Zähler formatieren return ( $CurrentImage.PreEndorserString.Substring(0, 10) + "{0:D5}" -f $counter )Bitte beachten Sie: PowerShell ist ein kostenfreies Produkt, welches bei früheren Windows Versionen nicht zum Standardumfang der Windows-Client Installation gehörte. Powershell-Variable und Export-Funktionen werden daher u.U. erst dann verfügbar bzw. aktiv, wenn PowerShell auf dem ausführenden PC / Server (nach)installiert wurde. CROSSCAP setzt eine PowerShell Version 3.X oder größer voraus.
Seitenunterscheider
Der Seitenunterscheider bietet die Möglichkeit, einen Vorder- oder Rückseiten-spezifischen Text-String zu erzeugen. Sie können mit dieser Variablen z.B. Namen von Exportdateien mit einem Zusatz versehen, aus welchem erkennbar wird, ob es sich bei der exportierten Seite um eine Vorder- oder Rückseite gehandelt hat.
Sie können die Unterscheidungsmerkmale direkt in das Eingabefeld eintragen oder über die Schaltfläche am Ende der Zeile den Dialog Zeichenfolge eingeben aufrufen. Sie bekommen dann ein größeres Text-Eingabefeld angezeigt.Bitte beachten Sie: Die Optionen Vorderseite und Rückseite funktionieren nur bei Scannern, die über eine entsprechende Funktion zur Seitenunterscheidung verfügen und diese Information auch per TWAIN-Treiber übermitteln. Insbesondere Flachbettscanner übermitteln dieses Metadatum üblicherweise nicht.
Repräsentiert die Anzahl der im aktuellen Stapel gescannten Seiten. Sie können in den Einstellungen die Anzahl der zu erwartenden Stellen angeben. Dies hat den Vorteil, dass die Ordner z. B. im Datei-Explorer chronologisch folgerichtig sortiert werden.
Ohne führende Nullen:1
10
11
12
13
2
3
...Mit führenden Nullen:
001
002
003
...
010
011
012
013CROSSCAP erlaubt die Verwendung von drei verschiedenen Arten von Seiten- bzw. Dokumentenzählern. Einen Vergleich der verschiedenen Zählertypen finden Sie im Abschnitt Zähler und Statistik.
Erlaubt den Zugriff auf einen der von Ihnen angelegten (Software-) Zähler (Details hierzu im Abschnitt Zähler, im Kapitel Projekteinstellungen).
CROSSCAP erlaubt die Verwendung von drei verschiedenen Arten von Seiten- bzw. Dokumentenzählern. Einen Vergleich der verschiedenen Zählertypen finden Sie im Abschnitt Zähler und Statistik.
Stapelindex
Ist mindestens ein Stapelindex angelegt worden, können Sie diesen in Ihrer Verzeichnisstruktur verwenden (mehr Information zu diesem Thema finden Sie im Abschnitt Indexfelder, Kapitel Projekteinstellungen).
Diese Variable beinhaltet den aktuellen Stand des Stapelzählers. Sie haben hierüber z.B. die Möglichkeit, Ihre Exportdaten nach abgearbeiteten Stapeln sortiert abzulegen.
Texterkennungstext
Erlaubt den Zugriff auf Textpassagen, welche durch sog. zonale Texterkennung erfasst wurden. Vorab muss die Texterkennung entsprechend konfiguriert worden sein (siehe Texterkennung (Projekt), im Abschnitt Bildverarbeitung, Kapitel Projekteinstellungen).
Über der Drop-Down Liste OCR-Textbereich können Sie einen der dort definierten Suchbereiche auswählen.
Verzeichnistrenner
Dies ist die deutsche Umschreibung des bekannten Backslash "\", welcher in einer MS-Windows-Umgebung zur Trennung von Verzeichnisebenen verwendet wird.
<Kalenderwoche><Aktueller Projektname> ergibt den Pfadanteil: ...\25Batch001\...
<Kalenderwoche><Verzeichnistrenner><Aktueller Projektname> ergibt den Pfadanteil: ...\25\Batch001\...
Alternativ können Sie einen Verzeichnistrenner auch über die Variable "Fester Text" (siehe oben) definieren, indem Sie dort einen Backslash eintragen.
Vorgabe
Erlaubt den Zugriff auf eine der von Ihnen angelegten Vorgaben (weitere Details finden Sie im Abschnitt Vorgaben, im Kapitel Projekteinstellungen).
Über diese Variable kann der aktuelle Stand der Zähler eines angeschlossenen Scanners ausgegeben und z.B. zur Benamung von Exportdateien verwendet werden.
Neben der Möglichkeit, die Anzahl der Stellen oder einen Zähler-Offset festzulegen, können Sie hier einen der hier angebotenen Zählertypen auswählen:
CROSSCAP erlaubt die Verwendung von drei verschiedenen Arten von Seiten- bzw. Dokumentenzählern. Einen Vergleich der verschiedenen Zählertypen finden Sie im Abschnitt Zähler und Statistik.
