Add Territory Barriers (Territory Design)

Available with Business Analyst license.

Summary

Allows the addition of polygon or line features to prevent or restrict the growth of territories.

Illustration

Usage

• Line or polygon layers can be used as barriers.

• New features can be added to an existing barrier.

• Each level can contain both an impedance and a restricted area.

Parameters

Dialog

Label	Explanation	Data Type
Input Territory Solution	The Territory Design solution layer that will be used in the analysis.	Group Layer; Feature Dataset; String
Level	The level to which the barriers will be applied.	String
Input Barrier Features	Line or polygon features used as a barrier.	Feature Layer
Barrier Type (Optional)	Specifies the type of barrier. Impedance— Limits the growth of territories. This is the default. Restricted Area—Prevents the creation of territories.	String
Append to existing barriers (Optional)	Specifies whether to append or replace the records to the barrier layer. Checked—Appends records to an existing barrier layer. Unchecked—Creates a new barrier layer or replaces records in an existing barrier layer. This is the default.	Boolean

Derived Output

Label	Explanation	Data Type
Updated Territory Solution	The updated territory solution.	Group Layer

Python

arcpy.td.AddTerritoryBarriers(in_territory_solution, level, in_barrier_features, {barrier_type}, {append_data})

Name	Explanation	Data Type
in_territory_solution	The Territory Design solution layer that will be used in the analysis.	Group Layer; Feature Dataset; String
level	The level to which the barriers will be applied.	String
in_barrier_features	Line or polygon features used as a barrier.	Feature Layer
barrier_type (Optional)	Specifies the type of barrier. IMPEDANCE— Limits the growth of territories. This is the default. RESTRICTED_AREA—Prevents the creation of territories.	String
append_data (Optional)	Specifies whether to append or replace the records to the barriers layer. APPEND—Appends records to an existing barrier layer. REPLACE—Creates a new barrier layer or replaces records in an existing barrier layer. This is the default.	Boolean

Derived Output

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

Code sample

AddTerritoryBarriers example (Python window)

The following Python window script demonstrates how to use the AddTerritoryBarriers tool.

import arcpy
arcpy.td.AddTerritoryBarriers("in_territory_solution", "Level[1]", "in_barrier_features", "IMPEDANCE", "REPLACE_DATA")

Environments

Current Workspace

Licensing information

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