cqload importintegration

Imports schema modifications to an existing schema from a schema file created with the exportintegration subcommand.

Applicability

Platform: Windows®

Command type: cqload subcommand

Synopsis

cqload importintegration

[ -dbset dbset_name ]  login password schema name [record type ] "integration name "
integration version  schema pathname"comment or description"new form"

Description

The importintegration subcommand modifies an existing schema by importing a partial schema from a file created using the exportintegration subcommand. To import an entire schema into the schema repository, use the 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 importintegration subcommand, right-click a schema repository and select install package to install the missing packages.

Attention: If you are using Rational® ClearQuest® MultiSite, you can only run the importintegration subcommand at the working master site.

Options and arguments

dbset_name
Specifies the ClearQuest connection name. Required if there are multiple schema repositories in the system.
login
ClearQuest login name of the user. This user must have Super User privileges.
password
ClearQuest password for the user. You must enter an empty set of double quotes ("") if there is no password.
schema name
Name of the schema associated with the integration. This name is the simple name of a schema that is defined in your schema repository (For example, TeamTest). The schema revision number increases by one after running the importintegration subcommand.
record type
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.
integration name
Name that you assign to the integration. You can specify any alphanumeric indicator such as a comment that identifies the integration you are loading.
integration version
Version that you are loading. This is a numeric value that is used as a comment identifying the integration you are loading.
Note: The version of the schema you are integrating is increased by one in the target schema regardless of the number of versions you import from the source.
schema pathname
Path name of a schema integration file that has been created by the exportintegration subcommand. Enclose the path name in double quotes.
form name
Forms 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

Troubleshooting

If you are having problems importing a block of schema revisions, use the exportintegration subcommand to create export files one revision at a time, then import them one revision at a time.
  • To import your schema revisions, run importintegration subcommands for each revision similar to those shown in the following example.

    cqload importintegration -dbset 2003.06.00 admin "" IBM_SR
    Service_Request i 8 "c:\clearquest\schema8.txt" ""

    cqload importintegration -dbset 2003.06.00 admin "" IBM_SR
    Service_Request i 9 "c:\clearquest\schema9.txt" ""

See also

importschema, exportintegration, exportschema,


Feedback