EMCDocumentum GuíadeusuariodeProcess Builder · EMCDocumentum GuíadeusuariodeProcess Builder Versión6.7 EMC Corporation Corporate Headquarters: Hopkinton, MA 017489103 15084351000

EMC DocumentumGuía de usuario de Process

Builder

Versión 6.7

EMC CorporationCorporate Headquarters:

Hopkinton, MA 01748910315084351000

www.EMC.com

Copyright EMC Corporation. Reservados todos los derechos.Marzo de 2011 EMC considera que la información de esta publicación es precisa a fecha de publicación. La información está sujetaa cambios sin previo aviso.

LA INFORMACIÓN DE ESTA PUBLICACIÓN SE PROPORCIONA "TAL CUAL". EMC CORPORATION NO OFRECEGARANTÍA ALGUNA CON RESPECTO A LA INFORMACIÓN DE ESTA PUBLICACIÓN Y EN CONCRETO NORECONOCE GARANTÍAS IMPLÍCITAS DE COMERCIABILIDAD O IDONEIDAD PARA UN FIN DETERMINADO.

El uso, copia y distribución del software de EMC descrito en esta publicación requiere una licencia de software válida. Para obtenerla lista más actualizada de nombres de producto de EMC, consulte las marcas comerciales de EMC Corporation en EMC.com. Todaslas demás marcas comerciales mencionadas son propiedad de sus respectivos propietarios.

Tabla de Contenidos

Capítulo 1 Introducción al diseño de procesos ............................................................... 11Introducción a los flujos de trabajo..................................................................... 11Plantillas de proceso y objetos de flujo de trabajo asociados...............................14Actividades...................................................................................................14Datos de proceso..........................................................................................16Habilitar informes de Business Activity Monitor (BAM)..................................17

Flujos ...........................................................................................................18Planificar los procesos de flujo de trabajo ..........................................................18Establecer funciones y permisos....................................................................19Elegir o crear plantillas de actividad ...............................................................21Elegir ejecutantes .........................................................................................21Definición de cuándo se determina el ejecutante .........................................23Usar alias..................................................................................................24

Permitir la delegación y la extensión ..............................................................25Definir asuntos de tareas...............................................................................26Agregar un requisito de firma.........................................................................27Definir valores de prioridad ............................................................................27Introducción a los datos de proceso ...............................................................31Introducción a los paquetes........................................................................31Introducción a las variables de proceso.......................................................32Introducción a los parámetros de proceso ...................................................32

Asociar plantillas de formulario con paquetes..................................................33Definir condiciones de desencadenamiento ....................................................34Definir temporizadores ..................................................................................34Configurar notificaciones ...............................................................................36Definir transiciones de actividad.....................................................................36

Capítulo 2 Utilizar Process Builder..................................................................................39Entorno de diseño de Process Builder ...............................................................39Configurar la barra de herramientas de Process Builder .....................................40Definir preferencias de la plantilla de proceso ....................................................41Permitir que Process Analyzer tenga acceso a las plantillas de proceso ...........41Compartir una plantilla de proceso con Process Analyzer.............................41Obtener procesos de Process Analyzer.......................................................42Definir ubicaciones de la carpeta compartir proceso.....................................42

Definir el número de puerto para la depuración de actividades entrantes ...........43Gestionar las carpetas de plantillas de actividades..........................................43Definir preferencias de mensajes de la plantilla de proceso .............................44Actualizar datos de proceso en la base de datos de BAM................................44Actualizar tipos de datos estructurados en BAM ..........................................45Actualizar los tipos de objeto de paquete en BAM........................................45

Ventana Plantillas de actividades ......................................................................45

EMC Documentum Guía de usuario de Process Builder Versión 6.7 3

Tabla de Contenidos

Ventana Structured Data Types (Tipos de datos estructurados)...........................46Crear categorías de tipos de datos estructurados............................................46Eliminar una categoría de tipos de datos estructurados ...................................47Crear un grupo de tipos de datos estructurados ..............................................47Actualizar la ventana Tipo de datos estructurado ............................................47Crear tipos de datos estructurados.................................................................47Ver detalles de tipos de datos estructurados ...................................................49Editar tipos de datos estructurados ................................................................49Crear tipos de datos estructurado complejos a partir de esquemas XML ...........50

Panel del editor de plantillas de proceso ............................................................51Seleccionar objetos de plantilla de proceso ....................................................51Alinear actividades........................................................................................52Sustituir actividades ......................................................................................52Ajustar a la cuadrícula...................................................................................53Acercar o alejar ............................................................................................53Agregar notas ...............................................................................................54Ver varios procesos utilizando fichas ..............................................................55

Utilizar la ficha Validación de procesos ..............................................................55Utilizar el navegador de plantillas de proceso.....................................................56

Capítulo 3 Trabajar con plantillas de proceso .................................................................59Información general de las plantillas de proceso.................................................59Abrir plantillas de proceso existentes .................................................................60Crear plantillas de proceso................................................................................60Definir propiedades de la plantilla de proceso ....................................................62Gestionar datos de procesos.............................................................................64Gestionar los paquetes..................................................................................65Gestionar las variables de proceso.................................................................67Gestionar parámetros de proceso ..................................................................68Anular configuración de nivel de actividad ......................................................69

Configurar las opciones avanzadas ...................................................................70Establecer las opciones de la Lista de control de acceso (LCA) .......................70Seleccionar un calendario para el proceso......................................................71Asignar un formulario de parámetros de proceso ............................................72Crear los conjuntos de correlación .................................................................72Habilitar servicios Web entrantes ...................................................................73

Guardar plantillas de proceso............................................................................74Guardar plantillas de proceso desprotegidas ..................................................75Guardar plantillas de proceso que no están desprotegidas ..............................75

Validar plantillas de proceso..............................................................................76Instalar plantillas de proceso .............................................................................77Desinstalar plantillas de proceso....................................................................77

Modificar plantillas de proceso ..........................................................................78Plantillas de proceso para registrar, retirar y crear versiones ...............................78Desproteger plantillas de proceso ..................................................................80Proteger plantillas de proceso........................................................................80Cancelar retiradas.........................................................................................81

Eliminar las plantillas de proceso.......................................................................81Importar plantillas de proceso ...........................................................................81Exportar plantillas de proceso ...........................................................................82

4 EMC Documentum Guía de usuario de Process Builder Versión 6.7

Tabla de Contenidos

Mantener sincronizados los procesos compartidos .............................................82Imprimir plantillas de proceso............................................................................84Configurar las opciones de impresión de página .............................................84Vista previa de procesos impresos .................................................................85

Capítulo 4 Conectar actividades......................................................................................87Información general sobre la conexión de actividades ........................................87Crear flujos...................................................................................................87

Cambiar la configuración de vista ......................................................................88Capítulo 5 Crear subprocesos.........................................................................................91

Información general sobre subprocesos.............................................................91Crear un subproceso utilizando el modelado descendente ..................................92Crear un subproceso utilizando el modelado ascendente....................................92Establecer las propiedades del subproceso .......................................................93Utilizar la ficha Visualización..........................................................................93

Expandir y contraer subprocesos ......................................................................94Quitar actividades de un subproceso .................................................................94Agregar notas a un subproceso.........................................................................94Eliminar un subproceso y su contenido ..............................................................95

Capítulo 6 Trabajar con plantillas de actividad................................................................97Trabajar con plantillas de actividad ....................................................................97Crear plantillas de actividad...........................................................................97Crear una nueva plantilla de actividad.........................................................97

Copiar una plantilla de actividad.....................................................................98Gestionar las plantillas de actividad dentro de las carpetas..............................98Quitar plantillas de actividad de las carpetas...................................................98Configurar plantillas de actividad....................................................................99Validar e instalar plantillas de actividad......................................................... 100Validar plantillas de actividad.................................................................... 100Instalar las plantillas de actividad.............................................................. 101Desinstalar las plantillas de actividad ........................................................ 101

Capítulo 7 Trabajar con actividades .............................................................................. 103Trabajar con el inspector de actividades .......................................................... 103Definir propiedades de actividades .................................................................. 105Seleccionar ejecutantes.................................................................................. 106Asociar un módulo de prioridad de colas de trabajo a una actividad ............... 108Elegir ejecutantes manuales ........................................................................ 108Asignar ejecutantes ahora........................................................................ 111Hacer que el ejecutante de una actividad elija a otros ejecutantes .............. 111Definir alias de ejecutante (los ejecutantes se asignarán cuando el flujode trabajo esté en curso).......................................................................... 113Select performer based on conditions (Seleccionar ejecutante segúncondiciones)............................................................................................ 114Seleccionar ejecutante basado en los datos de proceso y parámetros deproceso................................................................................................... 116

Asignar datos de proceso a un nivel de habilidad de cola de trabajo............... 117Elegir ejecutantes automáticos .................................................................... 118Definir desencadenadores de actividades..................................................... 119Establecer temporizadores de advertencia ................................................... 120Enviar una notificación ............................................................................. 123


Tabla de Contenidos

Iniciar un proceso .................................................................................... 124Ejecutar un método Java.......................................................................... 124Delegar tareas......................................................................................... 125Completar tareas .................................................................................... 125

Definir las reglas de transición de actividad .................................................. 126Crear condiciones de transición ................................................................... 128Definir notificaciones ................................................................................... 130Cambiar la configuración de vista................................................................. 136

Capítulo 8 Asignar elementos de datos de proceso ...................................................... 139Introducción a la herramienta de asignación de datos....................................... 139Agregar o editar datos de proceso en el asignador ........................................... 141Asignar atributos de paquete........................................................................... 141Asignar comentarios de tarea como datos de proceso ...................................... 142Agregar las propiedades del mensaje .............................................................. 142Agregar un esquema XML al contenido de la actividad ..................................... 143Incorporar formularios de Forms Builder a procesos ......................................... 144Rellenar formularios mediante archivos XML ................................................ 144Crear formularios de alta fidelidad con datos de proceso ............................... 144Usar una actividad HTTP entrante: inicio para crear una nueva instanciade formulario de alta fidelidad................................................................... 144Usar una actividad Asignación de datos de procesos para crear unainstancia de formulario de alta fidelidad..................................................... 145

Agregar un nodo basado en una condición ...................................................... 146Asignar los datos............................................................................................ 146Usar el asignador de datos .......................................................................... 147Asignar atributos de repetición..................................................................... 148Usar las funciones de asignación de datos ................................................... 150Generar un tiquet de inicio de sesión ........................................................ 154

Introducción a la correlación de mensajes .................................................... 155Usar los identificadores de correlación ...................................................... 156Utilizar conjuntos de correlaciones............................................................ 157

Capítulo 9 Depurar una plantilla de proceso ................................................................. 159Introducción al depurador de proceso .............................................................. 159Utilizar el entorno de depuración de procesos............................................... 160

Preparar la depuración del proceso ................................................................. 161Usar puntos de ruptura................................................................................ 161

Iniciar un flujo de trabajo en el depurador......................................................... 162Iniciar una sesión de depuración con una actividad de inicio manual .............. 162Iniciar una sesión de depuración con una actividad de inicio entrante............. 163

Probar un proceso en el depurador ................................................................. 163Utilizar la ficha Task Manager ...................................................................... 165Gestionar tareas manuales ...................................................................... 165Gestionar tareas automáticas ................................................................... 165

Utilizar la ficha Datos de procesos ............................................................... 167Utilizar la ficha Consola ............................................................................... 167Usar la ficha Administrar flujo de trabajo....................................................... 168Depurar los métodos personalizados con el depurador de proceso ................ 168


Tabla de Contenidos

Capítulo 10 Solución de problemas ................................................................................ 171Descripción de los archivos de registro ............................................................ 171Cambiar el nivel del anexador a DEBUG ...................................................... 171Acceder a tipos de datos estructurados desde una aplicaciónpersonalizada ............................................................................................. 172

Capítulo 11 Plantillas de actividades incorporadas......................................................... 173Plantillas de actividades incorporadas ............................................................. 173Plantillas de actividades de Servicios de contenido........................................... 173BOF Module (Módulo BOF) ......................................................................... 174Crear carpeta ............................................................................................. 175Búsqueda de FS2 (Federated Search Services)............................................ 176Abrir proceso .............................................................................................. 177Ciclo de vida............................................................................................... 178Aplicar ciclo de vida .................................................................................... 180Enlazar a carpeta........................................................................................ 180Nuevo caso con plantilla.............................................................................. 181

Flujo .............................................................................................................. 182Decision Split (División de la decisión).......................................................... 182Unir............................................................................................................ 183Publicar evento en proceso padre ................................................................ 184Transformación XSL.................................................................................... 184

Integración..................................................................................................... 185Crear LCA (lista de control de acceso) ......................................................... 185Crear evento de iCalendar .......................................................................... 186DB entrante: inicio y procedimiento.............................................................. 187DQL entrante: inicio y procedimiento............................................................ 190DQL Read (Leer DQL) ................................................................................ 191DQL Write (Escribir DQL) ............................................................................ 192Database Read (Leer base de datos) ........................................................... 193Database Stored Procedure (Procedimiento almacenado en base dedatos)......................................................................................................... 195Patrones de búsqueda de ejemplo ............................................................... 196Database Write (Escribir base de datos)....................................................... 197Dynamic Web Service (Servicio Web dinámico) ............................................ 199Abrir servicios Web no seguros ................................................................ 199Invocar servicios Web seguros ................................................................. 200

Email Inbound: inicio y procedimiento .......................................................... 207Establecer tipos de objetos personalizados para los anexos .......................... 209FTP entrante: inicio y procedimiento ............................................................ 210FTP saliente ............................................................................................... 212Leer FTP ................................................................................................... 214Fax saliente................................................................................................ 215Enviar una solicitud de consulta mediante Fax saliente ................................. 217HTTP entrante: inicio y procedimiento.......................................................... 218HTTP saliente............................................................................................. 220JMS entrante: inicio y procedimiento............................................................ 221JMS Saliente .............................................................................................. 223Asignación de datos de procesos................................................................. 224Plantilla de actividades SMTP...................................................................... 225WS entrante: inicio y procedimiento ............................................................. 228Servicio Web .............................................................................................. 231Documento de xPression Publish................................................................. 232Documento de publicación xPression: avanzado ......................................... 233


Tabla de Contenidos

Plantillas de actividad no admitidas ................................................................. 235Punto de observación.................................................................................. 236FTP............................................................................................................ 237Buzón HTTP............................................................................................... 238Aplicar ciclo de vida (5.3x y versiones anteriores) ......................................... 238Vuelta al estado anterior del ciclo de vida ..................................................... 239Promoción de ciclo de vida .......................................................................... 239Publicar en el tema de JMS ......................................................................... 239SMTP......................................................................................................... 240Enviar a la cola de JMS............................................................................... 241Enviar a MQ JMS........................................................................................ 242Iniciar subproceso....................................................................................... 242

Ejemplo ......................................................................................................... 243Decisión de repasar tarea de la cola ............................................................ 243Plantilla de actividad de ejemplo .................................................................. 244Definir habilidad para tarea de cola .............................................................. 244

Capítulo 12 Uso de variables de sustitución en actividades personalizadas .................. 245Utilizando variables de sustitución para propiedades de plantillas de actividadpersonalizadas............................................................................................... 245

Capítulo 13 Archivo de configuración de Process Builder.............................................. 249Archivo de configuración de Process Builder.................................................... 249


Prefacio

Con esta guía se pretende ayudar a los usuarios a diseñar y a generar plantillas de procesoscomerciales con EMC Documentum Process Builder. Process Builder es el centro de diseño deProcess Suite, que habilita y admite todas las fases del ciclo de vida del proceso comercial.

DestinatariosEsta guía está pensada para usuarios que diseñan procesos comerciales. Se asume que los usuariosestán familiarizados con el funcionamiento básico de EMC Documentum, en especial con lasfunciones de flujo de trabajo en tiempo de ejecución disponibles en Documentum Webtop o enTaskSpace.

Historial de revisiónEsta sección contiene una descripción del historial de revisión de este documento.

Tabla 1 Historial de revisión

Fecha de revisión DescripciónMarzo de 2011 Publicación inicial

Información de asistencia técnicaLas políticas y servicios de asistencia técnica de EMC Documentum están disponibles en el sitioweb de EMC Powerlink (http://Powerlink.EMC.com).

Nota: Debe registrarse en línea en Powerlink antes de utilizarlo.

Documentación relacionadaProcess Builder es una herramienta de diseño para plantillas de procesos empresariales. Los flujosde trabajo se crean a partir de estas plantillas en tiempo de ejecución. La documentación delusuario de Documentum Webtop o TaskSpace incluye información sobre cómo ejecutar y participaren flujos de trabajo.

Además de esta guía, la documentación de Process Builder incluye lo siguiente:

• EMC Documentum Process Builder Development Guide (Guía de desarrollo de EMCDocumentum Process Builder)

• EMC Documentum Process Builder Installation Guide (Guía de instalación de EMCDocumentum Process Builder)

• EMC Documentum Process Builder Release Notes (Notas de la versión de EMC DocumentumProcess Builder)

• EMC Documentum Process Builder Localization Guide (Guía de localización de EMCDocumentum Process Builder Localization)


http://powerlink.emc.com

Prefacio


Capítulo 1

Introducción al diseño de procesos

En este capítulo se trata lo siguiente:

• Introducción a los flujos de trabajo

• Plantillas de proceso y objetos de flujo de trabajo asociados

• Planificar los procesos de flujo de trabajo

Introducción a los flujos de trabajoBusiness Process Builder se utiliza para crear plantillas de proceso. Una plantilla de proceso captura ladefinición de un proceso comercial. Las instancias de procesos individuales que se generan en unaplantilla de proceso se denominan flujos de trabajo.

Un flujo de trabajo formaliza un proceso comercial, como por ejemplo, un proceso de reclamación alseguro o un proceso de desarrollo de ingeniería. Un flujo de trabajo incluye los siguientes elementos:

• Una plantilla de proceso es el proceso comercial representado como una definición de flujo detrabajo formalizado.Debido a que las plantillas de proceso son independientes a la creación de instancias en tiempo deejecución, es posible ejecutar a la vez varios flujos de trabajo basados en la misma plantilla.

• Una plantilla de proceso consta de varias actividades.Estas actividades representan las tareas necesarias para completar el proceso, como la recepción deun correo electrónico, la revisión, el registro en el repositorio o la aprobación de un documento.

• Flujos son los vínculos entre las actividades, especificando la secuencia de actividades.• Los datos de proceso son los distintos tipos de datos que fluyen por el proceso. Los datos de procesopueden ser un documento, un formulario, variables de proceso como números de pieza o direccionesde clientes, o parámetros de proceso que permiten que los administradores modifiquen un valorconstante para un parámetro específico a través de la instancia de proceso.Los datos de proceso están formados por variables de proceso, parámetros de proceso y paquetesque se mueven por el flujo de trabajo.

– Las variables de proceso son las variables de los tipos de datos o los datos de ejecución,individuales o agrupados, que se utilizan durante la vida del proceso.Un ejemplo de variables de proceso son los distintos elementos de datos que representan diversostipos de información sobre un cliente. Consulte Plantillas de proceso y objetos de flujo de trabajoasociados, página 14 si necesita más información sobre los componentes del flujo de trabajo.

– Los parámetros de proceso son valores que permiten a los administradores de la aplicaciónmodificar valores constantes que se utilizan en un proceso. Los parámetros de proceso se puedenutilizar en valores fijos dentro de un proceso, como roles de escalada, condiciones de transición,asignaciones dinámicas del ejecutante, etc. Cuando un administrador cambia los valores del



parámetro en la ficha Administración de TaskSpace, el valor se actualiza en todas las instanciasnuevas del proceso.

– Los paquetes contienen el objeto, normalmente un documento o archivo de imágenes, que se pasaentre las actividades para que el trabajo se pueda realizar en él.

Una solicitud de préstamo es un ejemplo de objeto que puede contener un paquete.

Figura 1 Las plantillas de proceso capturan procesos comerciales

Las plantillas de proceso pueden describir procesos comerciales simples o complejos. Puede crearflujos de trabajo que tengan segmentos de serie y segmentos paralelos. En un segmento de serie, lasactividades se suceden siguiendo una secuencia especificada. En un segmento paralelo, dos o másactividades se realizan simultáneamente. Asimismo, se puede crear un flujo de trabajo cíclico, en elque la finalización de una actividad reinicia una actividad completada anteriormente. La ruta que sigueun documento a través del flujo de trabajo puede diferir dependiendo de lo que ocurre durante elproceso. Por ejemplo, un pedido de compra se puede distribuir a diferentes actividades dependiendode si el administrador lo aprueba o lo rechaza.

Podrá crear una plantilla de proceso y usarla en muchas situaciones. Por ejemplo, puede utilizaractividades que identifican ejecutantes basándose en datos de proceso o alias en lugar de nombres deusuario reales. Cuando se usan datos de proceso o alias, el usuario real se selecciona en tiempo deejecución. Por ejemplo, un proceso empresarial típico con los documentos nuevos consta de cuatrofases: creación, revisión, corrección y publicación del documento. El autor y el revisor cambiarán dedocumento a documento. En lugar de crear un flujo de trabajo diferente para cada documento con losnombres del autor y el revisor asignados durante el proceso de diseño, se crea una plantilla de procesocon definiciones de actividad que usan datos de proceso para definir los nombres del autor y delrevisor. Puede diseñar el flujo de trabajo para seleccionar el autor y los revisores basándose en:

• El usuario que inicia el flujo de trabajo

• El ejecutante de la actividad anterior

• La lógica condicional definida en el flujo de trabajo

Puede agregar actividades a una plantilla de proceso mediante la creación de una actividad en blanco ola selección de la plantilla de actividad para el tipo de tarea representada por la actividad. La plantillade actividad determina qué atributos de configuración son necesarios para un tipo de tarea determinado.Incluye atributos comunes a todas las actividades (como el nombre y la lista de ejecutantes) y atributospersonalizados exclusivos de una tarea determinada. Por ejemplo, la plantilla para actividades queenvían archivos a un sitio Web incluiría un atributo con la URL que se usaría para el envío. Process



Builder incorpora plantillas de actividad predefinidas que representan tipos de actividad típicos ypuede crear plantillas de actividad personalizadas que se adapten exactamente a sus necesidades.

Los paquetes y las actividades pueden tener una plantilla de formulario asociada. Esta plantilla definelos campos de introducción de datos que se muestran a los ejecutores de la actividad y especifica cómose almacenan éstos en el repositorio de Documentum. Los formularios se crean mediante DocumentumForms Builder y se asocian con procesos que utilizan Process Builder.

Documentum Content Server implementa una plantilla de proceso de flujo de trabajo como objetodm_process. Por su parte, las definiciones de las actividades individuales de una plantilla de procesose almacenan en objetos dm_activity. Cuando diseñe un flujo de trabajo, puede incluir definicionesde actividad existentes y crear definiciones de actividad nuevas.

Cada vez que se inicia un flujo de trabajo, el servidor usa la plantilla de proceso (el objeto dm_process)para crear una instancia en tiempo de ejecución del mismo (un objeto dm_workflow). Cuando se iniciauna actividad, el servidor crea uno o más elementos de trabajo (dmi_workitem). Los elementos detrabajo son tareas que el servidor agrega a la bandeja de entrada de los usuarios designados comoejecutantes de la actividad.

El motor de proceso de Documentum instala el trabajo dm_initialize_WQ, que recopila e inicializa lastareas de cola con las habilidades configuradas en la actividad. La Guía del usuario de DocumentumAdministrator proporciona instrucciones sobre cómo configurar trabajos.

En el siguiente diagrama se describe el funcionamiento conjunto de los componentes de una plantillade proceso y una instancia en tiempo de ejecución.

Figura 2 Componentes de un flujo de trabajo



Plantillas de proceso y objetos de flujo detrabajo asociadosEl modelo de datos de proceso de Process Builder consta de una plantilla de proceso, un conjuntode definiciones de actividad, un grupo de datos que pasan por todo el proceso, un conjunto de flujosque conectan las actividades entre sí y uno o varios paquetes que representan los documentos quese están procesando.

La plantilla de proceso define la estructura de un proceso comercial. Está compuesta de definiciones deactividad y de un conjunto de atributos que definen los flujos que conectan las actividades.

ActividadesLas actividades representan las tareas que forman el proceso comercial. Los flujos de trabajo contienenvarios tipos de actividades:

• Las actividades de inicio son las primeras actividades del flujo de trabajo.• Las actividades de comienzo están conectadas a las actividades de inicio.• La actividad de finalización es la última actividad del flujo de trabajo. Una plantilla de procesosólo puede tener una actividad de finalización.

• Las actividades intermedias son las actividades existentes entre las actividades de inicio y definalización. Una plantilla de proceso puede tener un número ilimitado de actividades intermedias.

• Las actividades de espera de mensaje son actividades que participan en comunicación asincrónicacon aplicaciones externas y están diseñadas para obtener una respuesta de la aplicación.

• Las actividades del controlador de errores permiten especificar la acción que se debe realizar si seproduce un error en una actividad automática.

Las actividades pueden ser manuales o automáticas. Uno o varios usuarios realizan una actividadmanual. El sistema realiza una actividad automática en nombre de un usuario.

Los atributos de una definición de actividad describen las características de dicha actividad, incluidos:

• La forma de ejecución de la actividad• El ejecutante del trabajo• Cómo se asigna el ejecutante• El elemento que inicia la actividad• Qué desencadenadores son necesarios• Cuál es el comportamiento de transición una vez que se ha completado la actividad

Asimismo, las actividades también pueden presentar características específicas del tipo de tarea querepresentan. Por ejemplo, una actividad que envía documentos a un proveedor externo incluiría unatributo con la dirección de correo electrónico del proveedor. El conjunto de atributos personalizadosasociados a una actividad se configura mediante plantillas de actividad.

Cuando el servidor inicia una actividad, crea elementos de trabajo que agrega posteriormente a lasbandejas de entrada de los ejecutantes de la actividad. Estos elementos de trabajo contienen lospaquetes en los que trabaja el ejecutante, así como instrucciones relativas a la tarea requerida. Elservidor agrega un elemento de cola a la bandeja de entrada enlazado al elemento de trabajo. En el



manual Documentum Content Server Object Reference Guide se puede obtener más informaciónsobre este tema.

Actividades de inicio

Las actividades de inicio especifican las condiciones que comienzan una instancia de proceso. Lasactividades de inicio pueden conectar con cualquier actividad de comienzo y pueden ser manuales oautomáticas. Puede comenzar un flujo de trabajo con una actividad de inicio manual, varias actividadesde inicio automáticas o una combinación de una actividad manual y varias actividades de inicioautomáticas. Si la actividad de inicio es una actividad automática, especifique la configuración delcanal y las reglas de asignación para copiar los datos del mensaje en los datos de proceso. Si laactividad de inicio es manual, puede configurarla para iniciar un formulario creado en Forms Builderque inicie el proceso.

Por ejemplo, un flujo de proceso de una aplicación de préstamo puede tener varias actividades deinicio. Puede iniciarse con una actividad de inicio manual que inicie automáticamente un formulariode aplicación de préstamo que un procesador pueda finalizar durante una aplicación para llamadastelefónicas. El mismo proceso también puede tener una actividad de inicio automático que reciba unaaplicación de préstamo a través de un mensaje de correo electrónico.

Debe asignar el formulario creado en Forms Builder a la actividad de inicio manual en la fichaPropiedades del Inspector de actividades.

Para incluir una actividad de inicio automático, cree una actividad denominada Formulario de correoelectrónico recibido, donde se configura la cuenta de correo electrónico y los detalles del encabezado yel cuerpo del mensaje de correo electrónico se asignan a los datos de proceso.

Una actividad de inicio manual sólo permite configurar las fichas Propiedades, Datos y Presentación.Otras actividades de inicio como la plantilla de la actividad de inicio - Correo electrónico entrantetienen todas las fichas estándar así como una ficha para configurar la conexión del servidor de correoelectrónico.

Actividades de espera de mensaje

Un proceso comercial puede participar en comunicación asincrónica con otras aplicaciones externas.Una aplicación puede enviar al otro un mensaje y esperar una respuesta. Process Builder utilizaconjuntos de correlaciones que constan de datos exclusivos del mensaje para hacer coincidir larespuesta con la solicitud original. Cualquier plantilla de actividad de recepción puede configurarsecomo una actividad de espera de mensaje.

Por ejemplo, en una actividad de un proceso de compra, se envía un mensaje JMS al proveedor quesolicita información sobre si se envió un elemento de un pedido de compra. El mensaje especifica tantoel número de ID del proveedor como el número de pedido de compra del elemento. Posteriormente,el sistema del proveedor responde con un mensaje de estado de envío para el pedido de compra y elsistema utiliza el número del pedido de compra y el ID del proveedor incluido en el mensaje paracoincidir la solicitud con la respuesta.

Actividades del controlador de errores

Una actividad de controlador de errores es una actividad secundaria que se desencadena cuando unaactividad automática asociada produce un error en tiempo de ejecución. Una actividad de control deerrores puede ser tanto manual como automática y puede enlazarse a más de una actividad automática.



Una actividad del controlador de errores no puede tener un flujo saliente. Sólo se puede utilizar comocontrolador de errores en el proceso.

Cuando se asigna un controlador de errores a una actividad automática, el controlador de erroresse ejecuta cada vez que se produce un error con el método asociado a la actividad. Por lo que siha configurado el sistema para reintentar el método en un intervalo especificado y para un númeroespecificado de veces, el controlador de errores se ejecutará cada vez que se produzca un error demétodo hasta que el sistema haya ejecutado el número de intentos especificado.

Una vez que el sistema haya realizado el número especificado de intentos, llevará a cabo una acciónfinal basada la configuración de la ficha del ejecutante y continuará, se detendrá o finalizará el flujo detrabajo. Seleccionar ejecutantes, página 106 contiene más información acerca de cómo configurar elnúmero de intentos y el intervalo entre los intentos para las actividades automáticas fallidas.

Figura 3 Actividad del controlador de errores

En el panel del editor, se asocia la actividad de controlador de errores a la actividad automáticautilizando el botón de flujo para la asignación del controlador de errores de la barra de herramientas.El sistema identifica la actividad del controlador de errores con un icono de rayo sobre la actividady utiliza una línea discontinua gris para enlazar la actividad del controlador de errores con susactividades automáticas asociadas.

Nota: El control de errores no se admite para las plantillas de actividad entrante.

Datos de procesoLos datos de proceso son los distintos tipos de datos que fluyen por el proceso, como:

• Documentos• Formularios• Variables de proceso, como números de pieza o direcciones de clientes• Los parámetros de proceso que permiten a los administradores modificar un valor constante paraun elemento de datos concreto durante la instancia de proceso

La exposición y utilización de datos de proceso permite que los usuarios vean datos comercialessignificativos cuando ven su lista de tareas, como el nombre del candidato, el estado de aprobación deuna solicitud, la cantidad de un préstamo, etc. Esta información permite que el ejecutante de una tareatrabaje de manera más eficiente en las tareas de su bandeja de entrada.

Los datos de proceso están formados por varios tipos de datos:



• Las variables de proceso que se definen en el contexto del proceso.A estas variables se les pueden asignar valores predeterminados en el momento de diseñarlas, comoparte del proceso, o se pueden inicializar a partir de un formulario asociado con el proceso. Lasvariables de proceso pueden ser variables simples, como valores de cadena o booleanos, o tiposde datos complejos basados en los tipos de datos definidos como tipos de datos estructurados.Consulte Introducción a los datos de proceso, página 31 si precisa más información sobre lasvariables de proceso.

• Los parámetros de proceso que permiten a los administradores de la aplicación modificar valoresconstantes que se utilizan en un proceso. Los parámetros de proceso se pueden utilizar en roles deescalada, transiciones, selección de ejecutantes y para otros valores fijos de un proceso. Cuando eladministrador cambia los valores del parámetro en la ficha Administración de TaskSpace, el valor seactualiza en todas las nuevas instancias del proceso.Introducción a los datos de proceso, página 31 proporciona más información sobre este tema.

• Los datos obtenidos colateralmente del flujo de trabajo, como datos de paquetes o datos entrantes deservicios Web.Consulte Introducción a los datos de proceso, página 31 si precisa más información sobre datos depaquetes.

• Los datos de ejecución originados en el flujo de trabajo y elementos de trabajo actuales como lafecha de creación del flujo de trabajo y el estado en tiempo de ejecución del elemento de trabajo.Esta información se mantiene por el motor de proceso y se descarta cuando el flujo de trabajo hafinalizado.

Habilitar informes de Business Activity Monitor (BAM)

Process Builder se puede utilizar para configurar qué datos de ejecución se guardan en la base de datosde BAM, donde se pueden aprovechar para crear informes de BAM. Los diseñadores de procesospueden seleccionar variables de proceso (incluidos los tipos de datos estructurados) y objetos incluidosen paquetes específicos para los informes de BAM.

Para actualizar los datos empresariales de Process Builder en la base de datos de BAM, siga estos pasos:

• Active el seguimiento de comprobación para un proceso específico.

El seguimiento de comprobación es el medio a través del cual se publican datos de informes en labase de datos de BAM. Definir propiedades de la plantilla de proceso, página 62 proporcionainstrucciones sobre cómo habilitar el seguimiento de comprobación.

• Cree tipos de datos estructurados con atributos seleccionados para informes.

Crear tipos de datos estructurados, página 47 proporciona instrucciones sobre cómo crear tipos dedatos estructurados que se pueden supervisar en los informes de BAM.

• Seleccione los paquetes que desea incluir en los informes del nivel de proceso o la actividadindividual.

Gestionar los paquetes, página 65 y Cambiar datos de proceso en una actividad, página 134proporcionan instrucciones sobre la selección de paquetes para la supervisión en los niveles deproceso y actividad.

• Seleccione las variables que desea incluir en los informes de cada actividad.

Las variables pueden ser tipos simples (booleanos o de cadena) o tipos de datos estructuradosseleccionados para los informes en el momento de su creación. Cambiar datos de proceso en una



actividad, página 134 proporciona instrucciones sobre cómo seleccionar variables y tipos de datosestructurados para la supervisión en el nivel de actividad.

• Asegúrese de que todos los cambios en los datos empresariales que se están supervisando se hanactualizado en la base de datos de BAM. Actualizar datos de proceso en la base de datos de BAM,página 44 proporciona más información sobre la actualización de datos de proceso en la base dedatos de BAM.

En la Guía de implementación de Documentum Business Activity Monitor se proporciona informacióndetallada sobre cómo configurar los informes de BAM.

FlujosLos flujos conectan las actividades en el proceso. Permiten el movimiento de paquetes, variables deproceso, propiedades y cualquier dependencia que exista entre las actividades conectadas.

Existen tres tipos de flujos:

• Los flujos de avance pasan los paquetes de una actividad a la siguiente en el flujo de trabajo normal(por ejemplo, desplazando el paquete de la actividad de modificación a la actividad de aprobación).

• Los flujos de rechazo, por su parte, determinan lo que ocurre cuando el ejecutante de una actividadrechaza la tarea que se distribuye. Estos flujos dirigen los paquetes en un bucle hacia atrás, porejemplo, desplazando un paquete de la actividad de aprobación a la de modificación.

• Los Flujos del controlador de errores determinan qué acción se debe realizar cuando una actividadautomática asociada falla. Actividades, página 14 proporciona información específica sobre estetema.

Todas las actividades intermedias deben presentar, al menos, un flujo entrante y otro saliente. Unaactividad de inicio tiene, al menos, un flujo saliente, pero ninguno entrante. Una actividad definalización debe tener, al menos, un flujo entrante, pero ninguno saliente.

Planificar los procesos de flujo de trabajoLa creación de una plantilla de proceso implica tomar una serie de decisiones relativas al diseño.Deberá decidir los tipos de datos de procesos que intervienen en el proceso, las actividades que seincluyen y cómo estructurar el flujo de trabajo.

En primer lugar, es necesario revisar el proceso comercial que desea automatizar e identificar lasecuencia de actividades requeridas para completarlo. En Elegir o crear plantillas de actividad, página21 encontrará una serie de directrices que le ayudarán a tomar decisiones relativas a las actividades.

Deberá tomar las siguientes decisiones con cada una de las actividades del flujo de trabajo:

• ¿Hay una plantilla de actividad adecuada disponible?En Elegir o crear plantillas de actividad, página 21 se explica cómo decidir si es necesario crearplantillas adicionales.

• ¿Quién es el ejecutante?En Elegir ejecutantes, página 21 se describe esta opción.

• Para actividades manuales:



– ¿Puede el usuario delegar o ampliar la actividad? En Permitir la delegación y la extensión,página 25 se describen estas opciones.

– ¿Qué tipo de mensajes se debería mostrar a los ejecutantes para facilitar información sobre elelemento de trabajo? En Definir asuntos de tareas, página 26 se describe esta opción.

– ¿Debe el usuario cerrar la sesión para completar la actividad? En Agregar un requisito de firma,página 27 se describe esta opción.

– ¿Debería el usuario cumplimentar una plantilla de formulario personalizada para completar laactividad? En Asociar plantillas de formulario con paquetes, página 33 se describe esta opción.

• En el caso de las actividades automáticas, ¿cuál es su prioridad?En Definir valores de prioridad, página 27 se describen los valores de prioridad para las actividadesautomáticas.

• ¿Qué datos de proceso transporta el proceso por el flujo?Introducción a los datos de proceso, página 31 describe los tipos diferentes de datos de procesoque se pueden utilizar en un flujo de trabajo.

• Si desea crear informes basados en el flujo, ¿qué datos de proceso deberían utilizarse para generarinformes?Crear tipos de datos estructurados, página 47 proporciona más información sobre cómo hacer quelos datos de proceso estén disponibles para generar informes.

• ¿Cuándo se inicia la actividad?En Definir condiciones de desencadenamiento, página 34 encontrará información sobre esta decisión.

• ¿Qué acciones realizará la actividad si no se ha iniciado o completado en un tiempo razonable?En Definir temporizadores, página 34 se describen las acciones disponibles.

• Para las actividades automáticas, ¿qué acciones deberían realizarse si un método produce errores?Actividades, página 14 proporciona información detallada sobre este tema.

• ¿Qué notificaciones enviará esta actividad cuando se produzcan eventos del sistema?En Configurar notificaciones, página 36 se analizan las opciones de notificación.

• ¿Qué ocurre a continuación en el flujo de trabajo?En Definir transiciones de actividad, página 36 se describen las opciones de transición.

Establecer funciones y permisosDurante la etapa de planificación de la implementación, identifique las funciones de todos losejecutantes que participan en el proceso. Para cada función de ejecutante, identifique los permisos quecada ejecutante necesita para acceder a los datos necesarios para realizar su tarea asignada. Asegúresede incluir los permisos para los datos de sólo lectura y para los datos que el ejecutante especifica omodifica.

A continuación se indican los permisos mínimos que debe configurar:

• Para las plantillas de proceso, asegúrese de que los usuarios del grupo del desarrollador tienenpermiso para realizar modificaciones; los usuarios con permiso "World" pueden examinarlas.

• Para iniciar un proceso, el usuario necesita el permiso Relacionar y el permiso extendido Iniciarprocedimiento.



• Para las variables de proceso, los ejecutantes potenciales deben tener permiso de edición.

• Para los paquetes, los ejecutantes potenciales correspondientes deben tener permisos de edición,modificación o lectura, según los requisitos del negocio.

El rol dm_workflow_task_supervisor se instala de forma predeterminada con Content Server. Elrol dm_workflow_task_supervisor contiene los roles queue_manager y queue_advance_processor.Si existen usuarios que realizan funciones como la adquisición y reasignación de tareas de flujo detrabajo, agregue sus roles al rol dm_workflow_task_supervisor. Para permitir que un usuario adquierao reasigne una actividad, agregue dm_world al rol dm_workflow_task_supervisor.

Tabla 2 Operaciones de flujo de trabajo y roles de ejecutante necesarios

Operación de flujo de trabajo Rol de ejecutante necesario o permiso establecidoAdquirir y delegar un elemento de trabajo Ejecutante asignado del elemento de trabajo o, si el ejecutante

asignado es un grupo, miembro de dicho grupo

Supervisor del flujo de trabajo

Usuario con privilegios de administrador de sistema o desuperusuario

El usuario pertenece al rol dm_workflow_task_supervisor

Para la tarea de cola de trabajo, el usuario pertenece al grupo deadministradores de la cola de trabajo

Detener y reanudar una actividad enejecución





Para la tarea de cola de trabajo, el ejecutante de la tarea

Establezca y guarde los siguientesatributos de elemento de trabajo:

• a_wq_name

• a_wq_flag

• a_wq_policy_id

• a_wq_doc_profile

• a_held_by





Para la tarea de cola de trabajo, el ejecutante de la tarea

Establecer un valor de prioridad deelemento de trabajo en tiempo deejecución.







Elegir o crear plantillas de actividadA medida que identifique las tareas comerciales necesarias en cada paso del proceso, determine si hayuna plantilla de actividad que admita todas las actividades que agregue al proceso. Muchas plantillasde actividad incluyen uno o varios atributos personalizados exclusivos de una tarea determinada.Por ejemplo, la plantilla para actividades que envían correo electrónico incluye un atributo quecontiene la dirección de correo electrónico de destino. La plantilla también puede proporcionar valorespredeterminados para los atributos comunes a todas las actividades.

Process Builder incorpora plantillas de actividad predefinidas que representan tipos de actividad típicos.Si su proceso comercial incluye actividades con un fin específico a las que no se les aplica ninguna delas plantillas disponibles, cree actividades personalizadas cuyos atributos personalizados reflejen lastareas realizadas con las actividades. Puede que también tenga que desarrollar un método de flujo detrabajo personalizado para ejecutar la tarea requerida. Si normalmente utiliza un determinado tipo deactividad personalizada, puede basarse en ella para crear una plantilla de actividad personalizada.

Trabajar con plantillas de actividad, página 97 proporciona más detalles acerca de cómo crearplantillas de actividad.

Elegir actividadesCada plantilla de proceso debe tener una o varias actividades de inicio y una sola actividad definalización. La plantilla puede tener un número ilimitado de actividades intermedias. El número depasos que se deben incluir depende únicamente de la estructura y la finalidad del flujo de trabajo.

Cada actividad del flujo de trabajo debe tener un nombre exclusivo en la plantilla de proceso. Elnombre se asigna al agregar la actividad a la plantilla de proceso. Elija nombres descriptivos quedefinan el trabajo realizado por la actividad.

Puede incluir actividades que haya creado o actividades para las que disponga al menos de permisopara Relacionar.

Las definiciones de actividad se pueden usar varias veces en un flujo de trabajo. Supongamos, porejemplo, que desea que todos los documentos se sometan a dos rondas de revisión. Podría diseñar elflujo de trabajo con las siguientes actividades: Escribir, Revisar 1, Corregir, Revisar 2 y Publicar. Lasactividades Revisar 1 y Revisar 2 pueden usar la misma definición de actividad.

Sin embargo, si usa una actividad varias veces en un flujo de trabajo, debe estructurarlo de modo quesolo una instancia de la actividad esté activa a la vez. Un flujo de trabajo no puede iniciar una actividadsi la actividad anterior, basada en la misma definición, aún está en ejecución.

Elegir ejecutantesUna definición de actividad incluye la información que permite a Process Builder determinar elejecutante de la actividad. Process Builder ofrece un alto nivel de flexibilidad en cuanto a quién puedeser el ejecutante de una actividad. En el caso de las actividades automáticas, se debe identificar alusuario cuyos permisos se usarán durante la ejecución de la secuencia de comandos o del programa.

Al iniciarse una actividad manual, el servidor agrega un elemento de trabajo a la bandeja de entradadel usuario o usuarios designados como ejecutantes de la actividad. Para procesar documentosde gran volumen, puede agregar el elemento de trabajo a una cola de trabajo con la que trabajanmuchos usuarios diferentes. En la guía Documentum Webtop User Guide o en la guía Documentum



TaskSpace Configuration Guide se proporciona más información sobre la gestión de colas de trabajo ylos ejecutantes.

La tabla siguiente enumera las categorías entre las que se puede elegir al ejecutante. Cada categoríaestá representada por un valor entero. Solo las cuatro primeras opciones (de 0 a 3) están disponibles enlas actividades automáticas.

Tabla 3 Categorías de selección del ejecutante de la actividad

Categoría de usuario Selección de los ejecutantes0 Supervisor del flujo de trabajo El servidor selecciona al usuario designado como supervisor

del flujo de trabajo cuando se inicia la actividad. De formapredeterminada, el usuario que inicia el flujo de trabajo es elsupervisor.

1 Propietario del repositorio El servidor selecciona al usuario identificado como el propietariodel repositorio activo.

2 Ejecutante de la actividad anterior El servidor selecciona al ejecutante de la anterior actividadfinalizada que cumplió la condición de desencadenamientode la actividad actual. (Consulte Definir condiciones dedesencadenamiento, página 34 si necesita más información sobrelas condiciones de desencadenamiento). Puede incluir variosejecutantes así como usuarios de otras actividades anteriores.

3 Usuario específico Selecciona un nombre de usuario real al crear la plantilla.

4 Todos los usuarios del grupo Selecciona un nombre de grupo al crear la plantilla. Elservidor asigna en tiempo de ejecución un elemento de trabajoindependiente a cada uno de los miembros del grupo.

5 Un solo usuario del grupo (Primero enadquirir el elemento de trabajo)

Selecciona un nombre de grupo al crear la plantilla. El servidorasigna en tiempo de ejecución un elemento de trabajo nuevoa cada uno de los miembros del grupo. Cuando uno de losmiembros del grupo obtiene el elemento de trabajo, los elementosde trabajo se quitan de todas las bandejas de entrada de losmiembros del grupo.

6 Un solo usuario del grupo (Cantidadmenor de elementos de trabajo sinterminar)

Selecciona un nombre de grupo al crear la plantilla. El servidordetermina en tiempo de ejecución qué usuario del gruposeleccionado presenta la menor carga de trabajo y le asigna unnuevo elemento de trabajo. La carga de trabajo se mide como elnúmero de elementos de trabajo inactivos y activos.

7 Algunos usuarios de un grupo Selecciona una lista de varios usuarios o alias como ejecutantesde la actividad. El servidor asigna un elemento de trabajo a cadauno de los usuarios seleccionados como ejecutantes.



Categoría de usuario Selección de los ejecutantes8 Varios ejecutantes secuenciales Selecciona una lista de varios usuarios o alias como ejecutantes de

la actividad. El servidor asigna el elemento de trabajo al primerusuario de la lista de usuarios seleccionados. Cuando el usuariocompleta el elemento de trabajo, el servidor crea otro elementopara el siguiente usuario de la lista. Este proceso continúahasta que todos los usuarios seleccionados han completado suselementos de trabajo.

9 Cola de trabajo El servidor asigna el elemento de trabajo a la cola de trabajoque seleccione. Los usuarios asignados para trabajar en esa colaextraen los elementos de trabajo de la cola en orden de prioridad,o bien el administrador de la cola asigna el elemento a un usuarioparticular. Para obtener más información sobre el procesamientode colas de trabajo, consulte la guía Documentum Webtop UserGuide o la guía Documentum TaskSpace Configuration Guide.

Los participantes en un flujo de trabajo tienen la opción de aparecer como no disponibles para realizartareas de flujo de trabajo. Si cuando se ejecuta el flujo de trabajo no está disponible el usuarioseleccionado como ejecutante, el motor del flujo de trabajo intenta asignar el elemento de trabajo alusuario delegado del primero. Consulte Permitir la delegación y la extensión, página 25 si necesitamás información sobre los usuarios delegados.

Si necesita más información sobre la selección de los ejecutantes de una actividad en Process Builder,consulte Seleccionar ejecutantes, página 106. Si necesita información detallada sobre la creación deactividades cuyos ejecutantes se seleccionan en tiempo de ejecución, consulte Definición de cuándo sedetermina el ejecutante, página 23 y Usar alias, página 24.

Definición de cuándo se determina el ejecutante

Cuando cree la actividad, defina el tipo de ejecutante y la categoría de usuario. Puede definir elejecutante real en ese momento o configurar la actividad para que lo seleccione en tiempo de ejecución:

• El iniciador del flujo de trabajo, cuando éste se inicie

• El servidor, cuando se inicie la actividad

• El ejecutante de una actividad anterior, una vez completada la actividad

• Basado en lógica condicional que define en la actividad.

Definir el ejecutante real en una definición de actividad es una alternativa menos flexible. En cambio,permitir que el ejecutante de una actividad anterior elija al ejecutante de una actividad es más flexible,ya que permite que las decisiones relativas a los ejecutantes se basen en las circunstancias y reglasempresariales actuales. Permitir la configuración de un ejecutante basándose en condiciones es laalternativa más flexible utilizada para determinar al ejecutante.

Si selecciona la categoría 0 (Supervisor del flujo de trabajo), 1 (Propietario del repositorio) o 2(Ejecutante de la actividad anterior) como la categoría de usuario, será la categoría la que defina alusuario real. Por ejemplo, un flujo de trabajo en ejecución solo tiene un supervisor del flujo de trabajoy el repositorio en el que se ejecuta solo tiene un propietario del repositorio. No es necesario definir lapersona real al crear la actividad. El servidor la determinará cuando se inicie dicha actividad.



Si selecciona la categoría 3 (Usuario específico), podrá elegir a la persona en sí en el momento de crearla actividad. Para seleccionar a la persona real cuando se ejecuta el flujo de trabajo, utilice un aliaso defina la lógica condicional para determinar al usuario. Usar alias, página 24 o Select performerbased on conditions (Seleccionar ejecutante según condiciones), página 114 proporcionan informacióndetallada sobre estos temas.

Al utilizar un alias, el usuario puede resolverse automáticamente por el sistema utilizando un conjuntode alias o por el ejecutante de una actividad anterior. Las mismas opciones se aplican a las categorías 4,5, 6 ó 10, con la excepción de que debe proporcionar el nombre de un grupo o cola de trabajo en lugardel nombre de un usuario individual. Proporcione un nombre de grupo o de cola si está eligiéndolo alcrear la actividad. Utilice un alias si desea que el grupo o cola real se seleccione en tiempo de ejecución.

En el caso de las categorías 7 y 8, proporciona los nombres o alias de una lista de varios usuarios. Aligual que con otras categorías, puede seleccionar los ejecutantes reales al crear la actividad, hacer quesea el ejecutante de una actividad anterior el que elija al ejecutante o usar alias para que el ejecutantese seleccione en tiempo de ejecución.

Con cola de trabajo de categorías de usuario, un usuario concreto, todos los usuarios de un grupo, unúnico usuario de un grupo, algunos usuarios de un grupo o varios usuarios secuenciales, puede definirla lógica condicional en la actividad que resuelve el ejecutante basada en los datos de proceso y otralógica que define en una tabla de decisión. En tiempo de ejecución, el motor del proceso evalúa lasreglas tal y como se han configurado y asigna un ejecutante para la actividad. Select performer basedon conditions (Seleccionar ejecutante según condiciones), página 114 proporciona más informaciónsobre este tema.

Usar alias

Un alias es un nombre descriptivo de una categoría de usuario o grupo que se usa en lugar del nombrereal de usuario o grupo. El servidor sustituye en tiempo de ejecución el alias por el nombre del usuarioo grupo real que se ajusta a la categoría en ese momento y lugar. El uso de alias en las definiciones deactividad crea una plantilla de proceso flexible que se puede usar en distintas situaciones.

Supongamos, por ejemplo, que desea crear un flujo de trabajo para las solicitudes de vacaciones. Cadadepartamento de la compañía tiene un director diferente que debe aprobar las vacaciones. En lugarde crear una plantilla de proceso diferente para cada departamento, desea crear una plantilla comúnpara todos. Después de todo, el proceso comercial es el mismo en todos los departamentos. En lugarde usar nombres de ejecutantes específicos para las actividades, usa un alias, por ejemplo, Director.Cuando se ejecuta el flujo de trabajo, el servidor responde a la pregunta "¿Quién es el director deliniciador del flujo de trabajo?" y envía un elemento de trabajo a ese usuario.

El servidor resuelve los alias en tiempo de ejecución buscando en uno o varios conjuntos de alias hastalocalizar el alias y su valor real asociado. Un conjunto de alias es un objeto que define una lista de aliasy sus valores reales correspondientes. Puede crear conjuntos de alias en Documentum Administrator.El manual Documentum Administrator Guide proporciona información detallada sobre los conjuntosde alias. Puede asociar conjuntos de alias a usuarios concretos y, en Process Builder, identificar unconjunto de alias predeterminado para el flujo de trabajo.

Al incluir un alias como ejecutante para una actividad, puede especificar que el servidor resuelva elalias en tiempo de ejecución haciendo referencia a lo siguiente:

• Conjunto de alias predeterminado para el flujo de trabajo

• El conjunto de alias asociado al usuario que inicia el flujo de trabajo



• El conjunto de alias para el ejecutante de una actividad anterior

• Cualquier otro conjunto de alias que elija

También puede hacer que el servidor exija al iniciador del flujo de trabajo que proporcionemanualmente los valores de los alias cuando se inicia el flujo de trabajo. Para requerir al iniciador delflujo de trabajo resuelva los alias, hay que definir un conjunto de alias predeterminado para que laplantilla de proceso que contiene los alias pero no los nombres a los que se asignan los alias. ConsulteElegir ejecutantes manuales, página 108 si necesita información detallada.

Permitir la delegación y la extensión

Cuando se crea una actividad manual, se especifica si el usuario que va a realizar la actividad puededelegarla en otro ejecutante o extender la actividad identificando a un ejecutante adicional.

Con la delegación, el ejecutante original no completa la actividad. Con la extensión, en cambio, tantoel ejecutante original como el ejecutante adicional designado completan la actividad.

Cuando se permite la delegación, ésta puede ser automática o manual.

• La delegación automática tiene lugar cuando el servidor comprueba la disponibilidad del ejecutanteo los ejecutantes de una actividad y determina si no están disponibles. Cuando esto ocurre, elservidor delega automáticamente el trabajo en los usuarios que el ejecutante original designó en elcuadro de diálogo Disponibilidad para flujo de trabajo. Si no hay ningún usuario identificado,o dicho usuario no está disponible, el elemento de trabajo se vuelve a asignar al supervisor delflujo de trabajo o se devuelve al ejecutante original, dependiendo de una opción de configuraciónestablecida cuando se designó la actividad.

Para permitir que el ejecutante pase la tarea a otro usuario o grupo, marque Delegar el trabajo de laactividad en otra persona. Cuando seleccione esta opción, también deberá especificar dónde seenviará la tarea si no está disponible el usuario en el que el ejecutante la delega.

El indicador de sistema autodelegación en cascada controla la delegación cuando el delegado delejecutante inicial no está disponible. Cuando la autodelegación en cascada está activada, el sistemaenvía la tarea a través de una cadena de delegados hasta que encuentra un ejecutante disponible.Si el sistema no encuentra ningún ejecutante disponible, delegará la tarea en el supervisor delflujo de trabajo.

El atributo max_auto_delegate determina la longitud de la cadena de delegados. El valor mínimode este atributo es 1 y el valor máximo es 5. Por ejemplo, si el valor establecido es 3 y el sistemano encuentra un ejecutante en los tres primeros delegados, el sistema asume que la delegaciónha fallado. A continuación, asigna la tarea al ejecutante original o al supervisor basándose en laconfiguración de la actividad. La Guía del usuario de Documentum Administrator proporciona másinformación sobre cómo configurar esta opción.

• La delegación manual tiene lugar cuando el ejecutante del elemento de trabajo, el supervisor delflujo de trabajo o un superusuario decide delegar el elemento de trabajo.

Si se permite la extensión, cuando los ejecutantes originales completan los elementos de trabajo deuna actividad, pueden identificar una segunda ronda de ejecutantes de dicha actividad. El servidorgenera nuevos elementos de trabajo para la segunda ronda de ejecutantes. Sólo cuando la segundaronda de ejecutantes haya realizado el trabajo, podrá evaluar el servidor la condición de transición dela actividad y pasar a la siguiente. La segunda ronda de ejecutantes no puede ampliar más la actividad.



Consulte Seleccionar ejecutantes, página 106 si necesita más información sobre cómo definir estasopciones.

Definir asuntos de tareasUn asunto de tarea es un mensaje que proporciona al ejecutante de un elemento de trabajo informaciónsobre ese elemento. El mensaje forma parte de la definición de actividad. Puede incluir referencias auno o varios atributos cuyos valores son sustituidos por el servidor en tiempo de ejecución. Porejemplo, supongamos que el asunto de tarea se define como:

Please work on the {dmi_queue_item.task_name} task (from activity number{dmi_queue_item.r_act_seqno})of the workflow {dmi_workflow.object_name}.The attached package is {dmi_package.r_component_name}.

Supongamos que task_name es "Revisar", r_act_seqno es 2, object_name es "Propuesta Ingr" yr_package_name es "Primer borrador"; en tiempo de ejecución, el usuario ve:

Please work on the Review task (from activity number 2) of theworkflow Engr Proposal. The attached package is First Draft.

Los asuntos de tarea pueden tener hasta 255 caracteres (antes de que se resuelvan las referenciasde variables) y contener variables de proceso, parámetros de proceso y referencias a los siguientestipos de objeto y atributos:

• Cualquier atributo del objeto dm_workflow

• Cualquier atributo del objeto dmi_workitem asociado a la tarea actual

• Cualquier atributo del objeto dmi_queue_item asociado a la tarea actual, excepto para task_subject

• Cualquier atributo de un objeto dmi_package

Nota: El nombre del documento en un paquete sólo está disponible si se selecciona la opciónAlmacenar el nombre de documento en el paquete en el tiempo de ejecución en el cuadrode diálogo Propiedades de proceso.

La referencia se debe incluir entre llaves. Los nombres de atributo y de tipo de objeto deben apareceren minúsculas y separados por un punto.

El servidor utiliza las siguientes reglas al resolver la cadena:

• El servidor no inserta comillas al principio y final del tipo de objeto resuelto y las referenciasde atributo.

• Si el atributo al que se hace referencia es un atributo que se repite, el servidor sustituye todoslos valores y los separa por comas.

• Si la cadena que se crea (una vez se han resuelto las variables) es superior a 512 caracteres, elservidor trunca la cadena.

• Si un tipo de objeto y una referencia de atributo contienen un error. Por ejemplo, si el tipo deobjeto o el atributo no existe, el servidor no resuelve la referencia. Un error de referencia sinresolver se muestra en el mensaje.

La cadena resuelta se almacena en el atributo task_subject del objeto de elemento de cola asociado dela tarea. Una vez que el servidor ha creado el elemento de trabajo, no se cambiará el valor del atributotask_subject en el elemento de cola aunque cambien los valores en cualquiera de los atributos dereferencia.



Agregar un requisito de firmaMuchos procesos comerciales exigen cierto grado de responsabilidad. Una forma de proporcionarla esobligar a los ejecutantes a firmar las tareas que ejecutan. Al definir una actividad manual en ProcessBuilder, puede especificar que sea obligatorio que los ejecutantes firmen para poder completar laactividad. La firma requiere que el ejecutante escriba su contraseña para confirmar que ha ejecutado latarea.

Nota: Content Server también admite firmas electrónicas y digitales como modo de firmar tareas olos documentos asociados a una tarea. Consulte la documentación de Content Server si necesita másinformación sobre estas opciones de aprobación avanzadas.

Definir valores de prioridadEn las actividades automáticas, debe indicar un valor de prioridad que determina el orden en el queel servidor ejecuta la actividad con respecto a otras acciones de la cola. Asimismo, también puededefinir un valor de prioridad para las actividades manuales, que se refleja en la lista de tareas que seencuentran en la bandeja de entrada del ejecutante. La bandeja de entrada es una área específica delusuario que muestra las tareas actualmente asignadas al ejecutante.

Al iniciar una actividad automática, ésta se coloca en la cola de ejecución de una función del servidorque se ejecuta de forma periódica. Esta función ejecuta las actividades en orden de prioridad. De formapredeterminada, ejecuta todas las actividades automáticas en cola cada vez que se activa, aunque unadministrador de sistema puede limitar el número de actividades gestionadas cada vez que se ejecutala función. Si el valor de configuración del servidor max_wf_jobs se define como un número bajo yhay un gran número de actividades en cola con prioridad alta, puede que una actividad de prioridadbaja tenga que esperar varias activaciones hasta que se ejecute.

Consulte Definir propiedades de actividades, página 105 si precisa información sobre cómo definir laprioridad de una actividad.

Definición de de la prioridad inicial y antigüedad de tareasEn la mayoría de los procesadores de la cola, los elementos de trabajo aparecen en la bandeja deentrada según su prioridad. Los elementos de máxima prioridad se asignan para que se trabaje en ellosantes que en los elementos de trabajo de prioridad inferior. Los valores de prioridad y antigüedad sonelementos esenciales a la hora de procesar tareas de colas de trabajos. Cuando el sistema crea un nuevoelemento de trabajo, el servidor identifica la tarea como un elemento de cola de trabajos y comprueba lalógica que permite asignar una prioridad inicial al elemento. Después de que la tarea esté en la cola, untrabajo de caducidad aumenta la prioridad de la tarea en función de otra lógica, que sube la tarea en labandeja de entrada hasta que sea la tarea en la que se trabaja. El aumento de la prioridad puede provocarque el administrador de la cola redistribuya las tareas o reasigne recursos entre las colas de trabajos.

El nivel de prioridad que tiene inicialmente una tarea y la velocidad con la que aumenta la prioridad sepueden definir en la política de la cola de trabajos o en la plantilla de actividad de la tarea. Medianteuna política de cola de trabajos, el administrador de la cola o el gestor de colas puede especificar laprioridad inicial de la tarea y la frecuencia y porcentaje en los que se incrementa en función de valoresdiferentes definidos en la política.

Para escenarios de inicialización y clasificación por antigüedad más complejos, puede utilizarDocumentum Composer para crear un módulo de prioridad que contenga la lógica para calcular



y actualizar dinámicamente la prioridad en función de los datos de proceso u otros atributospertenecientes al proceso. Un módulo de prioridad puede estar asociado a una política de cola detrabajos o a una actividad de Process Builder.

Cómo resuelve el sistema la prioridad inicial de una tarea

Cuando el sistema crea una tarea de la cola de trabajos, Process Engine determina la prioridad inicialde la tarea utilizando los criterios siguientes en este orden:

1. Módulo de prioridad asociado a la definición de actividad: si hay un módulo de prioridadasociado a la definición de actividad, el sistema utiliza el método getInitialPriority() del módulo yestablece el valor de devolución como prioridad inicial.

2. Módulo de prioridad asociado a la política de cola de trabajos: si hay un módulo de prioridadasociado a la política de cola de trabajos, el sistema utiliza el método getInitialPriority() del móduloy establece el valor de devolución como prioridad inicial.

3. Política de cola de trabajos: si no hay ningún módulo de prioridad asociado a la tarea, el sistemautiliza el parámetro initial_priority del objeto de política de cola de trabajos para establecersu prioridad inicial.

Cómo aumenta el sistema la prioridad de una tarea

Cada vez que se ejecuta el trabajo de dm_QmPriorityAging, aumenta la prioridad de todas las tareas dela cola de trabajos utilizando los siguientes criterios en este orden:

1. Módulo de prioridad asociado a la definición de actividad: si hay un módulo de prioridadasociado a la definición de actividad, el sistema utiliza el método getIncrementPriority() del móduloy utiliza el valor de devolución como prioridad de incremento.

2. Módulo de prioridad asociado a la política de cola de trabajos: si hay un módulo de prioridadasociado a la política de cola de trabajos, el sistema utiliza el método getIncrementPriority() delmódulo y utiliza el valor de devolución como prioridad de incremento.

3. Política de cola de trabajos: si no hay ningún módulo de prioridad asociado a la tarea, el sistemautiliza el parámetro increment_priority del objeto de política de cola de trabajos para establecerla prioridad de incremento.

Establecimiento de la prioridad estática y de la lógica decaducidad para tareas

Las políticas de cola de trabajos permiten a los administradores o gestores de la cola definir lafrecuencia en la que se caducan las tareas de una cola de trabajos y la prioridad en la que estánestablecidas inicialmente.

Cuando el sistema crea una tarea de la cola de trabajos, la prioridad inicial de la tarea se estableceen función de la configuración de prioridad inicial de la política de cola de trabajos asociadaa esa tarea. Mientras que la tarea permanezca en la cola, cada vez que se ejecuta el trabajo dedm_QmPriorityAging, aumenta la prioridad de la tarea en la cantidad especificada en la configuraciónde prioridad de incremento de la política de cola de trabajos asociada a la tarea. La guía DocumentumWebtop User Guide proporciona más información sobre cómo establecer la prioridad y la lógica decaducidad para las tareas en función de las políticas de cola de trabajos.



Establecimiento de la prioridad dinámica y de la lógica decaducidad para tareasPuede haber situaciones en las que tanto la prioridad inicial como la cantidad de incremento de laprioridad deban calcularse dinámicamente. En estos casos, se crea un módulo de prioridad que utilizael sistema en lugar de la política de cola de trabajos para establecer la lógica de clasificación porprioridad y antigüedad. Se puede seleccionar un módulo de prioridad al crear la cola de trabajos enWebtop o TaskSpace o se puede seleccionar al crear la actividad en Process Builder.

Asociar un módulo de prioridad de colas de trabajo a una actividad, página 108 proporcionainformación detallada sobre cómo asignar un módulo de prioridad a una actividad.

Los datos de proceso se pueden utilizar para establecer la prioridad inicial y aumentarla en funciónde valores del flujo de trabajo. Por ejemplo, cuando una aplicación de préstamos perteneciente a uncliente preferente pasa por una cola de trabajos, se le puede asignar inmediatamente un valor deprioridad más alto que una aplicación de préstamos de otros clientes. Además, si la solicitud delpréstamo es para una cantidad mayor o proviene de un agente de préstamos preferente, la prioridadpuede aumentar a mayor velocidad para asegurarse de que el supervisor de la cola recibe una alerta sila tarea no se completa dentro de un período de tiempo especificado. Este tipo de lógica puede resultarespecialmente útil para aumentar la prioridad de una tarea cuando se acerca a una fecha límite o algunaotra restricción horaria. La prioridad aumenta más rápidamente a medida que se acerca la fecha límite,subiendo la tarea en la cola a una velocidad superior.

Para establecer la prioridad y los valores de caducidad:

1. Cree un módulo de prioridad que incluya una clase Java para las interfaces IWQTaskPriority eIDfModule.La interfaz IWQTaskPriority tiene dos métodos:

int getInitialPriority(IDfSession session, IDfWorkitemEx witem)throws DfException;

int getIncrementPriority(IDfSession session, IDfWorkitemEx witem)throws DfException;

La interfaz IDfModule no tiene ningún método.La guía del usuario de Documentum Composer proporciona información detallada sobre cómogenerar un módulo.

2. Mediante Composer, cree un módulo que utilice la clase que creó en el paso 1.Asegúrese de que incluye bpm_infra.jar y dfc.jar en la ruta de acceso de clase de cliente.

Módulo de prioridad de ejemplo

/** Copyright 1994-2008. EMC Corporation. All Rights Reserved.*/

package com.documentum.bpm.priority.test;



import com.documentum.bpm.IDfWorkitemEx;import com.documentum.bpm.priority.IWQTaskPriority;import com.documentum.fc.client.IDfModule;import com.documentum.fc.client.IDfSession;import com.documentum.fc.common.DfException;

public class SamplePriorityModule2 implements IWQTaskPriority, IDfModule {

/*** This example calculates priority from Process Data Variables.* There are two Process Data Variables defined on the workflow template:* - is_vip (boolean)* - loan_info* -loan_amount (int)* - broker_class (String)*/

public int getInitialPriority(IDfSession session,IDfWorkitemEx witem) throws DfException

{//// If is_vip == true// initial_priority = 10// Else// initial_priority = loan_info.loan_amount / 1000//

Boolean is_vip = (Boolean) witem.getPrimitiveVariableValue("is_vip");if (is_vip.booleanValue() )

return 10;else {

Integer loan_amount = (Integer)witem.getStructuredDataTypeAttrValue("loan_info", "loan_amount");

return (loan_amount.intValue() / 1000);}

}

public int getIncrementPriority(IDfSession session,IDfWorkitemEx witem) throws DfException

{//// If loan_info.broker_class = "A"// increment_priority = 10// Elseif loan_info.broker_class = "B"// increment_priority = 5// Else// increment_priority = 0//

String broker_class = (String) witem.getStructuredDataTypeAttrValue("loan_info", "broker_class");

if (broker_class.equalsIgnoreCase("A"))return 10;



if (broker_class.equalsIgnoreCase("B"))return 5;

elsereturn 0;

}}

Introducción a los datos de procesoAl definir un proceso comercial, los datos que se van a manejar en el flujo deben estar representadosde una forma significativa. Los datos de un flujo pueden ser variables de flujos de trabajo, variablesde proceso o paquetes asociados con el flujo.

Los datos de proceso son los distintos tipos de datos que fluyen por el proceso, como un documento,un formulario o variables de proceso, como números de pieza o direcciones de clientes. Existen dostipos principales de datos de proceso que se pueden definir en un proceso: datos de paquete y variablesde proceso. Ambos tipos de datos se deben definir en el nivel del proceso para que se puedan utilizaren cualquier actividad individual de dicho proceso.

Introducción a los paquetesLos paquetes son los objetos sobre los que las actividades realizan su trabajo. Un paquete puede serun documento, formulario o cualquier otro dato asociado con una actividad. Todos los paquetesgestionados por un objeto de proceso se muestran como parte de las propiedades del proceso. Acontinuación, se especifican los paquetes con los que trabaja cada actividad. Una actividad puedegestionar varios paquetes. Cada paquete puede tener una plantilla de formulario asociada, que define lainterfaz de usuario que los ejecutantes de la actividad ven al trabajar en el paquete.

Al definir un proceso comercial, debe identificar qué objetos controla el flujo de trabajo. Los objetosprocesados por un flujo de trabajo (como los documentos o las imágenes) se denominan paquetes. Elpaquete representa el contenido con el que trabaja la actividad. Una actividad puede funcionar conuno o más paquetes.

Para definir un paquete, debe identificar el elemento que se procesará con el flujo de trabajo. Tambiéntiene la opción de elegir un formulario que utilizará, para realizar la tarea, el ejecutante de la actividadque esté trabajando con el paquete.

Una actividad puede hacer lo siguiente con un paquete:

• No realizar ningún cambio en el paquete.• Modificar el paquete y guardarlo como una nueva versión en el repositorio.• Introducir un nuevo paquete en el flujo de trabajo, sin reenviar el paquete que recibió.• Modificar un atributo asociado al paquete.En muchos flujos de trabajo, todas las actividades funcionan en los mismos paquetes. Por ejemplo,un flujo de trabajo diseñado para la revisión y aprobación de órdenes de compra utilizará el mismodocumento de orden de compra como paquete para todas las actividades necesarias.

En otros casos, sin embargo, el trabajo que realiza una actividad da lugar a una versión nueva de undocumento a partir del paquete entrante. Por ejemplo, un usuario podría recibir un documento para que



lo revise. El usuario retira el documento, le agrega comentarios o revisiones y lo registra. En estecaso, se desea que la actividad envíe una nueva versión del componente cuando envíe el paquete ala siguiente actividad. En Process Builder, puede realizar este escenario configurando la actividadpara reenviar los mismos paquetes que recibe, aunque con una versión diferente. Para especificar laversión, puede usar el número de versión propiamente dicho, como 2.5, o una etiqueta de versiónsimbólica, como Borrador o ACTUAL.

El trabajo que se realiza en ciertas actividades requiere el envío por parte de éstas de un paquetecompletamente diferente al paquete recibido. Supongamos, por ejemplo, que una actividad acepta unaviso de acción de personal. El ejecutante (un empleado de recursos humanos) debe archivar el aviso yenviar un formulario diferente al departamento de contabilidad. En Process Builder, puede configuraruna actividad para aceptar determinados paquetes como entradas y enviar otros paquetes como salidas.

Si necesita más información sobre la configuración de flujos y paquetes en Process Builder, consulteCambiar datos de proceso en una actividad, página 134.

Introducción a las variables de procesoLas variables de proceso son distintos tipos de datos que circulan por el proceso comercial. Puedetratarse de tipos de datos simples (una cadena, un valor booleano o una fecha) o complejos, es decir,grupos de datos relacionados lógicamente como pedidos, componentes de fabricación, etc. Los tiposde datos complejos se definen en la ventana Structured Data Type (Tipo de datos estructurado), donde,como tipos de datos estructurados, pueden reutilizarse en varias plantillas de proceso en un repositorio.

Los valores predeterminados solo se pueden establecer en un tipo de datos simple. Los tipos de datoscomplejos tienen los valores predeterminados en la definición de tipo.

Los atributos de tipos de datos estructurados pueden identificarse para su utilización en la generaciónde informes. El motor del proceso expone los elementos para que las herramientas generadoras deinformes puedan utilizarlos y crear tanto informes estáticos como de BAM. Las variables de proceso sedefinen para un proceso mediante el componente Propiedades de proceso.

Gestionar las variables de proceso, página 67 proporciona más información sobre cómo definirvariables de proceso para un flujo de trabajo. Crear tipos de datos estructurados, página 47 proporcionamás información sobre cómo definir los tipos de datos estructurados para su repositorio.

Introducción a los parámetros de procesoLos parámetros de proceso permiten a los administradores de la aplicación utilizar la fichaAdministration de TaskSpace para modificar valores constantes que se utilizan a lo largo de unproceso. Los parámetros de proceso se pueden utilizar en umbrales, fechas límite, roles de escaladoy otros valores fijos durante un proceso. Cuando el administrador cambia los valores del parámetroen la ficha Administration, cualquier instancia de proceso nueva o que se esté ejecutando utilizael valor actualizado.

Los parámetros de proceso pueden tipos de datos simples (cadena, booleano, entero, flotante o fecha)y se definen dentro de la plantilla de proceso y son específicos a esa plantilla. A diferencia de lasvariables de proceso, los parámetros de proceso no se pueden compartir ni reutilizar en varias plantillasde proceso en un repositorio.

Por ejemplo, un administrador de la aplicación puede necesitar realizar cambios en los valoresdel ejecutante para responder a los distintos requisitos comerciales. El diseñador de procesos crea



una plantilla de proceso que incluye un parámetro de proceso approver1 y crea un valor constantemanager. Una vez completado e instalado el proceso, el administrador de la aplicación puede abrir laplantilla de proceso en la ficha Administración de TaskSpace y utilizar el formulario de parámetro deproceso asociado para cambiar el valor de approver1 de manager a otro ejecutante. Todos los flujos detrabajo nuevos utilizarán el valor actualizado.

Los parámetros de proceso también se pueden utilizar en asignaciones como datos de proceso desde ellado de origen (izquierda) del asignador de datos. El diseñador de proceso puede crear una asignaciónpara cambiar el destinatario para una notificación por correo electrónico creando el recipient2 delparámetro de proceso con un valor de [email protected]. El parámetro de procesoaparece en el lado de origen del asignador de datos en la plantilla de actividad y está disponible parala asignación. Después, una vez el proceso está instalado y ejecutándose, el administrador de laaplicación puede abrir el proceso y cambiar el destinatario del correo electrónico escribiendo un nuevovalor en el formulario del parámetro de proceso.

Gestionar parámetros de proceso, página 68 proporciona más información sobre cómo definirparámetros de proceso en Process Builder.

Asociar plantillas de formulario con paquetesPuede asociar una plantilla de formulario con cada paquete que pasa a una actividad manual. Estaplantilla proporciona una interfaz de usuario personalizada al ejecutante que ve e introduce losdatos. Dependiendo de las opciones de configuración, el ejecutante puede consultar el formulario enlas siguientes circunstancias:

• Un usuario abre el paquete desde la bandeja de entrada de Documentum

• Al ver las propiedades del paquete

El ejecutante rellena el formulario para completar la actividad o actualizar las propiedades delpaquete. Si la actividad recibe más de un paquete, el ejecutante rellena los formularios asociados acada paquete. Si un paquete no tiene un formulario asociado, el ejecutante ve un cuadro de diálogopredeterminado de Task Manager.

Se puede asociar una plantilla de formulario a cada paquete cada vez que los agrega al flujo de trabajo,tal y como se describe en Gestionar los paquetes, página 65. También puede asociar una plantillade formulario a un paquete al configurar una actividad manual. Un paquete puede tener sólo unformulario asociado a la vez, pero este formulario podrá cambiar a medida que el paquete pase a travésdel flujo de trabajo. Por ejemplo, el formulario que se muestra a un administrador que aprueba unasolicitud de compra podría ser diferente al que cumplimenta la persona que interpone la solicitud. Losdatos subyacentes de los dos formularios son los mismos, pero la forma de mostrarlos varía en funcióndel usuario. Al configurar una solicitud, puede establecer la plantilla de formulario utilizada para esaactividad de forma que sea diferente a la asociada con el paquete a nivel de proceso comercial.

Para asociar una plantilla de formulario con un paquete, ambos deberán tener el mismo modelo de datossubyacente. Cuando selecciona formularios, Process Builder sólo muestra las plantillas de formulariocuyo modelo de datos coincide con el tipo de datos seleccionado para el paquete. Si selecciona laplantilla de formulario antes de establecer el tipo de objeto del paquete, Process Builder establece eltipo de objeto para que coincida con el modelo de datos de la plantilla de formulario seleccionado.

Si necesita más información sobre los formularios y las plantillas de formularios, consulte la guíaDocumentum Forms Builder User Guide.



Definir condiciones de desencadenamiento

Un desencadenador es una señal que indica que la actividad puede empezar. Las condiciones dedesencadenamiento definen los criterios de inicio de una actividad determinada. En tiempo deejecución, el servidor no inicia una actividad hasta que se cumpla la condición de desencadenamientode la misma. Esta condición puede incluir de forma opcional un evento de desencadenamiento quedebe tener lugar para que la actividad se inicie.

Si la actividad presenta varios flujos entrantes, puede especificar el número de las actividades anterioresque se deben haber completado antes de que se inicie la actividad. La condición de desencadenamientoes el número mínimo de flujos que deben haber entregado paquetes a la actividad para que ésta seinicie. Por ejemplo, si una actividad presenta tres flujos entrantes, puede especificar que la actividad seinicie cuando dos de los tres flujos hayan entregado sus paquetes. La condición de desencadenamientodebe tener un valor entre 1 y el número total de flujos entrantes.

Un evento de desencadenamiento es un evento en cola del flujo de trabajo. Puede tratarse de unevento definido por el sistema, como dm_checkin, o se puede inventar un nombre de evento, como"promovido" o "presentado". Sin embargo, debido a que no es posible registrar un flujo de trabajopara que reciba notificaciones de eventos, el evento se debe situar de forma explícita en la cola delflujo de trabajo usando la API de Documentum. Si incluye un evento de desencadenamiento en lacondición de inicio, el servidor debe encontrar el evento identificado en la cola del flujo de trabajopara que se inicie la actividad. El mismo evento se puede usar como desencadenador de variasactividades, aunque la aplicación deberá poner el evento en cola para cada una de ellas. Consulte elmanual Documentum Content Server Fundamentals para obtener más información sobre cómo definiry poner eventos en cola.

Si necesita más información sobre cómo definir las condiciones de desencadenamiento de lasactividades, consulte Definir desencadenadores de actividades, página 119.

Definir temporizadores

Al configurar una actividad, puede definir temporizadores que se activen si el trabajo no parece fluircomo debiera. Por ejemplo, puede especificar que el supervisor del flujo de trabajo reciba un mensajede advertencia si la actividad no se inicia en un período de 12 horas después del inicio del flujo detrabajo, o enviar un mensaje al ejecutante de la actividad si ésta no se ha completado transcurridascuatro horas desde su inicio.

Process Builder admite dos tipos de temporizadores de advertencia en las actividades:

• Un pre-temporizador se pone en funcionamiento si una actividad no se ha iniciado dentro de unperíodo de tiempo especificado tras el inicio del flujo de trabajo.

• Un post-temporizador se pone en funcionamiento si una actividad no ha terminado dentro de unperíodo de tiempo especificado tras el inicio de la actividad.

Los administradores pueden modificar ambos temporizadores en Documentum TaskSpace. Si hayvarios temporizadores para una tarea, el sistema emplea el primero de ellos como fecha de vencimientoen TaskSpace. El sistema utiliza la fecha de vencimiento para calcular las tareas atrasadas enTaskSpace. En la Guía de configuración de Documentum TaskSpace se proporciona informacióndetallada sobre el cambio de los temporizadores en la ficha Administración de TaskSpace.



Cuando se inicia un flujo de trabajo, el sistema crea pre-temporizadores para todas las actividades quetienen pre-temporizadores configurados. Al mismo tiempo, el sistema crea la tarea para la primeraactividad del flujo de trabajo. Si se trata de una actividad automática, el agente de flujo de trabajoprocesa la tarea inmediatamente y mueve el flujo de trabajo a la segunda actividad. Cuando sedesencadena la segunda actividad, el servidor desactiva el pre-temporizador.

Dependiendo de la naturaleza de la actividad, un temporizador caducado puede realizar alguna deestas acciones:

• Notificación: enviar un mensaje de notificación a una o varias personas.

• Iniciar proceso: iniciar un nuevo proceso de flujo de trabajo usando los paquetes de la actividadactual.

• Ejecutar en método Java: ejecutar un método de flujo de trabajo automatizado (solo disponiblepara usuarios con privilegios de superusuario).

• Delegar tarea: delegar la tarea en otro ejecutante.

• Completar tarea: completar automáticamente una tarea manual y mover el flujo de trabajo ala siguiente actividad.

Las dos primeras acciones están disponibles para cualquier temporizador de actividad. Todos lostemporizadores pueden invocar un método siempre que el ejecutante de la actividad tenga losprivilegios de superusuario necesarios. Las acciones Delegar tarea y Completar tarea sólo estándisponibles como acciones de post-temporizador para actividades manuales que gestionan un únicoelemento de trabajo.

Cuando un temporizador completa una tarea, tiene la opción de definir el valor de un atributo en unade las variables de proceso o los paquetes del flujo de trabajo. Las condiciones de transición para laactividad se pueden comprobar para este valor y dependiendo de los atributos de un paquete o de lasvariables de proceso, puede procesarse el flujo de manera diferente.

Una actividad puede tener varios temporizadores. Asimismo, puede indicar al servidor que realice laúltima acción de temporizador repetidamente a un intervalo especificado hasta completar la actividad.

De forma predeterminada, los usuarios reciben notificaciones de advertencia en forma de elementosen la cola de la bandeja de entrada. No obstante, puede configurar el temporizador para enviar unanotificación por correo electrónico mediante una plantilla de correo electrónico personalizada.

Consulte Establecer temporizadores de advertencia, página 120 para obtener más información.

Nota: No se detienen los post-temporizadores cuando una tarea se detiene o se suspende y continuarácontando el tiempo. Por ejemplo, cuando se detiene una tarea de flujo de trabajo, no se detiene elpost-temporizador asociado. El post-temporizador continúa teniendo en cuenta el tiempo designadopara la tarea como si la tarea estuviera todavía en curso.

La tarea de verificar los temporizadores de advertencia y de realizar las acciones requeridas la realizala función de administración del sistema dm_WfmsTimer. El trabajo dm_WfmsTimer se instala conContent Server y se activa al instalar Process Engine.

Cuando está activo, la configuración predeterminada es que el trabajo se ejecute una vez cada hora.Para cambiar la frecuencia de ejecución del trabajo, utilice Documentum Administrator. Tambiénpuede cambiar el número de subprocesos que el sistema puede emplear para procesar temporizadores.Consulte la Guía del administrador de Documentum para obtener más información sobre el cambiode la configuración de trabajos y del número de subprocesos de trabajador utilizados por el trabajode temporizador.



Configurar notificacionesContent Server tiene la capacidad de controlar eventos particulares y notificar a los usuarios interesadoscuando se produzcan. Los eventos son acciones concretas aplicadas a los objetos de Documentum.En el contexto de Process Builder, los eventos pertinentes son acciones relacionadas con el flujo detrabajo, como un usuario iniciando el trabajo en un elemento de trabajo o delegando un elementode trabajo en otro usuario.

Al configurar una plantilla de proceso o una actividad, podrá asociar plantillas de mensaje de correoelectrónico personalizadas con varios eventos clave relacionados con el flujo de trabajo. Una plantillade correo electrónico es un documento con un formato especial almacenado en el repositorio deDocumentum que define el asunto y cuerpo de un mensaje de notificación por correo electrónico. Laplantilla puede incluir variables cuyos valores reemplaza el servidor en el tiempo de ejecución. Elmensaje entregado incluye información contextual, como el nombre del ejecutante actual o el paqueteque se enruta. Si un evento tiene asociada una plantilla de este tipo, cualquier usuario que se hayaregistrado para recibir notificación del evento obtendrá un mensaje generado a partir de la plantillade correo asociada. La guía Documentum Process Builder Development Guide proporciona másinformación sobre cómo crear plantillas de correo electrónico personalizadas.

Nota: El servidor genera y envía mensajes de notificación únicamente cuando uno o varios usuariosse han registrado para recibir notificación del evento. El manual Documentum Content ServerFundamentals proporciona información sobre cómo registrarse para las notificaciones de eventos.

Consulte Definir notificaciones, página 130 si necesita más información sobre cómo definir opcionesde notificación.

Definir transiciones de actividadSi una actividad presenta varios flujos salientes, tal vez desee que se envíen paquetes a todas lasactividades siguientes o sólo a determinadas actividades en función del resultado de la actividad. Porejemplo, podría ofrecer a un ejecutante que revisara el diseño de un nuevo formulario la opción dereenviar el diseño al siguiente revisor o devolverlo al diseñador para que lo corrija. Esta lógica deramificaciones se configura creando flujos desde la actividad a las dos posibles actividades siguientes ypermitiendo al ejecutante elegir la ruta que desea seguir.

El tipo de transición de una actividad define el modo en el que se seleccionan las actividades siguientescuando se completa la actividad. Existen tres tipos de transiciones:

• Seleccionar todas las actividades conectadas: el flujo continúa para todas las actividadessiguientes enlazadas a esta actividad, incluyendo flujos de avance y de rechazo.

• Permitir al ejecutante seleccionar las siguientes actividades: el ejecutante de la actividad eligelas actividades a las que desea enviar paquetes en tiempo de ejecución.

• Seleccionar las siguientes actividades basadas en condiciones: las actividades que recibenpaquetes o variables de proceso se determinan en tiempo de ejecución evaluando un conjunto decondiciones de transición que se basan en los datos de proceso existentes en la actividad.

Si la actividad es una actividad de grupo, es decir, si la categoría del ejecutante es 4 (Todos los usuariosdel grupo) u 8 (Algunos usuarios de un grupo), puede especificar cuántos miembros del grupo debencompletar la tarea antes de que el servidor considere la actividad general como completada y reenvíelos paquetes a las siguientes actividades. Por ejemplo, si cinco usuarios reciben un elemento de trabajo



para una actividad, puede especificar que la actividad esté completada cuando tres usuarios hayanterminado. También puede hacer que sea necesario que los cinco usuarios terminen la tarea.

Si deja que los ejecutantes seleccionen las actividades siguientes, puede limitar el número deactividades que el ejecutante puede seleccionar. Por ejemplo, si una actividad tiene tres flujos salientes,puede permitir al ejecutante enviar paquetes a los tres, o bien puede exigir que el ejecutante sóloseleccione uno o dos.

Si permite que un grupo de ejecutantes seleccione las actividades siguientes, es decir, si la categoríadel ejecutante es 4 u 8 y la opción de transición es Permitir al ejecutante seleccionar las siguientesactividades, también debe informar al servidor acerca de cómo combinar las selecciones de losejecutantes. Cuando un grupo selecciona actividades, es posible que algunos ejecutantes seleccionenactividades de reenvío y que otros seleccionen actividades de rechazo. En ese caso, ¿qué actividadesdebería iniciar el motor del flujo de trabajo? ¿Todas las actividades seleccionadas, sólo las de rechazoo sólo las de reenvío? También puede decidir completar la actividad inmediatamente siempre que unejecutante seleccione una actividad de rechazo o de reenvío.

Si elige un tipo de transición condicional, debe definir al menos una condición de transición para laactividad.

Determinar las condiciones de transición

Las condiciones de transición permiten definir actividades que distribuyen tareas de forma diferenteen función de los resultados de la actividad. Una condición de transición es una condición lógicacon uno o varios flujos asociados. Cuando una actividad se completa en tiempo de ejecución, elservidor evalúa sus condiciones de transición para determinar las actividades que se han de iniciar acontinuación como el siguiente paso en el flujo de trabajo. El servidor mueve el flujo de trabajo hacialas actividades asociadas a la primera condición de transición que sea VERDADERO. Una actividadpuede presentar varias condiciones de transición, aunque el servidor solo selecciona una en tiempo deejecución: la primera que sea VERDADERO.

Las condiciones de transición deben ser expresiones booleanas. Las condiciones de transición seusan normalmente para verificar los atributos de los componentes del paquete, el flujo de trabajocontenedor o el último elemento de trabajo completado. Cuando el paquete de flujo de trabajo es undocumento XML, puede crear condiciones de transición que comprueben el valor de un elementoXML en el documento.

Al usar condiciones de transición, siempre se incluye una opción Else. Esta opción es la acción quetoma el servidor si ninguna condición de transición es aplicable. La opción Else no tiene asociadaninguna condición y solo puede aparecer una por actividad.

Si precisa información sobre la definición de las condiciones de transición de una actividad, consulteDefinir las reglas de transición de actividad, página 126.




Capítulo 2

Utilizar Process Builder


• Entorno de diseño de Process Builder

• Configurar la barra de herramientas de Process Builder

• Definir preferencias de la plantilla de proceso

• Ventana Plantillas de actividades

• Ventana Structured Data Types (Tipos de datos estructurados)

• Panel del editor de plantillas de proceso

• Utilizar la ficha Validación de procesos

• Utilizar el navegador de plantillas de proceso

Entorno de diseño de Process BuilderProcess Builder es una herramienta gráfica para diseñar y definir el proceso comercial. La ventana deProcess Builder está dividida en dos paneles principales:

• El panel izquierdo contiene el subsistema Navegador de recursos, el cual muestra plantillas deactividad, página 45 y tipos de datos estructurados, página 46 que se pueden agregar a la plantillade proceso.

• El panel izquierdo es el editor de plantillas de proceso, página 51, el cual muestra una representacióngráfica de las plantillas de proceso a medida que se crean.

Para controlar el tamaño de los dos paneles, coloque el cursor sobre el borde entre ellos y arrástreloa una nueva posición.

Aparece un par de flechas entre la parte superior de los paneles. Para expandir uno de ellos de modoque ocupe toda la ventana, haga clic en la flecha que apunta en sentido contrario al panel que deseaexpandir. Para que Process Builder recupere la vista de dos paneles, haga clic en la flecha que apuntaen el otro sentido, que ahora aparece en el borde de la ventana. También puede abrir varios procesosdel mismo repositorio en el editor de plantillas de proceso, permitiéndole ver y comparar los procesos.Ver varios procesos utilizando fichas, página 55 proporciona más información sobre este tema.

En Resource Navigator (Navegador de recursos), puede hacer clic en los botones de la barra de títuloque muestran el nombre de cada ventana secundaria para minimizar y restaurar las ventanas.

Se mostrará una barra de herramientas configurable en la parte superior de la ventana, que proporcionaacceso rápido a los comandos más habituales.

Si el flujo de trabajo es demasiado grande para mostrarse en la ventana, puede usar el navegador paraver toda la plantilla de proceso y especificar la parte que desea ver.



La figura siguiente muestra el entorno de diseño de Process Builder.

Figura 4 Process Builder

Configurar la barra de herramientas de ProcessBuilderPara elegir los iconos que desea que aparezcan en la barra de herramientas, use las opciones del menúVer. Process Builder proporciona tres conjuntos de iconos en la barra de herramientas:

• Iconos estándar que proporcionan acceso a los comandos desde los menús Archivo y Editar.• Iconos de flujo de trabajo que permiten crear actividades o flujos y mostrar las propiedades de losobjetos de flujos de trabajo.

• Iconos de vista que permiten acercar y alejar el panel del editor de plantillas de proceso.

De forma predeterminada, la barra de herramientas muestra los tres conjuntos de iconos.

Para seleccionar los iconos que aparecen en la barra de herramientas de Process Builder:

1. En el menú Ver, seleccione Barras de herramientas.

Aparece un submenú con el nombre de cada grupo de iconos de la barra de herramientasdisponible. Los grupos que se muestran en ese momento en dicha barra tienen una marca deverificación junto a su nombre.

2. Seleccione el grupo que desea agregar o quitar de la barra de herramientas.



Si selecciona una opción sin marca, ese grupo de iconos se agregará a la barra de herramientas.Si, por el contrario, selecciona una opción con marca, ésta desaparece y el grupo se quitará de labarra de herramientas.

Definir preferencias de la plantilla de procesoEl menú Preferencia incluye opciones que permiten:

• Compartir plantillas de proceso con Documentum Process Analyzer• Establecer el número de puerto que el sistema utiliza al depurar las actividades de entrada• Gestionar las carpetas de plantillas de actividades• Definir las preferencias de la plantilla de proceso• Actualizar datos de proceso en la base de datos de BAM

Permitir que Process Analyzer tenga acceso a lasplantillas de procesoUna vez que un proceso comercial se ha definido o modificado en Process Analyzer o Process Builder,el proceso se puede compartir con la otra aplicación como un archivo XML (en formato XPDL) que seguarda en una carpeta compartida. Cada aplicación puede acceder al archivo XML desde la carpetacompartida, abrirlo y comenzar a trabajar con el proceso. Definir ubicaciones de la carpeta compartirproceso, página 42 proporciona detalles sobre la configuración de carpetas compartidas.

Nota: Compartir procesos se habilita cuando Process Analyzer y Process Builder están instalados enel mismo equipo. Para compartir procesos cuando las aplicaciones no están instaladas en el mismoequipo, use las opciones para importar y exportar. Importar plantillas de proceso, página 81 y Exportarplantillas de proceso, página 82 proporcione más información sobre esas opciones.

Use Obtener proceso del analista para abrir un proceso en Process Builder, que se creó o modificóusando Process Analyzer. Use Compartir proceso con analista para hacer que un proceso de ProcessBuilder esté disponible para un analista usando Process Analyzer.

Los tipos de actividad automática y manual se mantienen durante el proceso de compartir, aunqueel desarrollador deberá agregar las definiciones como, por ejemplo, los métodos y temporizadores, aProcess Builder. En los procesos compartidos no se incluyen los paquetes.

Asimismo, si comparte un proceso que contenga varias actividades de finalización desde ProcessAnalyzer, Process Builder agregará una actividad vacía adicional a la que se conectarán todas lasactividades de finalización. (Process Builder admite sólo una actividad de finalización, mientras quelos procesos exportados desde Process Analyzer pueden contener varias actividades de finalización).

Compartir una plantilla de proceso con Process AnalyzerPara compartir una plantilla de proceso con Process Analyzer:

1. En el menú Archivo, seleccione Compartir proceso con analista.

El sistema coloca el archivo XPDL en la carpeta compartida de Process Builder, donde ProcessAnalyzer puede acceder a la plantilla de proceso.



2. Haga clic en Aceptar.

Obtener procesos de Process Analyzer

Para obtener un proceso de Process Analyzer:

1. En el menú Archivo, seleccione Obtener proceso del analista.

Aparece el cuadro de diálogo Obtener proceso del analista y muestra todos los archivos que estánen la carpeta compartida de Process Analyzer.

2. Seleccione el archivo XPDL que desea abrir.


Process Builder creará un nuevo borrador de plantilla de proceso basado en el proceso de BusinessProcess Analyzer.

Si la información de ubicación del diseño de la actividad está disponible, se aplica a la plantilla deproceso compartido. Por otra parte, el sistema utilizará el diseño predeterminado y la configuraciónde vista gráfica. Puesto que la información de interfaz de usuario, tal como gráficos o imágenes, nose incluye en los procesos compartidos, deberá volver a crearla en Process Builder.

A continuación, deberá definir la información de ejecución para el proceso que utiliza el Inspectorde actividades.

Consulte el Trabajar con plantillas de actividad, página 97 si necesita más información sobre cómodefinir los detalles de la ejecución para las actividades.

Definir ubicaciones de la carpeta compartir proceso

Cuando los procesos se comparten entre Process Builder y Process Analyzer, la ubicación de lascarpetas en las cuales se guardan los procesos se puede configurar desde cualquiera de las aplicaciones.

Para definir ubicaciones de la carpeta compartir proceso:

1. En el menú Archivo, seleccione Preferencias.

Aparecerá el cuadro de diálogo Preferencias.

2. Para definir la ubicación de la carpeta compartida para Process Analyzer, haga clic en Seleccionar.

Aparecerá el cuadro de diálogo Abrir.

3. Desplácese al directorio donde está instalado Documentum y cree una carpeta para los archivosXPDL de Process Analyzer (por ejemplo, PA_Shared).

Generalmente, es C:\Documentum.


5. Repita los pasos 2 a 4 para definir la carpeta compartida para los archivos XPDL de Process Builder.



Definir el número de puerto para la depuración deactividades entrantesPara poder depurar una actividad entrante en el depurador de proceso, debe especificar el númerode puerto en el cuadro de diálogo Preferencias.

Para definir el número de puerto de entrada:1. En el menú Archivo, seleccione Preferencias.

Aparecerá el cuadro de diálogo Preferencias.2. En el cuadro de diálogo HTTP/Número de puerto de entrada de WebService, seleccione el

número de puerto que el depurador utilizará para depurar actividades entrantes.

Gestionar las carpetas de plantillas de actividadesEl usuario controla las carpetas de plantillas que se mostrarán mediante el cuadro de diálogoPreferencias de Process Builder. Las preferencias que establece sólo se aplican a su identificador deusuario. Cada usuario puede establecer distintas preferencias. Si precisa información sobre la forma decontrolar qué carpetas de plantillas de actividades aparecen en la ventana Activity Templates (Plantillasde actividades), consulte Gestionar las plantillas de actividad dentro de las carpetas, página 98.

El cuadro de diálogo Preferencias también habilita la configuración de las ubicaciones de la carpetacompartir proceso si Process Analyzer y Process Builder están instalados en el mismo equipo.Compartir una plantilla de proceso con Process Analyzer, página 41 proporciona más informaciónsobre cómo establecer las ubicaciones de carpeta de uso compartido.

Para agregar una nueva carpeta de plantilla de actividades a la ventana Plantillas de actividades:1. Seleccione Archivo > Preferencias.

Aparecerá el cuadro de diálogo Preferencias. El cuadro de lista de la izquierda muestra lascarpetas disponibles, mientras que el de la derecha muestra las carpetas que se están visualizandoactualmente en Process Builder.

Nota: Las preferencias se guardan de forma independiente para cada usuario. La lista de carpetaspuede variar si inicia sesión como otro usuario.

2. Para agregar una nueva carpeta a la lista de carpetas disponibles, haga clic en Nuevo y escribaun nombre para la carpeta en el cuadro de diálogo que aparece.

La nueva carpeta se mostrará en el cuadro de lista de la derecha una vez que haga clic en Aceptaren el cuadro de diálogo.

3. Haga clic en Aceptar en el cuadro de diálogo Preferencias para agregar las carpetas del cuadro delista de la derecha a la ventana Plantillas de actividad.

Para quitar una carpeta de la ventana Plantillas de actividad:

1. Seleccione Archivo > Preferencias.Aparecerá el cuadro de diálogo Preferencias. El cuadro de lista de la izquierda muestra lascarpetas disponibles, mientras que el de la derecha muestra las carpetas que se están visualizandoactualmente en Process Builder.Nota: Las preferencias se guardan de forma independiente para cada usuario. La lista de carpetaspuede variar si inicia sesión como otro usuario.



2. Para quitar una carpeta de la ventana Plantillas de actividades, resalte el nombre de la misma en elcuadro de lista de la derecha y haga clic en << Quitar.El nombre se desplazará al cuadro de lista de la izquierda y desaparecerá de la ventana Plantillasde actividades.


Definir preferencias de mensajes de la plantilla deprocesoPuede especificar cuándo el sistema le pide que valide o instale plantillas después de guardarlas.

Para definir las preferencias de la plantilla de proceso:

1. Seleccione Archivo > Preferencias.

Aparece el cuadro de diálogo Preferencias.

Nota: Las preferencias se guardan de forma independiente para cada usuario.

2. Especifique si Process Builder ha de preguntar si se deben validar o instalar las plantillas alguardarlas.

Para poder utilizar una plantilla de proceso a fin de crear un flujo de trabajo que se está ejecutandoactualmente, se debe validar e instalar. Si activa la casilla de verificaciónMostrar siemprepreguntas de validación e instalación después de guardar, Process Builder le preguntará sidesea validar e instalar la plantilla cada vez que la guarde. Si no activa dicha casilla, no apareceránesas preguntas. Debe validar e instalar explícitamente la plantilla y sus actividades antes depoder crear los flujos de trabajo a partir de ella.

3. Para reanudar la presentación del mensaje, seleccione Restablecer para mostrar los mensajesde advertencia.


Actualizar datos de proceso en la base de datos deBAMLa página Actualizar definiciones de datos de BAM permite actualizar los datos de procesoseleccionados en Process Builder con los datos de informes de la base de datos de BAM. De esta formase asegurará de que la estructura de los datos de Process Builder coincide con la estructura de BAM.Esta opción actualiza los datos empresariales de BAM con los datos de proceso seleccionados en lapágina Actualizar definiciones de datos de BAM.

Las definiciones de datos se deben actualizar sólo cuando se utilizan por primera vez o si ha habidoun cambio en las definiciones de datos. Por ejemplo, si modifica un tipo de datos estructurados paraagregar un nuevo atributo que se pueda incluir en los informes o para cambiar el nombre de un atributoque se puede incluir en los informes, debe actualizar esta nueva definición con BAM. Además, si creaun nuevo tipo de objeto que se utiliza en un paquete, estas definiciones de tipo de paquete se debenactualizar con la base de datos de BAM.

BAM debe estar instalado y configurado correctamente en Content Server para que se realice laactualización.



Actualizar tipos de datos estructurados en BAMPara actualizar tipos de datos estructurados:

1. Seleccione Herramientas > Actualizar definiciones de datos de BAM.

2. Realice alguno de los procedimientos siguientes:• En la lista de tipos de datos estructurados, seleccione los tipos que desea actualizar en la base dedatos de BAM.En el cuadro de lista sólo aparecen los tipos de datos estructurados que no se han actualizado.

• Haga clic en Seleccionar todo para actualizar todos los tipos de datos estructurados queaparecen en el cuadro de texto.

3. Haga clic en Actualizar.

Actualizar los tipos de objeto de paquete en BAMPara actualizar los tipos de objeto incluidos en los paquetes:

1. Para actualizar los tipos de objeto que se utilizan en un paquete con la base de datos de BAM,haga clic en Actualizar en el cuadro de grupo Tipos de objeto.

2. Haga clic en Cerrar.

Ventana Plantillas de actividadesLa ventana Plantillas de actividades, situada en el lado izquierdo de la ventana de Process Builder,muestra plantillas de actividad predefinidas que se pueden agregar a la plantilla de proceso. Lascarpetas de plantillas de actividades ofrecen una forma de organizar plantillas de actividad en gruposrelacionados. Por ejemplo, los nombres de las carpetas pueden representar categorías generales deactividades, como Aprobaciones e Integración.

Cada plantilla de actividad representa un tipo concreto de actividad y puede incluir propiedadesespeciales que sean específicas de dicho tipo de actividad. Por ejemplo, una plantilla de actividad parael envío de correo electrónico a socios externos incluye una propiedad para las direcciones de correoelectrónico. Consulte el apartado Trabajar con plantillas de actividad, página 97 si necesita másinformación sobre las plantillas de actividad.

La visualización de las carpetas de plantilla se controla mediante el cuadro de diálogo Preferenciasde Process Builder. En Gestionar las carpetas de plantillas de actividades, página 43 se proporcionainformación detallada sobre cómo configurar las carpetas que aparecen en la ventana.

Cada carpeta de plantillas de actividades se corresponde con una carpeta del sistema en el repositoriode Documentum. Estas carpetas tienen el mismo nombre que las carpetas que residen en la carpetadel sistema System/Workflow/Activity Templates. La carpeta incluye los objetos dm_activity que secorresponden a las plantillas de actividad de la carpeta.

Para agregar una actividad a la plantilla de proceso, arrastre la plantilla de actividad pertinente desdela ventana Plantillas de actividades hasta la ubicación que desee en el editor de plantillas de procesoy, a continuación, defina las propiedades de la actividad. Para ver o modificar las propiedades de laplantilla de actividad, haga doble clic en su icono en la carpeta de plantillas de actividades. Consulte el



Trabajar con plantillas de actividad, página 97 para obtener más información sobre la forma de definirpropiedades de las actividades y sus plantillas.

Desde el menú contextual, puede realizar muchas de las funciones existentes en el menú Archivo de labarra de herramientas, como guardar, quitar y crear nuevas carpetas o plantillas de actividad.

Las plantillas de actividad aparecen en la ventana en uno de estos tres estados: borrador, validado einstalado. Un icono representa cada estado. Sólo las plantillas de actividades instaladas se puedenagregar a una plantilla de proceso. Puede validar, instalar y desinstalar una plantilla de actividades enla ventana Plantillas de actividades si utiliza las funciones del menú contextual. En Validar plantillasde actividad, página 100 encontrará más información sobre este tema.

Tabla 4 Estados de la plantilla de actividades e iconos relacionados

Estado Icono

Borrador

Validado

Instalado

Ventana Structured Data Types (Tipos de datosestructurados)La ventana Structured Data Types (Tipos de datos estructurados) muestra todos los tipos de datosestructurados que se han definido en el repositorio. Se muestran en una estructura jerárquicaorganizada en categorías que se define en función de su uso en su negocio.

Utilice esta ventana para agregar y eliminar tipos de datos estructurados mediante el Asistente paraTipos de datos estructurados, para crear o eliminar categorías, y ver los detalles de los tipos de datosestructurados. También puede utilizar esta ventana para iniciar un asistente que le permita crear un tipode datos estructurados a partir de un esquema XML.

Crear categorías de tipos de datos estructuradosPuede organizar los datos de proceso en categorías jerárquicas de datos basadas en la organización decada empresa. Dentro de dichas categorías se encuentran los grupos y atributos que componen lostipos de datos estructurados.

Para agregar una categoría a la lista de tipos de datos estructurados:

1. Haga clic con el botón secundario del ratón en la ventana Tipo de datos estructurado y seleccioneAgregar categoría.

También puede agregar una categoría si selecciona Cambiar categorías en el Asistente paraagregar tipos de datos estructurados.

Aparecerá el cuadro de diálogo Seleccionar categoría con el árbol de jerarquía y los nodosdisponibles.

2. Escriba el nombre de la categoría que está agregando.



3. Resalte el nodo o la categoría del árbol donde desea agregar la nueva categoría y escriba el nombrede la nueva categoría.

4. Haga clic en para agregar la nueva categoría.


Eliminar una categoría de tipos de datosestructuradosPara eliminar una categoría:

1. En la ventana Structured Data Types (Tipos de datos estructurados), resalte la categoría quedesee eliminar.

2. Haga clic con el botón secundario del ratón en la ventana Structured Data Type (Tipo de datosestructurado) y seleccione Eliminar categoría.

Nota: Si la categoría incluye tipos de datos estructurados, el sistema no la eliminará.

Crear un grupo de tipos de datos estructuradosPara crear un grupo dentro de un tipo de datos estructurado:

1. Haga clic en el icono Agregar grupo .

2. Escriba el nombre del grupo.

Nota: El campo Nombre del grupo sólo admite caracteres de un byte.

Actualizar la ventana Tipo de datos estructuradoPara actualizar el contenido de la ventana Tipo de datos estructurado:

1. Haga clic con el botón secundario dentro de la ventana.

2. Seleccione Actualizar.

La ventana se actualiza con cualquier nuevo tipo de datos estructurado disponible dentro delrepositorio.

Crear tipos de datos estructuradosUn tipo de datos estructurado es una manera de representar datos empresariales que pertenecen alflujo del proceso y que, generalmente, consta de los siguientes elementos de datos: Nombre, Tipo,[Valor predeterminado].

Existen dos clases de tipos de datos estructurados: simples y complejos. Un tipo de datos simple es unúnico atributo, como una cadena o un valor booleano. Un tipo de datos complejo está formado porvarios atributos. Por ejemplo, los elementos de una solicitud de asignación se pueden organizar enel grupo Solicitud con los atributos nombre_solicitante, dirección_solicitante y tipo_equipamiento.Dentro de cada tipo de datos estructurado, puede organizar también los atributos en grupos relacionados



que dan la estructura visual al tipo de datos. Por ejemplo, dentro del tipo de datos estructurado cliente,puede tener un grupo de direcciones que contenga los atributos para la ciudad y el estado.

Nota: Debe disponer de los privilegios de usuario Crear tipo para crear un tipo de datos estructurado.

Para crear un tipo de datos estructurado:

1. En Process Builder, seleccione Archivo > Nuevo > Tipo de datos estructurado.

Además, haga clic en el icono Crear nuevo Tipo de datos estructurado en la barra deherramientas o haga clic con el botón secundario del ratón en la ventana en la ventana Tipo dedatos estructurado y seleccione Agregar tipo de datos estructurado.

Aparece el cuadro de diálogo Asistente para agregar tipo de datos estructurado.

2. Para cambiar las categorías o crear una nueva, haga clic en Change Categories (Cambiarcategorías) y agregue una nueva categoría al nodo seleccionado. Crear categorías de tipos de datosestructurados, página 46 proporciona procedimientos detallados para crear categorías.

3. Escriba un Nombre para el tipo de datos estructurado.

Los nombres deben tener menos de 70 caracteres y deben utilizar caracteres de un byte. El nombreno se puede modificar una vez que se ha guardado.

Para cambiar un nombre, debe asegurarse de que el tipo de datos estructurado no está en uso,eliminarlo y, a continuación, volver a crearlo con el nombre nuevo.

4. Escriba un Nombre para mostrar para el tipo de datos estructurado.

El texto del campo Nombre para mostrar aparece en la vista de árbol de la ventana Tipos dedatos estructurados.

Nota: Los nombres para mostrar deben tener menos de 70 caracteres. El campo Nombre paramostrar admite caracteres de doble byte.

5. Puede crear un grupo de atributos seleccionando el icono Agregar grupo y escribiendoel nombre del grupo.

Puede crear un grupo en cualquier punto del proceso de creación de tipos de datos estructurados.

El campo Nombre del grupo sólo admite caracteres de un byte.

6. Haga clic en del icono agregar para agregar un atributo al tipo de datos estructurado.

Puede quitar un atributo si hace clic en el icono Quitar .

7. Escriba un Nombre para el atributo.

Los nombres deben tener menos de 70 caracteres y deben utilizar caracteres de un byte.

8. Escriba un Nombre para mostrar para el atributo.

El texto del campo Nombre para mostrar aparece en la vista de árbol de la ventana Structured DataTypes (Tipos de datos estructurados).Nota: Los nombres para mostrar deben tener menos de 70 caracteres. El campo Nombre paramostrar admite caracteres de doble byte.

9. Escriba una descripción opcional para el atributo.

10. Seleccione un tipo de datos para el atributo.

Los valores válidos son: cadena, entero, flotante, fecha o booleano.

a. Según el tipo de datos que haya definido, escriba un valor predeterminado, si fuera necesario.



Nota: La variables de procesos que se usarán en conjuntos de correlaciones no deben tenervalores predeterminados. Las variables de proceso que tienen valores predeterminados noposeen las características de atributo exclusivas requeridas para que coincida un mensajeentrante con una instancia única de un proceso. Introducción a la correlación de mensajes,página 155 proporciona más información sobre el uso de conjuntos de correlación para asignarcontenido de mensajes a datos de proceso.

b. Para los valores de cadena, escriba una longitud máxima para el valor.

El valor predeterminado del campo es 256 caracteres.

Process Builder permite que los valores de cadena tengan hasta 4.000 bytes, dependiendo delos límites impuestos por la base de datos a este tipo de campo.

Nota: Debido a una limitación de las bases de datos de DB2, los atributos de tipos de datosestructurados mayores de 256 caracteres se truncarán en las bases de datos de BAM que solose ejecutan en DB2.

11. Defina otras opciones para el atributo, según sea necesario.

• Seleccione De repetición para habilitar la repetición de atributos.• Seleccione De búsqueda para permitir que BAM cree índices para el atributo.• Seleccione Informe para exponer este tipo a la base de datos de BAM y utilizarlo en losinformes de BAM.

12. Para actualizar las definiciones de tipos de datos con BAM, seleccione Actualizar las tablas debase de datos de BAM basadas en esta definición de SDT.

Al hacerlo, se envían las nuevas definiciones de tipos de datos a la base de datos de BAM, dondese agregan a las tablas que se utilizan para los informes.

Ver detalles de tipos de datos estructuradosPara ver los detalles de un tipo de datos estructurado:

1. Haga clic con el botón derecho del ratón en la ventana Tipos de datos estructurados.

2. seleccione Ver detalles en el menú o haga doble clic en el tipo de datos estructurado.

Aparece el cuadro de diálogo Tipos de datos estructurados y muestra los detalles del tipo dedatos estructurado.

Editar tipos de datos estructuradosDespués de crear un tipo de datos estructurado y antes de usarlo en un proceso, puede cambiar laspropiedades de los atributos, y también puede agregar atributos y grupos. Después de que un tipode datos estructurado se usa en un proceso, se pueden modificar datos mínimos para conservar laintegridad de cualquier instancia del proceso que esté en ejecución actualmente.

Los tipos de datos estructurados que se usan en un proceso tienen el texto En uso... en la parte superiorderecha del cuadro de diálogo. Si hace clic en el texto, el sistema inicia el cuadro de diálogo Lista deprocesos que muestra los procesos que actualmente hacen referencia a los tipos de datos estructurados.



Los atributos no se pueden modificar ni eliminar mientras están en uso. Puede cambiar el nombrepara mostrar y la descripción del tipo de datos estructurado. También puede agregar un grupo nuevoo un atributo nuevo.

Nota: Cuando modifique un tipo de datos estructurado utilizado en los informes de BAM, seleccionela opción de la página que permite actualizar la nueva definición con la base de datos de BAM.

Para cambiar un atributo de un tipo de datos estructurado en uso:

1. Abra todos los procesos que utilicen el tipo de datos.

2. Desinstale el proceso.

3. Quítelo como una variable de proceso.

4. Edite el tipo de datos estructurado.

Nota: Al agregar un nuevo atributo y guardar los cambios, ya no se podrá modificar ese atributo.

Crear tipos de datos estructurado complejos a partirde esquemas XMLPuede buscar y recuperar un esquema XML (como un archivo .XSD) e importarlo en el repositoriocomo un objeto de tipo de datos estructurado, permitiéndole utilizar los datos de una aplicaciónexterna o de otra parte de su negocio.

Nota: Si el esquema que está utilizando tiene muchos elementos, es mejor importarlos de uno en uno.

Para crear un tipo de datos estructurado a partir de un esquema XML:

1. Haga clic con el botón secundario en la ventana Tipos de datos estructurados y seleccione Creartipo de datos estructurado desde esquema XML.

Aparecerá el cuadro de diálogo Crear TDE desde esquema XML con la categoría a la quese va a agregar el tipo de datos estructurado.

2. Para cambiar las categorías o crear una nueva, haga clic en Change Categories (Cambiarcategorías) y agregue una nueva categoría al nodo seleccionado.

3. Seleccione un archivo de esquema XML para usar:

• Haga clic en para seleccionar el esquema del sistema de archivos local.

• Haga clic en para seleccionar el esquema del repositorio actual y desplazarse al esquemaque desea importar.

• Escriba una URL y haga clic en para obtener un nombre de esquema o recibir el contenidode un sitio web.

4. Seleccione el tipo de datos que desea importar.• Tipo complejo muestra todos los tipos de datos complejos que incluyen los atributos anidados.• Tipo de elemento muestra el objeto contenedor y la información jerárquica, además de losatributos asociados al tipo de datos.

5. En el cuadro de lista, seleccione el tipo de datos para utilizarlo como un tipo de datos estructurado.

La información relacionada para el tipo de datos aparece en el cuadro de grupo Tipos de datosestructurados.



6. Puede editar los campos más genéricos de los atributos, como Nombre para mostrar,Descripción.

7. Defina otras opciones para el atributo, según sea necesario.

• Seleccione De repetición para habilitar la repetición de atributos.• Seleccione De búsqueda para permitir que BAM cree índices para el atributo.• Seleccione Informe para exponer este tipo al crear los informes de BAM.

8. Haga clic en Aplicar para agregar los tipos de datos estructurados importados a la ventanaStructured Data Types (Tipos de datos estructurados).

Panel del editor de plantillas de procesoEl panel del editor de plantillas de proceso es la zona en donde se diseña el flujo de los procesoscomerciales. Para definir un proceso comercial, arrastre la actividad predefinida desde las carpetas deplantillas de actividades hasta el editor de plantillas de proceso o cree nuevas actividades manualeso automáticas, conéctelas con flujos y defina sus propiedades y las de los flujos. Consulte Crearplantillas de proceso, página 60 para obtener más información. También puede agregar notas de texto,página 54 a áreas de etiquetas de la plantilla.

Los procedimientos que se siguen para controlar el diseño visual de un proceso comercial son similaresa los de cualquier otro software de diseño gráfico.

• Para agregar objetos a la plantilla de proceso, arrastre una actividad desde la carpeta de plantillas deactividades y colóquela en el panel del editor de plantillas de proceso. El objeto se agregará a laplantilla justo en la ubicación donde suelte el botón del ratón. La barra de herramientas tambiéncuenta con botones para agregar flujos y actividades (en blanco).

• Para mover objetos dentro de la plantilla de proceso, selecciónelos y arrástrelos a la nuevaubicación. Siempre que se mueve una actividad con flujos que la conectan a otras actividades,las flechas que representan dichos flujos también se mueven con la actividad. Los flujos no sepueden mover por sí solos.

• Para eliminar objetos de la plantilla de proceso, selecciónelos y haga clic en el icono Eliminarobjetos seleccionados de la barra de herramientas o elija Eliminar en el menúModificar.

• Para copiar actividades, selecciónelas y haga clic en el icono Copiar de la barra de herramientas oelija Copiar en el menúModificar. Para agregar la nueva copia a la plantilla, haga clic en el iconoPegar de la barra de herramientas o seleccione Pegar en el menúModificar.

• Para ver las acciones disponibles para un objeto específico, selecciónelo y haga clic con el botónsecundario del ratón. Aparece un menú contextual en la posición del cursor del ratón en el que semostrarán las acciones disponibles.

Seleccionar objetos de plantilla de procesoPara seleccionar uno o varios objetos en el panel del editor de plantillas de proceso:

1. Introduzca el modo de selección con el icono Seleccionar objetos de la barra de herramientas,haciendo clic con el botón secundario del ratón en la página del editor o pulsando la tecla Esc.



2. Haga clic en la representación visual del objeto en el panel del editor de plantillas de proceso,o bien, haga clic en una zona despejada y arrastre el ratón para dibujar un rectángulo alrededorde los objetos.

Aparecerá un conjunto de cuadros negros alrededor de los objetos seleccionados. Si hace clic en elobjeto una segunda vez, se anula la selección y desaparecen los cuadros negros.

3. Para seleccionar objetos adicionales, mantenga presionada la tecla Mayús mientras hace clic enellos.

Nota: Si no mantiene pulsada dicha tecla, al elegir un objeto se anulará automáticamente laselección anterior.

4. Para seleccionar todos los objetos en la pantalla, elija Seleccionar todo en el menú Editar.

Alinear actividadesLas opciones de alineación permiten colocar las actividades de flujo de trabajo con exactitud. Esposible alinear actividades en sentido vertical u horizontal por sus bordes izquierdo, derecho, superioro inferior, o por sus puntos centrales.

Para alinear actividades:

1. Seleccione las actividades que desea alinear.

Debe seleccionar dos o más actividades para que se activen las opciones de alineación. ConsultePanel del editor de plantillas de proceso, página 51 si necesita más información sobre cómoseleccionar actividades.

2. Seleccione Alineación en el menúMostrar y, a continuación, elija la alineación correcta en elsubmenú.

Las opciones de alineación disponibles son las siguientes:

• Izquierda: alinea el borde izquierdo de los objetos seleccionados.

• Vertical: alinea el centro de los objetos seleccionados en sentido vertical.

• Derecha: alinea el borde derecho de los objetos seleccionados.

• Parte superior: alinea el borde superior de los objetos seleccionados.

• Horizontal: alinea el centro de los objetos seleccionados en sentido horizontal.

• Parte inferior: alinea el borde inferior de los objetos seleccionados.

Si decide alinear los bordes superiores de las actividades, la actividad superior o más altadetermina la colocación de las demás. Es decir, las actividades seleccionadas subirán para estaralineadas con actividad más alta. De igual modo, si decide alinear los bordes inferiores de lasactividades, la inferior o más baja determina la colocación de las demás. Esto también se aplica alas alineaciones izquierda y derecha.

Sustituir actividadesPuede sustituir una actividad de una plantilla de proceso por otra plantilla de actividad si arrastra lanueva plantilla de actividad desde la carpeta de plantillas de actividades y la coloca en la actividadexistente.



Por ejemplo, después de que un desarrollador de procesos importe un proceso de Process Analyzer aProcess Builder, es posible que deba sustituir las actividades genéricas importadas por determinadasplantillas de actividad existentes. El desarrollador sólo debe arrastrar una actividad nueva y colocarlaen la ubicación correcta del proceso, de forma que se elimine la actividad anterior y se sustituya porla nueva. Mediante este método de sustitución de una actividad se mantienen los enlaces entre lasactividades, pero no se conserva información de configuración, tal como temporizadores, transiciones,reglas de asignación, etc. Utilice el Inspector de actividades para volver a configurar la actividad.

Ajustar a la cuadrícula

La opción de ajuste a la cuadrícula proporciona mayor precisión a la hora de alinear flujos yactividades de flujo de trabajo.

Seleccione Ajustar a la cuadrícula en el menúMostrar.

Cuando se activa esta opción, aparece una cuadrícula en el fondo del editor de plantillas de proceso.Cuando mueva actividades o flujos en el editor, se alinearán automáticamente con la cuadrícula,facilitando la alineación de los objetos entre sí. La activación de la opción de ajuste a la cuadrícula noafecta al diseño de los objetos existentes en la plantilla.

Cuando se desactiva esta opción, la cuadrícula no aparece y los objetos se colocan exactamenteen la ubicación en la que se sueltan. Desactive esta opción si desea tener un control preciso de laposición de los objetos.

Acercar o alejar

Si los botones de la barra de herramientas de vista están activos, el nivel actual de zoom aparece enun cuadro entre los iconos Acercar y Alejar . Cada vez que hace clic en uno de estos iconos,Process Builder aleja o acerca los objetos un nivel.

Para acercar o alejar en una plantilla de proceso:

1. Expanda el cuadro de lista situado junto al icono Acercar o seleccione Zoom en el menú Ver.

2. Seleccione uno de los siguientes niveles de zoom:

• 200% (ampliación máxima)

• 150%

• 100% (vista normal: valor predeterminado)

• 75%

• 50%

• Último: cambia entre la opción de zoom actual y la anterior.

• Ancho: ajusta el ancho de la plantilla de proceso a las dimensiones visuales del panel deleditor de plantillas de proceso.

• Ajustar: amplía o reduce el aspecto de la plantilla de proceso de modo que se ajuste a lasdimensiones visibles del panel del editor de plantillas de proceso.



Agregar notasPuede agregar texto al diseño visual de la plantilla de proceso mediante notas. Aunque las notas noafectan a cómo se ejecuta realmente el proceso comercial, pueden servir para aclarar el proceso alas personas que consulten la plantilla. Puede colocar una nota en cualquier lugar del diseño de laplantilla. De forma predeterminada, la nota aparecerá con un rectángulo amarillo alrededor del texto,pero puede elegir otras opciones de visualización. En el ejemplo siguiente se muestra una nota condistintos formatos.

Figura 5 Las notas agregan texto al diseño visual

Process Builder le ofrece la opción de suprimir la visualización de las notas. En el menúHerramientas, seleccione Notas, a continuaciónMostrar y active o desactive la opción.

Para agregar una nota a una plantilla de proceso:

1. Haga clic en el icono Nota de la barra de herramientas .

Al arrastrar el cursor por el área de edición de la plantilla de proceso, aparece el icono.2. Haga doble clic en la ubicación del diseño del proceso donde desea agregar la nota.

El primer clic crea un rectángulo amarillo en la página y el segundo abre el cuadro de diálogoInspector de notas.

3. Introduzca el texto de la nota en la ficha Contenido de la nota.4. Haga clic en la ficha Visualización.

A medida que realice cambios en la configuración de la visualización, el cuadro Vista previasituado en la parte inferior del cuadro de diálogo mostrará las selecciones actuales.

5. Defina la fuente y el estilo para el texto de la nota.a. Seleccione una fuente en la lista Fuente.b. Seleccione un tamaño en la lista desplegable Tamaño de puntos.c. Para definir el estilo de fuente de la etiqueta, seleccione o borre Negrita y Cursiva.

6. Defina la alineación y el color del texto de la nota.a. Elija uno de los botones de opción (Izquierda, Centro o Derecha) a fin de especificar la

justificación de cada línea del texto de la nota.



b. Seleccione el color del texto en la lista desplegable Color de texto.

c. Elija el color de fondo de la nota en la lista desplegable Color de fondo.Los bordes externos de la nota quedarán amarillos, sin importar el color de fondo.

7. Especifique la transparencia que desea aplicar a la nota.

Con el control deslizante Transparencia, establezca el grado de transparencia. Si el nivel detransparencia se establece en el 100%, la nota será opaca y ocultará completamente los objetos quese encuentren detrás de ella en la plantilla de proceso. Si el nivel de transparencia se establece enel 0%, la nota será completamente transparente.

8. Especifique el aspecto del borde de la nota.

a. Active la casilla de verificación Borde para mostrar un borde amarillo.

b. Active la casilla de verificación Estilo de BPMN para mostrar la nota con el formato BusinessProcess Modeling Notation para anotaciones de texto: aparece un borde grueso en el ladoizquierdo de la nota.

9. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de notas o en Aceptarpara guardarlas y cerrar el Inspector de notas.

La nota aparecerá en el diseño del proceso.

10. Cambie el tamaño del cuadro de nota, si es necesario.

Para ello, seleccione el objeto de nota y arrastre uno de los controles negros situados en los bordes.

Ver varios procesos utilizando fichasCuando está creando una plantilla de proceso, puede necesitar ver otro proceso existente. ProcessBuilder le permite abrir y ver varios procesos en distintas fichas. Cuando se abre un proceso, ésteaparece en una nueva ficha, dejando a cualquier otro proceso abierto en fichas independientes en laventana del editor de procesos.

Haga doble clic en una ficha para expandir la presentación del proceso con objeto de que se ajuste a laventana completa. Haga doble clic de nuevo en ella para minimizar la ventana de proceso y mostraruna vez más el Navegador de recursos. El estado actual de la plantilla abierta aparece en la barra detítulo de la ventana Process Builder. Si la ficha incluye datos que aún no se han guardado, el nombredel proceso irá precedido de un asterisco (*).

Nota: La vista de varias fichas sólo está disponible para procesos existentes dentro del mismorepositorio. No se pueden abrir o ver procesos de más de un repositorio.

Para cerrar la ficha que está viendo actualmente, haga clic con el botón secundario en la ficha yseleccione Cerrar, elija Archivo > Cerrar o haga clic en en la ficha.

Utilizar la ficha Validación de procesosLa ficha Validación de procesos permite ver los errores de validación al validar un proceso guardado.Al validar un proceso con errores, en la ficha Validación de procesos se muestran todos los erroresdel proceso agrupados por nombre de actividad.



Figura 6 Ficha Validación de procesos

En la ficha Validación de procesos figuran errores que se producen como consecuencia de cambios enlos datos de procesos que definen lo siguiente:

• Ejecutante

• Ejecutante condicional

• Lógica de transición

• Acciones de temporizador

• Nombre de tarea

• Instrucciones de la tarea

• Configuración de elementos de la ficha personalizada de una plantilla de actividad

Expanda el nodo de la actividad y visualice todos los errores encontrados en cada actividad. Alseleccionar un error individual en la ficha, el sistema resalta la actividad correspondiente en el paneldel editor del proceso, de modo que pueda abrir la plantilla y corregir el error.

Para ver todos los errores de todas las actividades, haga clic en Expandir todo. Para cerrar la listade errores de todas las actividades, haga clic en Contraer todo.

También puede hacer clic en el botón Exportar a un archivo para guardar en un archivo una versiónde sólo texto de los errores o para copiarla en el portapapeles.

La ficha Validación de procesos y las fichas del depurador de proceso se pueden utilizar conjuntamentepara solucionar los problemas de un proceso.

Nota: Si no hay errores de validación en la plantilla, la ficha Validación de procesos no aparece.

Utilizar el navegador de plantillas de procesoAl definir una plantilla de proceso, la representación gráfica puede alcanzar fácilmente un tamaño tangrande que la pantalla no pueda mostrarla por completo. El editor de plantillas de proceso se desplazaautomáticamente a medida que el usuario agrega objetos y crea diseños de mayor tamaño.

El navegador permite controlar qué parte de una plantilla de gran tamaño aparece en pantalla.

Para moverse hasta la parte de una plantilla que se mostrará en la pantalla:



1. Seleccione Navegador en el menúMostrar o haga clic en el icono del mismo nombre de labarra de herramientas .

Aparece la ventana Navegador en el panel derecho de la ventana Process Builder. En ella semuestra una representación reducida de la plantilla de proceso actual, con un cuadro gris alrededorde la sección que aparece en pantalla.

2. Para cambiar el área de la plantilla que aparece en la pantalla, arrastre el cuadro gris en la ventanaNavegador hasta que se sitúe sobre el área que desea ver en el editor.

Cuando suelte el botón del ratón, el panel del editor se desplazará hasta la posición seleccionada.




Capítulo 3

Trabajar con plantillas de proceso


• Información general de las plantillas de proceso

• Abrir plantillas de proceso existentes

• Crear plantillas de proceso

• Definir propiedades de la plantilla de proceso

• Gestionar datos de procesos

• Configurar las opciones avanzadas

• Guardar plantillas de proceso

• Validar plantillas de proceso

• Instalar plantillas de proceso

• Modificar plantillas de proceso

• Plantillas de proceso para registrar, retirar y crear versiones

• Eliminar las plantillas de proceso

• Importar plantillas de proceso

• Exportar plantillas de proceso

• Mantener sincronizados los procesos compartidos

• Imprimir plantillas de proceso

Información general de las plantillas de procesoLas plantillas de proceso representan el proceso comercial a través del cual fluye un determinadoobjeto o conjunto de objetos. Definen el flujo de trabajo total de principio a fin. El usuario creaplantillas de proceso en Process Builder y las pone a disposición de los demás usuarios para quepuedan crear instancias de flujo de trabajo individuales a partir de ellas.

Las plantillas de proceso pueden encontrarse en tres estados: borrador, validado e instalado. El estadoactual de la plantilla abierta aparece en la barra de título de la ventana Process Builder. La barra detítulo también indica si la plantilla está retirada y el nombre de usuario del propietario del bloqueo, siotro usuario ha retirado la plantilla.

Una plantilla con el estado borrador no se ha validado desde que se creó o desde la última vez que semodificó. Una plantilla con el estado validado ha pasado las verificaciones de validación del servidor,que garantizan que la plantilla se ha definido correctamente. Una plantilla con el estado instalado estálista para ser utilizada en un flujo de trabajo activo.



Abrir plantillas de proceso existentesPuede abrir una plantilla existente a fin de revisarla, corregirla o guardarla con un nuevo nombre amodo de punto de partida de un nuevo flujo de trabajo.

Para abrir una plantilla de proceso:

1. En el menú Archivo, seleccione Abrir.

Aparece el cuadro de diálogo Abrir plantilla de proceso.

2. Para desplazarse hasta la plantilla, haga doble clic en el archivador y en los nombres de carpetahasta que aparezca el nombre de la plantilla en el cuadro de lista.

3. En la listaMostrar, seleccioneMostrar versiones actuales para ver únicamente la versión actualde las plantillas en la ventana, o bien seleccioneMostrar TODAS las versiones para ver unlistado de todas las versiones de las plantillas.

4. Resalte el nombre de la plantilla y active la casilla de verificación Retirar proceso al abrir paraeditar el proceso. Mostrar sólo está disponible cuando otro usuario tiene la plantilla retirada yabre una copia de sólo lectura de la plantilla.

Nota: Si otro usuario retira la plantilla, un icono de bloqueo aparece en el nombre de la plantilla yMostrar será la única opción disponible para la plantilla. Al colocar el cursor en el nombre, eltexto muestra el nombre del usuario que posee el bloqueo en la plantilla.

5. Haga doble clic en dicho nombre o resáltelo, y haga clic en Abrir.

Crear plantillas de procesoEl procedimiento siguiente proporciona información general sobre cómo crear plantillas. Algunospasos proporcionan enlaces a otros temas en los que podrá encontrar más detalles sobre la tareadescrita por dicho paso.

Para crear una plantilla de proceso:

1. Diseñe el proceso comercial y el flujo de trabajo que lo implementa.

Si necesita detalles sobre el diseño de procesos comerciales, consulte Planificar los procesos deflujo de trabajo, página 18.

2. En el menú Archivo, seleccione Nuevo > Proceso.

La plantilla en blanco se abrirá en su nueva ficha con las tareas de inicio y de fin predeterminadas.

Nota: Para crear una plantilla a partir de otra, abra la plantilla existente y guárdela con unnuevo nombre.

3. Defina las propiedades de plantilla.

Consulte Definir propiedades de la plantilla de proceso, página 62 si necesita información detallada.

4. Identifique los datos de proceso asociados o creados como parte del proceso comercial.

Consulte Gestionar datos de procesos, página 64 si necesita información detallada.

5. Agregue actividades a la plantilla de proceso hasta que haya una actividad por cada una de lastareas en el flujo de trabajo.



• Haga clic en el icono de actividad manual o el icono de actividad automática en la barrade herramientas, a continuación, haga clic en el panel del editor de plantillas de proceso dondedesea que aparezca la actividad.

• Arrastre y suelte una plantilla de actividad en la ventana Plantillas de actividad en al paneldel editor de plantillas de proceso.

Si la ventana Plantillas de actividades no incluye ninguna plantilla que represente el tipo deactividad que necesita, puede crear una actividad en blanco haciendo clic en los botones deactividad manual o automática en la barra de herramientas o puede crear una nueva plantilla. Crearplantillas de actividad, página 97 proporciona más información relacionada con la creación deuna nueva actividad.

6. Conecte cada actividad con la actividad que la precede en el flujo lógico.

La primera actividad en el flujo de trabajo debe estar conectada a una actividad de inicio (puedeser cualquier tipo de actividad de inicio) y la última actividad debe estar conectada a la actividadde finalización.

Para conectar dos actividades, seleccione uno de los iconos de flujo, mueva el cursor sobrela primera actividad hasta que vea su cuadro de selección y arrastre el ratón hasta la segundaactividad. Suelte el botón del ratón cuando vea el cuadro de selección de la segunda actividad.Process Builder dibuja una línea entre ambas actividades.

Puede conectar actividades mediante uno de los cuatro iconos Crear flujo de la barra deherramientas de Process Builder:

• Para conectar actividades en un movimiento de datos hacia adelante, haga clic en el icono Crearflujo de un solo segmento o en el icono Crear flujo de segmentos múltiples . La diferenciaentre los dos es visual: uno muestra una línea recta que representa el flujo entre las actividades yel otro una línea que consta de varios segmentos.

• Para conectar actividades en un movimiento de datos hacia atrás, haga clic en el icono Crearflujo de rechazo . Este icono representa la ruta que se sigue cuando el usuario de unaactividad rechaza el objeto que se está procesando.

• Para conectar una actividad del controlador de errores al flujo, haga clic enActividades, página 14 proporciona información detallada sobre este tema.

Nota: Conecte todas las actividades en el flujo antes de configurar las actividades individuales.Algunos pasos de configuración están basados en la posición de la actividad en el procesocomercial.

7. Configure cada actividad.

Consulte el Configurar plantillas de actividad, página 99 si necesita información detallada sobrecómo configurar las actividades. Normalmente, se recomienda configurar las actividades enel orden en que aparecen en el proceso comercial, comenzando por la actividad de inicio.Configure todas las fichas necesarias para cada actividad. Por ejemplo, recuerde configurar laficha Desencadenador para las actividades de unión y la ficha Transición para las actividades dedivisión de la decisión. (Para la actividad de inicio, sólo se encuentran disponibles las fichasPropiedades, Datos y Visualización.)

8. Ajuste el diseño visual según sea necesario.

Si necesita información sobre las opciones disponibles para el diseño de la plantilla de proceso,consulte Panel del editor de plantillas de proceso, página 51.

9. Guarde la plantilla de proceso.



Consulte Guardar plantillas de proceso, página 74.

10. Valide la plantilla de proceso.

Consulte Validar plantillas de proceso, página 76.

11. Instale la plantilla de proceso.

Consulte Instalar plantillas de proceso, página 77. Una vez que haya instalado la plantilla, ésta seencontrará disponible para los usuarios.

Definir propiedades de la plantilla de procesoUtilice el cuadro de diálogo Propiedades de proceso para proporcionar información básica sobre elflujo de trabajo que desea crear. El creador original y el estado actual de la plantilla de proceso,incluido su estado de bloqueo, propietario del bloqueo y versión, aparecen en la parte superior delcuadro de diálogo en campos de sólo vista.

Nota: Para modificar una plantilla existente, debe desinstalar el proceso. Modificar plantillas deproceso, página 78 proporciona más información sobre cómo modificar una propiedad existente.

Para definir las propiedades de la plantilla de proceso:

1. En el menú Herramientas, seleccione Propiedades de proceso o haga clic en el iconoPropiedades de plantilla de la barra de herramientas .

2. Seleccione la ficha General.

La información básica de la plantilla aparece como texto de sólo lectura en la parte superiorde la plantilla.

3. Para cambiar el propietario de la plantilla de proceso, haga clic en el botón Cambiar que aparecejunto al nombre del propietario y seleccione un usuario en el cuadro de diálogo que aparece.

Usted será el propietario predeterminado de todas las plantillas que cree. Únicamente puedecambiar el propietario si es un superusuario. De no ser así, el botón Cambiar no estará disponible.

4. Introduzca una descripción de la plantilla de proceso en el cuadro de texto Descripción.

5. Para modificar el alias predeterminado de esta plantilla, haga clic en el botón Cambiar queaparece junto al conjunto de alias actual.• Para elegir un conjunto de alias existente, marque Elegir entre los conjuntos de aliasexistentes, seleccione el nombre del conjunto de alias en la lista desplegable y haga clic enAceptar.

• Para crear un nuevo conjunto de alias, marque Crear nuevo conjunto de alias, escriba elnombre y la descripción del nuevo conjunto de alias y haga clic en Aceptar.

• Para quitar el conjunto de alias predeterminado asignado actualmente, marque Quitar conjuntode alias.

Si necesita más información sobre los conjuntos de alias y la forma en que se usan en los flujos detrabajo, consulte Usar alias, página 24.

6. Introduzca instrucciones para el ejecutante en el campo Instrucciones de flujo de trabajo.

Por ejemplo, puede dar instrucciones concretas a los ejecutantes de todas las actividades sobresus tareas.

7. Configure la Configuración de auditoría para la plantilla seleccionando la opción adecuada:



• Desactivado: el sistema no creará eventos de auditoría para los procesos que utilizan estaplantilla.

• Sólo los eventos BAM: el sistema crea sólo eventos de auditoría necesarios para las alertas y losinformes de BAM.

• Todos los eventos: el sistema crea el conjunto completo de eventos de auditoría.Nota: Si activa Todos los eventos se creará una gran cantidad de datos de auditoría y puedeverse afectado el rendimiento del sistema.

Si está activada la auditoría, se guardará la información de seguimiento de comprobación de todoslos flujos de trabajo creados a partir de esta plantilla. La auditoría debe estar activada para permitiral sistema publicar datos de informes en la base de datos de BAM.

Para cambiar la configuración de seguimiento de comprobación, debe disponer de privilegiosCONFIG_AUDIT. CONFIG_AUDIT es un privilegio de usuario ampliado y debe ser concedidopor otro propietario del repositorio u otro superusuario de Documentum TaskSpace o DocumentumWebtop. En la guía del usuario de Documentum Webtop y la Guía de configuración deDocumentum TaskSpace se proporciona información detallada sobre cómo ampliar los privilegiosde usuario.

8. Especifique si desea que los nombres de documentos distribuidos estén disponibles para quelos usuarios los vean.

De forma predeterminada, el paquete distribuido a través de un flujo de trabajo no incluye losnombres de los documentos en el paquete por motivos de seguridad. Si desea almacenar dichosnombres como parte del paquete, a fin de utilizarlos en las instrucciones que se pasen a losparticipantes del flujo de trabajo, marque la casilla Almacenar el nombre de documento en elpaquete en el tiempo de ejecución.

9. Para enviar un mensaje de correo electrónico cuando un temporizador caduca u ocurre otroevento, haga clic en Agregar en el cuadro de grupo Seleccione la plantilla para la notificaciónde eventos.

También puede eliminar una plantilla y un evento del cuadro de grupo seleccionando la filay haciendo clic en Quitar.

10. Seleccione el Evento que desencadenará la notificación en la lista desplegable.11. Haga clic en Haga clic para agregar una plantilla para seleccionar la plantilla de correo

electrónico que el servidor utilizará para enviar notificaciones del evento.• Seleccione la opción Elegir una plantilla existente del repositorio.• O seleccione Crear una nueva plantilla de correo electrónico mediante el Asistente paraplantilla de notificación. Descripción del Asistente para plantilla de notificación, página 131proporciona instrucciones sobre cómo crear una nueva plantilla de correo electrónico.

El servidor utiliza la plantilla de correo electrónico seleccionada para todas las notificaciones delmismo tipo de evento. Si no selecciona ninguna plantilla de correo electrónico, el servidor enviaráuna notificación predeterminada a la bandeja de entrada de Documentum de los usuarios.

12. Para asociar mensajes de correo electrónico personalizados con eventos de flujo de trabajoespecíficos, elija las plantillas de correo electrónico y eventos en el cuadro situado en la parteinferior del cuadro de diálogo.

Puede definir los mensajes que enviará el servidor en respuesta a los eventos relacionados conel proceso. Los usuarios registrados para recibir notificación del evento recibirán un mensajeelaborado con la plantilla de correo electrónico asociada a dicho evento. También puede asociar



plantillas de correo electrónico con eventos como parte de la definición de una actividad. Definirnotificaciones, página 130 proporciona más información sobre este tema.

• Si asocia una plantilla de correo electrónico con una plantilla de proceso, la primera se utilizarásiempre que se produzca el evento en flujos de trabajo creados desde dicha plantilla de proceso.

• Si asocia la plantilla de correo electrónico con la definición de una actividad, la plantilla seutilizará siempre que el evento se produzca durante una instancia de la actividad.

• Si una instancia de flujo de trabajo concreta y una actividad en el mismo flujo de trabajo tienenuna plantilla asociada para el mismo evento, se utilizará la plantilla asociada con la actividad.

a. Haga clic en el botón Agregar para añadir una fila al cuadro de notificación de eventos.

b. Haga clic en la columna Evento de la nueva fila y seleccione un evento de flujo de trabajo en lalista desplegable que aparezca. Los eventos disponibles son:

• dm_changedactivityinstancestate: una actividad automática cambia de estado porque elindicador de control de errores se ha definido como cero y el elemento de trabajo ha devueltoun valor distinto de cero.

• dm_startedworkitem: se genera un elemento de trabajo como parte del flujo de trabajo.

• dm_delegatedworkitem: un usuario delega un elemento de trabajo.

• Vencimiento de pre-temporizador: una actividad no se ha iniciado transcurrida la cantidadde horas designada tras el inicio del flujo de trabajo.

• Vencimiento de post-temporizador: una actividad no ha finalizado transcurrida la cantidadde horas designada tras el inicio de la actividad.

c. Haga clic en la columna Plantilla de correo electrónico de la fila y seleccione la plantilla decorreo electrónico que va a utilizar con el evento elegido en el paso b. Una plantilla de correoelectrónico es un documento en el repositorio de Documentum que define la estructura delmensaje de notificación. Si desea más información sobre la estructura de los documentosque funcionan como plantillas de correo electrónico, consulte la guía Documentum ProcessBuilder Development Guide.

13. Siga uno de estos procedimientos:

• Haga clic en Aceptar para cerrar el cuadro de diálogo.

• Haga clic en la ficha Datos para agregar datos de proceso a la plantilla.

Gestionar datos de procesosLa ficha Datos del cuadro de diálogo Propiedades de proceso muestra una lista de los paquetes,variables de proceso y parámetros de proceso que participan en flujos de trabajo creados desde estaplantilla de proceso. Los datos de proceso pueden constar de:

• Variables de flujos de trabajo

• Variables de proceso

• Parámetros de proceso

• Paquetes



Gestionar los paquetesEn muchos flujos de trabajo, el mismo paquete pasa a través de todas las actividades. Por ejemplo,un flujo de trabajo diseñado para la revisión y aprobación de pedidos de compra pasa el mismodocumento de pedidos de compra como paquete a todas las actividades necesarias. En otros casos, eltrabajo realizado por algunas actividades puede dar lugar a la creación de un documento. Supongamos,por ejemplo, que una actividad acepta un aviso de acción de personal. El ejecutante (un empleadode recursos humanos) debe archivar el aviso y enviar un formulario diferente al departamento decontabilidad. La lista de paquetes del cuadro de diálogo Propiedades de proceso debe incluir todoslos paquetes que participan en el flujo de trabajo, incluidos aquéllos creados o descartados durante elproceso. Al configurar las actividades, debe especificar los paquetes con los que trata cada actividad.Cambiar datos de proceso en una actividad, página 134 proporciona información detallada sobreeste tema.

Para establecer los paquetes para un proceso de negocio:

1. Si el cuadro de diálogo Propiedades de proceso aún no está abierto, seleccione Propiedades deproceso en el menú Herramientas o haga clic en el icono Propiedades de plantilla de la barrade herramientas .

2. Haga clic en la ficha Datos.

3. Para agregar un paquete al proceso empresarial, seleccione el nodo Paquetes en la vista de árbol yhaga clic en el botón + situado sobre la ventana.

El nuevo paquete aparecerá en el árbol bajo el nodo Paquetes y en el cuadro de lista PackageDefinition (Definición de paquete), junto con los controles necesarios para definir el paquete.

4. Escriba el nombre del paquete en el cuadro de texto Nombre.

Elija un nombre que le permita identificar el paquete cuando configure las actividades en elproceso comercial.

Nota: Los nombres del paquete están restringidos a 128 caracteres.

5. En la lista desplegable Versión, seleccione o escriba la versión predeterminada del contenidoque desea utilizar.

Nota: Process Builder se puede configurar para no mostrar la lista Versión. Archivo deconfiguración de Process Builder, página 249 proporciona información detallada sobre este tema.Si la lista no aparece, el flujo de trabajo utiliza siempre la versión ACTUAL.

La versión especificada aparece como la versión predeterminada utilizada para cada actividad quegestiona el paquete. Puede anular la versión al configurar la actividad. Para especificar la versión,puede seleccionar o escribir:

• <Cualquiera>, que significa que puede utilizarse cualquier versión del paquete.

• Un número de versión específico, por ejemplo, 2.5 o 3.0. Si escribe un número de versiónespecífico, el paquete incluirá siempre esa versión del documento.

• Una etiqueta de versión simbólica; por ejemplo, Borrador. Las etiquetas de versión simbólicasdistinguen entre mayúsculas y minúsculas; por lo tanto, asegúrese de que la versión que escribacoincide con la versión del objeto en el repositorio.

• ACTUAL, que es la selección predeterminada. Si selecciona ACTUAL, el paquete siemprecontendrá la versión con la etiqueta ACTUAL, que suele ser la versión más actual del objeto enel repositorio.



Nota: Process Builder se puede configurar para no mostrar la lista Versión. Archivo deconfiguración de Process Builder, página 249 proporciona información detallada sobre este tema.Si la lista no aparece, el flujo de trabajo utiliza siempre la versión ACTUAL.

6. Elija el tipo de objeto del objeto incluido en el paquete seleccionándolo en la lista desplegable Tipo.

Nota: Process Builder se puede configurar para no mostrar la lista Tipo. Archivo de configuraciónde Process Builder, página 249 proporciona información detallada sobre este tema. Si la listaTipo no aparece o si desea que Process Builder seleccione el tipo de objeto según la plantillade formulario elegida, vaya al paso siguiente.

Lo más habitual es que el tipo de objeto de un paquete sea un documento o un documentopersonalizado que el usuario haya creado. Consulte el manual Documentum Content ServerReference Guide para obtener una descripción de los tipos de objeto.

7. Para asociar una plantilla de formulario al paquete, selecciónela en la lista desplegable Formulario.

Una plantilla de formulario define una interfaz de usuario personalizada para los usuarios quegestionen este paquete durante el flujo de trabajo. Consulte Asociar plantillas de formulario conpaquetes, página 33 para obtener más información sobre el uso de formularios y plantillas deformulario. Para aparecer en la lista, el formulario debe estar en un estado instalado. La plantillapara formulario especificada aquí aparece como la plantilla predeterminada utilizada para cadaactividad que gestiona el paquete. Puede anular la plantilla de formulario al configurar la actividad.

Nota: Si elige una plantilla de formulario antes de definir el tipo de objeto del paquete, ProcessBuilder mostrará todas las plantillas disponibles en la lista desplegable y definirá el tipo de objetodel paquete según la plantilla que seleccione.

a. Seleccione un formulario existente en la lista desplegable Formulario. La lista muestrasólo aquellas plantillas de formulario cuyo modelo de datos coincida con el tipo de objetoseleccionado en el paso 5. Si la plantilla de formulario deseada no aparece, asegúrese de queseleccionó el tipo de objeto correcto en el paso 5.

b. Para crear una nueva plantilla de formulario o editar la seleccionada, haga clic en el botón conel icono de Forms Builder para iniciar Forms Builder. La guía Documentum Forms BuilderUser Guide proporciona más información sobre cómo crear formularios personalizados parasu flujo de trabajo.

8. Para que el formulario seleccionado muestre las propiedades del paquete, active la casilla deverificación Usar formulario para propiedades.

Si la casilla de verificación Usar formulario para propiedades no está activada, el formulariodel paso 7 aparece cuando el ejecutante de una actividad selecciona el paquete desde su bandejade entrada. El formulario se utiliza para guardar el contenido del paquete. Cuando la casilla deverificación está activada, el formulario aparece cuando el ejecutante ve las propiedades delpaquete. El formulario se utiliza para establecer las propiedades del paquete en el repositorio,no el contenido del paquete.

Nota: La opción Usar formulario para propiedades sólo está disponible para las plantillas deformulario cuya opción de asignación de almacenamiento se ha definido como Store in Repositoryattributes (Almacenar en atributos del repositorio). Consulte la guía Documentum Forms BuilderUser Guide si necesita información sobre esta opción de asignación de almacenamiento.

9. Para impedir que Process Builder haga que este paquete esté visible para todas las actividades deforma predeterminada, desactive la casilla de verificación Visible durante todo el proceso.



De forma predeterminada, Process Builder hace que el paquete sea visible para todas las actividadesdel proceso comercial, asumiendo que el paquete fluirá por todo el proceso. Una vez desactivadaesta casilla, el paquete sólo será visible en las actividades a las que lo agregue de forma explícita.

Nota: Si selecciona un paquete existente que es visible en algunas actividades y no en otras, lacasilla de verificación aparecerá como no disponible. Para restablecer todas las actividades demodo que tengan el mismo valor, haga clic en el enlace Cambiar configuración de nivel deactividad y, en el cuadro de diálogo que aparecerá a continuación, haga clic en Sí.

10. Para solicitar que el paquete tenga un documento u otro contenido asociado, active la casilla deverificación Éste es un paquete obligatorio.

Nota: Si selecciona un paquete existente que es obligatorio en algunas actividades y opcional enotras, la casilla de verificación aparecerá como no disponible. Para restablecer todas las actividadesde modo que tengan el mismo valor, haga clic en el enlace Cambiar configuración de nivel deactividad y, en el cuadro de diálogo que aparecerá a continuación, haga clic en Sí.

11. Para permitir que Process Builder publique los datos de informes en la base de datos de BAM delpaquete, seleccione Este paquete se puede utilizar para generar informes.

12. Haga clic en Aplicar para agregar el paquete al cuadro de lista.13. Para agregar otro paquete al flujo, repita los pasos 3 a 11.

Configure cada actividad para especificar los paquetes que gestionará, empezando con la actividadde inicio y avanzando a través del proceso comercial.

Consulte Cambiar datos de proceso en una actividad, página 134.

Gestionar las variables de procesoLas variables de proceso representan distintos tipos de datos que circulan por el proceso comercial.Puede tratarse de tipos de datos simples (como una cadena, un valor booleano o una fecha) ocomplejos, es decir, grupos de datos relacionados lógicamente como pedidos, componentes defabricación, etc. Las variables de proceso se pueden agrupar en conjuntos de atributos de tipos de datosrelacionados lógicamente que se pueden reutilizar en el repositorio.

Estas variables de proceso, o tipos de datos estructurados, están disponibles en la ventana Tipos dedatos estructurados y se pueden utilizar en varias plantillas de proceso de un repositorio.

Por ejemplo, puede crear una variable de proceso approved, que es un valor booleano, y asociarla alflujo de proceso. Puede diseñar a continuación un formulario de Forms Builder con botones de opciónque representen el valor para el campo aprobado y asociarlo al flujo de proceso.

Para establecer las variables de proceso para un proceso de negocio:1. Si el cuadro de diálogo Propiedades de proceso aún no está abierto, seleccione Propiedades de

proceso en el menú Herramientas o haga clic en el icono Propiedades de plantilla de la barrade herramientas .

2. Haga clic en la ficha Datos.3. Para agregar una variable de proceso al proceso comercial, seleccione el nodo Process Variables

(Variables de proceso) en la vista de árbol y haga clic en el botón + situado sobre la ventana.

La nueva variable aparecerá en el árbol bajo el nodo Process Variables (Variables de proceso) yen el cuadro de lista Definición de paquete, junto con los controles necesarios para definir lavariable de proceso.



4. Escriba el nombre de la variable en el cuadro de texto Nombre (puede contener un máximo de255 caracteres).

Elija un nombre que le permita identificar la variable cuando configure las actividades en elproceso comercial.Nota: Si cambia el nombre de una variable que ya está definida en el repositorio, este cambio sóloafecta a la variable dentro del proceso. No afecta al nombre del tipo de datos estructurado en elrepositorio. Éste conservará su nombre original.

5. Seleccione un tipo de datos en el campo Tipo.

Los valores válidos son: cadena, entero, flotante, fecha y booleano.

También puede elegir un tipo de datos estructurado en Tipos de datos estructurados; para ello,seleccioneMore Values (Más valores) y desplácese por el árbol de tipos de datos estructurados enel cuadro de diálogo Choose Type (Seleccionar tipo).

Nota: Las variables de proceso que son cadenas tienen una longitud máxima de 2.000 caracteres.

6. Según el tipo de datos que haya definido, escriba un Valor predeterminado, si fuera necesario.

7. Para asociar esta variable a una LCA, haga clic en Examinar y seleccione una LCA en la lista.

Nota: Una LCA asignada a una variable de proceso individual anula la LCA del nivel de proceso,si hay una asignada al proceso en la ficha Avanzada.

Establecer las opciones de la Lista de control de acceso (LCA), página 70 proporciona másinformación sobre las Listas de control de acceso.

8. Haga clic en Aplicar para guardar la definición de la nueva variable.

9. Para agregar otra variable al flujo, repita los pasos 3 a 11.

10. Haga clic en Aceptar para guardar las actualizaciones y cerrar el cuadro de diálogo.

Configure cada actividad para especificar las variables que gestionará, empezando con la actividad deinicio y avanzando a través del proceso comercial.

Cambiar datos de proceso en una actividad, página 134 proporciona más información sobre cómoconfigurar los datos de proceso dentro de una actividad.

Gestionar parámetros de procesoLos parámetros de proceso permiten a los administradores de la aplicación modificar valores constantesque se utilizan a lo largo de un proceso. Los parámetros que se definen dentro de un proceso estándisponibles a todas las actividades contenidas en el proceso.

El administrador puede cambiar los valores del parámetro en la ficha Administration en TaskSpacey cualquier nueva instancia de proceso, elementos de trabajo y variables dentro del flujo de trabajoutilizan el valor actualizado.

Introducción a los datos de proceso, página 31 proporciona información de información generalsobre parámetros de proceso.

Nota: al migrar parámetros de procesos, Documentum Composer crea para cada uno de ellos unparámetro de instalación correspondiente. El valor predeterminado se establece en el valor delrepositorio de origen. Delante del nombre del parámetro de instalación aparece el nombre del procesoseguido del nombre del parámetro de proceso: NombreProceso_NombreParámetroProceso0.parámetro.



En la Guía del usuario de Documentum Composer se proporciona información detallada sobre cómoutilizar los parámetros de instalación en proyectos de Documentum Composer.

Para establecer los parámetros de proceso de un proceso de negocio:


2. Haga clic en la ficha Datos.

3. Para agregar parámetros de proceso al proceso comercial, seleccione el nodo Parámetros deproceso en la vista de árbol y haga clic en el botón Agregar + situado sobre la ventana.

El nuevo parámetro aparece en el árbol bajo el nodo Variables de proceso y en el cuadro de listaParámetro de proceso, junto con los controles necesarios para definir el parámetro.

4. Escriba el nombre del parámetro en el cuadro de texto Nombre (puede contener un máximo de255 caracteres).

Elija un nombre que le permita identificar el parámetro cuando configura las actividades delproceso comercial o en la ficha Administración de TaskSpace. No se permiten espacios ycaracteres especiales en el nombre de parámetro.

5. Seleccione un tipo de datos en el campo Tipo.

Los valores válidos son: cadena, entero, flotante, fecha y booleano.

6. Introduzca una descripción de la edición.

7. Según el tipo de datos que haya definido, escriba un Valor constante. Los administradores de laaplicación pueden cambiar este valor en la ficha Administration en TaskSpace.

Anular configuración de nivel de actividad

La configuración creada en la ficha Datos del cuadro de diálogo Propiedades de proceso es unaconfiguración global que se aplica a todo el proceso. La configuración de muchas de las propiedades sepuede editar en el nivel de actividad, creando una mezcla de estados para ese ajuste específico. Porejemplo, un paquete se puede configurar para que se pueda incluir en informes en el nivel de proceso;sin embargo, puede tener la opción de inclusión en informes modificada en una actividad específica.Cuando la actividad tiene una configuración diferente a la global especificada en el proceso, puedeoptar por sobrescribir la configuración de nivel de actividad.

Para anular la configuración de nivel de actividad de un proceso:

1. En la ficha Datos del cuadro de diálogo Propiedades de proceso, seleccione el enlace Cambiarconfiguración de nivel de actividad.

2. En el cuadro de diálogo Cambiar configuración de nivel de actividad, el sistema muestra todaslas actividades cuya configuración difiere de las propiedades de proceso globales.

3. Para anular la configuración, seleccione el nombre de la actividad y haga clic en Sí.

La actividad hereda la configuración global asignada en el proceso.



Configurar las opciones avanzadasLa ficha Avanzada del cuadro de diálogo Propiedades de proceso permite establecer permisosen todo el proceso o variables individuales asociadas al flujo de proceso. También puede crear losconjuntos de correlación que hacen coincidir los atributos de un mensaje entrante procedente de unorigen externo con los datos de proceso de la actividad.

Establecer las opciones de la Lista de control deacceso (LCA)

Un conjunto de permisos (también conocido como una lista de control de acceso o LCA), define lospermisos del nivel de objeto aplicados a objetos a los que se asignan los conjuntos de permisos. Losconjuntos de permisos especifican qué acceso tiene cada usuario a un elemento determinado delrepositorio, como un archivo o carpeta. El propietario de los elementos del repositorio asigna a cadauno de ellos un conjunto de permisos. El conjunto de permisos define los permisos del ámbito delos objetos que se aplican a un objeto.

Al crear una nueva plantilla, el nuevo proceso así como los objetos de actividad confían en la LCApredeterminada del usuario o en la LCA predeterminada de la carpeta principal, dependiendo de laconfiguración del repositorio. Puede configurar la LCA para el proceso y la actividad desde dentrode Process Builder para asegurarse de que cada usuario tiene el acceso correcto a los elementos delflujo de trabajo.

Si un ejecutante de la tarea no tiene al menos permiso de lectura para el proceso, recibirá la tarea en subandeja de entrada y podrá abrirla, pero no podrá finalizar la tarea. Si un ejecutante de la tarea notiene al menos permiso de lectura de las variables de proceso, no podrá verlas en TaskSpace o en subandeja de entrada. Si un ejecutante de la tarea no tiene permisos de escritura, no podrá modificar lasvariables de proceso

LaGuía del usuario de Documentum Administrator proporciona información sobre cómo usar las LCA.

Tabla 5 Requisitos de permiso para un proceso

Usuario Nivel de permiso mínimo

Creador del proceso Escribir

Creador del flujo de trabajo Relacionar, Ejecutar _procedure

Supervisor del flujo de trabajo Relacionar

Ejecutantes de la tarea Leer

Tabla 6 Requisitos de permiso para las variables de proceso


Creador del proceso Escribir

Creador del flujo de trabajo Escribir




Supervisor del flujo de trabajo Escribir

Ejecutantes de la tarea Escribir

Para seleccionar LCA:


2. Haga clic en la ficha Avanzada.3. Para aceptar la LCA de variables de proceso de BPM predeterminada, haga clic en

Predeterminado.4. Para cambiar la LCA para todas las variables de proceso, haga clic en Examinar.

Aparecerá el cuadro de diálogo Selector de LCA.a. Seleccione una LCA que sea propiedad del Sistema o de un Usuario.

La lista de LCA cambiará en función de lo que elija. Las LCA del sistema puede utilizarlascualquier usuario del repositorio y las gestiona el propietario del repositorio. Las otras LCApueden gestionarlas sus propietarios o los usuarios con privilegios de administrador del sistema(Sysadmin) o de superusuario.

b. Resalte la LCA que se va a utilizar en todas las variables de proceso.

De manera predeterminada, el servidor define la LCA para la variable. Los permisos asociadosy la descripción de la LCA aparecen en el cuadro de diálogo.

c. Haga clic en Aceptar.

Nota: Una LCA asignada a una variable de proceso individual en la ficha Datos de la plantillade proceso anula la LCA del nivel de proceso.

5. Para permitir que el servidor elija la LCA correcta para el proceso, haga clic en Predeterminado.6. Para cambiar la LCA predeterminada del proceso, haga clic en Examinar y seleccione una LCA.

a. Puede seleccionar una LCA que sea propiedad del Sistema o de un Usuario.

La lista de LCA cambiará en función de lo que elija. Las LCA del sistema puede utilizarlascualquier usuario del repositorio y las gestiona el propietario del repositorio. Las otras LCApueden gestionarlas sus propietarios o los usuarios con privilegios de administrador del sistema(Sysadmin) o de superusuario.

b. Resalte la LCA que se va a utilizar en el proceso.

Los permisos asociados y la descripción de la LCA aparecen en el cuadro de diálogo.c. Haga clic en Aceptar.

Seleccionar un calendario para el procesoSe puede requerir a los diseñadores de proceso que implementen procesos comerciales que estánbasados en distintos períodos de tiempo o en horas de trabajo que los encontrados en el calendario delsistema estándar. En Documentum Webtop o TaskSpace, los diseñadores pueden crear calendariosbasados en calendarios laborales regionales, días festivos específicos del país o cualquier otra



restricción temporal exclusiva. De esta forma, los temporizadores y notificaciones de un proceso secalculan en función de un calendario concreto en lugar del calendario del sistema.

Nota: Cuando una tarea llega a la bandeja de entrada del usuario, la fecha de vencimiento de la tarease puede calcular basándose en el calendario del sistema. La siguiente vez que se ejecuta el trabajo deltemporizador, el trabajo actualiza la fecha de vencimiento según el calendario comercial.

Para seleccionar un calendario para un proceso:1. Si el cuadro de diálogo Propiedades de proceso aún no está abierto, seleccione Propiedades de

proceso en el menú Herramientas o haga clic en el icono Propiedades de plantilla de la barrade herramientas .

2. Haga clic en la ficha Avanzada.3. Seleccione un calendario en el cuadro de lista.

La lista de calendarios refleja todos los calendarios situados en la carpeta Sistema/Flujo detrabajo/Calendarios.Nota: Si los distintos calendarios diferentes están seleccionados tanto para un proceso como parauna actividad dentro de ese proceso, el sistema utiliza el calendario de la actividad.

Asignar un formulario de parámetros de procesoUn formulario de parámetros de proceso crea una página para que un administrador modifiquelos valores constantes que se utilizan a lo largo del proceso. Los administradores realizan estasmodificaciones en un formulario de Documentum Form al que acceden desde la ficha Administraciónde TaskSpace. Cualquier nueva instancia de proceso, elementos de trabajo y variables dentro del flujode trabajo utilizan el valor actualizado.

Para habilitar esta opción, se asigna o se crea un formulario de parámetros de proceso para habilitar laadministración de los parámetros y asignarla al proceso.

Para asignar un formulario de administración de proceso:1. En la lista desplegable Formulario, elija el formulario de parámetros de proceso que se utilizará

para mostrar los parámetros de proceso al administrador de TaskSpace.2. Haga clic en el botón Actualizar para recuperar todos los formularios disponibles del repositorio.

Esta acción busca en el repositorio los formularios de administración guardados.3. Para crear un nuevo formulario de parámetros de proceso, siga estos pasos:

a. Haga clic en el botón para iniciar Forms Builder.b. Utilice Forms Builder para crear un formulario para la actividad.

Consulte la guía Documentum Forms Builder User Guide si necesita información sobre lacreación de formularios.

En la guía Documentum TaskSpace Configuration Guide se proporciona más información sobre cómoadministrar procesos en TaskSpace.

Crear los conjuntos de correlaciónProcess Builder debe poder hacer coincidir un mensaje entrante con una instancia única de un flujo detrabajo para procesar los datos entrantes. Los conjuntos de correlación son colecciones de variables



de proceso que se definen para una actividad que permite al sistema comparar un mensaje con unainstancia de proceso.

Los conjuntos de correlación se crean en el nivel de proceso en función del tipo de información queestará recibiendo de las plantillas de actividad de los mensajes entrantes. Esto incluye el uso detipos de datos estructurados que se han definido con el repositorio. Puede crear varios conjuntosde correlación para un proceso, aunque una actividad sólo se puede asociar con un conjunto decorrelación. Introducción a la correlación de mensajes, página 155 proporciona más detalles acerca decómo utilizar los conjuntos de correlaciones para que los mensajes de orígenes externos coincidan conlos datos de proceso.

Para crear un nuevo conjunto de correlación:


2. Haga clic en la ficha Avanzada.3. En el cuadro de grupo Conjunto de correlación, seleccione el nodo raíz Conjunto de correlación

y haga clic en el botón Agregar (+) para crear un nuevo conjunto de correlación en el árbol.4. Para crear un nombre para el conjunto de correlación, haga clic con el botón secundario el nuevo

nodo y seleccione Editar nombre de conjunto.

Aparecerá el cuadro de diálogo Editar etiqueta.5. Escriba el nuevo nombre del conjunto de correlación y haga clic en Aceptar.

Los nombres del conjunto de correlación se limitan a 128 caracteres.6. Para agregar un atributo al conjunto de correlación, resalte el nombre del conjunto y haga clic

en .

La nueva propiedad indefinida se agrega al árbol.7. Haga clic con el botón secundario en el atributo y seleccione Editar modelo de correlación.

Aparece el cuadro de diálogo Correlación mostrando las variables de proceso asociadas al proceso.8. Seleccione una variable de proceso del árbol de variables y haga clic en Aceptar.

Nota: Sólo los datos de proceso guardados aparecen en el árbol. Si agrega una variable a la fichaDatos, no aparecerá en el árbol hasta después de haberla guardado.

9. Repita estos pasos agregando diferentes conjuntos de correlación y sus variables relacionadas.10. Haga clic en Aceptar.

Habilitar servicios Web entrantesSi una actividad de servicio Web entrante está incluida en el proceso, debe escribir el URI del espaciode nombres de destino para la ubicación del WSDL. Si hay varias actividades de servicio Web dentrodel proceso, utilizan el mismo espacio de nombres de destino.

Nota: Si hay actividades entrantes del servicio Web dentro del proceso, este campo debe completarseo el sistema no podrá validar el proceso.

Para habilitar los servicios Web entrantes:

1. Escriba el URI del espacio de nombres de destino para el WSDL.



2. Haga clic en Aplicar.

Guardar plantillas de procesoUna vez finalizada una plantilla de proceso, debe guardarla para poder validarla e instalarla. Al guardarla plantilla, se copian los cambios en el repositorio.

El proceso de almacenamiento varía en función de si guarda los cambios en una plantilla existente,guarda una plantilla nueva o guarda una plantilla con un nombre nuevo.

Para guardar los cambios en una plantilla existente como la misma versión, debe tener por lo menospermiso de escritura en la plantilla y debe estar trabajando con un borrador o una plantilla validada.Una plantilla que esté instalada debe desinstalarse primero para guardarla como la misma versión.Si las opciones de Guardar aparecen como no disponibles en el menú Archivo, posiblemente laplantilla ya se habrá instalado.

El estado actual de la plantilla aparece en la barra de título de Process Builder. La barra de títulotambién indica si la plantilla está retirada y el nombre de usuario del propietario del bloqueo, siotro usuario ha retirado la plantilla.

Process Builder se puede configurar para forzar nombres únicos o ubicaciones de carpeta específicaspara las plantillas de proceso. Archivo de configuración de Process Builder, página 249 proporcionainformación detallada sobre este tema. De forma predeterminada, sin embargo, las plantillas deproceso se pueden guardar en cualquier ubicación del repositorio y sus nombres deben ser exclusivossolamente dentro de la carpeta.

Para guardar una nueva plantilla de proceso o guardar una existente con un nuevo nombre:

1. En el menú Archivo, seleccione Guardar como.

Aparece el cuadro de diálogo Guardar plantilla de proceso como.

Nota: Si la plantilla de proceso actual es nueva y no se ha guardado previamente, al seleccionarGuardar, también se muestra el cuadro de diálogo Guardar plantilla de proceso como.

2. Escriba un nombre para la plantilla de proceso.

Los nombres de la plantilla de proceso deben tener menos de 80 caracteres. No se permitennombres más largos en Business Activity Monitor e interferirán con la supervisión del proceso.

3. A fin de crear una carpeta en la que almacenar la plantilla y los objetos asociados a ella, asegúresede que ha marcado la casilla de verificación Crear nueva carpeta para elementos asociados.

La casilla está marcada de forma predeterminada. Process Builder guarda la plantilla y susactividades en una carpeta con el mismo nombre que la plantilla, dentro de la carpeta queseleccione en el siguiente paso.

Si no está activada la casilla de verificación, desplácese a la carpeta en la que desea guardarla plantilla. Para ello, haga doble clic en los archivadores y directorios del cuadro de diálogoGuardar en hasta que se haya resaltado el nombre de la carpeta.

La ruta completa hasta la carpeta aparece en el cuadro de texto situado en la parte inferior delcuadro de diálogo.




Si cuenta con los permisos correspondientes en la carpeta seleccionada, Process Builder guarda laplantilla y sus actividades.

Si ha definido que se solicite confirmación para la instalación y validación, se muestra uncuadro de diálogo en el que se le pregunta si desea validar la plantilla. (En el cuadro de diálogoPreferencias se activan y desactivan las preguntas de instalación y validación. Definir propiedadesde la plantilla de proceso, página 62 proporciona más información sobre este tema).

5. Elija si desea validar la plantilla de proceso.

Consulte Validar plantillas de proceso, página 76 si necesita más información sobre la validaciónde plantillas. Si elige validar la plantilla, Process Builder intentará la validación. Si se produceun error, aparece un cuadro de diálogo notificándoselo. Haga clic en el botón Detalles para verel error que impidió la validación.

Si, por el contrario, la validación es correcta, aparece un cuadro de diálogo en el que se le preguntasi desea instalar la plantilla para que se encuentre disponible para los usuarios.

6. Elija si desea instalar la plantilla de proceso.

Consulte Instalar plantillas de proceso, página 77 si precisa más información sobre la instalaciónde plantillas.

Guardar plantillas de proceso desprotegidasPara guardar una plantilla de proceso actualizada que está retirada:

1. En el menú Archivo, seleccione Guardar.

Si la plantilla de proceso actual se ha guardado previamente y está retirada, Process Builderactualiza el archivo guardado.

Proteger plantillas de proceso, página 80 proporciona más información acerca de cómo registraruna plantilla.

2. Si cuenta con los permisos correspondientes en la carpeta seleccionada, Process Builder guardala plantilla y sus actividades. Si ha definido que se solicite confirmación para la instalación yvalidación, se muestra un cuadro de diálogo en el que se le pregunta si desea validar la plantilla.

Consulte Validar plantillas de proceso, página 76 si necesita más información sobre la validaciónde la plantilla.

Guardar plantillas de proceso que no estándesprotegidasPara guardar una plantilla de proceso actualizada que no está retirada:

1. Seleccione Archivo > Guardar o haga clic en el botón Guardar para guardar los cambiosrealizados en la versión actual.


Si cuenta con los permisos correspondientes en la carpeta seleccionada, Process Builder guardala plantilla y sus actividades. Si ha definido que se solicite confirmación para la instalación yvalidación, se muestra un cuadro de diálogo en el que se le pregunta si desea validar la plantilla.



3. Elija si desea validar la plantilla de proceso.

Consulte Validar plantillas de proceso, página 76 si necesita más información sobre la validaciónde plantillas. Si elige validar la plantilla, Process Builder intentará la validación. Si se produceun error, aparece un cuadro de diálogo notificándoselo. Haga clic en el botón Detalles para verel error que impidió la validación.

Si, por el contrario, la validación es correcta, aparece un cuadro de diálogo en el que se le preguntasi desea instalar la plantilla para que se encuentre disponible para los usuarios.

4. Elija si desea instalar la plantilla de proceso.


Validar plantillas de procesoLa validación de una plantilla comprueba que el proceso definido en la plantilla cumple los requisitosdel sistema. La ficha Validación de procesos aparece al validar una plantilla con errores. Si no hayerrores en el proceso, la ficha no aparece y puede continuar instalando el proceso en el repositorio oelegir seguir trabajando en él.

Solamente se puede realizar la validación si la plantilla abierta tiene el estado borrador y el usuariocuenta con el permiso de escritura.

Puede invocar el proceso de validación desde el depurador de proceso y ver ambas fichas al mismotiempo para poder solucionar los problemas de un proceso.

En esta ficha muestra un árbol de actividades y todos los errores asociados a cada una de lasactividades. Si hace clic en el error de una actividad en el árbol, se abrirá la actividad asociada en lapantalla del diseño, permitiéndole corregir el error en el momento de la validación. Utilice los botonesde control para ampliar y contraer el árbol, cerrar la ficha de validación o exportar una vista previa delárbol de errores a un archivo de texto. Este archivo contiene una representación en forma de texto delárbol de validación que se puede copiar en un editor de texto o guardar en una ubicación en el sistema.

Cuando se validan plantillas de proceso, se verifica que:

• Las actividades a las que se hace referencia cuentan con nombres únicos en la plantilla.

• Existe una actividad de inicio como mínimo y sólo una de finalización.

• Existe una ruta a través del flujo de trabajo desde cada actividad a la actividad de finalización.

• Todos los objetos a los que se hace referencia existen de forma local.

• Las actividades automáticas tienen un método seleccionado.

Para validar una plantilla de proceso:

1. En el menú Herramientas, seleccione Plantilla de proceso.

2. Seleccione Validar.

Si hay errores en el proceso, aparecerá la ficha Validación de procesos junto con una lista de loserrores del proceso.

3. Si, por el contrario, la validación es correcta, aparece un cuadro de diálogo en el que se le preguntasi desea instalar la plantilla para que se encuentre disponible para los usuarios.



Adicionalmente, si ha definido que se solicite confirmación para la instalación y validación,siempre que guarde una plantilla aparecerá un cuadro de diálogo donde se le pregunta si deseavalidar la plantilla. En el cuadro de diálogo Propiedades de plantilla se activan y desactivan laspreguntas de instalación y validación. Definir propiedades de la plantilla de proceso, página 62proporciona más información sobre este tema.

Instalar plantillas de procesoLas plantillas de proceso se deben instalar antes de que puedan estar disponibles para su uso en un flujode trabajo activo. Solamente puede instalar una plantilla si tiene el estado validado y el usuario cuentacon el permiso de escritura. El estado actual de la plantilla abierta aparece en la barra de título de laventana Process Builder. Si no está validada, seleccione Plantilla de proceso > Validar en el menúHerramientas. Consulte Validar plantillas de proceso, página 76 para obtener más información.

Si necesita realizar cambios en una plantilla instalada, primero debe desinstalarla, página 77. Sedetendrán todos los flujos de trabajo activos basados en la plantilla. Una vez realizados los cambios,vuelva a validar e instalar la plantilla.

Cuando vuelva a instalar la plantilla, podrá elegir la forma en la que desea tratar los flujos de trabajodetenidos durante la desinstalación. Podrá optar por:

• Reanudar los flujos de trabajo detenidos en el punto desde el que se detuvieron

• Anular los flujos de trabajo

Sus opciones elegidas dependerán de los cambios realizados en el flujo de trabajo. Quizás eliminó unaactividad o agregó una actividad que desea realizar en todos los objetos del flujo de trabajo, o modificólas condiciones de la transición. En cualquiera de estos casos, cancele los flujos de trabajo y reinícielos.Para eliminar un flujo de trabajo en ejecución, debe anular el flujo de trabajo y elegir la opción paradestruir los objetos en tiempo de ejecución en Webtop. El comportamiento predeterminado consiste enreanudar todos los flujos de trabajo detenidos que hagan referencia a dicha plantilla.

Para instalar plantillas de proceso:

1. En el menú Herramientas, seleccione Plantilla de proceso > Instalar.

Si la opción Instalar no se encuentra disponible, significa que la plantilla ya está instalada oque no se ha guardado o validado.

2. Si existen flujos de trabajo detenidos basados en esta plantilla de proceso, tendrá la posibilidad dereanudarlos o de detenerlos. Haga clic en una de las siguientes opciones:• Haga clic en Sí para reanudar los flujos de trabajo detenidos. Si reanuda un flujo de trabajodetenido que esté basado en una plantilla de proceso en la que ha realizado cambios importantes,las incompatibilidades entre la plantilla antigua y la modificada pueden ocasionar que el flujo detrabajo adopte un estado sin definir.

• Haga clic en No para anular los flujos de trabajo detenidos.

Desinstalar plantillas de procesoPara desinstalar plantillas de proceso:

1. En el menú Herramientas, seleccione Plantilla de proceso > Desinstalar.



Solamente puede desinstalar una plantilla si tiene el estado instalado y el usuario cuenta conpermiso de escritura.

Si algún usuario está ejecutando flujos de trabajo que estén basados en esta plantilla, aparece unmensaje indicándole que hay instancias activas del flujo de trabajo.

2. En caso de que aparezca este mensaje, haga clic en Sí para detener los flujos de trabajo o enNo para cancelar el proceso de desinstalación.

3. Haga clic en Sí para desinstalar esta plantilla de proceso y todas sus actividades.

4. Haga clic en Aceptar para cerrar el cuadro de diálogo que indica que el proceso ha finalizado.

Modificar plantillas de procesoPara cambiar una plantilla de proceso, modifique su flujo de procesos o sus definiciones de actividad.Siempre que cambie una plantilla, podrá sobrescribirla con los cambios o crear otra versión de lamisma. Todos los cambios realizados se rigen por los permisos del ámbito de los objetos.

Para realizar cambios en una plantilla y guardarlos sin crear otra versión, debe desinstalarla. Ladesinstalación de una plantilla requiere que se disponga del permiso Relacionar o de privilegios deadministrador del sistema o superusuario. Para guardar los cambios, necesita el permiso de escritura.

Si desea crear una versión de una plantilla de proceso, debe retirarla antes de comenzar a modificarla.Debe disponer del permiso Versión como mínimo. Puede crear otra versión de una plantilla sindesinstalar la actual. La creación de otra versión no afectará a los flujos de trabajo en ejecución queestén basados en la versión anterior de la plantilla.

Al guardar o registrar los cambios, el servidor define la nueva versión con el estado borrador. La nuevaversión se debe validar e instalar antes de iniciar un flujo de trabajo basado en ella.

Consulte también Guardar plantillas de proceso, página 74.

Plantillas de proceso para registrar, retirar ycrear versionesPara bloquear y editar una plantilla de proceso existente, retírela utilizando Process Builder. Cuandose abre el proceso para su edición, el sistema bloquea el archivo para que nadie más pueda realizarcambios en él. Al finalizar el proceso de edición y registrar una plantilla de proceso cambiada,modifique la etiqueta de la versión y conservar un historial actualizado de todos los cambios realizadosen la plantilla de proceso. Asimismo, al registrarlo se desbloqueará la plantilla para que otros usuariospuedan modificarla.

Cuando se retira una plantilla de proceso, el icono en el cuadro de diálogo Abrir plantilla de procesorefleja que está bloqueada por otro usuario. Para ver el nombre de usuario del propietario del bloqueo,coloque el cursor sobre el icono.



Tabla 7 Estados de la plantilla de proceso e iconos relacionados

Estado Icono

Retirado por usted (bloqueado)

Registrado (desbloqueado)

Una plantilla siempre recibe el número de versión 1.0 cuando se crea por primera vez. Al registrar unaplantilla después de haberla modificado, puede decidir si registrar el archivo como una nueva versión ocomo la misma versión. Al registrar una plantilla en el repositorio, el sistema le pide que seleccione sidesea aumentar el número de versión en un número entero o mediante un separador decimal (por unadécima). Aumentar el número de versión en un número entero se considera una revisión principal.Aumentar mediante un separador decimal es una revisión menor. El sistema marca el archivoregistrado más recientemente como ACTUAL. Si decide volver a registrar el archivo sin aumentar elnúmero de versión, la plantilla mantiene el mismo número de versión como la plantilla original y elsistema sobrescribe la plantilla original con los cambios que simplemente ha realizado y lo etiquetacomo ACTUAL. Al retirar una plantilla, puede decidir ver sólo la versión actual o todas las versiones.

Registrar y retirar los procesos en el repositorio utilizando Process Builder es muy similar a registrary retirar los documentos en otras aplicaciones de Documentum. Una diferencia muy importantees que una plantilla de proceso se puede instalar y utilizar al retirarla. Para modificar una plantillaexistente y guardarla como la misma versión (ACTUAL), debe desinstalar primero la plantilla (loque detiene todas las instancias de la plantilla en el entorno de tiempo de ejecución). Esto le evitarealizar cambios en una plantilla cuando se utiliza en el entorno en tiempo de ejecución. Despuésde desinstalar el proceso, es libre para realizar cambios en él, registrarlo como la misma versióny, a continuación, validar e instalar la plantilla.

Nota: Durante el momento en que se desinstala la plantilla, el sistema detiene todas las instancias enejecución del flujo de trabajo e impide que se inicie cualquier nueva instancia. Una vez instalada denuevo la plantilla, puede cancelar o reanudar las instancias detenidas, dependiendo de la complejidadde los cambios realizados en la plantilla. Las modificaciones realizadas en las plantillas existentesdeberían limitarse a cambios menores de propiedades de actividad que no utilice actualmente lainstancia o a cambios relacionados con las actividades futuras de la instancia. Para eliminar un flujode trabajo en ejecución, debe anular el flujo de trabajo y elegir la opción para destruir los objetosen tiempo de ejecución en Webtop.

Si retira una plantilla instalada sin desinstalarla primero, cualquier instancia en ejecución del procesocontinúa ejecutándose, utilizando la versión existente de la plantilla (etiquetada como ACTUAL). Laversión de la plantilla que está editando se abre como un borrador y sólo se le permite guardar yregistrar la plantilla como una nueva versión menor o mayor. Una vez registrada, validada e instalada,la nueva versión de la plantilla puede utilizarse en el entorno en tiempo de ejecución. Todas lasinstancias de proceso creadas usando la versión anterior continuarán ejecutándose hasta que hayanfinalizado. La guía Documentum Administrator User Guide proporciona información más concretasobre cómo utilizar las versiones.

Cancelar una retirada desbloquea la plantilla de proceso y descarta todos los cambios realizados en laplantilla de proceso durante el momento en que se retiró. El repositorio mantendrá la última versiónde la plantilla como la versión actual.



Desproteger plantillas de proceso

Nota: Se considera una buena práctica utilizar Documentum Process Builder únicamente para retiraruna plantilla de proceso.Para retirar una plantilla de proceso:

1. En el menú Archivo, seleccione Abrir para mostrar el cuadro de diálogo Abrir plantilla deproceso.

Nota: Para retirar un proceso que ya está abierto en el panel del editor, haga clic en o seleccioneArchivo > Retirar en el menú.

2. En el cuadro Ver, siga uno de estos procedimientos:

• Seleccione la opciónMostrar TODAS las versiones para mostrar todas las versiones existentes.

• Seleccione Mostrar versiones actuales para mostrar sólo esas versiones de la plantillaetiquetadas como ACTUAL.

3. En el cuadro Seleccionar una plantilla de proceso, explore y seleccione una plantilla.

Si otro usuario retira la plantilla, aparece un icono de bloqueo junto al nombre de la plantilla. SólopuedeMostrar una versión de sólo lectura de la plantilla hasta que se registra por el propietariodel bloqueo.

4. Para retirar la plantilla cuando se abre, seleccione Retirar proceso al abrir.

Nota: Si la plantilla está instalada, el sistema muestra un mensaje ofreciendo la opción dedesinstalar primero la plantilla o continuar con la retirada sin desinstalar la plantilla. Una plantillainstalada sólo se abre como una plantilla de borrador y sólo puede guardarse como nuevaversión mayor o menor. Para realizar los cambios en una versión existente de una plantilla, debedesinstalarla antes de retirarla.

5. Haga clic en Abrir para abrir una versión bloqueada de la plantilla en el panel del editor.

El estado de la plantilla en la barra de título de Process Builder cambia a Retirado.

Proteger plantillas de proceso

Para proteger una plantilla de proceso:

1. Haga clic en el icono o seleccione Archivo > Registro para mostrar el cuadro de diálogoRegistrar plantilla de proceso.

2. Seleccione la opción para guardar el proceso nuevo comoMisma versión, Versión menor oVersión mayor.

Registrar la plantilla como la misma versión realiza los cambios en la versión ACTUAL.

Nota: Si ha realizado los cambios en una plantilla instalada, puede guardar sólo la plantilla comouna versión menor o mayor. La opción de registrarlo como la misma versión no está disponible, yaque sobrescribir la versión actual afectaría a las instancias del proceso que están en ejecución.

3. Escriba una etiqueta descriptiva opcional para la nueva versión.




Cancelar retiradasUtilice este procedimiento cuando desee volver a registrar la plantilla en el repositorio sin guardar loscambios realizados. No se cambiará la versión existente etiquetada como ACTUAL en el repositorio.

Para cancelar una retirada en una plantilla de proceso:

1. Haga clic en el icono o seleccione Archivo > Cancelar retirada para mostrar el cuadro dediálogo Cancelar retirada.

El sistema muestra un mensaje que advierte que se perderán todos los cambios realizados enla plantilla.

Nota: Los superusuarios pueden cancelar la retirada de plantillas que son bloqueadas por otrosusuarios.

2. Haga clic en Sí para cancelar la retirada.

Eliminar las plantillas de procesoLa opción para eliminar una plantilla de proceso sólo está disponible si ésta está abierta en ProcessBuilder.

Para eliminar una plantilla de proceso:

1. En el menú Herramientas, seleccione Plantilla de proceso > Eliminar proceso.

Si una plantilla está actualmente en un estado instalado, el sistema le pedirá que la desinstale antesde eliminarla. Asimismo, si algún usuario está ejecutando flujos de trabajo que estén basados enesta plantilla, aparece un mensaje advirtiéndole de que hay instancias activas del flujo de trabajo.

2. Haga clic en Sí para desinstalar y eliminar la plantilla de proceso y las actividades relacionadas.

Importar plantillas de procesoDurante el proceso de importación, se toma un archivo XPDL exportado y se deja disponible paratrabajar con él en Process Builder o Process Analyzer. Los tipos de actividad automática y manualse mantienen durante la importación, aunque el desarrollador deberá agregar las definiciones como,por ejemplo, los métodos y temporizadores, a Process Builder. En el proceso de importación no seincluyen los paquetes.

Asimismo, si importa (o vuelve a importar) un proceso que contenga varias actividades de finalizacióndesde Process Analyzer, Process Builder agregará una actividad vacía adicional a la que se conectarántodas las actividades de finalización. (Process Builder admite sólo una actividad de finalización,mientras que los procesos exportados desde Process Analyzer pueden contener varias actividadesde finalización).

Nota: Si hay errores semánticos en el XPDL importado, el sistema guardará la nueva plantilla deproceso en un estado no válido. Utilice la información de cada mensaje de error de validación paracorregir el error y valide e instale la plantilla de proceso.

Para importar una plantilla de proceso en Process Builder:

1. En el menú Archivo, seleccione Importar > XPDL.



Aparecerá el cuadro de diálogo Proceso de importación.2. Desplácese hasta el archivo que desea importar. Para ello, haga doble clic en los directorios que

figuran en el cuadro de diálogo Proceso de importación hasta que se haya resaltado el nombredel archivo.

3. Haga clic en Abrir.

Process Builder creará un nuevo borrador de plantilla de proceso basado en el proceso de BusinessProcess Analyzer.

Si la información de ubicación del diseño de la actividad está disponible, se aplica a la plantilla deproceso importado. Por otra parte, el sistema utilizará el diseño predeterminado y la configuración devista gráfica. Puesto que la información de interfaz de usuario, tal como gráficos o imágenes, no seexporta con el proceso, deberá volver a crearla en Process Builder.

A continuación, deberá definir la información de ejecución para el proceso que utiliza el Inspectorde actividades.

Consulte el Instalar plantillas de proceso, página 77 si necesita más información sobre cómo definirlos detalles de la ejecución para las actividades.

Exportar plantillas de procesoMediante el proceso de exportación desde Process Builder o Process Analyzer se crea un archivoXPDL (XML Process Definition Language) que se guarda en una ubicación especificada en un sistemade archivos. A continuación, este archivo se puede importar en Process Analyzer o Process Builder.Las plantillas exportadas desde Process Builder contienen las definiciones de tipo que Process Analyzerutiliza para crear los objetos empresariales correspondientes. El archivo XPDL exportado contienetambién información sobre las actividades identificadas para la generación de informes de BAM.

Para exportar un proceso desde Process Builder:

1. En el menú Archivo, seleccione Exportar > XPDL.

Aparecerá el cuadro de diálogo Proceso de exportación.2. Desplácese hasta la carpeta en la que se guardará el archivo exportado. Para ello, haga doble

clic en los directorios que figuran en el cuadro de diálogo Proceso de exportación hasta que sehaya resaltado la carpeta.

3. Haga clic en Guardar.

Mantener sincronizados los procesoscompartidosLos procesos comerciales se pueden compartir y modificar en Process Builder o en Process Analyzer.Para mantener el proceso sincronizado entre las dos aplicaciones, deberá volver a importar el procesocambiado a su aplicación original.

Un proceso de Process Analyzer se puede exportar e importar, a continuación, a Process Builder ymodificar. Por ejemplo, utilice Process Builder para definir los detalles de ejecución, agregar unaactividad nueva o cambiar el orden de las actividades. Como resultado de estos cambios, el analista



comercial comprueba de nuevo el proceso en Process Analyzer o ejecuta una simulación del procesocomercial que se ha cambiado. Al volver a importar el proceso que se ha cambiado en ProcessBuilder, se actualiza el proceso original en Process Analyzer y se mantiene el proceso sincronizadoentre ambas aplicaciones.

Un proceso existente de Process Builder se puede exportar desde su aplicación original, importar enProcess Analyzer y modificar. Por ejemplo, el analista comercial puede cambiar el orden de lasactividades, agregar o eliminar una actividad. Para mantener el modelo ejecutable del procesosincronizado con el proceso que se ha cambiado, se deberá volver a importar en Process Builder.Durante la operación de volver a importar, el sistema utiliza la funcionalidad de creación de versionesy ofrece la opción de guardar el proceso como la misma versión, una versión menor o una mayor.

Para volver a importar un proceso comercial que se ha cambiado a Process Builder:

1. Exporte el proceso desde Process Analyzer.

2. Seleccione el proceso exportado e impórtelo en Process Builder.

Consulte Importar plantillas de proceso, página 81 para conocer el procedimiento para importar unproceso en Process Builder.

3. En el menú Archivo, seleccione Guardar.

Aparecerá el cuadro de diálogo Registrar plantilla de proceso, en el que se indica que el sistemaha detectado una versión existente del proceso en el repositorio.

4. Seleccione la opción para guardar el proceso nuevo comoMisma versión, Versión menor oVersión mayor.

El proceso nuevo se convertirá en la versión actual del proceso y el sistema mantendrá lasversiones anteriores con fines históricos. Todas las instancias del proceso creadas mediante laversión anterior continuarán ejecutándose con la plantilla de proceso de la versión anterior.

Asimismo, una vez que un proceso se registra como una versión mayor o menor, Process Builderno permitirá el almacenamiento de una versión anterior del proceso si ya existe una versión másreciente en el repositorio. Por ejemplo, el sistema impedirá guardar una importación de la versión1.0 de un proceso si ya existe la versión 1.1 en el repositorio. Se puede cambiar el nombre yguardar la versión anterior como un proceso diferente.

Un proceso comercial sólo se puede guardar como la misma versión si aún no se ha instalado dichaversión del proceso. Si se ha instalado una versión existente del proceso comercial, el sistema nopermitirá que se guarde como la misma versión. Se deberá guardar como una versión cambiada.


Si cuenta con los permisos correspondientes en la carpeta seleccionada, Process Builder guardala plantilla y sus actividades. Si ha definido que se solicite confirmación para la instalación yvalidación, se muestra un cuadro de diálogo en el que se le pregunta si desea validar la plantilla.Consulte Validar plantillas de proceso, página 76 si necesita más información sobre la validaciónde la plantilla.

6. Opcionalmente, puede instalar la plantilla de proceso.




Imprimir plantillas de procesoPuede imprimir una copia de la plantilla de proceso en cualquier momento.

Para imprimir plantillas de proceso:

1. Abra la plantilla que desee imprimir.2. Compruebe que las opciones de configuración de página son las deseadas.

Consulte Configurar las opciones de impresión de página, página 84 y Vista previa de procesosimpresos, página 85 si necesita información sobre dichas opciones.

3. Haga clic en el icono Imprimir diseño de plantilla de la barra de herramientas o seleccioneImprimir en el menú Archivo.

4. En la lista Nombre, elija el nombre de la impresora con la que desee imprimir.5. Para cambiar las propiedades de la impresora, haga clic en Propiedades y actualice la

configuración.

Consulte la documentación de la impresora si necesita más información sobre sus propiedades.6. Para imprimir la plantilla de proceso en un archivo en lugar de usar la impresora, marque la

casilla Imprimir a un archivo.7. Para imprimir más de una copia de la plantilla de proceso, escriba el número de copias deseadas en

el cuadro Número de copias.

Nota: Los controles del cuadro Intervalo de impresión aparecen como no disponibles, excepto elbotón de opción Todos. No se pueden imprimir partes de la plantilla, sino la plantilla completa.


Si ha elegido imprimir a un archivo, aparece el cuadro de diálogo Imprimir a un archivo. De locontrario, la plantilla de proceso se enviará a la impresora seleccionada.

9. En el cuadro de diálogo Imprimir a un archivo, escriba el nombre del archivo que desea crear,incluyendo la ruta completa.

Configurar las opciones de impresión de páginaLas opciones de configuración de página determinan la forma en la que se imprimirá la plantillade proceso.

Para cambiar las opciones de configuración de página:

1. En el menú Archivo, elija Configurar página.

Aparece el cuadro de diálogo Configurar página.2. Seleccione el tamaño del papel para las versiones impresas de la plantilla.

El cuadro Formato de papel ofrece seis tamaños estándar. Las dimensiones de cada formatoaparecen en pulgadas o centímetros, según la unidad de medida elegida en el campoMárgenes.Las opciones de formato del papel son:

• Carta de los EE.UU. (8,5 x 11 pulgadas)• Oficio de los EE.UU. (8,5 x 14 pulgadas)• Ejecutivo de los EE.UU. (7,25 x 10,5 pulgadas)



• A3 (29,69 x 42,01 centímetros)

• A4 (21 x 29,7 centímetros)

• A5 (14,8 x 21 centímetros)

3. Especifique si desea imprimir las páginas con orientación horizontal o vertical.

4. Introduzca los márgenes de las páginas impresas.

Puede hacerlo en pulgadas o centímetros con un máximo de dos decimales, por ejemplo, 1,25pulgadas o 4,44 centímetros.

5. Haga clic en Aceptar para guardar las opciones de configuración de página y salir de este cuadrode diálogo o en Imprimir para imprimir la plantilla actual con dicha configuración.

Vista previa de procesos impresos

La opción Vista preliminar ofrece una representación gráfica de la imagen que se imprimirá.

Para ver el formato de impresión:

1. En el menú Archivo, elija Vista preliminar.

Aparece el cuadro de diálogo Vista preliminar. El cuadro de la derecha muestra una imagenpreliminar de la plantilla de proceso tal y como aparecerá en la impresión. El diseño se basa en lasopciones de configuración de la página, página 84 y en la opción Tamaño de impresión.

2. Defina el tamaño de la copia impresa de la plantilla.

Las opciones de Tamaño de impresión son:

• Tamaño real: la impresión tendrá el mismo tamaño que en la vista previa de la plantilla en laventana de Process Builder.

• Igual que el tamaño de papel: el tamaño de la plantilla se ajustará para que ocupe una únicapágina con el tamaño y la orientación especificados en los pasos 2 y 3.

• Ajustar a: el tamaño de la plantilla se ajustará, de modo que ocupe una cantidad de páginasespecificadas tanto a lo ancho como a lo largo. Si selecciona esta opción, debe escribir unnúmero en cada uno de los dos cuadros de texto adyacentes.

3. Haga clic en Aceptar para guardar la opción Tamaño de impresión y salir de este cuadro dediálogo o en Imprimir para imprimir la plantilla actual con dicha configuración.




Capítulo 4

Conectar actividades


• Información general sobre la conexión de actividades

• Cambiar la configuración de vista

Información general sobre la conexión deactividadesLas líneas de flujo que conectan las actividades en un flujo de trabajo representan el flujo deldocumento u objeto que distribuye el flujo de trabajo. Los flujos permiten el movimiento de paquetes,sus propiedades y dependencias entre las actividades conectadas. Consulte Plantillas de proceso yobjetos de flujo de trabajo asociados, página 14 para obtener una descripción de los flujos.

Una vez que haya agregado un flujo a la plantilla, configúrelo con el Inspector de flujos. Para accederal Inspector de flujos, haga doble clic en un flujo en el panel del editor de plantillas de proceso oseleccione uno o varios flujos y elija Inspector de flujo en el menú Herramientas.

El Inspector de flujos le permite controlar la forma en la que el flujo aparece en la presentación visualde la plantilla de proceso. Cambiar la configuración de vista, página 88 proporciona más informaciónsobre este tema.

El nombre del flujo que está configurando aparece en el cuadro de texto situado en la parte superiordel Inspector de flujos. Si se selecciona más de un flujo, aparecen botones de flecha a cada lado delcuadro de texto con los que podrá desplazarse por los flujos seleccionados. La configuración seaplica al flujo cuyo nombre aparezca en el cuadro, a menos que haya seleccionado la opción Aplicara todos los seleccionados.

Siempre que se seleccionan varios flujos, cada ficha del Inspector de flujos muestra una o variascasillas de verificación Aplicar a todos los seleccionados. Si se marca esta casilla, Process Builderaplica la configuración asociada (es decir, la que aparece a la derecha de la casilla de verificación) atodos los flujos seleccionados y no sólo a áquel cuyo nombre aparezca en el cuadro de texto superior.Las opciones que no tengan la casilla marcada se aplicarán únicamente al flujo actual.

Crear flujosLas actividades se conectan utilizando uno de los cuatro iconos Crear flujo de la barra de herramientasde Process Builder:

• Para conectar actividades en un movimiento de datos hacia adelante, haga clic en el icono Crearflujo de un solo segmento o en el icono Crear flujo de segmentos múltiples . La diferencia



entre los dos es visual: uno muestra una línea recta que representa el flujo entre las actividades y elotro una línea que consta de varios segmentos.

• Para conectar actividades en un movimiento de datos hacia atrás, haga clic en el icono Crear flujo derechazo . Este icono representa la ruta que se sigue cuando el usuario de una actividad rechaza elobjeto que se está procesando.

• Para conectar una actividad automática a una actividad de controlador de errores, haga clic en elicono Assign Fault Handlers (Asignar controladores de errores) . Los controladores de errores lepermiten asignar una actividad del control de errores secundaria a una actividad automática en casode que se produzca un error en la actividad automática. Una actividad de controlador de errorestiene una línea discontinua que representa el flujo entre la actividad automática y su controlador deerrores relacionado.

Plantillas de proceso y objetos de flujo de trabajo asociados, página 14 proporciona descripciones delos tipos diferentes de flujos.

Cambiar la configuración de vistaLas opciones de la ficha Visualización controlan la forma en la que el flujo se muestra en la plantillade proceso.

Nota: Las opciones de la ficha Visualización no controlan si la línea de flujo comienza con undiamante de estilo BPMN. Los flujos tienen un diamante cuando la actividad que los crea selecciona lasiguiente actividad mediante lógica condicional. Definir las reglas de transición de actividad, página126 proporciona más información sobre este tema.

Para cambiar la configuración de vista de un flujo:

1. En el Inspector de flujos, elija la ficha Visualización.2. Determine si la línea de flujo aparece como Una sola línea directa entre las actividades conectadas

o como Líneas de segmentos múltiples, con cada segmento trazado en sentido horizontal yvertical.

Normalmente, las líneas de segmentos múltiples de un flujo son más fáciles de seguir.3. Defina la fuente y el estilo usados para mostrar las etiquetas de flujo o los nombres de los paquetes

distribuidos a través del flujo.

Esta configuración sólo se tiene en cuenta si elige mostrar los nombres del paquete en el próximopaso o si escribe en etiquetas personalizadas para ese segmento de flujo.a. Seleccione una fuente en la lista Fuente de etiquetas.b. Seleccione un tamaño en la lista desplegable Tamaño de puntos.c. Para definir el estilo de fuente de la etiqueta, marque o quite la marca de Negrita y Cursiva.

4. Especifique cómo se debe etiquetar el flujo en la pantalla del editor de plantillas de proceso.a. Active la casilla de verificaciónMostrar etiqueta si desea que aparezca una etiqueta en el

flujo, o bien desactívela si no desea que aparezca. Los dos botones de opción situados bajo lacasilla de verificación aparecen como no disponibles si la casilla no está activada.

b. SeleccioneMostrar paquetes visibles en la actividad de destino para etiquetar el flujo conlos nombres de paquetes controlados por la siguiente actividad. O bien, seleccione Etiquetapersonalizada y escriba el texto de la etiqueta en el cuadro de texto adyacente.



5. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de flujos o en Aceptarpara guardarlas y cerrar el Inspector.




Capítulo 5

Crear subprocesos


• Información general sobre subprocesos

• Crear un subproceso utilizando el modelado descendente

• Crear un subproceso utilizando el modelado ascendente

• Establecer las propiedades del subproceso

• Utilizar la ficha Temporizadores para subprocesos

• Expandir y contraer subprocesos

• Quitar actividades de un subproceso

• Agregar notas a un subproceso

• Eliminar un subproceso y su contenido

Información general sobre subprocesosLos subprocesos mejoran la capacidad de comunicar el significado comercial de una plantilla deproceso. Un proceso grande o complejo puede ser difícil de organizar visualmente cuando serequieren muchas actividades para finalizar un flujo de trabajo completo. Para simplificar el diseñode un proceso, tal vez desee agrupar las actividades relacionadas en subprocesos que, en conjunto,representan un proceso comercial.

En Process Builder, los subprocesos se pueden expandir para ver las actividades individuales ocontraer para crear una información general más simplificada de un proceso. El proceso contieneactividades que guardan alguna relación y que están agrupadas en un contenedor para simplificarsu administración. Esto puede ser particularmente útil al agrupar un conjunto de actividades querepresentan colectivamente una función comercial o un paso lógico de un proceso. Las actividades quecomparten los mismos datos de proceso también se pueden agrupar en un subproceso.

No hay restricciones en el número de flujos de entrada o de salida relacionados con un subproceso.Los flujos no se conectan al contenedor de subprocesos, sino a las actividades individuales dentrodel contenedor.

Los subprocesos se incluyen en los datos de informes de BAM. Los datos de entrada y salida se envíana la base de datos de informes de BAM cuando se ha habilitado el seguimiento de comprobación parael proceso. Las plantillas de actividades incluidas en el subproceso publican también datos de informescuando se seleccionan para la generación de informes.


Crear subprocesos

Crear un subproceso utilizando el modeladodescendenteEl modelado descendente hace referencia a la práctica de crear primero un subproceso vacíoy, a continuación, agregarle actividades individuales a medida que se definen. Este enfoque esespecialmente útil cuando se pretende diseñar primero los conceptos de alto nivel iniciales del procesoy completar los detalles en una fase posterior en desarrollo.

Para crear un subproceso seleccionando actividades existentes, siga estos pasos:1. Seleccione el icono Crear subproceso y, a continuación, haga clic en el panel del editor de

plantillas de procesos donde desea que aparezca el subproceso.

El nuevo subproceso vacío aparece como un rectángulo coloreado etiquetado como Subproceso.2. Haga clic en el subproceso y arrástrelo hacia la posición deseada de la ventana del editor de

procesos.3. Haga clic con el botón derecho del ratón en el subproceso y seleccione Inspector de subproceso

para establecer las propiedades que se comparten en todas las actividades dentro del subproceso.

Establecer las propiedades del subproceso, página 93 proporciona instrucciones detalladas paraestablecer estas propiedades.

4. Expanda el límite del subproceso haciendo clic en el signo más +.

Si es necesario, seleccione y arrastre el borde del subproceso para ampliar su límite.5. Arrastre cada actividad que desee incluir en el grupo al contenedor de subprocesos.

El sistema muestra un mensaje que confirma la acción. Si mueve el subproceso a otra posición dela ventana, las actividades incluidas también se mueven con él.

6. Cree las líneas de flujo individuales y conecte todas las actividades del flujo de proceso.

Las líneas de flujo no se conectan al contenedor de subprocesos, sino a las actividades individualesdentro del subproceso. Un subproceso no está limitado en el número de flujos de entrada o salidaque entran o salen de sus límites.

Crear un subproceso utilizando el modeladoascendenteEl modelado ascendente es la práctica de crear primero el proceso comercial con todas sus actividadesy a continuación agrupar actividades relacionadas en subprocesos. Este método le permite crearprimero todas las actividades necesarias, agruparlas en subprocesos y contraerlas para ver un flujomás compacto y simplificado.

Para crear un subproceso seleccionando actividades existentes:1. Seleccione las actividades que desea incluir en el subproceso.

Puede seleccionar varias actividades utilizando el ratón para arrastrar un rectángulo alrededor delas actividades que desea incluir en el subproceso o manteniendo presionada la tecla Mayús yhaciendo clic en las actividades individualmente.

Las actividades seleccionadas se rodean con una línea de guiones verde.2. Seleccione Herramientas > Subproceso > Agregar a subproceso.


Crear subprocesos

Las actividades seleccionadas aparecen en un rectángulo coloreado etiquetado como Subproceso.3. Haga clic con el botón derecho del ratón en el subproceso y seleccione Inspector de subproceso

para establecer las propiedades que se comparten en todas las actividades dentro del subproceso.

Establecer las propiedades del subproceso, página 93 proporciona instrucciones detalladas paraestablecer estas propiedades.

4. Puede hacer clic en el nuevo subproceso y arrastrarlo a la posición deseada de la ventana.

Establecer las propiedades del subprocesoPara establecer las propiedades de subproceso:

1. Haga clic con el botón secundario en el subproceso.2. Seleccione Inspector de subproceso para establecer las propiedades que se comparten en todas

las actividades dentro del subproceso.

Las propiedades de subproceso son independientes de las propiedades de actividad.Con el Inspector de subproceso, también puede establecer los temporizadores del subproceso asícomo las opciones para mostrar el subproceso.

Utilizar la ficha Temporizadores parasubprocesosProcess Builder admite dos tipos de temporizador de advertencia para los subprocesos:

• Un pre-temporizador se pone en funcionamiento si un subproceso no se ha desencadenado dentro deun período de tiempo especificado tras el inicio del flujo de trabajo.La actividad se considera desencadenada una vez que la crea el flujo de trabajo, aunque el usuariono la haya adquirido. Los pre-temporizadores no se activan en la primera actividad de un flujo detrabajo, ya que se desencadenan de forma automática al iniciarse los flujos de trabajo.

• Un post-temporizador se pone en funcionamiento si un subproceso no ha terminado dentro de unperíodo de tiempo especificado tras el inicio de la actividad.

Si precisa más información sobre temporizadores de flujo de trabajo, consulte Definir temporizadores,página 34.

Cuando un subproceso tiene definidas una o más acciones del temporizador, aparece un pequeño iconode reloj en la esquina inferior derecha del subproceso.

Utilizar la ficha VisualizaciónLas opciones de la ficha Visualización controlan la forma en la que se mostrará la actividad en laplantilla de proceso.

Nota: Cuando una actividad tiene definidas una o más acciones del temporizador, aparecerá unpequeño icono de reloj en la esquina inferior derecha del contenedor de subprocesos.1. En el Inspector de subproceso, haga clic la ficha Visualización.


Crear subprocesos

2. Defina la fuente y el estilo usados para designar la actividad en la plantilla.Seleccione una fuente en la lista Fuente de etiquetas.Seleccione un tamaño en la lista desplegable Tamaño de puntos.Para definir el estilo de fuente de la etiqueta, marque o quite la marca de Negrita yCursiva.

3. Seleccione el color de fondo para el formulario de subproceso el campo Color de fondo.4. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de subproceso o en

Aceptar para guardarlas y cerrar el Inspector.

Expandir y contraer subprocesosSe puede expandir y contraer un subproceso para mostrar u ocultar su contenido. Paraexpandir un subproceso individual, haga clic en el signo más ; se expandirá el límite yse mostrará el contenido del subproceso para que pueda ver las distintas actividades. Paraexpandir todos los subprocesos de la plantilla, seleccione Herramientas > Subproceso >Expandir todo; todos los subprocesos mostrarán el contenido.

Para contraer un subproceso individual, haga clic en el signo menos y el subproceso se minimiza,ocultando el contenido. Para contraer todos los subprocesos en la plantilla, seleccione Herramientas> Subproceso > Contraer todo

Cuando se contrae un subproceso, las actividades que contiene se ocultan de la vista. Puede arrastrarun subproceso contraído hacia las distintas ubicaciones del Editor de plantillas de proceso y las líneasde flujo ajustan automáticamente su longitud a la nueva posición. No puede arrastrar una actividada un subproceso contraído.

Quitar actividades de un subprocesoPuede quitar las actividades de un subproceso dejando intacta la actividad del subproceso. Seleccionela actividad o conjunto de actividades incluidas en el subproceso.

Para quitar una actividad de un subproceso:

1. Seleccione la actividad o grupo de actividades incluidas en el subproceso.2. Seleccione Herramientas > Subproceso > Quitar de subproceso.

El sistema muestra un mensaje en el que se confirma que la actividad se quitará permanentementedel subproceso.

3. Arrastre la actividad a una nueva ubicación en la pantalla.

Agregar notas a un subprocesoPuede agregar texto al diseño visual de la plantilla de proceso mediante notas.

Para agregar notas a un subproceso, seleccione un subproceso expandido, haga clic en el icono Notasy, a continuación, haga clic dentro del límite del subproceso. Puede crear también una nota dentro


Crear subprocesos

del Editor de plantillas de proceso y arrastrar la nota al subproceso. Las notas se ocultan cuando elsubproceso se contrae y se muestran al expandirse. Agregar notas, página 54 proporciona instruccionessobre cómo utilizar las notas en una plantilla de proceso.

Eliminar un subproceso y su contenidoAl eliminar un subproceso, también se eliminan todos los objetos que se encuentran dentro delsubproceso. Entre estos objetos se incluyen las plantillas de actividad que pertenecen al subproceso.Para conservar las plantillas de actividad incluidas en el subproceso, utilice la opción Quitar desubproceso.

Para eliminar un subproceso y su contenido:

1. Seleccione el subproceso.

2. Seleccione Eliminar en el menú contextual.

El subproceso, su contenido y las líneas de flujo conectadas se eliminan.


Crear subprocesos


Capítulo 6

Trabajar con plantillas de actividad


• Trabajar con plantillas de actividad

Trabajar con plantillas de actividadLas plantillas de actividad representan un tipo de tarea determinado que se puede agregar a un procesocomercial. Estas plantillas identifican todos los métodos subyacentes de flujos de trabajo necesariospara finalizar la tarea y determinan los atributos de configuración que se deben definir a fin de completarla tarea. La plantilla también puede definir valores predeterminados para algunos atributos comunes.

Para agregar una actividad a una plantilla de proceso comercial, seleccione la plantilla de actividadinstalada adecuada de una de las carpetas en la ventana Plantilla de actividad y lo arrastra en la ventanaProcess Template Editor (Editor de plantilla de proceso). Process Builder incluye plantillas para tiposde actividades de integración habituales, así como una plantilla de actividad de ejemplo. ConsultePlantillas de actividades incorporadas, página 173 para obtener una lista de las plantillas de actividadesfacilitadas por Process Builder. La guía Documentum Process Builder Development Guide proporcionamás información sobre cómo crear plantillas de actividad personalizadas.

Existen tres posibles estados de las plantillas de actividad: borrador, validado e instalado. Una plantillade actividad con el estado borrador no se ha validado desde que se creó o desde la última vez que semodificó. Una plantilla con el estado validado ha pasado las verificaciones de validación del servidor,que garantizan que la plantilla se ha definido correctamente. Una plantilla con el estado instalado estálista para usarse y crear actividades en el flujo de proceso. El estado actual de una plantilla de actividadse indica en el icono de ésta en la ventana Plantilla de actividad.

Crear plantillas de actividadSi su proceso comercial contiene actividades para las que Process Builder no incluye una plantillaadecuada, puede crearla. Puede copiar una plantilla existente y a continuación modificarla, o biencrear una plantilla nueva.

Crear una nueva plantilla de actividadPara crear una nueva plantilla de actividad:1. Seleccione la carpeta en la que agregará la nueva plantilla.2. En el menú Herramientas, seleccione Plantilla de actividad > Nueva o haga clic con el botón

secundario en la carpeta y seleccione Nueva en el menú.



Aparecerá una nueva plantilla de actividad con el nombre Sin título en la carpeta de plantillas deactividad actualmente activa.

3. Haga doble clic en la nueva plantilla de actividad para abrir el Inspector de plantilla de actividad.4. Configure la plantilla.

Consulte Configurar plantillas de actividad, página 99 si necesita más información sobre laconfiguración de plantillas de actividad.

Copiar una plantilla de actividadPara crear una nueva plantilla de actividad a partir de una plantilla existente:1. En un nodo de plantilla de actividad, seleccione la plantilla de actividad que desea copiar.2. En el menú Herramientas, seleccione Plantilla de actividad > Guardar como.

Las carpetas se muestran en System/Workflow/Activity Templates, que representan las plantillasde actividad disponibles.

3. Seleccione la carpeta de plantilla de actividad a la que desea agregar la plantilla nueva.4. Introduzca un nombre para la nueva plantilla en el cuadro de texto Nombre.5. Haga clic en Aceptar.

La plantilla de actividad aparecerá en el nodo seleccionado. La plantilla nueva tiene las mismascaracterísticas que la plantilla seleccionada en el paso 1. Sin embargo, la plantilla original y laplantilla nueva son independientes. Los cambios futuros en una no afectarán a la otra.

6. Realice los cambios necesarios en la nueva plantilla de actividad.

Consulte Configurar plantillas de actividad, página 99 si necesita más información sobre laconfiguración de plantillas de actividad.

Gestionar las plantillas de actividad dentro de las carpetasHay muchas plantillas de actividad organizadas por función bajo las carpetas (o nodos) de la ventanaPlantilla de actividades. Puede examinar las plantillas de actividad entregadas abriendo y cerrandolas carpetas a las que pertenecen. Plantillas de actividades incorporadas, página 173 proporcionainformación detallada sobre a qué nodo pertenece la plantilla de actividad e instrucciones paraconfigurar cada plantilla de actividad. Gestionar las carpetas de plantillas de actividades, página 43proporciona información detallada sobre cómo crear, agregar o quitar carpetas en la ventana Plantillasde actividad.

Cuando se crea una plantilla de actividad personalizada, se especifica en qué carpeta aparece.Dado que una plantilla de actividad puede ser importante en más de un tipo de situación o procesoempresarial, esta plantilla puede aparecer en más de una carpeta.

Quitar plantillas de actividad de las carpetasPara quitar una plantilla de actividad de una carpeta de plantillas de actividad:1. Seleccione la plantilla de actividad que desea quitar.2. En el menú Herramientas, seleccione Plantilla de actividad > Quitar o haga clic con el botón

secundario en la ventana Plantillas de actividades y seleccione Quitar.



La plantilla de actividad se quita de la paleta actual. Si la plantilla está enlazada a otra carpeta,seguirá apareciendo en esa carpeta.

Configurar plantillas de actividadConfigure una plantilla de actividad con el Inspector de plantilla de actividad. Este Inspector compartevarias fichas con el Inspector de actividades, que se utiliza para configurar actividades individuales.Con estas fichas compartidas, los valores que defina para la plantilla de actividad pasan a ser los valorespredeterminados de las actividades creadas a partir de la plantilla. El Inspector de plantilla de actividadno permite definir información sobre la prioridad, paquetes, flujos de entrada y salida u opciones detransición. Estos atributos de configuración guardan relación con la forma en la que una actividadindividual se ajusta a un flujo de proceso específico, por lo que no son relevantes para las plantillas.

El Inspector de plantilla de actividad también incluye una ficha adicional, llamada Definición, quedefine atributos personalizados para las actividades creadas con la plantilla. Los atributos se definenmediante XML, que define los nombres, tipos de datos y características de visualización de losatributos personalizados, así como ayuda para los usuarios que introducen valores para los atributos. Siuna actividad se crea a partir de la plantilla, el Inspector de actividades incluirá una o varias fichasadicionales para que el usuario las emplee al introducir valores de los atributos personalizados. Losnombres de estas fichas se especifican en el archivo XML.

Además de definir fichas adicionales, el archivo de definición de la plantilla de actividad puedesuprimir la visualización de una o varias fichas estándar del Inspector de actividades. Si una actividadse crea a partir de la plantilla, el Inspector de actividades no muestra ninguna de las fichas suprimidas,por lo que se impide que el usuario pueda cambiar valores de la ficha. Los valores definidos en elInspector de plantilla de actividad permanecen inalterados.

La estructura del archivo XML de una plantilla de actividad queda definida por el archivo deesquema activity.xsd, que se encuentra en el sistema de archivos local del directorio Archivos deprograma\Documentum\bpm\classes. Consulte la guía Documentum Process Builder DevelopmentGuide si necesita más información sobre la estructura del archivo. Para ver un ejemplo de archivoXML de una plantilla de actividad, consulte la plantilla de actividad Sample (Ejemplo) que hayinstalada en la carpeta de plantillas de actividad Sample (Ejemplo).

Para definir atributos de una plantilla de actividad:

1. Haga doble clic en la plantilla de actividad de la carpeta o selecciónela y elija Inspector deplantilla de actividad en el menú Herramientas.

Aparecerá el Inspector de plantilla de actividad.2. Defina los valores predeterminados de cualquiera de los atributos de configuración disponibles en

las otras fichas.

Los valores definidos en la plantilla pasarán a ser los predeterminados de cualquier actividadcreada a partir de la plantilla. Consulte el Trabajar con plantillas de actividad, página 97 paraobtener detalles sobre la definición de atributos. Normalmente, se aconseja enlazar la plantilla a unmétodo de flujo de trabajo personalizado en la ficha Ejecutante.

3. Seleccione la ficha Definición.

Aparecerá un cuadro de texto con los elementos XML que definen los atributos personalizadospara esta plantilla de actividad. Si se trata de una plantilla nueva o una sin atributos personalizados,los únicos elementos serán el elemento de nivel superior <xml> y el elemento <activity> queidentifica el esquema XML de las plantillas de actividad.



4. Edite el XML para definir atributos personalizados y la interfaz de usuario que los editará.

El XML que introduzca debe cumplir con el archivo de esquema activity.xsd. Consulte la guíaDocumentum Process Builder Development Guide si necesita más información sobre la estructuradel archivo.

5. Para suprimir la visualización de una o varias fichas en el Inspector de actividades, introduzcaun elemento <tab> por cada ficha suprimida.

El elemento <tab> debe ser un subelemento del elemento <tabs>, el cual también especifica lavisualización de las fichas personalizadas en el Inspector de actividades. Para cada ficha que deseasuprimir, escriba un elemento en este formato

<tab id="TAB_NAME" showInActInspector="false" />

Los valores válidos de NOMBRE_FICHA son PROPERTIES, PERFORMER, TRIGGER,NOTIFICATION, TRANSITION, PACKAGE y DISPLAY. Consulte el Trabajar con el inspectorde actividades, página 103 para obtener información sobre las opciones de cada una de estas fichas.El parámetro showInActInspector se omite en las fichas personalizadas.

6. Haga clic en Aceptar para cerrar el Inspector de plantilla de actividad.

Validar e instalar plantillas de actividadLas plantillas de actividad pueden encontrarse en tres estados: borrador, validado e instalado. Unaplantilla de actividad con el estado borrador no se ha validado desde que se creó o la última vez que semodificó. Una plantilla con el estado validado ha pasado las verificaciones de validación del servidor,que garantizan que la plantilla se ha definido correctamente.

La lista siguiente detalla algunas de las marcas de validación que realiza el sistema:

• Los pre-temporizadores y post-temporizadores están correctamente configurados.• La selección del usuario es válida para las actividades manuales.

Una plantilla con el estado instalado está lista para usarse y crear actividades. El estado actual deuna plantilla de actividad se indica en el icono de ésta en la ventana Plantillas de actividades. Unaplantilla válida tiene una marca de verificación roja en el icono de plantilla y una plantilla instaladatiene una flecha en el icono de plantilla.

Con la validación de una plantilla de actividad, se verifica que ésta cumple los requisitos del sistema.Solamente se puede realizar la validación si la plantilla abierta tiene el estado borrador y el usuariocuenta con el permiso de escritura.

Las plantillas de actividad se deben instalar a fin de que queden disponibles para crear actividades.Sólo se puede instalar una plantilla de actividad si tiene el estado validado y el usuario cuenta conpermiso de escritura.

Si necesita realizar cambios en una plantilla de actividad instalada, primero debe desinstalarla. Unavez realizados los cambios, vuelva a validar e instalar la plantilla.

Validar plantillas de actividadPara validar una plantilla de actividad:

1. Seleccione la plantilla de actividad que desea validar.



2. En el menú Herramientas, seleccione Plantilla de actividad > Validar.

Si la opción Validar aparece como no disponible, significa que la plantilla está actualmentevalidada o instalada, o que no cuenta con permiso para validar.

Si se produce un error en la validación, aparecerá un cuadro de diálogo. Haga clic en el botónDetalles para ver el error que impidió la validación. Si la validación se realiza correctamente,aparecerá una marca de verificación roja junto al icono de la plantilla de actividad en la ventanaPlantillas de actividad.

Instalar las plantillas de actividad

Para instalar una plantilla de actividad:

1. En el menú Herramientas, seleccione Plantilla de actividad > Instalar.

Si la opción Instalar aparece como no disponible, significa que la plantilla está instaladaactualmente o no tiene permiso para instalar. Si la instalación se realiza correctamente, apareceráel icono de validación junto a la plantilla de actividad en la ventana Plantillas de actividad.

Desinstalar las plantillas de actividad

Para desinstalar una plantilla de actividad:

1. En el menú Herramientas, seleccione Plantilla de actividad > Desinstalar.

Solamente puede desinstalar una plantilla si tiene el estado instalado y el usuario cuenta conpermiso de escritura. Si la plantilla se desinstala correctamente, se sustituirá la flecha situada juntoal icono de la plantilla (que representa el estado de instalado) con una marca de verificación roja(que representa el estado validado).




Capítulo 7

Trabajar con actividades


• Trabajar con el inspector de actividades

• Definir propiedades de actividades

• Seleccionar ejecutantes

• Descripción del Asistente para plantilla de notificación

• Crear una nueva plantilla de correo electrónico

• Cambiar datos de proceso en una actividad

• Editar los datos de proceso de un paquete existente

• Iniciar automáticamente un paquete desde una actividad manual

• Cambiar las variables de proceso existentes

• Editar las variables de proceso existentes

Trabajar con el inspector de actividadesLas actividades son las tareas de las que está compuesto el flujo de trabajo. La mayor parte de laconfiguración del flujo de trabajo consiste en configurar sus actividades. Si necesita información sobrela planificación de la configuración de las actividades del flujo de trabajo, consulte Planificar losprocesos de flujo de trabajo, página 18.

Las actividades se configuran con el Inspector de actividades. Para acceder al Inspector de actividades,haga doble clic en una actividad en el panel del editor de plantillas de proceso o seleccione una o variasactividades y elija Inspector de actividades en el menú Herramientas.

El Inspector de actividades incluye varias fichas, cada una de las cuales corresponde a un aspecto dela configuración de las actividades:

• La ficha Propiedades establece la prioridad de las actividades automáticas y permite ofrecerinstrucciones a los ejecutantes manuales, así como un formulario de la actividad. Definirpropiedades de actividades, página 105 proporciona información más detallada.

• La ficha Ejecutante permite seleccionar quién realiza la actividad y qué acciones hay disponiblespara él. Seleccionar ejecutantes, página 106 proporciona información más detallada sobre este tema.

• La configuración de la ficha Desencadenador determina cuando se inicia la actividad. Definirdesencadenadores de actividades, página 119 proporciona información más detallada sobre estetema.



• La ficha Temporizadores define las medidas que deben tomar los temporizadores si el trabajose estanca. Establecer temporizadores de advertencia, página 120 proporciona información másdetallada sobre este tema.

• La configuración de ficha Transición determina qué actividades van después en el flujo de trabajo.Definir las reglas de transición de actividad, página 126 proporciona información más detalladasobre este tema.

• La ficha Notificación especifica si el supervisor del flujo de trabajo recibe una notificación cuandose producen determinados eventos del sistema. Definir notificaciones, página 130 proporcionainformación detallada sobre este tema.

• La ficha Datos controla los datos de proceso que gestiona la actividad, incluidos los paquetes ylas variables de proceso. Cambiar datos de proceso en una actividad, página 134 proporcionainformación más detallada sobre este tema.

• La ficha Visualización controla la forma en la que la actividad se mostrará en la plantilla de proceso.Cambiar la configuración de vista, página 136 proporciona información detallada sobre este tema.

• Muchas actividades contienen una o varias fichas adicionales que incluyen propiedades específicasde ese tipo de actividad. El nombre de la ficha y las propiedades incluidas en ella se establecen en laplantilla de actividad. Configurar plantillas de actividad, página 99 proporciona más informaciónsobre la configuración de plantillas de actividad personalizadas.

Al escribir valores en los campos de una ficha personalizada, puede incluir variablesque se sustituyan en el tiempo de ejecución por valores del entorno actual, como elnombre del objeto dm_workflow. Para incluir una variable, escriba el elemento de XML<dmp:param>parámetro_admitido</dmp:param>, donde parámetro_admitido es una de lasvariables que admite Process Builder para la sustitución de variables. Consulte el Utilizandovariables de sustitución para propiedades de plantillas de actividad personalizadas, página 245para obtener una lista de las variables admitidas.

Nota: En función de la naturaleza de la actividad, puede que no aparezcan algunas actividades enel Inspector de actividades. Por ejemplo, una actividad creada a partir de la plantilla de actividadDivisión de la decisión incluye sólo las fichas Temporizadores, Visualización y Definición. Lasopciones de estas fichas son las únicas relevantes para las actividades Decision Split (División de ladecisión). La plantilla de actividad define el conjunto de fichas mostradas. Configurar plantillas deactividad, página 99 proporciona información detallada sobre este tema.

El nombre de la actividad que esté configurando aparece en el cuadro de texto situado en la partesuperior del Inspector de actividades. Cada actividad debe presentar un nombre único en la plantilla.Para cambiar este nombre, escriba otro en el cuadro de texto, reemplazando al anterior. Si seselecciona más de una actividad, aparecen botones de flecha a cada lado del cuadro de texto, quepermiten el desplazamiento por las actividades seleccionadas. La configuración se aplicará a laactividad cuyo nombre aparezca en el cuadro, a menos que haya seleccionado la opción Aplicara todos los seleccionados.

Siempre que se seleccionan varias actividades, cada ficha del Inspector de actividades muestrauna o varias casillas de verificación Aplicar a todos los seleccionados. Si se marca esta casilla,Process Builder aplica la configuración asociada (es decir, la que aparece a la derecha de la casillade verificación) a todas las actividades seleccionadas y no solo a aquellas cuyo nombre aparezca enel cuadro de texto superior. Por ejemplo, puede seleccionar varias actividades y elegir el mismoejecutante para todas ellas de una vez. Las opciones que no tengan la casilla marcada se aplicaránúnicamente a la actividad actual.



Definir propiedades de actividadesLa ficha Propiedades del Inspector de actividades permite definir la prioridad de las actividadesautomáticas, proporcionar instrucciones a los ejecutantes de las actividades manuales o asociarformularios con actividades. Al crear una actividad que utiliza un formulario, el ejecutante de la tareavisualiza dicho formulario en tiempo de ejecución, en lugar de visualizar la interfaz estándar deTask Manager que aparece al abrir una tarea.

Para establecer las propiedades de actividad:

1. En el Inspector de actividades, elija la ficha Propiedades.

El sistema muestra el Id. del objeto del repositorio y el estado de la actividad en el campo IDde actividad como un valor de sólo lectura.

2. Seleccione un nivel de prioridad en la lista desplegable Prioridad.

Este valor de prioridad designa la prioridad en la ejecución de una actividad automática y seignora en las actividades manuales. Si precisa más información, consulte Definir valores deprioridad, página 27.

La prioridad Dinámica se da cuando, en lugar de establecer la prioridad de la actividad como partede la plantilla de proceso, se establece utilizando código personalizado mientras se ejecuta elflujo de trabajo. Debe asignar esta prioridad sólo si el sistema incluye código personalizado paraestablecerla en tiempo de ejecución.

3. Introduzca una descripción de la actividad en el cuadro de texto Descripción.

4. Introduzca texto para el mensaje que aparecerá en la bandeja de entrada de un ejecutante manualen el cuadro Nombre de tarea.

De forma predeterminada, el mensaje predeterminado aparece en el cuadro. Además de textonormal, el mensaje puede contener los valores de atributos de flujo de trabajo que determina elsistema en el tiempo de ejecución. Por ejemplo, el mensaje puede incluir el nombre del flujo detrabajo o del documento que se está distribuyendo. Puede escribir hasta 256 caracteres. El mensajeque ve el usuario, con cualquier variable evaluada, se trunca a partir de 512 caracteres.

Para incluir un atributo de tiempo de ejecución en el nombre de la tarea, agregue una variable almensaje mediante los siguientes pasos:

a. En el cuadro Nombre de tarea, coloque el cursor en la ubicación del texto donde desea situarla variable.

b. Haga clic en Insertar.Aparecerá el cuadro de diálogo Insertar nombre de tarea desde el cual podrá elegir elatributo de tiempo de ejecución que desee incluir.

c. En el árbol Tipo de parámetro, seleccione el atributo que desea incluir en el mensaje de asunto.

d. Haga clic en Aceptar para cerrar el cuadro de diálogo.

Consulte Definir asuntos de tareas, página 26 para obtener información sobre las variablesdisponibles. Puede incluir varias variables en el nombre de la tarea.

5. Introduzca cualquier instrucción que desee incluir para el ejecutante de esta actividad en el campoInstrucciones de la tarea.

Nota: Las comillas tipográficas no se admiten en el campo Instrucciones de la tarea y evitarán queel sistema envíe las notificaciones por correo electrónico personalizadas.



Para incluir un atributo de tiempo de ejecución en las instrucciones de la tarea, agregue unparámetro al mensaje mediante los siguientes pasos:

a. En el cuadro Instrucciones de la tarea, coloque el cursor en la ubicación del texto dondedesea situar el parámetro.

b. Haga clic en Insertar. Aparecerá el cuadro de diálogo Insertar instrucción de tarea, en el quepuede seleccionar el atributo de tiempo de ejecución que desea incluir.

c. En el árbol Tipo de parámetro, seleccione el atributo que desea incluir en las instruccionesde la tarea.

d. Haga clic en Aceptar para cerrar el cuadro de diálogo.

6. En la lista desplegable Formulario, elija la plantilla de formulario (de haber alguna) que seutilizará para mostrar esta tarea al ejecutante de la actividad.

Nota: Sólo los formularios asociados con el proceso aparecen en la lista.

Si la actividad incluye los parámetros de proceso, puede crear un formulario Administrationde proceso para habilitar la administración de los parámetros. Desde el formulario, losadministradores pueden cambiar el valor de los parámetros de proceso.

Si desea crear un nuevo formulario para la actividad, siga estos pasos:

a. Haga clic en el botón para iniciar Forms Builder.

b. Utilice Forms Builder para crear un formulario para la actividad.

Consulte la guía Documentum Forms Builder User Guide si necesita información sobre lacreación de formularios.

c. Haga clic en el botón Actualizar para recuperar todos los formularios disponibles delrepositorio.

7. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de actividades o enAceptar para guardarlas y cerrar el Inspector de actividades.

Seleccionar ejecutantesAl definir una actividad, es necesario especificar quién la llevará a cabo. Las actividades puedenser realizadas manualmente por un individuo, grupo, cola de trabajo o alias especificado oautomáticamente por un método de flujo de trabajo. En el caso de las tareas manuales, puedeseleccionar ejecutantes concretos o permitir que los participantes en el flujo de trabajo los elijan. Paralas tareas automáticas, debe especificar un usuario de cuyos permisos se encarga la tarea automática.

Para seleccionar los ejecutantes de una actividad:

1. En el Inspector de actividades, elija la ficha Ejecutante.

2. En el cuadro El trabajo de la actividad es ejecutado, elija a los ejecutantes.• Para elegir un ejecutante manual, seleccione Por uno o más ejecutantes manuales.• Para elegir un ejecutante automático, seleccione Automáticamente de parte de un ejecutante.

3. Haga clic en el botón Seleccionar ejecutante para ver el asistente de selección del ejecutante deesta actividad.• Para elegir uno o varios ejecutantes manuales, consulte Elegir ejecutantes manuales, página 108.



• Para elegir el usuario cuyos permisos se usan con una actividad automática, consulte Elegirejecutantes automáticos, página 118.

4. Si ha seleccionado uno o varios ejecutantes manuales, elija qué acciones puede o debe realizar elejecutante.• Para permitir que el ejecutante pase la tarea a otro usuario o grupo, marque Delegar el trabajode la actividad en otra persona. Cuando seleccione esta opción, también deberá especificardónde se enviará la tarea si no está disponible el usuario en el que el ejecutante la delega.El indicador de sistema autodelegación en cascada controla la delegación cuando el delegadodel ejecutante inicial no está disponible. Cuando la autodelegación en cascada está activada, elsistema envía la tarea a través de una cadena de delegados hasta que encuentra un ejecutantedisponible. Si el sistema no encuentra ningún ejecutante disponible, delegará la tarea enel supervisor del flujo de trabajo.El atributo max_auto_delegate determina la longitud de la cadena de delegados. El valormínimo de este atributo es 1 y el valor máximo es 5. Por ejemplo, si el valor establecido es 3y el sistema no encuentra un ejecutante en los tres primeros delegados, el sistema asume quela delegación ha fallado. A continuación, asigna la tarea al ejecutante original o al supervisorbasándose en la configuración de la actividad.La Guía del usuario de Documentum Administrator proporciona más información sobre cómoconfigurar esta opción.

• Para permitir que el ejecutante elija otro usuario o grupo que realice junto a él la tarea, marqueHacer que otra persona repita el trabajo de la actividad.

• Para hacer que el ejecutante cierre la sesión cuando haya finalizado la actividad, marque Esnecesario que el ejecutante cierre la sesión cuando termine.

Si necesita información detallada sobre las opciones de delegación y extensión, consulte Permitirla delegación y la extensión, página 25.

5. Si ha seleccionado una actividad automática, establezca los parámetros de ejecución.a. Active la casilla de verificación Ejecutar este método automáticamente para elegir un

parámetro de ejecución automática en la lista desplegable. (Esta casilla de verificación seactiva de manera automática al usar Documentum Process Builder 6.5 y versiones anteriores).Las acciones de la lista desplegable son métodos de flujo de trabajo.

Si no se activa la casilla de verificación de la opción Ejecutar este método automáticamente,el sistema utilizará el dm_bpm_noop_method suministrado para conectarse al repositorio ycompletar la actividad en lugar de iniciar un método en tiempo de ejecución. Esto significa queel sistema adquiere y completa la tarea en representación del ejecutante de la tarea.

Nota: Para que un método personalizado esté disponible aquí, el atributo a_special_app debeestar definido. El atributo a_special_app es un atributo dm_sysobject cuyo uso está reservadopara los productos de Documentum. Este atributo debe tener el valor de flujo de trabajo.Consulte la guía Documentum Process Builder Development Guide para obtener detalles sobreel desarrollo de métodos de flujos de trabajo personalizados.

b. Para guardar un registro de ejecución mientras se ejecuta el método automático, seleccione Síen ¿Desea guardar los resultados de la ejecución?

El sistema guarda los resultados de ejecución en la carpeta /Temp/BPM/Method Exec Results.Si el método falla, el sistema también guarda la salida en la carpeta /Temp/BPM/MethodExceptions.

Puede configurar el trabajo dm_DMClean para eliminar la salida de los flujos de trabajocompletados que permanecen en la carpeta /Temp/BPM/Method Exec Results. Utilizando



Documentum Administrator, establezca el argumento -clean_wf_method_exec_resulten True. El manual Documentum Administration Guide proporciona información detalladasobre cómo utilizar el trabajo dm_DMClean.

c. Especifique durante cuánto tiempo intentará el servidor de proceso ejecutar este método antesde salir. Introduzca una cantidad de segundos en el cuadro El método termina en.

6. Configure las opciones que debe usar el sistema en caso de que el método falle.

a. Si desea que el sistema reintente el método cuando falle, seleccione Reintentar y escriba unIntervalo de reintento para especificar un intervalo de tiempo entre los reintentos. Utilice elcampoMáximo de intentos para escribir un número máximo de veces que el sistema deberíareintentar antes de realizar una de las acciones especificadas en el paso 6c.

b. Si ha asignado un controlador de errores a esta actividad, el sistema muestra el nombre dela actividad del controlador de errores en el campo Pasar al controlador de errores. Elcontrolador de errores se ejecuta cada vez que el método falla.

Actividades, página 14 proporciona información detallada sobre este tema.

c. Decida si el flujo de trabajo debe continuar o detenerse si se produce algún problema.

• Si se selecciona Detener ejecución, la tarea se pondrá en pausa y se reasignará al supervisordel flujo de trabajo.

• Si se selecciona Continuar ejecución, la tarea se pondrá en estado adquirido y deberáser completada.

• Finalizar ejecución detiene el flujo de trabajo sin la opción de reiniciarlo.


Asociar un módulo de prioridad de colas de trabajoa una actividadPuede asociar un módulo de prioridad a una actividad en la ficha Ejecutante del Inspector deactividades. Definir valores de prioridad, página 27 proporciona información detallada sobre cómoestablecer prioridad dinámica y lógica de caducidad a un proceso.

Para asociar un módulo de prioridad de colas de trabajo a una actividad:

1. Abra el Inspector de actividades y seleccione la ficha Ejecutante.

2. Seleccione Cola de trabajo como ejecutante.

3. En el cuadro de lista Seleccionar módulo de prioridad de tarea, seleccione el módulo deprioridad.

Nota: Si se han seleccionado dos módulos distintos para un flujo de trabajo (uno en la definiciónde la actividad y otro en la política de cola de trabajos), el sistema utiliza el módulo seleccionadodesde la actividad para calibrar la caducidad y las prioridades.

Elegir ejecutantes manualesLos pasos necesarios para seleccionar los ejecutantes manuales de una actividad dependen de dosfactores:



• De si existe un único ejecutante de la actividad o varios.

• De si identifica a los usuarios reales ahora, como parte de la plantilla, o usa alias.

Si necesita información detallada sobre las opciones para seleccionar ejecutantes manuales, consulteElegir ejecutantes, página 21.Para elegir uno o varios ejecutantes manuales de una actividad:

1. En la ficha Ejecutante del Inspector de actividades, seleccione Por uno o más ejecutantesmanuales y haga clic en el botón Seleccionar ejecutante.

Aparece el cuadro de diálogo Seleccionar ejecutante.

2. En la lista desplegable, elija el usuario o grupo que realizará esta actividad.

Puede elegir un usuario o grupo específico, o una opción que determine al usuario concreto cuandose ejecute el flujo de trabajo. Las opciones son:• Cola de trabajo: la actividad la realizará un miembro de la cola de trabajo seleccionada.Si necesita más información sobre la asignación de niveles de habilidad de cola de trabajo alas tareas de una cola, consulte Asignar datos de proceso a un nivel de habilidad de cola detrabajo, página 117.

• Supervisor del flujo de trabajo: la actividad la realizará el supervisor del flujo de trabajo, quede forma predeterminada es el usuario que inicia el flujo de trabajo.

• Propietario del repositorio: la actividad la realizará el usuario que es propietario delrepositorio.

• Ejecutante de la actividad anterior: La actividad la realizará el mismo usuario que hayacompletado la actividad anterior en el flujo de trabajo. Esta opción puede incluir varios usuarios.Seleccione el nombre de la actividad que tenga el ejecutante o grupo de ejecutantes que deseapara compeltar esta actividad. Puede elegir una de dos opciones para seleccionar un ejecutante:

– Asignar al último ejecutante de la actividad anterior significa que la persona quedesencadenó la finalización de la actividad anterior es el ejecutante asignado.

– Asignar a todos los ejecutantes de la actividad anterior significa que todos los ejecutantesde la actividad identificada son los ejecutantes asignados.

• Usuario específico: la actividad la realizará un usuario elegido de forma específica.• Todos los usuarios del grupo: la actividad será realizada por todos los miembros de un grupoespecífico.

• Un solo usuario del grupo: la actividad la realizará un único miembro de un grupo determinado.• Algunos usuarios de un grupo: la actividad la realizarán algunos miembros de un grupoconcreto, aunque no todos.

• Varios ejecutantes secuenciales: la actividad la realizarán varios usuarios, uno detrás de otro.

El resto del procedimiento difiere en función de la opción que se seleccione. Si seleccionaSupervisor del flujo de trabajo o Propietario del repositorio, el usuario concreto se determinarácuando se ejecute el flujo de trabajo. Haga clic en Finalizar e ignore el resto de este procedimiento.

Si ha elegido cualquier opción excepto las dos primeras, en la pantalla aparece un cuadro conel título Definir ejecutantes. Seleccione una opción en este cuadro para especificar cómo seseleccionarán los ejecutantes específicos de esta actividad.

3. Si ha elegido Ejecutante de la actividad anterior, seleccione el nombre de la actividad que tieneel ejecutante o grupo de ejecutantes que desea para completar esta actividad. Puede elegir una odos opciones para seleccionar un ejecutante:



• Asignar al último ejecutante de la actividad anterior significa que la persona quedesencadenó la finalización de la actividad anterior es el ejecutante asignado.

• Asignar a todos los ejecutantes de la actividad anterior significa que todos los ejecutantes dela actividad identificada son los ejecutantes asignados.

4. Si ha elegido Varios ejecutantes secuenciales, especifique si todos los ejecutantes de estaactividad disponen del derecho de rechazar el paquete que reciban y de devolverlo al ejecutanteque les precedió en la secuencia.

Cuando seleccione la opción Permitir que ejecutantes de tareas secuenciales rechacen elejecutante anterior, aparecerá un icono en la actividad indicando que existe una opción derechazo.Los ejecutantes secuenciales no disponen de esta opción de forma predeterminada. Para que seencuentre disponible, marque la casilla situada justo debajo del cuadro Seleccionar ejecutantes.

5. Especifique si seleccionará a los ejecutantes de esta actividad ahora o si los determinará de formadinámica cuando el flujo de trabajo se encuentre en curso.

Elija una opción en el cuadro Definir ejecutantes:• Asignar ejecutantes ahora: seleccionará al grupo o usuario concreto como parte de la plantillade proceso.

• Hacer que los ejecutantes de la actividad <nombre de la actividad> determinen losejecutantes de la actividad <nombre de la actividad>: los ejecutantes de la actividad anteriorseleccionarán a los ejecutantes de esta actividad cuando se ejecute el flujo de trabajo. Si estaactividad cuenta con varias actividades anteriores, elija en la lista desplegable al ejecutante queseleccionará al ejecutante de esta actividad.

• Definir alias de ejecutante (los ejecutantes se asignarán cuando el flujo de trabajo esté encurso): un conjunto de alias determinará al ejecutante de esta actividad. Deberá especificar quéconjunto de alias se usa en los pasos siguientes. Esta opción no se encuentra disponible si haseleccionado Algunos usuarios de un grupo o Varios ejecutantes secuenciales.

• Seleccionar ejecutante según condiciones: el ejecutante de la actividad se determina mediantela lógica condicional definida por el usuario, incluidos los datos del paquete y las variablesde proceso.

• Seleccionar ejecutante según datos de proceso: el ejecutante de la actividad vienedeterminado por los datos de proceso que se especifiquen, incluidos datos de paquete, variablesde proceso y datos de ejecución.

6. Si ha elegido Un solo usuario del grupo, especifique qué usuario del grupo seleccionado realizarála actividad.

Seleccionará el grupo en el paso siguiente. Para especificar qué usuario del grupo realizará laactividad, elija una de las opciones del cuadro Seleccionar usuario de grupo por:• Primero en adquirir el elemento de trabajo: una vez finalizada la actividad anterior, se agregaun elemento de trabajo a la bandeja de entrada de cada usuario del grupo. El primer usuario queadquiere el elemento de trabajo de su bandeja de entrada es el ejecutante. Los elementos detrabajo se quitan de las bandejas de entrada del otro usuario.

• Cantidad menor de elementos de trabajo sin terminar: una vez finalizada la actividadanterior, se agrega un elemento de trabajo a la bandeja de entrada del usuario que tiene la menorcantidad de tareas sin terminar en la misma.

7. Haga clic en Siguiente para continuar. Los pasos necesarios para finalizar este procedimientodependen de la opción elegida.

Las siguientes secciones proporcionan más información sobre las opciones para definir ejecutantes:



• Asignar ejecutantes ahora, página 111• Hacer que el ejecutante de una actividad elija a otros ejecutantes, página 111• Definir alias de ejecutante (los ejecutantes se asignarán cuando el flujo de trabajo esté en curso),página 113

• Select performer based on conditions (Seleccionar ejecutante según condiciones), página 114

Asignar ejecutantes ahoraSe dispone de las opciones siguientes si se elige la opción para asignar ejecutantes ahora:

• Si seleccionó Cola de trabajo, resalte el nombre de la cola de trabajo y, a continuación, haga clic enSiguiente para abrir la pantalla de asignación de datos, en la que puede asignar datos de proceso alos niveles de habilidad definidos para la cola.Si necesita más información sobre la asignación de datos de proceso a los niveles de habilidad,consulte Asignar datos de proceso a un nivel de habilidad de cola de trabajo, página 117.

• Si ha seleccionado Usuario específico en la pantalla anterior, resalte el nombre de un grupo o<Todos los usuarios> en el cuadro de lista Grupos y elija al ejecutante de esta actividad entrelos usuarios del grupo seleccionado en el cuadro de lista Usuarios del grupo. Tras seleccionarun usuario, haga clic en Finalizar.

• Si ha seleccionado Todos los usuarios del grupo o Un solo usuario del grupo en la pantallaanterior, elija un grupo en el cuadro de lista Grupos y haga clic en Finalizar.

• Si ha seleccionado Algunos usuarios de un grupo o Varios ejecutantes secuenciales, puededesignar varios usuarios, grupos o nombres de alias para realizar la actividad. Consulte elprocedimiento en el tema Hacer que el ejecutante de una actividad elija a otros ejecutantes, página111 si necesita información detallada sobre las opciones que aparecen al hacer clic en Siguiente.Nota: Dado que ha seleccionado Asignar ejecutantes ahora, el servidor elegirá todos los usuariosde la lista generada como ejecutantes y no usará la lista para proporcionar una lista de selección alejecutante de una actividad anterior, como se describe en el tema Hacer que el ejecutante de unaactividad elija a otros ejecutantes, página 111.

Hacer que el ejecutante de una actividad elija a otrosejecutantesEsta función también se conoce como selección de ejecutante dinámico. Con esta opción, el ejecutantede una actividad tendrá la posibilidad de elegir a los usuarios que realizarán la siguiente actividad delflujo de trabajo. En tiempo de ejecución, el ejecutante de la actividad puede elegir uno o más usuariosdel grupo especificado.

Si ha seleccionado Algunos usuarios de un grupo o Varios ejecutantes secuenciales, puede designaruna combinación de varios usuarios, grupos o nombres de alias entre los cuales el ejecutante de laactividad anterior puede elegir en tiempo de ejecución. Si ha elegido cualquiera de los demás tipos deejecutantes, no es necesario realizar más definiciones del ejecutante. Esta página no se muestra.

Si necesita más información sobre alias y conjuntos de alias, consulte Usar alias, página 24.

Para seleccionar usuarios y grupos:

1. Elija una o varias opciones para seleccionar usuarios. Si selecciona más de una opción, lasopciones siguientes aparecerán en orden secuencial:• Usuarios o grupos específicos: seleccione los nombres de usuario y grupo ahora.



• Alias de ejecutante que se resolverán por el iniciador del flujo de trabajo: seleccioneconjuntos de alias y alias para los que el iniciador del flujo de trabajo proporcionará nombresde usuario y grupo específicos al iniciar el flujo de trabajo.

• Alias de ejecutante que se resolverán en tiempo de ejecución a partir del conjunto dealias: seleccione los conjuntos de alias y alias que el servidor usará en tiempo de ejecuciónpara determinar los grupos y usuarios reales.

2. Haga clic en Siguiente.

3. Si ha seleccionado Usuarios o grupos específicos, seleccione los nombres de los grupos ousuarios que pueden realizar esta actividad.

a. Resalte el nombre de usuario o grupo en la lista de la izquierda y haga clic en Agregar paraagregarlo a la Lista de selección de la derecha.

b. Repita el paso 3a con cada usuario o grupo que desee agregar.

c. Cuando la Lista de selección incluya todos los usuarios y grupos deseados, haga clic enSiguiente o en Finalizar (en función de si ha elegido otras opciones en el paso 1).

4. Si ha elegido Alias de ejecutante que se resolverán por el iniciador del flujo de trabajo y no hadefinido aún un conjunto de alias predeterminado para este flujo de trabajo, elija uno.• Para elegir un conjunto de alias existente, haga clic en Elija entre los conjuntos de aliasexistentes y seleccione un conjunto de alias en la lista desplegable. En esta lista se muestrantodos los conjuntos de alias del repositorio a los que esté conectado actualmente y para los quetenga permiso de escritura.

• Para elegir un nuevo conjunto de alias, haga clic en Crear nuevo conjunto de alias y escribaun nombre y una descripción para el mismo. El servidor creará un alias con la informaciónescrita en esta página y la siguiente.

Haga clic en Siguiente una vez que haya identificado el conjunto de alias.

5. Si ha elegido Alias de ejecutante que se resolverán por el iniciador del flujo de trabajo,identifique uno o varios alias para los que el iniciador del flujo de trabajo debe escribir valoresen el momento de iniciar el flujo.

a. Especifique si desea Crear un nuevo alias de ejecutante o Usar un alias de ejecutanteexistente sin definir. Un alias existente y sin definir es el que aparece en el conjunto de aliasaunque sin un nombre de usuario específico asignado en el conjunto.

b. Para crear un nuevo alias de ejecutante, escriba un nombre y una descripción y haga clic enAgregar para incluirlo en la Lista de selección.

c. Para usar un alias de ejecutante existente, seleccione el alias adecuado en la lista desplegableAlias de ejecutante existente y haga clic en Agregar para incluirlo en la Lista de selección.De forma opcional, puede modificar la descripción del alias de modo que el propósito delmismo quede claro para el iniciador del flujo de trabajo.

d. Una vez que la Lista de selección incluya todos los alias deseados, haga clic en Siguiente o enFinalizar (en función de si ha elegido la opción final en el paso 1).

6. Si ha elegido Alias de ejecutante que se resolverán en tiempo de ejecución a partir delconjunto de alias, seleccione los alias que el servidor resolverá entre los conjuntos de aliasseleccionados.

a. Seleccione un conjunto de alias en la lista Conjunto de alias y, a continuación, un aliasconcreto en la lista que aparece debajo de ésta.

b. Haga clic en Agregar para incluir el alias en la Lista de selección.



c. Repita los pasos 6a y 6b con cada alias que desee incluir. Asimismo, una vez seleccionado elconjunto de alias que desea mover, puede utilizar los botones de flecha hacia arriba y haciaabajo para cambiar la posición de los alias en la lista.

7. Haga clic en Terminar.

Definir alias de ejecutante (los ejecutantes se asignaráncuando el flujo de trabajo esté en curso)Si selecciona esta opción, deberá especificar qué conjunto de alias y alias usará el motor de procesoen tiempo de ejecución para determinar la persona real que realizará esta actividad. Primero elija unconjunto de alias e identifique después un alias concreto en él.

Si necesita más información sobre alias y conjuntos de alias, consulte Usar alias, página 24.

Para identificar el conjunto de alias y alias del ejecutante:

1. Seleccione qué conjunto de alias desea usar para resolver los alias. Las opciones son:• Conjunto de alias predeterminado (el iniciador del flujo de trabajo lo resolverá cuando elflujo de trabajo esté en curso): el servidor hace referencia al conjunto de alias definido deforma predeterminada para este flujo de trabajo. El conjunto de alias predeterminado se defineen el cuadro de diálogo Propiedades de plantilla. Si no se ha seleccionado ningún conjunto dealias, podrá establecerlo en la próxima página.

• Conjunto de alias específico: el servidor hace referencia al conjunto de alias cuyo nombre seha seleccionado en la lista desplegable adyacente. En esta lista se muestran todos los conjuntosde alias del repositorio a los que esté conectado actualmente y para los que tenga permiso deescritura.

• Conjunto de alias de documento en el paquete: el servidor hace referencia al conjunto dealias asignado a un documento en un paquete que recibe esta actividad. En la lista desplegable,elija qué conjunto de alias del paquete definido se usará. Si selecciona <Cualquiera>, elservidor examinará los conjuntos de alias de todos los paquetes hasta que encuentre la primeracoincidencia con el alias específico que se identifica en el paso 4.

• Conjunto de alias de ejecutante anterior: el servidor hace referencia al conjunto de aliasasignado al ejecutante de la actividad anterior. Use esta opción, por ejemplo, si esta actividad ladebe realizar el administrador del ejecutante de la actividad anterior. Si, en tiempo de ejecución,el ejecutante anterior no tiene un conjunto de alias asociado, el servidor usará el conjunto dealias perteneciente al grupo del ejecutante anterior. Si el grupo tampoco tiene un alias, seenviará la tarea de actividad fallida al supervisor del flujo de trabajo.


Si ha elegido la opción Conjunto de alias predeterminado pero aún no ha seleccionado unconjunto de alias predeterminado para este flujo de trabajo, debe seleccionar un conjunto de alias.

Si ha seleccionado una de las otras opciones o ya ha definido el conjunto de alias predeterminadodel flujo de trabajo, haga clic en Siguiente para pasar a una página en la que pueda elegir el aliasconcreto dentro de dicho conjunto. Omita el paso 3.

3. Si aún no ha definido un conjunto de alias predeterminado para este flujo de trabajo, elija uno.• Para elegir un conjunto de alias existente, haga clic en Elija entre los conjuntos de aliasexistentes y seleccione un conjunto de alias en la lista desplegable. En esta lista se muestrantodos los conjuntos de alias del repositorio a los que esté conectado actualmente y para los quetenga permiso de escritura.



• Para elegir un nuevo conjunto de alias, haga clic en Crear nuevo conjunto de alias y escribaun nombre y una descripción para el mismo. El servidor creará un alias con la informaciónescrita en esta página y la siguiente.

Haga clic en Siguiente una vez que haya identificado el conjunto de alias.

4. Identifique el alias específico dentro del conjunto de alias seleccionado.

Si ha elegido un conjunto de alias específico en el paso 2, la lista desplegable Alias de ejecutanteincluirá los alias definidos en dicho conjunto.

Si ha elegido un conjunto de alias que se seleccionará en tiempo de ejecución, como el conjunto deejecutante anterior, la lista desplegable Alias de ejecutante estará vacía. Escriba el nombre delalias en el cuadro. Asegúrese de que el nombre coincida exactamente con el nombre del conjuntode alias que encontrará el servidor. Si, en tiempo de ejecución, el servidor no encuentra unacoincidencia entre el alias de ejecutante y los alias disponibles en el conjunto, la tarea de actividadse devolverá al supervisor del flujo de trabajo junto con una notificación.


Select performer based on conditions (Seleccionarejecutante según condiciones)Puede determinar el ejecutante de una tarea dinámicamente, según la lógica condicional que hayadefinido en la actividad. El ejecutante se determina en función de la lógica y los datos de procesodefinidos en la tabla de decisiones.

En el lado izquierdo de la expresión se definen las condiciones, según los datos de los atributos delproceso. En el lado derecho de la expresión puede especificar el nombre de la cola de trabajo y delusuario o grupo que ejecutará la tarea una vez resuelta la lógica.

En tiempo de ejecución, el motor del proceso evalúa las reglas tal y como se han configurado y asignaun ejecutante para la actividad.

Para asignar un ejecutante según la lógica condicional:

1. Seleccione un tipo de ejecutante que cumpla los criterios de configuración de la lógica condicional.

Los valores válidos son:• Cola de trabajo• Usuario específico• Todos los usuarios del grupo• Un solo usuario del grupo• Algunos usuarios de un grupo• Varios ejecutantes secuenciales

2. En el cuadro de grupo Seleccionar ejecutantes, elija Seleccionar ejecutante según condiciones.

3. Haga clic en Siguiente para abrir el cuadro de diálogo que se utilizará para definir la consulta.

4. Resalte la fila de la tabla Consulta que comience con la palabra IF.

5. En la lista desplegable Consulta sobre, seleccione el objeto al que desea que se aplique estacondición:• El flujo de trabajo en ejecución: la condición verificará los atributos del objeto dm_workflow.



• Datos de procesos: la condición verificará los atributos del paquete de proceso o de la variablede proceso que haya seleccionado en la lista desplegable.

6. Si está consultando sobre datos de proceso, utilice el cuadro de lista Datos de proceso paraseleccionar un paquete o una variable de proceso asociada al proceso.

7. Según las selecciones realizadas en el paso 5, elija el atributo cuyo valor desea utilizar en lacondición.

La lista desplegable incluye los atributos del tipo de objeto seleccionado en el paso 5.

8. Si el atributo seleccionado tiene uno o más valores repetidos, indique qué valor de índice deseausar en esta condición; para ello, seleccione una de las cuatro opciones de la lista o escriba unvalor de índice válido.

Los valores válidos son: LAST, FIRST, ALL y ANY.

9. Elija un operador lógico de comparación en la lista desplegable Condición y escriba un valorde comparación en el cuadro de texto Valor.

Nota: No debe utilizar el operador de igual (=) con una variable de proceso de tipo float. El usodel operador igual y una variable de proceso de tipo float puede provocar que se trunquen ose pierdan datos.

10. Haga clic en la fila de la tabla Consulta que comience con la palabra SELECT.

11. En el cuadro Selección de ejecutante condicional, puede seleccionar un ejecutante de una lista,escribir una consulta usando DQL (Documentum Query Language, Lenguaje de consulta deDocumentum) o utilizar datos de proceso o parámetros de proceso para asignar el ejecutante.

• Si elige Seleccionar de una lista de ejecutantes, seleccione el ejecutante en la lista.

• Si puede seleccionar varios ejecutantes, elija un nombre de ejecutante y haga clic en Agregarpara moverlo a la lista de selección.

• Si elige Escriba una consulta DQL, escriba la consulta en el cuadro de texto y haga clic enValidar consulta para asegurarse de que la consulta es válida.

• Si elige Seleccionar de datos de proceso, puede seleccionar datos de proceso o un parámetrode proceso para asignar un ejecutante. Seleccionar ejecutante basado en los datos de procesoy parámetros de proceso, página 116 proporciona información detallada sobre cómo utilizardatos de proceso para asignar un ejecutante.

Puede considerar que necesita agregar atributos o elementos a algunos datos para completarla selección del ejecutante.

– Introducción a la herramienta de asignación de datos, página 139 proporciona procedimientospara utilizar la herramienta de asignación de datos.

– Usar atributos de repetición, página 149 proporciona detalles sobre cómo agregar y asignarlos atributos con valor de repetición.

– Asignar atributos de paquete, página 141 proporciona instrucciones para exponer otrosatributos de origen de un paquete que no aparecen actualmente en el árbol

Nota: La opción para seleccionar el ejecutante mediante datos de proceso sólo es válida paralos siguientes tipos de ejecutantes: usuario específico, cola de trabajo, un solo usuario de ungrupo y varios usuarios secuenciales.


13. Para agregar otra cláusula a esta condición, haga clic en los botones AND u OR y repita lospasos anteriores.



Si una condición incluye varias cláusulas, el servidor utilizará las reglas naturales deprioridad para evaluar la expresión. Es decir, las cláusulas conectadas mediante AND seevaluarán antes que las cláusulas conectadas mediante OR. Por ejemplo, imagine que lacondición tiene el formato que se muestra a continuación, donde las letras representancláusulas condicionales: IF A AND B AND C OR D AND E OR F SELECT Nombre deejecutanteEl servidor evalúa esta condición de la siguiente forma:IF (A AND B AND C) OR (D AND E) OR F SELECT Nombre de ejecutante

14. Una vez que todas las condiciones específicas se hayan definido, seleccione el ejecutante al que seasignará la tarea si no se cumple ninguna condición.

Cuando haya definido todas las condiciones, resalte la fila en la tabla Consulta que comiencecon la palabra ELSE y elija el ejecutante que se debe utilizar si no se cumple ninguna de lasdemás condiciones.

Seleccionar ejecutante basado en los datos de proceso yparámetros de procesoPuede resolver dinámicamente el ejecutante de una actividad según los datos de proceso o parámetrosde proceso encontrados en la actividad. El ejecutante puede ser el nombre de un usuario, grupo o colade trabajos. En general, sólo se pueden utilizar los atributos de cadena para seleccionar un ejecutante.

Para asignar un ejecutante según los datos de proceso1. Seleccione un tipo de ejecutante que cumpla los criterios para asignar el ejecutante según los

datos de proceso.

Los valores válidos son:• Cola de trabajo• Usuario específico• Usuario único en el grupo• Todos los usuarios del grupo• Algunos usuarios de un grupo

2. En el cuadro de grupo Seleccionar ejecutantes, elija Seleccionar ejecutante según datosde proceso.

3. Haga clic en Siguiente para mostrar el árbol de datos de proceso.4. Expanda los nodos del árbol de datos de proceso y seleccione el paquete, variable de proceso o

parámetro de proceso utilizados para asignar el ejecutante a la tarea.

Puede considerar que necesita agregar atributos o elementos a algunos datos para completarla selección del ejecutante.

Nota: Sólo se puede seleccionar un atributo en el árbol de datos de proceso.• Introducción a la herramienta de asignación de datos, página 139 proporciona procedimientospara utilizar la herramienta de asignación de datos.

• Usar atributos de repetición, página 149 proporciona detalles sobre cómo agregar y asignar losatributos con valor de repetición.

• Asignar atributos de paquete, página 141 proporciona instrucciones para exponer otros atributosde origen de un paquete que no aparecen actualmente en el árbol.




El atributo aparece en el cuadro de texto Expresión. Un signo de dólar $ rodea a los marcadores deposición (por ejemplo, Cola de trabajo: $Var0.name$).

Especificar ejecutantes en función de todos los valores de unatributo de repetición

Al especificar un ejecutante en función de los datos de proceso, puede seleccionar los atributos ALLde un valor de repetición para los siguientes tipos de ejecutantes:

• Algunos usuarios de un grupo

• Todos los usuarios del grupo

Al seleccionar los atributos ALL, el nombre del ejecutante aparece en el cuadro de texto Seleccionarejecutante como<user type>: $<variable or package name>.<attribute name>[ALL]$

Por ejemplo, si se seleccionan los ejecutantes como Algunos usuarios de un grupo y se utilizan losatributos ALL de una variable de proceso, la representación sería:Some users from a group: $Group_A.username[ALL]$

En tiempo de ejecución, el motor del proceso crea elementos de trabajo para todos los ejecutantesespecificados en el atributo del valor de repetición de los datos del proceso. Puede ser una combinaciónde nombres de usuario individuales así como nombres de grupo.

El motor del proceso crea los siguientes elementos de trabajo cuando se seleccionan atributos ALL derepetición:

• Algunos usuarios de un grupo:

El sistema determina si los valores de repetición son usuarios individuales o un nombre de grupo. Acontinuación, crea un elemento de trabajo para cada usuario individual y un elemento de trabajopara el grupo.

• Todos los usuarios del grupo:

El sistema determina si los valores de repetición son usuarios individuales o un nombre de grupo. Acontinuación, crea un elemento de trabajo para cada usuario individual de la lista y un elemento detrabajo para cada usuario del grupo.

Asignar datos de proceso a un nivel de habilidad decola de trabajo

Cuando crea una actividad que realiza una determinada cola de trabajos, selecciona el nombre de lacola y configura las habilidades necesarias para la actividad en la ficha Ejecutante de Inspector deactividades. Puede utilizar el asignador de datos de proceso para relacionar los datos de proceso depaquetes o variables con las habilidades definidas en la cola de trabajo. Al asignar datos de procesoa una habilidad, el sistema utiliza esta información para designar un procesador para la tarea entiempo de ejecución.



La asignación de datos de proceso a niveles de habilidad de una cola de trabajo es un paso opcional.Si no se asigna la habilidad, la tarea no la considerará necesaria y no se utilizará en la designacióndel procesador.

Nota: Antes de definir las habilidades de una actividad concreta, debe definir la cola de trabajojunto con los niveles de habilidad asociados a la cola. Además, el servidor Java Method Server sedebe estar ejecutando para que el sistema utilice estas asignaciones para asignar un procesador entiempo de ejecución.

Para asignar datos de proceso a un nivel de habilidad de cola de trabajo:

1. En la ficha Ejecutante, seleccione Por uno o más ejecutantes manuales.

2. Haga clic en Seleccionar ejecutante.

3. En el cuadro de diálogo Seleccionar ejecutante, seleccione Cola de trabajo en la lista desplegable.

4. Seleccione Asignar ejecutantes ahora.


6. Resalte el nombre de la cola de trabajo que se encargará de la tarea.

7. Haga clic en Siguiente para abrir la herramienta de asignación, que muestra la lista de datosde proceso en la columna izquierda y la cola de trabajo con sus habilidades relacionadas enla columna derecha.

8. Utilice la herramienta de asignación de datos para asociar atributos de los datos de paquete a losniveles de habilidad predefinidos en la cola de trabajo.

Consulte Understanding the data mapping tool, página 139 para obtener información detalladasobre el uso de la herramienta de asignación de datos.


10. Haga clic en Aceptar o en Aplicar para guardar la configuración.

Elegir ejecutantes automáticosEl ejecutante de actividades automáticas debe resolverse en un único usuario. Para mejorar elrendimiento de las actividades automáticas en el proceso, haga de un usuario (o grupo reducido deusuarios) el ejecutante de todas las actividades automáticas. Por ejemplo, si define un usuario, comoauto_executor, y hace de dicho usuario el ejecutante de todas las actividades automáticas, el tiempo deejecución de las actividades automáticas en cuestión aumentará considerablemente. Este requisitolimita las opciones disponibles para las actividades automáticas a las siguientes categorías de usuario:

• Supervisor del flujo de trabajo (el iniciador del flujo de trabajo de forma predeterminada)

• Propietario del repositorio

• Ejecutante de la actividad anterior

• Usuario determinado

Si no se selecciona a un usuario determinado, el servidor determina el usuario real en tiempo deejecución. Por motivos de seguridad, sólo un superusuario puede seleccionar un usuario específicocomo ejecutante para una actividad automática en Process Builder.

Para elegir al usuario cuyo acceso de seguridad se usa para una actividad automática:



1. En la ficha Ejecutante del Inspector de actividades, seleccione Automáticamente enrepresentación de un ejecutante y haga clic en Seleccionar ejecutante.

Aparece el cuadro de diálogo Seleccionar ejecutante.2. Elija el acceso de seguridad del usuario que usará la actividad automática:

• Supervisor del flujo de trabajo: la actividad automática usará los permisos del supervisor delflujo de trabajo, que de forma predeterminada son los permisos del usuario que lo inicia.

• Propietario del repositorio: la actividad automática usará los permisos del propietario delrepositorio.

• Ejecutante de la actividad anterior: la actividad automática usará los permisos del usuarioque ha realizado la actividad anterior en el flujo de trabajo.

• Usuario específico: la actividad automática usará los permisos de un usuario que se elijaen el paso siguiente.

3. Si ha elegido Usuario específico, seleccione el usuario cuyos permisos se usarán.a. Haga clic en Elegir para mostrar el cuadro de diálogo Seleccionar usuario.b. En el cuadro de lista Grupos, resalte el nombre de un grupo o <Todos los usuarios>. Los

usuarios del grupo seleccionado aparecen en el cuadro de lista Usuarios del grupo.c. Seleccione el usuario en el cuadro de lista Usuarios del grupo. El nombre del usuario aparece

en el cuadro de texto Selección.d. Haga clic en Aceptar.

El nombre del usuario seleccionado aparece en el cuadro de texto Usuario.4. Haga clic en Terminar.

El nombre del usuario seleccionado aparece en el cuadro de texto situado junto al botónSeleccionar ejecutante.

Definir desencadenadores de actividadesUn desencadenador es una señal que indica que la actividad puede empezar. Use la fichaDesencadenador para describir las condiciones que desencadenan la actividad y enviar el paquete ala bandeja de entrada del ejecutante.

Si la actividad presenta varios flujos entrantes, puede especificar el número de las actividades anterioresque se deben haber completado antes de que se inicie la actividad. La condición de desencadenamientoes la cantidad mínima de flujos de entrada que deben haber aceptado paquetes para que comience estaactividad. Por ejemplo, si una actividad tiene tres flujos de entrada, puede decidir que se inicie laactividad cuando dos de los tres hayan aceptado paquetes.

Nota: Cuando una actividad tiene más de un flujo entrante, representa una actividad de unión en elproceso comercial total. Es decir, los paquetes de rutas de acceso diferentes van juntos en el proceso.Para mostrar la acción de unión con claridad en la plantilla de proceso comercial, inserte una plantillade actividad Unir explícita en el flujo. La actividad Unir define las condiciones de desencadenamientopara la actividad siguiente, la cual solo tiene un flujo entrante: el de la actividad Unir. ConsulteUnir, página 183.

Si necesita más información sobre los desencadenadores de actividad, consulte Definir condiciones dedesencadenamiento, página 34.

Para definir el momento en el que se desencadena una actividad:



1. En el Inspector de actividades, seleccione la ficha Desencadenador.

2. Especifique cuántos flujos de entrada de actividades se deben haber completado antes de que seinicie esta actividad. Cuando una actividad solo tiene un flujo de entrada, estas opciones noson diferentes.

• Para iniciar esta actividad sólo cuando todas las actividades inmediatamente anteriores hayanfinalizado, seleccione Todos los flujos de entrada están seleccionados.

• Para iniciar esta actividad cuando un número de actividades anteriores se haya completado,seleccione Se ha seleccionado este número de flujos de entrada e introduzca la cantidad deactividades precedentes que deben finalizar antes de que se ejecute esta actividad. La cantidadtotal de flujos de entrada para esta actividad se muestra junto al cuadro de texto.

3. Para asegurarse de que una acción específica ocurre antes de que la actividad seleccionada seejecute, marque la casilla de verificación Y cuando llegue este evento y escriba un nombre deevento en el cuadro de texto adyacente.

Puede tratarse de un evento definido por el sistema, como dm_checkin, o se puede inventar unnombre de evento, como "promovido" o "presentado". Si incluye un evento de desencadenamientoen la condición de inicio, el servidor debe encontrar el evento identificado en la cola del flujode trabajo para que se inicie la actividad. Consulte el manual Documentum Content ServerFundamentals Guide para obtener más información sobre cómo definir y poner eventos en colausando la API de Documentum.

4. Para permitir que la actividad pueda ejecutarse más de una vez en el mismo flujo de trabajo, marquela casilla de verificación Esta actividad se puede ejecutar más de una vez en un flujo de trabajo.

Una actividad de repetición es una actividad que se puede usar más de una vez en un flujo detrabajo concreto. De forma predeterminada, las actividades se definen como de repetición. Lasactividades con varios ejecutantes que se realizan de forma secuencial no pueden ser de repetición.Elegir ejecutantes, página 21 describe las categorías de usuario para los ejecutantes.

Si usa una actividad varias veces en un flujo de trabajo, debe estructurarlo de modo que solo unainstancia de la actividad esté activa a la vez. El servidor no puede iniciar una actividad si laactividad anterior, basada en la misma definición, aún está en ejecución.


• Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de actividades.

• Haga clic en Aceptar para guardar las actualizaciones y cerrar el Inspector de actividades.

Establecer temporizadores de advertencia

Process Builder admite dos tipos de temporizador de advertencia en las actividades:

• Un pre-temporizador se pone en funcionamiento si una actividad no se ha desencadenado dentro deun período de tiempo especificado tras el inicio del flujo de trabajo.

La actividad se considera desencadenada una vez que la crea el flujo de trabajo, aunque el usuariono la haya adquirido. Los pre-temporizadores no se activan en la primera actividad de un flujo detrabajo, ya que se desencadenan de forma automática al iniciarse los flujos de trabajo.

• Un post-temporizador se pone en funcionamiento si una actividad no ha terminado dentro de unperíodo de tiempo especificado tras el inicio de la actividad.



Si precisa más información sobre temporizadores de flujo de trabajo, consulte Definir temporizadores,página 34.

Si una actividad tiene definida una o más acciones de temporizador, aparecerá un pequeño icono de relojen la esquina inferior derecha del icono de la actividad en el panel del editor de plantillas de proceso.

Para establecer acciones de temporizador:

1. En el Inspector de actividades, seleccione la ficha Temporizadores.

2. Para seleccionar un calendario de las acciones del temporizador, elija un calendario en el cuadro delista Seleccionar calendario.

La lista contiene todos los calendarios situados en la carpeta System/Workflow/Calendar.

• Seleccione un calendario comercial para que utilice un calendario personalizado en los cálculosdel temporizador.

• Seleccione Usar calendario de proceso para seguir utilizando el calendario especificado paratodo el proceso.

• Seleccione Sin calendario para utilizar el calendario del sistema para la actividad.Nota: Si se seleccionan distintos calendarios para un proceso y una actividad dentro de eseproceso, el sistema utiliza el calendario de la actividad para los temporizadores de la actividad.

Seleccionar un calendario para el proceso, página 71 proporciona más información sobrecalendarios.

Nota: Cuando una tarea llega a la bandeja de entrada del usuario, la fecha de vencimiento de latarea se puede calcular basándose en el calendario del sistema. La siguiente vez que se ejecuta eltrabajo del temporizador, el trabajo actualiza la fecha de vencimiento según el calendario comercial.

3. Haga clic en el botón + situado sobre el cuadro de lista para agregar un nuevo temporizador oresalte un temporizador existente en el cuadro de lista.

4. En la lista desplegable Evento, seleccione qué tipo de acción de temporizador desea crear:Vencimiento de pre-temporizador o Vencimiento de post-temporizador.

5. Especifique cuándo debe vencer el temporizador escribiendo el número de horas y minutostranscurridos en los cuadros de texto Vence en.

Si esta acción es el primer temporizador de un determinado tipo (pre-temporizador opost-temporizador), el temporizador vence cuando haya transcurrido el número especificadode horas y minutos desde el inicio del flujo de trabajo o actividad, respectivamente. Lostemporizadores posteriores vencen cuando haya transcurrido el número especificado de horas yminutos desde que venció el temporizador anterior.

Nota: Cuando se detiene una tarea de flujo de trabajo, no se detiene el post-temporizador asociado.El post-temporizador continúa teniendo en cuenta el tiempo designado para la tarea como sila tarea estuviera en curso.

6. Para enviar un mensaje de correo electrónico a un programa de correo electrónico de otrofabricante cuando un temporizador caduca (en lugar de utilizar la bandeja de entrada de Webtopo TaskSpace), active la casilla de verificación Usar plantilla de correo electrónico y, acontinuación, haga clic en el botón Seleccionar.

a. Seleccione la opción para elegir una plantilla existente del repositorio; también puedecrear una nueva plantilla de correo electrónico con la ayuda del Asistente para plantillade notificación.



Descripción del Asistente para plantilla de notificación, página 131 proporciona instruccionessobre cómo crear una nueva plantilla de correo electrónico.

b. Después de seleccionar una plantilla de correo electrónico existente o de crear una plantillanueva, el nombre de la plantilla de correo electrónico aparecerá en el campo Usar plantilla decorreo electrónico.

El servidor utiliza la plantilla de correo electrónico seleccionada para todas las notificacionesdel mismo tipo de evento (pre-temporizador o post-temporizador). Si no activa la casilla Usarplantilla de correo electrónico, el servidor enviará una notificación predeterminada a la bandejade entrada de Documentum de los usuarios.

7. Para enviar un mensaje de correo electrónico a un programa de correo electrónico de otrofabricante cuando un temporizador caduca (en lugar de utilizar la bandeja de entrada de Webtop oTaskSpace), active la casilla de verificación Usar plantilla de correo electrónico; a continuación,haga clic en el botón Seleccionar y elija la plantilla de correo electrónico personalizada que deseautilizar en la notificación.

a. Para abrir una plantilla existente, desplácese a la plantilla que se encuentra en la estructurade archivos y selecciónela.

b. Para Crear una nueva plantilla de correo electrónico, seleccione la opción y haga clic enAceptar.

c. Aparece el Asistente para plantilla de notificación, permitiéndole crear dinámicamente unanueva plantilla de correo electrónico. Descripción del Asistente para plantilla de notificación,página 131 proporciona las instrucciones sobre cómo utilizar el asistente con objeto de crearuna plantilla de correo electrónico.

8. Si desea que el servidor siga repitiendo la acción pre-temporizador o post-temporizador final hastacompletar la actividad, marque la casilla Repetir la última acción.

El valor de la opción Repetir la última acción se define con independencia de las acciones depre-temporizador y post-temporizador. Cuando se selecciona, el servidor realizará la última acciónde temporizador en el intervalo de tiempo especificado hasta completar la actividad.

9. En la lista desplegable Acción, seleccione el tipo de acción que se pondrá en funcionamientocuando venza el temporizador.

Las opciones disponibles dependen de si está definiendo un pre-temporizador o unpost-temporizador y de la naturaleza de la actividad actual:

• Notificación: permite Enviar una notificación, página 123 un mensaje a una o varias personas.

• Iniciar proceso: permite Iniciar un proceso, página 124 mediante los paquetes de la actividadactual.

• Ejecutar en método JAVA: permite Ejecutar un método Java, página 124 (disponibleúnicamente para los usuarios con privilegios de superusuario).

• Delegar tarea: permite Delegar tareas, página 125 en otro ejecutante (disponible únicamentepara post-temporizadores de actividades manuales). También se puede delegar una tarea a unejecutante en función de los datos de proceso.

• Completar tarea: permite Completar tareas , página 125 y reenviarla a la siguiente actividaddel flujo de trabajo (disponible únicamente para post-temporizadores manuales).

10. Repita estos pasos con cada temporizador que desee agregar a esta actividad.



11. Para cambiar el orden de un temporizador en el cuadro de lista, resalte la acción de temporizadory haga clic en los botones de flecha hacia arriba o flecha hacia abajo en la parte superior delcuadro de lista.

El orden es importante porque la hora de caducidad de un temporizador se expresa como undeterminado intervalo después de que haya vencido el temporizador anterior.


Enviar una notificación

Utilice esta opción para enviar una notificación de correo electrónico a una persona cuando caduqueel temporizador

Para enviar una notificación:

1. Haga clic en el botón Seleccionar que aparece junto al cuadro de texto Enviar notificación a paraidentificar a los usuarios que se desean notificar cuando el temporizador caduca.

Puede enviar notificaciones basadas en Grupos y Usuarios, un Alias o Datos de procesos.

2. Para enviar la notificación a Grupos y Usuarios, seleccione el botón de opción.

a. Resalte el nombre de usuario o de grupo en la mitad izquierda del cuadro de diálogo.

El cuadro Usuarios del grupo muestra los miembros del grupo seleccionado en el cuadroGrupos, permitiéndole seleccionar miembros individuales del grupo.

b. Haga clic en Agregar >> para desplazar las selecciones a la lista de selección.


3. Para enviar la notificación a los usuarios con un alias determinado, seleccione el botón de opción.

a. Seleccione el conjunto de alias en la mitad izquierda del cuadro de diálogo.

El cuadro de Alias de ejecutante muestra los alias asociados al conjunto de alias. Al seleccionarcualquiera de estos alias, el sistema muestra el nombre del conjunto de alias que tiene asignadoasí como la descripción del alias del ejecutante.

b. Haga clic en Agregar >> para desplazar la selección al cuadro de lista de la derecha.


4. Para enviar una notificación basada en datos de proceso, haga clic en el botón de opción.

El sistema muestra el árbol de datos de proceso.

a. Expanda los nodos del árbol de datos de proceso y seleccione los atributos que deseaseleccionar para la notificación.

Puede considerar que necesita agregar atributos o elementos a algunos datos para completar laselección del ejecutante.

• Introducción a la herramienta de asignación de datos, página 139 proporciona procedimientospara utilizar la herramienta de asignación de datos.

• Usar atributos de repetición, página 149 proporciona detalles sobre cómo agregar y asignarlos atributos con valor de repetición.

• Asignar atributos de paquete, página 141 proporciona instrucciones para exponer otrosatributos de origen de un paquete que no aparecen actualmente en el árbol



b. Haga clic en Agregar >> para desplazar la selección al cuadro de lista de la derecha.c. Haga clic en Aceptar.

Iniciar un procesoUtilice esta opción para iniciar un flujo de trabajo cuando el temporizador caduca.

Para iniciar un proceso:

1. Haga clic en el botón Seleccionar que aparece junto al cuadro de texto Iniciar proceso.2. Seleccione la plantilla de proceso para que se inicie el proceso.

La plantilla seleccionada debe aceptar el mismo número y tipo de paquetes que la actividad actual.3. Seleccione los usuarios que se van a notificar.

Enviar una notificación, página 123 proporciona información detallada sobre cómo seleccionarusuarios para las notificaciones.


Ejecutar un método JavaUtilice esta opción para ejecutar un método Java cuando el temporizador caduca.

Cuando la acción del post-temporizador designada es invocar un método, el trabajo del temporizadorinicia el método y pasa los siguientes argumentos al método:

• docbase_name <docbase>• serverconfig_name <serverconfig>• workflow_id <wflow id>• act_seqno <act_seqno>• timer_type <tipo de temporizador: 0 identifica un pre-temporizador y 1 identifica unpost-temporizador>

• user_name <nombre del propietario de instalación de docbase>Nota: Los métodos Java personalizados no se deben extender desde WorkflowMethod ya que estánreservados únicamente para los métodos automáticos.

Para iniciar un método Java:

1. Haga clic en el botón Seleccionar que aparece junto al cuadro de textoMétodo.2. Seleccione el método de flujo de trabajo para que se ejecute el temporizador vencido y haga

clic en Aceptar.

Nota: Para que un método personalizado esté disponible aquí, el atributo a_special_app debe estardefinido. El atributo a_special_app es un atributo dm_sysobject cuyo uso está reservado para losproductos de Documentum. Este atributo debe tener el valor de flujo de trabajo. Consulte la guíaDocumentum Process Builder Development Guide para obtener detalles sobre el desarrollo demétodos de flujos de trabajo personalizados.

3. Active la casilla de verificación Sí, guardar los resultados de la ejecución para guardar unregistro de ejecución cuando se ejecute el método.

4. Seleccione los usuarios que se van a notificar.




Delegar tareas

Utilice esta opción para delegar una tarea cuando el temporizador caduca.

Para delegar una tarea:

1. Haga clic en el botón Seleccionar que aparece junto al cuadro de texto Para los ejecutantes.

Aparece el cuadro de diálogo Seleccionar ejecutante. Puede asignar ejecutantes con arreglo aGrupos y Usuarios, un Alias o Datos de procesos.

2. Para seleccionar un ejecutante con arreglo a Grupos y Usuarios, seleccione el botón de opción.

a. Resalte el nombre de usuario o de grupo en la mitad izquierda del cuadro de diálogo.

El cuadro Usuarios del grupo muestra los miembros del grupo seleccionado en el cuadroGrupos y le permite seleccionar miembros individuales del grupo.

b. Haga clic en Agregar >> para desplazar las selecciones a la lista de selección.


3. Para seleccionar un ejecutante a partir de un Alias determinado, seleccione el botón de opción.

a. Seleccione el conjunto de alias en la mitad izquierda del cuadro de diálogo.

El cuadro de diálogo Alias de ejecutante muestra los alias asociados al conjunto de alias. Alseleccionar cualquiera de estos alias, el sistema muestra el nombre del conjunto de alias quetiene asignado así como la descripción del alias del ejecutante.



4. Para seleccionar un ejecutante basándose en datos de proceso, haga clic en el botón de opción.

El sistema muestra el árbol de datos de proceso.

a. Expanda los nodos del árbol de datos de proceso y seleccione el atributo del ejecutante.

Puede considerar que necesita agregar atributos o elementos a algunos datos para completar laselección del ejecutante.


• Usar atributos de repetición, página 149 proporciona detalles sobre cómo agregar y asignarlos atributos con valor de repetición.

• Asignar atributos de paquete, página 141 proporciona instrucciones para exponer otrosatributos de origen de un paquete que no aparecen actualmente en el árbol



Completar tareas

Utilice esta opción para completar una tarea cuando el temporizador caduca.



Al completar una tarea de forma automática, es aconsejable definir un atributo con un valor concretopara que una condición de transición de actividad pueda distribuirlo de distinta forma en funcióndel valor de dicho atributo.

Para completar una tarea:

1. Si desea que el temporizador defina un atributo de valor al completar la tarea, marque la casillaChange process data attributes (Cambiar atributos de datos de proceso).

Si no marca esta casilla, diríjase al paso 3.

2. En la lista desplegable Datos de procesos, seleccione la variable de proceso o el paquete paracuyo atributo el temporizador definirá un valor.

3. En la lista desplegable Atributo, seleccione el atributo cuyo valor debe definir el temporizador.

4. Si el atributo seleccionado puede tener más de un valor, indique qué valores de índice desea usaren esta condición; para ello, seleccione una de las cuatro opciones del cuadro de lista Índiceo escriba un valor de índice válido.

5. En el cuadro de texto Valor, introduzca el valor con el que el temporizador debe definir el atributoseleccionado.

6. Seleccione los usuarios que se van a notificar.


Definir las reglas de transición de actividadLas reglas de transición determinan cuáles son las actividades siguientes en el flujo de trabajo. El flujose cambia basado en la lógica de la transición que se define utilizando los datos de proceso. Si unaactividad presenta varios flujos salientes, tal vez desee que se envíen paquetes a todas las actividadessiguientes o solo a determinadas actividades, en función del resultado de la actividad. Por ejemplo,podría ofrecer a un ejecutante que revisara el diseño de un nuevo formulario la opción de reenviar eldiseño al siguiente revisor o devolverlo al diseñador para que lo corrija. Esta lógica de ramificacionesse configura creando flujos desde la actividad a las dos posibles actividades siguientes y permitiendo alejecutante elegir la ruta que desea seguir.

Nota: Si una actividad tiene varios flujos salientes con lógica de ramificaciones, representa un puntode decisión en el proceso comercial global. Para mostrar el punto de decisión con claridad en laplantilla de proceso comercial, inserte una plantilla de actividad División de la decisión explícita en elflujo. En lugar de definir una lógica de ramificaciones en la actividad actual, conecte ésta con unaactividad Decision Split (División de la decisión) y defina la lógica de ramificaciones en ella. ConsulteDecision Split (División de la decisión), página 182.

Si una actividad únicamente cuenta con un flujo de salida, no hay necesidad de definir una condiciónde transición. La ficha Transición se mostrará como no disponible con la opción Seleccionar todaslas actividades conectadas seleccionada. En el caso las actividades automáticas, normalmente nose debe seleccionar la opción Let the activity’s performer choose (Permitir que el ejecutante de laactividad elija) a menos que el método de flujo de trabajo automático de la actividad utilice el métodosetoutput para elegir las siguientes actividades. Documentum Process Builder Development Guideproporciona información detallada sobre este tema.

Definir transiciones de actividad, página 36 proporciona información detallada sobre las transiciones.



Para definir la acción de transición:

1. En el Inspector de actividades, seleccione la ficha Transición.

2. Determine la forma en la que la actividad selecciona las siguientes actividades a las que enviarpaquetes:

• Para enviar tareas a todas las actividades siguientes conectadas a ésta (incluyendo los flujos derechazo), elija Seleccionar todas las actividades conectadas.

• Para dejar que el ejecutante decida qué actividad se seleccionará cuando la actual hayaterminado, elija Permitir al ejecutante seleccionar las siguientes actividades.

• Para distribuir paquetes entre distintas actividades siguiendo un conjunto de condiciones, elijaSeleccionar las siguientes actividades según estas condiciones.

Si decide distribuir paquetes según un conjunto de condiciones, vaya al paso 6.

3. Si la actividad la llevan a cabo varios ejecutantes, es decir, si la opción seleccionada en la fichaEjecutante es Todos los usuarios del grupo o Algunos usuarios de un grupo, especifique cuántosejecutantes deben completar la tarea:

• Para hacer que sea necesario que todos los ejecutantes completen la tarea, seleccione el botón deopción Todos los ejecutantes completan la tarea.

• Para completar la actividad cuando un cierto número de ejecutantes completen la tarea,seleccione el botón de opción [ ] ejecutantes completen la tarea y escriba en el cuadro detexto el número de ejecutantes necesarios. Si el número que escribe es mayor que el númerode ejecutantes que reciben elementos de trabajo para esta actividad en tiempo de ejecución, elservidor completará la actividad cuando todos los ejecutantes completen la tarea.

Si elige Seleccionar todas las actividades conectadas en el paso 2, pase al paso 7.

4. Si deja que el ejecutante seleccione las siguientes actividades, especifique el número máximo deactividades que éste puede seleccionar mediante el cuadro de lista desplegable Seleccionar unmáximo de [ ] actividades.

En el cuadro de lista se muestra el número total predeterminado de actividades siguientesdisponibles. Puede seleccionar cualquier número entre 1 y este máximo. En tiempo de ejecución,el servidor no permitirá que el ejecutante seleccione un número mayor de actividades que elespecificado.

5. Si permite que un grupo de ejecutantes seleccione las actividades siguientes, es decir, si lacategoría del ejecutante es Todos los usuarios del grupo o Algunos usuarios de un grupo y laopción de transición es Permitir al ejecutante seleccionar las siguientes actividades, especifiquecuándo se van a reenviar los paquetes a las actividades siguientes seleccionadas.

• Para iniciar inmediatamente las actividades de rechazo seleccionadas, seleccione el botón deopción Cualquier ejecutante rechaza. Si cualquier ejecutante selecciona las actividades derechazo, las actividades se inician sin esperar por otras respuestas. Se omiten las seleccionesde los demás ejecutantes.

• Para iniciar inmediatamente las actividades de reenvío seleccionadas, seleccione el botón deopción Cualquier ejecutante reenvía. Si cualquier ejecutante selecciona las actividades dereenvío, las actividades se inician sin esperar por otras respuestas. Se omiten las seleccionesde los demás ejecutantes.

• Para iniciar las actividades siguientes seleccionadas sólo cuando los ejecutantes identificadosen el paso 3 hayan completado la tarea, haga clic en el botón de opción Todos los ejecutantescompletan la tarea. Con esta opción, el servidor combina las selecciones de todos losejecutantes. Si algunos usuarios seleccionan actividades de reenvío y otros seleccionan



actividades de rechazo, el servidor determina qué actividades iniciar basándose en el conjuntofinal de botones de opción de esta ficha.

– Para iniciar todas las actividades seleccionadas por los ejecutantes, tanto las de reenvío comolas de rechazo, haga clic en Iniciar todas las actividades seleccionadas.

– Para iniciar sólo las actividades de rechazo seleccionadas (en el caso de que las haya), hagaclic en Sólo iniciar actividades de rechazo. Las actividades de reenvío sólo se inician sitodos los ejecutantes seleccionan actividades de reenvío.

– Para iniciar sólo las actividades de reenvío seleccionadas (en el caso de que las haya), hagaclic en Sólo iniciar actividades de reenvío. Las actividades de rechazo sólo se inician sitodos los ejecutantes seleccionan actividades de rechazo.

6. Especifique las condiciones que el servidor usa para determinar qué actividades reciben paquetes.

Consulte Crear condiciones de transición, página 128 si precisa más información sobre la creaciónde condiciones de transición.

7. Siga uno de estos procedimientos:• Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de actividades.• Haga clic en Aceptar para guardar las actualizaciones y cerrar el Inspector de actividades.

Crear condiciones de transiciónCuando elige la opción Seleccionar las siguientes actividades basadas en condiciones, aparece unatabla que la que se muestran las condiciones de transición definidas. Esta tabla estará en blanco laprimera vez que defina una actividad. Siga este procedimiento para agregar condiciones de transiciónde modo que se elijan automáticamente las siguientes actividades en el flujo de trabajo. Si necesita másinformación sobre las condiciones de transición, consulte Definir transiciones de actividad, página 36.

Nota: Si una actividad utiliza condiciones de transición, los flujos que llevan a las siguientesactividades tienen un diamante en el comienzo de la línea de flujo. Este formato sigue la normaBusiness Process Modeling Notation (BPMN).

Para crear una condición de transición:

1. Resalte la fila de la tabla Consulta que comience con la palabra IF.

El sistema muestra la ficha Asistente para transición y la ficha Edición manual

2. Para usar la Edición manual y crear una condición personalizada, escriba el texto en el cuadro detexto y haga clic en Aplicar para agregar la condición a la consulta.

a. Para utilizar el Asistente para transición para crear la condición, seleccione un objeto en lalista desplegable Consulta sobre. Este es el objeto al que desea que se aplique esta condición.Las opciones válidas son:

• El flujo de trabajo en ejecución: la condición verificará los atributos del objetodm_workflow.

• El último elemento de trabajo completado de la actividad: la condición verificará losatributos del objeto dmi_workitem.

• Datos de procesos: la condición verificará los atributos del paquete de proceso o de lavariable de proceso que haya seleccionado en la lista desplegable.

b. Si está consultando en Datos de proceso, utilice el cuadro de lista para seleccionar un paqueteo una variable de proceso asociada al proceso.



c. Si el paquete de entrada seleccionado es un documento XML y desea que esta condicióncompruebe un valor de un elemento XML interno, marque la casilla de verificación ExpresiónXPath e indique el elemento XML cuyo valor desea utilizar en la condición.

• En el cuadro de texto Esquema, escriba el nombre descriptivo del esquema XML con el quecumple el documento del paquete. Puede escribir el nombre en el cuadro de texto, hacer clicen Local para elegir el esquema en el sistema de archivos local o hacer clic en Repositoriopara elegir el esquema en el repositorio de Documentum.Este paso es opcional. Si el esquema no está disponible, deje en blanco el cuadro de texto.

• En el cuadro de texto Expresión XPath, cree la expresión XPath del elemento que deseeusar en la condición. Si ha seleccionado un esquema en el paso a, puede hacer clic en elbotón Seleccionar para elegir de entre una lista de expresiones XPath válidas. Si no haseleccionado ningún esquema en el paso a, haga clic en el enlace Escribir expresión yescriba la expresión XPath completa en el cuadro de diálogo que aparecerá. Después deescribir la expresión, seleccione el tipo de datos XML del elemento identificado y hagaclic en Aceptar.

Si no ha marcado la casilla Expresión XPath, elija el atributo del repositorio de Documentumcuyo valor desee usar en la condición.

La lista desplegable incluye los atributos del tipo de objeto seleccionado en el paso 2.

Si ha elegido un tipo de datos sencillo como una variable de proceso (cadena, booleano, entero,doble o datos), la lista no estará disponible. Los tipos de datos estructurados aparecen en elcuadro para la selección.

Si aparece una lista desplegable con el título Repitiendo atributo, elija o introduzca uníndice, el atributo seleccionado puede tener más de un valor. Indique qué valores de índicedesea usar en esta condición seleccionando una de las cuatro opciones de la lista o escribiendoun valor de índice. Si la condición de transición incluye una referencia a un atributo derepetición, dicho atributo debe tener, al menos, un valor. De lo contrario, la condición generaráun error en su evaluación.

d. Especifique la prueba que desea realizar en el atributo seleccionado.

Elija un operador lógico de comparación en la lista desplegable Condición y escriba un valorde comparación en el cuadro de texto Valor. El tipo de dato del atributo seleccionado semuestra debajo del cuadro.

3. Seleccione las actividades que se deben ejecutar a continuación cuando se cumpla esta condición;para ello, resalte los nombres de las actividades en el cuadro de lista situado en la parte inferior dela página.

La lista muestra los nombres de las actividades conectadas a ésta por medio de flujos. Paraseleccionar más de una actividad, mantenga presionada la tecla Ctrl o Mayús mientras hace clicen los nombres de las actividades.

Nota: Debe seleccionar una actividad en este momento aunque tenga previsto agregar máscláusulas a la condición.

4. Para agregar otra cláusula a esta condición de transición, haga clic en los botones AND u ORsituados junto a la etiqueta Agregar otra cláusula y repita los pasos del 2 al 6.

Si una condición incluye varias cláusulas, el servidor utilizará las reglas naturales de prioridad paraevaluar la expresión. Es decir, las cláusulas conectadas mediante AND se evaluarán antes que lascláusulas conectadas mediante OR. Por ejemplo, imagine que la condición tiene el formato que semuestra a continuación, donde las letras representan cláusulas condicionales:



IF A AND B AND C OR D AND E OR F SELECT Actividad 1

El servidor evalúa esta condición de la siguiente forma:

IF (A AND B AND C) OR (D AND E) OR F SELECT Actividad 15. Para agregar otra condición de transición, haga clic en el botón + situado sobre el cuadro de

la consulta (se agregará una fila nueva que empezará por ELSE IF) y, a continuación, repitalos pasos anteriores.

6. Una vez que todas las condiciones de transición específicas se hayan definido, seleccione lasactividades a las que se distribuyen los paquetes, si no se cumple ninguna condición.

Cuando haya definido todas las condiciones de transición, resalte la fila en la tabla Consulta quecomience con la palabra ELSE y seleccione las actividades que se deben realizar si no se cumpleninguna de las demás condiciones.

Definir notificacionesEn la ficha Notificación, puede establecer los mensajes que envía el servidor en respuesta a loseventos relacionados con flujo de trabajo como los cambios de estado de la actividad, un error demétodo durante un evento automático, etc. Los usuarios registrados para recibir notificación delevento recibirán un mensaje elaborado con la plantilla de correo electrónico asociada a dicho evento.Configurar notificaciones, página 36 proporciona información detallada sobre este tema. Tambiénpuede enviar las notificaciones en respuesta a los temporizadores del flujo de trabajo. Establecertemporizadores de advertencia, página 120 proporciona información detallada sobre este tema.

Nota: El servidor no envía una notificación Al inicio de un elemento de trabajo para las actividadesautomáticas.

Para especificar los mensajes de correo que se utilizan para las notificaciones:

1. En el Inspector de actividades, elija la ficha Notificación.

En esta ficha se muestran los nombres de los eventos para los que se envían las notificaciones.El nombre de la plantilla de correo electrónico que se utiliza para la notificación aparece bajo elnombre del evento.

2. Para utilizar una plantilla de correo electrónico personalizada en lugar del mensaje de notificaciónpredeterminado para un evento, marque la casilla de verificación Cambiar plantilla de correoelectrónico junto al nombre del evento.

El botón Seleccionar se vuelve activo al marcar la casilla.a. Seleccione la opción para elegir una plantilla existente del repositorio; también puede

crear una nueva plantilla de correo electrónico con la ayuda del Asistente para plantillade notificación.

Descripción del Asistente para plantilla de notificación, página 131 proporciona instruccionessobre cómo crear una nueva plantilla de correo electrónico.

b. Después de seleccionar una plantilla de correo electrónico existente o de crear una nueva, elnombre de la plantilla de correo electrónico aparece debajo del nombre del evento.

3. Si fuera necesario, repita el paso 2 para cada uno de los eventos para los que el sistema envía unanotificación por correo electrónico.




Descripción del Asistente para plantilla denotificaciónUtilice el Asistente para plantilla de notificación para crear dinámicamente plantillas decorreo electrónico desde dentro de una actividad. Las plantillas de notificación de correoelectrónico pueden basarse en datos de proceso, permitiéndole guardar las plantillas en la carpeta/System/Workflow/EmailTemplates. Las plantillas se pueden compartir entre procesos, aunque no serecomienda ya que las plantillas están basadas en asignaciones y en datos de proceso específicos deun proceso.

Nota: Si se modifican las asignaciones en la plantilla de notificación, la plantilla cambia en todo elsistema. Todas las actividades que utilizan dicha plantilla se actualizarán inmediatamente para reflejarlos cambios realizados.

La lista de remitentes y destinatarios predeterminados de la notificación está basada en el tipo de evento.El sistema envía la notificación al destinatario predeterminado además de a cualquier destinatarioespecificado por las asignaciones. Si al campo De del correo electrónico se le asigna a un valor, el valorasignado anula el remitente predeterminado y el sistema utiliza sólo el valor del remitente asignado.

Tabla 8 Remitente y destinatario predeterminado basados en evento

Nombre de evento Descripción Remitente

predeterminado

Destinatario

predeterminado

dm_startedworkitem Se crea una nueva tarea Usuario cuya acción ha

desencadenado la generación

de la nueva tarea, por

ejemplo, el ejecutante de la

actividad anterior

Ejecutante de la tarea

dm_delegatedworkitem La tarea se delega o

reasigna

Usuario que ha delegado la

tarea

Usuario de destino

dm_changedactivity

instancestate

Fallo en la tarea

automática

Ejecutante de la tarea Supervisor del flujo

de trabajo

El pre-temporizador ha

vencido

El pre-temporizador ha

vencido

Propietario de la instalación

del repositorio

Los usuarios o

grupos que se han

seleccionado para

recibir notificaciones

en la lista de

pre-temporizadores

El post-temporizador ha

vencido.

El post-temporizador

ha vencido.

Propietario de la instalación

del repositorio

Usuarios o grupos

que se han

seleccionado para

recibir notificaciones



Nombre de evento Descripción Remitente

predeterminado

Destinatario

predeterminado

en la lista de

post-temporizadores

Crear una nueva plantilla de correo electrónicoPara crear una nueva plantilla de correo electrónico:

1. En el Inspector de actividades, elija la ficha Notificación.

2. Seleccione la opción para Crear una nueva plantilla de correo electrónico y haga clic enAceptar.

3. Escriba el nombre de la plantilla utilizando únicamente caracteres alfanuméricos.

No se permiten los espacios, subrayados ni caracteres especiales.

4. Escriba el asunto de la notificación.

Puede utilizar texto estático o marcadores de posición que se asignan a los datos de proceso pararepresentar texto dinámico.

• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo, $orderno paraun número de orden).

• Utilice dos signos de dólar $$ para crear marcadores de posición con varios valores.• Para utilizar un signo de dólar en la notificación, utilice \$ (por ejemplo, quinientos dólares seexpresarían como \$500.00).Nota: Los valores de los marcadores de posición deben ser caracteres alfanuméricos sinespacios. El marcador de posición comienza después del signo de dólar $ y finaliza con elprimer carácter no alfanumérico.

Por ejemplo, para enviar un mensaje que indique que un pedido se ha procesado correctamente,utilice el siguiente texto de plantilla: El pedido de compra $orderno se procesó correctamente.El marcador de posición, numpedido aparece en la pantalla de asignación de datos y puedeasignarse a una variable de proceso o paquete. La notificación enviada tiene el siguiente asunto: Elpedido de compra 0896523 se procesó correctamente, donde 0896523 es el valor sustituido desdela asignación de datos de respuesta.

Nota: Todos los valores de marcador de posición deben asignarse a los datos de proceso.

5. Escriba el texto de la plantilla de correo electrónico en el cuadro de texto Plantilla de cuerpo.

Puede incluir texto estático, HTML copiado de un editor HTML de otro fabricante y parámetros demarcador de posición que se pueden asignar a los datos de proceso.

Si va a incluir formato HTML en el cuerpo del correo electrónico, debe asignar el valortexto/html constante al Contenido-Tipo del nodo Cuerpo del mensaje de correo electrónico.Si Contenido-Tipo no está asignado a un valor, el tipo de contenido es texto/llano de formapredeterminada.

• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo, $orderno).• Utilice dos signos de dólar $$ para crear marcadores de posición con múltiples valores.



• Para utilizar un signo de dólar en el cuerpo del mensaje de correo electrónico, utilice \$ (porejemplo, quinientos dólares se expresarían como \$500.00).

Nota: Los valores de los marcadores de posición deben ser caracteres alfanuméricos sinespacios. El token del marcador de posición comienza después del signo de dólar $ y finalizacon el primer carácter no alfanumérico. Asimismo, todos los valores de marcador de posicióndeben asignarse a los datos de proceso.

6. Haga clic en Siguiente para crear la asignación del mensaje de entrada asociando los datos deproceso al mensaje de correo electrónico.

La estructura del mensaje de correo electrónico aparece en el panel derecho y los datos de procesoen el lado izquierdo. Puede establecer los valores para los atributos de mensaje de correoelectrónico asignándolos desde los atributos del modelo de datos de proceso. Si tiene varios anexosdel correo electrónico, puede hacer clic en Agregar en el nodo Anexo para agregar más anexos.

Nota: El sistema invoca la plantilla de correo electrónico una vez para cada usuario definidoen el campo Notificación. Si un destinatario también está asignado en la plantilla de correoelectrónico, se envía un correo electrónico a ese destinatario para cada usuario definido en laficha Temporizador. Si hay tres usuarios seleccionados para recibir notificación y un destinatarioasignado al campo Para: de la plantilla, el sistema envía una notificación a cada uno de los tresusuarios y, además, envía tres copias de las notificaciones al usuario especificado en la asignaciónPara:.

Puede considerar que necesita agregar atributos o elementos a algunos datos para completarlas asignaciones.



• Asignar atributos de paquete, página 141 proporciona instrucciones para exponer otros atributosde origen de un paquete que no aparecen actualmente en el árbol

Nota: Todos los nodos de marcadores de posición bajo los nodos Asunto y Cuerpo deben asignarseen este punto. No es necesario realizar asignaciones en los campos de destinatario.

7. Haga clic en Siguiente para asignar el mensaje saliente.

Por ejemplo, si agregó una variable de proceso MsgId, puede asignar el atributo de Id. de mensajede notificación del mensaje de origen a esa variable de proceso.






La plantilla se vuelve la plantilla predeterminada para la notificación específica para la que laha creado.



Cambiar datos de proceso en una actividadAl configurar una actividad, deberá especificar los datos de proceso que se utilizarán durante laactividad y definir la forma en que la actividad tratará los paquetes, los parámetros de proceso o lasvariables de proceso que forman parte de la plantilla de proceso. Los datos de proceso se definen en laficha Datos del componente Propiedades de proceso. Gestionar los paquetes, página 65 proporcionamás información sobre cómo agregar datos de proceso a la plantilla de proceso.

La ficha Datos del Inspector de actividad muestra una vista de árbol de los datos de proceso,organizados en categorías asociadas a los paquetes, parámetros de proceso o las variables de procesoutilizadas en el proceso. El cuadro de lista muestra la información disponible sobre los datos deproceso, como el tipo, la versión y otros atributos específicos de los datos de proceso.

Para obtener información sobre los paquetes individuales, parámetros de proceso o variables deproceso, resalte el nodo específico para Paquetes, Parámetros de proceso o Variables de proceso. Enel caso de los paquetes, los campos nombre, tipo y versión son de sólo lectura y únicamente se puedenmodificar en la página Process Properties (Propiedades de la plantilla de proceso). La información delas variables de proceso y de los parámetros de proceso se puede modificar en la vista de nodo.

Puede cambiar cómo la actividad controla los datos de proceso seleccionando o desactivando lascasillas de verificación que están disponibles en la ficha Datos.

Editar los datos de proceso de un paqueteexistentePara editar los datos de proceso del paquete existente:

1. En el Inspector de actividades, elija la ficha Datos.

2. Expanda el nodo Paquetes y seleccione uno de los paquetes del árbol.

La lista de paquetes procede de la definición de plantilla de proceso.

3. En la lista desplegable Formulario, elija la plantilla de formulario (de haber alguna) que seutilizará para mostrar este paquete al ejecutante de la actividad.

De forma predeterminada, aparece la plantilla de formulario asignada al paquete en el cuadrode diálogo Propiedades de proceso. Sólo se muestran en la lista desplegable las plantillas deformulario que utilicen el mismo modelo de datos que la plantilla de formulario predeterminada.Consulte Asociar plantillas de formulario con paquetes, página 33 para obtener detalles sobreel uso de formularios en un flujo de trabajo.

Si no se asigna ninguna plantilla de formulario al paquete, Task Manager utilizará las opcionespredeterminadas para mostrar el contenido del paquete, lo que normalmente permite que elusuario lo abra en la aplicación asociada al tipo de documento, por ejemplo, Microsoft Wordpara documentos de Word.

4. Para que el formulario seleccionado en el paso 3 muestre las propiedades del paquete, marquela casilla de verificación Usar formulario para propiedades.

Si la casilla de verificación Usar formulario para propiedades no está activada, el formulariodel paso 3 aparece cuando el ejecutante de una actividad selecciona el paquete desde su bandejade entrada. El formulario se utiliza para guardar el contenido del paquete. Cuando la casilla de



verificación está activada, el formulario aparece cuando el ejecutante ve las propiedades delpaquete. El formulario se utiliza para establecer las propiedades del paquete en el repositorio,no el contenido del paquete.

5. Para que este paquete esté disponible para el ejecutante de esta actividad, marque la casilla deverificación Visible en esta actividad.

Si no activa la casilla de verificación Visible en esta actividad, el ejecutante de la actividad noverá el paquete. No obstante, éste seguirá disponible para las condiciones de transición.

6. Para requerir que el paquete tenga un objeto de contenido asociado, marque la casilla deverificación Éste es un paquete obligatorio.

Si no marca esta casilla, el ejecutante de la actividad podrá asignar contenido al paquete, pero noserá obligatorio que lo haga.

7. Para permitir que Process Builder publique los datos de informes en la base de datos de BAM delpaquete, seleccione Este paquete se puede utilizar para generar informes.

8. Repita los pasos 2 a 6 con cada paquete del proceso.

Siga uno de estos procedimientos:

• Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de actividades.• Haga clic en Aceptar para guardar las actualizaciones y cerrar el Inspector de actividades.

Iniciar automáticamente un paquete desde unaactividad manualPara iniciar un paquete automáticamente desde una actividad manual:

1. Resalte el nodo Paquetes.

La visualización de página cambia para mostrar sólo los paquetes asociados al flujo de proceso.

2. Haga clic en Inicio automático de paquete para que se muestre automáticamente un paquete oformulario asociado cuando se inicie la actividad.

Esta opción permite a este paquete mostrarse en seguida. De forma predeterminada, cuando unejecutante inicia una actividad desde la bandeja de entrada, aparece Task Manager que muestracada paquete como un enlace. El ejecutante hace clic en un enlace para mostrar el paquete (a travésdel formulario asignado al paquete o de la aplicación asociada al tipo de documento).

3. Seleccione el nombre del paquete que se va a iniciar desde la lista desplegable.

Cambiar las variables de proceso existentesPara cambiar las variables de proceso existentes:


2. Resalte el nodo Variables de proceso.

La visualización de página cambia para mostrar sólo las variables de proceso asociadas a laplantilla de proceso.



3. Para hacer que las variables estén disponibles para el ejecutante de esta actividad, active la casillade verificación Esta variable es visible en esta actividad.

Si esta casilla de verificación no está activada, el ejecutante de la actividad no verá esta variable.

4. Para exponer esta variable y utilizarla al generar informes, marque la casilla de verificación Estavariable se puede utilizar para generar informes.

Editar las variables de proceso existentesPara editar los parámetros de proceso existentes:


2. Resalte el nodo Parámetros de proceso.

La visualización de página cambia para mostrar sólo los parámetros de proceso asociados a laplantilla de proceso.

3. Para exponer esta variable y utilizarla al generar informes, marque la casilla de verificación Estavariable se puede utilizar para generar informes.

Cambiar la configuración de vistaLas opciones de la ficha Visualización controlan la forma en la que se mostrará la actividad en laplantilla de proceso.

Nota: Si una actividad tiene definida una o más acciones de temporizador, aparecerá un pequeño iconode reloj en la esquina inferior derecha del icono de la actividad en el panel del editor de plantillasde proceso.

Para cambiar la configuración de vista de una actividad:

1. En el Inspector de actividades, seleccione la ficha Visualización.

2. Para cambiar el gráfico que representa la actividad en la plantilla, seleccione Examinarrepositorio o Examinar local para buscar una imagen nueva.

3. Desplácese al archivo que contiene el gráfico.• Si está examinando el sistema de archivos local, desplácese al archivo y haga clic en Abrir.• Si está examinando el repositorio, desplácese al archivo y haga clic en Seleccionar.

El archivo seleccionado aparece en el cuadro Archivo de imagen.

Nota: Si selecciona una imagen externa a la ubicación estándar de las imágenes de actividad(que es la carpeta del repositorio System/Workflow/Images), Process Builder guardará unacopia de la misma en la carpeta una vez que haya guardado la actividad. Si utiliza Examinarlocal para elegir una imagen externa al directorio de la ubicación estándar C:\Archivos deprograma\Documentum\BPM\classes\images, Process Builder importará el archivo de imagen a lacarpeta System/Workflow/Images del repositorio.

4. Para cambiar el tamaño del gráfico que representa la actividad, seleccione un porcentaje en lalista desplegable Tamaño de imagen.

Se trata del porcentaje del tamaño real del gráfico.



5. Indique si se debe mostrar una etiqueta para la actividad; para ello, active o desactive la casillade verificación Mostrar etiqueta.

Si desactivaMostrar etiqueta, omita los pasos 5 y 6.

6. Decida si desea mostrar una etiqueta para la actividad con su Nombre o Ejecutante.

Tenga en cuenta que los mensajes de error, como los producidos durante la validación de plantillas,harán referencia a las actividades por su nombre. Si asigna a las actividades el nombre delejecutante, puede cambiar esta configuración de forma temporal a Nombre para poder encontrarla.

7. Defina la fuente y el estilo usados para designar la actividad en la plantilla.

• Seleccione una fuente en la lista Fuente de etiquetas.

• Seleccione un tamaño en la lista desplegable Tamaño de puntos.

• Para definir el estilo de fuente de la etiqueta, marque o quite la marca de Negrita y Cursiva.


• Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de actividades.

• Haga clic en Aceptar para guardar las actualizaciones y cerrar el Inspector de actividades.




Capítulo 8

Asignar elementos de datos de proceso


• Introducción a la herramienta de asignación de datos

• Agregar o editar datos de proceso en el asignador

• Asignar atributos de paquete

• Asignar comentarios de tarea como datos de proceso

• Agregar las propiedades del mensaje

• Agregar un esquema XML al contenido de la actividad

• Incorporar formularios de Forms Builder a procesos

• Agregar un nodo basado en una condición

• Asignar los datos

Introducción a la herramienta de asignación dedatosLa herramienta de asignación de datos proporciona una herramienta de asignación de datos gráficosque simplifica el proceso de pasar los datos del flujo de trabajo. La herramienta le permite asignarlos datos entre los datos de proceso, parámetros de proceso o atributos de flujo de trabajo del ladoizquierdo de la ventana a los atributos de servidor o de flujo de trabajo del lado derecho de la ventana.Esto puede incluir orígenes de datos como argumentos de método de flujo de trabajo, parámetros deservicios web, valores de devolución de consulta de bases de datos y atributos específicos de servicioscomo JMS, HTTP, FTP, etc.

Además, al definir los ejecutantes, puede utilizar el asignador de datos para relacionar los datos deproceso de paquetes o variables del flujo con las habilidades que definió en la cola de trabajo.

Muchas actividades automatizadas requieren la asignación de la información de un origen de datos aotro. Por ejemplo, supongamos que un proceso de un origen de préstamo incluye una actividad quellama a un servicio Web para buscar la puntuación de crédito de un cliente. La actividad debe pasarel número de la seguridad social desde el paquete de la solicitud del préstamo al servicio Web y, acontinuación, copiar la puntuación de crédito devuelta en otro atributo de paquete con el fin de quequede disponible para actividades posteriores. La herramienta de asignación gráfica permite asignardatos desde los atributos de paquete a los parámetros de entrada del servicio Web y desde el mensajede salida del servicio Web a los atributos de paquete.



Figura 7 Asignar un mensaje HTTP entrante a datos de proceso

La herramienta de asignación de datos tiene tres columnas:

• En la columna izquierda se muestran los orígenes de datos disponibles en un control de árbolcontraíble.

• En la columna derecha se muestran los destinos de datos disponibles en un control de árbolcontraíble.

• La columna central es el área de asignación; contiene cuadros que representan funciones deasignación de datos y líneas que conectan los cuadros con sus orígenes de entrada y destinos desalida.

El contenido de las columnas izquierda y derecha depende del tipo de actividad que se estéconfigurando. Para las actividades para las que se deben proporcionar valores de entrada, en lacolumna izquierda generalmente se muestran los atributos para todos los paquetes de los procesoscomerciales, variables de proceso y las variables de la ejecución en tiempo de ejecución, como porejemplo el nombre del supervisor, que están disponibles en tiempo de ejecución.

En la columna central se muestran las funciones que se utilizan para transferir datos desde uno o variosorígenes de datos de la izquierda a un destino de datos de la derecha. La herramienta de asignaciónpermite copiar los valores directamente desde un origen de datos a otro, realizar conversiones de tiposde datos, concatenar cadenas, realizar operaciones matemáticas con los números e incluir valoresconstantes. Consulte Usar las funciones de asignación de datos, página 150 para obtener una listade las funciones disponibles.



Puede asignar datos a o desde los elementos de nivel más bajo de los controles del árbol, las "hojas"del árbol, utilizando los iconos + o - para expandir o contraer el árbol. Entre los tipos de datosexpuestos en el árbol se incluyen los paquetes, las variables de proceso, los datos de ejecución ylos parámetros de proceso.

Agregar o editar datos de proceso en elasignadorPuede agregar o editar elementos individuales del árbol de datos seleccionando el enlace Editar einiciando el Diálogo Editar datos de proceso. Mediante el editor de datos puede crear, actualizar yeliminar elementos del árbol de datos del asignador, así como cambiar el modelo de proceso segúnsea necesario durante el diseño del proceso, sin tener que salir del diseñador e iniciar el cuadro dediálogo Propiedades de proceso.

Cuando vea un icono de signo más de color verde en un nodo, paquete o atributo de datos, significaque puede agregar o editar los datos asociados a esa ubicación en los datos de proceso.

Asignar atributos de paquetePara los paquetes de ambos lados del asignador, el árbol muestra sólo los atributos seleccionados deforma predeterminada. Se muestran todos los atributos personalizados para el tipo de objeto del paquetey también una selección de los atributos estándar de uso más frecuente. El nodo del paquete tambiénmuestra los tres atributos adicionales siguientes, que permiten asignar el contenido a otros orígenes:

• tipo de contenido: representación de cadena del tipo MIME del contenido del paquete• formato: nombre del objeto de formato (dm_format) asociado al contenido• datos: contenido real del paquete

Además, un paquete contendrá el atributo r_object_id. El atributo r_object_id contiene el IDde objeto del paquete.

De forma predeterminada, sólo los atributos de paquete básicos aparecen en el asignador. Para finalizaruna asignación, puede tener que exponer otros atributos de un paquete que no aparecen actualmenteen el árbol.

Para mostrar atributos de paquete adicionales:

1. Haga clic en el nombre del paquete con el botón secundario del ratón y seleccioneMostrarmás atributos.

Al seleccionar un paquete del asignador, aparece un cuadro de diálogo con la lista completa deatributos para el tipo de objeto del paquete.

2. Resalte los atributos que desea que estén disponibles para la asignación.

Mantenga presionadas las teclas Mayús o Ctrl para seleccionar varios atributos.3. Haga clic en Aceptar para cerrar el cuadro de diálogo.

Los atributos seleccionados se agregarán a la lista del control de árbol, en orden alfabético.

Nota: Si no asigna los atributos agregados a una función, no volverán a aparecer cuando guarde laactividad y vuelva a abrir el Inspector de actividad.



Asignar comentarios de tarea como datos deprocesoAsignar comentarios desde el paquete a un tipo de datos estructurado le permite recuperar loscomentarios de varios ejecutantes, así como la fecha de creación, el nombre del autor y el ID de nota.Los comentarios consolidados se pueden ver a continuación en actividades posteriores o asignaral cuerpo de un mensaje de correo electrónico.

El atributo note[ALL] sólo aparece en el nodo Paquetes del árbol de datos en la ventana Asignación demensaje de entrada (margen izquierdo) de origen.

Para configurar note[ALL] en una plantilla de actividad:

1. Con el cuadro de diálogo Propiedades de proceso, agregue al proceso un paquete y un tipo de datosestructurado que sea un valor de repetición.

El tipo de datos estructurado contiene los atributos que utilizará para asignar los comentarios. SDTdebe contener los siguientes atributos necesarios: id, writer, text y creation_date.

2. Abra una plantilla de actividad, configúrela y abra el asignador de datos.

3. En la ventana Asignación de mensaje de entrada, expanda Datos de proceso > Paquete >note[ALL].

4. Asigne los atributos Source necesarios a los atributos del tipo de datos estructurado creado queaparecen en el área Destino.

5. Guardar la plantilla de actividad

Agregar las propiedades del mensajePuede haber ocasiones en que necesite agregar una propiedad específica del servicio a un mensaje parafinalizar una asignación. En este caso, puede agregar la propiedad al mensaje, pero debe asegurarseque se agrega al nodo correcto y que se denomina correctamente. No hay ninguna validación para laspropiedades de mensaje agregadas.

Para agregar propiedades a un mensaje:

1. Haga clic con el botón secundario en el nodo de propiedad del mensaje en el árbol.

2. En el menú, seleccione Agregar.

Aparece el cuadro de diálogo Parámetro del asignador de datos.

3. Para agregar una propiedad al asignador, haga clic en .

La nueva propiedad indefinida se agrega al árbol.

4. Escriba el Nombre para mostrar y el Nombre completo de la propiedad.

5. Seleccione el Tipo de propiedad que está agregando.

6. Haga clic en Aceptar para agregar esta propiedad al mensaje.

Nota: Si no asigna las propiedades agregadas a una función, no se guardarán al volver a abrirel Inspector de actividad.



Agregar un esquema XML al contenido de laactividadPuede asociar un esquema XML a un anexo o al contenido del paquete o al contenido recibido desdeorígenes externos (como servicios HTTP o JMS) y utilizar el asignador para asignar los elementosdel esquema. Antes de anexar el esquema a un nodo en el árbol del asignador de datos, modifique elesquema para cambiar todas las instrucciones de importación de esquema que contienen direccionesURL relativas para utilizar direcciones URL absolutas.

El nodo de datos se expande cuando el esquema XML se asocia a los datos de contenido. Si unpaquete se asocia a un formulario que utiliza un esquema XML, el nodo de datos de contenido muestraautomáticamente el esquema XML asociado al formulario.

Nota: Si el valor que va a asignar está basado en una enumeración establecida, puede ver la listade valores disponibles haciendo clic con el botón secundario en el valor y seleccionandoMostrarenumeración.

Si un esquema XML contiene un elemento o un atributo del tipo xsd:anySimpleType, el asignador lomuestra como un nodo de cadena. Cuando se pasa un valor de fecha a este elemento, debe utilizar lasfunciones Fecha a cadena en el asignador de entrada y Cadena a fecha en el asignador de salida. Noutilice la función Copiar para los valores de fecha cuando asigne xsd:anySimpleType. El formato defecha de Fecha a cadena o Cadena a fecha debe ser uno de los siguientes:

Tabla 9 Formatos requeridos

Tipo de XSD Formato

fecha yyyy-MM-dd

dateTime yyyy-MM-dd’T’HH:mm:ss.SSSZ

hora HH:mm:ss.SSS

Para agregar un esquema XML:

1. En el árbol de atributos, desplácese al elemento Datos.

2. Haga clic con el botón secundario en Datos y seleccione Agregar elemento para mostrar elCuadro de diálogo de esquema.

3. Haga clic en Examinar para seleccionar un esquema del repositorio.

Puede filtrar la lista para mostrar los archivos XML y XSD, o bien elegir ver todos los formatosde tipo de contenido.

4. Seleccione un Elemento del esquema para utilizarlo en las asignaciones.

5. Seleccione un Traductor para utilizarlo al transformar el cuerpo del mensaje en un formatodeterminado, si es necesario.



Incorporar formularios de Forms Builder aprocesosCuando se asocia un formulario de Forms Builder a un flujo de trabajo, los usuarios pueden introducirinformación en el proceso mediante dicho formulario para, acto seguido, enviarlo a la dirección URL ode correo electrónico especificada. Estos datos se pueden incorporar, a continuación, al flujo detrabajo. Una vez enviado el formulario de datos al flujo de trabajo, los elementos del esquema delformulario se pueden asignar a variables de proceso, a un paquete o a un anexo.

Rellenar formularios mediante archivos XMLEl asignador de datos permite rellenar los campos de los formularios empleando un esquema XMLentrante y asignando dichos elementos al esquema del formulario en cuestión.

Para rellenar un formulario con datos de un archivo XML:

1. Cree un formulario en Forms Builder y asócielo como paquete al proceso y a una actividad, porejemplo, una plantilla de actividad FTP entrante.

Aparece el esquema del formulario en el nodo de datos del paquete.

2. Con el asignador de datos, asocie un esquema XML del repositorio al nodo de datos de la actividad.

Agregar un esquema XML al contenido de la actividad, página 143 ofrece instrucciones paraagregar esquemas XML al asignador de datos.

3. Utilice las funciones de asignación del asignador para mover contenido del esquema del archivoXML al esquema del formulario.

Crear formularios de alta fidelidad con datos deprocesoLas plantillas de formulario de alta fidelidad generan formularios muy parecidos a sus homólogos depapel e incorporan funciones de OpenOffice.org.

Cuando se asocia una plantilla de este tipo a un proceso, cabe la posibilidad de asignar datos de procesoa los elementos de su esquema así como crear o generar un formulario de alta fidelidad a partir de ellos.

Usar una actividad HTTP entrante: inicio para crear unanueva instancia de formulario de alta fidelidad

Puede usar una actividad entrante para crear una instancia de formulario de alta fidelidad.

Para crear una instancia de formulario de alta fidelidad:

1. Configure la plantilla de actividad HTTP entrante - Inicio con el sufijo de URL, seleccione Postpara el tipo de solicitud y elija incluir anexos en la solicitud.

2. Cree un paquete en el proceso que esté basado en un formulario de alta fidelidad instalado en elrepositorio.



Asegúrese de que el paquete no sea obligatorio en el proceso desactivando la casilla de verificaciónÉste es un paquete obligatorio.

3. En el asignador de datos de la plantilla de actividad HTTP entrante - Inicio, haga clic con el botónsecundario en el nodo Origen correspondiente al anexo y elija Agregar plantilla de formulario.

4. Acceda a la ubicación de la plantilla de formulario y seleccione ésta.

El tipo de objeto es dm_xfm_form.


6. Haga clic en Aceptar en la asignación.

Al expandir el nodo Datos, se ven los atributos del formulario de alta fidelidad.

7. Si desea enviar un correo electrónico con el formulario recién creado, agregue una plantilla deactividad SMTP saliente al proceso y asigne el contenido del paquete al nodo de anexos de correoelectrónico.

8. Asigne los elementos del esquema oportunos del nodo Datos del anexo HTTP al nodo Paquetey guarde la plantilla de actividad.

Usar una actividad Asignación de datos de procesos paracrear una instancia de formulario de alta fidelidad

Use una plantilla de actividad Asignación de datos de procesos para crear una instancia de formulariode alta fidelidad en el flujo de trabajo y, a continuación, use una plantilla de actividad saliente comoFTP saliente o SMTP saliente para enviar el formulario como anexo o paquete.

Crear una instancia de formulario de alta fidelidad como paquete

Para crear una instancia de formulario de alta fidelidad como paquete:

1. Cree un paquete en el proceso que esté basado en un formulario de alta fidelidad instalado en elrepositorio.

Asegúrese de que el paquete no sea obligatorio en el proceso desactivando la casilla de verificaciónÉste es un paquete obligatorio.

2. Abra la plantilla de actividad Asignación de datos de procesos, haga clic con el botón secundarioen el nodo Origen correspondiente al paquete y elija Agregar plantilla de formulario.

3. Acceda a la ubicación de la plantilla de formulario y seleccione ésta.

El tipo de objeto es dm_xfm_form.



Al expandir el nodo de datos del paquete, se ven los atributos del formulario de alta fidelidad.

6. Para crear el formulario de alta fidelidad en otra carpeta que no sea la predeterminada, asigner_folder_path a la ubicación de la nueva carpeta.

7. Si desea enviar un correo electrónico con el formulario recién creado, agregue una plantilla deactividad SMTP saliente al proceso y asigne el contenido del paquete al nodo de anexos de correoelectrónico.



Crear un formulario de alta fidelidad como un anexo

Para crear una instancia de formulario de alta fidelidad como anexo:

1. Siga los pasos del procedimiento anterior para crear una instancia de formulario de alta fidelidadcomo paquete, página 145.

2. En la asignación Destino, haga clic con el botón secundario en NombrePlantillaFormulario quecorresponde al nodo de anexos y asígnelo al nombre de la plantilla de formulario de alta fidelidad.

Nota: Esta asignación es obligatoria.3. Asigne los valores de datos de procesos necesarios a los atributos del formulario.4. Si desea enviar un correo electrónico con el formulario recién creado, agregue una plantilla de

actividad SMTP saliente al proceso y asigne el contenido del anexo al nodo de anexos de correoelectrónico.

Usar formularios de alta fidelidad para agregar datos a procesos

Si recibe un formulario de alta fidelidad en un proceso, puede incorporar la información del formularioal proceso para su posterior uso en el flujo de trabajo. Por ejemplo, si recibe el formulario de unaplantilla de actividad Correo electrónico entrante cuyo anexo es un formulario de alta fidelidad, puedeasignar los datos del proceso entrante a variables de procesos y agregar dicha información al proceso.

Agregar un nodo basado en una condiciónUtilice el Generador de nodos condicionales para agregar un nodo al árbol de datos que utiliza unaexpresión generada utilizando los elementos secundarios del nodo. Esta opción está disponible paraalgunos nodos de repetición que tienen más de un atributo y para el nodo Elemento de trabajo situadoen el nodo principal Datos de ejecución.

Para agregar una condición a un nodo:

1. Haga clic con el botón secundario del ratón en el nodo y seleccioneMostrar generador decondiciones.

2. Expanda el árbol de datos y seleccione el elemento en el que está creando la expresión.3. Seleccione el elemento, el operador y escriba el valor que se va a utilizar para crear la expresión.4. Haga clic en el botón Insertar expresión para crear la expresión.

La expresión aparece en el cuadro de texto.5. Haga clic en Aceptar.

El nuevo nodo aparece en el árbol de datos junto al texto de la expresión. Si el texto de la expresiónno está visible en su integridad, haga clic con el botón secundario del ratón en el nodo y abra elGenerador de nodos condicionales para ver el texto completo de la expresión.

Asignar los datosLa columna central contiene cuadros que representan las funciones de asignación de datos y líneasque conectan los cuadros de funciones con los argumentos de entrada y los destinos de salida. En



tiempo de ejecución, la actividad pasa los valores de los argumentos de entrada y guarda el resultadocomo el valor del atributo de destino.

Puede crear una función de asignación cada vez. La herramienta de asignación de datos requiere quese complete una asignación (mediante la selección de sus parámetros de entrada y destino de salida)antes de comenzar con la siguiente asignación. Siempre que se asignan datos de proceso, también sedebe asignar el formato o el tipo de contenido correspondiente. Esto se valida para cualquier servicio.

Todas las funciones de asignación de datos operan en atributos de un solo valor y en atributos convalores de repetición. Cuando el argumento de entrada es un atributo con valor de repetición o unaconsulta con varias filas de resultados, la función de asignación de datos utiliza alguno de los valoresde repetición o todos ellos. Cuando escribe su resultado en el atributo de destino, el nuevo resultadosobrescribe los valores existentes o agrega un valor de atributo nuevo. Consulte Usar atributos derepetición, página 149 si precisa información detallada sobre la asignación de atributos con valores derepetición.

Usar el asignador de datosPara asignar datos:

1. Seleccione una función en el cuadro de lista sobre el área de asignación de la columna central.

Consulte Usar las funciones de asignación de datos, página 150 para obtener información sobrelas funciones disponibles.

Sobre el área de asignación, aparecerá un icono que representa la función. Una X roja en laesquina inferior derecha indica que la función aún no tiene los argumentos requeridos. Unavez haya proporcionado todos los argumentos requeridos (en los pasos 4 ó 5 que se describena continuación), la X no aparecerá.

El cuadro de lista de las funciones permanecerá como no disponible mientras la función actual nosea válida. Sólo puede definir una función cada vez.

2. Arrastre el cuadro de las funciones hasta la ubicación en la que desea que aparezca.

La posición del cuadro de las funciones es una cuestión meramente visual La posición no afecta alorden de ejecución.

3. En la columna de la izquierda, seleccione los atributos cuyos valores serán los datos de entrada dela función.

Para seleccionar un atributo haga clic en su nombre. En el área de asignación, aparecerá unalínea que conecta el atributo seleccionado con el cuadro de funciones actual. Si el tipo de datosdel atributo seleccionado no coincide con el tipo de datos que la función espera, la línea semostrará discontinua. El sistema intentará convertir el valor al tipo de datos requerido en tiempode ejecución. Al hacer clic en el nombre de un atributo por segunda vez, éste se deseleccionay se elimina la línea.

Si la función actual acepta varios valores de entrada, podrá seleccionar varios atributos en lacolumna de la izquierda. De forma predeterminada, los atributos se agregan a la lista de lafunción de los argumentos de entrada en el orden seleccionado. Consulte el paso 5 para obtenerinformación sobre cómo modificar el orden de los argumentos.

Si el atributo que desea ya está enlazado a otra función, podrá enlazarlo a la función actualhaciendo clic en el botón Modo de dibujo de líneas . (a la derecha de la lista de funciones en la



parte superior de la columna central) y dibujando una línea desde el rombo negro situado en elextremo izquierdo de la línea de selección anterior hasta el cuadro que representa la función.

En algunos casos, es posible que desee definir una función que no utilice ningún atributo comodatos de entrada. Es decir, que todos los valores de entrada sean constantes. En esos casos, omitaeste paso y escriba los valores constantes relevantes en el paso 5.

4. En la columna derecha, seleccione el atributo en el que la actividad escribirá el resultado dela aplicación de la función.

Sólo podrá seleccionar un atributo en la columna derecha para cada función de asignación.

5. Modifique los argumentos de entrada de la función, si fuera necesario.

Haga doble clic en el cuadro de funciones para mostrar el cuadro de diálogo Editor de funciones,en el que se incluyen el nombre de la función, su sintaxis y una lista de los valores de entrada. Losnombres de los atributos que seleccionó en el paso 3 aparecen en formato XPath. Mediante estecuadro de diálogo, puede cambiar el orden de los atributos o agregar constantes como valores deentrada adicionales.

6. Haga clic en Aceptar para cerrar el cuadro de diálogo.

7. Repita estos pasos para cada función de asignación de datos que desee crear.

Asignar atributos de repetición

Hay varios casos en los que deseará copiar una variable de origen única en varias variables de destinoen un solo paso de asignación de datos. Tenga en cuenta que esta operación realiza otras accionesademás de efectuar varias copias. Dado que puede elegir diferentes funciones para la asignación,también puede realizar operaciones diferentes. Por ejemplo, tal vez podría desear utilizar una funciónde copia para copiar una fecha en otra y al mismo tiempo usar una función de fecha a cadena paracopiar la misma fecha en una variable de cadena.

Para copiar una variable en varias variables:

1. Cree la función de copia para el primer elemento como de costumbre.

2. Agregue una segunda función de copia y haga clic en la variable de destino.

3. Haga clic en el botónModo de dibujo de líneas en la barra de herramientas.

4. Coloque el cursor sobre el pequeño identificador en la variable de origen y haga clic una vez.

5. Haga clic en el identificador situado en el lado izquierdo de la función de copia para completar laasignación.



Usar atributos de repetición

La pantalla Asignación de mensaje de entrada y Asignación de mensaje de salida de todas las plantillasde actividad permiten el uso de atributos con varios valores.

Los atributos de varios valores tienen un enlace Agregar junto a su nombre. Utilice el enlace Agregarpara crear un nodo que represente un índice específico de atributos de varios valores. Al hacer clic enAgregar, el sistema crea un nuevo nodo con un valor de índice predeterminado. Para cambiar el valorde índice, haga doble clic en él y se abrirá el cuadro de diálogo Índice de repetición, en el que podráseleccionar PRIMERO/ÚLTIMO o escribir un valor numérico.

Agregar un nodo con un nuevo valor de índice

Para agregar un nodo con un nuevo valor de índice:

1. Haga clic en Agregar junto al atributo para el que desea que el sistema cree un nuevo nodo conun valor de índice predeterminado.

2. Haga doble clic en el nuevo valor de índice para iniciar el cuadro de diálogo Índice de repetición.

3. Para cambiar el valor de índice, seleccione FIRST, LAST o escriba un valor numérico para laposición del índice.

FIRST creará la primera posición del índice para el atributo. Esto suele resultar más útil en laasignación de mensajes de entrada cuando se asigna el primer valor de un atributo a otro atributocorrespondiente a la asignación de mensajes de salida.

LAST crea el nuevo atributo al final de cualquier otro atributo existente. Esto suele resultar másútil en la asignación de mensajes de salida en la que un valor de entrada se asigna a la últimaposición del valor de repetición. De esta forma se asegurará de que los datos asignados nosobrescriben los valores existentes.

Copiar atributos de un solo valor en atributos de varios valores

Para copiar un atributo de un solo valor en un índice específico de atributos de varios valores:

1. En el árbol de destino, cree un nodo que represente el índice específico del atributo de variosvalores.

2. Seleccione el nodo del atributo de un solo valor en el árbol de origen. Para ello, haga clic enel nodo de un solo atributo.

3. Seleccione el nodo que representa el índice específico del atributo de varios valores en el árbolde destino.

Copiar un índice de varios valores en un atributo de un solo valor

Para copiar el índice específico de un atributo de varios valores en un atributo de un solo valor:

1. En el árbol de origen, cree un nodo que represente el índice específico del atributo de varios valores.



2. Seleccione el nodo que representa el índice específico del atributo de varios valores en el árbolde origen.

3. Seleccione el nodo que representa el nodo de un solo atributo en el árbol de origen/destino.

Copiar todos los valores de un atributo de varios valores en un índiceespecífico de índices de varios valores

Para copiar todos los valores de un atributo de varios valores en un índice específico de índicesde varios valores:

1. En el árbol de destino, cree un nodo que represente el índice específico del atributo de variosvalores.

2. Seleccione el nodo que representa todos los valores (el valor de índice de este nodo será TODOS)en el árbol de origen.

3. Seleccione el nodo que representa el nodo de un solo atributo en el árbol de origen/destino.4. Haga doble clic en el functoid y se abrirá el cuadro de diálogo de la función.5. En el cuadro de diálogo de la función, seleccione PARA CADA UNO como el valor para

Contexto de entrada y elija Sobrescribir, Insertar antes o Insertar después como el valor deContexto de salida.

Cuando se utilizan las opciones Insertar después o Insertar antes, los valores se insertarán despuéso antes del índice. Cuando se utiliza la opción Sobrescribir, se sobrescriben los valores existentes.

Descripción del contexto de entrada

Dependiendo de la opción Contexto de entrada seleccionada para una regla de asignación, todos losvalores de un atributo de varios valores se transfieren a la función de asignación como argumentos(opción Todos), o bien la función de regla de asignación se ejecuta una vez para cada valor (Paracada uno).

Todos realiza la acción para todos los atributos y tendrá un único resultado. Si utiliza una operaciónAgregar para un grupo de atributos de repetición y selecciona Todos, el resultado será un valor únicoque representa la suma de todos los valores.

Para cada uno realiza la acción para cada uno de los atributos y proporciona varios resultados. Puedeseleccionar una operación y realizarla en cada uno de los atributos de repetición. Por ejemplo, puedetener varios anexos y crear un identificador para cada uno de ellos.

La opción de Contexto de entrada se puede visualizar o actualizar desde el cuadro de diálogo dela función.

Usar las funciones de asignación de datosEn un cuadro de lista sobre el área de asignación, aparece una lista de las funciones disponibles.Cuando selecciona una función de la lista, en el área de asignación aparece un icono que la representa.Una vez ha enlazado la función a sus argumentos de entrada y destino de salida (como se describe en lasección Asignar los datos, página 146), es posible que deba utilizar el cuadro de diálogo Editor defunciones para completar la definición de la función. El Editor de funciones permite modificar el ordende los argumentos de entrada de una función, así como agregar argumentos de entrada constantescuyos valores no provienen de los datos de proceso.



Haga doble clic en el cuadro de funciones para mostrar el cuadro de diálogo Editor de funciones, en elque se incluyen el nombre de la función, su sintaxis y una lista de los valores de entrada esperados.Los nombres de los atributos de entrada enlazados a la función aparecen en formato XPath. Si el valorque está asignando está basado en una enumeración establecida, puede ver una lista que muestra losvalores de enumeraciones del nodo de destino de la función.

• Para cambiar el orden de los argumentos de entrada, resalte uno de los argumentos y haga clic en elbotón de flecha hacia arriba o hacia abajo para moverlo a la nueva ubicación en la lista.

• Para agregar una constante a la lista de argumentos de entrada, resalte el argumento que precederá ala constante y haga clic en el botón +. Aparecerá una nueva línea bajo la línea que ha resaltado.Escriba el valor de la constante en la nueva línea.

Nota: No puede agregar un nuevo atributo de paquete a la función mediante este cuadro de diálogo;para ello, deberá volver a la pantalla de la asignación y seleccionarlo en la columna de la izquierda.

• Para eliminar una constante de la lista de argumentos de entrada, resáltela y haga clic en el botón -.

Nota: No puede eliminar un atributo de paquete de la lista mediante este cuadro de diálogo; paraello, deberá volver a la pantalla de la asignación y borrarlo en la columna de la izquierda.

En la tabla siguiente se muestran las funciones disponibles.

Tabla 10 Funciones de la asignación de datos

Función Argumentos de entrada ResultadoAgregar Dos o más números. Suma de los argumentos de

entrada.

Agregar día laboral Un valor de fecha entero, unacadena para el calendario, y unentero para noOfDays.

Agrega un día laboral al valorde noOfDays. El valor de un díalaboral está basado en el calendariocomercial seleccionado.

Agregar días Un valor de fecha entero y unentero para noOfDays.

Devuelve una fecha después desumar el número especificado dedías a la fecha.

De byte a cadena Dos cadenas, la primera representalos datos binarios y la segundaespecifica el valor de codificacióncomo, por ejemplo, UTF-8,UNICODE, etc. El valor decodificación predeterminado esUTF-8.

Datos como una cadena.

Concatenar Dos o más cadenas. Cadena concatenada compuestapor los argumentos de entrada enorden.

Copiar Un argumento de cualquier tipo. Argumento de entrada nomodificado.



Función Argumentos de entrada ResultadoRecuento Objecto param[]): Devuelve el número de valores en

la entrada de varios valores. Paralas entradas de un único valor, elvalor de devolución es 1.

Fecha a cadena Una fecha y una cadena querepresentan un patrón de fechaválido.El patrón de fecha debecumplir con el estándar JavaSimpleDateFormat. Para obtenerdetalles, consulte la API de Javay la documentación de referenciadel desarrollador situada en el sitioweb de desarrollador de Sun.

Valor de fecha como una cadenacon el patrón especificado.

Dividir Dos o más números. Resultado de dividir el primerargumento de entrada por elsegundo argumento. Cuandoexisten más de dos argumentos,cada número posterior se utilizapara dividir el resultado anterior.

Obtener Día Entero. Devuelve un entero que representael segmento del día de la fecha.

Obtener dirección de correoelectrónico

Cadena. Consulta dm_user para devolveruna dirección de correo electrónicopara un usuario.

Obtener Mes Entero. Devuelve un entero que representael segmento del mes de la fecha.

Obtener tiquet Cadena. Genera un tiquet de iniciode sesión para el nombre deusuario especificado en tiempode ejecución. Utiliza la siguientesintaxis: nombre de usuario,alcance, tiempo de espera, usoúnico y nombre del servidor.Generar un tiquet de inicio desesión, página 154 proporcionamás información sobre estafunción.

Obtener valor Parámetro de cadena que especificael objeto y el número de posicióndel índice.

Devuelve un valor de una posiciónespecificada en el índice.



Función Argumentos de entrada ResultadoObtener Año Entero. Devuelve un entero que representa

el segmento del año de la fecha.

Unir Dos o más matrices de cadenas. Crea una combinación de lasentradas seleccionadas.

Multiplicar Dos o más números. Producto de los argumentos deentrada.

Dividir Cadena que puede incluir un valorde posición de índice opcional.

Devuelve una cadena de repeticióno una posición en el valor derepetición si se utiliza la posiciónde índice opcional.

Cadena a byte Dos cadenas, la primera representalos datos y la segunda especificael valor de codificación como,por ejemplo, UTF-8, UNICODE,etc. El valor de codificaciónpredeterminado es UTF-8.

Datos binarios.

Cadena a fecha Dos cadenas, la primeraproporciona una fecha y lasegunda especifica su patrón. Elpatrón de fecha debe cumplir con elestándar Java SimpleDateFormat.Para obtener detalles, consulte laAPI de Java y la documentación dereferencia del desarrollador situadaen el sitio web de desarrollador deSun.

Valor del tipo de datos de fecha.

Subcadena Una cadena, un número querepresenta cuántos de los caracteresiniciales se eliminarán de la cadenay, opcionalmente, un número querepresenta la posición del últimocarácter que se incluirá en lasubcadena.

Cadena compuesta de caracteresdel primer argumento de entrada,que comienzan en la posición deinicio especificada y que finalizanen la posición final especificada.

Por ejemplo, si los argumentosde entrada son "infeliz" y 2, elresultado es la cadena "feliz". Silos argumentos de entrada son"infeliz", 2 y 5, el resultado es"fel".



Función Argumentos de entrada ResultadoRestar Dos o más números. Resultado de restar el segundo

número al primer número. Cuandoexisten más de dos argumentos,cada número posterior se resta alresultado anterior.

ToLower Cadena. Convierte la cadena en letrasminúsculas.

ToUpper Cadena. Convierte la cadena en letrasmayúsculas.

Generar un tiquet de inicio de sesiónLa función Obtener tiquet permite al sistema generar un inicio de sesión seguro para un usuarioconcreto. El tiquet se puede configurar para uno o más repositorios más de una vez, y puede caducartranscurrido un plazo de tiempo designado. El ejecutante de la actividad debe tener privilegiosde superusuario.

Nota: El diseñador del proceso debe tener privilegios de superusuario para conceder al ejecutante de laactividad privilegios de superusuario.

La función Obtener tiquet acepta los siguientes argumentos:

Tabla 11 Valores de editor de la función Obtener tiquet

Parámetro Tipo Valor

Nombre de usuario Cadena Nombre del usuario para el que crea el tiquet.

Alcance Cadena Alcance del tiquet de inicio de sesión adquirido. Los valores válidos

son: docbase, server y global.

Tiempo de espera Entero Duración en minutos de la validez de un tiquet de inicio de sesión

adquirido.

Uso único Booleano Número de veces que se puede usar el tiquet de inicio de sesión.

Nombre de servidor Cadena Nombre del repositorio que acepta el tiquet. Si el parámetro uso único

se establece en verdadero, el tiquet de inicio de sesión sólo es válido

para ese servidor en concreto.

Generar un tiquet de inicio de sesión global mediante la actividaddel asignador de datos de proceso

Utilice una actividad Asignación de datos de procesos para generar un tiquet de inicio de sesión globalcon el nombre de usuario, alcance, tiempo de espera, uso único y nombre de repositorio especificadosen un repositorio de uso múltiple.



Para generar un tiquet de inicio de sesión global utilizando todos los parámetros en unrepositorio de uso múltiple:

1. Agregue la plantilla de actividad Asignación de datos de procesos al proceso.

2. Asegúrese de que el ejecutante de la actividad tiene privilegios de superusuario.

3. En el Asignador de datos de entrada, seleccione la función Obtener tiquet.

4. En el editor de funciones, agregue cinco parámetros constantes y proporcione valores para elnombre de usuario, alcance, tiempo de espera, uso único y nombre del servidor.

5. Haga clic en Aceptar y guarde el proceso.

6. Asigne este tiquet a la variable de proceso.

7. Agregue la actividad SMTP saliente y asigne el tiquet para enviarlo como un anexo de correoelectrónico.

El destinatario del correo electrónico puede utilizar el tiquet para iniciar sesión en el mismorepositorio o en un repositorio de confianza diferente utilizando el nombre de usuario especificadodurante el plazo indicado dentro del período de tiempo válido.

Generar un tiquet de inicio de sesión global para un repositorio deconfianza diferente mediante la actividad Dynamic Web Service(servicio Web dinámico)

Utilice una actividad Dynamic Web Service para crear tiquets de inicio de sesión globales paradiferentes repositorios de confianza.

Para generar un tiquet de inicio de sesión global para un repositorio diferente medianteDynamic Web Service:

1. Agregue una actividad Dynamic Web Service al proceso y seleccione la ficha Configuracióndel servicio Web.

2. Asegúrese de que el ejecutante de la actividad tiene privilegios de superusuario.

3. Proporcione la URL del servicio Web DFS ContextRegistryService e invóquela.

Consulte Dynamic Web Service (Servicio Web dinámico), página 199 para obtener másinformación sobre plantillas de actividad Dynamic Web Services.

4. En el Asignador de datos de entrada, seleccione la función Obtener tiquet.

5. En el editor de funciones, agregue cinco parámetros constantes y proporcione valores para elnombre de usuario, alcance, tiempo de espera, uso único y nombre de repositorio.

6. Asigne este tiquet al campo de contraseña bajo el nodo RepositoryIdentity del cuerpo SOAP.

7. Haga clic en Aceptar y guarde la actividad.

Introducción a la correlación de mensajesProcess Builder debe poder hacer coincidir un mensaje entrante con una instancia única de un flujode trabajo para procesar los datos entrantes. Process Builder utiliza conjuntos de correlaciones eidentificadores de correlación formados de datos únicos para hacer coincidir la respuesta con lasolicitud original.



Por ejemplo, en una actividad de un proceso de compra, se envía un mensaje JMS al proveedor quesolicita información sobre si se envió un elemento de un pedido de compra. El mensaje especificatanto el número de ID del proveedor como el número de pedido de compra del elemento. El sistemautiliza estos números para hacer coincidir el mensaje con la instancia de proceso. Posteriormente, elsistema del proveedor responde con un mensaje de estado de envío para el pedido de compra, queincluye el número del pedido de compra y el ID del proveedor. Cuando estos identificadores se asignana los datos de proceso adecuados, el sistema puede hacer coincidir la solicitud con la respuesta ycontinuar el flujo de trabajo.

Usar los identificadores de correlación

Cuando se inicia una instancia de proceso, Process Engine crea un atributo correlation_identifier únicoen dm_workflow para identificar el proceso. Cuando una actividad intermedia entrante recibe esteidentificador en un mensaje, puede comparar el mensaje con la instancia de proceso basándose en estevalor sin tener que utilizar el conjunto de correlaciones.

Para utilizar esta propiedad del mensaje, el receptor del mismo debe tener el mismo identificador en surespuesta. En otras palabras, se debe haber enviado correlation_identifier en algún punto anterior delproceso para que el sistema pueda recibirlo en el mensaje entrante. Por ejemplo, cuando el mensajese envía a un proveedor que solicita información sobre un pedido de compra, el identificador de lacorrelación generado por sistema se envía en el mensaje saliente. Cuando el mensaje entrante tambiéncontiene el mismo identificador de correlación, el sistema lo utiliza para hacer coincidir el mensajecon la instancia de proceso.

Los campos que contienen los identificadores de correlación se configuran en cada plantilla deactividad intermedia entrante en la página de configuración, donde se define la conexión, el protocoloy las instrucciones de procesamiento. Este identificador es específico del protocolo del mensaje. Paramuchos mensajes entrantes, las propiedades únicas del mensaje, como por ejemplo los datos en elencabezado del mensaje o un nombre de archivo único, pueden contener el identificador de correlaciónpara hacer coincidir el mensaje con una instancia de proceso. Si no hay ninguna coincidencia entreestos valores, el sistema utilizará el conjunto de correlaciones especificado para hacer coincidir elmensaje con una instancia de proceso.

Tabla 12 Campos utilizados para configurar el ID de correlación

Plantilla de actividad Nombre del campo EjemploJMS entrante-procedimiento N/A Utilice en encabezado de JMS CorrelationId

HTTP entrante-procedimiento Propiedad de correlación MessageID

Correo electrónicoentrante-procedimiento

Encabezado decorrelación

Asunto



Plantilla de actividad Nombre del campo EjemploFTP entrante-procedimiento Patrón de correlación po_$id$.txt

Servicio Webentrante-procedimiento

N/A Utilice el MessageID del encabezadoWS-Addressing

Utilizar conjuntos de correlaciones

Si no se ha configurado un ID de correlación para una actividad o si el ID de correlación falta en unmensaje entrante, el sistema busca una asociación de conjunto de correlación para hacer coincidirel mensaje con un flujo de trabajo. Un conjunto de correlación es una colección de variables deproceso que se define para una actividad. En la mayoría de los procesos comerciales, hay atributosúnicos de datos de proceso que pueden identificarse y utilizarse para hacer coincidir los datos entrantescon una instancia de proceso. Estas asignaciones se crean utilizando la herramienta de asignación dedatos dentro de la plantilla de actividad, donde puede hacer coincidir los datos del mensaje entrantecon los datos del proceso existente.

Los conjuntos de correlaciones se definen en el nivel de proceso en la ficha Avanzada del componentePropiedades de proceso. En la lista de variables de proceso que están asociadas con el flujo detrabajo, puede asignar un nombre al conjunto de correlación y agregarle los atributos que utilizarápara la asignación de correlación. Por ejemplo, puede utilizar un número de pedido de compraúnico y un nombre para hacer coincidir los mensajes con una instancia de proceso. Si el pedido decompra y el nombre se pasa a todos los mensajes que se envían a y desde la instancia del proceso,a continuación, esos valores pueden utilizarse para hacer coincidir los mensajes de respuesta y losde solicitud. Puede crear un conjunto de correlación con nombre Pedido de compra y, dentro de él,seleccionar las variables de proceso para número y dirección del pedido de compra. En la herramientade asignación de datos, enlace los atributos para el número y la dirección del pedido de compradesde los atributos del mensaje entrante.

Un conjunto de correlación puede tener más de un identificador de correlación y un proceso puedeutilizar varios conjuntos de correlaciones, si es necesario. Puede seleccionar sólo un conjunto decorrelación para asignación dentro de una actividad. Por ejemplo en un flujo de proceso que gestionalos pedidos a los proveedores, puede crear el Conjunto de correlación 1 (número de pedido e ID delproveedor) y el Conjunto de correlación 2 (dirección y código postal) y utilizarlos al asignar mensajesen las actividades de entrada.

Los datos que un conjunto de correlación utiliza deben existir en el proceso o estar definidos enél antes de que el flujo de trabajo alcance la actividad que utiliza el conjunto de correlación. Losdatos se pueden definir en la actividad utilizando una actividad de inicio u otra actividad intermediaanteriormente en el proceso.

Nota: La variables de procesos que se usarán en conjuntos de correlaciones no deben tener valorespredeterminados. Las variables de proceso que tienen valores predeterminados no poseen lascaracterísticas de atributo exclusivas requeridas para que coincida un mensaje entrante con unainstancia única de un proceso. Si el sistema no encuentra una coincidencia única, el proceso de tiempode ejecución se cancela con un error.



Crear los conjuntos de correlación, página 72 proporciona más información acerca de cómo definirconjuntos de correlaciones para un proceso.


Capítulo 9

Depurar una plantilla de proceso


• Introducción al depurador de proceso

• Preparar la depuración del proceso

• Iniciar un flujo de trabajo en el depurador

• Probar un proceso en el depurador

Introducción al depurador de procesoEl depurador de Process Builder le permite probar interactivamente el diseño de una plantilla deproceso estableciendo los puntos de quiebre, recorriendo el proceso, examinando y modificando losdatos de proceso, probando las integraciones y adquiriendo y actuando sobre las tareas del proceso.

Depurar un proceso antes de implementarlo en un entorno de producción sirve para asegurar que elflujo de proceso diseñado satisface los requisitos comerciales originales en los que ha basado eldiseño. El uso del depurador para solucionar problemas de un proceso permite probarlo dentro delentorno de diseño sin tener que guardar, validar ni instalar dicho proceso. También puede probar lasactividades que está desarrollando para asegurarse de que ha configurado correctamente un flujo deproceso complejo. La ejecución de una ruta de acceso determinada dentro de un flujo también le puedeaportar una valiosa información durante el proceso de desarrollo.

La depuración tiene lugar en el entorno local. Cuando el proceso se ejecuta en modo de depuración, elservidor no crea elementos de trabajo reales o elementos de cola. Cualquiera cambio realizado en lasvariables de proceso sólo se mantiene en el sistema local durante la duración de la sesión de depuración.No se guardan una vez finalizada la sesión. Sin embargo, el servidor guarda los cambios realizados enlos objetos del paquete o los anexos durante la sesión de depuración y sobrescribe los datos de atributoexistentes. El sistema también crea cualquier objeto necesario para las actividades automáticas dentrodel proceso, como las interpretaciones o los anexos creados mediante las reglas de asignación.

Cuando el sistema ejecuta una actividad manual, el sistema adquiere y finaliza automáticamente laactividad lo que le permite recorrer todo el proceso sin detenerse en esa actividad particular. Paracompletar manualmente una actividad o realizar otra función manual en la actividad, puede estableceren ella un punto de quiebre. Esto le permite ejecutar las funciones que haría un ejecutante como, porejemplo, seleccionar la actividad siguiente en una transición o modificar datos de proceso.

Cuando establece un punto de quiebre en una actividad automática y elige recorrer la actividad, podráver los mensajes de entrada y salida, volver a ejecutar una tarea con errores y modificar los datosde proceso asociados a la actividad.

A medida que el depurador recorre las distintas actividades del flujo de proceso, marca el avance porel flujo con una línea en negrita. Esto resulta especialmente útil para seguir el progreso a través de



un flujo que tiene transiciones con posibles rutas de acceso distintas. Cuando el depurador está listopara ejecutar una actividad, se muestra una flecha verde sobre ella, lo que indica que se ha creado elelemento de trabajo y el ejecutante lo ha adquirido.

Figura 8 Actividad manual en el depurador

Una vez que el sistema ejecuta todo el proceso, muestra un mensaje en las fichas Task Manager yConsola para indicar que el flujo de trabajo se ha completado. En este punto todavía tiene acceso alproceso en modo de depuración y puede ver los mensajes de Process Engine en la ficha Consola.

Utilizar el entorno de depuración de procesosLa ventana depurador de proceso está dividida en dos paneles:

• El panel superior contiene la representación gráfica de la plantilla de proceso y muestra el progresodel proceso de depuración y los puntos de quiebre agregados al proceso.

• El panel inferior se compone de las siguientes fichas:

– Ficha TaskManager que gestiona las opciones de ejecución de las tareas manuales y automáticas.

– Ficha Datos de procesos, que permite visualizar y agregar paquetes, así como editar datosde proceso.

– Ficha Consola que muestra los mensajes de Process Engine.

– Ficha Administrar flujo de trabajo que permite enviar un evento al flujo de trabajo.



Para controlar el tamaño de los dos paneles, coloque el cursor sobre el borde entre ellos y arrástreloa una nueva posición.

En la tabla siguiente se muestran los iconos utilizados en los botones y en otros elementos de la interfaz.

Tabla 13 Elementos gráficos del depurador de proceso y su propósito

Elemento gráfico FinalidadLanza el proceso en modo de depuración o vuelve aejecutar el proceso en modo de depuración.

Agrega o quita un punto de quiebre.

Identifica todas las actividades actuales del flujo detrabajo. Se ha creado el elemento de trabajo y lo haadquirido el ejecutante. La flecha sólo aparece para lasactividades que requieren una intervención manual oque tienen puntos de quiebre.

Identifica una actividad ya ejecutada en el depurador.

Identifica una actividad en la que se ha establecido unpunto de quiebre.

Preparar la depuración del procesoPuede depurar procesos guardados en el repositorio de Documentum o puede depurar un procesomientras lo está diseñando. No es necesario guardar los procesos para que se prueben en el depuradorde proceso.

Usar puntos de rupturaLos puntos de quiebre le permiten detener el flujo de proceso en una actividad concreta para cambiarlos datos de proceso, agregan paquetes y ver la información de ejecución en la tarea. Puede agregarpuntos de quiebre en todas las actividades automáticas o manuales que desee.

Al ejecutar un proceso en modo de depuración, el sistema se detiene antes de cada actividad que tengaun punto de quiebre, permitiéndole abrir la actividad y agregar contenido a los paquetes, así comover o modificar los datos de proceso antes de ejecutar la actividad. Si la actividad es manual, puedefinalizarla, rechazarla o completarla antes de que el flujo continúe. Con una actividad automática,



puede abrir la actividad, ejecutar la tarea y consultar la entrada y salida de la actividad así comocualquier mensaje de error.

Para agregar un punto de quiebre:

1. Seleccione la actividad en el proceso.

Para seleccionar varios objetos, mantenga presionada la tecla Mayús mientras hace clic en ellos.2. Haga clic en el botón Alternar punto de quiebre para establecer el punto de quiebre en la actividad.

Para quitar un punto de quiebre:

1. Seleccione una actividad dentro del proceso que tenga un punto de quiebre.2. Haga clic en el botón Alternar punto de quiebre para quitar el punto de quiebre de la actividad.

Iniciar un flujo de trabajo en el depuradorPuede depurar una plantilla de proceso guardada en el repositorio o puede depurar un proceso mientraslo está diseñando antes de haberlo guardado. Una vez abierto el proceso en el editor de procesos,inicie el depurador y seleccione una actividad de inicio para comenzar el proceso. Puede agregarpaquetes o anexos al proceso y editar datos de paquete y variables de proceso para probar distintascombinaciones de datos en el flujo de proceso.

Nota: Sólo puede depurar un proceso cada vez. Si el depurador está abierto en una ficha, su iconoaparece en la ficha junto al nombre del proceso. El sistema no iniciará una instancia nueva deldepurador hasta que haya cerrado la sesión de depuración actual.

Iniciar una sesión de depuración con una actividadde inicio manualPara iniciar una sesión de depuración mediante una actividad de inicio manual:

1. Abra una plantilla de proceso en el editor de plantillas de proceso.

2. Haga clic en el icono Proceso de depuración o seleccione Depurar > Iniciar depuración deprocesos para abrir el cuadro de diálogo Proceso de depuración.

3. Escriba un nombre para el flujo de trabajo en el cuadro de texto Nombre del flujo de trabajo.4. Seleccione la actividad Iniciar un flujo de trabajo usando Iniciar manual.5. En el nodo Paquetes, haga clic en Adjuntar y seleccione el contenido de cada paquete que desea

probar.

Debe agregar contenido a cada paquete obligatorio.6. Si es necesario, edite los atributos expandiendo el nodo, haciendo clic en cualquiera que esté

disponible para su edición y escriba el nuevo valor en el cuadro de texto.

Algunos atributos, como r_object_id, no se pueden editar y aparecen atenuados.Nota: Los cambios realizados en los atributos de paquete en el depurador se guardan en elrepositorio y sobrescriben los datos de atributo del paquete existentes.

7. Expanda el nodo Variables para editar los valores haciendo clic con el botón secundario del ratónen cualquier campo editable y seleccione Editar valor.



Los cambios realizados en las variables de proceso sólo se mantienen en el sistema local durante laduración del proceso de depuración. No se guardarán una vez finalizada la sesión del depuradorde proceso.

8. Para asignar un anexo ad hoc al flujo de trabajo, haga clic en Adjuntar.

9. Haga clic en Iniciar flujo de trabajo para comenzar el proceso de depuración.

Se muestra la ventana de proceso de depuración permitiéndole ver y probar el proceso. Probarun proceso en el depurador, página 163 proporciona instrucciones detalladas sobre cómo probarel proceso.

Iniciar una sesión de depuración con una actividadde inicio entranteAntes de depurar una actividad de inicio HTTP entrante o Servicio Web entrante, debe especificarel número de puerto que utilizará el oyente en el cuadro de diálogo Preferencias. Definir el númerode puerto para la depuración de actividades entrantes, página 43 proporciona instrucciones sobrecómo establecer el número de puerto. Otras actividades entrantes utilizan los sondeos especificadosen la configuración de la actividad.Para iniciar una sesión de depuración mediante una actividad de inicio entrante:

1. Abra una plantilla de proceso en el editor de plantillas de proceso.

2. Haga clic en el icono Proceso de depuración o seleccione Depurar > Iniciar depuración deprocesos para abrir el cuadro de diálogo Proceso de depuración.

3. Si va a utilizar una actividad de inicio entrante para depurar el proceso, seleccione Iniciar flujode trabajo con oyentes de inicio entrantes.

El sistema inicia la escucha para el tipo de mensaje asociado a la actividad y comienza la escuchade la solicitud de inicio de mensaje específico a ese protocolo.

4. Haga clic en Iniciar escuchas para comenzar el proceso de depuración.

Se muestra la ventana de depuración de proceso permitiéndole ver el flujo de proceso. Cuando elproceso recibe el mensaje, el flujo de trabajo comienza.

Probar un proceso en el depurador, página 163 proporciona instrucciones detalladas sobre cómoprobar el proceso.

Probar un proceso en el depuradorPuede decidir ejecutar sin parar un proceso sin tener ningún punto de quiebre o puede detenerse en lasactividades para las que ha definido puntos de quiebre y ha probado la actividad interactivamente conla ventana de depuración de proceso. Puede realizar tareas manuales y ejecutar pruebas automáticas,establecer valores diferentes para variables de proceso y paquetes, así como enviar eventos al flujode trabajo. Mediante la ficha Consola puede ver el mensaje de Process Engine que le ayudará asolucionar problemas del proceso.

Además, hay varios botones de la barra de herramientas que activan distintas funciones en la ventanade depuración de procesos.



Tabla 14 Botones de depurador de proceso

Botón FinalidadPasar a la siguiente actividad hace que el depurador avancea la siguiente actividad incluso si no hay ningún punto dequiebre definido.

Pasar a la ejecución de la actividad actual permite ver losdetalles de la actividad automática. La actividad se ejecutapero no continúa en la actividad siguiente. Debe pasar auna actividad automática para ver los mensajes de servicioasociados a la ejecución de la actividad. Puede realizar cambiosen las asignaciones y la configuración de la actividad, volvera ejecutar la actividad si se producen errores y realizar otrasfunciones de resolución de problemas.

Volver a ejecutar la depuración ejecuta el proceso desde elprincipio del flujo, sin tener que volver a cargar los datos deproceso.

• Para paquetes o anexos, el proceso se ejecuta con losmismos datos con los que finalizó el flujo de trabajo. Si sehan realizado cambios en un paquete o anexo durante elflujo de trabajo, esos cambios se guardan en el repositorioy el proceso vuelve a empezar utilizando los atributosmodificados.

• Para variables de proceso, el proceso se ejecuta con losatributos cargados originalmente en el depurador. Si se hanrealizado cambios en las variables de proceso, esos cambiosno se guardan, por lo que el proceso se ejecuta con losvalores originales.

Esta opción sólo está disponible una vez completado elproceso. No puede volver a ejecutar un proceso completadoparcialmente.

Continuar hasta el siguiente punto de quiebre le permitedesplazarse al punto de quiebre siguiente del proceso.

Detener depuración finaliza el proceso de depuración y eliminael flujo de trabajo y los elementos de trabajo creados durante lasesión de depuración.

Salir de la sesión de depuración permite salir del depurador yvolver al editor de plantillas de proceso. El sistema elimina elflujo de trabajo y todos los elementos de trabajo creados para lasesión de depuración.



Utilizar la ficha Task ManagerLa ficha Task Manager le permite realizar distintas tareas para las actividades manuales y automáticas.La ficha muestra el estado del elemento de trabajo en la actividad (por ejemplo, adquirido).

Gestionar tareas manualesDe forma predeterminada, el sistema adquiere y finaliza las tareas manuales de modo que el procesose ejecuta durante el proceso de depuración sin intervención. Cuando se coloca un punto de quiebreen una actividad manual, puede seleccionar el contenido de un paquete, modificar las variables deproceso y realizar las funciones relacionadas con la tarea basándose en la actividad. Alguna de estasfunciones son:

• Rechazar una tarea.• Adquirir una tarea y completarla.• Seleccionar la actividad siguiente, si hay una condición de transición determinada por los ejecutantes.• Ver los detalles de los nombres de habilidad de un elemento de trabajo y los valores de habilidad.• Ver el ID del elemento de trabajo y el nombre del ejecutante para las tareas con varios ejecutantes yvarios elementos de trabajo.

• Forzar la finalización de una tarea.• Finalizar todos los elementos de trabajo para una tarea con varios elementos de trabajo.

La guía del usuario de Documentum Webtop, la Guía del usuario de Documentum TaskSpace y la Guíade configuración de Documentum TaskSpace proporcionan información detallada sobre las diferentesacciones disponibles para gestionar tareas manuales.

Gestionar tareas automáticasAl entrar en una actividad automática, el depurador ejecuta la actividad actual y muestra los mensajesde entrada y salida específicos del protocolo, así como cualquier excepción. Estos mensajes permitenver la comunicación entre los sistemas con los que se integra el proceso, por ejemplo, bases de datosde servicios Web externos, y facilitan la resolución de cualquier problema.

Además, puede abrir el Inspector de actividades y editar cualquiera de las propiedades de la actividadcon excepciones. Después de editar una actividad con excepciones, puede volver a ejecutar la actividadpara asegurarse de que la actividad se completa sin errores.

Para completar una actividad que contiene errores y que no puede corregir, haga clic en Obligar acompletar la tarea; el sistema completará la actividad y continuará con el proceso.

Al definir un punto de quiebre en una actividad automática, puede realizar las funciones siguientes:

• Entrar en la ejecución de la actividad.• Agregar o actualizar paquetes o anexos antes de que se ejecute la actividad.Nota: Si selecciona Pasar a la ejecución de la actividad actual, la actividad se ejecutainmediatamente y no puede cambiar los paquetes o anexos.

• Ejecutar la tarea y, a continuación, ver los mensajes de entrada y salida, así como los mensajes deexcepción de Process Engine.

• Volver a ejecutar una tarea con errores.



• Obligar a que termine una tarea aunque la actividad haya fallado.• Continuar hasta el siguiente punto de quiebre.

Si coloca un punto de quiebre en una actividad automática, puede pasar a la actividad y desencadenarsu ejecución. Esto le permite mostrar cualquier mensaje de entrada o de salida, así como cualquiererror o excepción. Por ejemplo, si llama a un servicio Web, podrá ver la solicitud y la información derespuesta.

De igual forma, puede ver los mensajes de entrada para cada protocolo concreto. Por ejemplo, el textode una solicitud SOAP aparece en la ventana de mensajes, lo que le permite copiarlo y pegarlo en uneditor de texto. También puede ver el texto del mensaje de respuesta (la respuesta SOAP) y cualquieractualización posterior de los datos de procesos.

Depurar métodos de flujo de trabajo automáticos

Varias de las plantillas de actividad suministradas con Process Builder ejecutan métodos automáticosque se extienden desde WorkflowMethod. Estas plantillas de actividad son:

• Crear carpeta• Enlazar a carpeta• Transformación de XSLT

El código para estos métodos automáticos está ubicado en el archivo bpsintegration.jar. Durante elproceso de instalación, Process Builder coloca estos archivos en el directorio <ubicación de instalaciónde Process Builder>classes/custom de forma que estén disponibles para el depurador de proceso.

Si tiene métodos personalizados, el depurador buscará el archivo JAR y cargará los métodos de lassiguientes ubicaciones:

• Directorio <ubicación de instalación de Process Builder>/classes/custom• Directorio %Documentum%//dba/java_methods cuando el servidor de contenido y Process Builderestán instalados en el mismo equipo

• El repositorio de Documentum si los métodos se implementan como un módulo BOF

El método Java personalizado se debe extender desde WorkflowMethod. Si los métodos Java no seextienden desde WorkflowMethod (en su lugar implementan IDfMethod), no se pueden ejecutar desdeel depurador y generarán un error. Utilice el botón Obligar a completar la tarea para completar latarea y continuar depurando el proceso.

Para ejecutar un método Java personalizado:

1. Escriba un método Java personalizado que se extienda desde WorkflowMethod.2. Cree un objeto dm_method en el repositorio.

Esto permite que el método automático aparezca en el cuadro de lista desplegable de selección enel Inspector de actividades.

3. Cree un archivo .jar (o las clases con la estructura del paquete completo) para el códigoJava personalizado y coloque el archivo .jar (o las clases) en el directorio C:/Archivos deprograma/Documentum/bpm/classes/custom.

Esto permite que el depurador cargue el archivo o las clases .jar para la ejecución en el métodopersonalizado.

4. Inicie el depurador de proceso y ejecute el proceso.



Nota: Los mensajes de depuración escritos en PrintWriter aparecerán en la ficha Consola.

Utilizar la ficha Datos de procesosUtilice la ficha Datos de procesos para ver los atributos de los datos asociados a la actividad y pararealizar la edición en línea de los datos de proceso. Puede agregar o actualizar paquetes o cambiar lasvariables de la instancia actual en el proceso. Haga clic en el botón Actualizar datos de procesopara obtener datos en caso de que otra actividad haya sufrido un cambio en los datos de proceso.

Para editar los datos de proceso:

1. Haga clic en el atributo del paquete o en la variable de proceso y escriba un nuevo valor.2. Pulse Intro en el teclado o seleccione Guardar.3. Para ver el contenido de un anexo o paquete, desplácese hasta el nodo contenido y haga clic en

el enlace correspondiente a Ver contenido.

El depurador mostrará el contenido en el editor o aplicación adecuados en otra ventana.

Nota: Los cambios realizados en los atributos de paquete en el depurador se guardan en elrepositorio y sobrescriben los datos de atributo del paquete existentes. Los cambios realizados enlas variables de proceso sólo se mantienen en el sistema local durante la duración del proceso dedepuración. No se guardarán una vez finalizada la sesión del depurador de proceso.

Utilizar la ficha ConsolaEn la ficha Consola se muestran mensajes de Process Engine sobre el estado del proceso. Estosmensajes incluyen cuándo se inició el flujo de trabajo, cuándo se crearon elementos de trabajo, seadquirieron, se completaron, si se envío una notificación por correo electrónico, etc. En la fichaConsola también se muestra el mensaje de depuración de los servicios utilizados en el proceso.

Los mensajes de protocolo muestran el mensaje intercambiado entre el servicio y el proceso:

• Para los mensajes salientes, el cuadro de texto Mensajes de entrada muestra el mensaje enviadodesde el proceso al servicio externo, y el cuadro de texto Mensajes de salida muestra el mensajedel servicio.

• Para los mensajes entrantes, el cuadro de texto Mensajes de entrada muestra el mensaje recibido porel proceso desde el servicio externo, y el cuadro de texto Mensajes de salida muestra el mensajeenviado desde el proceso al servicio.

Para los protocolos de los servicios Web y HTTP, el mensaje es una aproximación cercana al mensajeque se transmite por la red. Para otros servicios, el mensaje utiliza un formato XML que representa laestructura en árbol de la asignación de datos.

En el caso de datos binarios, el mensaje muestra la ubicación del archivo en el sistema de archivosdonde se almacena el contenido. Una vez que el flujo de trabajo se completa en el depurador, seelimina el archivo.

Por ejemplo:<Attachment><Name>test2<Name><Content-Type>text/plain<Content-Type>



<Data>C:\Documents and Settings\meenar\message_files\7bafbf6f-baae-4a16-b240-8335fb7f2d65.dat<Data>

</Attachment>

Nota: En la ficha no aparecen los errores de mensajería, pero están disponibles en el cuadro de textoExcepción de la ficha Task Manager para cualquier actividad automática que utilice la mensajería.

Usar la ficha Administrar flujo de trabajoLa ficha Administrar flujo de trabajo permite enviar un evento al flujo de trabajo para completar unatarea o continuar depurando el proceso.

Su nombre debe coincidir con el del evento que espera el flujo de trabajo (especificado en la fichaDesencadenador de la actividad pendiente en el flujo de trabajo).

Para enviar un evento al flujo de trabajo:

1. Escriba el nombre del evento en el campo Enviar Evento al flujo de trabajo.

2. Haga clic en Enviar.

Depurar los métodos personalizados con eldepurador de procesoSi utiliza métodos personalizados en sus flujos de trabajo, puede depurarlos utilizando el depuradorde proceso.

Para depurar un método personalizado:

1. Inicie Process Builder en modo de depuración.

2. Modifique el acceso directo para agregar opciones de depuración y habilitar la depuraciónmediante el puerto especificado.

Por ejemplo:

-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n

El acceso directo completo puede ser similar al siguiente:

C:\Program Files\Documentum\java\1.5.0_12\jre\bin\java.exe"-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n-Xms128m -Xmx256m -Dswing.aatext=true -cp ".;lib\bpm.jar;..\..\dctm.jar;C:\Documentum\config" WorkflowEditor -locale en_US

3. En el entorno de desarrollo integrado (IDE), agregue una nueva configuración de depuración paraconectar el host y puerto.

4. Inserte puntos de ruptura en el código, ejecute esta configuración de depuración desde el IDE yempiece a depurar el proceso desde Process Builder.

Cuando se llegue a una actividad que utiliza su método personalizado, podrá realizar la depuraciónmediante el código de método personalizado.



Nota: Para hacer que el código de método esté disponible al depurador de proceso, debe ser unaclase que se encuentre en la estructura de directorios adecuada o un archivo JAR emplazado en lacarpeta classes\custom en el directorio de instalación de Process Builder.




Capítulo 10

Solución de problemas


• Descripción de los archivos de registro

Descripción de los archivos de registroLos mensajes del archivo de registro proporcionan información valiosa cuando necesita depurar ysolucionar problemas de Process Builder. Si surgen problemas cuando el sistema lee un proceso delrepositorio o al guardar un proceso en un repositorio, Process Builder registra mensajes útiles y trazasde la pila de errores en un archivo de registro.

Process Builder registra los mensajes mediante log4j. La salida de la consola estándar (System.out ySystem.err) también se desvía al archivo de registro.

El archivo log4j.properties existente tiene el siguiente anexador para el registro de Process Builder:log4j.rootCategory=ERROR, A1, F1

log4j.logger.com.documentum.bpd=ERROR, bpdappenderlog4j.additivity.com.documentum.bpd=falselog4j.appender.bpdappender=org.apache.log4j.RollingFileAppenderlog4j.appender.bpdappender.File=processbuilder.loglog4j.appender.bpdappender.MaxFileSize=100KBlog4j.appender.bpdappender.layout=org.apache.log4j.PatternLayoutlog4j.appender.bpdappender.layout.ConversionPattern=%5p %c - %m%n

El archivo se envía con el conjunto de anexadores a ERROR.

Cambiar el nivel del anexador a DEBUGPara cambiar el nivel de anexador a DEBUG:

1. Para ver los mensajes de nivel de depuración, cambie el nivel del anexador a DEBUG en elarchivo log4j.properties del modo siguiente:

log4j.logger.com.documentum.bpd=DEBUG, bpdappender

2. Reinicie Process Builder.

Process Builder imprime los mensajes en el archivo processbuilder.log.

Puede localizar los mensajes de registro en el archivo processbuilder.log situado en el directorio enel que está instalado Process Builder. Por ejemplo:


Solución de problemas

C:\Program Files\Documentum\bpm\classes

Acceder a tipos de datos estructurados desde unaaplicación personalizada

Para obtener acceso a los atributos de los tipos de datos estructurados, puede utilizar las APIIDfWorkitemEx e IDfWorkflowEx.

Encontrará información detallada en los archivos Javadoc almacenados en Archivos deprograma\Documentum\help\bpm\api.

Nota: Durante el proceso de instalación, asegúrese de que ha seleccionado la opción para instalar ladocumentación del desarrollador. Esta opción instala JavaDocs en su sistema local.


Capítulo 11

Plantillas de actividades incorporadas


• Plantillas de actividades incorporadas

• Plantillas de actividades de Servicios de contenido

• Flujo

• Integración

• Plantillas de actividad no admitidas

• Ejemplo

Plantillas de actividades incorporadasProcess Builder se suministra con un conjunto de plantillas de actividades predefinidas para las tareasde los procesos comerciales habituales. Las plantillas están disponibles en la ventana Plantillas deactividades del Navegador de recursos y se organizan en una estructura de árbol que refleja el tipode tarea que representa cada una. Por ejemplo, el nodo Servicios de contenido contiene plantillas deactividades relacionadas con las funciones de gestión de contenido básicas y el nodo Integracióncontiene plantillas para las actividades que envían datos del proceso de flujo de trabajo a participantesexternos que usan las funciones de mensajería de Documentum Process Integrator.

Puede crear plantillas de actividad personalizadas para complementar las que se suministran. ConsulteCrear plantillas de actividad, página 97. Process Builder incluye una plantilla de actividad de ejemploque muestra el formato del archivo XML de plantilla de actividad para ayudarle a crear plantillas deactividad personalizadas. Aparece en el nodo de actividad de ejemplo.

En este apéndice se describe cada una de las plantillas de actividades y los parámetros especiales quees necesario escribir al crear una actividad a partir de ellas.

Nota: Las plantillas de actividades entrantes requieren que el archivo BPS.war esté implementado enel servidor de aplicaciones.

Plantillas de actividades de Servicios decontenidoLas plantillas de actividad de la ventana Servicios de contenido permiten incluir las tareas de gestiónde contenido básicas en los procesos comerciales.

Las actividades basadas en estas plantillas muestran solamente tres fichas en el Inspector deactividades: Ejecutante (que identifica el método de flujo de trabajo que debe ejecutarse), Definición y



una ficha personalizada. Las restantes fichas estándar del Inspector de actividades no son pertinentespara las actividades de los servicios de contenido.

BOF Module (Módulo BOF)Las actividades basadas en esta plantilla ejecutan un método Java empaquetado como un módulomediante Business Object Framework (BOF) de Documentum. La herramienta de asignación dedatos se utiliza para proporcionar valores para los parámetros de entrada del método y para asignarlos valores devueltos a los datos del proceso con el fin de que estén disponibles para actividadesposteriores. La plantilla de actividad del módulo BOF admite atributos de repetición simples ycomplejos tanto en la asignación de mensajes de entrada como en la de salida.

Nota: El tipo de datos de los parámetros y del valor de devolución debe ser un tipo primitivo de Java,Byte[] (y/o byte[]), un objeto DataSource o un objeto JavaBean. BLOB (Objeto binario grande) y losdatos binarios se representan como matriz de bytes. El tipo de datos char no se admite actualmente.

Para obtener información sobre el empaquetado de un método Java como un módulo BOF, consulte laguía Documentum Foundation Classes Development Guide.

Para configurar una actividad del módulo BOF:

1. En el Inspector de actividades, haga clic en la ficha Configuración de módulo BOF.2. Seleccione el módulo BOF que desea ejecutar.

a. Haga clic en Seleccionar.Aparecerá un cuadro de diálogo de selección en el que se muestra el contenido de lacarpeta \System\Modules.

b. Desplácese hasta el módulo que desea ejecutar y resáltelo.c. Haga clic en Aceptar.

Se cerrará el cuadro de diálogo y el nombre del módulo aparecerá en el cuadroMódulo BOF.Process Builder rellenará los cuadros de lista Interfaz yMétodo según el módulo seleccionado.

3. En los cuadros de lista, seleccione la interfaz y el método que se ejecutará.4. Haga clic en Siguiente.

El botón Siguiente aparecerá como no disponible hasta que haya escrito valores para todos loscampos requeridos en la página actual.

5. Si el método seleccionado tiene parámetros de entrada, proporcione valores para los parámetrosmediante la herramienta de asignación de datos.

En la pantalla Asignación de mensaje de entrada, la columna derecha de la herramienta deasignación de datos muestra los parámetros de entrada para el método. En la columna izquierdase muestran los datos de proceso. Se puede asignar el valor del atributo de datos de un paquetecomo un argumento de entrada para un método como Byte[] (y/o byte[]). Si los argumentosdel método o los valores devueltos son matrices, se mostrarán como atributos de repetición enlas pantallas de asignación de entrada/salida. El nodo/tipo de atributo del atributo de repeticiónserá el mismo que el tipo de matriz. Por ejemplo, para Cadena[], el nodo será de tipo cadena,para booleano[], será de tipo booleano, etc.

También se pueden asignar los datos y el tipo de contenido de un paquete a un DataSource.

Consulte Introducción a la herramienta de asignación de datos, página 139 para obtenerinformación detallada sobre el uso de la herramienta de asignación de datos.



Si el método seleccionado no tiene parámetros de entrada, la pantalla Asignación de mensaje deentrada no aparecerá. Continúe en el paso 7.


Si el método seleccionado no tiene valores de salida, el botón Siguiente aparecerá como nodisponible. Omita el paso siguiente.

7. Utilice la herramienta de asignación de datos para guardar los valores de salida como valores deatributo de paquete.

En la pantalla Asignación de mensaje de salida, la columna izquierda de la herramienta deasignación de datos muestra los valores devueltos por el método. En la columna derecha semuestran los datos de proceso.

En Asignación de mensaje de salida, un método puede devolver un valor a un paquete como Byte[](o byte[]). Sin embargo, debe establecer manualmente el formato del contenido del paquete en unvalor de cadena. También puede escribir el contenido de un DataSource en un paquete mediante laasignación del valor del atributo de los datos al atributo de los datos del paquete.


En tiempo de ejecución, si existe el paquete de destino, el valor del atributo de los datos sesustituye por los datos del DataSource o del método Byte[] (y/o byte[]). Para DataSource, elvalor del atributo de formato del paquete de destino se sustituye por el valor de formato delDataSource. Si no existe el paquete de destino, se creará un paquete nuevo. Los datos y el formatodel paquete de origen se copiarán en el paquete nuevo. Sin embargo, si el paquete de origen notiene una asignación de formato, el valor para el atributo de formato en el paquete de destinose define en "crtext".

Crear carpeta

Las actividades basadas en esta plantilla crean una nueva carpeta en el repositorio basada en unnombre de carpeta determinado o en una plantilla de carpeta. Para configurar la actividad, asigne unnombre a la nueva carpeta y especifique la ruta de acceso a la ubicación en la jerarquía de carpetas enla que desea crearla.

• Nombre de la nueva carpeta: escriba el nombre de la nueva carpeta. El nombre puede incluirvariables de sustitución. Haga clic el botón ... para mostrar un cuadro de diálogo en el que puedeseleccionar las variables disponibles.

• Crear a partir de una plantilla de carpeta (opcional): seleccione una plantilla de carpeta predefinidadel repositorio. La plantilla de carpeta permite crear una copia de la carpeta que incluye las carpetasanidadas, con el nombre raíz de la plantilla de carpeta utilizada como nuevo nombre de la carpeta.

• Carpeta de destino: haga clic en el botón ... para desplazarse hasta la carpeta principal en la que secreará la nueva carpeta. Al hacer clic en Aceptar en el cuadro de diálogo, el nombre de la carpetaprincipal aparecerá en el campo de datos. Nota: La carpeta de destino especificada en la plantilla deactividades debe ser exclusiva o la actividad no se completará

• O escriba la ruta de la carpeta: escriba la ruta completa a la carpeta principal en la que se crearála nueva carpeta, comenzando por una barra diagonal inversa y el nombre del archivador de nivelsuperior (por ejemplo, /System/Workflow). Al escribir la ruta de la carpeta en lugar de seleccionarla,puede incluir una o más variables de sustitución en la especificación de la ruta. Haga clic el



botón ... para mostrar un cuadro de diálogo en el que puede seleccionar las variables disponibles,incluyendo las variables de paquete.Nota: Si piensa utilizar Documentum Composer para migrar la plantilla de proceso, escriba elnombre de la carpeta y la ruta de acceso para evitar que el sistema importe la carpeta ademásde su contenido.

• Enlazar carpeta al paquete: enlaza la carpeta completa al paquete seleccionado en la listadesplegable.

Búsqueda de FS2 (Federated Search Services)Esta plantilla de actividad habilita una búsqueda de FS2 basada en un criterio de búsquedapreconfigurado. Los resultados de búsqueda, que pueden incluir páginas HTML, documentos de Word,archivos PDF, imágenes, etc., se guardan en la carpeta de resultados de búsqueda de FS2 y se muestranen el orden especificado en el campo Guardar resultados de FS2 con clasificación hasta (0-1).

La plantilla de actividad de búsqueda de FS2 puede utilizarse para buscar en varios destinos comoFileNet y servidores de Open Text, sitios Web externos y otros repositorios de Documentum a losque los adaptadores de FS2 puedan tener acceso.

Se ejecuta automáticamente una búsqueda de FS2 preconfigurada basada en la palabra clave Nombreen los sitios Web siguientes:

• http://www.google.com• http://www.cnn.com• http://www.interpol.int/• http://www.fbi.gov/• http://www.dhs.gov/dhspublic/• http://europa.eu/pol/cfsp/index_en.htm• http://news.bbc.co.uk/• Factiva• Repositorio actual• Abrir directorioNota: Estos destinos de búsqueda se configuran en el Centro de administración de FS2. El manualDocumentum ECI Services Administration Guide proporciona más información acerca de cómoconfigurar los destinos de búsqueda.

Configure los campos siguientes para permitir a la plantilla de actividad buscar el contenido.

• Cadena de búsqueda: escriba la cadena de búsqueda que define la información que está buscandoo haga clic en el botón con puntos suspensivos (...) situado junto al campo para seleccionar unacadena de búsqueda preconfigurada en un cuadro de diálogo.

• Ruta de archivo temporal de resultados de FS2: escriba la ruta de acceso completa de la ruta deacceso del archivo de resultados temporales. El archivo temporal se utiliza para guardar el contenidode un origen externo. Después de guardarlo en un archivo local, se importa en el repositorio.

• Guardar resultados de FS2 en el archivador: escriba el nombre del archivador que almacenarásus resultados.

• Guardar resultados de FS2 en la carpeta: escriba el nombre de carpeta del archivo de resultadosen el repositorio.



• Guardar resultados de FS2 con clasificación hasta (0-1): escriba el valor que se va a utilizar paraevaluar los resultados que se van a guardar. El número que escribe aquí es el porcentaje de aciertosmás bajo que guarda el sistema. Por ejemplo, para guardar los resultados que coincidan de un 50%a un 100% respecto al criterio de búsqueda, escriba .5. Para guardar un criterio de búsqueda quecumpla al menos el 20% del criterio de búsqueda, escriba .2.

Abrir procesoLa actividad Invocar proceso inicia un flujo de trabajo nuevo. La actividad se completará cuando seinicie el nuevo flujo de trabajo.

Aunque el nuevo flujo de trabajo es un subproceso lógico del flujo de trabajo que lo inicia, no hayninguna relación formal entre los objetos de ambos flujos de trabajo, que son independientes. Si deseahacer una pausa en el flujo de trabajo actual hasta que se complete el proceso, defina la siguienteactividad para que se desencadene como respuesta a un evento (en la ficha Desencadenador) e incluyauna actividad en el otro proceso, basada en la plantilla de actividad Publicar evento en proceso padre,que envíe el evento que espera el proceso principal.

Antes de configurar una actividad Invoke Process (Abrir proceso), deberá seleccionar primero elusuario que servirá como supervisor del flujo del nuevo flujo de trabajo.

Para configurar un actividad Invoke Process (Abrir proceso):

1. En el Inspector de actividades, haga clic en la ficha Invoke Process (Abrir proceso).2. Seleccione un proceso hijo en el cuadro de lista Nombre de proceso. Los paquetes obligatorios de

la plantilla seleccionada deben coincidir con los paquetes del flujo de trabajo actual tanto en nombrecomo en tipo. La coincidencia se aplica a todos los paquetes definidos, no sólo a los visibles.

3. Seleccione una actividad del cuadro de lista Iniciar actividad o elija Iniciar todas las actividades.

A continuación se iniciará la actividad seleccionada del proceso nuevo o se iniciarán todas lasactividades del proceso con el mismo ID de flujo de trabajo.

4. Haga clic en Siguiente.5. Si el proceso hijo tiene paquetes, proporcione valores para los paquetes mediante la herramienta de

asignación de datos.

En la pantalla Asignación de mensaje de entrada, la columna izquierda de la herramienta deasignación de datos muestra los paquetes del proceso principal. La columna derecha muestra lospaquetes del proceso hijo. Si hay más de un paquete en el proceso, debe asignar los paquetesobligatorios que se muestran en negrita. En caso contrario, se producirá un error. La columnaderecha también muestra el atributo Supervisor. El valor de este atributo debe ser el tipo de datosde cadena. Si no selecciona un supervisor, se utilizará el del proceso principal. Al realizar laasignación, los paquetes de la actividad deberán ser del mismo tipo de paquete o un supertipo delos paquetes del flujo de trabajo principal. Consulte Introducción a la herramienta de asignación dedatos, página 139 para obtener información detallada sobre el uso de la herramienta de asignaciónde datos.

6. Haga clic en Siguiente.7. Utilice la herramienta de asignación de datos para guardar los valores de salida como valores de

atributo de paquete.

En la pantalla Asignación de mensaje de salida, la columna izquierda de la herramienta deasignación de datos muestra el ID del flujo de trabajo de la actividad. Opcionalmente, los usuarios



pueden copiar este ID en el atributo de paquete con fines de control o auditoría. La columnaderecha muestra los atributos de paquete del proceso principal.


Puede considerar que necesita agregar atributos o elementos a algunos datos para completar lasasignaciones.

• Introducción a la herramienta de asignación de datos, página 139 proporciona procedimientos parautilizar la herramienta de asignación de datos.


• Asignar atributos de paquete, página 141 proporciona instrucciones para exponer otros atributos deorigen de un paquete que no aparecen actualmente en el árbol

Ciclo de vidaNota: Esta plantilla de actividad solo se admite en Documentum Process Builder versión 6.5 yversiones posteriores. Si se utiliza una versión anterior de Process Builder para un repositorio deDocumentum 6.5, no se abrirá esta plantilla.

Las actividades basadas en esta plantilla mueven el ciclo de vida del objeto a otro estado. Se puedenrealizar cuatro operaciones de ciclo de vida en el objeto:

• Promover, que pasa el objeto al estado especificado en el asignador de entrada.

• Volver al estado original, que mueve el objeto de su estado normal actual al estado normal anterior oal estado base si el parámetro demote_to_base_state está establecido en verdadero.

• Suspender, que detiene temporalmente el avance de un objeto por los estados del ciclo de vidaasignado.

• Reanudar, que reanuda el objeto con un estado de ciclo de vida en pausa.

Para cambiar una operación de ciclo de vida:

1. Seleccione la operación de ciclo de vida a la que desea mover el objeto.

2. Haga clic en Siguiente para usar el asignador de datos para asignar los atributos que cambian elestado del ciclo de vida del objeto.

Como referencia, en la página de configuración se muestran consejos para las asignacionesnecesarias y opcionales.







Tabla 15 Asignaciones de plantilla de ciclo de vida

Operación Requisito DescripciónPromover Requerido r_object_id identifica el objeto que se va a promover.

Opcional. state identifica el estado de destino deseado. El valorpredeterminado es el estado siguiente.

Opcional. override_entry_checks establecido en verdadero omitirála comprobación de la entrada de estado de ciclo de vidaconfigurado. (Cada estado del ciclo de vida tiene un conjuntode criterios de entrada que debe cumplir normalmente undocumento para ser promovido a ese estado). El valorpredeterminado es falso.

Devolver al estadoanterior

Requerido r_object_id identifica el objeto que se va a devolver al estadoanterior.

Opcional. state identifica el estado de destino deseado. El valorpredeterminado es el estado anterior.

Opcional. demote_to_base_state establecido en verdadero obliga adevolver el objeto al estado base. El valor predeterminado esfalso. Anula el estado.

Si el estado y demote_to_base_state están asignados,demote_to_base_state anula la asignación de estado.

Suspender Requerido r_object_id identifica el objeto que se va a suspender.

Opcional. El estado identifica el estado actual desde el cual se suspenderáel objeto. Puede ser un número de posición o el nombre delestado.

Opcional. override_entry_check establecido en verdadero omitela comprobación de la entrada de estado de ciclo de vidaconfigurado (el valor predeterminado es falso).

Reanudar Requerido r_object_id identifica el objeto que se va a reanudar.

Opcional. El estado identifica el estado de excepción desde el cual sereanudará el objeto. Puede ser un número de posición o elnombre del estado.

Opcional. override_entry_checks establecido en verdadero omitirála comprobación de la entrada de estado de ciclo de vidaconfigurado. (El valor predeterminado es falso).



Operación Requisito DescripciónOpcional. El valor resume_from_base_state establecido en verdadero

obliga a mover el objeto al estado base. (El valorpredeterminado es falso). Anula el estado.

Opcional. Si se asignan tanto state como resume_from_base_state,resume_from_base_state reemplaza a la asignación state.

Aplicar ciclo de vidaNota: Esta plantilla de actividad solo se admite en Documentum Process Builder versión 6.5 yversiones posteriores. Si se utiliza una versión anterior de Process Builder para un repositorio deDocumentum 6.5, no se abrirá esta plantilla.

Las actividades basadas en esta plantilla aplican un ciclo de vida de documento a un paquete delproceso comercial. Un ciclo de vida define una serie ordenada de estados que corresponden a las fasesde la vida de un documento.

Para configurar una actividad de Aplicar ciclo de vida, debe elegir el ciclo de vida que desea aplicar yel valor de ciclo de vida que se aplicará a los datos del proceso. Asimismo, debe especificar el estadoinicial del ciclo de vida y el alcance que se utilizará cuando se resuelvan alias asociados al ciclo devida. Consulte la guía Documentum Composer User Guide si precisa información detallada sobre lacreación y el uso de los ciclos de vida.

Para configurar la plantilla de actividad Aplicar ciclo de vida:

1. Seleccione la ficha Configuración de ciclo de vida.

2. En el cuadro de lista, seleccione el Nombre de ciclo de vida que se debe aplicar al paquete.

3. Seleccione el Alcance que se utilizará para resolver los alias asociados con el ciclo de vidaseleccionado.

Ésta es la clave para que el tipo dm_alias_set recupere la asignación de los valores de alias aquídefinidos. Los valores que aparecen en el cuadro de lista desplegable dependen del ciclo de vida.

4. Seleccione el Estado inicial que se debe aplicar al paquete.

5. Haga clic en Siguiente para usar el asignador de datos para asignar los atributos que aplicanun ciclo de vida al objeto.

Asignaciones necesarias

r_object_id Identifica el objeto al que se aplica el ciclo de vida.

Enlazar a carpetaLas actividades basadas en esta plantilla agregan los objetos de uno o varios paquetes a una carpetaespecificada del repositorio. Para configurar la actividad, debe especificar el nombre y la ubicación dela carpeta. La actividad puede copiar los paquetes especificados a la carpeta (manteniendo los enlacesde éstos a otras carpetas en las que pueden residir) o mover los paquetes a la carpeta (desenlazándolosde otras carpetas). Si la carpeta especificada no existe, la actividad puede crearla.



• O escriba la ruta de la carpeta: escriba la ruta completa a la carpeta principal en la que se crearála nueva carpeta, comenzando por una barra diagonal inversa y el nombre del archivador de nivelsuperior (por ejemplo, /System/Workflow). Al escribir la ruta de la carpeta en lugar de seleccionarla,puede incluir una o más variables de sustitución en la especificación de la ruta. Haga clic elbotón ... para mostrar un cuadro de diálogo en el que puede seleccionar las variables disponibles,incluyendo las variables de paquete.Nota: Si piensa utilizar Documentum Composer para migrar la plantilla de proceso, escriba elnombre de la carpeta y la ruta de acceso para evitar que el sistema importe la carpeta ademásde su contenido.

• Enlazar carpeta al paquete: enlaza la carpeta completa al paquete seleccionado en la listadesplegable.

• Paquetes: haga clic en el botón ... para mostrar un cuadro de diálogo en el que podrá seleccionar lospaquetes de proceso cuyo contenido desea enlazar a la carpeta del repositorio. Resalte el nombredel paquete en la lista de la izquierda y haga clic en el botón Agregar para moverlo a la lista depaquetes seleccionados de la derecha. Al hacer clic en Aceptar en el cuadro de diálogo, los nombresde los paquetes seleccionados aparecerán en el campo de datos.

• Nombre de la nueva carpeta: escriba el nombre de la nueva carpeta. El nombre puede incluirvariables de sustitución. Haga clic el botón ... para mostrar un cuadro de diálogo en el que puedeseleccionar las variables disponibles.

• Crear carpeta si no existe: seleccione Sí para que el sistema cree una carpeta con el nombreespecificado si no existiera.

• Crear a partir de una plantilla de carpeta (opcional): seleccione una plantilla de carpeta predefinidadel repositorio. La plantilla de carpeta permite crear una copia de la carpeta que incluye las carpetasanidadas, con el nombre raíz de la plantilla de carpeta utilizada como nuevo nombre de la carpeta.

• Carpeta de destino: haga clic en el botón ... para desplazarse hasta la carpeta principal a la quese enlazará la nueva carpeta. Al hacer clic en Aceptar en el cuadro de diálogo, el nombre de lacarpeta principal aparecerá en el campo de datos.

• O escriba la ruta de la carpeta de destino: escriba la ruta completa a la carpeta principal de la carpetaa la que se enlazará el contenido, comenzando por una barra diagonal inversa y el nombre delarchivador de nivel superior. Al escribir la ruta de la carpeta en lugar de seleccionarla, puede incluiruna o más variables de sustitución en la especificación de la ruta. Haga clic el botón ... para mostrarun cuadro de diálogo en el que puede seleccionar las variables disponibles.

• Desenlazar de las carpetas originales: seleccione Sí para que la actividad mueva los paquetes a lacarpeta especificada, desenlazándolos de otras carpetas; o seleccione No para copiar los paquetes ala carpeta, manteniendo los enlaces a otras carpetas. El valor predeterminado es No.

• Enlazar carpeta al paquete: para anexar el objeto de carpeta al proceso de negocio, seleccione elpaquete al que desea anexarlo en el cuadro de lista.

Nuevo caso con plantillaUtilice la plantilla de actividad Nuevo caso con plantilla para crear una carpeta y su contenido a partirde una plantilla predefinida. Esta carpeta se puede incluir en el proceso como un anexo o un paquete,y su contenido se puede mostrar en Documentum TaskSpace o Webtop. Por ejemplo, puede utilizarla plantilla de actividad Nuevo caso con plantilla para crear una carpeta que contenga subcarpetas ydocumentos asociados. A continuación puede utilizar el asignador de datos para definir algunosatributos de esos documentos basándose en datos de proceso.

Para configurar una plantilla de actividad Nuevo caso con plantilla:



1. En la ficha Crear carpeta, desplácese y seleccione la plantilla de carpeta del repositorio que deseeutilizar para crear la carpeta nueva y su contenido.

2. Puede decidir que todos los objetos de la carpeta utilicen la LCA de carpeta seleccionandoPropagar ACL a objetos hijo.

3. Haga clic en Siguiente para utilizar la página Asignación de entrada para asignar los atributosde la carpeta a los datos de proceso.

Esta operación incluye todos los atributos personalizados que se pueden establecer si la plantillaseleccionada es del subtipo dm_folder.


object_name Se asigna al nombre de la carpeta nueva.

r_folder_path Se asigna a la ubicación de la carpeta nueva.





4. Haga clic en Siguiente para utilizar la página Asignación de salida para adjuntar la carpeta nueva ysu contenido como un paquete o un anexo al proceso.

FlujoLas plantillas de actividad del nodo Flow (Flujo) se utilizan para controlar el flujo de trabajo a travésdel proceso comercial.

Decision Split (División de la decisión)

La plantilla de actividad Decision Split (División de la decisión) le permite mostrar explícitamentepuntos de decisión en una plantilla de proceso comercial. En lugar de especificar la lógica deramificaciones en la ficha Transición de una actividad que realiza otro tipo de acción, puede agregaruna actividad cuya única acción sea la de evaluar la lógica y reenviar los paquetes según corresponda.La separación de la decisión de las demás acciones permite que el flujo de proceso resulte más claro.



Figura 9 Proceso de aprobación sin y con la actividad Decision Split (División de ladecisión)

Al agregar una actividad Decision Split (División de la decisión), enlace la actividad anterior a estaactividad y defina su transición como Seleccionar todas las actividades conectadas. Defina la lógicade ramificaciones en la ficha Transición de la actividad Decision Split (División de la decisión).

La plantilla de actividad Decision Split (División de la decisión) no incluye fichas ni campospersonalizados. Cuando se ve una actividad creada con la plantilla Decision Split (División de ladecisión) en el Inspector de actividades, sólo aparecen las fichas Temporizadores, Transición,Datos y Visualización. Estas fichas contienen todos los valores de configuración relevantes parauna actividad de punto de decisión.

Nota: El sistema utiliza dm_bpm_noop_method para conectar con el repositorio y completar laactividad en lugar de iniciar un método en tiempo de ejecución.

Unir

La plantilla de actividad Unir le permite incluir actividades para evaluar las condiciones dedesencadenamiento cuando convergen varios flujos en un proceso comercial. En lugar de especificarlas condiciones de desencadenamiento en la ficha Desencadenador de una actividad que realiza otrotipo de acción, puede agregar una actividad cuya única acción sea la de evaluar las condiciones yreenviar paquetes según corresponda. La actividad Unir espera a que finalice un determinado númerode las actividades anteriores y, a continuación, reenvía sus paquetes a la siguiente actividad. Lasiguiente actividad no necesita evaluar las condiciones de desencadenamiento, puesto que la actividadUnir ya lo ha hecho.



Figura 10 Proceso de revisión sin y con la actividad Unir

La plantilla de actividad Unir no incluye fichas ni campos personalizados. Cuando se ve una actividadcreada con la plantilla Unir en el Inspector de actividades, sólo aparecen las fichas Desencadenador,Temporizadores, Datos y Visualización. Estas fichas contienen todos los valores de configuraciónrelevantes para una actividad Unir.

Nota: El sistema utiliza dm_bpm_noop_method para conectar con el repositorio y completar laactividad en lugar de iniciar un método en tiempo de ejecución.

Publicar evento en proceso padreLas actividades basadas en la plantilla Publicar evento en proceso padre funcionan de manera conjuntacon las de Invoke Process (Abrir proceso) para habilitar los subprocesos sincrónicos. Un flujo deproceso principal inicia un nuevo subproceso mediante una actividad Invoke Process (Abrir proceso) yespera a que se envíe un evento determinado antes de continuar. El subproceso secundario utiliza unaactividad Publicar evento en proceso padre para enviar el evento, de modo que el proceso principalpueda continuar.

• Nombre de evento: el nombre del evento que se enviará al flujo de trabajo principal. Su nombredebe coincidir con el del evento que espera el flujo de trabajo principal (especificado en la fichaDesencadenador de la actividad pendiente en el flujo de trabajo principal).

• Nombre del supervisor: seleccione el usuario en cuyo nombre se envía el evento.

Transformación XSLLa plantilla de actividad Transformación XSL crea actividades que realizan una transformación enun archivo XML. Las actividades basadas en esta plantilla recuperan contenido XML de un paquetede flujo de trabajo, le aplican un archivo XSL y, a continuación, anexan el archivo transformadocomo otro paquete de flujo de trabajo.



• Transformar contenido de paquete: el nombre del paquete de flujo de trabajo cuyo contenido XMLse va a transformar.

• Transformar con este archivo XSL: haga clic en el botón situado junto al campo para seleccionarel archivo XSL que se utilizará para transformar el contenido XML. El archivo XSL debe estarguardado en el repositorio.

• Anexar resultado como contenido del paquete: el nombre del paquete de flujo de trabajo en el que seescribirá el contenido transformado. Debe especificar un paquete válido definido para el proceso.

• Formato de contenido transformado: especifica si el contenido transformado se debe guardar enformato XML o HTML.

IntegraciónLas plantillas de actividad de la ventana Integración proporcionan un método para intercambiar datosentre el proceso comercial y los sistemas o ejecutantes externos. Algunas plantillas ofrecen una interfazsimilar a la de un asistente para definir la forma en que los datos se pasan de un origen de datos a otro.

Nota: Las plantillas de actividades entrantes requieren que el archivo BPS.war esté implementado enel servidor de aplicaciones.

Crear LCA (lista de control de acceso)Utilice la plantilla de actividad de LCA para crear un objeto LCA de Documentum a partir de unaplantilla de LCA y aplicarlo a objetos dentro de una instancia de proceso. La plantilla de LCA ya debeexistir en el repositorio y, al crearla, se debe haber especificado que incluya marcadores de posición oalias tanto para usuarios como para grupos. El sistema utiliza la plantilla de actividad Crear LCA conel fin de suministrar valores para dichos marcadores de posición y alias en función de los datos deprocesos y, tras resolver los alias, crea otro objeto LCA a partir de la plantilla.

Por ejemplo, puede crear con Documentum Composer una plantilla de LCA para un caso de clienteque permita a un supervisor disponer de permisos de escritura y eliminación para un paquete mientrasque el procesador del caso sólo tenga acceso de escritura. Una plantilla de LCA puede disponer dediferentes alias para los usuarios y los grupos de manera que se les otorguen distintos permisos.También puede crear LCA independientes para departamentos que requieran diversos conjuntos depermisos para sus usuarios y grupos.

Para configurar una actividad LCA basada en una plantilla de LCA:

1. En el campo Elegir plantilla de LCA, seleccione una plantilla de LCA existente en el repositorio.

2. Haga clic en Siguiente para asignar datos de proceso a los atributos de la plantilla de LCA.

Los atributos siguientes deben asignarse a los datos de proceso.


acl_name Se asigna al nombre del nuevo objeto LCA.

acl_domain Se asigna al propietario del nuevo objeto LCA.

acl_class Realiza una asignación a la clase ACL.

Los valores válidos son:



• 0: LCA privadaLas LCA privadas son LCA que solo están disponibles a los usuarios que las crean. Sólo elpropietario de una LCA privada o un usuario con privilegios de superusuario pueden modificar oeliminar la LCA.

• 3: LCA públicaSon LCA públicas las listas disponibles para cualquier usuario del repositorio. Sólo el propietario obien los usuarios con privilegios de administrador del sistema o de superusuario pueden modificar oeliminar las LCA públicas.

%grpcat, %Usercat y%usrgrpcat

Se asigna a los nombres de alias individuales del grupo, el usuario ylas categorías de usuario o de grupo. Asigne estos valores a los valorescorrectos de nombre de usuario o de grupo en los datos de proceso.

Para obtener más información sobre cómo resuelve los alias Content Server, consulte el apéndicesobre alias en la Guía de fundamentos de Content Server.

Nota: Los alias que pertenecen a categorías como conjunto de permisos, ruta de archivador y rutade carpeta no son compatibles con esta acción en el asignador de datos.





3. Haga clic en Siguiente para asignar los parámetros de salida de LCA a los datos de proceso. Deeste modo se aplica la LCA al paquete o al anexo.


r_object_id Se asigna al ID de objeto del nuevo objeto LCA.

acl_domain Se asigna al propietario del nuevo objeto LCA.

acl_name Se asigna al nombre del nuevo objeto LCA.

Crear evento de iCalendarLa plantilla de actividad Crear evento de iCalendar permite crear un archivo de intercambio de datosde calendario (.ics) que se pueda utilizar para crear un evento de calendario o una reunión en cualquiercliente que sea compatible con tipos de archivo iCalendar. La plantilla de actividad crea el archivobasándose en las asignaciones de entrada asignadas a los valores del archivo .ics. A continuaciónpuede enviar este archivo a los destinatarios o asistentes mediante una plantilla de actividad SMTP oHTTP saliente.

La plantilla de actividad sólo admite eventos de iCalendar (VEVENT).

Con esta plantilla de actividad no se escribe el evento de calendario en los datos de proceso, esdecir, si se vuelve a programar el evento o un cliente externo lo cancela, los datos de proceso no seactualizan con los cambios.



Nota: La plantilla de actividad Crear evento de iCalendar no es compatible con la característica decalendario comercial de TaskSpace. La actividad crea el archivo ICS basándose en un calendarioestándar.

Para crear un archivo de evento de iCalendar:

Nota: La plantilla de actividad Crear evento de iCalendar no tiene una página de configuración.

1. Utilice la herramienta del asignador de datos para asociar datos de proceso a atributos del archivode calendario.

Asocie un UID existente de los datos de proceso al uid de los atributos del calendario de destinopara actualizar un evento de calendario existente. Para actualizar un evento existente coninformación nueva, utilice el identificador existente como UID para el archivo. Esto cambiaráel evento cuando el archivo ICS se envíe en una actividad posterior. El sistema utiliza el UIDexistente para localizar y actualizar el evento de calendario existente.

Si el UID no está asignado a un valor, el servidor de métodos genera uno y el sistema lo asignaal archivo ICS. Cuando se crea el archivo ICS, el servidor de métodos genera un identificadorúnico para el evento.

Asocie cualquier otro dato de proceso a los atributos del calendario.

La especificación Internet Calendaring and Scheduling Core Object Specification (iCalendar)publicada por el Grupo de Trabajo en Ingeniería de Internet (IETF, Internet Engineering TaskForce), proporciona información detallada sobre las diferentes propiedades del archivo iCalendar.





2. Haga clic en Siguiente para adjuntar el archivo de invitación de calendario a los datos de procesocomo un paquete o un anexo.

DB entrante: inicio y procedimiento

Utilice la plantilla de actividad Base de datos entrante para recuperar las filas de una tabla de basede datos o ver y crear los flujos de trabajo o completar una actividad. El sistema crea una escuchaen tiempo de ejecución que ejecuta la instrucción select especificada para recuperar las filas para suprocesamiento. Una vez procesada la fila, una instrucción SQL definida por el usuario actualiza oelimina la fila para asegurarse de que no se ha procesado varias veces.

Por ejemplo, una compañía tiene una aplicación de base de datos que consulta una tabla de inventariopara buscar elementos que necesitan reabastecimiento. La actividad Base de datos entrante puedeconsultar la tabla de artículos que es necesario reponer para iniciar un proceso de pedido de comprade los artículos necesarios.



La plantilla de actividad Base de datos entrante solo obtiene los registros de una tabla o de una vista.Cada fila inicia una nueva instancia de proceso o completa una actividad intermedia. Cada registrodebe tener columnas que se pueden utilizar para identificar exclusivamente el registro. Además, cadafila en la base de datos debe corresponder con un solo evento. Por ejemplo, si un informe de gastostiene varios elementos de línea asociados, se deben almacenar en una tabla separada.

Para configurar la plantilla de actividad Base de datos entrante:

1. Abra la plantilla de actividad Base de datos entrante.

2. En el cuadro de lista Controlador JDBC, seleccione el controlador JDBC que se utilizará.

3. En el cuadro Cadena de conexión, escriba la cadena de conexión JDBC que se utilizará paraconectar con la base de datos.

La sintaxis esperada de la cadena de conexión aparecerá bajo el cuadro cuando seleccione elcontrolador JDBC.

4. Escriba el nombre de usuario y la contraseña que se utilizarán para conectar con la base de datos.

5. Haga clic en Probar conexión para que Process Builder conecte con la base de datos.

Si Process Builder puede conectar con la base de datos mediante la información que se haproporcionado en los pasos 2 a 4, aparecerá un mensaje en color verde bajo el cuadro Cadenade conexión. Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro.Modifique los valores e inténtelo de nuevo.

6. Escriba la instrucción Select en el cuadro Consulta a ejecutar.

La instrucción debe comenzar por la palabra clave select de SQL.

7. Haga clic en el botón Validar consulta.

Process Builder comprobará la validez de la consulta y mostrará un mensaje bajo el cuadro detexto que contiene la consulta.

Si la consulta no es válida, se obtendrá un mensaje de error de la base de datos. Corrija la consultapara que sea válida.

8. Únicamente para las actividades intermedias, seleccione un nombre de columna como el IDde correlación para que el sistema lo utilice para hacerlo coincidir con los datos recuperadosdel flujo de trabajo.

La columna contiene el identificador de correlación apropiada relacionada con la instancia de flujode trabajo concreta.

Un ID de correlación es una cadena única asociada con cada instancia de proceso y se puedeusar para identificar un flujo de trabajo y hacer coincidir el mensaje con él. El identificador decorrelación debe haberse establecido en una actividad anterior como una actividad Escribir base dedatos. Usar los identificadores de correlación, página 156 proporciona instrucciones sobre cómoutilizar la correlación en mensajes.

9. Escriba una instrucción de actualización o eliminación SQL como Instrucción paraprocesamiento posterior que marcará los registros a medida que se procese.

Para crear una consulta mediante los parámetros cuyos valores provienen de los atributos depaquete o de las variables de flujos de trabajo en tiempo de ejecución, escriba un signo deinterrogación (?) en donde desee que se sustituya el valor. El signo de interrogación representa unparámetro cuyo valor la actividad insertará en tiempo de ejecución.



Por ejemplo, una consulta que actualiza un registro del cliente basado en el número de la seguridadsocial (después de procesar el registro) incluye un signo de interrogación en lugar de un valorSSN concreto:UPDATE from CUSTOMER WHERE ssn=?

La instrucción update puede incluir cualquier número de parámetros, cada uno de ellosrepresentado por un signo de interrogación. Cada parámetro debe asignarse a los datos de procesoen la página de asignación de datos. No entrecomille el signo de interrogación.

Nota: Asegúrese de que la fila se puede identificar exclusivamente durante el procesamientoposterior para que el sistema sólo procese una única fila.

10. En el caso de las consultas que incluyen parámetros de sustitución, identifique el nombre dealias/nombre de columna para cada parámetro.

Si la consulta no incluye parámetros, omita este paso.

a. Haga clic en el botón Definir tipo de parámetros. Aparecerá un cuadro de diálogo con unalista de parámetros que corresponden al número de signos de interrogación de la consulta. Losnombres de los parámetros son parám1, parám2, etc.

b. Resalte la fila de uno de los parámetros.

c. Haga clic en el valor en la Nombre de columna/Alias y seleccione el nombre de columna o elalias de la columna del parámetro en el cuadro de lista. El nombre de columna o alias de lacolumna del parámetro debe coincidir con la columna de base de datos correspondiente a laque se asignan parámetros en la consulta del procesamiento posterior.

d. Repita los pasos b y c para cada parámetro.

e. Haga clic en Aceptar para cerrar el cuadro de diálogo.

11. Escriba el Fetch Size (Tamaño) para especificar el número de filas que se van a obtener porel controlador JDBC cuando se necesiten más filas para el procesamiento durante cada ciclodel sondeo.

12. Escriba el número de segundos utilizado como Frecuencia de sondeo después de que el sistemabusque nuevos registros en la tabla.

13. Escriba el Número de procesadores para definir el número de hilos que van a procesar losregistros simultáneamente.

14. Haga clic en Siguiente para asignar los datos del conjunto de resultados al modelo de datosde proceso.








DQL entrante: inicio y procedimientoNota: Esta plantilla de actividad solo se admite en Documentum Process Builder versión 6.5 yversiones posteriores. Si se utiliza una versión anterior de Process Builder para un repositorio deDocumentum 6.5, no se abrirá esta plantilla.

Utilice esta plantilla para procesar los objetos ubicados en un repositorio de Documentum. Cuandoel sistema encuentra un nuevo objeto, crea una nueva instancia del proceso o utiliza el objeto paracompletar una actividad o elemento de trabajo en ejecución.

En una actividad DQL entrante, se configura un oyente para escuchar un proceso entrante. Cuando seinicia el oyente, el sistema crea un hilo de sondeo que ejecuta la consulta DQL select especificada en lacalificación de DQL. El sondeo busca en el repositorio cualquier objeto nuevo que coincida con laconsulta utilizando el intervalo de tiempo especificado en la plantilla de actividad. Para cada ID deobjeto devuelto por la consulta, el sistema crea un nuevo hilo que delega el objeto en el procesadorposterior, el cual realiza la opción especificada sobre el objeto.

Para configurar una actividad DQL entrante:

1. En el Inspector de actividades, haga clic en la ficha Configuración de DQL.2. Seleccione la opción Conectarse a un repositorio diferente si está accediendo a información

desde otro repositorio.3. Escriba el Nombre del repositorio o selecciónelo en el cuadro de lista desplegable.

La lista contiene todos los repositorios a los que está conectada esta instancia de Process Builder através del archivo de configuración dfc.properties.

4. Si ha decidido conectarse a un repositorio diferente, escriba el nombre de usuario necesariopara conectarse al repositorio.

5. Si ha decidido conectarse a un repositorio diferente, escriba la contraseña necesaria paraconectarse al repositorio.

6. Haga clic en el botón Probar conexión para comprobar que los parámetros de conexión se hanescrito correctamente.

Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro de texto. Modifiquelos valores e inténtelo de nuevo.

7. Escriba la calificación de DQL para obtener objetos en el cuadro de texto.

Escriba una calificación de DQL formada por esa parte de una instrucción SELECT que empiezapor la palabra clave FROM. La calificación de DQL identifica de forma exclusiva un objeto enun repositorio.

8. Haga clic en Validar consulta para asegurarse de que la consulta es válida.9. Para las actividades intermedias solamente, seleccione un ID de correlación en la lista de atributos

que pertenezca al tipo de objeto especificado en la calificación de DQL.10. Seleccione una opción de posprocesamiento para gestionar el objeto después de que se haya

recuperado.

Los valores válidos permiten eliminar el objeto recuperado por la consulta, mover el objeto a unacarpeta especificada o actualizar los atributos basándose en la consulta introducida.

11. Si ha seleccionado mover el objeto a una carpeta para archivar, escriba la ruta de dicha carpeta.12. Si ha seleccionado actualizar valores de atributo, escriba la consulta para actualizar los atributos

del objeto en el cuadro de texto.



13. Escriba el número de segundos utilizados en Frecuencia de sondeo.

Éste es el tiempo tras el cual el procesador consulta el repositorio y obtiene cualquier entradanueva que coincida con la instrucción DQL select indicada.

14. Escriba el número de procesadores disponibles.

Éste es el número total de procesadores simultáneos que pueden supervisar los datos en estepunto final.

15. Haga clic en Siguiente para asignar los objetos a los atributos de datos de proceso.

DQL Read (Leer DQL)Nota: Esta plantilla de actividad solo se admite en Documentum Process Builder versión 6.5 yversiones posteriores. Si se utiliza una versión anterior de Process Builder para un repositorio deDocumentum 6.5, no se abrirá esta plantilla.

Las actividades basadas en esta plantilla ejecutan las consultas DQL en el repositorio especificado.Por ejemplo, puede utilizar la plantilla de actividad DQL Read para seleccionar un documento depréstamo del repositorio enviado entre una serie de fechas o en función del importe del préstamoo la puntuación de crédito.

Para configurar una plantilla de actividad Leer DQL:

1. En el Inspector de actividades, haga clic en la ficha Configuración de DQL.

2. Seleccione la opción Conectarse a un repositorio diferente si está accediendo a informacióndesde otro repositorio.

3. Escriba el Nombre del repositorio o selecciónelo en el cuadro de lista desplegable.






7. Escriba el Consulta que ejecutar en el cuadro de texto.

Para crear una consulta que utilice los valores del marcador de posición, escriba un signo deinterrogación (?) en donde desea que se sustituya el valor. El signo de interrogación representa unparámetro cuyo valor la actividad insertará en tiempo de ejecución.

8. Haga clic en el botón Configurar Tipo de parámetro para seleccionar un tipo de datos para elparámetro que especifique en la consulta DQL.

9. Haga clic en el botón Definir tipo de parámetros. Aparecerá un cuadro de diálogo con una listade parámetros que corresponden al número de signos de interrogación de la consulta.

Los nombres de los parámetros son parám1, parám2, etc.



10. Seleccione la fila de uno de los parámetros y haga clic en la columna Tipo de parámetro paraseleccionar un tipo.


12. Haga clic en Validar consulta para asegurarse de que la consulta es válida.

13. Haga clic en Siguiente para utilizar el asignador de datos para asignar los datos de proceso a losparámetros de la consulta.

DQL Write (Escribir DQL)Nota: Esta plantilla de actividad solo se admite en Documentum Process Builder versión 6.5 yversiones posteriores. Si se utiliza una versión anterior de Process Builder para un repositorio deDocumentum 6.5, no se abrirá esta plantilla.

Las actividades basadas en esta plantilla permiten ejecutar, crear, actualizar o eliminar consultas DQLde objetos en el repositorio especificado. Por ejemplo, puede utilizar la plantilla de actividad DQLWrite para definir una puntuación de crédito en un documento de préstamo del repositorio.

Para configurar una plantilla de actividad Escribir DQL:

1. En el Inspector de actividades, haga clic en la ficha Configuración de DQL.

2. Seleccione la opción Conectarse a un repositorio diferente si está accediendo a informacióndesde otro repositorio.

3. Escriba el Nombre del repositorio o selecciónelo en el cuadro de lista desplegable.






7. Escriba el Consulta que ejecutar en el cuadro de texto.

Para crear una consulta que utilice los valores del marcador de posición, escriba un signo deinterrogación (?) en donde desea que se sustituya el valor. El signo de interrogación representa unparámetro cuyo valor la actividad insertará en tiempo de ejecución.

8. Haga clic en el botón Configurar Tipo de parámetro para seleccionar un tipo de datos para elparámetro que especifique en la consulta DQL.

9. Haga clic en el botón Definir tipo de parámetros.

Aparecerá un cuadro de diálogo con una lista de parámetros que corresponden al número designos de interrogación de la consulta.

Los nombres de los parámetros son parám1, parám2, etc.

10. Seleccione la fila de uno de los parámetros.



11. Haga clic en la columna Tipo de parámetro para seleccionar un tipo.12. Haga clic en Aceptar.13. Haga clic en Validar consulta para asegurarse de que la consulta es válida.14. Haga clic en Siguiente para utilizar el asignador de datos para asignar los datos de proceso a los

parámetros de la consulta.

Database Read (Leer base de datos)Las actividades basadas en esta plantilla conectan con una base de datos externa y devuelven losresultados de una instrucción SQL Select. La actividad Database Read (Leer base de datos) tambiénadmite el intercambio de contenido desde el tipo de datos BLOB de Oracle y el tipo de datos Byte deMicrosoft SQL Server, a un paquete.

Nota: Los tipos de datos admitidos para los parámetros de la base de datos son: CHAR, VARCHAR,NVARCHAR_TYPE, BIGINT, INTEGER, SMALLINT, TINYINT, BIT, DOUBLE, FLOAT,NUMERIC, DECIMAL, REAL, DATE, TIME, TIMESTAMP, BOOLEAN, BINARY, BLOB,LONGVARBINARY, VARBINARY.

Para definir la actividad, debe identificar el controlador JDBC que se utilizará para conectar con labase de datos y especificar la instrucción Select que se ejecutará. La herramienta de asignación dedatos se utiliza para proporcionar los valores para las variables de sustitución de la instrucción Select ycopiar los resultados de la consulta en los atributos de paquete.

Para configurar una actividad de Database Read (Leer base de datos):

1. En el Inspector de actividades, haga clic en la ficha Configuración de la base de datos.2. En el cuadro de lista Controlador JDBC, seleccione el controlador JDBC que se utilizará.3. En el cuadro Cadena de conexión, escriba la cadena de conexión JDBC que se utilizará para

conectar con la base de datos.


4. Escriba el nombre de usuario y la contraseña que se utilizarán para conectar con la base de datos.5. Haga clic en Probar conexión para que Process Builder conecte con la base de datos.

• Si Process Builder puede conectar con la base de datos mediante la información que se haproporcionado en los pasos 2 a 4, aparecerá un mensaje en color verde bajo el cuadro Cadenade conexión.

• Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro. Modifique losvalores e inténtelo de nuevo.

6. Escriba la instrucción Select en el cuadro Consulta a ejecutar.

La instrucción debe comenzar por la palabra clave SQL Select. Para crear una consulta mediantelos parámetros cuyos valores provienen de los atributos de paquete o de las variables de flujosde trabajo en tiempo de ejecución, escriba un signo de interrogación (?) en donde desee que sesustituya el valor. El signo de interrogación representa un parámetro cuyo valor la actividadinsertará en tiempo de ejecución. Por ejemplo, una consulta que realiza una búsqueda de unregistro de cliente basada en un número de la seguridad social incluye un signo de interrogación enlugar de un valor específico del número de la seguridad social (SSN):

Select * from CUSTOMER where ssn=?



La instrucción Select puede incluir cualquier número de parámetros, cada uno de ellos representadopor un signo de interrogación. No entrecomille el signo de interrogación.

7. Para las consultas que incluyen parámetros de sustitución, identifique el tipo de datos para cadaparámetro.

Si la consulta no incluye parámetros, omita este paso.

a. Haga clic en el botón Definir tipo de parámetros. Aparecerá un cuadro de diálogo con unalista de parámetros que corresponden al número de signos de interrogación de la consulta. Losnombres de los parámetros son parám1, parám2, etc.

b. Resalte la fila de uno de los parámetros.

c. Haga clic en el valor de la columna Tipo de datos y seleccione el tipo de datos para elparámetro en el cuadro de lista. El tipo de datos del parámetro debe coincidir con el tipo dedatos de la columna de la base de datos correspondiente. Para una base de datos de Oracle,seleccione BLOB como el tipo de datos. Para Microsoft SQL, seleccione Binario como eltipo de datos del parámetro.


e. Haga clic en Aceptar para cerrar el cuadro de diálogo.

8. Haga clic en el botón Validar consulta.

Process Builder comprobará la validez de la consulta y mostrará un mensaje bajo el cuadro detexto que contiene la consulta.

Si la consulta no es válida, se obtendrá un mensaje de error de la base de datos. Corrija la consultapara que sea válida.


El botón Siguiente aparecerá como no disponible hasta que haya escrito valores para todos loscampos requeridos en la página actual.

10. Si la consulta tiene parámetros de sustitución, proporcione valores para los parámetros mediante laherramienta de asignación de datos.

En la pantalla Asignación de mensaje de entrada, la columna derecha de la herramienta deasignación de datos muestra los parámetros de sustitución de la consulta. La columna izquierdamuestra los atributos de paquete y las variables de sustitución de flujos de trabajo.

Si la consulta no incluye parámetros de sustitución, la pantalla Asignación de mensaje de entradano aparecerá. Continúe en el paso 12.

Introducción a la herramienta de asignación de datos, página 139 proporciona procedimientos parautilizar la herramienta de asignación de datos.


12. Utilice la herramienta de asignación de datos para guardar los resultados de la consulta comovalores de atributo de paquete.

En la pantalla Asignación de mensaje de salida, la columna izquierda de la herramienta deasignación de datos muestra los valores devueltos por la consulta. La columna de la derechamuestra los atributos de paquete. Si utiliza el tipo de datos BLOB, deberá asignar el contenido deBLOB como un atributo de datos del paquete.

Si la consulta devuelve más de una fila de datos, la actividad asigna los valores de la primera filadevuelta a los atributos de paquete asociados.




Database Stored Procedure (Procedimientoalmacenado en base de datos)Las actividades basadas en esta plantilla se conectan a una base de datos externa y ejecutan unprocedimiento almacenado o función. Para definir la actividad, debe identificar el controlador JDBCque se utilizará para conectar con la base de datos y especificar el procedimiento almacenado o lafunción que se ejecutarán. La herramienta de asignación de datos se utiliza para proporcionar valorespara los parámetros IN e IN/OUT del procedimiento almacenado. La actividad devuelve los valorespara los parámetros OUT e IN/OUT o el conjunto de resultados del procedimiento almacenado,o bien, el valor de devolución de una función.

Nota: Los tipos de datos admitidos para los parámetros IN, OUT e IN/OUT son: CHAR, VARCHAR,NVARCHAR_TYPE, BIGINT, INTEGER, SMALLINT, TINYINT, BIT, DOUBLE, FLOAT,NUMERIC, DECIMAL, REAL, DATE, TIME, TIMESTAMP, BOOLEAN, BINARY, BLOB,LONGVARBINARY, VARBINARY.

Para configurar una actividad Database Stored Procedure (Procedimiento almacenado en basede datos):

1. En el Inspector de actividades, haga clic en la ficha Configuración de la base de datos.







6. Escriba el nombre de la función o del procedimiento almacenado en el cuadro reservado para dichainformación. Opcionalmente, puede escribir el nombre descriptivo del procedimiento almacenadocon uno de los formatos siguientes:

<nombre-catálogo>.<nombre-esquema>.<nombre-procedimiento> o<nombre-esquema>.<nombre-procedimiento> o <nombre-procedimiento> Continúe en el paso 8.

Nota: Los nombres de catálogo, esquema y procedimiento o función distinguen entre mayúsculasy minúsculas.

7. Si no sabe el nombre del procedimiento almacenado o de la función, puede utilizar las siguientesinstrucciones para buscarlo:

a. Haga clic en Buscar para buscar un procedimiento o una función. Aparecerá la ventana Buscar.

b. En el cuadro Introduzca el patrón de búsqueda, escriba el nombre del procedimientoalmacenado o de la función. Este nombre distingue entre mayúsculas y minúsculas, y puede ser



descriptivo. También puede utilizar el comodín% para buscar un procedimiento almacenadoo una función. Si necesita más información sobre el uso del comodín%, haga clic en ¿Quées esto?.

c. Haga clic en Buscar.Process Builder busca el procedimiento almacenado o la función en todos losesquemas y paquetes de la base de datos y recupera el nombre descriptivo delprocedimiento o la función. Por ejemplo, si escribe el nombre del procedimientoCALCULAR_IMPUESTO en el cuadro de búsqueda, Process Builder recuperará elnombre del catálogo y el esquema junto con el nombre del procedimiento almacenadocomo, por ejemplo, STANDARD.SYS.CALCULAR_IMPUESTO.

Consulte Patrones de búsqueda de ejemplo, página 196 si necesita más información sobreel uso de diferentes patrones de búsqueda.

d. Seleccione el procedimiento almacenado o la función en el cuadro de lista.

Una vez que lo haya seleccionado, se mostrará información adicional como, por ejemplo, losparámetros de entrada y el valor de devolución, bajo el cuadro de lista.

e. Haga clic en Aceptar para volver a la ficha Configuración de la base de datos.El procedimiento almacenado o la función se muestran en el cuadro que se ofrece.


9. Si el procedimiento almacenado o la función aceptan parámetros de entrada, proporcione valorespara los parámetros mediante la herramienta de asignación de datos.

En la pantalla Asignación de mensaje de entrada, la columna izquierda muestra los atributos depaquete y las variables de sustitución del flujo de trabajo. La columna derecha de la herramientade asignación de datos muestra todos los parámetros IN e IN/OUT del procedimiento almacenadoo los argumentos de la función. Si existe más de un parámetro de entrada, y sólo asigna unparámetro, los otros se establecerán en NULL o como se haya definido en el procedimientoalmacenado o la función. Introducción a la herramienta de asignación de datos, página 139proporciona procedimientos para utilizar la herramienta de asignación de datos.

Si el procedimiento almacenado o la función no incluyen parámetros de entrada o argumentos, lapantalla Asignación de mensaje de entrada no aparecerá. Continúe en el paso 11.


11. Utilice la herramienta de asignación de datos para guardar el valor de devolución de la función oel procedimiento como atributos de paquete.

En la pantalla Asignación de mensaje de salida, la columna izquierda de la herramienta deasignación de datos muestra los valores de los parámetros OUT e IN/OUT o el resultado devueltopor el procedimiento almacenado, o bien, el valor de devolución de la función. La columna de laderecha muestra los atributos de paquete. Introducción a la herramienta de asignación de datos,página 139 proporciona procedimientos para utilizar la herramienta de asignación de datos.


Patrones de búsqueda de ejemplo

Puede utilizar los siguientes patrones de búsqueda en el cuadro Introduzca el patrón de búsqueda.

Nota: Los patrones de búsqueda distinguen entre mayúsculas y minúsculas.



• Nombre del procedimiento almacenado o la función: solo busca las ocurrencias de la función o elprocedimiento almacenado que se hayan escrito con el siguiente formato:<nombre de procedimiento>Por ejemplo, si busca el nombre de procedimiento almacenado ADD_EMPLOYEE, BusinessProcess Services recupera el procedimiento almacenado ADD_EMPLOYEE junto con el nombrede catálogo y esquema, tal como STANDARD.SYS.ADD_EMPLOYEE. Si busca ADD_,Business Process Services recupera todos los procedimientos almacenados o funciones cuyo nombrecomience por ADD_.

• Nombre descriptivo: solo busca las ocurrencias de los procedimientos almacenados o las funcionesque haya escrito con un nombre descriptivo usando uno de los siguientes formatos:<nombre-catálogo>.<nombre-esquema>.<nombre de procedimiento>o <nombre de esquema>.<nombre de procedimiento>Por ejemplo, si busca el procedimiento almacenado ORDSOURCE.ORDSYS.WRITE, BusinessProcess Services recupera el procedimiento almacenadoWRITE en el esquema ORDSYS delcatálogo ORDSOURCE. No se recuperarán los procedimientos almacenadosWRITE que seencuentren disponibles en otros catálogos o esquemas.Si busca SCOTT.ADD_EMPLOYEE, Business Process Services recupera el procedimientoalmacenado ADD_EMPLOYEE del esquema SCOTT.

• El carácter comodín %: busca los procedimientos almacenados o las funciones en todos loscatálogos y esquemas de la base de datos usando los patrones de búsqueda siguientes.

– % o en blanco: se recuperarán todos los procedimientos almacenados o las funciones de labase de datos.

– B%: se recuperarán todos los procedimientos almacenados cuyo nombre comience por "B".– A.%: se recuperarán todos los procedimientos almacenados del esquema cuyo nombre sea "A".– A.B%: se recuperarán todos los procedimientos almacenados cuyo nombre empiece por "B" enel esquema con nombre "A".

– C.A.B%: se recuperarán todos los procedimientos almacenados cuyo nombre empiece por "B"en el esquema con nombre "A" del catálogo "C".

– A%.B%: se recuperarán todos los procedimientos almacenados cuyo nombre empiece por "B"en cualquier esquema cuyo nombre comience por "A".

Database Write (Escribir base de datos)Las actividades basadas en esta plantilla conectan con una base de datos externa y ejecutan unainstrucción SQL Insert, Update o Delete. La actividad Database Write (Escribir base de datos) tambiénadmite el intercambio de contenido desde un paquete a los parámetros de bases de datos. Es decir, sepueden insertar o actualizar los datos binarios o BLOB desde un paquete a la base de datos.

Nota: Los tipos de datos admitidos para los parámetros de la base de datos son: CHAR, VARCHAR,NVARCHAR_TYPE, BIGINT, INTEGER, SMALLINT, TINYINT, BIT, DOUBLE, FLOAT,NUMERIC, DECIMAL, REAL, DATE, TIME, TIMESTAMP, BOOLEAN, BINARY, BLOB,LONGVARBINARY, VARBINARY.

Para definir la actividad, debe identificar el controlador JDBC que se utilizará para conectar con labase de datos y especificar la instrucción que se ejecutará. Utilice la herramienta de asignación dedatos para proporcionar valores para las variables de sustitución de la instrucción SQL. La actividaddevuelve el número de filas creadas o actualizadas.



Para configurar una actividad de Database Write (Escribir base de datos):

1. En el Inspector de actividades, haga clic en la ficha Configuración de la base de datos.







6. Escriba la instrucción SQL Insert, Update o Delete en el cuadro Consulta a ejecutar.

La instrucción deberá comenzar por una de las palabras clave SQL Insert, Update o Delete. Paracrear una instrucción SQL mediante los parámetros cuyos valores provienen de los atributosde paquete o de las variables de flujos de trabajo en tiempo de ejecución, escriba un signo deinterrogación (?) en donde desee que se sustituya el valor. El signo de interrogación representa unparámetro cuyo valor la actividad insertará en tiempo de ejecución. Por ejemplo, una instrucciónque actualiza el apellido de un cliente según un número de la seguridad social incluye un signo deinterrogación en lugar de un valor específico del número de la seguridad social (SSN):

Update CUSTOMER Set Lastname=’Smith’ where ssn=?

La instrucción SQL puede incluir cualquier número de parámetros, cada uno de ellos representadopor un signo de interrogación. No entrecomille el signo de interrogación.

7. Para las instrucciones SQL que incluyen parámetros de sustitución, identifique el tipo de datospara cada parámetro. Si la instrucción no incluye parámetros, omita este paso.

a. Haga clic en Definir tipo de parámetros. Aparecerá un cuadro de diálogo con una listade parámetros que corresponden al número de signos de interrogación de la consulta. Losnombres de los parámetros son parám1, parám2, etc.

b. Resalte la fila de uno de los parámetros

c. Haga clic en el valor de la columna Tipo de datos y seleccione el tipo de datos para elparámetro en el cuadro de lista. El tipo de datos del parámetro debe coincidir con el tipo dedatos de la columna de la base de datos correspondiente. Para una base de datos de Oracle,seleccione BLOB como el tipo de datos. Para Microsoft SQL, seleccione Binario como eltipo de datos del parámetro.


e. Haga clic en Aceptar para cerrar el cuadro de diálogo


El botón Siguiente aparecerá como no disponible hasta que haya introducido valores para todoslos campos requeridos en la página actual.

9. Si la instrucción SQL tiene parámetros de sustitución, proporcione valores para los parámetrosmediante la herramienta de asignación de datos.



En la pantalla Asignación de mensaje de entrada, la columna derecha de la herramienta deasignación de datos muestra los parámetros de sustitución de la instrucción SQL. La columnaizquierda muestra los atributos de paquete y las variables de sustitución de flujos de trabajo. Siutiliza el tipo de datos BLOB, deberá asignar el contenido de BLOB como un atributo de datosdel paquete.

Si la instrucción SQL no incluye parámetros de sustitución, la pantalla Asignación de mensaje deentrada no aparecerá. Continúe en el paso 11.

10. Haga clic en Siguiente.11. Utilice la herramienta de asignación de datos para guardar el número de filas devueltas como un

valor de atributo de paquete.

En la pantalla Asignación de mensaje de salida, la columna izquierda de la herramienta deasignación de datos muestra los valores únicos devueltos por la instrucción SQL: el número defilas insertadas o actualizadas. La columna de la derecha muestra los atributos de paquete.



Dynamic Web Service (Servicio Web dinámico)Las actividades basadas en esta plantilla ejecutan una operación de servicio Web. A diferencia de laplantilla Servicio Web, esta plantilla de actividad permite asignar datos de forma interactiva entre losatributos de los procesos comerciales y los parámetros de los servicios Web. Esta plantilla de actividadadmite servicios Web seguros y no seguros.

Las operaciones que se relacionan en el WSDL no aparecen en esta actividad en las siguientescondiciones:

• Operaciones definidas en el enlace que no son compatibles con SOAP 1.1 o SOAP 1.2.• Operaciones definidas en el WSDL en las que el atributo de nombre de las etiquetas de mensajede entrada y salida del enlace (/enlace/operación/entrada y /enlace/operación/salida) y puerto(/Tipopuerto/operación/entrada y /Tipopuerto/operación/salida) no coinciden.

Nota: Consulte Agregar un esquema XML al contenido de la actividad, página 143 para obtenerdetalles sobre la asignación de valores, incluido xsd:anySimpleType.

Abrir servicios Web no segurosEn esta sección se describe la forma de configurar una actividad de servicio Web no seguro.

Para abrir una actividad de Dynamic Web Service (Servicio Web dinámico) no seguro:

1. En el Inspector de actividades, haga clic en la ficha Configuración del servicio Web.2. En el cuadro Dirección URL del archivo WSDL, escriba el nombre completo de la URL al

archivo WSDL que contiene la operación que desea ejecutar.3. Haga clic en Leer archivo WSDL.

Process Builder leerá el archivo WSDL especificado y rellenará los demás campos de la pantalla.4. Seleccione uno de los tipos de puertos disponibles en el archivo WSDL especificado.



El cuadro de lista Tipo de puerto estará vacío hasta que haga clic en Leer archivo WSDL.

5. Seleccione una de las operaciones disponibles en el archivo WSDL especificado.


El botón Siguiente aparecerá como no disponible hasta que haya seleccionado una operación deun archivo WSDL válido. También aparecerá como no disponible si aún no ha especificado lospaquetes para el proceso comercial, o si la operación del servicio Web seleccionada no tieneparámetros de entrada o valores de devolución.

7. Si la operación del servicio Web seleccionada tiene parámetros de entrada, proporcione valorespara los parámetros mediante la herramienta de asignación de datos.

En la pantalla Asignación de mensaje de entrada, la columna derecha de la herramienta deasignación de datos muestra los parámetros de entrada para la operación. La columna izquierdamuestra los datos de proceso y las variables de sustitución de flujos de trabajo. Introducción ala herramienta de asignación de datos, página 139 proporciona procedimientos para utilizar laherramienta de asignación de datos.

Si la operación de servicio Web seleccionada no tiene parámetros de entrada, la pantallaAsignación de mensaje de entrada no aparecerá. Continúe en el paso 9.


Si la operación del servicio Web seleccionada no tiene valores de salida, el botón Siguienteaparecerá como no disponible. Omita el paso siguiente.


En la pantalla Asignación de mensaje de salida, la columna izquierda de la herramienta deasignación de datos muestra los valores de salida para la operación. La columna de la derechamuestra los atributos de paquete. Introducción a la herramienta de asignación de datos, página 139proporciona procedimientos para utilizar la herramienta de asignación de datos.


Invocar servicios Web seguros

Las actividades basadas en esta plantilla admiten tres tipos de seguridad. Son los siguientes:

• Compatibilidad de proxy HTTP

• Autenticación básica de HTTP

• Autenticación basada en encabezado SOAP

Antes de configurar un servicio Web seguro, puede configurar el servidor proxy HTTP. ConsulteConfigurar el servidor proxy HTTP, página 203 para configurar un servidor proxy HTTP.

En los procedimientos siguientes se describe la forma de configurar servicios Web protegidos porautenticación básica de HTTP y por autenticación basada en encabezado SOAP.

Para configurar una actividad de servicio Web seguro, haga clic en la ficha Configuración del servicioWeb del Inspector de actividades.



Invocar un servicio Web protegido por autenticación de HTTP

Si el servicio Web que se invoca está protegido mediante Autenticación básica de HTTP, sigaestos pasos:

1. En el cuadro Dirección URL del archivo WSDL, escriba el nombre completo de la URL alarchivo WSDL que contiene la operación que desea ejecutar.

2. Haga clic en Leer archivo WSDL.

Process Builder leerá el archivo WSDL especificado y rellenará los demás campos de la pantalla.

3. Seleccione uno de los tipos de puertos disponibles en el archivo WSDL especificado.



5. Seleccione Utilizar autenticación básica de HTTP.

6. En el cuadro Nombre de usuario, escriba el nombre de usuario.

7. En el cuadro Contraseña, escriba la contraseña para el usuario especificado.

8. Continúe con Asignar parámetros de servicio Web, página 202.

Invocar un servicio Web protegido por autenticación de encabezadoSOAP

Si el servicio Web que desea invocar está protegido por autenticación basada en encabezadoSOAP:

1. En el cuadro Dirección URL del archivo WSDL, escriba el nombre completo de la URL alarchivo WSDL que contiene la operación que desea ejecutar.

Por ejemplo, si utiliza Documentum Web Services Framework (WSF), puede usar la siguientedirección URL del servicio de credenciales del repositorio:

http://localhost:8080/ws/services/DocbaseCredentials?wsdl

donde:

• localhost:8080: dirección del host del servidor de aplicaciones

• ws/services: nombre del directorio del servidor de aplicaciones donde está instalado WebServices Framework (WSF)

2. Haga clic en Leer archivo WSDL.

Process Builder leerá el archivo WSDL especificado y rellenará los demás campos de la pantalla.

3. Seleccione uno de los tipos de puertos disponibles en el archivo WSDL especificado.



Nota: Consulte la guía Documentum Web Services Framework Development Guide si necesitamás información sobre los tipos y las operaciones del servicio de credenciales.

5. Para servicios Web con seguridad SOAP se generará un token de seguridad.

6. Continúe con Asignar parámetros de servicio Web, página 202 para asignar la informaciónde autenticación basada en SOAP.



Invocar un servicio Web protegido por Capa de sockets seguros(SSL)

Puesto que el servicio Web es seguro, debe disponer de un certificado SSL en su entorno. Consulteel manual Process Integrator Deployment Guide para obtener instrucciones sobre cómo importarcertificados SSL para dar soporte a conexiones cifradas de las plantillas de actividad.

Asignar parámetros de servicio Web

Realice los pasos siguientes para asignar los valores de entrada y salida del servicio Web. No obstante,antes de empezar, debe completar los pasos iniciales para configurar el servicio Web dinámico, tal ycomo se describe en Invocar servicios Web seguros, página 200.

Para asignar los parámetros del servicio Web:


El botón Siguiente aparecerá como no disponible hasta que haya seleccionado una operación deun archivo WSDL válido. También aparecerá como no disponible si aún no ha especificado lospaquetes para el proceso comercial, o si la operación del servicio Web seleccionada no tieneparámetros de entrada o valores de devolución.

2. Si la operación del servicio Web seleccionada tiene parámetros de entrada, proporcione valorespara los parámetros mediante la herramienta de asignación de datos.

En la pantalla Asignación de mensaje de entrada, la columna derecha de la herramienta deasignación de datos muestra los parámetros de entrada para la operación. La columna izquierdamuestra los atributos de paquete y las variables de sustitución de flujos de trabajo.


Si el servicio Web está protegido por autenticación basada en encabezado SOAP, debe asignar eltoken de seguridad y los parámetros seguros de SOAP. Si utiliza el servicio de credenciales basadoen Documentum WSF, debe asignar los valores de los parámetros según el tipo y las operacionesdel servicio de credenciales.

Nota: Si necesita más información sobre los tipos y las operaciones del servicio de credenciales,consulte la guía Documentum Web Services Framework Development Guide.

Si la operación de servicio Web seleccionada no tiene parámetros de entrada, la pantallaAsignación de mensaje de entrada no aparecerá. Continúe en el paso 3.


Si la operación del servicio Web seleccionada no tiene valores de salida, el botón Siguienteaparecerá como no disponible. Omita el paso siguiente.


En la pantalla Asignación de mensaje de salida, la columna izquierda de la herramienta deasignación de datos muestra los valores de salida para la operación. La columna de la derechamuestra los atributos de paquete.





Configurar el servidor proxy HTTP

Si utiliza un servidor proxy HTTP para acceder a un servicio Web ubicado fuera del servidor deseguridad, debe configurar los parámetros del proxy HTTP. Para ello, debe modificar el acceso directode Process Builder y el parámetro de inicio del servidor Java Method Server de Content Server.En las secciones siguientes se describe la forma de configurar los parámetros de inicio en sistemasbasados en Windows y UNIX.

Configurar parámetros del proxy HTTP en Windows

En esta sección se describe cómo configurar los parámetros de inicio del proxy HTTP en sistemasWindows para el acceso directo de Process Builder y para Content Server Java Method Server.1. En primer lugar, configure el acceso directo de Process Builder siguiendo estos pasos:

a. Haga clic con el botón secundario del ratón en el acceso directo de Process Builder delescritorio y seleccione Propiedades.

Nota: Si no dispone de un acceso directo a Process Builder en el escritorio, seleccione Inicio >Programas > Documentum, haga clic con el botón secundario del ratón en Process Buildery, a continuación, seleccione Propiedades.

b. En el cuadro Destino, modifique la ruta javaw.exe del siguiente modo:

• Autenticación básica de HTTP

"C:\Program Files\Documentum\java\1.5.0_12\jre\bin\javaw.exe-Dhttp.proxyHost=localhost -Dhttp.proxyPort=<port-number>-Dhttp.nonProxyHosts"

donde:

– http.proxyHost: nombre de host del servidor proxy.– http.proxyPort: número de puerto, siendo 80 el valor predeterminado.– http.nonProxyHosts: lista de host a los que se puede acceder directamente, pasandopor alto el servidor proxy. Se trata de una lista de expresiones regulares separadas por’|’. Se podrá acceder a través de una conexión directa, en lugar de mediante un proxy, aaquellos host que coincidan con estas expresiones regulares.

• HTTP sobre SSL:

"C:\Program Files\Documentum\java\1.5.0_12\jre\bin\javaw.exe-Dhttps.proxyHost=localhost -Dhttps.proxyPort=<port-number>-Dhttps.nonProxyHosts"

donde:

– https.proxyHost: nombre de host del servidor proxy.– https.proxyPort: número de puerto, siendo 443 el valor predeterminado.– https.nonProxyHosts: lista de host a los que se puede acceder directamente, pasandopor alto el servidor proxy. Se trata de una lista de expresiones regulares separadas por’|’. Se podrá acceder a través de una conexión directa, en lugar de mediante un proxy, aaquellos host que coincidan con estas expresiones regulares.

2. A continuación, configure los parámetros de inicio de Java Method Server siguiendo estos pasos:



a. Abra el archivo StartMethodServer.cmd en $DOCUMENTUM.b. Agregue los parámetros de proxy HTTP para la autenticación básica o HTTP sobre SSL

a JAVA_OPTIONS.Por ejemplo, agregue las siguientes líneas para admitir la autenticación básica de HTTP:-Dhttp.proxyHost=<host_proxy>-Dhttp.proxyPort=<número_puerto>dondehost_proxy es el nombre de host del servidor proxy.número_puerto es el número de puerto. El número predeterminado es 80.

Configurar parámetros del proxy HTTP en sistemas basados en UNIX

En esta sección se describe la forma de configurar el parámetro de inicio del servidor Java MethodServer de Content Server en sistemas basados en UNIX.

Para configurar los parámetros de inicio de Java Method Server:

1. Abra el archivo StartMethodServer.cmd en $DOCUMENTUM.2. Agregue los parámetros de proxy HTTP para la autenticación básica o HTTP sobre SSL a

JAVA_OPTIONS.

Por ejemplo, agregue las siguientes líneas para admitir la autenticación básica de HTTP:

-Dhttp.proxyHost=<host_proxy>-Dhttp.proxyPort=<número_puerto>

dondehost_proxy es el nombre de host del servidor proxy.número_puerto es el número de puerto. El número predeterminado es 80.

Abrir los servicios DFS (Documentum Foundation Services) desdeProcess Builder

Los servicios DFS se pueden abrir de dos maneras siguientes desde Process Builder.

• Como un servicio único, lo que significa que un proceso contiene una plantilla de actividad DynamicWeb Service (Servicio Web dinámico) que realiza una invocación única de un servicio Web DFS.

• Como un servicio encadenado, lo que significa que un proceso contiene varias plantillas de actividadDynamic Web Service (Servicio Web dinámico) que invocan los servicios Web DFS. La informaciónde identidad del repositorio se registra en un token que utilizan las plantilla de actividad.

Nota: La plantilla de actividad Dynamic Web Service (Servicio Web dinámico) solo admite base64y MTOM para las transferencias de contenido.

Registrar el repositorio para los servicios encadenados

Para registrar la identidad del repositorio (para los servicios encadenados):

1. Utilice el ContextRegistryService proporcionado por DFS para registrar el repositorio.

Para obtener más información sobre ContextRegistryService, consulte la guía DocumentumFoundation Services Development Guide.

2. En la ficha Configuración del servicio Web de la plantilla de actividad Dynamic Web Service,escriba la ruta de acceso completa de la dirección URL al WSDL.Por ejemplo,



http://yourserver:port/services/core/runtime/ContextRegistryService?wsdl

Nota: El WSDL también puede existir como un archivo local.3. Haga clic en Leer archivo WSDL.4. Seleccione ContextRegistryServicePort como Tipo de puerto.5. Seleccione register (registrar) como Operación.6. Haga clic en Siguiente.7. En la página Asignación de mensaje de entrada, cree las asignaciones siguientes:

• Asigne RepositoryName a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@repositoryName

• Asigne Username a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@userName

• Asigne Password a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@password

• Asigne Domain a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@domain

Nota: RepositoryIdentityes un nodo de repetición. Se pueden registrar varias identidades a untoken único.

8. Haga clic en Siguiente.9. En la página Asignación de mensaje de salida, el token generado está disponible en

SOAPEnvelope/SOAPBody/parameters/registerResponse/return

Eliminar del Registro la identidad del repositorio para los serviciosencadenados

Para eliminar del Registro la identidad del repositorio (para los servicios encadenados):

1. Utilice el ContextRegistryService proporcionado por DFS para registrar el repositorio.

Para obtener más información sobre ContextRegistryService, consulte la guía DocumentumFoundation Services Development Guide.

2. En la ficha Configuración del servicio Web de la plantilla de actividad Dynamic Web Service,escriba la ruta de acceso completa de la dirección URL al WSDL.Por ejemplo,http://yourserver:port/services/core/runtime/ContextRegistryService?wsdl

Nota: El WSDL también puede existir como un archivo local.3. Haga clic en Leer archivo WSDL.4. Seleccione ContextRegistryServicePort como Tipo de puerto.5. Seleccione unregister (eliminar del Registro) como Operación.




7. En la página Asignación de mensaje de entrada, agregue el token que se desea eliminar delRegistro a SOAPEnvelope/SOAPBody/params/unregister/token.

Abrir servicios DFS típicos (únicos o encadenados)

Para invocar un servicio DFS típico (único o encadenado), siga estos pasos:

1. Abra el Inspector de actividades para la plantilla de actividad Dynamic Web Service (ServicioWeb dinámico).

2. Seleccione la ficha Configuración del servicio Web.

3. Escriba la dirección URL completa para el WSDL para el servicio DFS concreto.

4. Seleccione el Tipo de puerto y Operación en función de los valores disponibles del archivoWSDL.


6. En la página Asignación de mensaje de entrada, agregue las asignaciones de datos siguientespara autenticar cualquiera de los servicios DFS.

Utilice la función de concatenación para construir la cadena para la asignación.Nota: Las asignaciones siguientes sólo sirven para autenticar los servicios DFS. La guíaDocumentum Foundation Services Development Guide proporciona información detallada sobre lafuncionalidad DFS.

En un servicio encadenado, asigne lo siguiente:

<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><wsse:BinarySecurityTokenQualificationValueType="http://schemas.emc.com/documentum#ResourceAccessToken" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"wsu:Id="RAD">someToken</wsse:BinarySecurityToken></wsse:Security>

a SOAPHeader

(SOAPEnvelope/SOAPHeader/SOAPHeaderElement[0])

Para un servicio único, asigne lo siguiente:

<ServiceContextxmlns="http://context.core.datamodel.fs.documentum.emc.com/"xmlns:ns2="http://properties.core.datamodel.fs.documentum.emc.com/"xmlns:ns3="http://profiles.core.datamodel.fs.documentum.emc.com/"><Identities xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"repositoryName="docbaseName" password="docbasePassword"userName="docbaseUsername"xsi:type="RepositoryIdentity"/></ServiceContext>

a SOAPHeader

(SOAPEnvelope/SOAPHeader/SOAPHeaderElement[0])

Nota: Utilice varias <Identities/> cuando se utilice más de un repositorio para la autenticación.



Email Inbound: inicio y procedimiento

Las plantillas de actividad de correo electrónico sondean a los servidores de correo electrónico para losmensajes entrantes y, a continuación, los procesan según la lógica empresarial que ha especificado.Dentro de la plantilla de actividad de Correo electrónico entrante, defina la conexión al servidor decorreo electrónico, seleccione las opciones para el procesamiento del mensaje una vez leído y asignelos datos del mensaje entrante a los datos de proceso que se utilizan en el proceso.

Por ejemplo, en un proceso comercial de reclamación de un cliente, puede configurar una plantilla decorreo electrónico entrante como la actividad de inicio del proceso. La actividad registra el servidor decorreo electrónico e inicia un nuevo flujo de trabajo cuando recibe un mensaje de correo electrónico conla reclamación de un cliente. En los siguientes pasos del proceso, el sistema enruta el correo electrónicoa través de una actividad manual a una persona que revisa la reclamación y resuelve el problema.

Nota: El cliente de correo electrónico debe tener la codificación establecida en UTF-8 al enviar yleer mensajes que utilizan caracteres multibyte.

1. En el campo Tipo de servidor de correo electrónico, seleccione el protocolo para conectarse alservidor de correo electrónico.

Los valores válidos son POP3S y IMAP.

2. En el campo Nombre de host, escriba el nombre o la dirección IP del servidor de correoelectrónico.

3. Escriba el Número de puerto donde el servidor de correo electrónico escucha las solicitudes deprotocolo.

Los valores predeterminados se establecen en función del protocolo seleccionado.

4. Seleccione el valor opcional para Utilizar cifrado.

El valor predeterminado es Ninguno.

Nota: Si utiliza el cifrado SSL o TLS, debe disponer de un certificado SSL en su entorno. Consulteel manual Process Integrator Deployment Guide para obtener instrucciones sobre cómo importarcertificados SSL para dar soporte a conexiones cifradas de las plantillas de actividad.

5. Escriba el Nombre de usuario y la Contraseña para el servidor de correo electrónico.


Si la conexión es incorrecta, se muestra un mensaje debajo del cuadro de texto. Modifique losvalores e inténtelo de nuevo.

7. Escriba el Nombre de la carpeta del correo electrónico donde se procesan los mensajes (porejemplo Bandeja de entrada).

También puede hacer clic en Obtener lista de carpetas... para ver una lista de las carpetas decorreo electrónico disponibles en el servidor de correo electrónico y seleccionar una.

8. Sólo para las actividades intermedias, puede introducir el nombre de un encabezado de mensaje decorreo electrónico que incluya un ID de correlación en el Nombre de encabezado de correlación.

Un ID de correlación es una cadena única asociada con cada instancia de proceso y se puede usarpara identificar un flujo de trabajo y hacer coincidir el mensaje con él.



Nota: Si el sistema no puede utilizar la información de este campo para hacer coincidir el mensajecon el flujo de trabajo, utiliza las asignaciones que se crean en el Paso 15 para hacer coincidir larespuesta con el mensaje de solicitud.

9. Seleccione o escriba el tipo MIME preferido para el mensaje.

Seleccione o escriba el tipo MIME de la parte del cuerpo del correo electrónico de mensajesmultiparte/alternativos y cuerpos de correo electrónico multiparte/alternativo.

10. En el cuadro de lista Opción de posprocesamiento, seleccione una opción para gestionar elmensaje una vez procesado.

Estas opciones dependen del tipo de servidor de correo electrónico seleccionado.Para los servidores de correo electrónico POP3, la única opción de posprocesamiento válidaes Eliminar mensaje de correo electrónico.Las opciones válidas para los servidores IMAP son: Marcar mensaje de correo electrónicocomo leído, Eliminar mensaje de correo electrónico oMover mensaje de correo electrónico ala carpeta para archivar.

11. Si ha seleccionado mover el mensaje a una carpeta para archivar en el campo anterior, escribael Nombre de carpeta para archivar o haga clic en Obtener lista de carpetas... para ir a lacarpeta para archivar.

12. En el campo Frecuencia de sondeo de oyente (en segundos), escriba el número de segundos quepasarán hasta que el oyente busque nuevos mensajes.

13. Escriba el número de sesiones de correo electrónico disponible para procesar los mensajes decorreo electrónico.

14. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, donde puede asignarlos datos del mensaje a los datos del proceso.

Las plantillas de actividad de correo electrónico entrante tienen nodos adicionales específicos paralos encabezados de correo electrónico que le permiten crear asignaciones que recuperen valores delos encabezados de correo electrónico:

Tabla 16 Atributos adicionales para las actividades de correo electrónico entrante

Nombre deatributo

Nombre delencabezado de correoelectrónico

Finalidad Acción

Fecha derecepción

La fecha en la que elsistema recibió el mensajede correo electrónico.

Recuperación

Importancia X-Priority,Importancia, Priority,X-MSMail-Priority

Estado establecido porel remitente que indicala importancia relativadel mensaje. Los valoresválidos son: (1) Alta, (3)Normal y (5) Baja. Sino se asigna este valor,el sistema utiliza el valorpredeterminado de 3, quees Normal.

Recuperación



Nombre deatributo


Finalidad Acción

Palabras clave Palabras clave Palabras o frases que sepueden utilizar cuandose busca u ordena correoelectrónico.

Recuperación

Fecha deexpiración

Fecha de expiración Fecha en que el correoelectrónico deja de serválido.

Recuperación

Confidencialidad Confidencialidad Informa al destinatario dela naturaleza del correoelectrónico y del riesgode divulgar el contenidoa personas distintasde los destinatariosespecificados.

Los valores válidos son:Personal, Private oCompany-Confidential.

Recuperación

Si no se asignan valores a estos atributos, no se recuperan del mensaje entrante.

La plantilla de actividad también permite agregar atributos al nodo Encabezados adicionalesdel mensaje de correo electrónico.





15. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, donde puede especificarreglas que hagan coincidir los atributos del conjunto de correlación con los atributos del mensaje.

16. Seleccione el Conjunto de correlaciones que está asignando en la lista de la parte superior dela página.

17. Introducción a la correlación de mensajes, página 155 proporciona más información acerca decómo utilizar los conjuntos de correlaciones para hacer coincidir los mensajes de los orígenesexternos con los datos de proceso. Crear los conjuntos de correlación, página 72 proporciona másinformación acerca de cómo definir los conjuntos de correlaciones para un proceso.

Establecer tipos de objetos personalizados para los anexosPuede configurar un tipo de objeto personalizado para los anexos de las plantillas de actividad Correoelectrónico entrante en lugar de usar el valor predeterminado de dm_document. En el asignador



de datos, establezca el atributo ObjectType en el nodo Anexos de los datos de proceso en un tipoválido para el repositorio.

FTP entrante: inicio y procedimientoLas plantillas de actividad de FTP supervisan los archivos y carpetas que se transfieren a las carpetasbase designadas. Por ejemplo, en un flujo de trabajo que procesa los pedidos de compra entrantes,puede utilizar esta plantilla de actividad para supervisar la carpeta base para los pedidos de compraentrantes que sean archivos XML. Según la asignación, el sistema inicia a continuación un procesopara cada archivo coincidente basado en el tipo de pedido que ha configurado en el esquema XML.

Desde la plantilla de actividad, puede configurar la información del servidor FTP, comprobar laconectividad y designar opciones de posprocesamiento como eliminar o archivar los archivos ocarpetas procesadas. Puede utilizar la herramienta de asignación de datos para procesar los archivoscomo datos o como documentos XML, al proporcionar un esquema XML.

Para configurar la plantilla de actividad entrante del FTP:1. Seleccione un Protocolo para la conexión.

Los protocolos estándar compatibles son FTP, SFTP (SSH FTP), FTPS (FTP sobre SSL) yArchivo local.

Nota: Si selecciona Archivo local, omita el paso 5.2. Escriba el nombre de host o la dirección IP del servidor FTP.3. Escriba el número de puerto que está utilizando para la conexión.

• El puerto predeterminado para FTP y FTPS es 21.• El puerto predeterminado para SFTP es 22.

4. Escriba el nombre de usuario y la contraseña para el servidor FTP al que está conectando, siel servidor requiere autenticación.

Nota: El usuario debe tener los privilegios suficientes para realizar la operación deposprocesamiento obligatoria configurada en el paso 11.

5. Para utilizar la autenticación de clave pública, seleccione SFTP en el cuadro de lista desplegable yseleccione la casilla de verificación Utilizar autenticación de clave pública.a. Haga clic en Importar clave privada para iniciar el cuadro de diálogo Elegir clave privada y

desplácese hasta la ubicación del archivo de clave privada.b. Seleccione el archivo de clave privada y haga clic en Aceptar.

El sistema carga el archivo de clave privada, y el contenido se cifra en Base64 y seescribe en la definición de servicio.

c. Escriba la clave frase de contraseña privada si la clave privada se creó con la clave frasehabilitada.

6. En el campo Carpetas base, escriba la ruta de acceso a las carpetas en el servidor FTP que sesupervisará.

7. En el campo Tipo de mensaje, seleccione la opción para las descargas de archivos.

Las opciones válidas son:

• Archivo comprimido, que permite al sistema supervisar varios archivos dentro de una ubicaciónde archivado.



• Directorio, que permite al sistema supervisar varios archivos dentro de una carpeta.• Archivo, que permite al sistema supervisar un archivo.

8. Haga clic en el botón Validar para comprobar que se han escrito los parámetros de conexión y laruta de la carpeta base correctamente.

9. En el campo Patrón de nombre de archivo/directorio incluido, escriba las variables para losnombres de tipos de archivo y directorios que desea incluir en la supervisión.Por ejemplo, escriba * .xml para supervisar los archivos XML.

10. En el campo Patrón de nombre de archivo/directorio excluido, escriba las variables para losnombres de tipos de archivo y directorios que desea excluir de la supervisión.Por ejemplo, escriba sam * para excluir todos los archivos que comienzan con sam.

11. Para las actividades intermedias únicamente, escriba los Patrones de correlación queproporcionan el formato de nombre de archivo que determina el ID de correlación del nombrede archivo.Por ejemplo, el archivo sam_956d77f734b6d7fb97771be.xml se puede representar (utilizandosignos de dólar $ como valores de marcador de posición) como sam_$id$.xml. El valor demarcador de posición $id$ representa el ID de correlación 956d77f734b6d7fb97771be.Los valores de los marcadores de posición deben ser caracteres alfanuméricos sin espacios. Eltoken del marcador de posición comienza después del signo de dólar $ y finaliza con el primercarácter no alfanumérico.Nota: Si el sistema no puede utilizar el campo Patrones de correlación para hacer coincidir losmensajes de solicitud y respuesta, entonces utiliza el ID de correlación y la asignación que sedefine en el Paso 17.

12. Seleccione una de las Opciones de posprocesamiento siguientes para gestionar el archivo unavez descargado y procesado.

Se puede Archivar o Eliminar el archivo, la carpeta o el archivado.13. Si ha seleccionado mover el mensaje a una carpeta para archivar en el paso 12, escriba el nombre

de la Carpeta para archivar.14. Escriba el número de Procesadores FTP disponibles.

Éste es el número total de procesadores simultáneos que pueden supervisar los datos en este puntofinal. Se basa en el número de conexiones simultáneas admitidas para el servidor FTP.Nota: El número de Procesadores FTP debería ser mayor que o igual a 1. Este número asume laexistencia de un sondeo, de modo que si está configurando tres procesadores, introduzca 3 en estecampo. Cuando configura su servidor FTP, tendrá un total de cuatro conexiones simultáneas.

15. Escriba el número de minutos utilizados como Intervalo de sondeo después del que el sistemacompruebe los archivos entrantes.

Por ejemplo, si la frecuencia de sondeo se establece en 45, el servidor FTP sondea cada 45 minutosen busca de archivos.

Nota: Si espera recibir archivos grandes, es mejor utilizar un intervalo de sondeo más alto.16. Haga clic en Siguiente para asignar atributos con origen FTP para procesar atributos de datos.







17. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, donde puedeespecificar reglas que hagan coincidir los atributos del conjunto de correlación con los atributosdel mensaje del FTP.

Introducción a la correlación de mensajes, página 155 proporciona más información acerca decómo utilizar los conjuntos de correlaciones para hacer coincidir los mensajes de los orígenesexternos con los datos de proceso. Crear los conjuntos de correlación, página 72 proporciona másinformación acerca de cómo definir los conjuntos de correlaciones para un proceso.Nota: El mensaje debe contener datos estructurados para poder asignar los atributos del conjuntode correlación a los atributos del mensaje.

18. Seleccione el Conjunto de correlación que está asignando en el cuadro de lista de la partesuperior de la página y configure las asignaciones para la actividad.


Agregar un esquema XML al contenido de la actividad, página 143 proporciona instrucciones paraagregar un esquema XML a una asignación de mensajes.

FTP salienteUtilice la plantilla de actividad FTP saliente para actividades que lean mensajes de los archivos. Estasplantillas de actividad son particularmente útiles para procesos que confían mucho en las transaccionesbasadas en archivos, como los procesos de auditoría financieros.

Para configurar la plantilla de actividad saliente del FTP:

1. Seleccione un Protocolo para el mensaje.

Los protocolos estándar compatibles son FTP, SFTP (FTP sobre SSH), FTPS (FTP sobre SSL) yArchivo local.

Nota: Si selecciona Archivo local, omita el paso 5.2. Escriba el nombre de host o la dirección IP del servidor FTP.3. Escriba el número de Puerto que está utilizando para la conexión.

• El puerto predeterminado para FTP y FTPS es 21.• El puerto predeterminado para SFTP es 22.



6. Para utilizar la autenticación de claves públicas, active la casilla correspondiente.a. Haga clic en Importar clave privada para iniciar el cuadro de diálogo Elegir clave privada y

desplácese hasta la ubicación del archivo de clave privada.b. Seleccione el archivo de clave privada y haga clic en Aceptar.



El sistema carga el archivo de clave privada, y el contenido se cifra en Base64 y se escribe enla definición de servicio.


7. Escriba la ruta de acceso al equipo de la Carpeta base al que se cargan los archivos.8. Seleccione el Tipo de mensaje.

Algunas opciones válidas son:• Archivo, que permite al sistema enviar un archivo simple.• Archivo comprimido, que coloca archivos en una carpeta de compresión. Este archivo senombra en tiempo de ejecución basándose en el nombre para archivar que configuró en elasignador de datos y, a continuación, colocó en el directorio de destino..

• Directorio, que coloca los archivos en subcarpetas basándose en el directorio de destino. Elnombre de la subcarpeta se determina en tiempo de ejecución basándose en el nombre deldirectorio que configura en el asignador de datos.

9. Haga clic en el botón Validar para comprobar que los parámetros de conexión se han escritocorrectamente.

Nota: El botón Validar no está disponible para la opción Archivo local. Debe verificarmanualmente que la carpeta base existe en el equipo donde se implementó la plantilla de actividadentrante.

10. Para permitir al sistema sobrescribir un archivo idéntico existente (o una subcarpeta si seleccionaDirectorio en el paso 6), seleccione Sobrescribir si existe.

Si se deja en blanco, el sistema asigna un nombre único al archivo agregando un númeroincremental al nombre del archivo (o la subcarpeta) y no sobrescribe el archivo (o la subcarpeta)existente.

11. Haga clic en Siguiente para asignar atributos de datos de proceso a los atributos del FTP.





Basándose en los tipos de archivo que ha elegido, debe completar las siguientes asignaciones:

• Si decide cargar los archivos en una subcarpeta, debe asignar los datos de proceso a lasubcarpeta del lado derecho de la pantalla de asignación de datos.

• Si decide cargar los archivos en un archivo comprimido, debe asignar el proceso al nodoArchivar.

• Además, por lo menos debe existir una asignación de los datos de proceso al nodo Anexo.Dentro de esta asignación, también hay que configurar los atributos Nombre del contenido,Tipo de contenido y Datos.Nota: La asignación del atributo Tipo de contenido determina el modo en el cual se transmitenlos datos al servidor FTP. Si se asigna a un texto de cadena, se transmite como texto ASCII.Todos los otros archivos se transfieren en modo binario.



Leer FTPLas actividades basadas en esta plantilla conectan con un servidor FTP y devuelven archivos o carpetasde acuerdo con los criterios especificados mediante los datos de proceso. Por ejemplo, un archivoXML entrante puede hacer referencia a un archivo de imagen ubicado en un servidor FTP que debedescargarse. Esta plantilla de actividad recupera el archivo y lo asocia a la actividad.

Nota: Esta plantilla de actividad se diferencia de FTP entrante en que utiliza los criterios de búsquedapara recuperar el archivo al crear el elemento de trabajo. FTP entrante se desencadena cuandose cumplen los criterios de búsqueda.

Para configurar una actividad Leer FTP:

1. Seleccione un Protocolo para la conexión.

Los protocolos estándar compatibles son FTP, SFTP (SSH FTP), FTPS (FTP sobre SSL) ySistema de archivos local.Nota: Si selecciona Sistema de archivos local, vaya directamente el paso 5.

2. Escriba el nombre de host o la dirección IP del servidor FTP.

3. Escriba el número de puerto para la conexión.• El puerto predeterminado para FTP y FTPS es 21.• El puerto predeterminado para SFTP es 22.


5. Para utilizar la autenticación de claves públicas, active la casilla correspondiente.

a. Haga clic en Importar clave privada para iniciar el cuadro de diálogo Elegir clave privada ydesplácese hasta la ubicación del archivo de clave privada.

b. Seleccione el archivo de clave privada y haga clic en Aceptar.

El sistema carga el archivo de clave privada, y el contenido se cifra en Base64 y se escribe enla definición de servicio.


6. En el campo Carpeta base, escriba la ruta a las carpetas en el servidor FTP que se leerán.

7. En el campo Tipo de mensaje, seleccione la opción para las descargas de archivos.

Las opciones válidas son:

• Archivo, que permite al sistema obtener un archivo.

• Archivo comprimido, que permite al sistema obtener varios archivos dentro de una ubicación dearchivado.

• Directorio, que permite al sistema obtener varios archivos dentro de una carpeta.

8. Haga clic en el botón Validar para comprobar que los parámetros de conexión y la ruta de lacarpeta en negrita se han escrito correctamente.

9. Haga clic en Siguiente para proporcionar el patrón o el nombre de archivo o de directorio exactosque se obtendrán del servidor FTP.




Nombre Nombre se debe asignar ya que el servidor FTP emplea la configuraciónproporcionada en la página Configuración para buscar el archivo o lacarpeta que se ha asignado al atributo.





10. Haga clic en Siguiente para utilizar la herramienta de asignación de datos para especificar lasreglas que permiten emparejar atributos del archivo descargado con datos de proceso.

Fax salienteNota: Captaris RightFax no está incluido en el conjunto de Process Suite y se debe adquirir yautorizarse a través de Captaris. Consulte la documentación de Captaris RightFax para obtenerinstrucciones sobre cómo instalar y configurar el servidor RightFax. Debe realizar los siguientespasos obligatorios para poder usar las plantillas de actividad Fax saliente:1. Consulte la documentación de RightFax para obtener la ruta a la API de Java de RightFax

(RFJavaInt.zip).2. Copie RFJavaInt.zip en la ruta siguiente del directorio de implementación de Method Server:

bpm.ear\bpm.war\WEB-INF\lib.3. Cambie el nombre RFJavaInt.zip por RFJavaInt.jar.4. Reinicie Method Server.

Utilice la plantilla de actividad Fax saliente para enviar mensajes unidireccionales a un servidor defax de Captaris RightFax. Estos mensajes pueden ser solicitudes de fax enviadas desde un proceso opueden ser consultas que solicitan el estado de una o varias solicitudes de fax. Los resultados de laconsulta aparecen en la bandeja de entrada del ejecutante de la actividad.

Para enviar una solicitud de fax con la plantilla de actividad Fax saliente:

1. Abra la plantilla de actividad Fax saliente.2. Escriba la dirección URL del servidor de RightFax.

Por ejemplo,

http://<FaxServer_IP>

3. Escriba el nombre de usuario del servidor de RightFax.4. En el cuadro de lista desplegable, seleccione la operación Enviar para enviar una solicitud de

fax al servidor de RightFax.

Enviar envía una solicitud de fax al servidor de RightFax. Consulta obtiene el estado de unasolicitud de fax enviada al servidor de RightFax basada en un identificador único.

5. Haga clic en el botón Probar URL de servidor de RightFax para comprobar que se puedeacceder al servidor de RightFax desde la plantilla de actividad.



6. Haga clic en Siguiente para asignar atributos de datos de proceso a los atributos de la solicitudde fax.





7. Cree una asignación para Detalles del destinatario utilizando los datos de proceso en la pantalladel asignador de datos:a. Asigne un ID a un identificador único para la solicitud.

Si no proporciona un identificador a la solicitud, el servidor de RightFax genera uno.b. Asigne un nombre al nombre del destinatario.c. Asigne una compañía al nombre de la compañía del destinatario.d. Asigne un Nº de fax al número de teléfono de fax de destino.e. Asigne un nombre de portada al nombre de la plantilla de portada que se encuentra en el

servidor de RightFax.

El sistema de RightFax admite dos tipos de portadas:

Portadas de fax de producción que utilizan la extensión de archivo .cov. No sepueden utilizar estas portadas al enviar el fax a varios destinatarios. En la mayoríade los casos, las portadas están situadas en la ubicación siguiente: C:\Archivos deprograma\RightFax\Production\Covers.

Portadas de fax de la empresa que utilizan las extensiones de archivo siguientes:

.pcl para los documentos de lenguaje de control de impresiones

.doc para los documentos de Microsoft Word

.html para los documentos HTML

.mht para documentos meta-HTMLEstas portadas se almacenan en la ubicación siguiente: C:\Archivos de programa\RightFax\FCS.

Nota: Las portadas de fax se deben crear utilizando criterios concretos y deben guardarse enuna ubicación designada en el servidor de RightFax. Consulte la documentación de CaptarisRightFax para obtener instrucciones sobre cómo crear y guardar portadas de fax.

8. Cree una asignación para Cover Page Notes (Notas de portada) utilizando los datos de proceso dela pantalla del asignador de datos:a. Asigne el tipo a un texto sin formato o formato de portada HTML.b. Asigne un texto al contenido del mensaje para la portada.

Nota: El sistema trunca los archivos de texto que exceden la longitud del ajuste automáticode línea del servidor de RightFax. Consulte la documentación de RightFax para obtenerinformación detallada sobre cómo establecer manualmente la longitud del ajuste automático delínea en el Registro del servidor de RightFax.

9. Cree una asignación para Attachments (Anexos) utilizando los datos de proceso de la pantalla delasignador de datos:



a. Asigne el tipo de contenido al tipo de contenido encontrado en el anexo.

Consulte la documentación de RightFax para obtener información sobre los tipos de contenidocompatibles.

b. Asigne los datos al contenido real del mensaje de fax.

Nota: Si espera enviar anexos grandes con la plantilla de actividad, es posible que tenga queajustar el valor del campo El método termina en la ficha Ejecutante.

10. Haga clic en Siguiente para asignar la respuesta de RightFax a los datos de proceso asociados a lasolicitud de envío y cree asignaciones para los siguientes atributos:a. Asigne el ID al identificador único para la solicitud de fax enviada por el proceso.b. Asigne un código al código de estado de la solicitud.c. Asigne un mensaje al mensaje del estado asociado al código de estado.

Enviar una solicitud de consulta mediante Fax salientePara enviar una solicitud de la consulta al servidor de RightFax utilizando la plantilla deactividad Fax saliente:

1. Escriba la dirección URL del servidor de RightFax.2. Escriba el nombre de usuario del servidor de RightFax.3. En el cuadro de lista desplegable, seleccione la operación Consulta para recuperar el estado de

una solicitud de fax enviada al servidor de RightFax basada en un identificador único.4. Haga clic en el botón Probar URL de servidor de RightFax para comprobar que se puede

acceder al servidor de RightFax desde la plantilla de actividad.5. Haga clic en Siguiente para asignar atributos de datos de proceso a los atributos de la solicitud

de fax.





6. Asigne la respuesta del servidor de RightFax a la consulta utilizando las variables siguientes:a. ID es el identificador único para la solicitud de fax enviada por el proceso.b. Código es el código de estado de la solicitud.c. Mensaje es el mensaje del estado asociado al código de estado.

Algunos mensajes comunes son:

• Problema de la línea telefónica• Programado para su envío• Problema al convertir el cuerpo de fax o portada

Para obtener una lista completa de mensajes, consulte la documentación de RightFax.



HTTP entrante: inicio y procedimientoUtilice la plantilla de actividad HTTP entrante para recibir y procesar los mensajes HTTP enviadospor un cliente externo. Se configura al oyente de HTTP para escuchar un sufijo de URL concreto ya continuación, leer y procesar los mensajes entrantes. El mensaje entrante puede asignarse paraprocesar datos mediante el asignador de datos.

El sistema devuelve a continuación una respuesta sincrónica al cliente utilizando el tipo de respuestaque especifica en la plantilla de actividad.

Nota: El navegador debe tener la codificación establecida en UTF-8 al enviar la solicitud al agente deescucha HTTP entrante si se utilizan caracteres multibyte.

Para configurar la plantilla de actividad entrante de HTTP:1. Escriba el Sufijo de URL al que se envía la solicitud de URL.

Por ejemplo, si la URL de solicitud de HTTP enviada desde el cliente eshttp://eng076:8001/bps/http/ReceivePO, entonces el sufijo es ReceivePO.

2. Si la plantilla de actividad entrante requiere autenticación, seleccione Autenticación para requerirun nombre de usuario y una contraseña.

3. Escriba el nombre de usuario y la contraseña requeridos para acceder a la actividad entrante.

Este es el valor que el usuario introduce en el cuadro de diálogo de autenticación del exploradorpara acceder a la actividad. La solicitud se envía nuevamente con el nombre de usuario y lacontraseña en la solicitud de HTTP. Si se selecciona autenticación y los parámetros de URL denombre de usuario y contraseña no se han enviado, la plantilla de actividad entrante no permitirá elacceso a la actividad.

4. Seleccione un Tipo de solicitud que especifique el tipo de solicitud entrante.

Los valores válidos son GET, POST y PUT.

• Seleccione GET si las solicitudes no van a llevar anexos.• POST y PUT pueden llevar anexos. Si algunas solicitudes tienen anexos y otras no,seleccionando POST como tipo de solicitud todavía podrá enviar una solicitud GET.

Nota: Si está utilizando el método GET, los campos utilizados para especificar la informaciónde la solicitud no están disponibles.

5. Si la plantilla de actividad es una actividad intermedia, escriba el Nombre de propiedad decorrelación.

Este nombre de propiedad de la solicitud HTTP se utiliza para identificar un flujo de trabajo. Esteatributo aparece en el asignador de datos, ubicado en el nodo de los parámetros URL del nodo delCuerpo. Este valor debe coincidir con uno de los valores de nombre de los datos de proceso.

Nota: El nombre de propiedad de correlación es utilizado por el sistema en primer lugar para hacercoincidir la solicitud con los mensajes de respuesta. Si hay valores de conjunto de correlaciónasignados, el sistema sólo utiliza esos valores si falla la asignación al nombre de propiedad decorrelación.

6. Para incluir anexos en el mensaje de solicitud, seleccione Con anexos. Los anexos están sólodisponibles para los tipos de solicitud POST y PUT.

7. Seleccione Validar documentos XML para forzar la validación del XML.8. Para crear una plantilla de texto para el mensaje de respuesta, seleccione Respuesta desde

plantilla.



9. Si está utilizando una Plantilla de respuesta, entre en el cuerpo de la respuesta en el cuadro detexto.

Puede incluir texto estático, HTML y valores de marcador de posición que se pueden asignarpara procesar los datos.

• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo, $ {tokenname }).

• Utilice dos signos de dólar $$ para crear marcadores de posición con múltiples valores.

• Para utilizar un signo de dólar en el cuerpo del mensaje de correo electrónico, utilice \$ (porejemplo, quinientos dólares se expresarían como \$500.00).

Nota: Los valores de los marcadores de posición deben ser caracteres alfanuméricos sinespacios. El token del marcador de posición comienza después del signo de dólar $ y finalizacon el primer carácter no alfanumérico.

Por ejemplo, para enviar un mensaje que indique que un pedido se ha procesado correctamente,utilice el siguiente texto de plantilla: El pedido de compra $orderno se procesó correctamente. Elmarcador de posición, numpedido aparece en la pantalla de asignación de datos y puede asignarsea una variable de proceso o paquete. La respuesta enviada será una página HTML con el mensajesiguiente: El pedido de compra 0896523 se procesó correctamente, donde 0896523 es el valorde sustitución obtenido de la asignación de datos de respuesta.

Nota: Todos los valores de marcador de posición deben asignarse a los datos de proceso.

10. Haga clic en Siguiente para asignar el mensaje de solicitud de entrada a los datos de proceso.





• Agregar las propiedades del mensaje, página 142 proporciona instrucciones para agregar unapropiedad específica del servicio a un mensaje para finalizar una asignación.

De acuerdo con los tipos de protocolo que ha seleccionado, complete las siguientes asignaciones:

• Los mensajes que utilizan los métodos GET no tienen ningún anexo, por lo que sólo losatributos para los parámetros URL y los encabezados aparecen en el asignador.

• Los mensajes que utilizan los métodos POST muestran los atributos de asignación para losencabezados, atributos de cuerpo y anexos, si los anexos se han habilitado en la pantalla anterior.

• Los mensajes que utilizan los métodos PUT muestran los atributos de asignación para elencabezado y un anexo del cuerpo, si los anexos se han habilitado en la pantalla anterior.

11. Haga clic en Siguiente para asignar los datos de proceso al mensaje de respuesta.

Utilice el asignador de datos para asociar los datos de proceso a los atributos de estado, encabezadoy cuerpo. Cualquier valor de marcador de posición aparece en el asignador de datos y le permiteasociar valores para enviar en la respuesta al cliente.







12. Haga clic en Siguiente para utilizar el asignador de datos para asociar los atributos de mensajes desolicitudes al conjunto de correlación que elija en el paso siguiente.


Introducción a la correlación de mensajes, página 155 proporciona más información acerca decómo utilizar los conjuntos de correlaciones para hacer coincidir los mensajes de los orígenesexternos con los datos de proceso. Crear los conjuntos de correlación, página 72 proporciona másinformación acerca de cómo definir los conjuntos de correlaciones para un proceso.

HTTP saliente

La plantilla de actividad HTTP saliente envía una solicitud de HTTP a una URL especificada y puederecibir una respuesta del servidor. Los campos de la plantilla de actividad le permiten especificar losdatos que se pueden asignar al modelo de datos de proceso.

Para configurar la plantilla de actividad saliente de HTTP:

1. Escriba la dirección URL completa del sitio al que la actividad envía contenido, que empiezacon el prefijo de protocolo http://.

2. Si el servidor requiere autenticación, seleccione Autenticación para requerir un nombre deusuario y una contraseña.

Nota: Sólo se admite la autenticación básica en la plantilla de actividad HTTP saliente.

3. Escriba un Nombre de usuario y una Contraseña si requiere autenticación.

4. Seleccione unMétodo de solicitud que especifique el tipo de solicitud que se va a enviar alservidor.

Los valores válidos son GET, POST y PUT.Nota: Si está utilizando el método GET, los campos utilizados para especificar la informaciónde la solicitud no están disponibles.



6. En el campo Tiempo de espera de conexión (minutos), escriba la cantidad de minutos que sepermite antes de que el sistema finalice una conexión inactiva.

7. Para incluir anexos en el mensaje de solicitud, seleccione Permitir anexos.

Los anexos están sólo disponibles para los tipos de solicitud POST y PUT.

8. Haga clic en Siguiente para asignar los datos de proceso al mensaje de solicitud.








Los mensajes que utilizan los métodos GET no tienen ningún anexo, por lo que sólo los atributospara los parámetros URL y los encabezados aparecen en el asignador.Los mensajes utilizando los métodos POST muestran los atributos de asignación para losencabezados, atributos de cuerpo o anexos, si los anexos se han habilitado en la pantalla anterior.Los mensajes que utilizan los métodos PUT muestran los atributos de asignación para elencabezado y un anexo del cuerpo, si los anexos se han habilitado en la pantalla anterior.

9. Haga clic en Siguiente para asignar el mensaje de respuesta a los datos de proceso.





• Agregar un esquema XML al contenido de la actividad, página 143 proporciona instruccionespara agregar un esquema XML a una asignación de mensajes.


JMS entrante: inicio y procedimientoLas plantillas de actividad JMS entrante se utilizan para recibir y procesar los mensajes JMS enviadosa una cola o un tema. Por ejemplo, en un flujo de trabajo de procesamiento de reclamaciones, se puedeconfigurar una actividad de inicio de JMS para escuchar una cola de reclamaciones. La actividad iniciael flujo de trabajo cuando un mensaje alcanza la cola. El sistema enruta a continuación los datosdel mensaje hacia el destino deseado.

Se especifican las opciones de conexión y procesamiento dentro de la plantilla de actividad y seasignan los parámetros del mensaje como encabezados JMS y otras propiedades a los datos de procesoutilizando la herramienta de asignación de datos.

Para configurar la plantilla de actividad entrante de JMS:

1. Configure el contexto inicial para el servidor de mensajería.a. Seleccione la Fábrica de contexto inicial que el sistema utiliza para tener acceso al contexto

de JNDI (Interfaz de directorios y nombres Java) del servidor de mensajería. Las fábricas decontexto para WebSphere, TIBCO y WebLogic están disponibles con Process Builder.



b. Escriba la URL del proveedor del servidor de mensajería.c. Escriba el nombre de usuario y la contraseña para el servidor de mensajería.d. Escriba las propiedades adicionales necesarias para tener acceso a los mensajes del servidor

JMS configurado.

InitialContextFactory utiliza estos atributos para crear InitialContext en tiempo de ejecución.2. Configure la conexión para la Cola/Tema.

a. Seleccione la opción para tener acceso a una Cola o a un Tema.b. Escriba el nombre de la Fábrica de conexiones utilizada para tener acceso a la cola o tema.c. Escriba el nombre de la cola o tema que desea supervisar para los mensajes.d. Escriba el nombre de usuario y la contraseña que se utilizan para tener acceso al tema o a la

cola, si es necesario.e. Escriba una consulta opcional del Selector de mensajes para utilizarla a la hora de filtrar

los mensajes leídos por el agente de escucha entrante en función del valor de una propiedaddeterminada enviada en el mensaje JMS.

Por ejemplo, puede instalar un filtro para una Id. de proveedor determinada que se use en elmensaje y sólo aquellos mensajes con ese Id. de proveedor serán procesados por esta plantillade actividad.

f. Seleccione Tipo de mensaje.

Los valores válidos son Message, MapMessage, TextMessage, BytesMessage,ObjectMessage y StreamMessage.

g. Haga clic en el botón Probar conexión para comprobar que los parámetros de conexión sehan escrito correctamente.

Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro de texto.Modifique los valores e inténtelo de nuevo.

3. Seleccione Validar esquema para que el sistema compruebe la validez de los esquemas XML entiempo de ejecución.

4. Escriba el Número de hebras que se van a utilizar con los mensajes JMS.

Nota: Para las conexiones del tema, el número predeterminado de hebras se establece siempre en 1.5. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, donde puede asignar

los datos del mensaje en los datos del proceso para el mensaje de entrada.









6. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, donde puede asignardatos de mensajes a los conjuntos de correlaciones.


8. Puede considerar que necesita agregar atributos o elementos a algunos datos para completarlas asignaciones.





• Introducción a la correlación de mensajes, página 155 proporciona más información acerca decómo utilizar los conjuntos de correlaciones para hacer coincidir los mensajes de los orígenesexternos con los datos de proceso. Crear los conjuntos de correlación, página 72 proporcionamás información acerca de cómo definir los conjuntos de correlaciones para un proceso.

JMS SalienteUtilice la plantilla de actividad JMS saliente para permitir a Process Builder enviar los mensajes a unaaplicación externa y, a continuación, recibir una respuesta de esa aplicación. Esta plantilla puede enviarmensajes XML, mensajes binarios y mensajes en otros formatos estructurados como archivos .CSV.

Para configurar la plantilla de actividad saliente de JMS:

1. Configure el contexto inicial para el servidor de mensajería.

a. Seleccione la Fábrica de contexto inicial que el sistema utiliza para tener acceso al contextode JNDI (Interfaz de directorios y nombres Java) del servidor de mensajería. Las fábricas decontexto para WebSphere, TIBCO y WebLogic están disponibles con Process Builder.

b. Escriba la URL del proveedor del servidor de mensajería.

c. Escriba el nombre de usuario y la contraseña para el servidor de mensajería.

d. Escriba las propiedades adicionales necesarias para tener acceso a los mensajes del servidorJMS configurado.

InitialContextFactory utiliza estos atributos para crear InitialContext en tiempo de ejecución.

2. Configure la conexión para la Cola/Tema.

a. Seleccione la opción para tener acceso a una Cola o a un Tema.

b. Escriba el nombre de la Fábrica de conexiones utilizada para tener acceso a la cola o tema.

c. Escriba el nombre de la cola o tema que desea supervisar para los mensajes.

d. Escriba el nombre de usuario y la contraseña que se utilizan para tener acceso al tema o a lacola, si es necesario.

e. Seleccione Tipo de mensaje.



Los valores válidos son Message, MapMessage, TextMessage, BytesMessage,ObjectMessage y StreamMessage.



4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, donde puede asignarlos datos del proceso en los datos del mensaje para el mensaje de entrada.






5. Haga clic en Siguiente para asignar los atributos de respuesta de mensaje a los datos de procesopara el mensaje saliente.


Asignación de datos de procesosLas actividades basadas en esta plantilla transfieren datos de un paquete del proceso comercial a otropaquete, o desde un atributo de paquete a otro. También puede copiar el contenido de un paqueteen otro paquete.

Para configurar una actividad de Asignación de datos de procesos:

1. En el Inspector de actividades, haga clic en la ficha Asignación de datos de procesos.

Aparecerá la herramienta de asignación de datos, con la lista de paquetes de proceso en lascolumnas de la izquierda y la derecha. La columna de la izquierda también contiene las variablesde sustitución de flujos de trabajo.

2. Utilice la herramienta de asignación de datos para transferir valores desde paquetes o datos deejecución a otros paquetes o atributos de paquete, o para copiar el contenido del paquete de lacolumna izquierda a un paquete de la columna derecha. También puede asignar atributos convalores de repetición.

Para los objetos del paquete que tienen contenido asociado a ellos, se muestran los siguientesatributos bajo el nodo Contenido:

• tipo de contenido: especifica el tipo MIME del contenido.• formato: especifica el nombre del objeto de formato (dm_format) que está asociado alcontenido.

• datos: especifica el contenido en sí.



Para copiar contenido en un paquete, los usuarios deben crear reglas de asignación para:

• Copiar datos desde cualquier nodo de origen al nodo de datos del paquete.• Definir los valores para el nodo de formato o de datos. Esto se puede llevar a cabo mediantela especificación de un valor constante o mediante la asignación de valores desde cualquiernodo de origen.Los usuarios verán el siguiente error de validación si no se especifican valores para los nodos deformato o de datos:No se ha encontrado el tipo de contenido o el formato en las reglas de asignación del paquete:<paquete de destino>

Puede utilizar cualquiera de las funciones normales disponibles para copiar el contenido delpaquete. Asimismo, puede utilizar las funciones De cadena a byte o De byte a cadena que admitenla conversión del contenido al tipo de datos Cadena. Consulte Usar las funciones de asignación dedatos, página 150 si precisa más información sobre estas funciones.




En tiempo de ejecución, si existe el paquete de destino, el contenido y el formato del paquete sesustituyen por el contenido y el formato del paquete de origen. Si no existe el paquete de destino,se creará un paquete nuevo. El contenido del paquete de origen, incluido el tipo de contenido,se copia en el paquete nuevo. Sin embargo, si el paquete de origen no tiene una asignación deformato o un tipo de contenido, el valor para el atributo de formato en el paquete de destino sedefine en crtext y el tipo de contenido como text/plain.

Plantilla de actividades SMTPUtilice la plantilla de actividad de SMTP para enviar mensajes y anexos de correo electrónico a laslistas de usuarios. Por ejemplo, puede agregar una plantilla de actividad que envíe un mensaje decorreo electrónico como respuesta a una reclamación de un cliente o enviar un informe de gastos enel cuerpo del mensaje de correo electrónico para su aprobación.

Para configurar la plantilla de actividad de SMTP:1. Escriba el Nombre de host del equipo host del servidor o su dirección IP.2. Escriba el parámetro que identifica el Número de puerto para el servidor.

Si no se proporciona ningún valor, la actividad utiliza el número estándar basándose en el tipode servidor que elija.

3. Seleccione el valor opcional para Utilizar cifrado.

El valor predeterminado es Ninguno.

Nota: Si utiliza el cifrado SSL o TLS, debe disponer de un certificado SSL en su entorno. Consulteel manual Process Integrator Deployment Guide para obtener instrucciones sobre cómo importarcertificados SSL para dar soporte a conexiones cifradas de las plantillas de actividad.

4. Seleccione Se requiere autenticación si el servidor requiere un nombre de usuario y unacontraseña para la autenticación.



5. Escriba un nombre de usuario y una contraseña si el servidor requiere autenticación.



7. Escriba la plantilla de asunto de correo electrónico en el campo Plantilla de asunto.

La plantilla de asunto debe constar de texto estático y de valores de marcadores de posición que sepuedan asignar a datos de procesos.Los valores de los marcadores de posición deben ser caracteres alfanuméricos sin espacios. Eltoken del marcador de posición comienza después del signo de dólar $ y finaliza con el primercarácter no alfanumérico. Asimismo, todos los valores de marcador de posición deben asignarse alos datos de proceso.

• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo, $ {tokenname }).• Utilice dos signos de dólar $$ para crear marcadores de posición con múltiples valores.• Para utilizar un signo de dólar en el cuerpo del mensaje de correo electrónico, utilice \$ (porejemplo, quinientos dólares se expresarían como \$500.00).Nota: Para utilizar un apóstrofo o una comilla simple dentro del asunto o cuerpo del correoelectrónico, debe incluir una comilla simple adicional como carácter de escape. Por ejemplo,para incluir EMC’s product en el texto, debe escribir EMC”s product.

8. Escriba el texto de la plantilla de correo electrónico en el cuadro de texto Plantilla de cuerpo.

Puede incluir texto estático, HTML copiado de un editor HTML de otro fabricante y parámetros demarcador de posición que se pueden asignar a los datos de proceso.

Si va a incluir formato HTML en el cuerpo del correo electrónico, debe asignar el valortexto/html constante al Contenido-Tipo del nodo Cuerpo del mensaje de correo electrónico.Si Contenido-Tipo no está asignado a un valor, el tipo de contenido es texto/llano de formapredeterminada.

Los valores de los marcadores de posición deben ser caracteres alfanuméricos sin espacios. Eltoken del marcador de posición comienza después del signo de dólar $ y finaliza con el primercarácter no alfanumérico. Asimismo, todos los valores de marcador de posición deben asignarse alos datos de proceso.

• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo, $ {tokenname }).• Utilice dos signos de dólar $$ para crear marcadores de posición con múltiples valores.• Para utilizar un signo de dólar en el cuerpo del mensaje de correo electrónico, utilice \$ (porejemplo, quinientos dólares se expresarían como \$500.00).Nota: Para utilizar un apóstrofo o una comilla simple dentro del asunto o cuerpo del correoelectrónico, debe incluir una comilla simple adicional como carácter de escape. Por ejemplo,para incluir EMC’s product en el texto, debe escribir EMC”s product.

9. Haga clic en Siguiente para crear la asignación del mensaje de entrada asociando los datos deproceso al mensaje de correo electrónico.

La estructura del mensaje de correo electrónico aparece en el panel derecho y los datos de procesoen el lado izquierdo. Puede establecer los valores para los atributos de mensaje de correoelectrónico asignándolos desde los atributos del modelo de datos de proceso. Si tiene varios anexosdel correo electrónico, puede hacer clic en Agregar en el nodo Anexo para agregar más anexos.



La plantilla de actividades SMTP tiene atributos adicionales específicos de los encabezados decorreo electrónico que permiten crear asignaciones que establecen estos valores en los encabezadosde correo electrónico:

Tabla 17 Atributos adicionales para las actividades SMTP

Nombre deatributo


Finalidad Acción

Importancia X-Priority,Importancia, Priority,X-MSMail-Priority

Sugerencia definida porel remitente que indicala importancia relativadel mensaje. Los valoresválidos son (1) Alta, (3)Normal y (5) Baja.

Conjunto de

Palabras clave Palabras clave Palabras o frases que sepueden utilizar cuandose busca u ordena correoelectrónico.

Conjunto de

Fecha deexpiración

Fecha de expiración Fecha en la que el correoelectrónico ya no esválido.

Conjunto de

Confidencialidad Confidencialidad Informa al destinatario dela naturaleza del correoelectrónico y del riesgode divulgar el contenidoa personas distintasde los destinatariosespecificados.

Los valores válidos son:Personal, Private oCompany-Confidential.

Conjunto de

La plantilla de actividad también permite agregar atributos al nodo Encabezados adicionalesdel mensaje de correo electrónico.







Nota: Por lo menos uno de los nodos de destinatario (Para, CCO o CC) debe asignarse desde losdatos de proceso o desde un valor constante. Además, todos los nodos de marcadores de posiciónbajo los nodos Asunto y Cuerpo deben asignarse en este punto.


Por ejemplo, si agregó una variable de proceso emailMsgId, puede asignar el atributo de Id. demensaje de correo electrónico del mensaje de origen a esa variable de proceso.Puede considerar que necesita agregar atributos o elementos a algunos datos para completarlas asignaciones.




• Agregar un esquema XML al contenido de la actividad, página 143 proporciona instruccionespara agregar un esquema XML a una asignación de mensajes. Agregar las propiedades delmensaje, página 142 proporciona instrucciones para agregar una propiedad específica delservicio a un mensaje para finalizar una asignación.

WS entrante: inicio y procedimientoEsta plantilla de actividad solo se admite en Documentum Process Builder versión 6.5 yversiones posteriores. Si se utiliza una versión anterior de Process Builder para un repositoriode Documentum 6.5, no se abrirá esta plantilla.Nota: Para que las URL puedan tener acceso a WSDL, primero se deben crear los agentes de escuchaentrantes de servicios Web.Estos son los formatos URL válidos para acceder al WSDL.http://<hostname>:<port>/bps/webservice/<processID>?WSDLhttp://<hostname>:<port>/bps/webservice/<processName>?WSDLhttp://<hostname>:<port>/bps/webservice/<processName>/<version>?WSDL

Utilice Web Service Inbound (Servicio Web entrante) para crear un nuevo punto final de los serviciosWeb para una actividad que necesita proporcionar un punto de integración y un WSDL a un sistemaexterno.

Por ejemplo, podría utilizar la plantilla de actividad Servicio Web entrante en un proceso de aplicaciónde préstamos para iniciar el proceso después de recibir una solicitud SOAP. Puede preparar la actividadcon WS-Security para requerir que el solicitante proporcione un nombre de usuario y una contraseñapara asegurar el servicio Web. Si la aplicación de préstamos incluye documentos grandes, puedehabilitar la compatibilidad con MTOM para la actividad que permitirá a la actividad enviar y recibirdatos binarios optimizados como anexos.

Como un paso de un proceso, la actividad Servicio Web entrante-procedimiento se puede utilizar pararecibir información desde un origen externo. La actividad también se puede utilizar para comprobar losingresos o recibir otra información relacionada desde un origen externo. Puede habilitar la seguridadpara asegurarse de que sólo las personas autorizadas pueden iniciar el proceso.

Puede habilitar la correlación de mensajes utilizando un identificador de correlación que sea un IDúnico generado para cada flujo de trabajo. Este ID de correlación se debe agregar al encabezado SOAPcon el formato definido por el estándar de WS-Addressing, como en el ejemplo siguiente:



<SOAPENV:header><wsa:RelatesTo xmlns:wsa={WS-AddressingSchema}>{correlationid}

<wsa:/RelatesTo></SOAPENV:header>

Hay dos maneras diferentes de definir el servicio Web:

• En la opción Procesar primero, se define el puerto y la operación y el sistema crea un WSDL desdela definición de proceso. El sistema crea un WSDL para un proceso, con una sección para cadaactividad de servicio Web entrante contenida en el mismo.

Nota: El WSDL generado sólo puede contener las variables de proceso asociadas a la actividadsi se han marcado como visibles para esa actividad en el Inspector de actividades. Cambiar datosde proceso en una actividad, página 134 proporciona instrucciones sobre cómo hacer que unavariable de proceso sea visible para una actividad.

• En la opciónWSDL primero, se especifica un WSDL existente para que el sistema lo utilice enel proceso.

Antes de agregar una actividad de servicio Web entrante a un proceso, configure el URI del espacio denombres de destino en la ficha Avanzada del cuadro de diálogo Propiedades de proceso. El sistema nopuede validar ni guardar el proceso sin el espacio de nombres de destino.

Un tipo de datos estructurado creado mediante la importación de un esquema XML puede no tenerdefinido el espacio de nombres de destino. Para utilizar este tipo de datos estructurado en un modeloProcesar primero, realice una de las siguientes acciones:

• Si el tipo de datos estructurado está en uso, cree un nuevo tipo con otro nombre y defina el espaciode nombres de destino en el esquema utilizado para crear el tipo de datos estructurado.

• Si el tipo de datos estructurado no está en uso, edite el esquema para definir un espacio de nombresde destino y vuelva a crear el tipo de datos.

Para configurar el servicio Web entrante:

1. En el Inspector de actividades, haga clic en la ficha Web Service Inbound (Servicio Web entrante).

2. Si selecciona la opción para usar Procesar primero, se describe un proceso en la plantilla deactividad y, una vez cargado, el sistema crea un WSDL a partir de la definición de proceso.

a. Escriba el nombre del tipo de puerto.

b. Escriba el nombre de la operación que se va a exponer al cliente.

c. Seleccione Correlación basada en contenido para permitir que el sistema correlacione losmensajes basándose en el conjunto de correlaciones.

d. En la lista Conjunto de correlación, seleccione un nombre de conjunto de correlación.

Nota: El modelo Procesar primero no requiere la asignación de los datos y el conjunto decorrelación, ya que la asignación se realiza implícitamente.

3. Para utilizar un WSDL existente para definir el servicio Web, seleccioneWSDL primero.

a. EscribaWSDL File URL/Path (Ruta/URL de archivo WSDL) al WSDL utilizado para laactividad.

b. Haga clic en Leer para recuperar el WSDL desde la ubicación que ha especificado.

c. Seleccione un tipo de puerto en la lista.

d. Seleccione el nombre de la operación que se va a exponer al cliente.



4. Para habilitar una autenticaciónWS Security UserName Token (Token de Nombre de usuario deWS-Security), active la casilla de verificación y escriba el nombre de usuario y la contraseña.

El controlador de WS-Security proporciona el acceso basado en credenciales a la actividad oproceso (cuando se utiliza en una actividad de inicio). Cuando se activa, todas las solicitudes delcliente a esta actividad deben contener las mismas credenciales en el encabezado de solicitud (enla estructura definida por el esquema de WS-Security para UserTokens) que se va a concederel acceso a la actividad o proceso.

5. SeleccioneMTOM para permitir que el sistema optimice cualquier anexo mientras se envía larespuesta.

Nota: MTOM no está disponible para la opción Procesar primero.

6. Haga clic en Siguiente para crear la asignación del mensaje de entrada asociando los datos deproceso al mensaje.

La estructura del mensaje SOAP aparece en el panel izquierdo y los datos de proceso en ellado derecho. Puede establecer los valores para los atributos del modelo de datos de procesoasignándolos desde los atributos del mensaje SOAP.


Las asignaciones siguientes se requieren para los anexos:

• Contenido del documento• Formato de archivoSi tiene varios anexos, puede hacer clic en Agregar en el nodo Anexo para agregar más anexos.











• Utilizar conjuntos de correlaciones, página 157 proporciona más información acerca de cómoutilizar los conjuntos de correlaciones para hacer coincidir los mensajes de los orígenes externoscon los datos de proceso. Crear los conjuntos de correlación, página 72 proporciona másinformación acerca de cómo definir los conjuntos de correlaciones para un proceso.




Servicio WebEsta plantilla de actividad le permite invocar los servicios Web con el estilo literal de documento. Lasactividades de servicios Web presentan dos diferencias importantes con respecto a otras actividadesde integración:

• El contenido que se envía al servicio Web debe ser un archivo XML bien formado que seaautosuficiente en espacio de nombres.

• Los servicios Web responden a los mensajes que reciben, por lo que la actividad necesita podergestionar una respuesta.

Para invocar un servicio Web, debe disponer de un documento WSDL (Web Services DescriptionLanguage) que proporcione la información necesaria para acceder al servicio. Los parámetrospersonalizados de las actividades del Servicio Web identifican el documento WSDL y el contenidoXML que se enviará al servicio. También especifican cómo gestionar la respuesta del servicio Web.

• Documento WSDL: este parámetro obligatorio señala a un archivo que incluye el contenido WSDLpara el servicio Web. Este archivo debe ser un documento WSDL bien formado almacenado en elrepositorio. Para desplazarse al archivo, debe hacer clic en el botón que aparece junto al cuadro detexto.

• Nombre del servicio: en muchos casos, el documento WSDL incluye el nombre del servicio Webque invocará la actividad. Si no es así, o si el documento WSDL contiene más de una definiciónde servicio, necesita escribir el nombre del servicio Web en este parámetro, que de otro modo, esopcional.

• Nombre de la operación: este parámetro obligatorio especifica el nombre de la operación delservicio Web que se invocará.

• Nombre del puerto: debe escribir el nombre del puerto para el servicio deseado si el documentoWSDL no lo proporciona o si incluye varios nombres de puerto.

• Enviar contenido del paquete de actividad: este parámetro opcional identifica qué contenido pasala actividad al servicio Web. El contenido debe ser XML bien formado que sea autosuficiente enespacio de nombres. El valor del parámetro es el nombre de uno de los paquetes entrantes de laactividad. Si no proporciona un valor, la actividad envía el contenido del primer paquete entrante(el paquete en el índice 0).

• Guardar respuesta del servicio Web: si define esta opción como Sí, la actividad guarda la respuestadel servicio Web como un documento XML. Los siguientes parámetros especifican el nombre deldocumento y dónde se guardará en el repositorio. Si define esta opción como No, los restantesparámetros no son relevantes.

• Guardar respuesta en la carpeta: si ha decidido guardar la respuesta del servicio Web, este parámetroespecifica la carpeta del repositorio en la que la actividad guarda el documento XML. La ubicaciónpredeterminada es /Temp.

• Nombre del documento de respuesta: si ha decidido guardar la respuesta del servicio Web, esteparámetro especifica el nombre dado al documento XML. Si no escribe un nombre, la actividadcrea uno utilizando el nombre del servicio Web seguido de la palabra "Respuesta" y la fecha yhora de la respuesta.



• Adjuntar documento de respuesta al paquete: si ha decidido guardar la respuesta del servicio Web,este parámetro especifica el paquete saliente al que se agrega el documento XML. Al agregar eldocumento a un paquete saliente, la actividad hace que se reenvíe a la siguiente actividad en el flujode trabajo. Si no escribe el nombre de un paquete saliente válido, el documento XML no se reenvía.

Documento de xPression PublishUtilice la plantilla de actividad de xPression Publish para generar un nuevo documento a partir deuna plantilla de documento de Document Sciences xPression sirviéndose de datos de proceso yasígnela a continuación a un paquete o un anexo. Las variables se sustituyen por datos de proceso alpublicar el documento.

Nota: La validación de datos no se admite en la plantilla de actividad Documento de xPressionPublish. Asegúrese de que todos los datos en tiempo de ejecución son válidos.

Para configurar una plantilla de actividad de xPression Publish:

1. Escriba la URL de servidor de xPression.

2. Escriba el nombre de usuario y la contraseña usados para conectar con el servidor de xPression.

Nota: es preciso asignar este usuario a un rol que disponga de permisos de xDesign.

3. Haga clic en Conectar para conectar con el servidor de xPression y recuperar una lista de lascategorías disponibles en dicho servidor.

4. Seleccione una categoría de documento de xPression en la lista.

Los valores mostrados en los campos Documento y Perfil de salida se basarán en esta categoría.

5. Seleccione un tipo de documento que pertenezca a la categoría seleccionada.

6. Seleccione un perfil de salida para el documento.

El sistema utiliza este perfil para publicar las salidas del documento como impresión, correoelectrónico, archivo o formatos basados en Web.

7. Haga clic en Siguiente para asignar los datos de proceso a las variables del documento de entrada.

Las variables del documento se basan en el tipo de documento.


Estos atributos deben asignarse a los datos de proceso:

El nombre es el nombre del archivo y se debe asignar al atributo object_name del paquete o anexo.

Debe asignar todas las variables requeridas por el servidor de xPression para completar el serviciode publicación. En tiempo de ejecución, las variables se sustituyen por datos de proceso en eldocumento generado.

En los documentos de xDesign, solo aparecen en el asignador las variables utilizadas en eldocumento. Asegúrese de que la clave principal esté asignada.







8. Haga clic en Siguiente para asignar el documento de salida a un paquete o anexo, si el perfil dedocumento proporciona un documento de salida.


Estos atributos deben asignarse a los datos de proceso:

• formato es el tipo de formato definido en el perfil de salida. Por ejemplo, si el perfil de salidaestá definido para que se publique un archivo PDF, este atributo se debe asignar al formato depaquete o anexo correspondiente.

• datos es el documento generado, el cual se debe asignar al atributo correspondiente de unpaquete o bien de un anexo.

Documento de publicación xPression: avanzadoUtilice la plantilla de actividad avanzada del documento de publicación xPression cuando haya muchosvalores constantes que deban asignarse a los datos de proceso. En vez de usar el asignador de datospara asignar cada variable, puede escribir el XML que crea las asignaciones para las constantes yagrega marcadores de posición para los datos dinámicos. A continuación puede utilizar el asignador dedatos para asignar únicamente los valores de marcador de posición creados por el XML.

Nota: La validación de datos no se admite en la plantilla de actividad avanzada del documento depublicación xPression. Asegúrese de que todos los datos en tiempo de ejecución son válidos.

Para configurar una plantilla de actividad de publicación xPression:

1. Escriba la URL de servidor de xPression.

2. Escriba el nombre de usuario y la contraseña usados para conectar con el servidor de xPression.

Nota: es preciso asignar este usuario a un rol que disponga de permisos de xDesign.

3. Haga clic en Conectar para conectar con el servidor de xPression y recuperar una lista de lascategorías disponibles en dicho servidor.

4. Seleccione una categoría de documento de xPression en la lista.

Los valores mostrados en los campos Documento y Perfil de salida se basarán en esta categoría.

5. Seleccione un tipo de documento que pertenezca a la categoría seleccionada.

6. Seleccione un perfil de salida para el documento.

El sistema utiliza este perfil para publicar las salidas del documento como impresión, correoelectrónico, archivo o formatos basados en Web.

7. Escriba el XML de datos de cliente que crea las asignaciones para las constantes y agregamarcadores de posición para los valores dinámicos.

En los documentos de xPression, la información sobre el cliente que contiene este XML sirve parapersonalizar el documento durante el proceso de publicación. El XML de este cuadro de texto



debe constar de texto estático y valores de marcador de posición para el contenido dinámicoque se desea asignar.

• Los marcadores de posición tiene como prefijo un signo de dólar $ (por ejemplo, $streetaddress).• Utilice dos signos de dólar $$ para crear marcadores de posición con múltiples valores.• Para utilizar un signo de dólar en el cuerpo del mensaje de correo electrónico, utilice \$ (porejemplo, quinientos dólares se expresarían como \$500.00).Nota: Los valores de los marcadores de posición deben ser caracteres alfanuméricos sinespacios. El token del marcador de posición comienza después del signo de dólar $ y finalizacon el primer carácter no alfanumérico.

El siguiente ejemplo de código muestra el XML de datos de cliente correspondiente a una solicitudde presentación de historiales médicos. El número de solicitud, la fecha de la solicitud y el númerode teléfono son todas las variables que se deben asignar en el asignador de datos.

<dataroot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><CUSTOMER_DATA><MedicalRecordReleaseRequest><reqNo>$RequestNo</reqNo><requestDate>$ReqDate</requestDate><patientName>John Doe</patientName>

<patientAddress_street1>1234 Cherry Circle</patientAddress_street1><patientAddress_street2></patientAddress_street2><patientAddress_city>San Jose</patientAddress_city><patientAddress_state>California</patientAddress_state><patientAddress_zipCode>95131</patientAddress_zipCode>

<patientDOB>1976-01-01</patientDOB><patientSSN>123-12-1234</patientSSN><patientHospitalName>Mercy Hospital</patientHospitalName><orgName>Mercy Medical Foundation</orgName><orgTelNo>$$TelephoneNo</orgTelNo></MedicalRecordReleaseRequest></CUSTOMER_DATA>

</dataroot>

como las variables deben ser cadenas de texto, los valores de fecha y hora se tienen que convertir aese tipo con la función DateToString del asignador de datos. (El formato de fecha que procede delos datos de proceso y el formato de fecha del XSD que espera el servidor de xPression puedenser diferentes).

En el anterior ejemplo, si requestDate es del tipo dateTime de XSD, use la siguiente cadena detexto para el formato:

yyyy-MM-dd’T’HH:mm:ss.SSSZ

El sistema exige los formatos siguientes para la conversión de la fecha y la hora:

Tabla 18 Formatos requeridos

Tipo de XSD Formatofecha yyyy-MM-dd



Tipo de XSD FormatodateTime yyyy-MM-dd’T’HH:mm:ss.SSSZ

hora HH:mm:ss.SSS

8. Haga clic en Siguiente para asignar los datos de proceso a las variables del documento de entradaque eran valores de marcador de posición en el XML.

Nota: Los valores constantes agregados mediante el cuadro de texto XML de datos de cliente noaparecen en el asignador de datos.


Debe asignar valores para las variables proporcionadas en el cuadro de texto XML de datosde cliente.





9. Haga clic en Siguiente para asignar el documento de salida a un paquete o anexo, si el perfil dedocumento proporciona un documento de salida.


Los atributos siguientes deben asignarse a los datos de proceso:

• El nombre es el nombre del archivo y se debe asignar al atributo object_name del paquete oanexo.

• formato es el tipo de formato definido en el perfil de salida.

• datos es el contenido generado.

Plantillas de actividad no admitidasLas plantillas de actividad de la siguiente sección ya no se entregan con Process Builder. Se hanreemplazado por plantillas de actividad que tienen funciones mejoradas. Las nuevas plantillas deactividad proporcionan una interfaz similar a la de un asistente para definir la transferencia de datos,incluyendo una herrameinta de asignación de datos gráficos para especificar cómo se intercambiandatos entre los orígenes de datos. Estas plantillas de actividad suministradas permiten el usoininterrumpido de la funcionalidad de mensajería de Process Integrator desde Process Builder yrequieren una configuración mínima sin desarrollo o procesamiento personalizados.

Esta sección es idónea para aquellos clientes que todavía están utilizando los procesos de las versionesanteriores (5.3x o anteriores) que contienen las plantillas de actividad más antiguas.



Nota: Estas plantillas se instalan como parte de los archivos BPM.dar y requieren la instalación deProcess Integrator. En la guía Process Integrator Activity Template 6.5 Migration Guide se ofreceinformación detallada sobre la compatibilidad con versiones anteriores de las plantillas de actividadobsoletas.

Punto de observaciónEsta plantilla de actividad permite seleccionar los paquetes asociados a una actividad específica ypublicar los datos empresariales en Process Analyzer para utilizarlos en los informes. Las actividadesseguidas de una plantilla de actividad Punto de observación pueden publicar datos de paquete enProcess Analyzer.

En tiempo de ejecución, la actividad Punto de observación inserta algunos atributos estándar y todoslos atributos personalizados en la tabla de seguimiento de auditoría, donde el trabajo Workflow PublishEvents (Eventos de publicación de flujo de trabajo) recopila los datos y los publica en Process Analyzer.

El trabajo Workflow Publish Events (Eventos de publicación de flujo de trabajo) publica los eventoscapturados en el seguimiento de auditoría en la base de datos ProActivity a intervalos regulares. Estetrabajo se proporciona como parte de la instalación de Process Engine. Si necesita más informaciónsobre la configuración del trabajo dm_WFPublishEvents, consulte la guía Process Builder InstallationGuide.

En la lista siguiente se muestran los atributos estándar que se publican como parte de cualquierdefinición de tipo de atributo:

• r_object_id

• object_name

• subject

• keywords

• title

• r_creation_date

• r_modify_date

Nota: El seguimiento de auditoría debe estar habilitado en la plantilla del proceso para que el trabajoWorkflow Publish Events (Eventos de publicación del flujo de trabajo) publique los datos del paquete.

Para configurar una actividad Punto de observación:

1. Identifique las actividades de un proceso que tienen paquetes que desea supervisar y utilizar en losinformes.

2. Desde la carpeta BAM, arrastre la plantilla de actividad Punto de observación hasta el proceso einsértela inmediatamente detrás de la actividad que desea supervisar.Existe una correspondencia uno a uno entre la actividad y la plantilla Punto de observación que lesigue. Si una actividad va seguida de una plantilla Punto de observación, no puede tener enlacessalientes a otras actividades, sólo puede conectar con dicha plantilla. Por otro lado, una plantillaPunto de observación sólo puede tener un enlace entrante desde una misma actividad, aunquepuede tener varios enlaces salientes.Abra el Inspector de actividades de Punto de observación y haga clic en la ficha Seleccionarpaquetes.



3. Seleccione los paquetes cuyos datos se publicarán en la base de datos ProActivity en este puntodel proceso.

a. Haga clic en Seleccionar. Aparecerá un cuadro de diálogo de selección en el que se muestranlos paquetes asociados a la plantilla del proceso.

b. Resalte el nombre del paquete en la lista de la izquierda y haga clic en Agregar para agregarloa la lista Elementos seleccionados de la derecha.

c. Repita estos dos pasos para cada paquete que desee agregar.d. Una vez que la lista de selección contenga todos los paquetes que desea supervisar, haga

clic en Aceptar.La ficha Seleccionar paquetes muestra una lista de los paquetes que se han marcado parala supervisión.Nota: Las plantillas de actividad Punto de observación no están visibles cuando se importan aProcess Analyzer. En cambio, la actividad que precede a la plantilla de actividad se marcacomo una actividad supervisada y contiene información en la que se indica qué paquetes se hanidentificado para la supervisión. Cuando el proceso empresarial se importa de nuevo en ProcessBuilder, la plantilla de actividad Punto de observación se restaura en el flujo del proceso.

FTPLa plantilla de actividad FTP se utiliza para enviar contenido a un sitio FTP o directamente a unsistema de archivos.

• Protocolo: este cuadro de lista muestra los protocolos disponibles para el envío del contenido. Losprotocolos estándar admitidos son FTP, FTPS (FTP sobre SSL), SFTP (SSH FTP) y File.

• Servidor: nombre o dirección IP del host del servidor FTP al que se enviará el contenido.

• Puerto: número de puerto en el que el servidor FTP está a la escucha.

• Nombre de usuario del servidor FTP: nombre de usuario para conectarse al servidor FTP.

• Contraseña del servidor FTP: contraseña del nombre de usuario.

• Directorio remoto: directorio al que se envía el contenido.

• Modo de transferencia: seleccione el método que utiliza la actividad cuando envía el contenido.Cuando selecciona la opción Archivar, la actividad crea un archivo Zip que contiene todo elcontenido y lo coloca en el directorio remoto especificado. Cuando selecciona Crear subdirectorio,la actividad crea un subdirectorio único en el directorio remoto especificado y coloca todo elcontenido en el subdirectorio. Cuando selecciona Todos los paquetes en directorio base, el contenidose coloca en el directorio remoto especificado.

• Adjuntar contenido desde los paquetes de actividad: este parámetro opcional identifica quécontenido envía la actividad a la ubicación especificada. El valor es el nombre de uno o varios de lospaquetes entrantes de la actividad. Si no proporciona un valor, la actividad envía el contenido delprimer paquete entrante (el paquete en el índice 0).

• Nombre del archivo o directorio: si ha elegido Archivar o Crear subdirectorio como el modo detransferencia, la actividad utiliza el valor de este campo para asignar un nombre al archivo ZIP osubdirectorio. Cuando proporciona un nombre de directorio, generalmente deseará incluir unavariable de sustitución en el nombre, como por ejemplo el ID del flujo de trabajo, con el fin de que laactividad cree un subdirectorio único para cada flujo de trabajo.



• Sobrescribir contenido de carpeta: seleccione si desea sobrescribir o no los archivos o carpetasexistentes en el directorio base del servidor FTP con el se va a transferir.

Buzón HTTP

La plantilla de actividad para enviar contenido mediante HTTP es la más sencilla de las plantillas deactividades de integración. Tiene un parámetro personalizado obligatorio y dos parámetros opcionales.

• URL: este parámetro obligatorio es la dirección URL completa del sitio al que la actividad envíacontenido, que empieza con el prefijo de protocolo http://.

• Tiempo de espera (seg.): este parámetro opcional define el valor del tiempo de espera para laconexión HTTP, en segundos. Si no incluye este valor o lo define como 0, la conexión no tendráun límite.

• Enviar contenido del paquete de actividad: este parámetro opcional identifica qué contenido envía laactividad a la dirección URL especificada. El valor es el nombre de uno de los paquetes entrantes dela actividad. Si no proporciona un valor, la actividad envía el contenido del primer paquete entrante(el paquete en el índice 0). Sólo se puede enviar el contenido de un paquete.

Aplicar ciclo de vida (5.3x y versiones anteriores)

Las actividades basadas en esta plantilla aplican un ciclo de vida de documento a uno o varios paquetesdel proceso comercial. Un ciclo de vida define una serie ordenada de estados que corresponden alas fases de la vida de un documento.

Para configurar una actividad de Aplicar ciclo de vida, debe elegir el ciclo de vida que desea aplicary los paquetes a los que se aplicará. Asimismo, debe especificar el estado inicial del ciclo de vida yel alcance que se utilizará cuando se resuelvan alias asociados al ciclo de vida. Consulte la guíaDocumentum Composer User Guide si precisa información detallada sobre la creación y el uso delos ciclos de vida.

• Paquetes a los que se aplicará el ciclo de vida: haga clic en el botón ... para mostrar un cuadro dediálogo en el que podrá seleccionar los paquetes de proceso a los que se aplicará el ciclo de vida.Para cada paquete al que desee aplicar el ciclo de vida, resalte el nombre del mismo en la lista dela izquierda y haga clic en el botón Agregar para moverlo a la lista de paquetes seleccionadosde la derecha. Al hacer clic en Aceptar en el cuadro de diálogo, los nombres de los paquetesseleccionados aparecerán en el campo de datos.

• Ciclo de vida: en el cuadro de lista, elija el ciclo de vida que desea aplicar a los paquetesseleccionados.

• Estado inicial: escriba el nombre del estado del ciclo de vida en el que se colocarán los paquetesseleccionados.

• Alcance: seleccione el alcance que se utilizará para resolver los alias asociados con el ciclo devida seleccionado.



Vuelta al estado anterior del ciclo de vidaLas actividades basadas en esta plantilla vuelven uno o varios paquetes a un estado anterior en el ciclode vida asociado. Puede volver los paquetes al estado original (el primero de la lista ordenada) o acualquier estado anterior que identifique mediante el nombre.

• Paquetes para volver al estado anterior: haga clic en el botón ... para mostrar un cuadro de diálogoen el que podrá seleccionar los paquetes de proceso que desea volver a un estado de ciclo de vidaanterior. Para cada paquete que desee volver a un estado anterior, resalte el nombre del mismoen la lista de la izquierda y haga clic en el botón Agregar para moverlo a la lista de paquetesseleccionados de la derecha. Al hacer clic en Aceptar en el cuadro de diálogo, los nombres de lospaquetes seleccionados aparecerán en el campo de datos.

• Volver al estado: para volver los paquetes seleccionados a un estado específico, escriba el nombredel estado en este campo. Si deja este espacio en blanco, se devuelve al estado anterior.

• Volver al estado original: para volver los paquetes seleccionados al estado original del ciclo devida, seleccione la opción Sí.

Promoción de ciclo de vidaLas actividades basadas en esta plantilla promueven uno o varios paquetes a un estado posterioren el ciclo de vida asociado.

• Paquetes para promover: haga clic en el botón ... para mostrar un cuadro de diálogo en el que podráseleccionar los paquetes de proceso que desea promover a un estado de ciclo de vida posterior. Paracada paquete que desee promover, resalte el nombre del mismo en la lista de la izquierda y hagaclic en el botón Agregar para moverlo a la lista de paquetes seleccionados de la derecha. Al hacerclic en Aceptar en el cuadro de diálogo, los nombres de los paquetes seleccionados apareceránen el campo de datos.

• Promover al estado: escriba el nombre del estado de ciclo de vida al que desea promover lospaquetes seleccionados. Si se deja en blanco, el paquete se devuelve al estado anterior.

• Forzar promoción: cada estado del ciclo de vida tiene un conjunto de criterios de entrada quenormalmente un documento debe cumplir para poder promoverse a dicho estado. Sin embargo, laplantilla de actividad Promoción de ciclo de vida permite "forzar" la promoción de un paqueteaunque no cumpla los criterios de entrada del estado. Seleccione la opción Sí para promover lospaquetes seleccionados independientemente de que cumplan los criterios de entrada del estado.

Publicar en el tema de JMSPuede enviar contenido mediante Java Message Service (JMS) de dos formas: enviándolo a una colade JMS o publicándolo en un tema de JMS. Utilice esta plantilla de actividad para crear actividadesque publican el contenido en los temas de JMS.

• Clase de fábrica de contexto inicial de JNDI: este parámetro obligatorio proporciona un nombre declase descriptivo de la clase de fábrica de contexto inicial de JNDI.

• URL del proveedor de JMS: este parámetro obligatorio proporciona la dirección URL completapara conectarse al proveedor de JMS.

• Nombre JNDI de la fábrica de conexiones de temas: este parámetro obligatorio ofrece el nombreJNDI de la fábrica de conexiones de temas para el proveedor JMS especificado.



• Nombre del tema: este parámetro obligatorio proporciona el nombre del tema en el que deseapublicar el contenido.

• Publicar contenido del paquete de actividades: este parámetro opcional identifica qué contenidoenvía la actividad a la dirección URL especificada. El valor es el nombre de uno de los paquetesentrantes de la actividad. Si no proporciona un valor, la actividad envía el contenido del primerpaquete entrante (el paquete en el índice 0). Puede enviar el contenido de un único paquete.

SMTPEsta plantilla de actividad se utiliza para enviar contenido a través del correo electrónico. Susparámetros definen el contenido del mensaje, la dirección a la que se envía y el servidor SMTP usadopara enviar el correo.

Cuando se envía contenido con el correo, los archivos de contenido se entregan como anexos delmensaje.

• Para: este parámetro obligatorio es la dirección de correo electrónico del destinatario, que incluyetanto el nombre de usuario como el nombre del dominio (usuario@dominio). Puede incluir variosdestinatarios separados por comas.

Haga clic en el botón de punto suspensivo (...) para mostrar el Cuadro de diálogo Variable desustitución y elegir las variables en tiempo de ejecución.

• CC y CCO: estos parámetros opcionales muestran los destinatarios adicionales del mensaje decorreo electrónico, con el mismo formato que el parámetro Para.

• De: este parámetro obligatorio es la dirección de correo electrónico del remitente, que se muestra enel campo De del mensaje enviado.

• Responder a: la dirección a la que se envían las respuestas a este mensaje. Utilice este parámetropara dar formato a la dirección de respuesta, de modo que se dirija correctamente a un gestor demensajes de Process Integrator. Normalmente, la dirección de respuesta incluye variables que elservidor sustituirá en tiempo de ejecución, como por ejemplo, el ID de flujo de trabajo actual.

• Asunto: el texto que se introduce para este parámetro se muestra como la línea de asunto delmensaje enviado. Si se deja en blanco, el mensaje se entrega con una línea de asunto vacía.

• Nombre de host del servidor SMTP o IP: este parámetro obligatorio identifica el servidor SMTPusado para enviar el mensaje. Puede escribir el nombre del equipo host o su dirección IP.

• Número de puerto del servidor SMTP: este parámetro opcional identifica el número de puerto delservidor SMTP. Si no proporciona un valor, la actividad utiliza el puerto SMTP 25 estándar.

• Nombre de usuario de autenticación del servidor SMTP y Contraseña de autenticación del servidorSMTP: si el servidor SMTP solicita un nombre de usuario y una contraseña, deberá proporcionarlos.

• Adjuntar contenido desde los paquetes de actividad: este parámetro opcional identifica quécontenido incluye la actividad como anexos al mensaje de correo electrónico. El valor son losnombres de uno o varios paquetes entrantes de la actividad, separados por comas. Si no proporcionaun valor, la actividad envía el contenido del primer paquete entrante (el paquete en el índice 0).

• Anexar todo el contenido de los paquetes de carpeta: si alguno de los paquetes que se envíancontiene objetos de carpeta, la actividad puede enviar todos los documentos de la carpeta (Sí) uomitir la carpeta (No). Si hace clic en Sí, la actividad anexa directamente sólo dichos documentosdentro de la carpeta. No anexa de forma recursiva los documentos de ninguna otra subcarpeta.



• Anexar la URL a los documentos del mensaje: permite mostrar la URL como parte del cuerpodel mensaje de correo electrónico.

• Anexar la URL a los paquetes de actividad del mensaje: permite a un usuario agregar paquetes ymostrar la URL correspondiente en el cuerpo del mensaje de correo electrónico.

• Anexar la URL a los anexos de flujo de trabajo del mensaje: permite a un usuario agregar una URLde anexo en el cuerpo del mensaje de correo electrónico.

• Utilizar la URL predeterminada a Webtop: seleccione No para permitir a los usuarios utilizar unaURL distinta de la URL de Webtop predeterminada.

• Proporcionar el prefijo de la URL si no utiliza el predeterminado: si no utiliza la URL de Webtoppredeterminada, escriba el prefijo de la URL que se va a utilizar en el cuerpo del mensaje de correoelectrónico.

• Proporcionar el sufijo de la URL si no utiliza el predeterminado: si no utiliza la URL de Webtoppredeterminada, escriba el sufijo de la URL que se va a utilizar en el cuerpo del mensaje de correoelectrónico.

Enviar a la cola de JMS

Puede enviar contenido mediante Java Message Service (JMS) de dos formas: enviándolo a una colade JMS o publicándolo en un tema de JMS. Utilice esta plantilla de actividad para crear actividadesque se envían a colas de JMS.

Nota: Utilice Enviar a MQ JMS para enviar mensajes a una cola cuando IBM MQ Series sea elproveedor JMS.

• Clase de fábrica de contexto inicial de JNDI: este parámetro obligatorio proporciona un nombre declase descriptivo de la clase de fábrica de contexto inicial de JNDI.

• URL del proveedor de JMS: este parámetro obligatorio proporciona la dirección URL completapara conectarse al proveedor de JMS.

• Nombre JNDI de la fábrica de conexiones de colas: este parámetro obligatorio ofrece el nombreJNDI de la fábrica de conexiones de colas para el proveedor de JMS especificado.

• Nombre de cola: este parámetro obligatorio proporciona el nombre de la cola a la que deseaenviar el contenido.

• Responder al nombre de cola: este parámetro opcional proporciona el nombre de la cola de JMS a laque se envía cualquier mensaje de respuesta.

• ID de correlación de mensajes: Process Integrator le permite especificar la manera en la que segestionarán los mensajes entrantes. El ID de correlación de mensajes es el ID que utilizará ProcessIntegrator para identificar mensajes de respuesta a este mensaje saliente.

• Enviar contenido del paquete de actividad: este parámetro opcional identifica qué contenido envía laactividad a la dirección URL especificada. El valor es el nombre de uno de los paquetes entrantes dela actividad. Si no proporciona un valor, la actividad envía el contenido del primer paquete entrante(el paquete en el índice 0). Puede enviar el contenido de un único paquete.



Enviar a MQ JMS

Utilice esta plantilla de actividad para enviar contenido mediante Java Message Service (JMS) conIBM MQ Series como proveedor JMS. Se requieren todos los parámetros.

Nota: Utilice Enviar a la cola de JMS para enviar mensajes a una cola de JMS con un proveedor JMSque no sea IMB MQ Series.

• Servidor: dirección IP o nombre descriptivo del equipo en el que se ejecuta WebSphere MQ.

• Puerto: puerto en el que escucha el gestor de cola. El número predeterminado es 1414.

• Gestor de cola: nombre del gestor de cola de WebSphere. El nombre distingue entremayúsculas y minúsculas. En la mayoría de los casos, el nombre tiene la formaWAS_nombrenodo_nombreservidor.

• Nombre de cola de trabajo: nombre de la cola a la que desea enviar el contenido. La cola debegestionarla el gestor de cola especificado. El nombre de la cola tiene la forma WQ_nombrecola.Para localizar el nombre de la cola nombrecola, seleccione Servers (Servidores) > ApplicationServers (Servidores de aplicaciones) > nombreservidor > Server Component (Componente deservidor) > Queue names (Nombres de cola) en WebSphere MQ.

• Nombre de canal: el nombre de la conexión de servidor cambiada que se crea en WebSphere MQpara conectar a MQ.

• Solicitar paquete: este parámetro identifica el contenido que la actividad envía a la cola especificada.El valor es el nombre de uno de los paquetes entrantes de la actividad. Sólo se puede enviarel contenido de un paquete.

Iniciar subproceso

La actividad Invocar proceso inicia un flujo de trabajo nuevo. Todos los paquetes del flujo de trabajoactual cuyos nombres y tipos coincidan con los paquetes de la plantilla de proceso del nuevo flujode trabajo se pasarán al nuevo flujo de trabajo. La actividad se completará cuando se inicie el nuevoflujo de trabajo.

Aunque el nuevo flujo de trabajo es un subproceso lógico del flujo de trabajo que lo inicia, no hayninguna relación formal entre los objetos de ambos flujos de trabajo, que son independientes. Si deseapausar el flujo de trabajo actual hasta que se complete el subproceso, defina la siguiente actividad paraque se desencadene como respuesta a un evento (en la ficha Desencadenador) e incluya una actividaden el subproceso, basada en la plantilla de actividad Publicar evento en proceso padre, que envíe elevento que espera el proceso principal.

• Iniciar este flujo de trabajo como subproceso: en el cuadro de lista, seleccione la plantilla de procesoque se utilizará para el nuevo flujo de trabajo. Los paquetes obligatorios de la plantilla seleccionadadeben coincidir con los paquetes del flujo de trabajo actual tanto en nombre como en tipo. Lacoincidencia se aplica a todos los paquetes definidos, no sólo a los visibles.

• Supervisor del subproceso: seleccione el usuario que actuará como supervisor del nuevo flujode trabajo.



EjemploLa ventana Ejemplo contiene una plantilla de actividad de ejemplo que muestra los diferentes tiposde controles de interfaz de usuario disponibles para los paneles de entrada de datos de actividadpersonalizados. Además de la plantilla de actividad de ejemplo, la ventana Ejemplo incluye dosplantillas de actividad relacionadas con la gestión de colas:

Consulte la guía Documentum Webtop User Guide para obtener más información sobre la gestión decolas.

Decisión de repasar tarea de la cola

Esta plantilla de actividad de ejemplo se utiliza para crear actividades que realicen controles de calidadperiódicos sobre los documentos procesados mediante una cola de trabajo. La definición de una colade trabajo incluye una política que especifica un porcentaje de documentos que se deben distribuir aotro procesador para el control de calidad.

Al igual que la plantilla de actividad Decision Split (División de la decisión), la plantilla Decisiónde repasar tarea de la cola crea actividades cuya única acción consiste en evaluar la lógica deramificaciones y reenviar los paquetes según corresponda. Una actividad basada en la plantillaDecisión de repasar tarea de la cola distribuye los paquetes a la siguiente actividad de revisión o a lasiguiente actividad sin revisión. Determina a qué actividad se distribuye cada paquete basándose endos factores: (a) el control de calidad porcentual especificado en la política de cola de trabajo asociadaa la actividad para comprobar, y (b) el parámetro de nivel de habilidad necesario.

• Actividad para comprobar: este parámetro obligatorio especifica la actividad que realiza elprocesamiento inicial de los documentos. El tipo de ejecutante de esta actividad debe tener lacategoría 10 (cola de trabajo). Introduzca el nombre de la actividad.

• Nivel de habilidad necesario: el nivel de habilidad de los ejecutantes cuyo trabajo se deberíacomprobar. El intervalo de valores válidos va de 0 (principiante) a 10 (avanzado).

• Nombre de la siguiente actividad de revisión: este parámetro obligatorio especifica la actividad querealiza el control de calidad. Introduzca el nombre de la actividad.

• Nombre de la siguiente actividad sin revisión: este parámetro obligatorio especifica la actividada la que se distribuirán los documentos que no precisan control de calidad. Introduzca el nombrede la actividad.

La lógica de distribución para cada paquete es:

1. Si el valor del control de calidad porcentual de la actividad para comprobar es cero, el paquete sedistribuye a la siguiente actividad sin revisión.

2. Si el ejecutante que gestionó este paquete en la actividad para comprobar tiene un nivel dehabilidad inferior al valor del parámetro del nivel de habilidad necesario, el paquete se distribuye ala siguiente actividad de revisión.

3. Todos los paquetes restantes se distribuyen a la siguiente actividad de revisión y siguiente actividadsin revisión en el porcentaje especificado por el valor del control de calidad porcentual. Porejemplo, si el control de calidad porcentual es 20%, uno de cada cinco documentos se distribuye ala siguiente actividad de revisión.



Plantilla de actividad de ejemplo

Process Builder incluye también una plantilla de actividad de ejemplo que muestra el formato delarchivo XML de una plantilla de actividad a fin de que le sirva de ayuda para crear plantillas deactividades personalizadas y aparece en la carpeta de plantillas de actividades de ejemplo. La guíaDocumentum Process Builder Development Guide proporciona información detallada sobre cómoutilizar la plantilla de actividad de ejemplo.

Definir habilidad para tarea de cola

Las actividades creadas a partir de esta plantilla establecen el nivel de habilidad del ejecutante para undeterminado paquete. Este valor del nivel de habilidad anula cualquier otro requisito anterior sobreel nivel de habilidad para el paquete.

En una situación normal, la actividad que precede a la actividad de Definir habilidad para tarea decola tiene una condición de transición que comprueba los atributos del paquete para determinar si ésterequiere un tratamiento especial. Los paquetes que requieren un tratamiento especial se distribuyen a laactividad de Definir habilidad para tarea de cola, mientras que todos los demás omiten esta actividad.

• Nombre del paquete: nombre del paquete para el que la actividad establece el nivel de habilidad delejecutante requerido.

• Nivel de habilidad: nivel de habilidad para aplicar al paquete. Los valores válidos aparecen en uncuadro de lista.


Capítulo 12Uso de variables de sustitución enactividades personalizadas


• Utilizando variables de sustitución para propiedades de plantillas de actividad personalizadas

Utilizando variables de sustitución parapropiedades de plantillas de actividadpersonalizadasAl escribir valores en los campos de una ficha personalizada en el Inspector de actividades, el usuariopuede incluir variables que se sustituyan en el tiempo de ejecución por valores del entorno actual,como el nombre del flujo de trabajo o el ejecutante de la tarea. La variable puede ser el único valordel campo, o bien puede aparecer dentro de una cadena más larga que contenga texto literal, otrasvariables de sustitución o una combinación de ambos.

Nota: La sustitución de la variable sólo está disponible en los campos cuyos tipos de datos seanCadena.

Para incluir una variable, escriba <dmp:param>variable_admitida</dmp:param>, dondevariable_admitida es una de las variables que figuran en la siguiente tabla. Cada variable se componede dos partes separadas por un punto: un tipo de parámetro, que identifica el tipo del objeto delcual se deriva el valor, y un nombre de atributo, que identifica el valor específico que se insertaen tiempo de ejecución. Por ejemplo, la variable <dmp:param>workflow.creator</dmp:param> sereemplazará en tiempo de ejecución por el valor del atributo creador del objeto de flujo de trabajo. Siel atributo seleccionado tiene varios valores, la variable de sustitución también incluye un índice paraespecificar cuál de ellos se utilizará.

Si un campo tiene un botón de puntos suspensivos (...) junto a él, podrá seleccionar la variable enun cuadro de diálogo, en lugar de escribirla. Una vez cerrado el cuadro de diálogo, Process Builderinserta la variable seleccionada en la posición actual del cursor.

Para insertar una variable de sustitución mediante el cuadro de diálogo:

1. Coloque el cursor en la ubicación del campo donde desea insertar la variable.2. Haga clic en el botón de puntos suspensivos (...) situado junto al campo.

Aparecerá el Cuadro de diálogo de la variable de sustitución.3. En el cuadro de lista Tipo de parámetro, seleccione el tipo de objeto o el nombre del paquete que

contenga el valor deseado.La lista Atributo muestra los atributos disponibles para el elemento seleccionado. O bien, siselecciona "alias" como tipo de parámetro, aparecerán las listas Conjunto de alias y Nombre dealias.


Uso de variables de sustitución en actividades personalizadas

4. Si seleccionó "alias" como tipo de parámetro, elija un conjunto de alias en el cuadro de listaConjunto de alias y, a continuación, seleccione un alias concreto en la lista Nombre de alias.

5. Si seleccionó cualquier otro tipo de parámetro en lugar de "alias", utilice la lista Atributo paraelegir el atributo cuyo valor desea incluir en la cadena.

6. Si el atributo que seleccionó en el paso 5 puede tener varios valores, seleccione FIRST (primero) oLAST (último) en la lista Índice para indicar cuál de ellos se utilizará.Si desea utilizar el valor de una posición de índice distinta de la primera o la última, una vezcerrado el cuadro de diálogo, edite la variable para reemplazar FIRST o LAST por un valor entero.La posición FIRST es equivalente a la posición 0 del índice.

7. Haga clic en Aceptar para cerrar el cuadro de diálogo.Process Builder inserta la variable seleccionada en la ubicación actual del cursor.

Tabla 19 Variables de sustitución admitidas para los campos de configuración de actividades

Variable Descripciónworkflow.creator El nombre de usuario de la persona que creó el

flujo de trabajo

workflow.instructions El texto del cuadro de texto Instruccionesde flujo de trabajo en el cuadro de diálogoPropiedades de proceso.

workflow.id El ID del flujo de trabajo

workflow.name El nombre del flujo de trabajo

workflow.process_id El ID de la plantilla de proceso a partir de la cualse generó el flujo de trabajo

workflow.start_date La fecha en la que se inició el flujo de trabajo

workflow.supervisor El nombre de usuario de la persona identificadacomo el supervisor del flujo de trabajo (elcreador predeterminado del flujo)

workflow.supervisor_address La dirección de correo electrónico del supervisordel flujo de trabajo

task.act_id El ID de la actividad que generó la tarea actual

task.number El número de secuencia dentro del flujo detrabajo de la actividad que generó la tarea

task.auto_method_id ID de la definición de método de unaactividad automática. Si la tarea no tiene unaactividad automática, el valor de la variable es"0000000000000000".

task.creation_date El formato de fecha se determina por el patrónde tiempo predeterminado definido en DFC.

task.due_date El formato de fecha se determina por el patrónde tiempo predeterminado definido en DFC. Sila tarea no tiene una fecha de vencimiento, elvalor de la variable es "nulldate"

task.performer El ejecutante de la tarea

task.performer_address La dirección de correo electrónico del ejecutantede la tarea



Variable Descripcióntask.priority El valor de prioridad asignado a la tarea

task.state El estado actual de la tarea, representado comoun entero

packagename.atributo El valor de cualquier atributo de valor únicoespecificado por packagename. Al seleccionar lavariable en el Cuadro de diálogo de la variablede sustitución, éste muestra todos los atributospersonalizados y un subconjunto de los atributosdm_document estándar más utilizados. Noobstante, puede utilizar cualquier atributo

packagename.atributo[índice] El valor de cualquier atributo de varios valoresespecificado por packagename. El índiceidentifica el valor que se utiliza: FIRST(primero), LAST (último) o un número enteroque indique una posición en la lista de valores.Al seleccionar la variable en el Cuadro dediálogo de la variable de sustitución, estemuestra todos los atributos personalizados yun subconjunto de los atributos dm_documentestándar más utilizados. No obstante, puedeutilizar cualquier atributo

doc.id El ID del primer documento del primer paqueteprocesado por la actividad

doc.name El nombre del primer documento del primerpaquete procesado por la actividad

note.id El ID de la primera nota anexa al documento,si hay alguna

note.writer El nombre de la persona que creó la nota

note.text El texto de la nota

note.creation_date La fecha en la que se creó la nota

alias.nombre_alias o alias.conjunto_alias.nombre_alias Alias del sistema, donde nombre_alias identificael alias que desea resolver. Si incluye elparámetro opcional conjunto_alias, el servidorutiliza el alias del conjunto de alias especificado

VarName o VarName.<attribute value> El valor de la variable de proceso




Capítulo 13Archivo de configuración de ProcessBuilder


• Archivo de configuración de Process Builder

Archivo de configuración de Process BuilderProcess Builder tiene un archivo de configuración que controla determinados aspectos de su interfaz deusuario. El archivo bpmconfig es un archivo XML que reside en la carpeta \System\Workflow\Config.Este archivo controla:

• Si Process Builder permite a los usuarios definir el tipo de objeto o la versión de los paquetes.

• El lugar del repositorio en el que los usuarios pueden guardar las plantillas de proceso.

• Si Process Builder exige nombres exclusivos para las plantillas de proceso.

• El número de nombres de plantillas de procesos que aparecen en la lista de archivos recientesdisponible en el menú Archivo.

En la tabla siguiente se describen los parámetros del archivo de configuración. Para modificar un valor,edite el archivo con un editor de texto y cambie los valores que sean necesarios.

Tabla 20 Parámetros de bpmconfig

Parámetro Descripción Valorpredeterminado

unique-template-name Se establece como verdadero para exigir que los nombresde las plantillas de procesos sean únicos en el repositorio

falso

show-package-version Especifica si Process Builder permite que los usuariosseleccionen la versión de un paquete. Si se establece enfalso, el proceso utiliza siempre la versión CURRENT

verdadero

show-package-type Especifica si Process Builder permite que los usuariosdefinan explícitamente la versión de un paquete. Si seestablece en falso, Process Builder utiliza el tipo deobjeto asociado a la plantilla de formulario seleccionadao dm_sysobject si no se ha seleccionado ningunaplantilla de formulario

verdadero


Archivo de configuración de Process Builder

Parámetro Descripción Valorpredeterminado

max-recent-file Define el número máximo de nombres de archivo queaparecen en la lista de archivos recientes

5

template-save-path Si existe este parámetro, Process Builder exige a losusuarios que guarden las plantillas de proceso enla carpeta o subcarpeta especificada; si no existe elparámetro, los usuarios pueden guardar las plantillasde proceso en cualquier carpeta para la que tengan unacceso de seguridad adecuado

Ninguno


ÍndiceAA inferior, función, 154A superior, función, 154actividad, ventana plantilla deagregar plantillas, 98

actividadesactivar delegación, 25, 107ajustar a la cuadrícula, 53alinear, 52anular, 69asuntos de tareas, 26cambiar la configuración de vista, 136condición de desencadenamiento, 34conectar, 87controlador de errores, 15copiar, 51de repetición, 120definir desencadenadores, 119descripción, 14ejecutantes, 21espera de mensaje, 15funciones de ejecutante, 22inicio, 15intervalos de reintento, 108mover, 51pegar, 51planificar, 21seleccionar con condiciones, 37sustituir, 52tipos de transición, 36

actividades automáticasatributos, 14ejecutantes válidos, 118parámetros de ejecución, 107valores de prioridad, 27

actividades de comienzo, 14actividades de control de errores, 87actividades de entradahabilitar servicios Web, 73

actividades de espera de mensaje, 14–15actividades de finalización, 14actividades de inicio, 14–15actividades del controlador de errores,14–15, 61actividades entrantesconjuntos de correlaciones, 73depurar, 163número de puerto, 43

actividades intermedias, 14actividades manualesalias como ejecutantes, 24atributos, 14delegación, 25ejecutantes válidos, 21extensión, 25

actualizaciones de BAM, 44Actualizar definiciones de datos de BAM,opción, 44

agregar categorías, 46Agregar día laboral, función, 151Agregar Días, función, 151Agregar, función, 151ajustar a la cuadrícula, 53algunos usuarios de un grupo, 22aliasalias de ejecutantes, 123crear conjuntos de alias, 24usar en el flujo de trabajo, 24

alinear actividades, 52almacenar nombres de documentos, 63anular actividades, 69Aplicar a todos los seleccionados (opción),87, 104Aplicar ciclo de vida, plantilla de actividad,180, 238Archivo, menú, 40asignación de datosatributos de repetición, 149atributos de un solo valor, 149funciones, 151procedimiento, 146usar conjuntos de correlaciones, 155usar funciones, 150

Asignación de datos de procesos (plantillade actividad), 224asignar datos, Consulte asignación dedatosasignar ejecutantes, 110asignar ejecutantes ahora, 111Asistente para plantilla de notificación, 131Asistente para tipo de datos estructurado, 48Asistente para tipos de datosestructurados, 46atributo task_subject, 26atributos, 141atributos de repeticiónasignar, 149asuntos de tareas, 26condiciones de transición, 129

Bbarra de herramientas, 39–40barra de herramientas de flujo de trabajo, 40barra de herramientas de vista, 40Base de datos entrante, plantilla deactividad, 187Business Activity Monitor, Consulte BAMBuzón HTTP, plantilla de actividad, 238

CCadena a byte, función, 153Cadena a fecha, función, 153caducidad de las tareas, 27


Índice

calendarios, 121calendarios de proceso, 72, 121carpetascompartir proceso, 42crear a partir de plantillas, 181gestionar, 98

carpetas de la plantilla de actividadesagregar, 43

carpetas de plantilla de actividadquitar plantillas de actividad, 98

carpetas de plantillas de actividadquitar, 43quitar plantillas de actividad, 98

categorías, 46Ciclo de vida, volver al estado anterior,plantilla de actividad, 239cola de trabajo, 23compartir plantillas de proceso, 41compartir proceso, carpetas, 42Concatenar, función, 151condiciones de transición, 35–37, 126,128, 130configuración de página, 84configuración de vistacambiar, 136

conjunto de alias predeterminado, 62, 113conjunto de habilidades, 117conjunto de habilidades de cola, 117conjuntos de aliasespecíficos, 113predeterminados, 113

conjuntos de correlacióncrear, 73

conjuntos de correlacionesdefinidos, 155usar, 157

copiar actividades, 51Copiar, función, 151correlación de mensajesconjuntos de correlaciones , 157identificadores de correlación , 156

correlación de mensajes campos deconfiguración, 156correlación de mensajes definida, 155Correo electrónico entrante, plantilla deactividad, 207Crear evento de iCalendar, plantilla deactividad, 186crear la plantilla de actividad LCA, 185Crear Plantilla de actividad de carpeta, 175

Ddatos, 141Datos (ficha), 104datos de ejecución, 17datos de paquetes, 17datos de proceso

asignación al conjunto de habilidadesde cola de trabajo, 117definir, 31definir parámetros de proceso, 32definir variables de proceso, 32descritos, 16gestionar, 134

datos de procesosdefinir paquetes, 31

datos, asignarentrada, contexto, 150

De byte a cadena, función, 151Decisión de repasar tarea de la cola,plantilla de actividad, 243Decisiones, dividir (plantilla de actividad), 182definiciones de datos, 44definir alias de ejecutante, 113definir ejecutantes, 109Definir habilidad para tarea de cola,plantilla de actividad, 244delegación, 107activar, 25actividades manuales , 25en cascada, 107

delegación en cascada, 25depurador de proceso, 159depurar procesosactividad de inicio manual , 162agregar puntos de quiebre, 161continuar hasta el siguiente punto dequiebre, 164definir número de puerto, 43detener, 164elementos gráficos, 161entorno, 167información general, 159iniciar un flujo de trabajo, 162obligar a completar la tarea , 165pasar a una actividad, 164pasar a una actividad automática, 164salir, 164tareas automáticas, 165Task Manager, ficha, 165volver a ejecutar una sesión dedepuración, 164

desencadenadoresdefinir, 34, 119eventos, 34

desinstalarplantillas de actividad, 100–101

desinstalarplantillas de proceso, 77determinar ejecutantes, 110disponibilidad del flujo de trabajo, 25Dividir, función, 152–153dm_changedactivityinstancestate, 64, 131dm_delegatedworkitem, 64, 131dm_startedworkitem, 64, 131dm_WfmsTimer, trabajo, 35


Índice

dm_workflow, 26dmi_package, 26dmi_queue_item, 26dmi_workitem, 26Documento de publicación xPression:plantilla de actividad avanzada, 233Documento de xPression Publish, plantillade actividad, 232DQL entrante, plantilla de actividad, 190

EEditar, menú, 40editor de plantillas del proceso; panelnotas de texto, 51

Ejecutante (ficha), 103, 106, 109, 118ejecutante de la actividad anterior, 22ejecutantesalias, 113, 123automáticos , 106, 118determinar en tiempo de ejecución, 23elegir, 21funciones, 22manuales , 106, 109selección según datos de proceso, 116seleccionar basándose en condiciones, 114usar delegación y extensión, 25

ejecutantes automáticoselegir, 106, 118

ejecutantes automáticos tareas, 106

ejecutantes condicionales, 110, 114ejecutantes manualesalgunos usuarios de un grupo, 109cola de trabajo, 109definir ejecutantes, 109ejecutante de la actividad anterior, 109elegir, 106, 109propietario del repositorio, 109selección según datos de proceso, 110seleccionar basándose en condiciones, 110supervisor de flujo de trabajo, 109todos los miembros de un grupo, 109un solo usuario del grupo, 110usuario específico, 109usuario único de un grupo, 109varios ejecutantes secuenciales, 109–110

ejemplo, plantillasDecisión de repasar tarea de la cola, 243Definir habilidad para tarea de cola, 244

elegirejecutantes automáticos, 118ejecutantes manuales, 109

elementos de trabajo, 14eliminar objetos, 51Enlazar a carpeta, plantilla de actividad, 180entorno de depuración de procesos, 160enumeración, 143

Enviar a la cola de JMS, plantilla deactividad, 241Enviar a MQ JMS, plantilla de actividad, 242Escribir base de datos, plantilla deactividad, 197Escribir DQL, plantilla de actividad, 192esquemas XMLagregar a mensajes, 143utilizar en tipos de datos estructurados, 50

Esquemas XMLen Inspector de plantilla de actividad, 99

estado borrador, 59, 97estado instalado, 59, 97estado validado, 59, 97eventos de calendario, 186exportar plantillas de proceso, 82extensión, 25

Ffallodefinir tiempos de espera del método, 108opciones de ejecución, 108opciones de reintento, 108

Fecha a cadena, función, 152ficha Avanzada, 70Ficha Datos, 64Ficha Desencadenador, 103ficha General, 62Ficha Notificación, 104Ficha Propiedades, 103Ficha Temporizadores, 104Ficha Transición, 104Ficha Visualización, 104fichasInspector de actividad, 99suprimir la presentación de, 100ver, 55

firmas digitales, 27flujo, plantillasIniciar subproceso, 242Publicar evento en proceso padre, 184Transformación XSL, 184Unir, 183

flujosagregar controladores de errores, 87avance, 18controlador de errores , 18descripción, 87Inspector de flujo, 87mostrar configuración, 88rechazo, 18

flujos de trabajopaquetes, 31planificar, 18variables de proceso, 32

flujos de un solo segmento, 87flujos de varios segmentos, 87


Índice

formato, 141Forms Builder, 15, 33, 66, 72, 106formulariosagregar, 66agregar a procesos, 144agregar a un paquete, 33agregar a una actividad, 134crear formularios de alta fidelidad, 144esquemas, 144propiedades, 66rellenar con XML, 144seleccionar, 72, 106

FTP entrante, plantilla de actividad, 210FTP saliente, plantilla de actividad, 212FTP, plantilla de actividad, 237funciones, 150–151, 195

Gguardar plantillas de proceso, 74

Hherramienta de asignación de datosagregar nodos condicionales, 146agregar propiedades de mensaje, 142agregar un esquema XML, 143asignar datos, 146atributos de paquete, 141editar datos de proceso, 141editor de funciones, 150información general, 139usar atributos de repetición, 149

HTTP entrante, plantilla de actividad, 218HTTP saliente, plantilla de actividad, 220HTTP/Número de puerto de WebServiceInbound, 43

IiCalendar, 186iconos, 40iconos de la barra de herramientas, 40ICS, eventos de calendario, 186ID de correlación, 156IDfModule, interfaz, 29importaresquema XML, 229plantillas de proceso, 81

imprimir plantillas de proceso, 84información generalsobre flujos de trabajo, 11

informesactualizar datos de proceso, 44actualizar definiciones de BAM, 49exponer paquetes, 67, 135exponer tipos de datos estructurados, 49

exponer variables de proceso, 32habilitar, 17subprocesos, 91

informes de BAMactualizar datos de proceso, 44actualizar definiciones de BAM, 49exponer paquetes, 67, 135exponer tipos de datos estructurados, 49habilitar, 17subprocesos, 91

iniciar automáticamente paquetes, 135iniciar automáticamente un paquete, 135Iniciar subproceso, plantilla de actividad, 242Inspector de actividades, 103Inspector de flujos, 87Inspector de notas, 54Inspector de plantilla de actividadconfigurar, 99crear una nueva plantilla, 97ficha Definición, 99

Inspector de plantillas de actividadcrear una nueva plantilla, 97

Inspector de subproceso, 92Inspector de subprocesos, 93instalarplantillas de actividad, 101plantillas de proceso, 75

instalar plantillas de actividad, 100instalar plantillas de proceso, 77instrucciones de flujo de trabajo, 62integración, plantillasBase de datos entrante, 187Base de datos, escritura de, 197Buzón HTTP , 238Correo electrónico entrante, 207Datos de procesos, asignación, 224Enviar a la cola de JMS, 241Enviar a MQ JMS, 242FTP, 237FTP entrante, 210FTP saliente, 212HTTP entrante, 218HTTP saliente, 220JMS entrante, 221JMS saliente, 223Leer base de datos, 193Publicar en el tema de JMS, 239SMTP, 240SMTP, actividad, 225

intervalos de reintento, 108Invocar proceso, plantilla de actividad, 177IWQTaskPriority, interfaz, 29

JJMS entrante, plantilla de actividad, 221JMS saliente, plantilla de actividad, 223


Índice

LLCAasignar a una variable, 68establecer, 70permisos mínimos, 70seleccionar, 71sistema, 71usuario, 71

Leer base de datos, plantilla de actividad, 193Leer DQL, plantilla de actividad, 191Leer FTP, plantilla de actividad, 214Listas de control de acceso, Consulte LCA

Mmarcadores de posición, 226mensajesagregar esquemas XML, 143propiedades, 142

mensajes asíncronos, 15mensajes de advertencia, 44método getInitialPriority, 28métodos de flujo de trabajo automático, 166módulo de prioridad de colas de trabajo, 108módulos de prioridadasociar a una actividad, 108definidos, 28ejemplo, 29

mostrar configuraciónflujos, 88

Mostrar ficha, 88mover actividades, 51Multiplicar, función, 153

NNavegador, 56nodosagregar condiciones, 146árbol de datos de proceso, 116asignar, 133, 228

nodos condicionales, 146nombre de tarea, 105–106Notificación (ficha), 130Notificación, ficha, 34notificacionescrear, 36, 130de temporizadores, 123plantillas de correo electrónico, 63valores predeterminados, 122

notificaciones del supervisor, 34, 130notificaciones por correo electrónico, 36notificar al supervisor, 34, 130Nuevo caso con plantilla (plantilla deactividad), 181

Oobjetoseliminar, 51seleccionar, 51

Obligar a completar la tarea, botón, 165Obtener Año, función, 153Obtener Día, función, 152Obtener dirección de correo electrónico,función, 152Obtener Mes, función, 152Obtener tiquet (función), 152Obtener valor, función, 152opción continuar ejecución, 108opción detener ejecución, 108opción finalizar ejecución, 108

Ppanel del editor de plantillas del procesodescrito, 51

paquetesagregar a la plantilla, 64almacenar nombres de documentos, 63atributos, 141definir, 31exponer para informes, 67iniciar automáticamente, 135mostrar atributos adicionales, 141obligatorios, 67

parámetros de procesoadministrar, 33definir, 32gestionar, 68información general, 32tipo, 69

Pasar a la siguiente actividad, botón, 164Pasar a, botón, 164pegar actividades, 51permisos, 70pista de auditoríaconfigurar, 62

plantilla de actividad de FS2, 176plantilla de actividad de módulo BOF, 174plantilla de actividad de procedimientoalmacenado de base de datos, 195plantilla de actividad de servicio web, 231plantilla de actividad Dynamic WebService, 199plantilla de actividad entrante de servicioWeb, 228plantilla de actividad FAX saliente, 215plantilla de actividad Vuelta al estadoanterior del ciclo de vida, 178plantilla de actividad, ventanacopiar plantillas personalizadas, 98

plantilla de LCA, 185plantilla de procesoDatos (ficha), 65


Índice

plantillas de actividadconfigurar, 99copiar, 98crear, 21, 97definir preferencias, 43desinstalar, 100–101estados, 46instalar, 100–101mostrar preguntas, 44mostrar preguntas de validación einstalación, 44validar, 100

plantillas de actividadesubicación dentro del sistema, 45

plantillas de correo electrónicocrear, 63, 122, 132para temporizadores, 63, 122seleccionar, 64

plantillas de flujoDecisiones, dividir, 182

plantillas de integraciónDynamic Web Service, 199Fax saliente, 215Invocar proceso, 177módulo BOF, 174procedimiento almacenado de base dedatos, 195servicio Web, 231

plantillas de notificación, 131plantillas de procesoabrir, 60agregar alias, 62agregar datos de proceso, 64agregar mensajes de correo electrónico, 63agregar notas, 54agregar parámetros de proceso, 69agregar un formulario, 66agregar variables de proceso, 67añadir alias, 62arquitectura, 14cambiar propiedades, 62cancelar retirada, 81compartir con Process Analyzer, 41crear, 60crear versiones, 65, 78Datos (ficha), 65descripción, 14desinstalar, 77eliminar, 81establecer el nivel de zoom, 53establecer LCA, 70estados, 59exportar, 82ficha Avanzada, 70guardar, 74importar, 81imprimir, 84instalar, 77

modificar, 78mostrar varias fichas, 55proteger, 80registrar, 78retirar, 78, 80usar el navegador, 56validar , 76volver a importar, 82

plantillas de servicios de contenidoCrear carpeta, 175plantilla de actividad de FS2, 176volver el ciclo de vida al estado anterior, 178

plantillas del procesocreación, 51

post-temporizador, 34, 93, 120pre-temporizador, 34, 93, 120Preferencias (cuadro de diálogo), 44Preferencias, cuadro de diálogo, 43, 45preguntasmostrar mensajes de advertencia, 44mostrar preguntas de instalación yvalidación, 44

presentación de informesconfiguración de pista de auditoría , 62configurar pista de auditoría, 62

presentación de informes de BAMconfiguración de pista de auditoría, 62

prioridadactividades, 27cómo la aumenta el sistema, 28definir prioridad inicial, 27establecer la prioridad estática, 28establecer prioridad dinámica, 29implementar, 29resolver, 28seleccionar niveles, 105

prioridad dinámica, 29, 105procedimiento almacenado, 195procesos de depuraciónactividad de inicio entrante , 163métodos de flujo de trabajo automático, 166tareas manuales, 165

Process Analyzercompartir procesos, 41XPDL, archivos, 42

Promoción e ciclo de vida, plantilla deactividad, 239propiedadesagregar, 26agregar a un mensaje, 142

Propiedades (ficha), 105Propiedades de proceso, 62propietario de la plantilla de proceso, 62propietario del repositorio, 22Publicar en el tema de JMS, plantilla deactividad, 239Publicar evento en proceso padre, plantillade actividad, 184


Índice

puntos de quiebre, 164

Rrechazar flujos, 87Recuento, función, 152registro de ejecución, 107reglas de transición, 126repository explorer, 98requisitos de firma, 27requisitos para cerrar sesión, 107Resource Navigator (Navegador derecursos), 39Restar, función, 154retirar procesos, 60

Sseguimiento de comprobaciónEventos de publicación de flujo detrabajo, trabajo, 236habilitar, 17subprocesos, 91

Seleccionar ejecutante, 109, 118seleccionar objetos, 51servicios de contenido, plantillaEnlazar a carpeta, 180

servicios de contenido, plantillasCiclo de vida, aplicar, 180, 238Ciclo de vida, volver al estado anterior, 239Promoción de ciclo de vida, 239

servicios Webhabilitar, 73plantilla de actividad Dynamic WebService, 199plantilla de actividad entrante de servicioWeb, 228

SMTP, actividad (plantilla de actividad), 225SMTP, plantilla de actividad, 240Subcadena, función, 153subprocesosconfigurar propiedades, 93contraer, 94eliminar, 95expandir, 94información general, 91Inspector de subproceso, 92modelado ascendente , 92modelado descendente, 92notas, 95opciones de visualización, 93quitar actividades, 94

supervisor del flujo de trabajo, 22

Ttareas

caducidad, 27Task Manager, ficha, 165TaskSpace, 33temporizadoresasociar a un calendario, 121completar tarea, 35completar una tarea, 125delegar tarea, 35delegar una tarea, 125ejecutar método Java, 35ejecutar un método Java, 124enviar notificaciones, 123iniciar proceso, 35iniciar un proceso, 124notificación, 35

Temporizadores (ficha), 93, 120temporizadores de advertencia, 34, 93, 120tipo de contenido, 141tipo de parámetro, 245tipos de datos complejos, 32, 47, 50tipos de datos de elementos, 50tipos de datos estructuradosasistente, 46atributos, 48categorías, 46De búsqueda, opción, 51editar, 49gestionar, 67grupos, 47Informe, opción, 51opción de informes, 49opción que puede buscarse, 49opción repetibles, 49Repetible, opción, 51simples, 32tipos complejos, 47, 50tipos de datos simples, 47tipos de elementos, 50utilizar un esquema XML, 50

Tipos de datos estructurados (ventana), 46tipos de datos simples, 32, 47tipos de transición, 36todas las versiones, 60todos los usuarios del grupo, 22trabajo Qm_QmPriorityAging, 28Transformación XSL, plantilla de actividad, 184Transición (ficha), 126Transition Condition Wizard, 128

Uun solo usuario del grupo, 22Unir plantilla de actividad, 183Unir, función, 153Usar formulario para propiedades, 66usuario específico, 22


Índice

Vvalidaciónmostrar preguntas, 44servidor, 100

validaciones del servidor, 100validarplantillas de actividad, 100plantillas de proceso, 76

variableseditar, 135sustitución, 174–175, 181, 189, 193,199, 245

variables de procesoagregar a un flujo, 64definidas, 17definir, 32listas de control de acceso, 68requisitos de permiso, 71tipo, 68

variables de sustitución, 245varios ejecutantes secuenciales, 23Vencimiento de post-temporizador, 64Vencimiento de pre-temporizador, 64ventana plantilla de actividadesintroducción, 45

ver procesos, 60Ver, menú, 40versiones, 65–66versiones actuales, 60vista de varias fichas, 55vista preliminar, 84–85Visualización (ficha), 136Visualización, ficha, 93Volver a ejecutar la depuración, botón, 164volver a importar plantillas de proceso, 82

XXDPL, archivos, 41XPDLauditoría, 81exportar, 82volver a importar, 82

XSD, archivo, 50

Zzoom; opciones, 53
