SEARCH_METADATA

SEARCH_METADATA

適用： REQUEST
サーバ： Metadata (Browse)
親要素： GET_METADATA   SEARCH_METADATA

<SEARCH_METADATA	属性の概要
SEARCH_METADATAがネストされている場合： operator="and \| or" [and] SEARCH_METADATAが外部要素の場合： foldermask ="1 - 7" fulloutput ="true \| false" [true] gndextent ="none \| document \| search" [none] maxresults ="整数" [検索条件にマッチする全レコード数] operator ="and \| or" [and] sort ="name \| relevance \| contenttype \| local_area \| global_area" [name] sort2 ="name \| relevance \| contenttype \| local_area \| global_area" startresult ="整数" [0] > 　　　SEARCH_METADATAがネストされている場合： <AREA... /> [および/または] (m) <DOCUMENTINFO... /> [および/または(Group A)] (m) <SUBSET... /> [および/または(Group A)] (m) <UPDATED... /> [および/または(Group A)] (m) <FULLTEXT... /> [および/または(Group B)] (m) <TAGTEXT... /> [および/または(Group B)] (m) <TAGVALUE... /> [および/または(Group B)] 　　　SEARCH_METADATAが外部要素の場合：　　　<ENVELOPE... /> [および/または] (m) <FULLTEXT... /> [および/または] (m) <SEARCH_METADATA... /> [および/または] (m) <TAGTEXT... /> [および/または] (m) <TAGVALUE... /> [および/または] 　 </SEARCH_METADATA >
太字：必須の属性もしくは子要素。 (m)：複数回使用できる子要素。

概要

メタデータドキュメントの選択条件を特定するために使用されます。

制限

少なくとも、SEARCH_METADATA、DOCUMENTINFO、SUBSET、ENVELOPE、FULLTEXT、TAGTEXT、あるいはTAGVALUEのうち1つの要素が必要です。各要素は複数回使用可能です。

SEARCH_METADATA親要素内に、検索条件を次の順序で追加します：

ENVELOPE. この要素は、一度だけ使用できます。
ネスト化されたSEARCH_METADATA要素 (構文セクションのGroup A)はSUBSET, DOCUMENTINFO, UPDATED, AREAを含みます。これらの要素は、順不同、複数回使用できます。
SEARCH_METADATAの外部要素の子要素は、FULLTEXT, SEARCH_METADATA, TAGTEXT, TAGVALUEとなります。これらの要素は、順不同、複数回使用できます。
ネスト化されたSEARCH_METADATA要素 (構文セクションの Group B) は FULLTEXT, TAGTEXT, TAGVALUE を含みます。これらの要素は、順不同、複数回使用できます。

複数の子要素を使用したSEARCH_METADATAリクエストの正しい構造を示した例は下記のとおりです。

<--Outer SEARCH_METADATA element -->
<SEARCH_METADATA ...>

<--#1 -->
  <ENVELOPE ...>

<--#2 -->
  <SEARCH_METADATA ...>
    <DOCUMENTINFO .../>
    <SUBSET .../>
  </SEARCH_METADATA>

<--#3 -->
  <FULLTEXT ...>

<--#4 -->
  <SEARCH_METADATA ...>
    <TAGTEXT .../>
  </SEARCH_METADATA>

</SEARCH_METADATA>

少なくとも、ENVELOPE, FULLTEXT, SEARCH_METADATA, TAGTEXT,TAGVALUEの要素が1つ以上必要です。ENVELOPEを除いた他の要素は複数回使用できます。
SEARCH_METADATAは、 SEARCH_METADATA要素の内部にネストされるでしょう。ネスト化されたSEARCH_METADATA要素は、追加のネスト化されたSEARCH_METADATA要素を含みません。

ネスト化されたSEARCH_METADATA要素はGroup A (SUBSET, DOCUMENTINFO, UPDATED, AREA)の子要素、もしくは Group B (FULLTEXT, TAGTEXT,TAGVALUE)の子要素が必須です。この２つのグループを混合させてはいけません。

次は有効なリクエスト例です。

