1 Allgemeine AttributeDie allgemeinen Attribute IgnoreError, Variable und Condition können bei allen Aktionen angegeben werden. Die Attribute sind optional und brauchen nur bei Bedarf hinterlegt werden. Wenn diese für eine Aktion nicht benötigt werden, können diese aber auch zur besseren Lesbarkeit des Skriptes entfernt werden. IgnoreError Das optionale Attribut IgnoreError gibt an, ob bei einem Fehler die Ausführung des Batchpad Skriptes abbricht oder das Skript weiter ausgeführt werden soll. Der Wert muss dem Typ Boolean (true oder false) entsprechen. Variable Das optionale Attribut Variable kann immer dann verwendet werden, wenn man das Ergebnis einer auszuführenden Aktion ermitteln möchte. Variable="{@ResultFileExists}". Die Ergebnisse sind je nach ausgeführter Aktion vom Typ her unterschiedlich, oft ist es ein Boolean (true oder false) der angibt ob die Aktion erfolgreich war. Bei Aktionen für Zeichenketten sind die Ergebnisse dann eher vom Typ String usw. Condition Das optionale Attribut Condition gibt an, ob die Aktion ausgeführt werden soll. Hierzu wird der Inhalt des Attributes als logischer Ausdruck auf Wahr oder Falsch geprüft. Der Ausdruck sollte dem Typ Boolean (true oder false) entsprechen. Der Ausdruck kann Funktionen aus VBScript enthalten, genauso wie Operatoren NOT, OR, AND... Mit dem Condition Attribut wertet man in der Regel Variablen aus, die Ergebnisse aus zuvor durchgeführten Aktionen enthalten. Beispiel: Condition="NOT {@ResultFileExists}" |
2 HasInternetConnection
Die Aktion HasInternetConnection prüft, ob eine Verbindung zu dem Internet aufgebaut werden kann. Falls ja wird true über das Attribut Variable zurückgegeben.
<HasInternetConnection Condition="" Variable="{@Result}" IgnoreError="false" />
3 Ping
Die Aktion Ping prüft, ob eine Verbindung zu einer bestimmten Adresse per Ping durchgeführt werden kann. Falls ja wird true über das Attribut Variable zurückgegeben.
<Ping Address="" Variable="{@Result}" />
4 GetLocalIPAddress
Die Aktion GetLocalIPAddress liefert über die Variable die lokale IP Adresse der Netzwerkkarte die mit dem Standardgateway verbunden ist zurück.
<GetLocalIPAddress Variable="{@Result}" />
5 FileDownload
Die Aktion FileDownload lädt die angegebene Datei aus dem Internet (Attribut: Source) und speichert die Datei in das angegebene Zielverzeichnis (Attribut: Destination).<FileDownload Source="" Destination="" Condition="" Variable="{@Result}" IgnoreError="false" />
6 InitSmtp
Die Aktion InitSmtp stellt eine Verbindung mit dem angegebenen Smtp-Server her (Attribut: Server). Falls die Authentifizierung aktiviert ist (Attribut: Authentification) müssen für die Attribute Login und Passwort gültige Anmeldedaten eingetragen werden. Über das Attribut E-Mail kann die Absender E-Mail Adresse hinterlegt werden. Für das Attribut DisplayName wird der Anzeigename des Absenders hinterlegt, für das Attribut Port kann der für den SMTP-Server gültige Port eingetragen werden und über das Attribut EnableSSL wird festgelgt ob die Verbindung verschlüsselt werden soll.
<InitSmtp DisplayName="" Email="" Login="" Password="" Server="" Port="25" EnableSSL="false" Authentification="true" Condition="" Variable="{@Result}" IgnoreError="false" />
7 SendMail
Über die Aktion SendMail wird eine E-Mail an die in dem Attribut To hinterlegten E-Mail-Adresse versendet. Über das Attribut Cc wird eine Kopie, und über Bcc eine Blindkopie an die jeweils hinterlegte E-Mail versendet. Der Betreff der E-Mail wird über das Attribut Subject angegeben, die Nachricht über das Attribut Body. Enthält die Nachricht HTML Formatierungen wird die HTML Formatierung über das Attribut IsBodyHtml angegeben werden. Der E-Mail kann zudem über das Attribut Attachment eine Datei angehangen werden. Das Attribut Template bietet die Möglichkeit den Pfad zu einem Template zu hinterlegen. In dem Template können die aus den Batchpad Skripten typischen Variablen Bezeichnungen eingetragen werden wie z.B. {@Name}. Wird das Template geladen, werden diese Platzhalter, mit denen zur Laufzeit hinterlegten gleichnamigen Variablen, ersetzt. Das Template kann als HTML formatiertes Dokument oder als reines Textdokument hinterlegt werden. Hinweis: Das Template kann auch direkt im Batchpad Skript angelegt werden, siehe Abschnitt HTML in diesem Lexikoneintrag.
<SendMail To="" Cc="" Bcc="" Subject="" Body="" IsBodyHtml="false" Attachment="" Template="" Condition="" Variable="{@Result}" IgnoreError="false" />
8 SendHttpRequest
Über die Aktion SendHttpRequest können Request an die in dem Attribut Url hinterlegte Adresse versendet werden. Abhängig von der Methode (Attribut: Method) können für z.B. für die Methode GET URL-Parameter über das Attribut UrlParameter angehangen werden. Für die Methode POST können die zu übertragenden Werte in dem Attribut Request angegeben werden. Der Content-Type des Request kann über das das Attribut Format bestimmt werden. Ist die URL durch eine Http-Authentifizierung geschützt, können die Anmeldedaten über die Attribute User und Password hinterlegt werden.
<SendHttpRequest Url="" UrlParameter="" Response="" Request="" Method="GET" Format="" User="" Password="" Condition="" Variable="{@Result}" IgnoreError="false" Header="{@HeaderList}" />
Über das Header-Attribut können Header Informationen mit angegeben werden die an den Server geschickt werden solle:
<KeyValueListAdd Data="{@HeaderList}" Key="Key1" Value="1234" />
<SendMessageToGotify Url="" Token="" Title="" Message="" Priority="2" Variable="{@Result}" />
<SendMessageToNtfy Url="" Token="" Title="" Message="" Priority="default" Tags="" Click="" Markdown="false" Delay="0" Attach="" Icon="" Variable="{@Result}" />
<SendTcpClientMessage IPAddress="" Port="" Timeout="" Message="" Response="{@Response}" Variable="{@Result}" />
<SSLCertificateValidation Ignore="true" Variable="{@Result}" />
<HttpTextEscape Text="" Variable="{@Result}" />
<HttpTextUnescape Text="" Variable="{@Result}" />
Die Aktion SSHExecuteCommand
<SSHExecuteCommand Command="" Servername="" User="" Password="" Message="{@ResultMessage}" Condition="" Variable="{@Result}" IgnoreError="false" />
Der Tag HTML bietet die Möglichkeit direkt in dem Batchpad-Skript ein HTML-Dokument zu hinterlegen. Das Dokument kann anschließend in der Form {@HTML:Beispiel} angesprochen werden. Wobei wie in dem Beispiel die Zeichenfolge "Beispiel" als Wert für das Attribut Name angegeben werden muss.
<HTML Name="Beispiel">
...
</HTML>
