Packagecom.esri.baserver.tasks.customerstoresetup
Classpublic class CustomerStoreSetupByCoordinatesParameters
InheritanceCustomerStoreSetupByCoordinatesParameters Inheritance AnalysisParameters Inheritance AnalysisParameters Inheritance BATaskParameters Inheritance Object

The CustomerStoreSetupByCoordinatesParameters class provides input parameters for the Customer/Store Setup by Coordinates task.

Point data for Customer/Store Setup are specified by either the dataTable or points parameters (these parameters are mutually exclusive). In the first case, the names of fields specified by parameter of this task should match the fields of the input data table, and the output layer will contain all fields specified in the input data table. In the second case, the customer/store layer will contain fields imported from PointRecord items.

The latitudeFieldName and longitudeFieldName parameters are used for identifying coordinate fields in the input record set specified with the dataTable object.

The geocodeCustomers parameter specifies the Setup type: the true value (default) means Customer Setup and the false value means Store Setup.

For Customer Setup, the nameField and linkField parameters can be specified. A new customer ID field is created.

For Store Setup, the storeIDField parameter should be specified when the dataTable parameter is used. The nameField parameter can be specified. The createNewIDField parameter specifies whether to create a new store ID field or not. If its value is true, a new store ID field is added to the output layer with the name specified by the storeIDField parameter. If this name already exists in the input fields, it is slightly modified to be unique. For example, if the input data already contains a field with a STORE_ID name and you try to create a new store ID field with the same name, a new field with the STORE_ID_1 name will be created in the output layer.

Output options for this task include rendering an output image (outputTypes.getMapImage) and/or creating a feature class for subsequent analysis (outputTypes.getFeatureClass). If no output options are specified, the required output options are specified as follows. If the renderingParameters parameter is specified, the image output is requested. If the outputAnalysisItem parameter is specified, the output analysis feature class will be stored in the repository. If both renderingParameters and outputAnalysisItem parameters are missing, the feature class output is requested.

View the examples

See also

CustomerStoreSetupByCoordinatesTask


Public Properties
 PropertyDefined By
 InheritedactiveDatasetID : String
Active dataset ID.
BATaskParameters
  createNewIDField : Boolean
An option specifying the use of an existing store ID field or creating a new store ID field for Store Setup.
CustomerStoreSetupByCoordinatesParameters
  dataTable : TableData
Data table containing a point record set.
CustomerStoreSetupByCoordinatesParameters
  geocodeCustomers : Boolean
An option specifying the setup type.
CustomerStoreSetupByCoordinatesParameters
  latitudeFieldName : String
Name of the latitude (y) field.
CustomerStoreSetupByCoordinatesParameters
  linkField : String
The name of the field to be used for assigning customers with stores or trade areas for Customer Setup.
CustomerStoreSetupByCoordinatesParameters
  longitudeFieldName : String
Name of the longitude (x) field.
CustomerStoreSetupByCoordinatesParameters
  nameField : String
Store/customer name field.
CustomerStoreSetupByCoordinatesParameters
 InheritedoutputAnalysisItem : FolderItem
Configuration options for storing the output feature class in the repository.
AnalysisParameters
 InheritedoutputSpatialReference : SpatialReference
The spatial reference to return the output feature set in.
AnalysisParameters
 InheritedoutputTypes : OutputTypes
Task output types.
BATaskParameters
  points : Array
Array of points specified with PointRecord instances.
CustomerStoreSetupByCoordinatesParameters
 InheritedrenderingParameters : RenderingParameters
Configuration options for rendering output to map image.
AnalysisParameters
 InheritedresultType : BAResultType
[read-only] Type of the result returned by the task associated with these parameters.
BATaskParameters
 InheritedreturnGeometry : Boolean
An option specifying the presence of the shape attribute in the returned record set.
AnalysisParameters
  spatialReference : SpatialReference
A spatial reference.
CustomerStoreSetupByCoordinatesParameters
  storeIDField : String
Store ID field name for Store Setup.
CustomerStoreSetupByCoordinatesParameters
 InheritedtaskName : String
[read-only] Name of a Community Analyst Task associated with these parameters.
BATaskParameters
Public Methods
 MethodDefined By
  
Creates a new instance of the CustomerStoreSetupByCoordinatesParameters class.
CustomerStoreSetupByCoordinatesParameters
Property Detail
createNewIDFieldproperty
createNewIDField:Boolean

An option specifying the use of an existing store ID field or creating a new store ID field for Store Setup.

The default value is false.


Implementation
    public function get createNewIDField():Boolean
    public function set createNewIDField(value:Boolean):void
dataTableproperty 
dataTable:TableData

Data table containing a point record set.


Implementation
    public function get dataTable():TableData
    public function set dataTable(value:TableData):void
geocodeCustomersproperty 
geocodeCustomers:Boolean

An option specifying the setup type.

The default value is true.


Implementation
    public function get geocodeCustomers():Boolean
    public function set geocodeCustomers(value:Boolean):void
latitudeFieldNameproperty 
latitudeFieldName:String

Name of the latitude (y) field. This property is used if the dataTable property is specified.

The default value is "Latitide".


Implementation
    public function get latitudeFieldName():String
    public function set latitudeFieldName(value:String):void
linkFieldproperty 
linkField:String

The name of the field to be used for assigning customers with stores or trade areas for Customer Setup.


Implementation
    public function get linkField():String
    public function set linkField(value:String):void
longitudeFieldNameproperty 
longitudeFieldName:String

Name of the longitude (x) field. This property is used if the dataTable property is specified.

The default value is "Longitude".


Implementation
    public function get longitudeFieldName():String
    public function set longitudeFieldName(value:String):void
nameFieldproperty 
nameField:String

Store/customer name field.


Implementation
    public function get nameField():String
    public function set nameField(value:String):void
pointsproperty 
points:Array

Array of points specified with PointRecord instances.


Implementation
    public function get points():Array
    public function set points(value:Array):void

See also

spatialReferenceproperty 
spatialReference:SpatialReference

A spatial reference.


Implementation
    public function get spatialReference():SpatialReference
    public function set spatialReference(value:SpatialReference):void

See also

storeIDFieldproperty 
storeIDField:String

Store ID field name for Store Setup. This property is required if dataTable property is used.


Implementation
    public function get storeIDField():String
    public function set storeIDField(value:String):void
Constructor Detail
CustomerStoreSetupByCoordinatesParameters()Constructor
public function CustomerStoreSetupByCoordinatesParameters(outputTypes:OutputTypes = null)

Creates a new instance of the CustomerStoreSetupByCoordinatesParameters class.

Parameters
outputTypes:OutputTypes (default = null) — Task output types.
Examples
ActionScript to create CustomerStoreSetupByCoordinatesParameters and then use in a Customer/Store Setup by Coordinates task.
                     
     var parameters : CustomerStoreSetupByCoordinatesParameters = new CustomerStoreSetupByCoordinatesParameters();
     
     // points is an array of com.esri.bacore.PointRecord items, e.g.
     //var points:Array = [new PointRecord("store_1", "Store 1", "1", 34.052074, -117.207841)];
     
     parameters.points = points;
     
     customerStoreSetupByCoordinatesTask.execute(parameters, new Responder(resultHandler, faultHandler));