Changes between Version 24 and Version 25 of S3/S3XML


Ignore:
Timestamp:
07/19/11 12:16:50 (11 years ago)
Author:
Dominic König
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • S3/S3XML

    v24 v25  
    8989A source file in the server file system can be specified using the ''filename'' URL variable:
    9090{{{
    91 PUT http://<server>/<resource>?filename=<path>
     91PUT http://<server>/<controller>/<resource>?filename=<path>
    9292}}}
    9393
    9494Multiple files can be specified as list of comma-separated pathnames:
    9595{{{
    96 PUT http://<server>/<resource>?filename=<path>,<path>,<path>
     96PUT http://<server>/<controller>/<resource>?filename=<path>,<path>,<path>
    9797}}}
    9898
     
    102102
    103103{{{
    104 PUT http://<server>/<resource>?fetchurl=<url>
     104PUT http://<server>/<controller>/<resource>?fetchurl=<url>
    105105}}}
    106106
    107107Multiple files can be specified as list of comma-separated pathnames:
    108108{{{
    109 PUT http://<server>/<resource>?fetchurl=<url>,<url>,<url>
     109PUT http://<server>/<controller>/<resource>?fetchurl=<url>,<url>,<url>
    110110}}}
    111111
     
    129129
    130130The 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.
     131
     132=== Data Format Conversion and Transformation ===
     133
     134S3XML interfaces may provide built-in codecs to convert and transform the input or output data from/to various data formats:
     135
     136[[Image(ConversionTransformation.png)]]
     137
     138The current S3 implementation provides built-in codecs for CSV, XML and JSON (PDF with OCR to come).
     139
     140XSLT 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:
     141{{{
     142GET http://<server>/<controller>/<resource>.<extension>?transform=<path_or_url>
     143}}}
     144
     145Alternatively, the client may attach the stylesheet to the request body. In this case the stylesheet's file name must be: <resource>.xslt.
     146
     147The ''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.
     148
    131149== XML Format ==
    132150