Nach der Dokumentgenerierung (Commands)
- Robert Mühsig
- Dinah Bolli (Unlicensed)
- 1 Commands
- 1.1 Übersicht
- 1.2 Beschreibungen
- 1.2.1 SaveFile (client-only)
- 1.2.2 OpenFile (client-only)
- 1.2.3 InvokeProcess (client-only)
Nach der eigentlichen Dokumentgenerierung können Commands (Befehle) aufgerufen werden. Gewisse Commands können nur im Erfolgsfall (OnSuccess) verwendet werden.
Commands
Die folgende Tabelle führt alle verfügbaren Commands auf und gibt an, ob sie nur client-seitig oder server-seitig verfügbar sind sowie, ob sie nur im Erfolgsfall verwendet werden können.
Übersicht
Command | Beschreibung | Client | Server | Nur im Erfolgsfall |
|---|---|---|---|---|
| Öffnet Office-Dateien mit dem Standardprozess, der in Windows für den Dateityp registriert ist. | ✓ |
| ✓ |
| Speichert das Dokument am angegebenen Zielort im angegebenen Format. | ✓ |
| ✓ |
| Ruft eine externe Anwendung auf. Aus Sicherheitsgründen muss der Prozess vorher konfiguriert werden. | ✓ |
|
|
Beschreibungen
SaveFile (client-only)
Der SaveFile-Command speichert das Dokument am angegebenen Zielort.
Parameter:
Filename: Absoluter Pfad mit Dateiendung
Overwrite: True/False; gibt an, ob eine bestehende Datei überschrieben werden soll.
CreateFolder: True/False; gibt an, ob Ordner, die im Filename angegeben sind, erstellt werden sollen.
<primedocsConnect>
...
<Commands>
<OnSuccess>
<SaveFile Filename="\\MyServer\share\organisation\...\Letter.docx"
Overwrite="true"
CreateFolder="true" />
</OnSuccess>
</Commands>
</primedocsConnect>Wird als Dateiendung .pdf oder .xps angegeben, wird die Datei über Office automatisch in das Zielformat konvertiert.
OpenFile (client-only)
Der OpenFile-Command öffnet Office-Dateien mit dem Standardprozess, der in Windows für den Dateityp registriert ist. Beispielsweise wird die generierte Datei an einem bestimmten Dateiort gespeichert und soll hinterher im Word weiterbearbeitet werden.
Parameter:
Filename: Absoluter Pfad mit Ziel-Dateiendung
<primedocsConnect>
...
<Commands>
<OnSuccess>
<!-- Szenario: -->
<SaveFile Filename="\\MyServer\share\organization\...\Letter.docx"
Overwrite="true"
CreateFolder="true" />
<OpenFile Filename="\\MyServer\share\organization\...\ShortLetter.docx"/>
</OnSuccess>
</Commands>
</primedocsConnect>InvokeProcess (client-only)
Der InvokeProcess-Command ruft eine externe Anwendung auf. Aus Sicherheitsgründen müssen im Dashboard die zulässigen Applikationen zuerst whitelisted werden. Die Konfiguration dafür kann unter Settings → Connect Settings → InvokeProcess - Configuration gefunden werden und sieht ansatzweise wie folgt aus:
<CommandConfig>
<Process name="OurSystemNotepad" executablePath="%systemroot%/notepad.exe" />
<Process name="..." executablePath="..." />
</CommandConfig>Der Aufruf in der Connect-Datei muss mit dem Namen einer zuvor im Dashboard freigegebenen Applikation übereinstimmen.
Parameter:
Name: Konfigurierter Prozessname
Arguments: Argumente für den Prozessaufruf
Der Aufruf kann optional Argumente enthalten und sieht folgendermassen aus:
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland