es:instance-from-document

es:instance-from-document(
   $entity-document as document-node()
) as map:map*

Summary

This function is deprecated and will be removed in a future release.
Extract an in-memory entity instance from its envelope document as a map:map () .

Usage Notes

Use this function to get an in-memory instance representation from an envelope document that contains canonical instance data within es:instance elements. An envelope document is usually created using the extract instance function in an instance converter module created by the Entity Services API.

An in-memory instance contains nested objects if those objects were persisted as nested XML elements. This function returns a sequence of one or more instances, as map:map values (json:object elements) .

To extract an entity from an envelope document as an XML node, use es:instance-xml-from-document instead. To extract an entity from an envelope document as a JSON object, use es:instance-json-from-document instead.

See Also

• Managing Entity Instances in the Entity Services Developer's Guide.
• es:instance-xml-from-document
• es:instance-json-from-document

Example

(: Assume /es-gs/env/1234.xml is an envelope document with
 : the following contents:
  <es:envelope xmlns:es="http://marklogic.com/entity-services">
    <es:instance>
      <es:info>
        <es:title>Person</es:title>
        <es:version>0.0.1</es:version>
      </es:info>
      <Person>
        <id>1234</id>
        <firstName>George</firstName>
        <lastName>Washington</lastName>
        <fullName>George Washington</fullName>
      </Person>
    </es:instance>
    <es:attachments>
      <person>
        <pid>1234</pid>
        <first>George</first>
        <last>Washington</last>
      </person>
    </es:attachments>
  </es:envelope>
:)

xquery version "1.0-ml";
import module namespace es = "http://marklogic.com/entity-services"
    at "/MarkLogic/entity-services/entity-services.xqy";

es:instance-from-document(fn:doc('/es-gs/env/1234.xml'))

(: Returns a json:object (map:map) equivalent to the following JSON:

{ "$type": "Person",
  "id":1234, 
  "firstName":"George", 
  "lastName":"Washington", 
  "fullName":"George Washington"
}
:)