Dell · TabladeContenidos Prefacio...

EMC® Documentum®

Capital ProjectsVersión 1.9

Guía de configuración

EMC CorporationOficina principal corporativa:

MA 01748-9103 1-508-435-1000www.EMC.com

Legal Notice

Copyright © 2011-2014 EMC Corporation. All Rights Reserved.

EMC believes the information in this publication is accurate as of its publication date. The information is subject to changewithout notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATIONMAKES NO REPRESENTATIONSOR WARRANTIES OF ANY KINDWITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLYDISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. Adobe and Adobe PDFLibrary are trademarks or registered trademarks of Adobe Systems Inc. in the U.S. and other countries. All other trademarksused herein are the property of their respective owners.

Documentation Feedback

Your opinion matters. We want to hear from you regarding our product documentation. If you have feedback about how we canmake our documentation better or easier to use, please send us your feedback directly at [email protected]

Tabla de Contenidos

Prefacio ................................................................................................................................ 9

Capítulo 1 Descripción general .................................................................................... 11Conceptos clave de Capital Projects ................................................................... 12

Proyectos ..................................................................................................... 13Configuraciones del proyecto compartidas..................................................... 13Estructuras xBS ............................................................................................ 14Administración de documentos ..................................................................... 14Comentarios................................................................................................. 14Procesos de acción ........................................................................................ 15Transmisiones .............................................................................................. 15Entrega ........................................................................................................ 16Matrices de distribución................................................................................ 17Carga de documentos ................................................................................... 18Informes ...................................................................................................... 19Planificación\Progreso de documentos .......................................................... 20Administración de correspondencia............................................................... 20Conceptos adicionales................................................................................... 20

Capítulo 2 Configurar ................................................................................................... 23Introducción para archivo de configuración de repositorio (RCF,Repository Configuration File) .......................................................................... 24Entender las expresiones de atributos ................................................................ 24

Utilizar las expresiones de atributos............................................................... 26Utilizar las expresiones de atributos en los parámetros decomplementos .............................................................................................. 26Funciones de los atributos de un valor ........................................................... 27Funciones de los atributos de un valor y de repetición..................................... 28Ejemplos de expresiones de atributos............................................................. 29Parámetros globales y expresiones de caracteres comodín depertenencias de rol del RCF........................................................................... 31Configuración de formatos de fecha y hora .................................................... 31

Configurar los documentos ............................................................................... 32Crear un tipo de documento.......................................................................... 32Crear las plantillas de documentos ................................................................ 35Definir la herencia de los atributos de plantilla en el RCF ................................ 35

Configurar los tipos de carpeta .......................................................................... 36Crear un tipo de carpeta................................................................................ 37Crear una plantilla de carpeta........................................................................ 38Configurar las carpetas principales y controladas ........................................... 39Configurar las reglas de contenido para las carpetas ....................................... 39Configurar las reglas de contenido de carpetas en el RCF ................................ 41Crear una carpeta subordinada...................................................................... 41Definir la herencia de los atributos de carpeta en el RCF ................................. 42

Configurar la autonumeración........................................................................... 43Crear una configuración de autonumeración .................................................. 43

3

Tabla de Contenidos

Aplicar la autonumeración ............................................................................ 45Configurar las convenciones de nomenclatura.................................................... 46Configurar el relleno de atributos automático..................................................... 47

Crear una configuración de relleno automático de atributos ............................ 47Configurar el cuadro de lista de texto en la configuración derelleno de atributos................................................................................... 48

Aplicar una configuración de relleno de atributos a un tipo............................. 48Configurar las listas desplegables dinámicas ...................................................... 49

Configurar la asistencia de valor para un atributo de un tipo deobjeto nuevo................................................................................................. 49

Configurar la asistencia de valor basada en una consulta DQL..................... 50Configurar la asistencia de valor basada en una lista estática devalores ..................................................................................................... 53Configurar la asistencia de valor basada en valores de listadesplegable .............................................................................................. 55Configurar la asistencia de valor de un atributo basada en unvalor de otro atributo ................................................................................ 60

Quitar un valor de lista desplegable............................................................... 64Configurar las transmisiones ............................................................................. 64

Crear un tipo de transmisión ......................................................................... 65Crear una plantilla de transmisión ................................................................. 67Crear las plantillas de hojas de comentarios y portadas ................................... 67Expresiones para crear las plantillas............................................................... 69Restringir los formatos de documento que se envían en lastransmisiones ............................................................................................... 71Desactivar las hojas de registro para las transmisiones de revisión ................... 71Enviar los paquetes de transmisión a un sitio FTP........................................... 72Crear las transmisiones de revisión automáticamente a partir detransmisiones entrantes................................................................................. 72

Configurar los métodos de envío ....................................................................... 73Definir el tamaño de los envíos de transmisiones por correoelectrónico ................................................................................................... 73Enviar los paquetes de transmisión a un sitio FTP........................................... 74Habilitar el método de envío a FTP para un proyecto ...................................... 74Configurar los parámetros de los métodos de envío Syncplicity....................... 75

Configurar las entregas ..................................................................................... 77Habilitar las entregas .................................................................................... 78Configurar los destinos de la entrega ............................................................. 78Configurar tipos de documentos.................................................................... 81Configurar automáticamente documentos marcados para entrega ................... 82Configurar automáticamente marcar documentos como listos paraentrega ........................................................................................................ 82Configurar manualmente marcar documentos como listos paraentrega ........................................................................................................ 83Configurar el estado inmovilizado de los documentos .................................... 83Configurar el archivado automático............................................................... 84Configurar los controladores de mensajes de entrega y losdestinatarios de notificaciones de errores ....................................................... 85Configurar etiquetas de categorías de entrega ................................................ 85Configurar validadores de entrega................................................................. 85Configurar perfil de seguridad para los paquetes de entrega ........................... 86

Configurar el conector de Syncplicity................................................................. 86Habilitar métodos de entrega de Syncplicity para un proyecto......................... 86

Configurar notificaciones de los eventos de lectura/cambio ................................. 87Configurar controladores de tareas de flujo de trabajo......................................... 88

4

Tabla de Contenidos

Configurar perfiles de seguridad ....................................................................... 88Agregar nuevos roles .................................................................................... 88Agregar un nuevo perfil de seguridad ........................................................... 90

Configurar un tipo de proceso de acción ............................................................ 94Crear un tipo de proceso de acción ................................................................ 94

Configurar una matriz de distribución ............................................................... 98Crear una matriz de distribución ................................................................... 98Revisar una configuración de tipo de matriz de distribución existente.............. 99Revisar una configuración existente de plantillas de matriz dedistribución.................................................................................................. 99Crear una matriz de distribución para un proceso nuevo............................... 100Importar matrices de distribución................................................................ 102Configurar el complemento DistributionMatrixImportProcessing.................. 106

Configurar copias ........................................................................................... 107Configurar los servicios de administración de copias .................................... 107

Configurar la carga de documentos ................................................................. 109Configurar la carga de documentos de nuevos tipos de documentosen RCF....................................................................................................... 109Ejemplo de hoja de cálculo .......................................................................... 111Configurar la carga de nuevos tipos de documentos en un proyecto .............. 112Definir reglas de coincidencia...................................................................... 114

Configurar el progreso de la planificación ........................................................ 115Crear una plantilla de progreso de la planificación........................................ 115Aplicar la plantilla de progreso de la planificación a un tipo dedocumento................................................................................................. 116Aplicar la plantilla de progreso de la planificación a un tipo dedocumento: ................................................................................................ 117

Controlar el acceso al contenido de Asset Operations........................................ 117Configurar etiquetas para eventos del historial empresarial............................... 118Configurar la autoextracción de propiedades del correo electrónico ................... 118

Capítulo 3 Configuración del conector de Capital Projects para SupplierExchange .................................................................................................. 121Habilitación del conector de Capital Projects para Supplier Exchange ................ 121Configurar las conexiones del sistema.............................................................. 121

Cifrado usando DFC................................................................................... 122Registrar Capital Projects con proyectos de Supplier Exchange .......................... 122Registrar el documento entregable externo con Supplier Exchange .................... 123Enviar las transmisiones generales a Supplier Exchange ................................... 124Cerrar entregable............................................................................................ 124Controlador de mensajes................................................................................. 125

Trabajos en Supplier Exchange .................................................................... 125

Capítulo 4 Tipos de documentos clave: permisos, acciones permitidas yoperaciones disponibles ........................................................................... 127Documentos entregables internos .................................................................... 127

Documento de entrega interno: permisos de Documentum ........................... 129Documento de entrega interno: acciones permitidas ..................................... 131Documento de entrega interno: operaciones disponibles ............................... 135

Documentos entregables externos.................................................................... 138Documento de entrega externo: permisos de Documentum........................... 139Documento de entrega externo: acciones permitidas..................................... 140

5

Tabla de Contenidos

Documento de entrega externo: operaciones disponibles............................... 142Documentos de correspondencia ..................................................................... 144

Documento de correspondencia: permisos de Documentum ......................... 146Documento de correspondencia: acciones permitidas ................................... 147Documento de correspondencia: operaciones disponibles ............................. 149

Capítulo 5 Referencia ................................................................................................. 153Acciones permitidas ....................................................................................... 153Permisos ........................................................................................................ 154Permisos extendidos ....................................................................................... 155Roles ............................................................................................................. 156

Capítulo 6 Configurar informes .................................................................................. 157Modelo y configuración del objeto de informe .................................................. 157Configuración de informes.............................................................................. 158

Contenido del paquete de informes de Capital Projects ................................. 158Interfaz de usuario de los informes de Capital Projects.................................. 160Construcciones admitidas con la definición de informe JasperReports ............ 161

Scriptlet de creación de informes ............................................................. 162Mostrar imágenes contenidas en el paquete de informes ....................... 162Mostrar el enlace DRL en un informe................................................... 162Definir los subinformes en el paquete de informes ................................ 163

Formateador ECSF.................................................................................. 163Configuración del informe de historial de negocio de modo que seacompatible con la localización ..................................................................... 164Configuración adicional del RCF relacionada con la funcionalidadde generación de informes .......................................................................... 165

Acciones del informe .............................................................................. 165Ubicación de resultados temporal ............................................................ 166Ejecutar acción permitida del informe ...................................................... 166Métodos del servidor .............................................................................. 166

Configurar informes asincrónicos ................................................................ 167Planificar informes ..................................................................................... 168Parámetros de informes predeterminados .................................................... 169

Acceder a los informes de ejemplo ................................................................... 169Informes de gráficos de ejemplo ...................................................................... 170

6

Tabla de Contenidos

Lista de tablas

Tabla 1. Operadores .......................................................................................................... 27Tabla 2. Funciones ............................................................................................................ 28Tabla 3. Funciones ............................................................................................................ 29Tabla 4. Ejemplos de expresiones de atributos..................................................................... 30Tabla 5. Ejemplos de expresiones de atributos..................................................................... 30Tabla 6. Atributos de las reglas de contenido ...................................................................... 41Tabla 7. Valores para la etiqueta params ............................................................................ 51Tabla 8. Valores para la etiqueta params ............................................................................ 54Tabla 9. Valores para la etiqueta params ............................................................................ 56Tabla 10. Valores para la etiqueta params ............................................................................ 61Tabla 11. Atributos de los paquetes de transmisiones ............................................................ 74Tabla 12. Atributos de los métodos de envío de Syncplicity ................................................... 75Tabla 13. Parámetros de los métodos de envío Syncplicity ..................................................... 75Tabla 14. Configuración de destinos de entrega .................................................................... 78Tabla 15. Atributos del exportador....................................................................................... 79Tabla 16. Atributos del formateador de datos ....................................................................... 80Tabla 17. Controladores de mensajes.................................................................................... 85Tabla 18. Atributos ............................................................................................................. 87Tabla 19. Expresiones.......................................................................................................... 87Tabla 20. Matriz de distribución ........................................................................................ 102Tabla 21. Info. destinatario ................................................................................................ 105Tabla 22. Parámetros del complemento DistributionMatrixImportProcessing ....................... 106Tabla 23. Propiedades del correo electrónico....................................................................... 118Tabla 24. Detalles de las claves de mensajes........................................................................ 125Tabla 25. Estados del ciclo de vida de documentos internos................................................. 128Tabla 26. Documento de entrega interno: permisos de Documentum (1 de 2)........................ 129Tabla 27. Documento de entrega interno: permisos de Documentum (2 de 2)........................ 130Tabla 28. Documento de entrega interno: acciones permitidas (1 de 2).................................. 131Tabla 29. Documento de entrega interno: acciones permitidas (2 de 2).................................. 133Tabla 30. Documento de entrega interno: operaciones disponibles (1 de 2) ........................... 135Tabla 31. Documento de entrega interno: operaciones disponibles (2 de 2) ........................... 137Tabla 32. Estados del ciclo de vida de documentos externos ................................................ 138Tabla 33. Documento de entrega externo: permisos de Documentum (1 de 2) ....................... 139Tabla 34. Documento de entrega externo: permisos de Documentum (2 de 2) ....................... 140Tabla 35. Documento de entrega externo: acciones permitidas (1 de 2) ................................. 141Tabla 36. Documento de entrega externo: acciones permitidas (2 de 2) ................................. 142Tabla 37. Documento de entrega externo: operaciones disponibles (1 de 2) ........................... 143

7

Tabla de Contenidos

Tabla 38. Documento de entrega externo: operaciones disponibles (2 de 2) ........................... 144Tabla 39. Estados del ciclo de vida de documentos de correspondencia ................................ 145Tabla 40. Documento de correspondencia: permisos de Documentum (1 de 2)...................... 146Tabla 41. Documento de correspondencia: permisos de Documentum (2 de 2)...................... 147Tabla 42. Documento de correspondencia: acciones permitidas (1 de 2)................................ 147Tabla 43. Documento de correspondencia: acciones permitidas (2 de 2)................................ 149Tabla 44. Documento de correspondencia: operaciones disponibles (1 de 2) ......................... 150Tabla 45. Documento de correspondencia: operaciones disponibles (2 de 2) ......................... 150Tabla 46. Acciones permitidas ........................................................................................... 153Tabla 47. Permisos ............................................................................................................ 154Tabla 48. Permisos extendidos ........................................................................................... 155Tabla 49. Roles del sistema global definidos en Capital Projects ........................................... 156

8

Prefacio

Este documento describe cómo configurar los artefactos de EMC Documentum Capital Projects en unproyecto de Capital Projects. En esta guía no se explica cómo utilizar EMC Documentum Composerpara configurar e instalar los artefactos de Documentum como, por ejemplo, los tipos de objetos ylos tipos de aspectos.

Los comandos y los ejemplos de códigos de esta guía se han formateado para ajustarlos a la páginadel documento. Si copia los comandos y los ejemplos en su entorno, revíselos y vuelva a formatearlossi fuese necesario (por ejemplo, quite los espacios adicionales).

Público previstoEsta guía está dirigida a los administradores que han completado la formación de Capital Projects anivel de administrador y que tienen experiencia con los siguientes productos y tecnologías:• Documentum Content Server

• Documentum Webtop

• Aplicaciones, capas y personalizaciones de Documentum WDK

• Notaciones XML y XPath

Historial de revisiónFecha de revisión Descripción

Junio de 2014 Publicación inicial

9

Prefacio

10

Capítulo 1Descripción general

EMC Documentum Capital Projects forma parte del conjunto de soluciones EMC Documentum forEngineering, Plant, and Facilities Management. Capital Projects utiliza EMC DocumentumWebtop enla plataforma EMC Documentum. Capital Projects permite a las empresas de ingeniería, suministro yconstrucción (EPC, Engineering, Procurement, and Construction) y a los trabajadores autónomosde grandes instalaciones y empresas de ingeniería a controlar la documentación relacionada con laingeniería y los procesos de comunicación. Capital Projects admite:• Administración de documentos:

— Compatibilidad con la numeración automática de documentos regulados

— Modelo de seguridad configurable basado en roles que admite la comunicación interdisciplinarsegura en varios proyectos de ingeniería

— Instalación y configuración rápidas de proyectos a partir de estructuras de plantillas conreglas de negocio incrustadas

— Herencia de metadatos de carpetas, plantillas y documentos para acelerar la clasificacióny la indexación

— Compatibilidad con la edición CAD multiarchivo, incluidos los archivos XREFS, la conexiónde cuadros de rotulación y la representación en PDF de dibujos (se requiere el módulo BTMDrawbridge)

— Modelo configurable de revisión de documentos para adaptarse a los procesos habitualesde control de documentos

— Estructuras configurables de desglose de trabajo que admiten las taxonomías habituales delsector

• Revisión y aprobación:

— Flujos de trabajo basados en proyectos configurables y sencillos que admiten ciclos de vida depreparación, comprobación y aprobación habituales

— Bandeja de entrada mejorada con notificación mejorada y control de tarea

11

Descripción general

— Seguimiento completo y funcionalidad de creación de informes

— Características integradas de consolidación de comentarios

• Transmisiones:

— Las transmisiones entrantes y salientes optimizan las actividades de control de documentos alenviar documentos a entidades externas y recibirlos de estas, a la vez que proporcionan unapista de auditoría completa de las actividades

— Las matrices de distribución se pueden configurar fácilmente para admitir los patronesde distribución repetitivos en función de los requisitos del contrato y de los metadatos dedocumentos

— Las matrices de distribución se pueden importar mediante una plantilla de hoja de Excel

— Las portadas de transmisión se rellenan automáticamente y son configurables

— La solución admite la notificación de correo electrónico y el envío mediante archivo zip

— Proporciona informes precisos sobre el estado de transmisión

• Carga masiva y exportación empaquetada:

— Carga de documentos automatizada de contenido a través de plantillas masivaspreconfiguradas que se adhieren a las reglas de herencia, contenido y numeración

— La biblioteca de exportación exporta rápidamente la estructura de carpetas, los documentosy los metadatos para los procesos de entrega contractuales

— El front-end HTML permite la exploración sin conexión y la visualización de la estructuraexportada y del contenido

• Seguimiento del progreso:— Plantillas de planificación configuradas con hitos para automatizar el seguimiento del

progreso del documento

— Los iconos gráficos indican el progreso en comparación con los documentos

— Los usuarios pueden importar y exportar la información de progreso

• Entrega:— Los documentos se pueden marcar para la entrega a los sistemas de destino y publicarse en la

ubicación de exportación configurada junto con los metadatos

— Admite la entrega de documentos

Conceptos clave de Capital ProjectsEntre los conceptos clave de Capital Projects se incluyen:

• Proyectos, página 13

• Estructuras xBS, página 14

• Configuraciones del proyecto compartidas, página 13

• Administración de documentos, página 14

• Comentarios, página 14

12


• Procesos de acción, página 15

• Transmisiones, página 15

• Entrega, página 16

• Matrices de distribución, página 17

• Carga de documentos, página 18

• Informes, página 19

• Planificación\Progreso de documentos, página 20

• Conceptos adicionales, página 20

Proyectos

Los proyectos son los contenedores de nivel superior (carpetas) que se configuran mediante lasdistintas opciones. La configuración define la estructura de carpetas del proyecto y los artefactos quese pueden crear en las subcarpetas.

Las áreas del proyecto almacenan y administran la documentación generada o recibida para undeterminado proyecto de ingeniería. El sistema proporciona la capacidad de crear, configurar yutilizar las áreas del proyecto.

Cada área del proyecto en el sistema tiene sus propias opciones de configuración. Las opcionesde configuración determinan la manera en que funcionará un área específica de un proyecto. Porejemplo:• Definen los artefactos creados dentro del área del proyecto. Por ejemplo: estructuras, documentos,

transmisiones, matrices de distribución e informes.

• Definen la información que se grabará y mostrará para cada tipo de artefacto.

• Definen la taxonomía utilizada para los artefactos dentro del área del proyecto.

• Definen los esquemas de numeración, las convenciones de nomenclatura y la asistencia de valorpara los artefactos dentro del área del proyecto.

• Definen las configuraciones que se utilizarán para admitir la carga de documentos dentro del áreadel proyecto (se utiliza para cargar documentos de forma masiva a la vez).

Capital Projects se instala con una configuración de plantilla del proyecto única. Según los requisitosdel negocio, esta configuración puede modificarse y exportarse, o bien modificarse e importarsecomo una nueva configuración. El sistema no se limita a las plantillas de configuración del proyectodefinidas previamente. Capital Projects permite a los administradores de sistema crear plantillasadicionales del proyecto después de que el sistema comience a ejecutarse.

Configuraciones del proyecto compartidas

Los artefactos reutilizables habituales como las plantillas de documento, las plantillas de informey los valores de la lista desplegable se pueden crear en un área de configuración del proyecto

13


compartida denominada EIFSHD. Puede utilizar estos artefactos en diferentes configuraciones delproyecto. No puede clonar esta configuración del proyecto compartida.

Estructuras xBS

Capital Projects le permite crear las siguientes estructuras de desglose dentro de un área de trabajodel proyecto:

• Estructura de desglose de trabajo: define los elementos de trabajo discretos de los proyectos.

• Estructura de desglose de activos: define la subdivisión del proyecto en distintos sistemasy subsistemas.

• Estructura de desglose de entrega: organiza la documentación del proyecto para la fase deentrega del mismo.

Administración de documentos

Un tipo de documento y una plantilla de documento permiten a los usuarios crear documentos. Eltipo de documento es el objeto de configuración de repositorio que define las siguientes opciones:• Perfil de seguridad

• Ciclo de vida

• Estados disponibles

• Ubicaciones donde los usuarios finales pueden crear documentos

• Convenciones de nomenclatura y numeración

• Atributos que los usuarios finales pueden mostrar u ocultar

La plantilla de documento proporciona los valores de atributo y contenido de los documentos quelos usuarios finales crean. Por ejemplo, los usuarios finales pueden crear documentos de contratoa partir de una plantilla de contrato de Microsoft Word. Se puede enlazar un tipo de documento avarias plantillas de documento.

Comentarios

Capital Projects proporciona las siguientes características de comentarios:• Permite a los usuarios finales realizar comentarios en los documentos del sistema. Al hacer un

comentario en un documento, un usuario final puede describir el comentario textualmente oadjuntar un archivo externo al comentario, o ambos.

• Permite realizar comentarios para avanzar por un ciclo de vida que indica los comentarios nuevos,abiertos, cerrados y rechazados. El estado de un comentario identifica los comentarios querequieren una acción por parte del preparador, revisor o aprobador del elemento.

• Consolida los comentarios para un rol de revisor principal durante una transmisión de revisión.

14


• Permite a los usuarios finales responder a los comentarios. El sistema mantiene y muestracomentarios y respuestas en un único hilo. El sistema mantiene un hilo de comentarios conun estado único.

• Si ha integrado Brava con el sistema, los usuarios finales pueden agregar marcas en el documentoy guardar las copias correspondientes como comentarios.

Procesos de acción

Los procesos de acción de Capital Projects definen la secuencia de actividades que realizan losusuarios finales en un conjunto de documentos y los cambios que experimentan los documentosdurante los procesos. Puede definir los estados del ciclo de vida y los participantes del proceso. Losprocesos le permiten comprobar la exactitud de los documentos. La siguiente tabla describe losprocesos:

En un proceso de preparación, comprobación y aprobación (PVA, Prepare, Verify and Approve), cadaciclo consta de un remitente que inicia y controla el ciclo mediante la definición de los siguientesparticipantes:• Preparadores: preparan el documento.

• Comprobadores: revisan y comprueban el documento o lo rechazan. Capital Projects devuelve eldocumento rechazado a los preparadores para que tomen las medidas correspondientes.

• Aprobadores: aprueban el documento o lo rechazan. Capital Projects devuelve el documentorechazado a los preparadores para que tomen las medidas correspondientes.

Capital Projects registra el nombre del participante que lleva a cabo una acción, así como la fecha y lahora en las que esta sucedió.

En un proceso de aprobación, cada ciclo consta de un remitente que inicia y controla el ciclo mediantela definición de los siguientes participantes:• Preparadores: preparan el documento.

• Aprobadores: aprueban el documento o lo rechazan. Capital Projects devuelve el documentorechazado a los preparadores para que tomen las medidas correspondientes.

Transmisiones

El servicio de transmisión de Capital Projects permite a los controladores de documentos colaborarde forma segura en las actividades de control de documento con las partes externas. El serviciode transmisión proporciona un proceso estándar para definir y administrar una transmisión, sucontenido, los destinatarios, el proceso de revisión, la pista de auditoría y los medios de distribución.

Los controladores de documentos pueden crear las siguientes transmisiones:• Transmisión general: se envían documentos a partes externas y se reciben de estas.

• Transmisión de entrada: se registra la recepción de un documento de una parte externa.

• Transmisión de revisión: se inicia y se administra la revisión de documentos y el ciclo decomentarios.

15


Capital Projects utiliza la numeración automática para identificar las transmisiones y realizar unseguimiento de ellas. Las transmisiones realizan un seguimiento y registran confirmaciones,respuestas, retrasos y fechas de vencimiento definidas. Capital Projects registra las fechas derespuesta y las de finalización de la transmisión.

Los controladores de documentos pueden crear transmisiones a partir de las ya existentes. Porejemplo:• Una transmisión de entrada a partir de una transmisión general

• Una transmisión general a partir de una transmisión de entrada

• Una transmisión general a partir de una transmisión general

• Una transmisión general a partir de una transmisión de revisión

• Una transmisión de revisión a partir de una transmisión de entrada

Capital Projects genera hojas de registro para las transmisiones de revisión en lugar de portadas. Lahoja de registro contiene información acerca de la transmisión de revisión y los participantes, así comode los documentos adjuntados a la transmisión. Los usuarios pueden descargar los archivos PDF delas hojas de registro desde la pestaña Contenido en el componente de propiedades de una transmisiónde revisión. Capital Projects genera hojas de registro para una transmisión de revisión cuando:• La revisión se inicia.

• El usuario solicita una hoja de registro durante la revisión. Capital Projects reemplaza la hoja deregistro anterior por la hoja de registro específica que ha solicitado el usuario.

• La revisión finaliza.

Puede configurar Capital Projects para que publique los paquetes de transmisión en un sitio deprotocolo de transferencia de archivos (FTP, File Transfer Protocol) o en una cuenta Syncplicitymediante Documentum Connector for Syncplicity. Capital Projects utiliza una plantillapreconfigurada en el RCF para enviar una notificación de correo electrónico a los destinatarios. Lanotificación contiene un enlace a la ubicación de FTP o a la carpeta Syncplicity. Capital Projects envíaun mensaje al Controlador de documentos si se produce un error al publicar un paquete en el sitio.

Puede configurar Capital Projects para crear automáticamente transmisiones de revisión a partir detransmisiones de entrada. Defina una lista de razones del problema por los que Capital Projectscreará las transmisiones de revisión. Si la razón del problema asociada a la transmisión de entradaestá en la lista, Capital Projects crea la transmisión de revisión. Capital Projects envía mensajesal Controlador de documentos cuando se inicia el proceso de creación y cuando se ha creado latransmisión de revisión.

Capital Projects admite la creación de varias transmisiones de revisión al aplicar una matriz dedistribución a un conjunto de documentos. En función de las múltiples opciones de distribución, losdocumentos se agrupan (según un conjunto común de destinatarios) y se agregan a una transmisiónúnica, o bien se crea una transmisión para cada documento. Puede revisar las transmisiones creadasy editarlas si existe algún problema.

Entrega

Al utilizar la función de entrega, puede transferir los documentos desde Capital Projects a otrossistemas como Asset Operations.

16


Puede realizar las siguientes tareas:• Marque o desmarque un documento para la entrega.

• Marque un documento como Listo para la entrega.

• Cree un paquete de entrega.

• Agregue los documentos que estén listos para la entrega a un único paquete de entrega válido(no cancelada).

• Para iniciar la entrega, publique los documentos junto con los metadatos en una ubicación deexportación para que los sistemas de destino los recopilen y los procesen.

• Una vez que el sistema de destino confirma la recepción de documentos, marque la entregacomo completada.

• Marque la entrega como cancelada en cualquier momento durante el ciclo de vida delpaquete de entrega antes de que se complete. Puede volver a crear otro paquete de entregay adjuntar los mismos documentos en el paquete nuevo. El sistema inmoviliza los documentosagregados a un paquete de entrega para no permitir más actualizaciones en el documento.Durante el proceso de entrega de los documentos, Capital Projects comprueba si el destino elegidoes el mismo que el origen de donde procede el documento de entrega.

Matrices de distribución

Las matrices de distribución le permiten configurar rápidamente la distribución de una transmisióno proceso de acción en función de una matriz predefinida. La matriz se puede configurar con unnúmero de condiciones de modo que pueda volver a utilizarse en otra ocasión.

Una matriz de distribución controla el modo en que Capital Projects distribuye documentos paralas transmisiones y los procesos de acción. Cuando cree una matriz de distribución, configure lassiguientes opciones:• Destinatarios

• Condiciones

• Razones de distribución

• Métodos de entrega

Capital Projects evalúa los documentos de las transmisiones y de los procesos de acción encomparación con las condiciones que defina. Si los documentos cumplen las condiciones, CapitalProjects distribuye los documentos a los destinatarios asociados a las condiciones de la matriz dedistribución.

Capital Projects crea y almacena matrices de distribución en la carpeta 05 Distribution/01.Management del área de trabajo de los proyectos. Se publicará una matriz de distribución a travésdel menú Herramientas antes de que esté disponible para las transmisiones y los procesos de acciónen el proyecto.

También puede importar una matriz de distribución configurada en una hoja de Excel con la plantillaespecificada. Esto ayuda a evitar la creación de matrices de distribución similares para cada proyecto.

17


Carga de documentos

Una hoja de cálculo de carga de Microsoft Excel permite a un usuario final crear varios documentoso actualizar varios documentos. La hoja de cálculo contiene los metadatos y las opciones de losdocumentos. La hoja de cálculo contiene una referencia al archivo requerido para cada fila de la hojade cálculo. El sistema busca los archivos que se utilizan como contenido de los documentos cargadosen función de una ubicación de red definida en el RCF.

Las opciones de carga de documentos controlan una única operación de carga en el sistema. Lasopciones de carga de documentos residen en el sistema y son específicas del proyecto. Las opcionesse crean en la carpeta 07. Carga/01. Documentos del área de trabajo del proyecto. Las opcionescontrolan:• El tipo de documento (Tipo de documento) que crea o actualiza la operación de carga.

• La asignación de las columnas de la hoja de cálculo en las propiedades del documento, lasopciones del documento y los archivos de contenido del documento.

• El modo en que el sistema procesa cada fila de la hoja de cálculo. Por ejemplo, procese algunasfilas como documentos nuevos y otras como actualizaciones de documentos.

• La hora en la que se ejecuta la operación de carga. Por ejemplo, planifique su ejecución en esemomento o en las horas de menor demanda.

Configure las opciones de carga de los documentos según las plantillas de cada proyecto. Lasplantillas definen (y bloquean, si fuera necesario) algunas de las opciones descritas anteriormente.Las plantillas han establecido un estándar de proyecto para la carga de documentos. No es necesariodefinir las opciones cada vez que se realiza una operación de carga de documentos. Cada operaciónde carga de documentos sigue una ruta lineal desde la creación hasta la finalización (carga completa).La ruta lineal se describe a continuación:• Creación: se crea el objeto de la carga de documentos, la hoja de cálculo se rellena.

• Validación: el sistema valida el contenido de la hoja de cálculo.

• Operación completada: la operación de carga de documentos se ha realizado y el sistema seha actualizado.

Se puede revisar y volver a realizar una operación de carga de documentos completada. Cuandose vuelve a realizar una operación de carga de documentos, el sistema permite al usuario agregarnuevas filas para su procesamiento.

Al repetir la operación de carga de documentos en una carga completada, se sigue la misma rutalineal a excepción de que la fase Creación pasa a denominarse Edición. Las operaciones de carga dedocumentos completadas se almacenan en el sistema y representan la configuración de la carga dedocumentos utilizada para controlar dicha operación. Una configuración de carga de documentosregistra la información sobre la operación que controla:• El número de veces que la operación se ha realizado o validado.

