cqload importintegration
Applicability
Platform: Windows
Command type: cqload subcommand
Synopsis
- cqload importintegration [-dbset dbset ] loginID password schema recordType integrationName integrationVersion "schemaFilePath" formName
Description
The cqload importintegration subcommand modifies an existing schema by importing a partial schema from a file created by using the cqload exportintegration subcommand. To import an entire schema into the schema repository, use the cqload importschema subcommand.
If a schema contains packages that are not installed in the schema repository, an error occurs for each package that is not found. Before using the cqload importintegration subcommand, right-click a schema repository and select install package to install the missing packages.
Options and arguments
- -dbset dbset
- Specifies the Rational ClearQuest connection name. Required if there are multiple schema repositories in the system.
- loginID
- Login name of the Rational ClearQuest user. This user must have Super User privileges.
- password
- Password for the loginID user. If the user does not have a password, you must enter an empty set of double quotes ("") if there is no password.
- schema
- Name of the schema associated with the integration. This is the simple name of a schema that is defined in your schema repository. Note that the schema revision number increases by one after running the cqload importintegration subcommand.
- recordType
- The record type in the target schema (for example, Defect) to which you want to add an integration. You must enter an empty set of double quotes ("") to omit this option.
- integrationName
- Name that you assign to the integration. You can specify any alphanumeric indicator such as a comment that identifies the integration you are loading.
- integrationVersion
- Version of the integration that you are loading. This is a numeric
value that is used as a comment to identify the integration. Important: The version of the schema that you are integrating is increased by one in the target schema regardless of the number of versions that you import from the source.
- schemaFilePath
- Path name of a schema integration file that has been created by the cqload exportintegration subcommand. Enclose the path name in double quotes ("").
- formName
- Form to which the new tabs created by the integration are added. If no form updates are required, enter an empty set of double quotes ("").
Examples
- Import the exported schema revisions into the Testing schema,
leaving all record types with their original names.
cqload importintegration -dbset 2013.00.00 admin secret Testing "" Email_Integ 1 "c:\program files\rational\clearquest 1.1\schema.txt" ""
- Import the exported schema revisions into the Testing schema,
renaming the record type specified in the recordType option
of the previously run cqload exportintegration subcommand to Defect.
cqload importintegration -dbset 2013.01.00 admin secret Testing Defect Email_Integ 1 "c:\tmp\export.txt" ""
Troubleshooting
- Following is an example of importing your schema revisions by running the cqload
importintegration subcommand for each revision.
cqload importintegration -dbset 2013.01.00 admin secret IBM_SR Service_Request i 8 "c:\clearquest\schema8.txt" ""
cqload importintegration -dbset 2013.01.00 admin secret IBM_SR Service_Request i 9 "c:\clearquest\schema9.txt" ""