Installation & Einrichtung

Dieser Artikel beschreibt, wie das MultiPushTool in Revit installiert und für den ersten Einsatz eingerichtet wird.

Systemvoraussetzungen

Revit-Version	.NET Framework	Betriebssystem
Revit 2019 / 2020	.NET Framework 4.7	Windows 10/11 (64-bit)
Revit 2021 – 2024	.NET Framework 4.8	Windows 10/11 (64-bit)
Revit 2025	.NET 8	Windows 10/11 (64-bit)

Schritt 1 – .addin-Datei deployen

Revit lädt Add-Ins automatisch, wenn eine .addin-Datei im folgenden Ordner liegt:

%APPDATA%\Autodesk\Revit\Addins\<RevitVersion>\

Beispiel für Revit 2024:

C:\Users\<Benutzername>\AppData\Roaming\Autodesk\Revit\Addins\2024\MultiPushTool.addin

Hinweis: Der Ordner %APPDATA% ist standardmäßig ausgeblendet. Sie können ihn direkt in der Adressleiste des Windows-Explorers eingeben.

Inhalt der .addin-Datei

Die MultiPushTool.addin enthält folgende Pflichtfelder:

Feld	Beschreibung	Beispielwert
`Assembly`	Vollständiger Pfad zur DLL	`K:\bimm\...\Planworks.MultiPushTool.dll`
`FullClassName`	Einstiegsklasse des Add-Ins	`Planworks.RevitAddin.MultiPushTool.QuickAccessApplication`
`ClientId`	Eindeutige GUID des Add-Ins	`{…}`
`Name`	Anzeigename in Revit	`MultiPushTool`

Schritt 2 – Konfigurationsdateien einrichten (optional)

Das MultiPushTool unterstützt zwei Konfigurationsdateien für Unternehmens- und Projekteinstellungen. Beide liegen im gleichen Ordner wie die DLL.

MultiPushTool.admin.config

Zeigt auf die zentrale Anwendungskonfiguration – wird einmalig vom Administrator gesetzt:

<add key="MainConfigurationPath" value="\\server\share\MultiPushTool.application.config" />

MultiPushTool.application.config

Enthält projektweite Einstellungen:

<add key="QuickAccessConfiguration" value="" />
<add key="AllowUserConfig" value="True" />
<add key="ShowDecimalPlaces" value="" />

Schlüssel	Funktion
`QuickAccessConfiguration`	Pfad zur zentralen Quick-Access-Konfigurationsdatei (XML)
`AllowUserConfig`	Erlaubt (`True`) oder sperrt (`False`) benutzereigene Quick-Access-Buttons
`ShowDecimalPlaces`	Setzt feste Nachkommastellen für alle Benutzer (leer = nicht erzwungen)

Wichtig: Wenn ShowDecimalPlaces gesetzt ist, können Benutzer die Rundungseinstellungen im Tool nicht mehr ändern. Dieser Wert wird für alle Installationen erzwungen.

Schritt 3 – Erster Start

Starten Sie Revit und öffnen Sie ein Projekt.

Das MultiPushTool erscheint im Revit-Ribbon unter dem Tab „b.i.m.m Tools" im Panel „MultiPushTool".

Beim ersten Start wird die Lizenzprüfung ausgeführt. Ist keine gültige Lizenz vorhanden, wird der Start abgebrochen und eine Fehlermeldung angezeigt.

Den aktuellen Lizenzstatus können Sie jederzeit über Menü › Info im Hauptfenster einsehen.

Fehlerbehebung bei der Installation

Problem	Mögliche Ursache	Lösung
Ribbon-Tab erscheint nicht	.addin-Datei fehlt oder liegt im falschen Ordner	Pfad und Revit-Version des Ordners prüfen
Fehler beim Laden des Add-Ins	DLL-Pfad in der .addin-Datei falsch	`Assembly`-Pfad in der .addin-Datei korrigieren
Lizenzdialog erscheint	Keine gültige Lizenz gefunden	Lizenz über Planworks GmbH beziehen
Revit-Versions-Fehler	DLL für andere Revit-Version kompiliert	Passenden Build für die installierte Revit-Version verwenden