• La fecha y hora de la última operación.

• El nombre del último usuario que realizó la operación.

• El tiempo total necesario para realizar la última operación.

18


• El número total de realizaciones de la validación incorrectas o correctas desde la última vezque se realizó la operación.

• El número total de realizaciones del proceso incorrectas o correctas desde la última vez que serealizó la operación.

El sistema registra los resultados de la validación y del procesamiento de la operación de cargadentro de la hoja de cálculo que contiene los datos de origen para la operación. El sistema almacenaesta hoja de cálculo. El usuario puede utilizar la configuración de la carga de documentos pararecuperar la hoja de cálculo.

Informes

Los informes se componen de los siguientes elementos:• Plantilla de informe: define el contenido, el diseño y las opciones de planificación del informe.

• Parámetros en tiempo de ejecución: proporciona filtros para controlar el contenido y el destinodel informe.

• Informe: los resultados de la ejecución del informe.

El sistema proporciona un marco de informes Jasper extendible que permite crear plantillasde informe. Puede realizar consultas y crear informes sobre los metadatos del documento, lastransmisiones, los procesos de distribución y los registros de eventos de auditoría de negocios.

Los informes se pueden ejecutar a petición o se pueden planificar para que se ejecuten en una fecha,hora y frecuencia determinadas. La pertenencia a un rol en la plantilla de informe permite controlarla capacidad de un usuario individual para ejecutar un informe.

Para ejecutar un informe a petición, el usuario final selecciona una plantilla de informe desde lacarpeta del proyecto 08 Informes/01. Plantillas y, a continuación, selecciona Herramientas > Ejecutarinforme. El sistema abre el primer cuadro de diálogo de parámetros de tiempo de ejecución quemuestra los parámetros de metadatos definidos en la plantilla de informe. Tras seleccionar Siguiente,el sistema abre un segundo cuadro de diálogo que muestra las opciones de salida de informe tal comose define en la plantilla de informe. Por último, el usuario selecciona Ejecutar para ejecutar el informe.

Para planificar un informe para ejecutarlo en una fecha y hora determinadas, el usuario seleccionauna plantilla de informe y ve las propiedades.• Pestaña Planificación: establece la información de planificación como, por ejemplo, la fecha

y la frecuencia.

• Pestaña Parámetros de planificación: establece los parámetros del informe que predefinen losvalores de los parámetros que se aplicarán al ejecutar el informe.

19


Planificación\Progreso de documentos

La opción Planificación\Progreso realiza un seguimiento del progreso de los documentos. Puedeconfigurar las siguientes opciones de planificación para un documento:• Planificación basada en esfuerzos: muestra el tiempo que se tarda en completar el proceso y el

número de días que quedan para la finalización.

• Planificación basada en progreso: plantilla que define un conjunto de eventos del documento quese producen, así como el porcentaje completado o el peso atribuido a cada evento. Las plantillas secrean en el área de configuración del proyecto para cada proyecto.

Los usuarios finales establecen la fecha de inicio del seguimiento del progreso. Los usuarios finalespueden habilitar o deshabilitar la planificación para cada documento, o bien establecer la plantillade progreso de planificación predeterminada para los tipos de documentos que se aplicará en lacreación de cada instancia del documento.

Los usuarios finales pueden aplicar la planificación a los documentos en todos los estados del ciclo devida excepto en los siguientes estados: anulado, cancelado y sustituido.

Administración de correspondencia

Capital Projects admite la creación de documentos de correspondencia que se clasifican comoCorrespondencia de entrada y Correspondencia de salida. Si los mensajes de correo electrónicose importan al sistema, Capital Projects agrega los valores de algunas de las propiedades de correoelectrónico como Asunto, Para, De, CC y fecha del correo electrónico enviado a las propiedadescorrespondientes en el documento.

Conceptos adicionales

Capital Projects también ofrece:• Autonumeración: proporciona una manera de generar los valores de acuerdo con una secuencia

de números para utilizarlos con respecto a los valores de atributo.

• Autonomenclatura: rellena automáticamente los nombres de los documentos, de las carpetas y delos otros objetos creados en el sistema Capital Projects.

• Control de acceso basado en roles: oculta el sistema de permisos de LCA subyacente utilizadoen Documentum; en lugar de ello, el control de acceso se define en términos de roles denegocio configurables que sean significativos para el negocio y en el contexto de los procesos yprocedimientos empresariales. Las listas LCA subyacentes se administran mediante las opcionesdel Perfil de seguridad:

— Los perfiles de seguridad asignan los miembros de rol a los valores de permisos de la LCA.

— El equipo Configuración técnica configura dichos perfiles en el archivo de configuración derepositorio (RCF, Repository Configuration File): Configuración de negocio. Los usuarios

20


seleccionan el perfil de seguridad adecuado que desean utilizar para cada tipo de documento otipo de carpeta y, a continuación, configuran los roles predeterminados según sea necesario.

— No es necesario que los usuarios finales tengan información sobre ellos.

• Herencia y propagación de atributos: se utiliza para propagar los valores de atributo desde lascarpetas que los contienen hasta los documentos.

• Listas desplegables para asistencia de valor: proporciona un modo sencillo de agregar o eliminarlos valores de asistencia de valor.

• Reglas de contenido: proporciona un modo de especificar o restringir qué objetos puedencrearse y dónde.

• Relleno automático de atributos: proporciona un modo de rellenar un valor de atributo con unvalor de otro atributo o con una combinación de valores de atributo.

21


22

Capítulo 2Configurar

Esta sección incluye información conceptual importante, así como tareas para diseñadoresexperimentados de la aplicación Capital Projects para que las realicen una vez instalado el producto.Utilice estos conceptos y estas tareas para configurar la aplicación para su uso en un procesoempresarial.

Estos son los temas que se incluyen en esta sección:• Introducción para archivo de configuración de repositorio (RCF, Repository Configuration File),

página 24

• Entender las expresiones de atributos, página 24

• Configurar los documentos, página 32

• Configurar los tipos de carpeta, página 36

• Configurar la autonumeración, página 43

• Configurar las convenciones de nomenclatura, página 46

• Configurar el relleno de atributos automático, página 47

• Configurar las listas desplegables dinámicas, página 49

• Configurar las transmisiones, página 64

• Configurar perfiles de seguridad, página 88

• Configurar un tipo de proceso de acción, página 94

• Configurar una matriz de distribución, página 98

• Configurar copias, página 107

• Configurar la carga de documentos, página 109

• Configurar el progreso de la planificación, página 115

• Controlar el acceso al contenido de Asset Operations, página 117

• Configuración de formatos de fecha y hora, página 31

23

Configurar

Introducción para archivo de configuraciónde repositorio (RCF, Repository ConfigurationFile)El archivo de configuración de repositorio (RCF, Repository Configuration File) es un archivo XMLcon el que se configura Capital Projects a un nivel técnico. En general, el RCF configura CapitalProjects para un conjunto determinado de aplicaciones mediante una arquitectura de informacióncomún.

El RCF incluye las reglas de herencia de atributos, los perfiles de seguridad, las accionesrelacionadas con el ciclo de vida, los complementos y otras opciones de Capital Projects. Losadministradores (usuarios privilegiados) pueden actualizar el RCF; para ello solo tienen que buscarRCF-Schema.xml. Para obtener información sobre las mejores prácticas, así como sobre los modosde administrar e implementar el RCF, consulte el documento EMC Documentum Capital Projects SDKGuide (Guía de EMC Documentum Capital Projects SDK). Esta guía se centra en la manipulacióndel contenido del RCF.

Para instalar y activar manualmente una nueva versión del RCF:1. Retire el archivo /ECSCONFIG/Application Configuration/RCF/RCF-schema.xml.

(Busque RCF-Schema.xml en Documentum Administrator).

2. Edite localmente el archivo XML mediante una herramienta de creación para realizar los cambiosnecesarios.

3. Guarde los cambios.

4. Registre el archivo XML revisado:

a. Como la misma versión que la versión actual, en cuyo caso se conserva el estado del ciclo devida.

b. Como una nueva versión, que se registra como una versión En preparación.

Nota: Compruebe el estado del ciclo de vida del nuevo archivo RCF. Si el estado del ciclode vida es En preparación, promuévalo para activarlo. Inicie sesión como Superusuarioo desde Documentum Administrator para promocionarlo. (Las operaciones del ciclo devida estándar no están disponibles para los que no sean superusuarios en Webtop). Paraevitar este paso, registre los cambios del RCF como la misma versión que la versión activaactual. Sin embargo, esta opción limita su capacidad para revertir los cambios a menos quemantenga una copia local.

5. Inicie sesión en la aplicación Capital Projects como administrador de configuración o comocontrolador de documento y, a continuación, seleccioneHerramientas -> Releer configuración deRCF para actualizar el RCF inmediatamente.

Entender las expresiones de atributosUna expresión de atributo indica una propiedad variable o un atributo de un objeto. Capital Projectsutiliza las expresiones de atributos para calcular valores sobre la marcha, en los parámetros de

24

Configurar

complementos, en las operaciones de creación de instancias de objetos y en otros escenarios como,por ejemplo, la autonumeración. Por ejemplo:<rcf><global_params>...<param name="incoming_folder" value="/PROJECTS/${project.object_name}/05. Distribution/02. Incoming Transmittals"/>...</global_params>...</rcf>

Cuando se utilizan en la sección de parámetros globales del RCF como el que se muestra más arriba,el valor del parámetro incoming_folder se extrae sustituyendo el valor del contexto del valorobject_name del objeto del proyecto actual de la expresión. Por lo tanto, si el valor object_namedel proyecto es Mi proyecto, el valor será /PROJECTS/My Project/05. Distribution/02.Incoming Transmittals.

En general, puede hacer referencia a los atributos de varios objetos en una expresión de atributoutilizando la notación <object-predicate>.<attribute-name>|<role-name>[<value-index>]. La parte[<value-index>] es opcional; si no se especifica, y el atributo al que se hace referencia es un atributorepetido, se mostrará una lista de valores delimitada por comas. Por ejemplo, la expresiónthis.r_version_label devuelve todas las etiquetas de la versión como una lista delimitadapor comas. Por ejemplo: “1.0,CURRENT”, donde this.r_version_label[0] devuelve solo elnúmero de versión, “1.0”. Se proporciona una serie de funciones y operadores para su uso con losatributos de expresiones (descritos en esta sección); además podrá incrustar literales de cadena sifuese necesario. Por ejemplo:doc_identifier = ’SOP’ + this.doc_number

podría utilizarse para derivar un valor de atributo doc_identifier a partir de un atributodoc_number.

En el ejemplo anterior, el proyecto y estas palabras clave son ejemplos de predicados de objeto. Estosindican el objeto de repositorio que se va a consultar en cada caso, que es el objeto de contexto, o estárelacionado con este, en el cual se produce un determinado evento de Capital Projects. Por ejemplo,cuando se inicia un complemento de Capital Projects, el objeto de contexto es el objeto de repositorioen el que se produce el evento; y cuando se crea una instancia de un documento, el objeto de contextoes la nueva instancia del documento. Los predicados de objetos que se admiten actualmente son:• this: indica el objeto de contexto.

• parent: indica la carpeta principal inmediata que contiene el objeto de contexto.

• governing: indica la carpeta “principal” que contiene el objeto de contexto (que puede encontrarseen la parte superior del árbol de carpetas).

• documenttype: para las instancias de documentos, indica el objeto de configuración del tipo dedocumento de Capital Projects asociado con el objeto de contexto.

• foldertype: para las instancias de carpetas, indica el objeto de configuración del tipo de carpeta deCapital Projects asociado con el objeto de contexto.

• configurationarea: la carpeta de configuración de Capital Projects en la que se define el tipo dedocumento o el tipo de carpeta del objeto de contexto.

25

Configurar

• project: la carpeta del proyecto de Capital Projects que es el área de trabajo donde se crea elcontenido real mediante los tipos de configuración y las plantillas.

• ecsobjecttype: para las instancias de objetos ecs, ya sea documento o carpeta, denota el objeto deconfiguración correspondiente asociado con el objeto de contexto.

Utilizar las expresiones de atributos

Las expresiones de atributos se pueden utilizar en Capital Projects en los siguientes casos:• En la opción Valores/omisiones de atributos especiales de un objeto de configuración del tipo de

carpeta o del tipo de documento de Capital Projects, para definir los valores de atributo calculadoscuando se crean instancias de los objetos de ese tipo.

• En los parámetros de complementos del RCF, para pasar valores dependientes del contextoa un complemento.

Cuando se establecen en la definición del tipo de carpeta o documento, las expresiones de atributosse resuelven solo una vez, en el momento de creación de la carpeta o del documento nuevo. Sinembargo, puede utilizar los complementos para volver a aplicarlos automáticamente en respuestaa determinados eventos. Al crear las instancias de objetos, la herencia de atributos funciona delsiguiente modo:1. Los atributos de plantilla de documento o carpeta son los que se heredan en primer lugar.

2. A continuación, se aplican los atributos que se heredan de las carpetas principales (tal y como seha definido en la sección <attribute_inheritance> del RCF).

3. Por último, se aplican las expresiones de atributos especificadas en la opción Valores/omisionesde atributos especiales del tipo de documento o del tipo de carpeta.

Estas reglas de prioridad están diseñadas para permitir que la herencia de atributos se ejecutea nivel de sistema si fuese necesario, a través de la plantilla y de la configuración del RCF. Losusuarios de la Configuración de negocio pueden beneficiarse de la función Valores/omisiones deatributos especiales para configurar opciones predeterminadas adicionales para determinadostipos de documentos o carpeta.

Utilizar las expresiones de atributos en los parámetrosde complementos

Al especificar los parámetros de complementos en los elementos <params> del RCF, las expresionesde atributos incrustados se pueden utilizar en las cadenas de valores, indicadas mediante lossímbolos delimitadores "${"..."}". Estos se resuelven automáticamente mediante el marco antesde pasarlos al complemento. Por ejemplo:<plugins>

...<plugin name="AuditStateChangeEvents"run_on_event="ecs_target_state_reached"class="com.ecsx.framework.library.plugins.AuditEventPlugin"applicable_types="document,folder"><params><param name="event" value="State changed to

26

Configurar

"${this.ecs_lc_state}""/></params>

</plugin>...

</plugins>

En este ejemplo, el parámetro de evento contiene la expresión de atributo incrustada${this.ecs_lc_state}, que se resuelve en el estado actual del ciclo de vida del objeto de contextoen cada caso.

Nota: Este mecanismo se aplica a todos los parámetros de complementos, como los complementosde acciones, los controles de validación y las condiciones previas, así como a los complementosde control de eventos.

Funciones de los atributos de un valor

La siguiente tabla resume los operadores compatibles actualmente con las expresiones de atributos deCapital Projects:

Tabla 1. Operadores

Operador Descripción

= Asignación

+= Anexar a atributo repetido

+ Suma/concatenación de cadenas

- Resta

* Multiplicación

/ División

> Mayor que

< Menor que

>= Mayor que o igual a

<= Menor que o igual a

== Equivalencia/cadena coincidente

!= No equivalencia/cadena no coincidente

AND AND lógico

OR OR lógico

! NOT lógico

Nota: Los operadores de asignación ("=" y "+=") solo se pueden utilizar en la opción"Expresiones/omisiones de atributos especiales" para los tipos de documentos y de carpeta deCapital Projects.

27

Configurar

Funciones de los atributos de un valor y de repetición

Las siguientes funciones se pueden utilizar en expresiones de atributos de Capital Projects, aplicablesa los atributos de un valor:

Tabla 2. Funciones

Función Descripción

LOWER(arg) Cambia arg a minúsculas.

UPPER(arg) Cambia arg a mayúsculas.

DATEADD(base-date, date-part, number) Agrega un número especificado de años, meses,semanas o días a la fecha base y devuelve lanueva fecha.

AFTER(date, base-date) Devuelve true si la fecha sigue a la fecha base, obien false en caso contrario.

BEFORE(date, base-date) Devuelve true si la fecha precede a la fecha base,o bien false en caso contrario.

SPLIT(arg, separator) Convierte un valor de cadena delimitado en unamatriz de cadenas.

SUBSTR(str, start, length) Devuelve una subcadena de str que comienza enel inicio de posición, enumerada desde 1, y quecomprende los caracteres de longitud.

EQUALS(str-1, str-2) Devuelve true si str-1 y str-2 son iguales; falseen caso contrario.

STARTSWITH(str, prefix) Devuelve true si str comienza por el valor deprefijo especificado, o false en caso contrario.

ENDSWITH(str, suffix) Devuelve true si str finaliza con el valor de sufijoespecificado, o false en caso contrario.

CONDITIONAL(cond, if-true, if-false) Devuelve if-true si el valor especificado cond estrue, en caso contario devuelve if-false.

ISNULL(arg) Devuelve true si arg no se ha definido o es nulo,o false en caso contrario.

HASTEXT(arg) Devuelve true si arg es un valor de cadena nonulo y no en blanco, o false en caso contrario.

QUOTE(arg) Pone arg entre comillas simples internas yduplica las comillas internas (por ejemplo, seutilizan en las consultas DQL).

INTERNAL_REQUOTE(arg) Duplica las comillas internas en arg únicamente.

SESSIONUSERNAME() Devuelve el nombre de usuario de la sesiónactual.

28

Configurar


CURRENTDATE() Devuelve la fecha actual del sistema en elformato de fecha ISO (formato DD/MM/AAAAhh:mm:ss).

DOCUMENTTYPEREF(doc-type-name/doc-type-path)

Devuelve el identificador de referencia internadel tipo de documento especificado.

FOLDERTYPENAME(folder-type-name/folder-type-path)

Devuelve el identificador de referencia internadel tipo de carpeta especificado.

REPLACE(str, find-chars, replace-chars) Reemplaza los caracteres find-chars en str porlos caracteres correspondientes en replace-chars.

REPLACE_ANY_SUBSTR(str, find-str, replace-str) Reemplaza todas las apariciones de find-str enstr por replace-str.

Nota: Los nombres de funciones no distinguen mayúsculas de minúsculas.

También se admiten las siguientes funciones para los atributos de un valor y de repetición:

Tabla 3. Funciones


LIST(str/str-array, delimiter) Transforma str, o bien todos los valores enstr-array, en una matriz de cadenas medianteun delimitador como el delimitador de artículo.(Para las cadenas de un valor, la funciónSPLIT() también se puede utilizar).

QUOTE_LIST(str/str-array, delimiter) Transforma str, o todos los valores en str-array, enuna matriz de valores de cadenas safely-quotedmediante un delimitador como el carácterdelimitador. Por ejemplo, se puede utilizar enuna cláusula DQL in(...).

CONCAT(str-array, separator) Combina todos los valores de cadenas enstr-array con una cadena única con artículosseparados por caracteres separadores.

Nota: Si se hace referencia a un atributo repetido attr sin especificar un value-index, el resultado esequivalente a CONCAT(attr, ’, ’).

Ejemplos de expresiones de atributos

La siguiente tabla muestra el uso de algunas expresiones de atributos de ejemplo, así como susresultados. Se supone que los siguientes datos de prueba se utilizan aquí:

29

Configurar

Tabla 4. Ejemplos de expresiones de atributos

Atributos de objetos de contexto Atributos de carpetas principales del objeto decontexto

Nombre de atributo Valor de atributo Nombre de atributo Valor de atributo

object_name objeto de ejemplo ecs_members[0]

ecs_members [1]

Andy

Ana

eif_area UE

eif_system[0]

eif_system[1]

RU

Noruega

ecs_authors[0]

ecs_authors[1]

Simon

Bob

Tabla 5. Ejemplos de expresiones de atributos

Nombre deatributo

Operador deasignación

Expresión Resultado:nombre deatributo

Resultado: valor

object_name = ‘new object name’ object_name nombre de objetonuevo

object_name = this.eif_area object_name UE

object_name = this.eif_system object_name RU, Noruega

object_name = this.eif_system[0] object_name RU

object_name = CONCAT(this.eif_system, ‘-‘)

object_name RU-Noruega

object_name = LOWER(this.eif_system[0])

object_name ru

object_name = this.object_name+ ’ ’ + UPPER(this.authors[1])

object_name objeto de ejemploBOB

object_name = this.eif_area + ’_’+ SUBSTR(this.object_name, 1,6)

object_name EU_sample

ecs_authors = ’John’ ecs_authors[0] John

object_name += ’John’ ecs_authors[0]

ecs_authors[1]

ecs_authors[2]

Simon

Bob

John

30

Configurar

Nombre deatributo

Operador deasignación

Expresión Resultado:nombre deatributo

Resultado: valor

object_name = parent.members ecs_authors[0]

ecs_authors[1]

Andy

Ana

object_name = parent.members ecs_authors[0]

ecs_authors[1]

ecs_authors[2]

ecs_authors[3]

Simon

Bob

Andy

Ana

Parámetros globales y expresiones de caracterescomodín de pertenencias de rol del RCF

Expresiones de caracteres comodín de pertenencias de rol del RCF:• $SESSION_USER: representa el nombre de usuario que ha iniciado sesión actualmente, se utiliza

generalmente en init_members para las pertenencias de rol.

Parámetros globales del RCF:• Los parámetros globales del RCF son aquellas variables que se definen, habitualmente al comienzo

del RCF, en la etiqueta “/rcf/global_params”.

Acceda a estos valores de parámetros en el RCF utilizando la siguiente sintaxis:— $P{PARAMETERNAME}

Por ejemplo, para definir un parámetro global agregue la etiqueta <param> del RCF en laetiqueta /rcf/global_params tal y como se muestra en el siguiente ejemplo donde “MYPARAMETER NAME” y “MY PARAMETER VALUE” representan respectivamente el nombrey el valor del parámetro que se agregarán. También puede utilizar expresiones de atributos enlos valores de parámetros globales.

Por ejemplo:<rcf>

<global_params>...<param name=”MY PARAMETER NAME” value=” MY PARAMETER VALUE”/>

</global_params>...

</rcf>

Configuración de formatos de fecha y hora

En los parámetros globales de RCF, utilice los siguientes parámetros predeterminados para actualizarla fecha y los formatos de fecha y hora:<param name="dateTimeFormat" value="dd/MM/yyyy HH:mm:ss"/>

31

Configurar

<param name="dateFormat" value="dd/MM/yyyy"/>

Los valores de los formatos de fecha y de fecha y hora deben ser compatibles con los mismos formatosdescritos en la clase java.text.SimpleDateFormat.

Si los valores de RCF son incorrectos o su formato no es compatible, los valores de dateFormat ydateTimeFormat serán los de dd/MM/yyyy y dd/MM/yyyy HH:mm:ss.

Estos parámetros trabajan junto con el parámetro de configuración local.

Configurar los documentosEn el contexto de Capital Projects, un documento se compone de dos partes:• Tipo de documento: el objeto de configuración que especifica las distintas opciones de un

documento, como el perfil de seguridad, el ciclo de vida, los estados disponibles, la ubicacióndonde se puede crear el documento, las convenciones de nomenclatura y numeración, así comolas opciones para mostrar u ocultar atributos.

• Plantilla de documento: el objeto que se clona (se copian el contenido y los atributos) paracrear documentos. Este objeto define los valores para los atributos y el contenido específicosempresariales.

Encontrará toda la información sobre los tipos de documentos de Capital Projects en la secciónCapítulo 4, Tipos de documentos clave: permisos, acciones permitidas y operaciones disponibles.

Para crear un documento, seleccione el tipo de documento y, a continuación, seleccione una de lasplantillas disponibles para ese tipo.

Estos son los temas que se incluyen en esta sección:

• Crear un tipo de documento, página 32

• Crear las plantillas de documentos, página 35

• Definir la herencia de los atributos de plantilla en el RCF, página 35

Crear un tipo de documento

Los tipos de documentos de Capital Projects no son tipos de objetos de Documentum peroproporcionan una capa de abstracción de los tipos de objetos de Documentum.

1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 01 Tipos de documentos > 01 Tipos. Seleccione Archivo > Nuevo > Tipo de documento.

32

Configurar

2. Escriba un nombre en el campo Nombre.

3. Elija el Perfil de seguridad. Las opciones se rellenan a partir de la configuración en el RCF. ElPerfil de seguridad rellena los ciclos de vida disponibles para dicho perfil.

4. Seleccione un ciclo de vida en el cuadro de lista del campo Ciclo de vida que rellena los estadosdisponibles para dicho tipo de ciclo de vida.

5. Seleccione los estados del ciclo de vida para los objetos de este tipo en el cuadro de lista delcampo Estado.

6. Seleccione las plantillas que desea utilizar para este tipo en el cuadro de lista del campo Plantillas.

7. Para crear objetos de este tipo en el área de trabajo del proyecto Archivo > Nuevo > Documento,seleccione la casilla de verificación Usar en operaciones Archivo/Nuevo/Documento.

8. Para crear objetos de este tipo en el área de trabajo del proyecto Archivo > Importar, seleccione lacasilla de verificación Usar en operaciones Archivo/Importar.

9. Para permitir la creación de este tipo de documento en las carpetas de Documentum, comodm_cabinet y dm_folder, seleccione la casilla de verificación Permitir creación en carpetasestándar.

10. Para permitir la creación de este tipo de documento en cualquier carpeta, seleccione la casilla deverificación Permitir creación en cualquier sitio.

33

Configurar

11. El atributo Autofiler Path debe dejarse en blanco y no se admite. Se quitará de futurasversiones.

12. Para restringir a los usuarios a un conjunto predefinido de nombres al crear los objetos dedocumento, haga clic en Editar para Convenciones de nomenclatura.

13. Para especificar los atributos que no se muestran en la ventana de propiedades de las instanciasde este tipo de documento, haga clic en Editar para Atributos ocultos.

14. Para especificar los atributos que se muestran en la ventana de propiedades de las instancias deeste tipo de documento, haga clic en Editar para Atributos obligatorios.

15. Para especificar los atributos que se muestran de solo lectura en la ventana de propiedades de lasinstancias de este tipo de documento, haga clic en Editar en Atributos de solo lectura.

16. Para especificar que los objetos creados mediante este tipo sigan una configuración deautonumeración, haga clic en Editar para Configuración de numeración.

17. Para rellenar los atributos en función de los valores de otros atributos de este objeto, haga clic enEditar para Configuraciones de relleno de atributos.

18. Para especificar la lista de tipos de carpetas y el número de tales carpetas a las que se puedeenlazar el objeto, haga clic en Editar para Reglas de enlace. En el siguiente ejemplo, se puedenenlazar los objetos de este tipo a un máximo de una carpeta del tipo WBS Folder y a un máximode dos carpetas del tipo Carpeta de ABS:

19. Utilice Aspectos predeterminados para definir qué aspectos pueden adjuntarse a los objetos deldocumento en el momento de su creación. Un aspecto es un artefacto de documento que secrea mediante Composer.

20. Para deshabilitar el control de versiones de este tipo de objetos, seleccione la casilla de verificaciónDesactivar control de versiones. Esta opción significa que cuando se guarda un objeto de estetipo, se sobrescribe una versión N y no se crea una nueva versión.

21. Para deshabilitar el control de versiones de las versiones no actuales de este tipo de objetos,seleccione la casilla de verificación Desactivar control de versiones de la versión no actual.Esta opción significa que puede utilizar una versión de un objeto actual pero no de una versiónanterior.

22. Para deshabilitar la bifurcación de este tipo de objetos, seleccione Desactivar bifurcación. Estaopción significa que no se puede crear una versión entre las dos versiones existentes.

23. Para permitir que los objetos de este tipo dispongan de las opciones Planificación/Progreso, hagaclic en Editar y, a continuación, seleccione Habilitar planificación de documentos o Habilitarprogreso basado en esfuerzos.

34

Configurar

Crear las plantillas de documentos1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 01 Tipos de documentos > 02 Plantillas. Cree plantillas sin contenido utilizando Archivo >Nuevo > Documento, o bien mediante Archivo > Importar plantilla de documento.

2. Escriba un nombre para la plantilla en el campo Nombre.

3. Seleccione el tipo de objeto que desea utilizar para esta plantilla en el campo Tipo.

4. Especifique los valores predeterminados que desee proporcionar a los atributos, de modo que secopien para las instancias de documento creadas mediante esta plantilla.

Nota: Para volver a utilizar las configuraciones del proyecto en varios proyectos, EMC recomiendacrear las plantillas de documento en la configuración del proyecto compartida (EIFSHD).

Definir la herencia de los atributos de plantilla en el RCF

La herencia de los atributos de plantilla proporciona los valores de atributo si utiliza las opcionesArchivo > Importar en sincronización con los atributos que se copiaron a partir del objeto de plantillacuando crea un documento (Archivo > Nuevo > Documento). Por ejemplo, el siguiente códigodefine la herencia de los atributos en el RCF:

<template_attribute_inheritance>

<!DESCRIPTION: Defines the attributes which shouldbe copied from a template to a new instance of anobject when the object is created using webtop import.Normal creation makes a copy of the template but importingdoesn’t do this>

<!base eif document type>

<doc_object_type name="eif_doc"><attr name="object_name" /><attr name="title" /><attr name="eif_issue_reason" /><attr name="eif_type_of_doc" /><attr name="eif_originator" /><attr name="eif_responsible" /><attr name="eif_discipline" />

</doc_object_type>

1. Cuando crea una plantilla del tipo de objeto “XXXX”, a continuación tiene que definir losatributos para ese tipo de objeto “XXXX” en la etiqueta template_attribute_inheritancedel RCF. Por ejemplo:

<doc_object_type name=”XXXX”><attr name=”X_attr1”/><attr name=”X_attr2”/><attr name=”X_attr3”/><attr name=”X_attr4”/>

</doc_object_type>

35

Configurar

2. Si un tipo de objeto “YYYY” amplía otro tipo de objeto personalizado, como “XXXX”, para elque ya se ha definido una configuración de herencia de atributos de plantilla, utilice el atributoextends para copiar los dos conjuntos de atributos para el supertipo y el subtipo. Por ejemplo:

<doc_object_type name=”YYYY” extends=”XXXX”><attr name=”Y_attr1”/><attr name=”Y_attr2”/><attr name=”Y_attr3”/><attr name=”Y_attr4”/>

</doc_object_type>

Configurar los tipos de carpetaLos tipos de carpeta representan las clases lógicas de las carpetas que son significativas parael negocio. Una vez especificados, se crean las definiciones de los tipos de carpeta que estánrelacionadas con el contexto de una unidad/función o departamento de negocio, a continuación sepuede configurar la política empresarial que determina el comportamiento de esa carpeta.

Al igual que los tipos de documentos, los tipos de carpeta también pueden disponer de plantillas,ciclos de vida, perfiles de seguridad, convenciones de nomenclatura y omisiones de atributosque controla automáticamente Capital Projects. Las carpetas de Capital Projects se crean comodocumentos: especifique el nombre de la carpeta y seleccione el tipo de carpeta, la plantilla, el ciclode vida y el estado inicial (según sea necesario). En comparación con un tipo de documento, lasfunciones adicionales que posee un tipo de carpeta de Capital Projects son:• Los usuarios pueden definir el tipo de carpeta como: Controlada o Principal. Una carpeta

Principal controla su propia seguridad y la seguridad de todas las subcarpetas que contengaque no sean principales. Las subcarpetas que no son principales se clasifican como carpetasde tipo Controlada.

• Los usuarios pueden definir las Reglas de contenido que se aplicarán a las carpetas que desee.Las reglas de contenido definen qué tipo de objetos puede contener una carpeta y qué rolespueden crear estos objetos.


• Crear un tipo de carpeta, página 37

• Crear una plantilla de carpeta, página 38

• Configurar las carpetas principales y controladas, página 39

• Configurar las reglas de contenido para las carpetas, página 39

• Configurar las reglas de contenido de carpetas en el RCF, página 41

• Crear una carpeta subordinada, página 41

• Definir la herencia de los atributos de carpeta en el RCF, página 42

