Arquitectura de Aplicaciones. Gestión Documental DOCUMENTUM. Área de Soluciones, Aplicaciones Especiales y Arquitectura de Software.

(1)

Enero 2014

Arquitectura de

Aplicaciones

Gestión Documental

DOCUMENTUM

(2)

IC M . C om uni c a c ión e I m a gen C orporat iv a

ÍNDICE

1. Introducción

2. Conceptos Básicos de Documentum

2.1 Conceptos Generales

2.2 Repositorio

2.3 Content Server

2.4 Modelo Objeto-Relacional

2.5 Objeto Documental

2.6 Tipos documentales

2.7 Permission Set

2.8 Acl’s

3. Arquitectura

3.1 Entorno de Desarrollo

3.2 Repositorios

(3)

ÍNDICE

4. Framework Documental

4.1 Tipología Básica

4.2 Seguridad Básica

o

Usuarios Nominales

o

Usuarios Genéricos

o

Auditoría de Seguridad

4.3 Integración con DCTM

o

Servicios web (docu_ws )



framework2

o

Servicios Documentales



Framework ATLAS

o

Librería docu_lib

4.4 Normativa Desarrollo

5. Soluciones de Desarrollo

5.1 Tipología de Soluciones

5.2 Java Métodos

5.3 TBO´s

5.4 Carga de Datos

5.5 Personalización Webtop

(4)

ÍNDICE

6. Ciclo de Vida de Mantenimiento de las APPS

(5)

Introducción



Objetivo Presentación



Funciones

del

Área

de

Aplicaciones

Especiales

y

Arquitectura del Software.



Desarrollo de normativa



Desarrollo de estándares



Soporte Técnico al desarrollo



Configuración de aplicaciones en entornos de desarrollo



_{Portal para el desarrollo de Aplicaciones}

• http://www.madrid.org/arquitecturasw

• http://intranet.madrid.org/arquitecturasw

(6)

ÍNDICE

1. Introducción

2. Conceptos Básicos de Documentum

2.1 Conceptos Generales

2.2 Repositorio

2.3 Content Server

2.4 Modelo Objeto-Relacional

2.5 Objeto Documental

2.6 Tipos documentales

2.7 Permission Set

2.8 Acl’s

3. Arquitectura

3.1 Entorno de Desarrollo

3.2 Repositorios

(7)



Content Server:

Es el núcleo de la plataforma Documentum. Como tal, ofrece toda la

funcionalidad de la plataforma, seguridad, gestión de procesos o gestión de contenidos

entre otros. Servicio que gestiona el repositorio

.



Connection Broker:

también conocido como docbroker, es un proceso que proporciona

la información necesaria a cada cliente sobre los repositorios activos en una red.



Docbase:

es un repositorio donde se almacena todo el contenido gestionado por la

plataforma Documentum. Almacena el contenido en FileSystem y las propiedades en

Base de Datos Relacional. Cada Docbase proporciona seguridad, servicios y

herramientas para compartir el contenido entre los diferentes usuarios. Para las

versiones más actuales, es también utilizado en su lugar el concepto de repositorio

.



DFC:

Es el acrónimo de Documentum Foundation Classes Son las APIs principales de

Documentum, basadas en la plataforma J2EE y dan acceso a la funcionalidad de

Documentum desde cualquier aplicación.



ACL:

es la lista de control de acceso aplicada a cada uno de los objetos residentes en el

repositorio documental, y definen el tipo de operación que cada usuario puede realizar

sobre el mismo.

Conceptos Básicos de Documentum

02

(8)

2.2 Repositorio



Almacena contenido en el Filesystem



Almacena las propiedades o metadatos

en

un

gestor

de

Base

de

Datos

Relacional



Reside en un servidor UNIX, Linux o

Windows

Repository

File Storage System Database

owner name creation date

object name

Conceptos Básicos de Documentum

(9)

2.3 Content Server



Es

un

servicio

que

controla

el/los

repositorio/s



El repositorio sólo puede ser accedido

mediante el Content Server



Soporta aplicaciones cliente-servidor y

aplicaciones web.

Conceptos Básicos de Documentum

02

