Configuration Selection

In this dialog you can choose the configuration for i-net Clear Reports. You can create a new configuration or you can use an existing configuration.

A configuration is a container for the properties of i-net Clear Reports.
In versions previous to 8.0 the properties were stored in the file crystalclear.properties. Since version 8.0 all configurations are stored in the operating system's preferences. Their location depends on the operating system. On Microsoft Windows, i-net Clear Reports uses the Windows registry, while on Unix systems the preferences are stored in the file system (/etc/.java, or ~/.java). The reason for this change is to manage the configuration of i-net Clear Reports more easily. Various configurations are stored at an central location. You don't have to manage several crystalclear.properties files any longer.

A new configuration can be created using default values for all properties or using the property values of an existing crystalclear.properties file.
If you update i-net Clear Reports from a version previous to 8.0 and you have modified the property values in the previous version, it can be useful to import the property values from the crystalclear.properties file used with previous version.

To creating a new configuration, it is necessary to specify the scope and the name of the new configuration. Configurations with the scope SYSTEM are available for all user on this system and with the scope USER only for the current user.

In the second step you can choose between 3 options to create a new configuration.

• Default Configuration - creates a new and with default values filled configuration
• Copy of a local Configuration - creates a copy of a available configuration
• Import CrystalClear.properties - imports a CrystalClear.properties file into the configuration

When importing a crystalclear.properties file, its settings are completely copied into the configuration. The DLL-properties, however, must first be converted into data sources in order for them to be used in version 8 and higher. An additional dialog will show the choices for converting these properties and will offer a choice of data source configuration per DLL. If no DLLs are to be imported, the dialog can simply be canceled, otherwise you can skip the DLLs you do not need by choosing "<do not import>". Also, for each data source, an individual scope can be set (System, User), depending on the current read and write permissions. A context menu additionally offers help for the simple choosing of drivers and scopes. Please note that after this conversion of the properties, imported configurations do not contain the DLL properties any more.

If you update i-net Clear Reports from version 8 (or higher) or you install another component (e.g. i-net Designer) on the same machine then it can be useful to use an already existing configuration. In this case just select the configuration to use in the drop down list.

Note: The SYSTEM scope is available only, if the setup is running with a user account that can access it, e.g. if the setup runs as administrator on Windows Vista.

The configuration should be created in the same scope with that i-net Clear Reports will be executed after installation. The USER scope can be used if i-net Clear Reports / i-net Designer will be run with the same user the setup is currently running with. Only the user which has started the setup program has access to this USER scope.
If i-net Clear Reports is running as Windows server or as Servlet in a Servlet engine then SYSTEM scope should be selected because services and application server often running with the SYSTEM account.