Changes between Version 24 and Version 25 of S3/S3XML

Timestamp:

07/19/11 12:16:50 (13 years ago)

Author:

Dominic König

Comment:

--

S3/S3XML

@@ -89 +89 @@
 A source file in the server file system can be specified using the ''filename'' URL variable:
 {{{
-PUT http://<server>/<resource>?filename=<path>
+PUT http://<server>/<controller>/<resource>?filename=<path>
 }}}
 
 Multiple files can be specified as list of comma-separated pathnames:
 {{{
-PUT http://<server>/<resource>?filename=<path>,<path>,<path>
+PUT http://<server>/<controller>/<resource>?filename=<path>,<path>,<path>
 }}}
 
@@ -102 +102 @@
 
 {{{
-PUT http://<server>/<resource>?fetchurl=<url>
+PUT http://<server>/<controller>/<resource>?fetchurl=<url>
 }}}
 
 Multiple files can be specified as list of comma-separated pathnames:
 {{{
-PUT http://<server>/<resource>?fetchurl=<url>,<url>,<url>
+PUT http://<server>/<controller>/<resource>?fetchurl=<url>,<url>,<url>
 }}}
 
@@ -129 +129 @@
 
 The default behavior for duplicate resolution in standard import mode is to update the exiting records with the values from the source record. In synchronization mode, though, the default is to accept the newest data.
+
+=== Data Format Conversion and Transformation ===
+
+S3XML interfaces may provide built-in codecs to convert and transform the input or output data from/to various data formats:
+
+[[Image(ConversionTransformation.png)]]
+
+The current S3 implementation provides built-in codecs for CSV, XML and JSON (PDF with OCR to come).
+
+XSLT stylesheets for the format transformations can be built-in on the server (found by the request URL file extension), or can be specified by the client. The client may use the ''transform'' URL variable to specify the path (on the server file system) or URL of the XSLT stylesheet:
+{{{
+GET http://<server>/<controller>/<resource>.<extension>?transform=<path_or_url>
+}}}
+
+Alternatively, the client may attach the stylesheet to the request body. In this case the stylesheet's file name must be: <resource>.xslt.
+
+The ''transform'' variable overrides any attached or built-in stylesheets, and attached stylesheets override built-in stylesheets. The ''.xml'' request URL extension is reserved for the native S3XML format, and must not use or accept any stylesheets.
+
 == XML Format ==