Diese Funktionalität ist nur in bestimmten Ausbaustufen verfügbar. Info / Copyright

Script-Typicals: Grundlagen

In Script-Typicals organisieren Sie Scripte, die nach dem Erzeugen der Projektdokumentation im Project Builder von der EPLAN Plattform ausgeführt werden sollen.

  1. Status: Definieren Sie, ob ein Script ausgeführt werden soll.
  2. Script: Sehen Sie sich die Vorschau des hochgeladenen Script-Inhaltes an. Eine Bearbeitung von Scripten ist im Designer nicht möglich.
  3. Parameter: Definieren Sie die Script-Parameter. Die Parameterwerte sind entweder fest vorgegebene Inhalte oder werden mit Hilfe von Konfigurationsvariablen sowie Formeln gestaltet.
  4. Referenzen: Sehen Sie sich die Verwendungsstellen eines Scripts an.

GeschlossenAllgemeine Voraussetzungen zur Verwendung von Scripten
  • Sie haben die EPLAN Plattform gestartet.
  • Sie haben sich in der EPLAN Cloud angemeldet.
  • Sie haben sich in einer Organisation angemeldet.
  • Sie haben den Designer geöffnet.
  • Sie haben eine Bibliothek geöffnet.

In eBUILD sind ausschließlich Scripte verwendbar, die das Attribut [Start] und mindestens den Parameter ProjectName enthalten. Der Parameter ProjectName wird dabei vom Generator automatisch übergeben und muss nicht im Designer als Script-Parameter definiert werden.

GeschlossenBeispiel: Einfaches Script ohne Parameter

 


public class <MyeBUILDScript>
{
	[Start]
	public void <FunctionName>(string ProjectName)
	{
		//<Enter your code text here>
		return;
	}
}

Darüber hinaus können auch Scripte mit weiteren Parametern in eBUILD verwendet werden. Alle vorhandenen Script-Parameter, mit Ausnahme des Standardparameters ProjectName, müssen im Designer unter Script-Typicals im Dropdown Parameter definiert werden.

GeschlossenBeispiel: Einfaches Script mit Parametern

 


public class <MyeBUILDScript>
{
	[Start]
	public void <FunctionName>(string ProjectName, string Para1, string Para2)
	{
		//<Enter your code text here>
		return;
	}
}

Die Parameter Para1 und Para2 des Script-Beispiels müssen im Dropdown Parameter eines Scripts in derselben Schreibweise wie vom Script selbst vorgegeben erstellt werden.

Hinweis

  • Die Notwendigkeit, einen Wert zu vergeben, hängt vom Inhalt des verwendeten Scripts ab und kann nicht in eBUILD selbst ermittelt werden.
  • Die Verwendung mehrerer gleichnamiger Script-Parameter ist technisch nicht zulässig und wird vom Designer verhindert.
  • Ein automatisches Auslesen evtl. vorhandener Script-Parameter ist technisch nicht möglich. Script-Parameter müssen manuell vom Bearbeiter des Script-Typicals im Designer passend zu dem hinterlegten Script angelegt werden. Bereits erstellte Parameter werden beim Aktualisieren des Scripts über Ersetzen nicht korrigiert und müssen bei Bedarf angepasst werden.

Mehr lesen