Documentum

Propòsit

L’objectiu d’aquest article és descriure la metodologia a seguir en la utilització del connector al sistema Documentum des de qualsevol aplicació Java del Framework J2EE. L’abast d’aquest sistema es fonamenta una interfície Java per a accedir a Documentum, permetent emmagatzemar i recuperar documents a més d’altres operacions relacionades com la creació de carpetes o assignació de propietats.

Instal·lació

Instal·lació del DFC (Documentum Foundation Classes)

Com a requisit previ a la utilització del servei, cal instal·lar a la màquina de desenvolupament/servidor la DFC (Documentum Foundation Classes) de la versió de Documentum que s’utilitzarà: 5.3, 6.5 o 7.1. En cas de no comptar amb aquests instal·lables, es poden sol·licitar mitjançant la bústia de la OT Canigó: oficina-tecnica.canigo.ctti@gencat.cat.

Els passos a seguir en la instal·lació, que són similars a les tres versions, són els següents:

En aquest punt, indicarem el host i el port del docBroker que conté el magatzem de claus.

[DOCBROKER_PRIMARY]
host =es-hg2r02j
port =1489

[DMAPI_CONFIGURATION]
cache_queries = T
token_storage_enabled=F
token_storage_path=D:\Documentum\apptoken

dfc.data.dir=C\:/Documentum
dfc.registry.mode=windows
dfc.search.ecis.enable=false
dfc.search.ecis.host=
dfc.search.ecis.port=
dfc.tokenstorage.dir=C\:/Documentum/apptoken
dfc.tokenstorage.enable=false
dfc.docbroker.host[0]=nomHostDocumentum
dfc.docbroker.port[0]=PortHostDocumentum
dfc.globalregistry.repository=NomRepositoriClaus
dfc.globalregistry.username=usernameRepositoriClaus
dfc.globalregistry.password=passRepositoriClaus

Instal·lació del connector

Per tal d’instal·lar el Mòdul de Documentum es pot optar per incloure’l automàticament a través de l’eina de suport al desenvolupament o bé afegir manualment la següent dependència en el fitxer pom.xml de l’aplicació:

<canigo.integration.documentum.version>[1.2.0,1.3.0)</canigo.integration.documentum.version>

<dependency>
          <groupId>cat.gencat.ctti</groupId>
          <artifactId>canigo.integration.documentum</artifactId>
          <version>${canigo.integration.documentum.version}</version>
</dependency>

<canigo.integration.documentum.version>[2.2.0,2.3.0)</canigo.integration.documentum.version>

<dependency>
          <groupId>cat.gencat.ctti</groupId>
          <artifactId>canigo.integration.documentum</artifactId>
          <version>${canigo.integration.documentum.version}</version>
</dependency>

<canigo.integration.documentum.version>[3.1.0,3.2.0)</canigo.integration.documentum.version>

<dependency>
          <groupId>cat.gencat.ctti</groupId>
          <artifactId>canigo.integration.documentum</artifactId>
          <version>${canigo.integration.documentum.version}</version>
</dependency>

mvn install:install-file -Dfile="dfc.jar" -DgroupId=dfc -DartifactId=dfc -Dversion=7.1 -Dpackaging=jar
mvn install:install-file -Dfile="certj.jar" -DgroupId=certj -DartifactId=certj -Dversion=5.2 -Dpackaging=jar
mvn install:install-file -Dfile="configservice-api.jar" -DgroupId=configservice -DartifactId=configservice-api -Dversion=7.1 -Dpackaging=jar
mvn install:install-file -Dfile="configservice-impl.jar" -DgroupId=configservice -DartifactId=configservice-impl -Dversion=7.1 -Dpackaging=jar
mvn install:install-file -Dfile="jcmFIPS.jar" -DgroupId=jcmFIPS -DartifactId=jcmFIPS -Dversion=6.1 -Dpackaging=jar
mvn install:install-file -Dfile="jcifs-krb5-1.3.1.jar" -DgroupId=jcifs-krb5 -DartifactId=jcifs-krb5 -Dversion=1.3.1 -Dpackaging=jar
mvn install:install-file -Dfile="cryptojce.jar" -DgroupId=cryptojce -DartifactId=cryptojce -Dversion=6.1 -Dpackaging=jar
mvn install:install-file -Dfile="cryptojcommon.jar" -DgroupId=cryptojcommon -DartifactId=cryptojcommon -Dversion=6.1 -Dpackaging=jar

Configuració

La configuració es realitza automàticament a partir de la eina de suport al desenvolupament.

Propietats del DFC

Caldrà incloure al CLASSPATH del projecte el fitxer dfc.properties generat durant la instal·lació del DFC.

Ubicació: <PROJECT_ROOT>/src/main/resources/dfc.properties

Propietats del connector

Ubicació: <PROJECT_ROOT>/src/main/resources/config/props/documentum.properties

Funcionament

En aquest exemple tenim dues classes: DocumentumServiceController, que és l’Endpoint del servei, i DocumentumAplicacioService, que és la classe Java en la que s’implementa la lògica de l’operació i s’invoca al mòdul de Documentum.

DocumentumServiceController.java

   import org.springframework.beans.factory.annotation.Autowired;
   import org.springframework.http.MediaType;
   import org.springframework.web.bind.annotation.PostMapping;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RestController;

   import cat.gencat.plantilla32.service.DocumentumAplicacioService;

   @RestController
   @RequestMapping("/documentum")
   public class DocumentumServiceController {

      @Autowired
      DocumentumAplicacioService documentumAplicacioService;

      @PostMapping(produces = { MediaType.APPLICATION_JSON_VALUE })
      public String testLogin() throws Exception {
         return documentumAplicacioService.testLogin();
      }
   }

DocumentumAplicacioService.java

   import org.slf4j.Logger;
   import org.slf4j.LoggerFactory;
   import org.springframework.beans.factory.annotation.Autowired;
   import org.springframework.context.annotation.Lazy;
   import org.springframework.stereotype.Service;

   import cat.gencat.ctti.canigo.arch.integration.documentum.DocumentumConnector;
   import cat.gencat.ctti.canigo.arch.integration.documentum.DocumentumService;
   import cat.gencat.ctti.canigo.arch.integration.documentum.impl.DocumentumConfigurator;

   @Service("documentumAplicacioService")
   @Lazy
   public class DocumentumAplicacioService {

      private static final Logger log = LoggerFactory.getLogger(DocumentumAplicacioService.class);

      @Autowired
      private DocumentumService service;

      @Autowired
      private DocumentumConnector documentum;

      @Autowired
      private DocumentumConfigurator configurator;

      /**
       * Comprovem que es pot fer login al sistema de Documentum
       */
      public String testLogin(){
         String message = null;
         try{
            service.login(configurator.getUser(), configurator.getPassword(),configurator.getDocBase(), this.documentum);
         }catch(Exception e){
            message = "Error al realitzar login";
            log.error(e.getMessage(), e);
         }
         message = "Login correcte";
         return message;
      }

   }