XMLSampleGenerator
This transformer generates an XML document based on an XML Schema (XSD) file.而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 theXMLTemplatertransformer.
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 Ports
There are no special requirements for the input features of this transformer.如果 the Path to Element parameter is set to an attribute value, the attribute should contain a valid XML path expression.
Output Ports
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.
Parameters
Schema
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.
如果 an entire document is to be generated, you should select the "base" XSD file.如果 a specific element is to be generated, you might have to select a different XSD file.
This parameter serves two purposes:
- 首先,对于包含多个顶级元素XSD文件,您可以使用此参数来指定哪些元素产生。
- 其次,你可以使用这个参数,指示变压器产生不是一个顶级元素的元素。要做到这一点,进入相应的元素作为参数值的路径。例如,下面的路径可以被用于生成从所述的Collada 1.4模式的动画元素:
/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 Date element in the AIXM schema, the following path may be used.
aixm:HoldingPatternTimeSlice/aixm:timeSliceMetadata/gmd:MD_Metadata/gmd:dateStamp/gco:Date
This parameter may be used to exclude elements from the generated XML.Multiple element names may be entered in a space separated list.As in the path parameter, the element names in this parameter must be namespace correct;the element names must use the same namespace prefixes as the XSD files.Wildcards may be used in the element names.For example, the following value will cause all elements in the gml namespace to be excluded, along with the gmd:dateStamp element.
gml:* gmd:dateStamp
如果 the generated XML is being annotated with comments, a comment will be inserted for each excluded element.
XML Generation
An XML schema may designate some XML attributes as optional.如果 this parameter is set to Yes, the optional attributes will be included in the XML output.如果 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.如果 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.如果 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.
- 首先仅限会员:这是此参数的默认值。仅置换组的第一个成员将被生成。
- 全部成员:取代组的所有成员将被生成。一般情况下,一个抽象的取代基应该由单一的部件取代。该参数可用于检查所有可能的取代基的成员。使用该值可能导致这是非常大的输出文档。
- 会员号:无替换组成员将会产生。相反,如果参数“与评论注释XML”被设置为“是”,则输出将包含注释上市路径替换组成员。这些路径可以然后在另一个XMLSampleGenerator被用来生成单个置换组成员。
This parameter controls the output when the XML schema contains anXS:选择。AnXS:选择lists a number of possible elements which may appear in the output.
- 第一个选项只有:这是此参数的默认值。只有在选择第一个选项将会产生。
- 所有选项:所有的选择方案将会产生。一般情况下,一个模式有效的文档将只包含一个选项。该参数值可以用来检查所有可能的选择方案。使用该值可能导致这是非常大的输出文档。
- 无选项:没有选择的选择将会产生。相反,如果参数“与评论注释XML”被设置为“是”,则输出将包含注释上市的路径选择选项。这些路径可以然后在另一使用XMLSampleGenerator生成个性化的选择方案。请注意,只有元素的路径将被列出。嵌套序列和选择,就不会产生任何的路径。
如果 this parameter is set to Yes, the output will be prefaced with an XML header.如果 the parameter is set to No, the output will not contain an XML header.
如果这个参数设置为Yes,输出将包含描述输出XML注释。
这些意见将描述什么是需要的样本XML转换成按照给定的模式是有效的XML文档。这包括关于递归复杂类型和取代基团,上的元素的信息和关于一个元件可能包含数据类型的多个可接受细节警告。
如果是,输出将包含从XML架构文档是相关的XML样本中注释文档和应用程序的信息。注释内容被写入到输出样品中的XML注释。
Result
该参数指定XML文档将被写入该属性。默认值是_结果。
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace.More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers.To access a menu of these options, clickbeside the applicable parameter.For more information, seeTransformer Parameter Menu Options。
Transformer Categories
FME Licensing Level
FME Professional edition and above
FME Community
The FME Community is the place for demos, how-tos, articles, FAQs, and more.Get answers to your questions, learn from other users, and suggest, vote, and comment on new features.
Search for samples and information about this transformer on theFME Community。