Nachdem Reports in i-doit definiert wurden, können diese verwendet werden.
Dazu wurde mit dem Modul "SM-VIEW List&Label" eine Datei idoit_llrpt.exe installiert. Diese dient als Schnittstelle zwischen i-doit und List&Label. Dort werden die Daten entsprechend der Definition aufbereitet und zu einer List&Label Druckdatei übertragen. Die Druckdatei muss dafür entsprechend konfiguriert sein, also die bereitgestellten Datenfelder beinhalten. Die Erstellung einer Druckdatei wird an anderer Stelle behandelt.
Die Schnittstelle kann zur Konfiguration und Fehlersuche direkt gestartet werden. Für die Ausgabe über SM-VIEW wird die Schnittstelle mit Parametern gestartet und nach dem Druck automatisch geschlossen.
Start - Parameter
Das Programm kann mit Parametern gestartet werden. Zum einen beim Aufruf und zum anderen durch eine Konfigurationsdatei.
Konfiguration per Datei
Liegt neben dem Programm die Datei idoit_llrpt.ini, dann werden zum Programmstart die dort konfigurierten Werte übernommen. Der Aufbau ist wie folgend:
[SYS]
HOST=http://192.168.88.11/i-doit
API=1jsedhdw334
USER=admin
PWD=admin
Hier kommen die Anmeldeangaben des i-doit - Systems hinein. Die Angaben für Host und API können bei einem manuellen Start in der Oberfläche geändert werden. Das macht Sinn, falls schnell zwischen Test- und Produktivsystem umgeschaltet werden soll.
Konfiguration per Startparameter
Die Schnittstelle kann auch von der Kommandozeile mit Parametern gestartet werden. Strings sollten in Anführungsstriche " eingeschlossen sein.
idoit_llrpt.exe [S:servername] [A:apikey] [U:username] [W:password] [R:reportobjid] { [V:basiswert] | [O:basisid] } [D:designer] [P:print] [H:hide]
- S:servername ... i-doit Servername. Kann durch Konfigurationsdatei voreingestellt werden, kann in der Oberfläche überschrieben werden
- A:apikey ... i-doit API-Key. Kann durch Konfigurationsdatei voreingestellt werden, kann in der Oberfläche überschrieben werden
- U:user ... Loginname des Benutzers, der aus i-doit über die API zugreifen darf.
- W:password ... Passwort des Benutzers, der aus i-doit über die API zugreifen darf.
- R:reportobjid ... ObjektId der Reportdefinition. Diese Angabe ist bei automatischer Ausführung über die Kommandozeile anzugeben. Der Wert kann in der Oberfläche geändert werden.
- V:basiswert ... Bezieht sich die Reportausgabe auf ein konkretes Objekt, dann kann hier der Wert übergeben werden. Er kann in der Oberfläche überschrieben werden.
- O:basisid ... Bezieht sich die Reportausgabe auf ein konkretes Objekt, dann kann hier dessen ObjektId übergeben werden. Ist dieser Wert gesetzt, wird ein mit V übermittelter Wert ignoriert.
- D:designer ... 1 oder 0 (default). Ist der Wert 1, dann wird anstelle des Berichts der Berichtsdesigner geöffnet. Die Daten werden auch hier übergeben, so dass eine Designanpassung mit visueller Kontrolle möglich ist. Macht nur Sinn bei Kommandozeilenaufruf, in der Oberfläche gibt es dafür einen Aktionsbutton.
- P:print ... 1 oder 0 (default). Ist der wert 1, dann wird der Bereicht sofort zum Druckt geöffnet. Macht nur Sinn bei Kommandozeilenaufruf, in der Oberfläche gibt es dafür einen Aktionsbutton.
- H:hide ... 1 oder 0 (default). Ist der Wert 1, dann wird die Oberfläche nicht angezeigt. Ist zu empfehlen bei Kommandozeilenaufruf.