This transformer generates an XML document based on an XML Schema (XSD) file. While the sample document may not pass a schema validation, it will provide a generate outline of what a valid XML document looks like. The XML generated by this transformer can be used as a base for an XML template used in the XMLTemplater transformer.
In addition to generating entire XML documents, this transformer may also be used to generate small portions of an XML document. All that is required is the path to the element which is to be generated.
Note that in order to prevent infinite recursions, the transformer will not generate recursive complex types or substitution groups. Recursive types and substitution groups will be generated once, and nested types/groups will not be generated.
INPUT: There are no special requirements for the input features of this transformer. If the Path to Element parameter is set to an attribute value, the attribute should contain a valid XML path expression.
OUTPUT: Features output from this transformer will have an attribute containing an XML document that was generated from the XML schema file listed in the transformer parameters.
This parameter specifies the location of the XSD file from which the XML will be generated. It is important that the file selected for this parameter contains the definition of the element to be generated. Since it is common for an XSD file to import other XSD files, the value of this parameter may differ depending on the desired output of the transformer.
If an entire document is to be generated, you should select the "base" XSD file. If a specific element is to be generated, you might have to select a different XSD file.
This parameter serves two purposes:
/COLLADA/library_animations/animation
Note that this path must be namespace correct. That is, the path elements must match the target namespaces of the XSD schemas being used. For example, to generate a Data element in the AIXM schema, the following path may be used.
aixm:HoldingPatternTimeSlice/aixm:timeSliceMetadata/gmd:MD_Metadata/gmd:dateStamp/gco:Date
An XML schema may designate some XML attributes as optional. If this parameter is set to Yes, the optional attributes will be included in the XML output. If this parameter is set to No, only XML attributes marked as "required" will be included in the output document.
An XML schema may designate the minimum and maximum number of times an element may occur in a particular location. If this parameter is set to No, only elements whose minimum number of occurrences is greater than zero will be included in the output XML document. If this parameter is set to Yes, all elements will be included at least once in the output document.
This parameter controls the output when the XML schema contains abstract substitution groups.
This parameter controls the output when the XML schema contains an xs:choice. An xs:choice lists a number of possible elements which may appear in the output.
If this parameter is set to Yes, the output will be prefaced with an XML header. If the parameter is set to No, the output will not contain an XML header.
If this parameter is set to Yes, the output will contain XML comments describing the output.
These comments will describe what is required to convert the sample XML into an XML document that is valid according to the given schema. This includes warnings about recursive complex types and substitution groups, details on the acceptable multiplicity of elements and information on the data types that an element may contain.
This parameter specifies the attribute to which the XML document will be written. The default is _result.
About Transformer Parameter Options
Search for samples and information about this transformer on FMEpedia.