Erzeugen und Ausführen von Skripten: Beispiel

Das folgende Beispiel zeigt, wie Sie Skripte erzeugen, wo Sie diese speichern, und wie Sie diese ausführen. Das Beispiel enthält drei Skripte, die:

  1. eine Benutzeroberfläche für Skripte zu Package & Display Designer hinzufügen. (Ein spezielles Register mit Schaltflächen für die Skripte wird erzeugt.)
  2. Zeichnungen in den Dateiformaten PDF, DXF und CF2 exportieren.
  3. Eine Mitteilungs-E-Mail versenden.

Hinweise:

Die Skripte

WICHTIG: Damit Package & Display Designer die Skripte ausführen kann, müssen diese auf die Speicherordner im Installationspfad verweisen (siehe Abbildung). Aus diesem Grund ist es wichtig, in den Skripten den Speicherort der Skripte und die Bilder für deren Schaltflächen anzugeben. In den folgenden Beispielen erfahren Sie, wie Sie Speicherorte der Skripte angeben.

  1. Erstellen Sie die Skripte gemäß Ihren Anforderungen. Siehe die API-Objekte, die für das Erzeugen von Skripten für Package & Display Designer notwendig sind.

Skript 1 (Startup.js) Hinzufügen der Bedienoberflächenelemente für die Skripte


//Init(), falls vorhanden, ist die Funktion, die beim Start des CAD-Systems ausgeführt wird. Sie legt die erforderlichen Bedienoberflächenelemente (Schaltflächen und Werkzeugleisten) an.

function Init()

{

//Fügt der Bedienoberfläche das Register Skripte hinzu. Gibt ebenfalls eine Instanz von ITabItem zurück.

var d = AutoAppUI.TabControlBar.AddCustomTab("Skripte");

//Fügt dem gerade erstellten ITabItem eine Schaltfläche hinzu. Gibt ebenfalls eine Instanz von IAutoCustomButton zurück.

//"JScript" ist die Programmiersprache des ausgeführten Skripts.

//"SampleScript" ist der Namensraum des Skripts. Dieser Parameter MUSS identisch mit dem Ordnernamen in ..\Scripts\JScript\ sein.

// In dem Beispiel ist der Skriptpfad .\Scripts\JScript\SampleScript\startup.js.

// und basiert auf diesem "Namensraum". Die Skriptengine findet die Einrichtungsskripte matchexport.js und sendreport.js.

//"BatchExport" ist der Name der auszuführenden Funktion.

//"./Big/Export.png" ist der Name des Schaltflächenbildes.

//"Stapelexport" ist der Tooltip der Schaltfläche.

//"Stapelexport in mehreren Formaten ausführen" ist der Text, der in der linken unteren Ecke erscheint, wenn der Mauszeiger über der Schaltfläche steht.

var c = d.AddMacrosButton("JScript", "SampleScript", "BatchExport", "./Big/Export.png", "Batch export", "Stapelexport in mehreren Formaten ausführen");

var c = d.AddMacrosButton("JScript", "SampleScript", "SendPrintReport", "./Big/Report.png", "Formular an E-Mail senden", "Druckbericht erzeugen und an E-Mail senden");

}

HINWEIS ZUR ANWENDUNG VON SYMBOLBILDERN: Der Skriptcode enthält Verweise auf die Bilder der Schältflächensymbole (siehe var c in obigem Skriptcode). Die Symbole wurden so erstellt, dass sie zu dem verwendeten Symbolthema passen. Package Designer wird mit zwei Symbolthemen ausgeliefert — Groß und Klein. Wenn Sie ein Symbolthema ändern wollen, müssen Sie auf jeden Fall den auf die entsprechenden Schaltflächensymbole verweisenden Pfad ändern.

Skript 2 (batchexport.js): Stapelexport von Zeichnungen in den Dateiformaten PDF, DXF und CF2