36

Configurar

Crear un tipo de carpeta1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 02 Carpetas > 01 Tipos y seleccione Archivo > Nuevo > Tipo de carpeta.

2. Escriba un nombre en el campo Nombre y seleccione un perfil de seguridad en el cuadro delista Perfil de seguridad.Las opciones del perfil de seguridad se rellenan a partir de la configuración en el RCF.

3. Para utilizar la seguridad de la carpeta como la seguridad de las subcarpetas que crean losusuarios dentro de la carpeta, seleccione Está controlando.

4. Haga clic en Editar, seleccione una plantilla para el tipo de carpeta y, a continuación, haga clic enSiguiente.

5. Para permitir que los usuarios creen objetos de carpeta en el área de trabajo del proyecto a travésdel menúArchivo > Nuevo > Carpeta, seleccioneUsar en operaciones “Archivo/Nuevo/Carpeta”.

6. Para permitir que los usuarios creen el tipo de carpeta en las carpetas de Documentum, como lostipos dm_cabinet y dm_folder, seleccione Permitir creación en carpetas estándar.

7. Para permitir el uso de un nombre predefinido para los objetos de carpetas que los usuarios crean,haga clic en Editar junto a la Convención de nomenclatura y defina la convención. Si deseaobtener más información, consulte la sección sobre la opción Convención de nomenclatura.

8. Para ocultar los atributos de la ventana de propiedades para las instancias del tipo de carpeta,haga clic en Editar junto a los Atributos ocultos y seleccione los atributos.

9. Para mostrar los atributos obligatorios de la ventana de propiedades para las instancias del tipode carpeta, haga clic en Editar junto a los Atributos obligatorios y seleccione los atributos.

10. Para especificar los atributos que son de solo lectura de la ventana de propiedades para lasinstancias del tipo de carpeta, haga clic en Editar junto a los Atributos de solo lectura y seleccionelos atributos.

11. Para aplicar la autonumeración a los objetos que los usuarios crean a partir del tipo de carpeta,haga clic en Editar junto a la Configuración de numeración y seleccione una configuración.Si desea obtener más información, consulte la sección sobre la opción Configuración denumeración.

12. Para rellenar los atributos de carpetas basados en los valores de otros atributos del objeto, hagaclic en Editar junto a las Configuraciones de relleno de atributos y defina las configuraciones.Si desea obtener más información, consulte la sección sobre la opción Configuraciones derelleno de atributos.

13. Para especificar la lista de los tipos de carpeta y el número de dichas carpetas a las que los objetosde la carpeta se pueden enlazar, haga clic en Editar junto a las Reglas de enlace y defina dichasreglas de enlace.

14. Utilice Aspectos predeterminados para definir qué aspectos pueden adjuntarse a los objetosde la carpeta en el momento de su creación. Un aspecto es un artefacto de documento que secrea mediante Composer.

37

Configurar

15. Configure las opciones de contenido de carpeta:• Heredar reglas de contenido principal: especifica que la carpeta heredará las reglas de

contenido de la carpeta principal. Si se selecciona esta opción, el sistema ignora las reglas decontenido definidas para la carpeta y aplica los roles de contenido de la carpeta principal.

• Tipos de documentos específicos: define los tipos de documentos que los usuarios puedencrear en la carpeta.

• Tipos de subcarpetas específicos: define los tipos de carpeta que los usuarios puedencrear en la carpeta.

• Tipos de objetos de configuración: define los tipos de configuración específicos, como laconfiguración de numeración, el atributo automático y la configuración de relleno, que losusuarios pueden crear en la carpeta.

• Detener creación de nuevos documentos para roles: especifica los roles que no pueden crearnuevos documentos en la carpeta.

• Detener creación de nuevas carpetas para roles: especifica los roles que no pueden crearcarpetas dentro de la carpeta.

Crear una plantilla de carpeta1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 02 Carpetas > 02 Plantillas.


3. Seleccione el tipo de carpeta que desea utilizar para esta plantilla en la lista desplegable Tipo.

4. Haga clic en Siguiente.

5. Configure las opciones de contenido de carpeta:• Heredar reglas de contenido principal: especifica que la carpeta heredará las reglas de

contenido de la carpeta principal. Si se selecciona esta opción, el sistema ignora las reglas decontenido definidas para la carpeta y aplica los roles de contenido de la carpeta principal.

• Tipos de documentos específicos: define los tipos de documentos que los usuarios puedencrear en la carpeta.

• Tipos de subcarpetas específicos: define los tipos de carpeta que los usuarios puedencrear en la carpeta.

• Tipos de objetos de configuración: define los tipos de configuración específicos, como laconfiguración de numeración, el atributo automático y la configuración de relleno, que losusuarios pueden crear en la carpeta.

• Detener creación de nuevos documentos para roles: especifica los roles que no pueden crearnuevos documentos en la carpeta.

• Detener creación de nuevas carpetas para roles: especifica los roles que no pueden crearcarpetas dentro de la carpeta.

6. Haga clic en Aceptar.

38

Configurar

Configurar las carpetas principales y controladas1. Vaya a la carpeta Proyectos > (carpeta del proyecto) del proyecto correspondiente en el área de

configuración del proyecto.

2. Seleccione Archivo > Nuevo > Carpeta para crear un tipo de carpeta raíz.

3. Para establecer la carpeta como Principal:

a. En la pestaña Crear, seleccione la casilla de verificación Establecer carpeta como áreaprincipal.

b. Haga clic en Finalizar.

Nota: Para establecer una carpeta existente como Principal, haga clic con el botón derecho delratón en la carpeta y seleccione Establecer como área principal en el menú contextual.

4. Para establecer la carpeta como Controlada:

a. En la pestaña Crear, seleccione la casilla de verificación Establecer carpeta como áreaprincipal.

b. Haga clic en Finalizar.

c. Seleccione la nueva carpeta del proyecto correspondiente en el área de configuración delproyecto y haga clic con el botón derecho del ratón.

d. En el menú contextual, seleccione Establecer como área controlada.

Configurar las reglas de contenido para las carpetas1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 02 Carpetas > 01 Tipos.

39

Configurar

2. Seleccione un tipo de carpeta.

3. Haga clic con el botón derecho y seleccione Propiedades.

4. Para configurar las Reglas de contenido, haga clic en Editar para las siguientes opciones:• Tipos de documentos específicos: define los tipos de documentos específicos que se pueden

crear en esta carpeta.

• Tipos de subcarpetas específicos: define los tipos de carpeta específicos que se puedencrear en esta carpeta.

• Tipos de objetos de configuración: define los tipos de configuración específicos, como laconfiguración de numeración, el atributo automático y la configuración de relleno, quese pueden crear en esta carpeta.

• Detener creación de nuevos documentos para roles: especifica los roles que no puedencrear nuevos documentos en esta carpeta.

• Detener creación de nuevas carpetas para roles: especifica los roles que no pueden crearcarpetas dentro de esta carpeta.

• Heredar reglas de contenido principal: especifica que las reglas de contenido definidas enla carpeta principal se utilizan para esta carpeta. Si se selecciona esta opción, se ignoran lasreglas de contenido definidas en esta carpeta y se aplican las reglas de contenido principalúnicamente.

5. Haga clic en Aceptar para guardar el objeto.

Nota: Como todos los miembros del proyecto (grupo XXX_project) forman parte del rolConsumidores, para evitar que un rol cree documentos o carpetas en una carpeta, debe agregartambién el rol Consumidores a los atributos Detener creación de nuevos documentos para roles yDetener creación de nuevas carpetas para roles, respectivamente.

40

Configurar

Configurar las reglas de contenido de carpetas en elRCF

El elemento <containment_rules> del archivo RCF define cómo y cuándo se aplican las reglasde contenido a las carpetas.

<containment_rulesenforce_from_folder_types="false"enforce_on_copy="true"enforce_on_move="true"enforce_on_link="true"/>

Tabla 6. Atributos de las reglas de contenido

Nombre de atributo Descripción Valores Obligatorio

enforce_from_folder_types

Define si las reglas decontenido se aplicanen función del tipo decarpeta o en función dela carpeta principal.

Verdadero

Falso

Sí

enforce_on_copy Define si debenaplicarse las reglasde contenido cuandose copia un objeto enuna carpeta.

Verdadero

Falso

Sí

enforce_on_move Define si debenaplicarse las reglasde contenido cuandose mueve un objeto auna carpeta.

Verdadero

Falso

Sí

enforce_on_link Define si debenaplicarse las reglasde contenido cuandose enlaza un objeto auna carpeta.

Verdadero

Falso

Sí

Crear una carpeta subordinada

Para crear una estructura de carpetas predefinida, hay que crear tipos de carpetas subordinadas(y tipos de documentos, si fuese necesario) dentro de un tipo de carpeta existente. Estos tipossubordinados se conocen como tipos subordinados, en contraposición con los tipos raíz, que son tiposde primer nivel de los que los usuarios pueden crear instancias.

Nota: En lugar de tener la estructura de carpetas creada en plantillas de carpetas y asociarlas a lostipos de carpetas, Capital Projects tiene la estructura definida en tipos de carpetas y asocia cadacarpeta subordinada a una plantilla única.

41

Configurar

1. Vaya a la carpeta 02 Carpetas > 01 Tipos del proyecto correspondiente en el área de configuracióndel proyecto.

2. Seleccione Archivo > Nuevo > Tipo de carpeta para crear un tipo de carpeta raíz.

3. Especifique las propiedades en la pestaña Crear.


5. En la pestaña Información, seleccione la casilla de verificación Usar en operacionesArchivo/Nuevo/Carpeta para que los usuarios puedan crear carpetas de este tipo en el área detrabajo del proyecto.

6. Haga clic en Finalizar para guardar el objeto de tipo carpeta raíz.

7. Seleccione la nueva carpeta para crear una carpeta en su interior.

8. Cree un tipo de carpeta subordinada siguiendo los pasos anteriores con estos cambios

a. Desactive la casilla de verificación Usar en operaciones Archivo/Nuevo/Carpeta. Estaconfiguración asegura que los usuarios puedan crear carpetas de este tipo solo bajo el tiporaíz pero no individualmente, para mantener la taxonomía intacta.

b. Seleccione solo una plantilla para estos tipos de carpetas subordinadas o se empleará comopredeterminada la primera plantilla de la lista cuando se creen instancias del objeto.

Definir la herencia de los atributos de carpeta en el RCF

La herencia de los atributos de carpeta permite que los valores de atributo definidos en los objetosde carpeta se copien en los atributos de objeto que contiene. Defina la herencia de los atributos decarpeta en la etiqueta folder_inheritance del RCF usando la configuración siguiente:

<folder_object_type name="eifx_abs" extends="eif_abs" /><folder_object_type name="eif_org_folder"><doc_object_type name="eif_doc">

<attr name="eif_area" /><attr name="eif_asset" /><attr name="eif_discipline" /><attr name="eif_function" /><attr name="eif_responsible" /><attr name="eif_subsystem" /><attr name="eif_system" /><attr name="eif_type_of_doc" /><attr name="eif_project_context.eif_project_ref">

</object_type>

• El elemento folder_object_type define el tipo de objeto de carpeta.

• El elemento de attr folder_object_type define el nombre del atributo del tipo de objetode carpeta que se hereda.

• El elemento object_type contiene un conjunto de etiquetas attr que definen los atributosdel objeto. El valor del atributo del objeto de carpeta respectivo que encapsula el elementoobject_type rellena los atributos.

• Básicamente, el atributo extends copia la configuración de un tipo de objeto de carpeta en otro.

42

Configurar

Configurar la autonumeraciónUtilice la configuración de autonumeración para definir las secuencias de numeración que son unacombinación de constantes y metadatos del documento y un número de secuencia generado por elsistema. Las reglas de autonumeración incluyen:• Nombres únicos para identificar documentos dentro de un proyecto.

• Designación de documentos de distintos tipos con diferentes configuraciones de autonumeraciónpara organizar y clasificar los documentos dentro de un proyecto.

• Una configuración de numeración la puede utilizar uno de entre los varios tipos de documentosde Capital Projects.

• Una vez que un tipo de documento de Capital Projects tiene una configuración de numeraciónaplicada, no se puede cambiar.

• Un tipo de documento de Capital Projects solo puede tener un objeto de autonumeración.

• Un tipo de documento de Capital Projects es autonumeración o no lo es. Es este caso, cree dostipos de documentos de Capital Projects para modelarlo.

Cada tipo de documento diferente disponible en Capital Projects se puede establecer con unaconfiguración de autonumeración siguiendo estos pasos. Después de crear una configuración deautonumeración, aplíquela a cualquier tipo de documento o de carpeta en el Área de configuracióndel proyecto.

• Crear una configuración de autonumeración, página 43

• Aplicar la autonumeración, página 45

Crear una configuración de autonumeración1. Seleccione Administrador del proyecto > Configuraciones del proyecto > <Nombre del proyecto>

> 07 Autonumeración.

2. Seleccione Archivo > Nuevo > Configuración de numeración.

3. En la pestaña Crear, escriba un nombre en el campoNombre de la configuración de numeración.


5. Seleccione la pestaña Configuración.

6. Haga clic en Agregar en el área Configuración de numeración. Se muestra la ventanaConfiguración de numeración.

43

Configurar

Cuando termine, haga clic en Aceptar para guardar los cambios y cierre el cuadro de diálogoConfiguración de numeración.

a. Atributo: seleccione esta opción y haga clic en Editar para abrir el cuadro de diálogo Selectorde atributos. Seleccione un tipo de objeto de Capital Projects y después seleccione un atributo.Si el atributo seleccionado está configurado como un valor de lista desplegable en el archivoRCF, seleccione la casilla de verificación Usar código abreviado para que este valor estédisponible para la configuración de numeración.

b. Número de secuencia: seleccione para generar un número de secuencia exclusivo quecomience una secuencia en cero (“0”), que es un atributo obligatorio de una configuraciónde numeración.Si el proyecto requiere que se genere un conjunto diferente de números de secuencia,establezca Permitir entrada manual en la pestaña Configuración y establezca el formatonumérico.

c. Texto: seleccione una opción y un separador en el cuadro de lista para definir un separadoren el formato de numeración. En el RCF, los separadores se definen bajo la etiqueta<separator_values> y los valores de texto, bajo la etiqueta <text_values>.

d. Separador: seleccione para definir un valor de texto con formato libre en el formato denumeración. Escriba el valor que se utilizará en el formato de numeración y, a continuación,haga clic en Agregar elemento para agregarlo al cuadro de lista. Cuando termine, hagaclic en Aceptar para guardar los cambios y cierre el cuadro de diálogo Configuraciónde numeración.

44

Configurar

e. En el área Configuración del número de secuencia, configure estas opciones: Permitirentrada manual: permite que los usuarios hagan entradas manuales para el número desecuencia. Escriba un formato de número en el campo de formato de número para definir elnúmero inicial de la secuencia. Ejemplos:• El resultado “000001” significa que el primer documento que utilice esta configuración de

autonumeración será el “000001”.

• El resultado “0001000” significa que el primer documento que utilice esta configuraciónde autonumeración será el “1000”.

Este valor se utiliza con fines de formato y no define el valor máximo de la secuencia. Sepermite para documentos existentes y el procesamiento de trabajos pendientes.

f. Permitir reutilización de numeración: permite reutilizar la numeración aplicada a objetosque se han eliminado del sistema. Las secuencias de numeración son contiguas.

g. Aplicación de número de identificación: identifica cuándo se aplica la numeración:

i. En creaciones de objetos: aplica la configuración de numeración en el objeto en elmomento de su creación.

ii. En otros eventos (mediante programación): aplica la numeración cuando se produce unevento en el objeto. Escriba un complemento en el archivo RCF para identificar el evento yconfigurar un método que aplique la numeración en el momento en que ocurra el evento.

h. Atributos de almacenamiento: haga clic en Editar para ver la ventana Selector de atributos.Especifique el tipo de objeto y los atributos asociados donde se debe almacenar el númeroexclusivo generado. Haga clic en Aceptar para guardar y cerrar.

7. Haga clic en Finalizar para guardar y cerrar.

Aplicar la autonumeración1. Cree una configuración de autonumeración.

2. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 01 Documento > 01 Tipos del proyecto respectivo bajo el área de configuración del proyecto.

45

Configurar

3. Seleccione un tipo de documento.


5. Haga clic en Editar la Configuración de numeración para seleccionar la configuración denumeración.

6. Haga clic en Aceptar para guardar el objeto.

Configurar las convenciones de nomenclaturaLas convenciones de nomenclatura son un mecanismo para dar nombre a documentos y carpetasutilizando los valores existentes en el sistema, como las listas desplegables. Las convenciones denomenclatura se usan con estos eventos:• Crear un documento

• Importar un documento

• Crear una carpeta

• Importar una carpeta

Las convenciones de nomenclatura:• Se utilizan para dar nombre a los documentos y a las carpetas creadas en el área de trabajo del

proyecto.

• Se aplican a los tipos de documentos y a las carpetas en la configuración del proyecto.

Si en un documento se utiliza la autonumeración y se aplican las convenciones de nomenclatura,estas tienen preferencia.

1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (nombre del proyecto)> 01 Tipos de documentos > 01 Tipos.

2. Seleccione uno de los tipos de documentos.


4. Desplácese a Convención de nomenclatura y haga clic en Editar.

5. Seleccione una de las opciones de configuración en el cuadro de lista del campo Tipo. Cuandoselecciona una opción, se activa la función de convención de nomenclatura. Las opciones deconfiguración son:• Ruta: seleccione esta opción para utilizar listas desplegables como convenciones de

nomenclatura. Haga clic en Editar para mostrar el cuadro de diálogo Elegir ruta y seleccionela ruta donde se definen las listas desplegables. El sistema busca los valores de la listadesplegable en la ruta especificada y después los muestra.

• Propiedad de ID: seleccione esta opción para basar la convención de nomenclatura en valoresde atributo. Haga clic en Editar para mostrar la ventana Selector de atributos. Especifiqueel tipo de objeto y el atributo asociado que se utilizará en la convención de nomenclatura.(Aunque el sistema permite seleccionar varios atributos, seleccione solo uno). Haga clicen Aceptar para guardar y cerrar.

Nota: Configure los atributos para utilizar valores de lista desplegable.

46

Configurar

• Lista: seleccione esta opción para proporcionar una lista fija de valores para la convenciónde nomenclatura. Haga clic en Editar para mostrar el cuadro de diálogo Introducir valores(atributos de repetición). Agregue texto en el campo Introducir nuevo valor para utilizar enla convención de nomenclatura.

• Expresión: seleccione esta opción para obtener valores utilizando una expresión deatributo. Escriba una expresión en el campo Expresión. Por ejemplo, la expresiónparent.object_name pone a cada documento el nombre de su carpeta principal.

• DQL: seleccione esta opción para obtener los valores de nomenclatura de una consultaDQL. Escriba la consulta DQL en el campo DQL. Al utilizar DQL independiente, se pasanlos parámetros del objeto seleccionado a esta expresión para limitar la búsqueda. En losresultados, los valores de la primera columna se muestran para asistencia de nomenclatura.Por ejemplo:select object_name from ecs_picklist where FOLDER (’ECSCONFIG’,Descend)

6. Haga clic en Finalizar.

Configurar el relleno de atributos automáticoSe utiliza para rellenar los atributos con el valor de una expresión compuesta de otros valores deatributo y texto libre.

Estos son los temas que se incluyen en esta sección:• Crear una configuración de relleno automático de atributos, página 47

• Aplicar una configuración de relleno de atributos a un tipo, página 48

Crear una configuración de relleno automático deatributos1. Seleccione Administrador del proyecto > Configuraciones del proyecto > <Nombre del proyecto>

> 08 Relleno automático de atributos

2. Seleccione Archivo > Nuevo > Configuración de relleno de atributos para crear unaconfiguración. Se muestra el cuadro de diálogo Nueva configuración de creación de relleno deatributos.

3. En la pestaña Crear, escriba un nombre en el campo Nombre de configuración de relleno deatributos.


5. Seleccione la pestaña Configuración.

47

Configurar

6. Haga clic en Agregar en el área Elementos de relleno. Se muestra el cuadro de diálogoInstalación de relleno de atributos. Seleccione una de las siguientes opciones:• Atributo: seleccione esta opción y haga clic en Editar para abrir el cuadro de diálogo Selector

de atributos. Seleccione un tipo de objeto de Capital Projects y después seleccione un atributo.

• Texto: seleccione un valor en el cuadro de lista o escriba un valor en el campo de texto del ladoderecho y haga clic en Agregar elemento para utilizar un valor personalizado que no figureen el cuadro de lista. Consulte en Configurar el cuadro de lista de texto en la configuración derelleno de atributos, página 48 la información para rellenar el cuadro de lista.

Cuando termine, haga clic en Aceptar para guardar los cambios y cierre el cuadro de diálogoInstalación de relleno de atributos.

7. Atributos de almacenamiento: haga clic en Editar para ver el cuadro de diálogo Selector deatributos. Especifique los atributos donde se almacena el valor generado. Si el atributo no figuraen el tipo adjunto, se ignora dicho atributo. Haga clic en Aceptar para guardar y cerrar.

8. Haga clic en Finalizar.

Configurar el cuadro de lista de texto en la configuración de rellenode atributos

El cuadro de lista Texto utiliza la sección siguiente del RCF:

<attr_population_configurations><static_text_values_list_is_final="false"><static_text>TR</static_text><static_text>NC</static_text><static_text>-</static_text>

</static_text_values><storage_attr_pre_text>Auto Populated</storage_attr_pre_text>

</attr_population_configurations>

El cuadro de lista se puede modificar del siguiente modo:• Para agregar más valores al cuadro de lista del campo Texto, vaya a la etiqueta

<attr_population_configurations> en el RCF. Agregue una etiqueta <static_text>por cada artículo adicional del cuadro de lista.

• Para que la lista sea fija y no se pueda modificar, establezca list_is_final=true en la etiqueta<static_text_values>.

• El valor temporal del atributo de almacenamiento antes de guardar el objeto se puede cambiar porun valor definido por el usuario utilizando la etiqueta <storage_attr_pre_text>.

Aplicar una configuración de relleno de atributos a untipo

La configuración de relleno de atributos se puede aplicar a los tipos siguientes:• Documentos

• Carpetas

48

Configurar

• Informes

• Carga de documentos

• Transmisión

• Matrices de distribución

• Procesos de acción

1. Seleccione un artículo de una carpeta 01 Tipos de la carpeta de artefactos correspondiente deCapital Projects en el área de configuración del proyecto. Por ejemplo, seleccione Administradordel proyecto > Configuraciones del proyecto > (carpeta del proyecto) > 01 Documentos > 01Tipos > Documento de correspondencia.


3. Desplácese a la opción Configuraciones de relleno de atributos y haga clic en Editar.

4. Vaya a la carpeta 08 Relleno automático de atributos del proyecto correspondiente y seleccioneuna configuración de relleno.

5. Haga clic en Aceptar en el tipo de objeto correspondiente para guardar los cambios.

Configurar las listas desplegables dinámicasLas listas desplegables ofrecen asistencia de valor configurable para atributos específicos de untipo de objeto. Los valores de lista desplegable aplicables a estos atributos se pueden definir enel área de configuración del proyecto. Las listas desplegables ofrecen asistencia de valor para laspropiedades asociadas con:• Documentos

• Carpetas

• Transmisiones

• Procesos de PVA

Estos son los temas que se incluyen en esta sección:• Configurar la asistencia de valor para un atributo de un tipo de objeto nuevo, página 49

• Quitar un valor de lista desplegable, página 64

Configurar la asistencia de valor para un atributo de untipo de objeto nuevo

En el contexto de Capital Projects, la configuración de asistencia de valor para un atributo implicalos cambios siguientes:• Cambios RCF en el elemento <value_assistance>

• Cambios en Capital Projects Webapp

• Creación de objetos de lista desplegable (si fuese necesario)

49

Configurar

El origen de los valores de una configuración de asistencia de valor puede ser alguno de los siguientes:• Un conjunto de resultados de una consulta DQL

• Una lista estática de valores

• Los valores definidos en una carpeta de lista desplegable

• Los valores definidos en una carpeta de lista desplegable que se determina basándose en otrovalor de atributo.

Estos son los temas que se incluyen en esta sección:• Configurar la asistencia de valor basada en una consulta DQL, página 50

• Configurar la asistencia de valor basada en una lista estática de valores, página 53

• Configurar la asistencia de valor basada en valores de lista desplegable, página 55

• Configurar la asistencia de valor de un atributo basada en un valor de otro atributo, página 60

Configurar la asistencia de valor basada en una consulta DQL

1. Haga estos cambios en el RCF:

a. Vaya a la sección <value_assistance> del RCF.

b. Cree una etiqueta object_type vacía con el atributo name como nombre del tipo de objetonuevo. Por ejemplo:

<object_type name=”XXX”><\object_type>

c. Copie las etiquetas attr existentes en las etiquetas object_type existentes y péguelasdentro de la nueva etiqueta object_type.

d. Haga los cambios siguientes según este ejemplo:

<attr name="eifx_my_attribute"><active_values is_list_complete="true"><source type="com.ecs.framework.library.picklists.PicklistSourceDQL"><params>

<param name="return-mode" value="values"/><param name="dql" value="select distinct myColName from dm_dbo.NewTablewhere mycolName like ‘s%’"/>

<param name="value_attr" value="myColName"/></params>

</source>

</active_values><all_values><source type="com.ecs.framework.library.picklists.PicklistSourceDQL"><params>

<param name="return-mode" value="values"/><param name="dql" value="select distinct myColName from dm_dbo.NewTablewhere mycolName like ‘s%’"/><param name="value_attr" value="myColName"/>

</params></source>

</all_values></attr>

50

Configurar

i. <attr name="eifx_my_attribute">: cambia el nombre por el nombre de unatributo nuevo.

ii. <active values>: define los valores activos para la lista desplegable. Establezcais_list_complete en verdadero cuando no quiera que el usuario proporcione valorespersonalizados en tiempo de ejecución.

iii. type: define el atributo type del elemento source como sigue: com.ecs.framework.library.picklists.PicklistSourceDQL

iv. params: la etiqueta params define los params que se pasarán. Revise la lista de paramsy los valores posibles para cada tipo de origen respectivamente:

Tabla 7. Valores para la etiqueta params

Nombre del parámetro Valor del parámetro Obligatorio

return-mode (en desuso) Define el tipo devisualización de la listadesplegable:

values: muestra undesplegable

Sí

selection_mode Define el tipo devisualización de la listadesplegable:• values : muestra

un cuadro de listaconvencional

Sí

Dql Consulta select de Dqlque devuelve una lista devalores.

Sí

value_attr Nombre de la columna quedevuelve la consultaDql que se utilizarácomo valores de la listadesplegable.

Sí

short_value_attr Nombre de la columnadevuelta por la consultaDql que se utilizará comovalores cortos de la listadesplegable.

No

v. etiqueta <all_values>: define todos los valores de una categoría concreta de listadesplegable que se mostrarán en la ventana de búsqueda. Los parámetros y tipo deorigen descritos previamente para active_values también se aplican a la etiquetaall_values.

2. Realice estos cambios en Capital Projects:

51

Configurar

a. Vaya al directorio raíz de Capital Projects en el servidor de aplicaciones donde estáimplementado.

b. Compruebe la etiqueta context-param de AppFolderName del archivo<root>/WEB-INF/web.xml para buscar cuál es la capa WDK de nivel superior en uso.Haga una nota en el valor de la etiqueta param-value.

...<context-param>

<param-name>AppFolderName</param-name><param-value>XXXXX</param-value>

</context-param>...

c. Si es algo distinto de custom, actualice del modo siguiente:

i. Actualice el valor de parámetro de AppFolderName a custom:<context-param>

<param-name>AppFolderName</param-name><param-value>custom</param-value>

</context-param>

ii. Abra app.xml en <root>/custom y actualice “extends” para extender elvalor de la etiqueta param-value previamente anotado. Verifique que el archivo<root>/custom/app.xml es como sigue:<?xml version="1.0" encoding="UTF-8" standalone="no"?><config><scope><application extends="XXXXX/app.xml"></application>

</scope></config>

Nota: Si se crea una capa Documentum Webtop personalizada con un nombre xxxx, elparámetro contexto de web.xml debería apuntar a la capa “xxxx”. Asimismo, el archivoapp.xml de la capa xxxx debería extender eif/app.xml.

d. Copie el componente xml que extiende el componente “atributos” de la capa webcomponentde alcance obligatorio. Por lo general, para un documento, se copia el archivodocbaseconfiguration(eif_doc).xml ubicado en el directorio raíz de Capital Projects:• De:

<root>/eif/config/library/attributes, donde eif_doc, eif_org_folder,eif_transmittal, de la capa de nivel superior (XXXXX)

En:

la carpeta <root>/custom/config/library/attributes. Cree la carpeta si fuesenecesario.

Cambie el nombre del archivo por docbaseconfiguration (eifx_deliverable_doc).xml, ya que este es el tipo de objeto que se va a configurar.

52

Configurar

Nota: Si se crea una capa de Documentum Webtop personalizada con nombre xxxx, copielos archivos xml en esta capa. La ruta es:<root>/xxxx/config/library/attributesfolder

e. Utilice el ejemplo siguiente y agregue una etiqueta para cada nuevo atributo configurado paraasistencia de valor bajo /config/scope/ docbaseobjectconfiguration/inserthacia el final de la etiqueta.<attribute name=’eifx_my_attribute’>

<valuetagclass>com.ecs.webtop.control.docbase.ecsfvalueassistance.ECSFValueAssistanceValueTag</valuetagclass>

</attribute>

f. Reinicie el servidor de aplicaciones para que los cambios surtan efecto.

Configurar la asistencia de valor basada en una lista estática devalores







<attr name="eifx_my_attribute"><active_values is_list_complete="true"><source type="com.ecs.framework.library.picklists.PicklistSourceList"><params>

<param name="values" value="value1,value2,value3,value4"/><param name="values_separator" value=","/></params></source>

</active_values><all_values><source type="com.ecs.framework.library.picklists.PicklistSourceList"><params>

<param name="values" value="value1,value2,value3,value4"/><param name="values_separator" value=","/>

</params></source>



53

Configurar


iii. type: define el atributo type del elemento source como sigue: com.ecs.framework.library.picklists.PicklistSourceList




values Lista de valores separadospor delimitador.

Sí

values_separator Delimitador utilizadopara separar la lista devalores. De manerapredeterminada “,” seconsidera el separador devalores.

Sí

short_values_separator

Delimitador utilizado paraseparar el valor de suvalor corto. De manerapredeterminada “,” seconsidera el separador delvalor corto.

No

ejemplo de short_values_separator:<source type="com.ecs.framework.library.picklists.PicklistSourceList">

<params><param name="values" value="v1|value1,v2|value2,v3|value3,v4|value4"/><param name="values_separator" value=","/><param name="short_values_separator" value="|"/>

</params></source>

v. etiqueta <all_values>: define todos los valores de una categoría concreta de listadesplegable que se mostrarán en la ventana de búsqueda. Los parámetros y tipo deorigen descritos previamente para active_values también se aplican a la etiquetaall_values.

2. Realice estos cambios en Capital Projects:


b. Compruebe la etiqueta context-param de AppFolderName en el archivo<root>/WEB-INF/web.xml para buscar cuál es la capa WDK de nivel superior en uso.Haga una nota en el valor de la etiqueta param-value.

….<context-param>


</context-param>

54

Configurar

….




</context-param>


</scope></config>



En:


e. Utilice el ejemplo siguiente y agregue una etiqueta para cada nuevo atributo configurado paraasistencia de valor bajo /config/scope/ docbaseobjectconfiguration/inserthacia el final de la etiqueta.<attribute name=’eifx_my_attribute’>

<valuetagclass>com.ecs.webtop.control.docbase.ecsfvalueassistance.ECSFValueAssistanceValueTag</valuetagclass>

</attribute>

f. Reinicie el servidor de aplicaciones para que los cambios surtan efecto.

Configurar la asistencia de valor basada en valores de listadesplegable




<object_type name=”XXX”>

55

Configurar

<\object_type>



<attr name="eifx_my_attribute"><active_values is_list_complete="true"><source type="com.ecs.framework.library.picklists.PicklistSourcePath"><params><param name="return-mode" value="values"/><param name="path" value="/ECSCONFIG/Application Configuration/${configurationarea.object_name}/03 Picklists/

My Attribute Name/Active values"/><param name="deep-search" value="true"/><param name="cached" value="false"/></params></source>

</active_values><all_values><source type="com.ecs.framework.library.picklists.PicklistSourcePath"><params><param name="return-mode" value="values"/><param name="path" value="/ECSCONFIG/Application Configuration"/><param name="category" value="My Attribute Name"/><param name="deep-search" value="true"/><param name="cached" value="false"/>

</params></source>




iii. type: define el atributo type del elemento source como sigue: com.ecs.framework.library.picklists.PicklistSourcePath




Path Ubicación en el repositoriocon objetos de artículos delista desplegable.

Sí

56

Configurar




• location_browser:muestra un exploradorde carpetas

• location: muestra unexplorador de carpetas(en desuso)

Sí

return-mode (en desuso) Define el tipo devisualización de la listadesplegable:• values: muestra un

menú

• location_browser:muestra un exploradorde ubicaciones

• location: muestraun explorador deubicaciones (en desuso)

Sí

deep-search Solo se puede utilizarcuando selection_mode/return-mode estáestablecido en “values”.• Verdadero

• Falso

No

category Utilizado cuando elparámetro deep-search estáestablecido en verdadero.Especifica el nombrede la carpeta de listadesplegable.

No

cached • Verdadero

• Falso

No

v. etiqueta <all_values>: define todos los valores de una categoría concreta de listadesplegable que se mostrarán en la ventana de búsqueda. Los parámetros y tipo de

57

Configurar

origen descritos previamente para active_values también se aplican a la etiquetaall_values.

Nota: El valor del parámetro return-mode solo puede ser location_browser dentrode la etiqueta <active_values>, siempre debe ser “values” dentro de la etiqueta<all_values>.

2. Realice estos cambios en Capital Projects Webapp:


b. Compruebe la etiqueta context-param de AppFolderName del archivo<root>/WEB-INF/web.xml para buscar cuál es la capa WDK de nivel superior en uso.Haga una nota en el valor de la etiqueta param-value.

….<context-param>


</context-param>….




</context-param>


</scope></config>



En:


e. Para mostrar los valores en una lista desplegable (cuando return-mode en RCF estáestablecido en "values"), agregue una etiqueta del modo siguiente para cada nuevo atributocambiando “name” por el nombre del atributo respectivo que se ha configurado para laasistencia de valor bajo /config/scope/docbaseobjectconfiguration/insert.

58

Configurar

<attribute name=’eifx_my_attribute’><valuetagclass>com.ecs.webtop.control.docbase.ecsfvalueassistance.ECSFValueAssistanceValueTag</valuetagclass>

</attribute>

f. Para mostrar los valores en location_browser (cuando return-mode enRCF está establecido en location_browser), agregue una etiqueta delmodo siguiente para cada nuevo atributo cambiando “name” por el nombredel atributo respectivo que se ha configurado para la asistencia de valor bajo/config/scope/docbaseobjectconfiguration/insert.

<attribute name=’eifx_my_attribute’><valuetagclass>

com.ecs.webtop.control.docbase.ECSAttributeWithPicklistLocatorValueTag</valuetagclass>

<editcomponent>ecspicklistlocatorcontainer</editcomponent><objecttypefordql>ecs_picklist</objecttypefordql><invocation><modalpopup><windowsize>ecslocator</windowsize><refreshparentwindow>onok</refreshparentwindow>

</modalpopup></invocation></attribute>

g. Reinicie el servidor de aplicaciones para que los cambios surtan efecto.

3. Cree una categoría de lista desplegable con el nombre del nuevo atributo como “Mi atributo”y cree los valores requeridos en la carpeta All Values. Enlace los nuevos valores con lacarpeta Active Values.

Para crear una lista desplegable para un atributo nuevo:1. Inicie sesión en Capital Projects.

2. En el área Configuración del proyecto, seleccione el proyecto.

3. Seleccione la carpeta 03 Listas desplegables.

4. Cree una carpeta que sea un “tipo de carpeta de lista desplegable” y denomínela con el nombredel nuevo atributo.

5. Desplácese a la nueva carpeta de categoría lista desplegable y localice las carpetas Valores activosy Todos los valores.

6. Seleccione la carpeta Todos los valores.

7. Seleccione Archivo -> Nuevo -> Valor de lista desplegable para crear un valor de listadesplegable. Lleve a cabo este paso con todos los valores que se necesiten para una categoríalista desplegable.

8. Para cada valor de lista desplegable, proporcione Valor, Valor corto (opcional).

9. Cree uno de estos tipos de listas desplegables:• Lista desplegable simple: enlace cada artículo requerido de la lista desplegable con la carpeta

Valores activos.

• Lista desplegable jerárquica o estructurada: cree la jerarquía de carpetas que se requiera(utilizando el tipo de carpeta Valores de lista desplegable para todas las carpetas) dentro

59

Configurar

de la carpeta Valores activos. Enlace cada artículo de lista desplegable bajo la clasificaciónde carpeta respectiva, según sea necesario.

Nota: Cree siempre los artículos de lista desplegable en la carpeta Todos los valores y enláceloscon la carpeta Valores activos. Los artículos de lista desplegable de la carpeta Valores activosse pueden configurar para utilizarlos en el RCF. Los artículos de lista desplegable de la carpetaTodos los valores se pueden utilizar en la pantalla Búsqueda avanzada. Si un artículo de listadesplegable llegar a estar obsoleto, se puede desenlazar de la carpeta Valores activos peromantenerse en Todos los valores para fines de búsqueda en valores antiguos.

Configurar la asistencia de valor de un atributo basada en un valorde otro atributo







<attr name="eifx_my_attribute" depends_on=”eif_my_attribute2”><active_values is_list_complete="true"><source type="com.ecs.framework.library.picklists.PicklistSourcePath"><params>

<param name="return-mode" value="values"/><param name="path" value="/ECSCONFIG/Application Configuration/${configurationarea.object_name}/03 Picklists/My AttributeName/Active values"/>

<param name="deep-search" value="true"/><param name="cached" value="false"/>

</params></source>

</active_values><all_values><source type="com.ecs.framework.library.picklists.PicklistSourcePath"><params><param name="return-mode" value="values"/><param name="path" value="/ECSCONFIG/Application Configuration"/><param name="category" value="My Attribute Name"/><param name="deep-search" value="true"/><param name="cached" value="false"/>

</params></source>



60

Configurar

ii. Agregue o actualice el atributo depends_on que define el atributo de cuyos valores vana depender las listas desplegables del atributo actual.Por ejemplo: si configura un relleno de lista desplegable mediante el atributo de objetoeif_system, establezca la configuración de la etiqueta <attr> como sigue:<attr name="eif_system" depends_on="eif_area">….</attr>

Este ejemplo depende del valor seleccionado para el atributo eif_area.

iii. <active values>: define los valores activos para la lista desplegable. Establezcais_list_complete en verdadero cuando no quiera que el usuario proporcione valorespersonalizados en tiempo de ejecución.

iv. type: define el atributo type del elemento source como sigue: com.ecs.framework.library.picklists.PicklistSourcePath

v. params: la etiqueta params define los params que se pasarán. Revise la lista de paramsy los valores posibles para cada tipo de origen respectivamente:



Path Ubicación en el repositoriocon objetos de artículos delista desplegable.

Sí



• location_browser:muestra un exploradorde carpetas

• location: muestra unexplorador de carpetas(en desuso)

Sí

return-mode (en desuso) Define el tipo devisualización de la listadesplegable:• values: muestra un

desplegable

• location_browser:muestra un exploradorde ubicaciones

• location: muestraun explorador deubicaciones (en desuso)

Sí

61

Configurar


deep-search Solo se puede utilizarcuando selection_mode/return-mode estáestablecido en “values”.• Verdadero

• Falso

No

category Utilizado cuando elparámetro deep-search estáestablecido en verdadero.Especifica el nombrede la carpeta de listadesplegable.

No

cached • Verdadero

• Falso

No

vi. etiqueta <all_values>: define todos los valores de una categoría concreta de listadesplegable que se mostrarán en la ventana de búsqueda. Los parámetros y tipo deorigen descritos previamente para active_values también se aplican a la etiquetaall_values.

Nota: El valor del parámetro return-mode puede ser location_browser dentro de la etiqueta<active_values> únicamente; debe ser siempre values dentro de la etiqueta <all_values>.

2. Realice estos cambios en Capital Projects Webapp:


b. Compruebe la etiqueta context-param de AppFolderName en el archivo<root>/WEB-INF/web.xml para buscar cuál es la capa WDK de nivel superior en uso.Haga una nota en el valor de la etiqueta param-value.

…<context-param>


</context-param>…




</context-param>

ii. Abra app.xml en <root>/custom y actualice “extends” para extender elvalor de la etiqueta param-value previamente anotado. Verifique que el archivo<root>/custom/app.xml es como sigue:<?xml version="1.0" encoding="UTF-8" standalone="no"?><config>

62

Configurar

<scope><application extends="XXXXX/app.xml"></application>

</scope></config>



En:


e. Para mostrar los valores como una lista desplegable. Por ejemplo, cuando return-mode enRCF está establecido en values.Agregue una etiqueta del modo siguiente para cada nuevo atributo cambiando el “name” porel nombre del atributo correspondiente que está configurado para asistencia de valor bajo/config/scope/docbaseobjectconfiguration/insert.

<attribute name=’eifx_my_attribute’><valuetagclass>com.ecs.webtop.control.docbase.ecsfvalueassistance.ECSFValueAssistanceValueTag</valuetagclass>

</attribute>

f. Para mostrar los valores como un explorador de ubicaciones. Por ejemplo, cuandoreturn-mode en RCF está establecido en location_browser.Agregue una etiqueta del modo siguiente para cada nuevo atributo cambiando el “name” porel nombre del atributo correspondiente que está configurado para asistencia de valor bajo/config/scope/docbaseobjectconfiguration/insert.

<attribute name=’eifx_my_attribute’><valuetagclass>

com.ecs.webtop.control.docbase.ECSAttributeWithPicklistLocatorValueTag</valuetagclass>

<editcomponent>ecspicklistlocatorcontainer</editcomponent><objecttypefordql>ecs_picklist</objecttypefordql><invocation><modalpopup><windowsize>ecslocator</windowsize><refreshparentwindow>onok</refreshparentwindow>

</modalpopup></invocation></attribute>

g. Reinicie el servidor de aplicaciones para que los cambios surtan efecto.

3. Siga estos pasos para crear una lista desplegable para un atributo nuevo.

a. Inicie sesión en Capital Projects.

b. En el área Configuración del proyecto, seleccione el proyecto.

c. Seleccione la carpeta 03 Listas desplegables.

63

Configurar

d. Cree una carpeta que sea un “tipo de carpeta de lista desplegable” y denomínela con elnombre del nuevo atributo.

e. Desplácese a la nueva carpeta de categoría lista desplegable y localice las carpetas Valoresactivos y Todos los valores.

f. Seleccione la carpeta Todos los valores.

g. Cree una jerarquía de carpetas utilizando el tipo de carpeta Picklist Values para todaslas carpetas contenidas en la carpeta Active Values. Denomine las carpetas con el mismonombre que los valores del atributo del que este atributo es dependiente.

h. Enlace los valores de lista desplegable de la carpeta Todos los valores con las carpetasrespectivas de la lista Carpetas activas.

Nota: Cree siempre los artículos de lista desplegable en la carpeta Todos los valores y enláceloscon la carpeta Valores activos. Los artículos de lista desplegable de la carpeta Valores activosse pueden configurar para utilizarlos en el RCF. Los artículos de lista desplegable de la carpetaTodos los valores se pueden utilizar en la pantalla Búsqueda avanzada. Si un artículo de listadesplegable está obsoleto, quite el enlace de la carpeta Valores activos pero manténgalo en lacarpeta Todos los valores para fines de búsqueda en valores antiguos.

Quitar un valor de lista desplegable

Si un artículo de lista desplegable está obsoleto, quite el enlace de la carpeta Valores activos peromanténgalo en la carpeta Todos los valores para fines de búsqueda en valores antiguos.

Configurar las transmisionesLas transmisiones proporcionan la funcionalidad siguiente:• Crear y registrar transmisiones entrantes, salientes y de revisión.

• Mantener los metadatos de la transmisión con fines de registro y supervisión.

• Generar portadas y acuses de recibo.

• Generar hojas de informes para las transmisiones de revisión.

• Utilizar matrices de distribución para automatizar la creación y el envío de transmisiones.

• Consolidar comentarios y generar hojas de comentarios.


• Crear un tipo de transmisión, página 65

• Crear una plantilla de transmisión, página 67

• Crear las plantillas de hojas de comentarios y portadas, página 67

• Expresiones para crear las plantillas, página 69

• Restringir los formatos de documento que se envían en las transmisiones, página 71

• Desactivar las hojas de registro para las transmisiones de revisión, página 71

64

Configurar

• Enviar los paquetes de transmisión a un sitio FTP, página 72

• Crear las transmisiones de revisión automáticamente a partir de transmisiones entrantes, página 72

Crear un tipo de transmisión1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 20 Transmisiones > 01 Tipos.

2. Seleccione Archivo > Nuevo > Tipo de transmisión.





7. Seleccione las plantillas que desea utilizar para este tipo en el cuadro de lista del campo Plantillas.

8. Para crear objetos de este tipo en el área de trabajo del proyecto con Archivo >Nuevo >Transmisión, seleccione la casilla de verificación Usar en operacionesArchivo/Nuevo/Documento.

65

Configurar

9. Para restringir la cantidad de objetos de este tipo que se crean en el área de trabajo delproyecto usando Archivo > Importar, desactive la casilla de verificación Usar en operacionesArchivo/Importar.

10. Especifique el resto de los atributos específicos del tipo de documento que sean obligatorios.Consulte la sección Crear un tipo de documento, página 32 para obtener detalles sobre losatributos.

11. En la pestaña Configuración, defina el atributo Tipos de documentos que se pueden adjuntar;para ello seleccione los tipos de documentos apropiados de Capital Projects.

12. Seleccione la Categoría de transmisión de uno de los valores siguientes:• Entrante

• General

• Revisar

13. Las opciones son:• Permitir destinatarios externos: seleccione esta opción para permitir que se envíen tareas y

notificaciones a destinatarios externos.

• Razones de destinatarios: seleccione I- Información o N- Notificación.

• Métodos de envío de destinatarios: seleccione Archivo adjunto de correo electrónico, Copiaimpresa o Notificación del sistema.

• Duración predeterminada del revisor principal (en días): (categoría transmisión de revisión)define el número predeterminado de días para la revisión principal, que se muestra cuandose inicia este tipo de transmisión.

• Duración predeterminada del aprobador de revisión (en días): (categoría transmisión derevisión) define el número predeterminado de días para aprobación, que se muestra cuandose inicia este tipo de transmisión.

14. Actualice los atributos obligatorios y haga clic en Finalizar para guardar el objeto.

66

Configurar

Crear una plantilla de transmisión1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 20 Transmisiones > 02 Plantillas.

2. Cree plantillas sin contenido usando Archivo > Nuevo > Plantilla de transmisión.


4. Especifique los valores predeterminados que desee proporcionar a los atributos, de modo que secopien para las instancias de documento creadas mediante esta plantilla.

5. Haga clic en Aceptar para verificar que la plantilla se ha retirado.

6. Para adjuntar contenido a la plantilla, seleccione el contenido y regístrelo.

Crear las plantillas de hojas de comentarios y portadas

Cuando crea objetos de transmisión de la categoría General, puede cargar una plantilla de hoja decomentarios o una portada.

1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 20 Transmisiones > 02 Plantillas.

2. Seleccione la transmisión General y vaya a la etiqueta Contenido de la ventana de propiedades.

67

Configurar

3. Descargue la plantilla requerida y cámbiela como sea preciso utilizando expresiones. Por ejemplo:

68

Configurar

Expresiones para crear las plantillas

Las expresiones para crear las plantillas son:

• Expresiones de transmisión: utilice alguno de los atributos únicos del objeto de transmisión(eif_transmittal) en la plantilla de manera que cuando se genere la hoja, se reemplacen losvalores respectivos.

Sintaxis de las expresiones:

69

Configurar

${tr.out.XXXX}

XXX es el nombre de cualquier atributo del objeto de transmisión

• Expresiones de destinatario: utilícelas en las portadas únicamente. Cuando utilice detalles deldestinatario, enciérrelos entre las expresiones ${rl.start} y ${rl.end}. Las expresionescontenidas entre las etiquetas se evalúan para cada destinatario de la transmisión y se genera unatabla (con una fila por destinatario). Utilice las expresiones siguientes en la plantilla para obtenerlos detalles de los destinatarios cuando se generan las portadas.


— ${rl.r.out.eif_rp_name}: nombre del destinatario

— ${ rl.r.out.eif_rp_company}: empresa del destinatario

— ${ rl.r.out.eif_rp_delivery}: método de entrega utilizado con este destinatario

— ${ rl.r.out.eif_rp_email}: correo electrónico del destinatario

— ${ rl.r.out.eif_rp_group}: grupo del destinatario

— ${ rl.r.out.eif_rp_reason}: razón del destinatario

— ${ rl.r.out.eif_rp_status}: estado del destinatario

• Expresiones de documento: utilice las expresiones de destinatario en las portadas únicamente.Cuando utilice detalles del destinatario, enciérrelos entre las expresiones ${dl.start} y${dl.end}. Las expresiones contenidas entre las etiquetas se evalúan para cada destinatariode la transmisión y se genera una tabla (con una fila por destinatario). Utilice alguno de losatributos únicos del objeto Documento eif_doc en la plantilla de manera que cuando se generela hoja, se reemplacen los valores respectivos.

Sintaxis de las expresiones:${dl.d.out.XXXX}

XXX es el nombre de cualquier atributo del objeto Documento.

• Expresiones de comentario: cuando utilice detalles del documento, enciérrelos entre lasexpresiones ${dl.start}}...${dl.d.cl.start} y ${dl.d.cl.end}...${dl.end}. Lasexpresiones contenidas entre las etiquetas se evalúan para cada destinatario de la transmisión yse genera una tabla (con una fila por destinatario). Utilice las expresiones de comentario en lahoja de comentarios únicamente. Utilice alguno de los atributos únicos del objeto Comentario(eif_comment) en la plantilla de manera que cuando se genere la hoja, se reemplacen losvalores respectivos.


— ${dl.d.cl.start}: representa el inicio de la lista de comentarios de un documento.

— ${dl.d.cl.end}: representa el final de la lista de comentarios de un documento.

— ${cl.ct.crl.start}: representa el inicio de la lista de respuestas de un comentario.

— ${cl.ct.crl.end}: representa el final de la lista de respuestas de un comentario.

— ${cl.ct.pc.out.XXXX}: XXXX es el nombre de cualquier atributo del objeto eif_comment.

— ${cl.ct.pc.out.attachments}: lista de archivos adjuntos de este comentario.

— ${cl.ct.pc.out.markups}: lista de marcas de este comentario.

70

Configurar

— ${crl.cr.out.XXXX}: XXXX es el nombre de cualquier atributo del objeto eif_comment quees una respuesta a un comentario.

— ${crl.cr.out.attachments}: lista de archivos adjuntos del comentario de respuesta.

Nota: Ponga siempre un “start” con su “end” correspondiente. La jerarquía es:

${dl.start}...${dl.d.cl.start}...${cl.ct.crl.start}...${cl.ct.crl.end}...${dl.d.cl.end}...{dl.end}

Restringir los formatos de documento que se envíanen las transmisiones

Para agregar o quitar formatos de documento que se puedan adjuntar en las transmisiones, vaya a laetiqueta denominada <prevented_formats> en el RCF. Agregue el nombre del formato comosigue (“xxxx” indica el nombre del formato):<prevented_format category="outgoing">

<format name="acad"/><format name="xxxx"/>

</prevented_format>

Desactivar las hojas de registro para las transmisionesde revisión

Actualice el RCF del modo siguiente para evitar que el sistema genere hojas de registro:• Para que se generen automáticamente hojas de registro cuando comienza la revisión, quite o

comente la etiqueta siguiente:rcf\plugins\plugin[name=”RecordSheetGenerationAtStart”]

• Para las hojas de registro que puede solicitar un usuario durante la revisión, quite o comente lasetiquetas siguientes:rcf\operations_registry\operation[type="tr_generate_adhoc_review_record_sheet"]

rcf\actions_registry\action[name="generate_adhoc_review_record_sheet"]

rcf\security_profiles\profile[name=”Review Transmittal”]\states\state[name=”In Commenting”]\operations\operation[reference="tr_generate_adhoc_review_record_sheet"]

rcf\security_profiles\profile[name=”Review Transmittal”]\states\state[name=”In Consolidation”]\operations\operation[reference="tr_generate_adhoc_review_record_sheet"]

rcf\security_profiles\profile[name=”Review Transmittal”]\states\state[name=”In Approval”]\operations\operation[reference="tr_generate_adhoc_review_record_sheet"]

• Para las hojas de registro generadas automáticamente cuando finaliza la revisión, quite o comentela etiqueta siguiente:rcf\plugins\plugin[name=”RecordSheetGenerationAtCompletion”]

71

Configurar

Enviar los paquetes de transmisión a un sitio FTP

Actualice el RCF para configurar el sistema para que envíe paquetes de transmisiones a un sitio FTP.

1. En el RCF, vaya al elemento <transmittals>.

2. Especifique valores para los parámetros siguientes en el elemento <action> de FTP (por ejemplo,<delivery_method>/<actions>/<action>):• ftp_host: nombre del sitio FTP

• ftp_username: nombre del usuario para el acceso al sitio FTP

• ftp_password: contraseña de acceso al sitio FTP

• ftp_path: ruta completa de la ubicación FTP donde el sistema envía los paquetes detransmisión. La ruta puede contener expresiones.

• notification_email: especifica la plantilla que utiliza el sistema para enviar notificacionesde correo electrónico a los destinatarios de las transmisiones.

• notification_subject: cadena que define la línea del asunto de las notificaciones decorreo electrónico. Por ejemplo:

Notificación de transmisión ’<número de transmisión>’ enviado al sitio FTP ’<host del sitioFTP>’

Crear las transmisiones de revisión automáticamentea partir de transmisiones entrantes

La opción de envío automático de transmisiones de revisión en las soluciones de Capital Projectsayuda a crear una nueva transmisión de revisión cuando se recibe una transmisión entrante.

1. En el RCF, vaya al elemento <global_params>.

2. Actualice el parámetro distribution_matrix_name con un valor fijo o una expresión basadaen atributo para su entorno.

3. Vaya al elemento <precondition name=“tr_issue_reason_check”>.

4. Para el parámetro transmittalIssuedReasons, especifique los valores de razón del problemapara los que Capital Projects crea transmisiones de revisión.Separe con comas una lista de razones del problema. Si no cambia el valor predeterminado,Capital Projects crea nuevas transmisiones de revisión para cualquier razón de problemaasociada con las transmisiones entrantes.

5. Vaya al elemento <plugin name=AutoCreateAndSendTransmittal>.

6. Actualice los siguientes parámetros para su entorno:• group_documents: valor booleano que determina si Capital Projects agrupa los documentos

de la transmisión entrante en una única transmisión de revisión o crea transmisiones de

72

Configurar

revisión independientes para cada documento. De forma predeterminada, este valor seestablece en verdadero.

• notify_to: valor fijo o expresión basada en atributos que define los usuarios o grupos a losque Capital Projects envía mensajes de transmisión de revisiones.

• newtransmittalname: valor fijo o expresión basada en atributos que define el nombre de lanueva transmisión. El valor predeterminado es Transmisión de revisión.

• transmittaltypename: nombre de la cadena del tipo de transmisión de revisión.

• transmittaltemplatename: nombre de la cadena de la plantilla de transmisión. El valorpredeterminado es Revisión predeterminada.

7. Vaya al elemento <task_message_management>.

8. Si es necesario, personalice los mensajes que Capital Projects envía a los controladores dedocumentos cambiando los valores <message_body> de las claves <message_handler>siguientes:• EIF_TR_REVIEW_AUTOSTART: indica que la solución Capital Projects inició la creación de la

transmisión de revisión.

• EIF_TR_REVIEW_CREATED: indica que la solución Capital Projects creó la transmisión derevisión.

• EIF_TR_REVIEW_ISSUES: la solución Capital Projects envía una notificación al controladorde documentos porque hay problemas en la creación y reenvío automático de lastransmisiones de revisión de la transmisión entrante.

• CP_EXCEPTION: muestra las excepciones relacionadas de la solución Capital Projects.

Configurar los métodos de envíoEn esta sección se incluyen las tareas siguientes:• Definir el tamaño de los envíos de transmisiones por correo electrónico, página 73

• Enviar los paquetes de transmisión a un sitio FTP, página 74

• Habilitar el método de envío a FTP para un proyecto, página 74

• Configurar los parámetros de los métodos de envío Syncplicity, página 75

Definir el tamaño de los envíos de transmisiones porcorreo electrónico

Tamaño máximo del archivo adjunto de correo electrónico; si se supera el envío de la transmisióndará error.

Siga estos pasos en el archivo RCF para establecer el tamaño máximo delos archivos adjuntos de correo electrónico que generan las transmisiones:agregue un parámetro nuevo <param name="maximum_size" value= “<any valid size .

73

Configurar

numeric only>”/> a la acción <action name = “send_tr_as_attachment"> bajo el métodode envío <delivery_method name="EA" label="Email Attachment">.

Enviar los paquetes de transmisión a un sitio FTP

Actualice el archivo RCF para configurar el sistema para que envíe paquetes de transmisiones a unsitio FTP.1. En el archivo RCF, vaya al elemento rcf\transmittals.

2. Especifique valores para los parámetros siguientes en el elemento <action> de FTP. Porejemplo:<delivery_method>/<actions>/<action>

Tabla 11. Atributos de los paquetes de transmisiones

Nombre de atributo Descripción

ftp_host El nombre de host o dirección IP de la ubicación del servidor FTP.

ftp_username La cuenta de usuario en el servidor FTP.

ftp_password La contraseña de la cuenta de usuario del servidor FTP. Estacontraseña se debe estar codificar con la utilidad de línea decomandos RegistryPasswordUtils de Java.

Por ejemplo,

"java com.documentum.fc.tools.RegistryPasswordUtils

password" = "MmKZP8KOlvrE6ndUolyl6Q=="

ftp_path Esta es una ubicación de FTP accesible para el usuario de FTP. Laruta puede contener expresiones.

Nota: Asegúrese de que existe esta ruta en la ubicación de FTPantes de enviar la transmisión.

mailContent Referencia a la plantilla de contenido de correo electrónicodefinida en el RCF.

notification_subject El asunto del mensaje de correo electrónico enviado una vez quela transmisión se ha enviado a la ubicación de FTP.

Habilitar el método de envío a FTP para un proyecto

De manera predeterminada, el envío a FTP no está disponible para los proyectos.

Siga estos pasos para habilitar la opción de envío a FTP para un proyecto:

1. Vaya a la carpeta 20 Transmisiones/01 Tipos de la carpeta de configuración del proyectocorrespondiente.

2. Haga clic con el botón derecho en el tipo Transmisión general y seleccione Propiedades.

74

Configurar

3. En la pestaña Configuración, haga clic en Editar en el atributo Métodos de envío dedestinatarios.

4. Seleccione a través del sitio FTP en la lista Valores disponibles.

5. Haga clic en Agregar.


7. En el cuadro de diálogo Propiedades, haga clic en Aceptar.

Configurar los parámetros de los métodos de envíoSyncplicity

En el archivo RCF, un elemento <delivery_method> contiene los atributos siguientes:

Tabla 12. Atributos de los métodos de envío de Syncplicity

Nombre de atributo Descripción ¿Configurable?

name Especifica los valores que sealmacenan en el repositoriocuando se selecciona el métodode envío para un destinatariode transmisiones. El valorpredeterminado es SYNCP.

Sí

EMC recomienda no configurareste atributo.

label El valor predeterminado esSyncplicity Delivery.

Sí

multiple_recipients Si es verdadero, el método seejecuta una sola vez para todoslos destinatarios (operaciónmasiva); de lo contrario, sellama al método una vez porcada destinatario.

Sí (verdadero o falso)

En las siguientes tablas se muestran los parámetros del elemento <action>:

Tabla 13. Parámetros de los métodos de envío Syncplicity

Nombre de parámetro Descripción ¿Configurable?

tr_syncshare_folder_path

Carpeta del repositorio en la que se cargael contenido de transmisión y se compartecon Syncplicity. El valor predeterminadoes /Syncplicity Share que es unarchivador creado durante la instalación.

Sí

75

Configurar

connection_name Referencia (nombre) de la etiquetasystem_connection en el RCF queguarda los detalles obligatorios para laconexión del conector Syncplicity, comoURL, nombre de usuario, etcétera. Elvalor predeterminado es SyncplicityConnector.

Sí

syncplicity_share_name Expresión que se resuelve en un nombreúnico que se utiliza como nombre dela carpeta que se comparte a través deSyncplicity. El valor predeterminado es${this.object_name} - Delivery.

Sí (no debe contenerlos caracteres/,\,|,<,>,:,;,?,*)

sync_profile_name Nombre del perfil del conector deSyncplicity que se utiliza para compartirla carpeta a través de Syncplicity. El valorpredeterminado es CP TransmittalProfile.

Nota: Si el perfil no existe, el sistema creauno vacío con ese nombre.

Sí

sharing_note Mensaje insertado en el mensaje de correoque envía Syncplicity cuando se comparteuna carpeta con un destinatario.

Sí

expiry_period_days Número de días después de la fecha deenvío tras los que la transmisión se purgaen Syncplicity.

Nota: Solo se purgan las transmisionesmarcadas como Complete.

Sí

promptEmailTemplate Referencia al elemento <template>utilizado como cuerpo del mensaje decorreo que envía Capital Projects cuandoel envío se realiza correctamente. Elvalor predeterminado es transmittal_syncplicity_delivery_success.Puede actualizar el contenido del elemento<template> respectivo con el nombrecorrespondiente para configurar el cuerpodel mensaje.

Sí

76

Configurar

failEmailTemplate Referencia al elemento <template>utilizado como cuerpo del mensaje decorreo que envía Capital Projects cuandose produce un error en el envío. Elvalor predeterminado es transmittal_syncplicity_delivery_fail.Puede actualizar el contenido del elemento<template> respectivo con el nombrecorrespondiente para configurar el cuerpodel mensaje.

Sí

subject_success Asunto del mensaje de correo que envíaCapital Projects cuando el envío se realizacorrectamente.

Sí

subject_fail Asunto del mensaje de correo que envíaCapital Projects cuando se produce unerror en el envío.

Sí

Configurar las entregasLa entrega de documentos a la fase de operaciones es una de las responsabilidades más importantesdel controlador de documentos. Durante esta fase, todos los dibujos, diseños, equipos e informaciónde infraestructura de la planta o instalación se entregan al operador para las operaciones ymantenimiento del sitio. La información de los activos también se debe importar en los sistemas quelos operadores utilizan para operar y mantener la instalación.

En el diagrama siguiente se ilustra el ciclo de vida de la entrega:


• Habilitar las entregas, página 78

• Configurar los destinos de la entrega, página 78

• Configurar tipos de documentos, página 81

• Configurar automáticamente documentos marcados para entrega, página 82

• Configurar automáticamente marcar documentos como listos para entrega, página 82

• Configurar el estado inmovilizado de los documentos, página 83

77

Configurar

