Table of Contents

...

"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.

...

• 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)

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 den Berechtigungen .default und offline_access:

Beispiel: api://XXXXXX-XXXXXX-XXXXX-XXXXX/.default offline_access
Die URI finden Sie in Ihrer AppProperties.json:
Image Removed
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.

Mögliche Fehler

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).

{
    "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

Diese bitte ergänzen.

• 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

Registriert Finance beim Nevis-Dienst. Ist nur möglich, wenn der Webdienst veröffentlicht ist. (Ermöglicht zum Beispiel die Synchronisation von Daten zwischen NEVARIS Build und Finance)

...

Gibt den "Scope" an, der bei der Authentifizierungsmethode "oauth2" verwendet wird. Dieser muss angepasst werden, folgen Sie dem unteren Punkt.

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 den Berechtigungen .default und offline_access:

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

Die URI finden Sie in Ihrer AppProperties.json:

Image Added

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.

...

Vollständige ODataV4 URL zum synchronisieren von Daten zwischen Finance und Build. (Verwendet vom Nevis-Dienst)

Mögliche Fehler

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).

{
    "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 Added

Diese bitte ergänzen.