Package | com.esri.baserver.tasks.tradeareas |
Class | public final class StandardLevelsOfGeographyTask |
Inheritance | StandardLevelsOfGeographyTask BAServerTask BATask AbstractTask flash.events.EventDispatcher |
This task allows you to generate trade areas based on predefined geographies. These geographies can be ESRI standard demographic layers.
To select standard geography records, a data table with geographic IDs must be generated from which to create the trade areas. This table will be used to select the IDs from the geography layer. Once selected, the features will be exported as a new feature class.
Alternatively to generating a data table, geographic IDs can be explicitely specified in the
geographyIDs
array.
For example, if you want to generate trade areas based on a list of ZIP Codes, you would start by creating a table with all the ZIP Code records you want included in the table. This table may be a territory assignment file created by an external process. The ZIP Code records are then matched to the ZIP Code boundaries provided with Community Analyst, and a trade area is created with all matching ZIP Codes.
All non-matching ZIP Codes will not be included in the output trade area. Non-matching ZIP Codes are ZIP Codes that are not valid and do not have a corresponding feature in the input geography layer.
The result of this task is a TaskResultOutput
object,
which is compatible with ArcGIS Server's mapping APIs. FeatureSet, MapImage, and an array of
ReportInfo objects can be returned in it depending on task output options requested.
Additionally, the output analysis layer and/or report can be stored to the Business Analyst Server repository.
See also
Property | Defined By | ||
---|---|---|---|
activeDatasetID : String
Active dataset ID. | BAServerTask | ||
concurrency : String
Value that indicates how to handle multiple calls to the same task. | AbstractTask | ||
disableClientCaching : Boolean
If true, adds a timestamp parameter ("_ts") to the REST request to prevent the request from
being loaded from the browser's cache. | AbstractTask | ||
isFullErrorMessage : Boolean
Produce an error message with stack trace (true) or without stack trace (false). | BAServerTask | ||
lastResult : TaskResultOutput [read-only]
The last result of executing the Standard Levels of Geography task. | StandardLevelsOfGeographyTask | ||
proxyURL : String
The URL to proxy the request through. | AbstractTask | ||
requestTimeout : Number
The request timeout in seconds. | AbstractTask | ||
showBusyCursor : Boolean
If true, a busy cursor is displayed while a service is executing. | AbstractTask | ||
token : String
Token for accessing a secure task. | AbstractTask | ||
tokenProvider : ITokenProvider
Provider responsible for updating the security token if the last one expires. | BATask | ||
url : String
URL of the task. | AbstractTask |
Method | Defined By | ||
---|---|---|---|
StandardLevelsOfGeographyTask(urlOrClient:Object = null)
Creates a new instance of the StandardLevelsOfGeographyTask class. | StandardLevelsOfGeographyTask | ||
Creates a new command encapsulating this task and the given parameters. | StandardLevelsOfGeographyTask | ||
execute(parameters:StandardLevelsOfGeographyParameters, responder:IResponder = null):AsyncToken
Sends a request for executing a Standard Levels of Geography task to the Business Analyst Server HTTP (REST) Service. | StandardLevelsOfGeographyTask |
Constant | Defined By | ||
---|---|---|---|
name : String = StandardLevelsOfGeography [static] Task name. | StandardLevelsOfGeographyTask |
lastResult | property |
lastResult:TaskResultOutput
[read-only] The last result of executing the Standard Levels of Geography task.
public function get lastResult():TaskResultOutput
StandardLevelsOfGeographyTask | () | Constructor |
public function StandardLevelsOfGeographyTask(urlOrClient:Object = null)
Creates a new instance of the StandardLevelsOfGeographyTask class.
A new task can be constructed in two ways: as a task sharing a BAServerClient type instance
with other tasks (the urlOrClient
parameter has the BAServerClient type) or
as a standalone task encapsulating its own client.
The base URL to the Business Analyst Server HTTP Service looks as follows:
http://{host}:{port}/ArcGIS/baserver/REST/services/DefaultMap/BAServer
The {host}
and {port}
parameters in this URL should be substituted with
valid Business Analyst Server host name and port, respectively.
urlOrClient:Object (default = null ) — A variable containing either Business Analyst Server HTTP Service base URL string or an
instance of the BAServerClient class.
|
See also
createCommand | () | method |
public function createCommand(parameters:StandardLevelsOfGeographyParameters, commandName:String = null):BACommand
Creates a new command encapsulating this task and the given parameters.
Parameters
parameters:StandardLevelsOfGeographyParameters — Parameters of a task to be executed.
| |
commandName:String (default = null ) — Command name.
|
BACommand — A new command.
|
execute | () | method |
public function execute(parameters:StandardLevelsOfGeographyParameters, responder:IResponder = null):AsyncToken
Sends a request for executing a Standard Levels of Geography task to the Business Analyst Server HTTP (REST) Service.
A response can be received in two ways—in an optional
responder
object passed in parameters
of this method and/or in listeners of fault
and taskCompleted
events registered for this task.
The responder is notified first when a response is received and parsed.
Its fault
method receives a parameter of the FaultEvent
type and its
result
method receives a parameter of the BATaskCompletedEvent
type
whose result
property contains the result object.
After that the received event is dispatched to listeners of this task.
If a response is succesfully received and parsed, the result is assigned to the
lastResult
property of this task.
Parameters
parameters:StandardLevelsOfGeographyParameters — Parameters of the task.
| |
responder:IResponder (default = null ) — A responder to call on result or fault.
|
AsyncToken — Asynch token associated with the response.
|
name | Constant |
public static const name:String = StandardLevelsOfGeography
Task name.