Programando DFC para integrar aplicaciones con Documentum

Las DFC’s son librerias basadas en Java, su API esta basada en interfaces públicas, las cuales sirven para ser usadas para desarrollar contra Documentum. Estas librerias se utilizan a través de las factorias que provee el API.

Se pueden utilizar para:

• Acceder a la funcionalidad de Documentum desde una aplicación personalizada.


• Personalizar o extender los productos como Documentum Desktop o WebTop


• Escribir un método o procedimiento que se ejecute como parte de un workflow dentro del servidor de contenido.


• Pueden estar ubicadas donde esta el servidor de contenidos, un sistema de capa intermedia, una aplicación de usuario final.

La interterfaz equivalente para entornos .NET se denomina PIA (Primary Interop Assembly).

Enlaces relacionados:

http://developer.emc.com/developer/downloads/dfcoverview.pdf

Tips for Developing WDK/Webtop-based Benchmarks

- FIN -

Tipos documentales de Documentum

Por cada fichero que se suba al servidor de Documentum mediante las DFC, se ha de especificar su tipo asociado, el listado de tipos se encuentra dentro de la base de datos del servidor.



Para obtener el listado de documentos soportados por este podemos hacerlo ejecutando una DQL(Documentum Query Language) como por ejemplo la siguiente :

select dos_extension, name, description from dm_format order by dos_extension

Eso si habría que tener cuidado de las extensiones que estan vacias y repetidas, todo depende de la lógica de negocio a implementar.





- FIN -

Errores durante el uso de las DFC 5.3

Durante el uso de las DFC de Documentum en una webapp me he encontrado con el siguiente listado de errores:

1. java.lang.UnsatisfiedLinkError: no dmcl40 in java.library.path
   
   Problema: El classloader encuentra las clases de las DFC en el classpath, pero no encuentra las .dll asociadas en el path del sistema.
   
   Solución: Especificar al tomcat mediante los parámetros de la JVM la ubicación de las dll de las DFC: -Djava.library.path=C:\desarrollo\documentum_dlls.
   
   
2. java.lang.UnsatisfiedLinkError: Native Library C:\Program Files\Documentum\Shared\dmcl40.dll already loaded in another classloader
   
   Problema: Pues sí, este es realmente un problema :-) suele salir después detener la aplicación y volverla a iniciar, al parecer las DFC tienen algún tipo de mecanismo que mantiene cargado las clases después de la primera ejecución correcta y que no se descarga al detener el servidor tomcat.
   
   Solución: Quitar -Djava.library.path del inicio del servidor e iniciarlo, cuando este de el primer error(error nº 1) hay que detenerlo, volver a introducir el parámetro e iniciar nuevamente el servidor, y sí! es una solución cutre pero me permitió seguir adelante con el desarrollo.
   
   
3. DfException:: THREAD: http-8084-Processor23; MSG: [DM_SYSOBJECT_E_LINK_PERMIT2]error: "Linking or unlinking to the folder '/mirepositorio'....."
   
   Solución: Este tipo de error me daba cuando intentaba conectarme al repositorio del servidor, el tema esta en que el nombre del repositorio no empieza con la barra "/".
   
   
4. DfException:: THREAD: http-8084-Processor25; MSG: [DM_SYSOBJECT_E_CANT_STORE_CONTENT]error: "Cannot store content pointed by file...[DM_CONTENT_E_BAD_FORMAT]error: ..."
   
   Solución: Se especificaba un tipo de documento erróneo de Documentum, este tipo no se corresponde con los mime-types, sino con tipos especificos de Documentum.
   

Enlaces referentes a como se comportan los classloaders:

• Inside class loaders
• Internals of Java class loading
• Class Loader - HOW TO (Tomcat 5.5)

- FIN -