A funcionalidade de scripting aceita também parâmetros. Isto só faz sentido, se na partida de um script lhe for transferido um parâmetro /Param. Isto é possível ao chamar o EPLAN através da linha de comando:
W3u.exe ExecuteScript /ScriptFile:<Valor> /Param:<Valor>
Quando o EPLAN é iniciado através da linha de comando para executar um script, o primeiro parâmetro é a ação que deve ser executada. A ação para executar scripts chama-se ExecuteScript. Esta ação dispõe do parâmetro /ScriptFile, através do qual é determinado o nome do script a ser executado. Cada parâmetro adicional (Param1, Param2, Param3, ...) é transferida à função de partida do script.
Exemplo: No exemplo seguinte (em C#) o script (a função de script) necessita de três parâmetros de string Param1, Param2 e Param3:
public class SimpleScriptWithParameters
{
[Start]
public void FunctionWithParameters(String Param1, String Param2, String Param3)
{
MessageBox.Show(Param1 + Param2 + Param3, "SimpleScriptWithParameters")
return;
}
}
O mesmo exemplo em Visual Basic.Net tem o seguinte aspeto:
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
É importante que todos os parâmetros que são utilizados na função do script sejam importados exatamente desta forma na chamada. De outra forma, o script não é executado.
Para uma aplicação EPLAN Electric P8 uma entrada na linha de comando no sistema operativo Windows 7 podia ter o seguinte aspeto:
"C:\Program Files (x86)\EPLAN\Electric P8\<Número de versão>\BIN\W3u.exe" ExecuteScript /ScriptFile:"C:\Users\Public\EPLAN\Electric P8\Scripts\<Código da empresa>\SimpleScriptWithParameters.cs" /Param1:Hello /Param2:" EPLAN " /Param3:User!
Com ajuda desta função, a chamada da linha de comando do EPLAN pode ser ampliada com alguns parâmetros.
Através da utilização de parâmetros gerais de linhas de comando, como por ex., /NoSplash, /Frame:0 e /Auto pode iniciar o programa de forma oculta e sair após a execução do script.
Veja também