ScriptBlockFunc-Services - Übersicht

SPLIT

Service
Beschreibung
Einen String mit dem übergebenen Delimiter auftrennen und die einzelnen Bestandteile in einen X-Array abfüllen (falls nötig, wird dieser zuerst geleert). Zurückgegeben wird die Anzahl Einträge. Optional ist Unterdrücken leerer Einträge und einfaches Filtern möglich.

WRITE

Service
Beschreibung
Geöffneten Ausgabekanal schliessen.
Liefert Anzahl Linien welche in den Kanal geschrieben wurden = Anzahl 'WRITE.OutLine()'-Aufrufe.
Ist ein bestimmter Ausgabekanal zum Schreiben geöffnet?
Ausgabekanal zum Schreiben einer ANSI-Datei öffnen. Standardmässig wird allenfalls bestehende Datei überschrieben.
Ausgabekanal zum Schreiben einer OEM-850-Datei öffnen. Standardmässig wird allenfalls bestehende Datei überschrieben.
Ausgabekanal zum Schreiben einer UTF-16LE-Datei (Little-Endian inkl. BOM) öffnen. Standardmässig wird allenfalls bestehende Datei überschrieben.
Ausgabekanal zum Schreiben einer UTF-16LE-Datei (Little-Endian ohne BOM) öffnen. Standardmässig wird allenfalls bestehende Datei überschrieben.
Ausgabekanal zum Schreiben einer UTF-8-Datei (inkl. BOM) öffnen. Standardmässig wird allenfalls bestehende Datei überschrieben.
Ausgabekanal zum Schreiben einer UTF-8-Datei (ohne BOM) öffnen. Standardmässig wird allenfalls bestehende Datei überschrieben.
Schreiben des übergebenen Texts.
Schreiben des übergebenen Texts inkl. einem zusätzlichen Zeilenumbruch.

X

Service
Beschreibung
Wert einer bestimmten X-Variable ergänzen.
Wert einer bestimmten X-Variable abholen.
Ist eine bestimmte X-Variable definiert?
Wert einer bestimmten X-Variable setzen.

XARR

Service
Beschreibung
Wert zu Array hinzufügen. Liefert neue Anzahl Einträge.
Alle Einträge eines Arrays zu einem anderen hinzufügen. Liefert neue Anzahl Einträge. Beide Arrays müssen bereits existieren.
Bestimmten Eintrag durch übergebenen Wert ergänzen. Fehler wenn noch kein Eintrag mit der übergebenen Nummer existiert.
Erstellt eine Kopie eines Arrays. Liefert neue Anzahl Einträge. Allenfalls vormals bestehende Einträge werden gelöscht.
Neuen Array definieren resp. bestehenden Array zurücksetzen.
Bestimmten Eintrag entfernen. Fehler, wenn Eintrag nicht vorhanden ist. Geliefert wird neue Anzahl Einträge.
Liefert Anzahl Einträge. Fehler, wenn Array nicht definiert wurde.
Bestimmten Eintrag abholen. Fehler wenn dieser nicht existiert.
Ermittelt, ob ein bestimmter Array existiert.
Bestimmten Eintrag setzen resp. ersetzen. Array wächst automatisch falls nötig.

XFAS

