Import Procedures Using Command Line Options

Use the swutil IMPORT command line options to quickly import one or more procedures. By setting the required command line options, you can define the required import options and suppress the prompts/questions.

To import a procedure, use the following command:

swutil IMPORT [procedure] [options]

where:

• procedure is the name of the .xfr file to import.

To import a procedure (for example, carpool.xfr) from a directory outside of SWDIR/util (for example, /Dept/Purchasing), run the following command:

swutil IMPORT /Dept/Purchasing

• options can be one or more of the following to suppress or change a specific option:

swutil IMPORT Options

Option

Description

+c

Overwrite the existing procedure description when you import a procedure as a new version.

-c

Do not overwrite the existing procedure description when you import a procedure as a new version.

-d

Do not prompt for the procedure’s Owner (the current user is used).

+d owner

Do not prompt for the Owner but set the value of Owner to the value supplied in owner.

-e

Use existing use files if there is a clash of names with existing files.

-g

Suppress confirmation when generating a new GUID for a renamed procedure.

-h

Display the command help (showing these options.)

-ix

Import an Incomplete procedure with status x, where x is one of the following:

• i for Incomplete
• w for Withdrawn

For example, -ii imports an Incomplete procedure as Incomplete.

Note: If you choose -ii but an Incomplete or Unreleased version of the procedure already exists, the option is ignored and the procedure is imported as Withdrawn instead.

-l

Overwrite lists that already exist.

-mx

Import a Model procedure with status x, where x is one of the following:

• m for Model
• r for Released
• w for Withdrawn

For example, -mr imports a Model procedure as Released.

Note: If you choose -mm but a Model version of the procedure already exists, or -mr and a Released version already exists, the option is ignored and the procedure is imported as Withdrawn instead.

-n

Choose to create a new version of the procedure for the prompt “New version or New name”.

+n name

Import the procedure as a new procedure with the given name instead of prompting for “New version or New name.”

-oa

Do not overwrite access control properties

+oa

Overwrite access control properties

-q

Import a procedure using the same procedure name (as a new version), owner and release status (except for an Incomplete procedure) with which it was exported, without having to complete the associated prompts.

Note: This option is equivalent to using the -d, -n, -mm, -rr and -uu options.

-rx

Import a Released procedure with status x, where x is one of the following:

• m for Model
• r for Released
• w for Withdrawn

For example, -rr imports a Released procedure as Released.

Note: If you choose -rm but a Model version of the procedure already exists, or -rr and a Released version already exists, the option is ignored and the procedure is imported as Withdrawn instead.

-t

Respond No to Import/Overwrite Table Data? prompt. Do not Import/Overwrite iProcess Table Data.

+t

Respond Yes to Import/Overwrite Table Data? prompt. Import/Overwrite iProcess Table Data.

-ux

Import an Unreleased procedure with status x, where x is one of the following:

• u for Unreleased
• w for Withdrawn

For example, -uu imports an Unreleased procedure as Unreleased.

Note: If you choose -uu but an Incomplete or Unreleased version of the procedure already exists, the option is ignored and the procedure is imported as Withdrawn instead.

-v

Display messages showing if a procedure has been committed to the database or rolled back. See Display Commit/Rollback Messages When Importing Procedures or Procedure Libraries.

+z

Import the procedure with case data normalization enabled. See TIBCO iProcess Engine Administrator’s Guide for more information about case data normalization.

-z

Import the procedure with case data normalization disabled. See TIBCO iProcess Engine Administrator’s Guide for more information about case data normalization.

 

Note 
• For any options that you do not set or suppress, you will be prompted in the same way as using the interactive method of importing a procedure.
• If you do not specify a procedure name or any options with the command, a “Do you want to import another xfr file?” prompt appears at the end of the current import process.

If you specify a procedure name or any options, the prompt is suppressed and the command terminates at the end of the current import process.

The procedure is imported to the root Procedure Management library. If you want to move the procedure to another library, use Procedure Manager to do so. See "Moving and Copying Procedures, Libraries and Shortcuts" in TIBCO iProcess Modeler Procedure Management.

Example

To import a released procedure called quota as a Model procedure suppressing all the other questions/prompts, use the following command:

swutil IMPORT quota -d -e -rm +t

Note 

You can abbreviate the options as shown in the above example. Therefore, instead of entering -d -e- -rm +t, you just need to enter -derm +t. You need to leave a space between a - option and a + option.