Key

If you're using ODA from XPages, follow these steps (updated as of version 34.10.0).

Prerequisites

Domino Designer and Domino Server 9.0.1 minimum.

XPages Extension Library 9.0.1_v00_17 minimum.

Info

title

Check Version

With the release of Feature Packs (starting FP8), core Domino Java APIs may changechanged. As a result, ODA will need to cut off support for earlier feature packs. 3.x is designed for Domino 9.0.1 versions up to FP7. ODA 4.x is designed for Domino 9.0.1 FP8. Please check release notes, this wiki and OpenNTF project.

3.x Prerequisites

Domino Designer and Domino Server 9.0.1 minimum.

XPages Extension Library 9.0.1_v00_17 minimum.

4.x Prerequisites

Domino Designer and Domino Server 9.0.1 FP8 minimum.

Step-by-step guide

Download ODA from OpenNTF (not nonxsp release).

Install the plugin on the server (follow steps for XPages Extension Library).

See the demo database for up-to-date details of the flags available. As of 3.1.0 the flags are:

godmode - Overrides the XPages session and database objects, converting the lotus.domino objects to their org.openntf.domino counterparts. If the switch is not enabled, the org.openntf.domino counterparts are loaded in addition to the lotus.domino objects, as opensession and opendatabase

khan - Turns on all "improvements" like forcing setAutoUpdate(false) for all view actions.

marcel - Auto-handles converting session to handle MIME where appropriate.The core API does not enforce setting Session.setConvertMIME() when handling MIME items and unsetting it once complete, but failing to do so can cause problems, e.g. accessing two different MIME items at once can cause a JRE and server crash.

automimenone - Does not automatic conversion of Items to MIME. By default, if 32k limit on a field is hit or any other exception is hit, the Item will be converted to MIME.

automime32k - Only does automatic conversion of Items to MIME if 32k limit is hit. By default, if 32k limit on a field is hit or any other exception is hit, the Item will be converted to MIME.

Godmode is recommended for new applications. It should not have negative impacts for existing applications, as long as all recycle() calls are removed, but testing is strongly recommended. Khan is strongly recommended.