Update Extended Property (Topographic Production)

Summary

Updates an extended property in the identified properties table for the chosen job.

Caution:

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.

Caution:

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.

Usage

  • If the Increment Value parameter is checked, the value will be added to any existing value. If the extended property is a number, the value will be added to the existing value and the sum will be set for the extended property value. If the extended property is not a number, the value will be appended to any existing value.

  • Populate the Properties Table Name parameter with the name of the table only. It is not necessary to populate the full database path to the table or the qualified name of the table.

  • The table designated in the Properties Table Name parameter must be registered as an extended property table in Workflow Manager (Classic).

Parameters

LabelExplanationData Type
Job ID

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

Long
Properties Table Name

The name of the extended properties table that will be updated.

String
Property Field

The property to be updated in the extended properties table.

String
Value

The value that will be set for the extended property.

String
Increment Value
(Optional)

If a value already exists for the chosen property, this parameter specifies whether the increment value will be added to the current value or will replace the current value.

  • Checked—The specified value will be added to any existing value for the property.
  • Unchecked—The specified value will replace the existing value for the property.
Boolean
Input Database Path
(Optional)

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

Derived Output

LabelExplanationData Type
Updated Job ID

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

Long

arcpy.topographic.UpdateExtendedProperty(job_id, properties_table_name, property_field, value, {increment_value}, {database_path})
NameExplanationData Type
job_id

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

Long
properties_table_name

The name of the extended properties table that will be updated.

String
property_field

The property to be updated in the extended properties table.

String
value

The value that will be set for the extended property.

String
increment_value
(Optional)

If a value already exists for the chosen property, this parameter specifies whether the increment value will be added to the current value or will replace the current value.

  • INCREMENTThe specified value will be added to any existing value for the property.
  • REPLACEThe specified value will replace the existing value for the property.
Boolean
database_path
(Optional)

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

Derived Output

NameExplanationData Type
updated_job_id

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

Long

Code sample

UpdateExtendedProperty example (stand-alone script)

This sample script increases the rework_count field in the TOPO_PRODUCTION_PROPERTIES table by 1.

# Name: UpdateExtendedProperty_sample.py
# Description: Sample script for running the Update Extended Property tool, and increasing the rework_count field in the
# TOPO_PRODUCTION_PROPERTIES table by 1

# 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 = 2023
properties_table_name = 'TOPO_PRODUCTION_PROPERTIES'
property_field = 'rework_count'
value = 1
increment_value = 'INCREMENT'
database_path = r'C:\Data\Workflows\Testing.jtc'

# Calling the Update Extended Property tool to increase the value in the rework_count field by 1
arcpy.topographic.UpdateExtendedProperty(job_id, properties_table_name, property_field, value, increment_value, database_path)

# 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')

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