LabelForm: Unterschied zwischen den Versionen

(25 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)

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

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

=== Video ===

{{#ev:youtube|G-O-Y-DB16o|~~480~~}}<section end=Video1 />~~<section end=Funktionsbeschreibung />~~

~~== Installation ==~~

~~{{InDaten}}~~

~~{{InScripte}}~~

~~== Rahmenbedingungen ==~~

~~Diese Einstellungen müssen am Script bzw. Aufruf gemacht werden~~

~~===Einstellwerte===~~

~~Folgende Einstellungen müssen über die Software [[ScriptSettings]] gemacht werden.~~

~~[[Datei:LabelForm_Einstellungen~~.~~png|600px]]~~

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

~~====Speicherort Konfigurationen====~~

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

~~In diesem Ordner, welcher vorzugsweise im Netzwerk für alle Benutzer bereitgestellt ist, werden alle Konfigurationen gespeichert.~~

~~====Zielordner====~~

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.

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

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

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

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

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

}

~~[[Datei:LabelForm_Beschreibung~~.~~png|600px]]~~

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

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

== Anwendungsbeispiele und Lösungen ==

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

== Anleitung ==

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

== Mögliche Fehler ==

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

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