データ タイプ

パラメーターのデータ タイプは、クライアントがパラメーターに対して提供する必要がある値のタイプを示します。パラメーターの値は、string、long、double、Boolean、date のように単純なタイプであるか、フィーチャセット (フィーチャクラスと同様に、属性を持つフィーチャのコレクション)、テーブル、またはラスターのいずれかになります。たとえば、データ タイプが、-2,147,483,648 ～ 2,147,483,647 の範囲内の数値を指定する必要がある long である場合に、他の 10 進値や文字列値を指定すると、ツールの予期しない動作が発生します。同様に、ラスター データ タイプの場合にツールを正常に実行するには、適切なラスター データを指定する必要があります。次のリストに、タスク パラメーターのデータ タイプとその期待値を示します。

{
"fields":[{"name":"Id","type":"esriFieldTypeString","alias":"Id"},
{"name":"State_Name","type":"esriFieldTypeString","alias":"State
Name"},
{"name":"State_Abbr","type":"esriFieldTypeString","alias":"State
Abbr"}],
"features" : [
 { "attributes" : {"Id" : 43, "State_Name" :
"California","State_Abbr":"CA"},
{ "attributes" : {"Id" : 67, "State_Name" :
"Colorado","State_Abbr":"CO"}]}
TypeString","alias":"Id"},

{ 
"geometryType" : "esriGeometryPoint",
"fields":[
  {"name":"Id","type":"esriFieldTypeOID","alias":"Id"},
  {"name":"Name","type":"esriFieldTypeString","alias":"Name"}],
"spatialReference" : {"wkid" : 4326},
"features" : [
    { "geometry" : {"x" : -104.44, "y" : 34.83,
           "spatialReference" : {"wkid" : 4326}}, 
      "attributes" : 
           {"Id" : 43,"Name" : "Feature 1"}},
    { "geometry" : {"x" : -100.65, "y" : 33.69,
            "spatialReference" : {"wkid" : 4326}},
      "attributes" : 
           {"Id" : 42,"Name" : "Feature 2"}}
    ]
}

表示名

表示名はパラメーターのわかりやすい名前です。

方向

方向は、パラメーターが入力または出力パラメーターのどちらに該当するかを識別するのに役立ちます。

• esriGPParameterDirectionInput : 入力パラメーター
• esriGPParameterDirectionOutput : 出力パラメーター

タスクを実行する際、クライアントは入力パラメーターの値のみを提供する必要があります。タスクが正常に実行されると、サーバーによって出力パラメーターが作成され、クライアントはこれらの出力パラメーターの値にアクセスできます。

デフォルト値

ジオプロセシング サービスの公開時に、成功したジオプロセシング ツール結果からジオプロセシング タスクが作成されます。デフォルト値には、タスクの作成元になった結果に含まれるパラメーターの値が表示されます。入力パラメーターのデフォルト値は、タスクの実行が成功するために渡される必要があるパラメーター値の例であり、出力パラメーターのデフォルト値は、タスクからの期待される出力の例です。

• GPFeatureRecordSet と GPRecordSet のデフォルト値には、フィーチャセット/レコードセットのスキーマに関する追加情報が示されます。スキーマには、ジオメトリ タイプ、HasZ、HasM、空間参照、フィールド、およびフィーチャが含まれます。次のスクリーン キャプチャは、GPFeatureRecordSet データ タイプのスキーマの例です。

  

  ツールの実行に成功するには、クライアントは、デフォルト値によって定義されたスキーマに準拠する入力フィーチャセットを提供する必要があります。スキーマのフィーチャ プロパティは、ほとんどの場合でなしになります。ただし、タスクが、[フィーチャを含める] オプションを使用して公開されている場合は、含まれるフィーチャが、デフォルト値にリスト表示されます。

• GPDataFile、GPRasterData、および GPRasterDataLayer のパラメーターにはデフォルト値はありません。

パラメーター タイプ

パラメーター タイプには、次の 3 種類があります。

1. esriParameterTypeRequired:パラメーターは、実行が成功するために必須です。クライアントは、タスクのリソースに対して操作を実行するときにパラメーターの値を提供する必要があります。
2. esriParameterTypeOptional:パラメーターは、実行が成功するために必須ではありません。
3. esriParameterTypeDerived:パラメーター値は、他の入力パラメーターから取得される出力パラメーターであるため、クライアントは値を提供する必要はありません。

カテゴリ

入力および出力パラメーターが多数存在する場合、通常、それらのパラメーターは、ツール作成者が理解しやすいように特定のカテゴリにグループ化されます。次のスクリーン キャプチャは、ArcGIS Desktop のツール ダイアログ ボックスで表示されるカテゴリの例です。

カテゴリは、ツール作成者の設計に従って、パラメーターが特定のカテゴリに属するかどうかを規定します。カテゴリの値は、ジオプロセシング タスク用のウィジェットを設計するときに使用できます。

選択リスト

一部の GPString パラメーターには、追加の選択リスト プロパティが示されます。選択リストは、ツールの実行が成功するために公開者によって指定される定義済みの値のセットです。実行が成功するには、クライアントが、選択リストから値の 1 つを選択する必要があります。クライアントが選択リストの値以外の値を提供した場合は、タスクが失敗します。次のスクリーン キャプチャは、GPString パラメーター Transportation_mode_network 用の選択リストの値 Street network、Bike network、Walk network を示しています。このような選択リストの値が表示された場合、クライアントは、実行の成功のためにそれらの値の中から 1 つを選択しなければなりません。

タスク公開時におけるパラメーターの選択リストの値の作成に関する詳細