Mit dem AVACloud Webservice haben Sie eine einfache Möglichkeit, alle Anforderungen von Ausschreibung, Vergabe und Abrechnung (AVA) in Ihrer Java basierten Anwendung abzubilden. In diesem Beispiel sehen Sie, wie Sie einen Authentifizierungstoken von Dangl.Identity erhalten und dann eine GAEB Datei nach Excel konvertieren sowie eine kurze Auswertung des Gesamtpreises und der Anzahl der Positionen durchführen.
Andere Fälle, wie z.B. das Konvertieren von GAEB zu GAEB, das Erstellen einer neuen GAEB Datei oder weitere Auswertungen und die Umwandlung zwischen GAEB und dem einheitlichen Dangl.AVA Projektsystem folgen dem selben Prinzip und sind mit dem AVACloud Java Client einfach möglich.
Sourcecode des Java - GAEB Projekts
Der Sourcecode des gesamten Projekts ist auf GitHub verfügbar. Sie können es gleich herunterladen und loslegen. Sie benötigen nur ein aktuelles Java JDK sowie Maven.
Projekt Erstellen & AVACloud Client Hinzufügen
Wenn Sie ein neues Java Projekt erstellen können Sie direkt den Quellcode des AVACloud Java Clients hinzufügen. Sie benötigen zusätzlich folgende Projektabhängigkeiten:
Client Authentifizierung
Die Authentifizierung von AVACloud basiert auf OpenID und nutzt JSON Web Tokens (JWT), um API Aufrufe zu autorisieren. Falls Sie es noch nicht getan haben, können Sie sich bei Dangl.Identity als Entwickler registrieren und 30 Tage kostenlosen Zugang zur AVACloud erhalten. Sollten Sie eine längere Testphase benötigen, sprechen Sie uns bitte einfach an.
Im nächsten Schritt bauen wir eine Funktion, die sich mittels der Client Credentials Methode bei Dangl.Identity anmeldet und Zugriff auf AVACloud gibt:
Sie können für die Implementierung der Authentifizierung auch jede kompatible OpenID Connect (OIDC) Library nutzen.
Der Vorgang ist überschaubar - Sie senden Ihre ClientId und Ihr ClientSecret an den Token-Endpunkt von Dangl.Identity https://identity.dangl-it.com/connect/token und erhalten einen 60 Minuten lang gültigen access_token zurück.
Zuletzt wird noch die Authentifizierung der Clientklassen konfiguriert:
GAEB zu Excel Konvertierung
Die erste Aufgabe der Beispielanwendung ist es, eine GAEB Datei mittels AVACloud in eine Microsoft Excel Arbeitsmappe zu transformieren. Auf die gleiche Art und Weise können Sie auch alle anderen Konvertierungen durchführen - zum Beispiel um GAEB Dateien zu reparieren oder in ein anderes Format zu transferieren.
GAEB Auswertung in Java
Noch nützlicher als das Konvertieren ist für viele Kunden von DanglIT die Umwandlung beliebiger GAEB Dateien in das vereinheitlichte Dangl.AVA Projektmodell. Für die Anbindung an Ihr System müssen Sie nicht mehr alle verschiedenen GAEB Formate und Versionen unterstützen - Sie erhalten eine Programmierschnittstelle zur Integration von GAEB in Ihre Java Anwendung.
Es ist völlig egal, welche Art von GAEB Dateien Sie haben - AVACloud erkennt vollautomatisch den Typ und liefert Ihnen ein einheitliches Datenmodell der GAEB Struktur zurück. Die Methoden getProjectTotalPrice() und getProjectPositionCount() zeigen nun exemplarisch, wie Sie das Projektmodell auswerten können:
Haben Sie noch Fragen zur Verwendung von AVACloud, um damit in Java schnell und einfach eine GAEB Schnittstelle / Library umzusetzen? Dann kontaktieren Sie uns!