Used in
REQUEST Servers
Metadata (Browse) Parent elements
SEARCH_METADATA Syntax
<TAGTEXT | Attribute Description Table |
(r)tag="string" (r)word="string" attribute="string" >
No Child Elements </TAGTEXT >
|
(r): Attribute or child element is required.
|
Description
Searches text within a specified element in metadata documents.
Notes
- A TAGTEXT search can be further restricted by limiting the search to an individual attribute.
- TAGTEXT search criteria are evaluated differently depending on how the tag is indexed. If a tag's data type in the XPath index definition file is STRING, the criteria are evaluated using the database's full text index on the content of these elements. If a tag's data type is VARCHAR, the criteria are evaluated by searching a character column using a standard SQL Where clause. Documents are found if the specified word or phrase occurs anywhere in the element's content.
When a tag is indexed as STRING wildcard characters work the same as described in FULLTEXT.
When a tag is indexed as VARCHAR:
- Documents are found by the criteria by checking the characters provided in the search criteria against the characters present in the element's content. Linguistic analysis is not performed.
- Wildcard characters are automatically added both preceeding and following the provided word, phrase, or word fragment to find all instances where the search criteria is contained in the element's content. It is not necessary to specify a wildcard character manually. However, if you specify a wildcard character by placing a percent sign (%) next to the search criteria, the search will succeed regardless of which RDBMS you use; if you use an asterisk (*) for the wildcard character instead, the search will not succeed.
- Punctuation and prepositions such as "a", "the", or "and" are not ignored when evaluating the search criteria.
- If more than one word is provided, the words must appear together in the published documents. For example, if the words "San Francisco" are provided together, they must appear next to each other in a document to be found by the search. For example, when searching an element containing a object's format, "Personal Feature" wouldn't find anything, but "Personal Geodatabase" might. In contrast, if the search specifies the word "Personal" and the word "Feature" in two separate TAGTEXT elements combined with an "and" operator documents will be found that contain both of these words anywhere in the element's content -- they don't have to be next to each other.
- For searching numeric values, see TAGVALUE.
Attribute Descriptions for TAGTEXT
Attribute | Usage |
---|
attribute | Name of an attribute for searching. |
tag | Defines the location of an element inside an XML tree. For example, the element "title" might be inside an XML structure such as
<metadata>
<idinfo> <citation>
<citeinfo>
<title>...</title>
</citeinfo> </citation>
</idinfo>
<metadata>
When searching the contents of "title", the string value for this attribute would be "metadata/idinfo/citation/citeinfo/title" where "metadata" is the root element in the XML document and the root element is not preceeded by a slash (/). |
word | List of one or more words. |
Back to top Examples for TAGTEXT
<?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>
|
Back to top