Attention: For this manual procedure, you need to already have
an eXist database server installed. Also, Oxygen XML Author Eclipse plugin has been tested to work with the latest stable
eXist version (version 6). It might work with previous eXist
versions, but they have not been tested and cannot be guaranteed to be compatible.
Tip: There is an easier way to configure an eXist
database connection using a built-in wizard. For more information, see How to Configure an eXist Connection Using the Built-in Wizard.
Step 1: Configure eXist Data Source Drivers
Oxygen XML Author Eclipse plugin supports eXist database server
versions up to and including version 5.0. To configure a data source for an
eXist database, follow these steps:
- Open the Preferences dialog box and go to Data Sources.
- Click the
New
button in the Data Sources panel.
- Enter a unique name for the data source.
- Select eXist from the driver Type drop-down menu.
- Click the Add Files button to add the
eXist driver files. The following driver files should be added
and they are found in the installation directory of the eXist database
server. Make sure you copy the files from the installation of the eXist
server where you want to connect from Oxygen XML Author Eclipse plugin.
- The exist.jar file located in the base directory (if present, depending on the server version).
- All JAR files in the lib/core/ directory (if present) or all JAR files located in the lib directory except for the JAR libraries with the pattern log4j-*.jar, which may interfere with the logging in Oxygen XML Author Eclipse plugin.
- Click the OK button to finish the data source configuration.
Step 2: Configure an eXist Connection
To configure a connection to an eXist database, follow
these steps:
- Open the Preferences dialog box and go to Data Sources.
- Click the New button in the Connections panel.
- Enter a unique name for the connection.
- Select a previously configured eXist data source from the Data Source drop-down menu.
- Enter the connection details:
- Set the URI to the installed eXist engine in the XML DB URI field.
- Set the user name in the User field.
- Set the password in the Password field.
-
Enter the start collection in the Collection field.
eXist organizes all documents in hierarchical collections. Collections are like directories. They are used to group related documents together. This text field allows the user to set the default collection name.
- Click the OK button to finish the connection configuration.
- To view your connection, go to the Data Source Explorer view (if the view is not displayed, it can be opened by selecting it from the menu) or switch to the Database perspective.
Resources
For more information about running XQuery against an eXist XML database, watch our video demonstration: