Allplan Visual Scripting

Mit dieser Funktion rufen Sie die Anwendung Allplan Visual Scripting auf, über die Sie mithilfe einer graphisch unterstützten Programmiersprache parametrisierbare Formen und Objekte generieren und komplette Workflows automatisieren können.

So erstellen Sie ein Skript mit Allplan Visual Scripting

Aktivieren Sie in Allplan das Teilbild, auf dem die durch das Skript erzeugten Objekte abgelegt werden sollen bzw. sich die zu modifizierenden Objekte befinden.
Klicken Sie auf Allplan Visual Scripting (Aufruf).
Rufen Sie Allplan Visual Scripting auf folgende Art auf:
- Actionbar: Rolle Konstruktion Aufgabe Benutzerobjekte Aufgabenbereich Visual Scripting
Das Anwendungsfenster von Allplan Visual Scripting wird geöffnet.

Tipp: Rufen Sie weitere Informationen zu Allplan Visual Scripting ab, indem Sie im Menü Hilfe auf Getting started klicken.
Klicken Sie in der Funktionsleiste oder im Menü Datei auf Neu, um ein neues Skript zu erzeugen.
Oder:

Klicken Sie in der Funktionsleiste oder im Menü Datei auf Öffnen, um ein bestehendes Skript zu laden.

Tipp: Mit Allplan wird eine Sammlung von Beispiel-Skripten ausgeliefert. Diese Skripte laden Sie, indem Sie in der linken Spalte des Dialogfeldes Öffnen den Ordner Examples anwählen. Aus diesen Skripten können Sie eigene, auf Ihre Anforderungen zugeschnittene Skripte ableiten. Speichern Sie in solchen Fällen die Skripte unter einer neuen Bezeichnung (siehe unten).
Wenn Sie ein neues Skript erzeugen oder ein bestehendes erweitern möchten, ziehen Sie die erforderlichen Nodes aus der Palette Bibliothek in den Arbeitsbereich.
Tipp: Unterhalb der Titelleiste der Palette Bibliothek befindet sich das Eingabefeld für die Suchfunktion. Durch Eingabe der Node-Bezeichnung bzw. Teilen davon lässt sich die Anzeige der Bibliothek einschränken und das Auffinden eines Nodes vereinfachen.
Durch Doppelklick linke Maustaste im Arbeitsbereich lässt sich eine Schnelleingabe (Quick insert) öffnen. Geben Sie hier die Node-Bezeichnung bzw. Teile davon ein. Die angezeigten Nodes können mit Doppelklick linke Maustaste in den Arbeitsbereich eingefügt werden.
Verknüpfen Sie anschließend die relevanten Input-Ports der Nodes mit den entsprechenden Output-Ports anderer Nodes mit Hilfe von Verbindungslinien.
Haben Sie ein bestehendes Skript geladen, können Sie die enthaltenen Verknüpfungen und Nodes ändern. Zur Handhabung der Nodes stehen Ihnen ein Kontextmenü im Arbeitsbereich und Funktionen im Menü Bearbeiten zur Verfügung. Im Getting started erfahren Sie, wie dies funktioniert.
Hinweis: Um die Darstellung Ihres Skripts oder einzelner Nodes in der Größe zu verändern, stehen Ihnen rechts oben im Arbeitsbereich mehrere Funktionen zur Verfügung. Diese Funktionen finden Sie auch im Menü Ansicht.

Wichtig!
Solange erforderliche Ports (rot markiert) noch nicht verbunden sind, kann ein Skript nicht ausgeführt werden!
Auf der rechten Seite des Allplan Visual Scripting - Anwendungsfenster befindet sich die Palette Palettendesigner.
Im unteren Teil dieser Palette werden von allen in den Arbeitsbereich gezogenen Nodes die sichtbar geschalteten Parameter angezeigt. Um diese Parameter entsprechend Ihren Vorstellungen sortieren zu können, lassen sie sich per Drag&Drop aus dem Bereich Nicht zugewiesen in den oberen Bereich der Palette verschieben. Hier bestimmen Sie das Aussehen der Palette Eigenschaften in Allplan, indem Sie Gruppen und Tabs anlegen können. Eine Gruppe bildet in der Allplan-Palette Eigenschaften einen Bereich, mit einem Tab wird eine Registerkarte in der Palette Eigenschaften angelegt.
Durch diese Strukturierung können Sie die sichtbaren Nodes-Parameter Ihren Vorstellungen entsprechend einsortieren und gruppieren.
Hinweis: Um zu überprüfen, welche Parameter zu welchem Node gehören, können Sie in der Palette Palettendesigner das Kontextmenü der Parameter öffnen und auf Auf Arbeitsfläche anzeigen klicken. Dies hat zur Folge, das der entsprechende Node zentriert und vergrößert im Arbeitsbereich dargestellt wird.
Um zu überprüfen, ob die sichtbaren Parameter eines im Arbeitsbereich liegenden Nodes in der Palette Palettendesigner bereits einsortiert und gruppiert worden sind oder nicht, öffnen Sie das Kontextmenü des Nodes und klicken auf In Palettendesigner selektieren. Die Parameter werden daraufhin in der Palette Palettendesigner zentriert und farblich hinterlegt hervorgehoben.
Im Menü Ansicht können Sie die Anzeige der Palette Beobachtungsliste einschalten. Dies geschieht auch, wenn Sie im Tooltip der Node-Parameter an den Output-Ports auf Beobachten klicken. Damit erreichen Sie, dass dieser Parameter in die Palette Beobachtungsliste aufgenommen wird. Die Palette Beobachtungsliste ermöglicht Ihnen, die darin enthaltenen Parameter während der Dauer Ihrer Visual Scripting Session zu prüfen.
Klicken Sie in der Funktionsleiste oder im Menü Skript auf Starten, um das Skript auszuführen.
In Allplan wird die Palette Eigenschaften geöffnet und das Resultat des Skripts als Vorschau im Grafikfenster dargestellt.

