Befehle
Kommandos sind entweder unabhängig oder abhängig von einem Subjekt. Sie unterliegen folgender Syntax:
COMMAND(Parameter1, Parameter2, …)
Subjekt-unabhängige Befehle
Befehl | Inhalt | Beispiel |
DefineProject(Projektname, Projektnummer) | Definiert das Projekt. |
CODE
|
DefineProjectSection(Abschnittsname, Abschnittsnummer, Projektname) | Definiert den Abschnitt im Projekt |
CODE
|
DefineProjectStage(PFAName, PFANummer, Abschnittsname) | Definiert den PFA des Abschnitts | |
DefineProjectPhase(Projektphase) | Definiert eine Projektphase | |
DefineProjectSubPhase(Projektsubphase) | Definiert eine Projektsubphase | |
DefineCost(Kostenkennwertname, Kostenkennwertnummer, Ausprägungsnummer, Ausprägungsfaktor, Kostenmessmethode, Kostenansatz) | Definiert einen Kostenkennwert (z.B. nach DB-Bahn-Richtlinie RiLi808). Kostenmessmethode siehe Befehle | Kostenmessmethoden:, Kostenansatz in €/[Kostenmessmethode] Die Kosten an einem Objekt werden anschließend mit dem Befehl SetCost verknüpft (siehe unten). |
CODE
Kostenkennwert Schwellen von 150€ pro Stück.
CODE
Kostenkennwert Schotter von 25.0€ pro m³ |
DefineColor(Farbname, Rot, Grün, Blau, Alpha) | Farbe mit Ganzzahlwerten (0 bis 255) für Rot, Grün, Blau und Transparenzgrad (255=voll sichtbar) | |
DefineMaterial(Materialname, Belastungsklasse, Dichte, Wichte, Elastizitätsmodul) | Materialdefinition | |
DefineGroup(Gruppenname, Gruppenkürzel) | Gruppendefinition mit Kürzel erzeugen | |
CreateMapping(AfilenameIn, AfilenameOut); | Erstellt eine Mapping.xml auf Grundlager einer CSV. Die CSV hat folgenden Aufbau:
CODE
wobei SourceFamily dem PropertySet des IN-going (IFC), SourceName dem Property des IN-going (IFC) und TargetFamily der KorFin-Kategorie und TargetName dem KorFin-Attribut entspricht. |
Kostenmessmethoden
Kostenmessmethode | ||
1 | Stück | # |
2 | Länge | m |
3 | Fläche | m² |
4 | Volumen | m³ |
5 | Pauschale | 1 |
Subjekt-abhängige Befehle
Befehl | Inhalt | Beispiel |
SetProject(Projectstage, Projectsection, Project) | Zuweisung zu einem PFA, Abschnitt oder Projekt. Es sollte nur eins angegeben werden – und zwar das “Höchstwertige”. |
CODE
|
SetProjectRange(Station von, Station bis) | Zuweisung zu einem Projektstationsbereich. | |
SetProjectPhase(Projectphase, Projectsubphase) | Zuweisung zu einer Projektphase und/oder Projektsubphase. | |
SetStock | Zuweisung zur Projektphase Bestand (Stock). | |
SetPlanning | Zuweisung zur Projektphase Planung (Planning). | |
SetDemolition | Zuweisung zur Projektphase Abbruch (Demolition). | |
SetOnce | Setzt die Anzahl 1. | |
SetCount SetCountSub | Berechnet und definiert die Anzahl der Instanzobjekte (wie bei Schwellen). “Sub” schließt die untergeordnete Struktur ein. | |
SetLength | Berechnet und definiert die Länge. | |
SetArea SetAreaFusion SetAreaSub SetAreaSubFusion | Berechnet und definiert die Lageplanfläche. Sub schließt die untergeordnete Struktur ein. Fusion überlagert alle Teilflächen und berechnet eine Gesamtfläche ohne Doppelungen. Die Funktionen SetAreaSub und SetAreaSubFusion stehen ab Version 4.8.0 nicht mehr zur Verfügung. Beim Attribuieren des Bahnsteigs wird automatisch die Lageplanfläche und nicht die Addition der einzelnen Flächen in die BIM-Daten geschrieben. | |
SetVolume SetVolumeSub | Berechnet und definiert das Volumen. “Sub” schließt die untergeordnete Struktur ein. Das Volumen wird nur dann gesetzt, wenn es ein korrektes Volumen ohne Fehler ist. | |
SetWeight | Berechnet das Gewicht aus den Angaben des spezifischen Gewichts in der Reihenfolge pro Volumen, pro Fläche oder pro Länge. Die Berechnung erfolgt bei der Definition des ersten spezifischen Gewichts. | |
SetCost(Kostenkennwertname, Kostenwert) | Berechnet die Kosten entsprechend des angegebenen Kostenkennwertnamens. Der Kostenkennwert muss vorher vorliegen. Dieser kann mit dem Befehl DefineCost (siehe oben) angelegt werden. Bei Angabe eines spezifischen Kostenwerts erfolgt keine Berechnung, sondern es wird dieser direkt übernommen. Der spezifische Kostenwert wird in der Regel nur bei pauschalen Kostenkennwerten verwendet. |
CODE
Ausgeführt auf einem Schwellenobjekt werden erst die Anzahl der Schwellen berechnet und anschließend die Kosten entsprechend des Kostenkennwerts “Schwellen” ermittelt. Das Komma für den nicht angegeben Kostenwert muss vorhanden sein. |
SetMaterial(Materialname) | Material zuweisen | |
SetBuildingMaterial(Materialname) | Baumaterial zuweisen. Das Baumaterial muss im Projekt unter diesem Namen verfügbar sein. | |
SetAccident(Unfall, Tabelle.csv) | Reichert den Unfallpunkt mit Namen Unfall mit den Unfalldaten aus der externen Tabelle an. | |
Generate2DBoundary(Dateiname) | Erstellt eine 2D-Umgrenzungslinie vom aktuellen Inhalt und speichert diese unter dem angegebenen Dateinamen ab. | |
DeleteGroup(Index) DeleteGroups | Entfernt die Gruppe mit dem Index. Index = 0 löscht alle Gruppen oder alle LV-Positionen. | |
SetGroup(Gruppe, Index) | Gruppe mit Namen Gruppe an Speicherstelle Index (1-10) zuweisen Index = 0 fügt die Gruppe im nächsten freien Feld hinzu. | |
UpdateLVPositions | LV-Positionen aus der Vernetzung im Fachobjekt aktualisieren. Ab Version 4.8. Die Attribuierung von LV-Positionen der LV-Ebene am Fachobjekt ist datentechnisch falsch und wird nur für die Erstellung von Liefergegenständen hier durchgeführt. | |
UpdateCycleTasks | Vorgänge des Bauterminplans aus der Vernetzung im Fachobjekt aktualisieren. Ab Version 4.8. Die Attribuierung von Vorgängen der 4D-Ebene am Fachobjekt ist datentechnisch falsch und wird nur für die Erstellung von Liefergegenständen hier durchgeführt. | |
SetDocument(Pfad, Pfadvariable, Unterverzeichnisse) | Verknüpft die Objekte mit Dokumentenverweisen unter möglicher Verwendung der Pfadvariable. Bei Unterverzeichnisse = true werden Unterverzeichnisse eingeschlossen. Ab Version 4.7.2 kann auch eine Datei anstatt eines Verzeichnisses angegeben werden. Für Ordner muss der Pfad mit Backslash abgeschlossen werden. | |
RemoveDocuments() | Entfernt alle mit dem Objekt verbundenen Datenobjekte von Dokumenten und die Kategorie DOCUMENTS. |
CODE
|
SetParent(FullName) | Setzt das übergeordnete Element mit Namen FullName (Pfad mit Namen oder Pfad). | |
SetConfidence(Level) | Setzt das Vertrauenslevel (0-100%). | |
SetColor(Color) | Setzt die Farbe (mit angegebenem Namen). | |
SetID(Index, NameID, ID, URL) | ID mit Index (1-3) mit Quelle NameID und optionaler URL setzen | |
SetName("Attribut, Attribut, …") | Setzt den Objektnamen aus einem Attributwert von alternativen Attributen. | |
Rename(“Search”, “Replace”, uppersearch) | Ersetzt den Teil des Objektnamens in “Search” durch “Replace”. Bei Uppersearch erfolgt die Suche in Großbuchstaben (nicht case sensitive). | |
SetTransform(„TransformDefinition“) | Setzt die Transformation der angegebenen Transformationsdefinition am Fachobjekt. | |
SetFloor(„Etagencode“) | Setzt die Etage am Fachobjekt. |
Befehle für den Import und Export
Befehl | Inhalt |
ExportSelection3D(Dateiname, Range, ks, combine, symbols, instances, Attributexport, Rekursionstiefe, BIM-Mappingdateiname, GIS-Mappingdateiname) ExportObject3D(Dateiname, Range, ks, combine, symbols, instances, Attributexport, Rekursionstiefe, BIM-Mappingdateiname, GIS-Mappingdateiname) | Exportiert den Inhalt der aktuellen Selektion oder des aktuellen Subjekts als IFC/OBJ/DXF/LandXML und speichert als externe Datei unter Dateiname ab.
Die Rekursionstiefe und das Mapping von BIM-Attributen ist ab KorFin Version 4.7.2 verfügbar. Das Mapping von GIS-Attributen ist ab KorFin Version 4.8 verfügbar. |
Befehle für die Attribuierung
(Um-)Parametrisierung wird als Befehl ausgeführt. Das Ergebnis wird direkt in das Fachobjekt geschrieben:
Befehl | Inhalt | Beispiel |
CSVEXPORT(Dateiname.csv [, optional Kategorienname]) | Exportiert alle BIM-Attribute in die Datei „file.csv“. Die Attribute werden optional auf Kategorien beschränkt, z.B. „Basis“. Exportiertes CSV-Schema: Schema BIM Attributes (ab Version 4.7.2) . |
CODE
Ab Version 4.7.2: Im CSV-Import und -Export erscheint eine Extra-Spalte für die Kategorie. Details BIM-Attributsystem in KorFin®. |
CSVIMPORT(Dateiname.csv) | Befüllt alle Attribute mit Werten aus der CSV-Datei und reichert die gewählten Objekte (angegeben über die Datenobjekt ID des Fachobjektes) damit an. Die Verknüpfung zu den Objekten erfolgt über die „Guid“ Spalte. Zur Gruppierung von Attributen innerhalb von Kategorien können Attributgruppen verwendet werden. Diese werden durch “Attributgruppe\Attributname“ im Attributnamen definiert. Der Zugriff auf diese Attribute erfolgt immer über den kompletten Attributnamen inkl. der Attributgruppe. Notwendiges CSV-Schema: Schema BIM Attributes (ab Version 4.7.2) . |
CODE
Ab Version 4.7.2: Im CSV-Import und -Export erscheint eine Extra-Spalte für die Kategorie. Details BIM-Attributsystem in KorFin®. Schemadefinition: Schema BIM Attributes (ab Version 4.7.2) . |
ExtendAttributes(Dateiname.csv) | Importiert alle Attribute aus der CSV-Datei und reichert alle ausgewählten Objekte mit den Kategorien der Attribute an. Attributgruppen werden durch “Attributgruppe\Attributname“ im Attributnamen definiert. Notwendiges CSV-Schema: Schema BIM Attributes (ab Version 4.7.2) . | |
AddCategory(„Family“) | Fügt die Familie “Family“ zum FO hinzu. Die Familie muss vorher definiert oder eine systemeigene Familie sein. | |
DeleteCategory(“Kategorie”) | Löscht die Kategorie mit angegebenem Namen. |
CODE
|
DeleteAttribute(“Attribute”) | Löscht das Attribut mit angegebenem Namen. |
CODE
|
EnsureAttribute(Code, "Attribut, Attribut, …") | Stellt sicher, dass mindestens ein Attribut der Menge definiert ist und kodiert die Anmerkung mit dem Code. |
CODE
|
SetParameter("Parameter, Wert, Parameter, Wert, …") | Schreibt bekannte ParameterBefehle | Parameter:in das Fachobjekt. |
CODE
|
SetAttributeUString( Attribut, Wert ) | Setzt den Wert eines Attributs vom Typ “Text” auf einem Fachobjekt. Ab Version 4.7.1. |
CODE
|
SetAttributeFloat64( Attribut, Wert ) | Setzt den Wert eines Attributs vom Typ “Zahl” auf einem Fachobjekt. Ab Version 4.7.1. |
CODE
|
SetAttributeBool( Attribut, Wert ) | Setzt den Wert eines Attributs vom Typ “Bool” auf einem Fachobjekt. Ab Version 4.8.0. |
CODE
|
SetAttributeEnum( Attribut, Wert ) | Setzt den Wert eines Attributs vom Typ “Enum” auf einem Fachobjekt. Der entsprechende Wert muss aus den möglichen Werten des Enums entnommen werden. Ab Version 4.8.0. |
CODE
|
Parameter
Parameter | Inhalt |
Fahrbahn | Setzt die Fahrbahn eines Fahrbahnobjekts. |
Befehle für BIM-Datenbanken
Befehl | Inhalt | Beispiel |
UpdateDatabase | Aktualisiert die interne Datenbank (auf ein neues Schema). | |
ExportUserDefinedStructure("Dateiname”) | Schreibt die vom Nutzer (nicht systemeigenen) definierten Attribute und Familien in die angegebene Datei. |
CODE
|
BIMScript("Dateiname”) | Führt ein in einer Datei definiertes BIM-Script aus einer CSV-Datei aus. Jedes Kommando steht in einer Zeile. Jede Zeile wird nacheinander ausgeführt. Kann ein Kommando nicht ausgeführt werden, wird das restliche BIM-Skript abgebrochen und nicht weiter ausgeführt. Die vorhergehenden Kommandos wurden durchgeführt und werden nicht rückgängig gemacht. |
CODE
Format für die CSV-Datei:
CODE
|
Kommandos für das BIM-Script (CSV-Datei):
Kommando | Beschreibung |
RENAME_FAMILY; Alter Name; Neuer Name | Benennt die Familie “Alter Name” in “Neuer Name” um. |
MOVE_ATTRIBUTE_TO_FAMILY; AttributName; Attributtyp; Zielfamilie | Verschiebt das Attribut mit Namen “Attributname” und dem Typ “Attributtyp” in die Familie “Zielfamilie” |
DELETE_FAMILY; Familie | Löscht die Familie “Familie” |
DELETE_ATTRIBUTE; Attributname | Löscht das Attribut mit Namen “Attributname” |