Docusnap und externe Programme

Docusnap bietet die Möglichkeit, von einem externen Programm zu Docusnap zu wechseln und den Datenexplorer zu einem bestimmten Punkt aufzuklappen.

Um dies zu ermöglichen gibt es die DocusnapLink.exe. Dieses Programm kann entweder direkt aufgerufen werden oder über das Docusnap-Protokoll gestartet werden.

Beim Öffnen von Docusnap können mehrere Parameter angegeben werden. Als erster Parameter wird der ONC mit dem konkreten ONC-Pfad angegeben. Der ONC-Pfad bestimmt, welches Objekt aufgeklappt werden soll. Wird kein Wert für ONC-Pfad angegeben bzw. ein nicht gültiger Wert als ONC-Pfad übergeben, dann wird Docusnap nur geöffnet.

Wenn die Funktion aufgerufen wird und Docusnap nicht läuft, wird nach einer gültigen Installation gesucht und diese gestartet. Wenn Docusnap aktiv ist, wird das Fenster anschließend in den Vordergrund geholt.

Einstellungen, die im Optionendialog getroffen werden, werden in einer Konfigurationsdatei auf dem Rechner, auf dem Docusnap ausgeführt wird, gespeichert. Wenn mehrere Mitarbeiter mit denselben Einstellungen Docusnap verwenden wollen, besteht die Möglichkeit, durch Parameter Docusnap mit einer gemeinsamen Konfigurationsdatei zu starten.

Diese zentrale Konfigurationsdatei sollte auch verwendet werden, wenn Docusnap von einem externen Programm gestartet wird, um Docusnap mit den gewünschten Einstellungen zu starten. Dabei wird der Parameter -UseConfig mit dem Pfad des Speicherorts der zentralen Konfigurationsdatei als weiterer Parameter angegeben. Wird der Parameter -SelectConfig verwendet, wird vor dem Start von Docusnap ein Dialog angezeigt, in dem der Pfad zur Konfigurationsdatei ausgewählt werden kann. Anschließend wird Docusnap mit den Einstellungen der ausgewählten Konfigurationsdatei gestartet.

Wenn das Öffnen von Docusnap nicht funktioniert, kann der Parameter -log angegeben werden um Fehlermeldungen in der Kommandozeile auszugeben.

Docusnap-Protokoll

Das Docusnap-Protokoll kann im Explorer oder im Internet Explorer mit docusnap: oder docusnap:// aufgerufen werden. Dabei wird im Hintergrund DocusnapLink aufgerufen, welches dann Docusnap öffnet.

Um den Datenexplorer von Docusnap bis zu einem bestimmten Knoten zu öffnen, wird der ONC angegeben. Dieser Wert wird in folgendem Format angegeben.

docusnap:[1,1]\[1,2]

Beim Aufruf können die zusätzlichen Parameter angegeben werden. Die Parameter werden mit einem & getrennt, das ? trennt den ONC und die optionalen Parameter. Wenn kein ONC angegeben wird, muss das ? nicht vor dem Parameter angegeben werden.

docusnap:[ONC]?Parameter1

docusnap:[ONC]?Parameter1&Parameter2

docusnap:?Parameter1&Parameter2

docusnap:Parameter1&Parameter2

 

docusnap:[1,1]\[1,2]?-SelectConfig

docusnap:[1,1]\[1,2]?-UseConfig&C:\Docusnap\Config.xml

DocusnapLink

Die DocusnapLink.exe wird verwendet, um Docusnap durch ein externes Programm zu starten. Dieses Programm befindet sich nach der Installation von Docusnap im Installationsverzeichnis im Ordner Tools. Dem Programm können Parameter übergeben werden. Als erster Parameter wird -ONC mit dem konkreten ONC-Pfad mit Anführungszeichen angegeben. Anführungszeichen sind notwendig, wenn sich ein Leerzeichen im ONC befindet, damit der richtige Knoten geöffnet werden kann.

Die Parameter -UseConfig und -SelectConfig werden verwendet um Docusnap mit den gewünschten Einstellungen zu starten, falls eine zentrale Konfigurationsdatei verwendet wird. Dabei wird -UseConfig mit dem Pfad des Speicherorts der zentralen Konfigurationsdatei in Anführungszeichen als weiterer Parameter angegeben. Beispielsweise -UseConfig “\sfile01\ita\Docusnap\Configuration.xml”. Um beim Start eine Konfiguration auszuwählen, wird der Parameter -SelectConfig angegeben.

Wenn der Link zu Docusnap nicht funktioniert, kann der Parameter -log angegeben werden, um Fehlermeldungen in der Kommandozeile auszugeben.

Die Parameter für den ONC-Pfad, die Konfiguration und das Logging können in beliebiger Reihenfolge angegeben werden.