Product(s):	Keynetix
	Version(s):	1.0
	Area:	Assist

How to Export multiple projects to AGS from HoleBASE 3.1 to import to HBSI

Explanation

Build 3.1.426.68 of HoleBASE includes a new feature which will allow users to perform a bulk AGS export, issuing data from multiple projects. Although this is likely to have a general application it is intended to assist users who are seeking to migrate over to HoleBASE SI and require tools to move the data.

Process

To use the feature follow the steps below:

• Login to HoleBASE 3.1 under a 'System Manager' account (if user accounts have been activated) and ensure no projects are open.
• Go to System | Bulk AGS Exporter
• Highlight the projects required for export (click to select, click+Ctrl to add to a selection, click+Shift for a multiple selection). Note the buttons to Select All and Deselect All if required.
• Click the Create AGS Files... and specify the folder within which the exported data will be created.
• HoleBASE 3.1 will now perform the export, creating a seperate file for each project. These will use the PROJ_ID for the file name. A log file is also created which projects from the selection have (and have not) been exported successfully. This file, called Bulk_AGS_Record.Log, can be found alongside the new AGS files.

A summary message is presented on completion reporting the result of the export

Further Information

Note there are occasions when the routine may not be able to complete the export, these being reflect both in the message above and the log file. This is typically the case when changes have been made to the system database which need to be applied to the project in question. As such changes are applied when the project is opened it should be possible to perform the export manually. That is, open the project and perform an individual AGS export in the usual manner.

The AGS Bulk Exporter does include a couple of additional features. The order in which the projects are listed can be adjusted using the Sort Order drop down list. Also, there is a checkbox to Remove Selected Projects after Export. This will remove projects from the list of those available under HoleBASE3.1 once AGS has been exported successfully. This can be useful when encouraging users to use the new HoleBASE SI system and helps to avoid two versions of the data to be maintained (although both systems can be run alongside one another; ensure this checkbox is unticked if this is likely to be the case on an individual project). Note that this option will simply remove the project from the list of those available under HoleBASE 3.1; the project database itself will remain unchanged and can be connected once more under the Project Manager.

This feature has been developed primarily with a view to allow users migrating to HoleBASE SI to transfer their data. As such, certain assumptions have been made about the requirements for the data - the output is similar to an 'archive' export from File | AGS Export. The file produced will be an AGS3.1 file and include all tables and fields from the project, including those which are user defined.