Content Server

Repository

(10)

2.4 Modelo Objeto-Relacional



Modelo relacional orientado a objetos



Cualquier entidad de Documentum es gestionada y almacenada

internamente como objetos documentales.

Conceptos Básicos de Documentum

(11)

2.5 Objeto Documental



El contenido almacenado en el repositorio es un

OBJETO



Las propiedades se almacenan en la Base de datos



Puede estar formado por un fichero contenido (opcional),

almacenado en el sistema de ficheros

Repository

File Storage System Database

Content File Properties

owner name creation date object name



Un objeto está definido por sus propiedades y métodos



Las propiedades lo describen



Los métodos describen las acciones que se pueden realizar sobre él.

Propiedades Métodos

Conceptos Básicos de Documentum

(12)

2.6 Tipos Documentales



¿Qué es un tipo documental (object type)?



Son plantillas en las que se apoyan las instancias de objetos.



Definen las propiedades que posee un objeto y sus métodos.



Todos los objetos pertenecen a un tipo.



Existen más de 100 tipos.



Se pueden añadir nuevos tipos personalizados (custom types).

Conceptos Básicos de Documentum

(13)



Un subtipo hereda todas las propiedades

de su supertipo



Los

subtipos

normalmente

tienen

propiedades adicionales



Jerarquía de objetos

Conceptos Básicos de Documentum

02

dm_user

dm_acl

dm_sysobject

dmr_content

dm_store

dm_cabinet

dm_procedure

dm_folder

dm_document

dm_workflow

dm_note

persistent

object

r_object_id

i_vstamp

i_is_replica

Supertipo

(o Tipo

Padre)

Subtipo

(o Hijo)

A

C

B

(14)

2.7 Permission Set



Hay dos categorías de tipos de permisos



Permisos básicos

– obligatorios para cada objeto



Permisos extendidos

– opcionales



Un permission set es una configuración de permisos reutilizable



Un Permission set indica los permisos extendidos y básicos para:



Owner (obligatorio) Propietario del objeto



Users (opcional) cualquier número de usuarios



Groups (opcional) cualquier número de grupos



World (obligatorio) todos los usuarios no indicados explícitamente

Owner DELETE

Conceptos Básicos de Documentum

(15)

2.8 ACL



Cada permission set es un objeto ACL en el Content Server:



Contiene una lista de usuarios y grupos



Contiene un conjunto de permisos básicos para cada usuario y grupo



Contiene un conjunto de permisos extendidos para cada usuario y grupo



Se asocia con los objetos por su nombre y propietario

World

Owner

xxxx_gr_admin

xxxx_gr_usgen

david

NONE

DELETE

WRITE

VERSION

WRITE

–

Change Location

–

Change Owner, Change State

Users/Groups

Basic Permissions

Extended Permissions

xxxx_acl_carpeta

dm_acl

Conceptos Básicos de Documentum

(16)

ÍNDICE

1. Introducción

2. Conceptos Básicos de Documentum

2.1 Conceptos Generales

2.2 Repositorio

2.3 Content Server

2.4 Modelo Objeto-Relacional

2.5 Objeto Documental

2.6 Tipos documentales

2.7 Permission Set

2.8 Acl’s

3. Arquitectura

3.1 Entorno de Desarrollo

3.2 Repositorios

(17)

Arquitectura

03

Documentum Content

Server 6.7 SP2

BBDD Oracle 11gR2 Webtop 6.7 SP2 Documentum Administrator 6.7 SP2 Bea Weblogic 9.2 Puesto Desarrollo Apache Tomcat 5.5.23 Documentum Composer 6.7 SP1 Documentum DAR Installer 6.7 SP1

3.1 Entorno de Desarrollo

Documentum DAR Installer 6.7 SP1

(18)

Código

Repositorio

Consejerías

01 Consejería de Economía y Hacienda, Consejería

de Transportes e Infraestructuras, Consejería de

Medio Ambiente, Vivienda y Ordenación del

Territorio

02 Consejería de Presidencia, Consejería de Cultura,

Deporte y Turismo, Consejería de Inmigración y

Cooperación, Consejería de Familia y Asuntos

Sociales, Consejería de Empleo y Mujer

03 Aplicaciones Horizontales

04 Consejería de Justicia e Interior

05 Consejería de Sanidad

06 Consejería de Educación

Arquitectura

03

Documentum

Content Server

6.7 SP2

3.2 Repositorios

(19)

3.2 Repositorios

(Ejemplo Entorno Desarrollo)

Arquitectura

(20)

Arquitectura

03

3.3 Arquitectura Física

(21)

ÍNDICE

4. Framework Documental

4.1 Tipología Básica

4.2 Seguridad Básica

o

Usuarios Nominales

o

Usuarios Genéricos

o

Auditoría de Seguridad

4.3 Integración con DCTM

o

Servicios web (docu_ws )



framework2

o

Servicios Documentales



Framework ATLAS

o

Librería docu_lib

4.4 Normativa Desarrollo

5. Soluciones de Desarrollo

5.1 Tipología de Soluciones

5.2 Java Métodos

5.3 TBO´s

5.4 Carga de Datos

5.5 Personalización Webtop

(22)

Framework Documental

04

(23)

5.3 Framework Documental



Incluye:



Tipología documental básica



Seguridad Básica



Tipos de Usuarios



Auditoría de Seguridad



Integración con Documentum



Librerías



Servicios Web



Normativa de Desarrollo

Tipología

Básica

Seguridad

Básica

Integración

con DTCM

Normativa

Desarrollo

Framework Documental

04

(24)

4.1 Tipología Básica



Se ha identificado una tipología documental básica que provea a los

proveedores un marco definido para la construcción de los servicios

que prestan a ICM en proyectos relacionados con Gestión Documental



Esta

técnica nos permite incluir cambios generales en los tipos

documentales básicos que son heredados por los tipos definidos en

las distintas aplicaciones



Se proporciona esta tipología en el DAR (ICM_Tipos_Basicos)



Documentación



Documento de Normativa



Documento preparación del entorno desarrollo

Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

(25)



cm_usuario



Hereda de:

dm_user



Atributos:



dni



telefono_fijo



telefono_movil



cm_documento_gral



Hereda de:

dm_document



Atributos:



fecha_registro



fecha_registro_interno



numero_registro



numero_registro_interno

dm_user

cm_usuario

dm_document

cm_documento_gral

xxxx_td_descripcion

Framework Documental

04

4.1 Tipología Básica

(26)



cm_documento_auditado



Hereda de:

cm_documento_gra

l



Atributos:



cdclave



traza_lopd

dm_document

cm_documento_gral

xxxx_td_descripcion

cm_documento_auditado

Framework Documental

04

4.1 Tipología Básica

(27)



cm_traza_lopd



Hereda de:

cm_documento_gra

l



Atributos:



cdclave



dsfich_logico



Cenprop



cendir.

xxxx_td_traza_lopd

dm_document

cm_documento_gral

cm_traza_lopd

Framework Documental

04

4.1 Tipología Básica

(28)

4.2 Seguridad Básica

Conceptos Documentum: Client Capability



Tipos de usuarios

• Usuarios Nominales

• Usuarios Genéricos

Consumer

Contributor

Coordinator

System

Administrator

Determina el

nivel de

funcionalidad

disponible en las

aplicaciones

cliente

Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

(29)

None

Create Type

Create cabinet

Create Group

SYSADMIN

SUPERUSER

Conceptos Documentum: Acceso al Repositorio - Privilegios

None

Config Audit

Purge Audit

View Audit

PRIVILEGIOS

Privilegios EXTENDIDOS

4.2 Seguridad Básica



Tipos de usuarios

• Usuarios Nominales

• Usuarios Genéricos

Framework Documental

(30)



Acceso mediante usuario / contraseña



La autenticación a través de LDAP

Framework Documental

04

4.2 Seguridad Básica



Tipos de usuarios

• Usuarios Nominales

(31)



Los usuarios

nominales nunca podrán tener permisos

de

SuperUser como Client Capability

Consumer

Contributor

Coordinator

System

Administrator

Framework Documental

04

4.2 Seguridad Básica



Tipos de usuarios

