DATASET

DATASET

適用： CONFIG   REQUEST
サーバ： Image   Query   Feature   Extract   ArcMap
親要素： LAYER

<DATASET	属性の概要
親要素：type属性がfeatureclassのLAYERもしくはTARGETLAYER *name ="文字列"* type ="point \| line \| polygon" *workspace ="文字列"* 親要素：type属性がimageのLAYER *name ="文字列"* *workspace ="文字列"* description ="文字列" showcolormaplegend ="true \| false" [true] type ="image" 親要素：GET_IMAGEまたはGET_EXTRACTのLAYERもしくはTARGETLAYER fromlayer ="マップ設定ファイルのレイヤID" > (m) <PARTITION... /> </DATASET >
太字：必須の属性もしくは子要素 (m) ：複数回使用できる子要素

概要

レイヤで使用されるデータセットを定義します。

制限

GET_IMAGEリクエスト内では、
name、type、workspace
または
fromlayer
のどちらかの属性セットが必要となります。
レイヤのタイプがfeatureclass（ポイント、ライン、ポイント）の場合、type属性が必要となります。ラスタイメージレイヤの場合、type属性は不要です。
ArcMapサーバはfromlayer属性のみをサポートします。つまり、ArcMapイメージサービスの既存レイヤのみを参照することができます。

注意

イメージサービス時にイメージまたはGRIDを指定するには、下表に示す通りです。

イメージへのアクセス方法	ワークスペースの場所	DATASETで指定するレイヤ名
データ名を指定する。	IMAGEWORKSPACEを使用し、directory属性でイメージの場所を指定する。	イメージファイル名（拡張子を含む）
ディレクトリ内の全てのイメージを使用する。同じ座標系が設定されていれば、リクエストされた範囲に含まれるイメージは全て自動的にタイリング表示される。	IMAGEWORKSPACEを使用し、directory属性でイメージファイルの置かれている場所を指定する。	name属性に「ImageDirectory」を設定する（例：name="ImageDirectory"）。
ArcViewのイメージカタログを利用する。	IMAGEWORKSPACEを使用し、directory属性で（イメージの場所ではなく）カタログの場所を指定する。	イメージカタログのDBFファイル名を設定する（例：カタログの名称が「imagecat.dbf」の場合、「name="imagecat.dbf"」）。
GRIDを追加する。	IMAGEWORKSPACEを使用する。GRIDは二つのディレクトリを持っており、一つはGRIDデータ自体の格納ディレクトリであり、もう一つはINFOデータベース用である。この両ディレクトリは、共通の親ディレクトリを持たなければならない。directory属性により、GRIDとINFOの親ディレクトリの場所を指定する。また、*.clrファイルによりGRIDの色を定義することができる。このファイルはGRIDと同じ名称で、GRIDとINFOの親ディレクトリに置く必要がある。	GRIDデータを含むディレクトリ名を指定する。もしGRID名が「WorldImage」の場合は「name="WorldImage"」と指定する。
ArcSDEで管理されたイメージを使用する。	SDEWORKSPACEを使用する。	イメージデータが格納されているラスタ列名を含む、ArcSDEにおけるフルネームを指定する。 Oracleの場合、<ユーザ名>.<イメージレイヤ名>.<ラスタ列名>という書式で指定する。ユーザ名が"SDEUSER"、イメージレイヤ名が"MYIMAGE"、ラスタ列名が"RASTER"の場合、DATASETのname属性は次の通りとなる。 SDEUSER.MYIMAGE.RASTER SQL Server、Informix、DB2の場合、<データベース名>.<ユーザ名>.<イメージレイヤ名>.<ラスタ列名>という書式で指定する。データベース名が"SDE"、ユーザ名が"SDEUSER"、イメージレイヤ名が"MYIMAGE"、ラスタ列名が"RASTER"の場合、DATASETのname属性に設定する名称は次の通りとなる。 SDE.SDEUSER.MYIMAGE.RASTER フィールド名がすべて大文字の場合は一般的にパフォーマンスは向上します。

