Datentabellen-Dienste
Es gibt eine Reihe von integrierten Diensten zum Verschieben von Daten in und aus Datentabellen, die für die Datentabellenform spezifisch sind. Es handelt sich um folgende:
|
Dienst
|
Beschreibung
|
||||
|---|---|---|---|---|---|
|
AddDataTableEntry (TAGS tags, VALUES values)
|
Übergeben Sie VALUES und optional tags. Eine Boolesche Rückgabe gibt einen Erfolg oder Fehler an.
|
||||
|
AddDataTableEntries
|
fügt mehrere Datentabelleneinträge hinzu.
|
||||
|
AddOrUpdateDataTableEntry (TAGS tags, VALUES values)
|
Übergeben Sie VALUES und optional tags. Gibt einen Zeichenfolgenwert der streamID des neuen oder aktualisierten Eintrags in der Datentabelle zurück. Aktualisiert eine Zeile, wenn sie vorhanden ist; andernfalls wird eine Zeile hinzugefügt.
|
||||
|
AddOrUpdateDataTableEntries
|
Fügt mehrere Datentabelleneinträge hinzu oder aktualisiert sie. Aktualisiert eine Zeile, wenn sie vorhanden ist; andernfalls wird eine Zeile hinzugefügt. Primäre Schlüssel müssen für Aktualisierung übereinstimmen.
|
||||
|
AssignDataTableEntries
|
Ersetzt vorhandene Datentabelleneinträge.
|
||||
|
DeleteDataTableEntry (STRING keyvalue)
|
Löscht einen einzelnen Eintrag basierend auf dem Schlüsselwert. Eine Boolesche Rückgabe gibt einen Erfolg oder Fehler an.
|
||||
|
DeleteDataTableEntries
|
Löscht mehrere Einträge, die den Werten in der ersten Zeile des Infotable-Eingabeparameters entsprechen. Beispiel: Eine Datentabelle enthält ein Feld namens Int01, und für drei Einträge ist Int01 auf 10 festgelegt. Bei der Ausführung löscht DeleteDataTableEntries alle drei Einträge, wenn 10 als Löschkriterium angegeben ist.
|
||||
|
FindDataTableEntries
|
Sucht nur Indizes, sodass dies evtl. schneller ist als der Dienst QueryDataTableEntries.
|
||||
|
GetDataTableEntries (NUMBER maxItems)
|
Gibt die letzten Einträge bis zur maximalen Anzahl der angeforderten Elemente zurück.
|
||||
|
GetDataTableEntry (STRING keyvalue)
|
Gibt eine Infotable einer Zeile mit dem übereinstimmenden Eintrag zurück.
|
||||
|
GetFieldNames
|
Gibt eine Liste mit den Feldnamen zurück, die dieser Datentabelle zugeordnet sind.
|
||||
|
PurgeDataTableEntries
|
Entfernt alle Einträge für diese Datentabelle. Eine Boolesche Rückgabe gibt einen Erfolg oder Fehler an.
|
||||
|
QueryDataTableEntries (NUMBER maxItems, STRING queryExpression, TAGS tags, VALUES query)
|
Gibt eine Infotable der Datensätze zurück, die den Anforderungsparametern entsprechen.
|
||||
|
SearchDataTableEntries
|
Gibt alle Datentabelleneinträge zurück, die den Suchabfrageparametern entsprechen. searchExpression ist der Schlüssel zu diesem Dienst; enthält Volltextsuche für die Felder STRING und TEXT. Die folgenden Filer können für searchExpression verwendet werden: + (Pluszeichen), Groß-/Kleinschreibung, ? (Fragezeichen), % (Prozentzeichen), AND und OR.
|
||||
|
UpdateDataTableEntry (TAGS tags, VALUES values)
|
Übergeben Sie values und optional tags. Eine Boolesche Rückgabe gibt einen Erfolg oder Fehler an. Aktualisiert eine Zeile, sofern vorhanden.
|
Beachtung von Groß- und Kleinschreibung bei Datentabellensuchen festlegen
Sie können einen Filter im Parameter query verwenden, damit bei Suchen in Datentabellen die Groß- und Kleinschreibung beachtet wird.
Hier ein Beispiel für den Dienst SearchDataTableEntries mit den folgenden Einträgen:
Sie können einen Filter definieren, damit der Parameter query bei der Rückgabe von Ergebnissen die Groß- und Kleinschreibung beachtet. Zum Beispiel:
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"AA"}}
Wenn Sie die Abfrage oben verwenden, werden die folgenden Ergebnisse zurückgegeben:
Hier ein anderes Beispiel mit demselben Dienst, in dem der folgende Filter im Parameter query verwendet wird:
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"aa"}}
Die folgenden Ergebnisse werden zurückgegeben:
