Über die BIMcollab-Nexus-Anbindung können Sie Issues zwischen big und einem BIMcollab-Projekt austauschen. Für eine zuverlässige Synchronisation müssen die Verbindung und die Werte der Issue-Felder aufeinander abgestimmt sein.
Voraussetzungen- Ein BIMcollab-Projekt beziehungsweise eine entsprechende BIMcollab-Lizenz ist vorhanden.
- Für die Verbindung wird gegebenenfalls ein API-Key benötigt. Ist Kaulquappe zum BIMcollab-Projekt eingeladen, kann dieser entfallen. Klären Sie die Zugangsdaten mit Ihrer Ansprechperson bei Kaulquappe.
- Öffnen Sie die Projektkonfiguration in big.
- Wechseln Sie zum Tab BCF / BIMcollab und hinterlegen Sie die Verbindungsdaten:
- BCF API URL: Adresse Ihrer BIMcollab-Instanz, beispielsweise
https://DOMAIN.bimcollab.com. - BCF API Client ID und BCF API Client Secret: Fragen Sie Ihre Ansprechperson bei Kaulquappe nach den benötigten Angaben.
- BCF API Projekt ID: Interne ID des BIMcollab-Projekts.
- BCF API URL: Adresse Ihrer BIMcollab-Instanz, beispielsweise
- Konfigurieren Sie bei Bedarf die weiteren Felder:
- BCF API Auto Sync: Synchronisiert Änderungen an Issues von big zu BIMcollab automatisch. Dafür müssen insbesondere die Statuswerte korrekt zugeordnet sein.
- BCF API Auto Sync - Bounding Box: Relevant für Revit-Modelle, die mit Schnittboxen statt unbegrenzten Schnittebenen arbeiten.
- Modelleinheit und BCF API Zieleinheit: Einheiten des Modells in big und des Ziels in BIMcollab.
- BCF API Translation (in Zieleinheit): Versatz auf der X-, Y- und Z-Achse.
- BCF API Rotation: Rotation in Grad, ohne Einheitszeichen.
Die ID und das Secret in den Screenshots sind Beispielwerte. Für Projekte mit unterschiedlichen Modellkoordinaten können Translation und Rotation nötig sein, damit Issues an der richtigen Stelle erscheinen.
BIMcollab-Projekt autorisieren
Nachdem BCF API URL, BCF API Client ID und BCF API Client Secret hinterlegt sind, erfolgt die Autorisierung über das Gesamtmodell:
- Öffnen Sie im Gesamtmodell das Menü mit den drei Punkten und wählen Sie BCF-Export-Sync.
- Melden Sie sich bei BIMcollab an und geben Sie die API-Verbindung frei.
- Wechseln Sie über den Redirect-Link zurück zu big und öffnen Sie BCF-Export-Sync erneut.
Die anschliessende Ermittlung der Kennung für BCF API Projekt ID steht laut Vorlage nur der Rolle KQ Admin zur Verfügung. Lassen Sie sich die Projekt-ID bei Bedarf von Ihrer Ansprechperson bei Kaulquappe bestätigen.
Gleichen Sie vor der ersten Synchronisation die Werte für Status, Priorität, Typ, Tags, Bereiche und Meilensteine zwischen big und BIMcollab ab. Fehlt eine erforderliche Zuordnung, kann ein Issue nicht übertragen werden. Nicht übereinstimmende Werte bei Tags, Bereichen und Meilensteinen können zudem zu Informationsverlust führen, da BIMcollab nur vordefinierte Werte akzeptiert.
- Hinterlegen Sie die Übersetzung der Statuswerte für BIMcollab.
- Ordnen Sie die Werte für Priorität und Typ zu oder passen Sie die entsprechenden Wertebereiche in BIMcollab an.
- Halten Sie die Werte für Tags, Bereiche und Meilensteine auf beiden Seiten synchron.
Issues aus BIMcollab nach big übernehmen: Öffnen Sie im Gesamtmodell das Menü mit den drei Punkten und wählen Sie BCF-Import-Sync. Sie können neue Issues importieren und bestehende aktualisieren (Standard), nur neue importieren oder nur bestehende aktualisieren. Es empfiehlt sich, vor der Arbeit in big zunächst den aktuellen Stand aus BIMcollab abzurufen.
Issues von big nach BIMcollab übertragen: Ist BCF API Auto Sync aktiviert, werden Änderungen von big automatisch an BIMcollab übertragen. Andernfalls oder bei Verzögerungen nutzen Sie im selben Menü BCF-Export-Sync. Beim manuellen Export werden nur die aktuell gefilterten Issues berücksichtigt. Passen Sie die Filter an, wenn weitere Issues exportiert werden sollen.