Service
Beschreibung
Eine Spalte für die Rückgabe von Binärdaten hinzufügen. Als Werte müssen Dateinamen mit Pfad abgefüllt werden. Abkürzung für 'XFAS(headBinary=name)'.
Wert für die nächste Zelle hinzufügen. Abkürzung für 'XFAS(cell=value)'.
Mehrere Zellen hinzufügen. Abkürzung für 'XFAS(cells=val1,val2,...)'.
Eine Spalte hinzufügen. Abkürzung für 'XFAS(head=name)'.
Mehrere Spalten hinzufügen. Abkürzung für 'Abkürzung für 'XFAS(heads=name1,name2,...)'.
Wert für die letzte Zelle ergänzen. Abkürzung für 'XFAS(cellAppend=value)'.
MLS-Meldungs-Parameter hinzufügen (Mehrfachaufruf möglich). Abkürzung für 'XFAS(mMlsTextParam=text)'.
Aktuellen Inhalt (insbesondere Spalten und Zeilen) zurücksetzen. Abkürzung für 'XFAS(clear)'.
Ist eine Spalte mit dem übergebenen Namen vorhanden? Abkürzung für 'XFAS(head?name)'.
Ist XFAS-Rückgabe im aktuellen Kontext möglich? Abkürzung für 'XFAS(fasActive)'.
Ist XFAS-Rückgabe definiert? Sprich: Liefert der Script-Aufruf eine XFAS-Rückgabe oder nicht.
Ist aktuell eine 'Direct-Response' vorhanden?
Eine Zeile abschliessen und gleichzeitig eine neue eröffnen. Abkürzung für 'XFAS(newRow)'.
Wert für eine bestimmte Spalte setzen. Abkürzung für 'XFAS(col=ColName,value)'.
MLS-Meldungs-Schlüssel setzen (setzt allfällig gesetzte Parameter zurück). Abkürzung für 'XFAS(mMlsKey=key)'.
Meldungs-Schlüssel setzen. Abkürzung für 'XFAS(mKey=key)'.
Meldungs-Text setzen. Abkürzung für 'XFAS(mText=text)'.
'Erfolgreich'-Flag setzen. Abkürzung für 'XFAS(ok=0|1)'.
Redo-Daten setzen. Abkürzung für 'XFAS(redoData=redoData)'.

XRES

Service
Beschreibung
Liefert Spalten-Namen anhand Spalten-Nummer. Fehler wenn nicht vorhanden
Liefert Wert einer Spalte anhand Spalten-Namen und Zeilen-Nummer (ohne Übergabe Zeile 1). Fehler wenn nicht vorhanden
Liefert Wert einer Spalte anhand Spalten-Nummer und Zeilen-Nummer (ohne Übergabe Zeile 1). Fehler wenn nicht vorhanden
Liefert Dauer der Ausführung in Millisekunden
Liefert Meldungs-Schlüssel
Liefert Meldungs-Text (ohne allfällige UI- und Log-Meldungen)
Liefert Meldungs-Text (inkl. allfällige UI- und Log-Meldungen)
Liefert in Meldungs-Text enthaltene Log-Meldungen (in JSON-Format)
Liefert in Meldungs-Text enthaltene UI-Meldungen (in JSON-Format)
Liefert Anzahl Rückgabespalten
Liefert Anzahl Zeilen
Liefert Info, ob Service-Ausführung erfolgreich war
Redo-Daten abholen (geliefertes Daten-Format ist 'private')
Ermittelt, ob ein bestimmtes Objekt existiert.
Service erneut ausführen und 'Erfolgreich'-Info zurückgeben
Log- und UI-Meldungen in eigene/aktuelle Response übernehmen

XSER

Service
Beschreibung
Service-Argument hinzufügen.
Service-Argumente hinzufügen.
Redo-Argumente hinzufügen.
Redo-Daten hinzufügen.
Wert zum letzten Service-Argument hinzufügen. Fehler, wenn noch kein Argument vorhanden ist.
Wert zu einem bestimmten Service-Argument (identifiziert anhand Nummer) hinzufügen. Fehler, wenn Argument noch nicht vorhanden ist.
XSer-Objekt zurücksetzen. Insbesondere adressierter Service und Argumente werden zurückgesetzt. Objekt selber existiert jedoch weiterhin.
Service ausführen, Resultat in XRes speichern und 'Erfolgreich'-Info als Rückgabewert.
Service ausführen, Resultat in 'XFAS-Direct-Response' zurückgeben, Header-Infos auch via XRes mit Namen 'XFAS' verfügbar und 'Erfolgreich'-Info als Rückgabewert liefern.
Liefert den Wert eines bestimmten Arguments. Fehler, wenn Argument nicht vorhanden ist.
Liefert Anzahl der aktuell vorhandenen Argumente.
Aktuell gesetzten Service-Port und -Namen abholen.
Ermittelt, ob ein bestimmtes Objekt existiert.
Bestimmtes Service-Argument (identifiziert anhand Nummer) setzen.
Service-Argumente setzen. Allfällig vormals vorhandene Argumente werden zurückgesetzt.
XSer-Objekt für einen bestimmten Service-Aufruf erzeugen (falls nötig). Allfällig vormals vorhandene Argumente bleiben erhalten.
XSer-Objekt für einen bestimmten Service-Aufruf erzeugen (falls nötig) und die übergebenen Argumente setzen. Allfällig vormals vorhandene Argumente werden zurückgesetzt.