function BatchExport() {

//Das folgende Skript exportiert die aktuelle Zeichnung in einem bestimmten Format in einen angegebenen Ordner.

AutoDrawing.ExportToFormat("c:\\EngViewWork7\\Test.pdf", "pdf");

AutoDrawing.ExportToFormat("c:\\EngViewWork7\\Test.dxf", "dxf");

AutoDrawing.ExportToFormat("c:\\EngViewWork7\\Test.cff", "cf2");

}

Skript 3: Druckzeichnungen erstellen und eine E-Mail-Mitteilung versenden


function SendPrintReport()

//Erzeugt eine Instanz der Schnittstelle IPrintDrawingBuilder.

//Wird verwendet, um Druckzeichnungen (Zeichnungsrahmen) im System zu erstellen und zu bearbeiten.

var builder = AutoProject.MakePrintDrawingBuilder();

//Lädt die Vorlage zur Erstellung der Druckzeichnung. Sucht im Ordner Settings, in dem die Vorlagen gespeichert sind, nach dem Namen.

builder.LoadTemplate("A3 Landscape OneUp.evf");

//Sucht in der geladenen Vorlage nach dem Nutzen-Platzhalter und richtet dessen Eigenschaften ein.

var placeholder1=builder.ItemByName("OneUp1");

//Schaltet im Nutzen-Platzhalter die Bemaßungslinien ein.

placeholder1.ShowML=true;

//Erstellt aus der vorkonfigurierten Vorlage die Druckzeichnung.

builder.Apply();

//Exportiert die erzeugte Druckzeichnung als PDF.

AutoDrawing.ExportToFormat("c:/ EngViewWork7/", "pdf");

//So erhalten wir eine Instanz der COM-Schnittstelle, die von einer anderen Applikation zur Verfügung gestellt wird.

//Das Beispiel verwendet Outlook, da abschließend eine E-Mail versendet wird. HINWEIS: Dies ist ein allgemeiner Ansatz.

var outlookApp = new ActiveXObject("Outlook.Application");

var theMailItem = outlookApp.CreateItem(0);

theMailItem.to = "baba@gmail.com";

theMailItem.Subject = "BETREFF HIER";

theMailItem.Body = "TEXT";

theMailItem.Attachments.add("c:/EngViewWork7/Test.cff");//Der Pfad zu der anzuhängenden Datei.

theMailItem.display();

}

  1. Speichern Sie die Skripte in dem Ordner, auf den Sie in den Skripten verwiesen haben. (Die Beispielskripte sind z.B. im Ordner SampleScript gespeichert.)

Ausführen der Beispielskripte in Package & Display Designer


  1. Stellen Sie sicher, dass Package & Display Designer beendet ist.
  2. Gehen Sie innerhalb der Dateistruktur der Installation in den Ordner, in dem die Skripte gespeichert sind, und ändern Sie die Dateierweiterungen von EXAMPLE zu JS wie folgt:

  1. Starten Sie das Programm.
  2. Klicken Sie im Menü Hilfe auf Registrierung, um das Skript zu verwenden.

Das Dialogfenster Registrierung erscheint.

  1. Wählen Sie das API-Modul (im Bild angezeigt).

WICHTIG: Wenn Ihre derzeitige Lizenz — Netzwerkschutz oder Lokaler Schutz — diese Module nicht enthält, wenden Sie sich bitte an support@engview.com, um Sie anzufordern.

  1. Klicken Sie auf den Button OK.

Bevor die Skripte ausgeführt werden können, fordert eine Meldung Sie zum Neustart des Programms auf.

  1. Klicken Sie auf OK, um die Meldung zu schließen, uns starten Sie das Programm neu.

Nach dem Programm-Neustart werden die Skriptdateien geladen. Die Symbole für die Skripte erscheinen in einer eigenen Symbolleiste Skripte.

  1. Klicken Sie auf eine entsprechende Schaltfläche, um ein Skript auszuführen.