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

Line barriers

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

LabelExplanationData 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 AreaPrevents 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

LabelExplanationData Type
Updated Territory Solution

The updated territory solution.

Group Layer

arcpy.td.AddTerritoryBarriers(in_territory_solution, level, in_barrier_features, {barrier_type}, {append_data})
NameExplanationData 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_AREAPrevents the creation of territories.
String
append_data
(Optional)

Specifies whether to append or replace the records to the barriers layer.

  • APPENDAppends records to an existing barrier layer.
  • REPLACECreates a new barrier layer or replaces records in an existing barrier layer. This is the default.
Boolean

Derived Output

NameExplanationData 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

Licensing information

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

Related topics