Create Workflow Database

Available with Workflow Manager license.

Summary

Creates Workflow Manager schema and configures an enterprise geodatabase as the Workflow Manager database.

The Workflow Manager database is used to store the job and configuration information for your work management system. Creating a Workflow Manager database is an administrative activity that creates the Workflow Manager schema in the specified enterprise geodatabase. The Workflow Manager database schema consists of system tables and one feature class that is used to store the geometries for the Area of Interest (AOI) for your jobs.

Note:

The Workflow Manager system tables created by this tool are geodatabase tables that are registered with your enterprise geodatabase. It is strongly advised that you not delete or modify these tables using your RDBMS tools.

Note:

The Workflow Manager repository name is created based on the database instance name and user name, for example, <instance name>_<username>. If operating system authentication is used, the name of the user logged in to the system will be used.

Usage

• When creating a Workflow Manager database, an owner user account with Update, Insert, Select, and Delete privileges is required, and a direct connection file (*.sde) to the enterprise geodatabase must be used.

  Note:

  The Update, Insert, Select, and Delete privileges are equivalent to those granted to the data creator user. These database-level permissions should be assigned by your database administrator for the Workflow Manager database.

• When creating the Workflow Manager database, define a spatial reference for the AOI feature class. The spatial reference chosen for the AOI feature class is applied to all AOIs in the Workflow Manager database. Thus, a global spatial reference is recommended if the AOIs of your jobs are going to be in different locations of the world.

  Note:

  For more information about the Workflow Manager AOI, see Essential Workflow Manager vocabulary.

• When creating a Workflow Manager database, a configuration with the Workflow Manager elements is imported. The Import Configuration parameter provides the following three options to import a configuration into the new Workflow Manager database:

  • Minimum Configuration—Imports the basic elements the Workflow Manager system requires to function properly. The file required for the import is included as part of the Workflow Manager installation. The following is a list of imported elements:
    • Privileges
    • User Groups - Only Administrator group
    • Status Types
    • Activity Types
    • Job Notification Types
    • Settings
    • Priorities
    • Hold Types
  • Quick Configuration—Imports all elements in the Minimum Configuration as well as samples of the other elements. The file required for import is included as part of the Workflow Manager installation. The samples are as follows:
    • Users
    • User Groups
    • Job Queries
    • Step Types
    • Hold Types
    • Settings
    • Job Types
    • Default Properties
    • Workflows
    • Naming Schemas
  • Custom Configuration—Imports a configuration from an existing Workflow Manager database. The file required for import can be generated by exporting the configuration from an existing Workflow Manager database.

    Note:

    For more information on exporting an existing configuration, see Exporting configuration files. For more information on exporting a configuration with jobs, see the Export Job Data tool.

• Check with your database administrator for information about a database configuration keyword to be used if a specific keyword has been set up for Workflow Manager. If no configuration keyword is specified, the DEFAULTS keyword is used.

• The User Store parameter defines the user store from which the user and role information is imported. When Portal is chosen, the users are retrieved from an existing portal and added to the Workflow Manager repository. When Traditional is chosen, the users and group roles are defined by an administrator in Workflow Manager Administrator. The roles can be imported from Active Directory or created manually.

  Note:

  To import the user store information using the Portal option, you must be signed in to the portal.

• The output is a database file (.jtc) with the Workflow Manager schema.

  The .jtc file is stored in the Workflow Manager Database folder.

Syntax

CreateWorkflowDatabase(Input_Database_Connection, AOI_Spatial_Reference, Import_Configuration, Input_Custom_Configuration, {User_Store})

