LabelForm: Unterschied zwischen den Versionen

VisuellWikitext

Aktuelle Version vom 30. November 2022, 14:29 Uhr

LabelForm

Funktionsbeschreibung der Skripterweiterung LabelForm und Anleitungen für die Administration dieser Funktion.

Funktionsbeschreibung

Video

Sollten Sie keinen Zugriff auf YouTube haben, können Sie hier die Videos anschauen.

Aktionen hinterlegen

Jedem Beschriftungseintrag können, ab der Version 2.19 von LabelForm, eine oder mehrere EPLAN-Aktionen hinterlegt werden. So kann über LabelForm beispielsweise eine Nachbearbeitung der Exportdateien erfolgen. Sollen mehrere Aktionen ausgeführt werden, müssen diese durch ein Semikolon in das entsprechende Feld eingetragen werden.

CustomFileEditAction /Parameter:"Value"; Backup /Type:"PROJECT" /ProjectName:"$(PROJECTPATH)"

Jede Aktion bekommt den Pfad zur Konfigurationsdatei von LabelForm (XML-Datei) und die Zeilenposition der Beschriftung in der Konfiguration übergeben. Mit diesen Informationen können dann weitere Details zu der Beschriftung aus der Konfigurationsdatei gelesen werden.

Beispiel:

[DeclareAction("CustomFileEditAction")]
public void Execute(string ConfigFilePath, string Position)
{
	var xDoc = new XmlDocument();
	xDoc.Load(ConfigFilePath);
	var myLabel = xDoc.SelectSingleNode("/Configuration/Labels/Label[Position=" + Position + "]");
	
	if(myLabel != null)
	{
		MessageBox.Show(myLabel["DestinationFilename"].InnerText);
	}
}

Beispiel zeigt ein Meldungsfenster mit dem Zielpfad der Beschriftung.

Anwendungsbeispiele und Lösungen

Anleitung

Die Anleitung und alle weiteren Informationen für LabelForm finden Sie direkt im Shop.

Mögliche Fehler

DataGridView-Ausnahme

System.ArgumentException: Der DataGridViewComboBoxCell-Wert ist ungültig.

Behandeln Sie das DataError-Ereignis, um dieses Standarddialog zu ersetzen.

Lösung: Die verwendeten Sprachen in den Schemata sind nicht in den Benutzereinstellungen hinterlegt:

Einstellungen > Benutzer > Übersetzung > Allgemein

@@ Zeile 1: / Zeile 1: @@
-{{En|LabelForm (english)}}
 [[Datei:SoftwareLabelForm.png|thumb|LabelForm]]