• Usuarios Nominales

(32)



Usuarios creados en el repositorio tipo Inline Password



Se podrán crear hasta tres usuarios según permisos:

(1)

o

con_xxxx



Usuario sólo consulta

o

adm_xxxx



Usuarios para tareas de administración

Framework Documental

04

4.2 Seguridad Básica



Tipos de usuarios

• Usuarios Nominales

(33)

IC M . C om uni c a c ión e I m a gen C orporat iv

a

Permisos de Usuarios Genéricos

con_xxxx

Consumer

Contributor

Coordinator

System

Administrator

None

Create Type

Create cabinet

Create Group

SYSADMIN

SUPERUSER

None

Config Audit

Purge Audit

View Audit

PRIVILEGIOS

_{Privilegios EXTENDIDOS}

Client Capability

Framework Documental

04

4.2 Seguridad Básica



Tipos de usuarios

• Usuarios Nominales

(34)

None

Create Type

Create cabinet

Create Group

SYSADMIN

SUPERUSER

None

Config Audit

Purge Audit

View Audit

Consumer

Contributor

Coordinator

System

Administrator

adm_xxxx

Permisos de Usuarios Genéricos

Framework Documental

04

4.2 Seguridad Básica



Tipos de usuarios

• Usuarios Nominales

(35)

aud_xxxx

Permisos de Usuarios Genéricos

None

Create Type

Create cabinet

Create Group

SUPERUSER

None

Config Audit

Purge Audit

View Audit

PRIVILEGIOS

_{Privilegios EXTENDIDOS}

Client Capability

Consumer

Contributor

Coordinator

System

Administrator

4.2 Seguridad Básica



Tipos de usuarios

• Usuarios Nominales

(36)



Auditoria de Seguridad

• La trazabilidad se delega en

la aplicación



antes de

invocar operaciones llamará

al xxxx_pack_log

• Para aplicaciones con

desarrollos java:

java_metodos o tbo´s



éstos deben llamar a

docu_pack_log

Acceso mediante Usuario Genérico

Documentum Content Server Cliente Aplicación Java Aplicación J2EE Servidor Aplicaciones BBDD Apps xxxx_pack_log java_metodo TBO BBDD Documentum docu_pack_log Usuario Genérico Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

4.2 Seguridad Básica

(37)



Auditoria de Seguridad

• La trazabilidad se delega a

Documentum

• Un proceso batch migra los

datos de la auditoria de

Documentum a la BBDD

SGUR

Acceso mediante Usuario Nominal

Documentum Content Server Cliente Aplicación Java Usuario Nominal Servidor Aplicaciones BBDD Documentum

BBDD Trazas SGUR ICM docu_jmtd_migracion_traz Audit Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

4.2 Seguridad Básica

(38)



Framework 2: Servicios de Gestión Documental:

docu_ws



Desarrollado en tecnología framework 2



Utilizado en aplicaciones existentes de framework 2



Se mantiene por compatibilidad,

no evolucionará y no debe

utilizarse para nuevos desarrollos.

Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

4.3 Integración con DCTM

(39)

Requisitos de Configuración en los módulos web con acceso al webservice docu_ws

xxxx_web

_{activation.jar} apache_soap-2_3_1.jar axis.jar commons-discovery-0.2.jar commons-logging-1.0.4.jar jaxrpc.jar log4j-1.2.15.jar mail-1.4.jar saaj.jar servlet.jar wsdl4j-1.6.1.jar lib_dep_docu_ws.zip docu_util_lib.jar jaxb_icm_1_3.jar seguridad_cm_1_1.jar sistemas2_4.jar xxxx_web.config documentum.docbase = desdocum_01 documentum.usuario = xxxx_usuario documentum.clave = ... documentum.docu_ws_url = http://desarrollo.madrid.org/docu_ws/services documentum.ws.adminService.url = ... ... documentum.ws. importarModificar.metodo = ... Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04



Framework 2: Servicios de Gestión Documental:

docu_ws

(40)

Administración de Grupos

Importar / Modificar

_Documentos

Ver / Exportar Documento

Permisos Documento

Borrar Documento

Buscar Documentos

Pedir Rendición