Parameter	Explanation	Data Type
Input_Database_Connection	The location of the enterprise geodatabase connection file that will host the Workflow Manager schema and configuration. The connection file must connect directly to the database, and the connection should be made as a database owner.	Workspace
AOI_Spatial_Reference	The spatial reference of the AOI feature class. You can specify the spatial reference in the following ways: Input the path to a .prj file, such as c:/workspace/watershed.prj. Define a spatial reference object—such as AOI_Spatial_Reference = arcpy.SpatialReference("c:/data/Africa/Carthage.prj") or AOI_Spatial_Reference = arcpy.SpatialReference('WGS 1984')—prior to using this tool, which you then use as the spatial reference parameter.	Coordinate System
Import_Configuration	Specifies the Workflow Manager elements to be imported into the new Workflow Manager database. The default is Minimum Configuration. Minimum Configuration —Imports the basic elements that the Workflow Manager system requires. Quick Configuration —Includes the Minimum Configuration elements plus samples for several elements. Custom Configuration —Specifies a Workflow Manager configuration file in the Input Custom Configuration parameter, exported from a preexisting database.	String
Input_Custom_Configuration	A custom configuration file that was exported from an existing Workflow Manager database.	File
User_Store (Optional)	The user store from which to retrieve the users and roles. The users can be imported from a portal and are assigned to roles created in the Workflow Manager repository. The portal user profile information cannot be edited using Workflow Manager Administrator. The users and roles can be created in the Workflow Manager repository using the TRADITIONAL option. When using the TRADITIONAL option, the users and roles can be imported from the Active Directory in Workflow Manager Administrator. PORTAL —The users will be imported from the portal you are currently signed in to. TRADITIONAL —The users and roles will be created in the Workflow Manager repository using Workflow Manager Administrator. Users and roles can be imported from the Active Directory when this option is used. This is the default.	String

Derived Output

Name	Explanation	Data Type
Output_DatabasePath	The output database file (.jtc) with Workflow Manager schema. The .jtc file is stored in the Workflow Manager Database folder.	File

Code sample

CreateWorkflowDatabase example 1 (stand-alone script)

This script creates and sets up a Workflow Manager database in an existing enterprise geodatabase, and the user store is set up in the Workflow Manager Administrator. Since no database configuration keyword is specified, DEFAULTS will be used by the tool.

# Import arcpy module
import arcpy

# Local variables:
Input_Database_Connection = r'C:\wmxrepository.sde'
AOI_Spatial_Reference = arcpy.SpatialReference('WGS 1984')
Import_Configuration = 'Quick Configuration'
User_Store = 'Traditional'

# Process: Create Workflow Database
arcpy.CreateWorkflowDatabase_wmx(Input_Database_Connection, 
                                 AOI_Spatial_Reference, Import_Configuration, 
                                 "", "", User_Store)

CreateWorkflowDatabase example 2 (stand-alone script)

This script creates and sets up a Workflow Manager database in an existing enterprise geodatabase, and the user store is imported from a portal you are currently signed in to. The database configuration keyword WMX is used.

# Import arcpy module
import arcpy

# Local variables:
Input_Database_Connection = r'C:\wmxrepository.sde'
AOI_Spatial_Reference = arcpy.SpatialReference('WGS 1984')
Import_Configuration = 'Minimum Configuration'
Config_keyword = 'WMX'
User_Store = 'Portal'

# Process: Create Workflow Database
arcpy.CreateWorkflowDatabase_wmx(Input_Database_Connection, 
                                 AOI_Spatial_Reference, Import_Configuration, 
                                 "", Config_keyword, User_Store)

CreateWorkflowDatabase example 3 (stand-alone script)

This script creates and sets up a Workflow Manager database in an existing enterprise geodatabase, and the user store is imported from a portal you are currently signed in to.

# Import arcpy module
import arcpy

# Local variables:
Input_Database_Connection = r'C:\wmxrepository.sde'
AOI_Spatial_Reference = arcpy.SpatialReference('WGS 1984')
Import_Configuration = 'Custom Configuration'
Config_File = r'C:\WMX\CustomConfiguration.jxl'
User_Store = 'Traditional'

# Process: Create Workflow Database
arcpy.CreateWorkflowDatabase_wmx(Input_Database_Connection, 
                                 AOI_Spatial_Reference, Import_Configuration, 
                                 Config_File, "", User_Store)

Environments

• Output CONFIG Keyword

Licensing information

• Basic: No
• Standard: Requires Workflow Manager
• Advanced: Requires Workflow Manager