Anbindung BIMcollab Nexus

Themen in Übersicht:

1. Voraussetzungen
2. Konfiguration
3. BCF Status gesonderte Einstellungen - Übersetzungen
4. Anwendung
5. Oft gestellte Fragen

Voraussetzungen

• Damit Issues zwischen big und BIMcollab Nexus ausgetauscht werden können, bedarf es:
  • eines BIMcollab Projektes bzw. einer Lizenz seitens BIMcollab
  • eines API Keys, sofern Kaulquappe in das BIMcollab Projekt eingeladen ist, ist dieser ggf. nicht erforderlich

Konfiguration

• öffnen der Projektkonfiguration

• Unter der Projekt Konfiguration ist der Tab BCF / BIMcollab zu öffnen
  • BCF API URL: Domainname der BIMcollab Instanz, dieser steht immer als Subdomain vor BIMcollab. z.B.: https://DOMAIN.bimcollab.com.
  • BCF API Client ID:  Fragen Sie hierzu ihren Kontakt bei der Kaulquappe.
  • BCF API Client Secret: Fragen Sie hierzu ihren Kontakt bei der Kaulquappe.
  • BCF API Projekt ID:  Interne Projekt-ID des BIMcollab-Projekts (siehe unten)

• • BCF API Auto Sync: Aktiviert die direkte Synchronisation der Issue von big zu BIMcollab - Achtung die Übersetzungen der Status muss dabei korrekt sein, anderenfalls wird ein Issue nicht synchronisiert.
  • BCF API Auto Sync - Bounding Box (1): Relevant beim Umgang mit Revit Modellen, da Revit mit Schnittboxen anstelle von unendlichen Schnittebenen arbeitet.
  • BCF API Auto Sync - Bounding Box (2): Relevant beim Umgang mit Revit Modellen, da Revit mit Schnittboxen anstelle von unendlichen Schnittebenen arbeitet.
  • Modelleinheit: Definiert die Modelleinheit ab big.
  • BCF API Zieleinheit: Definiert die Zieleinheit für BIMcollab.
  • BCF API Translation (in Zieleinheit): Hier kann der Versatz auf der X-Achse, Y-Achse und Z-Achse definiert werden. 
  • BCF API Rotation: Hier kann die Rotation definiert werden, diese ist in Grad anzugeben - ohne Einheitszeichen.

Hinweis: Dargestellte ID und Secret sind hier nur Beispielwerte!

Für erweiterte BCF Einstellungen, schauen sie unter folgendem Link: BCF Exporteinstellungen

BCF API Projekt ID

Die Projekt ID kann wie folgt extrahiert werden

• Hinterlegung der BCF API URL, BCF API Client ID & BCF API Client Secrets
• Ins Gesamtmodell wechseln, Das Kontextmenü öffnen und BCF-Export-Sync wählen

• Einloggen in BIMcollab
• Freigabe der API Verbindung
• Danach wieder zurück wechseln / Via des Redirect Links zurück wechseln
• Erneut das Kontextmenü öffnen und BCF-Export-Sync wählen
• Im Fenster nun auf der rechten Seite, kann nun die Client ID kopiert werden
  Hinweis: Diese Funktion steht nur Usern der Rolle KQ Admin zur Verfügung.
  

BCF Status gesonderte Einstellungen - Übersetzungen

Damit die Übertragung zu BIMcollab nahtlos funktioniert, muss eine Übersetzung für Status, Priorität, Typ, Tags, Bereiche und Meilensteine eingestellt werden. Sollte in einem Issues einer der vorherigen Translationen nicht definiert worden sein so wird das entsprechende Pendenz nicht in BIMcollab überführt. 

Siehe hierzu im Beitrag Issues unter BCF Status gesonderte Einstellungen - Übersetzungen.

Für den Status sind folgende Einstellungen zu hinterlegen:

Für die Priorität und den Typ sind die Wertebereiche zwischen big und BIMcollab abzugleichen und entsprechend zu mappen oder die Wertebereiche in BIMcollab auf die von big anzupassen.

Für die Tags, Bereiche und Meilensteine sind die Wertebereiche auf big und BIMcollab synchron zu halten. BIMcollab akzeptiert nur vordefinierte Werte. big ist hier flexibler. Bei unabgestimmten Wertebereichen kann es bei der Synchronisation jedoch zu Informationsverlusten kommen.

Anwendung Best-Practice

• Vor Beginn der Arbeit mit den Issues auf big sollte der aktuelle Stand aus BIMcollab bezogen werden. Hierzu können im Gesamtmodell die Issues bidirektional mit BIMcollab synchronisiert werden. Dazu auf die drei Punkte klicken und auf BCF-Import-Sync für den Bezug von Issues ab BIMcollab zu big.
  Hinweis: Beim Import gibt es die Möglichkeit zwischen Neue Importieren / bestehende updaten (Standard), nur neue importieren und nur bestehende updaten.
  
  
• Ist der Auto-Sync aktiviert, werden alle Änderungen automatisch in Echtzeit von big zu BIMcollab synchronisiert. Kommt es hier zu Verzögerungen oder ist der Auto-Sync nicht an, können Issues manuell über die drei Punkte und den Button BCF-Export-Sync von big zu BIMcollab exportiert werden.
  Hinweis: Beim manuellen Export-Sync werden nur die gefilterten Issues exportiert. Passen Sie die Filter an, um weitere Issues zu exportieren.

Besondere Konfigurationen 

• BIMcollab kann aktuell (Dezember 2021) nur Issues in globalen Koordinaten sinnvoll darstellen bzw. zwischen den verschiedenen Plugins synchronisieren. Damit auf big in lokalen Koordinaten bzw. Modellen angelegte Pendenzen auf BIMcollab bzw. in den Autorensoftware (dort werden diese im Revit immer über den Surveypoint Verortet) korrekt dargestellt werden, muss auf big in der Projektkonfiguration noch eine Umrechnungskorrektur (X,Y,Z + Rotation) hinterlegt werden.
• BIMcollab kann so eingerichtet werden, dass nur Issues synchronisiert (d.h. ins BIMCollab geladen) werden, welche exakt der im BIMCollab angelegten Katalogwerten entsprechend. Wenn dies so eingrichtet ist, müssen diese Katalogwerte auf den benötigten Issueattributen exakt gepflegt sein, ansonsten werden diese nicht Synchronsiert! 

Oft gestellte Fragen

• Bei weiteren Fragen, gerne eine Email an: [e-mail]