Create Task Group Jobs (Topographic Production)

Summary

Creates task group jobs based on the properties of an existing job.

Tip:

It is recommended that current Workflow Manager (Classic) users begin new projects using the services-driven version of ArcGIS Workflow Manager for ArcGIS Pro.

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 the types of task group jobs that will be created.

  • The TASK_GROUP table is used to determine the feature class that contains the area of interests (AOIs) that will be used for the 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 parameter 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 parameter value.

  • If the Job ID parameter value is a task job rather than a task group job, the jobs created by this tool will be defined 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 exists with a 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 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 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