ImportToID command (Import/Export tool)

Import a project item or test case to a TestArchitect project location identified by a TestArchitect ID.

Restriction: The Import/Export tool is not available in the TestArchitect packages for the Linux and macOS operating systems.


java -jar TAImportExportTool.jar --ImportToID [--server<value>] [--port<value>] --uid<value> 
--pwd<value> --repoName<value> --projectName<value> --sourceFile<value> --ID<value> 
[--overwrite<true|false>] [--includePictureChecks<yes|no>]
An executable .jar file used to invoke the Import/Export tool.
The file can be found at TA_INSTALL_DIR\binclient.
Invokes the import items function.
(Optional, default = localhost) Full hostname or IP address of the repository server hosting the repository into which the item is to be imported.
Note: If this argument is not defined, localhost is used as the default.
(Optional, default = 53400) Port number of the repository server.
  • If this argument is set to 0 or not defined, the default port number 53400 is used.
  • If port number of the source repository server has been changed from its TestArchitect default of 53400, ensure that the correct port number is specified.
User name with which to log in to repository.
Note: If the user name contains any spaces, enclose it between a pair of double quotation marks.
Password for the given user name.
Name of the target repository.
Note: If the repository name contains any spaces, enclose it between a pair of double quotation marks..
Name of the target TestArchitect project.
Note: If the project name contains any spaces, enclose it between a pair of double quotation marks.
Path to file that is to be imported.
  • Network paths are also supported.
  • If the path contains any spaces, enclose it between a pair of double quotation marks.
ID of the project item root node (Tests, Data, etc.) or folder into which the item is to be imported. In the case of importing test cases, ID must be that of a test module.
To obtain the ID of any TestArchitect entity, find the URL field under its Information tab. The ID is found at the end of the URL address, prefixed with a hyphen ( - ), such as, 1z23htgfc2, below:

(Optional, default = false) Specify whether the existing project item or test case, if any, should be overwritten.
Note: If this parameter is not specified, or its value is empty, its value defaults to false.
(Optional, default = yes; applicable only to import of test module) Specifies whether the regular picture checks belonging to the source test module are to be included.
  • This parameter is only applicable for test modules. If the target item is not a test module, this parameter, if declared, is simply ignored.
  • Only a .zip file containing an exported test module can include that test module's picture checks. Hence a value of yes for this parameter is only effectual when the -sourceFile parameter specifies a .zip file.

Example: Importing test modules including regular picture checks

Ensure that you have installed or upgraded your Java Runtime Environment (JRE) to at least version 8, which is necessary to run TAImportExportTool.jar on your Windows machine.
  • Refer to JRE 8 Installation for Microsoft Windows for details.
  • As an alternative to explicitly installing JDK 8, you may also use the Java Runtime Environment (JRE) packaged with TestArchitect at TA_INSTALL_DIR\jre\bin. In such a case, note that all invocations of the java command will need to specify its filepath (e.g., C:\Program Files\LogiGear\TestArchitect\jre\bin\java). (This latter step can be circumvented by setting the Windows environment variable JAVA_HOME to TA_INSTALL_DIR\jre\bin.)
Let's say you want to import a given test module, Action Based Testing, from a .zip file, with the following information and requirements:
  • Repository server's IP address:
  • Repository server's port number: 53400
  • Target repository name: SampleRepository
  • User name for account in repository: john
  • Password for the account: doe
  • Target project name: Car Rental
  • Include the test module's regular picture checks in the import.
  • File to import: D:\exported items\Action Based
    Note: While test modules can be exported to & imported from .csv, .html and .zip files, only .zip files can hold regular picture checks from the source test module.
  • ID of destination test folder in project: 1z23htgfc2

  • Overwrite the existing Action Based Testing test module, if any.

To run the ImportToID command, do the following:

  1. Bring up a command window. You can do this from the Windows Start menu by choosing Run, and then entering cmd. The command window opens with a prompt displaying your current directory.
  2. Use the cd command to change your current directory to TA_INSTALL_DIR\binclient\, which is where TAImportExportTool.jar is located. For example, type the following command at the prompt, and then press Enter.
    cd "C:\Program Files\LogiGear\TestArchitect\binclient"
    Now the prompt should change to the new directory, e.g., C:\Program Files\LogiGear\TestArchitect\binclient>
  3. Enter the following command, and then press Enter.
    java -jar TAImportExportTool.jar --ImportToID --server --port 53400 --uid john 
    --pwd doe --repoName SampleRepository --projectName "Car Rental" 
    --sourceFile "D:\exported items\Action Based" 
    --ID 1z23htgfc2 --overwrite true --includePictureChecks yes