LabelForm: Unterschied zwischen den Versionen

Aus ibKastl Wiki
VisuellWikitext
 
(9 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{En|LabelForm (english)}}
[[Datei:SoftwareLabelForm.png|thumb|LabelForm]]
[[Datei:SoftwareLabelForm.png|thumb|LabelForm]]
{{Shop|http://shopforprocess.com/cae/scripte-fuer-eplan/labelform}}
{{Shop|http://shopforprocess.com/cae/scripte-fuer-eplan/labelform}}
Funktionsbeschreibung der Skripterweiterung '''LabelForm''' und Anleitungen für die Administration dieser Funktion.
Funktionsbeschreibung der Skripterweiterung '''LabelForm''' und Anleitungen für die Administration dieser Funktion.
== Funktionsbeschreibung ==
== Funktionsbeschreibung ==
<section begin=Funktionsbeschreibung />
Wird im Dateinamen ein Ordner mit Backslash angegeben, werden Unterordner erzeugt.
[[Datei:LabelForm_Unterordner_Dateiname.png|600px]]
[[Datei:LabelForm_Unterordner.png]]
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.
===Platzhalter===
Sie können über das Kontextmenü (Rechtsklick) in der Spalte Pfad verschiedene Platzhalter einfügen:
[[Datei:LabelForm_Placeholder.png|600px]]
Wenn Sie eine Projekteigenschaft nutzen möchten können Sie die ID mit Index angeben. Ist kein Index für eine Variable vergeben (bei Standard-Eigenschaften) muss der Index 0 sein.
''{#ID=10000.0#}''
*10000 = ID
*0 = Index
{{Box rot|Ab EPLAN 2.5 können Benutzer-Zusatzfelder mit einem Namen gespeichert werden. Dadurch ist die ID in den Projekteigenschaften nicht direkt sichtbar. Die Benutzer-Zusatzfelder sind aufsteigend nummeriert von 40001 bis 40100 }}


=== Video ===
=== Video ===


<section begin=Video1 />
<section begin="Video1" />
{{#ev:youtube|G-O-Y-DB16o|640}}
{{#ev:youtube|G-O-Y-DB16o|640}}
{{YouTubeAccess}}<section end=Video1 /><section end=Funktionsbeschreibung />
{{YouTubeAccess}}
 
<section end="Video1" />
== Installation ==
{{InDaten}}
{{InScripte}}
 
===Einstellwerte===
Folgende Einstellungen müssen über die Software [[ScriptSettings]] gemacht werden.
 
[[Datei:LabelForm_Einstellungen.png|600px]]
 
====Speicherort Konfigurationen====
In diesem Ordner, welcher vorzugsweise im Netzwerk für alle Benutzer bereitgestellt ist, werden alle Konfigurationen gespeichert.
 
====Zielordner====
Die Ausgabe erfolgt im DOC-Verzeichnisses des EPLAN Projektes. Im angegebenen Unterordner werden die Dateien gespeichert.
 
====Beschreibung====
Sind mehrere LabelForm-Dialoge konfiguriert, kann hier eine Unterscheidung gemacht werden. Diese Angabe wird im Userinterface angezeigt.
 
[[Datei:LabelForm_Beschreibung.png|600px]]
 
====Konfiguration (direkt)====
Möchte man eine Konfiguration direkt ausführen, ohne den LabelForm-Dialog anzuzeigen, kann hier der Name der Konfiguration angegeben werden.


Um den Dialog anzuzeigen muss der Wert 'NULL' sein.
=== 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.  


==== Anmeldename / Kennung ====
<code>CustomFileEditAction /Parameter:"Value"; Backup /Type:"PROJECT" /ProjectName:"$(PROJECTPATH)"</code>
Hier kann eingestellt werden, ob der Anmeldename oder die Kennung für die Rechtsverwaltung verwendet werden kann.


==== Administratoren ====
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.  
In dieser Auflistung werden alle User definiert, welche Änderungen an den Konfigurationen vornehmen dürfen.


===Datenübernahme LabelForm 2.3===
'''Beispiel:'''<syntaxhighlight lang="c#" line="1" start="1">
Um Konfigurationen in die neue Version (ab LabelForm-Version 2.4) zu übernehmen ist das Programm [http://ibkastl.de/daten/download/public/81-labelformconverttool LabelFormConvertTool] notwendig.
[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);
}
}


Es werden die INI-Dateien in XML-Dateien umgewandelt. Optional können die alten INI-Dateien gelöscht werden. Ein Parallelbetrieb von Version ist gewährleistet wenn die INI-Dateien nicht gelöscht werden. Dies wird auch empfohlen um die Datenübernahme zu testen.
</syntaxhighlight>''Beispiel zeigt ein Meldungsfenster mit dem Zielpfad der Beschriftung.''


Es werden alle Unterordner des ausgewählten Verzeichnisses durchsucht.
== Anwendungsbeispiele und Lösungen ==


== Systemvoraussetzungen ==
== Anleitung ==
 
{{ShopAnleitung}}


=== Scripte ===
== Mögliche Fehler ==


==== EPLAN-Versionen ====
=== DataGridView-Ausnahme ===
<code>System.ArgumentException: Der DataGridViewComboBoxCell-Wert ist ungültig.</code>


*EPLAN 2.1 (anders Script notwendig)
<code>Behandeln Sie das DataError-Ereignis, um dieses Standarddialog zu ersetzen.</code>  
*EPLAN 2.2
*EPLAN 2.3
*EPLAN 2.4
*EPLAN 2.5<noinclude>[[Kategorie:Vorlagen Produkte]]</noinclude>
{{Vorlage:SvAnwendungen}}
{{Vorlage:SvCopyright}}


[[Kategorie:Produktdokumentation]]
Lösung: Die verwendeten Sprachen in den Schemata sind nicht in den Benutzereinstellungen hinterlegt:
{{Menue|Einstellungen > Benutzer > Übersetzung > Allgemein}}
[[Kategorie:Dokumentation Scripte]]
[[Kategorie:Dokumentation ibKastl-Scripte]]
[[Kategorie:Dokumentation ibKastl-Scripte]]

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

LabelForm
ShopLink.png

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

ProcessGear-01.png
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
Abgerufen von „http:///w/index.php?title=LabelForm&oldid=30789“