Changes between Version 10 and Version 11 of S3XRC/S3XML


Ignore:
Timestamp:
05/03/11 19:28:06 (10 years ago)
Author:
Dominic König
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • S3XRC/S3XML

    v10 v11  
    2424||'''Contents'''||''empty''||
    2525
     26The root element.
     27
     28Attributes:
     29||'''Name'''||'''Type'''||'''Description'''||'''mandatory?'''||
     30||'''domain'''||string||the domain name of the data repository||''no''||
     31
    2632==== resource ====
    2733||'''Parent elements'''||[#s3xml s3xml], [#resource resource], [#reference reference]||
     
    3036
    3137Represents a record.
     38
     39Attributes:
     40||'''Name'''||'''Type'''||'''Description'''||'''mandatory?'''||
     41||'''name'''||string||the name of the resource, usually the DB table name||''yes''||
     42||'''uuid'''||string||a unique identifier for the record||''(yes)''**||
     43||'''tuid'''||string||a temporary unique identifier for the record||''(yes)''**||
     44
     45(**) Records will be identified within the input file by their {{{uuid}}}, or, if no {{{uuid}}} is specified, by their {{{tuid}}}. While {{{uuid}}}s would be stored in the database and thus can be used to identify the record even in the database, {{{tuid}}}s will not be stored, but replaced by an internally generated UUID at import. Thus, {{{tuid}}}s cannot be used to update records in the database.
     46
    3247==== data ====
    3348||'''Parent elements'''||[#resource resource]||
     
    5267||'''Child elements'''||[#resource resource]||
    5368||'''Contents'''||Text||
     69
     70Represents a foreign key reference.
     71
     72Attributes:
     73||'''Name'''||'''Type'''||'''Description'''||'''mandatory?'''||
     74||'''field'''||string||the field name in the record||''yes''||
     75||'''resource'''||string||the name of the referenced resource, usually the tablename||''yes''||
     76||'''uuid'''||string||the unique identifier of the referenced record*||''(yes)''**||
     77||'''tuid'''||string||a temporary identifier for a referenced record in the same source*||''(yes)''**||
     78
     79(*) Referenced records would always be exported in the same output file. If a referenced record is found in the same input file, then it will be automatically imported.
     80
     81(**) Records will be identified within the input file by their {{{uuid}}}, or, if no {{{uuid}}} is specified, by their {{{tuid}}}.
     82
     83If the referenced record is enclosed in the ''reference'' element, then {{{uuid}}} and {{{tuid}}} can be omitted:
     84
     85{{{
     86<s3xml>
     87   <resource name="xxxyyy">
     88       <reference field="xy" resource="aaabbb">   <!-- the reference element, uuid/tuid can be omitted if -->
     89          <resource name="aaabbb">                <!-- the referenced record is enclosed in the reference -->
     90          </resource>
     91       </reference>
     92   </resource>
     93</s3xml>
     94}}}
    5495
    5596=== Example ===