Ver Rendición

Check Documentos

Gestionar Tablas Externas

Gestión de Carpetas

Framework Documental

04



Framework 2: Servicios de Gestión Documental:

docu_ws

(41)



Framework 2: librería

docu_lib



Sólo para aplicaciones de Framework 2



Para Aplicaciones con un exigencia de rendimiento alta y un nivel de

complejidad baja se proporcionará la librería docu_lib.



Este aplicativo es una réplica de las funcionalidades de los Servicios

Web ICM de acceso a Documentum de framework 2.



Los proyectos que utilicen docu_lib han de incorporar las

DFC’s en el

.ear de despliegue. En caso de tener que realizar un cambio de versión en

las

DFC’s, se tendrán que actualizar estos aplicativos).

(Esta Solución necesita autorización previa por parte de ICM)

Framework Documental

04

4.3 Integración con DCTM

(42)



Framework 2: librería

docu_lib

lib_dep_docu_lib.zip docu_util_lib.jar jaxb_icm_1_3.jar xxxx_web.config

xxxx_web

activation.jar aspectjrt.jar certjFIPS.jar ctsTransform.jar dfc.jar docu_util_lib.jar jaxb_icm_1_3.jar jsafeFIPS.jar log4j-1.2.15.jar mail-1.4.jar xercesImpl.jar xml-apis.jar dfc.docbroker.host[0]=icmcs03 dfc.docbroker.port[0]=1489 dfc.globalregistry.repository=desdocum_01 dfc.globalregistry.username=dm_bof_registry dfc.globalregistry.password=GrRNPhLJrkoTDAZE0RGJow\=\= dfc.propierties documentum.docbase = desdocum_01 documentum.usuario = xxxx_usuario documentum.clave = ...

Requisitos de Configuración en los módulos web con acceso mediante docu_lib

docu_lib.jar Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

4.3 Integración con DCTM

(43)



librería ICM:

docu_lib

Administración de Grupos

Importar / Modificar

_Documentos

Ver / Exportar Documento

Permisos Documento

Borrar Documento

Buscar Documentos

Pedir Rendición

Ver Rendición

Check Documentos

Gestionar Tablas Externas

Gestión de Carpetas

Framework Documental

04

(44)



Framework ATLAS: Servicios de Gestión Documental



La integración con el gestor documental se realiza en dos ámbitos



Acceso al core de documentum mediante programación (API)



Componentes visuales que acceden al gestor documental



Para desarrollar una aplicación web con integración con gestión

documental se debe partir del arquetipo de gestión documental que ya

incluye las librerías y ficheros de configuración necesarios para trabajar

con el servicio de gestión documental.

Framework Documental

04

4.3 Integración con DCTM

(45)

•buscar – realiza una consulta al gestor documental a partir de una Query en formato DQL.

ConsultaService

•alta – crea una nueva carpeta en el gestor

•modificacion– actualiza las propiedades de una carpeta existente

•baja – elimina una carpeta existe y su contenido

GestionCarpetasService

•cancelCheckout– cancela el bloqueo de un documento, previamente bloqueado

•checkin– registra una nueva versión de un documento bloqueado y lo desbloquea

•checkout– bloquea un documento

•eliminar – elimina un documento parcial (versión) o totalmente

•establecerPermisos– modifica los permisos de un documento

•exportar – recupera el contenido de un documento

•importar – envía un nuevo documento al gestor

•modificar – modifica las propiedades de un documento, sin establecer un bloque previo.

•pedirRender– solicita una transformación de formato de un documento

GestionDocService

•alta – crea un nuevo grupo en el gestor

•modificacion– modifica las propiedades de un grupo existente

GestionGruposService

•eliminar – elimina registros de una tabla externa

•insertar – inserta registros en una tabla externa

•modificar – modifica registros de una tabla externa

GestionTablasExternasService



Framework ATLAS: Servicios de Gestión Documental

Framework Documental

04

4.3 Integración con DCTM

(46)

xxxx_yyyy

(aplicación web)

xxxx_docu

xxxx_modd

xxxx_jmtd_<nombre>

xxxx_tbo_<nombre>