• Configurar el archivado automático, página 84

• Configurar los controladores de mensajes de entrega y los destinatarios de notificaciones deerrores, página 85

• Configurar perfil de seguridad para los paquetes de entrega, página 86

• Configurar etiquetas de categorías de entrega, página 85

• Configurar validadores de entrega, página 85

Habilitar las entregas

Puede habilitar o deshabilitar la función de entrega mediante el siguiente parámetro en el archivo RCF.<param name="isHandoverEnabled" value="false"/>

Establezca el parámetro isHandoverEnabled en true para habilitar la tarea de entrega. El valorpredeterminado es falso.

Configurar los destinos de la entrega

Debe configurar los destinos de la entrega en:• RCF: define todos los destinos de entrega disponibles.

• Configuraciones del proyecto: actualice las configuraciones del proyecto para poner los destinosde entrega a disposición del proyecto.

Definir los destinos de entrega en el archivo RCF1. Vaya al elemento \rcf\handover del archivo RCF.

2. Agregue o edite el elemento handover_target. Puede definir cualquier número de destinosde entrega.

3. Cada destino de entrega se define en el elemento handover_target y posee los atributossiguientes:

Tabla 14. Configuración de destinos de entrega

Nombre deatributo

Descripción Valor delparámetro

Obligatorio

name Especifica el nombre del destino deentrega. Puede definir cualquiernúmero de destinos de entrega enun proyecto.

asset_operations Sí

code Especifica el código abreviado quese puede utilizar para representarel nombre del destino. Este valorpersiste en la base de datos.

AO Sí

78

Configurar

label Especifica la etiqueta del destino deentrega.

Asset Operations Sí

max_batch_size Especifica el número máximo dedocumentos que se pueden incluiren el paquete de entrega.

No

4. El elemento handover_target tiene los siguientes elementos secundarios:1. <exporter>: especifica la ruta de la carpeta en la que se debe exportar el paquete.

Tabla 15. Atributos del exportador

Nombre de atributo Descripción Obligatorio

root_folder Especifica la carpeta raíz para laexportación de la entrega.

Sí

folder_expression Expresión para especificar la ruta de lacarpeta bajo la carpeta raíz en la que seexportarán todos los documentos de laentrega.

Sí

2. <filenaming>: especifica una expresión que define cómo se deben denominar los archivosexportados.

3. <data_formatter>: especifica las clases de interfaz e implementación utilizadas paraexportar los metadatos del contenido que se exporta como un archivo de manifiesto (xml, xls,etcétera).

79

Configurar

Tabla 16. Atributos del formateador de datos

Nombre de atributo Descripción Obligatorio

interface Interfaz que define el comportamiento decómo se deben formatear los datos de laentrega. El valor debe ser com.eif.library.handover.IHandOverDataFormattery no se puede modificar. Las clases de laimplementación deben implementar estainterfaz y ofrecer implementación a todos losmétodos.

Sí

use_implementation Especifica la clase de implementacióncompleta que realiza la tarea real de exportarlos metadatos a un archivo de manifiesto.

De manera predeterminada, se proporcionandos implementaciones:• Para exportar metadatos a un archivo XML,

utilice

com.eif.library.handover.dataformatters.EifHandOverXMLDataFormatter

• Para exportar a una hoja de cálculo deExcel, utilice

com.eif.library.handover.dataformatters.EifHandOverExcelDataFormatter

1. <attributes>: especifica una lista adicional de atributos que se exportarán junto con elconjunto predeterminado de atributos del documento.

De manera predeterminada por cada documento exportado,los atributos siguientes se exportan al archivo de manifiesto.r_object_id","ecs_internal_ref","eif_project_ref","eif_issue_reason","eif_discipline","eif_alt_doc_number","eif_equip_tags","eif_asset","eif_po_reference","eif_area","eif_system","eif_subsystem","eif_function","eif_acceptance_code

Por ejemplo,<attributes><attribute>attr_name1</attribute><attribute>attr_name2</attribute><attribute>aspect_name.attr_name</attribute>...</attributes>

2. <renditions>: especifica la lista de copias quese exportarán junto con el contenido principal.

80

Configurar

El valor especificado puede ser una copia con nombre (por ejemplo,Stamped and Signed) o un formato (por ejemplo, PDF).

Por ejemplo,<renditions><rendition>Stamped and Signed</rendition><rendition>pdf</rendition>....</renditions>

3. <validators>: especifica la lista de validadores que se ejecutarán en fases diferentes delpaquete de entrega.

Por ejemplo,<validators><validator reference="is_document_latest" /><validator reference="is_document_in_action_process"/></validators>

En la definición del validador, el parámetro used_when determina cuándo se ejecuta elvalidador respectivo. Los valores del parámetro son:

4. add_document: se llamará al validador mientras se agrega un documento al paquetede entrega.

5. onOk: se llamará al validador cuando se haga clic en Aceptar en la pantalla depropiedades de la entrega.

6. start_handover: se llamará al validador cuando se inicie la entrega.

Poner a disposición de un proyecto los destinos de entrega obligatorios1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)


2. Haga clic con el botón derecho en Paquete de entrega y haga clic en Propiedades.

3. En la pestaña Configuración, haga clic en el enlace Editar junto a la etiqueta Destinos dela entrega.

4. En el cuadro de diálogo Destinos de la entrega, seleccione los destinos en la lista Valoresdisponibles.



Configurar tipos de documentos

Puede definir los tipos de documentos que se pueden agregar al paquete de entrega en unaconfiguración de proyecto.

1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 20 Transmisiones > 01 Tipos.


81

Configurar

3. En la pestaña Configuración, haga clic en el enlace Editar junto a la etiqueta Tipos dedocumentos que se pueden adjuntar.

4. Seleccione el tipo de documento en la configuración de proyecto correspondiente.


Configurar automáticamente documentos marcadospara entrega

Mediante el uso de complementos, los documentos se pueden marcar automáticamente para laentrega. Por ejemplo, siempre que se crea un objeto en Capital Projects, se produce el eventoecs_created. A continuación figuran los detalles del complementoMarkForHandover.<plugin name="MarkForHandover" run_on_event="ecs_created"class="com.eif.library.plugins.handover.MarkForHandOver"applicable_types="External Deliverable Document,Internal Deliverable Document"><params><param name="notify_failure_to" value="$P{project_controllers_group_expr}"/></params><preconditions><precondition reference="isHandOverEnabled"/></preconditions></plugin>

El atributo applicable_types del elemento <plugin> especifica los tipos dedocumentos en los que se ejecuta el complemento. Para habilitar la función para untipo concreto de documento, debe agregar el tipo de documento en applicable_types.El atributo notify_failure_to especifica los destinatarios a los que se envía una notificación encaso de que el complemento no consiga marcar un documento para su entrega.

Configurar automáticamente marcar documentos comolistos para entrega

Mediante el uso de complementos, los documentos se pueden marcar automáticamente como listospara entrega. Por ejemplo, cuando se mueve un objeto a un nuevo estado del ciclo de vida en CapitalProjects, se produce el evento ecs_target_state_reached. Puede definir varios valores comouna cadena separada por comas.

En el archivo RCF, puede editar el complementoMarkReadyForHandover para personalizar los tiposaplicables, target_state e issue_reason.<plugin name="MarkReadyForHandover" run_on_event="ecs_target_state_reached"class="com.eif.library.plugins.handover.MarkReadyForHandOver"applicable_types="External Deliverable Document,Internal Deliverable Document"><param name="target_state" value="Latest" /><param name="issue_reason" value="Approved for As-Built" /><param name="notify_failure_to" value="$P{project_controllers_group_expr}"/></params><preconditions><precondition reference= "isHandOverEnabled"/><precondition reference="isMarkedForHandOver"/></preconditions></plugin>

82

Configurar

El atributo applicable_types del elemento <plugin> especifica los tipos de documentos en losque se ejecuta el complemento. Para habilitar la función para un tipo de documento específico, debeagregar el tipo de documento a applicable_types.

Además del tipo de documento, el complemento también comprueba si los valores de atributo deldocumento coinciden con los valores de parámetro. De manera predeterminada, se compruebanlas condiciones siguientes:

• El estado del ciclo de vida del documento hace coincidir cualquiera de los valores de la listaseparadas por comas con el parámetro target_state.

• El valor Razón del problema hace coincidir cualquiera de los valores de la lista separada porcomas con el parámetro issue_reason.

El atributo notify_failure_to especifica los destinatarios a los que se envía una notificación encaso de que el complemento no consiga marcar un documento como listo para entrega.

Configurar manualmente marcar documentos comolistos para entrega

Puede usar las Acciones de la interfaz de Capital Projects para marcar manualmente un documentocomo listo para entrega.

Cuando se invoca MarkReadyForHandoverAction, se marcan los documentos como listos paraentrega si cumplen las condiciones siguientes:

1. El estado del ciclo de vida del documento hace coincidir cualquiera de los valores de la listaseparada por comas con el parámetro target_state.

2. El valor Razón del problema del documento hace coincidir cualquiera de los valores de la listaseparada por comas con el parámetro issue_reason.

En el archivo RCF, puede editar el complementoMark_ready_for_handover_action para personalizarlos tipos aplicables, target_state e issue_reason.<action name="mark_ready_for_handover_action"class="com.eif.pluggable.actions.handover.MarkReadyForHandOverAction"propagate_exceptions_on_failure="false" error_level="error" use_method_server="true"><params><param name="target_state" value="Latest" /><param name="issue_reason" value="Approved for As-Built" /><param name="document_conditions_mismatch_message"value="Document conditions did not match :Issue reason should be ’Approved for As-Built’and version should be ’Latest’"/><param name="success_message" value="Marked the document as Ready for handover successfully."/><param name="failure_message" value="Failed to mark the document as Ready for handover."/></params></action>

Configurar el estado inmovilizado de los documentos

Cuando se agrega un documento al paquete de entrega, el documento debe estar congelado (de sololectura) de manera que no se puedan hacer actualizaciones posteriores.

83

Configurar

En el archivo RCF, puede personalizar el estado actualizando el parámetro siguiente:<param name="readonly_handover_doc_statuses" value="Prepare,Review,Pending,Published"/>

El valor del parámetro es una lista separada por comas del estado del ciclo de vida de entrega en elque el documento adjunto al paquete de entrega pasa a ser de solo lectura.

Configurar el archivado automático

La ruta predeterminada del archivado automático del paquete de entrega es:/PROJECTS/${project.object_name}/09.Handover/Handover=${this.ecs_lc_state}

Siga estos pasos para configurar la ruta auto_file_path:1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)



3. En la pestaña Información se puede ver el cuadro de texto Ruta de archivador automático conuna ruta predefinida. Puede personalizar esta ruta según los requisitos del proyecto.

Complemento archivado automático

Este complemento permite archivar automáticamente un objeto cuando se mueve aun estado diferente del ciclo de vida. El archivado automático se produce cuandocambia el estado del paquete de entrega. Se puede habilitar el complemento enel archivo RCF. A continuación se muestran los parámetros del complemento.

<plugin name="AutoFileTransmittal" run_on_event="ecs_target_state_reached"class="com.eif.pluggable.plugins.autofiling.AutoFileObjectPlugin"applicable_types="General Transmittal,Review Transmittal,Incoming Transmittal,Handover Package"><params><param name="ignore_exceptions" value="true"/></params></plugin>

El complemento tiene un parámetro auto_file_path opcional quedefine la ubicación en la que se archiva automáticamente un objeto.Si no se especifica, el archivado automático intentará archivar automáticamente el objeto en laubicación especificada en los objetos ecs_autofiler_path. El complemento también admiteun parámetro ignore_exceptions opcional para detener las excepciones que provoca cuandoel archivado automático da error.

Con este complemento habilitado y la ruta de archivado automático de la configuración del proyectoestablecida, el paquete de entrega se mueve a las carpetas State Named respectivas a medida queva pasando por estados diferentes como Pending, Published, Cancelled y Completed. Si seconfiguran tipos de paquetes de entrega personalizados, actualice el atributo applicable_typescon el nombre del nuevo tipo en el complemento RCF para habilitar el archivado automático para elnuevo tipo.

84

Configurar

Configurar los controladores de mensajes de entrega ylos destinatarios de notificaciones de errores

Los controladores de mensajes se encargan de controlar tipos de mensajes específicos. El enlace entreun mensaje y su controlador es message_key. El message_body ofrece la descripción del mensaje.

En el archivo RCF, puede configurar las claves de mensaje siguientes:

1. Vaya al parámetro message_handler.

2. Localice el message_key correspondiente y actualice las claves de mensaje obligatorias.

Tabla 17. Controladores de mensajes

message_key Descripción

EIF_HANDOVER_FAILURE Notifica el mensaje de error cuando la publicación del paquetede entrega da error.

EIF_HANDOVER_SUCCESS Notifica el mensaje cuando la publicación del paquete deentrega se realiza correctamente.

EIF_HANDOVER_CANCELLED

Notifica el mensaje a todos los controladores cuando elpaquete de entrega se cancela.

EIF_HANDOVER_COMPLETED

Notifica el mensaje a todos los controladores cuando elpaquete de entrega se completa.

Puede modificar los atributos message_type, message_summary y message_body delelemento message_handler.

Configurar etiquetas de categorías de entrega

Puede actualizar la etiqueta de la interfaz de usuario de la categoría de entrega actualizando elatributo de etiqueta en el elemento <category_labels>.<category name="handover" label="Handover"/>

Configurar validadores de entrega

Puede configurar los validadores de entrega utilizando el subelemento <validators> del elemento<handover_target>.

En Configurar los destinos de la entrega se ofrece más información sobre la configuración de validadores.

85

Configurar

Configurar perfil de seguridad para los paquetes deentrega

El perfil de seguridad de un paquete de entrega se define en el archivo RCF y se basa en el ciclode vida de la entrega.

Configurar el conector de SyncplicityEn el archivo RCF, puede configurar los atributos del elemento <system_connection>. Loselementos <system_connection> contienen los atributos siguientes:• name: establezca el valor de este atributo en Syncplicity Connector.

• type: establezca este atributo en Syncplicity.

• provider: establezca este atributo en syncplicity.

Los elementos secundarios del elemento <system_connection> son:• <url/>: URL del conector de Syncplicity.

• <user_name/>: usuario del repositorio que puede iniciar sesión en el conector de Syncplicity(miembro del grupo dmc_sync_admins).

• <login_token>: contraseña del usuario del repositorio para autenticarse con el conector deSyncplicity. Este elemento tiene un nombre de atributo encrypted cuyos valores posibles sondfc. Si el elemento es como <login_token encrypted=“dfc”>xxxxxxx</login_token>,el valor xxxxxxx se descifra utilizando la clase de DFC RegistryPasswordUtils antes deautenticarse con el conector de Syncplicity.

• <proxy_host>: nombre del host proxy opcional usado para conectar con el conector deSyncplicity.

• <proxy_port>: número del puerto proxy opcional usado para conectar con el conector deSyncplicity.

Habilitar métodos de entrega de Syncplicity para unproyecto

De manera predeterminada, Syncplicity Delivery no está disponible para los proyectos.Siga estos pasos para habilitar la entrega de Syncplicity para un proyecto:1. Vaya a la carpeta 20 Transmisiones/01 Tipos de la carpeta de configuración respectiva del

proyecto.

2. Haga clic con el botón derecho en el tipo Transmisión general y seleccione Propiedades.

3. En la pestaña Configuración, haga clic en Editar junto al atributo Métodos de envío dedestinatarios.

4. Seleccione Entrega de Syncplicity en el cuadro de lista Valores disponibles.


86

Configurar


7. En el cuadro de diálogo Propiedades, haga clic en Aceptar.

Configurar notificaciones de los eventos delectura/cambioPuede configurar el asunto y el contenido de las notificaciones utilizando el elemento controlador<message_handler> con el atributo clave establecido en DMI_REGISTRY_EVENT. Puede actualizarlos atributos siguientes del elemento, junto con el elemento secundario <message_body> querepresenta el contenido que se envía en la notificación.

Tabla 18. Atributos

Atributo Descripción

message_type Define el tipo de mensaje con el que se pueden ordenar losmensajes en el nodo Mensaje de la interfaz de usuario deCapital Projects.

message_summary Define el asunto del mensaje/correo que se envía.

send_mails Si es verdadero, envía el mensaje junto con lasnotificaciones de mensaje del sistema.

Puede usar las expresiones siguientes en los atributos message_body o message_summary:

Tabla 19. Expresiones

Expresión Descripción

${queuedObjectName} Especifica el nombre del objeto en el que tiene lugar el evento.

${queuedOnEventLabel} Representa la etiqueta del evento, cargada del archivoMessageManagement_en.properties. Las claves del archivode propiedades utilizadas son MSG_READ_LABEL,MSG_UPDATED_LABEL,MSG_LINKED_LABEL,MSG_UNLKINKED_LABEL forevents dm_getfile,dm_checkin,dm_link,dm_unlinkrespectivamente.

${actionPerformer} Representa al usuario que realizó el evento.

${queuedDate} Especifica la fecha en la que tuvo lugar el evento.

${fileOrFolder} Representa la etiqueta para File o Folder, cargada delarchivo MessageManagement_en.properties. Las clavesusadas en el archivo de propiedades son MSG_LABEL_FILE,MSG_LABEL_FOLDER.

87

Configurar

Configurar controladores de tareas de flujo detrabajoCapital Projects proporciona compatibilidad básica para los flujos de trabajo Documentum. Elelemento <workflow_task_handlers_registry> del RCF proporciona la asignación entre lasactividades de los flujos de trabajo y los controladores de tareas que controlan las tareas de flujo detrabajo que genera un flujo de trabajo en curso.

El formato para agregar entradas a este registro es:<workflow_task_handler key="[key of a task handler]"activities="[comma separated list of workflow activity names (or ’any’)]"/>

Para definir un controlador de tarea catch-all, use el valor any como nombre de actividad y elcontrolador se usará con todas las tareas del flujo de trabajo. Si usa una combinación de actividadescon nombre y la palabra clave any, Capital Projects usa las actividades con nombre donde esadecuado y el controlador de tarea catch-all con el resto de las tareas del flujo de trabajo.

Si tiene el mismo nombre de actividad en flujos de trabajo distintos, puede completar los nombresde la actividad con los nombres de los flujos de trabajo. Por ejemplo, si workflow1, workflow2tienen ambos una actividad de revisión, puede usar workflow1.Review o workflow2.Reviewpara especificar los controladores para actividades de flujo de trabajo concretas. Use Review si elcontrolador es el mismo en ambos flujos de trabajo.

Configurar perfiles de seguridadEl perfil de seguridad define un conjunto de roles, ciclos de vida y permisos para cada rol en cadaestado del ciclo de vida, así como las operaciones que se pueden llevar a cabo en cada estado delciclo de vida.

Todas las configuraciones del perfil de seguridad se crean en RCF.


• Agregar nuevos roles, página 88

• Agregar un nuevo perfil de seguridad, página 90

Agregar nuevos roles

Agregue un nuevo rol a un perfil de seguridad existente cuando ninguno de los existentes satisfagalos requisitos. Por ejemplo, si se requiere un nuevo rol para satisfacer requisitos específicos:• Rol: auditor

• Documento: documento entregable interno

• Permiso: lectura en diferentes fases del ciclo de vida de un documento interno

• Acción: view_history en un estado concreto de ese ciclo de vida

88

Configurar

1. Vaya al elemento security_profiles/profile en el RCF cuyo atributo name se aplica alnuevo rol.

2. Bajo el elemento profile vaya al elemento roles y copie cualquier etiqueta role y péguela alfinal del elemento roles:

<role Name="controllers"is_hidden="false"attribute="eif_roles_doc.controllers"label="Controllers"description="Users responsible for managing the document."><init_members><member>$SESSION_USER</member><member>$P(project_controllers_group_sec_profile_expr)</member>

<member>admingroup</member></init_members>

</role>

3. Establezca el atributo name en el nombre del nuevo rol.

4. Establezca el atributo is_hidden en verdadero o falso basándose en si el rol se muestra enla pestaña Pertenencia de Capital Projects.

5. Establezca attribute en el nombre de atributo del tipo o aspecto del objeto que almacena losusuarios o grupos designados para este rol. Si utiliza atributos de aspecto, emplee la sintaxis:aspectName.attributeName.

Nota: Por ejemplo, si se trata de un nuevo rol, puede agregar un nuevo atributo con estasopciones o usar un atributo existente:• Agregue atributo a un aspecto existente.

• Cree un aspecto con el nuevo atributo.

• Use cualquier atributo personalizado del objeto de carpeta o documento en el que se vaa utilizar este perfil.

Consulte EMC Documentum Composer User Guide (Guía del usuario de EMC DocumentumComposer) para obtener detalles sobre cómo agregar atributos a aspectos.

6. Establezca label y description como sea necesario.

7. Rellene el elemento init_members con todos los elementos member que sean necesarios.Cuando se use este perfil para crear un objeto, los miembros de este rol se resolverán segúninit_members. El valor de la etiqueta member puede ser cualquiera de los siguientes:• Nombre de usuario

• Nombre de grupo

• Expresión de Capital Projects o parámetro global de RCF

8. Una vez agregado el rol, defina los permisos para el mismo en cada estado del ciclo de vida.Use la etiqueta role_permissions/role bajo el elemento state respectivo del elementoprofile. Por ejemplo:

<states><state name="Placeholder"><role_permissions><role name="controllers"><permissions>

89

Configurar

<access_permit>DELETE</access_permit><extended_permits>CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION</extended_permits><permitted_actions><action name="change_membership" /><action name="view_history" /><action name="view_comments" /><action name="add_comments" /><action name="relate_to_document" /><action name="ap_attach" /><action name="dm_apply" /><action name="edit_progress" /><action name="view_progress" />

</permitted actions></permissions>

</role>

Nota: Cada estado también tiene una etiqueta default_permissions definida que se usapara especificar los permisos de un rol para el que no se ha definido un role_permissionsconcreto. Por ejemplo:<state>

...<default_permissions><access_permit>RELATE</access_permit><extended_permits/><permitted_actions>

<action name="view_progress"/><permitted_actions>

</default_permissions>...

</state>

9. Copie una etiqueta role existente y péguela al final de la etiqueta role_permissionsrespectiva.

10. Establezca el access_permit requerido según los permisos de acceso.

11. Establezca el extended_permit requerido según los permisos extendidos.

12. Establezca permitted_actions requeridas según las acciones disponibles.

13. Para permitir que los usuarios de este rol realicen las operaciones requeridas en esta fase, vaya ala definición de la etiqueta operation correspondiente en el elemento operations_registrydel RCF. Agregue este rol al atributo roles de la etiqueta operation. Por ejemplo:

<operation_registry><operation_name="library_export"type="generic_dynamic"label="Library export"roles="controllers,administrators"help_tip="Export the contents, renditions, and attribute values..."

Agregar un nuevo perfil de seguridad

Agregue un nuevo perfil de seguridad cuando ninguno de los roles existentes satisfaga los requisitos.Por ejemplo, cuando haya un nuevo tipo de documento que requiera roles personalizados definidoscon sus correspondientes permisos y operaciones.

90

Configurar

1. Vaya al elemento security_profiles en RCF.

2. Cree una etiqueta profile al final del elemento security_profiles.

<profile name="Report Template" applicable_types="document"><lifecycles><lifecycle name="Report" />

</lifecycles>

<required_groups is_hidden="true"><init_members />

</required_groups>

<required_groups_sets is_hidden="true"><init_members />

</required_groups_sets>

<roles><role name="controllers" is_hidden="false" attribute="ecs_roles_report.controllers"

label="Controllers" description="Users responsible for managing the document."><init_members><member>$SESSION_USER</member><member>$P(project_controllers_group_sec_profile_expr)</member>

<member>admingroup</member></init_members>

</role><role name="consumers" is_hidden="false" attribute="ecs_roles_report.consumers"

label="Consumers" description="Users who use the document."><init_members><member>$P(project_group_sec_profule_expr)</member>

</init_members></role>

<role name="runners" is_hidden="false" attribute="ecs_roles_report.runners"label="Runners" description="Users able to generate a report using this template." />

<init_members><member>admingroup</member>

</init_members></role>

</roles>

3. Establezca el atributo name en el nombre del nuevo perfil.

4. Establezca el atributo applicable_types en documents o folders en función de si el perfilse usa en objetos de documento o de carpeta respectivamente.

5. Cree un elemento lifecycles con tantos elementos lifecycles como sea necesario (por logeneral, uno). Establezca el atributo name de los elementos lifecycle en los nombres de losobjetos dm_policy creados con Composer e instalados en el repositorio.

6. Cree un elemento required_groups y debajo un elemento init_members. Agregue todos loselementos member bajo el elemento init_members, como sea necesario. Por ejemplo:

<required_groups is_hidden=”true”><init_members><member><ReqGrp1></member>

...<member><ReqGrpN></member></init_members></required_groups>

91

Configurar

Nota:1. El valor del elemento member debe ser un nombre de grupo.

2. Establezca el atributo is_hidden en verdadero o falso en función de si Required Groupsdebe aparecer en la pestaña Pertenencia.

7. Cree un elemento required_group_sets y debajo un elemento init_members. Agreguetodos los elementos member bajo el elemento init_members, como sea necesario. Por ejemplo:

<required_groups_sets is_hidden=”true”><init_members><member>ReqGrp1</member>

...<member>ReqGrpN</member></init_members></required_groups_sets>

Nota:1. El valor del elemento member debe ser un nombre de grupo.

2. Establezca el atributo is_hidden en verdadero o falso en función de si Required Groupsdebe aparecer en la pestaña Pertenencia.

Consulte EMC Documentum Content Server Fundamentals Guide (Guía de aspectos básicos deEMC Documentum Content Server) para obtener más información sobre RequiredGroupsy RequiredGroupSets.

8. Cree un elemento roles y agregue todos los elementos role que sean necesarios.

<states><state name="Being Prepared"><role_permissions><role name="controllers"><permissions><access_permit>DELETE</access_permit><extended_permits>CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION</extended_permits><permitted_actions><action name="change_membership" />


</role><role name="administrators"><permissions><access_permit>DELETE</access_permit><extended_permits>CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION</extended_permits><permitted_actions><action name="change_membership" />


</permissions></role>

</role_permissions

<default_permissions><access_permit>READ</access_permit>

<extended_permits/></default_permissions>

<operations>operation type="generic" name="activatereport" label="Activate Report"

92

Configurar

roles="controllers" help_tip="Activates reports"><actions><action name="Lifecycle State Change"

class="com.ecs.framework.library.execution.actions.impl.LifeCycleStateChangeActionpropagate_exceptions_on_failure="false" error_level="error">

</action></actions></operation>...</operations></state>

9. Cree un elemento base_state que contenga básicamente los permisos, acciones y operacionescomunes disponibles para el objeto en todos los estados. Bajo este elemento:• Defina el elemento role_permissions que contiene access_permit,

extended_permits y permitted_actions para cada rol necesario.

• Defina el elemento default_permissions que contiene access_permit,extended_permits y permitted_actions.

• Defina el elemento operations que contiene elementos operations copiados de otrosperfiles.

Nota: No se recomienda crear operaciones personalizadas. Utilice las opciones deconfiguración en lugar de la personalización.

10. Cree un elemento default_state. Este elemento contiene los permisos, acciones y operacionesdisponibles para el objeto en las fases en las que no se ha definido un elemento state separado.Bajo este elemento:• Defina el elemento role_permissions que contiene access_permit,

extended_permits y permitted_actions para cada rol como sea necesario.


• Defina el elemento operations que contiene elementos operation copiados de otrosperfiles.


11. Cree un elemento state para todos los estados necesarios del ciclo de vida, bajo el cual:• Defina el elemento role_permissions que contiene access_permit,

extended_permits y permitted_actions para cada rol necesario.


• Defina el elemento operations que contiene elementos operation copiados de otrosperfiles.


93

Configurar

Configurar un tipo de proceso de acciónLos procesos definen una secuencia de actividades que los usuarios llevan a cabo en un conjunto dedocumentos y los distintos cambios que los objetos de documento atraviesan en cada fase.

Crear un tipo de proceso de acción1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 23 Procesos de acción > 01 Tipos.

2. Seleccione Archivo > Nuevo > Tipo de proceso de acción.





7. Seleccione las plantillas que desea utilizar para este tipo en el cuadro de lista del campo Plantillas.Como la plantilla no tiene mucha relevancia, use la plantilla Proceso de acción.

94

Configurar

8. Para crear objetos de este tipo en el área de trabajo del proyecto Archivo > Nuevo > Documento,seleccione la casilla de verificación Usar en operaciones Archivo/Nuevo/Documento.

9. Para restringir la cantidad de objetos de este tipo que se crean en el área de trabajo delproyecto usando Archivo > Importar, desactive la casilla de verificación Usar en operacionesArchivo/Importar.

10. Consulte el tema Crear un tipo de documento, página 32 para obtener detalles sobre los atributos.

11. Haga clic en Siguiente y seleccione la pestaña Configuración. Haga clic en Editar para los Tipospermitidos y seleccione los tipos de proceso de acción según sea necesario. Haga clic en Aceptarpara guardar y seleccione la pestaña Configuración.

95

Configurar

12. Seleccione Permitir comentarios en elementos de asunto en este tipo de proceso para que losusuarios puedan agregar comentarios al documento adjunto a este proceso.

13. Seleccione Evitar varios procesos de este tipo con el mismo elemento de asunto para permitir alos usuarios crear más de un proceso de este tipo con el mismo documento adjunto.

14. En el cuadro de lista Primer paso, especifique el paso inicial del proceso en la lista de pasosdefinidos.

15. Para cada tipo permitido seleccionado para este proceso, defina el estado de cada objeto alfinalizar el proceso.

16. Haga clic en Agregar en el área de definición de los pasos del proceso.

96

Configurar

a. Escriba un nombre para el paso.

b. Escriba una etiqueta para el paso.

c. Proporcione las instrucciones que se mostrarán en la tarea para este paso.

d. Cuando el usuario completa el paso en curso, se muestra una lista de pasos. Seleccione lalista de los pasos para retroceder que se muestran cuando un usuario completa los pasos.

e. Seleccione la lista de los pasos para “continuar” que se harán visibles cuando un usuariocomplete un paso.

97

Configurar

f. Cuando los usuarios aceptan la invitación para realizar un paso, tienen que estar en un rolconcreto para ejecutar la tarea requerida en el documento. Esta configuración permite definir,para cada tipo, el rol que se asigna al usuario cuando se acepta el paso.

g. Cuando un usuario acepta la invitación para ejecutar el paso, esta configuración le permitedefinir el atributo en el documento para almacenar el nombre de usuario como ejecutantede dicha tarea.

h. Esta configuración define el estado en el que se deben establecer los documentos cuandoel paso está activo.

i. Cuando los usuarios completan un paso, esta configuración define el atributo en eldocumento que almacena la fecha de Finalización.

17. Haga clic en Aceptar para guardar y cerrar.

Configurar una matriz de distribuciónUna matriz de distribución se emplea para definir una matriz de condiciones frente a los destinatariosde manera que el sistema los seleccione de forma dinámica cuando se cumplen las condiciones.


• Crear una matriz de distribución, página 98

• Revisar una configuración de tipo de matriz de distribución existente, página 99

• Revisar una configuración existente de plantillas de matriz de distribución, página 99

• Crear una matriz de distribución para un proceso nuevo, página 100

Crear una matriz de distribución1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 05 Matrices de distribución > 01 Administración.

2. Seleccione Archivo > Nuevo > Matriz de distribución.

3. Dé un nombre a la nueva matriz de distribución.

4. Seleccione el tipo de documento como:• Matriz de proceso: si está creando una matriz de distribución para un proceso de acción.

• Matriz de transmisión: si está creando una matriz de transmisión para un proceso detransmisión.


6. Seleccione la plantilla Distribución en la lista desplegable Plantilla.

7. Haga clic en el botón de la esquina superior izquierda para agregar columnas a la matriz dedistribución.

