xml editor

    XML Editor
    XML Author
        DITA Editor
        DocBook Editor
        TEI Editor
        XHTML Editor
        XML Schema Editor
        RelaxNG Editor
    XML Diff
    XSL / XSLT
        XSL / XSLT Editor
        XSL / XSLT Debugger
        XSLT documentation
    XQuery
        XQuery Editor
        XQuery Debugger
    SVN Client
        Office Open XML
        Open Document Format
        XSL:FO Editor
        SVG Editor
        WSDL Editor
Supported platforms
Compatible with Windows7 & Mac OS X Snow Leopard
Ready for
data server software

MarkLogic support

Introduction

This tutorial shows you, step by step, how to configure the MarkLogic support in <oXygen/> XML Editor, browse and edit resources through WebDAV, as well as running XQuery interrogations.

An XDBC application server must be running in order to be able to connect to the MarkLogic server using <oXygen/>. More information about how to configure an XDBC server can be found in MarkLogic documentation: http://xqzone.marklogic.com/pubs/3.2/books/admin.pdf. Oxygen uses XCC connector to interact with MarkLogic XDBC server and requires the basic authentication schema to be set. Starting with version MarkLogic 4.0 the default authentication method when you create a HTTP or WebDAV Server is digest, so make sure to change it to basic.

The tutorial assumes that you have a basic knowledge of databases, XML technologies and of <oXygen/> XML Editor tool. The explanations and screen shots are given for the standalone version of the <oXygen/> XML Editor. However the same set of features are available in Eclipse plugin version of the product with minor interface differences.

How to Configure the MarkLogic Support in <oXygen/>

There are two notions you need to understand in order to configure the MarkLogic support in <oXygen/>: the data source and the connection.

A data source defines all that is needed in order to have a connection to the database. <oXygen/> currently supports MarkLogic version 3.0 or higher. Debugging is available only starting with MarkLogic 3.2 or higher.

Go to <oXygen/>'s Preferences->Data Sources and press the New button in order to add a new data source. Insert a data source name (make sure that each data source has an unique name) and select the MarkLogic type from driver type combo box.

MarkLogic Data Source Configuration Dialog

You also need to add the following MarkLogic specific driver file:

  • xcc.jar

In order to get these driver files download Java and .NET XCC distributions (XCC Connectivity Packages) from http://xqzone.marklogic.com/download/binaries/3.1/MarkXCC.Java-3.1-5.zip available on the page http://xqzone.marklogic.com/download/.

More information about configuring a MarkLogic datasource can be found in the user manual: http://www.oxygenxml.com/doc/ug-oxygen/native-xml-database-support.html

Once you have created the data source you may proceed further by defining one or more connection based on it. The connections can be configured on the same Preferences->Data Source page.

MarkLogic Connection Configuration Dialog

Start by choosing a unique connection name and set the Data Source combo box to the already configured MarkLogic data source. In the Host field specify the name or IP address of the XDBC server.

In the WebDAV URL field you can specify an URL pointing to a MarkLogic WebDAV server. More information about how to configure a WebDAV Server for MarkLogic can be found here: http://xqzone.marklogic.com/pubs/3.2/books/admin.pdf. This URL will be used for browsing and editing resource. The WebDAV url has the following structure: http://<host>:<port>.

Sometimes you need to work with two database servers (for example a development sever and a production server) so it makes sense to define a connection on each database server to be further used when executing XQuery or browsing/editing the database resources. If the two database servers have the same version you only need to configure a data source and add two connections for it.

Datasource Explorer View

Once we finished the configuration of the connection (and have specified a WebDAV URL) we are able to browse the database content using the Datasource Explorer view from the Database perspective.

Database Perspective

XQuery Support

MarkLogic supports XQuery interrogations over the stored XML content. For example if you like to create a XQuery to generate a report with the billing contact data from the latest purchase notifications. You can open an XQuery editor (New->XQuery), configure the transformation scenario to match the MarkLogic connection for the transformer field, write the XQuery and then execute it.

MarkLogic XQuery Support

XQuery Debugger Support

<oXygen/> XML Editor brought the first XQuery debugger against a native XML database allowing users of the MarkLogic 3.2 (or higher) database to debug their XQuery code based on the new MarkLogic Server 3.2 (or higher) XQuery debugging API.

When entering in the XQuery Debugging mode <oXygen/> provides a special layout that display the XML source (optional) and the XQuery documents side by side. It can also show the debugging output and specific XQuery debugging views and toolbars that allow you to set breakpoints, inspect variable bindings, evaluate expressions in the request context.

MarkLogic XQuery Debugger

More details about the <oXygen/> Xquery Debugger can be found here: http://www.oxygenxml.com/xquery_debugger.html

News
Upcoming Events:
Buy <oXygen/> License
XML Editor
Enterprise $449
Professional $349
Academic & SMP $64
XML Author
Enterprise $269
Professional $199
XML Diff
Professional $99  $59
Most Wanted Features
Cast your vote now! What feature would you need the most in the next version?
<oXygen/> XML Editor
Video Demonstrations
Support Life Program
Syncro SVN Client
Quotes
quote ..oXygen XML Editor still hits a sweet spot -- but a wider one than ever. The feature set, performance and interfaces get better with every release, while its core virtues remain, including the portability across platforms and the enlightened licensing (to users, not machines). Bravo for creating a product that needs no apology. quote
Wendell Piez
Mulberry Technologies Inc
XML Editor | XML Author | WYSIWYG Editors | Schema Editor | XSD Documentation | XSL/XSLT Editor | XQuery | XML Databases | SVN Client
© 2002-2010 SyncRO Soft Ltd. All rights reserved. | Sitemap | Privacy Policy | This website was created & generated with <oXygen/>® XML Editor