|
<< Click to Display Table of Contents >> RayPack > 7.3 u6 > User Guide > PackDesigner > MSI / MST / RPP Based Projects > Visual Designer Mode > System Interaction > ODBC Add an ODBC Driver |
In order to add an ODBC driver to a packaging project, users go to the ODBC view of the Visual Designer mode.
With a click on the Create new... button, an option menu is displayed. Select Driver to launch the required wizard interface.
Work your way through the steps of the wizard to define all required properties for the new item.
At any time, using the Next or Back buttons, which are displayed at the bottom of the wizard dialog, allows to navigate within the already processed steps.
To exit the wizard without creating a new object, use the Cancel button, also located at the bottom of the wizard dialog.
Select the type of the new driver object:
•Custom drivers have to be defined by providing the DLL with the driver logic. It is the recommended choice for quite special ODBC driver requirements.
•Predefined drivers are offered for integration into the packaging project from a list of drivers which are available on the current packaging machine. It is the recommended choice for common driver addition.
Click on the tile that represents the driver type which has to be added to the packaging project, and click Next to proceed.
When a new ODBC driver is added to a packaging project, the DLL resource has to be added to a specific component. RayPack usually creates a new component for the driver resources, as indicated by the default activation for the "Automatically create a new component" radio selector option. However, by selecting the other option "Select existing component", a drop-down menu with available components becomes visible. Select one of them, or manually define the properties of a new component if required.
ODBC Driver name
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)
ODBC Driver file
The DLL with the driver logic. It will be added to the objects stored within the packaging projects File table, and referenced in the ODBCDriver table via its identifier.
ODBC Driver setup file
The DLL with the logic required to install the driver. It will be added to the objects stored within the packaging projects File table, and referenced in the ODBCDriver table via its identifier. The setup file is optional, and only required if additional driver installation logic is needed to actually use the driver on the later target machines.
Driver
Select one of the drivers from the predefined list. The required resources will automatically be derived from the local machine and added to the packaging project.
If the required driver is not part of the list, use the Back button, select the type Custom driver, and upload the driver resources manually in the following wizard step.
Please keep in mind that the driver architecture must match the target machine architecture. Therefore, select the driver with the matching property ("x86" or "x64") displayed within the labels of the driver option list.
Use the summary page to check the correctness of the driver properties that were defined during the previous wizard steps.
•If all properties are set as required, click Process to finally create the ODBC item.
•If changes are due, click Back until the wizard step with the incorrect property definition(s) is displayed and make modifications as required.
Please note that changes in an early step may lead to different defaults or options in any later step. Therefore, please verify that all steps contain the desired settings whilst NEXTing to the summary page again.
Once the new ODBC driver has been created, the wizard can be closed by using the Finish button at its lower right corner. The ODBC view is updated, and the list of existing items contains the newly created object at the lowest position.