emcayudadedocumentum xceleratedcomposition … · emcayudadedocumentum xceleratedcomposition...

EMC Ayuda de DocumentumxCelerated Composition

Platform Designer

Versión 2.3

Guía del usuario

EMC Computer Systems México, S. A.Oficinas de la empresa:

Av. Antonio Dovalí Jaime, 70, torre C, piso 10, Santa Fe, Ciudad de México, 01219Tel.: +52 55 1037 0000

http://mexico.emc.com. Visite el sitio web de su país correspondiente.

Aviso legal

Copyright © 2009–2016 EMC Corporation. Todos los derechos reservados.

EMC considera que la información contenida en esta publicación es exacta en la fecha de su emisión. La información está sujeta acambios sin aviso previo.

LA INFORMACIÓN DE ESTA PUBLICACIÓN SE PROPORCIONA "TAL CUAL". EMC CORPORATION NO HACENINGUNA DECLARACIÓN NI OFRECE NINGUNA GARANTÍA DE NINGÚN TIPO CON RESPECTO A LAINFORMACIÓN DE ESTA PUBLICACIÓN Y, ESPECÍFICAMENTE, NO OFRECE NINGUNA GARANTÍA IMPLÍCITA DECOMERCIABILIDAD O IDONEIDAD PARA UN FIN DETERMINADO.

El uso, la copia y la distribución de cualquier software de EMC descrito en esta publicación requieren una licencia de softwareadecuada.

Para obtener una lista actualizada de los nombres de productos de EMC, consulte las marcas comerciales de EMC Corporation enEMC.com. Adobe y Adobe PDF Library son marcas comerciales o marcas comerciales registradas de Adobe Systems Inc. en losEE. UU. y en otros países. Todas las demás marcas comerciales mencionadas son propiedad de sus respectivos propietarios.

Comentarios sobre la documentación

Su opinión cuenta. Estamos interesados en saber cuál es su opinión sobre la documentación de nuestros productos. Si tienecomentarios sobre cómo podemos mejorar nuestra documentación o hacer que sea más fácil de usar, envíe sus comentariosdirectamente a [email protected]

Tabla de Contenidos

Capítulo 1 Introducción ...................................................................................................15xCelerated Composition Platform Designer ........................................................15Diseñar una aplicación .....................................................................................15Planificar .........................................................................................................16Crear la aplicación y los artefactos ....................................................................18Diseñar los modelos de proceso........................................................................18Configurar los servicios de datos de consulta.....................................................19Diseñar la interfaz de usuario............................................................................20Probar la aplicación ..........................................................................................21Empaquetar la aplicación..................................................................................21

Capítulo 2 Creación de aplicaciones y proyectos............................................................23Tareas .............................................................................................................23Crear una aplicación .....................................................................................23Editar una aplicación .....................................................................................24Exportar una aplicación .................................................................................25Importar una aplicación .................................................................................25Migrar una aplicación ....................................................................................26Migrar una aplicación con CLI........................................................................26Actualizar las bibliotecas de una aplicación mediante CLI................................27Crear un proyecto .........................................................................................28Editar un proyecto.........................................................................................28Exportar un proyecto .....................................................................................29Importar un proyecto .....................................................................................29Agregar una biblioteca ..................................................................................29Eliminar una biblioteca ..................................................................................30Actualizar una biblioteca................................................................................30Gestionar dependencias del proyecto.............................................................30Trabajar con un sistema de control de origen..................................................31

Conceptos .......................................................................................................32Aplicaciones .................................................................................................32Proyectos .....................................................................................................32Ampliar aplicaciones con código personalizado...............................................33Gestionar versiones del proyecto y de la aplicación.........................................33Compartir recursos de aplicación ...................................................................34Usar la vista Referencias...............................................................................34Buscar artefactos ..........................................................................................35

Capítulo 3 Crear componentes de nivel de aplicación ....................................................37Tareas .............................................................................................................37Crear un parámetro.......................................................................................37Crear un rol de aplicación..............................................................................38Creación de conjuntos de permisos................................................................38Configurar conjuntos de permisos ..................................................................39

EMC Documentum xCelerated Composition Platform Designer Versión 2.3 Guía del usuario 3

Tabla de Contenidos

Crear una plantilla de correo electrónico.........................................................40Configurar una plantilla de correo electrónico..................................................41Seleccionar un formato para un visor .............................................................41Crear un punto final.......................................................................................41Configurar un punto final de base de datos.....................................................42Configurar un punto final de correo electrónico ...............................................42Configurar un punto final de FTP ...................................................................44Configurar un punto final de HTTP .................................................................45Configurar un punto final de JMS ...................................................................46Configurar un punto final del repositorio .........................................................47Configurar un punto final de servicio web .......................................................48Acceder a un servicio web a través de un servidor proxy HTTP .......................49Configurar un punto final del servidor xPression..............................................49Trabajar con el navegador de aplicaciones .....................................................50Gestionar contenido de la biblioteca de recursos.............................................50Crear una extensión de Java .........................................................................50Migración de un módulo de Java y un servicio de Java....................................52Crear un conjunto de alias .............................................................................52

Conceptos .......................................................................................................53Implementar la seguridad ..............................................................................53Roles de aplicación .......................................................................................54Usar parámetros de una aplicación ................................................................54Conjuntos de permisos..................................................................................55Bibliotecas de recursos .................................................................................55Plantillas de correo electrónico ......................................................................56Conectar con sistemas externos mediante puntos finales ................................57Determinar qué punto final utilizar ..................................................................57Archivo de registro de xCP Designer ..............................................................58Extensiones Java..........................................................................................58Conjunto de alias ..........................................................................................59

Capítulo 4 Crear modelos de objetos ..............................................................................61Tareas .............................................................................................................61Crear un modelo de objeto ............................................................................61Configurar las opciones básicas del modelo de objeto.....................................61Agregar atributos a un modelo de objeto ........................................................63Editar atributos ............................................................................................64Editar atributos en línea.................................................................................64Crear un modelo de una lista desplegable ......................................................65Configurar las opciones básicas de la lista desplegable...................................65Agregar valores de lista desplegable ..............................................................65Configurar un evento de negocio ...................................................................65Editar un evento de negocio ..........................................................................67Configurar metadatos descubiertos ................................................................67Crear una relación de objetos ........................................................................68Configurar una relación de objetos .................................................................68Trabajar con el navegador de modelos de objeto ............................................69Definir alertas ...............................................................................................70Crear un fragmento de tipo ............................................................................71

Conceptos .......................................................................................................73Modelos de objetos .......................................................................................73Modelos de objeto base ................................................................................74Determinar qué modelo de objeto utilizar........................................................74Atributos del modelo de objeto.......................................................................76Definir los valores de atributo predeterminados...............................................77Acceder a un objeto de negocio mediante una dirección URL ..........................78Eventos de negocio.......................................................................................78

4 EMC Documentum xCelerated Composition Platform Designer Versión 2.3 Guía del usuario

Tabla de Contenidos

Descripción de los análisis de contenido.........................................................79Metadatos descubiertos ................................................................................80Relaciones de modelos de objetos .................................................................85Ejemplo de relación.......................................................................................86Comportamientos de las configuraciones de relación ......................................86Alerta ...........................................................................................................92Fragmento de tipo.........................................................................................93Compatibilidad con mensajes de Outlook .......................................................94

Capítulo 5 Crear modelos de procesos ...........................................................................97Tareas .............................................................................................................97Crear un modelo de proceso..........................................................................97Configurar información general para el modelo de proceso..............................97Crear variables de proceso............................................................................98Crear paquetes.............................................................................................99Agregar contenido a un proceso .................................................................. 100Especificar los permisos de proceso ............................................................ 101Seleccionar un calendario para el modelo de proceso ................................... 101Crear un conjunto de correlación ................................................................. 102Habilitar actividades de servicio web entrante ............................................... 102Diseñar el modelo de proceso en el lienzo.................................................... 102Configurar una actividad para adjuntar un fragmento de tipo.......................... 103Configurar una actividad para separar un fragmento de tipo .......................... 104Depurar un proceso ................................................................................... 105Crear una versión del proceso ..................................................................... 106

Conceptos ..................................................................................................... 107Definir un modelo de proceso de negocio ..................................................... 107Editor de modelos de proceso...................................................................... 108Procesos .................................................................................................... 108Datos de proceso........................................................................................ 108Variables de proceso................................................................................... 109Paquetes de proceso .................................................................................. 109Limitar los permisos de proceso del usuario final........................................... 110Procesos sin estado.................................................................................... 110Correlación de mensajes ............................................................................. 115Identificadores de correlación ...................................................................... 115Conjuntos de correlación ............................................................................. 116Depurador de procesos ............................................................................... 116Creación de versiones de proceso ............................................................... 117

Capítulo 6 Trabajar con actividades de proceso............................................................ 119Tareas: actividades manuales ......................................................................... 119Configurar tareas de actividades manuales .................................................. 119Configurar los ejecutores de una actividad manual........................................ 120Seleccionar el ejecutor de la última actividad para realizar una actividadmanual ....................................................................................................... 121Seleccionar usuarios de los parámetros de aplicación para realizar unaactividad manual......................................................................................... 122Seleccionar un usuario de un conjunto de alias para realizar una actividadmanual ....................................................................................................... 122Seleccionar un usuario de los datos de proceso para realizar una actividadmanual ....................................................................................................... 122Seleccionar un rol de aplicación para realizar una actividad manual ............... 123Seleccionar un grupo de los parámetros de aplicación para realizar unaactividad manual......................................................................................... 123Seleccionar un grupo de datos de proceso para realizar una actividadmanual ....................................................................................................... 123


Tabla de Contenidos

Seleccionar un grupo de un conjunto de alias para realizar una actividadmanual ....................................................................................................... 124Seleccionar el ejecutor de la actividad anterior para una actividadmanual ....................................................................................................... 124Definir colas de trabajos y habilidades en el repositorio ................................. 124Configurar una cola de trabajos para una tarea............................................. 125Seleccionar una cola de trabajos desde un parámetro................................... 126Seleccionar una cola de trabajos desde los datos de proceso........................ 126Asociar un módulo de prioridad a una tarea de cola de trabajos..................... 127

Tareas: actividades del sistema....................................................................... 127Configurar el ejecutor y la ejecución de una actividad del sistema.................. 127Seleccionar un usuario de los parámetros de aplicación para realizar unaactividad del sistema................................................................................... 128Configurar una actividad Crear .................................................................... 128Configurar una actividad Crear ACL ............................................................. 129Configurar una actividad Editar permisos...................................................... 130Configurar una actividad Mover.................................................................... 131Configurar una actividad Definir los datos de proceso ................................... 132Configurar una actividad Llamar al procedimiento de la base de datos ........... 132Configurar una actividad Leer desde la base de datos................................... 133Configurar una actividad Iniciar desde la base de datos ................................ 134Configurar una actividad Esperar a la base de datos ..................................... 135Configurar una actividad Escribir en base de datos ....................................... 136Configurar una actividad Leer desde el repositorio ........................................ 137Configurar una actividad Iniciar desde el repositorio ...................................... 138Configurar una actividad Esperar al repositorio ............................................. 139Configurar una actividad Escribir en el repositorio ......................................... 140Configurar una actividad Enviar correo electrónico ....................................... 141Configurar una actividad Iniciar desde correo electrónico .............................. 142Configurar una actividad Esperar al correo electrónico .................................. 144Configurar una actividad Llamar proceso...................................................... 146Configurar una actividad Llamar a un proceso sin estado .............................. 146Configurar una actividad Señalar proceso principal ....................................... 147Configurar una actividad Descargar desde FTP ........................................... 147Configurar una actividad Iniciar desde FTP................................................... 148Configurar una actividad Subir vía FTP ....................................................... 148Configurar una actividad Esperar a FTP ....................................................... 149Configurar una actividad Enviar solicitud HTTP o RESTful............................. 150Configurar una actividad Iniciar desde HTTP ................................................ 151Configurar una actividad Esperar a HTTP..................................................... 153Configurar una actividad Ejecutar servicio de Java........................................ 154Ejemplo de ampliación de la funcionalidad de proceso .................................. 154Configurar una actividad Enviar mensaje de JMS ......................................... 155Configurar una actividad Iniciar desde JMS .................................................. 156Configurar una actividad Esperar a JMS....................................................... 156Configurar una actividad Llamar a servicio web ............................................ 157Registrar el repositorio para los servicios encadenados................................. 158Eliminar del Registro la identidad del repositorio para los serviciosencadenados.............................................................................................. 159Abrir servicios DFS típicos (únicos o encadenados) ...................................... 159Configurar una actividad Iniciar desde servicio web....................................... 160Configurar una actividad Esperar al servicio web .......................................... 161Configurar una actividad Publicar documento ............................................... 163Configurar una actividad Documento de publicación avanzado ...................... 164Configurar una actividad de ciclo de vida...................................................... 166Configurar una actividad de aplicar ciclo de vida ........................................... 166

Conceptos ..................................................................................................... 167


Tabla de Contenidos

Actividades de proceso ............................................................................... 167Determinar las actividades que se van a utilizar ............................................ 169Determinar qué ejecutor de tarea se va a utilizar........................................... 173Usar colas de trabajos para el procesamiento de tareas ................................ 175Roles de colas de trabajos........................................................................... 176Tareas de usuario final ................................................................................ 177Controlar menús contextuales para las listas de tareas de usuario final ........... 179Asociar conjuntos de habilidades de usuario final a tareas de colas detrabajos ...................................................................................................... 180Descripción de los niveles de prioridad de tareas .......................................... 180Módulos de prioridad de tarea personalizados .............................................. 181Cambiar el acceso de los usuarios finales a los objetos................................. 182Leer desde la base de datos ....................................................................... 182Llamar al procedimiento de la base de datos ................................................ 182Escribir en la base de datos ........................................................................ 183Actividad Enviar correo electrónico............................................................... 183Iniciar un proceso cuando se recibe un mensaje de correo electrónico ........... 183Llamar a un proceso ................................................................................... 184Usar una señal para desencadenar un proceso principal ............................... 184Iniciar un proceso cuando se recibe una solicitud HTTP ................................ 184Ampliar la funcionalidad del proceso ............................................................ 185Iniciar un proceso cuando se recibe un mensaje de JMS............................... 185Llamar a servicio web.................................................................................. 185Invocar un servicio web seguro .................................................................... 185Invocar Documentum Foundation Services (DFS) desde xCP Designer ........... 186Asignaciones de datos implícitos del servicio web......................................... 186Iniciar un proceso cuando se recibe un mensaje SOAP................................. 187Usar Document Sciences xPression............................................................. 187Código de ejemplo de XML de datos de cliente............................................. 187Ciclo de vida............................................................................................... 188

Capítulo 7 Trabajar con flujos y asignaciones de datos ................................................ 189Tareas ........................................................................................................... 189Conectar actividades con flujos.................................................................... 189Cambiar la apariencia de flujos .................................................................... 189Configurar una actividad de flujo paralelo ..................................................... 190Agrupar actividades de proceso ................................................................... 190Anotar el modelo de proceso ....................................................................... 191Cambiar una imagen de la actividad de proceso ........................................... 192Configurar condiciones de desencadenamiento para iniciar unaactividad..................................................................................................... 192Definir temporizadores de actividad.............................................................. 193Configurar transiciones entre actividades ..................................................... 194Configurar una transición condicional entre actividades................................. 195Configurar notificaciones por correo electrónico de actividad ......................... 196Configurar los datos de proceso dentro de una actividad ............................... 196Asignar datos de proceso ............................................................................ 197Configurar una función de asignación de datos ............................................. 199Agregar atributos de varios valores .............................................................. 199Configurar el contexto para un atributo de varios valores............................... 199Agregar un nodo a un mensaje .................................................................... 200Agregar un nodo condicional a los datos del proceso .................................... 201Asignar datos de uno a varios nodos............................................................ 201Usar un esquema XML para representar una estructura de contenido ............ 202Usar contenido en un proceso ..................................................................... 202

Conceptos ..................................................................................................... 203Flujos ......................................................................................................... 203Flujos paralelos .......................................................................................... 204


Tabla de Contenidos

Organizar actividades de proceso en grupos ................................................ 206Descripción de los iconos de proceso que se van a utilizar ............................ 207Usar las condiciones de desencadenamiento para iniciar una actividad ........... 208Usar temporizadores de actividad en un proceso .......................................... 208Ejemplos de expresiones de duración de temporizadores de actividad ........... 209Usar transiciones para especificar las actividades siguientes delproceso ...................................................................................................... 211Notificaciones de actividad .......................................................................... 212Asignar datos dentro de actividades............................................................. 212Asignación de datos de procesos................................................................. 213Funciones de la asignación de datos............................................................ 215Atributos de varios valores........................................................................... 217Usar atributos de varios valores como entrada a funciones............................ 218Especificar condiciones para datos de asignación......................................... 218Vales de inicio de sesión ............................................................................. 219

Capítulo 8 Crear búsquedas, listas e informes de análisis............................................ 221Tareas ........................................................................................................... 221Crear una consulta...................................................................................... 221Editar las propiedades básicas de las consultas............................................ 221Configurar entradas predefinidas ................................................................. 222Configurar entradas de usuario .................................................................... 223Configurar un conjunto de datos de consulta en tiempo real .......................... 225Buscar en los objetos relacionados .............................................................. 226Suscribir una consulta histórica a un evento de negocio ................................ 227Configurar un conjunto de datos de consulta histórica ................................... 227Crear una columna de duración en una consulta histórica ............................. 228Crear una columna calculada en una consulta histórica................................. 228Aplicar una función de agregación a una consulta histórica ........................... 229Editar una columna calculada o de duración en una consulta histórica ........... 229Editar una columna agregada en una consulta histórica ................................ 229Configurar entradas de usuario de consulta histórica..................................... 230Usar la acción de volver a agregar en una consulta histórica ......................... 230Utilizar la acción de limpieza en una consulta histórica .................................. 231Configurar un conjunto de datos de consulta de texto completo ..................... 232Configurar entradas predefinidas de consulta de texto completo .................... 234Configurar entradas de usuario de consulta de texto completo....................... 235Configurar facetas de consulta de texto completo ......................................... 236Buscar contenido del repositorio .................................................................. 238Buscar contenido de carpeta ....................................................................... 239Crear una consulta de lista de tareas ........................................................... 240Configurar las propiedades básicas de una consulta de lista de tareas ........... 240Configurar un conjunto de datos de consulta de lista de tareas ...................... 242Optimizar la frecuencia de agregación de consultas históricas ....................... 243Actualizar una página después de modificar un modelo de consulta............... 244Configurar un conjunto de datos de consulta de alerta................................... 246Requisitos previos de Crystal Reports .......................................................... 248Conexiones de los informes de Crystal Reports ............................................ 249Configurar un informe de Crystal Reports mediante una conexión XML ........... 250Crear un artefacto de Crystal Reports .......................................................... 250Diseñar el informe de Crystal Reports .......................................................... 251Enlazar el informe de Crystal Reports .......................................................... 252Configurar un informe de Crystal Reports mediante una conexiónJDBC ......................................................................................................... 252Crear un artefacto de Crystal Reports .......................................................... 252Diseñar el informe de Crystal Reports .......................................................... 253Enlazar el informe de Crystal Reports .......................................................... 254Crear una consulta avanzada sobre el repositorio ......................................... 254


Tabla de Contenidos

Conceptos ..................................................................................................... 256Búsquedas ................................................................................................. 256Consultas ................................................................................................... 257Diseñar una experiencia de búsqueda.......................................................... 258Crear instrucciones de orden ....................................................................... 259Determinar cuándo utilizar una consulta en tiempo real o histórica ................. 259Modelo principal.......................................................................................... 260Conjunto de datos....................................................................................... 261Entradas predefinidas ................................................................................. 262Entradas de usuario .................................................................................... 263Sintaxis de consulta compatible para la búsqueda de texto completo ............. 263Determinar cuándo utilizar una consulta en tiempo real o de textocompleto .................................................................................................... 266Consulta en tiempo real............................................................................... 267Relaciones en consultas.............................................................................. 268Ajustar consultas en tiempo real para obtener un rendimiento óptimo............. 271Consulta de texto completo ......................................................................... 272Facetas ...................................................................................................... 273Resumen.................................................................................................... 274Ajustar consultas de texto completo para obtener un rendimientoóptimo........................................................................................................ 274Detección de idioma para las consultas de texto completo............................. 275Manejar consultas de texto completo grandes............................................... 276Vista previa de consulta en tiempo real o consulta de texto completo ............. 277Consultas históricas .................................................................................... 278Recopilar datos de las aplicaciones.............................................................. 278Ciclo de vida de un evento supervisado........................................................ 278Impacto de las condiciones de eventos de negocio en los informes................ 279Comparar entradas predefinidas con condiciones de eventos denegocio ...................................................................................................... 281Configurar eventos de negocio para crear informes sobre objetosrelacionados ............................................................................................... 281Determinar qué cálculo configurar................................................................ 283Pasos de cálculo......................................................................................... 284Agregación en relaciones de uno a uno........................................................ 285Agregación en relaciones uno a muchos ...................................................... 286Ejemplos de columnas calculadas................................................................ 288Consulta de lista de tareas .......................................................................... 288Migración de informes de Crystal Reports..................................................... 291Filtros de informes de Crystal Reports .......................................................... 292Consulta avanzada sobre el repositorio ........................................................ 292

Capítulo 9 Crear páginas de interfaz de usuario............................................................ 295Tareas ........................................................................................................... 295Editar la página Patrón de aplicaciones ........................................................ 295Crear una página de aplicación.................................................................... 296Editar una página de aplicación ................................................................... 296Crear una versión de rol .............................................................................. 297Agregar un rol a una versión de rol............................................................... 297Eliminar un rol de una versión de rol ............................................................ 297Configurar una acción de menú de contexto ................................................. 297Crear una página de objeto de negocio ........................................................ 300Editar una página de objeto de negocio........................................................ 301Crear un fragmento de página ..................................................................... 302Crear una página de carpeta ....................................................................... 304Editar una página de carpeta ....................................................................... 305Crear una página de contenido .................................................................... 305Editar una página de contenido.................................................................... 306


Tabla de Contenidos

Crear una página para iniciar un proceso ..................................................... 306Crear una página de tarea ........................................................................... 306Eliminar una página .................................................................................... 307Crear una página de archivador ................................................................... 307Importar un tema ........................................................................................ 308Agregar un widget a una página................................................................... 308Configurar un fragmento de página .............................................................. 309Agregar un atributo heredado a una página .................................................. 310Eliminar un widget de una página................................................................. 310Seleccionar un widget en un editor de diseño ............................................... 310Agregar un widget personalizado a una aplicación ........................................ 311Configurar un árbol de contenido ................................................................. 311Crear un menú de navegación ..................................................................... 312Configurar un menú de navegación.............................................................. 312Configurar un widget de diseño de borde...................................................... 314Configurar un widget de acordeón................................................................ 316Crear un cuadro de columna........................................................................ 317Configurar un cuadro de columna ................................................................ 317Agregar un widget a un widget contenedor ................................................... 319Configurar un área de contenido .................................................................. 320Configurar un widget Grupo de pestañas...................................................... 320Configurar una casilla de verificación ........................................................... 322Configurar la entrada y visualización de comentarios .................................... 323Configurar un widget de entrada de fecha y hora .......................................... 325Configurar un campo para la entrada de un número...................................... 328Configurar un área de texto ......................................................................... 329Configurar un campo para la entrada de texto............................................... 331Configurar un widget de lista desplegable..................................................... 333Habilitar anexos de proceso......................................................................... 335Configurar la selección de archivos .............................................................. 336Habilitar la selección de objetos ................................................................... 338Crear una lista de resultados ....................................................................... 340Configurar un widget Lista de resultados ...................................................... 341Configurar columnas en una lista de resultados ............................................ 344Dar formato a una columna de enteros......................................................... 348Dar formato a una columna flotante.............................................................. 349Dar formato a una columna de hora y fecha.................................................. 349Agregar una columna a una lista de resultados ............................................. 350Eliminar una columna de una lista de resultados........................................... 350Mostrar una lista de relaciones .................................................................... 350Configurar el widget Visualización de errores................................................ 351Configurar un campo de texto enriquecido.................................................... 352Configurar un widget de visualización de valores .......................................... 353Enlazar campos a datos .............................................................................. 354Configurar un widget de vista de carpeta ...................................................... 355Configurar un widget de visor ...................................................................... 356Configurar la apariencia de una imagen ....................................................... 357Configurar un menú de acción ..................................................................... 359Editar una interacción.................................................................................. 360Configurar un gráfico de columna y de línea ................................................. 361Configurar un gráfico de barras.................................................................... 363Configurar un gráfico circular o de donut ...................................................... 364Configurar un gráfico indicador .................................................................... 365Configurar gráficos que se actualizan dinámicamente ................................... 366Configurar un botón de opción ..................................................................... 367Definir un evento de interfaz de usuario personalizado .................................. 368Configurar un evento de interfaz de usuario.................................................. 369Crear un parámetro de sesión...................................................................... 370


Tabla de Contenidos

Actualizar un parámetro de sesión ............................................................... 371Publicar eventos de IU ................................................................................ 371Suscribirse a eventos de IU ......................................................................... 371Configurar un widget de Google Maps.......................................................... 372Instalar la extensión de explorador de CTF................................................... 374Instalar la aplicación nativa de CTF.............................................................. 374

Conceptos ..................................................................................................... 375Patrón de aplicaciones ................................................................................ 375Tema azul claro .......................................................................................... 376Páginas de aplicaciones.............................................................................. 379Administrar la página Parámetros de aplicación ............................................ 379Versiones de rol .......................................................................................... 379Páginas de inicio de proceso ....................................................................... 379Páginas de tareas ....................................................................................... 379Fragmentos de página ................................................................................ 380Plantillas de página de objeto de negocio predefinidas .................................. 380Widgets...................................................................................................... 381Paleta de widgets........................................................................................ 381Determinar qué widget utilizar...................................................................... 382Actualizar widgets de entrada de forma dinámica.......................................... 386Determinar qué widget de gráfico utilizar ...................................................... 386Editores de diseño ...................................................................................... 388Selección de widgets................................................................................... 388Validación de widgets.................................................................................. 388Sección Interacciones del editor de diseño ................................................... 389Iconos del panel Interacciones..................................................................... 389Menús de navegación ................................................................................. 390Cuadros de columna ................................................................................... 390Comportamiento en tiempo de ejecución de un widget de cuadro decolumna ..................................................................................................... 391Formatos de fecha y hora............................................................................ 393Listas de resultados .................................................................................... 394Widgets visor.............................................................................................. 394Widgets Visualización de errores ................................................................. 395Widgets de gráficos..................................................................................... 395Gráficos indicador ....................................................................................... 396Granularidad de tiempo ............................................................................... 396Actualizar gráficos de forma dinámica .......................................................... 397Parámetro de sesión ................................................................................... 399Evento de interfaz de usuario ...................................................................... 399Eventos de IU de OOTB.............................................................................. 401Editar fácilmente en tiempo de ejecución...................................................... 410Flujos de acción de las funcionalidades de ECM........................................... 411Arrastrar y soltar ......................................................................................... 414Arrastrar y soltar desde Outlook................................................................... 415Mapa de Google ......................................................................................... 415Mecanismo de transferencia de contenido .................................................... 417Marco de trabajo de transferencia de contenido ............................................ 417Requisitos previos....................................................................................... 418Consejos sobre solución de problemas ........................................................ 418Aspecto de widget....................................................................................... 419Paleta de esquema ..................................................................................... 421

Capítulo 10 Configurar acciones de la interfaz de usuario.............................................. 423Tareas ........................................................................................................... 423Crear un botón............................................................................................ 423Configurar un botón .................................................................................... 423Agregar un botón de acción Crear a una página de modelo de objeto ............ 426


Tabla de Contenidos

Agregar un botón de acción Actualizar a una página de modelo deobjeto......................................................................................................... 427Agregar un botón de acción Eliminar a una página de modelo deobjeto......................................................................................................... 427Crear un flujo de acción............................................................................... 428Crear un flujo de acción para agregar relaciones........................................... 428Redactar modelo de un flujo de acción ......................................................... 429Crear un paso en un flujo de acción ............................................................. 432Eliminar un flujo de acción ........................................................................... 432

Conceptos ..................................................................................................... 433Flujo de acción ........................................................................................... 433

Capítulo 11 Usar visores ................................................................................................. 435Conceptos ..................................................................................................... 435Visores compatibles .................................................................................... 435Cuándo habilitar clientes DFC con privilegios................................................ 436Eventos de aplicación del visor .................................................................... 436

Capítulo 12 Crear expresiones ........................................................................................ 439Tareas ........................................................................................................... 439Crear una expresión mediante Autocompletar............................................... 439Crear una expresión mediante el selector ..................................................... 439

Conceptos ..................................................................................................... 440Expresiones ............................................................................................... 440Operadores ................................................................................................ 442Funciones .................................................................................................. 443Funciones de fecha..................................................................................... 444Funciones de metadatos descubiertos.......................................................... 453Funciones de lista ....................................................................................... 455Funciones lógicas ....................................................................................... 458Funciones matemáticas............................................................................... 463Funciones de cadena .................................................................................. 468Funciones de contenido .............................................................................. 476Funciones de fragmento de página .............................................................. 477Funciones de fragmento de tipo ................................................................... 478Funciones de URL ...................................................................................... 480Funciones de aplicación .............................................................................. 481Funciones condicionales ............................................................................. 481Funciones de recopilaciones........................................................................ 482

Capítulo 13 Empaquetar e implementar aplicaciones ..................................................... 483Tareas ........................................................................................................... 483Agregar un entorno de implementación ........................................................ 483Agregar un entorno de tiempo de diseño ...................................................... 484Crear una configuración de ejecución........................................................... 485Editar una configuración de ejecución .......................................................... 487Ejecutar una aplicación en un entorno de implementación ............................. 488Empaquetar una aplicación para una implementación posterior ..................... 488Configurar las opciones de tiempo de espera de la aplicación........................ 489Empaquetar mediante Apache Maven.......................................................... 489Adoptar modelos de objeto de un repositorio ................................................ 494Migrar tipos de Composer ........................................................................... 494Utilizar el navegador de migración ............................................................... 495

Conceptos ..................................................................................................... 496Configuraciones para la ejecución de aplicaciones........................................ 496Empaquetar una aplicación ......................................................................... 497Empaquetar mediante la interfaz de la línea de comandos ......................... 498


Tabla de Contenidos

Archivo de registro de implementación de aplicaciones ................................. 498Modo de vista previa ................................................................................... 499Modo de vista previa mejorado en el servidor Tomcat.................................... 500Casos de uso del modo de vista previa ........................................................ 501Compilar automáticamente .......................................................................... 503Validar una aplicación ................................................................................. 504Opciones de implementación para la productividad de losdesarrolladores........................................................................................... 504Adopción de tipo ......................................................................................... 505Lista de verificación de migración................................................................. 506Navegador de migración.............................................................................. 507Migración de procesos ................................................................................ 508Biblioteca de extensión del núcleo ............................................................... 517Migración de tipos de datos estructurados .................................................... 517

Capítulo 14 Administrar una aplicación .......................................................................... 519Tareas ........................................................................................................... 519Añadir miembros a un rol............................................................................. 519Eliminar miembros de un rol ........................................................................ 519Cambiar el nombre de un artefacto .............................................................. 519Mover un artefacto ...................................................................................... 520

Conceptos ..................................................................................................... 520Cambiar el nombre de un artefacto o moverlo............................................... 520

Capítulo 15 Solución de problemas de implementación de aplicaciones........................ 523Los metadatos descubiertos no están disponibles ............................................ 523Una consulta de texto completo no devuelve resultados ................................... 524Las facetas están vacías ................................................................................ 526Error en las actividades salientes al configurarlas para crear conexionesseguras para la distribución de mensajes......................................................... 527Se ha reducido el rendimiento del sistema ....................................................... 528SSO falla cuando hay más de una aplicación implementada en el mismoservidor de aplicaciones ................................................................................. 528Bloqueo en la actividad de correo electrónico entrante ..................................... 528Borrar los archivos temporales del directorio Temp........................................... 529

ApéndiceA Usar el Visor de contenido de xCP............................................................... 531


PrefacioEsta guía describe cómo diseñar y configurar las aplicaciones con xCP Designer.

Audiencia destinataria

La información en esta guía está dirigida a los desarrolladores de aplicaciones que utilizan xCPDesigner para diseñar, desarrollar y configurar las aplicaciones.

Historial de revisiones

En la siguiente tabla se indican los cambios de esta guía.

Fecha de revisión Descripción

Julio de 2016 Publicación inicial


Capítulo 1

Introducción

En este capítulo se trata lo siguiente:

• xCelerated Composition Platform Designer• Diseñar una aplicación• Planificar• Crear la aplicación y los artefactos• Diseñar los modelos de proceso• Configurar los servicios de datos de consulta• Diseñar la interfaz de usuario• Probar la aplicación• Empaquetar la aplicación

xCelerated Composition Platform DesignerEMC® Documentum® xCelerated Composition Platform (xCP) Designer es un conjunto unificadode herramientas para diseñar e implementar aplicaciones de software rápidamente. xCP Designerfacilita la colaboración en equipo, ya que permite a los diseñadores de aplicaciones crear y reutilizarcomponentes de aplicaciones, lo cual reduce el tiempo y coste de construir aplicaciones verticales.Esto permite a las organizaciones configurar una aplicación en lugar de escribir código para crear unaaplicación, lo que ayuda a ser más ágiles y tener una mejor capacidad de respuesta ante los cambiosdel mercado.

Procedimientos recomendados: coloque el xCP Designer en una carpeta del nivel de raíz. Porejemplo, C:\xCPDesigner\

Diseñar una aplicaciónLa siguiente figura ilustra el proceso de alto nivel para diseñar una aplicación:

EMC Documentum xCelerated Composition Platform Designer Versión 2.3 Guía delusuario 15

Introducción

El diseño de una aplicación es un proceso repetitivo. Cada repetición implica planificar, crear ymodificar los componentes de la aplicación, y probar la aplicación para comprobar que satisface losrequisitos de negocio. La complejidad de la aplicación determina el número de repeticiones y elalcance de cada repetición.

PlanificarEs importante llevar a cabo una planificación al detalle para las aplicaciones de xCP Designer, ya queesto puede marcar la diferencia para el éxito o el fracaso del proyecto. Este tema explica variosaspectos de la planificación.

RequisitosConocer los requisitos del negocio y del sistema es fundamental para el diseño de una aplicación xCPque satisfaga sus necesidades. La recopilación de la siguiente información sirve de punto de partidapara identificar los requisitos de la aplicación xCP.

• Entorno técnico actual

• Casos de uso generales y del sistema

• Volúmenes de transacción estimada como, por ejemplo, el número de documentos escaneados

• Roles de usuarios, estructuras de usuario y de grupo, y las directivas para su mantenimiento

• Requisitos de seguridad

• Diagramas de procesos de negocio

• Puntos de integración del sistema como, por ejemplo, servidores de correo electrónico, bases dedatos, servicios web, etc.

• Tipos de contenido e información que administra el sistema, incluidos ejemplos

• Relaciones entre información y cómo se mantienen estas

• Contenido para la información saliente como, por ejemplo, cartas generadas, mensajes de correoelectrónico, etc.

InformesA la hora de planificar cómo utilizar los informes en su aplicación, considere las siguientes decisiones:


Introducción

• Determine si el informe contiene datos históricos o datos en tiempo real. Esto le ayudará a decidir sidebe crear una consulta en tiempo real o histórica.

• Determine los datos que desea incluir en el informe.

• Determine si los datos del informe se filtran automáticamente o si los usuarios finales puedenseleccionar los filtros que se aplican.

• Determine si el informe incluye cálculos.

• Determine el tipo de informe que desea configurar como, por ejemplo, un gráfico de columnas, delíneas, circular o indicador.

• Determine si los datos de informe se actualizan cada hora, diariamente, semanalmente,trimestralmente o anualmente.

Buscar

A la hora de planificar cómo utilizar la búsqueda en su aplicación, considere las siguientes decisiones:

• Determine si los usuarios finales saben específicamente lo que desean buscar, si necesitan losresultados de forma rápida y si la búsqueda se utiliza en detección abierta, por ejemplo, cuando unusuario final genera una lista de los documentos relacionados con una tecnología. Estas decisionesrepercuten en el modo en que se configura la función de búsqueda, lo que determina la cantidad dedatos devueltos por la búsqueda y qué filtros configurar de modo que los usuarios finales puedanencontrar rápidamente la información que necesitan.

• Determine si los usuarios finales tienen permiso para buscar cualquier tipo de contenido y si tienenacceso tanto a metadatos como a contenido.

• Determine si los usuarios finales filtran el conjunto de resultados ellos mismos o si deben predefinirel alcance de las búsquedas.

Implementación

Durante la fase de planificación, tome nota de cualquier aspecto del sistema que pueda cambiar cuandola aplicación se transfiera desde el entorno de implementación al de producción. Por ejemplo, las basesde datos utilizadas por la aplicación, por lo general, cambian al moverse al entorno de producción.Los usuarios asignados a actividades específicas también pueden ser diferentes en el entorno deproducción. Es importante compilar un inventario completo de estos elementos que se van a utilizardurante la implementación.

También debe saber si el entorno de producción contiene datos y si estos se han indexado portexto completo o se necesita volver a indexarlos. En función del número de objetos del índice, lareindexación puede durar hasta varios días.

Mientras que la indexación se puede aplazar e iniciar de forma manual mediante la herramienta deadministración de xPlore, debe planificar su entorno de xPlore según los requisitos del cliente. Utilicela herramienta de ajuste del tamaño de xPlore y EMC Documentum xPlore Installation Guide (Guía deinstalación de EMC Documentum xPlore) para ayudarle a configurar el entorno de xPlore.


Introducción

Crear la aplicación y los artefactosEn el siguiente gráfico se muestra el proceso para crear una aplicación y artefactos:

Después de planificar la aplicación, cree la aplicación desde la página de Inicio. xCP Designer creaautomáticamente un proyecto de aplicación en el sistema de archivos y el modelo de aplicación. Amedida que crea la aplicación, el modelo de aplicación evoluciona para contener el modelo de tiempode diseño para todos los artefactos que conforman la aplicación. Puede crear proyectos adicionales enel proyecto de aplicación para almacenar artefactos que se puede reutilizar entre otras aplicaciones yproyectos en su entorno de xCP Designer.

Después de crear la aplicación, utilice el Navegador de aplicaciones para crear componentes de nivel deaplicación. Los componentes de nivel de aplicación son artefactos del repositorio de Documentum quedefinen la funcionalidad a través de la aplicación. Puede crear roles de aplicación, parámetros, puntosfinales, componentes de seguridad, como, por ejemplo, conjuntos de permisos y plantillas de correoelectrónico. También puede especificar la configuración del visor para ver el contenido de la aplicación.

Después de crear modelos de nivel de aplicación, utilice el navegador de modelos de objeto para crearmodelos de objeto y configurar sus atributos. Los modelos de objeto son artefactos del repositoriode Documentum que definen instancias de objetos creadas por usuarios finales de la aplicación entiempo de ejecución. Los usuarios finales especifican valores de atributo para describir las instanciasde objetos que crean. Puede crear modelos de objeto de negocio, objeto de contenido, carpeta, listadesplegable y relación.

Diseñar los modelos de procesoDespués de crear la aplicación y los artefactos, se diseña el modelo de proceso. Un modelo de procesoproporciona la capacidad de configurar cómo fluye la información a través de una serie de actividades.Pueden ser actividades generadas automáticamente o actividades que requieren la interacción humana.Por ejemplo, puede crear un modelo de proceso que se utilice para la creación, revisión y aprobaciónde aplicaciones de préstamo.

En el siguiente gráfico se muestran los pasos para el diseño de modelos de proceso:

Al diseñar el modelo de proceso, puede definir las propiedades del proceso. Esto incluye decidir sidesea ejecutar el proceso de forma sincrónica en un modo sin estado o de forma asíncrona en un modo


Introducción

con estado. También incluye determinar quién puede iniciar el proceso y acceder a información delproceso mediante permisos.

Los datos de proceso son datos que fluyen a través del proceso en tiempo de ejecución. Los datosde proceso incluyen paquetes, variables de proceso y parámetros de aplicación. Las propiedades delmodelo de proceso le permiten especificar paquetes y variables de proceso. Mediante el uso de datosde proceso, un proceso puede crear o actualizar objetos de negocio, contenido y carpetas. Puederestringir el acceso a los datos de proceso a los usuarios finales en cualquier momento del mismo.

Un proceso crea y actualiza información mediante actividades de proceso. Las actividades del modelode proceso representan las tareas en el proceso de negocio. Las actividades de proceso le permiten:

• Crear y asignar tareas a los usuarios finales mediante las reglas de negocio o la lógica

• Enviar y recibir información de sistemas externos usando los puntos finales

• Ampliar el proceso utilizando código personalizado o utilizar actividades predefinidas

La información fluye a través de actividades en el modelo de proceso mediante los flujos de proceso.Los flujos conectan las actividades, determinan las rutas de acceso que se van a tomar en el proceso yestablecen cuándo se inician las actividades. Los flujos utilizan transiciones para determinar qué rutasseguir en el proceso. Los flujos utilizan desencadenadores para determinar cuándo seguir una ruta.

Una vez que haya configurado el modelo de proceso, puede diseñar la interfaz de usuario para losusuarios finales.

Configurar los servicios de datos de consultaDespués de crear la aplicación y los artefactos, puede configurar consultas. Una consulta coge laentrada y devuelve datos que puede formatear de varias formas, como en listas o gráficos.

En el siguiente gráfico se muestra el proceso para la configuración de los servicios de datos de consulta:

Las consultas se crean para proporcionar datos específicos que ayudan a los usuarios finales a realizarsu trabajo. En función de las necesidades del usuario final, puede seleccionar uno de los siguientestipos de consulta:

• Consulta histórica: proporciona a los usuarios finales datos calculados como totales, comparacionesde cantidades y agregaciones.

• Consulta en tiempo real: muestra una lista de objetos.

• Consulta de texto completo: permite a los usuarios finales buscar en los metadatos y el contenidode sus objetos.


Introducción

• Consulta de lista de tareas: muestra un conjunto de tareas incompletas para un usuario final ouna cola de trabajos.

Para la mayoría de las consultas, el conjunto de datos muestra los valores de los campos de datos engráficos, tablas, facetas o listas de resultados. Para las consultas históricas, puede suscribirse a loseventos de negocio antes de diseñar el conjunto de datos. Cuando la aplicación desencadena un eventode negocio, el sistema registra datos de aplicación y hace que estén disponible para la generación deinformes. Puede utilizar las columnas de conjunto de datos en un cálculo.

Puede configurar entradas de usuario y facetas que los usuarios finales pueden utilizar para filtrar losdatos. Las facetas ayudan a los usuarios finales mostrándoles solo valores existentes, lo que impideque se produzcan consultas sin respuesta. Las entradas de usuario permiten a los usuarios finalesintroducir sus propios criterios de consulta.

Diseñar la interfaz de usuarioDespués de que ha diseñado los modelos de proceso y ha configurado el servicio de datos de consulta,se diseña la interfaz de usuario. La interfaz de usuario que se diseña es lo que el usuario final vecuando inicia sesión en la aplicación y es la interfaz para introducir y recuperar datos, iniciar procesosy realizar tareas. Los usuarios finales en roles diferentes ven diferentes páginas y widgets.

En el siguiente gráfico se muestra el proceso de diseño de la interfaz de usuario:

El sistema crea de forma automática una plantilla Patrón de aplicaciones al crear una aplicación. Puedeagregar, quitar, modificar o cambiar de ubicación los widgets de la página del patrón de aplicacionespara determinar qué aparece en las páginas de la interfaz de usuario de la aplicación.

Los flujos de acción presentan una única pantalla, o un asistente, que ayuda a los usuarios finales arealizar una tarea. Un flujo de acción está asociado a un determinado objeto de negocio. Reviselas tareas y los procesos para determinar qué flujos de acción son necesarios para que los usuariosfinales lleven a cabo su trabajo.

Se crean páginas para ofrecerlas al usuario final de la capa de presentación de la aplicación. En lasiguiente tabla se describen los distintos tipos de páginas:


Introducción

Página Descripción

Aplicación Contiene el contenido administrado por la aplicación,no el contenido que forma parte de un caso concreto.Por ejemplo, puede crear una página principal opáginas de aplicación para contenidos como informes,listas de tareas y colas de trabajo.

Modelo de objeto Permita que el usuario final vea, cree o edite unmodelo de objeto como un objeto de negocio,una carpeta o contenido. Puede utilizar plantillaspredefinidas al crear estas páginas, o crear sus propiasplantillas partiendo de cero.

Sistema Son páginas de la interfaz de usuario predefinidasque reducen el tiempo necesario para crear laaplicación. Puesto que las páginas del sistema ofrecenfuncionalidad predefinida, no puede editar el diseñoo los widgets, pero puede asignar funciones a laspáginas para determinar quién puede acceder a ellas.

Los editores de diseño ofrecen la posibilidad de agregar, quitar o modificar widgets en una página paraproporcionar el aspecto final, la funcionalidad y la experiencia del usuario de la aplicación.

Una vez que se ha diseñado la interfaz de usuario para los usuarios finales, puede probar la aplicación.Nota: xCP Designer empaqueta la biblioteca FontAwesomehttp://fortawesome.github.IO/Font-Awesome/ con él. Según sus requisitos, puede utilizar clasesCSS de la biblioteca.

Probar la aplicaciónEn el siguiente gráfico se muestra el proceso para probar la aplicación:

Después de diseñar la interfaz de usuario, debe configurar un entorno de implementación para probar laaplicación. Al establecer una configuración de ejecución y asociarla a un entorno de implementación,no tiene que especificar la configuración de implementación cada vez que pruebe la aplicaciónejecutándola desde xCP Designer. Al probar la aplicación, puede verificar que cumple los requisitosestablecidos durante la fase de planificación. Si es necesario, puede probar distintos valores de puntofinal y parámetro y actualizar estos valores en la configuración de ejecución.

Empaquetar la aplicaciónDespués de diseñar la aplicación y probarla para comprobar que cumple todos los requisitos denegocio, se empaqueta para su implementación:


http://fortawesome.github.io/Font-Awesome/

Introducción

Cuando empaqueta una aplicación, xCP Designer hace lo siguiente:

• Valida la aplicación

• Compila la aplicación como un archivo de aplicación web (archivo WAR).

• Copia el archivo WAR a la estructura de carpetas de la aplicación en el sistema de archivos.

Cuando el archivo WAR está disponible, se entrega al administrador del sistema para laimplementación. EMC Documentum xCelerated Composition Platform Deployment Guide (Guía deimplementación de EMC Documentum xCelerated Composition Platform) y EMC DocumentumxCelerated Management System Deployment Guide (Guía de implementación de EMC DocumentumxCelerated Management System) proporcionan más información sobre la implementación deaplicaciones.


Capítulo 2

Creación de aplicaciones y proyectos


• Tareas• Conceptos

Tareas

Crear una aplicación

1. En la página principal, haga clic en Nueva aplicación.

2. En el cuadro de diálogo Nueva aplicación xCP, configure las propiedades básicas de la aplicacióntal y como se describe en la tabla siguiente:

Campo Descripción

Nombre de aplicación Escriba un nombre de aplicación.

Nombre de carpeta raíz Escriba un nombre de carpeta raíz de la aplicación más descriptivo sino desea utilizar el nombre de la aplicación.

Después de crear la aplicación, la carpeta raíz aparece en la carpetaAplicaciones. La longitud máxima de la ruta de acceso de la carpetaraíz es de 128 caracteres. El ejemplo siguiente muestra la ruta deacceso a una aplicación denominada Préstamo:

C:\xCPDesigner\Applications\Loan

Descripción Escriba una descripción de la aplicación.

3. Haga clic en Siguiente.

4. Configure el proyecto de aplicación, tal y como se describe en la tabla siguiente:



Campo Descripción

Espacio de nombres Escriba un prefijo para darle a un artefacto creado en el proyecto deaplicación un nombre del sistema único. Los espacios de nombresevitan conflictos entre proyectos que tienen artefactos con las mismasetiquetas.

Asegúrese de que el espacio de nombres no se esté utilizando en elentorno de tiempo de ejecución. Para comprobar si el espacio denombres ya existe en el entorno, recupere una lista de espacios denombres. Para ello, ejecute el siguiente comando en el equipo delrepositorio de Documentum:

select namespace from xcp_artifact_bundle (all)

Carpeta de proyecto De forma predeterminada, el sistema crea la carpeta del proyecto deaplicación en la carpeta raíz de la aplicación. Para utilizar una carpetadiferente, seleccione la opción para cambiar las carpetas de proyectoy haga clic en Examinar. En el ejemplo siguiente se muestra la rutade acceso a la carpeta de proyecto de una aplicación denominadaPréstamo:

C:\xCPDesigner\Applications\Loan\Loan

Para utilizar una unidad de red compartida, asigne una unidad delequipo a la ruta de acceso de Convención de nomenclatura uniforme(UNC) antes de crear la aplicación. Por ejemplo, asigne la unidad Z a\\network_drive\xcp_apps. Al crear la aplicación, seleccione la opciónpara cambiar las carpetas de proyecto y elija la unidad asignada.

Si utiliza un sistema de control de origen para compartir recursos,agregue la carpeta del proyecto de aplicación al repositorio de controlde origen. Consulte la documentación del sistema de control deorigen para obtener más información sobre la adición de recursos alrepositorio de control de origen.

5. Haga clic en Finalizar.

Editar una aplicación1. Abra la aplicación desde la página Inicio.

2. En el editorModelo de aplicación, seleccione el proyecto de aplicación.

3. En la pestaña General de la vista Propiedades, edite los campos tal y como se describen en latabla siguiente:

Campo Descripción

Nombre Muestra el nombre de aplicación.

Espacio de nombres Muestra el espacio de nombre del proyecto de aplicación.

Descripción Escriba una descripción de la aplicación.



Campo Descripción

Versión Escriba un número de versión para la aplicación.

La versión de aplicación se utiliza en la dirección URL derecursos de IU. De forma predeterminada, los exploradoresde los usuarios finales almacenan en caché los recursos dela interfaz de usuario durante un año a menos que se cambieel número de versión. Si realiza un cambio en un recurso dela interfaz de usuario y no modifica el número de versión,solicite a los usuarios finales que borren las memorias cachéde sus exploradores.

A diferencia de la modificación de la versión de aplicación,el cambio de la versión del proyecto no afecta alalmacenamiento en caché.

Fecha de creación Muestra la fecha de creación de la aplicación.

Ubicación Muestra la ubicación de la carpeta del proyecto deaplicación en el sistema de archivos.

4. Haga clic en Guardar.

Exportar una aplicación1. En la página Inicio, seleccione la aplicación y haga clic en Exportar o seleccione el proyecto de

aplicación en el editorModelo de aplicación y haga clic en Exportar.2. En el cuadro de diálogo Exportar aplicación xCP, haga clic en Examinar.3. Desplácese hasta la carpeta de destino y haga clic en Aceptar.4. Para incluir los proyectos en de los que depende el proyecto de aplicación, Incluir todos los

proyectos dependientes.5. Haga clic en Finalizar.

Importar una aplicaciónLa importación de una aplicación tiene dos fines:

• Reutilizar y modificar una aplicación desarrollada usando la versión actual de xCP

• Migrar una aplicación desarrollada usando la versión anterior de xCP

De forma predeterminada, el proceso de migrar una aplicación forma parte de la importación de unproceso de aplicación. De modo que, cuando se importa una aplicación desarrollada mediante unaversión anterior de xCP, se tarda más porque también se migra la aplicación. Migrar una aplicación,página 26 proporciona más información.1. En la página principal, haga clic en Importar aplicación.2. En el cuadro de diálogo Importar aplicación xCP, haga clic en Examinar y desplácese a la

carpeta raíz de la aplicación del sistema de archivos.3. Haga clic en Aceptar.4. Seleccione el proyecto de aplicación y los proyectos admitidos en la lista de proyectos.



5. Para copiar los proyectos seleccionados a la carpeta raíz de la nueva aplicación, seleccioneImportar una copia.

No seleccione esta opción si va a importar una aplicación administrada por un sistema de controlde origen.

6. Si es necesario, escriba un nuevo nombre de carpeta raíz de la aplicación.7. Haga clic en Finalizar.

Migrar una aplicaciónSi ha desarrollado una aplicación utilizando la versión anterior de xCP, puede utilizar la versión actualde xCP Designer para migrar esa aplicación a la versión actual:1. Haga clic en Importar aplicación para importar la aplicación de biblioteca original. La aplicación

de biblioteca es el proyecto original donde creó las bibliotecas.2. Exportar los proyectos como bibliotecas:

a. Abra el modelo de aplicación y seleccione el proyecto.b. Haga clic con el botón derecho en el proyecto y seleccione Exportar proyecto.c. Desplácese a una carpeta adecuada y seleccione Exportar como una biblioteca. El sistema

migra las bibliotecas a la versión actual y exporta la biblioteca a la carpeta que haya especificado.3. Importar la aplicación:

a. Haga clic en Importar aplicación.b. En la página Aplicación xCP del asistente Importar aplicación xCP , desplácese hasta la

carpeta raíz de la aplicación. Seleccione el proyecto de aplicación y los proyectos admitidosen la lista de proyectos. Para copiar los proyectos seleccionados a la carpeta raíz de la nuevaaplicación, seleccione Importar una copia. Haga clic en Siguiente.

c. En la página Actualizar bibliotecas del asistente Importar aplicación xCP, haga clic enAgregar. Seleccione la carpeta donde haya exportado la biblioteca. Haga clic en Finalizar. Elsistema migra la aplicación a la versión actual.

Ahora puede implementar la aplicación que ha migrado en el entorno de ejecución actual.

Migrar una aplicación con CLIUtilice la interfaz de la línea de comandos (CLI) para migrar una aplicación creada con una versiónanterior de xCP a la versión actual.1. Desplácese al directorio de la aplicación xCP de su sistema de archivos.2. Ejecute el comando para migrar la aplicación.

xcpdesigner.exe -clean -application com.emc.xcp.builder.cli.CLIApplication-importLocation <project location>-projects <comma separated project names>-data <workspace>-migrate true

Ejemploxcpdesigner.exe -clean -application com.emc.xcp.builder.cli.CLIApplication-importLocation C:\xcpprojects\insuranceprojects



-projects InsuranceObjects,Claims,Vendors-data C:\tmp1\Cliwkspace2-migrate true

Argumentos

Argumento Descripción

clean Elimina todos los proyectos que se hayan generadomediante la compilación anterior.

aplicación Especifica la aplicación que desea migrar.

importLocation Especifica la ubicación a la que se importará laaplicación.

projects Especifica los proyectos dentro de la aplicación quedesea migrar.

data Se refiere a cualquier carpeta vacía antes de ejecutareste comando. Esto señala al espacio de trabajoutilizado durante la migración.

migrate Indica la migración como True.

Actualizar las bibliotecas de una aplicación medianteCLIEste procedimiento no es para migrar aplicaciones, sino para sustituir las bibliotecas que existendentro de una aplicación.1. Desplácese al directorio de la aplicación xCP de su sistema de archivos.2. Ejecute el comando para actualizar las bibliotecas existentes dentro de una aplicación.

xcpdesigner.exe -clean -application com.emc.xcp.builder.cli.CLIApplication-importLocation <project location>-projects <comma separated project names>-data <workspace>-replacementLibs Lib1[,Lib2,Lib3]

Ejemploxcpdesigner.exe -clean -application com.emc.xcp.builder.cli.CLIApplication-importLocation C:\xcpprojects\insuranceprojects-projects InsuranceObjects,Claims,Vendors-data C:\tmp1\Cliwkspace2-replacementLibs C:\tmp1\Lib1

Argumentos


clean Elimina todos los proyectos que se hayan generadomediante la compilación anterior.

application Especifica la aplicación que desea migrar.

importLocation Especifica la ubicación a la que se importará laaplicación.




projects Especifica los proyectos dentro de la aplicación quedesea migrar.

data Se refiere a cualquier carpeta vacía antes de ejecutareste comando. Esto señala al espacio de trabajoutilizado durante la migración.

replacementLibs Especifica la ruta absoluta de la biblioteca de destinocon la que desee reemplazar la biblioteca existente.

Actualizar una biblioteca, página 30 proporciona más información sobre cómo actualizar unabiblioteca de xCP Designer.

Crear un proyecto1. Abra la aplicación desde la página Inicio.2. En el área Proyectos del editorModelo de aplicación, haga clic en Nuevo.3. En el cuadro de diálogo Nuevo proyecto xCP, configure las propiedades del proyecto tal y como

se describe en la tabla siguiente:

Campo Descripción

Nombre Escriba un nombre de proyecto.

Espacio de nombres Escriba un prefijo para darle a un artefacto creado en el proyecto un nombre delsistema único. Los espacios de nombres evitan conflictos entre proyectos quetienen artefactos con las mismas etiquetas.

Carpeta de proyecto De forma predeterminada, la carpeta del proyecto se crea en la carpeta raíz de laaplicación. Para utilizar una carpeta diferente, seleccione la opción para cambiarlas carpetas y haga clic en Examinar. El ejemplo siguiente muestra la ruta deacceso a la carpeta de proyecto para un proyecto denominado Origen en unaaplicación denominada Préstamo:

C:\xCPDesigner\Applications\Loan\Origination

Para utilizar una unidad de red compartida, asigne una unidad del equipo a la rutade acceso de Convención de nomenclatura uniforme (UNC) antes de crear elproyecto. Al crear el proyecto, asigne la unidad Z a \\network_drive\xcp_apps. Alcrear el proyecto, seleccione la opción para cambiar las carpetas de proyecto yelija la unidad asignada.

Descripción Escriba una descripción del proyecto.


Editar un proyecto1. Abra la aplicación desde la página Inicio.2. Seleccione el proyecto en el editor de lienzoModelo de aplicación.3. En la pestaña General de la vista Propiedades, edite los campos tal y como se describen en la

tabla siguiente:



Campo Descripción

Nombre Muestra el nombre del proyecto.

Espacio de nombres Muestra el espacio de nombre del proyecto.

Descripción Escriba una descripción del proyecto.

Versión Escriba un número de versión para el proyecto.

A diferencia de la modificación de la versión deaplicación, el cambio de la versión del proyecto noafecta al almacenamiento en caché.

Fecha de creación Muestra la fecha de creación del proyecto.

Ubicación Muestra la ubicación de carpeta del proyecto en elsistema de archivos.


Exportar un proyecto1. En la página Inicio, seleccione la aplicación y haga clic en Abrir.2. En el editorModelo de aplicación, seleccione el proyecto en la lista de proyectos.3. Haga clic en Exportar.4. Haga clic en Examinar en el cuadro de diálogo Exportar proyecto xCP y desplácese hasta

la carpeta de destino.5. Para exportar el proyecto como una biblioteca, seleccione Exportar como una biblioteca.6. Haga clic en Finalizar.

Importar un proyecto1. Abra la aplicación desde la página Inicio.2. En el área Proyectos del editorModelo de aplicación, haga clic en Importar.3. En el cuadro de diálogo Importar proyecto xCP, haga clic en Examinar y desplácese a la carpeta

del proyecto del sistema de archivos.4. Haga clic en Aceptar.5. Seleccione la carpeta del proyecto en la lista de proyectos.6. Para copiar la carpeta de proyecto a la carpeta raíz de la aplicación, seleccione Importar una copia.7. Haga clic en Finalizar.

Agregar una bibliotecaEste procedimiento se aplica al importar una biblioteca desde una aplicación creada en las versionesactual y anteriores de xCP Designer.



No puede agregar la misma biblioteca a diferentes proyectos en una aplicación ya que cuando unaaplicación se empaqueta, el archivo WAR resultante contiene todas las bibliotecas en una carpeta. Elsistema evita que copie un archivo JAR si ya está presente en una aplicación.1. Abra la aplicación desde la página Inicio.2. En el editorModelo de aplicación, haga clic con el botón derecho en el proyecto al que desea

agregar la biblioteca y seleccione Agregar biblioteca.3. En el cuadro de diálogo Agregar biblioteca, haga clic en Examinar y desplácese a la biblioteca

de su sistema de archivos.4. Haga clic en Aceptar.5. En el área Bibliotecas que se van a copiar del cuadro de diálogo Agregar biblioteca, seleccione

la casilla de verificación junto a cada biblioteca que desee agregar.6. Haga clic en Siguiente.7. Si es necesario, especifique los metadatos de la biblioteca.8. Si es necesario, cree las dependencias entre la biblioteca y el resto de los proyectos en la aplicación.9. Haga clic en Finalizar.

Eliminar una biblioteca1. Abra la aplicación desde la página Inicio.2. En el área Bibliotecas del editorModelo de aplicación, seleccione la biblioteca.3. Haga clic en Quitar.4. Haga clic en Sí.

Actualizar una biblioteca1. Abra la aplicación desde la página Inicio.2. En el área Bibliotecas del editorModelo de aplicación, seleccione la biblioteca.3. Haga clic en Actualizar.4. En el cuadro de diálogo Actualizar biblioteca, haga clic en Examinar y vaya a la carpeta donde la

biblioteca actualizada está ubicada en el sistema de archivos.5. Haga clic en Aceptar.6. En el área Biblioteca que se va a actualizar del cuadro de diálogo Actualizar biblioteca,

seleccione la casilla de verificación junto a cada biblioteca que desee actualizar.7. Haga clic en Siguiente.8. Revise los metadatos de la biblioteca.9. Haga clic en Finalizar.

Gestionar dependencias del proyecto1. Abra la aplicación y desplácese al editorModelo de aplicación.2. Seleccione un proyecto en la lista de proyectos.3. Haga clic en la pestaña Dependencias en la vista Propiedades.



4. Para crear una dependencia entre el proyecto seleccionado en el editor y un elemento de la pestañaDependencias, active la casilla de verificación situada junto al elemento.

5. Para quitar una dependencia entre el proyecto seleccionado en el editor y un elemento de la pestañaDependencias, desactive la casilla de verificación situada junto al elemento.


Trabajar con un sistema de control de origenPuede utilizar un sistema de control de origen de terceros para administrar los recursos de la aplicación.Todas las acciones de control de origen se inician a través del cliente de control de origen de terceros.Los siguientes pasos de alto nivel resumen cómo usar un sistema de control de origen de tercerospara administrar los recursos:1. Instale el cliente y el repositorio de control de origen.2. Cree una aplicación de xCP Designer en el sistema de archivos.3. Agregue la carpeta raíz de la aplicación al repositorio de control de origen.

Excluya las siguientes carpetas (que se indican con una barra diagonal) y archivos al agregar lacarpeta raíz de la aplicación y su contenido al repositorio:

• configuration/• gen/• META-INF/• target/• .index• .generatedresources• runapp.log

4. Compruebe que la aplicación está bajo el control de origen. Para ello, confirme que las siguientescarpetas (que se indican con una barra diagonal) y archivos se encuentran en el repositorio:

• .settings/• Artifacts/• content/• lib/• src/• .classpath• .project• build.properties• pom.xml

5. Para trabajar con una aplicación que otro desarrollador ha agregado al repositorio de controlde origen:a. Retire la aplicación del repositorio de control de origen y transfiérala al directorio de retirada

del sistema de archivos.b. Importe la aplicación al entorno de xCP Designer.

No seleccione la opción para importar una copia de la aplicación.



c. Después de actualizar los recursos compartidos, regístrelos en el repositorio de control deorigen.

d. Si desea obtener los cambios registrados por otros desarrolladores, utilice el cliente de controlde origen para sincronizar el sistema de archivos local con los cambios del repositorio decontrol de origen y, a continuación, haga clic en Actualizar en la barra de herramientas de xCPDesigner para seleccionar los cambios más recientes.

Consulte la documentación del sistema de control de origen para obtener más información sobre laconfiguración de un sistema de control de origen y el uso el cliente de control de origen para completaracciones de control de origen.

Conceptos

AplicacionesUna aplicación es una colección de recursos que representan una solución empresarial. Los recursosestán formados por un proyecto de aplicación, proyectos adicionales y artefactos que contribuyen afunciones específicas dentro de la aplicación.

Cada aplicación tiene un proyecto de aplicación que es el proyecto raíz. El proyecto de aplicación secrea automáticamente al crear una aplicación. El proyecto de aplicación tiene un artefacto de modelode aplicación que contiene el modelo de tiempo de diseño de todos los artefactos de la aplicación. Elmodelo de aplicación también contiene los metadatos que identifican de forma exclusiva las instanciasde la aplicación cuando se implementa.

Utilice la página Inicio para crear e importar aplicaciones. Las aplicaciones que cree e importeaparecerán en la lista de aplicaciones de la página. Utilice la lista para alternar entre las aplicacionescon las que desea trabajar.

ProyectosLos proyectos almacenan los artefactos que puede compartir entre aplicaciones y el resto de losproyectos. Por ejemplo, una aplicación de origen de préstamo y una aplicación de servicio de préstamoutilizan un proyecto de préstamo que contiene los artefactos comunes entre las aplicaciones, como unmodelo de objeto de negocio de préstamos, un modelo objeto de negocio de clientes, las páginas dela interfaz de usuario para los modelos y un proceso que modifica los objetos de negocio en tiempode ejecución de aplicación.

Cuando termine de desarrollar un proyecto, puede exportarlo como una biblioteca de xCP para queotros desarrolladores puedan importarla en sus aplicaciones. Si vuelve a implementar una aplicaciónen un entorno establecido en el modo de desarrollo y la aplicación comparte una biblioteca con otraaplicación del entorno, el sistema elimina los datos de ambas aplicaciones cuando el método deimplementación se establece en Completo y la directiva de datos se establece en Limpiar.

Crear un proyecto o importar un proyecto en una aplicación establece una referencia del proyecto deaplicación para el proyecto nuevo o importado. La referencia es una dependencia en el proyecto nuevoo importado. El resto de los proyectos de la aplicación no pueden hacer referencia al proyecto deaplicación. Las dependencias circulares no pueden existir entre proyectos. Por ejemplo, un proyectoA puede depender de un proyecto B, pero el proyecto B no puede depender del proyecto A. Para



administrar las dependencias de un proyecto, seleccione el proyecto en la lista del editor de modelo deaplicación y haga clic en la pestaña Dependencias de la vista Propiedades.

Ampliar aplicaciones con código personalizadoPuede ampliar la funcionalidad de la aplicación básica mediante la adición de un código personalizadoal xCP Designer. La siguiente tabla describe las extensiones que puede implementar:

Extensión Descripción

Función de Java Archivo de clase Java que define la función personalizada. Después decompilar el archivo como una biblioteca de archivo de Java (JAR) yagregarla, la función aparece al crear una expresión.

Función de JavaScript Archivo JavaScript y archivo XML de definición que integran la funciónen xCP Designer. Después de compilar los archivos como una bibliotecaJAR y agregarla manualmente a xCP Designer, la función aparece en eleditor de expresiones al crear las páginas de la aplicación.

Agregar una biblioteca, página 29 explica cómo añadir una biblioteca.

Widget Archivo JavaScript y archivo XML de definición que integran el widgeten xCP Designer. Después de compilar los archivos como una bibliotecaJAR y agregarla a xCP Designer, el widget aparece en la paleta Widgets.


Visor Obtenga la biblioteca JAR que contiene los archivos del visor. Después deañadir la biblioteca, puede asociar el visor con una aplicación y asignarloa su contenido.


Tema Archivo de hoja de estilo en cascada (CSS) que define el formatopersonalizado de las páginas de la aplicación. Después de crear el archivoy añadirlo, puede aplicar el tema a las páginas.


Servicio de Java para un proceso Archivo de clase de Java que define un servicio para un proceso. Despuésde compilar el archivo y agregarlo, el servicio aparece en el Inspector deactividad al configurar una actividad Ejecutar servicio de Java.

Servicio de Java para elcontrolador JDBC (Java DatabaseConnectivity)

Archivo de clase de Java que define un servicio para conectarse a una basede datos. Después de compilar el archivo y agregarlo, puede seleccionar elcontrolador al configurar un punto final de la base de datos.

Servicio de Java para unalgoritmo de caducidad de la colade trabajos

Archivo de clase de Java que define un servicio para un algoritmo decaducidad de la cola de trabajos. Después de compilar el archivo yagregarlo, el servicio aparece en el Inspector de actividad al configuraruna actividad Tarea de cola de trabajos.

Gestionar versiones del proyecto y de la aplicaciónUtilice los números de versión para administrar los cambios realizados en aplicaciones y proyectos deaplicaciones. La secuencia para los números de versión es x.y.z, donde:

• x es el número de versión mayor.



• y es el número de versión menor.

• z es el número de versión de revisión.

Durante la implementación, el sistema evalúa los números de versión en el entorno de implementacióny en el nuevo paquete de aplicación. Si el número de versión mayor o menor del nuevo paquete deaplicación es mayor, el sistema actualiza la aplicación en el entorno de implementación. Si solo elnúmero de versión de revisión del nuevo paquete de aplicación es mayor, el sistema sobrescribirá laaplicación en lugar de actualizarla.

Para especificar un número de versión en el nivel de aplicación, edite el número de versión delproyecto de aplicación. Para especificar un número de versión de un proyecto dentro de una aplicación,edite el número de versión del proyecto. Es necesario restaurar las dependencias entre el proyecto deaplicación y los proyectos dentro de la aplicación si:

• Actualiza la versión de aplicación y las versiones de los proyectos dentro de la aplicación.

• Actualiza las versiones de los proyectos dentro de la aplicación.

Seleccione el proyecto de aplicación en el editor de modelos de aplicación y utilice la pestañaDependencias de la vista Propiedades para restaurar las dependencias.

Compartir recursos de aplicación

Un entorno de desarrollo típico incluye un sistema de control de origen para la gestión de recursosen un equipo de desarrolladores de aplicaciones. Los ejemplos de recursos incluyen proyectos deaplicación, proyectos y artefactos como modelos de objeto de negocio, modelos de contenido, modelosde carpeta, así como modelos de proceso. El sistema de control de origen proporciona control derevisión para los recursos conforme los desarrolladores de aplicaciones desarrollan e implementanaplicaciones de forma simultánea.

Los desarrolladores de aplicaciones no podrán trabajar con los recursos hasta que los agregue alrepositorio de control de origen. No puede trabajar con recursos creados por otros desarrolladores deaplicaciones hasta que recupere sus recursos del repositorio de control de origen. El repositorio decontrol de origen no es un repositorio de Documentum.

Usar la vista Referencias

Mientas desarrolla una aplicación con xCP Designer, puede crear varios artefactos enlazados entre sí.A medida que crea la aplicación empresarial de forma progresiva, es posible que no recuerde todaslas referencias asociadas con un artefacto. En esta situación, puede seleccionar un artefacto en elnavegador y ver las referencias del artefacto en la vista Referencias. La vista Referencias muestratodas las referencias asociadas con el artefacto seleccionado.

La columna Nombre muestra las referencias de entrada del artefacto seleccionado, y la columna deproyecto indica el proyecto al que pertenece el artefacto de referencia. Para abrir una referencia de lalista, haga clic con el botón secundario en la referencia y haga clic en Abrir.

Si desea eliminar un artefacto, utilice vista Referencias para obtener una vista previa de todas lasreferencias asociadas con él.



Buscar artefactos

Al diseñar una aplicación empresarial con xCP Designer, puede crear varios artefactos. En el grupo deartefactos, localizar un determinado artefacto con el navegador de xCP es una tarea compleja. En estasituación, puede utilizar la barra de herramientas de búsqueda de xCP Designer.

Al escribir una cadena de búsqueda en la barra de herramientas de búsqueda, el sistema muestraautomáticamente los artefactos que coinciden con la cadena de búsqueda. Cuando hace clic en labarra de herramientas de búsqueda, el sistema muestra todas las consultas de búsqueda que hayaejecutado como opciones anteriores. Por ejemplo, puede buscar artefactos de versiones de procesoque compartan la misma etiqueta usando la barra de herramientas de búsqueda. El sistema muestra elresultado como nombre de proceso 1 (v1.0), nombre de proceso 1 (v2.0).

En el resultado de búsqueda, el sistema no devuelve ningún resultado para los artefactos ocultos y losartefactos que residen dentro de las bibliotecas.


Capítulo 3Crear componentes de nivel deaplicación



Tareas

Crear un parámetro1. En el navegador de aplicaciones, haga clic en Nuevo→ Parámetro.2. En el cuadro de diálogo Nuevo parámetro, especifique las propiedades de parámetro tal y como se

describe en la siguiente tabla:

Campo Descripción

Etiqueta Escriba una etiqueta para el parámetro.

Proyecto Si la aplicación contiene proyectos, seleccione el proyectopara el parámetro.

Tipo Seleccione el tipo de parámetro.

3. Haga clic en Finalizar.4. En el editor de parámetros, especifique las propiedades de parámetro tal y como se describe en la

tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el parámetro. Sicambia esta etiqueta, el sistema genera un nuevo nombredel sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno del sistemaque identifique el parámetro cuando se utilice en la API.

Este nombre se basa en la etiqueta. Si cambia la etiqueta,el sistema genera un nuevo nombre del sistema.

Tipo Si es necesario, seleccione un nuevo tipo de parámetro.

Valor Escriba o seleccione un valor predeterminado para elparámetro.

Descripción Escriba una descripción del parámetro.

Origen Identifica el proyecto o el proyecto de aplicación al quepertenece el parámetro.


Crear componentes de nivel de aplicación


Crear un rol de aplicación1. En el navegador de aplicaciones, haga clic en Nuevo→ Rol.2. Escriba una etiqueta para identificar el rol.3. Si la aplicación contiene proyectos, seleccione el proyecto para el rol.4. Haga clic en Finalizar.5. En el editor Rol de aplicación, especifique las propiedades del rol tal y como se describe en la

tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el rol. Sicambia esta etiqueta, el sistema genera un nuevonombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el rol cuando se utilice enla API.

Este nombre se basa en la etiqueta. Si cambia laetiqueta, el sistema genera un nuevo nombre delsistema.

Descripción Escriba una descripción del rol.

Origen Identifica el proyecto al que pertenece el rol deaplicación.

No elimine los roles creados en xCP Designer utilizando cualquier otra aplicación, como DA. Si losroles creados en xCP Designer se eliminan mediante cualquier otra aplicación, la implementaciónposterior de la aplicación podría arrojar error.

Creación de conjuntos de permisos1. En el navegador de aplicaciones, haga clic en Nuevo→ Conjunto de permisos.2. Escriba una etiqueta para identificar el conjunto de permisos.3. Si la aplicación contiene proyectos, seleccione el proyecto para el conjunto de permisos.4. Según sus necesidades, seleccione la clase para un grupo de permisos del modo siguiente:

Clase Descripción

Plantilla Crea una plantilla de conjunto de permisos. Los conjuntos de permisos deplantilla se usan para que las aplicaciones, los flujos de trabajo y los ciclosde vida puedan ser portátiles. Por ejemplo, una aplicación que utiliza unconjunto de permisos de plantilla se puede utilizar en distintos departamentosde una empresa.

Público Crea un conjunto de permisos público que todo el mundo puede utilizar. Losconjuntos de permisos públicos están disponibles para el uso por parte decualquier usuario del repositorio.

Normal Crea un conjunto de permisos normal que solo puede utilizar el usuario ogrupo que lo haya creado.




Configurar conjuntos de permisos1. En el navegador Aplicación, desplácese hasta el conjunto de permisos y ábralo en el editor

Conjunto de permisos.2. Para cambiar el propietario de cualquier clase de conjunto de permisos, vaya al Propietario

correspondiente y selecciónelo.3. Para agregar miembros del conjunto de permisos:

a. En el área Todos los usuarios y grupos, haga clic en uno de los siguientes:

• Agregar Alias: para agregar un nuevo alias de permiso. Solo es aplicable a la plantillade conjunto de permisos.

• Agregar usuario: para agregar un nuevo usuario de permiso.• Agregar grupo: para agregar un nuevo grupo de permisos.De manera predeterminada, aparecen dos entradas de miembros predeterminados:

• dm_owner: el propietario del conjunto de permisos. Los permisos predeterminados para elmiembro son eliminar, Ejecutar procedimiento y Cambiar ubicación.

• dm_world: Todos los usuarios del repositorio. Los permisos predeterminados para elmiembro son Ninguno, Ejecutar procedimiento y Cambiar ubicación.

Al migrar una aplicación con conjuntos de permisos a la versión actual de xCP Designer, elsistema establece el conjunto de permisos predeterminado básico para estos miembros delmodo siguiente:

Migración deaplicación 1.x a 2.3

Migración deaplicación 2.x a 2.3

Comportamiento en2.3

Para los miembros

Lectura o lo que estáconfigurado

Eliminar Eliminar dm_owner

Lectura o lo que estáconfigurado

Ninguno Ninguno dm_world

Nota: Si se han realizado cambios en los conjuntos de permisos en el repositorio, asegúresede realizar los mismos cambios en la versión actual de xCP Designer antes de implementar laaplicación.

b. Para el nuevo conjunto de Alias, en el cuadro de diálogo Detalles del permiso, seleccione unade las opciones siguientes:

• Relativo: para especificar un nombre de alias relativa.• Absoluto: para especificar los alias de un conjunto de alias específico.Nota: En tiempo de ejecución, el conjunto de valores predeterminado de un conjunto de aliasno se resuelve para el conjunto de permisos.

4. Para especificar un nivel de permiso básico y ampliado para un miembro de un conjunto depermisos:a. Seleccione la fila del miembro en el área Todos los usuarios y grupos.b. Seleccione Permisos básicos en la lista desplegable.

Permisos básicos



Nivel Descripción

Ninguno No hay acceso al objeto.

Examinar Ver los valores de atributos de un objeto, pero no sucontenido.

Leer Ver los valores de atributo y el contenido del objeto.(incluye Examinar).

Relacionar Permite ver los valores de atributos de un objeto y sucontenido, así como realizar comentarios sobre el objeto(incluye Examinar y Leer).

Versión Modificar el contenido del objeto y registrar una nuevaversión del objeto con un nuevo número de versión(incluye Examinar, Leer y Relacionar).

Escribir Editar los valores de atributos del objeto y registrar elobjeto con la misma versión (incluye Examinar, Leer,Relacionar y Versionar).

Eliminar Eliminar el objeto (incluye Examinar, Leer, Relacionar,Versionar y Eliminar).

c. Haga clic en la celda Permisos extendidos y seleccione el nivel de permisos.Permisos extendidos

Nivel Descripción

Ejecutar procedimiento Los superusuarios pueden cambiar el propietario de unelemento y utilizar el permiso Ejecutar procedimientopara ejecutar los procedimientos externos en algunostipos de objetos.

Cambiar ubicación Mover un objeto de una carpeta a otra en el repositorio

Cambiar estado Modificar el estado de un elemento que tiene un ciclode vida aplicado.

Cambiar permisos Modificar los permisos básicos de un elemento.

Cambiar propiedad Cambiar el propietario del elemento.

Eliminar extendido Permite eliminar el objeto solamente.

Cambiar enlaces de carpeta Permite eludir la seguridad de la carpeta.

5. Para quitar un miembro de un conjunto de permisos, seleccione la fila del miembro y haga clicen Quitar.


Crear una plantilla de correo electrónico1. En el navegador de aplicaciones, haga clic en Nuevo→ Plantilla de correo electrónico.2. Escriba una etiqueta para identificar la plantilla de correo electrónico.3. Si la aplicación contiene proyectos, seleccione el proyecto para la plantilla.4. Haga clic en Finalizar.



Configurar una plantilla de correo electrónico1. En el navegador de aplicaciones, desplácese a la plantilla y ábrala.2. En el editor de plantillas de correo electrónico, especifique las propiedades de la plantilla de

correo electrónico, tal y como se describe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar la plantilla. Si cambiaesta etiqueta, el sistema genera un nuevo nombre delsistema.

Nombre del sistema Escriba un nombre de sistema para uso interno del sistemaque identifique la plantilla cuando se utilice en la API.

Este nombre se basa en la etiqueta. Si cambia la etiqueta, elsistema genera un nuevo nombre del sistema.

Descripción Escriba una descripción de la plantilla de correo electrónico.

Origen Identifica el proyecto al que pertenece la plantilla de correoelectrónico.

Asunto Escriba una línea de asunto para el mensaje enviado. Sieste campo se deja en blanco, el mensaje se entregará conuna línea de asunto vacía. La plantilla de asunto puedeincluir texto estático y variables que se asignan a los datosde proceso. Si es necesario, utilice caracteres de escape.

Formato Seleccione el formato de correo electrónico.

Cuerpo Escriba el cuerpo del mensaje enviado. Puede incluir textoestático, HTML copiado de un editor HTML de terceros yvariables que se asignan a los datos de proceso.


Seleccionar un formato para un visor1. En el navegador Aplicación, amplíe Configuración→Visores y formatos.2. En la lista de visores, seleccione un visor.3. Haga clic en Editar.4. En el cuadro de diálogo Asignar formatos, seleccione un formato.5. Haga clic en Aceptar.

Crear un punto final1. En el navegador Aplicación, haga clic en Nuevo→Punto final.2. Escriba una etiqueta para identificar el punto final.3. Si la aplicación contiene proyectos, seleccione el proyecto para el punto final.4. En el cuadro de lista Tipo, seleccione el tipo de punto final.5. Haga clic en Finalizar.



Configurar un punto final de base de datos1. En el editor del punto final de la base de datos, especifique la información básica, tal y como se

describe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finalde la base de datos. Si cambia esta etiqueta, elsistema genera un nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el punto final de base dedatos cuando se utilice en la API.


Descripción Escriba una descripción del punto final de la basede datos.

Origen Identifica la aplicación o el proyecto al quepertenece el punto final.

2. Especifique los detalles de conexión tal y como se describe en la tabla siguiente:

Campo Descripción

Controlador JDBC Seleccione un controlador para conectarse a la basede datos.

Los controladores personalizados, así como loscontroladores preinstalados, aparecen aquí.

Cadena de conexión Escriba una cadena de conexión JDBC para la basede datos elegida.

3. Especifique la autenticación tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre de usuario Escriba un nombre de usuario para autenticar laconexión. Si no especifica un nombre de usuario ycontraseña, no se proporcionarán las credencialespara la conexión.

Contraseña Escriba una contraseña para autenticar la conexión.

4. Haga clic en Probar conexión para verificar la conexión.


Configurar un punto final de correo electrónico1. En el editor del punto final de correo electrónico, especifique la información básica, tal y como se




Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finalde correo electrónico. Si cambia esta etiqueta, elsistema genera un nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el punto final de correoelectrónico cuando se utilice en la API.


Descripción Escriba una descripción de cómo utilizar el puntofinal del correo electrónico.


Conexión de servidor Seleccione si va a crear un punto final de correoelectrónico entrante o saliente.

2. Para un punto final de correo electrónico saliente, especifique la Configuración de servidorsaliente tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre de host Escriba el nombre de host o la dirección IP delservidor SMTP que se utiliza para enviar el mensajede correo electrónico.

Número de puerto Escriba el número de puerto que se va a usar parala conexión del servidor saliente.

Cifrado Seleccione el protocolo de cifrado para enviar elmensaje de correo electrónico.

3. Para un punto final de correo electrónico entrante, especifique la Configuración de servidorentrante tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre de host Escriba el nombre de host o la dirección IP delservidor de correo electrónico que se utiliza pararecuperar el mensaje de correo electrónico.

Protocolo Seleccione el protocolo del servidor de correoelectrónico entrante para recuperar el mensaje decorreo electrónico.

Número de puerto Escriba el número de puerto que se va a usar para laconexión del servidor de correo electrónico entrante.

Cifrado Seleccione el protocolo de cifrado para recuperar elmensaje de correo electrónico.




Campo Descripción


Contraseña Escriba la contraseña utilizada para autenticar laconexión.

5. Para los puntos finales de correo electrónico saliente, haga clic en Probar conexión saliente paraprobar la conexión del SMTP saliente al servidor de correo electrónico.

6. Para los puntos finales de correo electrónico entrante, haga clic en Probar conexión entrante paraprobar la conexión de IMAP o POP3 entrante para el servidor de correo electrónico.


Configurar un punto final de FTP1. En el editor del punto final de FTP, especifique la información básica, tal y como se describe

en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finalde FTP. Si cambia esta etiqueta, el sistema generaun nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el punto final de FTP cuandose utilice en la API.


Descripción Escriba una descripción del punto final del FTP.



Campo Descripción

Protocolo Seleccione el protocolo para las transmisiones delFTP.

Nombre de host Escriba el nombre de host o dirección IP delservidor FTP.

Número de puerto Escriba el número de puerto para el protocolo queha seleccionado.

Ruta de carpeta base Escriba la ruta a la carpeta que se va a designar comoorigen o destino de las transferencias de archivos.

3. Especifique la información de autenticación tal y como se describe en la tabla siguiente:

Campo Descripción

Autenticación básica Seleccione Utilizar autenticación básica.



Campo Descripción

Autenticación de clave pública Seleccione Utilizar autenticación de clave pública.



4. Si está disponible, haga clic en Probar conexión para comprobar la conexión con el punto final.


Configurar un punto final de HTTP1. En el editor del punto final de HTTP, especifique la información básica, tal y como se describe


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finalde HTTP. Si cambia esta etiqueta, el sistema generaun nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el punto final de HTTPcuando se utilice en la API.


Descripción Escriba una descripción del punto final de HTTP.


2. En el campo URL, escriba la URL totalmente cualificada del sitio en el que la actividad envía elcontenido.

3. Especifique la autenticación básica de HTTP, tal y como se describe en la tabla siguiente:

Campo Descripción



4. Haga clic en Probar conexión para verificar la conexión.




Configurar un punto final de JMS1. En el editor del punto final de JMS, especifique la información básica, tal y como se describe


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finalde JMS. Si cambia esta etiqueta, el sistema generaun nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso internodel sistema que identifique el punto final de JMScuando se utilice en la API.


Descripción Escriba una descripción del punto final de JMS.


2. Especifique el contexto inicial tal y como se describe en la tabla siguiente:

Campo Descripción

Fábrica de contexto Seleccione la Fábrica de contexto inicial que elsistema utiliza para acceder al contexto de JNDI(Interfaz de directorios y nombres Java) del servidorde mensajería.

URL del proveedor Escriba la URL del proveedor del servidor demensajería.



Propiedades adicionales Escriba las propiedades adicionales necesarias paraacceder a los mensajes del servidor de JMS. Entiempo de ejecución, la Fábrica de contexto inicialutiliza estos atributos para crear el Contexto inicial.

3. Especifique la información de cola o tema tal y como se describe en la tabla siguiente:

Campo Descripción

Cola Seleccione esta opción para tener acceso a una cola.

Tema Seleccione esta opción para tener acceso a un tema.

Fábrica de conexiones Seleccione la fábrica de conexiones utilizada paraacceder a la cola o tema.

Nombre de cola o tema Escriba el nombre de la cola o el tema al que se va aacceder.



Campo Descripción

Nombre de usuario Escriba un nombre de usuario para acceder a la colao tema.

Contraseña Escriba una contraseña para acceder a la cola otema.

4. Haga clic en Probar conexión para verificar la conexión.5. Haga clic en Guardar.

Configurar un punto final del repositorio1. En el editor del punto final del repositorio, especifique la información básica, tal y como se


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finaldel repositorio. Si cambia esta etiqueta, el sistemagenera un nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el punto final del repositoriocuando se utilice en la API.


Descripción Escriba una descripción de cómo utilizar el puntofinal del repositorio.



Campo Descripción

Nombre de host de Docbroker Escriba el nombre del host que contiene elDocbroker donde está registrado el repositorio.

Puerto de Docbroker Escriba el puerto del host que contiene el Docbrokerdonde está registrado el repositorio.

Nombre del repositorio Haga clic en el botón Actualizar para obtener unalista de repositorios desde el Docbroker. Seleccioneel nombre de un repositorio que se haya configuradopara Docbroker en tiempo de ejecución.


Campo Descripción

Nombre de usuario Escriba el nombre utilizado para autenticar laconexión. Si no especifica un nombre de usuario ycontraseña, no se proporcionarán las credencialespara la conexión.



Campo Descripción

Contraseña Escriba la contraseña utilizada para autenticar conla conexión.

Dominio Escriba el dominio para autenticar con el repositorio.

4. Haga clic en Probar conexión para verificar la conexión con el repositorio.


6. Si tiene varios repositorios de Documentum para integrarlos en su aplicación, cree un punto finalde repositorio para cada repositorio.

Configurar un punto final de servicio web1. En el editor del punto final del servicio web, especifique la información básica, tal y como se


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finaldel servicio web. Si cambia esta etiqueta, el sistemagenera un nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el punto final del servicioweb cuando se utilice en la API.


Descripción Escriba una descripción del punto final del servicioweb.


2. En el campo URL de WSDL, escriba la URL totalmente cualificada en el archivo WSDL para laoperación que desea ejecutar.

3. Especifique la autenticación básica de HTTP, tal y como se describe en la tabla siguiente:

Campo Descripción



4. Haga clic en Probar conexión para verificar la conexión al punto final.




Acceder a un servicio web a través de un servidorproxy HTTPPara acceder a un servicio web que se encuentre fuera del servidor de seguridad a través de unservidor proxy HTTP, modifique el archivo de configuración de xCP Designer. La EMC DocumentumxCelerated Composition Platform Deployment Guide (Guía de implementación de EMC DocumentumxCelerated Composition Platform) proporciona información sobre cómo configurar un servidor proxyHTTP para servicios web en tiempo de ejecución.1. Vaya al directorio en el que se ha instalado xCP Designer y abra el archivo xcpdesigner.ini.

Por ejemplo, abra C:\xCPDesigner\xcpdesigner.ini.

2. Escriba los siguientes argumentos de la máquina virtual Java tras -vmargs:

-Dhttps.proxyHost=<proxy_host>-Dhttps.proxyPort=<port_number>-Dhttps.nonProxyHosts="<non_proxy_hosts>"

Donde:

• <proxy_host> es el nombre de host del servidor proxy.

• <port_number> es el número de puerto del servidor proxy. El valor predeterminado es 80 parala autenticación básica de HTTP y 443 para HTTP a través de SSL.

• <non_proxy_hosts> es la lista de hosts a los que se puede acceder directamente, omitiendo elservidor proxy. Esta lista contiene expresiones regulares separadas por ’|’. Se puede acceder através de una conexión directa, en lugar de mediante un proxy, a aquellos hosts que coincidancon estas expresiones regulares.

Configurar un punto final del servidor xPression1. En el editor del punto final de xPression, especifique la información básica, tal y como se describe


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el punto finaldel servidor xPression. Si cambia esta etiqueta, elsistema genera un nuevo nombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique el punto final del servidorxPression cuando se utilice en la API.


Descripción Escriba una descripción del punto final del servidorxPression.


2. En el campo URL de xPression, escriba una dirección URL para el servicio xPression.3. Especifique la autenticación tal y como se describe en la tabla siguiente:



Campo Descripción


Contraseña Escriba la contraseña utilizada para autenticar laconexión.

4. Haga clic en Probar conexión para verificar la conexión.5. Haga clic en Guardar.

Trabajar con el navegador de aplicacionesPara realizar un duplicado de un artefacto, haga clic con el botón secundario sobre el artefacto yseleccione Duplicar. El artefacto duplicado hereda los atributos del artefacto original.

Para transferir un artefacto a un proyecto diferente, haga clic con el botón secundario en el artefacto,seleccioneMover a y elija el nuevo proyecto.

Para eliminar un artefacto, haga clic con el botón secundario en él y seleccione Eliminar, o bienseleccione el artefacto y pulse la tecla Supr.

Para eliminar un proyecto, abra el editor de modelos de aplicación en el navegador, seleccioneel proyecto, y haga clic en Quitar.

Gestionar contenido de la biblioteca de recursos1. En el navegador de recursos, haga clic con el botón secundario en la carpeta del proyecto

correspondiente y seleccione Abrir.2. Agregue contenido a la carpeta o actualice el contenido existente.3. En el navegador de recursos, haga clic con el botón secundario en la carpeta y haga clic en

Actualizar.

Crear una extensión de Java1. En el navegador Aplicación, haga clic en Nuevo→ Extensión de Java.2. En el cuadro de diálogo Nueva extensión de Java, especifique las propiedades de parámetros

tal y como se describe en la tabla siguiente:

Campo Descripción

Biblioteca/módulo de Java Según sus necesidades, puede especificar el módulo deJava o la biblioteca de Java como extensión de Java.

Etiqueta Escriba una etiqueta de la biblioteca de Java.

Descripción Escriba una descripción de la biblioteca.




4. En la pestaña Conceptos básicos del editor, especifique las propiedades de la biblioteca tal ycomo se describe en la tabla siguiente:

Campo Descripción

Etiqueta Identifica la etiqueta de la extensión.

Nombre del sistema Identifica el nombre del sistema que utiliza el sistemainternamente para identificar la extensión cuando seutiliza en la API.

Este nombre se basa en la etiqueta. Si cambia la etiqueta,el sistema genera un nuevo nombre del sistema.

Descripción Escriba una descripción de la extensión.

Origen Identifica el proyecto o el proyecto de aplicación al quepertenece la extensión.

Ubicación de archivo Identifica la ruta de acceso a la extensión de Java en elsistema de archivos.

5. En la pestaña Biblioteca de Java del editor, especifique las propiedades de la biblioteca tal ycomo se describe en la tabla siguiente:

Campo Descripción

Archivos JAR Agregue los archivos JAR desde su sistema de archivoslocal.

Archivos de propiedades Agregue los archivos de propiedades desde el sistema dearchivos local.

También puede realizar operaciones de eliminación o edición en cualquier archivo JAR deimplementación o archivo de propiedades.

6. En la pestañaMódulo de Java del editor, especifique las propiedades del módulo de Java tal ycomo se describe en la tabla siguiente:

Campo Descripción

JARs de implementación Agregue las clases y los archivos JAR de implementacióndesde su sistema de archivos local. Seleccione la claseprincipal del archivo JAR seleccionado. Después deagregarlo, puede mover el archivo JAR de implementacióna la biblioteca de Java haciendo clic con el botón derechodel ratón en el archivo JAR seleccionado.

JARs de interfaz Agregue los archivos JAR de interfaz desde el sistemade archivos local.

Bibliotecas de Java Asocie una o varias bibliotecas de Java con el módulode Java. Puede seleccionar cualquier biblioteca de Javaque haya definido.

Puede realizar operaciones de eliminación o edición en cualquier archivo JAR de implementación,archivo JAR de interfaz o biblioteca de Java.




Migración de un módulo de Java y un servicio deJava

Migración del módulo de JavaEn las versiones anteriores, xCP Designer admite escritos artefactos de módulos de Java escritos amano. Al migrar una aplicación con el artefacto del módulo de Java a la versión actual de xCP, elmódulo de Java se migra al formato actual y el sistema garantiza que cumpla con el formato actual,como el nombre del sistema válida.

Migración de servicio de JavaLos servicios de Java creados en versiones anteriores se pueden migrar a la versión actual de xCPDesigner.

Los servicios de Java son el modo de pivotal de consumo de cualquier código externo o cualquierfunción personalizada. Los servicios de Java no son compatibles con la versión 2.3 de xCP y se migranautomáticamente a módulos de Java. Durante la migración, el sistema crea un módulo de Java paracada servicio de Java. Todo el código Java conectado se convierte a la biblioteca de Java y se asociaa estos módulos recién de Java recién creados.

Además, el sistema identifica la biblioteca JAR que contiene la Clase principal y adjunta la bibliotecaJAR como archivo JAR de implementación. Una vez finalizada la migración, puede realizar cambiosen estos módulos de Java y bibliotecas Java en los nuevos editores disponibles y realizar otros cambiossi es necesario.

Migración de funcionesLos servicios de Java se consumen como funciones personalizadas. Por lo tanto, cuando estasfunciones se migran con xCP Designer, las funciones se cargan desde los módulos correspondientesde Java. El sistema garantiza que las funciones de referencia continúen funcionando igual que antessin afectar a su integridad.

Migración de referenciasEl proceso de migración también migra los procesos y valida automáticamente las referencias alproceso. Las referencias a servicios de Java se reemplazan por los módulos de Java correspondientes. Ala vez, las referencias anteriores a módulos de Java se reemplazan por los módulos de Java corregidos.

Crear un conjunto de alias1. En el navegador Aplicación, haga clic en Nuevo > Conjunto de alias.2. Escriba una etiqueta para identificar el conjunto de alias.3. Si la aplicación contiene proyectos, seleccione el proyecto para el conjunto de alias.4. Para agregar uno o más alias que componen el conjunto de alias:

• En el área Alias, haga clic en Agregar.



• En el cuadro de diálogo Nuevo Alias, especifique el nombre del alias.• En la lista desplegable Tipo, seleccione un tipo de alias:

• Desconocido• Usuario: usuario único de la aplicación.• Grupo: grupo de usuarios de la aplicación• Usuario o grupo: cualquier usuario o grupo.• Ruta de carpeta o archivador: ruta a un archivador o carpeta en el repositorio de Documentum.• Conjunto de permisos: defina el nivel de permiso que puede asignar a un miembro delconjunto de permisos.

5. Haga clic en Aceptar.6. En el área Detalles del alias, proporcione los valores de los tipos de alias como sigue:

Según el tipo de alias seleccionado, aparecen varias opciones de parámetros y valores en el campoValor.

Tipo de alias Valor Descripción

Desconocido • Valor Especifique el valor del alias.

Usuario • Dejar en blanco

• Parámetro

Especificar el parámetro del alias.El valor del alias se puede dejaren blanco.

Grupo • Dejar en blanco

• Parámetro

• Valor

Especifique el parámetro o valordel alias. El valor del alias sepuede dejar en blanco.

Usuario o grupo • Dejar en blanco

• Parámetro

Especificar el parámetro del alias.El valor del alias se puede dejaren blanco.

Ruta del archivador o la carpeta • Parámetro

• Valor

Especifique el parámetro o valordel alias.

Conjunto de permisos • Parámetro

• Valor

Especifique el parámetro o valordel alias.


Conceptos

Implementar la seguridadPuede definir la configuración de seguridad en xCP Designer o aplicar la configuración de seguridadasociada a la carpeta principal que almacena instancias de objetos en el repositorio de Documentum.

La definición de la configuración de seguridad en xCP Designer consta de los siguientes pasosgenerales:

• Crear un rol de aplicación• Crear y configurar un conjunto de permisos



• Aplicar un conjunto de permisos a un modelo de objeto

Al aplicar la configuración de seguridad de la carpeta principal, el sistema aplica los permisos de la listade control de acceso (ACL) definidos para la carpeta del repositorio. Antes de aplicar la configuraciónde seguridad de la carpeta, póngase en contacto con el administrador del sistema para determinar eltipo de ACL. Si el tipo es público, cualquier usuario del repositorio puede crear instancias de objetosen la carpeta. Si el tipo es privado, solo el propietario de la ACL y los superusuarios del repositoriopueden crear objetos en la carpeta. La documentación de EMC Documentum Content Server contienemás información sobre la seguridad de la carpeta y permisos de ACL.

Roles de aplicación

Un rol de aplicación representa una función específica correspondiente a un tipo de usuario dentro deuna aplicación. Por ejemplo, una aplicación para el procesamiento de préstamos hipotecarios podríatener roles independientes para el solicitante de préstamo, el creador de préstamo y el procesador depréstamo. Después de crear el rol, puede asignarlo a un nivel de permiso para controlar el acceso alos datos de aplicación. El nivel de permiso determina el nivel de acceso que el usuario tiene enrelación con los datos de aplicación.

Es posible asignar más de un rol a un usuario.

Usar parámetros de una aplicación

Un parámetro funciona como una variable en toda una aplicación. Al crear un parámetro, puede definirsu tipo y, de forma opcional, especificar un valor predeterminado. Los valores de parámetros se puedenanular en tiempo de implementación y en tiempo de ejecución de la aplicación.

Al implementar una aplicación mediante su ejecución a través de xCP Designer, puede modificar losvalores de parámetros de la configuración de ejecución. El administrador de la aplicación puedemodificar los valores de parámetros en el archivo XML de configuración de la aplicación antes deimplementar esta. En tiempo de ejecución de la aplicación, el administrador de la misma puede utilizarla página Administrar parámetros de aplicación para modificar los valores de parámetros.

En la tabla siguiente se describen los tipos de parámetros que puede crear:

Tipo Descripción

Cadena Secuencia de caracteres

Entero Número entero

Flotante Número con un separador decimal

Booleano Valor verdadero o falso

Fecha-hora Fecha o una combinación de fecha y hora

Usuario Usuario único de la aplicación

Grupo Grupo de usuarios de la aplicación

Ruta de la carpeta Ruta de acceso a una carpeta del repositorio deDocumentum



Tipo Descripción

Cola de trabajos Cola de trabajos para el ejecutor de una actividad deproceso

Calendario empresarial Calendario empresarial para los cálculos deltemporizador de actividad de un modelo de proceso

Conjuntos de permisos

Un conjunto de permisos controla el acceso del usuario final a las instancias del objeto en tiempo deejecución de la aplicación. Al crear un conjunto de permisos en xCP Designer, puede asignar unmiembro del conjunto de permisos (un rol de aplicación, un parámetro de usuario o un parámetro degrupo) a un nivel de permiso. El usuario, alias o valores de parámetros del grupo se resuelven en tiempode ejecución. El sistema resuelve el alias al crear la instancia de un permiso a partir de la plantilla.

Considere un conjunto de permisos diseñado con los parámetros de aplicación. Puede configurar estosparámetros de aplicación en Configuración de ejecución. Además, puede cambiar estos parámetrosde aplicación utilizando Administrar parámetros de aplicación. Los cambios realizados en elparámetro de aplicación utilizando la página Gestionar parámetros de aplicación no tienen ningúnimpacto en el conjunto de permisos ya implementado.

Puede establecer los niveles de permiso básico y extendido y asignar a un miembro al conjunto depermisos. Al seleccionar un nivel de permiso, tenga en cuenta si el nivel es adecuado para el modelode objeto. Por ejemplo, el nivel Examinar es más adecuado para un objeto de negocio debido a queeste no tiene contenido.

Los conjuntos de permisos se pueden migrar desde la versión anterior a la versión actual de xCPDesigner. Durante la migración, el sistema asigna los conjuntos de permisos como sigue:

Versión anterior Versión actual

Sin acceso Ninguno

Examinar Examinar

Revisión Relacionar

Editar Escribir y cambiar ubicación

Administrar Eliminar y cambiar la ubicación

Examinar y eliminar Examinar y eliminar extendido

Bibliotecas de recursos

Una biblioteca de recursos es una subcarpeta de proyecto que almacena contenido opcional para unaaplicación. Por ejemplo, una biblioteca de recursos almacena imágenes como logotipos de páginase iconos de procesos. Utilice el navegador de recursos para gestionar el contenido de la bibliotecade recursos.



Plantillas de correo electrónicoAl configurar una plantilla de proceso o una actividad, puede asociarla con la plantilla de correoelectrónico que el sistema use para enviar notificaciones. Una plantilla de correo electrónico define elasunto, el tipo de contenido y el cuerpo del correo electrónico de notificación. El cuerpo del correoelectrónico puede contener código HTML copiado desde un editor distinto de HTML de otro fabricante.

El asunto y el cuerpo del mensaje pueden contener texto estático y variables que se asignan a losdatos de proceso. En tiempo de ejecución, el sistema reemplaza las variables por valores derivadosde los datos de proceso. Al utilizar variables:

• Utilice cadenas de caracteres alfanuméricos, sin espacios.

• Inserte un signo de dólar ($) antes de una variable que se asigne a un valor único.

• Inserte dos signos de dólar ($$) antes de una variable que se asigne a varios valores.

En la tabla siguiente se muestran los caracteres que requieren un carácter de escape:

Carácter Carácter deescape

Ejemplos

( )

’

{ }

[ ]

#

’ Estilo en línea:

<style type=’’text/css’’>.myclass’{’

color: black;background-color:‘#’d8da3d;

’}’</style>

JavaScript en línea:

<script type=’’text/javascript’’>myarray = [1,2,3,4];myFunction = function(arg)’{’return arg;’}’</script>

$ \ Elemento HTML:

<span>This is worth \$500</span><span>You are privileged customerand eligible for \”Personal Loan\”without any proofs<\span>

En el ejemplo siguiente se muestra el código de una plantilla de correo electrónico. En tiempode ejecución, el sistema reemplaza la variable $task_name por los datos de proceso asignadosa task_name.Subject: New Task: $task_nameContent-Type: HTML

Body:<html><head><title>New Task: $task_name </title></head>



<body><p>The following task has arrived in your inbox.</p>;<table><tr><td>Task Name:</td><td>task_name</td>

</tr><tr><td>Priority:</td><td>$task_priority ></td>

</tr><tr><td>Instructions:</td><td>$task_message_text</td>

</tr></table><p>Click <a>href=’’$url’’>here</a> to open the task.</p>

</body></html>

Conectar con sistemas externos mediante puntosfinales

Un punto final es un artefacto que representa un sistema externo, haciendo sencillo que la aplicación seconecte a ese sistema. Al crear actividades, puede seleccionar los puntos finales preconfigurados comoorígenes o destinos para los datos que consumen o producen las actividades. Varias actividades puedenreutilizar el mismo punto final. Puede proporcionar un punto final con la configuración predeterminada.

Los puntos finales le permiten implementar la aplicación a varios entornos con conexiones del sistemaexternas diferentes sin tener que cambiar las definiciones del modelo de proceso. Por ejemplo, puedecrear un punto final de base de datos y asignarlo a distintas bases de datos de los entornos de desarrollo,prueba y producción. Las asignaciones anulan la configuración predeterminada del punto final.

Determinar qué punto final utilizar

Utilice la tabla siguiente para determinar qué punto final va a utilizar:

Punto final Descripción

Base de datos

Configurar un punto final de base dedatos, página 42

Se conecta a una base de datos de SQL externa.

Correo electrónico

Configurar un punto final de correoelectrónico, página 42

Se conecta a un servidor de correo externo.

FTP

Configurar un punto final de FTP, página44

Se conecta a un servidor de transferencia de archivos que utilizaFTP, FTPS o bien SFTP.



Punto final Descripción

HTTP

Configurar un punto final de HTTP,página 45

Se conecta a un servidor web externo.

JMS

Configurar un punto final de JMS, página46

Se conecta a un servidor de mensajería externo que utiliza elservicio de mensajería de Java.

Repositorio

Configurar un punto final del repositorio,página 47

Se conecta a un repositorio de Documentum externo.

Servicio web (SOAP)

Configurar un punto final de servicioweb, página 48

Se conecta a un servicio basado en SOAP.

xPression

Configurar un punto final del servidorxPression, página 49

Se conecta a un servidor de Document Sciences xPression.

Archivo de registro de xCP DesignerAl iniciar xCP Designer, el sistema crea el archivo xCPDesigner.log. Este archivo contiene todoslos mensajes de registro, excepto los mensajes de implementación de aplicaciones, y El archivose actualiza continuamente.

Para ver el archivo, desplácese a xCPDesigner\logs y abra el archivo xCPDesigner.log en un editor detexto.

Limpieza de archivos temporalesPara habilitar la limpieza de archivos temporales DAR en el entorno Windows, ahora debe configurarel indicador de la JVM com.emc.xcp.builder.dar.autoclean en True, en cualquiera de losescenarios siguientes:

• Para xCP Designer, añada el indicador de la JVM a xCPDesigner.ini.

• Para el servidor de aplicaciones, configure el indicador de la JVM en la configuración del servidor.

• Si utiliza un código DFC JAVA para recuperar un objeto creado por xCP, el comando de JAVA paraejecutar ese código debe incluir el indicador de la JVM. No habilite el indicador si hay más de unaaplicación implementada en el mismo servidor de aplicaciones.

Extensiones JavaLas extensiones de Java permiten agregar funciones personalizadas y funcionalidades de procesosde negocio a una aplicación de xCP, como integrar con sistemas externos que no dispongan de unmecanismo de integración estándar, desencadenar acciones en sistemas externos, eliminar archivos



adjuntos de mensajes de correo electrónico o extraer archivos de nombres de dentro de un únicoarchivo zip.

Las extensiones de Java constan principalmente de estos elementos:

Módulo Java

Es un archivo de artefacto que agrega varios archivos JAR de Java y se usa para distribuir clases deJava y metadatos asociados.

Un módulo de Java se compone de dos tipos de archivos JAR: archivos JAR de interfaz y archivos JARde implementación. Los archivos JAR de interfaz contienen clases de Java de interfaz y los archivosJAR de implementación contienen las clases que implementan las clases de interfaz. Por lo general, lasclases de interfaz y las clases de implementación se agregan a archivos JAR separados.

Un módulo de Java también puede contener uno o más bibliotecas de Java.

Biblioteca Java

Es un conjunto de bibliotecas de Java que se pueden conectar a un módulo de Java. Es un archivo deartefacto que agrega varios archivos JAR y los archivos propiedades asociados.

Una librería de Java permite reutilizar código común en varios módulos de Java sin necesidad deduplicar archivos JAR. Por ejemplo, la biblioteca de E/S de Apache.

Note: Módulos de Java y bibliotecas Java son compatibles con archivos JAR compilados con Java1.6 o 1.7 solamente.

Conjunto de alias

Dentro de las aplicaciones de xCP, se hacen referencias múltiples a muchos usuarios, grupos, conjuntosde permisos, repositorios, archivadores o carpetas. En lugar de hacer referencia al nombre verdaderode usuario, grupo, archivador o carpeta, puede asignar un alias, un nombre simbólico. El nombresimbólico se denomina nombre del alias. El valor real se denomina valor del alias. Una colección dealias se denomina un conjunto de alias.


Capítulo 4

Crear modelos de objetos



Tareas

Crear un modelo de objeto1. En el navegador de modelos de objeto, haga clic en Nuevo y seleccione el tipo de modelo.2. En el cuadro de diálogo Nuevo objeto modelo, especifique las propiedades del modelo tal y como


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el objeto.

Proyecto Si la aplicación contiene proyectos, seleccione el proyectopara el modelo.

Herencia Para heredar los atributos de otro modelo, seleccione elmodelo de la lista.


No elimine modelos de objetos creados en xCP Designer utilizando cualquier otra aplicación, comoDA. Si los modelos de objetos creados en xCP Designer se eliminan mediante cualquier otraaplicación, la implementación posterior de la aplicación podría arrojar error.

Configurar las opciones básicas del modelo deobjeto1. En el navegador de modelos de objeto, desplácese a la plantilla y ábrala.2. En la pestaña Conceptos básicos del editor, especifique las propiedades del modelo tal y como se


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el modelo. Si cambiaesta etiqueta, el sistema genera un nuevo nombre del sistema.



Campo Descripción

Nombre del sistema Escriba un nombre de sistema para uso interno del sistemaque identifique el modelo cuando se utilice en la API.

Este nombre se basa en la etiqueta. Si cambia la etiqueta, elsistema genera un nuevo nombre del sistema.

Descripción Escriba una descripción del modelo.

Hereda de Identifica el modelo del que el nuevo modelo hereda losatributos.

Origen Identifica el proyecto al que pertenece el modelo de objeto.

Archivo Identifica la ruta de acceso al archivo de modelo en el sistemade archivos.

Ubicación predeterminada Escriba una expresión que defina la ubicación predeterminadaen el repositorio de Documentum donde se almacenan lasinstancias en tiempo de ejecución del modelo. La expresiónfunciona como directiva de archivado para las instanciasdel modelo. Utilice un valor de cadena para especificar laubicación en la expresión. En el ejemplo siguiente se muestrauna expresión que almacena las instancias de un parámetrode prueba en el archivador Temp del repositorio:

’/Temp/’+parameters.sbc.testparamone

No se puede establecer la ubicación predeterminada delmodelo de un archivador.

3. En el área Características de tiempo de ejecución, seleccione El usuario puede realizarcomentarios sobre el modelo de objeto para habilitar los comentarios.

Si habilita la opción de realizar comentarios, los comentarios se pueden realizar en los objetoscreados posteriormente, pero no en los objetos que se han creado antes de activar esta función.

4. En el área Permisos, especifique el método de seguridad tal y como se describe en la tabla siguiente:

Campo Descripción

Heredado de carpeta principal Aplica los permisos definidos en la lista de controlde acceso (ACL) asociada con la carpeta delrepositorio de Documentum en la que se almacenanlas instancias en tiempo de ejecución del modelo. Silos permisos para la carpeta del repositorio cambian,los nuevos permisos se aplican a las instancias deobjetos nuevas. Los nuevos permisos no se aplicana instancias anteriores del objeto en el repositorio.

Este método de seguridad es aplicable a los modelosde objeto de objeto de negocio, contenido y carpeta.Pero el método de seguridad no es aplicable almodelo de archivador.

Conjunto de permisos Aplica los permisos asociados a un conjunto depermisos de la aplicación.




Agregar atributos a un modelo de objeto1. En el navegadorModelos de objetos, abra el modelo.

2. Haga clic en Atributos.

3. Para mostrar los atributos heredados de un modelo principal, seleccioneMostrar heredados.

Para editar los atributos heredados, edite los atributos del modelo de objeto principal.

Al crear una página de modelo de objeto, solo los atributos que haya agregado aparecerán enesta. Se deben agregar los atributos heredados.

4. Arrastre y suelte un elemento de atributo desde la paleta Tipos al modelo.

5. En la ficha General de la vista Propiedades, especifique las propiedades de atributo tal y como sedescribe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el atributo. Si cambia esta etiqueta,el sistema genera un nuevo nombre del sistema.

No asigne al atributo el mismo nombre que el del modelo de objeto.

Para un modelo de objeto Contenido, Carpeta o Gabinete, no utilice lossiguientes como nombre de atributo:

• folder_id

• content_id

• model

• checkin_version

• checkin_label

• retain_lock

• is_current

• source

• gabinete base

Lista desplegable Seleccione la lista desplegable que se va a usar en un atributo de listadesplegable.

Adjuntar siempre este fragmentode tipo durante la creación deobjetos

Seleccione esta opción para convertir un fragmento de tipo en elfragmento de tipo predeterminado.

En tiempo de ejecución, el fragmento de tipo predeterminado se anexaautomáticamente a la instancia del objeto, pero el fragmento de tipopredeterminado no se puede separar.

Nombre del sistema Identifica el nombre del sistema para uso interno del sistema queidentifica el atributo cuando se utiliza en la API.

Este nombre se basa en la etiqueta. Si cambia la etiqueta, el sistemagenera un nuevo nombre del sistema.

Valor único Seleccione esta opción para configurar el atributo y que tenga soloun valor.



Campo Descripción

Multivalor Seleccione esta opción para configurar el atributo y que tenga muchosvalores como una lista de estados o ciudades.

Longitud de cadena Escriba el número de caracteres permitido en un atributo de cadena.Durante la implementación de aplicaciones, la longitud de cadena sevalida con el tamaño de paginación de la base de datos del repositorio.

Valor predeterminado Cree una expresión para devolver un valor inicial para el atributo. Elvalor aparece de forma predeterminada en instancias del modelo deobjeto en tiempo de ejecución de aplicación. Este valor aparece cuandoel usuario final crea una instancia de modelo de objeto y no especificaun valor de atributo.

Si especifica un valor predeterminado para un atributo de cadena,asegúrese de que el número de caracteres del valor predeterminado nosupera el número de caracteres especificado para Longitud de cadena.

Si especifica un valor predeterminado para un atributo flotantemultivalor o un atributo de lista desplegable multivalor de tipo dedatos flotante, asegúrese de que cada valor de la expresión tenga unseparador decimal.

Para un atributo flotante que no presente un número antes del separadordecimal, agregue un cero a la izquierda. Por ejemplo, para especificarun valor predeterminado de .12, escriba 0.12 en el editor de expresiones.

6. En la pestaña Validación, especifique las propiedades de atributo tal y como se describe en latabla siguiente:

Campo Descripción

Usar la validación basada enexpresión

Seleccione si desea utilizar la validación personalizada para el atributo.

Mensaje de validación Escriba el error para que aparezca si se introduce un valor no válido.

Condición de validación Introduzca los criterios que se utilizan para comprobar la validez delatributo. El mensaje aparece si esta condición es falsa.

7. En el cuadro de diálogo Información, escriba una descripción del atributo.8. Haga clic en Guardar.

Reinicie xCP Designer para que el atributo aparezca en el selector de datos de contexto.

Editar atributos1. Para editar un atributo en la vista Propiedades, seleccione el atributo y escriba el nuevo valor.2. Salga del campo con el ratón o un comando del teclado como Tab o Intro.3. Haga clic en Guardar.

Editar atributos en línea1. Haga doble clic en el atributo y escriba el nuevo valor.2. Salga del campo con el ratón o un comando del teclado como Tab o Intro.




Crear un modelo de una lista desplegable1. En el navegador de modelos de objeto, haga clic en Nuevo→ Lista desplegable.2. Escriba una etiqueta para identificar la lista desplegable.3. Si la aplicación contiene proyectos, seleccione el proyecto para la lista desplegable.4. Haga clic en Finalizar.

Configurar las opciones básicas de la listadesplegable1. En el navegador de modelos de objeto, desplácese al modelo de lista desplegable y ábralo.2. En la pestaña Conceptos básicos, establezca la configuración básica, tal y como se describe en la

tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar la listadesplegable.

Tipo de datos Seleccione el tipo de datos.

Descripción Escriba una descripción.

Origen Identifica el proyecto al que pertenece la listadesplegable.


Agregar valores de lista desplegable1. En el navegador de modelos de objeto, desplácese al modelo de lista desplegable y ábralo.2. En la pestaña Entradas, haga clic en Agregar entrada.3. Haga clic en la fila de la columna Etiqueta y escriba una etiqueta.

Esta etiqueta aparecerá en la aplicación en tiempo de ejecución.

4. Haga clic en la fila de la columna Valor y escriba un valor.

Los valores son para uso interno del sistema.

5. Para cambiar el orden en el que aparecen los elementos de la lista desplegable, haga clic enSubir o Bajar.


Configurar un evento de negocio1. En el navegador de modelos de objeto, desplácese al objeto de negocio, el contenido o el modelo

de carpeta y ábralo.



2. Haga clic en Eventos de negocio.3. Haga clic en Nuevo evento de negocio.4. Configure el evento de negocio tal y como se describe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta que identifique el evento de negocio.

Descripción Escriba una descripción del evento de negocio.

Se desencadena cuando Seleccione el elemento que desencadena el evento de negocio.

La condición es verdadera Escriba una expresión booleana que cree el evento de negocio. Elsistema crea el evento solo si se cumple la condición.

En un desencadenador de actualización, el sistema evalúa lacondición cuando cambia un atributo de objeto utilizado en laexpresión. Por ejemplo, si la expresión de condición contieneevent.loan.amount > 500000 y otro atributo cambia, pero el importedel préstamo no, el sistema no evalúa la condición. Como elsistema no evalúa la condición, tampoco crea un evento. Si dejaeste campo en blanco, el sistema desencadena el evento cuandocambia cualquier atributo del objeto.

5. Haga clic en Siguiente.6. Seleccione la acción que se producirá después de que el sistema cree el evento de negocio:

• Para conseguir que los datos de eventos solo estén disponibles para los informes, seleccioneNinguna acción y vaya al paso 9.

• Para iniciar un proceso y hacer que los datos de eventos estén disponibles para los informes,seleccione Iniciar proceso o Iniciar proceso sin estado y vaya al paso 7.

7. Seleccione el proceso y haga clic en Siguiente.8. Para definir los valores de entrada que inician el proceso:

a. En el cuadro de diálogo Evento de negocio de <modelo de objetos>, seleccione el paquete.b. Cree una expresión que asigne el evento de negocio al atributo de ID de objeto del modelo

enlazado al paquete.

En la siguiente figura se muestra cómo crear una expresión mediante la selección de los datosde contexto de un modelo de contenido denominado Reclamación:



En el ejemplo siguiente se muestra la expresión tal y como aparece en el editor de expresiones:

event.claim.r_object_id

9. En el cuadro de diálogo Evento de negocio de <modelo de objetos>, haga clic en Finalizar.

Editar un evento de negocio1. Vaya a la ficha Eventos de negocio del modelo de objeto que va a editar.2. Para mostrar eventos de negocio heredados, seleccioneMostrar heredados.3. Para editar un evento de negocio heredado, edite el evento de negocio para el modelo de objeto

principal.4. Haga clic con el botón secundario en el evento de negocio y seleccione Abrir.5. En el cuadro de diálogo Evento de negocio, edite las propiedades del evento de negocio y haga

clic en Finalizar.

Configurar metadatos descubiertos1. Haga clic en Atributos.2. Para agregar metadatos descubiertos, arrastre y suelte los metadatos descubiertos en la paleta

Tipos en el modelo de contenido.3. En la vista Propiedades, escriba una etiqueta para identificar el atributo.4. Consulte el campo Análisis para comprender cómo Content Intelligence Services genera valores

de metadatos descubiertos.



5. En la pestaña Información, escriba una descripción para compartirla con otros desarrolladoresde aplicaciones.

6. Para eliminar metadatos descubiertos, haga clic con el botón derecho en los metadatos descubiertosy seleccione Eliminar.

Si los objetos pertenecientes al modelo de contenido ya se han procesado, agregar o eliminar losmetadatos descubiertos puede activar un nuevo procesamiento de los objetos de contenido enfunción de la directiva de datos que se haya seleccionado:

• Limpiar: el sistema vuelve a procesar los objetos de contenido. Los valores de metadatosdescubiertos no están disponibles hasta que el procesamiento se completa.

• Mínimo: el sistema reprocesa los objetos de contenido. Los valores de metadatos descubiertosanteriores están disponibles durante el reprocesamiento.

• Mantener: no se produce el reprocesamiento automático. Content Intelligence Servicesactualiza los valores de metadatos descubiertos para los documentos nuevos o modificados.Mediante Documentum Administrator, puede forzar un reprocesamiento.

Si elimina todos los metadatos descubiertos de un modelo de contenido, el sistema borra losvalores, pero no realiza ningún nuevo procesamiento.

Crear una relación de objetos1. En el navegador de modelos de objeto, haga clic en Nuevo→ Relación.2. En el cuadro de diálogo Nueva relación, especifique las propiedades de relación tal y como se


Campo Descripción

Etiqueta Escriba una etiqueta para identificar la relación.

Proyecto Seleccione el proyecto para la relación.

Origen Seleccione el modelo de origen.

Destino Seleccione el modelo de destino.


Configurar una relación de objetos1. En el navegadorModelos de objetos, haga doble clic en la relación para abrirla.2. En el editor de relaciones, haga clic en Conceptos básicos.3. Configure la relación tal y como se describe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el artefacto derelación. Utilice una etiqueta significativa para elusuario final de la aplicación ya que es la etiquetapredeterminada para los widgets de la interfaz deusuario.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique la relación cuando se utiliceen la API.



Campo Descripción

Descripción Escriba una descripción de la relación.

Modelo de origen Seleccione el modelo de objeto de origen.

Modelo de destino Seleccione el modelo de objeto de destino.

Direccionalidad Para configurar una relación unidireccional,seleccione Unidireccional (de origen a destino) yelija el tipo de relación unidireccional.

Para configurar una relación bidireccional,seleccione Bidireccional y elija el tipo de relaciónbidireccional.

Origen Identifica el proyecto al que pertenece la relación.

Archivo Identifica la ruta de acceso al archivo de relacionesen el sistema de archivos.

4. En una relación unidireccional, escriba una etiqueta y el nombre del sistema a fin de indicar elmodo en el que el modelo de origen hace referencia al modelo de destino.

5. En una relación bidireccional, escriba una etiqueta y el nombre del sistema para cada sentidode la relación.

6. Haga clic en Guardar.7. Haga clic en Atributos.8. Cierre los editores de los modelos de origen y destino si están abiertos.9. En el editor de relaciones, agregue atributos a la relación.10.Haga clic en Guardar.

Cuando crea muchas relaciones y las vincula al mismo tiempo, se produce un error de validacióndurante la operación. Esto se debe a que la longitud del atributo xml_value está establecidacomo 10.000 caracteres y la longitud del evento generado supera la establecida. Este eventoocurre cuando:

• Hay una relación de 1:n y el elemento principal tiene más de 20 elementos secundariosrelacionados.

• Se suscribe el evento con atributos asignados en el conjunto de datos del elemento principal y elsecundario. El evento de actualización en el objeto se desencadena y genera un solo XML quecontiene el objeto principal con los 20 objetos secundarios y sus relaciones. El XML excedelos 10.000 caracteres y se produce un error en la operación.

Para evitar esto:

• Cree un evento de relación cuando el elemento principal y el secundario estén relacionados.

• Cree un nuevo informe, agregue el evento de relación y asigne el mismo conjunto de atributosen el conjunto de datos. Cada vez que se agrega un elemento principal a uno secundario, elsistema genera un archivo XML para esa relación en concreto. De este modo, habrá variosarchivos XML pequeños, en vez de uno grande.

Trabajar con el navegador de modelos de objetoPara realizar un duplicado de un modelo, haga clic con el botón secundario en el modelo y seleccioneDuplicar. El modelo duplicado hereda los atributos del modelo original.



Para transferir un modelo a un proyecto diferente, haga clic con el botón secundario en el modelo,seleccioneMover a y seleccione el nuevo proyecto.

Para eliminar un modelo, haga clic con el botón secundario en él y seleccione Eliminar, o bienseleccione el modelo y pulse la tecla Supr.

Definir alertas1. En el navegador de modelos de objetos, haga clic en Nuevo→ Alerta.

2. En el cuadro de diálogo Alerta nueva, especifique propiedades como se describe en la siguientetabla:

Campo Descripción

Etiqueta Actualice el nombre del servicio de Java.

Nombre de clase Seleccione una consulta histórica.


4. En la pestaña Conceptos básicos, especifique las propiedades tal y como se describe en la siguientetabla:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar la alerta.

Nombre del sistema El nombre del sistema se utiliza internamente para identificarde forma única el modelo.

Modelo principal Identifica la consulta histórica asociada con la alerta.

Descripción Escriba una descripción de la alerta.

Origen Identifica el proyecto al que pertenece el modelo de alerta.

Archivo Identifica la ruta de acceso al archivo de modelo en el sistemade archivos.

5. En la pestaña Desencadenadores, especifique las propiedades tal y como se describe en lasiguiente tabla:

Campo Descripción

La condición es verdadera Escriba una expresión booleana que crea un desencadenador.El sistema crea una alerta solo si se cumple la condición.

Volver a evaluar el desencadenador alactualizar los datos

Seleccione esta opción para volver a evaluar eldesencadenador cuando se actualicen los datos. El sistemaevalúa la condición cuando uno de los atributos usado en laexpresión ha cambiado.



Campo Descripción

Severidad Seleccione la severidad de la alerta.

Granularidad de tiempo Seleccione un período de tiempo durante el cual el sistemaevalúa los datos.

El valor de granularidad de tiempo solo es aplicable sise define la agregación en HDS. Este campo significael tipo de tabla de agregación que se supervisa para eldesencadenamiento de las alertas.

6. En la pestaña Conjunto de datos, realice los siguientes pasos:a. Para agregar columnas al conjunto de datos, arrastre campos del área inferior de la paleta Datos

de contexto y suéltelos en Columnas de conjunto de datos.

Si necesita cambiar el orden de las columnas de conjunto de datos, puede eliminar las columnasy agregarlas de nuevo en el orden correcto.

b. Para eliminar una columna de conjunto de datos, haga clic con el botón secundario en ellay haga clic en Eliminar.

c. Para editar el nombre de una columna, selecciónela y modifique la Etiqueta en la vistaPropiedades.

7. En la pestaña Acciones, realice los siguientes pasos:a. Haga clic Agregar, escriba una etiqueta y haga clic Siguiente.b. Seleccione la acción que se producirá después de que el sistema desencadene la alerta:

• Para que los datos de alertas solo estén disponibles para los informes, seleccione Ningunaacción. Realice una única entrada y vaya al último subpaso.

• Para iniciar un proceso y hacer que los datos de alertas estén disponibles para los informes,seleccione Iniciar proceso o Iniciar proceso sin estado y vaya al siguiente subpaso.

c. Seleccione el proceso y haga clic en Siguiente.d. Defina los valores de entrada para inicializar el proceso. Seleccione el paquete y cree una

expresión para asignar la alerta al atributo de ID de objeto del modelo. Asimismo, asigne lasvariables de entrada a los atributos de la salida de alerta.

e. Haga clic en Finalizar.

Crear un fragmento de tipo1. En el navegador deModelos de objetos, haga clic en Nuevo → Fragmento de tipo.2. En el cuadro de diálogo Nuevo fragmento de tipo, especifique las propiedades del fragmento de

tipo tal y como se describe en la siguiente tabla:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el fragmento de tipo.

Proyecto Si la aplicación contiene proyectos, seleccione el proyecto para el tipo defragmento.




4. En la pestaña Conceptos básicos, especifique las propiedades del fragmento de tipo, tal y como sedescribe en la siguiente tabla:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el fragmento de tipo.

Nombre del sistema El nombre del sistema se utiliza internamente para identificar de forma única elmodelo.

Descripción Escriba una descripción del fragmento de tipo.

Origen Identifica el proyecto al que pertenece el fragmento de tipo.

Archivo Identifica la ruta al archivo de fragmento de tipo en su sistema de archivos.

5. En el área Características de tiempo de ejecución, seleccione Permitir que este fragmento detipo se adjunte a cualquier tipo en tiempo de ejecución para quitar la restricción del fragmentode tipo para que se adjunte solo a un tipo específico.

6. En el área Funciones de tiempo de ejecución, seleccione Permitir que este fragmento de tipo seadjunte al nuevo objeto en copia para adjuntar el fragmento de tipo al objeto recién creado cadavez que se realiza una operación de copia del objeto.

7. En el área Funciones de tiempo de ejecución, seleccione Permitir que este fragmento de tipo seadjunte al nuevo objeto en versión para adjuntar el fragmento de tipo al objeto recién creado cadavez que se realiza una operación de versión del objeto.

8. En la pestaña Atributos, arrastre un elemento de atributo de la paleta Tipos y suéltelo en elfragmento de tipo.

9. En la pestaña General de la vista Propiedades, especifique propiedades de fragmentos de tipotal y como se describe en la siguiente tabla:

Campo Descripción

Etiqueta Escriba una etiqueta para un atributo de fragmento de tarea.

Lista desplegable Busque y seleccione la lista desplegable que se utilizará para un atributo defragmento de tarea.

Nombre del sistema El nombre del sistema se utiliza internamente para identificar el atributo delfragmento de tarea.

Valor único Seleccione esta opción para configurar el atributo de forma que solo tenga unvalor.

Multivalor Seleccione esta opción para configurar el atributo para que tenga muchosvalores como una lista de provincias o ciudades.

Longitud de cadena Escriba el número de caracteres permitido en un atributo de cadena.

Durante la implementación de aplicaciones, el sistema valida la longitud decadena con respecto al tamaño de paginación de la base de datos del repositorio.

Valor predeterminado Cree una expresión para devolver un valor inicial para el atributo. El valoraparece de forma predeterminada en instancias del fragmento de tipo en tiempode ejecución de aplicación.

Este valor aparece cuando el usuario final crea una instancia del fragmento detipo y no especifica un valor de atributo.

10. En la ficha Validación, especifique las propiedades del atributo, tal y como se describe en latabla siguiente:



Campo Descripción

Utilizar validaciónbasada en expresiones

Seleccione esta casilla de verificación para utilizar la validación personalizadacon el atributo.

Mensaje de validación Escriba el error que aparecerá si el usuario final introduce un valor no válido.

Condición de validación Introduzca los criterios que se utilizan para comprobar la validez del atributo.El mensaje aparece si esta condición es falsa.

11. En la pestaña Información, escriba una descripción para el atributo y haga clic en Guardar.12. En la pestaña Evento de negocio, haga clic en Nuevo evento de negocio.13. En el cuadro de diálogo Evento de negocio de <nombre de fragmento de tipo>, configure el

evento de negocio tal y como se describe en la siguiente tabla:

Campo Descripción

Etiqueta Escriba una etiqueta que identifique el evento de negocio para un fragmento de tipo.

Descripción Escriba una descripción del evento de negocio.

Se desencadenacuando

Seleccione el elemento que desencadena el evento de negocio.

Cuando el sistema adjunta, separa o actualiza un fragmento de tipo para unainstancia del objeto, se desencadena el evento asociado con un objeto.

La condición esverdadera

Escriba una expresión booleana que cree el evento de negocio. El sistema crea elevento solo si se cumple la condición.

14.Haga clic en Siguiente.15. Seleccione la acción que se producirá después de que el sistema cree el evento de negocio:

a. Para conseguir que los datos de eventos solo estén disponibles para los informes, seleccioneNinguna acción y vaya al paso 16.

b. Para iniciar un proceso y hacer que los datos de eventos estén disponibles para los informes,seleccione Iniciar proceso o Iniciar proceso sin estado y vaya al paso 14.

16. Seleccione el proceso y haga clic en Siguiente.17. Para definir los valores de entrada que inician el proceso:

a. En el cuadro de diálogo Evento de negocio de <nombre de fragmento de tipo>, seleccionelos paquetes o las variables.

b. Cree una expresión que asigne los datos del evento de negocio a los datos de proceso.18.Haga clic en Finalizar.

Conceptos

Modelos de objetosUn modelo de objeto define las instancias de un objeto en tiempo de ejecución de aplicaciones. Alcrear un modelo de objeto, puede configurar sus atributos y la ubicación en la que las instancias detiempo de ejecución del objeto se almacenan en el repositorio de Documentum. Los usuarios finales dela aplicación proporcionan valores de atributos para describir las instancias de los objetos que crean.



Documentum xPlore es un componente de Documentum Content Server y automáticamente seimplementa como parte del entorno de xCP. Le permite obtener todos los objetos indexados detexto completo sin ninguna configuración manual. Al crear aplicaciones, la configuración de índicede xPlore se actualiza para indexar todos los objetos para todas las aplicaciones, incluidos loscomentarios. Puesto que la indexación de xPlore es global y no específica de la aplicación, no sepueden definir modelos de objeto con atributos que tengan el mismo nombre de sistema pero quesean de tipos diferentes. Por ejemplo, no se puede definir un identificador como una cadena en unaaplicación ni como un número entero en otra aplicación.

Modelos de objeto base

Los modelos de objetos de contenido de base, carpeta de base y archivador de base se puedenpersonalizar.

Puede configurar las páginas de contenido de base, carpeta de base y archivador de base, así como losflujos de acción y los menús contextuales. No se pueden agregar nuevos atributos, relaciones, aspectoso eventos de negocio al modelo de contenido de base, carpeta de base o archivador de base. Si deseaconfigurarlos, debe crear un nuevo tipo personalizado.

Para el contenido de base, podrá encontrar en la biblioteca la vista predefinida, las páginas de edición ylos fragmentos _imp/_chk. Puede crear y personalizar la vista, así como editar las páginas y configurarel menú contextual para utilizarlos.

Para la carpeta de base, podrá encontrar en la biblioteca la vista predefinida, las páginas de edición ylos fragmentos _create. Puede crear y personalizar la vista, así como editar las páginas y configurarel menú contextual para utilizarlos.

Para el archivador de base, encontrará una vista predefinida, las páginas de edición y los fragmentos_create en la biblioteca. Puede crear y personalizar la vista, así como editar las páginas y configurarel menú contextual para utilizarlos.

Para los tipos de contenido de base, carpeta de base o archivador de base, se pueden crear y configurarlos objetos siguientes:

• Páginas

• Fragmentos

• Flujos de acción

• Menú de contexto

Para las aplicaciones migradas desde versiones anteriores de xCP, las opciones de ver y editar páginas,así como el menú contextual están disponibles en xCP Designer.

Determinar qué modelo de objeto utilizar

Utilice la tabla siguiente para determinar qué modelo de objeto se va a utilizar al crear una aplicación:



Modelo Descripción Ejemplo

Alerta

Definir alertas,página 70

Define una alerta en el sistema que puedeiniciar un proceso cuando se cumple lacondición definida.

Se define una alerta llamada Reclamacionesde supervisión basada en los datos históricos.En tiempo de ejecución, el sistema notificaesta alerta al departamento correspondientecuando el número de reclamaciones de uncliente supera el umbral especificado.

Objeto denegocio

Crear unmodelo deobjeto, página61

Define un concepto de negocio, como unapersona, ubicación o producto. Puede crearun modelo de objeto de negocio que no tengaatributos o un modelo de objeto de negocioque herede los atributos de otro objeto denegocio modelo. Los modelos de objeto denegocio no incluyen contenido, copias niversiones.

Un modelo de objeto de negocio denominadoCliente tiene los siguientes atributos:

• Nombre (cadena)

• Apellido (cadena)

• Dirección (cadena)

El usuario final crea un objeto de negociobasado en el modelo Cliente y especificavalores para los atributos.

Contenido


Define el contenido como texto, imagen,vídeo o archivos de audio. Puede crear unmodelo de contenido que no tenga atributoso un modelo de contenido que herede losatributos de otro modelo de contenido. Losmodelos de contenido pueden contenercopias y versiones.NotaEn tiempo de ejecución, se puedeeliminar la versión del documentoimportado. El sistema solicitará que seeliminen la versión actual o todas lasversiones del documento.

Un modelo de contenido con el nombre deReclamación tiene los siguientes atributos:

• Nombre (cadena)

• Apellido (cadena)

• Tipo de directiva (lista desplegable)

• Número de directiva (cadena)

• Número de reclamación (cadena)

• Cantidad (flotante)

• Aprobadores (cadena, varios valores)

El usuario final crea un objeto de contenidobasado en el modelo Reclamación. Elusuario final anexa un archivo de imagen(por ejemplo, una imagen de daño depropiedad) y especifica valores para losatributos.

Carpeta


Define una carpeta que contiene objetoscomo objetos de negocio, objetos decontenido y otras carpetas. Puede crear unmodelo de carpeta que no tenga atributos oun modelo de carpeta que herede los atributosde otro modelo de carpeta. El contenido deuna carpeta está sujeto a las directivas decontención definidas para la carpeta.

Un modelo de carpeta denominadaContenido de reclamaciones tiene lossiguientes atributos:

• Número de reclamación (cadena)

• Número de directiva (cadena)

• Procesado (booleano)

La carpeta permite al usuario final ver elestado de una reclamación de forma conjunta.



Modelo Descripción Ejemplo

Listadesplegable

Crear unmodelo deuna listadesplegable,página 65

Define una lista de etiquetas y los valorescorrespondientes. Puede utilizar la listadesplegable como un atributo de un modelode objeto de negocio, de contenido y decarpeta. Solo se muestran las etiquetas entiempo de ejecución. Los valores asociados alas etiquetas se almacenan en el repositoriode Documentum.

Un modelo de contenido con el nombre deEspecificación de ingeniería tiene un atributode lista desplegable con el nombre Estado.La lista desplegable contiene las etiquetasAprobado, Rechazado y No revisado. Elusuario final selecciona el estado de unalista desplegable Estado en una página deaplicación.

Fragmento detipo

Crear unfragmento detipo, página 71

Define un modelo de fragmento de tipo quecontiene uno o varios atributos que puededefinir con el tipo de objeto o el tipo base.Puede adjuntar un fragmento de tipo con unainstancia del objeto en tiempo de ejecuciónde la aplicación.

Un fragmento de tipo llamado Validardocumento se define y agrega a un flujo deproceso. En tiempo de ejecución, el sistemaanexa el fragmento de tipo de documentode validación a cada dibujo que envía alproveedor. De esta forma, el usuario finalpuede realizar el seguimiento del flujo dedocumentos.

Atributos del modelo de objeto

Los atributos son metadatos que definen instancias de objetos creadas en tiempo de ejecución. Losusuarios finales especifican valores de atributos al crear instancias de objetos. Al crear un modelode objeto, le puede agregar atributos personalizados. En la siguiente tabla se describen los tipos deatributo que se pueden agregar:

Tipo Descripción

Cadena Representa una secuencia de caracteres como, por ejemplo:

• Blas Sanz

• Plaza Mayor 34

• 043bd5r

Entero Representa un número entero como, por ejemplo:

• 10

• -525

Flotante Representa un número con un separador decimal como, por ejemplo:

• -0,66

• 27789,443

Booleano Representa un valor de verdadero o falso.



Tipo Descripción

Fecha-hora Representa una fecha o una combinación de fecha y hora como, por ejemplo:

• 28/10/1981

• 28 de octubre, 1981, 11:00 AM

Lista desplegable Representa una lista que puede rellenar una lista desplegable en una páginade aplicación como, por ejemplo:

• Lista de estados

• Entidades asociadas a un préstamo hipotecario (Prestatario, Prestamista oCompañía de seguros)

• Estados de reclamación (Enviado, Revisado y Aprobado)

• Tipos de cliente (Potencial, Cliente e Inactivo)

xCP Designer agrega automáticamente los siguientes atributos a los modelos de objeto:

• Modificado por (cadena)

• Creado por (cadena)

• Creado el (fecha y hora)

• ID de carpeta (cadena)

• Última modificación (fecha y hora)

• Nombre (cadena)

• ID de objeto (cadena)

• Tipo de objeto (cadena)

xCP Designer oculta de forma predeterminada estos atributos. Para verlos, seleccione Mostrarheredados en la pestaña Atributos del editor de modelos de objeto.

Definir los valores de atributo predeterminados

Puede crear una expresión para que devuelva un valor de atributo predeterminado en tiempo deejecución. Los usuarios finales de la aplicación pueden utilizar el valor predeterminado o especificarun valor diferente. Consulte la tabla siguiente para obtener ejemplos de expresiones de valorpredeterminado:



Expresión Descripción

15.0000,00 Cree un objeto de negocio denominado Préstamo.Añada un atributo flotante al objeto de negocio ypóngale el nombre de Cantidad mínima. Cuandoun procesador de préstamos crea una instancia depréstamos en tiempo de ejecución, 15.0000,00 aparecede forma predeterminada en el campo de Cantidadde préstamo. El procesador puede utilizar el valorpredeterminado o escribir un valor diferente.

parameters.app.department_code Cree un objeto de negocio denominado Departamento.Añada un atributo de cadena al objeto de negocio ypóngale el nombre de Código. Cree un parámetro decadena con el nombre Código de departamento conun valor de GP-988. Cuando el usuario final de laaplicación crea una instancia del objeto de negocioDepartamento, GP-988 aparece en el campo Códigoen la página de la aplicación.

Para cambiar el valor de código predeterminado sinvolver a empaquetar la aplicación, puede cambiarel valor de propiedad Código de departamentopredeterminado de GP-988 a un valor diferente en elarchivo XML de configuración de la aplicación.

Acceder a un objeto de negocio mediante unadirección URL

Puede acceder a un objeto de negocio desde una URL haciendo clic en la dirección URL. El objeto denegocio asociado se abrirá en el patrón de aplicaciones.

Eventos de negocio

Un evento de negocio hace que los datos estén disponibles para los informes o inicia un proceso. Puedeconfigurar eventos para los objetos de negocio, los objetos de contenido y las carpetas.

Al configurar un evento, seleccione el desencadenador que generará el evento y defina una condiciónpara el desencadenador. La condición es una expresión booleana que se evalúa en tiempo de ejecución.Si se cumple la condición, se genera el evento. Al configurar un evento para un desencadenador deactualización, la condición se evalúa solo si se ha cambiado la entrada.

En la tabla siguiente se muestran las expresiones de ejemplo de las condiciones de eventos de negocio:




event.loan_application.amount > 500000 Cree un evento de negocio con el nombre "PréstamoJumbo" para un objeto de negocio denominado"Aplicación de préstamo" con un atributo de enterocon el nombre "Importe". El usuario final envía unasolicitud de préstamo por un importe de 525.000USD. Dado que la cantidad supera los 500.000 USD,el sistema genera el evento de negocio y este inicia unproceso denominado "Revisión del préstamo Jumbo".

event.old_maintenance_operati.maintenance_status!= ’-1’ AND event.maintenance_operati.mainte-nance_status == ’-1’

Cree un evento denominado "Cambio de estado"para un objeto de negocio con el nombre "Operaciónde mantenimiento" que presente un atributo de listadesplegable denominado "Estado de mantenimiento".La lista desplegable tiene una entrada con la etiqueta"En espera" asociada al valor 0 y una entrada conla etiqueta "Completado" asociada al valor -1. Si elusuario final selecciona "Completado" en una listadesplegable de una página de aplicación, el sistemagenera el evento de negocio.

Al configurar un evento de negocio en los metadatos descubiertos, utilice el desencadenador "Atributosde metadatos descubiertos de <content_model> actualizados". A diferencia del resto de eventos, esteevento es asíncrono porque el análisis de contenido puede tardar un tiempo. Cuando un usuariofinal importa o modifica un objeto de contenido, el servidor CIS lo analiza y almacena o actualizalos valores almacenados de los metadatos descubiertos antes de desencadenar el evento. No utilice eldesencadenador "<content_model> actualizado" para los metadatos descubiertos; como el evento esasíncrono, el sistema lo evalúa con los valores anteriores, posiblemente obsoletos, de los metadatosdescubiertos.

Descripción de los análisis de contenidoUtilice el análisis de contenido para analizar el contenido textual de los objetos de contenidoy comprender mejor de qué tratan los objetos sin necesidad de leerlos. Permita a los usuariosencontrar objetos de contenido rápidamente mediante facetas de búsqueda enriquecidas con metadatosdescubiertos y extraer la información esencial de un objeto de contenido consultando los metadatosdescubiertos en línea con el objeto.

Content Intelligence Services (CIS) es el componente de Documentum para el análisis de contenido.Cada vez que se crea o importa un objeto de contenido diseñado con metadatos descubiertos en elrepositorio, el servidor de CIS lo analiza y devuelve los metadatos que descubra.

Las siguientes secciones describen los tres tipos de análisis que permiten buscar y detectar metadatos.

Detección de patronesDeterminados tipos de información presentan siempre el mismo formato. Utilice la función dedetección de patrones para recuperar este tipo de información, diseminada por el texto. Por ejemplo, sepueden extraer las direcciones de correo electrónico mediante la detección de patrones, ya que cumplencon un estándar. La función de detección de patrones recupera todos los metadatos encontradosque se corresponden con dicho patrón.



Detección de entidades

La función de detección de entidades es más inteligente que la detección de patrones, ya que se basaen el procesamiento del lenguaje natural (NLP, por sus siglas en inglés). Los metadatos descubiertosse detectan al realizar un análisis semántico de su contexto. Si el contexto es demasiado escaso, o sino está claro, puede que la detección parezca estar incompleta. Por ejemplo, la detección funcionamejor con sentencias que con tablas. Puede utilizar la función de detección de entidades para localizarnombres de personas o empresas en objetos de contenido.

Clasificación

Al detectar palabras clave predefinidas dentro del contenido, la clasificación identifica la categoría ala que pertenece un objeto de contenido. Las categorías de un área temática se organizan según unaestructura denominada taxonomía. La función de clasificación le permite organizar el contenidodel repositorio de una forma lógica y coherente. Por ejemplo, puede usar el metadato descubiertoTérminos de negocio (EE. UU.) para organizar documentos empresariales de acuerdo con el tema quetratan y su dominio correspondiente.

Metadatos descubiertos

Los metadatos descubiertos son fragmentos de información localizados al analizar el texto. Solo estándisponibles para objetos de contenido. Pueden encontrarse en el contenido en sí, en los valores delas propiedades del archivo o en los valores de los atributos del objeto. Las propiedades de archivoson características anexadas a un archivo en sí. Las propiedades se conservarán cuando se importe elarchivo al repositorio desde un sistema local de archivos, por ejemplo.

Al crear un modelo de contenido, debe definir qué metadatos descubiertos prefiere. Puede utilizar losmetadatos descubiertos en los casos siguientes:

• Cree búsquedas utilizando metadatos descubiertos en las consultas de texto completo comoentradas, salidas y facetas.

• Muestre los metadatos descubiertos al visualizar un objeto de contenido.

• Supervise la evolución de metadatos descubiertos para un modelo de contenido mediante el eventode negocio "Actualizados los atributos de los metadatos descubiertos".

Hay muchos tipos diferentes de metadatos descubiertos. Este tema detalla qué se puede encontrarcomo un metadato descubiertos.

Metadatos descubiertos por tipo de análisis

La tabla siguiente enumera los metadatos descubiertos según el tipo de análisis empleado:

Tipo de análisis Metadatos descubiertos

Clasificación Términos comerciales (EE. UU.), Ciencia e Ingeniería



Tipo de análisis Metadatos descubiertos

Detección de entidades Número de fax, empresa u organización, personas,número de teléfono, ubicación geográfica, direcciónde correo postal

Detección de patrones Dirección de correo electrónico, número de SeguridadSocial (EE. UU.), dirección URL

Metadatos descubiertos como términos comerciales (EE.UU.)Los metadatos descubiertos como resultado de la clasificación con la taxonomía de Términoscomerciales (EE. UU.) incluyen teorías y conceptos, como aspectos éticos, valoración, relacionespúblicas, mercadeo global, comunicación intercultural y temas relacionados con áreas de caráctergeneral como finanzas, mercadeo, administración y recursos humanos.

Los siguientes son ejemplos de términos comerciales que se pueden encontrar durante la clasificación:Financial Statements, Accounting, Balance sheet, Consolidated Income Statements, Long-Term Loans,Repayment Schedule, Time to Maturity, Arbitration and Mediation, Audit.

Metadatos descubiertos de dirección de correo electrónicoLos metadatos descubiertos de dirección de correo electrónico se encuentran mediante el uso dedetección de patrones. Los siguientes son los criterios utilizados:

• La parte local, es decir, la primera parte de la dirección de correo electrónico, contiene solamentecaracteres alfanuméricos, puntos (.), guiones (-) o signos de subrayado (_) y no supera los 50caracteres.

• El nombre de dominio, la última parte de la dirección de correo electrónico, pertenece a un dominiode nivel superior válido, como com, org o net, y no supera los 50 caracteres.

La detección no comprueba la validez de las direcciones de correo electrónico encontradas.

La siguiente tabla enumera ejemplos de direcciones de correo electrónico que se pueden detectar o no:

Direcciones de correo electrónico detectadas Direcciones de correo electrónico no detectadas

[email protected] [email protected]

[email protected] john&[email protected]

[email protected] foo@@.org

Metadatos descubiertos de organizaciónSegún la detección de entidades, se pueden detectar nombres de organizaciones, empresas, compañías,instituciones y medios dentro del contenido de texto.

Por ejemplo, la detección de entidades puede detectar los siguientes nombres de organización:

• Iomega

• Massachusetts General Hospital



• Senado de los EE. UU.

• Wall Street Journal

Metadatos descubiertos de personasSegún la detección de entidades, se pueden detectar nombres de personas en el contenido de texto.

Por ejemplo, la detección de entidades puede detectar los siguientes nombres de personas:

• Ms. Madsen

• Mark McClellan

• Dr. John R. Borzilleri

Metadatos descubiertos de lugaresSegún la detección de entidades, se pueden detectar nombres de ubicaciones geográficas oinfraestructuras en el contenido de texto.

Por ejemplo, la detección de entidades puede detectar los siguientes nombres de ubicaciones:

• África

• Londres

• Pearl Harbor

Cuando se detecta el nombre de una ubicación geográfica, se almacena una ruta de acceso después delpatrón continente/país/(EE. UU. cuando sea el caso)/ciudad. Por ejemplo:

• Europa/Francia/París

• América/Estados Unidos/California/San Francisco

Toda la ruta de acceso se muestra cuando se agregan los metadatos descubiertos de lugares como unacolumna de salida en un modelo de consulta o cuando se muestran en una página de visualizaciónde contenido. Puede utilizar una expresión para mostrar solo un nivel específico de ruta de acceso.Cuando utilice los metadatos descubiertos de lugares como una entrada en un modelo de consulta, labúsqueda se ejecuta en toda la ruta de acceso también.

Para consultar entradas de usuario, utilice el operador Contiene para que coincida cualquier términocon toda la ruta de acceso. Si utiliza el operador Es igual a, los usuarios finales tienen que introducirtoda la ruta de acceso para obtener resultados.

Cuando utilice los Metadatos descubiertos de lugares como una faceta en un modelo de consulta, elpaís, el estado de EE. UU. y la ciudad se muestran como valores de las facetas. Por ejemplo, si sedetecta la ciudad de París en un objeto de contenido, el sistema muestra dos valores de las facetas:Francia y París.

Metadatos descubiertos de números de teléfono y faxSegún la detección de entidades, se pueden detectar los números de teléfono y fax presentes en elcontenido de texto. Si el contexto no está claro, por ejemplo, si no hay una etiqueta clara comoTeléfono: o Fax:, el sistema asumirá que se trata de un número de teléfono.



Por ejemplo, la detección de entidades puede detectar los siguientes números:

• +33 (1) 35 78 18 28

• Teléfono: (917) 765-865

• Fax: (917) 765-865

• Fax: +91 11 6660 5672

Metadatos descubiertos de dirección postal

Según la detección de entidades, se pueden detectar las direcciones de correo postal en el contenido detexto.

Por ejemplo, la detección de entidades puede detectar las siguientes direcciones de correo postal:

• 23 Rue des Dames, 75 017 París

• PO Box 12345 Mowbray 7705

• 39 Wellington Street, Londres WC2E 7BB

Metadatos descubiertos de ingeniería y científicos

Los metadatos descubiertos encontrados como resultado de la clasificación con la taxonomía deingeniería y ciencia incluyen teorías y conceptos relacionados con los siguientes dominios: astronomía,química, ciencias de la Tierra, ingeniería, geodesia, ciencia material, matemáticas y física.

Los ejemplos de metadatos descubiertos de ingeniería y ciencia son muchos, desde la terminología debiotecnología a la termodinámica y la mecánica estadística, incluida una lista de 973 componentesorgánicos.

Metadatos descubiertos de números de Seguridad Social(SSN, por sus siglas en inglés)

Los metadatos descubiertos de los números de Seguridad Social de EE. UU. se encuentran utilizandola detección de patrones. Los siguientes son los criterios utilizados:

• El número está compuesto por tres dígitos, seguidos de otros dos dígitos y después otros cuatrodígitos: 568-48-4587.

• Las tres partes se separan mediante guiones, no por espacios ni ningún otro carácter.

Los números de Seguridad Social que no sean válidos, como los números que empiezan por 666,no se detectarán.

A continuación, figuran ejemplos de números de Seguridad Social que no son detectables:

• 568484587

• 666-48-4587

• 481-00-4587

• 900-48-4587



Metadatos descubiertos de URL

Los metadatos descubiertos de URL se encuentran mediante la detección de patrones. Los siguientesson los criterios utilizados:

• Comienza por un protocolo, como http, https, ftp o ftps.

• Comienza con el prefijo www o termina con un dominio de nivel superior conocido, como .com,.org, o .net.

La detección no distingue mayúsculas de minúsculas. Las URL similares pero con distintascombinaciones de mayúsculas y minúsculas se fusionarán. La función de detección no compruebala validez de las URL que localiza.

La siguiente tabla enumera ejemplos de direcciones URL que pueden ser detectadas o no:

Direcciones URL detectadas Direcciones URL no detectadas

https://localhost:8080/da/component/main?__dmf-ClientId=1306762423735

foo.bar

http://www.regexlib.com/DisplayPatterns.aspx?cat-tabindex=1&categoryId=2

foo.bar.baz

emc.com wwp.foo.bar

http://www

(www puede ser la denominación de una máquina).

_www.foo.bar

http://121.122.1.20:32000/da/component/main?__dmf-ClientId=1306762423735

Metadatos descubiertos de clasificación

Los metadatos descubiertos encontrados mediante la clasificación (términos comerciales (EE. UU.) oCiencia e Ingeniería) se muestran en tiempo de ejecución de dos formas: como un valor corto ocomo un valor expandido. La clasificación se basa en una taxonomía y la estructura de taxonomíarefleja la jerarquía de categorías. El valor corto es el nivel más relevante en la jerarquía y elvalor de expandido es la ruta de acceso completa de los metadatos descubiertos en la estructura detaxonomía. Por ejemplo, si el valor corto de un metadato descubiertos es Préstamos, la ruta de accesocompleta puede ser Préstamos/Disponibilidad de préstamos/Préstamos para pequeñas empresas oPréstamos/Características de préstamos/Programa de pagos.

La siguiente figura ilustra la estructura de la categoría Préstamos en la taxonomía de términoscomerciales (EE. UU.) con dos ejemplos de rutas de acceso completas:



Al crear un modelo de consulta de texto completo que incluya metadatos descubiertos a partir declasificación, el sistema devuelve la ruta completa como una columna de salida. Cuando muestra unmetadato descubierto a partir de la clasificación en la vista de contenido, la ruta completa se muestratambién. Puede utilizar una expresión para mostrar solo un nivel específico de ruta de acceso.

Del mismo modo, cuando se define una entrada de consulta en un metadato descubierto, el sistemaevalúa la restricción en la ruta completa. Sin embargo, al definir una faceta en un metadato descubiertoa partir de la clasificación, solo el valor corto se muestra para no sobrecargar la interfaz de usuario.

Relaciones de modelos de objetos

Un modelo de relación contiene el modelo de tiempo de diseño para una asociación entre un objetode negocio, un objeto de contenido, una carpeta u otro objeto de negocio en tiempo de ejecución deaplicaciones. Al definir una relación, configure su dirección, tipo y atributos. El objeto a través delque crea la relación es el objeto de origen. El objeto al que relaciona el objeto de origen es el objetode destino.

En una relación unidireccional, el objeto de origen hace referencia a un objeto de destino del mismoproyecto o de un proyecto diferente del que depende el primero. El modelo de relación se almacena enel mismo proyecto que el modelo de objeto de origen.

En una relación bidireccional, el objeto de origen hace referencia al objeto de destino y el objeto dedestino hace referencia al objeto de origen. Tanto los modelos de objeto como el modelo de relaciónse almacenan en el mismo proyecto.

En una asociación de objeto único, puede relacionar un objeto consigo mismo. Por ejemplo, se crea unobjeto de negocio Persona y, a continuación, se crea una relación con el mismo objeto de negocio. Enuna relación unidireccional, puede usar una etiqueta de administrador para describir la relación. Enuna relación bidireccional, puede usar una etiqueta Administrador para describir una dirección de larelación y una etiqueta de Empleado para describir la otra dirección.

La siguiente tabla describe las configuraciones de relación:



Dirección Tipo Descripción

Tiene uno La instancia de objeto de origen se relaciona con una instancia deobjeto de destino. Por ejemplo, una dirección se encuentra en unaciudad.

Unidirec-cional

Tiene muchos La instancia de objeto de origen se relaciona con varias instancias deobjeto de destino. Por ejemplo, un cliente tiene varias direcciones.

Uno a uno La instancia de objeto de origen se relaciona con una instancia deobjeto de destino. Por ejemplo, un cliente tiene un contrato de servicio.

Uno a varios La instancia de objeto de origen se relaciona con varias instancias delobjeto de destino. Por ejemplo, un cliente compra varios elementos.

Varios a uno Varias instancias del objeto de origen se relacionan con solo unainstancia del objeto de destino. Por ejemplo, varios empleados asistena una sesión de formación.

Bidireccional

Varios a varios Varias instancias del objeto de origen se relacionan con variasinstancias del objeto de destino. Por ejemplo, un abogado trabaja envarios casos y cada caso se asocia con varios abogados.

Ejemplo de relación

Una aplicación contiene objetos de negocio denominados Empresa y Persona. Desea configurar unarelación bidireccional entre los objetos de negocio. Desea que el objeto de negocio Empresa tengaacceso a los atributos del objeto de negocio Persona y desea que el objeto de negocio Persona tengaacceso a los atributos del objeto de negocio Empresa.

Configure el objeto de negocio Empresa para que tenga una relación de uno a varios con el objeto denegocio Persona, ya que una empresa tiene más de un empleado. Puesto que crea la relación a travésdel objeto de negocio Empresa, este es el objeto de origen. La persona es el objeto de destino.

Puesto que la empresa se refiera a una persona como empleado, utilice Empleado como etiqueta parala dirección de la relación empresa-persona. Puesto que la persona se refiera a la empresa como unempleado, utilice Empleado como etiqueta para la dirección de la relación empresa-persona. Las cifrassiguientes muestran la relación cuando se ve desde cada objeto de negocio:

Comportamientos de las configuraciones de relación

En la tabla siguiente se describe el comportamiento de las configuraciones de relación de modelos deobjeto y los resultados finales:



Relación de DesignerObjetosdenegocio

Dirección Tipo

Relación en tiempo deejecución

Comportamiento

DeCliente aGarantía

Unidireccional Tiene uno(con atributosaplicables)

1. Cree una relación entrelas instancias de objetode negocio Cliente1 yGarantía1.




5. Repita el paso 1

6. Repita el paso 2.

1. Se ha creado la relaciónentre Cliente1 y Garantía1.

2. Se ha eliminado la relaciónentre Cliente1 y Garantía1.Se ha creado la relaciónentre Cliente1 y Garantía2.





Relaciones en el sistema:

Cliente1 y Garantía2

DeCliente aGarantía

Unidireccional Tiene uno(sin atributosaplicables)





5. Repita el paso 3


1. Se ha creado la relaciónentre Cliente1 y Garantía1.





6. Se ha eliminado la relaciónentre Cliente1 y Garantía1.




Dirección Tipo


Comportamiento

Se ha creado la relaciónentre Cliente1 y Garantía2.


Cliente1 y Garantía2

DeCliente aEmpresa

Unidireccional Tiene muchos(con atributosaplicables)

1. Cree una relación entrelas instancias de objetode negocio Cliente1 yEmpresa1.




5. Repita el paso 1


1. Se ha creado la relaciónentre Cliente1 y Empresa1.


3. Se ha eliminado la relaciónentre Cliente1 y Empresa2.Se ha creado la relaciónentre Cliente2 y Empresa2.





Cliente1 y Empresa1

Cliente1 y Empresa2

DeCliente aEmpresa

Unidireccional Tiene muchos(sin atributosaplicables)













Dirección Tipo


Comportamiento

5. Repita el paso 1




Cliente1 y Empresa1

Cliente1 y Empresa2

DeCliente aSeguro

Bidireccional Uno a varios(sin atributosaplicables)

1. Cree una relación entrelas instancias de objetode negocio Cliente1 ySeguro1.




1. Se ha creado la relaciónentre Cliente1 y Seguro1.

2. Se ha creado la relaciónentre Cliente1 y Seguro2.

3. Se ha eliminado la relaciónentre Cliente1 y Seguro2.Se ha creado la relaciónentre Cliente2 y Seguro2.

4. Se ha eliminado la relaciónentre Cliente1 y Seguro1.Se ha creado la relaciónentre Cliente2 y Seguro1.


Cliente2 y Seguro2

Cliente2 y Seguro1

DeSeguro aCliente

Bidireccional Varios a uno(sin atributosaplicables)

Sololectura

1. Cree una relación entrelas instancias de objetode negocio Seguro1 yCliente1.




1. Se ha creado la relaciónentre Seguro1 y Cliente1.

2. Se ha eliminado la relaciónentre Seguro1 y Cliente1.Se ha creado la relaciónentre Seguro1 y Cliente2.

3. Se ha creado la relaciónentre Seguro2 y Cliente2.

4. Se ha eliminado la relaciónentre Seguro1 y Cliente1.Se ha creado la relaciónentre Seguro2 y Cliente1.


Seguro1 y Cliente2

Seguro2 y Cliente1




Dirección Tipo


Comportamiento

DeCliente aPréstamo

Bidireccional Varios a uno(con atributosaplicables)

1. Cree una relación entrelas instancias de objetode negocio Cliente1 yPréstamo1.






1. Se ha creado la relaciónentre Cliente1 yPréstamo1.

2. Se ha eliminado larelación entre Cliente1y Préstamo1. Se ha creadola relación entre Cliente1y Préstamo2.

3. Se ha creado la relaciónentre Cliente2 yPréstamo2.





Cliente 1 y Préstamo2

Cliente2 y Préstamo1

DeCliente aBanco

Bidireccional Varios a varios(sin atributosaplicables)

1. Cree una relación entrelas instancias de objeto denegocio Cliente1 y Banco1.





1. Se ha creado la relaciónentre Cliente1 y Banco1.









Dirección Tipo


Comportamiento

6. Repita el paso 2. Relaciones en el sistema:

Cliente1 y Banco1

Cliente1 y Banco2

Cliente2 y Banco2

Cliente2 y Banco1

Cliente1 y Banco1

Cliente1 y Banco2

DeBanco aCliente

Bidireccional Varios a varios(sin atributosaplicables)

1. Cree una relación entrelas instancias de objeto denegocio Banco1 y Cliente1.






1. Se ha creado la relaciónentre Banco1 y Cliente1.







Banco1 y Cliente1

Banco2 y Cliente1

Banco2 y Cliente2

Banco2 y Cliente1

Banco1 y Cliente1

Banco1 y Cliente2

DeCliente aCliente

Crear unarelación entrelas instanciasdel mismoobjeto denegocio

1. Cree una relación entrelas instancias de objetode negocio Cliente1 yCliente2.

No se puede crear una relaciónentre una instancia de un objetode negocio y esta misma, soloentre instancias diferentes.

1. Se ha creado la relaciónentre Cliente1 y Cliente2.


Cliente1 y Cliente2




Dirección Tipo


Comportamiento

DeCliente aSocio

Bidireccional Uno a uno(con atributosaplicables)

1. Cree una relación entrelas instancias de objeto denegocio Cliente1 y Socio1.




1. Se ha creado la relaciónentre Cliente1 y Socio1.

2. Se ha eliminado la relaciónentre Cliente1 y Socio1.Se ha creado la relaciónentre Cliente1 y Socio2.




Cliente2 y Socio1

De Socioa Cliente

Bidireccional Uno a uno(con atributosaplicables)

1. Cree una relación entrelas instancias de objeto denegocio Socio1 y Cliente1.




1. Se ha creado la relaciónentre Socio1 y Cliente1.

2. Se ha eliminado la relaciónentre Socio1 y Cliente1.Se ha creado la relaciónentre Socio1 y Cliente2.




Socio2 y Cliente1

Alerta

Al diseñar una aplicación, puede que necesite agregar un sistema de alerta. Por ejemplo, al diseñaruna aplicación para un proveedor de seguros, puede crear un sistema de alerta que envíe un correoelectrónico a todas las aseguradoras cuyo pago de la prima venza en 30 días.

Una alerta contiene una condición que solicita al sistema que realice determinadas acciones cuandoesta se cumpla. Puede definir la lógica de la condición en una expresión booleana que el sistemaevalúa con respecto a datos de consulta histórica en tiempo de ejecución. Cuando los datos cumplen



la condición, el sistema desencadena la alerta y realiza las acciones configuradas. También puedeespecificar el intervalo de tiempo para reiniciar una alerta.

Puede enlazar una consulta de alerta a varios widgets. La siguiente tabla describe los diferentescasos de uso:

AlertaWidget Caso de uso

Todos de varios valores

Todos los widgets Cualquier expresión que espere un valor único.Por ejemplo, el valor inicial de todos los widgetscon un solo valor de entrada.

Sí [1]

Todos los widgets Cualquier expresión que espere más de un valor.Por ejemplo, el valor inicial de todos los widgetscon más de un valor de entrada.

Sí

Lista de resultados,grupo de opción, listadesplegable y listadesplegable de variosvalores

Enlazar servicio de datos Sí

Gráfico de barras, gráficode columnas, gráficoindicador y gráficocircular


[1] Como el valor esperado es del tipo de un solo valor, si desea enlazar la salida de varios valores, deberáproporcionar un número de índice en la matriz, o bien utilizar una función para derivar un solo valor fuerade la matriz.

Fragmento de tipoEl fragmento de tipo le permite agregar comportamientos y/o atributos a un objeto sin cambiar sudefinición de tipo. El sistema le permite asociar fragmentos de tipo con una instancia del objeto entiempo de ejecución.

Por ejemplo, puede agregar el fragmento de tipo Validar documento a un flujo de proceso con el fin derealizar el seguimiento del flujo de documentos. Puede adjuntar este fragmento de tipo a un dibujo deingeniería que envía a un proveedor para su verificación. Este fragmento de tipo le permite realizar elseguimiento de los detalles del proveedor y la fecha en que se envió el dibujo. En tiempo de ejecución,el sistema adjunta este fragmento de tipo a cada dibujo que envía al proveedor. Cuando el proveedor ledevuelve el dibujo de ingeniería revisado, separa este fragmento de tipo de ese dibujo de ingeniería.

La idoneidad de un fragmento de tipo se define durante el diseño. Puede definir la idoneidad de dosformas: arrastre el fragmento de tipo y suéltelo en un modelo de objetos, o bien seleccione la casillade verificación Permitir que este fragmento de tipo se adjunte a cualquier tipo en tiempo deejecución mientras crea un fragmento de tipo. La idoneidad de un fragmento de tipo define si puedeadjuntar un fragmento de tipo a una instancia del objeto en tiempo de ejecución.

En tiempo de ejecución, se puede adjuntar un fragmento de tipo a una instancia del objeto de formaautomática cuando el usuario final crea un objeto o mediante un proceso con una actividad para



adjuntar un fragmento de tipo. Este fragmento de tipo asociado con una instancia del objeto se puedeseparar con una actividad para separar un fragmento de tipo. Un objeto puede tener asociados variosfragmentos de tipo, pero no puede tener asociadas varias instancias del mismo fragmento de tipo.

Una vez que ha configurado un fragmento de tipo para un modelo, los atributos del fragmento de tipoestán disponibles en todos los editores de xCP Designer, lo que incluye editores de aplicaciones,modelos de objetos, procesos, interfaz de usuario y servicios de datos. Sin embargo, no estándisponibles para el editor de consultas de lista de tareas debido a problemas de rendimiento.

Compatibilidad con mensajes de OutlookSe ha introducido el fragmento de tipo para correos electrónicos y se conoce como Aspectode mensaje Mdmo. Este fragmento de tipo se empaqueta como una biblioteca denominadamsgtf.messagetypefragment-1.0.0.jar y está disponible en la carpeta OptionalLibs en laque se encuentra xCP Designer.

Al agregar un modelo de objeto de contenido de tipo de mensaje de correo electrónico de Outlook,el fragmento de tipo extrae los metadatos específicos del mensaje y los almacena en los atributosde fragmentos de tipo. El procesamiento de los mensajes de correo electrónico para extraer losmetadatos de correo electrónico se realiza solo para los tipos de contenido con los que tiene asociado elfragmento de tipo de mensaje. Estos atributos de fragmentos de tipo de mensaje se pueden utilizarcomo cualquier otro atributo de fragmento de tipo, por ejemplo, en el editor de la interfaz de usuariopara ver, buscar o realizar otras funciones.

La biblioteca se ha rellenado con estos campos adicionales para almacenar atributos de metadatosespecíficos de mensajes:

• Dirección de correo electrónico del remitente• Dirección de correo electrónico del destinatario• Dirección de correo electrónico del campo CC• Fecha de envío del mensaje de correo electrónico• Fecha de recepción del mensaje de correo electrónico• Dirección de correo electrónico del campo CCO• Tamaño de los datos adjuntos• Recuento de los datos adjuntos• Se ha firmado• Importancia del correo electrónico• Asunto del correo electrónico• Sensibilidad del correo electrónico• Clase de mensaje• ID de mensaje

Debe agregar la biblioteca de fragmentos de tipo Aspecto de mensaje Mdmo a la aplicación mediantela opción Agregar biblioteca, página 29.

Puede enlazar el fragmento de tipo de mensaje solo con el modelo de objeto de contenido. En tiempode ejecución, el fragmento de tipo se puede adjuntar a una instancia del objeto automáticamente.



Los atributos del fragmento de tipo Aspecto de mensaje Mdmo se pueden configurar para Consultaen tiempo real, Consulta histórica y Consulta de texto completo. Los atributos también se puedenconfigurar para páginas de vista y de edición y para flujos de acción de importación.

Requisito previo

• InstaleMailApp.dar en Documentum Content Server antes de implementar cualquier aplicación.


Capítulo 5

Crear modelos de procesos



Tareas

Crear un modelo de proceso1. En el navegador de procesos, haga clic en Nuevo proceso.2. En el cuadro de diálogo Nuevo proceso, especifique las propiedades del modelo del proyecto


Campo Descripción

Etiqueta Escriba una etiqueta para el modelo de proceso.

El proceso puede ejecutarse en modosin estado

Seleccione la casilla de verificación El proceso puede ejecutarseen modo sin estado para permitir que se ejecute este modelo deproceso como un proceso sin estado en el tiempo de ejecución.

Proyecto Si la aplicación contiene proyectos, seleccione el proyecto al queestá agregando el modelo de proceso.

3. Seleccione Finalizar.

Configurar información general para el modelo deprocesoUtilice el cuadro de diálogo Propiedades de proceso para proporcionar información sobre el modelode proceso que vaya a crear. Esta configuración se aplica al proceso y los datos utilizados en dichoproceso.1. Haga clic en Propiedades de proceso.2. En la pestaña General, en el campo Descripción, escriba una descripción para el modelo de

proceso.3. En Instrucción de flujo de trabajo, escriba instrucciones para los ejecutores de las actividades.4. En Configuración de proceso, especifique la configuración para el proceso tal y como se describe




Campo Descripción

El proceso puede ejecutarse en modosin estado

Especifique si desea habilitar este modelo de proceso paraejecutarse como un proceso sin estado en tiempo de ejecución.

Almacenar el nombre de contenido enel paquete en el tiempo de ejecución

Especifique si desea que los nombres del contenido distribuidoestén disponibles para que los usuarios los vean.

De forma predefinida, el paquete distribuido a través de unproceso no incluye los nombres del contenido en el paquete pormotivos de seguridad. Seleccione esta opción para almacenar losnombres de contenido en el paquete y tener los nombres utilizadosen las instrucciones distribuidas a los participantes del proceso.

Eventos de proceso de auditoría Especifique si desea habilitar el evento de auditoría para loseventos del sistema.

5. En el área Notificaciones por correo electrónico predeterminadas, haga clic en Agregar eventopara definir las notificaciones por correo electrónico predeterminadas y la plantilla de correoelectrónico predeterminada para las actividades de proceso. Puede reemplazar estas notificacionespor correo electrónico predeterminadas en la configuración de actividades.

6. En la columna Evento, haga doble clic en la primera fila y seleccione un evento.7. En la columna Plantilla de correo electrónico, haga clic en la primera fila.

a. En el Asistente para plantilla de notificación, en el campo Plantilla de correo electrónico,haga clic en Seleccionar.

b. En el cuadro de diálogo Select Email Template (Seleccionar plantilla de correo electrónico),seleccione una plantilla de correo electrónico y haga clic en Finalizar.

c. En el área Vista previa, compruebe que la plantilla es correcta y haga clic en Siguiente.d. Complete las pantallas Asignación de mensaje de entrada y Asignación de mensaje de

salida tal y como se describe en Configurar una actividad Enviar correo electrónico , página141 y haga clic en Aceptar.

8. En la pestaña General, haga clic en Agregar evento para añadir las notificaciones de correoelectrónico predeterminadas.

9. Haga clic en Aceptar.

Crear variables de proceso1. Haga clic en Propiedades de proceso.2. En la pestaña Datos, seleccione el nodo Variables de proceso de la vista de árbol y haga clic en

Agregar.3. Configure la definición de variable tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre Escriba el nombre de la variable.

Tipo Seleccione un tipo de datos para la variable.

Valor único Seleccione si la variable tiene un único valor.

Por ejemplo, una variable Símbolo de valor de un proceso deIntercambio de stock podría ser una cadena.



Campo Descripción

Multivalor Seleccione si la variable contiene varios valores.

Por ejemplo, una variable Vecindarios para un proceso de ventas deinmobiliaria podría ser una lista de cadenas.

Valor predeterminado Para una variable de un solo valor, escriba un valor predeterminado,si lo desea.

Para hacer que una variable de proceso no sea visible, configúrela dentro de una actividad.

4. Para obtener una variable en un proceso sin estado, configure entradas y salidas de datos para laasignación de datos tal y como se define en la tabla siguiente:

Campo Descripción

No se usa para entradas ni salidas Seleccione esta opción para hacer que la variable no esté visible.

Se usa solamente para entrada Seleccione esta opción para usar la variable para las entradas dedatos.

Se usa solamente para salida Seleccione esta opción para usar la variable para las salidas dedatos.

5. Repita estos pasos para cada variable de proceso que agregue al modelo de proceso y haga clic enAceptar.

Si un proceso presenta un gran número de variables de proceso, sustituya estas por un únicopaquete de objeto de negocio a fin de mejorar el rendimiento.

Crear paquetes1. Haga clic en Propiedades de proceso.2. En la pestaña Datos, seleccione el nodo Paquetes nodo en la vista de árbol y haga clic en Agregar.3. Configure la definición del paquete tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre Escriba un nombre único para identificar el paquete.

Tipo Haga clic en Seleccionar, seleccione el tipo de objeto del paquete yhaga clic en Finalizar.

Versión Si selecciona un paquete de contenido, elija o escriba la opción deversión que desee usar en el proceso:

• Seleccione <Cualquiera> si se puede utilizar cualquier versióndel paquete.

• Escriba 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 contieneesa versión del contenido.

• Escriba una etiqueta de versión simbólica; por ejemplo, Borrador.Si escribe una etiqueta de versión, la etiqueta distingue entremayúsculas y minúsculas y debe coincidir con la versión delobjeto en el repositorio.



Campo Descripción

• Seleccione ACTUAL si desea que el paquete contenga la versiónetiquetada como ACTUAL, que suele ser la versión más actualdel objeto en el repositorio.

La versión especificada aparecerá como la versión predefinidautilizada por cada actividad que gestiona el paquete. Puede anularla versión al configurar la actividad.

Visible durante todo el proceso Define el paquete como visible para todas las actividades deproceso de negocio, asumiendo que el paquete fluye por todo elproceso. Una vez desactivada esta casilla, el paquete solo es visibleen las actividades a las que lo agregue de forma explícita.

Si selecciona un paquete que tiene una configuración de visibilidaddiferente tanto en el nivel global (Propiedades de proceso) comode actividades de proceso, esta opción no está disponible. Pararestablecer todas las actividades de modo que tengan el mismovalor, haga clic en el enlace Cambiar configuración de nivel deactividad y, en el cuadro de diálogo que aparece a continuación,haga clic en Sí.

Este es un paquete obligatorio Define el paquete según se requiera por el proceso.

Si selecciona un paquete que tiene una configuración de paqueteobligatorio diferente tanto en el nivel global (Propiedades deproceso) como de actividades de proceso, esta opción no estádisponible. Para restablecer todas las actividades de modoque tengan el mismo valor, haga clic en el enlace Cambiarconfiguración de nivel de actividad y, en el cuadro de diálogo queaparece a continuación, haga clic en Sí.

4. Repita estos pasos para cada paquete que agregue al modelo de proceso y haga clic en Aceptar.

Si un proceso presenta un gran número de variables de proceso, sustituya estas por un únicopaquete de objeto de negocio a fin de mejorar el rendimiento.

Agregar contenido a un proceso1. En el navegador Procesos, haga doble clic en el modelo de proceso para abrir el editor de modelo

de proceso.

2. Haga clic en Propiedades de proceso.

3. En la pestaña Datos, seleccione el nodo Paquetes nodo en la vista de árbol y haga clic en Agregar.

4. Configure la definición del paquete tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre Escriba un nombre para consultar el objeto decontenido en tiempo de ejecución.

Versión Si el objeto de contenido tiene una versión, seleccionela versión a la que se hace referencia mediante elpaquete.



Campo Descripción

Tipo Seleccione el modelo de contenido para establecer unenlace para el paquete.

Visible durante todo el proceso Seleccione esta opción para hacer que el paquete seavisible en todas las actividades. Puede anular estaselección en una configuración de actividad específica.

Este es un paquete obligatorio Seleccione esta opción para que se requiera que latarea tenga el paquete antes de iniciar la tarea. Puedeanular esta selección en una configuración de actividadespecífica.


Especificar los permisos de proceso1. Haga clic en Propiedades de proceso.

2. En la pestaña Avanzado, especifique los permisos de proceso, tal y como se describe en la tablasiguiente:

Campo Descripción

Limite quién puede iniciar esteproceso y edite las variables deproceso

Le permite restringir el número de usuarios finales que puedeiniciar un proceso y editar las variables de proceso en tiempode ejecución.

Conjunto de permisos Seleccione el conjunto de permisos que incluye los permisos deprocesos limitados y haga clic en Finalizar.


Seleccionar un calendario para el modelo de proceso1. Haga clic en Propiedades de proceso.

2. En la pestaña Avanzado, especifique el calendario predeterminado que se utilizará para todos loscálculos del temporizador de actividad tal y como se describe en la tabla siguiente:

Campo Descripción

Usar calendario estándar El sistema utiliza el calendario estándar para calcular la duracióndel temporizador. El calendario estándar se basa en el tiempoabsoluto. Éste es un calendario 24x7 sin vacaciones ni descansos.

Usar calendario empresarial específico El sistema utiliza un calendario empresarial especificado paracalcular la duración del temporizador. Un calendario empresarialincluye horas laborables y vacaciones.

Seleccione el calendario empresarial en los parámetros de laaplicación y haga clic en Finalizar.




Crear un conjunto de correlación1. Crear las variables de proceso para usarlas en el conjunto de correlación. No defina un valor

predeterminado para estas variables de proceso. Crear variables de proceso, página 98 proporcionainstrucciones para agregar las variables de proceso.

2. Haga clic en Propiedades de proceso.3. En la pestaña Avanzado, haga clic en Agregar conjunto de correlación.4. Para poner nombre al conjunto de correlación, haga clic con el botón derecho en el conjunto de

correlación, seleccione Editar nombre de conjunto, escriba una etiqueta y haga clic en Aceptar.5. Para agregar variables de proceso al conjunto de correlación:

a. Seleccione el conjunto de correlación y haga clic en Agregar conjunto de correlación porcada variable de proceso que desee incluir en el conjunto de correlación. Por ejemplo, paraagregar dos variables de proceso, haga clic en Agregar conjunto de correlación dos veces.

b. Para cada nueva cadena, haga clic con el botón derecho y seleccione Editar modelo decorrelación. En el cuadro de diálogo Correlación, seleccione una variable de proceso delárbol y haga clic en Aceptar.


Habilitar actividades de servicio web entranteSi el modelo de proceso contiene la actividad Iniciar desde servicio web o la actividad Esperar alservicio web, siga este procedimiento para especificar el indicador uniforme de recurso (URI) delespacio de nombre de destino para la ubicación del WSDL. Si hay varias actividades de servicio webdentro del modelo de proceso, utilizan el mismo espacio de nombres de destino.1. Haga clic en Propiedades de proceso y, a continuación, haga clic en Avanzado.2. En el campo URI del espacio de nombres de destino, escriba el espacio de nombres utilizado en

el WSDL.3. Haga clic en Aceptar.

Diseñar el modelo de proceso en el lienzoDiseñe el modelo de proceso mediante las siguientes acciones en el lienzo del editor de modelode proceso:

• Para agregar las actividades al lienzo: arrastre y suelte actividades predefinidas desde la paletaActividades al área de lienzo del editor de modelo de proceso.

• Para conectar las actividades con un flujo: seleccione la actividad, haga clic en un flujo de labarra de herramientas y arrastre el flujo de la actividad seleccionada a otra actividad.

• Para alinear actividades en el lienzo: seleccione las actividades que desea alinear. Aparece unalínea de color naranja alrededor de cada una de las actividades seleccionadas. Haga clic con elbotón derecho en las actividades, seleccione Alineación y, a continuación, seleccione el modo enque desea alinear las actividades. Por ejemplo, para alinear un grupo de actividades horizontalmenteen el centro de las actividades seleccionadas, haga clic Medio.

• Para agregar una actividad a un grupo: arrastre y suelte una actividad en un contenedor degrupo. Haga clic en Sí para confirmar.



• Para definir las propiedades de una actividad: haga doble clic en la actividad para acceder alInspector de actividad.

• Para definir las propiedades de un flujo: haga doble clic en el flujo para acceder al Inspector delflujo.

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

• Para realizar una acción en un objeto del modelo de proceso: haga clic con el botón secundarioen el objeto para tener acceso a un menú contextual con las acciones disponibles que incluyenCopiar, Pegar, Eliminar y Cambiar nombre. Si elimina una actividad enlazada a una página de tareao cambia su nombre, vuelva a enlazarla y resuelva manualmente cualquier expresión rota.

Note: no se pueden utilizar las combinaciones de teclas Ctrl+s (Guardar), Ctrl+c (Copiar) y Ctrl+v(Pegar) en el editor de modelos de proceso. Utilice los menús contextuales para copiar y pegar.Para guardar su trabajo, utilice el botón Guardar de la barra de herramientas de aplicación.

Configurar una actividad para adjuntar un fragmentode tipoUtilice esta actividad para adjuntar un fragmento de tipo con una instancia del objeto.1. Arrastre la actividad Adjuntar fragmento de tipo y suéltela en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestañaAdjuntar fragmento de tipo del Inspector de actividad, realice los siguientes pasos:

A Realice lo siguiente

Adjuntar unfragmento de tipo alpaquete de proceso

1. Seleccione un Paquete de proceso específico.

2. En el área Fragmentos de tipo, haga clic en Agregar.

El sistema solo muestra los fragmentos de tipo que se pueden seleccionar paraun paquete.

3. Seleccione un fragmento de tipo para enlazar al paquete.


En tiempo de ejecución, cuando el paquete de proceso está vacío y es de tipoObjeto de negocio o Contenido, se crea un objeto automáticamente y se anexan aél fragmentos de tipo. Sin embargo, si el paquete de proceso es de tipo Carpeta, laactividad arroja error dado que la carpeta no se puede crear sin el nombre de objeto.

Adjuntar unfragmento de tipoa un objeto

1. Seleccione los Objetos a los que hace referencia el ID de objeto.


El sistema muestra todos los fragmentos de tipo definidos en una aplicaciónde usuario final.

3. Seleccione un fragmento de tipo de la lista de fragmentos de tipo definidospara una aplicación.


En tiempo de ejecución, los fragmentos de tipo se adjuntan a una instancia deobjeto solo si se pueden seleccionar para el tipo de objeto.



4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.5. En la pestaña Adjuntar fragmento de tipo, asigne datos de proceso (Origen) de la actividad de

fragmento de tipo a los datos de proceso (Destino) de la actividad de fragmento de tipo.6. Si ha elegido la opción Objetos a los que hace referencia el ID de objeto, asigne el ID de objeto

de los objetos a los que desea adjuntar los fragmentos de tipo al atributo Elementos del áreaDestino. Si desea asignar varios objetos, haga clic en Agregar en el atributo Items para agregarmás valores de índice para el atributo de los elementos (por ejemplo, Items[1], Items[2] e Items[3]).Asigne un ID de objeto para cada valor de índice. En tiempo de ejecución, el fragmento de tiposeleccionado se asociará con las instancias del objeto.


Configurar una actividad para separar un fragmentode tipoUtilice esta actividad para separar un fragmento de tipo de la instancia del objeto.1. Arrastre la actividad Separar fragmento de tipo y suéltela en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Separar fragmento de tipo del Inspector de actividad, realice los siguientes

pasos según sea necesario:


Separar unfragmento de tipo delpaquete de proceso

1. Seleccione un Paquete de proceso específico.


El sistema solo muestra los fragmentos de tipo que se pueden seleccionarpara el paquete.

3. Seleccione un fragmento de tipo para separar del paquete.


Separar unfragmento de tipode un objeto

1. Seleccione los Objetos a los que hace referencia el ID de objeto.


El sistema muestra todos los fragmentos de tipo definidos en una aplicaciónde usuario final.

3. Seleccione un fragmento de tipo de la lista de fragmentos de tipo definidospara una aplicación.


5. Haga clic en Siguiente para mostrar la herramienta de asignación de datosde procesos.

6. Si ha elegido la opción Objetos a los que hace referencia el ID de objeto,asigne el ID de objeto de los objetos para los que desea separar los fragmentosde tipo del atributo Elementos del área Destino. Si desea asignar varios objetos,haga clic en Agregar en el atributo Items para agregar más valores de índicepara el atributo de los elementos (por ejemplo, Items[1], Items[2] e Items[3]).Asigne un ID de objeto para cada valor de índice. En tiempo de ejecución, elfragmento de tipo seleccionado se separa de la instancia del objeto.




Depurar un proceso1. Si depura un proceso que está configurado con un punto final o que utiliza cualquiera de los tipos

de objeto como un paquete o parámetro de aplicación, implemente la aplicación antes de comenzara depurar el proceso.

2. Abra el proceso en el editor de modelos de proceso.

3. Seleccione una actividad para agregar un punto de interrupción y haga clic en Toggle Breakpointon selected activity.

4. Haga clic en Proceso de depuración.

5. En el cuadro de diálogo Inicio de sesión del depurador, seleccione un entorno de tiempo dediseño. En el área Detalles del entorno, el sistema rellena todos los campos configurados en elentorno de tiempo de diseño seleccionado. Haga clic en Aceptar.

6. Si el flujo de trabajo del proceso comienza con una actividad manual:

a. En el cuadro de diálogo Depuración de procesos, haga clic en la actividad Iniciar flujo detrabajo con inicio manual.

b. Para agregar un paquete al flujo de trabajo, haga clic en Adjuntar y seleccione un objetodel repositorio.

Puede hacer doble clic en un atributo para editar el valor del atributo.

c. Para editar el valor de una variable, expanda el nodo Variables, haga clic con el botónsecundario y seleccione Editar valor. Puede definir varios valores como valores separadospor comas.

d. Para agregar un anexo a petición al flujo de trabajo, haga clic Adjuntar y seleccione un objeto.

e. Haga clic Iniciar flujo de trabajo y vaya al paso 9.

7. Si el flujo de trabajo del proceso comienza con una actividad de entrada:

a. En el cuadro de diálogo Proceso de depuración, haga clic en la actividad Iniciar un flujo detrabajo usando inicio entrante.

b. Haga clic en Iniciar escuchas para comenzar el proceso de depuración.

El depurador de procesos comienza la escucha de la solicitud de inicio del mensaje específicadel protocolo de la actividad entrante. El flujo de trabajo comienza cuando el proceso recibeel mensaje correspondiente. Vaya al paso 9.

8. En la ventana Proceso de depuración, realice los siguientes pasos según sea necesario:


Ejecute una actividad manual Haga clic en Administrador de tareas y adquiera,rechace o finalice una tarea.




Ejecutar una actividad automática 1. Haga clic Administrador de tareas para verlos mensajes de entrada y salida específicos delprotocolo y las excepciones que se produzcan.

Los mensajes de error se ven en el cuadro detexto Excepción de la pestaña Administradorde tareas.

2. Para editar las propiedades de una actividad,haga clic en Inspector de actividad.

3. Para completar una actividad que tiene errores,que no puede corregir, haga clic en Obligar acompletar la tarea.

Agregar paquetes y anexos y editar atributos yvariables de paquete

1. Haga clic en Datos de proceso.

2. Haga clic con el botón secundario en unos datosde proceso y seleccione Editar valor.

3. Haga clic Actualizar para obtener los últimosvalores.

Ver mensajes de registro para la ejecución del flujode trabajo y de temporizadores, desencadenadores ynotificaciones por correo electrónico

Haga clic en Consola para solucionar problemasde un proceso.

Enviar un evento de desencadenador 1. Haga clic Administrar flujo de trabajo.

2. Escriba un nombre de señal en el campo Enviarflujo de trabajo de evento.

3. Haga clic en Enviar.

Mover a la siguiente actividad Haga clic en Pasar a la siguiente actividad.

Ver detalles de una actividad y realizar las funcionesde solución de problemas

Haga clic en Pasar a la ejecución de la actividadactual.

Pasar a la siguiente actividad marcada con un puntode interrupción

Haga clic en Continuar al siguiente punto deinterrupción.

Iniciar de nuevo el proceso de depuración desde elprincipio del flujo

Haga clic en Volver a ejecutar la depuración.

9. Después de depurar el proceso, seleccione cada actividad marcada con un punto de interrupción yhaga clic en Toggle Breakpoint on selected activity para quitar un punto de interrupción.

Crear una versión del proceso1. Abra un proceso en el editor de modelos de proceso.2. Haga clic con el botón secundario en el nodo raíz del proceso y seleccione Crear versión.3. En el cuadro de diálogo Nueva versión (proceso), especifique información tal y como se describe

en la siguiente tabla:

Campo Descripción

Etiqueta Especifique una etiqueta para la nueva versión del proceso.



Campo Descripción

Versión menor Seleccione la versión menor para un proceso. Por ejemplo, v1.1.

Versión mayor Seleccione la versión mayor para un proceso. Por ejemplo, v2.0.

Descripción Escriba una descripción para la versión del proceso.


El proceso versionado hereda la lógica empresarial, los datos de proceso y todas las páginasasociadas con un proceso. Estas páginas incluyen una página de inicio y las páginas específicasde tareas, que se heredan del proceso original.

Conceptos

Definir un modelo de proceso de negocio

Un modelo de proceso toma la definición de un proceso de negocio, lo que permite a los usuariosejecutar el proceso repetidamente. Por ejemplo, un modelo para el procesamiento de préstamoshipotecarios podría enrutar una aplicación desde el solicitante del préstamo al creador del préstamoy al procesador del préstamo. Puesto que el modelo de proceso es independiente a la creación deinstancias en tiempo de ejecución, es posible ejecutar varios procesos basados en el mismo modelo deproceso a la vez.

Un modelo de proceso representa el proceso de negocio a través del que fluye un determinadoobjeto determinado o conjunto de objetos. Consta de las actividades (realizadas por personas o porel sistema), la selección del ejecutor, los datos de la ruta y las condiciones de transición basadas enlos datos de negocio.

Cada vez que cree un modelo de proceso, toma decisiones de diseño, como los tipos de datos de procesoque se van a utilizar, las actividades que se van a incluir y cómo estructurar el modelo de proceso.

La definición de un modelo de proceso normalmente incluye las siguientes tareas:

• Planifique el modelo de proceso.

• Cree el modelo de proceso.

• Establezca las propiedades del modelo de proceso.

– Agregue variables de proceso.

– Agregue paquetes para incluir contenido tales como objetos de negocio, objetos de contenidoy carpetas.

• Crear puntos finales para conectar con sistemas externos.

• Agregue actividades manuales o del sistema al editor de modelo de proceso.

• Conecte las actividades con flujos.

• Defina las propiedades de actividades y flujos, incluyendo la asignación de datos.



Editor de modelos de procesoEl editor de modelos de proceso es el área donde se diseña el modelo de proceso. Para definir unproceso comercial, puede arrastrar y soltar actividades predefinidas desde la paleta Actividades al áreadel lienzo del editor de modelo de proceso. Puede conectar las actividades con flujos y, a continuación,definir las propiedades de las actividades y flujos.

ProcesosUn proceso es una instancia de un modelo de proceso en tiempo de ejecución. Varios procesos basadosen el mismo modelo pueden ejecutarse a la vez dado que el modelo de proceso es independientede ejemplificación en tiempo de ejecución. Puede utilizar un modelo de proceso ya hecho o crearel suyo propio.

Un proceso incluye los siguientes elementos:

• Actividades: representan tareas dentro de un proceso de negocio. Por ejemplo, estas tareaspueden incluir el envío o la recepción de un mensaje, la revisión o la aprobación de contenido y lacomprobación de un archivo en un repositorio.

• Flujos de trabajo: conecte actividades dentro del proceso y orqueste la lógica de negocio.• Datos de proceso: se refieren a los distintos tipos de datos que fluyen por el proceso. Los dos tiposprincipales de datos de proceso que se pueden definir en un modelo de proceso son las variables deproceso y los paquetes de proceso.

Datos de procesoLos datos de proceso hacen referencia a los datos que fluyen a través del proceso en tiempo deejecución. Los datos de proceso están formados de varios tipos de datos:

• Paquetes: los paquetes hacen referencia a un objeto de negocio, contenido y datos de carpeta.El paquete incluye el objeto y su contenido y atributos asociados. Los paquetes son objetos delrepositorio que se conservan después de la ejecución del proceso. Las actividades funcionan en estospaquetes y, a continuación, se pasan a otras actividades. Por ejemplo, un proceso puede conteneruna aplicación de préstamos dentro de un paquete.

• Variables de proceso: las variables de proceso almacenan datos transitorios, lo que el sistema ya nonecesita cuando finaliza el proceso. Por ejemplo, puede crear variables de proceso para númerosde piezas y direcciones de clientes.

• Parámetros de aplicación: los parámetros de aplicación contienen valores predeterminadosdefinidos en el nivel de aplicación. Todos los procesos en la aplicación pueden tener accesoa estos valores.

• Datos de ejecución: los datos de ejecución proceden del proceso actual y los elementos de trabajo,como la fecha de creación del proceso y el estado de tiempo de ejecución del elemento de trabajo.El sistema descarta esta información cuando el proceso finaliza.

• Anexos: los anexos son objetos, como los objetos de negocio y objetos de contenido, que unusuario final adjunta a un proceso o a un elemento de trabajo incompleto. Por ejemplo, un procesoadministra propuestas de ingeniería en desarrollo. Un usuario final puede adjuntar un documento deinvestigación en papel para apoyar una propuesta. Los anexos se pueden agregar en cualquier punto



del proceso y se pueden eliminar cuando ya no se necesiten. Después de agregar un anexo, esta seencuentra disponible para los ejecutores de todas las actividades posteriores.

Los datos de proceso permiten a los usuarios finales ver datos de negocio significativos al visualizarsu lista de tareas. Por ejemplo, un usuario final puede ver el nombre de un solicitante, el estado deaprobación de una solicitud y el importe del préstamo. Esta información permite que el ejecutante deuna tarea trabaje de manera más eficiente en las tareas de su bandeja de entrada.

Son configurables los paquetes de proceso, las variables de proceso y los parámetros de aplicación.Se definen paquetes de proceso y variables en el nivel de proceso y se utilizan en las actividadesindividuales dentro de un proceso. Se configuran parámetros de aplicación en el nivel de aplicación,que permiten a los administradores de la aplicación configurarlos en tiempo de ejecución.

Variables de proceso

Las variables de proceso son instancias de datos que circulan por el proceso comercial. Por ejemplo,puede crear una variable de proceso aprobada como un valor booleano, y utilizarla en una transiciónpara determinar flujo de proceso. El valor de aprobada se puede actualizar en una actividad anterior.

Las variables de proceso, que se crean al crear este, se conservan a lo largo del ciclo de vida delproceso. Si ha configurado las variables de proceso para que presenten valores predeterminados, elsistema asigna estos valores. Una vez finalizado el proceso, el sistema elimina de forma permanentelos valores de las variables de proceso.

Una variable de proceso puede ser un valor único o una variable multivalor, y su tipo de datos se debeespecificar como Cadena, Entero, Flotante, Booleano o Fecha-hora.

Paquetes de proceso

Los paquetes son marcadores de posición para el objeto de negocio real, el contenido y los datos decarpeta que se ejecutan a través de un proceso en tiempo de ejecución. Los paquetes se puede enlazara los objetos de negocio existentes, objetos de contenido y objetos de carpeta que aparecen en elnavegador de modelos de objeto. El paquete hace referencia al objeto y su contenido y atributosasociados. Los objetos de contenido tienen contenido, pero los objetos de negocio no. Una vez que elpaquete se enlaza, las actividades pueden utilizar el contenido y los atributos de los paquetes. Porejemplo, en una aplicación de procesamiento de reclamaciones, un proceso de aprobación empiezacuando se crea una reclamación. El paquete está enlazado a un objeto de negocio de cliente, lo quesignifica que hace referencia al objeto de negocio de cliente y sus atributos asociados. Las actividadesmanuales en el proceso pueden utilizar ese paquete para mostrar información del cliente para elaprobador.

Los paquetes se pueden configurar en las propiedades del modelo de proceso y se consideran datosde proceso. En una actividad, puede:

• Hacer referencia a un objeto y asociarlo a un paquete

• Actualizar los atributos de un paquete

• Actualizar el contenido de un paquete



Limitar los permisos de proceso del usuario finalLos permisos de proceso determinan las acciones de proceso posibles para un usuario final o un grupoen tiempo de ejecución. Por ejemplo, para que un usuario final pueda trabajar en una tarea de proceso,el usuario final debe tener al menos el nivel de permiso Examinar.

La tabla siguiente describe las acciones de proceso de usuario final y los niveles de permiso necesariospara completar las acciones:

Acción Nivel de permiso mínimo

Trabajar en una tarea para un proceso Examinar

Iniciar un proceso Revisión

Editar una variable de proceso Editar

En tiempo de ejecución, cualquier usuario puede iniciar un proceso y editar las variables de proceso deforma predeterminada. Si los procesos de negocios exigen que limite los permisos de proceso, puedecrear un conjunto de permisos para restringirlos. A continuación, puede especificar este conjunto depermisos en las propiedades del modelo de proceso.

No puede limitar los permisos del supervisor del flujo de trabajo, el creador del proceso y el propietariodel repositorio.

La figura siguiente muestra un conjunto de permisos de ejemplo que restringe los permisos de proceso:

En este ejemplo, el administrador puede iniciar un proceso y editar variables de proceso. El procesadorpuede iniciar un proceso y leer las variables de proceso. El mantenimiento de Office no puede iniciarun proceso y no se pueden ver los valores de las variables de proceso.

Procesos sin estadoUn proceso sin estado se ejecuta de forma sincrónica como una sola transacción en cada sesión deusuario. Lo ejecuta el usuario que ha iniciado la sesión en la aplicación y no el ejecutor configuradoen cualquier actividad. La transacción síncrona se realiza solo al final del proceso. Si se produce unerror durante el proceso, todo el proceso falla.

Puede ejecutar un proceso sin estado de las siguientes formas:

• Como una actividad en un proceso• Como un servicio de datos ya sea desde una página o una interfaz de usuario externo• Desde un evento de negocio



• Desde una actividad de temporizador

Si ejecuta un proceso sin estado como un servicio de datos, puede configurar las entradas y salidas delos datos del proceso en las propiedades del modelo del proceso. Un proceso sin estado utiliza paquetesde proceso y variables de proceso tanto para las entradas como para las salidas de datos. Las variablesde proceso de un proceso sin estado pueden tener una combinación de variables de uno y varios valores.

Puede utilizar cualquier combinación de paquetes de proceso y variables de proceso para las entradasy salidas de datos. Puede definir los mensajes personalizados de operación correcta o de operaciónincorrecta, aunque el generador de expresiones no sea compatible. De forma predeterminada, elsistema localiza estos mensajes personalizados según la configuración regional de xCP Designer y ladisponibilidad del paquete de idiomas de xCP Designer en la configuración regional.

Puede configurar la visibilidad de un paquete de proceso y de una variable de proceso. Por ejemplo,una variable que se utiliza solo para la lógica transicional puede estar configurada como no visible.

Puede crear páginas de interfaz de usuario que utilicen los datos de procesos sin estado. Defina lasentradas de datos de la página cuando agregue una instancia de servicio de datos de proceso sin estado ala página. Las salidas de datos se definen en la vista Propiedades del widget seleccionado en la página.

Cuando se utilizan entradas de variables de proceso para actualizar o crear un objeto, la prácticarecomendada es asegurarse de que los nombres de la variable de proceso y del sistema de atributoscoincidan. Esto resulta útil para mostrar mensajes de error significativos asociados con el campoespecífico que tiene problemas.

Puede ejecutar un proceso sin estado desde un evento de negocio si configura un evento de negocio delmodelo de objeto para que inicie dicho proceso.

Si un objeto tiene un evento de negocio que inicia un proceso sin estado para modificar ese mismoobjeto, este puede desencadenar eventos en un bucle infinito. Como práctica recomendada en estasituación, asegúrese de realizar las siguientes modificaciones en el evento de negocio:

• Configure el evento de negocio para que inicie un proceso con estado en lugar de uno sin estado.

• Agregue una condición en el evento de negocio para impedir que se produzca un bucle infinito.

Ventajas y limitaciones de procesos sin estado

El proceso sin estado se ejecuta en la memoria y proporciona las siguientes ventajas:

• Mejora el rendimiento ya que el proceso sin estado se ejecuta en un hilo y en una sesión.

• Le permite usar las salidas del proceso sin estado.

El proceso sin estado devuelve user_login_name para los atributos Execution Data.workflow.supervisory Execution Data.task.performer.

Las siguientes limitaciones se aplican a los procesos sin estado:

• Los procesos sin estado se ejecutan en una transacción y en un hilo. Aunque la ejecución de unproceso en una transacción mejora el rendimiento, también aumenta el alcance de la transacción encomparación con un proceso normal. Si otro proceso normal o sin estado modifica el mismo conjuntode objetos, puede haber más errores de no coincidencia de versiones dado el aumento del alcance.

• Un modelo de proceso habilitado para ejecutarse en modo sin estado puede ejecutarse en estemodo o en uno con estado en tiempo de ejecución. Los procesos que se ejecutan en un modosin estado no generan eventos de negocio relacionados con el proceso. Sin embargo, sí generan



eventos de negocio definidos en los objetos (objetos de negocio, carpetas, o bien contenido) queel proceso crea o actualiza.

• El ejecutor del proceso sin estado ejecuta todas las actividades de proceso sin estado. Anula elejecutor configurado en la pestaña Ejecución de las actividades del sistema.

• Un proceso sin estado no puede tener actividades manuales, configuraciones de temporizador en lasactividades, actividades entrantes Iniciar desde o Esperar a, o condiciones de desencadenamiento (oeventos) en las actividades.

Enlazar procesos sin estado con los widgets

Puede enlazar las salidas de los procesos sin estado a varios widgets. La siguiente tabla describelos diferentes casos de uso:

Salidas de los procesos sin estadoWidget Caso de uso

Todos de un solo valor Todos de variosvalores

Salida mixta

Todos los widgets Cualquierexpresión queespere un valorúnico.Por ejemplo, elvalor inicial detodos los widgetscon un solo valorde entrada.

Sí Sí [1] Sí [1]

Todos los widgets Cualquierexpresión queespere más de unvalor.Por ejemplo, elvalor inicial detodos los widgetscon más de unvalor de entrada.

Sí [2] Sí Sí [2]


Enlazar serviciode datos

Sí [3] Sí Sí [4]

Gráfico de barras,gráfico de columnas,gráfico indicador ygráfico circular

Enlazar serviciode datos

Sí [3] Sí Sí [4]



Salidas de los procesos sin estadoWidget Caso de uso

Todos de un solo valor Todos de variosvalores

Salida mixta

NotaSi configura un proceso sin estado que devuelve un tipo de salida de un solo valor, deberá utilizarsolo el gráfico indicador.

• [1] Como el valor esperado es del tipo de un solo valor, si desea enlazar la salida de varios valores, deberáproporcionar un número de índice en la matriz, o bien utilizar una función para derivar un solo valorfuera de la matriz.

• [2] Como el valor esperado es del tipo de varios valores, si desea enlazar una salida de un solo valor, deberáencerrarla entre llaves para convertirla en una matriz.

• [3] Al utilizar todas las salidas de un solo valor como el origen de datos, se trata como una colección deun único registro.

• [4] Al utilizar la salida mixta como el origen de datos, el número de registros en la colección es igual a lalongitud máxima entre todas las salidas de varios valores. Para las salidas de un solo valor, el valor se repiteen todas las filas. En cambio, para las salidas de varios valores que tienen menor número de elementos queel número máximo, los registros restantes se rellenan con nulo. Por ejemplo, si hay 3 salidas (2 de variosvalores y 1 de un solo valor) con valores como:

out_m1 [A, B, C, D]

out_m2 [X, Y, Z]

out_s1 P

los registros generados serán:

Rec# out_m1 out_m2 out_s1

1 A X P

2 B A P

3 C Z P

4 D P

Enlazar procesos sin estado con las listas de resultados

Al utilizar un proceso sin estado para obtener una lista de objetos del repositorio, el número de objetosobtenidos por la actividad Lectura de DQL está limitado a 1,000. Esta restricción sirve para optimizarel rendimiento y, por lo tanto, se evitarán los problemas de memoria. Se recomienda proporcionar unfiltro adecuado (sugerencia de "comienza por") o una paginación en la instrucción de DQL.

Paginación: al utilizar un proceso sin estado para obtener una lista de objetos del repositorio y mostraresta lista en un widget de lista de resultados, se requieren algunos pasos de configuración adicionalespara obtener resultados paginados:

1. Cree un proceso sin estado con variables de proceso de entero: inicio, límite y página.2. Agregue variables de salida para todo lo que se devuelva de la instrucción DQL.3. Agregue la actividad Leer desde el repositorio al proceso y configure un punto final de repositorio.



4. En el área Consulta para ejecutar, escriba la consulta DQL que desea realizar para obtener losobjetos del repositorio.

5. Agregue la sugerencia RETURN_RANGE DQL a la consulta para permitir la paginación e incluyatres parámetros. Por ejemplo, select user_name from dm_user ENABLE(RETURN_RANGE? ? ? ’user_name ASC’).

6. En la pantalla Asignación de mensaje de entrada, asigne variables de proceso a los parámetros dela manera siguiente:

a. param1= inicio +1b. param2= inicio+límitec. param3= límitedonde:start+1 especifica a partir de qué número de fila se devuelven de las filas aplicables.start+limit especifica el número de filas finales que se devuelven de las filas aplicables.limit especifica el número de filas superiores que se optimizarán mediante el optimizador de basede datos.

7. En la pantalla Asignación de mensaje de salida, asigne valores devueltos a las variables de salida.

Clasificación: al utilizar un proceso sin estado para obtener una lista de objetos del repositorio ymostrar esta lista en un widget de lista de resultados, se requieren algunos pasos de configuraciónadicionales para obtener resultados paginados:

1. Agregue estas variables de procesos de entrada al proceso sin estado:

Tipo Nombre de

variable

Valor predeterminado

Cadena sortcol Cualquier columna que desea ordenar de forma predeterminada porprimera vez.

Cadena sortord Decide el orden de clasificación. ASC para ordenar la lista en ordenascendente y DESC para ordenar la lista en orden descendente.

2. Para cada salida de columna de la consulta DQL, agregue una variable de proceso de repeticióncon el mismo nombre de columna.

3. Agregue la actividad Leer desde el repositorio al proceso y configure un punto final de repositorio.4. En el área Consulta para ejecutar, escriba la consulta DQL que desea realizar para obtener los

objetos del repositorio.5. Agregue la sugerencia ORDER BY o RETURN_RANGE DQL a la consulta para admitir la

clasificación. Por ejemplo,select r_object_id, user_name from dm_user ENABLE(RETURN_RANGE ? ? ??, RETURN_TOP ?, OBJECT_BASED)

select user_name from dm_user ORDER BY ?

6. En la pantalla Asignación de mensaje de entrada, asigne las variables de proceso a los parámetroscorrespondientes de la columna de clasificación y del orden de clasificación:

a. param1= inicio +1b. param2= inicio+límitec. param3= límited. param4= concat (sortcol + <espacio en blanco> + sortord)



donde:inicio+1 especifica a partir de qué número de fila se devuelven de las filas aplicables.inicio+límite especifica el número de filas finales que se devuelven de las filas aplicables.límite especifica el número de filas superiores que se optimizarán mediante el optimizador debase de datos.concat (sortcol + <espacio en blanco> + sortord) especifica la columna y el orden en que semuestran los resultados ya organizados.

7. En la pantalla Asignación de mensaje de salida, asigne valores devueltos a las variables de salida.

Recuento de visitas: para el número de filas devueltas de un proceso sin estado, el métodorecomendado consiste en ejecutar la consulta DQL sin paginación. Es necesario entender cómoafecta al rendimiento cuando se vuelve a ejecutar la consulta si el recuento no se puede adaptar auna sola consulta.

Para obtener el recuento de visitas, puede definir una variable de proceso de salida de enteros paraobtener el número de filas seleccionadas. En la lista de resultados, utilice la variable de salida definidapara mostrar el número de filas.Nota: En xCP 2.0, es posible obtener el menú contextual para un proceso sin estado en una lista deresultados, si el proceso tiene la variable de salida denominada "id", que contiene el ID de objeto, y"r_object_type", que contiene el tipo de objeto. Esta característica dejó de funcionar en la versión 2.1.Para que funcione, asegúrese ahora de que la variable de salida "id" devuelva el URI del objeto delformulario "business-objects/ [r_object_type] / [r_object_id]" en lugar del ID de objeto solamente.(Cambie "business-objects" por "contents" o "folders" según sea necesario).

Correlación de mensajesCuando el sistema recibe un mensaje entrante, tiene que poder distribuirlo al proceso correcto paragestionar los datos entrantes. El sistema utiliza los identificadores de correlación y conjuntos decorrelación que contienen datos únicos para hacer coincidir la respuesta entrante con la solicitudoriginal.

Por ejemplo, en un proceso de compra, una actividad envía un mensaje de JMS a una solicitud deproveedor enviando información de un elemento de un pedido de compra. El mensaje especifica elnúmero de ID del proveedor y el número de pedido, lo que el sistema utiliza para que coincida elmensaje con el proceso. El sistema del proveedor responde más adelante con un mensaje de estado deenvío, que incluye el número de ID del proveedor y el número de pedido. Cuando estos atributos dedatos únicos se asignan a las variables de conjunto de correlación correspondientes, el sistema puedehacer coincidir la solicitud con la respuesta y continuar el proceso.

En las actividades de espera, puede usar un ID de correlación, un conjunto de correlación o ambos. Siun ID de correlación no está disponible, el sistema busca una asignación de conjunto de correlaciónpara hacer que coincida el mensaje entrante con el proceso.

Identificadores de correlaciónLos identificadores de correlación son valores de datos únicos que se utilizan para que coincidan conlos mensajes entrantes para el proceso correcto. El sistema crea un ID de correlación único paraidentificar cada proceso. Cuando actividad de espera recibe este identificador en un mensaje, puedehacer coincidir el mensaje con el proceso adecuado sin utilizar un conjunto de correlación.



La tabla siguiente describe dónde encontrar el ID de correlación en el mensaje entrante:

Actividad Ubicación de ID de correlación

Esperar al correo electrónico Encabezado de correo electrónico

Esperar a FTP Nombre de archivo o directorio

Esperar a HTTP Parámetro de secuencia de consulta

Esperar a JMS Parámetro correlationid de encabezado de JMS

Esperar al servicio web Encabezado SOAP

Esperar a la base de datos Una columna de los datos devueltos para la actividad

Esperar al repositorio Un atributo de objeto devuelto para la actividad

Conjuntos de correlaciónLos conjuntos de correlación son conjuntos de variables de proceso cuyos valores identificanexclusivamente un mensaje entrante de un proceso concreto.

Los conjuntos de correlación se definen en el nivel de modelo de proceso y, a continuación, se utilizanen las actividades. Por ejemplo, un conjunto de correlación con el nombre Transacciones bancariasconsta de variables de proceso para el número de transacción y el número de enrutamiento bancario. Siel proceso recibe información bancaria en las solicitudes HTTP, una actividad Esperar a HTTP podríarecibir la solicitud. Al configurar la actividad, asigna los atributos de mensaje entrante a las variablesde proceso correspondientes en el conjunto de correlación. En tiempo de ejecución, el sistema utilizael conjunto de correlación para distribuir los mensajes entrantes para el proceso correcto.

Puede seleccionar solo un conjunto de correlación para la asignación dentro de una actividad. Losvalores de datos del conjunto de correlación deben existir o establecerse antes de que el procesoalcance la actividad que utiliza el conjunto de correlación.

Un conjunto de correlación puede incluir más de una variable de proceso y un proceso puede utilizarvarios conjuntos de correlación a través de varias actividades.

Depurador de procesosPuede probar el diseño de un modelo de proceso y detectar y diagnosticar errores antes de implementarel proceso en un entorno de producción. Depurar el proceso le ahorra tiempo porque puede solucionarproblemas durante la fase de diseño de una aplicación de usuario final, en lugar de hacerlo en tiempode ejecución.

Cuando se depura un proceso, puede agregar un punto de interrupción a cualquier actividad en elproceso. El punto de interrupción le permite interactuar con una actividad en el proceso. El depuradorde procesos se detiene en cada punto de interrupción, de modo que puede comprobar o modificar laspropiedades de un proceso antes de ejecutarlo. Por ejemplo, un punto de interrupción le permitemodificar los datos de proceso, lo que le permite finalizar, rechazar o completar la actividad antes deejecutar una actividad manual. El punto de interrupción también muestra los mensajes de entrada,salida, y excepción asociados con una actividad automática. Puede agregar puntos de interrupciónpara cualquier actividad manual o automática.



Debe depurar el modelo de proceso en un entorno local. Al depurar el proceso, el sistema no creaelementos de trabajo reales o elementos de cola dentro de un repositorio. Sin embargo, el sistemaguarda los cambios realizados en los objetos a los que se hace referencia como un paquete o un adjuntodurante la sesión de depuración y sobrescribe los datos de atributo existentes. El sistema desencadenatodos los eventos de negocio asociados con tales objetos mientras se depura el proceso. El sistematambién crea cualquier objeto necesario para las actividades automáticas dentro del proceso, como lascopias o los adjuntos creados mediante las reglas de asignación.

Al depurar un proceso que tiene actividades Iniciar desde o Esperar a, debe detener los bps. Alimplementar una aplicación, los bps que se ejecutan en el servidor de aplicaciones inician la escuchade las actividades Iniciar desde y Esperar a. La escucha que se ejecuta en los bps puede consumirtodos los mensajes, y no la escucha que se ejecuta en el depurador.

El depurador de procesos tiene estas limitaciones:

• Si el ejecutor se establece según las condiciones, el ejecutor no se resuelve desde el depuradorde procesos. Esto ocurre porque la notificación de correo electrónico no pasa por el depuradorde procesos, incluso aunque el ejecutor se haya resuelto correctamente y se haya completado laejecución.

• El temporizador caduca después de que transcurra el tiempo configurado, incluso si el día actual estámarcado como un día festivo en un calendario laboral y el calendario se utiliza en el temporizador.La configuración del calendario laboral en el temporizador no es compatible en el depurador deprocesos.

• Al depurar un proceso, los atributos del fragmento de tipo y los objetos relacionados no se muestranpara los paquetes de la pestaña Datos de proceso en el depurador de procesos.

Creación de versiones de proceso

Una versión es una copia de un proceso existente y es diferente del proceso original. La versión de unproceso consta de un conjunto dedicado de páginas y servicios de datos.

Puede crear nuevas versiones de un proceso, de modo que varias versiones del mismo proceso puedencoexistir en tiempo de ejecución. Al crear una versión de un proceso, el sistema duplica solo las páginasdedicadas que incluyen la página de inicio del proceso y todas las páginas de tareas. Las páginasdedicadas, las variables de proceso y los paquetes del proceso adquieren la versión de la versión delproceso. En tiempo de ejecución, al crear una instancia de un proceso, puede elegir cualquier versióndel proceso para crear una instancia. Por ejemplo, suponga que ha diseñado un modelo de préstamospara procesar préstamos de clientes. Ahora, el gobierno ha introducido una nueva regulación queafecta a su modelo de préstamo. Para cambiar el flujo de proceso en el modelo de préstamo, puedecrear una versión del proceso existente y agregar una nueva actividad que cumpla la regulación reciénintroducida, al tiempo que se mantienen intactos los datos de proceso y la lógica empresarial existentes.Mediante este mecanismo, no es necesario detener o cerrar las instancias del proceso original.

Puede modificar un proceso una vez que el sistema ha creado una versión de dicho proceso.

Si se define un proceso en un proyecto y se crean páginas en la aplicación, al versionar el proceso,las páginas no se duplican.

Utilice con cuidado el control de versiones para los procesos para evitar que se produzcan incoherenciasen los datos de proceso. Se recomienda crear versiones de proceso mientras se implementa un proceso



en el entorno de producción dado que crear diferentes versiones de un proceso puede dar lugar a ladesincronización de los datos de proceso.Nota: Como práctica recomendada, se recomienda cambiar el proceso solo mediante la creación deversiones de proceso. De lo contrario, el sistema interrumpe el contacto entre el proceso y la instanciaen ejecución y esto puede causar fallos en las instancias en ejecución.


Capítulo 6

Trabajar con actividades de proceso


• Tareas: actividades manuales• Tareas: actividades del sistema• Conceptos

Tareas: actividades manuales

Configurar tareas de actividades manuales

Utilice este procedimiento para configurar las tareas de colas de trabajos y manuales que crean losprocesos en tiempo de ejecución.

1. Arrastre y suelte una actividad manual (actividad Tarea manual o actividad Tarea de colade trabajos) en el lienzo.

2. Haga doble clic en la actividad para abrir el Inspector de actividad.

3. En la pestaña Tarea, configure la tarea como se describe en la tabla siguiente:

Campo Descripción

Asunto Escriba un nombre para la tarea. Para incluir los datos de proceso,seleccione un parámetro para el asunto y haga clic en Aceptar.Cuando la tarea se crean en tiempo de ejecución, los datos deproceso se sustituyen por el valor para los datos de proceso.

Instrucciones Escriba las instrucciones para el ejecutor de tarea. Para incluir losdatos de proceso, seleccione un parámetro para las instruccionesde la tarea y haga clic en Aceptar. Cuando la tarea se crean entiempo de ejecución, los datos de proceso se sustituyen por elvalor para los datos de proceso.



Campo Descripción

Prioridad Seleccione una prioridad para la tarea.

Para las actividades Tarea manual, los procesadores puedenutilizar esta prioridad para priorizar sus tareas.

Para actividades Tarea de cola de trabajos, el sistema evalúala prioridad para distribuir tareas a los usuarios finales. Losadministradores de colas también pueden usar esta prioridad paradistribuir tareas.

Para asociar un módulo de prioridad personalizado a una tareade cola de trabajos, seleccione Dinámica.

Módulo de prioridad Si selecciona Dinámica como prioridad de una tarea de cola detrabajos, elija el módulo de prioridad que se va a utilizar para lalógica de prioridad y caducidad.


Configurar los ejecutores de una actividad manual1. Arrastre y suelte la actividad Tarea manual en el lienzo.


3. En la pestaña Ejecutor, en el área Elegir ejecutores, elija si desea seleccionar los ejecutores deuna lista o en función de una condición.

4. Para seleccionar un ejecutor de una lista, en el área Lista de ejecutores, haga clic en Agregar.

a. Para seleccionar un ejecutor individual, en el cuadro de diálogo Seleccionar ejecutor,seleccione el ejecutor individual de la lista y haga clic en Finalizar.

b. Para seleccionar otros ejecutores, en Determinar qué ejecutor de tarea se va a utilizar, página173 se proporcionan detalles adicionales y vínculos a procedimientos de selección de ejecutores.

c. Para ordenar los ejecutores en la lista de ejecutores para la distribución de tareas, haga clic enSubir y Bajar.

5. Para definir las condiciones para una lista de ejecutores, en el área Ejecutores condicionales,haga clic en Editar.

a. En el cuadro de diálogo Editar regla, en el área de condición IF, haga clic en Seleccionar paraacceder al editor de expresiones y agregar una condición IF.

b. En el área A continuación, lista de ejecutores, haga clic en Agregar para agregar losejecutores que se aplican a esa regla. Determinar qué ejecutor de tarea se va a utilizar, página173 proporciona detalles adicionales y vínculos a procedimientos de selección de ejecutores. ElEjecutor de la actividad anterior no está disponible para su uso como un ejecutor condicional.

c. Para ordenar los ejecutores en la lista de ejecutores para la distribución de tareas, haga clic enSubir y Bajar.

d. Haga clic en Aceptar.

e. Agregue más reglas según sea necesario.

6. En el área Procesado por, seleccione el modo en que las tareas se envían a los ejecutores de lalista de ejecutores, tal y como se describe en la tabla siguiente:



Campo Descripción

Usuarios individuales y miembro degrupo al mismo tiempo

Envía una tarea a cada usuario y a todos los usuarios de cada grupo.

Usuarios individuales y el primermiembro de grupo que aceptará latarea, al mismo tiempo

Envía una tarea a cada usuario y una tarea a cada grupo. El gruporecibe la tarea y se asigna al primer miembro de este grupo queadquiere la tarea.

Usuario individual o miembro degrupo con menos tareas

Envía una tarea al ejecutor que tiene el menor número de tareaspendientes.

Usuarios individuales y el primermiembro de grupo que aceptará latarea, en secuencia

Envía una tarea al primer usuario individual que aparece en lalista de ejecutores o al primer miembro del grupo que acepta latarea. La tarea se envía en el orden de la lista de arriba hacia abajo.Después de que esta tarea finaliza, otra tarea se envía al segundousuario individual o al primer miembro del grupo para que aceptela tarea de la lista.

Si selecciona esta opción, tiene la opción adicional de seleccionarsi desea permitir que los ejecutores rechacen una tarea. La tareavuelve al ejecutor que precedente en la secuencia.

7. En el área Opciones de la tarea, seleccione cómo gestionar tareas tal y como se describe en latabla siguiente:

Campo Descripción

Permitir al usuario delegar la tarea Si selecciona esta opción, seleccione el método para distribuir latarea si hay un problema con la delegación automática.

Permitir al ejecutor agregarejecutores adicionales a esta tarea

Esta opción permite al ejecutor agregar más ejecutores paracompletar la misma tarea.

Es necesaria la firma del ejecutor La actividad requiere un de cierre de sesión antes de completarse.Esta opción incluye la adición de una firma electrónica en la tarea.

Permitir que ejecutores de tareassecuenciales rechacen el ejecutoranterior

Si selecciona varios ejecutores de tareas secuenciales, especifiquesi estos pueden rechazar la tarea y devolverla al ejecutor anterioren la secuencia.


En tiempo de ejecución, una tarea manual se crea y asigna a los usuarios en la lista de ejecutorestal y como se define en la actividad manual.

Seleccionar el ejecutor de la última actividad pararealizar una actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Ejecutor de la última actividad y

haga clic en Finalizar.

2. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.

3. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de unaactividad manual, página 120 proporciona más detalles sobre la configuración.



Seleccionar usuarios de los parámetros deaplicación para realizar una actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Usuario por parámetro y haga clic en

Siguiente.2. Utilice el campo Buscar para buscar usuarios (parámetros de aplicación del tipo Usuario) en

los parámetros disponibles.3. Seleccione los usuarios en la lista de parámetros disponibles y haga clic en el botón de flecha a

la derecha para moverlos a la lista Ejecutores seleccionados.4. Haga clic en Finalizar.5. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.6. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de una

actividad manual, página 120 proporciona más detalles sobre la configuración.

Seleccionar un usuario de un conjunto de alias pararealizar una actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Usuario de conjunto de alias y haga

clic en Siguiente.2. En el cuadro de diálogo Seleccione un usuario de un conjunto de alias, seleccione un alias

del conjunto de alias.3. Para seleccionar un alias del conjunto de alias, seleccione un nodo del conjunto de alias en el área

superior y seleccione un alias en el área inferior.4. Haga clic en Finalizar.5. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.6. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de una

actividad manual, página 120 proporciona detalles sobre la configuración.

Seleccionar un usuario de los datos de proceso pararealizar una actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Usuario de los datos de proceso y

haga clic en Siguiente.2. En el cuadro de diálogo Seleccionar un usuario de datos de proceso, seleccione un atributo de

cadena de datos de proceso desde un paquete o seleccione una variable de proceso:• Para seleccionar un atributo de un paquete, expanda el nodo Paquetes en el área de superior,seleccione un paquete y seleccione un atributo en el área inferior.

• Para seleccionar una variable de proceso, seleccione el nodo Variables en el área de superiory seleccione una variable del área inferior.

3. Haga clic en Finalizar.4. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.5. Configure las opciones para las tareas y haga clic en Aceptar.Configurar los ejecutores de una




Seleccionar un rol de aplicación para realizar unaactividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Rol de aplicación y haga clic en

Siguiente.2. Utilice el campo Buscar para buscar un rol en los roles de aplicación disponibles.3. Seleccione el rol de aplicación en la lista disponible y haga clic en el botón de flecha a la derecha

para mover el rol a la lista Ejecutores seleccionados.4. Haga clic en Finalizar.5. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.6. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de una


Seleccionar un grupo de los parámetros deaplicación para realizar una actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Grupo del parámetro y haga clic en

Siguiente.2. Utilice el campo Buscar para buscar un grupo (un parámetro de aplicación del tipo Grupo) en

los parámetros disponibles.3. Seleccione el grupo en la lista de parámetros disponibles y haga clic en el botón de flecha a la

derecha para mover el grupo a la lista Ejecutores seleccionados.4. Haga clic en Finalizar.5. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.6. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de una


Seleccionar un grupo de datos de proceso pararealizar una actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Agrupar por datos de proceso y haga

clic en Siguiente.2. En el cuadro de diálogo Seleccionar un grupo de datos de proceso, seleccione un atributo de

cadena de datos de proceso desde un paquete o seleccione una variable de proceso:• Para seleccionar un atributo de un paquete, expanda el nodo Paquetes en el área de superior,seleccione un paquete y seleccione un atributo en el área inferior.


3. Haga clic en Finalizar.4. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.5. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de una




Seleccionar un grupo de un conjunto de alias pararealizar una actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Grupo de conjunto de alias y haga

clic en Siguiente.2. En el cuadro de diálogo Seleccione un grupo de un conjunto de alias, seleccione un alias del

conjunto de alias.3. Para seleccionar un conjunto de alias para el grupo, seleccione un nodo del conjunto de alias en el

área superior y seleccione un alias en el área inferior.4. Haga clic en Finalizar.5. Haga clic en Subir y en Bajar a fin de ordenar los ejecutores para la distribución de tareas.6. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de una

actividad manual, página 120 proporciona detalles sobre la configuración.

Seleccionar el ejecutor de la actividad anterior parauna actividad manual1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Ejecutor de la actividad anterior y

haga clic en Siguiente.2. Configure el Ejecutor de la actividad anterior tal y como se describe en la tabla siguiente:

Campo Descripción

Actividad Seleccione una actividad anterior en la lista desplegable.

Múltiples opciones de ejecutor Si la actividad anterior tiene varios ejecutores, seleccione quéconjunto de ejecutores se utilizará para la distribución de tareas.

3. Haga clic en Finalizar.4. Configure las opciones para las tareas y haga clic en Aceptar. Configurar los ejecutores de una


Definir colas de trabajos y habilidades en elrepositorioAntes de implementar la aplicación, asegúrese de que las colas de trabajos y las habilidades que seutilizan en el modelo de proceso se hayan definido también en el repositorio. EMC DocumentumContent Server Administration and Configuration Guide (Guía de configuración y administración deEMC Documentum Content Server) proporciona información adicional.1. En Documentum Administrator, defina las colas de trabajos con los mismos nombres que las

colas de trabajos utilizadas en xCP Designer.2. En un proceso, si configura las habilidades de una actividad Tarea de cola de trabajos en xCP

Designer, realice lo siguiente en Documentum Administrator:a. Defina un filtro coincidente con los mismos nombres y valores de habilidades como aquellas

que se utilizan en la actividad Tarea de cola de trabajos de xCP Designer.b. Asocie el filtro coincidente a la cola de trabajos.



c. Agregue las habilidades para la coincidencia de asignación de trabajo a los perfiles deprocesador.

La aplicación lleva a cabo la implementación, incluso aunque los nombres del conjunto dehabilidades no coincidan o estos no se encuentren en el repositorio. En este caso, la cola de trabajosse comporta como si no hubiera habilidades habilitadas. Cualquiera de los miembros de la colade trabajos puede extraer la tarea.

Si un proceso transfiere un valor de habilidad incorrecto (o no transfiere ningún valor) al conjuntode habilidades de la tarea de cola de trabajos en tiempo de ejecución, los miembros de la cola detrabajos no podrán extraer la tarea. Solo el administrador o el encargado de las colas de trabajopuede ver y asignar la tarea al miembro de la cola.

Configurar una cola de trabajos para una tarea1. Arrastre y suelte la actividad Tarea de cola de trabajos en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad y haga clic en la pestaña

Cola de trabajos.3. En el área Cola de trabajos elegida, elija si desea seleccionar una cola de trabajos individual o

seleccionar una cola de trabajos en función de una condición.4. Si selecciona Cola de trabajos, haga clic en Seleccionar.

En Seleccionar una cola de trabajos desde un parámetro, página 126 y Seleccionar una cola detrabajos desde los datos de proceso, página 126 se proporciona información adicional acerca de laselección de una cola de trabajo y la configuración de conjuntos de habilidades de colas de trabajos.

5. Si selecciona Basándose en una condición, en el área Cola de trabajos condicional, haga clicen Editar.a. En el cuadro de diálogo Editar regla, en el área de condición IF, haga clic en Seleccionar para

acceder al editor de expresiones y agregar una condición IF.b. En el área Cola de trabajos, haga clic en Editar para agregar la cola de trabajos que se aplica a

esa regla.

En Seleccionar una cola de trabajos desde un parámetro, página 126 y Seleccionar una colade trabajos desde los datos de proceso, página 126 se proporciona información adicionalacerca de la selección de una cola de trabajo y la configuración de conjuntos de habilidadesde colas de trabajos.

c. Agregue reglas de adicionales, según sea necesario, seleccionando solo una cola de trabajospor regla.

6. En el área Opciones de la tarea, seleccione cómo gestionar la tarea tal y como se describe en latabla siguiente:

Campo Descripción

Permitir al ejecutor agregarejecutores adicionales a esta tarea

Esta opción permite al ejecutor agregar más ejecutores paracompletar la misma tarea.

Es necesaria la firma del ejecutor La actividad requiere un de cierre de sesión antes de completarse.Esta opción incluye la adición de una firma electrónica en la tarea.


En tiempo de ejecución, una tarea se crea y asocia a la cola de trabajos tal y como se define en laactividad Tarea de cola de trabajos.



Seleccionar una cola de trabajos desde un parámetro1. En el cuadro de diálogo Seleccionar cola de trabajos, seleccione Cola de trabajos desde un

parámetro y haga clic en Siguiente.2. En el cuadro de diálogo Seleccionar una cola de trabajos desde un parámetro, utilice el campo

Buscar para buscar una cola de trabajos (parámetros de aplicación del tipo de cola de trabajos) delos parámetros disponibles.

3. Seleccione un parámetro y haga clic en Siguiente.4. Para habilitar la coincidencia de conjunto de habilidades, en el cuadro de diálogo Definir

habilidades de la cola de trabajos, agregue las habilidades necesarias para los ejecutores de lacola de trabajos:a. Haga clic en Añadir habilidad.b. En el cuadro de diálogo Añadir habilidad, escriba el nombre de habilidad, seleccione el tipo

de datos de habilidad y haga clic en Aceptar.c. Seleccione la habilidad y haga clic en Seleccionar para agregar un valor de conjunto de

habilidades.d. Agregue más habilidades según sea necesario.

5. Haga clic en Finalizar.6. Configure las opciones de la tarea y haga clic en Aceptar. Configurar una cola de trabajos para una

tarea, página 125 proporciona más detalles sobre la configuración.

Seleccionar una cola de trabajos desde los datosde proceso1. En el cuadro de diálogo Seleccionar cola de trabajos, seleccione Cola de trabajos desde datos

de proceso y haga clic en Siguiente.2. En el cuadro de diálogo Seleccionar una cola de trabajos de los datos de proceso, seleccione

el atributo de cadena de un paquete o de la variable de proceso que contiene el nombre de lacola de trabajos:• Para seleccionar un atributo de un paquete, expanda el nodo Paquetes en el área de superior,seleccione un paquete y seleccione un atributo en el área inferior.


3. Haga clic en Siguiente.4. Para activar la coincidencia de conjunto de habilidades, en el cuadro de diálogo Definir habilidades

de la cola de trabajos, agregue las habilidades necesarias para los ejecutores de la cola de trabajos:a. Haga clic en Añadir habilidad.b. En el cuadro de diálogo Añadir habilidad, escriba el nombre de habilidad, seleccione el tipo

de datos de habilidad y haga clic en Aceptar.c. Seleccione la habilidad y haga clic en Seleccionar para agregar un valor de conjunto de

habilidades.d. Agregue más habilidades según sea necesario.




6. Configure las opciones de la tarea y haga clic en Aceptar. Configurar una cola de trabajos para unatarea, página 125 proporciona más detalles sobre la configuración.

Asociar un módulo de prioridad a una tarea de colade trabajos1. Haga doble clic en una actividad Tarea de cola de trabajos para abrir el Inspector de actividad.

2. En el cuadro de diálogo Tarea, en la pestaña Prioridad, seleccione Dinámica.

3. En el campoMódulo de prioridad, seleccione el módulo de prioridad que se va a utilizar parala lógica de prioridad y caducidad.

Tareas: actividades del sistema

Configurar el ejecutor y la ejecución de una actividaddel sistema1. Arrastre y suelte una actividad de sistema en el lienzo.


3. En la pestaña Ejecución, configure la Configuración de ejecución tal y como se describe en latabla siguiente:

Campo Descripción

Realizar como Seleccione un ejecutor para la actividad. Este ejecutor ejecuta lalógica de ejecución de actividad y necesita privilegios para estaactividad.

Haga clic en Seleccione, seleccione un ejecutor en el cuadrode diálogo Seleccionar ejecutante y haga clic en Finalizar.Seleccionar un usuario de los parámetros de aplicación para realizaruna actividad del sistema, página 128 proporciona informaciónsobre cómo seleccionar un usuario parámetros de aplicación.

Procedimientos recomendados: para mejorar el rendimiento delas actividades del sistema en el proceso, haga de un usuario (o ungrupo reducido de usuarios) el ejecutor de todas las actividades delsistema. Por ejemplo, mediante la definición de un usuario, comopor ejemplo auto_executor, y convirtiendo a ese usuario en ejecutorde todas las actividades del sistema, la ejecución del tiempo deejecución aumenta significativamente para estas actividades.

Tiempo de espera (seg) Escriba el tiempo de espera en segundos para la duración de laejecución.

Procedimientos recomendados: al configurar las actividadesautomáticas, establezca el campo Tiempo de espera (s) en un valorsuperior a 60 segundos.



Campo Descripción

Prioridad Seleccione una prioridad para la tarea del sistema. De formapredeterminada, el sistema ejecuta las tareas del sistema en elorden de creación. El sistema utiliza esta prioridad solo si estáhabilitada en Documentum Content Server. EMC DocumentumxCelerated Composition Platform Deployment Guide (Guíade desarrollo de EMC Documentum xCelerated CompositionPlatform) proporciona instrucciones sobre cómo habilitar nivelesde prioridad para las actividades del sistema.

Habilitar registro de resolución deproblemas

Seleccione esta opción para guardar un registro de ejecución delservicio en ejecución. Los resultados de la ejecución aparecenen la carpeta del repositorio /Temp/BPM/Method Exec Results.Los errores de actividad aparecen en la carpeta del repositorio/Temp/BPM/Method Exceptions.

4. Configure el Control de excepciones tal y como se describe en la tabla siguiente:

Campo Descripción

Volver a intentar al agotar el tiempoo excepción

Seleccione esta opción para volver a ejecutar la actividad cuandose produzca un error debido a una excepción o una ejecución queesté llevando más tiempo del tiempo de espera especificado.

Máximo de intentos Escriba el número de veces de intentos antes del error.

Intervalo (mín.) Escriba el número de minutos de espera antes de volver a ejecutarla actividad.

En caso de fallo Seleccione cómo continuar cuando no se pueda resolver laexcepción.


Seleccionar un usuario de los parámetros deaplicación para realizar una actividad del sistema1. En el cuadro de diálogo Seleccionar ejecutor, seleccione Usuario del parámetro y haga clic en

Siguiente.2. Utilice el campo Buscar para buscar un usuario (parámetro de aplicación del tipo Usuario) en

los parámetros disponibles.3. Seleccione un usuario en la lista de parámetros disponibles y haga clic en Finalizar.4. Configure Configuración de la ejecución y Control de excepciones para la actividad del sistema

y haga clic en Aceptar. Configurar el ejecutor y la ejecución de una actividad del sistema, página127 proporciona más detalles sobre la configuración.

Configurar una actividad Crear1. Arrastre y suelte la actividad Crear en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En el área Crear objeto de la pestaña Crear, especifique cómo crear el objeto tal y como se




Campo Descripción

Desde un modelo Crea un objeto a partir de un modelo. Haga clic en Seleccionar.Seleccione el modelo de un objeto de negocio, una carpeta o elcontenido, y haga clic en Finalizar.

Desde una copia Copia un objeto en el repositorio, incluidos los atributos del objeto.Si el objeto es una carpeta, también se copian las subcarpetas ylos objetos incluidos dentro de esas subcarpetas. Crear un objetoa partir de una copia no copia las relaciones ni los conjuntos depermisos.

Esto no es compatible con el modelo de objeto de gabinete.

Propagar ACL a hijos Determina si los objetos incluidos en la nueva carpeta heredan ono la lista de control de acceso (ACL) de esa carpeta. Esta opciónsolo se aplica a las carpetas creadas a partir de una copia.

4. En el área Obtener carpeta de destino por, seleccione el modo para identificar la carpeta dedestino tal y como se describe en la tabla siguiente:

Campo Descripción

Usar ubicación predeterminada Identifica la carpeta de destino mediante la propiedad Ubicaciónpredeterminada del modelo.

ID de carpeta Identifica la carpeta de destino mediante un ID de carpeta. Estaopción requiere el ID de carpeta para la asignación de entrada.

Ruta de la carpeta Identifica la carpeta de destino mediante una ruta de acceso en elrepositorio. Esta opción requiere la ruta de acceso de carpeta parala asignación de entrada. Utilice el siguiente formato para la rutade acceso de carpeta:

/<nombre de archivador>/<nombre decarpeta>/<nombre de carpeta>

Esta actividad crea los objetos en la última carpeta de la ruta deacceso.

5. Haga clic en Siguiente.6. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso (Origen) a las

propiedades del objeto (Destino) y haga clic en Siguiente.7. En la pantalla Asignación de mensaje de salida, asigne el ID del objeto recién creado (Origen) a

los datos de proceso (Destino) y haga clic en Aceptar.

Configurar una actividad Crear ACLUtilice la plantilla de actividad Crear ACL para crear un objeto de Documentum ACL a partir deConjunto de permisos y aplicarlo a los objetos de una instancia de proceso. El conjunto de permisosse debe haber creado para incluir marcadores de posición o alias de usuarios y grupos. El sistemautiliza la plantilla de actividad Crear ACL para proporcionar valores para estos marcadores deposición y alias en función de los datos de proceso y crea un nuevo objeto ACL a partir del conjunto depermisos configurado después de resolver los alias.1. Arrastre y suelte la actividad Crear ACL en el lienzo.



2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Crear ACL, seleccione un conjunto de permisos existente y haga clic en Siguiente.

Note: Se admite solo la clase de plantilla del conjunto de permisos.4. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso a los atributos de la

plantilla ACL:

Atributos Descripción

Nombre de la ACL Se asigna al nombre del objeto ACL.

Dominio de ACL Se asigna al propietario del objeto ACL.

Clase ACL Se asigna a la clase de ACL. Los valores válidos son:

• 0 (ACL privada): están disponibles solo para el usuario que lascrea. Solo el propietario de una ACL privada o un usuario conprivilegios de superusuario puede modificar o eliminar la ACL.

• 3 (ACL pública): están disponibles para que cualquier personadel repositorio pueda utilizarlas. Solo el propietario de una ACLpública o un usuario con privilegios del sistema o superusuariopuede modificar o eliminar la ACL.

Note: Una vez configurada la plantilla de actividad con una plantilla de conjunto de permisos,si se agregan nuevos alias al conjunto de permisos, asegúrese de que los valores se asignan alos alias en el Inspector de actividad.

5. En la pantalla Asignación de mensaje de salida, asigne parámetros de la ACL a los datos deproceso.

Atributos Descripción

ID de objeto Se asigna al ID de objeto del objeto ACL recién creado.

Dominio de ACL Se asigna al propietario del objeto ACL recién creado.

Nombre de la ACL Se asigna al nombre del objeto ACL recién creado.

Note: Esta acción del asignador de datos no admite los alias que pertenecen a categorías comoconjunto de permisos, ruta de archivador y ruta de carpeta.


Configurar una actividad Editar permisos1. Arrastre y suelte la actividad Editar permisos en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Editar permisos, asigne los datos de proceso (Origen) para las entradas de permisos

de edición (Destino):a. En el área Origen de la pantalla Asignación de mensaje de entrada, asigne el ID de objeto de

los objetos que desea actualizar con permisos para el atributo Items en el área Destino. Si deseaasignar varios objetos, haga clic en Agregar en el atributo Items para agregar más valores de



índice para el atributo de los elementos (por ejemplo, Items[1], Items[2] e Items[3]). Asigneun ID de objeto para cada valor de índice.

b. Para aplicar el permiso se actualiza para todos los objetos contenidos en una carpeta, asigneun atributo booleano con un valor verdadero al atributo Apply to folder contents en el áreaDestino.

c. Asigne los nombres de usuario o grupo en el área Origen a un nivel de permiso específico,como, por ejemplo, Escritura, en el área Destino. Expanda el nodo Set Permission para ver losniveles de permiso.


Configurar una actividad Mover1. Arrastre y suelte la actividadMover en el lienzo.


3. En el área Obtener carpeta de destino por de la pestaña Mover, seleccione el modo paraidentificar la carpeta de destino tal y como se describe en la tabla siguiente:



Campo Descripción

ID de carpeta Identifica la carpeta de destino mediante un ID de carpeta. Estaopción requiere el ID de carpeta para la asignación de entrada.

Ruta de la carpeta Identifica la carpeta de destino mediante una ruta de acceso en elrepositorio. Esta opción requiere la ruta de acceso de carpeta parala asignación de entrada. Utilice el siguiente formato para la rutade acceso de carpeta:

/<nombre de archivador>/<nombre decarpeta>/<nombre de carpeta>

Esta actividad mueve o crea un acceso directo en la última carpetade la ruta de acceso.

4. En el área Operación, especifique qué desea hacer con el conjunto de objetos tal y como sedescribe en la tabla siguiente:

Campo Descripción

Mover Mueve el conjunto de objetos a la carpeta de destino.

Crear acceso directo Crea un acceso directo en la carpeta de destino para el conjuntode objetos.

5. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso (Origen) a losparámetros de la operación Mover (Destino) y haga clic en Aceptar.

Configurar una actividad Definir los datos de proceso1. Arrastre y suelte la actividad Definir los datos de proceso en el lienzo.


3. En la pestaña Definir los datos de proceso, asigne los datos de proceso de la actividad anterior alos datos de proceso para la actividad Definir los datos de proceso.


Configurar una actividad Llamar al procedimientode la base de datos1. Arrastre y suelte la actividad Llamar al procedimiento de la base de datos en el lienzo.


3. En la pestaña Llamar al procedimiento de la base de datos, configure la actividad tal y como sedescribe en la tabla siguiente:



Campo Descripción

Punto final Seleccione o cree un punto final para la actividad.

Nombre de procedimiento Escriba el nombre del procedimiento.

El nombre de un procedimiento de base de datos almacenado(también conocido como función de base de datos) se expresade las siguientes formas:

• totalmente calificado: <nombre de catálogo>.<nombrede esquema>.<nombre de procedimiento>

• parcialmente calificado: <nombre de es-quema>.<nombre de procedimiento>

• sin calificar: <nombre de procedimiento>

Si no conoce el nombre del procedimiento, haga clic en Buscarpara buscar en todos los esquemas y paquetes en la base de datos.

4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.

Si el procedimiento almacenado no tiene argumentos, vaya al paso 6.5. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso a los argumentos de

procedimiento y haga clic en Siguiente.

Si el procedimiento tiene varios argumentos de entrada y asigna uno solo, los demás se establecenen NULL o tal y como se defina en el procedimiento.

6. En la pantalla Asignación de mensaje de salida, asigne los valores devueltos de procedimiento alos datos de proceso y haga clic en Aceptar.

Si el procedimiento tiene varios valores devueltos y asigna uno solo, los demás se establecen enNULL o tal y como se defina en el procedimiento.

Configurar una actividad Leer desde la base de datos1. Arrastre y suelte la actividad Leer desde la base de datos en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Leer desde la base de datos, seleccione o cree un punto final para la actividad.4. En el área Consulta para ejecutar, escriba una instrucción Select.

Por ejemplo:

select * from dbo.TablexCP where Status=’process’

Para crear una consulta usando parámetros, escriba un signo de interrogación (?) donde deseesustituir el valor.

La consulta de ejemplo siguiente contiene los parámetros:

select * from dbo.TablexCP where Status=?

Solo puede agregar parámetros en la cláusula where. La instrucción puede incluir cualquier númerode parámetros, cada uno de ellos representado por un signo de interrogación. No entrecomilleel signo de interrogación.

5. Si la instrucción Select incluye parámetros, haga clic en Definir tipo de parámetro.



a. En el cuadro de diálogo Definir tipo de parámetros, seleccione los tipos de datos de todoslos parámetros.

b. Haga clic en Aceptar.6. Haga clic en Validar consulta para comprobar que la consulta es una consulta SQL válida.7. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.

Si la instrucción no contiene parámetros, vaya al paso 10.8. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso a parámetros de

instrucción.9. Haga clic en Siguiente.10. En la pantalla Asignación de mensaje de salida, asigne los valores devueltos de instrucción a

los datos de proceso.11. Haga clic en Aceptar.

Configurar una actividad Iniciar desde la base dedatos1. Arrastre y suelte la actividad Iniciar desde la base de datos en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Iniciar desde la base de datos, seleccione o cree un punto final para la actividad.4. En el área Leer consulta, escriba una consulta de lectura para ejecutarla en la base de datos y haga

clic en Validar consulta para comprobar que se trata de una consulta SQL válida.

Por ejemplo:


5. Especifique la información de procesamiento tal y como se describe en la tabla siguiente:

Campo Descripción

Número de hilos Escriba el número de hilos simultáneos que la actividad puedeutilizar para procesar los datos devueltos por la consulta de lectura.

Intervalo (s) Escriba el número de segundos de espera antes de ejecutar unanueva consulta de lectura.

N.º máximo de filas Escriba el número máximo de filas de resultados que la actividadprocesa.

6. En el área Declaración escrita de posprocesamiento, especifique una acción de posprocesamientopara impedir que se recuperen los mismos datos dos veces.

Escriba una instrucción de escritura que actualice los datos de modo que ya no cumplan con laconsulta. La instrucción de escritura puede ser una instrucción de actualizar o eliminar SQL.



update dbo.TablexCP set Status=’done’ where Columnint=?



Solo puede agregar parámetros en la cláusula where. La instrucción update puede incluirlos parámetros que desee, cada uno de ellos representado por un signo de interrogación. Noentrecomille el signo de interrogación.

Asegúrese de que la fila se puede identificar exclusivamente durante el procesamiento posteriorpara que el sistema solo procese una única fila.

7. Si la instrucción de escritura incluye parámetros, haga clic en Definir tipo de parámetros paraasignar los parámetros a los alias, que se asignan a las columnas reales de la base de datos.a. En el cuadro de diálogo Definir campos de parámetro, para cada parámetro de sustitución,

seleccione un nombre o un alias de columna de la base de datos. Las columnas de la basede datos que aparecen en la lista son columnas recuperadas de la base de datos mediante laconsulta de lectura.

b. Haga clic en Aceptar.8. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.9. En la pantalla Asignación de mensaje de entrada, asigne las columnas de fila de base de datos

recuperadas (Origen) a los datos de proceso (Destino).10.Haga clic en Aceptar.

Configurar una actividad Esperar a la base de datos1. Arrastre y suelte la actividad Esperar a la base de datos en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Esperar a la base de datos, seleccione o cree un punto final para la actividad.4. En el área Leer consulta, escriba una consulta de lectura para ejecutarla en la base de datos y haga

clic en Validar consulta para comprobar que se trata de una consulta SQL válida.

Por ejemplo:



Campo Descripción

Número de hilos Escriba el número de hilos simultáneos que la actividad puedeutilizar para procesar los datos devueltos por la consulta de lectura.


N.º máximo de filas Escriba el número máximo de filas de resultados que la actividadprocesa.

6. Para usar identificadores de correlación, en la lista desplegable ID de correlación, seleccioneuna columna que contenga un identificador de correlación. El sistema utiliza el identificador decorrelación para hacer coincidir los datos recuperados del flujo de trabajo.

Puede usar identificadores de correlación, conjuntos de correlación o ambos. El paso 12 describecómo configurar los conjuntos de correlaciones.

7. En el área Declaración escrita de posprocesamiento, especifique una acción de posprocesamientopara impedir que se recuperen los mismos datos dos veces.



Escriba una instrucción de escritura que actualice los datos de modo que ya no cumplan con laconsulta. La instrucción de escritura puede ser una instrucción de actualizar o eliminar SQL.



update dbo.TablexCP set Status=’processed’ where Columnint=?

Solo puede agregar parámetros en la cláusula where. La instrucción update puede incluirlos parámetros que desee, cada uno de ellos representado por un signo de interrogación. Noentrecomille el signo de interrogación.

Asegúrese de que la fila se puede identificar exclusivamente durante el procesamiento posteriorpara que el sistema solo procese una única fila.

8. Si la instrucción de escritura incluye parámetros, haga clic en Definir tipo de parámetros paraasignar los parámetros a los alias, que se asignan a las columnas reales de la base de datos.a. En el cuadro de diálogo Definir campos de parámetro, para cada parámetro de sustitución,

seleccione un nombre o un alias de columna de la base de datos. Las columnas de la basede datos que aparecen en la lista son columnas recuperadas de la base de datos mediante laconsulta de lectura.

b. Haga clic en Aceptar.9. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.10. En la pantalla Asignación de mensaje de entrada, asigne las columnas de fila de base de datos

recuperadas (Origen) a los datos de proceso (Destino).11. Para usar conjuntos de correlación, haga clic en Siguiente. De lo contrario, vaya al paso 13.12. En la pantalla Asignación de conjunto de correlación, en el campo Seleccionar conjunto,

seleccione un conjunto de correlación en la lista desplegable. Mediante la función Copiar, asignelas columnas de base de datos recuperadas (Origen) a variables de conjunto de correlación.

13.Haga clic en Aceptar.

Configurar una actividad Escribir en base de datos1. Arrastre y suelte la actividad Escribir en la base de datos en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Escribir en la base de datos, seleccione o cree un punto final para la actividad.4. En el área Consulta para ejecutar, escriba una instrucción Insert, Update o Delete.



update dbo.TablexCP set Status=’done’ where ID=?


5. Para establecer los parámetros, haga clic en Definir tipo de parámetro.



a. En el cuadro de diálogo Definir tipo de parámetros, seleccione los tipos de datos de todoslos parámetros.

b. Haga clic en Aceptar.6. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.


instrucción.8. Haga clic en Siguiente.9. En la pantalla Asignación de mensaje de salida, asigne los valores devueltos de instrucción a

los datos de proceso.10.Haga clic en Aceptar.

Configurar una actividad Leer desde el repositorio1. Arrastre y suelte la actividad Leer desde el repositorio en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Leer desde el repositorio, configure la actividad tal y como se describe en la tabla

siguiente:

Campo Descripción

Punto final Seleccione o cree un punto final de repositorio de Documentumpara la actividad.

Utilizar repositorio de aplicación entiempo de ejecución

Seleccione este campo para usar el repositorio de aplicación localen lugar del punto final en tiempo de ejecución a fin de mejorar elrendimiento. El punto final y el repositorio de aplicación debenser el mismo.

4. En el área Consulta para ejecutar, escriba una instrucción DQL.

Por ejemplo:

SELECT object_name, r_modify_date FROM dm_document WHERE object_namelike ’%loan%’


SELECT object_name, r_modify_date FROM dm_document WHERE object_namelike ?



SELECT object_name, r_modify_date FROM dm_document WHERE object_name =?

La siguiente consulta de ejemplo contiene la cláusula IN y los parámetros:

SELECT object_name, r_modify_date FROM dm_document WHERE object_name IN(?)



Para sustituir varios valores de un parámetro, vaya al paso 5.

5. Si la instrucción incluye parámetros, haga clic en Definir tipo de parámetro.a. En el cuadro de diálogo Definir tipo de parámetros, seleccione los tipos de todos los

parámetros.b. Seleccione la casilla de verificaciónMultivalor para sustituir varios valores de un parámetro.c. Haga clic en Aceptar.

6. Haga clic en Validar consulta para comprobar que la consulta es una consulta DQL válida.7. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.


instrucción y haga clic en Siguiente.9. En la pantalla Asignación de mensaje de salida, asigne valores de retorno de instrucción a datos

de proceso y haga clic en Aceptar.

Configurar una actividad Iniciar desde el repositorio1. Arrastre y suelte la actividad Iniciar desde el repositorio en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Iniciar desde el repositorio, especifique la información de conexión del repositorio


Campo Descripción




4. En el área Leer consulta, escriba una consulta de lectura para ejecutarla en el repositorio.

Esta consulta de lectura es una calificación de DQL y no una consulta completa. Por ejemplo:

dm_folder where object_name=’x’

5. Haga clic en Validar consulta para comprobar que la consulta es una consulta DQL válida.6. Especifique la información de procesamiento tal y como se describe en la tabla siguiente:

Campo Descripción


Número de hilos Escriba el número de hilos simultáneos que la actividad puedeutilizar para procesar los objetos devueltos por la consulta delectura.

7. Especifique una acción de posprocesamiento para evitar la recuperación del mismo objeto dosveces. Las acciones posteriores al procesamiento se describen en la tabla siguiente:



Campo Descripción

Eliminar objeto Después de que la consulta devuelva un objeto, elimine el objetodel repositorio.

Mover objeto a la carpeta Después de que la consulta devuelva un objeto, mueva el objetoal repositorio.

Ejecutar declaración de actualización Después de que la consulta devuelva un objeto, actualice susatributos dentro del repositorio. Escriba una instrucción queactualice los atributos para que el objeto ya cumpla con la consulta.


9. En la pantalla Asignación de mensaje de entrada, asigne el objeto recuperado de la consulta delectura (Origen) a los datos de proceso (Destino).


Configurar una actividad Esperar al repositorio1. Arrastre y suelte la actividad Esperar al repositorio en el lienzo.


3. En la pestaña Esperar al repositorio, especifique la información de conexión del repositoriotal y como se describe en la tabla siguiente:

Campo Descripción




4. En el área Leer consulta, escriba una consulta de lectura para ejecutarla en el repositorio.

Esta consulta de lectura es una calificación de DQL y no una consulta completa. Por ejemplo:

dm_folder where object_name=’x’

5. Haga clic en Validar consulta para comprobar que la consulta es una consulta DQL válida.


Campo Descripción


Número de hilos Escriba el número de hilos simultáneos que la actividad puedeutilizar para procesar los objetos devueltos por la consulta delectura.

7. Para usar identificadores de correlación, en la lista desplegable ID de correlación, seleccioneun atributo que contenga un identificador de correlación. El sistema utiliza el identificador decorrelación para hacer coincidir el objeto recuperado con el flujo de trabajo.




8. Especifique una acción de posprocesamiento para evitar la recuperación del mismo objeto dosveces. Las acciones posteriores al procesamiento se describen en la tabla siguiente:

Campo Descripción

Eliminar objeto Después de que la consulta devuelva un objeto, elimine el objetodel repositorio.

Mover objeto a la carpeta Después de que la consulta devuelva un objeto, mueva el objetoal repositorio.

Ejecutar declaración de actualización Después de que la consulta devuelva un objeto, actualice susatributos dentro del repositorio. Escriba una instrucción queactualice los atributos para que el objeto ya cumpla con la consulta.

9. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.10. En la pantalla Asignación de mensaje de entrada, asigne el objeto recuperado de la consulta de

lectura (Origen) a los datos de proceso (Destino).11. Si va a utilizar los conjuntos de correlación para la correlación de mensajes, haga clic en Siguiente.

De lo contrario, vaya al paso 13.12. En la pantalla Asignación de conjunto de correlación, en el campo Seleccionar conjunto,

seleccione un conjunto de correlación en la lista desplegable. Mediante la función Copiar, asigneatributos del objeto recuperado (Origen) a variables de conjunto de correlación.


Configurar una actividad Escribir en el repositorio1. Arrastre y suelte la actividad Escribir en el repositorio en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Escribir en el repositorio, configure la actividad tal y como se describe en la tabla

siguiente:

Campo Descripción




4. En el área Consulta para ejecutar, escriba una instrucción DQL.






UPDATE dm_document SET title=? WHERE r_object_id=?

La siguiente consulta de ejemplo contiene la cláusula IN y los parámetros:

UPDATE dm_document OBJECT SET title=? WHERE r_object_id IN (?)

Para sustituir varios valores de un parámetro, vaya al paso 5.

5. Para establecer los parámetros, haga clic en Definir tipo de parámetro.a. En el cuadro de diálogo Definir tipo de parámetros, seleccione los tipos de todos los

parámetros.b. Seleccione la casilla de verificaciónMultivalor para sustituir varios valores de un parámetro.c. Haga clic en Aceptar.



instrucción y haga clic en Siguiente.8. En la pantalla Asignación de mensaje de salida, asigne valores de retorno de instrucción a datos

de proceso y haga clic en Aceptar.

En la plantilla de actividad Escribir en el repositorio, el sistema admite la creación, actualización yeliminación de consultas DQL de objetos pero no la inserción de consultas DQL.

Configurar una actividad Enviar correo electrónicoPara utilizar el cifrado de Nivel de socket seguro (SSL) o Seguridad del nivel de transporte (TLS),debe disponer de un certificado SSL en su entorno. La EMC Documentum xCelerated CompositionPlatform Deployment Guide (Guía de implementación de EMC Documentum xCelerated CompositionPlatform) proporciona instrucciones sobre la importación de certificados SSL para admitir conexionesde cifrado para actividades.1. Arrastre y suelte la actividad Enviar correo electrónico en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Enviar correo electrónico, configure la actividad tal y como se describe en la

tabla siguiente:

Campo Descripción

Punto final Seleccione o cree un punto final de correo electrónico para laactividad.

Plantilla de correo electrónico Seleccione o cree una plantilla de correo electrónico para laactividad.

Vista previa del correo electrónico Vea el asunto y el cuerpo del mensaje de correo electrónicodefinidos en la plantilla de correo electrónico para comprobarque son correctos.

4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.5. En la pantalla Asignación de mensaje de entrada, para el mensaje de entrada, asigne los datos de

proceso (Origen) para los atributos del mensaje de correo electrónico (Destino).a. Asigne el nodo de destinatario Para en el área Destino.



b. Asigne todos los nodos de marcadores de posición que residen en los nodos principales Asuntoy Cuerpo.

c. Utilice los atributos que aparecen la lista de la tabla siguiente para crear asignaciones queestablezcan valores en los encabezados de correo electrónico:

Nombre deatributo

Nombre del encabezado decorreo electrónico

Descripción Acción

Importance X-Priority, Importancia, Priority,X-MSMail-Priority

Estado establecido por el remitenteque indica la importancia relativa delmensaje.

Los valores válidos son: (1) Alto, (3)Normal y (5) Bajo.

Conjuntode

Palabras clave Palabras clave Palabras o frases que se puedenutilizar cuando se busca u ordenacorreo electrónico.

Conjuntode

Fecha decaducidad

Fecha de caducidad La hora en que el mensaje deja de serválido.

Conjuntode

Sensitivity Sensitivity Instrucciones acerca de cómo divulgarcontenido de mensajes.

Los valores válidos son:Personal, Private oCompany-Confidential.

Conjuntode

La actividad Enviar correo electrónico también le permite agregar atributos al nodo AdditionalHeaders (Encabezados adicionales) en el mensaje de correo electrónico.

6. Asigne un anexo o paquete de proceso al anexo del correo electrónico. Si el correo electrónicotiene varios anexos, puede hacer clic en Agregar en el nodo Anexo para agregar más anexos.

7. Haga clic en Siguiente.8. En la pantalla Asignación de mensaje de salida, para el mensaje de salida, asigne los atributos del

mensaje de correo electrónico (Origen) a los datos de proceso (Destino).9. Haga clic en Aceptar.

Configurar una actividad Iniciar desde correoelectrónicoEl cliente de correo electrónico debe tener la codificación establecida en UTF-8 al enviar y leermensajes que utilizan caracteres multibyte.1. Arrastre y suelte la actividad Iniciar desde correo electrónico en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Iniciar desde correo electrónico, seleccione o cree un punto final de correo

electrónico entrante para la actividad.4. En el campo Carpeta que se va a supervisar, escriba o seleccione la carpeta, por ejemplo

Bandeja de entrada, en el servidor de correo electrónico para supervisar los mensajes de correoelectrónico no leídos.




Campo Descripción

Número de hilos Escriba el número de hilos que se utiliza para procesar los mensajesde correo electrónico.

Intervalo (s) Escriba el número de segundos que transcurren antes de que eloyente de correo electrónico busque nuevos mensajes de correoelectrónico desde el servidor de correo electrónico.

Tipo de contenido preferido Escriba o seleccione el tipo de contenido preferido para recuperarlos datos del mensaje de correo electrónico si el mensaje de correoelectrónico contiene varios tipos de contenido. Por ejemplo,un mensaje de correo electrónico enviado con varios tipos decontenido puede contener tanto datos HTML como datos de textosin formato.

6. Especifique una acción de posprocesamiento para evitar el procesamiento del mismo correoelectrónico dos veces. Las acciones posteriores al procesamiento se describen en la tabla siguiente:

Campo Descripción

Eliminar correo electrónico Elimina el mensaje de correo electrónico después de procesarse.

Marcar correo electrónico como leído Marca el mensaje de correo electrónico como leído una vez que seha procesado.

Mover correo electrónico a Mueve el mensaje de correo electrónico después de que se haprocesado. Escriba o seleccione el nombre de la carpeta dearchivo para mover el mensaje de correo electrónico (por ejemplo,Archive).


8. En la pantalla Asignación de mensaje de entrada, asigne los datos del mensaje (Origen) a losdatos de proceso (Destino).

Utilice los atributos mostrados en la tabla siguiente para crear asignaciones que recuperen losvalores de los encabezados de correo electrónico:

Nombre deatributo



Fecha derecepción

La fecha en que el sistema recibióel mensaje de correo electrónico.

Recuperación

Importance X-Priority, Importancia, Priority,X-MSMail-Priority

Estado establecido por el remitenteque indica la importancia relativadel mensaje.

Los valores válidos son: (1) Alto,(3) Normal y (5) Bajo. Si no seasigna este valor, el sistema utilizael valor predeterminado de 3, quees Normal.

Recuperación


Recuperación



Nombre deatributo



Fecha decaducidad

Fecha de caducidad La hora en que el mensaje deja deser válido.

Recuperación

Sensitivity Sensitivity Instrucciones acerca de cómodivulgar contenido de mensajes.


Recuperación

Si estos atributos no se han asignado, sus valores no se recuperan desde el mensaje entrante.

El la actividad Iniciar desde correo electrónico también le permite agregar atributos al nodoAdditional Headers (Encabezados adicionales) en el mensaje de correo electrónico.

9. Asigne los datos adjuntos de correo electrónico a un paquete de proceso o datos adjuntos.10.Haga clic en Aceptar.

Configurar una actividad Esperar al correoelectrónicoEl cliente de correo electrónico debe tener la codificación establecida en UTF-8 al enviar y leermensajes que utilizan caracteres multibyte.1. Arrastre y suelte la actividad Esperar al correo electrónico en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Esperar al correo electrónico, seleccione o cree un punto final de correo electrónico

entrante para la actividad.4. En el campo Carpeta que se va a supervisar, escriba o seleccione la carpeta, por ejemplo

Bandeja de entrada, en el servidor de correo electrónico para supervisar los mensajes de correoelectrónico no leídos.


Campo Descripción

Número de hilos Escriba el número de hilos que se utiliza para procesar los mensajesde correo electrónico.

Intervalo (s) Escriba el número de segundos que transcurren antes de que eloyente de correo electrónico busque nuevos mensajes de correoelectrónico desde el servidor de correo electrónico.

Tipo de contenido preferido Escriba o seleccione el tipo de contenido preferido para recuperarlos datos del mensaje de correo electrónico si el mensaje de correoelectrónico contiene varios tipos de contenido. Por ejemplo,un mensaje de correo electrónico enviado con varios tipos decontenido puede contener tanto datos HTML como datos de textosin formato.

6. En el campo Nombre de encabezado de correlación, escriba un nombre de encabezado queincluya un ID de correlación para utilizarse para la correlación de correo electrónico para lainstancia correcta del proceso a la espera.




7. Especifique una acción de posprocesamiento para evitar el procesamiento del mismo correoelectrónico dos veces. Las acciones posteriores al procesamiento se describen en la tabla siguiente:

Campo Descripción

Eliminar correo electrónico Elimina el mensaje de correo electrónico después de procesarse.

Marcar correo electrónico como leído Marca el mensaje de correo electrónico como leído una vez que seha procesado.

Mover correo electrónico a Mueve el mensaje de correo electrónico después de que se haprocesado. Escriba o seleccione el nombre de la carpeta dearchivo para mover el mensaje de correo electrónico (por ejemplo,Archive).

8. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.9. En la pantalla Asignación de mensaje de entrada, asigne los datos del mensaje (Origen) a los

datos de proceso (Destino).

Utilice los atributos mostrados en la tabla siguiente para crear asignaciones que recuperen losvalores de los encabezados de correo electrónico:

Nombre deatributo



Fecha derecepción

La fecha en que el sistema recibióel mensaje de correo electrónico.

Recuperación

Importance X-Priority, Importancia,Priority, X-MSMail-Priority

Estado establecido por el remitenteque indica la importancia relativadel mensaje.

Los valores válidos son: (1) Alto,(3) Normal y (5) Bajo. Si no seasigna este valor, el sistema utilizael valor predeterminado de 3, quees Normal.

Recuperación


Recuperación

Fecha decaducidad

Fecha de caducidad La hora en que el mensaje deja deser válido.

Recuperación

Sensitivity Sensitivity Instrucciones acerca de cómodivulgar contenido de mensajes.


Recuperación

Si estos atributos no se han asignado, sus valores no se recuperan desde el mensaje entrante.

La actividad Esperar al correo electrónico también le permite agregar atributos al nodoAdditional Headers (Encabezados adicionales) en el mensaje de correo electrónico.

10.Asigne los datos adjuntos de correo electrónico a un paquete de proceso o datos adjuntos.



11. Si va a utilizar los conjuntos de correlación, haga clic en Siguiente. De lo contrario, vaya al paso 13.12. En la pantalla Asignación de conjunto de correlación, en el campo Seleccionar conjunto,

seleccione un conjunto de correlación en la lista desplegable. Mediante la función Copiar, asigneatributos del mensaje (Origen) a variables de conjunto de correlación correspondientes.


Configurar una actividad Llamar proceso1. Arrastre y suelte la actividad Llamar proceso en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Llamar proceso, configure la actividad tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre de proceso Haga clic en Seleccionar, seleccione un subproceso lógico para laactividad que vaya a invocar, y haga clic en Finalizar.

Iniciar versión actual del proceso Seleccione si la actividad llama a la versión actual o a la versiónconfigurada del subproceso en tiempo de ejecución.

Si la casilla de verificación está seleccionada, la actividad siemprellama a la versión actual del subproceso en tiempo de ejecución,incluso aunque el proceso esté configurado con una versiónanterior del proceso. Si no está seleccionada, la actividad llama ala versión configurada del subproceso en tiempo de ejecución.

Configuración de invocación Seleccione si el proceso principal espera al subproceso invocadopara completarse antes de pasar a la siguiente actividad delproceso principal. Seleccione una configuración para el procesosecundario.

Configuración de inicio de proceso Seleccione si el subproceso comienza con la actividad de inicio ocon otra actividad del proceso.

4. Haga clic en Siguiente.5. En la pantalla Asignación de mensaje de entrada, asigne paquetes, variables, datos adjuntos y

datos de ejecución del proceso principal (Origen) a los datos de proceso del subproceso lógico(Destino), y haga clic en Siguiente.

6. En la pantalla Asignación de mensaje de salida, asigne los datos disponibles del subprocesológico al proceso principal:• Si la actividad continúa con la siguiente actividad antes de que el subproceso finalice, asigne elID de proceso del subproceso (Origen) al proceso principal (Destino).

• Si la actividad espera a que se complete el subproceso, asigne los datos del proceso completadodesde el subproceso (Origen) al proceso principal (Destino).


Configurar una actividad Llamar a un proceso sinestado1. Arrastre y suelte la actividad Llamar a un proceso sin estado en el lienzo.



2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En el campo Proceso de la pestaña Llamar a un proceso sin estado, haga clic en Seleccionar.4. Seleccione un modelo de proceso sin estado para llamar desde la actividad y haga clic

enFinalizar.Configurar información general para el modelo de proceso, página 97 explicadetalladamente cómo designar un modelo de proceso para ejecutarlo en modo sin estado.

5. Haga clic en Siguiente.6. En la pantalla Asignación de mensaje de entrada, asigne los datos de proceso (paquetes y

variables) del proceso principal (Origen) a los datos de proceso del proceso sin estado (Destino), yhaga clic en Siguiente.

7. En la pantalla Asignación de mensaje de salida, asigne los datos de proceso completados delproceso sin estado (Origen) al proceso principal (Destino).


Configurar una actividad Señalar proceso principalUtilice esta actividad en un proceso para indicar a un proceso principal en espera que continúe.1. Arrastre y suelte la actividad Señalar proceso principal en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso desde el proceso

(Origen) al atributo Nombre de señal en el proceso principal (Destino).

El nombre de señal es el nombre de la señal del desencadenador. Una actividad en el procesoprincipal espera a esta señal. El nombre de señal debe coincidir con el nombre especificado en lapestaña Desencadenador de la actividad pendiente.


Configurar una actividad Descargar desde FTP1. Arrastre y suelte la actividad Descargar desde FTP en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Descargar desde FTP, configure la actividad tal y como se describe en la tabla

siguiente:

Campo Descripción


Tipo de mensaje Seleccione el tipo de mensaje para descargar, ya sea un archivosin formato, comprimido (archivado en una carpeta zip) o endirectorio (organizado en subcarpetas).

4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.5. En la pantalla Asignación de mensaje de entrada, especifique un patrón o un nombre de archivo o

directorio exacto para obtenerlo del servidor FTP.6. Haga clic en Siguiente.7. En la pantalla Asignación de mensaje de salida, asigne los atributos del archivo descargado, el

archivo comprimido o el directorio a los datos de proceso.




Configurar una actividad Iniciar desde FTP1. Arrastre y suelte la actividad Iniciar desde FTP en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Iniciar desde FTP, seleccione o cree un punto terminal para la actividad.4. Especifique la información de supervisión tal y como se describe en la tabla siguiente:

Campo Descripción

Tipo de mensaje Seleccione el tipo de mensaje que desea recibir, ya sea un archivosin formato, comprimido (archivado en una carpeta zip) o endirectorio (organizado en subcarpetas).

Incluir patrón de nombre Especifique un patrón o el nombre exacto del archivo o directoriopara que se obtenga desde el servidor FTP.

Excluir patrón de nombre Especifique un patrón o el nombre exacto del archivo o directoriopara evitar que se obtenga desde el servidor FTP.


Campo Descripción

Número de hilos Escriba el número de hilos simultáneos que la actividad puede usarpara descargar contenido del servidor FTP.

Intervalo (s) Escriba el número de segundos de espera antes de que la actividadcompruebe s hay nuevos archivos o carpetas de mensajes entrantesdesde el servidor FTP.

6. Especifique una acción de posprocesamiento para evitar que se obtenga el mismo archivo odirectorio dos veces. Las acciones posteriores al procesamiento se describen en la tabla siguiente:

Campo Descripción

Eliminar archivo o directorio Elimina el archivo de mensaje o directorio del servidor FTPdespués de que se haya recuperado.

Mover el archivo o directorio a Mueve el archivo del mensaje o el directorio después de que se harecuperado. Escriba una ubicación de destino en el servidor FTP(por ejemplo, /archive).

7. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.8. En la pantalla Asignación de mensaje de entrada, asigne los atributos del mensaje FTP (Origen) a

los datos de proceso (Destino).9. Haga clic en Aceptar.

Configurar una actividad Subir vía FTP1. Arrastre y suelte la actividad Subir vía FTP en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Subir vía FTP, configure la actividad tal y como se describe en la tabla siguiente:



Campo Descripción


Tipo de mensaje Seleccione el tipo de mensaje para enviar, ya sea un archivo sinformato, un archivo comprimido (archivado en una carpeta zip) oun directorio (organizado en subcarpetas).

Opciones Seleccione Sobrescribir archivo o carpeta si existe parasobrescribir archivos o carpetas en el sistema de punto final.

Desactive esta opción para crear nuevos archivos o carpetas enlugar de sobrescribir.

4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.5. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso a los atributos de

archivo, archivo comprimido o directorio.

Las carpetas y subcarpetas de código postal se nombran en tiempo de ejecución. Los nombresde carpetas de código postal se basan en el nombre de archivo comprimido que configure. Losnombres de subcarpeta se basan en el nombre del directorio que configure.

Los archivos cuyo atributo Tipo de contenido se asigna a texto de cadena se transfieren como textoASCII. Todos los demás archivos se transfieren en modo binario.


Configurar una actividad Esperar a FTP1. Arrastre y suelte la actividad Esperar a FTP en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Esperar a FTP, seleccione o cree un punto final para la actividad.4. Especifique la información de supervisión tal y como se describe en la tabla siguiente:

Campo Descripción

Tipo de mensaje Seleccione el tipo de mensaje que desea recibir, ya sea un archivosin formato, comprimido (archivado en una carpeta zip) o endirectorio (organizado en subcarpetas).

Incluir patrón de nombre Especifique un patrón o el nombre exacto del archivo o directoriopara que se obtenga desde el servidor FTP.

Excluir patrón de nombre Especifique un patrón o el nombre exacto del archivo o directoriopara evitar que se obtenga desde el servidor FTP.


Campo Descripción

Número de hilos Escriba el número de hilos simultáneos que la actividad puede usarpara descargar contenido del servidor FTP.

Intervalo (s) Escriba el número de segundos de espera antes de que la actividadcompruebe s hay nuevos archivos o carpetas de mensajes entrantesdesde el servidor FTP.



6. Para usar identificadores de correlación para la correlación de mensajes, en el campo Patrón decorrelación, escriba un patrón de correlación para ver cómo determinar el ID de correlación delnombre de archivo. El oyente de FTP utiliza este patrón para correlacionar el mensaje con elflujo de trabajo.

Utilice $id$ como un marcador de posición para el identificador de correlación. Los valores delos marcadores de posición son caracteres alfanuméricos sin espacios.

Por ejemplo, el archivo sam_956d77f734b6d7fb97771be.xml se puede representar comosam_$id$.xml. El valor del marcador de posición $id$ representa el ID de correlación956d77f734b6d7fb97771be.


7. Especifique una acción de posprocesamiento para evitar que se obtenga el mismo archivo odirectorio dos veces. Las acciones posteriores al procesamiento se describen en la tabla siguiente:

Campo Descripción

Eliminar archivo o directorio Elimina el archivo de mensaje o directorio del servidor FTPdespués de que se haya recuperado.

Mover el archivo o directorio a Mueve el archivo del mensaje o el directorio después de que se harecuperado. Escriba una ubicación de destino en el servidor FTP(por ejemplo, /archive).


9. En la pantalla Asignación de mensaje de entrada, asigne los atributos del mensaje FTP (Origen) alos datos de proceso (Destino).

10. Si va a utilizar los conjuntos de correlación, haga clic en Siguiente. De lo contrario, vaya al paso 12.

11. En la pantalla Asignación de conjunto de correlación, en el campo Seleccionar conjunto,seleccione un conjunto de correlación en la lista desplegable. Mediante la función Copiar, asigneatributos del mensaje de FTP (Origen) a variables de conjunto de correlación correspondientes.


Configurar una actividad Enviar solicitud HTTP oRESTful1. Arrastre y suelte la actividad Enviar solicitud HTTP/RESTful en el lienzo.


3. En la pestaña Enviar solicitud HTTP/RESTful, configure la actividad tal y como se describeen la siguiente tabla:

Campo Descripción


Método de solicitud Seleccione uno de los siguientes métodos HTTP para la solicitud:GET, POST, PUT y DELETE.



Campo Descripción

Tiempo de espera de conexión(minutos)

Muestra el número de minutos que pueden transcurrir antes deque el sistema termine una conexión inactiva.

Permitir cuerpo de solicitud de variaspartes

Le permite asociar varios anexos con la solicitud HTTP. Estaopción solo es válida para las solicitudes POST y PUT.


5. En la pantalla Asignación de mensaje de entrada, asigne datos de procesos al mensaje desolicitud y haga clic en Siguiente.

6. En la pantalla Asignación de mensaje de salida, asigne el mensaje de respuesta a los datos deproceso.

Si es necesario, agregue atributos o elementos a los datos de proceso para completar lasasignaciones.

Nota: Debe seleccionar un punto final de servicio HTTP (URL, nombre de usuario y contraseña) paraconfigurar la actividad Enviar solicitud HTTP/RESTful.El punto final (URL, nombre de usuario ycontraseña) para la llamada de HTTP/REST puede configurarse de las dos maneras siguientes:

• Uso del punto final de HTTP cuando es constante para todas las solicitudes.

• Uso de los nodos de URL, nombre de usuario y contraseña en el asignador de datos cuando elpunto final cambie para cada solicitud.

El punto final o la asignación de datos deben estar presentes para completar la configuración de laactividad Enviar solicitud HTTP/RESTful. Tanto el punto final como la asignación de datos se puedenconfigurar. Si ambas se han configurado, durante el tiempo de ejecución las asignaciones de datos a losnodos de URL, nombre de usuario y contraseña tendrán prioridad sobre los nodos especificados enel punto final. No hay ninguna validación para la URL especificada en el punto final, excepto paraProbar conexión que se utilizó en el punto final.

Configurar una actividad Iniciar desde HTTP

El navegador debe tener la codificación establecida en UTF-8 al enviar la solicitud al agente de escuchaHTTP entrante si se utilizan caracteres multibyte.

1. Arrastre y suelte la actividad Iniciar desde HTTP en el lienzo.


3. En la pestaña Iniciar desde HTTP, especifique la información de la solicitud tal y como sedescribe en la tabla siguiente:



Campo Descripción

Sufijo de URL Escriba un sufijo para que la dirección URL local se supervisepara solicitudes HTTP entrantes.

Método HTTP Seleccione un método HTTP para la solicitud entrante.

Si espera que la URL de solicitud incluya parámetros de cadena deconsulta, asígnelos a los datos de proceso en el paso 7.

Si espera la solicitud para incluir un cuerpo de mensaje, seleccioneCon anexos. Por ejemplo, un archivo de contenido o de imagenpuede ser el cuerpo del mensaje.

Si el cuerpo del mensaje es un documento XML que necesite lavalidación, seleccione Validar documentos XML.


Campo Descripción

Requiere autenticación Seleccione esta opción para requerir las credenciales deautenticación al servidor web que envía la solicitud HTTP.

Nombre de usuario Escriba un nombre de usuario para autenticar la solicitud.

Contraseña Escriba una contraseña para autenticar la solicitud.

5. Para crear un mensaje de respuesta HTML para que se devuelva a partir de la solicitud, seleccioneUsar plantilla de respuesta personalizada.

a. En el cuadro de texto Plantilla de respuesta, escriba una plantilla para que la respuesta HTTPse envíe cuando se reciba una solicitud HTTP.

b. Incluya una variable de sustitución para cada elemento de datos de proceso que se va a insertaren la plantilla en tiempo de ejecución. Asigne las variables de sustitución a los datos de procesoen el paso 9. Estas variables tienen la misma sintaxis que las plantillas de correo electrónico.Plantillas de correo electrónico, página 56 proporciona información adicional.

En el siguiente ejemplo, se envía un mensaje para indicar que un pedido de compra específico se haprocesado correctamente:

Purchase Order $orderno successfully processed.

En este ejemplo, orderno es un marcador de posición que aparece en la pantalla Asignación demensaje de salida y que se puede asignar a un paquete o una variable de proceso. Un númerode pedido real reemplaza la variable de sustitución de la asignación de datos de respuesta entiempo de ejecución:

Purchase Order 0896523 successfully processed.


7. En la pantalla Asignación de mensaje de entrada, asigne el mensaje de solicitud de entrada(Origen) a los datos de proceso (Destino).


9. En la pantalla Asignación de mensaje de salida, asigne los datos de proceso (Origen) al mensajede respuesta (Destino).




Configurar una actividad Esperar a HTTPEl navegador debe tener la codificación establecida en UTF-8 al enviar la solicitud al agente de escuchaHTTP entrante si se utilizan caracteres multibyte.1. Arrastre y suelte la actividad Esperar a HTTP en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Esperar a HTTP, especifique la información de la solicitud tal y como se describe


Campo Descripción

Sufijo de URL Escriba un sufijo para que la dirección URL local se supervisepara solicitudes HTTP entrantes.

Método HTTP Seleccione un método HTTP para la solicitud entrante.

Si espera que la URL de solicitud incluya parámetros de cadena deconsulta, asígnelos a los datos de proceso en el paso 8.

Si espera la solicitud para incluir un cuerpo de mensaje, seleccioneCon anexos. Por ejemplo, un archivo de contenido o de imagenpuede ser el cuerpo del mensaje.

Si el cuerpo del mensaje es un documento XML que necesite lavalidación, seleccione Validar documentos XML.

4. Si desea utilizar un ID de correlación, en el campo Nombre de encabezado de correlación,escriba el nombre del encabezado que contiene el ID de correlación. El oyente de HTTP utiliza elID de correlación para hacer coincidir la solicitud HTTP entrante con el proceso.



Campo Descripción

Requiere autenticación Seleccione esta opción para requerir las credenciales deautenticación al servidor web que envía la solicitud HTTP.

Nombre de usuario Escriba un nombre de usuario para autenticar la solicitud.

Contraseña Escriba una contraseña para autenticar la solicitud.

6. Para crear un mensaje de respuesta HTML para que se devuelva a partir de la solicitud, seleccioneUsar plantilla de respuesta personalizada.a. En el cuadro de texto Plantilla de respuesta, escriba una plantilla para que la respuesta HTTP

se envíe cuando se reciba una solicitud HTTP.b. Incluya una variable de sustitución para cada elemento de datos de proceso que se va a insertar

en la plantilla en tiempo de ejecución. Asigne las variables de sustitución a los datos de procesoen el paso 10. Estas variables tienen la misma sintaxis que las plantillas de correo electrónico.Plantillas de correo electrónico, página 56 proporciona información adicional.

En el siguiente ejemplo, se envía un mensaje para indicar que una cuenta se ha procesadocorrectamente:

Account number $acctno successfully processed.



En este ejemplo, acctno es un marcador de posición que aparece en la pantalla Asignación demensaje de salida y que se puede asignar a un paquete o una variable de proceso. Un númerode cuenta real reemplaza la variable de sustitución de la asignación de datos de respuesta entiempo de ejecución:

Account number 0453323 successfully processed.

7. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.8. En la pantalla Asignación de mensaje de entrada, asigne el mensaje de solicitud de entrada

(Origen) a los datos de proceso (Destino).9. Haga clic en Siguiente.10. En la pantalla Asignación de mensaje de salida, asigne los datos de proceso (Origen) al mensaje

de respuesta (Destino).11. Si va a utilizar los conjuntos de correlación, haga clic en Siguiente. De lo contrario, vaya al paso 13.12. En la pantalla Asignación de conjunto de correlación, en el campo Seleccionar conjunto,

seleccione un conjunto de correlación en la lista desplegable. Mediante la función Copiar, asigne losatributos del mensaje de HTTP (Origen) a variables de conjunto de correlación correspondientes.


Configurar una actividad Ejecutar servicio de Java1. Arrastre y suelte la actividad Ejecutar servicio de Java en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Ejecutar servicio de Java, configure la actividad tal y como se describe en la

tabla siguiente:

Campo Descripción

Servicio de Java Seleccione el servicio de Java que desea que el proceso ejecute.

Método Seleccione uno de los métodos que el servicio de Java pone adisposición.

Cada método corresponde a una función que el servicio de Javapuede realizar.

4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.5. En la pantalla Asignación de mensaje de entrada, asigne los datos de proceso a los argumentos

del método.6. Haga clic en Siguiente.7. En la pantalla Asignación de mensaje de salida, asigne la respuesta a los datos de proceso.8. Haga clic en Aceptar.

Ejemplo de ampliación de la funcionalidad deprocesoUn ejemplo de funcionalidad ampliada de proceso predeterminado es la capacidad para generar unID único para su uso en un perfil de cliente. Para obtener esta funcionalidad, un desarrollador puedeescribir código de Java personalizado e integrarlo en su aplicación como un módulo de Java.



En este ejemplo, el nombre del servicio de Java es JavaGetUniqID y el método esgenerateUniqueID(prefijo de cadena). Este método dispone de una entrada de tipo Cadena y su valorse utiliza como un prefijo para el ID único. El método de salida (el ID único) es del tipo Cadena. Elmétodo genera un ID único y agrega el prefijo a ese ID único y lo devuelve.import java.util.UUID;

public class UniqueIDGenerator{public static String generateUniqueId(String prefix){

int hashCode = UUID.randomUUID().hashCode();return prefix + Integer.toString(hashCode);

}}

1. Cree un objeto de negocio denominado Cliente con los atributos: Nombre, Apellido e IDde cliente. Todos ellos son del tipo Cadena. CustomerID representa un ID único.

2. Cree un modelo de proceso.3. Cree un paquete denominado CustomerPkg de tipo Cliente.4. Agregue una actividad Ejecutar servicio de Java a su modelo de proceso.5. Al configurar la actividad:

a. Seleccione el servicio JavaGetUniqID.b. Seleccione el método generateUniqueID(String Prefix).c. Asigne datos de proceso para la entrada de método. Seleccione el atributo Apellido de

CustomerPkg como los datos para asignar a Prefijo en generateUniqueID.d. Asigne la salida del método al atributoCustomerID en CustomerPkg.

En tiempo de ejecución, cuando se inicia el proceso con una instancia Cliente, el sistema rellena elatributo CustomerID con un ID único generado por el servicio de Java.

Configurar una actividad Enviar mensaje de JMS1. Arrastre y suelte la actividad Enviar mensaje JMS en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Enviar mensaje JMS, configure la actividad tal y como se describe en la tabla

siguiente:

Campo Descripción


Tipo de mensaje Seleccione un tipo de mensaje JMS para enviarlo. Por ejemplo,hay tipos para texto, binario y datos de transmisión.

4. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.5. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso a los datos de mensaje.6. Haga clic en Siguiente.7. En la pantalla Asignación de mensaje de salida, asigne los atributos del mensaje a los datos

de proceso.




Si es necesario para completar las asignaciones, agregue atributos o elementos a los datos.

Configurar una actividad Iniciar desde JMS1. Arrastre y suelte la actividad Iniciar desde JMS en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Iniciar desde JMS, seleccione o cree un punto final para la actividad.4. Especifique la información de supervisión tal y como se describe en la tabla siguiente:

Campo Descripción

Selector de mensajes Escriba un selector de mensajes de JMS para filtrar los mensajesadecuadamente para el proceso.

Tipo de mensaje Seleccione un formato de cuerpo del mensaje (tipo de mensaje)definido por la API de JMS.


Campo Descripción

Número de hilos Escriba el número de hilos que la actividad puede utilizar de formasimultánea para descargar contenido desde el servidor de JMS.

Validar XML Seleccione esta opción para validar los mensajes de JMS medianteun esquema XML.

6. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.7. En la pantalla Asignación de mensaje de entrada, asigne los datos de mensajes (Origen) a los

datos de proceso (Destino). Si está utilizando un esquema XML en el servidor de JMS para validarlos mensajes, agregue el esquema XML al nodo Datos en el árbol de contexto de mensajes.Usar un esquema XML para representar una estructura de contenido, página 202 proporcionainstrucciones paso a paso.


Configurar una actividad Esperar a JMS1. Arrastre y suelte la actividad Esperar a JMS en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Esperar a JMS, seleccione o cree un punto final para la actividad.4. Especifique la información de supervisión tal y como se describe en la tabla siguiente:

Campo Descripción

Selector de mensajes Escriba un selector de mensajes de JMS para filtrar los mensajesadecuadamente para el proceso.

Tipo de mensaje Seleccione un formato de cuerpo del mensaje (tipo de mensaje)definido por la API de JMS.




Campo Descripción

Número de hilos Escriba el número de hilos que la actividad puede utilizar de formasimultánea para descargar contenido desde el servidor de JMS.

Validar XML Seleccione esta opción para validar los mensajes de JMS medianteun esquema XML.

6. Haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.7. En la pantalla Asignación de mensaje de entrada, asigne los datos de mensajes (Origen) a los

datos de proceso (Destino). Si está utilizando un esquema XML en el servidor de JMS para validarlos mensajes, agregue el esquema XML al nodo Datos en el árbol de contexto de mensajes.Usar un esquema XML para representar una estructura de contenido, página 202 proporcionainstrucciones paso a paso.

8. Si va a utilizar los conjuntos de correlación para la correlación de mensajes, haga clic en Siguiente.De lo contrario, vaya al paso 10.

9. En la pantalla Asignación de conjunto de correlación, en el campo Seleccionar conjunto,seleccione un conjunto de correlación en la lista desplegable. Mediante la función Copiar, asignedatos de mensaje (Origen) a variables de conjunto de correlación.


Configurar una actividad Llamar a servicio web1. Arrastre y suelte la actividad Llamar a servicio web en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Llamar a servicio web, configure la actividad tal y como se describe en la tabla

siguiente:

Campo Descripción


Tipo de puerto Seleccione el puerto para la operación que va a elegir.

Operación Seleccione una operación admitida por el servicio web al quepretende llamar.

Usar paquete de optimización debinario XML

Seleccione esta opción para habilitar la serialización de conjuntosde información XML que contienen datos binarios.


Si la operación no tiene parámetros de entrada, vaya al paso 7.5. En la pantalla Asignación de mensaje de entrada, asigne datos de proceso a los parámetros de

entrada de operación.6. Haga clic en Siguiente.7. En la pantalla Asignación de mensaje de salida, asigne los valores de salida a los datos de proceso.

Si la operación no tiene parámetros de salida, vaya al paso 8.8. Haga clic en Aceptar.



Registrar el repositorio para los serviciosencadenados

Este procedimiento utiliza el componente ContextRegistryService proporcionado por DFS pararegistrar el repositorio. EMC Documentum Foundation Services Development Guide (Guía dedesarrollo de EMC Documentum Foundation Services) proporciona más información sobreContextRegistryService.

1. Crear un punto final de servicio web mediante la ruta de acceso URL completa a WSDL.

Por ejemplo:

http://<hostname>:<port>/services/core/runtime/ContextRegistryService?wsdl

El WSDL también puede existir como un archivo local.

2. Haga doble clic en la actividad Llamar a servicio web para abrir el Inspector de actividad.

3. En la pestaña Llamar a servicio web, seleccione el punto final de servicio web que ha creado enel paso 1.

4. En el campo Tipo de puerto, seleccione ContextRegistryServicePort.

5. En el campo Operación, seleccione registrar.


7. En la pantalla Asignación de mensaje de entrada, cree las asignaciones siguientes:

• Asigne RepositoryName a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@repositoryName

• Asigne Username a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@userName

• Asigne Password a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@password

• Asigne Domain a:

SOAPEnvelope/SOAPBody/parameters/register/context/RepositoryIdentity[0]/@domain

RepositoryIdentityes un nodo de repetición. Se pueden registrar varias identidades a un token único.


9. En la pantalla Asignación de mensaje de salida, el token generado está disponible en

SOAPEnvelope/SOAPBody/parameters/registerResponse/return



Eliminar del Registro la identidad del repositoriopara los servicios encadenadosEste procedimiento utiliza el componente ContextRegistryService proporcionado por DFS paraeliminar el registro del repositorio. EMC Documentum Foundation Services Development Guide(Guía de desarrollo de EMC Documentum Foundation Services) proporciona más información sobreContextRegistryService.1. Crear un punto final de servicio web mediante la ruta de acceso URL completa a WSDL.

Por ejemplo:



2. Haga doble clic en la actividad Llamar a servicio web para abrir el Inspector de actividad.3. En la pestaña Llamar a servicio web, seleccione el punto final de servicio web que ha creado en

el paso 1.4. En el campo Tipo de puerto, seleccione ContextRegistryServicePort.5. En el campo Operación, seleccione eliminar registro.6. Haga clic en Siguiente.7. En la pantalla Asignación de mensaje de entrada, agregue el token que desea quitar del registro

en SOAPEnvelope/SOAPBody/parameters/unregister/token.

Abrir servicios DFS típicos (únicos o encadenados)1. Crear un punto final de servicio web mediante la ruta de acceso URL completa a WSDL.

Por ejemplo:



2. Haga doble clic en la actividad Llamar a servicio web para abrir el Inspector de actividad.3. En la pestaña Llamar a servicio web, seleccione el punto final de servicio web que ha creado en

el paso 1.4. Seleccione el Tipo de puerto y Operación en función de los valores disponibles del archivo

WSDL.5. Haga clic en Siguiente.6. En la pantalla Asignación de mensaje de entrada, agregue las asignaciones de datos siguientes

para autenticar cualquiera de los servicios DFS.

Utilice la función de concatenación para construir la cadena para la asignación.

Las asignaciones siguientes solo se utilizan para autenticar los servicios DFS. EMC DocumentumFoundation Services Development Guide (Guía de desarrollo de EMC Documentum FoundationServices) proporciona información detallada 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])

Utilice varias <Identities/> cuando se utilice más de un repositorio para la autenticación.

Configurar una actividad Iniciar desde servicio web1. En las Propiedades de proceso del modelo de proceso, en la pestaña Avanzado, configure el URI

del espacio de nombres de destino.2. Arrastre y suelte la actividad Iniciar desde servicio web en el lienzo.3. Haga doble clic en la actividad para abrir el Inspector de actividad.4. En la pestaña Iniciar desde servicio web, especifique la información de entrada del servicio web


Campo Descripción

Definir según Seleccione si desea definir las entradas del servicio web desdeDatos de proceso o un Servicio web existente.

Si selecciona Datos de proceso, el sistema no requiere que asignelos datos ya que las asignaciones están implícitas.

URL de WSDL Si selecciona Servicio web existente, escriba la dirección URLpara el WSDL (lenguaje de descripción de servicios web) quese utiliza para la actividad y haga clic en Leer para recuperar elWSDL desde la ubicación especificada.

Tipo de puerto Si selecciona Datos de proceso, escriba el nombre para el tipo depuerto de WSDL. De lo contrario, seleccione un tipo de puertoen la lista desplegable.

Operación Si selecciona Datos de proceso, escriba un nombre para laoperación de WSDL. De lo contrario, seleccione una operaciónen la lista desplegable.




Campo Descripción

Habilitar autenticación WS-Security Seleccione esta opción para requerir las credenciales deautenticación del servicio web que envía el mensaje SOAP.

Nombre de usuario Escriba un nombre de usuario para autenticar la transmisión.

Contraseña Escriba una contraseña para autenticar la transmisión.

Una vez habilitada, todas las solicitudes del cliente para esta actividad deben contener las mismascredenciales en el encabezado de solicitud (definidas por el perfil de token de nombre de usuario deseguridad de los servicios web) para obtener acceso a la actividad o proceso:

<SOAPENV:header><wsse:Security xmlns:wsse="{WS-Security Schema}">

<wsse:UsernameToken><wsse:Username>{username}</wsse:Username><wsse:Password Type="wsse:PasswordText">{password}

</wsse:Password></wsse:UsernameToken>

</wsse:Security></SOAPENV:header>

6. Seleccione Habilitar MTOM (transmisión de mensajes y mecanismo de optimización) parapermitir que el sistema optimice cualquier anexo al enviar la respuesta.

7. Si ha definido las entradas del servicio web desde Datos de proceso, vaya al paso 10. De locontrario, haga clic en Siguiente.

8. En la pantalla Asignación de mensaje de entrada, asigne los atributos del mensaje SOAP entrante(Origen) a los datos de proceso (Destino) y haga clic en Siguiente.

Asigne el contenido y el formato de archivo de los datos adjuntos. Si tiene varios anexos, puedehacer clic en Agregar en el nodo Anexo para agregar más anexos.

9. En la pantalla Asignación de mensaje de salida, asigne los datos de proceso (Origen) a larespuesta SOAP saliente (Destino).


Una vez que la aplicación se implementa, Process Integrator crea los oyentes de entrada del servicioweb. Estos son los formatos URL válidos para acceder al WSDL.

http://<hostname>:<port>/bps/webservice/<processID>?WSDLhttp://<hostname>:<port>/bps/webservice/<processName>?WSDLhttp://<hostname>:<port>/bps/webservice/<processName>/<version>?WSDL

Configurar una actividad Esperar al servicio web1. En las Propiedades de proceso del modelo de proceso, en la pestaña Avanzado, configure el URI

del espacio de nombres de destino.

2. Arrastre y suelte la actividad Esperar al servicio web en el lienzo.




4. En la pestaña Esperar al servicio web, especifique la información de entrada del servicio webtal y como se describe en la tabla siguiente:

Campo Descripción

Definir según Seleccione si desea definir las entradas del servicio web desdeDatos de proceso o un Servicio web existente.

Si selecciona Datos de proceso, el sistema no requiere laasignación de datos y conjunto de correlación puesto que lasasignación están implícitas.

URL de WSDL Si selecciona Servicio web existente, escriba la dirección URLpara el WSDL (lenguaje de descripción de servicios web) quese utiliza para la actividad y haga clic en Leer para recuperar elWSDL desde la ubicación especificada.

Tipo de puerto Si selecciona Datos de proceso, escriba el nombre para el tipo depuerto de WSDL. De lo contrario, seleccione un tipo de puertoen la lista desplegable.

Operación Si selecciona Datos de proceso, escriba un nombre para laoperación de WSDL. De lo contrario, seleccione una operaciónen la lista desplegable.

Conjunto de correlación Si selecciona Datos de proceso, puede seleccionar esta opciónpara usar conjuntos de correlación para la correlación de mensajes.

Si selecciona un Servicio web existente, puede configurar losconjuntos de correlación en el paso 11.

Puede utilizar ID de correlación, conjuntos de correlación o ambos.El paso 13 explica cómo agregar un ID de correlación.


Campo Descripción

Habilitar autenticación WS-Security Seleccione esta opción para requerir las credenciales deautenticación del servicio web que envía el mensaje SOAP.

Nombre de usuario Escriba un nombre de usuario para autenticar la transmisión.

Contraseña Escriba una contraseña para autenticar la transmisión.

Una vez habilitada, todas las solicitudes del cliente para esta actividad deben contener las mismascredenciales en el encabezado de solicitud (definidas por el perfil de token de nombre de usuario deseguridad de los servicios web) para obtener acceso a la actividad o proceso:

<SOAPENV:header><wsse:Security xmlns:wsse="{WS-Security Schema}">

<wsse:UsernameToken><wsse:Username>{username}</wsse:Username><wsse:Password Type="wsse:PasswordText">{password}

</wsse:Password></wsse:UsernameToken>

</wsse:Security></SOAPENV:header>



6. Seleccione Habilitar MTOM (transmisión de mensajes y mecanismo de optimización) parapermitir que el sistema optimice cualquier anexo al enviar la respuesta.

7. Si ha definido las entradas del servicio web desde Datos de proceso, vaya al paso 12. De locontrario, haga clic en Siguiente para mostrar la herramienta de asignación de datos de procesos.

8. En la pantalla Asignación de mensaje de entrada, asigne los atributos del mensaje SOAP entrante(Origen) a los datos de proceso (Destino) y haga clic en Siguiente.

Asigne el contenido y el formato de archivo de los datos adjuntos. Si tiene varios anexos, puedehacer clic en Agregar en el nodo Anexo para agregar más anexos.

9. En la pantalla Asignación de mensaje de salida, asigne los datos de proceso (Origen) a larespuesta SOAP saliente (Destino).

10. Si va a utilizar los conjuntos de correlación, haga clic en Siguiente. De lo contrario, vaya al paso 13.11. En la pantalla Asignación de conjunto de correlación, en el campo Seleccionar conjunto,

seleccione un conjunto de correlación en la lista desplegable. Mediante la función Copiar, asigneatributos de mensaje SOAP (Origen) a variables de conjunto de correlación.

12.Haga clic en Aceptar.13. Para habilitar la correlación de mensajes mediante un ID de correlación, agregue el ID de

correlación al encabezado SOAP en el formato definido por el estándar de Direccionamiento deservicios web, tal y como se indica en el ejemplo siguiente:

<SOAPENV:header><wsa:RelatesTo xmlns:wsa="{WS-AddressingSchema}">{correlationid}

</wsa:RelatesTo></SOAPENV:header>

Una vez que la aplicación se implementa, Process Integrator crea los oyentes de entrada del servicioweb. Estos son los formatos URL válidos para acceder al WSDL.

http://<hostname>:<port>/bps/webservice/<processID>?WSDLhttp://<hostname>:<port>/bps/webservice/<processName>?WSDLhttp://<hostname>:<port>/bps/webservice/<processName>/<version>?WSDL

Configurar una actividad Publicar documento1. Arrastre y suelte la actividad Publicar documento en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña xPression Configuration (Configuración de xPression), configure la actividad


Campo Descripción

Punto final Seleccione o cree un punto final del servidor xPression para laactividad.

Categoría Seleccione una categoría de documento de xPression.

Documento Seleccione un objeto de contenido que pertenezca a la categoríaseleccionada.

Perfil de salida Seleccione un perfil de salida para publicar el contenido.




5. En la pantalla Asignación de mensaje de entrada, asigne los datos de proceso a las variablesdel documento de entrada:

• Asigne todas las variables requeridas por el servidor de xPression para completar el serviciode publicación. En tiempo de ejecución, las variables se sustituyen por datos de proceso en eldocumento generado.

• En los documentos de xDesign, solo aparecen en el asignador las variables utilizadas en eldocumento. Asegúrese de que la clave principal esté asignada.

• Si fuera necesario, agregue atributos o elementos a algunos de los datos para completar lasasignaciones.

la validación de datos no se admite en la plantilla de actividad Documento de Publish. Asegúresede que todos los datos en tiempo de ejecución son válidos.


7. En la pantalla Asignación de mensaje de salida, asigne el documento de salida a un paquete o undato adjunto cuando el perfil de documento proporciona un documento de salida.

Los atributos siguientes deben asignarse a los datos de proceso:

• formato: este es el tipo de formato definido en el perfil de salida. Por ejemplo, si el perfil desalida está definido para que se publique un archivo PDF, este atributo se debe asignar al formatode paquete o dato adjunto correspondiente.

• datos: este es el documento generado. Se debe asignar al atributo correspondiente de unpaquete o un anexo.


Configurar una actividad Documento de publicaciónavanzado1. Arrastre y suelte la actividad Documento de publicación avanzado en el lienzo.


3. En la pestaña xPression Configuration (Configuración de xPression), configure la actividadtal y como se describe en la tabla siguiente:

Campo Descripción

Punto final Seleccione o cree un punto final del servidor xPression para la actividad.

Categoría Seleccione una categoría de documento de xPression.

Documento Seleccione un objeto de contenido que pertenezca a la categoría seleccionada.



Campo Descripción

Perfil de salida Seleccione un perfil de salida para publicar el contenido.

XML de datos decliente

Escriba el XML que crea las asignaciones para constantes y agrega las variables paralos valores dinámicos.

En los documentos de xPression, la información acerca del cliente que contieneeste XML sirve para personalizar el contenido durante el proceso de publicación.El XML de este cuadro de texto debe estar formado por texto estático, junto convariables para el contenido dinámico que asigne.

• Las variables llevan delante un símbolo de dólar $ (por ejemplo, $streetaddress).

• Utilice dos signos de dólar $$ para crear variables con varios valores.

• Para utilizar un símbolo de dólar literal, utilice\$ (por ejemplo, quinientos dólaresse expresarían como \$500.00).

las variables deben ser caracteres alfanuméricos sin espacios. La variable empiezadespués del símbolo de dólar $ y termina con el primer carácter no alfanumérico.

Como las variables deben ser cadenas de texto, los valores de hora y fecha se debenconvertir a ese tipo con la función DateToString del asignador de datos. (El formatode fecha que procede de los datos de proceso y el formato de fecha de XSD queespera el servidor de xPression pueden ser diferentes.)

El sistema requiere los siguientes formatos para las conversiones de hora y fechade XSD:

• fecha: aaaa-mm-dd

• hora y fecha: aaaa-mm-dd’T’HH:mm:ss.SSSZ

• hora: HH:mm:ss.SSS

Código de ejemplo de XML de datos de cliente, página 187 proporciona un ejemplo.

La validación de datos no se admite en la plantilla de actividad Documento depublicación avanzado. Asegúrese de que todos los datos en tiempo de ejecución sonválidos.


5. En la pantalla Asignación de mensaje de entrada, asigne los datos de proceso a las variables deldocumento de entrada que eran valores de marcador de posición en el XML:

• Cree asignaciones para las variables proporcionadas en el cuadro de texto XML de datos decliente.

• Si fuera necesario, agregue atributos o elementos a algunos de los datos para completar lasasignaciones.

los valores constantes agregados mediante el cuadro de texto XML de datos de cliente no aparecenen el asignador de datos.


7. En la pantalla Asignación de mensaje de salida, asigne el documento de salida a un paquete o undato adjunto cuando el perfil de documento proporciona un documento de salida.

Los atributos siguientes deben asignarse a los datos de proceso:



• formato: este es el tipo de formato definido en el perfil de salida. Por ejemplo, si el perfil desalida está definido para que se publique un archivo PDF, este atributo se debe asignar al formatode paquete o dato adjunto correspondiente.

• datos: este es el documento generado. Se debe asignar al atributo correspondiente de unpaquete o un anexo.


Configurar una actividad de ciclo de vida1. Arrastre y suelte la actividad Ciclo de vida en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Ciclo de vida, especifique la información del ciclo de vida tal como se describe


Campo Descripción

Funcionamiento del ciclo de vida Seleccione una de las siguientes opciones:

• Promover: avanza el objeto al estadoespecificado en el asignador de entrada.

• Degradar: devuelve el objeto de su estadonormal actual al estado normal anterior.

• Suspender: detiene temporalmente elavance de un objeto por los estados del ciclode vida asignado.

• Reanudar: reanuda el objeto que estabamarcado como en estado de ciclo de vidaen pausa.

4. Haga clic en Siguiente.5. En la pestaña Ciclo de vida, asigne datos del proceso (origen) al atributo del ciclo de vida (destino):

a. En el área Origen de la pantalla Asignación de mensaje de entrada, asigne el ID de objeto delos objetos que desee actualizar con ciclos de vida al atributo Elementos del área Destino.

b. Para aplicar un ciclo de vida al objeto, asigne un atributo booleano con un valor True al atributoEstado en el área Destino.

c. Establezca Anular comprobaciones de entrada con True para forzar la promoción del objeto,independientemente de cualquier otra condición.


Configurar una actividad de aplicar ciclo de vida1. Arrastre y suelte la actividad Aplicar ciclo de vida en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de actividad.3. En la pestaña Ciclo de vida, especifique la información del ciclo de vida tal como se describe




Campo Descripción

Ciclo de vida Seleccione el parámetro de aplicación para un ciclode vida.

Alcance Indique el alcance del ciclo de vida.

Estado inicial Identifica la posición del estado o el estado del ciclode vida asociado con el objeto.


5. En la pestaña Ciclo de vida, asigne datos del proceso (origen) al atributo del ciclo de vida (destino):

a. En el área Origen de la pantalla Asignación de mensaje de entrada, asigne el ID de objeto delos objetos que desee actualizar con ciclos de vida al atributo Elementos del área Destino.


Conceptos

Actividades de proceso

Las actividades de proceso representan las tareas realizadas en un proceso de negocio. Un modelode proceso contiene las siguientes actividades:

• Actividades de inicio: las actividades que inician el proceso.

• Actividad de finalización: la última actividad del proceso. Un modelo de proceso solo puedetener una actividad de finalización.

• Actividades por pasos: las actividades intermedias entre las actividades de inicio y la actividad definalización. Un modelo de proceso puede tener un número ilimitado de actividades por pasos.

Cada modelo de proceso consta de al menos una actividad de inicio, al menos de una actividad porpasos y de una actividad de finalización. Al crear un modelo de proceso, el sistema agrega lasactividades de inicio y finalización. Puede agregar actividades de inicio y por pasos adicionalesal modelo de proceso.

Actividades del sistema y manuales

Las actividades pueden ser manuales o del sistema. Una actividad manual la realizan uno o variosusuarios. El sistema realiza una actividad de sistema en nombre de un usuario.

Utilice las actividades manuales para crear tareas (elementos de trabajo) para los usuarios finales.Puede colocar estas tareas en la bandeja de entrada de un usuario final o un grupo. También puedecolocar las tareas en una cola de trabajos. Los usuarios pueden seleccionar las tareas que deseanrealizar en la cola de trabajos. Estas tareas contienen los paquetes y las instrucciones necesariospara completar la tarea.

En la tabla siguiente se describen las actividades manuales:



Icono Actividad manual Descripción

Tarea manual Utilice la actividad Tarea manual para crear una tarea para unapersona o varios ejecutores.

Tarea de cola de trabajos Utilice la actividad Tarea de cola de trabajos para crear una tarea yasociarla con una cola de trabajos.

Actividades de integraciónLas actividades de integración se comunican con sistemas externos usando un protocolo concreto.

Las actividades de integración se describen en la tabla siguiente:

Icono Actividad deintegración

Descripción

Actividad que llama a lalógica de integración.

Estas actividades, de forma sincrónica, llaman a la lógica deintegración y continúan con el flujo del proceso.

Actividad que inicia unproceso en función deuna comunicación deintegración.

Estas actividades esperan un mensaje de una integración. Se iniciaun nuevo proceso cuando la actividad recibe el mensaje.

Actividad que detieneun proceso y esperahasta que recibe unacomunicación deintegración.

Estas actividades esperan un mensaje de una integración. Cuando laactividad recibe el mensaje, se correlaciona con un proceso existentey el proceso se desencadena para continuar con su flujo actual.

Correlación de mensajes, página 115 proporciona informaciónadicional.

Definición de actividadLa definición de actividad se encuentra en el Inspector de actividad. Describe las característicasde la actividad, incluyendo:

• La forma de ejecución de la actividad• El ejecutor del trabajo• Cómo se asigna el ejecutor• Cuándo se inicia una actividad con varios flujos entrantes• Qué desencadenadores son necesarios• Cuál es el comportamiento de transición cuando la actividad se completa

Asimismo, las actividades también pueden presentar características específicas del tipo de tarea querepresentan. Por ejemplo, una actividad que envía contenido a un proveedor externo puede incluirun atributo con la dirección de correo electrónico del proveedor.

El marco de BPM gestiona internamente la finalización del elemento de trabajo cuando ejecuta lasactividades automáticas en un proceso. Si el método del flujo de trabajo personalizado o el servicio deJava tienen la lógica para gestionar la finalización o la limpieza del elemento de trabajo, no tendráque gestionar las transiciones del elemento de trabajo o las operaciones del flujo de trabajo. De locontrario, esto podría provocar excepciones al ejecutarse.



Determinar las actividades que se van a utilizar

Utilice las siguientes tablas para determinar qué actividades desea agregar a su modelo de proceso.

Para iniciar un proceso, utilice las actividades Iniciar que se describen en la tabla siguiente:

Actividad Descripción

Iniciar Inicia un proceso. El sistema añade esta actividad de inicio almodelo de proceso, pero puede añadir otras actividades de inicio.

Iniciar desde la base de datos

Configurar una actividad Iniciar desdela base de datos, página 134

Inicia un proceso cuando una consulta de lectura de SQL en la basede datos devuelve resultados. Después de recibir los resultados, laactividad procesa los datos tal y como se especifica en la actividad.

Iniciar desde el repositorio

Configurar una actividad Iniciar desdeel repositorio, página 138

Inicia un proceso cuando una consulta de lectura de DQL en elrepositorio devuelve resultados. Después de recibir los resultados, laactividad procesa los objetos tal y como se especifica en la actividad.

Iniciar desde correo electrónico

Configurar una actividad Iniciar desdecorreo electrónico, página 142

Inicia un proceso cuando llega un mensaje de correo electrónico enuna bandeja de entrada.

Iniciar un proceso cuando se recibe un mensaje de correo electrónico,página 183 proporciona información adicional.

Iniciar desde FTP

Configurar una actividad Iniciar desdeFTP, página 148

Inicia un proceso cuando un archivo o directorio aparece en unacarpeta supervisada de un servidor FTP.

Iniciar desde HTTP

Configurar una actividad Iniciar desdeHTTP, página 151

Inicia un proceso tras la recepción de una solicitud HTTP. Estaactividad también puede enviar un mensaje de respuesta HTTP alremitente de la solicitud entrante.

Iniciar un proceso cuando se recibe una solicitud HTTP, página 184proporciona un ejemplo.

Iniciar desde JMS

Configurar una actividad Iniciar desdeJMS, página 156

Inicia un proceso cuando un tema o cola de JMS recibe un mensajede JMS.

Iniciar un proceso cuando se recibe un mensaje de JMS, página 185proporciona un ejemplo.

Iniciar desde servicio web

Configurar una actividad Iniciar desdeservicio web, página 160

Inicia un proceso cuando un servicio web del entorno deimplementación recibe un mensaje SOAP (Protocolo de acceso deobjeto simple).

Iniciar un proceso cuando se recibe un mensaje SOAP, página 187proporciona un ejemplo.

Para interactuar con el flujo entrante, añada actividades por pasos tal y como se describe en la tablasiguiente:


Crear

Configurar una actividad Crear, página128

Cree un objeto en el repositorio, como una carpeta, un objeto denegocio o un objeto de contenido. También puede crear un objetocopiando un objeto existente.




Crear ACL

Configurar una actividad Crear ACL,página 129

Utilice la actividad Crear ACL para crear un objeto ACL deDocumentum a partir de un conjunto de permisos.

Editar permisos

Configurar una actividad Editarpermisos, página 130

Utilice la actividad Editar permisos para cambiar el acceso a losobjetos para un usuario final o un grupo en tiempo de ejecución.

Cambiar el acceso de los usuarios finales a los objetos, página 182proporciona información adicional.

Mover

Configurar una actividad Mover,página 131

Mueve un conjunto de objetos a una carpeta o crea un acceso directoen esa carpeta.

Definir los datos de proceso

Configurar una actividad Definir losdatos de proceso, página 132

Modifica los datos de proceso a medida que fluyen entre otras dosactividades.

Llamar al procedimiento de la base dedatos

Configurar una actividad Llamar alprocedimiento de la base de datos ,página 132

Se conecta a una base de datos externa y ejecuta un procedimiento ofunción almacenado.

Llamar al procedimiento de la base de datos, página 182 proporcionainformación adicional.

Leer desde la base de datos

Configurar una actividad Leer desde labase de datos, página 133

Se conecta a una base de datos externa y devuelve los resultados deuna instrucción SQL Select. También admite la lectura de contenidode una base de datos para un paquete, con los datos de tipo BLOB enOracle o de tipo Bytes en Microsoft SQL Server.

Leer desde la base de datos , página 182 proporciona informaciónadicional.

Esperar a la base de datos

Configurar una actividad Esperar a labase de datos, página 135

Detiene un proceso hasta que una consulta de lectura de SQL en labase de datos devuelve resultados. La actividad consulta la base dedatos a intervalos determinados. Después de recibir los resultados, laactividad procesa los datos tal y como se especifica en la actividad.

Escribir en la base de datos

Configurar una actividad Escribir enbase de datos, página 136

Se conecta a una base de datos externa y ejecuta una instrucción SQLInsert, Update o Delete. También es compatible con el intercambiode contenido de paquetes a los parámetros de bases de datos. Esdecir, se pueden insertar o actualizar datos binarios o BLOB desdeun paquete a la base de datos.

Escribir en la base de datos , página 183 proporciona informaciónadicional.

Leer desde el repositorio

Configurar una actividad Leer desde elrepositorio, página 137

Lee desde un repositorio de Documentum.

Esperar al repositorio

Configurar una actividad Esperar alrepositorio, página 139

Detiene un proceso hasta que una consulta de lectura de DQL en elrepositorio devuelve resultados. La actividad consulta la base dedatos a intervalos determinados. Después de recibir los resultados, laactividad procesa los objetos tal y como se especifica en la actividad.




Escribir en el repositorio

Configurar una actividad Escribir en elrepositorio, página 140

Escribe en un repositorio de Documentum.

Enviar correo electrónico

Configurar una actividad Enviar correoelectrónico , página 141

Envía mensajes de correo electrónico a listas de uno o más usuarios.

Actividad Enviar correo electrónico, página 183 proporcionainformación adicional.

Esperar al correo electrónico

Configurar una actividad Esperar alcorreo electrónico, página 144

Detiene un proceso hasta que llega un mensaje de correo electrónicoen una bandeja de entrada.

Descargar desde FTP

Configurar una actividad Descargardesde FTP , página 147

Transfiere archivos desde un servidor FTP a la aplicación.

Subir vía FTP

Configurar una actividad Subir vía FTP, página 148

Transfiere los archivos a un servidor FTP.

Esperar a FTP

Configurar una actividad Esperar aFTP, página 149

Detiene un proceso hasta que un archivo o directorio aparece en unacarpeta supervisada de un servidor FTP.

Enviar solicitud HTTP

Configurar una actividad Enviarsolicitud HTTP o RESTful, página 150

Envía las solicitudes HTTP GET, PUT o POST a un servidor web yrecibe las respuestas del servidor web.

Esperar a HTTP

Configurar una actividad Esperar aHTTP, página 153

Detiene un proceso hasta que la actividad recibe una solicitud HTTP.Esta actividad también puede enviar un mensaje de respuesta HTTPal remitente de la solicitud entrante.

Ejecutar servicio de Java

Configurar una actividad Ejecutarservicio de Java, página 154

Añade código personalizado al modelo de proceso.

En Ampliar la funcionalidad del proceso, página 185 y Ejemplode ampliación de la funcionalidad de proceso, página 154 seproporciona información adicional.

Enviar mensaje JMS

Configurar una actividad Enviarmensaje de JMS , página 155

Envía datos de texto, binarios o de transmisión a un servidor deservicio de mensajes de Java (JMS).

Esperar a JMS

Configurar una actividad Esperar aJMS, página 156

Detiene un proceso hasta que un tema o cola de JMS recibe unmensaje de JMS.

Llamar a servicio web

Configurar una actividad Llamar aservicio web , página 157

Obtiene datos procedentes de un servicio web basado en SOAP. Estaactividad admite servicios web seguros y no seguros.

Llamar a servicio web, página 185 proporciona informaciónadicional.




Esperar al servicio web

Configurar una actividad Esperar alservicio web, página 161

Detiene un proceso hasta que un servicio web en el entorno deimplementación recibe un mensaje SOAP.

Publicar documento

Configurar una actividad Publicardocumento, página 163

Genera un nuevo documento de Document Sciences xPressionmediante xPression Server.

Usar Document Sciences xPression, página 187 proporcionainformación adicional.

Documento de publicación avanzado

Configurar una actividad Documentode publicación avanzado, página 164

Proporciona las mismas funciones que Publicar documento pero, enlugar de utilizar el asignador de datos para asignar cada variable,puede utilizar los datos de cliente XML.

Usar Document Sciences xPression, página 187 proporcionainformación adicional.

Adjuntar fragmento de tipo

Configurar una actividad para adjuntarun fragmento de tipo, página 103

Adjunta un fragmento de tipo a un paquete de proceso o a un objeto.

Fragmento de tipo, página 93 proporciona información adicional.

Separar fragmento de tipo

Configurar una actividad para separarun fragmento de tipo, página 104

Separa un fragmento de tipo de un paquete de proceso o de un objeto.

Fragmento de tipo, página 93 proporciona información adicional.

Para crear las tareas para los usuarios finales, agregue actividades manuales tal y como se describeen la tabla siguiente:


Tarea manual

Configurar tareas de actividadesmanuales, página 119

Crea una tarea para una persona o varios ejecutores. Esta actividades una actividad manual.

En Configurar los ejecutores de una actividad manual, página 120y Determinar qué ejecutor de tarea se va a utilizar, página 173 seproporciona información adicional.

Tarea de cola de trabajos

Configurar tareas de actividadesmanuales, página 119

Crea una tarea y la asocia a una cola de trabajos. Esta actividades una actividad manual.

Configurar una cola de trabajos para una tarea, página 125proporciona información adicional.

Para realizar la ejecución de los flujos del proceso, utilice las actividades que se describen en latabla siguiente:


Llamar proceso

Configurar una actividad Llamarproceso, página 146

Inicia un subproceso.

Llamar a un proceso, página 184 proporciona información adicional.




Llamar a un proceso sin estado

Configurar una actividad Llamar a unproceso sin estado, página 146

Inicia un proceso sin estado. El ejecutor de la actividad Llamar aun proceso sin estado ejecuta todas las actividades de proceso sinestado. Anula el ejecutor configurado en la pestaña Ejecución de lasactividades automáticas.

Procesos sin estado, página 110 proporciona información adicional.

Decision Split (División de la decisión) Muestra explícitamente puntos de decisión en el modelo de procesode negocio. Esta actividad divide el flujo del proceso en varios flujos.

Grupo

Agrupar actividades de proceso, página190

Añade un grupo al modelo de proceso. Los grupos permitenorganizar y simplificar modelos de proceso complejos.

Organizar actividades de proceso en grupos, página 206 proporcionainformación adicional.

Unir Combina dos flujos de un proceso en un único flujo.

Flujos paralelos, página 204 proporciona información sobre lasuniones inteligentes.

Flujo paralelo

Configurar una actividad de flujoparalelo, página 190

Añade un flujo paralelo al modelo de proceso. Utilice un flujoparalelo cuando no se pueda determinar el número exacto de flujosde entrada para una actividad Unir hasta el tiempo de ejecución.

Flujos paralelos, página 204 proporciona información adicional.

Señalar proceso principal

Configurar una actividad Señalarproceso principal, página 147

Envía una señal a un proceso principal para que se active unaactividad.

Usar una señal para desencadenar un proceso principal, página 184proporciona información adicional.

Determinar qué ejecutor de tarea se va a utilizar

Una definición de actividad incluye la información que permite al sistema determinar el ejecutorde la actividad. Las actividades manuales tienen varias opciones para los ejecutores mientras quelas actividades del sistema deben identificar un usuario cuyos permisos se utilizan para ejecutar lasecuencia de comandos o programa.

Cuando se inicia una actividad manual en tiempo de ejecución, el sistema agrega una tarea a la bandejade entrada del usuario final o los usuarios finales designados como ejecutores de esa actividad. Parael procesamiento de gran volumen, puede agregar la tarea a una cola de trabajos utilizada por variostrabajadores.

Los participantes en un proceso tienen la opción de aparecer como no disponibles para realizar tareas.Si el usuario final seleccionado como ejecutor no está disponible, el motor del proceso intenta asignarel elemento de trabajo al usuario delegado para dicho usuario final.

La tabla siguiente enumera las categorías entre las que se puede elegir al ejecutor. Solo las primerascuatro opciones están disponibles para las actividades del sistema.



Ejecutor Cómo recupera el sistema ejecutores

Supervisor del flujo de trabajo El sistema selecciona al usuario designado como supervisordel flujo de trabajo cuando se inicia la actividad. De formapredeterminada, el usuario que inicia el proceso es el supervisor.

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

Ejecutor de la última actividad El sistema selecciona al ejecutante de la anterior actividadfinalizada que cumplió la condición de desencadenamiento de laactividad actual. El Ejecutor de la última actividad es un aliaspara el usuario que ha realizado la última actividad. Puede incluirvarios ejecutores y los usuarios de otras actividades anteriores.No se conoce este ejecutor hasta el tiempo de ejecución, ya que elejecutor puede proceder de un grupo.

Seleccionar el ejecutor de la última actividad para realizar unaactividad manual, página 121 proporciona información adicionalpara las actividades manuales.

Usuario del Parámetro Se seleccionan parámetros de aplicación para definir losmarcadores de posición para los usuarios que se determinan entiempo de ejecución. Los usuarios seleccionados de parámetrosde aplicación se pueden completar por cualquier usuario en unentorno.

Seleccionar un usuario de los parámetros de aplicación pararealizar una actividad del sistema, página 128 proporcionainformación adicional para las actividades del sistema.

Seleccionar usuarios de los parámetros de aplicación para realizaruna actividad manual, página 122 proporciona informaciónadicional para las actividades manuales.

Usuario de los datos de proceso Se seleccionan usuarios de datos de proceso utilizando atributosde paquete o variables. El sistema recupera el usuario de lasvariables o atributos dinámicos que seleccione en la actividadmanual actual.

Seleccionar un usuario de los datos de proceso para realizar unaactividad manual, página 122 proporciona información adicional.

Usuario de conjunto de alias Se seleccionan alias de conjuntos de alias como marcadores deposición para usuarios. El sistema recupera el usuario a partirdel valor de alias utilizando el objeto de conjunto de alias delrepositorio.

Seleccionar un usuario de un conjunto de alias para realizar una

actividad manual, página 122 proporciona información adicional.

Rol de aplicación El sistema recupera el rol que seleccione y lo considera comouna sola entidad al enviar las tareas. Los roles de aplicaciónson grupos de usuarios de una aplicación que realizan la mismafunción de negocio.

Seleccionar un rol de aplicación para realizar una actividadmanual, página 123 proporciona información adicional.



Ejecutor Cómo recupera el sistema ejecutores

Grupo del Parámetro Se seleccionan parámetros de aplicación para definir losmarcadores de posición para grupos que se determinan entiempo de ejecución. Un grupo seleccionado en un parámetrode aplicación se puede rellenar mediante cualquier grupo de unentorno.

Seleccionar un grupo de los parámetros de aplicación para realizaruna actividad manual, página 123 proporciona informaciónadicional.

Agrupar por datos de proceso Se selecciona un grupo de datos de proceso utilizando losatributos de paquete o variables. El sistema recupera el grupo delas variables o atributos dinámicos que seleccione en la actividadmanual.

Seleccionar un grupo de datos de proceso para realizar unaactividad manual, página 123 proporciona información adicional.

Grupo de conjunto de alias Se seleccionan alias de conjuntos de alias como marcadoresde posición para grupos. El sistema recupera el grupo a partirdel valor de alias utilizando el objeto de conjunto de alias delrepositorio.

Seleccionar un grupo de un conjunto de alias para realizar unaactividad manual, página 124 proporciona información adicional.

Ejecutor de la actividad anterior El sistema recupera el ejecutor o ejecutantes de cualquieractividad anterior que seleccione en la actividad manual actual.Puede seleccionar cualquier actividad manual con una conexiónentrante a la actividad manual. El Ejecutor de la actividad anteriorno está disponible para su uso como un ejecutor condicional.

Seleccionar el ejecutor de la actividad anterior para una actividadmanual, página 124 proporciona información adicional.

Usar colas de trabajos para el procesamiento detareasUna cola de trabajos es una lista de tareas a la que varios usuarios finales pueden tener acceso. Losprocesadores disponibles asignados a una cola de trabajos realizan las tareas.

Una cola de trabajos habilita el flujo de trabajo de manera más eficiente en situaciones en las queel volumen de tareas y la necesidad de procesamiento rápido son altos. Por ejemplo, un centro deprocesamiento de préstamos que tiene aplicaciones para varios tipos de préstamos con diferentesrequisitos de procesamiento es un buen ejemplo para las colas de trabajos. Puede crear colas paradistintos propósitos, lo que le permite administrar y equilibrar la carga de trabajo de la organización.

El sistema asigna una tarea a una cola de trabajos en función de las propiedades de la tarea y la cola detrabajos. Los procesadores asignados para trabajar en una cola reciben las tareas en sus bandejas deentrada por orden de prioridad. El administrador de cola también puede asignar manualmente unatarea a un usuario concreto. Los procesadores con el rol queue_advance_processor pueden extraer deforma selectiva las tareas de la cola independientemente de la prioridad. No tiene que esperar pararecibir tareas en su bandeja de entrada.



Roles de colas de trabajos

Los usuarios finales de la cola de trabajos se denominan procesadores. Los procesadores pueden tenerdos roles: queue_processor y queue_advance_processor.

Los procesadores con el rol queue_processor no pueden examinar las colas de trabajos. Se puedeelegir que el sistema envíe automáticamente la siguiente tarea cuando su cola está vacía, o bien puedensolicitar la siguiente tarea manualmente. A continuación, el sistema asigna al procesador la siguientetarea de mayor prioridad de entre las colas de trabajos de ese procesador.

Solo los procesadores con el rol queue_advance_processor pueden ver y acceder a las tareas de colasde trabajos en una lista de tareas de cola de trabajo. Un administrador de colas puede directamenteasignar una tarea a cualquier procesador.

En la tabla siguiente se describen los roles de colas de trabajos:

Rol Descripción

Queue_admin Crea colas de trabajos y directivas de colas, asigna los procesadorespara trabajar en las tareas de cola y define los perfiles de habilidades.Los perfiles de habilidades activan la aplicación para asignar tareas alprocesador adecuado. Los administradores de colas pueden agregar, editaro asignar perfiles a los procesadores de cola de trabajos individuales.

Los administradores de colas pueden ver tareas de colas de trabajos. Puedenver el nombre del procesador asignado a la tarea, el estado de la tarea, lahora de recepción de la tarea y la prioridad de la tarea actual.

Los miembros del rol queue_admin no tienen el rol de administrador deforma predeterminada.

Los administradores de colas que tengan privilegios para CREAR GRUPOSpueden crear colas de trabajos.

Queue_manager Supervisa las colas de trabajos para determinar qué colas presentan tareasatrasadas o demasiadas tareas. Los administradores de colas asignan losroles a las colas, y asignan a los usuarios el trabajo en tareas de colas.Los usuarios con este rol pueden volver a asignar tareas y suspenderlas.Asimismo, pueden agregar, editar y asignar perfiles de habilidades aprocesadores de colas de trabajos individuales.

Los administradores de colas pueden ver tareas de colas de trabajos. Puedenver el nombre del procesador asignado a la tarea, el estado de la tarea, lahora de recepción de la tarea y la prioridad de la tarea actual.

Los gestores de colas que tengan privilegios para CREAR GRUPOSpueden crear colas de trabajos.

Queue_processor Trabaja en tareas que el sistema asigna a partir de uno o más colas detrabajos. Los procesadores de colas puede solicitar trabajos, suspender yquitar la suspensión de trabajos, completar trabajos y reasignar su trabajoa otros.

Queue_advance_processor Trabaja en tareas que el sistema asigna a partir de uno o más colas detrabajos. Los procesadores de colas avanzados también pueden seleccionartareas en las que trabajar desde estas colas de trabajos.



Tareas de usuario final

Una tarea es un trabajo que requiere que un usuario final realice alguna acción. El proceso creatareas a través de una actividad de Tarea manual o una actividad de Tarea de cola de trabajos. Lasacciones disponibles para las tareas dependen del rol de la cola de trabajos del usuario final y laspropiedades de la tarea.

Acciones de Tarea manual

Las acciones de Tarea manual son las acciones que un usuario final puede realizar en una tarea manualen tiempo de ejecución.

La tabla siguiente describe las acciones de tarea manual:

Acción de tarea Descripción

Ver Va a la página de la tarea.

Adquirir Acepta una tarea de grupo que no está asignada. Una vez adquirida, no puedecompletarla otro usuario final.

Actualizar Actualiza los metadatos de la tarea sin finalizar la tarea.

Completo Finaliza la tarea.

Rechazar Finaliza la tarea y envía la tarea al flujo de rechazo. Esta acción solo está disponiblecuando está habilitada en la actividad de Tarea manual.

Delegar Guarda los datos de la tarea y envía la tarea a otro usuario final. Esta acción soloestá disponible cuando está habilitada en la actividad de Tarea manual.

Bloquear Pausa una tarea.

Quitar retención Elimina la retención de una tarea en pausa y la devuelve al estado correcto.

Detener Pausa una tarea indefinidamente.

Reanudar Reanuda una tarea detenida.

Repetir Finaliza la tarea y agrega ejecutores adicionales para trabajar en la tarea actual.Esta acción solo está disponible cuando está habilitada en la actividad de Tareamanual.

Acciones de Tarea de cola de trabajos

Las acciones de tarea de cola de trabajos son las acciones que un miembro de la cola de trabajos puederealizar en una tarea de cola de trabajos en tiempo de ejecución. Las acciones que pueden realizardependen de su rol de cola de trabajos. Roles de colas de trabajos describe cada uno de los rolesde colas de trabajos.

Estas acciones de tarea de cola de trabajos solo son relevantes en el contexto de una lista de tareas decola de trabajos. Un usuario final con el rol queue_processor no puede ver una lista de tareas de colade trabajos. Los procesadores de colas solo ven tareas en sus bandejas de entrada individuales.

La tabla siguiente describe las acciones de tarea de cola de trabajos disponibles en una lista de tareasde cola de trabajo y los roles de colas de trabajos necesarios para completar las acciones:



Acción de tarea Descripción Rol de la cola de trabajos

Ver Va a la página de la tarea. Procesador avanzado de la cola, gestorde la cola o administrador de la cola

Adquirir Acepta una tarea que no está asignada. Procesador avanzado de la cola, gestorde la cola o administrador de la cola

Actualizar Actualiza los metadatos de la tarea sinfinalizar la tarea.

Procesador avanzado de la cola, gestorde la cola o administrador de la cola

Completo Finaliza la tarea. Procesador avanzado de la cola, gestorde la cola o administrador de la cola

Rechazar Finaliza la tarea y envía la tarea al flujode rechazo.


Delegar Guarda los datos de la tarea y envía latarea a otro usuario final.


Bloquear Pausa una tarea. Gestor de cola o administrador de lacola

Quitar retención Elimina el bloqueo de una tarea enpausa.

Gestor de cola o administrador de lacola

Detener Pausa una tarea indefinidamente. Gestor de cola o administrador de lacola

Reanudar Reanuda una tarea detenida. Gestor de cola o administrador de lacola

Repetir Finaliza la tarea y agrega ejecutoresadicionales para trabajar en la tareaactual. Esta acción solo está disponiblecuando está habilitado en la actividad detarea de cola de trabajos.


Asignar Asigna una tarea a un miembro de lacola de trabajos.


Quitar asignación Coloca una tarea de vuelta en la cola detrabajos.


Reasignar Asigna la tarea a un usuario diferente enla cola de trabajos.


Obtener tarea siguiente Obtiene la tarea de mayor prioridad detodas las colas de trabajos asignadasde un procesador que coincide con lashabilidades del procesador.


Volver a la cola Devuelve una tarea a la cola de trabajos. Procesador avanzado de la cola, gestorde la cola o administrador de la cola

Cambiarcolade trabajos

Cambia la cola de trabajos de una tarea. Administrador de colas



Controlar menús contextuales para las listas detareas de usuario final

En tiempo de ejecución, el sistema genera automáticamente menús contextuales para las listas de tareasde usuario final en las páginas de aplicación. Cuando un usuario final hace clic con el botón secundarioen una tarea, aparecen las acciones del menú contextual. Las acciones del menú contextual para lasactividades manuales (tareas manuales y tareas de colas de trabajos) pueden variar en función de si sedefine una página de tarea en la aplicación. Si desea que los usuarios finales completen una tarea deuna lista, no defina una página de tarea para esa actividad manual.

En la siguiente tabla se muestran las acciones del menú contextual de la lista de tareas de una actividadmanual, si procede:

Página de tarea definida Acciones del menú contextual de la lista de tareas

Sí • Adquirir

• Ver

• Asignar

• Quitar asignación

• Reasignar

• Cambiar cola de trabajos

Si define una página de tarea, el usuario final puedever la tarea en la lista de tareas y completarla en estapágina.

No • Adquirir

• Completo

• Rechazar

• Repetir

• Delegar

• Asignar

• Quitar asignación

• Reasignar

• Cambiar cola de trabajos

Si, por el contrario, no define una página de tarea, elusuario final puede completar la tarea mediante elmenú contextual de la lista de tareas.

Adquisición automática:

En tiempo de ejecución, cuando se abre una tarea manual desde la lista de tareas, no se adquiere demanera automática. Para ello, debe hacer clic con el botón secundario en la opción Ver en el menúcontextual. Como alternativa, también puede adquirir la tarea manualmente. Vaya a la página detareas y haga clic en Adquirir.



Asociar conjuntos de habilidades de usuario final atareas de colas de trabajos

Los conjuntos de habilidades de la cola de trabajos determinan quién cumple los requisitos pararealizar una tarea de la cola de trabajos. Al crear una cola de trabajos, puede definir las habilidades ola experiencia necesarias para procesar las tareas en la cola de trabajos. El perfil de procesador deDocumentum Administrator permite asignar esas habilidades a los procesadores de colas de trabajos.Cuando un procesador obtiene la tarea siguiente o cuando un administrador asigna una tarea, el sistemadetermina si el procesador cumple los requisitos en función de las habilidades necesarias para latarea. Una tarea determinada asociada con una cola puede requerir una o más habilidades para podercompletarse. Un procesador puede tener varias habilidades relacionadas con una cola de trabajos.

Por ejemplo, la cola de trabajos loan_underwriter_queue (colas de asegurador de préstamos) tienetres habilidades necesarias definidas: préstamos para vehículos, préstamos comerciales y préstamosdomésticos. Cuando una aplicación de préstamos para vehículos entra en el proceso, el sistemaevalúa las habilidades definidas en la actividad del proceso y resuelve el valor de habilidad para unpréstamo para vehículos. A continuación, envía la aplicación de préstamos a loan_underwriter_queue.Cuando un supervisor asigna una tarea o un procesador intenta obtener una, el sistema garantizaque el procesador cuenta con la habilidad de préstamos para vehículos antes de permitir que esteadquiera la tarea.

No es necesario habilitar la coincidencia de conjunto de habilidades. Si no se definen las habilidadesde una cola de trabajos, el sistema no puede determinar la idoneidad de los procesadores en funciónde las habilidades. En ese caso, cualquier procesador de la cola de trabajos puede utilizar la acciónObtener tarea siguiente para realizar las tareas independientemente de sus aptitudes.

Es recomendable calcular una programación temporal de referencia de una lista de tareas antes deimplementar los conjuntos de habilidades. Este cálculo de referencia permite determinar cómo afectaal rendimiento la coincidencia de conjunto de habilidades. Es importante saber que los costes derendimiento aumentan a medida que crece el número de tareas de una lista.

Si se utilizan colas de trabajos y conjuntos de habilidades en el modelo de proceso, estos debenincluirse en el repositorio antes implementar la aplicación. Utilice Documentum Administratorpara definir las colas de trabajos y las habilidades en el repositorio. EMC Documentum ContentServer Administration and Configuration Guide (Guía de configuración y administración de EMCDocumentum Content Server) proporciona información adicional.

Descripción de los niveles de prioridad de tareas

Las tareas de actividades del sistema y manuales presentan niveles de prioridad que se puedenestablecer dentro de la actividad. Estos niveles de prioridad son bajo, medio y alto. Según el tipo detarea, estos niveles presentan diferentes funciones.

Las tareas de colas de trabajos pueden tener también un nivel de prioridad adicional: dinámico. Laprioridad dinámica utiliza un módulo de prioridad de tarea personalizado que permite especificar laprioridad de tarea inicial y la forma en que puede cambiar la prioridad en un proceso.

En la tabla siguiente se describen los niveles de prioridad disponibles para cada tipo de tarea:



Tarea Descripción de los niveles de prioridad

Sistema De forma predeterminada, el sistema ejecuta las tareasdel sistema en el orden de creación. El sistema utilizalos niveles de prioridad solo si Documentum ContentServer se ha configurado para usar las prioridadespara las actividades del sistema. EMC DocumentumxCelerated Composition Platform Deployment Guide(Guía de desarrollo de EMC Documentum xCeleratedComposition Platform) proporciona instruccionessobre cómo habilitar niveles de prioridad para lasactividades del sistema.

Manual Los procesadores pueden utilizar estos niveles paraasignar prioridad a sus tareas.

Cola de trabajos El sistema evalúa los niveles de prioridad bajo, medioy alto para distribuir las tareas a los usuarios finales.Los administradores de colas también pueden usarestos niveles de prioridad para distribuir tareas.

El sistema puede utilizar un módulo de prioridadpersonalizado dinámico para determinar la prioridaden lugar de utilizar los niveles bajo, medio y alto. Estepermite utilizar escenarios complejos de prioridady caducidad para definir y actualizar los niveles deprioridad. La prioridad dinámica se establece en elproceso en tiempo de ejecución en lugar de en laspropiedades de actividades.

Módulos de prioridad de tarea personalizados

Un módulo de prioridad de tarea personalizado permite crear escenarios complejos de inicializacióny caducidad para las tareas de colas de trabajos. Puede especificar la prioridad de tarea inicial, y lafrecuencia y el porcentaje en los que esta se incrementa en función de diferentes valores del módulo deprioridad.

Un módulo de prioridad contiene la lógica para calcular y actualizar la prioridad de forma dinámica enfunción de los datos de proceso u otros atributos que pertenezcan a dicho proceso. Por ejemplo, siuna aplicación de préstamos de un cliente preferido llega a una cola de trabajos, esta puede recibiruna prioridad mayor que las aplicaciones de otros clientes. Si la solicitud procede de un agente depréstamo preferido o por un importe de préstamo elevado, la prioridad puede aumentar a mayorvelocidad. También puede aumentar la prioridad de una tarea cuando se aproxima a una fecha límiteo debido a alguna otra restricción temporal. Este aumento de la prioridad provoca que la tarea subaposiciones en la cola a mayor velocidad.



Cambiar el acceso de los usuarios finales a losobjetosUtilice la actividad Editar permisos para cambiar el acceso a los objetos para un usuario final o ungrupo en tiempo de ejecución. La tabla siguiente describe los permisos básicos de la lista de control deacceso (ACL) que se pueden establecer:

Permiso básico Acceso

Ninguno No hay acceso al objeto.

Examinar Puede ver las propiedades del objeto, pero no el contenido del objeto.

Leer Puede ver el contenido y las propiedades del objeto.

Relacionar Puede agregar anotaciones al objeto (incluye los permisos Examinar y Leer).

Versión Puede modificar el contenido del objeto y registrarlo como una nueva versión delobjeto con un nuevo número de versión (incluye los permisos Examinar, Leer yRelacionar). Los usuarios finales no pueden sobrescribir una versión existente nieditar las propiedades del objeto.

Escribir Puede editar las propiedades del objeto y registrar el objeto con la misma versión(incluye los permisos Examinar, Leer, Relacionar y Versión).

Eliminar Puede eliminar objetos (incluye Examinar, Leer, Relacionar, Versión y Escribir).

Estos permisos básicos conceden o revocan la capacidad de acceso y manipulación con respecto a losatributos y el contenido de un objeto. Los niveles de permisos básicos son jerárquicos y cada nivel másalto de acceso incluye las capacidades de los niveles precedentes. Por ejemplo, un usuario final con elpermiso Relacionar tiene también los permisos Leer y Examinar.

Al cambiar los permisos, si existe el permiso para ese usuario final, el nuevo permiso reemplaza elpermiso existente para el objeto. Si agrega dos permisos para el mismo usuario final, el sistema aplicael permiso de mayor nivel.

Leer desde la base de datosUtilice la actividad Leer desde la base de datos para conectarse a una base de datos externa y devolverlos resultados de una instrucción SQL Select. También admite la lectura de contenido de una base dedatos para un paquete, con los datos de tipo BLOB en Oracle o de tipo Bytes en Microsoft SQL Server.

Los tipos de datos compatibles con los parámetros de la base de datos son: CHAR, VARCHAR,NVARCHAR, BIGINT, INTEGER, SMALLINT, TINYINT, BIT, DOUBLE, FLOAT, NUMERIC,DECIMAL, REAL, DATE, TIME, TIMESTAMP, BOOLEAN, BINARY, BLOB, LONGVARBINARYy VARBINARY.

Llamar al procedimiento de la base de datosUtilice la actividad Procedimiento de base de datos para conectar el sistema a una base de datos externay ejecutar una función o un procedimiento almacenados. La actividad devuelve los valores para losparámetros OUT e IN/OUT o el conjunto de resultados del procedimiento almacenado.



Los tipos de datos compatibles con los parámetros IN, OUT e IN/OUT son: CHAR, VARCHAR,NVARCHAR, BIGINT, INTEGER, SMALLINT, TINYINT, BIT, DOUBLE, FLOAT, NUMERIC,DECIMAL, REAL, DATE, TIME, TIMESTAMP, BOOLEAN, BINARY, BLOB, LONGVARBINARYy VARBINARY.

Escribir en la base de datosUtilice la actividad Escribir en la base de datos para conectarse a una base de datos externa y ejecutaruna instrucción SQL Insert, Update o Delete. También es compatible con el intercambio de contenidode paquetes a parámetros de bases de datos. Es decir, se pueden insertar o actualizar datos binarioso BLOB desde un paquete a la base de datos.

Los tipos de datos compatibles con los parámetros de la base de datos son: CHAR, VARCHAR,NVARCHAR, BIGINT, INTEGER, SMALLINT, TINYINT, BIT, DOUBLE, FLOAT, NUMERIC,DECIMAL, REAL, DATE, TIME, TIMESTAMP, BOOLEAN, BINARY, BLOB, LONGVARBINARYy VARBINARY.

Actividad Enviar correo electrónicoUtilice la actividad Enviar correo electrónico para enviar mensajes de correo electrónico a las listas deuno o más usuarios. Por ejemplo, puede enviar un correo electrónico de respuesta a la reclamación deun cliente o enviar un informe de gastos para su aprobación incluyéndolo en el cuerpo de un mensajede correo electrónico. La actividad Enviar correo electrónico le permite agregar adjuntos y tieneatributos que puede asignar para definir los valores de los encabezados de correo electrónico.

La actividad define los siguientes parámetros:

• Contenido del mensaje

• Dirección a la que se envía

• Servidor SMTP utilizado para enviar el correo electrónico

• Acción que se realiza con el correo electrónico de respuesta

Para mayor flexibilidad, el asunto y el cuerpo del mensaje pueden contener texto estático, así comovalores de marcador de posición que se pueden asignar para procesar datos. Además, el cuerpo delcorreo electrónico puede contener texto en formato HTML que se copia desde otro editor de HTML.

Tras configurar el asunto y cuerpo, utilice el asignador de datos para configurar el resto de detalles. Lainformación de mapa en el contexto del proceso de los atributos del mensaje tales como el remitentey los destinatarios. A continuación, asigne los artefactos del proceso, como paquetes y variables,al ID de mensaje de salida.

Iniciar un proceso cuando se recibe un mensaje decorreo electrónicoUtilice la actividad Iniciar desde correo electrónico para iniciar un proceso cuando llegue un mensajede correo electrónico a una bandeja de entrada. Por ejemplo, en un proceso de servicio al cliente, estaactividad sondea un servidor de correo electrónico e inicia un proceso cuando recibe un mensaje de



correo electrónico del cliente. El sistema puede enrutar el contenido del correo electrónico a través deuna actividad manual a un ejecutor que revisará el mensaje para ayudar al cliente.

La salida de la actividad Iniciar desde correo electrónico son datos de mensaje de correo electrónico.Los datos del mensaje de correo electrónico se asignan dentro de la actividad al modelo de datosdel proceso.

Llamar a un procesoUtilice la actividad Llamar proceso para invocar un proceso. Puede decidir si esta actividad espera aque finalice el proceso antes de continuar con la siguiente actividad dentro del proceso principal.

Tiene las siguientes opciones:

• La actividad Llamar proceso invoca el proceso y espera a que se complete. Una vez que el procesofinaliza, ya sea porque se ha completado o ha terminado, el proceso principal continúa con lasiguiente actividad. Los datos del proceso completado pueden asignarse de nuevo al procesoprincipal. Los datos de ejecución incluyen el atributo completed_sucessfully. Este atributo esverdadero si el proceso devuelve datos correctamente y falso si el proceso se anula o termina.

• La actividad Llamar proceso invoca el proceso y, a continuación, de forma inmediata, continúa conla siguiente actividad. Puesto que la actividad se completa antes que el proceso, la única informaciónque se puede asignar de nuevo al proceso principal es el ID del proceso.

Usar una señal para desencadenar un procesoprincipalPuede utilizar una señal para desencadenar una actividad en un proceso principal. Puede configurar laactividad en el proceso principal para que espere una señal procedente de un subproceso antes de quese inicie. Por ejemplo, un proceso principal puede orquestar varios subprocesos en diferentes estadosde progreso. Cada subproceso puede enviar una señal al proceso principal con una actualización deestado. Estos señales desencadenan una actividad en el proceso principal y proporcionan informaciónde estado acerca de todos los subprocesos.

Un proceso principal llama a un subproceso mediante una actividad Llamar proceso. Cualquieractividad por pasos del proceso principal puede entrar en pausa y esperar una señal procedente delsubproceso antes de iniciarse. El subproceso utiliza una actividad Señalar proceso principal para enviaruna señal al proceso principal, de forma que este pueda continuar.

Iniciar un proceso cuando se recibe una solicitudHTTPUtilice la actividad Iniciar desde HTTP para iniciar un proceso tras la recepción de una solicitudHTTP. Por ejemplo, en una aplicación de inmobiliaria, esta actividad podría iniciar un proceso despuésde recibir una solicitud HTTP con un documento hipotecario en el cuerpo del mensaje. El sistemapuede enrutar el contenido de la solicitud HTTP mediante una actividad manual a un ejecutor querevisará el documento hipotecario.



Esta actividad también puede enviar un mensaje de respuesta HTTP al remitente de la solicitudentrante. Por ejemplo, el proceso podría enviar una respuesta HTTP para confirmar que se ha recibidola solicitud de préstamo.

Ampliar la funcionalidad del procesoUtilice la actividad Ejecutar servicio de Java para ampliar la funcionalidad del proceso fuera de lasactividades de proceso estándar facilitadas por defecto. Puede trabajar con un desarrollador que cree elcódigo Java personalizado para proporcionar la funcionalidad ampliada. El desarrollador integra elcódigo en la aplicación como un módulo de Java y, a continuación, la funcionalidad ampliada pasa aestar disponible mediante la actividad Ejecutar servicio de Java.

Un proceso puede utilizar varias actividades Ejecutar servicio de Java para tener acceso a los métodoscorrespondientes desde cualquier de servicio de Java integrado en su aplicación. Antes de configurar laactividad Ejecutar servicio de Java, consulte con el desarrollador el nombre del servicio de Java y elnombre del método que proporciona la funcionalidad.

Iniciar un proceso cuando se recibe un mensaje deJMSUtilice la actividad Iniciar desde JMS para iniciar un proceso en el que un tema o cola de JMSreciba un mensaje de JMS. Por ejemplo, en un proceso de procesamiento de reclamaciones, puedeconfigurar una actividad Iniciar desde JMS para escuchar una cola de reclamaciones. La actividadinicia el proceso cuando un mensaje alcanza la cola. El sistema enruta a continuación los datos delmensaje hacia el destino deseado.

Llamar a servicio webEsta actividad admite servicios web seguros y no seguros.

Las operaciones que se relacionan en el WSDL no aparecen en esta actividad en las siguientescondiciones:

• Operaciones definidas en el enlace no compatibles con SOAP 1.1 o SOAP 1.2.

• Operaciones definidas en el WSDL en las que hay una discrepancia entre el atributo de nombrede las etiquetas input y output de binding y port. Por ejemplo: (/binding/operation/input and/binding/operation/output) y (/portType/operation/input and /portType/operation/output).

Invocar un servicio web seguroLa actividad Llamar a servicio web de xCP Designer admite tres tipos de seguridad:

• Compatibilidad de proxy HTTP

• Autenticación básica de HTTP

• Autenticación basada en encabezado SOAP



Antes de configurar un servicio Web seguro, puede configurar el servidor proxy HTTP. EMCDocumentum xCelerated Composition Platform Deployment Guide (Guía de implementación de EMCDocumentum xCelerated Composition Platform) proporciona información sobre cómo configurar unservidor proxy HTTP para servicios web.

Si el servicio web que se invoca está protegido por la autenticación de HTTP, utilice la autenticaciónbásica de HTTP en el punto final del servicio web para transferir el nombre de usuario y la contraseña.Configurar un punto final de servicio web, página 48 proporciona información adicional.

Si el servicio web que se invoca está protegido por la autenticación basada en encabezado SOAP,asigne el token de seguridad y los parámetros protegidos por SOAP en el nodo de encabezado SOAP. Elencabezado SOAP se puede encontrar en la asignación de entrada (sobre de SOAP/encabezado SOAP).

Para invocar un servicio web protegido por Nivel de socket seguro (SSL), debe disponer de uncertificado SSL en su entorno. La EMC Documentum xCelerated Composition Platform DeploymentGuide (Guía de implementación de EMC Documentum xCelerated Composition Platform) proporcionainstrucciones sobre la importación de certificados SSL para admitir conexiones de cifrado paraactividades.

Invocar Documentum Foundation Services (DFS)desde xCP DesignerPuede invocar DFS desde xCP Designer de una de las dos maneras siguientes:

• Como un servicio único, lo que significa que un proceso contiene una actividad de servicio web querealiza una invocación única de un servicio web DFS.

• Como un servicio encadenado, lo que significa que un proceso contiene varias actividades deservicios web que invocan servicios web DFS. La información de identidad del repositorio seregistra en un token que utiliza cada actividad.

Las actividades de servicio web admiten base64 y MTOM para las transferencias de contenido.

Asignaciones de datos implícitos del servicio webLas actividades Iniciar desde servicio web y Esperar al servicio web le permiten definir las entradas deservicio web en función de los datos de proceso o de un servicio web existente. Si selecciona los datosde proceso, no tiene que asignar los datos. Tampoco tiene que asignar el conjunto de correlación en laactividad Esperar al servicio web. Las asignaciones están implícitas y el sistema las completa.

El mensaje SOAP que se espera de la operación depende de las variables de proceso y los objetos denegocio visibles para la actividad. Durante la asignación de entrada, el sistema asigna las variables ylos objetos de negocio recibidos del mensaje SOAP a las variables y los objetos de negocio del proceso.

Durante la asignación de salida para la actividad Iniciar desde servicio web, el mensaje SOAP quedevuelve la operación contiene el ID del flujo de trabajo. Durante la asignación de salida para laactividad Esperar al servicio web, el mensaje SOAP que devuelve la operación contiene el ID delflujo de trabajo y el ID del elemento de trabajo.

En la asignación de correlación, si el conjunto de correlación utiliza una variable, el sistema compruebasi el valor de la variable en el mensaje coincide con el valor en el proceso.



Iniciar un proceso cuando se recibe un mensajeSOAPUtilice la actividad Iniciar desde servicio web para iniciar un proceso cuando un servicio web delentorno de implementación reciba un mensaje SOAP (Protocolo de acceso de objeto simple). Porejemplo, en una aplicación de planificación de recursos, esta actividad podría iniciar un procesocuando al recibir un mensaje SOAP solicitando suministros para oficinas regionales. El sistemapodría enrutar el contenido del mensaje SOAP a través de una actividad manual a un ejecutor quesupervisaría el envío.

El servicio web que recibe mensajes SOAP se define al configurar la actividad Iniciar desde servicioweb.

Usar Document Sciences xPressionUtilice la actividad Publicar documento para generar un nuevo documento de Document SciencesxPression mediante el servidor xPression. Como parte del proceso, se reemplazan las variables deldocumento en el documento al publicarlo. El servidor de xPression genera varios documentos decliente y los distribuye en salidas tales como impresión, correo electrónico, archivo o formatosbasados en web.

Utilice la actividad Documento de publicación avanzado cuando haya varios valores constantes queasignar a los datos del proceso. Esta actividad proporciona las mismas funciones que Publicardocumento pero, en lugar de utilizar el asignador de datos para asignar cada variable, puede utilizarla configuración XML de datos de cliente. Utilizaría la configuración XML de datos de cliente paracrear las asignaciones para las constantes y agregar marcadores de posición para los datos dinámicos.También utilizaría el asignador de datos para asignar únicamente los valores de marcador de posiciónque el XML crea.

Código de ejemplo de XML de datos de clienteEl siguiente ejemplo de código muestra el XML de datos de cliente correspondiente a una solicitud depresentación de historiales médicos. El número de solicitud, la fecha de la solicitud y el número deteléfono son todas variables que se deben asignar en el asignador de datos.<dataroot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><CUSTOMER_DATA><MedicalRecordReleaseRequest><reqNo>$RequestNo</reqNo><requestDate>$ReqDate</requestDate><patientName>John Doe</patientName><patientAddress_street1>1234 Cherry Circle</patientAddress_street1><patientAddress_street2></patientAddress_street2><patientAddress_city>San Jose</patientAddress_city><patientAddress_state>California</patientAddress_state><patientAddress_zipCode>95131</patientAddress_zipCode><patientDOB>1976-01-01</patientDOB><patientSSN>123-12-1234</patientSSN><patientHospitalName>Mercy Hospital</patientHospitalName>



<orgName>Mercy Medical Foundation</orgName><orgTelNo>$$TelephoneNo</orgTelNo></MedicalRecordReleaseRequest></CUSTOMER_DATA>

</dataroot>

En este ejemplo, si requestDate es del tipo dateTime de XSD, use la siguiente cadena de formato:yyyy-MM-dd’T’HH:mm:ss.SSSZ

Ciclo de vida

Un ciclo de vida define la secuencia de estados en que se puede encontrar un objeto. Por lo general, elciclo de vida está diseñado para un documento, para describir un proceso de revisión. Por ejemplo,cuando un usuario final crea un documento, este se envía a otros usuarios para su revisión y aprobación.El ciclo de vida define el estado del objeto en cada etapa del proceso.

El ciclo de vida contiene:

• Estados: un ciclo de vida puede estar en un estado normal de progresión o en un estado deexcepción. Los estados definidos son promover, degradar, suspender y reanudar.

• Tipos de objetos que se pueden conectar al ciclo de vida: cualquier objeto o subtipo del sistemapuede tener un ciclo de vida asociado.

• Procedimientos de validation: un ciclo de vida puede desencadenar un comportamientopersonalizado en el repositorio cuando un objeto entra o sale de un estado del ciclo de vida.

Para obtener más información acerca de los ciclos de vida, consulte la Guía de aspectos básicos deContent Server y la Guía del usuario de Documentum Process Builder


Capítulo 7Trabajar con flujos y asignaciones dedatos



Tareas

Conectar actividades con flujos1. Utilice uno de los flujos de actividad siguientes para conectar las actividades en el modelo de

proceso:• Para pasar datos de proceso de una actividad a la siguiente, agregue un flujo de reenvío. Haga clicen Flujo recto para agregar un flujo de reenvío con una sola línea. Haga clic en Flujo devarios segmentos para agregar un flujo de reenvío con una línea que conste de varios segmentos.

• Para dirigir los datos de proceso en un bucle hacia atrás o en un flujo de reenvío alternativo, hagaclic en Crear flujo de rechazo.

• Para conectarse a una actividad de controlador de errores, haga clic en Usar este flujo paraasignar controladores de errores.

2. Arrastre y suelte el flujo desde el borde de una actividad a la siguiente para conectar las actividades.

Cambiar la apariencia de flujosSiga este procedimiento para cambiar la forma en que aparecen las líneas de flujo y para agregaretiquetas de flujo para hacer el modelo de proceso más descriptivo.1. En el lienzo del editor de modelo de proceso, haga doble clic en una línea de flujo de actividad para

abrir el Inspector del flujo.2. Configure el modo en que el flujo aparece en el modelo de proceso tal y como se describe en la

tabla siguiente:

Campo Descripción

Estilo visual de flujo Seleccione si desea utilizar una sola línea o líneas devarios segmentos. Las líneas de muchos segmentospueden ser más fáciles de seguir para los usuarios.

Fuente de etiquetas Seleccione una fuente para usarla para la etiquetade flujo de trabajo.


Trabajar con flujos y asignaciones de datos

Campo Descripción

Tamaño de fuente Seleccione el tamaño del texto de la etiqueta.

Negrita Seleccione esta opción para resaltar en negrita eltexto de la etiqueta.

Cursiva Seleccione esta opción para resaltar en cursiva eltexto de la etiqueta.

Mostrar etiqueta Seleccione esta opción para mostrar una etiquetapara el flujo. Borre este campo para ocultar laetiqueta de flujo de trabajo.

Mostrar paquetes visibles en la actividad de destino Seleccione esta opción para etiquetar el flujo con losnombres de los paquetes que controla la siguienteactividad.

Etiqueta personalizada Seleccione esta opción para agregar su propiaetiqueta de flujo de trabajo. Escriba el texto parala etiqueta.


Configurar una actividad de flujo paralelo1. Arrastre y suelte la actividad Flujo paralelo en el lienzo y colóquela dentro del modelo de proceso

principal.2. Ajuste el Flujo paralelo según sea necesario para el modelo de proceso:

• Para cambiar el tamaño del flujo paralelo, seleccione un borde del contenedor de flujo paralelo yarrástrelo.

• Para sustituir una actividad, arrastre y suelte una actividad de sustitución desde la paletaActividades a la primera actividad o cualquier actividad por pasos. Haga clic en Sí paraconfirmar el reemplazo.

• Para configurar la primera actividad en lugar sustituirla, haga doble clic en la actividadSeparador de decisión para abrir el Inspector de actividad. Cambie el nombre de la actividaden el campo de la parte superior del Inspector de actividad. Haga clic en la pestaña Transicióny ajuste la configuración de transición. Complete la configuración de esta actividad como loharía para cualquier otra y haga clic en Aceptar.

• Para agregar flujos y actividades adicionales, agréguelos entre la primera actividad y la actividadUnión inteligente.

• Para cambiar el color de fondo, haga doble clic en el fondo del Flujo paralelo, seleccione uncolor de fondo de la lista desplegable y haga clic en Aceptar.

Agrupar actividades de proceso1. Arrastre y suelte una actividad Grupo en el lienzo.2. Haga doble clic en la actividad para abrir el Inspector de grupo.3. Escriba la etiqueta para el grupo.4. Seleccione la fuente de etiquetas y el color de fondo del grupo.5. Haga clic en Aceptar.



6. Para hacer el grupo más grande, arrastre el borde para ampliar el límite del grupo.

7. Arrastrar y suelte las actividades que desee incluir en el grupo en el contenedor del grupo.

8. Conecte las actividades en el modelo de proceso con los flujos de proceso.

9. Para ocultar las actividades del grupo, haga clic en el signo menos. Para expandir el grupo, hagaclic en el signo más.

Anotar el modelo de proceso

Puede agregar texto al diseño visual del modelo de proceso mediante notas. Las notas anotan elmodelo de proceso y proporcionan información clara para diseñadores de aplicaciones. No cambianlos procesos.

1. En la barra de herramientas, haga clic en Crear nota y, a continuación, haga clic en el lienzo deleditor de modelo de proceso para colocar la nota en el lienzo.

2. Arrastre y suelte la nota para cambiar su ubicación.

3. Haga doble clic en la nota para abrir el Inspector de notas.

4. En la pestaña Contenido de la nota, escriba el texto de la nota.

5. En la pestaña Visualización, en el campo Fuente, configure la fuente y el estilo del texto de la nota.

Los cambios en la configuración de nota aparecen en el área Vista previa.

6. En el área Formato, configure la alineación y el color de la nota tal y como se describe en latabla siguiente:

Campo Descripción

Formato Especifique cómo justificar el texto de la nota.

Transparencia Establezca el nivel de transparencia mediante el control deslizante. Si define elnivel de transparencia 100 por cien, la nota será opaca y ocultará los objetosque se encuentren detrás de ella. Si define el nivel de transparencia en 0 porciento, la nota es transparente.

Color de texto Seleccione el color del texto de la nota.

Color de fondo Seleccione el color de fondo de la nota.

7. En el área Vista previa, especifique el borde de la nota tal y como se describe en la tabla siguiente:

Campo Descripción

Borde Muestra un borde amarillo.

Estilo de BPMN Muestra la nota en el formato Business Process Modeling Notation (formato deBPMN) para las anotaciones de texto.


9. Para cambiar el tamaño de la nota, haga clic y arrastre un identificador negro que hay en el bordede la nota.



Cambiar una imagen de la actividad de proceso

Utilice este procedimiento para cambiar la imagen que aparece en el modelo de proceso para unaactividad. El archivo de imagen personalizada debe estar en el navegador de Recursos. Gestionarcontenido de la biblioteca de recursos, página 50 proporciona información adicional.

1. Haga doble clic en una actividad para abrir el Inspector de actividad.

2. En la pestaña Visualización, configure la imagen de actividad tal y como se describe en la tablasiguiente:

Campo Descripción

Usar imagen personalizada para laactividad

Seleccione esta opción para sustituir la imagen predeterminadapara esta actividad por su propia imagen.

Origen de imagen Haga clic en Seleccionar para localizar la imagen. En el cuadrode diálogo Select Resources (Seleccionar recursos), seleccioneel archivo de imagen personalizada y haga clic en Finalizar.

Tamaño de imagen Seleccione un porcentaje para ajustar el tamaño de imagen.

3. Configure la etiqueta de la actividad tal y como se describe en la siguiente tabla:

Campo Descripción

Mostrar etiqueta Seleccione esta opción para incluir la etiqueta de actividad. Borreeste campo para ocultar la etiqueta de actividad.

Tamaño de fuente Seleccione el tamaño del texto de la etiqueta.

Negrita Seleccione esta opción para resaltar en negrita el texto de laetiqueta.

Cursiva Seleccione esta opción para resaltar en cursiva el texto de laetiqueta.


Configurar condiciones de desencadenamiento parainiciar una actividad1. Haga doble clic en una actividad para abrir el Inspector de actividad.

2. En la pestaña Desencadenador, especifique cuándo iniciar esta actividad tal y como se describeen la tabla siguiente:

Campo Descripción

Todos los flujos de entrada están seleccionados Seleccione esta opción para iniciar esta actividadcuando todas las actividades inmediatamenteprecedentes hayan finalizado.

Se ha seleccionado este número de flujos de entrada. Seleccione esta opción para especificar cuántosflujos de entrada se deben completar antes de quese inicie esta actividad.



Campo Descripción

Y cuando llegue esta señal Seleccione esta opción para esperar hasta que unaacción específica se produzca antes de iniciar estaactividad. Escriba el nombre del desencadenadorseñal que debe llegar antes de que se inicie estaactividad.

Esta actividad se puede ejecutar más de una vez enun flujo de trabajo

Seleccione esta opción para habilitar esta actividady que se ejecute más de una vez en un proceso.Estructure el modelo de proceso para que solouna instancia de la actividad se pueda habilitar encualquier momento.


Procedimientos recomendados: compruebe que la pestaña Desencadenador de cada actividadestá definida con el número correcto de actividades entrantes antes de ejecutar la aplicacióne iniciar el proceso.

Definir temporizadores de actividad1. Haga doble clic en una actividad para abrir el Inspector de actividad.

2. En la pestaña Temporizadores, haga clic en Agregar para agregar un temporizador a la actividad.

3. En el cuadro de diálogo Configuración del temporizador, configure el temporizador tal y como sedescribe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el temporizador.

Temporizador iniciado el Seleccione si el temporizador se inicia cuando se inicia el proceso o cuandose inicia la actividad.

Temporizador quitado el: Muestra el evento que elimina el temporizador.

4. En el área Duración de tiempo de espera, escriba un número entero o una expresión para calcularla fecha de caducidad del temporizador. El resultado de la expresión debe ser un número entero.En tiempo de ejecución, si el sistema evalúa la expresión como un valor negativo, la acción deltemporizador se ejecuta inmediatamente.

5. En el campo Duración en, seleccione la unidad que se va a utilizar para la duración.

6. En Acciones al agotarse el tiempo de espera, haga clic en Agregar para agregar una acción afin de que se ejecute cuando caduque el temporizador y, a continuación, en la pantalla Agregaracción, seleccione una acción disponible, tal y como se describe en la tabla siguiente:

Acción Procedimiento

Llamar proceso En la pantalla Llamar proceso, seleccione un proceso y haga clic enSiguiente.

En la pantalla Llamar proceso <nombre de proceso>, defina los valores deentrada del contexto actual para invocar el proceso y haga clic en Finalizar.



Acción Procedimiento

Llamar a un proceso sinestado

En la pantalla Llamar a un proceso sin estado, seleccione un proceso sinestado y haga clic en Siguiente.

En la pantalla Llamar al proceso sin estado <nombre de proceso>, definalos valores de entrada del contexto actual para invocar el proceso y hagaclic en Finalizar.

Definir valor En el árbol de datos de contexto, actualice el valor de datos de proceso.

Delegar tarea En la pantalla Delegar tarea, en el campo Delegar en, haga clic enSeleccionar. En el cuadro de diálogo Seleccionar ejecutor, seleccione elejecutor de la tarea delegada.

Completar tarea Haga clic en Finalizar.

7. Haga clic en Agregar para agregar más acciones.8. Para cambiar el orden de las acciones, seleccione una acción y haga clic en Subir o Bajar.9. En el área Nueva ocurrencia, seleccione Las acciones al agotarse el tiempo de espera se

volverán a producir cada duración para habilitar que las acciones se repitan y escriba un númeroentero o una expresión para calcular la frecuencia de repetición de las acciones. El resultado de laexpresión debe ser un número entero.

No se admiten nuevas ocurrencias en el depurador de procesos.10. En el campo Duración en, seleccione la unidad que se va a utilizar para la duración.11. Haga clic en Finalizar.12. Si el temporizador se inicia cuando se inicia la actividad, en la pestaña Temporizadores, en la

columna Fecha de vencimiento, seleccione la fecha de vencimiento que el sistema utiliza paracalcular las tareas atrasadas.

13. En el área Calendario, seleccione el calendario que se utiliza para convertir la duración a una fechade desencadenamiento tal y como se describe en la tabla siguiente:

Campo Descripción

Usar calendario estándar Especifica el calendario estándar para calcular la duración deltemporizador.

Usar calendario empresarial delproceso

Especifica el calendario definido en las propiedades del procesodel modelo de proceso para calcular la duración del temporizador.

Usar calendario empresarial específico Seleccione un calendario empresarial para utilizarlo para calcularla duración del temporizador.


Configurar transiciones entre actividades1. Haga doble clic en una actividad para abrir el Inspector de actividad.2. En la pestaña Transición, especifique una transición para determinar las actividades que vienen a

continuación en el flujo de proceso.• Para distribuir el flujo de proceso a todas las actividades posteriores, seleccione Seleccionartodas las actividades conectadas. Si la actividad tiene varios ejecutores, especifique el númerode estos que deben completar la tarea antes de que finalice la actividad. Vaya al paso 4.



• Para permitir que el ejecutor determine las siguientes actividades del flujo de proceso, seleccionePermitir al ejecutor seleccionar las siguientes actividades y vaya al paso 3.

• Para distribuir el flujo de proceso a las siguientes actividades en función de un conjunto decondiciones, seleccione Seleccionar las siguientes actividades según condiciones. Configuraruna transición condicional entre actividades, página 195 proporciona información sobre cómoconfigurar una transición condicional.

3. Si deja que el ejecutor seleccione las siguientes actividades del proceso, especifique las reglas detransición:a. En el campo Seleccione hasta [n] actividades, elija el número máximo de actividades que

puede seleccionar el ejecutante.b. Si la actividad tiene varios ejecutores, especifique el número de estos que deben completar la

tarea antes de que finalice la actividad.c. Si deja que varios ejecutores seleccionen las siguientes actividades, determine cuándo se

iniciarán estas, tal y como se describe en la tabla siguiente:

Campo Descripción

Cualquier ejecutor rechaza Inicia inmediatamente las actividades de rechazoseleccionadas sin esperar otras respuestas.

Cualquier ejecutor reenvía Inicia inmediatamente las actividades de reenvíoseleccionadas sin esperar otras respuestas.

Todos los ejecutores completen la tarea Inicia las siguientes actividades seleccionadas solocuando el número de ejecutores especificado hayacompletado la tarea.

Seleccione las actividades que se iniciarán si losejecutores seleccionan tanto actividades de reenvíocomo de rechazo.


Configurar una transición condicional entreactividadesEste procedimiento solo se aplica en los casos en los que los flujos conectan una actividad anterior auna o varias actividades posteriores.

Puede especificar reglas que determinan qué flujos se siguen cuando se completa la actividad anterior.El uso de reglas crea una transición condicional.1. Haga doble clic en la actividad previa para abrir el Inspector de actividad.2. En la pestaña Transición, seleccione Seleccionar las siguientes actividades según condiciones

para mostrar el área Transiciones.3. Configure una o más reglas.

a. Haga doble clic en una regla IF-THEN-ELSE para verla en el editor de reglas.b. Especifique una condición mediante el editor de expresiones.c. Seleccione una o varias actividades para que ocurran con dicha condición.d. Haga clic en Aceptar.



e. En la pestaña Transición, continúe para configurar las reglas, haciendo clic en Agregar paraagregar reglas nuevas y en Aplicar para guardar los cambios.


Al hacer clic en Aceptar y Aplicar se comprueban las reglas de errores.

Configurar notificaciones por correo electrónico deactividad1. Haga doble clic en una actividad para abrir el Inspector de actividad.

2. Haga clic en Notificación.

3. Para cada evento de notificación de la lista, seleccione si desea enviar una notificación por correoelectrónico del sistema o una notificación por correo electrónico personalizada.

4. Para enviar una notificación por correo electrónico personalizada:

a. Seleccione Enviar correo electrónico personalizado y haga clic en Editar.

b. En el campo Plantilla de correo electrónico del Asistente para plantilla de notificación,seleccione la plantilla de correo electrónico que se va a usar para la notificación y haga clic enFinalizar.

c. Haga clic en Siguiente.

d. En la pantalla Asignación de mensaje de entrada, para el mensaje de entrada, asigne los datosde proceso (Origen) para los atributos del mensaje de correo electrónico (Destino).

Asigne el nodo de destinatario Para en el área Destino. Asigne todos los nodos de marcadoresde posición que residen en los nodos Asunto y Cuerpo.

e. Asigne los datos adjuntos del correo electrónico en los datos de proceso para los datos adjuntosdel mensaje de correo electrónico. Si el correo electrónico tiene varios anexos, puede hacerclic en Agregar en el nodo Anexo para agregar más anexos.

f. Haga clic en Siguiente.

g. En la pantalla Asignación de mensaje de salida, asigne el ID de mensaje del mensaje enviado(Origen) a los datos de proceso (Destino) y haga clic en Aceptar.

5. Cuando termine las selecciones para los eventos de notificación, haga clic en Aceptar.

Configurar los datos de proceso dentro de unaactividad1. Haga doble clic en una actividad para abrir el Inspector de actividad.

2. En la pestaña Datos, seleccione cada variable de paquete o de proceso por separado paraconfigurarla.

• Para seleccionar un paquete, expanda el nodo Paquetes y seleccione el paquete.

• Para seleccionar una variable de proceso, expanda el nodo Variables de proceso y seleccione lavariable de proceso.

3. Configure los paquetes y las variables de proceso tal y como se describe en la tabla siguiente:



Campo Descripción

Versión Para un paquete de contenido, seleccione o escriba la versión delpaquete que se aplica a esta actividad. Puede escribir una versiónespecífica, por ejemplo, 2.0 ó 3.0. También puede escribir unaversión simbólica, como Borrador. Esta versión sobrescribe laversión configurada en el modelo de proceso.

Visible en esta actividad Seleccione esta opción para que la variable de proceso o el paqueteesté disponible para el ejecutor de esta actividad. Desactive estaopción si no desea que el ejecutor de esta actividad vea el paqueteo la variable de proceso en tiempo de ejecución.

Este es un paquete obligatorio Seleccione esta opción para que se requiera rellenar el paqueteantes de finalizar la actividad.


Asignar datos de proceso1. Haga doble clic en una actividad de integración para abrir el Inspector de actividad.

2. Vaya a la herramienta de asignación de datos de procesos.

3. En una pantalla de asignación de datos (Asignación de mensaje de entrada, Asignación de mensajede salida o Asignación de conjunto de correlación), seleccione una función de asignación de datosde procesos en la lista desplegable.

Por ejemplo, para copiar los valores del origen al destino, seleccione la función Copiar.

4. Arrastre el icono de función hasta la ubicación en la que desea que aparezca. La posición noafecta al orden de ejecución.

5. En el área Origen, seleccione los atributos cuyos valores son los datos de entrada de la función.

• Para seleccionar un atributo, haga clic en el nombre del atributo. En el área de asignación,aparecerá una línea que conecta el atributo seleccionado con el icono de función actual. Si la



función actual acepta varios valores de entrada (por ejemplo, la función Concatenar), puedeseleccionar varios atributos en el área Origen.

• Para borrar el atributo y quitar la línea, haga clic en el nombre del atributo una segunda vez.

• Para seleccionar un atributo que ya se ha asignado a otra función, haga clic en Modo dedibujo de líneas. Dibuje una línea desde el punto de conexión en la línea de selección anteriorhasta el icono de la función.

• Para definir una función que utiliza constantes en lugar de atributos como datos de entrada,omita este paso y escriba los valores de constantes en el paso 7.

6. En el área Destino, seleccione el atributo que recibe el resultado de la función.

7. Para modificar las propiedades de la función, haga doble clic en el icono para abrir el Editor defunciones. Realice los cambios necesarios y haga clic en Aceptar.



• Para agregar una constante como valor de entrada adicional, en el área Parámetros de función,haga clic en el botón Agregar un parámetro de constante. Escriba la constante en el campo.Por ejemplo, Revisado.

• Para cambiar el orden de los atributos, utilice las flechas para moverlos hacia arriba o abajoen la lista.

8. Repita estos pasos para cada función de asignación de datos que desee crear.

Configurar una función de asignación de datos1. Haga doble clic en una actividad de integración para abrir el Inspector de actividad.2. Vaya a la herramienta de asignación de datos de procesos.3. En una pantalla de asignación de datos, seleccione una función de asignación de datos de proceso

en el cuadro de lista.4. Haga doble clic en el icono de la función para abrir el Editor de funciones .

• Para agregar una constante como valor de entrada adicional, en el área Parámetros de función,haga clic en Agregar un parámetro de constante. Escriba la constante en el campo.

• Para quitar una constante, seleccione la constante y haga clic en Quitar un parámetro deconstante.

• Para cambiar el orden de los atributos, utilice las flechas para moverlos hacia arriba o abajoen la lista.

5. Haga clic en Aceptar.6. Para agregar un atributo de paquete a la función, seleccione el paquete en el área Origen.

Agregar atributos de varios valores1. Haga doble clic en una actividad de integración para abrir el Inspector de actividad.2. En la herramienta de asignación de datos de procesos, localice un atributo multivalor.3. Haga clic en el enlace Agregar junto al nombre de atributo para crear un nodo con un valor de

índice predeterminado.4. Para cambiar el valor de índice, haga doble clic en el valor de índice.

a. En el cuadro de diálogo Índice de repetición, seleccione PRIMERO, ÚLTIMO o escribaun valor numérico.

b. Haga clic en Aceptar.5. Repita estos pasos para especificar valores adicionales para el atributo.

Configurar el contexto para un atributo de variosvaloresUtilice este procedimiento para establecer el contexto para un atributo de varios valores con un valorde índice [ALL].1. Haga doble clic en una actividad de integración para abrir el Inspector de actividad.2. Vaya a la herramienta de asignación de datos de procesos.



3. Seleccione una función que pueda incorporar varios valores y haga doble clic en el icono de función.4. En el área Definir contexto de repetición del Editor de funciones, seleccione el valor para el

Contexto de entrada tal y como se describe en la tabla siguiente:

Campo Descripción

Todos Realiza la función para todos los atributos al mismo tiempo ycrea una salida de atributo de un solo valor.

Por ejemplo, el atributo de varios valores IntArray es un tipode entero con valores [1, 2, 3, 4, 5]. La función de regla deasignación es Agregar(IntArray, 1). El resultado de esta funciónson los valores de atributo de varios valores + 1.

Esta opción realiza la función Agregar con IntArray como unargumento, creando una salida de un solo valor. En este caso, lasalida en el área Destino es 16 = (1+2+3+4+5) + 1.

For-each Realiza la función para cada uno de los atributos de formaindividual y crea una salida de atributo de varios valores.

Con el ejemplo anterior, esta opción realiza la función Agregarpara cada valor en IntArray, creando un atributo de varios valoresen el área de Destino. En este caso, el resultado es [2, 3, 4, 5 y 6].

5. Seleccione el valor para el Contexto de salida tal y como se describe en la tabla siguiente:

Campo Descripción

Sobrescribir Se sobrescriben los valores existentes.

Insertar después Inserta valores después del valor de índice.

Insertar antes Inserta valores antes del valor de índice.

6. En el área Origen, seleccione el nodo de atributos de varios valores que representa todos losvalores (el valor de índice para este nodo es [ALL]).

7. En el área Destino, cree un nodo que represente un valor de índice específico del atributo de variosvalores. Seleccione este nodo para completar la asignación de datos.

Agregar un nodo a un mensajeUtilice este procedimiento para agregar un nodo de mensaje adicional para finalizar una asignación dedatos.1. Haga doble clic en un mensaje de correo electrónico, JMS o actividad de integración de HTTP

para abrir el Inspector de actividad.2. Configure la actividad y desplácese a la herramienta de asignación de datos de procesos.3. Para agregar un nodo de mensaje:

• En una plantilla de actividad HTTP, para agregar un parámetro de URL, haga clic con el botónderecho en URL Parameters (Parámetros de URL) y seleccione Agregar.

• En una plantilla de actividad de correo electrónico, para agregar un encabezado de correoelectrónico personalizado, haga clic con el botón derecho en Additional Headers (Encabezadosadicionales) y seleccione Agregar.

• En una plantilla de actividad de JMS, para agregar una propiedad de mensaje de JMS, haga cliccon el botón derecho en Propiedad y seleccione Agregar.



4. En el cuadro de diálogo Parámetro del asignador de datos, haga clic en Agregar parámetrode asignación.

5. Escriba el Nombre para mostrar y el Nombre completo de la propiedad.

6. Seleccione el Tipo de propiedad.


Asegúrese de que todas las propiedades de mensaje que agrega son adecuadas para el protocolo demensaje, ya que no existe ninguna validación para las propiedades de mensaje agregadas.

8. Utilice el nodo de mensaje agregado en la asignación de datos.

Agregar un nodo condicional a los datos del proceso

1. Haga clic con el botón secundario en un nodo de elemento multivalor ( ) y seleccioneMostrargenerador de condiciones.

2. En el árbol de datos, seleccione un atributo para la expresión.

3. Seleccione un operador y escriba un valor para la expresión.

4. Haga clic en Insertar expresión.

5. Haga clic en Aceptar.Un nodo condicional aparecerá en el árbol de datos junto al texto de la expresión. Si el texto dela expresión no está visible, haga clic con el botón derecho en el nodo condicional y seleccioneEditar condición para ver el texto completo de la expresión.

Asignar datos de uno a varios nodos

Una variable de origen puede proporcionar una entrada a varias funciones cuya salida, a continuación,establece valores para varias variables de destino. Puede realizar la asignación con una sola asignaciónde datos.

Por ejemplo, una variable de hora y fecha podría ser el origen para ambas de las funciones siguientes:

• Una función de copia que establece el valor de una variable de destino de hora y fecha

• Una función de fecha para cadena que establece el valor de una variable de cadena

El siguiente ejemplo muestra las técnicas necesarias para los datos de asignación desde un origen amuchos destinos.

1. Crear la función de copia para el primer elemento.

2. Agregue una segunda función de copia y haga clic en la variable de destino.

3. Haga clic en el botónModo de dibujo de líneas en la barra de herramientas.

4. Coloque el cursor sobre el punto de conexión de la variable de origen y haga clic una vez.



5. Haga clic en el identificador situado junto a la función de copia para completar la asignación.

Usar un esquema XML para representar unaestructura de contenidoPuede utilizar un esquema XML para representar la estructura de contenido de un paquete o un anexo.Antes de realizar este procedimiento, coloque el esquema XML (archivo XSD) en la carpeta Recursosde la aplicación.1. Haga clic con el botón derecho en un nodo de Datos en el árbol de asignación de datos de proceso

y seleccione Agregar elemento.2. En el cuadro de diálogo Esquema, haga clic en Examinar.3. En el cuadro de diálogo Select Resource (Seleccionar recurso), seleccione el esquema y haga

clic en Finalizar.4. En el campo Elemento, seleccione un elemento raíz del esquema XML y haga clic en Aceptar.

El sistema actualiza el árbol de contexto con la estructura XML que describe el esquema XML.Puede utilizar la estructura XML para la asignación de datos.

Usar contenido en un procesoEsta tarea proporciona un ejemplo de cómo puede utilizar el contenido en un proceso. Muestra cómocambiar el nombre de contenido de forma automática del nombre y apellido de un cliente en laactividadDefinir los datos de proceso.1. Cree un objeto de negocio Cliente y agregue atributos para el nombre y el apellido.2. Cree un objeto de contenido y agregue un atributo para el nombre completo.3. Agregue el objeto de negocio Cliente como un paquete al proceso.4. Agregue el objeto de contenido como un paquete al proceso.5. Arrastre y suelte la actividad Definir los datos de proceso en el lienzo.6. Haga doble clic en la actividad para abrir el Inspector de actividad en la pestaña Process Data

Mapping (Asignación de datos de proceso).7. En la pantalla Asignación de mensaje de entrada, área Origen, expanda el paquete de objeto

de negocio Cliente.8. En la pantalla Asignación de mensaje de entrada, área Destino, expanda el paquete de objeto de

contenido.9. Asigne los atributos Nombre y Apellido del paquete Cliente al atributo Nombre completo del

paquete de objeto de contenido en el área Destino mediante la función Concatenar. Funciones dela asignación de datos, página 215 proporciona información adicional.




Conceptos

FlujosLos flujos conectan las actividades en el modelo de proceso y orquestan la lógica empresarial. Losflujos también permiten el movimiento de paquetes, variables de proceso, propiedades y dependenciasque existen entre las actividades conectadas.

Las flechas en un modelo de proceso indican flujos. Puede configurar y etiquetar flujos para mejorar laclaridad del modelo de proceso.

Existen tres tipos de flujos:

• Flujos de reenvío: pasan los datos de proceso de una actividad a la siguiente. Por ejemplo, unpaquete pasa de una actividad de edición a una actividad de aprobación. Una flecha totalmentenegra representa un Flujo de reenvío.

• Flujos de rechazo: determinan lo que ocurre cuando el ejecutor de una actividad rechaza la tareaque se distribuye. Los flujos de rechazo dirigen los datos de proceso en un bucle hacia atrás o en unflujo de reenvío alternativo. Por ejemplo, un paquete pasa de la actividad de aprobación de nuevo ala actividad de edición. Una flecha roja con una línea discontinua representa un Flujo de rechazo.



• Flujos de controlador de error: determinan qué acción se debe realizar cuando una actividad delsistema asociada falla. Una flecha gris con una línea discontinua y un icono representa un flujode controlador de errores.

Todas las actividades por pasos deben presentar, al menos, un flujo entrante y otro saliente. Unaactividad de inicio solo tiene un flujo saliente y ningún flujo entrante. Una actividad de finalizaciónsolo puede tener un flujo entrante y ninguno saliente.

La siguiente figura ilustra los tres tipos de flujos:

En esta figura, el flujo de rechazo se denomina Rechazado por el administrador. El flujo delcontrolador de error se denomina Aplicación de negocio no accesible. El resto de los flujos son Flujosde reenvío. Los rombos en la base de las flechas indican información de transición en la actividadanterior. Por ejemplo, los flujos de reenvío con la etiqueta Cantidad de la factura > 10000 y Cantidadde la factura <= 10000 tienen un rombo en la base de la flecha situada junto a la actividad de divisiónde decisiones. La actividad de división de decisiones contiene información de transición para quelos flujos enruten la factura al revisor correcto.

Flujos paralelos

Un flujo paralelo es un grupo de actividades contenido que se divide en un número dinámico de posiblesflujos. A continuación, cada conexión activa se combina en el proceso principal mediante una actividadUnión inteligente. La actividad Unión inteligente determina automáticamente el número de conexionesactivas y espera a que estas se completen antes de combinarlas con el proceso de flujo principal.

La figura siguiente muestra un flujo paralelo:



Utilice un flujo paralelo cuando no se pueda determinar el número exacto de flujos de entrada parauna actividad Unir hasta el tiempo de ejecución. Una actividad convencional Unir requiere que seespecifique el número de flujos de entrada cuando se diseña la actividad. La Unión inteligente en unflujo paralelo contiene inteligencia adicional para gestionar flujos de entrada.

Dentro de un flujo paralelo, puede reemplazar o agregar actividades entre la división de decisiones y laactividad Unión inteligente. La primera actividad es una actividad división de decisiones que puedeconfigurar o sustituir con una actividad manual o del sistema. La actividad Unión inteligente no sepuede editar o eliminar del contenedor de flujo paralelo. Está preconfigurada para iniciarse cuandotodas las actividades activadas del flujo paralelo se hayan completado.

Por ejemplo, en un proceso de revisión de factura, un procesador revisa facturas inferiores a $10.000.Un procesador y un administrador revisan las facturas de $10.000 o superiores. Puesto que la cantidadde la factura no está disponible hasta el tiempo de ejecución y puede haber tanto uno o como dos flujosde entrada, este proceso utiliza un flujo paralelo.

La siguiente figura ilustra el proceso de revisión de factura:

En este ejemplo, la primera actividad (división de decisiones) contiene la siguiente configuración detransición:



La actividad Unión inteligente utiliza la información de transición de la actividad de división dedecisiones para seguir la lógica del proceso de negocios y continuar con el flujo de proceso. Si elproceso recibe una factura de $9.000, la actividad Unión inteligente se activa cuando la actividad derevisión por el procesador finaliza. Si el proceso recibe una factura de $12.000, la actividad Unióninteligente se activa tanto cuando la actividad de revisión por el procesador finaliza como cuando laactividad de revisión por el administrador finaliza.

Organizar actividades de proceso en gruposLos grupos de actividad de proceso le permiten organizar el modelo de proceso visualmente. Parasimplificar un modelo de proceso, puede agrupar las actividades relacionadas con la actividad Grupo.Se puede ampliar un grupo para ver las actividades individuales o contraerlo para obtener una vistacompacta.

La siguiente figura ilustra una agrupación de actividades con un estilo de diagrama de flujo de procesos:

En este ejemplo, hay un grupo de aprobación y un grupo de procesamiento. La agrupación de estiloflujo de procesos muestra las actividades relacionadas con cada una de estas funciones.

La figura siguiente muestra un grupo de aprobación contraído y un grupo de procesamiento ampliado:



Los flujos no conectan directamente con el contenedor de grupos. Se conectan a las actividadesindividuales dentro del contenedor.

Descripción de los iconos de proceso que se vana utilizar

La tabla siguiente describe los iconos del editor de modelos de proceso:

Icono Nombre Descripción

Propiedades deproceso

Define las propiedades del modelo de proceso.

Configurar información general para el modelo de proceso, página 97proporciona información adicional.

Seleccionarobjetos

Le permite seleccionar objetos individuales en el modelo de proceso.

Flujo recto Agrega un flujo de reenvío (flecha negra con una sola línea) entre dosactividades.

Flujos, página 203 proporciona información adicional.

Flujo de variossegmentos

Agrega un flujo de reenvío (flecha negra con líneas de muchos segmentos)entre dos actividades.


Crear flujo derechazo

Agrega un flujo de rechazo (flecha roja con una línea discontinua) entre dosactividades.




Icono Nombre Descripción

Usar este flujopara asignarcontroladores deerrores

Agrega un flujo de controlador de errores (flecha gris con una líneadiscontinua y un icono) entre dos actividades.


Crear nota Agrega un indicador visual para anotar el modelo de proceso.

Anotar el modelo de proceso, página 191 proporciona información adicional.

Usar las condiciones de desencadenamiento parainiciar una actividadUn desencadenador es una acción que inicia una actividad. Las condiciones de desencadenamientodefinen los criterios de inicio de una actividad determinada. En el tiempo de ejecución, el servidor noinicia una actividad hasta que las condiciones del desencadenador de la actividad se cumplen. Lascondiciones del desencadenador pueden incluir una señal de desencadenamiento que debe tenerlugar para que la actividad se inicie.

Si la actividad presenta varios flujos entrantes, puede especificar el número de las actividadesanteriores que se deben haber completado antes de que se inicie la actividad. Por ejemplo, si unaactividad tiene tres flujos entrantes, puede establecer la actividad para que se inicie cuando dos delos tres flujos entrantes se hayan completado.

Antes de ejecutar la aplicación e iniciar el proceso, compruebe que ha definido la pestañaDesencadenador de cada actividad con el número correcto de las actividades entrantes.

Usar temporizadores de actividad en un procesoAl configurar una actividad de proceso, puede definir temporizadores para iniciar acciones específicascuando el trabajo se retrase o no se complete. Por ejemplo, puede establecer recordatorios deejecutores de tarea para completar una tarea o iniciar el procesamiento de escalación de problemascon los acuerdos de nivel de servicio (los SLA).

Hay dos tipos de temporizadores para las actividades:

• Instancia de proceso iniciada: si no se ha iniciado una actividad dentro de un período de tiempodeterminado tras el inicio del proceso, el sistema realiza una acción concreta.

• Actividad iniciada: si no se ha completado una actividad dentro de un período de tiempodeterminado tras el inicio de la actividad, el sistema realiza una acción concreta.

En función del tipo de temporizador, puede especificar que se inicien las siguientes cuando finaliceel temporizador:

• Llamar proceso: inicia un proceso.

• Llamar a un proceso sin estado: inicia un proceso sin estado y utiliza los valores devueltospara actualizar los datos del proceso.

• Definir valor: muestra la herramienta de asignación de datos y le permite actualizar los valoresde datos del proceso.



• Delegar tarea: delega la tarea de usuario final en otro ejecutor.

• Completar tarea: finaliza la tarea de usuario final actual.

Un temporizador puede tener varias acciones de tiempo de espera. Por ejemplo, después de queun temporizador complete una tarea, también puede definir el valor de un atributo en una variablede proceso o paquete. Las condiciones de transición de la actividad pueden comprobar este valor ycambiar el flujo del proceso.

Puede configurar las acciones del temporizador para que se repitan conforme a un intervalodeterminado hasta que el temporizador finalice. Por ejemplo, puede enviar notificaciones por correoelectrónico cada 2 horas hasta que la actividad se complete.

Cuando una actividad tiene un temporizador configurado, aparece un pequeño reloj en la esquina delicono de la actividad tal y como se muestra en la figura siguiente:

También puede configurar las fechas de vencimiento de los temporizadores que se inician cuandose inicia la actividad.

Ejemplos de expresiones de duración detemporizadores de actividadUna razón común para utilizar un temporizador es cuando se tiene un acuerdo de nivel de servicio(SLA) para completar una tarea en un determinado plazo. Por ejemplo, en una aplicación deprocesamiento de reclamaciones, la reclamación se debe procesar en un plazo de 10 días. Dado quedeben completarse varias tareas para procesar la reclamación, la aplicación utiliza dos medidas detiempo para la elevación. La primera medida es establecer un temporizador en función de cuándo seinicia el proceso. Un administrador recibe una notificación cuando la actividad no comienza a tiempo.La segunda medida se toma cuando la actividad está iniciada pero aún no ha finalizado. Durante estetiempo, un temporizador puede llevar a cabo una elevación a un administrador y reasignar la tarea.

La siguiente figura ilustra un proceso simple de procesamiento de reclamaciones:

Los siguientes ejemplos utilizan este proceso de procesamiento de reclamaciones.

Ejemplo de tiempo fijo

En el proceso de procesamiento de reclamaciones, un procesador tiene tres días para revisar ycompletar una reclamación. Este proceso utiliza tres temporizadores para asegurarse de que el



procesador revisa la tarea en tres días. El parámetro de la aplicación para controlar este SLA es SLAde revisión del procesador.

La tabla siguiente proporciona ejemplos de expresiones de duración de tiempo fijo:

Temporizador Expresión de duración (en días)

Establece un recordatorio para el día anterior a lafecha de vencimiento de revisión del proceso queenvía una notificación al ejecutor de la tarea.

parameters.app.processor_review_sl - 1

Define una alerta para el día de vencimiento de larevisión del proceso, que se envía al ejecutor de latarea y a un administrador.

parameters.app.processor_review_sl

Reasigna la tarea a un administrador el día despuésde la fecha de vencimiento de la revisión del proceso.

parameters.app.processor_review_sl + 1

Ejemplo de tiempo relativo

En el proceso del procesamiento de reclamaciones, la actividad de revisión del procesador se debecompletar en los 5 días posteriores al inicio del proceso. Este proceso utiliza tres temporizadores paraasegurarse de que la actividad se completa a tiempo. El parámetro de la aplicación para este SLA esSLA de tiempo de finalización de procesamiento.

La tabla siguiente proporciona ejemplos de expresión de duración del tiempo relativo:


Establece un recordatorio para el día anteriora la fecha de vencimiento de finalización delprocesamiento, que envía una notificación al ejecutorde la tarea.

differenceDays(addDays(process.process_instance.start_date,parameters.app.processing_completi - 1),now())

Establece una alerta para el día en que se debefinalizar el procesamiento, que se envía al ejecutorde la tarea y a un administrador.

differenceDays(addDays(process.process_instance.start_date,parameters.app.processing_completi),now())

Inicia un proceso de elevación el día posterior a lafecha de vencimiento del tiempo de finalización delprocesamiento.

differenceDays(addDays(process.process_instance.start_date,parameters.app.processing_completi + 1),now())

Ejemplo de tiempo definido por el usuario

En lugar de utilizar un parámetro de aplicación, puede utilizar un atributo en una variable de paquete ode proceso para determinar una fecha de vencimiento. En este caso, las expresiones de duración de lostemporizadores usan la variable de proceso "due_date".

La tabla siguiente proporciona ejemplos de expresiones de duración de tiempo definidas por el usuario:


Establece un recordatorio para el día anteriora la fecha de vencimiento de finalización delprocesamiento, que envía una notificación al ejecutorde la tarea.

differenceDays(addDays(process.Variables.due_date, - 1),now())




Establece una alerta para el día en que se debefinalizar el procesamiento, que se envía al ejecutorde la tarea y a un administrador.

differenceDays(process.Variables.due_date,now())

Vuelve a asignar la tarea a un administrador el díaposterior a la fecha de vencimiento del tiempo definalización del procesamiento.

differenceDays(addDays(process.Variables.due_date, 1),now())

Usar transiciones para especificar las actividadessiguientes del procesoLas transiciones determinan las actividades siguientes de un proceso. Con varios flujos salientes, puedeconfigurar la transición de manera que solo se realicen las actividades seleccionadas en función delresultado de la actividad. Por ejemplo, puede permitir que un revisor de diseño de formularios reenvíeel diseño al siguiente revisor o que lo devuelva al diseñador a fin de que lo vuelva a examinar. Paraconfigurar esta lógica de ramificación, cree flujos desde la primera actividad hasta las dos actividadesposteriores posibles. A continuación, permita al ejecutor decidir la ruta que desea seguir.

La transición seleccionada en una actividad define las siguientes actividades del flujo de procesocuando la actividad se completa en tiempo de ejecución. Existen tres tipos de transiciones de tiempode ejecución:

• Seleccionar todas las actividades conectadas: el sistema dirige el flujo de proceso a todas lasactividades posteriores.

• Permitir al ejecutor seleccionar las siguientes actividades: el ejecutor de la actividad determinalas siguientes actividades del flujo de proceso.

• Seleccionar las siguientes actividades según condiciones: el sistema dirige el flujo de proceso alas actividades posteriores evaluando las condiciones de transición de la actividad.

Si una actividad tiene varios flujos salientes con lógica de ramificaciones, representa un punto dedecisión en el proceso comercial global. Para mostrar de forma clara el punto de decisión del modelode proceso, puede insertar una actividad de división de decisión explícita en el flujo. En lugar deconfigurar transiciones en la actividad actual, asocie la actividad a una actividad de división dedecisión y configure las transiciones en esta última.

Determinar las condiciones de transiciónLas condiciones de transición permiten definir actividades que distribuyen tareas de forma diferente enfunción de los resultados de la actividad. Una condición de transición es una condición lógica con unoo varios flujos asociados. Cuando una actividad se completa en tiempo de ejecución, el sistema evalúasus condiciones de transición para determinar las actividades que se han de iniciar a continuacióncomo el siguiente paso del proceso. El servidor transfiere el proceso a las actividades asociadas ala primera condición de transición que se evalúe como VERDADERO. Una actividad puede tenervarias condiciones de transición, aunque el servidor solo selecciona la primera que se evalúe comoVERDADERO en tiempo de ejecución.

Al utilizar condiciones de transición, incluya una acción "Else". Si ninguna de las condiciones detransición se evalúa como VERDADERO, el sistema utiliza las transiciones "Else".



Notificaciones de actividad

El sistema envía una notificación de Documentum y una notificación por correo electrónico a unusuario final cuando uno de los siguientes eventos se produce en una actividad:

Evento El usuario que recibe la notificación

Cuando falla una tarea automática Supervisor del flujo de trabajo

Cuando se delega una tarea de usuario Usuario delegado

Cuando se crea una tarea de usuario Ejecutante de la tarea

En lugar de utilizar las notificaciones por correo electrónico, puede crear notificaciones por correoelectrónico personalizadas mediante una plantilla de correo electrónico. El servidor de correoelectrónico configurado en la configuración del repositorio envía las notificaciones por correoelectrónico.

Las notificaciones configuradas en las propiedades del proceso del modelo de proceso anulan lasnotificaciones del sistema.

Asignar datos dentro de actividades

La herramienta de asignación de datos de procesos proporciona una interfaz gráfica que simplifica elproceso de transferencia de datos de proceso. El área Origen está en un lado de la pantalla y el área deDestino está en el otro lado de la pantalla. Puede asignar datos de proceso o atributos en el área Origena atributos de servidor o proceso en el área Destino. Estos atributos pueden incluir argumentos demétodo de proceso, parámetros de servicio web, valores de devolución de consultas de base de datosy atributos específicos a los servicios como JMS, HTTP y FTP.

En la siguiente figura se muestra la herramienta de asignación de datos de procesos:



Muchas actividades automatizadas requieren la información de asignación de un origen de datos aotro. Por ejemplo, un proceso de creación de préstamos incluye una actividad que llama a un servicioweb para buscar la puntuación de crédito de un cliente. La actividad transfiere el número de seguridadsocial del paquete de la aplicación de préstamos al servicio web. La actividad, a continuación, copiala puntuación de crédito devuelta en otro atributo de paquete, de modo que está disponible paraactividades posteriores. Puede asignar datos de los atributos de paquete a los parámetros de entrada delservicio web y desde el mensaje de salida del servicio web a los atributos de paquete.

El contenido de las áreas Origen y Destino depende del tipo de actividad que configure. Para lasactividades que requieren valores de entrada, el área Origen, por lo general, muestra los atributospara todos los paquetes de proceso de negocio, las variables de proceso y las variables de ejecuciónen tiempo de ejecución. Las variables de ejecución en tiempo de ejecución, como el nombre delsupervisor, están disponibles en tiempo de ejecución.

El área central muestra las funciones que se utilizan para transferir datos del área Origen a los datos delárea Destino. La herramienta de asignación le permite copiar los valores directamente desde un origende datos a otro. También puede realizar conversiones de tipos de datos, concatenar cadenas, realizaroperaciones matemáticas con números e incluir valores de constantes.

Asignación de datos de procesos

En la herramienta de asignación de datos de procesos, el área central contiene iconos que representanlas funciones de asignación de datos de procesos. También incluye líneas que conectan los iconos de



función a sus argumentos de entrada y los destinos de salida. En tiempo de ejecución, la actividad pasalos valores de los argumentos de entrada y guarda el resultado como el valor del atributo de destino.

En la siguiente figura se muestra la asignación de datos en la herramienta de asignación de datos deprocesos:

Puede crear una función de asignación cada vez. La herramienta de asignación de datos de procesosrequiere que se complete una asignación (mediante la selección de sus parámetros de entrada y destinode salida) antes de comenzar con la siguiente asignación. Si el tipo de datos de un atributo no coincidecon el tipo de datos que la función espera, la conexión aparecerá como una línea discontinua. Cuandolos tipos de datos coinciden, la conexión aparece como una línea continua.

Si una función de asignación de datos no tiene todos los argumentos necesarios, aparecerá una X rojaen la esquina inferior derecha del icono de la función , lo que indica que la función está incompleta.

Puede hacer doble clic en un icono de función para abrir el Editor de funciones. Se muestra el nombrede la función, su sintaxis y una lista de los valores de entrada. El Editor de funciones le permite:

• Modificar el orden de los atributos: para una función que acepta varios argumentos de entrada,la lista de argumentos de entrada sigue el orden de las selecciones de atributo de origen. Puedecambiar el orden de estos atributos.

• Usar valores de entrada de constante en lugar de atributos: algunas funciones no tienenatributos como entradas debido a que todos sus valores de entrada son constantes. En lugar deseleccionar atributos en el área Origen, utilice el Editor de funciones para agregar los valores deentrada de constantes.

• Definir contexto de repetición: cuando el argumento de entrada para una función es un atributo devarios valores, la función puede procesar los valores de forma individual o todas simultáneamente.Cuando la función escribe su resultado en el atributo de destino, la función pueden sobrescribir losvalores existentes o agregar nuevos valores de atributo. Puede especificar cómo escribir estosvalores en el Editor de funciones.



Funciones de la asignación de datos

Se lleva a cabo una función de asignación de datos en los datos de un origen y se guarda el resultadoen un destino. El origen y el destino son nodos de datos de proceso disponibles para la actividad deintegración en la que tiene lugar la asignación.

Un icono de función representa la función en la herramienta de asignación de datos de procesos.Cuando hace doble clic, el icono de función se abre en el Editor de funciones. El Editor de funcionesmuestra el nombre de la función, su sintaxis y una lista de los valores de entrada esperados. Losnombres de los atributos enlazados a la función aparecen en formato XPath. Si el valor se basa enuna enumeración establecida, puede ver una lista de valores de enumeraciones del nodo de destino dela función.

Las funciones de asignación de datos se describen en la tabla siguiente:

Función Argumentos de entrada Resultado

Agregar Dos o más números. Suma de los argumentos de entrada.

Agregar día laboral Un valor de fecha entero, una cadenapara el calendario, y un entero paranoOfDays.

Agrega un día laboral al valor denoOfDays. El valor de un día laboralestá basado en el calendario comercialseleccionado.

Agregar días Un valor de fecha entero y un enteropara noOfDays.

Devuelve una fecha después de sumarel número especificado de días a lafecha.

De byte a cadena Dos cadenas, la primera representa losdatos binarios y la segunda especificael valor de codificación como, porejemplo, UTF-8, UNICODE, etc. Elvalor de codificación predeterminadoes UTF-8.

Datos como una cadena.

Concatenar Dos o más cadenas. Cadena concatenada compuesta por losargumentos de entrada en orden.

Copiar Un argumento de cualquier tipo. Argumento de entrada no modificado.

Cantidad (Objeto param[]) Devuelve el número de valores en laentrada de varios valores. Para lasentradas de un único valor, el valor dedevolución es 1.

Fecha a cadena Una fecha y una cadena que representanun patrón de fecha válido. El patrón defecha debe cumplir con el estándar deJava SimpleDateFormat. Para obtenermás información, consulte la API deJava y la documentación de referenciadel desarrollador.

Valor de fecha como una cadena con elpatrón especificado.

Dividir Dos o más números. Resultado de dividir el primerargumento de entrada por el segundoargumento. Cuando existen más de dosargumentos, cada número posterior seutiliza para dividir el resultado anterior.




Obtener día Entero. Devuelve un entero que representa elsegmento del día de la fecha.

Obtener correo electrónico Cadena. Consulta dm_user para devolver unadirección de correo electrónico para unusuario.

Obtener mes Entero. Devuelve un entero que representa elsegmento del mes de la fecha.

Obtener tiquet Cadena. Genera un tiquet de inicio de sesiónpara el nombre de usuario especificadoen tiempo de ejecución. Utiliza lasiguiente sintaxis: nombre de usuario,alcance, tiempo de espera, uso únicoy servidor.

Obtener valor Parámetro de cadena que especificael objeto y el número de posición delíndice.

Devuelve un valor de una posiciónespecificada en el índice.

Obtener año Entero. Devuelve un entero que representa elsegmento del año de la fecha.

Unir Dos o más matrices de cadenas. Crea una combinación de las entradasseleccionadas.

Multiplicar Dos o más números. Producto de los argumentos de entrada.

Dividir Cadena que puede incluir un valor deposición de índice opcional.

Devuelve una cadena de repetición ouna posición en el valor de repetición sise utiliza la posición de índice opcional.

Cadena a byte Dos cadenas, la primera representa losdatos y la segunda especifica el valorde codificación como, por ejemplo,UTF-8, UNICODE, etc. El valor decodificación predeterminado es UTF-8.

Datos binarios.

Cadena a fecha Dos cadenas, la primera proporcionauna fecha y la segunda especificasu patrón. El patrón de fecha debecumplir con el estándar de JavaSimpleDateFormat. Esta funciónadmite el formato MMMM solo en laconfiguración regional de inglés. Paraobtener más información, consultela API de Java y la documentaciónde referencia del desarrollador quese encuentra en el sitio web dedesarrollador de Sun.

Valor del tipo de datos de fecha.




Subcadena Una cadena, un número que representacuántos de los caracteres inicialesse eliminarán de la cadena y,opcionalmente, un número querepresenta la posición del últimocarácter que se incluirá en la subcadena.

Cadena compuesta de caracteres delprimer argumento de entrada, quecomienzan en la posición de inicioespecificada y que finalizan en laposición final especificada.

Por ejemplo, si los argumentos deentrada son unhappy y 2, el resultadoes la cadena happy. Si los argumentosde entrada son unhappy, 2 y 5, elresultado es hap.

Restar Dos o más números. Resultado de restar el segundo númeroal primer número. Cuando existenmás de dos argumentos, cada númeroposterior se resta al resultado anterior.

Reducir Cadena. Convierte la cadena en letrasminúsculas.

Aumentar Cadena. Convierte la cadena en letrasmayúsculas.

Atributos de varios valores

Los atributos de varios valores son atributos que contienen más de un valor. Por ejemplo, el atributoAutores del objeto de contenido es un atributo de varios valores ya que el contenido puede tenermás de un autor.

La herramienta de asignación de datos de procesos admite atributos multivalor, así como atributos deun solo valor. Utilice atributos de varios valores si desea especificar varios valores en las funcionesde asignación de datos de proceso. Puede identificar un atributo de varios valores mediante Agregarenlace que aparece junto a su nombre. El enlace Agregar le permite especificar valores independientespara el atributo. Estos valores son los valores de índice (por ejemplo, Authors [1] y Authors [2]).

La tabla siguiente describe los nodos de atributo con valores de índice:

Nodo de atributo Descripción

<nombre de atributo>[All] Apunta al conjunto completo de valores para dichoatributo. Por ejemplo, Authors[ALL] especifica todoslos autores del conjunto.

<nombre de atributo>[n] Indica una posición de índice específica para losatributos. Por ejemplo, Authors[0], Authors[1] yAuthors[2].

<nombre de atributo>[FIRST] Indica la primera posición de índice para el atributo.Por ejemplo, Authors[FIRST] es el primer autor dela lista.

<nombre de atributo>[LAST] Indica el atributo al final de cualquier otro atributoexistente. Por ejemplo, Authors[LAST] es el últimoautor de la lista.



Los atributos multivalor con el índice [ALL] se ubican en el área Origen de la herramienta deasignación de datos de procesos. No se encuentran en el área de destino. Cuando se asigna unatributo de varios valores con el índice [ALL], también tiene que especificar el contexto para elatributo de varios valores. El contexto proporciona información sobre cómo gestiona la función delproceso las entradas.

Usar atributos de varios valores como entrada afunciones

En la asignación de datos de proceso, una función puede utilizar los valores de un atributo de variosvalores mediante las siguientes opciones de contexto de entrada:

• Todos: la función realiza la acción en todos los valores al mismo tiempo y crea una salida deatributo de un solo valor. Por ejemplo, si asigna un atributo de varios valores cuyos valores seanenteros a una función Agregar, la salida es la suma de todos los valores de entrada.

• For-Each: la función realiza su acción una vez en cada uno de los valores individuales para generarvarias salidas. Por ejemplo, el atributo de varios valores LoanValue es un tipo de entero con valores100.000, 200.000 y 300.000. Si utiliza la función Multiplicar para multiplicar los valores por0,10, el resultado es 10.000, 20.000 y 30.000.

Puede hacer doble clic en un icono de función para abrir el Editor de funciones. El Editor de funcionesle permite configurar las opciones de contexto de entrada.

Especificar condiciones para datos de asignación

Un nodo de elementos de varios valores ( ) con el índice ALL es un indicador que lleva a unconjunto completo de atributos. Un nodo secundario con un índice de número entero señala a un soloelemento en dicho conjunto. Además de los nodos con valores de índice, puede agregar nodos basadosen condiciones. El sistema establece el valor de un nodo condicional ( ) cuando una condiciónespecificada se convierte en verdadera.

Por ejemplo, el nodo Workitem[ALL] es una lista de objetos que contienen datos sobre actividades.Una actividad de proceso denominada MyLastActivity requiere que datos sobre una actividaddenominada MyFirstActivity. En los datos de proceso de MyLastActivity, puede crear un nodode elemento de trabajo condicional cuyo valor se establezca cuando la condición act_name =MyFirstActivity sea verdadera. Los datos sobre MyFirstActivity, a continuación, se puedenasignar en el nodo condicional.

Puede agregar nodos condicionales para cualquier nodo de elementos de varios valores, incluyendo:

• Los nodos Workitem[ALL] ubicados en un nodo de datos de ejecución

• Los nodos Rendition[ALL] ubicados dentro de un paquete de contenido y dentro de un nodo deanexos

La figura siguiente muestra un nodo condicional agregado a un nodo de elementos de varios valores:



Vales de inicio de sesión

Los tiquets de inicio de sesión permiten a los usuarios finales conectarse al repositorio de formasegura sin tener que proporcionar credenciales. Puede configurar el tiquet para acceder a uno o variosrepositorios, para permitir más de un uso y para que caduque transcurrido un período de tiempoespecificado.

Por ejemplo, una actividad de proceso envía un mensaje de correo electrónico a un usuario finalsolicitando una actualización de información. El mensaje de correo electrónico contiene un enlaceal contenido del repositorio. El tiquet de inicio de sesión se integra en el enlace. Cuando el usuariofinal hace clic en el enlace para acceder al contenido del repositorio, el usuario final no tiene queiniciar sesión.

Utilice la función Obtener tiquet de la herramienta de asignación de datos de procesos para generarun tiquet de inicio de sesión para un determinado usuario final. El ejecutor de la actividad necesitaprivilegios de superusuario. Solo un usuario con privilegios de superusuario puede otorgar privilegiosde superusuario.


Capítulo 8Crear búsquedas, listas e informes deanálisis



Tareas

Crear una consulta1. En el navegador Servicios de datos, haga clic en Nuevo y seleccione un modelo de consulta.2. En el cuadro de diálogo Nueva consulta, especifique la configuración de la consulta tal y como se


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el modelo deconsulta.

Modelo principal En la lista de modelos de objeto, seleccione elmodelo de objeto que devolverá la consulta.

Para crear una consulta en tiempo real en unarelación, seleccione el modelo de objeto de origen.Puede seleccionar más adelante la relación en lapestaña Conjunto de datos.

Para crear una consulta de alerta, especifique todaslas alertas o una alerta específico en la aplicaciónactual. La consulta de alerta creada en Todas lasalertas muestra todas las alertas de docbase entreaplicaciones.


Editar las propiedades básicas de las consultas1. Haga clic en Conceptos básicos.2. Especifique las propiedades tal y como se describe en la siguiente página:


Crear búsquedas, listas e informes de análisis

Campo Descripción

Etiqueta Escriba una etiqueta para identificar la consulta. Sicambia esta etiqueta, el sistema genera un nuevonombre del sistema.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique la consulta cuando se utiliceen la API.


Tipo de servicio de datos Muestra el tipo de servicio de datos en el que sebasa la consulta.

Modelo principal Si el modelo principal seleccionado anteriormenteya no está disponible o se ha modificado su etiqueta,seleccione o cree un modelo principal válido parala consulta.

Tenga en cuenta que cambiar el modelo principalrestablece todos los parámetros de consulta.

Descripción Escriba una descripción para compartir con otrosdesarrolladores de aplicaciones.

Origen Identifica el proyecto al que pertenece la consulta.

Configurar entradas predefinidasEste procedimiento se aplica a consultas históricas, en tiempo real, de lista de tareas y de alerta.1. Haga clic en Conjunto de datos.2. Para agregar una entrada predefinida, realice lo siguiente:

a. Seleccione el modelo en el área superior de la paleta Datos de contexto.b. Arrastre un campo de datos del área inferior de la paleta Datos de contexto y suéltelo en

Entradas predefinidas.

Para consultas de alerta, si ha especificado todas las alertas como modelo principal y desealimitarlo a la aplicación actual, agregue el espacio de nombres de alerta como entradaspredefinidas y especifique el espacio de nombres de la aplicación actual como valor.

Para consultas históricas, no se permiten los siguientes elementos en los filtros predefinidos:

• Atributos de repetición• Atributos de fragmentos de tipo• Atributos de relación• Atributos relacionados con objetos de negocio• Variables de proceso• Variables de instancia de proceso• Atributos relacionados con paquetes de proceso• Variables relacionadas con tareas• Atributos de lista desplegable



3. En la vista Propiedades, especifique la configuración tal y como se describe en la tabla siguiente:

Campo Descripción

Operador Seleccione un operador para la entrada predefinida.

Valor Introduzca el valor con el que la restricción debecoincidir.

Si utiliza una función, asegúrese de que devuelve eltipo de atributo esperado.

Para los tipos de datos de cadena, utilice comillassimples.

Para los tipos de datos de hora y fecha, la restricciónse evalúa utilizando la zona de hora UTC, no la zonahoraria del usuario final. Los resultados puedenparecer incoherentes para los usuarios finales cuyazona horaria sea muy distinta a la zona horaria UTC.

Si selecciona el operador En o No está en,introduzca una lista de valores separados por comasentre llaves. Por ejemplo, {’Enviado’, ’Abierto’,’En curso’}. Los operadores En y No está en soloadmiten los tipos de datos String, Integer, Float yDate.

Si selecciona el operador Entre o No está entre,introduzca dos valores al igual que para el operadorEn. Los dos valores se incluyen en el rangoevaluado para la restricción.

Independiente de mayúsculas y minúsculas Para las consultas en tiempo real, seleccioneesta opción para que coincidan los valoresindependientemente del caso.

Un operador AND se utiliza entre entradas.

4. Para eliminar una entrada predefinida, haga clic con el botón secundario en la fila y seleccioneEliminar.

Configurar entradas de usuarioEste procedimiento se aplica a consultas en tiempo real, de lista de tareas y de alerta.

1. Haga clic en Entradas de usuario.

2. Para agregar una entrada de usuario, realice lo siguiente:

a. Seleccione el modelo en el área superior de la paleta Datos de contexto.

b. Arrastre un campo de datos del área inferior de la paleta Datos de contexto y suéltelo enEntradas de usuario.

Para las consultas en tiempo real, si utiliza campos de datos de un objeto relacionado como entradasde usuario, y si la relación tiene varios destinos, el sistema devuelve una instancia del modeloprincipal tan pronto como cualquier objeto relacionado coincide con la restricción.



Por ejemplo, si crea una consulta con el cliente como modelo principal y una entrada de usuariopara una cantidad de garantía inferior a un valor x, obtendrá una lista de todos los clientes paralos que al menos una garantía tiene una cantidad inferior al valor x, incluso aunque haya otrasinstancias de garantías relacionadas con una cantidad superior al valor x.

Para las consultas de alerta, la lista de campos de datos del área inferior de la paleta Datos decontexto depende del modelo principal especificado en la pestaña Conceptos básicos. Si el modeloprincipal especificado es Todas las alertas, se muestran los campos de datos comunes a todas lasalertas en docbase entre aplicaciones. Sin embargo, si el modelo principal seleccionado es unaalerta específica de la aplicación actual, se muestran los campos de datos de dicha alerta, así comoaquellos que son comunes a todas las alertas en docbase.

3. Para cada campo de datos incluido en una entrada, en la vista Propiedades, especifique laconfiguración tal y como se describe en la tabla siguiente:

Campo Descripción

Operador Seleccione un operador para el campo de datos.

Independiente de mayúsculas y minúsculas Para las consultas en tiempo real, seleccioneesta opción para que coincidan los valoresindependientemente del caso.

4. Para cada entrada de usuario, en la vista Propiedades, especifique la configuración tal y como sedescribe en la tabla siguiente:

Campo Descripción

Etiqueta de entrada Escriba una etiqueta para identificar la entrada. Sino la modifica durante la composición de página,se convierte en la etiqueta de entrada en tiempo deejecución.

Para facilitar la cumplimentación de los campos deentrada para los usuarios finales, indique también eloperador. Por ejemplo, Amount lower than o Namebegins with.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique la entrada cuando se utiliceen la API.

5. Para agregar otro campo de datos a la misma entrada de usuario, arrastre un campo de datos dela paleta Datos de contexto a la cuadrícula Campos de datos.

Solo puede agregar un campo de datos del mismo tipo que el primer campo de datos en unaentrada de usuario. Por ejemplo, si el primer campo de datos es una fecha/hora, el campo dedatos adicional debe ser una fecha/hora también.

6. Para crear una entrada adicional, arrastre y suelte un campo de datos desde la paleta Datos decontexto debajo del último campo de datos de la última entrada.

7. Para eliminar una entrada, haga clic derecho debajo de la Etiqueta de entrada y seleccioneEliminar.

8. Para eliminar un campo de datos en una entrada, haga clic con el botón secundario en la fila yseleccione Eliminar.



Configurar un conjunto de datos de consulta entiempo real1. Haga clic en Conjunto de datos.

El modelo principal de la consulta en tiempo real y el primer nivel de sus relaciones aparecen enRelación de datos.

2. Para devolver una relación en lugar del modelo principal seleccionado anteriormente, seleccioneuna relación en el cuadro de listaModelo devuelto.

Si configura una consulta para devolver relaciones, el sistema mostrará una lista de objetosrelacionados en tiempo de ejecución, pero las acciones disponibles para los usuarios son específicasde la relación.

3. Para agregar una columna al conjunto de datos, realice lo siguiente:

a. Seleccione el modelo en el área superior de la paleta Datos de contexto.

b. Arrastre un campo de datos del área inferior de la paleta Datos de contexto y suéltelo enColumnas de salida.

• Si el modelo de consulta incluye una relación, solo puede seleccionar un atributo de variosvalores como columna de salida. Puede ser un atributo del objeto de origen, un atributo delobjeto de destino o un atributo aplicable para la relación.

• Si el modelo de consulta incluye una relación con varios destinos, no se pueden seleccionarcomo atributos de columnas de salida desde otras relaciones o desde otros objetos de destino.

4. Seleccione Devolver todas las versiones para mostrar todas las versiones de un documento en elresultado de búsqueda, en tiempo de ejecución. Si no selecciona Devolver todas las versiones,solo la versión actual de un documento se muestra en el resultado de búsqueda.

Devolver todas las versiones no está disponible para selección cuando:

• El modelo principal seleccionado es un objeto de carpeta.

• El modelo devuelto seleccionado es de una relación.

5. Seleccione Devolver el recuento de visitas para obtener el recuento de los registros devueltos poruna consulta de búsqueda.

Note: Al seleccionar esta opción, el sistema podría ralentizar el rendimiento de la consulta debúsqueda.

6. Para configurar el tamaño máximo del resultado de la consulta, escriba el tamaño en Tamañomáximo del resultado. El valor predeterminado es –1. Cuando el valor se establece como –1, lalimitación de tamaño de REST de 1000 resultados entra en vigor. En cualquier otro caso, puedeestablecer el valor deseado para el tamaño del resultado.

Puede configurar la propiedad en el archivo rest-api-paging-config.properties o el archivorest-api-runtime.properties para establecer el límite de tamaño máximo de resultados a 1000:

rest.paging.max.size=1000

7. Para cada columna, en la vista Propiedades, especifique la configuración tal y como se describeen la tabla siguiente:



Campo Descripción

Etiqueta Escriba una etiqueta para identificar la columna.

Si no la modifica durante la composición de página,se convierte en el encabezado de columna en tiempode ejecución.

Habilitar la opción de clasificación Seleccione esta opción para indicar que la columnase puede ordenar. No se admiten los camposde datos que puede tener varios valores comoatributos de varios valores y atributos de un objetorelacionado para las relaciones de varios destinos.

Columna de ordenación predeterminada paraconsulta

Para ordenar los resultados por un campo de datos,configure la columna para que se pueda ordenar y, acontinuación, seleccione Columna de ordenaciónpredeterminada para consulta.

En tiempo de ejecución, no hay ningún indicadorvisual de la columna seleccionada.

Dirección predeterminada Especifique la dirección de ordenación parala columna de ordenación predeterminadaseleccionada.

8. Para eliminar una columna de salida, haga clic en ella y seleccione Eliminar.

Puede definir una relación con el objeto de contenido y crear una consulta en tiempo real paradevolver la relación. El objeto de contenido se puede versionar y el resultado de la búsquedamuestra la relación con el objeto de contenido con versiones. Además, puede definir una relacióncon el objeto de contenido como su objeto secundario y crear una consulta en tiempo real paradevolver el modelo primario. Tras versionar el objeto de contenido secundario, el resultado de labúsqueda devolverá el objeto de contenido secundario con versiones.

Buscar en los objetos relacionadosUtilice este procedimiento para crear una búsqueda en los objetos según su relación con un objeto deorigen, como una lista de garantías de un cliente.1. En el navegador de servicios de datos, cree un modelo de consulta en tiempo real.2. Seleccione el objeto de origen de la relación comoModelo principal. Por ejemplo, seleccione el

objeto de negocio Cliente.3. En la pestaña Conjunto de datos, seleccione la relación entre Cliente y Garantía comoModelo

devuelto.4. Seleccione los campos de datos como Columnas de salida. Por lo general, se seleccionan los

campos de datos del objeto relacionado (por ejemplo, el objeto de negocio Garantía).

Independientemente de los campos de datos que elija mostrar en tiempo de ejecución, las accionesdisponibles en los elementos de la lista son específicas de la relación.

Solo puede seleccionar un atributo de varios valores.

5. En el navegador de interfaz de usuario, cree o abra la página correspondiente al modelo principal(por ejemplo, el objeto de negocio Cliente).

6. Cree una instancia del modelo de consulta en tiempo real.



7. Agregue un widget de Lista de resultados y enlácelo a la instancia de servicio de datos. Sila instancia del servicio de datos que desea seleccionar no existe, agréguela desde el panelInteracciones del editor de diseño.

El sistema realiza automáticamente las operaciones siguientes:

• Genera y enlaza widgets de entrada para la instancia.• Configura las columnas en la lista de resultados de las columnas de salida de la instancia.• Genera y configura un botón de búsqueda para iniciar la búsqueda cuando se hace clic en él.

Suscribir una consulta histórica a un evento denegocio1. Haga clic en Colección de datos.2. Arrastre un evento desde la paleta Eventos y colóquelo en Suscripción.3. Para eliminar una suscripción, haga clic con el botón secundario en un evento y seleccione

Eliminar.

Configurar un conjunto de datos de consultahistórica1. Haga clic en Conjunto de datos.2. Para agregar una columna al conjunto de datos, realice lo siguiente:

a. Seleccione el modelo en el área superior de la paleta Datos de contexto.b. Arrastre un campo de datos del área inferior de la paleta Datos de contexto a Columnas de

conjunto de datos.

Si va a enlazar este conjunto de datos a un widget de gráfico, incluya al menos una columnanumérica en el conjunto. No es obligatorio incluir una columna numérica al enlazar el conjuntode datos a un widget Lista de resultados.

En los modelos de objeto relacionados, al configurar una consulta histórica para suscribirse a unevento de negocio del objeto relacionado, la paleta Datos de contexto muestra dos nodos demodelo de objeto: el nodo de modelo de objeto de origen y el nodo <nombre del modelo deobjeto> relacionado. Para informar acerca del modelo de objeto relacionado, arrastre y sueltelos campos de datos necesarios desde el nodo <nombre del modelo de objeto> relacionado hastaColumnas de conjunto de datos.

Si necesita cambiar el orden de las columnas de conjunto de datos puede configurar de nuevola consulta y agregar las columnas en el orden correcto, o cambiar el orden de las columnasen el widget Lista de resultados.

3. Para eliminar una columna de conjunto de datos, haga clic con el botón secundario en ella yseleccione Eliminar.

Los cálculos basados en una columna eliminada también se eliminarán.

4. Para editar el nombre de una columna, selecciónela y modifique la Etiqueta en la vistaPropiedades.

La figura siguiente contiene un conjunto de datos de consulta histórica:



Crear una columna de duración en una consultahistóricaAntes de realizar esta tarea, la consulta histórica debe suscribirse a varios eventos de negocio.1. En la ficha Cálculo, haga clic en Agregar cálculo.2. Seleccione Crear una columna de duración y haga clic en Siguiente.3. En el cuadro de diálogo Columna calculada, especifique la configuración tal y como se describe


Campo Descripción

Etiqueta Escriba una etiqueta para la columna.

De Seleccione un evento de negocio.

A Seleccione un evento de negocio.

En Seleccione una unidad de tiempo.

4. Haga clic en Finalizar.5. Para eliminar una columna de duración, haga clic con el botón secundario y seleccione Eliminar.

Crear una columna calculada en una consultahistórica1. En la ficha Cálculo, haga clic en Agregar cálculo.2. Seleccione Crear una columna calculada y haga clic en Siguiente.

No puede crear una columna calculada con los datos agregados en el paso 2 o un cálculo superior.3. En el cuadro de diálogo Columna calculada, especifique la configuración tal y como se describe


Campo Descripción

Etiqueta Escriba una etiqueta para la columna.



Campo Descripción

Tipo de datos Seleccione el tipo de datos de la columna calculada.

Expresión Haga clic en Seleccionar y utilice el editor deexpresiones para definir una expresión.

4. Haga clic en Finalizar.5. Para eliminar una columna calculada, haga clic con el botón secundario en ella y seleccione

Eliminar.

Aplicar una función de agregación a una consultahistóricaUtilice este procedimiento para agregar columnas de una consulta histórica. Los datos en tiempo deejecución devueltos por la consulta histórica no pueden ser NULL para los atributos de fecha y cadena.Si una instancia en tiempo de ejecución contiene datos NULL, la agregación presentará errores.1. En la ficha Cálculo, haga clic en Agregar cálculo.2. Seleccione Aplicar funciones de agregación.3. Seleccione una columna y haga clic en Siguiente.4. Seleccione una o más funciones y haga clic en Finalizar.

No puede crear una columna calculada con los datos agregados en el paso 2 o un cálculo superior.5. Para eliminar una columna de salida, haga clic en ella y seleccione Eliminar.6. Para modificar un nombre de columna de salida, cambie el nombre de columna en la ficha

Conjunto de datos.

Editar una columna calculada o de duración en unaconsulta histórica1. Abra un modelo de consulta histórica.2. En la ficha Cálculo, seleccione una columna de salida calculada o de duración.3. En la ficha Cálculos de la vista Propiedades, en el campo Tipo de datos, seleccione un tipo de

datos.4. Haga clic en Seleccionar y edite la expresión.

Editar una columna agregada en una consultahistórica1. Abra un modelo de consulta histórica.2. Seleccione Cálculo.3. Seleccione una columna de salida.4. En la ficha Cálculos de la vista Propiedades, seleccione Dimensión o una Función.



Configurar entradas de usuario de consulta histórica1. Haga clic en Entradas de usuario.2. Arrastre y suelte una columna Resultado de la agregación o Resultado de la auditoría de la

paleta Datos de contexto en el lienzo.3. Utilice la tabla siguiente para configurar la entrada de usuario en la vista Propiedades:

Campo Descripción

Etiqueta Identifica la entrada de usuario. La etiqueta apareceen la aplicación en tiempo de ejecución. Si cambiaesta etiqueta, el sistema genera un nuevo nombredel sistema.

Nombre El nombre de sistema para uso interno del mismoque identifica la entrada de usuario cuando se utilizaen la API.

Este nombre se basa en la etiqueta.

Campo de datos Representa la columna de salida de la que se derivala entrada del usuario.

Tipo de lista de valores Seleccione Entrada de usuario o Valores de listadesplegable para proporcionar todos los valoresdiferentes.

Los tipos de datos admitidos por los valores deentrada de usuario incluyen entero, flotante, cadena,hora y fecha y booleano.

Para forzar al usuario final a que seleccione unaentrada de usuario, elijaObligatorio. Si una entradade usuario es obligatoria, el gráfico no contienedatos hasta que el usuario final selecciona unaentrada de usuario.

Operador Seleccione un operador. El tipo de datos determinala lista de operadores de entre los que seleccionar.El tipo de datos booleanos no requiere ningunaconfiguración.

En tiempo de ejecución, el sistema muestra eloperador y la etiqueta de forma conjunta.

Usar la acción de volver a agregar en una consultahistóricaLa consulta histórica proporciona a los usuarios finales datos calculados como totales, comparacionesde cantidades y agregaciones. Cuando se definen las agregaciones para una consulta histórica, aveces los datos se pueden dañar. Por lo tanto, el usuario final debe realizar una serie de pasos paracorregir los datos dañados.

Para solucionar el problema, utilice la acción de volver a agregar. El sistema procesa nuevamente,desde el principio, todos los datos disponibles en las tablas de historial de BAM y tablas de agregación.



• Para volver a agregar todas las consultas históricas disponibles en una aplicación:

http://localhost:8080/bam-server/admin?action=re-aggregate&namespace=<namespace of the HDS query>

where,<namespace of the HDS query> is the namespace of theapplication or project where thehistorical query resides.

• Para volver a agregar una consulta histórica específica disponible en una aplicación:

http://localhost:8080/bam-server/admin?action=re-aggregate&namespace=<namespace of the HDS query>&hdsname=<Name of the HDS query>

where,<namespace of the HDS query> is the namespace of the

application or project where thehistorical query resides.

<Name of the HDS query> is the name of thecreated historical query.

Note: No indique el espacio de nombres del atributo hdsname de la consulta al mencionar elnombre de la consulta histórica. Puede verificar el hdsname en la columna NAME de la tablaBAM_D_DS de la base de datos BAM.

Si tiene una gran cantidad de datos, como millones de registros para procesar, como parte de laconsulta histórica, la acción de volver a agregar puede tardar un par de horas en completarse. Por lotanto, debe planear la acción de volver a agregar en horas en las que no haya mucha carga en BAM.Para realizar el seguimiento del progreso de la acción de volver a agregar, consulte los mensajes queempiezan por Trabajo de volver a agregar en el archivo de registro de BAM.Nota: Asegúrese de que el registro de BAM esté habilitado.

Si hay una alerta configurada para una consulta histórica y se realiza la acción de volver a agregar, laalerta se desencadena de nuevo.

Utilizar la acción de limpieza en una consultahistóricaOcasionalmente, los datos almacenados se vuelven inmanejables debido a su gran tamaño. Por logeneral, los datos disponibles en la base de datos se utilizan con fines de auditoría y se vuelvenredundantes al cabo de un tiempo. Si los datos han superado el espacio de disco, es necesario limpiarla base de datos. Por lo tanto, el sistema proporciona acciones de purga y limpiar-hd que permitenpurgar totalmente los datos.

Precaución: antes de realizar la acción, es obligatorio hacer copia de seguridad de los datos. Estaoperación no se puede deshacer y el sistema no proporciona un mecanismo para recuperar los datos.

• Para purgar todos los datos de las tablas de historial de BAM, tablas de agregación y tablas deentidades (por ejemplo, BO, procesos y actividad):

http://localhost:8080/bam-server/admin?action=purge&namespace=<namespace of the HDS query>




• Para purgar todos los datos hasta el último día del año especificado:

http://localhost:8080/bam-server/admin?action=purge&namespace=<namespace of the HDS query>&year=<Specify the year that identifies the last dayof the year up to which the data must be deleted>


• Para purgar todos los datos de las tablas de historial de BAM y tablas de agregación solamente:

http://localhost:8080/bam-server/admin?action=clean-hds&namespace=<namespace of the HDS query>


• Para purgar todos los datos hasta el último día del año especificado:

http://localhost:8080/bam-server/admin?action=clean-hds&namespace=<namespace of the HDS query>&year=<Specify the year that identifies the last day

of the year up to which the data must be deleted>


Si tiene una gran cantidad de datos, como millones de registros que desea eliminar, como parte de laconsulta histórica, la acción de purga o limpieza de hd puede tardar un par de horas en completarse.Por lo tanto, debe planear estas acciones en horas en las que no haya mucha carga en BAM. Pararealizar el seguimiento del progreso de estas acciones, consulte los mensajes relacionados con laeliminación o limpieza en el archivo de log de BAM.

Configurar un conjunto de datos de consulta detexto completo1. Haga clic en Conjunto de datos.

2. Para agregar una columna al conjunto de datos, arrastre un campo de datos de la paleta Datos decontexto y suéltelo en Columnas de salida.

Si no incluye la columna Nombre en la salida, el nombre de objeto no aparecerá en los mensajes alutilizar las funciones de copiar y cortar durante el tiempo de ejecución.




Campo Descripción

Etiqueta Escriba una etiqueta para identificar la columna. Sino la modifica durante la composición de página, seconvierte en el encabezado de columna en tiempode ejecución.

Activar la opción de clasificación Seleccione esta opción para indicar que la columnase puede ordenar. No se admiten los camposde datos que puede tener varios valores comoatributos de varios valores y atributos de un objetorelacionado para las relaciones de varios destinos.

Activar la opción de ordenación para unaaplicación que ya se ha implementado provoca unareindexación que lleva a cabo Documentum xPloreal volver a implementar la aplicación. Asegúresede que la latencia inducida por el tiempo dereindexación es aceptable para los usuarios finales.La indexación lleva desde unas horas hasta variassemanas para millones de objetos.



De forma predeterminada, no se selecciona ningúncampo de datos para el orden predeterminado. Losresultados aparecen en orden de clasificación, tal ycomo determina Documentum xPlore.






6. Seleccione Genere resúmenes de los resultados de búsqueda y resalte las ocurrencias deltérmino de la búsqueda para mostrar resúmenes con resultados y resaltar las ocurrencias de lostérminos de búsqueda en el conjunto de resultados.

7. Seleccione Devolver todas las versiones para mostrar todas las versiones de un documento en elresultado de búsqueda, en tiempo de ejecución. Si no selecciona Devolver todas las versiones,solo la versión actual de un documento se muestra en el resultado de búsqueda.

Devolver todas las versiones no está disponible para la selección cuando el modelo principalseleccionado es un objeto de carpeta.



8. Para configurar el tamaño máximo del resultado de la consulta, escriba el tamaño en Tamañomáximo del resultado. El valor predeterminado es –1. Cuando el valor se establece en –1, lalimitación de tamaño de REST de 1000 resultados entra en vigor. En cualquier otro caso, se puedeestablecer el valor deseado para el tamaño del resultado.

Puede configurar la propiedad en el archivo rest-api-paging-config.properties o el archivorest-api-runtime.properties para establecer el límite de tamaño máximo de resultados a 1000:


Configurar entradas predefinidas de consulta detexto completo1. Haga clic en Conjunto de datos.

2. Para agregar una entrada predefinida, arrastre un campo de datos de la paleta Datos de contexto ycolóquelo en Entradas predefinidas.

3. En la vista Propiedades, especifique la configuración tal y como se describe en la tabla siguiente:

Campo Descripción

Operador Seleccione un operador para la entrada predefinida.

Valor Introduzca el valor con el que la restricción debecoincidir.

Para los tipos de datos de cadena, utilice comillassimples.

Para los tipos de datos de hora y fecha, la restricciónse evalúa utilizando la zona de hora UTC, no la zonahoraria del usuario final. Los resultados puedenparecer incoherentes para los usuarios finales cuyazona horaria sea muy distinta a la zona horaria UTC.

Si selecciona el operador En o No está en,introduzca una lista de valores separados por comasentre llaves. Por ejemplo, {’Enviado’, ’Abierto’,’En curso’}. Los operadores En y No está en soloadmiten los tipos de datos String, Integer, Float yDate.

Si selecciona el operador Está entre o No estáentre, introduzca dos valores al igual que para eloperador En. Los dos valores se incluyen en elrango evaluado para la restricción.

Hacer coincidir variaciones, faltas y erroresortográficos

Seleccione esta opción para tener en cuenta loserrores tipográficos y las variaciones ortográficasen los valores de entrada.

Esta opción solo está disponible para los tipos dedatos de cadena de caracteres y para los operadores= !=, Contiene y No contiene.




4. Para eliminar una entrada predefinida, haga clic con el botón secundario en la fila y seleccioneEliminar.

Configurar entradas de usuario de consulta de textocompleto1. Haga clic en Entradas de usuario.

2. Para mostrar una entrada de usuario que permita la búsqueda de texto completo en cualquiercampo de datos y en el contenido, seleccione Incluir un campo de entrada para la búsquedade texto completo.

3. Para tener en cuenta los errores tipográficos y las variaciones ortográficas en los valoresintroducidos por el usuario en los campos de entrada para la búsqueda de texto completo, seleccioneTambién hacer coincidir variaciones, faltas y errores ortográficos.

4. Para agregar una entrada de usuario, arrastre un campo de datos de la paleta Datos de contexto ycolóquelo en Entradas de usuario.

5. Para cada campo de datos incluido en una entrada, en la vista Propiedades, especifique laconfiguración tal y como se describe en la tabla siguiente:

Campo Descripción

Operador Seleccione el operador que va a utilizarse con estecampo de datos.

Para obtener los metadatos descubiertos encontradopor clasificación (términos comerciales (EE. UU.) oCiencia e Ingeniería), utilice el operador Contieneo el operador Termina con. El operador Contienecoincide con cualquier valor en la ruta completade los metadatos descubiertos, mientras que eloperador Termina con coincide con el último valorde la ruta de acceso.

Para los Metadatos descubiertos de lugares quese almacenan como una ruta de acceso como deEuropa/Francia/París, utilice el operador Contienepara hacer que coincida cualquier término de la rutacompleta.

Hacer coincidir variaciones, faltas y erroresortográficos

Seleccione esta opción para tener en cuenta loserrores tipográficos y las variaciones ortográficas enlos valores introducidos por el usuario.

Esta opción solo está disponible para los tipos dedatos de cadena y para los operadores = y Contiene.

6. Para cada entrada de usuario, en la vista Propiedades, especifique la configuración tal y como sedescribe en la tabla siguiente:



Campo Descripción

Etiqueta de entrada Escriba una etiqueta para identificar la entrada. Sino la modifica durante la composición de página,se convierte en la etiqueta de entrada en tiempo deejecución.

Para facilitar la cumplimentación de los campos deentrada, indique también el operador. Por ejemplo,Amount lower than o Name begins with.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique la entrada cuando se utiliceen la API.

7. Para agregar otro campo de datos a la misma entrada de usuario, arrastre un campo de datos de lapaleta Datos de contexto y suéltelo en la cuadrícula Campos de datos.

Un operador OR se utiliza entre los campos de datos en la misma entrada.

Solo puede agregar un campo de datos del mismo tipo que el primer campo de datos en unaentrada de usuario. Por ejemplo, si el primer campo de datos es una fecha/hora, el campo dedatos adicional debe ser una fecha/hora también.

8. Para crear una entrada adicional, arrastre y suelte un campo de datos desde la paleta Datos decontexto debajo del último campo de datos de la última entrada.


9. Para eliminar una entrada, haga clic derecho debajo de la Etiqueta de entrada y seleccioneEliminar.

10. Para eliminar un campo de datos en una entrada, haga clic con el botón secundario en la fila yseleccione Eliminar.

Configurar facetas de consulta de texto completo1. Haga clic en Facetas.

2. Para agregar una faceta, arrastre un campo de datos de la paleta Datos de contexto y colóqueloen Facetas.

3. En la pestaña General de la vista Propiedades, especifique la configuración, tal y como sedescribe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar la faceta. Nopuede modificar la etiqueta durante la composiciónde página; esta etiqueta se muestra en tiempo deejecución.

Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique la faceta cuando se utiliceen la API.



Campo Descripción

Definir una faceta principal Seleccione un campo de datos como facetaprincipal. La faceta principal es el campo de datosde nivel anterior para la búsqueda avanzada.

Los campos de datos agregados en la tabla defacetas que se pueden utilizar como faceta principalsólo se muestran en la lista desplegable. Asimismo,las facetas de fecha-hora agrupadas por fechasrelativas no se pueden usar como faceta principal.

Aparecer al seleccionar el valor de la faceta Especifique una expresión para obtener un valorpara que aparezca en tiempo de ejecución, alseleccionar el valor de faceta.

No disponible para selección si la faceta principaltiene valores de rango.

4. En el área Valores de faceta, especifique la configuración tal y como se describe en la tablasiguiente:

Campo Descripción

Ordenar Cuando se recuperen valores distintos de losresultados o las fechas agrupadas por unidadde tiempo, especifique el orden de clasificaciónutilizado para mostrar los valores de faceta entiempo de ejecución.

Establecer un límite en los valores de faceta Cuando se recuperen valores distintos de losresultados, seleccione esta opción para especificar elnúmero máximo de valores que se van a recuperarpara la faceta.

Un gran número de valores, como, por ejemplo,cientos de ellos, pueden mermar el rendimientoal cargar los resultados de la página en tiempo deejecución. Muy pocos valores no proporcionan alos usuarios finales una visión representativa delconjunto de resultados y solo les permite examinarun subconjunto de los mismos. Para asegurarsede que los usuarios finales obtienen una facetarepresentativa, seleccione ordenar los valores porfrecuencia.

Valores distintos de resultados Seleccione esta opción para mostrar los valores quecoinciden con los resultados de forma individual.



Campo Descripción

Intervalos numéricos personalizados Seleccione esta opción para agrupar los valores paralos campos de datos de tipo entero o flotante y, acontinuación, realice los pasos siguientes:

1. Haga clic en Agregar para agregar un intervalo.

2. Escriba una etiqueta para identificar el rango.Por ejemplo, para crear un intervalo para uncampo de datos de tamaño, escriba 0-100 KB.

3. Escriba un valorMínimo y/o un valorMáximo.

Los valores mínimo y máximo se incluyen en elrango. Para incluir en el rango todos los valoresmayores o iguales a un valor, indique solo ellímite inferior. Por ejemplo, para un intervalode 0 a 100 KB, escriba solo 100 como valormínimo.Para incluir en el intervalo todos los valoresmenores o iguales que un valor, indique soloel límite superior. Por ejemplo, para un rango0-100 KB, solo escriba 100 como el valormáximo.

Para definir un intervalo numérico personalizado,debe incluir el número de inicio y excluir elnúmero final. Por ejemplo, si el intervalo enterose personaliza como 1-3 3-9 9-100, 1-3 significa(x>= 1 y x<3), 3-9 significa (x>= 3 y x<9) y9-100 significa (x>= 9 y x<100).Para fechas personalizadas, junio de 2015significa >=2015-06-01 00:00:00 y < 2015-07-0100:00:00.

4. Para eliminar un rango, selecciónelo y haga clicen Quitar.

5. Para ordenar los rangos, seleccione uno de losrangos y haga clic en Subir o Bajar.

Intervalos de fechas agrupados Fecha Campos de fecha de datos de grupo porFechas relativas o por unidades de tiempo: Días,Semanas,Meses, Trimestres o Años.

Buscar contenido del repositorioUtilice este procedimiento para crear una búsqueda global para la aplicación. La búsqueda recuperatodos los modelos de objeto: objetos de negocio, carpetas y objetos de contenido.

1. En el navegador de servicios de datos, cree un modelo de consulta de texto completo.

2. En el cuadro de diálogo Nueva consulta de texto completo, seleccione Todos los modelos comoModelo principal.



3. En el editor de consultas, en la pestaña Conjunto de datos, configure columnas de salida yentradas predefinidas.

La paleta Datos de contexto solo muestra campos de datos comunes para todos los modelos.4. En la pestaña Entradas de usuario, seleccione Incluir un campo de entrada para la búsqueda

de texto completo.5. En el navegador de interfaz de usuario, cree o abra una página de aplicación.6. Cree una instancia del modelo de consulta de texto completo.7. Para evitar un tiempo de carga prolongado, no seleccione la opción de actualización Al cargar

la página.8. Agregue un widget de Lista de resultados y enlácelo a la instancia.

El sistema genera automáticamente y enlaza un widget de entrada para la instancia.

Buscar contenido de carpetaLa búsqueda de texto completo que se describe en este procedimiento le permite recuperar todos losmodelos de objeto que contiene la carpeta y sus subcarpetas. Difiere del servicio de datos en tiemporeal de contenido de carpeta en que está disponible de forma preestablecida y en que solo le permiterecuperar objetos de carpeta.1. En el navegador de servicios de datos, cree un modelo de consulta de texto completo.2. En el cuadro de diálogo Nueva consulta de texto completo, para recuperar todos los objetos,

seleccione Todos los modelos comoModelo principal.

Para recuperar solo objetos de un modelo de específico, seleccione el modelo de objeto.3. En el editor de consultas, en la pestaña Conjunto de datos, configure columnas de salida y

entradas predefinidas.4. En la pestaña Entradas de usuario, configure las entradas como sigue:

a. Arrastre y suelte el campo de datos Carpetas principales.b. En la vista Propiedades del campo de datos, seleccione una opción de Recursión para buscar

solo en esta carpeta o para buscar en esta carpeta y en todas sus subcarpetas.c. Agregue entradas de usuario según sea necesario:

• Para agregar una sola entrada de texto completo, seleccione Incluir un campo de entradapara la búsqueda de texto completo.

• Para agregar entradas en campos de datos específicos, arrastre y suelte los campos de datosdesde la paleta Datos de contexto.

5. En el navegador de interfaz de usuario, cree o abra una página específica del modelo de carpeta enel que desee realizar una búsqueda.

6. En el área Interacciones, cree una instancia del modelo de consulta de texto completo.7. En la vista Propiedades, haga clic en Entradas.

a. Seleccione la fila del atributo de carpetas principales.b. Junto al editor de expresiones, haga clic en Seleccionar.c. En el área superior de la pestaña Datos de contexto, seleccione el modelo de carpeta.

Si el modelo de carpeta no está disponible en los datos de contexto, probablemente se deba aque ha seleccionado una página de aplicación en lugar de una página específica del modelode carpeta.



d. En el área inferior de la pestaña Datos de contexto, seleccione el atributo de ID de objeto yhaga clic en Aceptar.

8. Agregue un widget de Lista de resultados y enlácelo a la instancia.El sistema genera automáticamente y enlaza widgets de entrada para la instancia.

Para permitir que los usuarios finales sepan cuál es la carpeta que se utiliza para la búsqueda, agregueun campo de visualización de valor enlazado con el nombre de la carpeta o la ruta de la carpeta.

Crear una consulta de lista de tareas1. En el navegador Servicios de datos, haga clic en Nuevo→Consulta de lista de tareas.

2. En el cuadro de diálogo Nueva consulta de lista de tareas, especifique la configuración de laconsulta tal y como se describe en la tabla siguiente:

Campo Descripción


Proyecto Si la aplicación contiene proyectos, seleccione elproyecto para la consulta.

Tareas asignadas a Seleccione el responsable para el que se ha creadola lista.


Configurar las propiedades básicas de una consultade lista de tareas1. Haga clic en Conceptos básicos.

2. Especifique la configuración tal y como se describe en la tabla siguiente:

Campo Descripción


Nombre del sistema Escriba un nombre de sistema para uso interno delsistema que identifique la consulta cuando se utiliceen la API.


Tipo de servicio de datos Identifica el tipo de servicio de datos.

Tareas asignadas a Seleccione el responsable para el que se ha creadola lista.



Campo Descripción

Filtrar por cola de trabajos 1. Haga clic en Seleccionar.

2. En el cuadro de diálogo Agregar cola detrabajos, realice una de las siguientes accionespara seleccionar las colas de trabajos desde lasque desea mostrar las tareas:

• Utilice los botones de flecha para seleccionaruna o varias colas de trabajos de la lista Colasde trabajos disponibles.

Las colas de trabajos que se muestran son losparámetros de aplicación de colas definidosen la aplicación.

• Haga clic en Nuevo parámetro para crear unparámetro de aplicación de la cola de trabajos.

Puede modificar el parámetro más adelante enel navegador de aplicaciones.

Si selecciona varias colas de trabajos, el sistemaagrega automáticamente una entrada al modelo deconsulta que corresponde con la lista de colas detrabajos. En tiempo de ejecución, el usuario finalpuede filtrar las tareas mediante la selección de unacola de trabajos en la lista.

Filtrar por proceso Seleccione todos los procesos en la aplicación oespecifique los procesos que desea incluir en laconsulta:

1. Haga clic en Seleccionar.

2. En el cuadro de diálogo Agregar proceso,realice una de las siguientes acciones paraseleccionar los procesos desde los que deseamostrar las tareas.

• Utilice los botones de flecha para seleccionaruno o varios procesos de la lista Procesosdisponibles. Solo los procesos que están sinestado están disponibles.

• Haga clic en Nuevo artefacto de procesopara crear un modelo de proceso.

Después de configurar el modelo de consultade lista de tarea, complete la configuracióndel modelo de proceso en el navegador deprocesos.

Descripción Escriba una descripción para compartir con otrosdesarrolladores de aplicaciones.

Origen Identifica el proyecto al que pertenece la consulta.

Si utiliza una base de datos de Oracle, puede intentar mejorar el tiempo de respuesta de unaconsulta de lista de tareas compleja, por ejemplo, al mostrar atributos de objeto de negocio que



no se incluyan en un paquete a los que se accede mediante una relación, ajustando la base dedatos con los siguientes parámetros:

• optimizer_index_caching=95

• optimizer_index_cost_adj=5

Pruebe los cambios realizados en estos parámetros, ya que la configuración del entorno controlatanto la mejora del rendimiento como cualquier efecto secundario que pueda presentarse.

Configurar un conjunto de datos de consulta de listade tareas1. Haga clic en Conjunto de datos.2. Para agregar una columna al conjunto de datos, realice lo siguiente:

a. Seleccione la tarea, el proceso o un tipo de paquete en el área superior de la paleta Datos decontexto.

b. Arrastre un campo de datos del área inferior de la paleta Datos de contexto y suéltelo enColumnas de salida.




Campo Descripción



Habilitar la opción de clasificación Seleccione esta opción para indicar que la columnase puede ordenar. No se admiten los camposde datos que puede tener varios valores comoatributos de varios valores y atributos de un objetorelacionado para las relaciones de varios destinos.








Optimizar la frecuencia de agregación de consultashistóricasEl sistema agrega datos de todas las consultas históricas cada 5 minutos. Si hay demasiados trabajosde agregación ejecutándose de forma simultánea, el rendimiento del sistema se ve afectado y losgráficos no se cargan rápidamente.

La siguiente figura muestra picos en el uso de la CPU que se producen en intervalos de 5 minutos amedida que el número de las consultas históricas aumenta:

Para evitar problemas de rendimiento futuro, puede ajustar dos aspectos de los trabajos de agregaciónde consultas históricas: LAST_RUN y STEP_SIZE.

LAST_RUN es la hora en que un trabajo de agregación se inicia. De forma predeterminada, el sistemainicia todos los trabajos de agregación al mismo tiempo, por ejemplo, 10:20 a.m., 10:25 a.m., 10:30a.m., etc. Para mejorar el rendimiento del sistema, alterne los trabajos de agregación de manera quecomiencen a diferentes horas, lo que disminuirá la carga de la CPU. El sistema acepta valores deLAST_RUN expresados en minutos. Por ejemplo, utilice un valor LAST_RUN de 1, 2, 3, etc. Si eluso de CPU todavía es demasiado alto, ajuste STEP_SIZE.

STEP_SIZE controla la frecuencia de ejecución de un trabajo de agregación. El STEP_SIZEpredeterminado es 5 minutos, lo que significa que el sistema inicia trabajos de agregación cada 5minutos. Puede aumentar o disminuir STEP_SIZE. Si se reduce el STEP_SIZE puede mejorar elrendimiento del sistema debido a que el sistema agrega menos filas de datos. El sistema acepta valoresde STEP_SIZE como minutos enteros, expresados en segundos. Por ejemplo, el sistema acepta 60, 120y 180, pero no acepta 90, 150 ni 210.

Ajuste LAST_RUN y STEP_SIZE mediante la ejecución de secuencias de comandos en la base dedatos de BAM.

En el ejemplo siguiente, la secuencia de comandos ajusta LAST_RUN de manera que los trabajos deagregación de tres consultas históricas se inician 1 minuto más tarde que el resto de los trabajos deagregación.UPDATE BAM_S_JOBS SET LAST_RUN=DATEADD(mi,1,LAST_RUN) WHERE NAME in



(’QueryLabel_1’,’QueryLabel_2’,’QueryLabel_3’)

En el ejemplo siguiente, la secuencia de comandos ajusta LAST_RUN de manera que los trabajosde agregación de dos consultas históricas se ejecutan 2 minutos antes que el resto de los trabajos deagregación.UPDATE BAM_S_JOBS SET LAST_RUN=DATEADD(mi,-2,LAST_RUN) WHERE NAME in(’QueryLabel_4’,’QueryLabel_5’)

En el ejemplo siguiente, la secuencia de comandos cambia step_size a 60 segundos para todas lasconsultas históricas con Cliente en el nombre.UPDATE BAM_S_JOBS SET STEP_SIZE=60 WHERE NAME like ’Customer%’

Actualizar una página después de modificar unmodelo de consultaSi modifica un modelo de consulta que tiene instancias ya enlazadas a las páginas, puede actualizarmanualmente las páginas para agregar o quitar campos de entrada y columnas de salida.

El siguiente ejemplo ilustra el procedimiento de actualización. Imagine que crea un modelo de objetoCliente, un modelo de consulta para buscar en los clientes y una página para mostrar la búsqueda.La interacción original del modelo de consulta incluye tres columnas de salida: Nombre, Últimamodificación y Creado el, y una entrada Nombre.

En la siguiente figura se muestran las propiedades de la interacción:

En la siguiente figura se muestran los widgets creados al enlazar el widget de lista de resultadosa la interacción:

Si desea agregar un campo de búsqueda en el atributo Creado el y una columna en el atributoModificado por.1. Abra el modelo de consulta.2. Haga clic en Conjunto de datos.3. Arrastre y suelte el atributo Cambiar por desde Datos de contexto hasta Columnas de salida.



4. Haga clic en Entradas de usuario.

5. Arrastre y suelte el atributo Creado el desde los Datos de contexto debajo de la entrada Nombreque ya estaba definida.

6. Guarde el modelo de consulta.

7. Abra la página que se determine para mostrar la lista de clientes y los campos de búsqueda.

8. Abra el panel Interacciones y haga clic en la interacción para comprobar que la nueva entraday la nueva salida están disponibles.

9. Para agregar un campo de búsqueda al atributo Modificado por, arrastre y suelte un widget deEntrada de fecha/hora en la página.

10. Especifique la etiqueta y otras configuraciones de la entrada.

11. En el panel Interacciones, haga clic en la interacción.

12. En la vista Propiedades, haga clic en Entradas.

13.Haga doble clic en la columna Página para el atributo Creado el.

14. En el área superior de la pestaña Datos de contexto, debajo de widgets, seleccionedate_time_input.

15. En el área inferior de la pestaña Datos de contexto, seleccione Valor y haga clic en Aceptar.

El valor de la página está configurado en widgets.date_time_input.value.

16. Para agregar una columna en el atributo de la cuadrícula de datos Modificado por, haga clic conel botón derecho en una columna y seleccione Insertar columna antes de o Insertar columnadespués de.

17. En la vista Propiedades, especifique la etiqueta de la columna.

18.Haga clic en Seleccionar junto al editor de expresiones del campo Valor.

19. En el área inferior de la pestaña Datos de contexto, bajo Salidas, seleccione Modificado por yhaga clic en Aceptar.El valor está establecido como Outputs.r_modifier.

20.Guarde los cambios.



Configurar un conjunto de datos de consulta dealerta1. Haga clic en Conjunto de datos.2. Para agregar una columna al conjunto de datos, realice lo siguiente:

a. Seleccione el modelo en el área superior de la paleta Datos de contexto.b. Arrastre un campo de datos del área inferior de la paleta Datos de contexto y suéltelo en

Columnas de salida.

La lista de campos de datos del área inferior de la paleta Datos de contexto depende del modeloprincipal seleccionado en la pestaña Conceptos básicos:

• Si el modelo principal seleccionado es Todas las alertas, se muestran los campos de datoscomunes a todas las alertas en docbase entre aplicaciones.

• Si el modelo principal seleccionado es una alerta específica de la aplicación actual, se muestranlos campos de datos de dicha alerta, así como aquellos que son comunes a todas las alertasen docbase.

En la siguiente tabla se describen los campos de datos de alertas comunes a todas las alertas endocbase:

Campo de datosde alertas

Descripción

Acción de alertadesencadenada

Indica si se ha desencadenado una acción de alerta. Los valores posibles son Truey False.

Alerta creada el Fecha en que se ha creado la alerta.

Descripción dealerta

Descripción de una alerta.

Acciones de errorde alerta

Indica el estado de las acciones. Contiene el nombre de las acciones con error, si lasacciones arrojan error. De lo contrario, aparece en blanco.

Nombre de alerta Nombre de una alerta.

Espacio de nombresde alerta

Espacio de nombres de una alerta.

ID de objeto dealerta

Identificador de objetos de una alerta.

Tipo de objeto dealerta

Tipo de objeto de una alerta.



Campo de datosde alertas

Descripción

Gravedad de alerta Gravedad de una alerta. Los valores posibles son:

• Baja

• Media

• Alta

Nombre de origende alerta

Nombre de origen de una alerta.

Estado de alerta Estado de una alerta. Los valores posibles son:

• Nuevo

• Confirmado

• Cerrado

En tiempo de ejecución, la aplicación proporciona la utilidad de hacer clic con elbotón secundario y cambiar el estado de la alerta.




Campo Descripción



Habilitar la opción de clasificación Seleccione esta opción para indicar que la columnase puede ordenar. Los campos de datos que puedentener varios valores, por ejemplo atributos de variosvalores, no se pueden ordenar.


Para ordenar los resultados por un campo de datos,defina la columna como que se puede ordenar y, acontinuación, seleccione Columna de ordenaciónpredeterminada para consulta.






Requisitos previos de Crystal ReportsEstos son los requisitos previos necesarios para crear y diseñar un informe de Crystal Reports.

• Debe instalar el software del diseñador de Crystal Reports para ver y diseñar informes de CrystalReports.

• Debe descargar la biblioteca en tiempo de ejecución para Java de Crystal Reports (CRJ -crjava-runtime_12.2.219.zip).

• Debe agregar los archivos JAR de Crystal Reports en el entorno de xCP:

1. Descomprima el contenido de crjava-runtime_12.2.219.zip en una ubicación temporal.2. Del contenido descomprimido, agregue la carpeta crystalreportviewers al archivo JAR

crystalreportviewers.jar. Se debe conservar el mismo nombre del archivo JAR. Debe asegurarsede que crear el archivo JAR en la carpeta raíz.

3. Del contenido descomprimido, agregue solo los siguientes archivos JAR a la carpeta crsdk.Puede darle cualquier nombre a la carpeta. Asegúrese de que nombra los archivos JAR solocomo se especifica a continuación.

a. CrystalReportsRuntime.jarb. CrystalCommon2.jarc. JDBInterface.jard. jrcerom.jare. keycodeDecoder.jarf. logging.jarg. pfjgraphics.jarh. QueryBuilder.jari. webreporting.jarj. webreporting-jsf.jark. XMLConnector.jarl. xpp3.jarm. jai_imageio.jarn. com.azalea.ufl.barcode.1.0.jaro. DatabaseConnectors.jarp. cvom.jarq. crystalreportviewers.jar

4. Cree un archivo web-fragment.xml y agregue los siguientes servlets relacionados de CrystalReports en el archivo XML.

<?xml version="1.0" encoding="UTF-8"?><web-fragment metadata-complete="true" version="3.0"xmlns="http://java.sun.com/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-fragment_3_0.xsd"><servlet>



<description>Servlet for xCP Crystal Reports</description><servlet-name>XcpCrystalReportViewerServlet</servlet-name><servlet-class>com.emc.xcp.rest.crystalreport.servlet.XcpCrystalReportViewerServlet</servlet-class></servlet>

<servlet-mapping><servlet-name>XcpCrystalReportViewerServlet</servlet-name><url-pattern>/crystalreport/*</url-pattern></servlet-mapping>

<servlet><servlet-name>CrystalReportViewerServlet</servlet-name><servlet-class>com.crystaldecisions.report.web.viewer.CrystalReportViewerServlet</servlet-class></servlet>

<servlet-mapping><servlet-name>CrystalReportViewerServlet</servlet-name><url-pattern>/CrystalReportViewerHandler</url-pattern></servlet-mapping>

<listener><listener-class>com.emc.xcp.rest.crystalreport.ReportCleanupListener</listener-class></listener>

</web-fragment>

5. Coloque el archivo web-fragment.xml en la carpeta META-INF de crystalreportviewers.jar.

6. Agregue la propiedad del sistema Dcom.sap.cr.lib.path=<ruta de carpeta que contiene los JAR detiempo de ejecución de Crystal Reports> al archivo xcpdesigner.ini.

7. Reinicie xCP Designer para que el sistema seleccione los archivos JAR en tiempo de ejecuciónde Crystal Reports.

8. Después de diseñar el informe de Crystal Reports, debe agregar los archivos JAR en tiempo deejecución de Crystal Reports al entorno de xCP mediante la función Agregar biblioteca de xCPDesigner. Esto permite agrupar estos archivos JAR dentro del archivo war de cada aplicación.

Nota: Para el servidor de aplicaciones WebSphere, debe eliminar la carpeta javax(/xpp3/javax) dexpp3.jar antes de agregar el JAR a las bibliotecas mediante la función Agregar biblioteca.

• Debe instalar Adobe Flash Player en el navegador.

Conexiones de los informes de Crystal Reports

Puede diseñar Crystal Reports mediante:



• Una conexión XML: para conjuntos de datos pequeños, como tablas de historial de BAM.Configurarun informe de Crystal Reports mediante una conexión XML, página 250 proporciona informacióndetallada sobre cómo configurar un informe de Crystal Reports mediante una conexión de XML.

• Una conexión JDBC: para conjuntos de datos grandes y con uso intensivo de conjuntos de datosla docbase de Documentum o la base de datos BAM. Configurar un informe de Crystal Reportsmediante una conexión JDBC, página 252 proporciona información detallada sobre cómo configurarun informe de Crystal Reports mediante una conexión JDBC.

Configurar un informe de Crystal Reports medianteuna conexión XMLConfigurar un informe de Crystal Reports mediante una conexión de XML implica:

• Crear un artefacto de Crystal Reports, página 250

• Diseñar el informe de Crystal Reports, página 251

• Enlazar el informe de Crystal Reports, página 252

Crear un artefacto de Crystal ReportsCrear un artefacto de Crystal Reports implica:

• Agregar los Archivos JAR de Crystal Reports, página 248 al entorno de xCP.• Crear un artefacto de Crystal Reports en xCP Designer agregando uno o varios orígenes de datos.

Siga estos pasos para crear un artefacto de Crystal Reports en xCP Designer:1. En el navegador de Servicios de datos, haga clic en Nuevo > Nuevo Crystal Report. El sistema

genera un archivo <nombre de artefacto de cr>_rpt.rpt bajo el artefacto de Crystal Reports.2. Especifique una Etiqueta para el informe de Crystal Reports y haga clic en Finalizar.3. En la pestaña Conceptos básicos, especifique las propiedades tal y como se describe en la siguiente

tabla:

Campo Descripción

Etiqueta Etiqueta del informe de Crystal Reports.

Nombre del sistema Nombre del sistema utilizado internamente para identificarde forma única el modelo.

Origen Aplicación a la que pertenece el informe de Crystal Reports.

Archivo Ruta de acceso al informe de Crystal Reports en su sistemade archivos.

4. En la pestaña Orígenes, haga clic en Examinar, seleccione los orígenes de datos del informe deCrystal Reports y haga clic en Aceptar.

Puede agregar uno o varios orígenes de datos al artefacto de Crystal Reports.

El número máximo de registros que muestra el sistema varía según el origen de datos al queestá enlazado el informe de Crystal Reports:



• Consulta en tiempo real/consulta de alerta: de forma predeterminada, el número máximode registros que se muestran es de 1.000. Para cambiar este valor, edite el parámetrorest.paging.max.size en el archivo rest-api-runtime.properties.

• Consulta histórica: de forma predeterminada, el número máximo de registros que se muestran esde 10.000. Para cambiar este valor, edite el parámetro bam.jdbc.preference.maxRowsen el archivo bam.properties.

• Proceso sin estado: de forma predeterminada, el número máximo de registros que se muestran esde 1.000. No puede configurar el número de registros para un proceso sin estado.

Si desea exportar datos a Microsoft Excel, puede crear un informe de Crystal Reports y rellenarlos datos de ese informe de Crystal Reports. El informe de Crystal Reports permite exportardatos a Microsoft Excel.

5. Guarde el artefacto de Crystal Reports.

Diseñar el informe de Crystal ReportsDeberá diseñar el informe de Crystal Reports mediante el diseñador de Crystal Reports.1. En el navegador de Servicios de datos, haga doble clic para abrir el archivo .rpt de Crystal Reports.2. En el software del Diseñador de Crystal Reports, vaya a Base de datos > Experto de base de datos.3. En el cuadro de diálogo Experto de base de datos de la pestaña Datos, seleccione Crear nueva

conexión usando los servicios XML y web.4. Seleccione los archivos XML y XSD de <ubicación de aplicación de xCP>\Applications\<nombre

de la aplicación>\<nombre de la aplicación>\gen\main\resources\crystalreport connections\<espaciode nombres del artefecto de Crystal Reports> y haga clic en Finalizar.

donde:

<ubicación de aplicación de xCP> es la ubicación donde está instalada la aplicación.

<nombre de la aplicación> es el nombre de la aplicación creada.

<espacio de nombres del artefecto de Crystal Reports> es el espacio de nombres de la aplicación oel proyecto donde reside el artefacto de Crystal Reports.

Si no ve los archivos XML y XSD, debe resolver los errores en la pestaña Problemas de xCPDesigner. Como alternativa, guarde el artefacto de Crystal Reports que regenera los archivos XMLy XSD. Para habilitar la opción de guardar para el artefacto de Crystal Reports, en la pestañaOrígenes, haga clic en Examinar para seleccionar de nuevo el origen de datos.

El formato de nombre del archivo XML y XSD es Crystal Report artifact name_namespace of thedatasource_datasource name.

5. Agregue las tablas de base de datos al área Tablas seleccionadas.6. Arrastre los atributos de tabla en Campos de base de datos del Explorador de archivos y

suéltelos en la columna Detalles del diseñador de tablas.

Si modifica el origen de datos (por ejemplo, añadir o eliminar un campo) en xCP Designer, vaya aBase de datos > Comprobar base de datos para actualizar los campos actualizados. En ocasiones,si el sistema no actualiza las tablas, realice los siguientes pasos:

• Cierre y abra de nuevo el archivo .rpt o vaya a Base de datos > Cerrar sesión en el servidor eIniciar sesión. El sistema selecciona los últimos archivos XML y XSD.

• Asegúrese de que no haya errores en la pestaña Problemas de xCP Designer para que el sistemagenere los archivos XML y XSD.



Debe establecer la ubicación del origen de datos y asignar los nuevos archivos XML y XSD denuevo en el archivo .rpt si:

• cambia el nombre o mueve un origen de datos• cambia el nombre o mueve un artefacto de Crystal Reports• importa cualquier aplicaciónSi no ve los archivos XML y XSD o si los archivos no están actualizados, guarde el artefacto deCrystal Reports. Esto vuelve a generar los archivos XML y XSD. Para habilitar la opción deguardar para el artefacto de Crystal Reports, en la pestaña Orígenes, haga clic en Examinarpara seleccionar de nuevo el origen de datos.

7. Haga clic en Guardar y cierre el informe.

Enlazar el informe de Crystal ReportsPara ver el informe diseñado en tiempo de ejecución, enlace el artefacto de Crystal Reports al widgetde Crystal Reports.1. En el navegador de Interfaz de usuario, abra una página.2. En la paletaWidgets, arrastre un widget Crystal Report y suéltelo en un editor de diseño.3. En la pestaña General de la vista Propiedades, especifique las propiedades del informe tal y

como se describe en la siguiente tabla:

Campo Descripción

ID Escriba un ID para el widget de Crystal Reports.

Título Escriba un título. El título aparece en la aplicación en tiempo deejecución.

Granularidad de tiempo Seleccione una granularidad de tiempo.

Artefacto de Crystal Report Seleccione el artefacto de Crystal Reports al que desea enlazar elinforme de Crystal Reports y haga clic en Aceptar.

4. En la pestaña Estilo, especifique la altura del widget en píxeles.5. Guarde la aplicación.

xCP no admite el formato de derecha a izquierda (RTL) para el widget de Crystal Reports.

Configurar un informe de Crystal Reports medianteuna conexión JDBCConfigurar un informe de Crystal Reports mediante una conexión JDBC implica:

• Crear un artefacto de Crystal Reports, página 252• Diseñar el informe de Crystal Reports, página 253• Enlazar el informe de Crystal Reports, página 254

Crear un artefacto de Crystal ReportsCrear un artefacto de Crystal Reports implica:



• Agregar los Archivos JAR de Crystal Reports, página 248 al entorno de xCP.

• Crear un artefacto de Crystal Reports en xCP Designer.

Siga estos pasos para crear un artefacto de Crystal Reports en xCP Designer:1. En el navegador de Servicios de datos, haga clic en Nuevo > Nuevo Crystal Report. El sistema

genera un archivo <nombre de artefacto de cr>_rpt.rpt bajo el artefacto de Crystal Reports.2. Especifique una Etiqueta para el informe de Crystal Reports y haga clic en Finalizar.3. En la pestaña Conceptos básicos, especifique las propiedades tal y como se describe en la siguiente

tabla:

Campo Descripción

Etiqueta Etiqueta del informe de Crystal Reports.

Nombre del sistema Nombre del sistema utilizado internamente para identificarde forma única el modelo.

Origen Aplicación a la que pertenece el informe de Crystal Reports.

Archivo Ruta de acceso al informe de Crystal Reports en su sistemade archivos.

Diseñar el informe de Crystal ReportsDeberá diseñar el informe de Crystal Reports mediante el diseñador de Crystal Reports. Puede utilizarla conexión JDBC de Crystal Reports para conectarse a Docbase de Documentum o base de datosBAM.

Requisitos previos para configurar los archivos JAR para conectarse a Docbase de Documentum:

• Descargue las clases DFC del centro de descargas de EMC: https://emc.subscribenet.com.

• Dirija JavaDir a la misma versión de Java que se haya empaquetado junto con las clases DFC.

• Copie los archivos dmjdbc.jar y dmjdbc.properties de la carpeta OptionalLibs de xCP Designera la carpeta crtemp.

• Copie dfc.properties a la carpeta crtemp.

• Edite <BUSINESSOBJECTS_INSTALL_DIR>\common\4.0\java\CRConfig.xml delmodo siguiente:Especifique el archivo dctm.jar de Documentum como la primeraentrada en la etiqueta classpath. Por ejemplo: si el directorio de Documentum esC:/Program Files, especifique C:\Program Files\Documentum\dctm.jar como la primeraentrada en la etiqueta <Classpath> del modo siguiente: <Classpath>C:\ProgramFiles\Documentum\dctm.jar;C:\crtemp\dmjdbc.jar;C:\crtemp\</Classpath>

• La conectividad JDBC solo puede aprovechar los cambios en el modelo de datos validado enDocbase de Documentum. Para una nueva aplicación, implemente el modelo de datos. Debeasegurarse de que el informe de Crystal Reports siempre está sincronizado con el modelo de datosimplementado en Docbase de Documentum.

Siga estos pasos para diseñar Crystal Reports en el diseñador de Crystal Reports:1. En el navegador de Servicios de datos de xCP Designer, haga doble clic para abrir el archivo

.rpt de Crystal Reports.2. En el software del Diseñador de Crystal Reports, vaya a Base de datos > Experto de base de datos.



3. En el cuadro de diálogo Experto de base de datos de la pestaña Datos, seleccione Crear nuevaconexión mediante JDBC (JNDI).

4. Especifique la URL de conexión. La URL de conexión del controlador JDBC de Documentum esjdbc:documentum:oca:docbaseext@<Repository_Name>.

5. Especifique el Nombre de clase de la base de datos. El nombre de clase de base de datos deDocumentum es com.documentum.oca.jdbc.jdbc20.ext.DjdbcDriverExt. Haga clic en Siguiente.

6. Especifique el ID de usuario y la Contraseña para conectarse al repositorio. Haga clic enFinalizar. Se ha conectado al repositorio.

7. Expanda el nodo Conexión JDBC para ver la lista de los tipos de Documentum del repositorio.8. Seleccione los campos que se muestran en el informe. Haga clic en Siguiente.9. Haga clic en Finalizar para generar el informe.

Debe volver a implementar la aplicación después de diseñar el informe de Crystal Reports.Nota: Puede conectarse a la base de datos BAM mediante la conexión JDBC como cualquier otra basede datos. La documentación de Crystal Reports proporciona información detallada sobre la conexión ala base de datos BAM. Asimismo, asegúrese de configurar bam.properties en la aplicación host.La Guía de implementación de xCP proporciona información detallada sobre la creación de la basede datos de Microsoft SQL Server.

Enlazar el informe de Crystal ReportsPara ver el informe diseñado en tiempo de ejecución, enlace el artefacto de Crystal Reports al widgetde Crystal Reports.1. En el navegador de Interfaz de usuario, abra una página.2. En la paletaWidgets, arrastre un widget Crystal Report y suéltelo en un editor de diseño.3. En la pestaña General de la vista Propiedades, especifique las propiedades del informe tal y

como se describe en la siguiente tabla:

Campo Descripción

ID Escriba un ID para el widget de Crystal Reports.


Granularidad de tiempo Seleccione una granularidad de tiempo.

Artefacto de Crystal Report Seleccione el artefacto de Crystal Reports al que desea enlazar elinforme de Crystal Reports y haga clic en Aceptar.

4. En la pestaña Estilo, especifique la altura del widget en píxeles.5. Guarde la aplicación.

xCP no admite el formato de derecha a izquierda (RTL) para el widget de Crystal Reports.

Crear una consulta avanzada sobre el repositorio1. En el navegador Servicios de datos, haga clic en Nuevo→Consulta avanzada sobre el repositorio.2. En el cuadro de diálogo Nueva consulta avanzada sobre el repositorio, especifique la

configuración de la consulta tal y como se describe en la tabla siguiente:



Campo Descripción


3. Haga clic en Siguiente.4. En el cuadro de diálogo Vista previa de consulta, especifique la configuración de la consulta


Campo Descripción

Editor Escriba la consulta en el editor.

Tamaño máximo del resultado Para configurar el tamaño máximo del resultado dela consulta, escriba el tamaño en Tamaño máximodel resultado. El valor predeterminado es –1.Cuando el valor se establece en –1, la limitación detamaño de REST de 1000 resultados entra en vigor.En cualquier otro caso, puede establecer el valordeseado para el tamaño del resultado.

Puede configurar la propiedad en el archivorest-api-paging-config.properties o en el archivorest-api-runtime.properties para establecer ellímite del tamaño máximo de resultados a 1000:


Sincronizar consulta Rellena los parámetros de entrada de usuario en lasección de entradas de usuario.Note: Es importanteelegir el tipo de datos correspondiente al sincronizarla consulta. De lo contrario, el sistema puedegenerar un error, si el tipo de datos especificado noestá permitido.

Entradas de usuario Según la consulta que se defina, pueden aparecerlos parámetros de entrada. El tipo y valor de losparámetros se puede definir individualmente.

El usuario debe indicar los parámetros con múltiplesvalores en forma de valores separados por comas.Los tipos de datos compatibles son los siguientes:

• Entero

• Flotante

• Cadena

• Fecha se debe indicar los formatossiguientes:’mm/dd/yyyy hh:mi:ss’’mm/dd/yyyy’



• Booleano

Ejecutar Ejecuta la consulta y obtiene una vista previa delresultado de la consulta.

Si la consulta se realiza correctamente, la salida secompleta en el área de resultados. De lo contrario,aparece un mensaje de error en el áreaMensaje.

Ordenar por Puede ordenar en función de cualquiera de lascolumnas según la consulta definida. De formapredeterminada, la primera columna aparece comocriterio de ordenación la primera vez.

Ascendente o descendente Decide el orden de clasificación.


Conceptos

BúsquedasAgregue búsquedas a una aplicación para permitir que los usuarios finales realicen sus tareas de unaforma rápida y eficaz.

Puede diseñar tipos diferentes de búsquedas en distintas situaciones. Este tema describe los tiposprincipales de búsquedas.

Listas de objetosUna búsqueda puede ser tan sencilla como una lista de objetos que se filtra de antemano. De estemodo, los usuarios finales no se encuentran abrumados por la cantidad de datos que tienen que filtrarellos mismos para sus tareas diarias.

Buscar en toda la aplicaciónCree una búsqueda global para recuperar cualquier objeto de la aplicación. Con una búsqueda global,puede aprovechar las capacidades de Documentum xPlore para ampliar una búsqueda. Por ejemplo,



una búsqueda pueden coincidir con varios tipos de variaciones de una palabra como sinónimos(mediante un diccionario de tesauros), palabras mal escritas (también denominadas "búsquedas poraproximación") y formularios conjugados (cuando la derivación está habilitada).

Buscar en función de entradas de usuario

Si los usuarios finales utilizan siempre los mismos criterios para encontrar un objeto, puede ayudarlesmediante el diseño de un formulario de búsqueda que directamente devuelva lo que estén buscando.El modelo de consulta para el formulario de búsqueda puede incluir entradas predefinidas queautomáticamente redefinen el conjunto de resultados. En este caso, el formulario de búsqueda essimilar a una plantilla de búsqueda.

Buscar en función de selección de usuario

Puede crear una navegación con facetas y permitir a los usuarios finales examinar el contenidomediante el filtrado de metadatos predefinidos. Las facetas son útiles dado que el usuario finalno necesita conocer el valor exacto de los metadatos. Por ejemplo, el usuario final puede buscardocumentos de tipo PDF, y con un tamaño entre 5 y 10 MB. La navegación con facetas es un métodosencillo para buscar información en un amplio conjunto de resultados.

ConsultasConfigure consultas cuando desee diseñar búsquedas e informes. Utilice las consultas para:

• Crear formularios de búsqueda.

• Agregue una búsqueda avanzada a una aplicación.

• Agregar navegación con facetas a una aplicación.

• Crear listas de tareas.

• Crear gráficos que contengan datos de aplicación históricos y en tiempo real.

Cree el modelo de consulta y, a continuación, agregue una instancia del mismo a la página deaplicación.

La siguiente tabla resume los usos de cada consulta:

Tipo Dominio Requisito Ejemplo

En tiempo real Trabajador del conocimiento Operaciones de supervisión Mis casos abiertos

Histórica Línea de negocio Tendencias de negocio Suma trimestral de ingresos

Administración Informes de productividad Las tareas de trabajocompletadas

Administración Previsiones de resultados Búsquedas más comunes

Legal Uso de la aplicación Registro de cambio deactividad de casos

Auditoría de historial decasos



Tipo Dominio Requisito Ejemplo

Texto completo Trabajador del conocimiento Buscar objetos de contenido Todos los objetos decontenido que contienenlas palabras Oriente Medio

Todos los objetos decontenido por un autor

Todos los objetosde contenido de unadeterminada categoría

Lista de tareas Procesador de tareas Actividad de proceso Mi lista de tareas por hacer

Supervisor de colas detrabajo

Todas las aplicaciones depréstamo pendientes

Alerta Trabajador del conocimiento alertas de negocio Todas las alertas del sistema

La siguiente tabla resume las características de datos de contexto de cada consulta:

Tipo Datos decontexto

Almacén dedatos

Contenido Dimensión detiempo

Registros porconjunto deresultados

En tiemporeal

Aplicación Base de datos Metadatos Instantánea 1.000

Histórica Aplicación Almacén de datossin conexión

Metadatos Cambio de estadocon el paso deltiempo

100 millones

Textocompleto

Objetos Repositorio dedocumentosXML (xDB)

Índice de textocompleto

Metadatos

Metadatosdescubiertos

No aplicable 10.000

Lista detareas

Procesos Base de datos Metadatos Instantánea N/D*

Alerta Aplicación Almacén de datossin conexión

Metadatos Cambio de estadocon el paso deltiempo

1.000

* El número de registros por conjunto de resultados para las consultas de lista de tareas depende delos modelos de proceso y el número de procesos en ejecución. Las listas de tareas se basan en lasconsultas selectivas que devuelven un número limitado de registros.

Diseñar una experiencia de búsquedaCrear una experiencia de búsqueda fácil para el usuario depende de las consultas y de la manera en quese muestran a los usuarios finales en las páginas. Entre las prácticas recomendadas para diseñar laexperiencia de búsqueda, se incluyen:

• Identifique la información que necesita, así como los conocimientos acerca del dominio de losusuarios finales.



– ¿Los usuarios finales saben exactamente lo que están buscando y desean obtenerlo rápidamente?

– ¿Es más una necesidad de detección? Por ejemplo, ¿hay algún documento relacionado conesta tecnología?

• Defina el alcance de las consultas. Definir de forma clara el alcance mejora la relevancia de losresultados y el tiempo de respuesta.

– Utilice entradas predefinidas. Dado que las entradas predefinidas están ocultas para losusuarios finales, asegúrese de que comprenden cómo las restricciones definidas por las entradaspredefinidas limitan la consulta.

– Defina los valores de búsqueda predeterminada. Además de reducir el alcance de consulta, losvalores de búsqueda predeterminada se pueden comportar como sugerencias para los usuariosfinales que no estén seguros de qué criterios de búsqueda establecer.

• Las búsquedas que devuelven cero resultados pueden frustrar a los usuarios finales y consumenmucho tiempo. Utilice facetas en lugar de campos de entrada para evitar los resultados de búsquedascero.

• Indique el alcance de la consulta. Por ejemplo, para una búsqueda de contenido de carpeta, indiqueel nombre o la ruta de la carpeta actual.

• Para facilitar la cumplimentación de los campos de entrada para los usuarios finales, indique losoperadores y la sensibilidad de mayúsculas y minúsculas de las entradas de consulta.

Crear instrucciones de ordenAl iniciar la creación de una aplicación, siga las instrucciones de orden de creación descritas en estetema. Las instrucciones le ayudan a trabajar más rápidamente mediante la descripción de los requisitosy la lógica de creación.

• Cree los modelos de objeto o los modelos de proceso y, a continuación, cree modelos de consulta. Sise cambia el modelo principal de un modelo de consulta, se restablece toda la configuración delmodelo de consulta. No planee reutilizar un modelo de consulta para varios modelos de objeto.

• Cree los modelos de consulta y, a continuación, cree las listas de resultados.

– Si cambia el modelo devuelto de una consulta en tiempo real o la configuración de faceta de unaconsulta de texto completo, cree otra instancia de servicio de datos que refleje el cambio.

– Una vez que se ha asignado una lista de resultados a una instancia de servicio de datos, no puedeasignarla a otra instancia del servicio de datos.

La mayoría de los cambios de un servicio de datos de consulta se refleja en las instancias que sehayan creado previamente. Si desea modificar un modelo de consulta que presenta instancias yaenlazadas a páginas, puede actualizar manualmente las páginas para agregar o quitar campos deentrada y columnas de listas de resultados.

Determinar cuándo utilizar una consulta en tiemporeal o históricaUtilice la tabla siguiente para determinar si una consulta histórica o una consulta en tiempo realcumple los requisitos de generación de informes:



Requisito Histórica En tiempo real

Volumen de datos Hasta 10 millones de registros sinoptimización

Más de 10 millones de registroscon optimización

10.000 registros

Agregación Las consultas históricas se puedenutilizar para generar gráficos queincluyan cálculos. Los cálculosse obtienen previamente enlas consultas históricas, lo quesignifica que se realizan antes deque un usuario final necesite elgráfico.

Mostrar un gráfico histórico queincluya cálculos requiere menostiempo que su equivalente entiempo real.

No disponible

Latencia de datos En 30 segundos, los datos de lainstancia aparece en gráficos.

Los datos calculados previamentese pueden optimizar hasta 5minutos.

Latencia cero

Frecuencia de visualización Hasta 100.000 visualizaciones degráficos por hora

Hasta 1.000 visualizaciones degráficos por hora

Notificación de casos Los gráficos pueden contenerinformación acerca de todos loscasos, incluyendo aquellos que seencuentran activos, archivados oeliminados.

Los gráficos pueden contenerinformación acerca de los cambiosen el ciclo de vida de los casos.

Los gráficos solo contieneninformación acerca de los casosactivos.

Paginación Crystal Reports se utiliza paraconfigurar la paginación.

Admite 100 registros por página

Modelo principal

Un modelo principal es un modelo de objeto utilizado para diseñar una consulta. El modelo principaldetermina los otros modelos de objeto que se pueden incluir en el conjunto de datos. Cuandoselecciona un modelo principal, solo los objetos relacionados aparecen en la paleta Datos de contexto.Un modelo principal se puede enlazar a otros modelos de objeto cuando se diseña un conjunto de datos.



Conjunto de datos

Un conjunto de datos son los datos devueltos por una consulta. Los valores de los campos de datosque forman un conjunto de datos se representan en columnas. Las columnas se utilizan para generargráficos, tablas, listas y cuadrículas. Utilice entradas predefinidas para filtrar un conjunto de datosy así reducir la cantidad de datos devueltos. El conjunto de datos puede incluir campos de datos deobjetos relacionados o de relaciones.

En la mayoría de las consultas, solo tiene que definir las columnas de salida. Las columnas desalida están disponibles para la composición de la página. Solo los campos de datos seleccionadoscomo columnas de salida se pueden hacer visibles para los usuarios finales. Al crear un widget decuadrícula, las columnas de la cuadrícula se crean automáticamente a partir de las columnas desalida de la consulta.

En las consultas históricas, puede definir las columnas de conjunto de datos en la pestaña del editorConjunto de datos. Si es necesario, utilice las columnas del conjunto de datos para definir los cálculos.En la pestaña del editor Cálculos, defina las columnas de salida para la composición de la página.

Conjunto de datos de consulta en tiempo real

La figura siguiente contiene un conjunto de datos de consulta en tiempo real de ejemplo:

Este modelo de consulta proporciona a los usuarios finales información actualizada de antigüedad decasos y de estado. Cada columna de salida pertenece al modelo de caso principal.

Conjunto de datos de consulta histórica

La figura siguiente contiene un conjunto de datos de consulta histórica de ejemplo:



En este ejemplo, todas las columnas del conjunto de datos, excepto Importe de garantía, pertenecena Préstamo, que es el modelo principal del conjunto de datos. Para agregar la columna Importe degarantía, utilice la paleta Datos de contexto para desplazarse por la relación entre los modelos deobjeto de negocio Préstamo y Garantía. La relación entre los modelos de objeto de negocio Préstamo yGarantía se define al crear los modelos de objeto.

Entradas predefinidasLas entradas predefinidas filtran los datos recuperados por una consulta. Los usuarios finales no editanni ven entradas predefinidas en tiempo de ejecución.

Utilice entradas predefinidas para delimitar una consulta que se alinea con los requisitos de los usuariosfinales. Por ejemplo, puede reducir el alcance de la consulta para recuperar tipos específicos de objetosde contenido, copias específicas u objetos con un estado específico.

Las restricciones establecidas por entradas predefinidas son acumulativas. Por ejemplo, puede crearuna lista de préstamos con entradas predefinidas como Loan.LoanAmount > $400000 ANDLoan.PaymentAmount > $2500 AND Loan.ClosedDate before 1/1/2011. La lista incluyetodos los préstamos cerrados antes del 1 de Enero del 2011 donde el importe del préstamo es mayorque $400.000 y el pago mensual es mayor que $2.500.

Reducir la cantidad de datos recuperados:

• Elimina la necesidad de desplazamiento a través de listas de resultados grandes.

• Mejora el tiempo de respuesta de la consulta. Las consultas selectivas se ejecutan mejor que lasconsultas no selectivas.

• Devuelve una lista de resultados delimitada que permite a los usuarios finales obtener los datosque necesitan para realizar sus tareas. Por ejemplo, puede crear una lista de objetos que se hayanretirado por el usuario final actual mediante la adición de una entrada predefinida como Locked by= session.user.name..

Ejemplos de entradas predefinidas para fechas relativas

Use expresiones para definir los valores de las entradas predefinidas. No se admiten los días laborables.



La siguiente tabla proporciona ejemplos de fechas relativas:

Criterios Operador Expresión Descripción

Al o después de 2010 Al o después de createDate(2010, 1, 1) Utilice este tipo deentrada predefinida paratener en cuenta una fechaespecífica como la fechade entrada en vigor deuna nueva ley.

No anterior a un año Al o después de addDays(now(), -365) Calcula una fecharestando 365 días a lafecha actual.

Utilice este tipo deentrada predefinida paramejorar el tiempo derespuesta de la consulta.

Fecha de vencimiento enmenos de 30 días

Al o después de addDays(now(), 30) Calcula una fechamediante la adiciónde 30 días a la fechaactual.

Utilice este tipo deentrada predefinida paradefinir una fecha devencimiento futura.

Entradas de usuarioLas entradas de usuario de un modelo de consulta son los criterios introducidos por los usuariosfinales para definir los datos que se van a recuperar.

En las consultas en tiempo real, de texto completo y de alerta, puede asignar varios campos de datosa una sola entrada de usuario. Un operador OR se utiliza entre los campos de datos en la mismaentrada. Un operador AND se utiliza entre entradas.

En las consultas históricas, las entradas de usuario reducen la cantidad de datos devueltos por laconsulta. Las entradas de usuarios ayudan a los usuarios finales a examinar los datos históricos desdevarios puntos de vista. Los usuarios finales tienen varias maneras para filtrar los datos históricos. Sepueden seleccionar valores de una lista de valores diferentes o a partir de rangos. Según el tipo de datos,también puede agregar un campo de sugerencia para permitir que puedan reducir la lista de valores.

Sintaxis de consulta compatible para la búsquedade texto completoLos usuarios finales pueden utilizar la sintaxis de consulta en el campo de entrada para la búsquedade texto completo. Utilice la información de este tema para notificarles los elementos admitidos ypara comprender los resultados de búsqueda.

En la tabla siguiente se describen los operadores booleanos y los caracteres admitidos:



Operador Descripción

AND Para obtener resultados que contengan dos términosde búsqueda, los usuarios finales pueden llevar a cabouna de las siguientes acciones:

• Dejar un espacio en blanco entre los términos debúsqueda.

• Escribir AND entre los términos de búsqueda.

Un término puede ser una palabra o una frase entrecomillas.

OR Para obtener resultados que contengan al menos untérmino, los usuarios finales deben escribir OR entrelos términos de búsqueda.

El uso explícito del operador OR permite a losusuarios finales encadenar varios términos con losoperadores AND y OR. El operador AND tieneprecedencia sobre el operador OR. Por ejemplo,si el usuario final escribe: conocimiento oradministración and detección, losresultados contendrán el término conocimiento, o bienlas palabras administración y detección.

NOT Para obtener resultados que no contengan un término,los usuarios finales deben escribir NOT antes de esetérmino.

El término puede ser una palabra o una fraseentrecomillada. Solo se toma en cuenta el términoque sigue al operador.

El operador NOT se puede utilizar después delos operadores AND u OR, separado por unespacio. Ejemplo de sintaxis válida: DocumentumNOT adaptador o Documentum AND NOTadaptador; ambas consultas devolverán resultadosque contienen Documentum, pero no el términoadaptador. Documentum OR NOT adaptadordevuelve resultados que contienen Documentum(y posiblemente adaptador) o que no contienen eltérmino adaptador. Los usuarios finales deben utilizaresta sintaxis con cautela, ya que puede generar ungran número de resultados.

El operador NOT se puede utilizar solo al principio dela consulta. Por ejemplo, si escribe NOT adaptador,obtendrá resultados que no contienen la palabra"adaptador". Los usuarios finales deben utilizar estasintaxis con cautela, ya que puede generar un grannúmero de resultados.

El operador NOT se puede incluir entre paréntesis,pero no usar con paréntesis.




La siguiente sintaxis es válida: (AdministraciónNOT Desarrollo) OR (AdministraciónNOT Configuración).

La siguiente sintaxis no es válida: Admin-istración NOT ( Desarrollo ORConfiguración ).

ANDNOT (en una palabra) no es un operador.

Comillas (dobles comillas) Para buscar una palabra o frase exactas, los usuariosfinales deben escribir esta entre comillas.

El uso de comillas impide que los usuarios finalesobtengan resultados que incluyan variaciones deltérmino de búsqueda, Los usuarios finales puedenutilizar comillas para buscar palabras con el mismouso de mayúsculas o minúsculas.

Paréntesis Para especificar que se deben procesar juntosdeterminados términos, los usuarios finales debenusar paréntesis.

Los usuarios finales deben utilizar paréntesis deapertura y cierre, y dejar un espacio delante y detrásde cada uno de ellos.

Una búsqueda de conocimiento andadministración or detección devuelveresultados que contienen los términos conocimiento yadministración, o que contienen la palabra detección.

Una búsqueda de conocimiento and (administración or detección ) devuelveresultados que contienen el término conocimiento, yla palabra administración o detección.

Asterisco o signo de interrogación El asterisco y los signos de interrogación soncaracteres comodín. Los usuarios finales puedenutilizar comodines con los campos de entrada detexto completo, que se configuran con los operadores,para que coincidan con los términos con caracteresdesconocidos o para ampliar la consulta. El asteriscoequivale a cero o más caracteres en cualquier parte deuna palabra. El signo de interrogación equivale a unsolo carácter en cualquier parte de una palabra.

Los usuarios finales pueden utilizar caracterescomodín en el campo de entrada para la búsquedade texto completo y en las entradas de usuarioconfiguradas con los operadores Contiene, Empiezapor, Termina con o Es igual a.

Puede configurar Documentum xPlore para agregarautomáticamente caracteres comodín, pero esta accióntiene un efecto negativo en el rendimiento que debevalorar en relación con su propio entorno.




Cuando los usuarios finales utilizan caracterescomodín, estos obtienen resultados que incluyenvariaciones a partir de la lematización. Por ejemplo,una búsqueda de d*to devuelve resultados quecontienen palabras como: documento , descuento,dato o departamento, pero no documentado odocumentación.

Los operadores AND, OR, y NOT son palabras reservadas. Para buscar un término que incluya unoperador, los usuarios finales pueden utilizar comillas. Por ejemplo, una búsqueda de "hardwareand software" devuelve objetos con esa cadena de tres palabras. Una búsqueda de hardwareand software (sin comillas) devuelve todos los objetos que contengan las palabras hardwarey software.

Los operadores AND, OR y NOT no distinguen entre mayúsculas y minúsculas. Por ejemplo, losusuarios finales pueden escribir: AND, and o And.

Determinar cuándo utilizar una consulta en tiemporeal o de texto completoUtilice la tabla siguiente para determinar si una consulta de texto completo o una consulta en tiemporeal cumple los requisitos de búsqueda.

Requisito Texto completo En tiempo real

Relaciones No se admite. Puede crear búsquedas conlos atributos de los objetosrelacionados y de las relacionescomo entradas o salidas deconsulta.

Latencia de datos Latencia de indexación limitada. Latencia cero.

Facetas Se admite. No se admite.

Metadatos descubiertos Los metadatos descubiertos seadmiten como salidas y entradas deconsulta y también como facetas.

No se admite.

Variaciones del término debúsqueda

Solo las consultas de textocompleto admiten las búsquedasde variaciones de una palabrabasándose en las capacidades deDocumentum xPlore.

Ejemplos de expansión de consulta:

• La búsqueda del término ratónpuede devolver resultados con eltérmino ratones.

• La búsqueda del término EMCpuede devolver resultados con eltérmino EMC2.

Las consultas en tiempo realdevuelven la coincidencia exactadel término de búsqueda. Esto secumple cuando se buscan objetosde contenido indexado.



Requisito Texto completo En tiempo real

• La búsqueda del términoDocumnetum puede devolverresultados con el términoDocumentum.

Sensibilidad de mayúsculas yminúsculas

Las consultas de texto completo nodistinguen entre mayúsculasy minúsculas de formapredeterminada.

Las consultas en tiempo realdistinguen entre mayúsculasy minúsculas de formapredeterminada.

Búsqueda de fragmentos Para obtener coincidencias defragmentos en las consultas detexto completo, el usuario finaldebe escribir un carácter comodín.

La búsqueda de fragmentos concaracteres comodín explícitos seadmite en el campo de entradapara la búsqueda de texto completoy en las entradas de usuarioconfiguradas con los operadoresContiene, Empieza por, Terminacon o Es igual a.

Por ejemplo:

• Una búsqueda de tipo "el términoempieza conHora" no devuelveresultados que empiezan porHorario, sino por Hora de laimplementación.

• Una búsqueda de tipo "el términoempieza con Hora*" devuelveresultados que empiezan porHorario.

Puede configurar la compatibilidadcon la búsqueda de fragmentosen EMC Documentum xPloreAdministration and DevelopmentGuide (Guía de administracióne implementación de EMCDocumentum xPlore).

Las consultas en tiempo realcon los operadores Contiene,Empieza por y Termina con buscancoincidencias de fragmentos deforma predeterminada.

Consulta en tiempo realUtilice una consulta en tiempo real para crear un gráfico o una búsqueda en tiempo real que puedarequerir o no entradas de los usuarios finales:

• Una lista de clientes que se ha modificado o creado recientemente



• Un formulario para buscar clientes por su nombre o ID

• Una lista de garantías asociada a un cliente especificado por el usuario final

Las consultas en tiempo real le permiten ejecutar consultas DQL optimizadas en un repositorio deaplicaciones y recuperar los resultados. Las consultas en tiempo real son excelentes para crear lasbúsquedas que recorren las relaciones. Por ejemplo, los usuarios finales obtienen más informaciónacerca del perfil del cliente si pueden ver sus garantías. A diferencia de las consultas de texto completo,las consultas en tiempo real no están sujetas a ninguna latencia de indexación. Cuando se crean pararecuperar una lista de objetos de contenido, las consultas en tiempo real no pueden utilizar el conjuntode metadatos descubiertos para el modelo de contenido.

Generar gráficos de consultas en tiempo real es apropiado cuando los usuarios finales necesitan obtenerinformación acerca de los casos e instancias de procesos cuando estos se produzcan. Los gráficos entiempo real son excelentes para el seguimiento operativo, que depende de la información actualizada.Por ejemplo, utilice una consulta en tiempo real para generar una lista de casos abiertos. Los gráficosde consulta en tiempo real están limitados a un número de filas debido que es posible que devuelvanuna gran cantidad de datos. Los datos en tiempo real se almacenan en la memoria.

Puede enlazar una consulta en tiempo real a varios widgets. La siguiente tabla describe los diferentescasos de uso:

Consulta en tiempo realWidget Caso de uso



Sí [1]


Sí






Relaciones en consultasBusque en las relaciones para mostrar modelos de objeto relacionados. Por ejemplo, puede definir unmodelo de consulta en tiempo real para mostrar todas las garantías de un cliente determinado.



Al definir un modelo de consulta en tiempo real que devuelva una relación, las acciones disponibles enlos resultados son específicas para la relación.

También puede definir un modelo de consulta en tiempo real que devuelva un modelo de objeto eincluya los atributos de sus relaciones o los atributos de los objetos relacionados. Por ejemplo, puedecrear una lista de clientes con una columna para mostrar los nombres de sus garantías.

Para crear una cuadrícula de resultados usando una consulta en tiempo real que devuelva una relación,debe agregar el widget de lista de resultados a una página del modelo primario correspondiente. Porejemplo, para crear una lista de instancias de garantía para un cliente determinado, agregue el widgetde lista de resultados a la página del cliente Mostrar.

Las siguientes limitaciones se aplican a modelos de consulta en tiempo real que incluyen relaciones:

• Si el modelo de consulta incluye una relación, y se ha seleccionado un atributo de varios valoresnormal como una columna de salida, no se puede seleccionar ningún otro atributo de varios valorescomo columna de salida. El atributo puede ser un atributo del objeto de origen, un atributo delobjeto de destino o un atributo aplicable a la relación.

Además de los atributos de varios valores normales, un atributo de varios valores puede ser unatributo con un solo valor aplicable a una relación de varios destinos, o un atributo de un solo valordel objeto de destino de una relación de varios destinos.

Si el modelo de consulta incluye una relación de varios destinos, y no ha seleccionado ningúnatributo de varios valores normal, entonces puede seleccionar varios atributos de un solo valor delobjeto de destino, o que sean aplicables a la relación.

• Si el modelo de consulta incluye una relación con varios destinos, no se puede seleccionar comoatributos de columna de salida de otras relaciones u objetos de destino.

Un modelo de consulta incluye una relación en los casos siguientes:

• Utilice el atributo de una relación o el atributo de un objeto relacionado como una columna desalida, entrada predefinida o entrada del usuario en el modelo de consulta.

• Se configura el modelo de consulta para devolver relaciones en lugar del modelo principal.

Ejemplos de modelos de consulta compatibles para un modelo de datos

El siguiente diagrama ilustra la primera limitación con un modelo de datos de simplificado.



En este diagrama, el modelo de datos se compone de cinco modelos de objeto (A, B C, D y E)enlazados mediante relaciones. Hay dos relaciones con un único destino, Rel A - B y Rel A - C y dosrelaciones con varios destinos, Rel A - D y Rel A - E.

La tabla siguiente describe los modelos de consulta admitidos para este modelo de datos.

Modelos de objetos incluidos enla consulta

Modelo devuelto Número de atributos devarios valores admitidos enlas columnas de salida

El modelo de objeto A estáenlazado a un modelo de objetoB mediante una relación de únicodestino

Modelo de objeto A o la relaciónAB

Un atributo de varios valores puedeser:

• un atributo de varios valoresdel objeto de origen, A

• un atributo de varios valoresdel objeto de destino, B

• un atributo de varios valoresaplicable a la relación

El modelo de objeto A estáenlazado a dos modelos de objeto,B y C, mediante relaciones deúnico objetivo

Modelo de objeto A o la relaciónAB o la relación AC

Un atributo de varios valores puedeser:


• un atributo de varios valoresdel objeto de destino, B

• un atributo de varios valoresaplicable a la relación AB

• un atributo de varios valoresdel objeto de destino, C

• un atributo de varios valoresaplicable a la relación AC



Modelos de objetos incluidos enla consulta

Modelo devuelto Número de atributos devarios valores admitidos enlas columnas de salida

El modelo de objeto A estáenlazado a otro modelo de objetoD mediante una relación de variosdestinos

Modelo de objeto A Un atributo de varios valores puedeser:


• un atributo de un solo valordel objeto de destino, D

• un atributo de un solo valoraplicable a la relación

El modelo de objeto A estáenlazado a otro modelo de objetoD mediante una relación de variosdestinos

Relación AD Un atributo de varios valores puedeser:


• un atributo de varios valoresdel objeto de destino, D

• un atributo de varios valoresaplicable a la relación

Ajustar consultas en tiempo real para obtener unrendimiento óptimo

Las consultas en tiempo real ejecutan consultas DQL optimizadas en una base de datos subyacente.

El rendimiento de las consultas en tiempo real depende de distintos factores:

• Los datos en sí: ¿cuántas instancias de objeto tiene en el repositorio? ¿Qué son los valores demetadatos?

• El modelo de datos: ¿el modelo de datos contiene muchas relaciones?

• El modelo de seguridad: ¿es permisivo o restrictivo?

• Las consultas ejecutadas por los usuarios finales: ¿son las consultas selectivas o no? ¿Losusuarios finales escriben un valor o lo seleccionan de una lista de valores predefinidos?

Para evitar problemas de rendimiento o para mejorar el rendimiento de consultas, puede ajustaralgunos factores de rendimiento de las consultas en tiempo real.

Utilice la tabla siguiente para ayudarle a tomar decisiones al crear el modelo de datos:

Configuración de modelo de datos Impacto de rendimiento

Habilitar la opción de ordenación en las columnas desalida

La habilitación de la opción de ordenación en unacolumna de salida puede afectar al rendimientocuando se devuelve un gran número.




Entradas de consulta Defina las entradas de consulta para que la consultasea más selectiva. Por ejemplo, defina una entradapredefinida en la fecha para limitar la cantidad dedatos devueltos.

Incluir relaciones en consultas Una consulta modelo incluye una relación al usaratributos de una relación o de un objeto relacionadocomo salidas o entradas, o al configurar el modelo deconsulta para que devuelva relaciones.

Desde un punto de vista de base de datos, las tablas secrean para los modelos de objeto y las relaciones. Unaconsulta que incluye una relación se convierte en unaconsulta SQL con muchas de funciones JOIN. Paramejorar el rendimiento, limite el número de nivelesde relación para evitar consultas complejas.

Operadores Cuando utilice consultas en tiempo real, así comootras consultas de base de datos como las consultashistóricas y las de lista de tareas, no deberá utilizarlos operadores Contiene, Termina con o No contienepara las entradas de usuario. Cuando utiliza estosoperadores, la cláusula WHERE no puede valerse deun índice. Por tanto, el rendimiento de las consultasse degrada.

A diferencia de las consultas de texto completo y el índice de texto completo, las consultas en tiemporeal no crean automáticamente índices en la base de datos del repositorio.

En función de los datos y la capacidad de selección de las consultas, agregue índices para mejorar elrendimiento. Por ejemplo, al habilitar la opción de no distinguir entre mayúsculas y minúsculas, losíndices adicionales pueden mejorar el rendimiento.

Consulta de texto completoUtilice una consulta de texto completo para crear una búsqueda global o para buscar atributos medianteun formulario de búsqueda. Las consultas de texto completo son ideales para buscar objetos decontenido como, por ejemplo, documentos, pero también se pueden utilizar para buscar otros modelosde objeto, como objetos de negocio.

Cuando se buscan objetos de contenido, las consultas se ejecutan en el contenido mismo y en losvalores de atributo indexados mediante Documentum xPlore. Al buscar en otros modelos de objeto,las consultas se ejecutan solo en los valores de atributo indexados. Una consulta de texto completopermite a los usuarios finales buscar cadenas aproximadas considerando las posibles variaciones oerrores ortográficos de los términos. Para objetos de contenido, también devuelve un resumen de textopara cada resultado y resalta las ocurrencias de los términos de búsqueda.

Las consultas de texto completo le permiten incluir facetas. Las facetas, que calcula xPlore, permiten alos usuarios finales examinar grandes conjuntos de datos para localizar los elementos de interés.

Si no se define una opción de ordenación predeterminada, xPlore devuelve los resultados por orden declasificación. Para calcular la puntuación de un resultado, xPlore toma en cuenta:



• El número de veces de los términos de búsqueda en el resultado

• Si los términos de búsqueda aparecen en los metadatos

• La actualidad de los resultados en función del atributo de última modificación (r_modify_date)

A diferencia de las consultas históricas o en tiempo real, las consultas de texto completo no admitenaquellas búsquedas que recorren las relaciones. Las consultas de texto completo se centran en un únicotipo de modelo. Por ejemplo, puede buscar clientes o garantías, pero no los clientes y sus garantías.

Al crear una consulta de texto completo en un modelo de carpeta, la consulta no se ejecuta en elcontenido de los objetos incluidos en una instancia de la carpeta, sino en los valores indexados delos atributos de la carpeta.

Facetas

Utilice las facetas para obtener una comprensión inmediata de los metadatos contenidos en el conjuntode resultados. Las facetas también facilitan la búsqueda avanzada, conocida como navegación confacetas, al permitir a los usuarios finales profundizar en las áreas de interés.

Puede configurar las facetas para mostrar valores diferentes o para mostrar las bandejas de valores. Porejemplo, puede aplicar las siguientes estrategias de filtro:

• Filtrar resultados por mes o por trimestre.

• Filtrar resultados por cantidad de 0 a 100.000 y de 100.000 a infinito.

• Filtre los resultados por los metadatos descubiertos como, por ejemplo, las personas mencionadasen el contenido.

Las facetas se basan en características de contenido como, por ejemplo, los atributos de objeto,incluidos los metadatos descubiertos.

Documentum xPlore calcula las facetas y las devuelve como parte del conjunto de resultados. Laventaja de las facetas de xPlore sobre los campos de entrada introducidos manualmente por usuariosfinales es que evitan consultas sin respuesta al limitar los valores a los resultados que no están vacíos.

Facetas en tiempo de ejecución

En tiempo de ejecución, los usuarios finales seleccionan valores de faceta para restringir la lista deresultados. Cada valor de faceta se muestra con el recuento de resultados coincidentes. Cuando seselecciona un valor de faceta, esta se mueve al cuadro de selección en la parte superior del panel defacetas. Para restaurar la lista de resultados anterior o inicial, los usuarios finales pueden quitar todas osolo algunas de las selecciones. Si define diversas facetas, los usuarios finales pueden desplazarse paraver todos los valores de faceta o estas se pueden contraer para mostrarse de forma individual. Si unafaceta tiene muchos valores diferentes, los valores con más resultados coincidentes se muestran enprimer lugar y aparecerá un enlace disponible para mostrar más valores.

La estructura de ruta simplificada le permite regresar a la lista anterior de nidos y elegir una rutadiferente. Actualmente, está limitada a un elemento secundario por nodo principal y solo los nodoshoja contendrán varios valores.



ResumenLas consultas de texto completo le permiten ver un resumen de cada objeto de contenido en la lista deresultados. En tiempo de ejecución, los términos de búsqueda se resaltan en el resumen para que losusuarios finales vean rápidamente por qué el objeto coincide con la consulta.

Resúmenes dinámicos y estáticosSegún los términos de búsqueda, xPlore calcula un resumen dinámico del objeto de contenido dondelos términos de búsqueda aparecen en contexto. Si la consulta se ejecuta sin los términos de búsqueda,por ejemplo, en una situación de navegación con facetas, xPlore devuelve un resumen estáticobasado en los metadatos de objeto. También puede configurar xPlore para que siempre devuelvaresúmenes estáticos en lugar de resúmenes dinámicos para mejorar el tiempo de respuesta de xPlore.La EMC Documentum xPlore Administration and Development guide (Guía de implementación yadministración de EMC Documentum xPlore) proporciona más información acerca de otras opcionesde configuración de los resúmenes.

Nivel de permiso al mostrar resúmenesEl resumen refleja el contenido de los objetos de contenido. Por este motivo, el modo de seguridadpredeterminado cuando se solicitan resúmenes es no devolver objetos a los usuarios finales si tienensolo permisos Examinar en los objetos. Si crea una consulta de texto completo con los resúmenes,asegúrese de que los usuarios finales para los que crea la consulta tienen al menos el nivel de permisode lectura. También puede modificar el modo de seguridad de xPlore para que solo tenga en cuenta elnivel de permiso, Examinar o Leer, en lugar de considerar si el resumen se solicita.

Ajustar consultas de texto completo para obtener unrendimiento óptimoDocumentum xPlore automáticamente indexa en texto completo todos modelos de objeto definidos enxCP Designer. Al implementar o volver a implementar una aplicación, la configuración del índice dexPlore se actualiza. Este tema trata sobre algunos aspectos a tener en cuenta al crear los modelos deobjeto y los modelos de consulta, y al volver a implementar una aplicación.

Implementar la aplicación en un repositorio de producciónAl implementar una aplicación nueva en un repositorio que contiene datos de producción, la indexaciónlleva desde unas cuantas horas hasta semanas para millones de objetos.

Al volver a implementar una aplicación después de modificar los modelos de objeto o los modelosde consulta, el sistema provoca una reindexación de los objetos.

Optimizar las consultas de texto completoPara evitar problemas de rendimiento futuro, puede ajustar dos aspectos de las consultas de textocompleto: la indexación y el conjunto de datos devueltos.



La siguiente tabla resalta algunos puntos que pueden ayudarle a tomar decisiones para crear elmodelo de datos:


Habilitar la opción de ordenación en las columnas desalida

Configurar un conjunto de datos de consulta de textocompleto, página 232

Al habilitar la opción de ordenación en una columnade salida, un índice adicional se crea con xPlore. Parauna implementación inicial, un índice adicional tieneun impacto en el tiempo de indexación, los requisitosde espacio en disco, etc.

Al habilitar la opción de ordenación para unareimplementación, se desencadena una reindexaciónde los objetos y aumenta la latencia antes de que losusuarios finales puedan buscar los objetos reciénindexados.

En tiempo de ejecución, ordenar los campos de datosde la cadena de tipo ocupa más memoria que ordenarotros tipos de campos de datos como enteros o fechas.

Devolución de facetas con los resultados

Configurar facetas de consulta de texto completo,página 236

Al definir un modelo de consulta para devolverfacetas, xPlore calcula y devuelve las facetas por cadaconsulta.

La configuración predeterminada es devolver unmáximo de 50 valores, pero puede modificar estemáximo o quitarlo para recuperar más valores o todosellos.

Incluso aunque el widget de faceta no muestreinicialmente todos los valores, un número elevadode valores puede afectar de forma negativa elrendimiento a la hora de cargar resultados de páginasen tiempo de ejecución.

Operadores para entradas de usuario Hay algunos operadores, como No contiene y ! =, quepueden ejecutar consultas no selectivas y degradar elrendimiento de las consultas.

Detección de idioma para las consultas de textocompleto

En las consultas de texto completo, el sistema detecta el idioma para la consulta y el idioma para laindexación de objetos de contenido. La no coincidencia entre los dos detecciones puede producirresultados incoherentes. Este tema describe brevemente la detección de idioma y su rol en consultasde texto completo. La documentación de Documentum xPlore proporciona más detalles sobre latokenización, la detección de idioma, la lematización y las palabras de detención.

Dado que los términos de la consulta introducidos como entradas de usuario normalmente no tienencontexto para detectar el idioma de la consulta, se utiliza la configuración regional del exploradordel usuario final.



Con Documentum xPlore, el idioma se detecta durante la indexación para realizar la tokenizacióny lematización.

La tokenización es la identificación de palabras y, por lo tanto, depende del idioma. El tokenización serealiza en los términos de consulta y cuando se indexa contenido.

La lematización es un paso de la tokenización. Éste es un proceso que normalización que reduce unapalabra a su forma canónica. Por ejemplo, una palabra como libros se normaliza en libro eliminandola marca de plural. Soy, son y es se normalizan en ser. La lematización se aplica a los objetos decontenido indexados y a las consultas. La lematización analiza una palabra por su contexto (parte de laoración, como, por ejemplo, nombres o verbos) y el formulario canónico de una palabra (lema) seindexa. Los lemas extraídos son las palabras reales.

La lematización es útil dado que permite a los usuarios finales buscar variaciones de una palabraautomáticamente. También devuelve más resultados relevantes filtrando fuera de los resultados cuyoidioma no coincide con la consulta.

Sin embargo, si el idioma no es el mismo para la consulta y la indexación, los tokens de consultapuede que no coincidan con los tokens indexados y la búsqueda de texto completo devuelve menosresultados de los esperados. Por ejemplo, si el idioma local del explorador del usuario final es inglésy los objetos de contenido se indexan en español, una consulta con un término en español puedeque no devuelva todos los resultados esperados.

Las palabras de detención y diccionarios de tesauros dependen también del idioma y se puedenconfigurar en xPlore. Las palabras de detención son palabras que se filtran antes de la indexación, paraguardar el tamaño del índice y para evitar búsquedas de palabras comunes. Un tesauro proporcionatérminos relacionados o sinónimos que se utilizan para ampliar la consulta.

Ejemplo de no coincidencia entre el idioma del objeto de contenido y el idiomalocal del explorador

Supongamos que disponemos de dos objetos de contenido: documento A y documento B. Para ambos,xPlore detecta que su idioma es el español e indexa los siguientes tokens:

• Un documento A contiene la palabra ratón (y no la palabra ratones): el token indexado para estapalabra es ratón.

• Documento B contiene la palabra ratones (y no la palabra ratón): los tokens indexados para estapalabra son ratones y ratón, que es el formulario canónico.

Imagine un usuario final con un explorador de Internet con la configuración regional establecidaen francés. Cuando el idioma local del explorador y el idioma del objeto de contenido difieren, labúsqueda devuelve solo la coincidencia exacta entre los términos de búsqueda y el token indexado.

• Buscar el término ratón devuelve los documentos A y B debido a que ambos objetos de contenidotienen el token ratón.

• Buscar el término ratones devuelve el documento B porque es el único objeto de contenido conel token ratones.

Manejar consultas de texto completo grandesLa búsqueda de contenido de la aplicación puede devolver un gran número de resultados, sobre todo,cuando no hay ningún término de búsqueda o si se inicializa la búsqueda al cargar la página. En estoscasos, los usuarios finales pueden llegar hasta el límite de 10.000 resultados.



Este máximo está establecido en el nivel de DFC, por motivos de rendimiento. Mientras quelos usuarios finales casi nunca examinan los 10.000 resultados, es un número de resultados losuficientemente alto para crear facetas representativas de contenido de aplicación.

Los 10.000 resultados son los 10.000 resultados más relevantes después haber pasado el filtro deseguridad. Significa que, con una directiva de seguridad restrictiva, xPlore puede leer 20.000resultados para alcanzar y mantener 10.000 resultados. Cuando redefine la consulta introduciendotérminos de búsqueda o mediante la selección de valores de faceta, xPlore ejecuta una consulta nuevay más selectiva. El conjunto de resultados obtenido puede incluir resultados que se han omitido enla consulta anterior, debido a que han sobrepasado el límite de 10.000, generando inconsistenciasaparentes en los recuentos de facetas. EMC Documentum Search Development Guide (Guía deimplementación de búsquedas de EMC Documentum) describe cómo configurar el número máximo delos resultados que se devuelven por consulta.

Vista previa de consulta en tiempo real o consultade texto completo

Es posible obtener una vista previa de la consulta de texto completo o en tiempo real en tiempo dediseño. Asegúrese de que el entorno de tiempo de diseño esté configurado antes de obtener unavista previa de estas consultas.

Es posible obtener una vista previa de la primera página con 10 elementos para estas consultas. Seadmiten los siguientes campos:

Campos Compatible o no compatible

Entrada de usuario predefinida Compatible

Entrada de usuario Compatible y se puede editar este campo.

Para introducir cadenas de caracteres, utilice comillassimples. Para las entradas de varios valores, utilice’{,’} ’.

Ordenar por Compatible

Términos de resumen o de coincidencia para consultade texto completo

Compatible

Limitaciones

• No se admiten facetas en consultas de texto completo.

• Algunas expresiones en tiempo de ejecución no son compatibles en las entradas predefinidas.

Solución de problemas

• Active el registro de depuración y compruebe el registro de xCP Designer.

• Consulte el registro de xPlore para las consultas de texto completo.



Consultas históricas

Utilice las consultas históricas para diseñar gráficos que analicen rápidamente los datos de aplicación.En las consultas históricas, los datos de aplicación se obtienen sin conexión y se guardan en unalmacén de datos separados del repositorio de Documentum. Los datos devueltos por consultashistóricas pueden ser datos de instancia o agregados.

Utilice las consultas históricas para generar informes que:

• Comparen el promedio del importe del préstamo con el promedio de una garantía

• Cuenten el número de aplicaciones de préstamo enviado cada día

• Identifiquen el número máximo de importe del préstamo para cada oferta de préstamo

Recopilar datos de las aplicaciones

Suscríbase a los eventos de negocio para acumular datos en una consulta histórica. Por ejemplo, en unsistema de procesamiento de préstamos, se desencadenaría un evento de negocio cuando un préstamoentra en la fase de firma. Al suscribirse a este evento de negocio, se recopilan los datos acerca de todoslos préstamos que introduzcan firmas.

Si la consulta se suscribe a varios eventos de negocio, puede especificar qué evento de negocioproporciona los datos a una columna. A menos que se modifique, las columnas de conjuntos de datosobtienen los datos del evento de negocio predeterminado. Utilice la pestaña del conjunto de datospara cambiar la configuración predeterminada seleccionando diferentes eventos de negocio paralas columnas de conjuntos de datos.

Ciclo de vida de un evento supervisado

Cuando se desencadena un evento de negocio, los datos de aplicación contenidos en los modelos deobjeto, casos y procesos se escriben en la cola de mensajes. El motor Business Activity Monitor(BAM) supervisa la cola de Content Server y, cuando se agreguen los datos, el almacén de datos losimportará. El almacén de datos contiene datos de aplicación sin procesar y datos agregados; tambiénes el lugar del que las consultas históricas obtienen los datos. El sistema no consulta una base dedatos de producción. Los datos devueltos por las consultas se pueden calcular y utilizar en gráficos ycuadrículas que se muestran en las páginas de aplicación.

El siguiente gráfico ilustra el ciclo de vida de un evento supervisado:



Impacto de las condiciones de eventos de negocioen los informes

Un evento de negocio es un suceso que tiene lugar durante el ciclo de vida de un modelo de objeto, uncaso o un proceso. Suscriba una consulta histórica a uno o varios eventos de negocio.

Para configurar un evento de negocio, seleccione un desencadenador y escriba una condición. Sinuna condición, el sistema crea un evento de negocio cuando el valor que activa el desencadenadores verdadero. Con una condición, el sistema crea eventos de negocio cuando los valores deldesencadenador y de la condición son verdaderos.

Por ejemplo, puede configurar un evento de negocio para que se desencadene cuando un cliente envíeuna solicitud de préstamo de cliente.

Sin una condición, el sistema captura los datos de todos los préstamos nuevos, independientementedel importe o tipo. Suscríbase a este evento de negocio para informar acerca de todas las solicitudesde préstamos nuevos.

En la siguiente figura se muestra un evento de negocio sin una condición:



Utilice una condición para especificar cuándo se debe crear un evento de negocio. Porejemplo, configure un evento de negocio para que se desencadene cuando un cliente remita unasolicitud de préstamos por un importe superior a $500.000. En este ejemplo, la condición esevent.newboustomer_loan_appli.loan_amount>500000. Suscríbase a este evento denegocio para informar acerca de las nuevas solicitudes de préstamo por importes superiores a $500.000.

La siguiente figura ilustra un evento de negocio con una condición:

Las condiciones afectan a la cantidad de datos capturados, almacenados en un área de ensayo ydisponibles para gráficos e informes. En estos ejemplos, el evento de negocio sin condición capturamás datos que el evento de negocio con condición.



Comparar entradas predefinidas con condiciones deeventos de negocio

Puede generar el mismo informemediante una entrada predefinida o una condición de evento de negocio.Por ejemplo, un informe con la condición event.newboustomer_loan_appli.loan_amount>500000en un evento de negocio arroja el mismo resultado que un informe con la misma condición acercade una entrada predefinida. Con una entrada predefinida, se pueden utilizar los mismos datos deaplicación con varias consultas.

Utilice una condición de un evento de negocio para:

• Reducir el consumo de datos almacenados en el área de ensayo.

• Optimizar el rendimiento de las consultas, ya que el filtrado con entradas predefinidas no esnecesario.

• Optimizar el rendimiento del sistema, ya que únicamente los datos necesarios se transfieren alárea de ensayo.

Configurar eventos de negocio para crear informessobre objetos relacionados

Al diseñar una aplicación, puede representar datos como un único modelo de objeto o relacionar variosmodelos de objeto entre sí. La relación entre modelos de objeto afecta a la forma de configurar loseventos de negocio para recopilar datos de informe.

Al realizar informes sobre modelos de objeto relacionados, agregue un atributo a uno de los modelosde objeto y utilícelo para realizar un seguimiento de cuándo un usuario final completa la introducciónde datos. Puede utilizar este atributo como una condición de desencadenamiento en el evento denegocio. Cuando el usuario final o el sistema actualiza el valor del atributo, el sistema desencadena elevento de negocio y recopila los datos pertinentes.

Por ejemplo, diseñe una aplicación de préstamos para procesar los préstamos del cliente. Para estaaplicación, cree dos modelos de objeto relacionados. El modelo de objeto de la aplicación de préstamoscaptura la información acerca de la solicitud de un préstamo por parte de un cliente y el modelo deobjeto de garantía captura la información acerca de la garantía del préstamo. Estos modelos de objetocomparten una relación de uno a varios de modo que cada aplicación de préstamos puede tener unao varias garantías, tal y como se muestra en el siguiente gráfico:



Para configurar un evento de negocio que enumere todas las garantías de una aplicación de préstamos,agregue un atributo de estado del préstamo para el modelo de objeto de aplicación de préstamos,tal y como se muestra en el siguiente gráfico:

Después de introducir los datos de todas las garantías, el usuario final o el sistema actualizan elatributo de estado del préstamo con el valor Aprobado. Esta acción desencadena un evento denegocio, y el sistema recopila los datos de garantías y la aplicación de préstamos y los facilita parala elaboración de informes.

En el siguiente gráfico se muestra el evento de negocio de una aplicación de préstamos en el que elestado del préstamo se utiliza como la condición de desencadenamiento:



Si no configura el evento de negocio basado en el atributo que se utiliza para realizar un seguimientode cuándo el usuario termina de introducir los datos, el sistema no podrá capturar los datos pertinentes.Por ejemplo, si configura el evento de negocio en el objeto de aplicación de préstamos, el sistema nocapturará los datos de garantías porque no estaban disponibles cuando se desencadenó el evento. Siconfigura el evento de negocio en el objeto de garantía, el sistema solo recopilará los datos en laprimera garantía introducida, aunque la aplicación de préstamos tenga varias. Si configura el evento denegocio en el objeto de relación, no se capturarán datos de garantías porque el usuario no introdujoninguno cuando el sistema desencadenó el evento.

Determinar qué cálculo configurar

Utilice la tabla siguiente para determinar qué tipo de cálculo va a configurar:

Cálculo Descripción

Columna de duración Calcula el período de tiempo entre dos eventos de negocio.

Por ejemplo, cree una columna de duración para calcular el tiempodesde el momento en que se asigna una tarea de revisión hastaque se completa.



Cálculo Descripción

Columna calculada Compara valores, formatea valores y realiza cálculos.

Una columna calculada agrega una columna a un conjunto de datosy se crea a partir de una expresión que utiliza otras columnas delconjunto de datos.

Utilice el editor de expresiones para escribir las expresiones delas columnas calculadas.

Agregación Realiza cálculos básicos como promedio, suma y recuento.

En la agregación, cada columna de salida es una dimensión o unafunción.

Una dimensión representa la columna de agrupación de un gráfico,como las categorías, las personas o la hora.

Una función es una operación aritmética que representa los valoresde medición de un gráfico, como el tamaño, la cantidad o elrecuento. El tipo de datos de una columna de salida determina quéfunciones se pueden seleccionar.

Pasos de cálculo

Cada vez que se configura un cálculo, el sistema agrega un paso de cálculo al conjunto de datos. Elpaso Resultado de la auditoría contiene las columnas de salida del conjunto de datos sin cálculosconfigurados. El paso 1 contiene las funciones y las dimensiones seleccionadas para cada columna desalida. Por ejemplo, un cálculo de paso 1 calcula una suma de cantidad de garantía.

La siguiente figura ilustra un cálculo de paso 1

:

Un cálculo de paso 2 aparece cuando se utiliza una columna de salida de paso 1 en otro cálculo. Porejemplo, un cálculo de paso 2 aparece cuando se calcula el promedio del importe de las garantías.No hay límite para el número de pasos de cálculo que puede configurar. Haga clic en un paso decálculo para navegar entre los cálculos.

La siguiente figura ilustra un cálculo de paso 2:



Agregación en relaciones de uno a uno

Las relaciones de uno a uno significan que los objetos están relacionados con una única instancia deotro objeto. Por ejemplo, las entidades crediticias que suscriben hipotecas estarían interesadas encalcular el importe promedio del préstamo para cada tipo de préstamo. Esta operación se basa en unarelación uno a uno entre el ID del préstamo y su importe. Esta relación significa que para cada ID depréstamo solamente hay un importe del préstamo.

La siguiente figura compara los promedios de los importes de préstamos para cada tipo de préstamoofrecido:

La siguiente figura muestra los datos antes de que se configure el cálculo:



La siguiente figura muestra los datos una vez que el tipo de préstamo se configura como una dimensióny se obtiene el promedio del importe de préstamo:

Agregación en relaciones uno a muchos

Puede otorgar una consideración especial a aquellos cálculos que incluyan relaciones uno a muchos.En las relaciones uno a muchos, un objeto se relaciona con muchas otras instancias de otro objeto.Por ejemplo, comparar el promedio del importe del préstamo con el promedio de una garantía esuna medida que emplean las entidades crediticias que ofrecen hipotecas para determinar los riesgosfinancieros.

La siguiente figura muestra el tipo de gráfico que resulta interesante para una entidad hipotecaria:

Una sencilla comparación entre el promedio del importe de los préstamos y el promedio de unagarantía es incorrecta, porque existen relaciones uno a muchos entre el préstamo y la garantía.

La siguiente figura ilustra varias garantías para un préstamo:

El enfoque correcto es comparar el promedio del importe del préstamo con el promedio de la sumatotal de las garantías. Para generar este gráfico:



1. Agregue las siguientes columnas a un conjunto de datos: ID de préstamo, tipo de préstamo,importe del préstamo, garantía y fecha de cierre. La siguiente figura muestra cada columna delconjunto de datos:

2. Configure un cálculo en el que:

• Se sume el importe de las garantías

• Todas las demás columnas sean dimensiones

La siguiente figura muestra el importe total de las garantías de cada ID de préstamo:

3. Configure un segundo cálculo en el que:

• Se calcula el promedio del importe de las garantías

• Se obtenga el promedio del importe del préstamo

• El tipo de préstamo es una dimensión

• El ID de préstamo se elimina del cálculo

el promedio del importe del préstamo no se pueda calcular si el ID del préstamo está configuradocomo una dimensión. Elimine el ID de préstamo del cálculo para calcular el promedio del importedel préstamo.

La siguiente figura muestra una comparación entre el promedio de la suma de las garantías y elpromedio de los importes de préstamos para cada tipo de préstamo:



Ejemplos de columnas calculadasLa siguiente tabla proporciona ejemplos de columnas calculadas:


est_monthly_p+est_monthly_t Calcula el pago mensual estimado añadiendo lacolumna de capital e intereses mensuales estimados yla columna de impuestos mensuales estimados.

addDays(date_submitted, 90) Calcula una fecha mediante la adición de 90 días a lacolumna de fecha de envío.

concat(first_name, ’ ’, last_name) Concatena el nombre y el apellido del cliente.

differenceDays(date_completed, date_started) >sla_in_days

Calcula si el tiempo de ejecución del proceso superao no un umbral predefinido estimado mediante elacuerdo de nivel de servicio (SLA). Esta expresióndevuelve un valor booleano.

total_liabilities > total_assets Compara dos valores. Esta expresión devuelve unvalor booleano.

round((total_collateral_amount * 1.75), 2) Calcula el importe del préstamo máximomultiplicando la garantía total por 1,75. Redondea elvalor devuelto a una cifra con dos decimales.

Consulta de lista de tareasUtilice una consulta de lista de tareas para representar un conjunto de tareas incompletas. Permite a losusuarios finales recuperar una lista de tareas que tienen que realizar. Por ejemplo, un miembro del



equipo Finanzas puede elegir una aplicación de préstamos de una lista de aplicaciones para revisar, yaprobarla o rechazarla.

Puede restringir la lista de las tareas asignadas a ejecutores concretos, como el usuario final actual, obien las tareas de una o varias colas de trabajos. Las tareas pueden proceder de uno o más procesos.

La lista de tareas puede mostrar información relacionada con las tareas, o con cualquier paquetede proceso.Nota: De forma predeterminada, se ejecuta la consulta de lista de tareas en modo de privilegios desuperusuario. Por lo tanto, el sistema omite todas las comprobaciones de permiso y puede exponerinformación confidencial a los usuarios finales como un resultado de búsqueda.

En la siguiente tabla se ilustran diversos escenarios de cómo los paquetes y las variables definidos enlos procesos se rellenan en el conjunto de datos de consulta de lista de tareas:

Consultade listade tareas

Filtrar porproceso

Paquetes de proceso ytipos de objetos

Variables de proceso Los paquetes yvariables disponiblespara el conjunto dedatos de consulta delista de tareas

Consulta1

Préstamo decliente v1.0:nuevo procesode préstamo decliente

Paquetes de préstamode cliente v1.0:

• loan_amount

• loan_rate

• loan_date

Estos paquetes estánasociados con el tipo deobjeto CustomerBO.

Variables de Préstamode cliente v1.0:

• customer_name

• customer_age

Paquetes: tipos de objetoasociados con paquetesde Préstamo de clientev1.0, CustomerBO

Variables de Préstamo decliente v1.0:

• customer_name

• customer_age

Consulta2

Préstamo decliente v2.0:versión delproceso depréstamo decliente v1.0

Paquetes de Préstamode cliente v2.0:

• loan_amount

• loan_rate

• loan_date



• customer_name

• customer_nationality

Paquetes: tipos de objetoasociados con paquetesde Préstamo de clientev2.0, CustomerBO

Variables de Préstamo decliente v2.0:

• customer_name

• customer_national-ity

Consulta3

Préstamo decliente v1.0y Préstamode clientev2.0: procesosseleccionados delmismo grupo declientes.


• loan_amount

• loan_rate

• loan_date

Paquetes de Préstamode cliente v2.0:

• loan_amount

• loan_rate


• customer_name

• customer_age


• customer_name

• customer_

Paquetes: tipos deobjeto asociados conpaquetes de Préstamode cliente v1.0 yPréstamo de clientev2.0, CustomerBO

Variables: unión de lasvariables de los procesosPréstamo de cliente v1.0y Préstamo de clientev2.0.



Consultade listade tareas

Filtrar porproceso

Paquetes de proceso ytipos de objetos

Variables de proceso Los paquetes yvariables disponiblespara el conjunto dedatos de consulta delista de tareas

• loan_date

Los paquetes de losprocesos Préstamo decliente v1.0 y Préstamode cliente v2.0 estánasociados con el tipo deobjeto CustomerBO.

nationality• customer_name

• customer_age

• customer_national-ity

Consulta4

Préstamo deempleado v1.0:nuevo procesode préstamo deempleado

Paquetes de Préstamode empleado v1.0:

• emp_loan_amount

• emp_loan_date

Estos paquetes estánasociados con el tipo deobjeto EmployeeBO.

Variables de Préstamode empleado v1.0:

• emp_name

• emp_joining_date

Paquetes: tipos de objetoasociados con paquetesen Préstamo de empleadov1.0, EmployeeBO

Variables de Préstamo deempleado v1.0:

• emp_name


Consulta5

Préstamo decliente v1.0y Préstamode empleadov1.0: procesosseleccionadosde los gruposde clientes yempleados.


• loan_amount

• loan_rate

• loan_date


Paquetes de Préstamode empleado v1.0:

• emp_loan_amount

• emp_loan_date

Estos paquetes estánasociados con el tipo deobjeto EmployeeBO.


• customer_name

• customer_age

Variables de Préstamode empleado v1.0:

• emp_name


Paquetes: tipos de objetoasociados con paquetesde Préstamo de clientev1.0 y Préstamo deempleado v1.0:

• CustomerBO

• EmployeeBO

Variables: no se muestraninguna de las variablesde los procesos Préstamode cliente v1.0 yPréstamo de empleadov1.0.

Puede enlazar una consulta de lista de tareas a varios widgets. La siguiente tabla describe losdiferentes casos de uso:



Consulta de lista de tareasWidget Caso de uso



Sí [1]


Sí






Migración de informes de Crystal Reports

Los informes de Crystal Reports creados en versiones anteriores se pueden migrar a la versión actualde xCP Designer.

Los filtros de entrada de usuario diseñados en Crystal Reports en versiones anteriores de xCP Designerno se migran a versiones posteriores. Debe crear los filtros manualmente mediante el software dediseño de Crystal Reports.

En el diseñador de Crystal Reports, el nombre de tabla en el archivo .rpt se muestra como dataSourceen lugar de con el nombre de origen de datos real. Si desea que el nombre de tabla en el archivo .rptcoincida con el nombre del origen de datos, realice estos pasos:

1. Defina la ubicación del origen de datos.

2. Cree una conexión nueva usando Servicios XML y web y seleccione los archivos xml y xsdde <ubicación de aplicación de xCP>\Applications\<nombre de la aplicación>\<nombre de laaplicación>\gen\main\resources\crystalreport connections\<espacio de nombres de la aplicación>.

3. Vaya a Base de datos > Experto de base de datos. Seleccione la tabla en el lado derecho delcuadro de diálogo y haga clic con el botón derecho para cambiar el nombre de la tabla.



Filtros de informes de Crystal Reports

Crystal Reports no está integrado con los filtros de entrada de usuario de xCP. Debe crear manualmentelos filtros mediante el software de diseño de Crystal Reports. En la documentación de Crystal Reportsse proporciona información detallada sobre los filtros.

Aquí se muestran algunos aspectos que es necesario conocer acerca de los filtros:

• La lista desplegable se considera un campo de texto.

• Los valores de fecha proporcionados se consideran en la zona horaria UTC. Debe convertir la zonahoraria del navegador al diseñar el informe.

• El proceso sin estado enlazado con un informe de Crystal Reports no debe tener ninguna variable deproceso como tipo de entrada.

Consulta avanzada sobre el repositorio

La consulta de repositorio avanzada permite al usuario final leer datos del repositorio de maneraeficiente. A diferencia del estado complejo y engorroso que implica un proceso sin estado, la consultaavanzada es un mecanismo fácil de escribir, fácil de comprender y fácil de configurar para leer datosdel repositorio.

La consulta avanzada del repositorio permite definir una consulta compleja mediante el editor de DQL.La consulta permite conectarse a una docbase configurada en el entorno de tiempo de diseño y obteneruna vista previa de los resultados de una instrucción DQL.

Consulta parametrizada Es una técnica de ejecución de consultas que separa una cadena de consultade valores de parámetros de consulta. En tiempo de ejecución, los valores de los parámetros deconsulta deben ser proporcionados por el usuario final.

Estas cláusulas se pueden parametrizar en DQL:

1. Ordenación: Para permitir la clasificación y resolverla en tiempo de ejecución, utilice ladeclaración de consulta:

Ejemploselect * from dm_user order by ?

En la instrucción DQL, el parámetro ? se sustituye por un valor de columna predeterminada deordenación en tiempo de diseño. En caso de que el usuario final no haya configurado Ordenar por,la consulta se ordena según la primera columna.

2. Paginación: De forma predeterminada, la consulta admite la paginación. Sin embargo, a medidaque el conjunto de datos aumenta, la lista de registros que se deben recuperar desde el repositorio ola lista de resultados crecen muy rápidamente. Para evitar cualquier problema de rendimiento yrecuperar solo el conjunto de registros requerido, utilice la sugerencia RETURN_RANGE paraobtener el conjunto óptimo de registros conforme a los requisitos. Esta sugerencia se proporcionacomo una forma de paginar los resultados de una declaración de consulta.

RETURN_RANGE starting_row ending_row [optimize_top_row] ’sorting_clause’



Parámetro Descripción

fila_de_inicio Especifica a partir de qué número de fila se

devuelven de las filas aplicables.

fila_de_fin Especifica el número de fila final que se devuelve de

las filas aplicables.

optimizar_primera_fila (Opcional) Especifica el número de filas superiores

que se optimizarán mediante el optimizador de base

de datos. Si no se especifica, no se genera ninguna

sugerencia correspondiente para la instrucción

DQL.

cláusula_de_ordenación Especifica el atributo y la secuencia de ordenación

que se debe utilizar para determinar el rango. Define

la secuencia de los resultados calificados.

Ejemplos//Resolves at runtimeselect r_object_id, r_object_type, item_description, price, expiry_date

from app_obj_item enable(RETURN_RANGE ? ? ? ? )where,At runtime, the value for starting_row and ending_row parameters arederived from query parameters page and items-per-page.These values are provided automatically at runtime from widgets suchas Results List, Drop-down list.The end user should not provide any values for the starting_row andending_row parameters.

//User-defined valuesselect r_object_id, r_object_type, item_description, price, expiry_date

from app_obj_item enable (RETURN_RANGE 1 100 10 ’price ASC’)

3. Filtros de entrada: En tiempo de ejecución, se reemplazan los valores por los proporcionados porel usuario final. Esto es aplicable a las cláusulas where y having.

select user_os_name from dm_user where user_name=$PARAM$

where,The values specified within a $ sign are replaced at runtime.

Es necesario especificar un valor predeterminado para un filtro de entrada en xCP Designer. Alcargar la página, si no hay ningún valor predeterminado definido para el filtro de entrada, el sistemaasigna los valores predeterminados. Por ejemplo,

String = ’’ //( empty string)Integer = 0Float = 0.0Boolean=falseDateTime=current date and current time



4. Recuento de visitas: Para el número de filas devueltas de una consulta avanzada sobre elrepositorio, el método recomendado consiste en ejecutar la consulta DQL sin paginación. Vinculela salida de esta consulta de recuento con la propiedadMostrar recuento de registros de lalista de resultados.

select count (*) from (select user_name from dm_user where user_name=$PARAM$)

5. Menú de contexto: Para ver el menú de contexto, la consulta avanzada sobre el repositorio debetener r_object_id y r_object_type en la consulta.


Capítulo 9

Crear páginas de interfaz de usuario



Tareas

Editar la página Patrón de aplicacionesNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.

Descargue e instale Sencha CMD 6.x desde el sitio https://www.sencha.com/products/sencha-cmd/.Hay 2 versiones de Sencha CMD disponibles: de 32 bits y 64 bits. Según la variante de xCP Designerque utilice, de 32 bits o 64 bits, debe descargar la misma versión de Sencha CMD. Esto es opcional yes necesario si desea aplicar un tema personalizado.1. (Opcional) En el archivo xcpdesigner.ini, agregue la propiedad al final del archivo y reinicie xCP

Designer. Ejecute este paso solo si desea aplicar un tema personalizado.

-Dxcp.theme.compiler.location=<LocationOfSenchaCmd>Por ejemplo:-Dxcp.theme.compiler.location=C:/users/me/bin/Sencha/Cmd/6.0.2.14

2. En el navegador Interfaz de usuario, haga doble clic en la página del patrón de aplicaciones.3. Agregue widgets de las paletas situadas junto a la página del patrón de aplicaciones.4. En la pestaña Conceptos básicos, defina la página tal y como se describe en la tabla siguiente:

Campo Descripción

Etiqueta Muestra la etiqueta que se muestra en el navegador Interfaz de usuario.

Nombre delsistema

Muestra el nombre del sistema para uso interno del sistema que identifique la páginacuando se utiliza en la API.

Título deaplicación

Escriba el texto que aparecerá en la barra de título por encima de la página durante eltiempo de ejecución. La barra de título muestra Application title - Título de página,de modo que, si se deja en blanco, solo aparece Título de página.

Páginapredeterminadade la aplicación

Seleccione una página de aplicación para actuar como página predeterminada parala aplicación.

Tema de aplicación Seleccione un tema en la lista desplegable y haga clic en Aplicar.


https://www.sencha.com/products/sencha-cmd/


Campo Descripción

Descripción Escriba una descripción para compartir con otros desarrolladores de aplicaciones.

Origen Muestra el proyecto en el que se almacena la página.


Para habilitar de manera automática el complemento cliente en la página Preferencias para cadausuario, configure Al cargar la página y llame al evento Al guardar preferencias con el valorenable_client_plugin establecido en verdadero.

6. Para agregar un evento de IU, página 369, haga clic en Eventos de IU.

Crear una página de aplicaciónNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.1. En el navegador de interfaz de usuario, seleccione Nuevo→Página.2. En el cuadro de diálogo Página nueva, seleccione el proyecto en el que se almacenará la página en

la lista desplegable Proyecto.3. En el campo Alcance de la página, seleccione Aplicación.4. En el campo Etiqueta, escriba una etiqueta para identificar la página de aplicación.5. Haga clic en Finalizar.

Editar una página de aplicación1. En el navegador Interfaz de usuario, haga doble clic en la página.2. En la pestaña Conceptos básicos, defina la página tal y como se describe en la tabla siguiente:

Campo Descripción

Etiqueta Etiqueta para identificar la página de aplicación. Si cambia esta etiqueta, el sistemagenera un nuevo nombre del sistema.

Nombre delsistema

Nombre de sistema que el sistema utiliza internamente para identificar la página de laaplicación cuando se utiliza en la API.

Este nombre se basa en la etiqueta. Si cambia la etiqueta, el sistema genera un nuevonombre del sistema.

Título de página Texto que aparecerá en la barra de título por encima de la página en tiempo deejecución. La barra de título muestra Título de aplicación - Título de página, asíque, si se deja en blanco, solo aparece Título de aplicación.

El título de la página se puede configurar como Estático o Dinámico. Puede usar eleditor Expresión para establecer el título de la página de forma dinámica.

Descripción Descripción para compartir con otros desarrolladores de aplicaciones.

Origen Proyecto en el que se almacena la página.

Alcance de lapágina

Alcance de la página; si se trata de una página de aplicación o una página de objeto.La ubicación de la página en el navegador Interfaz de usuario varía con estaselección. Si selecciona la página del objeto, haga clic en Seleccionar y elija elmodelo de objeto.



3. Haga clic en Diseño y configure los widgets en la página.• Para agregar un widget a la página, arrastre un widget de la paleta Widgets y suéltelo enla página.

• Para configurar un widget en la página, selecciónelo y configure las pestañas en la vistaPropiedades.

4. Para agregar un parámetro de sesión, página 371, expanda Interacciones. En el áreaMensajespersonalizados, puede definir los mensajes personalizados para el éxito o error mediante eleditor de expresiones. Seleccione Deshabilitar mensaje de error estándar para deshabilitarlos mensajes de error estándar para el servicio de datos. Debe vincular estos mensajes de errorpersonalizados al widget Visualización de errores. Si se han especificado mensajes personalizados(éxito o error), el sistema muestra los mensajes de éxito o de error estándar.


Crear una versión de rol1. En el navegador Interfaz de usuario, haga clic con el botón derecho en la página para la que

vaya a crear la versión de rol.2. Seleccione si va a crear una versión de rol o si va a duplicar una versión de rol existente.3. En el cuadro de diálogo Versión de rol vacía o Duplicar versión de rol, escriba una etiqueta.4. Haga clic en Agregar.5. En el cuadro de diálogo Agregar rol de aplicación, utilice las teclas de flecha para mover los

roles al área Roles de aplicación seleccionada.6. Haga clic en Aceptar.7. En el cuadro de diálogo Versión de rol vacía o Duplicar versión de rol, haga clic en Finalizar.

Agregar un rol a una versión de rol1. En la pestaña Conceptos básicos, haga clic en Agregar.2. En el cuadro de diálogo Agregar rol de aplicación, utilice las teclas de flecha para mover los

roles al área Roles de aplicación seleccionada.3. Haga clic en Aceptar.

Eliminar un rol de una versión de rol1. En la pestaña Conceptos básicos, seleccione el rol o roles que se van a eliminar.2. Haga clic en Quitar.

Configurar una acción de menú de contextoEste procedimiento se aplica a modelos de objeto de negocio, carpeta, contenido, archivador, proceso yrelación. Para los modelos de objeto de negocio, contenido, carpeta y archivador, también se puedenestablecer atributos de varios valores.



1. En el navegador de Interfaz de usuario, haga clic con el botón secundario en el modelo de objetoy haga clic en Crear menú de contexto.

Note: Para un proceso, se puede configurar el menú contextual en los niveles siguientes:

• Todo el nivel de proceso: en todo el nivel de proceso haciendo clic en el nodo raíz en la Interfazde usuario de proceso en el navegador Interfaz de usuario.

• Dentro de un proceso específico: en todas las actividades de un proceso específico y para unaactividad específica dentro de un proceso específico.

2. En la paleta Acciones, arrastre el widget Acción del menú de contexto y suéltelo en el editorMenú de contexto.

Si añade posteriormente páginas o flujos de acción al modelo de objeto, el sistema no los agregaráal menú contextual. Agréguelos manualmente.

3. Para cambiar el orden de un elemento de menú contextual, seleccione Menú contextual yarrástrelo arriba y abajo según sea necesario.

4. Para configurar un elemento de menú contextual, selecciónelo y especifique las propiedades.5. En la pestaña General del área Conceptos básicos de la vista Propiedades, escriba una Etiqueta

para el elemento de menú.6. En la pestaña General del área Acción de la vista Propiedades, configure las acciones de menú

tal y como se describe en la siguiente tabla:

Invocar acciones Descripción

Instancia delservicio de datos

En la lista desplegable Instancia del servicio de datos, seleccione una instancia delservicio de datos que desee asociar. Si la instancia del servicio de datos que deseaseleccionar no existe, agréguela desde el panel Interacciones del editor de diseño.

Dependiendo de la instancia del servicio de datos seleccionada, especifique losdemás detalles en el área Acción.

Ninguno No se especifica ninguna acción a menos que se haya configurado un evento de IU.

Ir a URL Especifique la dirección URL a la que está enlazado el elemento de menú.

Descargar En tiempo de ejecución, descarga un archivo.

Editar documento En tiempo de ejecución, descarga un archivo y se abre en la aplicación adecuadapara su edición. Antes de descargar el archivo, el sistema lo bloquea en el servidorpara evitar que otros usuarios lo editen.

Cancelar edición En tiempo de ejecución, elimina el bloqueo en el archivo y permite que otrosusuarios editen el contenido.

Importar versiónnueva

En tiempo de ejecución, importa el archivo modificado en el servidor.

Crear carpeta En tiempo de ejecución, crea una nueva carpeta en el servidor.

Importar archivo En tiempo de ejecución, importa un nuevo archivo en una ubicación de su elecciónen el servidor.

Si la acción es una acción de eliminación, en tiempo de ejecución, el usuario se redirige a unaubicación diferente tal y como se describe en la siguiente tabla:

Modelo de objeto Ubicación de redireccionamiento

Objeto de negocio Página actual

Contenido (sin selección) Página actual



Modelo de objeto Ubicación de redireccionamiento

Contenido (con selección) Página anterior

Carpeta (con selección) Página anterior

Los eventos de IU se pueden desencadenar en las acciones del menú de contexto configurado.

7. Si se ha seleccionado la acción Ir a la página o Instancia de servicio de datos y una páginaespecífica en el ajuste Una vez hecho, vaya a para invocar en tiempo de ejecución en el áreaAcción, especifique los valores en Selección de página tal como se describe en la tabla siguiente:

Campo Descripción

Ninguno No va a ninguna página. Esta es la configuración predeterminada.

Estático Navegue y seleccione una página estática fija a la que navegar en tiempo de ejecución.

Si la página seleccionada es una página de instancia, especifique una expresión de IDde objeto. Para una página de aplicación, no se requiere ningún ID de objeto.

Expresión Utilizando el selector, especifique una expresión que defina qué página debe apareceren tiempo de ejecución. Una expresión se resuelve en forma de nombre de páginacon el formato <espacio de nombres>_<nombre_de_página>.

Para la asignación de un solo valor, asigne el modelo con atributos del modosiguiente:

model[0].single // concatenates first modeland its single attribute.

model[0].multi[0] // concatenates first modeland its first attribute

Para una asignación de varios valores, asigne el modelo con atributos del modosiguiente:

model.single //concatenates all modelsand single attribute

model.multi //concatenates all modelsand all multivalue attributes

model.multi[0] //concatenates all modelsand first attribute

model[0].multi // concatenates first modeland multiple attributes

Si la página seleccionada es una página de instancia, especifique la expresión de IDde objeto. Para una página de aplicación, no se requiere ningún ID de objeto.NotaPuede configurar la acción predeterminada para un menú contextual soloen una página que se haya seleccionado usando el selector de artefactos. En laspáginas y direcciones URL basadas en expresiones, el sistema no admite la acciónpredeterminada puesto que hay casos en los que la evaluación de la expresión nogenera ningún valor o el sistema vuelve a evaluarla expresión para que se reflejen losnuevos valores, lo cual actualiza la cuadrícula.



Campo Descripción

URL Escriba una expresión para constituya la URL que define qué página debe apareceren tiempo de ejecución. Las direcciones URL pueden incluir http, https o ftp. Si nose especifica ningún identificador de protocolo, el sistema asume el protocolo http deforma predeterminada.

Abrir página dedestino en unanueva pestaña

Seleccione si el vínculo de destino se debe abrir en una pestaña nueva al hacer clicen él.

• Destino: especifique el destino que identifica la pestaña de la página de destino.

• Parámetros de URL: especifique cadenas de consulta parametrizadas para laURL incluyéndolas en una URL de página.

Note: En tiempo de ejecución, si el vínculo de destino no se abre en una pestañanueva, asegúrese de que no haya ningún bloqueo de ventanas emergentes habilitado.

8. En el panel Interacciones, haga clic para agregar una interacción. En el área Mensajespersonalizados, puede definir los mensajes personalizados para el éxito o error mediante eleditor de expresiones. Seleccione Deshabilitar mensaje de error estándar para deshabilitarlos mensajes de error estándar para el servicio de datos. Debe vincular estos mensajes de errorpersonalizados al widget Visualización de errores. Si se han especificado mensajes personalizados(éxito o error), el sistema muestra los mensajes de éxito o de error estándar.

9. En la pestaña Comportamiento, configure el elemento de menú tal y como se describe en latabla siguiente:

Campo Descripción

Oculto cuando Escriba una expresión que evalúe las condiciones, lo que, si es verdadero, impideque el usuario final vea el widget. Si no introduce una expresión, el widget de menúcontextual está visible.

Haga clic en Seleccionar para incluir datos de la página en la expresión.

Deshabilitadocuando

Escriba una expresión que evalúe las condiciones, lo que, si es verdadero, deshabilitael elemento de menú para el usuario final. Si no introduce una expresión, el elementode menú se habilita.

Haga clic en Seleccionar para incluir datos de la página en la expresión.

En un nodo Desligado del navegador de interfaz de usuario, todos los menús contextuales seetiquetan del mismo modo. Si tiene varios menús contextuales en el nodo Desligado, debe abrirlospara determinar el modelo de objeto de negocio, contenido o carpeta al que pertenecen.

Crear una página de objeto de negocioNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.



1. En el navegador de interfaz de usuario, haga clic en Nuevo→Página.

2. En el cuadro de diálogo Página nueva, seleccione el proyecto en el que se almacenará la página enla lista desplegable Proyecto.

3. En el campo Alcance de la página, seleccioneModelo de objetos o proceso específico.

4. Haga clic en Seleccionar.

5. En el cuadro de diálogo Seleccionar artefacto, seleccione el modelo de objeto y haga clic enFinalizar.

6. Seleccione los widgets y enlaces que se van a agregar a la página.

7. Escriba una etiqueta para identificar la página de objeto de negocio.


La página Crear <nombre de objeto de negocio> (o Editar <nombre de objeto de negocio>,oMostrar <nombre de objeto de negocio>) aparece en el objeto de negocio, dentro del nodoInterfaz del usuario de objeto de negocio. En tiempo de ejecución, el sistema agrega una acciónde ir a la barra al menú contextual para el objeto de negocio (si se genera un menú contextual).Por ejemplo, el menú contextual de Cliente contiene las selecciones de página Editar clientey Visualizar cliente.

Si se ha modificado el nombre del modelo de objeto de la página, debe quitar manualmente todas lasinstancias de servicios de datos que hagan referencia al modelo anterior antes de guardar la página.

El sistema crea los campos de entrada solo para los atributos que haya agregado. Debe agregarcampos de entrada para los atributos heredados.

Editar una página de objeto de negocio1. En el navegador Interfaz de usuario, haga doble clic en la página de objeto de negocio.

2. Elija una de las siguientes opciones:

• Para configurar un widget en la página, selecciónelo y configure las pestañas en la vistaPropiedades.

No configure un botón Eliminar para redirigir a la página actual o a una página específica que sehaya eliminado, ya que el objeto eliminado no puede aparecer.

• Para agregar un widget a la página, arrastre un widget de la paleta Widgets y suéltelo enla página.

3. En la pestaña Conceptos básicos, defina la página tal y como se describe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar la página de objeto de negocio. Si cambia estaetiqueta, el sistema genera un nuevo nombre del sistema.

Nombre delsistema

Escriba un nombre de sistema para uso interno del sistema que identifique la páginade objeto de negocio cuando se utilice en la API.




Campo Descripción

Título de página Escriba el texto que aparecerá en la barra de título por encima de la página durante eltiempo de ejecución. La barra de título muestra Application title - Título de página,de modo que, si se deja en blanco, solo aparece Título de aplicación.

El título de la página se puede configurar como Estático o Dinámico. Puede usar eleditor Expresión para establecer el título de la página de forma dinámica.


Origen Muestra el proyecto en el que se almacena la página.

Alcance de lapágina

Seleccione si la página es una página de aplicación o una página de objeto. Laubicación de la página en el navegador Interfaz de usuario varía con esta selección.Si selecciona la página del objeto, haga clic en Seleccionar y elija el modelo deobjeto.

La página se usaráprincipalmentepara la creación denuevas instanciasde <modelode objetos denegocio>. Permitala navegación aesta página desdecualquier página.

Seleccione esta opción para impedir la visualización y edición de una instancia de un<modelo de objetos de negocio>. No es una página de instancia, aunque sea unapágina de <modelo de objetos de negocio>. Puede enlazar a esta página desde unapágina principal.

Déjelo en blanco para hacer que sea una página de instancias. Solo se puede utilizarpara ver o editar una instancia de un <modelo de objetos de negocio>.

4. En la pestaña Diseño, defina el botón para una página Crear <nombre de objeto de negocio> oEditar <nombre de objeto de negocio>.

5. Para agregar un parámetro de sesión, página 371, expanda Interacciones. En el áreaMensajespersonalizados, puede definir los mensajes personalizados para el éxito o error mediante eleditor de expresiones. Seleccione Deshabilitar mensaje de error estándar para deshabilitarlos mensajes de error estándar para el servicio de datos. Debe vincular estos mensajes de errorpersonalizados al widget Visualización de errores. Si se han especificado mensajes personalizados(éxito o error), el sistema muestra los mensajes de éxito o de error estándar.


Crear un fragmento de página1. En el navegador de Interfaz de usuario, haga clic con el botón secundario en Interfaz del usuario

de aplicación y haga clic en Nuevo fragmento de página.2. En el cuadro de diálogo Nuevo fragmento de página, si la aplicación contiene proyectos,

seleccione el proyecto donde el sistema almacena el fragmento de página.3. En el campo Alcance del fragmento de página, seleccione Aplicación oModelo de objetos

específico.4. Si seleccionaModelo de objetos específico:

a. Haga clic Examinar y seleccione un modelo de objetos.b. En el área Generar widgets y enlaces, seleccione los widgets y enlaces que el sistema agrega a

la página.

Según la selección del modelo de objeto, aparece la lista Generar widgets y enlaces:



Modelo de objeto Generar widgets y enlaces

Contenido Ninguno, Mostrar, Editar, Importar e Importar versión nueva

Carpeta Ninguna, Mostrar, Editar y Crear carpeta

Objeto de negocio Ninguno, Crear, Mostrar y Editar

Excepto para la opción Ninguno, el sistema genera automáticamente los elementos de interfazde usuario y servicios de datos necesarios y los enlaza todos juntos. Este enlace significa quepuede agregar el fragmento de página a varias páginas de aplicación.

5. En el campo Etiqueta, escriba una etiqueta para identificar el fragmento de página.6. Haga clic en Finalizar.7. En la pestaña Conceptos básicos, defina el fragmento de página tal y como se describe en la

siguiente tabla:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar un fragmento de página.

Nombre delsistema

Escriba un nombre de sistema para uso interno del sistema que identifique elfragmento de página cuando se utilice en la API.



8. En el área Comportamiento, utilice el editor de expresiones para especificar una expresión. Entiempo de ejecución, el fragmento de página se oculta si la expresión se evalúa como verdadera.

9. En la pestaña Datos, en el área Entradas del fragmento de página, haga clic en Agregar entraday defina la entrada tal y como se describe en la siguiente tabla:

Campo Descripción

Nombre Escriba un nombre para identificar la entrada del fragmento de página.

Tipo o modelo Haga clic Tipo y seleccione un tipo del cuadro de lista, o haga clicModelo y hagaclic en Examinar para seleccionar un modelo de objetos.

Tiene variosvalores

Seleccione esta opción para permitir varios valores de entrada.

Asignación dedatos

Utilice el editor de expresiones para introducir un valor de parámetro de sesiónpredeterminado para la entrada.

10. En el área Salidas de fragmento de página, haga clic Agregar entrada y defina una salidatal y como se describe en la siguiente tabla:

Campo Descripción

Nombre Escriba un nombre para identificar la salida del fragmento de página.

Tipo o modelo Haga clic Tipo y seleccione un tipo del cuadro de lista, o haga clicModelo y hagaclic en Examinar para seleccionar un modelo de objetos.

Tiene variosvalores


Asignación dedatos

Utilice el editor de expresiones para introducir un valor de parámetro de sesiónpredeterminado para la salida.



11. En la pestaña Diseño, arrastre un widget y suéltelo en un editor de diseño y utilice las pestañasGeneral, Estilo y Comportamiento para configurar el widget.

Un fragmento de página puede contener varios widgets.12. Para agregar un parámetro de sesión, página 371, expanda Interacciones.13. Para agregar un evento de IU, página 369, haga clic en Eventos de IU.

Crear una página de carpetaNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.1. En el navegador de interfaz de usuario, seleccione Nuevo→Página.

2. En el cuadro de diálogo Página nueva, seleccione el proyecto en el que se almacenará la página enla lista desplegable Proyecto.

3. En el campo Alcance de la página, seleccioneModelo de objetos o proceso específico.4. Haga clic en Seleccionar.5. En el cuadro de diálogo Seleccionar artefacto, seleccione la carpeta y haga clic en Finalizar.6. Seleccione los widgets y enlaces que se van a agregar a la página.7. Escriba una etiqueta.8. Haga clic en Finalizar.

La página Editar <modelo de carpeta> o la página Ver <modelo de carpeta> aparecen en elnavegador Interfaz de usuario bajo el nodo de su carpeta en el nodo Interfaz de usuario decarpeta. El sistema agrega una acción de ir a página al menú contextual para la carpeta (si segenera un menú contextual). Por ejemplo, el menú contextual de una carpeta Cliente contiene lasselecciones de página Editar cliente y Visualizar cliente.

La página Ver <modelo de carpeta> contiene un conjunto de widgets de inicio que permitenhacer lo siguiente:

• Ver el contenido y las carpetas de la carpeta mediante una lista de resultados que está vinculada aun servicio de datos en tiempo real de contenido de carpeta

• Realizar la edición y eliminación de operaciones:

– Haga clic en Editar información para abrir la página Editar carpeta.– Haga clic en Eliminar para eliminar la carpeta o el contenido seleccionado.

9. Quite todas las columnas del widget de lista de resultados de la página Ver <modelo de carpeta>que no desee que el usuario final vea.

Puede agregar una lista de resultados a una página Editar <modelo de carpeta> y enlazarla a unservicio de datos en tiempo real de contenido de carpeta.


Antes de enlazar de nuevo una página a un modelo de carpeta cuyo nombre se haya cambiado,cierre y vuelva a abrir la página.




10. En la pestaña Conceptos básicos, defina el Título de la página. Se puede configurar comoEstático o Dinámico. Puede usar el editor Expresión para establecer el título de la páginade forma dinámica.


Editar una página de carpeta1. En el navegadorModelos de objetos, haga doble clic en la página de carpeta.2. Utilice el editor de la página de carpetas para agregar o configurar atributos.3. Haga clic en Guardar.

Crear una página de contenidoNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.1. En el navegador de interfaz de usuario, seleccione Nuevo→Página.2. En el cuadro de diálogo Página nueva, seleccione el proyecto en el que se almacenará la página en

la lista desplegable Proyecto.3. En el campo Alcance de la página, seleccioneModelo de objetos o proceso específico.4. Haga clic en Seleccionar.5. En el cuadro de diálogo Seleccionar artefacto, seleccione el contenido y haga clic en Finalizar.6. Seleccione los widgets y enlaces que se van a agregar a la página.7. Escriba una etiqueta.8. Haga clic en Finalizar.

La página Editar <modelo de contenido> o la página Ver <modelo de contenido> aparecen en elnavegador Interfaz de usuario. El sistema agrega una acción de ir a página al menú contextualdel contenido. Por ejemplo, el menú contextual del contenido Cliente contiene las seleccionesde página Editar cliente y Visualizar cliente.

Mostrar <modelo de contenido> contiene un conjunto de widgets de inicio que le permitenrealizar lo siguiente:

• Si la página es heredada, puede ver información acerca de los atributos heredados y los atributospersonalizados que son específicos del modelo de contenido actual. Además, puede obteneruna vista previa del contenido y proporcionar comentarios si los widgets se han configuradoen el modelo de contenido.

• Si la página se genera desde cero, contiene los widgets que son específicos para la página delmodelo de contenido predeterminado.

• En las páginas que se heredan o crean desde el principio, puede realizar operaciones de edicióny eliminación:

– Haga clic en Editar información para abrir la página Editar contenido.– Haga clic en Eliminar para eliminar el contenido.







Editar una página de contenido1. En el navegadorModelos de objetos, haga doble clic en la página de contenido.2. Utilice el editor de la página de contenido para agregar o configurar atributos.3. Haga clic en Guardar.

Crear una página para iniciar un procesoNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.1. En el navegador de interfaz de usuario, seleccione Nuevo→Página.2. En el cuadro de diálogo Página nueva, seleccione el proyecto en el que se almacenará la página en

la lista desplegable Proyecto.3. En el campo Alcance de la página, seleccioneModelo de objetos o proceso específico.4. Haga clic en Seleccionar.5. En el cuadro de diálogo Seleccionar artefacto, seleccione el proceso y haga clic en Finalizar.6. Seleccione la actividad de inicio en la lista desplegable Actividad.7. Escriba una etiqueta.8. Haga clic en Finalizar.9. Seleccione los widgets y enlaces que se van a agregar a la página.


Crear una página de tareaNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.1. En el navegador de interfaz de usuario, seleccione Nuevo→Página.2. En el cuadro de diálogo Página nueva, seleccione el proyecto en el que se almacenará la página en

la lista desplegable Proyecto.3. En el campo Alcance de la página, seleccioneModelo de objetos o proceso específico.4. Haga clic en Seleccionar.5. En el cuadro de diálogo Seleccionar artefacto, seleccione el proceso y haga clic en Finalizar.6. Seleccione una tarea en la lista desplegable Actividad.7. Escriba una etiqueta.8. Haga clic en Finalizar.



9. Seleccione los widgets y enlaces que se van a agregar a la página.

Si elimina una actividad enlazada a una página de tarea o cambia su nombre, vuelva a enlazarla yresuelva manualmente cualquier expresión rota.


Eliminar una página1. En el navegador Interfaz de usuario, haga clic con el botón derecho en la página que desea

eliminar.2. Seleccione Eliminar.

Crear una página de archivadorNo configure un servidor proxy en la configuración del explorador de Internet o no podrá ver la página.1. En el navegador de interfaz de usuario, seleccione Nuevo→Página.2. En el cuadro de diálogo Página nueva, seleccione el proyecto en el que se almacenará la página en

la lista desplegable Proyecto.3. En el campo Alcance de la página, seleccioneModelo de objetos o proceso específico y haga

clic en Seleccionar.4. En el cuadro de diálogo Seleccionar artefacto, seleccione el archivador y haga clic en Finalizar.5. Seleccione los widgets y enlaces que se van a agregar a la página.6. Escriba una etiqueta.7. Haga clic en Finalizar.

La página Editar <modelo de archivador> o la página Ver <modelo de archivador> aparecerán enel navegador Interfaz de usuario dentro del nodo del archivador en el nodo Interfaz de usuariode archivador. El sistema agrega una acción de ir a página al menú contextual para el archivador(si se genera un menú contextual). Por ejemplo, el menú contextual del archivador Cliente contienelas selecciones de página Editar cliente y Visualizar cliente.

La página Ver <modelo de archivador> contiene un conjunto de widgets de inicio que permitenhacer lo siguiente:

• Ver el contenido mediante una lista de resultados que está vinculada a un servicio de datos entiempo real de contenido de carpeta

• Realizar la edición y eliminación de operaciones:

– Haga clic en Crear desde plantilla para crear un archivador desde una plantilla.– Haga clic en Importar archivos para importar archivos al archivador seleccionado.– Haga clic en Nueva carpeta para crear una carpeta nueva para el archivador seleccionado.– Haga clic en Editar información para abrir la página Editar archivador.– Haga clic en Eliminar para eliminar el archivador o el contenido seleccionado.

8. Quite todas las columnas del widget de lista de resultados de la páginaVer <modelo de archivador>que no desee que el usuario final vea.



Puede agregar una lista de resultados a una página Editar<modelo de archivador> y vincularla auna consulta de contenido de carpeta.


Antes de enlazar de nuevo una página a un modelo de archivador cuyo nombre se haya cambiado,cierre y vuelva a abrir la página.




Importar un tema1. En el editorModelo de aplicación, haga clic en Agregar biblioteca.2. En el cuadro de diálogo Agregar biblioteca, haga clic en Examinar y seleccione la carpeta donde

se encuentra el tema.3. En la lista desplegable Copiar a, seleccione la ubicación en la que importar el tema.4. En el área Bibliotecas a copiar, seleccione el tema que se va a importar.5. Haga clic en Finalizar.

Una vez importado, el tema se puede seleccionar y aplicar desde la pestaña Conceptos básicosde la página principal.

Agregar un widget a una páginaHay dos métodos para agregar un widget a una página:

• Arrastrar el widget desde la paleta y colocarlo en la página.

• Hacer doble clic en un widget de la paleta para agregarlo a la página.

La posición del widget depende de la selección actual en la página. Si tiene algo seleccionado, elwidget aparecerá en la página por debajo del widget seleccionado. Si no hay nada seleccionado, elwidget aparecerá en la parte inferior de la página.

Una vez que el widget se agrega a la página, se selecciona automáticamente.

Puede cortar o copiar un widget y pegarlo en la misma página, fragmento de página o paso de la interfazde usuario o en otra página, fragmento de página o paso de la interfaz de usuario. También puedeseleccionar múltiples widgets a la vez con la tecla Ctrl. Al copiar un widget vinculado a un servicio dedatos y pegarlo en la misma página, fragmento de página o paso de la interfaz de usuario, el sistema noduplica el servicio de datos correspondiente. Sin embargo, si se pega en otra página, fragmento depágina o paso de la interfaz de usuario, el sistema de copia y pega el servicio de datos correspondienteen la página, el fragmento de página o el paso de la interfaz de usuario de destino. Si existe el mismoservicio de datos en el destino, el sistema crea una instancia más en el panel Interacciones.



Puede hacer clic en los widgets para usar los elementos Cortar ,Copiar oPegar del menú contextual.Como alternativa, puede utilizar Ctrl + C, Ctrl + X o Ctrl + V como accesos directos de teclado.También puede usar la opción Pegar en el área en blanco del editor de páginas cuando no hay ningúnwidget seleccionado.

El sistema selecciona automáticamente todos los widgets secundarios en un widget contenedor. Estopermite copiar y pegar también el contenido de los widgets secundarios.

Configurar un fragmento de páginaEste procedimiento se aplica a las páginas de Aplicación, Objeto de negocio, Carpeta y Contenido.1. En el navegador de Interfaz de usuario, abra una página.2. En la paletaWidgets, arrastre un widget Fragmento de página y suéltelo en el editor de diseño.3. En la pestaña General de la vista Propiedades, en el campo ID, escriba un ID para el fragmento

de página.4. En el área Fragmento de página, seleccione ID de fragmento de página y, a continuación,

haga clic en Examinar para especificar un fragmento de página. Se obtiene una vista previa delfragmento de página seleccionado en el editor de diseño. El ID de fragmento de página es opcional.Puede establecer un ID de fragmento de página o proporcionar una suscripción al evento en lapestaña Comportamiento para establecerla.

5. En el área Asignación de entrada de fragmento de página, utilice el editor de expresiones paradefinir un valor para cada entrada.

6. En la pestaña Estilo, haga lo siguiente:

Campo Descripción

Márgenes Especifique los valores para los márgenes alrededor del fragmento de página.

Clase CSS Especifique un nombre de clase para la hoja de estilo en cascada (CSS) quese aplique al widget.

Ancho Especifique el ancho del fragmento de página. Si el contenido es mayor queel ancho especificado, el sistema muestra la barra de desplazamiento. Deforma predeterminada, la opción Automáticamente está seleccionada. Acontinuación, el widget de un contenedor ajusta el ancho siguiendo el anchodel contenedor.

El ancho máximo puede ser 1.048 píxeles.

Alto Especifique la altura del fragmento de página. Si el contenido es mayor quela altura especificada, el sistema muestra la barra de desplazamiento. Deforma predeterminada, la opción Automáticamente está seleccionada. Laaltura máxima puede ser 1.048 píxeles.

7. Publique eventos de IU o suscríbase a estos en la pestaña Comportamiento.a. Haga clic en el área Publicar para agregar uno de los siguientes:

• Desencadenantes: haga clic para agregar un desencadenante que escuche las acciones o loseventos que se llevan a cabo en un widget, una instancia del servicio de datos o un evento deIU, lo que, a su vez, desencadenará el evento de IU que se publicará.

• Con condición: escriba una expresión que evalúe la condición que, si es verdadera, publicael evento de IU. Es opcional.



• Evento de IU: seleccione el evento de interfaz de usuario que se va a publicar. Haga clicen Siguiente.

b. Especifique el valor de cada parámetro de evento de interfaz de usuario. Haga clic en Finalizar.El sistema muestra la publicación recién agregada en la cuadrícula.

c. En el área Suscribir, haga clic para agregar uno de los siguientes:

• Comportamiento: haga clic para agregar la acción que se va a realizar en el widget:configurar el ID de fragmento u ocultar el fragmento cuando se cumpla la condición.Proporcione el valor para cada acción mediante el editor de expresiones.

• Desencadenador de comportamiento: seleccione el evento al que desea suscribirse.El comportamiento se realiza cuando se desencadena cualquiera de los eventos. Si noproporciona ningún desencadenador, el sistema realiza la suscripción implícita según elvalor del comportamiento.

• Condición de desencadenador: escriba una expresión que evalúe la condición, que en casode ser verdadera, realiza el comportamiento. Es opcional.

d. Haga clic en Finalizar.El sistema muestra la suscripción recién agregada en la cuadrícula.

Agregar un atributo heredado a una páginaSiga este procedimiento para una página de creación o edición. Si está utilizando una páginade visualización, utilice un widget de visualización de valor y asigne el Valor inicial a<objeto>.<atributo>.I1. Arrastre y suelte un widget de entrada en la página y establezca sus propiedades.2. En el área Interacciones, seleccione la interacción.3. En el cuadro de diálogo Entradas de la vista Propiedades, seleccione los atributos heredados.4. Haga clic en Seleccionar.5. En el cuadro de diálogo Selector, haga clic en Datos de contexto.6. En el nodo widgets del área superior, seleccione el widget de entrada que ha agregado.7. En el área inferior, seleccione Valor.8. Haga clic en Aceptar.

Eliminar un widget de una página1. Seleccione el widget que desea eliminar.2. Haga clic con el botón derecho en el widget y seleccione Eliminar.

Seleccionar un widget en un editor de diseñoSeleccione un widget para editar sus propiedades o para copiarlo, moverlo o eliminarlo. Dado que loswidgets pueden contener subelementos, como una columna en el widget Cuadro de columna, a veceses difícil seleccionar el elemento para editarlo. Este tema le proporciona sugerencias de selección.

• Para seleccionar un widget, haga clic en el widget en el editor de diseño.



• Para seleccionar un subelemento en un widget que contiene elementos complejos, primero hagaclic en el widget y, a continuación, haga clic en el subelemento.

Tras la selección, el elemento seleccionado se resalta en el editor y sus propiedades se muestran enla vista Propiedades.

Agregar un widget personalizado a una aplicación1. En el editorModelo de aplicación, haga clic en Agregar biblioteca.2. En el cuadro de diálogo Agregar biblioteca, haga clic en Examinar y seleccione la carpeta en la

que se encuentra el widget.3. En la lista desplegable Copiar a, seleccione la ubicación en la que agregar el widget.4. En el área Bibliotecas a copiar, seleccione el widget que se va a importar.5. Haga clic en Finalizar.

Una vez importado, el widget personalizado está disponible en la paleta Widgets de los editoresde diseño.

Configurar un árbol de contenido1. En la paletaWidgets, arrastre y suelte un widget Árbol de contenido en una página de aplicación.2. En el área Conceptos básicos de la pestaña General en la vista Propiedades, defina el árbol de

contenido tal y como se describe en la tabla siguiente:

Campo Descripción

ID Escriba un ID para el widget.

Título Escriba el título que se muestra en la parte superior del árbol de contenido.

Información sobreherramientas

Escriba información sobre herramientas para el árbol de contenido.

Habilitar arrastrar ysoltar

Seleccione Habilitar arrastrar y soltar para habilitar la acción de arrastrar ysoltar archivos en tiempo de ejecución.

Mostrar solocarpetas

Seleccione esta opción para mostrar solo las carpetas y no los archivos.

Mostrar objetosocultos

Seleccione esta opción para mostrar los objetos ocultos.

3. En el área Navegación, defina el árbol de contenido tal y como se describe en la tabla siguiente:

Campo Descripción

Raíz Escriba la ruta de acceso de la carpeta en el nivel más alto de la jerarquía al que elusuario final puede acceder mediante este árbol de contenido.

Si este campo se deja en blanco, el usuario final no puede seleccionar el nivelde raíz en tiempo de ejecución.

Mostrar archivos anivel de raíz

Seleccione si el usuario puede ver las carpetas y los archivos o solo las carpetas enel nivel más alto de la jerarquía.

El usuario final debe seleccionar un nodo para mostrar su contenido.



4. En el cuadro de diálogo Altura de la pestaña Estilo, especifique una altura en píxeles que limite laaltura del widget al valor introducido, o bien seleccione automático para permitir que el widget seexpanda para adaptarse a su contenido.

5. En el campo Clase CSS de la pestaña Estilo, especifique un nombre de clase para la hoja deestilo en cascada (CSS) que se aplique al widget.

6. Publique los eventos de IU en la pestaña Comportamiento.a. Haga clic en el área Publicar para agregar uno de los siguientes:





Crear un menú de navegación1. En la paletaWidgets, arrastre y suelte un widgetMenú de navegación en una página.2. En la pestaña General de la vista Propiedades, configure el widget tal y como se describe en la

tabla siguiente:

Campo Descripción


Orientación del menú Seleccione la orientación de los elementos de menú de nivel superior delwidget de menú de navegación.

Visualización del submenú Seleccione cómo abrir un submenú.

3. Suscríbase a los eventos de IU en la pestaña Comportamiento.a. En el área Suscribir, haga clic para agregar uno de los siguientes:

• Comportamiento: haga clic para agregar la acción que desea realizar en el widget.Proporcione el valor para cada acción mediante el editor de expresiones.



b. Haga clic en Finalizar.El sistema muestra la suscripción recién agregada en la cuadrícula.

Configurar un menú de navegación1. Agregue o quite elementos de menú.



• Haga clic con el botón derecho en el menú y seleccione Insertar elemento al principio oInsertar elemento al final.

• Haga clic con el botón derecho en un elemento de menú y seleccione Insertar elemento antesde o Insertar elemento después de.

• Para agregar un elemento de submenú, haga clic con el botón derecho en un elemento de menú yseleccione Insertar elemento de submenú.

• Para quitar un elemento de menú, haga clic con el botón derecho y seleccione Eliminar.2. Para reordenar los elementos de menú, arrástrelos y suéltelos en el menú de nivel superior o dentro

de un submenú.3. Agregue separadores a los submenús para facilitar su lectura.

• Para agregar un separador, haga clic con el botón secundario en un elemento de submenúy seleccione Insertar separador.El separador se inserta debajo del elemento de menú seleccionado actualmente o junto a unmenú de nivel superior horizontal.

• Para quitar un separador, haga clic con el botón secundario en el separador y seleccioneEliminar.

4. Seleccione el widgetMenú de navegación.5. En la pestaña General de la vista Propiedades, configure el menú de navegación tal y como se


Campo Descripción


Orientación delmenú

Seleccione la orientación de los elementos de menú de nivel superior del widget demenú de navegación.

Visualización delsubmenú

Seleccione cómo abrir un submenú.

6. Seleccione un elemento de menú dentro del widgetMenú de navegación.7. En el área Conceptos básicos de la vista Propiedades, configure el elemento de menú tal y como


Campo Descripción

Etiqueta Escriba una etiqueta para identificar el elemento de menú.

También puede modificar la etiqueta directamente en el menú de navegación.

8. En el área Enlaces, identifique el enlace de página para el elemento de menú tal y como se describeen la tabla siguiente:

Campo Descripción


Seleccione Ninguno si tiene un elemento de menú que se va a utilizar comoelemento principal de un elemento de submenú.

Estático Navegue y seleccione una página estática fija a la que navegar en tiempo deejecución.

Si la página seleccionada es una página de instancia, especifique una expresión deID de objeto. Para una página de aplicación, no se requiere ningún ID de objeto.



Campo Descripción

Expresión Utilizando el selector, especifique una expresión que defina qué página debeaparecer en tiempo de ejecución. Una expresión se resuelve en forma de nombre depágina con el formato <espacio de nombres>_<nombre_de_página>.

Si la página seleccionada es una página de instancia, especifique una expresión deID de objeto. Para una página de aplicación, no se requiere ningún ID de objeto.

URL Escriba una expresión para constituya la URL que define qué página debe apareceren tiempo de ejecución. Las direcciones URL pueden incluir http, https o ftp. Sino se especifica ningún identificador de protocolo, el sistema asume el protocolohttp de forma predeterminada.

Abrir página dedestino en una nuevapestaña

Seleccione si el vínculo de destino se debe abrir en una pestaña nueva al hacerclic en él.




9. Repita los pasos del 6 al 8 para el resto de elementos de menú del menú de navegación.10. En la pestaña Estilo, especifique un nombre de clase para la hoja de estilo en cascada (CSS) que

se aplique al widget.11. Suscríbase a los eventos de IU en la pestaña Comportamiento.

a. En el área Suscribir, haga clic para agregar uno de los siguientes:





Configurar un widget de diseño de bordeUse este procedimiento para configurar el diseño de borde o las regiones dentro del widget de diseñode borde.



1. En la paletaWidgets, arrastre y suelte un widget Diseño de borde en el editor de diseño.

2. Seleccione el diseño de borde completo o sus regiones inherentes como parte del diseño.

3. En el área Conceptos básicos de la pestaña General en la vista Propiedades, defina el diseño deborde tal y como se describe en la tabla siguiente:

Campo Descripción


Título Escriba el encabezado que aparece encima del diseño de borde.

4. En el área Conceptos básicos de la pestaña General de la vista Propiedades, defina las regionestal y como se describe en la tabla siguiente:

Campo Descripción

ID Escriba un ID para la región.

Título Escriba el encabezado que aparece encima de la región.

Región Indica la región seleccionada del diseño.

Desplazarautomáticamente

Seleccione la opción para habilitar el desplazamiento automáticamente.

Mostrar divisor Seleccione la opción para permitir el cambio de tamaño de las regiones.

Contraíble Seleccione la opción para que las regiones sean contraíbles.

Iniciar contraído Seleccione la opción para que una región específica aparezca contraída.

Note: En el tiempo de ejecución, al guardar cambios en cualquiera de las regiones, el sistemaconserva estos ajustes. Por ejemplo, al contraer la región Norte, el sistema conserva la región Nortecomo contraída. Al actualizar la página, el sistema reanuda el comportamiento predeterminado.

Note: Es posible cortar o copiar cualquier región dentro del mismo diseño de borde. Es posiblemover o copiar cualquier región específica a otro diseño de borde, siempre que esa región no estédisponible. La región central no se puede eliminar.

5. En el área Diseño de la pestaña Estilo, defina el diseño de borde tal y como se describe en latabla siguiente:

Campo Descripción

Alto Indique la altura del diseño de borde:

• px: escriba una altura para cada región.

Note: Solo se puede especificar la configuración de altura para las regiones Nortey Sur del diseño.

Ancho Indique el ancho del diseño de borde:

• px: escriba una anchura para cada región.

• %: escriba una anchura para cada región.

Note: Solo se puede especificar la configuración de ancho para las regiones Anchoy Este del diseño.

Note: El panel de diseño de borde no es contraíble, mientras que las regiones soncontraíbles según los ajustes de configuración.



6. En el campo Clase CSS del área Estilo, especifique un nombre de clase de la hoja de estilo encascada (CSS) que se aplica al diseño de borde.






Configurar un widget de acordeónUtilice este procedimiento para diseñar un diseño de acordeón que admite varios paneles, con unestilo de acordeón expandido.1. En la paletaWidgets, arrastre y suelte un widget Acordeón en el editor de diseño.2. Seleccione el acordeón entero o sus paneles inherentes como parte del widget.3. En el área Conceptos básicos de la pestaña General en la vista Propiedades, defina el acordeón

tal como se describe en la tabla siguiente:

Campo Descripción


Título Escriba el encabezado que aparece encima del widget.

Un solo panel Seleccione la opción para permitir que aparezcan varios paneles con un estilo deacordeón expandido. Esto significa que un panel aparece expandido y los demásaparecen contraídos.

Varios paneles Seleccione la opción para permitir que aparezca más de un panel del widget abiertoa la vez. El sistema distribuye por igual las dimensiones de la pantalla entre todoslos paneles.

4. En el área Conceptos básicos de la pestaña General en la vista Propiedades, defina los panelesdel acordeón tal y como se describe en la tabla siguiente:

Campo Descripción

ID Escriba un ID para el panel del acordeón.

Título Escriba el encabezado que aparece en la parte superior del panel del acordeón.

Desplazarautomáticamente

Seleccione la opción para habilitar el desplazamiento automáticamente.

Iniciar contraído Seleccione la opción para que un panel específico aparezca contraído en tiempode ejecución.

Note: Si la opción Iniciar contraído está seleccionada y se contraen todos lospaneles de acordeón, el sistema elige un panel del acordeón al azar y lo muestraexpandido.



5. En el área Diseño de la pestaña Estilo, defina el acordeón tal y como se describe en la tablasiguiente:

Campo Descripción

Alto Indique la altura del widget de acordeón:

• %: escriba una altura para el widget.

• automático: el contenido del widget de acordeón determina la altura del widget.

• px: escriba una altura para el widget.

Ancho Indique el ancho del widget de acordeón:

• %: escriba un ancho para el widget.

• automático: el contenido del acordeón determina el ancho del widget.

• px: escriba un ancho para el widget.

6. En el campo Clase CSS del área Estilo, especifique un nombre de clase de la hoja de estilo encascada (CSS) para aplicar al widget de acordeón.






Crear un cuadro de columnaEl widget de cuadro de columna es un contenedor de diseño para los widgets. Cree un widget decuadro de columna para proporcionar una estructura de diseño a los widgets.1. En la paletaWidgets, arrastre un widget Cuadro de columna y suéltelo en un editor de diseño.2. Configure el widget de cuadro de columna y sus columnas tal y como se describe en Configurar

un cuadro de columna, página 317.

Configurar un cuadro de columna1. Haga clic en el área de encabezado del widget de cuadro de columna para seleccionarlo.2. En el área Conceptos básicos de la pestaña General en la vista Propiedades, especifique la

información tal y como se describe en la tabla siguiente:

Campo Descripción




Campo Descripción

Título Escriba el título que aparecerá en la barra de título en tiempo de ejecución. Dejeeste campo en blanco para ocultar la barra de título. Por ejemplo, puede ocultarla barra de título para utilizar el cuadro de columna solo para diseño y posición.Para utilizar el cuadro de columna como sección o como contenedor para campos,agregue un título para el cuadro de columna.

El cuadro se puedecontraer

Seleccione esta opción para que el cuadro de columna se contraiga verticalmente entiempo de ejecución. Cuando el cuadro de columna se contrae, solo permanecenvisibles el título y el icono de alternar. Esta funcionalidad requiere un título

El área Columnas muestra una lista de columnas y las configuraciones actuales tal y como sedescribe en la tabla siguiente:

Columna de sololectura

Descripción

# Muestra un número de columna asignado automáticamente.

Orientación Indica si la alineación de columna es vertical u horizontal.

Ancho Muestra el ancho definido para la columna.

Ancho mínimo Muestra el ancho mínimo de la columna.

Desbordamiento Muestra el comportamiento en tiempo de ejecución de la columna cuando lacolumna es más estrecha que su contenido. Cortar indica que algunos de loscontenidos se cortan y no son visibles. Barra de desplazamiento indica que elcontenido puede verse mediante un desplazamiento horizontal.

Separador entrecolumnas

Indica si la columna contiene un separador.

3. Agregue o quite columnas según sea necesario.• Para agregar una columna, selecciónela y haga clic con el botón secundario en ella en el widgetde cuadro de columna junto al lugar donde desea agregar la nueva columna y seleccioneInsertar columna a la derecha o Insertar columna a la izquierda.

• Para quitar una columna, selecciónela, haga clic con el botón secundario en ella y seleccioneEliminar columna.

4. Para seleccionar la columna, haga clic en el área de encabezado de una Columna dentro delwidget Cuadro de columna.

5. En el área Diseño, especifique la configuración de columna tal y como se describe en la tablasiguiente:

Campo Descripción

Orientación Seleccione la orientación de columna vertical (predeterminado) u horizontal.

Ancho Seleccione una de las siguientes opciones:

• auto: ancho de la columna en píxeles. Rellena automáticamente el espaciohorizontal restante.

• px: ancho fijo en píxeles.

• %: ancho expresado en forma de porcentaje sobre ancho total de la tabla.

Ancho mínimo Si el valor del ancho es automático o%, puede definir un ancho mínimo para lacolumna. Si establece un valor de ancho mínimo, la columna no se reduce pordebajo de este valor al cambiar de tamaño el explorador.



Campo Descripción

Desbordamiento decontenido

Seleccione el comportamiento en tiempo de ejecución para aquellos casos en queel cambio de tamaño de un separador provoque que la columna sea más estrechaque el contenido.

• Recortar contenido

• Mostrar barra de desplazamiento

Separador entrecolumnas

Seleccione esta opción para tener un separador junto al borde de la columna.

6. En el área Contenido de columna, seleccione el comportamiento del widget contenido en lacolumna tal y como se describe en la tabla siguiente:

Campo Descripción

Posición de etiqueta Seleccione la posición de etiqueta para las etiquetas de todos los widgets queaparecen en la columna.

Toda la configuración de etiqueta invalida la configuración de tema. Si seleccionaTema, se utiliza la configuración de posición de la etiqueta de tema.

Ancho de la etiqueta Escriba el ancho de etiqueta para todos los widgets que aparezcan en la columna.

Alineación vertical Seleccione la alineación vertical para todos los widgets dentro de la columna.

Alineaciónhorizontal

Seleccione la alineación horizontal para todos los widgets dentro de la columna.

Márgenes Escriba los márgenes que aparecen alrededor de los widgets agregados a la columna.

No coloque widgets con anchos variables (por ejemplo, un widget de lista de resultados, gráficode columnas, indicador o circular, o de visor) dentro de un cuadro de columna con orientaciónhorizontal, ya que este se expande para adaptarse a los componentes incluidos. El widget nose muestra y no puede eliminarse.

7. Repita los pasos del 4 al 6 para las columnas restantes del cuadro de columna.8. Suscríbase a los eventos de IU en la pestaña Comportamiento.






Agregar un widget a un widget contenedorDe forma predeterminada, un widget contenedor no tiene contenido, pero puede agregar widgets a él.Por ejemplo, puede agregar un widget de texto enriquecido a una columna de un widget de cuadro de



columna de modo que el usuario pueda ver información acerca de lo que muestra la celda. No coloquewidgets con anchos variables (por ejemplo, un widget de lista de resultados, gráfico de columnas,indicador o circular, o de visor) dentro de un cuadro de columna con orientación horizontal, ya que estese expande para adaptarse a los componentes incluidos. El widget no se muestra y no puede eliminarse.

Arrastre y suelte el widget desde la paletaWidgets a la celda del widget contenedor. Asegúrese de quela celda esté resaltada antes de colocar el widget.

Configurar un área de contenido1. Haga clic en cualquier lugar dentro del Área de contenido para seleccionarla y arrástrela hasta

una de las siguientes ubicaciones:• En cualquier lugar en el nivel raíz de la página• En un widget de cuadro de columna

2. En la pestaña Estilo, especifique los márgenes para el área de contenido.3. En la tabla siguiente se describen las reglas para mostrar el contenido direccionable por URL, en la

ubicación especificada por el área de contenido:

Tamaño Regla de visualización del área de contenido

Ancho Si el contenedor es la página, rellene la página completamente. Si el contenedores un widget de diseño, como un cuadro de columna, especifique el ancho de lacolumna mediante las reglas de la columna: Fijo, Automáticamente o %. Siel contenido es mayor que el ancho especificado, el sistema muestra la barra dedesplazamiento. De forma predeterminada, la opción Automáticamente estáseleccionada. El ancho máximo puede ser 1.048 píxeles.

Alto El contenido que reemplaza el área de contenido determina el alto. Si el contenidoes mayor que la altura especificada, el sistema muestra la barra de desplazamiento.De forma predeterminada, la opción Automáticamente está seleccionada. Laaltura máxima puede ser 1.048 píxeles.

4. En la pestaña Estilo del área Formato, especifique un nombre de clase para la hoja de estilo encascada (CSS) que se aplique al widget.

Configurar un widget Grupo de pestañas1. En la paletaWidgets, arrastre y suelte un widget Grupo de pestañas en el editor de diseño.2. Haga clic con el botón derecho en la pestaña y utilice las acciones del menú contextual para

agregar, copiar o quitar pestañas.3. Seleccione el grupo de pestañas.4. En el área Conceptos básicos de la pestaña General en la vista Propiedades, defina el grupo de

pestañas tal y como se describe en la tabla siguiente:

Campo Descripción


Título Escriba el encabezado que aparece sobre el grupo de pestañas.



5. En el área Valor, Establecer ID de pestaña seleccionada mediante el editor de expresiones.Puede seleccionar la pestaña para que se muestre durante el tiempo de ejecución. También puedeestablecer la pestaña según los eventos de IU. ID de pestaña seleccionada y Todos los ID depestaña están disponibles como propiedades de salida. Se agrega un nuevo evento, boxready.

Puede configurarMostrar todas las fichas al cargar en el grupo de pestañas. Esta opción se debeconfigurar esta opción con true para que se muestren todas las pestañas al cargar la página. Elvalor predeterminado de esta opción es false.

6. Seleccione una pestaña.7. En el área Ficha, defina la pestaña tal y como se describe en la tabla siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta que aparezca en la pestaña.


Escriba información sobre herramientas para su pestaña.

Icono Haga clic en Seleccionar y elija una imagen que funciona como un icono para lapestaña. La altura del icono está limitado a menos de 26 píxeles.

Clase CSS Especifique un nombre de clase de una hoja de estilo en cascada (CSS) que seaplica a la pestaña.

8. Repita los pasos 5–7 para las demás pestañas.9. En el área Diseño de la pestaña Estilo, defina el grupo de pestañas tal y como se describe en la

tabla siguiente:

Campo Descripción

Posiciónde pestaña

Seleccione el lugar donde las pestañas se adjuntan al panel.

Ancho de pestaña Indique el ancho de cada pestaña:

• Automático: el contenido de cada pestaña (etiqueta e icono) determina laanchura de la pestaña. Se muestran las pestañas con distintos anchos en funcióndel contenido.

• px: escriba una anchura para cada pestaña.

Ancho mínimo depestaña

Indica la anchura menor que tiene una pestaña incluso si el panel de pestañas sehace más pequeño. Se produce desbordamiento de pestaña.

Alto de panel Indique la altura del panel de la pestaña:

• Automático: el contenido del panel de pestañas determina la altura del panel.

• px: escriba una altura para cada pestaña.

Ancho de panel Indique el ancho del panel de la pestaña:

• Automático: el contenido del panel de pestañas determina la anchura del panel.

• px: escriba una anchura para cada pestaña.

Ancho mínimo depanel

Escriba la anchura con la que debe aparecer una barra de desplazamiento horizontalen el explorador si el panel de pestañas se hace más pequeño.

10. En el campo Clase CSS del área Estilo, especifique un nombre de clase de la hoja de estilo encascada (CSS) que se aplica a la pestaña grupo.

11. Publique eventos de IU o suscríbase a estos en la pestaña Comportamiento.



a. Haga clic en el área Publicar para agregar uno de los siguientes:










Configurar una casilla de verificación1. En la paletaWidgets, arrastre un widget de casilla de verificación y colóquelo en un editor de

diseño.2. En la ficha General de la vista Propiedades, especifique la configuración y los valores básicos del

widget tal y como se describe en la tabla siguiente:

Campo Descripción


Etiqueta Escriba una etiqueta para identificar la casilla de verificación. Ejemplo: Estadodel cliente

Valor Seleccione un atributo booleano para enlazar a este widget. Una vez enlazado, laetiqueta del widget se actualiza con la etiqueta del atributo.

Si la casilla de verificación es una entrada de un servicio de datos, y esta no estáactivada en tiempo de ejecución, el valor del atributo no se considera como falso ylas instancias en las que el atributo es verdadero se devuelven a la lista de resultados.

De forma predeterminada, el sistema evalúa el valor de la expresión y lo rellena. Entiempo de ejecución, cada vez que cambia el valor de la expresión, el sistema vuelvea evaluar y asignar el valor actualizado de nuevo.

Texto de la casillade verificación

Escriba el texto que aparece junto a la casilla de verificación. Ejemplo: ClientePremier













4. En la pestaña Validación, defina lo siguiente para validar cualquier widget de entrada:

Campo Descripción

Es obligatorio Selecciónelo para que el campo sea obligatorio.

Error eninformación sobreherramientas

Seleccione esta opción para ocultar la descripción emergente de mensaje de error quese muestra al pasar el ratón. Debe utilizar el widget de visualización de errores paramostrar los mensajes de error.

Validaciones Haga clic para agregar una de estas condiciones para validar el widget.

• Eventos desencadenantes: indica el evento que desencadena la evaluación dela expresión de validación. Se agrega un evento desencadenante de ”cambio”predeterminado para el widget al agregar una condición de validación. Si elcampo se deja vacío, la validación se desencadena solo cuando el widget se hayainicializado. Haga clic para abrir una lista de eventos de widget, eventos deservicio de datos y eventos de interfaz de usuario.

• Expresión de validación: indica las expresiones que evalúan en tiempo deejecución. Haga clic para abrir y agregar Datos de contexto, Funciones yParámetros.

• Mensaje de validación: indica el texto que muestra el sistema cuando se produceun error de validación. Este mensaje se muestra para el usuario final al pasar elratón sobre el campo erróneo.

Configurar la entrada y visualización de comentarios1. En la paletaWidgets, arrastre un widget Comentarios y suéltelo en un editor de diseño.2. En el área Conceptos básicos de la pestaña General en la vista Propiedades, defina el widget

Comentarios tal y como se describe en la tabla siguiente:



Campo Descripción


Mostrar el nombredel elemento en eltítulo

Seleccione si el nombre del objeto asociado con los comentarios aparece o no comoel título del widget cuando se utiliza la aplicación.

El widget se puedecontraer

Seleccione si el widget se puede contraer verticalmente o no, ocultando loscomentarios.

Contraído pordefecto

Seleccione si el widget se puede contraer verticalmente o no la primera vez que unusuario visita la página.

Mostrar elcomentario másreciente en la partesuperior

Muestra el comentario más reciente en orden cronológico.

Filtro de versionesde comentarios

Según sus necesidades, seleccione una de las acciones siguientes:

• Mostrar comentarios independientes de la versión: todos los comentarios sonvisibles para el usuario final y no están vinculados a ninguna versión específica.

• Mostrar comentarios específicos de la versión: los comentarios están vinculadosa una versión específica del documento. Los comentarios están visibles solo alvisualizar la versión específica con la que están relacionados.

• El usuario selecciona: el usuario dispone de la opción de seleccionar comentariosdependientes o independientes de la versión en tiempo de ejecución.


Escriba información sobre herramientas para el árbol de contenido.

Tecla de accesorápido

Seleccione una combinación de teclas que puedan utilizarse en tiempo de ejecuciónpara mover el foco al árbol de contenido.

3. En el campo ID de objeto, escriba el ID de objeto para el objeto cuyos comentarios desea mostrar.Si este campo se deja en blanco, el widget muestra los comentarios del objeto actual.

4. En la pestaña Estilo, haga lo siguiente:

Campo Descripción

Clase CSS Especifique un nombre de clase para la hoja de estilo en cascada (CSS) quese aplique al widget.

Ancho Especifique el ancho del widget de comentarios. Si el contenido es mayorque el ancho especificado, el sistema muestra la barra de desplazamiento. Deforma predeterminada, la opción Automáticamente está seleccionada. Elancho máximo puede ser 1.048 píxeles.

Alto Especifique la altura del widget de comentarios. Si el contenido es mayorque la altura especificada, el sistema muestra la barra de desplazamiento. Deforma predeterminada, la opción Automáticamente está seleccionada. Laaltura máxima puede ser 1.048 píxeles.

5. Suscríbase a los eventos de IU en la pestaña Comportamiento.








Configurar un widget de entrada de fecha y hora1. En la paletaWidgets, arrastre y suelte un widget Entrada de fecha/hora o Entrada multivalor de

fecha y hora en el editor de diseño.

No utilice widgets multivalor para buscar cualquier tipo de consulta en los campos de datosmultivalor. Los usuarios finales solo pueden introducir un valor a la vez.

2. En la pestaña General de la vista Propiedades, especifique los valores tal y como se describeen la tabla siguiente:

Campo Descripción


Etiqueta Escriba una etiqueta para identificar el widget de hora y fecha.

Aviso Para un widget de entrada de hora y fecha, escriba el texto para ayudar a los usuariosfinales a introducir la fecha. Tenga claro el formato de fecha adecuado que debeescribir el usuario final para introducir correctamente la fecha.

Valor Seleccione un atributo o escriba una expresión que proporcione los datos queaparecen como el valor seleccionado inicialmente.

De forma predeterminada, el sistema evalúa el valor de la expresión y lo rellena. Enel tiempo de ejecución, cada vez que cambia el valor de la expresión, el sistemavuelve a evaluar y asignar el valor actualizado.

3. En la pestaña Estilo de la vista Propiedades, especifique el aspecto y el formato para la hora yfecha como se describe en la tabla siguiente:

Campo Descripción

Ancho Escriba una anchura fija para el campo, o seleccione Automático: para permitirque el campo de entrada se ajuste automáticamente para rellenar la anchura delcontenedor.

Alto Para un widget de entrada de hora y fecha de varios valores, escriba una altura parael widget.

Clase CSS Especifique un nombre de clase para la hoja de estilo en cascada (CSS) que seaplique al widget.



Campo Descripción

Estilo de fecha Seleccione si ocultar o no la hora.

El estilo de fecha determina si la fecha almacenada se convierte o no a la hora local.

• Solo fecha: la fecha se convierte de la hora universal coordinada (UTC) a lahora local.

Por ejemplo, si un usuario final en la ciudad de Nueva York introduce la hora yfecha del 4 de febrero de 2012, el sistema muestra la hora y fecha a un usuariofinal en San Francisco como 3 de febrero de 2012. La fecha se almacena como 4de febrero de 2012, 12:00 AM, y el sistema lo convierte a la hora local del 3de febrero de 2012, 9:00 PM.

• Fecha del historial: la fecha no se convierte a partir de la hora universalcoordinada (UTC). Utilice esta opción para asegurarse de que la fecha almacenadaaparece como un valor absoluto en todas las zonas horarias y no se convierte (porejemplo, fechas como cumpleaños y aniversarios).

Por ejemplo, si un usuario final en la ciudad de Nueva York introduce la hora yfecha del 4 de febrero de 2012, el sistema muestra la hora y fecha a un usuariofinal en San Francisco como 4 de febrero de 2012. La fecha se almacena como 4de febrero de 2012, 12:00 AM, y no se convierte a la hora local.

• Hora y fecha: la fecha se convierte de la hora universal coordinada (UTC) enla hora local.

Por ejemplo, si un usuario final en la ciudad de Nueva York introduce la hora yfecha del 4 de febrero de 2012, 2:00 AM, el sistema muestra la hora y fecha a unusuario final en San Francisco como 3 de febrero de 2012, 11:00 PM.

Formato de fecha Seleccione el formato para la fecha.

Si selecciona el formato corto con un año de dos dígitos, entonces 00–50 indicalos años 2000–2050, mientras que 51–99 indica 1951–1999. Utilice el formato decuatro dígitos, no local y que distingue entre mayúsculas y minúsculas para evitareste problema.

Formato de hora Seleccione el formato para la hora.

Note:

• Al buscar una fecha utilizando el estilo Fecha del historial, la fecha de entrada utiliza la zonahoraria del cliente. Al buscar una fecha del historial, debe configurar el widget de fecha con elestilo Fecha del historial. De forma similar, al buscar las fechas solo de fecha, debe configurar elwidget de fecha con el estilo Solo fecha.

• Los widgets de fecha presentan una función automática de sustitución de respuesta que generavalor de fecha siguiente. Esto es debido a la funcionalidad ExtJS subyacente. Esta propiedad seexpone mediante un parámetro de aplicación que se puede crear, como el valor useStrictDate(boolean) creado en el espacio de nombres de la aplicación. Si no se crea el parámetro deaplicación, se establece el valor predeterminado true (boolean), lo que indica que la fechano se convierte en la fecha válida siguiente. Sin embargo, cuando el parámetro de aplicación seestablece en False, una fecha como 30/02/2015 cambia a 02/03/2015, ya que el mes de febrerosolo tiene 28 días.

Un asterisco (*) junto a las opciones de formato de hora y fecha indica que el formato depende dela configuración regional.















Campo Descripción










Configurar un campo para la entrada de un número1. En la paletaWidgets, arrastre y suelte un widget Entrada de números o Entrada multivalor

de números en un editor de diseño.


2. En la pestaña General en la vista Propiedades, especifique la configuración básica del widget enlos campos tal y como se describe en la tabla siguiente:

Campo Descripción


Etiqueta Escriba una etiqueta para identificar el campo de entrada de número.

Aviso Para un widget de entrada de números, escriba el texto para ayudar a los usuariosfinales a introducir números en el cuadro de entrada.

En tiempo de ejecución, el texto de pregunta aparece dentro del cuadro de entrada ydesaparece cuando el usuario final hace clic en el cuadro de entrada.




3. En el área Diseño de la pestaña Estilo, configure el widget tal y como se describe en la tablasiguiente:

Campo Descripción

Ancho Escriba una anchura fija, o para un widget de entrada de números seleccioneAutomático para permitir que el campo de entrada se ajuste automáticamente pararellenar la anchura del contenedor.

El campo Ancho controla únicamente el tamaño del cuadro de entrada, no el tamañototal del widget.

Alto Para un widget de entrada de números de varios valores, escriba una altura.

4. En el área Formato de la pestaña Estilo, especifique un nombre de clase para la hoja de estilo encascada (CSS) que se aplique al widget.














Campo Descripción








Configurar un área de texto

1. En la paletaWidgets, arrastre un widget Área de texto y suéltelo en un editor de diseño.


Campo Descripción


Etiqueta Escriba una etiqueta para identificar el widget de hora y fecha.



Campo Descripción

Aviso Escriba el texto para ayudar a los usuarios finales a introducir la fecha.

Valor Seleccione el atributo que desee enlazar a este widget.



Campo Descripción

Ancho Escriba una anchura fija para el área de entrada de texto, o seleccione Automático:para permitir el campo de entrada se ajuste automáticamente para rellenar la anchuradel contenedor.


Alto Escriba una altura fija para el área de texto.













Campo Descripción




Campo Descripción







Configurar un campo para la entrada de texto1. En la paletaWidgets, arrastre y suelte un widget Entrada de texto o Entrada multivalor de

texto en un editor de diseño.


2. En la pestaña General en la vista Propiedades, especifique la configuración básica del widget enlos campos tal y como se describe en la tabla siguiente:

Campo Descripción


Etiqueta Escriba una etiqueta para identificar el campo de entrada de texto.

Aviso Para un widget de entrada de texto, escriba el texto para ayudar a los usuarios finalesa introducir texto en el cuadro de entrada.

En tiempo de ejecución, el texto de pregunta aparece dentro del cuadro de entrada ydesaparece cuando el usuario final hace clic en el cuadro de entrada.






Campo Descripción

Ancho Escriba una anchura fija o, para un widget de entrada de texto, seleccioneAutomático para permitir que el campo de entrada se ajuste automáticamente pararellenar la anchura del contenedor.


Alto Para un widget de entrada de varios valores de texto, escriba una altura.














Campo Descripción




Campo Descripción







Configurar un widget de lista desplegable1. En la paletaWidgets, arrastre y suelte un widget Lista desplegable o Selección múltiple de lista

desplegable en un editor de diseño.


2. En el área Conceptos básicos de la pestaña General en la vista Propiedades, defina la listadesplegable tal y como se describe en la tabla siguiente:

Campo Descripción


Etiqueta Escriba una etiqueta para identificar la lista desplegable.

Aviso Escriba el texto que aparecerá en la lista desplegable cuando no haya ningúnelemento seleccionado. Este texto le pide al usuario que seleccione un valor.

3. En el área Valor de la pestaña General, defina la lista desplegable tal y como se describe en lasiguiente tabla:



Campo Descripción


De forma predeterminada, el sistema evalúa el valor de la expresión y lo rellena.En tiempo de ejecución, cada vez que cambia el valor de la expresión, el sistemavuelve a evaluar y asignar el valor actualizado de nuevo.

Todos los valores y Todas las etiquetas están disponibles como propiedades desalida. Puede seleccionar Todos los valores como valor inicial mediante el editorde expresiones. selectedValue está disponible como propiedad de salida quepermite recuperar valores de la lista desplegable.

Se ha agregado un nuevo evento: ’load’.


El tipo de datos determina los controles de visualización disponibles para darformato al widget.

Origen de datos Mediante el selector de un solo modelo, los valores posibles se pueden rellenardesde una lista de selección, un parámetro de sesión o una instancia de serviciode datos.

Limitación: al invocar el servicio de datos, se recuperan los primeros 1000resultados para una consulta histórica, de texto completo o en tiempo real.

Si utiliza la misma instancia de servicio de datos para la lista desplegable quepara un widget de lista de resultados, el widget de lista desplegable sobrescribe elconjunto de tamaño de página para la lista de resultados.

Si el tipo de datos de la instancia de servicio de datos o la lista desplegable que seha seleccionado no es compatible con el tipo de datos seleccionado anteriormente,debe eliminar manualmente el error devuelto en la vista Problemas después decorregir el tipo de datos.

Valor Seleccione el valor que se almacena en el repositorio cuando se realiza una seleccióny se guarda en tiempo de ejecución. Este valor no aparece para el usuario final.

Visualización Seleccione la etiqueta que aparece en la lista cuando la lista desplegable se visualizaen tiempo de ejecución. Esta etiqueta representa el valor seleccionado en la listadesplegable Valor.

Por ejemplo, Iniciar proceso utiliza el ID de empleado como una entrada. Si unorigen de datos devuelve Nombre de empleado (Cadena), ID de empleado (entero),seleccione Nombre de empleado en la lista desplegable Visualización y seleccioneel ID de empleado en la lista desplegable Valor. El usuario final ve John Smithcomo una de las entradas, pero 12345 es el valor correcto para el proceso.

4. En la pestaña Estilo, especifique un nombre de clase para la hoja de estilo en cascada (CSS) quese aplique al widget.














Campo Descripción








Habilitar anexos de proceso1. En la paletaWidgets, arrastre y suelte un widget Anexo en el editor de diseño.2. En la pestaña General de la vista Propiedades, especifique los valores tal y como se describe


Campo Descripción


Título Escriba un título para el widget.

Etiqueta Escriba una etiqueta para identificar el widget de anexos.



Campo Descripción

Valor inicial Seleccione un atributo o escriba una expresión que proporcione los datosque aparecen como el valor seleccionado inicialmente. Por ejemplo,demo_manual_task.attachments.

Seleccione Administrar eventos de IU para evaluar una expresión al producirseun evento de IU.

Permitir laselección dearchivos delrepositorio

Seleccione De una carpeta del repositorio para permitir la selección de archivosdel repositorio en tiempo de ejecución.

Seleccione ID de carpeta raíz si la carpeta se identifica por su ID de objeto o Rutade carpeta raíz si la carpeta se identifica por su ruta.


Permitir laselección dearchivos de launidad local

Seleccione De una carpeta de la unidad local para permitir la selección de archivosde la unidad local en tiempo de ejecución.

Seleccione Habilitar arrastrar y soltar para habilitar la acción de arrastrar y soltararchivos en tiempo de ejecución.

A continuación, en la lista desplegable, seleccione un flujo de acción de importación.Cuando el archivo se elimina, se desencadena el flujo de acción de importaciónelegido.

3. En la pestaña Estilo en la vista Propiedades:

1. Configure la apariencia del widget.2. Especifique un nombre de clase para la hoja de estilo en cascada (CSS) que se aplique al widget.

4. En la ficha Comportamiento de la vista Propiedades, configure el widget tal y como se describeen la tabla siguiente:

Campo Descripción

Oculto cuando Escriba una expresión que evalúe las condiciones, lo que, si es verdadero, impide queel usuario final vea el widget. Si no introduce una expresión, el widget está visible.

Haga clic en Selector para incluir datos de la página en la expresión.


Configurar la selección de archivosEl selector de archivos también es compatible con los atributos de varios valores.1. En la paletaWidgets, arrastre un widget Selector de archivos y suéltelo en un editor de diseño.2. En la pestaña General de la vista Propiedades, especifique los valores del widget tal y como se


Campo Descripción

ID Especifique un ID para el widget Selector de archivos.

Etiqueta Especifique una etiqueta para identificar el widget Selector dearchivos.



Número de archivos permitido Especifique el número de archivos que el usuario final puedeimportar en tiempo de ejecución.

URL de carga de archivos Especifique la función para la URL de carga de archivos.De forma predeterminada, el valor está establecido engetFileUploadUrl.

Extensiones de archivos permitidas Especifique una expresión para enumerar las extensiones dearchivo permitidas.

Extensiones de archivos no permitidas Especifique una expresión para enumerar las extensiones dearchivo no permitidas.

3. En la pestaña Estilo de la vista Propiedades, especifique lo siguiente:

Campo Descripción

Ancho Especifique el ancho del widget Selector de archivos.

Alto Especifique el alto del widget Selector de archivos.

Clase CSS Especifique un nombre de clase para la hoja de estilo en cascada (CSS)que se aplique al widget.











5. En el área Suscribir, estas nuevas propiedades se agregan del modo siguiente:a. Establecer ID de objeto de los archivos que se van a registrarb. Establecer nombres de objeto de los archivos que se van a registrarc. Establecer tipos de objeto de los archivos que se van a registrar




Campo Descripción








Habilitar la selección de objetos1. En la paletaWidgets, arrastre un widget Selector de objetos y suéltelo en el editor de diseño.


Campo Descripción


Etiqueta Escriba una etiqueta para identificar el widget.

Seleccionarmodelo

Seleccione un paquete o un modelo:

• Paquete: seleccione un paquete asociado con el modelo de objetos.

• Modelo: seleccione un modelo de objetos.

Visualización Seleccione un atributo para mostrar en función del modelo de objetos que seleccione.

Valor Seleccione un atributo o escriba una expresión que proporcione los datosque aparecen como el valor seleccionado inicialmente. Por ejemplo,demo_initiate.processPackages.adminpack.id.




Campo Descripción

Permitir laselección deobjetos delrepositorio

Seleccione De una carpeta del repositorio para permitir la selección de un objetodel repositorio en tiempo de ejecución. A continuación, en la lista desplegable,seleccione un flujo de acción rellenado según el paquete o modelo seleccionado.

Permitir laselección dearchivos de launidad local

Seleccione De una carpeta de la unidad local para permitir la selección de unarchivo de la unidad local en tiempo de ejecución.

Seleccione Habilitar arrastrar y soltar para habilitar la acción de arrastrar y soltararchivos en tiempo de ejecución.

A continuación, en la lista desplegable, seleccione un flujo de acción de importación.La lista se rellena en función del paquete o modelo seleccionado para el modelode objetos de contenido. Cuando el archivo se elimina, se desencadena el flujo deacción de importación elegido.

3. En el campo Estilo de la vista Propiedades, especifique un nombre de clase para la hoja de estiloen cascada (CSS) que se aplique al widget.













Campo Descripción




Campo Descripción







Crear una lista de resultados1. En la paletaWidgets, arrastre un widget de lista de resultados y colóquelo en un editor de diseño.

2. En el área Conceptos básicos de la pestaña General de la vista Propiedades, defina la lista deresultados tal y como se describe en la tabla siguiente:

Campo Descripción


Título Escriba el texto que aparecerá en la barra de título por encima de la lista de resultados.Si no desea una barra de título en la lista de resultados, deje este campo en blanco.

Permitir selecciónde varioselementos

Seleccione si el usuario final puede seleccionar varios elementos de la lista deresultados.

Habilitar arrastrary soltar

Seleccione Habilitar arrastrar y soltar para habilitar la acción de arrastrar y soltarcarpetas en tiempo de ejecución.

Deshabilitarnavegaciónpredeterminada

Seleccione para anular el comportamiento predeterminado de la primera columna delwidget de lista de resultados que se representa como un vínculo.



Campo Descripción

Permitircancelación deselección

Seleccione si el usuario final puede anular la selección de las filas seleccionadasmediante Ctrl + clic en tiempo de ejecución.

Mostrar recuentode registros

Seleccione Habilitar para mostrar el número total de registros en tiempo de ejecución.De forma predeterminada, la opción Habilitar no está seleccionada. SeleccioneHabilitar y, a continuación, una de estas opciones para mostrar el recuento deregistros:

• Seleccione automáticamente si el usuario final desea mostrar el recuento deregistros, que está enlazado con una consulta en tiempo real, consulta de textocompleto, consulta de lista de tareas o consulta de alertas.

• A través de la selección de una expresión si el usuario final desea mostrar elrecuento de registros mediante una expresión. Para un proceso sin estado, esla única opción disponible para que el usuario final especifique el recuento deregistros.

3. En el área Datos de la pestaña General de la vista Propiedades, seleccione una instancia delservicio de datos desde la lista desplegable Instancia del servicio de datos. No seleccione unainstancia de servicio de datos que devuelva un solo objeto como salida.

El sistema configura el servicio de datos para que devuelva resultados paginados. No utilice lamisma instancia de servicio de datos que para un widget de lista desplegable, ya que este últimosobrescribe el conjunto de tamaño de página para la lista de resultados.

Si la entrada del servicio de datos es un widget de casilla de verificación y esta no está activadaen tiempo de ejecución, el valor del atributo no se considera falso y se devuelven las instanciasen las que el atributo es verdadero.

En un proceso sin estado, el sistema no devuelve resultados paginados.4. En el cuadro de diálogo Conectar con interacción, haga clic en Aceptar.

Configurar un widget Lista de resultados1. Mantenga el ratón sobre un borde exterior o la barra de título del widget Lista de resultados

y haga clic para seleccionar todo el widget.2. En el área Conceptos básicos de la pestaña General de la vista Propiedades, defina la lista de

resultados tal y como se describe en la tabla siguiente:

Campo Descripción


Título Escriba el texto que aparecerá en la barra de título por encima de la listade resultados. Si no desea una barra de título en la lista de resultados, dejeeste campo en blanco.

Permitir selección de varioselementos

Permite seleccionar varias filas y eliminarlas mediante el menú contextual.

Habilitar arrastrar y soltar Permite arrastrar y soltar un archivo en una carpeta de una lista deresultados, con lo cual se invoca el flujo de acción de importación.

Deshabilitar navegaciónpredeterminada

Deshabilita el vínculo a la página y la exploración de esta.



Campo Descripción

Permitir cancelación deselección

Permite la selección de una fila seleccionada.

Seleccionarautomáticamente la primerafila de la cuadrícula

Selecciona la primera fila de la cuadrícula de forma predeterminada.

Conservar los cambiosen tiempo de ejecución

En el tiempo de ejecución, el sistema restaura los cambios realizados en laspropiedades de la lista de resultados y conserva esos cambios. Por ejemplo,ocultar, mover, cambiar el tamaño y ordenar.

Mostrar recuento deregistros

Realice alguno de los procedimientos siguientes:

• Habilitar: cuando la opción de mostrar el número de registros estáhabilitada, es posible hacer lo siguiente:

– Mostrar detalles del número de registros (por ejemplo, mostrar 1: 10de 25)

– Ir a la primera página

– Ir a la página anterior

– Ira al número de página indicado por el usuario final

– Ir a la página siguiente

– Ir a la última página

– Utilizar la lista desplegable para cambiar el número de resultados quese deben mostrar por página

• Deshabilitar: cuando la opción de visualizar el número de registros estádeshabilitada, es posible hacer lo siguiente:

– Ir a la primera página

– Ir a la página anterior

– Ir a la página siguiente

– Utilizar la lista desplegable para cambiar el número de resultados quese deben mostrar por página

Mostrar recuento deregistros: automático omediante una expresión

Automático: el sistema utiliza el número de registros proporcionado porel servicio de datos enlazado a la lista de resultados. Esta opción se puedeutilizar cuando se emplea Habilitar recuento de visitas en un servicio dedatos como la consulta en tiempo real. Esta es la opción predeterminada.

Mediante expresión: escriba una expresión para determinar el número deregistros, que se utiliza en la lista de resultados en el tiempo de ejecución,independientemente de la cantidad real de registros devueltos por elservicio de datos.

3. En el área Datos, defina la columna tal y como se describe en la tabla siguiente:



Campo Descripción

Permitir la ediciónen línea

Seleccione la opción en caso de que desee permitir al usuario editar los valores delas celdas en la lista de resultados. Esto también permite agregar, eliminar y subiry bajar filas.

Si el widget Lista de resultados se adjunta a orígenes de datos que devuelvenrecuentos de resultados como RTQ, TLQ, FTQ y HDS, utilice la opción Automático.Para los orígenes de datos que no pueden devolver un recuento de resultados comoProceso sin estado, use el editor de expresiones y agregue otra variable de salidapara devolver el recuento de resultados; después, vincule la variable de salida a laexpresión de recuento de resultados en el widget.

Origen de datos Mediante el selector de un solo modelo, seleccione la instancia del servicio de datoso el parámetro de sesión de tipo de modelo multivalor para enlazar a la lista deresultados. Si la instancia del servicio de datos que desea seleccionar no existe,agréguela desde el panel Interacciones del editor de diseño.

4. En la pestaña Estilo del área Diseño, especifique el número de filas que deben aparecer en cadapágina. Cuando se invoca el servicio de datos, este recupera este número de resultados y losmuestra en la página.

Si utiliza la misma interacción para la lista de resultados que para un widget de lista desplegable,este último sobrescribe el conjunto de tamaño de página para la lista de resultados.

Para un proceso sin estado, el sistema no devuelve resultados paginados independientemente delvalor especificado aquí. Para que la paginación funcione con un proceso sin estado, consulteProceso sin estado, página 110.

Asegúrese de que el tamaño máximo de resultados del servicio de consulta vinculado sea mayoro igual que la cantidad de filas del widget Lista de resultados. De lo contrario, el sistema utilizalímite predeterminado del servicio de consultas vinculado.

Widget Lista deresultados: númerode fila

Tamaño máximo deresultados del serviciode consulta enlazado

Valor real del tamañomáximo de resultados

Resultados en tiempode ejecución

100 –1 1,000 100

1,000 –1 1,000 1,000

2,000 –1 1,000 1,000

10 100 100 10

100 100 100 100

200 100 100 100

1,000 10,000 10,000 1,000

10,000 10,000 10,000 10,000

20,,000 10,000 10,000 10,000

5. En la pestaña Estilo del área Diseño, especifique estas propiedades tal y como se describe en latabla siguiente:



Propiedad Descripción

Lista de tamaños de página disponibles Define una serie de tamaños de páginas que puedencontener la cantidad definida de registros porpágina. Es posible definir varios valores, expresadoscomo valores separados por comas. Esta lista detamaños de página se muestra al usuario como lalista desplegable en el tiempo de ejecución, y sepuede usar para cambiar el número de registros porpágina de forma dinámica.

6. En la pestaña Estilo del área Formato, especifique un nombre de clase para la hoja de estilo encascada (CSS) que se aplique al widget.











Configurar columnas en una lista de resultadosEste procedimiento se aplica a la Lista de resultados.1. Coloque el cursor dentro de una columna y haga clic para seleccionarlo.2. En el área Columna de la pestaña General en la vista Propiedades, defina la columna tal y como


Campo Descripción

ID Escriba un ID para la columna del widget.

Etiqueta Escriba la etiqueta que aparecerá en el encabezado de columna.



Campo Descripción


Escriba un mensaje de información sobre herramienta para el encabezado de lacolumna.

Ancho Escriba el ancho de columna predeterminado en píxeles.

Si tiene muchas columnas, aparece una barra de desplazamiento horizontal en eltiempo de ejecución. Establezca un valor para el ancho de la última columna a fin deasegurarse de que se muestre completamente cuando se desplace el usuario final.

3. En el área Datos, defina la columna tal y como se describe en la tabla siguiente:

Campo Descripción

Valor Especifique el valor que se va a mostrar en las celdas de la columna. Puedeseleccionar el atributo de datos para vincular con la columna.

Tipo de datos Seleccione el tipo de datos. El tipo de datos proporciona validación para el valor enel editor de expresiones (que se basa en el tipo de datos) y determina los controles devisualización disponibles para el formato del valor de la columna.

Utilice la función htmlEncode en los widgets de visualización para evitarvulnerabilidades de secuencias a través de sitios cuando se utilizan valoresintroducidos por el usuario final como parte de una expresión de HTML. El sistemaautomáticamente codifica las expresiones de cadena.

Visualización (Opcional) Esto se puede utilizar para mostrar contenido personalizado dentro dela columna en lugar del valor real devuelto por el servicio de datos. También sepuede usar para mostrar un valor derivado que utilice varios atributos de salida delservicio de datos.

Para escribir una expresión, introduzca la expresión en el campo Visualización.

Ejemplo: la siguiente expresión muestra una columna Nombre de cliente en elformato Apellido, Nombre:

Outputs.last_name+’, ’+

Outputs.first_name

Para crear esta expresión:

• Utilice el selector para obtener Outputs.last_name.

• Escriba: +’,’+

• Utilice el selector para obtener Outputs.first_name.

Note: Al configurar la Lista de resultados, es posible especificar el valor y laexpresión en tiempo de diseño. En el tiempo de ejecución, al presentar la columna, laexpresión tiene prioridad sobre el valor.

Origen de imagen Al seleccionar el tipo de datos de imagen, especifique el origen de la imagen. Lasopciones disponibles son:

• Estático: navegue a una imagen estática integrada y selecciónela. Estaes la configuración predeterminada.

• Expresión: mediante el selector, especifique una expresión que definaqué imagen debe aparecer en el tiempo de ejecución.



Campo Descripción

Página En el tiempo de ejecución, al hacer clic en la imagen, el sistema redirige a cualquierade las siguientes acciones:

• Ninguno: no va a ninguna página. Esta es la configuración predeterminada.

• Estático: navegue a una página estática fija y selecciónela para ir a ella en eltiempo de ejecución. Especifique una expresión de ID de objeto, que se resuelveen un ID de objeto existente. El ID de objeto es aplicable a la página de instanciasolamente. Para una página de aplicación, no se requiere ningún ID de objeto.

• Expresión: especifique una expresión que defina qué página aparece en el tiempode ejecución. Especifique una expresión de ID de objeto, que se resuelve en un IDde objeto existente. El ID de objeto es aplicable a la página de instancia solamente.Para una página de aplicación, no se requiere ningún ID de objeto.

• URL: escriba una expresión que constituya la URL que define qué página debeaparecer en el tiempo de ejecución. Las direcciones URL pueden incluir http, httpso ftp. Si no se especifica ningún identificador de protocolo, el sistema asume quese trata del protocolo http de forma predeterminada.

Abrir el destino enuna pestaña nueva


• Destino: especifique el destino que identifica la pestaña de la páginade destino.

• Parámetros de URL: especifique cadenas de consulta parametrizadaspara la URL incluyéndolas en una URL de página.

Tiene variosvalores

Seleccione si se habilitan varios valores.

Pantalla multivalor Seleccione la preferencia para la apariencia de varios valores:

• Nueva línea para cada valor: cada valor aparece en una línea diferente.

• Una sola línea con separador: seleccione un separador que aparecerá entre losvalores.

Este campo está deshabilitado si el atributo no tiene varios valores.

Separador Seleccione el separador que vaya a aparecer entre los valores que aparecen en unasola línea.

Formato Especificar el modo en que el valor aparece en esta columna cuando se utilizala aplicación.

Los controles para el formato varían con el tipo de datos seleccionado en campoTipo de datos.

4. En el área Opciones en tiempo de ejecución de la pestaña General en la vista Propiedades,defina la columna tal y como se describe en la tabla siguiente:

Campo Descripción

Se puede utilizarpara ordenar

Seleccione esta opción para indicar que la columna se puede ordenar en el tiempode ejecución. De forma predeterminada, esta opción está deshabilitada cuando estáhabilitada la opción Permitir la edición en línea. La propiedad Valor determina quéatributo de salida del servicio de datos se utiliza para la ordenación. Si ese atributode salida no es compatible con la ordenación en el servicio de datos (por ejemplo,una consulta en tiempo real), esta opción está deshabilitada.



Campo Descripción

Se puede ocultar Seleccione esta opción para indicar que el usuario puede ocultar la columna en eltiempo de ejecución.

Se puede cambiarde tamaño

Seleccione esta opción para indicar que el usuario puede cambiar el tamaño de lacolumna en el tiempo de ejecución.

Se puede cambiarde posición

Seleccione esta opción para indicar que la columna puede cambiar de posición enel tiempo de ejecución.

5. En el área Edición de la pestaña General en la vista Propiedades, defina la columna tal y como sedescribe en la tabla siguiente:

Campo Descripción

Tipo de editor Según el tipo de datos y el valor Tiene varios valores de la columna, el Tipo deeditor se selecciona automáticamente. Este valor de Tipo de editor disponible sepuede cambiar por las opciones de la lista.

Según el tipo de datos y el valor de Tiene varios valores para una columna, las opcionesdisponibles de tipo de editor para usar de inmediato son las siguientes:

Tipo de datos Tipo de editor

Cadena Seleccione una de las siguientes opciones:

• Entrada de texto

• Área de texto

• Visualización del valor

• Lista desplegableEntero Seleccione una de las siguientes opciones:

• Entrada de números


• Lista desplegable

Flotante Seleccione una de las siguientes opciones:

• Entrada de números



Fecha-hora Seleccione una de las siguientes opciones:

• Visualización del valor de entrada de fecha yhora

Booleano Seleccione una de las siguientes opciones:

• Casilla de verificación





Tipo de datos Tipo de editor

Imagen Seleccione una de las siguientes opciones:

• Entrada de texto

• Área de texto



Lista desplegable Para una lista de selección, el tipo de editor es unalista desplegable que vincula el origen de datos conla lista desplegable real.

Valores múltiples de cadena de caracteres (valoresrepetidos)

Seleccione una de las siguientes opciones:

• Entrada multivalor de texto


• Selección múltiple de lista desplegable

Valores múltiples enteros (valores repetidos) Seleccione una de las siguientes opciones:

• Entrada multivalor de número



Valores múltiples flotantes (valores repetidos) Seleccione una de las siguientes opciones:

• Entrada multivalor de número



Valores múltiples de fecha (valores repetidos) Visualización de valores en entrada de valoresmúltiples de fecha y hora

6. Suscríbase a los eventos de IU en la pestaña Comportamiento.






Dar formato a una columna de enteros

Si selecciona Entero, utilice los siguientes controles de visualización para dar formato al valor dela columna:



Campo Descripción

Estilo de número Seleccione el estilo para el número.

Utilizar separadorde miles

Seleccione esta casilla de verificación si el número debe mostrar un separador cadatres dígitos.

Estilo del separador Seleccione un estilo para el separador. Este campo se habilita si el campo Decimales seconfigura como mayor que 0 o el campo Use thousand separator (Utilizar separadorde miles) está seleccionado. Este campo se deshabilita si el campo Decimales seconfigura como 0 y el campo Use thousand separator (Utilizar separador de miles) noestá seleccionado.

Si selecciona Utilizar configuración regional, la configuración regional en tiempo deejecución del explorador se utiliza para determinar el estilo del separador.

Números negativos Seleccione el formato para mostrar números negativos.

Dar formato a una columna flotante

Si selecciona Flotante, utilice los siguientes controles de visualización para dar formato al valorde la columna:

Campo Descripción

Estilo de número Seleccione el estilo para el número.

Decimales Establezca el número de decimales que se debe mostrar.

Utilizar separadorde miles

Seleccione esta casilla de verificación si el número debe mostrar un separador cadatres dígitos.

Estilo del separador Seleccione un estilo para el separador. Este campo se habilita si el campo Decimales seconfigura como mayor que 0 o el campo Use thousand separator (Utilizar separadorde miles) está seleccionado. Este campo se deshabilita si el campo Decimales seconfigura como 0 y el campo Use thousand separator (Utilizar separador de miles) noestá seleccionado.

Si selecciona Utilizar configuración regional, la configuración regional en tiempo deejecución del explorador se utiliza para determinar el estilo del separador.

Números negativos Seleccione el formato para mostrar números negativos.

Dar formato a una columna de hora y fecha

Si selecciona el tipo de datos como Hora y fecha, utilice los siguientes controles de visualización paradar formato al valor de la columna:



Campo Descripción

Estilo de fecha El estilo de fecha determina si la fecha almacenada se convierte o no a la hora local.

• Solo fecha: la fecha se convierte de la hora universal coordinada (UTC) a la horalocal.

Por ejemplo, si un usuario final en la ciudad de Nueva York introduce la hora y fechadel 4 de febrero de 2012, el sistema muestra la hora y fecha a un usuario final en SanFrancisco como 3 de febrero de 2012. La fecha se almacena como 4 de febrero de2012, 12:00 AM, y el sistema lo convierte a la hora local del 3 de febrero de 2012,9:00 PM.

• Fecha del historial: la fecha no se convierte a partir de la hora universal coordinada(UTC). Utilice esta opción para asegurarse de que la fecha almacenada aparece comoun valor absoluto en todas las zonas horarias y no se convierte (por ejemplo, fechascomo cumpleaños y aniversarios).

Por ejemplo, si un usuario final en la ciudad de Nueva York introduce la hora y fechadel 4 de febrero de 2012, el sistema muestra la hora y fecha a un usuario final en SanFrancisco como 4 de febrero de 2012. La fecha se almacena como 4 de febrero de2012, 12:00 AM, y no se convierte a la hora local.

• Hora y fecha: la fecha se convierte de la hora universal coordinada (UTC) en lahora local.

Por ejemplo, si un usuario final en la ciudad de Nueva York introduce la hora y fechadel 4 de febrero de 2012, 2:00 AM, el sistema muestra la hora y fecha a un usuariofinal en San Francisco como 3 de febrero de 2012, 11:00 PM.

Formato de fecha Seleccione el formato para la fecha.

Si selecciona el formato corto con un año de dos dígitos, entonces 00–50 indica los años2000–2050, mientras que 51–99 indica 1951–1999. Utilice el formato de cuatro dígitos,no local y que distingue entre mayúsculas y minúsculas para evitar este problema.

Formato de hora Seleccione el formato para la hora.

Agregar una columna a una lista de resultados1. Haga clic con el botón derecho en una columna y seleccione Insertar columna antes de o

Insertar columna después de.2. Configure las propiedades de columna.

Eliminar una columna de una lista de resultados1. Haga clic con el botón secundario en la columna que se va a eliminar.2. Seleccione Eliminar.

Mostrar una lista de relaciones1. Cree una página Vista para un objeto de negocio (ejemplo: vista de cliente).2. Agregue una lista de resultados a la página:



a. Arrastre un widget Lista de resultados y suéltelo en un editor de diseño.b. Seleccione Utilizar un servicio de datos existente y haga clic en Siguiente.c. Seleccione un servicio de datos que devuelve relaciones (por ejemplo: Garantía garantizada)

y haga clic en Siguiente.d. Seleccione los atributos que se van a utilizar como columnas, especifique su orden y haga

clic en Finalizar.3. Guarde la página y agréguela como un enlace a un menú de navegación.4. Guarde y ejecute la aplicación.5. Desplácese a la página de visualización del objeto de negocio.

Configurar el widget Visualización de errores1. En la paletaWidgets, arrastre y suelte un widget Visualización de errores en el editor de diseño.2. En la pestaña General, configure lo siguiente:

a. En el área Aspectos básicos, escriba lo siguiente tal como se describe en la tabla siguiente.

Campo Descripción

ID ID del widget.

Título Título que aparecerá en la barra de título en tiempo de ejecución.

b. En el área Visualización de errores del cuadro de diálogo Selector de widgets, haga clic paraagregar widgets o interacciones para enlazar con el widget Visualización de errores.

• Seleccione Mostrar errores en campos intactos para mostrar los mensajes de errorcorrespondientes a campos intacto, a los que no se ha navegado ni visitado. Por ejemplo,un error que indica que el campo es obligatorio justo después de cargar la página, es unerror en un campo intacto.

• Seleccione Deshabilitar la visualización automática en caso de errores para que el widgetVisualización de errores no se haga visible en cuanto detecte errores de validación.

3. En la pestaña Estilo, configure el widget como se describe en la tabla siguiente:

Campo Descripción

Márgenes Escriba los valores para los márgenes: Parte superior, Parte inferior Derecha yIzquierda alrededor del widget.

Ancho Especifique el ancho del widget en píxeles. De forma predeterminada, la opciónAutomático está seleccionada.

Alto Especifique la altura del widget en píxeles. De forma predeterminada, la opciónAutomático está seleccionada.













Durante el tiempo de ejecución, el sistema muestra todos los mensajes de validación en el widgetVisualización de errores.

Configurar un campo de texto enriquecido1. En la paletaWidgets, arrastre un widget Texto enriquecido y suéltelo en un editor de diseño.2. En el campo ID de la pestaña General en la vista Propiedades, escriba un ID para el widget.3. En el campo Valor, escriba el texto que desea que aparezca en el cuadro de texto de widget.4. Publique eventos de IU o suscríbase a estos en la pestaña Comportamiento.













Configurar un widget de visualización de valores1. En la paletaWidgets, arrastre un widget Visualización del valor y suéltelo en un editor de diseño.

2. En el área Conceptos básicos de la pestaña General de la vista Propiedades, configure laspropiedades del widget tal y como se describe en la tabla siguiente:

Campo Descripción


Etiqueta Escriba una etiqueta para identificar el widget de visualización del valor.

Una vez enlazada, la etiqueta predefinida será la etiqueta del atributo. Puede cambiarla etiqueta del widget, pero el valor se obtiene desde el valor real del atributo cuandoel widget aparece en tiempo de ejecución.NotaSi no proporciona ninguna etiqueta para el widget, el sistema muestra un título(Sin título) para el widget en texto atenuado para identificar la ubicación del widgeten el Editor de página.En tiempo de ejecución, no se muestra ninguna etiqueta.

3. En el área Valor de la pestaña General en la vista Propiedades, configure el valor que aparecetal y como se describe en la tabla siguiente:

Campo Descripción

Valor Especifique el valor que se va a aparecer.

• Para seleccionar un widget o atributo de datos:

– Borre el campo de Valor (editor de expresiones).

– Haga clic en Seleccionar junto al editor de expresiones.

– En el cuadro de diálogo Selector, seleccione el widget o atributo de datos paraenlazarlo con el widget de visualización de valor y haga clic en Aceptar.

Si selecciona un widget de cuadrícula de resultados, el valor que se muestraderiva de la fila seleccionada.

• Para escribir una expresión, escriba la expresión en el campo Valor.

De forma predeterminada, el sistema evalúa el valor de la expresión y lo rellena.En tiempo de ejecución, cada vez que cambia el valor de la expresión, el sistemavuelve a evaluar y asignar el valor actualizado de nuevo.


El tipo de datos determina los controles de visualización disponibles para darformato al widget.

Utilice la función htmlEncode en los widgets de visualización para evitarvulnerabilidades de secuencias a través de sitios cuando se utilizan valoresintroducidos por el usuario final como parte de una expresión de HTML. El sistemaautomáticamente codifica las expresiones de cadena.

Deshabilitar laredistribución deimágenes en deHTML

Para un tipo de datos HTML, al especificar una etiqueta <IMG> en la expresión devalor con esta casilla de verificación seleccionada, se ve afectado el rendimiento delsistema. En tiempo de ejecución, el sistema establece el diseño de la imagen denuevo para corregir la anchura y altura de la imagen.

Tiene variosvalores

Seleccione si se habilitan varios valores.



Campo Descripción

Pantalla multivalor Seleccione la preferencia para la apariencia de varios valores:

• Nueva línea para cada valor: cada valor aparece en una línea diferente.

• Una sola línea con separador: seleccione un separador que aparecerá entre losvalores.

Este campo está deshabilitado si el atributo no tiene varios valores.

Separador Seleccione el separador que vaya a aparecer entre los valores que aparecen en unasola línea.












Enlazar campos a datos1. Seleccione un widget en un editor de diseño.

2. En la pestaña General de la vista Propiedades, haga clic en Seleccionar junto al campo Valorinicial.

El panel superior del cuadro de diálogo Selector muestra el objeto de negocio (por ejemplo,Cliente) y los elementos de los datos globales, como el nombre de la aplicación y el usuario actual.

3. En el área inferior, seleccione el atributo de datos de contexto que se va a enlazar al campo (porejemplo, Código postal).




Configurar un widget de vista de carpeta1. En la paletaWidgets, arrastre y suelte un widget Vista de carpeta en el editor de diseño.2. En la pestaña General de la vista Propiedades, especifique los valores tal y como se describe


Campo Descripción

Título Escriba un título para identificar el widget de vista de carpeta.


Escriba información sobre herramientas para el widget.

Ocultar panel decontenido

Seleccione esta opción para borrar el área de contenido del panel derecho.

Habilitar arrastrary soltar

Seleccione Habilitar arrastrar y soltar para habilitar la acción de arrastrar y soltarcarpetas en tiempo de ejecución.

Raíz Seleccione la carpeta.

Mostrar archivos anivel de raíz

Seleccione si solo aparecen carpetas o carpetas y archivos en la carpeta raíz.

El usuario final debe seleccionar un nodo para mostrar su contenido.

Mostrar solocarpetas

Seleccione esta opción para mostrar solo las carpetas y no los archivos.

Mostrar objetosocultos

Seleccione esta opción para mostrar los objetos ocultos.

Ruta de carpeta oID de carpeta raíz

Seleccione si la carpeta raíz se identifica por su ID de objeto o su ruta de acceso.

Ruta de nodoo ID de nodoseleccionado

Especifique el nodo en el que se selecciona el árbol. Proporcione el nodo comoID o ruta mediante el editor de expresiones. Dependiendo de la expresión puedeseleccionar el ID de nodo o la ruta.

3. En la pestaña Estilo en la vista Propiedades:

1. Configure la apariencia del widget.2. Especifique un nombre de clase para la hoja de estilo en cascada (CSS) que se aplique al widget.













Configurar un widget de visor1. En la paletaWidgets, arrastre un widget Visor y suéltelo en un editor de diseño.

2. En la pestaña General de la vista Propiedades, configure el widget tal y como se describe en latabla siguiente:

Campo Descripción


Título Escriba el texto que aparece en la barra de título por encima del widget Visor.

Mostrar nombre dedocumento como título

Muestra el nombre del documento en la barra de título del visor.

Visor preferido Utilizando el selector, especifique una expresión que defina qué visor debeaparecer en tiempo de ejecución.

Si no existe un visor específico en su equipo local, o si se accede a un formatoincompatible mediante el visor, el sistema asume, de forma predeterminada,el visor asignado en la configuración Viewer y formatos para el formatoen cuestión.

Mostrar barra deherramientas demodificación dedocumento

Muestra la barra de herramientas de modificación de documentos para losusuarios con permisos apropiados.

Mostrar navegador enminiatura

Muestra el navegador en miniatura a los usuarios finales.

Para obtener un mejor rendimiento del sistema, no muestre las miniaturas,por ejemplo, cuando el usuario final vea documentos que sean, sobre todo,de texto.

Si no se muestran las miniaturas, se deshabilitará la modificación dedocumentos y el usuario solo podrá ver los documentos, pero no realizarcambios en ellos.

Permitir impresión Permite a los usuarios finales imprimir.

Mostrar anotaciones Muestra las anotaciones para todos los usuarios finales.

Permitir modificación deanotaciones

Permite a los usuarios finales modificar las anotaciones.



Campo Descripción

ID de objeto Identifica el origen del ID de objeto del contenido que aparece.

Haga clic en Seleccionar para especificar el valor de otro widget o elcontexto de la página como el origen del ID de objeto.

Tipo de contenido Identifica el origen del tipo del contenido que aparece. El tipo de contenidodetermina el visor que el sistema invoca en tiempo de ejecución.

Haga clic en Seleccionar para especificar el valor de otro widget o elcontexto de la página como el origen del tipo de contenido.

El sistema es flexible y permite configurar cualquier reproducción delcontenido. Aparte de la fuente principal de contenido, se puede especificarcualquier reproducción del contenido disponible en el sistema. Si no hayninguna reproducción disponible para el contenido, el sistema regresa alorigen principal del objeto.

Por ejemplo, para un documento en formato PDF, si también existe unareproducción en forma de imagen disponible, puede configurarla en el campoTipo de contenido. Si el visor de imágenes no está disponible, el sistemaregresa al visor predeterminado y abre el documento PDF en la aplicaciónAcrobat Reader.

3. En la pestaña Estilo, especifique la anchura y la altura del widget en píxeles.

Puede establecer el ancho Automático para que este coincida con el del contenedor.4. Suscríbase a los eventos de IU en la pestaña Comportamiento.






Configurar la apariencia de una imagen1. En la paletaWidgets, arrastre y suelte un widget Imagen en el editor de diseño.2. En el área Conceptos básicos de la pestaña General en la vista Propiedades, especifique los

valores tal y como se describe en la tabla siguiente:

Campo Descripción


Texto alternativo Escriba el texto que aparece si la imagen no aparece.



Campo Descripción

Origen de imagen Haga clic en Seleccionar y localice la imagen en la Biblioteca de recursos.


Escriba información sobre herramientas para el widget.

3. En el área Enlaces, especifique los valores tal y como se describe en la tabla siguiente:

Campo Descripción






URL Escriba una expresión para constituya la URL que define qué página debe apareceren tiempo de ejecución. Las direcciones URL pueden incluir http, https o ftp. Si nose especifica ningún identificador de protocolo, el sistema asume que se trata delprotocolo http de forma predeterminada.






4. En la pestaña Estilo, haga lo siguiente:a. En el área Diseño, especifique el ancho y alto de la imagen.b. En el área Formato, especifique un nombre de clase para la hoja de estilo en cascada (CSS)

que se aplique al widget.5. Suscríbase a los eventos de IU en la pestaña Comportamiento.








Configurar un menú de acción1. En la paletaWidgets, arrastre y suelte unMenú de acción en un editor de diseño.

2. En la pestaña General en la vista Propiedades, configure el menú de acción tal y como se describeen la tabla siguiente:

Campo Descripción


Etiqueta Escriba una etiqueta para identificar el menú de acción.

3. En la pestaña Estilo, especifique un nombre de clase para la hoja de estilo en cascada (CSS) quese aplique al widget.














Editar una interacción1. Haga clic en una interacción.

2. En el área Conceptos básicos de la pestaña General de la vista Propiedades, defina la interaccióntal y como se describe en la siguiente tabla:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar la interacción.

Interacción Muestra la etiqueta de una interacción en la que se basa la instancia.

Devuelve Muestra el tipo devuelto por la interacción.

Actualizar Seleccione una, ambas o ninguna de las opciones para especificar cuándo se llama ala interacción.

Siempre se llama a la interacción por medio de un botón configurado para tal fin,con independencia de esta selección.

Recuperarmetadatos depermisos

Seleccione esta opción para extraer la información relacionada con los metadatosde permisos. Como práctica recomendada, utilice su criterio para seleccionaresta opción, ya que se trata de una actividad que afecta al rendimiento de formaimportante. Si no está seleccionada, la información relacionada con los metadatosde permisos está disponible bajo petición en tiempo de ejecución. Esto solo esaplicable a la consulta en tiempo real.

3. En el áreaMensajes personalizados, puede definir los mensajes personalizados para el éxito oerror mediante el editor de expresiones. Seleccione Deshabilitar mensaje de error estándar paradeshabilitar los mensajes de error estándar para el servicio de datos. Debe vincular estos mensajesde error personalizados al widget Visualización de errores. Si se han especificado mensajespersonalizados (éxito o error), el sistema muestra los mensajes de éxito o de error estándar.

4. En la pestaña Entradas de la vista Propiedades, seleccione la fila de la entrada que se va a editar.

5. Modifique el elemento asignado a la entrada escribiendo una nueva expresión en el editor deexpresiones o haga clic en Seleccionar y elija el elemento de datos de contexto. Si la interaccióntiene una entrada de ID, la expresión asignada devuelve un valor de ID en tiempo de ejecución. Porejemplo, la expresión aparecería como model .id.

Si se deja una entrada en blanco, no se transfieren datos de esa entrada cuando se invoca lainteracción.















Campo Descripción








Configurar un gráfico de columna y de línea1. En el navegador Interfaz de usuario, abra o cree una página.

2. En el área Interacciones del editor de diseño, haga clic en Nueva interacción.

3. En el cuadro de diálogo Seleccionar interacción, seleccione la interacción con la que deseaenlazar el gráfico y haga clic en Finalizar. No seleccione un interacción que devuelva un soloobjeto como salida.

4. En la paletaWidgets, arrastre y suelte un Gráfico de columnas en el editor de diseño.

5. En la ficha General de la vista Propiedades, especifique las propiedades de gráfico tal y como sedescribe en la tabla siguiente:

Campo Descripción

ID Escriba un ID para el widget de gráfico.



Campo Descripción


Instancia del servicio de datos Seleccione la instancia de servicio de datos a la que desea enlazarel gráfico y haga clic en Aceptar. No seleccione una instancia deservicio de datos que devuelva un solo objeto como salida.

6. En la ficha Categorías, haga lo siguiente:a. Seleccione la categoría que desea utilizar como el eje X en el gráfico.

Una categoría se selecciona en las columnas de tipo de cadena, fecha y booleana.

El sistema se limita los valores del eje X a 10 caracteres.b. En el campo Etiqueta de eje de la categoría seleccionada, escriba una etiqueta.c. En el área Formato, especifique el modo en que el eje X aparece en el gráfico.

El área Formato solo aparece para los campos de fecha y hora. Al seleccionar Fecha delhistorial, el usuario final ve un valor de fecha y hora universal coordinada (UTC). El sistemano convierte los valores de UTC a la zona horaria local.

d. Para agregar una categoría, haga clic en Agregar .7. En la ficha Valores, haga lo siguiente:

a. En el campo Etiqueta de eje Y, escriba una etiqueta de eje.b. Seleccione los valores que desea que aparezcan en el gráfico.

La lista de valores contiene columnas numéricas o de tipo entero.c. En el campo Etiqueta para el valor seleccionado, escriba una etiqueta que aparezca para el

valor en la leyenda.d. En el cuadro de diálogo Tipo del valor seleccionado, seleccione el tipo de gráfico.e. Seleccione la fila de un valor para aplicarle un formato.f. En el área Formato, especifique el modo en que el valor aparece en el gráfico.g. Para agregar un valor, haga clic en Agregar.

8. En la ficha Visualización predeterminada, en el área Visualización, seleccione las propiedadesde gráfico predeterminadas tal y como se describe en la tabla siguiente:

Campo Descripción

Granularidad de tiempo Seleccione una granularidad de tiempo y el filtro de tiempo relativo.

Orden predeterminado Seleccione una columna y la dirección de ordenación.

Leyenda de gráfico Muestre u oculte la leyenda del gráfico.

Estilo del gráfico de columnas Muestre el gráfico como apilado o agrupado.

9. En la pestaña Estilo, configure lo siguiente:

Campo Descripción

Ancho Especifique el ancho del gráfico en píxeles. El valor predeterminadoes 500 píxeles y el valor mínimo es 400 píxeles.

Alto Especifique la altura del gráfico en píxeles. El valor predeterminadoes 350 píxeles.

10. Para agregar una línea horizontal, en el área Líneas, haga clic en Agregar y configure la líneatal y como se describe en la tabla siguiente:



Campo Descripción

Valor Escriba un valor. Aparece la línea horizontal para el valor introducido.

Etiqueta Escriba una etiqueta. La etiqueta aparece en la leyenda.

Color Seleccione un color de línea.

Puede configurar una línea horizontal para comparar los valores del gráfico con un estándar (porejemplo, SLA). En tiempo de ejecución, la línea SLA no se muestra en el gráfico de columnascuando hay una sola instancia en el gráfico.

Configurar un gráfico de barras1. En el navegador Interfaz de usuario, abra o cree una página.2. En el área Interacciones del editor de diseño, haga clic en Nueva interacción.3. En el cuadro de diálogo Seleccionar interacción, seleccione la interacción con la que desea

enlazar el gráfico y haga clic en Finalizar. No seleccione un interacción que devuelva un soloobjeto como salida.

4. En la paletaWidgets, arrastre un widget Gráfico de barras y suéltelo en el editor de diseño.5. En la ficha General de la vista Propiedades, especifique las propiedades de gráfico tal y como se


Campo Descripción




6. En la ficha Categorías, haga lo siguiente:a. Seleccione la categoría que desea utilizar como el eje X en el gráfico.

Una categoría se selecciona en las columnas de tipo de cadena, fecha y booleana.

El sistema se limita los valores del eje X a 10 caracteres.b. En el campo Etiqueta de eje de la categoría seleccionada, escriba una etiqueta.c. En el área Formato, especifique el modo en que el eje X aparece en el gráfico.

El área Formato solo aparece para los campos de fecha y hora. Al seleccionar Fecha delhistorial, el usuario final ve un valor de fecha y hora universal coordinada (UTC). El sistemano convierte los valores de UTC a la zona horaria local.

d. Para agregar una categoría, haga clic en Agregar .7. En la ficha Valores, haga lo siguiente:

a. En el campo Etiqueta de valores de gráfico, escriba una etiqueta de eje.b. Seleccione los valores que desea que aparezcan en el gráfico.

La lista de valores contiene columnas numéricas o de tipo entero.c. En el campo Etiqueta para el valor seleccionado, escriba una etiqueta que aparezca para el

valor en la leyenda.



d. Seleccione la fila de un valor para aplicarle un formato.e. En el área Formato, especifique el modo en que el valor aparece en el gráfico.f. Para agregar un valor, haga clic en Agregar.

8. En la ficha Visualización predeterminada, en el área Visualización, seleccione las propiedadesde gráfico predeterminadas tal y como se describe en la tabla siguiente:

Campo Descripción

Granularidad de tiempo Seleccione una granularidad de tiempo y el filtro de tiempo relativo.



Estilo de gráfico de barras Muestre el gráfico como apilado o agrupado.


Campo Descripción



Configurar un gráfico circular o de donut1. En el navegador Interfaz de usuario, abra o cree una página.2. En el área Interacciones del editor de diseño, haga clic en Nueva interacción.3. En el cuadro de diálogo Seleccionar interacción, seleccione la interacción con la que desea


4. En la paletaWidgets, arrastre un widget Gráfico circular y suéltelo en un editor de diseño.5. En la pestaña General de la vista Propiedades, especifique las propiedades de gráfico tal y como


Campo Descripción




6. En la ficha Categorías, haga lo siguiente:a. Seleccione la categoría que aparecerá en el gráfico.

Las categorías incluyen columnas de tipo de cadena, fecha y booleanas.

El sistema se limita los valores del eje X a 10 caracteres.

El área Formato solo aparece para los campos de fecha y hora. Al seleccionar Fecha delhistorial, el usuario final ve un valor de fecha y hora UTC. El sistema no convierte los valoresde UTC a la zona horaria local.



b. Para agregar una categoría, haga clic en Agregar .7. En la ficha Valores, haga lo siguiente:

a. Seleccione los valores que desea que aparezcan en el gráfico.

Cada valor crea un gráfico circular o un gráfico de donut independiente en el mismo widgetde gráfico.

b. En el campo Etiqueta para el valor seleccionado, escriba una etiqueta que aparezca para elvalor en la leyenda.

c. En el cuadro de diálogo Tipo del valor seleccionado, seleccione el tipo de gráfico.d. Seleccione la fila de un valor para aplicarle un formato.e. En el área Formato, especifique el modo en que el valor aparece en el gráfico.f. Para agregar un valor, haga clic en Agregar.

8. En la pestaña Visualización predeterminada, seleccione las propiedades de gráficopredeterminadas tal y como se describen en la tabla siguiente:

Campo Descripción

Granularidad de tiempo Seleccione una granularidad de tiempo y un filtro de tiempo relativo.




Campo Descripción



Configurar un gráfico indicador1. En el navegador Interfaz de usuario, abra o cree una página.2. En el área Interacciones del editor de diseño, haga clic en Nueva interacción.3. En el cuadro de diálogo Seleccionar interacción, seleccione la interacción con la que desea


4. En la paletaWidgets, arrastre un widget Gráfico indicador y suéltelo en un editor de diseño.5. En la pestaña General de la vista Propiedades, especifique las propiedades de gráfico tal y como


Campo Descripción






6. En la ficha Valores, haga lo siguiente:a. Seleccione los valores que desea que aparezcan en el gráfico.

Un gráfico indicador aparece en el widget de gráfico para cada valor seleccionado.b. En el campo Etiqueta para el valor seleccionado, escriba una etiqueta para el valor.c. Seleccione la fila de un valor para aplicarle un formato.d. En el área Formato, especifique el modo en que el valor aparece en el gráfico.e. Para agregar un valor, haga clic en Agregar.

7. En la pestaña Visualización predeterminada, seleccione una granularidad de tiempo.8. En la pestaña Estilo, configure lo siguiente:

Campo Descripción



9. Seleccione la opción para mostrar u ocultar la leyenda del gráfico.10. En el área Rangos:

a. Haga clic en Agregar.b. En el campo Desde, escriba un valor.c. En el campo Para, escriba un valor.d. En el cuadro de lista Color, seleccione un color de indicador.

Configurar gráficos que se actualizan dinámicamenteAntes de realizar este procedimiento, asegúrese de que:

• Configure las consultas enlazado a la lista de resultados de origen y destino o del widget de gráfico.• Incluya al menos una columna en común en los conjuntos de datos de las consultas enlazadascon el widget de origen y de destino.

• Configure la columna de conjunto de datos en común como una entrada de usuario en la consultaenlazada con el widget de destino.

• Agregue la lista de resultados de origen y destino o los widgets de gráfico a la página de la aplicación.Para configurar gráficos que se actualicen dinámicamente:1. En la página de aplicación que contiene los widgets de gráficos de origen y destino, abra

Interacciones.2. Haga clic en la interacción asociada con el gráfico de destino.3. En la vista Propiedades, seleccione Cuando cambia un valor de entrada.4. En la pestaña Entradas, haga clic en Seleccionar junto al editor de expresiones.5. En el área superior de la pestaña Datos de contexto, bajo los widgets, amplíe el widget de gráfico

de origen.6. Haga clic en selected_row y haga clic en Aceptar.7. Para probar la configuración en xCP Designer, seleccione un valor en el gráfico de origen. El

gráfico de destino se actualiza según el valor seleccionado.



Configurar un botón de opción1. En la paletaWidgets, arrastre un widget Botón de opción y suéltelo en un editor de diseño.2. En la pestaña General de la vista Propiedades, configure el widget tal y como se describe en la

tabla siguiente:

Campo Descripción

ID ID del widget.

Etiqueta Etiqueta del widget.

Número de campos de opción Cantidad de botones de opción que se deben agregar al widget. El límitesuperior es 1000.

Ubicación Seleccione Horizontal o Vertical.

Valor Seleccione un atributo o escriba una expresión que proporcione los datosque aparecen como el valor seleccionado inicialmente.

De forma predeterminada, el sistema evalúa el valor de la expresión ylo rellena. En tiempo de ejecución, cada vez que cambia el valor de laexpresión, el sistema vuelve a evaluar y asignar el valor actualizado denuevo.

Tipo de datos Seleccione el tipo de datos. El tipo de datos determina los controles devisualización disponibles para dar formato al widget.

Origen de datos Mediante el selector de un solo modelo, los valores posibles se puedenrellenar desde una lista de selección, un parámetro de sesión o unainstancia de servicio de datos. Note: Para una instancia de servicio dedatos, no seleccione ninguna interacción que devuelva un solo objetocomo salida.

3. En la pestaña Estilo, haga lo siguiente:a. Especifique el número de columnas para Campos de opción. El límite superior es 100.b. Especifique un nombre de clase para la hoja de estilo en cascada (CSS) que se aplique al widget.








• Desencadenador de comportamiento: seleccione el evento al que desea suscribirse.El comportamiento se realiza cuando se desencadena cualquiera de los eventos. Si no



proporciona ningún desencadenador, el sistema realiza la suscripción implícita según elvalor del comportamiento.




Campo Descripción








Definir un evento de interfaz de usuariopersonalizado1. En el navegador de Interfaz de usuario, haga clic en Nuevo →Evento de IU.2. En el cuadro de diálogo Nuevo evento de IU, si la aplicación contiene proyectos, seleccione el

proyecto donde el sistema almacena el evento de IU.3. En el cuadro de diálogo Nuevo evento de IU, en el campo Etiqueta, escriba una etiqueta para

identificar el evento de IU.4. En el campo Alcance del evento, seleccione uno de estos niveles.

El alcance le permite acceder a un evento desde varios elementos de la página.• Para limitar el evento de IU de modo que solo los elementos de una página y un fragmento queincluya páginas maestras accedan al evento, haga clic en Aplicación.

• Para limitar el evento de IU de modo que solo los elementos de una página que incluyenfragmentos accedan al evento, haga clic en Página.

• Para limitar el evento de IU de modo que solo los elementos de un fragmento de página accedanal evento, haga clic en Página.

• Para limitar el evento de IU de modo que solo los elementos de un flujo de acción accedan alevento, haga clic en Flujo de acción.



5. Haga clic en Finalizar.6. En la pestaña Conceptos básicos, especifique las propiedades tal y como se describe en la tabla

siguiente:

Campo Descripción

Etiqueta Escriba una etiqueta para identificar el evento de IU. Si cambia esta etiqueta, elsistema genera un nuevo nombre del sistema.

Nombre delsistema

El sistema asigna un nombre de sistema para uso interno para identificar el eventode IU. Este nombre se basa en la etiqueta. Si cambia la etiqueta, el sistema generaun nuevo nombre del sistema.


Alcance del evento Defina el alcance de un evento de IU.

Evento de tecla deacceso directo

Para activar el evento de IU con una combinación de teclas que desea configurar,seleccione esta opción.

Tecla de accesodirecto

Configure la tecla de acceso directo para desencadenar el evento de IU en tiempo deejecución. Al utilizar la combinación de teclas en el teclado en tiempo de ejecución,se desencadena el evento. NotaCuando se utilizan las teclas de acceso directo delnavegador como teclas de acceso directo de evento de IU, es posible que el evento nose desencadene de forma coherente. Por ejemplo, en el navegador Chrome, cuandose establece la combinación de teclas Ctrl + T como tecla de acceso directo, no sedesencadena el evento de IU. En su lugar el evento de navegador tiene prioridad yabre una nueva pestaña en el navegador Chrome.

7. En el editor de Datos, especifique los parámetros del evento de IU tal y como se describe en lasiguiente tabla:

Campo Descripción

Agregar parámetro Agrega un nuevo parámetro al evento de IU. En la pestaña General de la vistaPropiedades, escriba un Nombre y seleccione un Tipo. Si el parámetro puede tenervarios valores, seleccione Tiene varios valores.

Quitar parámetro Elimina el parámetro de evento de IU.

Importar modelo Para utilizar un modelo de objetos para definir parámetros de eventos de IU, hagaclic Importar modelo.

Al importar un modelo de objetos de negocio, todos los parámetros personalizadosasociados con él se agregan hasta la lista existente de parámetros.


Configurar un evento de interfaz de usuarioPuede configurar eventos de IU en páginas, fragmentos, flujos de acción, páginas del paso de flujos deacción y menús de contexto.1. En el navegador de Interfaz de usuario, abra la página, el fragmento, el flujo de acción, la página

del paso de flujos de acción o el menú de contexto.2. Haga clic en Eventos de IU. El sistema mostrará una lista de todas las publicaciones y

suscripciones en la página, el fragmento, el flujo de acción, la página del paso de flujos de acción oel menú contextual.



3. En el área Publicar, haga clic en Agregar. En el cuadro de diálogo Datos de contexto, seleccioneun evento de widget, una instancia del servicio de datos o un evento de IU que establezca lossiguientes criterios para invocar el evento de IU de destino.a. Desencadenantes: haga clic para agregar un desencadenante que escuche las acciones o los

eventos que se llevan a cabo en un widget, una instancia del servicio de datos o un evento deIU, lo que, a su vez, desencadenará el evento de IU que se publicará.

b. Con condición: escriba una expresión que evalúe la condición que, si es verdadera, publica elevento de IU. Es opcional.

c. Evento de IU: seleccione el evento de interfaz de usuario que se va a publicar. Haga clic enSiguiente.

d. Especifique el valor de cada parámetro de evento de interfaz de usuario. Haga clic en Finalizar.El sistema muestra la publicación recién agregada en la cuadrícula.

4. Haga doble clic para editar la publicación de eventos de interfaz de usuario.5. Haga clic en Quitar para eliminar la publicación de eventos de interfaz de usuario.6. En el área Suscribir, haga clic en Agregar . En el cuadro de diálogo Datos de contexto, seleccione

un widget, una instancia del servicio de datos o un evento de IU que establezca los siguientescriterios para suscribirse a un evento de IU.a. Comportamiento: haga clic para agregar la acción que desea realizar en el widget. Proporcione

el valor para cada acción mediante el editor de expresiones.b. Desencadenador de comportamiento: seleccione el evento al que desea suscribirse.

El comportamiento se realiza cuando se desencadena cualquiera de los eventos. Si noproporciona ningún desencadenador, el sistema realiza la suscripción implícita según el valordel comportamiento.

c. Condición de desencadenador: escriba una expresión que evalúe la condición, que en casode ser verdadera, realiza el comportamiento. Es opcional. Haga clic en Finalizar. El sistemamuestra la suscripción recién agregada en la cuadrícula.

7. Haga doble clic para editar la suscripción del evento de interfaz de usuario.8. Haga clic en Quitar para eliminar la suscripción del evento de interfaz de usuario.

Crear un parámetro de sesión1. En el navegador de Interfaz de usuario, seleccione Nuevo→Parámetro de sesión.2. Escriba una Etiqueta para identificar el parámetro de la sesión.3. Si la aplicación contiene proyectos, seleccione el proyecto al que está agregando el parámetro

de sesión.4. Seleccione el Tipo. Puede seleccionar Primitivo oModelo.5. Si selecciona Primitivo, haga lo siguiente:

a. Seleccione un tipo de datos de la lista desplegable.b. Para almacenar el valor del parámetro de sesión en el almacenamiento local del explorador,

seleccione Almacenado en el almacenamiento local del navegador.c. Para permitir que el parámetro de sesión tenga varios valores, seleccione Tiene varios valores.

6. Si seleccionaModelo, haga lo siguiente:a. Seleccione un tipo de datos utilizando el selector.b. Para permitir que el parámetro de sesión tenga varios valores, seleccione Tiene varios valores.




8. En la página Parámetro de sesión, defina el parámetro tal y como se describe en la siguiente tabla:

Campo Descripción

Etiqueta Identifica una etiqueta para el parámetro de sesión. Si cambia esta etiqueta, el sistemagenera un nuevo nombre del sistema.

Nombre delsistema

Identifica el nombre del sistema que el sistema utiliza internamente para identificar elparámetro de sesión cuando se utiliza en la API. Este nombre se basa en la etiqueta. Sicambia la etiqueta, el sistema genera un nuevo nombre del sistema.

Tipo Para cambiar el tipo, siga los pasos del 4 al 6.

Valor Escriba un valor o haga clic en Seleccionar y utilice el editor de expresiones paradefinir un valor.


Origen Identifica el proyecto al que pertenece el parámetro de sesión.

Actualizar un parámetro de sesiónEsta tarea es relevante para estos elementos de IU, páginas, páginas de objetos de negocio, fragmentosde página y flujos de acción.1. En el navegador de Interfaz de usuario, abra la página, fragmento o flujo de acción.2. En la pestaña Diseño, expanda Interacciones.3. Haga clic en Parámetro de sesión.4. En la pestaña General de la vista Propiedades, seleccione el parámetro de sesión.5. Escriba un valor o utilice el editor de expresiones para actualizar el valor del parámetro de sesión.

Publicar eventos de IU1. Publique los eventos de IU en la pestaña Comportamiento.






Suscribirse a eventos de IU1. Suscríbase a los eventos de IU en la pestaña Comportamiento.








Configurar un widget de Google MapsEs posible configurar un mapa estático o interactivo.

1. En la paletaWidgets, arrastre un widget Google Maps y suéltelo en un editor de diseño.

2. En la pestaña General de la vista Propiedades, configure el widget tal y como se describe en latabla siguiente:

Campo Descripción

ID Escriba un ID para el widget. El identificador único puede utilizarse enexpresiones para hacer referencia al mapa.

Tipo de mapa Especifica varios tipos de mapas. Los valores posibles son:

• Mapa de carreteras

• Satélite

• Híbrido

• Terreno

Nivel de zoom Establece el nivel de zoom inicial del mapa. En panas interactivos se puedeestablecer el nivel de zoom del mapa en tiempo de ejecución.

API de mapas Seleccione mapa interactivo o estático según sus requisitos.

Clave de API Defina la clave de API para utilizar el mapa con todas sus funciones alcompleto. Debe introducir el valor como Clave de API de Google.



Campo Descripción

Centro Seleccione una de las siguientes opciones:

Dirección: escriba la dirección para establecer el mapa en el centro de lapágina en tiempo de ejecución. Para cargar el mapa en tiempo de ejecuciónse deben especificar la dirección o las coordenadas de latitud y longitud.

Latitud/longitud: escriba las coordenadas de latitud y para establecer elmapa en el centro de la página en tiempo de ejecución. Especifique el valoren formato de cadena de caracteres con los valores de latitud y longitudseparados por comas.

Para cargar el mapa en tiempo de ejecución se deben especificar la direccióno las coordenadas de latitud y longitud.

Marcadores Configure el conjunto inicial de marcadores para que aparezcan al cargarel mapa.

3. En la pestaña Estilo, especifique la anchura y la altura del widget en píxeles.

Puede establecer el ancho Automático para que este coincida con el del contenedor.














Instalar la extensión de explorador de CTF• EnGoogle Chrome, se le redirige a la tienda web de Google para instalar la extensión del navegador.

• En Firefox, instale el complemento de navegador Firefox.

• En Internet Explorer, se descarga un instalador MSI. Una vez descargado, debe ejecutarmanualmente el instalador para instalar la extensión de IE y la aplicación nativa.

Instalar la aplicación nativa de CTF• En Google Chrome, se descarga el instalador de la aplicación nativa CTFNativeAppInstaller.exedespués de instalar la extensión del navegador correctamente. Deberá instalar manualmente estaaplicación haciendo doble clic en la aplicación. Las funciones de CTF se habilitan cuando el usuarioactualiza el navegador.

• En Firefox, instale el complemento de navegador Firefox. La instalación de la extensión se haceen línea con el navegador que solicita la confirmación al usuario final. No se le redirige a ningunaotra página.

• En Internet Explorer, la extensión BHO y la aplicación nativa de CTF se instalan conjuntamente.Es necesario abrir una nueva pestaña en el navegador Internet Explorer para continuar trabajandoen la aplicación xCP con la función de CTF activada y aceptar que se habiliten los complementoscuando el navegador lo solicite.

Después de instalar la extensión del navegador de CTF y la aplicación nativa de CTF, si no se veninguna barra de instrucciones de instalación de extensión del navegador durante el uso de laaplicación xCP, se considera que la instalación es correcta. Compruebe los registros de CTF paraconfirmarlo mejor.

Esta tabla ofrece una vista de las ubicaciones de instalación, ubicaciones de archivos de registro einstrucciones de desinstalación de CTF.

Aplicación nativa de CTF Internet Explorer Google Chrome Firefox

Ubicación de la instalación de laaplicación nativa de CTF:

%LOCALAPPDATA%\EMC\

ContentXfer\

com.emc.ctf.native.app\

<version>

Ubicación de la instalaciónde la extensión de IE:

C:\Program Files\

CTFHelperObject

La extensiónse instala en elnavegador y losregistros se puedenencontrar en laconsola JavaScriptdel navegador.

La extensiónse instala en elnavegador y losregistros se puedenencontrar en laconsola JavaScriptdel navegador.

Ubicación del registro de laaplicación nativa:

%temp%\ContentTransferDaemon.log

Registros de la extensiónde IE:

%temp%\BHO.log



Aplicación nativa de CTF Internet Explorer Google Chrome Firefox

Ubicación del repositorio decontenido local:

%localappdata%\EMC\

ContentXfer\

xcp_local_storage.json

Desinstalación:

Elimine la ubicación de instalacióndel cliente tal como se ha indicadoarriba.

Desinstalación:

Desinstale la extensióna través de Panel decontrol > Programasy características >Desinstalar un programa> EMC Content TransferHelper

NotaAl realizar la

operación de desinstalación

de la extensión de IE, el

instalador también elimina

la aplicación nativa de CTF.

Desinstalación

Navegue a chrome://extensions/ en elnavegador Chromey haga clic en elicono Quitar deChrome situadojunto a EMCContent TransferExtension.Note:Cuando se eliminala extensiónde Chrome,el instaladorno elimina laaplicación nativade CTF.

Desinstalación

Navegue a Add-onsManager://extensions/ enel navegadorFirefox y hagaclic en el iconoQuitar situadojunto a EMCContent TransferExtension.Note:Cuando se eliminala extensiónde Firefox,el instaladorno elimina laaplicación nativade CTF.

Conceptos

Patrón de aplicaciones

Un Patrón de aplicaciones define la superestructura externa de la aplicación. Identifica la posición yel diseño de los elementos de la interfaz de usuario, así como del área de contenido de las páginasincluidas en la aplicación. El sistema crea de forma automática una plantilla Patrón de aplicaciones alcrear una aplicación.

El Patrón de aplicaciones contiene un conjunto de widgets de inicio que proporcionan:

• Un menú horizontal

• Un control de sesión de usuario

• Un área de contenido

Los widgets del Patrón de aplicaciones deben configurarse. La documentación de cada uno delos widgets proporciona detalles acerca de la configuración. Una vez configurados, estos widgetsaparecerán en todas las páginas de la interfaz de usuario de la aplicación.



Tema azul claroAdemás del tema predeterminado del sistema, el tema azul claro proporciona un conjunto de archivosCSS que permite al usuario final sustituir el formato predeterminado del sistema para las páginasde la aplicación.

El tema azul claro se empaqueta como una biblioteca de xCP (xcp-clear-blue-theme.jar) y contienetres archivos scss:

• colors.scss: contiene las definiciones y las variables para los colores globales.

• common.scss: contiene las importaciones de archivos scss obligatorios.

• eztheme.scss: contiene los estilos personalizados que pueden aplicarse a las páginas de la aplicación.Al utilizar este archivo, puede sustituir el comportamiento del estilo predeterminado.

Una vez que se ha importado el tema azul claro, puede seleccionar y aplicar el tema en la pestañaConceptos básicos de la página principal.

Al utilizar este tema, puede sustituir los siguientes elementos:

Sustituir el estilo predeterminado para los widgets

Al aplicar el tema azul claro, los siguientes estilos para los widgets se cambiarán de formapredeterminada:

• Elimina la imagen de fondo de la aplicación para dejar una página en blanco.

• Elimina la imagen de fondo de la página del paso del flujo de acción para dejar un color azul pálido.

• Elimina la barra con rayas sobre los widgets del cuadro de columna.

• Muestra las etiquetas del widget en negrita.

• Elimina la sombra paralela alrededor de los widgets, por ejemplo, los widgets Visor y Lista deresultados.

• Cambia el color del menú de navegación de negro a azul.

• Cambia el color predeterminado del botón a azul.

• Cambia el logotipo de la aplicación.

• Establece el texto de los widgets Visualización del valor y Lista de resultados como ajuste de línea.

• Cambia el color predeterminado del widget de la pestaña a azul.

• Muestra el separador entre las columnas del Cuadro de columna como un icono.

• Ajusta la alineación vertical del widget Visor para que coincida con la de otros widgets.

Agregar un logotipo personalizado de página de inicio desesión de la aplicaciónSi usa este tema, podrá agregar un logotipo personalizado. Siga los siguientes pasos:

1. Cree una imagen y guarde el archivo con el formato PNG. Asegúrese de que el tamaño de laimagen es de 448 x 50 píxeles. Por ejemplo, logo.pngNota: En el nombre del archivo se distingueentre mayúsculas y minúsculas.



2. Guarde la imagen en la siguiente estructura de carpetas de aplicaciones en la que se encuentraxCP Designer:

\src\main\webapp\js\resources\css\icons

3. Aplique el tema desde la página principal.

4. Reinicie xCP Designer para reflejar los cambios guardados.

Paletas de colores disponibles

Utilice estos estilos al aplicar el color a cualquiera de los widgets disponibles. Reemplace <color>por cualquiera de los colores de estas paletas: paleta de colores predeterminada y paleta de EMC.Asegúrese de especificar <color> en minúsculas sin espacios, por ejemplo, emcbluelight2.

Paleta de colores predeterminada del sistema

Paleta de colores azul claro

Para especificar los estilos personalizados, puede definir estos estilos para los widgets como seindica a continuación:



Widget Estilos (clases CSS) Descripción

box-head-<color> Cambia el color del título.

box-head-text-<color> Cambia el color del texto del título.

box-head-line-<color> Cambia el color de la barra de subrayado deltítulo.

box-head-noline Elimina la barra de subrayado.

box-s-head-<color> Cambia el color del título y reduce el rellenoentre los espacios.

box-s-head-text-<color> Cambia el color del texto del título y reduceel tamaño de fuente.

box-body-<color> Cambia el color de las columnas.

Cuadro decolumna

box-body-text-<color> Cambia el color del texto de la columna.

results-s Reduce el tamaño de fuente de los valoresen la fila.

results-l Aumenta el tamaño de fuente de los valoresen la fila.

results-row-<color> Cambia el color de las filas.

results-row-text-<color> Cambia el color del texto de la fila.

results-head-<color> Cambia el color de la fila del encabezado.

Lista deresultados

results-head-text-<color> Cambia el color del texto de la fila delencabezado.

tab-<color> Cambia el color de las pestañas.

tab-text-<color> Cambia el color del texto de la pestaña.

tab-body-<color> Cambia el color de los paneles de la pestaña.

tab-noborder Elimina el contorno alrededor del grupo depestañas.

Grupo depestañas

tab-nocaret Elimina el triángulo marcador de la pestañaactual.

button-<color> Cambia el color del botón.

button-s-<color> Cambia el color y reduce el tamaño del botón.

button-l-<color> Cambia el color y aumenta el tamaño delbotón.

Botón

button-text-<color> Cambia el color del texto del botón.

tree-s Reduce el tamaño de fuente y todos los iconosaparecen más pequeños y más genéricos.

Árbol decontenido

tree-l Aumenta el tamaño de fuente y todos losiconos aparecen más grandes.

title-<color> Cambia el color de la barra del título encimade los widgets con títulos.

Árbol decontenidosy vista decarpeta

title-text-<color> Cambia el color del texto del título.



Páginas de aplicacionesLas páginas de aplicación alojan el contenido administrado por la aplicación, no el contenido queforma parte de un caso concreto. Por ejemplo, puede crear una página principal o páginas de aplicaciónpara contenidos como informes, listas de tareas y colas de trabajo. También puede mostrar una prácticarecomendada a la que desea que todos accedan.

Administrar la página Parámetros de aplicaciónAl crear una aplicación, una página del sistema se genera en la aplicación denominada Administrarparámetros de aplicación. Contiene los controles para cada parámetro de aplicación en la aplicación.Puede utilizar esta página para cambiar los valores para los parámetros de aplicación, pero no paraagregar o eliminar parámetros.

Versiones de rolLas versiones de rol de páginas se utilizan para crear versiones alternativas de una página y asignarlesroles. Cada versión de rol puede contener diseños completamente distintos, widgets e instancias deservicios de datos. El rol del usuario determina qué versión se presenta cuando el usuario se desplaza ala página.

En el navegador de la interfaz de usuario, cuando se agregan versiones de rol a una página, la páginaoriginal permanece en la misma posición en el árbol con las versiones de rol colocadas en un nivelinferior. La página original no es una versión de rol, pero es la versión predeterminada de la página. Laversión predeterminada de la página se muestra para los usuarios de roles que no han sido asignados alas versiones de rol de la página.

Páginas de inicio de procesoLos usuarios finales pueden crear páginas de inicio de proceso que les permiten iniciar un proceso.Estas páginas son como páginas de aplicación o páginas de modelo de objeto, pero solo puede haberuna página de inicio por proceso.

La página contiene un campo para cada variable que se basa en el tipo de datos y en la multiplicidadde la variable, y un control de paquete para la configuración de cada paquete. Los usuarios puedenagregar o quitar anexos de esta página también.

Páginas de tareasLas páginas de tareas permiten al usuario final tener acceso a las tareas asignadas y realizarlas. Lapágina incluye todas las variables, los paquetes y los anexos, y permite al usuario final modificarlospara completar la tarea. Para modificar los datos o los atributos de paquete, el usuario final necesita almenos permisos de escritura.

El usuario final al que se le haya asignado la tarea puede acceder a la página de tarea manual, mientrasque a la página de tareas de colas de trabajo pueden acceder todos aquellos que tengan el permiso



adecuado. Cuando un usuario final accede a una tarea, este puede ver todos los datos y los atributos depaquete, incluso aunque no tenga permisos de acceso para el objeto de paquete.

Fragmentos de páginaUn fragmento de página es un componente que contiene una colección de widgets o interaccionesque puede agregar a páginas o a otros fragmentos de página. Crear fragmentos de página elimina lanecesidad de agregar los mismos widgets a varias páginas en una aplicación de usuario final. Porejemplo, en una aplicación de procesamiento de préstamos los siguientes seis widgets de entrada detexto aparecen juntos en 12 páginas diferentes: nombre del cliente, apellidos del cliente, dirección,ciudad, provincia y código postal. Si no ha utilizado un fragmento de página, deberá agregar cada unode estos widgets de entrada de texto a cada una de las 12 páginas. Mediante un fragmento de página,se define de una vez una colección de widgets de entrada de texto y, a continuación, se reutiliza elfragmento en cada página.

Un fragmento de página se parece a una página en que lo asocia a una aplicación o a un modelo deobjeto. A diferencia de una página, un fragmento de página no se puede redireccionar por URL y debeagregarse a una página para que la aplicación en tiempo de ejecución lo procese. Un fragmento depágina es una entidad independiente que se comunica con la página host o fragmento por medio deparámetros de entrada y salida.

Cuando crea una página, puede configurar la aplicación para que muestre un fragmento de páginaespecífico a un usuario final o puede definir una expresión que utiliza el sistema para determinarqué fragmento de página le aparece al usuario final durante el tiempo de ejecución. Los fragmentosque aparecen en función de una expresión proporcionan una interfaz de usuario dinámica donde laacción del usuario final o algún otro contexto determinan el contenido que aparece en una página. Porejemplo, en una aplicación de procesamiento de préstamos, un procesador de préstamos y un evaluadordel préstamo podrían ver dos fragmentos de página diferentes en la misma página.

Ejemplo de interfaz de usuario dinámica

En una aplicación de préstamos, el usuario final necesita los datos del solicitante, como nombre,apellidos, dirección, ciudad, provincia y código postal en muchas etapas durante el ciclo de vida delpréstamo:

• Para mostrar los datos del solicitante en la página de tareas

• Para mostrar los datos del solicitante en una página de instancias

• Para mostrar los datos del solicitante en un flujo de acción

Puede definir todos los datos del solicitante como un fragmento de página una vez y reutilizarlo encada escenario. Si no utiliza un fragmento de página, deberá agregar los datos del solicitante enuna página distinta en cada escenario. El uso de fragmentos de página le permite crear páginas deaplicación más rápidamente.

Plantillas de página de objeto de negociopredefinidasHay tres plantillas de páginas de objeto de negocio predefinidas:



• Crear página <Objeto de negocio>

• Ver página <Objeto de negocio>

• Editar página <Objeto de negocio>

Si el objeto de negocio es Cliente, las páginas se llamarán Crear cliente, Ver cliente y Editar cliente.

Crear página Objeto de negocio

La página Crear objeto de negocio contiene un botón para crear un nuevo objeto de negocio, porejemplo un nuevo Cliente.

Página Ver objeto de negocio

La página Ver objeto de negocio contiene widgets que ofrecen:

• Posibilidad de acceder a una visualización de solo lectura de todos los atributos conocidos del objetode negocio, incluidos los atributos heredados

• Acciones comunes

• Comentarios

Página Editar objeto de negocio

La página Editar objeto de negocio contiene widgets que ofrecen:

• Una visualización editable de todos los atributos conocidos del objeto de negocio, incluidos losatributos heredados

• Un botón para guardar

WidgetsUn widget es un elemento de una interfaz gráfica de usuario (GUI, por sus siglas en inglés). Muestrauna determinada forma de organizar la información, como un cuadro de columna o un cuadro de texto,que el usuario final puede cambiar.

Al crear páginas de interfaz de usuario, puede agregar widgets de la paleta de widgets a un editor dediseño. Puede colocarlos en cualquier parte de la página.

El tema de la aplicación determina el estilo predeterminado de widget. Puede ajustar determinadosaspectos de la apariencia de algunos de widgets, como la altura y anchura, y también especificarel formato de número, hora y fecha.

Paleta de widgetsLos widgets disponibles para su uso en la creación de la aplicación se encuentran en la paleta dewidgets. Desde aquí puede agregar un widget a un editor de diseño y configurarlo para su uso.



Los widgets se organizan en la paleta por categoría. El elemento de la interfaz de usuario en tiempo deejecución que está diseñando determina las categorías de los widgets disponibles en la paleta.

Determinar qué widget utilizar

Utilice la tabla siguiente para determinar qué widgets va a agregar a su página:

Widget Descripción

Árbol de contenido

Configurar un árbol decontenido, página 311

Permite al usuario final desplazarse a una determinada jerarquía en unaubicación de repositorio desde una página de la aplicación. El usuario finalpuede seleccionar un objeto en el árbol de contenido, y la página del objetoaparece en un área de contenido en la misma página de aplicación que el árbolde contenido.

Menú de navegación

Configurar un menú denavegación, página 312

Le permite crear menús de navegación fáciles de utilizar que guían a losusuarios finales a través de la aplicación. Si agrega este widget a un patrón deaplicaciones, los usuarios finales pueden navegar a otras páginas de aplicacióno páginas del sistema. Si lo agrega a un patrón de caso, los usuarios finalespueden navegar a otras páginas de caso o páginas del sistema.

Menús de navegación, página 390 proporciona información adicional.

Cuadro de columna

Configurar un cuadro decolumna, página 317

Es el widget de diseño fundamental. Contiene otros widgets y proporciona lasreglas de diseño de los widgets que contiene. El widget de cuadro de columnapuede tener una o más columnas y cada una de ellas puede contener widgets,incluidos otros widgets de diseño, como el widget de cuadro de columna.

Cuadros de columna, página 390 proporciona información adicional.

Área de contenido

Configurar un área decontenido, página 320

Aparece en un patrón de aplicaciones o una página de la aplicación y sereemplaza con contenido en tiempo de ejecución. Por ejemplo, una páginaprincipal con una dirección URL que aparece en la ubicación del área decontenido Patrón de aplicaciones en tiempo de ejecución. Cada página maestrasolo puede tener un área de contenido y esta no puede eliminarse.

Si se incluye un área de contenido en una página de aplicación junto con unwidget de árbol de contenido, al hacer clic en el árbol de contenido, el usuariofinal no sale de la página de aplicación a menos que esta área se incluya en unwidget de vista de carpeta. En ese caso, se omitirá el área de contenido.

Grupo de pestañas

Configurar un widget Grupode pestañas, página 320

Permite al usuario final seleccionar entre varias pestañas, cada una de las cualescontiene otros widgets.

Casilla de verificación

Configurar una casilla deverificación, página 322

Permite a los usuarios finales introducir datos booleanos. Por ejemplo, unempleado de hotel puede actualizar el estado de un cliente pasándolo a lacategoría Premier si accede a la página de edición de clientes y selecciona lacasilla de verificación que corresponda a la categoría de cliente Premier.

Comentarios

Configurar la entraday visualización decomentarios, página 323

Muestra comentarios sobre un objeto de contenido u otro objeto de negocio,incluidos los comentarios creados como anotaciones mediante el visor decontenido.



Widget Descripción

Entrada de fecha/hora

Configurar un widget deentrada de fecha y hora,página 325

Permite al usuario final introducir valores para mostrar la fecha y la hora en unformato específico. El widget de hora y fecha se puede configurar para crear,editar y ver las páginas de objetos de negocio.

Al agregar el widget Entrada de fecha/hora a una página, puede configurarlopara que refleje un entorno localizado.

Entrada multivalor defecha-hora

Configurar un widget deentrada de fecha y hora,página 325

Permite al usuario final introducir valores para mostrar las fechas y las horas enun formato específico. El widget Entrada multivalor de fecha-hora se puedeconfigurar para crear, editar y ver las páginas de objetos de negocio.

Al agregar el widget Entrada multivalor de fecha-hora a una página, puedeconfigurarlo para que refleje un entorno localizado.

Entrada de números

Configurar un campo parala entrada de un número,página 328

Permite a los usuarios finales escribir un número entero o un número condecimales en un campo. Por ejemplo, un nuevo cliente llama a un servicio deimpuestos con la información. En una página de creación de clientes, un asesorfiscal escribe el número de dependientes en un campo de números enterosetiquetado como Dependientes. El asesor fiscal introduce los ingresos de losclientes con dos decimales en un campo flotante etiquetado como Ingresos.

Entrada multivalor denúmero

Configurar un campo parala entrada de un número,página 328

Permite a los usuarios finales escribir números enteros o números con decimalesen un campo. Por ejemplo, un empleado de hotel escribe y realiza un pedidosegún las preferencias de cliente para la planta de su habitación: 12, 13, 14.

Área de texto

Configurar un área de texto,página 329

Permite a un usuario final escribir texto en un cuadro de texto etiquetado. Unusuario final puede introducir o actualizar información específica acerca deun objeto de negocio (por ejemplo, el cliente) como el nombre, el apellido yel código postal.

El widget de área de texto difiere del widget de entrada de texto en que puedecambiar la altura del widget de área de texto.

Entrada de texto

Configurar un campo para laentrada de texto, página 331

Permite a un usuario final escribir texto en un cuadro de texto etiquetado. Unusuario final puede introducir o actualizar información específica acerca deun objeto de negocio (por ejemplo, el cliente) como el nombre, el apellido yel código postal.

Entrada multivalor de texto

Configurar un campo para laentrada de texto, página 331

Permite a un usuario final escribir varios valores de texto en un cuadro detexto etiquetado. Un usuario final puede introducir o actualizar informaciónespecífica acerca de un objeto de negocio (por ejemplo, Colores), como el rojo,azul y verde.

Lista desplegable

Configurar un widget delista desplegable, página333

Permite la selección de un elemento de una lista de opciones predefinidas.

Selección múltiple de listadesplegable

Configurar un widget delista desplegable, página333

Permite la selección de varios elementos de una lista de opciones predefinidas.



Widget Descripción

Anexo

Habilitar anexos de proceso,página 335

Permite al usuario final realizar una tarea para seleccionar objetos (por ejemplo,archivos, carpetas u objetos de negocio) que se utilizarán en el proceso.

Selector de objetos

Habilitar la selección deobjetos, página 338

Permite al usuario final realizar una tarea para seleccionar un paquete que seva a utilizar en el proceso. El widget se adjunta a un servicio de datos, quedetermina el tipo de objetos que se pueden seleccionar.

Lista de resultados

Configurar un widget Listade resultados, página 341

Muestra una lista de resultados de instancias de objetos y atributos seleccionadosen una página. La lista se muestra información acerca de un modelo de objeto,como un préstamo, una garantía, un cliente o un producto. Cada fila representauna instancia de objeto. Cada columna indica un único atributo para el objeto.Por ejemplo, si el widget de lista de resultados está configurado para enumerarpréstamos, cada fila representa un préstamo. Las columnas de ID del préstamo,tipo y cantidad representan atributos.

Una lista de resultados también se utiliza para mostrar los resultados debúsqueda cuando se agrega a una página de búsqueda para un modelo deconsulta.

Listas de resultados, página 394 proporciona información adicional.

Texto enriquecido

Configurar un campo detexto enriquecido, página352

Le permite agregar texto de solo lectura en la interfaz de usuario. Por ejemplo,puede utilizar el widget de texto enriquecido para agregar instruccionesdirigidas al usuario final en una página. Este widget se puede agregar encualquier parte de la página.

Visualización del valor

Configurar un widget devisualización de valores,página 353

Le permite agregar una etiqueta de solo lectura y el valor para un atributo en unapágina. Por ejemplo, el widget puede mostrar Nombre como etiqueta y Johncomo valor. Puede cambiar la etiqueta del widget, pero el valor se obtiene desdeel valor real del atributo cuando el widget aparece en tiempo de ejecución.

El atributo puede ser cualquier tipo de datos simples y puede tener uno o variosvalores. Puede dar formato a los atributos numéricos, de fecha o de hora y fecha.

Vista de carpeta

Configurar un widget devista de carpeta, página 355

Proporciona una vista en línea de una carpeta y su contenido.

Visor

Configurar un widget devisor, página 356

Aloja un visor de contenido para habilitar la visualización y manipulación decontenido. Utilice la configuración de la aplicación para asignar los tipos dearchivos de contenido a los visores alojados.

Widgets visor, página 394 proporciona información adicional.

Imagen

Configurar la apariencia deuna imagen, página 357

Coloca un gráfico en la página. Esta imagen puede ser un hipervínculo a unadirección URL preconfigurada.

Menú de acción

Configurar un menú deacción, página 359

Proporciona al usuario final enlaces a todas las páginas de creación y deinicio de procesos de la aplicación. Por ejemplo, si hay un objeto de negociodenominado "Cliente" y una página de creación de clientes, se crea unaacción de desplazamiento a la página de creación de clientes, que pasa a estardisponible en el menú de acciones.



Widget Descripción

Botón

Crear un botón, página 423

Invoca una de las acciones siguientes:

• Una acción de formulario, como Actualizar

• Una acción del sistema sobre un objeto, como Eliminar

• Una acción de navegación, como, por ejemplo, Ir a la página

Control de sesión de usuario Muestra el nombre y rol del usuario final. El usuario final también puedenacceder a la configuración, incluida la ubicación de red (se utiliza para BranchOffice Caching Services), o cerrar sesión mediante este widget.

El sistema genera este widget en la página principal y está disponible en lapaleta Widget.

Fragmento de página

Crear un fragmento depágina, página 302

Configurar un fragmento depágina, página 309

Contiene una colección de widgets que puede agregar a varias páginas. Adiferencia de otros widgets, primero se crea un fragmento de página y luegose configura en una página.

Fragmentos de página, página 380 proporciona más información.

Selector de archivos

Configurar la selección dearchivos, página 336

Permite al usuario agregar y quitar archivos. El usuario final puede importarestos archivos en tiempo de ejecución.

Grupo de botones de opciónConfigurar un botón deopción, página 367

Permite la selección de un elemento de una lista.

Visualización de erroresConfigurar el widgetVisualización de errores,página 351

Muestra mensajes de validación.

Mapa de GoogleConfigurar un widget deGoogle Maps, página 372

Permite al usuario agregar mapas a su aplicación.

Diseño de bordeConfigurar un widget dediseño de borde, página 314

Permite diseñar un diseño compatible con varias regiones dentro de un panel.Tiene la capacidad incorporada de expandir o contraer estas regiones inherentesy también es compatible con el anidamiento de varios paneles. Es posiblecolocar widgets en cualquier zona del diseño.

AcordeónConfigurar un widget deacordeón, página 316

Permite diseñar una disposición que admite varios paneles, con un estilo deacordeón expandido. Esto significa que, en cada momento, solo se puedeexpandir uno de los paneles. Cada panel se puede expandir y contraer.



Actualizar widgets de entrada de forma dinámica

Puede configurar widgets de entrada para actualizar el valor inicial devuelto desde un servicio de datos.Para ello, modifique la propiedad del valor Inicial del widget escribiendo una expresión que utilicedatos de contexto, funciones, parámetros, servicios de datos o valores de otros widgets.

Widgets de entrada incluyen:

• Entrada de texto (única y de varios valores)

• Entrada de números (valor único y varios valores)

• Entrada de hora y fecha (valor único y varios valores)

• Lista desplegable (sencilla y múltiple)

• Casilla de verificación

Determinar qué widget de gráfico utilizar

Utilice la tabla siguiente para determinar qué tipo de gráfico va a agregar a su página:

Widget de gráfico Descripción Ejemplo

Gráfico de columnas

Configurar un gráficode columna y de línea,página 361

Compara los datos entre los grupos.

Realiza un seguimiento de los cambiosen períodos de tiempo prolongados.

Recuento del número de reclamacionespor desempleo para cada provinciade una región. Recuento de lasreclamaciones por desempleo emitidasdurante días, semanas o meses.

Gráfico de barras

Configurar un gráfico debarras, página 363

Compara los datos entre los grupos.

Realiza un seguimiento de los cambiosen períodos de tiempo prolongados.

Recuento del número de reclamacionespor desempleo para cada provinciade una región. Recuento de lasreclamaciones por desempleo emitidasdurante días, semanas o meses.

Gráfico de líneas

Configurar un gráficode columna y de línea,página 361

Realiza un seguimiento de los cambiosocurridos con el paso del tiempo,especialmente si se trata de pequeñasmodificaciones.

Muestra las correlaciones entre lasvariables.

Genera previsiones que extrapolenresultados más allá de los datosdisponibles.

Recuento del número de veces quese actualizan las reclamaciones pordesempleo cada hora.




Gráfico circular

Configurar un gráficocircular o de donut,página 364

Compara partes de un todo en undeterminado momento. Visualiza unadistribución de proporción o porcentaje.

No utilice los gráficos circulares cuandolos valores de un conjunto de datos seannegativos.

Cada porción de un gráfico circularrepresenta una dimensión de eje X. Elvalor del eje Y determina el tamañorelativo de cada porción.

Cálculo de la distribución de ingresosgenerados en cada región geográficadurante un determinado año.

Gráfico toroidal

Configurar un gráficocircular o de donut,página 364

Compara la proporción de las partes deun todo mediante varias series de datos.

Visualiza una distribución de proporcióno porcentaje mediante varias series.

No utilice gráficos de donut cuando losvalores de un conjunto de datos seannegativos.

Cada anillo de un gráfico de donutrepresenta una serie de datos. Cadaporción representa una dimensión deeje X. El valor del eje Y determina eltamaño relativo de cada porción.

Comparación de la distribución deingresos generados en cada regióngeográfica para los diferentes productos.Cada anillo del gráfico de donutrepresenta un solo producto. El tamañode la porción representa la distribuciónde ingresos en cada región.

Lista de resultados

Crear una lista deresultados, página 340

Muestra una lista de instancias deobjetos y atributos seleccionados en unapágina.

Muestra información acerca de un tipode objeto, como préstamos, garantías,cliente o producto. Cada fila representauna instancia de objeto. Cada columnaindica un único atributo para el objeto.

Visualización del estado actual en unalista de procesos o casos.

Gráfico indicador

Configurar un gráficoindicador, página 365

Muestra un valor único en un gráficosemicircular. El valor puede representardatos de instancia o datos agregados.

Gráficos indicador, página 396proporciona información adicional.

Visualización de la duración promedioo máxima para los procesos en cursoejecutados durante el último día.

Crystal Report

Configurar un informede Crystal Reportsmediante una conexiónXML, página 250

Configurar un informede Crystal Reportsmediante una conexiónJDBC, página 252

Configure informes con capacidadesde formato avanzado. Crystal Reportsofrece una mayor flexibilidad y controlsobre los informes.

Exporta datos de gráficos en variosformatos.

Imprime informes de alta fidelidad y enpíxeles perfectos.

Aprovisionamiento para las partesinteresadas de versiones en papel de uninforme.




Imprime informes con grandescantidades de datos.

Editores de diseñoLos editores de diseño son los espacios de trabajo donde la interfaz de usuario se diseña agregando yconfigurando widgets. Puede agregar widgets al editor de diseño arrastrándolos y colocándolos en laposición donde se mostrarán en tiempo de ejecución. Cuando se agrega un widget al editor de diseño,estará seleccionado y disponible para su configuración.

Selección de widgetsUn editor de diseño le permite crear elementos de interfaz de usuario mediante los widgets. Lossiguientes elementos de interfaz de usuario (elementos de IU) contienen los editores de diseño enlos que se pueden agregar y configurar widgets:

• Páginas

• Pasos del flujo de acción

• Tareas

• Patrón de aplicaciones

Siempre hay una selección en un lienzo del editor de diseño. La selección puede ser tanto un widgetcomo un elemento de interfaz de usuario.

Un widget se resalta cuando se selecciona. Si no hay ningún widget resaltado visible, se selecciona elelemento de interfaz de usuario.

Si un widget contiene elementos complejos, como el diseño de columnas, acordeones, cuadrículas deresultados y menús, también podrá seleccionar los subelementos. Por ejemplo, si un widget de cuadrode columna tiene dos columnas, las columnas son subelementos que puede seleccionar. Antes de poderseleccionar un subelemento, se debe haber seleccionado un widget.

Validación de widgetsAl crear los formularios en los que el usuario final introduce los datos, es necesario comprobardiariamente si los datos escritos cumplen con las necesidades de la aplicación. Al validar los datos delformulario, el usuario final puede saber inmediatamente si hay errores, lo que aumenta la eficacia yaque se ahorra tiempo al esperar una respuesta HTTP y se evita que el servidor trabaje con la entradaincorrecta de formularios.

La función de validación le permite aplicar la validación a diferentes widgets de entrada y proporcionarcomentarios apropiados para que los usuarios finales realicen acciones correctivas.



Estas validaciones son de cara al cliente y no requieren que el usuario final envíe el formulario alservidor para validarlo si los datos introducidos cumplen con las necesidades de la aplicación.

Las validaciones típicas son:

• Hacer que un campo de un formulario sea obligatorio para que el usuario final no lo deje en blancoal rellenar un formulario.

• Asegurarse de que los datos introducidos en un campo cumplen las necesidades de la aplicación.

La validación consta de cuatro partes:

• El desencadenador: un evento que desencadena la validación del elemento.

• La expresión: una condición que el usuario final que introdujo los datos debe cumplir.

• El mensaje de error: un mensaje que se muestra al usuario final cuando una condición falla.

• Indicador visual: una indicación sobre el elemento de formulario de que presenta un error, con unborde rojo y un icono, para llamar la atención del usuario final.

Sección Interacciones del editor de diseñoUtilice la sección Interacciones de un editor de diseño para ver las interacciones agregadas a la páginaactual. Esta sección muestra instancias de acción y consultas de datos. Las interacciones aparecenen la sección cuando se generan durante la creación del widget.

Para mostrar el contenido de la sección Interacciones de un editor de diseño, haga clic en la flechaarriba situada junto al título de la sección.

Iconos del panel InteraccionesEn la siguiente tabla se muestra una lista de iconos disponibles en el panel Interacciones del editorde diseño:

Iconos Nombre del icono

Flujo de acción

Consulta de alerta

Objeto de negocio

Contenido

Carpeta

Consulta de texto completo

Consulta histórica

Proceso



Iconos Nombre del icono

Consulta en tiempo real

Relación

Proceso sin estado

Consulta de lista de tareas

Menús de navegaciónLos widgets del menú de navegación le permiten crear menús de navegación fáciles de utilizar queguían a los usuarios finales a través de la aplicación. Si agrega este widget a un patrón de aplicaciones,los usuarios finales pueden navegar a otras páginas de aplicación o páginas del sistema. Si lo agrega aun patrón de caso, los usuarios finales pueden navegar a otras páginas de caso o páginas del sistema.

Además del menú de nivel superior, puede agregar cualquier número de niveles de submenú al menúde navegación. Los elementos de menú actúan como hipervínculos a otras páginas. Cada elemento demenú contiene una etiqueta y también puede incluir un indicador de submenú. También puede agregarseparadores a los submenús para que el menú sea más fácil de leer.

Los elementos de menú pueden enlazarse a URL externas, así como a páginas de caso o de aplicacióninternas. Los vínculos externos le permiten vincular con información externa a la aplicación, como unsistema de ayuda o un sitio en la intranet con prácticas recomendadas.

Cuadros de columnaLos widgets de cuadro de columna son widgets de diseño fundamentales. Son contenedores de otroswidgets y proporcionan las reglas de diseño de los contenidos de los widgets. Un widget de cuadrode columna puede tener una o más columnas y cada una de ellas puede contener widgets, incluidosotros widgets de diseño, como el widget de cuadro de columna.

Para utilizar el widget de cuadro de columna para el diseño y posicionamiento, puede ocultar el título.Para usarlo como una sección o un contenedor de campos, puede hacer que su título sea visible.

El widget de cuadro de columna contiene los elementos siguientes:

• Título

• Contraer

• Columna

• Separador

Título

El título es el título del widget. Puede ocultar el título si no desea que aparezca en la interfaz de usuario.Para ocultar el título, quite el texto de campo de título de las propiedades del cuadro de columna.



ContraerLa función Contraer solamente está disponible si el widget de cuadro de columna tiene título. Hagaclic en el icono para contraer los contenidos del widget.

ColumnaEl widget de cuadro de columna puede contener un máximo de diez columnas.

La columna Orientación determina cómo se ordenan los widgets dentro de una columna. Si se eligela orientación horizontal, los widgets se organizan en una fila. Si se elige la orientación vertical,los widgets se apilan uno sobre otro.

La columna Ancho determina el tamaño horizontal de la columna. El tamaño de la columna se puedeconfigurar de las siguientes formas:

• Automático (el espacio horizontal restante se rellena de forma automática)• Número fijo de píxeles• Porcentaje del contenedor (página u otra columna)

La columna Ancho mínimo le permite configurar el tamaño horizontal mínimo de una columna de % oautomática. El ancho mínimo se especifica en píxeles.

Cuando se modifica el tamaño horizontal de una columna para reducirla y hacerla más pequeñaque el ancho del contenido, tiene dos opciones para gestionar el contenido que se desborda. Laopción Recortar muestra solamente los contenidos que caben en la columna. La opción Barra dedesplazamiento permite al usuario desplazarse para ver todo el contenido de la columna.

Se pueden configurar las etiquetas de los widgets etiquetados contenidos en una columna. Puedeajustar la posición de las etiquetas, su ancho, su relleno y su alineación.

SeparadorUn separador es un elemento de división horizontal ajustable situado entre columnas. Puede agregarun separador cuando las columnas a cada lado del borde tengan anchos automáticos o de %. Elseparador mejora la visualización de la interfaz de usuario, ya que permite a los usuarios visualizarmás o menos área de una columna.

Comportamiento en tiempo de ejecución de unwidget de cuadro de columnaUn widget de cuadro de columna rellena el ancho del contenedor donde se coloca. El contenedorpuede ser un editor de diseño de página u otro widget de contenedor, como un widget de cuadro decolumna, de acordeón o de pestaña.

Cuando se ajusta el tamaño del explorador en tiempo de ejecución, la configuración del ancho decolumna determina el comportamiento del widget de cuadro de columna. La configuración del anchode columna de cada una de ellas es automática, fija o por porcentajes.

Ancho del contenedor = columnas fijas + columnas con porcentaje + columnas automáticas



La configuración del ancho de columna se describe en la siguiente tabla:

Configurar anchode columna

Descripción

Fijo Rellena el número de píxeles de ancho especificado y no responde a los ajustes detamaño del explorador

% (porcentaje) Rellena un porcentaje especificado del ancho del contenedor

Automático Rellena el resto del ancho de las columnas, una vez que se calculen las columnas detipo fijo y de porcentaje

Cambiar el tamaño del explorador cambia el ancho total del contenedor. Esto hace que las columnasmodifiquen su tamaño de forma automática. Los cambios realizados dependen del número decolumnas y de la configuración del ancho.

La siguiente tabla muestra ejemplos de cómo las columnas rellenan el total del ancho del contenedorsegún su configuración:

Ancho total del

contenedor

Columna 1 Columna 2 Columna 3 Columna 4

1.000 píxeles 400 píxeles (fijo) 200 píxeles (20%) 400 píxeles(automático)

1.400 píxeles 400 píxeles (fijo) 280 píxeles (20%) 720 píxeles(automático)

1.400 píxeles 400 píxeles (fijo) 280 píxeles (20%) 360 píxeles(automático)*

360 píxeles(automático)*

1.000 píxeles 400 píxeles (fijo) 200 píxeles (20%) 300 píxeles (30%) 100 píxeles(automático)

1.400 píxeles 400 píxeles (fijo) 280 píxeles (20%) 420 píxeles (30%) 300 píxeles(automático)

1.000 píxeles 600 píxeles (60%) 400 píxeles (40%)

1.000 píxeles 600 píxeles (30%)** 400 píxeles (20%)**

1.000 píxeles 400 píxeles (fijo) 600 píxeles (20%)***

*Si hay más de una columna marcada como automática, compartirán el espacio disponible de formaproporcional.

**Si las columnas de porcentaje no se pueden usar para rellenar todo el contenedor, los porcentajesrepresentarán una proporción entre columnas.

***Si la única y otra columna es de tipo fijo, la configuración de porcentaje actúa como ajusteautomático.

Separador

Un separador es una barra de división entre dos columnas. En tiempo de ejecución, un usuario puededeslizar el separador hacia la izquierda o a la derecha, para ver más o menos área de las columnas.Un separador solo puede situarse entre dos columnas de ancho automático o de % (porcentaje). Laconfiguración de porcentaje o automática especifica el ancho inicial cuando la página aparece por



primera vez. Cuando el usuario desliza el separador, los nuevos anchos permanecen hasta que lapágina se actualiza o el separador se mueve de nuevo. Si las columnas que aparecen a los lados delseparador tienen una configuración de ancho mínimo, el separador solamente se podrá mover hastael ancho mínimo de cada columna.

Desbordamiento de contenido

Si un navegador cambia de tamaño o se elimina un separador, los contenidos de la columna puedenocupar más espacio que el que ofrece el tamaño de la columna. En esta situación, los contenidos serecortan o bien aparece una barra de desplazamiento a disposición de los usuarios. La gestión delos contenidos desbordados es una propiedad de la columna que se establece durante el diseño delwidget de cuadro de columna.

Formatos de fecha y horaProporcione al usuario final el formato correcto de fecha que debe introducirse en la etiqueta o el aviso.En la siguiente tabla se describe cómo responde el sistema a la entrada del usuario final:

Formato Entrada del usuariofinal

Interpretación de lainterfaz de usuario

Formato de mensaje deerror

Corto (03/08/09) 8/3/09 03/08/09 m/d/a

Medio (08 mar., 2009) 8/3/09 08 mar., 2009 d M, A

Largo (08 de marzo de2009)

8/3/09 08 de marzo de 2009 d F A

l, j F A 8/3/09 Domingo, 8 de marzo de2009

l, j F A

8/3/09 03/08/09 8/3/09 n/j/a

03/08/09 8/3/09 03/08/09 m/d/a

8/3/2009 8/3/09 8/3/2009 n/j/A

8-Mar-09 3/8/09 8-Mar-09 j-M-A

3/8/09 3/8/09 3/8/09 j/n/a

03/08/2009 3/8/09 03/08/2009 d/m/A

Los formatos de mensaje de error utilizados son Ext JS estándar, como se describe en la siguiente tabla:

Formato Descripción Valor devuelto

d Día del mes, dos dígitos con ceros a laizquierda

De 01 a 31

F Representación textual completa de un mes De enero a diciembre

j Día del mes sin ceros a la izquierda De 1 a 31

F Representación textual completa del día de lasemana

De domingo a sábado

L Representación textual corta de un mes De ene. a dic.



Formato Descripción Valor devuelto

m Representación numérica de un mes con cerosa la izquierda

De 01 a 12

n Representación numérica de un mes sin cerosa la izquierda

De 1 a 12

A Representación numérica completa de un año,cuatro dígitos

Ejemplos: 1999, 2003 o 2012

a Representación de un año de dos dígitos conceros a la izquierda

Ejemplos: 99, 03 o 12

Listas de resultadosUtilice un widget de lista de resultados para mostrar una lista de instancias de objetos y atributosseleccionados en una página. La lista muestra información acerca de un modelo de objeto, comopréstamos, garantías, cliente o producto. Cada fila representa una instancia de objeto. Cada columnaindica un único atributo para el objeto. Por ejemplo, si el de lista de resultados está configurado paraenumerar préstamos, cada fila representa un préstamo. Las columnas de ID del préstamo, tipo ycantidad representan atributos.

En tiempo de ejecución, el texto de la primera columna es un hipervínculo a la página predefinida dela instancia de objeto. Por ejemplo, si el ID de préstamo es la primera columna, los usuarios finalespueden hacer clic en cualquier enlace de ID para abrir la página predefinida del préstamo. Si no hayninguna página predefinida, el hipervínculo no aparece.

En tiempo de ejecución, cuando el número de registros disponibles en la última página de la lista deresultados sea igual que el límite de páginas definido para la Lista de resultados, aparecerá el botónReenviar.

Una lista de resultados muestra los datos devueltos a partir de una instancia del servicio de datos.Por lo tanto, una lista de resultados debe conectarse a una instancia del servicio de datos. Durantela creación de la lista de resultados, puede crear una instancia de servicio de datos o seleccionar unaconsulta histórica o de texto completo en tiempo real. A continuación, el sistema genera una instanciade servicio de datos basada en la selección y la conecta con la lista de resultados.

Para una consulta de texto completo, puede definir valores de aspecto y almacenarlos en un parámetrode sesión como valores separados por comas. Cada vez que cambia el valor de aspecto, la lista deresultados que muestra los datos de una consulta de texto completo recupera el valor de aspecto delparámetro de sesión definido. Puede suscribirse al evento de IU para establecer el valor de aspecto entiempo de ejecución.

Una lista de resultados también se utiliza para mostrar los resultados de búsqueda cuando se agrega auna página de búsqueda para un modelo de consulta.

Widgets visorUn widget de Viewer aloja un visor que permite visualizar y manipular contenido. xCP Designeres compatible con xCP Content Viewer, xCP Media Viewer, el complemento xCP Desktop Pluginy visores de terceros. Utilice la configuración de la aplicación para asignar los tipos de archivosde contenido a los visores alojados.



Un widget del visor contiene tres elementos tal y como se describe en la siguiente tabla:

Elemento Descripción

Barra deherramientas demodificación decontenido

Proporciona opciones para modificar la estructura de un objeto de contenido. Losparámetros de configuración y los permisos de usuario afectan a la disponibilidad dedeterminadas operaciones. Por ejemplo, el sistema deshabilita todas las operacionescuando un objeto de contenido está bloqueado por otro usuario.

Navegador enminiatura

Muestra una imagen para cada página de un objeto de contenido. Las imágenesaparecen como una versión en miniatura de una página o como un icono de tipo decontenido.

Portal para visoralojado

Muestra las páginas de un objeto de contenido en el visor de contenido.

El sistema deshabilita la barra de herramientas de modificación de contenido y el navegador enminiatura cuando los usuarios finales ven archivos en Acrobat Reader o en un explorador. El sistemadeshabilita la barra de herramientas de modificación de contenido para los usuarios de iPad.

Widgets Visualización de erroresEl widget Visualización de errores se utiliza para mostrar los mensajes de validación. Se puede enlazara los widgets de entrada como:

• Entrada de texto (única y de varios valores)• Entrada de números (valor único y varios valores)• Entrada de hora y fecha (valor único y varios valores)• Lista desplegable (sencilla y múltiple)• Casilla de verificación• Cuadro de columna• Fragmento• Grupo de pestañas• Botón de opción• Selector de objetos• Área de texto

El widget Visualización de errores también se puede enlazar a una interacción.

Puede enlazar uno o varios widgets Visualización de errores a un contenedor.

Durante el tiempo de ejecución, todos los mensajes de error se muestran en una lista con el prefijo de laetiqueta del widget. Al hacer doble clic en el mensaje de error del widget Visualización de errores,se destacará el widget de entrada en particular que tenga el error.

Widgets de gráficosLos widgets de gráficos como, por ejemplo, los de columna, circular, línea e indicador, representanvisualmente los datos en informes para los usuarios finales en tiempo de ejecución. Proporcionan a losusuarios finales una visión de las operaciones de negocio que mejora la toma de decisiones.



Los gráficos muestran los datos devueltos por una instancia de servicio de datos. Tras agregar unwidget de gráfico a una página, enlácelo a una instancia de servicio de datos históricos o en tiempo real.

En una aplicación en tiempo de ejecución, los gráficos muestran un máximo de 100 registros a la vez.Si el usuario final desea ver más de 100 registros, utilice el widget de lista de resultados.

Puede configurar gráficos para que actualicen dinámicamente los datos que aparecen en otros gráficos.

Gráficos indicadorUtilice los gráficos indicador para mostrar una instancia o un valor agregado en un gráfico semicircular.El valor cae dentro de un rango configurado para el gráfico indicador. Se pueden configurar rangosmúltiples para un gráfico indicador, y cada rango se asocia con un color.

Rangos y valores

En este ejemplo, cuando un valor está comprendido entre 1 y 100, el indicador aparece en verde,incluido el valor. Si un valor se encuentra está comprendido entre 101 y 200, el indicador aparece decolor naranja, incluido el valor. Si un valor es mayor que 201, el indicador es el rojo.

La figura siguiente contiene tres rangos para un gráfico indicador:

En función de estos intervalos, el siguiente gráfico indicador aparece cuando un valor es 45:

Granularidad de tiempoUtilice la granularidad de tiempo para configurar la vista predeterminada de los datos de gráficopresentados a los usuarios finales en la aplicación en tiempo de ejecución. Por ejemplo, si un gráficode columnas calcula la cantidad de ingresos generados (eje Y) para cada producto (eje X), y lagranularidad de tiempo es trimestral, el gráfico incluye resultados para el último trimestre completado.Cuando se genera un gráfico de ingreso por producto durante el segundo trimestre, los resultadosincluyen solo los datos del primer trimestre.



Si el eje X de un gráfico es un tipo de datos de fecha, utilice un filtro de tiempo relativo para especificarel número de períodos de tiempo que aparecen en el gráfico. Por ejemplo, establezca la granularidadde tiempo en Trimestral y el tipo 3 para que el filtro de tiempo relativo muestre tres columnas en elgráfico. Esta misma configuración para un gráfico circular muestra tres porciones, una porción paracada trimestre.

La figura siguiente contiene tres columnas de datos; cada una de las columnas representa un trimestre:

Actualizar gráficos de forma dinámica

Puede configurar los gráficos para que se actualicen dinámicamente de modo que, cuando los usuariosfinales realicen cambios en un gráfico, se actualicen los datos en otro gráfico. En el ejemplo siguiente,cuando un usuario final hace clic en la columna 1 Ene 2012, esta acción actualiza el gráfico circularpara mostrar los datos de esa misma fecha. Si el usuario final, a continuación, hace clic en la columna1 Abr 2012, esta acción actualiza el gráfico circular para mostrar datos de la fecha recientementeseleccionada.

La figura siguiente contiene un gráfico circular que se actualiza cuando el usuario final seleccionaun valor en el gráfico de columnas:



En este ejemplo, el gráfico Promedio del importe del préstamo por región es un destino que seactualiza cuando un usuario final hace clic en un valor del gráfico de origen. Los gráficos de origeny destino se pueden enlazar a la misma consulta histórica. Si utiliza dos consultas históricas, losconjuntos de datos deben tener al menos una columna en común. Configure la columna en comúncomo una entrada de usuario en la consulta enlazada al gráfico de destino.

La consulta enlazada al gráfico de origen incluye las siguientes columnas de conjunto de datos:

• Promedio del importe del préstamo

• Fecha

La consulta enlazada al gráfico de destino incluye las siguientes columnas de conjunto de datos:

• Promedio del importe del préstamo

• Fecha

• Oficina regional

Estos tipos de gráficos se pueden configurar entre dos o más widgets de cualquier tipo, incluidos lossiguientes:

• Widget de lista de resultados para el widget de gráfico

• Widget de gráfico para el widget de lista de resultados

• Widget de lista de resultados para el widget de lista de resultados

• Widget de gráfico para el widget de gráfico



Parámetro de sesión

Un parámetro de sesión almacena los datos que se pueden compartir entre diversos elementos de lainterfaz de usuario (IU) específica de la aplicación en tiempo de ejecución, por ejemplo, un ID decliente. En la lista siguiente se resumen las características del parámetro de sesión:

• Los parámetros de sesión solo se enlazan con un elemento de la interfaz de usuario, por ejemplo, unwidget, una página o un flujo de acción.

• El valor de un parámetro de sesión solo puede ser un tipo de datos básico o de modelo.

• Puede almacenar los parámetros de sesión en memoria o los puede convertir en datos persistentesalmacenándolos en el almacenamiento local del navegador cliente.

• Puede definir varios parámetros de sesión por aplicación, que constan de un tipo y, opcionalmente,un valor predeterminado. Puede utilizar un editor de expresiones para definir el valor inicial de unparámetro de sesión.

Por ejemplo, en su aplicación de asignación, puede preguntar a los clientes por su preferencia de zonahoraria. A continuación, la aplicación mostrará la fecha y hora en esa zona horaria en las páginasde la aplicación.

Evento de interfaz de usuario

Un evento de interfaz de usuario (IU) le permite configurar una aplicación dinámica donde la accióndel usuario final determina lo que aparece en la pantalla. Cuando se produce un evento de IU, laaplicación ajusta el contenido que aparece. Por ejemplo, una aplicación contiene dos fragmentos depágina; uno de ellos contiene una lista de clientes y el otro detalles de los clientes. Cuando el usuariofinal actualiza los detalles de un cliente específico, tiene lugar un evento de IU que se comunica con elprimer fragmento de página para actualizar los detalles específicos de ese cliente. Los eventos de IUpueden desencadenar varios eventos según las configuraciones que haya definido.

Un evento de interfaz de usuario (IU) proporciona un mecanismo para separar la información deorigen y de destino, lo que significa que, con independencia de esta, el evento de interfaz de usuario secomporta adecuadamente para transmitir la información. Los eventos de IU también proporcionan unaexperiencia de usuario final interactiva y mejorada donde un único evento de IU permite la interacciónentre las páginas. Por ejemplo, una aplicación contiene una página Cuentas de cliente. Esta páginaconsta más allá del widget Lista de resultados y del botón Agregar nuevo. El widget Lista de resultadosmuestra la información relacionada con las cuentas de cliente y el botón Agregar nuevo le permiteagregar una nueva cuenta de cliente. Puede utilizar una consulta en tiempo real (RTQ) para obtenerlos detalles de las cuentas de cliente. Al hacer clic en el botón Agregar nuevo, el sistema le conectaal flujo de acción que busca información a través de un asistente. El primer paso busca informaciónsobre el tipo de cuenta, el segundo paso busca información sobre el nombre del cliente y el últimopaso es un acuerdo que el cliente acepta para finalizar la creación de una cuenta. Esta secuencia depasos le permite crear una nueva cuenta de cliente. Con independencia de la información de origen yde destino, puede configurar un evento de interfaz de usuario llamado Cuenta creada y este eventose desencadenará en el último paso de un flujo de acción. Así, cada vez que se agrega una cuenta decliente, el evento de IU notifica al usuario final la adición de un nuevo cliente. Puede utilizar esteevento de IU para obtener la última lista de clientes cada vez que el usuario agrega un cliente.



xCP Designer se proporciona con un número eventos de IU del sistema que puede utilizar. Tambiénpuede utilizar un evento predefinido cuando cree un evento personalizado. Por ejemplo, puedeconfigurar el evento Objeto modificado para publicar un evento cuando el usuario final modificalos detalles del cliente.

Cuando se desencadena un evento de IU, el valor se suma para una expresión. Cuando la expresióncontiene un valor de true, los datos se rellenan en la carga durante el tiempo de ejecución de laaplicación.

Suscribirse a un evento de IU

Cada widget o instancia de servicio de datos puede suscribirse a un evento de interfaz de usuario.Cuando se produce cualquiera de estos eventos y se cumple una condición opcional, el widget puedellevar a cabo cualquier comportamiento configurado, como Deshabilitar, Ocultar, Definir valor, etc.También se puede ejecutar una instancia del servicio de datos.

Publicar un evento de IU

Los widgets, las instancias del servicio de datos u otros eventos de IU pueden publicar eventos de IUcuando se produce un evento en el widget, la instancia del servicio de datos o el evento de IU y secumple una condición opcional. Por ejemplo, si se hace clic en un widget, o este se habilita o pierde elenfoque; si se produce un error de instancia del servicio de datos; o si se activa un evento de IU.



Eventos de IU de OOTB

Los eventos de la interfaz del usuario de uso inmediato (OOTB) son de 2 tipos: eventos publicables yno publicables. Los eventos publicables se pueden configurar para publicarse en distintas acciones delusuario y, por lo general, el sistema realiza la acción correspondiente en tiempo de ejecución al publicarel evento. Sin embargo, solo el usuario puede suscribirse a eventos que no se pueden publicar y esposible configurar cualquier acción para que se lleve a cabo cuando el sistema publique estos eventos.

Eventos de IU de OOTB publicables

Evento de OOTB Descripción Carga útil El sistema realizauna actividad

Alcance

Actualizarformulario de lapágina

Publique elevento cuando seanecesario actualizarel modelo de lapágina.

N/D Internamente, elsistema vuelve acargar el modelo.Se aplica solopara la páginade instancia. Notiene ningún efectosobre la página deaplicación.

Página

Actualizarformulario defragmento

Publique elevento cuando seanecesario actualizarel fragmento.

N/D Internamente, elsistema vuelve acargar el modelo.Se aplica solo alfragmento de unainstancia. No tieneningún efecto sobreel fragmento de unaaplicación.

Fragmento

Borrar lista dearchivos cargados

Este evento permiteborrar el ID dearchivo del caché.Por ejemplo,esto ayuda alescribir un widgetpersonalizado,cuando se necesitauna función paraborrar el ID dearchivo cargado dela memoria cachédesde el lado delcliente.

ID de archivo: IDde archivo como unvalor de cadena decaracteres. Puedeobtener un ID dearchivo de la cargaútil del evento delista de carga dearchivos.

El sistema borra lacaché de nombresde archivos eID cargados enel lado del cliente.

Aplicación




Alcance

Desplazarse a lapágina

Publique el eventocuando deseeacceder a unapágina despuésde realizar unaactividad.

• page_id: IDde la páginaque se carga.Por ejemplo,namespace_<nombre delsistema depágina

• page_object_id:aplicable ala página deinstancia.

• external_url: ir ala dirección URLde la página.

• new_browser_tab: falso, abrirla página en lamisma ventana.

• browser_tab_target:especifique eldestino queidentifica lapestaña dela página dedestino.

• browser_tab_url_params:especifiquecadenasde consultaparametrizadaspara la direcciónURL.

• (opcional)force_navigate:permite volver acargar la página,tanto si lapágina actuales la mismao distinta quela páginasolicitada.

NotaSi seindican page_idy external_url,

Internamente, elsistema invocala navegaciónde página y loredirigirá a lapágina.

Aplicación




Alcance

page_id tieneprioridad.

Mostrar error Publique el eventocuando deseemostrar un mensajede error al usuariofinal.

error_message:mensaje de erroren forma de cadenade caracteres.

El sistema muestrael mensaje de errordefinido por elusuario.

Aplicación

Mostrar advertencia Publique el eventocuando deseemostrar un mensajede advertencia alusuario final.

warning_message:mensaje deadvertencia enforma de cadenade caracteres.

El sistema muestrael mensaje deadvertenciadefinido por elusuario.

Aplicación

Mostrarnotificación

Publique el eventocuando deseemostrar un mensajede notificación alusuario final.

notification_mes-sage: mensaje de no-tificación en formade cadena de carac-teres.

El sistema muestrael mensaje denotificacióndefinido por elusuario.

Aplicación

Actualizar páginade paso

Publique elevento cuando seanecesario actualizarla página de paso enun flujo de acción.

Carga útil enforma de cadenade caracteres quecontiene un ID depágina de paso.

El sistema actualizala página del pasoactiva actual delflujo de acción.

Página

Eventos de IU de OOTB no publicables

Evento deOOTB

Descripción Carga útil Alcance

Objeto creado Evento interno que se invocaal crear un objeto. El objetopuede ser objeto de negocio,objeto de tipo de contenido oun objeto de tipo carpeta.

• id: ID del último objeto creado enforma de cadena de caracteres.Representa el URI como

<tipo_de_objeto>/<nombre_de_artefacto>/<id_de_objeto_creado>

Por ejemplo: Business Objectdevuelve

"business-objects/rctt_bo8/0801e24080026257"

Mientras que Folder Objectdevuelve

"folders/rctt_myfold/0b01e24080026267"

• type: tipo del último objetocreado en forma de cadena de

Aplicación



Evento deOOTB


caracteres. Representa el URIcomo

types/<tipo_de_objeto>/<nombre_de_artefacto>

Por ejemplo: Business Objectdevuelve

"types/business-objects/rctt_bo8"

Mientras que Folder Objectdevuelve

"types/folders/rctt_myfold"

Objetoeliminado

Se invoca al eliminar unobjeto. El objeto puede serobjeto de negocio, objeto detipo de contenido o un objetode tipo carpeta.

• id: ID del último objeto eliminadoen forma de cadena decaracteres.

• type: tipo del último objetoeliminado en forma de cadena decaracteres.

Aplicación

Objetoimportado

Se invoca al importar unobjeto. El objeto puede serobjeto de negocio, objeto detipo de contenido o un objetode tipo carpeta.

• id: ID del último objeto importadoen forma de cadena decaracteres.

• type: tipo del último objetoimportado en forma de cadena decaracteres.

Aplicación

Objetomodificado

Se invoca al modificar unobjeto. El objeto puede serobjeto de negocio, objeto detipo de contenido o un objetode tipo carpeta.

• id: ID del último objeto modificadoen forma de cadena decaracteres.

• type: tipo del último objetomodificado en forma de cadenade caracteres.

Aplicación

Objetobloqueado

Se invoca cuando undocumento está abiertopara editarlo.

• id: ID del último objeto bloqueadoen forma de cadena decaracteres.

• type: tipo del último objetobloqueado en forma de cadenade caracteres.

Aplicación



Evento deOOTB


Objetodesbloqueado

Se invoca al cancelar laoperación de edición en undocumento.

• id: ID del último objetodesbloqueado en forma decadena de caracteres.

• type: tipo del último objetodesbloqueado en forma decadena de caracteres.

Aplicación

En caso de error Se invoca cuando se produceun error durante la ejecuciónde un servicio.

• errorcode: un número único enforma de cadena de caracteres.

• message: mensaje de error enforma de cadena de caracteres.

Aplicación

Al cargarformulario

Se invoca cuando al cargarun modelo para una páginade instancia, o despuésde procesar la página deaplicación.

N/D Página

Al descargarformulario

Se invoca antes de actualizarla página.

N/D Página

Al cargarfragmento

Se invoca cuando:

• se carga un modelo paraun fragmento de instancia

• después de procesar elcontenido del fragmentode aplicación

• cada vez que cambia unfragmento

N/D Fragmento

Al descargarfragmento

Se invoca cuando seconfigura el ID de fragmentomediante una expresión.Supongamos que utilizamosun contenedor de fragmentoúnico para dos tiposdiferentes de objetos,Cliente y Empleado, en unapágina. En este caso, sedebe proporcionar el ID defragmento a través de unaexpresión.

El evento Al descargarfragmento se invoca alcambiar de Cliente aEmpleado y viceversa.Sin embargo, el mismoevento no se desencadena alcambiar el fragmento para

N/D Fragmento



Evento deOOTB


un mismo objeto con IDdistintos.

Al inicializar Se invoca durante lainicialización de la vistade la aplicación.

N/D Aplicación

Al cerrar sesión Se invoca cuando elusuario cierra la sesiónde la aplicación.

N/D Aplicación

Al navegar Se invoca cuando la páginaactual se descarga y seredirige o se reenvía a otrapágina.

• previd: ID anterior en forma decadena de caracteres.

• prevmodelname: nombre delmodelo anterior en forma decadena de caracteres. Porejemplo: xcp_loan, donde xcp esun espacio de nombres y loan esel nombre del modelo.

• prevpagename: nombre de lapágina anterior en forma decadena de caracteres. Porejemplo: xcp_view_loan, dondexcp es un espacio de nombresy view_loan es el nombre de lapágina.

Aplicación

Al completar lanavegación

Se invoca una vez finalizadala navegación a otra página.

• Id: ID anterior en forma decadena de caracteres.

• modelname: nombre del modeloanterior en forma de cadena decaracteres.

• pagename: nombre de la páginaanterior en forma de cadena decaracteres.

Aplicación

Al cargar lapágina

Se invoca después del eventode carga de un formulario.

• Nombre del modelo en forma decadena de caracteres.

• Nombre de la página en forma decadena de caracteres.

Página

Al descargar lapágina

Se invoca antes de navegara otra página.

• Nombre del modelo en forma decadena de caracteres.

• Nombre de la página en forma decadena de caracteres.

Página



Evento deOOTB


Relación creada Se invoca al realizaruna acción de relacióncorrectamente. La acciónRelación relaciona dosobjetos.

Id: ID de la relación creada en formade cadena de caracteres. La cadena decaracteres devuelta es un URI.

Aplicación

Error al cargar elarchivo

Se invoca cuando se produceun error en una operación decarga de archivos.

• Nombre de archivo en forma decadena de caracteres.

• Mensaje de error en forma decadena de caracteres.

• ID de error en forma de cadenade caracteres.

Aplicación

Carga dearchivos correcta

Se invoca al realizarcorrectamente una operaciónde carga de archivos.

• ID de archivo en forma de cadenade caracteres.

• Nombre de archivo en forma decadena de caracteres.

Aplicación

Lista de carga dearchivos

Internamente, el eventocontiene la lista de ID quese cargan mediante unaoperación de arrastrar ycolocar archivos.

ID de archivo en forma de arreglo decadenas de caracteres.

Aplicación

Al finalizar flujode acción [1]

Se invoca al hacer clic en elbotón Terminar del flujo deacción.

• Nombre de flujo de acción enforma de cadena de caracteres.

• Nombre de la página del últimopaso en forma de cadena decaracteres.

Flujo de acción

Al cancelar flujode acción [1]

Se invoca al hacer clic en elbotón Cancelar del flujo deacción.

• Nombre de flujo de acción enforma de cadena de caracteres.

• Nombre de la página del últimopaso en forma de cadena decaracteres.

Flujo de acción

Al cargarpreferencias

El evento consumeinternamente los datosde preferencias. Para cargaruna página de preferenciascon el valor adecuado, serealiza una llamada AJAXque recupera el valor dela preferencia del servidory desencadena el eventoAl cargar preferencias.Los widgets o elementosque escuchan este evento

• role: rol actual del usuario.

• workflowautonexttask: valorverdadero o falso. Si esverdadero, se acepta la tareasiguiente automáticamente.

• delegate_task: valor verdaderoo falso. Delegar la tarea en otrousuario

• delegatetouser: usuario en el cualse debe delegar la tarea.

Aplicación



Evento deOOTB


cargan los datos adecuadosutilizando el contenido decarga útil del evento.

• networklocation - configuraciónregional: ubicaciónpredeterminada en la que seiniciará sesión la próxima vez queinicie sesión.

• enable_client_plugin: permiteuna edición sencilla para facilitarla transferencia de contenido.

Al guardarpreferencias

El evento permite guardarlas preferencias de usuarioen el servidor.

• role: rol actual del usuario

• workflowautonexttask: valorverdadero o falso. Si esverdadero, se acepta la tareasiguiente automáticamente.

• delegate_task: valor verdaderoo falso. Delegar la tarea en otrousuario

• delegatetouser: usuario en el cualse debe delegar la tarea.

• networklocation - configuraciónregional: ubicaciónpredeterminada en la que seiniciará sesión la próxima vez queinicie sesión.

• enable_client_plugin: permiteuna edición sencilla para facilitarla transferencia de contenido.

Aplicación

Objetoregistrado

Se invoca al registrar unobjeto.

• Id: ID del objeto anterior en formade cadena de caracteres

• newId: ID del objeto nuevo enforma de cadena de caracteres.

• type: tipo de objeto en forma decadena de caracteres.

• last_checkin_version: cadena decaracteres con múltiples valoresde la versión anterior

• latest_checkin_version: cadenade caracteres con múltiplesvalores de la versión nueva

• last_modified_date: última fechade modificación del objeto

• latest_modified_date: fecha demodificación más reciente delobjeto

Aplicación



Evento deOOTB


Contenidoinsertado

Se invoca al insertar páginasen el documento.

contentId: ID del objeto antiguo enforma de cadena de caracteres

newContentId: ID del objeto nuevo enforma de cadena de caracteres

Aplicación

Contenidoeliminado

Se invoca al quitar páginasdel documento.



Aplicación

Contenidoreordenado

Se invoca al organizar el flujode contenido reorganizandola secuencia del contenido.



Aplicación

Contenidoextraído

Se invoca al extraer elcontenido.



Aplicación

Comentariocreado

Se invoca al agregar elcomentario asociado con undocumento. Incluso si seresponde al comentario, seinvoca el evento.

objectId: ID de objeto en forma decadena de caracteres

commentID: ID del comentario enforma de cadena de caracteres

Aplicación

Comentarioeliminado

Se invoca al eliminar elcomentario asociado con undocumento.



Aplicación

Comentarioactualizado

Se invoca al actualizarel comentario existenteasociado a un documento.



Aplicación

Comentariovisualizado

Se invoca al visualizarel comentario y sus hilosasociados a un documento.



Aplicación

Notas específicas:

[1] Los eventos On Action Flow Finish y On Action Flow Cancel no se admiten en la versión actual dexCP Designer. Sin embargo, puede lograr esta funcionalidad mediante los desencadenadores ActionFlow Cancel, Action Flow Success o Action Flow Error.

Siempre que se migra a la versión actual una aplicación de xCP 2.1 o xCP 2.2 con eventos On ActionFlow Finish u On Action Flow Cancel, el sistema genera en la pestaña de problemas un error quedebe resolverse manualmente.



Editar fácilmente en tiempo de ejecuciónLa sencilla función de edición le permite:

• Edición de contenido

• Descargar un archivo

• Importar un archivo modificado en el servidor

En tiempo de ejecución, cuando hace clic en el botón Editar, el sistema descarga el documento en elsistema local y se abre en su aplicación nativa. Por ejemplo, si desea editar un documento de Word,el sistema inicia la aplicación Microsoft Word y abre el documento en dicha aplicación. Antes dedescargar el archivo, el sistema lo bloquea en el servidor para evitar que otros usuarios lo editen. Alregistrar el documento, el archivo local se selecciona automáticamente y se agrega al flujo de acción deimportación de nueva versión.

Puede configurar estas operaciones en el área Opciones de complemento del cliente de estos flujosde acción:

Para un flujo de acción Seleccione la casilla

de verificación para

configurar la operación

Configuración

predeterminada

de la operación

¿Es Configurable?

Abrir el archivo alterminar de descargarlo

VerdaderoDescargar contenido

Permitir al usuarioseleccionar la ubicaciónde descarga

Falso

Sí

Editar contenido Abrir el archivo alterminar de descargarlo

Verdadero Sí

Cancelar edicióncontenido

Eliminar el archivo localsi la operación es correcta

Falso Sí

Importaciónpersonalizada de nuevaversión

Eliminar el archivo localsi la operación es correcta

Verdadero Sí

Habilitar la edición sencilla

Para habilitar la edición sencilla:

• En la página Preferencias, seleccione la casilla de verificación Habilitar complemento de cliente ypara guardar la página, seleccione Guardar.

• Para asegurarse de que la sesión HTTP del navegador está disponible para el applet en Tomcat 7 ysuperior, así como en el paquete del servidor TC con Tomcat 7 y superior, agregue lo siguiente a<Tomcat_home>/conf/context.xml:

<context useHttpOnly="false"></context>

Para asegurarse de que la sesión HTTP del navegador está disponible para el applet en el servidorde aplicaciones WebSphere:



1. En el panel de exploración de la consola administrativa WebSphere, desplácese hasta Servidores> Tipos de servidor >; Servidores de aplicaciones WebSphere.

2. Seleccione el servidor que desea actualizar y, a continuación, desplácese hasta Panel deconfiguración > Configuración de contenedor > Administración de sesiones.

3. En Propiedades generales, haga clic en la etiqueta Habilitar cookies. No anule la selección dela opción Habilitar cookies.

4. Desactive la casilla de verificación Establecer cookies de sesión como solo HTTP.5. Guarde y reinicie el servidor de aplicaciones.

Flujos de acción de las funcionalidades de ECMLos flujos de acción de las funcionalidades de ECM se empaquetan como flujos de acción de alcancede aplicación. Estos flujos de acción se pueden invocar desde las páginas de instancias, los menúscontextuales y las páginas de aplicaciones. Se incluyen los siguientes flujos de acción de aplicacioneslistas para utilizar:

• Importar• Importar versión nueva• Crear documento a partir de una plantilla• Crear carpetaLas funcionalidades de ECM que se utilizan para crear contenido y carpetas están disponibles parasu uso en la aplicación xCP como flujos de acción personalizados preempaquetados. Se puedenutilizar como en la mayoría de casos o se pueden personalizar todavía más. De forma predeterminada,los flujos de acción de ECM contienen una página de un paso que utiliza entradas necesarias y quecontiene un widget de fragmento además de otros widgets. Este widget de fragmento carga unfragmento correspondiente al contenido o a la carpeta donde se muestran los atributos. Estos flujos deacción se asignan a los siguientes elementos:

• Los botones correspondientes de la página de visualización del contenido y de la carpeta.• El menú contextual de la lista de resultados, en la que se muestran las carpetas y el contenido.• El menú contextual del árbol de contenido.• Las acciones correspondientes del menú contextual del contenido y de la carpeta. Este menúcontextual aparece en la lista de resultados o en el árbol de contenido.

Cuando llegue el momento de diseñar, deberá crear fragmentos para cada uno de los tipos de contenidoy de carpeta para los que desee utilizar los flujos de acción de ECM. Si realiza cualquier cambio en elmodelo de contenido o carpeta, vuelva a crear los siguientes fragmentos.

• Los fragmentos relacionados con el contenido para los fragmentos de importación y de importaciónde versión nueva.

• Los fragmentos relacionados con la carpeta para el fragmento de creación de carpeta.

La tabla siguiente muestra los fragmentos necesarios para los flujos de acción y el sufijo del nombredel sistema esperado para dichos fragmentos:

Flujo de acción Artefacto Fragmento Sufijo

Importar Contenido Fragmento de importación _imp



Importar versión nueva Contenido Fragmento de importación

de versión nueva

_chk

Crear documento a

partir de una plantilla

Contenido Fragmento de importación

de versión nueva

_chk

Crear carpeta Carpeta Fragmento de creación de

carpeta

_create

ImportarEl flujo de acción Importar le permite importar contenido en tiempo de ejecución. Al importarel contenido, se proporcionan varios atributos, como el tipo de contenido, el formato y losmetadatos/atributos de contenido.

Puede agregar las siguientes entradas de flujo de acción en la pestaña Datos:

• content_types: filtra la lista de los tipos de contenido mostrados. Puede seleccionar el tipo decontenido del contenido que desea importar en tiempo de ejecución.

• default_content_type: el valor predeterminado del tipo de contenido al iniciar la ventana deimportación en tiempo de ejecución.

• content_formats: filtra la lista de los formatos de contenido mostrados. Puede seleccionar elformato de contenido del contenido que desea importar en tiempo de ejecución.

• default_content_format: el valor predeterminado del formato de contenido al iniciar la ventana deimportación en tiempo de ejecución.

• folder_id: el valor predeterminado del ID de la carpeta principal.

• custom_input_id: se utiliza para agregar las entradas personalizadas.

La configuración del botón Finalizar está vinculada a la acción de contenido de importaciónpersonalizada y puede utilizar las siguientes entradas:

• ID de carpeta: el ID de la carpeta principal donde el archivo se va a importar.

• ID de contenido: el ID único del archivo que ha proporcionado xCP REST al cargar el archivo en elservidor de aplicaciones. Se asigna al ID de archivo seleccionado en el widget Selector de archivos.

• Tipo de contenido: el tipo de contenido para el archivo. Se asigna al widget del tipo de contenido.

• Modelo: contiene toda la información sobre los metadatos para el archivo que desea importar.

Estos valores proporcionados se extraen a partir de los widgets de la página del paso.

Importar versión nuevaEl flujo de acción Importar nueva versión le permite importar la nueva versión de un contenido entiempo de ejecución. Permite la importación de contenido como la versión actual, la versión mayor, laversión menor y la versión ramificada. También permite retener los bloqueos después de importar lanueva versión. El flujo de acción Importar nueva versión es compatible con la importación de variosarchivos de nueva versión. Esto significa que se pueden seleccionar varios objetos de contenido yregistrar los objetos utilizando el asistente del flujo de acción.




• ID de objeto (r_object_id): el ID del objeto de contenido para el cual se va a importar la nuevaversión de contenido. Todas las entradas son multivalor.

• Tipo de contenido (r_object_type): el tipo de contenido para el cual se va a importar la nuevaversión.

• Nombre de objeto (object_name): escriba el nombre del objeto de contenido para el cual se va aimportar la nueva versión. Si no se indica el nombre del objeto, el nombre de archivo en el selectorde archivos aparece como nombre del objeto.

La configuración del botón Finalizar está vinculada a la acción de contenido de nueva versión deimportación personalizada y puede utilizar las siguientes entradas:

• ID: el ID del objeto de contenido para el cual se va a importar la nueva versión de contenido.• Modelo: los metadatos de la nueva versión del contenido.• Versión de registro: el número de la nueva versión del contenido.• Etiqueta de registro: la etiqueta de la nueva versión del contenido.• Bloqueo de retención: la etiqueta con la que se especifica si desea mantener el bloqueo en elnuevo contenido importado.

• Hacer actual: la etiqueta con la que se especifica si la nueva versión del contenido se convierteen la versión actual del contenido.

• ID de contenido: el ID único del archivo que ha proporcionado xCP REST al cargar el archivo en elservidor de aplicaciones. Se asigna al ID de archivo seleccionado en el widget Selector de archivos.

• Tipo de contenido: el tipo de contenido para el archivo.

Los valores de la configuración del botón Finalizar se proporcionan a partir de los widgetscorrespondientes de la página del paso o a partir de las entradas del flujo de acción.

Crear documento a partir de una plantillaEl flujo de acción Crear documento a partir de una plantilla le permite crear un documento basado enuna plantilla de documento existente para un tipo determinado.

Los flujos de acción Importar nueva versión y Crear documento utilizan el mismo fragmento. Notendrá que crear un segundo fragmento si ya se ha creado para el tipo de contenido.


• content_types: filtra la lista de plantillas mostradas por el tipo de contenido.• default_content_type: el tipo de contenido predeterminado de la plantilla.• content_formats: filtra la lista de plantillas de documento que se mostrarán en tiempo de ejecución.• default_content_format: el formato de contenido predeterminado de la plantilla.• folder_id: el valor predeterminado del ID de la carpeta principal donde se va a crear el documento.

La configuración del botón Finalizar está vinculada a la acción de contenido de base para la creaciónpersonalizada que puede utilizar entradas para el ID de carpeta (carpeta de destino), el tipo decontenido, el ID de plantilla de contenido (plantilla de documento de origen) y los atributos quecontienen el modelo del nuevo documento que se va a crear. Estos valores proporcionados se extraen apartir de los widgets de la página del paso.



Crear carpeta

El flujo de acción Crear carpeta le permite crear una carpeta en tiempo de ejecución. Se proporcionanvarios atributos como, el tipo de contenido y los metadatos del modelo, al crear una carpeta entiempo de ejecución.


• folder_types: filtra la lista de los tipos de carpetas mostrados. Puede seleccionar el tipo de carpetade la carpeta que desea crear en tiempo de ejecución.

• default_folder_type: el tipo de carpeta predeterminado de la carpeta de destino.

• default_folder_path: el valor predeterminado de la ruta de la carpeta de destino.

• parent_folder_id: el valor predeterminado del ID de la carpeta principal.

Puede agregar folder_id como la salida del flujo de acción en la pestaña Datos. Se trata del ID de lacarpeta creada al final del flujo de acción.

La configuración del botón Finalizar está vinculada a la acción de carpeta de base para la creaciónpersonalizada y puede utilizar entradas para el tipo de carpeta, el modelo y la carpeta principal. Estosvalores proporcionados se extraen a partir de los widgets de la página del paso.

Personalización

Todos los flujos de acción de ECM pueden clonarse y personalizarse mediante la creación de flujosde acción del nivel de aplicaciones nuevas. Puede personalizar las entradas del flujo de acción, laasignación de acción de datos y los widgets en las páginas del paso. Podrá personalizar el modelo(carpeta/contenido) de forma específica tras la creación de los fragmentos para cada tipo. Losfragmentos de los flujos de acción de ECM se incluyen dinámicamente mediante una expresión quetambién se puede personalizar.

Arrastrar y soltar

La función Arrastrar y soltar permite arrastrar y soltar un archivo desde el sistema local de archivosdirectamente en un widget de la aplicación. Desencadena un flujo de acción de importación si seconfigura un flujo de acción de importación en el menú contextual y está seleccionada la función. Lossiguientes widgets admiten la función de arrastrar y soltar:

• Árbol de contenido

• Vista de carpeta

• Lista de resultados

• Anexo

• Selector

• Selector de archivos



Arrastrar y soltar desde OutlookPuede arrastrar y soltar mensajes desde el cliente de correo de Outlook en un widget de la aplicación.La función de arrastrar y soltar solo se admite para objetos de correo electrónico en Outlook.

Los siguientes widgets admiten la función de arrastrar y soltar desde Outlook:

• Lista de resultados• Árbol de contenido• Vista de carpeta• Widget Selector• Anexo• Selector de archivos

Debe seleccionar Complemento de cliente para habilitar esta función.

En la siguiente tabla encontrará los navegadores, así como los archivos o los mensajes de correoelectrónico de escritorio admitidos cuando la opción Complemento de cliente está habilitada odeshabilitada.

Archivos o mensajes de correo electrónico admitidosNavegador web

Complemento de cliente

habilitado

Complemento de cliente

deshabilitado

Internet Explorer 9 S/S N/N

Internet Explorer 10 u 11 S/S S/N

Mozilla Firefox S/S S/N

Google Chrome S/S S/N

Puede seleccionar varios correos electrónicos para arrastrar y soltar. Al importar un correo electrónico,se pueden extraer y almacenar los metadatos en Docbase de Documentum.Compatibilidad conmensajes de Outlook, página 94 proporciona detalles sobre los metadatos de correo electrónico. Elproceso de arrastrar y soltar los mensajes de correo electrónico con anexos continúa como un objetoúnico.

Mapa de GoogleCon el widget de mapa de Google, puede agregar mapas a su aplicación.

Además de los mapas de carretera convencionales, el widget ofrece imágenes aéreas y de satélite.Principalmente, hay dos tipos de mapas disponibles a través de este widget:

• Mapas estáticos: aparecen en forma de imagen estática en tiempo de ejecución. En tiempo deejecución, no se pueden definir marcadores ni la dirección del centro en un mapa estático.

• Mapas interactivos: aparecen como mapas interactivos en los cuales se pueden establecer el nivelde zoom, el tipo de mapa, las coordenadas de latitud y longitud, y la dirección de la ubicación entiempo de ejecución. A medida que se aleja el mapa, aparecen los marcadores en él. Este es elmapa predeterminado.



.

Puede utilizar la función createMapMarkers para crear marcadores de un mapa. La función tienelos argumentos siguientes:

Argumento Tipo de datos Descripción

ids Cadena Especifique los ID para identificar los marcadores.

dirección Cadena Especifique las direcciones de los marcadores. Debe proporcionarcoordenadas de latitud/longitud o un argumento de dirección para definirlos marcadores en el mapa.

latitud Flotante Especifique las coordenadas de latitud de los marcadores. Debeproporcionar coordenadas de latitud/longitud o un argumento de direcciónpara definir los marcadores en el mapa.

longitud Flotante Especifique las coordenadas de longitud de los marcadores. Debeproporcionar coordenadas de latitud/longitud o un argumento de direcciónpara definir los marcadores en el mapa.

Título Cadena Asigne títulos al conjunto de marcadores. En tiempo de ejecución, estostítulos aparecen en forma de información sobre herramienta al pasar elratón por encima de los marcadores.

Utilice estas propiedades para obtener los valores del último marcador en el que se haya hecho clicen un mapa en tiempo de ejecución.

Propiedad Tipo de datos Descripción

ID del últimomarcadordonde se hahecho clic

Cadena Devuelve el identificador del marcador en el que el usuario final hayahecho clic por última vez.

Direccióndel últimomarcadordonde se hahecho clic

Cadena Devuelve la dirección del último marcador en el que el usuario final hayahecho clic.

Título delúltimomarcadordonde se hahecho clic

Cadena Devuelve el título del marcador en el que el usuario final haya hecho clicpor última vez.

Ejemplos

Para configurar el centro inicial donde encontrar la dirección en el mapa:

Initial center Address : ‘EMC Headquarters, Powder Springs, GA, USAIniital center Lat/Lng : ‘33.9178433,-84.7063289’

Para establecer el marcador mediante la función createMapMarkers:

Initial Markers/Set Marker :‘createGoogleMapMarkers({’e1’ }, {’EMC Headquarters,Echo Mill Drive, Powder Springs,GA, United States’}, {0.0}, {0.0}, {’EMC’})’



Mecanismo de transferencia de contenidoLas extensiones de explorador y los complementos son la forma de realizar transferencias avanzadasde contenido. Estos modos son compatibles en los navegadores Internet Explorer, Firefox y Chrome.

En tiempo de ejecución, el sistema solicita que se instale la extensión de navegador o un complementopara ejecutar a la transferencia de contenido de manera eficiente. La instalación es intuitiva y fácil deseguir. La aplicación local (origen) que contiene el contenido que deben transferirse puede conectarsecon el navegador web (destinatario) sin ningún inconveniente. Debe instalar la extensión y elcomplemento del navegador para que la transferencia de contenido se realice correctamente.

Para habilitar la transferencia avanzada de contenido: en la página Preferencias, seleccione la casillade verificación Habilitar complemento de cliente y para guardar la página, seleccione Guardar.

La extensión y el complemento de navegador han sustituido el Applet de Java, ya que no escompatibles con la mayoría de los navegadores. Para salvar la brecha, se introdujeron la extensióny los complementos del navegador para transferir grandes cantidades de datos de manera eficiente.Son compatibles con todos los tipos de contenido que admite el applet de Java, como los correoselectrónicos arrastrados y colocados desde Outlook.Nota: Para el navegador Internet Explorer, instale y habilite el complemento del navegador en primerlugar. Después de habilitar el complemento de navegador, debe reiniciar el navegador o abrir la mismapágina en una pestaña nueva para que se ejecute correctamente la transferencia de contenido.Nota:Para el navegador Internet Explorer, después de instalar el complemento, configure el nivel deseguridad del navegador como medio/alto y deshabilite el modo de protección mejorada.

Marco de trabajo de transferencia de contenidoEl marco de trabajo de transferencia de contenido (CTF) sin Java está desarrollado para proporcionarfunciones de transferencia de contenido enriquecido en xCP sin utilizar applets de Java. CTF consta dedos componentes principales:

• Extensiones de navegador de CTF

• Aplicación nativa de CTF

Extensiones de navegador de CTF

La extensión del navegador de CTF permite a la página web de la aplicación xCP comunicarse conuna aplicación nativa externa. No hay ningún mecanismo de cifrado, autenticación o transferencia decontenido en la capa de extensión de navegador. La aplicación nativa de CTF es responsable de latransferencia de contenido entre el sistema de archivos local y y el servidor de aplicaciones donde estéimplementada la aplicación de xCP. También interactúa con el sistema de archivos local. Para cadanavegador compatible, hay un componente de extensión de navegador correspondiente.

Los navegadores compatibles son:

Google Chrome: los usuarios finales deben descargar e instalar la extensión de navegador de CTFGoogle Javascript desde la tienda Google Web Store.

Mozilla Firefox: los usuarios finales deben descargar e instalar la extensión complemento delnavegador Firefox.

Internet Explorer: dado que Internet Explorer no es compatible con las extensiones del explorador enJavaScript, la extensión del navegador de CTF para IE se implementa como un Browser Helper Object



(BHO). El BHO se instala como complemento de Internet Explorer. El BHO de CTF se entrega enforma de instalador MSI desde xCP Designer.

Aplicación nativa de CTF

La aplicación nativa de CTF está implementada en lenguaje Python 3 y Python necesita una biblioteca.OpenSSL proporciona la capacidad HTTP/HTTPS subyacente en Python 3. La aplicación nativa deCTF está incluida en el archivo xcp-contentXfer<número_de_versión>.jar. El archivo JAR seencuentra en la carpeta web-inf\lib de la aplicación implementada. La aplicación es responsable de:

• Todas las operaciones de transferencia de contenido, incluidas las de importar, exportar, ver, editar,registrar y cancelar la retirada.

• Importar mensajes de correo electrónico desde la aplicación de escritorio de Microsoft Outlook.• Descarga de archivos en el sistema de archivos local.

Requisitos previosEstos son los requisitos previos necesarios para instalar el marco de trabajo de transferencia decontenido para estos navegadores:

Para los usuarios de Google Chrome y Firefox:

• Windows 7, Windows 8 y Windows 10• Es obligatorio disponer de privilegios de usuario• Cualquier versión reciente de Google Chrome posterior a la versión 45• Conexión a Internet para instalar la extensión de Chrome de CTF desde la Google Web Store.

Para los usuarios de Internet Explorer:

• Windows 7, Windows 8 y Windows 10• Es obligatorio disponer de privilegios de usuario administrador• 4.5 NET necesario• IE 11 solamente (puesto que Microsoft ya no ofrece soporte para Internet Explorer 10)• (Opcional) Conectividad a Internet

Consejos sobre solución de problemas• La aplicación xCP muestra la barra de instrucciones de instalación de la extensión de navegadorcuando la aplicación nativa de CTF o la extensión del navegador no están disponibles. Haga clicen Sí para volver a instalar y descartar la barra de instrucción.

• En algunos equipos, la ubicación del instalador descargado podría no ser obvia para el usuario. Sedeben indicar instrucciones especiales a los usuarios para que busquen el programa de instalacióndescargado en la ubicación de descarga del navegador e instalen las operaciones de transferencia decontenido de forma correcta.

• Si el usuario final opta por no instalar la extensión del navegador de CTF y la aplicación nativa deCTF, xCP vuelve al modo de cliente ligero para la transferencia de contenido.

• Para solucionar cualquier problema con la transferencia de contenido, compruebe el registro de laaplicación nativa de CTF y los registros de la consola de JavaScript de Chrome o del BHO de CTF.



Aspecto de widget

Aspecto de widget le permite ampliar la funcionalidad de un widget. Algunos aspectos estándisponibles como aspectos para usar de inmediato, etiquetas dinámicas y clases CSS dinámicas, y estosaspectos se pueden utilizar sin ningún inconveniente. Además, incluso puede utilizar los creados pordesarrolladores de widgets de terceros en xCP Designer. Antes de utilizar cualquier aspecto definidopersonalizado, debe agregar el aspecto como una librería en xCP Designer.

Hay 2 tipos de aspectos de widget: globales y no globales.

Por definición, los aspectos de widget globales son obligatorios y se asocian automáticamente con loswidgets que les correspondan. Esto significa la asociación con el aspecto no se puede eliminar delwidget. El sistema asocia aspectos globales de widget con el widget definido en una página o inclusouna página de dentro de una librería.

En el caso de aspectos de widget no globales, es necesario asociar manualmente los aspectos a loswidgets.

Los aspectos de widget de uso inmediato disponibles son los siguientes:

• Etiqueta dinámica: permite cambiar la etiqueta del widget de forma dinámica. Aplicable a todoslos widgets con el atributo Label o Title.

Aspecto de widget Asociar con un widget Atributo de widget

Árbol de contenido Título

Elemento de menú de navegación Etiqueta

Cuadro de columna Título

Grupo de pestañas Título

Casilla de verificación Etiqueta

Entrada de fecha/hora Etiqueta

Entrada de números Etiqueta

Entrada multivalor de fecha-hora Etiqueta

Entrada multivalor de número Etiqueta

Área de texto Etiqueta

Entrada de texto Etiqueta

Entrada multivalor de texto Etiqueta

Anexo Etiqueta

Lista desplegable Etiqueta

Lista desplegable con selección

múltiple

Etiqueta

Etiqueta dinámica



Aspecto de widget Asociar con un widget Atributo de widget

Selector de objetos Etiqueta

Grupo de opción Etiqueta

Lista de resultados Título

Columna de lista de resultados Título

Lista de resultados editable Título

Visualización del valor Etiqueta

Vista de carpeta Título

Visor Título

Menú de acción Etiqueta

Botón Etiqueta

• Clase CSS dinámica: permite cambiar la clase CSS del widget de forma dinámica. Aplicable atodos los widgets con el atributo CSS class.

Aspecto de widget Asociar con un widget

Árbol de contenido

Menú de navegación y elemento de menú denavegación

Cuadro de columna

Área de contenido

Contenedor de fragmentos de página

Pestaña y grupo de pestañas

Casilla de verificación

Comentarios

Entrada de fecha/hora

Entrada multivalor de fecha-hora

Entrada de números

Entrada multivalor de número

Área de texto

Entrada de texto

Entrada multivalor de texto

Anexo

Lista desplegable

Lista desplegable con selección múltiple

Selector de archivos

Clase CSS dinámica



Aspecto de widget Asociar con un widget

Selector de objetos

Grupo de opción

Lista de resultados

Lista de resultados editable

Widget de visualización de errores

Texto enriquecido

Visualización del valor

Vista de carpeta

Mapa de Google

Imagen

Visor

Menú de acción

Botón

Control de sesión de usuario

Paleta de esquema

Al agregar un widget o una serie de widgets al editor de diseños, los widgets aparecen en la paleta deesquema En tiempo de diseño, la paleta de esquema ofrece una vista general de los widgets disponiblespara configuración en el editor de diseño.

La secuencia de los widgets se mantiene en la paleta de esquema. Por lo tanto, cada vez que cambia lasecuencia de los widgets en el área del lienzo, la paleta de esquema mantiene la secuencia modificadade widgets. Los componentes subyacentes anidados del widget también se enumeran en el esquema.Al seleccionar el widget en la paleta de esquema, el widget correspondiente en el editor de diseño sevuelve activo y resaltado en el editor y viceversa. De forma predeterminada, la paleta de esquemaaparece como una ventana contraída.


Capítulo 10Configurar acciones de la interfaz deusuario



Tareas

Crear un botón1. En la paletaWidgets, arrastre un widget Botón y suéltelo en un cuadro de columna en un editor

de diseño.2. En el cuadro de diálogo Botón, especifique las propiedades básicas del widget tal y como se


Campo Descripción

Invocar Define la acción que va a invocar este botón.

Etiqueta de botón Escriba el texto que aparecerá en el botón. Después de realizar unaselección en el campo Invocar, la etiqueta cambia a la etiqueta de laacción.

3. Haga clic en Aceptar.4. Configure el widget de botón tal y como se describe en Configurar un botón, página 423.

Configurar un botón1. Haga clic en el widget Botón.2. En el área Conceptos básicos de la pestaña General en la vista Propiedades, configure el botón


Campo Descripción

ID ID del widget.

Etiqueta Etiqueta del botón. Cuando la propiedad de invocación está definida, la etiquetase cambia por la etiqueta de la acción. También puede modificar la etiquetadirectamente en el editor de diseño.


Configurar acciones de la interfaz de usuario

Campo Descripción

Origen de icono Seleccione Imagen o Glifo de fuente según sea necesario.

• Para Imagen, seleccione la imagen deseada con Selector de imágenes.

• Para Glifo de fuente, indique el código de carácterUnicode correspondiente al glifo, en números decimales.También puede proporcionar el glifo anteponiendo una x alnúmero. De forma predeterminada, se utiliza FontAwesome(http://fortawesome.github.IO/Font-Awesome/) como la fuente de glifo,pero se puede reemplazar indicando el valor de la fuente de glifo conel formato códigoDeGlifo@nombreDeFuente. Si la fuente no es unafuente disponible normalmente en el sistema cliente, asegúrese deincluirla con el tema personalizado para la aplicación. Por ejemplo:61461 o xf015 proporciona un icono de inicio.36@Arial proporciona el símbolo $ en fuente Arial.

Texto de la insignia Texto que aparece en la parte superior del widget. Utilice el editor de expresionespara definir el texto.


Información adicional que se muestra al pasar el ratón por encima del widget.

3. En el área Acciones, defina las acciones del botón tal y como se describe en la tabla siguiente:

Campo Descripción

Invocar Seleccione la acción para invocar en tiempo de ejecución cuando un usuario finalhaga clic en el botón. La lista de selecciones varía según el alcance o tipo del editorde diseño, como una página o tarea.

Después de seleccionar la acción, realice las selecciones necesarias para completarla acción. Por ejemplo, al seleccionar Instancia del servicio de datos se requierela selección de la instancia del servicio de datos que se va a invocar. Si la instanciadel servicio de datos que desea seleccionar no existe, agréguela desde el panelInteracciones del editor de diseño.

Comentarios Seleccione los mensajes que el sistema devuelve en respuesta a la acción realizadapor el usuario final.

Una vez hecho,vaya a

Seleccione la ubicación para redirigir el explorador tras la realización de la acción.

4. Si se ha seleccionado la acción Ir a la página o Instancia de servicio de datos y una páginaespecífica en el ajuste Una vez hecho, vaya a para invocar en tiempo de ejecución en el áreaAcción, especifique los valores en Selección de página tal como se describe en la tabla siguiente:

Campo Descripción




http://fortawesome.github.io/Font-Awesome/


Campo Descripción



URL Escriba una expresión para constituya la URL que define qué página debe apareceren tiempo de ejecución. Las direcciones URL pueden incluir http, https o ftp. Si nose especifica ningún identificador de protocolo, el sistema asume el protocolo http deforma predeterminada.


Seleccione si el vínculo de destino se abre en una pestaña nueva al hacer clic en él.




5. En la pestaña Estilo, seleccione las opciones de estilo disponibles para el widget Botón.

Campo Descripción

Escala Tamaño del botón como pequeño, mediano o grande. El valorpredeterminado es pequeño. El tamaño permitido del icono imagen quese puede proporcionar para el botón depende de la escala del botón. Sies pequeño, el tamaño máximo del icono de imagen es 16 x 16 px,mediano de 24 x 24 px y grande de 32 x 32 px.

Ancho Ancho del botón.

• automático: ancho natural del botón en función del texto. Es el valorpredeterminado.

• px: escriba una anchura fija, en píxeles, para el botón.

Alto Altura del botón.

• automático: alto natural del botón en función del texto. Es el valorpredeterminado.

• px: escriba una altura fija, en píxeles, para el botón.



Campo Descripción

Posición de imagen/glifo: Ubicación de la imagen o el glifo, como izquierda, derecha, superior oinferior. El valor predeterminado es izquierda.

Posición de la insignia Ubicación del texto de la insignia como Superior izquierda, Superiorderecha, Superior centro, Inferior izquierda, Inferior derecha, Inferiorcentro, Medio izquierdo, Medio derecha. El valor predeterminado esSuperior derecha.

Clase CSS Especifique un nombre de clase de una hoja de estilo en cascada (CSS)para aplicarla a la pestaña.












Agregar un botón de acción Crear a una página demodelo de objeto1. En la paletaWidgets, arrastre un widget Botón y suéltelo en una página de modelo de objeto.

2. En el cuadro de diálogo Botón, en el campo Invocar, seleccione Crear.

3. En el campo Etiqueta de botón, escriba el texto que aparecerá en el botón.


5. En el área Conceptos básicos de la pestaña General de la vista Propiedades, defina el botón.

6. En el área Acciones, especifique otras acciones del botón según se define en la tabla siguiente:



Campo Descripción

Comentarios Seleccione las acciones de comentarios.


Seleccione una página a la que redirigir el explorador una vez finalizada la acción.

• Página actual: el explorador permanece en la página actual.

• Página específica (<modelo de objeto>): <modelo de objeto> es el nombredel modelo para el cual se crea la página. Seleccione una página de modelo deobjeto disponible.

• Página de aplicaciones: seleccione una página de aplicación disponible.

Agregar un botón de acción Actualizar a una páginade modelo de objeto1. En la paletaWidgets, arrastre un widget Botón y suéltelo en una página de modelo de objeto.

2. En el cuadro de diálogo Botón, en el campo Invocar, seleccione Actualizar.




6. En el área Acciones, especifique otras acciones del botón según se define en la tabla siguiente:

Campo Descripción

Comentarios Seleccione las acciones de comentarios.



• Página actual: el explorador permanece en la página actual.

• Página específica (<modelo de objeto>): seleccione una página de modelo deobjeto disponible. El <modelo de objeto> es el nombre del modelo para el quese crea la página.

• Página de aplicaciones: seleccione una página de aplicación disponible.

Agregar un botón de acción Eliminar a una páginade modelo de objeto1. En la paletaWidgets, arrastre un widget Botón y suéltelo en una página de modelo de objeto.

2. En el cuadro de diálogo Botón, en el campo Invocar, seleccione Eliminar.


4. Haga clic en Aceptar para crear el widget de botón.


6. En el área Acciones, defina acciones adicionales del botón, tal y como se describe en la tablasiguiente:



Campo Descripción

Comentarios Seleccione las opciones de confirmación y notificación.



No configure un botón Eliminar para redirigir a una página específica de visualizacióno de edición.

Si se ha seleccionado la opción Página actual, se redirige al usuario final a la páginaprincipal si la página anterior era la página de inicio de sesión. De lo contrario, seredirige al usuario a la página anterior.

Crear un flujo de acción1. En el navegador de Interfaz de usuario, seleccione Nuevo→Flujo de acción.2. En el campo Etiqueta, escriba una etiqueta para identificar el flujo de acción.3. En el campo Alcance, seleccione Aplicación oModelo de objetos específico.4. Si selecciona, Aplicación:

a. Seleccione la Acción en la lista desplegable. Si selecciona Personalizado, especifique losiguiente:

1. En el cuadro de texto Contrato de datos, haga clic en Examinar y seleccione la instanciadel servicio de datos para usar en este flujo de acción.

2. En el cuadro de texto Número de pasos , especifique el número de secuencias de pasosreutilizables.

5. Si seleccionaModelo de objetos específico:a. En el campoModelo de objetos, haga clic en Examinar y seleccione un modelo de objetos.b. Seleccione la Acción y especifique las propiedades del flujo de acción tal y como se describe

en la siguiente tabla:

Acción Pasos para realizar

Personalizar 1. En el cuadro de texto Contrato de datos, haga clic Examinar y seleccione lainteracción para utilizar en este flujo de acción.

2. En el cuadro de texto Número de pasos , especifique el número de secuencias depasos reutilizables. Puede especificar un máximo de cinco, página 429 pasos.

Selector En el cuadro de texto Contrato de origen de datos, haga clic Examinar y seleccionela interacción para utilizar en este flujo de acción.

Relacionar 1. En el campo Relación, seleccione la relación de objeto o contenido que se va autilizar en este flujo de acción.

2. En el cuadro de texto Contrato de datos, haga clic en Examinar y seleccione lainstancia del servicio de datos para usar en este flujo de acción.

6. Haga clic en Finalizar.El artefacto de flujo de acción contiene dos nodos como mínimo: Modelo y Paso 1.

Crear un flujo de acción para agregar relaciones1. Cree un Flujo de acción con la siguiente configuración:

a. En el campo Acción, seleccione la acción de datos Relacionar.



b. En el campo Relación, seleccione la relación de objeto o contenido que se va a utilizar eneste flujo de acción.

2. Para configurar los pasos, realice lo siguiente:a. Haga doble clic en el nodo Paso 1 para crear el paso 1 del flujo de acción.b. Agregue una lista de resultados para permitir que el usuario final busque (o examine) objetos o

contenido del modelo relacionado.

Por ejemplo, para agregar Garantía como una relación con Cliente, seleccione una instancia deservicio de datos que devuelva garantías al crear la lista de resultados. Para agregar una listade resultados que incluya una búsqueda de objetos, seleccione una instancia del servicio dedatos con entradas que devuelvan garantías.

En Crear un paso en un flujo de acción, página 432 se proporcionan detalles adicionales.

c. Si su relación tiene metadatos, haga doble clic en el nodo Paso 2 para editar el paso 2 del flujode acción y configure los campos de metadatos que el usuario final completará.

d. Configure los campos de metadatos que el usuario final completará.3. Para crear pasos adicionales en el flujo de acción, haga doble clic en el nodoModelo para acceder

al editor Action Flow Model (Modelo de flujo de acción).4. Para comprobar este flujo de acción en tiempo de ejecución, realice lo siguiente:

a. Guarde y ejecute la aplicación.b. Vaya a una página de aplicación con una lista de objetos de negocio, como Clientes.c. Haga clic en cualquier parte de una fila para seleccionarla (por ejemplo, John Smith).d. Haga clic con el botón derecho en la fila seleccionada y seleccione el flujo de acción en el menú

(por ejemplo, Agregar material adjunto a Cliente).e. En el primer cuadro de diálogo del flujo de acción, busque el objeto de negocio relacionado

como, por ejemplo, Garantía.f. En la lista de resultados, seleccione uno de los resultados (por ejemplo, Edificio de oficinas

en calle principal) y haga clic en Siguiente.g. Si tiene metadatos, en el segundo cuadro de diálogo de flujo de acción, introduzca información

en los campos (por ejemplo, en Valor de garantía y Fecha de valoración).h. Complete los demás cuadros de diálogo y, a continuación, haga clic en Finalizar.

Si la acción de datos es correcta, el sistema crea una relación entre las dos instancias de objetode negocio o la instancia de objeto de negocio y el contenido, e incluye cualquier metadatode relación. En este ejemplo, el sistema crea una relación entre el cliente John Smith y elmaterial adjunto Edificio de oficinas en calle principal. También puede mostrar los valoresValor de material adjunto y Fecha de valoración.

Redactar modelo de un flujo de acciónEstos pasos se utilizan para crear el modelo de flujo de acción personalizado y los flujos de acción deimportación personalizada, nueva carpeta personalizada, importación personalizada de nueva versión ycreación personalizada de nuevo documento.1. En el navegador de Interfaz de usuario, haga doble clic en el nodo Modelo de un flujo de

acción definido.2. En la pestaña Conceptos básicos, defina los conceptos básicos del flujo de acción tal y como se




Campo Descripción

Etiqueta Escriba una etiqueta para el flujo de acción.

Nombre delsistema

El nombre del sistema se utiliza internamente para identificar de forma única elflujo de acción.


Alto Escriba la altura del cuadro de diálogo del paso.

Ancho Escriba la anchura del cuadro de diálogo del paso.

Pasos Haga clic en Agregar entrada para agregar un paso y haga clic en Quitar entradapara quitar un paso del flujo de acción.

De forma predeterminada, el sistema crea un flujo de acción con un máximo de cincopasos. Puede aumentar el número de pasos después de que el sistema haya creadoun flujo de acción. Vaya a Flujo de acción >Modelo. En la pestaña Conceptosbásicos, haga clic en Agregar entrada para agregar tantos pasos como desee.

3. En la pestaña Datos del área Entradas de flujo de acción, defina una entrada. Según el servicio dedatos especificado al crear el flujo de acción personalizada, se muestran las Entradas de flujo deacción. Si no ha especificado un servicio de datos al crear el flujo de acción personalizada o sidesea agregar más entradas de flujo de acción, haga clic Agregar entrada.

Las Entradas de flujo de acción aparecen ya rellenadas para los flujos de acción de importaciónpersonalizada, nueva carpeta personalizada, importación personalizada de nueva versión y creaciónpersonalizada de nuevo documento. Puede agregar más Entradas de flujo de acción haciendoclic en Agregar entrada.

Especifique las propiedades de entrada tal y como se describe en la siguiente tabla:

Campo Descripción

Nombre El nombre del sistema se utiliza internamente para identificar de forma única laentrada del flujo de acción.

Tipo o modelo Haga clic Tipo y seleccione un tipo de la lista desplegable, o haga clicModelo yhaga clic en Selector para seleccionar un modelo de objetos.

Tiene variosvalores


Valor Utilice el editor de expresiones para definir la asignación de datos para la entrada.

4. En el área Salidas de flujo de acción, haga clic Agregar entrada y especifique las propiedades desalida tal y como se describe en la siguiente tabla:

Las Salidas de flujo de acción se rellenan previamente para el flujo de acción de nueva carpetapersonalizada. Puede agregar más Entradas de flujo de acción haciendo clic en Agregar entrada.

Campo Descripción

Nombre El nombre del sistema se utiliza internamente para identificar de forma única lasalida del flujo de acción.

Tipo o modelo Haga clic Tipo y seleccione un tipo de la lista desplegable, o haga clicModelo yhaga clic en Selector para seleccionar un modelo de objetos.



Campo Descripción

Tiene variosvalores


Asignación devalores o datos

Utilice el editor de expresiones para definir la asignación de datos para la salida.

5. En la pestaña Exploración, especifique lo siguiente:

a. Puede definir la exploración del flujo de acción, como se describe a continuación.

Campo Descripción

Primer paso Seleccione el paso de la lista desplegable Página del paso o utilice unaExpresión para determinar el primer paso de su flujo de acción. Por ejemplo,actionflow.dataservices.statelessproc_initiate_sta-less_ds.firstStepId.

Etiqueta del botónFinalizar

Especifique la etiqueta en el campo Etiqueta o utilice una expresión para definirla etiqueta del botón Finalizar. La etiqueta predeterminada es Finalizar.

Acción del botónFinalizar

Seleccione la Instancia del servicio de datos de la lista desplegable para asignarcon el botón Finalizar. Si la instancia del servicio de datos que desea seleccionarno existe, agréguela a la sección Interacciones del editor de diseño.

Botón Finalizaractivado cuandocomportamiento

Especifique o haga clic en Selector en el campo Habilitado cuando para definircuándo desea que se active el botón Finalizar en su flujo de acción.

Botón Finalizaroculto cuandocomportamiento

Escriba una expresión que evalúe las condiciones, lo que, si es verdadero, impideque el usuario final vea el widget. Si no se introduce ninguna expresión, el botónFinalizar está visible.

Etiqueta de botónCancelar

Especifique la etiqueta en el campo Etiqueta o utilice una expresión para definirla etiqueta del botón Cancelar. La etiqueta predeterminada Cancelar.

Botón Cancelaroculto cuandocomportamiento

Escriba una expresión que evalúe las condiciones, lo que, si es verdadero, impideque el usuario final vea el widget. Si no se introduce ninguna expresión, el botónCancelar está visible.

b. Haga clic en Interacciones para agregar el servicio de datos. Según el servicio de datosseleccionado, especifique las propiedades. En el áreaMensajes personalizados, puede definirlos mensajes personalizados para el éxito o error mediante el editor de expresiones. SeleccioneDeshabilitar mensaje de error estándar para deshabilitar los mensajes de error estándarpara el servicio de datos. Debe vincular estos mensajes de error personalizados al widgetVisualización de errores. Si se han especificado mensajes personalizados (éxito o error), elsistema muestra los mensajes de éxito o de error estándar.

6. En la pestaña Eventos de IU, agregue Evento de IU, página 369.

De forma predeterminada, todos los eventos del nivel de aplicación y flujo de acción son visibles yse pueden configurar. Pero para el flujo de acción, algunos de los eventos no son relevantes.Por ejemplo:

• Para las entradas de flujo de acción, en el árbol de contexto se muestran todos los eventossimilares a carga y descarga de página. Estos eventos no se aplican al flujo de acción.



Crear un paso en un flujo de acciónEstos pasos se utilizan para crear un paso para el flujo de acción personalizado y los flujos de acción deimportación personalizada, nueva carpeta personalizada, importación personalizada de nueva versión ycreación personalizada de nuevo documento.1. En el navegador de Interfaz de usuario, haga doble clic en el nodo Paso de un flujo de acción

definido.2. En la pestaña Conceptos básicos, especifique una descripción del paso de flujo de acción.3. En la pestaña Diseño, haga lo siguiente:

a. Configure los widgets predeterminados mostrados en la página de diseño. si es necesario.b. Puede arrastrar y soltar otros widgets de la paleta Widgets en la página de diseño y configurarlos.c. Expanda Interacciones y haga clic en Nueva interacción para agregar una nueva interacción a

su paso. Defina las propiedades de Interacciones de la manera siguiente:

Campo Descripción

General En el área Conceptos básicos, especifique la etiqueta.

En el áreaMensajes personalizados, puede definir los mensajespersonalizados para el éxito o error mediante el editor deexpresiones. Seleccione Deshabilitar mensaje de error estándarpara desactivar los mensajes de error estándar para el servicio dedatos. Debe vincular estos mensajes de error personalizados alwidget Visualización de errores. Si se han especificado mensajespersonalizados (éxito o error), el sistema muestra los mensajes deéxito o de error estándar.

Entradas Haga doble clic en el atributo Entradas y explorepara definir la asignación de entradas. Por ejemplo,actionflow.Inputs.folder_id.

4. En la pestaña Navegación, defina el botón Siguiente:a. En el área Comportamiento, especifique o haga clic en Examinar en el campo Habilitado

cuando para definir cuándo desea habilitar el botón Siguiente.b. En el área Acción, seleccione el paso de la lista desplegable Ir a o utilice una expresión para

determinar el siguiente paso.5. En la pestaña Eventos de IU, agregue evento de IU, página 369.

De forma predeterminada, todos los eventos de aplicación y flujo están visibles y se puedenconfigurar. Pero para el flujo de acción, algunos de los eventos no son relevantes. Por ejemplo:

• Para las entradas de flujo de acción, en el árbol de contexto se muestran todos los eventossimilares a carga y descarga de página. Estos eventos no se aplican al flujo de acción.

Eliminar un flujo de acción1. En el navegador Interfaz de usuario, abra el nodo del modelo de objeto de negocio que contiene el

flujo de acción que se va a eliminar.2. Haga clic con el botón derecho en el flujo de acción para eliminarlo y seleccione Eliminar.

Al eliminar el artefacto de flujo de acción se eliminarán todos los elementos contenidos, incluidosel modelo y todos los pasos.



Conceptos

Flujo de acción

Un flujo de acción es una secuencia reutilizable de pasos que un usuario final realiza en la aplicación.Puede definir un flujo de acción y reutilizarlo en varios contextos. En tiempo de ejecución, el flujo deacción presenta a los usuarios finales un solo paso o varios pasos para ayudarles en la ejecución de unatarea de negocio. Por ejemplo, puede crear un flujo de acción que permita a los usuarios finales agregargarantías a un cliente. Puede reutilizar el mismo flujo de acción en una aplicación de procesamiento depréstamos para vehículos o en una aplicación para hipotecas. Un flujo de acción le permite:

• Controlar el número de pasos

• Ordenar el flujo de pasos

• Definir la última acción ejecutada al final del flujo

• Permitir que se etiquete el botón Finalizar

• Definir la etiqueta del botón Cancelar

• Definir la visibilidad de los botones Terminar y Cancelar

• Habilitar o deshabilitar la navegación al paso siguiente y final según la condición

• Configurar la expresión para devolver las páginas de pasos, la primera página o la siguiente página

Puede especificar la secuencia de pasos del flujo de acción, o puede utilizar una expresión paradeterminar la secuencia de pasos de forma dinámica según la evaluación basada en la expresión entiempo de ejecución. Por ejemplo, si tiene un empleado del banco que desea abrir una cuenta deahorros y una cuenta de préstamo. Cada cuenta requiere información distinta. Puede crear un flujo deacción que contenga todos los pasos necesarios para abrir una cuenta. El empleado del banco podríaejecutar los pasos del 1 al 6 para abrir la cuenta de préstamo, pero ejecutar solo los pasos del 1 al 3 yluego el paso 6 para abrir la cuenta de ahorros.

Al crear una expresión mediante el selector, el flujo de acción también aparece como los datos decontexto. Es posible seleccionar el contexto de datos, las entradas, los pasos y la instancia de serviciode datos para un flujo de acción.

Al configurar los eventos de IU para el flujo de acción, verá estos eventos:

Eventos Descripción

En la navegación de página siguiente del flujo deacción

El evento se desencadena al acceder a la páginasiguiente del flujo de acción.

En la navegación de página anterior del flujo de acción El evento se desencadena al acceder a la páginaanterior del flujo de acción.

En la carga de la página de paso de flujo de acción El evento se desencadena al lanzar la página del paso.

En el lanzamiento del flujo de acción El evento se desencadena al lanzar el flujo de acción.


Capítulo 11

Usar visores


• Conceptos

Conceptos

Visores compatiblesLos usuarios finales pueden utilizar visores para ver documentos, gráficos y otros archivos de unaaplicación. Algunos visores admiten anotaciones, texto o gráficos superpuestos en un documento ouna imagen.

En la tabla siguiente se muestra una lista de los visores compatibles:

Visor Descripción

Visor de contenido de xCP Admite los formatos de archivo pdf, tiff, jpeg, gif, png, bmp, los formatosde Microsoft Office, y correo electrónico y documentos adjuntos (.msg ycorreo EMC).

Admite un tipo de anotación denominada comentarios para anotacionesdonde los comentarios aparecen en un círculo con los números que indicanla secuencia.

No es compatible con otros tipos de anotaciones como líneas, flechas yformas.

Admite la interacción de un usuario final con todas las anotaciones o solocon sus propias anotaciones.

Visor de medios de xCP Admite los formatos de archivo de vídeo mpeg-4v, ogg, webm, 3gp, 3g2, asf,avi, flv, f4v, mpeg, m4v, quicktime y wmv.

Utilice Content Transformation Services (CTS) para transformar un vídeo enun formato común. CTS permite a los usuarios finales capturar fotogramasclave de vídeo a intervalos de tiempo concretos. Dependiendo del explorador,los vídeos se pueden visualizar en modo de ventana completa o en modode pantalla completa.

Complemento de escritorio dexCP

Admite los formatos de archivo tiff, jpeg, gif, png, bmp, rtf, crtext y deMicrosoft Office.

Admite la interacción de un usuario final con todas las anotaciones o solocon sus propias anotaciones.

El complemento de escritorio de xCP solo admite Microsoft Internet Explorer.


Usar visores

Visor Descripción

Explorador Admite los formatos pdf, jpeg, gif, png y crtext en Firefox e Internet Explorer.Internet Explorer también admite formatos de Microsoft Office.

Adobe Acrobat Reader Admite pdf.

Note: No hay ningún soporte para visualizar el tipo de objeto xForms en Viewer.

Cuándo habilitar clientes DFC con privilegiosOtorgue privilegios temporales en tiempo de ejecución cuando un usuario final:

• Modifica una página y no tiene suficientes permisos para trabajar con comentarios creados porotros usuarios finales.

• Mueve una página a una nueva ubicación en el documento y mantiene la asociación entre lapágina y los comentarios.

EMC Documentum Administrator User Guide (Guía de usuario de EMC Documentum Administrator)proporciona instrucciones sobre la activación de los clientes de DFC con privilegios.

EMC Documentum xCelerated Composition Platform Deployment Guide (Guía de implementaciónde EMC Documentum xCelerated Composition Platform) contiene instrucciones de solución deproblemas.

Eventos de aplicación del visorLos usuarios finales desencadenan eventos de aplicación al realizar ciertas operaciones en el visor.Cuando se registra un evento de aplicación, el seguimiento de auditoría registra el momento en que seproduce el evento. La EMC Documentum Content Server Administration and Configuration Guide(Guía de configuración y administración de EMC Documentum Content Server) contiene instruccionessobre el registro de eventos de aplicación del visor. Utilice Documentum Administrator para verel seguimiento de auditoría.

La siguiente tabla contiene una lista de eventos de aplicación del visor:

Nombre de evento El evento se desencadena cuando el usuario final

ivf_print Imprime un documento completo o parcial desde elvisor.

Para Visor de contenido de xCP, la información deseguimiento de auditoría se captura incluso si elusuario final hace clic en Cancelar en el cuadro dediálogo de impresión del explorador. Esta limitaciónsignifica que el seguimiento de auditoría registra unevento de impresión cuando el usuario final cancelael trabajo de impresión.

ivf_export Exporta un documento desde el visor.

ivf_page_deletion Elimina páginas de un documento.

ivf_page_extraction Extrae páginas de un documento.


Usar visores

Nombre de evento El evento se desencadena cuando el usuario final

ivf_page_insertion Inserta páginas en un documento.

ivf_page_reorder Reordene páginas en un documento.


Capítulo 12

Crear expresiones



Tareas

Crear una expresión mediante AutocompletarLa función Autocompletar filtra los datos de contexto disponibles para crear una expresión mientrasescribe en el editor de expresiones. En una lista de datos filtrados, los nombres del sistema del modelode objeto aparecen entre paréntesis junto a las etiquetas del modelo de objeto.1. Haga clic en el editor.2. Pulse Ctrl + barra espaciadora.

Si el editor está vacío, aparecerá el primer nivel de datos disponibles para crear la expresión.

3. Elija una de las siguientes opciones para buscar elementos de datos en la lista:• Utilice las flechas arriba y abajo.• Comience a escribir en el editor.

4. Después de seleccionar un elemento de datos en la lista, presione Intro para incluirlo en el editor.

Tenga en cuenta los siguientes puntos al utilizar la función autocompletar:

• Si un filtro solo produce un elemento de datos, el sistema agregará los elementos de datos al editorde forma automática.

• Si la lista autocompletar está abierta y escribe un punto después de un tipo de objeto en el editor, losatributos del tipo de objeto aparecerán en la lista.

• Para tipos de objetos y atributos, solo los nombres del sistema aparecen en el editor.

• Para los widgets, agregue .value al final del nombre del widget.

Crear una expresión mediante el selectorEl selector restringe los datos disponibles para crear una expresión para el contexto que seleccione.Cuando cambie el tamaño del selector, el sistema mantendrá el tamaño del cuadro de diálogo que hayadefinido al abrirlo para la próxima vez.


Crear expresiones

1. Haga clic en Seleccionar.2. Para utilizar datos de contexto en la expresión:

a. Haga clic en Datos de contexto.b. Seleccione el contexto de datos. Por ejemplo, seleccione un objeto de negocio.c. Seleccione un elemento de datos para el contexto. Por ejemplo, seleccione un atributo de

objeto de negocio.d. Haga clic en Aceptar.

3. Para utilizar una función en la expresión:a. Haga clic en Funciones.b. Seleccione una categoría de función. Por ejemplo, seleccione Cadena.

Utilice la función htmlEncode en los widgets de visualización para evitar vulnerabilidadesde secuencias a través de sitios cuando se utilizan valores introducidos por el usuario finalcomo parte de una expresión de HTML. El sistema automáticamente codifica las expresionesde cadena.

c. Seleccione una función.d. Haga clic en Aceptar.e. Resalte el valor de argumento predeterminado que aparece entre paréntesis.f. Pulse Ctrl + barra espaciadora para mostrar los datos de contexto y seleccione un valor

de argumento.4. Para utilizar un parámetro en la expresión:

a. Haga clic en Parámetros.b. En la parte superior del área del selector, seleccione el proyecto que contiene el parámetro.c. En el área inferior, seleccione el parámetro.d. Haga clic en Aceptar.

5. Para utilizar una lista desplegable en la expresión:a. Haga clic en Listas desplegables.b. En la parte superior del área del selector, seleccione el proyecto que contiene la lista desplegable.c. En el área inferior, seleccione la lista desplegable.d. Haga clic en Aceptar.

Conceptos

ExpresionesPuede crear expresiones que el sistema evalúa en tiempo de ejecución para comparar y establecer losdatos de aplicación. Una expresión puede incluir literales codificados de forma rígida y datos delcontexto en el que se crea la expresión. La expresión se evalúa en un tipo que sea coherente con elmodo en que se está utilizando esta. Por ejemplo, utilice una expresión booleana para devolver unvalor para una condición.

En la tabla siguiente se describen situaciones en las que se pueden crear expresiones:


Crear expresiones

Situación Descripción

Definir un valor de atributo predeterminado Devuelve un valor inicial predeterminado para unatributo de un solo valor o de varios valores de unobjeto de negocio, objeto de contenido o una carpeta.El valor aparece de forma predeterminada cuando elusuario final crea un objeto de negocio, un objeto decontenido o una carpeta y no especifica un valor.

Definir los valores de atributo predeterminados,página 77 proporciona las expresiones de muestra.

Definir una condición para crear un evento de negocio Crea un evento de negocio para los desencadenadoresde usuario final como a creación y actualización deun objeto de negocio, un objeto de contenido o unacarpeta. Si la expresión devuelve un valor verdaderopara la condición, los datos de eventos de negocio sepueden utilizar en los informes o iniciar un proceso.

Eventos de negocio, página 78 proporciona lasexpresiones de condición de muestra.

Crear una columna calculada en una consulta histórica Agrega una columna a un conjunto de datos deconsulta histórica que compara valores, aplicaformatos a valores y realiza cálculos.

Ejemplos de columnas calculadas, página 288proporciona las expresiones de muestra.

Crear una columna calculada en una consultahistórica, página 228 proporciona el procedimientopara la creación de columnas calculadas.

Configurar entradas predefinidas en consultas Define los criterios de ocultos para filtrar conjuntosde datos de consulta antes de que se muestren a losusuarios finales.

Ejemplos de entradas predefinidas para fechasrelativas, página 262 proporciona las expresiones demuestra.

Configurar entradas predefinidas, página 222proporciona el procedimiento para configurar entradaspredefinidas.

Definir una duración al crear un temporizador deactividad de proceso

Calcula la duración de un temporizador de actividadesde proceso basándose en una expresión. El resultadode la expresión es un entero que se utiliza paracalcular la caducidad del temporizador.

Ejemplos de expresiones de duración detemporizadores de actividad, página 209 proporcionalas expresiones de muestra.

Definir temporizadores de actividad, página193 proporciona el procedimiento para crear untemporizador en una actividad.


Crear expresiones

Situación Descripción

Configurar un valor inicial de un widget Devuelve un valor inicial predeterminado para unwidget. El valor aparece de forma predeterminadacuando el usuario final abre la página en la queaparece el widget.

Determinar el comportamiento de un widget Define las condiciones en las que un widget esinvisible o está deshabilitado para el usuario final.

Determinar qué fragmento de página aparece para unusuario final en la aplicación en tiempo de ejecución

Le permite crear una interfaz de usuario dinámicade la aplicación en tiempo de ejecución mediantela definición de la condición en la que aparece unfragmento de página para un usuario final.

Tenga en cuenta estas prácticas recomendadas al crear una expresión:

• Si una expresión larga se ajusta a la siguiente línea en el editor de expresiones, este podría indicarun error mediante la inserción de una línea de color rojo debajo de parte de la expresión, aunqueesta sea válida. Para borrar la línea, utilice el divisor ubicado junto al navegador de artefactos paraexpandir el ancho del editor de expresiones a fin de que la expresión no se ajuste a la siguiente línea.

• Utilice llaves para incluir un atributo de varios valores en la expresión. Por ejemplo:

{1,2,3,4,5}

Puede utilizar operadores, funciones y datos de contexto entre corchetes.

• Para incluir un elemento concreto de un atributo multivalor en una expresión, utilice los corchetespara extraer el elemento del atributo. En la expresión customer.keywords[0] = = ’VIP’,"customer" es el objeto de negocio, "keywords" es un atributo del objeto de negocio y [0] es elelemento. El sistema trata el atributo y el elemento como un solo valor al evaluar la expresión.

• Utilice las comillas sencillas para las cadenas literales. Por ejemplo:

’perro’

• Utilice los paréntesis para agrupar datos y establecer prioridad. Por ejemplo:

(5 + 3) * 4

• Al comparar valores flotantes en una expresión, utilice la función round(valor flotante, precisión)para redondear los valores flotantes a un punto decimal preciso.

Operadores

El editor de expresiones admite los operadores que aparecen en la tabla siguiente:

Tipo Operador

+

-

/

Matemático

*


Crear expresiones

Tipo Operador

>

>=

<

<=

==

Comparación

!=

AND

OR

Lógica booleana

NOT

Puede utilizar el operador + para concatenar tipos de datos de cadena, flotantes y de entero en lasexpresiones. El editor de expresiones concatena los tipos de datos de la siguiente forma:

• cadena + cadena = cadena

• flotante + flotante = flotante

• entero + entero = entero

• cadena + entero = cadena

• cadena + flotante = cadena

• flotante + entero = flotante

Funciones

xCP Designer cuenta con funciones integradas que puede utilizar en las expresiones, o bien puededesarrollar funciones personalizadas en Java o JavaScript y, a continuación, agregarlas a xCP Designer.Las funciones en Java se evalúan en un contexto de servidor y las funciones basadas en JavaScript lohacen en un explorador que se evalúa en un contexto de explorador.

Los temas relacionados definen cada una de las funciones disponibles a través de xCP Designer eindican en qué contexto están disponibles. En general, las expresiones que se utilizan en una página, unflujo de acción o un contexto de interfaz de usuario similar se evalúan en el explorador (por ejemplo, aldesactivar un botón basado en una condición) y el resto de artefactos (consultas, informes, modelos deobjeto y procesos) se evalúan en un contexto de servidor (por ejemplo, al escribir una expresión comocondición de un evento de negocio).

Si escribe una función personalizada, tenga en cuenta el contexto en el que se va a ejecutar:

• Si desea que la función personalizada esté disponible en el contexto del servidor, debe implementarlaen Java.

• Si desea que la función personalizada esté disponible en el contexto del explorador, debeimplementarla en JavaScript.

• Si desea que estén disponibles en ambos contextos, implemente la función en los dos lenguajes.

Las funciones pueden contener números variables de argumentos.


Crear expresiones

Funciones de fecha

A menos que se indique lo contrario, las funciones de fecha que se ejecutan en el contexto del servidoradoptan las zonas horarias de la máquina virtual Java (JVM) en la que se ejecutan. El sistema evalúalas expresiones en el contexto del servidor o del explorador. Debe establecer los servidores deaplicaciones en la misma zona horaria que todos los demás y que los equipos cliente. Si los usuariosfinales están distribuidos geográficamente, utilice las funciones basadas en UTC al crear fechas.

Función Descripción Ejemplo Se ejecutaen elcontextodelservidor

Se eje-cuta en elcontextodel explo-rador

addDays(DateTime date,Integer days) : DateTime

Devuelve el valor de fechay hora (DateTime) generadodespués de agregar el númerode días especificado pordays a date.

El argumento days puede serun número negativo, lo queindica resta.

Supongamos quenow() devuelveel valor derepresentación hora yfecha del 30 de Enerodel 2012 11:56:57PM.

addDays(now( ),-10) devuelve larepresentación deDateTime de 20 deenero de 201211:56:57 PM

Sí Sí

addHours(DateTime date,Integer hours) : DateTime

Devuelve el valor de fechay hora (DateTime) generadodespués de agregar el númerode horas especificado porhours a date.

El argumento hours puede serun número negativo, lo queindica resta.

Supongamos quenow() devuelveel valor derepresentación hora yfecha del 30 de Enerodel 2012 11:56:57PM.

addHours(now(), 3) devuelve larepresentación deDateTime de 31 deenero de 20122:56:57 AM

Sí Sí


Crear expresiones



addMinutes(DateTimedate, Integer minutes) :DateTime

Devuelve el valor de fechay hora (DateTime) generadodespués de agregar el númerode minutos especificado porminutes a date.

El argumento minutes puedeser un número negativo, loque indica resta.

Supongamos quenow() devuelveel valor derepresentación dehora y fecha del 31de Enero del 201212:02:23 AM.

addMinutes(now(), 30) devuelvela representación deDateTime de 31 deenero de 201212:32:23 AM

Sí Sí

addSeconds(DateTimedate, Integer seconds) :DateTime

Devuelve el valor de fechay hora (DateTime) generadodespués de agregar el númerode segundos especificado porseconds a date.

El argumento seconds puedeser un número negativo, loque indica resta.

Supongamos quenow() devuelveel valor derepresentación dehora y fecha del 31de Enero del 201212:03:18 AM.

addSeconds(now(), 22) devuelvela representación deDateTime de 31 deenero de 201212:03:40 AM

Sí Sí

createDate(Integer year,Integer month, Integerday) : DateTime

Devuelve la representaciónde fecha y hora (DateTime)especificada por year, month,day.

createDate(2012,1,31) devuelvela representación deDateTime de 31de enero de2012 con la horaestablecida en la horaactual

Sí Sí

createDateTime(Integeryear, Integer month,Integer day, Integer hour,Integer minute, Integerseconds) : DateTime

Devuelve la representaciónde DateTime especificadapor year, month, day,hour, minute, seconds.El sistema devuelve unafecha en función de la zonahoraria de la máquina virtualJava (JVM) que evalúa laexpresión.

Escriba el parámetro hourcon un formato de 24 horas.

createDateTime(2012,1,31,11,13,45)devuelve larepresentación deDateTime de 31 deenero de 201211:13:45 AM

Sí Sí


Crear expresiones



Nota técnica: la hora seestablece en función de lazona horaria de la máquinavirtual Java (JVM) querealiza la evaluación. En elcontexto de una aplicación,la máquina virtual Java seencuentra en el servidor deaplicaciones en el que seestá ejecutando la aplicacióno en Java Method Server.Se recomienda establecerambas JVM en la misma zonahoraria y en consonancia conla zona horaria de los usuariosfinales. Si los usuariosfinales están distribuidosgeográficamente, es posibleque sea más útil usar lafunción createDateUTCmostrada a continuación.

createDateUTC(Integer year, Integermonth, Integer day,Integer hour, Integerminute, Integer secs) :DateTime

Devuelve la representaciónde fecha y hora (DateTime)especificada por year,month, day, hour, minute ysecs mediante la horauniversal coordinada (UTC).

Escriba el parámetro hourcon un formato de 24 horas.

Nota técnica: esta funciónse introdujo para evitar losproblemas asociados a lacreación de una fecha sinconocer la zona horaria.

createDateUTC(2012,1,31,11,13,45)devuelve larepresentaciónde DateTime deJanuary 31,2012 11:13:45AM en UTC

Sí No

differenceDays

(DateTime date1,DateTime date2) : Integer

Número entero que representael número de días entredate1 y date2.

Devuelve una operaciónsimilar a la resta entre fechas.Si date2 es posterior a date1,el resultado será negativo.El resultado se convierte endías y se redondea al númeroentero más próximo.

31 de enero de 201211:13:45 AM - 1de febrero de 20127:28:29 PM

differenceDays(createDate(2012,1,31,11,13,45),createDate(2012,2,1,19,28,29)) devuelve -1

Sí Sí


Crear expresiones



1 de febrero de 20127:28:29 PM - 31de enero de 201211:13:45 AM

differenceDays(createDate(2012,2,1,19,28,29),createDate(2012,1,31,11,13,45)) devuelve 1

31 de enero de 201212:00:00 AM - 31de enero de 201211:59:59 PM

differenceDays(createDate(2012,1,31,0,00,00),createDate(2012,1,31,23,59,59)) devuelve 0

differenceSeconds

(DateTime date1,DateTime date2) : Integer

Devuelve un número enteroque representa el número desegundos entre date1 y date2.

La operación es similar a laresta entre fechas. Si date2 esposterior a date1, el resultadoserá negativo. El resultadose convierte en segundos yse redondea al número enteromás próximo.

Nota técnica: el tipo dedatos de entero puedeincluir un valor mínimo de-2147483648 y un valormáximo de 2147483647,por lo que es posible que seproduzca un error si entre lasdos fechas utilizadas hay unadiferencia superior a 68 años.

31 de enero de 201211:13:45 AM - 1de febrero de 20129:28:29 AM

differenceSeconds(createDate(2012,1,31,11,13,45),createDate(2012,2,1,9,28,29))

devuelve -80084

1 de febrero de 20129:28:29 AM - 31de enero de 201211:13:45 AM


devuelve 80084

Sí Sí


Crear expresiones



31 de enero de 201212:00:00 AM - 31de enero de 201211:59:59 PM


devuelve -86399

getDay(DateTime date) :Integer

Devuelve el valor de enterodel día del mes (1-31) que seutiliza en date.

employee.hire_date = 30 de enerode 2012, 8:05:23 AM(o, en su lugar, larepresentación deDateTime de 30 deenero de 2012)

getDay(employee.hire_date) devuelve 30

Sí Sí

getHour(DateTime date) :Integer

Devuelve el valor de enterode la hora con la notación de12 horas (1-12) que se utilizaen date.

employee.hire_date = 30 de enerode 2012, 8:05:23AM (o, en su lugar,la representación deDateTime de 30 deenero de 2012)

getHour(employee.hire_date) devuelve 8

Sí Sí

getMinute(DateTimedate): Integer

Devuelve el valor de enterodel minuto (0-59) que seutiliza en date.


getMinute(employee.hire_date) devuelve 5

Sí Sí


Crear expresiones



getMonth(DateTimedate): Integer

Devuelve el valor de enterodel mes (1-12) que se utilizaen date.


getMonth(employee.hire_date) devuelve 1

Sí Sí

getUserTimeZone():String

Devuelve la zona horaria delusuario.

getUserTimeZone() devuelve ’GMT’

No Sí

getYear(DateTime date):Integer

Devuelve el valor de enterodel año que se utiliza en date.


getYear(employee.hire_date) devuelve 2012

Sí Sí

now() : DateTime Devuelve la representaciónde fecha y hora (DateTime)de la fecha y hora actuales.

Supongamos quenow() devuelveel valor derepresentación defecha y hora del 31 deenero de 2012 a las12:03:18 AM

now() devuelve larepresentación defecha y hora de31 de enero de2012 12:03:18AM

Sí Sí


Crear expresiones



stringToDate(StringdateValue, String format): DateTime

Devuelve la representaciónde fecha y hora (DateTime)especificada por dateValue,que se codifica con el formatode fecha especificado porformat.

Esta función solo admite textode fecha en la configuraciónregional de la máquina virtualJava (JVM).

El parámetro format se puedeespecificar con las mismasreglas que la clase de JavaSimpleDateFormat. Consultela documentación estándarde JavaDocs disponible enOracle para ver ejemplos.

La zona horaria se basa en lazona horaria de la JVM querealiza la evaluación.

stringToDate(’01/31/2012’,’MM/dd/aaaa’)devuelve larepresentación deDateTime de 31 deenero de 201212:00:00 AM (conla zona horaria de laJVM)

Sí Sí

stringToDate(StringdateValue) : DateTime

Devuelve la representaciónde fecha y hora (DateTime)especificada por dateValue,que se codifica con el formatode fecha especificado por cISO 8601.NotaSi no se especifica,los valores predeterminadosde mes/día son los delmes/día actuales, la horapredeterminada es lamedianoche, y el valorpredeterminado de la zonahoraria es la del navegador.Si se especifica una hora,debe incluir horas y minutos.El delimitador "T", segundos,milisegundos y zona horariason opcionales.La fracciónde décimas de segundo, si seespecifica, debe contener almenos 1 dígito (no hay límitepara la cantidad máximade dígitos permitidos) y sepueden delimitar, ya sea con’.’ o con ’,’.

stringToDate("08/19/2012 ’ 16:2901:00’c’) devuelve larepresentaciónde DateTime como2012-08-19T16:20+01:00.

Sí Sí


Crear expresiones



stringToDateUTC(StringdateValue, String format): DateTime

Devuelve la representaciónde fecha y hora (DateTime)especificada por dateValue,que se codifica con elformato de fecha especificadopor format mediante la horauniversal coordinada (UTC).

El parámetro format se puedeespecificar con las mismasreglas que la clase de JavaSimpleDateFormat. Consultela documentación estándarde JavaDocs disponible enOracle para ver ejemplos.

stringToDateUTC(’31/01/2012’,’MM/dd/aaaa’)devuelve larepresentación deDateTime de 31 deenero de 201212:00:00 AM (conla zona horaria UTC)

Sí Sí

todayUTC() : DateTime Devuelve la representaciónde fecha y hora (DateTime)de la fecha actual con laparte de hora establecida enla medianoche (00:00:00)utilizando la hora universalcoordinada (UTC) como zonahoraria.

Supongamos que es31 de enero de 2012.

todayUTC( )

devuelve larepresentaciónde fecha y hora(DateTime)de January 31,2012 12:00:00AM (con la zonahoraria UTC)

Sí No

isValidDateTime (Datewidget ID)

Valida si el valor de fechay hora introducido en elwidget de entrada Date-timees válido.

Supongamos que es15/03/2014 11:00:00AM

isValidDateTime ()

valida larepresentaciónde fecha y hora(DateTime)del 15/3/201411:00:00 AM ydevuelve el valorTrue para el formatocorrecto.

Sí Sí


Crear expresiones



toLocaleDateString(DateTime date, Stringlocale) : String

Devuelve la representaciónde cadena de la fecha segúnla configuración regional.

var date = newDate(Date.UTC(2012, 11, 20, 3, 0,0));

// En inglés del ReinoUnido se utiliza lafecha en el formatodía-mes-año

toLocaleDateString(date,’en-GB’)devuelve"20/12/2012"

// En inglés de EE.UU. se utiliza lafecha en el formatomes-día-año

toLocaleDateString(date,’en-US’) devuelve"12/20/2012"

No Sí

toLocaleTimeString(DateTime date, Stringlocale) : String

Devuelve la representaciónde la hora en forma decadena de caracteres según laconfiguración regional.

var date = new Date(Date.UTC(2012, 11,20, 3, 0, 0));

// En inglés del ReinoUnido se utiliza elformato de 24 horassin AM/PM

toLocaleTimeString(date,’en-GB’)devuelve"03:00:00"// En inglés de EE.UU. se utiliza elformato de 12 horascon AM/PM

toLocaleTimeString(date, ’en-US’)devuelve "7:00:00PM"

No Sí


Crear expresiones



toLocaleString (DateTimedate, String locale) :String

Devuelve la representaciónde cadena de la fecha yhora según la configuraciónregional.

var date = newDate(Date.UTC(2012,11, 20, 3, 0, 0));

toLocaleString(date,’en-GB’)devuelve"20/12/201203:00:00"

toLocaleString(date,’en-US’) devuelve"12/19/2012,7:00:00 PM"

No Sí

Funciones de metadatos descubiertos

Al utilizar metadatos descubiertos en un modelo de contenido, hay algunos atributos que extraen unconjunto de rutas de acceso o categorías jerárquicas. Los metadatos descubiertos que se han extraídode esta forma son:

• Términos de negocio

• Lugar

• Ciencia e Ingeniería

Por ejemplo, el atributo Lugar puede contener lo siguiente tras la extracción: {’Europe/France/Paris’,’Europe/Germany/Berlin’, ’America/United States/California/Los Angeles’}. Todos los atributos demetadatos descubiertos se devuelven con un formato de lista (es decir, son atributos de repetición en elobjeto). Funciones de lista, página 455 proporciona más información sobre listas y atributos repetidos.

Puede mostrar un nivel específico en contraposición a la ruta de acceso completa. Para ello, utiliceuna función del editor de expresiones para mostrar solo el nivel especificado de la ruta de acceso. Porejemplo, podría tener espacio limitado para mostrar valores, como una celda de una lista de resultados,o los usuarios finales podrían necesitar solo determinada información como, por ejemplo, el nombre dela ciudad de un atributo Lugar.

Todas las funciones devuelven valores diferentes, ordenados alfabéticamente. Si los nivelesespecificados no están presentes en una ruta de acceso, no se devuelve ningún valor. La primeraposición de nivel de ruta de acceso es 0, no 1.

La tabla siguiente describe las funciones de metadatos descubiertos:


Crear expresiones

Función Descripción Ejemplo Seejecutaen elcontextodelservidor

Seejecutaen elcontextodelexplor-ador

DiscoveredMetadataLeaf(String[ ] paths) : String[ ]

Devuelveuna lista enque cadaelemento de lalista paths sesustituye porel nivel de rutade acceso dehoja de cadaelemento depaths.

DiscoveredMetadataLeaf({’Europe/France/Paris’,’Europe/Germany/Berlin’,’America/United States/California/LosAngeles’})

devuelve{’Berlin’,’Los Angeles’,’Paris’}

No Sí

DiscoveredMetadataLevelString[]paths, Integer level, [IntegerdefaultLevel]) : String[ ]

Muestra unalista con cadaelementoen la listapaths susti-tuido por eltérmino en elnivel de rutaespecificadopor level paracada elementode paths. Siel índice es-pecificado porlevel no existe,la función in-tenta volver ala posición denivel de rutade acceso es-pecificada pordefaultLevel,lo cual es op-cional. Si nose ha especifi-cado default-Level y el nivelde ruta de ac-ceso iniciadopor level noexiste, ese el-emento no se

DiscoveredMetadataLevel({C/Credit/Credit Terms/Collateral, C/Credit/Creditworthiness,C/Credit/Types of Credit/Consumer Credit}, 3, 2)

devuelve{’Collateral’,’Consumer Credit’,’Creditworthiness’}

y

DiscoveredMetadataLevel({C/Credit/Credit Terms/Collateral, C/Credit/Creditworthiness,C/Credit/Types of Credit/Consumer Credit}, 3)

devuelve{’Collateral’,’Consumer Credit’}

No Sí


Crear expresiones


Seejecutaen elcontextodelexplor-ador

sustituye pornada.

DiscoveredMetadataLevels(String[ ] paths, Integer[ ]levels) : String[ ]

Devuelveuna lista delos términosextraídosdesde cadaelemento dela lista paths,en la quelos términosextraídosproceden delos nivelesespecificadosen la listalevels.

DiscoveredMetadataLevels({’Engineering/Bioengineering/Biotechnology/Subfields ofBiotechnolog/Biophysics’,’Engineering/Nuclear Engineering/Fusion’,’Engineering/Electrical Engineering/Power Engineering/Generation’}, {2, 4})

devuelve{’Biophysics’,’Biotechnology’,’Fusion’,’Power Engineering’}

No Sí

Funciones de lista

Una lista, representada por la notación de corchete ([ ]) en el tipo de datos, es una representaciónsimilar a una matriz de los atributos de repetición. En otras palabras, cualquier atributo de repeticiónpuede utilizarse en una ubicación en la que se acepte una lista. Además, la lista no se puede transferircon una notación de llave ({}) como en los ejemplos. La primera posición del índice es 0, no 1. El usode "Any" en los valores de devolución y firma de la función implica que se puede transferir cualquiertipo de datos (cadena, booleano, fecha y hora, flotante y entero). No obstante, los parámetros deentrada deben ser del mismo tipo o se devolverá un error en tiempo de ejecución.

El valor devuelto será del mismo tipo que los parámetros de entrada.


Crear expresiones

Función Descripción Ejemplo Se ejecuta enel contexto delservidor

Se ejecuta enel contexto delexplorador

add(Any[ ] list1,Any[ ] list2, Integerindex) : Any[ ]

La lista generadaal insertar list2en list1 despuésde la posiciónespecificada porindex.

add({’Peter’,’Paul’},{’Mary’,’Jane’}, 1)

devuelve{’Peter’,’Mary’,’Jane’,’Paul’}

Sí No

add(Any[ ] list, AnynewValue, Integerindex) : Any [ ]

La lista generada alinsertar newValueen list1 despuésde la posiciónespecificada porindex.

add({’Peter’,’Paul’},’Mary’, 1)

devuelve{’Peter’,’Mary’,’Paul’}

Sí No

add(Any[ ] list1,Any[ ] list2) : Any[]

Lista generada alanexar list2 al finalde list1.

add({’Peter’,’Paul’},{’Mary’,’Jane’})

devuelve{’Peter’,’Paul’,’Mary’,’Jane’}

Sí No

add(Any[ ] list, Anyt) : Any[ ]

lista generada alanexar t al final delist1.

add({’Peter’,’Paul’},’Mary’)

devuelve{’Peter’,’Paul’,’Mary’}

Sí No


Crear expresiones



compare(Any[ ]list1, Any[ ] list2,Boolean strict) :Boolean

Compara dos listasy devuelve el valorTRUE si list1 ylist2 contienen losmismos valores enla lista. Si strictse establece comoTRUE, se tiene encuenta el orden delos elementos; si,por el contrario,strict se establececomo FALSE, elorden no se tiene encuenta.

compare({’Peter’,’Mary’,’Paul’},{’Paul’,’Mary’,’Peter’},FALSE)

devuelveTRUE

y

compare({’Peter’,’Mary’,’Paul’},{’Paul’,’Mary’,’Peter’},TRUE)

devuelveFALSE

Sí No

contains(Any[ ]list, Any object) :Integer

Compara objectcon cada elementode list y devuelve elíndice de la posiciónde la primeracoincidencia.Si no seencuentra ningunacoincidencia, sedevuelve el valor-1.

contains({’Peter’,’Mary’,’Paul’},’Paul’)

devuelve2

y

contains({’Peter’,’Mary’,’Paul’},’Jane’)

devuelve -1

Sí No


Crear expresiones



remove(Any [ ] list,Integer startIndex,Integer endIndex) :Any [ ]

Elimina los el-ementos de listempezando por laposición startIndexy acabando por laposición endIndex,ambas incluidas.Si startIndex esigual que endIndex,solo se eliminaráun elemento (elespecificado porstartIndex/endIn-dex).

remove({’Peter’,’Paul’,’Mary’,’Jane’},0, 1})

devuelve{’Mary’,’Jane’}

Sí No

size(Any[ ] list) :Integer

Número deelementos de listen forma de entero.

size({’Peter’,’Paul’,’Mary’})

devuelve 3

Sí No

Funciones lógicasUna función lógica es una instrucción de flujo de control que ejecuta determinados expresiones cuandouna determinada condición es verdadera.

Función Descripción Ejemplo Se ejecutaen elcontexto delservidor

Se ejecutaen elcontexto delexplorador

ifThenElse(Booleancondition,Stringresult1,Stringresult2) :String

Devuelve result1 si condition es TRUE yresult2 si condition es FALSE.

Esta función ifThenElse se utilizaespecíficamente para devolver unresultado de cadena.

ifThenElse(customer.net_worth>parameters.<espacio denombres>.vip_net_worth_minimum,’El cliente es unVIP’,’El cliente no es unVIP’)

devuelve ’Elcliente es unVIP’si cus-tomer.net_worth>

Sí No


Crear expresiones



parameters.<espacio de nom-bres>.vip_net_worth_minimumes TRUE

o

devuelve’El clienteno es un VIP’si cus-tomer.net_worth>parameters.<espacio de nom-bres>.vip_net_worth_minimumes FALSE

ifThenElse(Booleancondition,Booleanresult1,Booleanresult2) :Boolean


Esta función ifThenElse se utilizaespecíficamente para devolver unresultado booleano.

ifThenElse(customer.net_worth> parameters.<espacio denombres>.vip_net_worth_minimum,TRUE, FALSE)

devuelve TRUEsi cus-tomer.net_worth>parameters.<espacio de nom-bres>.vip_net_worth_minimumes TRUE

o

devuelve FALSEsi cus-tomer.net_worth>parameters.<espacio de nom-bres>.

Sí No


Crear expresiones



vip_net_worth_minimumes FALSE

ifThenElse(Booleancondition,DateTimeresult1,DateTimeresult2) :DateTime


Esta función ifThenElse se utilizaespecíficamente para devolver unresultado de fecha y hora (DateTime).

Explicación: en esteejemplo, deseamosdevolver la fechamás próxima en laque debe haberseadquirido el artículopara que la solicitudsea válida. Si elcliente solicitaun reembolso enefectivo, la directivade devoluciónespecifica que lafecha de compra nodebe ser superiora siete días enrelación con lafecha actual, porlo que devolvemosla fecha actual yrestamos siete días.Si el cliente solodesea intercambiarel artículo u obtenercrédito de la tienda,el umbral de fechaes igual a la fechaactual menos 30días.

ifThenElse(customer_refund_request.refund_or_exchange ==’Cash Refund’,addDays(now(),-7), addDays(now(),-30))

devuelve 23 deenero de 20128:05:23 AM (ola representación deDateTime de 23 deenero de 2012)si(customer_refund_

Sí No


Crear expresiones



request.refund_or_exchange ==’Cash Refund’,y la fecha-horaactual devuelta pornow( ) es 30 de enerode 2012 8:05:23AM.

o

devuelve 31 dediciembrede 20118:05:23 AM (ola representación deDateTime de 31 dediciembre de 2011)si customer_refund_request.refund_or_exchange == ’StoreCredit’y la fecha- horaactual devuelta pornow() es 30 de enerode 2012, 8:05:23AM

ifThenElse(Booleancondition,Floatresult1,Floatresult2) :Float


Esta función ifThenElse se utilizaespecíficamente para devolver unresultado flotante.

Explicación: eneste ejemplomostramos el usode instruccionesifThenElse anidadas.Si el cliente tieneuna puntuación decrédito excelente(por encima de 750),el banco podríaconsiderarlo aptopara un préstamocon un 3,5% deinterés, pero si solotiene una buenapuntuación (entre700 y 749), el bancopodría ofrecer uninterés del 5,5%; delo contrario, la tasade interés será del8,99%.

Sí No


Crear expresiones



ifThenElse(customer.credit_score>=750, 0,035,ifThenElse(customer.credit_score>=700, 0,055, 0,0899))

devuelve 0.035sicustomer.credit_scorees mayor o igualque 750

o

devuelve 0.055sicustomer.credit_scorees mayor o igualque 700 y menorque 750

o

devuelve 0.0899sicustomer.credit_scorees menor que 700

ifThenElse(Booleancondition,Integerresult1,Integerresult2) :Integer


Esta función ifThenElse se utilizaespecíficamente para devolver unresultado de entero.

ifThenElse(sop_document.approval_status== ’Approved’, 1, 0)

devuelve 1sisop_document.approval_statuses ’Approved’

o

devuelve 0si sop_document.

approval_statuses ’Rechazado’

Sí No

ifThenElse(Booleancondition,Anyresult1,


ifThenElse(customer.net_worth>parameters.

No Sí


Crear expresiones



Anyresult2): Any

<espacio denombres>.vip_net_worth_minimum,’El cliente es unVIP’,’El cliente no es unVIP’)

devuelve ’Elcliente es unVIP’si cus-tomer.net_worth>parameters.<espacio de nom-bres>.vip_net_worth_minimumes TRUE

o

devuelve ’Elcliente no esun VIP’si cus-tomer.net_worth>parameters.<espacio de nom-bres>.vip_net_worth_minimumes FALSE

Funciones matemáticas

Las funciones matemáticas (también clasificadas como funciones "math" en el contexto del explorador)contienen un conjunto de funciones que realizan operaciones matemáticas y algunas funciones que seencargan de la conversión de tipo en relación con números enteros y flotantes.


Crear expresiones

Función Descripción Ejemplo Se ejecuta enel contextodel servidor


Contexto delexplorador:abs(Float num) :Float

Contexto delservidor:abs(Float value) :Float

Devuelve el valor absoluto o,de forma más precisa, el valoromitiendo el signo de un númeroflotante, num*.

abs(-4.123)

devuelve 4.123

Sí Sí

Contexto delexplorador:abs(Integer num): Integer

Contexto delservidor:abs(Integer value): Integer

Devuelve el valor absoluto o,de forma más precisa, el valoromitiendo el signo de un númeroentero, num*.

abs(-4)

devuelve 4

Sí Sí

Contexto delnavegador:arrayAverage(Integer[ ]numAry) : Float

Contexto delservidor:avgInt(Integer[ ]values) : Float

Devuelve el promedio de losnúmeros de la lista de enterosproporcionada, numAry*.

Una lista, representada por lanotación de corchete ([ ]) alfinal del tipo de datos, es unarepresentación similar a una matrizde los atributos de repetición.La entrada puede proceder de unatributo de repetición o de una listacodificada de forma rígida. Laslistas se escriben con una notaciónde llave, {value1, value2,...}, comoen el ejemplo.

arrayAverage({-100,12,14,4,-6,82})

devuelve 1.0

Sí Sí

Contexto delnavegador:arrayMax(Integer [ ]numAry) : Integer

Contexto delservidor:max(Integer [ ]values) : Integer

Devuelve el número mayor de lalista proporcionada, numAry*.


arrayMax({-100,12,14,4,-6,82})

devuelve 82

Sí Sí


Crear expresiones



Contexto delnavegador:arrayMin(Integer [ ]numAry : Integer

Contexto delservidor:min(Integer [ ]values : Integer

Devuelve el menor de los númerosde la lista indicada, numAry*.


arrayMin({-100,12,14,4,-6,82})

devuelve -100

Sí Sí

Contexto delnavegador:average(Integer num1,Integer num2) :Float

Contexto delservidor:avgInt(Integer int1,Integer int2) :Float

Devuelve el promedio de losdos enteros, num1* y num2*,proporcionados como argumentos.

average(4,9)

devuelve 6.5

Sí Sí

avgFloat(Float int1, Floatint2) : Float

Devuelve el promedio de los dosnúmeros flotantes, int1 y int2,indicados como argumentos.

average(4.0,9.0)

devuelve 6.5

Sí No

avgFloat(Float[ ]values) :Float

Devuelve el promedio de losnúmeros de la lista de númerosen coma flotante proporcionada,values)..


avg({-100.2,12.5,14.1,4.6,-6.135,82.99})

devuelve1.309166666666667

Sí No


Crear expresiones



La primera posición del índice es0, no 1.

Contexto delexplorador:ceiling(Floatnum) : Integer

Contexto delservidor:ceiling(Floatvalue) : Integer

Devuelve el resultado de enteroque se obtiene al redondear porexceso num* al valor entero máspróximo (mayor que num*).

ceiling(92.53)

devuelve 93

Sí Sí

floatToInt(Float number) :Integer

Devuelve la representación enterade number.

No hay redondeo, solotruncamiento tras el decimal.

floatToInt(92.999)

devuelve 92

Sí No

Contexto delnavegador:floor(Floatnum) : Integer

Contexto delservidor:floor(Float value): Integer

Devuelve el resultado de enteroobtenido al redondear por abajonum* al valor de entero máspróximo (que es inferior a num*).

floor(92.53)

devuelve 92

Sí Sí

intToFloat(Integer number): Float

Devuelve la representación flotantedel valor flotante de number.

intToFloat(92)

devuelve 92.0

Sí No

Contexto delnavegador:max(Integernum1, Integernum2) : Integer

Contexto delservidor:max(Integer int1,Integer int2) :Integer

Devuelve el mayor de los dosenteros, num1* y num2*, indicadoscomo argumentos.

max(4,8)

devuelve 8

Sí Sí


Crear expresiones



Contexto delnavegador:min(Integernum1, Integernum2) : Integer

Contexto delservidor:min(Integer int1,Integer int2) :Integer

Devuelve el menor de dos enteros,num1* y num2*, proporcionadoscomo argumentos.

min(4,8)

devuelve 4

Sí Sí

Contexto delexplorador:mod(Integer num,Integer divisor) :Integer

Contexto delservidor:mod(IntegernumberDividend,IntegernumberDivisor) :Integer

Devuelve el módulo, o bienel resto, de num* dividido pordivisor*.

mod(5,2)

devuelve 1

Sí Sí

power(Integer num,Integer power) :Integer

Devuelve el resultado de elevarnum a la potencia power.

Acepta un valor de entero comoprimer argumento.

power(3,3)

devuelve 27

No Sí

Contexto delnavegador:power(Floatnum, Integerpower) : Float

Contexto delservidor:power(FloatnumberBase,IntegernumberExponent): Float

Devuelve el resultado de elevarnum* a la potencia power*.

Acepta un valor flotante comoprimer argumento.

power(3.0,3)

devuelve 27.0

Sí Sí

random( ) : Float Devuelve un número flotantealeatorio entre 0 y 1.

random( )

devuelve 0.1263

Sí Sí


Crear expresiones



Contexto delnavegador:round(Floatnum, Integerprecision) : Float

Contexto delservidor:round(Floatnumber, Integerprecision) : Float

Devuelve el valor de num*redondeado al número flotantemás próximo con el valor deprecision* especificado en dígitossignificativos. Una situación deempate se resuelve mediante elredondeo por arriba.

round(4.235, 2)

devuelve 4.24

Sí Sí

stringToFloat(String number) :Float

Devuelve la representación enforma de número flotante de lacadena number.

stringToFloat(’92.123’)

devuelve 92.123

Sí No

stringToInt(String number) :Integer

Devuelve la representación enforma de entero de la cadenanumber.

stringToInt(’92’)

devuelve 92

Sí No

* Los argumentos difieren para la firma de la función en el contexto del servidor.

Funciones de cadena

Las cadenas son una representación del texto. Las cadenas literales se incluyen entre comillas simples(’) en una expresión. A menos que se indique lo contrario, las funciones de cadena en las que se busca,compara o sustituye texto distinguen entre mayúsculas y minúsculas.



contains(String str1, , Stringstr2) : Boolean

Devuelve elvalor TRUEsi str2 estádentro de str1.

De locontrario,devuelve elvalor FALSO.

contains(’La fecha de vencimientodel préstamo ha pasado’,’préstamo’)

Devuelve’TRUE’

.

Sí Sí


Crear expresiones



endsWith(String str1, Stringstr2) : Boolean

Devuelve elvalor TRUEsi str1 terminacon str2.


endsWith (’La fecha devencimientodel crédito ya hapasado’, ’pasado’)

Devuelve’TRUE’

.

Sí Sí

floatToString(Float number) :String

Devuelve elvalor flotantetransferido,number, enforma decadena decaracteres.

Una de lasdiversasfunciones de"Conversiónde tipo dedatos", ya queel editor deexpresionesno realiza lasconversionesde tipode datosimplícitas(se denominatambién"Asignaciónde tipo dedatos").

floatToString(4.134)

devuelve’4.134’.

Sí Sí

getUserLocale():String

Devuelve laconfiguraciónregional delusuario.

getUserLocale()

devuelve’en_US’.

No Sí


Crear expresiones



intToString(Integer number) :String

Devuelve elvalor enterotransferido,number, enforma decadena decaracteres.

Una de lasdiversasfunciones de"Conversiónde tipo dedatos", ya queel editor deexpresionesno realiza lasconversionesde tipode datosimplícitas(se denominatambién"Asignaciónde tipo dedatos").

intToString(42)

devuelve’42’.

Sí Sí

length(String str) : Integer

Devuelve elnúmero decaracteres destr en formade entero.

length (’The loanexpiration datehas passed’)

devuelve35

Sí Sí

match(String text, Stringpattern) : Integer

Devuelve laposición delcarácter enrelación conla ubicaciónen la quecomienzala primeracoincidencia,donde text esel texto en elque se realizala búsqueday pattern esla cadenaque debeencontrarse

match (’La fecha devencimientodel préstamoha pasado’, ’ha pasado’)

devuelve38

Sí No


Crear expresiones



en el texto debúsqueda.

La primeraposición es 0,no 1. Si nose encuentrapattern comocoincidenciaen text, sedevuelve elvalor -1.

replace(String text, StringmatchPattern,StringreplacePattern):String

Devuelve lacadena gener-ada al susti-tuir todas lasinstancias dematchPat-tern dentrode text por re-placePattern.

replace (’The loanexpiration date haspassed.A notificationhas been sent. ’, ’has’,’has not’)

devuelve’The loan expiration datehas not passed.A notification hasnot been sent.’

Sí No

startsWith(String str1, Stringstr2) : Boolean

Devuelveel valorTRUE si str1comienza porstr2.


startsWith (’The loanexpiration datehas passed’, ’The loan’)

devuelve’TRUE’

Sí Sí

substring(String str, Integerstart) : String

Devuelvela cadenagenerada alextraer loscaracteres destr a partir dela posiciónindicada porstart.

La primeraposición es 0,no 1.

En elcontexto del

substring(’Mis fechas’, 4)

Devuelve’fechas’

Sí Sí


Crear expresiones



exploradorsolo seproporcionauna funciónpara las dosvariacionesde subcadena.

substring(String str, Integerstart, Integer end) :String

Devuelvela cadenagenerada alextraer loscaracteres destr a partir dela posiciónindicada porstart hasta laposición end,sin incluiresta última.

La primeraposición es 0,no 1.

En elcontexto delexploradorsolo seproporcionauna funciónpara las dosvariacionesde subcadena.

substring(’Loan Dates’,0,9)

devuelve’Loan Date’

Sí Sí

toLower(String str) : String

Devuelvela cadenagenerada alponer todoslos caracteresde str enminúsculas.

toLower(’IMPORTE DEL PRÉSTAMO’)

devuelveimporte del préstamo

Sí Sí

toUpper(String str) : String

Devuelvela cadenagenerada alponer todoslos caracteresde str enmayúsculas.

toUpper(’Fecha de vencimiento’)

devuelve"FECHA DE VENCIMIENTO"

Sí Sí


Crear expresiones



isStringRegExFormat(string, RegEx,Identifier) :Boolean

Validasi stringcoincide conla expresiónregularRegEx.Se puedeutilizar unidentificadoropcional paracontrolar lacoincidencia.Porejemplo, elidentificadorI se puedeutilizar pararealizar unacoincidenciadistinguiendoentremayúsculasy minúsculas.Esta funciónse puedeutilizarpara validarpatronescomo elcorreoelectrónico,la direcciónURL yel códigoHTML.

Para validar el correoelectrónico:isStringRegExFormat(’[email protected]’,’^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$’)

Para validar una URL:isStringRegExFormat(’www.abc.com’,’http(?)://([\w-]+\.)+[\w-]+(/[\w- ./?%&=]*)?’)

Sí Sí

dateToString(DateTimedateValue, Stringformat) : String

Devuelvela repre-sentación enforma de ca-dena de car-acteres delparámetrodateValueformateadosegún las re-glas especi-ficadas porformat.

Supongamos que now()devuelveel valor derepresentación deDateTime del31 de enero de 201211:37:23 AM.

dateToString(now(),’MMM dd, yyyyhh:mm a’) devuelveJan 31, 2012 11:37 AM

Sí Sí


Crear expresiones



Esta funciónsolo admitetexto de sal-ida en la con-figuración re-gional prede-terminada dela máquinavirtual Java(JVM).

El parámetroformatse puedeespecificarcon lasmismas reglasque la clase deJava SimpleDateFor-mat. Con-sulte la doc-umentaciónestándar deJavaDocsdisponible enOracle paraver ejemplos.

La zonahoraria sebasa en lazona horariade la JVMque realiza laevaluación.

dateToStringUTC(DateTimedateValue, Stringformat) : String

Devuelvela repre-sentación enforma de ca-dena de car-acteres dedateValueformateadosegún las re-glas especifi-cadas por for-mat mediantela hora uni-

Supongamos que now()devuelvela representación delvalor DateTimede 31 de enero,2012 11:37:23 AM, y queel usuario está en lazona horaria de la Horadel Pacífico.

dateToString(now(),’MMM dd,yyyy hh:mm a’) devuelve

Sí No


Crear expresiones



versal coordi-nada (UTC).

Esta funciónsolo admiteel texto defecha en laconfiguraciónregional eninglés. Porejemplo,"November"se entiende,pero"novembre"no.

El parámetroformatse puedeespecificarcon lasmismas reglasque la clase deJava SimpleDateFor-mat. Con-sulte la doc-umentaciónestándar deJavaDocsdisponible enOracle paraver ejemplos.

Jan 31, 2012 11:37 AM.

ltrim ( String str):String

Recortala cadenaindicada porla izquierda.

ltrim (’ The star jumped over the moon’)

devuelve ’The star jumpedover the moon’

No Sí

rtrim ( String str):String

Recortala cadenaindicada porla derecha.

rtrim (’ The star jumped over the moon ’)

devuelve ’The star jumpedover the moon’

No Sí


Crear expresiones



matchString (Stringstr, String pattern) :String[]

Hacecoincidir lacadena conel patrónindicado ydevuelve unamatriz decadenas.

str = ’ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz’;

pattern = /[A-E]/gi

Salida [’A’, ’B’, ’C’, ’D’,’E’, ’a’, ’b’, ’c’, ’d’,’e’]

No Sí

searchString (Stringstr, String pattern):Integer

Hacecoincidir laexpresiónregular conla cadena ydevuelve elíndice de lacoincidencia.

str = ’Watch out for the rock!’;

pattern = "r?or?" Este patrón dividirá lacadena por el espacio

Índice de salida de la cadena coincidencia

No Sí

replaceString(String str, Stringpattern, StringnewStr): String

Reemplazalasaparicionesde una cadenaen funciónde un patróndeterminado.

str = ’Watch out for the rock!’;

pattern = "ro"; este patrón divide lacadena por el espacio

newStr = "sho";

La salida devuelve la cadena sustituidacomo ’Watch out for theshock’

No Sí

splitString (Stringstr, String pattern) :String

Divide unacadena enuna matrizde cadenasespecificadapor un patrón.

str = ’I am a Developer’;

pattern = "\\s"

Este patrón divide la cadena por espacios

Matriz de cadenas de salida[’I’,’am’,”a’, ’Developer’]

No Sí

Funciones de contenido

Las funciones de contenido se pueden utilizar para interactuar con el contenido.


Crear expresiones


Se ejecutaen elcontextodelexplorador

lockStatus(DateTimelockdate,Stringlockowner) :String

Devuelvela cadena"Bloqueado " +lockdate + " por" + lockowner.Además,lockownermuestra"usted" enlugar delnombre deusuario silockowner esigual al usuarioque tienela sesiónabierta en esemomento.

lockStatus(doc.r_lock_date,doc.r_lock_owner)where doc.r_lock_date =9/21/12 02:58 am anddoc.r_lock_owner = ’joe’

Devuelve

’Bloqueado 9/21/1202:58 ampor joe ’cuando el usuario queinició sesiónno es joe.

Devuelve’Bloqueado 9/21/12 02:58 ampor usted’ cuando el usuarioque inició la sesión es joe.

No Sí

Funciones de fragmento de páginaUn fragmento de página es un componente que contiene una colección de widgets o interaccionesque puede agregar a páginas o a otros fragmentos de página. Las funciones de los fragmentos depágina contienen un conjunto de funciones que realizan operaciones con los fragmentos mientrasevalúan una expresión.



doesFragmentExist(String name): Boolean

DevuelveTRUE si existeun fragmentode nombrefragment1. Delo contrario,devuelve elvalor FALSO.

doesFragmentExist(fragment1) devuelve’TRUE’

N A

getFragment(String type, String suffix,[String namespace],[Boolean useFirstMatch),[Integer systemName-

Devuelve unfragmento consus atributospara unmodelode objetoy un sufijode nombre

getFragment(xcontent, _imp)devuelve el fragmentoinstancia de contenidomodelo de objeto y

N A


Crear expresiones



Limit]):String

de sistemaespecíficos.El parámetroopcionalde espaciode nombresespecifica elproyecto enel que deseabuscar elfragmento.El parámetroopcionaluseFirstMatchcoincide conlos criteriosdel fragmentoy muestrala primeraocurrencia.El parámetroopcionalsystemNameLimit reducela etiquetaextendida delnombre ydel sufijo delsistema, y sepuede omitir.

sufijo deimportación.

Funciones de fragmento de tipo

El fragmento de tipo contiene uno o varios atributos que puede definir con el tipo de objeto o eltipo base. Las funciones del fragmento de tipo contienen un conjunto de funciones que realizanoperaciones con los fragmentos de tipo.


Crear expresiones


Seejecutaen elcontextodelexplora-dor

isFragmentAttached(String objectId,String typeFragmentName): Boolean

Devuelve TRUEsi un nombredel sistema delfragmento detipo se adjuntaal objeto. Lafunción aceptael nombre delfragmento detipo y el objetoidentificadomediante el IDde objeto. Delo contrario,devuelve elvalor FALSO.

isFragmentAttached(fragment1, typefrag1)devuelve ’TRUE’

A N

getFragmentsAttached(String objectID): String

Devuelveuna lista defragmentos detipo anexadosal objetoidentificadomediante el IDde objeto.

getFragmentsAttached(String object1)devuelve todos losfragmentos de tipoadjuntos aobject1.

A N

isAttachableTypeFragment(String type_system_name,Stringfragment_system_name):Boolean

Devuelve TRUEsi un fragmentode tipo se puedeanexar a unainstancia delobjeto. Delo contrario,devuelve elvalor FALSO.

isAttachableTypeFragment(s1, fragment1)devuelve TRUE

N A

isTypeFragmentAttached(String object_id,Stringfragment_system_name):Boolean

Devuelve TRUEsi un fragmentode tipo se haanexado a unainstancia delobjeto. Delo contrario,devuelve elvalor FALSO.

isTypeFragmentAttached(folder_package2,fragment1)devuelve TRUE

N A


Crear expresiones

Funciones de URLLas funciones de URL contienen un conjunto de funciones para extraer información de las direccionesURL.



getObjectIDFromURI():String

Devuelve elobjectID de ladirección URIque se pasa ala función.

getObjectIDFromURI(’business-objects/abc_customer/0801e240800047e3’)

devuelve’0801e240800047e3’

No Sí

htmlEncode(String str):String

Devuelveuna cadenade HTMLcodificadamediante laconversión delos caracteresde HTMLreservadostransferidosen str a suequivalentede HTMLseguro.

htmlEncode(’La etiquetade imagen:<img>’)

devuelve’La etiquetade imagen:<img&gt’

No Sí

getBaseURL():String

Devuelve laURL base.

getBaseURL()devuelve’http://10.31.171.209:8080/myApp.’

No Sí

getFileUploadURL():String

Devuelvela URL defileupload.

Note: Lafunción estádisponible enla categoríaTodos.

getFileUploadURL()devuelve

’application/fileupload.html’

No Sí

getURLParameter (StringparamName): String

Devuelveel valor delparámetroindicado enforma decadena decaracteres.

Si la dirección URL eshttp://10.31.82.148:8000/App23/?nominify=true&group=main#application/ton_s123_otb_date_funct,

No Sí


Crear expresiones



getURLParameter(group)devolverá el valor como"main".

Funciones de aplicaciónFunción Descripción Ejemplo Se ejecuta

en elcontextodelservidor


getDeviceProfileName (): String

Devuelve una cadena decaracteres con el perfil deldispositivo.

Mozilla/5.0(Windows NT6.1; WOW64)AppleWebKit/537.36(KHTML,como Gecko)Chrome/46.0.2490.80Safari/537.36

No Sí

getValidation-ErrMsg(String widgetId,[Boolean addChildCom-pErrs]) : String []

Devuelve la matriz demensajes de error para unwidget determinado.

Si addChildCompErrs(parámetro opcional) esTrue, se devuelven todos losmensajes de error del widgety sus widgets secundarios.

No Sí

Funciones condicionalesContiene un conjunto de funciones para extraer información basada en una condición como parte dela función.

Función Descripción Se ejecuta enel contextodel servidor


isString (Any value) : Boolean Devuelve True si el valor es un valorde cadena de caracteres.

No Sí

isNumber (Any value): Boolean Devuelve True si el valor es un valornumérico.

No Sí

isBoolean (Any value): Boolean Devuelve True si el valor es un valorbooleano.

No Sí


Crear expresiones

Función Descripción Se ejecuta enel contextodel servidor


isDate (Any value, String Format):Boolean

Devuelve True si el valor es un valor defecha. Si se proporciona el parámetroformat (opcional), el sistema verificala fecha según el formato especificado.

No Sí

isEmptyOrNull (Any value) Devuelve True si el valor es nulo, estávacío o es un valor indefinido.

No Sí

isNaN (Any value) Devuelve True si el valor no es unnúmero.

No Sí

Funciones de recopilacionesContiene un conjunto de funciones para extraer información basada en una recopilación como parte dela función.



arrayContains (Any[]list, Any value, [IntegerfromIndex]) : Boolean

Devuelve True si el valor estápresente en la lista.

fromIndex: comienza abuscar en el arreglo desde elíndice indicado.

arrayContains(p1,3)devuelveTrue

Mientras queContains(p1,3,3)devuelvefalse

No Sí

sin (Any [] list, *Anyvalues): Any []

Devuelve una copia de la listacon todas las instancias de losvalores eliminados.

values: cadena de caracterescon varios valores separadospor comas.

without(p1,[2,3])devuelve un arreglocomo [1,5,6]

No Sí

uniq (Any[] list) : Any [] Devuelve una versión de lalista con elementos únicos yno duplicados.

uniq (p1) devuelveel arreglo como[1,2,3,5,6]

No Sí

indexOf (Any[] list, Anyvalue, [Boolean isSorted]): Integer

Devuelve el índice en el quese encuentra el valor en lalista.

Si Sorted es True, el sistemamarca la lista como ordenaday se realiza una búsquedabinaria para mejorar elrendimiento.

indexOf(p1,5)devuelve el valorcomo 5.

No Sí


Capítulo 13Empaquetar e implementar aplica-ciones



Tareas

Agregar un entorno de implementaciónEl administrador del sistema o de la aplicación xCP tiene los detalles de conexión del entorno paraagregar un entorno de implementación de xCP. EMC Documentum xCelerated Composition PlatformDeployment Guide (Guía de desarrollo de EMC Documentum xCelerated Composition Platform)contiene información detallada acerca de los entornos de implementación.1. En la barra de herramientas, haga clic en Preferencias.2. Seleccione Entornos de implementación.3. Haga clic en Agregar.4. En el cuadro de diálogo Agregar entorno de implementación, escriba los detalles de conexión

para el servidor de aplicaciones, tal y como se describe en la tabla siguiente:

Campo Descripción

Protocolo Seleccione uno de los protocolos: HTTP o HTTPS. Si opta por el modoSSL en el entorno de implementación, seleccione el protocolo HTTPS.

Nombre del entorno Escriba el nombre del entorno.

Nombre de host Escriba la dirección IP del servidor de aplicaciones.

Número de puerto Escriba el número de puerto del servidor de aplicaciones.

Nombre de usuario Escriba el nombre de usuario de implementación en el servidor deaplicaciones.

Contraseña Escriba la contraseña para el nombre de usuario de implementación enel servidor de aplicaciones.

Entorno xDA Enumera los entornos xDA activos que se pueden utilizar paraimplementar la aplicación creada con xCP.

Haga clic en Probar conexión para verificar la conexión.5. Haga clic en Finalizar.6. Para editar los detalles del entorno:

a. En el cuadro de diálogo Preferencias, seleccione Entornos de implementación.


Empaquetar e implementar aplicaciones

b. Seleccione el entorno y haga clic en Editar.c. Modifique los detalles del entorno y haga clic en Finalizar.d. Haga clic en Aceptar.

Agregar un entorno de tiempo de diseñoPuede utilizar un entorno de tiempo de diseño para ejecutar la aplicación en modo de vista previa,depurar el proceso o adoptar tipos existentes de un repositorio de Documentum.

El entorno de tiempo de diseño no forma parte de la implementación de la aplicación.1. En la barra de herramientas, haga clic en Preferencias.2. Seleccione Entornos de tiempo de diseño y haga clic en Agregar.3. En el cuadro de diálogo Agregar entorno de tiempo de diseño, especifique los detalles del

repositorio de Documentum tal y como se describe en la siguiente tabla:

Campo Descripción

Nombre de host dedocbroker

Escriba la dirección IP del repositorio de Documentum.

Puerto dedocbroker

Escriba el número de puerto del repositorio de Documentum.

Nombre delrepositorio

Haga clic en Actualizar y seleccione el repositorio de Documentum.

Nombre deusuario

Escriba el nombre de usuario en el repositorio de Documentum para autenticarla conexión.

Contraseña Escriba la contraseña para autenticar la conexión.

Dominio Escriba el nombre de dominio para autenticar la conexión.

(Opcional) Haga clic en Probar conexión.4. Haga clic en Siguiente.5. Especifique el Protocolo, la Dirección de BAM, el Número de puerto y la Raíz del contexto de

BAM para Business Activity Monitor. Haga clic en Siguiente.

Note: El valor predeterminado es bam-server para la raíz del contexto BAM. Puede cambiar elvalor según sus requisitos.

6. Seleccione la casilla de verificación Specify Global Registry Repository (Especificar repositoriodel registro global) y especifique los detalles tal y como se describe en la siguiente tabla:

Campo Descripción

Nombre de host dedocbroker

Escriba la dirección IP del repositorio de registros global.

Puerto dedocbroker

Escriba el número de puerto del repositorio del registro global.

Nombre delrepositorio

Haga clic en Actualizar y seleccione el repositorio del registro global.

Nombre deusuario

Escriba el nombre de usuario en el repositorio del registro global para autenticarla conexión.



Campo Descripción


Dominio Escriba el nombre de dominio para autenticar la conexión.

(Opcional) Haga clic en Probar conexión.

7. Especifique el Nombre del entorno y una Descripción.

8. Seleccione una de las opciones para Servidor web:

a. Webby: selecciona el servidor Webby.

b. Tomcat: selecciona el servidor Tomcat externo y especifica los detalles de Tomcat tal comose describe en la tabla siguiente:

Campo Descripción

Nombre de host Escriba la dirección IP del servidor de aplicaciones.

Puerto Escriba el número de puerto del servidor de aplicaciones.

Nombre deusuario

Escriba el nombre de usuario utilizado para autenticar la conexión.


9. Establezca este entorno como predeterminado, si es necesario, y haga clic en Finalizar.

10. Para editar los detalles del entorno:

a. En el cuadro de diálogo Preferencias, seleccione Entornos de tiempo de diseño.

b. Seleccione el entorno y haga clic en Editar.

c. Modifique los detalles del entorno y haga clic en Finalizar.

d. Haga clic en Aceptar.

El modelo de configuración del widget del visor decide si el enfoque se recibe o no en tiempo dediseño cuando una página con el visor se carga con un documento.

Crear una configuración de ejecución1. En la barra de herramientas, haga clic en Preferencias.

2. Seleccione Configuraciones de ejecución en el cuadro de diálogo Preferencias.

3. Haga clic en Agregar.

4. En el cuadro de diálogo Agregar configuración de ejecución, especifique la configuración básica,tal y como se describe en la tabla siguiente:

Campo Descripción

Nombre Escriba un nombre para la configuración.

Entorno Seleccione el entorno de implementación para laconfiguración.



Campo Descripción

Método de implementación Seleccione Completo para implementar la aplicacióncompleta.

Seleccione Incremental para implementar solo loscomponentes de la aplicación que han cambiado desde laúltima implementación o los componentes nuevos de laaplicación (por ejemplo, un modelo de objeto de negocioactualizado o una nueva página de aplicación).

Directiva de datos La directiva de datos define lo que les sucede a los datos deaplicación en el entorno al ejecutar una nueva versión de laaplicación. Los ejemplos de datos de aplicación incluyeninstancias en tiempo de ejecución de objetos de negocio,objetos de contenido, procesos e informes.

Seleccione Limpiar para eliminar los datos de aplicación.

SeleccioneMínimo para actualizar los datos de aplicaciónasociada con los componentes de la aplicación que hancambiado desde la última implementación.

SeleccioneMantener para conservar los datos de aplicación.La ejecución de la aplicación actualizada no afecta a los datosde aplicación existentes en el entorno.

Procedimientos recomendados: utiliceMantener cuandohaya una implementación de producción existente de laaplicación en la que está trabajando y desee modificar laaplicación. La configuración de la implementación para queutilice el modoMantener garantiza que se capturarán todoslos problemas de actualización de datos antes de llevar a cabola implementación en el entorno de producción. Utilice unconjunto de datos de prueba representativo en el entorno dedesarrollo para capturar de forma precisa todos los problemasque puedan producirse en la fase de producción al intentarimplementar de nuevo la aplicación actualizada.

Un entorno configurado para implementar modo admite todaslas directivas de datos. Un entorno configurado para el modode producción solo admite la directivaMantener.

Si dispone de datos de prueba importantes, cree secuenciasde comandos del cargador de prueba mediante código DFCde Java, API o DQL para cargar los datos. Si la directiva dedatos se ha establecido enMínimo o Limpiar, podría perderlos datos de prueba, lo que implica que necesita un métodoautomatizado para volver a proporcionarlos.



Campo Descripción

Descripción Escriba una descripción de la configuración.

Implementar el war en el servidor deaplicaciones

Realice alguno de los procedimientos siguientes:

• Deshabilitar: si desea implementar el archivo WAR deaplicación solo en el repositorio, no seleccione esta opción.Cuando está deshabilitada, el sistema permite implementarlos cambios rápidamente.

• Habilitar: si desea implementar la aplicación WARtanto en el host de aplicaciones como en el repositoriode archivos, seleccione esta casilla de verificación parapermitirlo. Esta es la opción predeterminada.

Note: si ejecuta una aplicación implementada anteriormente en un entorno establecido en el modode desarrollo y la aplicación comparte una biblioteca con otra aplicación del entorno, el sistemaelimina los datos de ambas aplicaciones cuando el método de implementación se establece enCompleto y la directiva de datos se establece en Limpiar.

5. Haga clic en Siguiente.6. Seleccione la indexación xPlore como Asíncrono o Síncrono y, a continuación, haga clic en

Siguiente.

Asíncrono es el modo de indexación predeterminado. En caso de la indexación asíncrona, elprograma de reconstrucción del índice se ejecuta en segundo plano. El mensaje de implementacióncorrecta de la aplicación xCP Designer no significa que la reindexación, si es necesaria, se hayacompletado en xPlore. Antes de utilizar la aplicación xCP Designer, compruebe que la indexaciónse haya completado.

7. Para asignar distintos valores de punto final y parámetro a la configuración:a. En la columnaConfiguración del cuadro de diálogo, amplíe el nodo del punto final o parámetro.b. En la columna Datos, haga doble clic en la celda del valor que desea cambiar.c. Escribir un nuevo valor.


Editar una configuración de ejecución1. En la barra de herramientas, haga clic en Preferencias.2. Seleccione Configuraciones de ejecución en el cuadro de diálogo Preferencias.3. Para editar solo la configuración básica, haga clic en la celda de la configuración y escriba o

seleccione un nuevo valor. Vaya al paso 5.4. Para editar el punto final y los valores de parámetros:

a. Seleccione la configuración de ejecución en la lista y haga clic en Editar.b. Haga clic en Siguiente.c. En la columnaConfiguración del cuadro de diálogo, amplíe el nodo del punto final o parámetro.d. En la columna Datos, haga doble clic en la celda del valor que desea cambiar.e. Escribir un nuevo valor.f. Haga clic en Finalizar.




Ejecutar una aplicación en un entorno deimplementación1. Abra la aplicación desde la página Inicio.

2. En la barra de herramientas, haga clic en Ejecutar aplicación para ejecutar la aplicación con laconfiguración de ejecución predeterminada o seleccione una configuración de ejecución diferente.

Puede cancelar la ejecución de la aplicación durante la validación, la compilación y las fases deempaquetado. No puede cancelar la ejecución de la aplicación durante la fase de implementación.Haga clic en Ejecutar en segundo plano para continuar trabajando en la aplicación mientras seimplementan los cambios anteriores.

La barra de progreso no muestra el estado actual del progreso de la implementación. Parece comosi la barra de progreso estuviera detenida mientras se realizan los pasos de implementación ensegundo plano.

Después de que el sistema valide e implemente la aplicación, la página principal de la aplicaciónse abre en el explorador predeterminado del equipo. Puede configurar la aplicación para que seagote el tiempo de espera de la misma tras un periodo especificado. Si se agota el tiempo de esperade la aplicación, el usuario final debe iniciar sesión de nuevo.

Empaquetar una aplicación para una implementaciónposterior1. En la barra de herramientas, haga clic en Paquete.

2. En el cuadro de diálogo Nuevo paquete de aplicación xCP, especifique la carpeta para el paquetede aplicación de una de las dos formas siguientes:

• Escriba la ruta de acceso a la carpeta en el cuadro de texto Examinar carpeta.

• Haga clic en Seleccionar carpeta para buscar carpetas disponibles. Seleccione la carpeta para elpaquete de aplicación. Haga clic en Seleccionar carpeta. El cuadro de diálogo Nuevo paquetede aplicación xCP muestra la ruta de acceso a la carpeta seleccionada en el cuadro de textoExaminar carpeta.

3. Haga clic en Finalizar.El sistema valida la aplicación. Si la aplicación no es válida, se muestra un mensaje de error.Si la aplicación es válida, el sistema compila la aplicación, crea un paquete de aplicación ymuestra la ruta de acceso para el paquete de aplicación en el cuadro de diálogo Nuevo paquetede aplicación xCP.

4. Haga clic en Aceptar para cerrar el cuadro de diálogo Nuevo paquete de aplicación xCP.

Puede proporcionar la ubicación del paquete de aplicación a su aplicación de xCP o al administradordel sistema. El administrador de la aplicación o del sistema utiliza xCelerated Deployment Agent(xDA) para implementar el paquete de la aplicación en un entorno de ensayo o producción.


Configurar las opciones de tiempo de espera de laaplicación1. En el entorno de implementación, desplácese al archivo web.xml de la aplicación.

En el ejemplo siguiente se muestra la ruta de acceso al archivo para una aplicación denominadaPréstamo:

C:\tcserver\apphost\webapps\Loan\WEB-INF\web.xml

2. Abra el archivo en un editor de texto.3. Especifique el valor de tiempo de espera en segundos.

En el ejemplo siguiente se muestra un tiempo de espera de la aplicación de dos horas:

<session-config><session-timeout>120</session-timeout></session-config>

4. Guarde los cambios realizados en el archivo.

Empaquetar mediante Apache MavenRequisitos previos

• Instalar Apache Maven 3.x. Para que el empaquetado de CLI funcione en modo sin conexión, laversión compatible es Apache-Maven 3.0.5.

• Defina JAVA_HOME en el directorio donde esté instalado JDK 7. Por ejemplo, seleccione el JDK 7de 32 bits para una aplicación xCP de 32 bits y JDK 7 de 64 bits para una aplicación xCP de 64 bits.

• Configure Maven para que se pueda acceder a él desde la consola.Pasos:1. Desplácese al directorio de la aplicación xCP de su sistema de archivos.2. Configure un repositorio de Maven y agregue el repositorio a la aplicación xCP.3. Edite el archivo POM de cada proyecto y agregue <repositorio>, <pluginRepository>,

elementos. Agregue el elemento <vmArgs> a las secciones de importación y validación delarchivo POM:

<repositories><repository><id>Builder</id><url>http://localhost:2910/maven</url></repository>

<repository><id>Builder-offline</id><url>file:///C:/.../xCPDesigner/maven/designer</url> (Path to Maven directory)</repository></repositories>

-----------------------------------------------------------<pluginRepositories><pluginRepository><id>Builder</id>

<url>http://localhost:2910/maven</url></pluginRepository>

<pluginRepository><id>Builder-offline</id><url>file:///C:/.../xCPDesigner/maven/designer</url> (Path to Maven directory)

</pluginRepository></pluginRepositories>

------------------------------------------------------------

4. Edite el archivo settings.xml en Maven y agregue el elemento <mirror>:

<settings xmlns=" http://maven.apache.org/SETTINGS/1.0.0 "xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance "xsi:schemaLocation=" http://maven.apache.org/SETTINGS/1.0.0http://maven.apache.org/xsd/settings-1.0.0.xsd "><profiles><profile><id>xcp-designer</id><properties><designerPath>C:\xCPDesigner</designerPath>

</properties></profile>

</profiles><activeProfiles><activeProfile>xcp-designer</activeProfile>

</activeProfiles><mirrors><mirror><id>Builder-offline</id><url>file:///c:/xCPDesigner/maven/designer</url><mirrorOf>Builder</mirrorOf></mirror>

</mirrors></settings>

Asegúrese de que settings.xml está disponible en la carpeta <directorio-de-inicio>/.m2.

SI ha ejecutado el paso 3, puede omitir este paso.

5. Para aumentar el tamaño de la pila, agregue el elemento <vmArgs> al archivo POM.



<plugin><groupId>com.emc.xcp.builder</groupId><artifactId>xcp-import-project</artifactId><version>1.0.4</version>

<configuration><mavenRepoPath>maven/designer</mavenRepoPath><vmArgs>-Xms512m -Xmx768m -XX:PermSize=256m-XX:MaxPermSize=512m</vmArgs>

</configuration></plugin><plugin>

<groupId>com.emc.xcp.builder</groupId>

<artifactId>xcp-validate</artifactId><version>1.0.10</version><executions>

<execution><id>xcp-validate</id><goals>

<goal>run</goal></goals>

</execution></executions><configuration><dir>${basedir}/Artifacts</dir><mavenRepoPath>maven/designer</mavenRepoPath><vmArgs>-Xms512m -Xmx768m -XX:PermSize=256m-XX:MaxPermSize=512m</vmArgs>

</configuration></plugin>

6. Guarde los cambios.

7. Cree un nuevo archivo POM.xml en el mismo nivel de carpeta Applications:

<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:

xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0

http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>cactus</groupId><artifactId>parent</artifactId><version>1.0.0</version><packaging>pom</packaging>

<modules><module>../Project_New_Customer_On_Boarding</module><module>../Customer_Services</module><module>../Casual_and_Property_Insurance</module>

</modules>

<build><plugins>

<plugin><groupId>com.emc.xcp.builder</groupId><artifactId>xcp-import-project</artifactId><version>1.0.4</version><configuration><vmArgs>-Xms512m -Xmx768m -XX:PermSize=256m

-XX:MaxPermSize=512m</vmArgs></configuration>

</plugin>

<plugin><artifactId>maven-deploy-plugin</artifactId><version>2.5</version><executions>

<execution><id>default-deploy</id>

<phase/></execution></executions>

</plugin></plugins>

</build>

<pluginRepositories><pluginRepository>

<id>Builder</id><releases>

<enabled>true</enabled><updatePolicy>never</updatePolicy>

</releases><snapshots>

<enabled>true</enabled><updatePolicy>never</updatePolicy>

</snapshots><url>file:///C:/tmp1/BuildZips/x5290/

xCPDesigner/maven/designer</url>

</pluginRepository></pluginRepositories>

</project>

Este paso es necesario únicamente cuando hay varios módulos que constan de aplicación y variosproyectos.

8. Ejecute el comando mvn xcp-import-project:run para importar proyectos a su máquinalocal.

9. Desplácese hasta el archivo POM recién creado en la línea de comandos y ejecute el siguientecomando:

mvn install "-DdesignerPath=<path_xCP_Designer>"

Los archivos JAR compatibles con SAP Crystal Reports se han desacoplado de xCP Designer enesta versión. Es obligatorio proporcionar la ubicación de los archivos JAR tal como sigue:

mvn xcp-import-project:run install -DdesignerPath=<Designer folder path>-Dcom.sap.cr.lib.path=<Crystal Report JARs folder path>

Ejemplomvn xcp-import-project:run install -DdesignerPath="C:\BuildZips\build1\xCPDesigner"-Dcom.sap.cr.lib.path={C:\Shared\app1}

Maven crea los archivos .WAR y .config.xml para la aplicación creada con xCP Designer.

10. También puede ejecutar los siguientes comandos de Maven:

Sintaxis

mvn [goals | phases] [options]

Argumentos


Argumento Tipo Descripción

xcp-import-project:run Objetivo Importa el proyecto al espacio de trabajo en el equipolocal. Es podrán que surja un error si el proyecto ya estádisponible en su espacio de trabajo.

validate Fase Valida el proyecto en busca de errores y garantiza que lainformación pertinente está disponible.

generate-sources Fase Genera un código de origen de un proyecto.

package Fase Compila el archivo WAR de una aplicación creada con xCPDesigner.

deploy Fase Implementa la aplicación xCP en el entorno. Tiene 2argumentos:

• envConfigFile: especifique la ruta relativa o absoluta alos archivos de propiedades de configuración del entorno.Agregue estas líneas a este archivo:# dataPolicy:CLEAN, MINIMAL,

MAINTAIN# deploymentMethod: INCREMENTAL,

FULLdeploymentService=com.emc.xcp.builder.deployment.XMSDeploymentServicedataPolicy=MINIMALdeploymentMethod=INCREMENTALxda.host=xda.port=xda.username=xda.password=xda.environmentNamexda.protocolrepositoryServicesOnly=true

//repositoryServicesOnly is anoptional parameter.Set to true if you need toperform a model-only deployment.Set false for deployment toall endpoints including theapplication hostDefault value is false.

• appConfigFile: especifique la ruta relativa del proyectoo la ruta absoluta al archivo XML de configuración dela aplicación.

install Fase Instala el paquete en el repositorio local.

clean Fase Elimina todos los proyectos que se hayan generadomediante la compilación anterior.



Argumento Tipo Descripción

-D<clave>=<valor> Opción Define las propiedades del sistema:

• (Obligatoria) designerPath: especifique la ruta de xCPDesigner donde se ha instalado.

• (Opcional) workspace: especifique la ruta del área detrabajo.

• – DoutputDirectory: especifique la ubicación deldirectorio de salida donde exportar los distintos archivosJAR de proyectos de la aplicación.

-X Opción Muestra la información de depuración.

11. Para obtener la versión del proyecto, utilice el comando siguiente:

mvn org.apache.maven.plugins:maven-help-plugin:2.1.1:evaluate-Dexpression=project.version

Puede analizar la salida del comando para obtener el valor de la versión del proyecto.

La página de Apache Maven proporciona información sobre los complementos y las fases deobjetivos de Maven.

Adoptar modelos de objeto de un repositorioAsegúrese de que el punto final del repositorio esté configurado para realizar esta actividad.1. En Navegador de migración > Modelos de objeto, haga clic en cualquiera de los modelos de

objeto y haga clic en Adoptar desde el repositorio.2. En el cuadro de diálogo Adoptar desde el repositorio, seleccione un entorno en tiempo de diseño.

El sistema rellena el nombre del entorno en tiempo de diseño.3. Seleccione el nombre de un proyecto en el que desee importar los tipos del repositorio. Haga

clic en Siguiente.4. Especifique los tipos de objetos de negocio, contenido, archivador y carpeta necesarios que desee

adoptar.

Al adoptar el subtipo dm_sysobject, el sistema permite adoptarlo como un objeto de negocio ocomo un modelo de contenido. Después de adoptar un tipo de datos, no se puede adoptar segúnotro tipo, así que piénselo bien antes de seleccionar el adecuado para la adopción.

Al adoptar un objeto subtipo de dm_sysobject como Contenido, el sistema le permite versionar yadjuntar contenido a ese objeto. Los eventos de negocio y las páginas de interfaz de usuario sepueden componer de forma parecida a como se componen los modelos de objetos de contenido.

5. Haga clic en Finalizar y, a continuación, haga clic Aceptar.

Si la operación se ha realizado correctamente, el sistema muestra los tipos de datos adoptados. Unavez que se adopta el tipo de datos para una aplicación específica, el sistema no permite adoptar denuevo el mismo tipo de datos.

Migrar tipos de ComposerPuede migrar los tipos creados con la aplicación Composer a xCP Designer.



Este procedimiento se aplica a modelos de objeto de negocio, carpeta, archivador y contenido.1. En el Navegador de migración, haga clic con el botón derecho del ratón en Tipos de Composer y

seleccioneMigrar de proyecto de Composer.2. En el cuadro de diálogoMigrar tipos de Composer, especifique las propiedades tal y como se


Campo Descripción

Ubicación del proyecto Haga clic en Examinar para desplazarse a la carpeta delproyecto en su sistema de archivos y haga clic en Aceptar.

Este proyecto se crea utilizando la aplicación Composer.

Proyecto Seleccione la aplicación o el proyecto al que desee migrarlos tipos de Composer.

3. Haga clic en Siguiente.4. Revise los tipos y seleccione la casilla de verificación junto a cada tipo que desee migrar.5. Haga clic en Finalizar.

Note: La regla de migración de tipos de Composer permite elegir el tipo de datos para la migracióndel tipo de Composer seleccionado.

Note: Composer no es compatible con la importación de artefactos de xCP porque los artefactosenumerados en Sysobjects no tienen nombres de objeto adecuados. Además, cuando se instalan losartefactos en otro Docbase, se pierden las referencias.

Utilizar el navegador de migraciónEste procedimiento es aplicable a estos componentes: proceso, tipos, conjuntos de permisos yconjuntos de alias.1. En la barra de herramientas, haga clic en Navegador de migración.2. Seleccione cualquiera de los componentes y haga clic con el botón derecho del ratón en él.3. Seleccione la opciónMigrar de proyecto de Composer y especifique la ruta del proyecto. Por

ejemplo, la ruta del proyecto creado con Composer.

Note: También se puede migrar el proceso utilizando la opciónMigrar desde el repositorio.Antes de llevarlo a cabo, debe configurar el entorno de tiempo de diseño.

4. EnMigrar de proyecto de Composer, seleccione la aplicación o el proyecto al que desee migrarel componente seleccionado.

5. Haga clic en Siguiente.6. Seleccione el artefacto de componente de la lista para la migración y haga clic en Finalizar.7. Haga clic en o haga doble clic en el componente y seleccione Recuperar pasos de migración.8. Según el componente seleccionado, haga lo siguiente:

a. Conjuntos de alias:en la pestaña Valores de alias, seleccione el valor de alias como unparámetro de aplicación o un artefacto según corresponda.

Nota: Para el tipo de alias Ruta de archivador definido en Composer, obtendría un tipode alias equivalente Ruta de archivador o carpeta en Designer.Nota: Como práctica



recomendada, si desea conservar los mismos valores de alias definidos en Composer, migre elartefacto utilizado en el alias primero y migre el conjunto de alias a continuación.

b. Tipos de Composer: para migrar tipos creados con la aplicación Composer a xCP Designer,consulte Migrar tipos de Composer, página 494.

c. Conjuntos de permisos: en la pestaña Reglas de migración de conjunto de permisos, asignelos descriptores de acceso a los parámetros de aplicación para resolver la dependencia.

En las aplicaciones de 1.x, los parámetros de instalación proporcionan los valores para losdescriptores de acceso. El equivalente del parámetro de instalación es el parámetro deaplicación en la versión actual de xCP Designer. Es necesario asignar los parámetros deinstalación a los parámetros de aplicación, de modo que estos valores se rellenen en losdescriptores de acceso durante la migración.

d. Proceso: en función de la estructura del proceso y sus componentes, pueden aparecer variaspestañas: Propiedades de proceso, Paquetes de proceso y parámetros de procesos, y Actividades.

Solo aparecerán las fichas relevantes según los pasos realizados durante la fase previa a lamigración. Si alguno de los componentes de proceso no aparece, significa que el asistente parala migración ha migrado el componente correctamente de forma automática.

e. Modelos de objeto: para adoptar el modelo de objeto Objeto de negocio, Archivador,Contenido y Carpeta del repositorio, consulte Adoptar tipos de datos, página 494.

9. Resuelva todas las dependencias mediante los pasos previos a la migración.

Note: Una vez que se hayan resuelto todas las dependencias, puede continuar con la migración.10.Haga clic en el componente con el botón derecho del ratón y haga clic en Iniciar migración.

El cuadro de diálogo indica la finalización correcta de la migración. Si se produce algún error,el sistema le mostrará un registro de errores. El registro de migración proporciona un registro delas actividades realizadas para migrar artefactos a xCP Designer. Los registros se encuentranen el mismo lugar que el archivo de registro de xCP Designer. Para completar la migración, esnecesario resolver los errores.

Durante todo el curso de la migración, los artefactos se someten a un cambio de estado del modosiguiente:

//Change in statePending -> Ready -> Done

Pending -> Ready (Occurs when you validate the inputs using Validate Inputs.)Ready -> Done (Happens when you perform the Start Migration activity.)

Actualmente, la migración no conserva su estado. Esto significa que, si se cierra el artefacto demigración o xCP Designer, se puede perder el progreso y por lo tanto, deberá reiniciar el procesode migración.

El sistema valida toda la migración e indica la finalización correcta de la migración.

Conceptos

Configuraciones para la ejecución de aplicacionesUna configuración de ejecución almacena la configuración de implementación para ejecutar unaaplicación de xCP Designer para que no tenga que especificar la configuración cada vez que ejecute la



aplicación. Las configuraciones de ejecución permiten a un equipo de desarrolladores de aplicacionesejecutar la misma aplicación en entornos diferentes. Por ejemplo, se crea una configuración paraejecutar una aplicación en el entorno de implementación A. Otro desarrollador de aplicaciones utilizaun sistema de control de origen para obtener la última versión de la aplicación y crea una configuraciónpara ejecutar la aplicación en el entorno de implementación B.

Puede probar distintos valores de punto final y parámetro con la aplicación mediante la asignación dediferentes valores de punto final y parámetro para la configuración en ejecución. Cambiar los valoresen la configuración de ejecución no cambia los valores en los modelos de punto final y parámetros.

Cuando se ejecuta la aplicación en entorno de xCelerated Deployment Agent (xDA) configuradopara el modo de implementación, el sistema sobrescribe el parámetro implementado previamente ylos valores del punto final con los valores del parámetro y los valores del punto final del archivo deconfiguración. Si el modo de entorno está configurado para la producción, el sistema no sobrescribelos valores de punto final y de parámetro implementados previamente.

Puede establecer configuraciones de ejecución para varios entornos de desarrollo. Por ejemplo, la fasede reindexación puede durar unos minutos al volver a implementar una aplicación para un repositoriocon miles de objetos. Puede probar la aplicación con dos entornos: uno con un repositorio con solounos cientos de objetos y un segundo entorno con un repositorio que tenga más objetos.

Si realiza un cambio en un objeto de negocio implementado para el que es necesario destruir los datos,al volver a ejecutar la aplicación, es obligatorio volver a implementar las definiciones de objeto denegocio. Se eliminan los datos asociados al objeto de negocio en los siguientes casos:

• Eliminación de un atributo de un tipo

• Cambio de nombre de un atributo en un tipo

• Reducción de la longitud de un atributo de cadena

• Cambio de un atributo de único a repetido

• Cambio de un atributo de repetido a único

Las instancias de objetos de negocio también se suprimirán cuando el objeto se elimine de la aplicación.

Si dispone de datos de prueba en su entorno, cualquiera de los cambios realizados en el modelo dedatos indicados anteriormente provocan la pérdida de algunos datos. Como práctica recomendada paraestas situaciones, cree secuencias de comandos del cargador que utilicen código DFC de Java, API oDQL para cargar los datos y utilice de forma periódica la opción de limpieza para borrar los datos y,a continuación, cargarlos de nuevo.

Como práctica recomendada, si realiza un cambio en una aplicación que ya esté en producción, utilicela directiva de datos de mantenimiento para asegurarse de que no se producen problemas durante laactualización de la aplicación, puesto que "Mantener" es la única directiva de datos admitida en elentorno de producción.

Empaquetar una aplicaciónUna aplicación debe empaquetarse para que se pueda implementar en un entorno de implementación,ensayo o producción. El empaquetado es el proceso automatizado de validación y compilación de unaaplicación, así como de su transformación al formato adecuado para un entorno de implementación.

Hay tres métodos de empaquetado de una aplicación:



• Ejecutar una aplicación desde la barra de herramientas empaqueta e implementa una aplicación,normalmente en un entorno de implementación.

• Empaquetar una aplicación desde la barra de herramientas. A continuación, una aplicación o unadministrador del sistema utiliza xCelerated Deployment Agent (xDA) para implementar el paquetede la aplicación en un entorno de ensayo o producción.

• Empaquetar una aplicación mediante la interfaz de la línea de comandos.

Empaquetar mediante la interfaz de la línea de comandos

Si usa el siguiente método de la interfaz de línea de comandos, podrá empaquetar aplicaciones yproyectos que se hayan creado con xCP Designer.

Empaquetar mediante Apache Maven

Todos los proyectos xCP Designer son proyectos de Maven estándares. Cada proyecto contiene unarchivo de modelo de objeto de proyecto (POM) en formato XML ubicado en la carpeta raíz de laaplicación.

Las plataformas Windows y Linux admiten este tipo de archivo.

Para empaquetar en Linux:

• Primero debe instalar la versión de 64 bits de JDK 7.0.x en el sistema ya que Java no se incluyeen la compilación de Linux.

• Debe instalar Apache Maven 3.0.5.

• Debe utilizar la misma versión del Linux Designer que coincide con la versión del WindowsDesigner desde el que se exporta la aplicación xCP.

Para obtener la lista de las versiones compatibles de plataformas Windows y Linux, consulte las Notasde la versión de EMC Documentum xCelerated Composition Platform.

Archivo de registro de implementación deaplicacionesAl hacer clic en la opción Ejecutar aplicación de la barra de herramientas, el sistema genera el archivorunapp.log. Todos los mensajes de implementación de aplicaciones, incluidos los de validación,estado, advertencia y error, se registran en este archivo. Cada vez que ejecute la aplicación, el sistemasobrescribirá el archivo de registro.

Puede consultar el archivo de registro de implementación de la aplicación de una de las siguientesformas:

• Durante la implementación de la aplicación, consulte los mensajes del registro de ejecución en lavista Consola.

• Si la implementación no funciona, haga clic en Ver registro en el cuadro de diálogo Preparándosepara ejecutar la aplicación xCP.



• Una vez finalizada la implementación, correctamente o con errores, vaya axCPDesigner\Applications\<espacio de trabajo de la aplicación>\<proyecto de aplicación>\ y abrael archivo runapp.log en un editor de texto.

Modo de vista previaPuede obtener una vista previa de la aplicación en un navegador durante el diseño. Esta funciónreemplaza la necesidad de la implementación integral para ver los cambios de diseño de una aplicación,lo que ahorra tiempo y recursos.

Por ejemplo, cuando realiza cambios en xCP Designer, como cambios de etiquetas, alineación dewidgets y cambios de IU, puede guardar la aplicación y obtener una vista previa de ella en el navegadorpara ver todos los cambios.

Al hacer cambios en las expresiones, en las variables de sesión o en los eventos de la interfaz deusuario, podrá verlos en el modo de vista previa solo cuando la caché del navegador esté desactivada.

Para que funcione, debe implementar los objetos docbase para el modo de vista previa. El modo devista previa solo abarca los cambios a nivel de IU y es necesario que antes de la vista previa no se hayaimplementado nada que requiera una representación de docbase.

El modo de vista previa funciona con estos servidores:

• Servidor Webby integrado• Servidor Tomcat externo: consulte la sección Modo de vista previa mejorada en servidor Tomcat,página 500.

Modo de vista previa en el servidor Webby

A continuación encontrará una lista de los parámetros que pueden configurar los usuarios para iniciarel modo de vista previa:

• webby.containerTimeout: especifica el tiempo de espera del contenedor webby.• webby.containerPort : especifica el puerto del contenedor webby.• preview.mode.debug: ejecuta la configuración de inicio del contenedor webby en modo dedepuración.

• displayWebbyView: agrega la vista de consola Webapps.• webby.jvmArgument: especifica los argumentos de la JVM para el contenedor webby. El valorpredeterminado es XX:PermSize=192m -XX:MaxPermSize=192m -Xms512m -Xmx832m.

Puede configurar el entorno de tiempo de diseño y asociarle el modo de vista previa. El mejorenfoque es establecer el entorno de tiempo de diseño predeterminado entorno de tiempo de diseño,página 484 para la aplicación y, al iniciar el modo de vista previa, el sistema selecciona el entorno deforma predeterminada.

El modo de vista previa está disponible en el menú principal. Hay cuatro opciones:

• Vista previa en navegador: vuelve a cargar la URL de contexto cada vez y redirige a la aplicación.• Iniciar el modo de vista previa: inicia una instancia del modo de vista previa.• Detener el modo de vista previa: detiene la instancia existente del modo de vista previa.• Reiniciar el modo de vista previa: detiene una instancia existente del modo de vista previa e iniciauna nueva instancia.


Si hay errores en la pestaña Problemas, el modo de vista previa no refleja los cambios realizados enxCP Designer, a menos que todos los errores se resuelvan.

Si agrega un widget a una página e intenta obtener una vista previa en el navegador sin una recarga decontexto, el sistema muestra los mensajes localizados y no los mensajes reales. Tras la recarga delcontexto, el sistema muestra los mensajes reales.

Modo de vista previa mejorado en el servidor TomcatRequisitos previos: asegúrese de que el servidor Tomcat esté instalado y configurado.

El modo de vista previa funciona con el servidor Webby integrado. Ahora, se puede utilizar un servidorde aplicaciones Tomcat externo para obtener una vista previa de la aplicación xCP en un navegadoren tiempo de diseño.

Para resolver estos problemas, se introduce el entorno de servidor Tomcat:

• Problemas de memoria, ya que el servidor Webby ocupa mucho espacio

• Se puede implementar de forma remota una aplicación en un servidor Tomcat externo

En el servidor Tomcat: una vez que está instalado el servidor Tomcat, vaya al archivocontext.xml disponible en la carpeta conf y haga lo siguiente:

• Añada estos atributos al elemento Contexto:antiResourceLocking="true"crossContext="true"

• Añada el elemento hacia el final del archivo, como sigue:<ContextantiResourceLocking="true" crossContext="true">

<WatchedResource>WEB-INF/web.xml</WatchedResource>

<WatchedResource>WEB-INF/classes</WatchedResource>

<Valve className="org.apache.catalina.authenticator.BasicAuthenticator" /></Context>

En xCP Designer: una vez instalado xCP Designer, vaya a la siguiente carpeta para implementar elarchivo WAR en el servidor Tomcat:plugins/com.emc.xcp.preview.tomcat/war

Puede configurar el entorno de tiempo de diseño y asociarle el modo de vista previa. Al configurarel entorno de tiempo de diseño, el sistema le ofrece la opción de seleccionar el entorno de servidorTomcat. El mejor enfoque es establecer el entorno de tiempo de diseño predeterminado entornode tiempo de diseño, página 484 para la aplicación y, al iniciar el modo de vista previa, el sistemaselecciona el entorno de forma predeterminada. El modo de vista previa admite solo en el modo HTTP.

Los cambios realizados relacionados con la interfaz de usuario se aplican a la aplicación alojada en elservidor Tomcat sin necesidad de reiniciar el servidor Tomcat. Sin embargo, los cambios realizadosen el repositorio, como cambios en los objetos de negocio, las listas desplegables y otros artefactossimilares, requieren la implementación de estos artefactos en el repositorio y, por lo tanto, requierenreiniciar el modo de vista previa.


Casos de uso del modo de vista previa

Supongamos que se ha habilitado el modo de vista previa con el modelo de objeto implementado en elservidor de aplicaciones. La siguiente tabla describe los diferentes casos de uso:

Caso de uso Funcionamiento del modo de vista previa

Agregar una página o un fragmento depágina nuevos

1. Cree una página o un fragmento de página en xCP Designer.

2. Vincule la página con la página principal de la aplicación ocon cualquier otra página de contenedor.

3. Guarde los cambios que desencadenan la compilacióninternamente. Asegúrese de que se complete la compilación.

4. Utilice el modo Vista previa en el navegador para ver lanueva página desde el enlace de la página principal.

Modificar el diseño de una página o de unfragmento de página

1. Modifique el diseño de una página o de un fragmento depágina en xCP Designer.


3. Actualice el navegador para ver las modificaciones que se hanrealizado en la página o el fragmento de página.

Agregar o modificar un flujo de acción 1. Agregue o modifique las configuraciones de flujos de acciónpara una página del paso en xCP Designer.


3. Utilice el modo Vista previa en el navegador para ver loscambios realizados en el flujo de acción.

Agregar o modificar un menú de contexto 1. Agregue o modifique las configuraciones de menús decontexto en xCP Designer.


3. Utilice el modo Vista preliminar en el navegador para verlos cambios realizados en el menú contextual.

Agregar o modificar un evento de IU 1. Agregue o modifique las configuraciones de eventos de IUen xCP Designer.


3. Borre la caché del navegador.

4. Utilice el modo Vista previa en el navegador para ver loscambios realizados en el evento de IU.



Caso de uso Funcionamiento del modo de vista previa

Agregar o modificar una variable de sesión 1. Agregue o modifique las configuraciones de variables desesión en xCP Designer.



4. Utilice el modo Vista previa en el navegador para ver loscambios realizados en las variables de sesión.

Agregar o modificar una expresión 1. Agregue o modifique las expresiones en los artefactos de IU.



4. Utilice el modo Vista previa en el navegador para ver loscambios realizados en las expresiones.

Consejos sobre solución de problemas

Siga los siguientes pasos cuando se produzca un error al visualizar la vista previa de la aplicaciónde xCP en el modo de vista previa.

Cuando se producen errores en el modo devista previa

Realizar una acción

Errores de la aplicación en el modo de vistaprevia

• Compruebe si la aplicación tiene errores de validación.Solucione los errores y el modo de vista previa reflejarálos cambios guardados.

• Los modelos y los tipos en la aplicación no estánsincronizados con los modelos de Docbase.

Las páginas o los fragmentos de página nuevosno se muestran en el modo de vista previa

Utilice el modo Vista previa en el navegador para volvera cargar la aplicación.

Las expresiones, los eventos de IU o losparámetros de sesión no se muestran en elmodo de vista previa

Borre la caché del navegador y ejecute la aplicación medianteel modo Vista previa en el navegador.

Los mensajes localizados no se muestran en elmodo de vista previa

Utilice el modo Vista previa en el navegador para volvera cargar la aplicación.



Cuando se producen errores en el modo devista previa

Realizar una acción

El modo de vista previa no está habilitado Compruebe que la opción Compilar automáticamente estáhabilitada.

Error HTTP 404 no encontrado del modo devista previa

Este error se produce si la aplicación tiene errores devalidación durante la importación de artefactos. Siga lospasos para solucionar este problema:

1. Habilite la opción Compilar automáticamente ysolucione los errores de validación.

2. Cierre xCP Designer.

3. Elimine la carpeta <app home>/target/m2e-webby.

4. Reinicie xCP Designer para reflejar los cambiosguardados.

Este error también se produce si el contenedor webby no logracargarse en un valor de tiempo de espera especificado. Por lotanto, se debe aumentar el tiempo de espera del contenedormediante el parámetro webby.containerTimeout parasolucionar este error.

Compilar automáticamenteLa función Compilar automáticamente permite que el sistema compile automáticamente la aplicacióncada vez que abra la aplicación o guarde los artefactos. El proceso de compilación de la aplicación esde naturaleza incremental; significa que solo se tendrán en cuenta los componentes de la aplicaciónque hayan cambiado o que se hayan visto afectados por el cambio desde la última compilación. Tengaen cuenta que al crear un proyecto por primera vez con xCP Designer, la compilación automática dela aplicación está deshabilitada de forma predeterminada, por lo que se reduce el tiempo empleadopara abrir la aplicación xCP.

Deshabilitar la función Compilar automáticamenteA veces el proceso de compilación de todos los artefactos puede llevar mucho tiempo debido al tamañoy a la complejidad de estos artefactos. Para realizar todas las actividades relacionadas con la creaciónde una aplicación sin interrumpir el flujo de su trabajo, puede deshabilitar la función Compilarautomáticamente y habilitarla cuando haya finalizado. Por ejemplo, si fuese necesario crear 200objetos de negocio para una aplicación, puede deshabilitar la función Compilar automáticamentey, a continuación, crear todos los objetos de negocio. Después de haber creado estos 200 objetosde negocio, puede habilitar la compilación automática y se desencadenará una vez la compilaciónincremental para estos recién creados 200 objetos de negocio.

No se puede deshabilitar la compilación actual hasta que la compilación no se haya completado.

Tenga en cuenta que el modo de vista previa no funciona cuando deshabilita la implementaciónautomática de la aplicación. Para obtener una vista previa de los cambios, debe habilitar la funciónde compilación automática.



El estado de la función Compilar automáticamente se mantiene para la siguiente instancia de xCPDesigner. Por ejemplo, si se deshabilita la función Compilar automáticamente y cierra xCP Designer,la función permanecerá deshabilitada al abrir xCP Designer la próxima vez.

Validar una aplicaciónAl habilitar la función Compilar automáticamente, se activa la compilación y los artefactos sevalidan automáticamente, por lo que no hay necesidad explícita de validarlos. Cuando la función estádeshabilitada, la funcionalidad de la aplicación Validar le permite validar los artefactos sin compilar laaplicación. Tenga en cuenta que al deshabilitar la función Compilar automáticamente, el sistema novalida la aplicación en busca de errores. La compilación incremental siguiente realiza la validación delos componentes de la aplicación que hayan cambiado desde la última compilación. Normalmente, sila aplicación tiene errores, estos se muestran en la vista Problemas de la página.

Opciones de implementación para la productividadde los desarrolladoresUn consultor o un desarrollador empaqueta una aplicación creada en xCP Designer cuando estálista para implementarse en un entorno de pruebas o producción. El empaquetado es el procesoautomatizado de validación y compilación de una aplicación, así como de su transformación al formatoadecuado para un entorno de implementación. El proceso de creación de paquetes genera dos archivos:un archivo WAR y un archivo de configuración de la aplicación en formato XML.

Implementar una aplicación es una operación que consume mucho tiempo y requiere varios pasos. Elsistema prepara un paquete limpio de la aplicación e implementa todos los componentes en variosservidores. En otras palabras, esto incluye la instalación (completa o incremental) de artefactosen Content Server, servidor BAM y servidor xPlore, así como la implementación del WAR de laaplicación en el servidor de aplicaciones. Con las optimizaciones existentes diseñadas para ejecutar lasimplementaciones en modo paralelo, se ha reducido mucho el tiempo necesario para implementar laaplicación.

Sin embargo, esto no refleja el caso de uso de Developer de tiempo de respuesta rápido para laimplementación de cambios pequeños. Durante la implementación de la aplicación, se tienen encuenta estos servidores:

• Repositorio: instala los artefactos de la aplicación en Content Server.• Servidor BAM: instala los artefactos de aplicación en el servidor BAM.• Servidor de búsqueda: instala los artefactos de la aplicación en el servidor de xPlore.• Aplicación: instala el archivo WAR de aplicación en el servidor host de aplicaciones.

Mejores prácticasPara implementaciones más rápidas, configure estos pasos:

• No active la opción Implementar el war en el servidor de aplicaciones en Configuración deejecución. Esto garantiza que se omita la implementación del archivo WAR de aplicación en elservidor de aplicaciones, pero se implementen los modelos en el repositorio.



• Según la aplicación que cree, puede configurar los componentes BAM y xPlore como componentesopcionales. Sin estos componentes, la implementación seguirá funcionando completamente. Paramejorar la productividad, puede deshabilitar componentes BAM y xPlore. Consulte la secciónConfiguración de servicios en la Guía de implementación de EMC Documentum xCeleratedComposition Platform para obtener más información sobre cómo deshabilitar los servicios.Note:Para los componentes BAM y xPlore, cuando los servicios de BAM y xPlore están deshabilitados,la implementación de la aplicación sigue funcionando. Sin embargo, los artefactos de estoscomponentes no rellenan los datos en tiempo de ejecución. Es necesario habilitar los servicios BAMy xPlore para reflejar los datos en tiempo de ejecución.

• Utilice el modo de vista previa para alojar la aplicación creada con xCP Designer. El modo de vistaprevia puede alojar la aplicación en el servidor Jetty interno o un servidor Tomcat externo. En el casodel servidor externo, la aplicación permanece disponible incluso después de cerrar xCP Designer.

Adopción de tipo

La función de adopción de tipos le permite adoptar tipos de datos del repositorio de Documentum parala aplicación xCP. Mediante la adopción de tipos, la aplicación xCP puede leer o escribir instanciasde datos creadas a través de clientes de Documentum, por ejemplo, versiones anteriores de xCP,Documentum Administrator, Webtop y TaskSpace, y adoptarlas en xCP Designer. Asimismo, losclientes de Documentum pueden leer o escribir nuevas instancias de los tipos adoptados creados enuna aplicación xCP. De este modo, la función de adopción de tipos proporciona interoperabilidad entrelos clientes de Documentum y las aplicaciones xCP que acceden a las instancias de datos.

En este tema, la aplicación xCP hace referencia a la aplicación creada con la versión actual de xCPDesigner.

Solo puede adoptar subtipos de los tipos de datos dm_sysobject, dm_document, dm_cabinet ydm_folder. Al adoptar un tipo de datos que se hereda de otro tipo de datos, también se adoptan todoslos supertipos. Por ejemplo, si el tipo premium_customer se hereda del tipo privileged_customer, elcual a su vez se hereda del tipo customer, cuando adopte el tipo premium_customer, también seadoptan sus supertipos de datos y los tipos privileged_customer y customer. Los tipos de datosadoptados aparecen en el navegador de modelos de objeto.

Si proporciona una etiqueta para un tipo de datos durante la creación del tipo mediante clientes deDocumentum, el sistema utiliza los valores de la etiqueta. Por ejemplo, suponga que se crea un tipo dedatos loan_customer con una etiqueta Préstamo cliente. Cuando adopte este tipo de datos en xCP, elmodelo de objetos aparecerá con Préstamo cliente como su etiqueta y loan_customer como el nombredel sistema. Sin embargo, si no se proporciona una etiqueta para un tipo de datos durante la creacióndel tipo, el sistema utiliza los valores de etiqueta predeterminados definidos por Content Server. Paralos subtipos de dm_sysobject, la etiqueta es SysObject. Para los subtipos de dm_content, la etiqueta esDocumento. Y para los subtipos de dm_folder, la etiqueta es Carpeta.

Cuando los tipos de datos se adoptan en una aplicación xCP, se comportan como cualquier otro tipo dedatos creado en xCP Designer. Puede modificar los atributos de los tipos de datos adoptados, agregarrelaciones con otros tipos o adjuntar fragmentos de tipo a estos tipos de datos.

Como práctica recomendada, utilice la directiva de datos MAINTAIN durante la implementación detipos de datos adoptados en el entorno de producción a fin de evitar pérdida de datos.



Lista de verificación de migración

Esta tabla muestra una visión general de los artefactos que indica qué ha cambiado en la versión actualrespecto de las versiones anteriores y enumera formas de resolución automáticas y manuales.

Tabla 389 Lista de verificación de migración

Artefacto Comportamiento de 2.x Comportamiento de la versiónactual

Menú contextual para losmodelos de objeto

El modelo principal que aparece en el editorde expresiones del menú contextual es unde solo valor.

Modelo de un solo valor: seleccione estaopción para configurar el atributo de modoque tenga un solo valor.

El modelo principal que apareceen el editor de expresiones delmenú contextual admite más deun valor.

Modelo de varios valores:seleccione esta opción paraconfigurar el atributo de modoque tenga más de un valor.

Acción Eliminar El modelo principal que aparece en el editorde expresiones para una acción Eliminar escompatible con un solo valor.

El modelo principal que apareceen el editor de expresiones para elflujo de acción Eliminar tambiénadmite más de un valor.

Flujo de acción deimportación personalizadade nueva versión

r_object_id y r_object_type como atributos • r_object_id, r_object_type yobject_name como atributos

• Tiene varios valores seincorpora en el flujo de acción.

Selector de archivos No aplicable • r_object_id, r_object_type yobject_name como atributos

• Tiene varios valores seincorpora en el flujo de acción.Nota: Durante la migración, elflujo de acción único funciona,pero los flujos de variasacciones no.

Conjunto de permisos Niveles de permisos al estilo de xCP, comoSin acceso, Búsqueda, Revisión, Edición,Administrar, Buscar y Eliminar.

Niveles de permisos al básicosy ampliados al estilo deDocumentum. Estos permisos sonde tipo público.

Soporte de Short-CutKeyEventManagerJS

Para admitir teclas de acceso directo, sedebe agregar la biblioteca JS personalizadaque registra el nombre del prefijode evento de IU para la aplicacióncon el método addUIEventPrefixxcp.event.ShortCutKeyEventManager..

Esto ha quedado obsoleto en estaversión. Utilice la nueva opciónTecla de acceso directo en elevento de IU durante la definiciónde un nuevo evento de IU.



Artefacto Comportamiento de 2.x Comportamiento de la versiónactual

Eventos deCancelar/Terminar flujo deacción

Estos eventos son compatibles con versionesanteriores.

Estos eventos están obsoletosen esta versión. Puede lograr lamisma funcionalidad mediantedesencadenadores de flujode acción correspondientes acancelar, éxito y error. Puedeconsultar los errores en la pestañaProblemas antes de migrar laaplicación. Estos errores se debencorregir manualmente.

Expresiones de eventos denegocio

Las expresiones en el árbol de contexto deeventos de negocio se refieren al nodo conesta notación (Por ejemplo, event.customer).

Esto no es compatible. En sulugar, se debe referir a ellos comoevent.customer.r_object_id. Estoes aplicable a los eventos denegocio de objeto de negocio,contenido, archivador y carpeta.Sin embargo, esta limitaciónno tiene ningún efecto en laevaluación de expresiones entiempo de ejecución.

Widgets personalizados Utiliza ExtJS 4.2.0 como marco de trabajode base.

Utiliza ExtJS 6.0.1 como marcode trabajo de base. Asegúrese deactualizar manualmente el códigode widget personalizado paracumplir con el mismo marco detrabajo.

Temas personalizados Utiliza ExtJS 4.2.0 como marco de trabajode base.

Utiliza ExtJS 6.0.1 como marcode trabajo de base. Consulteel tema Migrar una aplicacióndesde una versión anterior a laversión actual de xCP en la Guíade implementación de xCP paraobtener más información.

Navegador de migraciónEn la barra de herramientas, utilice Navegador de migración para migrar los procesos 1.x y otrosartefactos existentes. Los artefactos y sus componentes se pueden migrar tanto desde proyectosde Composer como del repositorio.

Esta tabla contiene una vista general de qué actividad admiten estos artefactos compatibles:

Artefactos compatibles Migrar desde proyectode Composer

Migrar desderepositorio

Adoptar desde elrepositorio

Conjuntos de alias Sí Sí No

Tipos de Composer Sí No No

Conjuntos de permisos Sí Sí No



Artefactos compatibles Migrar desde proyectode Composer

Migrar desderepositorio

Adoptar desde elrepositorio

Proceso Sí Sí No

Tipo de datosestructurados

Sí Sí No

Tipos No No Sí

Realice los pasos mencionados en estas secciones para ver cómo migrar o adoptar estos componentes.

Migración de procesosUtilice el navegador de migración para migrar los procesos de negocios heredados de 1.x desarrolladoscon Process Builder a los procesos de negocios actuales de xCP. El objetivo principal de la migraciónde procesos es migrar automáticamente las partes más importantes y complejas de diseño de procesos:expresiones, asignación de datos, rutas de transición, variables de proceso, paquetes, puntos definalización y ejecutantes. Toda la migración se produce de forma totalmente transparente, de modoque el flujo de proceso, las expresiones y las asignaciones de datos se mantienen intactos. Los procesosse pueden migrar desde proyectos de Composer y repositorio de Documentum.

Note: Solo los procesos creados con Documentum Process Builder 6.6 y versiones posteriores soncompatibles con los proyectos de repositorio y Composer.

La migración de procesos completa se produce en 4 fases:

1. Descubrimiento de procesos: según sus necesidades, usted confirma los procesos heredados de1.x que desea migrar. Verifique las dependencias involucradas, como los tipos que se usan en lospaquetes, el tipo de parámetros de proceso, los tipos de datos de estructura, los ejecutores, loscalendarios de negocio, las colas de trabajos, los módulos de Java, los puntos de finalización ylos subprocesos.

2. Pasos previos a la migración: el sistema comprueba los procesos e identifica todas lasdependencias. Siga los pasos indicados en la sección Requisitos previos.

3. Pasos de la migración: migrar el proceso con dependencias asociadas. Además, los componentesque no aparecen en los pasos previos a la migración se migran automáticamente.Note: La migración de procesos no migra completamente los procesos. Cualquier característica deun proceso 1.x que no sea compatible en 2.x se sustituye por una función equivalente en 2.x o porun valor predeterminado. Siga los pasos posteriores a la migración para llenar estos valores.

4. Pasos posteriores a la migración: algunos componentes de configuración no se pueden migrar porsí solos y es necesario hacerlo manualmente para completar el proceso de migración.

Requisitos previos (pasos previos a la migración)

• Modelos de objeto: adoptar los modelos de objetos para los paquetes mediante la función deadopción de tipos y migración de tipos.

• Parámetros de aplicación: crear parámetros de aplicación equivalentes para los parámetros deproceso, colas de trabajos, calendarios empresariales, ciclos de vida, usuarios y grupos.

• Puntos finales: terminal se refiere a un sistema externo como servicio web, HTTP, base de datos,JMS, correo electrónico, FTP, xPression y repositorio de Documentum. En 1.x, los terminales seguardan como parte de la definición de actividad. En 2.x, los terminales se conocen como artefactos



de terminal. Antes de la migración, cree estos terminales en xCP Designer y haga referencia a ellosen el paso previo a la migración de actividades.

• Conjunto de permisos: migrar o adoptar el conjunto de permisos de la actividad Crear ACL.

• Conjunto de alias: migrar o crear conjunto de alias para utilizarlo en la configuración del ejecutantede una actividad manual.

• Módulo de Java: crear módulo de Java para la plantilla de actividadMódulo BOF y la prioridadde tareas para la actividad Cola de trabajos.

• Proceso: todos los subprocesos que se utilizan en el proceso principal mediante la plantilla deactividad Invocar proceso o Invocar proceso de forma síncrona se deben migrar por separado, aligual que cualquier otro proceso y antes de migrar el proceso principal. Si va a migrar un procesosíncrono (llamado proceso sin estado en 2.x), el proceso migrado no está marcado como Sinestado de forma predeterminada. Se debe marcar como Sin estado después de la migración. Lasasignaciones de datos implicadas en la plantilla de actividad Invocar proceso o Invocar proceso deforma síncrona no se pueden tener en cuenta si el proceso secundario se regenera debido a SDT, aun nombre de variable no compatible o a un nombre de paquete incompatible.

Esta es una vista general rápida de los componentes compatibles como parte de la migración de proceso:

Tabla 391 Migración de propiedades de proceso

Pestañas Componente Migraciónautomática

Paso previo a lamigración

Paso posteriora la migración

Informaciónadicional

Nombre deplantilla

Sí (Opcional)Especifique unanueva etiqueta deproceso para laplantilla.

No aplicable No aplicable

Creador original No No aplicable No aplicable No se admiteesta función.

Estado actual No No aplicable No aplicable No se admiteesta función.

Etiqueta deversión

No No aplicable No aplicable No se admiteesta función.

Propietario deplantilla deproceso:


Descripción Sí

Conjuntode aliaspredeterminado


Instrucciones deflujo de trabajo

Sí No aplicable No aplicable No aplicable

Configuracióndel seguimientode auditoría


Almacenar elnombre decontenido en


General







el paqueteen tiempo deejecución

Seleccionarplantilla paranotificacionespor correoelectrónico

No No aplicable Definir unanueva plantillade correoelectrónico

No aplicable

Paquetes No • Utilice lafunción deadopción omigraciónde tipos paraobtener tiposheredados enxCP.

• Utilice lasextensiones denúcleo de xCPpara los tiposque no seancompatibles enxCP Designer.

Si el nombre delpaquete contienecaracteresespeciales ode más de unbyte que nose permiten enxCP, deberáasignarle unnombre nuevo.

No aplicable • No seadmite lamigraciónde xFormasociados.

• No seadmiteel campo"Estepaquetese puedeusar parael informegenerado".

Variables deproceso:Tipo de datossimples

Sí Si el nombre de lavariable contienecaracteresespeciales ode más de unbyte que nose permiten enxCP, deberáasignarle unnombre nuevo.

No aplicable Las variablesde procesose migranautomática-mente, perono se migransus ACL.

Variables deproceso:Tipo deestructura dedatos

No Consultela secciónMigración deSDT, página 517.


Datos







Parámetros deproceso

No • Debe crearun parámetrode aplicaciónequivalentedel mismotipo.

• Si se utilizanparámetros deconfiguraciónen elejecutante,por ejemplo,Ejecutanteen funciónde datos deproceso ySelección deejecutanteen funciónde datosde proceso,entoncesdeberá crearlos parámetrosde aplicaciónde usuario,grupo y tipode cola detrabajos.


ACL de variable No No aplicable Asignar unnuevo conjuntode permisos.

No aplicable

ACL deproceso.

No No aplicable Asignar unnuevo conjuntode permisos.

No aplicable

Calendario No Crear o asignarel parámetro deaplicación decalendario denegocio.


Formulario deparámetros deproceso


Formulario dealta fidelidad(formularioODT)


Opcionesavanzadas







Conjunto decorrelación

Sí No aplicable Si el proceso1.x tiene SDTasignados enel conjunto decorrelaciones,edite el conjuntode correlacionespara agregaratributos nuevosasignados atipos de variablesimples. Laasignaciónde datoscorrespondienteal conjunto decorrelacionesen la actividadPaso entrante(esperar) sedebe modificarpara reflejar losnuevos atributosañadidos alconjunto decorrelaciones.

Losatributos delconjunto decorrelacionesasignadosa tipos devariablesimplesmigranautomát-icamente.Los queinvolucranatributos deSDT se omitendurante lamigración.

Esta es una vista general rápida de los componentes compatibles como parte de la migración de lasactividades. Esto se aplica a las actividades manuales y automáticas.

Tabla 392 Migración de actividades

Componente Migraciónautomática


Paso posterior a lamigración


Propiedades No No aplicable No aplicable El sistema nopermite migrarla pestaña depropiedadesde actividadesautomáticas, ya queno son compatiblescon xCP. Solo laprioridad de latarea migra deforma automáticaen la pestaña deejecución de laactividad.







Ejecutante(Consulte lasección de lamigración de tiposde ejecutantes).

No No aplicable No aplicable No aplicable

Desencadenador Sí No aplicable No aplicable No aplicable

Transición Sí No aplicable Las expresionesque contenganatributos de Elflujo de trabajoen ejecución yÚltimo elementode trabajocompletado enla actividad no seadmiten en xCP.Deberá volver aescribir la expresiónde nuevo despuésde la actividad demigración.

No aplicable

Temporizadores Sí Cree un parámetrode calendarioempresarial yasígnelo en elpaso previo a lamigración, siempreque la configuracióndel temporizadorcontenga uncalendarioempresarial.

Cree un parámetrode aplicación deusuario y asígneloen el paso previoa la migración,si la acción deltemporizador esDelegar tarea a unusuario.

xCP no admitelas acciones detemporizadorNotificación yEjecutar métodoJava. Es posibleutilizar un procesosin estado o conestado con laactividad Ejecutarservicio de Javacon el fin de ejecutarmétodos de javapersonalizadoscomo parte de lasacciones de untemporizador.

xCP no admiteel campo Usarplantilla de correoelectrónico.







Notificación No No aplicable Las plantillas decorreo electrónicoutilizadas paranotificacionesno migranautomáticamente.Es necesario crearuna plantilla decorreo electrónicodespués de laactividad demigración.

No aplicable

Datos Sí No aplicable No aplicable • No se admitela migraciónde xFormasociados.

• No se admiteel campo Estepaquete puedeutilizarsepara generarinformes.

Visualización Sí No aplicable Las imágenespersonalizadasno migranautomáticamente.Las imágenespersonalizadasde deben volvera asignar despuésde la actividad demigración.

No aplicable

Notas genéricas:

• Actividad de inicio predeterminada: la actividad no migra automáticamente. Para un proceso queno esté vinculado desde una actividad de inicio predeterminada, el paso después de la migración esagregar un enlace a la primera actividad y configurar la condición de desencadenamiento.

• Actividad entrante en servicio web: la actividad no migra automáticamente. La actividad entranteen servicio web configurada con WSDL desde el sistema de archivos local migra con una URL deWSDL en blanco. Es necesario configurar la dirección URL de WSDL.

• Punto final: la plantilla de correo electrónico configurada en la plantilla de actividad SMTP migraautomáticamente. Todas las asignaciones de mensajes de entrada y salida migran automáticamente.

• Esquema XML asociado con el contenido de la actividad: puede haber esquemas XML concontenido de paquetes adjunto, o con el contenido recibido desde orígenes externos (como serviciosHTTP o JMS) y utilizar el asignador para asignar los elementos del esquema. Los esquemas migranautomáticamente y se agregan como recursos de la aplicación xCP durante la migración. Lasasignaciones de datos hacia y desde los elementos de esquema se conservan.



• Condición de transición basada en XML: si la condición de transición se basa en un paquete quetiene un documento XML, las expresiones se migran correctamente mediante funciones XML.

• El vínculo JumpToArtifact no funciona para Proceso—>Tipo de paquete. Es necesario recurrir alnavegador para editar y visualizar artefactos.

Estas actividades automáticas de 1.x no son compatibles con xCP. Por lo tanto, cuando un proceso 1.xcontiene cualquiera de estas actividades, estas se reemplazan con la actividad Ejecutar servicio deJava como marcador de posición o una plantilla de actividad automática 2.x equivalente. Para cadamarcador de posición de actividad Ejecutar servicio de Java, el usuario debe crear un módulo de Javaseparado mediante la función del módulo de Java y asociarlo a la migración del proceso después dela migración. La actividad de marcador de posición no tiene en cuenta ninguna configuración niasignación de datos heredada de la actividad 1.x.

Tabla 393 Actividades automáticas compatibles y no compatibles

Plantilla de actividad automática 1.x Plantilla de actividad automática actual

Búsqueda de FS2 Ejecutar servicio de Java (como actividad de marcadorde posición)

Crear evento de iCalendar Ejecutar servicio de Java (como actividad de marcadorde posición)

Transformación XSL Ejecutar servicio de Java (como actividad de marcadorde posición)

Fax saliente Ejecutar servicio de Java (como actividad de marcadorde posición)

Decisión de repasar tarea de cola Ejecutar servicio de Java (como actividad de marcadorde posición)

Establecer la habilidad de la tarea de cola Ejecutar servicio de Java (como actividad de marcadorde posición)

Vincular a carpeta Mover (como actividad de marcador de posición)

Crear ACL Crear o aplicar ACL

Caso nuevo a partir de plantilla Crear (como actividad de marcador de posición)

Módulo BOF Ejecutar servicio de Java

Invocar proceso Llamar proceso

Invocar proceso de forma síncrona Llamar a un proceso sin estado

Crear carpeta Crear (como actividad de marcador de posición)

Publicar evento en el proceso principal Señalizar proceso principal (como actividad demarcador de posición)

dm_noop_auto_method/

dm_bpm_noop_method/

dm_noop_auto_method_java

Unir

Métodos personalizados que se pueden seleccionar enla ficha de configuración del ejecutante

Ejecutar servicio de Java (como actividad de marcadorde posición)

Delegación de temporizador a grupo Ejecutar servicio de Java (como actividad de marcadorde posición)



Esta es una vista general rápida de los componentes compatibles como parte de la migración deltipo de ejecutante:

Tabla 394 Migración del tipo de ejecutante

Tipo de ejecutante Migraciónautomática




Supervisor del flujode trabajo


Propietario delrepositorio


Ejecutante de laactividad anterior


• Usuarioespecífico

• Todos losusuarios de ungrupo

• Un solo usuariode un grupo

• Varios usuariosde un grupo

• Variosejecutantessecuenciales

No Crear un parámetrode usuario ogrupo adecuadoo conjunto dealias manualmentey asignarlo enel paso previoa la migraciónpara estasconfiguraciones:

1. Asignarejecutante

2. Definir un aliasde ejecutante

3. Seleccionarejecutante segúncondiciones

En el paso previoa la migración sedebe seleccionar elmismo número deejecutantes que enproceso 1.x.

La configuración deejecutante siguienteno es compatible ymigra al tipo de eje-cutanteSupervisorde flujo de trabajo:

• Hacer que elejecutante dela actividad<nombre_de_actividad>determine elejecutante de laactividad.

• Seleccionarejecutante segúncondiciones:escribir unaconsulta DQL.

Los alias deejecutante distintosde Conjunto dealias específicose migran al tipode ejecutanteSupervisor del flujode trabajo.

Las configuracionesde ejecutantesiguientes se migranautomáticamente:

• Seleccionarejecutante segúndatos de proceso.

• Seleccionarel ejecutanteen función decondición conla selecciónde usuario enfunción de losdatos del proceso.

En 2.x, la prioridadde tarea de cola detrabajo puede serdinámica solo siestá configurado elmódulo de prioridadde tarea. Durantela migración, sedebe establecer laprioridad comomedia (nivelde prioridadpredeterminado)para la tarea de colade trabajo si no hayningún módulo deprioridad de tareaconfigurado en elproceso de 1.x.



Tipo de ejecutante Migraciónautomática




Cola de trabajos No Cree un parámetrode cola de trabajosy asígnelo duranteel paso previo a lamigración.


Seleccionarejecutante segúndatos de proceso


Biblioteca de extensión del núcleo

La biblioteca contiene los tipos de sistema preadoptados. Ayuda a los usuarios finales a utilizar los tiposde sistema en la aplicación xCP para la migración de procesos. Por ejemplo, consideremos la migraciónde un proceso 1.x en xCP y que uno de los tipos de paquete es una instancia XML, dm_xfm_instance.Para migrar el proceso con el tipo de instancia XML, es necesario importar la biblioteca que, a suvez, muestra el tipo de instancia XML en la aplicación xCP y lo utiliza en el proceso de migración.Note: Solo dm_xfm_instance se admite en la biblioteca de extensión del núcleo en esta versión.

A continuación se muestran las limitaciones de la instancia XML dm_xfm_instance cuando se utilizaen la aplicación xCP:

• La instancia XML no adoptar su formularios electrónicos asociados.

• No se respetan las asignaciones de almacenamiento para instancias XML nuevas o existentes cuandose actualizan desde la aplicación xCP.

• La nueva instancia XML creada desde la aplicación xCP no es interoperativa con clientes 1.x,como Webtop, Taskspace.

• Al utilizar una instancia XML en la migración de procesos, el esquema asociado no migraautomáticamente y se pierden las reglas de asignación de datos de proceso con los atributos deesquema.Nota: Una vez finalizada la migración, puede recuperar el esquema del repositorio,agregarlo a la aplicación como un recurso y usarlo en proceso, como cualquier otro esquema, paravolver a definir las reglas para todas las actividades necesarias.

Migración de tipos de datos estructurados

Las variables de proceso de tipos de datos estructurados (SDT) no son compatibles con xCP Designer.En su lugar, utilice objetos de negocio (BO) para admitir la funcionalidad de SDT. Los SDT se debenconvertir manualmente en objetos de negocio en la etapa previa a la migración. Para convertir SDT enBO, es necesario asignar los atributos de SDT con atributos de objetos de negocio utilizando el pasoprevio a la migración del proceso de migración. La asignación se utiliza para migrar atributos de SDTa atributos de BO en el asignador de datos o en una expresión que se utiliza en las condiciones detransición y la configuración condicional del ejecutante. La agrupación lógica de datos en SDT sepuede asignar a un único BO o se puede convertir en más de un BO vinculados entre sí mediante lafunción Relaciones.



Note: Como práctica recomendada, se recomienda reducir la normalización o acoplar el SDT al BOcon un máximo de tres tipos a fin de evitar problemas de rendimiento.

Las variables de proceso de tipo SDT se agregan como paquete al proceso durante la migración. Esnecesario proporcionar un nombre para el paquete agregado al proceso en la fase previa a la migración.Como parte de la migración de SDT, todos los paquetes agregados a un proceso se marcan comoobligatorios de forma predeterminada.

Por ejemplo, el SDT Empleado tiene departamento y dirección como grupos y sucursal como subgrupode departamento. Puede elegir entre un BO (empleados) o dos BO (empleado y departamento) parareducir la normalización del SDT.

Tipos de datos estructurados Objeto de negocio

- employee_name(attribute)- employee_age (attribute)1 group-department

- department_name (attribute)1.1group- branch

- branch_name (attribute)2 group-address

- address (attribute)

- employee_name(attribute)- employee_age (attribute)- department_name (attribute)- branch_name (attribute)- address (attribute)

O,

BO-employee- employee_name(attribute)- employee_age (attribute)- address (attribute)BO-department- department_name (attribute)- branch_name (attribute)


Capítulo 14

Administrar una aplicación



Tareas

Añadir miembros a un rol1. Desplácese hasta la página Roles de aplicación.2. Seleccione el rol al que va a agregar un miembro o miembros.3. Haga clic enManage Members (Administrar miembros).4. En la página Administrar miembros de rol, haga clic en Agregar.5. En el cuadro de diálogo Agregar miembros a <nombre de rol de aplicación>, seleccione el

miembro o los miembros que se van a agregar al rol.6. Haga clic en los iconos de flecha para mover el miembro o los miembros seleccionados a o desde el

campo Agregar a rol.7. Haga clic en Agregar.

Eliminar miembros de un rol1. Desplácese hasta la página Roles de aplicación.2. Haga clic en el rol del que va a quitar uno o más miembros.3. En la página Administrar miembros de rol, seleccione el miembro o los miembros que desea

eliminar.4. Haga clic en Quitar.

Cambiar el nombre de un artefacto1. Seleccione un artefacto en el navegador.2. Haga clic con el botón secundario en el artefacto y haga clic en Cambiar nombre.3. En el cuadro de diálogo Cambiar nombre, especifique los detalles de la manera siguiente:



Campo Descripción

Etiqueta De forma predeterminada, la etiqueta existente se rellena en el cuadro detexto. Cambie el nombre de la etiqueta, si es necesario.

Nombre del sistema El sistema asigna un nombre del sistema para identificar el artefacto (parauso interno). Si cambia la etiqueta, el sistema genera un nuevo nombredel sistema.

Ubicación de archivo Identifica la ruta de acceso al artefacto en el sistema de archivos.

Referencias Seleccione la casilla de verificación para actualizar las referencias asociadascon el artefacto.

4. (Opcional) Haga clic en Siguiente.

Revise los cambios. No seleccione la casilla de verificación de los cambios que no desee realizar.5. Seleccione la casilla de verificación correspondiente a los cambios que desee realizar y haga

clic en Finalizar.

Mover un artefacto1. Seleccione un artefacto en el navegador.2. Haga clic con el botón secundario en él, haga clic enMover a y seleccione un proyecto diferente.3. En el cuadro de diálogoMover, especifique los detalles de la manera siguiente:

Campo Descripción

Mover a Mueve un artefacto desde un proyecto existente hasta un proyecto diferente.

Etiqueta Cambie el nombre de la etiqueta, si es necesario. Si cambia esta etiqueta,el sistema genera un nuevo nombre del sistema.

Nombre del sistema El sistema asigna un nombre del sistema para identificar el artefacto (parauso interno). Si cambia la etiqueta, el sistema genera un nuevo nombredel sistema.

Ubicación de archivo Identifica la ruta de acceso al artefacto en el sistema de archivos.

Referencias Seleccione la casilla de verificación para actualizar las referencias asociadascon el artefacto.

4. (Opcional) Haga clic en Siguiente.

Revise los cambios. No seleccione la casilla de verificación de los cambios que no desee realizar.5. Seleccione la casilla de verificación correspondiente a los cambios que desee realizar y haga

clic en Finalizar.

Conceptos

Cambiar el nombre de un artefacto o moverloxCP Designer le permite cambiar el nombre de un artefacto o moverlo sin problemas. Cuandocambia el nombre de un artefacto o lo mueve, el sistema actualiza automáticamente la mayoría de lasreferencias asociadas con el artefacto.



Como práctica recomendada, si utiliza un control de origen, consulte todos sus archivos con referenciaantes de realizar cualquiera de estas operaciones.

Cambiar el nombre de un artefacto o moverlo presenta estas limitaciones:

• Si se hace referencia a un artefacto en una expresión, el nombre del artefacto en la expresión no seactualiza cuando cambia de nombre el artefacto o lo mueve. En este caso, la expresión se vuelveno válida y el error relacionado se muestra en la pestaña Problemas. Deberá editar la expresión yactualizar el nombre del artefacto manualmente.

• Si se hace referencia a un artefacto en un elemento de menú, el nombre del artefacto no se actualizaautomáticamente cuando cambia el nombre del artefacto o mueve este. En este caso, el enlace deelemento de menú se vuelve no válido y el error relacionado se muestra en la pestaña Problemas.Deberá abrir la página, seleccionar el elemento de menú y guardarla para que se refleje el cambio denombre del artefacto.

• Si se hace referencia a un artefacto en una interacción, el nombre del artefacto en la interacciónno se actualiza cuando cambia de nombre el artefacto o lo mueve. En este caso, la interacciónse vuelve no válida y el error relacionado se muestra en la pestaña Problemas. Deberá eliminarmanualmente la interacción existente y, a continuación, agregar una nueva asociada con el artefactocuyo nombre se ha cambiado.

• Se hace referencia a un artefacto en un proceso versionado, el nombre del artefacto y todas lasversiones del proceso se actualizan al cambiar el nombre del artefacto o moverlo. De formapredeterminada, la casilla de verificación Actualizar referencias está deshabilitada, así que nointente corregir algunas referencias y dejar otras sin cambiar. Si una actividad de un proceso tieneuna lógica de transición basada en el artefacto cuyo nombre ha cambiado o en reglas de asignaciónrelacionadas con dicho artefacto, el proceso se vuelve no válido y el error relacionado se muestra enla pestaña Problemas.

• Si se hace referencia a un artefacto en un informe de Crystal Reports y se cambia su nombre, elarchivo rpt correspondiente no se actualiza con un nuevo nombre de tabla y el error relacionado semuestra en la pestaña Problemas. Deberá abrir el archivo rpt y definir manualmente la ubicación deorigen de datos en los nuevos archivos xml y xsd.


Capítulo 15Solución de problemas de imple-mentación de aplicaciones


• Los metadatos descubiertos no están disponibles• Una consulta de texto completo no devuelve resultados• Las facetas están vacías• Error en las actividades salientes al configurarlas para crear conexiones seguras

para la distribución de mensajes• Se ha reducido el rendimiento del sistema• SSO falla cuando hay más de una aplicación implementada en el mismo servidor

de aplicaciones• Bloqueo en la actividad de correo electrónico entrante• Borrar los archivos temporales del directorio Temp

Los metadatos descubiertos no estándisponiblesSe ha implementado la aplicación con modelos de contenido que incluyen metadatos descubiertos,pero los metadatos descubiertos no están disponibles para los objetos de contenido en el repositorio.

Problema

El primer síntoma es que los metadatos descubiertos no están disponibles en la aplicación.

El segundo síntoma es que, al buscar en el conjunto de documentos en Documentum Administrator, elestado del conjunto de documentos es scheduled en lugar de completed.

Causa

Content Intelligence Services (CIS) no ha procesado el conjunto de documentos porque el conjunto dedocumentos no se ha sincronizado.

La sincronización ha fallado porque la comunicación se ha interrumpido entre xCP Designer yel servidor CIS.


Solución de problemas de implementación de aplicaciones

ResoluciónVaya al archivo xCPDesigner.log y busque un error CIException como Connection refused,Network unreachable, etc.

En el ejemplo siguiente se muestra un mensaje de error de sincronización debido a un error deconexión rechazada:2012-03-29T09:48:46.077 ERROR [Tpool-2-thread-1] [com.emc.xcp.artifact.contentanalytics.installer.DocsetSynchronizationTransactionObserver:68] Docset named: cus_my_doc was not synchronized withCIS server. CIS server will need to be (re)startedCiException:: THREAD: pool-2-thread-1; MSG: Connection refused:connect; ERRORCODE: 2713; NEXT: null

Se puede producir un problema de conexión en los siguientes casos:

• El servidor CIS está inactivo.• La configuración de CIS para el repositorio es incorrecto.• La red entre el host de xCP Designer y el host del servidor CIS no permite la conexión. Por ejemplo,puede ser un problema de DNS. CIS se configura utilizando el nombre de host pero no puedeverificar la conexión del host de CIS desde el host de xCP Designer utilizando el nombre de host.

Según el error del registro y la lista de posibles problemas de conexión, compruebe los puntossiguientes:

• El servidor CIS está activo y funcionando correctamente.• La configuración de CIS para el repositorio es correcta.• Puede verificar la conexión del host del servidor CIS desde el host de xCP Designer.La EMC Documentum Content Intelligence Services Administration guide (Guía de administración deEMC Documentum Content Intelligence Services) proporciona más detalles sobre la configuración deCIS en el repositorio y la supervisión de estado.

Una consulta de texto completo no devuelveresultados

ProblemaIncluso aunque ha creado instancias de objetos, la consulta de texto completo no devuelve resultados.

CausaUna consulta puede provocar un error si:

• La página no está correctamente configurada.• La consulta contiene errores. Hay dos tipos de errores:

– Errores de consulta: Se ha producido un error durante la ejecución dela consulta. Póngase en contacto con el administrador. Códigode error: E_FULL_TEXT.



– Errores de sintaxis: La sintaxis de la consulta no es válida. Código deerror: E_FULLTEXT_SYNTAX.

• Circunstancia externa a la consulta, como un error de memoria.• Los datos no están indexados.

ResoluciónLleve a cabo las siguientes acciones:

• Compruebe la sintaxis de consulta admitida, Se describe en Sintaxis de consulta compatible para labúsqueda de texto completo, página 263.

• Compruebe que la instancia de servicio de datos para el modelo de consulta está vinculado a lalista de resultados en la página de búsqueda.

• Utilice una herramienta de depuración web que rastrea comunicación de red para comprobar lasllamadas del servicio. Vuelva a ejecutar la consulta agregando el parámetro &debug a la URL de laconsulta para obtener la información de depuración.

• Compruebe los registros del servidor de aplicaciones para ver los seguimientos relacionados con laconsulta. Es más fácil de hacer si inicia el servidor TC en el modo de consola.

Si las acciones no solucionan el problema, compruebe que los objetos se han indexado correctamente.

En el host de xPlore, realice las acciones siguientes:

• Compruebe que los servicios de xPlore, Documentum xPlore PrimaryDSearch y DocumentumIndexagent se han iniciado.

• Compruebe que el agente de índice se ha iniciado. Si no:

1. En la interfaz de usuario del agente de indexación, inicie el agente de indexación en el modonormal.

2. Haga clic en Detalles para comprobar la indexación de la cola actual.3. Para volver a indexar las instancias de un modelo de objeto específico de forma inmediata,

seleccione DQL y el modelo de objeto en la lista De y, a continuación, haga clic en Submit(Enviar).

• Compruebe que los objetos se han indexado.

1. Obtenga el ID de objeto de los objetos.2. En el administrador de xPlore, vaya a Data Management (Administración de

datos)→your_repository→predeterminado3. Busque los ID de objetos. Si hay un ID de objeto, los datos indexados para este objeto se

muestran. Si no hay ID de objeto, marque la casilla de verificación de indexación de errores.• Compruebe los errores de indexación. En la interfaz de usuario del agente de indexación, haga clicen Detalles. Si el recuento de errores es mayor que 0, marque la casilla de verificación si los erroresestán relacionados con los objetos.

1. Obtenga el ID de objeto de los objetos.2. Busque los ID de objetos en los registros del agente de índice. Los registros están en

dsearch_home\server\DctmServer_Indexagent\logs\, donde dsearch_home es el directorio deinstalación de xPlore.

La EMC Documentum xPlore Administration and Development guide (Guía de implementacióny administración de EMC Documentum xPlore) proporciona más información acerca de la interfaz



de usuario del agente de índice de xPlore, el administrador de xPlore el estado de indexación y laconfiguración de indexación.

Las facetas están vacías

Problema

La consulta de texto completo devuelve resultados, pero las facetas no tienen valores.

Si las facetas están vacías y no hay ningún resultado, solucione primero el problema en relación con losresultados, como se describe en Una consulta de texto completo no devuelve resultados, página 524.

Causa

Las facetas pueden estar vacías si la configuración de faceta:

• La actualización no se ha realizado correctamente durante la implementación de la aplicación.

• No es correcta.

Resolución

Lleve a cabo las siguientes acciones:

• Compruebe el registro de implementación de aplicaciones para ver si se ha actualizado laconfiguración de la faceta. La línea siguiente indica que la actualización de xPlore se ha realizadocorrectamente:

[INFO] Updating xPlore indexes

• Compruebe la configuración de facetas en el archivo de configuración de xPlore dsearch_home\config\indexserverconfig.xml, donde dsearch_home es el directorio de instalación de xPlore.

Para obtener una faceta en un atributo con el nombre Cantidad, verá un elemento de sub-ruta comoel siguiente:

<sub-path description="Used by facet Amount in search model ft"returning-contents="true" type="double" path="dmftmetadata//amount"/>

• Vuelva a crear el índice.

La EMC Documentum xPlore Administration and Development guide (Guía de implementación yadministración de EMC Documentum xPlore) proporciona más información sobre la configuración delíndice y cómo volver a crear el índice.



Error en las actividades salientes alconfigurarlas para crear conexiones seguraspara la distribución de mensajes

ProblemaSi una actividad saliente (correo electrónico, JMS, HTTP, FTP o servicio web) se ha configurado paraque cree conexiones seguras (SSL o TLS) para la distribución de mensajes, se producirá un error conla excepción siguiente en tiempo de ejecución al establecer una conexión con el servidor:

java.security.InvalidKeyException: Illegal key size

CausaJava Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files son necesariospara las conexiones seguras.

ResoluciónSi las actividades salientes (correo electrónico, FTP, JMS, HTTP y servicio web) se configuran paraproporcionar mensajes a través de conexiones seguras (SSL o TLS), aplique los archivos UnlimitedStrength Jurisdiction Policy Files de JCE si el servidor utiliza los siguientes algoritmos criptográficospara el cifrado con los siguientes tamaños:

• DES, más de 64 bits• DESede, todos los tamaños• RC2, más de 128 bits• RC4, más de 128 bits• RC5, más de 128 bits• RSA, todos los tamaños• Todos los demás algoritmos, más de 128 bits

Para aplicar los archivos Unlimited Strength Jurisdiction Policy Files de JCE:

1. Descargue los Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Filesdesde:http://www.oracle.com/technetwork/java/javase/downloads/jce-6-download-429243.html

2. Localice la instancia de JAVA utilizada por JBoss Method Server. Puede encontrarla comoINSTANCE_JAVA_HOME en startMethodServer.cmd en <Documentum>\jboss7.1.1\server.

3. Haga copias de seguridad de local_policy.jar y US_export_policy.jar desdeINSTANCE_JAVA_HOME/jre/lib/security.

4. Detenga todos los procesos de Java que utilicen INSTANCE_JAVA_HOME (normalmente losprocesos de Java de pila de Documentum).

5. Copie los archivos de políticas descargados en INSTANCE_JAVA_HOME/jre/lib/security.6. Inicie los procesos de Java cerrados en el paso 4.


http://www.oracle.com/technetwork/java/javase/downloads/jce-6-download-429243.html


Se ha reducido el rendimiento del sistema

ProblemaEl sistema presenta un rendimiento muy lento.

CausaCada instancia de una pestaña del editor de página incluye una instancia de xulrunner que consumememoria. Si se están ejecutando muchas de estas instancias de forma sincrónica, el consumo dememoria acumulado puede reducir el rendimiento del sistema.

ResoluciónNo abra muchos editores de página al mismo tiempo o cierre aquellos que sean innecesarios.

SSO falla cuando hay más de una aplicaciónimplementada en el mismo servidor deaplicaciones

ProblemaSi hay más de una aplicación de xCP que utilicen SSO implementadas en el mismo servidor deaplicaciones, se genera un error de SSO.

Resolución1. Detenga el servidor de aplicaciones.2. Mueva los archivos vsj-license.jar y vsj-standard-3.3.jar de <webapps_home>/xcpapp/WEB-INF/lib

(de todas las aplicaciones de xCP implementadas en el servidor de aplicaciones ) a la carpeta<app_server>/lib.

3. Reinicie el servidor de aplicaciones.

Bloqueo en la actividad de correo electrónicoentrante

ProblemaNo se procesan los correos electrónicos mediante la actividad de entrada de correo electrónico y labase de datos advierte de una situación de bloqueo.



Resolución

Lleve a cabo las siguientes acciones:

1. Habilitar <Snapshot Isolation> y configurar READ_COMMITTED_SNAPSHOT con ON en elnivel de base de datos.

2. Habilitar <Snapshot Isolation> y configurar READ_COMMITTED_SNAPSHOT con ON en elcódigo. Esto significa que el código debe habilitar el aislamiento de snapshot antes de llamara cualquier consulta SQL.

Borrar los archivos temporales del directorioTemp

Problema

En ocasiones excepcionales, se crean archivos temporales en el equipo hasta llenar el disco duro ycolapsar las actividades relacionadas con la aplicación. Por ejemplo, los escenarios posibles:

• Cuando se ejecutan varias instancias de servidor de aplicaciones y todas apuntan hacia la carpetatemporal predeterminada del sistema

• Cuando se reimplementan varias aplicaciones continuamente, los archivos temporales se acumulan

Causa

La aplicación xCP crea un conjunto de archivos temporales (con el prefijo xcpdar) durante suejecución. Estos archivos DAR contienen artefactos, metadatos y recursos.

Resolución

Por lo general, se generan archivos temporales en estos casos:

• xDA: en el momento implementar la aplicación xCP.

• Servidor de aplicaciones que aloja la aplicación xCP

• Content Server: servidor de métodos Java funcionando en JBoss

• Scripts de DFC: al ejecutar scripts DFC, lo cual, además, modifica un artefacto de xCP

Cree una carpeta temporal independiente utilizando la variable de la JVM –Djava.IO.tmpdir y, acontinuación, borre los archivos temporales de las aplicaciones Content Server y DFC. Incluso losarchivos temporales se eliminan al apagar correctamente el servidor de aplicaciones.


Appendix A

Usar el Visor de contenido de xCP

En este apéndice se incluye lo siguiente:

∙∙∙ Tareas∙∙∙ Adición de un comentario∙∙∙ Responder a un comentario∙∙∙ Editar un comentario∙∙∙ Eliminar un comentario∙∙∙ Mover una página∙∙∙ Extraer una página∙∙∙ Insertar una página∙∙∙ Quitar una página

En este apéndice se ofrecen instrucciones sobre el uso del Visor de contenido de xCP. Proporcione estainformación a los usuarios finales. Si se utiliza otro visor, consulte la documentación del productocorrespondiente para obtener instrucciones.

Tareas

Adición de un comentario1. Haga clic en Agregar.2. Coloque el cursor con forma de cruz en la ubicación del comentario y haga clic una vez.3. En el cuadro de diálogo Agregar marcador de comentario, escriba el comentario.4. Haga clic en Aceptar para guardar el comentario en la página.

Los comentarios aparecen en el widget Comentarios con un marcador que indica que el comentariose un comentario de anotación. Un número que se utiliza para la indexación aparece en cadacomentario. El sistema no actualiza el número cuando el usuario final elimina un comentario.

Responder a un comentario1. Haga clic en el marcador de comentario para abrirlo.


Editar un comentario

2. Haga clic en Responder.3. Escriba un comentario y haga clic en Enviar para guardar la respuesta.4. Haga clic en Cerrar.

Cuando se responde a un comentario en el widget de comentarios, la respuesta aparece en el widgetde visor. Cuando se responde a un comentario en el widget de visor, la respuesta aparece enel widget de comentarios.

El sistema muestra el número de respuestas con el formato siguiente:

<Número de respuestas> (<Número de respuestas sin leer>) respuestas

Editar un comentario1. Haga clic en el marcador de comentario para abrirlo.2. En el cuadro de diálogo Comentario, actualice el comentario.3. Haga clic en Enviar para guardar los cambios.4. Haga clic en Cerrar.

Al editar un comentario en el widget Comentarios, el comentario modificado aparece en el widgetVisor. Al editar un comentario en el widget Visor, el comentario modificado aparece en el widgetComentarios.

Eliminar un comentario1. Haga clic en el marcador de comentario para abrir el comentario.2. Haga clic en Eliminar.3. En el cuadro de diálogo Eliminar comentario, haga clic en Sí.

Al eliminar un comentario en el widget Comentarios, el sistema suprime el comentario del widgetVisor. Al eliminar un comentario en el widget de visor, el sistema elimina el comentario delwidget de comentarios.

Mover una página1. Seleccione la miniatura de la página que desee mover.2. Haga clic con el botón secundario en la página y seleccioneMover páginas.3. En el navegador en miniatura, desplácese a una nueva ubicación, haga clic con el botón secundario

y seleccioneMover antes oMover después.4. Haga clic en Aplicar.5. En el cuadro de diálogo Reordenar páginas, seleccione una versión y escriba una descripción.6. Haga clic en Aceptar.

Extraer una página1. Seleccione las imágenes en miniatura de las páginas que desea extraer.


Usar el Visor de contenido de xCP

2. Haga clic en Extraer páginas.

3. Para quitar las páginas extraídas del documento de origen:

a. Seleccione Eliminar las páginas extraídas del documento actual.

b. Seleccione un número de versión e introduzca una descripción.


5. Realice alguno de los procedimientos siguientes:

• Si el tipo de documento está predefinido y la directiva de contenido no requiere la introducciónde propiedades, introduzca un nombre para el documento y haga clic en Finalizar.

• Si el tipo de documento está predefinido y la directiva de contenido requiere la introducción depropiedades, introduzca los metadatos del documento y haga clic en Finalizar.

• Si el tipo de documento no está predefinido y la directiva de contenido requiere la introducciónde propiedades, seleccione un Tipo de documento, introduzca los metadatos del documentoy haga clic en Finalizar.

El sistema guarda el documento en la misma ubicación que el documento original.

Insertar una página1. Haga clic en Insertar páginas.

2. En el cuadro de diálogo Insertar páginas, haga clic en Agregar.

3. En el cuadro de diálogo, seleccione el archivo y haga clic en Agregar.

El documento debe guardarse en el repositorio y debe tener el mismo formato que el documentoactual.

4. En el cuadro de diálogo Insertar páginas, seleccione una ubicación en el documento actual parainsertar las páginas.

5. Seleccione un número de versión, introduzca una descripción y haga clic en Aceptar.

Quitar una página1. Seleccione la miniatura de la página que desee quitar.

2. Haga clic en Quitar páginas.

3. Confirme o modifique las páginas que desee quitar.

Escriba una coma entre páginas no secuenciales. Escriba un guión entre páginas secuenciales.

Escriba un guión antes de un número de página para eliminar todas las páginas hasta ese número depágina, incluido este. Por ejemplo, si escribe -10, el sistema elimina todas las páginas desde elprincipio del documento hasta la página 10, incluida esta.

Escriba un guión después de un número de página para eliminar todas las páginas posteriores a esenúmero de página, incluido este. Por ejemplo, si escribe 10-, el sistema elimina todas las páginas apartir de la 10 hasta el final del documento.

4. Seleccione una versión, introduzca una descripción y haga clic en Aceptar.


emcayudadedocumentum xceleratedcomposition … · emcayudadedocumentum xceleratedcomposition...

Documents