Open topic with navigation

TIBCO iProcess® Engine 11.9.1

# 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.)
`-i` `x` | 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.
`-m` `x` | 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.
`-r` `x` | 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.
`-u` `x` | 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.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2024. Cloud Software Group, Inc. All Rights Reserved.