...

...

Vorwort

"Build Connector" ist eine App von NEVARIS Finance, die eine Integration mit NEVARIS Build über ODataV4 ermöglicht.
Hierbei wird im "Build Connector" ein Webdienst veröffentlicht der sogenannte "unbound actions" (Funktionen / Endpunkte) bereitstellt, über die alle notwendigen Integrations-Funktionen des abgelösten NAS-Dienstes abgebildet werden. 
Die Kommunikation / Synchronisation von Daten über den bekannten Nevis-Dienst erfolgt ebenfalls über den Webdienst.

Denken Sie daran, die Anwendung BUILD auf den aktuellen Stand 2024.1 zu updaten (auch den Server auf dem NEVIS - Integrationsdienst ausgeführt wird), bevor Sie hier fortfahren.

...

Einrichtung

Für eine vollständige Einrichtung muss lediglich eine Verbindung zum Nevis-Dienst eingerichtet werden. Der Webdienst wird automatisch bei der Installation von "Build Connector" für Sie angelegt und veröffentlicht.  

• Im WebClient suchen Sie bitte nach folgendem Punkt:

...

Alternativ können Sie auch nach "Nevis" suchen.Image Removed

...

Bei der Kommunikation zwischen dem Nevis-Dienst und dem Webdienst wird die Authentifizierungsmethode "oauth2" verwendet. Hierzu benötigt der Nevis-Dienst die "Client-ID":  der in Finance eingerichteten Entra-Anwendung und den jeweiligen Geheimschlüssel:

...

Entra-Anwendung

• Wählen Sie die Client Id der Entra-Anwendung aus, die Sie angelegt haben (Einrichtung Azure AD-Anmeldung - ACS - Finance 2024.1#EntraIDOAuth2.0Anwendungen):

• Tragen Sie den Geheimschlüssel ein, den Sie bei der Einrichtung erhalten haben Einrichtung Azure AD-Anmeldung - ACS - Finance 2024.1#Erl%C3%A4uterungdesSkriptes:

...

Nevis Endpunkt

• Tragen Sie die URL ein, über die der Nevis-Dienst veröffentlicht ist. Im Normalfall (Port kann abweichend sein!): http://NAMEDESSERVERSWONEVISLÄUFT:8201

...

• Tragen Sie den Namen ein, mit dem sich Finance beim Nevis-Dienst anmelden soll. (Dieser ist frei wählbar. Ein sprechender Name ist zu empfehlen)

...

Bei Nevis registrieren

• Führen Sie die Funktion "Bei Nevis registrieren" aus. Hierbei werden neben der Registrierung von Finance alle für die Kommunikation notwendigen Informationen an den Nevis-Dienst übertragen. 

...

• An dem Kennzeichen "In Nevis registriert" können Sie erkennen, ob die Registrierung abgeschlossen ist.

...

Funktionsumfang

Bei Nevis registrieren

...

Sonstige Informationen / Scope anpassen

Verbindungsinformationen

Die Verbindungsinformationen werden bei der Installation / Erstellung der Einrichtung automatisch vorbelegt. In der Regel müssen diese nicht mehr angepasst werden.Image Removed

...

Grant type:

Gibt den "Grant type" an, der bei der Authentifizierungsmethode "oauth2" verwendet wird.

...

Scope anpassen bei Verbindungen mit anderen Produkten (Build Connector, Build-Administration, BfW)

Der Scope setzt sich zusammen aus der Application ID URI der WebClient App-Registrierung und Registrierung und den Berechtigungen .default und offline_access:

Beispiel:  api://XXXXXX-XXXXXX-XXXXX-XXXXX/.default offline_access

Die URI finden Sie in Ihrer AppProperties.json:

Image Modified

Bitte beachten Sie, dass Sie diesen Scope für alle Produkte wie (BfW | Bau für Windows), Build Connector in Finance und auch in der Build-Administration nutzen. Ansonsten ist keine Kommunikation möglich. Für weitere Informationen konsultieren Sie bitte die Anleitungen der anderen Produkte.

Webdienst

Die ODataV4 Basis URL wird bei der Installation / Erstellung der Einrichtung automatisch vorbelegt. In der Regel muss diese nicht mehr angepasst werden.Image Removed

...

Webdienst aktiviert:

...

Expand
title API-Berechtigungen Entra
Falls folgender Fehler bei der Prüfung der OData-Schnittstelle als Antwort zurück kommt, (vorher immer mit Postman eine Testabfrage stellen!) Bspw: https://FINANCESERVERMITMITTELSCHICHT:ODATAPORTDERINSTANZ/INSTANZNAMEMITODATA/api/nevaris/finance/v2.0/companies (https://finance:7048/BAU/api/nevaris/finance/v2.0/companies). Fehler Code Block language js title Fehler { "error": { "code": "Unknown", "message": "One or more errors occurred. ('.', hexadecimal value 0x00, is an invalid character. Line 9128, position 15.) CorrelationId: " } } dann liegt das an der fehlenden Berechtigung in der App-Registrierung (AIO ..): Image Removed Image Added Diese bitte ergänzen.

Gehen Sie nun zurück zur Hauptseite und folgen der weiteren Anleitung
NEVARIS Finance Version 2024.1