LabelForm: Unterschied zwischen den Versionen

(21 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)

Zeile 1:

[[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 ==

~~Alle Beschriftungsausgaben werden im Projektordner im DOC-Verzeichnis abgelegt. Der Zielordner baut sich wie folgt auf:~~

~~{{Pfad|Projektordner/DOC/[Parameter destinationPath]/Datum-Uhrzeit}}~~

~~[[Datei:LabelForm Ausgabe.png]]~~

~~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

=== Video ===

{{YouTubeAccess}}<section end=Video1 /><section end=Funktionsbeschreibung />

~~== 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=~~===

=== Aktionen hinterlegen ===

~~Die Ausgabe erfolgt im DOC~~-~~Verzeichnisses des EPLAN Projektes~~. ~~Im angegebenen Unterordner~~ werden ~~die Dateien gespeichert~~.

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.

~~====Beschreibung====~~

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

~~Sind mehrere LabelForm-Dialoge konfiguriert, kann hier eine Unterscheidung gemacht werden. Diese Angabe wird im Userinterface angezeigt.~~

[[Datei~~:LabelForm_Beschreibung~~.~~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.

====~~Konfiguration~~ (~~direkt~~)====

'''Beispiel:'''<syntaxhighlight lang="c#" line="1" start="1">

~~Möchte man eine Konfiguration direkt ausführen, ohne den LabelForm-Dialog anzuzeigen, kann hier der Name der Konfiguration angegeben werden~~.

[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);

}

~~Um den Dialog anzuzeigen muss~~ der ~~Wert~~ '~~NULL~~' ~~sein.~~

</syntaxhighlight>''Beispiel zeigt ein Meldungsfenster mit dem Zielpfad der Beschriftung.''

====~~Administratoren====~~

== Anwendungsbeispiele und Lösungen ==

~~In dieser Auflistung werden alle User definiert, welche Änderungen an den Konfigurationen vornehmen dürfen.~~

====~~Datenübernahme LabelForm 2.3====~~

~~Um Konfigurationen in die neue Version zu übernehmen ist das Programm [LabelFormConvertTool http://ibkastl.de/daten/download/eplan/81-labelformconverttool] notwendig.~~

== Anleitung ==

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.

== Mögliche Fehler ==

== ~~Systemvoraussetzungen~~ ==

=== DataGridView-Ausnahme ===

<code>System.ArgumentException: Der DataGridViewComboBoxCell-Wert ist ungültig.</code>

~~{{Vorlage:SvScripte}}~~

<code>Behandeln Sie das DataError-Ereignis, um dieses Standarddialog zu ersetzen.</code>

~~{{Vorlage:SvAnwendungen}}~~

~~{{Vorlage:SvCopyright}}~~

[[Kategorie:~~Produktdokumentation~~]]

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

[[Kategorie:Dokumentation Scripte]]

[[Kategorie:Dokumentation ibKastl-Scripte]]