Technische Richtlinien - Dynamo-Skripte

Technische Richtlinien für die Einreichung von Dynamo-Skripten

Diese Richtlinien definieren die technischen, strukturellen und Qualitätsstandards für die Einreichung von Dynamo-Skripten beim RD Studio Creator Program. Unser Ziel ist einfach: zuverlässige, produktionsreife Automatisierungslösungen zu veröffentlichen, die von Fachleuten sicher in realen Projekten eingesetzt werden können.

Die Einhaltung dieser Richtlinien garantiert keine automatische Genehmigung. Jede Einreichung wird auf Qualität, Benutzerfreundlichkeit, Leistung und Originalität geprüft. Wir wollen keine zusätzliche Bürokratie schaffen – wir benötigen einheitliche Standards, um Ihre Arbeit verantwortungsvoll testen, unterstützen und veröffentlichen zu können.

Schnellnavigation

✅ Was wir suchen

Bei uns steht Qualität vor Quantität. Starke Dynamo-Einsendungen weisen in der Regel die folgenden Merkmale auf.

✅ Zulässig - Eigenständige Skripte (sofern vollständig)
Ein einzelnes Skript kann akzeptiert werden, wenn es einen klaren Mehrwert bietet, eine saubere Benutzerführung aufweist und die erforderliche Dokumentation sowie eine Liste der Abhängigkeiten enthält.

✅ Erforderlich – Professionelle, sofort einsatzbereite Automatisierung
Skripte müssen für den praktischen Einsatz in realen Projekten geeignet sein – klare Eingaben, vorhersehbare Ergebnisse und minimaler Einrichtungsaufwand. Wenn ein Skript vom Benutzer verlangt, Eingaben zu erraten, Knoten zu bearbeiten oder fehlende Schritte zu beheben, ist es nicht für die Veröffentlichung geeignet.

✅ Erforderlich – Originalwerk
Reichen Sie bitte ausschließlich Ihre eigenen Originaldrehbücher ein. Wiederveröffentlichte, leicht veränderte oder umbenannte Drehbücher anderer Autoren werden nicht akzeptiert.

Häufige Ablehnungsgründe (Schnell scheitern)

  • ❌ Das Skript kann auf der angegebenen Revit/Dynamo-Version nicht ausgeführt werden.
  • ❌ Fest codierte Dateipfade, Benutzernamen, maschinenspezifische Verzeichnisse oder fehlende externe Dateien
  • ❌ Verwendet kostenpflichtige, private oder unklare Paketabhängigkeiten ohne Genehmigung und Dokumentation
  • ❌ Keine klaren Ein-/Ausgaben, keine Anweisungen oder unleserliches Diagramm
  • ❌ Riskantes Verhalten ohne Warnungen (löscht Elemente, überschreibt Parameter, ändert große Auswahlen stillschweigend)
  • ❌ Keine Beispieldatei, obwohl eine solche zum Verständnis oder Testen des Arbeitsablaufs benötigt wird.
  • ❌ Keine Videodatei, wenn diese zum Verständnis oder Testen des Arbeitsablaufs benötigt wird.

Kompatibilität & Einrichtung

Wir benötigen Kompatibilitätsdetails, damit wir Ihr Skript zuverlässig testen und Supportprobleme nach der Veröffentlichung reduzieren können.

  • Kompatibilität angeben: Geben Sie klar an, welche Revit-Version(en) das Skript unterstützt.
  • Umgebung: Geben Sie an, ob das Skript für Dynamo in Revit oder für Dynamo Player bestimmt ist.
  • Python-Präferenz (Empfohlen): Wenn möglich, bevorzugen wir benutzerdefinierte Python-Knoten gegenüber externen Paketabhängigkeiten. Dies trägt zur langfristigen Stabilität bei, falls Pakete veraltet sind, entfernt oder grundlegend geändert werden.

Graphstruktur & Lesbarkeit

Harte Anforderungen

  • Verwenden Sie ein übersichtliches, gut lesbares Layout mit einheitlichem Zeilenabstand und gleichmäßiger Ausrichtung.
  • Zusammengehörige Knoten gruppieren (verwenden Sie Gruppen mit aussagekräftigen Titeln)
  • Entferne toten Code, ungenutzte Knoten und experimentelle Zweige.

Sehr empfehlenswert

  • Fügen Sie kurze Anmerkungen zu nicht offensichtlichen Logiken und wichtigen Entscheidungen hinzu.
  • Vermeiden Sie nach Möglichkeit übermäßig lange Drähte, die die gesamte Leinwand durchqueren.
  • Benutzerdefinierte Knoten sollten (falls verwendet) eindeutig benannt und übersichtlich organisiert werden.