8. Agregue usuarios/grupos como posibles destinatarios.

9. Agregue filas a la matriz de distribución utilizando el botón que tiene una imagen +.

98

Configurar

10. Dé nombre a la fila de distribución.

11. Haga clic en el enlace Agregar condiciones de cada fila y especifique las condiciones que sedeben cumplir para elegir los destinatarios para esa fila.

12. Edite las celdas de cada destinatario para definir la Tarea o razón.

13. Seleccione la Tarea o razón para las distintas columnas y haga clic en Finalizar para guardarla matriz.

14. Una vez creada la matriz, seleccione Herramientas > Acciones y haga clic en Publicar matrizpara que quede a disposición de un proceso de acción o transmisión.

Revisar una configuración de tipo de matriz dedistribución existente1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 22 Matrices de distribución > 01 Tipos.

2. Seleccione un tipo de matriz existente.


4. Seleccione la pestaña Información.• Para restringir la creación de matrices de distribución de este tipo, desactive la casilla de

verificación Archivo > Nuevo > Documento.

• Para asociar el tipo de matriz existente a otra plantilla de matriz de distribución, haga clic enEditar en Plantilla.

• Para restringir a los usuarios a un conjunto predefinido de nombres al crear los objetos dedocumento, haga clic en Editar para Convenciones de nomenclatura.

• Para especificar los atributos que no se muestran en la ventana de propiedades de lasinstancias de este tipo de documento, haga clic en Editar para Atributos ocultos.

• Para especificar los atributos que se muestran en la ventana de propiedades de las instanciasde este tipo de documento, haga clic en Editar para Atributos obligatorios.

• Para especificar los atributos que se muestran de solo lectura en la ventana de propiedades delas instancias de este tipo de documento, haga clic en Editar en Atributos de solo lectura.

• Para especificar que los objetos creados mediante este tipo sigan una configuración deautonumeración, haga clic en Editar para Configuración de numeración.


Revisar una configuración existente de plantillas dematriz de distribución1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 22 Matrices de distribución > 02 Plantillas.

2. Seleccione una matriz existente.

99

Configurar


4. Seleccione la pestaña Distribución.• Defina las columnas de la matriz de distribución de manera que los usuarios puedan decidir

al crear instancias si usan la columna programación o agregan/modifican los detalles.

• Defina las filas y condiciones específicas para cada fila de manera que los usuarios puedandecidir al crear instancias si usan la columna programación o agregan/modifican los detalles.


Crear una matriz de distribución para un proceso nuevo

Existen dos formas de crear una matriz de distribución para un proceso nuevo:

1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 22 Matrices de distribución > 02 Plantillas.

2. Seleccione Archivo > Nuevo > Plantilla de matriz de distribución.

3. Dé un nombre a la nueva plantilla de matriz de distribución. (Ignore la advertencia que se genera).

4. Haga clic en Finalizar para guardar.

5. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 22 Matrices de distribución > 01 Tipos.

6. Seleccione el tipoMatriz de proceso y abra el cuadro de diálogo Propiedades.

7. Agregue la plantilla recién creada al atributo Plantillas.


9. Vuelva a la carpeta 22 Matrices de distribución /02 Plantillas y abra el cuadro de diálogoPropiedades de la nueva plantilla.

10. Haga clic en Editar el atributo Tipos de destino válidos y seleccione el nuevo proceso de acción.

11. Haga clic en Aceptar para guardar y cerrar.Segundo método para crear una matriz de distribución para un proceso nuevo:

100

Configurar

1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 22 Matrices de distribución > 02 Plantillas.

2. Seleccione Archivo > Nuevo > Plantilla de matriz de distribución.

3. Dé un nombre a la nueva plantilla de matriz de distribución. (Ignore la advertencia que se genera).

4. Haga clic en Finalizar para guardar.

5. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 22 Matrices de distribución > 01 Tipos.

6. Seleccione Archivo > Nuevo > Tipo de matriz de distribución.





11. Agregue la plantilla recién creada al atributo Plantillas.

12. Seleccione Distribución de proceso de acción en el Tipo de distribución.

13. Seleccione la casilla de verificación Usar en operaciones Archivo/Nuevo/Documento, de maneraque el nuevo tipo esté disponible cuando se crean matrices de distribución.

14. Especifique cualquier otro atributo que sea necesario.

15. Vuelva a la carpeta 22 Matrices de distribución /02 Plantillas y abra el cuadro de diálogoPropiedades de la nueva plantilla.

16. Haga clic en Editar el atributo Tipos de destino válidos y seleccione el nuevo proceso de acción.

17. En la pestaña Reglas de contenido, agregue este tipo de matriz de distribución al atributo Tiposde documentos específicos.

101

Configurar


Importar matrices de distribución

Puede importar los detalles de la matriz de distribución usando una hoja de cálculo. La hoja decálculo proporciona los detalles de la matriz de distribución y de la información de los destinatarios.

El paquete de instalación de Capital Projects contiene hojas de cálculo de ejemplo para la matriz dedistribución. Estas hojas de cálculo se encuentran en <install package>\Samples>. Consulte lasiguiente tabla.

Tabla 20. Matriz de distribución

Nombre decolumna

Uso Descripciones

Encabezado: <Name> Este encabezado de columna procede delarchivo RCF. Puede editar el parámetrodist_col_hdg_row_name en el archivoRCF.

Nombre de fila

Valores: <any userdefined value>

Puede proporcionar cualquier valor definidopor el usuario en la matriz de distribución.Sin embargo, este valor debe ser exclusivo.Por ejemplo: Documentos de arquitectura,Documentos de mecánica, Documentos dediseño.

Separador <Any string ofcharacters configuredas a separator in RCF>

Puede utilizar cualquier cadena de caracterescomo separador configurado en RCF. Elsiguiente separador se utiliza en RCF comoejemplo de muestra. Por ejemplo: ******

102

Configurar

Encabezado: <object_type>.<attribute_name>.(<operator>)

<object_type>: puede especificar cualquier tipode objeto disponible en el repositorio dado.Por ejemplo, ecs_doc,eif_doc

<attribute_name>: puede especificar el nombrede cualquier atributo del tipo de objetoseleccionado. Por ejemplo, ecs_approvers,ecs_doc_type, ecs_doc_name, ecs_reviewers,ecs_security_profile, eif_discipline, eif_orginator

<operator>: especifique alguno de losoperadores.

Nota: Los atributos de tipo Fecha/Hora no seadmiten.

Condiciones

Valores: Valores separados por comas para la condiciónde encabezado. Por ejemplo: valor1, valor2,valor3

103

Configurar

Encabezado: En la hoja de información del destinatario sehace referencia al nombre de usuario. Estosnombres deben ser exclusivos.

Usuario

Valores: <taskOrReason>-<DeliveryMethod> Or<taskOrReason>

Puede utilizar cualquiera de los valoressiguientes:

Transmisión entrante: taskOrReason: I,N DeliveryMethod: SN por ejemplo: N,I, I-SN, N-SN ….

Transmisión saliente:taskOrReason: I,N DeliveryMethod: SN, EA, HCporejemplo: N, I, I-SN, N-SN, I-EA ….

Transmisión de revisión: taskOrReason:C, LR, AP, I DeliveryMethod:SNpor ejemplo: C, I-SN, LR, AP

Proceso de aprobación: no se requiere métodode entrega para el proceso de aprobación.Puede especificar taskOrReason comoRectify or Approve.

Proceso PVA: no se requiere método deentrega en los procesos de PVA. Puedeespecificar taskOrReason como Prepare,Verify, O Approve.

Donde,SN - System NotificationEA - Email AttachmentHC - Hard CopyI - InformationN - NotificationC - In-CommentingLR - Lead ReviewerAP - ApproverPrepare - PreparerVerify - VerifierApprove - ApproverRectify - Rectifier

Nota: Los valores proporcionados parael método de entrega en la hoja Matrizde distribución sobrescriben los valoresproporcionados en la hoja Información deldestinatario.

La hoja Info. destinatario incluye Name, Company, Group, Email, Is External User?, yand Delivery Method.

104

Configurar

Tabla 21. Info. destinatario

Nombresdecolumna

Uso Descripciones

Nombre <Valor definido -cualquier usuario>

Nombre del usuario que se usará como parte de la matriz dedistribución. Con usuarios externos, puede usar cualquiernombre definido por el usuario. No se realizará ningunavalidación en el caso de usuarios externos. Para usuariosinternos, debe asegurarse de que el nombre existe en elrepositorio.

Empresa <Valor definido porcualquier usuario>

(Opcional) Nombre de la empresa. Esto solo es aplicable a losusuarios externos.

Grupo <Para usuariosinternos: nombrede grupo deDocumentum alque perteneceel usuario>O<para usuariosexternos: cualquiervalor definido porel usuario>

Esto es obligatorio con los usuarios internos y se valida conla pertenencia del nombre de usuario proporcionado. Parausuarios externos, este es un valor definido por el usuario.Capital Projects no lleva a cabo ninguna validación.

Correoelectrónico

<Correoelectrónico válido>

Especifique un ID de correo electrónico válido. Esto esobligatorio para usuarios externos. Para usuarios internos, sehace referencia a los valores en la configuración del usuario.Por ejemplo, [email protected]

¿Es unusuarioexterno?

TRUE o FALSE Define si los usuarios son internos o externos.Si el valor se define como TRUE, indica que el usuario es externo.Si el valor se define como FALSE, indica que el usuario es interno.Si no especifica ningún valor O especifica cualquier otro, CapitalProjects lo considera FALSE.

Método deentrega

Transmisión:<métodode entregapredeterminadoque se usará>

Proceso deaprobación y PVA:<no se aplica>

Posibles valores de las transmisiones: SN, EA, HCEsta columna no es necesaria paraPVA o el proceso de aprobación.Descripción de los códigos abreviados del método de entrega:SN: notificación del sistemaEA: archivo adjunto de correo electrónicoHC: copia impresa

105

Configurar

Configurar el complementoDistributionMatrixImportProcessing

En el archivo de esquema RCF, puede personalizar los atributos editando el complementoDistributionMatrixImportProcessing.

Tabla 22. Parámetros del complemento DistributionMatrixImportProcessing

Nombre de parámetro Uso Descripción

dist_sheet_name Matriz dedistribución

Esto indica el nombre de la hoja Matriz dedistribución.

dist_col_hdg_row_name Nombre de fila Indica la etiqueta de encabezado del nombrede fila en la hoja Matriz de distribución.

dist_sheet_col_separator

***** Símbolo que se usa como separador decolumnas en la matriz de distribución.

dist_sheet_task_reason_delivery_method_separator

Separador (-) Se usa como separador entre las tareas y elmétodo de entrega en la hoja de la matriz dedistribución.

dist_sheet_valid_operators

=,<>,IN,NOTIN

Especifica cualquiera de los operadores: =,<>, IN, NOT IN además de definir lascondiciones.

rec_info_sheet_name Info.destinatario

Indica el nombre de la hoja de información deldestinatario.

rec_info_col_hdg_name Nombre Indica la etiqueta de encabezado de lacolumna Nombre en la hoja Información deldestinatario.

rec_info_col_hdg_company

Empresa Indica la etiqueta de encabezado de lacolumna Empresa en la hoja Información deldestinatario.

rec_info_col_hdg_group Grupo Indica la etiqueta de encabezado de la columnaGrupo en la hoja Información del destinatario.

rec_info_col_hdg_email Correoelectrónico

Indica la etiqueta de encabezado de la columnaCorreo electrónico en la hoja Información deldestinatario.

rec_info_col_hdg_is_external_user

¿Es un usuarioexterno?

Indica la etiqueta de encabezado de la columna ¿Es un usuario externo? Columna de la hoja Información del destinatario.

106

Configurar

rec_info_col_hdg_delivery_method

Método deentrega

Indica la etiqueta de encabezado de la columnaMétodo de entrega en la hoja Información deldestinatario.

is_atomic verdadero Si lo establece en verdadero, el sistemaactualiza la matriz de distribución solo si todaslas filas del archivo de Excel son válidas. Silo establece en falso, el sistema actualizará lamatriz de distribución con las filas válidas yregistrará los errores de las filas no válidas.

Cuando el contenido de la matriz de proceso o de la matriz de transmisión se actualiza en el entornode Capital Projects, se produce el evento ecs_content_updated y se inicia el complementoDistributionMatrixImportProcessing.

El complemento lee la información de la hoja de cálculo y actualiza el objeto matriz de distribución.Asimismo, se agrega la hoja de cálculo como una copia.

Si la importación es correcta, el contenido principal de los objetos cambiará por una matriz dedistribución y el archivo de Excel se adjuntará como una copia. O bien, el archivo de Excel continúasiendo el contenido principal del objeto. Puede verificar los mensajes de validación en el cuadrode diálogo de propiedades.

Configurar copiasLas copias permiten ver una versión PDF de un documento.


• Configurar los servicios de administración de copias, página 107

Configurar los servicios de administración de copias

Solicitudes de copias ad-hoc

Capital Projects ofrece la generación de operaciones de copia para cualquier documento yproporciona una lista de nombres de copias que se pueden seleccionar y después comprobar si esacopia concreta existe; también proporciona una opción de omisión.

De manera predeterminada, la capacidad de solicitar copias ad hoc está desactivada.Tiene que agregar la operación generate_rendition al estado del ciclo devida respectivo en el perfil de seguridad obligatorio para habilitar la operación.A continuación, la definición de la operación:<operation type="generate_rendition" dynamic="multiselect"is_bulk="false" name="generate_rendition" roles="controllers"label="Generate Rendition" help_tip="Generate rendition for the selected documents">

<params><param name="helpTip" enable_split="false"><![CDATA[

107

Configurar

<p>Use this action to generate rendition for the selected documents.</p><p>Choose rendition from the drop down or enter a new name</p><p>It is possible to overwrite an existing renditionby checking the Overwrite checkbox</p>]]></param><param name="user_select_name" value="true" /><param name="replace_existing" value="true" /><param name="target_rendition_name" value="pdf" /></params>

<preconditions><precondition reference="auto_render_available"/></preconditions>

<validators>

<validator reference="unique_rendition_name"/></validators>

<actions><action reference="generate_rendition_action"/></actions></operation>

Para habilitar esta operación en un perfil concreto, agregue simplemente esta línea bajo la etiquetaoperaciones:<operations><operation reference="generate_rendition" /></operations>

Los parámetros se describen del modo siguiente:

• user_select_name: determina si el usuario dispone de una interfaz de usuario para seleccionarel nombre de la copia o si se establece mediante programación. Este parámetro se debe estableceren “verdadero”. Cuando se establece en “falso”, el componente Webtop no muestra la interfaz deusuario. Este parámetro también determina si se debe realizar la validación de los nombres delas copias.

• replace_existing: establece el valor predeterminado en la interfaz de usuario de operaciones.

• target_rendition_name: nombre predeterminado de la copia generada cuandouser_select_name=false

• Esta acción, a la que se llama mediante esta operación, también se agrega al registro de acciones:<action name="generate_rendition_action"class="com.ecs.framework.library.contentmanagement.execution.actions.GeneratePdfRenditionUsingADTS" propagate_exceptions_on_failure="false"error_level="error" use_method_server="true"><params><param name="media_profile_name" value="document_to_pdf"/><param name="request_type" value="async"/><param name="request_timeout" value="30000"/><param name="source_page" value="0"/><param name="failure_message" value="Could not generate rendition"/><param name="success_message" value="Generate rendition request successfully

completed."/></params></action>

108

Configurar

Los siguientes parámetros también están disponibles:— media_profile_name: perfil de medios empleado para generar la copia en PDF.

— request_type: tipo de solicitud ADTS, sincrónica o asincrónica.

— request_timeout: intervalo de tiempo de espera de la solicitud ADTS.

— source_page: modificador de página de la copia de origen.

— failure_message: muestra el mensaje al usuario de la aplicación si la solicitud da error.

— success_message: muestra el mensaje si la solicitud es correcta.

Si ADTS está disponible o no se está ejecutando o no está instalado, las precondiciones siguientesdeben establecerse consecuentemente:

Si ADTS está disponible o no se está ejecutando o no está instalado, las precondiciones siguientesdeben establecerse consecuentemente:<renditioning>

<auto_render is_available="true"/></renditioning>

Si el marcador is_available está establecido en verdadero, la operación se muestra en la listade operaciones disponibles.

Configurar la carga de documentosLa funcionalidad de carga de documentos se utiliza para cargar una cantidad grande de documentosen el repositorio. Esta funcionalidad ayuda a especificar los valores de atributo junto con el contenidode los objetos. La configuración de carga de documentos para nuevos tipos de documentos implica laconfiguración de RCF y el proyecto. Esta funcionalidad está definida para los tipos de documentossiguientes:• Correspondencia

• Entregable externo

• Entregable interno

• Proyecto


• Configurar la carga de documentos de nuevos tipos de documentos en RCF, página 109

• Ejemplo de hoja de cálculo, página 111

• Configurar la carga de nuevos tipos de documentos en un proyecto, página 112

• Definir reglas de coincidencia, página 114

Configurar la carga de documentos de nuevos tipos dedocumentos en RCF1. Vaya a la sección execution_logic_definitions bajo la sección document_loading del

RCF.

109

Configurar

2. Copie una etiqueta execution_logic existente y péguela al final de la etiquetaexecution_logic_definitions.

3. Haga las modificaciones siguientes en este código:<execution_logic_definition name="MyTestDocType" extends=

"EIF Base Execution Logic Attributes" doctype="MyTestDocType">- <preconditions>- <precondition name="Is for execution action precondition"

class="com.ecs.framework.library.bulkupload.preconditions.IsForContextActionPrecondition">- <params>

<param name="for" value="ECSF Execution Action" /><param name="doctype" value="MyTestDocType" /></params></precondition></preconditions>

- <sets><include_from_base name="Name" /><include_from_base name="Revision" /><include_from_base name="Title" /><include_from_base name="Document Status" /><include_from_base name="Issue Reason" /><item name="column" value="Acceptance Code" /><include_from_base name="Type of Document" /><include_from_base name="Originator" /><include_from_base name="Responsible" /><include_from_base name="Discipline" /><item name="column" value="System" /><include_from_base name="Sequence Number" /><include_from_base name="Storage Path" /><include_from_base name="Content" /><include_from_base name="Rendition Name" /><include_from_base name="Rendition" /><include_from_base name="Link To" />

<set name=Custom Attribute Label"><item name="column" value="Custom Attribute Label"/><item name="logic" value="Attribute"/><item name="logic" value="Attribute"/>

</sets></execution_logic_definition>

a. name="MyTestDocType": especifique el nombre del nuevo tipo de documento.

b. extends="EIF Base Execution Logic Attributes": no lo cambie. Larecomendación es utilizar "Atributos lógicos de ejecución básica EIF" en el atributo extendido.

c. doctype="MyTestDocType": especifique el nombre del nuevo tipo de documento en elatributo doctype.

d. param name="doctype" value="MyTestDocType": especifique el nombre del nuevotipo de documento en el parámetro doctype para la precondición.

110

Configurar

e. sets: la sección sets configura las columnas que puede agregar a la hoja de carga.• Agregue las columnas definidas en supertipo usando include_from_base. Haga

referencia en el nombre al nombre del conjunto definido en supertipo.

• Para definir un atributo personalizado o un atributo que no está definido en supertipo,agregue un nuevo set. Conjunto se define usando tres elementos

— <item name=”column” value=”Column Label”/>: define el encabezado decolumna que se mostrará en la hoja de Excel. Cambie esta etiqueta según sea necesario.

— <item name=”logic” value=”Attribute”/>: define la clase de controladorpara este conjunto. No cambie esta etiqueta, cópiela según está.

— <item name=”parameter” value=”custom_attr_name”/>: define el nombrede atributo del tipo de objeto que se rellena a partir de los valores de una hoja decálculo de Excel. Cambie la etiqueta del valor de acuerdo con el nombre de atributo.

Nota: La carga de documentos no debe utilizarse como una utilidad de migración.

Ejemplo de hoja de cálculo

Una vez creado un objeto de carga de documento en el área de trabajo del proyecto, la hoja de Excelgenerada tiene este formato:

Descripción de la hoja de cálculo:1. Columna A: campo Estado de fila rellenado por el sistema, que indica si la fila se ha procesado

correctamente o ha dado error.

2. Columna B hasta el final: columnas diseñadas por el usuario para rellenar datos.

3. Las columnas con “*” indican campos obligatorios.

4. Las columnas cuyos valores se rellenan utilizando un valor de lista desplegable deben contenervalores solo de dicha lista desplegable; de lo contrario, la fila da error durante la validacióny proceso.

5. Campos especiales:

• Ruta de almacenamiento: define la ruta del repositorio donde se crea el objeto (enlaceprincipal).

• Enlazar con: define la ruta del repositorio con la que se enlazará este objeto (enlacesecundario).

111

Configurar

• Contenido: define la ruta relativa del archivo de contenido (incluyendo el nombre dearchivo con la extensión) en la ubicación de ruta compartida definida en la etiquetadocument_loading/content_location del RCF.

• Nombre de copia: especifica el nombre de la copia con el que se almacenan las copiassecundarias.

• Archivo de copia: define la lista separada por comas de la ruta relativa del archivo(incluyendo el nombre de archivo con la extensión) en la ubicación de ruta compartidadefinida en la etiqueta document_loading/content_location del RCF.

6. Especifique todos los campos de fecha en formato “DD/MM/AAAA hh:mm:ss”. Por ejemplo: el 8de agosto de 2012 es “8/8/2012 12:00:00 AM”.

Nota: La ubicación de la ruta compartida definida en el RCF debe ser accesible desde el equipo deContent Server y el servidor de aplicaciones.

Configurar la carga de nuevos tipos de documentosen un proyecto1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 05 Carga de documentos > 02 Plantillas.

a. Seleccione Archivo > Nuevo > Plantilla de carga de documentos. En la pestaña Crear:

b. Escriba un nombre en el campo Nombre.

c. Para seleccionar el tipo de documento nuevo, haga clic en Editar de Tipo de documentopermitido.

d. Seleccione las plantillas asociadas para el tipo de documento nuevo en el cuadro de lista Tipode documento permitido. Haga clic en Siguiente. En la pestaña Información:

112

Configurar

e. Utilice las Reglas de coincidencia de documentos para definir cómo se procesan losdocumentos de la hoja de carga masiva cuando existe un documento idéntico en una carpeta.(Los usuarios también pueden definir las condiciones que definen que un documento esidéntico a otro). El nuevo documento puede ser:• Creado como versión principal de un documento existente.

• Creado como versión menor de un documento existente.

• Creado sobrescribiendo el documento existente.

• Creado como nueva revisión del documento existente.

• Ignorado y mantenido el documento existente como está.

f. Establezca Valor en blanco en: BLANK o NULL

Nota: Para agregar más valores al cuadro de lista Valor en blanco, vaya a la etiquetablank_attribute_values bajo la etiqueta document_loading en el RCF. Agregue unetiqueta de valor para cada valor del cuadro de lista. Por ejemplo:

</blank_attribute_values><value>BLANK</value><value>NULL</value>

</blank_attribute_values>

g. Para evitar que el usuario que crea las hojas de carga de documentos utilizando esta plantillaedite la configuración de Valor en blanco y Reglas de coincidencia de documentos,seleccione la casilla de verificación Configuración de bloqueo de plantilla.

h. Haga clic en Aceptar para guardar y cerrar.

2. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 05 Carga de documentos > 01 Tipos.

3. Seleccione Archivo > Nuevo > Tipo de carga de documentos.

4. En el cuadro de lista Perfil de seguridad, seleccione Carga.



113

Configurar

7. Haga clic en Editar para Plantillas y agregue la plantilla nueva.

8. Para crear objetos de este tipo en el área de trabajo del proyecto usando Archivo> Nuevo >Documento, seleccione la casilla de verificación Usar en operacionesArchivo/Nuevo/Documento.


Definir reglas de coincidencia

Las reglas de coincidencia definen cómo se procesan los documentos cuando existe un documentoidéntico en una carpeta. Las reglas de coincidencia se definen en las plantillas de carga dedocumentos o en las instancias del objeto de carga de documento.

1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)> 05 Carga de documentos > 02 Plantillas.

2. Seleccione la plantilla para la que se están configurando las reglas de coincidencia.


4. Haga clic en Editar para Reglas de coincidencia de documentos.

5. Haga clic en Agregar para especificar las condiciones que califican un documento como idéntico.

114

Configurar

6. Haga clic en Aceptar para especificar la acción que se ejecutará ante la condición utilizando losvalores del cuadro de lista. Haga clic en Agregar para añadir más condiciones.


Configurar el progreso de la planificaciónEl progreso de la planificación ayuda a hacer el seguimiento del progreso del documento. Se puedeconfigurar y hacer el seguimiento en un documento utilizando planificación basado en esfuerzos oplanificación basada en progreso. La planificación se puede aplicar a los documentos en todos losestados del ciclo de vida excepto Anulado, Cancelado y Sustituido.

Para aplicar la planificación a los documentos, cree una plantilla de planificación y después aplíquelaal objeto de documento.

Estos son los temas que se incluyen en esta sección:• Crear una plantilla de progreso de la planificación, página 115

• Aplicar la plantilla de progreso de la planificación a un tipo de documento, página 116

• Aplicar la plantilla de progreso de la planificación a un tipo de documento:, página 117

Crear una plantilla de progreso de la planificación1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 25 Plantilla de planificación de documentos.

2. Seleccione Archivo > Nuevo > Plantilla de planificación de documentos.

3. En la pestaña Crear, escriba un nombre en el campo Nombre.

4. En la pestaña Plantilla de planificación, agregue una descripción en el campo Descripción.

5. Haga clic en + para agregar un evento.

115

Configurar

a. Nombre: proporcione un nombre para identificar el evento.

b. Peso: proporcione el peso del evento para calcular el progreso realizado en la finalizacióndel evento.

c. Control de tiempo: define el período de tiempo para la finalización del evento después dela finalización de su predecesor.

d. Condiciones: establezca la condición para decidir los criterios de finalización del evento. Sepueden agregar condiciones haciendo clic en “+” en la pantalla. La lista de condiciones delcuadro de lista Nombre de condición se configuran en la sección scheduling_progressdel RCF.

6. Seleccione el icono Establecer el orden de los eventos para reordenar los eventos.

7. Haga clic en Finalizar para guardar y cerrar.

Aplicar la plantilla de progreso de la planificación a untipo de documento1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 01 Tipos de documentos > 01 Tipos.

2. Haga clic con el botón derecho en un documento y seleccione Propiedades.

3. En la pestaña Información, desplácese a la opción Configuración de planificación/progreso yhaga clic en Editar.

116

Configurar

4. Seleccione una de las siguientes opciones:• Habilitar progreso basado en esfuerzos: habilita la planificación basada en el tiempo

necesario para finalizarla y el número de días que faltan para la finalización.

• Habilitar planificación de documento: establece una plantilla de planificación para habilitarel progreso basado en eventos hecho en el documento.

5. Seleccione una plantilla de planificación en el cuadro de lista Seleccionar plantilla deplanificación.


Aplicar la plantilla de progreso de la planificación a untipo de documento:1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (carpeta del proyecto)

> 01 Tipos de documentos > 01 Tipos.

2. Haga clic con el botón derecho en un tipo de documento y seleccione Acciones.

Nota: Las acciones que se muestran se basan en los permisos del usuario conectado. Para ver laopción Habilitar planificación o progreso, debe disponer de los permisos correctos.

3. Seleccione la acción Habilitar planificación o progreso.

4. Seleccione una de las siguientes opciones:• Habilitar planificación de documento: establece una plantilla de planificación para habilitar

el progreso basado en eventos hecho en el documento. Después, seleccione una plantilla deplanificación en el cuadro de lista Seleccionar plantilla de planificación.

• Habilitar progreso basado en esfuerzos: habilita la planificación basada en el tiemponecesario para finalizarla y el número de días que faltan para la finalización.


Controlar el acceso al contenido de AssetOperationsEn los casos en que las aplicaciones Capital Projects y Asset Operations compartan elmismo repositorio, puede controlar si los usuarios finales de Capital Projects tienenacceso para examinar o acceso para leer el contenido. Los usuarios con acceso paraexaminar no pueden ver el contenido del documento. Los usuarios finales con acceso delectura pueden ver el contenido del documento. El valor predeterminado es Browse. Siproporciona otros valores, Capital Projects produce la excepción RcfParserException.Ambos niveles de acceso permiten a los usuarios finales ver las propiedades (Información e Historialúnicamente), versiones, relaciones y ubicaciones de los documentos.

1. Retire el archivo RCF-Schema.xml.

2. Vaya al elemento <asset_operations>.

117

Configurar

3. Actualice el valor del elemento secundario <content_access>.En el ejemplo siguiente se muestra el código para el acceso de examinar:<asset_operations><content_access>browse</content_access>

</asset_operations>

En el ejemplo siguiente se muestra el código para el acceso de lectura:<asset_operations><content_access>read</content_access>

</asset_operations>

4. Haga clic en el archivo RCF-Schema.xml actualizado.

5. Inicie sesión en la aplicación y seleccione Herramientas > Releer configuración de RCF en labarra de menús.

6. Cierre sesión y después inicie sesión en Capital Projects para completar la actualización.

Configurar etiquetas para eventos del historialempresarialEl elemento <business_audit_events> del RCF define las etiquetas de cada evento que sedesencadena en Capital Projects. Puede actualizar el atributo display_name del elemento<business_audit_event> correspondiente para actualizar la etiqueta según se muestra en losinformes de la interfaz de usuario.

Configurar la autoextracción de propiedadesdel correo electrónicoEl complemento GetMsgEmailProperties de RCF se desencadena en la creación de un documentoy en la actualización de contenido para extraer las propiedades del mensaje de correo y copiarlas enlos atributos configurados en el nuevo objeto. Puede configurar qué propiedades del mensaje decorreo electrónico se va a asignar como valores de qué atributos del objeto. Las propiedades de losmensajes de correo electrónico son:

Tabla 23. Propiedades del correo electrónico

Propiedad Tipo de datos Descripción

PR_SUBJECT Cadena Asunto

PR_DISPLAY_FROM Cadena Mostrar destinatario: De

PR_DISPLAY_TO Cadena Mostrar destinatario: Para

PR_DISPLAY_CC Cadena Mostrar destinatario: Cc

PR_CLIENT_SUBMIT_TIME

Hora Contiene la hora, en UTC, en que se envía el mensajede correo electrónico.

118

Configurar

PR_MESSAGE_DELIVERY_TIME

Hora Contiene la fecha y hora de entrega de un mensaje.

PR_CREATION_TIME Hora Contiene la fecha y hora de creación de un mensaje.

El parámetro attributes del complemento contiene la lista separada por comas de los atributos deobjeto para las propiedades de correo electrónico correspondientes mencionadas en el parámetroproperties. Actualmente solo admite formatos entourage_msg & msg. Capital Projects noadmite formatos como eml.

119

Configurar

120

Capítulo 3Configuración del conector de CapitalProjects para Supplier Exchange

El conector de Capital Projects para Supplier Exchange conecta Capital Projects a un software comoun servicio de entorno (SaaS) Supplier Exchange. Después de instalar el conector, los dueños ylos operadores de las plantas pueden intercambiar entregables y transmisiones con empresas deingeniería, suministro y construcción a través de Supplier Exchange.

Estos son los temas que se incluyen en esta sección:• Habilitación del conector de Capital Projects para Supplier Exchange, página 121

• Configurar las conexiones del sistema, página 121

• Registrar Capital Projects con proyectos de Supplier Exchange, página 122

• Registrar el documento entregable externo con Supplier Exchange, página 123

• Enviar las transmisiones generales a Supplier Exchange , página 124

• Cerrar entregable, página 124

• Controlador de mensajes, página 125

Habilitación del conector de Capital Projectspara Supplier ExchangeEn el archivo RCF, puede habilitar o deshabilitar el conector de Supplier Exchange actualizandolos parámetros siguientes:<param name="isXchangeEnabled" value="false"/>

