Importing a Project

Owned by Tino Pförtner
Last updated: Aug 09, 2024
4 min read

Projects can be imported in either of two formats:

  • As a .zip file, which will be added to your repository.

  • As an import from your repository into your workspace, making the project available to you locally.

The method described in this tutorial is also relevant in the context of migration from SOX 3.x to 4.x. In order to reuse “legacy” projects created with SOX 3.x, it is necessary to first export them and then bring them into SOX v 4.x going through the steps explained below.

Please refer to new Exporting a ProjectUNDEFINED for a tutorial on project exports.

Importing an Archived Project

  1. Right-click inside the Repository view. From the context menu, select the Import item.

  2. On the dialog thus opened, click the > to expand the SOX directory. Next, select Import SOX Project.

  3. Click Next. - Outcome: the Project Import dialog will open.

  4. Click on the topmost Browse… button to identify your source file. - Outcome: a file (Windows) explorer dialog will open. Navigate to the location of a compressed SOX project, i.e., a suitable .zip file. Our scenario uses the project highlighted below. Click on Open to register your selection as your source.

  5. Click on the second Browse… button to define your target folder. - Outcome: SOX will open the Select folder dialog.

  6. The selection defaults to your “Projects” root directory. It is also possible to select any previously created subfolder, or to create one using the “plus” icon. Our example assumes the “Projects” selection.

  7. Confirm your selection with OK. Back on the main dialog, verify your choices and click Next.

  8. Outcome: SOX will display the Import Summary dialog.

  9. It is possible at this point to complete the process by clicking on Finish. If you choose Next instead, as the above dialog announces SOX will offer to adjust the catalogs configuration for your project.

  10. As indicated in the dialog, the “Create” option may be available depending on the catalogs used by your project. “Assign” is the default action for a system catalog and cannot be edited. Make the appropriate choices and click on Finish.

  11. Outcome: SOX will open the Open diagrams/documents dialog:

  12. After expanding, individual or collective choices as to the diagrams/documents you wish to open are possible:

  13. Click Open selected to confirm. - Outcome: SOX will open and display your project as per your selections.

Importing a SOX Repository Project

  1. Right-click inside the Repository view. From the context menu, select the Import menu.

  2. On the dialog thus opened, click the > to expand the directory. Next, select Import SOX Repository Project.

  3. Click Next.

  4. On the following dialog, click the > to expand the Projects directory. Next, select the desired project to be imported - in our example scenario, “Automatischer Heckspoiler”.

  5. Click Finish.

  6. Outcome: SOX will offer to open the diagrams and/or documents such as exist in the selected project. For convenience’s sake, we elect to have the software open all of them.

  7. Click Open selected.

Outcome: Your project was imported.