Packagecom.esri.bao.tasks.stdgeographies
Classpublic final class StdGeographiesByAttributesTask
InheritanceStdGeographiesByAttributesTask Inheritance BAOnlineTask Inheritance BATask Inheritance AbstractTask Inheritance flash.events.EventDispatcher

The Standard Geographies by Attributes task requests a list of feature/area names and their corresponding IDs based on the result of a string-based query on a Community Analyst data layer.

Features/areas in the Community Analyst data layers are often identified by standardized FIPS codes. Alternatively, they may be identified in the Community Analyst data layers by some other ID. Standard Geographies by Attributes can be used to look up these IDs.

Some applications of Standard Geographies by Attributes include the following:

The result of this task is an array of StdGeographiesFeature items containing all of the feature/area names and their corresponding IDs that satisfy the string-based query on the data layer. After looking up these IDs, they may be used to specify one or more geographic features/areas in a Summary Reports analysis using the StandardLayer as the value for the Boundaries parameter.

See also

StdGeographiesByAttributesParameters
StandardLayer
StdGeographiesFeature
Live Sample - Standard Geographies by Attributes


Public Properties
 PropertyDefined By
 InheritedactiveDatasetID : String
Active dataset ID.
BAOnlineTask
 Inheritedconcurrency : String
Value that indicates how to handle multiple calls to the same task.
AbstractTask
 InheriteddisableClientCaching : 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
  lastResult : Array
[read-only] The last result of executing the Standard Geographies by Attributes task.
StdGeographiesByAttributesTask
 InheritedproxyURL : String
The URL to proxy the request through.
AbstractTask
 InheritedrequestTimeout : Number
The request timeout in seconds.
AbstractTask
 InheritedshowBusyCursor : Boolean
If true, a busy cursor is displayed while a service is executing.
AbstractTask
 Inheritedtoken : String
Token for accessing a secure task.
AbstractTask
 InheritedtokenProvider : ITokenProvider
Provider responsible for updating the security token if the last one expires.
BATask
 Inheritedurl : String
URL of the task.
AbstractTask
Public Methods
 MethodDefined By
  
StdGeographiesByAttributesTask(urlOrClient:Object = null)
Creates a new instance of the StdGeographiesByAttributesTask class.
StdGeographiesByAttributesTask
  
createCommand(parameters:StdGeographiesByAttributesParameters, commandName:String = null):BACommand
Creates a new command encapsulating this task and the given parameters.
StdGeographiesByAttributesTask
  
execute(parameters:StdGeographiesByAttributesParameters, responder:IResponder = null):AsyncToken
Sends a request for executing a Standard Geographies by Attributes task to the Community Analyst HTTP (REST) Service.
StdGeographiesByAttributesTask
Protected Methods
 MethodDefined By
  
resultHandler(asyncToken:AsyncToken):void
[override]
StdGeographiesByAttributesTask
Events
 Event Summary Defined By
 InheritedThe fault event is dispatched when an asynchronous execution of a Community Analyst Task fails.BATask
 InheritedThe taskCompleted event is dispatched when an asynchronous execution of a Community Analyst Task successfully completes.BATask
Public Constants
 ConstantDefined By
  name : String = report/StdGeographiesByAttributes
[static] Task name.
StdGeographiesByAttributesTask
Property Detail
lastResultproperty
lastResult:Array  [read-only]

The last result of executing the Standard Geographies by Attributes task. This array contains items of the StdGeographiesFeature type.


Implementation
    public function get lastResult():Array

See also

Constructor Detail
StdGeographiesByAttributesTask()Constructor
public function StdGeographiesByAttributesTask(urlOrClient:Object = null)

Creates a new instance of the StdGeographiesByAttributesTask class.

A new task can be constructed in two ways: as a task sharing a BAOnlineClient type instance with other tasks (the urlOrClient parameter has the BAOnlineClient type) or as a standalone task encapsulating its own client.

The base URL to the Community Analyst Web Services looks as follows:

http://{host}:{port}

The {host} and {port} parameters in this URL should be substituted with valid Community Analyst host name and port, respectively.

If urlOrClient is null, the "http://baoapi.esri.com" value is assigned as the base URL.

Parameters
urlOrClient:Object (default = null) — A variable containing either Community Analyst HTTP Service base URL string or an instance of the BAOnlineClient class.

See also

Method Detail
createCommand()method
public function createCommand(parameters:StdGeographiesByAttributesParameters, commandName:String = null):BACommand

Creates a new command encapsulating this task and the given parameters.

Parameters

parameters:StdGeographiesByAttributesParameters — Parameters of a task to be executed.
 
commandName:String (default = null) — Command name.

Returns
BACommand — A new command.
execute()method 
public function execute(parameters:StdGeographiesByAttributesParameters, responder:IResponder = null):AsyncToken

Sends a request for executing a Standard Geographies by Attributes task to the Community Analyst 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:StdGeographiesByAttributesParameters — Parameters of the task.
 
responder:IResponder (default = null) — A responder to call on result or fault.

Returns
AsyncToken — Asynch token associated with the response.
resultHandler()method 
override protected function resultHandler(asyncToken:AsyncToken):void

Parameters

asyncToken:AsyncToken

Constant Detail
nameConstant
public static const name:String = report/StdGeographiesByAttributes

Task name.