Type de données

Le type de données du paramètre indique le type de valeur que le client doit fournir pour le paramètre. La valeur du paramètre peut être très simple : long, double, booléen, date ou chaîne. Il peut également s'agir d'un jeu d'entités (une collection d'entités dont les attributs sont similaires au sein d'une classe d’entités), d'une table ou d'un raster. Par exemple, si le type de données est "long", vous devez fournir une valeur numérique comprise entre -2 147 483 648 et 2 147 483 64. Toute autre valeur décimale ou valeur de chaîne générera un comportement inattendu de l'outil. Pareillement, si le type de données est "raster", vous devez fournir les données raster appropriées pour exécuter l'outil avec succès. La liste ci-dessous répertorie les types de données d'un paramètre de tâche et ses valeurs attendues.

{
"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"}}
    ]
}

Nom complet

Le nom d'affichage doit être pertinent pour le paramètre.

Direction

La direction permet d'identifier si le paramètre est en entrée ou en sortie.

• esriGPParameterDirectionInput : paramètre en entrée
• esriGPParameterDirectionInput : paramètre en sortie

Lorsqu'il exécute une tâche, le client doit uniquement fournir les valeurs des paramètres en entrée. Une fois la tâche exécutée avec succès, les paramètres en sortie sont créés par le serveur et le client peut alors accéder aux valeurs de ces paramètres.

Valeur par défaut

Lorsque vous publiez un service de géotraitement, les tâches de géotraitement sont créées à partir des résultats positifs de l'outil de géotraitement. La valeur par défaut contient les valeurs des paramètres du résultat à partir duquel la tâche a été créée. La valeur par défaut d'un paramètre en entrée constitue un exemple de la valeur du paramètre qui doit être transmise afin de garantir la bonne exécution de la tâche ; la valeur par défaut d'un paramètre en sortie constitue un exemple de la sortie attendue de la tâche.

• La valeur par défaut de GPFeatureRecordSet et GPRecordSet comporte des informations supplémentaires sur la structure des objets featureset/recordset. La structure inclut les valeurs GeometryType, HasZ, HasM, Référence spatiale, Champs et Entités. La capture d'écran ci-dessous constitue un exemple de structure de type de données GPFeatureRecordSet.

  

  Le client doit fournir des objets featureset en entrée conformes à la structure définie par la valeur par défaut pour que l'exécution de l'outil aboutisse. La propriété Entités de la structure sera None dans la plupart des cas. Toutefois, si la tâche a été publiée avec l'option Inclure les entités, les entités incluses seront répertoriées dans la valeur par défaut.

• Les paramètres GPDataFile, GPRasterData et GPRasterDataLayer n'ont aucune valeur par défaut.

Type de paramètre

Il existe trois types de paramètre :

1. esriParameterTypeRequired : ce paramètre est obligatoire au succès de l'exécution. Le client doit fournir une valeur pour le paramètre lorsqu'il exécute une opération sur la ressource de la tâche.
2. esriParameterTypeOptional : ce paramètre est facultatif au succès de l'exécution.
3. esriParameterTypeDerived : la valeur de ce paramètre est un paramètre en sortie dérivé d'autres paramètres en entrée. Le client n'a donc pas besoin de fournir une valeur.

Catégorie

Lorsqu'il y a de nombreux paramètres en entrée et en sortie, ceux-ci sont généralement regroupés dans des catégories spécifiques pour que le créateur de l'outil puisse plus facilement les identifier. La capture d'écran ci-dessous constitue un exemple de catégories de paramètres, telles qu'affichées dans la boîte de dialogue de l'outil ArcGIS for Desktop.

La catégorie indique si le paramètre appartient à une catégorie spécifique, telle que défini par le créateur de l'outil. La valeur de catégorie peut être utilisée pour concevoir des widgets pour les tâches de géotraitement.

Liste de choix

Certains paramètres GPString disposent d'une propriété de liste de choix supplémentaire. Une liste de choix est un ensemble de valeurs prédéfini établi par l'éditeur pour garantir la bonne exécution de l'outil. Le client doit alors choisir l'une des valeurs de la liste. La tâche échoue si le client fournit une valeur qui ne figure pas dans cette liste. La capture d'écran ci-dessous présente une liste de choix contenant les valeurs Street network, Bike network ou Walk network pour le paramètre GPString Transportation_mode_network. Lorsqu'une telle liste de choix est fournie, le client doit choisir l'une des valeurs de la liste pour garantir la bonne exécution de l'outil.

En savoir plus sur la création de valeurs de liste de choix pour les paramètres lors de la publication d'une tâche