xxxx_webtop

xxxx_batch_cdatos

4.4 Normativa

(1)

Tipología Básica

Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

(47)

4.4 Normativa

(1)



Según la Normativa se establece la siguiente nomenclatura:

(2)

(1) Más información de Normativa y Diseño en el portal de Desarrollo (2) xxxx corresponde con el nombre del proyecto

• xxxx_td_<nombre_tipo>

TIPOS DOCUMENTALES

• xxxx_gr_<nombre_grupo>

GRUPOS

• xxxx_rol _<descripción_funcional>

ROLES

• xxxx_ext_<nombre_tabla>

TABLAS EXTERNAS

• xxxx_acl_<descripción_funcional>

PLANTILLAS DE PERMISOS

• xxxx_wf_<descripción_funcional>

WORKFLOWS

• xxxx_lf _<descripción_funcional>

CICLOS DE VIDA

• xxxx _pro_<descripción_funcional>

PROCEDIMIENTOS

• xxxx_mtd _<descripción_funcional>

METODOS

• xxxx_job _<descripción_funcional>

JOBS

• xxxx_rl _<descripción_funcional>

RELACIONES ENTRE T. DOC.

• xxxx_alias _<descripción_funcional>

ALIAS SET

Tipología Básica Seguridad Básica Integración con DCTM Normativa Desarrollo

Framework Documental

04

(48)

ÍNDICE

4. Framework Documental

4.1 Tipología Básica

4.2 Seguridad Básica

o

Usuarios Nominales

o

Usuarios Genéricos

o

Auditoría de Seguridad

4.3 Integración con DCTM

o

Servicios web (docu_ws )



framework2

o

Servicios Documentales



Framework ATLAS

o

Librería docu_lib

4.4 Normativa Desarrollo

5. Soluciones de Desarrollo

5.1 Tipología de Soluciones

5.2 Java Métodos

5.3 TBO´s

(49)

Soluciones de Desarrollo

05

5.1 Tipología de Soluciones: Interfaces de Usuario

Aplicación Desarrollada en

Framework 2

Aplicación Desarrollada

en Framework ATLAS

Aplicación J2EE:

Personalización Webtop

DCTM

(50)

Tipo Desarrollo

J2EE

Framework 2

ATLAS

Webtop

Aplicación

Web

Java

Método

Proceso

Batch

Soluciones de Desarrollo

05

5.1 Tipología de Soluciones

Servicios

Gest.Doc.

docu_lib

DFC

docu_lib

DFC

Servicios

Gest.Doc.

docu_ws

(51)

5.2 Java Métodos

05

• Las aplicaciones crearán un único módulo técnico de tipo java-método con todos los métodos que

necesite

• Los java-métodos se empaquetarán en un único jar

xxxx_jmtd_<yyyy>.jar

JMTD

• El acceso se realizará mediante las DFC´s del producto

JMTD

DFC

• El java método sólo podrá utilizar las librerías autorizadas (docu_jmt_librerias_2_1.zip)

• Si se necesitan otras librerías, previo al desarrollo se solicitar Autorización al Área de Arquitectura

xxxx_jmtd_<yyyy>.jar

JMTD _{docu_jmt_librerias_2_1.zip}

xxxx_lib_<yyyy>.jar

jar

Previa Autorización

• Objeto: Implementar procesos planificados en Documentum

JOB MTD JMTD

(52)

05

• El fichero jar comprimido se añadirá en el archivo DAR en: xxxx_mod_yyyy

• La configuración del Job y del Method será:

DAR

xxxx_jmtd_<yyyy>.jar JMTD

• Run as the Server

• Use Method Server

• Launch directly

JOB

MTD

• Shedule

(Atención hora programada)

• Pass standard arguments



True

xxxx_job_<yyyy>

xxxx_mtd_<yyyy>

5.2 Java Métodos

(53)

5.3 TBO



Si existe la necesidad de personalizar la funcionalidad por defecto sobre

los eventos asociados a un tipo documental, se creará un módulo de tipo

TBO por cada uno de los tipos documentales sobre los que se

personalice su funcionalidad.



Para la implementación de estos módulos se deberá utilizar la plantilla de

