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 Plugin
Die Aktion Plugin erweitert die Funktion des Batchpad über die angegebene .dll Datei (Attribut: Name). TODO
<Plugin Name="" Mode="" Args="" Condition="" Variable="{@Result}" IgnoreError="false" />
3 mydatastreamInit
Die Aktion mydatastreamInit inititialisiert die Verbindung zu mydatastream. In dem Attribut wird die zu erreichende Portal Adresse eingetragen, beispielsweise "https://demo.mydata.stream/". Zudem muss der gültige Fingerprint (Attribut: LicenseNumber), ein gültiger Benutzer (Attribut: User) mit der Rolle Administrators und einem zugehörigen Passwort (Attribut: Password) hinterlegt werden.
<mydatastreamInit PortalUrl="" LicenseNumber="" User="" Password="" Condition="" Variable="{@Result}" IgnoreError="false" />
4 mydatastreamSendMessage
Die Aktion mydatastreamSendMessage sendet an den unter "SendTo" angegebenen Benutzer (Benuterzname in mydatastream) einen Nachricht in den Benachrichtigungs-Raum des Chats. Hinweis: mydatastreamSendMessage muss in Verbindung mit mydatastreamInit verwendet werden. mydatastreamInit muss vor dieser Aktion ausgeführt werden.
<mydatastreamSendMessage SendTo="" Message="" Link="" />
5 mydatastreamGetAccessLink
Die Aktion mydatastreamGetAccessLink erstellt einen Link auf ein Formular über den der Benutzer angemeldet wird und direkt auf das Formular weitergeleitet wird. Der Benutzer hat dabei nur Zugriff auf das freigegebene Formular. Für "SendTo" muss ein beliebiger Name angegeben werden. "FormularKey" kann aus dem AppBuilder entnommen werden, dort wird zu dem gewünschten Formular ein FormularKey hinterlegt. Der "Filter" bestimmt den Datensatz auf den der Link verweisen soll. Der Filter darf nur ein Ergebnis zurück liefern. "ExpireValue" in Verbindung mit "ExpireUnit" gibt an wie lange der Link gültig sein soll. Für 30 Tage wären die Angaben 30 und d einzutragen; Stunden: h; Minuten: m. Zusätzlich kann eine Passwort-Abfrage mit PasswordProtected="true" vorgelagert werden und der Dialog über die Attribute "PasswordButtonText" und "PasswordHeadline" individualisiert werden. Wird das Passwort zu oft falsch eingegeben (4 Versuche) wird der Link ungültig. Über MinutesCookieExpire wird angegeben wie lange die Sitzung ab Anmeldung über den Link gültig sein soll, bevor der Benutzer automatisch abgemeldet wird (Aber der Link ist unabhängig von der Session weiterhin gültig). Das Ergebnis wird über das Attribut "Link" ausgegeben und kann z.B. mit einer Print-Aktion in der Konsole des Batchpad ausgegeben werden. Hinweis: mydatastreamGetAccessLink muss in Verbindung mit mydatastreamInit verwendet werden. mydatastreamInit muss vor dieser Aktion ausgeführt werden.
<mydatastreamGetAccessLink SendTo="" FormularKey="" Filter="" ExpireValue="30" ExpireUnit="d|h|m" Link="{@ResultLink}" PasswordProtected="false" PasswordQuestion="" PasswordAnswer="" PasswordButtonText="" PasswordHeadline="" MinutesCookieExpire="30" />
Wichtig: Wir empfehlen eine Legitimation in jedem erzeugtem Link mit anzugeben!
6 mydatastreamGetAuthLink
Die Aktion mydatastreamGetAuthLink erzeugt einen Link über den sich ein Benutzer direkt am mydatastream Portal anmeldet. "UserName" muss einem Benutzernamen aus der Benutzerverwaltung von mydatastream entsprechen und es darf sich nicht um einen Administrator-Account handeln (sonst wird bricht die Anfrage ab). Alle weiteren Angaben entsprechen den Attributen der Aktion mydatastreamGetAccessLink. Hinweis: mydatastreamGetAuthLink muss in Verbindung mit mydatastreamInit verwendet werden. mydatastreamInit muss vor dieser Aktion ausgeführt werden.
<mydatastreamGetAuthLink UserName="" ExpireValue="30" ExpireUnit="d|h|m" MinutesCookieExpire="30" Link="{@ResultLink}" />
Es kann an den AuthLink eine Return-URL angehangen werden: "?ReturnUrl=". Die URL wird direkt nach der Authentifizierung geöffnet. Hinweis: App-Urls können über den Einstieg [portalURL]/pages/portal + öffnen der App in der Browser-Adresszeile angezeigt werden.
Wichtig: Wir empfehlen die Zwei-Faktor-Authentifizierung für jeden dem Link zugeordneten Benutzer zu aktivieren!
7 Sage100Init
Die Aktion Sage100Init TODO
<Sage100Init Server="" Port="" Datasource="" Mandant="" User="" Password="" Https="false" Timeout="00:02:00" Condition="" Variable="{@Result}" IgnoreError="false" />
8 Sage100Execute
Die Aktion Sage100Execute TODO
<Sage100Execute Service="" Config="" Data="" Message="" Mode="" Args="" Condition="" Variable="{@Result}" IgnoreError="false" />
