Guía del diseñador de contenido de CA Process

CA Process Automation
Guía del diseñador de contenido
Versión 04.2.00
Esta documentación, que incluye sistemas incrustados de ayuda y materiales distribuidos por medios electrónicos (en adelante,
referidos como la "Documentación") se proporciona con el único propósito de informar al usuario final, pudiendo CA proceder
a su modificación o retirada en cualquier momento. Esta documentación es propiedad de CA. Queda prohibida la copia,
transferencia, reproducción, divulgación, modificación o duplicación de la totalidad o parte de esta Documentación sin el
consentimiento previo y por escrito de CA.
No obstante lo anterior, si dispone de licencias de los productos informáticos a los que se hace referencia en la Documentación,
Vd. puede imprimir, o procurar de alguna otra forma, un número razonable de copias de la Documentación, que serán
exclusivamente para uso interno de Vd. y de sus empleados, y cuyo uso deberá guardar relación con dichos productos. En
cualquier caso, en dichas copias deberán figurar los avisos e inscripciones relativas a los derechos de autor de CA.
Este derecho a realizar copias de la Documentación sólo tendrá validez durante el período en que la licencia aplicable para el
software en cuestión esté en vigor. En caso de terminarse la licencia por cualquier razón, Vd. es el responsable de certificar por
escrito a CA que todas las copias, totales o parciales, de la Documentación, han sido devueltas a CA o, en su caso, destruidas.
EN LA MEDIDA EN QUE LA LEY APLICABLE LO PERMITA, CA PROPORCIONA ESTA DOCUMENTACIÓN "TAL CUAL" SIN GARANTÍA
DE NINGÚN TIPO INCLUIDAS, ENTRE OTRAS PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS IMPLÍCITAS DE COMERCIALIZACIÓN,
ADECUACIÓN A UN FIN CONCRETO Y NO INCUMPLIMIENTO. CA NO RESPONDERÁ EN NINGÚN CASO, ANTE VD. NI ANTE
TERCEROS, EN LOS SUPUESTOS DE DEMANDAS POR PÉRDIDAS O DAÑOS, DIRECTOS O INDIRECTOS, QUE SE DERIVEN DEL USO
DE ESTA DOCUMENTACIÓN INCLUYENDO A TÍTULO ENUNCIATIVO PERO SIN LIMITARSE A ELLO, LA PÉRDIDA DE BENEFICIOS Y
DE INVERSIONES, LA INTERRUPCIÓN DE LA ACTIVIDAD EMPRESARIAL, LA PÉRDIDA DEL FONDO DE COMERCIO O LA PÉRDIDA DE
DATOS, INCLUSO CUANDO CA HUBIERA PODIDO SER ADVERTIDA CON ANTELACIÓN Y EXPRESAMENTE DE LA POSIBILIDAD DE
DICHAS PÉRDIDAS O DAÑOS.
El uso de cualquier producto informático al que se haga referencia en la Documentación se regirá por el acuerdo de licencia
aplicable. Los términos de este aviso no modifican, en modo alguno, dicho acuerdo de licencia.
CA es el fabricante de esta Documentación.
Esta Documentación presenta "Derechos Restringidos". El uso, la duplicación o la divulgación por parte del gobierno de los
Estados Unidos está sujeta a las restricciones establecidas en las secciones 12.212, 52.227-14 y 52.227-19(c)(1) - (2) de FAR y en
la sección 252.227-7014(b)(3) de DFARS, según corresponda, o en posteriores.
Copyright © 2013 CA. Todos los derechos reservados. Todas las marcas registradas, nombres comerciales, logotipos y marcas
de servicios a los que se hace referencia en este documento pertenecen a sus respectivas empresas.
Referencias a productos de CA Technologies
Este documento forma parte de una biblioteca que hace referencia a los productos de
CA Technologies siguientes:
■
CA Catalyst para CA Service Desk Manager (CA Catalyst Connector para CA SDM)
■
CA Client Automation (anteriormente CA IT Client Manager)
■
CA Configuration Automation (anteriormente
CA Cohesion® Application Configuration Manager)
■
Base de datos de gestión de configuración de CA CMDB)
■
CA eHealth®
■
CA Embedded Entitlements Manager (CA EEM)
■
CA Infrastructure Insight (anteriormente Paquete:
CA Spectrum IM & CA NetQoS Reporter Analyzer combinados)
■
CA NSM
■
CA Process Automation (anteriormente CA IT Process Automation Manager)
■
CA Service Catalog
■
CA Service Desk Manager (CA SDM)
■
CA Service Operations Insight (CA SOI) (anteriormente
CA Spectrum® Service Assurance)
■
CA SiteMinder®
■
CA Workload Automation AE
Información de contacto del servicio de Soporte técnico
Para obtener soporte técnico en línea, una lista completa de direcciones y el horario de
servicio principal, acceda a la sección de Soporte técnico en la dirección
http://www.ca.com/worldwide.
Contenido
Capítulo 1: Introducción a Process Automation
11
Fases de desarrollo de procesos ................................................................................................................................ 13
Fase I: análisis de los requisitos.................................................................................................................................. 14
Identificación de los procesos que automatizar ................................................................................................. 15
Identificación de dónde se ejecutan los procesos .............................................................................................. 15
Identificación de los pasos de los procesos ........................................................................................................ 16
Identificación de las interdependencias ............................................................................................................. 16
Identificación de las dependencias externas ...................................................................................................... 17
Identificación de las restricciones de tiempo de ejecución ................................................................................ 17
Fase II: diseño e implementación............................................................................................................................... 17
Identificación de objetos de proceso y operadores ............................................................................................ 18
Configuración de operadores y pasos ................................................................................................................. 20
Optimización de la modularidad y la reutilización de componentes .................................................................. 22
Definición de iniciación y control de un proceso ................................................................................................ 24
Definición de alertas ........................................................................................................................................... 28
Fase III: prueba e implementación ............................................................................................................................. 28
Prueba del proceso con objetos relacionados .................................................................................................... 29
Generación de la documentación del proceso.................................................................................................... 30
Establecimiento de la versión de publicación del proceso y objetos relacionados ............................................ 30
Montaje del proceso con los objetos relacionados ............................................................................................ 30
Implementación de una versión de publicación del proceso con objetos relacionados .................................... 31
Especificación de instrucciones de importación ................................................................................................. 31
Capítulo 2: Guía de procedimientos iniciales
33
Acceso a CA Process Automation e inicio de sesión .................................................................................................. 34
Configuración de los ajustes del usuario .................................................................................................................... 35
Interfaz de usuario de CA Process Automation.......................................................................................................... 36
Páginas principales de la aplicación .................................................................................................................... 39
Controles de interfaz de usuario comunes ......................................................................................................... 55
Exploración del contenido original ............................................................................................................................. 57
Uso de CA EEM para cambiar la contraseña de CA Process Automation ................................................................... 58
Exploradores Web ...................................................................................................................................................... 59
Capítulo 3: Explorador de bibliotecas
61
Personalización del Explorador de bibliotecas ........................................................................................................... 61
Búsqueda en el Explorador de bibliotecas. ................................................................................................................ 61
Contenido 5
Búsqueda de la información de la versión de publicación .................................................................................. 63
Búsqueda de la información de versión .............................................................................................................. 64
Búsqueda de la información de pista de auditoría ............................................................................................. 65
Cómo trabajar con objetos y carpetas ....................................................................................................................... 66
Tipos de objetos de automatización ................................................................................................................... 67
Creación de una carpeta ..................................................................................................................................... 69
Creación de un objeto ......................................................................................................................................... 70
Edición de un objeto ........................................................................................................................................... 71
Versiones............................................................................................................................................................. 83
Eliminación o restauración de un objeto o carpeta ............................................................................................ 95
Cómo copiar y pegar objetos o carpetas............................................................................................................. 96
Cortado y pegado de un objeto o una carpeta ................................................................................................... 97
Cómo trabajar con contenido no modificable .................................................................................................... 98
Capítulo 4: Diseño de procesos
101
El Diseñador de procesos ......................................................................................................................................... 102
Operadores y vínculos: Los fundamentos ................................................................................................................ 104
Creación de un nuevo objeto de proceso ................................................................................................................ 105
Diseño de un proceso............................................................................................................................................... 106
Operadores de proceso ............................................................................................................................................ 108
El operador Iniciar ............................................................................................................................................. 110
Cómo agregar operadores a un proceso ........................................................................................................... 111
Operadores lógicos ........................................................................................................................................... 112
El operador Detener: Éxito o error.................................................................................................................... 114
Proceso de puertos de operador y vínculos ............................................................................................................. 115
Agregación de puertos de operador y vínculos ................................................................................................ 117
Personalización de puertos de salida y expresiones ......................................................................................... 118
Romper un vínculo para mejorar la lectura ...................................................................................................... 120
Bucles de proceso e iteraciones ............................................................................................................................... 120
Variables de sistema para bucles ...................................................................................................................... 121
Creación de un bucle de un operador en un proceso ....................................................................................... 122
Ejecución en bucle de serie de operadores ...................................................................................................... 127
Ejecución de un proceso en bucle..................................................................................................................... 130
Control del proceso .................................................................................................................................................. 132
Procesos hijo ..................................................................................................................................................... 133
Proceso en línea ................................................................................................................................................ 137
Carriles de proceso................................................................................................................................................... 140
Creación de carriles horizontales o verticales ................................................................................................... 141
Gestión de carriles ............................................................................................................................................ 142
Reglas de tratamiento de carriles ..................................................................................................................... 143
Versiones de proceso ............................................................................................................................................... 144
6 Guía del diseñador de contenido
Documentación de un proceso ................................................................................................................................ 144
Agregar comentarios a un proceso ................................................................................................................... 145
Establecimiento del nombre de un operador en un proceso ........................................................................... 145
Cambiar y mostrar información del operador en un proceso........................................................................... 146
Contenido Self-Contained ........................................................................................................................................ 146
Vínculos de contenido independiente .............................................................................................................. 147
Vaya a una parte específica de un proceso .............................................................................................................. 149
Arquitectura multicliente y CA Process Automation................................................................................................ 150
Cómo hacer que un proceso esté al tanto de varios clientes ........................................................................... 151
Seguridad heredada en los subprocesos........................................................................................................... 152
Cómo agregar variables en tiempo de inicialización ......................................................................................... 152
Procesos multicliente utilizando la observación de procesos ........................................................................... 152
El Editor de código de CA Process Automation ........................................................................................................ 152
Capítulo 5: Operadores e iconos
159
Operadores............................................................................................................................................................... 160
Configuración de propiedades del operador .................................................................................................... 163
Recuperación automática ................................................................................................................................. 164
Java y archivos JAR externos ............................................................................................................................. 165
Operadores personalizados .............................................................................................................................. 171
Sus operadores favoritos .................................................................................................................................. 197
Conectores ........................................................................................................................................................ 198
Iconos de operadores............................................................................................................................................... 200
Iconos de estado del operador ......................................................................................................................... 200
Creación, edición y aplicación de iconos personalizados .................................................................................. 202
Capítulo 6: Conjuntos de datos y parámetros
211
Conjuntos de datos .................................................................................................................................................. 211
Crear un objeto de conjunto de datos denominado ......................................................................................... 213
Definir páginas de conjuntos de datos y variables ............................................................................................ 215
Modificación de un conjunto de datos ............................................................................................................. 221
Consulta o copia de una expresión de conjunto de datos ................................................................................ 222
Lectura de valores del sistema operativo en variables de un conjunto de datos ............................................. 222
Parámetros del proceso ........................................................................................................................................... 231
Propiedades de operador ................................................................................................................................. 232
Parámetros calculados ...................................................................................................................................... 248
Capítulo 7: Formularios
285
Formularios de solicitud de inicio ............................................................................................................................ 285
Monitorización de las instancias del formulario de solicitud de inicio y las instancias del proceso ................. 286
Contenido 7
Formularios de solicitud de interacción ................................................................................................................... 287
El Diseñador de formularios ..................................................................................................................................... 289
Elementos de formulario .................................................................................................................................. 292
Propiedades del elemento de formulario ......................................................................................................... 295
Eventos del elemento de formulario ................................................................................................................ 307
Funciones del elemento de formulario ............................................................................................................. 310
Inicialización de variables de formulario .................................................................................................................. 377
Capítulo 8: Recursos
379
Cómo funcionan los recursos ................................................................................................................................... 380
Creación de un objeto de recursos .......................................................................................................................... 381
Edición de un objeto de recurso .............................................................................................................................. 382
Monitorización y edición de recursos ...................................................................................................................... 384
Agregación de un operador Gestionar recursos a un proceso ................................................................................. 385
Definición de acciones de recurso............................................................................................................................ 386
Cómo comprobar y responder recursos no disponibles .......................................................................................... 387
Cómo especificar un intervalo de tiempo de espera ........................................................................................ 388
Especificación de la disponibilidad de los recursos y los valores de configuración de las acciones ................. 389
Cómo comprobar la disponibilidad de los recursos sin ejecutar acciones........................................................ 390
Capítulo 9: Calendarios, planificaciones, tareas y disparadores
391
Calendarios............................................................................................................................................................... 391
Creación de un objeto de calendario ................................................................................................................ 392
El Diseñador de calendario básico .................................................................................................................... 393
El Diseñador de calendarios avanzados ............................................................................................................ 394
El Diseñador de calendario: Ficha Vista previa ................................................................................................. 404
Excluir calendario .............................................................................................................................................. 406
Planificaciones .......................................................................................................................................................... 407
Creación de un objeto de planificación ............................................................................................................. 410
Planificación de un proceso y tareas de operador ............................................................................................ 411
Vista previa de todas las instancias de una tarea planificada ........................................................................... 413
Uso de planificaciones....................................................................................................................................... 414
Control de planificaciones activas ..................................................................................................................... 415
Monitorización de todas las instancias de todas las tareas planificadas .......................................................... 415
Gestión de tareas ..................................................................................................................................................... 417
Asignación de una tarea a un usuario ............................................................................................................... 417
La Lista de tareas ............................................................................................................................................... 419
Administración de disparadores .............................................................................................................................. 420
Control de procesos desde una aplicación externa con llamadas de SOAP...................................................... 421
Cómo funcionan los disparadores de archivo y correo ..................................................................................... 421
Consideraciones de entrada de mensaje SNMP ............................................................................................... 426
8 Guía del diseñador de contenido
Capítulo 10: Ejecución, prueba y depuración de procesos
429
La página Operaciones ............................................................................................................................................. 431
Filtros para instancias de proceso ..................................................................................................................... 432
Objetos de filtro visualizados con un acceso directo ........................................................................................ 434
Objetos de observación de procesos ................................................................................................................ 434
Objetos de paquete de contenidos ................................................................................................................... 436
Reglas de ejecución .................................................................................................................................................. 438
Seguridad de tiempo de ejecución ........................................................................................................................... 439
Propiedades que afectan a la seguridad de los procesos en ejecución ............................................................ 439
Directrices para establecer la seguridad de tiempo de ejecución para un proceso ......................................... 441
Tratamiento de excepciones .................................................................................................................................... 442
Creación de identificadores de excepciones ..................................................................................................... 444
Ejecución interactiva de procesos ............................................................................................................................ 447
Inicie un proceso desde la biblioteca ................................................................................................................ 448
Iniciar un proceso como Suspendido desde la biblioteca ................................................................................. 449
Inicio de un proceso mientras se edita ............................................................................................................. 450
Abrir una instancia de proceso ......................................................................................................................... 450
Estados de proceso .................................................................................................................................................. 451
Depuración de un proceso ....................................................................................................................................... 451
Suspensión de un proceso ................................................................................................................................ 451
Cambio de estado de procesos descargados o finalizados ............................................................................... 452
Configuración y eliminación de puntos de interrupción de un proceso ........................................................... 452
Depuración de un proceso de Java ................................................................................................................... 454
Restablecimiento de un proceso....................................................................................................................... 455
Anulación de un proceso................................................................................................................................... 455
Control de una rama de proceso.............................................................................................................................. 455
Desactivación de operadores o de ramas ......................................................................................................... 456
Anulación de un operador ................................................................................................................................ 456
Restablecimiento de operadores de un proceso .............................................................................................. 457
Reanudación de la ejecución de un proceso suspendido ................................................................................. 457
Simulación del procesamiento de operadores ......................................................................................................... 458
Simulación del procesamiento de un operador seleccionado .......................................................................... 459
Simulación del procesamiento de un proceso completo .................................................................................. 460
Capítulo 11: Generación y uso de documentación de procesos
461
Acerca de la documentación de procesos................................................................................................................ 461
Generación de la documentación del proceso ......................................................................................................... 463
Capítulo 12: Publicación de objetos en otro entorno
465
Versiones de publicación.......................................................................................................................................... 466
Contenido 9
Vista de la información de la versión de publicación ........................................................................................ 466
Definición de la versión de publicación de objetos que se exportarán ............................................................ 467
Configuración como línea de referencia de la versión de publicación de los objetos ...................................... 469
Establecimiento de la versión de publicación del paquete de contenidos como la actual ............................... 470
Exportación e importación ....................................................................................................................................... 470
Exportación ....................................................................................................................................................... 471
Importación....................................................................................................................................................... 486
Valores mantenidos en la versión inicial de un objeto copiado........................................................................ 495
Apéndice A: Especificadores de formato para fechas
497
Apéndice B: Cómo usar máscaras para especificar patrones en cadenas
501
Sintaxis de la máscara .............................................................................................................................................. 501
Máscara de muestra................................................................................................................................................. 505
Apéndice C: Cómo se procesan los objetivos de un operador
507
Cómo se pueden especificar los objetivos para un operador .................................................................................. 507
Cómo procesar un objetivo especificado como una dirección IP o FQDN ............................................................... 508
Cómo procesar un objetivo especificado como el ID de un agente u orquestador ................................................. 513
Caso de Uso: Seguimiento de procesos recuperados mediante registros ............................................................... 514
Ejemplo de recuperación automática de operadores .............................................................................................. 515
10 Guía del diseñador de contenido
Capítulo 1: Introducción a Process
Automation
Los equipos de tecnología de la información como el suyo están automatizando sus
procesos de TI. Al definir, automatizar y orquestar procesos en distintos sistemas, se
puede mejorar la productividad a la vez que se imponen estándares en distintos
departamentos. La automatización ayuda a su organización a:
■
Reducir los gastos operacionales
■
Aumentar la productividad de la plantilla
■
Acelerar la entrega de servicio de TI
■
Mejorar la calidad del servicio
■
Imponer las políticas de conformidad
Automatizar procesos operacionales que pueden tomar tiempo y ser manuales,
incoherentes y propensos a errores. Los procesos de TI que comprenden varios sistemas
en distintas organizaciones se pueden automatizar.
Capítulo 1: Introducción a Process Automation 11
Fases de desarrollo de procesos
Bienvenido a CA Process Automation
Use CA Process Automation para diseñar, probar, gestionar e informar sobre procesos
automatizados que sean compatibles con operaciones de TI y entornos de producción.
CA Process Automation acelera la entrega de servicios de TI a la vez que reduce los
errores manuales. Tendrá la posibilidad de:
Utilice CA Process Automation en su explorador Web para gestionar, diseñar e
implementar procesos en una interfaz fácil de usar que ofrece las siguientes funciones
básicas:
■
Creación visual, incluidos los familiares diseños basados en iconos que pueden
arrastrarse y soltarse.
■
Monitorización de procesos de empresa con la capacidad de detener, modificar y
reanudar los procesos en ejecución.
■
Vistas basadas en roles con opciones de diseño flexibles.
■
Objetos fáciles de usar. Los procesos, los calendarios, las planificaciones, los
conjuntos de datos, los formularios y otros objetos de automatización se
representan como objetos en los cuales se puede hacer clic.
■
Sencilla organización de objetos de automatización a través de una biblioteca de
carpetas jerárquicas.
■
Control de versiones de objetos, incluidos la incorporación, extracción y selección
de versiones de línea de referencia actuales.
■
Funciones de ayuda activas para ayudarle a trabajar con conjuntos de datos,
variables y expresiones.
■
Procesamiento de operadores que se integran con otras aplicaciones y sistemas.
Esta sección contiene los siguientes temas:
Fases de desarrollo de procesos (en la página 13)
Fase I: análisis de los requisitos (en la página 14)
Fase II: diseño e implementación (en la página 17)
Fase III: prueba e implementación (en la página 28)
12 Guía del diseñador de contenido
Fases de desarrollo de procesos
Fases de desarrollo de procesos
Antes de trabajar con CA Process Automation, es importante que el usuario, como desarrollador de contenido o
diseñador, se familiarice con los conceptos de desarrollo del proceso. El resto de esta sección muestra las fases y
los pasos implicados en la automatización de los procesos de TI.
El desarrollo del proceso incluye las fases siguientes:
Fase I: análisis de los requisitos (en la página 14)
Identifique y caracterice los procesos de automatización necesarios en su
organización.
Fase II: diseño e implementación (en la página 17)
Asigne requisitos a objetos de automatización y configure los elementos.
Identifique elementos existentes para volver a utilizarlos, módulos que se necesitan
de terceros (por ejemplo, procesos relacionados con bases de datos o datos de
administradores de bases de datos) y módulos que el usuario mismo debe
desarrollar. Luego se podrán utilizar las herramientas de desarrollo de CA Process
Automation para importar o definir esos objetos de automatización en su
biblioteca.
Fase III: prueba e implementación (en la página 28)
Exporte todos los objetos de automatización relevantes a un archivo y facilite su
importación en el entorno de producción de CA Process Automation. Proporcione a
los administradores de producción instrucciones sobre cómo configurar los
elementos del entorno de producción.
Capítulo 1: Introducción a Process Automation 13
Fase I: análisis de los requisitos
Fase I: análisis de los requisitos
Esta fase se centra en qué información se debe recopilar y qué incidencias se deben
solucionar antes de diseñar un proceso o paquete de gestión de CA Process Automation.
Sus sitios específicos y soluciones de gestión podrían requerir tareas adicionales.
Incluya las tareas siguientes en un análisis de requisitos típico:
 Identificación de los procesos para automatizar.
 Identificación de dónde se ejecutan los procesos.
 Identificación de los pasos de los procesos y descripción de los resultados de cada
paso.
 Identificación de las interdependencias.
 Identificación de las dependencias externas.
 Identificación de las restricciones de tiempo de ejecución.
Los buenos candidatos a la automatización de los procesos cumplen uno o varios de los
requisitos de iniciación siguientes:
■
Se pueden identificar varias tareas, a menudo interdependientes.
■
Se pueden identificar requisitos de recursos superpuestos.
■
El proceso se puede ejecutar en la red o en distintas plataformas.
■
Se pueden aplicar restricciones de fecha y hora para planificar el proceso.
■
Otros procesos, aplicaciones o usuarios pueden disparar el proceso.
■
Los administradores, operadores u otros usuarios de la base de datos o del sistema
pueden ejecutar el proceso a petición.
14 Guía del diseñador de contenido
Fase I: análisis de los requisitos
Identificación de los procesos que automatizar
El primer paso en el proceso de desarrollo de CA Process Automation es identificar los
procesos para automatizar. Un proceso suele incluir varios subprocesos.
Lleve a cabo los pasos siguientes:
1.
Identifique la tarea primaria o el caso de uso, como, por ejemplo, mover datos de
bases de datos transaccionales distribuidas a un solo almacén de datos.
2.
Identifique subprocesos para tareas subordinadas, como:
a.
Extraer datos de fuentes diferentes
b. Transformar datos extraídos
c.
3.
Cargar los datos transformados
Separar los componentes comunes a distintos procesos en subprocesos modulares.
De una forma similar a la reutilización de los códigos, la modularización de
subprocesos compartidos ahorra tiempo de desarrollo y mantenimiento.
Nota: Más adelante en esta guía, aprenderá que los subprocesos corresponden a
objetos (en la página 67) independientes del proceso en el explorador de bibliotecas.
Identificación de dónde se ejecutan los procesos
Identifique dónde se desea ejecutar los componentes siguientes:
■
el proceso propiamente dicho
■
los subprocesos.
■
las tareas del proceso y los subprocesos.
Nota: Más adelante en esta guía, aprenderá que estas ubicaciones corresponden a
puntos de contacto que ejecutan procesos o pasos individuales en procesos. El
administrador configura puntos de contacto por el usuario.
Capítulo 1: Introducción a Process Automation 15
Fase I: análisis de los requisitos
Identificación de los pasos de los procesos
Incluya cada paso que se realiza como parte del proceso o subproceso.
Lleve a cabo los pasos siguientes:
1.
2.
Identifique cada paso. Algunos ejemplos serían:
■
Ejecutar una aplicación
■
Obtener datos de una fuente remota
■
Realizar uno o varios cálculos
■
Pedir información a un usuario con un formulario
■
Iniciar un subproceso
Para cada paso, identifique los posibles resultados siguientes:
a.
Resultados normales
b. Resultados anormales
c.
Resultados condicionales
Un paso puede producir un resultado con resultados condicionales. Cuando el
resultado es mayor que un valor especificado, el paso produce un resultado
concreto. Cuando el resultado es menor que un valor especificado, el paso produce
un resultado distinto. Varios resultados calculados determinan las rutas
subsiguientes por las distintas ramas de un proceso.
Nota: Más adelante en esta guía aprenderá que los pasos del diseño de un proceso
corresponden a operadores (en la página 104).
Identificación de las interdependencias
Las interdependencias determinan el flujo lógico de un proceso.
Lleve a cabo los pasos siguientes:
1.
Determine qué pasos de un proceso deben preceder o seguir a otros en un proceso.
2.
Determine cómo afectará a los pasos subsiguientes el resultado de cada paso.
3.
Para un paso con más de un resultado, identifique cada resultado y enumere la
secuencia independiente de pasos que deben ejecutarse después de cada
resultado.
Nota: La aplicación realiza cada resultado por separado. Por ejemplo, el resultado
anormal de un paso puede hacer que un proceso alerte a otro paso que espere a
recibir información. Para el mismo paso u operador, un resultado personalizado
podría activar una rama independiente del proceso para gestionar una condición de
error.
16 Guía del diseñador de contenido
Fase II: diseño e implementación
Identificación de las dependencias externas
Identifique las dependencias externas de los pasos de un proceso, tales como:
■
Sistemas remotos y aplicaciones.
■
Recursos compartidos como sistemas de archivos o bases de datos.
■
Procesos sincronizados y otros procesos que se ejecutan en paralelo.
Identificación de las restricciones de tiempo de ejecución
Identifique los recursos que un proceso requiere en el tiempo de ejecución. Puesto que
se comparten, los recursos siempre están limitados; por ejemplo, procesadores,
memoria o acceso a otros archivos, bases de datos o hardware. Recuerde que existen
dos tipos principales de restricciones de tiempo de ejecución:
■
Las restricciones de tiempo definen cuándo se debe completar un proceso. Los
ejemplos incluyen copias de seguridad que se ejecutan de noche o actividades de
mantenimiento del sistema que se ejecutan solamente durante un período de
tiempo específico.
■
Las restricciones de configuración incluyen requisitos de entorno de proceso. Por
ejemplo, los datos que deben estar disponibles para un proceso, incluidos archivos,
programas, perfiles de usuario y datos de cuenta, como nombres de usuario y
contraseñas.
Fase II: diseño e implementación
En la fase de diseño del desarrollo de un proceso, se asignan requisitos a objetos de
automatización de CA Process Automation y funcionalidad de operador. Los pasos del
diseño y la implementación de un proceso incluyen:
 Identificación de los objetos de automatización y los operadores del proceso
necesarios para implementar el proceso.
 Configuración de todos los operadores y pasos lógicos, incluidos las tareas, los
parámetros, los resultados, los recursos y las dependencias. Definición de la
información de configuración requerida durante el tiempo de ejecución (como
nombres de usuario, contraseñas y nombres de archivo).
 Optimización de su diseño para la modularidad y la reutilización de componentes.
 Definición de la iniciación y monitorización de un proceso, incluidos los permisos
para iniciar, controlar y modificar el proceso.
 Definición de las alertas y determinación de qué usuarios o grupos se alertan.
Capítulo 1: Introducción a Process Automation 17
Fase II: diseño e implementación
Identificación de objetos de proceso y operadores
Cada proceso o subproceso que se identifique corresponde a un objeto de proceso del
explorador de bibliotecas. Los objetos de un proceso definen una secuencia de pasos
vinculados. Cada operador de un proceso representa un paso. Después de diseñar un
proceso paso a paso, identifique los operadores que llevarán a cabo cada paso. A veces
un solo operador puede realizar un paso determinado. Otras veces, un paso puede
requerir dos o más operadores independientes.
Defina los pasos de un proceso colocando operadores basados en iconos que
representen las acciones que CA Process Automation realiza. Los operadores Iniciar
empiezan los procesos. Los operadores Detener finalizan los procesos. Los operadores
lógicos y de control definen los puntos de inicio y fin, la ramificación y las iteraciones del
proceso. El diseño de un proceso revela su estructura y asigna, sincroniza y define las
tareas y las dependencias existentes entre ellas.
Ejemplo: Operadores de un proceso
18 Guía del diseñador de contenido
Fase II: diseño e implementación
Elemento: Descripción:
Iniciar: el operador Iniciar representa el punto de entrada único donde empieza el proceso. Los
operadores Iniciar también indican el primer paso de una rama independiente.
Retraso: el operador Retraso demora el procesamiento de las ramas posteriores de un proceso hasta
que haya transcurrido un intervalo especificado de días, horas, minutos y segundos.
Operador O: los operadores O e Y controlan los pasos desde el punto de vista lógico. La acción del
operador O finaliza únicamente (y permite que continúe el procesamiento) cuando finaliza uno de los
operadores especificados. El operador Y finaliza únicamente (y permite que continúe el
procesamiento) cuando finalizan todos los operadores especificados.
Obtener variable SNMP: este operador devuelve el valor de una variable SNMP.
Enviar correo electrónico: utilice este operador para notificar a otros usuarios por correo
electrónico.
Escribir archivo: este operador escribe una variable de conjunto de datos en un archivo.
El puerto de salida personalizado
de salida específica.
especifica un curso predefinido de acción para una condición
Iniciar proceso: este operador inicia otro proceso. Se puede establecer una propiedad de bucle
opcional para ejecutar otro proceso repetidamente.
Error al detener: el operador Error al detener detiene todas las ramas de un proceso y configura el
estado del proceso como Erróneo. Utilice un operador Error al detener para el resultado anormal de
un proceso o una rama.
Detención correcta: el operador Detención correcta detiene todas las ramas de un proceso y
configura el estado del proceso como Completado. Utilice un operador Detención correcta para
indicar el resultado normal de un proceso o una rama.
Capítulo 1: Introducción a Process Automation 19
Fase II: diseño e implementación
Configuración de operadores y pasos
Después de identificar los operadores de cada paso, defina sus propiedades. Piense en
los tipos de datos que necesitan y la fuente de esos datos. Algunas propiedades de
operador son comunes a todos los operadores y otras se limitan a tipos específicos de
operadores. Por ejemplo, un operador de base de datos requiere parámetros para el
tipo de base de datos, el nombre de base de datos, un nombre de usuario válido y la
contraseña.
Se puede establecer el valor de una propiedad como una entidad literal como 5 o
Australia, o como una expresión como Var1.quantity o GetCountry. Las expresiones a
menudo incluyen variables o funciones. Una variable almacena un valor. Por ejemplo,
una variable puede contener una contraseña o una configuración de umbral. Una
función inspecciona un declaración lógica y devuelve un valor. Por ejemplo, una función
puede obtener o establecer el valor de un campo.
Las expresiones pueden incluir cualquiera de los elementos siguientes:
■
Variables del sistema y usuario
■
Functions
■
Valores literales
■
Operadores lógicos, de cadena, aritméticos y de comparación
■
Expresiones de JavaScript
Algunos campos sólo aceptan valores literales. Las etiquetas de estos campos aparecen
en cursiva. La mayor parte de los campos permiten las expresiones calculadas.
Nota: Versiones anteriores de CA Process Automation marcan los campos que aceptan
expresiones calculadas con un asterisco (*).
Los operadores también comparten las propiedades comunes siguientes:
■
Objetivo de ejecución: ¿Dónde debe ejecutarse este operador?
■
Valores de configuración de tiempo de espera: ¿Qué debe suceder cuando el
operador tarda demasiado en ejecutarse?
Para obtener más información sobre la funcionalidad y las propiedades de cada
operador, consulte la Guía de referencia del diseñador de contenido.
Los conjuntos de datos almacenan variables de CA Process Automation. Se pueden
agregar y editar variables en cualquiera de estos tres tipos de conjuntos de datos:
■
Conjuntos de datos denominados: los objetos de conjuntos de datos que crea y
mantiene en el explorador de bibliotecas.
■
Conjuntos de datos del proceso: el conjunto de datos de cada proceso.
■
Conjuntos de datos del operador: el conjunto de datos de cada operador de un
proceso.
20 Guía del diseñador de contenido
Fase II: diseño e implementación
Adicionalmente, el conjunto de datos de sistema de sólo lectura pone datos del sistema
a disposición de cualquier expresión. Para definir valores que pueden cambiar, como
credenciales de usuario, se utilizan variables y expresiones más complicadas. Se pueden
asignar valores para expresiones y variables globalmente o se puede cambiar
dinámicamente un valor en el código. Al configurar parámetros, sólo utilice valores
literales si es poco probable que los valores cambien.
Conjuntos de datos denominados
Utilice las variables globales en conjuntos de datos denominados para definir los valores
de configuración de parámetros. Los conjuntos de datos denominados son objetos de
automatización que definen variables que tienen un alcance que abarca la biblioteca
entera. Dependiendo de la configuración de seguridad para un objeto de conjunto de
datos, sus variables son globalmente accesibles para cualquier expresión en cualquier
objeto de automatización. Un campo en otro conjunto de datos puede hacer referencia
a una variable de conjunto de datos.
Los conjuntos de datos denominados se utilizan para especificar información como las
cuentas y contraseñas usadas en varios procesos. Cuando la información guardada en
un conjunto de datos denominado cambia, sólo se debe cambiar una vez, en el conjunto
de datos denominado, en lugar de en cada objeto de automatización que la utiliza.
Formulario de solicitud de inicio se puede utilizar para recopilar información de usuarios
autorizados y, a continuación, actualizar los valores de las variables del conjunto de
datos. El operador Ejecutar JavaScript se puede utilizar en un proceso para calcular y
almacenar valores en variables con nombre.
Recursos
Algunos operadores o procesos consumen mucha memoria, tiempo de procesador u
otros recursos limitados. Por ejemplo, si un proceso hijo llama a otros procesos y
monopoliza así muchos ciclos de CPU, se puede limitar la cantidad de instancias del
proceso hijo que se ejecutan en cualquier momento determinado.
Para gestionar los recursos, defina el objeto recurso que el proceso consume. Cuando
los procesos en ejecución bloquean o consumen el recurso, las demás solicitudes del
recurso deben esperar hasta que el recurso esté disponible o libre. Utilice los recursos
para gestionar el equilibrio de carga en sus procesos.
Más información:
Recursos (en la página 379)
Capítulo 1: Introducción a Process Automation 21
Fase II: diseño e implementación
Asignación de condiciones de salida a los resultados
Se puede definir una condición de salida para cada resultado del operador. Un operador
puede tener varias condiciones de salida para resultados diferentes, como Completado
o Erróneo.
Los operadores son compatibles con condiciones de salida específicas. Algunos
operadores también permiten definir un puerto personalizado. Por ejemplo, se puede
definir un puerto personalizado que solamente se ejecute si el resultado del operador es
Verdadero, Falso, "azul", 500, -2 o cualquier otro valor designado.
Defina un puerto personalizado cuando tenga un curso de acción claro en mente para
una condición de salida particular. Tal tipo de condición se da cuando falla la
importación de una base de datos por un motivo determinado. Cuando se ejecuta un
proceso y se encuentra una situación sin ninguna condición de salida específica, el
proceso se suspende y pasa a un estado bloqueado a la espera de la acción del usuario.
Los administradores u otros usuarios con un número suficiente de permisos pueden
cambiar valores de configuración de parámetros si es necesario y reiniciar un proceso
suspendido desde donde se interrumpió o desde el inicio.
Optimización de la modularidad y la reutilización de componentes
Divida los procesos en subprocesos separados u objetos de proceso hijo. Utilice un
proceso padre principal para controlar los subprocesos. Cada subproceso realiza una
tarea independiente o un conjunto de tareas, como extraer datos de una base de datos
y escribirlos en archivos separados. Cuando varios procesos comparten un subproceso
común, mantenga la flexibilidad en el diseño para permitir que el subproceso pueda
seguir usándose en los distintos procesos padre.
Agregue flexibilidad mediante variables o expresiones para configurar parámetros en el
proceso y en cada operador. De esta forma, si un proceso se reutiliza en entornos
diferentes o sistemas, ajustar el proceso es tan fácil como actualizar solamente las
variables relevantes.
CA Process Automation también le ayuda a controlar el flujo entre rutas diferentes o
subprocesos. Por ejemplo, cuando un proceso requiere una entrada en tiempo de
ejecución, se pueden utilizar los formularios de solicitud de interacción para solicitar a
los usuarios la información. Utilice uno o varios formularios de solicitud de interacción
para implementar puntos de control del proceso cuando usuarios o grupos específicos
deban autorizar un subproceso específico antes de que pueda continuar. El operador
Asignar tarea de usuario de un objeto de proceso detiene el proceso y, a continuación,
abre el formulario. El usuario puede introducir a continuación los valores necesarios.
22 Guía del diseñador de contenido
Fase II: diseño e implementación
Operadores personalizados
Se puede basar un objeto de operador personalizado en cualquiera de los otros
operadores disponibles en el entorno. Utilice los operadores personalizados para:
■
Facilitar la reutilización: utilice el mismo operador con los mismos valores de
configuración en procesos diferentes.
■
Guardar los valores de configuración de una tarea: se pueden preconfigurar
operadores personalizados para realizar ciertas tareas. Por ejemplo, se puede
definir un operador personalizado para usarse con una aplicación que ya esté
instalada en su sistema.
■
Interactuar con aplicaciones de empresa: también se puede exportar una carpeta
como un paquete de contenidos para proporcionar compatibilidad con aplicaciones
de empresa comunes.
Se puede modificar el operador personalizado sin cambiar el operador original.
Capítulo 1: Introducción a Process Automation 23
Fase II: diseño e implementación
Definición de iniciación y control de un proceso
Iniciación del proceso
Al diseñar procesos, decida cómo debe comenzar cada proceso. Un proceso se puede
diseñar para iniciarse de varias maneras:
■
Inicio manual: se puede iniciar manualmente un proceso en el explorador de
bibliotecas o el diseñador de procesos. Como un diseñador y desarrollador de
contenido que trabaja en CA Process Automation, suele iniciar procesos
manualmente mientras los diseña y examina.
■
Inicio automático: se puede elaborar un proceso que automáticamente inicia otro
proceso mediante el operador Iniciar proceso.
■
Inicio automático a través de una entidad externa: se puede establecer un proceso
para iniciarse desde una aplicación externa o sistema mediante servicios Web, una
utilidad de línea de comandos o disparadores. Por ejemplo, se puede especificar
que otro programa inicie un proceso mediante servicios Web (executeProcess o
executeStartRequest). Se puede establecer un proceso que se inicie a través de un
evento externo mediante el uso de disparadores compatibles, incluidos la creación
de archivos, un correo electrónico entrante, mensajes SNMP y eventos de
conectores UCF.
■
Inicio a través de una planificación: se puede planificar un proceso para iniciarse
mediante un objeto de planificación.
■
Inicio a través de un usuario y un formulario: se puede diseñar un objeto de
formulario de solicitud de inicio u objeto de formulario de solicitud de interacción
que pueda pedir a un usuario que responda al formulario que da lugar a la iniciación
de otro proceso. Un ejemplo de este método para iniciar un proceso es un
formulario de envío de informe de gastos. Un empleado puede rellenar el
formulario e iniciar un proceso de actualización de gastos a petición.
Control del proceso
Diseñadores, administradores y personal de producción utilizan CA Process Automation
parar controlar procesos. Para aprender más, consulte el siguiente contenido
correspondiente a su rol:
■
Diseñadores: para ejecutar, probar y depurar procesos, consulte Ejecución, prueba
y depuración de procesos (en la página 429).
■
Administradores: para administrar contenido de una aplicación o un sistema,
consulte la Guía del administrador de contenido de CA Process Automation.
■
Usuarios de producción: para iniciar procesos interactivamente en un entorno de
producción, consulte la Guía del usuario de producción de CA Process Automation.
24 Guía del diseñador de contenido
Fase II: diseño e implementación
Planificación de procesos
Dos objetos de automatización que se usan para panificar procesos son los calendarios y
las planificaciones. Utilice los objetos de calendario para definir condiciones de fecha
para las tareas de inicio que inician procesos u operadores individuales. Utilice objetos
de planificación para planificar tareas mediante objetos de calendario y/o fechas
explícitas.
■
La creación de condiciones de fecha con objetos de calendario se describe en
Calendarios (en la página 391).
■
Las tareas de planificación con objetos de planificación se describen en
Planificaciones (en la página 407).
Más información:
Calendarios (en la página 391)
Procesos a petición
Las herramientas administrativas y de desarrollo disponibles en la ficha Operaciones
exponen la estructura subyacente y la lógica de bibliotecas y aplicaciones. La ficha
Operaciones podría incluir un objeto de formulario de solicitud de inicio para pedir al
usuario la información requerida para iniciar un proceso. Los usuarios autorizados
pueden usar formularios de solicitud de inicio para ejecutar procesos a petición sin
conocer los detalles técnicos subyacentes:
■
Cómo funciona CA Process Automation.
■
Cómo está diseñada la arquitectura del sistema.
■
Cómo se estructura cada proceso.
Más información:
Formularios de solicitud de inicio (en la página 285)
Capítulo 1: Introducción a Process Automation 25
Fase II: diseño e implementación
Activación de procesos
CA Process Automation es compatible con eventos y disparadores que pueden iniciar
procesos desde aplicaciones y sistemas externos. Se pueden designar aplicaciones,
mensajes de correo electrónico, páginas Web u otros procesos para disparar un
proceso. Cualquiera de los métodos siguientes se puede utilizar para disparar un
proceso:
■
FTP
■
HTTP/SOAP post
■
Mensajes SNMP personalizados
■
SMTP (correo electrónico)
■
Evento UCF
Para obtener más información, consulte Disparadores (en la página 420).
Monitorizar procesos
Se pueden monitorizar gráficamente procesos mediante un objeto de observación de
procesos. Los objetos de observación de procesos proporcionan portales o accesos
directos a todos los procesos y objetos relacionados para una categoría de propiedades
concreta. Por ejemplo, un equipo de almacén de datos necesita obtener acceso a un
objeto de observación de procesos que contenga accesos directos a todos los procesos
de extracción, transformación y carga (ETL) para rellenar almacenes de datos.
Considere los roles y la propiedad al gestionar una observación de procesos. Por
ejemplo, los usuarios finales generalmente deben consultar y responder a los procesos a
medida que tienen lugar. En cambio, un administrador podría necesitar consultar el
historial. Un objeto de observación de procesos representa la propiedad al incluir
solamente aquellos objetos que debe monitorizar la persona que lo utiliza.
Más información:
La página Operaciones (en la página 431)
26 Guía del diseñador de contenido
Fase II: diseño e implementación
Definición de permisos
Los permisos dependen de quién es el propietario de los componentes gestionados o de
quién es responsable de funciones de gestión particulares. Se pueden asignar permisos
por grupo funcional (como administradores, operadores o un equipo de almacén de
datos) o por propiedad. A continuación, se pueden agregar o quitar usuarios
individuales de un grupo.
Por ejemplo, un equipo de almacén de datos controlaría los procesos ETL (de extracción,
transformación y carga) para rellenar un almacén de datos. Cree un grupo de almacén
de datos que contenga a los miembros del equipo de almacén de datos. Luego otorgue a
este grupo permisos de lista y de apertura para un objeto de observación de procesos
proporcionando todos los accesos directos relacionados con los procesos ETL.
A los administradores se les asignan más permisos que a los usuarios generales. Un
administrador de base de datos puede tener control sobre procesos para actualizar un
almacén de datos o para restaurar o realizar una copia de seguridad de ciertas bases de
datos. Si está haciendo un desarrollo para un entorno de empresa complicado en el que
hay muchos roles y propiedades diferentes, considere esto enfoque. Elabore la
propiedad para los grupos, usuarios y roles en una hoja de cálculo o en otro formato
para asignar los permisos correspondientes.
La propiedad de un proceso (o cualquier objeto de automatización) se asigna primero al
usuario bajo el cual se crea. La propiedad se puede cambiar.
El editor de permisos de CA EEM define los permisos de los usuarios para llevar a cabo
acciones en el tiempo de ejecución. Los miembros del grupo PAMAdmins
predeterminado tienen plenos permisos en todas las carpetas y todos los objetos de
automatización. Los miembros del grupo PAMUsers predeterminado no tienen ningún
permiso en ninguna carpeta u objeto de automatización. Los diseñadores de contenido
suelen ser miembros del grupo Diseñadores.
Los administradores de contenido o el propietario de una carpeta pueden asignarle
permisos en la carpeta con la propiedad Establecer propietario. Los objetos de
automatización agregados a la carpeta heredan los permisos de carpeta. Un
administrador con credenciales de CA EEM le puede asignar permisos en objetos de
automatización y carpetas en CA EEM.
Nota: Consulte la Guía del administrador de contenido para obtener más detalles.
Capítulo 1: Introducción a Process Automation 27
Fase III: prueba e implementación
Definición de alertas
En los procesos se pueden utilizar alertas de correo electrónico para poner sobre aviso a
usuarios o administradores sobre errores o incidentes, o para informar a usuarios de
que se ha completado un proceso o una tarea.
Cuando se diseñan alertas en un proceso, primero deben definirse los destinatarios. Por
ejemplo, se podría notificar a un único administrador cuando un proceso es correcto,
falla o espera información del usuario. También se puede crear un grupo de
destinatarios para alertar a los gestores que puedan necesitar recibir informes
mensuales.
Cree procesos separados que no solamente envíen alertas, sino que también dominen la
escalación y realicen otras tareas relacionadas con la alerta. Luego, si fuera necesario,
invoque el proceso de alerta desde otros procesos mediante el operador Iniciar proceso.
Utilice siempre variables de conjunto de datos denominado en CA Process Automation
para especificar destinatarios de correo electrónico, usuarios, grupos, perfiles y
contraseñas de cuentas. Utilice las variables para establecer parámetros en el operador
Enviar correo electrónico. Cuando se produzcan cambios, sólo hay que editar las
variables de un conjunto de datos denominado en lugar de todos los procesos que
utilizan los valores.
Debido a que los individuos cambian, se pueden definir grupos de correo electrónico de
usuario o alias de correo electrónico basados en una función o un rol. Cuando el
personal cambia, se pueden cambiar los individuos asignados a los alias sin tener que
editar las variables. Es posible que su organización ya tenga alias para los roles o grupos
correspondientes.
Fase III: prueba e implementación
La implementación del paquete de gestión de CA Process Automation en un entorno de
producción incluye las actividades siguientes:
1.
Monte los objetos de automatización en una carpeta. Los administradores
implementan una carpeta en otro orquestador, normalmente en un entorno
diferente.
2.
Hay que probar, depurar y verificar todo el contenido para la transición.
3.
Exporte la carpeta como un paquete de contenidos del entorno de desarrollo.
4.
Importe el paquete de contenidos en un entorno de producción.
5.
Proporcione instrucciones y formación para que los usuarios puedan activar
planificaciones y usar formularios para iniciar procesos a petición.
28 Guía del diseñador de contenido
Fase III: prueba e implementación
Prueba del proceso con objetos relacionados
Las pruebas son esenciales para implementar el paquete de gestión de CA Process
Automation que representa los procesos que se desean automatizar. Compruebe que
todos los componentes funcionen juntos según el diseño antes de implementar el
paquete de contenidos del entorno de diseño en el entorno de producción.
CA Process Automation tiene varias funciones para probar los procesos:
■
Un proceso se puede iniciar en el modo suspendido en la paleta Diseño y realizar
pruebas de tiempo de ejecución. Mientras se ejecuta la instancia del proceso, es
posible iniciarla en cualquier momento, así como hacer pausas en ella.
■
Se pueden establecer puntos de interrupción para hacer pausas y depurar los pasos
del proceso.
■
Los procesos se pueden ejecutar en el modo de simulación, lo que permite definir
los resultados específicos para un paso. El modo de simulación genera los
resultados simulados de cada paso sin realizar acciones reales.
Las pruebas se realizan en los niveles siguientes:
■
Los diseñadores de contenido comprueban que cada proceso y los objetos de
automatización que utiliza funcionen correctamente en el entorno de diseño.
■
Los administradores prueban la implementación después de la exportación e
importación para asegurarse de que cada proceso y los objetos de automatización
que utiliza funcionen correctamente en el entorno de producción. Este proceso se
realiza sin problemas cuando los administradores crean puntos de contacto en el
entorno de producción con los mismos nombres que en el entorno de diseño. Cada
miembro del par de puntos de contacto apunta a los agentes en sus entornos
respectivos.
La implementación en su conjunto puede superar todas las pruebas y ser operacional
mientras que un formulario concreto puede estar todavía en fase de rediseño y prueba.
Los términos siguientes reflejan esta diferencia:
■
Pruebas de unidades frente a las pruebas de integración
■
Una compilación de un candidato de versión interna frente a una compilación de
prueba de concepto del cliente
■
Desarrollo frente a producción
Procesos críticos con la misión de comprobar periódicamente los procesos que no se
ejecutan frecuentemente (como las conmutaciones por error del sistema). Las pruebas
periódicas verifican que los procesos y los usuarios funcionen en el entorno de
producción e impiden que los incidentes se conviertan en crisis.
Capítulo 1: Introducción a Process Automation 29
Fase III: prueba e implementación
Generación de la documentación del proceso
Existen varios roles que pueden generar documentación de procesos en diversos
momentos durante la realización de pruebas y la implementación:
■
Durante el diseño, la documentación de procesos resulta útil para un diseñador de
contenido a la hora de transferir el desarrollo de una automatización en curso a
otro diseñador. El administrador de contenido también puede utilizar la
documentación de procesos para realizar un seguimiento del progreso del proceso
de automatización.
■
Al final del proceso de diseño, los diseñadores de contenido pueden generar la
documentación del proceso para consultarla con posterioridad.
■
Durante la planificación de procesos subsiguiente, los administradores de contenido
pueden hacer referencia a documentaciones de procesos para encontrar más
información sobre conjuntos de datos u otros componentes reutilizables.
■
Cuando un proceso nuevo se importa al entorno de producción, el administrador de
producción puede generar la documentación del proceso que se debe revisar antes
de ejecutar el proceso por primera vez.
■
Tras de utilizar un proceso automatizado durante un período de tiempo, el
administrador de producción puede utilizar la documentación de producción
generada cuando solicite mejoras. Con el diagrama de flujo de procesos, el
administrador puede indicar exactamente dónde se solicita un cambio en un
proceso con facilidad.
Establecimiento de la versión de publicación del proceso y objetos relacionados
Se puede establecer un valor para el atributo de Versión de publicación cuando se
prepare para implementar objetos específicos de publicación en un entorno de
producción. El archivo que se exporta contiene solamente la versión seleccionada de
cada objeto que se exporta. Si se exportan objetos a un paquete de contenidos, los
usuarios no pueden modificar sus versiones de publicación después de la importación.
Todos los objetos se configuran como línea de referencia durante la importación. Como
resultado, los usuarios no pueden modificar la versión importada de ningún objeto. Si
los usuarios de producción tienen que modificar un objeto importado, deben guardarlo
como nueva versión.
Montaje del proceso con los objetos relacionados
Una carpeta monta los objetos de automatización que están relacionados con uno o
varios de los procesos que se están implementando. Un objeto Carpeta incluye objetos
que el proceso usa (por ejemplo, conjuntos de datos) y objetos que usan el proceso (por
ejemplo, formularios de solicitud de inicio).
30 Guía del diseñador de contenido
Fase III: prueba e implementación
Implementación de una versión de publicación del proceso con objetos
relacionados
Una vez que los diseñadores han probado un proceso en el entorno de diseño,
establecen una versión de publicación en el objeto Proceso y todos los objetos
relacionados. Entre los objetos relacionados, se incluyen todos los objetos que el
proceso usa y todos los objetos que usan el proceso.
Un administrador o diseñador monta la versión de cada objeto para publicarla en una
carpeta. Un administrador exporta a un archivo .xml la carpeta de contenido de
automatización relacionado. Después, el administrador importa este archivo XML al
entorno de producción.
Especificación de instrucciones de importación
Para facilitar la implementación del paquete de contenidos, proporcione instrucciones
de importación. Las instrucciones deben redactarse para los administradores de los
entornos de producción y otros usuarios del proceso. Indique cómo los elementos de
proceso se deberán configurar para trabajar en el entorno de producción.
Estas instrucciones pueden incluir los temas de muestra siguientes:
■
Cómo instalar las aplicaciones o actualizaciones necesarias
■
Cómo configurar nombres de usuario, grupos y contraseñas
■
Cómo configurar permisos para usuarios o grupos
■
Cómo configurar conjuntos de datos para el entorno de producción
■
Cómo configurar hardware adicional para operadores
■
Cómo activar planificaciones
■
Cómo configurar disparadores externos
■
Cómo iniciar procesos a petición utilizando un formulario
Capítulo 1: Introducción a Process Automation 31
Capítulo 2: Guía de procedimientos iniciales
Esta sección introduce CA Process Automation y proporciona información básica sobre
el inicio de sesión y cómo familiarizarse con la interfaz de usuario.
Esta sección contiene los siguientes temas:
Acceso a CA Process Automation e inicio de sesión (en la página 34)
Configuración de los ajustes del usuario (en la página 35)
Interfaz de usuario de CA Process Automation (en la página 36)
Exploración del contenido original (en la página 57)
Uso de CA EEM para cambiar la contraseña de CA Process Automation (en la página 58)
Exploradores Web (en la página 59)
Capítulo 2: Guía de procedimientos iniciales 33
Acceso a CA Process Automation e inicio de sesión
Acceso a CA Process Automation e inicio de sesión
La dirección URL que se utiliza para acceder a CA Process Automation depende en si el
orquestador del dominio se configura con un nodo (que no está agrupado en clúster) o
varios nodos (agrupado en clúster). Se puede examinar directamente en CA Process
Automation que no esté agrupado en clúster. Para CA Process Automation agrupado en
clúster, examine el equilibrador de carga asociado. Se puede llegar a todos los
orquestadores del dominio iniciando la dirección URL del orquestador del dominio o del
equilibrador de carga para el orquestador del dominio.
Lleve a cabo los pasos siguientes:
1.
Examine CA Process Automation.
■
Utilice la siguiente sintaxis para acceder a una comunicación segura:
https://servidor:puerto/itpam
Ejemplos:
https://Orchestrator_host:8443/itpam
https://loadBalancer_host:443/itpam
■
Utilice la siguiente sintaxis para la comunicación básica:
http://servidor:puerto/itpam
Ejemplos:
http://Orchestrator_host:8080/itpam
http://loadBalancer_host:80/itpam
Aparecerá la página de inicio de sesión de CA Process Automation.
2.
Introduzca las credenciales de la cuenta de usuario.
Nota: Si se configura CA EEM para hacer referencia a varios usuarios de Microsoft
Active Directory y CA Process Automation no acepta un nombre de usuario
incompleto, debe indicarse el nombre principal, es decir domain_name\user_name.
3.
Haga clic en Iniciar sesión.
CA Process Automation se abre. Se muestra la ficha Página principal.
34 Guía del diseñador de contenido
Configuración de los ajustes del usuario
Configuración de los ajustes del usuario
Después de iniciar sesión por primera vez, configure los valores de configuración de
visualización de la interfaz del usuario.
Lleve a cabo los pasos siguientes:
1.
En la lista de vínculos en la parte superior de la página principal, haga clic en su
nombre del usuario.
2.
En el cuadro de diálogo Configuración del usuario, indique sus preferencias de
visualización para el formato de fecha y hora, y su idioma.
3.
Haga clic en Guardar y cerrar.
Nota: CA Process Automation guarda y restaura automáticamente otros ajustes
personalizados que hace mientras trabaja. Por ejemplo, si fija una paleta o personaliza
las columnas que desea ver en una tabla o lista.
Capítulo 2: Guía de procedimientos iniciales 35
Interfaz de usuario de CA Process Automation
Interfaz de usuario de CA Process Automation
La interfaz de CA Process Automation proporciona un entorno administrativo y de
desarrollo integrado para consultar, gestionar y ejecutar todos los objetos en sus
sistemas de automatización. CA Process Automation es una aplicación Web que se
puede abrir en cualquier equipo con acceso al orquestador de CA Process Automation.
Cada ficha principal en la parte superior de la página presenta una sección o área
funcional única de la aplicación. Los controles comunes que aparecen en toda la
aplicación hacen que esta sea fácil de usar. Por ejemplo, se usan los mismos pasos
básicos para ordenar una lista de entradas y configurar qué columnas deben aparecer.
Equation 1: Este gráfico resalta cómo trabajar con la interfaz de usuario para llevar a
cabo funciones de CA Process Automation.
36 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Capítulo 2: Guía de procedimientos iniciales 37
Interfaz de usuario de CA Process Automation
Elemen Descripción:
to:
Controles del explorador y el SO: aunque no forman parte de CA Process Automation, el sistema
operativo proporciona controles para trabajar con la ventana actual para tareas como Minimizar,
Maximizar, Restaurar y Cerrar. Su explorador también muestra sus propios menús, barras de
herramientas, paneles y áreas de búsqueda. En ocasiones, se pueden utilizar funciones del explorador
para completar funciones integradas de CA Process Automation, por ejemplo, actualizar una página o
ajustar la ampliación de la vista (zoom).
Vínculos: CA Process Automation proporciona vínculos a aplicaciones comunes, por ejemplo,
Configuración del usuario, Ayuda y Cerrar sesión. Las páginas individuales cuentan con vínculos
apropiados al contenido relacionado.
Fichas principales de la aplicación: haga clic en una ficha para centrarse en una sección específica de CA
Process Automation. La ficha Biblioteca está seleccionada en la imagen de muestra, así que la aplicación
muestra carpetas y objetos en el Explorador de bibliotecas.
Barra de herramientas: muchas páginas y cuadros de diálogo contienen barras de herramientas
específicas con iconos y botones de herramienta adecuados.
Paneles: los paneles dividen una ventana o página. En este ejemplo, el panel del Explorador de
bibliotecas aparece a la izquierda y muestra un campo de entrada de filtro y una jerarquía de carpeta
ampliable. La página principal muestra información detallada acerca de la entrada que esté
seleccionada en un panel.
Página principal: el área principal de una página muestra información esencial acerca del elemento que
esté seleccionado en un panel. CA Process Automation normalmente presenta los datos en una tabla,
una lista, un formulario, un lienzo de diseño o un gráfico. Según sea necesario, el área principal se divide
en paletas, fichas, paneles u otros controles visuales.
Cuadro de diálogo: al hacer clic en ciertos botones, aplicar acciones o ejecutar comandos, la aplicación
a menudo presenta cuadros de diálogo para recopilar datos adicionales.
Mensaje: los eventos y la lógica predefinida que el usuario o el sistema inician pueden dar lugar a la
publicación de mensajes. La mayor parte de estas alertas son informativas y proporcionan información
necesaria. Sin embargo, algunos mensajes pueden mostrar advertencias graves diseñadas para proteger
los datos. Los mensajes de error proporcionan información útil que se puede combinar con los datos de
los archivos de registro para solucionar problemas.
38 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Páginas principales de la aplicación
Haga clic en cualquiera de las siete fichas principales para ir a las siete páginas
principales de la aplicación. Mientras trabaja, CA Process Automation aplica lógica y
permisos para determinar lo que se puede consultar. En ocasiones, CA Process
Automation cambia automáticamente su selección de ficha actual o abre otra ventana.
Por ejemplo, si abre un proceso en el explorador de bibliotecas, verá automáticamente
el proceso en el diseñador. Cuando se abre un objeto de planificación desde la ficha
Biblioteca, se ve la ventana Editor de planificaciones. Cuando se hace clic en una
instancia de proceso en la ficha Operaciones, aparece automáticamente una página
Instancia del proceso aparte.
Capítulo 2: Guía de procedimientos iniciales 39
Interfaz de usuario de CA Process Automation
Inicio
Utilice esta página como punto de partida conveniente o cuadro de mandos para su
sesión de trabajo de CA Process Automation. En el ejemplo siguiente se resaltan las
funciones disponibles.
40 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Capítulo 2: Guía de procedimientos iniciales 41
Interfaz de usuario de CA Process Automation
Element Descripción:
o:
Ficha Inicio: haga clic en la ficha Inicio para ver la página principal. La página principal aparece al iniciar
sesión en CA Process Automation.
Botones rápidos: CA Process Automation proporciona una serie de opciones para ahorrar tiempo y
empezar a trabajar. La esquina inferior derecha de la página también contiene Vínculos rápidos.
Tareas y objetos de automatización: CA Process Automation muestra tablas en las que figuran las
tareas y los objetos de automatización que se han extraído (es decir, las versiones de trabajo de los
objetos).
Mi actividad reciente: aparece una lista de actividades de proceso recientes ordenadas por fecha y
hora. Haga clic en un vínculo para abrir la instancia de proceso.
42 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Explorador de bibliotecas
Para gestionar objetos de automatización en carpetas, utilice el Explorador de
bibliotecas.
Element Descripción:
o:
Ficha Biblioteca: Haga clic en esta ficha para ir al Explorador de bibliotecas. Utilice el explorador de
bibliotecas para ver, crear, editar o eliminar objetos y carpetas de automatización.
Panel de carpetas: CA Process Automation muestra los orquestadores y carpetas a los que se puede
obtener acceso en este panel de tamaño modificable. Aplique un filtro para ver solamente las carpetas
coincidentes. Por ejemplo, Folder_2 encontraría Folder_2, Folder_200 y MyFolder_2.
Área de búsqueda: introduzca criterios para realizar una búsqueda básica o avanzada. Por ejemplo,
busque uno o varios objetos por nombre, tipo o palabra clave. También se pueden buscar y reemplazar
objetos.
Crear objetos de automatización: en el explorador de bibliotecas se pueden crear carpetas para
almacenar objetos de automatización. Haga clic con el botón secundario del ratón en una carpeta para
consultar el menú de comandos que se pueden realizar en esa carpeta. También se pueden crear
nuevos objetos de automatización como procesos, planificaciones o formularios de solicitud de inicio.
Cambiar nombre de un objeto: haga clic con el botón secundario del ratón sobre un objeto y elija
Cambiar nombre del menú de acceso directo para editar el nombre.
Capítulo 2: Guía de procedimientos iniciales 43
Interfaz de usuario de CA Process Automation
Element Descripción:
o:
Editar un objeto: utilice la barra de herramientas o haga clic con el botón secundario del ratón en un
objeto para consultar un menú de acceso directo de comandos.
Propiedades: este panel con fichas muestra datos generales, etiquetas, versiones, publicaciones y una
pista de auditoría para cada objeto.
Papelera de reciclaje: utilice la Papelera de reciclaje para gestionar objetos y las carpetas que se han
suprimido. La aplicación permite restaurarlos, dejarlos en la Papelera de reciclaje o borrarlos
definitivamente.
Nota: Para obtener más información acerca de la configuración de la seguridad de objetos y carpetas, consulte la
Guía del administrador de contenido.
44 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Diseñador
Para diseñar, editar y probar un proceso, use la página Diseñador. El diseñador es
compatible con los siguientes detalles del proceso:
■
Flujo del operador básico
■
Documentación de los objetos Proceso
■
Resultados lógicos
■
Conexión de líneas
■
Exploración de conjuntos de datos
■
Definición de propiedades
■
Escritura de código
■
Monitorización de las instancias de proceso
■
Recorrido paso a paso, depuración, prueba y control de las instancias de proceso
Element Descripción:
o:
Ficha del diseñador: cuando se abre un proceso nuevo o se edita uno existente desde el explorador de
bibliotecas, aparece esta ficha. Si esta ficha no está disponible, significa que todavía no ha abierto
ningún proceso o que no tiene permisos de seguridad para abrir un proceso.
Capítulo 2: Guía de procedimientos iniciales 45
Interfaz de usuario de CA Process Automation
Element Descripción:
o:
Barra de herramientas del diseñador de procesos: use los botones de herramientas para diseñar y
probar procesos. Utilice los valores de configuración de Ver de la derecha para mostrar u ocultar los
operadores, conjuntos de datos, propiedades y las paletas de navegación.
Fichas de proceso: cada proceso que abre aparece en su propia ficha. Se pueden copiar y pegar
objetos entre fichas.
Diseñador de procesos: el diseño de proceso actual aparece en esta zona de trabajo, lienzo o diseño.
El diseñador de procesos incluye la cuadrícula, carriles, todos los operadores, puertos y líneas de
conexión.
Paleta de operadores: arrastre y suelte operadores con funciones específicas desde esta paleta en el
diseño de su proceso.
Paleta del conjunto de datos: use esta paleta para consultar o editar las variables de conjuntos de
datos de un proceso u operador.
Paleta Propiedades: utilice esta paleta y sus vínculos y ventanas para gestionar las propiedades de un
operador. En este ejemplo se muestran las propiedades del operador Ejecutar script. El usuario
también ha agregado código en el cuadro de diálogo Código de ejecución posterior.
Paleta de navegación: use esta paleta para ir a regiones específicas en procesos de mayor tamaño.
Para ahorrar tiempo, intente desplazarse dentro de esta paleta en lugar de desplazarse por el diseño
del diseñador principal.
46 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
También se pueden ejecutar instancias de proceso en la página Diseñador.
Capítulo 2: Guía de procedimientos iniciales 47
Interfaz de usuario de CA Process Automation
48 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Elemen Descripción:
to:
Ficha Diseñador: esta ficha aparece cuando se abre una instancia de un proceso existente desde otra
página de la aplicación. Si esta ficha no está disponible, significa que todavía no ha abierto ninguna
instancia de proceso o que no tiene permisos de seguridad para abrir una instancia de proceso.
Barra de herramientas de instancias de proceso: use los botones de herramientas para detener, iniciar,
depurar y probar instancias actuales de un proceso. Utilice los valores de configuración de Ver de la
derecha para mostrar u ocultar los operadores, conjuntos de datos, propiedades y las paletas de
navegación y registro.
Fichas Proceso e Instancia: Cada proceso y cada instancia de un proceso que se abre aparece en su
propia ficha. Las fichas Procesar instancia aparecen una junto a otra en su ficha de diseño de proceso de
origen. Las fichas Proceso muestran un icono. Las fichas Procesar instancia no muestran un icono. CA
Process Automation asigna un número de ID de proceso único a cada nombre de instancia para que se
puedan identificar las diferentes instancias. Se pueden copiar y pegar objetos entre fichas.
Barra de estado de instancias de proceso: esta barra muestra el estado de la instancia. Si resulta
pertinente, la duración del estado también aparecerá. Por ejemplo, las instancias En espera también
mostrarán un reloj indicando cuánto tiempo la instancia ha estado en este estado. También se puede
utilizar el control de jerarquía para centrarse en subprocesos específicos.
Instancia del proceso: el diseño de la instancia del proceso aparece en esta zona de trabajo, lienzo o
diseño. La instancia de proceso incluye la cuadrícula, carriles, todos los operadores, puertos y líneas de
conexión. Utilícela para encontrar la ruta de su proceso mientras se ejecuta.
Paleta de registros: use esta paleta para verificar o solucionar los problemas de instancias de proceso.
Operaciones
La página de Operaciones muestra un cuadro de mandos con los siguientes elementos
clave:
■
Vínculos a operadores, procesos y otros objetos
■
Paquetes de contenidos
■
Observación de procesos
■
Formularios de solicitud de inicio
■
Conjuntos de datos
■
Recursos
Capítulo 2: Guía de procedimientos iniciales 49
Interfaz de usuario de CA Process Automation
La página Operaciones le ayuda a gestionar procesos que están en ejecución o procesos
completados. Se pueden iniciar procesos a petición e interactuar con procesos en
ejecución mediante los formularios interactivos. La página Operaciones es un cuadro de
mandos de automatización que responde a los siguientes tipos de preguntas:
■
¿Qué está ejecutándose en mi entorno?
■
¿Qué ha estado ejecutándose en mi entorno?
■
¿Qué procesos están disponibles para iniciarse a petición?
■
¿Qué procesos están a la espera de una entrada de usuario o de aprobación?
Element Descripción:
o:
Ficha Operaciones: haga clic en esta ficha para ver la página Operaciones.
Barra de herramientas de Operaciones: con estos comandos se puede trabajar con elementos en las
diversas listas de la página Operaciones.
50 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Element Descripción:
o:
Panel de Operaciones: se puede seleccionar una entrada en la lista expandible en este panel. Por
ejemplo:
■
Por ejemplo, haga clic en Instancias del proceso para ver un gráfico y una lista de las instancias.
■
Haga clic en paquetes de contenidos para ver una lista de los paquetes de contenidos que se han
importado y los objetos que contienen.
■
Haga clic en un Formulario de solicitud de inicio para iniciarla.
■
Introduzca un filtro opcional para buscar un objeto de recurso.
En la ilustración, el usuario ha introducido Mi recurso para encontrar entradas coincidentes
organizadas en carpetas en la sección Recursos del panel.
Gráfica o área de gráfico: el producto muestra como una gráfica o un gráfico los datos de las instancias
del proceso, las observaciones del proceso y las instancias del proceso que están en paquetes de
contenidos. En la ilustración, el usuario está señalando las barras Instancias completadas para ver la
cantidad total (11). Haga clic en una barra en el gráfico para agregar el valor del estado asociado al
filtro para que los resultados aparezcan debajo en una lista. Haga clic otra vez en la barra para eliminar
el valor del filtro.
Lista o página principal: el área principal de la página Operaciones muestra información esencial.
Además del gráfico, el producto suele presentar estos datos en una tabla, una lista o un formulario.
Por ejemplo, se puede ver, filtrar y ordenar una lista de instancias por su estado. Haga clic en un objeto
de recurso para ver el estado actual de los recursos que representa.
Capítulo 2: Guía de procedimientos iniciales 51
Interfaz de usuario de CA Process Automation
Configuración
La paleta Explorador de configuración muestra la jerarquía lógica del dominio. Los
administradores utilizan la ficha Configuración para instalar y configurar varios agentes y
orquestadores. Los diseñadores de contenido tienen acceso de sólo lectura a la paleta
Explorador de configuración en la ficha Configuración.
Element Descripción:
o:
Ficha Configuración: solamente los administradores pueden utilizar esta
ficha para actualizar los valores de configuración.
Barra de herramientas Configuración: solamente los administradores pueden bloquear objetos en el
Explorador de configuración, guardar cambios de configuración y desbloquear los objetos.
Jerarquía de dominio del Explorador de configuración: solamente los administradores pueden
configurar el producto.
Panel principal del Explorador de configuración: el panel principal muestra los datos de configuración.
Instalación y Gestionar recursos de usuario: solamente los administradores pueden ver estas paletas.
Las paletas Instalación y Gestionar recursos de usuario no aparecen cuando los diseñadores de
contenido seleccionan la ficha Configuración.
52 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Informes
Use esta página para realizar tareas de generación de informes. Por ejemplo:
■
Generación de un informe existente
■
Carga de un nuevo informe
■
Establecimiento de parámetros personalizados
■
Exportación de datos de informes
Element Descripción:
o:
Ficha Informes: haga clic en la ficha Informes para ver o crear informes.
Barra de herramientas de informes: utilice esta barra de herramientas para trabajar con la página de
informes. También hay una barra de herramientas estándar independiente disponible para trabajar
con los resultados de los informes.
Área Agregar informe nuevo: esta área, que aparece al hacer clic en Nuevo en la barra de
herramientas, permite especificar los detalles del informe y guardarlo.
Lista de informes: muestra una lista de los informes que están disponibles.
Capítulo 2: Guía de procedimientos iniciales 53
Interfaz de usuario de CA Process Automation
Element Descripción:
o:
Cuadro de diálogo Parámetro: al hacer clic en un informe de la lista (excepto el Informe de objetos de
referencia), aparece este cuadro de diálogo. Utilícelo para definir el intervalo de datos que se debe
incluir en la instancia seleccionada del informe. En este ejemplo, el usuario ha seleccionado todos los
estados en el campo Estado del proceso {}.
Resultado del informe: al hacer clic en Aceptar, aparece una vista previa en pantalla del resultado del
cuadro de diálogo Parámetro. Estos resultados se puede utilizar tal cual, imprimir en otro dispositivo o
exportarlos para su uso en otra aplicación.
Nota: Para diseñar informes nuevos, instale el diseñador BIRT en un servidor de
aplicaciones independiente y conéctelo a la base de datos de informes.
54 Guía del diseñador de contenido
Interfaz de usuario de CA Process Automation
Controles de interfaz de usuario comunes
La interfaz Web de CA Process Automation ofrece un conjunto coherente de controles.
Las tablas, las listas, las páginas, los comandos y los filtros funcionan de la misma
manera estándar en todas las páginas.
Nota: Algunas funciones no están disponibles en todas las páginas.
Elem Descripción:
ento:
Capítulo 2: Guía de procedimientos iniciales 55
Interfaz de usuario de CA Process Automation
Elem Descripción:
ento:
Comandos: como acceso directo, se puede hacer clic con el botón secundario del ratón
en un elemento de la lista para seleccionar los mismos comandos que están
disponibles en una barra de herramientas. En este ejemplo, se puede hacer clic en
Propiedades en la barra de herramientas o hacer clic con el botón secundario del
ratón en una fila de tarea en la tabla y elegir Propiedades en el menú de acceso
directo resultante.
Paginación: cuando CA Process Automation presenta tablas de datos, se puede
controlar cuánto cabe en una página. Las tablas superiores e inferiores de este
ejemplo ambas muestran 170 elementos. En la página superior, el usuario ha
seleccionado 200 filas en cada página. Esto condensa los 170 elementos a una sola
página. Para la página inferior, el usuario ha decidido ver 10 filas. Este valor aumenta
el número de páginas necesarias para mostrar los 170 elementos a 17 páginas.
Utilice los controles situados en la parte inferior de la ventana para ir a la primera o
última página en pantalla, o a la anterior o siguiente. También puede ir directamente a
una página específica introduciendo el número de página en el campo Página.
Multiselección: compruebe una o varias filas para aplicar el mismo comando a
elementos similares. La aplicación solamente permitirá ejecutar comandos válidos
para varios elementos al mismo tiempo.
Filtros: introduzca una palabra o cadena de texto opcional y pulse la tecla Intro para
ver solamente los elementos coincidentes. Por ejemplo, escriba net y solamente
aparecerán los objetos netstat y netstatw en la lista. Haga clic en la X para borrar el
filtro.
Orden de clasificación: haga clic en una fila de campo de encabezado de columna
para seleccionar Ordenar ascendente u Ordenar descendente. Como acceso directo,
haga clic en el encabezado de la columna para cambiar el orden de clasificación. Un
triángulo pequeño indica la dirección del orden de clasificación: ascendente (flecha
hacia abajo), descendente (flecha hacia arriba) o sin clasificar (ningún triángulo).
Disposición de las columnas: haga clic y arrastre una columna entera para cambiar la
secuencia de columnas en una tabla. En este ejemplo, el usuario ha decidido colocar la
columna Tipo entre Nombre y Estado.
Tamaño de columna: coloque su ratón sobre el límite que divide dos columnas.
Cuando el cursor cambie al cursor de cambio de tamaño, arrastre el borde de la
columna hacia la izquierda o la derecha para ajustar la anchura de la columna y sus
datos.
Mostrar u ocultar columnas: se pueden mostrar (seleccionado) u ocultar (no
seleccionado) los campos indicados para controlar las columnas que aparecen en una
tabla.
Filtros rápidos: si está disponible, se puede aplicar un filtro rápido a una columna.
Compruebe los valores de campo que se desean incluir y borre los valores que se
desean excluir.
56 Guía del diseñador de contenido
Exploración del contenido original
Elem Descripción:
ento:
Filtros de hora y fecha: para los campos de hora y fecha en una tabla, se puede definir
un filtro como un intervalo o período de tiempo. El filtro excluye los datos que no se
encuentran en el intervalo. En este ejemplo, el usuario solamente desea incluir las filas
con valores de Hora final de 30 de noviembre de 2012 a las 10:00 a 30 de noviembre
de 2013 a las 23:59.
Exploración del contenido original
El vínculo de contenido original de la página Principal dirige al diseñador de contenido al
contenido de muestra. El contenido de muestra ilustra lo que se puede hacer con
diversos objetos de automatización.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Principal y, a continuación, haga clic en Exploración del
contenido original.
La ficha Biblioteca se abre con la carpeta PAM_PreDefinedContent seleccionada en
el panel de navegación.
2.
Expanda la carpeta que titulada PAM_PreDefined Content.
3.
Expanda la subcarpeta que representa el operador, el objeto o el proceso de diseño
que le interese.
4.
En el panel principal, haga doble clic en un objeto donde Tipo sea Proceso.
El proceso se abre en la ficha Diseñador. El proceso incluye anotaciones que
describen la finalidad del proceso, otra información relevante e indicaciones para
personalizar el proceso.
5.
Utilice el proceso de muestra seleccionado como herramienta de aprendizaje o
como modelo para un proceso propio.
Capítulo 2: Guía de procedimientos iniciales 57
Uso de CA EEM para cambiar la contraseña de CA Process Automation
Uso de CA EEM para cambiar la contraseña de CA Process
Automation
El administrador normalmente asigna una contraseña temporal cuando configura
cuentas de usuario para el almacén de usuarios interno. Todos los usuarios de CA
Process Automation con cuentas de usuario creadas en CA EEM pueden cambiar esta
contraseña antes de iniciar sesión en CA Process Automation. A continuación, se puede
cambiar la contraseña de CA Process Automation en el intervalo que definen las
políticas de contraseñas.
Nota: Esta capacidad no se aplica cuando CA EEM hace referencia a cuentas de usuario
de un almacén de usuarios externo, como Microsoft Active Directory. En este caso, debe
mantenerse la contraseña en el directorio al que se hace referencia.
Utilice CA EEM para cambiar la contraseña de CA Process Automation.
Lleve a cabo los pasos siguientes:
1.
Abra un explorador e introduzca la dirección URL del servidor de CA EEM que utiliza
CA Process Automation. Por ejemplo:
https://hostname_or_IPaddress:5250/spin/eiam/
Para identificar el nombre de host o dirección IP de CA EEM que utiliza CA Process
Automation, consulte el campo Servidor backend de CA EEM en la subficha
Seguridad de la ficha Configuración de CA Process Automation.
2.
Inicie sesión en CA Embedded Entitlements Manager (CA EEM) en el cuadro de
diálogo Iniciar sesión:
a.
Para Aplicación, seleccione <Global>.
b. Suprima EiamAdmin si este nombre predeterminado aparece en el campo
Nombre de usuario.
c.
Introduzca el nombre de usuario y la contraseña de CA Process Automation.
d. Haga clic en Iniciar sesión.
3.
En Autoadministración, haga clic en Cambio de contraseña.
4.
Restablezca la contraseña:
a.
Introduzca su nombre de usuario y contraseña antigua de CA Process
Automation.
b. Introduzca la nueva contraseña en los campos Nueva contraseña y Confirmar
contraseña.
c.
Haga clic en Aceptar.
CA Process Automation acepta las credenciales actualizadas cuando se inicie sesión.
58 Guía del diseñador de contenido
Exploradores Web
Exploradores Web
Incluso entre los exploradores Webs compatibles, CA Process Automation puede
comportarse de forma diferente debido a diferencias en productos de terceros. Por
ejemplo, cuando se intenta abandonar una página o ficha con cambios sin guardar, cada
uno de los siguientes exploradores compatibles puede mostrar un mensaje ligeramente
diferente:
■
Microsoft Internet Explorer
■
Google Chrome
■
Mozilla Firefox
Esencialmente, los tres le dan la opción de permanecer en la página para guardar los
datos o abandonar la página y descartar los cambios.
Microsoft Internet Explorer
Cuando se configura Microsoft Internet Explorer 8 o 9 en modo de compatibilidad, CA
Process Automation puede mostrar un rendimiento o comportamiento limitado. Por
ejemplo, los menús desplegables de las columnas de campo en la página Operaciones
podrían desaparecer si se hace clic en Iniciar solicitudes (o otra opción del panel
Operaciones) y, a continuación, se vuelve a Vínculos y se elige Instancias del proceso. En
este estado, el botón del menú desplegable del encabezado de la columna podría no
aparezca en otras vistas. Esto puede dar lugar a la incapacidad de establecer un filtro.
Se recomienda no activar explícitamente el modo de compatibilidad ni la configuración
de Intranet. Si se observa un comportamiento raro al utilizar Internet Explorer, asegure
que el modo de compatibilidad no esté activado.
Nota: Si se debe activar la configuración de Intranet, desactive manualmente Mostrar
sitios de la intranet en Vista de compatibilidad en Configuración de Vista de
compatibilidad en el menú Herramientas de Internet Explorer.
Capítulo 2: Guía de procedimientos iniciales 59
Capítulo 3: Explorador de bibliotecas
Esta sección contiene los siguientes temas:
Personalización del Explorador de bibliotecas (en la página 61)
Búsqueda en el Explorador de bibliotecas. (en la página 61)
Cómo trabajar con objetos y carpetas (en la página 66)
Personalización del Explorador de bibliotecas
Puede personalizar su vista de las columnas en el explorador de bibliotecas. Las
columnas muestran valores de campo para entradas en una tabla.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de carpetas del explorador de bibliotecas, seleccione una carpeta.
3.
En la ventana principal, para mostrar u ocultar una columna, haga clic en
encabezado de la columna y elija Columnas.
en el
Aparecerá una lista de comprobación de los nombres de campo disponibles.
4.
Borre las columnas de campo que desee ocultar. Compruebe las columnas de
campo que desee mostrar.
5.
Para ordenar la lista, haga clic en en un encabezado de columna y elija Orden
ascendente u Orden descendente.
6.
Para organizar la secuencia de columnas, haga clic en un encabezado de columna y
arrástrelo a la izquierda o la derecha.
Búsqueda en el Explorador de bibliotecas.
Se pueden utilizar las funciones de búsqueda para encontrar elementos específicos en el
Explorador de bibliotecas. Se pueden ejecutar acciones en varios objetos relacionados
en los resultados de la búsqueda.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de carpetas del explorador de bibliotecas, seleccione la carpeta raíz o
una subcarpeta específica.
El producto limita la búsqueda a los objetos y carpetas en la carpeta seleccionada.
Capítulo 3: Explorador de bibliotecas 61
Búsqueda en el Explorador de bibliotecas.
3.
En el campo de búsqueda, introduzca el nombre de un operador o carpeta.
4.
(Opcional) Haga clic en Búsqueda avanzada para definir una búsqueda basada en
cualquiera de las propiedades siguientes:
5.
■
Nombre
■
Propietario
■
Tipo
■
Estado de incorporación
■
Fecha de creación
■
Fecha de modificación
■
Etiquetas
Haga clic en Buscar.
Aparecerán los resultados de la búsqueda.
Nota: Si está buscando en una jerarquía de la carpeta con un paquete de
contenidos, el producto devuelve solamente los objetos de la versión de
publicación actual del paquete de contenidos. El producto también devuelve
objetos que residen en la jerarquía de la carpeta, pero que no se encuentran en el
paquete de contenidos.
6.
7.
En los resultados de búsqueda se puede trabajar con objetos y carpetas al igual que
se puede hacer en cualquier otra carpeta de la biblioteca.
■
Para abrir un elemento para editarlo, haga doble clic en él.
■
Para que se muestre un menú de acceso directo con los comandos disponibles,
haga clic con el botón secundario del ratón en un único elemento.
■
Para aplicar una acción a varios objetos a la vez, seleccione los elementos y
haga clic con el botón secundario del ratón en un elemento seleccionado.
Para iniciar una nueva búsqueda, realice una de estas acciones:
■
Haga clic en Restablecer.
■
Haga clic en Búsqueda simple o Búsqueda avanzada.
■
Borre o modifique los criterios especificados en los campos de búsqueda.
■
Haga clic en la x del cuadro Búsqueda simple.
62 Guía del diseñador de contenido
Búsqueda en el Explorador de bibliotecas.
Búsqueda de la información de la versión de publicación
Se puede asociar opcionalmente cada versión de objeto con una versión de publicación.
La ficha Versiones permite filtrar las asociaciones mostradas para mostrar los objetos y
las versiones que se asocian con la cadena especificada. Se puede buscar una versión de
publicación específica para mostrar la versión que se necesite. Además, se puede buscar
una cadena genérica que devuelva varias versiones de un objeto. La ficha Versiones
permite realizar búsquedas con comodines, tanto si se especifica un carácter comodín
(*) como si no, tal y como se muestra en el ejemplo siguiente:
Cadena de búsqueda
Resultados de la búsqueda
5
Cualquier versión de objeto en la que los campos Versión o Versión de
publicación contengan el carácter 5.
*5
5*
*5*
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón secundario del ratón en el objeto y seleccione Editar.
3.
En el editor de objetos, haga clic en la ficha Versiones.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos y ejemplos.
4.
En la barra de herramientas de Versión, haga clic en el icono de lupa en el extremo
más a la derecha.
5.
Especifique los criterios de búsqueda pertinentes en el campo de búsqueda y haga
clic en Buscar.
La búsqueda devuelve los objetos y las versiones que se asocian con la cadena
especificada.
Capítulo 3: Explorador de bibliotecas 63
Búsqueda en el Explorador de bibliotecas.
Búsqueda de la información de versión
La ficha Versión permite filtrar las versiones mostradas para objetos que contienen la
cadena especificada.
■
Para criterios de búsqueda distintos de las fechas, los resultados de la búsqueda
incluyen filas para las versiones de objeto que contienen la cadena especificada en
alguno de los campos siguientes:
–
Versión
–
Modificado por
–
Creado por
Nota: Por ejemplo, para mostrar los objetos que contienen 5, especifique 5, *5, 5*
o *5* como criterio de búsqueda.
■
Para criterios de búsqueda de fecha, los resultados de la búsqueda incluyen filas
para las versiones de objeto que tienen la fecha que se ha introducido en cualquiera
de los campos siguientes:
–
Creado el
–
Fecha de la última modificación
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón secundario del ratón en el objeto y seleccione Editar.
Aparece el editor de objetos.
3.
Haga clic en la ficha Versiones.
4.
Haga clic en el icono de lupa en el lado derecho de la barra de herramientas
Versión.
Aparecen el campo de búsqueda y el botón Buscar.
5.
Especifique los criterios de búsqueda pertinentes en el campo de búsqueda y haga
clic en Buscar.
El proceso de búsqueda muestra objetos que cumplen los criterios de búsqueda
especificados. Los criterios de búsqueda distintos de las fechas devuelven todas las
versiones que contienen la cadena especificada en los campos Versión, Modificado
por y Creado por. Los criterios de búsqueda de fecha devuelven todas las versiones
que coincidan exactamente con los campos Creado en y Fecha de la última
modificación.
64 Guía del diseñador de contenido
Búsqueda en el Explorador de bibliotecas.
Búsqueda de la información de pista de auditoría
La ficha Pista de auditoría permite mostrar solamente versiones de objeto que cumplan
uno de los siguientes criterios de búsqueda (o los dos):
■
El campo Versión o el campo Nombre de usuario contienen la cadena especificada
en el campo Filtro.
Por ejemplo, si se especifica 5 en el campo Filtro, la búsqueda devolverá cualquier
objeto de Pista de auditoría que tenga el número 5 en el campo Versión o en el
campo Nombre de usuario.
■
El campo Última actualización contiene una fecha incluida dentro del intervalo de
fechas especificado en los campos Desde y Hasta.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón secundario del ratón en el objeto y seleccione Editar.
Aparece el editor de objetos.
3.
Haga clic en la ficha Pista de auditoría.
4.
Haga clic en el icono de lupa en el lado derecho de la barra de herramientas Pista de
auditoría.
Aparecen los campos de búsqueda y el botón Buscar.
5.
Especifique los criterios de búsqueda el campo Filtro, en Desde y Hasta o en ambos.
A continuación, haga clic en Buscar.
Filtro
Especifica los criterios de búsqueda numéricos o alfanuméricos para los
campos siguientes, donde los resultados de la búsqueda pueden incluir
cualquier versión de objeto que contenga la cadena especificada.
■
Versión
■
Nombre de usuario
Desde - Hasta
Especifica criterios de intervalo de fechas para buscar los datos más
actualizados.
El proceso de búsqueda muestra objetos que cumplen los criterios de búsqueda
especificados.
Capítulo 3: Explorador de bibliotecas 65
Cómo trabajar con objetos y carpetas
Cómo trabajar con objetos y carpetas
Las carpetas son contenedores para objetos.
Utilice este proceso para editar un objeto:
1.
Identifique la ubicación de un objeto o de una carpeta en el explorador de
bibliotecas.
2.
Abra el objeto.
3.
Extraiga el objeto a una versión de trabajo que pueda editarse.
4.
Edite el objeto.
5.
Guarde los cambios realizados.
6.
Incorpore el objeto (en este paso también se decide si deben aplicarse cambios a la
misma versión o a una nueva).
Cuando sólo se desea inspeccionar un objeto, se puede hacer clic en Propiedades o
abrirlo. A continuación, se pueden ver las propiedades en detalle y decidir si desea
editarlas.
Los objetos se abren en un editor o diseñador que está basado en el tipo de objeto. Por
ejemplo, un proceso se abre en el Diseñador de procesos y aparece un objeto del
conjunto de datos en un cuadro de diálogo Conjunto de datos. Cada editor tiene sus
propias fichas, paletas y botones de la barra de herramientas.
Nota: Esta sección sólo incluye información básica sobre la apertura y la edición de
objetos, además de la gestión de versiones. Otras secciones describen con mayor detalle
cómo editar diversos tipos de objetos.
66 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Tipos de objetos de automatización
Los objetos de automatización son componentes de la aplicación que definen los
elementos configurables de un paquete de CA Process Automation. Estos objetos
definen las operaciones del sistema e incluyen software ejecutable. Cree y configure
objetos de automatización de CA Process Automation en el Explorador de bibliotecas,
en carpetas de biblioteca de automatización específicas asociadas a un orquestador
específico.
Se pueden realizar las acciones siguientes en una biblioteca de automatización:
■
Desplácese por la biblioteca de automatización asociada con un orquestador.
■
Los objetos de una biblioteca de automatización se pueden crear, editar y ver.
■
Se pueden crear carpetas en una biblioteca para agrupar objetos relacionados. Las
carpetas permiten definir una estructura jerárquica para que el usuario y sus
compañeros de trabajo puedan encontrar los objetos. Esta estructura es similar a
las carpetas o los directorios del sistema operativo del equipo.
En el explorador de bibliotecas se pueden crear los siguientes tipos de objeto:
Proceso
Un objeto de proceso describe gráficamente el orden de los operadores y las
dependencias entre estos y otros procesos. Los procesos representan operadores
gráficamente con vínculos que muestran la secuencia y la lógica que hay detrás de
los pasos que realizar el proceso.
Planificación
Un objeto de planificación aplica condiciones de fecha y hora cuando se ejecutan
los módulos (incluidos los procesos). Para agrupar tareas por aplicación, propiedad
u otros criterios, utilice varias planificaciones.
Calendario
Un objeto de calendario define reglas que describen condiciones de fecha
complejas. Un objeto de calendario especifica gráficamente fechas, intervalos de
hora y elementos condicionales que determinan cuándo y con qué frecuencia el
producto realiza operaciones.
Icono personalizado
Los objetos de icono personalizado especifican imágenes gráficas que sirven de
identificación exclusiva para los operadores.
Operador personalizado
Los objetos de operador personalizado permiten ampliar la presentación y la
configuración de los operadores existentes. Se pueden personalizar operadores
propios conforme a operadores existentes y optimizarlos con parámetros
específicos diseñados reutilizarlos en diversos procesos.
Capítulo 3: Explorador de bibliotecas 67
Cómo trabajar con objetos y carpetas
Conjunto de datos
Un objeto de conjunto de datos define y agrupa variables que el producto utiliza
como parámetros que requieren otros procesos, operadores y recursos. Los
ejemplos incluyen ubicaciones de aplicación, contraseñas y nombres de perfil. Se
pueden configurar fácilmente estas variables para que el producto pueda actualizar
procesos de actualización y planificación de forma eficaz con el fin de reflejar
cambios en un entorno de aplicación.
Paquete
Empezando en CA Process Automation 04.2.00, el objeto de paquete ya no puede
agrupar accesos directos a otros objetos de automatización. Los paquetes no están
disponibles para referencia mediante ninguno de los exploradores de objetos de CA
Process Automation. Para exportar e importar contenido que no se puede modificar
de un entorno a otro en la versión 04.2.00, hay que utilizar un paquete de
contenidos.
Paquete de contenidos
El objeto de automatización paquete de contenidos agrupa los objetos de CA
Process Automation que un diseñador de contenido ha exportado como un paquete
de contenidos. El diseñador de contenido agrega los objetos de automatización a
una carpeta y exporta la carpeta como paquete de contenidos. El usuario de
producción puede ver los paquetes de contenidos importados en la Biblioteca o en
la ficha Operaciones.
Observación de procesos
El objeto de observación de procesos permite a los usuarios definir y monitorizar
determinadas aplicaciones en el entorno de producción. Un objeto Observación de
procesos es una recolección de accesos directos a otros elementos de la biblioteca
de automatización. Un usuario puede abrir un objeto de observación de procesos
para consultar el estado de instancias de proceso y otros objetos. El objeto de
observación de procesos permite a los usuarios monitorizar los operadores sin
permitirles necesariamente el acceso a objetos o datos subyacentes.
Recurso
Un objeto Recurso es un modelo que representa elementos de la arquitectura del
sistema. Utilícelos para sincronizar procesos independientes que dependan de
elementos de infraestructura comunes, así como para cuantificar y controlar el
acceso a las entidades informáticas específicas. Incluya varios recursos que
representen entidades relacionadas en un solo objeto Recurso.
68 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Formulario de solicitud de inicio
El objeto de formulario de solicitud de inicio define accesos directos para que un
usuario de producción pueda iniciar procesos manualmente. Un cuadro de diálogo
personalizado solicita a los usuarios los valores de los parámetros necesarios para
iniciar los procesos asociados.
Formulario de solicitud de interacción
El objeto de formulario de solicitud de interacción solicita a los usuarios que
proporcionen respuestas en campos de datos y otros controles de la interfaz de
usuario. Los usuarios introducen la información obligatoria para continuar un
proceso. Por ejemplo, se puede utilizar un formulario de solicitud de interacción
para pedir a un interesado que revise cada paso de un proceso de aprobación.
Creación de una carpeta
Las jerarquías de carpeta permiten categorizar y organizar objetos relacionados.
Además, permiten aplicar repetidamente permisos seleccionados a objetos y carpetas
subordinados. Para organizar y proteger los grupos de objetos, se pueden agregar
carpetas para estructurar la jerarquía de la biblioteca.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de la carpeta Explorador de bibliotecas, seleccione la carpeta donde se
desee crear una carpeta nueva.
3.
En la barra de herramientas, haga clic en Nuevo y, a continuación, elija Carpeta.
Aparece la nueva carpeta.
4.
Cambie el nombre de la carpeta.
Nota: Para establecer derechos y realizar otras tareas de objeto, la práctica
recomendable es organizar los objetos en carpetas. No cree objetos de en el nivel de
raíz, ya que no se pueden gestionar como un grupo.
Capítulo 3: Explorador de bibliotecas 69
Cómo trabajar con objetos y carpetas
Creación de un objeto
Cree nuevos objetos de automatización en carpetas específicas en la biblioteca que esté
asociada a un orquestador. Después de crear un objeto, podrá editar sus propiedades.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de la carpeta Explorador de bibliotecas, seleccione una carpeta donde
almacenar el nuevo objeto.
3.
En la barra de herramientas, haga clic en Nuevo y seleccione un tipo de objeto.
Se crea un nuevo objeto.
4.
Introduzca un nombre único para el objeto.
La aplicación avisa cuando el nombre especificado ya está asociado a otro objeto de
la carpeta.
Nota: Para establecer derechos y realizar otras tareas de objeto, la práctica
recomendable es organizar los objetos en carpetas. No cree objetos de en el nivel de
raíz, ya que no se pueden gestionar como un grupo.
Nota: El objeto de paquete ya no se admite en CA Process Automation 4.2.00. Un
diseñador de contenido puede ahora agrupar los objetos de automatización en una
carpeta y exportar objetos como un paquete de contenidos para implementarlo en un
entorno de producción. El uso del objeto del paquete existente se mantiene para
ofrecer compatibilidad con versiones anteriores. Consulte Cómo migrar objetos de un
paquete a una carpeta nueva para preparar una exportación.
70 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Edición de un objeto
Después de crear un objeto, se puede modificar su configuración en cualquier
momento. Por ejemplo, puede:
■
Editar las etiquetas de un objeto
■
Agregar un recurso a un objeto Recurso
■
Eliminar un objeto de una observación de procesos
CA Process Automation almacena varias versiones de un objeto. De forma
predeterminada, cuando se extrae y se edita un objeto, la aplicación utiliza la versión
actual designada. Una vez editado, incorpore el objeto. Al incorporarlo, se puede
especificar si se deben aplicar los cambios a la misma versión o una nueva versión del
objeto. En cualquiera de los dos casos, la aplicación aplica los cambios de forma
predeterminada.
Cada objeto puede tener una versión de publicación (en la página 466) asociada. La
versión de publicación identifica la versión específica de un objeto que debe
implementarse en un entorno de producción. CA Process Automation requiere que el
objeto se proporcione al entorno de producción en un objeto Paquete de contenidos
(en la página 475). Se puede establecer un indicador que impida que se modifique la
versión de publicación. A continuación, CA Process Automation configura el objeto
como línea de referencia al importarlo al entorno de producción. Cuando se establece
una versión de publicación de un objeto, la versión interna del objeto se asocia con la
del número de versión.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de carpetas del explorador de bibliotecas, haga clic en una carpeta.
3.
Haga doble clic en un objeto.
La versión actual del objeto se abre para editarse.
4.
Si el objeto todavía no se ha extraído, haga clic en Extraer.
5.
Editar el objeto
6.
Haga clic en Guardar o en Guardar y cerrar.
La aplicación guarda los cambios. Puesto que el objeto aún está extraído, puede
continuar editándolo.
7.
Haga clic en Incorporar.
8.
Realice los siguientes pasos en el cuadro de diálogo Incorporar:
a.
En el campo Incorporar como, elija Nueva versión o Misma versión.
b. (Opcional) Introduzca los comentarios que desee sobre los cambios realizados
en esta versión.
Capítulo 3: Explorador de bibliotecas 71
Cómo trabajar con objetos y carpetas
c.
(Opcional) Seleccione la casilla de verificación Línea de referencia para utilizar
esta versión como línea de referencia.
d. (Opcional) Anule la selección de la casilla de verificación Actual si desea una
nueva versión pero no quiere que se marque como actual. La versión anterior a
la actual continuará siendo actual.
e.
Haga clic en Incorporar.
Visualización y cambio de las propiedades generales de un objeto
Se pueden ver las propiedades generales de cualquier proceso u objeto Biblioteca.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta, haga clic con el botón secundario del ratón en un objeto y,
a continuación, seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha General.
4.
Consulte las propiedades de objeto de solo lectura.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos.
5.
(Opcional) Este campo se puede editar para un objeto extraído o incorporado. Haga
clic en Guardar para almacenar sus cambios.
Especifique etiquetas o palabras clave para objetos
La ficha Etiquetas permite asignar palabras clave que organicen objetos según algún
sistema de denominación significativo reconocido por la organización. Cualquier usuario
puede realizar una búsqueda avanzada de objetos o carpetas mediante etiquetas o
palabras clave.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta, haga clic con el botón secundario del ratón en un objeto y,
a continuación, seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha Etiquetas.
4.
En la ficha Etiquetas:
a.
Haga clic en Editar.
b. Introduzca uno o varios valores de texto separados por comas sin espacios
entre los elementos de la lista. Por ejemplo:
prueba,seguridad,beta de código de proyecto
c.
72 Guía del diseñador de contenido
Haga clic en Guardar.
Cómo trabajar con objetos y carpetas
Cambiar Propiedad para objetos de automatización
El usuario que crea una carpeta o un objeto de automatización es, de forma
predeterminada, el propietario de esta. El propietario tiene pleno control sobre una
carpeta o un objeto de automatización. Un propietario puede cambiar la propiedad a
otro usuario de CA Process Automation.
Nota: El permiso de CA EEM Environment_Content_Administrator otorga el control
total de todas las carpetas y los objetos de automatización. Todos los administradores
que pertenecen al grupo de PAMAdmins tienen este permiso.
Si se activa Seguridad de tiempo de ejecución, solo podrá iniciar el proceso su
propietario (o administrador).
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione uno o varios objetos incluyendo carpetas.
3.
Haga clic en el botón de la barra de herramientas Establecer propietario.
4.
En la lista Usuarios disponibles, seleccione la cuenta de usuario que se va a
establecer como nuevo propietario. Utilice la función de búsqueda para encontrar
cuentas de usuario coincidentes.
5.
Haga clic en Guardar y cerrar.
Especificación de políticas de archivado
Después de que un proceso automatizado se haya ejecutado y completado
correctamente, el producto archiva los datos en tiempo de ejecución para tenerlos
como referencia y realizar métrica. De forma predeterminada, el objeto hereda las
propiedades de la política de archivado del orquestador. Sin embargo, se puede definir
manualmente el número de días que el servidor conserva las instancias del proceso
completadas o erróneas o los objetos de planificación. Se puede definir también el
número de instancias del proceso completadas y erróneas que el producto conserva.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta y luego seleccione un objeto de proceso o de planificación.
3.
Haga clic con el botón secundario del ratón en el objeto y seleccione Propiedades.
4.
En el panel Propiedades, haga clic en la ficha Política de archivado.
5.
Borre la casilla de verificación Heredar política de archivado del orquestador. Esta
tarea activa los otros campos.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos y ejemplos.
Capítulo 3: Explorador de bibliotecas 73
Cómo trabajar con objetos y carpetas
6.
Introduzca un valor para el historial de procesos.
Este valor define el intervalo (en días) que el producto conserva las instancias del
proceso completadas y erróneas en el archivo de archivado antes de borrar de
forma definitiva automáticamente los registros. El producto mantiene el historial
del proceso para este intervalo, independientemente del número de instancias en
el archivo de archivado.
7.
Introduzca los valores para las instancias erróneas y finalizadas.
Estos valores definen el número de instancias del proceso que el producto conserva
antes de borrar de forma definitiva automáticamente los registros con los estados
siguientes:
–
Solo estado Erróneo
–
Estado Finalizado
De las instancias que superen el límite de retención especificado, el producto
suprime primero la más antigua.
8.
Haga clic en Guardar.
Especificación de la versión de la carpeta
Un diseñador de contenido puede proporcionar información de la versión para una
carpeta. La ficha Versión de las propiedades de carpeta indica la versión de publicación
de la carpeta. Hay que especificar la versión de publicación de una carpeta para
exportar la carpeta como un paquete de contenidos. La información de adición que
describe el contenido de la carpeta puede ayudar al consumidor de paquete de
contenidos cuando el contenido se importa a un entorno nuevo.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón secundario del ratón en la carpeta del panel derecho de la
Biblioteca y, a continuación, seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha Publicación para ver las propiedades
de la carpeta.
4.
Haga clic en el campo Valor del atributo ReleaseVersion.
5.
En la ventana Valor, introduzca la carpeta Versión de publicación y, a continuación,
haga clic en Aceptar.
Nota: No se puede suprimir ni editar el atributo ReleaseVersion, pero se puede
insertar la versión de publicación adecuada en la columna Valor.
74 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
6.
Haga clic en Guardar.
7.
Haga Clic en Agregar propiedad o Suprimir propiedad para definir o eliminar más
propiedades de carpeta.
Por ejemplo, se puede agregar la información siguiente en la ficha Publicación:
■
Propietario que ha creado el paquete de contenidos.
■
Usuarios que pueden utilizar los objetos de paquete de contenidos después de
que haberlos importado a un entorno nuevo.
■
Información de soporte.
■
Ayuda en línea (dirección URL a la ayuda en línea).
Especificación de propiedades de ROI
Cuando se definen las propiedades del retorno de la inversión (ROI) de un objeto del
proceso, los valores que se introducen aparecen en el conjunto de datos de las
instancias del proceso.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta, haga clic con el botón secundario del ratón en un objeto del
proceso y, a continuación, seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha Retorno de inversión (ROI).
4.
Marque la casilla de verificación Activar ROI.
5.
Cambie los siguientes valores:
■
En el campo Tiempo de trabajo manual, introduzca el tiempo total (en horas y
minutos) que necesita el personal para disparar varias operaciones de procesos
manualmente.
■
En el campo Tiempo transcurrido del proceso manual, introduzca el tiempo
total (en horas y minutos) que necesita el personal para ejecutar todo el
proceso de forma manual.
■
En la lista desplegable de Importancia, seleccione la importancia del proceso
que aparece en el informe de ROI (alta, media o baja).
■
(Opcional) En el campo Nombre del grupo de aplicaciones/sistema, introduzca
el nombre de grupo común a mediante el cual el producto agrega procesos en
el informe de ROI.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos y ejemplos.
6.
Haga clic en Guardar.
Capítulo 3: Explorador de bibliotecas 75
Cómo trabajar con objetos y carpetas
Cuándo seleccionar Ejecutar como propietario
CA Process Automation proporciona un control de acceso más preciso en operaciones
de automatización específicas como procesos, conjuntos de datos, calendarios y
planificaciones. El control de acceso no solo incluye los tradicionales derechos de lectura
y escritura, sino también derechos para iniciar un proceso y monitorizar sus instancias.
Se controla también el acceso a otros objetos como procesos hijo, conjuntos de datos o
calendarios. Los derechos de acceso se imponen en todas las interfaces externas,
incluidos los servicios Web y las interfaces de usuario.
Veamos el ejemplo a continuación con los siguientes supuestos:
■
El proceso P1 tiene un proceso hijo P2.
■
El propietario X posee P1 y P2.
■
P1 requiere acceso a otros elementos que el Propietario X no desea exponer
directamente a otros usuarios.
■
El acceso predeterminado es que un proceso se ejecuta como el usuario que inicia
el proceso.
Si el Usuario A inicia una instancia de P1, P1 puede iniciar P2 solamente si el Usuario A
está autorizado para iniciar P2 directamente. Para proteger los objetos de
automatización frente a la exposición, el Propietario X puede requerir procesar P1 (o
cualquiera de sus operadores o procesos hijo) para ejecutarlo como propietario, es
decir, ejecutar bajo la identidad del Propietario X. Cuando el Propietario X configura un
proceso ejecutarlo como propietario, el Propietario X está autorizando a otros usuarios
a ejecutar el proceso P1 sin concederlos el acceso a los elementos que P1 necesita.
Del mismo modo, el Propietario X puede obligar a los operadores a ejecutarse bajo la
identidad del usuario que inició la instancia del proceso. Aunque el proceso P1 se
configura para ejecutarse como propietario, el Propietario X puede imponer el proceso
hijo P2 para ejecutarse bajo la identidad del usuario que inicia directamente o
indirectamente el proceso P1. En este caso, CA Process Automation utiliza la identidad
del usuario originario para validar el acceso al proceso hijo P2.
Consideremos este escenario: un usuario administrador de la base de datos crea un
proceso de administración de base de datos que requiere externalizar las credenciales
del administrador de la base de datos a un conjunto de datos denominado. El
administrador de la base de datos configura este proceso para ejecutarlo como el
propietario. La opción Ejecutar como propietario concede a instancias del acceso al
conjunto de datos que almacena las credenciales de administrador de la base de datos.
El administrador de la base de datos autoriza a los usuarios seleccionados para que
puedan ejecutar un proceso de administrador de la base de datos específico, sin
conceder acceso directo a estos usuarios a las credenciales de administrador de la base
de datos.
76 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
En resumen, una instancia del proceso en ejecución tiene dos identidades relacionadas:
■
El usuario real que inicia la instancia del proceso en la interfaz de usuario, una
agenda o un servicio web.
■
El usuario efectivo que viene determinado por cómo se aplica Ejecutar como
propietario a las definiciones del proceso y a los operadores en esos procesos.
Nota: La identidad del usuario efectivo actual se utiliza para validar el acceso a
procesos hijos, operadores y conjuntos de datos.
Más información:
Directrices para establecer la seguridad de tiempo de ejecución para un proceso (en la
página 441)
Especificación de las propiedades de seguridad de tiempo de ejecución
Se pueden especificar propiedades de seguridad de tiempo de ejecución para los
objetos de proceso y de planificación. Estas propiedades definen si el sistema verifica los
permisos de usuario cuando estos intentan acceder a objetos de automatización de la
base de datos y cómo se lleva a cabo esta verificación.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta, haga clic con el botón secundario del ratón en un objeto de
proceso o planificación y, a continuación, seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha Seguridad de tiempo de ejecución.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos.
Capítulo 3: Explorador de bibliotecas 77
Cómo trabajar con objetos y carpetas
4.
En Seguridad de tiempo de ejecución se pueden realizar una de las tareas
siguientes:
■
Herede configuraciones de seguridad activadas del orquestador, si
corresponde. Este es el valor predeterminado.
■
Seleccione Activar de la lista desplegable. Esta opción permite que el producto
verifique los permisos de usuario cuando estos acceden a los objetos en el
proceso.
Los objetos de proceso están diseñados normalmente para acceder a otros
objetos con el fin de leer o ejecutarse durante la ejecución, como cuando un
proceso dispara otro proceso. Si se activa, el producto utiliza la seguridad de
tiempo de ejecución para verificar que el usuario (el propietario o autor de la
llamada) tiene permisos para acceder al objeto. Por ejemplo, el usuario A tiene
permisos para iniciar un proceso. Este proceso intenta acceder al Objeto B y al
Objeto C. El producto verifica los permisos para cada objeto. Si la seguridad de
tiempo de ejecución determina que el usuario no tiene permisos para acceder
Objeto B, el proceso produce un error.
■
5.
Seleccione Desactivar para desactivar la validación y el cumplimiento de la
propiedad del proceso en tiempo de ejecución. Esta opción proporciona a
compatibilidad con versiones anteriores de procesos existentes y permite que
estos procesos se ejecuten como lo hacían antes de esta versión.
Configure la seguridad de tiempo de ejecución para los objetos de proceso
mediante las opciones siguientes. Para mantener la casilla de verificación Ejecutar
como propietario, hay que ser el propietarios del proceso o un administrador de
contenido de entornos.
■
Ejecute el proceso como el usuario que inició la instancia del proceso.
a. En el campo Seguridad de tiempo de ejecución, haga clic en Activar.
b. Desactive Ejecutar como propietario.
Esta opción impone derechos de seguridad de tiempo de ejecución con la
identidad del usuario que inicia la instancia del proceso.
■
Ejecute el proceso como propietario.
a. En el campo Seguridad de tiempo de ejecución, haga clic en Activar.
b. Seleccione Ejecutar como propietario.
Esta opción impone derechos de seguridad de tiempo de ejecución con la
identidad del propietario, independientemente de quién inicia la instancia del
proceso. Esto permite a los usuarios iniciar un proceso que puede acceder a
elementos que el propietario desea proteger.
■
6.
Seleccione la casilla de verificación Activar la recuperación del operador para
recuperar operadores específicos automáticamente que produjeron un error
con SYSTEM_ERROR.
Haga clic en Guardar.
78 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Más información:
Directrices para establecer la seguridad de tiempo de ejecución para un proceso (en la
página 441)
Definición de la duración de ejecución de un proceso
Se puede definir la duración de ejecución esperada para un proceso. Si el tiempo de
ejecución de un proceso supera la duración definida, la ficha Operaciones muestra un
indicador rojo (de advertencia).
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta y, a continuación, seleccione un objeto de proceso para el
que desee definir la duración de ejecución.
Nota: Si el objeto del proceso adecuado no existe, créelo. Para obtener más
información sobre la creación de procesos, consulte Diseño de procesos (en la
página 101).
3.
Haga clic con el botón secundario del ratón en el objeto de procesos y seleccione
Propiedades.
4.
En el panel Propiedades, haga clic en la ficha Duración.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos y ejemplos.
5.
Marque la casilla de verificación Activado.
El producto activa los campos de la ficha Duración.
6.
Establezca la duración esperada del proceso.
7.
Defina con cuánto tiempo antes de la ejecución se debe advertir al usuario antes de
que un proceso supere la duración esperada.
8.
Haga clic en Guardar.
Capítulo 3: Explorador de bibliotecas 79
Cómo trabajar con objetos y carpetas
La opción Estado de duración muestra uno de los indicadores de estado siguientes para
la instancia del proceso de tiempo de ejecución asociada:
■
Rojo: la ejecución del proceso ha excedido la duración esperada.
■
Amarillo: el proceso está ejecutándose pero está a punto de llegar al final de la
duración esperada.
■
Verde: el proceso se ha ejecutado dentro de la duración esperada. El estado es
verde mientras un proceso se completa y mientras se está ejecutando un proceso
que no se encuentra en el estado amarillo o rojo.
■
Sin indicadores: el proceso no tiene ninguna duración esperada definida.
80 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Capítulo 3: Explorador de bibliotecas 81
Cómo trabajar con objetos y carpetas
82 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Versiones
CA Process Automation utiliza un sistema de control de versión que realiza un
seguimiento de los cambios de los objetos de la biblioteca. El sistema de seguimiento de
las versiones siempre mantiene una única versión actual para cada objeto. Cuando se
abre un objeto, la aplicación utiliza automáticamente el que se ha designado como la
versión actual. La aplicación conserva otras versiones del objeto para la copia de
seguridad o para el archivo de archivado. Se pueden abrir versiones archivadas de un
objeto para verlas, editarlas o establecerlas como la versión actual. El propietario del
objeto o cualquier otro usuario que tenga permisos suficientes pueden cambiar la
versión actual.
Se puede extraer y luego editar cualquier versión de un objeto. Cuando se finalicen las
ediciones, se pueden introducir cambios a la versión o a una nueva versión del objeto.
Para impedir que los usuarios cambien una versión en particular, se le puede designar
como versión de línea de referencia. Las versiones de línea de referencia pueden
utilizarse como cualquier otra versión. También se puede extraer una versión de línea
de referencia y editarla, pero solo se podrá incorporar en el objeto como una versión
nueva. Las versiones de línea de referencia sirven como comparativa o plantilla para
desarrollos futuros.
Para publicar una nueva versión de un proceso con todos sus componentes, establezca
el atributo Versión de publicación para el proceso y cada objeto asociado. La versión de
publicación (en la página 466) normalmente es una versión de un objeto que se
implementa en un entorno de producción. CA Process Automation mantiene el atributo
Versión de publicación que se estableció antes de la exportación, en el entorno de
importación. Hay que establecer un atributo Versión de publicación para cada objeto,
agregar cada objeto a la carpeta e iniciar la exportación de la carpeta. Si se exporta la
carpeta como un paquete de contenidos, la versión de publicación no se puede
modificar en el entorno de producción. El proceso de importación configura
automáticamente como línea de referencia la versión de publicación de un paquete de
contenidos para impedir que los usuarios incorporen cambios en la versión importada.
Capítulo 3: Explorador de bibliotecas 83
Cómo trabajar con objetos y carpetas
84 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Element Descripción:
o:
Versiones del objeto: Para cada objeto, el explorador de la biblioteca muestra el usuario que ha
extraído el objeto y las últimas y más actuales versiones del objeto. En este ejemplo, la versión actual
del conjunto de datos seleccionado es 2, que es la versión que el usuario Design_01 ha extraído. La
última versión del objeto es la número 4.
Ficha Versiones del panel Propiedades: la ficha Versiones del panel Propiedades enumera la versión
original y todas las demás versiones de un objeto. Se puede consultar qué versión es actual, qué
versión o versiones son líneas de referencia y la información sobre la creación y modificación.
La ficha Versiones del panel Propiedades también proporciona un campo Versión de publicación
editable. Si lo desea, realice la acción siguiente:
1.
Agregue un valor específico de publicación al campo Versión de
publicación como parte de la preparación para la exportación.
2. Seleccione esta versión del objeto para exportarla.
Nota: Si se exportó el objeto como parte de un paquete de contenidos, el campo Versión de
publicación no se puede modificar una vez que el objeto se ha importado a un entorno nuevo. Aparece
una sugerencia en el campo que indica que está bloqueado.
Ficha Versiones de un editor de objetos: cuando se abre o edita un objeto, la ficha Versiones permite
seleccionar una única versión actual y una o varias versiones de línea de referencia. La otra
información es exactamente la misma que la información mostrada en el panel Propiedades.
Ficha Pista de auditoría del editor de objetos: esta ficha proporciona un historial de todos los cambios
realizados en cada objeto de automatización.
Capítulo 3: Explorador de bibliotecas 85
Cómo trabajar con objetos y carpetas
Comprensión de versiones
Consulte los siguientes gráficos y ejemplos para aprender los conceptos básicos sobre el
trabajo con versiones.
Símbolos:
Versión de objeto.
actual.
Versión
Versión de trabajo.
versión de trabajo.
Descartar
Abra una versión anterior.
Versión de línea de
referencia.
Versión extraída por el usuario 1.
Última versión extraída por el
usuario 2.
Elem Descripción:
ento:
Secuencia de control de versiones típica: un nuevo objeto de automatización empieza
en la
versión 0. El objeto se extrae como la
versión de trabajo 0, con la opción
de aplicar cambios pendientes a la misma versión 0 o una nueva versión 1.
Versión actual: en esta secuencia típica,
la versión de trabajo 0 se incorpora como
la nueva versión 1. La nueva versión se suele designar como la
versión actual. La
versión actual es aquella que se utiliza cuando el proceso realmente se ejecuta. La
versión
original 0 se considera ahora solo como una copia de seguridad o un
archivo de archivado.
86 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Elem Descripción:
ento:
Cambios aplicados a la misma versión: en este ejemplo,
la versión 2 se extrae
varias veces. Cada vez, el usuario ha decidido aplicar los cambios a la misma versión en
lugar de crear una versión nueva. Aunque los cambios se realizaron en
las
versiones de trabajo 3 (0), 3 (i) y 3 (ii), el usuario ha decidido agruparlos todos en una
sola versión. El usuario no puede volver para ver el objeto entre los cambios de las
versiones 3 (0) y 3 (i). Ninguna existe ninguna versión independiente que consultar.
Versión de línea de referencia: el usuario ha designado la versión 4 como una versión
de línea de referencia. Cualquier versión de trabajo extraída se deberá incorporar
como una nueva versión, versión 5. Cuando se especifican uno o varias versiones de
línea de referencia, esencialmente se está bloqueando cada versión. Esta práctica
impide que se pueda realizar ninguna modificación en las versiones de línea de
referencia actuales. Sólo se pueden utilizar como plantillas u objetos de clase
antecesores para facilitar la creación de nuevas versiones.
Versiones actuales, de trabajo y abiertas:
la versión actual 5 tiene tres ramas
simultáneas que los usuarios podrían seguir. En la rama A, sus cambios se aplican
como
las versiones nueva y actual 6. En la rama B, la versión de trabajo
5 se
puede introducir como
la nueva versión 6, aunque
la versión 5 sigue siendo la
versión actual. En la rama C, el usuario decide abrir
la versión 5. El usuario puede
consultar la versión pero no puede guardar cambios en la misma.
Varios usuarios: al ejecutar procesos, use
la versión actual 6; es posible que el
objeto se extraiga para el
usuario 1 con cambios pendientes en
la versión de
trabajo 7. Al ejecutar procesos, use
la versión actual 6; el usuario 2 puede aplicar
los últimos cambios realizados en el objeto y reflejarse como
la última versión 7.
Descargar la versión de trabajo: los cambios realizados en
la versión de trabajo 7
se pueden descartar. Al igual que la operación para deshacer una extracción, devuelve
el objeto a la última versión incorporada.
Nueva versión actual: la
última versión 7 se puede extraer como
la versión de
trabajo 7. Durante la incorporación, el usuario puede decidir convertirla en la nueva
versión actual 8.
Configuración de la versión de objeto como actual o como línea de referencia
La ficha Versiones muestra información sobre las versiones de un objeto. En esta ficha
se pueden realizar las tareas siguientes:
■
Determinar cuándo y quién creó una versión específica y la actualizó por última vez
■
Determinar cuál es la versión actual de un objeto y, opcionalmente, designar una
versión diferente como actual
■
Determinar qué versiones están configuradas como línea de referencia y,
opcionalmente, designar que una o varias versiones tengan línea de referencia
Capítulo 3: Explorador de bibliotecas 87
Cómo trabajar con objetos y carpetas
Al principio, el producto designa el objeto que crea como versión 0 (de trabajo). Cuando
se guarda el objeto y se incorpora por primera vez, el producto lo designa como versión
1 (actual). De este punto en adelante, el producto designa una versión como actual y
utiliza esta versión cuando se ejecuta el proceso. El producto inicia la versión actual de
forma predeterminada cuando se abre el objeto desde la biblioteca. De forma
predeterminada, las versiones modificadas de los objetos asumen el estado Actual al
incorporarlas. Opcionalmente, se puede usar el botón Actual para asignar ese estado a
cualquier versión anterior. Esta opción permite crear una versión del objeto a la cual el
producto no accede o no abre de forma predeterminada. No tiene que extraer un
objeto para establecer la versión actual. Solo el propietario del objeto o un usuario con
el rol de administrador de contenido de entornos tiene permisos para designar una
versión como actual.
Puede configurar como línea de referencia una versión de objeto y bloquear otras
actualizaciones. Los usuarios pueden utilizar la versión configurada como línea de
referencia como plantilla para crear una versión nueva e incorporada. Se puede
configurar una versión como línea de referencia cuando no esté previsto hacer más
cambios en el objeto. Por ejemplo, se recomienda configurar los objetos como línea de
referencia antes de empaquetarlos para su exportación. La versión que configure como
línea de referencia puede ser la versión actual u otra versión.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta, haga clic con el botón secundario del ratón en un objeto y,
a continuación, seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha Versiones.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos y ejemplos.
4.
(Opcional) Haga clic en el botón Actual activo de una versión para establecerla
como versión actual y desactivar el botón.
5.
(Opcional) Haga clic en el botón Línea de referencia activo en una o varias versiones
para configurarlas como versiones de línea de referencia y desactivar el botón.
Nota: No se puede revertir la configuración de una versión como línea de
referencia. Si actualiza una versión configurada como línea de referencia, debe
guardarla como versión nueva.
88 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Establecimiento de la versión actual de un objeto
La versión actual de un objeto es la versión predeterminada utilizada por CA Process
Automation en el desarrollo o la producción. Para establecer la versión actual no es
necesario extraer el objeto, pero es necesario ser el propietario del objeto o un
miembro del rol Administrador de contenido de entorno.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Explorador de bibliotecas.
2.
Haga doble clic en un objeto.
El objeto se abre en su editor.
3.
Haga clic en la ficha Versiones.
4.
En la fila de una versión específica, haga clic en el botón Actual.
El botón Actual desactivado indica que la versión seleccionada ahora es actual. Se
puede cambiar directamente la versión actual haciendo clic en el botón Actual en
cualquier fila.
Abra la versión actual o de trabajo de un objeto
Cuando se hace doble clic sobre un objeto en la biblioteca que se ha extraído, se abre la
versión de trabajo. La versión de trabajo mostrará los cambios efectuados. Si el objeto
no se ha extraído, la versión actual se abrirá en modo de solo lectura. Extraiga el objeto
para editarlo.
Apertura de una versión seleccionada de un objeto
Se puede abrir una versión seleccionada de cualquier objeto para consultarla o editarla
en lugar de abrir la versión actual. Por ejemplo, se puede abrir una versión anterior o
abrir una nueva rama del objeto con sus últimos cambios.
Para abrir una versión seleccionada de un objeto
1.
Haga clic en la ficha Explorador de bibliotecas.
2.
En el panel de carpetas del explorador de bibliotecas, haga clic en una carpeta.
3.
Haga clic con el botón secundario del ratón en un objeto, elija Versiones y, a
continuación, abra una versión.
4.
En el cuadro de diálogo Editar versión, haga clic en una versión del objeto y, a
continuación, seleccione Abrir.
El objeto se abre en su editor.
Capítulo 3: Explorador de bibliotecas 89
Cómo trabajar con objetos y carpetas
Extracción de un objeto
Para editar y guardar los cambios realizados en un objeto, extráigalo. La extracción de
un objeto permite impedir que otros usuarios cambien al mismo tiempo un objeto que
se está editando. Se puede abrir y consultar un objeto sin extraerlo, pero no se puede
editar.
Se puede extraer uno o varios objetos antes de abrirlos.
Lleve a cabo los pasos siguientes:
1.
En el explorador de bibliotecas, seleccione uno o varios objetos.
2.
Haga clic en Extraer.
Ahora se puede hacer doble clic en el objeto extraído que desea abrir y editarlo.
También se puede extraer un solo objeto después de abrirlo.
Lleve a cabo los pasos siguientes:
1.
En el explorador de bibliotecas, haga clic en el objeto.
El objeto se abre en su editor.
2.
En el editor de objetos o el Diseñador de procesos, haga clic en Extraer.
Se puede extraer, editar, incorporar, probar los cambios y, a continuación, extraer y
continuar editando el objeto.
Cómo guardar los cambios de un objeto extraído
Guardar la versión de trabajo de un objeto le impide que pierda los cambios mientras
trabaja. Por ejemplo, si cierra involuntariamente el editor de objetos. Los cambios
guardados en un objeto extraído solo afectan a la versión de trabajo del objeto. No se
crea una nueva versión del objeto y el objeto no se incorpora.
Lleve a cabo los pasos siguientes:
1.
Extraiga un objeto (en la página 90).
2.
Edite la versión de trabajo.
3.
Haga clic en Guardar.
Una vez que se hayan guardado los cambios a la versión de trabajo, se puede cerrar el
editor. El objeto aún está extraído. La versión de trabajo permanece editable y continúa
reflejando sus cambios mientras esté extraída. Cuando se abre el objeto otra vez, la
aplicación automáticamente abre la versión de trabajo.
90 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Cómo descartar los cambios de un objeto extraído
Después de la extracción, modifique y guarde un objeto. A continuación, puede decidir
si desea continuar trabajando con tal versión específica. Aunque se haya guardado la
versión de trabajo varias veces, aún podrá realizar Anular la extracción para descartar la
versión de trabajo guardada.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón secundario del ratón en el objeto de la ventana principal y
seleccione Incorporar/Extraer.
3.
Seleccione Deshacer la extracción.
La aplicación ignora los cambios que se han guardado en la versión de trabajo e
incorpora el objeto.
4.
Para continuar trabajando con el objeto, extráigalo de nuevo.
Incorporación de objetos
Cuando termine la edición, incorpore el objeto para guardar los cambios en la misma
versión del objeto o en una versión nueva.
Después de finalizar el procedimiento, el diseñador permanecerá abierto y podrá seguir
consultando el objeto en el modo de sólo lectura. Extraiga el objeto de nuevo si desea
realizar más cambios.
Lleve a cabo los pasos siguientes:
1.
Extraiga un objeto (en la página 90).
2.
Editar el objeto
3.
Guarde los cambios en el objeto extraído (en la página 90).
4.
En la barra de herramientas del editor de objetos o la barra de herramientas del
Explorador de bibliotecas, haga clic en Incorporar.
Se muestra el cuadro de diálogo Incorporar y el nombre del objeto aparece en el
campo Nombre de objeto.
Capítulo 3: Explorador de bibliotecas 91
Cómo trabajar con objetos y carpetas
5.
Para especificar cómo se deben incorporar los cambios, especifique las siguientes
configuraciones:
Actual
Seleccionado: la versión seleccionada se convierte en la versión actual del
objeto. La versión actual es la que utiliza CA Process Automation.
No seleccionado: la versión actual anterior sigue siendo la versión actual.
Desactive la casilla de verificación si está incorporando un objeto cuyo diseño
está en curso.
Línea de referencia
Seleccionado: la versión del objeto que está incorporando no se puede cambiar
en una extracción futura. Las versiones de la línea de referencia solamente
pueden servir de base para las nuevas versiones. Se puede extraer una versión
de línea de referencia, modificarla e incorporar el objeto como una versión
nueva
No seleccionado: la versión del objeto que está incorporando sí se puede
cambiar en una extracción futura.
Versión
Muestra la versión del objeto que se está incorporando.
Versión de publicación
Define un indicador único para la versión de un objeto que se selecciona para
su exportación como parte de una publicación.
Si el campo Versión de publicación es de solo lectura, significa que el objeto se
importó previamente con la versión de publicación en el modo no modificable.
La sugerencia proporciona detalles al respecto.
Introduzca un valor para Versión de publicación solamente cuando esté
preparando la versión del objeto para la exportación (solo, en una carpeta).
Introduzca un valor específico de versión para que no haya conflictos con
ningún valor de versión de publicación para un objeto existente en el entorno
de importación.
Nota: Si se produce un conflicto, la importación genera un error. En concreto,
la importación genera errores en los siguientes casos:
92 Guía del diseñador de contenido
■
El objeto se importa con la opción Importar como nueva versión y
mantener el objeto existente.
■
El objeto existente tiene una versión con el mismo valor de Versión de
publicación que el valor introducido en el campo de Versión de
publicación.
Cómo trabajar con objetos y carpetas
Comentarios
(Opcional) Introduzca comentarios descriptivos para que se guarden con esta
versión del objeto.
Incorporar como
Especifica si se debe crear una versión nueva del objeto o si se deben aplicar
los cambios a la misma versión.
Nueva versión: permite crear una versión nueva del objeto.
Misma versión: sobrescribe la versión actual del objeto con los cambios hechos
desde que se extrajo por última vez.
6.
Haga clic en Incorporar.
Nota: Si intenta incorporar cambios en un objeto configurado como línea de
referencia, CA Process Automation mostrará un mensaje de error.
Comprensión de las líneas de referencia
La finalidad de las líneas de referencia en un objeto es bloquear una versión.
Se debe tener en cuenta el caso en el que se está editando la versión de un objeto de
automatización y guardando los cambios. Después de realizar todos los cambios
planificados, hay que configurar la versión actual del objeto como línea de referencia
para evitar futuros cambios en esa versión. Se puede extraer una versión de línea de
referencia, modificarla y guardar los cambios, pero no se puede introducir el objeto
como la misma versión. Se deben introducir los cambios como si de una nueva versión
se tratase.
Por ejemplo, suponga que establece como línea de referencia la versión 0 de un proceso
y, a continuación, procede de esta forma:
1.
Se extrae la versión 0.
2.
Se edita la versión 0.
3.
Se guarda la versión 0.
4.
A continuación, se incorpora la versión 0.
■
Si se incorporan los cambios como una versión nueva, CA Process Automation
la creará correctamente.
■
Si se intentan incorporar los cambios como si se tratase de la misma versión, el
producto mostrará el siguiente mensaje:
Se ha extraído una versión de línea de referencia. Para
incorporar los cambios, se debe seleccionar Nueva versión.
No se puede sobrescribir una versión de línea de referencia introduciendo los
cambios en la misma versión.
Capítulo 3: Explorador de bibliotecas 93
Cómo trabajar con objetos y carpetas
Se puede configurar una versión como línea de referencia cuando no esté previsto hacer
más cambios en el objeto. Por ejemplo, se recomienda configurar los objetos como línea
de referencia antes de exportarlos como un paquete de contenidos. El proceso de
empaquetado se puede equiparar con el de publicación. Por tanto, antes de publicar un
objeto, se puede bloquear configurándolo como línea de referencia en la incorporación
final. Posteriormente se podrá modificar el objeto, siempre que se incorporen los
cambios en una versión diferente.
Nota: Durante la exportación de una carpeta como un paquete de contenidos, CA
Process Automation exporte los atributos de la versión de publicación en el modo no
modificable. El proceso de importación configura como líneas de referencia todos los
objetos para que los usuarios del entorno objetivo no puedan modificar las versiones de
objeto exportadas.
Creación de una versión de línea de referencia de un objeto
Para impedir que los usuarios cambien una versión en particular, se le puede designar
como versión de línea de referencia. Los usuarios pueden extraer una versión de línea
de referencia y editarla, pero sólo se podrá incorporar como una versión nueva.
No es necesario extraer objetos para establecerlos como líneas de referencia, pero es
necesario ser el propietario del objeto o tener permiso administrativo sobre él.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Explorador de bibliotecas.
2.
Haga doble clic en un objeto.
El objeto se abre en su editor.
3.
Haga clic en la ficha Versiones.
4.
En la fila de una versión específica, haga clic en el botón Línea de referencia.
La versión seleccionada es ahora la de línea de referencia, ya que el botón Línea de
referencia estará inhabilitado. Se pueden seleccionar varias versiones de línea de
referencia de un objeto.
Nota: No se puede deshacer ni revocar el estado de línea de referencia de una versión.
Si se desea restablecer una versión para que no sea la línea de referencia, establézcala
como la versión actual, extráigala y, a continuación, introdúzcala como nueva versión sin
marcar la casilla de verificación Línea de referencia.
94 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Eliminación o restauración de un objeto o carpeta
Los objetos de automatización, las carpetas vacías o las carpetas que contengan objetos
se pueden suprimir cuando ya no se necesiten. La aplicación mueve los elementos
suprimidos a la papelera de reciclaje.
Si se suprime involuntariamente un objeto que se necesita (o una carpeta que contenga
un objeto necesario), se puede restaurar este objeto con su estructura de carpetas.
Nota: Únicamente un administrador puede borrar de forma permanente objetos (y sus
carpetas) desde la Papelera de reciclaje.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione uno o varios objetos o carpetas.
3.
Haga clic en Suprimir.
Para prevenir la pérdida inmediata de datos, los elementos se mueven
automáticamente a la Papelera de reciclaje.
4.
En el panel de carpetas del explorador de bibliotecas, haga clic en Papelera de
reciclaje.
5.
(Opcional) Ordene por fecha, nombre o tipo, o utilice funciones de búsqueda para
encontrar elementos específicos.
6.
Para restaurar objetos o carpetas, selecciónelos y haga clic Restaurar el grupo
seleccionado.
7.
Para suprimir objetos o carpetas de forma permanente, selecciónelos y haga clic en
Borrar definitivamente la selección.
Importante: Después de borrar definitivamente objetos o carpetas, estos no se
pueden recuperar. Cuando se seleccionan carpetas o un conjunto de objetos que se
desean borrar definitivamente, este proceso muestra cualquier objeto extraído. El
administrador revisa la lista. Posteriormente, el administrador continúa o cancela el
borrado definitivo, en función de los resultados del análisis.
Capítulo 3: Explorador de bibliotecas 95
Cómo trabajar con objetos y carpetas
Cómo copiar y pegar objetos o carpetas
Se pueden copiar objetos o carpetas. Se puede utilizar la versión actual de un objeto
como base para objetos configurados de manera similar en el mismo orquestador. Copie
la versión actual de un objeto en la misma carpeta (o en una diferente) donde pueda
renombrarla y editarla como si fuera un objeto nuevo. Por ejemplo, puede configurar un
objeto Operador personalizado y, a continuación, agregar copias de dicho objeto a una
biblioteca.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Identifique los objetos que desee copiar en la ventana principal. Compruebe que la
versión pertinente esté marcada como la versión actual.
3.
Seleccione una o varias carpetas u objetos fuente y haga clic en
4.
En el panel de carpetas del Explorador de bibliotecas, haga clic en una carpeta de
destino en la misma biblioteca de automatización y haga clic en Pegar.
Copiar.
Observe los siguientes resultados:
5.
■
CA Process Automation agrega los objetos copiados con los mismos nombres
que los objetos originales.
■
Cada objeto tiene una versión, la versión que se ha copiado.
■
Si la versión copiada tiene un valor de Versión de publicación, la copia conserva
ese valor.
■
Si la versión copiada se había configurado como línea de referencia, la copia
también será una línea de referencia.
■
Si esta ubicación es la misma que la de la carpeta fuente, CA Process
Automation anexa un número a cada nombre de objeto (por ejemplo,
Proceso_1).
(Opcional) Renombre los objetos nuevos.
96 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
Cortado y pegado de un objeto o una carpeta
Los objetos y las carpetas se pueden cortar y pegar en la misma carpeta o una diferente.
Por ejemplo, se puede cortar un objeto Operador personalizado y, después, pegarlo en
la misma biblioteca.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Identifique los objetos que desee cortar en la ventana principal.
3.
Seleccione una o varias carpetas u objetos fuente y haga clic en Cortar.
4.
En el panel de carpetas del explorador de bibliotecas, haga clic en la carpeta de
destino en la misma biblioteca de automatización y haga clic en Pegar.
Si los nombres de los objetos que se van a pegar existen en la ubicación objetivo,
seleccione objetos en dicha ubicación para reemplazarlos por los objetos que ha
cortado.
Capítulo 3: Explorador de bibliotecas 97
Cómo trabajar con objetos y carpetas
Cómo trabajar con contenido no modificable
CA Technologies puede publicar contenido no modificable. El icono de negación indica
que el contenido no se puede modificar:
El uso de objetos no modificables es diferente del uso de objetos modificables en los
siguientes aspectos:
■
No se puede modificar la versión importada.
■
Se puede copiar y pegar la versión importada en otra carpeta y, a continuación,
modificar la copia.
■
No se puede modificar la versión de publicación de un objeto importado.
■
No se puede modificar la versión de publicación de una copia del objeto importado.
Detalles de nivel de acción sobre el uso de contenido no modificable
Se permiten realizar las siguientes acciones en contenido no modificable:
■
Copiar el objeto con un nuevo nombre y pegarlo en una carpeta diferente
■
Cortar el objeto y pegarlo en una carpeta diferente
■
Suprimir el objeto importado
■
Consultar las propiedades de objeto
■
Realice cualquiera de las acciones que se muestran en la lista desplegable Más
acciones para los objetos importados.
No se permiten realizar las siguientes acciones en contenido no modificable:
■
Editar el objeto
■
Renombrar el objeto
■
Incorporar o extraer el objeto
■
Abrir la versión del objeto para su edición
■
Actualizar las propiedades de objeto
■
Establecer el propietario del objeto
■
Exportar el objeto
Si el contenido no modificable se exporta en una carpeta, las siguientes acciones no se
permiten en la carpeta:
98 Guía del diseñador de contenido
Cómo trabajar con objetos y carpetas
■
Importar
■
Crear objeto
■
Paste
Capítulo 3: Explorador de bibliotecas 99
Capítulo 4: Diseño de procesos
Los objetos de proceso de CA Process Automation representan operadores, puertos,
vínculos, lógica y restricciones de forma gráfica. Cada proceso contiene una o más
cadenas de operadores que se pueden ejecutar en una secuencia o paralelamente. Los
carriles separan los procesos padre de los procesos secundarios disparados. Por
ejemplo, una rama de un proceso que cambia a un subproceso se describe a menudo en
un carril separado. Los identificadores de excepción controlan los operadores que se
anulan o terminan debido a errores del sistema o condiciones de salida sin identificar.
Cada proceso define la configuración y gestión de los operadores en puntos de contacto
en un entorno. Los objetos de proceso se almacenan con otros objetos en una biblioteca
asociada con un orquestador. Se pueden crear objetos de proceso en el Explorador de
bibliotecas o directamente en el Diseñador. Estos también se abren desde el explorador
de bibliotecas. Sin embargo, los procesos se consultan y editan en el diseñador de
procesos.
Esta sección contiene los siguientes temas:
El Diseñador de procesos (en la página 102)
Operadores y vínculos: Los fundamentos (en la página 104)
Creación de un nuevo objeto de proceso (en la página 105)
Diseño de un proceso (en la página 106)
Operadores de proceso (en la página 108)
Proceso de puertos de operador y vínculos (en la página 115)
Bucles de proceso e iteraciones (en la página 120)
Control del proceso (en la página 132)
Carriles de proceso (en la página 140)
Versiones de proceso (en la página 144)
Documentación de un proceso (en la página 144)
Contenido Self-Contained (en la página 146)
Vaya a una parte específica de un proceso (en la página 149)
Arquitectura multicliente y CA Process Automation (en la página 150)
El Editor de código de CA Process Automation (en la página 152)
Capítulo 4: Diseño de procesos 101
El Diseñador de procesos
El Diseñador de procesos
El diseñador de procesos proporciona un entorno de desarrollo integrado donde puede
arrastrar y soltar operadores y vínculos para diseñar procesos. El diseñador de procesos
también proporciona capacidades de depurado, prueba y valores de configuración de
propiedades y conjuntos de datos.
Utilice el Diseñador de procesos para realizar lo siguiente:
■
Diseñar y editar procesos.
■
Ejecutar y controlar la ejecución de los procesos en entornos de producción o de
prueba.
■
Modificar una instancia en ejecución de un proceso para recuperarlo de una
incidencia.
Agregar un operador arrastrándolo desde la paleta Operadores al diseño. También se
pueden ver y configurar directamente las propiedades o valores del conjunto de datos
para un operador o proceso.
El diseño del diseñador de procesos incluye los elementos de proceso siguientes:
■
Lienzo: arrastre un operador para ver las guías que le permitirán al operador ajustar
las posiciones en la cuadrícula.
■
Carriles: el proceso de ejemplo muestra dos carriles para organizar los segmentos.
Se pueden agregar más carriles, combinarlos o eliminarlos.
■
Operadores: las entidades funcionales de un proceso. Cada operador, excepto
aquellos al final, mostrará sus puertos de salida y otros iconos de estado más
pequeños.
■
Puertos: estos pequeños puntos de conexión representan los puertos de salida de
cada operador. Todos los operadores, excepto el operador Iniciar, también tienen
un puerto de entrada único.
■
Vínculos: estas líneas conectan el puerto de salida de un operador al puerto de
entrada de otro operador. Se puede personalizar el aspecto de estas líneas.
■
Editores de identificadores: además del Editor principal, el diseñador incluye otras
dos otras fichas en la parte inferior para editar identificadores de excepciones y de
cambio de carril.
El gráfico siguiente describe el Diseñador de procesos.
102 Guía del diseñador de contenido
El Diseñador de procesos
Elemen Descripción:
to:
Barra de herramientas del Diseñador y fichas Proceso: cuando se abre un proceso nuevo o se edita uno
existente desde el Explorador de bibliotecas, aparece la ficha Diseñador. Cada proceso abierto aparece
en su propia ficha. Use los botones de la barra de herramientas para extraer, editar, ampliar o reducir,
guardar, probar e incorporar el objeto de proceso seleccionado. Los operadores se puede copiar y pegar
de una ficha del proceso a otra. La barra de herramientas también incorpora iconos para crear un
proceso o abrir un proceso existente (las imágenes de pantalla pueden variar).
Menú Ver: utilice los valores de configuración de Ver que aparecen arriba a la derecha para mostrar u
ocultar los operadores, los conjuntos de datos, las propiedades y las paletas de navegación. También se
pueden acoplar las paletas de propiedades y de conjuntos de datos a la derecha o en la parte inferior.
Haga clic en Desplazar para abrir la página actual en su propia ventana en el explorador para maximizar
la vista.
Paleta de operadores: arrastre y suelte operadores desde esta paleta hasta el diseño de su proceso.
También se pueden introducir criterios de búsqueda (por ejemplo, "obtener") para filtrar operadores no
coincidentes.
Paleta Conjunto de datos: Use esta paleta para consultar o editar las variables de conjuntos de datos de
un proceso u operador.
Paleta de propiedades: utilice esta paleta y sus botones y ventanas adicionales para gestionar las
propiedades del operador seleccionado.
Paleta de navegación: use esta paleta para ir a regiones específicas de procesos de gran tamaño con
varios carriles. En términos prácticos, puede desplazarse en cualquier dirección dentro de esta paleta en
lugar de desplazarse por el diseño del diseñador principal hacia arriba o abajo.
Diseñador de procesos: el diseño de proceso actual aparece en esta zona de trabajo, lienzo o diseño. El
diseñador de procesos incluye la cuadrícula de fondo y uno o varios carriles.
Capítulo 4: Diseño de procesos 103
Operadores y vínculos: Los fundamentos
Operadores y vínculos: Los fundamentos
La estructura general de un proceso de CA Process Automation se compone de dos
elementos básicos: operadores y vínculos. Los operadores realizan tareas o pruebas
condicionales. Los vínculos conectan a los operadores y determinan el orden de
procesamiento.
La lista siguiente describe algunos ejemplos de operadores:
■
Los operadores Gestión de archivos controlan tamaños de archivo, patrones y otros
parámetros relacionados con los archivos que hay en un sistema.
■
Los operadores del módulo de transferencia de archivos utilizan FTP para realizar
transferencias de archivo y aplicar operadores de archivo remotos.
■
Los operadores Correo electrónico notifican a los administradores del sistema si hay
errores u otros estados condicionales que requieren intervención humana.
■
Los operadores de interfaz Utilidades de la red aplican, actualizan y controla
variables SNMP y envían mensajes SNMP a dispositivos y controladores de red.
■
Los operadores Recurso representan recursos en un suministro limitado.
■
Los servicios Web (métodos SOAP) representan una interfaz entre productos de
terceros y CA Process Automation.
Los vínculos conectan operadores y realizan el flujo de procesamiento. El punto donde
se cruzan el operador y el vínculo se llama puerto. Un vínculo se origina en el puerto de
salida de un operador y termina en el puerto de entrada de otro operador.
Cuando se ejecuta un proceso entre dos operadores, la secuencia de procesamiento se
puede resumir de la siguiente manera:
■
Active el primer operador.
■
Aplique lógica, obtenga un resultado y diríjase al puerto de salida apropiado.
■
Active el segundo operador.
104 Guía del diseñador de contenido
Creación de un nuevo objeto de proceso
Un operador puede tener varios puertos de salida para controlar diversos resultados.
Cada vínculo de salida puede iniciar una rama separada de operadores en un
subproceso o proceso hijo. Los puertos de salida y entrada imponen la secuencia lineal
en la que se procesan los operadores. Pueden dirigir el flujo de procesamiento a una
rama particular de un proceso dependiendo del resultado de un solo operador.
Para dirigir el procesamiento en función de los resultados de varios operadores, utilice
los operadores siguientes:
■
El operador Bucle.
■
El operador Excepción en el modo Identificador de excepciones.
■
Operadores condicionales, como el operador Y o el operador O.
Estos operadores le permiten diseñar varias ramas de entrada y salida para otros
operadores. También se pueden crear vínculos que dependan de los resultados de
varios operadores.
Creación de un nuevo objeto de proceso
Utilice el Explorador de bibliotecas para crear un objeto Proceso en una carpeta.
También se puede crear un proceso en el Diseñador y especificar una carpeta en el
momento de guardarlo. Cree un objeto Proceso para cada secuencia, flujo o subproceso
de automatización discreta que se desee automatizar. Después de crear el objeto
Proceso, diseñe el proceso agregando operadores y conectándolos con vínculos.
Nota: Para establecer derechos y realizar otras tareas de objeto, la práctica
recomendable es organizar los objetos en carpetas. No cree objetos de en el nivel de
raíz, ya que no se pueden gestionar como un grupo.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de carpetas del explorador de bibliotecas, seleccione una carpeta.
3.
En la barra de herramientas, haga clic en Nuevo y, a continuación, elija Proceso .
Aparecerá un nuevo objeto de proceso aparece con un nombre predeterminado. El
proceso se extrae automáticamente para que capture sus cambios exclusivos.
4.
Haga clic en el nombre del proceso y cámbielo a un nombre único. El nombre puede
editarse directamente hasta que se deselecciona. Para editarlo otra vez, haga clic
con el botón secundario del ratón sobre el mismo y elija Renombrar.
Ha creado un nuevo objeto de proceso. A continuación se puede diseñar el proceso.
Capítulo 4: Diseño de procesos 105
Diseño de un proceso
Diseño de un proceso
Primero, ejecute los pasos de Creación de un nuevo objeto de proceso (en la
página 105). Una vez que conozca los conceptos y los pasos para la creación de sus
primeros procesos, podrá editar fácilmente cualquier proceso. Utilice el diseñador de
procesos para diseñar y configurar todos los objetos de proceso.
Lleve a cabo los pasos siguientes:
1.
Haga doble clic sobre el proceso en la Biblioteca o ábralo desde el Diseñador de
procesos.
El diseñador de procesos se abre con un conjunto predeterminado de operadores
de inicio y parada básicos.
2.
Utilice el diseñador de procesos para diseñar y configurar el proceso. Esto incluye
agregar operadores, puertos y vínculos. Consulte los restantes temas incluidos en
esta sección para obtener ayuda.
3.
Para configurar las propiedades de proceso, haga clic en cualquier espacio neutro
del lienzo y elija Propiedades desde el menú Vista en la barra de herramientas.
Se abre la paleta Propiedades. Las propiedades del proceso determinan el
comportamiento predeterminado de todos los operadores agregados a un proceso.
Configuración
Especifica si mostrar carriles horizontales o verticales.
Vincular
Especifica el peso, el color y la forma de las líneas que vinculan a los
operadores.
Simulación
Especifica las opciones de simulación predeterminadas para operadores
agregados a un proceso. Puede sustituir esta configuración para un operador
específico.
Opciones de etiqueta
Especifica las opciones de visualización predeterminadas para operadores
agregados a un proceso. Puede sustituir esta configuración para un operador
específico.
4.
Cuando haya finalizado, haga clic en Aplicar para ver los cambios.
5.
Continúe con otras tareas de esta sección de esta guía.
6.
Cuando termine de editar un objeto, haga clic en Guardar y, a continuación, en
Incorporar.
Sugerencias para el diseño de procesos
106 Guía del diseñador de contenido
Diseño de un proceso
Tenga presentes las sugerencias siguientes al trabajar con procesos:
■
Se puede repetir cualquiera de los temas de este capítulo en prácticamente
cualquier orden. Por ejemplo, agregar un carril, agregar un puerto o conectar un
vínculo.
■
Como regla básica, se puede editar un proceso mediante los mismos pasos que
deben seguirse para editar cualquier objeto de automatización en la biblioteca.
Consulte Cómo trabajar con objetos (en la página 66).
■
Extraiga siempre el proceso para impedir que otros sobrescriban sus cambios. Los
procesos se pueden extraer antes de abrirse (en el explorador de bibliotecas) o
después de haberse abierto (en el diseñador de procesos).
■
CA Process Automation siempre ejecuta la versión actual de un proceso; sin
embargo, si ha extraído un objeto, CA Process Automation es lo bastante
inteligente como para ejecutar la versión de trabajo.
■
Cuando se incorpora un proceso modificado, decida cómo se gestionarán sus
versiones. Se puede reemplazar la versión abierta o se puede crear una nueva
versión independiente.
■
Antes de probar los cambios realizados en un proceso, incorpore la versión editada
que había extraído previamente.
Capítulo 4: Diseño de procesos 107
Operadores de proceso
Operadores de proceso
Los operadores de proceso aplican funciones o realizan acciones para ofrecer un
resultado. Los resultados colectivos de una serie de operadores determinan el flujo
automatizado del proceso.
Elemen Descripción:
to:
Operador Inicio: Todos los procesos incluyen como mínimo un operador Inicio con ningún puerto de
entrada y un solo puerto de salida. Es posible, aunque poco frecuente, que haya más de un operador
Inicio en un proceso.
Operador Detención correcta: Todos los procesos incluyen como mínimo un operador Detener. Los
operadores Detener pueden ser de dos tipos: correcto (mostrado aquí) o error.
Operador Seleccionado: El borde del operador seleccionado actualmente se muestra con un contorno
discontinuo. La paleta Propiedades muestra los valores de configuración del operador actualmente
seleccionado.
Operador Consulta de base de datos con varios puertos de salida: A medida que se agregan puertos,
estos se muestran alrededor de los bordes inferior y derecho del operador. Cada puerto representa el
flujo de proceso de un resultado particular.
Nota: Haga clic con el botón secundario del ratón en un operador para
agregar un puerto.
108 Guía del diseñador de contenido
Operadores de proceso
Elemen Descripción:
to:
Operador Retraso con puerto posterior: los operadores Retraso no incluyen puertos correctamente
Completados de Tiempo de espera. Además de un puerto de resultado personalizado, presentan sólo
dos puertos predeterminados: después y erróneo. Distintos operadores incluyen puertos diferentes.
Operador Enviar evento con indicador de punto de interrupción: los indicadores de estado aparecen
cuando se hace clic en la opción de configuración del punto de interrupción.
Operador Desactivado: cuando desactiva un operador, el diseñador lo muestra transparente. Se puede
decidir activarlo en otro momento.
Capítulo 4: Diseño de procesos 109
Operadores de proceso
El operador Iniciar
Se aplica automáticamente un operador Iniciar predeterminado cuando se crea y abre
un nuevo proceso. El operador Iniciar no tiene ningún puerto de entrada. Configure las
propiedades del operador Iniciar en la paleta Propiedades. Por ejemplo, se puede
cambiar el nombre, especificar un icono personalizado o cambiar la ubicación y el texto
de la etiqueta de icono.
El operador Iniciar inicia una cadena de operadores en cualquier proceso. Cuando un
proceso nuevo empieza, inmediatamente activa el operador Iniciar. Todos los
operadores se deben vincular directa o indirectamente a esta cadena de operadores. Un
proceso puede tener varios operadores Iniciar para iniciar varias rutas de
procesamiento. Estas rutas también se conocen como ramas o subprocesos. Sin
embargo, como regla general, un proceso realmente sólo necesita un operador Iniciar.
Como puede verse en el ejemplo de la derecha, un diseño más eficaz utiliza el mismo
operador Iniciar y quizás incluso el mismo operador Detención correcta. Varios vínculos
pueden compartir el mismo operador.
Nota: la ejecución de varias ramas en paralelo con varios operadores de inicio puede dar
lugar a entradas en el registro confusas. Los registros pueden ser difíciles de analizar
porque la secuencia de ejecución de las ramas con varios inicios puede parecer estar en
orden aleatorio. En la mayor parte de los casos, utilice un único operador Iniciar para
cada proceso.
110 Guía del diseñador de contenido
Operadores de proceso
Cómo agregar operadores a un proceso
Después de incluir el operador Iniciar en un proceso, arrastre el siguiente operador y
luego una los vínculos que determinan el flujo del proceso.
Lleve a cabo los pasos siguientes:
1.
Haga una de las siguientes acciones para abrir un proceso
a.
En el Explorador de bibliotecas, haga doble clic en un objeto de proceso.
b. En la barra de herramientas del Diseñador, haga clic en Abrir.
Aparece la ficha del diseñador de procesos. Si no se ha extraído todavía, haga clic en
Extraer.
2.
Arrastre un operador desde la paleta Operadores y suéltelo en el diseño del
proceso en cualquier lugar debajo o a la derecha del operador Inicio. Los
operadores se disponen en carpetas para cada módulo o categoría de operador
compatible con CA Process Automation. Introduzca el nombre de un operador en el
campo Buscar para buscar operadores coincidentes.
3.
Repita el paso anterior tanto como sea necesario para crear una cadena de
operadores.
4.
Cree el primer vínculo de la cadena. Haga clic en el pequeño puerto de salida bajo el
operador Iniciar y arrastre el vínculo al puerto de entrada del operador de destino.
5.
Continúe conectando lógicamente puertos de salida con los puertos de entrada de
operadores en secuencia.
6.
Configure cada operador haciendo doble clic en él para abrir la paleta de
propiedades.
Capítulo 4: Diseño de procesos 111
Operadores de proceso
Operadores lógicos
Los operadores lógicos (Y y O) se utilizan para sincronizar, unir y dividir el procesamiento
en función de determinadas condiciones. En esta versión, los operadores Y y O están
disponibles en la carpeta Estándar en la paleta Operadores.
Nota: A partir de CA Process Automation r4.0, el operador de derivación no está ya
disponible. Si se importa o se migra a esta versión desde una versión anterior, el
operador de derivación se convierte en un operador O.
Ejemplo: lógica condicional
El ejemplo de proceso siguiente muestra ocho operadores y nueve vínculos (2 azules, 4
verdes y 3 rojos).
■
El operador Iniciar en la parte superior inicia el procesamiento simultáneo de los
dos primeros operadores vinculados (Tarea 1 y Tarea 2).
■
La Tarea 3 se inicia únicamente cuando la Tarea 2 haya finalizado correctamente.
■
El operador Y de los vínculos de salida para la Tarea 1 y la Tarea 3 se activa
solamente después de que tanto la Tarea 1 como la Tarea 3 finalicen
correctamente. Esta ruta termina en el operador verde Detención correcta.
■
El operador O de los vínculos de salida para la Tarea 2 y la Tarea 3 se activa en caso
de que la Tarea 2 o la Tarea 3 finalicen de forma incorrecta. Esta ruta termina con el
operador rojo Error al detener.
■
Los operadores Control del proceso que se ejecutan en un orquestador ejecutan un
proceso. Se pueden ejecutar tareas individuales en un proceso en cualquier punto
de contacto del agente que se encuentre en el mismo entorno que el orquestador.
Por ejemplo, la Tarea 1 puede fluir en un punto de contacto de Windows mientras
la Tarea 2 y la Tarea 3 fluyen en un punto de contacto de UNIX.
112 Guía del diseñador de contenido
Operadores de proceso
Operador Y
El operador Y define un punto de sincronización entre todos los vínculos de entrada al
operador. Los vínculos de salida de un operador Y sólo se activan después de haberse
activado todos los vínculos de entrada al operador. Utilice un operador Y para
sincronizar varias ramas de un proceso cuando todas las ramas deben completarse
antes de comenzar una o más ramas.
Operador O
El operador O activa vínculos de salida cuando cualquiera de los vínculos de entrada se
activa. El operador O también se puede implementar con un solo vínculo de entrada
para activar dos o más vínculos de salida para ramas paralelas independientes.
No tiene que utilizar un operador O para implementar una condición "o" lógica en un
proceso. Dos o más vínculos que introducen el mismo operador se comportan del
mismo modo que un operador O. Sin embargo, para evitar la confusión, y para
documentar la lógica de un proceso, se recomienda utilizar un operador O en lugar de
fusionar vínculos en una operación. La propiedad Nombre en un operador O permite
etiquetar el operador y lo documenta en el contexto de la secuencia lógica de
operadores del proceso.
Capítulo 4: Diseño de procesos 113
Operadores de proceso
El operador Detener: Éxito o error
Termine un proceso vinculando el operador final en una secuencia a un operador
Detener. Un proceso puede tener varios operadores de parada en ramas diferentes. Un
operador Detener procesado en cualquier rama no tiene ninguna salida y finaliza el
procesamiento del proceso completo. Los operadores de parada se pueden configurar
opcionalmente para finalizar un bucle de llamada en otro proceso.
Lleve a cabo los pasos siguientes:
1.
Abra y extraiga un proceso.
2.
En la paleta Operadores, arrastre un operador Detención correcta o Error al detener
hasta el proceso.
3.
Haga doble clic en el operador Detener para abrir la paleta Propiedades.
4.
En la sección Detener, especifique el valor del número entero devuelto por el
proceso en el campo Resultado y elija un valor para el campo Tipo de final.
■
Para terminar el proceso de forma normal, haga clic en Detención correcta e
introduzca un valor de resultado de 1. El valor de resultado 1 hace que el
proceso completado termine cuando el operador Iniciar proceso lo convoca en
un proceso padre.
■
Para terminar el proceso de forma anormal, haga clic en Error al detener e
introduzca un valor de resultado de 0. El valor de resultado 0 hace que el
proceso anulado termine cuando el operador Iniciar proceso lo convoca en un
proceso padre.
5.
(Opcional) En lugar de utilizar estos valores de configuración predeterminados para
el resultado, se puede especificar una expresión que devuelva un número entero.
La expresión debe devolver un número entero distinto de cero para indicar que el
proceso se completó normalmente o cero para indicar que el proceso se completó
anormalmente.
6.
Seleccione la casilla de verificación Interrumpir bucle de llamada para interrumpir
un bucle de llamada. Si el proceso se convocó desde un operador de generación de
bucles de otro proceso, esta opción interrumpe el bucle al procesar retornos de
esta detención al otro proceso. Al desactivar esta casilla de verificación, el bucle de
llamada puede continuar.
7.
Active la casilla de verificación Ignorar tareas en ejecución (detención inmediata)
para detener el procesamiento del proceso de forma inmediata cuando se ejecute
la acción Detener. Esto interrumpe cualquier otro operador que permanezca activo
en otro sitio en el proceso. Desactive esta casilla de verificación para permitir a los
operadores en curso que finalicen normalmente antes de detener el proceso.
114 Guía del diseñador de contenido
Proceso de puertos de operador y vínculos
Proceso de puertos de operador y vínculos
Los vínculos entre los operadores definen las dependencias. Los vínculos actúan sobre
los resultados que produce cada operador. Los vínculos definen el orden y la lógica de
un proceso.
Los distintos tipos de acciones tienen resultados predefinidos diferentes:
■
Correcto
■
Completado
■
Anulado
■
Error
■
Tiempo de espera agotado
La aplicación calcula estos resultados para determinar qué condiciones de salida,
puertos y vínculos se deben activar en una secuencia lógica. Por ejemplo, se puede
agregar un puerto personalizado a algunos operadores y se puede especificar que el
puerto se active cuando una expresión devuelva un valor Verdadero.
Las condiciones de salida en un operador no son mutuamente exclusivas. Si el producto
califica como verdaderas varias condiciones de salida, se procesarán todas las
condiciones de salida. Al procesar varias condiciones de salida en un único operador, se
puede iniciar un procesamiento simultáneo subsiguiente de varias ramas.
Cuando se ejecuta un proceso, el producto activa sus operadores solamente una vez.
Cuando un vínculo conduce a un operador previamente activado, el producto no vuelve
a procesar el operador de destino y se termina la rama que el vínculo extiende.
Nota: Los vínculos se unen a operadores en pequeños puntos de conexión llamados
puertos.
Capítulo 4: Diseño de procesos 115
Proceso de puertos de operador y vínculos
Elemen Descripción:
to:
Operador Seleccionado: haga clic en un operador para consultar sus variables de conjunto de datos,
páginas y propiedades. Haga clic con el botón secundario del ratón en un operador para agregar un
puerto de salida.
Propiedades del vínculo: realice una de las siguientes acciones para ajustar el aspecto de un vínculo:
■
Haga doble clic en un vínculo.
■
Haga clic con el botón secundario del ratón en un vínculo y seleccione
Propiedades del vínculo.
Seleccione el espesor, el color, la forma y el aspecto discontinuo de cada
vínculo.
Forma de la línea del vínculo: en lugar de líneas ortogonales normales, este vínculo morado aparece
con segmentos de línea recta. Los vínculos se pueden extender y colocar según sea necesario.
Vínculo detenido: se ha forzado la detención de este vínculo. Como ejemplo, considere un proceso que
está en un bucle, a la espera de un evento, procesando dicho evento y ejecutándose repetidamente en
un bucle. Cuando una rama paralela del proceso determina que el proceso original que está
ejecutándose en un bucle debe detenerse, puede usar el vínculo y el puerto detenido para detener el
bucle.
116 Guía del diseñador de contenido
Proceso de puertos de operador y vínculos
Elemen Descripción:
to:
Vínculo roto: rompa un vínculo para dividir una ruta indirecta larga en dos líneas numeradas. Los
vínculos divididos son más fáciles de consultar y gestionar. Para volver a unir las líneas numeradas, haga
clic con el botón secundario del ratón en el número del vínculo dentro de un círculo y, a continuación,
seleccione Unir vínculo.
Vínculo desactivado: este vínculo gris discontinuo indica que está desactivado temporalmente. Haga
clic con el botón secundario del ratón en el vínculo para reactivarlo.
Agregación de puertos de operador y vínculos
Coloque un vínculo entre operadores para establecer el flujo lógico. Por ejemplo,
conecte el operador Iniciar con el operador siguiente para empezar un flujo de proceso.
Los vínculos conectan uno de cualquier número de puertos de salida de un operador al
puerto de entrada fijo único de otro.
Lleve a cabo los pasos siguientes:
1.
Abra un proceso.
Aparece la ficha del diseñador de procesos. Si no se ha extraído todavía, haga clic en
Extraer.
2.
Identifique un operador fuente, su puerto de salida y el puerto de entrada de un
operador de destino.
3.
En el operador fuente, si el puerto de salida que desea no aparece, hace clic con el
botón secundario del ratón en el operador y, a continuación, haga clic en el puerto
se desea agregar. Los tipos de puerto varían por operador. Los ejemplos incluyen
Erróneo, Completado, Después y Personalizado.
Aparece un puerto de salida de otro color en el borde del operador.
4.
Haga clic en el puerto de salida del operador fuente y arrastre el vínculo al puerto
de entrada del operador de destino.
Aparece un vínculo nuevo entre los dos operadores.
5.
Repita estos pasos, agregue vínculos y, si es necesario, puertos entre operadores
para definir el flujo del proceso.
6.
En la barra de herramientas, haga clic en Guardar.
Capítulo 4: Diseño de procesos 117
Proceso de puertos de operador y vínculos
Personalización de puertos de salida y expresiones
La mayor parte de los operadores de CA Process Automation son compatibles con los
puertos de salida personalizados. Cuando agregue un puerto personalizado, especifique
lo siguiente:
■
un nombre para la condición
■
un icono para distinguirlo de otros puertos en el operador
■
una expresión booleana válida que devuelva Verdadero o Falso cuando el operador
termina el procesamiento
■
una descripción opcional
También se puede mover el puerto para mejorar la presentación del vínculo. Pulse la
tecla Ctrl mientras hace clic en el puerto para moverlo a posiciones compatibles en los
bordes derecho o inferior del operador.
En el campo Expresión, introduzca una expresión JavaScript válida que devuelva el valor
booleano Verdadero o Falso. Puede utilizar la expresión del puerto personalizado para
evaluar el código de resultado de un operador. El código de resultado indica la
respuesta del operador y lo devuelve la variable de resultado del conjunto de datos del
operador. El vínculo personalizado se activa sólo si la expresión devuelve una condición
Verdadera.
Para activar un vínculo basado en un valor específico para el código de resultado, utilice
la siguiente sintaxis:
Process.Operator.Result == value
118 Guía del diseñador de contenido
Proceso de puertos de operador y vínculos
La palabra clave Proceso hace referencia al conjunto de datos de proceso. El operador es
el valor especificado por el parámetro Nombre del operador. El resultado es el nombre
del campo para la variable del código de resultado en el conjunto de datos del operador.
Para activar un puerto también se puede elaborar una expresión como comparación
entre varias declaraciones. En este ejemplo, el valor de GoJava debe ser 1 y el valor del
operador OpM en el proceso P2 no debe ser 1:
(Process.GoJava.Result == 1) && (P2.OpM != 1)
Cuando un proceso se ejecuta y encuentra un operador sin ningún puerto de salida
definido, el proceso pasa a un estado Bloqueado.
Cuando un operador tiene varios puertos personalizados, la aplicación ejecuta todos los
puertos con una condición de salida que devuelve el valor Verdadero. Evite superponer
lógica en los puertos de salida si no desea activar más de un vínculo de salida a la vez. Es
muy probable que esta condición suceda si incluye puertos tanto estándar como
personalizados en el mismo operador. Por ejemplo, si incluye un puerto personalizado
activado por la expresión Process.A==5 y un puerto estándar correcto en un operador,
este último activa ambos vínculos de salida cuando Process.A devuelve un valor de 5.
Para atrapar valores y enrutar el procesamiento a un solo puerto, sería mejor usar más
de un puerto de salida personalizado para especificar expresiones exclusivas, como:
(Process.A == 5) Y (Process.OperatorName.Result == 5)
(Process.A == 5) Y (Process.OperatorName.Result != 5)
(Process.B == "finance") Y (Process.OperatorName.Result == 7)
(Process.OperatorName.Result == 1) Y (Process.A <> 5)
En este ejemplo, podría incluir también el vínculo estándar de errores producido para
cubrirlo cuando la variable de resultado del operador devuelve un valor de 0. Si duda
sobre los resultados de diferentes respuestas, puede utilizar la función de simulación en
un operador para probar respuestas de diferentes permutaciones de configuración y
valores.
Nota: Utilice funciones de ayuda variables (pulse Ctrl + barra espaciadora) para facilitar
la construcción de estas expresiones.
Puede editar un puerto personalizado en cualquier momento después de haberlo
agregado a un operador haciendo doble clic en el puerto. Si no puede predefinir la
forma de procedimiento de una condición de salida particular (por ejemplo, si se
produce un error al importar una base de datos), puede omitir un vínculo para ello.
Cuando ningún vínculo de salida no especifica ninguna condición de salida para un
operador, el proceso entra en estado de suspensión y en espera de una acción
correctora por parte del usuario.
Capítulo 4: Diseño de procesos 119
Bucles de proceso e iteraciones
Romper un vínculo para mejorar la lectura
Los vínculos se pueden enredar en un proceso complicado y abarrotar la vista. Si hay
muchos vínculos que atraviesan un área, o si se desea vincular un operador a través de
otras ramas a un operador a distancia, se puede romper un vínculo.
Nota: El vínculo en sí no se rompe; solamente la representación visual del vínculo. En
lugar de que una línea completa se sitúe entre dos operadores, la línea se divide en dos
símbolos de vínculo numerados coincidentes en los operadores fuente y de destino.
Lleve a cabo los pasos siguientes:
1.
Identifique el vínculo que se desea romper entre un operador fuente y un operador
de destino.
2.
Haga clic con el botón secundario en el vínculo y, a continuación, en Romper
vínculo.
El vínculo se rompe y se reemplaza por marcadores de vínculo coincidentes en
ambos extremos del vínculo. El vínculo dividido se comporta de la misma forma que
un vínculo que no se ha dividido.
Nota: Para volver a unir un vínculo roto, haga clic con el botón secundario en
cualquier marcador de vínculo y, a continuación, haga clic en Unir vínculo.
Bucles de proceso e iteraciones
La vigilancia, monitorización y otros procesos cíclicos a menudo se ejecutan
repetidamente. Estos ciclos se pueden controlar mediante bucles. Se pueden aplicar
uno o más métodos para ejecutar operadores en bucles:
■
Se puede ejecutar un operador en un ciclo o en un bucle hasta que se cumpla
alguna condición.
■
Se puede usar el operador Bucle para crear un bucle de la secuencia de los
operadores
■
Se puede ejecutar en bucle un proceso entero. Un proceso generado a partir de un
bucle puede consistir en varios operadores vinculados.
120 Guía del diseñador de contenido
Bucles de proceso e iteraciones
Variables de sistema para bucles
Se pueden crear variables de bucle personalizadas, y el usuario puede gestionarlas, o
usar las variables del sistema disponibles para los bucles incluidos con esta versión de
CA Process Automation.
Por ejemplo, podría crear lógica para calcular la duración desde la hora de inicio de la
primera iteración de un bucle hasta la hora actual de cada bucle. Incluso podría utilizar
código de ejecución previa y posterior para introducir datos en un bucle como
■
inicialización de variables
■
configuración de números de bucle
■
procesamiento de resultados cuando termina el bucle
En lugar de crear y actualizar sus propias variables de recuento de bucle, puede
aprovechar las variables de bucle incorporadas. El operador Bucle y cualquier otro
operador con valores de configuración de bucle son compatibles con las variables de
conjunto de datos siguientes:
■
CurrentLoopIteration
■
OverallLoopDuration
Utilice CurrentLoopIteration cuando necesite un contador de bucles estándar. La
variable CurrentLoopIteration contiene el valor 0 durante la primera iteración del bucle
e incrementa en 1 en el inicio o final de cada iteración adicional. Por ejemplo, si el
operador se configura para que funcione en bucle 3 veces, al final de la ejecución de
todas las iteraciones, CurrentLoopIteration es igual a 3. Específicamente, es 0 en la
primera iteración, 1 en la segunda iteración, 2 en la tercera iteración y 3 en la última
iteración. La última iteración no se ejecuta porque incumple la condición de bucle.
Utilice OverallLoopDuration cuando sea necesario ejecutar en bucle durante un período
de tiempo fijo; por ejemplo, para ejecutar en bucle durante un máximo de 5 minutos y a
continuación salir. Esta variable contiene el número de segundos entre el inicio de la
primera iteración del bucle y el final de la última iteración. OverallLoopDuration se
actualiza en el inicio y final de cada iteración de bucle. Incluye cualquier retraso
establecido entre iteraciones del bucle.
Nota: Las variables del sistema CurrentLoopIteration y OverallLoopDuration no se
pueden modificar. Aunque aparecen en el conjunto de datos de operador, sus valores
no cambian salvo que estén en un bucle (operador Recuento de repetición > 1).
Capítulo 4: Diseño de procesos 121
Bucles de proceso e iteraciones
Creación de un bucle de un operador en un proceso
Un método sencillo para crear un bucle en un proceso es configurar los parámetros
Bucle en un operador que sea compatible con la generación de bucles. Abra la paleta
Propiedades para el operador. En la sección Configuración de ejecución, en el campo
Recuento de repetición, introduzca el número de veces que el operador debe repetirse.
La opción Recuento de repetición es un campo calculado, de modo que se puede utilizar
una variable o expresión para especificar el recuento en tiempo de ejecución. Recuento
de repetición acepta un número entero (el número de veces que se ejecutará el bucle) o
un valor booleano (el bucle continúa mientras la condición se evalúe como verdadera).
Algunos ejemplos de entradas válidas serían:
3
Process.var < 3
Process.var == false
El operador se puede repetir indefinidamente seleccionando la casilla de verificación
Bucle infinito.
El indicador
Bucle aparece en los operadores que ha decidido ejecutar en bucle:
Se puede configurar el parámetro de bucle en el operador Iniciar proceso para ejecutar
un proceso repetidamente. Esto funciona bien en el caso de ejecutar en bucle pocas
iteraciones de un proceso y guardar una instantánea histórica del proceso para cada
bucle. No obstante, se debe evitar llamar a un proceso varias veces (como en un bucle
infinito) desde otro proceso. CA Process Automation guarda un historial de todas las
instancias de proceso. La acción de llamar a un proceso en un bucle infinito desde otro
proceso puede implicar el uso de una cantidad considerable de espacio en disco para
guardar datos irrelevantes.
122 Guía del diseñador de contenido
Bucles de proceso e iteraciones
El método preferido para ejecutar un proceso repetidamente consiste en crear un bucle
en forma cíclica dentro de un proceso. Cuando sea necesario, se puede guardar una
instantánea histórica de un proceso de generación de bucles al realizar una bifurcación
en un operador Iniciar proceso que inicia una nueva instancia separada del proceso
antes de ejecutar un operador Detener al final de la rama.
Se puede especificar el período de retención, o el período de tiempo del historial, en los
valores de configuración de la política en la biblioteca para un orquestador o su punto
de contacto asociado.
Nota: Si se establece un operador para que se ejecute en bucle con una acción de
tiempo de espera seguida de una acción de Restablecer, la condición de bucle se
comprueba al moverse de una iteración a otra, no al restablecer una iteración. La
variable OverallLoopDuration contiene el número de segundos desde el inicio de la
primera iteración, incluido el tiempo empleado en todas las iteraciones restablecidas.
Los restablecimientos de iteraciones de bucle no restablecen también
OverallLoopDuration.
Si se establece un operador para que se ejecute en bucle con una acción de tiempo de
espera seguida de una acción de Continuar, OverallLoopDuration contendrá el número
de segundos desde el inicio de la primera iteración hasta el final de la ejecución de la
última iteración. Si el operador agota el tiempo de espera, OverallLoopDuration no
contendrá el número de segundos desde el inicio de la primera iteración hasta el
momento en que el operador agota el tiempo de espera.
Capítulo 4: Diseño de procesos 123
Bucles de proceso e iteraciones
Interrupción de generación de bucles
Se puede interrumpir un operador en bucle agregando un vínculo de parada de otra
rama del proceso.
Lleve a cabo los pasos siguientes:
1.
Abra y extraiga un proceso.
2.
Cree un vínculo desde un operador en una rama independiente y asócielo a un
operador en bucle.
3.
Haga clic con el botón secundario en el vínculo y, a continuación, en Detener
vínculo.
El vínculo parece como una línea roja discontinua con un símbolo de detención rojo
cerca del operador en bucle.
4.
Haga clic en Guardar.
En el tiempo de ejecución, la rama separada alcanza el operador en bucle y se producen
las acciones siguientes:
■
El operador en bucle se ejecuta y se completa.
■
Se realizan las acciones posteriores a la ejecución para el operador.
■
El procesamiento ahora combinado de las dos ramas continúa en el operador
siguiente del proceso.
124 Guía del diseñador de contenido
Bucles de proceso e iteraciones
Creación de un bucle de elementos indexados de un campo Conjunto de datos
En lugar de utilizar las variables incorporadas del sistema CurrentLoopIteration y
OverallLoopDuration, pueden crear variables de bucle personalizadas y gestionarlas
usted mismo. Las versiones anteriores de CA Process Automation requerían este
método. Por ejemplo, podría crear lógica para calcular la duración desde la hora de
inicio de la primera iteración de un bucle hasta la hora actual de cada bucle. Incluso
podría utilizar código de ejecución previa y posterior para introducir datos en un bucle
como
■
inicialización de variables
■
configuración de números de bucle
■
procesamiento de resultados cuando termina el bucle
Para crear un bucle de todos los elementos de un campo de conjunto de datos
indexado, primero utilice un operador Ejecutar JavaScript en el grupo Utilidades para
inicializar el elemento CurrentIndex para el campo de conjunto de datos en 0. Por
ejemplo, la expresión siguiente inicializa el elemento CurrentIndex en la variable del
proceso X a 0:
Process.X.CurrentIndex=0;
Para crear un bucle de elementos indexados de un campo Conjunto de datos
1.
Conecte el vínculo de salida Correcto del operador Ejecutar JavaScript al operador
que se desea procesar en un bucle.
2.
En la paleta Conjunto de datos del operador que desea ejecutar en bucle, utilice la
configuración del elemento Tamaño para el campo indexado como el valor de
Recuento de repetición en la ficha Bucle. Por ejemplo:
Process.X.Size.
3.
Para aumentar la configuración de CurrentIndex después de haber completado
cada iteración del bucle, utilice una expresión de código de ejecución posterior. Por
ejemplo:
Process.X.CurrentIndex=Process.X.CurrentIndex+1;
En este caso, el elemento CurrentIndex es el recuento del bucle. Se puede utilizar la
configuración de CurrentIndex para acceder a elementos del campo indexado en
expresiones calculadas. Por ejemplo:
Process.X[Process.X.CurrentIndex];
Nota: Si está acostumbrado a lenguajes de programación, como Visual BASIC, que
utilizan matrices con base uno, recuerde que el campo de un conjunto de datos
indexado es una matriz con base cero. En las matrices con base uno, el primer
elemento se indexa con 1 y el último se indexa con la cantidad de elementos. El
primer elemento de un campo de conjunto de datos indexado se indexa con 0 y el
último elemento se indexa con un número menor que el valor del elemento
Tamaño del campo.
Capítulo 4: Diseño de procesos 125
Bucles de proceso e iteraciones
Además de acceder a elementos en un campo de conjunto de datos indexado, se puede
seguir el número de iteración durante el procesamiento de un bucle para otras
finalidades. Utilice una variable de proceso como process.i para la variable de índice. En
un operador Cálculo del módulo de interpretación que precede al operador en bucle,
inicialice la variable del proceso en su valor inicial. Por ejemplo, process.i=1. Para
aumentar la variable de índice después de haber completado cada iteración del bucle,
utilice una expresión en el código de ejecución posterior del operador. Por ejemplo:
Process.i=Process.i+1;
Nota: Los pasos de este tema no se consideran ya necesarios; sin embargo, se incluyen
como referencia con el código heredado. Si se utilizan las variables del sistema más
recientes, solamente se aplica el paso 2 y el paso 3 se reemplaza de la siguiente manera.
Utilice la variable CurrentLoopIteration del operador en bucle para acceder a elementos
del campo indexado en expresiones calculadas. Por ejemplo:
Process.X[Process[OpName].CurrentLoopIteration];
Indexación del recuento de bucle para otras finalidades
Se puede seguir el número de iteración durante el procesamiento de un bucle para
acceder a elementos en un campo Conjunto de datos indexado, o para otras finalidades.
Utilice una variable de proceso para la variable de índice (por ejemplo, process.i). En un
operador Cálculo del módulo de interpretación que precede al operador en bucle,
inicialice la variable del proceso en su valor inicial para el bucle:
Process.i=1;
Para aumentar la variable de índice después de haber completado cada iteración del
bucle, utilice una expresión en la ficha Acciones de ejecución posterior de las
propiedades del operador. Por ejemplo:
Process.i=Process.i+1;
Nota: Este tema no se considera ya necesario; sin embargo, se incluye como referencia
al trabajar con código heredado.
Errores y excepciones de bucle
Si se produce un error con respecto al código previo o posterior a la ejecución:
■
Los registros del proceso indican que la condición de ejecución previa o posterior
del operador Bucle no se ha ejecutado correctamente.
■
El indentificador de excepciones del proceso se dispara con una excepción de
anulación. La fuente y SourceROID señalan al operador Bucle.
126 Guía del diseñador de contenido
Bucles de proceso e iteraciones
Ejecución en bucle de serie de operadores
También se puede ejecutar en bucle una secuencia de operadores dentro de un
operador Bucle.
Lleve a cabo los pasos siguientes:
1.
Abra un proceso.
2.
Arrastre el operador Bucle desde el grupo de operadores Estándar hasta el proceso.
3.
Cambie de tamaño el cuadro delimitador del operador Bucle para alojar la
secuencia de operadores que se desea agregar al bucle.
4.
Arrastre los operadores al cuadro.
El color del cuadro delimitador cambia para indicar que se ha seleccionado como
destino para los operadores que se arrastren.
5.
Agregue puertos y vínculos.
6.
Vincule el punto de entrada del cuadro con el primer icono de la rama y vincule el
último icono con el puerto de salida del cuadro.
7.
Agregue vínculos desde y hasta el operador Bucle:
a.
Vincule al menos un operador fuera del cuadro con el puerto de entrada.
b. Conecte el puerto de salida con al menos un operador fuera del cuadro.
8.
Haga doble clic en el operador Bucle para ver sus propiedades.
Aparecerá la paleta Propiedades del operador Bucle. Si no aparece, elija
Propiedades en el menú Ver.
9.
Establezca las propiedades del bucle y haga clic en Aplicar.
Nota: Se puede crear una rama de generación de bucles infinitos seleccionando la
casilla de verificación Bucle infinito. Como con cualquier operador de bucle infinito,
se puede detener el bucle agregando un vínculo de parada desde otro operador.
Capítulo 4: Diseño de procesos 127
Bucles de proceso e iteraciones
Nota: Los valores para las variables de sistema CurrentLoopIteration y
OverallLoopDuration se actualizan para cada instancia de proceso y aparecen en el
conjunto de datos. Aunque se establezca Recuento de repetición en 1 para el
operador Bucle, CurrentLoopIteration muestra 1 y OverallLoopDuration muestra 10
al final de una instancia individual. En contraste, las variables de sistema
CurrentLoopIteration y OverallLoopDuration solamente se actualizan para otros
operadores cuando Recuento de repetición es mayor que 1. Esto es porque el
operador Bucle siempre se ejecuta en bucle, aunque sea solamente una vez.
Más información:
Interrupción de generación de bucles (en la página 124)
Bucles While y Do While
Use la casilla de verificación Mientras se encuentra en un bucle del operador Bucle para
gestionar el comportamiento del bucle. Si se selecciona, el operador Bucle se comporta
como un bucle while. Si no se selecciona, el operador Bucle se comporta como un bucle
do-while.
Algunos operadores Bucle existentes en el contenido desarrollado antes de actualizar a
CA Process Automation 4.0 tendrán el campo Mientras se encuentra en un bucle
desactivado. Se continuarán comportando como bucles do-while. Estos operadores
Bucle se pueden convertir en bucles while activando la casilla Mientras se encuentra en
un bucle.
Las dos diferencias principales entre los operadores Bucle while y do-while son:
■
Los bucles while comprueban la condición del bucle especificada en el campo
Recuento de repetición antes de ejecutar la primera iteración y antes de cada
iteración subsiguiente.
■
Los bucles do-while comprueban la condición del bucle especificada en el campo
Recuento de repetición al final de cada iteración, así se garantiza ejecutar siempre
como mínimo la primera iteración del bucle.
Nota: Un operador Bucle se puede configurar para comportarse como un bucle while o
do-while. Los demás operadores que permiten la ejecución en bucle sólo se pueden
comportar como bucles do-while.
128 Guía del diseñador de contenido
Bucles de proceso e iteraciones
La secuencia lógica de un operador Bucle
Los campos Código de ejecución previa y Código de ejecución posterior están
disponibles en las propiedades del operador Bucle. En estos campos se puede introducir
código de JavaScript para ejecutarse con cada iteración del bucle. CA Process
Automation ejecuta cualquier código de ejecución previa o posterior de un operador
Bucle para cada iteración del bucle.
Nota: En el contenido desarrollado antes de la actualización a CA Process Automation
4.0, los operadores Bucle mostrarán los campos Código de ejecución previa y Código de
ejecución posterior vacíos.
La secuencia de procesamiento de cualquier condición previa y posterior depende del
tipo de bucle.
Operadores Bucle while:
1.
Ejecutar condición previa.
2.
Compruebe la condición de bucle while tal y como se indica en el campo Recuento
de repetición.
■
Si la condición del bucle se realiza correctamente:
a.
Restablezca los operadores que hay dentro del operador Bucle.
b. Ejecute los operadores que hay dentro del operador Bucle.
c.
Ejecute la condición posterior al final de la iteración del bucle.
d. Vuelva al paso 1.
■
Si la condición del bucle falla:
Salga del operador Bucle sin ejecutar la condición posterior y, a continuación,
ejecute el operador siguiente después del operador Bucle.
Operadores Bucle do-while:
1.
Restablezca los operadores que hay dentro del operador Bucle.
2.
Ejecute la condición previa.
3.
Ejecute los operadores que hay dentro del operador Bucle.
4.
Ejecute la condición posterior.
5.
Compruebe la condición de bucle do-while tal y como se indica en el campo
Recuento de repetición.
■
Si la condición de bucle se realiza correctamente, vuelva al paso 1.
■
Si la condición de bucle falla, salga del operador Bucle y, a continuación,
ejecute el operador siguiente después del operador Bucle.
Capítulo 4: Diseño de procesos 129
Bucles de proceso e iteraciones
Ejecución de un proceso en bucle
Para ejecutar un proceso muchas veces, cree una rama cíclica en un objeto de proceso
en lugar de utilizar el operador Iniciar proceso para llamar a un proceso repetidamente
desde otro. Este método implica ejecutar en bucle un proceso cíclicamente colocando
dos operadores Iniciar. Se coloca un operador Iniciar en el principio y otro operador
Iniciar en el final.
Lleve a cabo los pasos siguientes:
1.
Abra y extraiga un proceso.
2.
Coloque los operadores siguientes:
a.
Iniciar
b. Detención correcta
c.
Error al detener
d. Una serie de operadores que desea repetir.
3.
Agregue un operador Iniciar en el punto de la secuencia donde termina y donde se
desea reiniciar la rama.
4.
Vincule el último operador de la rama con el segundo operador Iniciar. El operador
Iniciar tiene un vínculo de entrada que permite que se le ubique al final de una
secuencia de pasos.
Nota: Cuando la secuencia de procesamiento llega al segundo operador Iniciar que
se muestra en la figura, reinicializa todos los operadores y reinicia el proceso.
5.
Para interrumpir este tipo de proceso cíclico, incorpore lógica que conduzca fuera
de la rama cíclica. Agregue un puerto de salida en un operador que puede conducir
directamente a un operador Detener o que pueda conducir a una rama diferente.
130 Guía del diseñador de contenido
Bucles de proceso e iteraciones
Daemons y otros procesos en bucle
Para ejecutar un proceso muchas veces, cree una rama cíclica en un objeto de proceso
en lugar de utilizar el operador Iniciar proceso para llamar a un segundo proceso
repetidamente. Un proceso cíclico se ejecuta en un bucle infinito. Cada iteración no crea
nuevas instancias del objeto de proceso. La ventaja principal de la implementación de
una rama cíclica es que la lógica que sale del bucle está en el propio proceso. El proceso
no depende de factores externos en un proceso padre. El proceso se ejecuta como un
objeto autónomo.
Estos son algunos ejemplos de procesos en bucle que se ejecutan indefinidamente:
■
Procesos en bucle continuo para controlar el uso del sistema o de la red
■
Consulta del estado de los componentes de las redes o el sistema
■
Organización y comprobación de eventos o mensajes
■
Daemons
■
Servicios
Ejemplo de proceso en bucle
Elemen Descripción:
to:
Operador Iniciar 1: empiece el proceso con un operador Iniciar estándar.
Capítulo 4: Diseño de procesos 131
Control del proceso
Elemen Descripción:
to:
Operador Iniciar proceso: diseñe una secuencia de operadores que represente la funcionalidad que
desea repetir o ejecutar en bucle. Esta rama puede incluir incluso un operador Iniciar proceso para
iniciar instancias de un segundo proceso.
Operador Iniciar 2: el operador Iniciar tiene un vínculo de entrada opcional. Cuando el proceso fluye al
segundo operador Iniciar, reinicializa todos los otros operadores y reinicia el proceso de nuevo en el
operador Iniciar 1.
Puerto y vínculo de salida: para salir de esta secuencia en bucle, especifique una condición de salida.
Nota: Otro método para interrumpir un proceso cíclico es utilizar una rama
independiente con su propio operador Iniciar. La rama puede esperar a que la parte en
bucle del proceso cambie una variable o libere un recurso. Después de que se produzcan
todos estos eventos, la rama independiente se ejecuta; por ejemplo, envía una alerta de
correo electrónico o procesa un operador Detener.
Control del proceso
Los procesos complejos a menudo requieren una jerarquía de subprocesos. En la
programación tradicional, la funcionalidad es modular. Los equipos descomponen la
complejidad en procedimientos, métodos o bibliotecas que se pueden utilizar
repetidamente. De modo similar, en CA Process Automation existen métodos para
simplificar los procesos complejos. Se pueden modelar procesos subordinados como
ramas o como procesos independientes. Se puede invocar un proceso subordinado o
hijo independiente desde un proceso padre a través de un operador Iniciar proceso. Por
ejemplo, un proceso padre que gestiona los sistemas informáticos de un banco puede
incorporar los siguientes procesos hijo mediante operadores Iniciar proceso:
■
Durante cada día hábil, procesar pagos de facturas automáticos.
■
Durante cada noche, realizar una copia de seguridad diaria.
■
Al final de cada día, procesar y verificar cheques.
■
Al final de cada mes, calcular el interés de las cuentas.
Los procesos subordinados definen procesos hijo lógica o físicamente claros dentro de
un sistema. La estructura de un proceso padre sincroniza los procesos hijo, gestiona los
recursos que se comparten entre procesos y define el tratamiento de los errores y las
dependencias entre procesos en una escala que abarca todo el sistema.
132 Guía del diseñador de contenido
Control del proceso
Procesos hijo
Utilice el operador Iniciar proceso para iniciar un proceso secundario o hijo desde una
instancia en ejecución de un proceso primario o padre. El operador Iniciar proceso inicia
una nueva instancia de proceso en un punto de contacto especificado. El operador
Iniciar proceso inicia variables del proceso asociadas a la nueva instancia.
El operador Iniciar proceso puede iniciar una nueva instancia de un proceso en el modo
adjunto, separado o como un proceso en línea:
■
Modo adjunto: el proceso que inicia la nueva instancia se denomina proceso padre.
La nueva instancia se denomina proceso hijo. La aplicación termina de procesar la
nueva instancia completa. Un proceso hijo que finaliza su flujo en el modo adjunto
puede copiar los valores del conjunto de datos en el conjunto de datos de proceso
padre de llamada.
Si un proceso padre activa un operador Detener en una rama antes de que un
proceso hijo active su propio operador Detener, la instancia padre puede finalizar
antes que la instancia hijo.
■
Modo separado: el operador Iniciar proceso inicia una nueva instancia de proceso
hijo que se comporta como si no tuviera elemento padre. En el modo separado, el
workflow que inicia una nueva instancia de otro proceso se completa
inmediatamente después de haber puesto en cola la solicitud de inicio. Un proceso
que finaliza en el modo separado no puede copiar sus valores de conjunto de datos
en el conjunto de datos en el proceso de llamada padre.
■
Proceso en línea: el proceso hijo se ejecuta como una instancia separada. Un
proceso padre tiene control limitado sobre el proceso hijo. El proceso hijo en línea
se vincula fuertemente al proceso padre con acceso al contexto padre y su ciclo de
vida, como la creación de instancias o el archivado. No se puede ejecutar un
proceso en línea en el modo separado.
Capítulo 4: Diseño de procesos 133
Control del proceso
Configuración de un proceso hijo
Configure el operador Iniciar proceso en un proceso padre para controlar el
comportamiento del proceso hijo que está iniciando.
Lleve a cabo los pasos siguientes:
1.
Abra y extraiga un proceso en el Diseñador de procesos.
2.
En la paleta Operadores, expanda Control del proceso y arrastre un operador Iniciar
proceso a su proceso.
3.
Haga doble clic el operador Iniciar proceso para ver sus propiedades en la paleta
Propiedades.
4.
Expanda el grupo Iniciar proceso.
5.
En el campo Nombre de proceso, introduzca la ruta completa al proceso.
6.
En el campo Código de inicialización del conjunto de datos de proceso, haga clic en
el botón Examinar indicado mediante ... (puntos suspensivos) para abrir el cuadro
de diálogo de generación de scripts completo.
7.
Introduzca declaraciones de JavaScript para inicializar variables en el conjunto de
datos de proceso hijo que está iniciando. En este contexto, la palabra clave process
hace referencia al conjunto de datos de proceso de la nueva instancia que se inicia.
La palabra clave Autor de llamada hace referencia al conjunto de datos de la
instancia padre que contiene el operador Iniciar proceso. Este contexto es el único
en el que la palabra clave Caller está disponible. Este contexto también es el único
en que la palabra clave Proceso no hace referencia al proceso que contiene un
operador.
■
Proceso padre: Proceso A
■
Proceso hijo: Proceso B
■
El operador Iniciar proceso en A inicia el proceso hijo B
■
La inicialización del conjunto de datos local B ocurre con el conjunto de datos A
como autor de la Llamada
Las palabras clave Process y Caller son obligatorias para hacer referencia a las
variables del conjunto de datos de proceso padre o hijo. Si omite ambas palabras
clave en un nombre de variable, la aplicación busca una variable de ámbito de
cálculo. No busca una variable con un nombre similar en el conjunto de datos padre
o hijo. Por ejemplo, el código siguiente produce un error si no se creó
anteriormente una variable de ámbito de cálculo X en el cuadro de diálogo Script
local:
Process.X = Caller.X;
Process.Y = X + 100;
8.
Haga clic en Guardar para cerrar el cuadro de diálogo de código de inicialización.
9.
En el campo Modo, seleccione Adjunto, Separado o En línea.
134 Guía del diseñador de contenido
Control del proceso
Si selecciona Separado, el campo Fecha de inicio se habilita. Especifica la fecha en la
que comienza la instancia separada del proceso. El valor predeterminado es la fecha
en la que se ejecuta el operador, indicada como System.Date. Similarmente, el
campo Hora de inicio especifica la hora en la que comienza la instancia separada. El
valor predeterminado es System.Time.
Nota: Las versiones anteriores de esta aplicación incluían operadores Ejecutar proceso
independientes para el modo adjunto y el modo separado. En realidad, ambos
operadores desempeñaban la misma función. La única diferencia era que en el operador
Ejecutar proceso, se desactivaba inicialmente la casilla de verificación Separar después
del inicio o después de poner la solicitud en cola. En el operador Ejecutar proceso
separado, la casilla de verificación se seleccionada desde el principio. En cualquiera de
ambos casos, se podía activar o desactivar la casilla de verificación Separar después del
inicio o después de poner la solicitud en cola en cualquier momento después de poner
el operador Ejecutar proceso para cambiar el modo en el cual se iniciaba. En esta
versión, todos estos operadores se importan como operadores Iniciar proceso.
Capítulo 4: Diseño de procesos 135
Control del proceso
Inicialización de las variables del proceso hijo con las palabras clave del autor de la llamada y
del proceso
Para introducir un script que permita inicializar variables del proceso en el proceso hijo,
haga clic en el botón Examinar del Código de inicialización del conjunto de datos del
proceso para abrir el cuadro de diálogo Script del proceso. En el cuadro de diálogo Script
del proceso, se pueden introducir sentencias JavaScript para inicializar variables en el
conjunto de datos del proceso que está iniciando.
Palabra clave Proceso
Hace referencia al Conjunto de datos del proceso de la nueva instancia que se está
iniciando. Este contexto es el único en el que la palabra clave Proceso no hace
referencia al proceso que contiene un operador.
Palabra clave Autor de llamada
Hace referencia al Conjunto de datos de la instancia padre que contiene el operador
Ejecutar proceso. Este contexto es el único en el que la palabra clave Caller está
disponible.
En el cuadro de diálogo Script del proceso, las palabras clave Process y Caller son
obligatorias para hacer referencia a las variables del conjunto de datos del proceso
padre o hijo. Si omite ambas palabras clave en un nombre de variable en el cuadro de
diálogo Script del proceso, el módulo de interpretación busca una variable de ámbito de
cálculo. El Módulo de interpretación no busca una variable con nombre similar en el
conjunto de datos padre ni hijo. Por ejemplo, el código siguiente produce un error si no
se creó anteriormente una variable de ámbito de cálculo X en el cuadro de diálogo
Script local:
Process.X = Caller.X;
Process.Y = X + 100;
136 Guía del diseñador de contenido
Control del proceso
Devolución de variables del conjunto de datos al proceso padre
Se puede acceder al conjunto de datos de un proceso hijo completado usando una
expresión en el proceso padre. El nombre del operador Iniciar proceso hace referencia
al conjunto de datos de proceso hijo en el conjunto de datos local del proceso padre. El
código siguiente en el proceso padre hace referencia a una variable del conjunto de
datos de un proceso hijo:
Process.Operator_Name.Field_Name
Operator_Name representa el nombre del operador Iniciar proceso en el proceso padre
y Field_Name es la variable del conjunto de datos a la cual se desea acceder en el
proceso hijo.
Esto sólo funciona para procesos iniciados en el modo adjunto. Los procesos iniciados
en el modo separado se convierten en el proceso de raíz de una secuencia de llamadas y
no copian sus conjuntos de datos en el proceso que los inició.
Inicio de procesos de manera recursiva
Además del uso de memoria, no hay ninguna restricción en el número de procesos que
se pueden iniciar en una cadena. Un proceso incluso puede iniciar otra instancia de sí
mismo de manera recursiva.
Evite llamar a procesos de manera recursiva en el modo adjunto, ya que hacerlo puede
generar una cadena de llamadas infinita. Sin embargo, a menudo es útil que un proceso
inicie otra instancia de sí mismo en el modo separado. Por ejemplo, se puede guardar
una imagen de un proceso de monitorización en un cierto estado, y continuar
ejecutando el proceso. En este caso, el proceso de monitorización puede iniciar una
nueva instancia de sí mismo en el modo separado y, a continuación, ejecutar un
operador Detener para finalizar. Luego, la instancia finalizada se guarda y un
administrador la puede examinar en su estado predefinido.
Proceso en línea
El operador Iniciar proceso se utiliza para invocar procesos hijo. El proceso hijo que se
invoca se ejecuta como una instancia separada. Un proceso padre tiene control limitado
sobre el proceso hijo y puede conducir a una sobrecarga de rendimiento en tiempo de
ejecución.
El modo en línea le permite ejecutar un proceso hijo y expandirlo en el proceso padre.
Un proceso hijo en línea tiene acceso al contexto padre. El ciclo de vida del hijo en línea,
incluidos la creación de instancias o el archivado, se vincula fuertemente al padre.
CA Process Automation permite a los usuarios decidir si desean ejecutar el proceso
como un proceso en línea.
Capítulo 4: Diseño de procesos 137
Control del proceso
Configuración de un proceso en línea
Se puede ejecutar un operador de proceso para ejecutar un proceso hijo en el modo en
línea.
Lleve a cabo los pasos siguientes:
1.
En la paleta Propiedades del operador Iniciar proceso, haga clic en el botón
Explorador de objetos (...).
Aparece el explorador de objetos.
2.
Seleccione el proceso hijo.
3.
En el campo Modo, seleccione En línea.
El proceso hijo se configura para ejecutarse como un proceso en línea.
4.
Active la casilla de verificación Heredar identificador de cambio de carril del proceso
padre.
Los identificadores de cambio de carril del proceso padre se cargan para el proceso
hijo.
Nota: La casilla de verificación Heredar identificador de cambio de carril del proceso
padre se activa únicamente para procesos hijos en línea. CA Process Automation
evalúa el proceso hijo cuando se inicia el proceso padre. El proceso hijo en línea se
carga y expande en el proceso padre.
138 Guía del diseñador de contenido
Control del proceso
Vista de un proceso hijo en línea
Se puede ver un proceso hijo en línea en tiempo de ejecución mediante uno de los
métodos siguientes:
■
En el Diseñador, haga clic en el icono con el signo más en el lado derecho superior
del operador de Iniciar proceso en la instancia padre.
■
En el Diseñador, haga clic en la lista desplegable Jerarquía y seleccione un proceso
hijo que aparezca debajo del proceso padre.
■
En la página Operaciones, haga clic en una instancia padre.
El gráfico siguiente muestra estos tres métodos.
Capítulo 4: Diseño de procesos 139
Carriles de proceso
Carriles de proceso
Los carriles de un proceso, a menudo llamados simplemente carriles, permiten dividir el
proceso en partes lógicas diferentes. El diseñador de procesos permite agregar, insertar,
cambiar de tamaño y eliminar carriles. Se pueden definir reglas que se activan cuando
los vínculos entre pasos de un proceso cruzan un límite entre carriles. Las reglas definen
pasos adicionales para ejecutar cuando el procesamiento cruza límites de carriles.
Los operadores de un proceso se organizan visualmente en uno o varios carriles. Las
líneas paralelas muestran los límites de los carriles. La orientación predeterminada del
carril de un proceso nuevo es vertical. En principio, un proceso nuevo tiene un solo
carril, etiquetado Lane_0. Los carriles adicionales se nombran en secuencia a medida
que se agregan: Lane_1, Lane_2 y así sucesivamente. Los nombres se pueden
personalizar para organizar las ramas de un proceso de una forma lógica para usted.
Cuando hay varios carriles en un proceso, se pueden definir reglas de cambio de carril.
Estas reglas especifican secuencias de operador que se invocan solamente cuando la
ejecución de un proceso atraviesa dos carriles. Una regla de cambio de carril se parece a
cualquier secuencia de operadores en la ficha Editor principal, excepto que cada regla
empieza con un operador Cambiar carril en lugar del operador Iniciar. Las propiedades
del operador Cambiar carril definen la transición entre los carriles fuente y de destino
que invocan la secuencia de operadores vinculados al operador Cambiar carril.
Se puede agregar cualquier número de carriles en la ficha Editor principal y, a
continuación, formar vínculos que crucen los límites de los carriles entre los operadores
del proceso. Luego, en la ficha Identificador de cambio de carril, se pueden definir
secuencias de operadores invocados cuando la ejecución cruza los límites. Cuando la
ejecución de un proceso cruza el límite de un carril, invoca un proceso en el
identificador de cambio de carril que se define para que se produzca para la transición
particular (por ejemplo, del carril A al carril B).
Si se define más de una regla para una transición particular, la aplicación utiliza la
primera regla existente en el orden de prioridad que se indica a continuación:
Prioridad
Coincidencias y ejecuciones
1
Regla definida para carriles fuente y de destino específicos (A a B)
2
Regla definida para un carril fuente específico (A a cualquiera)
3
Regla definida para un carril de destino específico (cualquiera a B)
4
Regla definida para dos carriles cualesquiera (cualquiera a cualquiera)
5
No se aplica ninguna regla si no existe ninguna de las coincidencias antes mencionadas.
140 Guía del diseñador de contenido
Carriles de proceso
Si no hay reglas de cambio de carril definidas en el objeto de proceso para la instancia
actual de un proceso, la aplicación busca una regla de cambio de carril coincidente en el
objeto del proceso predeterminado especificado en los valores de configuración de
propiedades del orquestador. Esto sucede solamente si no hay reglas de cambio de
carril definidas en el objeto del proceso actual. La aplicación no comprueba el objeto del
proceso predeterminado si hay una regla de cambio de carril definida en el objeto del
proceso actual, aun cuando no se produce ninguna coincidencia.
Cuando el procesamiento cruza una transición entre carriles, la aplicación:
■
Suspende el proceso después de haber completado los operadores en ejecución.
■
Intenta hacer coincidir una regla definida en el objeto del proceso o en el proceso
predeterminado para el orquestador en el orden siguiente:
Reglas de cambio de carril
Coincidencias
Acción
Se definen en el objeto del
proceso
Una regla en el objeto del proceso en
el orden de prioridad antes
mencionado
Ejecute la regla definida en el objeto
del proceso.
No se definen en el objeto del
proceso
Una regla en el objeto del proceso
predeterminado para el orquestador
en el orden de prioridad antes
mencionado
Ejecute la regla definida en el objeto
del proceso predeterminado.
Ninguna coincidencia
Ignore la transición.
A continuación, la aplicación sigue procesando el proceso.
Creación de carriles horizontales o verticales
Los carriles se orientan horizontal o verticalmente como se hayan configurado en las
propiedades del proceso. Seleccione la orientación de los carriles antes de comenzar a
agregar operadores a un proceso. Se debe configurar la orientación antes de agregar
más carriles a un proceso, dado que no se puede cambiar la orientación de varios
carriles en un proceso.
Lleve a cabo los pasos siguientes:
1.
Abra y extraiga un proceso.
2.
En el diseñador de procesos, haga clic en Propiedades.
3.
En la paleta Propiedades del proceso, expanda la sección Configuración.
4.
En Orientación del carril, haga clic en Horizontal o Vertical.
5.
Haga clic en Aplicar.
Capítulo 4: Diseño de procesos 141
Carriles de proceso
Gestión de carriles
El diseñador de procesos permite agregar, insertar, cambiar de tamaño y eliminar
carriles.
Para agregar un nuevo carril a la derecha de los carriles orientados verticalmente o al
final de los carriles orientados horizontalmente:
1.
En el panel Editor principal del Diseñador de procesos, haga clic con el botón
secundario en el panel del proceso.
2.
Haga clic en Carriles, Agregar carril.
Nota: Alternativamente, se puede hacer clic en el botón Agregar carril en la barra
de herramientas.
Se agregar un nuevo carril al panel Editor principal.
Para insertar un carril en cualquier otro sitio en el panel Editor principal:
1.
En el panel Editor principal del Diseñador de procesos, clic con el botón secundario
en el carril adyacente al lugar donde desea agregar el nuevo carril.
2.
Haga clic en Carriles, Insertar carril, seleccione Insertar carril a la izquierda o
Insertar carril a la derecha.
Se inserta un nuevo carril.
3.
Si los carriles se orientan horizontalmente, haga clic en Insertar carril encima o
Insertar carril debajo.
Se inserta un carril por encima o por debajo del carril existente según su selección.
4.
Para cambiar de tamaño un carril existente, haga clic en la línea divisoria entre los
carriles y arrástrelo a la izquierda o a la derecha para carriles dispuestos
verticalmente o arriba o abajo para carriles dispuestos horizontalmente.
Nota: El ancho mínimo de un carril es de 50 pixeles.
Se puede eliminar el carril de un proceso combinándolo con un carril existente. Un carril
se puede combinar con otro ubicado a la izquierda o a la derecha de un carril orientado
verticalmente o con otro ubicado por encima o por debajo de un carril orientado
horizontalmente.
Para eliminar un carril de un proceso
1.
En el panel Editor principal del Diseñador de procesos, haga clic con el botón
secundario en el carril que desea suprimir.
2.
Haga clic en Carriles, Combinar carriles, y seleccione Combinar con izquierda o
Combinar con derecha.
Nota: Si los carriles se orientan horizontalmente, haga clic en Combinar carril con el
carril de encima o Combinar carril con el carril de abajo para combinarlos.
142 Guía del diseñador de contenido
Carriles de proceso
Reglas de tratamiento de carriles
Cuando un proceso contiene varios carriles, se pueden definir reglas de cambio de carril.
Estas reglas especifican secuencias de operador que se invocan solamente cuando la
ejecución de un proceso atraviesa el límite de un carril. Cada regla se define para que se
produzca para una de las transiciones siguientes entre carriles:
■
De un carril específico a otro carril específico (del carril A al carril B)
■
De un carril específico a cualquier otro carril (del carril A a cualquier carril)
■
De cualquier carril a un carril específico (de cualquier carril al carril B)
■
De cualquier carril a cualquier otro carril (de cualquier a cualquier carril)
Las reglas de cambio de carril tienen el mismo aspecto que cualquier secuencia de
operador en la ficha Editor principal, excepto por el hecho de que cada regla empieza
por un operador Cambiar carril en lugar de un operador Iniciar. Las propiedades del
operador Cambiar carril definen la transición entre los carriles fuente y de destino que
invocan la secuencia de operadores vinculados al operador Cambiar carril.
Lleve a cabo los pasos siguientes:
1.
En la parte inferior del diseñador de procesos, seleccione la ficha Identificador de
cambio de carril.
2.
En el grupo Estándar de la paleta Operadores, arrastre un operador Cambiar carril
hasta el panel Identificador de cambio de carril.
3.
Haga doble clic en el icono Cambiar carril. A continuación, haga clic en Propiedades,
en el panel Cambiar carril.
4.
En el campo Nombre, escriba un nombre para identificar la regla.
5.
Para Origen y Destino, seleccione la combinación de carriles que activa la regla.
6.
Haga clic en Aplicar.
7.
En la paleta, arrastre más operadores hasta el proceso que completa la regla para la
transición y configure cada uno de ellos según sea necesario.
8.
En la barra de herramientas, haga clic en el botón Guardar.
Se completó la nueva regla de transición.
Capítulo 4: Diseño de procesos 143
Versiones de proceso
Versiones de proceso
CA Process Automation siempre ejecuta la copia incorporada de la versión actual de un
objeto de proceso. Cuando el orquestador empieza a ejecutar la versión actual de un
objeto de proceso, crea una copia de esa versión del proceso en la biblioteca de
automatización. El sistema procesa operadores en una instancia y crea o hace referencia
a variables del conjunto de datos de proceso dentro de la instancia. Los cambios
realizados en una instancia de un proceso no afectan a la definición básica de éste. Para
acceder a las definiciones básicas, se debe utilizar el explorador de bibliotecas. Para ver
o editar la definición básica y las instancias de la versión de un proceso, se debe utilizar
el diseñador de procesos.
Documentación de un proceso
Se puede generar documentación del proceso. La documentación del proceso puede
incluir un gráfico sobre el diseño del proceso tal y como aparece en el lienzo en la ficha
Diseñador.
Utilice comentarios, sus propios nombres de operador y etiquetas del objeto para
completar la documentación del proceso que va a generar. Los comentarios, los
nombres y las etiquetas apropiados ayudan a los demás diseñadores a entender qué
hace su proceso y cómo está construido. Al insertar comentarios en un proceso, se
proporcionan detalles sobre las cadenas, los procesos o las regiones de un proceso. Los
comentarios del proceso permanecen fijos en él. No se deben utilizar comentarios para
etiquetar operadores específicos, dado que estos cambian de ubicación con frecuencia
en el espacio de trabajo para adaptarse a vínculos y a otros operadores. En lugar de ello,
se debe utilizar la propiedad Nombre de las propiedades de información del operador
específico para etiquetarlo.
Más información:
Generación y uso de documentación de procesos (en la página 461)
144 Guía del diseñador de contenido
Documentación de un proceso
Agregar comentarios a un proceso
Utilice el operador Comentario en el grupo Estándar de la paleta Operadores para
agregar comentarios a un proceso. Se puede cambiar la cadena de propiedad Nombre
del operador. Los comentarios son importantes para documentar pasos en un proceso y
ofrecen más espacio que las etiquetas.
Para agregar un comentario a un proceso
1.
Arrastre un operador Comentario desde el grupo Estándar al proceso.
Un objeto de comentario aparece con el nombre predeterminado Comentario.
2.
Haga doble clic en el comentario para mostrar el cuadro de diálogo Propiedades de
los comentarios.
3.
Reemplace el texto original del comentario con el texto que desea que aparezca en
el lienzo.
Se pueden cambiar el color de fondo, el formato del texto y la alineación.
4.
Haga clic en Aceptar para aplicar los cambios.
5.
Haga clic en Guardar para guardar su diseño de proceso.
Establecimiento del nombre de un operador en un proceso
La propiedad Nombre del operador identifica al operador colocado en un proceso. Las
expresiones utilizan el nombre para acceder al conjunto de datos del operador en el
formato:
Process.operator_name.field_name
De forma predeterminada, la propiedad Nombre se utiliza también para etiquetar un
operador del diseñador de procesos cuando se selecciona la opción Información de
icono para un proceso.
Cuando agrega un operador al proceso, se genera un nombre predeterminado, el cual
indica la tarea que realiza el operador. Se puede cambiar este texto para proporcionar
más información significativa o específica acerca del operador relacionado con el
sistema.
Para cambiar el nombre de un operador
1.
Haga doble clic en un operador de un proceso o haga clic en el operador y elija
Propiedades en menú Ver.
2.
En las propiedades de información en el panel Propiedades, en el campo Nombre,
introduzca una breve descripción del operador.
Los nombres de operador pueden estar compuestos por caracteres alfanuméricos y
el guión bajo (_).
Capítulo 4: Diseño de procesos 145
Contenido Self-Contained
Cambiar y mostrar información del operador en un proceso
El nombre se incluye en un campo de texto que opcionalmente etiqueta un operador en
un proceso. La propiedad Texto del operador define este campo. La opción Información
de operador en el menú Ver oculta o muestra este campo de texto junto a los
operadores de un proceso.
Para generar un valor predeterminado para la propiedad Texto, CA Process Automation
combina las configuraciones Nombre del operador y Parámetros del operador.
Lleve a cabo los pasos siguientes:
1.
Haga doble clic en un operador en un proceso.
2.
En el campo Nombre de las propiedades de Información, en la paleta Propiedades,
introduzca el texto que debe aparecer junto al operador en el proceso.
Nota: Utilice los otros valores de configuración de la ficha Información del panel
Propiedades para:
■
Especificar un icono personalizado en lugar del icono predeterminado para el
operador.
■
Anular las preferencias del objeto para el texto actualizado automática o
manualmente que se muestra con el operador.
■
Establezca la posición del texto, el color de fondo, el tipo de letra y la alineación.
Contenido Self-Contained
Se puede incrustar un diseño de proceso, instancia de tiempo de ejecución, objeto de
automatización o una vista concreta en otros productos e interfaces dinámicas
mediante URL designadas. Esta integración ofrece las siguientes funciones:
■
Otros equipos de desarrollo pueden adoptar productos y soluciones que
aprovechan CA Process Automation y que ofrecen vistas integradas en una página
de una ventana. Por ejemplo, como cliente, administrador o proveedor de servicios,
se pueden integrar partes específicas de la interfaz de usuario de CA Process
Automation en portales existentes como sitios web, intranets y repositorios de
Sharepoint.
■
Como diseñador de procesos puede construir un flujo de trabajo de proceso que
envíe correo electrónico con un vínculo directo a una tarea específica para que la
tarea se pueda aprobar directamente.
■
El contenido independiente facilitado por los vínculos de acceso directo a vistas
específicas permite ahorrar tiempo a la hora de acceder a información importante y
relevante.
146 Guía del diseñador de contenido
Contenido Self-Contained
Vínculos de contenido independiente
Los siguientes vínculos son compatibles con el contenido independiente en otras vistas,
marcos, partes Web o portales. También se puede enviar correo electrónico con estos
vínculos para ofrecer vistas directas de objetos concretos.
En lugar de [URL de servidor], utilice la URL para la implementación de CA Process
Automation:
http://servidor:puerto/itpam/Web.jsp
En lugar de <path>, especifique la ruta absoluta del objeto de automatización y su
nombre en el Explorador de bibliotecas:
/MyProjectFolder/Folder_1/MyStartForm
Nota: Estos vínculos distinguen entre mayúsculas y minúsculas.
Objetos de automatización:
Los objetos de CA Process Automation son direccionables mediante direcciones URL.
Estas direcciones URL "para arrancar" se pueden incrustar dentro de iFrame o portlets
de otros productos. Por ejemplo, se puede disparar un proceso y hacer que la interfaz
de usuario de seguimiento para esa instancia esté incrustada en un portlet
personalizado.
Formulario de solicitud de interacción
[Server URL]?page=Form&refPath=<path>
Formulario de solicitud de inicio
[Server URL]?page=Commander&refPath=<path>
Planificación
[Server URL]?page=Agenda&refPath=<path>
Calendario
[Server URL]?page=Calendar&refPath=<path>
Icono personalizado
[Server URL]?page=CustomIcon&refPath=<path>
Operador personalizado
[Server URL]?page=Template&refPath=<path>
Conjunto de datos
[Server URL]?page=Dataset&refPath=<path>
Paquete
[Server URL]?page=C2OPackage&refPath=<path>
Capítulo 4: Diseño de procesos 147
Contenido Self-Contained
Observación de procesos
[Server URL]?page=AppMonitor&refPath=<path>
Recurso
[Server URL]?page=Resources&refPath=<path>
Proceso
[Server URL]?page=processeditor&refPath=<path>
Otras entidades:
Observación de procesos (predeterminada)
Utilice el siguiente formato para acceder a la observación de procesos que aparece
en la ficha Operaciones:
[Server URL]?page=processwatch
Listas de tareas
Utilice el siguiente formato para acceder a todas las tareas que se ven en la ficha
Operaciones:
[Server URL]?page=tasklist&tasklist=alltasks
Utilice el siguiente formato para acceder a las tareas de grupo que se ven en la ficha
Operaciones:
[Server URL]?page=tasklist&tasklist=grouptasks
Utilice el siguiente formato para acceder a mis tareas, tal como se muestran en la
ficha Operaciones o en la ficha Página principal:
[Server URL]?page=tasklist
Instancias del proceso
Utilice este formato para acceder a una instancia de tiempo de ejecución de un
proceso en su propia ventana:
[Server URL]?page=runtimeeditor&ROID=<runtime_instance_ID>
Formularios
Utilice este formato para acceder al formulario de solicitud de inicio o al formulario
de solicitud de interacción que se utiliza para responder a una tarea:
[Server
URL]?ROID=<runtime_object_ID>&tasklist=ALL_TASK_FILTER
&page=replytask
Utilice este formato para acceder a una lista de instancias del formulario de
solicitud de inicio tal como se muestra en la ficha Operaciones:
[Server URL]?refPath=<path_to_SRF_object>&page=srflist
148 Guía del diseñador de contenido
Vaya a una parte específica de un proceso
Versiones de objeto
Para acceder a una versión incorporada específica de cualquier objeto de biblioteca
que no sea un proceso, añada el parámetro versionid a la dirección URL:
&versionid=<version_number>
Para, por ejemplo, acceder a la versión 3 del objeto MyResource:
[Server
URL]?page=Resources&refPath=/TestFolder/MyResource&versioni
d=3
Versiones de proceso
Para acceder a una versión incorporada específica de un proceso, añada el
parámetro version a la dirección URL:
&version=<version_number>
Para, por ejemplo, obtener acceso a la versión 4 del objeto MyProcess:
[Server
URL]?page=processeditor&refPath=/TestFolder/MyProcess&versi
on=4
Vaya a una parte específica de un proceso
Al trabajar con procesos largos, utilice la ventana de navegación para ayudarle a ajustar
su vista actual. Resulta más práctico reducir el tamaño de la vista que desplazarse por el
proceso completo en la ventana principal.
Lleve a cabo los pasos siguientes:
1.
Abra un proceso.
2.
En el diseñador de procesos, seleccione la ventana de navegación en el menú Ver.
La ventana de navegación muestra una imagen en miniatura de su proceso.
3.
Arrastre el marco rectangular por encima de la parte del proceso que se desea
consultar.
La ventana principal muestra una vista ampliada del área seleccionada.
4.
Para ajustar la vista en miniatura de su proceso, arrastre el cuadrado desde la
esquina inferior derecha.
5.
Para cambiar el tamaño de la paleta de navegación, arrastre cualquier borde o
esquina de la misma forma que cambiaría el tamaño de cualquier paleta.
Capítulo 4: Diseño de procesos 149
Arquitectura multicliente y CA Process Automation
Arquitectura multicliente y CA Process Automation
En una implementación multicliente, los administradores desean controlar el acceso del
usuario a instancias de procesos en función de un cliente o un conjunto de clientes. Se
pueden utilizar procesos de CA Process Automation comunes en varios clientes. Esta
función permite controles de acceso de instancias de procesos. Se puede impedir que
un usuario con acceso a un cliente acceda a una instancia relacionada con un cliente
diferente. Esta función también da lugar a una sincronizacion y duplicacion de procesos
mejorada, y reduce las tareas de mantenimiento relacionadas.
Se puede limitar el acceso a las instancias de procesos, según el acceso a un cliente,
utilizando procesos comunes en los clientes. Esto se logra configurando un ID de cliente
(como una nueva variable bien definida) como parte de una instancia de proceso. A
continuación se valida el acceso a ese ID de cliente cuando se solicita acceso a esa
instancia de proceso particular.
Nota: La configuración del ID de cliente es responsabilidad del diseñador de procesos
como parte del diseño del proceso o como parte de los parámetros de entrada al
proceso. El proceso que aún no haya establecido un ID de cliente debe consultar las
restricciones de control de acceso actuales según la definición del proceso.
150 Guía del diseñador de contenido
Arquitectura multicliente y CA Process Automation
Cómo hacer que un proceso esté al tanto de varios clientes
Hacer que un proceso existente esté al tanto de varios clientes implica los siguientes
pasos:
■
Agregar una variable relacionada con la seguridad al contexto de una instancia de
proceso en ejecución en tiempo de ejecución
■
Crear una política multicliente
Lleve a cabo los pasos siguientes:
1.
Para agregar una variable relacionada con la seguridad al contexto de una instancia
de proceso en ejecución en tiempo de ejecución, realice una de las acciones
siguientes:
■
Agregue una variable relacionada con la seguridad al contexto de una instancia
de proceso en ejecución en tiempo de ejecución usando JavaScript:
Process.SECURITY_CONTEXT_ID=<ID>;
Process.SECURITY_CONTEXT_GRP=[set the product group or family];
Por ejemplo:
Process.SECURITY_CONTEXT_ID="myid";
Process.SECURITY_CONTEXT_GRP="mygrp";
■
Transfiera valores a la instancia de proceso usando etiquetas <params>
mientras se inicia el proceso por medio del servicio Web executeProcess. Por
ejemplo:
<executeProcess xmlns="http://www.ca.com/itpam">
[assign the value for flow in your book]
…
<params>
<param name="SECURITY_CONTEXT_ID">myid</param>
<param name="SECURITY_CONTEXT_GRP">mygrp</param>
</params>
</executeProcess>
2.
Para crear una política para el multicliente, lleve a cabo los pasos siguientes:
a.
Agregue una política en EEM utilizando Objeto como el nombre de clase de
recursos.
b. Especifique las identidades para las cuales esta política es válida.
c.
Especifique Recursos para que esta política coincida con la ruta del proceso
para el que está creando la política.
d. Especifique las acciones necesarias de la política.
e.
Agregue filtros y especifique valores para los atributos con nombre Security
Context ID y Security Context Group.
Capítulo 4: Diseño de procesos 151
El Editor de código de CA Process Automation
Esta política se aplica a todas las instancias de procesos cuando los valores de los
atributos con nombre coinciden con los de la instancia de proceso en tiempo de
ejecución.
Seguridad heredada en los subprocesos
Los subprocesos heredan automáticamente los valores de los atributos de seguridad (es
decir, SECURITY_CONTEXT_ID y SECURITY_CONTEXT_GRP) del proceso padre.
Cómo agregar variables en tiempo de inicialización
Se pueden especificar nuevos valores en la opción Código de inicialización del conjunto
de datos de proceso del operador de servicio Ejecutar proceso. Los valores para el
contexto de seguridad especificados en el Código de inicialización del conjunto de datos
del proceso tienen prioridad sobre los valores especificados en el proceso padre.
Procesos multicliente utilizando la observación de procesos
Se pueden ver instancias de procesos en tiempo de ejecución mediante la observación
de procesos si una política multicliente lo permite. También se pueden llevar a cabo
acciones necesarias, como Abrir, Anular, Suspender, etc., si una política lo permite.
El Editor de código de CA Process Automation
El editor de código avanzado en CA Process Automation permite crear, editar y depurar
fácilmente código para diversos lenguajes de programación en las siguientes
ubicaciones:
■
El código de ejecución previa y ejecución posterior de un operador.
■
El parámetro de entrada del código fuente para el operador Ejecutar script.
152 Guía del diseñador de contenido
El Editor de código de CA Process Automation
■
El parámetro de entrada del código fuente para el operador Ejecutar JavaScript.
■
El parámetro de código de inicialización de datos para el operador Iniciar proceso.
■
Editores de script de formulario para el formulario de solicitud de interacción y
formulario de solicitud de inicio.
■
El parámetro de entrada del código fuente para el operador Invocar método SOAP.
■
El parámetro de entrada del código fuente para el operador Invocar método de
SOAP Async.
■
El parámetro de entrada del código fuente para el operador Apply XSLT (Aplicar
XSLT)
■
El parámetro de entrada del código fuente en algunos operadores personalizados
donde el operador base es uno de los operadores previamente mencionados.
El Editor de código admite los idiomas siguientes:
■
JavaScript (.js) (está disponible tanto para JavaScript del lado cliente como para
JavaScript del lado servidor)
■
XML (.xml)
■
SQL (.sql)
■
Java (.java)
■
Por lotes (.bat)
■
Archivo de comandos de Windows (.cmd)
■
Script de Virtual Basic (.vbs)
■
Valores de configuración de Windows Script Host (.wsh)
■
Archivo de PerlScript (.ps)
■
HTML (.html)
■
Shell (.sh)
Algunos operadores adicionales contienen editores de texto que utilizan la
funcionalidad del editor de código cuando procede. Cuando el idioma específico que se
ha utilizado en el operador es compatible con el editor de código y CA Process
Automation, sus editores de texto se adaptarán automáticamente al idioma
especificado. Específicamente, sus editores de texto resaltan palabras clave específicas
de idioma. Sin embargo, si los operadores utilizan un idioma que no es compatible con
el editor de código o que no se ha implementado en CA Process Automation, un editor
de texto sin formato estará disponible para codificar.
Si se incorpora un proceso, el Editor de código se inicia en el modo de sólo lectura y se
desactivan el editor y la barra de herramientas. Sin embargo, algunos botones de la
barra de herramientas (por ejemplo, Script validation (validación de Script), Buscar y
Ayuda) todavía están disponibles.
Capítulo 4: Diseño de procesos 153
El Editor de código de CA Process Automation
El Editor de código incluye las siguientes funciones:
Arrastrar y soltar
Arrastra cualquier archivo o texto seleccionado (desde dentro o fuera de CA Process
Automation) y lo suelta en el editor para rellenarlo.
Buscar/Reemplazar
Encuentre código específico (con las opciones de expresiones regulares y distinguir
entre mayúsculas y minúsculas) y, a continuación, reemplace instancias específicas
o todos los resultados.
Deshacer
Revierte la acción previa.
Rehacer
Revierte la acción previa Deshacer.
154 Guía del diseñador de contenido
El Editor de código de CA Process Automation
Ir a la línea número
Avanza a una línea especificada del código.
Volver a dar formato a la selección
Ajusta el sangrado del texto seleccionado.
Volver a formatear todo el documento
Ajusta el sangrado del documento de todo el código.
Importación de archivos
Busque un archivo específico para importarlo en el editor.
Entre los modos de editor compatibles con archivos importados se incluyen:
■
.bat
■
.cmd
■
/js
■
vbs
■
.wsh
■
.ps1
■
.sh
■
.pl
■
.xml
CA Process Automation proporciona un error si otras extensiones de archivo se
importan en el editor de código avanzado.
Nota: Cualquier tipo de archivo se puede importar para el editor genérico.
Exportar a archivo
Guarde el archivo en las descargas de CA Process Automation.
Mostrar registro de errores
Muestra los errores en el código. Esta función está solamente disponible en los
siguientes casos:
■
El código de ejecución previa y ejecución posterior de un operador.
■
El parámetro de entrada del código fuente para el operador Ejecutar JavaScript.
■
El parámetro de código de inicialización de datos para el operador Iniciar
proceso.
El editor marca el código incorrecto en un registro de errores desplazable en la
parte inferior del editor. Cada error contiene el número de línea y un hipervínculo
para ir a la línea específica del código. Cuando se corrige el error, el editor lo borra
automáticamente del registro de errores.
Capítulo 4: Diseño de procesos 155
El Editor de código de CA Process Automation
Nota: El código se debe introducir correctamente, en expresiones válidas. Sin
embargo, se puede guardar código incluso si contiene errores, aunque CA Process
Automation emitirá una advertencia. Se omiten algunas validaciones (como los
ejemplos siguientes):
"strict"
Espera Use Strict en la declaración de funciones de JavaScript.
"eqeqeq"
Espera === en lugar de == en la condición.
"smarttabs"
Valida una mezcla de fichas y espacios.
Pliegue de código
Cuando se hace clic en el número de línea de un {, el Editor de código pliega el
código hasta el paréntesis coincidente }.
Al editar XML, el pliegue de código se basa en las etiquetas coincidentes. Se puede
expandir o contraer el fragmento de XML basado en las etiquetas coincidentes. El
editor de código cierra automáticamente las etiquetas mientras usted edita.
El Editor de código también utiliza las convenciones siguientes:
■
Muestra los números de línea.
■
Elimina las líneas vacías.
■
Resalta el texto coincidente del documento cuando se selecciona texto específico.
■
Resalta la línea actual.
156 Guía del diseñador de contenido
El Editor de código de CA Process Automation
Codificación en colores
El Editor de código utiliza los colores siguientes para mostrar JavaScript:
Naranja
Indica:
■
Palabras clave del conjunto de datos para JavaScript del lado servidor
■
Variables de formulario para JavaScript del lado cliente
Ejemplo:
Azul
Indica las funciones del sistema de CA Process Automation. JavaScript del lado
cliente y del lado servidor tienen conjuntos diferentes de las funciones del sistema.
Ejemplo:
Morado
Indica las palabras clave de JavaScript.
Ejemplo:
Accesos directos
El Editor de código utiliza los accesos directos siguientes:
■
Ctrl+C (copiar)
■
Ctrl+V (pegar)
■
Ctrl+X (cortar)
■
Ctrl+Z (deshacer)
■
Ctrl+Y (rehacer)
■
Ctrl+A (Seleccionar todo)
■
Suprimir (para suprimir el texto seleccionado)
■
Página Inicio (ir al principio de la línea actual)
■
Página Inicio (ir al final de la línea actual)
Capítulo 4: Diseño de procesos 157
El Editor de código de CA Process Automation
Los accesos directos siguientes solamente son válidos para JavaScript:
■
■
Pulse Ctrl+Espacio para mostrar los elementos siguientes:
–
Una lista de palabras clave del conjunto de datos (que aparecen en primer
lugar) y las palabras clave de JavaScript del lado servidor.
–
Una lista de variables del formulario (que aparecen en primer lugar) y las
palabras clave de JavaScript del lado cliente.
Presione Ctrl+Alt para ver una lista de las funciones del sistema. JavaScript del lado
cliente y del lado servidor tienen conjuntos diferentes de las funciones del sistema.
Nota: En el Diseñador de formularios, solamente se puede utilizar JavaScript del
lado del cliente (para formularios de solicitud de inicio y formularios de solicitud de
interacción). Las funciones de sistema específicas de CA Process Automation no
están disponibles. Sin embargo, las funciones de los formularios están disponibles.
158 Guía del diseñador de contenido
Capítulo 5: Operadores e iconos
CA Process Automation lleva a cabo las instrucciones de los operadores que se agregan
a un proceso o a una planificación. En esta sección se describe cómo se configuran los
operadores después de que se hayan agregado a un objeto de proceso o planificación.
En esta sección también se incluye información sobre operadores personalizados y
conectores.
Esta sección contiene los siguientes temas:
Operadores (en la página 160)
Iconos de operadores (en la página 200)
Capítulo 5: Operadores e iconos 159
Operadores
Operadores
En una sección anterior de esta guía se ofreció una descripción de los operadores
Proceso (en la página 108). Para obtener más información sobre cada operador,
consulte la Guía de referencia del diseñador de contenido.
En esta sección se incluyen directrices generales sobre cómo configurar las propiedades
y trabajar con distintos tipos de operadores, entre ellos, los operadores personalizados.
Elemen Descripción:
to:
Barra de herramientas y fichas del diseñador: cuando se abre un proceso
nuevo o edita uno existente desde el explorador de bibliotecas, aparece la
ficha del diseñador. En la barra de herramientas, haga clic en Ver y seleccione
las paletas Operadores y Propiedades.
Paleta de operadores: busque operadores por carpeta o nombre.
Operadores personalizados en un grupo personalizado: arrastre un operador personalizado de esta
paleta y suéltelo en su diseño de proceso. Haga clic con el botón secundario del ratón en un operador
para agregarlo o eliminarlo del grupo de favoritos.
160 Guía del diseñador de contenido
Operadores
Elemen Descripción:
to:
Paleta Propiedades: utilice esta paleta y sus botones, vínculos y ventanas para gestionar las
propiedades del operador que esté seleccionado en ese momento. Expanda y contraiga los paneles
mientras trabaja. Cada panel está formado por propiedades similares.
Ventanas adicionales: algunas propiedades aparecen en sus propias ventanas.
También se trabaja con operadores para configurar planificaciones.
Elemen Descripción:
to:
Editor de planificaciones: cuando se abre una planificación desde el explorador de bibliotecas, aparece
el Editor de planificaciones. Utilice la barra de herramientas para activar, incorporar o guardar la
planificación, además de determinar su validez.
Panel Procesos: seleccione los procesos que se van a incluir y arrástrelos hasta la página Planificar
elementos.
Capítulo 5: Operadores e iconos 161
Operadores
Elemen Descripción:
to:
Proceso planificado en cola: defina la duración y la frecuencia de ejecución del proceso en un solo día.
Propiedades de proceso: haga clic en Propiedades para ver las propiedades del proceso en las fichas
General y Específico.
Panel Operadores: seleccione los operadores que se van a incluir y arrástrelos hasta la página Planificar
elementos.
Propiedades del operador: haga clic en Propiedades para ver las propiedades del operador en las fichas
General y Específico.
162 Guía del diseñador de contenido
Operadores
Configuración de propiedades del operador
Las propiedades del operador aparecen en el diseñador de procesos en la paleta
Propiedades. Se organizan campos similares en cuadros de grupo en paneles
expandibles con títulos familiares como Proceso, Configuración de ejecución, Simulación
e Icono. Algunos paneles y grupos son comunes para todos los operadores y otros son
únicos para un operador concreto. Por ejemplo, las propiedades de cada operador
incluyen un panel de iconos. El panel Datos asíncronos de llamada de SOAP, sin
embargo, solamente aparece para el operador Invocar método de SOAP Async.
Las propiedades del operador también están disponibles cuando se incluyen operadores
en objetos de planificación.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Abra un objeto de proceso o un objeto de planificación.
Los procesos se abren en el diseñador de procesos. Las planificaciones se abren en
el cuadro de diálogo Editor de planificaciones.
3.
En la barra de herramientas, haga clic en Extraer si el objeto no se ha extraído ya.
4.
Agregue un operador al proceso o la planificación:
a.
Para un proceso, arrastre un operador al diseño del proceso desde la paleta
Operadores.
b. Para una planificación, contraiga el panel de procesos, expanda el panel de
operadores y arrastre un operador a la lista de elementos de planificación.
5.
Consulte las propiedades del operador:
a.
En un proceso, haga doble clic en el operador.
Aparece la paleta Propiedades
b. En una planificación, haga clic en Propiedades y en las fichas General o
Específico.
6.
Haga clic en Guardar.
Se guardan los valores de propiedades introducidos para el operador seleccionado.
Nota: Para obtener más información acerca de las propiedades de operador, consulte la
Guía de referencia del diseñador de contenido.
Capítulo 5: Operadores e iconos 163
Operadores
Recuperación automática
La función Recuperación de operador controla los procesos que se pueden recuperar
como parte de la recuperación manual o automática de un punto de contacto,
orquestador o grupo de host. Esta función se puede activar o desactivar.
■
Active la recuperación en un proceso y defina un identificador de excepciones
que le notifique en caso de que haya un error.
■
Desactive la recuperación en un proceso y defina un identificador de
excepciones que solucione el error del sistema. Por ejemplo, el identificador
podría ejecutar l operador en un punto de contacto diferente.
Nota: Para obtener más información, consulte Tratamiento de excepciones (en
la página 442).
CA Process Automation activa Activar la recuperación de operadores para cada objeto
antes de ejecutar una instancia de proceso. CA Process Automation utiliza los valores de
configuración para determinar si la instancia del proceso es recuperable. La instancia del
proceso no se ve afectada si los valores de configuración del objeto cambian después de
haber ejecutado la instancia del proceso.
Si está activado, el procedimiento de recuperación actúa sobre los operadores y
recupera las instancias del proceso que fallan con el error SYSTEM_ERROR. Los procesos
de los operadores deben configurarse para poder recuperarse y deben estar en los
estados Bloqueado, En ejecución o En espera cuando se activa la recuperación. La
recuperación del operador lo restablece y, a continuación, reanuda los procesos. Un
operador en estado Bloqueado debe reanudar el funcionamiento y volverse a ejecutar
durante la recuperación del punto de contacto.
Los nuevos procesos creados en CA Process Automation versión 4.0 o una versión
posterior tienen esta opción seleccionada de forma predeterminada. Activar la
recuperación de operadores está desactivado de forma predeterminada solamente en
los procesos existentes creados antes de la actualización a CA Process Automation
versión 4.0.
164 Guía del diseñador de contenido
Operadores
Java y archivos JAR externos
El módulo de Java permite especificar código de Java para ejecutarse dentro de un
intérprete de BeanShell en JVM de CA Process Automation. BeanShell es un intérprete
de fuente de Java dinámico integrado, un lenguaje de generación de scripts y un
entorno flexible. Mediante el módulo de Java de CA Process Automation y los
operadores, se puede:
■
Importar y hacer referencia a archivos JAR en el nivel del módulo o del operador.
■
Configurar valores de configuración globales para todos los operadores Ejecutar
código de Java o valores de configuración específicos de un operador concreto. Se
pueden especificar rutas a los archivos JAR externos que los operadores pueden
utilizar. También se puede establecer la configuración de registro predeterminada
en el módulo. Para cada operador, se puede especificar el código que se desea
ejecutar, los parámetros de entrada y los nombres de las variables de salida. Los
valores de configuración de registro que se especifican para un operador Ejecutar
código de Java único anulan los valores de configuración de registro en el nivel del
módulo.
■
Escriba código de Java que haga referencia a clases en estos archivos JAR. CA
Process Automation crea automáticamente nuevos tipos de datos de objeto de Java
cuando se ejecuta un programa de Java. Puesto que se invocan nuevos objetos de
Java dentro del operador Ejecutar código de Java, no es necesario utilizar ningún
métodos de creación o destrucción de objeto. Después de ejecutar el operador, CA
Process Automation recopila automáticamente los recursos, las clases y los objetos
basura que hubiera en la memoria.
■
Ejecute el código de Java mediante el operador Ejecutar código de Java. Se pueden
invocar clases en un archivo de archivado de Java externo (JAR) desde un operador
Ejecutar código de Java. Utilice este operador para aprovechar la funcionalidad que
proporciona su código de Java existente.
■
Guarde objetos de Java en el conjunto de datos del operador para ponerlos a
disposición de los operadores Ejecutar código de Java. Puede guardar un objeto de
Java completo en el conjunto de datos del operador antes de que finalice la
ejecución del operador. A continuación, se puede aprovechar el objeto de Java
guardado en el conjunto de datos del operador en operadores subsiguientes
trasladándolo a estos.
Capítulo 5: Operadores e iconos 165
Operadores
Configuración del módulo de Java
Se pueden invocar clases en un archivo de archivado de Java externo (JAR) desde todos
los operadores Ejecutar código de Java. Configure el módulo de Java para aplicar valores
de configuración a estos operadores para aprovechar la funcionalidad que proporciona
su código de Java existente. A continuación, utilice el operador Ejecutar código de Java
para crear un objeto de Java.
Lleve a cabo los pasos siguientes:
1.
Especifique los archivos JAR con los que desea trabajar en un orquestador de CA
Process Automation o equipo del agente. Busque el campo Archivos JAR externos
predeterminados del módulo. Introduzca las rutas a los archivos JAR externos que
deben cargarse para que puedan usarlos los operadores Ejecutar código de Java
que se ejecuten en el orquestador o agente. En cada ruta se puede introducir:
a.
La ruta completa a un archivo JAR que reside en el equipo donde se está
ejecutando el orquestador o agente. La ruta completa empieza con cualquiera
de las barras invertidas siguientes:
/
\\
También se puede designar la ruta completa mediante una expresión regular
que empieza con un carácter, le siguen dos puntos (:) y, a continuación, el resto
de la cadena, incluida la sintaxis de punto como en:
^.:.*
b. La ruta completa a un archivo JAR disponible en http:// o https://. La ruta no
requiere autenticación y no puede accederse a ella a través de un proxy de
http.
c.
La ruta relativa a un archivo JAR cargado en la carpeta de recursos del usuario
de CA Process Automation. Si no se especifica una ruta completa, la aplicación
considera que la ruta que se introduce es una ruta relativa.
El cargador de clases del módulo de Java, compartido por todos los operadores
Ejecutar código de Java del módulo de Java, carga los archivos JAR incluidos en este
campo. Los archivos JAR se cargan una vez al ejecutar el primer operador del
módulo de Java y posteriormente si se realiza algún cambio en los archivos JAR
externos predeterminados. Cualquier archivo JAR introducido en esta lista estará
disponible para el código de Java ejecutado por los operadores Ejecutar código de
Java. Las clases que define en los archivos JAR en el nivel del operador anulan las
mismas clases especificadas en los archivos JAR en el nivel del módulo.
2.
Además de archivos JAR externos, introduzca las rutas a los archivos .class que
cualquier operador Ejecutar código de Java ejecutado en el orquestador o agente
use.
166 Guía del diseñador de contenido
Operadores
a.
Para archivos .class de un paquete sin nombre, escriba una ruta que termine
con el directorio que contenga los archivos .class. Por ejemplo, MyAccount.java
no pertenece a ningún paquete y MyAccount.class se encuentra en la ubicación
siguiente:
C:\java\tests\MyAccount.class
Establezca el operador para que use la ruta siguiente:
C:\\java\\tests
b. Para archivos .class de un paquete con nombre, escriba una ruta que termine
con el directorio que contenga el paquete raíz. El paquete raíz es el primer
paquete en el nombre del paquete completo. Por ejemplo, MyAccount.java
pertenece al paquete com.ca.tech. MyAccount.class se encuentra en la ruta
siguiente:
C:\java\othertests\com\ca\tech\MyAccount.class
Establezca el operador para que use la ruta siguiente:
C:\\java\\othertests
Nota: Especifique la ruta a una carpeta como la ruta completa o una ruta relativa a
Recursos del usuario de CA Process Automation. No especifique una ruta de http.
Especifique la ruta a una carpeta para cargar archivos .class, no archivos JAR. A
diferencia de los archivos .class, cada archivo JAR requiere una ruta independiente
que termina con el archivo JAR (no el directorio donde reside).
3.
(Opcional) Cargue los archivos JAR con los que se desee trabajar en Recursos del
usuario de CA Process Automation.
CA Process Automation automáticamente refleja los archivos JAR.
Nota: Los recursos, incluidos los recursos de usuario, se reflejan en el intervalo de
duplicación del orquestador o agente. Asegúrese de que los archivos JAR cargados
en los recursos de usuario se hayan duplicado antes de utilizarlos en los operadores
del módulo de Java.
4.
Verifique que los archivos JAR que contienen las clases de Java con las que se desea
trabajar estén disponibles para el orquestador o agente cuyo punto de contacto
esté ejecutando el operador.
5.
(Opcional) Configure el registrador predeterminado del módulo. Estos valores de
configuración se pueden anular en el nivel del operador.
6.
(Opcional) Anule los valores de configuración del nivel del módulo que desee
configurando operadores individuales. Consulte el procedimiento siguiente,
Configuración del operador Ejecutar código de Java (en la página 168).
7.
Ejecute cualquier operador Ejecutar código de Java. El módulo de Java captura las
excepciones o los errores detectados durante una operación y alerta al usuario en
el campo Motivo del operador problemático.
Capítulo 5: Operadores e iconos 167
Operadores
Configuración del operador Ejecutar código de Java
Se pueden invocar clases en un archivo de archivado de Java externo (JAR) desde un
operador Ejecutar código de Java. El operador Ejecutar código de Java puede utilizar
archivos JAR en el nivel del operador y en el nivel del módulo. El operador Ejecutar
código de Java también se puede configurar para anular valores de configuración en el
nivel del módulo. Utilice este operador para aprovechar la funcionalidad que
proporciona su código de Java existente.
Lleve a cabo los pasos siguientes:
1.
Si todavía no ha configurado el módulo de Java, realice esta tarea en primer lugar.
Consulte Configuración del módulo de Java (en la página 166).
2.
Configure el operador Ejecutar código de Java.
Especifique las rutas a los archivos JAR externos que usa el operador Ejecutar
código de Java. En cada ruta se puede introducir:
■
La ruta completa a un archivo JAR que reside en el host donde se están
ejecutando el orquestador o el agente. La ruta completa empieza con
cualquiera de las barras invertidas siguientes:
/
\\
Se puede utilizar también una expresión normal (incluida la notación con
puntos) que empieza con un carácter seguido de dos puntos (:) y, después, el
resto de la cadena, por ejemplo:
^.:.*
■
La ruta completa a un archivo JAR disponible en http:// o https://. La ruta no
puede requerir autenticación y no debe poder accederse a ella a través de un
proxy de http.
■
La ruta relativa a un archivo JAR que reside en la carpeta Recursos del usuario
de CA Process Automation.
Si no se especifica una ruta completa, la aplicación interpreta que la ruta que se
introduce es una ruta relativa.
Los archivos JAR especificados en este campo los carga el operador y los pone a
disposición del código de Java en el operador en ejecución. Las clases definidas en
los archivos JAR anulan las mismas clases especificadas en los archivos JAR en el
nivel del módulo.
3.
Además de archivos JAR externos, introduzca las rutas a los archivos .class para el
operador Ejecutar código de Java.
a.
Para archivos .class de un paquete sin nombre, escriba una ruta que termine
con el directorio que contenga los archivos .class. Por ejemplo, si
MyAccount.java no pertenece a un paquete y MyAccount.class se encuentra
en:
168 Guía del diseñador de contenido
Operadores
C:\java\tests\MyAccount.class
Configure el operador de forma que utilice la ruta siguiente:
C:\\java\\tests
b. Para archivos .class de un paquete con nombre, escriba una ruta que termine
con el directorio que contenga el paquete raíz. El paquete raíz es el primer
paquete en el nombre del paquete completo. Por ejemplo, si MyAccount.java
pertenece al paquete com.ca.tech y MyAccount.class se encuentra en:
C:\java\othertests\com\ca\tech\MyAccount.class
Configure el operador de forma que utilice la ruta siguiente:
C:\\java\\othertests
Nota: Especifique la ruta a una carpeta como la ruta completa o una ruta relativa a
Recursos del usuario de CA Process Automation. No especifique una ruta de http.
Especifique la ruta a una carpeta para que se carguen los archivos .class, no los
archivos JAR. A diferencia de los archivos .class, cada archivo JAR requiere una ruta
independiente que termina con el archivo JAR (no el directorio donde reside).
4.
(Opcional) Cargue los archivos JAR con los que se desee trabajar en Recursos del
usuario de CA Process Automation.
CA Process Automation automáticamente refleja los archivos JAR.
Nota: Los recursos, incluidos los recursos del usuario, se duplican durante el
intervalo de duplicación del orquestador o el agente. Asegúrese de que los archivos
JAR cargados en los recursos de usuario se hayan duplicado antes de utilizarlos en
los operadores del módulo de Java.
5.
Especifique el código que se debe ejecutar.
6.
Especifique los parámetros de entrada que se deben transferir al código de Java.
7.
Especifique los nombres de salida de las variables creadas en el código Java del
operador. Los nombres de variables de salida se deben haber guardado en el
conjunto de datos del operador cuando el código termine de ejecutarse.
Nota: CA Process Automation convierte en serie los objetos Java que no son
booleanos, fechas, enteros, números, cadenas, caracteres o matrices de estos tipos
y los guarda como JavaObjects.
8.
(Opcional) Especifique el valor de registrador de este operador Ejecutar código de
Java. Estos valores de configuración anulan los valores de configuración de
registrador en el nivel del módulo.
9.
Ejecute el operador Ejecutar código de Java.
El módulo de Java captura las excepciones o los errores detectados durante una
operación y alerta al usuario mediante el campo Motivo del operador problemático.
Capítulo 5: Operadores e iconos 169
Operadores
Uso de un JavaObject
Los objetos Java se guardan después de que un operador Ejecutar código Java se haya
completado en un tipo de datos JavaObject. Se puede utilizar una variable de conjunto
de datos de JavaObject de las siguientes maneras:
■
Transfiera la variable de conjunto de datos JavaObject en la lista de parámetros del
operador Ejecutar código de Java.
■
Transfiera la ruta de la variable de conjunto de datos JavaObject en una variable de
cadena desde un formulario de solicitud de interacción o un formulario de solicitud
de inicio. Por ejemplo:
JavaObjectPath = Datasets["/GlobalDatasets"].acct
A continuación, se puede utilizar la función eval al transferir la variable
JavaObjectPath a la lista de parámetros del operador Ejecutar código de Java. Por
ejemplo:
eval(Process.IRF.JavaObjectPath)
■
Copie un JavaObject en Javascript. También se puede asignar un JavaObject a otro.
Nota: No se debe modificar el valor real de un JavaObject de CA Process
Automation (cadena en serie del objeto Java original). Los cambios que realice
podrían impedir que el operador Ejecutar código Java cargue el JavaObject.
Observe las restricciones siguientes al trabajar en JavaScript:
■
Al igual que con las contraseñas, no se puede concatenar un JavaObject a una
cadena.
■
No se puede cargar un JavaObject y utilizar sus métodos en JavaScript. En lugar de
ello, transfiera el JavaObject en la lista de parámetros del operador Ejecutar código
Java y acceda al mismo en el código Java del operador.
170 Guía del diseñador de contenido
Operadores
El código Java que escriba puede estar formado por declaraciones y expresiones Java
normales. Puede definir también sus propios métodos y utilizarlos dentro del código.
Por ejemplo:
// Importar las clases que desea utilizar
importar ca.tech.pam.MyAccount;
// Nota: No es preciso importar StringBuffer y Fecha porque forman parte de los
// paquetes importados automáticamente
// importar java.lang.StringBuffer;
// importar java.util.Date;
// Nota: El archivo jar que contiene la clase ca.tech.pam.MyAccount
// debe estar en la lista de archivos JAR externos del operador o el módulo;
// pero java lang y java util están en rt.jar, que se coloca automáticamente en
el classpath
MyAccount acct = nuevo MyAccount(1000.00);
// Utilizar los métodos públicos del objeto MyAccount
acct.addFunds(34.44);
acct.subFunds(10);
// Definir su propio método
Cadena getStatement(MyAccount acc) {
StringBuffer strBuff = nuevo StringBuffer("Balance de cuenta: " +
acc.getBalance());
Fecha dt = nuevo Date(System.currentTimeMillis());
strBuff.append(" en fecha: " + dt);
devolver strBuff.toString();
}
// Utilice el método que haya definido
// asimismo, imprima la declaración mediante el objeto 'registrador' que
// configure en la página de registrador del operador
logger.info(getStatement(acct));
Después de ejecutar este código Java, el mensaje de registro muestra el saldo de la
cuenta, la fecha y la hora:
Balance de la cuenta: 124.44 en la fecha: Mié 13 Jul 12:53:37 EDT 2011
Operadores personalizados
Se pueden definir objetos de operador personalizado que los usuarios podrán agregar a
sus procesos o planificaciones, al igual que lo harían cualquier otro operador. Se crean
operadores personalizados reutilizando un operador base existente. Configure los
valores de configuración de ese operador base en la paleta de propiedades. Utilice
operadores personalizados para compartir nuevas funcionalidades a través de su
organización de TI.
Capítulo 5: Operadores e iconos 171
Operadores
Por ejemplo, se podría utilizar el operador Obtener variable SNMP como base para un
operador personalizado que recupere información específica de un enrutador de red.
Configure el OID de variable SNMP apropiado y la cadena de comunidad y, a
continuación, defina las propiedades para que los usuarios puedan configurar la
dirección IP de la variable SNMP. Después de la publicación, los usuarios pueden agregar
el operador personalizado a un proceso o a una planificación y, acto seguido, configurar
la dirección IP para acceder a información específica del enrutador de red. No es
necesario que los usuarios conozcan el OID de variable SNMP ni la cadena de
comunidad. Esos valores ya se han configurado y probablemente están ocultos para el
usuario.
Un uso más importante de los operadores personalizados es desarrollar conexiones con
nuevos sistemas y aplicaciones de empresa, entre ellos:
■
Aplicaciones importantes: las organizaciones a menudo desarrollan e implementan
este tipo de aplicaciones internamente.
■
Servicios Web (SOAP y RESTful)
■
Línea de comandos y aplicaciones de generación de scripts
■
Bases de datos
■
Java
Desarrolle operadores personalizados que ejecuten acciones comunes que conecten con
sus aplicaciones y sistemas. Reutilice sus propios operadores personalizados para
permitir que su organización pueda trabajar fácilmente con estas aplicaciones y
sistemas de procesos automatizados. Los usuarios pueden realizar acciones sin
necesidad de tener un conocimiento profundo de todas las interfaces de las aplicaciones
y los sistemas.
Los operadores personalizados también ofrecen la ventaja de adaptarse fácilmente a los
cambios de su entorno de TI. Por ejemplo, basta con cambiar el objeto del operador
personalizado original si los cambios del entorno de TI exigen que se cambie la forma de
conectar con una aplicación. Todos los procesos y las planificaciones que utilizan el
operador personalizado aplican automáticamente los cambios en la última versión
designada. En consecuencia, los cambios del entorno de TI son transparentes para todos
los procesos y todas las planificaciones.
Creación de un objeto de operador personalizado
Se puede crear un operador personalizado en cualquier carpeta de una biblioteca.
172 Guía del diseñador de contenido
Operadores
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en una carpeta.
3.
En la barra de herramientas, haga clic en Nuevo y, a continuación, elija Operador
personalizado.
Aparece el cuadro de diálogo Seleccione un operador base.
4.
Seleccione el operador básico para el operador personalizado y haga clic en
Aceptar. Expanda carpetas o introduzca el nombre de operador que se desea
buscar.
En la biblioteca, se crea un objeto de operador personalizado con un nombre
predeterminado.
5.
Renombre el operador personalizado.
Nota: La aplicación identifica operadores personalizados por una ubicación única en la
biblioteca mediante la ruta y el nombre del objeto. Evite cambiar la ubicación y el
nombre del objeto de operador personalizado si se está utilizando actualmente en un
proceso. Renombrar o mover un operador personalizado mientras se está usando en un
proceso puede dar lugar a la pérdida de cambios o actualizaciones.
Propiedades de operador personalizado
Se puede configurar un operador personalizado modificando los valores de
configuración predeterminados disponibles para el operador base. También se pueden
agregar parámetros y páginas de entrada para presentar a un usuario del operador
personalizado con valores de configuración de entrada específicos.
Cada operador personalizado tiene siete tipos de propiedades principales:
■
Formulario
■
Vista previa
■
Parámetros
■
Conjunto de datos
■
Configuración del grupo
■
Propiedades
■
Versiones
■
Pista de auditoría
Capítulo 5: Operadores e iconos 173
Operadores
Para cada configuración, puede hacer lo siguiente:
■
Déjela en blanco y permita que el usuario la configure al utilizar el operador
personalizado.
■
Configúrela con un valor predeterminado y márquela como invisible, lo cual oculta
la configuración definitivamente del usuario al utilizar el operador personalizado.
También puede:
■
Configúrela con un valor predeterminado, pero permita que el usuario cambie el
valor.
■
Configúrela con un valor predeterminado y márquela como de sólo lectura, lo cual
permite al usuario ver pero no editar el valor.
Por ejemplo: un operador personalizado básico
Se puede crear un operador personalizado que recupere información específica de un
enrutador de red por medio del operador Obtener variable SNMP como el operador
base. Como parte del operador personalizado, configure el OID de variable SNMP
apropiado y la cadena de comunidad y, a continuación, defina las propiedades para que
el usuario pueda configurar la dirección IP de la variable SNMP. El operador Obtener
variable SNMP tiene los valores de configuración específicos siguientes:
■
Host del agente (Dirección IP)
■
Comunidad
■
ID de objeto (OID)
■
Recuento de reintentos
■
Tiempo de espera
■
Versión de SNMP
Normalmente configuraría los valores predeterminados y marcaría como invisibles
todos los valores de configuración, excepto Host del agente. Otro diseñador que utilice
este operador personalizado solamente ve el ajuste Host del agente en el panel
Propiedades. Todos los otros valores de configuración se ocultan. Otros usuarios pueden
especificar el host del agente para determinar el enrutador de red desde donde procede
la información. Pero otros usuarios no tienen que conocer los otros valores de
configuración del operador Obtener variable SNMP. Mientras configuren la dirección IP
correcta, la información en cuestión aparecerá.
174 Guía del diseñador de contenido
Operadores
Por ejemplo: un operador personalizado avanzado
Para proporcionar un ejemplo más avanzado, se puede crear una interfaz en una
aplicación interna utilizando la generación de scripts. En este ejemplo, utilizaría el
operador Iniciar script como la base para el operador personalizado. A continuación,
normalmente especificaría la extensión del script, el script mismo y otros valores de
configuración, como los parámetros para transferir al script. Normalmente configuraría
estos parámetros (de hecho, todos los parámetros que proceden del operador base)
como invisibles. También puede crear su propia página de valores de configuración para
solicitar algunos valores de configuración que son específicos del operador a un usuario
del operador personalizado. Como en el sencillo ejemplo anterior, un usuario final
puede utilizar su operador personalizado para actuar en su aplicación interna. Esta
técnica extiende procesos integrados sin necesidad de conocer datos específicos sobre
cómo se conecta con esa aplicación.
Más información:
Operador personalizado: Ficha Propiedades (en la página 192)
Operador personalizado: Ficha Formulario
Al diseñar un operador Personalizar se puede permitir que los parámetros y las páginas
personalizadas reciban datos de usuarios finales mientras configuran el operador
personalizado como parte de un proceso o planificación. Utilice la ficha Formulario de
operador personalizado para:
■
Agregar, eliminar y renombrar páginas de propiedades
■
Agregar, eliminar y renombre parámetros en las páginas de propiedades
■
Configurar las características de un parámetro
■
Reorganizar parámetros en una página de propiedades
■
Mover parámetros entre páginas
Cada operador personalizado puede tener una o varias páginas de parámetros en
función de su operador antepasado u operador base. Estos parámetros se pueden
modificar y configurar. Por ejemplo, si la base es el operador Ejecutar script, puede
configurar los siguientes parámetros:
■
El campo scriptType para definir la extensión del script
■
El campo inLineScript para definir el propio script
■
Los otros campos y parámetros estándar para el operador Ejecutar script
Capítulo 5: Operadores e iconos 175
Operadores
Agregación de páginas de propiedad
La ficha Valores de configuración de operador personalizado incluye las propiedades
básicas estándar de un operador. Estos valores de configuración corresponden a los
parámetros que se encuentran en la paleta Propiedades del Diseñador de procesos. Use
la paleta Propiedades para configurar las propiedades básicas del operador
personalizado y las propiedades personalizadas asignadas al mismo.
Un operador personalizado puede requerir que se introduzcan más parámetros en la
función del operador. Se pueden agregar páginas de propiedades para agrupar estos
parámetros adicionales. Cuando se agregan páginas al operador personalizado en la
ficha Formulario, estas aparecen como secciones expandibles en la paleta Propiedades
del Diseñador de procesos.
Lleve a cabo los pasos siguientes:
1.
En el Explorador de bibliotecas, haga doble clic en un operador personalizado.
2.
En la barra de herramientas, haga clic en Extraer.
3.
En la ventana de diseñador de operadores personalizados, haga clic en la ficha
Formulario.
4.
En el panel Elementos de formulario, expanda todos los siguientes:
a.
Elementos de formulario
b. Diseño de página bajo Elementos de formulario
c.
Diseño de página bajo su operador personalizado
5.
Arrastre un elemento Página desde el Diseño de página de elementos de formulario
al nivel Diseño de página para su operador personalizado.
6.
Haga clic en la nueva página y luego haga clic en Renombrar en la barra de
herramientas. Renombre la página nueva con un identificador significativo.
Cada nombre de página corresponde a una sección nombrada expandible en la
paleta Propiedades de operador personalizado en el Diseñador de procesos.
7.
El orden de las páginas en la paleta de Propiedades también corresponde al orden
mostrado en la ficha Formulario. Seleccione una página y haga clic en Mover hacia
arriba o Mover hacia abajo en la barra de herramientas para desplazarse una página
arriba o abajo en la lista.
Para eliminar una página de propiedades, incluidos todos los parámetros:
1.
Seleccione la página.
2.
En la barra de herramientas, haga clic en Suprimir.
176 Guía del diseñador de contenido
Operadores
Cómo agregar parámetros personalizados
Una vez creadas las páginas de propiedades, se pueden agregar parámetros (campos) a
las mismas. Los parámetros personalizados suelen utilizarse para ofrecer a los usuarios
una presentación diferente de un parámetro que se necesita para el operador base. Por
ejemplo, se puede agregar un parámetro para presentar una lista de valores de entre los
cuales se desea que los usuarios seleccionen, en lugar de utilizar un cuadro de edición
sin valores definidos. Los parámetros también se utilizan para capturar datos que luego
se utilizan en una expresión para calcular uno o más parámetros del operador base.
Además, los parámetros se utilizan para presentar a los usuarios una interfaz con la
terminología apropiada.
A menos que configure sus propiedades Solo lectura, Desactivado u Oculto en
verdadero, los usuarios finales podrán ver y configurar los parámetros personalizados
que agregue a su operador en la paleta Propiedades de operador personalizado en el
diseñador de procesos o en el editor de planificaciones.
Lleve a cabo los pasos siguientes:
1.
En el Explorador de bibliotecas, haga doble clic en un operador personalizado.
2.
En la barra de herramientas, haga clic en Extraer.
3.
En la ventana de diseñador de operadores personalizados, haga clic en la ficha
Formulario.
4.
En el panel Elementos de formulario, expanda todos los siguientes:
a.
Elementos de formulario
b. Diseño de página y cualquier página que esté debajo de su operador
personalizado
5.
Arrastre un elemento de formulario desde Elementos de formulario hasta la página
de su operador personalizado. No se puede arrastrar un campo directamente al
diseño de formulario.
6.
Haga clic en el nuevo campo para editar sus propiedades. Renombre el nuevo
campo con un identificador significativo mediante la propiedad Etiqueta. Use el
botón Renombrar de la barra de herramientas para renombrar algunos campos
como casillas de verificación.
Cada nombre de página corresponde a una sección nombrada en la paleta
Propiedades de operador personalizado en el Diseñador de procesos.
7.
El orden de las páginas en la paleta Propiedades también corresponde al orden que
se muestra en la ficha Formulario. Seleccione un elemento y haga clic en Mover
hacia arriba o Mover hacia abajo en la barra de herramientas para desplazarlo hacia
arriba o hacia abajo en la lista.
Capítulo 5: Operadores e iconos 177
Operadores
Para eliminar un parámetro:
1.
Seleccione la página.
2.
En la barra de herramientas, haga clic en Eliminar.
Opción de parámetro invisible
CA Process Automation permite configurar parámetros de operador personalizado y
ocultarlos al usuario final. Se pueden configurar los parámetros de operador
personalizado como invisibles, de sólo lectura o editables en tiempo de ejecución. Para
transferir información al parámetro de operador personalizado, agregue macros a dicho
operador. Se pueden ocultar al usuario los parámetros de entrada y aun así utilizar
macros para acceder a los valores de entrada de los parámetros de operador
personalizado ocultos. Los cambios que se realizan en los parámetros de operador
personalizados se aplican a todos los procesos mediante el operador personalizado.
A menos que configure sus propiedades Solo lectura, Desactivado u Oculto en
verdadero, los usuarios finales podrán ver y configurar los parámetros personalizados
que agregue a su operador en la paleta Propiedades de operador personalizado en el
diseñador de procesos o en el editor de planificaciones.
178 Guía del diseñador de contenido
Operadores
Propiedad Expandir macro en el valor
Para utilizar un parámetro personalizado para definir el valor de un parámetro del
operador básico (motivo por el que se suelen usar parámetros personalizados), se le
debe tratar como una macro. Utilice la opción Expandir macro en el valor para permitir
la introducción de datos del usuario en un campo de operador personalizado que se
usará como el valor de un parámetro de operador base.
Para ello, primero establezca la propiedad Oculta. A continuación, configure el
parámetro del operador base con la opción Ampliar macro en el valor. CA Process
Automation busca en los valores de parámetros del operador base (para cualquier
parámetro con Ampliar macro en el valor activado) todo nombre de parámetro
personalizado y reemplaza el nombre de parámetro personalizado con el valor del
parámetro del cliente. Si bien ésta es una función eficaz, tenga cuidado al determinar
qué parámetros del operador base deberían tener configurada la opción Ampliar macro
en el valor y al nombrar los parámetros personalizados para que sean únicos de manera
tal que no se pueda reemplazar accidentalmente una cadena con el parámetro
personalizado que comparta el mismo nombre.
Por ejemplo, se ha creado un operador personalizado mediante el operador Ejecutar
script como operador base. El script se ha definido para transferir algunos parámetros
basados en datos proporcionados por un usuario del operador personalizado. Se agrega
un campo de formulario para obtener esta entrada por parte del usuario final y ese
parámetro se llama for. En el operador base, agregue un parámetro e introduzca el valor
for y establezca la propiedad Expandir macro en el valor como verdadera. Esto transfiere
correctamente la entrada del usuario configurada en el campo de formulario de
operador personalizado al script en forma de parámetro.
Si un usuario introduce el valor Steve para este parámetro personalizado, el script
recibiría un parámetro con el valor Steve. Sin embargo, si se activa la opción Expandir
macro en el valor para el parámetro de operador base inLineScript, esto reemplaza la
palabra for en cualquier lugar del script con la palabra Steve. Esto no es deseable, dado
que el código de generación de scripts para cualquier bucle Para se reemplazaría
accidentalmente por un término involuntario, lo que daría lugar a un error de sintaxis en
el script.
Más información:
Operador personalizado: Ficha Propiedades (en la página 192)
Prueba de la interfaz de operador personalizado
Después de agregar y configurar páginas y parámetros, se puede utilizar la función
Prueba para obtener una vista previa del panel de Propiedades de operador
personalizado.
Capítulo 5: Operadores e iconos 179
Operadores
Lleve a cabo los pasos siguientes:
1.
Haga clic en Prueba en la barra de herramientas.
Los parámetros aparecen en las fichas en el mismo orden en que aparecen en las
páginas correspondientes en la paleta Parámetros de operador personalizado.
2.
Revise las páginas y los parámetros.
Se puede consultar una vista previa de la vista de usuario final del operador cliente
y las opciones disponibles para la misma.
Ejemplo: recuperación de valores de matriz de ValueMap con una función del sistema de
operador.
En este ejemplo se utiliza la siguiente función del sistema de operador para recuperar
los valores de una matriz de ValueMap. La función devuelve un campo o columna de
una matriz basada en los parámetros proporcionados.
getValueFromValueMapArray(groupName, arrName, fieldName,
fieldValue, requiredFieldName)
Lleve a cabo los pasos siguientes:
1.
Cree un operador personalizado denominado "CustOp_GetDBVersion" con Obtener
versión como operador base.
2.
Diseñe el formulario de la misma forma que se muestra en la siguiente ilustración:
180 Guía del diseñador de contenido
Operadores
Asigne los siguientes nombres a los elementos del formulario: mNamedConnection,
mHostName, mUserName, mPassword, mPort, mDBName, mDBType y
mDriverName. Asegúrese de que los nombres de los elementos del formulario sean
similares a los nombres de las variables definidas en la ficha de Configuración del
grupo.
3.
Haga clic en la ficha Parámetros y cree un grupo denominado
"NamedConnectionGroupDemo".
4.
Haga clic en la ficha Ejecución previa de operador personalizado e introduzca el
siguiente código:
Process.HostName =
getValueFromValueMapArray("NamedConnectionGroupDemo",
"ConnArray", "mNamedConnection", Operator.mNamedConnection,
"mHostName");
Process.UserName =
getValueFromValueMapArray("NamedConnectionGroupDemo",
"ConnArray", "mNamedConnection", Operator.mNamedConnection,
"mUserName");
Process.Password =
getValueFromValueMapArray("NamedConnectionGroupDemo",
"ConnArray", "mNamedConnection", Operator.mNamedConnection,
"mPassword");
Process.Port =
getValueFromValueMapArray("NamedConnectionGroupDemo",
"ConnArray", "mNamedConnection", Operator.mNamedConnection,
"mPort");
Process.DBName =
getValueFromValueMapArray("NamedConnectionGroupDemo",
"ConnArray", "mNamedConnection", Operator.mNamedConnection,
"mDBName");
Process.DBType =
getValueFromValueMapArray("NamedConnectionGroupDemo",
"ConnArray", "mNamedConnection", Operator.mNamedConnection,
"mDBType");
Process.DriverName =
getValueFromValueMapArray("NamedConnectionGroupDemo",
"ConnArray", "mNamedConnection", Operator.mNamedConnection,
"mDriverName");
5.
Seleccione la ficha Configuración del grupo y haga clic en Bloquear para bloquear el
grupo.
6.
Cree una matriz de ValueMap denominada "ConArray" y agregue los parámetros
que se muestran en la siguiente ilustración:
Capítulo 5: Operadores e iconos 181
Operadores
7.
Haga clic en Guardar configuración para guardar la configuración del grupo.
8.
Haga clic en Desbloquear para publicar el grupo NamedConnectionGroupDemo en
el nivel del dominio y el entorno.
9.
Abra el grupo en el Explorador de configuración de la ficha Módulos.
10. Agregue los valores de parámetro a la matriz tal y como se muestra en la siguiente
ilustración y guarde la matriz.
182 Guía del diseñador de contenido
Operadores
Una vez que se recuperen los valores de matriz de ValueMap, un usuario de producción
puede utilizar el operador NamedConnectionGroupDemo en un proceso para hacer
referencia a una conexión con nombre.
1.
Cree un proceso que se utilice en el operador personalizado CustOp_GetDBVersion.
2.
Especifique "mysql" como el valor del campo de conexión en las propiedades del
operador personalizado para recuperar los valores relacionados desde la matriz
ConArray.
3.
Ejecute el proceso.
Se ejecuta el script del código de ejecución previa de operador personalizado. En el
proceso se recuperan los valores para el valor del campo de conexión de MySQL
introducido en la propiedad de la conexión con nombre; además, lo muestra en la
paleta Conjunto de datos.
Operador personalizado: Ficha Vista previa
Utilice la ficha Vista previa para probar los elementos del formulario.
Capítulo 5: Operadores e iconos 183
Operadores
Operador personalizado: Ficha Valores de configuración
Utilice la ficha Valores de configuración para configurar valores de configuración que
sean comunes a todos los operadores. La ficha Valores de configuración de operador
personalizado incluye las propiedades básicas estándar de un operador. Estos valores de
configuración corresponden a los parámetros que se encuentran en la paleta
Propiedades del Diseñador de procesos.
Objetivo
Define dónde se ejecuta el operador personalizado.
El objetivo es una expresión calculada
Indica que el objetivo utiliza una expresión calculada.
El objetivo es sólo de lectura
Indica que el objetivo es de sólo lectura y no se puede cambiar.
Ejecutar como usuario autor de la llamada
Indica que el operador se ejecuta como si fuera la entidad de llamada.
"Ejecutar como usuario autor de la llamada" es de sólo lectura
Indica que el operador se ejecuta como si fuera la entidad de llamada, pero como
de sólo lectura para que no se pueda cambiar.
Grupo
Especifica un nombre de grupo para su operador personalizado. Este ajuste de
configuración se utiliza como el título del grupo o la carpeta en la paleta
Operadores. Se puede utilizar el mismo nombre de grupo para operadores
personalizados afines para que todos aparezcan en la misma carpeta en la paleta
Operadores. La configuración de un grupo de operadores personalizados define
valores y parámetros habituales para los operadores personalizados del grupo.
Nombre para mostrar
Indica el nombre que se muestra en la paleta Operadores con el icono de su
operador personalizado. El nombre debe ser corto y estar basado en la función del
operador. El nombre para mostrar también se utiliza para proporcionar el valor
inicial del campo Nombre en la página de información de las propiedades del
operador. Se puede utilizar cualquier combinación de letras, dígitos, espacios y
guiones bajos.
184 Guía del diseñador de contenido
Operadores
Ejecución previa de operador personalizado
Especifica los códigos que se deben ejecutar antes de que se ejecute el operador
personalizado.
Ejecución posterior de operador personalizado
Especifica los códigos que se deben ejecutar después de que se ejecute el operador
personalizado.
Icono de visualización actual
Especifica el icono que representa el operador. De forma predeterminada, el icono
del operador personalizado es el icono del operador base.
Creación de un grupo de operadores personalizados
Los diseñadores de contenido o los administradores utilizan la ficha Configuración para
crear un grupo de operadores personalizados. Solo los administradores pueden
configurar el grupo de operadores personalizados en la ficha Configuración del grupo.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca y vaya a la carpeta que contiene el operador
personalizado en el cual se desea basar el grupo de operadores personalizados.
2.
Haga doble clic en el operador personalizado objetivo.
3.
Haga clic en la ficha Configuración.
4.
Introduzca el nombre de grupo de operadores personalizados en el campo Grupo y,
a continuación, haga clic en Guardar.
Asignación del grupo a otros operadores personalizados
Los diseñadores de contenido que agregan operadores personalizados pueden utilizar la
ficha Parámetros para asignar un grupo adecuado al operador personalizado.
Lleve a cabo los pasos siguientes:
1.
Para abrir el editor de operadores personalizados, haga doble clic en un operador
personalizado en la ficha Biblioteca.
2.
En el editor de operadores personalizados, haga clic en la ficha Configuración.
3.
En la lista desplegable de Grupo, seleccione el nombre del grupo.
4.
Haga clic en Guardar.
Capítulo 5: Operadores e iconos 185
Operadores
Código de ejecución previa o posterior específico de los operadores personalizados
CA Process Automation permite definir código JavaScript de ejecución previa y posterior
para operadores personalizados. El código de ejecución previa se procesa antes de que
se ejecute un operador y el código de ejecución posterior se procesa después de que se
ejecute el operador. Los usuarios de los operadores personalizados no pueden anular el
código de ejecución previa o posterior que hayan definido previamente los diseñadores
o los desarrolladores con más permisos.
El código se ejecuta en el siguiente orden:
1.
Código de ejecución previa definido por el usuario
2.
Código de ejecución previa específico de los operadores personalizados
3.
El operador personalizado
4.
Código de ejecución posterior específico de los operadores personalizados
5. Código de ejecución posterior definido por el usuario
Definición de códigos de ejecución previa y de ejecución posterior específicos del operador personalizado
Para evitar la supresión o modificación accidental de código de ejecución, se puede
definir un código específico para cada operador personalizado. También se puede
utilizar la entrada del operador personalizado o los datos resultantes en el código.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga doble clic en un operador personalizado.
Se muestra el cuadro de diálogo Operador personalizado.
3.
Haga clic en la ficha Parámetros.
4.
Haga clic en uno de los dos botones:
■
Haga clic en Ejecución previa de operador personalizado para introducir código
de ejecución previa.
■
Haga clic en Ejecución posterior de operador personalizado para introducir
código de ejecución posterior.
Aparecerá un cuadro de diálogo de código.
5.
Introduzca su código. Haga clic en Aceptar.
6. Haga clic en Guardar.
Orden de ejecución del código de ejecución previa específico de los operadores personalizados
186 Guía del diseñador de contenido
Operadores
El orden de ejecución para el código de ejecución previa específico de los operadores
personalizados es el siguiente:
1.
Ejecute el código de ejecución previa definido por el usuario, es decir, el código de
ejecución previa definido en el proceso.
2.
Evalúe los parámetros del usuario (se deben evaluar también las expresiones y
macros de expansión).
3.
Ejecute el código de ejecución previa definido personalizado. Se muestran los
parámetros del usuario y se puede utilizar la palabra clave Operador para acceder a
los parámetros.
Nota: El diseñador no tiene los permisos necesarios para cambiar los valores de los
parámetros del usuario.
4.
Evalúe los parámetros estándar (se deben evaluar también las expresiones y macros
de expansión).
5.
Evalúe el operador Base.
Operador personalizado: Ficha Conjunto de datos
Para definir y agrupar las variables de los conjuntos de datos del operador que
contienen la información que devuelve un operador personalizado, utilice la ficha
Conjunto de datos.
Por ejemplo, suponga que un operador personalizado recupera campos de un ticket en
un sistema de control de tickets interno. Se puede crear una página para agrupar todos
los campos recuperados y poner los parámetros en la página que corresponda a los
campos devueltos.
Usar la ficha Conjunto de datos de esta manera ofrece las siguientes ventajas:
■
Los usuarios del operador personalizado pueden comprobar fácilmente cómo está
definido el resultado sin tener que ejecutar el operador primero para crear los
parámetros en el tiempo de ejecución.
■
Se pueden agrupar parámetros relacionados en una página con un nombre
descriptivo, lo que no se puede hacer en el tiempo de ejecución.
Capítulo 5: Operadores e iconos 187
Operadores
La paleta Conjunto de datos permite agregar, suprimir y mover páginas y parámetros,
además de renombrarlos. También se pueden configurar las definiciones de parámetros
para configurar el tipo, el valor inicial y otras características. Las configuraciones y los
parámetros de la paleta Conjunto de datos de un operador personalizado son las
mismas que las de cualquier otro conjunto de datos.
Para cada par nombre-valor del parámetro de salida de la izquierda, se puede
especificar si el valor del parámetro se debe ocultar en el resultado.
Ocultar de resultados
Especifica si se debe incluir el parámetro en el resultado.
■
Seleccionado: indica que se debe ocultar el parámetro; es decir, el parámetro
de resultado no se muestra en el conjunto de datos.
■
No seleccionado: indica que el parámetro se incluirá en los parámetros de
salida; es decir, el conjunto de datos mostrará el parámetro de resultado.
Más información:
Conjuntos de datos (en la página 211)
Operador personalizado: ficha Configuración del grupo
En la ficha Configuración, los diseñadores y los administradores de contenido pueden
realizar estas acciones:
■
Crear un grupo de operadores personalizados (en la página 185) para un operador
personalizado
■
Asignar el grupo a otros operadores personalizados (en la página 185)
En la ficha Configuración del grupo, los administradores de contenido pueden realizar
estas acciones:
■
Configurar un grupo de operadores personalizados (en la página 189)
■
Editar una configuración de grupo de operadores personalizados (en la página 190)
En la ficha Módulos del Explorador de configuración, los administradores agregan
valores predeterminados para las variables configuradas, los cuales se heredan
posteriormente. La herencia continúa desde el Dominio hasta los entornos y desde cada
entorno hasta los operadores que se ejecutan en el entorno. Los administradores
pueden anular los valores del nivel de Dominio en el entorno. Los diseñadores de
contenido pueden anular las configuraciones de nivel de entorno en el nivel del
operador personalizado.
188 Guía del diseñador de contenido
Operadores
Configuración y publicación de un grupo de operadores personalizados
Un grupo de operadores personalizados define los parámetros que son comunes con un
grupo de operadores personalizados. Los diseñadores de contenido (o los
administradores) utilizan la ficha Configuración para crear un grupo de operadores
personalizados. A continuación, los administradores utilizan la ficha Configuración del
grupo para agregar las variables adecuadas y publicar el grupo en el dominio y sus
entornos. La publicación agrega el grupo de operadores personalizados a la ficha
Módulos del Explorador de configuración.
Nota: Después de publicar las variables se pueden configurar los valores desde la ficha
Configuración. Los operadores personalizados heredan automáticamente los valores
predeterminados del grupo de operadores personalizados al cual pertenece el operador
personalizado.
Lleve a cabo los pasos siguientes:
1.
Para abrir el editor de operadores personalizados, haga doble clic en un operador
personalizado en la ficha Biblioteca.
2.
En el editor de operadores personalizados, haga clic en la ficha Configuración del
grupo.
Nota: No es necesario extraer el operador personalizado para configurar un grupo.
3.
Haga clic en Bloquear para bloquear el grupo.
Las opciones Agregar variable y Agregar página se activan.
4.
Agregue variables o páginas según corresponda.
5.
Haga clic en Guardar configuración.
6.
Haga clic en Desbloquear.
7.
Haga clic en Aceptar en el mensaje siguiente:
Agrupe las variables de configuración publicadas en el dominio y
el entorno.
CA Process Automation agrega el nuevo grupo de operadores personalizados a la
ficha Módulos para el dominio y cada entorno de este.
En la ficha Módulos del Explorador de configuración, los administradores pueden
abrir el grupo de operadores personalizados que se ha definido en la ficha
Configuración. En un grupo de operadores personalizados abierto, los
administradores pueden agregar valores a las variables que se han definido en la
ficha Configuración del grupo.
Nota: Para obtener más información acerca de cómo configurar valores para grupos
de operadores personalizados, consulte la Guía del administrador de contenido.
Capítulo 5: Operadores e iconos 189
Operadores
Edición de una configuración de grupo de operadores personalizados
Los administradores pueden editar una configuración de grupo de operadores
personalizados. Al volver a publicar, no se actualizan todos los cambios realizados en la
ficha Módulos del Explorador de configuración. Si un grupo editado ya se ha publicado
como mínimo una vez o bien otro usuario ya lo está utilizando, CA Process Automation
solamente publicará los nuevos parámetros en el grupo. Si se suprimen o cambian
operaciones de tipos de datos en las variables que ya se han publicado , no se
actualizarán en el nivel del entorno o el dominio al volver a publicar. Sin embargo, CA
Process Automation guarda los cambios en el nivel del operador personalizado. Se
pueden consultar las variables de tipo de datos modificadas al abrir el operador
personalizado en un grupo.
Lleve a cabo los pasos siguientes:
1.
Para abrir el editor de operadores personalizados, haga doble clic en un operador
personalizado en la ficha Biblioteca.
2.
Haga clic en la ficha Configuración del grupo.
3.
Haga clic en Bloquear para bloquear el grupo.
CA Process Automation activa las opciones Agregar variable y Agregar página.
4.
Agregue, suprima o edite variables o páginas según corresponda.
5.
Haga clic en Guardar configuración.
6.
Haga clic en Desbloquear.
Al utilizar un operador personalizado en el grupo editado en la ficha Diseñador,
asegúrese de que el operador personalizado incluya todos los cambios realizados en
el grupo (incluidos los cambios de tipo de datos).
190 Guía del diseñador de contenido
Operadores
Operador personalizado: Ficha Paneles personalizados
La ficha Paneles personalizados sólo aparece para un subconjunto limitado de
operadores base, como Asignar tarea de usuario o Invocar método SOAP. Las secciones
de la ficha varían según el operador base. En los siguientes ejemplos aparecen
operadores base comunes.
Para los operadores personalizados basados en el operador Asignar tarea de usuario, la
ficha Paneles personalizados se divide en las secciones siguientes:
Asignatarios
Especifica los usuarios o los grupos que pueden interactuar con el operador
personalizado y su formulario.
Transferir/delegar filtros
Especifica los usuarios o los grupos que están disponibles para la transferencia o
delegación de tareas.
Tarea de usuario
Especifica el Título, Descripción y Código de inicialización de datos de formulario
para el Formulario de solicitud de interacción asociado.
Para los operadores personalizados basados en el operador Invocar método SOAP, la
ficha Paneles personalizados se divide en las secciones siguientes:
Datos de llamada de SOAP
Utilice este grupo de campos para especificar la URL del servicio, el nombre del
método, el nombre de usuario, la contraseña, la versión, la fuente y otros detalles
para la autenticación básica de SOAP o HTTP. Utilice el Asistente de WSDL para
cargar una URL y seleccionar servicios, puertos y operaciones WSDL.
Parámetros dinámicos
Utilice este grupo de campos para especificar el estilo de parámetro y agregar,
editar o suprimir macros o consultas de XPath.
Resultados de las llamadas
Utilice este grupo de campos para especificar la ruta del archivo de respuesta de la
solicitud de SOAP guardada y agregar, editar o eliminar datos extraídos adicionales.
También se pueden seleccionar opciones para determinar cómo se gestionan las
partes del cuerpo y encabezado extraídas de SOAP, así como los espacios de
nombres XML.
Archivo adjunto de MIME
Utilice este grupo de campos para especificar una expresión o agregar, editar y
eliminar contenido como archivos adjuntos de MIME.
Seguridad WS
Utilice este grupo grande de campos para gestionar detalles de seguridad. Expanda
cada cuadro de grupo haciendo clic en su título para ver todos los campos.
Capítulo 5: Operadores e iconos 191
Operadores
Sintaxis de expansión de macros
En versiones anteriores de CA Process Automation se podía utilizar una variable en un
campo de operador personalizado que aceptaba una expresión como entrada. El
operador base era compatible con el uso de variables y las sustituía dinámicamente con
valores reales, un concepto que se conoce como expansión de macros. Los operadores
personalizados que se importan de versiones anteriores siguen siendo compatibles con
variables dinámicas y la expansión de macros en esta versión de CA Process Automation.
Sin embargo, para algunos operadores base, concretamente los que tienen una ficha
Paneles personalizados, los campos no son compatibles con la expansión de macros con
sólo un nombre de variable. Los ejemplos incluyen los operadores Asignar tarea de
usuario e Invocar métodos SOAP. Agregue el término operator al campo para evaluar la
expresión y la expansión de la macro, en el caso de que sean compatibles. El gráfico
siguiente demuestra la sintaxis que se requiere para reemplazar las variables varUserID
y varUserPassword dinámicamente:
Operator.varUserID
Operator.varUserPassword
Operador personalizado: Ficha Propiedades
Utilice esta ficha para almacenar el nombre, la descripción y las etiquetas de palabra
clave para su operador personalizado. Las propiedades básicas de esta ficha funcionan
la misma forma que para todos los objetos de automatización.
192 Guía del diseñador de contenido
Operadores
Operador personalizado: Ficha Versiones
Utilice esta ficha para gestionar las versiones de su operador personalizado. Las
versiones funcionan de la misma forma para todos los objetos de automatización.
Operador personalizado: Ficha Pista de auditoría
Utilice esta ficha para examinar el historial de su operador personalizado. Las pistas de
auditoría funcionan de la misma forma para todos los objetos de automatización.
Definición de la disponibilidad del operador personalizado como Todos los usuarios
De forma predeterminada, un operador personalizado no está disponible para otros
diseñadores de CA Process Automation. Se puede definir la disponibilidad de los
operadores personalizados para todos los usuarios.
La disponibilidad de un operador personalizado sólo afecta a la capacidad de verlo y
agregarlo a un proceso o una planificación. Una vez que se agrega un operador
personalizado a un proceso o una planificación, eliminar su disponibilidad no afecta a su
inclusión existente y uso.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga doble clic en un operador personalizado.
Se muestra el cuadro de diálogo Operador personalizado.
3.
En la barra de herramientas:
a.
Haga clic en Dar disponibilidad para permitir a todos los usuarios consultar y
utilizar el operador.
b. Haga clic en Eliminar disponibilidad para ocultar el operador de otros usuarios.
El cambio de disponibilidad es instantáneo al hacer clic en Guardar.
Capítulo 5: Operadores e iconos 193
Operadores
Publicación de una configuración de grupo de operadores personalizados en otro dominio
Cuando se define un grupo de operadores personalizados, el grupo se publica
automáticamente en el Dominio actual y en todos los entornos del Dominio.
Cuando se realiza una importación a un Dominio diferente, el proceso permite publicar
el grupo de operadores personalizados en ese Dominio y en todos sus entornos. La
opción Publicar configuración del grupo del operador del cliente requiere derechos
Group_Config_Admin. Los administradores (los miembros del grupo PAMAdmins) tienen
este derecho.
Lleve a cabo los pasos siguientes:
1.
En el explorador de bibliotecas para el orquestador seleccionado, seleccione el
destino de los elementos importados.
2.
Haga clic con el botón secundario del ratón en la carpeta principal y, a continuación,
seleccione Importar.
3.
Haga clic en Examinar, busque el archivo .xml en la ventana Abrir y, a continuación,
haga clic en Abrir.
4.
Seleccione una de las opciones siguientes para especificar cómo se deben gestionar
los objetos con nombres conflictivos. Si se importa en una carpeta vacía, no puede
haber ningún tipo de conflicto.
5.
■
Importar
■
Importar y reemplazar
■
No importar
(Opcional) Active la casilla de verificación Establecer la versión importada como
actual.
Esta opción es relevante si se ha seleccionado Importar como nueva versión y
mantener el objeto existente en el paso 4.
6.
Active la casilla de verificación Dar disponibilidad a los operadores personalizados
importados.
No se pueden utilizar operadores personalizados hasta que están disponibles.
7.
Active la casilla de verificación Publicar configuración del grupo del operador del
cliente.
Al efectuar la publicación, los grupos de operadores personalizados se publican en
el Dominio de importación y en todos los entornos de este Dominio.
8.
Haga clic en Enviar.
9.
Haga clic en Aceptar en el mensaje que confirma que la importación es correcta.
La importación vuelve a crear la estructura de la carpeta exportada en la ubicación
seleccionada, importa los operadores personalizados y publica el grupo de
operadores personalizados junto con las variables relacionadas.
194 Guía del diseñador de contenido
Operadores
Uso de operadores personalizados
Se puede utilizar un operador personalizado en un proceso o una planificación como
cualquier otro operador. Tenga presentes estos puntos al trabajar con operadores
personalizados:
■
Los valores iniciales de los parámetros de operador personalizados se pueden
configurar previamente u ocultarse.
■
Pueden existir nuevas entradas de parámetro personalizadas que requieran
configuración.
■
Su operador personalizado aparecerá en una carpeta llamada No categorizado a
menos que establezca un nombre de grupo personalizado en la ficha Parámetros
del cuadro de diálogo Operador personalizado.
■
Si un operador personalizado no está disponible cuando se abre un proceso para
editarlo, dé disponibilidad al operador personalizado y actualice la carpeta del
grupo de operadores de nuevo.
■
Si un operador personalizado no está disponible cuando se abre una planificación
para editarla, dé disponibilidad al operador personalizado y actualice la carpeta del
grupo de operadores de nuevo.
■
Se debe actualizar la carpeta del grupo de operadores en un proceso o una
planificación para ver los cambios que se hayan producido en el nombre
personalizado del operador u otros valores de configuración.
■
Se debe cerrar y volver a abrir un proceso o una planificación para poder ver los
cambios que se produzcan en operadores personalizados existentes.
■
Nota: Cualquier proceso o planificación que utilice un operador personalizado usa la
última versión incorporada marcada como Actual en el explorador de bibliotecas.
Capítulo 5: Operadores e iconos 195
Operadores
Edición de valores de operadores personalizados
Los grupos de operadores personalizados proporcionan valores predeterminados a las
variables personalizadas. Los operadores personalizados que se asignan a un grupo de
operadores personalizados comparten esas variables y valores. Se pueden aceptar los
valores de nivel de grupo o se pueden asignar valores diferentes a las variables de un
operador personalizado.
Nota: Los valores de grupo se establecen en el nivel Dominio. Todos los entornos del
Dominio heredan estos valores de grupo. A diferencia de las categorías de operadores,
los valores de los grupos de operadores personalizados no se pueden anular en el nivel
del orquestador ni del agente. Sin embargo, los valores heredados en el nivel del
operador personalizado sí se pueden cambiar.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Diseñador.
2.
Haga clic en la lista desplegable Ver y seleccione Operadores, Conjunto de Datos y
Propiedades.
3.
Expanda el nombre del grupo de operadores personalizados en la lista Operadores y
arrastre el operador personalizado seleccionado hasta el lienzo.
4.
Haga doble clic en el operador personalizado.
5.
Revise el valor de cada variable personalizada. Puede aceptar el valor heredado o
especificar el valor que desee.
6.
Haga clic en Guardar.
Cómo trabajar con operadores personalizados protegidos
CA Technologies puede publicar operadores personalizados protegidos. El icono de
bloqueo indica que el operador personalizado está protegido:
El uso de operadores personalizados protegidos se limita a los casos siguientes:
■
No se puede ver el código definido en el operador personalizado protegido. Se
encriptan los parámetros de entrada, el código de ejecución previa y el de ejecución
posterior.
■
No se puede modificar la versión importada.
■
No se puede modificar ni consultar el código en una copia de la versión importada.
196 Guía del diseñador de contenido
Operadores
Sus operadores favoritos
Esta práctica función permite agregar sus operadores favoritos a la carpeta o grupo
Favoritos. El grupo Favoritos aparece en la parte superior de la paleta Operadores en el
diseñador de procesos.
Haga clic en Actualizar en la paleta Operadores para ver sus operadores favoritos
cuando diseñe un proceso.
Cómo agregar o eliminar sus operadores favoritos
Se pueden agregar y eliminar operadores favoritos de la carpeta de grupo de favoritos
en la paleta Operadores.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Diseñador.
2.
Abra un proceso o cree un proceso.
3.
En la barra de herramientas, haga clic en el menú Ver y seleccione Operadores.
Aparecerá la paleta Operadores.
4.
En el área de filtro en la parte superior de la paleta Operadores, haga clic en
Actualizar.
La lista de operadores, operadores personalizados y operadores favoritos se
actualiza.
5.
Expanda la carpeta de favoritos para ver los operadores que se han agregado. En el
caso de los usuarios nuevos, no aparece ningún operador.
6.
Para agregar un operador a su carpeta de favoritos:
a.
Expanda cualquier otra carpeta de operadores.
b. Haga clic con el botón secundario del ratón en un operador y seleccione
Agregar a favoritos.
c.
7.
Haga clic en Actualizar.
Para eliminar un operador de su carpeta de favoritos:
a.
Haga clic en Actualizar.
b. Expanda la carpeta de favoritos para ver los operadores que se han agregado.
c.
Haga clic con el botón secundario del ratón en un operador y seleccione
Eliminar de los favoritos.
Capítulo 5: Operadores e iconos 197
Operadores
Conectores
Los conectores son extensiones opcionales de CA Process Automation que activan
operadores que se conectan con otras soluciones de terceros y de CA. Cuando su
administrador configura un conector, un nuevo grupo de operadores aparece en la
paleta Operadores en el diseñador de procesos.
Los conectores integran los productos de terceros y de CA en los procesos del workflow
y proporcionan servicios de puente desde otros productos hasta soluciones y productos
de CA que incorporan CA Catalyst. Se pueden descargar otros conectores, además de los
conectores proporcionados en los medios de instalación de CA Process Automation.
Pueden aplicarse restricciones de licencias. Esta es una lista de los conectores más
populares:
■
Amazon Web Services (AWS)
■
BMC Remedy
■
CA Client Automation
■
CA CMDB
■
CA Configuration Automation
■
CA eHealth
■
CA NSM
■
CA Service Desk Manager
■
CA Spectrum IM
■
CA Workload Automation AE
■
IBM AS/400
■
IBM z/OS
■
Microsoft Hyper-V
■
VMware vSphere
Use conectores específicos de la aplicación para realizar tareas, por ejemplo, recopilar
datos o aplicar acciones, en sistemas y aplicaciones objetivo. Los conectores
proporcionan operadores que se ejecutan en las ubicaciones siguientes:
■
En el orquestador.
■
En agentes que residen en el servidor de aplicaciones.
■
En agentes de proxy que pueden realizar remotamente la tarea necesaria o
recopilar los datos en el servidor de aplicaciones.
Cada módulo de conector suele incluir varios operadores. Cada operador realiza una de
las tareas especializadas siguientes:
Compatibilidad con el árbol de decisiones
198 Guía del diseñador de contenido
Operadores
Devuelve un valor binario (verdadero/falso, correcto/erróneo) que se puede utilizar
para decidir cómo ramificar el proceso. En algunas situaciones, el valor devuelto
puede tener más de dos opciones. Sin embargo, el valor devuelto es siempre un
conjunto pequeño y bien definido de posibles valores.
Recolección de datos
Recopila más conjuntos de datos complejos de la aplicación objetivo. El resultado se
almacena normalmente en un conjunto de datos local donde otros operadores
pueden analizarlo más en profundidad. Si es necesario, los datos también se
pueden hacer globales para que otros procesos puedan utilizarlos.
Gestión activa
Realiza acciones en el sistema objetivo, incluidos todos los operadores que
modifican el comportamiento del sistema objetivo de cualquier manera. Por
ejemplo:
■
Envío de un evento
■
Reconfiguración de la aplicación
■
Inicio o detención de un servicio relacionado
En algunos casos, un único operador puede desempeñar más de una de estas funciones.
Por ejemplo, se puede ejecutar un conector, el cual devuelve un conjunto de resultados
basado en la acción del conector.
CA Process Automation incluye diversos conectores. Crear conectores y operadores
relacionados es muy fácil siguiendo uno de estos métodos:
■
Mediante la ejecución de archivos ejecutables estándares, específicos de la
aplicación que están en el agente.
■
Mediante el uso de lenguajes de generación de scripts estándares para realizar
funciones más complejas.
Para minimizar el tamaño de la aplicación y la complejidad de la interfaz del usuario,
solamente se instalan de forma predeterminada un conjunto de conectores genéricos
de uso frecuente. Se recomienda instalar los otros conectores solamente cuando sea
necesario.
Capítulo 5: Operadores e iconos 199
Iconos de operadores
Iconos de operadores
CA Process Automation proporciona iconos predeterminados que se muestran para los
operadores cuando estos se ubican en un proceso o una planificación. El icono
predeterminado se puede reemplazar por un icono que se especifique (un icono
personalizado). Se puede asignar un icono personalizado a cualquier operador en un
proceso, incluidos los operadores personalizados.
CA Process Automation automáticamente gestiona los indicadores visuales más
pequeños que representan el estado de un operador en un proceso. Por ejemplo, los
gráficos más pequeños que aparecen en las esquinas de todos los iconos representan
los distintos estados de ejecución de un proceso, por ejemplo, inactivo, en ejecución,
completado y error.
Iconos de estado del operador
El gráfico siguiente muestra un subconjunto menor de iconos que un operador puede
mostrar para indicar las opciones de estado y puerto.
Element Descripción:
o:
Punto de interrupción: este icono indica que se ha configurado un punto de interrupción en el proceso
en este operador. Haga clic en Establecer punto de interrupción en la barra de herramientas.
200 Guía del diseñador de contenido
Iconos de operadores
Element Descripción:
o:
Modo de simulación: este icono indica que está ignorando las opciones de simulación y ha establecido
el tipo de simulación del operador como local o a distancia. En la paleta Propiedades, expanda
Simulación.
Código de ejecución previa: este icono indica la presencia de código de JavaScript que se ejecuta antes
de que se produzca la ejecución del operador. En la paleta Propiedades, expanda Configuración de
ejecución.
Código de ejecución posterior: este icono indica la presencia de código de JavaScript que se ejecuta
después de que se produzca la ejecución del operador. En la paleta Propiedades, expanda
Configuración de ejecución.
Puerto personalizado: el proceso fluye por un puerto personalizado cuando su expresión
predeterminada es verdadera.
Puerto de tiempo de espera: el proceso fluye por este puerto cuando el operador supera el tiempo de
espera.
Puerto erróneo: el proceso fluye por este puerto cuando el operador ofrece un resultado fallido o
produce un fallo.
Puerto completado: el proceso fluye por este puerto cuando el operador ofrece un resultado correcto.
Cuando se ejecuta un proceso, los iconos siguientes indican el estado de cada operador.
Element Descripción:
o:
Anulado: el proceso se ha detenido.
En ejecución: el proceso se está ejecutando.
Erróneo: el proceso falló en este operador concreto.
Completado: el proceso ha transferido correctamente este operador concreto.
Tiempo de espera: el proceso ha superado el tiempo de espera en este operador concreto.
Capítulo 5: Operadores e iconos 201
Iconos de operadores
Creación, edición y aplicación de iconos personalizados
Los iconos personalizados son identificadores visuales de un operador. Ayudan a
identificar la función específica de un operador. Se pueden crear iconos personalizados
en cualquier carpeta de la biblioteca de automatización y aplicarlos a cualquier
operador. Cada icono muestra la elección de imagen base con una imagen modificadora
superpuesta en la esquina inferior derecha de la base. Las imágenes base (objeto) y
modificadora (acción) proporcionan una estructura coherente para todos los iconos.
En los temas de esta sección se describe por qué y cómo el Diseñador de contenido de
CA Process Automation utiliza iconos personalizados para personalizar el aspecto de los
operadores. Esta sección también proporciona ejemplos.
Como diseñador de procesos, confía en las pistas visuales que proporcionan los iconos
para determinar la finalidad de cada operador. Por ejemplo, ¿cuál diría que es la función
del siguiente icono de operador?
Incluso sin una etiqueta, se puede deducir de la imagen que este icono representa un
operador Suprimir correo electrónico. Un icono apropiado ayuda al usuario y a otros
diseñadores a comprender la funcionalidad de un operador.
La inversión inicial de tiempo en asignar un icono apropiado ofrece muchas ventajas,
como las siguientes:
Estandarización
Al usar un conjunto estándar de imágenes base y modificadoras, se ayuda a los
diseñadores a comprender el objeto que realiza la acción.
Simplicidad
Los diseñadores pueden identificar fácilmente los operadores incluso en los
procesos más complejos y de mayor envergadura.
Compartir
Los equipos de diseñadores que trabajan en otros idiomas pueden compartir
diseños de proceso porque son más fáciles de entender.
202 Guía del diseñador de contenido
Iconos de operadores
Utilice el siguiente diagrama de flujo como punto de partida para personalizar los iconos
de sus operadores de proceso:
No se requiere ninguna secuencia para realizar las tareas listadas. Dispone de las
opciones siguientes en cualquier momento para personalizar iconos:
■
Aplicar un icono personalizado a cualquier operador de un proceso (en la
página 206): Mientras se diseña un proceso, se puede cambiar el icono para que
cualquier operador personalice su aspecto solamente para una sola instancia.
Seleccione una instancia específica de un operador y cambie su icono por uno de los
objetos de icono personalizados predefinidos en la biblioteca.
■
Aplicar un icono personalizado a un operador personalizado (en la página 207):
Cuando se cambia un icono de operador personalizado, la elección del icono se
aplica a todas las instancias de ese operador. Además, todos los diseñadores
pueden ver el nuevo icono para el operador personalizado en la paleta Operador.
■
Editar un icono personalizado (en la página 205): a medida que transcurre el
tiempo, se pueden editar uno o más iconos personalizados predefinidos. Los
cambios se aplican donde se esté utilizando el icono personalizado en cuestión.
■
Crear un icono personalizado (en la página 204): se pueden definir uno o más
iconos personalizados. Se puede crear una serie de iconos personalizados que se
prevé asignar a operadores u operadores personalizados. También se pueden crear
y guardar los iconos personalizados sin saber de antemano dónde se van a utilizar
exactamente.
Capítulo 5: Operadores e iconos 203
Iconos de operadores
Creación de un icono personalizado
Se pueden crear iconos personalizados en cualquier carpeta de biblioteca de
automatización. Cada icono muestra su elección de imagen base con una imagen
modificadora superpuesta en la esquina inferior derecha de la base. La imagen base y
modificadora proporcionan una estructura coherente para todos los iconos.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
Aparece una lista jerárquica de carpetas en el panel izquierdo y todos sus objetos
de automatización se muestran en la ventana principal.
2.
(Opcional) Si el nuevo icono personalizado que se desea crear es similar a un objeto
de icono personalizado existente, selecciónelo, haga clic en Copiar y, a
continuación, Pegar.
Ahora se puede editar la copia para completar el icono personalizado. Omita el
paso siguiente.
3.
Haga clic con el botón secundario del ratón en cualquier carpeta en el panel del
explorador de bibliotecas y haga clic en Nuevo objeto, Icono personalizado.
El nuevo icono aparece en el explorador con un nombre predeterminado.
4.
Haga doble clic en el icono.
Se abre el editor de iconos personalizados.
5.
Seleccione una imagen base y una imagen modificadora. Los iconos se pueden
explorar uno a uno, se puede filtrar por el menú desplegable de categoría o se
puede introducir una búsqueda por palabra clave.
6.
Haga clic en la ficha Propiedades de objeto, introduzca o edite el nombre del icono
y, a continuación, haga clic en Guardar y Cerrar.
El nuevo icono personalizado está disponible en la biblioteca.
Por ejemplo, si se desea representar un operador llamado Informe de cargas, haría lo
siguiente:
■
Seleccione una imagen base que represente un informe.
■
Seleccione una imagen modificadora que represente la acción de carga.
204 Guía del diseñador de contenido
Iconos de operadores
Edición de un icono personalizado
Gradualmente, los iconos personalizados que el usuario y otros diseñadores creen se
pueden modificar para alinearse con otros iconos. Se pueden editar iconos
personalizados en cualquier carpeta de biblioteca de automatización. Cada icono
muestra su elección de imagen base con una imagen modificadora superpuesta en la
esquina inferior derecha de la base. La imagen base y modificadora proporcionan una
estructura coherente para todos los iconos.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
Aparece una lista jerárquica de carpetas en el panel izquierdo y todos sus objetos
de automatización se muestran en la ventana principal.
2.
Haga clic con el botón secundario del ratón sobre un icono personalizado.
3.
Haga clic en Acción, Editar.
Se abre el editor de iconos personalizados.
4.
Seleccione una imagen base y una imagen modificadora, edite el nombre del icono
y, a continuación, haga clic en Guardar.
Sus modificaciones se aplicarán al icono personalizado.
Por ejemplo, si se desea representar un operador llamado Informe de cargas, haría lo
siguiente:
■
Seleccione una imagen base que represente un informe.
■
Seleccione una imagen modificadora que represente la acción de carga.
Capítulo 5: Operadores e iconos 205
Iconos de operadores
Aplicación de un icono personalizado a cualquier operador en un proceso
Se puede cambiar el icono para cualquier operador utilizado en un proceso.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Diseñador.
2.
Haga clic en Open.
Se abrirá el cuadro de diálogo Abrir proceso.
3.
Vaya a su proceso y haga clic en Abrir.
El proceso que ha abierto aparece en una nueva ficha.
4.
Haga doble clic en un operador específico ya mostrado en el lienzo para consultar
sus Propiedades. En la barra de herramientas haga clic en el menú Vista y
compruebe las propiedades para consultar la paleta Propiedades.
5.
En la paleta Propiedades, expanda la sección Información.
6.
En la sección Información:
a.
Desactive la casilla de verificación Utilizar icono predeterminado.
Aparecerá un borde alrededor del icono actual y el botón Examinar estará
disponible.
b. Haga clic en el botón Examinar.
Aparecerá el cuadro de diálogo Seleccionar icono personalizado.
c.
Seleccione el objeto del icono personalizado que se desea utilizar para esta
instancia del operador.
d. Haga clic en Aceptar.
7.
En la barra de herramientas, haga clic en Guardar.
Nota: No se pueden cambiar los iconos asociados con el estado de ejecución de un
operador. Por ejemplo, en espera o completado. CA Process Automation gestiona
automáticamente estos iconos.
206 Guía del diseñador de contenido
Iconos de operadores
Cómo aplicar un icono personalizado a un operador personalizado
Se puede cambiar el icono para un operador personalizado. El icono que se seleccione
se aplica a todas las instancias futuras del operador personalizado en todos los
procesos. Los resultados existentes del operador personalizado en los procesos
continúan mostrando el icono predeterminado original para el operador base.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca
Aparece una lista jerárquica de carpetas en el panel izquierdo y todos sus objetos
de automatización se muestran en la ventana principal por tipo.
2.
Haga doble clic en un operador personalizado.
Se muestra la ventana Operador personalizado.
3.
En la barra de herramientas, haga clic en Extraer.
4.
Haga clic en la ficha Parámetros.
5.
En la ficha Parámetros, haga clic en el vínculo Cambiar icono.
6.
En el cuadro de diálogo Seleccionar icono personalizado, explore el icono
personalizado, selecciónelo y haga clic en Aceptar.
7.
Haga clic en Guardar.
8.
(Opcional) Si ninguno de los iconos existentes es el apropiado se debe editar un
icono personalizado o crean uno nuevo.
Nota: No se pueden cambiar los iconos asociados con el estado de ejecución de un
operador personalizado. Por ejemplo, en espera o completado. CA Process Automation
gestiona automáticamente estos iconos.
Ejemplos de iconos personalizados
La lista siguiente muestra ejemplos de iconos personalizados y los operadores que
podrían representar.
Diagnóstico (o monitorización) del rendimiento
Agregar cuenta de usuario
Script o código de depuración
Capítulo 5: Operadores e iconos 207
Iconos de operadores
Ejemplo: Creación o edición de un icono personalizado
El siguiente ejemplo muestra los conceptos clave del editor de iconos personalizados de
CA Process Automation. El gráfico muestra la selección de un icono base que se combina
con un icono de modificador más pequeño para crear un icono personalizado. La
combinación resultante se guarda como un objeto de icono personalizado que se puede
aplicar más tarde a cualquier operador.
208 Guía del diseñador de contenido
Iconos de operadores
Ejemplo: Aplicación de un icono personalizado
En el ejemplo siguiente, el diseñador ha decidido cambiar uno de dos iconos que son
idénticos. El operador personalizado está basado en el operador Asignar tarea de
usuario. Sin embargo, tiene una nueva finalidad clara. El operador pide a un usuario que
apruebe un informe. El icono predeterminado antiguo aparece dentro del proceso a la
izquierda (Antes) y el nuevo icono personalizado a la derecha (Después). El nuevo icono
representa mejor la función del operador seleccionado actualmente dentro del proceso.
En este ejemplo, el diseñador también ha decidido mostrar el nombre largo del
operador.
Imagine un proceso con muchos operadores similares organizados en una serie. Cada
operador podría realizar una acción diferente. En esta situación, utilice iconos
personalizados para ayudarle a identificar cada operador.
Capítulo 5: Operadores e iconos 209
Capítulo 6: Conjuntos de datos y
parámetros
Esta sección contiene los siguientes temas:
Conjuntos de datos (en la página 211)
Parámetros del proceso (en la página 231)
Conjuntos de datos
Los conjuntos de datos permiten definir grupos de variables para almacenar y organizar
datos. Los conjuntos de datos suponen un modo de compartir datos entre varias
instancias de proceso.
Un objeto de conjunto de datos define una recopilación de variables a las que se puede
hacer referencia por su nombre. Se crean y gestionan conjuntos de datos en el
explorador de bibliotecas al igual que otros objetos de automatización para un
orquestador. Un conjunto de datos puede contener cualquier número de campos,
llamados variables. Asigne cada variable a uno de los siguientes tipos de datos según el
tipo de datos que almacena la variable:
■
Booleano
■
Fecha
■
Cadena
■
Entero
■
Objeto de Java
■
Largo
■
Doble
■
Contraseña
■
Referencia de objeto
■
ValueMap
Se pueden configurar todos los tipos de datos para que contengan un solo valor o varios
valores indexados (en lo que se denomina matriz). Se puede definir un campo indexado
como una matriz de una o varias dimensiones.
Capítulo 6: Conjuntos de datos y parámetros 211
Conjuntos de datos
Se pueden editar objetos de conjunto de datos y conjuntos de datos de operador
personalizados en el explorador de bibliotecas. Se pueden editar conjuntos de datos
para procesos y cada operador en el diseñador de procesos.
Element Descripción:
o:
Conjuntos de datos en el explorador de bibliotecas: cree, edite y gestione sus propios objetos de
conjunto de datos en el explorador de bibliotecas. Abra un conjunto de datos para editarlo.
Conjuntos de datos de operador personalizados: cree, edite y gestione sus propios conjuntos de datos
para objetos de operador personalizados en el explorador de bibliotecas. Abra un operador
personalizado para editar su conjunto de datos.
212 Guía del diseñador de contenido
Conjuntos de datos
Element Descripción:
o:
Conjuntos de datos en el diseñador de procesos: la paleta Conjunto de datos muestra los conjuntos
de datos disponibles para el proceso y cada operador. También puede hacer referencia a sus propios
conjuntos de datos en el código. Haga clic en el icono
para abrir un cuadro de diálogo en el que
podrá editar el conjunto de datos del operador o del proceso seleccionado.
Páginas, variables, tipos de datos y valores: defina las páginas y las variables del conjunto de datos en
la mitad izquierda del cuadro de diálogo. Defina los tipos de datos e introduzca una descripción en la
mitad derecha. Defina valores en cualquiera de los dos lados. Haga clic con el botón secundario del
ratón en el nombre de la variable de una matriz para agregar un valor indexado.
Crear un objeto de conjunto de datos denominado
Se crean y gestionan objetos de conjunto de datos denominado con sus otros objetos de
automatización en el explorador de bibliotecas.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de carpetas del explorador de bibliotecas, seleccione una carpeta.
3.
En la barra de herramientas, haga clic en Nuevo y seleccione Conjunto de datos.
Aparece un nuevo objeto de conjunto de datos y está extraído para el usuario.
4.
Introduzca un nombre para el nuevo conjunto de datos.
5.
Haga doble clic en el conjunto de datos para definir sus páginas y campos.
Se abre el cuadro de diálogo Conjunto de datos.
Capítulo 6: Conjuntos de datos y parámetros 213
Conjuntos de datos
Tipos de conjuntos de datos
Las variables de conjunto de datos (también llamadas campos) pueden contener valores
literales que se definen explícitamente en el objeto de conjunto de datos. También se
pueden asignar valores a variables (campos) en tiempo de ejecución mediante
expresiones. Remítase a objetos de conjunto de datos y sus variables por su nombre
utilizando expresiones de JavaScript en parámetros calculados.
Se pueden crear y configurar variables de conjunto de datos para todos los tipos de
conjuntos de datos, excepto el conjunto de datos del sistema. Haga referencia a
variables de conjunto de datos de sistema directamente. Se puede hacer referencia a
conjuntos de datos de operador y proceso a través de objetos de operador o proceso
padre. En la tabla siguiente se describen los tipos de conjuntos de datos.
Tipo de
conjunto de
datos:
Descripción y alcance:
Para hacer referencia en
una expresión:
Conjunto de
datos
denominado
Los objetos de conjunto de datos almacenan la definición de un
conjunto de datos denominado en el explorador de bibliotecas.
Cualquier operador, proceso o planificación de la misma biblioteca
puede acceder a las variables de conjunto de datos denominado.
Se puede editar la versión actual de un conjunto de datos
denominado expandiendo la carpeta de la biblioteca y haciendo
doble clic en el objeto de conjunto de datos.
Consulte Especifique las
variables del conjunto de
datos denominadas (en la
página 268).
Conjunto de
datos del
proceso
Los conjuntos de datos de proceso contienen variables que el
usuario u otro diseñador define. CA Process Automation también
puede definir variables de proceso automáticamente cuando se
inicia una instancia de proceso. Los conjuntos de datos de proceso
aparecen en la paleta Conjunto de datos del diseñador de
procesos.
Consulte Cómo especificar
las variables del conjunto
de datos del proceso (en la
página 269).
Conjunto de
datos de
operador
En todas las instancias de un operador agregado a un objeto de
proceso o planificación se incluye un conjunto de datos del
operador. El conjunto de datos del operador puede contener
parámetros del operador, variables definidas por el usuario y
variables definidas mediante programación. Un conjunto de datos
del operador es ante todo accesible al operador más próximo y, en
segundo lugar, a otros operadores de un proceso. Los conjuntos
de datos de operador aparecen en conjuntos de datos de proceso
en la paleta Conjunto de datos del diseñador de procesos.
Consulte Cómo especificar
las variables del conjunto
de datos del operador (en
la página 271).
Conjunto de
datos del
sistema
Contiene variables predefinidas que están disponibles en el
contexto del dominio de CA Process Automation completo. Estas
variables acceden a parámetros del sistema y se encuentran
disponibles mediante la palabra clave System.
Consulte Cómo especificar
las variables del conjunto
de datos del sistema (en la
página 272).
214 Guía del diseñador de contenido
Conjuntos de datos
Definir páginas de conjuntos de datos y variables
Defina las páginas, las variables y los valores de un conjunto de datos. Cuando se ejecuta
un proceso, los operadores pueden hacer referencia a los valores de los conjuntos de
datos.
Los nuevos conjuntos de datos denominados y los conjuntos de datos de proceso
incluyen una página de raíz predeterminada llamada Parámetros. Las páginas y las
variables de los conjuntos de datos de operador varían por operador. Se pueden crear
nuevas variables (campos) o editar variables existentes. También se pueden agregar
páginas para agrupar variables de maneras lógicas. Para editar una variable existente o
su valor, haga clic en la variable o su valor y, a continuación, introduzca sus cambios.
También se pueden cambiar los valores de las variables (campos) de un conjunto de
datos mediante programación.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta y busque un conjunto de datos. Utilice las funciones de
búsqueda opcionales si es necesario.
3.
Haga doble clic en el conjunto de datos.
Aparece la ficha Conjunto de datos del cuadro de diálogo Conjunto de datos.
4.
Haga clic en Extraer.
5.
Para crear una página, haga clic en Agregar página.
6.
Para crear una variable:
a.
Seleccione una página.
b. Haga clic en Agregar variable.
7.
Para renombrar una página o una variable, haga doble clic en ella. Los nombres
deben empezar con una letra y deben tener una longitud máxima de 32 caracteres.
8.
En el caso de las variables, seleccione el tipo de datos y la página, introduzca un
valor inicial y proporcione una descripción opcional.
Página
Define la página que contiene la variable. Para mover la variable a una página
diferente, seleccione esa página. En el caso de los operadores personalizados,
la página especificada aquí corresponde a un grupo de propiedades expandible
en la paleta Propiedades.
Descripción
(Opcional) Proporciona información útil acerca de la variable cuando aparece
más adelante en un conjunto de datos. Si se introduce texto aquí, este se
mostrará en forma de sugerencia al pasar el puntero del ratón por el nombre o
el valor del campo.
Valor
Capítulo 6: Conjuntos de datos y parámetros 215
Conjuntos de datos
Especifica el valor predeterminado si el campo está vacío (borrado). Para los
campos del tipo entero, largo y doble, el valor predeterminado es cero. Para los
campos de tipo entero, doble, largo o cadena, puede especificar aquí su propio
valor predeterminado. Para consultar el contenido del campo Valor en otra
ventana, haga clic con el botón secundario del ratón en el campo Valor y elija
Expandir.
Nota: La opción Expandir está disponible únicamente para el tipo de datos de
cadena.
También se pueden introducir restricciones para un campo de esto tipos:
■
Para los campos de tipo booleano, se puede seleccionar Verdadero o Falso.
■
Para los campos de tipo de referencia de objeto, haga clic en el botón
Examinar (...) para seleccionar un objeto de conjunto de datos.
■
Para los campos de tipo fecha, haga clic en el botón Examinar (...) para
seleccionar una fecha.
■
Los campos Objeto de Java son de solo lectura.
Nota: No se puede asignar un valor predeterminado al tipo de campo
ValueMap.
9.
Para definir matrices:
a.
En la ficha General, seleccione la casilla de verificación Matriz y seleccione
Único o Doble en el campo Dimensión de matriz.
b. Haga clic con el botón secundario del ratón en la variable y seleccione Agregar
valor indexado.
c.
Haga clic en el campo Valor para introducir un valor.
Nota: Para editar el conjunto de datos de un operador personalizado, ábralo, extráigalo
y haga clic en la ficha Conjunto de datos. También se pueden editar conjuntos de datos
de operador y proceso haciendo clic
datos, en el Diseñador de procesos.
en la barra de título de la paleta Conjunto de
Tipos de datos de variables
Los tipos de datos de la variable del conjunto de datos apuntan a los tipos de valor de
JavaScript.
Estos son los distintos tipos de datos para las variables:
Booleano
Se almacena y devuelve Verdadero o Falso.
En expresiones, este tipo se asigna al tipo de datos booleanos de JavaScript.
216 Guía del diseñador de contenido
Conjuntos de datos
Referencia de objeto
Hace referencia a cualquier tipo de objeto disponible en CA Process Automation,
incluidos los objetos disponibles en una biblioteca de automatización, un punto de
contacto y grupos de punto de contacto.
Fecha
Se almacena y devuelve una fecha en un formato de fecha especificado en las
propiedades del parámetro.
En expresiones, este tipo se asigna al objeto de fecha de JavaScript.
Doble
Se almacena y devuelve un valor decimal. Los valores dobles se introducen en el
formato siguiente:
[digits][.digits][(E|e)[(+|-)]digits]
En expresiones, este tipo se asigna al tipo literal de punto flotante de JavaScript. El
literal tiene un valor mínimo de -1.7976931348623157E308 y un valor máximo de
1.7976931348623157E308.
Entero
Se almacena y devuelve un valor de entero de 16 bits. Un campo de entero puede
devolver un solo entero o una lista indexada de enteros. El entero permite
representar todos los enteros hasta un máximo de diez dígitos, de -2,147,483,648 a
+2,147,483,647.
En expresiones, este tipo de valor se asigna al tipo de entero de JavaScript.
Objeto de Java
Almacena un objeto de Java.
Largo
Se almacena y devuelve un entero de 32 bits. El tipo de datos largo permite
representar todos los enteros hasta 19 dígitos, de -9,223,372,036,854,775,808 a
+9,223,372,036,854,775,807.
En expresiones, este tipo de valor se asigna al tipo de entero de JavaScript.
Contraseña
Devuelve una contraseña en el formato encriptado. Los valores del campo de
contraseña sólo se pueden asignar a otros campos de contraseña. A los usuarios no
autorizados se les impide ver contraseñas en un formato no encriptado.
Nota: CA Process Automation protege contraseñas de cualquier modificación. Las
operaciones como la concatenación y manipulación de cadenas en las contraseñas
generan un valor nulo.
Capítulo 6: Conjuntos de datos y parámetros 217
Conjuntos de datos
Cadena
Devuelve una cadena de caracteres. Un campo de cadena puede devolver una sola
cadena o una lista indexada de cadenas.
En expresiones, este valor se asigna al tipo de cadena de JavaScript.
ValueMap
Define una estructura del conjunto de datos almacenada en otro conjunto de datos.
Se pueden agregar páginas y variables a un campo ValueMap. Las variables y
páginas de ValueMap se pueden anidar una dentro de otra.
En campos calculados, los campos de tipo ValueMap se muestran jerárquicamente
en una ruta de un conjunto de datos. El ejemplo siguiente muestra el parámetro
param1 en el campo VMap2 de ValueMap que, a su vez, se anida en el campo de
VMap1 de ValueMap que, a su vez, pertenece al conjunto de datos MyDataset.
Process.MyDataset.VMap1.VMap2.param1
Importante: Al cambiar el tipo de conjunto de datos o la opción de casilla de verificación
Matriz, se elimina todo dato existentes en el campo. Edite el conjunto de datos
solamente si es aceptable descartar algún valor actual en el campo.
Configuración de validación para variables de conjunto de datos
Cuando se selecciona el tipo variable, se puede especificar exactamente qué tipo de
datos el usuario puede introducir. Las restricciones que se pueden aplicar a un valor
dependen del tipo de datos seleccionado. La tabla siguiente incluye las restricciones
potenciales de los distintos tipos de datos en un conjunto de datos de operador.
Tipo de dato
Validaciones
Booleano
Ninguno
Fecha
Ninguno
Doble
Especifica valores mínimos y máximos para una variable de tipo
Doble entre el valor mínimo 1.7976931348623157E308 y el valor
positivo 1.7976931348623157E308.
El valor mínimo es el valor mínimo permitido para valores dobles.
El valor máximo es el valor máximo permitido para valores dobles.
Entero
Especifica valores mínimos y máximos para una variable de tipo
Entero entre el valor mínimo 2147483648 y el valor positivo
2147483647.
El valor mínimo es el valor mínimo permitido para valores enteros.
El valor máximo es el valor máximo permitido para valores enteros.
JavaObject
218 Guía del diseñador de contenido
Ninguno
Conjuntos de datos
Tipo de dato
Validaciones
Largo
Especifica valores mínimos y máximos para una variable de tipo Largo
entre el valor mínimo 9223372036854775808 y el valor positivo
9223372036854775807.
El valor mínimo es el valor mínimo permitido para valores largos.
El valor máximo es el valor máximo permitido para valores largos.
Objeto
Ninguno
Contraseña
Ninguno
Cadena
Ninguno
ValueMap
Ninguno
Matrices con valores indexados
Se puede definir una variable de conjunto de datos para almacenar un solo valor o una
matriz de valores indexados. Se puede obtener acceso a cada valor de una matriz
indexada. Se pueden definir los campos indexados en una matriz de dimensión única o
doble.
Cada dimensión de una matriz empieza con el valor indexado [0] y continúa en la
secuencia con [1], [2] y luego [3], y puede continuar con cualquier número de valores
adicionales. En las expresiones, represente una dimensión o nivel de una matriz con la
notación entre paréntesis. Cada nivel de una matriz es compatible con propiedades de
matrices y métodos de JavaScript.
El tipo de campo predeterminado almacenará un solo valor. Para especificar que un
campo almacene una lista indexada de valores, seleccione la casilla de verificación
Matriz y configure los valores indexados.
Capítulo 6: Conjuntos de datos y parámetros 219
Conjuntos de datos
Definición de ValueMap como matriz
Se puede crear un ValueMap, definir sus variables y se pueden incluir matrices en el
ValueMap. Se puede decidir incluso definir un ValueMap como una matriz. Cada
variable del ValueMap representa una estructura que se define en el conjunto de datos
bajo Tipo de elemento.
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta y busque un conjunto de datos. Utilice las funciones de
búsqueda opcionales o cree un conjunto de datos si es necesario.
3.
Haga doble clic en el conjunto de datos.
Aparece la ficha Conjunto de datos del cuadro de diálogo Conjunto de datos.
4.
Haga clic en Extraer.
5.
Seleccione una página. La página predeterminada se llama Parámetros.
6.
En la barra de herramientas, haga clic en Agregar variable.
7.
En la ficha General:
a.
Establezca el Tipo como ValueMap.
b. No haga clic en la casilla de verificación Matriz.
8.
Expanda la nueva variable ValueMap y seleccione una página. La página
predeterminada se llama Parámetros.
9.
En la barra de herramientas, haga clic en Agregar variable.
10. En la ficha General:
a.
Establezca el tipo de archivo.
b. Introduzca un valor inicial.
c.
Seleccione la casilla de verificación Matriz.
11. Repita los últimos tres pasos. Seleccione una página, haga clic en Agregar variable y
defina la variable como una matriz.
12. Expanda la variable ValueMap y la página. Haga clic con el botón secundario del
ratón en la primera variable y seleccione Agregar valor indexado.
13. Repita el último paso.
14. Haga clic con el botón secundario del ratón en la segunda variable y seleccione
Agregar valor indexado.
15. Repita el último paso.
Ha definido un ValueMap formado por dos matrices.
16. Haga clic en la variable ValueMap original.
17. En la ficha General, seleccione la casilla de verificación Matriz.
La carpeta Tipo de Elemento aparece bajo la variable de ValueMap.
220 Guía del diseñador de contenido
Conjuntos de datos
18. Expanda Tipo de elemento completamente para consultar las páginas, variables y
valores indexados.
19. Haga clic con el botón secundario del ratón en la variable de ValueMap original y
elija Agregar valor de índice.
Aparece el índice de matriz [0].
20. Expanda el índice de matriz [0]. Se copian las páginas, las variables y los valores
indexados desde la estructura Tipo de elemento.
Cuando se agrega una variable a una página bajo Tipo de elemento, todas las entradas
de índice de matriz de valuemap existentes incluyen inmediatamente la nueva variable
bajo la página correspondiente.
Cuando se suprime una variable a una página bajo Tipo de elemento, todas las entradas
de índice de matriz de valuemap existentes dejan de incluir inmediatamente la nueva
variable bajo la página correspondiente.
Cuando se especifican valores para las variables bajo Tipo de elemento, los valores se
convierten en los valores predeterminados para cualquier nueva entrada indexada de la
matriz de ValueMap. Los nuevos valores de Tipo de elemento no se propagan a entradas
de índice existentes de la matriz de ValueMap.
Modificación de un conjunto de datos
Se puede modificar un conjunto de datos agregando valores indexados o modificando
datos variables. Este procedimiento proporciona menos capacidades que las tareas de
conjunto de datos más robustas de definición de páginas y variables.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón derecho en un conjunto de datos y seleccione Modificar
conjunto de datos.
3.
En la ventana Modificar conjunto de datos:
a.
Haga clic con el botón secundario del ratón en una variable de matriz y elija
Agregar valor indexado para agregar una entrada a la matriz.
b. Haga clic en un valor para agregarlo o cambiarlo directamente.
Capítulo 6: Conjuntos de datos y parámetros 221
Conjuntos de datos
Consulta o copia de una expresión de conjunto de datos
Utilice este procedimiento para consultar o copiar la referencia completa a una matriz
de conjunto de datos o un valor específico.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En la biblioteca, realice una de las siguientes acciones:
■
Haga doble clic en el conjunto de datos.
■
Haga clic con el botón secundario del ratón en un conjunto de datos y elija
Editar.
■
Haga clic con el botón derecho del ratón en un conjunto de datos y haga clic en
Modificar conjunto de datos.
3.
En la ventana que se abre, haga clic en una matriz o una variable específica para
verla.
4.
Haga clic con el botón secundario del ratón en la matriz o en la variable y haga clic
en Ver expresión.
Se abre la ventana Expresión del conjunto de datos.
5.
Vea o copie la expresión. La expresión también se puede arrastrar hasta un campo
de destino que acepte expresiones y admita la función de arrastrar y soltar.
Lectura de valores del sistema operativo en variables de un conjunto de datos
CA Process Automation puede leer los valores que genera un proceso de shell en
variables de un conjunto de datos. Antes de que un operador de script UNIX o Windows
ejecute su script asociado, se crea una carpeta para aceptar los valores que genere el
script. La variable de entorno C2OSVD especifica la ruta completa a la carpeta (por
ejemplo, C:\TMP\_VS_559) que se crea para el operador de script. Un script puede
entonces copiar datos a archivos de texto en la carpeta para transferir los datos de
vuelta a CA Process Automation. Los datos transferidos de vuelta a CA Process
Automation mediante el directorio C2OSVD sirven para rellenar las variables del
conjunto de datos del operador de script.
222 Guía del diseñador de contenido
Conjuntos de datos
Un script debe guardar datos en archivos de texto en el directorio C2OSVD. Después de
que un operador de script finalice su script (pero antes de que realice las acciones
posteriores a la ejecución), se determina si la ubicación a la cual señala C2OSVD
contiene archivos. A continuación, CA Process Automation crea variables de conjunto de
datos del operador según las reglas siguientes:
■
El operador guarda el contenido de un archivo de la ubicación de C2OSVD en una
variable de cadena en el conjunto de datos del operador. La variable de cadena
tiene el mismo nombre que el archivo.
■
Una carpeta en la ubicación C2OSVD genera una variable indexada en el conjunto
de datos del operador con el mismo nombre que la carpeta. El operador guarda el
contenido de los archivos de texto con nombre en una secuencia numérica ubicada
en la carpeta en los elementos correspondientes de la variable indexada. Los
elementos se enumeran desde 0 hasta el número máximo de elementos que tenga
el archivo numerado más alto de la carpeta. Los archivos faltantes en la secuencia
numérica generan elementos nulos en la variable indexada.
■
CA Process Automation requiere un script para crear archivos en la ubicación
C2OSVD con los mismos nombres de las variables que se desea que aparezcan en el
conjunto de datos del operador. Si el script crea archivos de texto con extensiones
de archivo (como .txt), CA Process Automation incluye la extensión en el nombre de
la variable.
La ilustración siguiente muestra la conversión de archivo a variable cuando el directorio
de trabajo configurado es C:\TMP. El operador anexa \_VS_599 a la ruta del directorio
de trabajo para crear el valor C2OSVD, C:\TMP\_VS_599. El nombre de la carpeta (en
este caso, _VS_599) es exclusivo para todas las instancias de cualquier operador.
La ilustración también muestra dos carpetas %C2OSVD%/HostList y %C2OSVD%\OSList
que contienen cinco archivos llamados 0, 1, 2, 3 y 4. El script escribe un nombre de
equipo para cada archivo numerado de la carpeta HostList. El script escribe un nombre
de sistema operativo para cada archivo numerado de la carpeta OSList. CA Process
Automation crea dos variables indexadas basadas en cero después de ejecutar el script,
HostList y OSList. La aplicación asigna el contenido de los archivos numerados de las
carpetas HostList y OSList a los elementos correspondientes de las variables indexadas.
Capítulo 6: Conjuntos de datos y parámetros 223
Conjuntos de datos
En el ejemplo, el script de Windows utiliza la variable de C2OSVD para crear el archivo
%C2OSVD%\NumRowsRead. CA Process Automation crea la variable correspondiente
(NumFilesRead) en el conjunto de datos del operador del script después de ejecutar el
script. A continuación, el producto asigna el contenido del archivo NumFilesRead a la
variable.
Cuando finaliza un operador de script, suprime la carpeta C2OSVD y el contenido de
ésta. El código de ejecución posterior del operador de script puede acceder a las
variables del conjunto de datos del operador. Por lo general, el código copia los valores
de la variable del conjunto de datos del operador en las variables locales del conjunto de
datos de proceso o en las variables del conjunto de datos del operador en los
operadores de proceso posteriores. Los tres scripts de ejemplo incluidos en este
capítulo muestran cómo se implementa el ejemplo ilustrado en esta sección utilizando
un script UNIX, VBScript o PerlScript.
224 Guía del diseñador de contenido
Conjuntos de datos
Scripts de ejemplo para leer valores del sistema operativo en variables del conjunto de datos
Un proceso puede utilizar un script UNIX, VBScript o PerlScript para leer variables de
sistema operativo en variables de conjunto de datos del operador. Cada script lee líneas
de un archivo de texto que especifica un nombre de host, un solo espacio y el sistema
operativo que se ejecuta en el host. Por ejemplo:
JAMES Windows
INDO Linux
NILE Windows
AMAZON UNIX
YANGTSE Solaris
GILA UNIX
Los tres scripts guardan los nombres de host en un campo indexado con el nombre
HostList y los nombres de sistema operativo en un campo indexado con el nombre
OSList.
El proceso está formado por los pasos siguientes:
1.
El módulo UNIX o Windows transfiere un nombre de archivo de texto. El módulo
obtiene el nombre de archivo a partir de un parámetro de la ficha Proceso
pertinente de las propiedades del operador de script.
2.
El módulo UNIX o Windows crea e inicializa la variable de entorno C2OSVD con una
ruta a una carpeta única.
Una instancia de un operador de script usa la carpeta que especifica la variable de
entorno C2OSVD. La instancia no se repite ni la sobrescribe ninguna instancia
posterior o ningún otro operador de script.
3.
El módulo UNIX o Windows crea la carpeta a la que hace referencia la variable de
entorno C2OSVD.
4.
El script crea carpetas denominadas HostList y OSList en la carpeta a la que hace
referencia la variable de entorno C2OSVD.
5.
El script lee cada línea del archivo de texto y realiza las acciones siguientes:
■
El script escribe los nombres de host en los archivos numerados
secuencialmente de la carpeta %C2OSVD%\HostList.
■
El script escribe los nombres de sistema operativo en los archivos numerados
secuencialmente de la carpeta %C2OSVD%\OSList.
Estos archivos generan dos variables del conjunto de datos del operador indexadas,
HostList y OSList.
6.
El script escribe en un archivo denominado %C2OSVD%/NumRowsRead el número
de líneas leídas en los archivos.
Este archivo genera una variable del conjunto de datos del operador denominada
NumRowsRead.
Capítulo 6: Conjuntos de datos y parámetros 225
Conjuntos de datos
Ejemplo de script UNIX: operador de script UNIXGetInfo
El operador UNIXGetInfo ejecuta un script UNIX en un punto de contacto de UNIX.
Script (UNIX)
El ejemplo de script UNIX crea dos campos indexados, HostList y OSList, en el conjunto
de datos de operador UnixGetInfo. Lee el archivo fuente línea por línea y asigna
nombres de host ($host) a valores indexados en campos HostList secuenciales y
sistemas operativos ($opsys) a valores indexados en campos OSList numerados en
forma secuencial; comienzan con 0 y terminan con un número menos que el número de
filas que se lee en el archivo fuente.
Las variables de parámetro del script shell de UNIX $1, $2, etc. se establecen mediante
las entradas primera, segunda, etc. del área de entrada Parámetros del operador
Ejecutar script que realiza la llamada. En este caso, solamente se transfiere un
parámetro, el cual se usa para establecer SourceFile. El número de filas leídas se asigna
a la variable del conjunto de datos de operador denominada NumRowsRead. El único
objetivo de la línea de tiempo de suspensión 30 es poner en pausa el operador y
concederle al usuario 30 segundos para que examine las carpetas y los archivos creados
en la ubicación C2OSVD. No es posible incluir esta línea en un script de producción.
#!/bin/ksh
SourceFile=$1
#known to be reading 2 variables, host and operating system
mkdir $C2OSVD/HostList
mkdir $C2OSVD/OSList
integer counter=0
while read host opsys; do
echo -n $host > $C2OSVD/HostList/${counter}
echo -n $opsys > $C2OSVD/OSList/${counter}
counter=$counter+1
done < $SourceFile
echo -n $counter > $C2OSVD/NumRowsRead
sleep 30
exit 0
Ejemplo de VBScript: información de Script WinGetInfo
El operador de script WinGetInfo ejecuta un script VBScript en un punto de contacto de
Windows.
226 Guía del diseñador de contenido
Conjuntos de datos
Script (VBScript)
El script crea dos campos indexados, HostList y OSList, en el conjunto de datos de
operador WinGetInfo. El script:
■
Lee el archivo fuente línea por línea.
■
Asigna nombres de host (strHost) a valores indexados en campos HostList
secuenciales. La numeración empieza a partir de 0 y finaliza en una unidad menos
que el número de filas leídas en el archivo fuente.
■
Asigna sistemas operativos (strOS) a valores indexados en campos OSList
numerados secuencialmente. La numeración empieza a partir de 0 y finaliza en una
unidad menos que el número de filas leídas en el archivo fuente.
El script rellena la variable oArgs.Item con las entradas del área de introducción
Parámetros del operador Ejecutar script que realiza la llamada. La primera entrada
rellena oArgs.Item(0). El script asigna el número de filas que lee a la variable del
conjunto de datos del operador NumRowsRead. La línea Wscript.sleep 30000 hace una
pausa en el operador durante 30 segundos para que el usuario pueda examinar las
carpetas y los archivos creados en la ubicación C2OSVD. No se recomienda incluir la
línea Wscript.sleep 30000 en un script de producción.
Capítulo 6: Conjuntos de datos y parámetros 227
Conjuntos de datos
Dim oArgs
Dim oShell
Dim colProcessEnv
Dim objFSO
Dim objDir
Dim objFileIn
Dim objFileOut
Dim intCounter
Dim intExitCode
Dim strLine
Dim intSpacePos
Dim strHost
Dim strOS
on error resume next
set oArgs = WScript.Arguments
set oShell = WScript.CreateObject("WScript.Shell")
Set colProcessEnv = oShell.Environment("Process")
if oArgs.Count = 1 then
'debe tener el argumento requerido
para continuar normalmente,
produce un error si hay más argumentos presentes
strSourceFile = oArgs.Item(0)
Set objFSO = CreateObject("Scripting.FileSystemObject")
Set objDir = objFSO.CreateFolder(colProcessEnv("C2OSVD"))
Set objDir = objFSO.CreateFolder(colProcessEnv("C2OSVD") & "\HostList")
Set objDir = objFSO.CreateFolder(colProcessEnv("C2OSVD") & "\OSList")
intCounter = 0
Set objFileIn = objFSO.OpenTextFile(strSourceFile, 1)
Do Until objFileIn.AtEndOfStream
strLine = objFileIn.ReadLine
intSpacePos = InStr(strLine, " ")
strHost = Left(strLine, intSpacePos - 1)
strOS = Right(strLine, Len(strLine) - intSpacePos)
Set objFileOut = objFSO.CreateTextFile(colProcessEnv("C2OSVD") &
"\HostList\" & intCounter)
objFileOut.Write strHost
objFileOut.Close
Set objFileOut = objFSO.CreateTextFile(colProcessEnv("C2OSVD") & "\OSList\"
& intCounter)
objFileOut.Write strOS
objFileOut.Close
intCounter = intCounter + 1
Bucle
objFileIn.close
Set objFileOut = objFSO.CreateTextFile(colProcessEnv("C2OSVD") &
"\NumRowsRead")
objFileOut.Write intCounter
objFileOut.Close
intExitCode = 0
else
228 Guía del diseñador de contenido
Conjuntos de datos
'Wscript.echo "bad argument or required argument NOT present"
intExitCode = 5
end if
Wscript.sleep 30000
on error goto 0
Wscript.Quit intExitCode
Ejemplo de PerlScript: operador de script WinGetInfoPerl
El operador WinGetInfoPerl ejecuta PerlScript en un punto de contacto de Windows. En
el proceso de ejemplo, PerlScript se ejecuta en un punto de contacto de Windows,
aunque también podría ejecutarse en un punto de contacto de UNIX.
Script (PerlScript)
El script crea dos campos indexados, HostList y OSList, en el conjunto de datos de
operador WinGetInfoPerl. El script:
■
Lee el archivo fuente línea por línea.
■
Asigna nombres de host ($host) a valores indexados en campos HostList
secuenciales. La numeración empieza a partir de 0 y finaliza en una unidad menos
que el número de filas leídas en el archivo fuente.
■
Asigna sistemas operativos ($opsys) a valores indexados en campos OSList
numerados secuencialmente. La numeración empieza a partir de 0 y finaliza en una
unidad menos que el número de filas leídas en el archivo fuente.
El script rellena la variable ARGV con las entradas del área de introducción Parámetros
del operador Ejecutar script que realiza la llamada. El script asigna el número de filas
que lee a la variable del conjunto de datos del operador NumRowsRead. La línea sleep
30 hace una pausa en el operador durante 30 segundos para que el usuario pueda
examinar las carpetas y los archivos creados en la ubicación C2OSVD. No se recomienda
incluir la línea sleep 30 en un script de producción.
Capítulo 6: Conjuntos de datos y parámetros 229
Conjuntos de datos
use strict;
my $filename = "";
print " sample script to retrieve OS level data into variables within C2O\n\n";
my $numargs = @ARGV;
if ($numargs == 1) {
$filename = shift @ARGV;
} else {
print "enter path and filename to process:\n";
chomp($filename = <STDIN>);
}
my $c2osvd = $ENV{'C2OSVD'};
mkdir $c2osvd;
mkdir $c2osvd . "/HostList";
mkdir $c2osvd . "/OSList";
open HANDLE, $filename or die "ERROR: unable to open $filename: $!\n";
my $counter = 0;
while (<HANDLE>) {
my @fields = split;
my $host = $fields[0];
my $opsys = $fields[1];
my $filename1 = $c2osvd . "/HostList/" . $counter;
open HH, "> $filename1" or die "ERROR: unable to open $filename1: $!\n";
print HH $host;
close HH;
my $filename2 = $c2osvd . "/OSList/" . $counter;
open HH, "> $filename2" or die "ERROR: unable to open $filename2: $!\n";
print HH $opsys;
close HH;
$counter++;
}
my $filename3 = $c2osvd . "/NumRowsRead";
open HH, "> $filename3" or die "ERROR: unable to open $filename3: $!\n";
print HH $counter;
close HH;
close HANDLE;
sleep 30;
230 Guía del diseñador de contenido
Parámetros del proceso
Parámetros del proceso
Se pueden definir parámetros para los operadores de un proceso. Los parámetros
pueden aceptar cadenas literales o expresiones. Se puede introducir un valor como una
cadena sin delimitarlo de ningún modo. Los parámetros calculados aceptan valores
como expresiones de JavaScript. Utilice comillas simples o dobles delimitan las cadenas
literales en JavaScript.
Nota: Para ayudarle a identificar campos de CA Process Automation que no aceptan
expresiones, sus etiquetas aparecen en cursiva.
Los parámetros calculados permiten lo siguiente:
■
Manipulación de resultados de invocación de módulo y otras variables
■
Parametrización de operadores
■
Definición de condiciones de espera basadas en expresiones booleanas
(condiciones previas y condiciones de espera) Las condiciones de espera se pueden
utilizar para retrasar el procesamiento y sincronizar el uso de recursos por parte de
diferentes secuencias de operadores que se ejecutan simultáneamente.
Se pueden definir parámetros utilizando la variable del conjunto de datos. Las variables
del conjunto de datos están disponibles para los procesos en los contextos siguientes:
■
En el contexto de orquestador de CA Process Automation, los conjuntos de datos se
conocen como conjuntos de datos con nombre. Los conjuntos de datos con nombre
definen variables que son accesibles para cualquier proceso en el mismo
orquestador. Para acceder a un conjunto de datos denominado, se debe especificar
el nombre de la ruta completa en una expresión. Para ver o editar un conjunto de
datos denominado, haga doble clic en el objeto de conjunto de datos en el
explorador de bibliotecas para abrir el objeto en el diseñador de conjuntos de
datos.
■
El conjunto de datos de proceso se encuentra en el contexto del proceso. El
conjunto de datos de proceso está disponible para cualquier operador de un
proceso. Para acceder al conjunto de datos de proceso, se debe especificar la
palabra clave process en una expresión. Las variables se pueden editar en un
conjunto de datos del proceso en la paleta Conjunto de datos, en el Diseñador de
procesos.
■
Para cada operador de un proceso existe un conjunto de datos del operador. Las
variables de un conjunto de datos del operador están disponibles para el operador
y para otros operadores en el mismo proceso. Para acceder a un conjunto de datos
del operador, se debe especificar el nombre del operador en una expresión. Las
variables se pueden editar en un conjunto de datos del operador en la paleta
Conjunto de datos, en el Diseñador de procesos.
Capítulo 6: Conjuntos de datos y parámetros 231
Parámetros del proceso
Propiedades de operador
En esta sección se proporciona información acerca de los tipos de propiedades de
operador.
Cadenas literales
Para utilizar un valor de cadena literal en un campo que acepta una expresión (su
etiqueta no está en cursiva), encierre la cadena entre delimitadores. Utilice comillas
simples o dobles. Por ejemplo, podría escribir una cadena literal que especificara la ruta
a un programa para iniciar un proceso de UNIX de la siguiente manera:
"/usr/smart/program"
Carácter de escape en cadenas literales
Se puede usar el carácter de escape (\) en cadenas literales. En lugar de ser analizado
por el intérprete de idioma de CA Process Automation, el carácter que sigue al carácter
de escape se interpreta literalmente. Si hay una acción semántica asociada a un carácter
de escape, el intérprete convierte la acción en su carácter equivalente en lugar de llevar
a cabo la acción semántica.
Por ejemplo, digamos que se desea incluir un carácter de comillas dobles en una cadena
delimitada por comillas. Coloque el carácter de escape de forma que preceda al carácter
de comillas para que el analizador no lo interprete como el delimitador de cadena:
\"
Para incluir la barra diagonal inversa en una cadena, primero debe colocar el carácter de
escape:
\\
Más información:
Tipo de datos String (en la página 253)
232 Guía del diseñador de contenido
Parámetros del proceso
Especificación de rutas en cadenas literales
Cuando utiliza la nomenclatura de archivo de Microsoft Windows en una cadena literal
para especificar una ruta en una expresión, las barras diagonales inversas se deberán
escapar de la siguiente manera:
"C:\\IT PAM\\import\\script_ora1.bat"
En la mayoría de los casos, deberá utilizar nombres de archivo normalizados, con barras
diagonales (/), aún para especificar una ruta en un equipo con Microsoft Windows. Por
ejemplo:
"C:/IT PAM/import/script_ora1.bat"
Cuando se especifica una ruta a una carpeta o un objeto en una biblioteca, la barra
diagonal inicial representa la carpeta raíz, seguida de la jerarquía de carpetas delimitada
por barras. Por ejemplo:
"/Production/Processes/failover_process"
Capítulo 6: Conjuntos de datos y parámetros 233
Parámetros del proceso
Variables del conjunto de datos de parámetros
Además de cadenas literales, se pueden utilizar variables del conjunto de datos en una
expresión calculada. Las variables en una expresión no se encierran entre comillas. El
nombre del programa en la expresión calculada siguiente incluye variables y texto
literal:
"/usr/bin" + Datasets["/Application1/Settings"].ProgramName
Elemen Descripción:
to:
Variables de conjunto de datos y valores: Desplácese por encima de un valor de variable de conjunto
de datos para ver una descripción de sugerencia para la variable si es que está disponible.
Variables de referencia de conjuntos de datos en el código de ejecución previa: escriba manualmente
expresiones que hagan referencia a las variables del conjunto de datos.
234 Guía del diseñador de contenido
Parámetros del proceso
Cuando se desea utilizar el resultado de un operador como la entrada para otro
operador, utilice la misma referencia de variable por su nombre. Todos los parámetros
de entrada se convierten automáticamente en variables de conjunto de datos enviadas
después de que el proceso finaliza.
Capítulo 6: Conjuntos de datos y parámetros 235
Parámetros del proceso
Rutas relativas para conjuntos de datos
CA Process Automation puede utilizar rutas relativas o absolutas al acceder a conjuntos
de datos denominado. Las rutas absolutas también se conocen como rutas completas o
fijas.
Ejemplo 1
Folder1 se encuentra en la carpeta raíz de la biblioteca. Folder1 contiene dos objetos:
Process1 y Dataset1. Abra Process1, haga doble clic en el operador Iniciar proceso y
busque el campo Nombre de proceso en la paleta Propiedades.
En lugar de introducir un valor, debe utilizar o hacer referencia al valor en un campo
llamado Nombre de proceso en Dataset1. Para la ruta absoluta, se especificaría lo
siguiente:
Datasets["/Folder1/Dataset1"].ProcessName
También se puede especificar la ruta de Dataset1 relativa a Process1. La misma
expresión que utiliza una ruta relativa es:
Datasets["Dataset1"].ProcessName
Mientras CA Process Automation evalúa la expresión de la ruta relativa, busca Dataset1
en la misma carpeta que Process1.
Si mueve Dataset1, la ruta absoluta deja de ser válida. Para corregir esta situación,
tendría que actualizarla. Sin embargo, mientras estén en la misma carpeta, puede
mover Dataset1 y Process1 a cualquier sitio y la ruta relativa seguirá siendo válida.
Ejemplo 2
Al igual que el ejemplo 1, se utilizará un campo en un conjunto de datos. Esta vez se
utilizará Dataset2 en el nivel raíz de la biblioteca. Para la ruta absoluta, se especificaría
lo siguiente:
Datasets["/Dataset2"].ProcessName.
La misma expresión que utiliza una ruta relativa es:
Datasets["../Dataset2"].ProcessName.
Esta expresión de ruta le indica a la aplicación que busque en la carpeta que es la
carpeta padre de Folder1 (la carpeta que contiene el proceso). Folder1 es el punto de
partida. El código, "../Dataset2" indica literalmente que se debe subir un nivel en la
jerarquía de la carpeta y buscar Dataset2. En este caso, la carpeta padre de Folder1 es la
carpeta raíz y la aplicación busca Dataset2 allí.
Estos conceptos, resumidos en los dos puntos siguientes, también se aplican a
Linux/UNIX, Windows y cualquier entorno que sea compatible con convenciones de
denominación uniformes.
236 Guía del diseñador de contenido
Parámetros del proceso
■
Existe una carpeta padre "/".
■
Todas las demás carpetas son carpetas hijo de la carpeta padre.
Cuando existen estas condiciones, se pueden simplificar expresiones complejas
mediante rutas relativas. Por ejemplo:
"../../"
Nota: Las rutas relativas o absolutas se pueden utilizar como expresiones en cualquier
objeto.
Capítulo 6: Conjuntos de datos y parámetros 237
Parámetros del proceso
Asistencia para nombres de variables del conjunto de datos
Los conjuntos de datos de CA Process Automation definen y almacenan grupos de
variables compartidos entre instancias de proceso. CA Process Automation permite
utilizar las variables como parámetros de entrada en la ejecución de instancias de
proceso.
Después de haber creado variables del conjunto de datos para procesos y operadores,
podría no recordar nombres variables. Las variables que forman parte de un operador y
no de algo que ha definido son fáciles de olvidar. Para ayudarle a hacer referencia a
estas variables de conjunto de datos de proceso y operador sin ir de un operador a otro,
la aplicación proporciona un ayudante de edición en contexto. Conocida como
Asistencia para nombres de variables del conjunto de datos e invocada a través de
Ctrl+Espacio, esta función le ayuda a:
■
Identificar variables de conjunto de datos y aplicarlas a cualquier campo que acepte
expresiones.
■
Reducir el tiempo de desarrollo del proceso
■
Reducir los errores en el alcance o la sintaxis.
La mayoría de los campos de texto que aceptan expresiones introducidas son
compatibles con la Asistencia para nombres de variables del conjunto de datos. Consulte
el siguiente gráfico para ver ejemplos.
238 Guía del diseñador de contenido
Parámetros del proceso
Element Descripción:
o:
Valores sugeridos para el operador Ejecutar programa: en este ejemplo, el usuario ha pulsado
Ctrl+Espacio para mostrar la Asistencia para nombres de variables del conjunto de datos. Aparece una
lista de valores en los niveles global o de raíz.
Operadores sugeridos: después introducir
Process.
Aparece una lista de operadores en el nivel del proceso.
Variables sugeridas: después de especificar el alcance del proceso y operador, aparece una lista de
variables en el nivel del operador.
Sugerencias basadas en el alcance: cuando se accede por primera vez al campo, las sugerencias son
apropiadas en ese nivel o alcance. Después de especificar el parámetro del proceso, el alcance de las
sugerencias se reduce a las variables apropiadas en el nivel del proceso.
Actualizaciones basadas en datos del usuario: a medida que introduce texto, la aplicación actualiza
dinámicamente las sugerencias. En este ejemplo, escribir
Va
reduce los resultados posibles a solamente las entradas coincidentes que empiecen por Va.
Varios conjuntos de datos: la aplicación actualiza dinámicamente el alcance de las sugerencias cuando
se especifican expresiones que abarcan más de un conjunto de datos.
Sugerencias inteligentes: si resulta pertinente, la aplicación incluirá parámetros adicionales basados
en el alcance y el contexto. Por ejemplo, un operador de formulario puede incluir el parámetro
Formulario y el operador Iniciar proceso puede incluir la palabra reservada Caller. La aplicación
también es compatible automáticamente con las variables de matriz y asignación de valores.
Uso de la asistencia para nombres de variables de conjunto de datos
Utilice la función Asistencia para nombres de variables del conjunto de datos en diversos
contextos compatibles en la aplicación.
Lleve a cabo los pasos siguientes:
1.
Abra y extraiga el objeto de automatización que se desea editar. Por ejemplo, un
proceso, un formulario o un conjunto de datos.
2.
Pulse la tecla Tab o haga clic en un campo de texto que acepte expresiones.
3.
Pulse Ctrl + Espacio.
Aparece una lista de valores sugeridos.
4.
Seleccione el valor que se desee utilizar. Para seleccionar variables del conjunto de
datos de proceso o de operador, introduzca el siguiente valor de cadena en el
campo de texto:
Process.
Capítulo 6: Conjuntos de datos y parámetros 239
Parámetros del proceso
5.
Introduzca un nombre de operador para la asistencia para nombres de variables
específicas del operador.
6.
Para filtrar los datos basados en texto introducido, empiece a escribir o introducir
caracteres.
La lista de sugerencias se actualizará dinámicamente a medida que introduzca el
texto.
7.
Seleccione los valores que se desee utilizar.
Parámetros de contraseña
Los caracteres introducidos en el campo de contraseña se ven como asteriscos (*). Las
contraseñas guardadas en un campo de conjunto de datos de tipo de contraseña se
encriptan. Una expresión en un parámetro calculado sólo puede asignar el valor de un
campo de contraseña a otro campo de contraseña.
Configuración de ejecución
La configuración de ejecución especifica cómo y dónde ejecutar el operador. Los valores
de configuración Objetivo y Tiempo de espera están disponibles para los operadores
tanto de un proceso como de una planificación. Los grupos Procesamiento y Bucle sólo
están disponibles para operadores de procesos.
240 Guía del diseñador de contenido
Parámetros del proceso
Valores de configuración objetivo
El campo Objetivo de la sección Configuración de ejecución de la paleta Propiedades
especifica dónde se ejecuta el operador. Utilice las directrices siguientes cuando se
especifique un objetivo en el campo Objetivo:
■
Si el objetivo es un orquestador, introduzca el punto de contacto de este. El campo
Objetivo se puede dejar en blanco para apuntar al orquestador que está ejecutando
el proceso.
Nota: No especifique la dirección IP de un equipo que aloja un orquestador en
clúster.
■
Si el objetivo es un agente, introduzca el punto de contacto de éste. Si el punto de
contacto se asigna a varios agentes con la misma prioridad, se selecciona el objetivo
de ejecución exacto para equilibrar la carga.
■
Si el objetivo es un agente específico y el punto de contacto se asigna a varios
agentes, introduzca el ID del agente.
■
Si el objetivo no tiene ningún agente pero tiene un punto de contacto de proxy,
introduzca el punto de contacto del proxy.
■
Si el objetivo es un host remoto al que hace referencia un grupo de host:
–
Seleccione la opción del menú desplegable Coincidir solamente con el objetivo
en los grupos de host (Activada).
–
Seleccione la opción Buscar en DNS cuando coincida con el objetivo en los
grupos de host (Activada) para identificar el DNS si se está realizando una
coincidencia con el objetivo en el grupo de host.
–
Seleccione El objetivo es una expresión calculada. Cree un conjunto de datos
que hagan referencia a una dirección IP o FQDN de un host que cumpla con los
criterios de patrón de un grupo de host.
–
Introduzca la referencia del conjunto de datos a la dirección IP o FQDN en el
campo Objetivo.
Importante: Utilice un conjunto de datos para la dirección IP o FQDN si el proceso
con este operador se va a importar como un paquete de contenidos. Solamente se
puede modificar un conjunto de datos en este escenario. Es decir, no se puede
modificar el valor del campo Objetivo después de la importación.
Variables del conjunto de datos de operador
El conjunto de datos del operador contiene variables asociadas a un operador. Las
variables y los valores asociados a estas se pueden ver, crear, editar o suprimir durante
el tiempo de diseño. Las variables están a disposición del operador al que están
asociadas o de cualquier otro operador del proceso desde el mismo momento en que se
inicia el proceso. Después de la ejecución del operador, crea automáticamente otras
variables en el conjunto de datos del operador. Algunas variables son estándares y
ofrecen información como la hora de inicio, la hora de detención y el resultado. Otras
variables son específicas para cada operador.
Capítulo 6: Conjuntos de datos y parámetros 241
Parámetros del proceso
Se puede utilizar la notación de puntos o la notación de corchetes con expresiones para
acceder a una variable del conjunto de datos del operador desde cualquier operador de
un proceso:
Process_name.Operator_name.field_name
Process_name[OpName_expression].field_name
Process_name[OpName_expression][field_name_expression]
Nota: También se puede utilizar IconName en lugar de OpName.
Las expresiones devuelven el nombre del operador o la variable tal y como se indica. La
sintaxis siguiente devuelve un elemento en un campo indexado, donde n es el número
de elemento:
field_name[n]
Los códigos de ejecución previa y ejecución posterior para un operador pueden utilizar
la palabra clave OpName para acceder al nombre del operador actual. Utilice la sintaxis
siguiente para especificar una variable del conjunto de datos del operador en el código
de ejecución previa o posterior de ese mismo operador:
Process[OpName].field_name
Por ejemplo, utilice las siguientes sentencias del código de ejecución posterior para
realizar estas acciones:
■
Asigne el nombre del operador y el valor de la variable Resultado asociada a las
variables del conjunto de datos del proceso iName e iResult
■
Cree una variable del conjunto de datos de operador denominada World:
Process.iName = OpName
Process.iResult = Process[OpName].Result
Process[OpName].World = "Hola mundo"!;
Si conoce el nombre del operador en el momento del diseño, se puede utilizar el
nombre del operador literal para hacer referencia a las variables del conjunto de datos
en una expresión.
En ocasiones, sin embargo, no se conoce el nombre del operador en tiempo de diseño.
Por ejemplo:
■
Cuando se editan acciones de ejecución previa o posterior para un objeto de
operador personalizado.
■
Cuando hay que acceder a las variables del conjunto de datos del operador en uno
de los distintos operadores, pero no se sabe qué operador se ejecutó hasta el
tiempo de ejecución.
242 Guía del diseñador de contenido
Parámetros del proceso
Luego se puede utilizar el código de ejecución previa o posterior en cada operador para
guardar el nombre de este en una variable, al igual que con la variable iName en el
ejemplo anterior. La variable podría ser una variable del conjunto de datos del proceso o
bien una variable del conjunto de datos del operador que pertenece al operador que
requiere el nombre. Por ejemplo, en la ilustración siguiente, el proceso ejecuta el
operador A o el operador B antes de llegar al operador C. El operador C puede utilizar
entonces el nombre de la operación que el operador A o el operador B guardaron en
una variable del proceso para acceder a las variables del conjunto de datos.
El uso de variables en lugar de nombres estáticos hace que el código sea modular e
intercambiable entre los operadores de un proceso.
Configuración de propiedades de procesamiento
La propiedades de procesamiento definen el código de ejecución previa y el código de
ejecución posterior.
Capítulo 6: Conjuntos de datos y parámetros 243
Parámetros del proceso
Código de ejecución previa y código de ejecución posterior
El código JavaScript de ejecución previa y de ejecución posterior se procesa antes y
después de que se ejecute un operador. El código de ejecución previa suele utilizarse
para configurar variables de bucle u otras variables que se pueden utilizar como parte
del operador. El código de ejecución posterior suele utilizarse para procesar los
resultados de un operador o para aumentar índices de bucles.
Se puede utilizar la palabra clave OpName para acceder al conjunto de datos del
operador. Por ejemplo, la sentencia siguiente inserta el nombre de operador en un
mensaje y asigna la cadena a una nueva variable del conjunto de datos del operador
denominada operatorMsg:
Process[OpName].operatorMsg = “Operador de recuperación” + OpName +
“reestructuración servidor principal en” +System[“Fecha”]+ ":" + System[“Hora”];
Normalmente, se debe incluir código que esté estrechamente asociado con el
procesamiento del operador específico.
En el caso de código inconexo, una buena práctica es agregar un operador Cálculo
independiente al proceso.
Configuración del estado de un operador
Durante el procesamiento del código anterior y posterior a la ejecución, puede
especificar un valor para setOperatorStatus. Se puede imponer el operador como
correcto o erróneo.
Para especificar el éxito del operador:
setOperatorStatus ("Correctamente", Resultados de la
operación,"Motivo").
Para especificar el fallo del operador:
setOperatorStatus ("Erróneo", Resultados de la
operación,"Motivo").
244 Guía del diseñador de contenido
Parámetros del proceso
Valores de configuración de bucle
La propiedad Bucle especifica el número de veces que se repite un operador. Cuando un
operador se ejecuta en un bucle, las condiciones de salida y los vínculos de conexión del
operador se evalúan únicamente cuando dicho bucle termina.
Los valores de configuración de bucle tienen las siguientes propiedades:
Recuento de repetición
Especifica el número de veces que el operador debe repetirse. Este valor puede
especificarse con un entero o una expresión de CA Process Automation que
devuelve un entero durante el tiempo de ejecución. El valor predeterminado 1
ejecuta un bucle en un operador una sola vez en un workflow. Para ejecutar un
bucle infinito, haga clic en la casilla de verificación Bucle infinito.
También puede utilizarse una expresión booleana. La expresión se evalúa después
de que el operador se haya ejecutado. Un operador en un workflow ejecuta un
bucle continuo siempre y cuando la expresión se evalúe como verdadera. Si la
expresión es falsa, el operador sale.
Bucle infinito
Crea un bucle infinito. El operador o proceso continúa repitiéndose hasta que el
proceso se interrumpe o el bucle se detiene desde otra rama utilizando el comando
de bucle de detención vinculado al operador Bucle.
Retraso entre iteraciones
CA Process Automation es compatible con una opción de retraso inherente para
todos los operadores que tienen una opción de bucle. El campo de texto Retraso
entre iteraciones toma una expresión. La expresión se evalúa en un entero y el valor
se toma como retraso en segundos. Antes de que la iteración siguiente se ejecute,
hay un retraso según lo especifique el usuario después de una iteración en el bucle.
El valor mínimo para el retraso es cero. El retraso predeterminado es de 0
segundos. CA Process Automation considera un retraso como de cero segundos
para todas las entradas no válidas.
Capítulo 6: Conjuntos de datos y parámetros 245
Parámetros del proceso
Valores de configuración de tiempo de espera
Los valores de configuración de tiempo de espera permiten a los usuarios configurar un
tiempo de espera como parte de todos los operadores. Si el operador no ha finalizado
según el tiempo especificado definido en los valores de configuración de tiempo de
espera, la ejecución toma un puerto de salida de tiempo de espera. Los usuarios aún
tienen la posibilidad de optar por finalizar la ejecución del operador y tomar la ruta de
tiempo de espera o permitir que el operador continúe con la ejecución.
Los valores de configuración de tiempo de espera tienen las siguientes propiedades:
Sin tiempo de espera
Especifica que no hay ningún tiempo de espera configurado para el operador
(activado de forma predeterminada).
Para especificar un valor de tiempo de espera, borre el contenido de la casilla de
verificación Sin tiempo de espera.
Tipo
Sin tiempo de espera. Seleccione uno de los siguientes tipos de tiempo de espera.
Duración
Especifica la duración de tiempo de espera en segundos.
Fecha objetivo
Especifica la fecha (MM/DD/AAAA) y hora (24 horas) del tiempo de espera.
Duración/fecha-hora objetivo
Define la duración de tiempo de espera o la fecha objetivo para el operador.
246 Guía del diseñador de contenido
Parámetros del proceso
Acción
Se puede seleccionar una de las siguientes acciones de tiempo de espera:
Abandonar
Especifica que el flujo se abandone una vez que se agota el tiempo de espera
del operador. Se ejecutan las siguientes acciones:
■
La operación se ejecuta en el modo separado.
■
Se agota el tiempo de espera del operador.
■
Se ejecuta el código de ejecución posterior.
■
El flujo del proceso se lleva a cabo a través de la rama de tiempo de
espera.
■
Se ejecuta el operador de retrasos.
Anular
Especifica que el flujo se anule una vez que se agota el tiempo de espera del
operador. Se ejecutan las siguientes acciones:
■
El operador se anula.
■
Se ejecuta el código de ejecución posterior.
■
El flujo del proceso se lleva a cabo a través de la rama de tiempo de
espera.
■
Se ejecuta el operador de retrasos.
Continuar
Especifica que el flujo continúe una vez que se agota el tiempo de espera del
operador. Se ejecutan las siguientes acciones:
■
El operador y la operación se encuentran en estado de ejecución.
■
El flujo del proceso se lleva a cabo a través de la rama de tiempo de
espera.
■
Se ejecuta el operador de retrasos.
■
Se ejecuta el código de ejecución posterior después de que se ejecuta el
operador.
Restablecer
Especifica que el flujo se restablezca una vez que se agota el tiempo de espera
del operador. Se ejecutan las siguientes acciones:
■
El operador y la operación se encuentran en estado de ejecución y se
restablecen.
■
Se ejecuta el código de ejecución posterior.
■
El flujo del proceso se lleva a cabo a través de la rama de tiempo de
espera.
Capítulo 6: Conjuntos de datos y parámetros 247
Parámetros del proceso
■
Se ejecuta el operador de retrasos.
Parámetros calculados
Los parámetros en los cuadros de diálogo y las páginas de propiedades que aceptan
expresiones se llaman parámetros calculados. Los valores para parámetros calculados se
deberán introducir como expresiones de JavaScript. Se pueden utilizar expresiones de
JavaScript para configurar los valores del conjunto de datos, realizar cálculos en los
operadores del servicio de interpretación, como parte del código de ejecución previa y
ejecución posterior, y especificar parámetros donde se permita una expresión. La mayor
parte de los campos aceptan parámetros calculados. Los campos que no aceptan
expresiones como entrada tienen etiquetas en cursiva.
Expresiones
Una expresión es cualquier declaración lógica que la aplicación puede evaluar para
devolver un valor. Puede incluir cualquier combinación de los siguientes tipos de datos:
■
enteros (incluidos largo, doble, etc.)
■
cadenas
■
funciones
■
variables
■
referencias a otros operadores
■
JavaScript
■
fechas y horas
■
asignaciones de valores
■
valores literales
■
valores calculados
■
operadores lógico Y, O y No palabras clave o símbolos (&&, ||, !)
■
operadores de comparación (==, !=, <, >, <=, >=, <>)
■
paréntesis incluyentes
Las expresiones son entradas válidas para todos los campos, incluidos los operadores de
JavaScript, las funciones, los puertos de salida personalizados y los campos de propiedad
de operador, con la excepción de los campos etiquetados en cursiva.
248 Guía del diseñador de contenido
Parámetros del proceso
Palabras reservadas en las expresiones
Se reserva un número de palabras en las expresiones de CA Process Automation. Estas
incluyen palabras reservadas de CA Process Automation, funciones del sistema y
palabras clave de JavaScript. No utilice estas palabras como identificadores (como para
nombres de objeto variables u otro) en expresiones.
Palabras reservadas de CA Process Automation
■
Autor de llamada
■
DateAdjust
■
Proceso
■
CurrentIndex
■
FreeRes
■
Size
■
Conjuntos de datos
■
OpName
■
Sistema
Funciones del sistema de CA Process Automation
Consulte la Guía de referencia del diseñador de contenido para obtener información
detallada sobre cada una de las funciones del sistema de CA Process Automation.
Capítulo 6: Conjuntos de datos y parámetros 249
Parámetros del proceso
Palabras clave de JavaScript reservadas
■
Break
■
do
■
if
■
switch
■
var
■
case
■
else
■
in
■
this
■
void
■
catch
■
false
■
instanceof
■
throw
■
while
■
continue
■
finally
■
new
■
true
■
with
■
predeterminado
■
for
■
null
■
try
■
delete
■
function
■
return
■
typeof
Tipos de datos
Las expresiones de CA Process Automation son compatibles con los tipos de datos de
JavaScript. Las variables o las constantes representan datos.
250 Guía del diseñador de contenido
Parámetros del proceso
Tipo de datos Boolean
Los valores booleanos tienen dos valores posibles: verdadero y falso. JavaScript
convierte los literales verdaderos y falsos a 1 y 0 cuando es necesario.
Los valores booleanos son normalmente el resultado de una comparación hecha en sus
expresiones de JavaScript. Los valores booleanos están normalmente utilizados en las
estructuras de control. Por ejemplo, la sentencia if-then de JavaScript realiza una acción
si es verdadero y una acción diferente si es falso.
Los ejemplos siguientes son todos expresiones booleanas válidas:
Process.A == 1
!(Process.A == 1)
(Process.A != 1)
(Process.A == 1) && (Process.B > 0)
Tipo de dato Date
El tipo de fecha almacena y devuelve fechas de variables del conjunto de datos. El tipo
de formato de fecha se puede especificar como parte del tipo de datos. Por ejemplo, se
puede especificar que representa una fecha como mes y luego día o día y luego mes.
Tipo de datos Double
El tipo de datos numérico doble puede tener un separador decimal. La sintaxis
tradicional se utiliza para números reales. Un valor real se representa como la parte del
número a la cual le sigue un separador decimal y la parte fraccionaria de un número.
Este tipo puede almacenar números reales de -1.7976931348623157E308 a
1.7976931348623157E308.
Los literales de punto flotante se pueden representar utilizando la notación exponencial:
un número real seguido por la letra e (o E), seguido por un signo opcional más (+) o
menos (-), seguido por un exponente íntegro, en el formato siguiente:
[digits][.digits][{E|e}[{+|-}]digits]
Ejemplos
2.718
2345.789
7.748E-5
Capítulo 6: Conjuntos de datos y parámetros 251
Parámetros del proceso
Tipo de datos Integer
El tipo de datos de entero de 16 bits se puede escribir como valores literales en una
expresión. Se pueden representar exactamente todos los enteros desde -2,147,483,647
a +2,147,483,647.
Tipo de datos JavaObject
Este tipo de datos permite almacenar objetos de Java en CA Process Automation.
Todas las variables de JavaObject son de sólo lectura. Sus campos CurrentValue y ¿Solo
lectura? están desactivados. Sólo se pueden editar los campos siguientes:
■
Tipo
■
Página
■
Descripción
■
Matriz
Un JavaObject que no está vacío muestra su tipo de clase en el campo CurrentValue
asociado. El campo CurrentValue para un JavaObject vacío se establece como
[JavaObject].
El valor real de la variable JavaObject es la versión de la cadena en serie del objeto Java,
pero CA Process Automation no muestra esta cadena en serie. Muestra, sin embargo, el
tipo de clase de Java del objeto.
Un JavaObject creado manualmente está siempre vacío porque no se puede introducir
su valor directamente en CA Process Automation. Las variables JavaObject se suelen
guardar en un conjunto de datos después de que el operador Ejecutar código Java haya
terminado de ejecutarse.
Tipo de datos Long
Tipo de datos largo es un campo 32 bits que se puede escribir como valores literales en
una expresión. Se pueden representar exactamente todos los enteros de
-9,223,372,036,854,775,808 a +9,223,372,036,854,775,808.
Tipo de datos Password
El tipo de datos de contraseña almacena contraseñas en un formato encriptado en las
variables del conjunto de datos. Los usuarios no visualizan el valor almacenado en una
variable de tipo de contraseña.
252 Guía del diseñador de contenido
Parámetros del proceso
Tipo de datos Object Reference
El tipo de datos de referencia de objeto almacena la ruta completa o de referencia en un
objeto en una biblioteca. Se puede utilizar en cualquier sitio en donde una expresión
requiera la ruta a un objeto. El filtro de referencia de objeto sobre el tipo de referencia
de objeto lo restringe a hacer referencia a uno o más tipos de objeto especificados.
Tipo de datos String
Se pueden escribir cadenas como valores literales en una expresión. Las funciones y los
operadores de JavaScript en una expresión también devuelven cadenas. Para distinguir
entre identificadores (por ejemplo, nombres de variables) y cadenas literales, las
cadenas literales se deben encerrar entre delimitadores de cadena. Se pueden usar
comillas simples o dobles para usar como delimitadores de cadena. Por ejemplo, para
utilizar una cadena literal para que el nombre de un programa inicie un proceso UNIX,
escriba lo siguiente:
"/usr/smart/program"
En los cuadros de texto marcados con un asterisco (*), introduzca o una expresión o una
cadena literal entre comillas. El asterisco indica que CA Process Automation evalúa el
contenido del cuadro de texto como una expresión. No utilice comillas para delimitar las
expresiones.
Los cuadros de texto que esperan valores literales no están etiquetados con un asterisco
(*). En tales casos, no delimite las cadenas con comillas.
JavaScript utiliza la barra diagonal inversa (\) como carácter de escape para las cadenas
literales. Si se adjunta una acción semántica a un carácter de escape, éste se convierte
en su equivalente de carácter en lugar de llevar a cabo la acción semántica. Por ejemplo,
'C:\\pam' se convierte en 'C:\pam'.
CA Process Automation interpreta literalmente cualquier carácter situado detrás de un
carácter de escape, en lugar de analizarlo mediante el intérprete de lenguaje. Por
ejemplo, para incluir comillas dobles en una cadena, coloque delante de esta un
carácter de escape, \”. En este caso, el analizador no interpreta las comillas dobles como
el delimitador de cadena. Para incluir la barra diagonal inversa en una cadena, primero
debe colocar el carácter de escape, \\.
Para incluir en la cadena el mismo carácter que se utiliza como delimitador, aplique un
escape al carácter cuando se esté usando como delimitador. Por ejemplo, la cadena
siguiente está delimitada con comillas simples. La cadena incluye comillas simples como
caracteres a los que se ha aplicado un escape y comillas dobles como caracteres
literales:
'El motor de la base de datos no puede encontrar la base de datos \'CHECKERS\' en el
servidor "GAMES"'
Capítulo 6: Conjuntos de datos y parámetros 253
Parámetros del proceso
La misma cadena, delimitada con comillas dobles, incluye comillas simples como
caracteres literales y las comillas dobles como caracteres sustituidos por caracteres de
escape:
"El motor de la base de datos no puede encontrar la base de datos 'CHECKERS' en el
servidor \"GAMES\""
La siguiente tabla muestra las secuencias de escape en JavaScript:
Secuencia
Carácter representado
\0
El carácter NUL (\u0000)
\b
La tecla de retroceso (\u0008)
\t
Ficha horizontal (\u0009)
\n
Línea nueva (\u000A)
\v
Ficha vertical (\u000B)
\f
Suministro del formulario (\u000C)
\r
Retorno de carro (\u000D)
\"
Comillas dobles (\0022)
\'
Apóstrofo o comillas simples (\0u0027)
\\
El carácter Latin-1 especificado por dos dígitos
hexadecimales NN
Tipo de datos ValueMap
El tipo de datos ValueMap contiene una recolección de variables de diversos tipos de
datos. Se puede utilizar para crear un grupo de variables dentro de un conjunto de
datos. Este tipo también se conoce como un registro o una estructura.
Operadores de JavaScript
Se pueden utilizar operadores de JavaScript para construir cadenas, enteros, valores
booleanos y expresiones lógicas a partir de una combinación de entidades (enteros,
cadenas, funciones y conjuntos de datos). El número de operandos que se pueden usar
son los que caracterizan a los operadores de JavaScript. La mayoría de los operadores de
JavaScript son operadores binarios que combinan dos expresiones en una sola expresión
más compleja.
JavaScript también es compatible con varios operadores unarios que convierten una
sola expresión en una expresión más compleja. En esta sección se describen los
operadores de JavaScript que se utilizan con mayor frecuencia en las expresiones de CA
Process Automation.
254 Guía del diseñador de contenido
Parámetros del proceso
Operadores de acceso a objetos y matriz
JavaScript utiliza la notación de punto (.) para el acceso a objetos y las matrices. Se
puede acceder a los elementos de una matriz utilizando la notación de corchetes ([ ]),
mientras que para los elementos de un objeto se utiliza la notación de puntos (.).
JavaScript considera que la notación de corchetes y puntos son operadores.
La notación de puntos utiliza el formato siguiente:
object.identifier
El operando identifier puede ser el nombre literal de la propiedad, el método o el
nombre de la variable (en un conjunto de datos), sin comillas simples ni dobles. El
operando no puede ser una cadena o variable que contenga una cadena.
La notación de corchetes utiliza los formatos siguientes:
array[expression] //
El operando array hace referencia a una matriz. El operando [expression] devuelve
un valor entero para un índice de matriz.
object[expression] //
El operando object hace referencia a un objeto. El operando [expression] devuelve
una cadena que designa una propiedad del objeto.
Nota: A diferencia de la notación de puntos, en la que el segundo operando es un
identificador, el operando [expression] es una cadena.
La notación de corchetes permite acceder a los elementos de la matriz y a las
propiedades del objeto. La notación de corchetes también permite acceder a las
propiedades del objeto sin limitar el operando identifier, tal y como lo hace la notación
de puntos.
Operadores de asignación
JavaScript proporciona el operador de asignación normal y los operadores de asignación
aritméticos que proporcionan accesos directos a operadores aritméticos comunes.
Operador
Ejemplo
Equivalente
=
a=b
+=
a += b
a=a+b
-=
a -= b
a=a-b
*=
a *= b
a=a*b
/=
a /= b
a=a/b
%=
a %= b
a=a%b
Capítulo 6: Conjuntos de datos y parámetros 255
Parámetros del proceso
Operadores aritméticos
JavaScript utiliza los siguientes operadores para combinar valores de enteros:
Operador
Descripción
*
Multiplicación
/
División
+
Adición o unario más
-
Sustracción o unario menos
%
Módulo
++
Incremento
--
Reducción
Los cálculos aritméticos en una expresión siguen reglas algebraicas:
■
Cuando una expresión contiene varios operadores aritméticos, primero se calcula la
multiplicación y división y, a continuación, la resta y la suma.
■
Cuando los operadores son del mismo nivel, se calculan de izquierda a derecha.
■
Se pueden utilizar paréntesis para cambiar la precedencia. Primero se evalúan
cálculos dentro de paréntesis. Si los paréntesis se anidan, el cálculo más
profundamente anidado tiene precedencia.
Operador de concatenación de cadena
El lenguaje interpretado tiene el siguiente operador para combinar los valores de
cadena.
Operador
Descripción
+ (cadenas)
Concatenación de cadenas
Utilice el operador de cadena para combinar o concatenar dos o más cadenas de
carácter en una sola cadena de carácter. Por ejemplo, la expresión "ABCD" + "123"
devuelve la cadena concatenada "ABCD123".
256 Guía del diseñador de contenido
Parámetros del proceso
Operadores lógicos
El lenguaje interpretado utiliza los siguientes operadores lógicos (o booleanos) para
combinar los resultados de las funciones u operadores booleanos.
Operador
Descripción
&&
Operación lógica Y
||
Operación lógica O
!
Operación lógica NO
Los operadores lógicos devuelven Verdadero o Falso. Estos operadores reconocen nulo,
0, "" o no definido como Falso y los demás operandos que no tienen cero como
Verdadero.
Operadores de igualdad y comparación
Se utilizan operadores de comparación con cadenas y datos numéricos. Los operadores
de comparación se evalúan como un valor booleano. Devuelven Verdadero o Falso
basados en el resultado de la condición probada.
Operador
Descripción
==
Igual a
===
Identidad
!=
No igual a
===
Sin identidad
<
Menor que
<=
menor que o igual a
>
Mayor que
>=
Mayor que o igual a
?:
Operador condicional terciario
La expresión
x1 ? x2 : x3
devuelve x2 cuando x1 es Verdadero o x3 cuando x1 es Falso.
Capítulo 6: Conjuntos de datos y parámetros 257
Parámetros del proceso
Precedencia del operador
Los operadores del lenguaje de interpretación de CA Process Automation siguen las
reglas de precedencia computacional estándar, como se muestra en la tabla siguiente.
Se ejecutan operadores al mismo nivel de precedencia de izquierda a derecha.
Precedencia
Operador
1
. () [ ]
2
¡++ -- - (unario) + (unario)!
3
* / %
4
+ (adición) - (sustracción) + (concatenación de cadena)
5
< <= > >=
6
== != === !==
7
&&
8
||
9
?:
10
= *= /= %= += -=
258 Guía del diseñador de contenido
Parámetros del proceso
Palabras clave para acceder a los conjuntos de datos
En la siguiente tabla se describen las palabras clave utilizadas para hacer referencia a los
conjuntos de datos en contextos diferentes:
Conjunto de datos
Contexto del conjunto de
datos
Descripción
Conjuntos de datos
Conjunto de datos
denominado
Utiliza el formato siguiente para acceder a un conjunto de
datos denominado en una biblioteca de CA Process
Automation:
Datasets[dataset_path].field
_name
dataset_path
Una expresión de CA Process Automation que devuelve la
ruta completa para un conjunto de datos denominado en
la biblioteca actual.
Por ejemplo, la ruta siguiente hace referencia a un
conjunto de datos denominado CxLinuxDev, que está
ubicado en la subcarpeta Datos de la carpeta de
demostración de la biblioteca:
Datasets["/Demo/Data/]
Capítulo 6: Conjuntos de datos y parámetros 259
Parámetros del proceso
Conjunto de datos
Contexto del conjunto de
datos
Descripción
Proceso
Conjunto de datos de un
proceso
Accede a un conjunto de datos del proceso con el
formato siguiente:
Process.field_name
o
Process[expression]
Process.field_name
o
Process[expression]
nombre_campo
La variable del conjunto de datos.
expression
Una variable u otra expresión que devuelve el nombre de
un campo. Por ejemplo:
Process.x = 5;
Process.fn = "x";
Process.y = Process[Process.fn];
Un conjunto de datos de proceso se define en un
proceso. Cada vez que se inicia un proceso, este crea una
copia de sí mismo (llamada instancia de proceso) que
incluye el conjunto de datos del proceso. El objeto de
proceso original determina los valores iniciales para el
conjunto de datos. Los cambios que se realicen en el
conjunto de datos de una instancia del proceso no
afectan al original.
260 Guía del diseñador de contenido
Parámetros del proceso
Conjunto de datos
Contexto del conjunto de
datos
Descripción
Autor de llamada
Conjunto de datos del proceso Transfiere valores entre procesos en una jerarquía de
para un proceso padre cuando llamadas cuando un proceso utiliza el operador Iniciar
está iniciando un proceso hijo. proceso (en el modo adjunto, separado o en línea) o bien
el operador Ejecutar un proceso separado con el que es
compatible el Módulo de procesos para iniciar otro
proceso. La opción de código de inicialización del
conjunto de datos del proceso del operador Iniciar
proceso especifica estas asignaciones.
Por ejemplo, cuando el proceso A que llama al proceso B
debe inicializar campos en el conjunto de datos de
proceso B, el proceso A especifica el proceso B como
parte del código de inicialización del conjunto de datos
del proceso. En este contexto, Autor de llamada hace
referencia al conjunto de datos de proceso padre A,
mientras que Proceso se refiere al conjunto de datos de
proceso hijo B.
Dentro del contexto del código de inicialización del
conjunto de datos del proceso, siempre se requiere que
la palabra clave Proceso haga referencia a una variable en
el conjunto de datos del proceso hijo.
Si se omiten las palabras clave Proceso y Autor de
llamada en un nombre de variable en el script de
inicialización del conjunto de datos del proceso, CA
Process Automation buscará solamente una variable
relacionada con el cálculo. El producto no busca una
variable de nombre similar en el conjunto de datos padre
ni hijo. Por ejemplo, el siguiente código produce un error
si no se creó ningún alcance de cálculo X previamente en
el contexto de cálculo:
Process.X = Caller.X;
Process.Y = X + 100;
Capítulo 6: Conjuntos de datos y parámetros 261
Parámetros del proceso
Conjunto de datos
Contexto del conjunto de
datos
Descripción
ninguno
El cálculo actual y, en algunos Si se omite la palabra clave Process a la izquierda de una
casos, el conjunto de datos del sentencia de asignación, CA Process Automation siempre
crea o asigna un valor dentro del alcance del cálculo
proceso
actual (una variable de cálculo). Una variable de cálculo
existe mientras CA Process Automation esté procesando
un campo de cálculo. Por ejemplo, el código siguiente
crea una variable de cálculo igual al valor 5:
a=5
Si se omite la palabra clave Process en otros contextos
(como a la derecha de una sentencia de asignación), CA
Process Automation buscará primero una variable de
alcance de cálculo o una variable de proceso con el
mismo nombre.
Por ejemplo:
Process.a = 1
Process.b = 2
a=5
x=a
y=b
CA Process Automation crea dos variables en el conjunto
de datos del proceso (a=1 y b=2) y dos variables de
cálculo (x=5 e y=2).
Process.operator_na Conjunto de datos del
me
operador en un proceso
o
Process[expresión]
Activa el acceso a un conjunto de datos del operador,
donde operator_name es una cadena que especifica el
nombre de un operador en un proceso. Por ejemplo:
Process.y = Process.emailOp.subject
La expresión devuelve el nombre de un operador en un
proceso, por ejemplo:
Process.opName = "emailOp"
Process.y = Process[Process.opName].subject
Notas:
- Para obtener información sobre cómo especificar los
campos del conjunto de datos del operador y para crear
una lista de campos generados por el sistema en los
conjuntos de datos del operador, consulte Cómo
especificar las variables del conjunto de datos del
operador (en la página 271).
- Para obtener más información sobre cómo especificar
variables de operador en la configuración de las
propiedades del operador, consulte Variables del
conjunto de datos de parámetros (en la página 234).
262 Guía del diseñador de contenido
Parámetros del proceso
Conjunto de datos
Contexto del conjunto de
datos
Descripción
Sistema
Conjunto de datos del sistema Permite acceder al conjunto de datos del sistema.
Los campos del conjunto de datos del sistema
representan la información del sistema de CA Process
Automation (por ejemplo, el nombre de host, la fecha y la
hora). El conjunto de datos del sistema es de solo lectura.
Nota: Para obtener más información sobre los campos
del conjunto de datos del sistema y sobre cómo
especificar variables del sistema y cómo ver una lista de
variables del sistema, consulte Cómo especificar las
variables del conjunto de datos del sistema (en la
página 272).
Root
Conjunto de datos padre
Activa un proceso hijo en línea para acceder al conjunto
de datos del proceso de una instancia padre.
Se puede utilizar la palabra clave Root para acceder al
conjunto de datos del proceso de la instancia raíz.
Ejemplos:
- El proceso A inicia un proceso en línea (proceso B). El
proceso B inicia otro proceso en línea (proceso C). El
proceso C utiliza la palabra clave Root para acceder al
conjunto de datos del proceso A.
- El proceso A inicia el proceso B en un modo no en línea
y el proceso B inicia el proceso C en el modo en línea. El
proceso C solo tiene acceso al conjunto de datos del
proceso B (no al del proceso A) mediante la palabra clave
Root.
Acceso a los campos del conjunto de datos en las expresiones
Los valores del campo Conjunto de datos de una expresión utilizan la notación de
corchetes ([expression]) o de puntos (.field), o ambas, para especificar un conjunto de
datos o un campo perteneciente a un conjunto de datos.
Capítulo 6: Conjuntos de datos y parámetros 263
Parámetros del proceso
Sintaxis para especificar el valor de un campo
A un valor en un solo campo no indexado se accede mediante una expresión que utiliza
la notación de puntos:
dataset_reference.field_name
El parámetro dataset_reference corresponde a una de las palabras clave descritas
previamente. El parámetro field_name es un nombre de campo del conjunto de datos.
El ejemplo siguiente devuelve el valor del campo Y en un conjunto de datos del proceso:
Process.Y
También se puede acceder a un valor utilizando la notación de corchetes:
dataset_reference[field_name_expression]
El parámetro field_name_expression es una expresión que devuelve el nombre de un
campo en el conjunto de datos al cual se hace referencia. El ejemplo siguiente devuelve
el valor del campo Y en un conjunto de datos del proceso:
Process.Y
Se suele recomendar el uso de la notación de corchetes para que una expresión
especifique un conjunto de datos o un nombre de campo en un conjunto de datos.
Cómo especificar el valor de un elemento en un campo indexado
Para acceder a un valor en un campo indexado (matriz), utilice la sintaxis siguiente:
dataset_reference.indexed_field_name[index]
El parámetro indexed_field_name especifica el nombre de campo en el conjunto de
datos. Index es un entero que se remite a un elemento indexado de la matriz.
Para especificar la cadena indexed_field_name con la notación de corchetes, utilice la
sintaxis siguiente. En el ejemplo, indexed_field_name_expression es una expresión de
CA Process Automation que devuelve la cadena indexed_field_name.
dataset_reference[indexed_field_name_expression][index]
Al igual que las matrices de JavaScript, los campos indexados de CA Process Automation
son "matrices de matrices", en lugar de verdaderas matrices. Para acceder a un
elemento en una matriz de matrices, utilice el operador [ ] dos veces. Por ejemplo, para
el campo de entero indexado bidimensional llamado "integers", todos los elementos de
lista integers[x] son, en sí mismos, una lista indexada de enteros. Para acceder a un
entero concreto del campo indexado, debe escribir la expresión integers[x][y]. En
general, para cualquier campo indexado de n dimensiones, utilice la sintaxis siguiente
para acceder a cualquier elemento de datos:
dataset_reference.indexed_field_name[index1][index2] ... [indexn]
264 Guía del diseñador de contenido
Parámetros del proceso
El parámetro index es un entero o una expresión que devuelve un entero. El parámetro
tiene un valor desde 0 (para el primer valor en una lista indexada) hasta la longitud de la
lista menos 1. La evaluación del index es circular, por tanto, cuando el valor de index
supera la longitud de una lista indexada, se utiliza la fórmula siguiente para determinar
su valor:
Índice-real = índice % longitud-de-la-lista;
Dicho de otra manera, para n elementos en un campo indexado, se obtienen los
resultados siguientes:
■
Un índice n devuelve el elemento 0
■
Un índice n+1 devuelve el elemento 1
■
Un índice n-1 devuelve el último elemento
La tabla siguiente ilustra los resultados de los elementos de acceso de un campo
indexado en un conjunto de datos del proceso:
Expresión
Descripción
valor = Process.X[2]
Se refiere al tercer elemento de un campo indexado X del conjunto
de datos del proceso.
valor = Process.X[18]
Para un campo indexado X con un tamaño de 19, esta expresión
hace referencia al elemento 19 de X, el mismo que Process.X[18].
valor = Process.X[Process.Y + 2]
Una expresión calcula el índice.
valor = Process.A[5][2]
Devuelve el valor en una matriz bidimensional. El tercer elemento en
la sexta lista indexada definida por la matriz define la matriz.
Capítulo 6: Conjuntos de datos y parámetros 265
Parámetros del proceso
Acceso a la longitud de un campo indexado
CA Process Automation es compatible con la propiedad de longitud de JavaScript para
matrices y su propia propiedad de tamaño para acceder a la longitud de un campo
indexado. La propiedad de longitud es de solo lectura, mientras que la propiedad de
tamaño permite cambiar el número de elementos de un campo indexado. La propiedad
de longitud utiliza la notación de puntos o de corchetes para devolver el número de
elementos de un campo indexado:
dataset_reference.indexed_field_name.length
dataset_reference[indexed_field_name_expression].length
La propiedad de tamaño funciona de la misma forma, utilizando notación de punto o de
paréntesis:
dataset_reference.indexed_field_name.size
dataset_reference[indexed_field_name_expression].size
Debido a que un campo indexado es una matriz basada en cero, las propiedades de
longitud y tamaño siempre devuelven una unidad más que el índice para el último
elemento de un campo. Así, cuando la longitud o el tamaño devuelven n, un campo
contiene 0, 1..., n-1 elementos indexados y el índice para el último elemento de la
matriz es n-1.
Si se asigna un nuevo valor a la propiedad de tamaño se extiende o trunca el número de
elementos en un campo indexado. Si se reduce el valor para la propiedad de tamaño, se
eliminan elementos del extremo superior de un campo indexado y se suprimen los
valores almacenados en los elementos suprimidos. El siguiente código utiliza la
propiedad de tamaño para incrementar la longitud de una matriz X en un elemento y,
posteriormente, asigna 25 al nuevo elemento:
Process.X.size = Process.X.size + 1;
Process.X[Process.X.size - 1] = 25;
Para una matriz pluridimensional, la propiedad de tamaño o longitud devuelve el
número de elementos en una dirección de matriz a la cual se anexa.
Por ejemplo, para una matriz bidimensional denominada matrix[a][b], la sintaxis
siguiente devuelve el tamaño de la primera dimensión de la matriz, con los elementos
que contienen 0...size1-1:
size1 = matrix.length
La siguiente sintaxis devuelve el tamaño de la segunda dimensión de la matriz, dado el
primer elemento de dimensión 2, con b que contiene los elementos 0...size2-1 cuando a
= 2 contiene elementos 0...size1-1:
size2 = matrix[2].length
266 Guía del diseñador de contenido
Parámetros del proceso
En el siguiente ejemplo se gestionan elementos de un campo indexado pluridimensional
enrollando todos los elementos en un campo indexado bidimensional (una matriz de
matrices) en la variable del conjunto de datos del proceso llamada "matrix". El código
asigna el valor para cada elemento a un campo indexado unidimensional en los valores
denominados de la variable del conjunto de datos del proceso:
var i; j; k=0;
for (i=0; i < Process.matrix.length; i++)
{
for (j=0; j < Process.matrix[i].length; j++)
{
Process.values[k] = Process.matrix[i][j]
k++
}
}
Cómo acceder a los métodos en un campo indexado
Los campos indexados son compatibles con los siguientes métodos de matriz de
JavaScript:
concat()
Concatena elementos en una matriz.
join()
Convierte todos los elementos de matriz en cadenas y los concatena.
pop()
Elimina un elemento del final de una matriz.
Nota: Si la matriz pertenece al conjunto de datos de operador de otro operador, no
utilice el método de explosión para que las matrices de JavaScript evalúen los
parámetros de operador.
push()
Empuja un elemento hasta el final de una matriz.
reverse()
Revierte el orden de los elementos en una matriz.
shift()
Cambia un elemento desde del inicio de una matriz.
slice()
Devuelve una sector de la submatriz de una matriz.
sort()
Ordena elementos de una matriz.
Capítulo 6: Conjuntos de datos y parámetros 267
Parámetros del proceso
splice()
Inserta, suprime o reemplaza elementos de la matriz.
toLocaleString()
Convierte una matriz en una cadena localizada.
toString()
Convierte una matriz en una cadena.
unshift()
Inserta elementos en el inicio de una matriz.
Para obtener información acerca de cómo utilizar estos métodos, consulte la guía de
referencia de JavaScript.
Especifique las variables del conjunto de datos denominadas
Los campos en los objetos de conjunto de datos (llamados "conjuntos de datos") se
identifican en expresiones que utilizan la notación de puntos (.string) o de corchetes
([expresión]):
Datasets[path_expression][variable_name_expression]
Datasets[path_expression].variable_name
path_expression
Es cualquier expresión de JavaScript que devuelve un descriptor de ruta para un
objeto de conjunto de datos en la biblioteca actual de CA Process Automation. La
ruta a cualquier objeto de la biblioteca empieza con una barra diagonal (/) para el
elemento raíz, seguida de la jerarquía de la carpeta delimitada por la barra y
termina con el nombre de objeto.
variable_name_expression
Representa una expresión que devuelve el nombre de un campo en el objeto de
conjunto de datos.
variable_name
Es el nombre real de un campo en el objeto de conjunto de datos.
Todas las sintaxis siguientes son válidas para hacer referencia al campo Y en las
coordenadas del conjunto de datos denominado que se encuentra en la carpeta
/MathValues:
Datasets["/MathValues/Coordinates"].Y
Datasets["/MathValues/Coordinates"].Y
268 Guía del diseñador de contenido
Parámetros del proceso
Más información:
Rutas relativas para conjuntos de datos (en la página 236)
Cómo especificar las variables del conjunto de datos del proceso
Las variables que contiene el conjunto de datos del proceso las puede definir el
desarrollador o CA Process Automation automáticamente cuando se inicia una instancia
de proceso. La palabra clave Proceso se utiliza para acceder a las variables del conjunto
de datos del proceso. Se puede utilizar la notación de puntos o de corchetes para
especificar una variable de proceso en una expresión:
Process.variable_name
Process[expresión]
La expresión puede especificar el nombre de la variable como una cadena literal en el
formato:
Process["variable_name"]
Por ejemplo:
Process["StartDate"]
Process.StartDate
CA Process Automation define automáticamente las siguientes variables de sistema de
proceso al ejecutar un proceso:
CallerUser
El ID del usuario que ha iniciado la instancia del proceso. Cuando un proceso padre
utiliza un operador Iniciar proceso para iniciar un proceso hijo, el proceso padre
transmite el valor de CallerUser. Cuando un operador Iniciar proceso de una tarea
planificada inicia otro proceso, el valor de CallerUser está en blanco.
DisplayName
El nombre del objeto de proceso tal como se muestra en la biblioteca.
effectiveUser
El propietario actual del objeto de proceso.
EndDate
La fecha de finalización de esta instancia del proceso, con el formato:
MM/DD/YYYY
EndTime
La hora de finalización de esta instancia de proceso, con el formato:
HH:MM:SS
Capítulo 6: Conjuntos de datos y parámetros 269
Parámetros del proceso
InstanceName
El nombre del objeto de proceso original que termina en un identificador de objeto
de tiempo de ejecución único que identifica cada instancia de un proceso. Por
ejemplo, 372 se añade a process_1, lo que da lugar a el Nombre de la instancia sea
process_1_372.
InstanceUUID
Sólo para uso interno.
ObjectID
Identificador de objeto sólo para uso interno.
ParentProcessROID
El identificador de objeto de tiempo de ejecución único para el proceso padre que
inició el proceso hijo.
rootUUID
Sólo para uso interno.
RuntimeROID
Un identificador de objeto único que la aplicación añade al Nombre para mostrar
del proceso para identificar cada instancia del proceso. Por ejemplo, RuntimeROID
372 se añade a process_1, lo que da lugar a que el Nombre de la instancia sea
process_1_372.
ScheduledStartTime
La fecha/hora en que se planificó el inicio del proceso.
ServerName
El nombre del servidor asociado con el punto de contacto.
ServerID
Sólo para uso interno.
StartDate
Fecha en que se creó esta instancia de proceso, con el formato:
MM/DD/YYYY
StartTime
Hora en que se creó esta instancia de proceso, con el formato:
HH:MM:SS
TouchpointName
Nombre del orquestador que gestiona el proceso en ejecución.
270 Guía del diseñador de contenido
Parámetros del proceso
Cómo especificar las variables del conjunto de datos del operador
Los conjuntos de datos de operador contienen variables que el desarrollador define en
el tiempo de diseño o que CA Process Automation define en el tiempo de ejecución para
un operador específico. Las variables del tiempo de diseño están disponibles
inmediatamente después de que se inicie un proceso. Las variables de tiempo de
ejecución se agregan cuando se ejecuta un operador.
El nombre de operador en el conjunto de datos local durante el tiempo de ejecución
etiqueta los conjuntos de datos del operador, a fin de que se pueda utilizar la notación
de puntos (.) o de corchetes ([expression]) para especificar una variable de operador en
una expresión:
Operator.field_name
Process["Operator_name"].field_name
Process["Operator_name"]["field_name"]
Los códigos de ejecución previa y ejecución posterior para un operador pueden utilizar
la palabra clave OpName para acceder al nombre del operador actual. Se puede utilizar
esta palabra clave para acceder a un conjunto de datos del operador o para crear un
conjunto de este tipo. Utilice la sintaxis siguiente para especificar una variable del
conjunto de datos del operador en el código de ejecución previa o posterior:
Process[OpName].field_name
En la siguiente tabla figuran variables de sistema de conjunto de datos del operador de
uso frecuente que CA Process Automation define automáticamente. Se pueden definir
variables adicionales para operadores específicos.
Variable del conjunto de datos
del operador
Alcance del tiempo de
ejecución
Descripción
AgentName
durante, después
Nombre de la máquina asociada al punto de
contacto que ejecuta el operador.
AgentID
durante, después
Sólo para uso interno.
EndDate
después de
La fecha en la que el operador finalizó la ejecución,
con el formato:
MM/DD/YYYY
EndTime
después de
La hora a la que el operador detuvo la ejecución,
con el formato:
HH:MM:SS
Motivo
después de
Una cadena que describe el resultado.
ResponseCode
después de
Una cadena que describe el resultado.
Capítulo 6: Conjuntos de datos y parámetros 271
Parámetros del proceso
Variable del conjunto de datos
del operador
Alcance del tiempo de
ejecución
Descripción
StartDate
durante, después
La fecha en la que el operador inició la ejecución,
con el formato:
StartTime
durante, después
La hora a la que el operador inició la ejecución, con
el formato:
MM/DD/YYYY
HH:MM:SS
ServiceType
durante, después
El módulo de CA Process Automation que ejecutó
el operador.
TargetName
durante, después
El nombre del objetivo (por ejemplo, Orquestador).
TouchpointName
durante, después
Nombre del punto de contacto que ejecuta el
operador.
UUID
durante, después
Sólo para uso interno.
Cómo especificar las variables del conjunto de datos del sistema
El conjunto de datos del sistema para un proceso contiene variables que devuelven
información del sistema. La palabra clave System se utiliza para acceder al conjunto de
datos del sistema. Se puede utilizar la notación de puntos (.) o de corchetes
([expression]) para especificar una variable de sistema en una expresión:
System.variable_name
System[expression]
La sintaxis siguiente utiliza notación de corchetes para especificar un nombre de
variable de sistema con una cadena literal:
System["variable_name"]
272 Guía del diseñador de contenido
Parámetros del proceso
El conjunto de datos del sistema contiene las variables siguientes:
DATE
La fecha actual, con el formato MM/DD/YY.
DAY
El día del mes.
FIRSTDAYMONTH
La fecha del primer día del mes actual, con el formato MM/DD/YY.
FIRSTDAYNEXTMONTH
La fecha del primer día del mes siguiente, con el formato MM/DD/YY.
FIRSTDAYPREVMONTH
La fecha del primer día del mes anterior, con el formato MM/DD/YY.
HOST
El nombre del host actual.
LASTDAYMONTH
La fecha del último día del mes actual, con el formato MM/DD/YY.
LASTDAYNEXTMONTH
La fecha del último día del próximo mes, con el formato MM/DD/YY.
LASTDAYPREVMONTH
La fecha del último día del mes anterior, con el formato MM/DD/YY.
MONTH
El mes actual representado como un número basado en 0 (por ejemplo, esta
variable devuelve 0 para enero).
TIME
La hora actual del día en minutos (por ejemplo, esta variable devuelve 600 para las
10 de la mañana)
TIMES
La hora actual del día, con el formato HHMM.
TOMORROW
La fecha del día siguiente a la fecha actual, con el formato MM/DD/YY.
WEEK
La semana del mes.
YEAR
El año actual.
Capítulo 6: Conjuntos de datos y parámetros 273
Parámetros del proceso
YESTERDAY
La fecha del día anterior al día actual, con el formato MM/DD/YY.
Sentencias
Las expresiones son frases de JavaScript que se evalúan para proporcionar un valor. Las
declaraciones de JavaScript ejecutan comandos o combinan una o más expresiones para
hacer cosas o proporcionar valores. Un programa de JavaScript es una recolección de
declaraciones.
Esta sección describe brevemente la sentencia de variables y la asignación de variables,
iteraciones y bucles que se utilizan comúnmente en los cálculos de CA Process
Automation. La siguiente tabla enumera las sentencias de JavaScript, algunas de las
cuales no se documentan en esta sección.
Sentencias JavaScript
Sentencia
Sintaxis
Descripción
Break
break; break nombre_etiqueta:
Salga de un conmutador o sentencia
iterativa; o salga de la sentencia con
un nombre proporcionado por una
sentencia de etiqueta.
case
case expresión:
Etiqueta una sentencia dentro de una
sentencia del conmutador.
continue
continue; continue nombre_etiqueta:
Reinicie el bucle o el bucle con un
nombre proporcionado por una
sentencia de etiqueta.
predeterminado
default;
Etiquete la sentencia predeterminada
dentro de una sentencia del
conmutador.
do/while
do statement while (expresión)
Realice expresiones en una sentencia
de rato hasta que una expresión la
evalúe como falsa.
empty
;
No hacer nada.
for
for (inicialización; prueba; incremento) Crear bucles mientras una prueba es
sentencia
verdadera.
for/in
Sentencia for (variable_in_object)
Crear bucles de las propiedades de un
objeto.
274 Guía del diseñador de contenido
Consulte La sentencia de bucle for/in.
Parámetros del proceso
Sentencia
Sintaxis
Descripción
function
function nombre_función(a1,a2...an)
{sentencias}
Declara una función. Consulte Incluir
recursos comunes en scripts de CA
Process Automation.
if/else
if (expresión) sentencia1 else
sentencia2
Ejecute condicionalmente. Consulte La
sentencia if.
etiqueta
identificador: sentencia
Asigne un identificador a una
sentencia.
return
return[ expresión]
Vuelva de una función o devuelva un
valor de una función.
switch
switch (expresión) {sentencias}
Rama condicional de Multiway para
sentencias de caso o
predeterminadas. Consulte La
sentencia del conmutador.
throw
throw expresión;
Descartar una excepción.
try
try {sentencias}
Capturar una excepción.
var
var name_1[=value1][, ..., name_n
[=value_n]];
Declare e inicialice opcionalmente
variables. Consulte Declaración de
variable.
while
while (expresión) sentencia
Realice expresiones en una sentencia
while hasta que una expresión la
evalúa como verdadera. Consulte La
sentencia de bucle while.
Más información:
Declaración variable (en la página 276)
La sentencia if (en la página 277)
La sentencia del conmutador (en la página 279)
La sentencia del bucle while (en la página 280)
Consulte la sentencia de bucle for/in (en la página 281)
Incluir recursos comunes en scripts de CA Process Automation (en la página 284)
Capítulo 6: Conjuntos de datos y parámetros 275
Parámetros del proceso
Declaración variable
La sentencia de var de JavaScript declara una variable de JavaScript. Opcionalmente, se
puede utilizar el operador de asignación = para inicializar una variable en el mismo
momento de su creación. La definición de variable de JavaScript utiliza la sintaxis
siguiente:
var variable_name [= initial_value];
Las líneas siguientes crean variables pero dejan los valores iniciales sin definir hasta que
el código subsiguiente les asigne valores:
var x
var s
Se puede inicializar una variable como un entero o como una cadena. En el ejemplo
siguiente, x se inicializa como un entero y s como una cadena vacía.
var x = 0
var s= ""
Pueden crear diversas variables en una única sentencia:
var i = 0, j = 0, k = 0
Asignación variable
Para asignar valores a variables de conjunto de datos, utilice el operador de asignación
=. La asignación variable utiliza la sintaxis siguiente:
[dataset_reference.]variable_name = expresión;
La expresión está formada por cualquier combinación de funciones, variables, valores y
operadores, y devuelve una cadena o un valor entero. Por ejemplo:
Process.S = "ABCDEF" + '_' + "123"
Datasets[“ThisDataset”].x = 18 * I
x = 18 * I
De forma predeterminada, si se omite la referencia del conjunto de datos, JavaScript
hará referencia al conjunto de datos del proceso. Si la variable no existe en el conjunto
de datos del proceso, JavaScript crea una variable provisional. Si desea crear una
variable del conjunto de datos del proceso, utilice la referencia del proceso.
Reutilización de variables
Selección de la variable de proceso padre-hijo: capacidad que permite que un proceso
hijo consulte a las variables inicializadas por el proceso padre
276 Guía del diseñador de contenido
Parámetros del proceso
Declaraciones condicionales
Las expresiones de CA Process Automation reconocen las sentencias condicionales de
JavaScript. La selección condicional if evalúa una sola condición booleana mientras que
el condicional evalúa una serie de condiciones booleanas. Las declaraciones
condicionales de CA Process Automation que esperan un valor booleano reconocen el 0
como Falso y los enteros que no sean cero como Verdadero. Las expresiones de CA
Process Automation también son compatibles con la sentencia del conmutador, el cual
permite resultados múltiples al evaluar una sola variable.
La sentencia if
La sentencia de selección condicional if utiliza la sintaxis siguiente:
if (expresión_booleana)
sentencia
La expresión booleana es una combinación de funciones, variables, valores y operadores
que devuelve un valor único Verdadero o Falso. Por ejemplo:
if (i <= 18) {
y = 18 * I
z = y * 56
}
El segundo formulario de la sentencia de selección condicional if permite dos resultados
de la expresión booleana. La sintaxis es la siguiente:
if (expresión_booleana)
sentencia1
else
sentencia2
Por ejemplo:
if (i <= 18)
Process.Date = System.Date
else
Process.Date = "2006/01/23"
Capítulo 6: Conjuntos de datos y parámetros 277
Parámetros del proceso
La sentencia else if
Para resultados múltiples, se pueden anidar sentencias de if/else. Sin embargo, la lógica
se puede volver molesta para seguir con demasiados anidamientos. Se puede utilizar,
por lo tanto, la construcción siguiente para una serie de sentencias de if/else:
if (expresión_booleana_1)
sentencia_1
else (expresión_booleana_2)
sentencia_2
else if (expresión_booleana_3)
sentencia_3
...
else if (expresión_booleana_n)
sentencia_n
else
sentencia_else
La sentencia else final es opcional. Meramente especifica el código que se tiene que
ejecutar si ninguna de las expresiones booleanas es verdadera.
278 Guía del diseñador de contenido
Parámetros del proceso
La sentencia del conmutador
La sentencia del conmutador realiza una rama multiforma, que es útil cuándo todas las
ramas de una sentencia condicional dependen de la misma variable. En este caso, es
molesto comprobar el valor de la misma variable repetidamente utilizando múltiples
sentencias if. La sentencia del conmutador utiliza la sintaxis siguiente para hacer lo
mismo más eficazmente:
switch(variable)
{
case value_1:
sentencias
break;
case value_2:
sentencias
Break
...
case value_n:
sentencias
Break
default:
sentencias
Break
}
La sentencia del conmutador ejecuta el código dentro de la sentencia del caso que
coincide con el valor actual de la variable. Si no hay ninguna coincidencia, la sentencia
del conmutador ejecuta el código predeterminado o avanza hasta la sentencia siguiente
si no hay ningún código predeterminado. Las declaraciones de interrupción
opcionalmente delimitan un bloqueo de código de un caso del caso siguiente. A falta de
una sentencia de interrupción, la ejecución va de un caso al siguiente. Esto es una acción
legal, por lo que hay que tener cuidado de no omitir una sentencia de interrupción a
menos que realmente pretenda que la ejecución fracase hasta la sentencia de caso
siguiente.
Declaraciones iterativas
JavaScript tiene varias sentencias de bucle iterativas, una sentencia de continuar y una
sentencia de interrupción. Los bucles while y do-while realizan una o más declaraciones
mientras alguna condición sea verdadera. Los bucles for y for loops realizan una o más
declaraciones un número especificado de veces. La sentencia de interrupción cierra una
declaración iterativa. La sentencia de continuar reinicia un bucle en una nueva iteración.
Capítulo 6: Conjuntos de datos y parámetros 279
Parámetros del proceso
La sentencia del bucle while
El bucle while presenta la siguiente sintaxis:
while (expresión_booleana)
sentencia
El bucle while realiza una secuencia de sentencias mientras la expresión booleana
probada en el inicio del bucle devuelva un valor Verdadero. Por ejemplo:
var n = 0
while (z < 10)
{
Process.square[n] = n * n
n++
}
La sentencia del bucle do/while
El bucle do-while presenta la siguiente sintaxis:
do
sentencia
while (expresión_booleana)
El bucle do-while es similar al bucle while excepto que prueba al final del bucle en lugar
de al inicio del bucle. El bucle while realiza una secuencia de sentencias mientras la
expresión booleana devuelva un valor Verdadero. Por ejemplo:
var n = 0
do {
Process.square[n] = n * n
} while (n++ < 10)
La sentencia de bucle for
El bucle for realiza una secuencia de sentencias para un número especificado de veces.
El bucle for presenta la siguiente sintaxis:
for (inicialización ; prueba ; incremento) sentencia
sentencia
El bucle for es similar al bucle while excepto que se incluye una inicialización y un
incremento en la sintaxis del bucle. Cada iteración del bucle for aumenta el incremento,
realiza la prueba y realiza la sentencia.
Por ejemplo, dada una variable indexada Process.square que contiene 35 valores, podría
utilizar las líneas siguientes del código para configurar todos los valores al cuadrado de
su índice:
for (var i = 0; i < 34; i++)
Process.square[i] = i * i
280 Guía del diseñador de contenido
Parámetros del proceso
Consulte la sentencia de bucle for/in
El bucle for/in realiza una secuencia de sentencias para todos los valores de una variable
especificada en un objeto concreto. El bucle for/in tiene la sintaxis siguiente:
for (variable en objeto)
sentencia
El valor de variable es uno de los elementos siguientes:
■
El nombre de una variable
■
Una sentencia de var que declara una variable
■
Un elemento de matriz
■
Una propiedad del objeto
Dicho de otra manera, el valor de variable es equivalente al lado izquierdo de una
expresión de asignación. El valor de objeto es el nombre de un objeto o una expresión
que devuelve un objeto.
Por ejemplo, para hacer bucles a través de los elementos de un campo indexado en un
conjunto de datos, hay que definir una variable de índice y especificar el campo
indexado como el objeto.
for (var i in Process.square)
Process.square[i] = i * i
La sentencia de interrupción
La sentencia de interrupción se puede utilizar para cerrar un bucle, como se ilustra en
las líneas siguientes del código.
var l = 0;
while (I < 10) {
n = n++;
if (n > 102)
break;
}
Capítulo 6: Conjuntos de datos y parámetros 281
Parámetros del proceso
La sentencia de continuar
La sentencia de continuar se puede utilizar para avanzar hasta la iteración siguiente de
un bucle. El ejemplo siguiente (bastante trivial) ilustra el uso de la sentencia de
continuar para asignar números pares a una variable local indexada.
var i = 0, j = 0
for (j=0; j < 102; j++)
{
if (j%2) continue
// sentencia siguiente ejecutada solamente para valores pares de j
Process.evens[i] = j
i++
// parada siguiente del bucle cuando se completan todos los elementos de la
matriz
if (i >= Process.evens.Size) break
}
282 Guía del diseñador de contenido
Parámetros del proceso
Especificar rutas de sistema en las expresiones de CA Process Automation
Los cálculos generalmente aceptan las rutas de UNIX o Microsoft Windows. La ruta de
UNIX funciona para las ubicaciones tanto en UNIX como en los sistemas de host de
Microsoft Windows. Por ejemplo:
Process.Path = "/tmp/files/myfile"
El ejemplo anterior especifica la ubicación de la unidad actual para un host de Microsoft
Windows o la raíz para un host de UNIX. Especifique una ruta de red de la siguiente
manera:
Process.NetPath = "//myhost/tmp/files/myfile.txt"
Incluya la especificación de la unidad en una ruta para un sistema de Microsoft
Windows de la siguiente manera:
Process.Path = "C:/tmp/files/myfile.txt"
Si un directorio de trabajo (como C:\tmp) se especifica para un proceso de Microsoft
Windows, especifique una ruta dentro del directorio de trabajo sin ningún carácter de
barra principal, de la siguiente manera:
Process.Subdir = "files/myfile.txt"
Si utiliza una ruta de Microsoft Windows en un cálculo, verifique que se sustituye el
carácter de barra inclinada invertida para que el intérprete correctamente lo evalúe
como un carácter real, de la siguiente manera:
Process.Path = "C:\\tmp\\files\\myfile.fm"
Capítulo 6: Conjuntos de datos y parámetros 283
Parámetros del proceso
Incluir recursos comunes en scripts de CA Process Automation
Se pueden incluir previamente scripts definidos en un script de CA Process Automation.
Esto le permite a un script leer dentro y acceder a las funciones guardadas en el tiempo
de ejecución. Utilice la sentencia de incluir en cualquier línea de un cuadro de diálogo
de script para agregar un script previamente guardado al archivo. La sentencia de incluir
utiliza la sintaxis siguiente:
include(expression)
El argumento de expresión puede ser cualquier ruta que haga referencia un recurso
apropiado. Las rutas reconocidas incluyen:
■
Una ruta relativa, como include("Scripts/functions.js)", especifica un recurso de
usuario común (c2ouserresources) en el repositorio de CA Process Automation.
Nota: Para obtener más información sobre cómo agregar o gestionar recursos en el
repositorio de CA Process Automation, consulte “Gestionar recursos comunes” en
la Guía de administración.
■
Una ruta del directorio, como include("/scripts/functions.js)", especifica un script en
la unidad actual para un host de Microsoft Windows o la raíz para un host de UNIX.
■
El incluir la letra de unidad de disco en una ruta explícita, como
include("D:\\scripts\\functions.js)", se especifica un script en una unidad
especificada.
■
Una ruta de red, como include("//share/scripts/function.js)", especifica un script en
un recurso de red compartido.
■
Una URL, como include(“http://james:8080/itpam/scripts/functions.js"), especifica
una ruta a un recurso Web.
Se agregan las líneas en un script incluido a un script como si se escribieran en lugar de
la sentencia de incluir. Tenga en cuenta que es una buena práctica incluir solamente
funciones necesarias u otro código en lugar de bibliotecas de función larga en un script
incluido. Se recopilan scripts incluidos en el tiempo de ejecución; demasiadas líneas de
código sin utilizar innecesariamente aumentan el tiempo necesario para ejecutar un
script.
Comentarios en los cálculos de CA Process Automation
Los comentarios de JavaScript se delimitan en líneas por el par de caracteres //. El inicio
de un comentario siempre implica el final de una línea lógica. Un comentario se inicia al
final de la línea lógica y termina al final de la línea física. El intérprete de lenguaje de
JavaScript ignora comentarios.
284 Guía del diseñador de contenido
Capítulo 7: Formularios
CA Process Automation es compatible con dos tipos de objetos de formulario
interactivos principales:
■
Formularios de solicitud de inicio
■
Formularios de solicitud de interacción
Diseñe estos formularios en puntos estratégicos del proceso para permitir a los usuarios
proporcionar datos y controlar el proceso.
Los operadores personalizados también incluyen formularios con páginas y campos de
datos que aparecen en la paleta Propiedades del Diseñador de procesos.
Esta sección contiene los siguientes temas:
Formularios de solicitud de inicio (en la página 285)
Formularios de solicitud de interacción (en la página 287)
El Diseñador de formularios (en la página 289)
Inicialización de variables de formulario (en la página 377)
Formularios de solicitud de inicio
El objeto Formulario de solicitud de inicio permite crear una interfaz que permite a
otros usuarios iniciar un proceso e introducir datos en el inicio de manera estructurada.
Se diseña y mantiene el diseño y comportamiento del formulario. Los usuarios rellenan
el formulario cuando se le solicita. Por ejemplo, se le puede dar a alguien la capacidad
de proporcionar información que influya en la forma en que se inicia un proceso
relacionado.
Se puede agrupar una serie de elementos de forma relacionados en una página
específica o en una sección específica de la página. Se puede agregar cualquier número
de páginas. Se pueden utilizar funciones y eventos para obtener o establecer otros
valores de campo. Diseñe el formulario para recopilar toda la información del usuario
que se requiere para iniciar el proceso.
Capítulo 7: Formularios 285
Formularios de solicitud de inicio
Monitorización de las instancias del formulario de solicitud de inicio y las
instancias del proceso
Después de crear y diseñar un formulario de solicitud de inicio, se debe iniciar como
parte de otro proceso o manualmente. Cuando se inicia un formulario, da lugar a una
nueva instancia de formulario con un nombre único formado por el nombre del
formulario más el ID de objeto de tiempo de ejecución del formulario. Cuando se inicia
un proceso, da lugar a una nueva instancia de proceso con un nombre único formado
por el nombre del proceso más el ID de objeto de tiempo de ejecución del proceso. A
continuación, se ofrecen algunos ejemplos:
MyStartRequestForm_239
MyProcess_241
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Operaciones.
2.
En el panel Operaciones, vaya a cualquiera de las ubicaciones siguientes para ver
instancias del proceso y el formulario:
a.
Expanda Iniciar solicitud, expanda las carpetas y haga clic en un formulario de
solicitud de inicio.
b. Expanda Observación de procesos, expanda las carpetas, expanda un objeto de
observación de procesos y haga clic en un formulario de solicitud de inicio
opcional agregado previamente al objeto.
c.
3.
Expanda Vínculos y haga clic en Iniciar solicitud.
En el panel Operaciones, vaya a una de las ubicaciones siguientes para iniciar un
formulario y su proceso asociado:
a.
Expanda Iniciar solicitud, expanda las carpetas y haga clic en un formulario de
solicitud de inicio. Haga clic con el botón secundario del ratón en el formulario
y seleccione Inicio.
b. Expanda Observación de procesos, expanda las carpetas, expanda un objeto de
observación de procesos y haga clic en un formulario de solicitud de inicio
opcional agregado previamente al objeto. Haga clic con el botón secundario del
ratón en el formulario y seleccione Inicio.
4.
Repita el paso 2 para ver tanto la instancia del formulario como la instancia del
proceso.
5.
Para monitorizar la instancia del proceso, haga clic en una fila y, a continuación,
haga clic en Abrir instancia de proceso en la barra de herramientas.
286 Guía del diseñador de contenido
Formularios de solicitud de interacción
Notas:
■
La columna Instancia del proceso no muestra ningún dato de ningún formulario en
el estado En cola. Los formularios en cola no crean una instancia de un proceso
hasta que el formulario empieza a ejecutarse.
■
El nombre de la instancia de un proceso se puede cambiar con el proceso en
ejecución mediante Process.UserInstName. Haga clic en Actualizar para ver el
nuevo nombre de la instancia del proceso.
■
La columna Instancia del proceso no incluye ningún formulario que estuviera en
ejecución antes de actualizar a la versión actual de CA Process Automation.
Formularios de solicitud de interacción
El Formulario de solicitud de interacción permite crear una interfaz que se puede utilizar
durante la ejecución de un proceso para interactuar con un usuario en una manera
estructurada. Los usuarios que gestionan procesos en CA Process Automation o tienen
algún otro objetivo de negocio pueden acceder al formulario en un explorador Web.
Entre los casos de uso típicos de formularios de solicitud de interacción se incluyen los
siguientes:
■
Obtención de aprobación antes de avanzar en un proceso o una ruta dentro de un
proceso.
■
Concesión de permiso para que un usuario seleccione un curso de acción.
■
Recuperación de información que sólo está disponible de una persona en tiempo de
ejecución.
■
Solicitud de acciones manuales (por ejemplo, conexión física de un servidor a un
conmutador) que deberán llevarse a cabo y marcarse como completadas antes de
avanzar en un proceso.
Capítulo 7: Formularios 287
Formularios de solicitud de interacción
El objeto de formulario de solicitud de interacción define las páginas, los parámetros y
otras características del formulario. Los parámetros pueden configurarse para mostrar
cuadros de edición, listas desplegables, cuadros de lista y listas de casillas de verificación
en las páginas de formulario. El formulario puede tener varias páginas, lo que permite
agrupar parámetros relacionados en páginas separadas. Para pasar por las páginas de
un Formulario de solicitud de interacción, los usuarios deben hacer clic en los botones
Siguiente y Atrás. Se puede agregar un número de páginas indefinido a un Formulario de
solicitud de interacción para reunir todos los datos requeridos durante la ejecución de
un proceso que utiliza el formulario.
Los formularios de solicitud de interacción se guardan como objetos separados en la
biblioteca de automatización. Después de crear e incorporar un Formulario de solicitud
de interacción, se le puede agregar a cualquier proceso que utilice el operador Asignar
tarea de usuario.
Cuando un proceso ejecuta el operador Asignar tarea de usuario, el Formulario de
solicitud de interacción se clasifica como una petición de usuario pendiente en CA
Process Automation. El operador Interacción de usuario no se completa hasta que un
usuario autorizado responde a la petición al rellenar y enviar el Formulario de solicitud
de interacción o hasta que se agota el tiempo de espera especificado en el operador
Asignar tarea de usuario.
288 Guía del diseñador de contenido
El Diseñador de formularios
El Diseñador de formularios
Cuando se abre un formulario desde el explorador de bibliotecas, aparece el Diseñador
de formularios. El Diseñador de formularios presenta una barra de herramientas
estándar y una serie de fichas. Utilice la ficha Formulario para diseñar un formulario y
utilice la ficha Vista previa para comprobar su aspecto.
Capítulo 7: Formularios 289
El Diseñador de formularios
290 Guía del diseñador de contenido
El Diseñador de formularios
Element Descripción:
o:
Elementos de formulario: la parte superior de este panel muestra todos los tipos disponibles de
controles.
Estructura de formulario: la parte inferior de este panel muestra la estructura del formulario. Arrastre
y suelte los elementos del formulario en las páginas del formulario desde aquí.
Páginas de formulario: el diseño de las páginas del formulario aparece aquí. Haga clic en un control
para editar sus propiedades. Para los formularios que disponen de varias páginas, haga clic en Atrás y
Siguiente para ver otras páginas. Los usuarios también pueden hacer clic en Siguiente y Atrás para ver
las páginas del formulario.
Arrastre y suelte elementos del formulario en la página para diseñar los formularios.
Nota: El área que está disponible para soltar una página en otra página es muy pequeña. Se
recomienda arrastrar el elemento de página al área de límite que se encuentra entre los elementos del
formulario y el propio formulario:
Panel de propiedades: use este panel para ver o editar las variables de los elementos del formulario.
Por ejemplo, configure la propiedad Requerido como verdadero, cambie la etiqueta utilizada para
identificar un campo o especificar una función para un evento.
La ilustración muestra los argumentos siguientes utilizados en el evento onFocus para establecer el
valor de un campo de texto denominado Form.Var_3 hasta 500:
ca_pam_setTextFieldValue(Form.Var_3, 500)
Capítulo 7: Formularios 291
El Diseñador de formularios
Elementos de formulario
Este tema presenta ejemplos básicos de cada tipo de elemento de formulario.
Element Descripción:
o:
Estructura de formulario: mientras se diseña el formulario, la organización de las páginas y los
elementos de formulario aparecen en la ficha Formulario.
Vista de página: la vista se puede configurar para mostrar las páginas como tarjetas o fichas. Las
tarjetas aparecen en secuencia cuando el usuario hace clic en Atrás o Siguiente. Las fichas permiten el
usuario seleccionar cualquier ficha para consultar la página asociada.
Casillas de verificación y botones de opción: utilice un grupo de casillas de verificación (elementos de
lista de comprobación) para que el usuario pueda seleccionar varios elementos relacionados. Use un
grupo de botones de opción (botones de selección) cuando un usuario puede seleccionar solamente un
elemento relacionado. Use casillas de verificación individuales para controlar los valores de
configuración de elementos inconexos.
Orientación: las listas de comprobación y los botones de opción pueden aparecer en orientación
vertical u horizontal.
Etiquetas: utilice etiquetas para identificar campos específicos o regiones del formulario.
Imágenes: utilice un elemento de imagen para especificar un gráfico. Se pueden utilizar imágenes para
mostrar logotipos, iconos, indicadores de estado o botones en los que los usuarios pueden hacer clic.
El icono de vínculo roto aparece cuando el formulario no puede encontrar una imagen.
HTML: use este elemento de formulario para especificar el código de HTML que se desea procesar
para el usuario del formulario.
292 Guía del diseñador de contenido
El Diseñador de formularios
Element Descripción:
o:
Referencia de objeto: use una referencia de objeto para permitir a los usuarios del formulario
seleccionar fácilmente otro objeto en el explorador de bibliotecas. Una referencia de objeto almacena
la ruta de un objeto en una biblioteca. Por ejemplo, un usuario puede especificar un punto de contacto
en un orquestador y, a continuación, ejecutar un proceso en el punto de contacto seleccionado. Como
diseñador de formularios, se pueden limitar los tipos de objetos disponibles que una referencia de
objeto permite.
Element Descripción:
o:
Conjunto de campos: utilice conjuntos de campos para agrupar elementos de formulario relacionados.
Los usuarios pueden expandir y contraer los conjuntos de campos para centrarse en partes específicas
de un formulario y evitar de ese modo la confusión.
Campo de texto y área de texto: use los campos de texto para que los usuarios puedan introducir
datos básicos, como nombres, direcciones, cuentas de correo electrónico, números de teléfono y otros
datos. Use los elementos Área de texto para que los usuarios puedan introducir varias líneas de texto.
Los usuarios pueden ver la cantidad de texto que se determinó en la propiedad de altura del
formulario y desplazarse por el resto del campo.
Texto multilínea: se puede usar texto multilínea para mostrar cantidades grandes de texto en una
ventana aparte a la que se le puede cambiar el tamaño y por la que el usuario se puede desplazar. Este
elemento ocupa una línea única en el formulario. En el formulario aparece como un botón con puntos
suspensivos (...) con el fin de indicar que se puede hacer clic en él para explorar la ventana completa.
Campo Fecha: utilice un campo de fecha para almacenar una fecha. Los usuarios pueden introducir
una fecha o seleccionarla en el control de calendario integrado.
Control numérico: utilice este tipo de campo para permitir al usuario aproximar o ajustar un valor
hacia arriba o abajo en incrementos predeterminados.
Capítulo 7: Formularios 293
El Diseñador de formularios
Element Descripción:
o:
Búsqueda: utilice una búsqueda para presentar una tabla de una columna de valores en una ventana
emergente. Se puede utilizar un conjunto de datos o una fuente de datos externa para proporcionar
los valores. Un usuario puede hacer clic en un valor y, a continuación, seleccionar Aceptar para rellenar
el campo de búsqueda y almacenar el valor.
Seleccionar: use este elemento para presentar una lista desplegable de opciones al usuario.
Matriz simple y tabla: utilice una matriz simple para almacenar un solo tipo de datos en una tabla.
Utilice una tabla cuando sea necesario almacenar varias columnas de datos. Estos elementos de
formulario incluyen opciones para agregar, suprimir y mover filas.
En una tabla se pueden insertar los elementos siguientes:
■
Casilla de verificación
■
Fecha
■
Conjunto de campos
■
Imagen
■
Etiqueta
■
Campos de búsqueda
■
Botón de opción (botón de selección)
■
Campo de selección
■
Campo de texto
■
Área de texto
■
Texto multilínea
■
Tabla
■
Matriz simple
■
Referencia de objeto
■
Lista de comprobación
■
Control de números
■
HTML
■
Página
294 Guía del diseñador de contenido
El Diseñador de formularios
Propiedades del elemento de formulario
Nota: Señale un atributo de elemento de formulario para consultar la descripción de
sugerencia del elemento si desea obtener ayuda para completar el formulario.
Permitir agregar filas
Valor booleano (verdadero o falso) para tablas y matrices simples. Cuando es
verdadero, un botón permite a los usuarios de los formularios crear filas en la tabla.
Cuando es falso, los usuarios no pueden agregar filas a la tabla.
Permitir decimales
Valor booleano (verdadero o falso) para los campos de control numérico. Cuando es
verdadero, los usuarios pueden introducir números con decimales, como 12,25 o
0,003. Cuando es falso, los usuarios no pueden introducir números decimales en el
campo; solamente números enteros.
Permitir eliminar filas
Valor booleano (verdadero o falso) para tablas y matrices simples. Cuando es
verdadero, un botón permite a los usuarios de los formularios eliminar filas de la
tabla. Cuando es falso, los usuarios no pueden eliminar filas de la tabla.
Permitir números negativos
Valor booleano (verdadero o falso) para los campos de control numérico. Cuando es
verdadero, los usuarios pueden introducir números inferiores a cero, como -10.
Cuando es falso, los usuarios no pueden introducir números negativos; solamente 0
o números positivos.
Permitir reorganizar filas
Valor booleano (verdadero o falso) para tablas y matrices simples. Cuando es
verdadero, dos botones permiten a los usuarios de los formularios mover las
entradas hacia arriba y abajo en la tabla. Cuando es falso, los usuarios no pueden
mover las filas hacia arriba y abajo en la tabla.
Calendario
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Calendario. Cuando es falso o está vacío,
el tipo Calendario de objeto de automatización no se muestra. Las propiedades del
objeto de campos de referencia de objeto filtran tipos específicos de objetos de
automatización cuando el usuario consulta las opciones disponibles.
Capítulo 7: Formularios 295
El Diseñador de formularios
Etiqueta de la casilla de verificación
Cadena de texto o nombre aplicado a una sola casilla de verificación o un elemento
de casilla de verificación de un grupo.
Creado por
Cuenta de usuario o nombre del usuario que ha creado el formulario.
Creado el
Fecha y hora en las que se creó el formulario.
Icono personalizado
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Icono personalizado. Cuando es falso o
está vacío, el tipo Icono personalizado de objeto de automatización no se muestra.
Las propiedades del objeto de campos de referencia de objeto filtran tipos
específicos de objetos de automatización cuando el usuario consulta las opciones
disponibles.
Operador personalizado
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Operador personalizado. Cuando es falso
o está vacío, el tipo Operador personalizado de objeto de automatización no se
muestra. Las propiedades del objeto de campos de referencia de objeto filtran tipos
específicos de objetos de automatización cuando el usuario consulta las opciones
disponibles.
Conjunto de datos
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Conjunto de datos. Cuando es falso o
está vacío, el tipo Conjunto de datos de objeto de automatización no se muestra.
Las propiedades del objeto de campos de referencia de objeto filtran tipos
específicos de objetos de automatización cuando el usuario consulta las opciones
disponibles.
Expresión del conjunto de datos
Referencia a una variable de matriz específica en un objeto de conjunto de datos en
la biblioteca como en el siguiente ejemplo:
Datasets["/MyFolder/MyForm/MyDatasetObject"].MyArray
296 Guía del diseñador de contenido
El Diseñador de formularios
Formato de fecha
Formato preferido para las fechas. Por ejemplo, introduzca el valor dd de MMMM
de yyyy para que la fecha 05/01/2014 tenga el formato 01 de mayo de 2014.
Introduzca yyyyMMdd para mostrar la misma fecha así: 20140501. El formato de
fecha predeterminado es MM/dd/yyyy.
La hora también se puede almacenar en un campo de fecha. Por ejemplo, se puede
establecer la propiedad Formato de fecha como dd/MM/yyyy hh:mm:ss para
mostrar el valor de fecha y hora 01/05/2014 10:17:43.
Descripción
Información acerca del elemento de formulario además de su nombre o etiqueta
corta.
Desactivado
Configuración opcional que se puede aplicar a un elemento de formulario. Los
siguientes comportamientos definen elementos con el conjunto de propiedades
Desactivado:
■
El elemento de formulario no puede estar activo.
■
El elemento de formulario se muestra atenuado.
■
No se puede cambiar el valor de un elemento de formulario desactivado; sin
embargo, sí se puede copiar su valor para volver a utilizarlo.
Desactive un elemento de formulario para aplicar lógica empresarial e impedir que
se introduzcan datos no válidos.
Editable
Valor booleano (verdadero o falso) para un campo. Cuando es verdadero, los
usuarios pueden editar el campo. Cuando es falso, los datos son de sólo lectura.
Altura
Cantidad de espacio vertical que el elemento de formulario ocupa. Especifique un
valor (en píxeles) para esta propiedad desde la parte superior hasta la inferior del
elemento de formulario.
Oculto
Valor booleano (verdadero o falso) para un campo.
Verdadero
Hace que el campo sea invisible cuando el formulario se procesa.
Capítulo 7: Formularios 297
El Diseñador de formularios
Ocultar etiqueta
Valor booleano (verdadero o falso) para un campo o una tabla con una etiqueta.
Cuando es verdadero, la etiqueta está oculta. Cuando es falso o está vacío, la
etiqueta sí se puede ver.
_id
Identificador de sólo lectura único para una instancia específica de un elemento de
formulario. La propiedad _id añade los siguientes elementos al nombre del
formulario con un punto (.) como separador:
■
Nombre de cualquier objeto padre como tabla
■
Nombre del elemento de formulario
Por ejemplo, Form1 tiene dos grupos de botón de selección con las siguientes
propiedades _id:
Form1.rgName1
Form1.rgName2
Un botón de selección específico podría tener la siguiente propiedad _id:
Form1.rgName2.RadioOptionA
Un elemento de formulario de una tabla denominada "Table_2" podría tener la
siguiente propiedad _id:
Form_1.Table_2.Var_3
La propiedad _id para un formulario es la misma que su valor de la propiedad
Nombre.
Nota: La propiedad _id se utiliza en las funciones de JavaScript. Cuando se
renombra o se mueve un elemento, sea consciente de que también está cambiando
su _id.
Incremento
En los campos de control numérico, valor de un ajuste incremental hacia arriba o
abajo. Por ejemplo, si el campo muestra 6,55 y el incremento es de 0,02, un clic
hacia arriba da como resultado 6,57; mientras que un clic hacia abajo, 6,53.
Formulario de solicitud de interacción
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Formulario de solicitud de interacción.
Cuando es falso o vacío, los objetos de automatización del tipo Formulario de
solicitud de interacción no se muestran. Las propiedades del objeto de campos de
referencia de objeto filtran tipos específicos de objetos de automatización cuando
el usuario consulta las opciones disponibles.
298 Guía del diseñador de contenido
El Diseñador de formularios
Invisible
Hace que únicamente los campos de formularios de operador personalizados sean
visibles o invisibles pero de solo lectura.
Verdadero
Hace que el campo sea invisible únicamente dentro de operadores
personalizados.
Nota: Este atributo solo es válido en operadores personalizados. El atributo
Oculto solamente oculta un campo donde el atributo Invisible oculta el campo
y también establece el campo en solo lectura.
Dentro de los operadores personalizados, el atributo Invisible creado en CA
Process Automation versión 3.x y el atributo Oculto creado en CA Process
Automation versión 4.1 se asignan a este atributo en CA Process Automation
versión 4.2.
Etiqueta
Nombre descriptivo corto que se muestra al usuario de un elemento de formulario.
Alineación de etiquetas
Una propiedad de sólo lectura que indica cómo se muestran las etiquetas de campo
con respecto a los elementos de formulario que describen. En Diseñador de
formularios, se puede hacer clic en los botones de la barra de herramientas para
alinear etiquetas a la izquierda, a la derecha o por encima de los elementos del
formulario seleccionado.
Ancho de etiqueta
Tamaño (en píxeles) de una línea de texto de etiqueta. Las etiquetas más largas se
justifican en la línea siguiente.
Capítulo 7: Formularios 299
El Diseñador de formularios
Diseño
Propiedad exclusiva de diseño que determina cómo se mostrarán varias páginas de
un formulario en las fichas Formulario y Vista previa.
Tarjeta
Consulte una página a la vez; utilice los botones Atrás y Siguiente para ir de una
página a otra en orden. Mediante esta configuración es cómo se muestran las
páginas de todos los formularios. Tarjeta es la configuración predeterminada
de Diseño.
Ficha
Consulte los nombres de páginas disponibles en sus respectivas fichas. Por
comodidad, los diseñadores pueden hacer clic en una ficha para ir a la página
asociada en cualquier orden.
Longitud máxima
Número máximo de caracteres que un usuario puede introducir en el campo. Por
ejemplo, para requerir un número de 8 dígitos en un campo específico, establezca
las propiedades de Longitud Máxima y Longitud mínima para el campo en 8.
Número máximo de filas
Número máximo de entradas permitidas en una tabla.
Longitud mínima
Número mínimo de caracteres que un usuario puede introducir en el campo. Por
ejemplo, para requerir un número de 8 dígitos en un campo específico, establezca
las propiedades de Longitud Máxima y Longitud mínima para el campo en 8.
Núm. mínimo de filas
Número mínimo de entradas permitidas en una tabla.
Modificado por
Cuenta de usuario o nombre del usuario que ha modificado el formulario.
Fecha de modificación
Fecha en la que el objeto del formulario se modificó por última vez.
300 Guía del diseñador de contenido
El Diseñador de formularios
Nombre
Cadena única que identifica un elemento de formulario. El sistema asigna un
nombre inicial (como Var_3) cuyo valor puede modificar. Al cambiar el valor de
nombre también se cambiará el valor _id.
Los elementos de formulario pueden tener dos nombres independientes: una
propiedad Nombre y un nombre interno que identifica el elemento de formulario
en el Diseñador de formularios.
■
Cambie el valor Nombre para establecer el valor de la variable _id que
identifica el elemento de formulario.
■
Haga clic en Renombrar para cambiar el nombre interno de un elemento que se
muestra en el diseño de estructura de formulario jerárquica durante el
procedimiento de diseño. Este nombre interno es el valor predeterminado
dado a la etiqueta de un elemento de formulario. Esta etiqueta se muestra a
los usuarios del formulario en el tiempo de ejecución.
Formato de número
Cadena que define el formato de la entrada numérica en el campo. Por ejemplo,
introduzca $#,## para mostrar $3,14.
Orientación
Especifica si organizar grupos de opciones y casillas de verificación horizontal o
verticalmente en el formulario. El valor predeterminado es la orientación vertical.
Tamaño de página
Número de filas que se mostrarán en cada página de una tabla o matriz simple.
Contraseña
Valor booleano (verdadero o falso) para un campo de texto; a menudo se usa con
campos de contraseña. Cuando es verdadero, la entrada del usuario se muestra
mediante caracteres de viñeta para ocultar la entrada de otros usuarios. Cuando es
falso o vacío, la entrada de usuario se muestra exactamente como se ha escrito.
Patrón
Requisito de restricción o validación de la entrada para los valores que un usuario
introduce en un campo de texto o en un área de texto. Por ejemplo, establezca el
patrón en [a-z] para que solamente sea necesario especificar caracteres alfabéticos
en minúscula en el campo asociado.
Mensaje del patrón
La alerta o sugerencia en pantalla que se mostrará cuando una entrada de usuario
no coincida con el patrón definido en la propiedad Patrón.
Capítulo 7: Formularios 301
El Diseñador de formularios
Proceso
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Proceso. Cuando es falso o vacío, los
objetos de automatización del tipo Proceso no se muestran. Las propiedades del
objeto de campos de referencia de objeto filtran tipos específicos de objetos de
automatización cuando el usuario consulta las opciones disponibles.
Observación de procesos
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Observación de procesos. Cuando es
falso o vacío, los objetos de automatización del tipo Observación de procesos no se
muestran. Las propiedades del objeto de campos de referencia de objeto filtran
tipos específicos de objetos de automatización cuando el usuario consulta las
opciones disponibles.
Procesar como HTML
Valor booleano (verdadero o falso) para los campos de texto de varias líneas.
Cuando es verdadero, el formulario interpreta el contenido del campo como código
HTML y el producto muestra el campo tal y como lo haría un explorador Web. Por
ejemplo, el texto que se etiqueta con <H2> aparecerá como un encabezado de
segundo nivel y el texto que se etiqueta con <b> aparecerá en negrita.
302 Guía del diseñador de contenido
El Diseñador de formularios
Necesario
Valor booleano (verdadero o falso) que indica si el elemento de formulario debe
contener un valor o puede permanecer vacío.
Recurso
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Recurso. Cuando es falso o vacío, los
objetos de automatización del tipo Recurso no se muestran. Las propiedades del
objeto de campos de referencia de objeto filtran tipos específicos de objetos de
automatización cuando el usuario consulta las opciones disponibles.
Planificación
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Planificación. Cuando es falso o vacío, los
objetos de automatización del tipo Planificación no se muestran. Las propiedades
del objeto de campos de referencia de objeto filtran tipos específicos de objetos de
automatización cuando el usuario consulta las opciones disponibles.
Formulario de solicitud de inicio
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye objetos de automatización del tipo Formulario de solicitud de inicio. Cuando
es falso o vacío, los objetos de automatización del tipo Formulario de solicitud de
inicio no se muestran. Las propiedades del objeto de campos de referencia de
objeto filtran tipos específicos de objetos de automatización cuando el usuario
consulta las opciones disponibles.
Capítulo 7: Formularios 303
El Diseñador de formularios
Estilo
Una o más sentencias (como en los siguientes ejemplos) que determinan cómo se
mostrarán a los usuarios los atributos de texto en un campo. Formatee las
asignaciones de atributo de estilo en caso mixto.
color:blue;
textAlign:center;
textDecoration:underline;
textTransform:uppercase
textIndent:30px;
fontStyle:italic;
fontFamily:"Courier";
fontSize:14px;
Índice de ficha
Número que controla el orden de las fichas del formulario durante el diseño y la
ejecución. La aplicación no impone la unicidad. Por ejemplo, se pueden utilizar
múltiplos de 5 o 10 cuando establezca el orden de las fichas. Por lo tanto, si se
inserta un nuevo campo en el diseño entre el campo 20 y el 25, se puede asignar su
índice de ficha a 22.
También se puede dejar el valor de Índice de ficha vacío y hacer clic en Mover hacia
arriba o Mover hacia abajo en la barra de herramientas para ajustar el orden de las
fichas. De forma predeterminada, el orden de las fichas del formulario sigue el
diseño de arriba abajo.
Alineación de texto
Especifica cómo se muestra un archivo de imagen en la parte del diseño del
formulario que ocupa. Las imágenes se pueden alinear a la izquierda o derecha,
centradas o justificadas.
Dirección del texto
Especifica cómo deben mostrarse los caracteres en un campo con respecto a los
bordes izquierdo y derecho del campo. Seleccione ltr o deje el campo de propiedad
vacío para mostrar el texto de izquierda a derecha. ltr es el valor predeterminado y
la dirección de texto predeterminada para los conjuntos de código de ISO-8859
Latin I. Seleccione rtl para mostrar el texto de derecha a izquierda.
Punto de contacto
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye tipos de objeto de automatización que se establecen como verdadero. El
usuario puede examinar los puntos de contacto por dominio, entorno y
orquestador. Cuando es falso o está vacío, solo se muestra el punto de contacto
predeterminado y el usuario no puede seleccionar ningún otro punto de contacto.
304 Guía del diseñador de contenido
El Diseñador de formularios
Grupo de punto de contacto
Valor booleano (verdadero o falso) para los campos de referencia de objeto.
Cuando es verdadero, el cuadro de diálogo de búsqueda Explorador de objetos
incluye tipos de objeto de automatización que se establecen como verdadero. El
usuario puede examinar los grupos del punto de contacto por dominio, entorno y
orquestador. Cuando es falso o está vacío, solo se muestra el grupo de punto de
contacto predeterminado y el usuario no puede seleccionar ningún otro grupo de
punto de contacto.
URL
Para los elementos de formulario de imagen, la ruta de la URL a un archivo de
imagen es como en los siguientes ejemplos:
https://www.<nombre_compañía>.com/images/logo1.png
o
http://my.intranet.site/Corporate%20Images/Big2.jpg
Utilice imágenes para mostrar datos, indicar el estado o proporcionar botones en
los que los usuarios puedan hacer clic.
Valor
Datos almacenados de un elemento de formulario. Todos los elementos de un
formulario almacenan sus valores directamente en sus bordes visuales
provisionalmente antes de confirmarlos en la base de datos. El valor se muestra
como una propiedad para dos elementos de formulario específicos:
■
Cada opción de un campo de selección tiene su propia propiedad de valor.
Utilice la propiedad para almacenar una cadena o un número para cada opción.
Por ejemplo, aunque el usuario consulte las opciones fáciles, moderadas y
difíciles, las propiedades Valor de estas opciones podrían ser 0,8, 1,0 y 1,2.
Estos valores se podrían utilizar en cálculos adicionales.
■
Un elemento de formulario HTML muestra una propiedad de valor. Utilice la
propiedad para especificar el texto y código reales para almacenarse en el
campo. Por ejemplo, introduzca los siguientes datos en la propiedad Valor de
un elemento de formulario HTML:
1, 2, 3, <b>4</b>, 5, <i>6</i>, ...
<H2>CA Process Automation</H2>
El usuario del formulario ve los datos procesados siguientes en el mismo
campo:
1, 2, 3, 4, 5, 6,...
CA Process Automation
Ancho
Cantidad de espacio horizontal (en píxeles) que se desea que el elemento de
formulario ocupe. Especifique un valor para esta propiedad en el borde izquierdo
del elemento de formulario.
Capítulo 7: Formularios 305
El Diseñador de formularios
Visualización de las propiedades de formulario en una ventana nueva
Cuando las propiedades de formulario no están completamente visibles en el panel
Propiedades del diseñador de formularios, dichas propiedades se pueden consultar en
una ventana separada.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Abra un formulario.
3.
En el diseñador de formularios:
a.
Arrastre un campo a una página en el diseño.
b. Haga clic en el campo clasificado en la estructura del formulario.
c.
Identifique una propiedad o un evento que pueda almacenar varias líneas de
texto, como Estilo u onMouseOver.
d. Haga clic con el botón secundario del ratón en el valor del evento o de la
propiedad y haga clic en Expandir.
Las propiedades expandidas aparecen en una ventana nueva.
Nota: Cuando se expande un evento, se puede presionar Ctrl+Espacio para ver las
sugerencias de ayuda de finalización del código. Presione Ctrl+Alt para ver una lista de
las funciones.
306 Guía del diseñador de contenido
El Diseñador de formularios
Eventos del elemento de formulario
onBlur
Ocurre cuando un elemento de formulario pierde el centro de atención. Por
ejemplo, un formulario contiene un campo Nombre de usuario. Un usuario centra la
atención en el campo utilizando la tecla tabuladora o haciendo clic en él. El evento
onBlur se produce cuando el usuario realiza una de las dos acciones siguientes:
■
El usuario hace clic en otro objeto o en otra ventana.
■
El usuario pulsa el tabulador para ir al campo siguiente (por ejemplo, el campo
Contraseña).
onChange
Ocurre cuando un elemento de formulario pierde el centro de atención y el nuevo
valor del elemento de formulario es diferente del valor antiguo. Por ejemplo, un
formulario contiene un campo llamado Cantidad con un valor de 10. Después de
que el usuario cambie el valor a 15, el usuario no cambia el centro de atención a
otro campo. El evento onChange se produce únicamente después de que el usuario
realice cualquiera de las siguientes acciones:
■
El usuario hace clic en otro objeto o en otra ventana.
■
El usuario pulsa el tabulador para ir al campo siguiente.
onClick
Se produce cuando el usuario hace clic en un elemento de formulario. Una acción
de clic correcta debe incluir los eventos onMouseDown y onMouseUp en el mismo
objeto. Este requisito evita que se llame a funciones o a otro código
accidentalmente, porque el ratón debe permanecer en el objeto en el que se va a
hacer clic.
onFocus
Ocurre cuando un elemento de formulario recibe la atención. Para establecer la
atención en un campo, el usuario puede usar el tabulador o hacer clic en un
elemento del formulario. También se pueden escribir scripts o código para centrar
la atención en un elemento de formulario.
onKeyDown
Ocurre cuando un usuario pulsa una tecla por primera vez (por ejemplo, cuando un
usuario hace clic en un campo Nombre o utiliza el tabulador para acceder a él). Un
script que está asociado al evento onKeyDown para el campo Nombre alerta a los
usuarios cuando intentan pulsar teclas de número.
onKeyPress
Se produce cuando un usuario pulsa una tecla y la mantiene pulsada. Por ejemplo,
el evento onKeyPress se produce cuando un usuario hace clic en un campo de
selección llamado Nombre (o utiliza el tabulador para acceder a él) y, a
continuación, pulsa alguna tecla que representa una letra del alfabeto. Un script
que está asociado al evento onKeyPress para el campo Nombre muestra los
diversos nombres que coinciden con la tecla alfabética pulsada.
Capítulo 7: Formularios 307
El Diseñador de formularios
onKeyUp
Ocurre cuando un usuario suelta una tecla después de haberla tenido pulsada. Por
ejemplo, el evento onKeyUp ocurre cuando un usuario hace clic en un campo de
control numérico llamado Temperatura o llega hasta él mediante el tabulador. Un
script que está asociado al evento aumenta o disminuye el valor del campo cada vez
que el usuario pulsa y suelta una tecla concreta.
onLoad
Ocurre cuando se abre el formulario por primera vez para que el usuario lo rellene.
onLookup
Ocurre cuando un usuario hace clic en Examinar en un campo de búsqueda para
consultar valores que se han calculado (o "buscado", según indique el script) en
función de otros valores de campo.
onMouseDown
Se produce cuando el usuario pulsa el botón izquierdo del ratón en un elemento de
formulario.
onMouseMove
Se produce cuando un usuario mueve el puntero del ratón dentro de los límites de
un elemento de formulario.
onMouseOut
Se produce cuando un usuario mueve el puntero del ratón fuera de los límites de un
elemento de formulario.
onMouseOver
Ocurre cuando un usuario mueve el puntero del ratón por encima de un elemento
de formulario y, después, deja de mover el ratón.
onMouseUp
Ocurre cuando un usuario suelta el botón izquierdo del ratón después de haberlo
tenido pulsado en un elemento de formulario.
onMouseWheel
Ocurre cuando un usuario que tiene un ratón equipado con rueda la hace girar
hacia adelante o hacia atrás para desplazarse a un elemento de formulario.
onSubmit
Ocurre cuando el usuario envía el formulario. Cualquiera de las acciones siguientes
puede enviar el formulario:
■
El usuario hace clic en el botón Enviar.
■
El usuario pulsa una tecla específica o una combinación de teclas.
■
Cambia el valor de un campo.
■
El usuario llega al final del formulario en el orden de las fichas.
308 Guía del diseñador de contenido
El Diseñador de formularios
onValidate
Ocurre cuando el código asociado verifica el valor de un campo con respecto a las
reglas de negocio antes de que se produzca una de las acciones siguientes:
■
El valor del campo se almacena en el búfer de datos.
■
El valor del campo se escribe en la base de datos.
Por ejemplo, el usuario hace clic en un campo Número de serie (o accede a él
mediante el tabulador). Dicho campo debe empezar con las letras SN y contener 10
dígitos numéricos. Antes de que el usuario pueda ir al campo siguiente con el
tabulador o hacer clic fuera del campo, el evento onValidate y su código asociado
verifican los datos. Se podría informar al usuario si el número de serie no cumple las
reglas de validación para que corrija la entrada.
Se puede utilizar onValidate para validar de forma personalizada lo que se
introduce en un campo. Por ejemplo, para garantizar que una entrada de campo
tiene como mínimo tres caracteres, se puede escribir una función personalizada en
el cuadro de diálogo Script:
validateValue:function(_val) {
if(_val.length < 3) {
return "Escriba más de 3 caracteres en este campo";
} else {
return null;
}
En el Diseñador de formularios, incluya el valor del atributo onValidate para el
campo de texto que se debe validar. Por ejemplo:
ca_fd.js.validateValue(_val)
La función personalizada reemplaza el parámetro obligatorio _val por el valor de
campo correcto cuando se ejecuta el script.
Si el script de validación devuelve un valor nulo, significa que la entrada de campo
ha superado la validación. De lo contrario, la entrada de campo no supera la
validación y el script devuelve un error (por ejemplo, "Escriba más de 3 caracteres
en este campo").
Capítulo 7: Formularios 309
El Diseñador de formularios
Funciones del elemento de formulario
Muchos de los eventos de interfaz de usuario se producen cuando un usuario interactúa
con un formulario. Los eventos como cambiar un valor de campo (onChange) o colocar
el puntero del ratón sobre una tabla (onMouseOver) pueden iniciar las funciones de
JavaScript. Al igual que en el Diseñador de formularios, se pueden utilizar funciones de
elemento de formulario para lograr los siguientes objetivos:
■
Controlar dinámicamente los elementos de formulario basados en eventos.
■
Obtener datos de un campo o tabla.
■
Establecer los datos en un campo o una tabla.
■
Utilice la lógica para ayudar a los usuarios a que puedan desplazarse por opciones
potencialmente complejas. Por ejemplo, se pueden utilizar funciones para
actualizar una lista de ciudades según el país que seleccione un usuario.
■
Ayude a los usuarios a minimizar los errores durante la introducción de datos.
En esta sección se incluyen las funciones de JavaScript predefinidas que se pueden
utilizar en los campos de los formularios de solicitud de inicio y de solicitud de
interacción.
Elementos de formulario
Los elementos de formulario especifican la información en un formulario que se debe
enviar a un sitio Web o servicio. Los elementos pueden ser de distintos tipos: campo de
texto, casilla de verificación, contraseña, botón de opción, botón de envío, etc.
En el Diseñador de formularios están disponibles los siguientes elementos de
formulario.
Funciones generales para todos los elementos de formulario
Estas funciones son aplicables a todos los tipos de elementos.
310 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_disableField(_id, isDisable)
Activa o desactiva un campo especificado. Cuando un campo está activado, los usuarios
pueden proporcionar entradas o editar los valores. Los campos desactivados están
todavía visibles pero no aceptan que el usuario escriba nada.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo que se debe activar o desactivar.
Esta información se puede encontrar en las propiedades del elemento.
Consulte Propiedades del elemento de formulario (en la página 295) para
obtener más información.
isDisable (boolean)
Especifica si el campo debe estar desactivado (verdadero) o activado (falso).
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo desactiva el campo de la lista de comprobación especificada,
incluyendo todos los elementos de la lista de comprobación dentro del mismo.
ca_pam_disableField('Form.ckListField27', true)
Capítulo 7: Formularios 311
El Diseñador de formularios
ca_pam_hideField(_id, isHide)
Muestra u oculta un campo especificado. El usuario no puede ver los campos ocultos. El
orden de las fichas del formulario omite los campos ocultos. Aunque el campo oculto
pueda mantener un valor todavía, éste se elimina del formulario rápidamente.
Parámetros de entrada
_id (string)
Especifica si el identificador único del campo se debe mostrar u ocultar.
hide (booleano)
Especifica si el campo se debe ocultar (verdadero) o mostrar (falso).
Valor de retorno
Ninguno.
Ejemplo
Tenga que un usuario rellena un formulario de aplicación en línea de con
información del lugar de nacimiento. Si las ciudades del campo Ciudad de
nacimiento son solo capitales, el usuario puede seleccionar Otra Ciudad. Al hacer
clic en Otra Ciudad, el atributo Oculto se establece como falso y se hace visible un
campo de texto. El usuario ya puede introducir el nombre de la ciudad.
Este ejemplo oculta el campo especificado.
ca_pam_hideField('Form.Var_0', true)
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario, 02 Show and Hide
Form Element: Show and Hide Form Element.
312 Guía del diseñador de contenido
El Diseñador de formularios
Análisis de XML
ca_pam_showDataInTable(result, _id, tableHeader)
Muestra las filas de datos que se obtienen a partir de la función del campo de búsqueda
en una tabla con una sola columna que tiene el título o el encabezado que se han
especificado.
Esta función solamente muestra el "resultado" que cumple los criterios. El resultado
aquí representa una matriz de filas. El resultado puede estar almacenado en una
variable y transferido a esta función, o directamente reemplazado por la llamada de
función que devuelve el resultado.
Parámetros de entrada
result (object)
Especifica una llamada de función que da lugar a los valores que se muestran
en una tabla.
_id (string)
Especifica el identificador único de la tabla Campo de búsqueda en la que se
debe mostrar el conjunto de resultados.
tableHeader (string)
Especifica una cadena de texto para mostrarla en la parte superior de la tabla
Campo de búsqueda del formulario.
Valor de retorno
No se devuelve ningún valor; esta función solamente muestra la tabla con los
valores incluidos en ella.
Ejemplo
ca_pam_showDataInTable(result,'Form.office','Office');
En este ejemplo se muestra la tabla Oficina con los resultados de una consulta
independiente para obtener los nombres de las oficinas. En la consulta
independiente, la selección Región del usuario determina las oficinas que se
mostrarán.
El evento onLookup para un campo de búsqueda denominado Office (Oficina) llama
a esta función.
Capítulo 7: Formularios 313
El Diseñador de formularios
ca_pam_convertToSimpleArray (objectArray, fieldName)
Crea una matriz simple de cadenas a partir de cualquier matriz de objetos de JavaScript
más compleja.
Parámetros de entrada
objectArray (object)
Especifica una referencia a una matriz de objetos de JavaScript que contienen
diversas propiedades.
fieldName (string)
Define el nombre de la propiedad en objectArray a partir de donde se debe
crear la matriz simple.
Valor de retorno
Se devuelve la matriz que el método crea.
Ejemplo
var location1 = new Object();
location1.buildingCode = 10;
location1.floorCode = 20;
var location2 = new Object();
location2.buildingCode = 100;
location2.floorCode = 200;
var LocationArray = {location1,location2};
var floorCodeArray = ca_pam_convertToSimpleArray (LocationArray,
„floorCode‟);
El resultado de floorCodeArray {20,200}.
314 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_convertToJavaScriptObject(valueObject)
Convierte un tipo de datos de automatización de procesos en un objeto de JavaScript
estándar en función del tipo de datos de entrada. Si se proporciona una cadena como
un valor de entrada, el método devuelve un valor de cadena.
Parámetros de entrada
valueObject
Especifica los tipos de datos de automatización de procesos. Por ejemplo,
Booleano, Fecha y ValueMap.
Valor de retorno
Devuelve un objeto de JavaScript basado en el valor de valueObject. Si ValueMap es
el valor de entrada, devuelve un objeto de JavaScript como una asignación. Si la
matriz Valor es el parámetro de entrada, el método devuelve una matriz de
JavaScript.
Nota: Para el tipo de datos Fecha, se devuelve el valor largo, que es la
representación canónica de la fecha. Para convertirlo en un objeto de fecha, utilice
la sintaxis siguiente:
new Date (ca_pam_convertToJavaScriptObject(valueObject))
Ejemplo
Este ejemplo declara una variable (matriz) y la configura como el objeto de
JavaScript convertido.
var array = ca_pam_convertToJavaScriptObject(valueObject);
Capítulo 7: Formularios 315
El Diseñador de formularios
Casilla de verificación
ca_pam_isSelectedCheckBox(_id)
Determina si una casilla de verificación está seleccionada (verdadero) o desactivada
(falso).
Parámetros de entrada
_id (string)
Especifica el identificador único del campo Casilla de verificación que se va a
evaluar.
Valor de retorno
Value (boolean)
Verdadero si la casilla de verificación está seleccionada, falso en caso contrario.
Ejemplo
ca_pam_isSelectedCheckBox('Form.ckbxInsBuy')
La etiqueta de la casilla de verificación ckbxInsBuy es Adquirir un seguro. El código
de ejemplo devuelve "verdadero" cuando se selecciona la casilla de verificación
Adquirir un seguro. El código devuelve "falso" cuando la casilla de verificación se
desactiva.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario, 02 Show and Hide
Form Element: Show and Hide Form Element.
316 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_selectCheckBox(_id, isSelect)
Selecciona o desactiva una casilla de verificación especificada.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo Casilla de verificación que debe
seleccionarse o desactivarse.
isSelect (boolean)
Especifica si un campo está seleccionado (verdadero) o sin seleccionar (falso).
Valor de retorno
Ninguno.
Ejemplo
ca_pam_selectCheckBox('Form.ckbxInsBuy', true)
Este ejemplo activa la casilla de verificación ckbxInsBuy en el formulario.
■
La etiqueta de la casilla de verificación ckbxInsBuy es Adquirir un seguro.
■
La función ca_pam_selectCheckBox se podría utilizar si el usuario selecciona
otras opciones del formulario que requieren la compra de un seguro.
Fecha
A excepción de lo comentado en esta sección, todas las funciones de fecha devuelven la
fecha como una cadena con el formato especificado en la propiedad Formato de fecha.
ca_pam_getDateFieldMaxValue(_id)
Devuelve el valor de la propiedad Valor máximo del campo de fecha expresado como
una cadena.
Parámetros de entrada
_id (string)
El identificador único de un campo Fecha.
Valor de retorno
El valor máximo para un campo Fecha expresado como una cadena.
Ejemplo
Este ejemplo devuelve el valor máximo permitido para el campo DateDeparture
como una cadena de fecha (por ejemplo, 20/05/2025).
ca_pam_getDateFieldMaxValue('Form.DateDeparture')
Capítulo 7: Formularios 317
El Diseñador de formularios
ca_pam_getDateFieldMaxValueInMillis(_id)
Devuelve el valor de la propiedad Valor máximo del campo de fecha expresado como un
entero largo. Este número entero representa el número de milisegundos antes o
después del 1 de enero de 1970 00:00:00 UTC (denominado Unix Epoch). El valor de
este campo se puede transferir, tal y como se indica en el método
ca_pam_getDateFieldMaxValue(_id) (en la página 317).
Parámetros de entrada
_id (string)
Define el identificador único del campo Fecha.
Valor de retorno
El valor máximo para un campo Fecha, expresado como un entero largo.
Ejemplo
ca_pam_getDateFieldMaxValueInMillis('Form.DateDeparture')
Este ejemplo devuelve el valor máximo permitido para el campo DateDeparture
como una cadena numérica medida en milisegundos. Para el campo Fecha con un
valor máximo de 25/05/25, esta función devolvería 1748188800000 (es decir,
1 748 188 800 000 o 1,7 billones de milisegundos).
La función ca_pam_getDateFieldMaxValueInMillis devuelve un resultado negativo
para las fechas anteriores a 1970.
ca_pam_getDateFieldMinValue(_id)
Devuelve el valor de la propiedad Valor mínimo del campo de fecha expresado como
una cadena. El valor de este campo se puede transferir, tal y como se indica en el
método ca_pam_getDateFieldMaxValue(_id) (en la página 317).
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Fecha.
Valor de retorno
El valor mínimo para un campo Fecha expresado como una cadena.
Ejemplo
Este ejemplo devuelve el valor mínimo permitido para el campo DateDeparture
como una cadena de fecha (por ejemplo, 05/05/2025).
ca_pam_getDateFieldMinValue('Form.DateDeparture')
318 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_getDateFieldMinValueInMillis(_id)
Devuelve el valor de la propiedad Valor mínimo del campo de fecha expresado como un
entero largo. Este número entero representa el número de milisegundos antes o
después del 1 de enero de 1970 00:00:00 UTC (denominado Unix Epoch). El valor de
este campo se puede transferir, tal y como se indica en el método
ca_pam_getDateFieldMaxValue(_id) (en la página 317).
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Fecha.
Valor de retorno
El valor mínimo para un campo Fecha, expresado como un entero largo.
Ejemplo
ca_pam_getDateFieldMinValueInMillis('Form.DateofBirth')
Este ejemplo devuelve el valor mínimo permitido para el campo DateofBirth como
una cadena numérica medida en milisegundos. Para el campo Fecha con un valor
mínimo de 1/01/74, esta función devolvería 126291600000 (es decir,
126 291 600 000 o 126000 millones de milisegundos).
Esta función devuelve un resultado negativo para las fechas anteriores a 1970.
ca_pam_getDateFieldValue(_id)
Devuelve el valor de un campo Fecha expresado como una cadena de fecha (por
ejemplo, 05/05/2025).
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Fecha.
Valor de retorno
Valor de fecha expresado como una cadena.
Ejemplo
var LastDay =ca_pam_getDateFieldValue('Form.TripEndDate');
ca_pam_setDateFieldMaxValue('Form.DateDeparture',LastDay);
La primera línea de este ejemplo obtiene TripEndDate, por ejemplo, 15/05/2014, y
lo almacena en la variable LastDay.
La segunda línea de este ejemplo establece el valor máximo del campo
DateDeparture en el valor de la variable LastDay.
Capítulo 7: Formularios 319
El Diseñador de formularios
ca_pam_getDateFieldValueInMillis(_id)
Devuelve el valor de un campo Fecha expresado como un número entero largo (por
ejemplo, 61238000). Este número entero representa el número de milisegundos antes o
después del 1 de enero de 1970 00:00:00 UTC (denominado Unix Epoch).
Parámetros de entrada
_id (string)
Define el identificador único del campo Fecha.
Valor de retorno
Valor de fecha para un campo Fecha expresado como un entero largo.
Ejemplo
ca_pam_getDateFieldValueInMillis('Form.DateofBirth')
Este ejemplo devuelve el valor del campo DateofBirth como una cadena numérica
medida en milisegundos. Para un campo de fecha con un valor de 22/08/1965, esta
función devolvería -132307200000 (es decir, -132 307 200 000 o -132 000 millones
de milisegundos).
La función ca_pam_getDateFieldValueInMillis devuelve un resultado positivo para
las fechas 1 de enero de 1970 o posteriores.
ca_pam_setDateFieldMaxValue(_id, val)
Establece el valor de la propiedad Valor máximo del campo de fecha. Los usuarios del
formulario no pueden introducir una fecha en el campo de fecha posterior al valor
máximo.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Fecha.
val
Especifica el valor máximo que se puede utilizar, expresado como una cadena
de fecha (por ejemplo, 20/05/2014).
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo establece la propiedad del valor máximo del campo DateDeparture
como la fecha almacenada en la variable LastDay.
ca_pam_setDateFieldMaxValue('Form.DateDeparture',LastDay);
320 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_setDateFieldMinValue(_id, val)
Establece el valor de la propiedad Valor mínimo del campo de fecha. Los usuarios del
formulario no pueden introducir una fecha en el campo de fecha anterior al valor
mínimo.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Fecha.
val
Especifica el valor mínimo que se puede utilizar expresado como una cadena de
fecha (por ejemplo, 05/05/2012).
Valor de retorno
Ninguno.
Ejemplo
ca_pam_setDateFieldMinValue('Form.DateArrival',today);
Este ejemplo establece la propiedad del valor mínimo del campo DateArrival como
la fecha almacenada en la variable today.
■
El producto alerta a los usuarios del formulario si se introduce una fecha
anterior a la del valor mínimo.
■
Los calendarios emergentes del formulario muestran fechas inválidas en gris y
no permiten que los usuarios seleccionen fechas no válidas.
Capítulo 7: Formularios 321
El Diseñador de formularios
ca_pam_setDateFieldValue(_id, val)
Establece el valor de un campo de fecha en un una cadena de fecha (por ejemplo,
15/05/2014). El valor se establece solamente si se especifica en el formato correcto (es
decir, en el formato especificado en la propiedad Formato de fecha del campo Fecha). Si
el valor de esta propiedad está vacío, el valor se establece en el Formato de fecha
especificado en la Configuración del usuario.
Nota: Transfiera la fecha en el formato correcto; de lo contrario, no se definirá.
Parámetros de entrada
_id
Define el identificador único del campo Fecha.
val
Define un valor de fecha que se especifica (por ejemplo, 5/05/2014).
Valor de retorno
Ninguno.
Ejemplo
ca_pam_setDateFieldValue('Form.DateArrival','05/05/2014');
Este ejemplo establece el campo DateArrival como 05/05/2014.
322 Guía del diseñador de contenido
El Diseñador de formularios
Campo de búsqueda
ca_pam_getTextFieldValue(_id)
Devuelve un valor procedente de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo de texto.
Valor de retorno
Valor procedente del campo de texto (cadena).
Ejemplo
Este ejemplo devuelve el valor del campo de texto top_vendors.
ca_pam_getTextFieldValue('Form.top_vendors')
Este ejemplo devuelve el valor del campo de texto top_vendors y establece el
campo de texto dynamic_field según el valor devuelto.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 323
El Diseñador de formularios
ca_pam_setTextFieldValue(_id, val)
Define el valor de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo para el que debe definirse un valor
específico.
val (string)
Define el nuevo valor para el campo de texto.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo configura el campo de texto top_vendors con la cadena siguiente: I
vote for vendor 3 because (Voto por el distribuidor 3 porque):
ca_pam_setTextFieldValue('Form.top_vendors', 'I vote for vendor 3
because: ')
Para continuar con este ejemplo, después de que los usuarios introduzcan sus
motivos, utilice ca_pam_getTextFieldValue('Form.top_vendors') para enviar las
declaraciones completas.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
Este ejemplo devuelve el valor del campo top_vendors y configura dynamic_field
con ese valor.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Diríjase a la carpeta Formularios de interacción del usuario y, a continuación,
acceda a 08 Populate Table SOAP WS: Populate Table SOAP WS.
324 Guía del diseñador de contenido
El Diseñador de formularios
Botones de opción
ca_pam_isSelectRadio (_id, radio_id)
Determina si un botón de selección específico está seleccionado.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Botones de opción.
radio_id (string)
Determina el identificador único de un botón de selección específico de un
grupo.
Valor de retorno
Value (boolean)
Verdadero si el botón de opción está seleccionado, falso en caso contrario.
Ejemplo
ca_pam_isSelectRadio('Form.Transportation',
'Form.Transportation.Option_01_Air')
Transportation (Transporte) es un grupo con dos botones de selección con los
siguientes ID:
■
Option_01_Air
■
Option_02_Rail
Este ejemplo devuelve "verdadero" si el botón de selección de Air (Aire) del grupo
Transportation (Transporte) está seleccionado o "falso" en caso contrario.
Capítulo 7: Formularios 325
El Diseñador de formularios
ca_pam_selectRadio(_id, radio_id)
Permite elegir un botón de selección específico en un campo Botones de opción.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Botones de opción.
radio_id (string)
Especifica el identificador único de un botón de selección en Botones de
opción.
Valor de retorno
Ninguno.
Ejemplo
ca_pam_selectRadio('Form.Transportation',
'Form.Transportation.Option_01_Air')
Este ejemplo selecciona el botón de opción Air (Aire) en los botones de opción de
Transportation (Transporte).
Transportation (Transporte) son botones de opción con dos botones de selección
con los siguientes ID:
■
Option_01_Air
■
Option_02_Rail
326 Guía del diseñador de contenido
El Diseñador de formularios
Seleccionar
ca_pam_getSelectedOptions(_id)
Devuelve el valor de índice de la opción seleccionada actualmente en un campo
Seleccionar.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo Seleccionar para el que se debe
recuperar el valor de opción.
Valor de retorno
Esta función devuelve una matriz de índice de opciones seleccionadas.
En el caso de una única lista desplegable Seleccionar, el índice de opciones
seleccionado se puede recuperar accediendo al primer elemento de la matriz.
Ejemplo
ca_pam_getSelectedOptions('Form.VarFillerType')
Este ejemplo recupera el valor de índice del tipo de relleno que elija el usuario.
■
Filler Type (Tipo de relleno) es un campo de selección con las opciones Rocks
(Piedras) [0], Sand (Arena) [1] y Water (Agua) [2].
■
La función ca_pam_getSelectedOptions devuelve el valor de índice 1 cuando el
usuario selecciona Sand (Arena) de la lista desplegable Filler Type (Tipo de
relleno).
Capítulo 7: Formularios 327
El Diseñador de formularios
ca_pam_getSelectedOptionValues(_id)
Devuelve el valor de la opción seleccionada actualmente en un campo Seleccionar.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo para el cual debe recuperarse el
valor de opción.
Valor de retorno
Esta función devuelve una matriz de valores de opción seleccionados.
En el caso de una única lista desplegable Seleccionar, el valor de opción
seleccionado se puede recuperar accediendo al primer elemento de la matriz.
Ejemplo
alert(ca_pam_getSelectedOptionValues('Form.VarFillerType')[0])
En este ejemplo se devuelve el número del valor de opción o la cadena de texto
para el tipo de relleno que eligió el usuario.
■
El comando de alerta muestra el resultado del valor de opción al usuario en un
cuadro de diálogo o un mensaje emergente.
■
Filler Type (Tipo de relleno) es un campo de selección con las opciones (los
valores de índice se muestran entre corchetes) y los valores siguientes:
Rocks [0], $50
Sand [1], $100
Water [2], Call for details.
■
La función ca_pam_getSelectedOptionValues devuelve el valor de la opción
que se selecciona de la lista desplegable Filler Type (Tipo de relleno) cuando el
usuario hace clic en Update Order Form (Actualizar formulario de pedido).
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario, 06 Populate
Dropdown DB: Populate Dropdown from DB.
328 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_selectOption(_id, name, value, isSelect)
Selecciona o desactiva una opción en un campo Seleccionar basado en el valor y el
nombre de la opción. También se puede utilizar esta función para evitar la selección de
una opción específica.
Esta función permite seleccionar y deseleccionar una opción. Si una opción no está
seleccionada y desea seleccionarla mediante programación, el valor de isSelect debe ser
verdadero. Si una opción ya está seleccionada y desea deseleccionarla, use el valor falso
para isSelect.
Parámetros de entrada
_id (string)
Especifica que se debe configurar el identificador único del campo Seleccionar.
name (string)
Determina el nombre de la opción del campo Seleccionar específico.
value (string)
Determina el valor de la opción del campo Seleccionar específico. Este valor es
el valor existente de la opción.
isSelect (boolean)
Especifica si el campo está seleccionado (verdadero) o no seleccionado (falso).
Valor de retorno
Ninguno.
Ejemplo
ca_pam_selectOption('Form.City', 'Regional Hub', 'Sydney', true);
Este ejemplo configura el campo City (Ciudad) con la opción llamada Regional Hub
(Centro regional).
Si hay más de una opción llamada Regional Hub (Centro regional), esta función
aplica la opción con el valor especificado. Esta distinción es importante. Se puede
utilizar ca_pam_getSelectedOptionValues(_id) para identificar el valor específico de
una opción de campo, incluso cuando varias opciones tienen el mismo nombre. Por
ejemplo, los usuarios pueden continuar utilizando un conjunto de formularios
estándares en el negocio directo del Regional Hub (Centro regional) aunque el valor
cambie.
Capítulo 7: Formularios 329
El Diseñador de formularios
ca_pam_selectOptionByIndex(_id, index, isSelect)
Selecciona o deselecciona una opción en un campo Seleccionar basado en el índice.
Parámetros de entrada
_id (string)
Define el identificador único del campo Seleccionar que debe seleccionarse o
desactivarse.
index (integer)
Especifica el identificador fijo de una opción del campo.
isSelect (boolean)
Especifica si la opción del campo Seleccionar está seleccionada (verdadero) o
sin seleccionar (falso).
Valor de retorno
Ninguno.
Ejemplos
ca_pam_selectOptionByIndex('Form.VarFillerType', 2, true)
Este ejemplo establece la opción actual de Filler Type (Tipo de relleno) como el
valor en la posición de índice 2.
■
Filler Type (Tipo de relleno) es un campo de selección con las opciones Rocks
(Piedras) [0], Sand (Arena) [1] y Water (Agua) [2].
■
Economy Option (Opción de economía) es una casilla de verificación con esta
función en su evento onClick.
■
Cuando el usuario selecciona la casilla de verificación Economy Option (Opción
de economía), la función ca_pam_selectOptionByIndex establece el campo
Filler Type (Tipo de relleno) como la opción en la posición de índice 2, Water
(Agua).
Otro ejemplo:
ca_pam_selectOptionByIndex('Form.VarFillerType', 2, false)
Cuando Filler Type (Tipo de relleno) ya está configurado como Water (Agua), esta
función borra el contenido del campo Filler Type (Tipo de relleno).
330 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_addValuesInSelectStore(_id, values)
Agrega nuevas opciones al campo Seleccionar con un conjunto sencillo de valores que
se define en el código.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo Seleccionar.
values (objeto de JavaScript)
Especifica una matriz de objetos donde cada objeto tiene dos propiedades
("nombre" y "valor") que son necesarias para representar las opciones del
campo Seleccionar. La propiedad "name" de cada objeto se representa como la
clave para la opción agregada y la propiedad "value" sería el valor. Si tiene una
matriz de nombres y valores, también podría utilizar la función
ca_pam_createSelectStore para crear el objeto "values" (tal y como se muestra
en el ejemplo).
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo utiliza la selección del usuario de Oeste o Norte en un campo
independiente denominado Región para actualizar los iconos disponibles en el
campo City (Ciudad) de manera dinámica.
if('West'==regionChoice)
var cityOptionNames =["New York","Rio De Janeiro","Mexico City"]
var cityOptionValues =["West_01","West_02","West_03"];
if('North'==regionChoice)
var cityOptionNames =["Madrid","Moscow","Copenhagen"]
var cityOptionValues =["North_04","North_05","North_06"];
ca_pam_addValuesInSelectStore('Form1.City',
ca_pam_createSelectStore(cityOptionNames ,cityOptionValues ))
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario. La función se puede
encontrar en los formularios siguientes:
■
04 Populate Dropdown Dataset: Populate Dropdown Dataset.
■
06 Populate Dropdown DB: Populate Dropdown from DB.
Capítulo 7: Formularios 331
El Diseñador de formularios
ca_pam_clearSelectStore(_id)
Borra todas las opciones del campo Seleccionar.
Parámetros de entrada
_id (string)
Especifica que se debe borrar el identificador único del campo Seleccionar.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo borra todas las opciones existentes del campo City (Ciudad) en el
formulario 1. Esto se puede utilizar para reinicializar el campo de selección y
rellenarlo con opciones nuevas mediante la propiedad
ca_pam_addValuesInSelectStore().
ca_pam_clearSelectStore(Form1.City)
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario, 06 Populate
Dropdown DB: Populate Dropdown from DB.
332 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_createSelectStore(nameArray, valueArray)
Se utiliza para crear un conjunto de opciones para un campo Seleccionar.
Parámetros de entrada
nameArray (array)
Define una matriz de nombres de opciones que se muestran al usuario.
valueArray (array)
Opcionalmente define una matriz de valores de opción que corresponde a cada
elemento de nameArray. Si se omite, se utiliza nameArray para definir tanto los
nombres como los valores.
Valor de retorno
Objeto de JavaScript que representa opciones de almacén y sus valores.
Ejemplo
Este ejemplo define las opciones disponibles para el campo City (Ciudad) en los
nombres especificados y los valores asociados.
var cityOptionNames = ["Los Angeles", "New York", "New Carolina"];
var cityOptionValues = ["LA","NY","NC"];
var newStore = ca_pam_createSelectStore(cityOptionNames
,cityOptionValues )
Ahora la variable newStore se puede transferir a un elemento Seleccionar
formulario mediante el método siguiente:
ca_pam_addValuesInSelectStore(„Form.City‟,newStore);
Capítulo 7: Formularios 333
El Diseñador de formularios
ca_pam_createSelectStoreFromSQLResult(resultFromSQLQuery, nameColumnID,
valueColumnID)
Crea un conjunto de opciones para el campo Seleccionar directamente a partir del
resultado de una consulta SQL.
Parámetros de entrada
resultFromSQLQuery (object)
Define los datos recuperados mediante una sentencia SQL.
nameColumnID (array)
Define el nombre de la columna en el resultado SQL que se utiliza como
nombres en el campo Seleccionar.
valueColumnID (array)
Opcionalmente, define el nombre de la columna en el resultado SQL que se
utiliza como valores en el campo Seleccionar. Si se omite, la columna definida
mediante nameColumnID se utiliza tanto para nombres como para valores.
Valor de retorno
Se devuelve la matriz que la función construye.
Ejemplo
Este ejemplo utiliza el resultado de una consulta de una fuente de datos externa
para establecer las opciones del campo City (Ciudad). La consulta se ejecuta cuando
el usuario selecciona una opción del campo Región.
ca_pam_addValuesInSelectStore('Form1.City',ca_pam_createSelectS
toreFromSQLResult(result,'txtRegion'));
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario, 06 Populate
Dropdown DB: Populate Dropdown from DB.
334 Guía del diseñador de contenido
El Diseñador de formularios
Campo de texto
ca_pam_getTextFieldValue(_id)
Devuelve un valor procedente de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo de texto.
Valor de retorno
Valor procedente del campo de texto (cadena).
Ejemplo
Este ejemplo devuelve el valor del campo de texto top_vendors.
ca_pam_getTextFieldValue('Form.top_vendors')
Este ejemplo devuelve el valor del campo de texto top_vendors y establece el
campo de texto dynamic_field según el valor devuelto.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 335
El Diseñador de formularios
ca_pam_setTextFieldValue(_id, val)
Define el valor de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo para el que debe definirse un valor
específico.
val (string)
Define el nuevo valor para el campo de texto.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo configura el campo de texto top_vendors con la cadena siguiente: I
vote for vendor 3 because (Voto por el distribuidor 3 porque):
ca_pam_setTextFieldValue('Form.top_vendors', 'I vote for vendor 3
because: ')
Para continuar con este ejemplo, después de que los usuarios introduzcan sus
motivos, utilice ca_pam_getTextFieldValue('Form.top_vendors') para enviar las
declaraciones completas.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
Este ejemplo devuelve el valor del campo top_vendors y configura dynamic_field
con ese valor.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Diríjase a la carpeta Formularios de interacción del usuario y, a continuación,
acceda a 08 Populate Table SOAP WS: Populate Table SOAP WS.
336 Guía del diseñador de contenido
El Diseñador de formularios
Área de texto
ca_pam_getTextFieldValue(_id)
Devuelve un valor procedente de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo de texto.
Valor de retorno
Valor procedente del campo de texto (cadena).
Ejemplo
Este ejemplo devuelve el valor del campo de texto top_vendors.
ca_pam_getTextFieldValue('Form.top_vendors')
Este ejemplo devuelve el valor del campo de texto top_vendors y establece el
campo de texto dynamic_field según el valor devuelto.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 337
El Diseñador de formularios
ca_pam_setTextFieldValue(_id, val)
Define el valor de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo para el que debe definirse un valor
específico.
val (string)
Define el nuevo valor para el campo de texto.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo configura el campo de texto top_vendors con la cadena siguiente: I
vote for vendor 3 because (Voto por el distribuidor 3 porque):
ca_pam_setTextFieldValue('Form.top_vendors', 'I vote for vendor 3
because: ')
Para continuar con este ejemplo, después de que los usuarios introduzcan sus
motivos, utilice ca_pam_getTextFieldValue('Form.top_vendors') para enviar las
declaraciones completas.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
Este ejemplo devuelve el valor del campo top_vendors y configura dynamic_field
con ese valor.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Diríjase a la carpeta Formularios de interacción del usuario y, a continuación,
acceda a 08 Populate Table SOAP WS: Populate Table SOAP WS.
338 Guía del diseñador de contenido
El Diseñador de formularios
Texto de varias líneas
ca_pam_getTextFieldValue(_id)
Devuelve un valor procedente de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo de texto.
Valor de retorno
Valor procedente del campo de texto (cadena).
Ejemplo
Este ejemplo devuelve el valor del campo de texto top_vendors.
ca_pam_getTextFieldValue('Form.top_vendors')
Este ejemplo devuelve el valor del campo de texto top_vendors y establece el
campo de texto dynamic_field según el valor devuelto.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 339
El Diseñador de formularios
ca_pam_setTextFieldValue(_id, val)
Define el valor de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo para el que debe definirse un valor
específico.
val (string)
Define el nuevo valor para el campo de texto.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo configura el campo de texto top_vendors con la cadena siguiente: I
vote for vendor 3 because (Voto por el distribuidor 3 porque):
ca_pam_setTextFieldValue('Form.top_vendors', 'I vote for vendor 3
because: ')
Para continuar con este ejemplo, después de que los usuarios introduzcan sus
motivos, utilice ca_pam_getTextFieldValue('Form.top_vendors') para enviar las
declaraciones completas.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
Este ejemplo devuelve el valor del campo top_vendors y configura dynamic_field
con ese valor.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Diríjase a la carpeta Formularios de interacción del usuario y, a continuación,
acceda a 08 Populate Table SOAP WS: Populate Table SOAP WS.
340 Guía del diseñador de contenido
El Diseñador de formularios
Tabla
ca_pam_clearTableData(_id, startIndex, endIndex)
Suprime una o más filas de datos de una tabla.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
startIndex (integer)
Especifica el índice numérico de la primera fila de datos de la tabla que debe
suprimirse.
endIndex (integer)
Especifica el índice numérico de la última fila de datos de la tabla que debe
suprimirse.
Valor de retorno
Ninguno.
Ejemplo
ca_pam_clearTableData('Form.employeeList',0,ca_pam_getTableRowC
ount('Form.employeeList')-1);
Este ejemplo suprime todas las filas de la tabla employeeList.
■
El intervalo para suprimir empieza con la fila 0 y termina con la última.
■
Para calcular la última fila, la función a_pam_clearTableData obtiene el número
de filas actuales de la tabla a partir de la función ca_pam_getTableRowCount y
resta 1.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario y, a continuación:
–
07 Populate Table RESTful WS: Populate Table RESTful WS.
–
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 341
El Diseñador de formularios
ca_pam_getTableData(_id, startIndex, endIndex)
Devuelve los datos de la tabla desde el índice de inicio hasta el índice de finalización, tal
y como se indica en el nombre del método. Esta función devuelve una matriz de objetos
de JavaScript donde cada elemento de la matriz representa una fila en la tabla. Para
recuperar el valor de una columna concreta, se puede acceder al valor mediante la
propiedad Nombre de la columna desde el objeto de JavaScript correspondiente a la
fila.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
startIndex (integer)
Especifica el índice numérico de la primera fila de la tabla desde la que se
devolverán los datos.
endIndex (integer)
Especifica el índice numérico de la última fila de la tabla desde la que se
devolverán los datos. Si se especifica un índice mayor que la última fila
disponible, la función producirá un fallo.
Valor de retorno
Devuelve una matriz que está representada como un objeto de JavaScript.
Importante: Después de que el método devuelva los datos de la tabla, los nombres
las variables que se utilizan para acceder a las columnas deben estar en minúscula,
con independencia de cómo se defina la propiedad Nombre para cada campo de
columna en el Diseñador de formularios.
Ejemplo
ca_fd.js.PassData(ca_pam_getTableData('Form.tableRaceResults',0
,4))
En este ejemplo se utiliza el siguiente script de formulario para transferir los cinco
mejores tiempos de finalización en una carrera de un elemento de formulario de
tabla a una base de datos personalizada. El evento onClick de la casilla de
verificación Record Race Times (Mejores tiempos de la carrera) inicia llamadas de
función para obtener los datos de la tabla, transferir los datos y registrar los
resultados.
{
PassData : function(result) {
for(i=0;i<result.length;i++)
{
var firstRow = result[i];
alert(firstRow.var_0);
}
}
}
342 Guía del diseñador de contenido
El Diseñador de formularios
La ilustración siguiente muestra el formulario tal y como aparece en el momento
del diseño.
ca_pam_getTableRowCount(_id)
Devuelve el número total de filas de datos de una tabla.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
Valor de retorno
Devuelve un número de filas como un entero.
Ejemplo
ca_pam_getTableRowCount('Form.employeeList')
Este ejemplo devuelve el número de filas del elemento de formulario de tabla de la
lista de empleados.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 343
El Diseñador de formularios
ca_pam_setTableData(_id, values)
Establece los datos en una tabla.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
values (object)
Especifica los datos que se deben mostrar en las filas y las columnas de la tabla.
Este parámetro solamente acepta el resultado de una consulta SQL.
Valor de retorno
Ninguno.
Ejemplo
ca_pam_setTableData('Form.employeeList',result);
Este ejemplo configura la tabla employeeList con los valores que devuelve la
variable de resultado.
344 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_setTableDataFromJSObject(_id, values)
Rellena una tabla con la matriz de objetos de JavaScript.
Parámetros de entrada
_id (string)
Especifica el ID de la tabla.
values (object)
Especifica la matriz de JavaScript que contiene una lista de objetos. Las
propiedades de los objetos deben ser iguales que el nombre de la columna
para rellenar los datos.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo muestra cómo rellenar una tabla a partir de una matriz de objetos de
JavaScript. El ID de la tabla es Form.name y tiene dos columnas como firstName y
lastName.
var tableData = new Array();
var data1 = new Object();
data1.firstName = "firstName1";
data1.lastName = "lastName1";
tableData[0] = data1;
var data2 = new Object();
data2.firstName = "firstName2";
data2.lastName = "lastName2";
tableData[1] = data2;
ca_pam_setTableDataFromJSObject('Form.names',tableData );
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 345
El Diseñador de formularios
Matriz simple
ca_pam_clearTableData(_id, startIndex, endIndex)
Suprime una o más filas de datos de una tabla.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
startIndex (integer)
Especifica el índice numérico de la primera fila de datos de la tabla que debe
suprimirse.
endIndex (integer)
Especifica el índice numérico de la última fila de datos de la tabla que debe
suprimirse.
Valor de retorno
Ninguno.
Ejemplo
ca_pam_clearTableData('Form.employeeList',0,ca_pam_getTableRowC
ount('Form.employeeList')-1);
Este ejemplo suprime todas las filas de la tabla employeeList.
■
El intervalo para suprimir empieza con la fila 0 y termina con la última.
■
Para calcular la última fila, la función a_pam_clearTableData obtiene el número
de filas actuales de la tabla a partir de la función ca_pam_getTableRowCount y
resta 1.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario y, a continuación:
–
07 Populate Table RESTful WS: Populate Table RESTful WS.
–
08 Populate Table SOAP WS: Populate Table SOAP WS.
346 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_getTableData(_id, startIndex, endIndex)
Devuelve los datos de la tabla desde el índice de inicio hasta el índice de finalización, tal
y como se indica en el nombre del método. Esta función devuelve una matriz de objetos
de JavaScript donde cada elemento de la matriz representa una fila en la tabla. Para
recuperar el valor de una columna concreta, se puede acceder al valor mediante la
propiedad Nombre de la columna desde el objeto de JavaScript correspondiente a la
fila.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
startIndex (integer)
Especifica el índice numérico de la primera fila de la tabla desde la que se
devolverán los datos.
endIndex (integer)
Especifica el índice numérico de la última fila de la tabla desde la que se
devolverán los datos. Si se especifica un índice mayor que la última fila
disponible, la función producirá un fallo.
Valor de retorno
Devuelve una matriz que está representada como un objeto de JavaScript.
Importante: Después de que el método devuelva los datos de la tabla, los nombres
las variables que se utilizan para acceder a las columnas deben estar en minúscula,
con independencia de cómo se defina la propiedad Nombre para cada campo de
columna en el Diseñador de formularios.
Ejemplo
ca_fd.js.PassData(ca_pam_getTableData('Form.tableRaceResults',0
,4))
En este ejemplo se utiliza el siguiente script de formulario para transferir los cinco
mejores tiempos de finalización en una carrera de un elemento de formulario de
tabla a una base de datos personalizada. El evento onClick de la casilla de
verificación Record Race Times (Mejores tiempos de la carrera) inicia llamadas de
función para obtener los datos de la tabla, transferir los datos y registrar los
resultados.
{
PassData : function(result) {
for(i=0;i<result.length;i++)
{
var firstRow = result[i];
alert(firstRow.var_0);
}
}
}
Capítulo 7: Formularios 347
El Diseñador de formularios
La ilustración siguiente muestra el formulario tal y como aparece en el momento
del diseño.
ca_pam_getTableRowCount(_id)
Devuelve el número total de filas de datos de una tabla.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
Valor de retorno
Devuelve un número de filas como un entero.
Ejemplo
ca_pam_getTableRowCount('Form.employeeList')
Este ejemplo devuelve el número de filas del elemento de formulario de tabla de la
lista de empleados.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
348 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_setTableData(_id, values)
Establece los datos en una tabla.
Parámetros de entrada
_id (string)
Especifica el identificador único de un elemento de formulario de tabla.
values (object)
Especifica los datos que se deben mostrar en las filas y las columnas de la tabla.
Este parámetro solamente acepta el resultado de una consulta SQL.
Valor de retorno
Ninguno.
Ejemplo
ca_pam_setTableData('Form.employeeList',result);
Este ejemplo configura la tabla employeeList con los valores que devuelve la
variable de resultado.
Capítulo 7: Formularios 349
El Diseñador de formularios
ca_pam_setTableDataFromJSObject(_id, values)
Rellena una tabla con la matriz de objetos de JavaScript.
Parámetros de entrada
_id (string)
Especifica el ID de la tabla.
values (object)
Especifica la matriz de JavaScript que contiene una lista de objetos. Las
propiedades de los objetos deben ser iguales que el nombre de la columna
para rellenar los datos.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo muestra cómo rellenar una tabla a partir de una matriz de objetos de
JavaScript. El ID de la tabla es Form.name y tiene dos columnas como firstName y
lastName.
var tableData = new Array();
var data1 = new Object();
data1.firstName = "firstName1";
data1.lastName = "lastName1";
tableData[0] = data1;
var data2 = new Object();
data2.firstName = "firstName2";
data2.lastName = "lastName2";
tableData[1] = data2;
ca_pam_setTableDataFromJSObject('Form.names',tableData );
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
350 Guía del diseñador de contenido
El Diseñador de formularios
Referencia de objeto
ca_pam_getTextFieldValue(_id)
Devuelve un valor procedente de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único de un campo de texto.
Valor de retorno
Valor procedente del campo de texto (cadena).
Ejemplo
Este ejemplo devuelve el valor del campo de texto top_vendors.
ca_pam_getTextFieldValue('Form.top_vendors')
Este ejemplo devuelve el valor del campo de texto top_vendors y establece el
campo de texto dynamic_field según el valor devuelto.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a las carpetas Formularios de interacción del usuario y, a continuación:
■
07 Populate Table RESTful WS: Populate Table RESTful WS.
■
08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 351
El Diseñador de formularios
ca_pam_setTextFieldValue(_id, val)
Define el valor de un campo de texto.
Parámetros de entrada
_id (string)
Especifica el identificador único del campo para el que debe definirse un valor
específico.
val (string)
Define el nuevo valor para el campo de texto.
Valor de retorno
Ninguno.
Ejemplo
Este ejemplo configura el campo de texto top_vendors con la cadena siguiente: I
vote for vendor 3 because (Voto por el distribuidor 3 porque):
ca_pam_setTextFieldValue('Form.top_vendors', 'I vote for vendor 3
because: ')
Para continuar con este ejemplo, después de que los usuarios introduzcan sus
motivos, utilice ca_pam_getTextFieldValue('Form.top_vendors') para enviar las
declaraciones completas.
ca_pam_setTextFieldValue('Form.dynamic_field',
ca_pam_getTextFieldValue('Form.top_vendors'))
Este ejemplo devuelve el valor del campo top_vendors y configura dynamic_field
con ese valor.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Diríjase a la carpeta Formularios de interacción del usuario y, a continuación,
acceda a 08 Populate Table SOAP WS: Populate Table SOAP WS.
Fuentes de datos
ca_pam_getDatasetData(dataSetExpression,callBack)
Recupera el valor de una variable a partir de un conjunto de datos de CA Process
Automation.
Nota: En las versiones de CA Process Automation anteriores a la 04.1.00, este método
se llamaba ca_pam_getDataFromDatasetQuery.
352 Guía del diseñador de contenido
El Diseñador de formularios
Parámetros de entrada
datasetExpression (string)
Define una cadena, expresión o llamada de función que da lugar a una ruta
absoluta en un conjunto de datos. Este parámetro incluye la palabra clave de
conjuntos de datos, la ruta de biblioteca de un objeto de conjunto de datos y el
nombre de la variable de matriz ValueMap.
Datasets["/BR412-DATA-FOLDER-20111214/Folder_FORMS_20120328
/dataset_forms_demo/My_Dataset55"].MyVal
callBack (object)
Define una referencia al objeto de función para llamar después de haber
recuperado los datos, incluidos los métodos de onSuccess y onFailure.
Valor de retorno
Cuando la función recupera los datos, se ejecutan las funciones onSuccess(result) u
onFailure(caught) callBack. La función por sí misma no devuelve ningún valor.
Ejemplo
ca_pam_getDatasetData(ca_pam_getTextFieldValue('Form.TxtFieldWi
thDatasetPath'),callBack)
El código de ejemplo contiene la siguiente información:
■
El campo de texto TxtFieldWithDatasetPath almacena la expresión del conjunto
de datos.
■
La función getTextFieldValue obtiene el valor de la expresión de conjunto de
datos.
■
La función getDataUsingDatasetExpression recupera los valores del conjunto de
datos y llama a la función callBack para determinar qué sucede a continuación.
■
Para continuar con este ejemplo, se pueden utilizar las funciones siguientes en
la declaración callBack.onSuccess para aplicar los datos a una tabla o campo de
búsqueda, respectivamente:
ca_pam_setTableData('Form.employeeList',result);
ca_pam_showDataInTable(result,'Form.Results','Dataset
results');
ca_pam_getSQLData(driverName,connectionURL,userName,password,query,callBack)
Dirige SQL para recuperar datos de una fuente de datos externa y almacena esos datos
en una variable definida llamada "callBack".
Nota: En las versiones de CA Process Automation anteriores a la 04.1.00, este método
se llamaba ca_pam_getDataFromSQLQuery.
Capítulo 7: Formularios 353
El Diseñador de formularios
Parámetros de entrada
driverName (string)
Define el nombre de clase para el controlador de SQL instalado que está
usando (por ejemplo, com.mysql.jdbc.driver).
connectionURL (string)
Define la URL de la aplicación de base de datos para consultar como en el
ejemplo siguiente:
jdbc:mysql://miPC-xp.miEmpresa.com:<puerto>/<ruta> o
https://<servidor>:<puerto>/
userName (string)
Define el nombre de usuario o las credenciales de inicio de sesión de una
cuenta de usuario predefinida con permisos suficientes para ejecutar la
consulta.
password (string)
Define la contraseña que se asocia con el nombre de usuario especificado.
query (string)
Define una declaración de consulta de SQL específica o una referencia a una
declaración de consulta de SQL. El siguiente código representa una consulta de
SQL de muestra:
"select * from employeedatatable where empName like
'%"+ca_pam_getTextFieldValue('Form.empName')+"%'";
callBack (object)
Define una referencia al objeto de función para llamar después de haber
recuperado los datos, incluidos los métodos de onSuccess y onFailure.
Valor de retorno
Cuando la función recupera los datos, se ejecutan las funciones onSuccess(result) u
onFailure(caught) callBack. La función por sí misma no devuelve ningún valor.
Ejemplo
ca_pam_getSQLData(ca_fd.js.driverName
(),ca_fd.js.connectionURL(),ca_fd.js.userName(),ca_fd.js.passwo
rd(),ca_fd.js.queryEmployeeName(),callBack);
Este ejemplo consulta una fuente de datos externa y almacena los datos que
resultantes en la variable callBack.
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario, 06 Populate
Dropdown DB: Populate Dropdown from DB.
354 Guía del diseñador de contenido
El Diseñador de formularios
Análisis de JSON
ca_pam_convertJSONToJSObject(jsonString)
Utilice este método para crear un objeto de JavaScript desde una cadena de JSON. El
método de ca_pam_convertJSONToJSObject admite la notación de comillas. La notación
de comillas es una forma alternativa de acceder a cualquier propiedad de un objeto de
JavaScript cuando el nombre de la propiedad no es un identificador de JavaScript válido.
Por ejemplo, para acceder a la propiedad de ID del objeto de biblioteca, la sintaxis de
notación de comillas es book*“id”+.
Parámetros de entrada
jsonString (string)
Define la cadena de JSON para realizar la conversión a un objeto de JavaScript.
Valor de retorno
Devuelve el objeto de JavaScript.
Ejemplo
El ejemplo muestra una cadena de JSON:
{"menu": {
"id": "file",
"value": "File",
"popup": {
"menuitem": [
{"value": "New", "onclick": "CreateNewDoc()"},
{"value": "Open", "onclick": "OpenDoc()"},
{"value": "Close", "onclick": "CloseDoc()"}
]
}
}}
El script de muestra siguiente accede al valor de campo de ID:
var parsedJSON = ca_pam_convertJSONToJSObject(jsonString);
var menuObj = parsedJSON.menu.;
var idValue = menuObj.id.;
El script de muestra siguiente accede al elemento onclick en el segundo elemento
de la matriz menuitem:
var
var
var
var
var
var
parsedJSON = ca_pam_convertJSONToJSObject(jsonString);
menuObj = parsedJSON.menu;
popUpObj = menuObj .popup;
menuItemArray = popUpObj .menuitem.;
secondElementOfMenuItemArray = menuItemArray[1];
onclickElement = secondElementOfMenuItemArray.onclick;
Capítulo 7: Formularios 355
El Diseñador de formularios
También se puede encontrar esta función en el contenido listo para usar en CA
Process Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario y, a continuación, 07
Populate Table RESTful WS: Populate Table RESTful WS.
356 Guía del diseñador de contenido
El Diseñador de formularios
Métodos de REST
ca_pam_getRESTData(url, doNotValidateCert, headers, callBack)
Utiliza el método de HTTP Get para iniciar el servicio de REST. Se puede utilizar este
método con las siguientes firmas:
ca_pam_getRESTData(url, callBack);
ca_pam_getRESTData(url, doNotValidateCert, callBack);
Parámetros de entrada
url (string)
Define la URL para la solicitud de HTTP. La URL empieza con http:// o https://.
doNotValidateCert (boolean)
Especifica si se encuentra un certificado SSL válido. Este campo es relevante al
consultar una URL de HTTPS.
■
Falso: valida el certificado SSL y produce un fallo en la operación si el
certificado no es válido.
■
Verdadero: acepta el certificado SSL aunque no sea válido y continúa
haciendo la llamada de HTTP.
headers (objetos)
Define una lista de pares de clave/valor que establece encabezados en la
solicitud.
callBack (object)
Define una referencia al objeto de función para llamar después de haber
recuperado los datos, incluidos los métodos de onSuccess y onFailure.
Valor de retorno
Cuando la función recupera los datos, se ejecutan las funciones onSuccess(result) u
onFailure(caught) callBack. La función por sí misma no devuelve ningún valor.
Ejemplo
Esta función se puede encontrar en el contenido listo para usar en CA Process
Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario y, a continuación, 07
Populate Table RESTful WS: Populate Table RESTful WS.
Capítulo 7: Formularios 357
El Diseñador de formularios
ca_pam_getRESTDataAuth(url, userName, password, doNotValidateCert, headers, callBack)
Inicia el servicio de REST en una URL especificada que requiere autenticación. Este
método es compatible solamente con autenticación de HTTP básica. Se puede utilizar
este método con las siguientes firmas:
ca_pam_getRESTDataAuth (url, userName, password, callBack)
ca_pam_getRESTDataAuth (url, userName, password, doNotValidateCert,
callBack)
Parámetros de entrada
url (string)
Define la URL para la solicitud de HTTP. La URL empieza con http:// o https://.
username (string)
Define el nombre de usuario para el que se autenticará la URL especificada.
password (string)
Define la contraseña asociada al nombre de usuario especificado.
doNotValidateCert (boolean)
Especifica si se encuentra un certificado SSL válido. Este campo es relevante al
consultar una URL de HTTPS.
■
Falso: valida el certificado SSL y produce un fallo en la operación si el
certificado no es válido.
■
Verdadero: acepta el certificado SSL aunque no sea válido y continúa
haciendo la llamada de HTTP.
headers (objetos)
Define una lista de pares de clave/valor que establece encabezados en la
solicitud.
callBack (object)
Define una referencia al objeto de función para llamar después de haber
recuperado los datos, incluidos los métodos de onSuccess y onFailure.
Valor de retorno
Cuando la función recupera los datos, se ejecutan las funciones onSuccess(result) u
onFailure(caught) callBack. La función por sí misma no devuelve ningún valor.
358 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_postRESTData(url, body, contentType, doNotValidateCert, headers, callBack)
Utiliza el método de HTTP Post para iniciar el servicio REST. Se puede utilizar este
método con las siguientes firmas:
ca_pam_postRESTData
ca_pam_postRESTData
ca_pam_postRESTData
ca_pam_postRESTData
callBack)
(url,
(url,
(url,
(url,
callBack)
body, callBack)
body, contentType, callBack)
body, contentType, doNotValidateCert,
Parámetros de entrada
url (string)
Define la URL para la solicitud de HTTP. La URL empieza con http:// o https://.
body (string)
Define los datos que se enviarán en la solicitud de HTTP.
contentType (string)
Define el tipo de contenido que comprende el cuerpo de solicitud de HTTP.
Este valor se ha enviado como encabezado (tipo de contenido) en la solicitud
de HTTP.
doNotValidateCert (boolean)
Especifica si se encuentra un certificado SSL válido. Este campo es relevante al
consultar una URL de HTTPS.
■
Falso: valida el certificado SSL y produce un fallo en la operación si el
certificado no es válido.
■
Verdadero: acepta el certificado SSL aunque no sea válido y continúa
haciendo la llamada de HTTP.
headers (objetos)
Define una lista de pares de clave/valor que establece encabezados en la
solicitud.
callBack (object)
Define una referencia al objeto de función para llamar después de haber
recuperado los datos, incluidos los métodos de onSuccess y onFailure.
Valor de retorno
Cuando la función recupera los datos, se ejecutan las funciones onSuccess(result) u
onFailure(caught) callBack. La función por sí misma no devuelve ningún valor.
Capítulo 7: Formularios 359
El Diseñador de formularios
ca_pam_postRESTDataAuth(url, userName, password, body, contentType, doNotValidateCert,
headers, callBack)
Inicia el servicio de REST en una URL especificada que requiere autenticación. El servidor
llama a los métodos de REST de forma asíncrona.
Las funciones onSuccess(result) u onFailure(caught) del objeto de devolución de llamada
se ejecuta según proceda después de que los datos se recuperen del servidor. El
resultado puede ser cualquier formato de datos que el servicio de REST devuelva. El
método es compatible solamente con autenticación de HTTP básica. Se puede utilizar
este método con las siguientes firmas:
ca_pam_postRESTDataAuth(url,
ca_pam_postRESTDataAuth(url,
ca_pam_postRESTDataAuth(url,
callBack)
ca_pam_postRESTDataAuth(url,
doNotValidateCert, callBack)
userName, password, callBack)
userName, password, body, callBack)
userName, password, body, contentType,
userName, password, body, contentType,
Parámetros de entrada
url (string)
Define la URL para la solicitud de HTTP. La URL empieza con http:// o https://.
username (string)
Define el nombre de usuario para el que se autenticará la URL especificada.
password (string)
Define la contraseña que se asocia con el nombre de usuario especificado.
body (string)
Define los datos que se enviarán en la solicitud de HTTP.
contentType (string)
Define el tipo de contenido que comprende el cuerpo de solicitud de HTTP.
Este valor se ha enviado como encabezado (tipo de contenido) en la solicitud
de HTTP.
doNotValidateCert (boolean)
Especifica si se encuentra un certificado SSL válido. Este campo es relevante al
consultar una URL de HTTPS.
■
Falso: valida el certificado SSL y produce un fallo en la operación si el
certificado no es válido.
■
Verdadero: acepta el certificado SSL aunque no sea válido y continúa
haciendo la llamada de HTTP.
headers (objetos)
Define una lista de pares de clave/valor que establece encabezados en la
solicitud.
360 Guía del diseñador de contenido
El Diseñador de formularios
callBack (object)
Define una referencia al objeto de función para llamar después de haber
recuperado los datos, incluidos los métodos de onSuccess y onFailure.
Valor de retorno
Cuando la función recupera los datos, se ejecutan las funciones onSuccess(result) u
onFailure(caught) callBack. La función por sí misma no devuelve ningún valor.
Ejemplo
Esta función se puede encontrar en el contenido listo para usar en CA Process
Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Acceda a la carpeta Formularios de interacción del usuario y, a continuación, 07
Populate Table RESTful WS: Populate Table RESTful WS.
Ejemplo: método de POST de REST
Para recuperar todos los formularios de solicitud de inicio en la biblioteca de CA Process
Automation, llame al API de REST de PAM en el contenedor de CA Catalyst.
1.
Cree un formulario de solicitud de interacción y diséñelo tal y como muestra la
ilustración siguiente:
Capítulo 7: Formularios 361
El Diseñador de formularios
2.
Agregue el campo de palabra clave al formulario de solicitud de interacción.
3.
Agregue el siguiente texto a la sección Script del formulario de solicitud de
interacción:
{
sample : function()
{
var callBack = new Object();
callBack.onSuccess = function(result)
{
alert(result);
}
callBack.onFailure = function(caught)
{
alert(caught);
}
var headers = new Object();
var contentType="application/xml";
ca_pam_getDataFromRESTPostHTTPAuthentication('https://<hostName>:<PortNumber>
/node/rest/CA:00074:01/_ops/QueryStartRequests',useName
password,<requestBody>,contentType,true,headers,callBack);
}
}
El cuerpo de solicitud es tal y como se muestra a continuación:
<QueryStartRequestFormsRequest
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="p1:QueryStartRequestFormsRequest"
xmlns:p1="http://ns.ca.com/2011/09/pam-ops" >
<Filter>
<LookUpPath>/</LookUpPath>
<IsRecursive>true</IsRecursive>
</Filter>
</QueryStartRequestFormsRequest>
4.
Proporcione el valor ca_fd.js.sample() en el evento onBlur del campo de palabra
clave.
5.
Haga clic en Guardar.
El script se ejecuta según el evento onBlur del campo de palabra clave. El formulario
de solicitud de inicio se recupera según el cuerpo de consulta especificado y la
solicitud de REST realizada.
362 Guía del diseñador de contenido
El Diseñador de formularios
Métodos de SOAP
ca_pam_getSOAPData(serviceURL, methodName, inlineText, soapVersion,
stripXMLNamespacesFromResponse, callBack)
Realiza una llamada del servicio Web y convierte el XML resultante en un objeto de
JavaScript.
Este método es un método sobrecargado. Se puede invocar ca_pam_getSOAPData sin
proporcionar la versión de SOAP ni el parámetro stripXMLNamespacesFromResponse. Si
no se proporcionan estos parámetros, se considera que la versión de SOAP es SOAP_1_1
y que el parámetro stripXMLNamespacesFromResponse es verdadero.
Las firmas de método sobrecargadas son las siguientes:
■
ca_pam_getSOAPData (serviceURL,methodName, inlineText,callBack)
■
ca_pam_getSOAPData (serviceURL,methodName, inlineText,soapVersion, callBack)
Parámetros de entrada
serviceURL (string)
Indica la URL para el servicio de SOAP. Se suele acceder a la URL a través de
HTTP o HTTPS. La URL generalmente es un punto de entrada para un método o
más.
methodName (string)
Indica el método o la función que se va a ejecutar. El método se transfiere al
servicio de SOAP como un encabezado MIME de SOAPAction.
inlineText (string)
Especifica la fuente de la solicitud de entrada del servicio de SOAP. Este
parámetro incluye un mensaje de XML, que puede incluir un sobre de SOAP.
soapVersion (string)
Especifica la versión del servidor de SOAP en el cual se realiza la llamada. Entre
los posibles valores, se incluyen SOAP_1_1 y SOAP_1_2. El valor
predeterminado es SOAP _1_1.
stripXMLNamespacesFromResponse (boolean)
Especifica si se han eliminado de la respuesta de XML (verdadera) los espacios
de nombre de respuesta. El valor predeterminado es true.
callBack (object)
Define una referencia al objeto de función para llamar después de haber
recuperado los datos, incluidos los métodos de onSuccess y onFailure.
Capítulo 7: Formularios 363
El Diseñador de formularios
La función ca_pam_getSOAPData llama al método de callBack de forma
asíncrona en el servidor. Cuando la función recupera los datos, se ejecutan las
funciones onSuccess(result) u onFailure(caught) callBack. Si se devuelve un
error de SOAP en la función, esta llama al método de onFault(faultString) y el
resultado será una cadena de XML.
Si no se proporcionan la versión de SOAP ni los parámetros
stripXMLNameSpacesFromResponse, se sustituyen sus valores
predeterminados y la respuesta se devuelve al objeto callBack en la función
onSuccess(result).
Valor de retorno
Cuando la función recupera los datos, se ejecutan las funciones onSuccess(result) u
onFailure(caught) callBack. Si se devuelve un error de SOAP en la función, esta
llama al método de onFault(faultString) y el resultado será una cadena de XML. La
función por sí misma no devuelve ningún valor.
Nota: Esta función se puede encontrar en el contenido listo para usar en CA Process
Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Diríjase a la carpeta Formularios de interacción del usuario y, a continuación,
acceda a 08 Populate Table SOAP WS: Populate Table SOAP WS.
Ejemplo: método SOAP
364 Guía del diseñador de contenido
El Diseñador de formularios
Este ejemplo utiliza el método del servicio Web getStartRequestForms de
CA Process Automation para rellenar una tabla con todos los Formularios de solicitud de
inicio de la Biblioteca. El método del servicio Web getStartRequestFormsweb devuelve
todos los formularios de solicitud de inicio en una carpeta especificada.
Nota: Este método utiliza el método ca_pam_convertXMLToJSObject(xmlString,
elementTagName), descrito más adelante en esta sección, para crear un objeto de
JavaScript a partir de XML.
1.
Cree un formulario de solicitud de interacción y diséñelo tal y como muestra la
ilustración siguiente:
Capítulo 7: Formularios 365
El Diseñador de formularios
2.
Agregue los campos siguientes al formulario de solicitud de interacción:
soapService
Establezca este campo en la siguiente URL:
http://hostname:portNumber/itpam/soap
soapAction
Establezca este campo de texto como getStartRequestForms.
soapData
Rellene esta área de texto con el código siguiente:
<tns:getStartRequestForms xmlns:tns="http://www.ca.com/itpam">
<tns:auth>
<!--xsd:Choice Type-->
<tns:token>token__</tns:token>
<tns:user>pamadmin</tns:user>
<tns:password>pamadmin</tns:password>
</tns:auth>
<tns:filter>
<tns:lookUpPath isRecursive="true">/</tns:lookUpPath>
</tns:filter>
</tns:getStartRequestForms>
retrieveSRF
Establezca el atributo onclick de esta casilla de verificación como el valor
ca_fd.js.retreiveSRFAndPopulateTable().
3.
Cree una tabla denominada srfs.
4.
Agregue los campos de texto de nombre y refPath como columnas a la tabla de srfs.
5.
Agregue el siguiente texto a la sección Script del formulario:
{
retreiveSRFAndPopulateTable: function()
{
var callBack = new Object();
callBack.onSuccess = function(result)
{
var srfResult = ca_pam_ convertXMLToJSObject
(result,'startRequest');
var tableArray = new Array();
for( i=0;i<srfResult .length;i++)
{
var object = new Object();
object.name = srfResult [i]["name"];
object.refPath = srfResult [i]["refPath"];
tableArray[i] = object ;
}
366 Guía del diseñador de contenido
El Diseñador de formularios
ca_pam_clearTableData('Form.srfs',0,ca_pam_getTableRowCount('Form.srfs')-1);
ca_pam_setTableDataFromJSObject('Form.srfs',tableArray);
}
callBack.onFailure = function(caught)
{
alert(caught);
}
ca_pam_getSOAPData(ca_pam_getTextFieldValue('Form.soapService'),ca_pam_getTex
tFieldValue('Form.soapAction'),ca_pam_getTextFieldValue('Form.soapData'),'SOA
P_1_1',true,callBack);
}
}
6.
Haga clic en Guardar.
7.
Para hacer que CA Process Automation verifique que la tabla de formularios de
solicitud de inicio se rellene dinámicamente con datos, seleccione la casilla de
verificación.
El script se ejecuta cuando se cambia el valor de la casilla de verificación. El script rellena
la tabla de formularios de solicitud de inicio dinámicamente con los formularios de
solicitud de inicio que se devuelven desde la llamada de SOAP El método getSOAPData
se utiliza para hacer una consulta de SOAP para recuperar los datos y
convertXMLToJSObject se utiliza para convertir la respuesta XML en un objeto de
JavaScript. El objeto de JavaScript se puede utilizar para rellenar la tabla dinámicamente
mediante el método ca_pam_setTableDataFromJSObject.
Capítulo 7: Formularios 367
El Diseñador de formularios
Análisis de XML
ca_pam_convertXMLToJSObject(xmlString, elementTagName)
Crea un objeto de JavaScript de XML.
Nota: Si el elemento XML tiene en cuenta el espacio de nombres y dispone de un prefijo
de espacio de nombres, utilice la notación de citas para acceder a él.
Parámetros de entrada
xmlString (string)
Define la cadena de XML para realizar la conversión a un objeto de JavaScript.
elementTagName (string)
(Opcional) Devuelve el elemento que tiene el nombre de etiqueta especificado.
Si no se proporciona elementTagName, el método devolverá el elemento raíz.
Valor de retorno
Devuelve un valor del tipo Objeto.
Ejemplo
Tenga en cuenta el siguiente XML para convertirlo a un objeto de JavaScript:
<?xml version="1.0"?>
<catalog>
<book id="bk101">
<author>Gambardella, Matthew</author>
<title>Guía del desarrollador de XML</title>
<genre>Equipo</genre>
<price>44,95</price>
<publish_date>01-10-2000</publish_date>
<description>Una mirada en profundidad a la creación de
aplicaciones
con XML.</description>
</book>
</catalog>
En este ejemplo se convierten los datos de XML anteriores en un objeto de
JavaScript.
■
La sintaxis siguiente convierte el documento de XML en un objeto de
JavaScript:
var parsedXML = ca_pam_convertXMLToJSObject(xmlString);
■
Se puede utilizar cualquiera de las líneas siguientes para acceder al elemento
book:
var bookObj = parsedXML . book[0];
var bookObj = parsedXML [“book”][0];
368 Guía del diseñador de contenido
El Diseñador de formularios
■
Se puede utilizar cualquiera de las líneas siguientes para recuperar el valor de
atributo de ID del elemento book:
var idVal = bookObj.id;
var idVal = bookObj[“id”];
■
Se puede utilizar cualquiera de las líneas siguientes para acceder al valor de
descripción de ID del elemento book:
var bookDesription = bookObj. description[0]._text;
var bookDesription = bookObj[“description”][0][“_text”];
Nota: Si un elemento tiene un atributo y existe un elemento con el mismo nombre,
acceda a ellos como una matriz. En la matriz, el primer miembro (índice 0) es
siempre el atributo y, a continuación, van los elementos.
Ejemplo
Tenga en cuenta el siguiente XML para convertirlo a un objeto de JavaScript:
<?xml version="1.0"?>
<categories>
<category name="Weather">
<name part="1">Soleado</name>
<name part="2">Lluvioso</name>
</category>
<category name="Climate">
<name part="1">Húmedo</name>
<name part="2">Seco</name>
</category>
</categories>
En este ejemplo se convierten los datos de XML anteriores en un objeto de
JavaScript.
■
Utilice la sintaxis siguiente para recuperar el primer objeto de categoría de las
categorías que XML representa como xmlString:
var parsedXML= ca_pam_convertXMLToJSObject(xmlString);
var firstCatagory= parsedXML.category[0];
■
Utilice la sintaxis siguiente para acceder al atributo con nombre:
var bookName = firstCatagory.name[0];
■
Utilice la sintaxis siguiente para acceder al valor del primer elemento de
nombre:
var firstBookName = firstCatagory.name[1]._text;
Capítulo 7: Formularios 369
El Diseñador de formularios
Ejemplo
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<Header/>
<Body>
<getStartRequestFormsResponse
xmlns="http://www.ca.com/itpam">
<startRequests>
<startRequest name="RahulSrf"
refPath="/Folder/">
<description/>
</startRequest>
<startRequest name="Start Request Form"
refPath="/RestSupport/">
<description/>
</startRequest>
</startRequests>
</getStartRequestFormsResponse>
</Body>
</Envelope>
En este ejemplo se muestra el uso del método de
ca_pam_convertXMLToJSObject(xmlString, elementTagName) con el parámetro
elementTagName.
El siguiente script recupera todos los elementos de <startRequest> de XML:
var srfResult =
ca_pam_convertXMLToJavaScriptObject(xmlString,'startRequest');
srfResult es una matriz de todos los elementos de startRequest.
370 Guía del diseñador de contenido
El Diseñador de formularios
Ejemplo
<?xml version="1.0"?>
<note _text="abc">
<_text>Tove</_text>
</note>
En este ejemplo se muestra un escenario en el cual el XML tiene _text como
elemento o atributo. En este caso, el método crea una matriz con el nombre
"_text".
■
El primer elemento de la matriz devuelve el nodo de texto en el elemento.
■
El segundo elemento de la matriz devuelve el nodo de atributo (con el nombre
"_text") del elemento.
■
Otros elementos de la matriz devuelven nodos del elemento hijo (con el
nombre "_text") del elemento.
El script siguiente accede a los valores:
var
var
var
var
parsedXML= ca_pam_convertXMLToJavaScriptObject(xmlString);
textNode= parsedXML["_text"][0];
attributeValue= parsedXML["_text"][1];
childTextNodeValue= parsedXML["_text"][2]["_text"];
El script muestra el resultado siguiente:
textNode="";
(puesto que no existe un valor de escala con el nodo).
attributeValue="abc";
childTextNodeValue="Tove"
También se puede encontrar esta función en el contenido listo para usar en CA Process
Automation.
1.
En la Página principal, haga clic en Exploración del contenido original.
2.
Diríjase a la carpeta Formularios de interacción del usuario y, a continuación,
acceda a 08 Populate Table SOAP WS: Populate Table SOAP WS.
Capítulo 7: Formularios 371
El Diseñador de formularios
Creación de un formulario simple con funciones básicas
En este ejemplo, se está desarrollando un formulario para una compañía que trabaja en
tres regiones principales (California, Pensilvania y Carolina del Norte). En cada estado, la
compañía tiene una ubicación de oficina primaria y secundaria identificada mediante el
nombre de la ciudad. Los interesados responsables de implementar la política de la
compañía desean que el formulario cumpla los requisitos de negocio siguientes:
■
Todo el negocio que se origine en California se debe dirigir de forma
predeterminada a la oficina de Anaheim.
■
Todo el negocio que se origine en Pensilvania se debe dirigir de forma
predeterminada a la oficina de Filadelfia.
■
Todo el negocio que se origine en Carolina del Norte se debe dirigir de forma
predeterminada a la oficina de Raleigh.
■
Todo el negocio que se origine en cualquier otro estado se debe dirigir de forma
predeterminada a la oficina de Pittsburgh.
■
El usuario tiene la opción de especificar otro estado u otra ciudad.
Ejemplo: un formulario básico
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Cree un objeto de formulario de solicitud de interacción o busque uno existente
para utilizar con este procedimiento de muestra.
3.
Haga doble clic en el objeto de formulario.
Aparecerá el cuadro de diálogo Formulario de solicitud de interacción, o Diseñador
de Formularios.
4.
Si el objeto de formulario todavía no se ha extraído, haga clic en Extraer.
5.
En el panel Elementos de formulario, expanda las entradas siguientes:
a.
Elementos de formulario
b. Su formulario (por ejemplo, Interaction_Request_Form_4)
c.
Vista de página
d. Página
372 Guía del diseñador de contenido
El Diseñador de formularios
6.
Haga clic en Página.
7.
Haga clic en Renombrar en la barra de herramientas.
8.
Introduzca la ubicación del nombre y haga clic en Aceptar.
9.
Arrastre un campo de selección desde el panel Formulario hasta la página de
ubicación.
10. Repita el paso 9.
Aparecerán dos campos de selección bajo el diseño de la página de ubicación.
11. Lleve a cabo las acciones siguientes en el panel Formulario:
a.
Arrastre tres opciones de selección hasta el primer campo de selección.
b. Arrastre seis opciones de selección hasta el segundo campo de selección.
12. Haga clic en cada uno de los siguientes elementos de formulario y, a continuación,
haga clic en Renombrar para cambiar el nombre de cada objeto, tal y como se
indica:
a.
Renombre el primer campo de selección como State (Estado).
■
Renombre la primera opción como CA.
■
Renombre la segunda opción como PA.
■
Renombre la tercera opción como NC.
b. Renombre el segundo campo de selección como City (Ciudad).
■
Renombre la primera opción como Anaheim.
■
Renombre la segunda opción como Los Angeles.
■
Renombre la tercera opción como Pittsburgh.
■
Renombre la cuarta opción como Philadelphia.
■
Renombre la quinta opción como Charlotte.
■
Renombre la sexta opción como Raleigh.
Capítulo 7: Formularios 373
El Diseñador de formularios
13. Haga clic en cada uno de los elementos de formulario siguientes y realice las
siguientes configuraciones de propiedad en el panel Propiedades (Nombre y Valor).
a.
Para State (Estado):
■
Configure el nombre como State (Estado).
■
Establezca el valor del evento onChange como ca_fd.js.selectRegion().
■
Establezca el valor de la opción CA como California.
■
Establezca el valor de la opción PA como Pennsylvania.
■
Establezca el valor de la opción NC como North Carolina (Carolina del
Norte).
b. Para City (Ciudad):
■
Configure el nombre como City (Ciudad).
■
Establezca la propiedad de valor de cada opción de ciudad como el nombre
de la ciudad. Por ejemplo, establezca Anaheim como Anaheim, Los Angeles
a Los Angeles, etc.
14. En el panel Elementos de formulario, haga clic en el nombre de su formulario y, a
continuación, haga clic en Script en la barra de herramientas.
Se abre el cuadro de diálogo Script.
374 Guía del diseñador de contenido
El Diseñador de formularios
15. Copie y pegue el código siguiente en el editor de script (en la página 152):
{
selectRegion: function()
{
var selectedState = ca_pam_getSelectedOptionValues('Form.State')[0];
if(selectedState == 'North Carolina')
{
ca_pam_selectOption('Form.City', 'Raleigh', 'Raleigh', true);
}
else if(selectedState == 'California')
{
ca_pam_selectOption('Form.City', 'Anaheim', 'Anaheim', true);
}
else if(selectedState == 'Pennsylvania')
{
ca_pam_selectOption('Form.City', 'Philadelphia', 'Philadelphia', true);
}
else
{
ca_pam_selectOption('Form.City', 'Pittsburgh', 'Pittsburgh', true);
}
}
}
16. Haga clic en Guardar. Se cerrará el cuadro de diálogo Script.
17. Haga clic en Guardar en el diseñador de formularios.
Capítulo 7: Formularios 375
El Diseñador de formularios
18. Haga clic en la ficha Vista previa.
19. Compruebe que sus resultados sean similares a los valores y resultados de muestra
de la ilustración y la tabla que aparecen a continuación:
Estado:
Ciudad predeterminada:
CA
Anaheim
PA
Philadelphia
NC
Raleigh
Cualquier otro estado. Por ejemplo, NY.
Pittsburgh
376 Guía del diseñador de contenido
Inicialización de variables de formulario
Inicialización de variables de formulario
Después de diseñar un formulario de solicitud de interacción, se puede configurar en un
operador Asignar tarea de usuario específico en un proceso. También se puede agregar
código para inicializar campos de formulario en tiempo de ejecución.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Diseñador.
2.
En el diseñador de procesos, abra un proceso o cree uno.
3.
En el grupo de control del proceso en la paleta Operadores, arrastre un operador
Asignar tarea de usuario a su proceso.
4.
Haga doble clic en el operador Asignar tarea de usuario para abrir la paleta
Propiedades.
5.
En la paleta Propiedades:
a.
Expanda Tarea de usuario.
b. En el campo Formulario de solicitud de interacción, haga clic en el botón de
búsqueda para buscar un formulario. Haga clic en Aceptar.
c.
6.
Haga clic en el campo Código de inicialización de datos de formularios para
ampliarlo.
En la ventana Código de inicialización de datos de formularios, inicialice cualquier
variable de formulario. En los ejemplos siguientes, myTextField es el _id del
elemento de formulario que se desea inicializar.
■
En tipos de datos simples, introduzca:
Form.myTextField='welcome'.
■
Si el campo simple está dentro de un conjunto de campos o ValueMap,
introduzca:
Form.value_map= newValueMap();
Form.valuemap.myTextField="welcome";
■
Si el campo simple está dentro de una asignación de valor compleja en un
valueMap, introduzca:
Form.value_map.value_map_nested= newValueMap();
Form.value_map.value_map_nested.text_field_nested="test";
7.
En la ventana Código de inicialización de datos de formularios, haga clic en Aceptar.
Capítulo 7: Formularios 377
Capítulo 8: Recursos
Un objeto Recurso es un modelo que representa elementos de la arquitectura del
sistema. Utilícelos para sincronizar procesos independientes que dependan de
elementos de infraestructura comunes, así como para cuantificar y controlar el acceso a
las entidades informáticas específicas. Incluya varios recursos que representen
entidades relacionadas en un solo objeto Recurso.
Utilice objetos de recurso para:
■
Equilibrar la carga de procesamiento en todos los procesos que se ejecutan en un
punto de contacto.
■
Sincronizar la ejecución de procesos que no se pueden ejecutar paralelamente.
■
Implementar bloqueos en el nivel del entorno que simultáneamente activan o
desactivan varios procesos.
■
Gestionar estratégicamente procesos y sistemas con derechos de seguridad
comunes.
Los recursos se agrupan porque están relacionados entre sí de alguna forma. Los
ejemplos incluyen bases de datos compartidas, vínculos de transmisión, acceso
simultáneo a un número limitado de licencias de software, procesos simultáneos en un
punto de contacto, cuotas numéricas y otros recursos. Después de medir el
rendimiento, se pueden asignar recursos del sistema a los procesos que los requieran.
Se puede limitar el número de conexiones de FTP simultáneas que utiliza
CA Process Automation. Se pueden utilizar recursos para iniciar un proceso sucesor
solamente después de que un proceso antecedente haya publicado un recurso. Los
recursos también se pueden utilizar para representar y controlar el acceso a una entidad
de entorno de TI particular como un archivo de registro que recibe actualizaciones de
varios procesos.
Esta sección contiene los siguientes temas:
Cómo funcionan los recursos (en la página 380)
Creación de un objeto de recursos (en la página 381)
Edición de un objeto de recurso (en la página 382)
Monitorización y edición de recursos (en la página 384)
Agregación de un operador Gestionar recursos a un proceso (en la página 385)
Definición de acciones de recurso (en la página 386)
Cómo comprobar y responder recursos no disponibles (en la página 387)
Capítulo 8: Recursos 379
Cómo funcionan los recursos
Cómo funcionan los recursos
El operador Gestionar recursos se encuentra en la carpeta Control del proceso. Un
proceso puede utilizar el operador Gestionar recursos para tomar unidades disponibles
de un recurso especificado. Si se toman todas las unidades del recurso especificado (en
los propios procesos o en procesos diferentes), el operador Gestionar recursos retrasa el
procesamiento en toda esa rama hasta que el recurso tiene unidades libres.
El siguiente diseño muestra un proceso que toma una unidad del recurso cuota de
proceso antes de ejecutar una aplicación. Si hay unidades disponibles en el recurso de
cuota del proceso, el procesamiento continúa en Ejecutar la aplicación 1. Si no hay
ninguna unidad de recurso disponible, el proceso no se inicia hasta que hay unidades
disponibles o hasta que se agota el tiempo de espera de operador. Una vez que el
operador Ejecutar la aplicación 1 termina, la unidad de recursos queda liberada y vuelve
al recurso cuota de proceso, y el procesamiento continúa con los operadores
subsiguientes del proceso.
Los recursos permiten definir el número de unidades disponibles y cuántas unidades se
consumen. Un recurso está formado por un número máximo de unidades, el valor
actual de las unidades disponibles y un indicador para saber si el recurso está
bloqueado.
Se pueden realizar las siguientes acciones con los recursos:
■
La toma de una cantidad especificada de unidades de un recurso disponible. La
introducción de un valor superior en el campo Utilizado.
■
La liberación de una cantidad especificada de unidades de un recurso disponible. La
introducción de un valor inferior en el campo Utilizado.
■
El bloqueo de un recurso.
■
El desbloqueo de un recurso.
380 Guía del diseñador de contenido
Creación de un objeto de recursos
Un operador Gestionar recursos puede consumir o liberar cualquier número
especificado de recursos. Como desarrollador o administrador, se pueden utilizar
operadores Gestionar recursos para ajustar el equilibrio de carga en un punto de
contacto concreto. También se puede bloquear un recurso para evitar que otro proceso
consuma las unidades del recurso.
Se aplican las restricciones siguientes a los recursos:
■
El número máximo de unidades de cualquier recurso es un valor arbitrario que se
puede calibrar y ajustar para los requisitos del sistema. Asimismo, el número de
recursos que utiliza un proceso es arbitrario. El límite máximo es 9.999; sin
embargo, déjese guiar por el rendimiento y la arquitectura. Asigne a los procesos
las unidades de recurso que mejor se adapten a sus requisitos de implementación.
■
El valor de unidades de recurso actualmente utilizado es siempre menor o igual que
el valor máximo del recurso.
■
Un proceso dependiente de recursos debe esperar hasta que su número
especificado de unidades esté disponible.
■
Los operadores no pueden consumir unidades de un recurso bloqueado.
■
Los operadores no pueden bloquear un recurso que está bloqueado por otro
proceso.
Creación de un objeto de recursos
Cree y defina tantos objetos Recurso como sea necesario en cada orquestador. El
operador Recurso realiza operaciones de recurso en un proceso. El operador Recurso
utiliza las versiones actuales de objetos de recurso especificados. Las modificaciones
hechas en el objeto de recurso en su estado actual están disponibles inmediatamente
para el operador Recurso una vez que se incorporan.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel izquierdo, haga clic en una carpeta, seleccione Nuevo y, a continuación,
Recursos.
Aparece un nuevo recurso.
3.
Haga clic en el nombre del recurso y renómbrelo con un nombre más significativo.
4.
Edite el objeto de recurso.
Nota: También se pueden crear objetos de recurso dinámicamente mediante código.
Capítulo 8: Recursos 381
Edición de un objeto de recurso
Edición de un objeto de recurso
Edite un objeto de recurso para gestionar recursos individuales en él. También se
pueden gestionar versiones, ver propiedades y examinar el historial del objeto.
Agregue entradas de recurso individuales para aplicaciones, conexiones u otras
instancias que se desea controlar. Esto le permite:
■
Establecer un número máximo de instancias que se puedan ejecutar en cualquier
momento.
■
Realizar un seguimiento del número de instancias o unidades que se están
ejecutando simultáneamente.
■
Realizar un seguimiento del número de instancias disponibles o unidades
disponibles que se pueden iniciar en cualquier momento.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga doble clic en un objeto de recurso.
Aparecerá el cuadro de diálogo Recursos. La ficha Recursos se abre de forma
predeterminada.
3.
Haga clic Agregar para agregar un recurso individual.
4.
Revise cualquiera de los valores de las columnas de la ficha Recursos. Haga clic en
las celdas editables para introducir nuevos valores.
Nombre
Incluye los nombres de los recursos individuales de un objeto de recurso.
Cantidad
Enumera el número total de unidades asignadas a un recurso. Una unidad es un
número arbitrario que sirve como una cuota en un proceso.
Utilizado
Indica el número de unidades asignadas.
Disponible
Indica el número de unidades no asignadas. Definido por la fórmula:
Disponible = Cantidad - Usado
Estado
382 Guía del diseñador de contenido
Edición de un objeto de recurso
Especifica si un recurso está bloqueado o desbloqueado. Haga clic en el icono
de bloqueo en esta columna para intercambiar el estado bloqueado o
desbloqueado para un recurso. El operador Recurso también se puede utilizar
para bloquear un recurso mediante programación en una planificación o un
proceso. Los demás operadores Gestionar recursos no pueden bloquear,
desbloquear, tomar ni devolver unidades de recurso para un recurso
bloqueado hasta que se libere el bloqueo. Un bloqueo permite a un proceso o
una planificación monopolizar un recurso mientras procesa operadores.
% de uso
Coloque el ratón sobre este indicador visual para consultar el porcentaje
numérico del recurso que se está utilizando. Cualquier parte restante está
disponible.
Descripción
Proporciona una descripción del registro. La columna Descripción le permite
introducir texto que describe un recurso.
5.
Haga clic en Incorporar o Guardar y Cerrar.
Notas:
■
En el campo Cantidad, especifique la cantidad para el recurso. Las cuotas de los
operadores en los procesos se obtienen de este número. La cantidad es un valor
arbitrario que no está por sí mismo relacionado con unidades de ningún equipo real
o recurso de sistema (como un CPU, una memoria o banda ancha). Se puede utilizar
para repartir un recurso entre procesos en el modo en que se requiera. No hay
reglas sobre la cantidad de un recurso. Podría especificar una cantidad de 1, así
cualquier proceso puede ejecutar solamente una instancia de un operador
intensivo de CPU en cualquier momento dado.
■
Las variables del conjunto de datos se pueden utilizar para configurar el uso de un
recurso, por lo que el uso se puede ajustar en un punto de contacto sin necesidad
de abrir ni configurar los procesos que consumen un recurso. Por ejemplo, si
configuraba la cantidad en 100, podría cambiar una variable de uso de 10, a 20, 50
o incluso a 100 para incluir las demandas en un punto de contacto.
■
Las columnas Utilizado y Disponible muestran cuántas unidades de un recurso se
están consumiendo actualmente y cuántas están disponibles. Se puede introducir
un valor en el campo Utilizado de entre 0 y el número total de unidades mostradas
en el campo Cantidad. Más comúnmente, el operador Recurso cambia estos valores
de manera programática en un proceso o una planificación.
Capítulo 8: Recursos 383
Monitorización y edición de recursos
Monitorización y edición de recursos
Se pueden monitorizar y editar los recursos de un objeto de recurso en la página
Operaciones. La página Operaciones permite modificar la versión actual de un objeto de
recurso. Sus cambios se aplican automáticamente a cualquier operador Gestionar
recursos mediante el objeto de recurso.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Operaciones.
2.
En el panel Vínculos:
a.
Expanda Observación de procesos o Recursos.
b. Expanda la lista de carpetas o busque una observación de procesos o un objeto
de recurso específico.
c.
Seleccione un objeto de recurso.
Aparecerá la versión actual del objeto de recurso.
3.
Seleccione un recurso y, a continuación, realice uno de los cambios siguientes.
a.
En la barra de herramientas, haga clic en Bloquear para bloquear el recurso.
Haga clic en Desbloquear para desbloquear un recurso. También se puede
hacer clic en el icono de bloqueo de la columna State (Estado) para cambiar
esta configuración.
b. Haga clic en Borrar para eliminar los recursos utilizados y restablecer los
recursos libres a la cantidad máxima disponible.
c.
Haga clic en los campos Cantidad, Utilizado y Descripción para editar sus
valores.
d. Haga clic en Actualizar para ver los últimos datos del sistema.
Sus cambios están disponibles para los operadores Gestionar recursos.
4.
Para agregar o editar recursos en un operador Gestionar recursos en una
planificación:
a.
Expanda Vínculos y haga clic en Planificaciones activas o globales.
b. En la lista de planificaciones, haga doble clic en una planificación.
c.
En un elemento Gestionar recursos de la planificación, haga clic en
Propiedades.
d. Haga clic en la ficha Específico.
e.
Haga clic en Extraer.
f.
Haga clic en Agregar, Editar o Suprimir para configurar los recursos.
g.
Haga clic en Incorporar o en Guardar y Cerrar.
384 Guía del diseñador de contenido
Agregación de un operador Gestionar recursos a un proceso
Agregación de un operador Gestionar recursos a un proceso
Después de haber creado un objeto de recurso con uno o varios recursos, agregue un
operador Recurso a un proceso. Por ejemplo, coloque un operador Recurso antes y otro
después de otros operadores para equilibrar la carga. El primer operador Recurso utiliza
o toma recursos y el segundo operador libera o devuelve unidades, poniéndolas a
disposición de otros procesos que están en espera.
Lleve a cabo los pasos siguientes:
1.
Abra un proceso en el diseñador de procesos.
2.
Abra la paleta del operador Control del proceso para el recurso.
3.
Arrastre y suelte el operador Gestionar recursos a una ubicación del proceso.
4.
Defina los vínculos de entrada y salida. El operador Gestionar recursos tiene tres
vínculos de salida posibles:
5.
■
Se procesa Completado cuando el operador se ejecuta correctamente. La
variable Resultado se configura en 1 y la variable Motivo se configura en
COMPLETADO.
■
Se procesa Erróneo cuando el módulo de interpretación no puede completar el
operador correctamente. La variable Resultado se configura en -1 y la variable
Motivo se configura en ERRÓNEO.
■
Se procesa Tiempo de espera si el operador Recurso no se completa dentro de
un intervalo de tiempo de espera opcional especificado. La variable Resultado
se configura en 1 y la variable Motivo se configura en TIEMPO DE ESPERA.
■
Resultado personalizado se procesa cuando la configuración de ejecución
determinan el resultado. La variable Resultado se configura en 0 y la variable
Motivo se configura en PERSONALIZADO.
Haga doble clic el operador Recurso para configurar las opciones.
Aparecen las paletas Conjunto de datos y Propiedades de recursos.
Capítulo 8: Recursos 385
Definición de acciones de recurso
Definición de acciones de recurso
Se puede establecer la acción que se desea que tome cada operador Gestionar recursos.
Las posibles acciones incluyen tomar y liberar unidades o bloquear y desbloquear
recursos.
Lleve a cabo los pasos siguientes:
1.
En el Diseñador de procesos, haga doble clic sobre un operador Gestionar recursos.
2.
En la paleta Propiedades, haga clic en el botón Agregar. Se pueden crear varias
acciones para varios recursos dentro de un operador Recurso.
Aparece el cuadro de diálogo Propiedades de acción.
3.
En el campo del objeto Recursos, especifique el objeto de recurso que se desea
utilizar. Se puede introducir la ruta completa al objeto de recursos en la biblioteca
de automatización del orquestador o hacer clic en el botón Examinar para localizar
el objeto.
4.
(Opcional) Haga clic en Abrir para consultar o editar los recursos en el objeto.
5.
En el campo Nombre de recurso, introduzca el nombre del recurso o una expresión.
Nota: Tanto el campo Ruta de recurso como el campo Nombre de recurso aceptan
expresiones. Delimite las cadenas literales mediante comillas.
6.
En el campo Acción, seleccione de la lista desplegable la acción que se desea que el
realice el recurso:
Cómo tomar unidades
Toma el número de unidades de recurso especificado en el campo Cantidad.
Unidades disponibles
Hace que el número de recursos especificados en el campo Cantidad estén
disponibles.
Bloquear recurso
Bloquea el recurso para que otros operadores Recurso no puedan tomar
unidades de recurso ni bloquear el recurso. Las acciones pueden liberar todavía
unidades de recurso que se tomaban antes de que un recurso se bloqueara,
pero las unidades disponibles no estarán disponibles hasta después de que el
recurso se desbloquee.
Desbloquear recurso
Desbloquea un recurso bloqueado.
7.
Al tomar o al liberar unidades de recurso, especifique una cantidad en el campo
Cantidad.
8.
Haga clic en Guardar y cerrar.
La nueva acción se agrega a la lista Acción.
386 Guía del diseñador de contenido
Cómo comprobar y responder recursos no disponibles
Notas: Para quitar una acción de la lista Acción, haga clic en la acción y luego haga
clic en el botón Suprimir. Para editar una acción existente, haga clic en la acción y, a
continuación, haga clic en el botón Editar. Para consultar una acción seleccionada
en un proceso que no está extraído, haga clic en el botón Vista.
El siguiente gráfico muestra dos ejemplos.
Cómo comprobar y responder recursos no disponibles
Las propiedades siguientes determinan qué recursos ejecuta el operador y cómo
responde cuando los recursos no están disponibles:
■
Campo Tiempo de espera
■
Casilla de verificación Todos los recursos deben estar disponibles
■
Casilla de verificación Ejecutar acciones
Capítulo 8: Recursos 387
Cómo comprobar y responder recursos no disponibles
Cómo especificar un intervalo de tiempo de espera
A veces una acción intenta tomar más unidades de un recurso de las que están
disponibles o intenta bloquear un recurso que ya está bloqueado. Dadas estas
situaciones, establezca el intervalo de Tiempo de espera para determinar cuánto tiempo
espera el operador a que los recursos estén disponibles. Después de que se agote el
intervalo de tiempo de espera especificado, el operador comprueba una última vez si el
recurso está disponible antes de que finalice el tiempo de espera. Cuando el operador
Recurso agota el tiempo de espera, el módulo de procesos procesa el vínculo de salida
de tiempo de espera en el operador.
Lleve a cabo los pasos siguientes:
1.
Abra un proceso.
2.
Arrastre un operador Gestionar recursos en el proceso.
3.
Haga doble clic en el operador Gestionar recursos para ver sus propiedades.
4.
En la paleta Configuración de ejecución, configure las opciones disponibles en el
grupo Tiempo de espera.
Sin tiempo de espera
Cuando está activado, el operador espera indefinidamente hasta que todos los
recursos, incluidas todas las acciones listadas bajo Acciones, se puedan ejecutar
y estén disponibles.
Si no está activado, se aplica un ajuste de tiempo de espera en Duración o
Fecha objetivo.
Tipo
Seleccione Duración o Fecha objetivo. El operador espera antes de agotar el
tiempo de espera. Por ejemplo, para especificar un intervalo de tiempo de
espera, seleccione Duración e introduzca el número de segundos. Si se
especifica una duración de tiempo de espera de 0 segundos, el operador no
espera. Si los recursos no están disponibles, agota el tiempo de espera
inmediatamente. El operador se ejecuta correctamente solamente si los
recursos están inmediatamente disponibles.
Duración/fecha y hora objetivo
Especifique la cantidad numérica de segundos o una fecha y hora que sirvan
como período de tiempo de espera.
Acción
Seleccione Continuar, Restablecer, Anular o Abandonar. Si elige Anular, el
operador procesa el vínculo de salida Erróneo.
5.
Guarde el proceso.
388 Guía del diseñador de contenido
Cómo comprobar y responder recursos no disponibles
Especificación de la disponibilidad de los recursos y los valores de configuración
de las acciones
Las siguientes propiedades determinan qué recursos ejecuta el operador. También
determinan cómo responde el operador cuando los recursos están no disponibles.
Active la casilla de verificación Todos los recursos deben estar disponibles para
determinar cómo CA Process Automation gestiona la disponibilidad de recursos.
Establezca la opción Ejecutar acciones para determinar cómo se comporta CA Process
Automation con respecto a la disponibilidad de recursos y a las acciones
predeterminadas.
Lleve a cabo los pasos siguientes:
1.
Abra un proceso.
2.
Arrastre un operador Gestionar recursos en el proceso.
3.
Haga doble clic en el operador Gestionar recursos para ver sus propiedades.
4.
Active la casilla de verificación Todos los recursos deben estar disponibles:
Activada
Especifica que todos los recursos que aparecen en el campo Acción deben estar
disponibles antes de que se aplique cualquier acción. El operador se ejecuta
correctamente solamente si todos los recursos se muestran disponibles dentro
de las restricciones del ajuste de Tiempo de espera.
Borrar
Permite al operador completar solamente aquellas acciones para las cuales hay
recursos disponibles. El operador se realiza correctamente si uno o varias de las
acciones incluidas se ejecuta correctamente dentro de las restricciones del
ajuste de Tiempo de espera.
Capítulo 8: Recursos 389
Cómo comprobar y responder recursos no disponibles
5.
Active la casilla de verificación Ejecutar acciones:
Activada
El operador ejecuta todas las acciones, si puede.
Borrar
El operador no ejecuta ninguna acción. Si los recursos están disponibles dentro
de las restricciones de Tiempo de espera, el operador ejecuta el vínculo de
salida Correcto sin realizar acciones.
6.
Guarde el proceso.
Nota: Esta configuración se puede utilizar con un recurso que se configura para activar o
desactivar un conjunto completo de procesos. Antes de iniciar sus tareas, esos procesos
comprueban que no hay ningún bloqueo en el recurso; para ello, intenta tomar una
unidad de recursos del recurso. Según el resultado de la prueba, otro mecanismo puede
bloquear o desbloquear el recurso, por ejemplo:
■
Tareas planificadas (donde la activación o desactivación de los procesos se basa en
restricciones de tiempo)
■
Tareas iniciadas manualmente (utilizando un formulario de solicitud de inicio)
■
Un proceso iniciado por una aplicación de monitorización externa
■
Un proceso que controla una condición interna o externa en un bucle.
Cómo comprobar la disponibilidad de los recursos sin ejecutar acciones
Establezca la opción Ejecutar acciones para determinar cómo se comporta CA Process
Automation con respecto a la disponibilidad de recursos y a las acciones
predeterminadas.
390 Guía del diseñador de contenido
Capítulo 9: Calendarios, planificaciones,
tareas y disparadores
En general, una tarea Ejecutar proceso puede planificar cualquier proceso de un objeto
de planificación según fechas válidas definidas en un objeto Calendario. Una tarea de
una planificación especifica que un operador seleccionado se ejecute en un punto de
contacto especificado. Los disparadores permiten que las aplicaciones externas inicien
un proceso.
En esta sección se describen los calendarios, las planificaciones, las tareas y los
disparadores.
Esta sección contiene los siguientes temas:
Calendarios (en la página 391)
Planificaciones (en la página 407)
Gestión de tareas (en la página 417)
Administración de disparadores (en la página 420)
Calendarios
Los calendarios definen reglas para fechas que se aplican en tareas para que se ejecuten
o no cuando se espera. Por ejemplo, se puede crear un objeto de calendario llamado
LastOpenDayofMonth y utilizarlo para planificar copias de seguridad completas e
informes mensuales el último día disponible de cada mes.
Después de definir objetos de calendario, utilícelos en objetos de planificación para
determinar cuándo se ejecutan las tareas. La planificación de tareas o procesos para que
se ejecuten en determinados días requiere un objeto de planificación. Las
planificaciones coordinan el momento de inicio de tareas o procesos a través de las
fechas válidas definidas por un calendario.
Se pueden crear varios calendarios y asociar cualquier calendario individual con
cualquier número de tareas planificadas. La separación de calendarios de las
planificaciones permiten definir reglas comunes para fechas que se pueden reutilizar en
muchos contextos de planificación. Para cambiar las reglas (por ejemplo, aquellas que
representan días inactivos) de todas las tareas que utilizan (incluidas o excluidas) un
calendario, edite el calendario que describe esas fechas. Las planificaciones aplican
automáticamente los cambios que se producen en un calendario.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 391
Calendarios
Creación de un objeto de calendario
Se puede crear un objeto de calendario en cualquier carpeta en el explorador de
bibliotecas.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en una carpeta.
3.
En la barra de herramientas, haga clic en Nuevo, seleccione Objeto y, a
continuación, elija Calendario.
Aparecerá un nuevo objeto de calendario
4.
Haga clic en el nombre del calendario para renombrarlo.
5.
Haga doble clic en el calendario para editarlo.
Se abre el diseñador de calendarios.
6.
Defina las reglas del calendario que la aplicación utiliza para crear un calendario de
fechas incluidas y excluidas. Elija una de las siguientes opciones:
■
Haga clic en la ficha Básica para definir reglas básicas.
■
Haga clic en la ficha Avanzada para definir reglas avanzadas.
392 Guía del diseñador de contenido
Calendarios
El Diseñador de calendario básico
El diseñador de calendarios se abre cuando se edita un objeto de calendario. Utilice la
ficha Básica para definir rápidamente reglas que generen fechas incluidas. A
continuación se pueden excluir ciertas fechas. Otro enfoque consiste en crear un
calendario independiente específicamente para las fechas excluidas que se desea aplicar
y gestionar aparte.
Elemen Descripción:
to:
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 393
Calendarios
Elemen Descripción:
to:
Repetición de regla de calendario: seleccione una opción que represente el patrón de repetición de las
fechas del calendario que desee definir. Las opciones incluyen diariamente, semanalmente,
mensualmente y anualmente, o bien sus propias fechas seleccionadas manualmente. También se puede
definir un intervalo de fechas o establecer la regla para que se repita indefinidamente.
Valores de configuración detallados: Esta parte de la ficha Básica basa su aspecto en la selección
efectuada de la regla de calendario. Por ejemplo, una repetición semanal da lugar a valores de
configuración detallados para los días de la semana y las semanas del mes. Otro ejemplo sería una
repetición mensual que muestra valores de configuración para días específicos del mes.
Resumen de fechas incluidas y excluidas: esta área incluye todos los días de su regla de calendario.
Desactive la casilla de verificación de una fecha para excluirla del calendario.
El Diseñador de calendarios avanzados
Las reglas de un calendario avanzado son estructuras de árbol jerárquicas. La ficha
Avanzada para un objeto de calendario siempre muestra tres conjuntos de reglas de
calendario:
■
Fechas incluidas manualmente
■
Fechas excluidas manualmente
■
Regla de calendario
Estos tres elementos de raíz para una regla de calendario son fijos. Estos tres conjuntos
no se pueden suprimir. Defina reglas creando condiciones de fecha en los elementos de
raíz. Una regla de calendario combina operadores de fecha (como día del mes, mes del
año o semana del año) con operadores lógicos (Intersección, Unión, Exclusión e Igual).
La regla de calendario es, en realidad, el operador de raíz Unión para todas las reglas de
calendario.
Empiece a construir una regla de calendario arrastrando una regla ordenada por icono
bajo Todas las reglas al conjunto de Regla de calendario. También se puede incluir o
excluir fechas manualmente.
Después de colocar una regla bajo Reglas de calendario, configure sus propiedades.
Las propiedades para un objeto de condición de fecha en una regla de calendario
también tienen propiedades que se pueden expandir para configurar la condición de
fecha, como las propiedades Intervalo de mes.
394 Guía del diseñador de contenido
Calendarios
Por ejemplo, si las propiedades de intervalo de meses se configura en "3", especifica
que cada tercer mes en un año es válido. Debido a que el intervalo se inicia en enero y
termina en diciembre, este intervalo de tres meses se repite a lo largo del año. Esta
regla define una condición para realizar tareas cada trimestre.
La ilustración siguiente muestra esta condición en una regla y agrega una condición que
especifica el quinto día de cada mes. El operador de intersección se comporta como un
Y lógico para combinar estas dos condiciones en una sola regla que especifica el quinto
día de cada trimestre.
Ejemplo: Cree una regla que especifique el quinto día de cada trimestre
1.
Arrastre el operador Intersección a Regla de calendario.
2.
Arrastre Intervalo de mes bajo Intersección.
3.
Haga clic en el operador Intervalo de mes. Defina un Intervalo de mes de enero a
diciembre con Paso fijado en 3.
4.
Arrastre un operador Intervalo de día bajo Intersección y especifique un intervalo
de 5 a 5 con Paso establecido en 1.
5.
Para guardar los cambios en la versión de trabajo del objeto Calendario, haga clic en
Guardar y Cerrar.
6.
Para probar el Calendario, haga clic en la ficha Vista previa.
Puede continuar agregando operadores adicionales y condiciones para definir una regla
aún más. La jerarquía lógica define el orden en el cual se aplican las condiciones.
En términos de una ecuación booleana, uno se puede imaginar el objeto Calendario
rodeado por paréntesis incluyentes y aplicando restricciones booleanas para subordinar
operadores y condiciones.
■
El operador de unión aplica un booleano O para subordinar operadores y
condiciones.
■
El operador de intersección aplica un booleano Y para subordinar operadores y
condiciones.
■
El operador de exclusión aplica un booleano NO a una condición excluida.
■
El operador Igual inserta otra regla de calendario en una ecuación, de modo que se
puede considerar como la inserción de una función booleana creada por el usuario.
Una regla de calendario o combinación de reglas de calendario pueden dominar
prácticamente cualquier problema de planificación.
Tenga en cuenta que, según las necesidades de un problema de planificación concreto,
hay varias formas de construir reglas de calendario. También se puede definir un
conjunto de fechas en un calendario aparte. Se puede utilizar un operador Igual para
especificar el objeto de calendario y agregarlo directamente bajo la regla de calendario.
También se puede utilizar un operador Unión, Intersección o Exclusión para incluir un
operador Igual en una regla de calendario.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 395
Calendarios
Operadores lógicos Regla de calendario
Utilice los cuatro operadores de conjunto lógicos para incluir y excluir fechas en reglas
de calendario. Los operadores Unión, Intersección y Exclusión proporcionan una manera
de incluir y excluir fechas representadas por condiciones de fecha básicas o por
combinaciones de ramificación de condiciones y operadores. La lista siguiente describe
cada operador lógico:
Unión
Indica que una o más condiciones vinculadas deben cumplirse para que se cumpla
la condición combinada.
Coloque una o más ramas o condiciones básicas bajo este icono.
Intersección
Indica que las condiciones vinculadas deben cumplirse para que se cumpla la
condición combinada.
Coloque una o más ramas o condiciones básicas bajo este icono.
Exclusión
Indica una condición básica o una rama que debe excluirse de una regla.
Se excluyen todas las fechas que, de otro modo, no se seleccionan. Por lo tanto,
sólo es útil excluir días cuando están seleccionados en otra parte de la regla. Por
ejemplo, no se sirve ninguna finalidad al excluir los días martes a menos que otras
condiciones y operaciones en una regla los definan como días válidos. Así, si una
condición especifica los días laborables (lunes a viernes) como días válidos, podría
utilizar el operador Exclusión para excluir martes de este conjunto.
Expanda el operador Exclusión para mostrar las ramas Incluido y Excluido.
Haga clic en una rama y luego agregue una condición o un operador para definir
fechas incluidas o excluidas. Este operador tiene dos conjuntos de argumentos
ramificados:
Incluido: Una o más condiciones básicas o ramas que representan fechas que incluir
en la regla.
Excluido: Una o más condiciones básicas o ramas que representan fechas que
excluir del conjunto de fechas definido por el conjunto Incluido.
Igual
Utilice el operador Igual para utilizar un conjunto de fechas existente definido por
otro objeto de calendario en la regla. Este operador tiene los parámetros
siguientes:
Nombre de calendario: El nombre del calendario al cual se hace referencia.
396 Guía del diseñador de contenido
Calendarios
Diferencia: Cambia las fechas válidas definidas por el Calendario al cual se hace
referencia por el número de días especificado. Introduzca un número negativo para
mover las fechas a más temprano o un número positivo para mover las fechas a
más tarde.
Días de apertura: Cuando está seleccionada esta opción, indica que la diferencia o
turno solamente se aplica a los días de apertura.
Por ejemplo, una nueva regla de calendario podría hacer referencia a otro
calendario que especifica días de copia de seguridad con una diferencia de 1. La
condición en la nueva regla de calendario especifica el día que sigue
inmediatamente a los días de copia de seguridad.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 397
Calendarios
Operadores Fecha de regla de calendario
Esta sección describe las condiciones elementales sobre fechas y sus parámetros. Las
condiciones se pueden colocar en el panel de regla del Diseñador de calendario. Para
seleccionar una fecha en las propiedades de un operador, haga clic en el icono de
calendario para abrir el visor de calendarios y seleccionar una fecha.
Lista Fechas
Especifica fechas individuales. Por ejemplo:
■
1 de marzo de 2014
■
15 de julio de 2014
■
23 de septiembre de 2015
Parámetros
■
Una lista de fechas con años.
■
Para agregar una fecha, haga clic en el botón Agregar fecha.
■
Para suprimir una fecha de la lista, selecciónela y, a continuación, haga clic en
el botón Suprimir fecha.
■
Haga clic en los botones Mover hacia arriba o Mover hacia abajo para
reorganizar las fechas de la lista.
Intervalo de fechas
Especifica un intervalo diario, semanal o mensual periódico en un intervalo de
fechas de inicio a fin.
Por ejemplo, todas las semanas desde el 1 de marzo de 2015 hasta el 1 de julio de
2016.
Parámetros
■
Inicio: Fecha inicial del intervalo.
■
Fin: Fecha final del intervalo.
■
Repetir para siempre: Marque esta casilla para omitir la Fecha de finalización y
extender el intervalo indefinidamente.
■
Paso: Indica la cantidad de unidades (días, semanas o meses) de cada intervalo.
Por ejemplo, un intervalo con una unidad de semana y un paso
predeterminado de 1 ocurre una vez en la semana 1 otra vez en la semana 2 y
una tercera vez en la semana 3. Cuando Paso se establece como 3, el intervalo
ocurre una vez en las semanas 1 a 3 otra vez en las semanas 4 a 6 y una tercera
vez en las semanas 7 a 9.
■
Unidad: Especifica la frecuencia de repetición o intervalo. Seleccione Día,
Semana o Mes.
Lista de fechas sin año
398 Guía del diseñador de contenido
Calendarios
Especifica la lista con fechas explícitas de aniversario.
Por lo general, esta condición se utiliza para especificar días festivos que acontecen
el mismo día de cada año. Por ejemplo: 1 de enero y 25 de diciembre.
Parámetros
■
Especifica una lista de fechas sin años.
■
Para agregar una fecha, haga clic en el botón Agregar parámetro (+). Haga clic
en el botón Examinar (...) del parámetro nuevo para abrir el control de
calendario Seleccionar fecha y seleccione una fecha.
■
Para eliminar una fecha de la lista, selecciónela y, a continuación, haga clic en
el botón Suprimir parámetro (x). Puede hacer clic en los botones Mover hacia
arriba o Mover hacia abajo para reorganizar las fechas de la lista.
Fecha sin intervalo de año
Especifica un intervalo de fechas de aniversario sin incluir un año.
Por ejemplo, del 21 de marzo al 20 de junio (para la primavera).
Parámetros
■
Inicio: Fecha inicial sin un año para el intervalo.
■
Fin: Fecha final sin un año para el intervalo.
Intervalo de año
Especifica un intervalo de años.
Puede especificar años bisiestos si comienza el intervalo en un año bisiesto y
especifica un salto de 4 (de 2000 a 2024 con un salto de 4).
Parámetros
■
Inicio: Año inicial del intervalo.
■
Fin: Año final del intervalo.
■
Paso: Número de años desde un año válido al año válido siguiente.
Intervalo de mes
Especifica uno o más meses en el año.
El primer semestre se especifica con un intervalo de 1 a 6 con un paso de 1. El
segundo semestre se especifica con un intervalo de 7 a 12 con un paso de 1.
Parámetros
■
Inicio: Mes inicial del intervalo.
■
Fin: Mes final del intervalo.
■
Paso: Número de meses desde un mes válido al mes válido siguiente.
Intervalo de semana del mes
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 399
Calendarios
Especifica una o más semanas en el mes.
CA Process Automation implementa estándares ISO durante semanas parciales. Una
semana que se cruza con un mes dado se considera parte del mes si el jueves de
esa semana cae en el mes.
Por ejemplo, si el 1 de junio es un viernes, la primera semana del mes empieza el 4
de junio. Si el 1 de junio es miércoles, la primera semana del mes empieza el 30 de
mayo.
Es posible que el "primer lunes del mes" no sea el "lunes de la primera semana del
mes." Para definir el anterior, es más sencillo combinar las condiciones "día del
mes" y "día de la semana".
Parámetros
Inicio: Semana inicial del intervalo.
Fin: Semana final del intervalo.
Paso: Número de semanas desde una semana válida a la próxima semana
válida.
Revertir: El recuento empieza en la última semana del mes y va hacia atrás.
Intervalo de semana del año
Especifica una o más semanas en el año.
CA Process Automation implementa estándares ISO para semanas parciales. Una
semana que se cruza con un año dado se considera parte del año si el jueves de esa
semana cae en el año.
Por ejemplo, si el 1 de junio es un viernes, la primera semana del mes empieza el 4
de junio. Si el 1 de enero es un miércoles, la primera semana del año empieza por el
30 de diciembre del año anterior.
Es posible que el "primer lunes del año" no sea el "lunes de la primera semana del
año." Para definir el anterior, es más sencillo combinar las condiciones "día del año"
y "día de la semana".
Parámetros
Inicio: Semana inicial del intervalo.
Fin: Semana final del intervalo.
Paso: Número de semanas desde una semana válida a la próxima semana
válida.
Revertir: El recuento empieza con la última semana del año y va hacia atrás.
Intervalo de día
Especifica un intervalo de días válidos (entre 1 y 31) en un mes con una día inicial,
un día final y un salto.
400 Guía del diseñador de contenido
Calendarios
Se puede especificar también que la iteración se inicie al final del mes o que se
cuentan solamente días de apertura en cada paso. Los días de apertura son
aquellos que no son especificados por una condición o regla que cierra o excluye
fechas.
Por ejemplo, el intervalo que se inicia y finaliza con 1 con Revertir seleccionado,
especifica el último día del mes. El último día laborable del mes se especificaría
cuando se selecciona también la casilla de verificación Abrir y se agrega un intervalo
de Día laborable que especifica que de lunes a viernes se agrega con un operador Y.
Parámetros
Inicio: Día inicial del intervalo.
Fin: Día final del intervalo.
Paso: Número de días desde un día válido al próximo día válido.
Revertir: El recuento empieza con el último día del mes y va hacia atrás.
Días de apertura: El recuento de pasos incluye solamente los días de apertura
cuando los días están cerrados por una condición o una regla.
Intervalo de día del año
Especifica un intervalo de días válidos (entre 1 y 366) en un año con un día inicial,
un día final y un salto. El día 366 es válido en años bisiestos.
Se puede especificar también que la iteración se inicie al final del año o que se
cuentan solamente días de apertura en cada paso. Los días de apertura son
aquellos que no son especificados por una condición o regla que cierra o excluye
fechas.
Por ejemplo, se puede especificar el invierno como el intervalo del 21 de diciembre
al 20 de marzo.
O para un ejemplo un poco más complicado, para especificar cada 10º día a lo largo
del año entero, podría utilizar un intervalo de 1 a 365 (o 366 para un salto) con un
paso de 1. Podría especificar los últimos diez días de apertura del año con un día
inicial de 1, un día final de 10, con Revertir y Abrir seleccionado.
Parámetros
Inicio: Día inicial del intervalo.
Fin: Día final del intervalo.
Paso: Número de días desde un día válido al próximo día válido.
Revertir: El recuento empieza desde el último día del año y va hacia atrás.
Abiertos: El recuento de pasos incluye solamente los días de apertura.
Intervalo de día de la semana
Especifica uno o más días de la semana (de lunes a domingo) como intervalo con un
día inicial, un día final y un salto.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 401
Calendarios
Por ejemplo, el intervalo que empieza el sábado y que termina el domingo con un
paso de 1 especifica los fines de semana.
Parámetros
Inicio: Día inicial del intervalo.
Fin: Día final del intervalo.
Paso: Número de días desde un día válido al próximo día válido.
Día laborable del mes
Especifica un día laborable en una semana indexada de un mes en particular. La
semana se indexa desde los primeros días del mes o desde los últimos.
Parámetros
Día laborable: Especifica el día de la semana.
Mes: Especifica el mes al que corresponde el día laborable.
Índice de semana: Especifica el índice de la semana que corresponde al día
laborable. (El valor puede ser de 1 a 5 porque en cualquier mes que no puede haber
más de 5 semanas)
Revertir: Si se selecciona esta casilla de verificación, el recuento para el índice de
semana se inicia desde la última semana.
Por ejemplo, si selecciona lunes como un día laborable, septiembre como un mes y
3 como un Índice de semana: en septiembre, el tercer lunes se incluye en el
calendario. Si seleccionó la casilla de verificación Revertir, en septiembre, el tercer
lunes del último se incluye en el calendario.
Día laborable del año
Especifica un día laborable en una semana indexada del año. La semana se indexa
desde los primeros días del año o desde los últimos.
Parámetros
Día laborable: Especifica el día de la semana.
Índice de semana: Especifica el índice de la semana al que corresponde el día
laborable. (El valor puede ser de 1 a 53 porque en un año no puede haber más de
53 semanas)
Revertir: Si se selecciona esta casilla de verificación, el recuento de índice de
semana se inicia desde la última semana.
Por ejemplo, si selecciona lunes como un día laborable, 43 como el Índice de
semana, el lunes número cuarenta y tres del año se incluye en el calendario. Si
seleccionó la casilla de verificación Revertir, el lunes número cuarenta y tres de la
última semana se incluye en el calendario.
402 Guía del diseñador de contenido
Calendarios
Cómo agregar y eliminar fechas de calendario manualmente
En ocasiones pueden ser necesarias fechas en un objeto de calendario que no se
especifican fácilmente mediante una regla de calendario. De igual modo, una regla
puede incluir fechas que, por algún motivo, no desea en un calendario. Se puede utilizar
Fechas incluidas manualmente y Fechas excluidas manualmente en el panel Reglas de
calendario seleccionadas para agregar o eliminar fechas seleccionadas manualmente.
Para agregar o eliminar fechas
1.
Abra un calendario.
2.
Haga clic en la ficha Avanzada.
3.
Expanda Fechas incluidas manualmente o Fechas excluidas manualmente.
4.
En el visor de meses del panel de Propiedades, haga clic con el botón secundario del
ratón sobre una fecha seleccionada y luego haga clic sobre uno de los comandos de
incluir o excluir fecha en el menú de acceso directo.
■
Para incluir fechas específicas durante un año en particular, haga clic en el
comando Incluir fecha completa.
■
Para incluir fechas de aniversario para todos los años, haga clic en el comando
Incluir fecha de aniversario.
■
Para excluir fechas específicas durante un año en particular, haga clic en el
comando Incluir fecha completa.
■
Para excluir fechas de aniversario para todos los años, haga clic en el comando
Incluir fecha de aniversario.
El comando Incluir fecha completa solamente está disponible cuando se
seleccionan fechas excluidas en el panel. El comando Excluir fecha completa
solamente está disponible cuando se seleccionan fechas incluidas en el panel.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 403
Calendarios
El Diseñador de calendario: Ficha Vista previa
Utilice la ficha Vista previa para inspeccionar las fechas que se deben incluir en un
calendario o excluir de él.
También se pueden comparar las fechas de un calendario con las fechas de un segundo
calendario. Por ejemplo, defina un calendario de trabajo estándar en el que se omitan
los días de vacaciones o festivos definidos en otro calendario de exclusión. Se puede
mostrar una vista previa de cómo afectaría el calendario de exclusión al calendario de
trabajo estándar mientras lo edita.
404 Guía del diseñador de contenido
Calendarios
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 405
Calendarios
Elemen Descripción:
to:
Ficha Vista previa y año: después de definir un calendario en la ficha Básica o Avanzada, haga clic en la
ficha Vista previa para consultar las fechas. Haga clic en Año anterior, Año siguiente o seleccione un
año.
Fechas incluidas: este panel muestra todas las fechas incluidas en la configuración de la regla de
calendario.
Visualizar previamente el calendario de exclusión: (Opcional) Seleccione un calendario separado para
mostrar los conflictos en rojo y en negrita en la vista previa del calendario.
Fechas incluidas: la vista previa del calendario muestra las fechas incluidas en el calendario con
números escritos en azul oscuro y en negrita.
Fechas excluidas: la vista previa del calendario muestra las fechas que se han omitido manual o
automáticamente de las reglas del calendario. Estas fechas aparecen con los números escritos en azul
claro.
Fechas en conflicto: la vista previa del calendario muestra las fechas superpuestas o que están en
conflicto con las fechas definidas en un calendario de exclusión opcional. Las fechas están escritas en
rojo y en negrita.
Campos resolución del conflicto: utilice el campo Diferencia para especificar el número de días que una
fecha elegible se mueve cuando cae en una fecha omitida o excluida. Un valor de diferencia negativo
cambia hacia delante (más temprano) y un valor positivo cambia hacia atrás (más tarde). Cuando este
valor es cero (el valor predeterminado), la fecha elegible, normalmente incluida en la regla de
calendario, se muestra en color rojo y en negrita y se omite.
Seleccione la casilla de verificación Días de apertura para trabajar únicamente con los días incluidos al
cambiar la planificación para evitar el uso de fechas excluidas u omitidas. Los días de apertura son
aquellos que no están incluidos en una condición o regla que omita o excluya fechas. Si no se selecciona
la casilla de verificación Días de apertura, es posible que, al cambiar una fecha, se seleccione un día
excluido u omitido.
Utilice el campo Máx. de cambios para definir el número máximo de cambios o ajustes que se deben
permitir si los cambios repetidos caen en días de cierre.
Excluir calendario
Los días cerrados son esos días en los cuales no se puede realizar un grupo de tareas
planificadas. Se pueden especificar días cerrados dentro de un calendario (por ejemplo,
los fines de semana están cerrados implícitamente cuando una regla especifica días
laborables) o en un calendario de vacaciones aparte. Un calendario de vacaciones se
crea con reglas que especifican fechas válidas, al igual que cualquier otro calendario. Si
se especifica un calendario como vacaciones o un calendario de exclusión se cierran
fechas que de otro modo se definirían como fechas válidas para realizar tareas.
406 Guía del diseñador de contenido
Planificaciones
Por ejemplo, ciertas tareas no se pueden realizar durante las vacaciones de la compañía.
En este caso, se crea un calendario que especifica las vacaciones de la empresa como
fechas válidas. A continuación, para cada tarea de una planificación que se desea omitir
en las vacaciones de la empresa, especifique el calendario de vacaciones de la empresa
como Excluir calendario. Las vacaciones de la compañía se cierran para esas tareas.
Planificaciones
Los objetos Planificación permiten configurar cuándo se deben ejecutar las tareas del
proceso o del operador. Especifique días válidos en la planificación o que hagan
referencia a objetos de calendario definidos previamente. Los objetos Planificación
permiten agrupar, coordinar y planificar cuándo se deben ejecutar las tareas
relacionadas con los elementos organizativos o arquitectónicos de una empresa. Por
ejemplo:
■
Aplicaciones
■
Propiedad
■
Monitorización
■
Mantenimiento
■
Procesos funcionales
Los objetos de planificación especifican:
■
Las tareas (procesos y operadores) que se van a ejecutar
■
La hora del día en que se inicia cada tarea
■
El intervalo de repetición para varias incidencias de una tarea
■
Los días en que se inician las tareas (mediante un calendario, especificando días
explícitos o una combinación de ambos)
■
Los días en que no está permitido iniciar tareas (mediante calendarios de
vacaciones y especificando días excluidos)
■
La hora del día en que finaliza cada tarea
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 407
Planificaciones
Se puede crear una planificación con o sin especificar un calendario. Los procesos y
otras tareas que se ejecutan todos los días o en días especificados no requieren un
objeto de calendario. Para planificar fechas usando reglas de calendario:
1.
Cree objetos de calendario.
2.
Especifique los calendarios en los objetos de planificación.
Los calendarios definen reglas que especifican fechas válidas para realizar tareas y días
de cierre en los cuales las tareas no se pueden ejecutar. Los objetos de planificación
asocian tareas relacionadas operativamente con un calendario y especifican las horas en
las que se ejecutan las tareas en los días válidos que definen las reglas de calendario.
Equation 2: En este gráfico se resaltan las funciones principales de la página
Planificaciones.
408 Guía del diseñador de contenido
Planificaciones
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 409
Planificaciones
Elemen Descripción:
to:
Editor de planificaciones: cuando se abre una planificación desde el explorador de bibliotecas, aparece
el cuadro de diálogo Planificación. Utilice la barra de herramientas para activar, establecer la validez,
introducir o guardar la planificación. Haga clic en cualquiera de las cinco fichas, incluida la del Editor de
planificaciones.
Panel Procesos: seleccione los procesos que se van a incluir y arrástrelos hasta la lista Planificar
elementos.
Proceso planificado: defina la duración y la frecuencia de ejecución del proceso en un solo día desde las
24:00 a las 23:45 horas.
Propiedades de proceso: haga clic en Propiedades para ver las propiedades del proceso en las fichas
General y Específico.
Panel Operadores: seleccione los operadores que se van a incluir y arrástrelos hasta la lista Planificar
elementos.
Propiedades del operador: haga clic en Propiedades para ver las propiedades del operador en las fichas
General y Específico.
Creación de un objeto de planificación
Para crear un objeto de automatización en CA Process Automation, consulte Creación
de un objeto (en la página 70).
410 Guía del diseñador de contenido
Planificaciones
Planificación de un proceso y tareas de operador
Se puede configurar un proceso u operador para ejecutarse como una sola tarea o una
serie de tareas en una planificación. La diferencia entre especificar un operador como
tarea en una planificación y especificar un operador en un proceso es que el operador
planificado se inicia a una hora planificada más que como paso de un proceso. También
se puede planificar cualquier proceso para que se inicie mediante un operador Iniciar
proceso en una planificación.
Lleve a cabo los pasos siguientes:
1.
En la Biblioteca, haga doble clic en un objeto de Planificación.
2.
En el Editor de planificaciones, identifique los procesos y los operadores que se
desea planificar.
3.
Expanda el panel Procesos u Operadores y arrastre cualquier proceso u operador
disponible a la lista Planificar elementos. También se puede hacer clic con el botón
secundario del ratón en un proceso u operador y elegir Agregar.
4.
Para cada elemento, complete los campos siguientes:
Hora de inicio
La hora a la que una tarea empezará a ejecutarse en días planificados.
Intervalo de repetición (minutos)
Indica si una tarea deberá ejecutase repetidamente entre una hora de inicio y
una hora de finalización, y, en este caso, con qué frecuencia. Por ejemplo, cada
2 minutos o cada 120 minutos (2 horas). Para cada vez que se repite la tarea se
crea una nueva instancia de la tarea. Especifique la cantidad de minutos entre
un inicio y otro en el campo adyacente (minutos). Por ejemplo, el valor 120 en
la casilla de minutos repite una tarea cada dos horas.
Asegúrese de que la hora de finalización sea posterior a la última hora a la que
desee que el operador vuelva a ejecutarse. Por ejemplo, una tarea puede
configurarse como sigue:
■
La hora de inicio es a las 24:00 horas
■
La casilla de verificación Intervalo de repetición está activada
■
El campo (minutos) está configurado como 120 minutos
■
La hora de finalización es a las 16:00 horas
Estos valores de configuración planifican el proceso u operador para iniciarse
por primera vez a las 24:00 horas, repetirse cada dos horas y ejecutarse por
última vez antes de las 16:00 horas.
Hora de finalización
Para una tarea que se repite, la hora a la que la tarea deja de repetirse en
cualquier día planificado.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 411
Planificaciones
5.
Llegado a este punto, ha planificado una tarea para que se repita cada día desde la
hora de inicio especificada hasta la hora de finalización especificada y en el
intervalo especificado. Continúe con los pasos restantes sólo si es necesario editar
en detalle las fechas planificadas o las propiedades.
6.
Expanda un grupo de elementos o haga clic en Propiedades.
Aparecen las fichas General y Específico.
7.
En la ficha General:
a.
Expanda Valores de configuración de calendario y seleccione de los campos
siguientes:
■
Sólo lo que se ha seleccionado manualmente: solamente se consideran las
fechas planificadas manualmente. Cuando no se especifica ningún
calendario en un elemento planificado, se considera que el elemento se
planifica cada día, excepto cuando se selecciona esta opción. Cuando esta
opción está seleccionada, las fechas de ejecución deben planificarse
explícitamente en Incluidas manualmente o Excluidas manualmente, o en
ambas.
■
Incluir calendario: un objeto de calendario que planifica fechas para
ejecutar la tarea.
■
Excluir calendario: un objeto de calendario de vacaciones que especifica
los días de cierre en los cuales no se ejecutan tareas. La ruta completa del
calendario solía especificar días de cierre (esos en los cuales una tarea se
puede no planificar). No hay ningún día de cierre cuando no hay ningún
calendario de vacaciones que se especifique aquí.
■
Días por cambio: activa reglas que cambian las fechas en que se ejecutan
las tareas cuando una fecha especificada por el objeto de calendario cae
en una fecha de cierre. El número de días para cambiar una fecha
planificada cuando la fecha planificada cae en una fecha de cierre. El turno
puede ser negativo o cero. Cuando este valor es negativo, la fecha se
cambia hacia más adelante. Cuando este valor es cero, las fechas de cierre
se omiten sencillamente sin reprogramar la tarea.
■
No hay días excluidos: seleccione esta casilla de verificación para contar
solamente los días de apertura cuando se cambia la fecha planificada para
evitar una fecha de cierre.
■
Núm. máximo de cambios: cuando se replanifica una tarea porque la
fecha planificada original cae en un día de cierre, es posible que la nueva
fecha también caiga en una fecha de cierre. Este parámetro define el
número máximo de cambios que se permiten. Esta situación no ocurre
cuando la casilla No hay días excluidos está seleccionada.
b. Expanda Fechas incluidas manualmente para obtener una lista de fechas
individuales que incluir en la planificación.
c.
Expanda Fechas excluidas manualmente para obtener una lista de fechas
individuales que excluir de calendarios de fechas incluidas especificadas
previamente.
412 Guía del diseñador de contenido
Planificaciones
d. Expanda Nombre de la tarea para escribir un nombre más significativo para la
tarea.
8.
Haga clic en la ficha Específico y expanda los grupos de campos que varían por
operador o proceso. Para un proceso, aparecen los grupos Iniciar proceso y
Configuración de ejecución. Para un operador, aparecen Configuración de ejecución
y otros parámetros. Configure los campos.
9.
Para establecer un intervalo de fechas válido para la planificación entera, haga clic
en Validez. Especifique una fecha lejos en el futuro, como el 31/12/2050, para
continuar evaluando fechas indefinidamente o hasta que la agenda se desactive
manualmente.
10. Para suprimir una tarea, haga clic en la X en el borde derecho.
11. Haga clic en Activar para iniciar los elementos planificados.
12. Haga clic en Incorporar y, a continuación, cierre el cuadro de diálogo Planificación.
13. Monitorice los elementos planificados en la ficha Operaciones.
Vista previa de todas las instancias de una tarea planificada
Se puede mostrar la vista previa de las instancias planificadas de una tarea para un día
específico. Cuando se configura una tarea para que se repita un día concreto, la
aplicación realiza un seguimiento de cada instancia de la tarea. Por ejemplo, si una tarea
se repite cada 10 minutos durante media hora, la vista previa mostrará 3 instancias.
Utilice este procedimiento para planificar una tarea en una fecha futura o para ver los
resultados de tareas planificadas en una fecha específica en el pasado.
Lleve a cabo los pasos siguientes:
1.
En el cuadro de diálogo Planificación, haga clic en la ficha del editor de planificación
para configurar la lista de elementos planificados en el período entero de validez.
2.
Haga clic en la ficha Vista previa. Si su tarea se repite, en la ficha Vista previa
aparecerán varias instancias del mismo día.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 413
Planificaciones
3.
En la ficha Vista previa:
a.
En el campo Fecha de vista previa, seleccione una fecha en el intervalo válido
para la planificación.
b. En la lista desplegable Nodos, seleccione Todos los nodos o un punto de
contacto de orquestador concreto.
c.
Seleccione las opciones Actual o Archivado.
d. Haga clic en Actualizar.
La aplicación evalúa las reglas de calendario y el período de validez que está
asociado a las tareas antes de mostrar las instancias adecuadas en una lista.
■
Cuando se selecciona una fecha pasada, la ficha Vista previa incluye las tareas
iniciadas, su estado, la hora de inicio y la hora de finalización.
■
Cuando se selecciona la fecha actual, la ficha Vista previa indica si se han
iniciado instancias y su estado y la hora de inicio y finalización.
■
Cuando se selecciona una fecha futura, la ficha Vista previa incluye todas las
instancias correspondientes a la fecha seleccionada si la planificación está
activa en el punto de contacto seleccionado.
4.
Haga doble clic en una instancia para ver el panel Propiedades de solo lectura, que
muestra los valores de configuración de la tarea.
5.
Haga clic en la ficha Editor de planificaciones para realizar cambios en la
planificación.
6.
Para establecer un intervalo de fechas válido para toda la planificación, haga clic en
Validez.
7.
Haga clic en Activar para iniciar los elementos planificados.
8.
Haga clic en Incorporar y, a continuación, cierre el cuadro de diálogo Planificación.
9.
Monitorice los elementos planificados en la ficha Operaciones.
Uso de planificaciones
Una planificación se debe activar e incorporar para poder utilizarla. Se puede activar una
planificación en el punto de contacto de orquestador específico donde reside. Cuando
una planificación está activa en varios puntos de contacto se comporta como una
instancia independiente en cada punto de contacto. Esto le permite planificar las
mismas tareas en varios equipos simultáneamente. Algunos ejemplos de este tipo de
tareas incluyen: la clasificación de los registros, la actualización e instalación del
software, y la copia de seguridad de los archivos.
Nota: Cuando se ejecuta una planificación, esta y los operadores de la misma usan
solamente las copias incorporadas de los objetos a los que hacen referencia.
414 Guía del diseñador de contenido
Planificaciones
Control de planificaciones activas
Después de activar una planificación, monitorícela mediante el vínculo Planificaciones
activas de la página Operaciones.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Operaciones.
2.
En la página Operaciones, expanda el panel Vínculos.
3.
Haga clic en Planificaciones activas.
4.
En la barra de herramientas, seleccione un orquestador y un entorno y, a
continuación, haga clic en Actualizar.
5.
En la tabla Planificaciones activas, haga doble clic en una planificación.
Se abre el cuadro de diálogo Planificación.
6.
En el cuadro de diálogo Planificación:
a.
Edite los elementos planificados. Consulte Planificación de un proceso y tareas
de operador (en la página 411).
b. En la barra de herramientas, haga clic en Activar para activar la planificación.
c.
En la barra de herramientas, haga clic en Desactivar para desactivar la
planificación. En la página Operaciones también se puede desactivar una
planificación.
Nota: Sus permisos asignados determinan si se puede enumerar, abrir o editar un
objeto de planificación específico. Un administrador de contenido o un propietario
de objetos de automatización puede cambiar los permisos de un objeto de
automatización.
7.
Haga clic en Incorporar o Guardar y Cerrar.
Monitorización de todas las instancias de todas las tareas planificadas
Se pueden monitorizar las instancias planificadas de todas las tareas de un día
específico. Cuando se configura una tarea para que se repita varias veces al día durante
varios días, CA Process Automation realiza un seguimiento de cada instancia de la tarea.
Por ejemplo, si una tarea se repite cada 10 minutos durante media hora (3 instancias)
cada día durante 1 año, CA Process Automation realizará un seguimiento de las 1095
instancias. Utilice este procedimiento para planificar una tarea en una fecha futura o
para ver los resultados de todas las tareas planificadas en una fecha específica del
pasado.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Operaciones.
2.
Expanda el panel Vínculos en la página Operaciones.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 415
Planificaciones
3.
Haga clic en Planificaciones globales.
4.
En la barra de herramientas, seleccione un orquestador y un entorno y haga clic en
Actualizar.
5.
En la tabla de Planificaciones globales:
a.
En el campo Fecha de vista previa, seleccione una fecha en el intervalo válido
para la planificación.
b. En la lista desplegable Nodos, seleccione Todos los nodos o un punto de
contacto de orquestador concreto.
c.
Seleccione las opciones Actual o Archivado.
d. Haga clic en Actualizar.
CA Process Automation evalúa las reglas del calendario y el período de validez que
está asociado a las tareas antes de mostrar las instancias adecuadas en la lista. Si la
tarea se repite, se mostrarán varias instancias para el mismo día.
■
Cuando se selecciona una fecha pasada, la lista incluye las tareas iniciadas, su
estado y la hora de inicio y de finalización.
■
Cuando se selecciona la fecha actual, la lista indica si se han iniciado instancias,
su estado y la hora de inicio de finalización.
■
Cuando se selecciona una fecha futura, la lista incluye todas las instancias
correspondientes a la fecha seleccionada si la planificación está activa en el
punto de contacto seleccionado.
6.
Para ver la ventana Propiedades de solo lectura que muestra los valores de
configuración para la tarea planificada, haga doble clic la instancia adecuada.
7.
En la barra de herramientas:
■
Haga clic en Conjunto de datos para ver el conjunto de datos del operador o el
proceso.
■
Haga clic en En espera o Liberar la retención para mantener en espera o liberar
la instancia.
■
Haga clic en Restablecer para reiniciar una instancia.
416 Guía del diseñador de contenido
Gestión de tareas
Gestión de tareas
Se pueden gestionar tareas de CA Process Automation diseñando formularios de
interacción del usuario para permitir que los usuarios controlen tareas o proporcionen
entradas personalizadas. En la Lista de tareas de la página Operaciones o la lista Mis
tareas de la página principal, haga clic con el botón secundario del ratón en una tarea
para:
Responder
Modificar el proceso de alguna manera mediante un formulario en el cuadro de
diálogo Responder. Por ejemplo, se pueden cambiar los parámetros de campo o los
valores antes de hacer clic en Finalizar para completar la tarea.
Tomar
Asígnese provisionalmente la propiedad y responsabilidad totales de la tarea
pendiente.
Devolver
Para tareas con un estado Tomada solamente, libera la propiedad exclusiva de la
tarea. La tarea se devuelve a sus usuarios o grupos asignatarios o delegados.
Delegar
Asigna la tarea a un usuario o grupo secundario, conocido como un delegado.
Transferir
Asigna la tarea a un asignatario diferente.
Abrir instancia de proceso
Consulte la tarea en el contexto de la instancia de proceso padre y revise el diseño
del proceso.
Actualizar
Actualice la lista de tareas con los últimos cambios de todos los usuarios y la
actividad del sistema.
Propiedades
Consulte información adicional sobre la tarea incluyendo su descripción, fecha de
vencimiento, estado y sus asignatarios y delegados.
Asignación de una tarea a un usuario
Para crear una tarea, cree un proceso utilizando el operador Asignar tarea de usuario y,
a continuación, inícielo.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 417
Gestión de tareas
Al crear una tarea, se pueden especificar los siguientes atributos:
1.
Abra un proceso en el diseñador de procesos.
2.
En la paleta Operadores, expanda Control del proceso o busque el operador Asignar
tarea de usuario.
3.
Arrastre el operador Asignar tarea de usuario a su proceso.
4.
Haga doble clic en el operador Asignar tarea de usuario.
5.
En la paleta Propiedades:
a.
Expanda Asignatarios e introduzca los usuarios y grupos que asignar a esta
tarea.
b. Expanda Transferir/Delegar filtros para permitir la delegación de la tarea que
está restringida a usuarios o grupos específicos.
c.
Expanda Tarea de usuario y complete los campos siguientes:
Título
El título de la tarea.
Descripción
Una descripción de la tarea.
Formulario de solicitud de interacción
La ruta de la biblioteca correspondiente al formulario de solicitud de
interacción.
Código de inicialización de datos de formulario
Se puede escribir JavaScript para rellenar este campo.
Página Mostrar aprobación
Una casilla de verificación que especifica si se debe mostrar una pantalla
de aprobación al final del formulario de solicitud de interacción. El usuario
que trabaja en la tarea puede aprobarla o rechazarla mediante la página
de aprobación.
d. Expanda los siguientes grupos de propiedades de operador comunes para
especificar cualquier información de diseñador sobre el operador Asignar tarea
de usuario:
6.
■
Configuración de ejecución
■
Simulación
■
Información
En la barra de herramientas Diseñador, haga clic en Guardar.
418 Guía del diseñador de contenido
Gestión de tareas
La Lista de tareas
Se puede trabajar con tareas en la página principal o en la página Operaciones. La
página inicial muestra solamente el estado, el título, la descripción y los campos Fecha
de vencimiento en la conveniente tabla Mis tareas. Use la Lista de tareas en la página
Operaciones para consultar información más detallada sobre las tareas.
Las tareas se originan en procesos que incluyen un operador Asignar tarea de usuario y
un formulario de solicitud de interacción. Se puede clasificar la lista de tareas en orden
ascendente/descendente haciendo clic en los encabezados de las columnas. Utilice la
columna Estado para determinar si una tarea está pendiente, está completada,
aprobada, rechazada o tomada.
En la página Operaciones, se puede filtrar la lista de tareas para mostrar lo siguiente:
■
Solamente sus tareas (Mis tareas, las tareas asignadas al usuario actual)
■
Solamente las tareas asignadas a los grupos a los que pertenece
■
Todas las tareas
La lista de tareas de la página Operaciones muestra las columnas de campo siguientes
para cada tarea:
■
ID de tarea
■
Título
■
Descripción
■
Hora de inicio
■
Fecha de vencimiento
■
Fecha de finalización
■
Estado
■
Asignatarios
■
Delegados
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 419
Administración de disparadores
Administración de disparadores
Puede controlar los procesos con aplicaciones externas mediante cualquiera de los
métodos siguientes:
■
Disparadores
■
Servicios Web (SOAP)
■
Utilidad de la línea de comandos
■
Scripts
Se recomienda utilizar llamadas de SOAP en lugar de disparadores porque los servicios
Web son más sólidos. Las aplicaciones que no pueden hacer llamadas de SOAP pueden
utilizar disparadores como alternativa.
Los disparadores permiten que las aplicaciones externas inicien un proceso en CA
Process Automation. Un disparador invoca el proceso de CA Process Automation que se
define en el contenido XML o en un mensaje SNMP. El contenido XML puede enviarse a
la ubicación de archivo configurada o a la dirección de correo electrónico configurada. El
contenido del mensaje SNMP se puede enviar en un OID que coincide con una expresión
regular configurada. CA Process Automation escucha los mensajes SNMP entrantes en el
puerto de mensaje SNMP configurado, 162 de forma predeterminada.
Cuando inicia un proceso, como cuando ejecuta el operador Iniciar proceso o usa un
disparador o llamada SOAP, está actuando en nombre de algún usuario o propietario. En
el caso de disparadores o llamadas de SOAP, la información acerca del propietario de
contenido está en la carga útil o los mensajes. Esta información determina las versiones
de los objetos de automatización que se ejecutan:
■
Si extrae un proceso y, a continuación, lo ejecuta, llama o activa (es tanto el
propietario de contenido como el iniciador), CA Process Automation utiliza su
versión privada extraída.
■
De lo contrario, CA Process Automation utiliza las versiones actuales de los objetos
de automatización. Esto incluye procesos que no están extraídos ni extraídos por
otro usuario.
Puede ejecutar y verificar su propia versión extraída antes de incorporar los objetos de
nuevo o de hacer que sean los actuales.
420 Guía del diseñador de contenido
Administración de disparadores
Control de procesos desde una aplicación externa con llamadas de SOAP
El orquestador de CA Process Automation expone servicios Web que permiten a las
aplicaciones externas iniciar y controlar procesos en una biblioteca. Las llamadas de
SOAP requieren XML válido. Los métodos y parámetros expuestos de los servicios Web
se describen en el WSDL. Para obtener más detalles, recupere el WSDL desde la URL
apropiada del dominio en función de si CA Process Automation admite la comunicación
segura y está agrupado en clúster. En los ejemplos siguientes,
nombre_host_equilibrador_carga es el nombre de host o la dirección IP del equilibrador
de carga Apache.
■
Seguro y no agrupado en clúster:
https://<nombre_host_orquestador_dominio>:8443/itpam/soap?wsdl
■
No seguro y no agrupado en clúster:
http://<nombre_host_orquestador_dominio>:8080/itpam/soap?wsdl
■
Seguro y agrupado en clúster:
https://<nombre_host_equilibrador_carga>:<puerto_seguro_Apache>/itpam/soap?ws
dl
Nota: El puerto seguro de Apache suele ser 443.
■
No seguro y agrupado en clúster:
http://<nombre_host_equilibrador_carga>:<puerto_seguro_Apache>/itpam/soap?wsd
l
Nota: El puerto no seguro de Apache suele ser 80.
Para los scripts de muestra que utilizan llamadas de SOAP al orquestador de CA Process
Automation para iniciar procesos, vaya a la siguiente carpeta:
<directorio_instalación>/server/c2o/.c2orepository/public/scripts/trigger
Nota: La ruta del <directorio_instalación> suele ser C:\Archivos de
programa\CA\PAM.
La subcarpeta Java contiene una herramienta basada en Java y todos los recursos que la
herramienta requiere para iniciar procesos de CA Process Automation de forma remota
mediante SOAP. La ruta a la subcarpeta Java es la siguiente:
<directorio_instalación>/server/c2o/.c2orepository/public/scripts/trigger/jav
a
Cómo funcionan los disparadores de archivo y correo
Este tema proporciona una descripción de la secuencia de procesamiento de los
disparadores. Utiliza disparadores de archivo y correo como ejemplos.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 421
Administración de disparadores
Ejemplo de disparador de archivo y correo:
1.
A la frecuencia configurada, CA Process Automation busca nuevo contenido en la
carpeta configurada y en la cuenta de correo electrónico configurada.
2.
Si se encuentra un nuevo objeto de archivo o de correo, CA Process Automation
intenta ejecutar el proceso, en base al contenido XML.
Sigue una ilustración de contenido XML válido para el disparador de archivo:
3.
Cuando el disparador ejecuta el proceso especificado en la instancia de disparo, el
conjunto de datos de proceso se rellena con los valores contenidos en el XML. El
siguiente ejemplo muestra cómo se utilizan los valores en el contenido XML para
rellenar el conjunto de datos de proceso del disparador de archivo.
422 Guía del diseñador de contenido
Administración de disparadores
4.
Los resultados se envían a la carpeta procesada en la ruta configurada.
5.
Los correos electrónicos recibidos en la cuenta de correo electrónico configurada
son procesados prácticamente de la misma forma que el contenido XML recibido en
los archivos. Además, se envían correos electrónicos de confirmación, donde el
contenido afirma si el contenido XML se obtuvo del cuerpo del correo electrónico o
en un adjunto. El siguiente ejemplo muestra los dos mensajes:
Monitorizar el conjunto de datos del disparador de archivo de un proceso iniciado por un
disparador de archivo
Cuando el contenido XML válido de un archivo dispara una instancia del proceso, el
conjunto de datos de proceso del disparador de archivo se puede controlar mediante
Observación de procesos. Utilice las siguientes descripciones de campos para
interpretar los valores que se muestran.
FileName
El nombre del archivo con el contenido que disparó el proceso.
<additional_parameters>
Los parámetros adicionales que se transfieren en la etiqueta <params> del
contenido XML disparador del archivo.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 423
Administración de disparadores
Monitorizar el conjunto de datos de SMTP de un proceso iniciado por un disparador de correo
Cuando el contenido XML válido de un correo electrónico dispara una instancia del
proceso, el conjunto de datos de proceso SMTP se puede controlar mediante
Observación de procesos. Utilice las siguientes descripciones de campos para
interpretar los valores que se muestran.
SenderAddress
La dirección de correo electrónico de la cuenta de la cual se envía el correo
electrónico disparador.
SentDate
La fecha y hora de envío del correo electrónico.
ReceivedDate
La fecha y hora de recepción del correo electrónico.
MailSubject
El asunto del correo disparador.
MessageNumber
El número de mensaje del correo disparador en el momento de disparar el proceso.
Nota: Este número puede cambiar para el mismo correo si se suprimen o mueven
mensajes de la Bandeja de entrada.
MessageID
ID único del correo en el servidor.
MailBody
El cuerpo del mensaje de correo electrónico en estos casos:
■
Cuando el contenido XML válido de un adjunto dispara el proceso.
■
Cuando se inicia el proceso disparador predeterminado, es decir, cuando no se
encuentra contenido XML válido en el cuerpo del correo electrónico ni en el
archivo adjunto.
Nota: Este valor de cadena se trunca después de los primeros 64 k de caracteres en
el cuerpo del correo.
424 Guía del diseñador de contenido
Administración de disparadores
MailAttachments
Una variable de matriz ValueMap que contiene ValueMaps con la siguiente
información acerca de los adjuntos:
a.
contentType: tipo de contenido del archivo adjunto.
b. contentID: ID de contenido del archivo adjunto, si corresponde.
c.
fileURL: URL desde la que se puede consultar o descargar el archivo adjunto.
d. name: nombre del archivo adjunto.
e.
attachmentID: ID único para este adjunto. Este ID se puede transferir a
funciones de sistema de JavaScript.
Nota: Si desea obtener más información sobre las funciones de sistema de
JavaScript, puede consultar la Guía de referencia del diseñador de contenido.
<additional parameters>
Estos parámetros, transferidos mediante la etiqueta <params> en el contenido XML
disparador, existen solamente cuando el contenido XML válido en el cuerpo del
correo o adjunto inicia el proceso de CA Process Automation.
Formato de contenido XML para disparadores de archivo y correo
Las aplicaciones externas que usan disparadores de archivo o correo para iniciar
procesos de CA Process Automation deben crear una entrada en un formato XML válido.
El contenido XML puede escribirse en el cuerpo de un correo electrónico o enviarse
como adjunto. Si el XML se copia en el cuerpo de un correo electrónico, no puede
contener más de lo que se exige para disparar un proceso. En los disparadores de
archivo, el archivo disparador debe incluir todo el contenido.
Sigue un ejemplo de formato XML válido:
<c2oflow version="1.0">
<flow name="/Test/RunNotepad" action="start">
<!-- Ruta completa del proceso -->
CA AuthMinder
<user>pamadmin</user>
<!-- Nombre de usuario de CA Process Automation
<password>pamadmin</password> <!-- Contraseña de CA Process Automation -->
-->
</auth>
<options>
<!-- Parámetros opcionales para ejecución demorada -->
<startDate></startDate> <!—Fecha de inicio en formato [MM/dd/yyyy] -->
<startTime></startTime>
<!-- Hora de inicio en formato [HH:mm]; HH en 24 h
-->
</options>
<params>
<!-- Parámetros de inicialización del proceso, si corresponde
-->
<param name="ParamOne">Using file trigger</param>
<param name="ParamTwo">Second parameter from file trigger</param>
</params>
</flow>
</c2oflow>
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 425
Administración de disparadores
Consideraciones de entrada de mensaje SNMP
CA Process Automation es compatible con los mensajes SNMPv1 y SNMPv2, pero no
procesa mensajes SNMPv3. Cuando un dispositivo de red o una aplicación empresarial
envía un mensaje SNMPv1 o SNMPv2 que CA Process Automation detecta en el puerto
configurado, CA Process Automation procesa el contenido.
Cambio del puerto de escucha de mensajes SNMP
De forma predeterminada, CA Process Automation escucha el puerto 162 para mensajes
SNMP diseñados para iniciar procesos de CA Process Automation. Si ha cerrado el
puerto 162 en su sitio y ha configurado un puerto alternativo, cambie la configuración
de CA Process Automation para este puerto en el archivo OasisConfig.properties. A
continuación, reinicie el servicio del orquestador.
El puerto en el que CA Process Automation escucha los mensajes SNMP se puede
cambiar.
Lleve a cabo los pasos siguientes:
1.
Conéctese al servidor donde se configura el orquestador del dominio.
2.
Vaya a la siguiente carpeta o directorio:
directorio_instalación/server/c2o/.config/
3.
Abra el archivo OasisConfig.properties.
4.
Cambie el valor en la siguiente línea de 162 al número de puerto que utiliza para
mensajes SNMP.
oasis.snmptrigger.service.port=162
5.
Guarde el archivo.
6.
Reinicie el servicio del orquestador.
a.
Detenga el orquestador.
b. Inicie el orquestador.
En cuanto el servicio se reinicia, CA Process Automation empieza a escuchar en el
puerto que se ha configurado. CA Process Automation está a la escucha de nuevos
mensajes SNMP que cumplan los criterios configurados en el disparador SNMP.
426 Guía del diseñador de contenido
Administración de disparadores
Monitorizar el conjunto de datos de SNMP de un proceso iniciado por un disparador de mensaje
SNMP
Cuando un mensaje SNMP dispara una instancia del proceso, el conjunto de datos de
proceso de SNMP se puede monitorizar mediante Observación de procesos. Utilice las
siguientes descripciones de campos para interpretar los valores que se muestran.
SenderAddress
Dirección IP de la fuente.
AgentIPAddress
Dirección IP del agente SNMP, si está disponible en el mensaje.
SNMPVersion
Versión del mensaje SNMP.
ErrorIndex
Índice de error del mensaje SNMP.
AgentUptime
Tiempo de actividad del agente que envía el mensaje.
EnterpriseOID
Identificador de objeto (OID) del objeto gestionado que generó el mensaje SNMP.
PayloadOIDs
ID de objeto presente en la carga útil del mensaje SNMP. Los ID del objeto de la
carga útil representan una variable de matriz de cadena de CA Process Automation.
PayloadValues
Valores en la carga útil que corresponden a los valores en PayloadOIDs. Estos datos
son también una variable de matriz de cadena de CA Process Automation.
Nota: Si hay varios filtros, se procesa la primera coincidencia.
Capítulo 9: Calendarios, planificaciones, tareas y disparadores 427
Capítulo 10: Ejecución, prueba y depuración
de procesos
Este capítulo analiza cómo ejecutar, probar y depurar procesos interactivamente
durante el desarrollo. Los mismos métodos se pueden utilizar para ejecutar procesos en
un entorno de producción.
Cuando se desea ejecutar un proceso, se puede iniciar mediante cualquiera de los
métodos siguientes:
■
Iniciación de proceso manual
■
Formulario de solicitud de inicio
■
Una llamada desde otros procesos
■
Disparador mediante aplicaciones externas, FTP, llamadas SOAP, mensajes SNMP o
mensajes SMTP (correo electrónico)
El módulo de workflow en un orquestador ejecuta procesos. Cuando inicia un proceso
en un orquestador, el módulo de workflow crea y ejecuta una copia del objeto de
proceso en la biblioteca de automatización del orquestador. Esta copia en ejecución es
una instancia de proceso. El módulo de workflow crea una instancia separada de un
proceso cada vez que el usuario inicia un proceso (u otro proceso u otra aplicación
inician un proceso).
Capítulo 10: Ejecución, prueba y depuración de procesos 429
Administración de disparadores
Se puede abrir y ver una instancia de un proceso, y trabajar con ella, mientras ésta se
ejecuta y una vez finalizada. Los cambios efectuados en una instancia de un proceso
afectan solamente a esa instancia y no afectan al objeto de proceso original almacenado
en una biblioteca de automatización.
Cuando comienza un proceso, se conecta con los módulos de agente u orquestador
correctos en equipos de red gestionados. Un proceso realiza las funciones designadas en
los operadores, prueba las condiciones y las ejercita las dependencias. Cuando surgen
condiciones de error, el proceso realiza acciones correctivas y notifica a los operadores y
administradores cuando es necesario. Un administrador puede utilizar el controlador de
aplicaciones para controlar los procesos en ejecución y realizar acciones correctivas.
Esta sección contiene los siguientes temas:
La página Operaciones (en la página 431)
Reglas de ejecución (en la página 438)
Seguridad de tiempo de ejecución (en la página 439)
Tratamiento de excepciones (en la página 442)
Ejecución interactiva de procesos (en la página 447)
Estados de proceso (en la página 451)
Depuración de un proceso (en la página 451)
Control de una rama de proceso (en la página 455)
Simulación del procesamiento de operadores (en la página 458)
430 Guía del diseñador de contenido
La página Operaciones
La página Operaciones
La página Operaciones tiene las siguientes funciones:
■
Monitorizar las tareas seleccionadas y los elementos de sistema que gestiona CA
Process Automation.
■
Muestra las propiedades de los paquetes de contenidos importados en la paleta
Paquetes de contenidos
■
Mostrar todas las actividades de proceso para una biblioteca de automatización
seleccionada, por ejemplo:
–
Instancias del proceso
–
Planificaciones
–
Invocaciones de módulo
–
Conjuntos de datos
–
Peticiones de usuario
–
Recursos
Capítulo 10: Ejecución, prueba y depuración de procesos 431
La página Operaciones
Element Descripción:
o:
Ficha Operaciones: haga clic en esta ficha para ir a la página Operaciones, un cuadro de mandos de
automatización de alto nivel. En la barra de herramientas, se puede elegir un orquestador, además de
abrir una instancia del proceso y controlarla.
Panel Vínculos: seleccione un vínculo para consultar los elementos asociados. Por ejemplo, haga clic
en Instancias de proceso para ver todos los procesos por estado. Expanda un grupo para explorar
carpetas y seleccionar una instancia. Algunos objetos incluyen un menú contextual de comandos al
que se puede acceder haciendo clic con el botón secundario del ratón. Por ejemplo, la ilustración
muestra que el usuario hizo clic con el botón secundario del ratón en un subproceso del objeto
observación de procesos y, a continuación, hizo clic en Iniciar proceso en el menú contextual.
Área de gráfico: sitúe el puntero en una barra del área de gráfico para mostrar el número de
elementos que coinciden con el estado asociado. Haga clic en una barra para mostrar solo los
elementos que coinciden con el estado asociado.
Tabla o lista Operaciones: en función de lo que haya seleccionado en el panel Vínculos, esta área
mostrará los datos resultantes en una tabla o una lista.
Filtros para instancias de proceso
Se pueden aplicar los filtros siguientes a un acceso directo de gestor de punto de
contacto en un objeto de observación de procesos para definir los objetos que muestra
el acceso directo.
Todas las instancias
Muestra todas las instancias de proceso en el orquestador actual. Todas las
instancias se muestran solamente si todos se seleccionan o borran todos los filtros.
En cola
Muestra todas las instancias que están en cola y en espera de ejecución.
En ejecución
Muestra las instancias de procesos en ejecución en el punto de contacto. Este filtro
no muestra instancias cuyos estados sean En espera, Suspendido o Punto de
interrupción suspendido.
Suspendido
Muestra las instancias de proceso que un usuario o la aplicación del punto de
contacto hayan suspendido.
En espera
Muestra instancias de proceso que tengan un estado de ejecución inactivo, por
ejemplo, los procesos donde todos los operadores activos están esperando un
evento asincrónico externo. El evento puede ser una interacción del usuario, una
fecha y hora objetivo u otra operación de larga duración.
432 Guía del diseñador de contenido
La página Operaciones
Bloqueado
Muestra instancias del proceso que están bloqueadas porque no hay ninguna ruta
disponible. Una instancia del proceso bloqueada se puede completar después de
que un usuario suspenda el proceso y proporcione una ruta válida. El estado
bloqueado refleja las siguientes situaciones:
■
La instancia del proceso requiere intervención del usuario.
■
Una instancia de proceso no puede continuar a causa de una condición
inesperada.
Completado
Muestra todas las instancias del proceso en el punto de contacto que se
completaron sin incidencias.
Error
Muestra todas las instancias del proceso en el punto de contacto que finalizaron sin
completarse.
Anulado
Muestra todas las instancias del proceso que han terminado de modo anormal en el
punto de contacto. Para identificar rápidamente los procesos que tienen
incidencias, examine esta carpeta. Para solucionar los problemas del proceso, abra
la instancia que ha fallado.
Capítulo 10: Ejecución, prueba y depuración de procesos 433
La página Operaciones
Objetos de filtro visualizados con un acceso directo
Observación de procesos incluye un acceso directo para cada uno de los filtros. Se
puede utilizar el procedimiento siguiente para agregar filtros a Observación de
procesos.
Lleve a cabo los pasos siguientes:
1.
Abra el objeto Observación de procesos: seleccione una carpeta Biblioteca y haga
doble clic en el objeto Observación de procesos.
2.
En la ficha Observación de procesos, seleccione un proceso de una carpeta
Biblioteca en el panel izquierdo y, a continuación, seleccione Agregar nuevo en la
barra de herramientas.
El objeto seleccionado se agrega como acceso directo en Observación de procesos.
3.
Expanda el acceso directo del objeto de proceso y seleccione los filtros.
4.
Guarde los cambios realizados.
Para consultar la instancia de objeto para los filtros seleccionados, haga clic en la ficha
Operaciones y expanda la paleta Observación de procesos. El nuevo acceso directo se
puede seleccionar en la ubicación en la que se creó el acceso directo. Se muestran las
instancias correspondientes para el objeto de proceso, en función de los filtros
especificados.
Objetos de observación de procesos
Un objeto de observación de procesos proporciona una forma fácil de monitorizar el
estado de otros objetos de automatización. Los objetos de observación de procesos se
crean en el explorador de bibliotecas. Se pueden agregar objetos (técnicamente
punteros a objetos) desde varios dominios, puntos de contacto, orquestadores y otras
bibliotecas. Cuando consulta el objeto de observación de procesos en la página
Operaciones, muestra el estado actual de los objetos monitorizados.
434 Guía del diseñador de contenido
La página Operaciones
Cómo crear un nuevo objeto de observación de procesos
Defina un nuevo objeto de observación de procesos en el explorador de bibliotecas y
monitorice el estado de cada objeto que incluye en la página Operaciones.
Nota: Para establecer derechos y realizar otras tareas de objeto, la práctica
recomendable es organizar los objetos en carpetas. No cree objetos de en el nivel de
raíz, ya que no se pueden gestionar como un grupo.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
En el panel de carpetas Biblioteca
a.
Seleccione un orquestador en el entorno de producción o diseño.
b. Seleccione una carpeta.
3.
En la barra de herramientas, haga clic en Nuevo y seleccione Observación de
procesos.
Aparece un nuevo objeto de observación de procesos en la carpeta seleccionada.
4.
En el campo Nombre, introduzca un nombre para la observación de procesos.
5.
Haga doble clic en la nueva observación de procesos.
Observación de procesos se abre en una ventana del explorador.
6.
En el panel izquierdo
a.
Seleccione el dominio, entorno, orquestador, punto de contacto, grupo de host
y carpeta para el objeto que se desea agregar a la observación de procesos.
b. Vaya al objeto que se desea incluir en la observación de procesos.
7.
En la barra de herramientas, haga clic Agregar nuevo.
El objeto seleccionado se agrega a la observación de procesos. Aparece el nombre,
tipo de objeto, ruta de referencia, modo y descripción del objeto seleccionado.
8.
Si se ha agregado un proceso, seleccione uno o más estados que desee mostrar en
la observación de procesos, como, por ejemplo, en cola, suspendido y bloqueado.
9.
Haga clic en Guardar.
Capítulo 10: Ejecución, prueba y depuración de procesos 435
La página Operaciones
Monitorización de objetos desde Observación de procesos
Se puede abrir una instancia de un proceso mostrado en el panel Detalles de la ventana
Observación de procesos. Abrir una instancia de proceso permite editar o monitorizar
de cerca la ejecución de la instancia del objeto. Los cambios efectuados en una instancia
de objeto solamente afectan a la ejecución de esa instancia: no se reflejan en la
definición del objeto que hay en la biblioteca.
Nota: Un usuario de CA Process Automation debe tener suficientes permisos para
consultar o editar un objeto en la ventana Observación de procesos.
Para guardar los cambios en una instancia de objeto, haga clic con el botón secundario
del ratón en la instancia del proceso, en Observación de procesos, y haga clic en
Exportar.
Nota: Para obtener más información sobre el trabajo con instancias de proceso en
Observación de procesos, consulte la Guía del administrador de contenido.
Compatibilidad con ruta relativa extendida
Una solución de automatización desarrollada en CA Process Automation está formada
por diversos tipos de objeto de automatización que pueden incluir procesos, conjuntos
de datos, formularios de solicitud de inicio y formularios de solicitud de interacción.
CA Process Automation permite a los usuarios mover una solución de automatización
desde cualquier nivel por toda la jerarquía de la biblioteca. Por ejemplo, los usuarios
pueden mover objetos de una carpeta a otra o pueden mover los objetos de
automatización a una biblioteca de dominio diferente. Cuando mueve las soluciones de
automatización por una biblioteca, la ruta de raíz de los objetos cambia. Para mover una
solución de automatización sin romper o cambiar la relación entre los objetos (a pesar
de que cambie la carpeta raíz), utilice la opción Ruta relativa extendida.
Nota: CA Process Automation proporciona las opciones Relativo y Absoluto en la lista
desplegable de la columna de MODO para el acceso directo del objeto agregado en
Observación de procesos y Paquete.
Objetos de paquete de contenidos
El objeto de automatización de paquete de contenidos agrupa los objetos de CA Process
Automation que un diseñador de contenido ha exportado a un entorno diferente. El
diseñador de contenido agrega los objetos de automatización a una carpeta y exporta la
carpeta como un paquete de contenidos. Cuando se consulta el objeto de paquete de
contenidos en la página Operaciones, muestra el estado actual de los objetos
monitorizados.
436 Guía del diseñador de contenido
La página Operaciones
Más información
Objetos de paquete de contenidos (en la página 475)
Monitorización de objetos desde Observación de procesos
Se puede abrir una instancia de un objeto en el panel Detalles de la ventana Paquetes
de contenidos. Si se abre un objeto, se puede monitorizar de cerca la instancia del
objeto mientras la instancia se ejecuta. Los cambios efectuados en una instancia de
objeto afectan solamente a la ejecución de esa instancia: no modifican la definición del
objeto de la biblioteca.
Nota: Un usuario de CA Process Automation debe tener suficientes permisos para ver o
editar un objeto en la ventana Paquete de contenidos.
Se pueden realizar las acciones siguientes en un objeto de un paquete de contenidos:
■
Iniciar o suspender un proceso
■
Iniciar un formulario de solicitud de inicio
■
Dar o no dar disponibilidad a un operador personalizado
■
Activar o desactivar una planificación
Capítulo 10: Ejecución, prueba y depuración de procesos 437
Reglas de ejecución
Reglas de ejecución
Los operadores de un proceso pueden tener varios vínculos de entrada y salida. Un
vínculo de entrada sirve como orden de ejecución e invoca al operador. Cada vínculo de
salida corresponde a un resultado particular de un operador. Los operadores tienen
vínculos de salida predefinidos (como Anulado, Completado, Error o Correcto). Algunos
operadores también permiten utilizar una expresión booleana para definir un vínculo de
salida personalizado según los resultados y el valor de las variables accesibles a los
operadores de un proceso.
A continuación se describen las reglas de ejecución de un proceso:
■
Los operadores de inicio del flujo principal pueden tener un vínculo de entrada. Si
tienen un vínculo de entrada, no pueden tener un vínculo de salida y funcionar
como el operador Restablecer (por ejemplo, un operador que se utiliza para
restablecer el proceso completo).
■
Los operadores de parada no tienen ningún vínculo de salida y completan la
ejecución de un proceso.
■
Todos los vínculos de salida con condiciones booleanas evaluadas como Verdadero
se activan y conducen a la activación de los operadores de salida subsiguientes. Los
vínculos de salida predeterminados son mutuamente exclusivos entre sí. Todos los
vínculos personalizados para los cuales la expresión booleana se evalúa como
Verdadero se activan y conducen a los operadores de salida subsiguientes.
■
Los operadores (distintos de los operadores recapitalizados de una rama generada a
partir del bucle de un proceso) se procesan sólo una vez durante la ejecución de la
rama de un proceso. Cuando el vínculo de un operador completado conduce a un
operador que ya está activado, este último no se procesa una segunda vez. Después
de la activación, el vínculo procesado no está disponible para el procesamiento
subsiguiente de un proceso.
Algunos operadores son compatibles con el procesamiento generado a partir de un
bucle, en el cual el módulo de workflow ejecuta el operador un número
especificado de veces o indefinidamente. Las condiciones de salida y los vínculos de
conexión del operador se evalúan sólo cuando el bucle finaliza. El operador Bucle
permite aplicar el procesamiento generado a partir de un bucle y las condiciones de
salida de éste a una secuencia integrada de operadores.
■
Los vínculos rotos interrumpen la ejecución de un bucle en operadores que son
compatibles con el uso del procesamiento generado a partir de un bucle.
438 Guía del diseñador de contenido
Seguridad de tiempo de ejecución
Seguridad de tiempo de ejecución
La función opcional Seguridad de tiempo de ejecución, cuando está activada, ayuda a
verificar la identidad del usuario que está ejecutando el proceso seguro o la
planificación. El usuario de cualquier proceso es el propietario o el autor del proceso. El
usuario de cualquier planificación siempre es el propietario. La identidad del usuario
autor de la llamada es la identidad del usuario que inicia un proceso, una planificación o
un operador.
Se utiliza la imposición de la seguridad de tiempo de ejecución cuando se inicia un
proceso, independientemente de cómo se invoque el proceso. Por ejemplo, la
imposición de la seguridad de tiempo de ejecución se aplica a procesos hijo iniciados por
procesos padre.
Consulte Especificación de propiedades de seguridad de tiempo de ejecución (en la
página 77).
También se puede configurar un operador en un proceso para que se ejecute en el
contexto del usuario autor marcando la casilla de verificación Ejecutar como usuario
autor de la llamada que aparece bajo Configuración de ejecución. Marque esta opción
para indicar que desea que el operador se ejecute como si el usuario que ha iniciado el
proceso fuera el que está al mando. Los valores de configuración del operador anulan
los valores de configuración de las propiedades del proceso, si difieren.
Propiedades que afectan a la seguridad de los procesos en ejecución
Solamente el propietario del proceso o los administradores de contenido de entornos
pueden configurar Seguridad de tiempo de ejecución. Dos propiedades del proceso
afectan a la seguridad de tiempo de ejecución en instancias de este proceso:
■
Seguridad de tiempo de ejecución
■
Ejecutar como propietario
Capítulo 10: Ejecución, prueba y depuración de procesos 439
Seguridad de tiempo de ejecución
Seguridad de tiempo de ejecución
Especifica si se debe imponer la seguridad de tiempo de ejecución para este
proceso. La seguridad de tiempo de ejecución se puede activar o desactivar
explícitamente o a través de la herencia. Si se configura explícitamente, los cambios
realizados en los valores de configuración heredados no tienen ningún impacto.
Heredar del orquestador
Aplica la misma configuración que figura en el orquestador. Activar seguridad
de tiempo de ejecución se puede activar o desactivar en la ficha Políticas del
orquestador padre.
Activar
Indica que se desea activar Seguridad de tiempo de ejecución. Cuando un
usuario intenta iniciar una instancia de este proceso, CA Process Automation
examina la configuración de Ejecutar como propietario para el usuario.
■
Si se activa Ejecutar como propietario, CA Process Automation determina
el usuario actualmente configurado como propietario e inicia el proceso
bajo la identidad del propietario. Si este proceso convoca a otro proceso,
ese proceso se ejecuta bajo la identidad del propietario del proceso padre.
Nota: Este valor de configuración se puede anular en el nivel del operador
si se activa Ejecutar como usuario autor de la llamada.
■
Si se desactiva Ejecutar como propietario, CA Process Automation examina
los permisos del usuario que está intentando iniciar una instancia del
proceso. Si ese usuario tiene derechos de inicio, CA Process Automation
permite que la instancia del proceso se inicie bajo la identidad del usuario
autor de la llamada. Si este proceso invoca otro proceso establecido como
usuario autor de la llamada, CA Process Automation comprueba los
derechos de inicio del proceso hijo.
Desactivar
Indica que se desea desactivar Seguridad de tiempo de ejecución. La casilla de
verificación Ejecutar como propietario se desactiva.
440 Guía del diseñador de contenido
Seguridad de tiempo de ejecución
Ejecutar como propietario
Esta casilla de verificación sólo se activa si Seguridad de tiempo de ejecución se
activa explícitamente o a través de la herencia.
Seleccionado
Especifica que todas las instancias del proceso actual se pueden ejecutar bajo
la identidad del propietario (ejecutar como propietario). Cuando un usuario
autorizado inicia el proceso, el propietario obtiene acceso a los procesos hijo y
a otros objetos. El acceso por parte del propietario puede incluir objetos a los
que el usuario autor de la llamada, que inició la instancia, no puede acceder.
Solamente el propietario del proceso o el administrador de contenido de
entornos pueden establecer esta propiedad.
No seleccionado
Especifica que el permiso de inicio se ha verificado en tiempo de ejecución para
el usuario autor de la llamada que intenta iniciar la instancia del proceso.
Directrices para establecer la seguridad de tiempo de ejecución para un proceso
Durante el inicio, una instancia de proceso puede asumir una de las identidades
siguientes:
■
El usuario autor de la llamada, es decir, el usuario que inició la instancia del
proceso.
■
El propietario del proceso.
Al configurar la seguridad de tiempo de ejecución en el nivel del proceso, considere las
directrices siguientes.
Su objetivo:
Configuración necesaria:
Ejecute el proceso como el usuario autor de la llamada. ■
Imponga derechos de seguridad de tiempo de ejecución
con la identidad del usuario que inicia la instancia del
■
proceso.
Seleccione Activar en el campo Seguridad de
tiempo de ejecución.
Ejecute el proceso como propietario.
Imponga la seguridad de tiempo de ejecución
ejecutando instancias de proceso bajo la identidad del
propietario, sin importar quién lo inicie.
■
Seleccione Activar en el campo Seguridad de
tiempo de ejecución.
■
Seleccione Ejecutar como propietario.
Desactive Ejecutar como propietario.
Desactive la validación e imposición de la propiedad del Seleccione Desactivar en el campo Seguridad de tiempo
de ejecución. Esta opción ayuda a garantizar la
proceso en tiempo de ejecución.
compatibilidad con versiones anteriores para procesos
existentes.
Capítulo 10: Ejecución, prueba y depuración de procesos 441
Tratamiento de excepciones
Más información:
Cuándo seleccionar Ejecutar como propietario (en la página 76)
Tratamiento de excepciones
El tratamiento de excepciones permite definir secuencias de operadores para
excepciones predefinidas en los operadores de un proceso, como Error, Anular o
Resultado inesperado. Se puede crear también una secuencia de operadores
predeterminada para que se ejecute para toda excepción que carezca de una secuencia
explícita. Mientras el módulo de workflow procesa una excepción, pausa la ejecución de
cualquier otro operador del proceso.
El tratamiento de excepciones utiliza prioridades cuando se evalúan condiciones de
salida en un operador. La tabla siguiente enumera los tipos de excepción.
Prioridad
Tipo de excepción
Se produce cuando
1
Excepción del sistema
Hay un nombre de punto de contacto incorrecto, un agente
al que no se puede acceder o cualquier tipo de error de
comunicación.
2
Respuesta no identificada
No hay ningún vínculo de salida para una condición de salida
particular.
3
Anulado
Un operador se anula o un usuario anula a un operador.
4
Tiempo de espera
Se agota el tiempo de espera de una operación y no hay
ninguna ruta definida del puerto de tiempo de espera al
flujo principal.
Cuando un operador del proceso experimenta una excepción, el módulo de workflow
realiza las acciones siguientes:
■
Suspende el procesamiento del proceso después de haber ejecutado los operadores
actuales.
■
Intenta hacer coincidir y ejecutar una excepción en el orden siguiente:
Prioridad
Coincidencias
Acción
1
Identificador de excepciones
definido en el objeto del proceso
Ejecuta el identificador de excepciones definido en el
objeto del proceso.
442 Guía del diseñador de contenido
Tratamiento de excepciones
Prioridad
Coincidencias
Acción
2
Identificador de excepciones
definido en el objeto del proceso
para el orquestador que ejecuta
el módulo de workflow
Ejecuta el identificador de excepciones definido en el
objeto del proceso predeterminado para el orquestador.
3
Ninguno
Ignora la excepción.
El módulo de workflow sigue procesando el proceso.
Capítulo 10: Ejecución, prueba y depuración de procesos 443
Tratamiento de excepciones
Creación de identificadores de excepciones
El identificador de excepciones permite crear secuencias de operadores para las
siguientes excepciones predefinidas de un proceso:
Anulado
Se produce una anulación siguiendo instrucciones del usuario o el operador.
Error del sistema
Se produce con cualquier tipo de error de comunicación. Por ejemplo, cuando el
proceso tiene un nombre de punto de contacto incorrecto o hace referencia a un
agente que no se está ejecutando.
Tiempo de espera
Ocurre cuando se producen las dos circunstancias siguientes:
■
El operador caduca antes de terminar.
■
El operador está configurado para tomar la ruta de tiempo de espera y
terminar o continuar con un resultado. El identificador de excepciones define la
ruta de tiempo de espera.
Respuesta no identificada
Se produce cuando no hay ningún conector de resultado que se corresponda con la
respuesta.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Diseñador.
2.
Haga clic en Abrir, vaya a la carpeta donde está el proceso que desea abrir,
selecciónelo y haga clic en Abrir.
3.
Seleccione la ficha Identificador de excepciones.
4.
Expanda la carpeta Estándar en la paleta Operadores y arrastre el operador
Excepción hasta el proceso.
5.
Expanda el cuadro de diálogo de propiedades del operador Excepción.
6.
Expanda Información y escriba un nombre en el campo de nombre.
Nota: Se recomienda anexar un prefijo al nombre de los operadores incluidos en un
identificador de excepciones predeterminado para que dichos nombres no
coincidan con los nombres de los operadores del proceso que carga el identificador
de excepciones predeterminado.
7.
Expanda Se ha producido una excepción.
8.
Seleccione un tipo de excepción de la lista desplegable.
9.
En la paleta, arrastre más operadores al proceso que completa la regla para la
excepción. Vincule los operadores en la secuencia de ejecución.
444 Guía del diseñador de contenido
Tratamiento de excepciones
Nota: Si finaliza la secuencia sin agregar ningún operador Detener, el proceso
principal se reanuda. También se puede detener el proceso de una o varias rutas en
el identificador de excepciones.
10. En la barra de herramientas, haga clic en Guardar.
Se agrega la nueva regla de excepción.
Capítulo 10: Ejecución, prueba y depuración de procesos 445
Tratamiento de excepciones
Como parte de la identificación de las excepciones, se puede restablecer el operador y
continuar con el proceso. También puede optar por ignorar una excepción y continuar
con el proceso. Para ignorar una excepción, configure el operador en el modo de
simulación y continúe con el proceso. El operador Restablecer reside en la paleta
Común. Se puede utilizar el operador Restablecer en el panel del proceso, en el
Identificador de excepciones y en el Identificador de cambio de carril.
Lleve a cabo los pasos siguientes:
1.
Haga clic con el botón secundario en el botón Agregar, Restablecer para agregar un
operador Restablecer.
El cuadro de texto muestra una entrada con una lista desplegable en la que se
puede seleccionar uno de los operadores del proceso actual. Se pueden agregar
numerosos nombres de operadores.
2.
Para ordenar los nombres de los operadores, haga clic en Suprimir, Mover hacia
arriba y Mover hacia abajo, según sea necesario.
3.
Introduzca una expresión que se resuelva en una cadena (por ejemplo, un nombre
de operador) o una lista de valores (por ejemplo, nombres de operadores) en el
tiempo de ejecución. Realice esta acción en lugar de seleccionar un nombre de
operador en la lista desplegable.
4.
Seleccione o deseleccione la opción Continuar con resultado.
Seleccionada:
Hace que la opción Condición de finalización esté disponible para seleccionar
los valores Correcto o Incorrecto.
Correcto:
Si se produce una condición de error en el tiempo de ejecución, CA Process
Automation da por hecho que los operadores seleccionados son correctos.
Continúa con el resto del flujo del proceso.
Incorrecto:
Si se produce una condición de error en el tiempo de ejecución, CA Process
Automation da por hecho que hay algún error en los operadores
seleccionados. Continúa con el resto del flujo del proceso.
No seleccionado:
Si se produce una condición de error durante el tiempo de ejecución, CA
Process Automation restablece los operadores seleccionados y continúa con el
flujo del proceso.
5.
(Opcional) Para ignorar una excepción y continuar con el proceso, agregue un
operador Restablecer en el modo del identificador de excepciones para que se
ignore la excepción:
exceptionStart-<nombre del operador>.Source
446 Guía del diseñador de contenido
Ejecución interactiva de procesos
Nota: Cuando se agrega un campo a la lista de operadores Restablecer operador, los
nombres del operador Bucle del proceso aparecen en la lista desplegable del nuevo
campo. El operador Restablecer permite restablece todos los operadores incluidos en el
operador Bucle y restablece el operador Bucle a la primera iteración. Después del
restablecimiento, el operador Bucle se reinicia desde la primera iteración. Puesto que el
operador Bucle no es compatible con la simulación, el operador Restablecer siempre
restablece un operador Bucle. El operador Bucle se restablece y se ignoran los siguientes
valores de campo:
■
Continuar con resultado
■
Condición de finalización
■
Código de ejecución previa
■
Código de ejecución posterior
Ejecución interactiva de procesos
Se puede iniciar una instancia de un proceso inmediatamente o en el modo suspendido.
Cuando un proceso se inicia inmediatamente, se crea una instancia del proceso, se carga
en la memoria y empieza a procesar operadores en el acto. Si un proceso se inicia en el
modo suspendido, la instancia del proceso se carga en la memoria, pero no empieza a
procesar.
Se puede crear el acceso directo de un proceso en un objeto de observación de
procesos. Si es un usuario autorizado, puede iniciar y controlar el proceso desde el
interior del objeto de observación de procesos. En la paleta Observación de procesos de
la ficha Operaciones, haga clic con el botón secundario del ratón en el proceso y haga
clic en Inicio.
Se puede iniciar la versión actual de un proceso accediendo al objeto del proceso en el
explorador de bibliotecas. También se puede iniciar un proceso mientras se edita en el
diseñador de procesos. Mientras se edita un proceso, se pueden incorporar cambios e
iniciar la versión actual del proceso sin salir del Diseñador de procesos.
Cuando comienza un proceso, CA Process Automation crea una copia o instancia de él
en la biblioteca de automatización. Los cambios realizados en una instancia no afectan a
la definición básica del proceso. Se puede acceder a las definiciones básicas a través del
explorador de bibliotecas. Las instancias de proceso se monitorizan mediante una
Observación de procesos. Para monitorizar una instancia de proceso, se puede abrir la
Observación de procesos en la paleta Observación de procesos de la ficha Operaciones.
El objeto de automatización de Observación de procesos real se puede abrir mediante el
Explorador de bibliotecas.
Capítulo 10: Ejecución, prueba y depuración de procesos 447
Ejecución interactiva de procesos
Más información:
La página Operaciones (en la página 431)
Inicie un proceso desde la biblioteca
Se puede iniciar un proceso desde la ficha Biblioteca. Iniciar un proceso de inmediato
permite llevar a cabo una tarea en un entorno de producción.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en Orquestador y seleccione la combinación Orquestador:entorno.
3.
Vaya a la carpeta que contiene el proceso para iniciarse.
4.
Realice una de las siguientes acciones:
■
Haga clic con el botón secundario del ratón en el proceso y seleccione Iniciar
proceso.
■
Seleccione el proceso y seleccione Iniciar proceso de la lista desplegable Más
acciones de la barra de herramientas.
Se abre la petición Monitorizar instancia de proceso.
5.
Realice una de las siguientes acciones:
■
Haga clic en Sí para abrir una nueva ventana para controlar la instancia en
ejecución del proceso.
■
Haga clic en No para ejecutar una instancia del proceso. El proceso no se
muestra.
El proceso se inicia inmediatamente.
448 Guía del diseñador de contenido
Ejecución interactiva de procesos
Iniciar un proceso como Suspendido desde la biblioteca
Se puede iniciar una instancia de un proceso en un estado suspendido para lograr
alguno de los objetivos siguientes:
■
Inserte puntos de interrupción.
■
Configure parámetros.
■
Realice otros cambios antes de que el proceso se ejecute.
■
Monitorice o controle la ejecución de un proceso.
■
Depure la secuencia de pasos del proceso.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en Orquestador y seleccione el orquestador:entorno apropiado.
3.
Vaya a la carpeta que contiene el proceso para iniciarse en estado suspendido.
4.
Realice una de las siguientes acciones:
■
Haga clic con el botón secundario del ratón en el proceso y seleccione Inicio
suspendido.
■
Seleccione el proceso y seleccione Inicio suspendido de la lista desplegable Más
acciones de la barra de herramientas.
Se abre la petición Monitorizar instancia de proceso.
5.
Realice una de las siguientes acciones:
■
Haga clic en Sí para abrir la ficha Diseñador con la barra de herramientas de
depuración. Puede empezar a trabajar con la instancia suspendida
inmediatamente.
■
Haga clic en No para cargar el proceso en la ficha Operaciones. La ficha
Diseñador no se abre. Se puede ir más tarde a la instancia de la paleta de
Observación de procesos de la ficha Operaciones. Para continuar, haga clic con
el botón secundario del ratón en esa instancia y seleccione Inicio suspendido.
Más información:
Depuración de un proceso (en la página 451)
Capítulo 10: Ejecución, prueba y depuración de procesos 449
Ejecución interactiva de procesos
Inicio de un proceso mientras se edita
Mientras edita un objeto de proceso, puede iniciar la versión actual sin salir del
diseñador de procesos. Los comandos Inicio e Inicio suspendido están disponibles en el
menú Archivo. Los botones Inicio e Inicio suspendido también están disponibles en la
barra de herramientas del diseñador de procesos.
Los comandos Inicio e Inicio suspendido del diseñador de procesos crean una instancia
del proceso actual en la memoria, como iniciar un proceso en el explorador de
bibliotecas. Al hacer clic en Inicio, se crea la instancia del proceso correspondiente y
comienza de forma inmediata la ejecución del proceso. Al hacer clic en Inicio
suspendido, se crea la instancia del proceso correspondiente, pero no se inicia la
ejecución del proceso.
Tanto el comando Inicio como el comando Inicio suspendido solicitan el punto de
contacto en el que se ejecutará el proceso y, a continuación, solicitan si se desea
monitorizar la ejecución del proceso. Si opta por controlar la ejecución del proceso, CA
Process Automation abre una ventana del diseñador de procesos aparte para trabajar
con la nueva instancia en el modo de depuración.
Abrir una instancia de proceso
El objeto de Observación de procesos y la página Operaciones le permiten consultar
instancias de procesos en un orquestador. Tendrá la posibilidad de:
■
Recuperar y reiniciar los procesos que se suspenden después de uns incidencia.
■
Determinar los valores de variables del conjunto de datos y el estado de los
operadores en procesos en ejecución, suspendidos o finalizados.
Se pueden crear objetos de observación de procesos o usar página Operaciones para
monitorizar y editar instancias de procesos. Haga clic en la ficha Operaciones para
controlar todas las instancias de procesos en un orquestador. También se pueden
establecer filtros para controlar sólo objetos seleccionados.
Más información:
La página Operaciones (en la página 431)
450 Guía del diseñador de contenido
Estados de proceso
Estados de proceso
El diseñador de procesos actualiza periódicamente el estado actual del proceso. Los
siguientes iconos codificados con colores se utilizan para indicar el estado de cada uno
de los operadores. El proceso se puede editar mientras está en ejecución o suspendido.
Una vez que un proceso se ha completado o anulado, la instancia no se puede cambiar.
Depuración de un proceso
Cuando se abre una instancia de un proceso, el Diseñador de procesos le ayuda a
controlar el estado y a depurar un proceso. Los botones de depuración están
disponibles en la barra de herramientas del Diseñador de procesos. Cuando se suspende
el procesamiento, se puede editar el proceso y cambiar los valores de los parámetros de
los operadores.
La ejecución de un proceso se puede suspender de varias maneras:
■
Cuando una instancia se inicia en un estado Suspendido
■
Cuando se hace clic en el botón Suspender proceso
■
Al finalizar un proceso y hacer clic en el botón Cambiar el estado del proceso al
finalizar en la barra de herramientas del Diseñador de procesos. El proceso se
suspende, pero el estado aparece como Bloqueado.
■
Cuando no hay ningún operador válido en las ramas de un proceso en ejecución El
proceso se suspende, pero el estado aparece como Bloqueado.
Suspensión de un proceso
Cuando un proceso está en el estado suspendido, se puede hacer todo lo siguiente:
■
Cambiar el hecho de que un proceso se descargue después de finalizar
■
Restablecer el proceso
■
Restablecer los operadores de un proceso
■
Agregar o eliminar puntos de interrupción
■
Modificar el proceso
■
Hacer clic en el botón Reanudar proceso para continuar el procesamiento
■
Anular el proceso
Capítulo 10: Ejecución, prueba y depuración de procesos 451
Depuración de un proceso
La modificación de un proceso en un estado suspendido permite trabajar en un
problema imprevisto y luego reanudar la ejecución automatizada mientras se hace un
seguimiento de los cambios que se hayan efectuado. Cambie a una observación de
procesos para exportar una instancia modificada de un proceso y guardar los cambios
efectuados en tiempo de ejecución de forma permanente.
Para suspender la ejecución de la instancia de un proceso mientras funciona en el modo
de depuración, haga clic en el botón Suspender proceso en la barra de herramientas del
diseñador de procesos.
La ejecución de la instancia del proceso se detiene. No se examinan más dependencias
hasta que se reanuda la ejecución del proceso. Se puede editar un proceso en un estado
suspendido. Toda modificación efectuada en los parámetros del operador u otros
elementos del proceso afecta solamente a esa instancia del proceso.
Para reiniciar la ejecución de la instancia suspendida de un proceso, haga clic en el
botón Reanudar proceso. El botón Reanudar proceso reinicia un proceso suspendido
desde donde dejó de ejecutarse, a menos que se restablezca. Si la instancia de un
proceso suspendido se restablece, la ejecución se reinicia desde el comienzo del
proceso.
Cambio de estado de procesos descargados o finalizados
Al ejecutar un proceso en el modo de depuración, el módulo de workflow normalmente
no descarga la instancia de proceso cuando llega a un operador Detener. Esto le permite
modificar y reiniciar el proceso.
Para hacer que el módulo de workflow descargue un proceso cuando llegue a un
operador Detener, haga clic en Mantener estado en el menú Control para borrar la
marca de verificación junto al comando. También se puede utilizar el botón Cambiar el
estado del proceso al finalizar, que se encuentra en la barra de herramientas para
activar o desactivar este comando. El botón de la barra de herramientas permanece
inactivo mientras el comando está activo.
Configuración y eliminación de puntos de interrupción de un proceso
Se pueden utilizar puntos de interrupción para identificar errores. Los puntos de
interrupción permiten comprobar valores de variables y parámetros de operador.
Establezca un punto de interrupción en un operador para interrumpir un proceso
inmediatamente antes de que el operador se inicie. A continuación se pueden
establecer valores de parámetro y se puede examinar el procesamiento de un operador
a medida que ocurre.
Cuando se configura un punto de interrupción, se suspende la ejecución completa del
proceso cuando llega al operador que tiene el punto de interrupción. Aparece un signo
de exclamación (!) junto al operador que ha suspendido el proceso.
452 Guía del diseñador de contenido
Depuración de un proceso
Se pueden configurar y eliminar puntos de interrupción en un objeto de proceso o en la
instancia suspendida de un proceso. Los puntos de interrupción configurados en la
definición del objeto del proceso original aparecen automáticamente en cualquier
instancia de ese proceso.
Lleve a cabo los pasos siguientes:
1.
Abra un proceso en el diseñador de procesos.
2.
Seleccione uno o más operadores en el proceso.
3.
En la barra de herramientas, haga clic en Establecer puntos de interrupción.
El símbolo de punto de interrupción aparece junto al operador seleccionado.
4.
Para eliminar puntos de interrupción existentes, seleccione uno o más operadores y
haga clic en el botón Eliminar puntos de interrupción en la barra de herramientas
de depuración.
Capítulo 10: Ejecución, prueba y depuración de procesos 453
Depuración de un proceso
Depuración de un proceso de Java
El conector de Java utiliza Apache Log4j para capturar los mensajes de registro del
conector. Al solucionar una incidencia con un proceso de Java, depúrelo activando y, a
continuación, revisando los archivos de registro. Los mensajes de registro capturados en
el nivel DEPURAR son muy detallados y deberían servir de ayuda a los ingenieros del
sistema para definir la causa raíz de una incidencia.
Nota: Las rutas a los archivos log4j.xml y c2o.log cambian cuando el módulo de Java se
ejecuta en un agente de CA Process Automation.
Lleve a cabo los pasos siguientes:
1.
Busque el archivo log4j.xml en la ruta siguiente:
ruta_instalación_CA Process Automation\Domain\server\c2o\conf\log4j.xml
2.
Establezca el umbral de log4j del módulo de Java como DEPURAR.
A continuación se incluye un ejemplo de la sección y línea específicas (mostrada en
negrita) del archivo log4j.xml:
<!-- A size based file rolling appender for C2O and JXTA Logs-->
<appender name="C2OFILE"
class="org.jboss.logging.appender.RollingFileAppender">
<errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
<param name="File" value="${jboss.server.home.dir}/log/c2o.log"/>
<param name="Threshold" value="DEBUG"/>
<param name="Append" value="true"/>
<param name="MaxFileSize" value="50000KB"/>
<param name="MaxBackupIndex" value="3"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d %-5p [%c] [%15.15t] %m%n"/>
</layout>
</appender>
3.
Inserte la sección siguiente en el archivo log4j.xml:
<category name="com.optinuity.c2o.servicegroup.javaobject">
<priority value="DEBUG" />
</category>
4.
Abra los mensajes del conector de Java capturados en el archivo c2o.log ubicado en
la ruta siguiente:
ruta_instalación_CA Process Automation\Domain\server\c2o\log\c2o.log
454 Guía del diseñador de contenido
Control de una rama de proceso
Restablecimiento de un proceso
Se puede restablecer una instancia suspendida de un proceso para reiniciar la ejecución.
Todas las variables, parámetros y operadores de una instancia suspendida de un
proceso se restablecen a sus estados iniciales. La aplicación no restablece parámetros
definidos por el usuario.
Si reanuda la ejecución de un proceso después de haberlo restablecido, el
procesamiento se inicia en el operador Iniciar. Se puede restablecer un proceso durante
operaciones de prueba o depuración para volver a ejecutar cadenas de operadores. En
la producción, se puede restablecer un proceso tras una incidencia. Se puede modificar
un proceso restablecido antes de reiniciarlo para evitar volver a llevar a cabo algunas
tareas o para realizar tareas adicionales. Por ejemplo, puede:
■
Configurar o eliminar puntos de interrupción
■
Utilizar otro proceso
■
Establecer valores de configuración de parámetros de operadores
Anulación de un proceso
Para detener una instancia de proceso, haga clic en el botón Anular proceso en la barra
de herramientas del Diseñador de procesos.
Nota: No se puede modificar una instancia de proceso después de haber ejecutado el
comando de anulación.
Control de una rama de proceso
Los siguientes comandos permiten controlar la ejecución de ramas individuales de un
proceso sin afectar al proceso completo.
■
activar y desactivar operadores,
■
anular la ejecución de operadores,
■
restablecer operadores individuales y reanudar la ejecución de operadores en un
proceso.
Estos comandos aparecen en la barra de herramientas del Diseñador de procesos tanto
para los diseños como para las instancias de proceso.
Capítulo 10: Ejecución, prueba y depuración de procesos 455
Control de una rama de proceso
Desactivación de operadores o de ramas
Se puede utilizar el comando Desactivar operadores para desactivar un operador y
provisionalmente desactivar parte de un proceso sin modificarlo. Al desactivar un
operador, se detiene la ejecución de éste y de todos los operadores subsiguientes de la
rama de un proceso. Un operador es inaccesible para un proceso cuando todas las rutas
a él de cualquier operador Iniciar pasan por un operador desactivado. El comando
Desactivar operadores está disponible cuando se edita la definición de objeto para un
proceso o una instancia de un proceso.
Para desactivar un operador en un proceso
1.
Abra un objeto de proceso o una instancia de un proceso.
Nota: En el caso de una instancia en ejecución de un proceso, suspenda la ejecución
antes de continuar con el siguiente paso del procedimiento.
2.
Seleccione uno o más operadores que desee desactivar.
3.
Haga clic en Desactivar operadores en la barra de herramientas del Diseñador de
procesos para desactivar un operador.
El símbolo de desactivación aparece junto al operador.
Nota: Para activar operadores desactivados, seleccione uno o más operadores
desactivados y haga clic en Activar operadores en la barra de herramientas.
También se puede desactivar una rama completa haciendo clic con el botón secundario
del ratón en un vínculo y seleccionando Desactivar vínculo desde el menú.
Más información:
Simulación del procesamiento de operadores (en la página 458)
Anulación de un operador
El comando Anular operadores anula el procesamiento de uno o más operadores
seleccionados que están en el estado En ejecución. Un operador anulado introduce un
estado Error. El procesamiento no continúa en una rama anulada de un proceso, pero
aún se puede continuar en otras ramas. Si se ha definido un identificador de
excepciones, se ejecuta para gestionar la excepción de anulación.
456 Guía del diseñador de contenido
Control de una rama de proceso
Lleve a cabo los pasos siguientes:
1.
Abra una instancia en ejecución de un proceso.
2.
Seleccione el operador en ejecución que se desea anular.
3.
Haga clic en el botón Anular operadores de la barra de herramientas del Diseñador
de procesos:
Se anula el procesamiento del operador.
Restablecimiento de operadores de un proceso
El comando Restablecer operadores restablece los operadores seleccionados en un
proceso suspendido a sus estados iniciales correspondientes como si no se hubiesen
ejecutado. Por lo general, este comando se utiliza para que los operadores que se
encuentran en una instancia de un proceso puedan volver a ejecutarse sin restablecer el
proceso completo. Puede modificar los operadores con diferentes ajustes de
parámetros o modificar de otra manera el proceso.
Lleve a cabo los pasos siguientes:
1.
Abra una instancia suspendida de un proceso.
Si es necesario, suspenda la ejecución de una instancia en ejecución.
2.
Seleccione uno o más operadores que desee restablecer.
3.
Haga clic en el botón Restablecer operadores de la barra de herramientas del
Diseñador de procesos.
Los operadores se restablecen.
Algunos operadores Bucle se restablecen de la siguiente manera:
■
Restablece todos los operadores que hay dentro del operador Bucle.
■
Restablece el operador Bucle a la primera iteración.
Después del restablecimiento, el operador Bucle se reinicia desde la primera
iteración.
Reanudación de la ejecución de un proceso suspendido
El comando Reanudar proceso reanuda el procesamiento de operadores restablecidos
en una instancia suspendida de un proceso.
Capítulo 10: Ejecución, prueba y depuración de procesos 457
Simulación del procesamiento de operadores
Para reanudar la ejecución de un proceso suspendido
1.
Abra una instancia suspendida de un proceso.
2.
Haga clic en el botón Reanudar proceso de la barra de herramientas del Diseñador
de procesos.
El proceso se reanuda.
Simulación del procesamiento de operadores
Para omitir un operador mientras se ejecutan los operadores subsiguientes de un
proceso, se puede simular la ejecución del operador en lugar de desactivarlo. Se puede
simular el procesamiento de operadores seleccionados o de un proceso completo.
Puede utilizar las propiedades de simulación del proceso para todos los operadores de
un proceso. También puede sustituir la configuración del proceso en operadores
individuales del proceso.
El modo de simulación se utiliza a menudo durante el desarrollo para verificar el flujo de
un proceso o la sincronización de procesos interdependientes. En el entorno de
producción, el modo local se utiliza a menudo para omitir tareas individuales a fin de
alojar condiciones pasajeras en el sistema, como un agente no disponible, un
orquestador o una aplicación suspendida. El modo de simulación a distancia se utiliza
principalmente en la fase de desarrollo para verificar la configuración y los parámetros
de los operadores en un proceso. El modo de simulación a distancia también se puede
utilizar para ejecutar tareas simuladas en la producción periódicamente, con el único fin
de verificar los valores del campo del conjunto de datos.
El modo de simulación controla los resultados y la duración de un operador en un
proceso. Se puede utilizar durante el desarrollo para evitar ejecutar un operador
mientras se examinan operadores en las ramas subsiguientes de un proceso. La
simulación es útil en un entorno de producción cuando un operador no debería
ejecutarse. Los operadores no se ejecutan cuando los procesos o los recursos no están
disponibles. En cualquiera de ambos casos, la simulación de un operador permite
ejecutar un proceso sin tener que cambiar los vínculos de entrada o salida en el
operador. Dicho de otra manera, puede evitar ejecutar el operador provisionalmente
mientras conserva la estructura y las dependencias en su proceso.
458 Guía del diseñador de contenido
Simulación del procesamiento de operadores
Simulación del procesamiento de un operador seleccionado
Se puede simular el procesamiento de un operador seleccionado.
Lleve a cabo los pasos siguientes:
1.
Abra cualquier operador en el explorador de bibliotecas o en un proceso abierto.
2.
Configure las propiedades de simulación de cualquier operador.
3.
Si la simulación del proceso no está activada, active primero la casilla de verificación
Sustituir las opciones de simulación en el proceso.
4.
Para activar la simulación, especifique un tipo de simulación local o a distancia.
–
Local: el operador no se procesa. CA Process Automation no convoca al módulo
asociado o ni verifica los parámetros del módulo. El operador simulado
devuelve el resultado y procesa el vínculo especificado por la opción Condición
de finalización.
–
A distancia: el módulo de workflow convoca al módulo asociado. El módulo
verifica los parámetros antes de devolver el resultado, pero no ejecuta el
operador. Si los parámetros no son correctos, se produce un error en el
operador simulado independientemente del resultado especificado. Si los
parámetros son correctos, el operador simulado devuelve el resultado y
procesa el vínculo especificado por la opción Condición de finalización.
El símbolo de simulación aparece junto a un operador cuando se activa la
simulación local o a distancia:
5.
(Opcional) Seleccione la casilla de verificación Evaluar condiciones previas y código
de ejecución posterior para evitar los efectos secundarios generados al ignorar las
condiciones previas o el código de ejecución posterior. Seleccione esta opción de
evaluar las condiciones previas del operador y ejecutar el código de ejecución
posterior.
6.
Establezca el parámetro Condición de finalización. Especifica el resultado simulado
de un operador. La condición de finalización determina qué vínculo de salida se
procesa después del procesamiento simulado del operador. Al establecer este
parámetro, se determina el posterior procesamiento de ramas dependientes en un
proceso. Esta configuración determina el valor devuelto por la variable Resultado
de un operador. El valor de configuración Correcto o Completado devuelve un valor
positivo que activa un vínculo de salida Correcto en un operador. La configuración
Error devuelve un cero o un valor negativo que activa un vínculo de salida Error o
Anular. El valor Resultado personalizado permite devolver un valor arbitrario, que
normalmente se utiliza para probar un vínculo de salida personalizado.
Capítulo 10: Ejecución, prueba y depuración de procesos 459
Simulación del procesamiento de operadores
7.
(Opcional) Se puede especificar una demora en segundos para simular la duración
de la tarea. Cambie el valor predeterminado de cero del campo Retraso si el tiempo
normalmente necesario para ejecutar un operador podría afectar al
comportamiento o el resultado de otros operadores del proceso.
Más información:
Código de ejecución previa y código de ejecución posterior (en la página 244)
Simulación del procesamiento de un proceso completo
Se puede simular un procesamiento para todos los pasos de un proceso. La
configuración de simulación del proceso se aplica a todos los operadores del proceso
que no estén configurados para anular los valores de configuración de simulación del
proceso.
Lleve a cabo los pasos siguientes:
1.
Abra el proceso.
2.
Haga clic en Propiedades en el menú Archivo o en el botón Propiedades de la barra
de herramientas del Diseñador de procesos:
3.
En la ficha Simulación del panel Propiedades, defina la configuración de simulación
predeterminada de todos los operadores del proceso:
■
Tipo
■
Retraso
■
Condición de finalización
■
Evaluar condiciones previas y código de ejecución posterior
Excepto en el caso de optar por suprimir los valores de configuración del proceso, estos
valores son los mismos que los que se describen para configurar un operador.
Los parámetros de simulación de un proceso son los mismos que los de un operador,
excepto que son los valores de configuración predeterminados de todos los operadores
de un proceso. Para cambiar la configuración de la propiedad de simulación para un
operador específico, seleccione la casilla de verificación Sustituir las opciones de
simulación en el proceso en las páginas de propiedades de simulación para el operador.
460 Guía del diseñador de contenido
Capítulo 11: Generación y uso de
documentación de procesos
Se puede generar documentación de los procesos automatizados. Otros usuarios podrán
imprimir la documentación del proceso que se genere.
Esta sección contiene los siguientes temas:
Acerca de la documentación de procesos (en la página 461)
Generación de la documentación del proceso (en la página 463)
Acerca de la documentación de procesos
Se pueden generar detalles de definición de procesos y gráficos con anotaciones. El
formato de salida es PDF.
La documentación de procesos incluye detalles en los niveles siguientes:
■
Detalles en el nivel del proceso
■
Detalles en el nivel del operador para cada operador utilizado en el flujo de
procesos
Capítulo 11: Generación y uso de documentación de procesos 461
Acerca de la documentación de procesos
La siguiente lista resume los detalles que se generan en cada nivel:
Detalles en el nivel del proceso
La documentación de procesos genera la siguiente información para un proceso
seleccionado:
■
Imagen del proceso
■
Nombre de proceso
■
Parámetros creados por el usuario en el conjunto de datos del proceso
■
Ruta de la biblioteca
■
Propietario
■
Versión del proceso
■
Versión
■
Extraído por
■
Fecha de creación
■
Fecha de la última modificación
■
Orquestador en el que reside el proceso
■
Etiquetas del proceso
Detalles en el nivel del operador
La documentación del proceso genera los detalles siguientes para cada operador
que utiliza un proceso seleccionado:
■
Mapa de bits del icono que representa al operador
■
Parámetros creados por el usuario en el conjunto de datos del operador
■
Nombre del operador
■
Descripción del operador
■
Tipo de operador (es decir, la categoría del operador)
■
Parámetros del operador
■
Puertos de salida
■
Configuración de ejecución
–
Código de ejecución previa
–
Código de ejecución posterior
–
Bucle
–
Tiempo de espera
–
Objetivo
462 Guía del diseñador de contenido
Generación de la documentación del proceso
Generación de la documentación del proceso
Se puede generar la documentación del proceso en cualquier momento. Por ejemplo,
utilice esta función para registrar el estado del proceso antes de crear una transición a
producción.
Lleve a cabo los pasos siguientes:
1.
Abra el proceso desde la ficha Biblioteca.
2.
En la ficha Diseñador, haga clic en el botón Documentación del proceso de la barra
de herramientas.
Se abrirá el cuadro de diálogo Opciones de documentación del proceso.
3.
4.
(Opcional) Seleccione las opciones que se deben incluir en la documentación.
■
Conjunto de datos del proceso
■
Información del operador
■
Código Pre-/Post-Execution
■
Propiedades de operador
■
Conjunto de datos de operador
■
Identificador de excepciones (si se selecciona, CA Process Automation genera la
documentación y un archivo de imagen de todos los operadores del
Identificador de excepciones)
■
Identificador de cambio de carril (si se selecciona, CA Process Automation
genera la documentación y un archivo de imagen de todos los operadores del
Identificador de cambio de carril)
Haga clic en Aceptar.
Aparecerá un cuadro de diálogo solicitando si debe abrirse o guardarse el archivo.
5.
Haga clic en Abrir para consultar el contenido del archivo zip, o bien haga clic en
Guardar para guardar el archivo zip a una ubicación de su elección.
El archivo zip contiene:
■
Un archivo PDF que contiene la documentación del proceso.
■
Las imágenes de tamaño completo contenidas en la documentación del
proceso. El PDF contiene imágenes adaptadas, con lo cual es posible que no
sean legibles si el proceso es muy grande.
■
Un archivo XML que contiene los datos sin formato que se utilizan para generar
la documentación en formato XML. Este archivo permite transformar el XML en
otros formatos.
Capítulo 11: Generación y uso de documentación de procesos 463
Capítulo 12: Publicación de objetos en otro
entorno
Después de diseñar y probar un nuevo proceso, este se puede liberar con los objetos
que utiliza. Normalmente, un proceso nuevo que esté en una biblioteca de orquestador
de un entorno de diseño se publica en una biblioteca de orquestador de un entorno de
producción. Se pueden exportar objetos a una carpeta, un paquete o un paquete de
contenidos (en la página 472). Sin embargo, para exportar objetos relacionados a un
contenedor simple y adjuntarle una versión de publicación, se deben exportar esos
objetos como un paquete de contenidos.
Si se ha usado paquetes en CA Process Automation 04.1.00, migre esos objetos a un
nuevo paquete de contenidos.
El entorno de diseño y el entorno de producción están en el mismo dominio. Si la
funcionalidad está diseñada en una ubicación y se desea implementarla en una
ubicación diferente, se puede implementar el producto en dos dominios separados. Se
puede importar el archivo .xml de un objeto, carpeta, paquete o paquete de contenidos
a un orquestador de otro entorno en un dominio diferente.
Nota: Cuando se exportan objetos para importarlos a un orquestador del mismo
entorno, se pueden omitir los procesos de configuración de los objetos como línea de
referencia y las configuraciones de las versiones de publicación.
Un administrador o diseñador de contenido puede realizar este proceso. Normalmente,
un administrador exporta una carpeta como paquete de contenidos del entorno
predeterminado y, a continuación, lo importa a un entorno de producción. La ilustración
siguiente describe el proceso:
Capítulo 12: Publicación de objetos en otro entorno 465
Versiones de publicación
Lleve a cabo los pasos siguientes:
1.
Establezca la versión de publicación de objetos que se exportarán. (en la
página 467)
2.
Configuración como línea de referencia de la versión de los objetos que se van a
exportar (si procede) (en la página 469).
3.
Agregue objetos a una carpeta (si procede) (en la página 477).
4.
Realice una exportación (en la página 473).
5.
Realice una importación (en la página 489).
Versiones de publicación
Una publicación se produce cuando se implementan un proceso y sus componentes
desde un entorno de diseño a un entorno de producción. Cuando se seleccionan
componentes para empaquetarlos para su exportación, se elige una versión de cada
componente. Se puede introducir un valor específico de publicación en el campo
Versión de publicación de la versión de cada carpeta y objeto que tenga previsto
empaquetar para su exportación. Esta práctica se requiere cuando se exportan objetos a
una carpeta como un paquete de contenidos.
Después de establecer una versión de publicación para cada objeto, agregue la versión
correspondiente a la carpeta que desee exportar como paquete de contenidos.
Los paquetes de contenido empiezan como carpetas en el entorno de CA Process
Automation inicial. Cuando se exporta una carpeta como un paquete de contenidos y se
importa a un entorno nuevo, el producto crea las líneas de referencia de las versiones
de objeto importadas en el paquete de contenidos. Los usuarios no pueden modificar
los datos de la versión de publicación de los objetos importados.
Vista de la información de la versión de publicación
La ficha Versiones muestra información acerca de las versiones de publicación que se
establecen para el objeto seleccionado.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione un objeto en la ventana principal y haga clic en Propiedades.
3.
El panel Propiedades aparece en la parte inferior de la ventana.
466 Guía del diseñador de contenido
Versiones de publicación
4.
Haga clic en la ficha Versión.
5.
Consulte los datos que se muestran en Versión de publicación.
La versión de publicación identifica la versión específica de un objeto que se ha
importado, o bien que desea exportar y, a continuación, importar a un entorno de
producción. Este identificador se puede establecer en cualquier objeto individual.
Este campo está bloqueado en las circunstancias siguientes:
■
El objeto se importó como parte de un paquete de contenidos.
■
El objeto se importó de un paquete (en la versión 4.1.00) con su versión de
publicación en el modo no modificable.
Nota: Consulte la referencia sobre la interfaz de usuario para obtener información
detallada sobre la ficha Versiones.
Definición de la versión de publicación de objetos que se exportarán
La ficha Versiones muestra información acerca de las versiones de publicación que se
establecen para el objeto seleccionado. Puede establecer la versión de publicación
cuando esté preparado para implementar un objeto en un entorno de producción. La
versión de publicación de un objeto identifica normalmente su versión específica para la
implementación. A través del campo Versión de publicación, por ejemplo, se puede
establecer el atributo de la versión de publicación para un proceso y cada objeto
asociado.
Cuando se esté preparado para implementar un objeto en un entorno de producción:
■
Se puede exportar un objeto solo.
■
Se pueden exportar todos los objetos de una carpeta seleccionada, incluidas las
subcarpetas.
■
Se pueden exportar los objetos como paquete de contenidos. En este caso, cada
carpeta que exporte como paquete de contenidos debe tener la versión de
publicación y todos los objetos incluidos en la carpeta. Una vez que el paquete de
contenidos se importa, no se puede modificar la versión de publicación en el nuevo
entorno, a menos que se haga una copia del objeto.
Nota: Para obtener más información, consulte el apartado sobre la diferencia entre
exportar un objeto, una carpeta, un paquete de contenidos y un paquete (en la
página 472).
En cada caso, el archivo exportado contiene el valor del atributo de la versión de
publicación de cada objeto que se va a exportar.
Capítulo 12: Publicación de objetos en otro entorno 467
Versiones de publicación
Se puede establecer la versión de publicación del siguiente modo:
Desde la biblioteca
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Seleccione una carpeta del panel izquierdo y, a continuación, un objeto único
de la lista del panel derecho.
3.
Haga clic con el botón secundario del ratón en el objeto y seleccione
Propiedades.
4.
En el panel Propiedades, haga clic en la ficha Versiones.
Nota: Consulte las sugerencias o la referencia sobre la interfaz de usuario para
obtener las descripciones de los campos y ejemplos.
5.
Haga clic con el botón secundario del ratón en la versión aplicable y a
continuación seleccione Establecer versión de la publicación.
6.
Introduzca un valor adecuado en el campo Versión de publicación.
Desde la ficha Versiones en el editor de objetos
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga doble clic en un objeto.
La versión actual del objeto se abre en el Editor de objetos.
3.
Haga clic en la ficha Versiones.
Nota: El editor de procesos no contiene una ficha Versiones.
4.
Haga clic con el botón secundario del ratón en la versión del objeto que se va a
implementar y seleccione Establecer versión de la publicación.
Se abre el campo Versión de publicación.
5.
Introduzca una versión de publicación para el objeto y, a continuación, pulse
Intro.
Mientras se incorpora un objeto
Consulte Incorporación de objetos (en la página 91).
468 Guía del diseñador de contenido
Versiones de publicación
Configuración como línea de referencia de la versión de publicación de los objetos
Un diseñador de contenido configura como línea de referencia un objeto para crear una
versión de instantánea de él. Los usuarios no pueden cambiar la versión de línea de
referencia de un objeto pero lo pueden utilizar como base para una nueva versión. Un
diseñador de contenido puede configurar objetos como línea de referencia en cualquier
momento, pero normalmente lo hace con la versión del objeto que se va a exportar. En
la fase de preparación para la exportación, los diseñadores de contenido pueden
configurar un elemento como línea de referencia y definir la versión de publicación en la
versión de exportación en la misma sesión.
Nota: La versión de un objeto que se configure como línea de referencia para exportarlo
a una carpeta como paquete de contenidos puede ser la versión actual u otra versión.
Normalmente, es la versión actual que se ha extraído.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en Orquestador y seleccione el Orquestador: Entorno apropiado.
3.
Vaya a la carpeta con un objeto objetivo y verifique que el campo Estado del objeto
indica Incorporado. (Si no es así, incorpore el objeto antes de continuar).
4.
Seleccione el informe objetivo y haga clic en Propiedades.
5.
Haga clic en la ficha Versiones.
6.
Si el botón Línea de referencia está activado en la versión que se va a publicar, haga
clic en Línea de referencia.
En el ejemplo siguiente, el botón Línea de Referencia para Rv2.0 se activa.
Equation 3: En las propiedades de todos los objetos hay una ficha Versiones. En esta
ficha se puede establecer, opcionalmente, una versión de publicación, definir una versión
como actual y crear una línea de referencia de uno o más versiones mostradas.
7.
Cierre el panel Propiedades.
Capítulo 12: Publicación de objetos en otro entorno 469
Exportación e importación
Establecimiento de la versión de publicación del paquete de contenidos como la
actual
La ficha Versiones muestra información acerca de las versiones de publicación que están
disponibles para un paquete de contenidos. La versión de publicación identifica por lo
general la versión específica de un paquete que debe implementarse en un entorno de
producción.
Después de haber importado el paquete de contenidos a un entorno nuevo, se puede
utilizar la ficha Versiones para establecer el atributo de versión de publicación del
paquete de contenidos.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón secundario del ratón en un paquete de contenidos y
seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha Versiones.
4.
Para establecer el paquete de contenidos como la versión de publicación actual,
selecciónelo y haga clic en Actual.
5.
Haga clic en Sí en el mensaje de advertencia.
El explorador de bibliotecas muestra la versión actual del paquete de contenidos.
Exportación e importación
Para mover los siguientes elementos de la biblioteca de un orquestador a la biblioteca
de otro orquestador, utilice los procesos de exportación e importación:
■
Objetos
■
Carpetas
■
Paquetes
■
Paquetes de contenidos
Por ejemplo, se puede copiar de un entorno de desarrollo a un entorno de producción,
o bien copiar de un orquestador a otro orquestador en el mismo entorno. En el proceso
de exportación se crea un archivo XML que se utiliza durante el proceso de importación.
Una vez que se exporten los objetos, impórtelos en el orquestador de destino.
470 Guía del diseñador de contenido
Exportación e importación
Tenga en cuenta los siguientes puntos antes de realizar la exportación e importación:
■
Los archivos de exportación conserva toda la información, incluidas las jerarquías y
las rutas, de cada objeto exportado. Durante la exportación, puede guardar toda la
jerarquía absoluta de carpetas de la carpeta raíz o solamente las rutas relativas a
partir de la carpeta seleccionada.
■
Cuando se importa un archivo .xml que se exportó como rutas absolutas o relativas
a una biblioteca de automatización, CA Process Automation reconstruye la
información de la ruta (absoluta o relativa) en el archivo de la estructura de
carpetas exportada.
■
Cuando se exportó la carpeta raíz, también se exportó toda la biblioteca de
automatización. Tenga en cuenta las restricciones de tamaño antes de que se
exporte la carpeta raíz.
■
Se puede abrir un archivo de exportación en cualquier editor de texto de XML.
■
No se puede modificar la versión de publicación de un paquete de contenido
exportado. El proceso de exportación encripta el archivo de exportación .xml para
impedir modificaciones.
■
Cuando se exporta una carpeta u objeto fuera de un paquete de contenidos, el
propio objeto determina el estado del objeto importado. Por ejemplo, si se exporta
un proceso que no se puede modificar fuera de un paquete de contenidos, el
proceso sigue sin ser modificable después de la importación.
Exportación
A continuación, se explica el proceso de exportación.
Capítulo 12: Publicación de objetos en otro entorno 471
Exportación e importación
¿Qué diferencia hay entre exportar un objeto, una carpeta, un paquete de contenidos y un
paquete?
CA Process Automation le permite exportar objetos y carpetas de diversas maneras.
Durante la exportación se crea un archivo .xml que se puede importar a un entorno
diferente.
Se pueden exportar los elementos siguientes:
Un objeto por sí mismo
Se puede exportar solamente un objeto en un modo modificable. Se puede agregar
una versión de publicación al objeto, pero no es obligatorio. Después de importar
un objeto a un entorno nuevo, se puede modificar el objeto directamente.
Una carpeta con todos sus objetos y subcarpetas
Mediante la exportación de una carpeta se exporta también la carpeta y su
contenido, incluidas las subcarpetas. El contenido puede incluir cualquier objeto
disponible en la biblioteca de CA Process Automation.
Se puede exportar una carpeta en un modo modificable para que tanto la carpeta
como su contenido se puedan modificar directamente en un entorno nuevo. No es
obligatorio que los objetos que se exportan mediante una carpeta tengan una
versión de publicación.
En el archivo de exportación, se conservan la ruta de la carpeta y la estructura
jerárquica de los objetos y carpetas subordinadas.
472 Guía del diseñador de contenido
Exportación e importación
Una carpeta como un paquete de contenidos
Una carpeta se convierte en un paquete de contenidos con la exportación y no se
puede modificar en el entorno nuevo. En el archivo de exportación, se conservan la
ruta de la carpeta y la estructura jerárquica de los objetos y carpetas subordinadas.
Se puede agregar información de publicación a una carpeta para exportar como un
paquete de contenidos. El atributo de versión de publicación se requiere para todas
las carpetas, pero se puede agregar otra información relevante acerca de la carpeta
o los objetos en ella.
Es una buena práctica exportar una carpeta como un paquete de contenidos si se
está realizando la transición de un nuevo proceso con sus componentes desde el
entorno de diseño hasta el entorno de producción. Los destinatarios en el entorno
de producción no pueden modificar el contenido del paquete de contenidos.
Importante: Si no se establece la versión de publicación del paquete de contenidos
o los objetos hijo de la carpeta, el producto anula la tarea de exportación.
Un paquete
El objeto de paquete solo cuenta con disponibilidad con versiones anteriores en CA
Process Automation 04.2.00. No se puede hacer referencias a paquetes en
formularios de solicitud de interacción, formularios de solicitud de inicio,
operadores personalizados, observaciones de procesos o conjuntos de datos. Se
puede exportar todavía un paquete 04.1.00, pero no se puede modificar el paquete
después de haberlo importado a un entorno nuevo. Sin embargo, se pueden
modificar los objetos del paquete.
Para incluir objetos similares y exportarlos a un entorno nuevo, utilice un paquete
de contenido.
Los paquetes que se migran de la versión 04.1.00 a la versión 04.2.00 se exportan
de la misma manera que un objeto.
Nota: No se pueden exportar varias carpetas u objetos de automatización a la vez. Cree
una carpeta y, a continuación, monte todos los objetos que se deseen exportar como un
paquete de contenidos único. No se puede exportar una carpeta como paquete de
contenidos que ya contenga un paquete de contenidos.
Realización de una exportación
Para mover objetos, carpetas, paquetes y paquetes de contenido de la biblioteca de un
orquestador a la biblioteca de otro orquestador, utilice los procesos de exportación. El
orquestador puede estar en el mismo entorno o un entorno diferente.
Capítulo 12: Publicación de objetos en otro entorno 473
Exportación e importación
Exportación de un objeto
Nota: Los paquetes que se migran de la versión 04.1.00 a la versión 04.2.00 se exportan
de la misma manera que un objeto.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en Orquestador y seleccione la opción Orquestador: entorno apropiada.
3.
Vaya al objeto que se va a exportar, haga clic con el botón secundario del ratón en
el objeto y seleccione Exportar.
4.
Para especificar las rutas, seleccione una de las siguientes opciones:
Exportar, Rutas absolutas
Incluye la ruta completa para el objeto seleccionado.
Exportar, Rutas relativas
Incluye la ruta relativa a la carpeta que contiene el objeto seleccionado.
5.
Para guardar el archivo XML, haga clic en Guardar en el cuadro de diálogo Descarga
de archivos.
El nombre de archivo predeterminado es object-name.xml.
6.
Vaya a la ubicación en la cual se guardará el archivo .xml en la unidad local.
7.
Defina el nombre con el cual se guardará el archivo.
Por ejemplo, se puede añadir _RR al nombre de archivo para indicar que se trata de
una ruta relativa o _RA para indicar una ruta absoluta.
nombre-objeto_RR.xml
nombre-objeto_RA.xml
8.
Haga clic en Guardar.
Se exporta el objeto.
Exportación de carpetas
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en Orquestador y seleccione la opción Orquestador: entorno apropiada.
474 Guía del diseñador de contenido
Exportación e importación
3.
Vaya al objeto o carpeta que se va a exportar, haga clic con el botón secundario del
ratón en ella y, a continuación, seleccione una de las siguientes opciones:
Exportar
Exporta una carpeta o paquete en un modo modificable.
Exportar como paquete de contenidos (solo para carpetas)
Exporta una carpeta como paquete de contenidos en un modo no modificable.
4.
Para especificar las rutas de exportación, seleccione una de las siguientes opciones:
Exportar, Rutas absolutas
Incluye la ruta completa a la carpeta seleccionada.
Exportar, Rutas relativas
Incluye la ruta relativa a la carpeta que contiene la carpeta seleccionada.
Importante: Si la versión de publicación del paquete de contenidos o de sus objetos
hijo no se establece en la carpeta, el producto anula la tarea de exportación.
5.
Para guardar el archivo XML, haga clic en Guardar en el cuadro de diálogo Descarga
de archivos.
El nombre de archivo predeterminado es folder-name.xml.
6.
Vaya a la ubicación en la cual se guardará el archivo .xml en la unidad local.
Defina el nombre con el cual se guardará el archivo. Por ejemplo, se puede añadir
_RR al nombre de archivo para indicar que se trata de una ruta relativa o _RA para
indicar una ruta absoluta.
nombre-carpeta_RR.xml
nombre-carpeta_RA.xml
7.
Haga clic en Guardar.
CA Process Automation exporta la carpeta y su contenido.
Más información
Exportación de rutas relativas y absolutas (en la página 480)
Objetos de paquete de contenidos
Los procesos complejos pueden utilizar diversos objetos, incluidos operadores, iconos,
recursos, conjuntos de datos y otros procesos. Pueden estar distribuidos en varias
carpetas con objetos inconexos en una biblioteca de automatización. Esta complejidad
presenta los problemas potenciales siguientes:
Capítulo 12: Publicación de objetos en otro entorno 475
Exportación e importación
■
Un usuario puede encontrar dificultades trabajando solamente con los objetos
necesarios para una implementación o una actualización subsiguiente.
■
Un desarrollador que trabaje con objetos distintos en diferentes carpetas puede
tener dificultades para encontrar objetos específicos o realizar un seguimiento de
ellos.
■
Al exportar objetos actualizados para implementarlos en un entorno de producción,
el administrador puede olvidarse de un objeto obligatorio.
Para exportar todos los objetos de automatización relacionados, se pueden montar en
una carpeta y exportar dicha carpeta como paquete de contenidos a otro entorno de CA
Process Automation. Los paquetes de contenidos son útiles porque permiten meter
objetos relacionados en un contenedor único y, a continuación, asignarles una versión
de publicación. Cuando los objetos se importan a un nuevo entorno de producción, no
se pueden modificar a menos que se copien los objetos importados. No se puede editar
ni suprimir ninguno de los objetos del paquete de contenidos. De este modo se
protegen dichos objetos para que no se puedan modificar de una forma dañina. Dicho
de otra manera, se puede retroceder siempre al paquete de contenidos original si se
desean revocar cambios no deseados realizados a los objetos. Como las versiones de
publicación de los objetos no son modificables, los diseñadores de contenido del
entorno de diseño fuente pueden identificar las versiones de los objetos exportados e
importados si se debe solucionar un problema.
En cambio, si se exportan objetos por ellos mismos o mediante una carpeta, se pueden
modificar en un entorno nuevo. Algunos objetos que se importan por ellos mismos o
mediante una carpeta (en lugar de un paquete de contenidos) no necesitan una versión
de publicación. Estos objetos se pueden modificar directamente. Es una buena práctica
exportar una carpeta como un paquete de contenidos si se está realizando la transición
de un nuevo proceso con sus componentes desde el entorno de diseño hasta el entorno
de producción.
Nota: No se pueden exportar varias carpetas u objetos de automatización a la vez. Cree
una carpeta y, a continuación, monte todos los objetos que se deban exportar como un
paquete de contenidos único. No se puede exportar una carpeta como paquete de
contenidos que ya contenga un paquete de contenidos o un paquete.
476 Guía del diseñador de contenido
Exportación e importación
Se pueden ver los paquetes de contenidos importados en la Biblioteca.
■
Cuando se expande un paquete de contenidos en el panel derecho, sus objetos hijo
(que forman parte de la versión actual) se muestran debajo del paquete de
contenidos.
■
Se puede consultar la última información de la versión de una carpeta o paquete de
contenidos en sus propiedades. Haga clic con el botón secundario del ratón en el
objeto, seleccione Propiedades y, a continuación, haga clic en la ficha Versiones. La
ficha Pista de auditoría registra algunos cambios hechos a la carpeta o al paquete
de contenidos.
Se pueden consultar también todos los paquetes de contenidos importados en la paleta
Paquetes de contenidos de la ficha Operaciones.
■
Si se hace clic en el paquete de contenidos en el panel izquierdo, sus propiedades
se ven en el panel derecho.
■
Si se hace clic en los objetos individuales que contiene en el panel izquierdo,
aparecen las propiedades de objeto en el panel derecho.
■
Si el paquete de contenidos contiene un proceso, el lado derecho muestra una vista
gráfica de las instancias.
Más información
Versiones de publicación (en la página 466)
Creación de un paquete de contenidos
Adición de objetos a un paquete
Antes de exportar una carpeta como un paquete de contenidos, hay que rellenar la
carpeta con objetos.
En un paquete de contenidos de la versión 04.02.00 de CA Process Automation todos los
objetos que se van a exportar deben estar en una única carpeta. En la versión 04.1.00,
se pueden agregar objetos como accesos directos desde diferentes carpetas a un
paquete para realizar una exportación.
Después de agregar un objeto, se puede utilizar el parámetro versión o versión de
publicación para establecer la versión de un objeto. Si se ha personalizado el parámetro
de versión de publicación, establezca la versión del objeto en la columna Versión de
publicación.
El atributo de versión de publicación se puede definir antes de agregar una versión
seleccionada de cada objeto a una carpeta. Después de agregar los objetos a la carpeta,
determine la versión de publicación del paquete de contenidos.
Capítulo 12: Publicación de objetos en otro entorno 477
Exportación e importación
Lleve a cabo los pasos siguientes:
1.
Creación de una carpeta.
2.
Para abrir la carpeta, haga doble clic en ella en el panel de carpeta del explorador
de bibliotecas.
3.
En la barra de herramientas, haga clic en Nuevo y seleccione un tipo de objeto.
CA Process Automation crea un objeto.
4.
Introduzca un nombre único para el objeto.
Nota: También se puede cortar y pegar un objeto desde otra carpeta a la nueva carpeta
de paquete de contenidos.
Adición de información de publicación a una carpeta
La adición de información de publicación a una carpeta es una forma útil de
proporcionar información relevante acerca de la carpeta y de cualquiera de los objetos
que esta contiene.
Se puede definir la publicación de una carpeta en la ficha Publicación bajo las
propiedades de la carpeta. El valor de atributo ReleaseVersion que se define para una
carpeta en la ficha Publicación permite gestionar la versión de una carpeta, que resulta
especialmente útil si se desea exportar dicha carpeta como un paquete de contenidos.
ReleaseVersion es el atributo obligatorio de la carpeta. No se puede suprimir ni editar el
atributo ReleaseVersion, pero se puede insertar la versión de publicación adecuada en
la columna Valor.
Nota: Se puede consultar la última información sobre publicación de una carpeta en sus
propiedades. Haga clic con el botón secundario del ratón en la carpeta, seleccione
Propiedades y, a continuación, haga clic en la ficha Publicación. La ficha Pista de
auditoría registra algunos cambios hechos a la carpeta.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic con el botón secundario del ratón en la carpeta del panel derecho y, a
continuación, seleccione Propiedades.
3.
En el panel Propiedades, haga clic en la ficha Publicación para ver las propiedades
de la carpeta.
4.
Haga clic en el campo Valor.
Se muestra el cuadro Valor.
478 Guía del diseñador de contenido
Exportación e importación
5.
Introduzca un valor para el atributo ReleaseVersion y haga clic en Aceptar.
6.
Haga clic en el vínculo Agregar propiedad para definir la propiedad de una carpeta
adicional y haga clic en Suprimir propiedad para eliminar la propiedad de una
carpeta definida por el usuario.
Una vez que la versión de publicación se ha asignado, se puede exportar la carpeta
como un paquete de contenidos.
Más información
Exportación de carpetas (en la página 474)
Llamada de objetos de paquete de contenidos
Cuando cualquier objeto convoca a otro objeto en CA Process Automation, el producto
recupera el objeto al que se hace referencia en la base de datos, a menos que el objeto
se suprima. Por ejemplo, un proceso puede convocar otro proceso o un proceso puede
hacer referencia a un conjunto de datos específico. Si el objeto al cual se hace referencia
se ha suprimido, se muestra un error. De lo contrario, se devuelve el objeto.
Sin embargo, la llamada a un objeto que está en un paquete de contenidos cuenta con
otra restricción. Si algún objeto hace referencia a otro objeto en un paquete de
contenidos, el producto verifica que reside en la versión de publicación actual del
paquete de contenidos. Si el objeto no está en la versión de publicación actual del
paquete de contenidos (o se ha suprimido), se genera un error.
El producto requiere la versión más actual de un objeto en un paquete de contenidos en
los casos siguientes:
■
Se busca un operador personalizado en el explorador de operadores.
■
Un calendario llama a otro calendario como un calendario de exclusión de vista
previa (en el campo Visualizar previamente el calendario de exclusión de la ficha
Vista previa del diseñador de calendario). Si el calendario seleccionado no forma
parte de la versión de publicación actual del paquete de contenidos, las fechas no
se excluyen cuando ese calendario se aplica con el campo Visualizar previamente el
calendario de exclusión.
■
Un operador personalizado llama a otro objeto mediante una referencia de objeto
que no forma parte de la versión de publicación actual del paquete de contenidos.
■
Un conjunto de datos que el operador del proceso de inicio utiliza llama a otro
objeto mediante una referencia de objeto. La referencia de objeto no forma parte
de la versión de publicación actual del paquete de contenidos.
■
Un proceso utiliza el operador Comprobar calendario para llamar a un calendario
que no forma parte de la versión de publicación actual del paquete de contenidos.
Capítulo 12: Publicación de objetos en otro entorno 479
Exportación e importación
■
Un observador de procesos llama a otro objeto que no forma parte de la versión de
publicación actual del paquete de contenidos. En este caso, la paleta Observación
de procesos se muestra esa observación de procesos.
■
Un proceso llama a un formulario de solicitud de interacción que no está en la
versión de publicación actual del paquete de contenidos. En este caso, el proceso
produce un fallo.
■
Un proceso llama a otro proceso que no se encuentra en la versión de publicación
actual del paquete de contenidos. En este caso, el proceso produce un fallo.
■
Una planificación llama a otro proceso que no se encuentra en la versión de
publicación actual del paquete de contenidos. En este caso, el proceso no se
ejecuta.
■
Un formulario de solicitud de inicio llama a otro objeto mediante una referencia de
objeto que no se encuentra en la versión de publicación actual del paquete de
contenidos.
■
Un formulario de solicitud de interacción (usado en el operador Asignar tarea de
usuario y llamado en el operador Iniciar proceso) llama a otro objeto que no forma
parte de la versión de publicación actual del paquete de contenidos.
Exportación de rutas relativas y absolutas
Cuando se inicia una exportación, se pueden seleccionar tanto rutas relativas como
absolutas. La opción seleccionada afecta a la estructura de carpetas en la que aparece el
objeto seleccionado en la biblioteca del orquestador de destino.
Ejemplo: exportación de paquete de contenidos
Tenga en cuenta el siguiente ejemplo. En la carpeta raíz, la biblioteca de orquestadores
de origen es Carpeta_a y contiene Carpeta_b, que a su vez contiene Proceso 1 y
Formulario de solicitud de inicio 1.
480 Guía del diseñador de contenido
Exportación e importación
Caso 1:
Considere los criterios siguientes:
■
Se exporta Carpeta_b (que incluye Proceso 1 y Formulario de solicitud de inicio
1) como un paquete de contenidos con una ruta absoluta.
■
El usuario que realiza la importación selecciona la carpeta /prueba como el
destino en el entorno nuevo.
Después de la importación, el paquete de contenidos aparece en la estructura de
carpetas siguiente:
/prueba/Carpeta_a/Carpeta_b
En la jerarquía, la prueba y Carpeta_a son carpetas, pero Carpeta_b es ahora un
paquete de contenidos.
Caso 2:
Considere los criterios siguientes:
■
Se exporta Carpeta_b con una ruta relativa.
■
El usuario que realiza la importación selecciona la carpeta /prueba como el
destino.
Después de la importación, el paquete de contenidos aparece en la siguiente
estructura de carpetas:
/prueba/Carpeta_b
Capítulo 12: Publicación de objetos en otro entorno 481
Exportación e importación
Ejemplo: exportación de carpetas
Considere los criterios siguientes:
■
Suponga que la estructura de carpetas de origen es raíz, Carpeta_a y
Carpeta_b.
■
El objeto Proceso reside en Carpeta_b.
/Carpeta_a/Carpeta_b/Proceso
Caso 1:
Exporte Carpeta_b con rutas absolutas. Importe el contenido exportado a la carpeta
/prueba. Después de la importación, la estructura de la carpeta de destino es la
siguiente:
/prueba/Carpeta_a/Carpeta_b/Proceso
Caso 2:
Exporte Carpeta_b con rutas relativas. Importe el contenido exportado a la carpeta
/prueba. Después de la importación, la estructura de la carpeta de destino es la
siguiente:
/prueba/Carpeta_b/Proceso
482 Guía del diseñador de contenido
Exportación e importación
Ejemplo: Exportación de objetos
Caso 1:
Exporte el objeto Proceso con rutas absolutas. Importe el contenido exportado a la
carpeta /prueba. Después de la importación, la estructura de la carpeta de destino
es la siguiente:
/prueba/Carpeta_a/Carpeta_b/Proceso
Caso 2:
Exporte el objeto Proceso con rutas relativas. Importe el contenido exportado a la
carpeta /prueba. Después de la importación, la estructura de la carpeta de destino
es la siguiente:
/prueba/Proceso
Capítulo 12: Publicación de objetos en otro entorno 483
Exportación e importación
Cómo migrar objetos de un paquete a una carpeta nueva para preparar una exportación
El paquete de contenidos es un objeto que se introdujo en CA Process Automation
04.2.00. En CA Process Automation 04.1.00, los objetos se contenían en un paquete
para exportar de un entorno a otro entorno diferente. El objeto de paquete solo cuenta
con disponibilidad con versiones anteriores en la versión 04.2.00. No se puede hacer
referencias a paquetes en formularios de solicitud de interacción, formularios de
solicitud de inicio, operadores personalizados, observaciones de procesos o conjuntos
de datos. Se puede exportar todavía un paquete 04.1.00, pero no se puede modificar el
paquete después de haberlo importado a un entorno nuevo. Sin embargo, se pueden
modificar los objetos del paquete.
Si se desea agrupar objetos similares y exportarlos como una publicación no modificable
en un entorno nuevo, se debe utilizar el paquete de contenidos. CA Process Automation
crea el paquete de contenidos después de haber exportado la carpeta (como un
paquete de contenidos) de un entorno y haberla importado en otro entorno. Una vez
importado, el paquete de contenidos se puede ver en el explorador de bibliotecas y en
la ficha Operaciones en la paleta Paquetes de contenidos, como se indicada por el icono
de paquete de contenidos .
Este escenario describe los pasos obligatorios para migrar contenido de un objeto de
paquete a una carpeta nueva, si se desea continuar moviendo contenido como una
versión no modificable entre entornos.
El diagrama siguiente describe las tareas que los diseñadores de contenido llevan a cabo
cuando migran objetos de un paquete a una carpeta nueva para preparar la
exportación:
Lleve a cabo los pasos siguientes:
1.
Abra el objeto del paquete de la versión 04.1.00 y anote todos los objetos que el
paquete contiene (en la página 485).
2.
Encuentre y copie esos objetos de paquete en la biblioteca (en la página 485).
3.
Cree una carpeta para pegar en ella los objetos del paquete. (en la página 486)
484 Guía del diseñador de contenido
Exportación e importación
Abra el paquete del objeto 04.1.00 y anote todos los objetos que contiene el paquete.
El objeto del paquete que se creó en la versión 04.1.00 está indicado por un icono de
paquete azul:
Lleve a cabo los pasos siguientes:
1.
Abra el explorador de bibliotecas.
2.
Encuentre y abra el objeto del paquete de la versión 04.1.00.
3.
Anote todos los objetos que están contenidos dentro del paquete.
Localización de los objetos del paquete en la biblioteca
Una vez que se hayan identificado los objetos dentro del paquete, encuéntrelos dentro
de la biblioteca, cópielos y péguelos en una carpeta nueva.
En las carpetas de la biblioteca, se pueden abrir carpetas conocidas y desplazarse por
ellas o buscar carpetas por nombre para los objetos que el paquete contiene. También
se pueden buscar objetos con la opción de Búsqueda simple mediante un solo criterio o
con la opción de Búsqueda avanzada con varios criterios. La acción de búsqueda
encuentra objetos que coinciden con los criterios de búsqueda dentro de la estructura
de carpetas que haya especificado.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Navegue por el árbol de carpetas para llegar a la carpeta que contiene el objeto. Si
es necesario, puede consultar carpetas por nombre en el campo de búsqueda que
hay sobre el panel Orquestador.
3.
(Opcional) Busque el objeto. En la carpeta seleccionada, lleve a cabo una de los
siguientes tipos de búsqueda:
4.
■
Lleve a cabo una búsqueda simple si desea realizar la consulta con un solo
criterio de búsqueda, como un propietario o tipo de objeto.
■
Lleve a cabo una búsqueda avanzada si desea realizar la consulta con varios
criterios, como el estado de un objeto o una fecha de modificación.
Haga clic con el botón secundario del ratón en cada objeto que devuelva la
búsqueda y seleccione Copiar.
Capítulo 12: Publicación de objetos en otro entorno 485
Exportación e importación
Creación de una carpeta para pegar en ella los objetos del paquete
Cuando haya encontrado un objeto en la biblioteca que el paquete de la versión 04.1.00
contiene, péguelo en una carpeta nueva para exportarlos a un nuevo entorno.
Todos los objetos que desee exportar se deberán encontrar en una carpeta. En la
versión 04.1.00, se pueden agregar objetos como accesos directos desde diferentes
carpetas a un paquete para realizar una exportación. Este comportamiento no es
posible con un paquete de contenidos. Todos los objetos se deben albergar en una
carpeta solamente para su exportación.
Lleve a cabo los pasos siguientes:
1.
En el panel de la carpeta Explorador de bibliotecas, seleccione la carpeta donde se
desee crear una carpeta.
2.
En la barra de herramientas, haga clic en Nuevo y, a continuación, en Carpeta.
Aparece la nueva carpeta.
3.
Cambie el nombre de la carpeta.
4.
Haga clic con el botón secundario del ratón en el objeto y seleccione Pegas.
Repita el proceso para cada objeto que el paquete contiene hasta que la nueva carpeta
contenga todo el contenido de la versión 04.1.00. Se pueden editar los objetos después
de haberlos pegado en la carpeta nueva.
Las migraciones de contenido ya se han completado y se puede exportar la carpeta a un
entorno nuevo.
Importación
Los temas de esta sección explican el proceso de importación.
486 Guía del diseñador de contenido
Exportación e importación
Cómo establecer opciones de importación
CA Process Automation le proporciona cierta flexibilidad en el método para importar
objetos.
Si en la importación se incluyen operadores personalizados, seleccione Dar
disponibilidad a los operadores personalizados importados.
Si los operadores personalizados son nuevos y pertenecen a un grupo personalizado
nuevo, lleve a cabo las acciones adecuadas para su entorno.
■
No seleccione Publicar configuración del grupo del operador del cliente si el
entorno de importación está en el mismo dominio que el entorno de exportación.
En este caso, la configuración del grupo de operadores personalizados ya se ha
publicado.
■
Seleccione Publicar configuración del grupo del operador del cliente si el entorno de
importación está en un dominio diferente al entorno de exportación.
Hay que tener en cuenta el contenido de importación cuando se configure Establecer la
versión importada como actual y se seleccione cómo manejar los nombres duplicados.
■
Para activar los objetos importados con la capacidad de volver a una versión
anterior de un objeto importado, si es necesario:
–
Seleccione: Importar
–
Seleccione: Establecer la versión importada como actual
Nota: Estas opciones son las óptimas cuando se está importando una versión de
publicación de actualización y todos los objetivos de operador se establecen como
host en el entorno de importación. Se le notificarán los nombres duplicados porque
los objetos de la última publicación se encuentran en la carpeta de destino.
Capítulo 12: Publicación de objetos en otro entorno 487
Exportación e importación
■
Para importar sin activar los objetos actualizados, en los que la versión anterior
conserva su estado de la versión actual:
–
Seleccione: Importar
–
Desactive: Establecer la versión importada como actual
Nota: Estas opciones son las óptimas cuando la importación incluye operadores
cuyo objetivo son los host que todavía no se han definido con su nombre de punto
de contacto en el entorno de importación. Con esta configuración, se pueden
establecer objetos como actuales después de asegurarse de que los objetivos de
proceso estén disponibles en el entorno de importación.
■
Para aplazar la importación de cualquier objeto con un nombre duplicado y poder
establecer los objetos como actuales manualmente:
–
Seleccione: No importar
–
Desactive: Establecer la versión importada como actual
–
Nota: Estas opciones son las óptimas cuando se están importando objetos
nuevos en una carpeta rellena. Estas opciones evitan que se haga una versión
nueva de un objeto de importación con el mismo nombre pero con una función
diferente. Estas opciones también permiten establecer objetos como actuales
después de probar y verificar su uso en el nuevo entorno.
Si se reciben alertas, se puede considerar la posibilidad de realizar estas
acciones:
■
■
Registre los nombres duplicados en el mensaje de alerta e informe a un
administrador en el entorno fuente. Quizá esos objetos se puedan
renombrar y exportarse otra vez.
■
Vuelva a realizar la importación, pero en una carpeta vacía.
Para activar los objetos importados sin la capacidad de revertir la acción para
objetos con nombres duplicados:
–
Seleccione: Importar y reemplazar
–
Seleccione: Establecer la versión importada como actual
–
Nota: Estas opciones son las óptimas cuando se están reimportando
correcciones a objetos en la carpeta de destino. En este caso, nunca será
necesario volver a la versión reemplazada.
488 Guía del diseñador de contenido
Exportación e importación
Realización de una importación
Se puede importar un objeto, una carpeta, un paquete o un paquete de contenidos que
se haya exportado. El proceso de exportación crea el archivo XML que utiliza el proceso
de importación.
Nota: Si se ha exportado una carpeta como un paquete de contenidos, el producto
importa la carpeta exportada como un paquete de contenidos no modificable en la
carpeta de importación. No se puede cortar y suprimir de un paquete de contenidos. Se
pueden copiar los objetos de automatización de un paquete de contenidos y pegarlos a
otra carpeta para modificarlos. Se pueden consultar también todos los paquetes de
contenidos importados en la paleta Paquetes de contenidos de la ficha Operaciones.
Lleve a cabo los pasos siguientes:
1.
Haga clic en la ficha Biblioteca.
2.
Haga clic en Orquestador y seleccione la opción Orquestador: entorno apropiada.
3.
Desplácese hasta la carpeta de destino.
4.
Haga clic con el botón secundario del ratón en la carpeta de destino y, a
continuación, seleccione Importar.
5.
En el cuadro de diálogo Importar, acceda al archivo .xml que ha exportado y haga
clic en Abrir.
Nota: Asegúrese de que el archivo .xml que se desea importar no tiene un tamaño
mayor a 250 MB.
Capítulo 12: Publicación de objetos en otro entorno 489
Exportación e importación
6.
Especifique cómo importar un objeto que tiene el mismo nombre que un objeto
existente en la misma ruta.
Nota: Si se importa a una carpeta vacía, no puede haber ningún tipo de conflicto
con nombres existentes.
Importar
El objeto importado se procesa como si fuera una versión nueva del objeto
existente. Seleccione esta opción si la finalidad de esta importación es una
actualización y desea conservar el historial de las versiones anteriores. Si el
objeto importado tiene la misma versión de publicación, se sobrescribe la
versión de publicación existente con la versión de publicación del objeto
importado.
No importar
La importación del objeto se detiene y se conserva el objeto existente. El
proceso de importación mostrarán los objetos con nombres que pueden
generar conflictos. Si hay conflictos, puede realizar la importación a una
carpeta vacía. Si lo desea, también puede renombrar el objeto en el entorno
fuente y, a continuación, repetir la exportación y la importación. Esta opción es
adecuada cuando los objetos que se van a importar son nuevos, en lugar de
versiones nuevas de objetos existentes.
Importar y reemplazar
Suprima el objeto existente e importe la versión nueva del objeto como la
versión 0.
490 Guía del diseñador de contenido
Exportación e importación
7.
Defina las especificaciones de importación según las directrices siguientes:
Establecer la versión importada como actual
Especifica si se debe configurar la versión importada como la Actual. Esta
opción es relevante si se ha seleccionado Importar y reemplazar en el paso 6.
■
Seleccionado: la versión importada se configura como la actual.
■
No seleccionado: deja configurada como actual la versión existente que
está marcada como actual. Desactive esta opción si la versión anterior de
este objeto es la que está activa.
Nota: Si está buscando en una jerarquía de la carpeta con un paquete de
contenidos, el producto devuelve solamente los objetos de la versión de
publicación actual del paquete de contenidos. El producto también
devuelve objetos que residen en la jerarquía de la carpeta, pero que no se
encuentran en el paquete de contenidos.
Dar disponibilidad a los operadores personalizados importados
Especifica si los operadores personalizados importados se deben establecer
como disponibles. No se pueden utilizar operadores personalizados hasta que
están disponibles.
■
Seleccionado: los operadores personalizados importados pasan a estar
disponibles. Seleccione esta opción para que los usuarios no tengan que
configurar individualmente como disponibles los operadores
personalizados importados.
■
No seleccionado: los operadores personalizados se importan sin cambiar
su disponibilidad.
Publicar configuración del grupo de operadores personalizados
Especifica si los grupos de operadores personalizados se deben publicar. La
publicación está aconsejada cuando se importa un objeto, una carpeta o un
paquete en un dominio diferente del dominio desde el que se exportó el
archivo. Con la acción de publicar, los grupos de operadores personalizados se
publican en la ficha Módulos de nivel de dominio, donde cada entorno también
contiene los grupos que heredan del dominio.
■
Seleccionado: se publican los grupos de operadores personalizados. Esta
configuración se aplica cuando se importan grupos de operadores
personalizados a un dominio diferente del dominio en el que se diseñaron
los grupos de operadores personalizados.
■
No seleccionado: no se publican los grupos de operadores personalizados.
Esta configuración se aplica cuando las configuraciones de grupos de
operadores personalizados importados se publicaron en el dominio actual
y sus entornos en el momento de definir el grupo de operadores
personalizados.
Nota: Si no tiene derechos de Group_Config_Admin, esta opción está
desactivada.
Capítulo 12: Publicación de objetos en otro entorno 491
Exportación e importación
8.
Haga clic en Enviar.
9.
Haga clic en Aceptar en el mensaje que confirma que la importación es correcta.
Versión de publicación y estado de línea de referencia de los objetos importados
El estado del atributo Versión de publicación (modificable o no modificable) y el estado
Línea de referencia de cada objeto importado dependen de las condiciones siguientes:
■
Si el entorno de importación ya contiene versiones existentes de los objetos que se
van a importar.
■
Si los objetos existen, si los objetos se importan con la opción de importar como
una versión nueva y conservar las versiones de objeto existentes.
Las siguientes opciones de importación están disponibles para gestionar los objetos
existentes para los cuales la importación es una versión nueva:
■
Suprimir el objeto existente y tratar la versión del objeto importada como la versión
0.
■
Conservar el objeto existente y tratar la versión de objeto importada como una
versión nueva.
492 Guía del diseñador de contenido
Exportación e importación
Caso 1: las versiones importadas son las únicas versiones de los objetos en el entorno
de importación.
La versión importada es la única versión del objeto en las situaciones siguientes:
■
El objeto no existía en el entorno de importación antes de importar.
■
El objeto existía, pero el objeto importado ha reemplazado al objeto existente con
el mismo nombre.
Tenga en cuenta las propiedades de un objeto creado. La versión 0 del objeto está
marcada como actual, no está configurada como línea de referencia y tiene un atributo
Versión de publicación modificable.
■
Cuando la versión de publicación del archivo XML no es modificable, el estado del
atributo Versión de publicación del objeto importado no es modificable y la versión
nueva se configura como línea de referencia.
■
Cuando la versión de publicación del archivo XML es modificable, el estado del
atributo Versión de publicación del objeto importado es modificable y la versión
nueva no se configura como línea de referencia.
La ilustración siguiente resume los casos:
Capítulo 12: Publicación de objetos en otro entorno 493
Exportación e importación
Caso 2: las versiones importadas son las versiones nuevas de objetos existentes en el
entorno de importación.
Consideremos el caso en el que se importa una versión nueva de un objeto existente,
cuyo el atributo Versión de publicación del objeto existente no es modificable.
■
Cuando la versión de publicación del archivo XML no es modificable, el estado del
atributo Versión de publicación del objeto importado no es modificable y la versión
nueva se configura como línea de referencia.
■
Cuando la versión de publicación del archivo XML es modificable, el estado del
atributo Versión de publicación del objeto importado no es modificable y la versión
nueva no está configurada como línea de referencia.
Consideremos el caso en el que se importa una versión nueva de un objeto existente,
cuyo atributo Versión de publicación del objeto existente es modificable.
■
Cuando la versión de publicación del archivo XML no es modificable, el estado del
atributo Versión de publicación del objeto importado no es modificable y la versión
nueva se configura como línea de referencia.
■
Cuando la versión de publicación del archivo XML es modificable, el estado del
atributo Versión de publicación del objeto importado es modificable y la versión
nueva no se configura como línea de referencia.
La ilustración siguiente resume estos casos:
494 Guía del diseñador de contenido
Exportación e importación
Valores mantenidos en la versión inicial de un objeto copiado
La versión actual de un objeto es el elemento que se copia y se pega. Es decir, la copia
nueva tiene una versión, la versión actual del objeto original. El valor Versión de
publicación y el hecho de si es modificable se mantienen en la versión inicial de la copia
del objeto. Si en la importación, la versión actual del objeto original estaba configurada
como línea de referencia, la copia del objeto también lo estará.
Capítulo 12: Publicación de objetos en otro entorno 495
Apéndice A: Especificadores de formato
para fechas
CA Process Automation utiliza fecha de Java de estándar y las cadenas de patrón de
formato de hora. Dentro de las cadenas de patrón de fecha y hora, las letras sin comillas
de la 'A' a la 'Z' y de la 'a' a la 'z' se interpretan como letras de patrón que representan
los componentes de una cadena de fecha u hora. Se puede citar texto utilizando
comillas simples (') o dobles (") para evitar la interpretación. "''" representa una sola
cita. Todos los demás caracteres no se interpretan; se copian en la cadena de resultado
durante el formato o se hacen coincidir con la cadena de entrada durante el análisis.
Letra
Componente de fecha u
hora
Presentación
Ejemplos
G
Asignador de era
Texto
d.C
s
Año
Año
2009; 09
M
Mes del año
Mes
Julio; 07
w
Semana del año
Número
27
W
Semana del mes
Número
2
S
Día del año
Número
189
d
Día del mes
Número
10
F
Día de la semana del mes Número
2
E
Día de la semana
Texto
Martes; Ma
a
Marcador a.m./p.m.
Texto
p.m.
A
Hora del día (0-23)
Número
0
k
Hora del día (1-24)
Número
24
K
Hora en a.m./p.m. (0-11)
Número
0
h
Hora en a.m./p.m. (1-12)
Número
12
he
Minutos en la hora
Número
30
s
Segundos en el minuto
Número
55
S
Milisegundo
Número
978
z
Zona horaria
Zona horaria general
Hora estándar del Pacífico;
PST; GMT-08:00
Z
Zona horaria
Zona horaria de RFC 822
-0800
Apéndice A: Especificadores de formato para fechas 497
Exportación e importación
Normalmente, los patrones se repiten; su número determina la presentación exacta
como se muestra en la tabla siguiente:
Presentación
Formato
Texto
Si el número de letras del patrón es 4 o más, se utiliza todo el formulario; de lo contrario,
se acepta un formulario corto o abreviado, independiente del número de letras del
patrón.
Número
El número de letras del patrón es el número mínimo de dígitos y los números más cortos
se rellenan con ceros para este monto. Durante el análisis, el número de letras de patrón
se ignora a menos que se necesite para separar dos campos adyacentes.
Año
Si el número de letras de patrón es 2, el año se trunca a 2 dígitos; de lo contrario, se
interpreta como un número.
Durante el análisis, si el número de letras de patrón es más de 2, el año se interpreta
literalmente, sin tener en cuenta el número de dígitos. Entonces, al utilizar el patrón
"MM/dd/yyyy", "11/01/12" se analiza como 11-ene-12 d. C.
Mes
Si el número de letras de patrón es 3 o más, el mes se interpreta como un texto; de lo
contrario, se interpreta como un número.
Zona horaria general
Las zonas horarias se interpretan como texto si tienen nombres. Para las zonas horarias
que representan un valor de diferencia horaria de GMT, se utiliza la sintaxis siguiente:
■
GMTOffsetTimeZone:
■
Horas de signo de GMT: Minutos
■
El signo es + o -
■
Las horas deben ser entre 0 y 23 y deben tener uno de los formatos siguientes:
Dígito
Dígito Dígito
■
■
Los minutos deben ser entre 00 y 59 y en el formato siguiente:
Dígito Dígito
El dígito es uno de los siguientes:
0123456789
El formato es la configuración local independiente y se deberá tomar del bloque latino
básico del estándar Unicode.
Zona horaria de RFC
822
Se utiliza un formato de zona horaria de cuatro dígitos:
■
RFC822TimeZone:
Sing TwoDigitHours Minutes
■
TwoDigitHours deben ser entre 00 y 23. Para las demás definiciones, aplican las
zonas horarias generales.
498 Guía del diseñador de contenido
Exportación e importación
SimpleDateFormat también es compatible con las cadenas de patrón de fecha y hora
localizadas. En estas cadenas, las letras de patrón descritas anteriormente se pueden
reemplazar con otra, dependiente de la configuración local y letras de patrón.
SimpleDateFormat no trata con la localización de texto que no sea las letras de patrón;
eso es a criterio del cliente de la clase.
Los ejemplos siguientes muestran cómo se interpretan patrones de fecha y hora en la
configuración local en inglés de EE.UU. La fecha y la hora dadas son 2009-07-04
12:08:56 en la zona horaria del Pacífico en EE. UU.
Patrón de fecha y hora
Resultado
"yyyy.MM.dd G 'at' HH:mm:ss z"
2009.07.04 d.C a las 12:08:56 Hora de verano del
Pacífico
"EEE, MMM d, ''yy"
Miér, 4 de jul, '09
"h:mm a"
12:08 p.m.
"hh 'o''clock' a, zzzz"
12 en punto p.m., hora de verano del Pacífico
"K:mm a, z"
0:08 p.m., Hora de verano del Pacífico
"yyyyy.MMMMM.dd GGG hh:mm aaa"
02009.julio.04 d. C. 12:08 p.m.
"EEE, d MMM yyyy HH:mm:ss Z"
Mi, 4 de jul 2009 12:08:56 -0700
"yyMMddHHmmssZ"
010704120856-0700
"yyyy-MM-dd'T'HH:mm:ss.SSSZ"
2009-07-04T12:08:56.235-0700
Apéndice A: Especificadores de formato para fechas 499
Apéndice B: Cómo usar máscaras para
especificar patrones en cadenas
Se usan máscaras para los parámetros del operador que monitorizan mensajes y
contenido de archivo. Las máscaras que usa CA Process Automation son expresiones
regulares de JavaScript que describen conjuntos de cadenas sin decir cuál es su
contenido en realidad.
Se pueden usar máscaras para determinar si hay coincidencia con un patrón en
particular y para extraer partes de la cadena coincidente. CA Process Automation pone
las subcadenas extraídas en las variables que se pueden utilizar para especificar valores
de parámetro para otros operadores. Entre los operadores que usan máscaras se
incluye el operador Entradas de directorio y las macros de extracción. También se
pueden usar máscaras para especificar cadenas permisibles, como formatos de fecha
para los campos de entrada de texto.
Esta sección contiene los siguientes temas:
Sintaxis de la máscara (en la página 501)
Máscara de muestra (en la página 505)
Sintaxis de la máscara
Una expresión regular está formada por una secuencia de caracteres que deben
corresponder a los que aparecen en las cadenas que coinciden. Los caracteres
mostrados en la tabla siguiente sirven como operadores de expresión regular
Operador de expresión Descripción
regular
.
Ejemplo
El operador de punto representa
La expresión a.b coincide con cualquier
cualquier carácter excepto un carácter de cadena de tres caracteres que comience
fin de línea.
con “a” y finalice con “b”.
Apéndice B: Cómo usar máscaras para especificar patrones en cadenas 501
Sintaxis de la máscara
Operador de expresión Descripción
regular
Ejemplo
\
La escapatoria activa el uso del operador
como caracteres literales en lugar de ser
reconocido como operadores.
Si una máscara se especifica como una
cadena literal en una expresión de CA
Process Automation, el operador de
escapatoria debe sustituirse para evitar
que el carácter de escapatoria sea
desarmado por el intérprete de expresión
de CA Process Automation antes de que
la máscara se pase al analizador de
expresión regular.
El carácter sustituido \\ coincide con el
carácter de barra inclinada invertida \.
El operador sustituido \| coincide con la
barra vertical.
Para una cadena literal en una expresión de
CA Process Automation, "\\"? coincide con
el signo de interrogación.
\n
Secuencia de carácter de escapatoria de
fin de línea.
La expresión
Si una máscara se especifica como una
cadena literal en una expresión de CA
Process Automation, la secuencia del
carácter de escapatoria debe sustituirse
para evitar que el carácter de escapatoria
sea desarmado por el intérprete de
expresión de CA Process Automation
antes de que la máscara se pase al
analizador de expresión regular.
primera línea\n segunda línea
coincide las cadenas en donde "primera
línea" aparece al final de una línea y
"segunda línea" aparece en el inicio de la
línea siguiente.
Si una cadena literal especifica la misma
expresión en una expresión de CA Process
Automation, el operador se sustituye de la
siguiente manera:
"primera línea\\n segunda línea"
|
Alternativa. Este operador crea una
alternativa entre los caracteres o grupos.
Aplica al carácter o grupo
inmediatamente adyacente a su izquierda
o derecha.
(a|b) coinciden con el carácter "a" o el
carácter "b".
(abcd)|(efgh) coincide con la cadena “abcd”
o la cadena “efgh”.
(ab|Bc) coincide con la cadena "abc" o la
cadena "aBc".
()
Grupo. Este operador agrupa caracteres
en una sub-expresión que aplica a
operadores alternativos y de repetición.
(abcd)|(efgh) coincide con la cadena “abcd”
o la cadena “efgh”.
(abcde)* coincide con cero, uno o varios
resultados sucesivos de la cadena "abcde",
mientras que abcde* coincide con cadenas
que empiezan con "abcd" seguidas por un
cero o por caracteres de más "e".
502 Guía del diseñador de contenido
Sintaxis de la máscara
Operador de expresión Descripción
regular
Ejemplo
[]
Esta construcción coincide con un carácter
individual. [0-9] coincide con un dígito.
[aeiou] coincide con una vocal.
Se utiliza para definir una clase de
caracteres por inclusión. Es una lista
compuesta de caracteres individuales e
intervalos (intervalos).
[a-cx z9] coincide con una letra entre los
primeros tres y los últimos tres caracteres
del alfabeto o el dígito 9.
[0-9]+ coincide con un entero.
[^] Se utiliza para definir una clase de
caracteres por exclusión.
Esta construcción coincide con un carácter
individual. [^0-9] coincide con cualquier
carácter excepto con un dígito.
[^aeiou] coincide con cualquier carácter
excepto con una vocal.
*
Repetición. Define cero o más resultados
del carácter o grupo que aparece
inmediatamente junto al operador. La
serie puede estar vacía. a* coincide con
cero o con más caracteres "a".
(123)* coincide con cero o más repeticiones
de la cadena "123".
123* coincide con los dígitos 12 seguidos
por cero o más caracteres "3".
+
Repetición. Define uno o más resultados
del carácter o grupo que aparece
inmediatamente junto al operador. La
serie no puede estar vacía.
a+ coincide con uno o más caracteres "a".
(ab)+ coincide con una serie de una o más
repeticiones de la cadena "ab".
[a-z, |.] coincide con una serie de palabras
en pequeñas letras, separadas por espacios,
comas o puntos.
?
Se utiliza para indicar que el carácter o
grupo que precede el operador es
opcional. ab?c coincide con las cadenas
"abc" y "ac".
a(X|Y)?b coincide con las cadenas "ab",
"aXb" y "aYb".
{n}
Se utiliza para definir un número preciso
de repeticiones del carácter o agruparse
precediendo el operador.
[0-9]{,2} coincide con un número de
exactamente dos dígitos.
(ab){2} coincide con la cadena "abab".
abc{2} coincide con la cadena "abcc".
(a{2})* coincide con las cadenas de un
número par de caracteres "a".
Apéndice B: Cómo usar máscaras para especificar patrones en cadenas 503
Sintaxis de la máscara
Operador de expresión Descripción
regular
Ejemplo
{n,m}
Se utiliza para especificar que el número
de incidencias del carácter o grupo que
precede el operador es entre n y m.
[0-9]{2,3} coincide con un número de dos o
tres dígitos.
(ab){1,2} coincide con la cadena "ab" o
"abab".
{n,}
Se utiliza para especificar que el número
de incidencias del carácter o grupo que
precede el operador es n o mayor.
[0-9]{,2} coincide con un número de al
menos dos dígitos.
{n,}
Se utiliza para especificar que el número
de incidencias del carácter o grupo que
precede el operador es n o menor.
[0-9]{,2} coincide con números que
equivalen a 99 o son menores, incluyendo
la cadena vacía.
504 Guía del diseñador de contenido
Máscara de muestra
Máscara de muestra
El patrón siguiente permite el filtrado preciso del resultado del comando de DIR en la
shell de comando de Windows:
([0-9]{2}/){2}[0-9]{2} *[0-9]{2}:[0-9]{2}(a|p) *[0-9,]+ [_~0-9a-zA-Z ]*(\.[_0-9a-zA-Z ]*)?
Las líneas siguientes coinciden con este patrón:
26/10/05 07:03p 134,217,723 pagefile.sys
26/10/05 07:03p 1,024 testfile
Las líneas anteriores se forman con los elementos siguientes:
■
([0-9]{2}/) representa cadenas de carácter compuestas de dos dígitos y una marca
de barra (/), como en "10/".
■
([0-9]{2}/){2}[0-9]{2} genera sobre el elemento anterior y especifica que la
secuencia de dos dígitos se puede repetir 3 veces, cada secuencia se separa de la
siguiente con una marca de barra, como en "26/10/05".
■
*[0-9]{2}:[0-9]{2}(a|p) coincide con cualquier número de espacios seguidos por la
hora en el formato hh:mm seguido de "a" para a.m. o "p" para p.m.
■
*[0-9,]+ coincide con cualquier número de espacios seguidos por cualquier número
de dígitos y comas para el tamaño de archivo.
■
[_~0-9a-zA-Z]*(\.[_~0-9a-zA-Z]*)? representa una secuencia de caracteres
alfanuméricos, subrayado (_) y tildes (~), opcionalmente seguidas por un período y
otra secuencia. Debido a que el punto (.) es el operador de punto, es necesario
sustituirlo por el carácter de escapatoria (\) cuando pretendemos que coincida
como carácter.
El patrón en una máscara puede diferir dependiendo de los caracteres exactos que
tienen que coincidir. Por ejemplo [\._~0-9a-zA-Z ]* en lugar de
[_~0-9a-zA-Z]*(\.[_~0-9a-zA-Z]*)? podría coincidir también con los nombres de archivo
en nuestros resultados de ejemplo, pero sin imponer restricciones al número de puntos
(.) en el nombre del archivo.
Apéndice B: Cómo usar máscaras para especificar patrones en cadenas 505
Apéndice C: Cómo se procesan los objetivos
de un operador
Este apéndice describe cómo procesa CA Process Automation objetivos del operador.
Esta sección contiene los siguientes temas:
Cómo se pueden especificar los objetivos para un operador (en la página 507)
Cómo procesar un objetivo especificado como una dirección IP o FQDN (en la página
508)
Cómo procesar un objetivo especificado como el ID de un agente u orquestador (en la
página 513)
Caso de Uso: Seguimiento de procesos recuperados mediante registros (en la página
514)
Ejemplo de recuperación automática de operadores (en la página 515)
Cómo se pueden especificar los objetivos para un operador
El objetivo de un operador es el host en el que se ejecuta el operador. Un host que
puede ser el objetivo de un operador se deberá configurar con un punto de contacto, un
punto de contacto de proxy o un grupo de host. Al determinar las configuraciones de
ejecución para un operador, los diseñadores de contenido normalmente seleccionan el
host objetivo en función de cómo está configurado dicho objetivo.
Especifique el objetivo tal y como se indica en la lista siguiente cuando se cumplan las
condiciones oportunas:
Punto de contacto
El host objetivo tiene instalado un orquestador o un agente. Cuando se especifica
un punto de contacto como objetivo de un operador y ese punto de contacto se
activa y se asocia con un orquestador o agente activo, CA Process Automation
ejecuta el operador en el punto de contacto especificado. Si un punto de contacto
objetivo está asociado con un solo agente u orquestador, cada ejecución tiene
como objetivo el mismo host. Si un punto de contacto está asociado a varios
agentes con la misma prioridad, cada ejecución podría tener como objetivo un
agente diferente en un host distinto.
Grupo de punto de contacto
El operador se ejecutará en todos los host que están asociados a puntos de
contacto del grupo de puntos de contacto especificado.
Apéndice C: Cómo se procesan los objetivos de un operador 507
Cómo procesar un objetivo especificado como una dirección IP o FQDN
<AgentID>
Excepción del punto de contacto: especifique el mismo ID de agente para
operadores consecutivos cuando el proceso requiere que el operador se ejecute en
el mismo host que el operador anterior. Indique un ID de agente específico cuando
el proceso requiera que el operador se ejecute en el mismo host cada vez que se
ejecute. Una prueba ejecutada del operador muestra la cadena ID de agente en el
conjunto de datos del sistema. Copie la cadena ID de agente del conjunto de datos
en el campo Objetivo.
Punto de contacto de proxy
El host objetivo se especifica como el host remoto en una configuración de punto
de contacto de proxy. Generalmente, este host no tiene un agente ni un
orquestador instalado.
Dirección IP o FQDN
El host objetivo tiene una dirección IP o un FQDN que pueden coincidir con un
patrón en un grupo de host configurados. Generalmente, este host no tiene un
agente ni un orquestador instalado.
Nota: El nombre de host se puede utilizar, pero se prefiere FQDN.
Importante: Se pueden producir resultados inesperados si se especifica el objetivo con
un punto de contacto que tiene el mismo nombre que un host del entorno. También se
pueden producir resultados inesperados si el agente asociado a ese punto de contacto
está inactivo cuando se ejecuta el operador. En este caso, CA Process Automation no
ejecuta el operador en el punto de contacto. En lugar de ello, CA Process Automation
intenta resolver el objetivo (pensado para ser el punto de contacto) para el nombre de
un host en el entorno. Si encuentra un nombre de host de este tipo, CA Process
Automation busca otro punto de contacto, orquestador, punto de contacto de proxy o
grupo de host que ejecute sus operadores en este host. CA Process Automation ejecuta
el operador en el primer resultado que encuentre.
Cómo procesar un objetivo especificado como una dirección IP
o FQDN
Cuando se utiliza una dirección IP o un FQDN para especificar el host objetivo de un
operador, CA Process Automation consulta repetidamente el Servidor de nombre de
dominio (DNS). Si especifica un FQDN como el objetivo, la primera búsqueda devuelve
las direcciones IP definidas en el host con ese FQDN. Si especifica una dirección IP, la
primera búsqueda devuelve el FQDN para ese host y las direcciones IP asociadas a ese
FQDN. Cada búsqueda subsiguiente se prueba en comparación con todos los
especificadores del host que se recuperan en la búsqueda inicial.
508 Guía del diseñador de contenido
Cómo procesar un objetivo especificado como una dirección IP o FQDN
CA Process Automation busca todas las formas en que está configurado el host objetivo
en el entorno de CA Process Automation actual. Los grupos de host definen host
remotos con patrones de nombres de host y subredes. Por lo tanto, un grupo de host
puede incluir host con orquestadores o agentes que están asignados a puntos de
contacto. Un grupo de host también puede incluir host individuales que están asignados
a un punto de contacto de proxy. Un host que se identifica con una dirección IP o un
FQDN se podría haber procesado con un nombre del punto de contacto o con un
nombre de punto de contacto de proxy.
Algunas búsquedas encuentran orquestadores o agentes activos que están definidos en
los host que tienen activados los puntos de contacto. Otra búsqueda encuentra un
punto de contacto de proxy activado en un agente activo que está asignado al host. Una
búsqueda encuentra grupos de host activos en un agente activo con patrones de
nombres de host o subredes de dirección IP que coinciden con la dirección IP o el FQDN
del host. Cuando se cumplen los criterios de búsqueda, estas consultas retrasan el inicio
de la ejecución del operador. CA Process Automation ejecuta el operador en el primer
punto de contacto, punto de contacto de proxy o grupo de host que primero encuentra
activo que se esté ejecutando en un agente o un orquestador activo. El punto de
contacto, el punto de contacto de proxy o el grupo de host deben pertenecer al entorno
actual. Cuando no se cumple ninguno de los criterios de búsqueda, el operador falla y se
genera un mensaje de error.
Apéndice C: Cómo se procesan los objetivos de un operador 509
Cómo procesar un objetivo especificado como una dirección IP o FQDN
El área Objetivo de la ficha Configuración de ejecución para los operadores contiene una
casilla de verificación denominada "Coincidir solamente con el objetivo en los grupos de
host". Seleccione esta casilla de verificación en estos casos:
■
Al especificar una dirección IP dentro de una subred que se especifica en un grupo
de host.
■
Al especificar un nombre de host que coincide con un patrón especificado en un
grupo de host.
Cuando se selecciona casilla de verificación Buscar en DNS, CA Process Automation
resuelve el nombre del objetivo haciendo una búsqueda en DNS. La búsqueda consiste
en encontrar un registro que coincida con una referencia en función del grupo de host.
Tenga en cuenta el caso en el que se desactiva esta casilla de verificación, pero en el que
existe el FQDN y la dirección IP del objetivo. El siguiente procesamiento determina el
host en el que se ejecuta el operador:
1.
2.
La aplicación busca los DNS de todos los identificadores para el objetivo
especificado. Si el objetivo está especificado como un FQDN, CA Process
Automation busca todas las direcciones IP para ese FQDN. Si el objetivo es una
dirección IP, CA Process Automation busca el FQDN y otras direcciones IP para
dicho FQDN.
■
Si falla la conexión con el DNS, la aplicación escribe un error en el archivo de
registro y se cierra.
■
Si la consulta devuelve el FQDN y otras direcciones IP, la aplicación utiliza la
dirección IP especificada y este conjunto de resultados para todas las
búsquedas subsiguientes.
■
Si la consulta devuelve una o varias direcciones IP, la aplicación utiliza el FQDN
especificado y las direcciones IP en todas las búsquedas subsiguientes.
La aplicación busca un orquestador activo con un punto de contacto activado (en el
entorno actual) que se instala en un host en los resultados de la búsqueda del paso
1.
■
Si se encuentra, la aplicación ejecuta el operador en ese punto de contacto del
orquestador.
■
Si no se encuentra, la aplicación continúa con el procesamiento.
Nota: La aplicación no detecta orquestadores en clúster. Los host con
orquestadores en clúster no aparecen en la configuración del dominio.
510 Guía del diseñador de contenido
Cómo procesar un objetivo especificado como una dirección IP o FQDN
3.
4.
La aplicación busca un agente activo con un punto de contacto activado (en el
entorno actual) que se instala en un host en los resultados de la búsqueda del paso
1.
■
Si el host tiene un agente activo con un punto de contacto activado, CA Process
Automation usa dicho punto de contacto para ejecutar el operador.
■
Si el host tiene un agente activo con varios puntos de contacto activados, CA
Process Automation usa uno de los puntos de contacto activados para ejecutar
el operador.
■
Si no se encuentra, la aplicación continúa con el procesamiento.
La aplicación busca un agente activo que está conectado al host objetivo remoto.
Este agente debe tener un punto de contacto de proxy activado o un grupo de host
en el entorno actual. En el caso de grupos de host, las consultas utilizan
coincidencias de patrón. Las consultas del grupo de host encuentran si el patrón del
nombre de host o la subred de referencia incluyen un identificador de host en el
conjunto de resultados del paso 1. Para los puntos de contacto de proxy, la
aplicación busca una coincidencia exacta con cualquiera de los identificadores de
host recuperados en el paso 1.
■
Si la única coincidencia es un host remoto al que hace referencia un punto de
contacto de proxy, la aplicación ejecuta el operador en dicho host remoto.
■
Si la única coincidencia es un host remoto al que hace referencia un grupo de
host, la aplicación ejecuta el operador en dicho host remoto.
■
Si la aplicación encuentra varias coincidencias, ejecuta el operador en el primer
host remoto que encuentre y al que haga referencia un punto de contacto de
proxy o un grupo de host.
■
Si no hay ninguna coincidencia con los criterios de búsqueda, la aplicación
continúa con el procesamiento.
Apéndice C: Cómo se procesan los objetivos de un operador 511
Cómo procesar un objetivo especificado como una dirección IP o FQDN
5.
La aplicación determina por qué no se ha ejecutado el operador. A continuación, la
aplicación produce un error en el operador con un mensaje de error.
■
Condición: ninguno de los identificadores recuperados en el paso 1 pertenece a
un host del entorno actual.
Resultado: la aplicación produce un error en el operador con el siguiente
mensaje:
No pudo publicarse el mensaje en el nodo.
■
Condición: uno o varios identificadores recuperados en el paso 1 pertenecen a
un host donde todos los orquestadores y los agentes están inactivos.
Resultado: el operador produce un error con el siguiente mensaje:
No pudo publicarse el mensaje en el nodo.
■
Condición: uno o varios identificadores del paso 1 pertenecen a un host con
todos los puntos de contacto desactivados o al que se hace referencia
únicamente con grupos de host o puntos de contacto del proxy desactivados.
Resultado: la aplicación devuelve un punto de contacto o un grupo de host
desactivados en el campo TouchpointName de las variables de salida del
sistema del conjunto de datos del operador. La aplicación produce un error en
el operador con el siguiente mensaje de error:
El nodo está desactivado.
Nota: Tenga en cuenta la excepción en la que el usuario especifica un nombre de host o
dirección IP en el campo Objetivo de un operador del tipo Invocar Java. CA Process
Automation busca primero un host de agente coincidente. Si lo encuentra, el operador
Invocar Java se ejecuta en el host del agente. Si la búsqueda produce un error, la
aplicación busca un host de orquestador coincidente. Si lo encuentra, intenta ejecutarlo,
pero el operador Invocar Java produce un error debido a que no puede ejecutarse en un
orquestador.
Más información:
Valores de configuración objetivo (en la página 241)
512 Guía del diseñador de contenido
Cómo procesar un objetivo especificado como el ID de un agente u orquestador
Cómo procesar un objetivo especificado como el ID de un
agente u orquestador
Suponga que se desee que un operador tenga como objetivo el mismo host cada vez
que se ejecuta. En ese caso, se pueden especificar los datos de AgentID como un
objetivo. En la instalación de cada orquestador y cada agente se configuran los datos
únicos de AgentID. En tiempo de ejecución, CA Process Automation recupera el ID del
orquestador o del agente y lo guarda en el campo AgentID en el conjunto de datos del
sistema.
Después de la ejecución de prueba de un operador, se puede copiar la cadena ID de
agente que se muestra en el conjunto de datos del sistema en el campo Objetivo.
En el caso que se necesitan dos operadores consecutivos para ejecutarse en el mismo
host de agente, especifique el mismo AgentID que el objetivo para los dos operadores.
Se puede utilizar AgentID como objetivo alternativo para cualquier punto de contacto
determinado.
Importante: El uso de AgentID hace referencia al host local donde está instalado el
agente o el orquestador. Cuando se especifica AgentID, CA Process Automation no
utiliza el punto de contacto de proxy o el grupo de host que se ejecuta en el agente para
ejecutar operaciones en host remotos. Considere el caso en donde Operator_1 se
ejecuta en un punto de contacto de proxy configurado en un agente con un ID de
agente especificado. No utilice este AgentID como objetivo para Operator_2. Si se
especifica el AgentID, CA Process Automation no se ejecuta en ese punto de contacto de
proxy para Operator_2.
CA Process Automation produce un error en el operador cuando se encuentra
cualquiera de las condiciones siguientes:
■
El agente del objetivo o del orquestador está inactivo. CA Process Automation envía
el mensaje siguiente:
No pudo publicarse el mensaje en el nodo.
■
Todos los puntos de contacto asignados al objetivo están desactivados. CA Process
Automation muestra el mensaje siguiente cuando uno de los puntos de contacto
está desactivado:
El nodo está desactivado.
Nota: El operador Invocar Java solo puede dirigir agentes. El operador Invocar Java no
puede ejecutarse en un orquestador. Un ID del campo Objetivo del operador Invocar
Java debe resolver un agente (no un orquestador); de lo contrario, el operador
producirá un error.
Apéndice C: Cómo se procesan los objetivos de un operador 513
Caso de Uso: Seguimiento de procesos recuperados mediante registros
Caso de Uso: Seguimiento de procesos recuperados mediante
registros
El escenario siguiente es una alternativa a la apertura de numerosos procesos para
identificar aquellos que se han recuperado automáticamente. En este escenario se
examinan los archivos de registro.
Supuestos:
■
Se asigna un agente a dos puntos de contacto.
■
Se ejecutan más de 1000 procesos simultáneamente.
■
La recuperación automática de operadores está configurada para los puntos de
contacto.
Escenario:
1.
De repente, el agente queda inactivo.
2.
Mientras el agente está inactivo, 300 de los 1000 procesos intentan ejecutar
operadores en los puntos de contacto.
3.
Los 300 procesos quedan en estado BLOQUEADO.
4.
El agente se activa.
5.
La recuperación de operadores, que se inicia automáticamente, recupera los 300
procesos.
6.
Más tarde, se da cuenta de que 1000 procesos se han terminado de ejecutar. Abre
uno de ellos para examinar sus registros y descubrir que se recuperaron
automáticamente.
7.
Realice una de las acciones siguientes para averiguar cuáles de los 1000 procesos
que han finalizado lo han hecho después de recuperarse:
–
Abra cada uno de los 1000 procesos para determinar cuáles se recuperaron
automáticamente.
–
Examine el archivo de registro.
Nota: En el tema siguiente se describe la alternativa preferida, que es examinar el
archivo de registro.
514 Guía del diseñador de contenido
Ejemplo de recuperación automática de operadores
Ejemplo de recuperación automática de operadores
Si está seleccionada la opción Recuperación automática de operadores (opción
predeterminada), no es necesario que el usuario inicie la recuperación. Cada
orquestador del entorno detecta que el agente o el orquestador están activos y se lleva
a cabo la recuperación. Cada orquestador ejecuta la recuperación en los puntos de
contacto, grupos de host u orquestadores activados que estén asignados al agente o al
orquestador en el entorno.
Si el agente está asignado a muchos puntos de contacto, los orquestadores ejecutan la
recuperación en todos los puntos de contacto activados asignados al agente. Cuando se
activa un agente o un orquestador, el orquestador del dominio transmite los cambios a
los otros orquestadores. En una configuración agrupada en clúster, solamente el nodo
máster ejecuta la recuperación.
Ejemplo: recuperación automática
Considere el siguiente escenario donde se asigna un agente a los siguientes puntos de
contacto y grupos de host en un entorno:
■
TP_user01-w500,
■
TP_user01-w500_2
■
TP_user01-w500_3
■
TP_manyAgents
■
HG_user01-w500
Supongamos que todos los puntos de contacto y grupos de host están activados, pero
solo se han configurado para la Recuperación automática de operadores los siguientes
puntos de contacto y grupos de host:
■
TP_user01-w500
■
TP_user01-w500_3
■
HG_user01-w500
Cuando el agente se activa, cada orquestador del entorno intenta ejecutar la
recuperación automática en los tres puntos de contacto.
Apéndice C: Cómo se procesan los objetivos de un operador 515
Ejemplo de recuperación automática de operadores
Supongamos que hay dos orquestadores en el entorno:
El archivo de registro de Orquestador1 contiene:
■
Mensaje que indica al agente que se activó nuevamente:
2010-06-28 19:22:59,984 DEBUG
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Checking whether
to initiate Touchpoint/Orchestrator Recovery of 'System_Error' operators in
'Waiting' or 'Running' or 'Blocked' Processes (with auto recovery flag set), that
ran against Agent/Server ID: f3492322-5517-4a21-8a19-92838ccb3f65
■
El orquestador asignó el agente a HG_user01-w500:
2011-03-28 19:22:59,984 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Initiating
Touchpoint/Orchestrator: HG_user01-w500 Recovery... Recovering 'System_Error'
Operators that ran against: HG_user01-w500 and belong to 'Waiting' or 'Running'
or 'Blocked' Processes (with auto recovery flag set).
2011-03-28 19:22:59,984 DEBUG
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieve the processes (with enabled auto recovery
flag) that are in 'Waiting' or „Running‟ or 'Blocked' states and contain operators
in 'System Error' when ran against: HG_user01-w500
■
El orquestador indica que se recuperarán 0 procesos para HG_user01-w500:
2011-03-28 19:23:00,000 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieved - 0 processes to recover for
HG_user01-w500 recovery.
2011-03-28 19:23:00,000 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Found no
Processes to recover for Touchpoint/Orchestrator: HG_user01-w500 Recovery.
■
El orquestador asignó el agente a TP_user01-w500:
2011-03-28 19:23:00,000 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Initiating
Touchpoint/Orchestrator: TP_user01-w500 Recovery... Recovering 'System_Error'
Operators that ran against: TP_user01-w500 and belong to 'Waiting' or 'Running'
or 'Blocked' Processes (with auto recovery flag set).
2011-03-28 19:23:00,000 DEBUG
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieve the processes (with enabled auto recovery
flag) that are in 'Waiting' or „Running‟ or 'Blocked' states and contain operators
in 'System Error' when ran against: TP_user01-w500.
■
El orquestador indica que se recuperará 1 proceso para TP_user01-w500:
2011-03-28 19:23:00,015 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieved - 1 processes to recover for
TP_user01-w500 recovery.
516 Guía del diseñador de contenido
Ejemplo de recuperación automática de operadores
■
El orquestador pone en cola la solicitud de recuperación para el único proceso
(ROID: 2889) que se recuperará para TP_user01-w500:
2011-03-28 19:23:00,015 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Queueing recovery of process with ROID - 2889 for
TP_user01-w500 recovery.
2011-03-28 19:23:00,015 DEBUG
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Special Response for process recovery. ROID is 2889
UUID is 3fe95f08-a347-4d6d-a0a3-b3639836e130
2011-03-28 19:23:00,015 DEBUG
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Special Response for process recovery was posted.
ROID is 2889 UUID is 3fe95f08-a347-4d6d-a0a3-b3639836e130
2011-03-28 19:23:00,015 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Queued requests
for Touchpoint: TP_user01-w500 Recovery... Recovering Processes with the
following ROIDs: 2889
■
El orquestador indica que el punto de contacto TP_user01-w500_2 está asignado al
agente, pero no está configurado para la recuperación automática:
2011-03-28 19:23:00,015 DEBUG
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Touchpoint:
TP_user01-w500_2 mapped to Agent: f3492322-5517-4a21-8a19-92838ccb3f65 is not
set to Automatic Recovery of 'System_Error' operators in 'Waiting' or „Running‟
or 'Blocked' Processes.
■
El orquestador asignó el agente a TP_user01-w500_3:
2011-03-28 19:23:00,015 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Initiating
Touchpoint/Orchestrator: TP_user01-w500_3 Recovery. Recovering 'System_Error'
Operators that ran against: TP_user01-w500_3 and belong to 'Waiting' or 'Running'
or 'Blocked' Processes (with auto recovery flag set).
2011-03-28 19:23:00,015 DEBUG
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieve the processes (with enabled auto recovery
flag) that are in 'Waiting' or „Running‟ or 'Blocked' states and contain operators
in 'System Error' when ran against:: TP_user01-w500_3
■
El orquestador indica que se recuperarán 0 procesos para TP_user01-w500_3:
2011-03-28 19:23:00,015 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieved - 0 processes to recover for
TP_user01-w500_3 recovery.
2011-03-28 19:23:00,031 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Found no
Processes to recover for Touchpoint/Orchestrator: TP_user01-w500_3 Recovery.
Apéndice C: Cómo se procesan los objetivos de un operador 517
Ejemplo de recuperación automática de operadores
■
El orquestador indica que el punto de contacto TP_manyAgents está asignado al
agente, pero no está configurado para la recuperación automática:
2011-03-28 19:23:00,031 DEBUG
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Touchpoint:
TP_manyAgents mapped to Agent: f3492322-5517-4a21-8a19-92838ccb3f65 is not set
to Automatic Recovery of 'System_Error' operators in 'Waiting' or „Running‟ or
'Blocked' Processes
■
El orquestador obtiene la solicitud de recuperación de la cola para el proceso 2889:
2011-03-28 19:23:30,015 INFO
[com.optinuity.c2o.workflowengine.FlowManagerCache] [onPool Worker-3]
Registering flow manager: 2889
2011-03-28 19:23:30,015 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [onPool Worker-3] Handling
Response: [$$TouchpointRecovery&&]. flow id is 2889
2011-03-28 19:23:30,171 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [onPool Worker-3] Start
Recovery of Process with ROID:2889, for TP_user01-w500 Recovery.
■
El orquestador restablece los operadores con System_Error cuando se ejecutaron
con TP_user01-w500 dentro del proceso 2889:
2011-03-28 19:23:30,171 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [onPool Worker-3] Resetting
System_Error Operators in Process with ROID: 2889 for TP_user01-w500 Recovery.
2011-03-28 19:23:30,203 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [onPool Worker-3] Resetting
Operator with ROID: 2912 in Process with ROID: 2889 for TP_user01-w500 Recovery.
■
El orquestador reanuda todo el proceso 2889 después de haber restablecido los
operadores apropiados:
2011-03-28 19:23:30,343 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [onPool Worker-3] Resuming
Process with ROID: 2889 for TP_user01-w500 Recovery.
2011-03-28 19:23:30,343 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [onPool Worker-3] Resuming
WorkFlow - ROID is 2889
2011-03-28 19:23:30,703 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [onPool Worker-3] Done
resuming Process with ROID: 2889 for TP_user01-w500 Recovery.
El proceso 2889 se completa correctamente. Como el proceso de recuperación se
inició automáticamente, los registros del proceso indican que el motor fue el que
inició la recuperación. Para la recuperación manual, los registros incluyen el nombre
del usuario que inició la recuperación.
518 Guía del diseñador de contenido
Ejemplo de recuperación automática de operadores
El archivo de registro de Orchestrator2 (OrchestratorD610b) incluye lo siguiente:
■
Lo siguiente para OrquestadorD610b es similar a orquestador:
2011-03-28 19:23:41,444 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Initiating
Touchpoint/Orchestrator: HG_user01-w500 Recovery. Recovering 'System_Error'
Operators that ran against: HG_user01-w500 and belong to 'Waiting' or 'Running'
or 'Blocked' Processes (with auto recovery flag set).
2011-03-28 19:23:41,444 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieved - 0 processes to recover for
HG_user01-w500 recovery.
2011-03-28 19:23:41,444 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Found no
Processes to recover for Touchpoint/Orchestrator: HG_user01-w500 Recovery...
2011-03-28 19:23:41,444 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Initiating
Touchpoint/Orchestrator: TP_user01-w500 Recovery... Recovering 'System_Error'
Operators that ran against: TP_user01-w500 and belong to 'Waiting' or 'Running'
or 'Blocked' Processes (with auto recovery flag set).
2011-03-28 19:23:41,444 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieved - 0 processes to recover for
TP_user01-w500 recovery.
2011-03-28 19:23:41,444 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Found no
Processes to recover for Touchpoint/Orchestrator: TP_user01-w500 Recovery...
2011-03-28 19:23:41,444 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Initiating
Touchpoint/Orchestrator: TP_user01-w500_3 Recovery... Recovering 'System_Error'
Operators that ran against: TP_user01-w500_3 and belong to 'Waiting' or 'Running'
or 'Blocked' Processes (with auto recovery flag set).
Apéndice C: Cómo se procesan los objetivos de un operador 519
Ejemplo de recuperación automática de operadores
■
OrquestadorD610b encuentra 1 proceso que se va a recuperar para
TP_user01-W500_3 (ROID de proceso: 541) y pone en cola su solicitud de
recuperación:
2011-03-28 19:23:41,444 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieved - 1 processes to recover for
TP_user01-w500_3 recovery.
2011-03-28 19:23:41,444 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Queueing recovery of process with ROID - 541 for
TP_user01-w500_3 recovery.
2011-03-28 19:23:41,444 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Queued requests
for Touchpoint: TP_user01-w500_3 Recovery... Recovering Processes with the
following ROIDs: 541
2011-03-28 19:23:41,444 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Retrieved - 1 processes to recover for
TP_user01-w500_3 recovery.
2011-03-28 19:23:41,444 WARN
[com.optinuity.c2o.workflowengine.C2oWorkFlowEngine] [aListenerThread]
recoverSystemErrorProcesses: Queueing recovery of process with ROID - 541 for
TP_user01-w500_3 recovery.
2011-03-28 19:23:41,444 INFO
[com.optinuity.c2o.c2oserver.ServerManager] [aListenerThread] Queued requests
for Touchpoint: TP_user01-w500_3 Recovery... Recovering Processes with the
following ROIDs: 541
520 Guía del diseñador de contenido
Ejemplo de recuperación automática de operadores
■
OrquestadorD610b recibe la solicitud de recuperación, restablece los operadores
con System_Error, que se ejecutaron con TP_user01-w500_3, en el proceso y,
finalmente, se reanuda el proceso:
2011-03-28 19:24:11,461 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [nPool Worker-63] Handling
Response: [$$TouchpointRecovery&&]. flow id is 541
2011-03-28 19:24:11,804 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [nPool Worker-63] Start
Recovery of Process with ROID:541, for TP_user01-w500_3 Recovery.
2011-03-28 19:24:11,820 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [nPool Worker-63] Resetting
System_Error Operators in Process with ROID: 541 for TP_user01-w500_3 Recovery.
2011-03-28 19:24:11,883 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [nPool Worker-63] Resetting
Operator with ROID: 564 in Process with ROID: 541 for TP_user01-w500_3 Recovery.
2011-03-28 19:24:12,039 INFO
[com.optinuity.c2o.workflowengine.C2OSvcIconInstanceRefObject] [nPool
Worker-63] Inside Update ConnectorTraversed, Current/destination is
Start_System_Process_1 Source is Start_1
2011-03-28 19:24:12,117 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [nPool Worker-63] Resuming
Process with ROID: 541 for TP_user01-w500_3 Recovery.
2011-03-28 19:24:12,117 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [nPool Worker-63] Resuming
WorkFlow - ROID is 541
2011-03-28 19:24:12,133 INFO
[com.optinuity.c2o.workflowengine.C2OSvcIconInstanceRefObject] [nPool
Worker-63] Inside Update ConnectorTraversed, Current/destination is
Start_System_Process_1 Source is Start_1
2011-03-28 19:24:12,648 INFO
[com.optinuity.c2o.workflowengine.WorkflowManager] [nPool Worker-63] Done
resuming Process with ROID: 541 for TP_user01-w500_3 Recovery.
Apéndice C: Cómo se procesan los objetivos de un operador 521