Create Territory Solution (Territory Design)

Available with Business Analyst license.

Summary

Creates a new territory solution with two levels and loads input features into the base level.

Usage

• Input features for the base level can be a point feature layer or a polygon feature layer.

• The type of input layer will determine how the base level is displayed, for example, points or polygons.

• Additional geometries can be created to display either boundary centers or polygon boundaries.

• Additional layers can be created to display the base level, for example, centers of polygons or boundaries of points.

• The ID Field and the Name Field parameters are optional. Specifying these parameters will load attribute values from the input features to uniquely identify features in the base layer, such as ZIP Codes or census tract names. If no ID field is specified, a unique ID will be automatically generated.

• By default, all of the fields in the input layer will be added to the territory solution. You can turn off field visibility by right-clicking the column header and clicking Hide Field if you do not want the field to be added to the territory solution.

• The %Number% variable determines where the integer number is placed, either after or before the territory name—for example, Territory %Number% produces Territory 1, Territory 2, and so forth, and %Number% Territory produces 1 Territory, 2 Territory, and so forth.

• A mask layer is only supported for a point-based territory solution.

Parameters

Dialog

Label	Explanation	Data Type
Input Features	The geometry or data features that will be used as the base level of the created solution. The level will have the same name as the input features.	Feature Layer
Territory Solution Name	The name of the territory solution that will be created.	String
ID Field (Optional)	The field that contains ID values for objects in the level.	Field
Name Field (Optional)	The input layer field that contains the name values that will be loaded into the base level.	Field
Territory Level Name (Optional)	The name of the territory level, for example, level 2.	String
Default Territory Name (Optional)	The prefix for the names of the new territories that will be created, for example, Territory 1, Territory 2, and Territory 3 or District 1, District 2, and District 3.	String
Boundary Mask (Optional)	The layer that will be used as a mask to limit the growth of point-based layers.	Feature Layer

Derived Output

Label	Explanation	Data Type
Output Territory Solution	The output territory solution.	Group Layer

Python

arcpy.td.CreateTerritorySolution(in_features, solution_name, {id_field}, {name_field}, {territory_level_name}, {default_territory_name}, {in_boundary_mask})

Name	Explanation	Data Type
in_features	The geometry or data features that will be used as the base level of the created solution. The level will have the same name as the input features.	Feature Layer
solution_name	The name of the territory solution that will be created.	String
id_field (Optional)	The field that contains ID values for objects in the level.	Field
name_field (Optional)	The input layer field that contains the name values that will be loaded into the base level.	Field
territory_level_name (Optional)	The name of the territory level, for example, level 2.	String
default_territory_name (Optional)	The prefix for the names of the new territories that will be created, for example, Territory 1, Territory 2, and Territory 3 or District 1, District 2, and District 3.	String
in_boundary_mask (Optional)	The layer that will be used as a mask to limit the growth of point-based layers.	Feature Layer

Derived Output

Name	Explanation	Data Type
out_territory_solution	The output territory solution.	Group Layer

Code sample

CreateTerritorySolution example (Python window)

The following Python window script demonstrates how to use the CreateTerritorySolution function.

import arcpy
arcpy.td.CreateTerritorySolution("CensusTacts", "Territory Solution", "CensusID", "TractName", "Territories", "Territory", None)

Environments

Current Workspace

Licensing information

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