ODWEK – Cómo conectar a Content Manager OnDemand

En primer lugar hay que instalar OnDemand Web Enablement Kit (ODWEK) en la maquina desde la que queramos establecer la conexión con OnDemand.

En nuestro caso concreto vamos a establecer la conexión desde una maquina con Windows, por eso se ha utilizado el paquete IBM Content Manager OnDemand Web Enablement Kit. V9.0 (con código de producto CIV7ML). La instalación de ODWEK no presenta ningún problema, simplemente hay que ejecutar el instalador odwekwin.exe, seleccionar la ruta en la que se hará la instalación y pulsar el botón: “Siguiente”.

La instalación se ha realizado en la siguiente ruta: E:\IBM el instalador de ODWEK creará una serie de carpetas y subcarpetas, finalmente cuando termine la instalación se habrá creado la siguiente carpeta: E:\IBM\OnDemand Web Enablement Kit\V9.0 Dentro de ella estarán las DLLs y los ficheros JAR necesarios para poder utilizar ODWEK.

Antes de poder crear el programa de ejemplo en Java habrá que configurar la variable de entorno PATH para que se puedan localizar las DLL necesarias. En nuestro caso, el sistema operativo es de 64 bits, pero tanto la JRE como el JDK que se están utilizando son de 32bits. Esto es importante por lo que vamos a comentar ahora en relación con la variable de entorno PATH.

Hay que añadir al PATH dos rutas:

– Una será la carpeta de instalación de ODWEK (en nuestro caso E:\IBM\OnDemand Web Enablement Kit\V9.0)
– La otra será la carpeta lib32 o lib64 en función de si estamos usando una versión de Java de 32 o 64 bits, en nuestro caso se ha añadido al PATH la siguiente ruta: E:\IBM\OnDemand Web Enablement Kit\V9.0\lib32

Después de esto ya será posible establecer la conexión a ondemand mediante ODWEK, para ello se creará un pequeño programa Java que hará uso de las librerias de ODWEK. Habrá que usar el JAR ODApi.jar que en nuestro caso estará situado en la siguiente ruta: E:\IBM\OnDemand Web Enablement Kit\V9.0\api En esa carpeta también hay un fichero llamado ODApiDoc.zip que contiene la documentación de la API ODWEK en formato JavaDoc.

Código de ejemplo para establecer conexión mediante ODWEK

A continuación el código del programa usado para establecer la conexión con ondemand:

import java.util.Enumeration;

import com.ibm.edms.od.ODConfig;
import com.ibm.edms.od.ODServer;

public class ConnectOD {
	public static void main(String[] args) {
		try {
			connect();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	public static void connect() {
		ODConfig odConfig = new ODConfig();
		ODServer odServer;

        if(odConfig == null)
            return;
        else
        {
        	try {
        		odServer = new ODServer( odConfig );
        		odServer.initialize( "ConnectOD" );	// Necesario un nombre para inicializar la conexion
            	System.out.println( "Logging on to SERVER.OD.LOCAL ..." );
            	odServer.setPort(1915);									// Puerto del servidor
            	odServer.logon( "SERVER.OD.LOCAL", "admin", "passwd" );	// Nombre del servidor y credenciales

				// Se obtiene la lista de Folders y se muestra en pantalla
            	Enumeration<String> enu = odServer.getFolderNames();
            	while (enu.hasMoreElements()){
            	    System.out.println(enu.nextElement());
            	}

                // Desconexion
                //------------
                System.out.println( "Logging off..." );
    			odServer.logoff( );
                odServer.terminate( );
                System.out.println( "" );
                System.out.println( "---------------------------------------------------" );
        	} catch (Exception e) {
        		System.out.println(e.getMessage());
        		e.printStackTrace();
        	}
        }
	}
}

Simplemente se trata de un programa que establece la conexión con el servidor de ondemand, obtiene la lista de carpetas y las muestra por consola.

Una vez establecida la conexión con el servidor de ondemand a través de ODWEK lo siguiente será ver cómo utilizar la API para poder realizar consultas y recuperar documentos.