Copyright © TIBCO Software Inc. All rights reserved.
Copyright © TIBCO Software Inc. All rights reserved.


Chapter 9 Procedures and Procedure Libraries : Import a Procedure

Import a Procedure
This section describes how to import a procedure into Procedure Manager. For example, you might want to do this if you have received a procedure definition file (.xfr) from another office that you need to use.
Note that:
Single procedures can only be imported to the root Procedure Management library. You can move them to your target libraries after the import using Procedure Manager.
If you import a .xfr file that was exported from iProcess Version 8 or Version 9, any Autosteps or Open Client steps will be ignored. After you have imported the procedure, you can replace or remove these step types in TIBCO iProcess Modeler.
By default, the procedure keeps the version number contained in the .xfr file. A pre-iProcess Version 10.0 procedure uses the default version number (because it has no version numbering information in the .xfr file).
Import a Procedure Interactively
The interactive method uses the swutil menu and displays prompts for each stage of the import. If you want to import a procedure without displaying all of the prompts, use the command line method. See Import Procedures Using Command Line Options.
To import a procedure (the following example uses a procedure called APPLY1) using the swutil menu:
1.
7 - Import an ‘xfr’ file
The following prompt is displayed:

 
Working, Please Wait .....
Importing a Procedure
Name of xfr file (<CR> to quit )?

 
2.
Enter the name of the .xfr file that contains the procedure you want to import.
For example, if the procedure definition file is called apply1.xfr, enter apply.
3.

 
Checking Procedure ‘APPLY1’:
Procedure name APPLY1 already exists
‘R’ename, ‘N’ew version or ‘A’lways new version?

 
Instead, you must choose one of the following options:
R  Rename the procedure.
(You cannot rename an OEM locked procedure. If you do, the import attempt will fail.)
Name of procedure (<CR> to quit).
N  Create a new version of the procedure, in which case the minor version number is automatically incremented.
A  Always create a new version. Select this option, if you are importing more than one procedure and want to create a new version for each one. This prompt is then suppressed for any remaining procedures during this command session.
4.

 
Do you want to change the default owner - owner?
Yes, No, A yes and apply to all, Skip all

 
You can choose one of the following:
Yes - and then enter a new username.
iProcess checks that this username is a valid iProcess user, but does not verify that the user has the appropriate permissions on the procedure. You must ensure that the specified username has appropriate access to the procedure.
No - and use the existing username.
A - and then enter a new username and this will apply to all remaining procedures being imported.
S - responds No to all and sets the owner to the user performing the import.
5.

 
Enable Case Data Normalization for the current procedure?
’Y’es, ’N’o, ’A’(Yes and apply to all), ’S’kip (No to all
):

 
You can choose one of the following:
Yes - to enable case data normalization.
No - to import the procedure without case data normalization enabled.
A - yes to enable case data normalization and apply this to all remaining procedures being imported.
S - no to enabling case data normalization and apply this to all remaining procedures being imported.
6.
You are prompted to overwrite the procedure description. Select Y to overwrite the procedure description, or N to use the existing procedure description.
7.
a.
The release status of the procedure in the .xfr file, as shown in the following table:
b.
The status that a procedure can be imported as depends upon the status of any existing versions of the procedure on the system, as shown in the following table.
Unreleased or Incomplete
8.
9.
10.
You are prompted if you want to import another procedure. Enter Y or N. If you enter Y, continue from step 1.
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.
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:
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.
Use existing use files if there is a clash of names with existing files.
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.
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 name
Note: This option is equivalent to using the -d, -n, -mm, -rr and -uu options.
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.
Respond Yes to Import/Overwrite Table Data? prompt. Import/Overwrite iProcess Table Data.
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.
Import the procedure with case data normalization enabled. See TIBCO iProcess Engine Administrator’s Guide for more information about case data normalization.
Import the procedure with case data normalization disabled. See TIBCO iProcess Engine Administrator’s Guide for more information about case data normalization.
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.
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

 
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.

Copyright © TIBCO Software Inc. All rights reserved.
Copyright © TIBCO Software Inc. All rights reserved.