SEARCH_METADATA

SEARCH_METADATA

Used in: REQUEST
Servers: Metadata (Browse)
Parent elements: GET_METADATA   SEARCH_METADATA

<SEARCH_METADATA	Attribute Description Table
foldermask ="1 - 7" fulloutput ="true \| false" [true] gndextent ="none \| document \| search" [none] maxresults ="integer" [All records matching search criteria] operator ="and \| or" [and] sort ="name \| relevance \| contenttype \| local_area \| global_area" [name] sort2 ="name \| relevance \| contenttype \| local_area \| global_area" startresult ="integer" [0] > <AREA... /> [And/Or] (m) <DOCUMENTINFO... /> [And/Or] (m) <ENVELOPE... /> [And/Or] (m) <FULLTEXT... /> [And/Or] (m) <SEARCH_METADATA... /> [And/Or] (m) <SUBSET... /> [And/Or] (m) <TAGTEXT... /> [And/Or] (m) <TAGVALUE... /> [And/Or] <UPDATED... /> [And/Or] </SEARCH_METADATA >
Bold: Attribute or child element is required. (m): Child element can be used multiple times.

Description:

Used to specify criteria for selecting documents.

Restrictions:

At least one occurrence of SEARCH_METADATA, DOCUMENT, SUBSET, ENVELOPE, FULLTEXT, TAGTEXT, or TAGVALUE is required. Each element can be used multiple times.

Notes:

Response is zero or more occurrances of METADATA_DATASET.
The attributes maxresults and startresult work together to return a specified number of records at a time. For example, assume 10 records should be returned at a time. In this case, maxresult would be set to "10". For the first pass, records 0 through 9 would be returned. To retrieve these records, startresult would be set to "0". In the second pass, records 10 through 19 should be retrieved. To do this, startresult should be set to 10. The programmer is responsible for keeping track and changing the value of startresult programmatically. The ArcIMS Spatial Server does not make this calculation.
SEARCH_METADATA can be used in a nested query inside a parent SEARCH_METADATA element.

Attribute Descriptions for SEARCH_METADATA:

Attribute	Usage	Back to Top
foldermask	Specifies folder types to be returned in the response. The value of foldermask is an integer storing the sum of one or more of the following values: 1 = Root document 2 = "Normal" folder 4 = Document For example, use "4" to return documents only. Use "7" (1 + 2 + 4) to return all types of folders. The different values are: 1 = Root document only (1) 2 = "Normal" folders only (2) 3 = Root document and "normal" folders (1 + 2) 4 = Documents only (4) 5 = Root document and documents (1 + 4) 6 = "Normal" folders and documents (2 + 4) 7 = Root document, "normal" folders, and documents (1 + 2 + 4)
fulloutput	By default this attribute is "true". When "true", an XML file is generated, and a thumbnail and gnd file is created if available. When "false", the XML file, thumbnail, and gnd files are not created.
gndextent	The extent written to the GND file. When "none" is selected, the default extent of the service is used. For "document" the extent is taken from the metadata document. For "search" the extent is the search extent specified in the client such as Metadata Explorer.
maxresults	By default, all records meeting the search criteria are returned. This attribute limits the number of returned records to the maximum value assigned to the attribute.
operator	Used to define the operator for the SEARCH_METADATA query.
sort	Preference for ordering results. "Name" orders the results alphabetically. "Relevance" lists results from highest to lowest relevance. "Contenttype" sorts and groups results by content type. "Local_area" lists results by area in ascending order. "Global_area" lists results by area in descending order.
sort2	Sorts search results that were batched using startresult and maxresults. "Name" orders the results alphabetically. "Relevance" lists results from highest to lowest relevance. "Contenttype" sorts and groups results by content type. "Local_area" lists results by area in ascending order. "Global_area" lists results by area in descending order.
startresult	By default, all records meeting the search criteria are returned starting with record 0. This attribute allows a specified record as the start record.

Examples for SEARCH_METADATA:

Example 1: When searching by name or owner of documents using DOCUMENTINFO.	Back to Top
<?xml version="1.0" encoding="UTF-8" ?> <ARCXML version="1.1"> <REQUEST> <GET_METADATA> <SEARCH_METADATA> <DOCUMENTINFO name="World" /> </SEARCH_METADATA> </GET_METADATA> </REQUEST> </ARCXML>

Example 2: When using SUBSET.	Back to Top
<?xml version="1.0" encoding="UTF-8" ?> <ARCXML version="1.1"> <REQUEST> <GET_METADATA> <SEARCH_METADATA> <SUBSET type="children" docid="{F7DDF21-BC01-4C20-8AA5-243B33ED0B1E}" /> </SEARCH_METADATA> </GET_METADATA> </REQUEST> </ARCXML>

Example 3: When using TAGVALUE.	Back to Top
<?xml version="1.0" encoding="UTF-8"?> <ARCXML version="1.1"> <REQUEST> <GET_METADATA> <SEARCH_METADATA operator="and" maxresults="10" startresult="0" > <TAGVALUE tag="metadata/idinfo/citation/citeinfo/pubdate" greaterthanorequalto="20001006" lessthanorequalto="20010104"/> </SEARCH_METADATA> </GET_METADATA> </REQUEST> </ARCXML>

Example 4: When using ENVELOPE, TAGVALUE, FULLTEXT, and SEARCH_METADATA recursively with TAGTEXT.

Back to Top

<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_METADATA>
      <SEARCH_METADATA operator="and">
        <ENVELOPE minx="-176.98" miny="18.93" maxx="-66.97" maxy="71.35" spatialoperator="within" />
        <TAGVALUE tag="metadata/dataqual/lineage/srcinfo/srccite/citeinfo/pubdate" greaterthan="1990" />
        <FULLTEXT word="cities"/>
        <SEARCH_METADATA operator="or">
          <TAGTEXT tag="metadata/idinfo/citation/citeinfo/geoform" word="data"/>
          <TAGTEXT tag="metadata/idinfo/citation/citeinfo/geoform" word="digital"/>
        </SEARCH_METADATA>
      </SEARCH_METADATA>
    </GET_METADATA>
  </REQUEST>
</ARCXML>