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. 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.
Der Aufbau ist wie folgend:
[SYS]
HOST=http://192.168.88.11/i-doit
API=1jsedhdw334
USER=admin
PWD=admin
Ab Version 2.6.0.127 stehen zwei weitere optionale Parameter zur Verfügung (0 ist Standard):
PdfExport=0
PdfPreview=0
Normalerweise startet List&Label mit einer Bildschirmvorschau und das kann von dort gedruckt oder gespeichert werden. Beim Speichern wird allerdings immer der Name "preview.pdf" vergeben.
Wird der Wert PdfExport=1 gesetzt, dann wird nicht die Vorschau, sondern ein Auswahldialog angezeigt. Lässt man die Vorschau aus und speichert sofort (als PDF), dann wird ein Dateiname mit der Objektbezeichnung erstellt.
Stehen beide Parameter PdfExport und PdfPreview auf 1, dann wird die PDF Datei nach dem Speichern sofort angezeigt. Das wird dann der Ersatz der Bildschirmvorschau.
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. Wird dieser Wert in Zusammenhang mit dem konfigurierbaren Report verwendet, dann muss bei der Definition des Reports im Feld Beschreibung die dazugehörige Klasse angegeben werden.
- O:basisid ... Bezieht sich die Reportausgabe auf ein konkretes Objekt, dann kann hier dessen ObjektId (C__CATG__GLOBAL) ü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.
Beispiel:
idoit_llrpt.exe V:"UHR\1715" R:61737 D:0 P:1 H:1
ODER
idoit_llrpt.exe O:71860 R:61737 D:0 P:1 H:1
Diese Aufrufe drucken den unter ObjektId 61737 konfigurierten Bericht mit dem Basiswert "UHR\1715" bzw. dessen ObjektId 71860. Die Loginparamter wurden in der ini Datei gespeichert.