procesos Batch



El acceso a Documentum se realizará mediante las DFC´s



Dentro de cada módulo se entregarán dos librerías:

•

Librería que contiene el Interfaz del módulo:

xxxx_tbo_interfaz_yyyy.jar

•

Librería que contiene la implementación del módulo:

xxxx_tbo_impl_yyyy.jar

(54)

5.4 Carga Inicial de datos



Para

realizar

una

carga

inicial

de

datos

en

Documentum

se

implementará un módulo técnico de tipo batch , partiendo de la plantilla

de procesos Batch



Desde estos módulos se accederá a Documentum mediante la librería

docu_lib



Cuando la librería no proporcione la funcionalidad requerida, podrán ser

utilizadas las DFCs del producto, pero siempre previa autorización por

parte de ICM

(55)

5.5 Personalización Webtop



El uso de clientes estándar de Documentum quedará relegado a las

siguientes situaciones:



El producto cumple perfectamente las necesidades de la lógica de

negocio de la aplicación.



La parametrización o desarrollo sobre el producto estándar no alterará el

comportamiento interno de la aplicación, para no perder soporte del

producto por parte de EMC.



Solución rápida para proyectos con niveles de requisitos bajos respecto

a la utilización de Interfaz de usuario.

05

(Esta Solución necesita autorización previa por parte de ICM)

(56)

Se entregará siguiendo el formato de un proyecto eclipse según la siguiente estructura:

Contiene todos los ficheros entregables del proyecto: • xxxx_webtop.war

• dfc.properties

• (otros ficheros de configuración que sean necesarios) • custom_xxxx_webtop.zip

(Contiene el empaquetado de todos los elementos modificados o incluidos en la personalización a partir del directorio web)

Este directorio contendrá todos los ficheros necesarios para generar el .war. Será obligatorio que exista:

• el fichero CrearWar.bat

• el directorio classes_webtop (Contendrá todos los .classpropios del producto)

Directorio con las librerías necesarias de compilación en el proyecto Directorio con los ficheros java fuentes en sus correspondientes paquetes. El nombre del paquete principal debe de coincidir con el nombre del módulo según normativa framework 2.

Contiene el propio webtop

Dentro de la carpeta custom se incluirán los nuevos componentes y los

5.5 Personalización Webtop

(57)

ÍNDICE

6. Ciclo de Vida de Mantenimiento de las APPS

(58)

06

ú

n

el

ti

p

o

d

e mó

d

u

lo

técni

co

Análisis de

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

DocApp BBDD Aplicación Web Aplicación Webtop TBO Batch

Seguir indicaciones de la normativa

de desarrollos Fw ATLAS / Fw 2

Seguir indicaciones de la normativa para Modelo

de Datos

Fases: codificación, instalación, y

paso a producción

Fases: codificación, instalación, y paso a

producción

(59)

Ciclo de Vida Mantenimiento de APPS

06

Documentum Content Server 6.7 SP2 BBDD Oracle 11g

Entorno

Desarrollador

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

Puesto Desarrollo Documentum Composer 6.7 SP1 Documentum DAR Installer 6.7 SP1 Documentum DAR Installer 6.7 SP1

(60)

Herramientas Desarrollo

Generación

06

JMTD

Ciclo de Vida Mantenimiento de APPS

DocApp DAR Aplicación Webtop

eclipse

TBO DAR DAR

conf

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

Documentum Composer

eclipse

Documentum Composer

(61)

Inicial

Herramienta Instalación

Destino

06

JMTD

Ciclo de Vida Mantenimiento de APPS

DocApp

Aplicación Webtop

TBO

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

Apache TomCat

DAR DAR_Installer

conf

DAR DAR_Installer

Petición Inst. Arquitectura Apps.

conf

Petición Inst. Arquitectura Apps.

(62)

06

Ciclo de Vida Mantenimiento de APPS

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción



Paso 1: Generar entrega en Repositorio Subversion o StarTeam

StarTeam



Subir al repositorio los módulos



Anotar ruta para incluir en la solicitud de Paso a

Producción

(63)



Paso 1: Generar entrega en Repositorio Subversion o StarTeam

