Updating Your Workspace

Due to incompatibilities between Eclipse and earlier versions of the Jaspersoft Studio workspace, the workspace format was updated. The current workspace format can't be used with older versions of Jaspersoft Studio.

If you are not prompted to update your workspace, you do not need to.

If you are updating from an old version of Jaspersoft Studio, you are prompted to choose a new workspace when you launch Jaspersoft Studio. When you choose a new workspace, a new, empty workspace is created and set as the workspace for your Jaspersoft Studio instance. This workspace will be used for newer versions. Your previous workspace remains unchanged and can still be used with older versions.

To update the reports and data from your earlier version of Jaspersoft Studio, you can import some or all of your projects, server connections, data adapters, and project settings into your new workspace.

Importing projects:

1. (Optional) To import a version of the MyReports project, you must first delete the existing MyReports folder from your current workspace. You can do this, for example, if you have just upgraded and have created a new empty workspace. To delete MyReports in your current workspace, navigate to the workspace location in your file system and delete or move the MyReports directory.
2. Select File > Import ...
3. Select Existing Projects into Workspace from the General category.

Selecting projects in Import dialog

4. Browse to the workspace which you want, click OK, and then click Next.

The Import dialog opens.

Import Projects dialog

5. To work on a copy without modifying the originals, select Copy projects into workspace.
6. Click Finish.

The projects you selected are imported into your current workspace.

Your workspace contains server connections, global data adapters, and your Jaspersoft Studio preferences in addition to your projects. You must import each type separately.

Importing server connections:

1. Select File > Import ....
2. Select External JasperReports Server Connections from the Jaspersoft Studio category.
3. Browse to the workspace which you want, click OK, and then click Next.

The Select the Server Connections dialog opens.

Select the Server Connections dialog

4. Choose the connections you want.
5. Click Finish to import the connections.

The selected server connections are imported into your Jaspersoft Studio instance.

Importing data adapters and settings:

1. Select File > Import ....
2. Select External Properties and Data Adapters from the Jaspersoft Studio category.
3. Browse to the workspace which you want, click OK, and then click Next.

The Select the Data Adapters dialog opens.

Select the Data Adapters dialog

4. Choose the data adapters you want. You do not need to import the built-in adapters (One Empty Record and Sample DB).
5. Click Next.

Select the properties dialog

6. Choose the properties you want and click Finish.

The selected data adapters and properties are imported into your Jaspersoft Studio instance.