<SEARCH_METADATA ...>
  <SEARCH_METADATA ...>
    <DOCUMENTINFO .../>
    <SUBSET .../>
  </SEARCH_METADATA>
  <SEARCH_METADATA ...>
    <TAGTEXT .../>
  </SEARCH_METADATA>
</SEARCH_METADATA>

次は無効なリクエスト例です。（DOCUMENTINFOとTAGTEXTは異なるグループなので）

<SEARCH_METADATA ...>
  <SEARCH_METADATA ...>
    <DOCUMENTINFO .../>
    <TAGTEXT .../>
  </SEARCH_METADATA>
</SEARCH_METADATA>

注意

レスポンスはゼロ以上のMETADATA_DATASETです。
maxresults属性とstartresult属性は、1回に返却するレコード数を決定するために使用されます。例えば、10レコードずつ返却するように設定する場合は、maxresultを"10"に設定します。1回目では0から9までのレコードが返却されます。これらのレコードを検索するにはstartresultを0に設定します。2回目では10から19のレコードが返却されます。これらのレコードを検索するにはstartresultを10に設定します。プログラマはレコード数の跡をたどり、startresultを適時変更するようなプログラムを組む必要があります。ArcIMS空間サーバは、このような計算を内部では行いません。

属性の概要

属性	使い方	トップに戻る
foldermask	レスポンスで返却されるフォルダタイプを指定します。foldermaskの値は、以下の値を1つ以上合計した整数です： 1 = ルートドキュメント 2 = "普通の"フォルダ 4 = ドキュメント例えば、ドキュメントのみを返却するには"4"を使用します。すべてのフォルダタイプを返却するには"7"（1 + 2 + 4）を使用します。個々の値についての説明は以下の通りです： 1 = ルートドキュメントのみ (1) 2 = "普通の"フォルダのみ (2) 3 = ルートドキュメントと"普通の"フォルダ (1 + 2) 4 = ドキュメントのみ (4) 5 = ルートドキュメントとドキュメント (1 + 4) 6 = "普通の"フォルダとドキュメント (2 + 4) 7 = ルートドキュメント、"普通の"フォルダ、ドキュメント (1 + 2 + 4)
fulloutput	"true"に設定した場合、XMLファイルが生成され、必要であればサムネイルとgndファイルが作成されます。"false"の場合、XMLファイル、サムネイル、gndファイルは作成されません。
gndextent	GNDファイルに書き込まれるエクステントです。"none"が選択された場合、サービスのデフォルトのエクステントが使用されます。"document"の場合、エクステントはメタデータドキュメントから参照されます。"search"の場合、エクステントはMetadata Explorerのようなクライアントによって指定された検索範囲です。
maxresults	デフォルトでは検索条件を満たした全てのレコードが返却されます。この属性は返却されるレコード数を指定した最大値に制限します。
operator	SEARCH_METADATAクエリの演算子を定義するために使用されます。
sort	結果の並べ順の優先度です。"Name"は結果をアルファベット順で並べます。"Relevance"は最も高い関連性を持つレコードから最も低い関連性を持つレコード順に並べます。"Contenttype"は結果をコンテンツタイプでソートしてグループにします。"Local_area"は面積の昇順で結果を一覧にします。"Global_area"は面積の降順で結果を一覧にします。
sort2	startresultとmaxresultsを使用してバッチ処理された検索結果をソートします。"Name"は結果をアルファベット順で並べます。"Relevance"は最も高い関連性を持つレコードから最も低い関連性を持つレコード順に並べます。"Contenttype"は結果をコンテンツタイプでソートしてグループにします。"Local_area"は面積の昇順で結果を一覧にします。"Global_area"は面積の降順で結果を一覧にします。
startresult	デフォルトでは検索条件を満たした全てのレコードがレコード0から開始され返却されます。この属性は、指定されたレコードを開始レコードとして設定します。

サンプル

サンプル1：DOCUMENTINFOを使用し、名前もしくは所有者でメタデータドキュメントを検索する場合	トップに戻る
<?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>

サンプル2： SUBSETを使用する場合	トップに戻る
<?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>

サンプル3： TAGVALUEを使用する場合	トップに戻る
<?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>

サンプル4： ENVELOPE、TAGVALUE、FULLTEXT、SEARCH_METADATAを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>