engine:procedures:mi_getfieldtypes_pu
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| — |
engine:procedures:mi_getfieldtypes_pu [11.01.2016 ] (aktuell) |
||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| + | ===== mi_GetFieldTypes_Pu ===== | ||
| + | |||
| + | Gibt alle Datentypen (oder nur einen bestimmten), die der "dStore" unterstützt, zurück.\\ | ||
| + | |||
| + | Hintergrund:\\ Zur Speicherung von Eigenschaften (z.B. Personen- oder Artikeleigenschaften) wird immer ein "varchar"-Datentyp in der Datenbank verwendet. Manchmal möchte man jedoch sicherstellen, daß man bestimmte Eigenschaften in eine Zahl oder ein Datum konvertieren kann. Dies wird im "dStore" durch die "FieldTypes" realisiert, anhand der die Eingaben entsprechend überprüft und evtl. abgewiesen werden.\\ Aus diesem Grund ist es UNBEDINGT NOTWENDIG, daß AUSSCHLIESSLICH "dStore"-Prozeduren zur Manipulation von Daten verwendet werden und NIEMALS direkte "Updates"/"Inserts" ausgeführt werden (ausgenommen Schnittstellen-Tabellen oder wo sonst explizit erlaubt).\\ | ||
| + | |HTTP-Method|GET | | ||
| + | |HTTP-Auth|Optional | | ||
| + | |Tags|{{tag>[mi Get Field Types Pu]}}| | ||
| + | |Engine-Kategorie|miscellaneous | | ||
| + | |Engine-Typ|Daten-Ermittlung | | ||
| + | |Letzte Aktualisierung|3.5.18 (2002-05-15)| | ||
| + | |||
| + | ==== Parameter ==== | ||
| + | |||
| + | ^Name ((Pflichtparameter sind unterstrichen)) ^Standard-Wert ^Beschreibung ((siehe [[webservice:engine_parameterconventions|Parameter-Konventionen engine/<Prozedur-Name>]])) ^SQL-Datentyp((siehe [[:webservice:engine_datatypes|Datentypen im Bereich "engine"]])) ^ab Version ^ | ||
| + | |__FieldTypeID__| |ID eines Datentyps. Optional, um nur den Datensatz eines Datentyps zurückzubekommen.\\ |tinyint|3.5.18| | ||
| + | ==== Rückgabe ==== | ||
| + | |||
| + | === (parameterunabhängig) === | ||
| + | |||
| + | ^Spaltenname ^Beschreibung ^SQL-Datentyp((siehe [[:webservice:engine_datatypes|Datentypen im Bereich "engine"]])) ^ab Version ^ | ||
| + | |FieldTypeID|ID eines Datentyps\\ |tinyint|3.5.0 | | ||
| + | |BasicFieldType|Der Basis-Daten-Typ, mögliche Werte :\\ * Ja-Nein (intern immer als "0" und "1" gespeichert)\\ * Zahl\\ * Text\\ * Datum\\ * Uhrzeit\\ * Datum und Uhrzeit\\ * vergangenes Datum\\ |varchar(20)|3.5.0 | | ||
| + | |FieldTypeDescription|Bezeichnung des Datentyps "FieldTypeID", z.B. "Ganze Zahlen von -999 bis 999" oder "Text - 20 Zeichen"\\ |varchar(100)|3.5.0 | | ||
| + | |MaxLength|Maximale Anzahl Zeichen, die Eigenschaften/Werte vom Datentyp "FieldTypeID" haben dürfen\\ |tinyint|3.5.0 | | ||
| + | |PrecisionValue|Gilt nur für Datentypen mit Basis-Daten-Typ "Zahl" und gibt die Anzahl erlaubter Nachkommastellen an\\ |tinyint|3.5.0 | | ||
| + | ==== Output-Parameter ==== | ||
| + | |||
| + | Die Prozedur hat keine Output-Parameter.==== Mögliche Return-Codes ==== | ||
| + | |||
| + | Die Prozedur hat keine Fehlercodes. | ||
| + | ==== XML-Schema ==== | ||
| + | |||
| + | Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema [[http://resources.dstore.de/xsd/webservice_SmartGate/Response/EngineProcedure_v1_0.xsd|Response/EngineProcedure_v1_0.xsd]] validiert. | ||
| + | ==== Historie ==== | ||
| + | |||
| + | |3.5.18 |2002-05-15|\\ | | ||
| + | |||
| + | ==== Code-Snippets ==== | ||
| + | |||
| + | == Engine Playground == | ||
| + | Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist: | ||
| + | * [[http://playground.dstore.de/index.php?proc=mi_GetFieldTypes_Pu|mi_GetFieldTypes_Pu im Engine Playground öffnen]] | ||
| + | == cURL == | ||
| + | Unformatierte Ausgabe: | ||
| + | <code bash> | ||
| + | curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/mi_GetFieldTypes_Pu?FieldTypeID=<value>'</code>Mit xmllint ((I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org)) formatierte Ausgabe: | ||
| + | <code bash> | ||
| + | curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/mi_GetFieldTypes_Pu?FieldTypeID=<value>' | xmllint --format -</code>== dStore_php == | ||
| + | <code php> | ||
| + | use dStore_php\WebService; | ||
| + | |||
| + | $service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80); | ||
| + | |||
| + | $request = new WebService\Requests\Engine\Procedure\Request( | ||
| + | new WebService\Requests\AccessData('default'), | ||
| + | 'mi_GetFieldTypes_Pu', | ||
| + | array( | ||
| + | 'FieldTypeID' => <value> | ||
| + | ) | ||
| + | ); | ||
| + | |||
| + | $service->execute($request); | ||
| + | |||
| + | $xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument(); | ||
| + | $ResultSet = $xml_result->getRowsAsArray(); | ||
| + | |||
| + | </code> | ||
| + | == engine/execute == | ||
| + | XML zur Ausführung mit der Methode [[:webservice:engine:execute|engine/execute]], z.B. per | ||
| + | curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>' | ||
| + | |||
| + | <code xml> | ||
| + | <?xml version="1.0" encoding="UTF-8"?> | ||
| + | <ListOfBatches> | ||
| + | <Batch No="0"> | ||
| + | <Procedure Name="mi_GetFieldTypes_Pu"> | ||
| + | <Parameters> | ||
| + | <Parameter Name="FieldTypeID"><!-- tinyint value --></Parameter> | ||
| + | </Parameters> | ||
| + | </Procedure> | ||
| + | </Batch> | ||
| + | </ListOfBatches></code> | ||
engine/procedures/mi_getfieldtypes_pu.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)