Establezca el parámetro isXchangeEnabled en true para habilitar el conector de Capital Projectspara Supplier Exchange. De forma predeterminada, este valor se establece en false.

Configurar las conexiones del sistemaPara conectar a Supplier Exchange utilizando Capital Projects, <RCF>/<system_connections>debe actualizarse con el elemento <system_connection> siguiente:<system_connection name="Supplier Exchange Site" description="Supplier Exchange Site"

121

Configuración del conector de Capital Projects para Supplier Exchange

type="xChange" provider="beacon"><url>http://xchange-emc.emcondemand.com/Beacon</url><key_id encryption="dfc" >uvo/yFu6FwOUYp19nZy7603HT1rs748LF37dYfm9wB/zUubfsY+q8A==></key_id><private_key encryption="dfc">MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBAL0zP+HgaRD+qq5cZC8Olheut14LtNCRGaBmU4paOUbhLUxvuQ2ndUe8qL22RNNSFp64upSDNq9QFMsDegoWnGPvfT3dvJ7aysGxBaZPz2MM5CXL8c3Z9nIdi7g0Et1ZdCbQhkzW57fIgbRyyIaHc5FLuNs9r9frcqyBC3mZId2vAgMBAAECgYAJA++n1jcmHFR1ZtP5RWMpMWXtwSC2YtZLRS+hjedhIBVgqTQyroeRSa/qtkw08O+V/uxua4rdXgis8cyiEsNp5K1ui5WrjcdHuBcyHuk+kC8fn8w0SkXirN4rRYDkVGx7WJdfM3kx9tjrLKLIeCcXl/acERwXoe0HUhgh4y16WQJBAODuf3BeoGpmhhWV1+K9ftVZjKihVXFBexuGGg4sy2Tef0ilCNpou/zZ9/a7KhAgyu8wkpaTVTih5BxsS84AktkCQQDXVU0CyxR+uUi07MNBOSyUv1azwgdE6NxGvrXFQw8n7mLJhojDjtZpHXCHUFdgCXCmbnVoZlMRhs5JCln3nQ/HAkEAjEVvh/4a//+rwq5NkYMnI5nS1B64kAaL5WA9w3U/6kmvCviQitQh189+iYmy85fftkaORAThco3TGb6Xj4JgEQJAQot04iEaM1NVGbx1VsmxckJzK9gRYQVJVX+IMu7XVzK/SqINz8lrj05uwRJd/irMqlJGbD36+9aaF05goTnjbwJBAIXbcD2mcSI2e2ieIhWh+WBzdvq/G9IjB5VByUmfvBXgKVsNjvjdqNcKi8839sPzjpFA/XaIcjv9IX52J1FIVTY=</private_key><proxy_host>localhost</proxy_host><proxy_port>8888</proxy_port>

</system_connection>

Donde:• url: especifique url para conectar a Supplier Exchange.

• key_id: este elemento tiene un nombre de atributo encryption cuyo valor posible esdfc. Porejemplo, si tiene <key_id encryption=“dfc”>xxxxxxx</key_id> el valor xxxxxxx sedescifra utilizando la clase RegistryPasswordUtils de DFC.

Consulte la documentación de Supplier Exchange para la generación de key_id y private key.

• private_key: especifique la clave de cifrado/descifrado.

• proxy_host : especifique los detalles del host proxy, si lo hay.

• proxy_port : especifique el puerto proxy, si lo hay.

Nota: Donde los valores key_id y private_key se generan en la página Cuenta de servicio deSupplier Exchange.

Cifrado usando DFC

Puede cifrar key_id y private_key.Para cifrar una contraseña, ejecute el comando siguiente:

java-cp<path_to_dfc_jar>\dfc.jar com.documentum.fc.tools.RegistryPasswordUtils<text_to_encrypt>

Registrar Capital Projects con proyectos deSupplier ExchangePara registrar Capital Projects con un proyecto Supplier Exchange, debe crear un proyecto de SupplierExchange con el mismo código de proyecto que el de la referencia de Capital Projects.

122


Para registrar el proyecto:1. Inicie sesión en Capital Projects.

2. Vaya al área de trabajo del proyecto.

3. Seleccione el proyecto que se va a registrar.

4. Haga clic en Herramientas > Acciones.

5. Haga clic en Registrar proyecto con Supplier Exchange

En el RCF, puede configurar la operación <operation name="register_project_xchange">y la acción <action name=”register_project_xchange_action”> para realizar el registrodel proyecto.

Registrar el documento entregable externo conSupplier ExchangeLos documentos entregables externos creados en Capital Projects se pueden registrar en SupplierExchange, o bien realizando la acción Registrar entregable con Supplier Exchange, o bienautomáticamente mediante el complemento cuando se cree el documento en el proyecto. Losdocumentos se registran automáticamente con Supplier Exchange si ya se ha registrado el proyecto.En el caso de aquellos documentos que se han creado antes registrar el proyecto, debe registrarloscon Supplier Exchange.

Para registrar automáticamente los entregables con Supplier Exchange, debe actualizar los siguientesatributos en el RCF:<plugin applicable_types="External Deliverable Document"class="com.emc.eix.pluggable.plugin.RegisterDeliverablePlugin"name="RegisterDeliverable" run_on_event="ecs_creation_finished">

<params><param name="process_immediately" value="false"/><param name="project_expression" value="${project.r_object_id}"/><param name="deliverable_list"value="${CONDITIONAL(HASTEXT(this.eif_discipline),this.eif_discipline,’Default’)}"enable_split="false"/>

</params><preconditions><precondition reference="isXchangeEnabled"/>

</preconditions></plugin>

Donde:• Cuando el parámetro del complemento process_immediately se establece en true, registrará

inmediatamente el proyecto con Supplier Exchange. De lo contrario, se registra cuando se ejecutael trabajo Registrar entregables con xChange.

• El parámetro del complemento y de la acción deliverable_list toma el valor de la disciplina delatributo establecida en el documento. Si este atributo no se ha establecido, entonces establece elvalor como Predeterminado.

123


Enviar las transmisiones generales a SupplierExchangeEn el archivo RCF, puede configurar el mecanismo de entrega para enviar las transmisiones aSupplier Exchange mediante el elemento.<rcf>\<transmittals>\<distribution>\<delivery_methods>\<delivery_method name=”EXH”>

Puede quitar la marca de comentario del mecanismo de entrega en el RCF.

En Capital Projects:1. Vaya a Transmisiones > Tipos > Transmisión general > Propiedades.

2. En la pestaña Configuración, editeMétodos de envío de destinatarios.

3. Agregue Sitio Supplier Exchange como uno de los métodos de entrega.

Cuando envía las transmisiones generales, esta opción estará disponible como una de las opcionesde la lista Entrega por.

El valor de la empresa debe ser el mismo que el valor del contrato en Supplier Exchange al enviar latransmisión general.

El validador <Validator name= tr_xch_check_recipient> comprueba si el conjunto dedestinatarios de la transmisión general existe en Supplier Exchange.

Cerrar entregableEn el archivo RCF, puede configurar el complemento <plugin name="CloseDeliverable> paracerrar el entregable en Supplier Exchange. Puede configurar el parámetro states, que aceptavalores separados por comas.

Cuando el documento entregable externo alcanza cualquiera de los estados configurados en el RCF,se activa el complemento para eliminar el entregable en Supplier Exchange.<plugin name="CloseDeliverable" run_on_event="ecs_target_state_reached"class="com.emc.eix.pluggable.plugin.DeliverableStateChangePlugin"applicable_types="External Deliverable Document">

<params><param name="states" value="Cancelled,Void,Superseded"/>

</params><preconditions><precondition reference="isXchangeEnabled"/>

</preconditions></plugin>

124


Controlador de mensajesLos controladores de mensajes se encargan de controlar tipos de mensajes específicos. El enlace entreun mensaje y su controlador es message_key. El message_body ofrece la descripción del mensaje.En el archivo RCF, puede configurar las siguientes message_keys (claves de mensajes):1. En el archivo RCF, vaya hasta el parámetro message_handler.

2. Ubique la message_key respectiva y actualice los detalles de descripción obligatorios.

Tabla 24. Detalles de las claves de mensajes

message_key message_type Descripción

EIX_DELIVERABLE_REGISTER_FAILURE

Registro del entregable El controlador de mensajespara las notificaciones cuandose produce un error en elregistro del entregable al sitioSupplier Exchange.

EIX_INCOMING_TR_NOTIFICATION

Notificación de transmisión El controlador de mensajespara las notificaciones cuandose recibe una transmisiónde entrada y requiere unprocesamiento.

EIX_INCOMING_TR_FAILURE

Error en la transmisión deentrada

El controlador de mensajespara las notificaciones cuandose produce un error en unatransmisión de entrada paraimportar documentos desdeSupplier Exchange hastaCapital Projects.

Trabajos en Supplier Exchange

Cuando el parámetro process_immediately se establece en false en el complemento <pluginname=”RegisterDeliverable"> , process_immediately, el trabajo Registrar entregablescon xChange registra todos los documentos entregables externos pendientes.

El trabajo Importar paquetes con xChange se utiliza para descargar todos los envíos desde xChangehasta Capital Projects. Estos documentos de envío se agregan a Capital Projects y se crea unatransmisión de entrada para los mismos.

125


126

Capítulo 4Tipos de documentos clave: permisos,acciones permitidas y operacionesdisponibles

Para los tipos de documentos clave disponibles en Capital Projects, las siguientes seccionesproporcionan una referencia a los permisos, a las acciones permitidas y a las operaciones disponiblespara cada rol en un estado de ciclo de vida determinado.


• Documentos entregables internos, página 127

• Documentos entregables externos, página 138

• Documentos de correspondencia, página 144

Documentos entregables internosLos documentos internos (documento entregable interno y documento de proyecto) se utilizan para:

• Transmisiones

• PVA

Estados del ciclo de vida de documentos internos

127

Tipos de documentos clave: permisos, acciones permitidas y operaciones disponibles

Tabla 25. Estados del ciclo de vida de documentos internos

Estados Descripción

Marcador de posición Indica un documento antes de su primerarevisión.

En preparación Indica una revisión del documento que se estápreparando.

Requiere verificación Indica una revisión del documento que se estabapreparando y ahora se está verificando.

Requiere aprobación Indica una revisión del documento que requierela aprobación antes de ponerlo a disposición.

Más reciente Indica la revisión del documento que se debeutilizar.

Más reciente (bajo revisión) Indica desde la segunda revisión del documentohasta la última cuando se ha creado una nuevarevisión, pero aún no está disponible.

Anterior revisión Indica una revisión del documento histórico.

Cancelado Indica una revisión del documento que nuncafue emitida y ya no es necesaria.

Nulo Indica una revisión del documento que fueemitida y ya no es necesaria.

Sustituido Indica una revisión del documento cuando se hasustituido (reemplazado) por otro documento.

• Documento de entrega interno: permisos de Documentum, página 129

• Documento de entrega interno: acciones permitidas, página 131

• Documento de entrega interno: operaciones disponibles, página 135

128


Documento de entrega interno: permisos deDocumentum

Las siguientes tablas muestran los permisos que se asignan a los usuarios de un rol específico enfunción del estado del documento.

Tabla 26. Documento de entrega interno: permisos de Documentum (1 de 2)

Estados del ciclo de vidaNombres de roles

Marcador deposición

Enpreparación

Requiereverificación

Requiereaprobación

Más reciente

Controlador DELETE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION

DELETE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION

WRITE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION


RELATE,CHANGE_PERMIT

Autores READ WRITE,CHANGE_STATE

RELATE RELATE RELATE

Colaboradores READ RELATE RELATE RELATE RELATE

Consumidores BROWSE BROWSE BROWSE BROWSE RELATE

Administradoresde comentarios

READ RELATE RELATE RELATE RELATE

Administradores DELETE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION





Preparar ejecutante READ WRITE,CHANGE_STATE


Comprobarejecutante

READ RELATE RELATE,CHANGE_STATE

RELATE RELATE

Aprobar ejecutante READ RELATE RELATE RELATE,CHANGE_STATE

RELATE

129




Enpreparación


Requiereaprobación

Más reciente

Colaboradores(plantilla)

READ RELATE RELATE RELATE RELATE

Consumidores(plantilla)

BROWSE BROWSE BROWSE BROWSE BROWSE

Tabla 27. Documento de entrega interno: permisos de Documentum (2 de 2)


Más reciente(bajo revisión)

Anteriorrevisión

Cancelado Nulo Sustituido

Controlador RELATE,CHANGE_PERMIT


READ,CHANGE_PERMIT

READ,CHANGE_PERMIT


Autores RELATE RELATE READ READ RELATE

Colaboradores RELATE RELATE READ READ RELATE

Consumidores RELATE RELATE READ READ RELATE


RELATE RELATE READ READ RELATE

Administradores WRITE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION





Preparar ejecutante RELATE RELATE READ READ RELATE

Comprobarejecutante


Aprobar ejecutante RELATE RELATE READ READ RELATE




BROWSE BROWSE BROWSE BROWSE BROWSE

130


Documento de entrega interno: acciones permitidas

Las siguientes tablas muestran las acciones permitidas disponibles para los usuarios de un rolespecífico en función del estado del documento.

Tabla 28. Documento de entrega interno: acciones permitidas (1 de 2)



Enpreparación


Requiereaprobación

Más reciente

Controlador change_membership,view_history,relate_to_document,ap_attach,dm_apply,edit_progress,view_progress

change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,ap_attach,dm_apply,edit_progress,view_progress



change_membership,view_history,view_comments,add_comments,new_revision,relate_to_document,manage_renditions,dm_apply,edit_progress,view_progress

Autores view_history,relate_to_document,dm_apply,view_progress

view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply,view_progress



view_history,view_comments,add_comments,new_revision,relate_to_document,manage_renditions,dm_apply,view_progress

131




Enpreparación


Requiereaprobación

Más reciente

Colaboradores view_history,relate_to_document,view_progress

view_history,view_comments,add_comments,relate_to_document,view_progress




Consumidores view_progress

view_progress

view_progress

view_progress

view_progress


— view_comments,add_comments,manage_comments

view_comments,add_comments,manage_comments



Administradores change_membership,view_history,view_progress

change_membership,view_history,view_progress




Prepararejecutante

— view_history,view_comments,add_comments,manage_comments,relate_to_document,manage_renditions,dm_apply

— — view_progress

Comprobarejecutante

— — view_history,view_comments,add_comments,manage_comments,relate_to_document

— view_progress

132




Enpreparación


Requiereaprobación

Más reciente

Aprobarejecutante

— — — view_history,view_comments,add_comments,manage_comments,relate_to_document

view_progress


— view_comments,add_comments

view_comments,add_comments




— — — — —

Tabla 29. Documento de entrega interno: acciones permitidas (2 de 2)



Anteriorrevisión


Controlador change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply,edit_progress,view_progress

change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply

change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply,edit_progress,view_progress



133




Anteriorrevisión


Autores view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply,view_progress

view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply




Colaboradores view_history,view_comments,add_comments,relate_to_document,view_progress

view_history,view_comments,add_comments,relate_to_document




Consumidores view_progress

— view_progress

view_progress

view_progress








change_membership,view_history




Prepararejecutante

view_progress

— view_progress

view_progress

view_progress

Comprobarejecutante

view_progress

— view_progress

view_progress

view_progress

Aprobarejecutante

view_progress

— view_progress

view_progress

view_progress

134




Anteriorrevisión









— — — — —

Documento de entrega interno: operacionesdisponibles

Las siguientes tablas muestran las operaciones disponibles para los usuarios de un rol específico enfunción del estado del documento.

Tabla 30. Documento de entrega interno: operaciones disponibles (1 de 2)



Enpreparación


Requiereaprobación

Más reciente

Controlador add_comment,apply_matrix,enable_scheduling_progress,disable_scheduling_progress,set_next_schedule_date,to_being_prepared,cancel_document,void_document,supersede_document

add_comment,apply_matrix,generate_rendition,enable_scheduling_progress,disable_scheduling_progress,set_next_schedule_date, to_latest, cancel_document,void_document,supersede_document

add_comment,apply_matrix,generate_rendition,enable_scheduling_progress,disable_scheduling_progress,set_next_schedule_date, cancel_document,void_document,supersede_document

add_comment,apply_matrix,generate_rendition,enable_scheduling_progress,disable_scheduling_progress,set_next_schedule_date, cancel_document,void_document,supersede_document

add_comment,apply_matrix,generate_rendition,enable_scheduling_progress,disable_scheduling_progress,set_next_schedule_date, cancel_document,void_document,supersede_document,create_new_revision

135




Enpreparación


Requiereaprobación

Más reciente

Autores — add_comment

add_comment

add_comment

create_new_revision,add_comment

Colaboradores — add_comment

add_comment

add_comment

add_comment

Consumidores — — — — add_comment


— add_comment

add_comment

add_comment

add_comment

Administradores insert_old_revision

add_comment,insert_old_revision




Prepararejecutante

— add_comment

add_comment

add_comment

add_comment

Comprobarejecutante

— add_comment

add_comment

add_comment

add_comment

Aprobarejecutante

— add_comment

add_comment

add_comment

add_comment


— add_comment

add_comment

add_comment

add_comment


— — — — —

136


Tabla 31. Documento de entrega interno: operaciones disponibles (2 de 2)



Anteriorrevisión


Controlador add_comment,apply_matrix,disable_scheduling_progress,set_next_schedule_date,generate_rendition,cancel_document,void_document,supersede_document

add_comment,apply_matrix,disable_scheduling_progress,set_next_schedule_date,generate_rendition

add_comment,apply_matrix,disable_scheduling_progress,set_next_schedule_date,reinstate_document

apply_matrix,disable_scheduling_progress,set_next_schedule_date,reinstate_document

add_comment,apply_matrix,disable_scheduling_progress,set_next_schedule_date, undo_supersede_document

Autores add_comment

add_comment

— — add_comment

Colaboradores add_comment

add_comment

— — add_comment

Consumidores add_comment

add_comment

— — add_comment


add_comment

add_comment

— — add_comment

Administradores add_comment,insert_old_revision





Prepararejecutante

add_comment

add_comment

— — add_comment

Comprobarejecutante

add_comment

add_comment

— — add_comment

Aprobarejecutante

add_comment

add_comment

— — add_comment

137




Anteriorrevisión



add_comment

add_comment

— — add_comment


— — — — —

Documentos entregables externosLos documentos entregables externos se utilizan para:

• Transmisiones

• Revisión y comentarios

Estados del ciclo de vida de documentos externos

Tabla 32. Estados del ciclo de vida de documentos externos


Marcador de posición Indica un documento antes de su primerarevisión.

Como enviado Indica la revisión del documento que se recibióde un proveedor pero no se ha revisadointernamente.

Más reciente Indica la revisión del documento que se debeutilizar.

Más reciente (bajo revisión) Indica desde la segunda revisión del documentohasta la última cuando se ha creado una nuevarevisión, pero aún no está disponible.

Anterior revisión Indica una revisión del documento histórico.

138



Cancelado Indica una revisión del documento que nuncafue emitida y ya no es necesaria.

Nulo Indica una revisión del documento que fueemitida y ya no es necesaria.

Sustituido Indica una revisión del documento cuando se hasustituido (reemplazado) por otro documento.

• Documento de entrega externo: permisos de Documentum, página 139

• Documento de entrega externo: acciones permitidas, página 140

• Documento de entrega externo: operaciones disponibles, página 142

Documento de entrega externo: permisos deDocumentum


Tabla 33. Documento de entrega externo: permisos de Documentum (1 de 2)



Como enviado Más reciente Más reciente (bajorevisión)

Controlador DELETE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION




Colaboradores READ RELATE RELATE RELATE

Consumidores BROWSE BROWSE RELATE RELATE


READ RELATE RELATE RELATE

Administradores DELETE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION




139






READ RELATE RELATE RELATE


BROWSE BROWSE BROWSE BROWSE

Tabla 34. Documento de entrega externo: permisos de Documentum (2 de 2)


Anterior revisión Cancelado Nulo Sustituido

Controlador RELATE,CHANGE_PERMIT


READ, CHANGE_PERMIT


Colaboradores RELATE RELATE READ RELATE

Consumidores RELATE RELATE READ RELATE


RELATE RELATE READ RELATE

Administradores WRITE,CHANGE_STATE,CHANGE_PERMIT,CHANGE_LOCATION





RELATE READ READ RELATE


BROWSE BROWSE BROWSE BROWSE

Documento de entrega externo: acciones permitidas


140


Tabla 35. Documento de entrega externo: acciones permitidas (1 de 2)




Controlador change_membership,view_history,relate_to_document,ap_attach,dm_apply,edit_progress,view_progress

change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,ap_attach,dm_apply,new_revision,edit_progress,view_progress

change_membership,view_history,view_comments, add_comments,new_revision, relate_to_document,manage_renditions,dm_apply,edit_progress,view_progress


Colaboradores view_history,relate_to_document,view_progress




Consumidores view_progress view_progress view_progress view_progress


— view_comments,add_comments,manage_comments








— view_comments,add_comments




— — — —

141


Tabla 36. Documento de entrega externo: acciones permitidas (2 de 2)



Controlador change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply,edit_progress,view_progress


change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,dm_apply


Colaboradores view_history,view_comments,add_comments,relate_to_document




Consumidores — view_progress view_progress view_progress






Administradores change_membership,view_history










— — — —

Documento de entrega externo: operacionesdisponibles


142


Tabla 37. Documento de entrega externo: operaciones disponibles (1 de 2)




Controlador add_comment,apply_matrix,enable_scheduling_progress, disable_scheduling_progress,set_next_schedule_date,to_as_submitted,cancel_document,void_document,supersede_document

add_comment,apply_matrix,generate_rendition, enable_scheduling_progress, disable_scheduling_progress,set_next_schedule_date,to_latest, cancel_document,void_document,supersede_document,create_new_revision

add_comment,apply_matrix,generate_rendition, enable_scheduling_progress, disable_scheduling_progress, set_next_schedule_date, cancel_document,void_document,supersede_document,create_new_revision

add_comment,apply_matrix,disable_scheduling_progress, set_next_schedule_date, generate_rendition, cancel_document,void_document,supersede_document

Colaboradores — add_comment add_comment add_comment

Consumidores — add_comment add_comment add_comment


— add_comment add_comment add_comment

Administradores insert_old_revision





— add_comment add_comment add_comment


— — — —

143


Tabla 38. Documento de entrega externo: operaciones disponibles (2 de 2)



Controlador add_comment,apply_matrix,disable_scheduling_progress, set_next_schedule_date, generate_rendition

add_comment,apply_matrix,disable_scheduling_progress, set_next_schedule_date, reinstate_document

apply_matrix,disable_scheduling_progress, set_next_schedule_date, reinstate_document

add_comment,apply_matrix,disable_scheduling_progress,set_next_schedule_date,undo_supersede_document

Colaboradores add_comment add_comment — add_comment

Consumidores add_comment add_comment — add_comment


add_comment add_comment — add_comment

Administradores add_comment,insert_old_revision





add_comment add_comment — add_comment


— — — —

Documentos de correspondenciaLos documentos de correspondencia se utilizan para:

• Transmisiones

• PVA

Estados del ciclo de vida de documentos de correspondencia

144


Tabla 39. Estados del ciclo de vida de documentos de correspondencia


En preparación Indica una revisión del documento que se estápreparando.

Requiere aprobación Opcional. Indica una revisión del documentoque requiere la aprobación antes de ponerlo adisposición.

Aprobado para su envío Opcional. Indica una revisión del documentoque se ha aprobado y que puede enviar.

Esperando respuesta Opcional. Indica una revisión del documentoque se ha enviado o recibido, pero requiere unarespuesta.

Completado Indica una revisión del documento que seha enviado o recibido, y una respuesta se harecibido o enviado. No se requiere ninguna otraacción.

Registrado Indica una revisión del documento que norequiere una respuesta y se guarda pararegistro histórico. Los tipos de documentos decorrespondencia pueden crearse en este estado.

145



• Documento de correspondencia: permisos de Documentum, página 146

• Documento de correspondencia: acciones permitidas, página 147

• Documento de correspondencia: operaciones disponibles, página 149

Documento de correspondencia: permisos deDocumentum


Tabla 40. Documento de correspondencia: permisos de Documentum (1 de 2)


En preparación Requiere aprobación Aprobado para suenvío

Controladores DELETE, CHANGE_STATE, CHANGE_PERMIT, CHANGE_LOCATION

DELETE, CHANGE_STATE, CHANGE_PERMIT, CHANGE_LOCATION


Autores WRITE, CHANGE_STATE

RELATE RELATE

Colaboradores RELATE RELATE RELATE

Consumidores RELATE RELATE RELATE

Administradores decomentarios


Administradores DELETE, CHANGE_STATE, CHANGE_PERMIT, CHANGE_LOCATION

WRITE, CHANGE_STATE, CHANGE_PERMIT, CHANGE_LOCATION


Preparar ejecutante WRITE, CHANGE_STATE

RELATE RELATE

Aprobar ejecutante RELATE RELATE, CHANGE_STATE

RELATE




BROWSE BROWSE BROWSE

146


Tabla 41. Documento de correspondencia: permisos de Documentum (2 de 2)


Registrado Esperando respuesta Completado

Controladores RELATE, CHANGE_PERMIT


RELATE, CHANGE_PERMIT

Autores RELATE RELATE RELATE

Colaboradores RELATE RELATE RELATE

Consumidores RELATE RELATE RELATE



Administradores WRITE, CHANGE_STATE, CHANGE_PERMIT, CHANGE_LOCATION



Preparar ejecutante RELATE RELATE RELATE

Aprobar ejecutante RELATE RELATE RELATE




BROWSE BROWSE BROWSE

Documento de correspondencia: acciones permitidas


Tabla 42. Documento de correspondencia: acciones permitidas (1 de 2)



Controladores change_membership,view_history,view_comments,add_comments,relate_to_document,manage_renditions,ap_attach, dm_apply

change_membership,view_history,view_comments, add_comments, manage_comments,relate_to_document,manage_renditions,dm_apply

change_membership,view_history,view_comments,add_comments,manage_comments,relate_to_document,manage_renditions,dm_apply

147




Autores view_history,view_comments,add_comments,manage_comments,relate_to_document,manage_renditions,ap_attach, dm_apply,

view_history,view_comments,add_comments,manage_comments,relate_to_document,manage_renditions,dm_apply





Consumidores — — —








Preparar ejecutante view_history,view_comments, add_comments, manage_comments,relate_to_document,manage_renditions

— —

Aprobar ejecutante — view_history,view_comments, add_comments, manage_comments,relate_to_document,manage_renditions

—






— — —

148


Tabla 43. Documento de correspondencia: acciones permitidas (2 de 2)



Controladores change_membership,view_history,view_comments,add_comments,manage_comments,relate_to_document,manage_renditions,dm_apply



Autores view_history,view_comments,add_comments,manage_comments,relate_to_document,manage_renditions,dm_apply




view_history,view_comments,add_comments,relate_to_documen


Consumidores — — —








Preparar ejecutante — — —

Aprobar ejecutante — — —






— — —

Documento de correspondencia: operacionesdisponibles


149


Tabla 44. Documento de correspondencia: operaciones disponibles (1 de 2)



Controladores add_comment,apply_matrix, record_correspondence_document

add_comment,apply_matrix,generate_rendition

add_comment,apply_matrix, generate_rendition, record_correspondence_document

Autores add_comment, record_correspondence_document

add_comment add_comment, record_correspondence_document

Colaboradores add_comment add_comment add_comment

Consumidores — — add_comment


add_comment add_comment add_comment

Administradores add_comment add_comment add_comment

Preparar ejecutante add_comment add_comment add_comment

Aprobar ejecutante add_comment add_comment add_comment




— — —

Tabla 45. Documento de correspondencia: operaciones disponibles (2 de 2)



Controladores add_comment,apply_matrix,generate_rendition

add_comment,apply_matrix, generate_rendition, complete_correspondence_document

add_comment,apply_matrix,generate_rendition

Autores add_comment add_comment,complete_correspondence_document

add_comment

Colaboradores add_comment add_comment add_comment

Consumidores add_comment add_comment add_comment



Administradores add_comment add_comment add_comment

150




Preparar ejecutante add_comment add_comment add_comment

Aprobar ejecutante add_comment add_comment add_comment




— — —

151


152

Capítulo 5Referencia

Los siguientes temas contienen información sobre las referencias:

• Acciones permitidas, página 153

• Permisos, página 154

• Permisos extendidos, página 155

• Roles, página 156

Acciones permitidasTabla 46. Acciones permitidas

Acción permitida Descripción

add_comments Permite realizar comentarios en un objeto.

ap_attach Permite adjuntar el objeto a un proceso deacción.

change_containment_rules Permite modificar las reglas de contenido paraun objeto de carpeta.

change_membership Permite modificar la pertenencia de los roles deobjetos.

dm_apply Permite aplicar una matriz de distribución alobjeto.

document_load_run_as_su Permite establecer la opción “ejecutar comosuper usuario” para un proceso de carga dedocumentos.

edit_progress Permite editar y actualizar el progreso deplanificación del documento.

loading_run_as_su Permite establecer la opción “ejecutar comosuper usuario” para un proceso de carga dedocumentos.

153

Referencia

Acción permitida Descripción

loading_set_schedule Permite establecer una hora planificadade ejecución para un proceso de carga dedocumentos.

make_attachment_comments Se utiliza para transmisiones y procesos deacción. El usuario puede realizar comentarios enlos documentos adjuntos.

manage_comments Permite establecer el estado de los comentariosrealizados en un objeto.

manage_renditions Permite modificar las copias de un documento(mediante la pestaña Contenido en laspropiedades).

new_revision Permite crear una nueva revisión de undocumento.

relate_to_document Permite relacionar un objeto con otro.

run_report Permite generar un informe a partir de unaplantilla de informe.

tr_edit_relation_attrs Permite modificar los atributos en la relaciónque adjunta un documento a una transmisión.

tr_redistribute Permite modificar la lista de destinatarios parauna transmisión y reenviarla.

view_comments Permite ver los comentarios realizados en unobjeto.

view_history Permite ejecutar el informe de historial denegocio de un objeto.

view_progress Permite ver el progreso de planificación dedocumento.

PermisosCapital Projects configura los permisos del documento en función del rol del usuario y de lacategoría del documento. Los permisos se definen para cada elemento del repositorio. Los permisosidentifican el nivel de seguridad necesario para que un grupo o usuario acceda a los elementos ya sus acciones permitidas.

En la tabla siguiente se describen los permisos básicos en Documentum:

Tabla 47. Permisos

Permiso Descripción

Ninguno No se puede acceder a ningún objeto ni a ningúnatributo de objeto.

154

Referencia

Permiso Descripción

Examinar Se pueden ver las propiedades del objeto.

Leer Se pueden ver las propiedades del objeto y elcontenido.

Relacionar Igual que Leer y, además, los usuarios puedenañadir anotaciones de objeto.

Versión Igual que Relacionar y, además, los usuariospueden modificar el contenido del objeto.

Escribir Igual que Versión y, además, los usuariospueden modificar los atributos y cambiar elcontenido del objeto sin actualizar la versión.

Eliminar Igual que Escribir y, además, los usuariospueden eliminar cualquier objeto.

Permisos extendidosTabla 48. Permisos extendidos

Permisos Descripción

Ejecutar procedimiento Los superusuarios pueden cambiar elpropietario de un elemento y utilizar el permisoEjecutar procedimiento para ejecutar losprocedimientos externos en algunos tipos deelementos.

Cambiar ubicación Los usuarios que dispongan del permisoCambiar ubicación pueden mover un elementohasta el repositorio.

Cambiar estado Los usuarios que dispongan del permisoCambiar estado pueden cambiar el estado deun elemento al que se le haya aplicado un ciclode vida.