+{{Shop|http://shopforprocess.com/cae/scripte-fuer-eplan/labelform}}
 Funktionsbeschreibung der Skripterweiterung '''LabelForm''' und Anleitungen für die Administration dieser Funktion.
 == Funktionsbeschreibung ==
-<section begin=Funktionsbeschreibung />
-<section begin=Video1 />
-{{#ev:youtube|G-O-Y-DB16o|480}}
-<section end=Video1 />
-{{Box grün|Das Video wird im Vollbildmodus in HD (1080p) wiedergegeben}}
-Alle Beschriftungsausgaben werden im Projektordner im DOC-Verzeichnis abgelegt. Der Zielordner baut sich wie folgt auf:
+=== Video ===
-{{Pfad|Projektordner/DOC/[Parameter destinationPath]/Datum-Uhrzeit}}
+<section begin="Video1" />
+{{#ev:youtube|G-O-Y-DB16o|640}}
+{{YouTubeAccess}}
+<section end="Video1" />
-[[Datei:LabelForm Ausgabe.png]]
+=== Aktionen hinterlegen ===
+Jedem Beschriftungseintrag können, ab der Version 2.19 von LabelForm, eine oder mehrere EPLAN-Aktionen hinterlegt werden. So kann über LabelForm beispielsweise eine Nachbearbeitung der Exportdateien erfolgen. Sollen mehrere Aktionen ausgeführt werden, müssen diese durch ein Semikolon in das entsprechende Feld eingetragen werden.
-Wird im Dateinamen ein Ordner mit Backslash angegeben, werden Unterordner erzeugt.
+<code>CustomFileEditAction /Parameter:"Value"; Backup /Type:"PROJECT" /ProjectName:"$(PROJECTPATH)"</code>
-[[Datei:LabelForm_Unterordner_Dateiname.png|600px]]
+Jede Aktion bekommt den Pfad zur Konfigurationsdatei von LabelForm (XML-Datei) und die Zeilenposition der Beschriftung in der Konfiguration übergeben. Mit diesen Informationen können dann weitere Details zu der Beschriftung aus der Konfigurationsdatei gelesen werden.
-[[Datei:LabelForm_Unterordner.png]]
+'''Beispiel:'''<syntaxhighlight lang="c#" line="1" start="1">
+[DeclareAction("CustomFileEditAction")]
+public void Execute(string ConfigFilePath, string Position)
+{
+	var xDoc = new XmlDocument();
+	xDoc.Load(ConfigFilePath);
+	var myLabel = xDoc.SelectSingleNode("/Configuration/Labels/Label[Position=" + Position + "]");
+	if(myLabel != null)
+	{
+		MessageBox.Show(myLabel["DestinationFilename"].InnerText);
+	}
+}
-Die XML-Dateien (Schemata) werden bei jedem ausführen neu eingelesen. Somit werden Änderungen vom Benutzer am Schema in EPLAN ignoriert. Die Einstellungen auf Dateiebene (XML) haben immer Vorrang.<section end=Funktionsbeschreibung />
+</syntaxhighlight>''Beispiel zeigt ein Meldungsfenster mit dem Zielpfad der Beschriftung.''
-== Rahmenbedingungen ==
+== Anwendungsbeispiele und Lösungen ==
-Diese Einstellungen müssen am Script bzw. Aufruf gemacht werden
-===Einstellwerte===
-Der Bilderordner für das Script. Bitte Zeile bei Bedarf anpassen.
+== Anleitung ==
-<source lang="csharp">
-// Imagepath
+{{ShopAnleitung}}
-public string ImagePath = Path.Combine(
-PathMap.SubstitutePath("$(MD_SCRIPTS)"),
-"LabelForm", "Images");
-</source>
-Administratoren, welche Änderungen vornehmen dürfen. Es wird die Einstellung ''Benutzer > Darstellung > Kennung'' verwendet.
+== Mögliche Fehler ==
-<source lang="csharp">
-// User who have rights for editing (UI-Buttons where enabled)
-public static string[] Admins = { "WJO", "MK" };
-</source>
-===Parameter===
+=== DataGridView-Ausnahme ===
-Der Aufruf der Action benötigt folgende Parameter:
+<code>System.ArgumentException: Der DataGridViewComboBoxCell-Wert ist ungültig.</code>
-{| {{TableSortable}}
-|- {{TableHeaderC}}
-! Name
-! Beschreibung
-|-
-|iniPath
-|In diesem Ordner werden die Konfigurationen für alle Benutzer gespeichert.
-|-
-|destinationPath
-|Ordnername für die Ausgabe im DOC Verzeichnis
-|-
-|description
-|Beschreibung für die Konfigurationen (optional). Das Script kann dadurch für mehrere Gewerke genutzt werden.
-|-
-|}
-=== Schemas / Settings ===
+<code>Behandeln Sie das DataError-Ereignis, um dieses Standarddialog zu ersetzen.</code>
+Lösung: Die verwendeten Sprachen in den Schemata sind nicht in den Benutzereinstellungen hinterlegt:
-=== Scripte ===
+{{Menue|Einstellungen > Benutzer > Übersetzung > Allgemein}}
+[[Kategorie:Dokumentation Scripte]]
-== Siehe auch ==
-*[[Hauptmenüerweiterung ibKastl]]
-*[[Pfadvariablen in EPLAN]]
-*[[:Kategorie:EPLAN Actions]]
-*[[:Kategorie:EPLAN Scripting]]
-== Weblinks ==
-[[Kategorie:Produktdokumentation]]
 [[Kategorie:Dokumentation ibKastl-Scripte]]