Operación de tarea: ejecutar

Si la operación compatible de la tarea es Tarea ejecutar, debe utilizar el método ejecutar de la instancia del geoprocesador y aprobar los parámetros. Debe definir los controladores de eventos que enfocarán la aplicación en peticiones satisfactorias y fallidas. El evento onExecuteComplete se planteará cuando la tarea se ejecute correctamente y devuelva los mensajes de resultado y de geoprocesamiento. El evento onError se plantea cuando falla la ejecución de la tarea. Cuando la tarea falle, el servidor devolverá una instancia de con código de error HTML y mensajes de geoprocesamiento, si los hubiera.

function myGPExecuteTask(){
 // Get params from setupParameters method described above.
 var params=setupParameters();

 // Setup onTaskSuccess and onTaskFailure event handlers.
 dojo.connect(gpTask, "onExecuteComplete",onTaskSuccess);
 dojo.connect(gpTask, "onError",onTaskFailure);

 // Execute gpTask with params
 gpTask.execute(params);
}

// Callback when the Task operation succeeded
function onTaskSuccess(results, messages) {
  // Do something with the results...
  // More info on rendering the results in section below    
}

// Handler that is invoked when the Task operation has failed
function onTaskFailure(error) {
  // Report error 
  alert("Error:"+ error); 
}

Operación de tarea: submitJob

Si la operación compatible de la tarea es la operación submitJob, debe utilizar el método Geoprocessor.submitJob y aprobar los parámetros. En el caso de submitJob, surgen tres acontecimientos y deben tratarse de forma adecuada en la aplicación Web.

• onStatusUpdate: A diferencia de ejecutar, en el caso de submitJob, el servidor crea un trabajo y asigna un jobId. Las operaciones submitJob no notifican al cliente cuando se completa un trabajo, así que depende del cliente comprobarlo con el servicio para determinar el estado del trabajo. Las aplicaciones Web, por defecto, envían solicitudes de estado al servidor cada segundo para determinar el estado de la tarea. Cada vez que la respuesta de estado se recibe, se plantea el evento onStatusUpdate. Puede aumentar o disminuir el intervalo de la consulta del estado a través del método Geoprocessor.setUpdateDelay si es necesario. El evento onStatusUpdate se plantea cada vez que el estado del trabajo se comprueba. El controlador de eventos recibe una instancia JobInfo que contiene el Id. de trabajo, el estado del trabajo y cualquier GPMessages devueltos por el servidor. Puede utilizar esta información para realizar el seguimiento de los progresos de la tarea.
• onJobComplete: Cuando aparezca JobInfo.jobStatus = STATUS_SUCCEEDED, se plantea el evento onJobComplete. Los resultados no se devuelven automáticamente para el cliente cuando se completa la operación, sino que en su lugar se almacenan en el servidor y el cliente debe enviar una solicitud para recuperarlos. En el controlador de eventos onJobComplete, puede invocar el método Geoprocessor.getResultData y obtener los resultados. Cada parámetro de salida es un recurso independiente, y el método getResultData de la instancia del geoprocesador debe ser invocado para cada parámetro de salida de la tarea. Debe proporcionar el jobId devuelto por el controlador de eventos y el nombre del parámetro de salida en el método getResultData. También debe crear un controlador de eventos para el evento onGetResultDataComplete. El evento onGetResultDataComplete surge cuando la aplicación Web recibe el valor de resultado del parámetro de salida.
• onError: El evento onError se plantea cuando una solicitud submitJob o una solicitud de estado caduca o si las tareas de geoprocesamiento fallan. El caso devolverá una instancia de error con código de error HTML.

function myGPSubmitJob(){
 // Get params from setupParameters method described above.
 var params=setupParameters();

 // Setup event handlers.
 dojo.connect(gpTask, "onJobComplete",onTaskComplete);
 dojo.connect(gpTask, "onError",onTaskFailure);
 dojo.connect(gpTask, "onStatusUpdate",onTaskStatus);
 gpTask.submitJob(params);
}

// Event handler for onJobComplete event
function onTaskComplete(jobInfo) {
    /* Get the value of an output parameter Buffer_polygons
      using getResultData. The name of the output
      may vary in your gpTask*/      
    dojo.connect(gpTask, "onGetResultDataComplete",
                      onTaskResultComplete);
    gpTask.getResultData(jobInfo.jobId, 
                          "Buffer_polygons");
}

