guía del usuario p/n 300-008-167-a01...expandir y contraer un subproceso..... 111 quitar...

EMC® Documentum®

Process BuilderVersión 6.5 SP1

Guía del usuario

P/N 300-008-167-A01

EMC CorporationSede principal:

Hopkinton, MA 01748-91031-508-435-1000

www.EMC.com

Copyright © 2004 - 2008 EMC Corporation. Reservados todos los derechos.

Publicado en diciembre de 2008

EMC cree que la información de este documento es precisa en el momento de su publicación. La información está sujeta acambios sin previo aviso.

LA INFORMACIÓN DE ESTA PUBLICACIÓN SE PROPORCIONA "TAL CUAL". EMC CORPORATION NO EMITENINGUNA DECLARACIÓN O GARANTÍA DE NINGÚN TIPO CON RESPECTO A LA INFORMACIÓN DE ESTAPUBLICACIÓN Y RECHAZA ESPECÍFICAMENTE LAS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDAD O IDONEIDADPARA UN DETERMINADO FIN.

El uso, copia y distribución del software de EMC descrito en esta publicación requiere una licencia de software válida.

Para obtener la lista más actualizada de nombres de producto de EMC, consulte las marcas comerciales de EMC Corporationen EMC.com.

Todas las demás marcas comerciales mencionadas son propiedad de sus respectivos propietarios.

Tabla de contenido

Prefacio .......................................................................................................................... 11

Capítulo 1 Introducción al diseño de procesos comerciales ........................................ 13Introducción a los flujos de trabajo............................................................... 13Plantillas de proceso y objetos de flujo de trabajo asociados........................... 17

Actividades............................................................................................ 18Actividades de inicio .......................................................................... 19Actividades de espera de mensaje........................................................ 20Actividades del controlador de errores................................................. 20

Datos de proceso .................................................................................... 21Habilitar informes de Business Activity Monitor (BAM)........................ 22

Flujos..................................................................................................... 23Planificar los procesos de flujo de trabajo ..................................................... 24

Elegir o crear plantillas de actividad ........................................................ 25Elegir actividades ................................................................................... 26Elegir ejecutantes.................................................................................... 26

Definición de cuándo se determina el ejecutante ................................... 29Usar alias ........................................................................................... 30

Permitir la delegación y la extensión ........................................................ 31Definir asuntos de tareas......................................................................... 31Agregar un requisito de firma ................................................................. 32Definir valores de prioridad .................................................................... 33

Definición de de la prioridad inicial y antigüedad de tareas................... 33Cómo resuelve el sistema la prioridad inicial de una tarea................. 34Cómo aumenta el sistema la prioridad de una tarea .......................... 34

Establecimiento de la prioridad estática y de la lógica decaducidad para tareas ......................................................................... 35Establecimiento de la prioridad dinámica y de la lógica decaducidad para tareas ......................................................................... 35

Módulo de prioridad de ejemplo ..................................................... 36Introducción a los datos de proceso ......................................................... 38

Introducción a los paquetes ................................................................. 38Introducción a las variables de proceso ................................................ 39

Introducción a los parámetros de proceso................................................. 40Asociar plantillas de formulario con paquetes .......................................... 40Definir condiciones de desencadenamiento .............................................. 41Definir temporizadores ........................................................................... 42Configurar notificaciones ........................................................................ 44Definir transiciones de actividad ............................................................. 44

Determinar las condiciones de transición ............................................. 45

Capítulo 2 Utilizar Process Builder ............................................................................ 47Entorno de diseño de Process Builder .......................................................... 47Barra de herramientas de Process Builder..................................................... 49Definir preferencias de la plantilla de proceso .............................................. 49

Compartir plantillas de proceso con Process Analyzer .............................. 49

Guía del usuario de EMC Documentum Process Builder Versión 6.5 SP1 3

Tabla de contenido

Definir ubicaciones de la carpeta compartir proceso.............................. 51Definir el número de puerto para la depuración de actividadesentrantes ................................................................................................ 51Gestionar las carpetas de plantillas de actividades .................................... 52Definir preferencias de mensajes de la plantilla de proceso........................ 53Actualizar datos de proceso en la base de datos de BAM........................... 54

Ventana Activity Templates (Plantillas de actividades) .................................. 55Ventana Structured Data Types (Tipos de datos estructurados)...................... 56

Creación de categorías de tipos de datos estructurados y grupos ............... 56Crear tipos de datos estructurados........................................................... 57Editar tipos de datos estructurados.......................................................... 60Crear un tipo de datos estructurado complejo a partir de unesquema XML ........................................................................................ 60

Panel del editor de plantillas de proceso....................................................... 61Alinear actividades................................................................................. 63Sustituir una actividad............................................................................ 63Ajustar a la cuadrícula ............................................................................ 64Acercar o alejar....................................................................................... 64Agregar notas ........................................................................................ 65Ver varios procesos utilizando fichas........................................................ 67

Ficha Validación de procesos ....................................................................... 67Navegador ................................................................................................. 68

Capítulo 3 Trabajar con plantillas de proceso ............................................................ 69Información general de las plantillas de proceso ........................................... 69Abrir plantillas de proceso existentes ........................................................... 70Crear plantillas de proceso .......................................................................... 70Definir propiedades de la plantilla de proceso .............................................. 73Gestionar datos de procesos ........................................................................ 76

Gestionar los paquetes ............................................................................ 76Gestionar las variables de proceso ........................................................... 79Gestionar parámetros de proceso............................................................. 81Anular configuración de nivel de actividad .............................................. 82

Configurar las opciones avanzadas .............................................................. 82Establecer las opciones de la Lista de control de acceso (LCA) ................... 83Seleccionar un calendario para el proceso................................................. 85Asignar un formulario de parámetros de proceso ..................................... 85Crear los conjuntos de correlación ........................................................... 86Habilitar servicios Web entrantes............................................................. 87

Guardar plantillas de proceso...................................................................... 87Validar plantillas de proceso ....................................................................... 90

Utilizar la ficha Validación de procesos .................................................... 91Instalar plantillas de proceso ....................................................................... 92Modificar plantillas de proceso.................................................................... 93Plantillas de proceso para registrar, retirar y crear versiones.......................... 94Eliminar las plantillas de proceso................................................................. 97Importar plantillas de proceso ..................................................................... 97Mantener sincronizados los procesos compartidos........................................ 98Exportar plantillas de proceso ................................................................... 100Imprimir plantillas de proceso................................................................... 100

Definir las opciones de configuración de página ..................................... 101

4 Guía del usuario de EMC Documentum Process Builder Versión 6.5 SP1

Tabla de contenido

Vista previa de procesos impresos ......................................................... 102

Capítulo 4 Conectar actividades ............................................................................ 103Crear flujos .............................................................................................. 103Cambiar la configuración de vista.............................................................. 104

Capítulo 5 Crear subprocesos ................................................................................ 107Crear un subproceso utilizando el modelado descendente........................... 108Crear un subproceso utilizando el modelado ascendente............................. 108Establecer las propiedades del subproceso ................................................. 109

Utilizar la ficha Temporizadores ............................................................ 109Utilizar la ficha Visualización ................................................................ 110

Gestionar subprocesos .............................................................................. 110Expandir y contraer un subproceso........................................................ 111Quitar actividades de un subproceso ..................................................... 111Agregar notas a un subproceso.............................................................. 111Eliminar un subproceso y su contenido.................................................. 112

Capítulo 6 Trabajar con plantillas de actividad ......................................................... 113Crear plantillas de actividad...................................................................... 114Gestionar las plantillas de actividad dentro de las carpetas.......................... 115Configurar plantillas de actividad.............................................................. 116Validar e instalar plantillas de actividad..................................................... 117

Capítulo 7 Trabajar con actividades ........................................................................ 121Definir propiedades de actividades............................................................ 123Seleccionar ejecutantes.............................................................................. 125

Asociar un módulo de prioridad de colas de trabajo a unaactividad.............................................................................................. 127Elegir ejecutantes manuales................................................................... 127

Asignar ejecutantes ahora ................................................................. 130Hacer que los ejecutantes de la <actividad> determinen losejecutantes de la actividad................................................................. 131Definir alias de ejecutante (los ejecutantes se asignaráncuando el flujo de trabajo esté en curso) ............................................. 133Select performer based on conditions (Seleccionar ejecutantesegún condiciones) .......................................................................... 134Seleccionar ejecutante basado en los datos de proceso yparámetros de proceso ...................................................................... 137

Asignar datos de proceso a un nivel de habilidad de cola detrabajo ................................................................................................. 138Elegir ejecutantes automáticos ............................................................... 139

Definir desencadenadores de actividades ................................................... 140Establecer temporizadores de advertencia .................................................. 141

Enviar una notificación ......................................................................... 144Iniciar un proceso ................................................................................. 146Ejecutar un método Java........................................................................ 146Delegar tareas ...................................................................................... 147Completar tareas .................................................................................. 148

Definir las reglas de transición de actividad ............................................... 149Crear condiciones de transición ............................................................. 151

Definir notificaciones ................................................................................ 154Utilizar el Asistente para plantilla de notificación ................................... 155


Tabla de contenido

Cambiar datos de proceso en una actividad................................................ 158Cambiar la configuración de vista.............................................................. 161

Capítulo 8 Asignar elementos de datos de proceso ................................................ 163Introducción a la herramienta de asignación de datos ................................. 163Agregar o editar datos de proceso en el asignador ...................................... 166Asignar atributos de paquete..................................................................... 166Agregar las propiedades del mensaje ......................................................... 167Agregar un esquema XML al contenido de la actividad .............................. 168Incorporar formularios de Forms Builder a procesos ................................... 169

Rellenar formularios mediante archivos XML......................................... 169Crear formularios de alta fidelidad mediante datos de procesos .............. 169

Usar una actividad HTTP entrante: inicio para crear unanueva instancia de formulario de alta fidelidad .................................. 170Usar una actividad Asignación de datos de procesos paracrear una instancia de formulario de alta fidelidad.............................. 170Usar formularios de alta fidelidad para agregar datos aprocesos .......................................................................................... 171

Agregar un nodo basado en una condición................................................. 172Asignar los datos...................................................................................... 172

Usar atributos de repetición .................................................................. 174Contexto de entrada ......................................................................... 175

Usar las funciones de asignación de datos .............................................. 175Introducción a la correlación de mensajes................................................... 180

Usar los identificadores de correlación ................................................... 180Utilizar conjuntos de correlaciones ........................................................ 181

Capítulo 9 Depurar una plantilla de proceso ............................................................ 183Introducción al Debugger de proceso......................................................... 183

Utilizar el entorno de debug (depuración) de procesos............................ 185Preparar la depuración del proceso............................................................ 187

Agregar puntos de quiebre.................................................................... 187Iniciar un flujo de trabajo en el depurador.............................................. 187

Probar un proceso en el depurador ............................................................ 189Utilizar la ficha Task Manager ............................................................... 191

Gestionar una tarea manual............................................................... 191Gestionar una tarea automática ......................................................... 192

Depurar métodos de flujo de trabajo automáticos ........................... 193Utilizar la ficha Datos de procesos ......................................................... 193Utilizar la ficha Consola ........................................................................ 194Usar la ficha Administrar flujo de trabajo ............................................... 195

Apéndice A Plantillas de actividades incorporadas .................................................... 197Servicios de contenido .............................................................................. 199

Crear carpeta........................................................................................ 199Aplicar ciclo de vida ............................................................................. 200Ciclo de vida ........................................................................................ 201Enlazar a carpeta .................................................................................. 203ECIS (Enterprise Content Integration Services) - (Servicios deIntegración de Contenido Empresarial) .................................................. 204

Flujo ....................................................................................................... 205Decision Split (División de la decisión)................................................... 206Unir..................................................................................................... 206


Tabla de contenido

Publicar evento en proceso padre .......................................................... 207Transformación XSL ............................................................................. 208

Integración .............................................................................................. 208BOF Module (Módulo BOF) .................................................................. 209Crear LCA (lista de control de acceso).................................................... 211Crear carpeta a partir de plantilla .......................................................... 213Crear evento de calendario de ICS ........................................................ 214Base de datos entrante: inicio y procedimiento ....................................... 215Database Read (Leer base de datos) ....................................................... 218Database Stored Procedure (Procedimiento almacenado enbase de datos)....................................................................................... 220

Patrones de búsqueda de ejemplo ...................................................... 222Database Write (Escribir base de datos) .................................................. 224DQL entrante: inicio y procedimiento .................................................... 226DQL Read (Leer DQL) .......................................................................... 227DQLWrite (Escribir DQL) ..................................................................... 228Dynamic Web Service (Servicio Web dinámico) ...................................... 229

Abrir servicios Web no seguros.......................................................... 230Abrir los servicios Web seguros ......................................................... 231

Asignar parámetros de servicio Web .............................................. 232Configurar el servidor proxy HTTP ............................................... 233

Configurar parámetros del proxy HTTP en Windows ................. 234Configurar parámetros del proxy HTTP en sistemasbasados en UNIX...................................................................... 235

Abrir los servicios DFS (Documentum Foundation Services)desde Process Builder ....................................................................... 236

Correo electrónico entrante: inicio y procedimiento ................................ 238Fax saliente .......................................................................................... 240FTP entrante: inicio y procedimientos .................................................... 244FTP saliente.......................................................................................... 247Leer FTP ............................................................................................. 248HTTP entrante: inicio y procedimiento .................................................. 250HTTP saliente....................................................................................... 253JMS entrante: inicio y procedimiento ..................................................... 255JMS Saliente ......................................................................................... 257Asignación de datos de procesos ........................................................... 258SMTP .................................................................................................. 260Abrir proceso ....................................................................................... 262Servicio Web ........................................................................................ 263Servicio Web entrante: inicio y procedimiento ........................................ 265Documento de xPression Publish........................................................... 268Documento de xPression Publish: Avanzada ......................................... 269

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

Plantillas de actividad no admitidas........................................................... 274Iniciar subproceso ................................................................................ 274SMTP................................................................................................... 275Publicar en el tema de JMS .................................................................... 276FTP...................................................................................................... 277Buzón HTTP ........................................................................................ 278Enviar a la cola de JMS.......................................................................... 278Enviar a MQ JMS.................................................................................. 279Aplicar ciclo de vida (5.3x y versiones anteriores) ................................... 280Vuelta al estado anterior del ciclo de vida............................................... 280Promoción de ciclo de vida.................................................................... 281BAM ................................................................................................... 281


Tabla de contenido

Punto de observación........................................................................ 282Trabajo Workflow Publish Events (Eventos de publicaciónde flujo de trabajo)........................................................................ 283

Apéndice B Variables de sustitución para las propiedades de plantillas deactividades personalizadas .................................................................... 285

Apéndice C Archivo de configuración de Process Builder ........................................... 289


Tabla de contenido

Lista de figuras

Figura 1. Las plantillas de proceso capturan procesos comerciales ................................... 15Figura 2. Componentes de un flujo de trabajo................................................................. 17Figura 3. Actividad del controlador de errores ............................................................... 21Figura 4. Process Builder............................................................................................... 48Figura 5. Las notas agregan texto al diseño visual ........................................................... 65Figura 6. Asignar un mensaje HTTP entrante a datos de proceso ................................... 165Figura 7. Actividad manual en el Debugger ................................................................. 185Figura 8. Proceso de aprobación sin y con la actividad Decision Split (División

de la decisión) .......................................................................................... 206Figura 9. Proceso de revisión sin y con la actividad Unir ............................................... 207


Tabla de contenido

Lista de tablas

Tabla 1. Categorías de selección del ejecutante de la actividad........................................ 27Tabla 2. Estados de la plantilla de actividades e iconos relacionados............................... 56Tabla 3. Requisitos de permiso para un proceso ............................................................ 83Tabla 4. Requisitos de permiso para las variables de proceso.......................................... 83Tabla 5. Estados de la plantilla de proceso e iconos relacionados .................................... 94Tabla 6. Remitente y destinatario predeterminado basados en evento........................... 155Tabla 7. Funciones de la asignación de datos............................................................... 176Tabla 8. Campos utilizados para configurar el ID de correlación .................................. 181Tabla 9. Elementos gráficos del Debugger de proceso y su propósito ............................ 186Tabla 10. Botones de Debugger de proceso ................................................................... 189Tabla 11. Asignaciones de plantilla de ciclo de vida ...................................................... 201Tabla 12. Formatos requeridos..................................................................................... 271Tabla 13. Variables de sustitución admitidas para los campos de configuración

de actividades .......................................................................................... 286Tabla 14. Parámetros de bpmconfig.............................................................................. 289


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 de ProcessSuite, que habilita y admite todas las fases del ciclo de vida del proceso comercial.

Destinatarios

Esta guía está pensada para usuarios que diseñan procesos comerciales. Se asume quelos usuarios están familiarizados con el funcionamiento básico de EMC Documentum,en especial con las funciones de flujo de trabajo en tiempo de ejecución disponiblesen Documentum Webtop o en TaskSpace.

Historial de revisión

En esta sección se describe el historial de revisiones de este documento.

Historial de revisión

Fecha de revisión Descripción

Diciembre de 2008 Publicación inicial

Información de asistencia técnica

Las políticas y los servicios de asistencia técnica de EMC Documentum están disponiblesen el sitio Web de EMC Powerlink (http://Powerlink.EMC.com).

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


http://powerlink.emc.com

Prefacio

Documentación relacionada

Process Builder es una herramienta de diseño para plantillas de procesos empresariales.Los flujos de trabajo se crean a partir de estas plantillas en tiempo de ejecución. Ladocumentación del usuario de Documentum Webtop o TaskSpace incluye informaciónsobre cómo ejecutar y participar en 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 EMCDocumentum Process Builder)

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


Capítulo 1

Introducción al diseño de procesoscomerciales

En este capítulo se describen los conceptos básicos relativos al diseño de procesos comerciales y aDocumentum Workflow. Se incluyen los siguientes temas:• Introducción a los flujos de trabajo, página 13• Plantillas de proceso y objetos de flujo de trabajo asociados, página 17• Planificar los procesos de flujo de trabajo, página 24

Introducción a los flujos de trabajo

Business Process Builder se utiliza para crear plantillas de proceso. Este tipo de plantillastoma la definición de un proceso comercial, lo que permite a los usuarios ejecutarreiteradamente el proceso. Las instancias de procesos individuales que se generan enuna plantilla de proceso se denominan flujos de trabajo.

Un flujo de trabajo formaliza un proceso comercial, como por ejemplo, un proceso dereclamación al seguro o un proceso de desarrollo de ingeniería. Un flujo de trabajoincluye los siguientes elementos:

• Una plantilla de proceso es el proceso comercial representado como una definiciónde flujo de trabajo formalizado.

Los usuarios pueden usar la plantilla para ejecutar reiteradamente el procesocomercial. Debido a que las plantillas de proceso son independientes a la creaciónde instancias en tiempo de ejecución, es posible ejecutar a la vez varios flujos detrabajo basados en la misma plantilla.

• Una plantilla de proceso consta de varias actividades.

Estas actividades representan las tareas necesarias para completar el proceso, comola recepción de un correo electrónico, la revisión, el registro en el repositorio o laaprobación de un documento.


Introducción al diseño de procesos comerciales

• Flujos son los vínculos entre las actividades, especificando la secuencia de actividades.• Datos de proceso son los distintos tipos de datos que recorren el proceso, como

un documento, un formulario o variables de proceso, como números de pieza odirecciones de clientes o parámetros de proceso que permiten a los administradoresmodificar un valor constante para un parámetro concreto a lo largo de la instancia deproceso.

Los datos de proceso están formados por variables de proceso, parámetros de proceso ypaquetes que se mueven por el flujo de trabajo.

— Las variables de proceso son las variables de los tipos de datos o los datos deejecución, individuales o agrupados, que se utilizan durante la vida del proceso.

Un ejemplo de variables de proceso son los distintos elementos de datos querepresentan diversos tipos de información sobre un cliente. Consulte Plantillasde proceso y objetos de flujo de trabajo asociados, página 17 si necesita másinformación sobre los componentes del flujo de trabajo.

— Los parámetros de proceso son valores que permiten a los administradores dela aplicación modificar valores constantes que se utilizan en un proceso. Losparámetros de proceso se pueden utilizar en valores fijos dentro de un proceso,como roles de escalada, condiciones de transición, condiciones del ejecutante,asignaciones dinámicas del ejecutante, nombre de tarea e instrucciones detarea. Cuando un administrador cambia los valores del parámetro en la fichaAdministración de TaskSpace, el valor se actualiza en todas las instancias nuevasdel proceso.

— Los paquetes contienen el objeto, normalmente un documento o archivo deimágenes, que se pasa entre las actividades para que el trabajo se pueda realizaren él.

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



Figura 1. Las plantillas de proceso capturan procesos comerciales

Las plantillas de proceso pueden describir procesos comerciales simples o complejos.Se pueden crear flujos de trabajo que contengan segmentos en serie, en los que lasactividades se siguen unas a otras en una secuencia específica, y segmentos paralelos,en los que dos o más actividades tienen lugar al mismo tiempo. Asimismo, se puedecrear un flujo de trabajo cíclico, en el que la finalización de una actividad reinicia unaactividad completada anteriormente. La ruta que sigue un documento a través del flujode trabajo puede diferir dependiendo de lo que ocurre durante el proceso. Por ejemplo,un pedido de compra se puede distribuir a diferentes actividades dependiendo de si eladministrador lo aprueba o lo rechaza.

Podrá crear una plantilla de proceso y usarla en muchas situaciones. Para ello, seincluyen actividades cuyos ejecutantes se identifican por medio de datos de proceso oalias en lugar de por nombres de usuario. Cuando se usan datos de proceso o alias, elusuario real se selecciona en tiempo de ejecución. Por ejemplo, un proceso empresarialtípico con los documentos nuevos consta de cuatro fases: creación, revisión, corrección ypublicación del documento. El autor y el revisor cambiarán de documento a documento.En lugar de crear un flujo de trabajo diferente para cada documento con los nombres delautor 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 delautor y del revisor. Dependiendo de cómo se diseña el flujo de trabajo, tanto el autorcomo los revisores puede elegirlos la persona que inicia el flujo de trabajo, la que realizala actividad anterior, automáticamente el servidor cuando se inicia la actividad o enfunción de la lógica condicional definida en el flujo de trabajo.

Puede agregar actividades a una plantilla de proceso mediante la creación de unaactividad en blanco o la selección de la plantilla de actividad adecuada para el tipo detarea representada por la actividad. La plantilla de actividad determina los atributosde configuración que son necesarios para un determinado tipo de tarea, incluidos losatributos comunes a todas las actividades (como un nombre y una lista de ejecutantes)



y los atributos personalizados exclusivos de una tarea específica. Por ejemplo, laplantilla para actividades que envían archivos a un sitio Web incluiría un atributo conla URL que se usaría para el envío. Process Builder incorpora plantillas de actividadpredefinidas que representan tipos de actividad típicos y puede crear plantillas deactividad personalizadas que se adapten exactamente a sus necesidades.

Los paquetes y las actividades pueden tener una plantilla de formulario asociada. Estaplantilla define los campos de introducción de datos que se muestran a los usuariosal ejecutar la actividad y especifica cómo se almacenan éstos en el repositorio deDocumentum. Los formularios se crean mediante Documentum Forms Builder y seasocian con procesos que utilizan Process Builder.

Las plantillas de proceso de flujo de trabajo se implementan a través de DocumentumContent Server como objetos dm_process. Por su parte, las definiciones de las actividadesindividuales de una plantilla de proceso se almacenan en objetos dm_activity. Al diseñarun flujo de trabajo, además de crear las nuevas definiciones de actividad necesarias,puede incluir definiciones de actividad existentes.

Cada vez que se inicia un flujo de trabajo, el servidor usa la plantilla de proceso (el objetodm_process) para crear una instancia en tiempo de ejecución del mismo (un objetodm_workflow). En cambio, cuando se inicia una actividad, el servidor crea uno o varioselementos de trabajo (dmi_workitem), que son tareas que el servidor agrega a la bandejade entrada de los ejecutantes designados de la actividad.

En la Figura 2, página 17 se describe el funcionamiento conjunto de los componentes deuna plantilla de 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 asociados

El modelo de datos de proceso de Process Builder consta de una plantilla de proceso, unconjunto de definiciones de actividad, un grupo de datos que pasan por todo el proceso,un conjunto de flujos que conectan las actividades entre sí y uno o varios paquetes querepresentan los documentos que se están procesando.



La plantilla de proceso define la estructura de un proceso comercial. Está compuestade definiciones de actividad y de un conjunto de atributos que definen los flujos queconectan las actividades.

Actividades

Las actividades representan las tareas que forman el proceso comercial. Los flujos detrabajo contienen varios 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

proceso sólo puede tener una actividad de finalización.• Las actividades intermediasson las actividades existentes entre las actividades de inicio

y de finalización. Una plantilla de proceso puede tener un número ilimitado deactividades intermedias.

• Las actividades de espera de mensajeson actividades de recepción que participan encomunicación asincrónica con aplicaciones externas y están diseñadas para obteneruna respuesta de la aplicación.

• Las actividades del controlador de errorespermiten especificar la acción que se deberealizar si se produce un error en una actividad automática.

Las actividades pueden ser manuales o automáticas. Las actividades manuales lasrealizan una o varias personas. Las actividades automáticas las realiza el sistema departe de un usuario.

Los atributos de una definición de actividad describen las características de dichaactividad, 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 actividadAsimismo, las actividades también pueden presentar características específicas deltipo de tarea que representan. Por ejemplo, una actividad que envía documentosa un proveedor externo incluiría un atributo con la dirección de correo electrónicodel proveedor. El conjunto de atributos personalizados asociados a una actividad seconfigura mediante plantillas de actividad.

Cuando el servidor inicia una actividad, crea elementos de trabajo que agregaposteriormente a las bandejas de entrada de los ejecutantes de la actividad. Estos



elementos de trabajo contienen los paquetes en los que el usuario debe trabajar, así comoinstrucciones relativas a la tarea requerida. El servidor agrega un elemento de cola a labandeja de entrada enlazado al elemento de trabajo. En el manual Documentum ContentServer Object Reference (Referencia de objetos de Document Content Server) se puedeobtener más información sobre este tema.

Actividades de inicio

Las actividades de inicio especifican las condiciones que comienzan una instancia deproceso. Las actividades de inicio pueden conectar con cualquier actividad de comienzoy pueden ser manuales o automáticas. Puede comenzar un flujo de trabajo con unaactividad de inicio manual, varias actividades de inicio automáticas o una combinaciónde una actividad manual y varias actividades de inicio automáticas. Si la actividad deinicio es una actividad automática, debe especificar la configuración del canal y lasreglas de asignación para copiar los datos del mensaje en los datos de proceso utilizadosdurante dicho proceso. Si la actividad de inicio es manual, puede configurarla parainiciar automáticamente un formulario creado en Forms Builder que inicie el proceso.

Por ejemplo, un flujo de proceso de una aplicación de préstamo puede tener variasactividades de inicio. Puede iniciarse con una actividad de inicio manual que inicieautomáticamente un formulario de aplicación de préstamo que un procesador puedafinalizar durante una aplicación para llamadas telefónicas. El mismo proceso tambiénpuede tener una actividad de inicio automático que reciba una aplicación de préstamo através de un mensaje de correo electrónico.

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

Para incluir una actividad de inicio automático, podría crear una actividad denominadaFormulario de correo electrónico recibido, donde se configura la cuenta de correoelectrónico y los detalles del encabezado y el cuerpo del mensaje de correo electrónico seasignan a los datos de proceso definidos para dicho proceso.

Una actividad de inicio manual sólo permite configurar las fichas Propiedades, Datosy Presentación. Otras actividades de inicio, como la plantilla de actividad Correoelectrónico entrante: inicio, tienen todas las fichas estándar, así como una ficha paraconfigurar la conexión del servidor de correo electrónico.



Actividades de espera de mensaje

Un proceso comercial puede participar en comunicación asincrónica con otrasaplicaciones externas. Una aplicación puede enviar al otro un mensaje y esperaruna respuesta. Process Builder utiliza conjuntos de correlaciones que constan de datosexclusivos del mensaje para hacer coincidir la respuesta con la solicitud original.Cualquier plantilla de actividad de recepción puede configurarse como una actividad deespera de mensaje.

Por ejemplo, en una actividad de un proceso de compra, se envía un mensaje JMSal proveedor que solicita información sobre si se envió un elemento de un pedido decompra. El mensaje especifica tanto el número de ID del proveedor como el número depedido de compra del elemento. Posteriormente, el sistema del proveedor responde conun mensaje de estado de envío para el pedido de compra y el sistema utiliza el númerodel pedido de compra y el ID del proveedor incluido en el mensaje para coincidir lasolicitud con la respuesta.

Actividades del controlador de errores

Una actividad de controlador de errores es una actividad secundaria que se desencadenacuando una actividad automática asociada produce un error en tiempo de ejecución.Una actividad de control de errores puede ser tanto manual como automática y puedeenlazarse a más de una actividad automática. Una actividad del controlador de erroresno puede tener un flujo saliente. Sólo se puede utilizar como controlador de erroresen el proceso.

Cuando se asigna un controlador de errores a una actividad automática, el controladorde errores se ejecuta cada vez que se produce un error con el método asociado a laactividad. Por lo que si ha configurado el sistema para reintentar el método en unintervalo especificado y para un número especificado de veces, el controlador de erroresse ejecutará cada vez que se produzca un error de método hasta que el sistema hayaejecutado el número de intentos especificado.

Una vez que el sistema haya realizado el número especificado de intentos, llevará acabo una acción final basada la configuración de la ficha del ejecutante y continuará, sedetendrá o finalizará el flujo de trabajo. Seleccionar ejecutantes, página 125 contiene másinformación acerca de cómo configurar el número de intentos y el intervalo entre losintentos 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 actividadautomática utilizando el botón de flujo para la asignación del controlador de errores dela barra de herramientas. El sistema identifica la actividad del controlador de errores conun icono de rayo sobre la actividad y utiliza una línea discontinua gris para enlazar laactividad del controlador de errores con sus actividades automáticas asociadas.

Datos de proceso

Los 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 para un elemento de datos concreto durante la instancia de procesoLa exposición y utilización de datos de proceso permite que los usuarios vean datoscomerciales significativos cuando ven su lista de tareas, como el nombre del candidato, elestado de aprobación de una solicitud, la cantidad de un préstamo, etc. Esta informaciónpermite que el ejecutante de una tarea trabaje de manera más eficiente en las tareasde 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 dediseñarlas, como parte del proceso, o se pueden inicializar a partir de un formularioasociado con el proceso. Las variables de proceso pueden ser variables simples,como valores de cadena o booleanos, o tipos de datos complejos basados en los tiposde datos definidos como Tipos de datos estructurados. Consulte Introducción a lasvariables de proceso, página 39 si precisa más información sobre las variables deproceso.



• Los parámetros de proceso que permiten a los administradores de la aplicaciónmodificar valores constantes que se utilizan en un proceso. Los parámetros deproceso se pueden utilizar en roles de escalada, transiciones, selección de ejecutantesy para otros valores fijos de un proceso. Cuando el administrador cambia los valoresdel parámetro en la ficha Administración de TaskSpace, el valor se actualiza entodas las nuevas instancias del proceso.

Introducción a los parámetros de proceso, página 40 proporciona más informaciónsobre este tema.

• Los datos obtenidos colateralmente del flujo de trabajo, como datos de paquetes odatos entrantes de servicios Web.

Consulte Introducción a los paquetes, página 38 si precisa más información sobredatos de paquetes.

• Los datos de ejecución originados en el flujo de trabajo y elementos de trabajoactuales como la fecha de creación del flujo de trabajo y el estado en tiempo deejecución del elemento de trabajo. Esta información se mantiene por el motor deproceso y se descarta cuando el flujo de trabajo ha finalizado.

Habilitar informes de Business Activity Monitor (BAM)

Process Builder se puede utilizar para configurar qué datos de ejecución se guardan enla base de datos de BAM, donde se pueden aprovechar para crear informes de BAM.Los diseñadores de procesos pueden seleccionar variables de proceso, tipos de datosestructurados y objetos incluidos en paquetes específicos para utilizarlos en los informesde 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 datosde informes en la base de datos de BAM. Definir propiedades de la plantilla deproceso, página 73 proporciona instrucciones sobre cómo habilitar el seguimientode comprobación.

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

Crear tipos de datos estructurados, página 57 proporciona instrucciones sobre cómocrear tipos de datos estructurados que se pueden supervisar en los informes de BAM.



• Seleccione los paquetes que desea incluir en los informes del nivel de proceso ola actividad individual.

Gestionar los paquetes, página 76 y Cambiar datos de proceso en una actividad,página 158 proporcionan instrucciones sobre la selección de paquetes para lasupervisión en los niveles de proceso 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 datosestructurados seleccionados para los informes en el momento de su creación.Cambiar datos de proceso en una actividad, página 158 proporciona instruccionessobre cómo seleccionar variables y tipos de datos estructurados para la supervisiónen el nivel de actividad.

• Asegúrese de que todos los cambios en los datos empresariales que se estánsupervisando se han actualizado en la base de datos de BAM. Actualizar datos deproceso en la base de datos de BAM, página 54 proporciona más información sobrela actualización de datos de proceso en la base de datos de BAM.

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

Flujos

Los flujos conectan las actividades en el proceso. Permiten el movimiento de paquetes,variables de proceso, propiedades y cualquier dependencia que exista entre lasactividades 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óna la actividad de aprobación).

• Los flujos de rechazo, por su parte, determinan lo que ocurre cuando el ejecutante deuna actividad rechaza la tarea que se distribuye. Estos flujos dirigen los paquetesen un bucle hacia atrás, por ejemplo, desplazando un paquete de la actividad deaprobación a la de modificación.

• Los flujos de controlador de errores determinan qué acción se debe realizar si unaactividad automática asociada produce errores. Actividades del controlador deerrores, página 20 proporciona más información sobre este tema.

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



Planificar los procesos de flujo de trabajo

La creación de una plantilla de proceso implica tomar una serie de decisiones relativas aldiseño. Deberá decidir los tipos de datos de procesos que intervienen en el proceso, lasactividades que se incluyen y cómo estructurar el flujo de trabajo.

En primer lugar, es necesario revisar el proceso comercial que desea automatizare identificar la secuencia de actividades requeridas para completarlo. En Elegiractividades, página 26 encontrará una serie de directrices que le ayudarán a tomardecisiones relativas a las actividades.

Deberá tomar las siguientes decisiones con cada una de las actividades del flujo detrabajo:• ¿Hay una plantilla de actividad adecuada disponible?

En Elegir o crear plantillas de actividad, página 25 se explica cómo decidir si esnecesario crear plantillas adicionales.

• ¿Quién es el ejecutante?

En Elegir ejecutantes, página 26 se describe esta opción.• Para actividades manuales:

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

— ¿Qué tipo de mensajes se debería mostrar a los ejecutantes para facilitarinformación sobre el elemento de trabajo? En Definir asuntos de tareas, página31 se describe esta opción.

— ¿Debe el usuario cerrar la sesión para completar la actividad? En Agregar unrequisito de firma, página 32 se describe esta opción.

— ¿Debería el usuario cumplimentar una plantilla de formulario personalizadapara completar la actividad? En Asociar plantillas de formulario con paquetes,página 40 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 33 se describen los valores de prioridadpara las actividades automáticas.

• ¿Qué datos de proceso transporta el proceso por el flujo?

Introducción a los datos de proceso, página 38 describe un proceso para Introduccióna los paquetes, página 38 y Introducción a las variables de proceso, página 39proporciona algunas directrices acerca de cómo agregar las variables de proceso alflujo de proceso. Introducción a los parámetros de proceso, página 40 proporcionainstrucciones acerca de cómo crear parámetros de proceso.



• Si desea crear informes basados en el flujo, ¿qué datos de proceso deberían utilizarsepara generar informes?

Crear tipos de datos estructurados, página 57 proporciona más información sobrecómo hacer que los datos de proceso estén disponibles para generar informes.

• ¿Cuándo se inicia la actividad?

En Definir condiciones de desencadenamiento, página 41 encontrará informaciónsobre esta decisión.

• ¿Qué acciones realizará la actividad si no se ha iniciado o completado en un tiemporazonable?

En Definir temporizadores, página 42 se describen las acciones disponibles.• Para las actividades automáticas, ¿qué acciones deberían realizarse si un método

produce errores?

Actividades del controlador de errores, página 20 proporciona información detalladasobre este tema.

• ¿Qué notificaciones enviará esta actividad cuando se produzcan eventos del sistema?

En Configurar notificaciones, página 44 se analizan las opciones de notificación.• ¿Qué ocurre a continuación en el flujo de trabajo?

En Definir transiciones de actividad, página 44 se describen las opciones detransición.

Elegir o crear plantillas de actividad

A medida que identifique las tareas comerciales necesarias en cada paso del proceso,deberá determinar si hay una plantilla de actividad que admita todas las actividadesque agregue al proceso. Muchas plantillas de actividad incluyen uno o varios atributospersonalizados exclusivos de una tarea determinada. Por ejemplo, la plantilla paraactividades que envían correo electrónico incluye un atributo que contiene la direcciónde 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 deactividad típicos. Si su proceso comercial incluye actividades con un fin específico alas que no se les aplica ninguna de las plantillas disponibles, deberá crear actividadespersonalizadas cuyos atributos personalizados reflejen las tareas realizadas con lasactividades. Puede que también tenga que desarrollar un método de flujo de trabajopersonalizado para ejecutar la tarea requerida. Si normalmente utiliza un determinadotipo de actividad personalizada, puede basarse en ella para crear una plantilla deactividad personalizada.



Capítulo 7, Trabajar con actividades proporciona más detalles acerca de cómo crearplantillas de actividad.

Elegir actividades

Cada plantilla de proceso debe tener una o varias actividades de inicio y una solaactividad de finalización. La plantilla puede tener un número ilimitado de actividadesintermedias. El número de actividades intermedias incluidas dependerá únicamente dela estructura del flujo de trabajo, que, a su vez, depende del objetivo empresarial quese persiga.

Cada actividad del flujo de trabajo debe tener un nombre exclusivo en la plantilla deproceso. El nombre se asigna al agregar la actividad a la plantilla de proceso. Elijanombres descriptivos que definan el trabajo realizado por la actividad.

Puede incluir actividades que haya creado o actividades para las que disponga al menosde permiso para Relacionar.

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

Sin embargo, si usa una actividad varias veces en un flujo de trabajo, debe estructurarlode modo que solo una instancia de la actividad esté activa a la vez. Un flujo de trabajo nopuede iniciar una actividad si la actividad anterior, basada en la misma definición, aúnestá en ejecución.

Elegir ejecutantes

Una definición de actividad incluye la información que permite a Process Builderdeterminar quién realizará la actividad. Process Builder ofrece un alto nivel deflexibilidad en cuanto a quién puede ser el ejecutante de una actividad. En el caso de lasactividades automáticas, sin embargo, se debe identificar al usuario cuyos permisos seusará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 bandejade entrada del usuario o usuarios designados como ejecutantes de la actividad. Paraprocesar documentos de gran volumen, puede agregar el elemento de trabajo a una colade trabajo con la que trabajan muchos usuarios diferentes. En la guía Documentum WebtopUser Guide o en la guía Documentum TaskSpace Configuration Guide se proporciona másinformación sobre la gestión de colas de trabajo y los ejecutantes.



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

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

Categoría de usuario Selección de los ejecutantes

0 Supervisor del flujo de trabajo El servidor selecciona al usuario designado comosupervisor del flujo de trabajo cuando se inicia laactividad. De forma predeterminada, el usuarioque inicia el flujo de trabajo es el supervisor.

1 Propietario del repositorio El servidor selecciona al usuario identificado comoel propietario del repositorio activo.

2 Ejecutante de la actividadanterior

El servidor selecciona al ejecutante de laanterior actividad finalizada que cumplióla condición de desencadenamiento de laactividad actual. (Consulte Definir condicionesde desencadenamiento, página 41 si necesitamás información sobre las condiciones dedesencadenamiento). Puede incluir variosejecutantes así como usuarios de otras actividadesanteriores.

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

4 Todos los usuarios del grupo Selecciona un nombre de grupo al crear la plantilla.El servidor asigna en tiempo de ejecución unelemento de trabajo independiente a cada uno delos miembros del grupo.

5 Un solo usuario del grupo(Primero en adquirir el elementode trabajo)

Selecciona un nombre de grupo al crear la plantilla.El servidor asigna en tiempo de ejecución unelemento de trabajo nuevo a cada uno de losmiembros del grupo. Cuando uno de los miembrosdel grupo obtiene el elemento de trabajo, loselementos de trabajo se quitan de todas las bandejasde entrada de los miembros del grupo.



Categoría de usuario Selección de los ejecutantes

6 Un solo usuario del grupo(Cantidad menor de elementosde trabajo sin terminar)

Selecciona un nombre de grupo al crear la plantilla.El servidor determina en tiempo de ejecución quéusuario del grupo seleccionado presenta la menorcarga de trabajo y le asigna un nuevo elementode trabajo. La carga de trabajo se mide como elnúmero de elementos de trabajo inactivos y activos.

8 Algunos usuarios de un grupo Selecciona una lista de varios usuarios o alias comoejecutantes de la actividad. El servidor asigna unelemento de trabajo a cada uno de los usuariosseleccionados como ejecutantes.

9 Varios ejecutantes secuenciales Selecciona una lista de varios usuarios o alias comoejecutantes de la actividad. El servidor asigna elelemento de trabajo al primer usuario de la listade usuarios seleccionados. Cuando el usuariocompleta el elemento de trabajo, el servidor creaotro elemento para el siguiente usuario de la lista.Este proceso continúa hasta que todos los usuariosseleccionados han completado sus elementos detrabajo.

10 Cola de trabajo El servidor asigna el elemento de trabajo a la colade trabajo que seleccione. Los usuarios asignadospara trabajar en esa cola extraen los elementos detrabajo de la cola en orden de prioridad, o bien eladministrador de la cola asigna el elemento a unusuario particular. Para obtener más informaciónsobre el procesamiento de colas de trabajo, consultela guía Documentum Webtop User Guide o la guíaDocumentum TaskSpace Configuration Guide.

Los participantes en un flujo de trabajo tienen la opción de aparecer como no disponiblespara realizar tareas de flujo de trabajo. Si cuando se ejecuta el flujo de trabajo no estádisponible el usuario seleccionado como ejecutante, el motor del flujo de trabajo intentaasignar el elemento de trabajo al usuario delegado del primero. Consulte Permitir ladelegación y la extensión, página 31 si necesita más información sobre los usuariosdelegados.

Si necesita más información sobre la selección de los ejecutantes de una actividad enProcess Builder, consulte Seleccionar ejecutantes, página 125. Si necesita informacióndetallada sobre la creación de actividades cuyos ejecutantes se seleccionan en tiempode ejecución, consulte Definición de cuándo se determina el ejecutante, página 29 yUsar alias, página 30.



Definición de cuándo se determina el ejecutante

Al crear una actividad, es necesario definir el tipo de ejecutante y la categoría de usuario.Puede definir el ejecutante real en ese momento o configurar la actividad para que loseleccione 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 unaactividad es más flexible, ya que permite que las decisiones relativas a los ejecutantes sebasen en las circunstancias y reglas empresariales actuales. Permitir la configuraciónde un ejecutante basándose en condiciones es la alternativa más flexible utilizada paradeterminar 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íala que defina al usuario real. Por ejemplo, un flujo de trabajo en ejecución solo tieneun supervisor del flujo de trabajo y el repositorio en el que se ejecuta solo tiene unpropietario del repositorio. No es necesario definir la persona 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 elmomento de crear la actividad. Para seleccionar a la persona real cuando se ejecuta elflujo de trabajo, utilice un alias o defina la lógica condicional para determinar al usuario.Usar alias, página 30 o Select performer based on conditions (Seleccionar ejecutantesegún condiciones) , página 134 proporcionan información detallada sobre estos temas.

Al utilizar un alias, el usuario puede resolverse automáticamente por el servidorutilizando un conjunto de alias o por el ejecutante de una actividad anterior. Las mismasopciones se aplican a las categorías 4, 5, 6 ó 10, con la excepción de que debe proporcionarel nombre de un grupo o cola de trabajo en lugar del nombre de un usuario individual.Proporcione un nombre de grupo o de cola si está eligiéndolo al crear 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 8 y 9, proporciona los nombres o alias de una lista de variosusuarios. Al igual que con otras categorías, puede seleccionar los ejecutantes reales alcrear la actividad, hacer que sea el ejecutante de una actividad anterior el que elija alejecutante o usar alias para que el ejecutante se seleccione en tiempo de ejecución.

Con cola de trabajo de categorías de usuario, un usuario concreto, todos los usuariosde un grupo, un único usuario de un grupo, algunos usuarios de un grupo o variosusuarios secuenciales, puede definir la lógica condicional en la actividad que resuelveel ejecutante basada en los datos de proceso y otra lógica que define en una tabla de



decisión. En tiempo de ejecución, el motor del proceso evalúa las reglas tal y como sehan configurado y asigna un ejecutante para la actividad. Select performer based onconditions (Seleccionar ejecutante según condiciones) , página 134 proporciona másinformación sobre este tema.

Usar alias

Un alias es un nombre descriptivo de una categoría de usuario o grupo que se usa enlugar del nombre real de usuario o grupo. El servidor sustituye en tiempo de ejecución elalias por el nombre del usuario o grupo real que se ajusta a la categoría en ese momentoy lugar. El uso de alias en las definiciones de actividad crea una plantilla de procesoflexible que se puede usar en distintas situaciones.

Supongamos, por ejemplo, que desea crear un flujo de trabajo para las solicitudesde vacaciones. Cada departamento de la compañía tiene un director diferente quedebe aprobar las vacaciones. En lugar de crear una plantilla de proceso diferente paracada departamento, desea crear una plantilla común para todos. Después de todo, elproceso comercial es el mismo en todos los departamentos. En lugar de usar nombres deejecutantes específicos para las actividades, usa un alias, por ejemplo, Director. Cuandose 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 conjuntosde alias hasta localizar el alias y su valor real asociado. Un conjunto de alias es unobjeto que define una lista de alias y sus valores reales correspondientes. Puede crearconjuntos de alias en Documentum Administrator. En la guía Documentum ContentServer Administration Guide (Guía de administración de Documentum Content Server) seproporciona información detallada sobre los conjuntos de alias. Puede asociar conjuntosde alias a usuarios concretos y, en Process Builder, identificar un conjunto de aliaspredeterminado para el flujo de trabajo.

Al incluir un alias como ejecutante para una actividad, puede especificar que el servidorresuelva el alias en tiempo de ejecución haciendo referencia al:• 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 elijaTambién puede hacer que el servidor exija al iniciador del flujo de trabajo queproporcione manualmente los valores de los alias cuando se inicia el flujo de trabajo.Para requerir al iniciador del flujo de trabajo resuelva los alias, hay que definir unconjunto de alias predeterminado para que la plantilla de proceso que contiene los aliaspero no los nombres a los que se asignan los alias. Consulte Elegir ejecutantes manuales,página 127 si necesita información detallada.



Permitir la delegación y la extensión

Al crear una actividad manual, debe especificar si el ejecutante de la actividad puede ono delegar la actividad en otro ejecutante o extender la actividad definiendo un ejecutanteadicional.

Con la delegación, el ejecutante original no completa la actividad. Con la extensión, encambio, tanto el ejecutante original como el ejecutante adicional designado completan laactividad.

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 disponibilidaddel ejecutante o los ejecutantes de una actividad y determina si no están disponibles.Cuando esto ocurre, el servidor delega automáticamente el trabajo en los usuariosque el ejecutante original designó en el cuadro de diálogo Disponibilidad para flujode trabajo. Si no hay ningún usuario identificado, o dicho usuario no está disponible,el elemento de trabajo se vuelve a asignar al supervisor del flujo de trabajo o sedevuelve al ejecutante original, dependiendo de una opción de configuraciónestablecida cuando se designó la actividad.

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

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

Consulte Seleccionar ejecutantes, página 125 si necesita más información sobre cómodefinir estas opciones.

Definir asuntos de tareas

Un asunto de tarea es un mensaje que proporciona al ejecutante de un elemento detrabajo información sobre ese elemento. El mensaje forma parte de la definición deactividad. Puede incluir referencias a uno o varios atributos cuyos valores son sustituidospor el servidor en tiempo de ejecución. Por ejemplo, supongamos que el asunto detarea 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 "PropuestaIngr" y r_package_name es "Primer borrador"; en tiempo de ejecución, el usuario ve:Please work on the Review task(from activity number 2) of the workflow Engr Proposal.The attached package is First Draft.

Los asuntos de tarea pueden tener hasta 255 caracteres (antes de que se resuelvan lasreferencias de variables) y contener referencias a los siguientes tipos 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 seleccionala opción Almacenar el nombre de documento en el paquete en el tiempo deejecución en el cuadro de diálogo Propiedades de proceso (consulte Definirpropiedades de la plantilla de proceso, página 73).

La referencia se debe incluir entre llaves. Los nombres de atributo y de tipo de objetodeben aparecer en 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

referencias de atributo.• Si el atributo al que se hace referencia es un atributo que se repite, el servidor

sustituye todos los valores y los separa por comas.• Si la cadena que se crea (una vez se han resuelto las variables) es superior a 512

caracteres, el servidor trunca la cadena.• Si un tipo de objeto y una referencia de atributo contienen un error. Por ejemplo,

si el tipo de objeto o el atributo no existe, el servidor no resuelve la referencia. Unerror de referencia sin resolver se muestra en el mensaje.

La cadena resuelta se almacena en el atributo task_subject del objeto de elemento decola asociado de la tarea. Una vez que el servidor ha creado el elemento de trabajo, nose cambiará el valor del atributo task_subject en el elemento de cola aunque cambienlos valores en cualquiera de los atributos de referencia.

Agregar un requisito de firma

Muchos procesos comerciales exigen cierto grado de responsabilidad. Una forma deproporcionarla es obligar a los ejecutantes a firmar las tareas que ejecutan. Al definiruna actividad manual en Process Builder, puede especificar que sea obligatorio que los



ejecutantes firmen para poder completar la actividad. La firma requiere que el ejecutanteescriba su contraseña para confirmar que ha ejecutado la tarea.

Nota: Content Server también admite firmas electrónicas y digitales como modo defirmar tareas o los documentos asociados a una tarea. Consulte la documentación deContent Server si necesita más información sobre estas opciones de firma avanzadas.

Definir valores de prioridad

En las actividades automáticas, debe indicar un valor de prioridad que determina elorden en el que el servidor ejecuta la actividad con respecto a otras acciones de lacola. Asimismo, también puede definir un valor de prioridad para las actividadesmanuales, que se refleja en la lista de tareas que se encuentran en la bandeja de entradadel ejecutante. La bandeja de entrada es una área específica del usuario que muestra lastareas actualmente asignadas al ejecutante.

Al iniciar una actividad automática, ésta se coloca en la cola de ejecución de una funcióndel servidor que se ejecuta de forma periódica. Esta función ejecuta las actividades enorden de prioridad. De forma predeterminada, ejecuta todas las actividades automáticasen cola cada vez que se activa, aunque un administrador de sistema puede limitar elnúmero de actividades gestionadas cada vez que se ejecuta la función. Si el valor deconfiguración del servidor max_wf_jobs se define como un número bajo y hay un grannú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 123 si precisa información sobrecómo definir la prioridad de una actividad.

Definición de de la prioridad inicial y antigüedad de tareas

En la mayoría de los procesadores de la cola, los elementos de trabajo aparecen en labandeja de entrada según su prioridad. Los elementos de máxima prioridad se asignanpara que se trabaje en ellos antes que en los elementos de trabajo de prioridad inferior.Los valores de prioridad y antigüedad son elementos esenciales a la hora de procesartareas de colas de trabajos. Cuando el sistema crea un nuevo elemento de trabajo, elservidor identifica la tarea como un elemento de cola de trabajos y comprueba la lógicaque permite asignar una prioridad inicial al elemento. Después de que la tarea esté en lacola, un trabajo de caducidad aumenta la prioridad de la tarea en función de otra lógica,que sube la tarea en la bandeja de entrada hasta que sea la tarea en la que se trabaja. Elaumento de la prioridad puede provocar que el administrador de la cola redistribuyalas tareas o reasigne recursos entre las colas de trabajos.



El nivel de prioridad que tiene inicialmente una tarea y la velocidad con la que aumentala prioridad se pueden definir en la política de la cola de trabajos o en la plantilla deactividad de la tarea. Mediante una política de cola de trabajos, el administrador de lacola o el gestor de colas puede especificar la prioridad inicial de la tarea y la frecuenciay porcentaje en los que se incrementa en función de valores diferentes definidos enla política.

Para escenarios de inicialización y clasificación por antigüedad más complejos, puedeutilizar Documentum Composer para crear un módulo de prioridad que contenga lalógica para calcular y actualizar dinámicamente la prioridad en función de los datos deproceso u otros atributos pertenecientes al proceso. Un módulo de prioridad puede estarasociado a una política de cola de trabajos 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 laprioridad inicial de 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ódulode prioridad asociado a la definición de actividad, el sistema utiliza el métodogetInitialPriority() del módulo y establece el valor de devolución como prioridadinicial.

2. Módulo de prioridad asociado a la política de cola de trabajos: si hay un módulode prioridad asociado a la política de cola de trabajos, el sistema utiliza el métodogetInitialPriority() del módulo y establece el valor de devolución como prioridadinicial.

3. Política de cola de trabajos: si no hay ningún módulo de prioridad asociado a latarea, el sistema utiliza el parámetro initial_priority del objeto de política de cola detrabajos para establecer su 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 detodas las tareas de la 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ódulode prioridad asociado a la definición de actividad, el sistema utiliza el métodogetIncrementPriority() del módulo y utiliza el valor de devolución como prioridadde incremento.

2. Módulo de prioridad asociado a la política de cola de trabajos: si hay un módulode prioridad asociado a la política de cola de trabajos, el sistema utiliza el método



getIncrementPriority() del módulo y utiliza el valor de devolución como prioridadde incremento.

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

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

Las políticas de cola de trabajos permiten a los administradores o gestores de la coladefinir la frecuencia en la que se caducan las tareas de una cola de trabajos y la prioridaden la que están establecidas inicialmente.

Cuando el sistema crea una tarea de la cola de trabajos, la prioridad inicial de la tarease establece en función de la configuración de prioridad inicial de la política de cola detrabajos asociada a esa tarea. Mientras que la tarea permanezca en la cola, cada vez quese ejecuta el trabajo de dm_QmPriorityAging, aumenta la prioridad de la tarea en lacantidad especificada en la configuración de prioridad de incremento de la política decola de trabajos asociada a la tarea. La guía Documentum Webtop User Guide proporcionamás información sobre cómo establecer la prioridad y la lógica de caducidad para lastareas en función de las políticas de cola de trabajos.

Establecimiento de la prioridad dinámica y de la lógica decaducidad para tareas

Puede haber situaciones en las que tanto la prioridad inicial como la cantidad deincremento de la prioridad deban calcularse dinámicamente. En estos casos, se crea unmódulo de prioridad que utiliza el sistema en lugar de la política de cola de trabajos paraestablecer la lógica de clasificación por prioridad y antigüedad. Se puede seleccionarun módulo de prioridad al crear la cola de trabajos en Webtop o TaskSpace o se puedeseleccionar al crear la actividad en Process Builder.

Asociar un módulo de prioridad de colas de trabajo a una actividad, página 127proporciona información detallada sobre cómo asignar un módulo de prioridad a unaactividad.

Los datos de proceso se pueden utilizar para establecer la prioridad inicial y aumentarlaen función de valores del flujo de trabajo. Por ejemplo, cuando una aplicación depréstamos perteneciente a un cliente preferente pasa por una cola de trabajos, se lepuede asignar inmediatamente un valor de prioridad más alto que una aplicación depréstamos de otros clientes. Además, si la solicitud del préstamo es para una cantidad



mayor o proviene de un agente de préstamos preferente, la prioridad puede aumentar amayor velocidad para asegurarse de que el supervisor de la cola recibe una alerta si latarea no se completa dentro de un período de tiempo especificado. Este tipo de lógicapuede resultar especialmente útil para aumentar la prioridad de una tarea cuando seacerca a una fecha límite o alguna otra restricción horaria. La prioridad aumenta másrápidamente a medida que se acerca la fecha límite, subiendo la tarea en la cola a unavelocidad superior.

Para establecer la prioridad y los valores de caducidad:

1. Cree un módulo de prioridad.Cree una clase Java para la interfaz IWQTaskPriority y la interfaz IDfModule.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 sobrecómo generar 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 decliente.

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 proceso

Al definir un proceso comercial, los datos que se van a manejar en el flujo deben estarrepresentados de una forma significativa. Los datos de un flujo pueden ser variables deflujos de trabajo, variables de proceso o paquetes asociados con el flujo.

Los datos de proceso son los distintos tipos de datos que fluyen por el proceso, como undocumento, un formulario o variables de proceso, como números de pieza o direccionesde clientes. Existen dos tipos principales de datos de proceso que se pueden definir enun proceso: datos de paquete y variables de proceso. Ambos tipos de datos se debendefinir en el nivel del proceso para que se puedan utilizar en cualquier actividadindividual de dicho proceso.

Introducción a los paquetes

Los paquetes son los objetos sobre los que las actividades realizan su trabajo. Un paquetepuede ser un documento, formulario o cualquier otro dato asociado con una actividad.Todos los paquetes gestionados por un objeto de proceso se muestran como parte de laspropiedades del proceso. A continuación, se especifican los paquetes con los que trabajacada actividad. Una actividad puede gestionar varios paquetes. Cada paquete puedetener una plantilla de formulario asociada, que define la interfaz de usuario que losejecutantes de la actividad ven al trabajar en el paquete.

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

Para definir un paquete, debe identificar el elemento que se procesará con el flujo detrabajo. También tiene la opción de elegir un formulario que utilizará, para realizar latarea, el ejecutante de la actividad que 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 decompra utilizará el mismo documento de orden de compra como paquete para todaslas actividades necesarias.



En otros casos, sin embargo, el trabajo que realiza una actividad da lugar a una versiónnueva de un documento a partir del paquete entrante. Por ejemplo, un usuario podríarecibir un documento para que lo revise. El usuario retira el documento, le agregacomentarios o revisiones y lo registra. En este caso, se desea que la actividad envíe unanueva versión del componente cuando envíe el paquete a la siguiente actividad. EnProcess Builder, puede realizar este escenario configurando la actividad para reenviarlos 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 etiquetade versión simbólica, como Borrador o ACTUAL.

El trabajo que se realiza en ciertas actividades requiere el envío por parte de éstas deun paquete completamente diferente al paquete recibido. 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 aldepartamento de contabilidad. En Process Builder, puede configurar una actividad paraaceptar 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 ProcessBuilder, consulte Cambiar datos de proceso en una actividad, página 158.

Introducción a las variables de proceso

Las variables de proceso son distintos tipos de datos que circulan por el procesocomercial. Puede tratarse de tipos de datos simples (una cadena, un valor booleanoo una fecha) o complejos, es decir, grupos de datos relacionados lógicamente comopedidos, componentes de fabricación, etc. Los tipos de datos complejos se definen en laventana Structured Data Type (Tipo de datos estructurado), donde, como tipos de datosestructurados, pueden reutilizarse en varias plantillas de proceso en un repositorio.

Los valores predeterminados sólo se pueden establecer en el tipo de datos simples. Lostipos de datos complejos tienen los valores predeterminados en la definición de tipo.

Los atributos de tipos de datos estructurados (variables de proceso) pueden identificarsepara su utilización en la generación de informes. El motor del proceso expone loselementos para que las herramientas generadoras de informes puedan utilizarlos y creartanto informes estáticos como de BAM. Las variables de proceso se definen para unproceso mediante el componente Propiedades de proceso.

Gestionar las variables de proceso, página 79 proporciona más información sobrecómo definir variables de proceso para un flujo de trabajo. Crear tipos de datosestructurados, página 57 proporciona más información sobre cómo definir los tipos dedatos estructurados para su repositorio.



Introducción a los parámetros de proceso

Los parámetros de proceso permiten a los administradores de la aplicación utilizar laficha Administration de TaskSpace para modificar valores constantes que se utilizan alo largo de un proceso. Los parámetros de proceso se pueden utilizar en umbrales,fechas límite, roles de escalado y otros valores fijos durante un proceso. Cuando eladministrador cambia los valores del parámetro en la ficha Administration, cualquierinstancia de proceso nueva o que se esté ejecutando utiliza el 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 esaplantilla. A diferencia de las variables de proceso, los parámetros de proceso no sepueden compartir ni reutilizar en varias plantillas de proceso en un repositorio.

Por ejemplo, un administrador de la aplicación puede necesitar realizar cambios enlos valores del ejecutante para responder a los distintos requisitos comerciales. Eldiseñador de procesos crea una plantilla de proceso que incluye un parámetro deproceso approver1 y crea un valor constante manager. Una vez completado e instalado elproceso, el administrador de la aplicación puede abrir la plantilla de proceso en la fichaAdministración de TaskSpace y utilizar el formulario de parámetro de proceso asociadopara 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 deproceso desde el lado de origen (izquierda) del asignador de datos. El diseñador deproceso puede crear una asignación para cambiar el destinatario para una notificaciónpor correo electrónico creando el recipient2 del parámetro de proceso con un valor [email protected]. El parámetro de proceso aparece en el lado de origen delasignador de datos en la plantilla de actividad y está disponible para la 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ónicoescribiendo un nuevo valor en el formulario del parámetro de proceso.

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

Asociar plantillas de formulario con paquetes

Puede asociar una plantilla de formulario con cada paquete que pasa a una actividadmanual. Esta plantilla proporciona una interfaz de usuario personalizada al ejecutanteque ve e introduce los datos. Dependiendo de las opciones de configuración, el ejecutantepuede consultar el formulario cuando se da alguna de la siguientes circunstancias:• Un usuario abre el paquete desde la bandeja de entrada de Documentum



• Al ver las propiedades del paqueteEl ejecutante rellena el formulario para completar la actividad o actualizar laspropiedades del paquete. Si la actividad recibe más de un paquete, el ejecutante rellenalos formularios asociados a cada paquete. Si un paquete no tiene un formulario asociado,el ejecutante ve un cuadro de diálogo predeterminado de Task Manager.

Se puede asociar una plantilla de formulario a cada paquete cada vez que los agrega alflujo de trabajo, tal y como se describe en Gestionar los paquetes, página 76. Tambiénpuede asociar una plantilla de formulario a un paquete al configurar una actividadmanual. Un paquete puede tener sólo un formulario asociado a la vez, pero esteformulario podrá cambiar a medida que el paquete pase a través del flujo de trabajo. Porejemplo, el formulario que se muestra a un administrador que aprueba una solicitudde compra podría ser diferente al que cumplimenta la persona que interpone lasolicitud. Los datos subyacentes de los dos formularios son los mismos, pero la forma demostrarlos varía en función del usuario. Al configurar una solicitud, puede establecerla plantilla de formulario utilizada para esa actividad de forma que sea diferente a laasociada con el paquete a nivel de proceso comercial.

Para asociar una plantilla de formulario con un paquete, ambos deberán tener el mismomodelo de datos subyacente. Cuando selecciona formularios, Process Builder sólomuestra las plantillas de formulario cuyo modelo de datos coincide con el tipo de datosseleccionado para el paquete. Si selecciona la plantilla de formulario antes de establecerel tipo de objeto del paquete, Process Builder establece el tipo de objeto para que coincidacon el modelo de datos de la plantilla de formulario seleccionado.

Si necesita más información sobre los formularios y las plantillas de formularios, consultela guía Documentum Forms Builder User Guide.

Definir condiciones de desencadenamiento

Un desencadenador es una señal que indica que la actividad puede empezar. Lascondiciones de desencadenamiento definen los criterios de inicio de una actividaddeterminada. En tiempo de ejecución, el servidor no inicia una actividad hasta que secumpla la condición de desencadenamiento de la misma. Esta condición puede incluirde forma opcional un evento de desencadenamiento que debe tener lugar para que laactividad se inicie.

Si la actividad presenta varios flujos entrantes, puede especificar el número de lasactividades anteriores que se deben haber completado antes de que se inicie la actividad.La condición de desencadenamiento es el número mínimo de flujos que deben haberentregado paquetes a la actividad para que ésta se inicie. Por ejemplo, si una actividadpresenta tres flujos entrantes, puede especificar que la actividad se inicie cuando dos delos tres flujos hayan entregado sus paquetes. La condición de desencadenamiento debetener 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 deun evento definido por el sistema, como dm_checkin, o se puede inventar un nombrede evento, como "promovido" o "presentado". Sin embargo, debido a que no es posibleregistrar un flujo de trabajo para que reciba notificaciones de eventos, el evento se debesituar de forma explícita en la cola del flujo de trabajo usando la API de Documentum.Si incluye un evento de desencadenamiento en la condición de inicio, el servidor debeencontrar el evento identificado en la cola del flujo de trabajo para que se inicie laactividad. El mismo evento se puede usar como desencadenador de varias actividades,aunque la aplicación deberá poner el evento en cola para cada una de ellas. ConsulteDocumentum Content Server Fundamentals (Fundamentos de Documentum ContentServer) para obtener más información sobre cómo definir y poner eventos en cola.

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

Definir temporizadores

Al configurar una actividad, puede definir temporizadores que se activen si el trabajo noparece fluir como debiera. Por ejemplo, puede especificar que el supervisor del flujo detrabajo reciba un mensaje de advertencia si la actividad no se inicia en un período de12 horas después del inicio del flujo de trabajo, o enviar un mensaje al ejecutante de laactividad si ésta no se ha completado transcurridas cuatro 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 un perí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 un período de tiempo especificado tras el inicio de la actividad.

Los administradores pueden modificar ambos temporizadores en DocumentumTaskSpace. Si hay varios temporizadores para una tarea, el sistema emplea el primero deellos como fecha de vencimiento en TaskSpace. El sistema utiliza la fecha de vencimientopara calcular las tareas atrasadas en TaskSpace. En la Guía de configuración de DocumentumTaskSpace se proporciona información detallada sobre el cambio de los temporizadoresen la ficha Administración de TaskSpace.

Cuando se inicia un flujo de trabajo, el sistema crea pre-temporizadores para todas lasactividades que tienen pre-temporizadores configurados. Al mismo tiempo, el sistemacrea la tarea para la primera actividad del flujo de trabajo. Si se trata de una actividadautomática, el agente de flujo de trabajo procesa la tarea inmediatamente y mueve elflujo de trabajo a la segunda actividad. Cuando se desencadena la segunda actividad, elservidor desactiva el pre-temporizador.



Dependiendo de la naturaleza de la actividad, un temporizador vencido puede realizaruna de estas 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 actividad actual.• Ejecutar en método Java: ejecutar un método de flujo de trabajo automatizado (sólo

disponible para usuarios con privilegios de superusuario).• Delegar tarea: delegar la tarea en otro ejecutante.• Completar tarea: completar automáticamente una tarea manual y hacer que el flujo

de trabajo pase a la siguiente actividad.Las dos primeras acciones están disponibles para cualquier temporizador de actividad.Todos los temporizadores pueden invocar un método siempre que el ejecutante de laactividad tenga los privilegios de superusuario necesarios. Las acciones Delegar tareay Completar tarea sólo están disponibles como acciones de post-temporizador paraactividades manuales que gestionan un único elemento de trabajo.

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

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

De forma predeterminada, los usuarios reciben notificaciones de advertencia en formade elementos en la cola de la bandeja de entrada. No obstante, puede configurar eltemporizador para enviar una notificación por correo electrónico mediante una plantillade correo electrónico personalizada.

Consulte Establecer temporizadores de advertencia, página 141 para obtener másinformación.

Nota: No se detienen los post-temporizadores cuando una tarea se detiene o se suspendey continuará contando el tiempo. Por ejemplo, cuando se detiene una tarea de flujo detrabajo, no se detiene el post-temporizador asociado. El post-temporizador continúateniendo en cuenta el tiempo designado para la tarea como si la tarea estuviera todavíaen curso.

La tarea de verificar los temporizadores de advertencia y de realizar las accionesrequeridas la realiza la función de administración del sistema dm_WfmsTimer. El trabajodm_WfmsTimer se instala con Content Server y se activa al instalar Process Engine.

Cuando está activo, la configuración predeterminada es que el trabajo se ejecute una vezcada hora. Para cambiar la frecuencia de ejecución del trabajo, utilice Documentum



Administrator. Consulte la guía Documentum Administrator User Guide para obtenerinformación adicional sobre cómo cambiar la configuración de trabajos.

Configurar notificaciones

Content Server tiene la capacidad de controlar eventos particulares y notificar a losusuarios interesados cuando se produzcan. Los eventos son acciones concretas aplicadasa los objetos de Documentum. En el contexto de Process Builder, los eventos pertinentesson acciones relacionadas con el flujo de trabajo, como un usuario iniciando el trabajo enun elemento de trabajo o delegando un elemento de trabajo en otro usuario.

Al configurar una plantilla de proceso o una actividad, podrá asociar plantillas demensaje de correo electrónico personalizadas con varios eventos clave relacionados conel flujo de trabajo. Una plantilla de correo electrónico es un documento con un formatoespecial almacenado en el repositorio de Documentum que define el asunto y cuerpo deun mensaje de notificación por correo electrónico. La plantilla puede incluir variablescuyos valores reemplaza el servidor en el tiempo de ejecución. El mensaje entregadoincluye información contextual, como el nombre del ejecutante actual o el paquete quese enruta. Si un evento tiene asociada una plantilla de este tipo, cualquier usuario quese haya registrado para recibir notificación del evento obtendrá un mensaje generado apartir de la plantilla de correo asociada. La guía Documentum Process Builder DevelopmentGuide proporciona más información sobre cómo crear plantillas de correo electrónicopersonalizadas.

Nota: El servidor genera y envía mensajes de notificación únicamente cuando unoo varios usuarios se han registrado para recibir notificación del evento. El manualDocumentum Content Server Fundamentals proporciona información sobre cómoregistrarse para las notificaciones de eventos.

Consulte Definir notificaciones, página 154 si necesita más información sobre cómodefinir opciones de notificación.

Definir transiciones de actividad

Si una actividad presenta varios flujos salientes, tal vez desee que se envíen paquetesa todas las actividades siguientes o sólo a determinadas actividades en función delresultado de la actividad. Por ejemplo, podría ofrecer a un ejecutante que revisara eldiseño de un nuevo formulario la opción de reenviar el diseño al siguiente revisor odevolverlo al diseñador para que lo corrija. Esta lógica de ramificaciones se configuracreando flujos desde la actividad a las dos posibles actividades siguientes y permitiendoal ejecutante elegir la ruta que desea seguir.



El tipo de transición de una actividad define el modo en el que se seleccionan lasactividades siguientes cuando se completa la actividad. Existen tres tipos de transiciones:

• Seleccionar todas las actividades conectadas: el flujo continúa para todas lasactividades siguientes enlazadas a esta actividad, incluidos flujos de avance y derechazo.

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

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

Si la actividad es una actividad de grupo, es decir, si la categoría del ejecutante es 4(Todos los usuarios del grupo) u 8 (Algunos usuarios de un grupo), puede especificarcuántos miembros del grupo deben completar la tarea antes de que el servidor considerela actividad general como completada y reenvíe los paquetes a las siguientes actividades.Por ejemplo, si cinco usuarios reciben un elemento de trabajo para una actividad, puedeespecificar que la actividad esté completada cuando tres usuarios hayan terminado.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úmerode actividades que el ejecutante puede seleccionar. Por ejemplo, si una actividad tienetres flujos salientes, puede permitir al ejecutante enviar paquetes a los tres, o bien puedeexigir que el ejecutante sólo seleccione uno o dos.

Si permite que un grupo de ejecutantes seleccione las siguientes actividades, es decir, sila categoría del ejecutante es 4 u 8 y la opción de transición es Permitir al ejecutanteseleccionar las siguientes actividades, también debe indicar al servidor cómo combinarlas selecciones de los ejecutantes. Cuando un grupo selecciona actividades, es posibleque algunos ejecutantes seleccionen actividades de reenvío y que otros seleccionenactividades de rechazo. En ese caso, ¿qué actividades debería iniciar el motor del flujode trabajo? ¿Todas las actividades seleccionadas, sólo las de rechazo o sólo las dereenví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 detransición para la actividad.

Determinar las condiciones de transición

Las condiciones de transición permiten definir actividades que distribuyen tareas deforma diferente en función de los resultados de la actividad. Una condición de transiciónes una condición lógica con uno o varios flujos asociados. Cuando una actividad secompleta en tiempo de ejecución, el servidor evalúa sus condiciones de transición



para determinar las actividades que se han de iniciar a continuación como el siguientepaso en el flujo de trabajo. El servidor mueve el flujo de trabajo hacia las actividadesasociadas a la primera condición de transición que sea VERDADERO. Una actividadpuede presentar varias condiciones de transición, aunque el servidor solo selecciona unaen tiempo de ejecución: la primera que sea VERDADERO.

Las condiciones de transición deben ser expresiones booleanas. Las condiciones detransición se usan normalmente para verificar los atributos de los componentes delpaquete, el flujo de trabajo contenedor o el último elemento de trabajo completado.Cuando el paquete de flujo de trabajo es un documento XML, puede crear condicionesde transición que comprueben el valor de un elemento XML en el documento.

Al usar condiciones de transición, siempre se incluye una opción Else. Esta opción es laacción que toma el servidor si ninguna condición de transición es aplicable. La opciónElse no tiene asociada ninguna condición y solo puede aparecer una por actividad.

Si precisa información sobre la definición de las condiciones de transición de unaactividad, consulte Definir las reglas de transición de actividad, página 149.


Capítulo 2

Utilizar Process Builder

En este capítulo se describe cómo utilizar el entorno de diseño de Process Builder y en él se incluyenlos temas siguientes:• Entorno de diseño de Process Builder, página 47• Barra de herramientas de Process Builder, página 49• Ventana Activity Templates (Plantillas de actividades), página 55• Ventana Structured Data Types (Tipos de datos estructurados), página 56• Panel del editor de plantillas de proceso, página 61• Navegador, página 68

Entorno de diseño de Process Builder

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

• El panel izquierdo contiene el subsistema Navegador de recursos, el cual muestraplantillas de actividad y tipos de datos estructurados que se pueden agregar ala plantilla de proceso.

• El panel izquierdo es el editor de plantillas de proceso, el cual muestra unarepresentación grá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 yarrástrelo a una nueva posición.

Aparece un par de flechas entre la parte superior de los paneles. Para expandir uno deellos de modo que ocupe toda la ventana, haga clic en la flecha que apunta en sentidocontrario al panel que desea expandir. Para que Process Builder recupere la vista de dospaneles, haga clic en la flecha que apunta en el otro sentido, que ahora aparece en elborde de la ventana. También puede abrir varios procesos del mismo repositorio en eleditor de plantillas de proceso, permitiéndole ver y comparar los procesos. Ver variosprocesos utilizando fichas, página 67 proporciona más información sobre este tema.



En Resource Navigator (Navegador de recursos), puede hacer clic en los botones de labarra de título que muestran el nombre de cada ventana secundaria para minimizary restaurar las ventanas.

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

Si el flujo de trabajo es demasiado grande para mostrarse en la ventana, puede usar elnavegador para ver 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



Barra de herramientas de Process Builder

Para elegir los iconos que desea que aparezcan en la barra de herramientas, use lasopciones del menú Ver. Process Builder proporciona tres conjuntos de iconos en labarra de herramientas:

• Iconos estándar que proporcionan acceso a los comandos desde los menús Archivoy Editar.

• Iconos de flujo de trabajo que permiten crear actividades o flujos y mostrar laspropiedades de los objetos de flujos de trabajo.

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

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

Para seleccionar los iconos que aparecen en la barra de herramientasde 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 deherramientas disponible. Los grupos que se muestran en ese momento en dichabarra tienen una marca de verificació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 deherramientas. Si, por el contrario, selecciona una opción con marca, ésta desaparecey el grupo se quitará de la barra de herramientas.

Definir preferencias de la plantilla de proceso

Esta sección describe las siguientes funciones disponibles en el menú Preferencias:

• Compartir plantillas de proceso con Process Analyzer, página 49• Definir el número de puerto para la depuración de actividades entrantes, página 51• Gestionar las carpetas de plantillas de actividades, página 52• Definir preferencias de mensajes de la plantilla de proceso, página 53

Compartir plantillas de proceso con Process Analyzer

Una vez que un proceso comercial se ha definido o modificado en Process Analyzer oProcess Builder, el proceso se puede compartir con la otra aplicación como un archivo



XML (en formato XPDL) que se guarda en una carpeta compartida. Cada aplicaciónpuede acceder al archivo XML desde la carpeta compartida, abrirlo y comenzar atrabajar con el proceso. Definir ubicaciones de la carpeta compartir proceso, página 51proporciona detalles sobre la configuración de carpetas compartidas.

Nota: Compartir procesos se habilita cuando Process Analyzer y Process Builder estáninstalados en el mismo equipo. Para compartir procesos cuando las aplicaciones no estáninstaladas en el mismo equipo, use las opciones para importar y exportar. Importarplantillas de proceso, página 97 y Exportar plantillas de proceso, página 100 proporcionemás información sobre esas opciones.

UseObtener proceso del analista para abrir un proceso en Process Builder, que se creó omodificó usando Process Analyzer. Use Compartir proceso con analista para hacer queun proceso de Process Builder esté disponible para un analista usando Process Analyzer.

Los tipos de actividad automática y manual se mantienen durante el proceso decompartir, aunque el desarrollador deberá agregar las definiciones como, por ejemplo,los métodos y temporizadores, a Process Builder. En los procesos compartidos nose incluyen los paquetes.

Asimismo, si comparte un proceso que contenga varias actividades de finalización desdeProcess Analyzer, Process Builder agregará una actividad vacía adicional a la que seconectarán todas las actividades de finalización. (Process Builder admite sólo unaactividad de finalización, mientras que los procesos exportados desde Process Analyzerpueden contener varias actividades de finalización).

Para compartir un 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 Process Analyzer puede acceder al proceso.

2. Haga clic en Aceptar.

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 losarchivos que están en la carpeta compartida de Process Analyzer.

2. Seleccione el archivo XPDL que desea abrir

3. Haga clic en Aceptar.Process Builder creará un nuevo borrador de plantilla de proceso basado en elproceso de Business Process Analyzer.Si la información de ubicación del diseño de la actividad está disponible, se aplicaa la plantilla de proceso compartido. Por otra parte, el sistema utilizará el diseñopredeterminado y la configuración de vista gráfica. Puesto que la información de



interfaz de usuario, tal como gráficos o imágenes, no se incluye en los procesoscompartidos, deberá volver a crearla en Process Builder.A continuación, deberá definir la información de ejecución para el proceso queutiliza el Inspector de actividades.Consulte el Capítulo 7, Trabajar con actividades si necesita más información sobrecómo definir 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ónde las carpetas en las cuales se guardan los procesos se puede configurar desdecualquiera de las aplicaciones.

Nota: Las ubicaciones de la carpeta compartir proceso se guardan localmente comopreferencias para la instancia Process Builder.

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 clicen Seleccionar.Aparecerá el cuadro de diálogo Abrir.

3. Desplácese al directorio donde está instalado Documentum y cree una carpeta paralos archivos XPDL 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 XPDLde Process Builder.

Definir el número de puerto para la depuración deactividades entrantes

Para poder depurar una actividad entrante en el Debugger de proceso, debe especificarel número de puerto en el cuadro de diálogo Preferencias.

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 WebService Inbound,seleccione el número de puerto que el Debugger utilizará para depurar actividadesentrantes.

Gestionar las carpetas de plantillas de actividades

El usuario controla las carpetas de plantillas que se mostrarán mediante el cuadro dediálogo Preferencias de Process Builder. Las preferencias que establece sólo se aplicana su identificador de usuario. Cada usuario puede establecer distintas preferencias. Siprecisa información sobre la forma de controlar qué carpetas de plantillas de actividadesaparecen en la ventana Activity Templates (Plantillas de actividades), consulte Gestionarlas plantillas de actividad dentro de las carpetas, página 115.

El cuadro de diálogo Preferencias también habilita la configuración de las ubicacionesde la carpeta compartir proceso si Process Analyzer y Process Builder están instaladosen el mismo equipo. Compartir plantillas de proceso con Process Analyzer, página49 proporciona más información sobre cómo establecer las ubicaciones de carpeta deuso compartido.

Para agregar una nueva carpeta de plantilla de actividades a la ventanaActivity Templates (Plantillas de actividades):

1. Seleccione Archivo > Preferencias o haga clic con el botón derecho del ratón en unacarpeta existente y seleccione Nuevo.Aparecerá el cuadro de diálogo Preferencias. El cuadro de lista de la izquierdamuestra las carpetas disponibles, mientras que el de la derecha muestra las carpetasque se están visualizando actualmente en Process Builder.

Nota: Las preferencias se guardan de forma independiente para cada usuario. Lalista de carpetas puede variar si inicia sesión como otro usuario.

2. Para agregar una nueva carpeta a la lista de carpetas disponibles, haga clic en Nuevoy escriba un 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 hagaclic en Aceptar en el cuadro de diálogo.

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

Para quitar una carpeta de la ventana Activity Templates (Plantillas deactividades):

1. Seleccione Archivo > Preferencias.



Aparecerá el cuadro de diálogo Preferencias. El cuadro de lista de la izquierdamuestra las carpetas disponibles, mientras que el de la derecha muestra las carpetasque se están visualizando actualmente en Process Builder.

Nota: Las preferencias se guardan de forma independiente para cada usuario. Lalista de carpetas puede variar si inicia sesión como otro usuario.

2. Para quitar una carpeta de la ventana Plantillas de actividad, resalte el nombre de lamisma en el cuadro de lista de la derecha y haga clic en << Quitar.El nombre se desplazará al cuadro de lista de la izquierda y desaparecerá de laventana Activity Templates (Plantillas de actividades).


Definir preferencias de mensajes de la plantilla deproceso

Puede especificar cuándo el sistema le indica que valide o instale las plantillas despuésde guardarlas.

Para definir las preferencias de la plantilla de proceso:

1. Seleccione Archivo > Preferencias.Aparecerá 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 lasplantillas al guardarlas.Para poder utilizar una plantilla de proceso a fin de crear un flujo de trabajo quese está ejecutando actualmente, se debe validar e instalar. Si activa la casilla deverificaciónMostrar siempre preguntas de validación e instalación después deguardar, Process Builder le preguntará si desea validar e instalar la plantilla cadavez que la guarde. Si no activa dicha casilla, no aparecerán esas preguntas. Debevalidar e instalar explícitamente la plantilla y sus actividades antes de poder crearlos flujos de trabajo a partir de ella.

3. Para reanudar la presentación del mensaje, seleccione Restablecer para mostrarlos mensajes de advertencia.




Actualizar datos de proceso en la base de datos de BAM

La página Actualizar definiciones de datos de BAM permite actualizar los datos deproceso seleccionados en Process Builder con los datos de informes de la base de datosde BAM. De esta forma se asegurará de que la estructura de los datos de Process Buildercoincide con la estructura de BAM. Esta opción actualiza los datos empresariales deBAM con los datos de proceso seleccionados en la página Actualizar definiciones dedatos de BAM.

Las definiciones de datos se deben actualizar sólo cuando se utilizan por primera vez o siha habido un cambio en las definiciones de datos. Por ejemplo, si modifica un tipo dedatos estructurados para agregar un nuevo atributo que se pueda incluir en los informeso para cambiar el nombre de un atributo que se puede incluir en los informes, debeactualizar esta nueva definición con BAM. Además, si crea un nuevo tipo de objeto quese utiliza en un paquete, estas definiciones de tipo de paquete se deben actualizar con labase de datos de BAM.

BAM debe estar instalado y configurado correctamente en Content Server para que serealice la actualización.

Nota: Los datos de proceso se deben habilitar para informes en Process Builder, parapoder actualizar los datos de informes en la base de datos de BAM.

Para 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 de datos de BAM.

En el cuadro de lista sólo aparecen los tipos de datos estructurados que no sehan actualizado.

• Haga clic en Seleccionar todo para actualizar todos los tipos de datosestructurados que aparecen en el cuadro de texto.

3. Haga clic en Actualizar.

Para 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 datosde BAM, haga clic en Actualizar en el cuadro de grupo Tipos de objeto.

2. Haga clic en Cerrar.



Ventana Activity Templates (Plantillas deactividades)

La ventana Activity Templates (Plantillas de actividades), situada en el lado izquierdode la ventana de Process Builder, muestra plantillas de actividad predefinidas que sepueden agregar a la plantilla de proceso. Las carpetas de plantillas de actividades ofrecenuna forma de organizar plantillas de actividad en grupos relacionados. Por ejemplo, losnombres de las carpetas pueden representar categorías generales de actividades, comoAprobaciones e Integración.

Cada plantilla de actividad representa un tipo concreto de actividad y puede incluirpropiedades especiales que sean específicas de dicho tipo de actividad. Por ejemplo, unaplantilla de actividad para el envío de correo electrónico a socios externos incluye unapropiedad para las direcciones de correo electrónico. Consulte el apartado Capítulo 7,Trabajar con actividades si necesita más información sobre las plantillas de actividad.

La visualización de las carpetas de plantilla se controla mediante el cuadro de diálogoPreferencias de Process Builder. En Gestionar las carpetas de plantillas de actividades,página 52 se proporciona información detallada sobre cómo configurar las carpetas queaparecen en la ventana.

Cada carpeta de plantillas de actividades se corresponde con una carpeta del sistemaen el repositorio de Documentum. Estas carpetas tienen el mismo nombre que lascarpetas que residen en la carpeta del sistema System/Workflow/Activity Templates. Lacarpeta incluye los objetos dm_activity que se corresponden a las plantillas de actividadde la carpeta.

Para agregar una actividad a la plantilla de proceso, arrastre la plantilla de actividadpertinente desde la ventana Activity Templates (Plantillas de actividades) hasta laubicación que desee en el editor de plantillas de proceso y, a continuación, defina laspropiedades de la actividad. Para ver o modificar las propiedades de la plantilla deactividad, haga doble clic en su icono en la carpeta de plantillas de actividades. Consulteel Capítulo 7, Trabajar con actividades para obtener más información sobre la forma dedefinir propiedades de las actividades y sus plantillas.

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

Las plantillas de actividad aparecen en la ventana en uno de estos tres estados: borrador,validado e instalado. Un icono representa cada estado. Sólo las plantillas de actividadesinstaladas se pueden agregar a una plantilla de proceso. Puede validar, instalar ydesinstalar una plantilla de actividades en la ventana Plantillas de actividades si utilizalas funciones del menú contextual. En Validar e instalar plantillas de actividad, página117 encontrará más información sobre este tema.



Tabla 2. 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 lostipos de datos estructurados que se han definido en el repositorio. Se muestran en unaestructura jerárquica organizada en categorías que se define en función de su uso en sunegocio.

Utilice esta ventana para agregar y eliminar tipos de datos estructurados mediante elAsistente para Tipos de datos estructurados, para crear o eliminar categorías, y ver losdetalles de los tipos de datos estructurados. También puede utilizar esta ventana parainiciar un asistente que le permita crear un tipo de datos estructurados a partir de unesquema XML.

Creación de categorías de tipos de datos estructuradosy grupos

Puede organizar los datos de proceso en categorías jerárquicas de datos basadas en laorganización de cada empresa. Dentro de dichas categorías se encuentran los grupos yatributos que componen los tipos 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 estructuradoy seleccione Agregar categoría.También puede agregar una categoría si selecciona Cambiar categorías en elAsistente para agregar tipos de datos estructurados.Aparecerá el cuadro de diálogo Seleccionar categoría con el árbol de jerarquía ylos nodos disponibles.

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 yescriba el nombre de la nueva categoría.

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


Para eliminar una categoría

1. En la ventana Structured Data Types (Tipos de datos estructurados), resalte lacategoría que desee eliminar.

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

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

Para 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.

Para actualizar el contenido de la ventana Structured Data Type (Tipo dedatos 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 disponibledentro del repositorio.

Crear tipos de datos estructurados

Un tipo de datos estructurado es una manera de representar datos empresariales quepertenecen al flujo del proceso y que, generalmente, consta de los siguientes elementosde datos: Nombre, Tipo, [Valor predeterminado].

Existen dos clases de tipos de datos estructurados: simples y complejos.Un tipo dedatos simple es un único atributo, como una cadena o un valor booleano. Un tipo dedatos complejo está formado por varios atributos. Por ejemplo, los elementos de unasolicitud de asignación se pueden organizar en el grupo Solicitud con los atributosnombre_solicitante, dirección_solicitante y tipo_equipamiento. Dentro de cada tipode datos estructurado, puede organizar también los atributos en grupos relacionadosque 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 atributospara la ciudad y el estado.

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

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 barrade herramientas o haga clic con el botón secundario del ratón en la ventana en laventana Tipo de datos 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 Cambiar categoríasy agregue una nueva categoría al nodo seleccionado. En Creación de categoríasde tipos de datos estructurados y grupos, página 56 encontrará procedimientosdetallados para la creación de categorías.

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

Nota: Los nombres deben tener menos de 70 caracteres y deben utilizar caracteres deun byte. El nombre no se puede modificar una vez que se ha guardado.

Para cambiar un nombre, debe asegurarse de que el tipo de datos estructurado noestá 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 ventanaTipos de datos estructurados.

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

5. Puede crear un grupo de atributos si selecciona el icono Agregar grupo .

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

6. Escriba el nombre del grupo.

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

7. Haga clic en del icono agregar para agregar un atributo al tipo de datosestructurado.Puede quitar un atributo si hace clic en el icono Quitar .

8. Escriba un Nombre para el atributo.

Nota: Los nombres deben tener menos de 70 caracteres y deben utilizar caracteres deun byte.



9. Escriba un Nombre para mostrar para el atributo.El texto del campo Nombre para mostrar aparece en la vista de árbol de la ventanaStructured Data Types (Tipos de datos estructurados).

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

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

11. Seleccione un tipo de datos para el atributo.Los valores válidos son: cadena, entero, flotante, fecha o booleano.

12. Según el tipo de datos que haya definido, escriba un valor predeterminado, si fueranecesario.

Nota: La variables de procesos que se usarán en conjuntos de correlaciones nodeben tener valores predeterminados. Las variables de procesos que tienen valorespredeterminados no poseen las características de atributo exclusivas requeridaspara que coincida un mensaje entrante con una instancia única de un proceso.Introducción a la correlación de mensajes, página 180 proporciona más informaciónsobre cómo usar conjuntos de correlaciones para asignar el contenido de un mensajea los datos de proceso.

13. 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 enlos informes de BAM.

14. Para actualizar las definiciones de tipos de datos con BAM, seleccione Actualizar lastablas de base 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 deBAM, donde se agregan a las tablas que se utilizan para los informes.


Para 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 detallesdel tipo de datos estructurado.



Editar tipos de datos estructurados

Después de crear un tipo de datos estructurado y antes de usarlo en un proceso, puedecambiar las propiedades de los atributos, y también puede agregar atributos y grupos.Después de que un tipo de datos estructurado se usa en un proceso, se pueden modificardatos mínimos para conservar la integridad de cualquier instancia del proceso queesté en ejecución actualmente.

Los tipos de datos estructurados que se usan en un proceso tienen el texto En uso... en laparte superior derecha del cuadro de diálogo. Si hace clic en el texto, el sistema inicia elcuadro de diálogo Lista de procesos que muestra los procesos que actualmente hacenreferencia a los tipos de datos estructurados.

Los atributos no se pueden modificar ni eliminar mientras están en uso. Puede cambiarel nombre para mostrar y la descripción del tipo de datos estructurado. También puedeagregar un grupo nuevo o un atributo nuevo.

Nota: Cuando modifique un tipo de datos estructurado utilizado en los informes deBAM, seleccione la opción de la página que permite actualizar la nueva definición con labase 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 eseatributo.

Crear un tipo de datos estructurado complejo a partirde un esquema XML

Puede buscar y recuperar un esquema XML (como un archivo .XSD) e importarlo en elrepositorio como un objeto de tipo de datos estructurado, permitiéndole utilizar losdatos de una aplicación externa o de otra parte de su negocio.

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



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

1. Haga clic con el botón secundario del ratón en la ventana Tipos de datosestructurados y seleccione Crear tipo de datos estructurado desde esquema XML.Aparecerá el cuadro de diálogo Crear TDE desde esquema XML con la categoríaa la que se va a agregar el tipo de datos estructurado.

2. Para cambiar las categorías o crear una nueva, haga clic en Change Categories(Cambiar categorí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 archivo local• Haga clic en para seleccionar el esquema del repositorio actual y desplazarse

al esquema que desea importar.• Escriba una URL y haga clic en para obtener un nombre de esquema o recibir

el contenido de un sitio web.4. Seleccione el tipo de datos que desea importar.

• Tipo complejo muestra todos los tipos de datos complejos que incluyen losatributos anidados.

• Tipo de elemento muestra el objeto contenedor y la información jerárquica,además de los atributos asociados al tipo de datos.

5. En el cuadro de lista, seleccione el tipo de datos para utilizarlo como un tipo dedatos estructurado.La información relacionada para el tipo de datos aparece en el cuadro de grupoTipos de datos estructurados.

6. Puede editar los campos más genéricos de los atributos, comoNombre 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 laventana Structured Data Types (Tipos de datos estructurados).

Panel del editor de plantillas de proceso

El panel del editor de plantillas de proceso es la zona en donde se diseña el flujo delos procesos comerciales. Para definir un proceso comercial, arrastre la actividadpredefinida desde las carpetas de plantillas de actividades hasta el editor de plantillasde proceso o cree nuevas actividades manuales o automáticas, conéctelas con flujos y



defina sus propiedades y las de los flujos. Consulte Crear plantillas de proceso, página70 para obtener más información. También puede agregar notas de texto a áreas deetiquetas de la plantilla.

Los procedimientos que se siguen para controlar el diseño visual de un proceso comercialson similares a los de cualquier otro software de diseño gráfico.

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

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

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

• Para copiar actividades, selecciónelas y haga clic en el icono Copiar de la barra deherramientas o elija Copiar en el menúModificar. Para agregar la nueva copia ala plantilla, haga clic en el icono Pegar de la barra de herramientas o seleccionePegar en el menúModificar.

• Para ver las acciones disponibles para un objeto específico, selecciónelo y haga cliccon el botón secundario del ratón. Aparece un menú contextual en la posición delcursor del ratón en el que se mostrarán las acciones disponibles.

Para seleccionar uno o varios objetos en el panel del editor de plantillasde proceso:

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

2. Haga clic en la representación visual del objeto en el panel del editor de plantillasde proceso, o bien, haga clic en una zona despejada y arrastre el ratón para dibujarun rectángulo alrededor de los objetos.Aparecerá un conjunto de cuadros negros alrededor de los objetos seleccionados.Si hace clic en el objeto una segunda vez, se anula la selección y desaparecen loscuadros negros.

3. Para seleccionar objetos adicionales, mantenga presionada la tecla Mayús mientrashace clic en ellos.

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



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

Alinear actividades

Las opciones de alineación permiten colocar las actividades de flujo de trabajo conexactitud. Es posible alinear actividades en sentido vertical u horizontal por sus bordesizquierdo, derecho, superior o 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 dealineación. Consulte Panel del editor de plantillas de proceso, página 61 si necesitamás información sobre cómo seleccionar actividades.

2. Seleccione Alineación en el menúMostrar y, a continuación, elija la alineacióncorrecta en el submenú.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ásalta determina la colocación de las demás. Es decir, las actividades seleccionadassubirán para estar alineadas con actividad más alta. De igual modo, si decide alinearlos bordes inferiores de las actividades, la inferior o más baja determina la colocaciónde las demás. Esto también se aplica a las alineaciones izquierda y derecha.

Sustituir una actividad

Puede sustituir una actividad de una plantilla de proceso por otra plantilla de actividadsi arrastra la nueva plantilla de actividad desde la carpeta de plantillas de actividades yla coloca en la actividad existente.

Por ejemplo, después de que un desarrollador de procesos importe un proceso de ProcessAnalyzer a Process Builder, es posible que deba sustituir las actividades genéricasimportadas por determinadas plantillas de actividad existentes. El desarrollador sólo



debe arrastrar una actividad nueva y colocarla en la ubicación correcta del proceso,de forma que se elimine la actividad anterior y se sustituya por la nueva. Medianteeste 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 aconfigurar la actividad.

Ajustar a la cuadrícula

La opción de ajuste a la cuadrícula proporciona mayor precisión a la hora de alinearflujos y actividades 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 deplantillas de proceso. Cuando mueva actividades o flujos en el editor, se alinearánautomá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 no afecta al diseño de los objetosexistentes en la plantilla.

Cuando se desactiva esta opción, la cuadrícula no aparece y los objetos se colocanexactamente en la ubicación en la que se sueltan. Desactive esta opción si desea tener uncontrol preciso de la posición de los objetos.

Acercar o alejar

Si los botones de la barra de herramientas de vista están activos, el nivel actual de zoomaparece en un cuadro entre los iconos Acercar y Alejar . Cada vez que hace clic enuno 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 enel 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 delpanel del editor de plantillas de proceso.

• Ajustar: amplía o reduce el aspecto de la plantilla de proceso de modo que seajuste a las dimensiones visibles del panel del editor de plantillas de proceso.

Agregar notas

Puede agregar texto al diseño visual de la plantilla de proceso mediante notas. Aunquelas notas no afectan a cómo se ejecuta realmente el proceso comercial, pueden servir paraaclarar el proceso a las personas que consulten la plantilla. Puede colocar una nota encualquier lugar del diseño de la plantilla. De forma predeterminada, la nota aparecerácon un rectángulo amarillo alrededor del texto, pero puede elegir otras opciones devisualización. En el ejemplo siguiente se muestra una nota con distintos 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, seleccioneNotas, 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, apareceel 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 cuadrode diálogo Inspector 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 Vistaprevia situado en la parte inferior del cuadro de diálogo mostrará las seleccionesactuales.

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 yCursiva.

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 deespecificar 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 defondo.

7. Especifique la transparencia que desea aplicar a la nota.Con el control deslizante Transparencia, establezca el grado de transparencia.Si el nivel de transparencia se establece en el 100%, la nota será opaca y ocultarácompletamente los objetos que se encuentren detrás de ella en la plantilla de proceso.Si el nivel de transparencia se establece en el 0%, la nota será completamentetransparente.

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 elformato Business Process Modeling Notation para anotaciones de texto: apareceun borde grueso en el lado izquierdo de la nota.

9. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de notaso en Aceptar para 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 situadosen los bordes.

Ver varios procesos utilizando fichas

Cuando está creando una plantilla de proceso, puede necesitar ver otro proceso existente.Process Builder le permite abrir y ver varios procesos en distintas fichas. Cuando se abreun proceso, éste aparece en una nueva ficha, dejando a cualquier otro proceso abierto enfichas independientes en la ventana del editor de procesos.

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

Nota: La vista de varias fichas sólo está disponible para procesos existentes dentro delmismo repositorio. 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 derecho en laficha y seleccione Cerrar, elija Archivo > Cerrar o haga clic en en la ficha.

Ficha Validación de procesos

La ficha Validación de procesos permite ver los errores de validación al validar unproceso guardado. Al validar un proceso con errores, en la ficha Validación de procesosse muestran todos los errores del proceso agrupados por nombre de actividad.

Expanda el nodo de la actividad y visualice todos los errores encontrados en cadaactividad. Al seleccionar un error individual en la ficha, el sistema resalta la actividadcorrespondiente en el panel del editor del proceso, de modo que pueda abrir la plantillay corregir el error.

Utilizar la ficha Validación de procesos, página 91 proporciona más información sobre lavalidación de procesos.

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



Navegador

Al definir una plantilla de proceso, la representación gráfica puede alcanzar fácilmenteun tamaño tan grande que la pantalla no pueda mostrarla por completo. El editor deplantillas de proceso se desplaza automáticamente a medida que el usuario agregaobjetos y crea diseños de mayor tamaño.

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

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 la barra de herramientas .Aparece la ventanaNavegador en el panel derecho de la ventana Process Builder. Enella se muestra una representación reducida de la plantilla de proceso actual, con uncuadro gris alrededor de la sección que aparece en pantalla.

2. Para cambiar el área de la plantilla que aparece en la pantalla, arrastre el cuadro grisen la ventana Navegador 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ónseleccionada.


Capítulo 3

Trabajar con plantillas de proceso

En este capítulo se describe la forma de crear plantillas, validarlas e instalarlas. Los temas son lossiguientes:

• Abrir plantillas de proceso existentes, página 70• Crear plantillas de proceso, página 70• Definir propiedades de la plantilla de proceso, página 73• Gestionar los paquetes, página 76• Guardar plantillas de proceso, página 87• Validar plantillas de proceso, página 90• Instalar plantillas de proceso, página 92• Plantillas de proceso para registrar, retirar y crear versiones, página 94• Eliminar las plantillas de proceso, página 97• Modificar plantillas de proceso, página 93• Importar plantillas de proceso, página 97• Mantener sincronizados los procesos compartidos, página 98• Exportar plantillas de proceso, página 100• Imprimir plantillas de proceso, página 100

Información general de las plantillas deproceso

Las plantillas de proceso representan el proceso comercial a través del cual fluye undeterminado objeto o conjunto de objetos. Definen el flujo de trabajo total de principio afin. El usuario crea plantillas de proceso en Process Builder y las pone a disposición delos demás usuarios para que puedan crear instancias de flujo de trabajo individuales apartir de ellas.



Las plantillas de proceso pueden encontrarse en tres estados: borrador, validado einstalado. El estado actual de la plantilla abierta aparece en la barra de título de laventana Process Builder. La barra de título también indica si la plantilla está retirada y elnombre de usuario del propietario del bloqueo, si otro usuario ha retirado la plantilla.

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

Abrir plantillas de proceso existentes

Puede abrir una plantilla existente a fin de revisarla, corregirla o guardarla con un nuevonombre a modo 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 nombresde carpeta hasta que aparezca el nombre de la plantilla en el cuadro de lista.

3. En la listaMostrar, seleccioneMostrar versiones actuales para ver únicamente laversión actual de las plantillas en la ventana, o bien seleccioneMostrar TODAS lasversiones para ver un listado de todas las versiones de las plantillas.

4. Resalte el nombre de la plantilla y active la casilla de verificación Retirar proceso alabrir para editar el proceso. Mostrar sólo está disponible cuando otro usuario tienela plantilla retirada y abre una copia de sólo lectura de la plantilla.

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

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

Crear plantillas de proceso

El procedimiento siguiente proporciona información general sobre cómo crear plantillas.Algunos pasos proporcionan enlaces a otros temas en los que podrá encontrar másdetalles sobre la tarea descrita 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 losprocesos de flujo de trabajo, página 24.

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 finpredeterminadas.

Nota: Para crear una plantilla a partir de otra, abra la plantilla existente y guárdelacon un nuevo nombre.

3. Defina las propiedades de plantilla.Consulte Definir propiedades de la plantilla de proceso, página 73 si necesitainformación detallada.

4. Identifique los datos de proceso asociados o creados como parte del procesocomercial.Consulte Gestionar los paquetes, página 76 si necesita información detallada.

5. Agregue actividades a la plantilla de proceso hasta que haya una actividad por cadauna de las tareas en el flujo de trabajo.• Haga clic en el icono de actividad manual o el icono de actividad automática

en la barra de herramientas, a continuación, haga clic en el panel del editor deplantillas de proceso donde desea que aparezca la actividad.

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

Si la ventana Plantillas de actividades no incluye ninguna plantilla que represente eltipo de actividad que necesita, puede crear una actividad en blanco haciendo clic enlos botones de actividad manual o automática en la barra de herramientas o puedecrear una nueva plantilla. Capítulo 7, Trabajar con actividades proporciona másinformación relacionada con la creación de una 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 deinicio (puede ser cualquier tipo de actividad de inicio) y la última actividad debeestar conectada a la actividad de finalización.Para conectar dos actividades, seleccione uno de los iconos de flujo, mueva elcursor sobre la primera actividad hasta que vea su cuadro de selección y arrastreel ratón hasta la segunda actividad. Suelte el botón del ratón cuando vea el cuadrode selección de la segunda actividad. Process Builder dibuja una línea entre ambasactividades.Puede conectar actividades mediante uno de los cuatro iconos Crear flujo de labarra de herramientas de Process Builder:



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

• Para conectar actividades en un movimiento de datos hacia atrás, haga clic enel icono Crear flujo de rechazo . Este icono representa la ruta que se siguecuando el usuario de una actividad rechaza el objeto que se está procesando.

• Para conectar una actividad del controlador de errores al flujo, haga clic en

Actividades del controlador de errores, página 20 proporciona informacióndetallada sobre este tema.

Nota: Conecte todas las actividades en el flujo antes de configurar las actividadesindividuales. Algunos pasos de configuración están basados en la posición de laactividad en el proceso comercial.

7. Configure cada actividad.Consulte el Capítulo 7, Trabajar con actividades si necesita información detalladasobre cómo configurar las actividades. Normalmente, se recomienda configurar lasactividades en el orden en que aparecen en el proceso comercial, comenzando porla actividad de inicio. Configure todas las fichas necesarias para cada actividad.Por ejemplo, recuerde configurar la ficha Desencadenador para las actividades deunión y la ficha Transición para las actividades de división de la decisión. (Para laactividad de inicio, sólo se encuentran disponibles las fichas Propiedades, Datosy 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 plantillade proceso, consulte Panel del editor de plantillas de proceso, página 61.

9. Guarde la plantilla de proceso.Consulte Guardar plantillas de proceso, página 87.

10. Valide la plantilla de proceso.Consulte Validar plantillas de proceso, página 90.

11. Instale la plantilla de proceso.Consulte Instalar plantillas de proceso, página 92. Una vez que haya instalado laplantilla, ésta se encontrará disponible para los usuarios.



Definir propiedades de la plantilla de proceso

Utilice el cuadro de diálogo Propiedades de proceso para proporcionar informaciónbásica sobre el flujo de trabajo que desea crear. El creador original y el estado actual de laplantilla de proceso, incluido su estado de bloqueo, propietario del bloqueo y versión,aparecen en la parte superior del cuadro de diálogo en campos de sólo vista.

Nota: Para editar una plantilla existente, debe desinstalar el proceso. Modificarplantillas de proceso, página 93 proporciona más información sobre cómo modificaruna 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 partesuperior de la plantilla.

3. Para cambiar el propietario de la plantilla de proceso, haga clic en el botón Cambiarque aparece junto al nombre del propietario y seleccione un usuario en el cuadrode diálogo que aparece.Usted será el propietario predeterminado de todas las plantillas que cree.Únicamente puede cambiar el propietario si es un superusuario. De no ser así, elbotón Cambiar no estará disponible.

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

5. Para modificar el alias predeterminado de esta plantilla, haga clic en el botónCambiar que aparece junto al conjunto de alias actual.Si necesita más información sobre los conjuntos de alias y la forma en que se usanen el flujo de trabajo, consulte Usar alias, página 30.• Para elegir un conjunto de alias existente, marque Elegir entre los conjuntos de

alias existentes, seleccione el nombre del conjunto de alias en la lista desplegabley haga clic en Aceptar.

• Para crear un nuevo conjunto de alias, marque Crear nuevo conjunto de alias,escriba el nombre y la descripción del nuevo conjunto de alias y haga clic enAceptar.

• Para quitar el conjunto de alias predeterminado asignado actualmente, marqueQuitar conjunto de alias.

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



Por ejemplo, puede dar instrucciones concretas a los ejecutantes de todas lasactividades sobre sus tareas.

7. Para activar o desactivar la configuración de seguimiento de comprobación de laplantilla, haga clic en la opción correspondiente.Si está activada la auditoría, se guardará la información de seguimiento decomprobación de todos los flujos de trabajo creados a partir de esta plantilla. Laauditoría debe estar activada para permitir al sistema publicar datos de informes enla base de datos de BAM.

Nota: Para cambiar la configuración de seguimiento de comprobación, debedisponer de privilegios CONFIG_AUDIT. CONFIG_AUDIT es un privilegio deusuario ampliado y debe ser concedido por otro propietario del repositorio u otrosuperusuario de Documentum TaskSpace o Documentum Webtop. En la guía delusuario de Documentum Webtop y la Guía de configuración de Documentum TaskSpace seproporciona información detallada sobre cómo ampliar los privilegios de usuario.

8. Especifique si desea que los nombres de documentos distribuidos estén disponiblespara que los usuarios los vean.De forma predeterminada, el paquete distribuido a través de un flujo de trabajo noincluye los nombres de los documentos en el paquete por motivos de seguridad. Sidesea almacenar dichos nombres como parte del paquete, a fin de utilizarlos en lasinstrucciones que se pasen a los participantes del flujo de trabajo, marque la casillaAlmacenar el nombre de documento en el paquete en el tiempo de ejecución.

9. Para enviar un mensaje de correo electrónico cuando un temporizador caducau ocurre otro evento, haga clic en Agregar en el cuadro de grupo Seleccione laplantilla para la notificación de eventos.También puede eliminar una plantilla y un evento del cuadro de grupo seleccionandola fila y 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 decorreo electrónico que el servidor utilizará para enviar notificaciones del evento.

a. Seleccione la opción para elegir una plantilla existente del repositorio; tambiénpuede crear una nueva plantilla de correo electrónico con la ayuda del Asistentepara plantilla de notificación.Utilizar el Asistente para plantilla de notificación, página 155 proporcionainstrucciones sobre cómo crear una nueva plantilla de correo electrónico.

El servidor utiliza la plantilla de correo electrónico seleccionada para todas lasnotificaciones del mismo tipo de evento. Si no selecciona ninguna plantilla de correoelectrónico, el servidor enviará una notificación predeterminada a la bandeja deentrada de Documentum de los usuarios.



12. Para asociar mensajes de correo electrónico personalizados con eventos de flujo detrabajo específicos, elija las plantillas de correo electrónico y eventos en el cuadrosituado en la parte inferior del cuadro de diálogo.Puede definir los mensajes que enviará el servidor en respuesta a los eventosrelacionados con el proceso. Los usuarios registrados para recibir notificación delevento recibirán un mensaje elaborado con la plantilla de correo electrónico asociadaa dicho evento. Configurar notificaciones, página 44 proporciona más informaciónsobre este tema.

Nota: También puede asociar plantillas de correo electrónico con eventos comoparte de la definición de una actividad.• 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 trabajocreados desde dicha plantilla de proceso.

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

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

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

b. Haga clic en la columna Evento de la nueva fila y seleccione un evento de flujode trabajo en la lista desplegable que aparezca. Los eventos disponibles son:• dm_changedactivityinstancestate: una actividad automática cambia de

estado porque el indicador de control de errores se ha definido como cero yel elemento de trabajo ha devuelto un valor que no es cero.

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

• dm_delegatedworkitem: un usuario delega un elemento de trabajo.• Vencimiento de pre-temporizador: una actividad no se ha iniciado

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

transcurrida la cantidad de 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 de correo electrónico que va a utilizar con el evento elegido en elpaso b. Una plantilla de correo electrónico es un documento en el repositoriode Documentum que define la estructura del mensaje de notificación. Si deseamás información sobre la estructura de los documentos que funcionan como



plantillas de correo electrónico, consulte la guía Documentum Process BuilderDevelopment 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 procesos

La ficha Datos del cuadro de diálogo Propiedades de procesomuestra una lista de lospaquetes, variables de proceso y parámetros de proceso que participan en flujos detrabajo creados desde esta plantilla de proceso. Los datos de proceso pueden constar de:• Variables de flujos de trabajo• Variables de proceso• Parámetros de proceso• Paquetes

Gestionar los paquetes

En 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 pedidosde compra pasa el mismo documento de pedidos de compra como paquete a todaslas actividades necesarias. En otros casos, el trabajo realizado por algunas actividadespuede dar lugar a la creación de un documento. Supongamos, por ejemplo, que unaactividad acepta un aviso de acción de personal. El ejecutante (un empleado de recursoshumanos) debe archivar el aviso y enviar un formulario diferente al departamento decontabilidad. La lista de paquetes del cuadro de diálogo Propiedades de proceso debeincluir todos los paquetes que participan en el flujo de trabajo, incluidos aquéllos creadoso descartados durante el proceso. Al configurar las actividades, debe especificar lospaquetes con los que trata cada actividad. Cambiar datos de proceso en una actividad,página 158 proporciona información detallada sobre este tema.

Para definir los paquetes de un proceso comercial:

1. Si el cuadro de diálogo Propiedades de proceso aún no está abierto, seleccionePropiedades de proceso en el menú Herramientas o haga clic en el iconoPropiedades de plantilla de la barra de herramientas .

2. Haga clic en la ficha Datos.



3. Para agregar un paquete al proceso empresarial, seleccione el nodo Paquetes en lavista de árbol y haga clic en el botón + situado sobre la ventana.El nuevo paquete aparecerá en el árbol bajo el nodo Paquetes y en el cuadro delista Package Definition (Definición de paquete), junto con los controles necesariospara 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 lasactividades en el proceso comercial.

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

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

Nota: Process Builder se puede configurar para no mostrar la lista Versión.Apéndice C, Archivo de configuración de Process Builder proporciona informacióndetallada sobre este tema. Si la lista no aparece, el flujo de trabajo utiliza siempre laversión ACTUAL.

La versión especificada aparece como la versión predeterminada utilizada para cadaactividad que gestiona 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ón especí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ólicas distinguen entre mayúsculas y minúsculas; por lo tanto,asegúrese de que la versión que escriba coincide con la versión del objeto enel repositorio.

• ACTUAL, que es la selección predeterminada. Si selecciona ACTUAL, el paquetesiempre contendrá la versión con la etiqueta ACTUAL, que suele ser la versiónmás actual del objeto en el repositorio.

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

Nota: Process Builder se puede configurar para no mostrar la lista Tipo. ApéndiceC, Archivo de configuración de Process Builder proporciona información detalladasobre este tema. Si la lista Tipo no aparece o si desea que Process Builder seleccioneel tipo de objeto según la plantilla de formulario elegida, vaya al paso siguiente.

Lo más habitual es que el tipo de objeto de un paquete sea un documento oun documento personalizado que el usuario haya creado. Consulte el manualDocumentum Content Server Reference (Referencia de Documentum Content Server)para obtener una descripción de los tipos de objeto.



7. Para asociar una plantilla de formulario al paquete, selecciónela en la listadesplegable Formulario.Una plantilla de formulario define una interfaz de usuario personalizada para losusuarios que gestionen este paquete durante el flujo de trabajo. Consulte Asociarplantillas de formulario con paquetes, página 40 para obtener más informaciónsobre el uso de formularios y plantillas de formulario. Para aparecer en la lista,el formulario debe estar en un estado instalado. La plantilla para formularioespecificada aquí aparece como la plantilla predeterminada utilizada para cadaactividad que gestiona el paquete. Puede anular la plantilla de formulario alconfigurar la actividad.

Nota: Si elige una plantilla de formulario antes de definir el tipo de objeto delpaquete, Process Builder mostrará todas las plantillas disponibles en la listadesplegable y definirá el tipo de objeto del paquete según la plantilla que seleccione.

a. Seleccione un formulario existente en la lista desplegable Formulario. La listamuestra sólo aquellas plantillas de formulario cuyomodelo de datos coincida conel tipo de objeto seleccionado en el paso 5. Si la plantilla de formulario deseadano aparece, asegúrese de que seleccionó el tipo de objeto correcto en el paso 5.

b. Para crear una nueva plantilla de formulario o editar la seleccionada, haga clicen el botón con el icono de Forms Builder para iniciar Forms Builder.La guía Documentum Forms Builder User Guide proporciona más informaciónsobre cómo crear formularios personalizados para su flujo de trabajo.

8. Para que el formulario seleccionado muestre las propiedades del paquete, active lacasilla de verificación Usar formulario para propiedades.Si la casilla de verificación Usar formulario para propiedades no está activada, elformulario del paso 7 aparece cuando el ejecutante de una actividad seleccionael paquete desde su bandeja de entrada. El formulario se utiliza para guardar elcontenido del paquete. Cuando la casilla de verificación está activada, el formularioaparece cuando el ejecutante ve las propiedades del paquete. El formulario se utilizapara establecer las propiedades del paquete en el repositorio, no el contenido delpaquete.

Nota: La opción Usar formulario para propiedades sólo está disponible para lasplantillas de formulario cuya opción de asignación de almacenamiento se ha definidocomo Store in Repository attributes (Almacenar en atributos del repositorio).Consulte la guía Documentum Forms Builder User Guide si necesita información sobreesta opción de asignación de almacenamiento.

9. Para impedir que Process Builder haga que este paquete esté visible para todas lasactividades de forma predeterminada, desactive la casilla de verificación Visibledurante todo el proceso.De forma predeterminada, Process Builder hace que el paquete sea visible paratodas las actividades del proceso comercial, asumiendo que el paquete fluirá por



todo el proceso. Una vez desactivada esta casilla, el paquete sólo será visible en lasactividades a las que lo agregue de forma explícita.

Nota: Si selecciona un paquete existente que es visible en algunas actividades y no enotras, la casilla de verificación aparecerá como no disponible. Para restablecer todaslas actividades de modo que tengan el mismo valor, haga clic en el enlace Cambiarconfiguración de nivel de actividad y, en el cuadro de diálogo que aparecerá acontinuación, haga clic en Sí.

10. Para solicitar que el paquete tenga un documento u otro contenido asociado, activela casilla de verificación Éste es un paquete obligatorio.

Nota: Si selecciona un paquete existente que es obligatorio en algunas actividadesy opcional en otras, la casilla de verificación aparecerá como no disponible. Pararestablecer todas las actividades de modo que tengan el mismo valor, haga clic en elenlace Cambiar configuración de nivel de actividad y, en el cuadro de diálogo queaparecerá a continuación, haga clic en Sí.

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

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.

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

15. Configure cada actividad para especificar los paquetes que gestionará, empezandocon la actividad de inicio y avanzando a través del proceso comercial.Consulte Cambiar datos de proceso en una actividad, página 158.

Gestionar las variables de proceso

Las variables de proceso representan distintos tipos de datos que circulan por el procesocomercial. Puede tratarse de tipos de datos simples (como una cadena, un valor booleanoo una fecha) o complejos, es decir, grupos de datos relacionados lógicamente comopedidos, componentes de fabricación, etc. Las variables de proceso se pueden agruparen conjuntos de atributos de tipos de datos relacionados lógicamente que se puedenreutilizar en el repositorio.

Estas variables de proceso, o tipos de datos estructurados, están disponibles en la ventanaTipos de datos estructurados y se pueden utilizar en varias plantillas de proceso deun repositorio.

Por ejemplo, puede crear una variable de proceso approved, que es un valor booleano,y asociarla al flujo de proceso. Puede diseñar a continuación un formulario de Forms



Builder con botones de opción que representen el valor para el campo aprobado yasociarlo al flujo de proceso.

Para definir las variables de proceso de un proceso comercial:



3. Para agregar una variable de proceso al proceso comercial, seleccione el nodoProcess 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 (Variablesde proceso) y en el cuadro de lista Definición de paquete, junto con los controlesnecesarios para definir la variable de proceso.

4. Escriba el nombre de la variable en el cuadro de texto Nombre (puede contenerun máximo de 255 caracteres).Elija un nombre que le permita identificar la variable cuando configure lasactividades en el proceso comercial.

Nota: Si cambia el nombre de una variable que ya está definida en el repositorio, estecambio sólo afecta a la variable dentro del proceso. No afecta al nombre del tipo dedatos estructurado en el repositorio. É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 dedatos estructurados en el cuadro de diálogo Choose Type (Seleccionar tipo).

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

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

Nota: Una LCA asignada a una variable de proceso individual anula la LCA delnivel 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 83 proporcionamás informació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.



11. Configure cada actividad para especificar las variables que gestionará, empezandocon la actividad de inicio y avanzando a través del proceso comercial.Cambiar datos de proceso en una actividad, página 158 proporciona más informaciónsobre cómo configurar los datos de proceso dentro de una actividad.

Gestionar parámetros de proceso

Los parámetros de proceso permiten a los administradores de la aplicación modificarvalores constantes que se utilizan a lo largo de un proceso. Los parámetros que se definendentro de un proceso están disponibles a todas las actividades contenidas en el proceso.

El administrador puede cambiar los valores del parámetro en la ficha Administrationen TaskSpace y cualquier nueva instancia de proceso, elementos de trabajo y variablesdentro del flujo de trabajo utilizan el valor actualizado.

Introducción a los parámetros de proceso, página 40 proporciona información deinformación general sobre parámetros de proceso.

Nota: al migrar parámetros de procesos, Documentum Composer crea para cada unode ellos un parámetro de instalación correspondiente. El valor predeterminado seestablece en el valor del repositorio de origen. Delante del nombre del parámetro deinstalación aparece el nombre del proceso seguido del nombre del parámetro de proceso:NombreProceso_NombreParámetroProceso0.parámetro. En la Guía del usuario de DocumentumComposer se proporciona información detallada sobre cómo utilizar los parámetros deinstalación en proyectos de Documentum Composer.

Para definir los parámetros de proceso de un proceso comercial:



3. Para agregar parámetros de proceso al proceso comercial, seleccione el nodoParámetros de proceso en la vista de árbol y haga clic en el botón Agregar + situadosobre la ventana.El nuevo parámetro aparece en el árbol bajo el nodo Variables de proceso y en elcuadro de lista Parámetro de proceso, junto con los controles necesarios para definirel parámetro.

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



Elija un nombre que le permita identificar el parámetro cuando configura lasactividades del proceso comercial o en la ficha Administración de TaskSpace. No sepermiten espacios y caracteres 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. Losadministradores de la aplicación pueden cambiar este valor en la fichaAdministration en TaskSpace.

Anular configuración de nivel de actividad

La configuración creada en la ficha Datos del cuadro de diálogo Propiedades de procesoes una configuración global que se aplica a todo el proceso. La configuración de muchasde las propiedades se puede editar en el nivel de actividad, creando una mezcla deestados para ese ajuste específico. Por ejemplo, un paquete se puede configurar para quese pueda incluir en informes en el nivel de proceso; sin embargo, puede tener la opciónde inclusión en informes modificada en una actividad específica. Cuando la actividadtiene una configuración diferente a la global especificada en el proceso, puede optar porsobrescribir 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 enlaceCambiar configuración de nivel de actividad.

2. En el cuadro de diálogo Cambiar configuración de nivel de actividad, el sistemamuestra todas las actividades cuya configuración difiere de las propiedades deproceso 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 avanzadas

La ficha Avanzada del cuadro de diálogo Propiedades de proceso permite establecerpermisos en todo el proceso o variables individuales asociadas al flujo de proceso.También puede crear los conjuntos de correlación que hacen coincidir los atributos deun mensaje entrante procedente de un origen externo con los datos de proceso de laactividad.



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

Un conjunto de permisos (también conocido como una lista de control de acceso oLCA), define los permisos del nivel de objeto aplicados a objetos a los que se asignanlos conjuntos de permisos. Los conjuntos de permisos especifican qué acceso tienecada usuario a un elemento determinado del repositorio, como un archivo o carpeta.El propietario de los elementos del repositorio asigna a cada uno de ellos un conjuntode permisos. El conjunto de permisos define los permisos del ámbito de los objetosque se aplican a un objeto.

Al crear una nueva plantilla, el nuevo proceso así como los objetos de actividad confíanen la LCA predeterminada del usuario o en la LCA predeterminada de la carpetaprincipal, dependiendo de la configuración del repositorio. Puede configurar la LCApara el proceso y la actividad desde dentro de Process Builder para asegurarse de quecada usuario tiene el acceso correcto a los elementos del flujo de trabajo.

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

La guía Documentum Content Server Administration Guide proporciona información sobrecómo usar las LCA.

Tabla 3. 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 4. Requisitos de permiso para las variables de proceso

Usuario Nivel de permiso mínimo

Creador del proceso Escribir

Creador del flujo de trabajo Escribir

Supervisor del flujo de trabajo Escribir

Ejecutantes de la tarea Escribir



Para seleccionar una LCA:


2. Haga clic en la ficha Avanzada.

3. Para aceptar la LCA de variables de proceso de BPM predeterminada, haga clic enPredeterminado.

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 puedeutilizarlas cualquier usuario del repositorio y las gestiona el propietario delrepositorio. Las otras LCA pueden gestionarlas sus propietarios o los usuarioscon 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. Lospermisos asociados y 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 laplantilla de proceso anula la LCA del nivel de proceso.

5. Para permitir que el servidor elija la LCA correcta para el proceso, haga clic enPredeterminado.

6. Para cambiar la LCA predeterminada del proceso, haga clic en Examinar y seleccioneuna 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 puedeutilizarlas cualquier usuario del repositorio y las gestiona el propietario delrepositorio. Las otras LCA pueden gestionarlas sus propietarios o los usuarioscon 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 dediálogo.




Seleccionar un calendario para el proceso

Se puede requerir a los diseñadores de proceso que implementen procesos comercialesque están basados en distintos períodos de tiempo o en horas de trabajo que losencontrados en el calendario del sistema estándar. En DocumentumWebtop o TaskSpace,los diseñadores pueden crear calendarios basados en calendarios laborales regionales,días festivos específicos del país o cualquier otra restricción temporal exclusiva. De estaforma, los temporizadores y notificaciones de un proceso se calculan en función de uncalendario concreto en lugar del calendario del sistema.

Nota: Cuando una tarea llega a la bandeja de entrada del usuario, la fecha de vencimientode la tarea se puede calcular basándose en el calendario del sistema. La siguiente vezque se ejecuta el trabajo del temporizador, el trabajo actualiza la fecha de vencimientosegún el calendario comercial.

Para seleccionar un calendario para un proceso



3. Seleccione un calendario en el cuadro de lista.La lista de calendarios refleja todos los calendarios situados en la carpetaSistema/Flujo de trabajo/Calendarios.

Nota: Si los distintos calendarios diferentes están seleccionados tanto para unproceso como para una actividad dentro de ese proceso, el sistema utiliza elcalendario de la actividad.

Asignar un formulario de parámetros de proceso

Un formulario de parámetros de proceso crea una página para que un administradormodifique los valores constantes que se utilizan a lo largo del proceso. Losadministradores realizan estas modificaciones en un formulario de Documentum Formal que acceden desde la ficha Administración de TaskSpace. Cualquier nueva instanciade proceso, elementos de trabajo y variables dentro del flujo de trabajo utilizan el valoractualizado.

Para habilitar esta opción, se asigna o se crea un formulario de parámetros de procesopara habilitar la administració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 quese 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 disponiblesdel 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ónsobre la creación de formularios.En la guía Documentum TaskSpace Configuration Guide se proporciona másinformación sobre cómo administrar procesos en TaskSpace.

Crear los conjuntos de correlación

Process Builder debe poder hacer coincidir un mensaje entrante con una instancia únicade un flujo de trabajo para procesar los datos entrantes. Los conjuntos de correlación soncolecciones de variables de proceso que se definen para una actividad que permite alsistema comparar un mensaje con una instancia de proceso.

Los conjuntos de correlación se crean en el nivel de proceso en función del tipo deinformación que estará recibiendo de las plantillas de actividad de los mensajesentrantes. Esto incluye el uso de tipos de datos estructurados que se han definido conel repositorio. Puede crear varios conjuntos de correlación para un proceso, aunqueuna actividad sólo se puede asociar con un conjunto de correlación. Introducción a lacorrelación de mensajes, página 180 proporciona más detalles acerca de cómo utilizarlos conjuntos de correlaciones para que los mensajes de orígenes externos coincidancon los datos de proceso.

Para crear un nuevo conjunto de correlación:



3. En el cuadro de grupo Conjunto de correlación, seleccione el nodo raíz Conjuntode correlación y haga clic en el botón Agregar (+) para crear un nuevo conjunto decorrelación en el árbol.



4. Para crear un nombre para el conjunto de correlación, haga clic con el botónsecundario 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 conjuntoy 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 decorrelaciónAparece el cuadro de diálogo Correlación mostrando las variables de procesoasociadas 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 unavariable 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 variablesrelacionadas.


Habilitar servicios Web entrantes

Si una actividad de servicio Web entrante está incluida en el proceso, debe escribir el URIdel espacio de nombres de destino para la ubicación del WSDL. Si hay varias actividadesde servicio Web dentro del proceso, utilizan el mismo espacio de nombres de destino.

Nota: Si hay actividades entrantes del servicio Web dentro del proceso, este campo debecompletarse o 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 proceso

Una vez finalizada una plantilla de proceso, debe guardarla para poder validarla einstalarla. Al guardar la plantilla, se copian los cambios en el repositorio.



El proceso de almacenamiento varía en función de si guarda los cambios en una plantillaexistente, guarda una plantilla nueva o guarda una plantilla con un nombre nuevo. Paraguardar los cambios en una plantilla existente como la misma versión, debe tener porlo menos permiso de escritura en la plantilla y debe estar trabajando con un borradoro una plantilla validada. Una plantilla que esté instalada debe desinstalarse primeropara guardarla como la misma versión. Si las opciones de Guardar aparecen como nodisponibles en el menú Archivo, posiblemente la plantilla ya se habrá instalado.

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

Process Builder se puede configurar para forzar nombres únicos o ubicaciones decarpeta específicas para las plantillas de proceso. Apéndice C, Archivo de configuraciónde Process Builder proporciona información detallada sobre este tema. De formapredeterminada, sin embargo, las plantillas de proceso se pueden guardar en cualquierubicación del repositorio y sus nombres deben ser exclusivos solamente dentro dela carpeta.

Para guardar una nueva plantilla de proceso o guardar una existente conun 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, alseleccionar Guardar, también se muestra el cuadro de diálogo Guardar plantillade proceso como.

2. Escriba un nombre para la plantilla de proceso.

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

3. A fin de crear una carpeta en la que almacenar la plantilla y los objetos asociadosa ella, asegúrese de que ha marcado la casilla de verificación Crear nueva carpetapara elementos asociados.La casilla está marcada de forma predeterminada. Process Builder guarda la plantillay sus actividades en una carpeta con el mismo nombre que la plantilla, dentro de lacarpeta que seleccione en el siguiente paso.Si no está activada la casilla de verificación, desplácese a la carpeta en la que deseaguardar la plantilla. Para ello, haga doble clic en los archivadores y directorios delcuadro 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 parteinferior del cuadro de diálogo.




Si cuenta con los permisos correspondientes en la carpeta seleccionada, ProcessBuilder guarda la plantilla y sus actividades.Si ha definido que se solicite confirmación para la instalación y validación, semuestra un cuadro de diálogo en el que se le pregunta si desea validar la plantilla.(En el cuadro de diálogo Preferencias se activan y desactivan las preguntas deinstalación y validación. Definir propiedades de la plantilla de proceso, página 73proporciona más información sobre este tema).

5. Elija si desea validar la plantilla de proceso.Consulte Validar plantillas de proceso, página 90 si necesita más información sobrela validación de plantillas. Si elige validar la plantilla, Process Builder intentará lavalidación. Si se produce un error, aparece un cuadro de diálogo notificándoselo.Haga clic en el botón Detalles para ver el error que impidió la validación.Si, por el contrario, la validación es correcta, aparece un cuadro de diálogo en elque se le pregunta si desea instalar la plantilla para que se encuentre disponiblepara los usuarios.

6. Elija si desea instalar la plantilla de proceso.Consulte Instalar plantillas de proceso, página 92 para obtener más informaciónacerca de la instalación de plantillas.

Para 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, ProcessBuilder actualiza el archivo guardado.Plantillas de proceso para registrar, retirar y crear versiones, página 94 proporcionamás información acerca de cómo registrar una plantilla.

2. Si cuenta con los permisos correspondientes en la carpeta seleccionada, ProcessBuilder guarda la plantilla y sus actividades. Si ha definido que se soliciteconfirmación para la instalación y validación, se muestra un cuadro de diálogo en elque se le pregunta si desea validar la plantilla.Consulte Validar plantillas de proceso, página 90 si necesita más información sobrela validación de la plantilla.

Para guardar una plantilla de proceso actualizada que no está retirada:

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

2. Haga clic en Aceptar.Si cuenta con los permisos correspondientes en la carpeta seleccionada, ProcessBuilder guarda la plantilla y sus actividades. Si ha definido que se soliciteconfirmación para la instalación y validación, se muestra un cuadro de diálogo en elque se le pregunta si desea validar la plantilla.



3. Elija si desea validar la plantilla de proceso.Consulte Validar plantillas de proceso, página 90 si necesita más información sobrela validación de plantillas. Si elige validar la plantilla, Process Builder intentará lavalidación. Si se produce un error, aparece un cuadro de diálogo notificándoselo.Haga clic en el botón Detalles para ver el error que impidió la validación.Si, por el contrario, la validación es correcta, aparece un cuadro de diálogo en elque se le pregunta si desea instalar la plantilla para que se encuentre disponiblepara los usuarios.

4. Elija si desea instalar la plantilla de proceso.Consulte Instalar plantillas de proceso, página 92 si precisa más información sobre lainstalación de plantillas.

Validar plantillas de proceso

La validación de una plantilla comprueba que el proceso definido en la plantilla cumplelos requisitos del sistema. La ficha Validación de procesos aparece al validar una plantillacon errores. Si no hay errores en el proceso, la ficha no aparece y puede continuarinstalando el proceso en el repositorio o elegir seguir trabajando en él.

Solamente se puede realizar la validación si la plantilla abierta tiene el estado borrador yel usuario cuenta con el permiso de escritura.

Puede invocar el proceso de validación desde el Debugger de proceso y ver ambas fichasal mismo tiempo para poder solucionar los problemas de un proceso.

En esta ficha muestra un árbol de actividades y todos los errores asociados a cada una delas actividades. Si hace clic en el error de una actividad en el árbol, se abrirá la actividadasociada en la pantalla del diseño, permitiéndole corregir el error en el momento de lavalidación. Utilice los botones de control para ampliar y contraer el árbol, cerrar la fichade validación o exportar una vista previa del árbol de errores a un archivo de texto. Estearchivo contiene una representación en forma de texto del árbol de validación que sepuede 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 unalista de los errores del proceso.

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

Adicionalmente, si ha definido que se solicite confirmación para la instalación yvalidación, siempre que guarde una plantilla aparecerá un cuadro de diálogo donde se lepregunta si desea validar la plantilla. En el cuadro de diálogo Propiedades de plantilla seactivan y desactivan las preguntas de instalación y validación. Definir propiedades de laplantilla de proceso, página 73 proporciona más información sobre este tema.

Utilizar la ficha Validación de procesos

La ficha Validación de procesos permite ver los errores de validación al validar unproceso guardado. Al validar un proceso con errores, en la ficha Validación de procesosse muestran todos los errores del proceso agrupados por nombre de actividad.

En la ficha Validación de procesos figuran errores que se producen como consecuenciade cambios en los 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 actividadExpanda el nodo de la actividad y visualice todos los errores encontrados en cadaactividad. Al seleccionar un error individual en la ficha, el sistema resalta la actividadcorrespondiente en el panel del editor del proceso, de modo que pueda abrir la plantillay corregir el error.

Para ver todos los errores de todas las actividades, haga clic en Expandir todo. Paracerrar la lista de 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 archivouna versión de sólo texto de los errores o para copiarla en el portapapeles.

La ficha Validación de procesos y las fichas del Debugger de proceso se pueden utilizarconjuntamente para solucionar los problemas de un proceso.

Instalar plantillas de proceso

Las plantillas de proceso se deben instalar antes de que puedan estar disponibles para suuso en un flujo de trabajo activo. Solamente puede instalar una plantilla si tiene el estadovalidado y el usuario cuenta con el permiso de escritura. El estado actual de la plantillaabierta aparece en la barra de título de la ventana Process Builder. Si no está validada,seleccione Plantilla de proceso > Validar en el menú Herramientas. Consulte Validarplantillas de proceso, página 90 para obtener más información.

Si necesita realizar cambios en una plantilla instalada, primero debe desinstalarla. Sedetendrán todos los flujos de trabajo activos basados en la plantilla. Una vez realizadoslos cambios, vuelva a validar e instalar la plantilla.

Cuando vuelva a instalar la plantilla, podrá elegir la forma en la que desea tratar losflujos de trabajo detenidos 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 trabajoSus opciones elegidas dependerán de los cambios realizados en el flujo de trabajo.Quizás eliminó una actividad o agregó una actividad que desea realizar en todos losobjetos del flujo de trabajo, o modificó las condiciones de la transición. En cualquiera deestos casos, cancele los flujos de trabajo y reinícielos. Para eliminar un flujo de trabajoen ejecución, debe anular el flujo de trabajo y elegir la opción para destruir los objetosen 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 o que no se ha guardado o validado.Si existen flujos de trabajo detenidos basados en esta plantilla de proceso, tendrála posibilidad de reanudarlos o de detenerlos. Haga clic en una de las siguientesopciones:• Haga clic en Sí para reanudar los flujos de trabajo detenidos.

Si reanuda un flujo de trabajo detenido que esté basado en una plantilla deproceso en la que ha realizado cambios importantes, las incompatibilidadesentre la plantilla antigua y la modificada pueden ocasionar que el flujo de trabajoadopte un estado sin definir.

• Haga clic en No para anular los flujos de trabajo detenidos.

Para 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 usuariocuenta con permiso de escritura.Si algún usuario está ejecutando flujos de trabajo que estén basados en esta plantilla,aparece un mensaje 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 detrabajo o en No 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 procesoha finalizado.

Modificar plantillas de proceso

Para cambiar una plantilla de proceso, modifique su flujo de procesos o sus definicionesde actividad. Siempre que cambie una plantilla, podrá sobrescribirla con los cambios ocrear otra versión de la misma. Todos los cambios realizados se rigen por los permisosdel ámbito de los objetos.

Para realizar cambios en una plantilla y guardarlos sin crear otra versión, debedesinstalarla. La desinstalación de una plantilla requiere que se disponga del permisoRelacionar o de privilegios de administrador del sistema o superusuario. Para guardarlos cambios, necesita el permiso de escritura.



Si desea crear una versión de una plantilla de proceso, debe retirarla antes de comenzar amodificarla. Debe disponer del permiso Versión como mínimo. Puede crear otra versiónde una plantilla sin desinstalar la actual. La creación de otra versión no afectará a losflujos de trabajo en ejecución que esté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 estadoborrador. La nueva versión se debe validar e instalar antes de iniciar un flujo de trabajobasado en ella.

Consulte también Guardar plantillas de proceso, página 87.

Plantillas de proceso para registrar, retirar ycrear versiones

Para bloquear y editar una plantilla de proceso existente, retírela utilizando ProcessBuilder. Cuando se abre el proceso para su edición, el sistema bloquea el archivopara que nadie más pueda realizar cambios en él. Al finalizar el proceso de edicióny registrar una plantilla de proceso cambiada, modifique la etiqueta de la versión yconservar un historial actualizado de todos los cambios realizados en la plantilla deproceso. 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 plantillade proceso refleja que está bloqueada por otro usuario. Para ver el nombre de usuariodel propietario del bloqueo, coloque el cursor sobre el icono.

Tabla 5. 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 una plantilla después de haberla modificado, puede decidir si registrar elarchivo como una nueva versión o como la misma versión. Al registrar una plantilla enel repositorio, el sistema le pide que seleccione si desea aumentar el número de versiónen un número entero o mediante un separador decimal (por una décima). Aumentar elnúmero de versión en un número entero se considera una revisión principal. Aumentarmediante 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 sinaumentar el número de versión, la plantilla mantiene el mismo número de versión como



la plantilla original y el sistema sobrescribe la plantilla original con los cambios quesimplemente ha realizado y lo etiqueta como ACTUAL. Al retirar una plantilla, puededecidir ver sólo la versión actual o todas las versiones.

Registrar y retirar los procesos en el repositorio utilizando Process Builder es muysimilar a registrar y retirar los documentos en otras aplicaciones de Documentum. Unadiferencia muy importante es que una plantilla de proceso se puede instalar y utilizaral retirarla. Para modificar una plantilla existente y guardarla como la misma versión(ACTUAL), debe desinstalar primero la plantilla (lo que detiene todas las instancias dela plantilla en el entorno de tiempo de ejecución). Esto le evita realizar cambios en unaplantilla cuando se utiliza en el entorno en tiempo de ejecución. Después de desinstalarel proceso, es libre para realizar cambios en él, registrarlo como la misma versión y, acontinuación, validar e instalar la plantilla.

Nota: Durante el momento en que se desinstala la plantilla, el sistema detiene todaslas instancias en ejecución del flujo de trabajo e impide que se inicie cualquier nuevainstancia. Una vez instalada de nuevo la plantilla, puede cancelar o reanudar lasinstancias detenidas, dependiendo de la complejidad de los cambios realizados en laplantilla. Las modificaciones realizadas en las plantillas existentes deberían limitarse acambios menores de propiedades de actividad que no utilice actualmente la instancia o acambios relacionados con las actividades futuras de la instancia.

Para eliminar un flujo de trabajo en ejecución, debe anular el flujo de trabajo y elegir laopción para destruir los objetos en tiempo de ejecución en Webtop.

Si retira una plantilla instalada sin desinstalarla primero, cualquier instancia en ejecucióndel proceso continúa ejecutándose, utilizando la versión existente de la plantilla(etiquetada como ACTUAL). La versión de la plantilla que está editando se abre comoun borrador y sólo se le permite guardar y registrar la plantilla como una nueva versiónmenor o mayor. Una vez registrada, validada e instalada, la nueva versión de la plantillapuede utilizarse en el entorno en tiempo de ejecución. Todas las instancias de procesocreadas usando la versión anterior continuarán ejecutándose hasta que hayan finalizado.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 cambiosrealizados en la plantilla de proceso durante el momento en que se retiró. El repositoriomantendrá la última versión de la plantilla como la versión actual.

Para retirar una plantilla de proceso:

1. En el menú Archivo , seleccione Abrir para mostrar el cuadro de diálogo Abrirplantilla de proceso

Nota: Para retirar un proceso que ya está abierto en el panel del editor, haga clic eno seleccione Archivo > Retirar en el menú.

2. En el cuadro Ver, siga uno de estos procedimientos:



• Seleccione la opciónMostrar TODAS las versiones para mostrar todas lasversiones existentes.

• SeleccioneMostrar versiones actuales para mostrar sólo esas versiones de laplantilla etiquetadas 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 laplantilla. Sólo puedeMostrar una versión de sólo lectura de la plantilla hasta que seregistra por el propietario del 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 laopción de desinstalar primero la plantilla o continuar con la retirada sin desinstalarla plantilla. Una plantilla instalada sólo se abre como una plantilla de borrador ysólo puede guardarse como nueva versión mayor o menor. Para realizar los cambiosen una versión existente de una plantilla, debe desinstalarla antes de retirarla.

5. Haga clic en Abrir para abrir una versión bloqueada de la plantilla en el panel deleditor.El estado de la plantilla en la barra de título de Process Builder cambia a Retirado.

Para registrar una plantilla de proceso:

1. Haga clic en el icono o seleccione Archivo > Registrar para mostrar el cuadro dediálogo Registrar plantilla de proceso.

2. Seleccione la opción para guardar el proceso nuevo comoMisma versión, Versiónmenor o Versión mayor.Registrar la plantilla como la misma versión realiza los cambios en la versiónACTUAL.

Nota: Si ha realizado los cambios en una plantilla instalada, puede guardar sólola plantilla como una versión menor o mayor. La opción de registrarlo como lamisma versión no está disponible, ya que sobrescribir la versión actual afectaría a lasinstancias del proceso que están en ejecución.

3. Escriba una etiqueta descriptiva opcional para la nueva versión.


Para cancelar una retirada en una plantilla de proceso:

Utilice este procedimiento cuando desee volver a registrar la plantilla en el repositoriosin guardar los cambios realizados. No se cambiará la versión existente etiquetada comoACTUAL en el repositorio.

1. Haga clic en el icono o seleccione Archivo > Cancelar retirada para accederal cuadro de diálogo Cancelar retirada.



El sistema muestra un mensaje que advierte que se perderán todos los cambiosrealizados en la plantilla.

Nota: Los superusuarios pueden cancelar la retirada de plantillas que sonbloqueadas por otros usuarios.

2. Haga clic en Sí para cancelar la retirada.

Eliminar las plantillas de proceso

La opción para eliminar una plantilla de proceso sólo está disponible si ésta está abiertaen Process Builder.

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 ladesinstale antes de eliminarla. Asimismo, si algún usuario está ejecutando flujos detrabajo que estén basados en esta plantilla, aparece un mensaje advirtiéndole de quehay instancias activas del flujo de trabajo.

2. Haga clic en Sí para desinstalar y eliminar la plantilla de proceso y las actividadesrelacionadas.

Importar plantillas de proceso

Durante el proceso de importación, se toma un archivo XPDL exportado y se dejadisponible para trabajar con él en Process Builder o Process Analyzer. Los tiposde actividad automática y manual se mantienen durante la importación, aunqueel desarrollador deberá agregar las definiciones como, por ejemplo, los métodos ytemporizadores, a Process Builder. En el proceso de importación no se incluyen lospaquetes.

Asimismo, si importa (o vuelve a importar) un proceso que contenga varias actividadesde finalización desde Process Analyzer, Process Builder agregará una actividad vacíaadicional a la que se conectarán todas las actividades de finalización. (Process Builderadmite sólo una actividad de finalización, mientras que los procesos exportados desdeProcess Analyzer pueden contener varias actividades de finalización).

Nota: Si hay errores semánticos en el XPDL importado, el sistema guardará la nuevaplantilla de proceso en un estado no válido. Utilice la información de cada mensaje deerror de validación para corregir 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 losdirectorios que figuran en el cuadro de diálogo Proceso de importación hasta que sehaya resaltado el nombre del archivo.

3. Haga clic en Abrir.Process Builder creará un nuevo borrador de plantilla de proceso basado en elproceso de Business Process Analyzer.Si la información de ubicación del diseño de la actividad está disponible, se aplicaa la plantilla de proceso importado. Por otra parte, el sistema utilizará el diseñopredeterminado y la configuración de vista gráfica. Puesto que la información deinterfaz de usuario, tal como gráficos o imágenes, no se exporta con el proceso,deberá volver a crearla en Process Builder.A continuación, deberá definir la información de ejecución para el proceso queutiliza el Inspector de actividades.Consulte el Capítulo 7, Trabajar con actividades si necesita más información sobrecómo definir los detalles de la ejecución para las actividades.

Mantener sincronizados los procesoscompartidos

Los procesos comerciales se pueden compartir y modificar en Process Builder o enProcess Analyzer. Para mantener el proceso sincronizado entre las dos aplicaciones,deberá volver a importar el proceso cambiado a su aplicación original.

Un proceso de Process Analyzer se puede exportar e importar, a continuación, a ProcessBuilder y modificar. Por ejemplo, utilice Process Builder para definir los detalles deejecución, agregar una actividad nueva o cambiar el orden de las actividades. Comoresultado de estos cambios, el analista comercial comprueba de nuevo el proceso enProcess Analyzer o ejecuta una simulación del proceso comercial que se ha cambiado.Al volver a importar el proceso que se ha cambiado en Process Builder, se actualizael proceso original en Process Analyzer y se mantiene el proceso sincronizado entreambas aplicaciones.

Un proceso existente de Process Builder se puede exportar desde su aplicación original,importar en Process Analyzer y modificar. Por ejemplo, el analista comercial puedecambiar el orden de las actividades, agregar o eliminar una actividad. Para mantenerel modelo ejecutable del proceso sincronizado con el proceso que se ha cambiado, sedeberá volver a importar en Process Builder. Durante la operación de volver a importar,



el sistema utiliza la funcionalidad de creación de versiones y ofrece la opción de guardarel proceso como la misma versión, una versión menor o una mayor.

Para volver a importar un proceso comercial que se ha cambiado aProcess 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 97 para conocer el procedimientopara importar un proceso en Process Builder.

3. En el menú Archivo, seleccione Guardar.Aparecerá el cuadro de diálogo Registrar plantilla de proceso, en el que se indicaque el sistema ha detectado una versión existente del proceso en el repositorio.

4. Seleccione la opción para guardar el proceso nuevo comoMisma versión, Versiónmenor o Versión mayor.El proceso nuevo se convertirá en la versión actual del proceso y el sistemamantendrá las versiones anteriores con fines históricos. Todas las instancias delproceso creadas mediante la versión anterior continuarán ejecutándose con laplantilla de proceso de la versión anterior.Asimismo, una vez que un proceso se registra como una versión mayor o menor,Process Builder no permitirá el almacenamiento de una versión anterior del procesosi ya existe una versión más reciente en el repositorio. Por ejemplo, el sistemaimpedirá guardar una importación de la versión 1.0 de un proceso si ya existela versión 1.1 en el repositorio. Se puede cambiar el nombre y guardar la versiónanterior como un proceso diferente.Un proceso comercial sólo se puede guardar como la misma versión si aún no se hainstalado dicha versión del proceso. Si se ha instalado una versión existente delproceso comercial, el sistema no permitirá que se guarde como la misma versión. Sedeberá guardar como una versión cambiada.

5. Haga clic en Aceptar.Si cuenta con los permisos correspondientes en la carpeta seleccionada, ProcessBuilder guarda la plantilla y sus actividades. Si ha definido que se soliciteconfirmación para la instalación y validación, se muestra un cuadro de diálogo en elque se le pregunta si desea validar la plantilla.Consulte Validar plantillas de proceso, página 90 si necesita más información sobrela validación de la plantilla.

6. Elija si desea instalar la plantilla de proceso.Consulte Instalar plantillas de proceso, página 92 si precisa más información sobre lainstalación de plantillas.



Exportar plantillas de proceso

Mediante el proceso de exportación desde Process Builder o Process Analyzer se creaun archivo XPDL (XML Process Definition Language) que se guarda en una ubicaciónespecificada en un sistema de archivos. A continuación, este archivo se puede importaren Process Analyzer o Process Builder. Las plantillas exportadas desde ProcessBuilder contienen las definiciones de tipo que Process Analyzer utiliza para crear losobjetos empresariales correspondientes. El archivo XPDL exportado contiene tambiéninformació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 deexportación hasta que se haya resaltado la carpeta.

3. Haga clic en Guardar.

Imprimir plantillas de proceso

Puede 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 Definir las opciones de configuración de página, página 101 y Vista previade procesos impresos, página 102 si necesita información sobre dichas opciones.

3. Haga clic en el icono Imprimir diseño de plantilla de la barra de herramientas oseleccione Imprimir en el menú Archivo.Aparece el cuadro de diálogo Imprimir.

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 actualicela configuración.Consulte la documentación de la impresora si necesita más información sobre suspropiedades.



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 decopias deseadas en el cuadro Número de copias.

Nota: Los controles del cuadro Intervalo de impresión aparecen como nodisponibles, excepto el botón de opción Todos. No se pueden imprimir partes dela plantilla, sino la plantilla completa.

8. Haga clic en Aceptar.Si ha elegido imprimir a un archivo, aparece el cuadro de diálogo Imprimir aun archivo. De lo contrario, la plantilla de proceso se enviará a la impresoraseleccionada.

9. En el cuadro de diálogo Imprimir a un archivo, escriba el nombre del archivo quedesea crear, incluyendo la ruta completa.

Definir las opciones de configuración de página

Las opciones de configuración de página determinan la forma en la que se imprimirála plantilla de 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 cadaformato aparecen en pulgadas o centímetros, según la unidad de medida elegida enel 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, porejemplo, 1,25 pulgadas o 4,44 centímetros.



5. Haga clic en Aceptar para guardar las opciones de configuración de página y salirde este cuadro de diálogo o en Imprimir para imprimir la plantilla actual con dichaconfiguración.

Vista previa de procesos impresos

La opción Vista preliminar ofrece una representación gráfica de la imagen que seimprimirá.

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 unaimagen preliminar de la plantilla de proceso tal y como aparecerá en la impresión.El diseño se basa en las opciones de configuración de la página y en la opciónTamañ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 visualización de la

plantilla de proceso en Process Builder.• Igual que el tamaño de papel: el tamaño de la plantilla de proceso se ajustará

para que ocupe una única página con el tamaño y la orientación especificadosen los pasos 2 y 3.

• Ajustar a: el tamaño de la plantilla de proceso se ajustará de modo que ocupeuna cantidad de páginas especificada tanto a lo ancho como a lo largo. Siselecciona esta opción, debe escribir un número en cada uno de los dos cuadrosde texto adyacentes.

3. Haga clic en Aceptar para guardar la opción Tamaño de impresión y salir deeste cuadro de diálogo o en Imprimir para imprimir la plantilla actual con dichaconfiguración.


Capítulo 4

Conectar actividades

Las 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 17 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ónvisual de la plantilla de proceso. Cambiar la configuración de vista, página 104 proporciona másinformación sobre 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 activa 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 aquél cuyo nombre aparece en el cuadro de texto superior.Las opciones que no tengan la casilla marcada se aplicarán únicamente al flujo actual.

Crear flujos

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 enel icono Crear flujo de un solo segmento o en el icono Crear flujo de segmentosmúltiples . La diferencia entre los dos es visual: uno muestra una línea recta querepresenta el flujo entre las actividades y el otro una línea que consta de variossegmentos.

• Para conectar actividades en un movimiento de datos hacia atrás, haga clic en elicono Crear flujo de rechazo . Este icono representa la ruta que se sigue cuando elusuario de una actividad rechaza el objeto que se está procesando.

• Para conectar una actividad automática a una actividad de controlador de errores,haga clic en el icono Assign Fault Handlers (Asignar controladores de errores).Los controladores de errores le permiten asignar una actividad del control de erroressecundaria a una actividad automática en caso de que se produzca un error en laactividad automática. Una actividad de controlador de errores tiene una líneadiscontinua que representa el flujo entre la actividad automática y su controladorde errores relacionado.

Actividades del controlador de errores, página 20 proporciona información detalladasobre este tema.

Consulte Plantillas de proceso y objetos de flujo de trabajo asociados, página 17 paraobtener una descripción de los tipos de flujos.

Cambiar la configuración de vista

Las opciones de la ficha Visualización controlan la forma en la que el flujo se muestra enla plantilla de proceso.

Nota: Las opciones de la ficha Visualización no controlan si la línea de flujo comienzacon un diamante de estilo BPMN. Los flujos tienen un diamante cuando la actividad quelos crea selecciona la siguiente actividad mediante lógica condicional. Definir las reglasde transición de actividad, página 149 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 lasactividades conectadas o como Líneas de segmentos múltiples, con cada segmentotrazado en sentido horizontal y vertical.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 nombresde los paquetes distribuidos a través del flujo.



Esta configuración sólo se tiene en cuenta si elige mostrar los nombres del paquete enel próximo paso o si escribe en etiquetas personalizadas para ese segmento de flujo.

a. Seleccione una fuente en la lista Fuente de etiquetas.


c. Para definir el estilo de fuente de la etiqueta, marque o quite la marca de Negritay Cursiva.

4. Especifique cómo se debe etiquetar el flujo en la pantalla del editor de plantillas deproceso.

a. Active la casilla de verificaciónMostrar etiqueta si desea que aparezca unaetiqueta en el flujo, o bien desactívela si no desea que aparezca. Los dos botonesde opción situados bajo la casilla de verificación aparecen como no disponiblessi la casilla no está activada.

b. SeleccioneMostrar paquetes visibles en la actividad de destino para etiquetarel flujo con los nombres de paquetes controlados por la siguiente actividad.O bien, seleccione Etiqueta personalizada y escriba el texto de la etiqueta enel cuadro de texto adyacente.

5. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector de flujoso en Aceptar para guardarlas y cerrar el Inspector.


Capítulo 5

Crear subprocesos

Los 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 actividadesque comparten 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ónpara el proceso. Las plantillas de actividades incluidas en el subproceso publican también datos deinformes cuando se seleccionan para la generación de informes.

En las secciones siguientes se describe cómo crear subprocesos dentro de una plantilla de proceso:

• Crear un subproceso utilizando el modelado descendente, página 108• Crear un subproceso utilizando el modelado ascendente, página 108• Establecer las propiedades del subproceso, página 109• Gestionar subprocesos, página 110


Crear subprocesos

Crear un subproceso utilizando el modeladodescendente

El modelado descendente hace referencia a la práctica de crear primero un subprocesovacío y, a continuación, agregarle actividades individuales a medida que se definen. Esteenfoque es especialmente útil cuando se pretende diseñar primero los conceptos de altonivel iniciales del proceso y completar los detalles en una fase posterior en desarrollo.

Para crear un subproceso seleccionando actividades existentes:

1. Seleccione el icono Crear subproceso y, a continuación, haga clic en el panel deleditor de plantillas de procesos donde desea que aparezca el subproceso.El nuevo subproceso vacío aparece como un rectángulo coloreado etiquetado comoSubproceso.

2. Haga clic en el subproceso y arrástrelo hacia la posición deseada de la ventana deleditor de procesos.

3. Haga clic con el botón derecho del ratón en el subproceso y seleccione Inspectorde subproceso para establecer las propiedades que se comparten en todas lasactividades dentro del subproceso.Establecer las propiedades del subproceso, página 109 proporciona instruccionesdetalladas para establecer 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 otraposición de la 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 deproceso.

Nota: Las líneas de flujo no se conectan al contenedor de subprocesos, sino a lasactividades individuales dentro del subproceso. Un subproceso no está limitado enel número de flujos de entrada o salida que entran o salen de sus límites.

Crear un subproceso utilizando el modeladoascendente

El modelado ascendente es la práctica de crear primero el proceso comercial con todassus actividades y a continuación agrupar actividades relacionadas en subprocesos.


Crear subprocesos

Este método le permite crear primero todas las actividades necesarias, agruparlas ensubprocesos y contraerlas para ver un flujo má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ánguloalrededor de las actividades que desea incluir en el subproceso o manteniendopresionada la tecla Mayús y haciendo clic en las actividades individualmente.Las actividades seleccionadas se rodean con una línea de guiones verde.

2. Seleccione Herramientas > Subproceso > Agregar a subproceso.Las actividades seleccionadas aparecen en un rectángulo coloreado etiquetadocomo Subproceso

3. Haga clic con el botón derecho del ratón en el subproceso y seleccione Inspectorde subproceso para establecer las propiedades que se comparten en todas lasactividades dentro del subproceso.Establecer las propiedades del subproceso, página 109 proporciona instruccionesdetalladas para establecer estas propiedades.

4. Puede hacer clic en el nuevo subproceso y arrastrarlo a la posición deseada de laventana.

Establecer las propiedades del subproceso

Haga clic con el botón derecho del ratón en el subproceso y seleccione Inspector desubproceso para establecer las propiedades que se comparten en todas las actividadesdentro del subproceso. Las propiedades de subproceso son independientes de laspropiedades de actividad.

Utilizar la ficha Temporizadores

Process Builder admite dos tipos de temporizador de advertencia para los subprocesos:• Un pre-temporizador se pone en funcionamiento si una actividad no se ha

desencadenado dentro de un período de tiempo especificado tras el inicio del flujode trabajo.

La actividad se considera desencadenada una vez que la crea el flujo de trabajo,aunque el usuario no la haya adquirido. Los pre-temporizadores no se activanen la primera actividad de un flujo de trabajo, ya que se desencadenan de formaautomática al iniciarse los flujos de trabajo.


Crear subprocesos

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

Si precisa más información sobre temporizadores de flujo de trabajo, consulte Definirtemporizadores, página 42.

Cuando un subproceso tiene definidas una o más acciones del temporizador, aparece unpequeño icono de reloj en la esquina inferior derecha del subproceso.

Utilizar la ficha Visualización

Las opciones de la ficha Visualización controlan la forma en la que se mostrará laactividad en la plantilla de proceso.

Nota: Cuando una actividad tiene definidas una o más acciones del temporizador,aparecerá un pequeño icono de reloj en la esquina inferior derecha del contenedor desubprocesos.

1. En el Inspector de subproceso, haga clic la ficha Visualización.

2. Defina la fuente y el estilo usados para designar la actividad en la plantilla.




3. Seleccione el color de fondo para el formulario de subproceso el campo Color defondo.

4. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector desubproceso o en Aceptar para guardarlas y cerrar el Inspector.

Gestionar subprocesos

Esta sección describe las siguientes funciones disponibles para gestionar subprocesos:• Expandir y contraer un subproceso, página 111• Quitar actividades de un subproceso, página 111• Agregar notas a un subproceso, página 111• Eliminar un subproceso y su contenido, página 112


Crear subprocesos

Expandir y contraer un subproceso

Se puede expandir y contraer un subproceso para mostrar u ocultar su contenido.Para expandir un subproceso individual, haga clic en el signo más ; se expandiráel límite y se mostrará el contenido del subproceso para que pueda ver las distintasactividades. Para expandir todos los subprocesos de la plantilla, seleccioneHerramientas> Subproceso > Expandir todo; todos los subprocesos mostrarán su contenido.

Para contraer un subproceso individual, haga clic en el signo menos y el subprocesose minimiza, ocultando el contenido. Para contraer todos los subprocesos de la plantilla,seleccione Herramientas > Subproceso > Contraer todo.

Cuando se contrae un subproceso, las actividades que contiene se ocultan de la vista.Puede arrastrar un subproceso contraído hacia las distintas ubicaciones del Editor deplantillas de proceso y las líneas de flujo ajustan automáticamente su longitud a la nuevaposición. No puede arrastrar una actividad a un subproceso contraído.

Quitar actividades de un subproceso

Puede quitar actividades de un subproceso sin modificar el subproceso. La actividad nocambiará de posición en la pantalla, por lo que debe arrastrarla a una nueva ubicaciónfuera del 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ápermanentemente del subproceso.

3. Arrastre la actividad a una nueva ubicación en la pantalla.

Agregar notas a un subproceso

Puede agregar texto al diseño visual de la plantilla de proceso mediante notas.

Para agregar notas a un subproceso, seleccione un subproceso expandido, haga clicen el icono Notas y, a continuación, haga clic dentro del límite del subproceso. Puedecrear también una nota dentro del Editor de plantillas de proceso y arrastrar la nota alsubproceso. Las notas se ocultan cuando el subproceso se contrae y se muestran alexpandirse. Agregar notas , página 65 proporciona instrucciones sobre cómo utilizar lasnotas en una plantilla de proceso.


Crear subprocesos

Eliminar un subproceso y su contenido

Al eliminar un subproceso, también se eliminan todos los objetos que se encuentrandentro del subproceso. Entre estos objetos se incluyen las plantillas de actividad quepertenecen al subproceso. Para conservar las plantillas de actividad incluidas en elsubproceso, utilice la opción Quitar de subproceso.

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.


Capítulo 6

Trabajar con plantillas de actividad

Las plantillas de actividad representan un tipo de tarea determinado que se puede agregar a unproceso comercial. Estas plantillas identifican todos los métodos subyacentes de flujos de trabajonecesarios para finalizar la tarea y determinan los atributos de configuración que se deben definir afin de completar la tarea. La plantilla también puede definir valores predeterminados para algunosatributos 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 Activity Template (Plantilla de actividad) ylo arrastra en la ventana Process Template Editor (Editor de plantilla de proceso). Process Builderincluye plantillas para tipos de actividades de integración habituales, así como una plantilla deactividad de ejemplo. Consulte Apéndice A, Plantillas de actividades incorporadas para obtener unalista de las plantillas de actividades facilitadas por Process Builder. La guía Documentum ProcessBuilder Development Guide proporciona más información sobre cómo crear plantillas de actividadpersonalizadas.

Existen tres posibles estados de las plantillas de actividad: borrador, validado e instalado. Unaplantilla de actividad con el estado borrador no se ha validado desde que se creó o desde la última vezque se modificó. Una plantilla con el estado validado ha pasado las verificaciones de validación delservidor, que garantizan que la plantilla se ha definido correctamente. Una plantilla con el estadoinstalado está lista para usarse y crear actividades en el flujo de proceso. El estado actual de unaplantilla de actividad se indica en el icono de ésta en la ventana Activity Template (Plantilla deactividad).

En este capítulo se describe la forma de crear plantillas de actividad, configurarlas, validarlas einstalarlas. Los temas son los siguientes:

• Crear plantillas de actividad, página 114• Gestionar las plantillas de actividad dentro de las carpetas, página 115• Configurar plantillas de actividad, página 116• Validar e instalar plantillas de actividad, página 117



Crear plantillas de actividad

Si su proceso comercial contiene actividades para las que Process Builder no incluye unaplantilla adecuada, puede crearla. Puede copiar una plantilla existente y a continuaciónmodificarla, o bien crear una plantilla nueva.

Para crear una plantilla de actividad nueva:

1. Seleccione la carpeta en la que agregará la nueva plantilla.

2. En el menú Herramientas, seleccione Plantilla de actividad > Nuevo o haga clic conel botón derecho en la carpeta y seleccione Nuevo en el menú.Aparecerá una nueva plantilla de actividad con el nombre Sin título en la carpeta deplantillas de actividad actualmente activa.

3. Haga doble clic en la nueva plantilla de actividad para abrir el Inspector de plantillade actividad.

4. Configure la plantilla.Consulte Configurar plantillas de actividad, página 116 si necesita más informaciónsobre la configuración de plantillas de actividad.

Para crear una nueva plantilla de actividad basada en otra existente:

1. En un nodo de plantilla de actividad, seleccione la plantilla de actividad que deseacopiar.

2. En el menú Herramientas, seleccione Plantilla de actividad > Guardar como.Las carpetas se muestran en System/Workflow/Activity Templates, que representanlas plantillas de actividad disponibles.

3. Seleccione la carpeta de plantilla de actividad a la que desea agregar la plantillanueva.

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 tienelas mismas características que la plantilla seleccionada en el paso 1. Sin embargo,la plantilla original y la plantilla nueva son independientes. Los cambios futurosen 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 116 si necesita más informaciónsobre la configuración de plantillas de actividad.



Gestionar las plantillas de actividad dentro delas carpetas

Hay muchas plantillas de actividad organizadas por función bajo las carpetas (o nodos)de la ventana Activity Template (Plantilla de actividad). Puede examinar las plantillas deactividad entregadas abriendo y cerrando las carpetas a las que pertenecen. Apéndice A,Plantillas de actividades incorporadas proporciona información detallada sobre a quénodo pertenece la plantilla de actividad e instrucciones para configurar cada plantillade actividad. Gestionar las carpetas de plantillas de actividades, página 52 proporcionainformació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é carpetaaparece. Dado que una plantilla de actividad puede ser importante en más de un tipo desituación o proceso empresarial, esta plantilla puede aparecer en más de una carpeta.

Para agregar (copiar) una plantilla de actividad en otra plantilla deactividad:

1. Seleccione la carpeta de actividad a la que desea agregar la plantilla.

2. En el menú Herramientas, seleccione Plantilla de actividad > Agregar o haga cliccon el botón derecho en la ventana Plantillas de actividad y seleccione Agregar.Aparecerá el cuadro de diálogo Abrir.

3. En el cuadro Seleccionar de, desplácese hasta la plantilla de actividad que deseaagregar y selecciónela.

4. Haga clic en Aceptar.La plantilla de actividad seleccionada aparecerá en la plantilla actual. La plantillaya está enlazada a esta carpeta, así como a la carpeta original. Todos los cambiosrealizados en la plantilla se reflejarán en ambas carpetas.

Para quitar una plantilla de actividad de una carpeta:

1. Seleccione la plantilla de actividad que desea quitar.

2. En el menú Herramientas, seleccione Plantilla de actividad > Quitar o haga clic conel botón derecho en la ventana Plantillas de actividad y seleccione Quitar.La plantilla de actividad se quita de la paleta actual. Si la plantilla está enlazada aotra carpeta, seguirá apareciendo en esa carpeta.



Configurar plantillas de actividad

Configure una plantilla de actividad con el Inspector de plantilla de actividad. EsteInspector comparte varias fichas con el Inspector de actividades, que se utiliza paraconfigurar actividades individuales. Con estas fichas compartidas, los valores quedefina para la plantilla de actividad pasan a ser los valores predeterminados de lasactividades creadas a partir de la plantilla. El Inspector de plantilla de actividad nopermite definir información sobre la prioridad, paquetes, flujos de entrada y salida uopciones de transición. Estos atributos de configuración guardan relación con la formaen la que una actividad individual se ajusta a un flujo de proceso específico, por loque no son relevantes para las plantillas.

El Inspector de plantilla de actividad también incluye una ficha adicional, llamadaDefinición, que define atributos personalizados para las actividades creadas con laplantilla. Los atributos se definen mediante XML, que define los nombres, tipos de datosy características de visualización de los atributos personalizados, así como ayuda paralos usuarios que introducen valores para los atributos. Si una actividad se crea a partirde la plantilla, el Inspector de actividades incluirá una o varias fichas adicionales paraque 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 actividadpuede suprimir la visualización de una o varias fichas estándar del Inspector deactividades. Si una actividad se crea a partir de la plantilla, el Inspector de actividadesno muestra ninguna de las fichas suprimidas, por lo que se impide que el usuariopueda cambiar valores de la ficha. Los valores definidos en el Inspector de plantilla deactividad permanecen inalterados.

La estructura del archivo XML de una plantilla de actividad queda definida por elarchivo de esquema activity.xsd, que se encuentra en el sistema de archivos localdel directorio Archivos de programa\Documentum\bpm\classes. Consulte la guíaDocumentum Process Builder Development Guide si necesita más información sobrela estructura del archivo. Para ver un ejemplo de archivo XML de una plantilla deactividad, consulte la plantilla de actividad Sample (Ejemplo) que hay instalada en lacarpeta 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 elijaInspector de plantilla 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óndisponibles en las otras fichas.Los valores definidos en la plantilla pasarán a ser los predeterminados de cualquieractividad creada a partir de la plantilla. Consulte el Capítulo 7, Trabajar con



actividades para obtener detalles sobre la definición de atributos. Normalmente,se aconseja enlazar la plantilla a un método de flujo de trabajo personalizado enla ficha Ejecutante.

3. Seleccione la ficha Definición.Aparecerá un cuadro de texto con los elementos XML que definen los atributospersonalizados para esta plantilla de actividad. Si se trata de una plantilla nueva osin atributos personalizados, los únicos elementos serán el elemento <xml> de nivelsuperior y el elemento <activity> que identifica el esquema XML de las plantillasde actividad.

4. Edite el XML para definir atributos personalizados y la interfaz de usuario quelos editará.El XML que introduzca debe cumplir con el archivo de esquema activity.xsd.Consulte la guía Documentum Process Builder Development Guide si necesita másinformación sobre la estructura del archivo.

5. Para suprimir la visualización de una o varias fichas en el Inspector de actividades,introduzca un elemento <tab> por cada ficha suprimida.El elemento <tab> debe ser un subelemento del elemento <tabs>, el cual tambiénespecifica la visualización de las fichas personalizadas en el Inspector de actividades.Con cada ficha que desee suprimir, introduzca 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 elCapítulo 7, Trabajar con actividades para obtener información sobre las opcionesde cada una de estas fichas. El parámetro showInActInspector se omite en lasfichas personalizadas.

6. Haga clic en Aceptar para cerrar el Inspector de plantilla de actividad.

Validar e instalar plantillas de actividad

Las plantillas de actividad pueden encontrarse en tres estados: borrador, validado einstalado. Una plantilla de actividad con el estado borrador no se ha validado desdeque se creó o la última vez que se modificó. Una plantilla con el estado validado hapasado las verificaciones de validación del servidor, que garantizan que la plantilla se hadefinido correctamente.

La lista siguiente detalla algunas de las marcas de validación que realiza el sistema:

• Cada actividad está conectada a la actividad de finalización mediante una ruta.• Los pre-temporizadores y post-temporizadores están correctamente configurados.• La selección del usuario es válida para las actividades manuales.



• Cada actividad intermedia está directa o indirectamente conectada a una actividadde inicio. (Una actividad del controlador de errores es una excepción, puesto quesólo está relacionada con actividades automáticas y no puede tener flujos de salida).

Una plantilla con el estado instalado está lista para usarse y crear actividades. El estadoactual de una plantilla de actividad se indica en el icono de ésta en la ventana ActivityTemplates (Plantillas de actividad). Una plantilla válida tiene una marca de verificaciónroja en el icono de plantilla y una plantilla instalada tiene una flecha en el icono deplantilla.

Con la validación de una plantilla de actividad, se verifica que ésta cumple los requisitosdel sistema. Solamente se puede realizar la validación si la plantilla abierta tiene elestado borrador y el usuario cuenta con el permiso de escritura.

Las plantillas de actividad se deben instalar a fin de que queden disponibles para crearactividades. Sólo se puede instalar una plantilla de actividad si tiene el estado validado yel usuario cuenta con permiso de escritura.

Si necesita realizar cambios en una plantilla de actividad instalada, primero debedesinstalarla. Una vez realizados los cambios, vuelva a validar e instalar la plantilla.

Para 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áactualmente validada 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 clicen el botón Detalles para ver el error que impidió la validación. Si la validación serealiza correctamente, aparecerá una marca de verificación roja junto al icono de laplantilla de actividad en la ventana 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áinstalada actualmente o no tiene permiso para instalar. Si la instalación se realizacorrectamente, aparecerá el icono de validación junto a la plantilla de actividaden la ventana 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 usuariocuenta con permiso de escritura. Si la plantilla se desinstala correctamente, se



sustituirá la flecha situada junto al icono de la plantilla (que representa el estado deinstalado) con una marca de verificación roja (que representa el estado validado).


Capítulo 7

Trabajar con actividades

Las 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 24.

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 ovarias actividades 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 123 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 125 proporciona información más detallada sobre estetema.

• La configuración de la ficha Desencadenador determina cuando se inicia la actividad. Definirdesencadenadores de actividades, página 140 proporciona información más detallada sobreeste tema.

• La ficha Temporizadores define las medidas que deben tomar los temporizadores si el trabajose estanca. Establecer temporizadores de advertencia, página 141 proporciona información másdetallada sobre este tema.

• La configuración de ficha Transición determina qué actividades van después en el flujo detrabajo. Definir las reglas de transición de actividad, página 149 proporciona información másdetallada sobre este tema.

• La fichaNotificación especifica si el supervisor del flujo de trabajo recibe una notificación cuandose producen determinados eventos del sistema. Definir notificaciones, página 154 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 158 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 deproceso. Cambiar la configuración de vista, página 161 proporciona información detallada sobreeste tema.

• Muchas actividades contienen una o varias fichas adicionales que incluyen propiedadesespecíficas de ese tipo de actividad. El nombre de la ficha y las propiedades incluidas en ella seestablecen en la plantilla de actividad. Configurar plantillas de actividad, página 116 proporcionamás información sobre 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 XML<dmp:param>supported_parameter</dmp:param>, donde supported_parameter es una de lasvariables que Process Builder admite para la sustitución de variables. Consulte el Apéndice B,Variables de sustitución para las propiedades de plantillas de actividades personalizadas paraobtener 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 116 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 laplantilla. Para cambiar este nombre, escriba otro en el cuadro de texto, reemplazando al anterior.Si se selecciona más de una actividad, aparecen botones de flecha a cada lado del cuadro de texto,que permiten el desplazamiento por las actividades seleccionadas. La configuración se aplicará ala actividad 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 activa 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 sólo a aquélla cuyo nombre aparece 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 actividades

La ficha Propiedades del Inspector de actividades permite definir la prioridad de lasactividades automáticas, proporcionar instrucciones a los ejecutantes de las actividadesmanuales o asociar formularios con actividades. Al crear una actividad que utiliza unformulario, el ejecutante de la tarea visualiza dicho formulario en tiempo de ejecución, enlugar de visualizar la interfaz estándar de Task Manager que aparece al abrir una tarea.

Para definir las propiedades de actividades:

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 elcampo ID de 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 actividadautomática y se ignora en las actividades manuales. Si precisa más información,consulte Definir valores de prioridad, página 33.La prioridad Dinámica se da cuando, en lugar de establecer la prioridad de laactividad como parte de la plantilla de proceso, se establece utilizando códigopersonalizado mientras se ejecuta el flujo de trabajo. Debe asignar esta prioridad sólosi el sistema incluye código personalizado para establecerla 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 unejecutante manual en el cuadro Nombre de tarea.De forma predeterminada, el mensaje predeterminado aparece en el cuadro.Además de texto normal, el mensaje puede contener los valores de atributos deflujo de trabajo que determina el sistema en el tiempo de ejecución. Por ejemplo, elmensaje puede incluir el nombre del flujo de trabajo o del documento que se estádistribuyendo. Puede escribir hasta 255 caracteres. El mensaje que ve el usuario, concualquier variable evaluada, se trunca a partir de 512 caracteres.Para incluir un atributo de tiempo de ejecución en el nombre de la tarea, agregueuna variable al mensaje mediante los siguientes pasos:

a. En el cuadro Nombre de tarea, coloque el cursor en la ubicación del texto dondedesea situar la variable.

b. Haga clic en Insertar. Aparecerá el cuadro de diálogo Insertar nombre de tareadesde el cual podrá elegir el atributo de tiempo de ejecución que desee incluir.

c. En el árbol Tipo de parámetro, seleccione el atributo que desea incluir en elmensaje de asunto.

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



Consulte Definir asuntos de tareas, página 31 para obtener información sobre lasvariables disponibles. Puede incluir varias variables en el nombre de la tarea.

5. Introduzca cualquier instrucción que desee incluir para el ejecutante de estaactividad en el campo Instrucciones de la tarea.

Nota: Las comillas tipográficas no se admiten en el campo Instrucciones de la tarea yevitarán que el 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 un parámetro al mensaje mediante los siguientes pasos:

a. En el cuadro Instrucciones de la tarea, coloque el cursor en la ubicación deltexto donde desea situar el parámetro.

b. Haga clic en Insertar. Aparecerá el cuadro de diálogo Insertar instrucción detarea, en el que puede seleccionar el atributo de tiempo de ejecución que deseaincluir.

c. En el árbol Tipo de parámetro, seleccione el atributo que desea incluir en lasinstrucciones de 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 se utilizará 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 formularioAdministration de proceso para habilitar la administración de los parámetros. Desdeel formulario, los administradores pueden cambiar el valor de los parámetros deproceso.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ónsobre la creación de formularios.

c. Haga clic en el botónActualizar para recuperar todos los formularios disponiblesdel repositorio.

7. Haga clic en Aplicar para guardar las actualizaciones sin cerrar el Inspector deactividades o en Aceptar para guardarlas y cerrar el Inspector de actividades.



Seleccionar ejecutantes

Al definir una actividad, es necesario especificar quién la llevará a cabo. Las actividadespueden ser realizadas manualmente por un individuo, grupo, cola de trabajo o aliasespecificado o automáticamente por un método de flujo de trabajo. En el caso de lastareas manuales, puede seleccionar ejecutantes concretos o permitir que los participantesen el flujo de trabajo los elijan. Para las tareas automáticas, debe especificar un usuariode 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 de esta actividad.• Para elegir uno o varios ejecutantes manuales, consulte Elegir ejecutantes

manuales, página 127.• Para elegir el usuario cuyos permisos se usan con una actividad automática,

consulte Elegir ejecutantes automáticos, página 139.4. Si ha seleccionado uno o varios ejecutantes manuales, elija qué acciones puede o

debe realizar el ejecutante.• Para permitir que el ejecutante pase la tarea a otro usuario o grupo, marque

Delegar el trabajo de la actividad en otra persona. Cuando seleccione estaopción, también deberá especificar dónde se enviará la tarea si tampoco estádisponible el usuario en el que el ejecutante la delega. Es posible reenviar latarea al supervisor del flujo de trabajo, o bien devolverla al ejecutante original sise produce un error en la delegación automática.

• Para permitir que el ejecutante elija otro usuario o grupo que realice junto a él latarea, marque Hacer que otra persona repita el trabajo de la actividad.

• Para hacer que el ejecutante cierre la sesión cuando haya finalizado la actividad,marque Es necesario que el ejecutante cierre la sesión cuando termine.

Si necesita información detallada sobre las opciones de delegación y extensión,consulte Permitir la delegación y la extensión, página 31.

5. Si ha seleccionado una actividad automática, defina los parámetros de ejecución.

a. Active la casilla de verificación Ejecutar este método automáticamente paraelegir un parámetro de ejecución automática en la lista desplegable. (Esta casilla



de verificación se activa de manera automática al usar Documentum ProcessBuilder 6.5 y versiones anteriores). Las acciones de la lista desplegable sonmétodos de flujo de trabajo.Si no se activa la casilla de verificación de la opción Ejecutar este métodoautomáticamente, el sistema utilizará el dm_bpm_noop_method suministradopara conectarse al repositorio y completar la actividad en lugar de iniciarun método en tiempo de ejecución. Esto significa que el sistema adquiere ycompleta la tarea en representación del ejecutante de la tarea.

Nota: Para que un método personalizado esté disponible aquí, el atributoa_special_app debe estar definido. El atributo a_special_app es un atributodm_sysobject cuyo uso está reservado para los productos de Documentum. Esteatributo debe tener el valor de flujo de trabajo. Consulte la guía DocumentumProcess Builder Development Guide para obtener detalles sobre el desarrollo demé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?

c. Especifique durante cuánto tiempo intentará el servidor de proceso ejecutareste método antes de salir. Introduzca una cantidad de segundos en el cuadroEl 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 yescriba un Intervalo de reintento para especificar un intervalo de tiempo entrelos reintentos. Utilice el campoMáximo de intentos para escribir un númeromáximo de veces que el sistema debería reintentar antes de realizar una de lasacciones especificadas en el paso 6c.

b. Si ha asignado un controlador de errores a esta actividad, el sistema muestrael nombre de la actividad del controlador de errores en el campo Pasar alcontrolador de errores. El controlador de errores se ejecuta cada vez que elmétodo falla.Actividades del controlador de errores, página 20 proporciona informacióndetallada sobre este tema.

c. Decida si el flujo de trabajo debe continuar o detenerse si se produce algúnproblema.

Si se selecciona Detener ejecución, la tarea se pondrá en pausa y sereasignará al supervisor del flujo de trabajo.Si se selecciona Continuar ejecución, la tarea se pondrá en estado adquiridoy 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 trabajo auna actividad

Puede asociar un módulo de prioridad a una actividad en la ficha Ejecutante delInspector de actividades. Establecimiento de la prioridad dinámica y de la lógicade caducidad para tareas, página 35 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 elmódulo de prioridad.Definición de de la prioridad inicial y antigüedad de tareas, página 33 proporcionainformación detallada sobre los módulos de prioridad.

Nota: Si se seleccionaran dos módulos diferentes para un flujo de trabajo (uno en ladefinición de actividad y otro en la política de cola de trabajos), el sistema utilizaráel módulo seleccionado desde dentro la actividad para calibrar la caducidad y lasprioridades.

Elegir ejecutantes manuales

Los pasos necesarios para seleccionar los ejecutantes manuales de una actividaddependen de dos factores:

• 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 ejecutantesmanuales, consulte Elegir ejecutantes, página 26.

Para elegir uno o varios ejecutantes manuales de una actividad:

1. En la ficha Ejecutante del Inspector de actividades, seleccione Por uno o másejecutantes manuales 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 usuarioconcreto cuando se ejecute el flujo de trabajo. Las opciones son:



• Cola de trabajo: la actividad la realizará un miembro de la cola de trabajoseleccionada.

Si necesita más información sobre la asignación de niveles de habilidad de colade trabajo a las tareas de una cola, consulte Asignar datos de proceso a un nivelde habilidad de cola de trabajo, página 138.

• Supervisor del flujo de trabajo: la actividad la realizará el supervisor del flujode trabajo; de forma predeterminada, es el usuario que inicia el flujo de trabajo.

• Propietario del repositorio: la actividad la realizará el usuario que es propietariodel repositorio.

• Ejecutante de la actividad anterior: la actividad la realizará el mismo usuarioque haya completado la actividad anterior en el flujo de trabajo. Esta opciónpuede incluir varios usuarios. Seleccione el nombre de la actividad que tengael ejecutante o grupo de ejecutantes que desea para compeltar esta actividad.Puede elegir una de dos opciones para seleccionar un ejecutante:

Asignar al último ejecutante de la actividad anterior significa que lapersona que desencadenó la finalización de la actividad anterior es elejecutante asignado.Asignar a todos los ejecutantes de la actividad anterior significa que todoslos ejecutantes de la actividad identificada son los ejecutantes asignados.

• Usuario específico: la actividad la realizará un usuario elegido de formaespecífica.

• Todos los usuarios del grupo: la actividad la realizarán todos los miembrosde un grupo específico.

• Un solo usuario del grupo: la actividad la realizará un único miembro de ungrupo específico.

• Algunos usuarios de un grupo: la actividad la realizarán algunos miembros deun grupo específico, aunque no todos.

• Varios ejecutantes secuenciales: la actividad la realizarán varios usuarios, unodetrás de otro.

El resto del procedimiento difiere en función de la opción que se seleccione. Siselecciona Supervisor del flujo de trabajo o Propietario del repositorio, el usuarioconcreto se determinará cuando se ejecute el flujo de trabajo. Haga clic en Finalizar eignore el resto de este procedimiento.Si ha elegido cualquier opción excepto las dos primeras, en la pantalla aparece uncuadro con el título Definir ejecutantes. Seleccione una opción en este cuadro paraespecificar cómo se seleccionarán los ejecutantes específicos de esta actividad.

3. Si ha elegido Ejecutante de la actividad anterior, seleccione el nombre de laactividad que tiene el ejecutante o grupo de ejecutantes que desea para completaresta actividad. Puede elegir una o dos opciones para seleccionar un ejecutante:• Asignar al último ejecutante de la actividad anterior significa que la persona

que desencadenó la finalización de la actividad anterior es el ejecutante asignado.



• Asignar a todos los ejecutantes de la actividad anterior significa que todos losejecutantes de la actividad identificada son los ejecutantes asignados.

4. Si ha elegido Varios ejecutantes secuenciales, especifique si todos los ejecutantesde esta actividad disponen del derecho de rechazar el paquete que reciban y dedevolverlo al ejecutante que les precedió en la secuencia.Los ejecutantes secuenciales no disponen de esta opción de forma predeterminada.Para que se encuentre disponible, marque la casilla situada justo debajo del cuadroSeleccionar ejecutantes.

5. Especifique si seleccionará a los ejecutantes de esta actividad ahora o si losdeterminará de forma diná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 plantilla de proceso.• Hacer que los ejecutantes de la actividad <nombre de la actividad> determinen

los ejecutantes de la actividad <nombre de la actividad>: los ejecutantes dela actividad anterior seleccionarán los ejecutantes de esta actividad cuandose ejecute el flujo de trabajo. Si esta actividad cuenta con varias actividadesanteriores, elija en la lista desplegable al ejecutante que seleccionará al ejecutantede esta actividad.

• Definir alias de ejecutante (los ejecutantes se asignarán cuando el flujo detrabajo esté en curso): un conjunto de alias determinará al ejecutante de estaactividad. Deberá especificar qué conjunto de alias se usa en los pasos siguientes.Esta opción no se encuentra disponible si ha seleccionado Algunos usuarios deun grupo o Varios ejecutantes secuenciales.

• Seleccionar ejecutante según condiciones: el ejecutante de la actividad sedetermina mediante la lógica condicional definida por el usuario, incluidos losdatos del paquete y las variables de proceso.

• Seleccionar ejecutante según datos de proceso: el ejecutante de la actividad sedetermina mediante los datos de proceso definidos por el usuario, incluidosdatos del paquete, variables de proceso y datos de ejecución.

6. Si ha elegido Un solo usuario del grupo, especifique qué usuario del gruposeleccionado realizará la actividad.Seleccionará el grupo en el paso siguiente. Para especificar qué usuario del gruporealizará la actividad, elija una de las opciones del cuadro Seleccionar usuario degrupo por:• Primero en adquirir el elemento de trabajo: una vez finalizada la actividad

anterior, se agrega un elemento de trabajo a la bandeja de entrada de cadausuario del grupo. El primer usuario que adquiere el elemento de trabajo de subandeja de entrada es el ejecutante. Los elementos de trabajo se quitan de lasbandejas de entrada del otro usuario.



• Cantidad menor de elementos de trabajo sin terminar: una vez finalizada laactividad anterior, se agrega un elemento de trabajo a la bandeja de entrada delusuario que tiene la menor cantidad de tareas sin terminar en la misma.

7. Haga clic en Siguiente para continuar.Los pasos necesarios para finalizar este procedimiento dependen de la opciónelegida.• Asignar ejecutantes ahora, página 130• Hacer que los ejecutantes de la <actividad> determinen los ejecutantes de la

actividad, página 131• Definir alias de ejecutante (los ejecutantes se asignarán cuando el flujo de trabajo

esté en curso), página 133• Select performer based on conditions (Seleccionar ejecutante según condiciones)

, página 134

Asignar ejecutantes ahora

Se 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 en Siguiente para abrir la pantalla de asignación de datos, en la que puedeasignar datos de proceso a los niveles de habilidad definidos para la cola.

Si necesita más información sobre la asignación de datos de proceso a los nivelesde habilidad, consulte Asignar datos de proceso a un nivel de habilidad de colade trabajo, página 138.

• Si ha seleccionado Usuario específico en la pantalla anterior, resalte el nombre deun grupo o <Todos los usuarios> en el cuadro de lista Grupos y elija al ejecutantede esta actividad entre los usuarios del grupo seleccionado en el cuadro de listaUsuarios del grupo. Tras seleccionar un usuario, haga clic en Finalizar.

• Si ha seleccionado Todos los usuarios del grupo o Un solo usuario del grupo en lapantalla anterior, elija un grupo en el cuadro de listaGrupos y haga clic en Finalizar.

• Si ha seleccionado Algunos usuarios de un grupo o Varios ejecutantes secuenciales,puede designar varios usuarios, grupos o nombres de alias para realizar la actividad.Consulte el procedimiento en el tema Hacer que los ejecutantes de la <actividad>determinen los ejecutantes de la actividad, página 131 si necesita informacióndetallada sobre las opciones que aparecen al hacer clic en Siguiente.

Nota: Dado que ha seleccionado Asignar ejecutantes ahora, el servidor elegirátodos los usuarios de la lista generada como ejecutantes y no usará la lista paraproporcionar una lista de selección al ejecutante de una actividad anterior, comose describe en el tema Hacer que los ejecutantes de la <actividad> determinen losejecutantes de la actividad, página 131.



Hacer que los ejecutantes de la <actividad> determinen losejecutantes de la actividad

Esta función también se conoce como selección de ejecutante dinámico. Con esta opción, elejecutante de una actividad tendrá la posibilidad de elegir a los usuarios que realizaránla siguiente actividad del flujo de trabajo. En tiempo de ejecución, el ejecutante de laactividad puede elegir uno o más usuarios del grupo especificado.

Si ha seleccionado Algunos usuarios de un grupo o Varios ejecutantes secuenciales,puede designar una combinación de varios usuarios, grupos o nombres de alias entrelos cuales el ejecutante de la actividad anterior puede elegir en tiempo de ejecución. Siha elegido cualquiera de los demás tipos de ejecutantes, no es necesario realizar másdefiniciones del ejecutante. Esta página no se muestra.

Si necesita más información sobre alias y conjuntos de alias, consulte Usar alias, página30.

Para seleccionar usuarios y grupos:

1. Elija una o varias opciones para seleccionar usuarios.Si selecciona más de una opción, las opciones siguientes aparecerán en ordensecuencial:• 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:

seleccione conjuntos de alias y alias para los que el iniciador del flujo de trabajoproporcionará nombres de usuario y grupo específicos al iniciar el flujo detrabajo.

• Alias de ejecutante que se resolverán en tiempo de ejecución a partir delconjunto de alias: seleccione los conjuntos de alias y alias que el servidor usaráen tiempo de ejecución para determinar los grupos y usuarios reales.

2. Haga clic en Siguiente.

3. Si ha seleccionado Usuarios o grupos específicos, seleccione los nombres de losgrupos o usuarios que pueden realizar esta actividad.

a. Resalte el nombre de usuario o grupo en la lista de la izquierda y haga clic enAgregar para agregarlo 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 en Siguiente o en Finalizar (en función de si ha elegido otras opcionesen el paso 1).

4. Si ha elegido Alias de ejecutante que se resolverán por el iniciador del flujo detrabajo y no ha definido aún un conjunto de alias predeterminado para este flujo detrabajo, elija uno.



• Para elegir un conjunto de alias existente, haga clic en Elija entre los conjuntosde alias existentes y seleccione un conjunto de alias en la lista desplegable. Enesta lista se muestran todos los conjuntos de alias del repositorio a los que estéconectado actualmente y para los que tenga permiso de escritura.

• Para elegir un nuevo conjunto de alias, haga clic en Crear nuevo conjunto dealias y escriba un nombre y una descripción para el mismo. El servidor crearáun alias con la información escrita 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 detrabajo, identifique uno o varios alias para los que el iniciador del flujo de trabajodebe escribir valores en el momento de iniciar el flujo.

a. Especifique si desea Crear un nuevo alias de ejecutante o Usar un alias deejecutante existente sin definir. Un alias existente y sin definir es el que apareceen el conjunto de alias aunque sin un nombre de usuario específico asignado enel conjunto.

b. Para crear un nuevo alias de ejecutante, escriba un nombre y una descripción yhaga clic en Agregar para incluirlo en la Lista de selección.

c. Para usar un alias de ejecutante existente, seleccione el alias adecuado en la listadesplegable Alias de ejecutante existente y haga clic en Agregar para incluirloen la Lista de selección. De forma opcional, puede modificar la descripcióndel alias de modo que el propósito del mismo quede claro para el iniciadordel flujo de trabajo.

d. Una vez que la Lista de selección incluya todos los alias deseados, haga clic enSiguiente o en Finalizar (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 apartir del conjunto de alias, seleccione los alias que el servidor resolverá entre losconjuntos de alias seleccionados.

a. Seleccione un conjunto de alias en la lista Conjunto de alias y, a continuación, unalias concreto 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 vezseleccionado el conjunto de alias que desea mover, puede utilizar los botones deflecha hacia arriba y hacia abajo para cambiar la posición de los alias en la lista.

7. Haga clic en Terminar.



Definir alias de ejecutante (los ejecutantes se asignarán cuando elflujo de trabajo esté en curso)

Si selecciona esta opción, deberá especificar qué conjunto de alias y alias usará el motorde proceso en tiempo de ejecución para determinar la persona real que realizará estaactividad. Primero elija un conjunto 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ágina30.

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 el flujo de trabajo esté en curso): el servidor hace referencia al conjuntode alias definido de forma predeterminada para este flujo de trabajo. El conjuntode alias predeterminado se define en el cuadro de diálogo Propiedades deplantilla. Si no se ha seleccionado ningún conjunto de alias, podrá establecerloen la próxima página.

• Conjunto de alias específico: el servidor hace referencia al conjunto de aliascuyo nombre se ha seleccionado en la lista desplegable adyacente. En esta listase muestran todos los conjuntos de alias del repositorio a los que esté conectadoactualmente y para los que tenga permiso de escritura.

• Conjunto de alias de documento en el paquete: el servidor hace referenciaal conjunto de alias asignado a un documento en un paquete que recibe estaactividad. En la lista desplegable, elija qué conjunto de alias del paquete definidose usará. Si selecciona <Cualquiera>, el servidor examinará los conjuntos dealias de todos los paquetes hasta que encuentre la primera coincidencia del aliasespecífico identificado en el paso 4.

• Conjunto de alias de ejecutante anterior: el servidor hace referencia al conjuntode alias asignado al ejecutante de la actividad anterior. Use esta opción, porejemplo, si esta actividad la debe realizar el administrador del ejecutante de laactividad anterior. Si, en tiempo de ejecución, el ejecutante anterior no tiene unconjunto de alias asociado, el servidor usará el conjunto de alias perteneciente algrupo del ejecutante anterior. Si el grupo tampoco tiene un alias, se enviará latarea de actividad fallida al supervisor del flujo de trabajo.

2. Haga clic en Siguiente.Si ha elegido la opción Conjunto de alias predeterminado pero aún no haseleccionado un conjunto de alias predeterminado para este flujo de trabajo, debeseleccionar un conjunto de alias.



Si ha seleccionado una de las otras opciones o ya ha definido el conjunto de aliaspredeterminado del flujo de trabajo, haga clic en Siguiente para pasar a una páginaen la que pueda elegir el alias concreto 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 alias existentes y seleccione un conjunto de alias en la lista desplegable. Enesta lista se muestran todos los conjuntos de alias del repositorio a los que estéconectado actualmente y para los que tenga permiso de escritura.

• Para elegir un nuevo conjunto de alias, haga clic en Crear nuevo conjunto dealias y escriba un nombre y una descripción para el mismo. El servidor crearáun alias con la información escrita 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 Aliasde ejecutante incluirá los alias definidos en dicho conjunto.Si ha elegido un conjunto de alias que se seleccionará en tiempo de ejecución, comoel conjunto de ejecutante anterior, la lista desplegable Alias de ejecutante estarávacía. Escriba el nombre del alias en el cuadro. Asegúrese de que el nombre coincidaexactamente con el nombre del conjunto de alias que encontrará el servidor. Si, entiempo de ejecución, el servidor no encuentra una coincidencia entre el alias deejecutante y los alias disponibles en el conjunto, la tarea de actividad se devolverá alsupervisor del flujo de trabajo junto con una notificación.


Select performer based on conditions (Seleccionar ejecutantesegún condiciones)

Puede determinar el ejecutante de una tarea dinámicamente, según la lógica condicionalque haya definido en la actividad. El ejecutante se determina en función de la lógica ylos datos de proceso definidos en la tabla de decisiones.

En el lado izquierdo de la expresión se definen las condiciones, según los datos de losatributos del proceso. En el lado derecho de la expresión puede especificar el nombre dela cola de trabajo y del usuario 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 hanconfigurado y asigna un 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 laló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úncondiciones.

3. Haga clic en Siguiente para abrir el cuadro de diálogo que se utilizará para definir laconsulta.

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 seaplique esta condició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 variable de proceso que haya seleccionado en la lista desplegable.6. Si está consultando sobre datos de proceso, utilice el cuadro de lista Datos de

proceso para seleccionar 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 deseautilizar en la condició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 desea usar en esta condición; para ello, seleccione una de las cuatro opcionesde la lista o escriba un valor de índice válido.

9. Elija un operador lógico de comparación en la lista desplegable Condición y escribaun valor de comparación en el cuadro de texto Valor.

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 ejecutantede una lista, escribir una consulta usando DQL (Documentum Query Language,Lenguaje de consulta de Documentum) o utilizar datos de proceso o parámetrosde 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 clicen Agregar para moverlo a la lista de selección.

• Si elige Escriba una consulta DQL, escriba la consulta en el cuadro de texto yhaga clic en Validar consulta para asegurarse de que la consulta es válida.

• Si elige Seleccionar de datos de proceso, puede seleccionar datos de proceso oun parámetro de proceso para asignar un ejecutante. Seleccionar ejecutantebasado en los datos de proceso y parámetros de proceso, página 137 proporcionainformación detallada sobre cómo utilizar datos de proceso para asignar unejecutante.

Puede considerar que necesita agregar atributos o elementos a algunos datospara completar la selección del ejecutante.

— Introducción a la herramienta de asignación de datos, página 163proporciona procedimientos para utilizar la herramienta de asignación dedatos.

— Usar atributos de repetición, página 174 proporciona detalles sobre cómoagregar y asignar los atributos con valor de repetición.

— Asignar atributos de paquete, página 166 proporciona instruccionespara exponer otros atributos de origen de un paquete que no aparecenactualmente en el árbol

Nota: La opción para seleccionar el ejecutante mediante datos de proceso sólo esválida para los siguientes tipos de ejecutantes: usuario específico, cola de trabajo,un solo usuario de un grupo y varios usuarios secuenciales.


13. Para agregar otra cláusula a esta condición, haga clic en los botones AND u OR yrepita los pasos anteriores.Si una condición incluye varias cláusulas, el servidor utilizará las reglas naturalesde prioridad para evaluar la expresión. Es decir, las cláusulas conectadas medianteAND se evaluarán antes que las cláusulas conectadas mediante OR. Por ejemplo,imagine que la condición tiene el formato que se muestra a continuación, donde lasletras representan cláusulas condicionales:IFAANDBANDCORDANDEORFSELECT Nombre de ejecutanteEl servidor evalúa esta condición de la siguiente forma:IF (AANDBANDC) OR (DANDE )ORFSELECT Nombre de ejecutante

14. Una vez que todas las condiciones específicas se hayan definido, seleccione elejecutante al que se asignará la tarea si no se cumple ninguna condición.Cuando haya definido todas las condiciones, resalte la fila en la tabla Consultaque comience con la palabra ELSE y elija el ejecutante que se debe utilizar si no secumple ninguna de las demás condiciones.



Seleccionar ejecutante basado en los datos de proceso yparámetros de proceso

Puede resolver dinámicamente el ejecutante de una actividad según los datos de procesoo parámetros de proceso encontrados en la actividad. El ejecutante puede ser el nombrede un usuario, grupo o cola de trabajos. En general, sólo se pueden utilizar los atributosde cadena para seleccionar un ejecutante.

Para asignar un ejecutante según los datos de proceso

1. Seleccione un tipo de ejecutante que cumpla los criterios para asignar el ejecutantesegú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

2. En el cuadro de grupo Seleccionar ejecutantes, elija Seleccionar ejecutante segúndatos de 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 deproceso o parámetro de proceso utilizados para asignar el ejecutante a la tarea.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar la selección del ejecutante.• Introducción a la herramienta de asignación de datos, página 163 proporciona

procedimientos para utilizar la herramienta de asignación de datos.• Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar

y asignar los atributos con valor de repetición.• Asignar atributos de paquete, página 166 proporciona instrucciones para exponer

otros atributos de origen de un paquete que no aparecen actualmente en el árbol

Nota: Sólo se puede seleccionar un atributo en el árbol de datos de proceso.

5. Haga clic en Terminar.El atributo aparece en el cuadro de texto Expresión. Un signo de dólar $ rodea a losmarcadores de posición (por ejemplo, Cola de trabajo: $Var0.name$).



Asignar datos de proceso a un nivel de habilidad decola de trabajo

Cuando crea una actividad que realiza una determinada cola de trabajos, selecciona elnombre de la cola y configura las habilidades necesarias para la actividad en la fichaEjecutante de Inspector de actividades. Puede utilizar el asignador de datos de procesopara relacionar los datos de proceso de paquetes o variables con las habilidades definidasen la cola de trabajo. Al asignar datos de proceso a una habilidad, el sistema utiliza estainformación para designar un procesador para la tarea en tiempo de ejecución.

La asignación de datos de proceso a niveles de habilidad de una cola de trabajo es unpaso opcional. Si no se asigna la habilidad, la tarea no la considerará necesaria y no seutilizará en la designación del procesador.

Nota: Antes de definir las habilidades de una actividad concreta, debe definir la cola detrabajo junto con los niveles de habilidad asociados a la cola. Además, el servidor JavaMethod Server se debe estar ejecutando para que el sistema utilice estas asignacionespara asignar un procesador en tiempo 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 lalista 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 listade datos de proceso en la columna izquierda y la cola de trabajo con sus habilidadesrelacionadas en la columna derecha.

8. Utilice la herramienta de asignación de datos para asociar atributos de los datos depaquete a los niveles de habilidad predefinidos en la cola de trabajo.Consulte Introducción a la herramienta de asignación de datos, página 163 paraobtener información detallada sobre 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áticos

El ejecutante de las actividades automáticas debe ser un único usuario. Este requisitolimita las opciones disponibles para las actividades automáticas a las siguientescategorí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 determinadoSi no se selecciona a un usuario determinado, el servidor determina el usuario realen tiempo de ejecución.

Para elegir al usuario cuyo acceso de seguridad se usa para una actividadautomá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 del flujo de trabajo, que de forma predeterminada son los permisosdel usuario que lo inicia.

• Propietario del repositorio: la actividad automática usará los permisos delpropietario del repositorio.

• Ejecutante de la actividad anterior: la actividad automática usará los permisosdel usuario que ha realizado la actividad anterior en el flujo de trabajo.

• Usuario específico: la actividad automática usará los permisos del usuario quese elija en 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 losusuarios>. Los usuarios del grupo seleccionado aparecen en el cuadro de listaUsuarios del grupo.

c. Seleccione el usuario en el cuadro de lista Usuarios del grupo. El nombre delusuario 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.




El nombre del usuario seleccionado aparece en el cuadro de texto situado junto albotón Seleccionar ejecutante.

Definir desencadenadores de actividades

Un desencadenador es una señal que indica que la actividad puede empezar. Use laficha Desencadenador para describir las condiciones que desencadenan la actividad yenviar el paquete a la bandeja de entrada del ejecutante.

Si la actividad presenta varios flujos entrantes, puede especificar el número de lasactividades anteriores que se deben haber completado antes de que se inicie la actividad.La condición de desencadenamiento es la cantidad mínima de flujos de entrada quedeben haber aceptado paquetes para que comience esta actividad. Por ejemplo, si unaactividad tiene tres flujos de entrada, puede decidir que se inicie la actividad cuandodos de los tres hayan aceptado paquetes.

Sugerencia: Cuando una actividad tiene más de un flujo entrante, representa unaactividad de unión en el proceso comercial total. Es decir, los paquetes de rutas de accesodiferentes van juntos en el proceso. Para mostrar la acción de unión con claridad en laplantilla de proceso comercial, inserte una plantilla de actividad Unir explícita en elflujo. La actividad Unir define las condiciones de desencadenamiento para la actividadsiguiente, la cual sólo tiene un flujo entrante: el de la actividad Unir. Consulte Unir,página 206.

Si necesita más información sobre los desencadenadores de actividad, consulte Definircondiciones de desencadenamiento, página 41.

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 completadoantes de que se inicie esta actividad.• Para iniciar esta actividad sólo cuando todas las actividades inmediatamente

anteriores hayan finalizado, seleccione Todos los flujos de entrada estánseleccionados.

• Para iniciar esta actividad cuando un número de actividades anteriores se hayacompletado, seleccione Se ha seleccionado este número de flujos de entradae introduzca la cantidad de actividades precedentes que deben finalizar antesde que se ejecute esta actividad. La cantidad total de flujos de entrada para estaactividad se muestra junto al cuadro de texto.

Cuando una actividad solo tiene un flujo de entrada, estas opciones no son diferentes.



3. Para asegurarse de que una acción específica ocurre antes de que la actividadseleccionada se ejecute, marque la casilla de verificación Y cuando llegue este eventoy escriba un nombre de evento en el cuadro de texto adyacente.Puede tratarse de un evento definido por el sistema, como dm_checkin, o se puedeinventar un nombre de evento, como "promovido" o "presentado". Si incluye unevento de desencadenamiento en la condición de inicio, el servidor debe encontrarel evento identificado en la cola del flujo de trabajo para que se inicie la actividad.Consulte Documentum Content Server Fundamentals (Fundamentos de DocumentumContent Server) para obtener más información sobre cómo definir y poner eventosen cola usando la API de Documentum.

4. Para permitir que la actividad pueda ejecutarse más de una vez en el mismo flujo detrabajo, marque la casilla de verificación Esta actividad se puede ejecutar más deuna vez en un flujo de trabajo.Una actividad de repetición es una actividad que se puede usar más de una vez enun flujo de trabajo concreto. De forma predeterminada, las actividades se definencomo de repetición. Las actividades con varios ejecutantes que se realizan de formasecuencial no pueden ser de repetición. Elegir ejecutantes, página 26 describe lascategorías de usuario para los ejecutantes.Si usa una actividad varias veces en un flujo de trabajo, debe estructurarlo de modoque solo una instancia de la actividad esté activa a la vez. El servidor no puedeiniciar una actividad si la actividad anterior, basada en la misma definición, aúnestá en ejecución.

5. 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.

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 de un período de tiempo especificado tras el inicio del flujode trabajo.

La actividad se considera desencadenada una vez que la crea el flujo de trabajo,aunque el usuario no la haya adquirido. Los pre-temporizadores no se activanen la primera actividad de un flujo de trabajo, ya que se desencadenan de formaautomática al iniciarse los flujos de trabajo.



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

Si precisa más información sobre temporizadores de flujo de trabajo, consulte Definirtemporizadores, página 42.

Si una actividad tiene definida una o más acciones de temporizador, aparecerá unpequeño icono de reloj en la esquina inferior derecha del icono de la actividad en elpanel 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 calendarioen el cuadro de lista 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álculos del temporizador.• Seleccione Usar calendario de proceso para seguir utilizando el calendario

especificado para todo 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 actividaddentro de ese proceso, el sistema utiliza el calendario de la actividad para lostemporizadores de la actividad.

Seleccionar un calendario para el proceso, página 85 proporciona más informaciónsobre calendarios.

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

3. Haga clic en el botón + situado sobre el cuadro de lista para agregar un nuevotemporizador o resalte un temporizador existente en el cuadro de lista.

4. En la lista desplegable Evento, seleccione qué tipo de acción de temporizador deseacrear: Vencimiento de pre-temporizador o Vencimiento de post-temporizador.

5. Especifique cuándo debe vencer el temporizador escribiendo el número de horas yminutos transcurridos en los cuadros de texto Vence en.Si esta acción es el primer temporizador de un determinado tipo (pre-temporizadoro post-temporizador), el temporizador vence cuando haya transcurrido el númeroespecificado de horas y minutos desde el inicio del flujo de trabajo o actividad,respectivamente. Los temporizadores posteriores vencen cuando haya transcurridoel número especificado de horas y minutos desde que venció el temporizador anterior.



Nota: Cuando se detiene una tarea de flujo de trabajo, no se detiene elpost-temporizador asociado. El post-temporizador continúa teniendo en cuenta eltiempo designado para la tarea como si la tarea estuviera en curso.

6. Para enviar un mensaje de correo electrónico a un programa de correo electrónico deotro fabricante cuando un temporizador caduca (en lugar de utilizar la bandeja deentrada de Webtop o TaskSpace), active la casilla de verificación Usar plantilla decorreo electrónico y, a continuación, haga clic en el botón Seleccionar.


b. Después de seleccionar una plantilla de correo electrónico existente o de crearuna plantilla nueva, el nombre de la plantilla de correo electrónico aparecerá enel campo Usar plantilla de correo electrónico.

El servidor utiliza la plantilla de correo electrónico seleccionada para todas lasnotificaciones del mismo tipo de evento (pre-temporizador o post-temporizador).Si no activa la casilla Usar plantilla de correo electrónico, el servidor enviará unanotificación predeterminada a la bandeja de entrada de Documentum de los usuarios.

7. Para enviar un mensaje de correo electrónico a un programa de correo electrónicode otro fabricante cuando un temporizador caduca (en lugar de utilizar la bandejade entrada de Webtop o TaskSpace), active la casilla de verificación Usar plantillade correo electrónico; a continuación, haga clic en el botón Seleccionar y elija laplantilla de correo electrónico personalizada que desea utilizar en la notificación.

a. Para abrir una plantilla existente, desplácese a la plantilla que se encuentra en laestructura de archivos y selecciónela.

b. Para Crear una nueva plantilla de correo electrónico, seleccione la opción yhaga clic en Aceptar.

c. Aparece el Asistente para plantilla de notificación, permitiéndole creardinámicamente una nueva plantilla de correo electrónico. Utilizar el Asistentepara plantilla de notificación, página 155 proporciona las instrucciones sobrecómo utilizar el asistente con objeto de crear una plantilla de correo electrónico.

8. Si desea que el servidor siga repitiendo la acción pre-temporizador opost-temporizador final hasta completar la actividad, marque la casilla Repetirla última acción.El valor de la opción Repetir la última acción se define con independencia delas acciones de pre-temporizador y post-temporizador. Cuando se selecciona, elservidor realizará la última acción de temporizador en el intervalo de tiempoespecificado hasta completar la actividad.



9. En la lista desplegable Acción, seleccione el tipo de acción que se pondrá enfuncionamiento cuando 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 los mensajes de Enviar una notificación, página 144 a una

o más personas.• Iniciar proceso: permite a Iniciar un proceso, página 146 utilizar los paquetes

de la actividad actual.• Ejecutar en método JAVA: activa Ejecutar un método Java, página 146 (sólo

disponible para usuarios con privilegios de superusuario).• Delegar tarea: permite Delegar tareas, página 147 a otro ejecutante (sólo

disponible para post-temporizadores de actividades manuales). También sepuede delegar una tarea a un ejecutante en función de los datos de proceso.

• Completar tarea: permite Completar tareas, página 148 y reenviarla a la siguienteactividad del flujo de trabajo (sólo disponible para post-temporizadoresmanuales).

10. Repita los pasos 2 a 7 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 detemporizador y haga clic en los botones de flecha hacia arriba o flecha hacia abajoen la parte superior del cuadro de lista.El orden es importante porque la hora de caducidad de un temporizador se expresacomo un determinado intervalo después de que haya vencido el temporizadoranterior.


Enviar una notificación

Utilice esta opción para enviar una notificación por correo electrónico a una personacuando el temporizador caduca.

Para enviar una notificación:

1. Haga clic en el botón Seleccionar que aparece junto al cuadro de texto Enviarnotificación a para identificar a los usuarios que se desean notificar cuando eltemporizador caduca.Puede enviar notificaciones basándose en grupos y usuarios, un alias o datos deproceso.

2. Para enviar la notificación a Grupos y usuarios, active el botón de opción.



a. Resalte el nombre de usuario o de grupo en la mitad izquierda del cuadro dediálogo.El cuadro Usuarios del grupomuestra los miembros del grupo seleccionado enel 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 elbotó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 dealias. Al seleccionar cualquiera de estos alias, el sistema muestra el nombredel conjunto de alias que tiene asignado así como la descripción del alias delejecutante.

b. Haga clic en Agregar >> para desplazar la selección al cuadro de lista de laderecha.


4. Para enviar una notificación basada en datos de proceso, haga clic en el botón deopción.El sistema muestra el árbol de datos de proceso.

a. Expanda los nodos del árbol de datos de proceso y seleccione los atributos quedesea seleccionar para la notificación.Puede considerar que necesita agregar atributos o elementos a algunos datospara completar la selección del ejecutante.• Introducción a la herramienta de asignación de datos, página 163

proporciona procedimientos para utilizar la herramienta de asignación dedatos.

• Usar atributos de repetición, página 174 proporciona detalles sobre cómoagregar y asignar los atributos con valor de repetición.

• Asignar atributos de paquete, página 166 proporciona instruccionespara exponer otros atributos de origen de un paquete que no aparecenactualmente en el árbol





Iniciar un proceso

Utilice 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 Iniciarproceso.

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 quela actividad actual.

3. Seleccione los usuarios que se van a notificar.Enviar una notificación, página 144 proporciona información detallada sobre cómoseleccionar usuarios para las notificaciones.


Ejecutar un método Java

Utilice esta opción para ejecutar un método Java cuando el temporizador caduca.

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 vencidoy haga clic en Aceptar.

Nota: Para que un método personalizado esté disponible aquí, el atributoa_special_app debe estar definido. El atributo a_special_app es un atributodm_sysobject cuyo uso está reservado para los productos de Documentum. Esteatributo debe tener el valor de flujo de trabajo. Consulte la guía Documentum ProcessBuilder Development Guide para obtener detalles sobre el desarrollo de métodos deflujos de trabajo personalizados.

3. Active la casilla de verificación Sí, guardar los resultados de la ejecución paraguardar un registro de ejecución cuando se ejecute el método.




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 losejecutantes.Aparece el cuadro de diálogo Seleccionar ejecutante. Puede asignar ejecutantesbasándose en grupos y usuarios, un alias o datos de proceso.

2. Para elegir un ejecutante por Grupos y usuarios, active el botón de opción.

a. Resalte el nombre de usuario o de grupo en la mitad izquierda del cuadro dediálogo.El cuadro Usuarios del grupomuestra los miembros del grupo seleccionado enel 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ónde opción.

a. Seleccione el conjunto de alias en la mitad izquierda del cuadro de diálogo.El cuadro de diálogo Alias de ejecutantemuestra los alias asociados al conjuntode alias. Al seleccionar cualquiera de estos alias, el sistema muestra el nombredel conjunto de alias que tiene asignado así como la descripción del alias delejecutante.



4. Para seleccionar un ejecutante basándose en datos de proceso, haga clic en el botónde 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 delejecutante.Puede considerar que necesita agregar atributos o elementos a algunos datospara completar la selección del ejecutante.• Introducción a la herramienta de asignación de datos, página 163

proporciona procedimientos para utilizar la herramienta de asignación dedatos.



• Usar atributos de repetición, página 174 proporciona detalles sobre cómoagregar y asignar los atributos con valor de repetición.

• Asignar atributos de paquete, página 166 proporciona instruccionespara exponer otros atributos de origen de un paquete que no aparecenactualmente 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 unvalor concreto para que una condición de transición de actividad pueda distribuirlo dedistinta forma en función del 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 casilla Change process data attributes (Cambiar atributos de datos deproceso). Si no marca esta casilla, diríjase al paso 3.

2. En la lista desplegable Datos de procesos, seleccione la variable de proceso o elpaquete para cuyo atributo el temporizador definirá un valor.

3. En la lista desplegable Atributo, seleccione el atributo cuyo valor debe definirel temporizador.

4. Si el atributo seleccionado puede tener más de un valor, indique qué valores deíndice desea usar en esta condición; para ello, seleccione una de las cuatro opcionesdel cuadro de lista Índice o escriba un valor de índice válido.

5. En el cuadro de texto Valor, introduzca el valor con el que el temporizador debedefinir el atributo seleccionado.




Definir las reglas de transición de actividad

Las reglas de transición determinan cuáles son las actividades siguientes en el flujo detrabajo. El flujo se cambia basado en la lógica de la transición que se define utilizando losdatos de proceso. Si una actividad presenta varios flujos salientes, tal vez desee que seenvíen paquetes a todas las actividades siguientes o solo a determinadas actividades, enfunción del resultado de la actividad. Por ejemplo, podría ofrecer a un ejecutante querevisara el diseño de un nuevo formulario la opción de reenviar el diseño al siguienterevisor o devolverlo al diseñador para que lo corrija. Esta lógica de ramificaciones seconfigura creando flujos desde la actividad a las dos posibles actividades siguientes ypermitiendo al ejecutante elegir la ruta que desea seguir.

Sugerencia: Si una actividad tiene varios flujos salientes con lógica de ramificaciones,representa un punto de decisión en el proceso comercial global. Para mostrar el puntode decisión con claridad en la plantilla de proceso comercial, inserte una plantilla deactividad División de la decisión explícita en el flujo. En lugar de definir una lógicade ramificaciones en la actividad actual, conecte ésta con una actividad Decision Split(División de la decisión) y defina la lógica de ramificaciones en ella. Consulte DecisionSplit (División de la decisión), página 206.

Si una actividad únicamente cuenta con un flujo de salida, no hay necesidad de definiruna condición de transición. La ficha Transición se mostrará como no disponible conla opción Seleccionar todas las actividades conectadas seleccionada. En el caso lasactividades automáticas, normalmente no se debe seleccionar la opción Let the activity’sperformer choose (Permitir que el ejecutante de la actividad elija) a menos que el métodode flujo de trabajo automático de la actividad utilice el método setoutput para elegirlas siguientes actividades. Documentum Process Builder Development Guide proporcionainformación detallada sobre este tema.

Definir transiciones de actividad, página 44 proporciona información detallada sobretransiciones.

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 alas que enviar paquetes:• Para enviar tareas a todas las actividades siguientes conectadas a ésta (incluyendo

los flujos de rechazo), elija Seleccionar todas las actividades conectadas.• Para dejar que el ejecutante decida qué actividad se seleccionará cuando la

actual haya terminado, elija Permitir al ejecutante seleccionar las siguientesactividades.



• Para distribuir paquetes entre distintas actividades siguiendo un conjuntode condiciones, elija Seleccionar las siguientes actividades según estascondiciones.

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 seleccionadaen la ficha Ejecutante es Todos los usuarios del grupo o Algunos usuarios de ungrupo, especifique cuántos ejecutantes deben completar la tarea:• Para hacer que sea necesario que todos los ejecutantes completen la tarea,

seleccione el botón de opció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 escribaen el cuadro de texto el número de ejecutantes necesarios. Si el número queescribe es mayor que el número de ejecutantes que reciben elementos de trabajopara esta actividad en tiempo de ejecución, el servidor completará la actividadcuando 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úmeromáximo de actividades que éste puede seleccionar mediante el cuadro de listadesplegable Seleccionar un máximo de [ ] actividades.En el cuadro de lista se muestra el número total predeterminado de actividadessiguientes disponibles. Puede seleccionar cualquier número entre 1 y este máximo.En tiempo de ejecución, el servidor no permitirá que el ejecutante seleccione unnúmero mayor de actividades que el especificado.

5. Si permite que un grupo de ejecutantes seleccione las siguientes actividades, es decir,si la categoría de ejecutante es Todos los usuarios del grupo o Algunos usuariosde un grupo y la opción de transición es Permitir al ejecutante seleccionar lassiguientes actividades, especifique cuándo se deben reenviar los paquetes a lassiguientes actividades seleccionadas.• Para iniciar inmediatamente las actividades de rechazo seleccionadas, seleccione

el botón de opción Cualquier ejecutante rechaza. Si cualquier ejecutanteselecciona las actividades de rechazo, las actividades se inician sin esperar porotras respuestas. Se omiten las selecciones de los demás ejecutantes.

• Para iniciar inmediatamente las actividades de reenvío seleccionadas, seleccioneel botón de opción Cualquier ejecutante reenvía. Si cualquier ejecutanteselecciona las actividades de reenvío, las actividades se inician sin esperar porotras respuestas. Se omiten las selecciones de los demás ejecutantes.



• Para iniciar las actividades siguientes seleccionadas sólo cuando los ejecutantesidentificados en el paso 3 hayan completado la tarea, haga clic en el botón deopción Todos los ejecutantes completan la tarea. Con esta opción, el servidorcombina las selecciones de todos los ejecutantes. Si algunos usuarios seleccionanactividades de reenvío y otros seleccionan actividades de rechazo, el servidordetermina qué actividades iniciar basándose en el conjunto final de botonesde opción de esta ficha.

— Para iniciar todas las actividades seleccionadas por los ejecutantes, tanto lasde reenvío como las de rechazo, haga clic en Iniciar todas las actividadesseleccionadas.

— Para iniciar sólo las actividades de rechazo seleccionadas (en el caso de quelas haya), haga clic en Sólo iniciar actividades de rechazo. Las actividadesde reenvío sólo se inician si todos los ejecutantes seleccionan actividadesde reenvío.

— Para iniciar sólo las actividades de reenvío seleccionadas (en el caso de quelas haya), haga clic en Sólo iniciar actividades de reenvío. Las actividadesde rechazo sólo se inician si todos los ejecutantes seleccionan actividadesde rechazo.

6. Especifique las condiciones que el servidor usa para determinar qué actividadesreciben paquetes.Consulte Crear condiciones de transición, página 151 si precisa más informaciónsobre la creación de condiciones de transición.



actividades.

Crear condiciones de transición

Si elige la opción Seleccionar las siguientes actividades según estas condiciones,aparece una tabla en la que se muestran las condiciones de transición definidas. Estatabla estará en blanco la primera vez que defina una actividad. Siga este procedimientopara agregar condiciones de transición de modo que se elijan automáticamente lassiguientes actividades en el flujo de trabajo. Si necesita más información sobre lascondiciones de transición, consulte Definir transiciones de actividad, página 44.

Nota: Si una actividad utiliza condiciones de transición, los flujos que llevan a lassiguientes actividades tienen un diamante en el comienzo de la línea de flujo. Esteformato sigue la norma Business 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.

2. En la lista desplegable Consulta sobre, seleccione el objeto al que desea que seaplique esta condición:• El flujo de trabajo en ejecución: la condición verificará los atributos del objeto

dm_workflow.• El último elemento de trabajo completado de la actividad: la condición

verificará los atributos del objeto dmi_workitem.• Datos de procesos: la condición verificará los atributos del paquete de proceso o

de la variable de proceso que haya seleccionado en la lista desplegable.3. Si está consultando en Datos de proceso, utilice el cuadro de lista para seleccionar

un paquete o una variable de proceso asociada al proceso.

4. Si el paquete de entrada seleccionado es un documento XML y desea que estacondición compruebe un valor de un elemento XML interno, marque la casilla deverificación Expresión XPath e indique el elemento XML cuyo valor desea utilizar enla condición.

a. En el cuadro de texto Esquema, escriba el nombre descriptivo del esquemaXML con el que cumple el documento del paquete. Puede escribir el nombre enel cuadro de texto, hacer clic en Local para elegir el esquema en el sistema dearchivos local o hacer clic en Repositorio para elegir el esquema en el repositoriode Documentum.Este paso es opcional. Si el esquema no está disponible, deje en blanco el cuadrode texto.

b. En el cuadro de texto Expresión XPath, cree la expresión XPath del elemento quedesee usar en la condición. Si ha seleccionado un esquema en el paso a, puedehacer clic en el botón Seleccionar para elegir de entre una lista de expresionesXPath válidas. Si no ha seleccionado ningún esquema en el paso a, haga clic en elenlace Escribir expresión y escriba la expresión XPath completa en el cuadro dediálogo que aparecerá. Después de escribir la expresión, seleccione el tipo dedatos XML del elemento identificado y haga clic en Aceptar.

5. Si no ha marcado la casilla Expresión XPath, elija el atributo del repositorio deDocumentum cuyo 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 datosestructurados aparecen en el cuadro para la selección.Si aparece una lista desplegable con el título Repitiendo atributo, elija o introduzcaun índice, el atributo seleccionado puede tener más de un valor. Indique qué valoresde índice desea usar en esta condición seleccionando una de las cuatro opciones dela lista o escribiendo un valor de índice. Si la condición de transición incluye una



referencia a un atributo de repetición, dicho atributo debe tener, al menos, un valor.De lo contrario, la condición generará un error en su evaluación.

6. 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 escribaun valor de comparación en el cuadro de texto Valor. El tipo de dato del atributoseleccionado se muestra debajo del cuadro.

7. Seleccione las actividades que se deben ejecutar a continuación cuando se cumplaesta condición; para ello, resalte los nombres de las actividades en el cuadro de listasituado en la parte inferior de la página.La lista muestra los nombres de las actividades conectadas a ésta por medio deflujos. Para seleccionar más de una actividad, mantenga presionada la tecla Ctrl oMayús mientras hace clic en los nombres de las actividades.

Nota: Debe seleccionar una actividad en este momento aunque tenga previstoagregar más cláusulas a la condición.

8. Para agregar otra cláusula a esta condición de transición, haga clic en los botonesAND u OR situados junto a la etiqueta Agregar otra cláusula y repita los pasosdel 2 al 6.Si una condición incluye varias cláusulas, el servidor utilizará las reglas naturalesde prioridad para evaluar la expresión. Es decir, las cláusulas conectadas medianteAND se evaluarán antes que las cláusulas conectadas mediante OR. Por ejemplo,imagine que la condición tiene el formato que se muestra a continuación, donde lasletras representan cláusulas condicionales:IFAANDBANDCORDANDEORFSELECT Actividad 1El servidor evalúa esta condición de la siguiente forma:IF (AANDBANDC) OR (DANDE)ORFSELECT Actividad 1

9. Para agregar otra condición de transición, haga clic en el botón + situado sobre elcuadro de la consulta (se agregará una fila nueva que empezará por ELSE IF) y, acontinuación, repita los pasos del 2 al 7.

10. Una vez que todas las condiciones de transición específicas se hayan definido,seleccione las actividades a las que se distribuyen los paquetes, si no se cumpleninguna condición.Cuando haya definido todas las condiciones de transición, resalte la fila en la tablaConsulta que comience con la palabra ELSE y seleccione las actividades que sedeben realizar si no se cumple ninguna de las demás condiciones.



Definir notificaciones

En la ficha Notificación puede establecer los mensajes enviados por el servidor enrespuesta a eventos relacionados con el flujo de trabajo, como cambios de estado dela actividad, un error de método durante un evento automático, etc. Los usuariosregistrados para recibir notificación del evento recibirán un mensaje elaborado conla plantilla de correo electrónico asociada a dicho evento. Configurar notificaciones,página 44 proporciona información detallada sobre este tema. También puede enviarlas notificaciones en respuesta a los temporizadores del flujo de trabajo. Establecertemporizadores de advertencia, página 141 proporciona información detallada sobreeste tema.

Nota: El servidor no envía una notificación Al inicio de un elemento de trabajo para lasactividades automáticas.

Para especificar los mensajes de correo que se utilizan para lasnotificaciones:

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 lasnotificaciones. El nombre de la plantilla de correo electrónico que se utiliza para lanotificación aparece bajo el nombre del evento.

2. Para utilizar una plantilla de correo electrónico personalizada en lugar del mensajede notificación predeterminado para un evento, marque la casilla de verificaciónCambiar plantilla de correo electrónico junto al nombre del evento.El botón Seleccionar se vuelve activo al marcar la casilla.


b. Después de seleccionar una plantilla de correo electrónico existente o de crearuna nueva, el nombre de la plantilla de correo electrónico aparece debajo delnombre del evento.

3. Si fuera necesario, repita el paso 2 para cada uno de los eventos para los que elsistema envía una notificación por correo electrónico.




Utilizar el Asistente para plantilla de notificación

Utilice 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 enla carpeta /System/Workflow/EmailTemplates. Las plantillas se pueden compartir entreprocesos, aunque no se recomienda ya que las plantillas están basadas en asignaciones yen datos de proceso específicos de un proceso.

Nota: Si se modifican las asignaciones en la plantilla de notificación, la plantilla cambiaen todo el sistema. Todas las actividades que utilizan dicha plantilla se actualizaráninmediatamente para reflejar los cambios realizados.

La lista de remitentes y destinatarios predeterminados de la notificación está basada enel tipo de evento. El sistema envía la notificación al destinatario predeterminado ademásde a cualquier destinatario especificado por las asignaciones. Si al campo De del correoelectrónico se le asigna a un valor, el valor asignado anula el remitente predeterminadoy el sistema utiliza sólo el valor del remitente asignado.

Tabla 6. Remitente y destinatario predeterminado basados en evento

Nombre de evento Descripción Remitentepredeterminado

Destinatariopredetermi-nado

dm_startedworkitem Se crea unanueva tarea

Usuario cuya acciónha desencadenadola generación dela nueva tarea,por ejemplo, elejecutante de laactividad anterior

Ejecutante dela tarea

dm_delegatedworkitem La tarea sedelega oreasigna

Usuario que hadelegado la tarea

Usuario dedestino

dm_changedactivityin-stancestate

La tareaautomática hafallado

Ejecutante de la tarea Supervisor delflujo de trabajo



Nombre de evento Descripción Remitentepredeterminado

Destinatariopredetermi-nado

El pre-temporizador havencido

El pre-temporizadorha vencido

Propietario de lainstalación delrepositorio

Los usuarioso grupos quese han selec-cionado pararecibir no-tificacionesen la lista depre-tempo-rizadores

El post-temporizador havencido.

El post-temporizadorha vencido.

Propietario de lainstalación delrepositorio

Usuarios ogrupos quese han selec-cionado pararecibir no-tificacionesen la lista depost-tempo-rizadores

Crear una plantilla de flujo de trabajo

1. Seleccione la opción para Crear una nueva plantilla de correo electrónico y hagaclic en Aceptar.

2. Escriba el nombre de la plantilla utilizando únicamente caracteres alfanuméricos.No se permiten los espacios, subrayados ni caracteres especiales.

3. Escriba el asunto de la notificación.Puede utilizar texto estático o marcadores de posición que se asignan a los datos deproceso para representar texto dinámico.• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo,

$orderno para un 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 se expresarían como \$500.00).

Nota: Los valores de los marcadores de posición deben ser caracteresalfanuméricos sin espacios. El marcador de posición comienza después del signode dólar $ y finaliza con el primer carácter no alfanumérico.



Por ejemplo, para enviar un mensaje que indique que un pedido se ha procesadocorrectamente, utilice el siguiente texto de plantilla: El pedido de compra $orderno seprocesó correctamente. El marcador de posición, numpedido aparece en la pantallade asignación de datos y puede asignarse a una variable de proceso o paquete. Lanotificación enviada tiene el siguiente asunto: El pedido de compra 0896523 se procesócorrectamente, donde 0896523 es el valor sustituido desde la asignación de datosde respuesta.

Nota: Todos los valores de marcador de posición deben asignarse a los datos deproceso.

4. Escriba el texto de la plantilla de correo electrónico en el cuadro de texto Plantillade cuerpo.Puede incluir texto estático, HTML copiado de un editor HTML de otro fabricante yparámetros de marcador de posición que se pueden asignar a los datos de proceso.Si está incluyendo formato HTML en el cuerpo del correo electrónico, debe asignarel valor texto/html constante al Contenido-Tipo del nodo Cuerpo del mensajede correo electrónico. Si Contenido-Tipo no está asignado a un valor, el tipo decontenido es texto/llano de forma predeterminada.• 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 \$ (por ejemplo, quinientos dólares se expresarían como \$500.00).

Nota: Los valores de los marcadores de posición deben ser caracteresalfanuméricos sin espacios. El token del marcador de posición comienza despuésdel signo de dólar $ y finaliza con el primer carácter no alfanumérico. Asimismo,todos los valores demarcador de posición deben asignarse a los datos de proceso.

5. Haga clic en Siguiente para crear la asignación del mensaje de entrada asociandolos datos de proceso al mensaje de correo electrónico.La estructura del mensaje de correo electrónico aparece en el panel derecho y losdatos de proceso en el lado izquierdo. Puede establecer los valores para los atributosde mensaje de correo electrónico asignándolos desde los atributos del modelo dedatos de proceso. Si tiene varios anexos del correo electrónico, puede hacer clic enAgregar en el nodo Anexo para agregar más anexos.

Nota: El sistema invoca la plantilla de correo electrónico una vez para cada usuariodefinido en el campo Notificación. Si un destinatario también está asignado en laplantilla de correo electrónico, se envía un correo electrónico a ese destinatario paracada usuario definido en la ficha Temporizador. Si hay tres usuarios seleccionadospara recibir notificación y un destinatario asignado al campo Para: de la plantilla, elsistema envía una notificación a cada uno de los tres usuarios y, además, envía trescopias de las notificaciones al usuario especificado en la asignación Para:.



Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar yasignar los atributos con valor de repetición.Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de 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 Cuerpodeben asignarse en este punto. No es necesario realizar asignaciones en los camposde destinatario.

6. Haga clic en Siguiente para asignar el mensaje saliente.Por ejemplo, si agregó una variable de procesoMsgId, puede asignar el atributo deId. de mensaje de notificación del mensaje de origen a esa variable de proceso.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar yasignar los atributos con valor de repetición.Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol

7. Haga clic en Aceptar.La plantilla se vuelve la plantilla predeterminada para la notificación específicapara la que la ha creado.

Cambiar datos de proceso en una actividad

Al configurar una actividad, deberá especificar los datos de proceso que se utilizarándurante la actividad y definir la forma en que la actividad tratará los paquetes, losparámetros de proceso o las variables de proceso que forman parte de la plantilla deproceso. Los datos de proceso se definen en la ficha Datos del componente Propiedadesde proceso. Gestionar los paquetes, página 76 proporciona más información sobre cómoagregar datos de proceso a la plantilla de proceso.

La ficha Datos del Inspector de actividad muestra una vista de árbol de los datos deproceso, organizados en categorías asociadas a los paquetes, parámetros de procesoo las variables de proceso utilizadas en el proceso. El cuadro de lista muestra la



información disponible sobre los datos de proceso, como el tipo, la versión y otrosatributos específicos de los datos de proceso.

Para obtener información sobre los paquetes individuales, parámetros de proceso ovariables de proceso, resalte el nodo específico para Paquetes, Parámetros de procesoo Variables de proceso. En el caso de los paquetes, los campos nombre, tipo y versiónson de sólo lectura y únicamente se pueden modificar en la página Process Properties(Propiedades de la plantilla de proceso). La información de las variables de proceso y delos parámetros de proceso se puede modificar en la vista de nodo.

Puede cambiar cómo la actividad controla los datos de proceso seleccionando odesactivando las casillas de verificación que están disponibles en la ficha Datos.

Para 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 se utilizará para mostrar este paquete al ejecutante de la actividad.De forma predeterminada, aparece la plantilla de formulario asignada al paqueteen el cuadro de diálogo Propiedades de proceso. Sólo se muestran en la listadesplegable las plantillas de formulario que utilicen el mismo modelo de datos quela plantilla de formulario predeterminada. Consulte Asociar plantillas de formulariocon paquetes, página 40 para obtener detalles sobre el uso de formularios en unflujo de trabajo.Si no se asigna ninguna plantilla de formulario al paquete, Task Manager utilizarálas opciones predeterminadas para mostrar el contenido del paquete, lo quenormalmente permite que el usuario lo abra en la aplicación asociada al tipo dedocumento, por ejemplo, Microsoft Word para documentos de Word.

4. Para que el formulario seleccionado en el paso 3 muestre las propiedades del paquete,marque la casilla de verificación Usar formulario para propiedades.Si la casilla de verificación Usar formulario para propiedades no está activada, elformulario del paso 3 aparece cuando el ejecutante de una actividad seleccionael paquete desde su bandeja de entrada. El formulario se utiliza para guardar elcontenido del paquete. Cuando la casilla de verificación está activada, el formularioaparece cuando el ejecutante ve las propiedades del paquete. El formulario se utilizapara establecer las propiedades del paquete en el repositorio, no el contenido delpaquete.

5. Para que este paquete esté disponible para el ejecutante de esta actividad, marque lacasilla de verificación Visible en esta actividad.



Si no activa la casilla de verificación Visible en esta actividad, el ejecutante dela actividad no verá el paquete. No obstante, éste seguirá disponible para lascondiciones de transición.

6. Para requerir que el paquete tenga un objeto de contenido asociado, marque la casillade verificación Éste es un paquete obligatorio.Si no marca esta casilla, el ejecutante de la actividad podrá asignar contenido alpaquete, pero no será obligatorio que lo haga.

7. Para permitir que Process Builder publique los datos de informes en la base dedatos de BAM del paquete, seleccione Este paquete se puede utilizar para generarinformes.

8. Repita los pasos 2 a 6 con cada paquete del proceso.



actividades.

Para iniciar automáticamente un paquete desde una actividad manual:

1. Resalte el nodo Paquetes.La visualización de página cambia para mostrar sólo los paquetes asociados al flujode proceso.

2. Haga clic en Inicio automático de paquete para que se muestre automáticamente unpaquete o formulario asociado cuando se inicie la actividad.Esta opción permite a este paquete mostrarse en seguida. De forma predeterminada,cuando un ejecutante inicia una actividad desde la bandeja de entrada, aparece TaskManager que muestra cada paquete como un enlace. El ejecutante hace clic en unenlace para mostrar el paquete (a través del formulario asignado al paquete o de laaplicación asociada al tipo de documento).

3. Seleccione el nombre del paquete que se va a iniciar desde la lista desplegable.

Para cambiar las variables de proceso existentes:

1. Resalte el nodo Variables de proceso.La visualización de página cambia para mostrar sólo las variables de procesoasociadas a la plantilla de proceso.

2. Para hacer que las variables estén disponibles para el ejecutante de esta actividad,active la casilla de 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.



3. Para exponer esta variable y utilizarla al generar informes, marque la casilla deverificación Esta variable se puede utilizar para generar informes.

Para editar los parámetros de proceso existentes:

1. Resalte el nodo Parámetros de proceso.La visualización de página cambia para mostrar sólo los parámetros de procesoasociados a la plantilla de proceso.

2. Para exponer esta variable y utilizarla al generar informes, marque la casilla deverificación Esta variable se puede utilizar para generar informes.

Cambiar la configuración de vista

Las opciones de la ficha Visualización controlan la forma en la que se mostrará laactividad en la plantilla de proceso.

Nota: Si una actividad tiene definida una o más acciones de temporizador, apareceráun pequeño icono de reloj en la esquina inferior derecha del icono de la actividad en elpanel del editor de plantillas de 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, seleccioneExaminar repositorio 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ágenesde actividad (que es la carpeta del repositorio System/Workflow/Images), ProcessBuilder guardará una copia de la misma en la carpeta una vez que haya guardado laactividad. Si utiliza Examinar local para elegir una imagen externa al directorio de laubicación estándar C:\Archivos de programa\Documentum\BPM\classes\images,Process Builder importará el archivo de imagen a la carpeta System/Workflow/Imagesdel repositorio.

4. Para cambiar el tamaño del gráfico que representa la actividad, seleccione unporcentaje en la lista 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 desactivela casilla de verificaciónMostrar 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 lavalidación de plantillas, harán referencia a las actividades por su nombre. Si asigna alas actividades el nombre del ejecutante, puede cambiar esta configuración de formatemporal a Nombre para poder encontrarla.

7. Defina la fuente y el estilo usados para designar la actividad en la plantilla.






actividades.


Capítulo 8

Asignar elementos de datos de proceso

En este capítulo se describe cómo utilizar la función de asignación de datos de Process Builder desdeuna plantilla de actividad y se incluyen los temas siguientes:

• Introducción a la herramienta de asignación de datos, página 163• Agregar o editar datos de proceso en el asignador, página 166• Asignar atributos de paquete, página 166• Agregar las propiedades del mensaje, página 167• Agregar un esquema XML al contenido de la actividad , página 168• Agregar un nodo basado en una condición, página 172• Asignar los datos, página 172• Introducción a la correlación de mensajes, página 180

Introducción a la herramienta de asignaciónde datos

La herramienta de asignación de datos proporciona una herramienta de asignaciónde datos gráficos que simplifica el proceso de pasar los datos del flujo de trabajo. Laherramienta le permite asignar los datos entre los datos de proceso, parámetros deproceso o atributos de flujo de trabajo del lado izquierdo de la ventana a los atributos deservidor o de flujo de trabajo del lado derecho de la ventana. Esto puede incluir orígenesde datos como argumentos de método de flujo de trabajo, parámetros de servicios 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 relacionarlos datos de proceso de paquetes o variables del flujo con las habilidades que definió enla cola de trabajo.



Muchas actividades automatizadas requieren la asignación de la información de unorigen de datos a otro. Por ejemplo, supongamos que un proceso de un origen depréstamo incluye una actividad que llama a un servicio Web para buscar la puntuaciónde crédito de un cliente. La actividad debe pasar el número de la seguridad socialdesde el paquete de la solicitud del préstamo al servicio Web y, a continuación, copiarla puntuación de crédito devuelta en otro atributo de paquete con el fin de que quededisponible para actividades posteriores. La herramienta de asignación gráfica permiteasignar datos desde los atributos de paquete a los parámetros de entrada del servicioWeb y desde el mensaje de salida del servicio Web a los atributos de paquete.



Figura 6. 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 controlde árbol contraíble.

• En la columna derecha se muestran los destinos de datos disponibles en un controlde árbol contraíble.



• La columna central es el área de asignación; contiene cuadros que representanfunciones de asignación de datos y líneas que conectan los cuadros con sus orígenesde entrada y destinos de salida.

El contenido de las columnas izquierda y derecha depende del tipo de actividad quese esté configurando. Para las actividades para las que se deben proporcionar valoresde entrada, en la columna izquierda generalmente se muestran los atributos para todoslos paquetes de los procesos comerciales, variables de proceso y las variables de laejecución en tiempo de ejecución, como por ejemplo el nombre del supervisor, que estándisponibles en tiempo de ejecución.

En la columna central se muestran las funciones que se utilizan para transferir datosdesde uno o varios orígenes de datos de la izquierda a un destino de datos de la derecha.La herramienta de asignación permite copiar los valores directamente desde un origende datos a otro, realizar conversiones de tipos de datos, concatenar cadenas, realizaroperaciones matemáticas con los números e incluir valores constantes. Consulte Usarlas funciones de asignación de datos, página 175 para obtener una lista de las funcionesdisponibles.

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. Entrelos tipos de datos expuestos en el árbol se incluyen los paquetes, las variables de proceso,los datos de ejecución y los parámetros de proceso.

Agregar o editar datos de proceso en elasignador

Puede agregar o editar elementos individuales del árbol de datos seleccionando el enlaceEditar e iniciando elDiálogo Editar datos de proceso. Mediante el editor de datos puedecrear, actualizar y eliminar elementos del árbol de datos del asignador, así como cambiarel modelo de proceso según sea necesario durante el diseño del proceso, sin tener quesalir del diseñador e iniciar el cuadro de diálogo Propiedades de proceso.

Cuando vea un icono de signo más de color verde en un nodo, paquete o atributo dedatos, significa que puede agregar o editar los datos asociados a esa ubicación en losdatos de proceso.

Asignar atributos de paquete

Para los paquetes de ambos lados del asignador, el árbol muestra sólo los atributosseleccionados de forma predeterminada. Se muestran todos los atributos personalizadospara el tipo de objeto del paquete y también una selección de los atributos estándar de



uso más frecuente. El nodo del paquete también muestra los tres atributos adicionalessiguientes, 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 paqueteAdemás, un paquete contendrá el atributo r_object_id. El atributo r_object_id

contiene el ID de objeto del paquete.

De forma predeterminada, sólo los atributos de paquete básicos aparecen en el asignador.Para finalizar una asignación, puede tener que exponer otros atributos de un paqueteque no aparecen actualmente en 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 seleccioneMostrar más atributos.Al seleccionar un paquete del asignador, aparece un cuadro de diálogo con la listacompleta de atributos 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 ordenalfabético. Los atributos recién agregados aparecen con la etiqueta <Nuevo>. Ahoraestán disponibles para la asignación.

Nota: Si no asigna los atributos agregados a una función, no volverán a aparecercuando guarde la actividad y vuelva a abrir el Inspector de actividad.

Agregar las propiedades del mensaje

Puede haber ocasiones en que necesite agregar una propiedad específica del servicio aun mensaje para finalizar una asignación. En este caso, puede agregar la propiedadal mensaje, pero debe asegurarse que se agrega al nodo correcto y que se denominacorrectamente. No hay ninguna validación para las propiedades 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 aabrir el Inspector de actividad.

Agregar un esquema XML al contenido de laactividad

Puede asociar un esquema XML a un anexo o al contenido del paquete o al contenidorecibido desde orígenes externos (como servicios HTTP o JMS) y utilizar el asignadorpara asignar los elementos del esquema. Antes de anexar el esquema a un nodo en elárbol del asignador de datos, modifique el esquema para cambiar todas las instruccionesde importación de esquema que contienen direcciones URL relativas para utilizardirecciones URL absolutas.

El nodo de datos se expande cuando el esquema XML se asocia a los datos de contenido.Si un paquete se asocia a un formulario que utiliza un esquema XML, el nodo de datosde contenido muestra automáticamente el esquema XML asociado al formulario.

Nota: Si el valor que está asignando está basado en una enumeración establecida, puedever la lista de valores disponibles haciendo clic con el botón secundario del ratón en elvalor y seleccionandoMostrar enumeración.

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 paramostrar el Cuadro 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 losformatos de 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 unformato determinado, si es necesario.



Incorporar formularios de Forms Builder aprocesos

Cuando se asocia un formulario de Forms Builder a un flujo de trabajo, los usuariospueden introducir información en el proceso mediante dicho formulario para, actoseguido, enviarlo a la dirección URL o de correo electrónico especificada. Estos datos sepueden incorporar, a continuación, al flujo de trabajo. Una vez enviado el formulario dedatos al flujo de trabajo, los elementos del esquema del formulario se pueden asignar avariables de proceso, a un paquete o a un anexo.

Rellenar formularios mediante archivos XML

El asignador de datos permite rellenar los campos de los formularios empleando unesquema XML entrante y asignando dichos elementos al esquema del formulario encuestió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 unaactividad, por ejemplo, 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 datosde la actividad.Agregar un esquema XML al contenido de la actividad , página 168 ofreceinstrucciones para agregar esquemas XML al asignador de datos.

3. Utilice las funciones de asignación del asignador para mover contenido del esquemadel archivo XML al esquema del formulario.

Crear formularios de alta fidelidad mediante datos deprocesos

Las plantillas de formulario de alta fidelidad generan formularios muy parecidos a sushomólogos de papel e incorporan funciones de OpenOffice.org.

Cuando se asocia una plantilla de este tipo a un proceso, cabe la posibilidad de asignardatos de proceso a los elementos de su esquema así como crear o generar un formulariode alta fidelidad a partir de ellos.



Usar una actividad HTTP entrante: inicio para crear una nuevainstancia de formulario de alta fidelidad

Puede usar una actividad entrante para crear una instancia de formulario de altafidelidad.

Para crear una instancia de formulario de alta fidelidad:

1. Configure la plantilla de actividad HTTP entrante: inicio con el sufijo de URL,seleccione Post para 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 fidelidadinstalado en el repositorio.Asegúrese de que el paquete no sea obligatorio en el proceso desactivando la casillade verificación Éste es un paquete obligatorio.

3. En el asignador de datos de la plantilla de actividad HTTP entrante: inicio, haga cliccon el botón secundario en el nodo Origen correspondiente al anexo y elija Agregarplantilla 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.Al expandir el nodo Datos, se ven los atributos del formulario de alta fidelidad.

7. Asigne los elementos del esquema oportunos del nodo Datos del anexo HTTP alnodo Paquete y guarde la plantilla de actividad.

8. Si desea enviar un correo electrónico con el formulario recién creado, agregue unaplantilla de actividad SMTP saliente al proceso y asigne el contenido del paquete alnodo de anexos de correo electrónico.

Usar una actividad Asignación de datos de procesos para crearuna instancia de formulario de alta fidelidad

Use una plantilla de actividad Asignación de datos de procesos para crear una instanciade formulario de alta fidelidad en el flujo de trabajo y, a continuación, use una plantillade actividad saliente como FTP saliente o SMTP saliente para enviar el formulariocomo anexo o 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 fidelidadinstalado en el repositorio.Asegúrese de que el paquete no sea obligatorio en el proceso desactivando la casillade verificación Éste es un paquete obligatorio.

2. Abra la plantilla de actividad Asignación de datos de procesos, haga clic con elbotón secundario en el nodo Origen correspondiente al paquete y elija Agregarplantilla de formulario.

3. Acceda a la ubicación de la plantilla de formulario y seleccione ésta.El tipo de objeto es dm_xfm_form.


5. Haga clic en Aceptar.Al expandir el nodo de datos del paquete, se ven los atributos del formulario dealta fidelidad.

6. Para crear el formulario de alta fidelidad en otra carpeta que no sea lapredeterminada, asigne r_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 unaplantilla de actividad SMTP saliente al proceso y asigne el contenido del paquete alnodo de anexos de correo electrónico.

Para crear una instancia de formulario de alta fidelidad como anexo:

1. Siga los pasos del procedimiento anterior para crear una instancia de formulariode alta fidelidad como paquete.

2. En la asignación Destino, haga clic con el botón secundario enNombrePlantillaFormulario que corresponde al nodo de anexos y asígnelo alnombre 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 unaplantilla de actividad SMTP saliente al proceso y asigne el contenido del anexo alnodo de anexos de correo electró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óndel formulario al proceso para su posterior uso en el flujo de trabajo. Por ejemplo, si



recibe el formulario de una plantilla de actividad Correo electrónico entrante cuyoanexo es un formulario de alta fidelidad, puede asignar los datos del proceso entrante avariables de procesos y agregar dicha información al proceso.

Agregar un nodo basado en una condición

Utilice el Generador de nodos condicionales para agregar un nodo al árbol de datos queutiliza una expresión generada utilizando los elementos secundarios del nodo. Estaopción está disponible para algunos nodos de repetición que tienen más de un atributo ypara el nodo Elemento de trabajo situado en 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 seleccioneMostrargenerador de condiciones.

2. Expanda el árbol de datos y seleccione el elemento en el que está creando laexpresión.

3. Seleccione el elemento, el operador y escriba el valor que se va a utilizar para crearla 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 textode la expresión no está visible en su integridad, haga clic con el botón secundariodel ratón en el nodo y abra el Generador de nodos condicionales para ver el textocompleto de la expresión.

Asignar los datos

La columna central contiene cuadros que representan las funciones de asignación dedatos y líneas que conectan los cuadros de funciones con los argumentos de entraday los destinos de salida. En tiempo de ejecución, la actividad pasa los valores de losargumentos de entrada y guarda el resultado como el valor del atributo de destino.

Puede crear una función de asignación cada vez. La herramienta de asignación de datosrequiere que se complete una asignación (mediante la selección de sus parámetros deentrada y destino de salida) antes de comenzar con la siguiente asignación. Siempre quese asignan datos de proceso, también se debe asignar el formato o el tipo de contenidocorrespondiente. Esto se valida para cualquier servicio.



Todas las funciones de asignación de datos operan en atributos de un solo valor y enatributos con valores de repetición. Cuando el argumento de entrada es un atributo convalor de repetición o una consulta con varias filas de resultados, la función de asignaciónde datos utiliza alguno de los valores de repetición o todos ellos. Cuando escribe suresultado en el atributo de destino, el nuevo resultado sobrescribe los valores existentes oagrega un valor de atributo nuevo. Consulte Usar atributos de repetición, página 174 siprecisa información detallada sobre la asignación de atributos con valores de repetición.

Para asignar datos:

1. Seleccione una función en el cuadro de lista sobre el área de asignación de lacolumna central.Consulte Usar las funciones de asignación de datos, página 175 para obtenerinformación sobre las funciones disponibles.Sobre el área de asignación, aparecerá un icono que representa la función. Una Xroja en la esquina inferior derecha indica que la función aún no tiene los argumentosrequeridos. Una vez haya proporcionado todos los argumentos requeridos (en lospasos 4 ó 5 que se describen a continuación), la X no aparecerá.El cuadro de lista de las funciones permanecerá como no disponible mientras lafunción actual no sea 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 Laposición no afecta al orden de ejecución.

3. En la columna de la izquierda, seleccione los atributos cuyos valores serán los datosde entrada de la función.Para seleccionar un atributo haga clic en su nombre. En el área de asignación,aparecerá una línea que conecta el atributo seleccionado con el cuadro de funcionesactual. Si el tipo de datos del atributo seleccionado no coincide con el tipo de datosque la función espera, la línea se mostrará discontinua. El sistema intentará convertirel valor al tipo de datos requerido en tiempo de ejecución. Al hacer clic en el nombrede un atributo por segunda vez, éste se deselecciona y se elimina la línea.Si la función actual acepta varios valores de entrada, podrá seleccionar variosatributos en la columna de la izquierda. De forma predeterminada, los atributosse agregan a la lista de la función de los argumentos de entrada en el ordenseleccionado. Consulte el paso 5 para obtener información sobre cómo modificar elorden de los argumentos.Si el atributo que desea ya está enlazado a otra función, podrá enlazarlo a la funciónactual si hace clic en el botón Modo de dibujo de líneas (a la derecha de la listade funciones en la parte superior de la columna central) y agrega una línea desdeel diamante de color negro del extremo izquierdo de la línea de selección anteriorhasta el cuadro que representa la función.



En algunos casos, es posible que desee definir una función que no utilice ningúnatributo como datos de entrada. Es decir, que todos los valores de entrada seanconstantes. En esos casos, omita este paso y escriba los valores constantes relevantesen el paso 5.

4. En la columna derecha, seleccione el atributo en el que la actividad escribirá elresultado de la aplicación de la función.Sólo podrá seleccionar un atributo en la columna derecha para cada función deasignació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 Editorde funciones, en el que se incluyen el nombre de la función, su sintaxis y una listade los valores de entrada. Los nombres de los atributos que seleccionó en el paso3 aparecen en formato XPath. Mediante este cuadro de diálogo, puede cambiar elorden de los atributos o agregar constantes como valores de entrada adicionales. EnUsar las funciones de asignación de datos, página 175 se proporciona informacióndetallada sobre este tema.Haga clic en Aceptar para cerrar el cuadro de diálogo.

6. Repita los pasos 1 a 5 para cada función de asignación de datos que desee crear.

Usar atributos de repetición

Las pantallas Asignación de mensaje de entrada y Asignación de mensaje de salida detodas las plantillas de actividad admiten atributos de varios valores.

Los atributos de varios valores tienen un enlace Agregar junto a su nombre. Utilice elenlace Agregar para crear un nodo que represente un índice específico de atributosde varios valores. Al hacer clic en Agregar, el sistema crea un nuevo nodo con unvalor de índice predeterminado. Para cambiar el valor de índice, haga doble clic enél y se abrirá el cuadro de diálogo Índice de repetición, en el que podrá seleccionarPRIMERO/ÚLTIMO o escribir un valor numérico.

Para copiar un atributo de un solo valor en un índice específico deatributos de varios valores:

1. En el árbol de destino, cree un nodo que represente el índice específico del atributode varios valores.

2. Seleccione el nodo del atributo de un solo valor en el árbol de origen. Para ello,haga clic en el nodo de un solo atributo.

3. Seleccione el nodo que representa el índice específico del atributo de varios valoresen el árbol de destino.



Para copiar el índice específico de un atributo de varios valores en unatributo de un solo valor:

1. En el árbol de origen, cree un nodo que represente el índice específico del atributode varios valores.

2. Seleccione el nodo que representa el índice específico del atributo de varios valoresen el árbol de origen.

3. Seleccione el nodo que representa el nodo de un solo atributo en el árbol de origen.

Para copiar todos los valores de un atributo de varios valores en un índiceespecífico de índices de varios valores:

1. En el árbol de destino, cree un nodo que represente el índice específico del atributode varios valores.

2. Seleccione el nodo que representa todos los valores (el valor de índice de este nodoserá TODOS) en el árbol de origen.

3. Seleccione el nodo que representa el nodo de un solo atributo en el árbol de origen.

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 valorpara Contexto de entrada y elija Sobrescribir, Insertar antes o Insertar despuéscomo el valor de Contexto de salida.Cuando se utilizan las opciones Insertar después o Insertar antes, los valores seinsertarán después o antes del índice. Cuando se utiliza la opción Sobrescribir, sesobrescriben los valores existentes.

Contexto de entrada

Dependiendo de la opción Contexto de entrada seleccionada para una regla deasignación, todos los valores de un atributo de varios valores se transfieren a la función deasignación como argumentos (opción TODOS), o bien la función de regla de asignaciónse ejecuta una vez para cada valor (PARA CADA UNO). La opción de Contexto deentrada se puede visualizar o actualizar desde el cuadro de diálogo de la función.

Usar las funciones de asignación de datos

En un cuadro de lista sobre el área de asignación, aparece una lista de las funcionesdisponibles. Cuando selecciona una función de la lista, en el área de asignación apareceun icono que la representa. Una vez ha enlazado la función a sus argumentos de entraday destino de salida (como se describe en la sección Asignar los datos, página 172), es



posible que deba utilizar el cuadro de diálogo Editor de funciones para completar ladefinición de la función. El Editor de funciones permite modificar el orden de losargumentos de entrada de una función, así como agregar argumentos de entradaconstantes cuyos valores no provienen de los datos de proceso.

Haga doble clic en el cuadro de funciones para mostrar el cuadro de diálogo Editor defunciones, en el que se incluyen el nombre de la función, su sintaxis y una lista de losvalores de entrada esperados. Los nombres de los atributos de entrada enlazados a lafunción aparecen en formato XPath. Si el valor que está asignando está basado en unaenumeración establecida, puede ver una lista que muestra los valores de enumeracionesdel nodo de destino de la función.

• Para cambiar el orden de los argumentos de entrada, resalte uno de los argumentos yhaga clic en el botón de flecha hacia arriba o hacia abajo para moverlo a la nuevaubicación en la lista.

• Para agregar una constante a la lista de argumentos de entrada, resalte el argumentoque precederá a la constante y haga clic en el botón +. Aparecerá una nueva líneabajo 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 medianteeste cuadro de diálogo; para ello, deberá volver a la pantalla de la asignación yseleccionarlo en la columna de la izquierda.

• Para eliminar una constante de la lista de argumentos de entrada, resáltela y hagaclic en el botón—.

Nota: No puede eliminar un atributo de paquete de la lista mediante este cuadrode diálogo; para ello, deberá volver a la pantalla de la asignación y borrarlo en lacolumna de la izquierda.

En la tabla siguiente se muestran las funciones disponibles.

Tabla 7. Funciones de la asignación de datos

Función Argumentos de entrada Resultado

Agregar Dos o más números. Suma de los argumentosde entrada.

Agregar día laboral Un valor de fecha entero,una cadena para elcalendario, y un enteropara noOfDays.

Agrega un día laboral alvalor de noOfDays. Elvalor de un día laboral estábasado en el calendariocomercial seleccionado.

Agregar días Un valor de fecha entero yun entero para noOfDays.

Devuelve una fechadespués de sumar elnúmero especificado dedías a la fecha.




De byte a cadena Dos cadenas, la primerarepresenta los datosbinarios y la segundaespecifica el valor decodificación como,por ejemplo, UTF-8,UNICODE, etc. Elvalor de codificaciónpredeterminado es UTF-8.

Datos como una cadena.

Concatenar Dos o más cadenas. Cadena concatenadacompuesta por losargumentos de entradaen orden.

Copiar Un argumento de cualquiertipo.

Argumento de entrada nomodificado.

Recuento Objecto param[]): Devuelve el número devalores en la entrada devarios valores. Para lasentradas de un único valor,el valor de devolución es 1.

Fecha a cadena Una fecha y una cadenaque representan unpatrón de fecha válido.El patrón de fecha debecumplir con el estándarJava SimpleDateFormat.Para obtener detalles,consulte la API de Javay la documentación dereferencia del desarrolladorsituada en el sitio web dedesarrollador de Sun.

Valor de fecha como unacadena con el patrónespecificado.

Dividir Dos o más números. Resultado de dividir elprimer argumento deentrada por el segundoargumento. Cuandoexisten más de dosargumentos, cada númeroposterior se utiliza paradividir el resultadoanterior.




Obtener Día Entero. Devuelve un entero querepresenta el segmento deldía de la fecha.

Obtener dirección decorreo electrónico

Cadena. Consulta dm_user paradevolver una dirección decorreo electrónico para unusuario.

Obtener Mes Entero. Devuelve un entero querepresenta el segmento delmes de la fecha.

Obtener valor Parámetro de cadena queespecifica el objeto y elnúmero de posición delíndice.

Devuelve un valor de unaposición especificada en elíndice.

Obtener Año Entero. Devuelve un entero querepresenta el segmento delaño de la fecha.

Unir Dos o más matrices decadenas.

Crea una combinación delas entradas seleccionadas.

Multiplicar Dos o más números. Producto de losargumentos de entrada.

Dividir Cadena que puede incluirun valor de posición deíndice opcional.

Devuelve una cadena derepetición o una posiciónen el valor de repeticiónsi se utiliza la posición deíndice opcional.

Cadena a byte Dos cadenas, la primerarepresenta los datos yla segunda especificael valor de codificacióncomo, por ejemplo,UTF-8, UNICODE, etc.El valor de codificaciónpredeterminado es UTF-8.

Datos binarios.




Cadena a fecha Dos cadenas, la primeraproporciona unafecha y la segundaespecifica su patrón.El patrón de fecha debecumplir con el estándarJava SimpleDateFormat.Para obtener detalles,consulte la API de Javay la documentación dereferencia del desarrolladorsituada en el sitio web dedesarrollador de Sun.

Valor del tipo de datos defecha.

Subcadena Una cadena, un númeroque representa cuántos delos caracteres iniciales seeliminarán de la cadena y,opcionalmente, un númeroque representa la posicióndel último carácter que seincluirá en la subcadena.

Cadena compuesta decaracteres del primerargumento de entrada, quecomienzan en la posiciónde inicio especificada yque finalizan en la posiciónfinal especificada.

Por ejemplo, si losargumentos de entrada son"infeliz" y 2, el resultadoes la cadena "feliz". Si losargumentos de entrada son"infeliz", 2 y 5, el resultadoes "fel".

Restar Dos o más números. Resultado de restar elsegundo número al primernúmero. Cuando existenmás de dos argumentos,cada número posterior seresta al resultado anterior.

ToLower Cadena. Convierte la cadena enletras minúsculas.

ToUpper Cadena. Convierte la cadena enletras mayúsculas.



Introducción a la correlación de mensajes

Process Builder debe poder hacer coincidir un mensaje entrante con una instanciaúnica de un flujo de trabajo para procesar los datos entrantes. Process Builder utilizaconjuntos de correlaciones e identificadores de correlación formados de datos únicos parahacer coincidir la respuesta con la solicitud original.

Por ejemplo, en una actividad de un proceso de compra, se envía un mensaje JMSal proveedor que solicita información sobre si se envió un elemento de un pedido decompra. El mensaje especifica tanto el número de ID del proveedor como el número depedido de compra del elemento. El sistema utiliza estos números para hacer coincidir elmensaje con la instancia de proceso. Posteriormente, el sistema del proveedor respondecon un mensaje de estado de envío para el pedido de compra, que incluye el númerodel 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 larespuesta y continuar el flujo de trabajo.

Usar los identificadores de correlación

Cuando se inicia una instancia de proceso, Process Engine crea un atributocorrelation_identifier único en dm_workflow para identificar el proceso. Cuando unaactividad intermedia entrante recibe este identificador en un mensaje, puede compararel mensaje con la instancia de proceso basándose en este valor sin tener que utilizar elconjunto de correlaciones.

Para utilizar esta propiedad del mensaje, el receptor del mismo debe tener elmismo identificador en su respuesta. En otras palabras, se debe haber enviadocorrelation_identifier en algún punto anterior del proceso para que el sistema puedarecibirlo en el mensaje entrante. Por ejemplo, cuando el mensaje se envía a un proveedorque solicita información sobre un pedido de compra, el identificador de la correlacióngenerado por sistema se envía en el mensaje saliente. Cuando el mensaje entrantetambién contiene el mismo identificador de correlación, el sistema lo utiliza para hacercoincidir el mensaje con la instancia de proceso.

Los campos que contienen los identificadores de correlación se configuran en cadaplantilla de actividad intermedia entrante en la página de configuración, donde se definela conexión, el protocolo y las instrucciones de procesamiento. Este identificador esespecífico del protocolo del mensaje. Para muchos mensajes entrantes, las propiedadesúnicas del mensaje, como por ejemplo los datos en el encabezado del mensaje o unnombre de archivo único, pueden contener el identificador de correlación para hacercoincidir el mensaje con una instancia de proceso. Si no hay ninguna coincidencia entreestos valores, el sistema utilizará el conjunto de correlaciones especificado para hacercoincidir el mensaje con una instancia de proceso.



Tabla 8. Campos utilizados para configurar el ID de correlación

Plantilla de actividad Nombre delcampo

Ejemplo

JMS entrante: procedimiento N/A Utilice en encabezado de JMSCorrelationId

HTTP entrante: procedimiento Propiedad decorrelación

MessageID

Correo electrónico entrante:procedimiento

Encabezado decorrelación

Asunto

FTP entrante: procedimiento Patrón decorrelación

po_$id$.txt

Servicio Web entrante:procedimiento

N/A Utilice el MessageID delencabezado WS-Addressing

Utilizar conjuntos de correlaciones

Si no se ha configurado un ID de correlación para una actividad o si el ID de correlaciónfalta en un mensaje entrante, el sistema busca una asociación de conjunto de correlaciónpara hacer coincidir el mensaje con un flujo de trabajo. Un conjunto de correlación esuna colección de variables de proceso que se define para una actividad. En la mayoríade los procesos comerciales, hay atributos únicos de datos de proceso que puedenidentificarse y utilizarse para hacer coincidir los datos entrantes con una instancia deproceso. Estas asignaciones se crean utilizando la herramienta de asignación de datosdentro de la plantilla de actividad, donde puede hacer coincidir los datos del mensajeentrante con los datos del proceso existente.

Los conjuntos de correlaciones se definen en el nivel de proceso en la ficha Avanzadadel componente Propiedades de proceso. En la lista de variables de proceso que estánasociadas con el flujo de trabajo, puede asignar un nombre al conjunto de correlacióny 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 coincidirlos mensajes con una instancia de proceso. Si el pedido de compra y el nombre se pasaa 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 los desolicitud. 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 decompra. En la herramienta de asignación de datos, enlace los atributos para el número yla dirección del pedido de compra desde los atributos del mensaje entrante.



Un conjunto de correlación puede tener más de un identificador de correlación yun proceso puede utilizar varios conjuntos de correlaciones, si es necesario. Puedeseleccionar sólo un conjunto de correlación para asignación dentro de una actividad.Por ejemplo en un flujo de proceso que gestiona los pedidos a los proveedores, puedecrear el Conjunto de correlación 1 (número de pedido e ID del proveedor) y el Conjuntode correlación 2 (dirección y código postal) y utilizarlos al asignar mensajes en lasactividades de entrada.

Los datos que un conjunto de correlación utiliza deben existir en el proceso o estardefinidos en él antes de que el flujo de trabajo alcance la actividad que utiliza el conjuntode correlación. Los datos se pueden definir en la actividad utilizando una actividad deinicio u otra actividad intermedia anteriormente en el proceso.

Nota: La variables de procesos que se usarán en conjuntos de correlaciones nodeben tener valores predeterminados. Las variables de proceso que tienen valorespredeterminados no poseen las características de atributo exclusivas requeridas paraque coincida un mensaje entrante con una instancia única de un proceso. Si el sistemano encuentra una coincidencia única, el proceso de tiempo de ejecución se cancela conun error.

Crear los conjuntos de correlación, página 86 proporciona más información acerca decómo definir conjuntos de correlaciones para un proceso.


Capítulo 9

Depurar una plantilla de proceso

En este capítulo se presentan los conceptos básicos de la depuración de una plantilla de proceso deProcess Builder. Se incluyen los siguientes temas:• Introducción al Debugger de proceso, página 183• Preparar la depuración del proceso, página 187• Probar un proceso en el depurador, página 189

Introducción al Debugger de proceso

El depurador de Process Builder le permite probar interactivamente el diseño de unaplantilla de proceso estableciendo los puntos de quiebre, recorriendo el proceso,examinando y modificando los datos de proceso, probando las integraciones yadquiriendo y actuando sobre las tareas del proceso.

Depurar un proceso antes de implementarlo en un entorno de producción sirve paraasegurar que el flujo de proceso diseñado satisface los requisitos comerciales originalesen los que ha basado el diseño. El uso del Debugger para solucionar problemas de unproceso permite probarlo dentro del entorno de diseño sin tener que guardar, validar niinstalar dicho proceso. También puede probar las actividades que está desarrollandopara asegurarse de que ha configurado correctamente un flujo de proceso complejo. Laejecución de una ruta de acceso determinada dentro de un flujo también le puede aportaruna valiosa información durante el proceso de desarrollo.

La depuración tiene lugar en el entorno local. Cuando el proceso se ejecuta en modode debug (depuración), el servidor no crea elementos de trabajo reales o elementos decola. Cualquiera cambio realizado en las variables de proceso sólo se mantiene en elsistema local durante la duración de la sesión de debug (depuración). No se guardanuna 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 losdatos de atributo existentes. El sistema también crea cualquier objeto necesario para las



actividades automáticas dentro del proceso, como las interpretaciones o los anexoscreados mediante las reglas de asignación.

Cuando el sistema ejecuta una actividad manual, el sistema adquiere y finalizaautomáticamente la actividad lo que le permite recorrer todo el proceso sin detenerseen esa actividad particular. Para completar manualmente una actividad o realizar otrafunción manual en la actividad, puede establecer en ella un punto de quiebre. Esto lepermite ejecutar las funciones que haría un ejecutante como, por ejemplo, seleccionar laactividad siguiente en una transición o modificar datos de proceso.

Cuando establece un punto de quiebre en una actividad automática y elige recorrer laactividad, podrá ver los mensajes de entrada y salida, volver a ejecutar una tarea conerrores y modificar los datos de proceso asociados a la actividad.

A medida que el Debugger recorre las distintas actividades del flujo de proceso, marcael avance por el flujo con una línea en negrita. Esto resulta especialmente útil paraseguir el progreso a través de un flujo que tiene transiciones con posibles rutas deacceso distintas. Cuando el Debugger está listo para ejecutar una actividad, se muestrauna flecha verde sobre ella, lo que indica que se ha creado el elemento de trabajo y elejecutante lo ha adquirido.



Figura 7. Actividad manual en el Debugger

Una vez que el sistema ejecuta todo el proceso, muestra un mensaje en las fichas TaskManager y Consola para indicar que el flujo de trabajo se ha completado. En este puntotodavía tiene acceso al proceso en modo de depuración y puede ver los mensajes deProcess Engine en la ficha Consola.

Utilizar el entorno de debug (depuración) de procesos

La ventana Debugger de proceso se divide en dos paneles:• El panel superior contiene la representación gráfica de la plantilla de proceso y

muestra el progreso del proceso de depuración y los puntos de quiebre agregados alproceso.



• El panel inferior se compone de las siguientes fichas:

— Ficha Task Manager que gestiona las opciones de ejecución de las tareasmanuales y automáticas.

— Ficha Datos de procesos, que permite visualizar y agregar paquetes, así comoeditar datos de proceso.

— Ficha Consola que muestra los mensajes de Process Engine.

— Ficha Administrar flujo de trabajo que permite enviar un evento al flujo detrabajo.

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

En la tabla siguiente se muestran los iconos utilizados en los botones y en otros elementosde la interfaz.

Tabla 9. Elementos gráficos del Debugger de proceso y su propósito

Elemento gráfico Finalidad

Lanza el proceso en modo dedepuración o vuelve a ejecutar elproceso en modo de depuración.

Agrega o quita un punto de quiebre.

Identifica todas las actividadesactuales del flujo de trabajo. Se hacreado el elemento de trabajo y loha adquirido el ejecutante. La flechasólo aparece para las actividades querequieren una intervención manualo que tienen puntos de quiebre.

Identifica una actividad ya ejecutadaen el Debugger.

Identifica una actividad en la que seha establecido un punto de quiebre.



Preparar la depuración del proceso

Puede depurar procesos guardados en el repositorio de Documentum o puede depurarun proceso mientras lo está diseñando. No es necesario guardar los procesos para serprobado en el Debugger de proceso.

Agregar puntos de quiebre

Los puntos de quiebre le permiten detener el flujo de proceso en una actividad concretapara cambiar los datos de proceso, agregan paquetes y ver la información de ejecuciónen la tarea. Puede agregar puntos de quiebre en todas las actividades automáticas omanuales que desee.

Al ejecutar un proceso en modo de depuración, el sistema se detiene antes de cadaactividad que tenga un punto de quiebre, permitiéndole abrir la actividad y agregarcontenido a los paquetes, así como ver o modificar los datos de proceso antes de ejecutarla actividad. Si la actividad es manual, puede finalizarla, rechazarla o completarla antesde que el flujo continúe. Con una actividad automática, puede abrir la actividad, ejecutarla tarea y consultar la entrada y salida de la actividad así como cualquier mensaje deerror.

Para agregar un punto de quiebre:

1. Seleccione la actividad en el proceso.Para seleccionar varios objetos, mantenga presionada la tecla Mayús mientras haceclic en ellos.

2. Haga clic en el botón Alternar punto de quiebre para establecer el punto de quiebreen 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 dela actividad.

Iniciar un flujo de trabajo en el depurador

Puede depurar una plantilla de proceso guardada en el repositorio o puede depurarun proceso mientras lo está diseñando antes de haberlo guardado. Una vez abierto elproceso en el editor de procesos, inicie el Debugger y seleccione una actividad de inicio



para comenzar el proceso. Puede agregar paquetes o anexos al proceso y editar datosde paquete y variables de proceso para probar distintas combinaciones de datos enel flujo de proceso.

Nota: Sólo puede depurar un proceso cada vez. Si el Debugger está abierto en una ficha,su icono aparece en la ficha junto al nombre del proceso. El sistema no iniciará unainstancia nueva del Debugger hasta que haya cerrado la sesión de depuración actual.

Para iniciar una sesión de debug (depuración) mediante una actividadde 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 > Iniciardepuración de procesos para abrir el cuadro de diálogo Proceso de depuración.

3. Escriba un nombre para el flujo de trabajo en el cuadro de textoNombre del flujo detrabajo.

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 paqueteque desea probar.Debe agregar contenido a cada paquete obligatorio.

6. Si es necesario, edite los atributos expandiendo el nodo, haciendo clic en cualquieraque 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 guardanen el repositorio y sobrescriben los datos de atributo del paquete existentes.

7. Expanda el nodo Variables para editar los valores haciendo clic con el botónsecundario del ratón en cualquier campo editable y seleccione Editar valor.Los cambios realizados en las variables de proceso sólo se mantienen en el sistemalocal durante la duración del proceso de debug (depuración). No se guardarán unavez finalizada la sesión del depurador de 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 debug.Se muestra la ventana de proceso de debug permitiéndole ver y probar el proceso.Probar un proceso en el depurador, página 189 proporciona instrucciones detalladassobre cómo probar el proceso.

Para iniciar una sesión de debug mediante una actividad de inicio entrante:

Nota: Antes de depurar una actividad de inicio HTTP entrante o Servicio Web entrante,debe especificar el número de puerto que utilizará el oyente en el cuadro de diálogoPreferencias. Definir el número de puerto para la depuración de actividades entrantes,



página 51 proporciona instrucciones sobre cómo establecer el número de puerto. Otrasactividades entrantes utilizan los sondeos especificados en la configuración de laactividad.

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 > Iniciardepuración de procesos 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, seleccioneIniciar flujo de trabajo con oyentes de inicio entrantes.El sistema inicia la escucha para el tipo de mensaje asociado a la actividad ycomienza la escucha de la solicitud de inicio de mensaje específico a ese protocolo.

4. Haga clic en Iniciar escuchas para comenzar el proceso de debug (depuración).Se muestra la ventana de debug (depuración) de proceso permitiéndole ver el flujode proceso. Cuando el proceso recibe el mensaje, el flujo de trabajo comienza.Probar un proceso en el depurador, página 189 proporciona instrucciones detalladassobre cómo probar el proceso.

Probar un proceso en el depurador

Puede decidir ejecutar sin parar un proceso sin tener ningún punto de quiebre o puededetenerse en las actividades para las que ha definido puntos de quiebre y ha probadola actividad interactivamente con la ventana de debug (depuración) de proceso. Puederealizar tareas manuales y ejecutar pruebas automáticas, establecer valores diferentespara variables de proceso y paquetes, así como enviar eventos al flujo de 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 funcionesen la ventana de depuración de procesos.

Tabla 10. Botones de Debugger de proceso

Botón Finalidad

Pasar a la siguiente actividad hace que elDebugger avance a la siguiente actividadincluso si no hay ningún punto de quiebredefinido.



Botón Finalidad

Pasar a la ejecución de la actividad actualpermite ver los detalles de la actividadautomática. La actividad se ejecuta pero nocontinúa en la actividad siguiente. Debepasar a una actividad automática paraver los mensajes de servicio asociadosa la ejecución de la actividad. Puederealizar cambios en las asignaciones y laconfiguración de la actividad, volver aejecutar la actividad si se producen erroresy realizar otras funciones de resolución deproblemas.

Volver a ejecutar la depuración ejecuta elproceso desde el principio del flujo, sintener que volver a cargar los datos deproceso.• Para paquetes o anexos, el proceso se

ejecuta con los mismos datos con losque finalizó el flujo de trabajo. Si sehan realizado cambios en un paquete oanexo durante el flujo de trabajo, esoscambios se guardan en el repositorio y elproceso vuelve a empezar utilizando losatributos modificados.

• Para variables de proceso, el procesose ejecuta con los atributos cargadosoriginalmente en el Debugger. Si se hanrealizado cambios en las variables deproceso, esos cambios no se guardan,por lo que el proceso se ejecuta con losvalores originales.

Esta opción sólo está disponible unavez completado el proceso. No puedevolver a ejecutar un proceso completadoparcialmente.

Continuar hasta el siguiente punto de quiebrele permite desplazarse al punto de quiebresiguiente del proceso.



Botón Finalidad

Detener debug (depuración) finaliza el procesode depuración y elimina el flujo de trabajoy los elementos de trabajo creados durantela sesión de depuración.

Salir de la sesión de depuración permite salirdel Debugger y volver al editor de plantillasde proceso. El sistema elimina el flujo detrabajo y todos los elementos de trabajocreados para la sesión de depuración.

Utilizar la ficha Task Manager

La ficha Task Manager le permite realizar distintas tareas para las actividades manualesy automáticas. La ficha muestra el estado del elemento de trabajo en la actividad (porejemplo, adquirido).

Gestionar una tarea manual

De forma predeterminada, el sistema adquiere y finaliza las tareas manuales de modoque el proceso se ejecuta durante el proceso de depuración sin intervención. Cuando secoloca un punto de quiebre en una actividad manual, puede seleccionar el contenido deun paquete, modificar las variables de proceso y realizar las funciones relacionadas conla tarea basándose en la actividad. Algunas de estas funciones incluyen:

• 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 y varios 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 yla Guía de configuración de Documentum TaskSpace proporcionan información detalladasobre las diferentes acciones disponibles para gestionar tareas manuales.

Gestionar una tarea automática

Al entrar en una actividad automática, el depurador ejecuta la actividad actual y muestralos mensajes de entrada y salida específicos del protocolo, así como cualquier excepción.Estos mensajes permiten ver la comunicación entre los sistemas con los que se integra elproceso, por ejemplo, bases de datos de servicios Web externos, y facilitan la resoluciónde cualquier problema.

Además, puede abrir el Inspector de actividades y editar cualquiera de las propiedadesde la actividad con excepciones. Después de editar una actividad con excepciones, puedevolver a ejecutar la actividad para asegurarse de que la actividad se completa sin errores.

Para completar una actividad que contiene errores y que no puede corregir, haga clicen Obligar a completar la tarea; el sistema completará la actividad y continuará con elproceso.

Al definir un punto de quiebre en una actividad automática, puede realizar las funcionessiguientes:• 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 losmensajes de excepció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 ydesencadenar su ejecución. Esto le permite mostrar cualquier mensaje de entrada o desalida, así como cualquier error o excepción. Por ejemplo, si llama a un servicio Web,podrá ver la solicitud y la información de respuesta.

De igual forma, puede ver los mensajes de entrada para cada protocolo concreto. Porejemplo, el texto de una solicitud SOAP aparece en la ventana de mensajes, lo quele permite copiarlo y pegarlo en un editor de texto. También puede ver el texto delmensaje de respuesta (la respuesta SOAP) y cualquier actualización posterior de losdatos de procesos.



Depurar métodos de flujo de trabajo automáticos

Varias de las plantillas de actividad suministradas con Process Builder ejecutan métodosautomáticos que se extienden desde WorkflowMethod. Estas plantillas de actividad son:• Crear carpeta• Enlazar a carpeta• Transformación de XSLTEl código para estos métodos automáticos está ubicado en el archivo bpsintegration.jar.Durante el proceso de instalación, Process Builder coloca estos archivos en el directorioC:/Archivos de programa/Documentum/BPM/classes/personalizado de forma que esténdisponibles para el Debugger de proceso.

Si un proceso contiene métodos Java personalizados, los métodos deben extendersedesde WorkflowMethod. Si los métodos Java no se extienden desde WorkflowMethod(en su lugar implementan IDfMethod), no se pueden ejecutar desde el Debugger ygenerarán un error. Utilice el botón Obligar a completar la tarea para completar la tareay 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 deselección en el Inspector de actividades.

3. Cree un archivo .jar (o las clases con la estructura del paquete completo) para elcódigo Java personalizado y coloque el archivo .jar (o las clases) en el directorioC:/Archivos de programa/Documentum/bpm/classes/custom.Esto permite que el Debugger cargue el archivo o las clases .jar para la ejecución en elmétodo personalizado.

4. Inicie el Debugger de proceso y ejecute el proceso.

Nota: Los mensajes de depuración escritos en PrintWriter aparecerán en la fichaConsola.

Utilizar la ficha Datos de procesos

Utilice la ficha Datos de procesos para ver los atributos de los datos asociados a laactividad y para realizar la edición en línea de los datos de proceso. Puede agregar oactualizar paquetes o cambiar las variables de la instancia actual en el proceso. Hagaclic en el botón Actualizar datos de proceso para obtener datos en caso de que otraactividad 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 nuevovalor.

2. Pulse Intro en el teclado o seleccione Guardar.

3. Para ver el contenido de un anexo o paquete, desplácese hasta el nodo contenidoy haga clic en el enlace correspondiente a Ver contenido. El Debugger mostrará elcontenido en el editor o aplicación adecuados en otra ventana.

Nota: Los cambios realizados en los atributos de paquete en el depurador se guardan enel repositorio y sobrescriben los datos de atributo del paquete existentes. Los cambiosrealizados en las variables de proceso sólo se mantienen en el sistema local durante laduración del proceso de debug (depuración). No se guardarán una vez finalizada lasesión del depurador de proceso.

Utilizar la ficha Consola

En la ficha Consola se muestran mensajes de Process Engine sobre el estado del proceso.Estos mensajes incluyen cuándo se inició el flujo de trabajo, cuándo se crearon elementosde trabajo, se adquirieron, se completaron, si se envío una notificación por correoelectrónico, etc. En la ficha Consola también se muestra el mensaje de depuración de losservicios utilizados en el proceso.

Los mensajes de protocolo muestran el mensaje intercambiado entre el servicio y elproceso:• Para los mensajes salientes, el cuadro de texto Mensajes de entrada muestra el

mensaje enviado desde el proceso al servicio externo, y el cuadro de texto Mensajesde salida muestra el mensaje del servicio.

• Para los mensajes entrantes, el cuadro de texto Mensajes de entrada muestra elmensaje recibido por el proceso desde el servicio externo, y el cuadro de textoMensajes de salida muestra el mensaje enviado desde el proceso al servicio.

Para los protocolos de los servicios Web y HTTP, el mensaje es una aproximación cercanaal mensaje que se transmite por la red. Para otros servicios, el mensaje utiliza un formatoXML que representa la estructura 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 dearchivos donde se almacena el contenido. Una vez que el flujo de trabajo se completa enel Debugger, se elimina 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 elcuadro de texto Excepción de la ficha Task Manager para cualquier actividad automáticaque utilice la mensajería.

Usar la ficha Administrar flujo de trabajo

La ficha Administrar flujo de trabajo permite enviar un evento al flujo de trabajo paracompletar una tarea o continuar depurando el proceso.

Su nombre debe coincidir con el del evento que espera el flujo de trabajo (especificado enla ficha Desencadenador 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.


Apéndice A

Plantillas de actividades incorporadas

Process Builder se suministra con un conjunto de plantillas de actividades predefinidas para lastareas de los procesos comerciales habituales. Las plantillas están disponibles en la ventana ActivityTemplates (Plantillas de actividades) del Navegador de recursos y se organizan en una estructurade árbol que refleja el tipo de tarea que representa cada una. Por ejemplo, el nodo Servicios decontenido contiene plantillas de actividades relacionadas con las funciones de gestión de contenidobásicas y el nodo Integración contiene plantillas para las actividades que envían datos del procesode flujo de trabajo a participantes externos que usan las funciones de mensajería de DocumentumProcess Integrator.

Puede crear plantillas de actividad personalizadas para complementar las que se suministran.Consulte Crear plantillas de actividad, página 114. Process Builder incluye una plantilla de actividadde ejemplo que muestra el formato del archivo XML de plantilla de actividad para ayudarle a crearplantillas de actividad 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. Las plantillas de actividad estándar son:

Servicios de contenido, página 199• Crear carpeta, página 199• Ciclo de vida, página 201• Aplicar ciclo de vida, página 200• Enlazar a carpeta, página 203• ECIS (Enterprise Content Integration Services) - (Servicios de Integración de Contenido

Empresarial), página 204Flujo , página 205• Decision Split (División de la decisión), página 206• Unir, página 206• Publicar evento en proceso padre, página 207• Transformación XSL, página 208Integración , página 208• BOF Module (Módulo BOF), página 209



• Crear LCA (lista de control de acceso), página 211• Crear carpeta a partir de plantilla, página 213• Crear evento de calendario de ICS , página 214• Base de datos entrante: inicio y procedimiento, página 215• Database Read (Leer base de datos), página 218• Database Stored Procedure (Procedimiento almacenado en base de datos), página 220• Database Write (Escribir base de datos), página 224• DQL entrante: inicio y procedimiento, página 226• DQL Read (Leer DQL), página 227• DQL Write (Escribir DQL), página 228• Dynamic Web Service (Servicio Web dinámico), página 229• Correo electrónico entrante: inicio y procedimiento, página 238• Fax saliente, página 240• FTP, página 277• FTP entrante: inicio y procedimientos, página 244• FTP saliente, página 247• Leer FTP , página 248• HTTP entrante: inicio y procedimiento, página 250• HTTP saliente, página 253• Buzón HTTP, página 278• JMS entrante: inicio y procedimiento, página 255• JMS Saliente, página 257• Asignación de datos de procesos, página 258• SMTP , página 260• Abrir proceso, página 262• Servicio Web, página 263• Servicio Web entrante: inicio y procedimiento, página 265• Documento de xPression Publish, página 268• Documento de xPression Publish: Avanzada , página 269

Nota: Las plantillas de actividades entrantes requieren que el archivo BPS.war esté implementado enel servidor de aplicaciones.

Ejemplo, página 272• Definir habilidad para tarea de cola, página 272• Decisión de repasar tarea de la cola, página 273Plantillas de actividad no admitidas, página 274

• Buzón HTTP, página 278



• Vuelta al estado anterior del ciclo de vida, página 280• Promoción de ciclo de vida, página 281• Punto de observación, página 282• Publicar en el tema de JMS, página 276• Enviar a la cola de JMS, página 278• Enviar a MQ JMS, página 279• SMTP, página 275• Iniciar subproceso, página 274

Servicios de contenido

Las plantillas de actividad de la ventana Servicios de contenido permiten incluir lastareas de gestión de contenido básicas en los procesos comerciales.

Las actividades basadas en estas plantillas muestran solamente tres fichas en el Inspectorde actividades: Ejecutante (que identifica el método de flujo de trabajo que debeejecutarse), Definición y una ficha personalizada. Las restantes fichas estándar delInspector de actividades no son pertinentes para las actividades de los servicios decontenido.

Las actividades de la ventana Servicios de contenido son:

• Crear carpeta, página 199• Aplicar ciclo de vida, página 200• Vuelta al estado anterior del ciclo de vida, página 280• Enlazar a carpeta, página 203• ECIS (Enterprise Content Integration Services) - (Servicios de Integración de

Contenido Empresarial), página 204

Crear carpeta

Las actividades basadas en esta plantilla crean una nueva carpeta en el repositoriobasada en un nombre de carpeta determinado o en una plantilla de carpeta. Paraconfigurar la actividad, asigne un nombre a la nueva carpeta y especifique la ruta deacceso a la ubicación en la jerarquía de carpetas en la que desea crearla.

• Nombre de la nueva carpeta: escriba el nombre de la nueva carpeta. El nombrepuede incluir variables de sustitución. Haga clic el botón ... para mostrar un cuadrode diálogo en el que puede seleccionar las variables disponibles.



• Crear a partir de una plantilla de carpeta (opcional): seleccione una plantilla decarpeta predefinida del repositorio. La plantilla de carpeta permite crear una copiade la carpeta que incluye las carpetas anidadas, con el nombre raíz de la plantilla decarpeta utilizada como nuevo nombre de la carpeta.

• Carpeta de destino: haga clic en el botón ... para desplazarse hasta la carpetaprincipal en la que se creará la nueva carpeta. Al hacer clic en Aceptar en el cuadrode diálogo, el nombre de la carpeta principal aparecerá en el campo de datos.

• O escriba la ruta de la carpeta: escriba la ruta completa a la carpeta principal enla que se creará la nueva carpeta, comenzando por una barra diagonal inversay el nombre del archivador de nivel superior (por ejemplo, /System/Workflow).Al escribir la ruta de la carpeta en lugar de seleccionarla, puede incluir una o másvariables de sustitución en la especificación de la ruta. Haga clic el botón ... paramostrar un cuadro de diálogo en el que puede seleccionar las variables disponibles,incluyendo las variables de paquete.

• Enlazar carpeta al paquete: enlaza la carpeta completa al paquete seleccionado en lalista desplegable.

Aplicar ciclo de vidaNota: Sólo Documentum Process Builder versión 6.5 admite esta plantilla de actividad.Si se utiliza una versión anterior de Process Builder con un repositorio Documentum 6.5,esta plantilla no se abrirá.

Las actividades basadas en esta plantilla aplican un ciclo de vida de documento a unpaquete del proceso comercial. Un ciclo de vida define una serie ordenada de estadosque corresponden a las fases de la vida de un documento.

Para configurar una actividad de Aplicar ciclo de vida, debe elegir el ciclo de vida quedesea aplicar y el valor de ciclo de vida que se aplicará a los datos del proceso. Asimismo,debe especificar el estado inicial del ciclo de vida y el alcance que se utilizará cuando seresuelvan alias asociados al ciclo de vida. Consulte la guía Documentum Composer UserGuide si precisa información detallada sobre la creación y el uso de los ciclos de vida.

1. En el primer cuadro de lista, seleccione el ciclo de vida que debe aplicarse al paquete.

2. Alcance: seleccione el alcance que se utilizará para resolver los alias asociados conel ciclo de vida seleccionado.Ésta es la clave para que el tipo dm_alias_set recupere la asignación de los valoresde alias aquí definidos. Los valores que aparecen en el cuadro de lista desplegabledependen del ciclo de vida.El estado inicial con el que se definirá el paquete aparece en el cuadro de texto.

3. Haga clic en Siguiente para usar el asignador de datos para asignar los atributosque aplican un ciclo de vida al objeto.



Asignación necesaria — Los siguientes parámetros deben asignarse a los datos deproceso:• r_object_id identifica el objeto al que se aplica el ciclo de vida.

Ciclo de vidaNota: Sólo Documentum Process Builder versión 6.5 admite esta plantilla de actividad.Si se utiliza una versión anterior de Process Builder con un repositorio Documentum 6.5,esta plantilla no se abrirá.

Las actividades basadas en este plantilla mueven el ciclo de vida del objeto a otro estado.Se pueden realizar 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 o al estado base si el parámetro demote_to_base_state estáestablecido en true.

• Suspender, que detiene temporalmente el avance de un objeto por los estados delciclo de vida asignado.

• 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 quecambian el estado del ciclo de vida del objeto.Como referencia, en la página de configuración se muestran consejos para lasasignaciones necesarias y opcionales.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar yasignar los atributos con valor de repetición.Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol

Tabla 11. Asignaciones de plantilla de ciclo de vida

Operación Requisito Descripción

Promover Requerido r_object_id identifica el objeto que se va apromover.




Opcional. state identifica el estado de destino deseado. Elvalor predeterminado es el estado siguiente.

Opcional. override_entry_checks establecido en trueomitirá la comprobación de la entrada de estadode ciclo de vida configurado. (Cada estado delciclo de vida tiene un conjunto de criterios deentrada que debe cumplir normalmente undocumento para ser promovido a ese estado).El valor predeterminado es false.

Devolver al estadoanterior

Requerido r_object_id identifica el objeto que se va adevolver al estado anterior.

Opcional. state identifica el estado de destino deseado. Elvalor predeterminado es el estado anterior.

Opcional. demote_to_base_state establecido en trueobliga a devolver el objeto al estado base. Elvalor predeterminado es false. Anula el estado.

Si el estado y demote_to_base_state estánasignados, demote_to_base_state anula laasignación de estado.

Suspender Requerido r_object_id identifica el objeto que se va asuspender.

Opcional. state identifica el estado de destino deseado (elvalor predeterminado es el estado suspendidoasociado al estado actual).

Opcional. override_entry_check establecido en trueomite la comprobación de la entrada deestado de ciclo de vida configurado (el valorpredeterminado es false).Reanudar Requerido r_object_id identifica el objeto que se va areanudar.

Opcional. state identifica el estado de destino deseado (elvalor predeterminado es el estado reanudadoasociado al estado actual).

Opcional. override_entry_checks establecido en trueomite la comprobación de la entrada deestado de ciclo de vida configurado (el valorpredeterminado es false).




Opcional. resume_from_base_state establecido en trueobliga a mover el objeto al estado base (el valorpredeterminado es false). Anula el estado.

Opcional. Si se asignan tanto state como resume_from_base_state, resume_from_base_state reemplazaa la asignación state.

Enlazar a carpeta

Las actividades basadas en esta plantilla agregan los objetos de uno o varios paquetes auna carpeta especificada del repositorio. Para configurar la actividad, debe especificar elnombre y la ubicación de la carpeta. La actividad puede copiar los paquetes especificadosa la carpeta (manteniendo los enlaces de éstos a otras carpetas en las que pueden residir)o mover los paquetes a la carpeta (desenlazándolos de otras carpetas). Si la carpetaespecificada no existe, la actividad puede crearla.

• O escriba la ruta de la carpeta: escriba la ruta completa a la carpeta principal enla que se creará la nueva carpeta, comenzando por una barra diagonal inversay el nombre del archivador de nivel superior (por ejemplo, /System/Workflow).Al escribir la ruta de la carpeta en lugar de seleccionarla, puede incluir una o másvariables de sustitución en la especificación de la ruta. Haga clic el botón ... paramostrar un cuadro de diálogo en el que puede seleccionar las variables disponibles,incluyendo las variables de paquete.

• Enlazar carpeta al paquete: enlaza la carpeta completa al paquete seleccionado en lalista desplegable.

• Paquetes: haga clic en el botón ... para acceder a un cuadro de diálogo en el quepodrá seleccionar los paquetes de proceso cuyo contenido desea enlazar a la carpetadel repositorio. Resalte el nombre del paquete en la lista de la izquierda y haga clicen el botón Agregar para moverlo a la lista de paquetes seleccionados de 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.

• Nombre de la nueva carpeta: escriba el nombre de la nueva carpeta. El nombrepuede incluir variables de sustitución. Haga clic el botón ... para mostrar un cuadrode diálogo en el que puede seleccionar las variables disponibles.

• Crear carpeta si no existe: seleccione Sí para que el sistema cree una carpeta conel nombre especificado si no existiera.



• Crear a partir de una plantilla de carpeta (opcional): seleccione una plantilla decarpeta predefinida del repositorio. La plantilla de carpeta permite crear una copiade la carpeta que incluye las carpetas anidadas, con el nombre raíz de la plantilla decarpeta utilizada como nuevo nombre de la carpeta.

• Carpeta de destino: haga clic en el botón ... para desplazarse hasta la carpetaprincipal a la que se enlazará la nueva carpeta. Al hacer clic en Aceptar en el cuadrode diálogo, el nombre de la carpeta principal aparecerá en el campo de datos.

• O escriba la ruta de la carpeta de destino: escriba la ruta completa a la carpetaprincipal de la carpeta a la que se enlazará el contenido, comenzando por una barradiagonal inversa y el nombre del archivador de nivel superior. Al escribir la ruta dela carpeta en lugar de seleccionarla, puede incluir una o más variables de sustituciónen la especificación de la ruta. Haga clic el botón ... para mostrar un cuadro dediálogo en el que puede seleccionar las variables disponibles.

• Desenlazar de las carpetas originales: seleccione Sí para que la actividad mueva lospaquetes a la carpeta especificada, desenlazándolos de otras carpetas; o seleccioneNo para copiar los paquetes en la carpeta, manteniendo los enlaces a otras carpetas.El valor predeterminado es No.

• Enlazar carpeta al paquete: para anexar el objeto de carpeta al proceso comercial,seleccione el paquete al que desea anexarlo en el cuadro de lista.

ECIS (Enterprise Content Integration Services) -(Servicios de Integración de Contenido Empresarial)

Esta plantilla de actividad habilita una búsqueda de ECIS basada en un criterio debúsqueda pre-configurado. Los resultados de búsqueda, que pueden incluir páginasHTML, documentos de Word, archivos PDF, imágenes, etc., se guardan en la carpetade resultados de búsqueda de ECIS y se muestran en el orden especificado en el campoGuardar resultados de ECIS con clasificación hasta (0-1).

La plantilla de actividad de ECIS puede utilizarse para buscar en varios destinoscomo FileNet y servidores de Open Text, sitios web externos y otros repositorios deDocumentum a los que los adaptadores de ECIS puedan tener acceso.

Se ejecuta automáticamente una búsqueda de ECIS preconfigurada basada en la palabraclave Nombre en 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 directorio

Nota: Estos destinos de búsqueda se configuran en el Centro de administración de ECIS.La guía Documentum ECI Services Administration Guide proporciona más informaciónacerca de cómo configurar los destinos de búsqueda.

Configure los campos siguientes para permitir a la plantilla de actividad buscar elcontenido.

• Cadena de búsqueda: escriba la cadena de búsqueda que define la información queestá buscando o haga clic en el botón con puntos suspensivos (...) situado junto alcampo para seleccionar una cadena de búsqueda preconfigurada en un cuadro dediálogo.

• Ruta de archivo temporal de resultados de ECIS: escriba la ruta completa de la rutade acceso del archivo de resultados temporales. El archivo temporal se utiliza paraguardar el contenido de un origen externo. Después de guardarlo en un archivolocal, se importa en el repositorio.

• Guardar resultados de ECIS en el archivador: escriba el nombre del archivadorque almacenará sus resultados.

• Guardar resultados de ECIS en la carpeta: escriba el nombre de carpeta del archivode resultados en el repositorio.

• Guardar resultados de ECIS con clasificación hasta (0-1): escriba el valor que se vaa utilizar para evaluar los resultados que se van a guardar. El número que escribeaquí es el porcentaje de aciertos más bajo que guarda el sistema. Por ejemplo, paraguardar los resultados que coincidan de un 50% a un 100% respecto al criterio debúsqueda, escriba .5. Para guardar un criterio de búsqueda que cumpla al menos el20% del criterio de búsqueda, escriba .2

Flujo

Las plantillas de actividad del nodo Flow (Flujo) se utilizan para controlar el flujo detrabajo a través del proceso comercial. Las actividades de este nodo son:

• Decision Split (División de la decisión), página 206• Unir, página 206• Publicar evento en proceso padre, página 207• Iniciar subproceso, página 274• Transformación XSL, página 208



Decision Split (División de la decisión)

La plantilla de actividad Decision Split (División de la decisión) le permite mostrarexplícitamente puntos de decisión en una plantilla de proceso comercial. En lugar deespecificar la lógica de ramificaciones en la ficha Transición de una actividad que realizaotro tipo de acción, puede agregar una actividad cuya única acción sea la de evaluar lalógica y reenviar los paquetes según corresponda. La separación de la decisión de lasdemás acciones permite que el flujo de proceso resulte más claro.

Figura 8. Proceso de aprobación sin y con la actividad Decision Split (División de la

decisión)

Al agregar una actividad Decision Split (División de la decisión), enlace la actividadanterior a esta actividad y defina su transición como Seleccionar todas las actividadesconectadas. Defina la lógica de ramificaciones en la ficha Transición de la actividadDecision Split (División de la decisión).

La plantilla de actividad Decision Split (División de la decisión) no incluye fichas nicampos personalizados. Cuando se ve una actividad creada con la plantilla DecisionSplit (División de la decisión) en el Inspector de actividades, sólo aparecen las fichasTemporizadores, Transición, Datos y Visualización. Estas fichas contienen todos losvalores de configuración relevantes para una actividad de punto de decisión.

Nota: El sistema utiliza dm_bpm_noop_method para conectar con el repositorio ycompletar la actividad 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 condicionesde desencadenamiento cuando convergen varios flujos en un proceso comercial. Enlugar de especificar las condiciones de desencadenamiento en la ficha Desencadenadorde una actividad que realiza otro tipo de acción, puede agregar una actividad cuyaúnica acción sea la de evaluar las condiciones y reenviar paquetes según corresponda.



La actividad Unir espera a que finalice un determinado número de las actividadesanteriores y, a continuación, reenvía sus paquetes a la siguiente actividad. La siguienteactividad no necesita evaluar las condiciones de desencadenamiento, puesto que laactividad Unir ya lo ha hecho.

Figura 9. Proceso de revisión sin y con la actividad Unir

La plantilla de actividad Unir no incluye fichas ni campos personalizados. Cuandose ve una actividad creada con la plantilla Unir en el Inspector de actividades, sóloaparecen las fichas Desencadenador, Temporizadores, Datos y Visualización. Estasfichas contienen todos los valores de configuración relevantes para una actividad Unir.

Nota: El sistema utiliza dm_bpm_noop_method para conectar con el repositorio ycompletar la actividad en lugar de iniciar un método en tiempo de ejecución.

Publicar evento en proceso padre

Las actividades basadas en la plantilla Publicar evento en proceso padre funcionan demanera conjunta con las de Invoke Process (Abrir proceso) para habilitar los subprocesossincrónicos. Un flujo de proceso principal inicia un nuevo subproceso mediante unaactividad Invoke Process (Abrir proceso) y espera a que se envíe un evento determinadoantes de continuar. El subproceso secundario utiliza una actividad Publicar evento enproceso padre para enviar el evento, de modo que el proceso principal pueda continuar.

• Nombre de evento: el nombre del evento que se enviará al flujo de trabajo principal.Su nombre debe coincidir con el del evento que espera el flujo de trabajo principal(especificado en la ficha Desencadenador de la actividad pendiente en el flujo detrabajo principal).

• Nombre del supervisor: seleccione el usuario en cuyo nombre se envía el evento.



Transformación XSL

La plantilla de actividad Transformación XSL crea actividades que realizan unatransformación en un archivo XML. Las actividades basadas en esta plantilla recuperancontenido XML de un paquete de flujo de trabajo, le aplican un archivo XSL y, acontinuación, anexan el archivo transformado como otro paquete de flujo de trabajo.

• Transformar contenido de paquete: el nombre del paquete de flujo de trabajo cuyocontenido XML se va a transformar.

• Transformar con este archivo XSL: haga clic en el botón situado junto al campo paraseleccionar el archivo XSL que se utilizará para transformar el contenido XML. Elarchivo XSL debe estar guardado en el repositorio.

• Anexar resultado como contenido del paquete: el nombre del paquete de flujo detrabajo en el que se escribirá el contenido transformado. Debe especificar un paqueteválido definido para el proceso.

• Formato de contenido transformado: especifica si el contenido transformado sedebe guardar en formato XML o HTML.

Integración

Las plantillas de actividad de la ventana Integración proporcionan un método paraintercambiar datos entre el proceso comercial y los sistemas o ejecutantes externos.Algunas plantillas ofrecen una interfaz similar a la de un asistente para definir la formaen 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 en el servidor de aplicaciones.

Las actividades de este nodo son:

• BOF Module (Módulo BOF), página 209• Crear LCA (lista de control de acceso), página 211• Crear carpeta a partir de plantilla, página 213• Crear evento de calendario de ICS , página 214• Base de datos entrante: inicio y procedimiento, página 215• Database Read (Leer base de datos), página 218• Database Stored Procedure (Procedimiento almacenado en base de datos), página 220• Database Write (Escribir base de datos), página 224• DQL entrante: inicio y procedimiento, página 226• DQL Read (Leer DQL), página 227• DQL Write (Escribir DQL), página 228



• Dynamic Web Service (Servicio Web dinámico), página 229• Correo electrónico entrante: inicio y procedimiento, página 238• Fax saliente, página 240• FTP, página 277• FTP entrante: inicio y procedimientos, página 244• FTP saliente, página 247• Leer FTP , página 248• HTTP entrante: inicio y procedimiento, página 250• HTTP saliente, página 253• Buzón HTTP, página 278• JMS entrante: inicio y procedimiento, página 255• JMS Saliente, página 257• Asignación de datos de procesos, página 258• SMTP , página 260• Abrir proceso, página 262• Servicio Web, página 263• Servicio Web entrante: inicio y procedimiento, página 265• Documento de xPression Publish, página 268• Documento de xPression Publish: Avanzada , página 269

BOF Module (Módulo BOF)

Las actividades basadas en esta plantilla ejecutan un método Java que se proporcionacomo un módulo que utiliza Business Object Framework (BOF) de Documentum.La herramienta de asignación de datos se utiliza para proporcionar valores para losparámetros de entrada del método y para asignar los valores de devolución a losatributos de paquete con el fin de que estén disponibles para actividades posteriores.

Nota: El tipo de datos de los parámetros y del valor de devolución debe ser un tipoprimitivo de Java, Byte[] (y/o byte[]), un objeto DataSource o un objeto JavaBean. BLOB(Objeto binario grande) y los datos binarios se representan como matriz de bytes. El tipode datos char no se admite actualmente.

Para obtener información sobre el empaquetado de un método Java como un móduloBOF, consulte la guí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 quese muestra el contenido de la carpeta \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óduloaparecerá en el cuadroMódulo BOF. Process Builder rellenará los cuadros delista 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 paratodos los campos requeridos en la página actual.

5. Si el método seleccionado tiene parámetros de entrada, proporcione valores para losparámetros mediante la herramienta de asignación de datos.En la pantalla Asignación de mensaje de entrada, la columna derecha de laherramienta de asignación de datos muestra los parámetros de entrada para elmétodo. La columna izquierda muestra los atributos de paquete y las variablesde sustitución de flujos de trabajo. Se puede asignar el valor del atributo de datosde un paquete como un argumento de entrada para un método como Byte[] (y/obyte[]). También se puede asignar el contenido completo, es decir, datos y tipo decontenido, de un paquete a un DataSource. Consulte Introducción a la herramientade asignación de datos, página 163 para obtener información detallada sobre el usode la herramienta de asignación de datos.Si el método seleccionado no tiene parámetros de entrada, la pantalla Asignación demensaje de entrada no aparecerá. Continúe en el paso 7.

6. Haga clic en Siguiente.Si el método seleccionado no tiene valores de salida, el botón Siguiente aparecerácomo no disponible. Omita el paso siguiente.

7. Utilice la herramienta de asignación de datos para guardar los valores de salidacomo valores de atributo de paquete.En la pantalla Asignación de mensaje de salida, la columna izquierda de laherramienta de asignación de datos muestra los valores de salida para el método. Lacolumna de la derecha muestra los atributos de paquete.En Asignación de mensaje de salida, un método puede devolver un valor a unpaquete como Byte[] (o byte[]). Sin embargo, debe establecer manualmente elformato del contenido del paquete en un valor de cadena. También puede escribirel contenido de un DataSource en un paquete mediante la asignación del valor delatributo de los datos al atributo de los datos del paquete.Consulte Introducción a la herramienta de asignación de datos, página 163 paraobtener información detallada sobre el uso de la herramienta de asignación de datos.



8. Haga clic en Aceptar o en Aplicar para guardar la configuración.En tiempo de ejecución, si existe el paquete de destino, el valor del atributo de losdatos se sustituye por los datos del DataSource o del método Byte[] (y/o byte[]). ParaDataSource, el valor del atributo de formato del paquete de destino se sustituye porel valor de formato del DataSource. Si no existe el paquete de destino, se crearáun paquete nuevo. Los datos y el formato del paquete de origen se copiarán en elpaquete nuevo. Sin embargo, si el paquete de origen no tiene una asignación deformato, el valor para el atributo de formato en el paquete de destino se define en"crtext".

Crear LCA (lista de control de acceso)

Utilice la plantilla de actividad de LCA para crear un objeto LCA de Documentuma partir de una plantilla de LCA y aplicarlo a objetos dentro de una instancia deproceso. La plantilla de LCA ya debe existir en el repositorio y, al crearla, se debe haberespecificado que incluya marcadores de posición o alias tanto para usuarios como paragrupos. El sistema utiliza la plantilla de actividad Crear LCA con el fin de suministrarvalores para dichos marcadores de posición y alias en función de los datos de procesos 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 paraun caso de cliente que permita a un supervisor disponer de permisos de escritura yeliminación para un paquete mientras que el procesador del caso sólo tenga acceso deescritura. Una plantilla de LCA puede disponer de diferentes alias para los usuarios ylos grupos de manera que se les otorguen distintos permisos. También puede crearLCA independientes para departamentos que requieran diversos conjuntos de permisospara 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 existenteen el repositorio.

2. Haga clic en Siguiente para asignar datos de proceso a los atributos de la plantillade LCA.

Asignaciones necesariasLos atributos siguientes deben asignarse a los datos de proceso:• acl_name es el nombre del nuevo objeto de LCA.• acl_domain es el propietario del nuevo objeto de LCA.



• acl_class indica el tipo de LCA.

Los valores válidos son:

— 0: LCA privada

Son LCA públicas las listas disponibles para cualquier usuario delrepositorio. Sólo el propietario o bien los usuarios con privilegios deadministrador del sistema o de superusuario pueden modificar o eliminarlas LCA públicas.

— 3: LCA pública

Son LCA públicas las listas disponibles para cualquier usuario delrepositorio. Sólo el propietario o bien los usuarios con privilegios deadministrador del sistema o de superusuario pueden modificar o eliminarlas LCA públicas.

Asignaciones opcionalesLas siguientes son asignaciones opcionales:

— %grpcat,%Usercat y%usrgrpcat son los nombres de alias individuales parael grupo, el usuario y las categorías de usuario o de grupo. Asigne estosvalores a los valores correctos de nombre de usuario o de grupo en los datosde proceso. Si elige no asignar los alias, el servidor los resolverá según losvalores predeterminados para la LCA.

Para obtener más información sobre cómo resuelve los alias Content Server,consulte el apéndice sobre alias en la Guía de fundamentos de Content Server.

Nota: Los alias que pertenecen a categorías como conjunto de permisos, rutade archivador y ruta de carpeta no son compatibles con esta acción en elasignador de datos.

Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



otros atributos de origen de un paquete que no aparecen actualmente en el árbol.3. Haga clic en Siguiente para asignar los parámetros de salida de LCA a los datos de

proceso. De este modo se aplica la LCA al paquete o al anexo.Asignaciones necesarias

Se deben asignar los atributos siguientes:



• r_object_id es el ID de objeto del nuevo objeto de LCA.

acl_domain es el propietario del nuevo objeto de LCA.

acl_name es el nombre del nuevo objeto de LCA.

Crear carpeta a partir de plantilla

Utilice la plantilla de actividad Crear carpeta a partir de plantilla para crear una carpetay su contenido a partir de una plantilla predefinida. Esta carpeta se puede incluir en elproceso como un anexo o un paquete, y su contenido se puede mostrar en DocumentumTaskSpace o Webtop. Por ejemplo, puede utilizar la plantilla de actividad Crear carpetaa partir de plantilla para crear una carpeta que contenga subcarpetas y documentosasociados. 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 Crear carpeta a partir de plantilla:

1. En la ficha Crear carpeta, desplácese y seleccione la plantilla de carpeta delrepositorio que desee utilizar para crear la carpeta nueva y su contenido.

2. Haga clic en Siguiente para utilizar la página Asignación de entrada para asignarlos atributos de la carpeta a los datos de proceso. Esta operación incluye todos losatributos personalizados que se pueden establecer si la plantilla seleccionada esdel subtipo dm_folder.

Asignación necesaria — Los siguientes parámetros deben asignarse a los datos deproceso:• objet_name se asigna al nombre de la carpeta nueva.• r_folder_path se asigna a la ubicación de la carpeta nueva.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



otros atributos de origen de un paquete que no aparecen actualmente en el árbol.3. Haga clic en Siguiente para utilizar la página Asignación de salida para adjuntar la

carpeta nueva y su contenido como un paquete o un anexo al proceso.



Crear evento de calendario de ICS

La plantilla de actividad Crear evento de calendario de ICS permite crear un archivo deintercambio de datos de calendario (.ics) que se pueda utilizar para crear un evento decalendario o una reunión en cualquier cliente que sea compatible con tipos de archivoiCalendar. La plantilla de actividad crea el archivo basándose en las asignaciones deentrada asignadas a los valores del archivo .ics. A continuación puede enviar este archivoa 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 deproceso, es decir, si se vuelve a programar el evento o un cliente externo lo cancela, losdatos de proceso no se actualizan con los cambios.

Nota: La plantilla de actividad Crear evento de calendario de ICS no es compatible conla característica de calendario comercial de TaskSpace. La actividad crea el archivoICS basándose en un calendario estándar.

Para crear un archivo de evento de calendario de ICS:

Nota: La plantilla de actividad Crear evento de calendario de ICS no tiene una páginade configuración.

1. Utilice la herramienta del asignador de datos para asociar datos de proceso aatributos del archivo de calendario.

Asignaciones opcionalesLos atributos siguientes pueden asignarse a los datos de proceso:• Asocie un UID existente de los datos de proceso al uid de los atributos del

calendario de destino para actualizar un evento de calendario existente. Paraactualizar un evento existente con información nueva, utilice el identificadorexistente como UID para el archivo. Esto cambiará el evento cuando el archivoICS se envíe en una actividad posterior. El sistema utiliza el UID existente paralocalizar y actualizar el evento de calendario existente.

Si el UID no está asignado a un valor, el servidor de métodos genera uno y elsistema lo asigna al archivo ICS. Cuando se crea el archivo ICS, el servidor demé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 Task Force), proporciona información detallada sobre lasdiferentes propiedades del archivo iCalendar.

Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.



• Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.

• Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregary asignar los atributos con valor de repetición.

• Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol.

2. Haga clic en Siguiente para adjuntar el archivo de invitación de calendario a losdatos de proceso como un paquete o un anexo.

Base de datos entrante: inicio y procedimiento

Utilice la plantilla de actividad Base de datos entrante para recuperar las filas de unatabla de base de datos o ver y crear los flujos de trabajo o completar una actividad.El sistema crea una escucha en tiempo de ejecución que ejecuta la instrucción selectespecificada para recuperar las filas para su procesamiento. Una vez procesada la fila,una instrucción SQL definida por el usuario actualiza o elimina la fila para asegurarsede que no se ha procesado varias veces.

Por ejemplo, una compañía tiene una aplicación de base de datos que consulta una tablade inventario para buscar elementos que necesitan reabastecimiento. La actividad Basede datos entrante puede consultar la tabla de elementos que necesitan reabastecimientocon objeto de iniciar un proceso de pedido de compra para los elementos necesarios.

La plantilla de actividad Base de datos entrante sólo obtiene los registros de una tabla ode una vista. Cada fila inicia una nueva instancia de proceso o completa una actividadintermedia. Cada registro debe tener columnas que se pueden utilizar para identificarexclusivamente el registro. Además, cada fila en la base de datos debe corresponder conun solo evento. Por ejemplo, si un informe de gastos tiene varios elementos de líneaasociados, 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 seutilizará.

3. En el cuadro Cadena de conexión, escriba la cadena de conexión JDBC que seutilizará para conectar con la base de datos.La sintaxis esperada de la cadena de conexión aparecerá bajo el cuadro cuandoseleccione el controlador JDBC.

4. Escriba el nombre de usuario y la contraseña que se utilizarán para conectar conla 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 quese ha proporcionado en los pasos 2 a 4, aparecerá un mensaje en color verde bajo elcuadro Cadena de conexión. Si la conexión es incorrecta, se muestra un mensaje enrojo 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 elcuadro de texto que contiene la consulta.Si la consulta no es válida, se obtendrá un mensaje de error de la base de datos.Corrija la consulta para que sea válida.

8. Únicamente para las actividades intermedias, seleccione un nombre de columnacomo el ID de correlación para que el sistema lo utilice para hacerlo coincidir con losdatos recuperados del flujo de trabajo.La columna contiene el identificador de correlación apropiada relacionada con lainstancia de flujo de trabajo concreta.Un ID de correlación es una cadena única asociada con cada instancia de proceso yse puede usar para identificar un flujo de trabajo y hacer coincidir el mensaje con él.El identificador de correlación debe haberse establecido en una actividad anteriorcomo una actividad Escribir base de datos. Usar los identificadores de correlación,página 180 proporciona instrucciones sobre cómo utilizar 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 losatributos de paquete o de las variables de flujos de trabajo en tiempo de ejecución,escriba un signo de interrogación (?) en donde desee que se sustituya el valor. Elsigno de interrogación representa un pará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úmerode la seguridad social (después de procesar el registro) incluye un signo deinterrogación en lugar de un valor SSN concreto:UPDATE from CUSTOMER WHERE ssn=?

La instrucción update puede incluir cualquier número de parámetros, cada uno deellos representado por un signo de interrogación. Cada parámetro debe asignarse alos datos de proceso en la página de asignación de datos. No entrecomille el signode interrogación.

Nota: Asegúrese de que la fila se puede identificar exclusivamente durante elprocesamiento posterior 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 elnombre de alias/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 dediálogo con una lista de parámetros que corresponden al número de signosde interrogación de la consulta. Los nombres 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 decolumna o el alias de la columna del parámetro en el cuadro de lista. El nombrede columna o alias de la columna del parámetro debe coincidir con la columnade base de datos correspondiente a la que se asignan parámetros en la consultadel 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 aobtener por el controlador JDBC cuando se necesiten más filas para el procesamientodurante cada ciclo del sondeo.

12. Escriba el número de segundos utilizado como Frecuencia de sondeo después deque el sistema busque nuevos registros en la tabla.

13. Escriba el Número de procesadores para definir el número de hilos que van aprocesar los registros simultáneamente.

14. Haga clic en Siguiente para asignar los datos del conjunto de resultados al modelode datos de proceso.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



otros atributos de origen de un paquete que no aparecen actualmente en el árbol.15. Haga clic en Aceptar o en Aplicar para guardar la configuración.



Database Read (Leer base de datos)

Las actividades basadas en esta plantilla conectan con una base de datos externa ydevuelven los resultados de una instrucción SQL Select. La actividad Database Read(Leer base de datos) también admite el intercambio de contenido desde el tipo de datosBLOB de Oracle y el tipo de datos Byte de Microsoft 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á paraconectar con la base de datos y especificar la instrucción Select que se ejecutará. Laherramienta de asignación de datos se utiliza para proporcionar los valores para lasvariables de sustitución de la instrucción Select y copiar los resultados de la consulta enlos 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.





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 unaconsulta 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 unsigno de interrogación (?) en donde desee que se sustituya el valor. El signo deinterrogación representa un parámetro cuyo valor la actividad insertará en tiempode ejecución. Por ejemplo, una consulta que realiza una búsqueda de un registro de



cliente basada en un número de la seguridad social incluye un signo de interrogaciónen lugar 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 unode ellos representado por un signo de interrogación. No entrecomille el signo deinterrogación.

7. Para las consultas que incluyen parámetros de sustitución, identifique el tipo dedatos 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 dediálogo con una lista de parámetros que corresponden al número de signosde interrogación de la consulta. Los nombres de los parámetros son parám1,parám2, etc.


c. Haga clic en el valor de la columna Tipo de datos y seleccione el tipo de datospara el parámetro en el cuadro de lista. El tipo de datos del parámetro debecoincidir con el tipo de datos de la columna de la base de datos correspondiente.Para una base de datos de Oracle, seleccione BLOB como el tipo de datos. ParaMicrosoft SQL, seleccione Binario como el tipo de datos del parámetro.



8. Haga clic en el botón Validar consulta.Process Builder comprobará la validez de la consulta y mostrará un mensaje bajo elcuadro de texto que contiene la consulta.Si la consulta no es válida, se obtendrá un mensaje de error de la base de datos.Corrija la consulta para que sea válida.

9. Haga clic en Siguiente.El botón Siguiente aparecerá como no disponible hasta que haya escrito valores paratodos los campos requeridos en la página actual.

10. Si la consulta tiene parámetros de sustitución, proporcione valores para losparámetros mediante la herramienta de asignación de datos.En la pantalla Asignación de mensaje de entrada, la columna derecha de laherramienta de asignación de datos muestra los parámetros de sustitución de laconsulta. La columna izquierda muestra los atributos de paquete y las variablesde sustitución de flujos de trabajo. Consulte Introducción a la herramienta deasignación de datos, página 163 para obtener información detallada sobre el uso dela herramienta de asignación de datos.



Si la consulta no incluye parámetros de sustitución, la pantalla Asignación demensaje de entrada no aparecerá. Continúe en el paso 12.


12. Utilice la herramienta de asignación de datos para guardar los resultados de laconsulta como valores de atributo de paquete.En la pantalla Asignación de mensaje de salida, la columna izquierda de laherramienta de asignación de datos muestra los valores devueltos por la consulta. Lacolumna de la derecha muestra los atributos de paquete. Si utiliza el tipo de datosBLOB, deberá asignar el contenido de BLOB como un atributo de datos del paquete.Consulte Introducción a la herramienta de asignación de datos, página 163 paraobtener información detallada sobre el uso de la herramienta de asignación de datos.Si la consulta devuelve más de una fila de datos, la actividad asigna los valores de laprimera fila devuelta a los atributos de paquete asociados.


Database Stored Procedure (Procedimiento almacenadoen base de datos)

Las actividades basadas en esta plantilla conectan con una base de datos externa yejecutan un procedimiento almacenado o una función. Para definir la actividad, debeidentificar el controlador JDBC que se utilizará para conectar con la base de datos yespecificar el procedimiento almacenado o la función que se ejecutarán. La herramientade asignación de datos se utiliza para proporcionar valores para los parámetros INe IN/OUT del procedimiento almacenado. La actividad devuelve los valores para losparámetros OUT e IN/OUT o el conjunto de resultados del procedimiento almacenado, obien, 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 (Procedimientoalmacenado en base de datos):



3. En el cuadro Cadena de conexión, escriba la cadena de conexión JDBC que seutilizará para conectar con la base de datos.



La sintaxis esperada de la cadena de conexión aparecerá bajo el cuadro cuandoseleccione el controlador JDBC.



6. Escriba el nombre de la función o del procedimiento almacenado en el cuadroreservado para dicha información. Opcionalmente, puede escribir el nombredescriptivo del procedimiento almacenado con uno de los formatos siguientes:<nombre de catálogo>.<nombre de esquema>.<nombre de procedimiento>o <nombre de esquema>.<nombre de procedimiento>o <nombre de procedimiento>

Nota: Los nombres de catálogo, esquema y procedimiento o función distinguenentre mayúsculas y minúsculas.

Continúe en el paso 8.

7. Si no sabe el nombre del procedimiento almacenado o de la función, puede utilizarlas siguientes instrucciones para buscarlo:

a. Haga clic en Buscar para buscar un procedimiento o una función. Aparecerá laventana Buscar.

b. En el cuadro Introduzca el patrón de búsqueda, escriba el nombre delprocedimiento almacenado o de la función. Este nombre distingue entremayúsculas y minúsculas, y puede ser descriptivo. También puede utilizar elcomodín % para buscar un procedimiento almacenado o una función. Si necesitamás información sobre el uso del comodín %, haga clic en ¿Qué es esto?.

c. Haga clic en Buscar.Process Builder buscará el procedimiento almacenado o la función en todos losesquemas y paquetes de la base de datos y recuperará 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áel nombre del catálogo y el esquema junto con el nombre del procedimientoalmacenado como, por ejemplo, STANDARD.SYS.CALCULAR_IMPUESTO.Consulte Patrones de búsqueda de ejemplo, página 222 si necesita másinformación sobre el 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, porejemplo, los parámetros de entrada y el valor de devolución, bajo el cuadrode 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 valores para los parámetros mediante la herramienta de asignaciónde datos.En la pantalla Asignación de mensaje de entrada, la columna izquierda muestra losatributos de paquete y las variables de sustitución del flujo de trabajo. La columnaderecha de la herramienta de asignación de datos muestra todos los parámetros IN eIN/OUT del procedimiento almacenado o los argumentos de la función. Si existe másde un parámetro de entrada, y sólo asigna un parámetro, los otros se estableceránen NULL o como se haya definido en el procedimiento almacenado o la función.Consulte Introducción a la herramienta de asignación de datos, página 163 paraobtener información detallada sobre el uso de la herramienta de asignación de datos.Si el procedimiento almacenado o la función no incluyen parámetros de entrada oargumentos, la pantalla Asignación de mensaje de entrada no aparecerá. Continúeen el paso 11.


11. Utilice la herramienta de asignación de datos para guardar el valor de devolución dela función o el procedimiento como atributos de paquete.En la pantalla Asignación de mensaje de salida, la columna izquierda de laherramienta de asignación de datos muestra los valores de los parámetros OUT eIN/OUT o el resultado devuelto por el procedimiento almacenado, o bien, el valor dedevolución de la función. La columna de la derecha muestra los atributos de paquete.Consulte Introducción a la herramienta de asignación de datos, página 163 paraobtener información detallada sobre el uso de 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ónde búsqueda.

Nota: Los patrones de búsqueda distinguen entre mayúsculas y minúsculas.



• Nombre del procedimiento almacenado o la función: sólo busca las aparicionesde la función o el procedimiento almacenado que se hayan escrito con el siguienteformato:

<nombre de procedimiento>

Por ejemplo, si busca el nombre de procedimiento almacenado ADD_EMPLOYEE,Business Process Services recupera el procedimiento almacenado ADD_EMPLOYEE

junto con el nombre de catálogo y esquema, tal como STANDARD.SYS.ADD_EMPLOYEE.Si busca ADD_, Business Process Services recupera todos los procedimientosalmacenados o funciones cuyo nombre comience por ADD_.

• Nombre descriptivo: sólo busca las apariciones de los procedimientos almacenadoso las funciones que se hayan escrito con un nombre descriptivo usando uno de lossiguientes formatos:

<nombre de catálogo>.<nombre de esquema>.<nombre de procedimiento>

o <nombre de esquema>.<nombre de procedimiento>

Por ejemplo, si busca el procedimiento almacenado ORDSOURCE.ORDSYS.WRITE,Business Process Services recupera el procedimiento almacenado WRITE en elesquema ORDSYS del catálogo ORDSOURCE. No se recuperarán los procedimientosalmacenados WRITE que se encuentren disponibles en otros catálogos o esquemas.

Si busca SCOTT.ADD_EMPLOYEE, Business Process Services recupera el procedimientoalmacenado ADD_EMPLOYEE del esquema SCOTT.

• El comodín %: busca los procedimientos almacenados o las funciones en todoslos catálogos y esquemas de la base de datos usando los patrones de búsquedasiguientes.

— % o en blanco: se recuperarán todos los procedimientos almacenados o lasfunciones de la base de datos.

— B%: se recuperarán todos los procedimientos almacenados cuyo nombrecomience por "B".

— A.%: se recuperarán todos los procedimientos almacenados del esquema cuyonombre sea "A".

— A.B%: se recuperarán todos los procedimientos almacenados cuyo nombreempiece por "B" en el esquema con nombre "A".

— C.A.B%: se recuperarán todos los procedimientos almacenados cuyo nombreempiece por "B" en el esquema con nombre "A" del catálogo "C".

— A%.B%: se recuperarán todos los procedimientos almacenados cuyo nombreempiece 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 yejecutan una instrucción SQL Insert, Update o Delete. La actividad Database Write(Escribir base de datos) también admite el intercambio de contenido desde un paquetea los parámetros de bases de datos. Es decir, se pueden insertar o actualizar los datosbinarios 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á paraconectar con la base de datos y especificar la instrucción que se ejecutará. Utilice laherramienta de asignación de datos para proporcionar valores para las variables desustitución de la instrucción SQL. La actividad devuelve el número de filas creadas oactualizadas.

Para configurar una actividad de Database Write (Escribir 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, Updateo Delete. Para crear una instrucción SQL mediante los parámetros cuyos valoresprovienen de los atributos de paquete o de las variables de flujos de trabajo entiempo 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 valorla actividad insertará en tiempo de ejecución. Por ejemplo, una instrucción que



actualiza el apellido de un cliente según un número de la seguridad social incluye unsigno de interrogación en lugar de un valor específico del número de la seguridadsocial (SSN):Update CUSTOMER Set Lastname=’Smith’ where ssn=?

La instrucción SQL puede incluir cualquier número de parámetros, cada unode ellos representado por un signo de interrogación. No entrecomille el signo deinterrogación.

7. Para las instrucciones SQL que incluyen parámetros de sustitución, identifique eltipo de datos para 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 conuna lista de parámetros que corresponden al número de signos de interrogaciónde la consulta. Los nombres de los parámetros son parám1, parám2, etc.


c. Haga clic en el valor de la columna Tipo de datos y seleccione el tipo de datospara el parámetro en el cuadro de lista. El tipo de datos del parámetro debecoincidir con el tipo de datos de la columna de la base de datos correspondiente.Para una base de datos de Oracle, seleccione BLOB como el tipo de datos. ParaMicrosoft SQL, seleccione Binario como el tipo de datos del parámetro.



8. Haga clic en Siguiente.El botón Siguiente aparecerá como no disponible hasta que haya introducido valorespara todos los campos requeridos en la página actual.

9. Si la instrucción SQL tiene parámetros de sustitución, proporcione valores para losparámetros mediante la herramienta de asignación de datos.En la pantalla Asignación de mensaje de entrada, la columna derecha de laherramienta de asignación de datos muestra los parámetros de sustitución de lainstrucción SQL. La columna izquierda muestra los atributos de paquete y lasvariables de sustitución de flujos de trabajo. Si utiliza el tipo de datos BLOB, deberáasignar el contenido de BLOB como un atributo de datos del paquete. ConsulteIntroducción a la herramienta de asignación de datos, página 163 para obtenerinformación detallada sobre el uso de la herramienta de asignación de datos.Si la instrucción SQL no incluye parámetros de sustitución, la pantalla Asignación demensaje de entrada no aparecerá. Diríjase al paso 11.


11. Utilice la herramienta de asignación de datos para guardar el número de filasdevueltas como un valor de atributo de paquete.



En la pantalla Asignación de mensaje de salida, la columna izquierda de laherramienta de asignación de datos muestra los valores únicos devueltos por lainstrucción SQL: el número de filas insertadas o actualizadas. La columna de laderecha muestra los atributos de paquete. Consulte Introducción a la herramienta deasignación de datos, página 163 para obtener información detallada sobre el uso dela herramienta de asignación de datos.


DQL entrante: inicio y procedimientoNota: Sólo Documentum Process Builder versión 6.5 admite esta plantilla de actividad.Si se utiliza una versión anterior de Process Builder con un repositorio Documentum 6.5,esta plantilla no se abrirá.

Utilice esta plantilla para procesar los objetos ubicados en un repositorio deDocumentum. Cuando el sistema encuentra un nuevo objeto, crea una nueva instanciadel proceso o utiliza el objeto para completar una actividad o elemento de trabajoen ejecución.

En una actividad DQL entrante, se configura un oyente para escuchar un procesoentrante. Cuando se inicia el oyente, el sistema crea un hilo de sondeo que ejecutala consulta DQL select especificada en la calificación de DQL. El sondeo busca en elrepositorio cualquier objeto nuevo que coincida con la consulta utilizando el intervalo detiempo especificado en la plantilla de actividad. Para cada ID de objeto devuelto por laconsulta, el sistema crea un nuevo hilo que delega el objeto en el procesador posterior, elcual 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 ainformació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 deProcess Builder a través del archivo de configuración dfc.properties.

4. Si ha decidido conectarse a un repositorio diferente, escriba el nombre de usuarionecesario para conectarse al repositorio.

5. Si ha decidido conectarse a un repositorio diferente, escriba la contraseña necesariapara conectarse al repositorio.

6. Haga clic en el botón Probar conexión para comprobar que los parámetros deconexión se han escrito correctamente.



Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro detexto. Modifique los 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 SELECTque empieza por la palabra clave FROM. La calificación de DQL identifica de formaexclusiva un objeto en un 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 lalista de atributos que pertenezca al tipo de objeto especificado en la calificaciónde DQL.

10. Seleccione una opción de posprocesamiento para gestionar el objeto después deque se haya recuperado.Los valores válidos permiten eliminar el objeto recuperado por la consulta, mover elobjeto a una carpeta especificada o actualizar los atributos basándose en la consultaintroducida.

11. Si ha seleccionado mover el objeto a una carpeta para archivar, escriba la ruta dedicha carpeta.

12. Si ha seleccionado actualizar valores de atributo, escriba la consulta para actualizarlos 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 cualquierentrada nueva 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 losdatos en este punto final.

15. Haga clic en Siguiente para asignar los objetos a los atributos de datos de proceso.

DQL Read (Leer DQL)Nota: Sólo Documentum Process Builder versión 6.5 admite esta plantilla de actividad.Si se utiliza una versión anterior de Process Builder con un repositorio Documentum 6.5,esta plantilla no se abrirá.

Las actividades basadas en esta plantilla ejecutan las consultas DQL en el repositorioespecificado. Por ejemplo, puede utilizar la plantilla de actividad DQL Read paraseleccionar un documento de préstamo del repositorio enviado entre una serie de fechaso en función del importe del préstamo o la puntuación de crédito.



Para configurar una plantilla de actividad Leer DQL:






6. Haga clic en el botón Probar conexión para comprobar que los parámetros deconexión se han escrito correctamente.Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro detexto. Modifique los valores e inténtelo de nuevo.

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 unsigno de interrogación (?) en donde desea que se sustituya el valor. El signo deinterrogación representa un parámetro cuyo valor la actividad insertará en tiempode ejecución.

8. Haga clic en el botón Configurar Tipo de parámetro para seleccionar un tipo dedatos para el parámetro que especifique en la consulta DQL.


10. Haga clic en Siguiente para utilizar el asignador de datos para asignar los datos deproceso a los parámetros de la consulta.

DQL Write (Escribir DQL)Nota: Sólo Documentum Process Builder versión 6.5 admite esta plantilla de actividad.Si se utiliza una versión anterior de Process Builder con un repositorio Documentum 6.5,esta plantilla no se abrirá.

Las actividades basadas en esta plantilla permiten ejecutar, crear, actualizar o eliminarconsultas DQL de objetos en el repositorio especificado. Por ejemplo, puede utilizarla plantilla de actividad DQL Write para definir una puntuación de crédito en undocumento de préstamo del repositorio.



Para configurar una plantilla de actividad Escribir DQL:







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 unsigno de interrogación (?) en donde desea que se sustituya el valor. El signo deinterrogación representa un parámetro cuyo valor la actividad insertará en tiempode ejecución.

8. Haga clic en el botón Configurar Tipo de parámetro para seleccionar un tipo dedatos para el parámetro que especifique en la consulta DQL.


10. Haga clic en Siguiente para utilizar el asignador de datos para asignar los datos deproceso a los parámetros de la consulta.

Dynamic Web Service (Servicio Web dinámico)

Las actividades basadas en esta plantilla ejecutan una operación de servicio Web. Adiferencia de la plantilla Servicio Web, esta plantilla de actividad permite asignar datosde forma interactiva entre los atributos de los procesos comerciales y los parámetros delos servicios Web. Esta plantilla de actividad admite servicios Web seguros y no seguros.

En las secciones siguientes se describe la forma de configurar servicios Web segurosy no seguros.

• Abrir servicios Web no seguros, página 230• Abrir los servicios Web seguros, página 231



Abrir servicios Web no seguros

En esta sección se describe la forma de configurar una actividad de servicio Web noseguro.

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 laURL 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 camposde 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 archivoWSDL.

5. Seleccione una de las operaciones disponibles en el archivo WSDL especificado.

6. Haga clic en Siguiente.El botón Siguiente aparecerá como no disponible hasta que haya seleccionado unaoperación de un archivo WSDL válido. También aparecerá como no disponible siaún no ha especificado los paquetes para el proceso comercial, o si la operación delservicio Web seleccionada no tiene parámetros de entrada o valores de devolución.

7. Si la operación del servicio Web seleccionada tiene parámetros de entrada,proporcione valores para los parámetros mediante la herramienta de asignaciónde datos.En la pantalla Asignación de mensaje de entrada, la columna derecha de laherramienta de asignación de datos muestra los parámetros de entrada para laoperación. La columna izquierda muestra los datos de proceso y las variablesde sustitución de flujos de trabajo. Consulte Introducción a la herramienta deasignación de datos, página 163 para obtener información detallada sobre el uso dela herramienta de asignación de datos.Si la operación de servicio Web seleccionada no tiene parámetros de entrada, lapantalla Asignación de mensaje de entrada no aparecerá. Continúe en el paso 9.

8. Haga clic en Siguiente.Si la operación del servicio Web seleccionada no tiene valores de salida, el botónSiguiente aparecerá como no disponible. Omita el paso siguiente.

9. Utilice la herramienta de asignación de datos para guardar los valores de salidacomo valores de atributo de paquete.



En la pantalla Asignación de mensaje de salida, la columna izquierda de laherramienta de asignación de datos muestra los valores de salida para la operación.La columna de la derecha muestra los atributos de paquete. Consulte Introduccióna la herramienta de asignación de datos, página 163 para obtener informacióndetallada sobre el uso de la herramienta de asignación de datos.


Abrir los servicios Web seguros

Las actividades basadas en esta plantilla admiten tres tipos de seguridad. Son lossiguientes:• Compatibilidad de proxy HTTP• Autenticación básica de HTTP• Autenticación basada en encabezado SOAPAntes de configurar un servicio Web seguro, puede configurar el servidor proxy HTTP.Consulte Configurar el servidor proxy HTTP, página 233 para configurar un servidorproxy HTTP.

En los procedimientos siguientes se describe la forma de configurar servicios Webprotegidos por autenticación básica de HTTP y por autenticación basada en encabezadoSOAP.

Para configurar una actividad de servicio Web seguro, haga clic en la ficha Configuracióndel servicio Web del Inspector de actividades.

Si el servicio Web que desea invocar está protegido por autenticaciónbásica de HTTP:

1. En el cuadro Dirección URL del archivo WSDL, escriba el nombre completo de laURL al archivo 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 camposde la pantalla.



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. Diríjase al Asignar parámetros de servicio Web, página 232.

Si el servicio Web que desea invocar está protegido por autenticaciónbasada en encabezado SOAP:

1. En el cuadro Dirección URL del archivo WSDL, escriba el nombre completo de laURL al archivo WSDL que contiene la operación que desea ejecutar.Por ejemplo, si utiliza Documentum Web Services Framework (WSF), puede usar lasiguiente dirección URL del servicio de credenciales del repositorio:http://localhost:8080/ws/services/DocbaseCredentials?wsdldonde:• localhost:8080 es la dirección del host del servidor de aplicaciones.• ws/services es el nombre del directorio del servidor de aplicaciones donde está

instalado Web Services Framework (WSF).2. Haga clic en Leer archivo WSDL.

Process Builder leerá el archivo WSDL especificado y rellenará los demás camposde la pantalla.



Nota: Consulte la guía Documentum Web Services Framework Development Guidesi necesita más información sobre los tipos y las operaciones del servicio decredenciales.

5. Para servicios Web con seguridad SOAP se generará un token de seguridad.

6. Si desea asignar información de autenticación basada en SOAP, consulte Asignarparámetros de servicio Web, página 232.

Asignar parámetros de servicio Web

Realice los pasos siguientes para asignar los valores de entrada y salida del servicioWeb. No obstante, antes de empezar, debe completar los pasos iniciales para configurarel servicio Web dinámico, tal y como se describe en Abrir los servicios Web seguros,página 231.

Para asignar los parámetros del servicio Web:




El botón Siguiente aparecerá como no disponible hasta que haya seleccionado unaoperación de un archivo WSDL válido. También aparecerá como no disponible siaún no ha especificado los paquetes para el proceso comercial, o si la operación delservicio Web seleccionada no tiene parámetros de entrada o valores de devolución.

2. Si la operación del servicio Web seleccionada tiene parámetros de entrada,proporcione valores para los parámetros mediante la herramienta de asignaciónde datos.En la pantalla Asignación de mensaje de entrada, la columna derecha de laherramienta de asignación de datos muestra los parámetros de entrada para laoperación. La columna izquierda muestra los atributos de paquete y las variablesde sustitución de flujos de trabajo. Consulte Introducción a la herramienta deasignación de datos, página 163 para obtener información detallada sobre el uso dela herramienta de asignación de datos.Si el servicio Web está protegido por autenticación basada en encabezado SOAP,debe asignar el token de seguridad y los parámetros seguros de SOAP. Si utiliza elservicio de credenciales basado en Documentum WSF, debe asignar los valores delos parámetros según el tipo y las operaciones del servicio de credenciales.

Nota: Si necesita más información sobre los tipos y las operaciones del servicio decredenciales, consulte la guíaDocumentumWeb Services Framework Development Guide.

Si la operación de servicio Web seleccionada no tiene parámetros de entrada, lapantalla Asignación de mensaje de entrada no aparecerá. Continúe en el paso 3.

3. Haga clic en Siguiente.Si la operación del servicio Web seleccionada no tiene valores de salida, el botónSiguiente aparecerá como no disponible. Omita el paso siguiente.

4. Utilice la herramienta de asignación de datos para guardar los valores de salidacomo valores de atributo de paquete.En la pantalla Asignación de mensaje de salida, la columna izquierda de laherramienta de asignación de datos muestra los valores de salida para la operación.La columna de la derecha muestra los atributos de paquete. Consulte Introduccióna la herramienta de asignación de datos, página 163 para obtener informacióndetallada sobre el uso de la herramienta de asignación de datos.


Configurar el servidor proxy HTTP

Si utiliza un servidor proxy HTTP para acceder a un servicio Web ubicado fuera delservidor de seguridad, debe configurar los parámetros del proxy HTTP. Para ello, debemodificar el acceso directo de Process Builder y el parámetro de inicio del servidor Java



Method Server de Content Server. En las secciones siguientes se describe la forma deconfigurar los parámetros de inicio en sistemas basados en Windows y UNIX.• Configurar parámetros del proxy HTTP en Windows, página 234• Configurar parámetros del proxy HTTP en sistemas basados en UNIX, página 235

Configurar parámetros del proxy HTTP en Windows

En esta sección se describe la forma de configurar los parámetros de inicio del proxyHTTP en sistemas de Windows para:• Acceso directo de Process Builder• El servidor Java Method Server de Content Server

Para configurar el acceso directo de Process Builder:

1. Haga clic con el botón secundario del ratón en el acceso directo de Process Builderdel escritorio y seleccione Propiedades.

Nota: Si no dispone de un acceso directo a Process Builder en el escritorio, seleccioneInicio > Programas > Documentum, haga clic con el botón derecho del ratón enProcess Builder y, a continuación, seleccione Propiedades.

2. 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 hosts a los que se puede acceder directamente,pasando por alto el servidor proxy. Se trata de una lista de expresionesregulares separadas por ’|’. Se podrá acceder a través de una conexióndirecta, en lugar de mediante un proxy, a aquellos host que coincidan conestas 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 hosts a los que se puede acceder directamente,pasando por alto el servidor proxy. Se trata de una lista de expresionesregulares separadas por ’|’. Se podrá acceder a través de una conexióndirecta, en lugar de mediante un proxy, a aquellos host que coincidan conestas expresiones regulares.


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 sobreSSL a JAVA_OPTIONS.Por ejemplo, agregue las siguientes líneas para admitir la autenticación básica deHTTP:-Dhttp.proxyHost=<host_proxy>-Dhttp.proxyPort=<número_puerto>donde

host_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 servidorJava Method Server 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 de $DOCUMENTUM$.

2. Agregue los parámetros de proxy HTTP para la autenticación básica o HTTP sobreSSL a JAVA_OPTIONS.Por ejemplo, agregue las siguientes líneas para admitir la autenticación básica deHTTP:-Dhttp.proxyHost=<host_proxy>-Dhttp.proxyPort=<número_puerto>donde



host_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 plantillaactividad Dynamic Web Service (Servicio Web dinámico) que realiza una invocaciónúnica de un servicio Web de DFS.

• Como un servicio encadenado , lo que significa que un proceso contiene variasplantillas de actividad Dynamic Web Service (Servicio Web dinámico) que invocanlos servicios Web de DFS. La información de identidad del repositorio se registra enun token que utilizan las plantilla de actividad.

Nota: La plantilla de actividad Dynamic Web Service (Servicio Web dinámico) sóloadmite base64 para las transferencias de contenido.

Para registrar la identidad del repositorio (para los servicios encadenados):

1. Utilice el ContextRegistryService proporcionado por DFS para registrar elrepositorio.Para obtener más información sobre ContextRegistryService, consulte la guíaDocumentum Foundation Services Development Guide.

2. En la ficha Configuración del servicio Web de la plantilla de actividad Dynamic WebService, 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. Seleccione ContextRegistryServicePort como Tipo de puerto.

4. Seleccione register (registrar) como Operación.

5. Haga clic en Leer archivo WSDL.


7. En la página Asignación de mensaje de entrada, cree las asignaciones siguientes:

a. Asigne RepositoryName aSOAPEnvelope/SOAPBody/params/register/arg0/Identities[0}/@repositoryName

b. Asigne Username a



SOAPEnvelope/SOAPBody/params/register/arg0/Identities[0]/@userName

c. Asigne Password aSOAPEnvelope/SOAPBody/params/register/arg0/Identities[0]/@password

d. Asigne Domain aSOAPEnvelope/SOAPBody/params/register/arg0/Identities[0]/@domain

Nota: Las identidades son un nodo de repetición. Se pueden registrar variasidentidades a un token único.


9. En la página Asignación de mensaje de salida, el token generado está disponible enSOAPEnvelope/SOAPBody/parameters/registerResponse/return

Para eliminar del Registro la identidad del repositorio (para los serviciosencadenados):

1. Utilice el ContextRegistryService proporcionado por DFS para registrar elrepositorio.Para obtener más información sobre ContextRegistryService, consulte la guíaDocumentum Foundation Services Development Guide.

2. En la ficha Configuración del servicio Web de la plantilla de actividad Dynamic WebService, 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. Seleccione ContextRegistryServicePort como Tipo de puerto.

4. Seleccione unregister (eliminar del Registro) como Operación.

5. Haga clic en Leer archivo WSDL.


7. En la página de la Asignación de mensaje de entrada, agregue el token cuyo registrodebe eliminarse aSOAPEnvelope/SOAPBody/params/unregister/arg0

Abrir un servicio DFS típico (único o encadenado)

1. Abra el Inspector de actividades para la plantilla de actividad Dynamic Web Service(Servicio Web 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 disponible delarchivo WSDL.


6. En la página Asignación de mensaje de entrada, agregue las asignaciones de datossiguientes para 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. Laguía Documentum Foundation Services Development Guide proporciona informacióndetallada sobre la funcionalidad 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: Use varias etiquetas <Identities/> cuando se utilice más de un repositoriopara la autenticación.

Correo electrónico entrante: inicio y procedimiento

Las plantillas de actividad de correo electrónico sondean a los servidores de correoelectrónico para los mensajes entrantes y, a continuación, los procesan según lalógica empresarial que ha especificado. Dentro de la plantilla de actividad de Correoelectrónico entrante, defina la conexión al servidor de correo electrónico, seleccione las



opciones para el procesamiento del mensaje una vez leído y asigne los datos del mensajeentrante a los datos de proceso que se utilizan en el proceso.

Por ejemplo, en un proceso comercial de reclamación de un cliente, puede configuraruna plantilla de correo electrónico entrante como la actividad de inicio del proceso. Laactividad registra el servidor de correo electrónico e inicia un nuevo flujo de trabajocuando recibe un mensaje de correo electrónico con la reclamación de un cliente. En lossiguientes pasos del proceso, el sistema enruta el correo electrónico a través de unaactividad manual a una persona que revisa la reclamación y resuelve el problema.

1. En el campo Tipo de servidor de correo electrónico, seleccione el protocolo paraconectarse al servidor de correo electrónico.

Los valores válidos son IMAP o POP.

2. En el campo Nombre de host, escriba el nombre o la dirección IP del servidor decorreo electrónico.

3. Escriba el Número de puerto donde el servidor de correo electrónico escuchasolicitudes de protocolo (IMAP o POP) .

Los valores predeterminados se establecen en función del protocolo seleccionado.

4. Escriba el nombre de usuario y la contraseña para el servidor de correo electrónico.

5. Haga clic en el botón Probar conexión para comprobar que los parámetros deconexión se han escrito correctamente.

Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro detexto. Modifique los valores e inténtelo de nuevo.

6. Escriba el Nombre de la carpeta del correo electrónico donde se procesan losmensajes (por ejemplo Bandeja de entrada).

También puede hacer clic en Obtener lista de carpetas... para ver una lista delas carpetas de correo electrónico disponibles en el servidor de correo electrónicoy seleccionar una.

7. Para actividades intermedias, puede introducir el nombre de un encabezado demensaje de correo electrónico que incluya un ID de correlación en el Nombre deencabezado de correlación.

Un ID de correlación es una cadena única asociada con cada instancia de proceso yse puede usar para 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 hacercoincidir el mensaje con el flujo de trabajo, utiliza las asignaciones que se crean en elPaso 15 para hacer coincidir la respuesta con el mensaje de solicitud.

8. Seleccione una opción para gestionar el mensaje 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 deposprocesamiento válida es Eliminar mensaje de correo electrónico.Las opciones válidas para los servidores IMAP son: Marcar mensaje de correoelectrónico como leído, Eliminar mensaje de correo electrónico oMovermensaje de correo electrónico a la carpeta para archivar.

9. Si ha seleccionado mover el mensaje a una carpeta para archivar en el campo anterior,escriba el nombre de dicha carpeta o haga clic en Obtener lista de carpetas... para ira la carpeta de archivos.

10. Escriba el número de segundos que pasa antes de que el oyente compruebe si haynuevos mensajes.

11. Escriba el número de sesiones de correo electrónico disponible para procesar losmensajes de correo electrónico.

12. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, dondepuede asignar los datos del mensaje a los datos del proceso.

Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.




13. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, dondepuede especificar reglas que hagan coincidir los atributos del conjunto de correlacióncon los atributos del mensaje.

14. Seleccione el Conjunto de correlaciones que está asignando en la lista de la partesuperior de la página.

Introducción a la correlación de mensajes, página 180 proporciona más informaciónacerca de cómo utilizar los conjuntos de correlaciones para hacer coincidir losmensajes de los orígenes externos con los datos de proceso. Crear los conjuntos decorrelación, página 86 proporciona más información acerca de cómo definir losconjuntos de correlaciones para un proceso.

Fax salienteNota: Captaris RightFax no está incluido en el conjunto de Process Suite y se debeadquirir y autorizarse a través de Captaris. Consulte la documentación de Captaris



RightFax para obtener instrucciones sobre cómo instalar y configurar el servidorRightFax.

Debe realizar los pasos obligatorios siguientes antes de usar las plantillas de actividadde Fax saliente:

1. Consulte la documentación de RightFax para obtener la ruta a la API de Java deRightFax (RFJavaInt.zip).

2. Copie RFJavaInt.zip en la ruta siguiente del directorio de implementación de MethodServer: bpm.ear\bpm.war\WEB-INF\lib.

3. Cambie el nombre RFJavaInt.zip por RFJavaInt.jar.

4. Reinicie Method Server.

5.Utilice la plantilla de actividad Fax saliente para enviar mensajes unidireccionales a unservidor de fax de Captaris RightFax. Estos mensajes pueden ser solicitudes de faxenviadas desde un proceso o pueden ser consultas que solicitan el estado de una o variassolicitudes de fax. Los resultados de la consulta aparecen en la bandeja de entrada delejecutante 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.

3. Escriba el nombre de usuario del servidor de RightFax.

4. En el cuadro de lista desplegable, seleccione la operación Enviar para enviar unasolicitud de fax al servidor de RightFax.Enviar envía una solicitud de fax al servidor de RightFax. Consulta obtiene el estadode una solicitud 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 sepuede acceder al servidor de RightFax desde la plantilla de actividad.

6. Haga clic en Siguiente para asignar atributos de datos de proceso a los atributos dela solicitud de fax.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona


y asignar los atributos con valor de repetición.




7. Asigne los Detalles del destinatario siguientes utilizando los datos de proceso en lapantalla del 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 generauno.

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 seencuentra 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 se

pueden utilizar estas portadas al enviar el fax a varios destinatarios. En lamayoría de los casos, las portadas están situadas en la ubicación siguiente:C:\Archivos de programa\RightFax\Production\Covers.

• Portadas de fax de la empresa que utilizan las extensiones de archivosiguientes:

.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-HTML

Estas portadas se almacenan en la ubicación siguiente: C:\Archivos deprograma\RightFax\FCS.

Nota: Las portadas de fax se deben crear utilizando criterios concretos y debenguardarse en una ubicación designada en el servidor de RightFax. Consulte ladocumentación de Captaris RightFax para obtener instrucciones sobre cómocrear y guardar portadas de fax.

8. Asigne las notas de la portada utilizando los datos de proceso en la pantalla delasignador 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 ajusteautomático de línea del servidor de RightFax. Consulte la documentaciónde RightFax para obtener información detallada sobre cómo establecermanualmente la longitud del ajuste automático de línea en el Registro delservidor de RightFax.



9. Asigne los anexos utilizando los datos de proceso en la pantalla del asignador dedatos:

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 lostipos de contenido compatibles.

b. Asigne los datos al contenido real del mensaje de fax.

Nota: Si espera enviar anexos grandes con la plantilla de actividad, es posible quetenga que ajustar el valor del campo El método termina en la ficha Ejecutante.

10. Haga clic en Siguiente para asignar la respuesta del servidor de RightFax a los datosde proceso asociados a la solicitud de envío.

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 unmensaje al mensaje del estado asociado al código de estado.

Para enviar una solicitud de la consulta al servidor de RightFax utilizandola plantilla de actividad 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 recuperarel estado de una solicitud de fax enviada al servidor de RightFax basada en unidentificador único.

4. Haga clic en el botón Probar URL de servidor de RightFax para comprobar que sepuede 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 dela solicitud de fax.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



otros atributos de origen de un paquete que no aparecen actualmente en el árbol.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 portadaPara obtener una lista completa de mensajes, consulte la documentación deRightFax.

FTP entrante: inicio y procedimientos

Las plantillas de actividad de FTP supervisan los archivos y carpetas que se transfieren alas carpetas base designadas. Por ejemplo, en un flujo de trabajo que procesa los pedidosde compra entrantes, puede utilizar esta plantilla de actividad para supervisar la carpetabase para los pedidos de compra entrantes que sean archivos XML. Según la asignación,el sistema inicia a continuación un proceso para cada archivo coincidente basado en eltipo de pedido que ha configurado en el esquema XML.

Desde la plantilla de actividad, puede configurar la información del servidor FTP,comprobar la conectividad y designar opciones de posprocesamiento como eliminaro archivar los archivos o carpetas procesadas. Puede utilizar la herramienta deasignación de datos para procesar los archivos como datos o como documentos XML, alproporcionar 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 sobreSSL) y Archivo 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, si el 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. En el campo Carpetas base, escriba la ruta de acceso a las carpetas en el servidorFTP que se supervisará.

6. 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ón de archivado.• Directorio, que permite al sistema supervisar varios archivos dentro de una

carpeta.• Archivo, que permite al sistema supervisar un archivo.

7. Haga clic en el botón Validar para comprobar que se han escrito los parámetros deconexión y la ruta de la carpeta base correctamente.

8. En el campo Patrón de nombre de archivo/directorio incluido, escriba las variablespara los nombres de tipos de archivo y directorios que desea incluir en la supervisión.Por ejemplo, escriba * .xml para supervisar los archivos XML.

9. En el campo Patrón de nombre de archivo/directorio excluido, escriba las variablespara los nombres 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.

10. Para las actividades intermedias únicamente, escriba los Patrones de correlación queproporcionan el formato de nombre de archivo que determina el ID de correlacióndel nombre de archivo.Por ejemplo, el archivo sam_956d77f734b6d7fb97771be.xml se puede representar(utilizando signos de dólar $ como valores de marcador de posición) comosam_$id$.xml.El valor de marcador de posición $id$ representa el ID de correlación956d77f734b6d7fb97771be.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 $ yfinaliza con el primer carácter no alfanumérico.

Nota: Si el sistema no puede utilizar el campo Patrones de correlación para hacercoincidir los mensajes de solicitud y respuesta, entonces utiliza el ID de correlación yla asignación que se define en el Paso 17.

11. Seleccione una de las Opciones de posprocesamiento siguientes para gestionar elarchivo una vez descargado y procesado.Se puede Archivar o Eliminar el archivo, la carpeta o el archivado.

12. Si ha seleccionado mover el mensaje a una carpeta para archivar en el paso 12,escriba el nombre de la Carpeta para archivar.

13. Escriba el número de Procesadores FTP disponibles.



Éste es el número total de procesadores simultáneos que pueden supervisar losdatos en este punto final. Se basa en el número de conexiones simultáneas admitidaspara el servidor FTP.

Nota: El número de Procesadores FTP debería ser mayor que o igual a 1. Estenúmero asume la existencia de un sondeo, de modo que si está configurando tresprocesadores, introduzca 3 en este campo. Cuando configura su servidor FTP, tendráun total de cuatro conexiones simultáneas.

14. Escriba el número de minutos utilizados como Intervalo de sondeo después del queel sistema compruebe los archivos entrantes.Por ejemplo, si la frecuencia de sondeo se establece en 45, el servidor FTP sondeacada 45 minutos en busca de archivos.

Nota: Si espera recibir archivos grandes, es mejor utilizar un intervalo de sondeomás alto.

15. Haga clic en Siguiente para asignar atributos con origen FTP para procesar atributosde datos.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona


y asignar los atributos con valor de repetición.• Agregar un esquema XML al contenido de la actividad , página 168 proporciona

instrucciones para agregar un esquema XML a una asignación de mensajes.• Asignar atributos de paquete, página 166 proporciona instrucciones para exponer

otros atributos de origen de un paquete que no aparecen actualmente en el árbol.16. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, donde

puede especificar reglas que hagan coincidir los atributos del conjunto de correlacióncon los atributos del mensaje del FTP.Introducción a la correlación de mensajes, página 180 proporciona más informaciónacerca de cómo utilizar los conjuntos de correlaciones para hacer coincidir losmensajes de los orígenes externos con los datos de proceso. Crear los conjuntos decorrelación, página 86 proporciona más información acerca de cómo definir losconjuntos de correlaciones para un proceso.

Nota: El mensaje debe contener datos estructurados para poder asignar los atributosdel conjunto de correlación a los atributos del mensaje.

17. Seleccione el Conjunto de correlación que está asignando en el cuadro de lista de laparte superior de la página y configure las asignaciones para la actividad.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.



Agregar un esquema XML al contenido de la actividad , página 168 proporcionainstrucciones para agregar un esquema XML a una asignación de mensajes.

FTP saliente

Utilice la plantilla de actividad FTP saliente para actividades que lean mensajes de losarchivos. Estas plantillas de actividad son particularmente útiles para procesos queconfían mucho en las transacciones basadas en archivos, como los procesos de auditoríafinancieros.

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 (FTPsobre SSL) y Archivo local.

Nota: Si selecciona Archivo local, omita el paso 5.


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.


5. Escriba la ruta de acceso al equipo de la Carpeta base al que se cargan los archivos.

6. 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. Estearchivo se nombra en tiempo de ejecución basándose en el nombre para archivarque configuró en el asignador de datos y, a continuación, colocó en el directoriode destino..Directorio, que coloca los archivos en subcarpetas basándose en el directoriode destino. El nombre de la subcarpeta se determina en tiempo de ejecuciónbasándose en el nombre del directorio que configura en el asignador de datos.

7. Haga clic en el botón Validar para comprobar que los parámetros de conexión se hanescrito correctamente.

Nota: El botón Validar no está disponible para la opción Archivo local. Debeverificar manualmente que la carpeta base existe en el equipo donde se implementóla plantilla de actividad entrante.



8. Para permitir al sistema sobrescribir un archivo idéntico existente (o una subcarpetasi selecciona Directorio en el paso 6), seleccione Sobrescribir si existe.Si se deja en blanco, el sistema asigna un nombre único al archivo agregando unnúmero incremental al nombre del archivo (o la subcarpeta) y no sobrescribe elarchivo (o la subcarpeta) existente.

9. Haga clic en Siguiente para asignar atributos de datos de proceso a los atributosdel FTP.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



instrucciones para agregar un esquema XML a una asignación de mensajes.• Asignar atributos de paquete, página 166 proporciona instrucciones para exponer

otros atributos de origen de un paquete que no aparecen actualmente en el árbolBasándose en los tipos de archivo que ha elegido, debe completar las siguientesasignaciones:• Si decide cargar los archivos en una subcarpeta, debe asignar los datos de

proceso a la subcarpeta 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 nodo Archivar.• 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 losatributos Nombre del contenido, Tipo de contenido y Datos.

Nota: La asignación del atributo Tipo de contenido determina el modo en el cual setransmiten los datos al servidor FTP. Si se asigna a un texto de cadena, se transmitecomo texto ASCII. Todos los otros archivos se transfieren en modo binario.

Leer FTP

Las actividades basadas en esta plantilla conectan con un servidor FTP y devuelvenarchivos o carpetas de acuerdo con los criterios especificados mediante los datos deproceso. Por ejemplo, un archivo XML entrante puede hacer referencia a un archivo deimagen ubicado en un servidor FTP que debe descargarse. Esta plantilla de actividadrecupera el archivo y lo asocia a la actividad.



Nota: Esta plantilla de actividad se diferencia de FTP entrante en que utiliza los criteriosde búsqueda para recuperar el archivo al crear el elemento de trabajo. FTP entrante sedesencadena cuando se 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 sobreSSL) y Sistema de archivos local.

Nota: Si selecciona Sistema de archivos local, vaya directamente el paso 5.


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. En el campo Carpeta base, escriba la ruta a las carpetas en el servidor FTP que seleerán.

6. 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 de archivado.• Directorio, que permite al sistema obtener varios archivos dentro de una carpeta.

7. Haga clic en el botón Validar para comprobar que los parámetros de conexión y laruta de la carpeta en negrita se han escrito correctamente.

8. Haga clic en Siguiente para proporcionar el patrón o el nombre de archivo o dedirectorio exactos que se obtendrán del servidor FTP.

Asignaciones necesariasEl atributo siguiente debe asignarse a los datos de proceso:• Nombre se debe asignar ya que el servidor FTP emplea la configuración

proporcionada en la página Configuración para buscar el archivo o la carpetaque se ha asignado al atributo.

Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona


y asignar los atributos con valor de repetición.




9. Haga clic en Siguiente para utilizar la herramienta de asignación de datos paraespecificar las reglas que permiten emparejar atributos del archivo descargado condatos de proceso.

HTTP entrante: inicio y procedimiento

Utilice la plantilla de actividad HTTP entrante para recibir y procesar los mensajes HTTPenviados por un cliente externo. Se configura al oyente de HTTP para escuchar un sufijode URL concreto y a continuación, leer y procesar los mensajes entrantes. El mensajeentrante puede asignarse para procesar datos mediante el asignador de datos.

El sistema devuelve a continuación una respuesta sincrónica al cliente utilizando el tipode respuesta que especifica en la plantilla de actividad.

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ónpara requerir un nombre de usuario y una contraseña.

3. Escriba un nombre de usuario y una contraseña requeridos para acceder a laactividad entrante.Este es el valor que el usuario introduce en el cuadro de diálogo de autenticacióndel explorador para acceder a la actividad. La solicitud se envía nuevamente conel nombre de usuario y la contraseña en la solicitud de HTTP. Si se seleccionaautenticación y los parámetros de URL de nombre de usuario y contraseña no se hanenviado, la plantilla de actividad entrante no permitirá el acceso 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 unasolicitud GET.

Nota: Si está utilizando el método GET, los campos utilizados para especificar lainformación de la solicitud no están disponibles.

5. Si la plantilla de actividad es una actividad intermedia, escriba el Nombre depropiedad de correlación.



Este nombre de propiedad de la solicitud HTTP se utiliza para identificar un flujode trabajo. Este atributo aparece en el asignador de datos, ubicado en el nodo delos parámetros URL del nodo del Cuerpo. Este valor debe coincidir con uno de losvalores de nombre de los datos de proceso.

Nota: El nombre de propiedad de correlación es utilizado por el sistema en primerlugar para hacer coincidir la solicitud con los mensajes de respuesta. Si hay valoresde conjunto de correlación asignados, el sistema sólo utiliza esos valores si falla laasignación al nombre de propiedad de correlación.

6. Para incluir anexos en el mensaje de solicitud, seleccione Con anexos. Los anexosestán sólo disponibles 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 Respuestadesde plantilla.

9. Si está utilizando una Plantilla de respuesta, entre en el cuerpo de la respuesta enel cuadro de texto.Puede incluir texto estático, HTML y valores de marcador de posición que se puedenasignar para 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



Nota: Los valores de los marcadores de posición deben ser caracteresalfanuméricos sin espacios. El token del marcador de posición comienza despuésdel signo de dólar $ y finaliza con el primer carácter no alfanumérico.

Por ejemplo, para enviar un mensaje que indique que un pedido se ha procesadocorrectamente, utilice el siguiente texto de plantilla: El pedido de compra $orderno seprocesó correctamente. El marcador de posición, numpedido aparece en la pantallade asignación de datos y puede asignarse a una variable de proceso o paquete. Larespuesta enviada será una página HTML con el mensaje siguiente: El pedido decompra 0896523 se procesó correctamente, donde 0896523 es el valor de sustituciónobtenido de la asignación de datos de respuesta.

Nota: Todos los valores de marcador de posición deben asignarse a los datos deproceso.

10. Haga clic en Siguiente para asignar el mensaje de solicitud de entrada a los datos deproceso.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.





• Agregar las propiedades del mensaje, página 167 proporciona instruccionespara agregar una propiedad específica del servicio a un mensaje para finalizaruna asignación.

• Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol

De acuerdo con los tipos de protocolo que ha seleccionado, complete las siguientesasignaciones:• Los mensajes que utilizan los métodos GET no tienen ningún anexo, por lo

que sólo los atributos para los parámetros URL y los encabezados aparecenen el asignador.

• Los mensajes que utilizan los métodos POST muestran los atributos deasignación para los encabezados, atributos de cuerpo y anexos, si los anexos sehan habilitado en la pantalla anterior.

• Los mensajes que utilizan los métodos PUTmuestran los atributos de asignaciónpara el encabezado y un anexo del cuerpo, si los anexos se han habilitado en lapantalla 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 deestado, encabezado y cuerpo. Cualquier valor de marcador de posición aparece en elasignador de datos y le permite asociar valores para enviar en la respuesta al cliente.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



instrucciones para agregar un esquema XML a una asignación de mensajes.• Agregar las propiedades del mensaje, página 167 proporciona instrucciones

para agregar una propiedad específica del servicio a un mensaje para finalizaruna asignación.


12. Haga clic en Siguiente para utilizar el asignador de datos para asociar los atributosde mensajes de solicitudes al conjunto de correlación que elija en el paso siguiente.



13. Seleccione el Conjunto de correlación que está asignando en el cuadro de lista de laparte superior de la página y configure las asignaciones para la actividad.Introducción a la correlación de mensajes, página 180 proporciona más informaciónacerca de cómo utilizar los conjuntos de correlaciones para hacer coincidir losmensajes de los orígenes externos con los datos de proceso. Crear los conjuntos decorrelación, página 86 proporciona más información acerca de cómo definir losconjuntos de correlaciones para un proceso.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona


y asignar los atributos con valor de repetición.• Agregar las propiedades del mensaje, página 167 proporciona instrucciones


HTTP saliente

La plantilla de actividad HTTP saliente envía una solicitud de HTTP a una URLespecificada y puede recibir una respuesta del servidor. Los campos de la plantilla deactividad le permiten especificar los datos que se pueden asignar al modelo de datos deproceso.

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, queempieza con el prefijo de protocolo http://.

2. Si el servidor requiere autenticación, seleccione Autenticación para requerir unnombre de usuario y una contraseña.

Nota: Sólo se admite la autenticación básica en la plantilla de actividad HTTPsaliente.

3. Escriba unNombre 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 aenviar al servidor.Los valores válidos son GET, POST y PUT.

Nota: Si está utilizando el método GET, los campos utilizados para especificar lainformación de la solicitud no están disponibles.




6. En el campo Tiempo de espera de conexión (minutos), escriba la cantidad deminutos que se permite antes de que el sistema finalice una conexión inactiva.

7. Si desea incluir los 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.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona




• Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbolLos mensajes que utilizan los métodos GET no tienen ningún anexo, por loque sólo los atributos para los parámetros URL y los encabezados aparecenen el asignador.Los mensajes utilizando los métodos POSTmuestran los atributos de asignaciónpara los encabezados, atributos de cuerpo o anexos, si los anexos se hanhabilitado en la pantalla anterior.Los mensajes que utilizan los métodos PUTmuestran los atributos de asignaciónpara el encabezado y un anexo del cuerpo, si los anexos se han habilitado en lapantalla anterior.

9. Haga clic en Siguiente para asignar el mensaje de respuesta a los datos de proceso.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



instrucciones para agregar un esquema XML a una asignación de mensajes.





JMS entrante: inicio y procedimiento

Las plantillas de actividad JMS entrante se utilizan para recibir y procesar los mensajesJMS enviados a una cola o un tema. Por ejemplo, en un flujo de trabajo de procesamientode reclamaciones, se puede configurar una actividad de inicio de JMS para escuchar unacola de reclamaciones. La actividad inicia el flujo de trabajo cuando un mensaje alcanzala cola. El sistema enruta a continuación los datos del mensaje hacia el destino deseado.

Se especifican las opciones de conexión y procesamiento dentro de la plantilla deactividad y se asignan los parámetros del mensaje como encabezados JMS y otraspropiedades a los datos de proceso utilizando 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 accesoal contexto de JNDI (Interfaz de directorios y nombres Java) del servidor demensajería. Las fábricas de contexto para WebSphere, TIBCO y WebLogic estándisponibles 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.

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 lacola 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 altema o a la cola, si es necesario.

e. Escriba una consulta opcional del Selector de mensajes para utilizarla a la horade filtrar los mensajes leídos por el oyente entrante en función del valor de unapropiedad determinada enviada en el mensaje JMS.



Por ejemplo, puede instalar un filtro para una Id. de proveedor determinada quese use en el mensaje y sólo aquellos mensajes con ese Id. de proveedor seránprocesados por esta plantilla de actividad.

f. Seleccione Tipo de mensaje.Los valores válidos sonMessage,MapMessage, TextMessage, BytesMessage,ObjectMessage y StreamMessage.

g. Haga clic en el botón Probar conexión para comprobar que los parámetros deconexión se han escrito correctamente.Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro detexto. Modifique los valores e inténtelo de nuevo.

3. Seleccione Validar esquema para que el sistema compruebe la validez de losesquemas XML en tiempo 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 seestablece siempre en 1.

5. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, dondepuede asignar los datos del mensaje en los datos del proceso para el mensaje deentrada.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



instrucciones para agregar un esquema XML a una asignación de mensajes.• Agregar las propiedades del mensaje, página 167 proporciona instrucciones



6. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, dondepuede asignar datos de mensajes a los conjuntos de correlaciones.

7. Seleccione el Conjunto de correlación que está asignando en el cuadro de lista de laparte superior de la página y configure las asignaciones para la actividad.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.




• Agregar un esquema XML al contenido de la actividad , página 168 proporcionainstrucciones para agregar un esquema XML a una asignación de mensajes.


• Introducción a la correlación de mensajes, página 180 proporciona másinformación acerca de cómo utilizar los conjuntos de correlaciones para hacercoincidir los mensajes de los orígenes externos con los datos de proceso. Crearlos conjuntos de correlación, página 86 proporciona más información acerca decómo definir los conjuntos de correlaciones para un proceso.

JMS Saliente

Utilice la plantilla de actividad JMS saliente para permitir a Process Builder enviarlos mensajes a una aplicación externa y, a continuación, recibir una respuesta de esaaplicación. Esta plantilla puede enviar mensajes XML, mensajes binarios y mensajes enotros 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 accesoal contexto de JNDI (Interfaz de directorios y nombres Java) del servidor demensajería. Las fábricas de contexto para WebSphere, TIBCO y WebLogic estándisponibles 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.

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 lacola 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 altema o a la cola, si es necesario.

e. Seleccione Tipo de mensaje.



Los valores válidos sonMessage,MapMessage, TextMessage, BytesMessage,ObjectMessage y StreamMessage.

f. Haga clic en el botón Probar conexión para comprobar que los parámetros deconexión se han escrito correctamente.Si la conexión es incorrecta, se muestra un mensaje en rojo debajo del cuadro detexto. Modifique los valores e inténtelo de nuevo.

3. Haga clic en Siguiente para mostrar la herramienta de asignación de datos, dondepuede asignar los datos del proceso en los datos del mensaje para el mensaje deentrada.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona





4. Haga clic en Siguiente para asignar los atributos de respuesta de mensaje a losdatos de proceso para el mensaje saliente.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



otros atributos de origen de un paquete que no aparecen actualmente en el árbol

Asignación de datos de procesos

Las actividades basadas en esta plantilla transfieren datos de un paquete del procesocomercial a otro paquete, o desde un atributo de paquete a otro. También puede copiarel contenido de un paquete en 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 procesoen las columnas de la izquierda y la derecha. La columna de la izquierda tambiéncontiene las variables de sustitución de flujos de trabajo.

2. Utilice la herramienta de asignación de datos para transferir valores desde paqueteso datos de ejecución a otros paquetes o atributos de paquete, o para copiar elcontenido del paquete de la columna izquierda a un paquete de la columna derecha.También puede asignar atributos con valores de repetición.Para los objetos del paquete que tienen contenido asociado a ellos, se muestran lossiguientes atributos 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 al contenido.• datos: especifica el contenido en sí.Para copiar contenido en un paquete, los usuarios deben crear reglas de asignaciónpara:• 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 mediante la especificación de un valor constante o mediante la asignaciónde valores desde cualquier nodo de origen.

Los usuarios verán el siguiente error de validación si no se especifican valorespara los nodos de formato o de datos:

No se ha encontrado el tipo de contenido o el formato en las reglas de asignación delpaquete: <paquete de destino>

Puede utilizar cualquiera de las funciones normales disponibles para copiar elcontenido del paquete. Asimismo, puede utilizar las funciones De cadena a byte oDe byte a cadena que admiten la conversión del contenido al tipo de datos Cadena.Consulte Usar las funciones de asignación de datos, página 175 si precisa másinformación sobre estas funciones.Consulte Introducción a la herramienta de asignación de datos, página 163 paraobtener más información sobre el uso de la herramienta de asignación de datosy Usar atributos de repetición, página 174 si necesita más información sobre losatributos con valor de repetición.

3. Haga clic en Aceptar o en Aplicar para guardar la configuración.En tiempo de ejecución, si existe el paquete de destino, el contenido y el formato delpaquete se sustituyen por el contenido y el formato del paquete de origen. Si noexiste el paquete de destino, se creará un paquete nuevo. El contenido del paquetede origen, incluido el tipo de contenido, se copia en el paquete nuevo. Sin embargo,



si el paquete de origen no tiene una asignación de formato o un tipo de contenido, elvalor para el atributo de formato en el paquete de destino se define en crtext y el tipode contenido como text/plain.

SMTP

Utilice la plantilla de actividad de SMTP para enviar mensajes y anexos de correoelectrónico a las listas de usuarios. Por ejemplo, puede agregar una plantilla de actividadque envíe un mensaje de correo electrónico como respuesta a una reclamación de uncliente o enviar un informe de gastos en el cuerpo del mensaje de correo electrónicopara su aprobación.

Para configurar la plantilla de actividad de SMTP:

1. Escriba el nombre del equipo host del servidor SMTP o su dirección IP.

2. Escriba el parámetro que identifica el Número de puerto para el servidor SMTP.Si no proporciona un valor, la actividad utiliza el puerto SMTP 25 estándar.

3. Seleccione Se requiere autenticación si el servidor requiere un nombre de usuario yuna contraseña para la autenticación.

4. Escriba un nombre de usuario y una contraseña si el servidor requiere autenticación.


6. 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 deposición que se puedan asignar a datos de procesos.• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo,







7. Escriba el texto de la plantilla de correo electrónico en el cuadro de texto Plantillade cuerpo.Puede incluir texto estático, HTML copiado de un editor HTML de otro fabricante yparámetros de marcador de posición que se pueden asignar a los datos de proceso.Si está incluyendo formato HTML en el cuerpo del correo electrónico, debe asignarel valor texto/html constante al Contenido-Tipo del nodo Cuerpo del mensajede correo electrónico. Si Contenido-Tipo no está asignado a un valor, el tipo decontenido es texto/llano de forma predeterminada.• Los marcadores de posición se prefijan con un signo de dólar $ (por ejemplo,





8. Haga clic en Siguiente para crear la asignación del mensaje de entrada asociandolos datos de proceso al mensaje de correo electrónico.La estructura del mensaje de correo electrónico aparece en el panel derecho y losdatos de proceso en el lado izquierdo. Puede establecer los valores para los atributosde mensaje de correo electrónico asignándolos desde los atributos del modelo dedatos de proceso. Si tiene varios anexos del correo electrónico, puede hacer clic enAgregar en el nodo Anexo para agregar más anexos.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar yasignar los atributos con valor de repetición.Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol

Nota: Por lo menos uno de los nodos de destinatario (Para, CCO o CC) debeasignarse desde los datos de proceso o desde un valor constante. Además, todos losnodos de marcadores de posición bajo los nodos Asunto y Cuerpo deben asignarseen este punto.

9. Haga clic en Siguiente para asignar el mensaje saliente.



Por ejemplo, si agregó una variable de proceso emailMsgId, puede asignar el atributode Id. de mensaje de correo electrónico del mensaje de origen a esa variable deproceso.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar yasignar los atributos con valor de repetición.Agregar un esquema XML al contenido de la actividad , página 168 proporcionainstrucciones para agregar un esquema XML a una asignación de mensajes.Agregar las propiedades del mensaje, página 167 proporciona instrucciones paraagregar una propiedad específica del servicio a un mensaje para finalizar unaasignación.Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol

Abrir proceso

La actividad Invocar proceso inicia un flujo de trabajo nuevo. La actividad se completarácuando se inicie el nuevo flujo de trabajo.

Aunque el nuevo flujo de trabajo es un subproceso lógico del flujo de trabajo que loinicia, no hay ninguna relación formal entre los objetos de ambos flujos de trabajo, queson independientes. Si desea hacer una pausa en el flujo de trabajo actual hasta quese complete el proceso, defina la siguiente actividad para que se desencadene comorespuesta a un evento (en la ficha Desencadenador) e incluya una actividad en el otroproceso, basada en la plantilla de actividad Publicar evento en proceso padre, que envíeel evento que espera el proceso principal.

Antes de configurar una actividad Invoke Process (Abrir proceso), deberá seleccionarprimero el usuario 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 paquetesobligatorios de la plantilla seleccionada deben coincidir con los paquetes del flujo detrabajo actual tanto en nombre como en tipo. La coincidencia se aplica a todos lospaquetes definidos, no sólo a los visibles.

3. Seleccione una actividad del cuadro de lista Iniciar actividad o elija Iniciar todas lasactividades.



A continuación se iniciará la actividad seleccionada del proceso nuevo o se iniciarántodas las actividades del proceso con el mismo ID de flujo de trabajo.


5. Si el proceso hijo tiene paquetes, proporcione valores para los paquetes mediantela herramienta de asignación de datos.En la pantalla Asignación de mensaje de entrada, la columna izquierda de laherramienta de asignación de datos muestra los paquetes del proceso principal. Lacolumna derecha muestra los paquetes del proceso hijo. Si hay más de un paqueteen el proceso, debe asignar los paquetes obligatorios que se muestran en negrita.En caso contrario, se producirá un error. La columna derecha también muestra elatributo Supervisor. El valor de este atributo debe ser el tipo de datos de 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 unsupertipo de los paquetes del flujo de trabajo principal. Consulte Introducción a laherramienta de asignación de datos, página 163 para obtener información detalladasobre el uso de la herramienta de asignación de datos.


7. Utilice la herramienta de asignación de datos para guardar los valores de salidacomo valores de atributo de paquete.En la pantalla Asignación de mensaje de salida, la columna izquierda de laherramienta de asignació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 confines de control o auditoría. La columna derecha muestra los atributos de paquetedel proceso principal.Consulte Introducción a la herramienta de asignación de datos, página 163 paraobtener información detallada sobre el uso de la herramienta de asignación de datos.


Servicio Web

Esta plantilla de actividad le permite invocar los servicios Web con el estilo literal dedocumento. Las actividades de Servicios Web se diferencian de las demás actividades deintegración en dos aspectos principales:

• El contenido que se envía al servicio Web debe ser un archivo XML bien formado quesea autosuficiente en espacio de nombres.

• Los servicios Web responden a los mensajes que reciben, por lo que la actividadnecesita poder gestionar una respuesta.



Para invocar un servicio Web, debe disponer de un documento WSDL (Web ServicesDescription Language) que proporcione la información necesaria para acceder alservicio. Los parámetros personalizados de las actividades del Servicio Web identificanel documento WSDL y el contenido XML que se enviará al servicio. También especificancómo gestionar la respuesta del servicio Web.

• Documento WSDL: este parámetro obligatorio señala a un archivo que incluye elcontenido WSDL para el servicio Web. Este archivo debe ser un documento WSDLbien formado almacenado en el repositorio. Para desplazarse al archivo, debe hacerclic en el botón que aparece junto al cuadro de texto.

• Nombre del servicio: en muchos casos, el documento WSDL incluye el nombredel servicio Web que invocará la actividad. Si no es así, o si el documento WSDLcontiene más de una definición de servicio, necesita escribir el nombre del servicioWeb en este parámetro, que de otro modo, es opcional.

• Nombre de la operación: este parámetro obligatorio especifica el nombre de laoperación del servicio Web que se invocará.

• Nombre del puerto: debe escribir el nombre del puerto para el servicio deseado si eldocumento WSDL no lo proporciona o si incluye varios nombres de puerto.

• Enviar contenido del paquete de actividad: este parámetro opcional identifica quécontenido pasa la actividad al servicioWeb. El contenido debe ser XML bien formadoque sea autosuficiente en espacio de nombres. El valor del parámetro es el nombrede uno de los paquetes entrantes de la actividad. Si no proporciona un valor, laactividad 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 actividadguarda la respuesta del servicio Web como un documento XML. Los siguientesparámetros especifican el nombre del documento y dónde se guardará en elrepositorio. Si define esta opción como No, los restantes parámetros no sonrelevantes.

• Guardar respuesta en la carpeta: si ha decidido guardar la respuesta del servicioWeb, este parámetro especifica la carpeta del repositorio en la que la actividadguarda el documento XML. La ubicación predeterminada es /Temp.

• Nombre del documento de respuesta: si ha decidido guardar la respuesta del servicioWeb, este parámetro especifica el nombre dado al documento XML. Si no escribe unnombre, la actividad crea uno utilizando el nombre del servicio Web seguido de lapalabra "Respuesta" y la fecha y hora de la respuesta.

• Adjuntar documento de respuesta al paquete: si ha decidido guardar la respuestadel servicio Web, este parámetro especifica el paquete saliente al que se agrega eldocumento XML. Al agregar el documento a un paquete saliente, la actividad haceque se reenvíe a la siguiente actividad en el flujo de trabajo. Si no escribe el nombrede un paquete saliente válido, el documento XML no se reenvía.



Servicio Web entrante: inicio y procedimientoNota: Sólo Documentum Process Builder versión 6.5 admite esta plantilla de actividad.Si se utiliza una versión anterior de Process Builder con un repositorio Documentum 6.5,esta plantilla no se abrirá.

Utilice Web Service Inbound (Servicio Web entrante) para crear un nuevo punto final delos servicios Web para una actividad que necesita proporcionar un punto de integracióny un WSDL a un sistema externo.

Por ejemplo, podría utilizar la plantilla de actividad Servicio Web entrante en un procesode aplicación de préstamos para iniciar el proceso después de recibir una aplicación deentrada. Puede preparar la actividad con WS-Security para requerir que el solicitanteproporcione un nombre de usuario y una contraseña para asegurar el servicio Web. Si laaplicación de préstamos incluye documentos grandes, puede habilitar la compatibilidadcon MTOM para la actividad que permitirá a la actividad enviar y recibir datos binariosoptimizados como anexos.

Como un paso en un proceso, la actividad Servicio Web entrante: procedimiento sepuede utilizar para recibir información desde un origen externo. La actividad tambiénse puede utilizar para comprobar los ingresos o recibir otra información relacionadadesde un origen externo. Puede habilitar la seguridad para asegurarse de que sólo laspersonas autorizadas pueden iniciar el proceso.

Puede habilitar la correlación de mensajes utilizando un identificador de correlación quesea un ID único generado para cada flujo de trabajo. Este ID de correlación se debeagregar al encabezado SOAP con 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 desde la definición de proceso. El sistema crea un WSDL para un proceso,con una sección para cada actividad de servicio Web entrante contenida en el mismo.

Nota: El WSDL generado sólo puede contener las variables de proceso asociadas ala actividad si se han marcado como visibles para esa actividad en el Inspector deactividades. Cambiar datos de proceso en una actividad, página 158 proporcionainstrucciones sobre cómo hacer que una variable de proceso sea visible para unaactividad.

• En la opciónWSDL primero, se especifica un WSDL existente para que el sistemalo utilice en el proceso.

Nota: Antes de agregar una actividad de servicio Web entrante a un proceso, configureel URI del espacio de nombres de destino en la ficha Avanzada del cuadro de diálogo



Propiedades de proceso. El sistema no puede validar ni guardar el proceso sin el espaciode nombres de destino.

Un tipo de datos estructurado creado mediante la importación de un esquema XMLpuede no tener definido el espacio de nombres de destino. Para utilizar este tipo de datosestructurado en un modelo Procesar 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 espacio de nombres de destino en el esquema utilizado para crear el tipode datos estructurado.

• Si el tipo de datos estructurado no está en uso, edite el esquema para definir unespacio de nombres de 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 (ServicioWeb entrante).

2. Si selecciona la opción para usar Procesar primero, se describe un proceso en laplantilla de actividad y, una vez cargado, el sistema crea un WSDL a partir de ladefinició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 sistemacorrelacione los mensajes basándose en el conjunto de correlaciones.

d. En la lista Conjunto de correlación, seleccione un nombre de conjunto decorrelación.

Nota: El modelo Procesar primero no requiere la asignación de los datos y elconjunto de correlación, ya que la asignación se realiza implícitamente.

3. Para utilizar un WSDL existente para definir el servicio Web, seleccioneWSDLprimero.

a. EscribaWSDL File URL/Path (Ruta/URL de archivo WSDL) al WSDL utilizadopara la actividad.

b. Haga clic en Leer para recuperar elWSDL 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 Nombrede usuario de WS-Security), active la casilla de verificación y escriba el nombre deusuario y la contraseña.El controlador de WS-Security proporciona el acceso basado en credenciales a laactividad o proceso (cuando se utiliza en una actividad de inicio). Cuando se



activa, todas las solicitudes del cliente a esta actividad deben contener las mismascredenciales en el encabezado de solicitud (en la estructura definida por el esquemade WS-Security para UserTokens) que se va a conceder el acceso a la actividad oproceso.

5. SeleccioneMTOM para permitir que el sistema optimice cualquier anexo mientrasse envía la respuesta.

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 asociandolos datos de proceso al mensaje.La estructura del mensaje SOAP aparece en el panel izquierdo y los datos de procesoen el lado derecho. Puede establecer los valores para los atributos del modelo dedatos de proceso asignándolos desde los atributos del mensaje SOAP.

Asignaciones necesariasLas 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 agregarmás anexos.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar yasignar los atributos con valor de repetición.Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol

7. Haga clic en Siguiente para asignar el mensaje saliente.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.Usar los identificadores de correlación, página 180 proporciona más informaciónacerca de cómo definir conjuntos de correlaciones para un proceso.Introducción a la herramienta de asignación de datos, página 163 proporcionaprocedimientos para utilizar la herramienta de asignación de datos.Usar atributos de repetición, página 174 proporciona detalles sobre cómo agregar yasignar los atributos con valor de repetición.Agregar un esquema XML al contenido de la actividad , página 168 proporcionainstrucciones para agregar un esquema XML a una asignación de mensajes.



Agregar las propiedades del mensaje, página 167 proporciona instrucciones paraagregar una propiedad específica del servicio a un mensaje para finalizar unaasignación.Asignar atributos de paquete, página 166 proporciona instrucciones para exponerotros atributos de origen de un paquete que no aparecen actualmente en el árbol

Documento de xPression Publish

Utilice la plantilla de actividad de xPression Publish para generar un nuevo documento apartir de una plantilla de documento de Document Sciences xPression sirviéndose dedatos de proceso y asígnela a continuación a un paquete o un anexo. Las variables sesustituyen por datos de proceso al publicar el documento.

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 servidorde 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 unalista de las categorí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ánen 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,correo electrónico, archivo o formatos basados en Web.

7. Haga clic en Siguiente para asignar los datos de proceso a las variables deldocumento de entrada.Las variables del documento se basan en el tipo de documento.

Asignaciones necesariasDebe asignar todas las variables requeridas por el servidor de xPression paracompletar el servicio de publicación. En tiempo de ejecución, las variables sesustituyen por datos de proceso en el documento generado.Si emplea documentos de xPresso, asegúrese de que sólo aparezcan en el asignadorde datos variables utilizadas en el proceso.



En los documentos de xDesign, sólo aparecen en el asignador variables utilizadas enel proceso. Asegúrese de que la clave principal esté asignada.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



otros atributos de origen de un paquete que no aparecen actualmente en el árbol.8. Haga clic en Siguiente para asignar el documento de salida a un paquete o anexo, si

el perfil de documento proporciona un documento de salida.Asignaciones necesarias

Los 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 salida está definido para que se publique un archivo PDF, este atributose debe asignar al formato de paquete o anexo correspondiente.

• datos es el documento generado, el cual se debe asignar al atributocorrespondiente de un paquete o bien de un anexo.

Documento de xPression Publish: Avanzada

Utilice la plantilla de actividad Documento de xPression Publish: Avanzada cuandohaya muchos valores constantes que deban asignarse a los datos de proceso. En vez deusar el asignador de datos para asignar cada variable, puede escribir el XML que crealas asignaciones para las constantes y agrega marcadores de posición para los datosdinámicos. A continuación puede utilizar el asignador de datos para asignar únicamentelos valores de marcador de posición creados por el XML.

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 servidorde 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 unalista de las categorí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ánen 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,correo electrónico, archivo o formatos basados en Web.

7. Escriba el XML de datos de cliente que crea las asignaciones para las constantes yagrega marcadores de posición para los valores dinámicos.En los documentos de xPression, la información sobre el cliente que contiene esteXML sirve para personalizar el documento durante el proceso de publicación. ElXML de este cuadro de texto debe constar de texto estático y valores de marcador deposición para el contenido dinámico que 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



Nota: Los valores de los marcadores de posición deben ser caracteresalfanuméricos sin espacios. El token del marcador de posición comienza despuésdel signo de dólar $ y finaliza con el primer carácter no alfanumérico.

El siguiente ejemplo de código muestra el XML de datos de cliente correspondientea una solicitud de presentación de historiales médicos. El número de solicitud, lafecha de la solicitud y el número de teléfono son todas las variables que se debenasignar 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>

Nota: como las variables deben ser cadenas de texto, los valores de fecha y hora setienen que convertir a ese tipo con la función DateToString del asignador de datos.(El formato de fecha que procede de los datos de proceso y el formato de fecha delXSD que espera el servidor de xPression pueden ser diferentes).

En el anterior ejemplo, si requestDate es del tipo dateTime de XSD, use la siguientecadena de texto 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 12. Formatos requeridos

Tipo de XSD Formato

fecha yyyy-MM-dd

dateTime 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 deldocumento de entrada que eran valores de marcador de posición en el XML.

Nota: Los valores constantes agregados mediante el cuadro de texto XML de datosde cliente no aparecen en el asignador de datos.

Asignaciones necesariasDebe asignar valores para las variables proporcionadas en el cuadro de texto XMLde datos de cliente.Puede considerar que necesita agregar atributos o elementos a algunos datos paracompletar las asignaciones.• Introducción a la herramienta de asignación de datos, página 163 proporciona



otros atributos de origen de un paquete que no aparecen actualmente en el árbol.9. Haga clic en Siguiente para asignar el documento de salida a un paquete o anexo, si

el perfil de documento proporciona un documento de salida.Asignaciones necesarias

Los atributos siguientes deben asignarse a los datos de proceso:• nombre comprende el nombre del documento y el tiempo en milisegundos.• formato es el tipo de formato definido en el perfil de salida.



• datos es el contenido generado.

Ejemplo

La ventana Ejemplo contiene una plantilla de actividad de ejemplo que muestra losdiferentes tipos de controles de interfaz de usuario disponibles para los paneles deentrada de datos de actividad personalizados. Además de la plantilla de actividad deejemplo, la ventana Ejemplo incluye dos plantillas de actividad relacionadas con lagestión de colas:

• Plantilla de actividad de ejemplo, página 272• Definir habilidad para tarea de cola, página 272• Decisión de repasar tarea de la cola, página 273Consulte la guía Documentum Webtop User Guide para obtener más información sobrela gestión de colas.

Plantilla de actividad de ejemplo

Process Builder incluye también una plantilla de actividad de ejemplo que muestra elformato del archivo XML de una plantilla de actividad a fin de que le sirva de ayudapara crear plantillas de actividades personalizadas y aparece en la carpeta de plantillasde actividades de ejemplo. Documentum Process Builder Development Guide proporcionainformación detallada sobre cómo utilizar 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 delejecutante para un determinado paquete. Este valor del nivel de habilidad anulacualquier otro requisito anterior sobre el nivel de habilidad para el paquete.

En una situación normal, la actividad que precede a la actividad de Definir habilidadpara tarea de cola tiene una condición de transición que comprueba los atributos delpaquete para determinar si éste requiere un tratamiento especial. Los paquetes querequieren un tratamiento especial se distribuyen a la actividad de Definir habilidad paratarea de cola, mientras que todos los demás omiten esta actividad.

• Nombre de paquete: nombre del paquete para el que la actividad establece el nivelde habilidad del ejecutante requerido.



• Nivel de habilidad: nivel de habilidad para aplicar al paquete. Los valores válidosaparecen en un cuadro de lista.

Decisión de repasar tarea de la cola

Esta plantilla de actividad de ejemplo se utiliza para crear actividades que realicencontroles de calidad periódicos sobre los documentos procesados mediante una colade trabajo. La definición de una cola de trabajo incluye una política que especifica unporcentaje de documentos que se deben distribuir a otro procesador para el controlde calidad.

Al igual que la plantilla de actividad Decision Split (División de la decisión), la plantillaDecisión de repasar tarea de la cola crea actividades cuya única acción consiste en evaluarla lógica de ramificaciones y reenviar los paquetes según corresponda. Una actividadbasada en la plantilla Decisión de repasar tarea de la cola distribuye los paquetes a lasiguiente actividad de revisión o a la siguiente actividad sin revisión. Determina a quéactividad se distribuye cada paquete basándose en dos factores: (a) el control de calidadporcentual especificado en la política de cola de trabajo asociada a la actividad paracomprobar, y (b) el parámetro de nivel de habilidad necesario.

• Actividad para comprobar: este parámetro obligatorio especifica la actividad querealiza el procesamiento inicial de los documentos. El tipo de ejecutante de estaactividad debe tener la categoría 10 (cola de trabajo). Introduzca el nombre dela actividad.

• Nivel de habilidad necesario: el nivel de habilidad de los ejecutantes cuyo trabajose debería comprobar. 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 especificala actividad que realiza el control de calidad. Introduzca el nombre de la actividad.

• Nombre de la siguiente actividad sin revisión: este parámetro obligatorio especificala actividad a la que se distribuirán los documentos que no precisan control decalidad. Introduzca el nombre de 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 se distribuye a la siguiente actividad sin revisión.

2. Si el ejecutante que gestionó este paquete en la actividad para comprobar tiene unnivel de habilidad inferior al valor del parámetro del nivel de habilidad necesario, elpaquete se distribuye a la siguiente actividad de revisión.

3. Todos los paquetes restantes se distribuyen a la siguiente actividad de revisión ysiguiente actividad sin revisión en el porcentaje especificado por el valor del control



de calidad porcentual. Por ejemplo, si el control de calidad porcentual es 20%, unode cada cinco documentos se distribuye a la siguiente actividad de revisión.

Plantillas de actividad no admitidas

Las plantillas de actividad de la siguiente sección ya no se entregan con Process Builder.Se han reemplazado por plantillas de actividad que tienen funciones mejoradas. Lasnuevas plantillas de actividad proporcionan una interfaz similar a la de un asistente paradefinir la transferencia de datos, incluyendo una herrameinta de asignación de datosgráficos para especificar cómo se intercambian datos entre los orígenes de datos. Estasplantillas de actividad suministradas permiten el uso ininterrumpido de la funcionalidadde mensajería de Process Integrator desde Process Builder y requieren una configuraciónmínima sin desarrollo o procesamiento personalizados.

Esta sección es idónea para aquellos clientes que todavía están utilizando los procesosde las versiones anteriores (5.3x o anteriores) que contienen las plantillas de actividadmás antiguas.

Nota: Estas plantillas se instalan como parte de los archivos BPM.dar y requieren lainstalación de Process Integrator. En la guía Process Integrator Activity Template 6.5Migration Guide se ofrece información detallada sobre la compatibilidad con versionesanteriores de las plantillas de actividad obsoletas.

Iniciar subproceso

La actividad Invocar proceso inicia un flujo de trabajo nuevo. Todos los paquetes delflujo de trabajo actual cuyos nombres y tipos coincidan con los paquetes de la plantillade proceso del nuevo flujo de trabajo se pasarán al nuevo flujo de trabajo. La actividadse completará cuando se inicie el nuevo flujo de trabajo.

Aunque el nuevo flujo de trabajo es un subproceso lógico del flujo de trabajo que loinicia, no hay ninguna relación formal entre los objetos de ambos flujos de trabajo, sonindependientes. Si desea pausar el flujo de trabajo actual hasta que se complete elsubproceso, defina la siguiente actividad para que se desencadene como respuesta a unevento (en la ficha Desencadenador) e incluya una actividad en el subproceso, basadaen la plantilla de actividad Publicar evento en proceso padre, que envíe el evento queespera el proceso principal.• Iniciar este flujo de trabajo como subproceso: en el cuadro de lista, seleccione la

plantilla de proceso que se utilizará para el nuevo flujo de trabajo. Los paquetesobligatorios de la plantilla seleccionada deben coincidir con los paquetes del flujo detrabajo actual tanto en nombre como en tipo. La coincidencia se aplica a todos lospaquetes definidos, no sólo a los visibles.



• Supervisor del subproceso: seleccione al usuario que actuará como supervisor delnuevo flujo de trabajo.

SMTP

Esta plantilla de actividad se utiliza para enviar contenido a través del correo electrónico.Sus parámetros definen el contenido del mensaje, la dirección a la que se envía y elservidor SMTP usado para enviar el correo.

Cuando se envía contenido con el correo, los archivos de contenido se entregan comoanexos del mensaje.

• Para: este parámetro obligatorio es la dirección de correo electrónico deldestinatario, que incluye tanto el nombre de usuario como el nombre del dominio(usuario@dominio). Puede incluir varios destinatarios separados por comas.

Haga clic en el botón de punto suspensivo (...) para mostrar el Cuadro de diálogoVariable de sustitución y elegir las variables en tiempo de ejecución.

• CC y CCO: estos parámetros opcionales muestran los destinatarios adicionales delmensaje de correo 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 en el campo De del mensaje enviado.

• Responder a: la dirección a la que se envían las respuestas a este mensaje. Utiliceeste parámetro para dar formato a la dirección de respuesta, de modo que se dirijacorrectamente a un gestor de mensajes de Process Integrator. Normalmente, ladirección de respuesta incluye variables que el servidor sustituirá en tiempo deejecución, como por ejemplo, el ID de flujo de trabajo actual. Apéndice B, Variablesde sustitución para las propiedades de plantillas de actividades personalizadasproporciona información detallada sobre este tema.

• Asunto: el texto que se introduce para este parámetro se muestra como la línea deasunto del mensaje enviado. Si se deja en blanco, el mensaje se entrega con unalínea de asunto vacía.

• Nombre de host del servidor SMTP o IP: este parámetro obligatorio identifica elservidor SMTP usado para enviar el mensaje. Puede escribir el nombre del equipohost o su dirección IP.

• Número de puerto del servidor SMTP: este parámetro opcional identifica el númerode puerto del servidor SMTP. Si no proporciona un valor, la actividad utiliza elpuerto SMTP 25 estándar.

• Nombre de usuario de autenticación del servidor SMTP y Contraseña deautenticación del servidor SMTP: si el servidor SMTP solicita un nombre de usuarioy una contraseña, deberá proporcionarlos.



• Adjuntar contenido desde los paquetes de actividad: este parámetro opcionalidentifica qué contenido incluye la actividad como anexos al mensaje de correoelectrónico. El valor son los nombres de uno o varios paquetes entrantes de laactividad, separados por comas. Si no proporciona un valor, la actividad envía elcontenido del primer paquete entrante (el paquete en el índice 0).

• Anexar todo el contenido de los paquetes de carpeta: si alguno de los paquetesque se envían contienen objetos de carpeta, la actividad puede enviar todos losdocumentos de la carpeta (Sí) u omitirla (No). Si hace clic en Sí, la actividad anexadirectamente sólo dichos documentos dentro de la carpeta. No anexa de formarecursiva los documentos de ninguna otra subcarpeta.

• Anexar la URL a los documentos del mensaje: permite mostrar la URL como partedel cuerpo del mensaje de correo electrónico.

• Anexar la URL a los paquetes de actividad del mensaje: permite a un usuarioagregar paquetes y mostrar la URL correspondiente en el cuerpo del mensaje decorreo electrónico.

• Anexar la URL a los anexos de flujo de trabajo del mensaje: permite a un usuarioagregar una URL de anexo en el cuerpo del mensaje de correo electrónico.

• Utilizar la URL predeterminada a Webtop: seleccioneNo para permitir a los usuariosutilizar una URL distinta de la URL de Webtop predeterminada.

• Proporcionar el prefijo de la URL si no utiliza el predeterminado: si no utiliza la URLde Webtop predeterminada, escriba el prefijo de la URL que se va a utilizar en elcuerpo del mensaje de correo electrónico.

• Proporcionar el sufijo de la URL si no utiliza el predeterminado: si no utiliza la URLde Webtop predeterminada, escriba el sufijo de la URL que se va a utilizar en elcuerpo del mensaje de correo electrónico.

Publicar en el tema de JMS

Puede enviar contenido mediante Java Message Service (JMS) de dos formas: enviándoloa una cola de JMS o publicándolo en un tema de JMS. Utilice esta plantilla de actividadpara crear actividades que publican el contenido en los temas de JMS.

• Clase de fábrica de contexto inicial de JNDI: este parámetro obligatorio proporcionaun nombre de clase 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 URLcompleta para conectarse al proveedor de JMS.

• Nombre JNDI de la fábrica de conexiones de temas: este parámetro obligatorioofrece el nombre JNDI de la fábrica de conexiones de temas para el proveedor JMSespecificado.

• Nombre del tema: este parámetro obligatorio proporciona el nombre del tema en elque desea publicar el contenido.



• Publicar contenido del paquete de actividades: este parámetro opcional identificaqué contenido envía la actividad a la dirección URL especificada. El valor es elnombre de uno de los paquetes entrantes de la actividad. Si no proporciona un valor,la actividad envía el contenido del primer paquete entrante (el paquete en el índice0). Puede enviar el contenido de un único paquete.

FTP

La plantilla de actividad FTP se utiliza para enviar contenido a un sitio FTP odirectamente a un sistema de archivos.

• Protocolo: este cuadro de lista muestra los protocolos disponibles para el envíodel contenido. Los protocolos 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á elcontenido.

• Puerto: número de puerto en el que escucha el servidor FTP.• Nombre de usuario del servidor FTP: nombre de usuario para conectarse al servidor

FTP.• Contraseña del servidor FTP: contraseña para el 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 Zipque contiene todo el contenido y lo coloca en el directorio remoto especificado.Cuando selecciona Crear subdirectorio, la actividad crea un subdirectorio único enel directorio remoto especificado y coloca todo el contenido en el subdirectorio.Cuando selecciona Todos los paquetes en directorio base, el contenido se coloca en eldirectorio remoto especificado.

• Adjuntar contenido desde los paquetes de actividad: este parámetro opcionalidentifica qué contenido envía la actividad a la ubicación especificada. El valor es elnombre de uno o varios de los paquetes entrantes de la actividad. Si no proporcionaun valor, la actividad envía el contenido del primer paquete entrante (el paqueteen el índice 0).

• Nombre del archivo o directorio: si ha elegido Archivar o Crear subdirectorio comoel modo de transferencia, la actividad utiliza el valor de este campo para asignarun nombre al archivo ZIP o subdirectorio. Cuando proporciona un nombre dedirectorio, generalmente deseará incluir una variable de sustitución en el nombre,como por ejemplo el ID del flujo de trabajo, con el fin de que la actividad cree unsubdirectorio único para cada flujo de trabajo.



• Sobrescribir contenido de carpeta: seleccione si desea sobrescribir o no los archivoso carpetas existentes en el directorio base del servidor FTP con los que se van atransferir.

Buzón HTTP

La plantilla de actividad para enviar contenido mediante HTTP es la más sencilla de lasplantillas de actividades de integración. Tiene un parámetro personalizado obligatorio ydos parámetros opcionales.

• URL: este parámetro obligatorio es la dirección URL completa del sitio al que laactividad envía contenido, que empieza con el prefijo de protocolo http://.

• Tiempo de espera (seg.): este parámetro opcional define el valor del tiempo de esperapara la conexión HTTP, en segundos. Si no incluye este valor o lo define como 0, laconexión no tendrá un límite.

• Enviar contenido del paquete de actividad: este parámetro opcional identifica quécontenido envía la actividad a la dirección URL especificada. El valor es el nombrede uno de los paquetes entrantes de la actividad. Si no proporciona un valor, laactividad envía el contenido del primer paquete entrante (el paquete en el índice 0).Sólo se puede enviar el contenido de un paquete.

Enviar a la cola de JMS

Puede enviar contenido mediante Java Message Service (JMS) de dos formas: enviándoloa una cola de JMS o publicándolo en un tema de JMS. Utilice esta plantilla de actividadpara crear actividades que se envíen a colas de JMS. Publicar en el tema de JMS, página276 proporciona información sobre la forma de publicar temas de JMS.

Nota: Utilice Enviar a MQ JMS, página 279 para enviar mensajes a una cola cuando IBMMQ Series sea el proveedor JMS.

• Clase de fábrica de contexto inicial de JNDI: este parámetro obligatorio proporcionaun nombre de clase 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 URLcompleta para conectarse al proveedor de JMS.

• Nombre JNDI de la fábrica de conexiones de colas: este parámetro obligatorioofrece el nombre JNDI de la fábrica de conexiones de colas para el proveedor deJMS especificado.

• Nombre de cola: este parámetro obligatorio proporciona el nombre de la cola a laque desea enviar el contenido.



• Responder al nombre de cola: este parámetro opcional proporciona el nombre de lacola de JMS a la que se envía cualquier mensaje de respuesta.

• ID de correlación de mensajes: Process Integrator permite especificar la manera enla que se gestionarán los mensajes entrantes. El ID de correlación de mensajes es elID que utilizará Process Integrator para identificar mensajes de respuesta a estemensaje saliente.

• Enviar contenido del paquete de actividad: este parámetro opcional identifica quécontenido envía la actividad a la dirección URL especificada. El valor es el nombrede uno de los paquetes entrantes de la actividad. Si no proporciona un valor, laactividad 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) con IBM MQ Series como proveedor JMS. Se requieren todos los parámetros.

Nota: Utilice Enviar a la cola de JMS, página 278 para enviar mensajes a una cola JMScon un proveedor JMS que no sea IBM MQ Series.

• Servidor: dirección IP o nombre descriptivo del equipo en el que se ejecutaWebSphere MQ.

• Puerto: puerto en el que escucha el gestor de cola. El número predeterminado es1414.

• 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 debe gestionarla el gestor de cola especificado. El nombre de la colatiene la forma WQ_nombrecola. Para localizar el nombre de la cola nombrecola,seleccione Servers (Servidores) > Application Servers (Servidores de aplicaciones)> nombreservidor > Server Component (Componente de servidor) > Queue names(Nombres de cola) en WebSphere MQ.

• Nombre de canal: el nombre de la conexión de servidor cambiada que se crea enWebSphere MQ para conectar a MQ.

• Solicitar paquete: este parámetro identifica el contenido que la actividad envía ala cola especificada. El valor es el nombre de uno de los paquetes entrantes de laactividad. 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 ovarios paquetes del proceso comercial. Un ciclo de vida define una serie ordenada deestados que corresponden a las fases de la vida de un documento.

Para configurar una actividad de Aplicar ciclo de vida, debe elegir el ciclo de vida quedesea aplicar y los paquetes a los que se aplicará. Asimismo, debe especificar el estadoinicial del ciclo de vida y el alcance que se utilizará cuando se resuelvan alias asociadosal ciclo de vida. Consulte la guía Documentum Composer User Guide si precisa informacióndetallada sobre la creación y el uso de los ciclos de vida.

• Paquetes a los que se aplicará el ciclo de vida: haga clic en el botón ... para mostrarun cuadro de diálogo en el que podrá seleccionar los paquetes de proceso a losque se aplicará el ciclo de vida. Para cada paquete al que desee aplicar el ciclo devida, resalte el nombre del mismo en la lista de la izquierda y haga clic en el botónAgregar 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 seleccionadosaparecerán en el campo de datos.

• Ciclo de vida: en el cuadro de lista, elija el ciclo de vida que desea aplicar a lospaquetes seleccionados.

• Estado inicial: escriba el nombre del estado del ciclo de vida en el que se colocaránlos paquetes seleccionados.

• Alcance: seleccione el alcance que se utilizará para resolver los alias asociadosal ciclo de vida elegido.

Vuelta al estado anterior del ciclo de vida

Las actividades basadas en esta plantilla vuelven uno o varios paquetes a un estadoanterior en el ciclo de vida asociado. Puede volver los paquetes al estado original (elprimero de la lista ordenada) o a cualquier estado anterior que identifique mediante elnombre.

• Paquetes para volver al estado anterior: haga clic en el botón ... para mostrar uncuadro de diálogo en el que podrá seleccionar los paquetes de proceso que deseadevolver a un estado de ciclo de vida anterior. Para cada paquete que desee volver aun estado anterior, resalte el nombre del mismo en la lista de la izquierda y haga clicen el botón Agregar para moverlo a la lista de paquetes seleccionados de 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.



• Volver al estado: para devolver los paquetes seleccionados a un estado específico,escriba el nombre del estado en este campo. Si deja este espacio en blanco, sedevuelve al estado anterior.

• Volver al estado original: para devolver los paquetes seleccionados al estado originaldel ciclo de vida, seleccione la opción Sí.

Promoción de ciclo de vida

Las actividades basadas en esta plantilla promueven uno o varios paquetes a un estadoposterior en el ciclo de vida asociado.

• Paquetes para promover: haga clic en el botón ... para mostrar un cuadro de diálogoen el que podrá seleccionar los paquetes de proceso que desea promover a un estadode ciclo de vida posterior. Para cada paquete que desee promover, resalte el nombredel mismo en la lista de la izquierda y haga clic en el botónAgregar para moverlo a lalista de paquetes seleccionados de la derecha. Al hacer clic enAceptar en el cuadro dediálogo, los nombres de los paquetes seleccionados aparecerán en el campo de datos.

• Promover al estado: escriba el nombre del estado de ciclo de vida al que deseapromover los paquetes seleccionados. Si se deja en blanco, el paquete se devuelveal estado anterior.

• Forzar promoción: cada estado del ciclo de vida tiene un conjunto de criterios deentrada que normalmente un documento debe cumplir para poder promoverse adicho estado. Sin embargo, la plantilla de actividad Promoción de ciclo de vidapermite "forzar" la promoción de un paquete aunque no cumpla los criterios deentrada del estado. Seleccione la opción Sí para promover los paquetes seleccionadosindependientemente de que cumplan los criterios de entrada del estado.

BAM

La plantilla de actividad Punto de observación de la carpeta BAM ofrece un métodopara la publicación de los datos empresariales incluidos en paquetes desde ProcessBuilder a la base de datos ProActivity. Estos datos quedan disponibles para ReportManager, donde los diseñadores de informes pueden crear informes de BAM basadosen los datos de paquete.



Punto de observación

Esta plantilla de actividad permite seleccionar los paquetes asociados a una actividadespecífica y publicar los datos empresariales en Process Analyzer para utilizarlos en losinformes. Las actividades seguidas de una plantilla de actividad Punto de observaciónpueden publicar datos de paquete en Process Analyzer.

En tiempo de ejecución, la actividad Punto de observación inserta algunos atributosestándar y todos los atributos personalizados en la tabla de seguimiento de auditoría,donde el trabajo Workflow Publish Events (Eventos de publicación de flujo de trabajo)recopila los datos y los publica en Process Analyzer. En la lista siguiente se muestran losatributos estándar que se publican como parte de cualquier definició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 paraque el trabajo Workflow Publish Events (Eventos de publicación del flujo de trabajo)publique los datos del paquete.

Consulte Definir propiedades de la plantilla de proceso, página 73 si necesita másinformación sobre la habilitación del seguimiento de auditoría.

Para configurar una actividad Punto de observación:

1. Identifique las actividades de un proceso que tienen paquetes que desea supervisar yutilizar en los informes.

2. Desde la carpeta BAM, arrastre la plantilla de actividad Punto de observación hastael proceso e insértela inmediatamente detrás de la actividad que desea supervisar.Existe una correspondencia uno a uno entre la actividad y la plantilla Punto deobservación que le sigue. Si una actividad va seguida de una plantilla Punto deobservación, no puede tener enlaces salientes a otras actividades; sólo puedeconectar con dicha plantilla. Por otro lado, una plantilla Punto de observación sólopuede tener un enlace entrante desde una misma actividad, aunque puede tenervarios enlaces salientes.

3. Abra el Inspector de actividades de Punto de observación y haga clic en la fichaSeleccionar paquetes.

4. Seleccione los paquetes cuyos datos se publicarán en la base de datos ProActivity eneste punto del proceso.



a. Haga clic en Seleccionar. Aparecerá un cuadro de diálogo de selección en el quese muestran los paquetes asociados a la plantilla del proceso.

b. Resalte el nombre del paquete en la lista de la izquierda y haga clic en Agregarpara agregarlo a 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 deseasupervisar, haga clic en Aceptar.La ficha Seleccionar paquetes muestra una lista de los paquetes que se hanmarcado para la supervisión.

Nota: Las plantillas de actividad Punto de observación no están visibles cuando seimportan a Process Analyzer. En cambio, la actividad que precede a la plantilla deactividad se marca como una actividad supervisada y contiene información en la quese indica qué paquetes se han identificado para la supervisión. Cuando el procesoempresarial se importa de nuevo en Process Builder, la plantilla de actividad Punto deobservación se restaura en el flujo del proceso.

Trabajo Workflow Publish Events (Eventos de publicación de flujo de trabajo)

El trabajo Workflow Publish Events (Eventos de publicación de flujo de trabajo) publicalos eventos capturados en el seguimiento de auditoría en la base de datos ProActivitya intervalos regulares. Este trabajo se proporciona como parte de la instalaciónde Process Engine. Si necesita más información sobre la configuración del trabajodm_WFPublishEvents, consulte la guía Process Builder Installation Guide.


Apéndice B

Variables de sustitución paralas propiedades de plantillas deactividades personalizadas

Al 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 del cualse deriva el valor, y un nombre de atributo, que identifica el valor específico que se inserta en tiempode ejecución. Por ejemplo, la variable <dmp:param>workflow.creator</dmp:param> se reemplazaráen tiempo de ejecución por el valor del atributo creador del objeto de flujo de trabajo. Si el atributoseleccionado tiene varios valores, la variable de sustitución también incluye un índice para especificarcuá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 delpaquete que contenga el valor deseado.


Variables de sustitución para las propiedades de plantillas de actividades personalizadas

La lista Atributomuestra los atributos disponibles para el elemento seleccionado. Obien, si selecciona "alias" como tipo de parámetro, aparecerán las listas Conjunto dealias y Nombre de alias.

4. Si seleccionó "alias" como tipo de parámetro, elija un conjunto de alias en el cuadrode lista Conjunto de alias y, a continuación, seleccione un alias concreto en la listaNombre de alias.

5. Si seleccionó cualquier otro tipo de parámetro en lugar de "alias", utilice la listaAtributo para elegir 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) o LAST (ú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 vez cerrado el cuadro de diálogo, edite la variable para reemplazar FIRST oLAST 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 13. Variables de sustitución admitidas para los campos de configuración de actividades

Variable Descripción

workflow.creator El nombre de usuario de la persona quecreó 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 dela cual se 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 personaidentificada como el supervisor del flujode trabajo (el creador predeterminado delflujo)

workflow.supervisor_address La dirección de correo electrónico delsupervisor del flujo de trabajo

task.act_id El ID de la actividad que generó la tareaactual




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 tieneuna actividad automática, el valor de lavariable es "0000000000000000".

task.creation_date El formato de fecha se determina por elpatrón de tiempo predeterminado definidoen DFC.

task.due_date El formato de fecha se determina por elpatrón de tiempo predeterminado definidoen DFC. Si la tarea no tiene una fecha devencimiento, el valor de la variable es"nulldate"

task.performer El ejecutante de la tarea

task.performer_address La dirección de correo electrónico delejecutante de la tarea

task.priority El valor de prioridad asignado a la tarea

task.state El estado actual de la tarea, representadocomo un entero

packagename.atributo El valor de cualquier atributo de valorúnico especificado por packagename.Al seleccionar la variable en el Cuadro dediálogo de la variable de sustitución, éstemuestra todos los atributos personalizadosy 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 variosvalores especificado por packagename.El índice identifica qué valor se debeutilizar: FIRST (primero), LAST(último) o un entero que indicauna posición en la lista de valores.Al seleccionar la variable en el Cuadrode diálogo de la variable de sustitución,el cuadro de diálogo muestra todoslos atributos personalizados y unsubconjunto de uso habitual de los




atributos dm_document estándar. Noobstante, puede utilizar cualquier atributo

doc.id El ID del primer documento del primerpaquete procesado por la actividad

doc.name El nombre del primer documento delprimer paquete procesado por la actividad

note.id El ID de la primera nota anexa aldocumento, 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_aliaso alias.conjunto_alias.nombre_alias Alias del sistema, donde nombre_aliasidentifica el alias que desea resolver.Si incluye el parámetro opcionalconjunto_alias, el servidor utiliza el alias delconjunto de alias especificadoVarName o VarName.<valor de atributo> El valor de la variable de proceso


Apéndice C

Archivo de configuración de ProcessBuilder

Process Builder tiene un archivo de configuración que controla determinados aspectos desu interfaz de usuario. 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 recientes

disponible en el menú Archivo.En la tabla siguiente se describen los parámetros del archivo de configuración. Para modificar unvalor, edite el archivo con un editor de texto y cambie los valores que sean necesarios.

Tabla 14. Parámetros de bpmconfig

Parámetro Descripción Valor predeter-minado

unique-template-name Se establece como true para exigir que los nombresde las plantillas de procesos sean únicos en elrepositorio

false

show-package-version Especifica si Process Builder permite que losusuarios seleccionen la versión de un paquete. Sise establece en false, el proceso utiliza siempre laversión CURRENT

true


Archivo de configuración de Process Builder

Parámetro Descripción Valor predeter-minado

show-package-type Especifica si Process Builder permite que losusuarios definan explícitamente la versión de unpaquete. Si se establece en false, Process Builderutiliza el tipo de objeto asociado a la plantilla deformulario seleccionada o dm_sysobject si no se haseleccionado ninguna plantilla de formulario

true

max-recent-file Define el número máximo de nombres de archivoque aparecen en la lista de archivos recientes

5

template-save-path Si existe este parámetro, Process Builder exige alos usuarios que guarden las plantillas de procesoen la carpeta o subcarpeta especificada; si no existeel parámetro, los usuarios pueden guardar lasplantillas de proceso en cualquier carpeta para laque tengan un acceso de seguridad adecuado

Ninguno


Índice

AA inferior, función, 179A superior, función, 179actividad, ventana plantilla de

agregar plantillas, 115actividades

ajustar a la cuadrícula, 64alinear, 63anular, 82asuntos de tareas, 31cambiar la configuración de vista, 161condición de desencadenamiento, 41conectar, 103controlador de errores, 20copiar, 62de repetición, 141definir desencadenadores, 140descripción, 18ejecutantes, 26espera de mensaje, 20inicio, 19intervalos de reintento, 126mover, 62pegar, 62permitir la delegación, 125planificar, 26roles del ejecutante, 27seleccionar con condiciones, 45sustituir, 63tipos de transición, 44

actividades automáticasatributos, 18ejecutantes válidos, 139parámetros de ejecución, 125valores de prioridad, 33

actividades de comienzo, 18actividades de espera de mensaje, 18, 20actividades de finalización, 18actividades de inicio, 18 a 19

actividades del controlador de errores, 18,20, 72, 103

actividades entrantesconjuntos de correlaciones, 86depurar, 188habilitar servicios Web, 87número de puerto, 51

actividades intermedias, 18actividades manuales

alias como ejecutantes, 30atributos, 18delegación, 31ejecutantes válidos, 26extensión, 31

actualizaciones de BAM, 54Actualizar definiciones de datos de BAM,

opción, 54agregar categorías, 56Agregar día laboral, función, 176Agregar Días, función, 176Agregar, función, 176ajustar a la cuadrícula, 64algunos usuarios de un grupo, 28alias

alias de ejecutantes, 145crear conjuntos de alias, 30usar en el flujo de trabajo, 30

alinear actividades, 63almacenar nombres de documentos, 74antigüedad de tareas, 33anular actividades, 82Aplicar a todos los seleccionados

(opción), 103, 122Aplicar ciclo de vida, plantilla de

actividad, 200, 280Archivo, menú, 49asignación de datos

atributos de repetición, 174funciones, 176usar conjuntos de correlaciones, 180


Índice

usar funciones, 175Asignación de datos de procesos (plantilla

de actividad), 258asignar datos

a nivel de habilidad de cola detrabajo, 138

información general, 172niveles de habilidad de cola de

trabajo, 138procedimiento, 172

asignar ejecutantes, 129asignar ejecutantes ahora, 130Asistente para plantilla de

notificación, 155Asistente para tipo de datos

estructurado, 58Asistente para tipos de datos

estructurados, 56atributo de repetición

asignar, 174atributo task_subject, 31 a 32atributo task_subject, de actividades, 32atributos, 166atributos de repetición

asuntos de tareas, 32condiciones de transición, 153

Bbarra de herramientas, 48 a 49barra de herramientas de flujo de

trabajo, 49barra de herramientas de vista, 49Base de datos entrante, plantilla de

actividad, 215Business Activity Monitor, consulte BAMBuzón HTTP, plantilla de actividad, 278

CCadena a byte, función, 178Cadena a fecha, función, 179calendarios, consulte calendarios de procesocalendarios de proceso, 85, 142carpetas

compartir proceso, 51crear a partir de plantillas, 213gestionar, 115

carpetas de la plantilla de actividadesagregar, 52

quitar, 52carpetas de plantilla de actividad

quitar plantillas de actividad, 115categorías, 56Ciclo de vida, volver al estado anterior,

plantilla de actividad, 201, 280cola de trabajo, 28compartir plantillas de proceso, 49compartir proceso, carpetas, 51Concatenar, función, 177condiciones de transición, 43, 45, 148 a 149,

151, 153configuración de página, 101configuración de vista

cambiar, 161conjunto de alias predeterminado, 73, 133conjuntos de alias

específicos, 133predeterminados, 133

conjuntos de correlacióncrear, 86

conjuntos de correlacionesdefinidos, 180usar, 181

copiar actividades, 62Copiar, función, 177correlación de mensajes

campos de configuración, 181conjuntos de correlaciones, 181definida, 180identificadores de correlación, 180

Correo electrónico entrante, plantilla deactividad, 238

Crear carpeta a partir de plantilla, plantilla deactividad, 213

Crear evento de calendario de ICS, plantilla deactividad, 214

Crear LCA, plantilla de actividad, 211Crear Plantilla de actividad de carpeta, 199

Ddatos, 167Datos (ficha), 122datos de ejecución, 22datos de paquetes, 22datos de proceso

definir, 38definir paquetes, 38definir parámetros de proceso, 40


Índice

definir variables de proceso, 39descritos, 21gestionar, 158

datos de procesosasignar a nivel de habilidad de cola de

trabajo, 138datos, asignación

valor único, atributos, 174datos, asignar

entrada, contexto, 175De byte a cadena, función, 177Debugger de proceso, consulte depurar

procesosDecisión de repasar tarea de la cola, plantilla

de actividad, 273Decisiones, dividir (plantilla de

actividad), 206definiciones de datos, 54definir alias de ejecutante, 133definir ejecutantes, 128Definir habilidad para tarea de cola, plantilla

de actividad, 272delegación, 31, 125depurar procesos

actividad de inicio entrante, 188actividad de inicio manual, 188agregar puntos de quiebre, 187continuar hasta el siguiente punto de

quiebre, 190definir número de puerto, 51detener, 191elementos gráficos, 186entorno, 185, 193información general, 183iniciar un flujo de trabajo, 187métodos de flujo de trabajo

automáticos, 193obligar a completar la tarea, 192pasar a una actividad, 189pasar a una actividad automática, 190salir, 191tareas automáticas, 192tareas manuales, 191Task Manager, ficha, 191volver a ejecutar una sesión de

depuración, 190desencadenadores

definir, 41, 140eventos, 42

desinstalar

plantillas de actividad, 117 a 118plantillas de proceso, 92

determinar ejecutantes, 129disponibilidad del flujo de trabajo, 31Dividir, función, 177 a 178dm_changedactivityinstancestate, 75, 155dm_delegatedworkitem, 75, 155dm_startedworkitem, 75, 155dm_WfmsTimer, trabajo, 43dm_workflow, 32dmi_package, 32dmi_queue_item, 32dmi_workitem, 32Documento de xPression Publish: Avanzada,

plantilla de actividad, 269Documento de xPression Publish, plantilla de

actividad, 268DQL entrante, plantilla de actividad, 226

EECIS, plantilla de actividad, 204Editar, menú, 49editor de plantillas del proceso; panel

notas de texto, 61Ejecutante (ficha), 121, 125, 127, 139ejecutante de la actividad anterior, 27ejecutantes

alias, 133, 145automáticos, 125, 139determinar en tiempo de ejecución, 29elegir, 26manuales, 125, 127roles, 27selección según datos de proceso, 137seleccionar basándose en

condiciones, 134utilizar alias, 30utilizar la delegación y la

extensión, 31ejecutantes automáticos

elegir, 125, 139tareas, 125

ejecutantes condicionales, 129, 134ejecutantes manuales

algunos usuarios de un grupo, 128cola de trabajo, 128definir ejecutantes, 128ejecutante de la actividad anterior, 128elegir, 125, 127


Índice

propietario del repositorio, 128selección según datos de proceso, 129seleccionar basándose en

condiciones, 129supervisor de flujo de trabajo, 128tareas, 125todos los miembros de un grupo, 128un solo usuario del grupo, 129usuario específico, 128usuario único de un grupo, 128varios ejecutantes secuenciales, 128 a

129ejemplo, plantillas

Decisión de repasar tarea de lacola, 273

Definir habilidad para tarea decola, 272

elegirejecutantes automáticos, 139ejecutantes manuales, 127

elementos de trabajo, 18eliminar objetos, 62Enlazar a carpeta, plantilla de

actividad, 203enumeración, 168Enviar a la cola de JMS, plantilla de

actividad, 278Enviar a MQ JMS, plantilla de

actividad, 279Escribir base de datos, plantilla de

actividad, 224Escribir DQL, plantilla de actividad, 228esquemas XML

agregar a mensajes, 168utilizar en tipos de datos

estructurados, 60Esquemas XML

en Inspector de plantilla deactividad, 117

estado borrador, 70, 113estado instalado, 70, 113estado validado, 70, 113eventos de calendario, 214exportar plantillas de proceso, 100extensión, 31

Ffallo

definir tiempos de espera delmétodo, 126

opciones de ejecución, 126opciones de reintento, 126

Fax saliente, plantilla de actividad, 240Fecha a cadena, función, 177ficha Avanzada, 82Ficha Datos, 76Ficha Desencadenador, 121ficha General, 73Ficha Notificación, 121Ficha Propiedades, 121, 123Ficha Temporizadores, 121Ficha Transición, 121Ficha Visualización, 122fichas

Inspector de actividad, 116suprimir la visualización de, 117ver, 67

firmas digitales, 32flujo, plantillas

Iniciar subproceso, 274Publicar evento en proceso padre, 207Transformación XSL, 208Unir, 206

flujosagregar controladores de errores, 103avance, 23controlador de errores, 23descritos, 103Inspector de flujo, 103mostrar configuración, 104rechazo, 23

Flujos de segmentos múltiples, 103flujos de trabajo

paquetes, 38planificar, 24variables de proceso, 39

Flujos de un único segmento, 103formato, 167Forms Builder, 19, 40, 78, 86, 124formularios

agregar, 78agregar a procesos, 169agregar a una actividad, 159agregar al paquete, 40crear formularios de alta

fidelidad, 169esquemas, 169propiedades, 78


Índice

rellenar con XML, 169seleccionar, 86, 124

FTP entrante, plantilla de actividad, 244FTP saliente, plantilla de actividad, 247FTP, plantilla de actividad, 277funciones, 175 a 176, 220

Gguardar plantillas de proceso, 87

Hherramienta de asignación de datos

agregar nodos condicionales, 172agregar propiedades de mensaje, 167agregar un esquema XML, 168asignar datos, 172atributos de paquete, 166editar datos de proceso, 166editor de funciones, 175información general, 163usar atributos de repetición, 174

HTTP entrante, plantilla de actividad, 250HTTP saliente, plantilla de actividad, 253HTTP/Número de puerto de WebService

Inbound, 52

IiCalendar, 214iconos, 49iconos de la barra de herramientas, 49ICS, eventos de calendario, 214ID de correlación, 180IDfModule, interfaz, 36importar, plantillas de proceso, 97imprimir plantillas de proceso, 100información general

sobre flujos de trabajo, 13informes

actualizar datos de proceso, 54actualizar definiciones de BAM, 59configurar seguimiento de

comprobación, 74exponer paquetes, 79, 160exponer tipos de datos

estructurados, 59exponer variables de proceso, 39habilitar, 22subprocesos, 107

informes de BAMactualizar datos de proceso, 54actualizar definiciones de BAM, 59configurar seguimiento de

comprobación, 74exponer paquetes, 79, 160exponer tipos de datos

estructurados, 59habilitar, 22subprocesos, 107

iniciar automáticamente un paquete, 160Iniciar subproceso, plantilla de

actividad, 274Inspector de actividades, 121Inspector de flujos, 103Inspector de notas, 65Inspector de plantilla de actividad

configurar, 116crear una nueva plantilla, 114ficha Definición, 117

Inspector de subproceso, 108 a 109instalar

plantillas de actividad, 118plantillas de proceso, 89, 92

instalar plantillas de actividad, 117instrucciones de flujo de trabajo, 73integración, plantillas

Base de datos entrante, 215Base de datos, escritura de, 224Base de datos, procedimiento

almacenado, 220Buzón HTTP, 278Correo electrónico entrante, 238Datos de procesos, asignación, 258Enviar a la cola de JMS, 278Enviar a MQ JMS, 279FTP, 277FTP entrante, 244FTP saliente, 247HTTP entrante, 250HTTP saliente, 253JMS entrante, 255JMS saliente, 257Leer base de datos, 218Módulo BOF, 209Publicar en el tema de JMS, 276Servicio Web dinámico, 229SMTP, 275SMTP, actividad, 260Web, servicio, 263


Índice

intervalos de reintento, 126Invocar proceso, plantilla de

actividad, 262IWQTaskPriority, interfaz, 36

JJMS entrante, plantilla de actividad, 255JMS saliente, plantilla de actividad, 257

LLCA

asignar a una variable, 80establecer, 83permisos mínimos, 83seleccionar, 84sistema, 84usuario, 84

LCA, plantilla, 211Leer base de datos, plantilla de

actividad, 218Leer DQL, plantilla de actividad, 227Leer FTP, plantilla de actividad, 248Listas de control de acceso, consulte LCA

Mmarcadores de posición, 260mensajes

agregar esquemas XML, 168propiedades, 167

mensajes asíncronos, 20mensajes de advertencia, 53método getInitialPriority, 34métodos de flujo de trabajo

automáticos, 193Módulo BOF, plantilla de actividad, 209módulo de prioridad de colas de

trabajo, 127módulos de prioridad

asociar a una actividad, 127definidos, 34ejemplo, 36

mostrar configuraciónflujos, 104

mover actividades, 62Multiplicar, función, 178

NNavegador, 68nivel de habilidad, 138nivel de habilidad de cola de trabajo, 138nodos

agregar condiciones, 172árbol de datos de proceso, 137asignar, 158, 261

nodos condicionales, 172nombre de tarea, 123 a 124Notificación, ficha, 42, 154notificaciones

crear, 44, 154de temporizadores, 144plantillas de correo electrónico, 74valores predeterminados, 143

notificaciones del supervisor, 42, 154notificaciones por correo electrónico, 44notificar al supervisor, 42, 154

Oobjetos

eliminar, 62seleccionar, 62

Obligar a completar la tarea, botón, 192Obtener Año, función, 178Obtener Día, función, 178Obtener dirección de correo electrónico,

función, 178Obtener Mes, función, 178Obtener valor, función, 178opción continuar ejecución, 126opción detener ejecución, 126opción finalizar ejecución, 126

Ppanel del editor de plantillas del proceso

descrito, 61paquetes

agregar a la plantilla, 76almacenar nombres de

documentos, 74atributos, 166definir, 38exponer para informes, 79iniciar automáticamente, 160mostrar atributos adicionales, 167obligatorios, 79


Índice

parámetros de procesoadministrar, 40definir, 40gestionar, 81información general, 40tipo, 82

Pasar a la siguiente actividad, botón, 189Pasar a, botón, 190pegar actividades, 62permisos, 83plantilla de actividad, ventana

copiar plantillas personalizadas, 115plantillas de actividad

configurar, 116copiar, 114 a 115crear, 25, 114definir preferencias, 52desinstalar, 117 a 118estados, 56instalar, 117 a 118mostrar mensajes de preguntas, 53mostrar preguntas de validación e

instalación, 53validar, 117 a 118

plantillas de actividadesubicación dentro del sistema, 55

plantillas de correo electrónicocrear, 74, 143, 156para temporizadores, 74, 143seleccionar, 76

plantillas de flujoDecisiones, dividir, 206

plantillas de integraciónFax saliente, 240Invocar proceso, 262

plantillas de notificación, 155plantillas de proceso

abrir, 70agregar alias, 73agregar datos de proceso, 76agregar mensajes de correo

electrónico, 75agregar notas, 65agregar parámetros de proceso, 81agregar un formulario, 78agregar variables de proceso, 80arquitectura, 17cambiar propiedades, 73cancelar retirada, 96compartir con Process Analyzer, 49

crear, 70crear versiones, 77, 94descripción, 18desinstalar, 92eliminar, 97establecer el nivel de zoom, 64establecer LCA, 83estados, 70exportar, 100ficha Avanzada, 82ficha Datos, 76guardar, 87importar, 97imprimir, 100instalar, 92modificar, 93mostrar varias fichas, 67registrar, 94, 96retirar, 94 a 95usar el navegador, 68validar, 90volver a importar, 98

plantillas de servicios de contenidoCrear carpeta, 199

plantillas del procesocreación, 61

post-temporizador, 42, 110, 142pre-temporizador, 42, 109, 141Preferencias, cuadro de diálogo, 51 a 53,

55preguntas

mostrar mensajes de advertencia, 53mostrar preguntas de validación e

instalación, 53prioridad

actividades, 33cómo la aumenta el sistema, 34definir inicial, 33establecer la prioridad estática, 35establecer prioridad dinámica, 35implementar, 36resolver, 34seleccionar niveles, 123

prioridad dinámica, 35, 123procedimiento almacenado, 220Procedimiento almacenado en base de

datos, plantilla de actividad, 220Process Analyzer

compartir procesos, 49XPDL, archivos, 51


Índice

Promoción e ciclo de vida, plantilla deactividad, 281

propiedadesagregar, 32agregar a un mensaje, 167

Propiedades de proceso, consulte plantillasde proceso

propietario de la plantilla de proceso, 73propietario del repositorio, 27Publicar en el tema de JMS, plantilla de

actividad, 276Publicar evento en proceso padre, plantilla de

actividad, 207puntos de quiebre, 190

RRechazar flujos, 103Recuento, función, 177registro de ejecución, 126reglas de transición, 149repository explorer, 114requisitos de firma, 32requisitos para cerrar sesión, 125Resource Navigator (Navegador de

recursos), 47Restar, función, 179retirar procesos, 70

Sseguimiento de comprobación

configurar, 74Eventos de publicación de flujo de

trabajo, trabajo, 283habilitar, 22puntos de observación, 282subprocesos, 107

Seleccionar ejecutante, 127, 139seleccionar objetos, 62Servicio Web dinámico, plantilla de

actividad, 229Servicio Web entrante, plantilla de

actividad, 265Servicio Web, plantilla de actividad, 263servicios de contenido, plantilla

Enlazar a carpeta, 203servicios de contenido, plantillas

Ciclo de vida, aplicar, 200, 280

Ciclo de vida, volver al estadoanterior, 201, 280

ECIS, plantilla de actividad, 204Promoción de ciclo de vida, 281

servicios Webhabilitar, 87

SMTP, actividad (plantilla deactividad), 260

SMTP, plantilla de actividad, 275Subcadena, función, 179subprocesos

contraer, 111eliminar, 112establecer propiedades, 109expandir, 111información general, 107Inspector de subproceso, 108modelado ascendente, 108modelado descendente, 108notas, 111opciones de visualización, 110quitar actividades, 111temporizadores, 109

supervisor del flujo de trabajo, 27

Ttareas

antigüedad, 33ejecutantes automáticos, 125ejecutantes manuales, 125

Task Manager, ficha, 191TaskSpace, 40temporizadores

asociar a un calendario, 142completar tarea, 43completar una tarea, 148delegar tarea, 43delegar una tarea, 147ejecutar método Java, 43ejecutar un método Java, 146enviar notificaciones, 144iniciar proceso, 43iniciar un proceso, 146notificación, 43

Temporizadores (ficha), 109, 141temporizadores de advertencia, 42, 109,

141Temporizadores, ficha, 109tipo de contenido, 167


Índice

tipo de parámetro, 285tipos de datos complejos, 39, 57, 61tipos de datos de elementos, 61tipos de datos estructurados

asistente, 56atributos, 58categorías, 56De búsqueda, opción, 59, 61editar, 60gestionar, 79grupos, 57Informe, opción, 61opción de informes, 59Repetible, opción, 59, 61simples, 39tipos complejos, 57, 61tipos de datos simples, 57tipos de elementos, 61utilizar un esquema XML, 60

tipos de datos simples, 39, 57tipos de transición, 44todas las versiones, 70todos los usuarios del grupo, 27trabajo Qm_QmPriorityAging, 35Transformación XSL, plantilla de

actividad, 208Transición (ficha), 149Transition Condition Wizard, 151

Uun solo usuario del grupo, 27Unir plantilla de actividad, 206Unir, función, 178Usar formulario para propiedades, 78usuario específico, 27

Vvalidación

mostrar mensajes de preguntas, 53servidor, 117

validaciones del servidor, 117validar

plantillas de actividad, 117 a 118plantillas de proceso, 90

variableseditar, 160sustitución, 199, 203, 210, 216, 219,

225, 285variables de proceso

agregar a un flujo, 76definidas, 21definir, 39listas de control de acceso, 80requisitos de permiso, 83tipo, 80

variables de sustitución, 285varios ejecutantes secuenciales, 28Vencimiento de post-temporizador, 75Vencimiento de pre-temporizador, 75ventana plantilla de actividades

introducción, 55Ventana Structured Data Types (Tipos de

datos estructurados), 56ver procesos, 70Ver, menú, 49versiones, 77versiones actuales, 70vista de varias fichas, 67vista preliminar, 101 a 102Visualización (ficha), 104, 161Visualización, ficha, 110Volver a ejecutar la depuración, botón, 190volver a importar plantillas de proceso, 98

XXDPL, archivos, 50XPDL

exportar, 100importar, 97volver a importar, 98

XSD, archivo, 60

Zzoom; opciones, 64