サポートされるイメージの種類については、ArcIMS Helpを参照して下さい。
イメージサービスでは、各セルの幅と高さが同じ（各セルが正方形である）場合、GeoTIFFファイルは正しく表示されます。セルの幅と高さが同じでない場合、イメージは引き伸ばされたように見えるでしょう。イメージにワールドファイルを付けることにより、この問題を解決することができます。ワールドファイルの詳細については、ArcIMS Helpを参照して下さい。
イメージレイヤの場合、ピクセル値を凡例に含めるか否かをshowcolormaplegend属性で指定することができます。その場合、以下に挙げるルールが適用されます。
- イメージデータがカラーマップを持たず、RASTER_RENDERERを使用しない場合には、イメージの名称のみが凡例に表示されます。
- イメージデータがカラーマップを持っていて、RASTER_RENDERERを使用しない場合には、カラーマップの値が凡例に表示されます。もしカラーマップを凡例に表示したくない場合には、showcolormaplegend属性に"false"を設定して下さい。カラーマップをサポートするイメージフォーマットはArcSDEラスタ、GRID、BIL、BSQです。
- イメージデータがカラーマップを持っていて、RASTER_RENDERERも使用する場合には、RASTER_RENDERERで設定した値が優先的に凡例へ表示されます。RASTER_RENDERERの値を凡例に表示したくない場合には、showcolormaplegend属性に"false"を設定して下さい。
- RASTER_RENDERERを使用し、カラーマップが無い場合には、RASTER_RENDERERの値が凡例に表示されます。RASTER_RENDERERの値を凡例に表示したくない場合には、showcolormaplegend属性に"false"を設定して下さい。
リクエストにおいて、レイヤに対してfromlayer属性を使用する場合、このレイヤに対してマップ設定ファイルでクエリが設定されていると、fromlayerはこのクエリを受け継ぎます。

属性の概要

親要素：type属性がfeatureclassのLAYERもしくはTARGETLAYER

属性	使い方	トップに戻る
name	ソースとなるデータを指定します。設定する値は、マップ設定ファイルまたはビューア設定ファイルのどちらでDATASETが使用されているかに依存します。マップ設定ファイル：シェープファイルの場合は、「STATES」のように、ファイル名から拡張子を省いた名称を指定します。ArcSDEの場合は、「DATA.STATES」のように、レイヤのフルネームを指定します。ビューア設定ファイル内のフィーチャサービスレイヤ：マップ設定ファイル内のLAYERのidを指定します。例えば、レイヤのidが"0"の場合、「DATASET name="0"」と指定します。ビューア設定ファイル内のイメージサービスレイヤ：イメージサービス名を設定します。例えば、サービス名が"world"の場合、「DATASET name="world"」と指定します。
type	ソースとなるデータのタイプを指定します。LAYERで定義されたレイヤのtype属性の値がfeatureclassの場合に必要となります。
workspace	データが存在するワークスペースの名称を指定します。

親要素：type属性がimageのLAYER

属性	使い方	トップに戻る
description	この属性値はArcSDEラスタのカラーマップに対応するArcSDEの概要テーブルの名称です。データセット名が"MYRASTER.ELEVMAP.RASTER"の場合、対応する概要テーブルは"MYRASTER.ELEVMAPDESC"という名称になります。 <LAYER type="image" name="MYRASTER.ELEVMAP" visible="true" id="0"> <DATASET name="MYRASTER.ELEVMAP.RASTER" description="MYRASTER.ELEVMAPDESC" showcolormaplegend="true" workspace="sde_ws-0"/> </LAYER> 概要テーブルは、COLORMAP_INDEXとDESCRIPTIONという名前の二つの文字列フィールド（カラム）を持っている必要があります。最初のカラムは、カラーマップの同じインデックス値に対応するインデックス値を含んでいます。二番目のカラムは、これらのインデックスについての概要を含んでいます。テーブルはラスタと同じデータベースに格納されている必要があります。各ラスタ値の概要が含まれている場合、カラーマップ値の代わりに凡例へ表示されます。概要を凡例へ表示するには、showcolormaplegendを"true"に設定して下さい。
name	ソースとなるデータを指定します。イメージデータへのアクセス方法と名称の設定方法については、上記の「注意」セクションの表を参照して下さい。
showcolormaplegend	凡例の表示情報を設定します。"true"を設定した場合、ピクセル値の情報が凡例に表示されます。"false"を設定した場合は、レイヤ名だけが凡例に表示されます。さらに詳しい情報については、上記の「注意」セクションを参照して下さい。
type	ソースとなるデータのタイプを指定します。イメージレイヤでは必須の属性ではありません。
workspace	データが存在するワークスペースの名称を指定します。

親要素：GET_IMAGEまたはGET_EXTRACTのLAYERもしくはTARGETLAYER

属性	使い方	トップに戻る
fromlayer	マップ設定ファイルで定義されたレイヤを、名称ではなくレイヤIDで指定します。

サンプル

サンプル 1：マップ設定ファイルの場合

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-178.21" miny="18.92" maxx="-66.96" maxy="71.41" name="Initial_Extent" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="CITIES" visible="true" id="2">
      <DATASET name="CITIES" type="point" workspace="shp_ws-0" />
      <SIMPLERENDERER>
        <SIMPLEMARKERSYMBOL type="square" width="5" />
      </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

