Inhaltsverzeichnis
mi_InsertTempdb_OneID
Dient dem Einfügen von Werten in die Tabelle „OneID“ der Tabelle „tempdb“. (Wird z.B. für im_GetBinaryCodeIDsForNode_Pu oder pm_GetPersonProperties_Ad benötigt.)
Anmerkung:
Grundsätzliche Vorgehensweise der mi_InsertTemp...-Prozeduren für Tabellen der Datenbank „tempdb“: In den „Listen-Parametern“ werden Werte (durch '¶' getrennt bzw. durch ein anderes Zeichen, wenn ein entsprechender Parameter vorhanden ist) übergeben, aus denen die jeweilige Prozedur einen Datensatz bildet und in die zugehörige Tabelle einfügt. Der erste Datensatz wird aus den jeweils ersten Elementen der „Listen-Parameter“ zusammengesetzt, der zweite Datensatz aus den jeweils zweiten Elementen usw. Das bedeutet insbesondere, daß alle „Listen-Parameter“ die GLEICHE Anzahl Elemente enthalten müssen, sonst gibt es einen Fehler („-500“).
Hintergrund:
Für stored procedures gibt es leider keine „array“-Parameter. Als work-around werden sogenannte permanente, temporäre Tabellen (in der speziellen Datenbank „tempdb“) verwendet. Da mehrere Prozesse diese Tabellen gleichzeitig verwenden können, gibt es in jeder dieser Tabellen eine Spalte „spid“, damit jeder Prozeß seine (eindeutige) „Server-Process-ID“ („SELECT spid“) zusammen mit den gewünschten Daten speichern kann. So wird verhindert, daß Prozesse (versehentlich oder absichtlich) auf Daten anderer Prozesse zugreifen können.
| HTTP-Method | POST |
| HTTP-Auth | Optional |
| Tags | |
| Engine-Kategorie | miscellaneous |
| Engine-Typ | Daten-Änderung |
| Letzte Aktualisierung | 7.0.4 (2014-03-19) |
Parameter
| Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
|---|---|---|---|---|
| IDList | Liste von IDs, durch die in „ListSeparator“ angegebene Zeichenkette getrennt. Die angegebenen Werte werden in der Spalte „ID1“ gespeichert. | varchar(16384) | 3.5.0 | |
| Delete | 0 | „0“ : Keine Daten vorher löschen „1“ : Alle Datensätze zur „spid“ vorher löschen | bit | 3.5.0 |
| ListSeparator | '¶' | Gibt an, durch welche Zeichenkette die Werte in „IDList“ getrennt sind | varchar(4) | 7.0.4 |
Rückgabe
Die Prozedur hat keine Rückgaben.
Output-Parameter
Die Prozedur hat keine Output-Parameter.
Mögliche Return-Codes
| Code | Beschreibung | Quelle 4) |
|---|---|---|
| -500 | Falsche Parameter | nur direkt |
XML-Schema
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
Historie
| 7.0.4 | 2014-03-19 | Neuer Parameter „ListSeparator“ |
| 6.5.2 | 2013-02-26 | 1. „IDList“ wurde erweitert [von „255“ auf „16384“] 2. „Separator“ wurde erweitert [von „1“ auf „4“] 3. Anpassungen an den aktuellen Quellcode-Standard 4. Etwas optimierte Abarbeitung |
| 3.5.13 | 2001-12-06 | |
| 3.5.0 | 2000-11-23 | Erstmalig in dieser Version erstellt |
Code-Snippets
Es handelt sich um eine Methode zum Füllen von Schnittstellentabelle wie in Hintergrundinformationen zu Engine-Prozeduren erläutert. Die Methode kann ausschließlich per engine/execute in einem gemeinsamen Batch mit komplementären Prozeduren verwendet werden.
engine/execute
XML zur Ausführung mit der Methode engine/execute, z.B. per
curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'
<?xml version="1.0" encoding="UTF-8"?> <ListOfBatches> <Batch No="0"> <Procedure Name="mi_InsertTempdb_OneID"> <Parameters/> </Procedure> </Batch> </ListOfBatches>