MarkLogic Server 11.0 Product Documentationes:schema-generate
es:schema-generate( $model as map:map ) as element(xsd:schema)*
Summary
This function is deprecated and will be removed in a future release.
Generate an XSD schema that can be used to validate instance data.
| Parameters | |
|---|---|
| model | A valid basic entity model. |
Usage Notes
Use this function to generate an XSD schema you can use to validate your instance data. As generated, the schema can be used to validate instance data that conforms to the Entity Services canonical XML. You can customize the schema as needed. You must install the schema in the schemas database to use it for validation.If the source model includes multiple entity type definitions and the entity types define different entity instance namespace URIs, then this function generates a schema for each namespace.
See Also
- Generating an Entity Instance Schema in the Entity Services Developer's Guide.
Example
(: Generate a schema from a model and save it to a file. :)
xquery version "1.0-ml";
import module namespace es = "http://marklogic.com/entity-services"
at "/MarkLogic/entity-services/entity-services.xqy";
let $basic-model := fn:doc("/es-ex/models/name.json")
let $schema := es:schema-generate($basic-model)[1]
return xdmp:save("/somewhere/name.xsd", $schema);
(: Customize schemas as needed, then deploy it to the schemas database.
: You can use the deployed schema as follows:
:)
let $instance-data := fn:doc("/instances/names/some-instance.xml")
return xdmp:validate($instance-data, "strict")
Example
(: Generate a schema from a model :)
xquery version "1.0-ml";
import module namespace es = "http://marklogic.com/entity-services"
at "/MarkLogic/entity-services/entity-services.xqy";
es:schema-generate( es:model-validate(
<es:model xmlns:es="http://marklogic.com/entity-services">
<es:info>
<es:title>Example</es:title>
<es:version>1.0.0</es:version>
</es:info>
<es:definitions>
<Name>
<es:properties>
<first><es:datatype>string</es:datatype></first>
<middle><es:datatype>string</es:datatype></middle>
<last><es:datatype>string</es:datatype></last>
</es:properties>
<es:required>first</es:required>
<es:required>last</es:required>
</Name>
</es:definitions>
</es:model>
))
(: ==> A schema similar to the following:
<xs:schema elementFormDefault="qualified"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:sem="http://marklogic.com/semantics"
xmlns:es="http://marklogic.com/entity-services">
<xs:element name="first" type="xs:string"/>
<xs:element name="middle" type="xs:string"/>
<xs:element name="last" type="xs:string"/>
<xs:complexType name="NameType" mixed="true">
<xs:sequence minOccurs="0">
<xs:element ref="first"/>
<xs:element minOccurs="0" ref="middle"/>
<xs:element ref="last"/>
</xs:sequence>
</xs:complexType>
<xs:element name="Name" type="NameType"/>
</xs:schema>
:)