06

Ciclo de Vida Mantenimiento de APPS

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

JMTD DAR _Dar Aplicación Webtop TBO

conf

Dar Dar Se creará un “tag” de subversion con fecha y versión de la entrega

Subversion

(64)



Paso 1: Generar entrega en Repositorio Subversion o StarTeam

06

Ciclo de Vida Mantenimiento de APPS

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

JMTD DAR _Dar Aplicación Webtop TBO

conf

Dar Dar Se creará un “tag” de subversion con fecha y versión de la entrega

(65)



Ejemplo de Entrega completa

Contiene un fichero erwin con una subárea llamada Documentum en la que se crean los objetos oracle necesarios (sinónimos,secuencia y trigger) :

XXXX-ERW-vv.rr-aaaammdd.er1

Este directorio contendrá los fuentes java en formato proyecto eclipse del programa de carga inicial de datos

Carpeta que contiene los fuentes java en formato proyecto eclipse de java métodos

Carpeta que contiene los fuentes java en formato proyecto eclipse de los tbo’s Carpeta que contiene los fuentes java en formato proyecto eclipse del cliente webtop personalizado

Este directorio contendrá:

• Dar: xxxx_modelo_de_datos_v[n] • Scripts: xxxx_preinstalación_v[n].api

xxxx_postinstalación_v[n].dql xxxx_marcha_atras_v[n].ebs

Esquema con un ejemplo de entrega mediante subversion:

Se creará un “tag” de subversion con fecha y versión de la entrega

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

(66)



Entrega completa.

Scripts utilizados

Acciones antes de Instalar

Instalación del DAR

Acciones después de Instalar

DQL xxxx_preinstalacion_v[n].api IAPI Instalación DAR xxxx_postinstalacion_v[n].dql Dmbasic xxxx_proc_postinstall Dmbasic xxxx_marcha_atras_v[n].ebs - Creación de ACL´s - Creación de otros objetos no incluidos en la DocApp

Elimina todos los objetos

- Registrar tablas externas - Asignación de permisos

- Asignar ACL´s a

Obligatorio

Opcional

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

(67)

IC M . C om uni c a c ión e I m a gen C orporat iv a 

Entrega incremental

• Una vez que la aplicación se ha pasado a producción, para las siguientes entregas del módulo

xxxx_docu, se entregará:

Una versión completa ubicada en la carpeta xxxx_docu/DAR

Una versión incremental, la cual contendrá sólo aquellos objetos nuevos y/o modificados

 Las entregas incrementales de este módulo se ubicarán en una carpeta llamada xxxx_docu/DAR_INC_V[N], siendo n la versión de la entrega y siendo n mayor que 1.

• El resto de módulos se entregarán de la misma forma.

Análisis

Requisitos

Diseño

Codificación

Instalación

en Desarrollo o

Mantenimiento

Paso a

Producción

Este directorio contendrá:

• Dar: xxxx_modelo_de_datos_v[n] • Scripts: xxxx_preinstalación_v[n].api

xxxx_postinstalación_v[n].dql xxxx_marcha_atras_v[n].ebs Este directorio contendrá:

• Dar xxxx_modelo_de_datos__inc v[n] • Scripts: xxxx_preinstalación_inc_v[n].api

xxxx_postinstalación_inc_v[n].dql xxxx_borrado_objetos_inc_v[n].ebs

Se creará un “tag” de subversion con fecha y versión de la entrega

06

Ciclo de Vida Mantenimiento de APPS

(68)



Scripts utilizados en una

entrega incremental

Acciones antes de Instalar

Instalación del DAR

Acciones después de Instalar

DQL xxxx_preinstalacion_inc_v[n].api IAPI xxxx_postinstalacion_inc_v[n].dql Dmbasic xxxx_proc_postinstall_inc_v[n] - Creación de ACL´s - Creación de otros objetos no incluidos en la DocApp

- Registrar tablas externas - Asignación de permisos

- Asignar ACL´s a

Dmbasic

xxxx_borrado_objetos_inc_ v[n].ebs

Elimina todos los objetos nuevos de una aplicación creados en las entregas