Eingaben, Ausgaben & UX

Harte Anforderungen

  • Die Eingabemöglichkeiten müssen übersichtlich und zentralisiert sein (vorzugsweise ein einziger Eingabebereich).
  • Verwenden Sie eindeutige Eingabebezeichnungen (Beispiel: "Zielkategorie", "Parametername", "Präfixtext").
  • Die Ausgaben müssen sichtbar und verständlich sein (Beispiel: Ergebnisliste, Anzahl oder Statusmeldung).
  • Wenn das Skript das Modell verändert, fügen Sie einen deutlichen Warnhinweis in der Nähe des Ausführungsbereichs ein.

Sehr empfehlenswert

  • Wo möglich, sichere Standardeinstellungen bereitstellen.
  • Fügen Sie mithilfe von Notizen einen kurzen „Anleitungsblock“ innerhalb des Diagramms hinzu.
  • Fügen Sie klare Erfolgs-/Fehlermeldungen hinzu (Beispiel: „0 Elemente gefunden“, „Abgeschlossen“, „Fehlender Parameter“).

Pakete & Abhängigkeiten

Pakete sind erlaubt. Wir benötigen lediglich Transparenz, damit Benutzer Ihr Skript ohne Rätselraten ausführen können und wir es langfristig unterstützen können.

Harte Anforderungen

  • Liste alle verwendeten Pakete auf (Paketname + Version)
  • Vermeiden Sie kostenpflichtige, private oder nur auf Einladung zugängliche Abhängigkeiten, es sei denn, dies wurde im Voraus ausdrücklich vereinbart.

Sehr empfehlenswert

  • Bevorzugen Sie nach Möglichkeit Standardknoten (OOTB).
  • Gängige Community-Pakete sind im Allgemeinen akzeptabel, solange sie stabil und dokumentiert sind.
  • Vermeiden Sie Abhängigkeiten, die die Kompatibilität zwischen verschiedenen Versionen wahrscheinlich beeinträchtigen.

Qualität, Sicherheit und Leistung

Harte Anforderungen

  • Keine fest codierten Pfade (nutzen Sie Benutzerauswahl, relative Logik oder klar dokumentierte Einrichtungsschritte).
  • Leere Auswahlen und fehlende Parameter elegant behandeln
  • Verlangen Sie nicht, dass der Benutzer das Skript bearbeitet, um es auszuführen (es sei denn, dies ist ausdrücklich angegeben und begründet).
  • Vermeiden Sie destruktive Aktionen ohne ausdrückliche Warnung (Löschen, Überschreiben, Massenänderung).

Sehr empfehlenswert

  • Aufwändige Geometrieoperationen sollten nach Möglichkeit minimiert werden.
  • Frühzeitig filtern, Listengrößen reduzieren und unnötige Konvertierungen vermeiden.
  • Stellen Sie eine einfache Beispieldatei bereit, falls der Workflow Kontext benötigt.

Python-Knoten (falls verwendet)

  • Python-Knoten sind erlaubt
  • Fügen Sie im Code kurze Kommentare ein, um Eingaben, Ausgaben und die wichtigste Logik zu erläutern.
  • Vermeiden Sie schwer verständliche Abhängigkeiten, die Benutzer nicht ohne Weiteres installieren können.

Einreichungsanforderungen

  • .dyn- Datei
  • Videoaufzeichnung, die die Funktionsweise des Skripts anhand der Beispieldatei (.rvt) zeigt.
  • Beispiel einer .rvt-Datei (erforderlich, wenn das Skript eine bestimmte Konfiguration zum Testen benötigt)
  • Kurzbeschreibung mit Erklärung der Funktion des Skripts und seiner Anwendungsgebiete
  • Umgebung: Dynamo oder Dynamo Player
  • Liste der Abhängigkeiten (verwendete Pakete, falls vorhanden)

Alle Einsendungen werden manuell geprüft. Feedback oder Änderungswünsche sind Teil des Prozesses.

Bereit zur Einreichung?

Reichen Sie Ihre Arbeit über unser Formular ein. Wenn Sie sich nicht sicher sind, ob Ihr Drehbuch geeignet ist, fügen Sie eine kurze Notiz hinzu, und wir werden es prüfen.

Reichen Sie Ihre Arbeit ein

Fragen?
Senden Sie uns eine E-Mail an support@rdstudio.co

Zurück nach oben