Skripte und API
für eigene Abläufe
Das Gewicht der Fertigteile steht im Modell nirgends, und beim nächsten Stand fehlt es wieder. Ein Skript rechnet solche Werte einmal an jedes Bauteil und beim neuen Modellstand gleich noch einmal.
Was sind Skripte und API in C24BIM?
Skripte in C24BIM nehmen Ihnen Arbeit ab, die in jedem Projekt wiederkommt. Das kann ein Wert an jedem Bauteil sein, ein LV aus einer Datei oder die Zuweisung nach eigenen Regeln. Für einfache Werte reicht ein Ausdruck mit Platzhaltern, für größere Abläufe schreiben Sie JavaScript. Dahinter steht die Bridge-API, über die Skripte und eigene Seiten im Projekt arbeiten, von der Auswahl im Modell bis zur Position im LV.
Wann lohnt sich ein Skript?
Mittwoch früh, Kranplanung für den Rohbau. Die Arbeitsvorbereitung braucht das Gewicht jeder Fertigteilstütze, aber im Modell steht nur das Volumen. Also geht eine Liste nach Excel, dort kommt die Dichte dazu, und das Ergebnis landet in einer Tabelle neben dem Modell.
Am Freitag schickt der Planer den nächsten Stand, und die Tabelle passt nicht mehr. Die Mail mit der Bitte, das Gewicht im Modell zu ergänzen, bringt frühestens mit dem übernächsten Stand etwas, und die Kranplanung wartet nicht so lange.
Ein Eigenschaftsskript legen Sie einmal an: Volumen mal Dichte, Ziel ist die Eigenschaft Gewicht. Es läuft bei jedem neuen Modellstand von selbst, und der Wert steht wieder an jeder Stütze. So ergänzen Sie fehlende Bauteilangaben selbst, ohne auf den Planer zu warten.
Was Skripte und API in C24BIM möglich machen
-
Fehlende Werte selbst rechnen
Ein Ausdruck mit Platzhaltern, zum Beispiel Volumen mal Dichte, schreibt für jedes Bauteil einen Wert in eine Eigenschaft Ihrer Wahl. Programmieren muss dafür niemand.
-
Beim nächsten Modellstand von selbst
Eigenschaftsskripte laufen beim Öffnen des Projekts oder beim Hinzufügen eines Modells. Der neue Stand kommt, die Werte stehen wieder da.
-
Größere Abläufe in JavaScript
Ein Projektskript liest und ändert Bauteile, legt ein LV aus einer GAEB-Datei an oder weist Bauteile nach Ihren Regeln zu. Mitgelieferte Beispiele geben den Einstieg vor.
-
Eigene Formeln für den Mengenansatz
Mengenfunktionen, die Sie selbst schreiben, stehen jedem Mengenansatz offen, also jeder Formel, mit der eine Position ihre Menge rechnet.
-
Eigene Eingabemaske im Projekt
Eine eigene Seite im Bereich Formular wählt Bauteile aus, färbt die Ansicht ein und ändert Positionen im LV. Der Ablauf Ihrer Arbeitsvorbereitung bekommt so eine Maske, die genau zu ihm passt.
-
Einmal gepflegt, überall verfügbar
Skripte liegen zentral in Content und gehen von dort in jedes Projekt.
So bringen Sie ein Skript ins Projekt
-
Vorlage nehmen
Ein Beispielskript aus dem Demo-Projekt oder ein Skript aus Content kommt ins Projekt.
-
Anpassen
Sie tragen im Editor Ihre Eigenschaften, Filter und Positionen in Ausdruck oder Code ein.
-
Freigeben
Vor dem ersten Lauf bestätigen Sie die Freigabe für dieses Projekt und diesen Code-Stand.
-
Ergebnis prüfen
Die Statusleiste meldet, was das Skript getan hat, und die neuen Werte stehen in den Eigenschaften der Bauteile.
Die Vorteile
im Detail:
Projektskripte für alles, was ein Ausdruck nicht schafft
Soll ein Skript ein ganzes LV aus einer GAEB-Datei anlegen oder Bauteile nach mehreren Bedingungen zuweisen, reicht ein Ausdruck nicht mehr. Dann schreiben Sie ein Projektskript in JavaScript, direkt im Code-Editor der App. Es greift auf alles zu, was die Bridge-API anbietet: Bauteile und Eigenschaften, Mengen und Formeln, Filter, LV und Abrechnungsregeln, dazu Bauteillisten, Kollisionsprüfung, BCF-Topics und die Begehung. Die Methoden heißen nach einem festen Schema aus Verb und Nomen, und die Beschreibung jeder Methode steht in der App im Info-Dialog unter Entwickler.
Was das Skript erledigt hat, meldet es in der Statusleiste. Mitgeliefert sind drei Beispiele zum Anpassen: der Umfang je Bauteil, ein GAEB-LV einlesen und anlegen, eine eigene Projektseite für die Zuweisung von Bauteilen.
Ein Eigenschaftsskript rechnet, was im Modell fehlt
Das häufigste Skript ist das kleinste. Ein Ausdruck mit Platzhaltern für vorhandene Werte, etwa das Volumen eines Bauteils, rechnet einen neuen Wert und schreibt ihn in eine Ziel-Eigenschaft. Volumen mal Dichte ergibt das Gewicht für die Kranplanung, und zwar an jeder Stütze einzeln.
Als Auslöser wählen Sie das Öffnen des Projekts oder das Hinzufügen eines Modells. Kommt der nächste Stand vom Planer, stehen die Werte ohne weiteren Klick wieder an den Bauteilen. Gespeichert wird im Projekt von C24BIM, die IFC-Datei bleibt, wie sie vom Planer kam.
Eine eigene Seite im Projekt, die zu Ihrem Ablauf passt
Manche Arbeit läuft in der Arbeitsvorbereitung immer gleich: Bauteile eines Bauabschnitts auswählen, einfärben, einer Position zuweisen, weiter zum nächsten. Dafür binden Sie im Bereich Formular eine eigene Seite ein, als lokale Projektseite am Desktop oder als Adresse im Netz.
Über die Bridge-API wählt die Seite Bauteile aus, färbt die Ansicht mit Legende ein und liest Mengen und Formeln. Sie ändert Positionen im LV, setzt Filter und erzeugt GAEB-Dateien. Die Bereiche der App bleiben, nur dass Ihr Ablauf jetzt auf einer Seite steht.
Jeder Code läuft erst nach Ihrer Freigabe
Bevor ein Skript zum ersten Mal läuft, fragt die App nach Ihrer Freigabe, je Projekt und je Code-Stand. Ändert sich der Code, fragt sie erneut. Danach arbeitet das Skript mit denselben Rechten wie die App selbst, deshalb geben Sie nur Code frei, dessen Herkunft Sie kennen.
Eine eingebundene Seite aus dem Netz braucht je Herkunft die Freigabe, auf das Projekt zuzugreifen. Seiten dürfen keinen Code schreiben, und Methoden mit großer Wirkung fragen vor der Ausführung noch einmal nach.
Nutzen für die Beteiligten
-
Arbeitsvorbereitung
Das Gewicht je Fertigteil steht für die Kranplanung am Bauteil, auch wenn der Planer es nie modelliert hat.
-
Kalkulation
Ihre Formeln greifen auf eigene Mengenfunktionen zu und rechnen Mengen, die der Standard nicht vorsieht.
-
BIM-Koordination
Fehlende Angaben ergänzt sie in jedem neuen Modellstand automatisch, statt den Planer jedes Mal um Nachbesserung zu bitten.
Aus der Praxis
Mittwoch, 7:30 Uhr, Arbeitsvorbereitung für den Rohbau einer Wohnanlage in Hildesheim mit Fertigteilstützen. Für die Kranplanung fehlt das Gewicht jeder Stütze, im Modell steht nur das Volumen. Die BIM-Koordination legt ein Eigenschaftsskript an: Volumen mal 2,5, Ziel ist die Eigenschaft Gewicht in Tonnen. Als Auslöser wählt sie das Hinzufügen eines Modells. Als am Freitag der neue Stand kommt, filtert die Arbeitsvorbereitung alle Stützen über fünf Tonnen, ohne dass jemand nachgerechnet hat.
Bestandteil von C24BIM
Skripte greifen auf dieselben Filter, Mengenansätze und Prüfregeln zu wie die Mengenermittlung und die Modellprüfung. Wer den Ausdruck nicht selbst schreiben will, lässt ihn sich vom KI-Assistenten vorschlagen und prüft ihn vor dem ersten Lauf. Der Assistent arbeitet selbst über dieselben Methoden der Bridge-API, und was er kann, kann auch ein Skript. Über den Agenten-Zugang steht dieselbe Bridge-API auch Claude auf Ihrem Rechner offen, mit denselben Rechten wie ein Projektskript.
Wenn Sie einen Ablauf haben, den Sie in jedem Projekt von Hand wiederholen, schauen wir gemeinsam, ob ein Skript ihn übernimmt. Schreiben Sie uns.
FAQ
Muss ich programmieren können?
Für Eigenschaftsskripte reicht ein Ausdruck mit Platzhaltern, etwa Volumen mal Dichte. JavaScript brauchen Sie erst für Projektskripte und eigene Seiten, und dort helfen die Beispiele und der KI-Assistent.
In welcher Sprache schreibe ich Projektskripte?
In JavaScript, als Funktion run, die die Bridge-API übergeben bekommt. Der Code-Editor ist in C24BIM eingebaut.
Was kann ein Skript im Projekt alles ändern?
Alles, was die Bridge-API anbietet, und das sind über 170 Methoden in 21 Gruppen. Dazu gehören Eigenschaften an Bauteilen, die Ansicht samt Begehung, Mengen und Formeln, das LV samt GAEB, Filter und Auswahlmengen, Bauteillisten, Abrechnungsregeln, Prüfregeln, Kollisionsprüfung, BCF-Topics, Terminplan und Content-Pakete.
Kann auch Claude auf meinem Rechner die Bridge-API nutzen?
Ja, über den Agenten-Zugang in der Desktop-App. Claude Desktop, Claude Code oder ein anderer MCP-Client ruft dann dieselben Methoden auf wie ein Projektskript, und vor dem Löschen oder einem Import fragt C24BIM nach.
Wo finde ich die Beschreibung der Bridge-API?
In der App, im Info-Dialog unter Entwickler, sobald die Lizenz aktiv ist. Dort steht jede Methode mit ihren Parametern, nach Gruppen geordnet und mit demselben Namensschema aus Verb und Nomen.
Wann läuft ein Skript zum ersten Mal?
Erst nach Ihrer Freigabe. Die App fragt je Projekt und Code-Stand nach, bei geändertem Code erneut. Danach läuft das Skript mit den Rechten der App, deshalb geben Sie nur Code frei, dessen Herkunft Sie kennen.
Wo liegen die Werte, die ein Skript gerechnet hat?
Im Projekt von C24BIM, an jedem Bauteil als Eigenschaft. Die IFC-Datei vom Planer bleibt unverändert, und beim nächsten Modellstand rechnet das Skript die Werte wieder dazu.
Was passiert beim nächsten Modellstand mit den gerechneten Werten?
Ein Eigenschaftsskript mit dem Auslöser Hinzufügen eines Modells rechnet sie neu. Alternativ läuft es jedes Mal beim Öffnen des Projekts.
Kann ich eine eigene Webseite einbinden?
Ja, im Bereich Formular, als lokale Projektseite am Desktop oder als Adresse im Netz. Eine Seite aus dem Netz braucht je Herkunft Ihre Freigabe, auf das Projekt zuzugreifen.
Laufen Skripte auch in der Web-Version?
Ja, im Browser unter app.c24bim.de laufen Skripte genauso. Eigene Seiten binden Sie dort als Adresse im Netz ein, am Desktop zusätzlich als lokale Projektseite.
Wie bekommen alle Projekte der Firma dasselbe Skript?
Über Content. Dort pflegen Sie das Skript einmal und übertragen es in die Projekte, bestehende Skripte aus Projektdateien importieren Sie dorthin.