XTAB

Service
Beschreibung
Spalte hinzufügen. Zurückgegeben wird Nummer der eingefügten Spalte. Aktuell unterstützt werden die Datentypen 'A', 'B', 'D' und 'R'. Standardmässig (ohne nähere Angabe) wird eine 'A'-Spalte erstellt.
Index (Unique-Constraint) anhand der übergebenen Spalten-Namen hinzufügen. Zurückgegeben wird Index-Nummer. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Index (Unique-Constraint) anhand der übergebenen Spalten-Nummern hinzufügen. Zurückgegeben wird Index-Nummer. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Zusätzliche Zeile hinzufügen, wobei die Spalten-Werte optional mitgegeben werden können. Fehler, wenn Constraint-Violation (üblicherweise Unique-Index-Verletzung). Fehler, wenn einer der übergebenen Werte nicht passt und auch nicht umgewandelt werden kann.
Zusätzliche Zeile hinzufügen, wobei die Spalten-Werte optional mitgegeben werden können. Fehler, wenn Constraint-Violation (üblicherweise Unique-Index-Verletzung). Fehler, wenn einer der übergebenen Werte nicht passt und auch nicht umgewandelt werden kann. Zurückgegeben wird die Nummer der neu eingefügten Row (wenn diese gemäss allfällig vorhandenem Filter sichtbar ist - ansonsten 0). ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
View (Filter und Sortierung) zurücksetzen.
Filter zurücksetzen. Zurückgegeben wird die Anzahl Zeilen welche nach dem Entfernen des Filters sichtbar ist (alle Zeilen).
Sortierreihenfolge zurücksetzen.
Neue Tabelle definieren resp. bestehende Tabelle (Daten und Struktur) zurücksetzen.
Bestimmte Zeile löschen (standardmässig unter Einbezug einer allfälligen View). Fehler wenn adressierte Zeile nicht existiert.
Alle Zeilen löschen (standardmässig unter Einbezug einer allfälligen View). Zurückgegeben wird die Anzahl gelöschter Zeilen.
Liefert Nummer der ersten passenden Zeile. 0 wenn keine Zeile passt. Übergebenes Filter wirkt (standardmässig) additiv zu für ganze Tabelle gesetztem View-Filter (kann durch entsprechendes Argument übersteuert werden). ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Liefert Nummer, der für die übergebenen Index-Segmente passenden Zeile. 0 wenn keine Zeile passt. Allenfalls für Tabelle gesetzte View wird miteinbezogen, das heisst nur zu Filter passende Zeilen sind für Prüfung relevant. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Liefert Nummer, der für die übergebenen Index-Segmente passenden Zeile. 0 wenn keine Zeile passt. Allenfalls für Tabelle gesetzte View wird _NICHT_ miteinbezogen, das heisst alle Zeilen sind für Prüfung relevant. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Boolean abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird false geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Boolean abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird false geliefert.
Liefert Spalten-Datentyp und Format zum übergebenen Spalten-Namen. Standardmässig Fehler, wenn nicht vorhanden. Andernfalls Leerstring.
Liefert Spalten-Datentyp und Format zur übergebenen Spalten-Nummer. Standardmässig Fehler, wenn nicht vorhanden. Andernfalls Leerstring.
Liefert Spalten-Namen zur übergebenen Spalten-Nummer. Standardmässig Fehler, wenn nicht vorhanden. Andernfalls Leerstring.
Liefert Spalten-Nummer zum übergebenen Spalten-Namen. Standardmässig Fehler, wenn nicht vorhanden. Andernfalls 0.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Datum abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 'Leer-Datum' (01.01.0001) geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Datum abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 'Leer-Datum' (01.01.0001) geliefert.
Liefert Anzahl Spalten.
Liefert Anzahl Zeilen (standardmässig unter Einbezug einer allfälligen View).
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Zahl abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 0.0 geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Zahl abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 0.0 geliefert.
Liefert Nummer einer Zeile gemäss Schlüssel-Werten oder 0 falls nicht vorhanden. Prüfung in View (= nur Zeilen gemäss Filter). Sortierung gemäss Schlüssel muss aktiv sein! Auch für Tabellen mit vielen Zeilen schnell.
Liefert Nummer einer Zeile gemäss Schlüssel-Werten oder 0 falls nicht vorhanden. Prüfung in ganzer Tabelle ohne View (= alle Zeilen). Auch für Tabellen mit vielen Zeilen schnell.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als String abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird '' (Leerstring) geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als String abholen. Fehler wenn Casting nicht möglich ist. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird '' (Leerstring) geliefert.
Aktuellen Filter abholen.
Prüfen ob Spalte mit dem übergebenen Namen vorhanden ist.
Prüfen ob Spalte mit der übergebenen Nummer vorhanden ist.
Prüfen ob Index mit der übergebenen Nummer vorhanden ist.
Prüft, ob bereits eine Zeile für die übergebenen Index-Segmente vorhanden ist. Allenfalls für Tabelle gesetzte View- wird miteinbezogen, das heisst nur zu Filter passende Zeilen sind für Prüfung relevant. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Prüft, ob bereits eine Zeile für die übergebenen Index-Segmente vorhanden ist. Allenfalls für Tabelle gesetzte View wird NICHT miteinbezogen, das heisst alle Zeilen sind für Prüfung relevant. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Ist eine bestimmte Zeile gemäss Schlüssel-Werten bereits vorhanden? Prüfung in View (= nur Zeilen gemäss Filter). Sortierung gemäss Schlüssel muss aktiv sein! Auch für Tabellen mit vielen Zeilen schnell.
Ist eine bestimmte Zeile gemäss Schlüssel-Werten bereits vorhanden? Prüfung in ganzer Tabelle ohne View (= alle Zeilen). Auch für Tabellen mit vielen Zeilen schnell.
Ermittelt, ob eine bestimmte Tabelle existiert.
Schlüssel gemäss den übergebenen Spalten setzen. Definiert automatisch einen 'Unique - Constraint'. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Schlüssel gemäss den übergebenen Spalten setzen. Definiert automatisch einen 'Unique - Constraint'. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Einen Wert setzen (standardmässig unter Einbezug einer allfälligen View). Fehler, wenn Constraint-Violation (üblicherweise Unique-Index-Verletzung). Fehler, wenn übergebener Wert nicht zur adressierten Spalte passt und auch nicht umgewandelt werden kann. Standardmässig Fehler, wenn Spalte oder Zeile nicht existiert. Rückgabewert besagt, ob Wert gesetzt wurde oder nicht.
Einen Wert setzen (standardmässig unter Einbezug einer allfälligen View). Fehler, wenn Constraint-Violation (üblicherweise Unique-Index-Verletzung). Fehler, wenn übergebener Wert nicht zur adressierten Spalte passt und auch nicht umgewandelt werden kann. Standardmässig Fehler, wenn Spalte oder Zeile nicht existiert. Rückgabewert besagt, ob Wert gesetzt wurde oder nicht.
Einen Filter setzen: Nach dem Setzen ist nur noch ein Subset der Zeilen sichtbar. Zurückgegeben, wird die Anzahl der 'sichtbaren' Zeilen. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Sortierreihenfolge gemäss den übergebenen Spalten-Namen setzen. Prefix '-' = absteigende Sortierung. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Sortierreihenfolge gemäss den übergebenen Spalten-Nummern setzen. Negative Nummern = absteigende Sortierung. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Sortierreihenfolge gemäss Index setzen. Fehler wenn Index nicht vorhanden ist. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Sortierreihenfolge gemäss Schlüssel setzen. Fehler wenn Schlüssel nicht definiert wurde.
Zusätzliche Zeile hinzufügen, wobei die Spalten-Werte optional mitgegeben werden können. Im Constraint-Violation-Fehlerfall (üblicherweise Unique-Index-Verletzung) wird nicht eingefügt und false zurückgegeben. Wenn einer der übergebenen Werte nicht passt und auch nicht umgewandelt werden kann, wird nicht eingefügt und false zurückgegeben. Wenn erfolgreich eingefügt werden kann, wird true zurückgegeben.
Zusätzliche Zeile hinzufügen, wobei die Spalten-Werte optional mitgegeben werden können. Zurückgegeben wird die Nummer der neu eingefügten Row (wenn diese gemäss allfällig vorhandenem Filter sichtbar ist - ansonsten 0). Im Constraint-Violation-Fehlerfall (üblicherweise Unique-Index-Verletzung) wird nicht eingefügt und -1 zurückgegeben. Wenn einer der übergebenen Werte nicht passt und auch nicht umgewandelt werden kann, wird nicht eingefügt und -2 zurückgegeben. ACHTUNG: Kann bei Tabellen mit vielen Zeilen langsam sein!
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Boolean abholen. Wenn Casting nicht möglich ist, wird false zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird false geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Boolean abholen. Wenn Casting nicht möglich ist, wird false zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird false geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Datum abholen. Wenn Casting nicht möglich ist, wird 'Leer-Datum' (01.01.0001) zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 'Leer-Datum' (01.01.0001) geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Datum abholen. Wenn Casting nicht möglich ist, wird 'Leer-Datum' (01.01.0001) zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 'Leer-Datum' (01.01.0001) geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Zahl abholen. Wenn Casting nicht möglich ist, wird 0.0 zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 0.0 geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als Zahl abholen. Wenn Casting nicht möglich ist, wird 0.0 zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird 0.0 geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als String abholen. Wenn Casting nicht möglich ist, wird '' (Leerstring) zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird '' (Leerstring) geliefert.
Bestimmten Wert (standardmässig unter Einbezug einer allfälligen View) als String abholen. Wenn Casting nicht möglich ist, wird '' (Leerstring) zurückgegeben. Standardmässig Fehler, wenn adressierter Wert nicht vorhanden ist. Wenn dieser Fehler unterdrückt wird, wird '' (Leerstring) geliefert.
Einen Wert falls möglich setzen (standardmässig unter Einbezug einer allfälligen View). Im Constraint-Violation-Fehlerfall (üblicherweise Unique-Index-Verletzung) wird Wert nicht gesetzt. Im Casting-Fehlerfall (übergebener Wert passt nicht zur adressierten Spalte und kann auch nicht umgewandelt werden) wird Wert nicht gesetzt. Rückgabewert besagt, ob Wert gesetzt wurde oder nicht. Standardmässig Fehler, wenn Spalte oder Zeile nicht existiert.
Einen Wert falls möglich setzen (standardmässig unter Einbezug einer allfälligen View). Im Constraint-Violation-Fehlerfall (üblicherweise Unique-Index-Verletzung) wird Wert nicht gesetzt. Im Casting-Fehlerfall (übergebener Wert passt nicht zur adressierten Spalte und kann auch nicht umgewandelt werden) wird Wert nicht gesetzt. Rückgabewert besagt, ob Wert gesetzt wurde oder nicht. Standardmässig Fehler, wenn Spalte oder Zeile nicht existiert.