Cambiar permiso Los usuarios que dispongan del permisoCambiar permiso pueden modificar lospermisos básicos de un elemento.

Cambiar propiedad Los usuarios que dispongan del permisoCambiar propiedad pueden cambiar elpropietario del elemento.

155

Referencia

Permisos Descripción

Eliminar objeto extendido Los usuarios que dispongan del permisoEliminar objeto extendido solo pueden eliminarel objeto.

Cambiar enlaces de carpeta Permite a un usuario enlazar un objeto a unacarpeta, o bien desenlazar un objeto de unacarpeta.

RolesTabla 49. Roles del sistema global definidos en Capital Projects

Roles del sistema global definidos Descripción

administrador del proyecto eif Rol que da acceso a la funcionalidad deadministración del proyecto.

administrador de tareas del sistema eif Rol que permite administrar todas las tareas EIFde los usuarios.

administrador de tareas del proyecto eif Rol que permite administrar las tareas EIF delos usuarios (dentro de los proyectos donde elmiembro sea el controlador).

dm_sysadmin_role Grupo dinámico para el privilegiodm_sysadmin_role.

queue_admin Usuario que puede crear y administrar las colasde trabajos y sus políticas.

queue_manager Usuario que supervisa las colas de trabajos yasigna a los usuarios que se encargarán de loselementos de las colas.

queue_processor Usuario que se encarga de los elementos de unao varias colas de trabajos.

process_report_admin Usuario que dispone de permiso para ejecutarlos informes de flujos de trabajo históricos.

queue_advance_processor Usuario cuyo rol es queue_processor y puedeseleccionar la tarea de las colas de trabajos dela que se va a encargar.

dm_workflow_task_supervisor Usuario que puede adquirir una tarea del flujode trabajo, así como delegarla.

156

Capítulo 6Configurar informes

La solución Documentum Capital Projects admite la administración de los informes de negociomediante el módulo Informes. El módulo Informes saca partido de los siguientes elementos:• Tipos de documentos y plantillas: los informes se definen y administran del mismo modo que los

tipos de documentos estándar. Por ejemplo, una definición de informe está compuesta de:

— Tipo de informe: objeto de configuración (como el objeto de configuración del tipo dedocumento).

— Plantilla de informe: asociada con un tipo de informe.

• Creación de instancias de plantilla: los informes reales solo se pueden crear a partir de lasplantillas de informes correspondientes.

• Perfiles de seguridad: cada tipo de informe puede aplicarse a cualquier perfil de seguridadpersonalizado diseñado para controlar todos los aspectos de seguridad a través de su ciclo de vida.

• Reglas de contenido de carpetas: las reglas de contenido estándar se aplican a los informes. Porejemplo, solo pueden crearse los informes en las carpetas permitidas.

Capital Projects utiliza el motor JasperReports para generar los informes.

• Modelo y configuración del objeto de informe, página 157

• Configuración de informes, página 158

• Acceder a los informes de ejemplo, página 169

Modelo y configuración del objeto de informeLos informes son una extensión de los tipos de documentos ECSF básicos. El modelo del objetoprincipal consta de los siguientes tipos que extienden los tipos básicos:• ecs_report_type: extiende el tipo de objeto ecs_doc_type.

• ecs_report_doc: extiende el tipo de objeto ecs_doc.

Estos dos tipos proporcionan una separación clara de los tipos de objetos ECSF estándar, al mismotiempo que saca partido de todos los conceptos clave de los tipos de documentos ECSF. La carpeta

157

Configurar informes

Configuration Container Folder básica de Capital Projects contiene ahora la siguienteestructura del directorio para mejorar la separación y la administración de informes:

• 04 Informes

— 01 Tipos: la carpeta Tipos solo puede contener los tipos de informes.

— 02 Plantillas: la carpeta Plantillas solo puede contener las plantillas de informes.

Para importar una plantilla de informe en Capital Projects:1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (nombre del

proyecto)> 04 Informes > 02 Plantillas.

2. Seleccione Archivo > Importar plantilla de informe.

Para crear un tipo de informe en Capital Projects:1. Seleccione Administrador del proyecto > Configuraciones del proyecto > (nombre del proyecto)

> 04 Informes > 01 Tipos.

2. Seleccione Archivo > Nuevo > Tipo de informe.

Configuración de informesCapital Projects incluye una definición de entrada dm_format solo para la creación de informes:ecs_report (paquete de informes). Importe las plantillas de informes como contenido con formatoecs_report. La extensión de archivo DOS para el formato ecs_report es ECSFR.

• Contenido del paquete de informes de Capital Projects, página 158

• Interfaz de usuario de los informes de Capital Projects, página 160

• Construcciones admitidas con la definición de informe JasperReports, página 161

• Configuración del informe de historial de negocio de modo que sea compatible con la localización,página 164

Contenido del paquete de informes de Capital Projects

Los paquetes de informes son archivos ZIP que contienen:• Definición de informe JasperReports: el archivo jrxml es obligatorio. Capital Projects utiliza

el primer archivo jrxml que encuentre en la raíz del archivo de almacenamiento. El archivojrxml contiene las siguientes definiciones:— Sección de parámetros: cada informe requiere de los siguientes parámetros:

— report_exec_session: transfiere la sesión de usuario correspondiente al motor deinformes. Por ejemplo:<parameter name="report_exec_session"class=java.lang.Object" isForprompting="false"/>

— ecs_report_formats: define los formatos de salida para el informe. Por ejemplo:

158

Configurar informes

<parameter name="ecs_report_formats"class=java.lang.String" isForprompting="false"><defaultValueExpression><![CDATA["pdf,xls,csv,xlsx,excel,html,rtf"]]></defaultValueExpression>

— ecs_report_ui: señala a la definición de interfaz de usuario definida en el archivoRCF. Por ejemplo:

<parameter name="ecs_report_ui"class=java.lang.String" isForprompting="false"><defaultValueExpression><![CDATA["test_report_ui"]]></defaultValueExpression>

— Sección queryString: contiene la definición de la lógica del negocio. Las tres opciones son:

— dql: se utiliza cuando el archivo jrxml contiene una consulta DQL, que extrae los datos devisualización desde docbase. Por ejemplo:

<queryString language="dql"><![CDATA[select r_object_id, object_name, ecs_doc_type_name, subject,ecs_ic_state, ecs_security_profile, titlefrom ecs_docwhere ecs_template_level = 0 and object_name like’$P{ecs_report_parameter_object_name_pattern}%’]]></queryString>

— datasource_provider: contiene el nombre de clase completo de la clase Java que es laencargada de extraer los datos de visualización desde docbase. Por ejemplo:

<queryString language="datasource_provider"><![CDATA[com.ecs.framework.library.report.samples.SampleReport]]></queryString>

La clase Java especificada implementa la interfaz IECSFDataSourceProvider o extiendeECSFAbstractDataSourceProvider (esta opción es la más sencilla). Existen dosopciones para incrustar una clase especificada en una aplicación:— Incluirla en la implementación de bibliotecas jar de la aplicación.

— Crear la clase datasourceprovider.jar e incluirla en el archivo ECSFR. El archivodatasourceprovider.jar contiene la clase especificada. (Actualmente el nombrejar está codificado). El archivo ECSFR es el archivo zip con una extensión con unnombre nuevo.

• Archivos auxiliares (como imágenes de referencia, definiciones de subinformes y archivos jarpersonalizados que contienen las implementaciones de los proveedores personalizados de origende datos). Estos son los archivos opcionales:

— Imágenes de informes: contenido de archivo binario o archivos a los que se puede hacerreferencia en la definición jrxml como elementos de informes.

— Definiciones de subinformes: otras definiciones jrxml inyectadas por el motor de creaciónde informes ECSF en el informe principal. El motor JasperReports admite la anidación deinformes. Esta función es útil a la hora de implementar los informes con las interfaces deusuario avanzadas. Por ejemplo, una interfaz de usuario que contenga tablas secundariasdentro de las tablas. Tanto el informe principal como los subinformes de Capital Projects

159

Configurar informes

se pueden colocar en el mismo paquete de informes. Los subinformes se colocan en unasubcarpeta Sub-Reports.

— Proveedores personalizados de origen de datos: archivos Jar que contienen las clasesJava especificadas como proveedores de origen de datos dentro de la definición de informeprincipal.

Interfaz de usuario de los informes de Capital Projects

Las definiciones de informes de Capital Projects permiten que el usuario especifique los datos quedeseen mediante los parámetros de informes.

Nota: Esta función se encuentra disponible en Webtop.

Utilice el parámetro ecs_report_ui para proporcionar a Capital Projects la configuración de lainterfaz de usuario del informe cuando no se ha especificado un valor de parámetro predeterminado.Por ejemplo:

<parameter name="report_exec_session"class="java.lang.Object" isForPrompting="false"/><parameter name="ecs_report_formats"class="java.lang.String" isForPrompting="false">

<defaultValueExpression><![CDATA["pdf,xls,csv,xlsx,excel,html,rtf,docx"]]></defaultValueExpression></parameter><parameter name="ecs_report_formats"class="java.lang.String" isForPrompting="false"/><parameter name="ecs_report_parameter_object_name_pattern"class="java.lang.String" isForPrompting="true"/><parameter name="ecs_report_ui"class="java.lang.String" isForPrompting="false"><defaultValueExpression><![CDATA["test_report_ui"]]></defaultValueExpression></parameter>

La interfaz de usuario del informe se define en el esquema del RCF como un elemento dinámico de lainterfaz de usuario dentro de la siguiente ruta: /rcf/ecs/reporting/report_ui_configs

Por ejemplo:

<report_ui name="test_report_ui"><controls><control name="ecs_report_parameter_object_name_pattern"

type="text_box"><params><param name="label" value="Object Name Pattern"/>

</params></control>

</controls></report_ui>

Cada parámetro del informe que se define como “solicitud de usuario obligatoria” necesita delcorrespondiente control de interfaz de usuario dinámica que se procesa de forma dinámica en elasistente Ejecutar informe. El control de interfaz de usuario se asocia con un parámetro JasperReports

160

Configurar informes

mediante el atributo del nombre. Por ejemplo, según el parámetro report_ui mostrado en elejemplo anterior, la definición del parámetro es:

<parameter name="ecs_report_formats"class="java.lang.String" isForPrompting="false"/><parameter name="ecs_report_parameter_object_name_pattern"class="java.lang.String" isForPrompting="true"/><parameter name="ecs_report_ui"class="java.lang.String" isForPrompting="false">

En el siguiente ejemplo, queryString transfiere los valores que ha rellenado el usuario. La lógicadel negocio se define como:• Parámetro de informe: ecs_report_parameter_object_name_pattern se define para la

solicitud.

• Control de interfaz de usuario: ecs_report_parameter_object_name_pattern muestra yasigna el valor relleno en el parámetro de informe.

• queryString: la siguiente cadena de consulta contiene la expresión $P{ecs_report_parameter_object_name_pattern} que realiza la asignación entre el parámetro de informe y la cadenade consulta.

<queryString language="dql"><![CDATA[select r_object_id, object_name, ecs_doc_type_name, subject,ecs_ic_state, ecs_security_profile,title from ecs_doc where ecs_template_level = 0 and object_name like’$P{ecs_report_parameter_object_name_pattern}%’]]></queryString>

En el siguiente ejemplo, los valores que ha rellenado el usuario se transfieren mediante una clase Java:public SampleReport(IDfSession dfSession, Map parameters) throwsDFException {super(dfSession,parameters);objectNamePattern = (String) getParameterValue("ecs report parameter object name pattern");objectNamePattern = objectNamePattern != null ? objectNamePattern :"";

El módulo de interfaz de usuario dinámica proporciona controles para representar los diferentestipos de parámetros, como cuadro de texto sin formato, cuadro de lista, selector de fecha, casillade verificación según sea necesario.

Construcciones admitidas con la definición de informeJasperReports


• Scriptlet de creación de informes, página 162

• Formateador ECSF, página 163

161

Configurar informes

Scriptlet de creación de informes

Capital Projects proporciona una clase de extensión JRDefaultScriptlet para utilizarla en unadefinición de informe con el fin de acceder a los recursos del paquete de informes o a un repositoriode contexto. Declare el scriptlet desde el elemento raíz del informe. Por ejemplo:<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" ... scriptletClass="com.ecs.framework.library.report.ECSFScriptlet">

El scriptlet puede ser de cualquier clase que extienda la clase JRDefaultScriptlet . Despuésde registrar el scriptlet, un scriptlet personalizado puede contener cualquier método nuevopersonalizado en el archivo jrxml. La versión JasperReports incluida en Capital Projects admitela definición de varios scriptlets en un informe. El scriptlet ECSFScrptlet se incluye en CapitalProjects y contiene los siguientes métodos:

• getImageById(String id): id se trata del r_object_id del objeto cuyo contenido esla imagen.

• getImage(String uri): uri se trata de la ruta completa de docbase del objeto cuyo contenidoes la imagen.

• getTemplateContent(String uri): uri se trata de la ruta relativa dentro del archivo ECSFR.

• getSysObjectDRL(String id): devuelve el enlace DRL del objeto cuyo id se ha especificado.

• getObjectPropertiesDRL(String id): devuelve el enlace al componente de propiedadesdel objeto cuyo id se ha especificado.

Mostrar imágenes contenidas en el paquete de informes

Utilice el método getTemplateContent() para mostrar una imagen. Por ejemplo:<image><reportElement x="0" y="0" width="83" height="50"/><imageExpression class="java.io.InputStream"><![CDATA[((com.ecs.framework.library.report.ECSFScriptlet)

$P{REPORT_SCRIPTLET}).getTemplateContent("image_path")]]><//imageExpression>

</image>

image_path es la ruta relativa desde la raíz del archivo ECSFR. Por ejemplo, si el archivo logo.pngse ha colocado en la raíz del archivo report.ecsfr, la ruta image_path será “logo.png”.

Mostrar el enlace DRL en un informe

Utilice el método getSysObjectDRL() para mostrar el enlace DRL en un informe. Por ejemplo:<hyperlinkReferenceExpression><!((com.ecs.framework.library.report.ECSFScriptlet)$P{REPORT_SCRIPTLET}).getSysObjectDRL($F{r_object_id})]></hyperlinkReferenceExpression>

162

Configurar informes

Definir los subinformes en el paquete de informes

Registre los subinformes del informe principal en la sección de parámetros. En el siguiente ejemplo,el parámetro se define con el nombre ProjectDocumentsAndTransmittalsSubreportque es una instancia de net.sf.jasperreports.engine.JasperReport. Elarchivo ECSFR contiene los subinformes de la subcarpeta. Coloque el archivoProjectDocumentsAndTransmittalsSubreport.jrxml en los subinformes. ECSF detectaautomáticamente esta conexión e incrusta el subinforme en el informe principal.<parameter name="ProjectDocumentsAndTransmittalsSubreport"class="net.sf.jasperreports.engine.JasperReport"/>

Para utilizar el subinforme, defina la etiqueta del subinforme en el área principal del informe. Porejemplo:<subreport runToBottom="false">

<reportElement stretchType="RelativeToBandHeight" x="0"y="0" width="802" height="0"/>

<subreportParameter name="ecs_report_parameter_objectId"><subreportExpression class="net.sf.jasperreports.engine.JasperReport">

<![CDATA[P{ProjectDocumentsAndTransmittalsSubreport}]]></subreportExpression></subreport>

Formateador ECSF

ECSF proporciona una clase de extensión JRDefaultScriptlet para utilizarla en una definiciónde informe con el fin de acceder a los recursos del paquete de informes o a un repositorio de contexto.Declare el scriptlet desde el elemento raíz del informe tal y como se describe a continuación:<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" ... scriptletClass="com.ecs.framework.library.report.ECSFScriptlet">

Para utilizar al formateador, declare el elemento de importación como un elemento secundario delelemento raíz del informe <jasperreports>:<import value="com.ecs.framework.library.report.formatting.*"/>

Entonces ECSFValueFormatter se podrá utilizar para formatear los valores que desea mostrar:<textFieldExpression class="java.lang.String"><![CDATA[ECSFValueFormatter.formatDate($P{ecs_report_parameter_spm_issue_date_from},"dd. MMM yyyy. HH:mm:ss zzz") + " to " + ECSFValueFormatter.formatDate($P{ecs_report_parameter_spm_issue_date_to},"dd. MMM yyyy. HH:mm:ss zzz")]]></textFieldExpression>

Los métodos definidos en ECSFValueFormatter son:• formatBoolean(boolean value, String trueValue, String falseValue)

• formatDouble(double value, String format)

• formatDate(Date value, String pattern)

• formatDate(Date value, String pattern, String language)

• formatRepeatingBoolean(Collection<Boolean> values, String trueValue,String falseValue, String separator)

• formatRepeatingString(Collection<String> values, String separator)

163

Configurar informes

• formatRepeatingDouble(Collection<Double> values, String format, Stringseparator)

• formatRepeatingInt(Collection<Integer> values, String separator)

• formatRepeatingDate(Collection<Date> values, String pattern, Stringseparator)

• formatRepeatingDate(Collection<Date> values, String pattern, Stringseparator, String language)

• formatTimeInterval(Date start, Date end)

• toDqlDateString(Date date)

Configuración del informe de historial de negocio demodo que sea compatible con la localizaciónPara agregar la fuente necesaria al informe generado1. Cree un jar con los siguientes archivos y estructura de carpetas.

• jasperreports_extension.properties

• fonts— _<font filename>.TTF

— _fontsfamily.xml

• Actualice jasperreports_extension.properties con la siguiente información:

net.sf.jasperreports.extension.registry.factory.fonts =net.sf.jasperreports.engine.fonts.SimpleFontExtensionsRegistryFactory

net.sf.jasperreports.extension.simple.font.families.ireportfamily1394786788408 =fonts/fontsfamily1394786788408.xml

• Actualice fontsfamily.xml con la siguiente información:

Puede cambiar los nombres de fontFamily y font_file. Deben coincidir con_<font_filename>.TTF.<?xml version="1.0" encoding="UTF-8"?><fontFamilies><fontFamily name="Arial Unicode MS Regular"><normal><![CDATA[fonts/ARIALUNI_0.TTF]]></normal><pdfEncoding>![CDATA[Identity-H]]></pdfEncoding><pdfEmbedded>![CDATA[true]]></pdfEmbedded></fontFamily></fontFamilies>

2. Introduzca el nombre de la fuente predeterminada en reportHeaders_xx_XX.propertiesde ecs_framework_lib_nls_xx_XX.jar. Por ejemplo, DEFAULT_FONT_NAME = ArialUnicode MS Regular

Los archivos de propiedades se encuentran en \Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\DmMethods.war\WEB-INF\lib\ecs_framework_lib_nls_xx_XX.jar

164

Configurar informes

3. Coloque los archivos jar en las siguientes rutas:• Servidor de aplicaciones: webapps\epfm\WEB-INF\lib

• Content Server: \Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\DmMethods.war\WEB-INF\lib

4. Reinicie el servidor de métodos Java, así como el servidor de aplicaciones.

Configuración adicional del RCF relacionada con lafuncionalidad de generación de informes

Realice las siguientes tareas para modificar el archivo RCF. Estos son los temas que se incluyenen esta sección:

• Acciones del informe, página 165

• Ubicación de resultados temporal, página 166

• Ejecutar acción permitida del informe, página 166

• Métodos del servidor, página 166

Acciones del informe

Por lo general, las acciones del informe se ejecutan cuando:• Un modo de informe se define mediante Guardar o Guardar y abrir.

• La ejecución del informe ha finalizado.

Por ejemplo, cuando un usuario desea ejecutar un informe que tarda demasiado tiempo en ejecutarse,define la ejecución del informe para que sea asincrónica y selecciona una o varias acciones denotificación. Cuando finaliza la ejecución del informe, los usuarios reciben la notificación.

Capital Projects proporciona las acciones del informe en la forma de EmailAsAttachment yEmailAsLink.

Para definir un informe:1. Vaya hasta /rcf/reporting en el RCF.

2. Agregue las siguientes acciones al elemento de generación de informes:<actions>

<action name="attachReportAction" class="com.ecs.framework.library.report.actions.EmailAsAttachment" description="Email as attachment"><params><param name= "roles" value="controllers"/><param name= "zip_content" value="true"/><param name= "failure_message" value="Failed to send result as email attachment."/><param name="emailTemplate" tpl_ref="generic_mail_template"/></params></action><action name="linkReportAction" class="com.ecs.framework.library.report.

165

Configurar informes

actions.EmailAsLink" description="Email as Link"><params><param name= "roles" value="controllers"/><param name= "failure_message" value="Failed to send result as link."/><param name="emailTemplate" tpl_ref="generic_mail_template"/></params></action></actions>

Después de actualizar los cambios en el RCF y volver a cargarlo, podrá ver estas acciones cuandocree o ejecute los informes.

Ubicación de resultados temporal

Cuando un usuario desea abrir un informe automáticamente después de la ejecución, el archivode resultados del informe debe guardarse temporalmente en una ubicación del repositorio.Especifique la ubicación de un elemento raíz de la sección de informes como un valor del atributoreport_result_location. De forma predeterminada, la ubicación es el archivador Temp. Porejemplo:<reporting temporary_results_location="/Temp">

Ejecutar acción permitida del informe

Para permitir la acción “ejecutar informe”, agregue “run_report” a la acción permitida del objetode informe:

<role name="consumers"><access_permit>READ</access_permit><extended_permits/><permitted_actions><action name="run report"/>

</permitted actions></role>

Métodos del servidor

En caso de que un usuario que no sea superusuario configure un informe para ejecutarlo conpermisos de superusuario, agregue el siguiente código en /rcf/ecs/methods.

• Ejemplo de informes asincrónicos:<method name="executeReport"

class="com.ecs.framework.methods.dispatch.report.ExecuteReport" is_async="true" />

• Ejemplo de informes sincrónicos:<method name="executeReportSynchronously"

class="com.ecs.framework.methods.dispatch.report.ExecuteReport" />

166

Configurar informes

Configurar informes asincrónicos

La función de informes admite la ejecución de informes asincrónicos. Utilice la ejecución de informesasincrónicos cuando un informe tarda mucho tiempo en ejecutarse.

1. Seleccione Proyectos > (nombre del proyecto) > 08 Informes > 01 Plantillas > (nombre de laplantilla).

2. Seleccione la plantilla que desee, haga clic con el botón derecho del ratón y, a continuación,seleccione Propiedades.

3. En la pestaña Propiedades, seleccione la pestaña Configuración.

4. Seleccione Asíncrono. La opción Guardar se selecciona automáticamente y se atenúa.

Nota: Las siguientes imágenes son un ejemplo de la interfaz de usuario de Capital Projects; estaspueden variar en función de las opciones de configuración.

5. Ejecute el informe asincrónico tal y como se describe a continuación:

a. Seleccione Guardar.

b. Especifique la Ubicación del informe guardado, que es la ruta de docbase.

c. Especifique los Detalles del informe guardado, que son el nombre de objeto, el tipo dedocumento y la plantilla del objeto de resultado.

167

Configurar informes

d. Haga clic en Finalizar para guardar y cerrar.

e. Active el informe y, a continuación, ejecútelo.

Planificar informes

Se puede planificar la ejecución de los informes de Capital Projects.

1. Seleccione Proyectos > (nombre del proyecto) > 08 Informes > 01 Plantillas > (nombre de laplantilla).

2. Seleccione la plantilla y haga clic con el botón secundario para mostrar la ventana Propiedades.

3. Seleccione la pestaña Planificación.

4. Seleccione Activar planificación y especifique las siguientes opciones:

a. Especifique el formato.

b. Especifique la Ubicación del informe guardado, que es la ruta de docbase.

c. Especifique los Detalles del informe guardado, que son el nombre de objeto, el tipo dedocumento y la plantilla del objeto de resultado.

d. Especifique las acciones en Acciones de informe disponibles (si las hubiera).

e. Especifique el tipo de usuario.

f. Defina las opciones de planificación como las horas y la frecuencia.

168

Configurar informes

Parámetros de informes predeterminados

Cada informe consta de parámetros de informes que se definen como “para solicitud”. Por ejemplo:<parameter name="ecs_report_formats" class="java.Lang.String" isForPrompting="false"/><parameter name="ecs_report_object_name_pattern" class="java.Lang.String"isForPrompting="true"/>

<parameter name="ecs_report_ui" class="java.Lang.String" isForPrompting="false">

Haga coincidir los parámetros con la interfaz de usuario dinámica para permitir que los usuariosrellenen los valores de los parámetros durante la ejecución del informe. Por lo general, se trata deparámetros de filtrado que aplican los valores de los parámetros a las reglas de la lógica de negocio yfiltran previamente los datos antes de generar los resultados del informe. Por ejemplo, utilice losfiltros basados en el patrón del nombre, en las fechas de creación o en la ubicación principal.

Los parámetros de informes también pueden tener valores predeterminados, que rellenanpreviamente la página de parámetros de informes durante la ejecución del informe. Utilice los valorespredeterminados cuando un informe tenga numerosos filtros que puedan tardar mucho tiempo enrellenarse. Utilice pestaña Valores de parámetros predeterminados en la ventana Propiedades paraestablecer estos parámetros.

Acceder a los informes de ejemploCapital Projects instala los siguientes informes de ejemplo. Los informes son los siguientes:• Informe de todos los documentos

• Informe de acción de correspondencia

• Informe de transmisiones pendientes (últimas)

169

Configurar informes

• Informe de documentos principales

• Informe de documentos principales con progreso

• Informe de transmisiones de proyecto

• Informe de transmisiones de revisión

• Estado de aprobación

• Ejemplo de gráfico del progreso del documento

• Informe del estado de la entrega

• Informe de transmisiones de proyecto

• Informe de tareas de revisión

• Ejemplo de gráfico del estado de transmisión

• Ejemplo de gráfico del progreso de WBS

Para acceder a los informes de muestra:1. Seleccione Administrador del proyecto > Configuraciones del proyecto > EIFSHD > 04 Informes

> 02 Plantillas.

2. Los informes de plantillas muestran:

Informes de gráficos de ejemploA continuación se muestran las dos plantillas de informes de ejemplo que pueden generar informescomo gráficos en la configuración del proyecto compartido de Capital Projects (EIFSHD):• Ejemplo de gráfico del estado de transmisión

• Ejemplo de gráfico del progreso de WBS

170

Configurar informes

Para ejecutar los informes sin errores, siga estos pasos:1. Descargue los siguientes archivos jar del sitio web jfree:

• jcommon-1.0.15.jar

• jfreechart-1.0.13.jar

Nota: En el paquete de Capital Projects no se incluyen estos archivos jar. Puede descargar estosarchivos jar del sitio web jfree si lo desea.

2. Copie los archivos jar en:• La carpeta lib del servidor de métodos Java. (Por ejemplo, C:\Documentum\jboss5.1.0

\server\DctmServer_MethodServer\deploy\ServerApps.ear\DmMethods.war\WEB-INF\lib).

• La carpeta lib en la raíz virtual de Capital Projects del servidor de aplicaciones. Por ejemplo,C:\apache-tomcat-7.0.33\webapps\epfm\WEB-INF\lib

• Reinicie el servidor de métodos Java, así como el servidor de aplicaciones.

Para que las plantillas estén a su disposición, siga estos pasos:1. Cree un Tipo de informe nuevo.

2. Seleccione la plantilla de entre las que se han descrito más arriba y que están ubicadas en EIFSHD.

3. Agregue el nuevo tipo de informe a las reglas de contenido de la carpeta correspondiente dondese debe crear la plantilla de informe.

171

Configurar informes

172

Index

Aacciones permitidas, 153Administración de documentos, 14archivo de configuración de repositorio, 24asincrónico, 167asistencia de valor, 49

Atributo de un tipo de objeto nuevo, 49Basada en un valor de otro atributo, 60Basada en una consulta DQL, 50Basada en una lista estática de

valores, 53Basada en valores de lista

desplegable, 55autonumeración

crear, 43Autonumeración

aplicar, 45configurar, 43

Ccampo Texto, 48caracteres comodín

pertenencia de rol, 31carga de documentos

configurar, 109configurar en RCF, 109configurar nuevos tipos de documentos

en un proyecto (2º método), 112ejemplo de hoja de cálculo, 111

Carga de documentos, 18carpeta

subordinada, 41carpeta subordinada, 41carpetas

controladas, 39principales, 39reglas de contenido, 39

comentarios, 14conceptos clave

Administración de documentos, 14Carga de documentos, 18comentarios, 14Conceptos adicionales, 20Estructuras xBS, 14Informes, 19Matrices de distribución, 17Planificación\Progreso de

documentos, 20Procesos de acción, 15proyectos, 13Transmisiones, 15 hasta 16

configuración de informesinformes asincrónicos, 167planificar informes, 168

configuración de plantillas de matriz dedistribuciónrevisar, 99

configuración de RCFejecutar acción permitida del

informe, 166ubicación de resultados temporal, 166

Configuración de relleno de atributosaplicar, 48

configuración de tipo de matriz dedistribuciónrevisar, 99

configuración del RCF, 165acciones del informe, 165métodos del servidor, 166

configurarcampo Texto, 48Capital Projects, 23reglas de contenido en RCF, 41

contenido del paquete de informes, 158Convenciones de nomenclatura

configurar, 46copias

configurar, 107

173

Index

Ddescripción general, 11documento

configurar, 32Documento de correspondencia: acciones

permitidas, 147Documento de correspondencia:

operaciones disponibles, 149Documento de correspondencia: permisos

de Documentum, 146Documento de entrega externo: acciones

permitidas, 140Documento de entrega externo:

operaciones disponibles, 142Documento de entrega externo: permisos

de Documentum, 139Documento de entrega interno: acciones

permitidas, 131Documento de entrega interno: operaciones

disponibles, 135Documento de entrega interno: permisos

de Documentum, 129Documento entregable interno, 127Documentos de correspondencia, 144Documentos entregables externos, 138Documentum, 11

EEstructuras xBS, 14expresión de atributo

ejemplos, 29parámetros de complementos, 26uso, 26

Expresionescrear plantillas, 69

expresiones de atributos, 24

Fformateador, 163funciones de atributos

operadores, 27un valor y repetición, 28

Hherencia de atributos

carpeta, 42Herencia de los atributos del RCF

herencia de los atributos, 35hoja de comentarios, 67

Iinforme

configuración, 158definir subinforme, 163interfaz de usuario, 160mostrar enlace DRL, 162mostrar imágenes, 162

informes, 19configurar, 157ejemplos, 169

JJasperReports, 161

Llista desplegable, 49 hasta 50, 53, 55, 60

quitar, 64Listas desplegables dinámicas

configurar, 49

Mmatriz de distribución

configurar, 98crear, 98, 100

Matriz de distribución, 17Modelo y configuración del objeto de

informe, 157

Pparámetros de informes, 169perfil de seguridad

agregar, 90permisos, 154permisos extendidos, 155Planificación\Progreso de documentos, 20Plantilla de documento, 32plantilla de transmisión

crear, 67plantillas

expresiones, 69hoja de comentarios, 67portada, 67

Plantillas de carpeta, 38

174

Index

crear, 38Plantillas de documentos, 35

crear, 35portada, 67Procesos de acción, 15progreso de la planificación

aplicar a un documento, 117aplicar a un tipo de documento, 116configurar, 115crear, 115

proyectos, 13

RRCF, 24referencia, 153

acciones permitidas, 153extendidos, 155permisos, 154roles, 156

reglas de coincidenciadefinir, 114

reglas de contenido, 36, 39Relleno automático de atributos

configurar, 47crear, 47

rolagregar, 88

configurar, 88Roles del sistema global, 156

roles de seguridadconfigurar, 88

SScriptlet ECSF, 162servicios de administración de copias

configurar, 107

TTipo de carpeta

crear, 37Tipo de documento, 32

crear, 32tipo de proceso de acción


Tipos de documentos, 127transmisiones, 15 hasta 16


WWebtop, 11

175

Dell · TabladeContenidos Prefacio...

Documents

Transcript of Dell · TabladeContenidos Prefacio...