Set Next Task (Topographic Production)

摘要

Sets the next task in a workflow from the task list.

警告:

This tool is designed to be run as a step in a Workflow Manager (Classic) workflow. Running this tool outside of Workflow Manager (Classic) does not honor all Workflow Manager (Classic) constraints such as job assignment, dependencies, or holds and may cause a job to enter an unusable state.

警告:

This tool is intended for use with the Topographic Mapping production workflows and will not support an improperly configured Workflow Manager (Classic) repository. Sample workflows and instructions for configuring Topographic Mapping production workflows are available as part of the product file installer.

提示:

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

使用情况

  • A task is a small, focused unit of work that can be executed by an individual. Task groups are composed of multiple tasks that, when executed in sequence, complete a type of work. For example, a task group to perform data extraction can be composed of tasks to collect data, validate the data, and publish the data. Task groups and their associated tasks are defined by your Workflow Manager (Classic) administrator as part of configuring the Topographic Mapping workflows.

  • When run through Workflow Manager (Classic), a parent job is created for a task group to define the type of work that needs to be completed over a specific area of interest. When a task is ready to be executed, a job is created for the task and is linked to the task group job as a child.

  • The Set Task List tool must be run before this tool to ensure that the appropriate tasks are associated with the job. Based on the list of tasks associated with the job, this tool determines the next task to be executed.

  • This tool uses the order and status of the tasks associated with the job to determine the next task. If a task is found, the current task extended property will be set with the ID of the task with the lowest task order that is in Waiting status. If all tasks have been completed and none remain in the task list, the current task will be set to 0.

参数

标注说明数据类型
Job ID

The ID of the Workflow Manager (Classic) job that will be updated.

Long
Input Database Path
(可选)

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

File

派生输出

标注说明数据类型
Updated Job ID

The Job ID of the updated Workflow Manager (Classic) job.

Long

arcpy.topographic.SetNextTask(job_id, {database_path})
名称说明数据类型
job_id

The ID of the Workflow Manager (Classic) job that will be updated.

Long
database_path
(可选)

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

File

派生输出

名称说明数据类型
updated_job_id

The Job ID of the updated Workflow Manager (Classic) job.

Long

代码示例

SetNextTask example (stand-alone script)

This script takes the next task with a status of 1 and sets it as the next task for the parent job.

# Name: SetNextTask_sample.py
# Description: This script will take the next task with a status of 1 and set it as the next task for the parent 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 = 2072
input_database_connection = r'C:\Data\Workflows\Testing.jtc'

# Calling the Set Next Task to update the TOPO_TASK_GROUP_PROPERTIES table and to set the next job
arcpy.topographic.SetNextTask(job_id, input_database_connection)

# Getting all messages, warnings, and errors from the tool run and printing the results back to the user
messages = arcpy.GetMessages(0)
warnings = arcpy.GetMessages(1)
errors = arcpy.GetMessages(2)
arcpy.AddMessage('Tool Messages: {}\nTool Warnings: {}\nTool Errors{}\n'.format(messages, warnings, errors))

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

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 否
  • Standard: 需要 Production Mapping and Workflow Manager
  • Advanced: 需要 Production Mapping and Workflow Manager

相关主题