ImportRepository command (Import/Export tool)

Import a repository from a .dat file.

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

Synopsis

java -jar TAImportExportTool.jar --ImportRepository [--server<value>] [--port<value>] 
[--repoName<value>] --filePath<value> [--overwrite<true|false>]
TAImportExportTool.jar
An executable .jar file used to invoke the Import/Export tool.
The file can be found at TA_INSTALL_DIR\binclient.
--ImportRepository
Invokes the import repository function.
--server<value>
(Optional, default = localhost) Full hostname or IP address of the repository server in which the repository is to reside.
Note: If this argument is not defined, localhost is used as the default.
--port<value>
(Optional, default = 53404) Dedicated port number used to connect to the repository server.
Note: At present, only the port number 53404 may be used, and serves as the default value. Hence, please ensure that this port is always available.
--repoName<value>
(Optional) Name to be assigned to the imported repository.
Note:
  • If the repository name contains any spaces, enclose it between a pair of double quotation marks..
  • If this parameter is not defined, the name of the source repository used to generate the file during export is used as the default.
  • Extended ASCII characters are not allowed in naming.
--filePath<value>

Import file containing a previously exported repository.

Note:
  • The import file must have a .dat extension.
  • Network paths are also supported.
  • If the path contains any spaces, enclose it between a pair of double quotation marks.
--overwrite<true|false>
(Optional, default = false) Specify whether the existing repository, if any, should be overwritten.
Note: If this parameter is not specified, or its value is empty, its value defaults to false.
CAUTION:
Since overwriting a repository will cause you to lose the data in the existing repository, please inform your team members to ensure that no project modifications are made during the repository import process.

Running ImportRepository command (Import/Export tool)

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.
Tip:
  • 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.)

To run the ImportRepository 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 --ImportRepository --server 192.168.167.60 --port 53404 
    --repoName ScrumBoard --filePath "D:\repository list\MySampleRepository.dat" --overwrite true