Zum Inhalt springen

LabelForm: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
K Textersetzung - „EPLAN“ durch „Eplan“
Markierungen: Mobile Bearbeitung Mobile Web-Bearbeitung
 
(89 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{KeyUser}}{{User}}
[[Datei:SoftwareLabelForm.png|thumb|LabelForm]]
[[Datei:Eplan Csharp.png|thumb|EPLAN scripting mit C#]]
{{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=Video1 />
{{#ev:youtube|rgP2E-6rMDY|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 ===
[Parameter destinationPath] / Datum-Uhrzeit


== Rahmenbedingungen ==
<section begin="Video1" />
Diese Einstellungen müssen am Script bzw. Aufruf gemacht werden
{{#ev:youtube|G-O-Y-DB16o|640}}
{{YouTubeAccess}}
<section end="Video1" />


===Einstellwerte===
=== Aktionen hinterlegen ===
Der Bilderordner für das Script. Bitte Zeile bei Bedarf anpassen.
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.  
<source lang="csharp">
public string ImagePath = Path.Combine(PathMap.SubstitutePath("$(MD_SCRIPTS)"), "LabelForm", "Images"); // Imagepath
</source>


Administratoren, welche Änderungen vornehmen dürfen. Es wird die Einstellung ''Benutzer > Darstellung > Kennung'' verwendet.
<code>CustomFileEditAction /Parameter:"Value"; Backup /Type:"PROJECT" /ProjectName:"$(PROJECTPATH)"</code>
<source lang="csharp">
public static string[] Admins = { "WJO", "MK" }; // User who have rights for editing (UI-Buttons where enabled)  
</source>


===Parameter===
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.  
Der Aufruf der Action benötigt folgende Parameter:
{| {{TableSortable}}
|- {{TableHeaderC}}
! Name
! Beschreibung
! Werte
|-
|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.
|
|-
|}


'''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);
}
}


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


*[[Hauptmenüerweiterung ibKastl]]
== Anwendungsbeispiele und Lösungen ==


== Weblinks ==
== Anleitung ==
 
{{ShopAnleitung}}


== Mögliche Fehler ==
=== DataGridView-Ausnahme ===
<code>System.ArgumentException: Der DataGridViewComboBoxCell-Wert ist ungültig.</code>
<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:
{{Menue|Einstellungen > Benutzer > Übersetzung > Allgemein}}
[[Kategorie:Dokumentation Scripte]]
[[Kategorie:Dokumentation ibKastl-Scripte]]
[[Kategorie:Dokumentation ibKastl-Scripte]]