18.1 Converting Earlier Projects

Previous Designer workspaces are not compatible with Designer 3.5 and later. Designer stores projects and configuration information in a workspace. These workspaces are not compatible from one version of Designer to another. You need to point Designer 3.5 to a new workspace, and not to a workspace used by a previous version of Designer.

18.1.1 Converting Projects from Designer 3.5 to Designer 4.0.1

Designer 4.0.1 supports conversion of Designer 3.5 and 4.0 projects to Designer 4.0.1. You can import the Designer 3.5 projects into Designer 4.0.1 from the file system or from the version control system. The conversion from Designer 3.5 to Designer 4.0.1 supports the objects that are newly added to Designer 4.0.1.

18.1.2 Converting Projects with the Project Converter Wizard

To convert an earlier project:

  1. To convert projects that were not open in an editor when Designer was closed, open the project by doing one of the following:

    • Double-click the project in the Project view.

    • Right-click the project in the Project view, then select Open.

    Although you can open a project in the Navigator view by clicking the project’s .proj file, Novell recommends that you use the Project view instead. Otherwise, the Navigator view takes you into the raw file system.

  2. In the Project view, expand the project, then double-click Project needs conversion.

  3. Designer opens the project in the Project Converter Wizard. Review the steps, then click Next.

  4. Name the project, then click Next.

    The Project Converter backs up your project before converting. You can accept or change the default name.

  5. (Optional) If you edited the name but want to return to the default, click Reset.

  6. Convert the project by clicking Convert.

    The converter changes, adds, and removes references, attributes, and elements. It might also create new files or delete old ones. It converts the project file to the new, correct file format. A progress bar displays during the backup and conversion. Converting very large projects might take a few seconds.

  7. View the conversion log by clicking View Log.

    The conversion.log file is in the project folder in the Workspace directory (for example, c:\documents and settings\skopai\digitalairlines\conversion.log).

  8. Open the project.

    Regardless of the internal format (for example, Designer 1.2 or Designer 3.5 or Designer 4.0.1), Designer always deploys to the proper format of the target Identity Manager environment.

    The converter ensures only forward compatibility. It is not backward compatible. A project that is converted to a newer release of Designer cannot be converted to an older release. In order to return to an earlier format, use the backup file of your project.

18.1.3 Running Later Projects on Earlier Designer Versions

Designer 2.0 or later (including Designer 3.5) does not let you load a project created in later Designer versions if the file format has changed between versions.

For example, Designer 2.0 and Designer 3.0 use different formats. If you create a project in 3.5, you cannot open that project in 2.0. Instead, a message informs you that you can’t open the project because it requires the later version of Designer.

Even if the version formats are the same, it isn’t a good practice to run later projects on earlier versions of Designer. Later versions of Designer have additional bug fixes and features that might make more use of the existing format. Therefore, going back to an earlier Designer version could result in an inferior experience.