ArcMap

Assign Customers by SOLAP Data

Available with Business Analyst license.

Summary

This tool is designed to use multiple SALES fields, which are extracted from the OLAP cube to build criteria for assigning customers to the stores.

Usage

Syntax

arcpy.ba.AssignCustomersBySOLAP(CustomerLayer, InStoreDimension, InSelectedHierarchyLevels, WayToDefineLinkField, LinkField, {VBSScriptString}, {InAssignToOneStore}, {CreateNewFeatureClass}, {OutputFeatureClass})
ParameterExplanationData Type
CustomerLayer

The customer layer used to make the customer assignments to each store.

Feature Layer
InStoreDimension

Select the store dimension in the customer layer. A dimension is an axis of an OLAP cube.

String
InSelectedHierarchyLevels

Select the hierarchy level to process. Hierarchies categorize a dimension into a number of levels. More than one hierarchy can be associated with the same dimension.

String
WayToDefineLinkField

Determines how store is selected.

  • CREATE NEW —Creates a new Store ID field.
  • USE EXISTING —Uses an existing Store ID field.
String
LinkField

The store ID field that will be used to assign customers.

String
VBSScriptString
(Optional)

Input a custom VBS script assigning customers to stores based on the dimensions in the customer layer.

String
InAssignToOneStore
(Optional)

Allows the user to decide if the assignment of a customer to a store will be influenced by which store he/she shops at most.

  • True —Assigns the customer to the store he/she shops at most.
  • False —Will not assign the customer to the store he/she shops at most.
Boolean
CreateNewFeatureClass
(Optional)

Generates a new feature class based on the existing layer or uses the existing layer.

  • True —Creates a new feature class.
  • False —Does not create a new feature class. The original layer will be used.
Boolean
OutputFeatureClass
(Optional)

The feature class that will contain the customer features.

Feature Class

Code sample

AssignCustomersBySOLAP example (stand-alone script)

# Name: AssignCustomersBySOLAP.py
# Description: Assigns customers in the San Francisco area to their designated store.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business") 
 
# Define the parameters for the Assign Customers by SOLAP Data tool

  CustPath = "C:\My Output Data\Projects\Default Project\CustLayers\OLAP\Customer.shp"
  StoreDim = "Product"
  Hierarchy = "ALL"
  StoreId = "STORE_ID"
 
# Assign Customers by SOLAP Data
  arcpy.AssignCustomersBySOLAP_ba(CustPath,
	  StoreDim,
	  Hierarchy,
	  StoreId)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Requires Business Analyst
  • Standard: Requires Business Analyst
  • Advanced: Requires Business Analyst

Related topics