サンプル 2：ビューア設定ファイルの場合

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
      <ENVELOPE minx="-180.0" miny="-90.0" maxx="185.6901927947995" maxy="90.0" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
      <IMAGESERVERWORKSPACE name="mapper_ws-0" url="http://mymachine.domain.com/servlet/com.esri.esrimap.Esrimap" service="background" />
      <FEATURESERVERWORKSPACE name="ifs_ws-1" url="http://mymachine.domain.com/servlet/com.esri.esrimap.Esrimap" service="world" />
      </WORKSPACES>
      <LAYER type="image" name="background" visible="true" id="0">
      <DATASET name="background" type="image" workspace="mapper_ws-0" />
      </LAYER>
      <LAYER type="featureclass" name="Countries" visible="true" id="1">
      <DATASET name="1" type="polygon" workspace="ifs_ws-1" />
      </LAYER>
    </MAP>
    <SCALEBAR backcolor="192,192,192" fontcolor="0,0,0" mapunits="decimal_degrees" scaleunits="feet" screenunits="inches" />
  </CONFIG>
</ARCXML>

サンプル 3：fromlayerを使用するREQUESTの場合

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
        <IMAGESIZE width="643" height="502" />
      </PROPERTIES>
      <LAYER type="featureclass" name="select layer" visible="true" id="Selected">
        <DATASET fromlayer="1" />
        <SPATIALQUERY>
          <SPATIALFILTER relation="area_intersection">
            <POLYLINE>
              <PATH>
                <POINT x="-2.1079549837513" y="19.99815142335011" />
                <POINT x="28.99468788980437" y="15.88488432940315" />
                <POINT x="55.99468788980437" y="35.88488432940315" />
              </PATH>
            </POLYLINE>
          </SPATIALFILTER>
        </SPATIALQUERY>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="0,255,0" filltype="cross" fillinterval="3" />
        </SIMPLERENDERER>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

サンプル 4：単一のイメージを名称で指定する場合

トップに戻る

サンプル 5：ディレクトリ内の複数のイメージを指定する場合

トップに戻る

サンプル 6：イメージカタログを指定する場合

トップに戻る

サンプル 7：GRIDを指定する場合

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
       <ENVELOPE minx="-2006008" miny="-1240677" maxx="-1993628" maxy="-1256187" name="Initial_Extent" />
       <MAPUNITS units="meters" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
       <IMAGEWORKSPACE directory="<path to parent directory above INFO and GRID directory>" name="jai_ws-15" />
      </WORKSPACES>
      <LAYER type="image" name="Mt St. Helens" visible="true" id="0">
       <DATASET name="<GRID directory>" type="image" workspace="jai_ws-15" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

サンプル 8：SQL Server、DB2、あるいはInformixのArcSDEラスタレイヤにアクセスする場合。DATASETのnameは<データベース>.<ユーザ名>.<レイヤ名>.<ラスタカラム>で、このサンプルではSDEDATABASE.SDEUSER.SDELAYER.RASTERになる。

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="dialog" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="192837" miny="3769109" maxx="197809" maxy="3773771" name="Initial_Extent" />
        <MAPUNITS units="meters" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
      <SDEWORKSPACE name="sde_ws-0" server="myserver" instance="port:5151" database="sdedatabase" user="sdeuser" encrypted="true" password="UIUXIOPP" geoindexdir="d:\temp\" />
      </WORKSPACES>
      <LAYER type="image" name="SDEDATABASE.SDEUSER.SDELAYER.RASTER" visible="true" id="1">
      <DATASET name="SDEDATABASE.SDEUSER.SDELAYER.RASTER" workspace="sde_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

サンプル 9：OracleのArcSDEラスタレイヤにアクセスする場合。DATASETのnameは<ユーザ名>.<レイヤ名>.<ラスタカラム>で、このサンプルではSDEUSER.SDELAYER.RASTERになる。

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="dialog" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="192837" miny="3769109" maxx="197809" maxy="3773771" name="Initial_Extent" />
        <MAPUNITS units="meters" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
      <SDEWORKSPACE name="sde_ws-0" server="myserver" instance="port:5151" database="" user="sdeuser" encrypted="true" password="UIUXIOPP" geoindexdir="d:\temp\" />
      </WORKSPACES>
      <LAYER type="image" name="SDEUSER.SDELAYER.RASTER" visible="true" id="1">
      <DATASET name="SDEUSER.SDELAYER.RASTER" workspace="sde_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>