Mit dem AVACloud Webservice haben Sie eine einfache Möglichkeit, alle Anforderungen von Ausschreibung, Vergabe und Abrechnung (AVA) in Ihrer Python basierten Anwendung abzubilden. In diesem Beispiel sehen Sie, wie Sie einen Authentifizierungstoken von Dangl.Identity erhalten und dann eine GAEB Datei auswerten.
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 Python Client einfach möglich.
Sourcecode des Python - GAEB Projekts
Der Sourcecode für dieses Projekt ist direkt auf GitHub verfügbar. Sie können ihn gleich herunterladen und loslegen.
Projekt Erstellen & AVACloud Client Hinzufügen
Wenn Sie ein neues Projekt erstellen, können Sie den Python Client mit diesem Befehl installieren: pip install git+https://github.com/Dangl-IT/avacloud-client-python.git.
App Entry
Als Eingangspunkt für die Demo dient das Pythonscript hello_avacloud.py.
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:
Die Variablen clientId und clientSecret geben Sie in die dafür vorgesehenen Formularfelder ein. 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.
GAEB Auswertung in Python
Für die Anbindung von GAEB 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 Python 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 Methode zeigt nun exemplarisch, wie Sie das Projektmodell auswerten können:
GAEB in Microsoft Excel Umwandeln mit Python
Eine weitere Möglichkeit zum Arbeit mit GAEB in Python ist das Transformieren von Dateien, zum Beispiel von GAEB nach Excel:
Haben Sie noch Fragen zur Verwendung von AVACloud, um damit in Python schnell und einfach eine GAEB Schnittstelle / Library umzusetzen? Dann kontaktieren Sie uns!