Rebuild Territory Solution (Territory Design)

Available with Business Analyst license.

Summary

Updates the territory solution to reflect changes made to the base level.

Usage

  • The input data must be an existing territory solution layer.

  • Territory levels are rebuilt with the correct territory ID.

  • If the parent ID is updated in the base level attribute table, the territory level is not automatically updated to reflect the changes. You must rebuild to propagate the changes to the upper level.

  • The following changes are supported by the tool:

    • Edits to the geometry of the base layer, for example, add, move, and delete.
    • Updates to attribute value; for example, attribute values will be aggregated to the upper level with rebuild.
    • Updates to parent ID.

  • Removing fields is not supported.

  • If territories are manually updated using the Territory Design ribbon tools—for example, Assign and Unassign—the upper level territory will automatically update and you will not need to rebuild.

Parameters

LabelExplanationData Type
Input Territory Solution

The input territory solution.

Group Layer; Feature Dataset; String
Boundary Mask
(Optional)

The layer that is used as a mask to limit the growth of point-based layers.

Feature Layer

Derived Output

LabelExplanationData Type
Updated Territory Solution

The updated territory solution.

Group Layer

arcpy.td.RebuildTerritorySolution(in_territory_solution, {in_boundary_mask})
NameExplanationData Type
in_territory_solution

The input territory solution.

Group Layer; Feature Dataset; String
in_boundary_mask
(Optional)

The layer that is used as a mask to limit the growth of point-based layers.

Feature Layer

Derived Output

NameExplanationData Type
out_territory_solution

The updated territory solution.

Group Layer

Code sample

RebuildTerritorySolution example (Python window)

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

import arcpy
arcpy.td.RebuildTerritorySolution("TD")

Environments

Licensing information

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

Related topics