public class ShowLowlevelGVs extends AbstractShowLowlevelData
Dieses Tool dient zum Anzeigen der Struktur von HBCI-Job-Parametern für das
Erzeugen von Lowlevel-Jobs. Diese Struktur wird benötigt, wenn Jobs über das
Lowlevel-Interface zum Erzeugen und Parametrisieren von Jobs erzeugt werden. Eine
Erklärung des Unterschieds zwischen High- und Lowlevel-Schnittstelle befindet sich
in der Dokumentation des Packages org.kapott.hbci.GV.
Der Aufruf erfolgt durch
java org.kapott.hbci.tools.ShowLowlevelGVs [hbciversion]Ist keine
hbciversion angegeben, so wird diese über STDIN erfragt.
Das Tool gibt eine baumartige Struktur aus, welche die Lowlevelnamen der Geschäftsvorfälle sowie die Bezeichnungen für die dazugehörigen Lowlevel-Parameter enthält. Die Struktur für einen Datensatz beginnt immer mit einer Zeile
jobname:JOBNAME version:VERSIONDabei ist VERSION die Versionsnummer des Lowlevel-Jobs JOBNAME, auf die sich die folgende Strukturbeschreibung bezieht. Die Strukturbeschreibung für einen Job endet bei der nächsten Zeile mit diesem Format bzw. am Ende der Ausgabe.
In den eigentlichen Beschreibungszeilen können Zeilen im Format
GROUP:GROUPNAME {MIN,MAX}
folgen. Damit wird beschrieben, dass jetzt eine Gruppe von zusammengehörigen Jobparametern folgt.
Eine solche Gruppe muss mindestens MIN und darf höchstens MAX mal als Lowlevel-Parameter auftreten.
Alle Zeilen, die nicht mit GROUP: beginnen, haben das Format
LOWLEVELNAME:DATENTYP {MIN,MAX}
LOWLEVELNAME ist dabei der Lowlevelname eines Parameters, wie er beim Setzen von Parametern mit
HBCIJob.setParam(String,String) benutzt werden kann.
DATENFORMAT ist dabei eine Kurzbezeichnung für den Datentyp, den dieser Parameter annehmen kann.
MIN und MAX geben an, wie oft dieser Parameter (in seiner Gruppe) mindestens bzw. höchstens
auftauchen darf.
Folgende Datentypen gibt es zur Zeit:
AN - alphanumerische Daten (Strings)Bin - binäre Daten (meist in einem Fremdformat) Code - wie ANCtr - Länderkennzeichen (meist "DE")Cur - Währungskennzeichen (meist "EUR")DTAUS - Daten im DTAUS-Format (alphanumerische Daten im DTAUS-Zeichensatz)Date - Datumsangaben (in einem Locale-typischen Format)Dig - nur Ziffern (führende Nullen erlaubt) ID - wie ANJN - nur "J" oder "N" (für JA bzw. NEIN) - entspricht also BooleanNum - ganzzahliger numerischer Wert ohne führende NullenTime - Zeitangabe in einem Locale-typischen FormatWrt - Angaben von Double-Werten im Format ab.cd (keine Exp.-Schreibweise!)Innerhalb einer Anwendung kann mit der Methode
HBCIHandler.getSupportedLowlevelJobs()
eine Liste aller unterstützten Lowlevel-Jobs in Erfahrung gebracht werden. Zusätzlich gibt diese
Methode zu jedem Jobnamen die Versionsnummer zurück, welche für diesen Job von HBCI4Java benutzt
werden wird (das hängt von der aktuellen HBCI-Version und dem benutzten Passport ab, kann von
außen also nicht direkt beeinflusst werden). In der Ausgabe dieses Tool kann nun nach einem
bestimmten Lowlevelnamen eines Jobs und der von HBCI4Java dafür verwendeten Versionsnummer gesucht werden.
Ist der entsprechende Eintrag gefunden, so hat man eine Übersicht über alle möglichen
Lowlevel-Jobparameter und wie oft diese auftreten müssen bzw. dürfen.
Die gleiche Übersicht erhält man übrigens, wenn man innerhalb der Anwendung die Methode
HBCIHandler.getLowlevelJobParameterNames(String)
aufruft, allerdings fehlen in der Ausgabe dieser Methode die Informationen über die möglichen
Häufigkeiten der einzelnen Parameter, dafür wird hier automatisch die richtige Versionsnummer
des Jobs ausgewählt.
| Constructor and Description |
|---|
ShowLowlevelGVs() |
| Modifier and Type | Method and Description |
|---|---|
static void |
main(String[] args) |
displayContentRef, pathWithDot, showData, showDataCopyright © 2019. All rights reserved.