Dokumentgenerierung starten

---

primedocs Connect kann sowohl client- als auch serverseitig verarbeitet werden.

Clientseitige Verarbeitung

Dateiendungen

Zwei Dateiendungen sind in Windows mit dem primedocs-Client bereits verknüpft:

Dateiendung	Beschreibung
.pdcx	Beinhaltet primedocs Connect-konformes XML und wird von primedocs direkt (ohne Rückfrage) ausgeführt. Die Datei wird – sofern im XML nicht anders definiert – nach der Dokumenterstellung gelöscht.
.pdck	Gleich wie .pdcx, das k steht aber für keep. Die primedoc Connect-Datei wird nach der Verarbeitung nicht gelöscht.

Erstellt man eine primedocs Connect Datei und benennt diese mit der Dateiendung .pdcx oder .pdck ist diese Datei automatisch mit primedocs verknüpft und kann normal über Windows gestartet werden.

Aufruf über Konsole

Es ist zudem möglich primedocs über die Konsole aufzurufen:

.\primedocs.exe /connect "<path to xml file>"

Alternativ funktioniert auch der Aufruf über den /URI Parameter:

.\primedocs.exe /uri "primedocs:connect=<path to xml file>&keepConnect=true"

Als path to xml file kann ein Dateipfad oder eine URL angegeben werden (siehe Abruf von URL).

warnung

WICHTIG
primedocs löscht nach der Verarbeitung automatisch die Connect-Datei. Wird das zusätzliche Argument /keepConnect übergeben, kann dieses Verhalten unterdrückt werden. Wird via Shell aufgerufen, dann muss die Dateiendung ".pdck" verwendet werden.

URI via Protokoll Handler

Bei der Installation des primedocs desktop Clients wird ein Protkollhandler registriert, welcher den Command Aufruf via URI ermöglicht.

Damit kann primedocs desktop auch aus einem Browser via Link aufgrufen werden.

<a href="primedocs:connect="[path to xml file]">Dokument generieren</a>

Abruf von URL

Wenn eine URL als [path to xml file] startend mit http:// oder https:// angegeben wird, ruft primedocs Desktop diese auf um von dort das Connect-File zu beziehen. Somit kann beispielsweise eine API verwendet werden für die Datenlieferung.

Damit der Aufruf der URL funktioniert muss diese zuvor über die Connect Remote Policies im Admin-Dashboard freigegeben werden. In dieser Einstellung können auch HTTP Header definiert werden für beispielsweise die Übermittlung eines Authentifizierungstokens.

Da die Zeichen & und = als Separator für die Connect-Argumente verwendet werden, sollte die URL encoded werden. Beispielsweise muss die URL
https://api.example.com/connect?token=124AbC&language=de
dem Aufruf als
primedocs:connect=https%3A%2F%2Fexample.com%2Fconnect%3Ftoken%3D124AbC%26language%3Dde
übergeben werden.

Bei Verwendung einer URL wird die Einstellung keepConnect ignoriert.

TemplatePicker

Der TemplatePicker wird angezeigt, wenn:

• kein Template-Element angegeben wurde
• oder der Tag-Filter mehrere Vorlagen hervorbringen würde und AllowTemplatePicker="true" definiert wurde.

---

Serverseitige Verarbeitung

primedocs Connect kann serverseitig über die Web API genutzt werden: Connect API