De scripting-functie kan ook gebruik maken van parameters. Dit heeft echter alleen zin als er bij het uitvoeren van een script een parameter /Param wordt opgegeven. Dit kan door het script via een opdrachtregel op te roepen:
W3u.exe ExecuteScript /ScriptFile:<Waarde> /Param:<Waarde>
Als EPLAN via de opdrachtregel wordt gestart om een script uit te voeren, is de eerste parameter de actie die moet worden uitgevoerd. De actie voor het uitvoeren van scripts luidt ExecuteScript. Deze actie beschikt over de parameter /ScriptFile, waarmee de naam van het uit te voeren script wordt gedefinieerd. Elke volgende extra parameter (Param1, Param2, Param3, ...) wordt overgedragen aan de startfunctie van het script.
In het volgende voorbeeld (in C#) is voor het script (de scriptfunctie) de drie-string-parameter Param1, Param2 en Param3 nodig:
public class SimpleScriptWithParameters { [Start] public void FunctionWithParameters(String Param1, String Param2, String Param3) { MessageBox.Show(Param1 + Param2 + Param3, "SimpleScriptWithParameters") return; } }
Hetzelfde voorbeeld in Visual Basic.Net ziet er als volgt uit:
Public Class SimpleScriptWithParameters <Start> _ Public Sub FunctionWithParameters(ByVal Param1 As String, ByVal Param2 As String, ByVal Param3 As String) MessageBox.Show(Param1 + Param2 + Param3, "SimpleScriptWithParameters") Return End Sub 'FunctionWithParameters End Class 'SimpleScriptWithParameters
Het is belangrijk dat alle parameters die in de functie van het script worden gebruikt, ook net zo in de oproep worden overgenomen. Anders wordt het script niet uitgevoerd.
Voor het programma EPLAN Electric P8 zou de opdrachtregel er onder het besturingssysteem Windows 7 als volgt uit kunnen zien:
"C:\Program Files (x86)\EPLAN\Electric P8\<Versienummer>\BIN\W3u.exe" ExecuteScript /ScriptFile:"C:\Users\Public\EPLAN\Electric P8\Scripts\<Bedrijfskenmerk>\SimpleScriptWithParameters.cs" /Param1:Hello /Param2:" EPLAN " /Param3:User!
Met behulp van deze functie kunt u de EPLAN-opdrachtregeloproep met eigen parameters uitbreiden.
Door gebruik te maken van algemene opdrachtregelparameters zoals /NoSplash, /Frame:0 en /Auto kunt u het programma onzichtbaar starten en na het uitvoeren van het script weer afsluiten.
Zie ook