// Event handler for onStatusUpdate event
function onTaskStatus(jobInfo) {
     //write status to console to help debugging
    console.log(jobInfo.jobStatus);
}

// Event handler for onError event
function onTaskFailure(error) {
  // Report error 
  alert("Error:"+ error); 
}

Resultados del controlador de evento onExecuteComplete

En el caso de la operación ejecutar, el evento onExecuteComplete devuelve los resultados y mensajes de la tarea de geoprocesamiento. Los resultados de la instancia son un conjunto de todos los parámetros de salida de la tarea, y las entradas del conjunto están siempre en el orden en que se enumeran en la página Tareas. Por lo tanto, los valores de parámetro se puede identificar por su posición en el conjunto. Cada parámetro de salida en el conjunto tiene un nombre de parámetro, su tipo de datos y su valor. El código que aparece a continuación muestra cómo acceder al primer parámetro de salida en los resultados. En el siguiente código, el parámetro de salida se conoce por ser una salida GPFeatureRecordSetLayer y, por lo tanto, el código muestra cómo representarlo como una capa de gráficos y agregarlo a la aplicación Web.

function onTaskSuccess(results, messages) {
    /* Retrieve the output parameter value based 
      on its position from the result instance.
      In the case shown below, the output is the first output 
      parameter of the task and it
      is a GPFeatureRecordSetLayer.*/
    var featureset = results[0].value;
   
    // Create a graphics layer with features
    var taskResultLayer= new esri.layers.GraphicsLayer
              ({id:"MyGPExecuteResultLayer"});
    
    // Create a symbol based on the geometry. 
    // The geometry is assumed to be polygons in the code below
    var simplePolySymbol = new esri.symbol.SimpleFillSymbol();
    simplePolySymbol.setOutline(new esri.symbol.SimpleLineSymbol(
                  esri.symbol.SimpleLineSymbol.STYLE_SOLID,
                  new dojo.Color([0,0,0,0.5]), 1));
    simplePolySymbol.setColor(new dojo.Color([255,0,0,0.7]));
    
    // Create graphics from features and add it graphicslayer 
    dojo.forEach(featureset.features,function(feature){
             feature.setSymbol(simplePolySymbol);
             //Add feature to the graphics layer
             taskResultLayer.add(feature);});
    }
    // Add graphicslayer to webmap 
    //  myMap is assumed to be an instance of map container esri.map
    myMap.addLayer(taskResultLayer)
}

Resultados del controlador de evento onGetResultDataComplete

El evento onGetResultDataComplete proporciona una instancia de resultado. A diferencia de los resultados del evento onExecuteComplete, la instancia de resultado solo tendrá valores para el parámetro requerido. El resultado del parámetro tendrá el nombre, el tipo de datos y el valor solicitados. El valor de parámetro se recupera del resultado y se utiliza según sea necesario. El código que aparece a continuación muestra cómo visualizar los resultados de un parámetro GPFeatureRecordSetLayer a partir de un parámetro de instancia de resultado.

function onTaskResultComplete(paramResult) {
   // Retrieve the value of the parameter from the paramresult
   var featureSet = paramResult.value;

   // Create a graphics layer with features
   var taskResultLayer= new esri.layers.GraphicsLayer
              ({id:"MyGPSubmitJobResultLayer"});
    
   // Create a symbol based on the geometry. 
   // The geometry is assumed to be polygons in the code below
   var simplePolySymbol = new esri.symbol.SimpleFillSymbol();
   simplePolySymbol.setOutline(new esri.symbol.SimpleLineSymbol(
                  esri.symbol.SimpleLineSymbol.STYLE_SOLID,
                  new dojo.Color([0,0,0,0.5]), 1));
   simplePolySymbol.setColor(new dojo.Color([255,0,0,0.7]));
    
   // Create graphics from features and add it graphicslayer 
   dojo.forEach(featureset.features,function(feature){
             feature.setSymbol(simplePolySymbol);
             //Add feature to the graphics layer
             taskResultLayer.add(feature);});
   }
   // Add graphicslayer to webmap 
   //   myMap is assumed to be an instance of map container esri.map.
   myMap.addLayer(taskResultLayer)
}