Export / Import BS2000 Remote Build Projects

For saving, sharing, copying and even for troubleshooting it is useful to export and import a complete BS2000 Remote Build Project. This is done in BS2IDE as follows:

Export of a BS2000 Remote Build Project

An entire BS2000 Remote Build Project will be exported as a ZIP archive file that contains all global BS2IDE resources that are used and referenced by the BS2000 project.

This includes:

BS2000 connections
Placeholder sets
Commands (compile commands and call procedure commands)
Remote build rules
Launch configurations (run and debug)
The project and its files and folders
Contents of local files

To export a BS2000 Remote Build Project click

File > Export... , choose BS2000 – Export Remote BS2000 Project and click Next.
On the next wizard page specify the remote BS2000 project that shall be exported. If the project that is currently selected in the Project Explorer is a BS2000 project, this project will be displayed as pre-selection. Use the Browse... button to select the project to be exported or type the name of the project into the text field.

The text field ZIP archive file contains the default path and name of the archive file where the exported project shall be written to. Use the Browse... button or the text field to choose another file path and name. If the selected archive file already exists, you need to activate the option Overwrite existing ZIP archive file in order to proceed.

Press the Finish button to export the project into the specified ZIP archive file.

Import of a BS2000 Remote Build Project

To import a BS2000 Remote Build Project click

File > Import... , choose BS2000 – Import Remote BS2000 Project and click Next.
The next wizard pages are:

Wizard Page BS2000 Project ZIP Archive File

Select the ZIP archive file that contains a previously exported remote BS2000 project that shall be imported using the Browse... button or the ZIP archive file text field.

Wizard Page Export Source Info

This page contains information about the source of the exported project such as the export date, the name of the source host and the exporting user, the original project name.

Wizard Page Import Options

This page contains some options that control the import process. The options are:

Use suitable existing resources
If this option is activated (which is the default), BS2IDE tries to use existing global resources that have the same properties than the resources to be imported (e.g. a placeholder set that has exactly the same placeholders but may have another name).
If the option is not activated, new global resources will be created for the imported project even if there are suitable resources available. This does not apply to existing BS2000 connections to the same host and user-ID, which will always be used if available.
Name prefix for imported resources
May contain a name prefix for the names of global resources that will be created during the import process. The default is no name prefix.
Resource name suffix pattern to resolve name conflicts
BS2IDE uses this pattern as a suffix for the names of global resources in case of name conflicts. A name conflict may occur if a global resource with the same name than the resource to be imported already exists, but the existing resource cannot be used because it has different properties or the option Use suitable existing resources is not activated. The pattern must contain exactly one number sign (‘#’). BS2IDE substitutes this number sign with a number starting with 1 until the name conflict can be resolved.
The default pattern is ‘ (#)’.

Wizard Page Global Resources

This page contains an overview of all global resources that are contained in the project to be imported. This includes the original names and possibly new names of the resources, the information if an existing resource will be used or a new resource will be created and the »usage« of the resources (i.e. which other resources reference a resource and for what reason).

The top-level items are the global resource types, which are:

Project
Connections
Placeholder Sets
Call Procedure Commands
Compile Commands
Remote Build Rules
Launch Configurations

The next tree level contains the global resources to be imported. If the resource will get a new name, this new name is displayed as well. The symbols of the global resources have the following meanings:

The resource will be created with its original name

The resource will be created with a different name.

A suitable existing resource will be used. It has the same name as the original name of the resource to be imported.

A suitable existing resource will be used. It has another name than the original name of the resource to be imported but the same properties.

This symbol only applies to connections. A connection has a context menu that contains the menu option Select Connection. This menu option can be used to substitute the connection with another, already existing BS2000 connection. This symbol will be displayed if a different connection has been selected.

Expand a global resource tree item to get information about the usage of the resource. All other resources that reference this resource are listed. In addition to that, the reference reason is given.

Wizard Page Files and Folders

This page contains an overview about all folders and files that are about to be imported.

The folder and file symbols may have the following overlay images:

This file or folder is a direct link to a remote BS2000 file.

This file or folder is an indirect link to a remote BS2000 file (i.e. one of its ancestors is directly linked to a remote BS2000 file).

This file or folder is a direct link to a non-BS2000 file.

This file or folder is an indirect link to a non-BS2000 file.

This file or folder has a delegate property that will be imported as well.

The content of this (local) file is available and will be imported.

Press the Finish button of the import wizard to start the import process with the specified options.

	The resource will be created with its original name
	The resource will be created with a different name.
	A suitable existing resource will be used. It has the same name as the original name of the resource to be imported.
	A suitable existing resource will be used. It has another name than the original name of the resource to be imported but the same properties.
	This symbol only applies to connections. A connection has a context menu that contains the menu option Select Connection. This menu option can be used to substitute the connection with another, already existing BS2000 connection. This symbol will be displayed if a different connection has been selected.

	This file or folder is a direct link to a remote BS2000 file.
	This file or folder is an indirect link to a remote BS2000 file (i.e. one of its ancestors is directly linked to a remote BS2000 file).
	This file or folder is a direct link to a non-BS2000 file.
	This file or folder is an indirect link to a non-BS2000 file.
	This file or folder has a delegate property that will be imported as well.
	The content of this (local) file is available and will be imported.