<< Click to Display Table of Contents >> RayPack > 7.3 u6 > User Guide > PackDesigner > MSI / MST / RPP Based Projects > Visual Designer Mode > System Interaction > ODBC  Edit an ODBC Item

To edit an ODBC item, users load the list of existing objects by calling the ODBC view within the Visual Designer mode of PackDesigner. Clicking on the list item of the object that has to be edited displays its details in the editor panel on the right hand side of the RayPack application screen.

 

The amount of changeable properties depends on the specific ODBC item type:

 

Edit an ODBC Driver

Name

To edit the driver name, users have to either click on the name or the edit icon displayed at the right-hand side of the current name. A direct inline value editor dialog is displayed. Please refer to the common dialogs section for details on how to handle this type of editor interface.

 

The name has to be given as an alphanumerical string, which may contain the ASCII characters A-Z (a-z), digits (0-9), underscores (_), or periods (.). It must begin with either a letter or an underscore. The name must be unique within the ODBC items of the same type (e. g. there may not be several ODBC driver items with the same name, whilst there may be a translator and a driver item with the same name).

 

Component

Each ODBC driver has to be related to a component. To change the current relation, users may either select another component from the drop-down list, or create a new component with a click on the [...] button at the right-hand side of the current component value. The select a component dialog is displayed in this case. Please refer to the common dialogs section for details on how to handle this type of editor interface.

 

File and Setup File

These two properties are not editable via the interface provided by the Visual Designer. If a driver does not have the right values within these fields, it has to be removed from the packaging project, and added again with the correct properties.

 

 

Parameters

To add a new parameter to the ODBC driver, users have to click on the Add button, which is available within the PARAMETERS tab of the details pane, displayed at the right-hand side of the ODBC dialog as soon as a driver item has been selected from the item list on the left. A new parameter is created, with the default string "attribute" set for the attribute column, and an empty value. Attributes for ODBC drivers are stored within the Installer database table ODBCAttribute.

 

To change either the attribute or the value column content of a specific parameter row, users have to double-click the cell and start to type the new value. Hitting enter saves the new content. As an alternative, it is also possible to click the cell that has to be modified, and hit F2 on the keyboard. The cell is set into direct inline edit mode, ready for user input to replace the existing content.

 

A parameter can be removed by right-clicking the parameter row, and selecting Remove from the context menu.

 

 

Edit an ODBC Data Source

Name

To edit the data source name, users have to either click on the name or the edit icon displayed at the right-hand side of the current name. A direct inline value editor dialog is displayed. Please refer to the common dialogs section for details on how to handle this type of editor interface.

 

The name has to be given as an alphanumerical string, which may contain the ASCII characters A-Z (a-z), digits (0-9), underscores (_), or periods (.). It must begin with either a letter or an underscore. The name must be unique within the ODBC items of the same type. (e. g. there may not be several ODBC data source items with the same name, whilst there may be a translator and a data source item with the same name)

 

Registration Type

Data sources may either be available per-machine, which enables all users with valid credentials for the machine to use it, or per-user, which restricts the usage for any other user than the one the parent package is installed for. The recommended (and default) setting is per-machine.

To change the current setting, users switch the radio selector control to activate the option that has to be set.

 

Component

Each ODBC data source has to be related to a component. To change the current relation, users may either select another component from the drop-down list, or create a new component with a click on the [...] button at the right-hand side of the current component value. The select a component dialog is displayed in this case. Please refer to the common dialogs section for details on how to handle this type of editor interface.

 

Parameters

To add a new parameter to the ODBC data source, users have to click on the Add button, which is available within the PARAMETERS tab of the details pane, displayed at the right-hand side of the ODBC dialog as soon as a data source item has been selected from the item list on the left. A new parameter is created, with the default string "attribute" set for the attribute column, and an empty value. Attributes for ODBC data sources are stored within the Installer database table ODBCSourceAttribute.

 

To change either the attribute or the value column content of a specific parameter row, users have to double-click the cell and start to type the new value. Hitting enter saves the new content. As an alternative, it is also possible to click the cell that has to be modified, and hit F2 on the keyboard. The cell is set into direct inline edit mode, ready for user input to replace the existing content.

 

A parameter can be removed by right-clicking the parameter row, and selecting Remove from the context menu.

 

 

Edit an ODBC Translator

Name

To edit the translator name, users have to either click on the name or the edit icon displayed at the right-hand side of the current name. A direct inline value editor dialog is displayed. Please refer to the common dialogs section for details on how to handle this type of editor interface.

 

The name has to be given as an alphanumerical string, which may contain the ASCII characters A-Z (a-z), digits (0-9), underscores (_), or periods (.). It must begin with either a letter or an underscore. The name must be unique within the ODBC items of the same type. (e. g. there may not be several ODBC translator items with the same name, whilst there may be a translator and a data source item with the same name)

Component

Each ODBC translator has to be related to a component. To change the current relation, users may either select another component from the drop-down list, or create a new component with a click on the [...] button at the right-hand side of the current component value. The select a component dialog is displayed in this case. Please refer to the common dialogs section for details on how to handle this type of editor interface.

File & Setup File

These two properties are not editable via the interface provided by the Visual Designer. If a translator does not have the right values within these fields, it has to be removed from the packaging project, and added again with the correct properties.