Sollte das Skript nicht oder nicht fehlerfrei ablaufen, können Sie Informationen über mögliche Ursachen abrufen. Diese Informationen werden im Fenster Ausgabe eingeblendet. Im Menü Ansicht regeln Sie das Ein- bzw. Ausblenden des Fensters Ausgabe.

Hinweis: Mit der Funktion Stoppen (UMSCHALT + F5) lässt sich das durch Starten ausgelöste Ausführen des Skripts unterbrechen. Ist das Skript schon ausgeführt und in Allplan werden die Eigenschaftenpalette und das Objekt angezeigt, bewirkt das Aktivieren der Funktion Stoppen, dass diese Darstellungen in Allplan wieder gelöscht werden.
Die Funktion Stoppen finden Sie in der Funktionsleiste und im Menü Skript.
Wechseln Sie auf die Palette Eigenschaften in Allplan und stellen Sie die Parameter Ihren Anforderungen entsprechend ein.
Oder:

Bearbeiten Sie die erzeugten bzw. modifizierten Objekte im Allplan Grafikfenster, z. B. indem Sie die Griffe an die vorgesehene Position ziehen oder die Werte in den Eingabefeldern am Objekt ändern.

Hinweis: Solange das Skript geöffnet ist, können Sie die Parameter auch direkt im Skript modifizieren.
Wenn Sie ein neues Skript erstellt oder ein bestehendes geändert haben, können Sie es jederzeit in einer Projektdatei (*.avsprj) speichern.
Um Änderungen an einem bestehenden Skript zu speichern, klicken Sie in der Funktionsleiste oder im Menü Datei auf Speichern.

Oder:

Um ein Skript unter einer neuen Bezeichnung zu speichern, klicken Sie im Menü Datei auf Speichern unter....

Hinweis: Speichern Sie ein Skript auch dann, wenn Sie am Skript selbst nichts geändert haben, die aktuell eingestellten Parameter beim nächsten Aufruf des Skripts jedoch wieder zur Verfügung stehen sollen.
Durch Auslösen der Funktion Starten wurde in Allplan die Palette Eigenschaften geöffnet und das Resultat des Skripts als Vorschau im Grafikfenster dargestellt.
Möchten Sie diese Ergebnisse im Allplan-Teilbild erhalten, muss vor dem Schließen des Skripts das Erzeugen der Objekte in Allplan erfolgen.
Bisher werden die Objekte im Allplan-Teilbild nur angezeigt, das heißt beim Schließen des Skripts würden die Objekte und ihre Eigenschaftenpalette in Allplan verschwinden.

Klicken Sie in der Symbolleiste oder im Menü Datei auf Objekte in Allplan erzeugen.
Damit wird das Erzeugen des im Script definierten Objekts in Allplan ausgelöst.
Wählen Sie im Dialogfeld Speichern unter den gewünschten Ordner (Projekt, Büro oder Privat), vergeben Sie eine Bezeichnung und klicken Sie auf Speichern.
Die Objekte wurden in Allplan gespeichert. Die Objekte werden im Allplan-Fenster dargestellt, die Eigenschaften-Palette wurde geschlossen. Die Verbindung zwischen Allplan und dem Visual Scripting - Anwendungsfenster wurde unterbrochen.
Um Allplan Visual Scripting zu beenden, klicken Sie auf den Schließen-Knopf im Rahmen des Visual Scripting Anwendungsfensters oder im Menü Datei auf Beenden (Alt + F4).

Detaillierte und weiterführende Informationen zum Thema Visual Scripting auch anhand eines kleinen Beispiels erläutert, finden Sie, wenn Sie im Anwendungsfenster von Allplan Visual Scripting das Menü Hilfe und hier Allplan Visual Scripting-Hilfe anklicken oder wenn Sie F1 drücken.

Datenschutzbestimmungen