4D v16.3

XML

Home

 
4D v16.3
XML

XML 

 

Constant  Type Value Comment
Copy XML data source  Longint 1 4D keeps a copy of the DOM tree with the picture, which means the picture can be saved in a picture field of the database and then redisplayed or exported at any time.
DOCTYPE Name  Longint 3 Name of the root element as defined in the DOCTYPE marker
Document URI  Longint 6 URI of the DTD
Encoding  Longint 4 Encoding used (UTF-8, ISO...)
Get XML data source  Longint 0 4D only reads the XML data source; it is not kept with the picture. This noticeably increases command execution speed; however, because the DOM tree is not kept, it is not possible to store or export the picture.
Own XML data source  Longint 2 4D exports the DOM tree with the picture. The picture can be stored or exported and command execution is fast. However, the elementRef XML reference can then no longer be used by other 4D commands. This is the default mode for exporting when the exportType parameter is omitted.
PUBLIC ID  Longint 1 Public identifier (FPI) of the DTD to which the document conforms (if the DOCTYPE xxx PUBLIC tag is present).
SYSTEM ID  Longint 2 System identifier
Version  Longint 5 Accepted XML version
XML Base64  Longint 1  
XML binary encoding  Longint 5 Specifies the way binary data will be converted.
Possible values:
  • XML Base64 (default value): binary data are simply converted to Base64
  • XML data URI scheme: binary data are converted to Base64 and the "data:;base64" header is added. This format mainly allows a browser to automatically decode a picture, and is also required for the insertion of pictures. For more information, see http://en.wikipedia.org/wiki/Data_URI_scheme.
XML case insensitive  Longint 2  
XML case sensitive  Longint 1  
XML CDATA  Longint 7  
XML comment  Longint 2  
XML convert to PNG  Longint 1  
XML DATA  Longint 6  
XML data URI scheme  Longint 2  
XML date encoding  Longint 2 Specifies the way 4D dates will be converted. For example, !01/01/2003! in the Paris time zone.
Possible values:
  • XML ISO (default value): use of the format xs:datetime without indication of time zone. Result: "2003-01-01". The time part, if it is present in the 4D value (via SQL) is lost.
  • XML local: use of the format xs:date with indication of time zone. Result: "2003-01-01 +01:00". The time part, if it is present in the 4D value (via SQL) is lost.
  • XML datetime local: use of the format xs:dateTime (ISO 8601). Indication of time zone. This format allows the time part to be kept, if it is present in the 4D value (via SQL). Result: "<Date>2003-01-01T00:00:00 +01:00</Date>".
  • XML UTC: use of the format xs:date. Result: "2003-01-01Z". The time part, if it is present in the 4D value (via SQL) is lost.
  • XML datetime UTC: use of the format xs:dateTime (ISO 8601). This format allows the time part to be kept, if it is present in the 4D value (via SQL). Result: "<Date>2003-01-01T00:00:00Z</Date>".
XML datetime local  Longint 3  
XML datetime local absolute  Longint 1  
XML datetime UTC  Longint 5  
XML DOCTYPE  Longint 10  
XML DOM case sensitivity  Longint 8 Specifies the case sensitivity regarding element names for DOM Get XML element and DOM Count XML elements commands.
Possible values:
  • XML case sensitive (default value): commands are case sensitive.
  • XML case insensitive: commands are not case sensitive.
XML duration  Longint 2  
XML ELEMENT  Longint 11  
XML end document  Longint 9  
XML end element  Longint 5  
XML entity  Longint 8  
XML external entity resolution  Longint 7 Controls whether external entities are resolved in XML documents. For security reasons, by default both DOM and SAX 4D XML parsers do not allow external entity resolution. Note that the scope of this selector is the calling process (if preemptive) or all cooperative processes (if called from a cooperative process). It globally applies to all XML documents (the first parameter is ignored, you can pass an empty string).
Possible values:
  • XML enabled: allow external entity resolution in XML documents
  • XML disabled (default value): disallow external entity resolution (an external entity declaration generates a parser error)
XML indentation  Longint 4 Specifies the indentation of the XML document.
Possible values:
  • XML with indentation (default value): the document is indented.
  • XML no indentation: the document is not indented; its contents are placed in a single line.
XML ISO  Longint 1  
XML local  Longint 2  
XML native codec  Longint 2  
XML no indentation  Longint 2  
XML picture encoding  Longint 6 Specifies the way pictures must be converted (before encoding in Base64).
Possible values:
  • XML convert to PNG (default value): pictures are converted to PNG before being encoded in Base64.
  • XML native codec: pictures are converted in their first native storage CODEC before being encoded in Base64. You must use these options to encode SVG pictures (see example for the XML SET OPTIONS command).
XML processing instruction  Longint 3  
XML raw data  Longint 2  
XML seconds  Longint 4  
XML start document  Longint 1  
XML start element  Longint 4  
XML string encoding  Longint 1 Specifies the way 4D strings are converted to element values. It does not concern the conversion to attributes for which XML imposes the use of escape characters.
Possible values:
  • XML with escaping (default value): conversion of 4D strings to XML element values with replacement of characters. The Text type data are automatically parsed so that forbidden characters (<&>’) are replaced by XML entities (&amp;&lt;&gt; &apos;&quot;).
  • XML raw data: 4D strings are sent as raw data; 4D does not carry out encoding or parsing. 4D values are converted if possible to XML fragments and inserted as a child of the target element. If a value cannot be considered as an XML fragment, it is inserted as raw data into a new CDATA node.
XML time encoding  Longint 3 Specifies the way 4D times are converted. For example, ?02/00/46? (Paris time). The encoding differs depending on whether you want to express a time or a duration.
Possible values for times:
  • XML datetime UTC: time expressed in UTC (Universal Time Coordinated). Note that conversion to UTC is automatic. Result: "<Duration>0000-00-00T01:00:46Z</Duration>".
  • XML datetime local: time expressed with the time difference of the machine of the 4D engine. Result: "<Duration>0000-00-00T02:00:46+01:00</Duration>".
  • XML datetime local absolute (default value): time expressed without indication of time zone. No modification of the value. Result: "<Duration>0000-00-00T02:00:46</Duration>".
Possible values for durations:
  • XML seconds: number of seconds since midnight; no modification of the value since it expresses a duration. Result: "<Duration>7246</Duration>".
  • XML duration: duration expressed in compliance with XML Schema Part 2: Datatypes Second Edition. No modification of the value since it expresses a duration. Result: "<Duration>PT02H00M46S</Duration>".
XML UTC  Longint 4  
XML with escaping  Longint 1  
XML with indentation  Longint 1  


See also 

DOM Append XML child node
DOM GET XML CHILD NODES
DOM Get XML information
SAX Get XML node
SVG EXPORT TO PICTURE
XML GET OPTIONS
XML SET OPTIONS

 
PROPERTIES 

Product: 4D
Theme: List of constant themes

 
HISTORY 

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)