Once you are on the Import and Export page in the Administration section, ensure that the Import tab is selected to start the Import Wizard. Click Browse to select a file to upload, then click the Upload button to send the file to the server for processing.
The main details about the imported file will be displayed and you will be provided with options allowing you to either Import to a new project, Import to any existing project or, if matching project is found, Import to a matching project.
If a matching project is found on the server, you can choose to overwrite the project. You can optionally choose to Overwrite the project name and provide a New Project Name for the matching project**.** If project details exist in the imported file, then you can optionally Overwrite project details in the matching project. Likewise, if project permissions exist in the imported project, you can optionally Overwrite project permissions in the matching project. In later steps, you will also have the option to overwrite configurations in the matching project, if configuration permissions exist and you choose Overwrite configuration permissions here, then the permissions will be overwritten in all selected configurations.
Note when importing over existing items, that the changes that are made can not be undone. It is advisable to take a full database backup first.
You can choose to import the project as a new project and give in a New Project Name and New Project Slug. All project details, permissions and configurations will be imported to this new project.
You can choose to select an existing project to overwrite. If project details exist in the imported file, then the existing project details will be replaced with these details. You can optionally choose to Overwrite the project name and provide a New Project Name for the existing project**.** In later steps, you will also have the option to overwrite configurations in the existing project.
You can choose to select an existing project to overwrite. You can optionally choose to Overwrite the project name and provide a New Project Name for the existing project**.** If project details exist in the imported file, then you can optionally Overwrite project details in the existing project. Likewise, if project permissions exist in the imported project, you can optionally Overwrite project permissions in the existing project. In later steps, you will also have the option to overwrite configurations in the existing project, if configuration permissions exist and you choose Overwrite configuration permissions here, then the permissions will be overwritten in all selected configurations.
Note when importing over existing items, that the changes that are made can not be undone. It is advisable to take a full database backup first.
Once you have chosen the relevant Project options, click Next to move to the Configurations step.
The Configurations step of the Import wizard shows a list of all the configurations in the imported document. Check boxes are provided allowing you to choose which configurations to import.
If importing to a new or empty project, or if no match is found for a configuration, a icon is displayed, indicating the configuration is new. You can optionally give the new configuration a new name by clicking on the Rename button. A New Name text box is shown allowing you to enter the new name.
If importing to an existing project and a match is found for a configuration, a icon is displayed, indicating the configuration exists. You can choose to:
Once you have chosen the required Configurations and related options, click Next to move to the Repositories step. Alternatively, click Back to return to the File & Project Details step.
The Repositories step of the Import wizard shows a list of all the repositories in the imported document. Check boxes are provided allowing you to choose which repositories to import.
If an existing matching repository is not found a icon is displayed and, if the repository is selected, it will be created as a new repository. You can optionally edit the Name and change the Scope for the new repository to Global, Project or Configuration. Note that Configuration scope is only available if you are importing a single configuration.
If an existing matching repository is found a icon is displayed. You can choose to:
Once you have chosen the required Repositories and related options, click Next to move to the Variables step. Alternatively, click Back to return to the Configurations step.
The Variables step of the Import wizard shows a list of all the variables in the imported document. Check boxes are provided allowing you to choose which variables to import.
If an existing matching variable is not found a icon is displayed and, if the variable is selected, it will be created as a new variable. You can optionally edit the Name and change the Scope for the new variable to Application, Project or Configuration. Note that Configuration scope is only available if you are importing a single configuration.
If an existing matching variable is found a icon is displayed. You can choose to:
Once you have chosen the required Variables and related options, click Next to move to the Shared Resources step. Alternatively, click Back to return to the Repositories step.
The Issue Connectors step of the Import wizard shows a list of all the issue connectors in the imported document. Check boxes are provided allowing you to choose which issue connectors to import.
If an existing matching issue connector is not found a icon is displayed and, if the issue connector is selected, it will be created as a new shared resource. You can optionally edit the Name for the new issue connector.
If an existing matching issue connector is found a icon is displayed. You can choose to:
Once you have chosen the required Issue Connectors and related options, click Next to move to the Options step. Alternatively, click Back to return to the Shared Resources step.
This step of the Import wizard allows you to choose options related to the import process.
If the imported file contains invalid content for any of the fields, then a validation error may occur and will be displayed in the import log. Here you can choose whether the import process should continue or abort.
Abort immediately: If a validation error occurs, the import process will be aborted, no items will be imported, no changes will be committed to the database.
Skip item and continue, but abort before committing: This is the default option. If it is possible to continue, then the invalid item will be skipped and a warning will be displayed in the import log. The import process will continue to import the next item. At the end of the import process, changes will not, however, be committed to the database. If there are multiple validation issues, then this option will allow you to see all of them at once.
Skip item and continue: If it is possible to continue, then the invalid item will be skipped and a warning will be displayed in the import log. The import process will continue to import the next item. At the end of the import process, changes will be committed to the database.
If the imported file contains encrypted passwords and other sensitive values, then you can choose whether to import them.
If you are import a file exported on a different server, the encryption keys will be different. In this case, input boxes will be provided to allow you to enter the encryption parameters.
The encryption Key and Vector can be found in the appSettings section of server configuration file under the keys "Continua.SymmetricEncryptionKey" and "Continua.SymmetricEncryptionVector".
e.g.
<appSettings>
<!-- DO NOT remove or change the keys BELOW -->
<!-- They are set during the first installation, changing them will require you to re-enter all passwords fields -->
<!-- We recommend that you keep a backup of these values -->
<add key="Continua.HashSalt" value="**************"/>
<add key="Continua.SymmetricEncryptionKey" value="**************" />
<add key="Continua.SymmetricEncryptionVector" value="**************" />
<!-- DO NOT remove these the keys ABOVE -->
.....
</appSettings>
Once you have entered the required details, click Run Import to start the import process.
While the import is running, progress messages are displayed.
If the import fails validation, a red Import failed! message and a Retry Import button is displayed. All changes are rolled back leaving the server database as it was before the import was started.
If the import is successful, a green Import complete message and an Import Another File button is displayed.