Create Task Group Jobs (Topographic Production)

Summary

Creates new Task Group jobs based on the properties of an existing job.

Usage

  • This tool is intended for use with the Topographic Mapping production management workflows and will not support an improperly configured Workflow Manager (Classic) repository.

  • The TASK_GROUP_RELATIONSHIPS table is used to determine which types of task group jobs will be created.

  • The TASK_GROUP table is used to determine which feature class contains the AOIs that will be used for new Task Group jobs. A job will be created for each feature in the feature class that intersects and shares an interior with the AOI for the Job ID value. If no feature class is defined in the TASK_GROUP table, a job will be created with the same AOI as the Job ID value.

  • If the Job ID value is a Task job rather than a Task Group job, the jobs created by this tool will be determined by the properties of the parent Task Group job.

  • A job will not be created if a job with the same Task Group and AOI already exists and is in Created or Ready to Work status. However, the job ID of the existing job will be returned in the list of output job IDs.

Parameters

LabelExplanationData Type
Job ID

The job ID of the ArcGIS Workflow Manager (Classic) job that will have dependencies set.

Long
Input Database Path
(Optional)

The Workflow Manager (Classic) database connection file that contains the job information. If no connection file is specified, the current default Workflow Manager (Classic) database will be used.

File

Derived Output

LabelExplanationData Type
Output Job IDs

A list of job IDs that the job is dependent on.

Long

arcpy.topographic.CreateTaskGroupJobs(job_id, {database_path})
NameExplanationData Type
job_id

The job ID of the ArcGIS Workflow Manager (Classic) job that will have dependencies set.

Long
database_path
(Optional)

The Workflow Manager (Classic) database connection file that contains the job information. If no connection file is specified, the current default Workflow Manager (Classic) database will be used.

File

Derived Output

NameExplanationData Type
out_job_ids

A list of job IDs that the job is dependent on.

Long

Code sample

CreateTaskGroupJobs example (stand-alone script)

The following code sample demonstrates how to use the CreateTaskGroupJobs function in Python.

# Name: CreateTaskGroupJobs_sample.py
# Description: This script returns a list of new task group jobs that are created
# based on the area of interest and extended properties of the chosen job.

# Import System Modules
import arcpy

# Check Out Extensions
arcpy.CheckOutExtension('Foundation')
arcpy.CheckOutExtension('JTX')

# Setting the environment
arcpy.env.overwriteOutput = True

# Setting Local Variables
job_id = 23
input_database_connection = r'C:\Data\Workflows\Testing.jtc'

# Create new task group jobs
new_jobs = arcpy.topographic.CreateTaskGroupJobs(job_id, input_database_connection)

# Check In Extensions
arcpy.CheckInExtension('Foundation')
arcpy.CheckInExtension('JTX')

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Requires Production Mapping and Workflow Manager
  • Advanced: Requires Production Mapping and Workflow Manager

Related topics