Regeln ausführen und das Protokoll verstehen

Dieser Artikel beschreibt die drei Ausführungsmodi, den detaillierten Ablauf und wie das Ausführungsprotokoll zu lesen ist.

Ausführungsmodi

Alle Regeln ausführen

Klicken Sie auf die Schaltfläche „Ausführen" in der Toolbar. Alle Regeln werden nacheinander in der Reihenfolge der Tabelle ausgeführt – unabhängig von der aktuellen Zeilenmarkierung.

Auswahl ausführen

Markieren Sie eine oder mehrere Zeilen (Strg+Klick oder Shift+Klick) und klicken Sie dann auf den Dropdown-Pfeil neben „Ausführen" › „Ausgewählte Regeln ausführen". Nur die markierten Regeln werden ausgeführt, in der Reihenfolge der Tabelle.

Invertierte Auswahl ausführen

Über den Dropdown-Pfeil › „Invertierte Auswahl ausführen" werden alle Regeln ausgeführt, die nicht markiert sind. Nützlich, wenn Sie eine oder wenige Regeln überspringen möchten, ohne alle anderen neu markieren zu müssen.

Tipp: Alle drei Ausführungsmodi sind auch über das Kontextmenü (Rechtsklick in die Tabelle) erreichbar.

Ausführungsablauf im Detail

Für jede Regel werden bei der Ausführung folgende Schritte durchgeführt:

Schritt	Beschreibung	Bei Fehler
1. Validierung	Prüfen ob Zielparameter und Wert vorhanden sind	Protokollzeile: „Kein Parameter" / „Kein Wert" – nächste Regel
2. Evaluation	Elemente nach Datenquelle, Filter und Kategorie suchen	Protokollzeile: „Keine Elemente gefunden" – nächste Regel
3. Parameterzuordnung	Parameter per Name im ersten Element suchen	Protokollzeile: „Parameter nicht gefunden" – nächste Regel
4. Wert parsen	Pattern-Parser-Ausdruck auflösen (falls vorhanden)	Protokollzeile mit Fehlermeldung des Parsers
5. Worksharing-Checkout	Elemente bei Zentraldatei auschecken	Teilergebnis: nicht ausgecheckte Elemente werden übersprungen
6. Schreiben	Parameter pro Element setzen, Zähler führen	Einzelne Fehler werden gezählt und im Protokoll ausgegeben

Revit-Transaktion: Alle Änderungen einer Ausführung (alle Regeln zusammen) werden in einer einzigen Revit-Transaktion zusammengefasst. Das bedeutet: Ein einziges Strg+Z macht alle Änderungen rückgängig – auch wenn mehrere Regeln ausgeführt wurden.

Das Ausführungsprotokoll

Nach der Ausführung erscheint der Protokolldialog. Jede Zeile entspricht einer Regel und zeigt das Ergebnis in folgendem Format:

Zeile 1: 47 Parameter gesetzt (von 47)

Alle Protokollmeldungen im Überblick

Meldung	Bedeutung
`Y Parameter gesetzt (von Z)`	Y von Z gefundenen Elementen wurden erfolgreich beschrieben
`… N Parameter nicht geschrieben`	N Elemente hatten den Parameter, Revit hat das Schreiben abgelehnt (z. B. Formelbindung, schreibgeschützter Parameter)
`… N Elemente haben den Parameter nicht`	N Elemente besitzen den Zielparameter nicht (z. B. Familien ohne diesen Parameter)
`… N Elemente gesperrt`	Worksharing: N Elemente konnten nicht ausgecheckt werden
`Kein Parameter gesetzt`	Regel hat keinen Zielparameter – unvollständig
`Kein Wert`	Kein Wert eingetragen (außer bei Text-Parametern)
`Keine Elemente gefunden`	Kein Element erfüllte die Filterkriterien
`Keine Parameter gefunden`	Gefundene Elemente haben keine schreibbaren Parameter
`Parameter nicht gefunden`	Zielparameter nicht in den gefundenen Elementen vorhanden
Pattern-Parser-Fehlermeldung	Formelausdruck konnte nicht ausgewertet werden

Protokoll ausblenden

Aktivieren Sie in den Einstellungen „Fehlerprotokoll ignorieren". Das Protokoll wird dann nur noch angezeigt, wenn tatsächlich Fehler oder Warnungen aufgetreten sind – nicht nach fehlerfreien Ausführungen.

Worksharing – Detailverhalten

Bei Projekten mit Worksharing (Zentraldatei):

Vor dem Schreiben versucht das Tool, alle betroffenen Elemente automatisch auszuchecken (WorksharingUtils.CheckoutElements).
Der Checkout erfolgt in einem Block für alle Elemente der Regel – nicht einzeln.
Elemente, die ein anderer Benutzer bereits ausgecheckt hat, werden aus der Liste entfernt. Für diese Elemente wird „X Elemente gesperrt" im Protokoll gemeldet.
Wenn der gesamte Checkout fehlschlägt (z. B. Verbindungsfehler), bricht die Ausführung der Regel ab.
Nach der Ausführung werden Elemente nicht automatisch freigegeben. Freigeben erfolgt manuell über Revit › Synchronisieren und Freigeben.

Empfehlung: Für umfangreiche Massenänderungen in Zentraldateien: Führen Sie die Ausführung durch, wenn möglichst wenige andere Benutzer aktiv in der Datei arbeiten. Synchronisieren Sie unmittelbar nach der Ausführung, um die Änderungen in die Zentraldatei zu schreiben.