Programmierschnittstelle (API)

Menüleiste

Tastenkürzel

Bearbeiten > Skripte

Strg + J

Der Frontplatten Designer enthält eine Programmierschnittstelle (API), mit der Sie Aktionsfolgen als ausführbares Skript formulieren können. Die verwendete Skriptsprache ist JavaScript.

_images/01_Skripte.PNG

Alle im Folgenden beschriebenen Aktionen werden im Skripting-Fenster ausgeführt (Bearbeiten > Skripte). Das Fenster öffnet sich in einer reduzierten Ansicht. Die Vollanzeige mit dem integrierten Skript-Editor öffnen Sie mit der Schaltfläche >> oberhalb der Liste der Skripte.

_images/001_Skripte_Pfeile.PNG

Schnittstellendokumentation

Die Dokumentation der Programmierschnittstelle (PDF) finden Sie hier.

Skript ausführen

Gelistetes Skript ausführen:

  1. Skript markieren

  2. Klick auf Start

_images/01_scripte02.PNG

Externes Skript ausführen:

  1. Klick auf PastePad

  2. Code in den sich öffnenden Editor einfügen

  3. Klick auf Start

Während der Ausführung des Skriptes werden im Bereich Ausgabe Resultate des Skripts, Ausgaben der Funktion print() sowie Fehlermeldungen angezeigt.

Nach Ausführung des Skriptes wird die bearbeitete, bzw. erzeugte, Frontplatte im Arbeitsbereich des Frontplatten Designers angezeigt.

Skript erstellen / bearbeiten

Um ein neues Skript anzulegen, klicken Sie auf Neu.

Um ein bestehendes Skript zu bearbeiten, markieren Sie das Skript im Verzeichnisbaum.

_images/01_Dateibaum-Scripte.PNG

Öffnen Sie anschließend den integrierten Skript-Editor mit der Schaltfläche >>.

Das bearbeitete Skript können Sie jederzeit ausführen (Schaltfläche Start), zwischendurch speichern (Schaltfläche Speichern) oder unter neuem Namen als zusätzliches Skript anlegen (Schaltfläche Speichern unter).

Im PastePad können Sie erstellte oder eingefügte Zeilen jederzeit separat testen (zum Beispiel Varianten eines bestimmten Fräselementes).

Um den Dateinamen eines Benutzerskripts zu ändern markieren Sie das Skript und klicken Sie auf Umbenennen.

Externes Skript hinzufügen

Um ein externes Skript (Dateiendung .fpjs) in die Dateiliste zu übernehmen, klicken Sie auf Hinzufügen. Alternativ fügen Sie das Skript direkt in das Benutzerskripte-Verzeichnis ein (Dateipfad s. u.) und aktualisieren anschließend die Dateiliste im Skripting-Fenster.

Skripte verwalten

Im oberen Bereich des Skripting-Fensters werden alle Skripte angezeigt, die entweder vom Benutzer erstellt (Benutzerskripte) oder mit dem Frontplatten Designer mitgeliefert wurden (FPD-Skripte).

Die Benutzerskripte sind unter folgendem Pfad abgelegt:

  • Windows: %APPDATA%FrontDesignScripts

  • Mac: $HOME/.FrontDesign/Scripts

  • Linux: $HOME/.FrontDesign/Scripts

Falls Sie den Inhalt des entsprechenden Pfads z. B. mittels eines Dateimanagers verändert haben, können Sie die Änderungen mittels der Aktualisieren-Schaltfläche oberhalb des Skript-Verzeichnisses übernehmen.