ca process automation - support.ca.com process automation 04 2 00-esp... · esta documentación...

Guía del diseñador de contenido Versión 04.2.00

CA Process Automation

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.

http://www.ca.com/worldwide

Contenido 5

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

6 Guía del diseñador de contenido

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

Contenido 7

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


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

Contenido 9

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


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


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.

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)

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.

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.



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. Cargar los datos transformados

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



Identificación de los pasos de los procesos

Incluya cada paso que se realiza como parte del proceso o subproceso.


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

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


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.

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.


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.



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



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 especifica un curso predefinido de acción para una condición de salida específica.

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.



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.



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)



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.



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.



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.



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)



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)



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.

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.


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.



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.



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



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


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)

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.


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.

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.


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.

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.



Elemento:

Descripción:

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.



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.



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.



Elemento:

Descripción:

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.



Explorador de bibliotecas

Para gestionar objetos de automatización en carpetas, utilice el Explorador de bibliotecas.

Elemento:

Descripción:

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.



Elemento:

Descripción:

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.



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

Elemento:

Descripción:

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.



Elemento:

Descripción:

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.



También se pueden ejecutar instancias de proceso en la página Diseñador.



Elemento:

Descripción:

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



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?

Elemento:

Descripción:

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.



Elemento:

Descripción:

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.



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.

Elemento:

Descripción:

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.



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

Elemento:

Descripción:

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.



Elemento:

Descripción:

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.



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.

Elemento:

Descripción:



Elemento:

Descripción:

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.

Exploración del contenido original


Elemento:

Descripción:

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.


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.

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.


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.

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 3: Explorador de bibliotecas


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.


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 en el encabezado de la columna y elija Columnas.

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.



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.



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:

■ Nombre

■ Propietario

■ Tipo

■ Estado de incorporación

■ Fecha de creación

■ Fecha de modificación

■ Etiquetas

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

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



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*



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.



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




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.



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.




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.

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.



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.



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.



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.



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.



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.



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



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.



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.



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.



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.




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. Haga clic en Guardar.



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



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.


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.



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.




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.



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.




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.



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.





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.



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.



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.



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.

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

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

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




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



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.


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.




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.



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.



Elemento:

Descripción:

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.



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. Versión

actual.

Versión de trabajo. Descartar

versión de trabajo.

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.

Elemento:

Descripción:

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.



Elemento:

Descripción:

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



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.




3. En el panel Propiedades, haga clic en la ficha Versiones.


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.



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.


1. Haga clic en la ficha Explorador de bibliotecas.


El objeto se abre en su editor.


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


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.




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.


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.


1. En el explorador de bibliotecas, haga clic en el objeto.


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.


1. Extraiga un objeto (en la página 90).

2. Edite la versión de trabajo.


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.



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.



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.


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.



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:

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



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.



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.






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.



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.



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.



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.



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

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.

Observe los siguientes resultados:

■ 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).

5. (Opcional) Renombre los objetos nuevos.



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.



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.



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:



■ Importar

■ Crear objeto

■ Paste


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.


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)

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.



Elemen

to:

Descripción:

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.

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.

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.





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.

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.


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



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.

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.

Elemento:

Descripción:

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.



Elemento:

Descripción:

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.



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.



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.


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.



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.



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.



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.


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.

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.



Elemento:

Descripción:

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.



Elemento:

Descripción:

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.


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.



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



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.

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.


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.


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.



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



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.



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.



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.



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.


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.



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.



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.



Ejecución en bucle de serie de operadores

También se puede ejecutar en bucle una secuencia de operadores dentro de un operador Bucle.


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.



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.



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.



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.



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.



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

Elemento:

Descripción:

Operador Iniciar 1: empiece el proceso con un operador Iniciar estándar.

Control del proceso


Elemento:

Descripción:

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.

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.

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.


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.

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.

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:



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.

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.


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.

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.

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.

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.



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.

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.

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.


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.

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)

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 (_).

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.


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.


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.



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.


[Server URL]?page=Form&refPath=<path>


[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>


[Server URL]?page=Template&refPath=<path>

Conjunto de datos

[Server URL]?page=Dataset&refPath=<path>

Paquete

[Server URL]?page=C2OPackage&refPath=<path>




[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

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


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.


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.

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.



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


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.

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



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



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.



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.



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.



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)



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.


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.


Operadores (en la página 160) Iconos de operadores (en la página 200)

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.

Elemento:

Descripción:

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.

Operadores


Elemento:

Descripción:

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.

Elemento:

Descripción:

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.

Operadores


Elemento:

Descripción:

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.

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.



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.


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.

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.

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.

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.


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.

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.

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.


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:

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.

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.

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.

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.

Operadores




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

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

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

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.


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.

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.


1. En el Explorador de bibliotecas, haga doble clic en un operador personalizado.


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:


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.

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.

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.

Operadores



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)


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:

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 =



"mUserName");

Process.Password =



"mPassword");

Process.Port =



"mPort");

Process.DBName =



"mDBName");

Process.DBType =



"mDBType");

Process.DriverName =



"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:

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.

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.

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.

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.


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.


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.


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.



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.


Orden de ejecución del código de ejecución previa específico de los operadores personalizados

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.

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.

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.



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.

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.



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

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.

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.

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.




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.

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.


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.

■ Importar

■ Importar y reemplazar

■ No importar

5. (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.

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.

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.


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.


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.

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.



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. Haga clic en Actualizar.

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

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

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.

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.

Elemento:

Descripción:

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.



Elemento:

Descripción:

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.

Elemento:

Descripción:

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.



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.



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.



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.



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.



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.



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.



Aplicación de un icono personalizado a cualquier operador en un proceso

Se puede cambiar el icono para cualquier operador utilizado en un proceso.



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.


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.



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.


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.


Se muestra la ventana Operador personalizado.


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.


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



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.



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 6: Conjuntos de datos y parámetros


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.

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.

Elemento:

Descripción:

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.

Conjuntos de datos


Elemento:

Descripción:

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.




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.

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

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.



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.


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

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 en la barra de título de la paleta Conjunto de datos, en el Diseñador de procesos.

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.

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.

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

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.


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.


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.


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.

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.



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.

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.



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.

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.

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.

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.

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.

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.

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

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.

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;


print HH $opsys;

close HH;

$counter++;

}

my $filename3 = $c2osvd . "/NumRowsRead";


print HH $counter;

close HH;

close HANDLE;

sleep 30;

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.



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)



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"



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

Elemento:

Descripción:

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.



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.



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.



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



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.



Elemento:

Descripción:

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.


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.



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.



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.



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.



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.



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").



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.



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.



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.




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.



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






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.



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.



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.



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



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.



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"'



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.



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



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.


+ (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".



Operadores lógicos

El lenguaje interpretado utiliza los siguientes operadores lógicos (o booleanos) para combinar los resultados de las funciones u operadores booleanos.


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


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



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 = *= /= %= += -=



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/]




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.




Descripción

Autor de llamada Conjunto de datos del proceso para un proceso padre cuando

está iniciando un proceso hijo.

Transfiere valores entre procesos en una jerarquía de llamadas cuando un proceso utiliza el operador Iniciar 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:






Descripción

ninguno El cálculo actual y, en algunos casos, el conjunto de datos del

proceso

Si se omite la palabra clave Process a la izquierda de una sentencia de asignación, CA Process Automation siempre crea o asigna un valor dentro del alcance del cálculo 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_name

o

Process[expresión]

Conjunto de datos del operador en un proceso

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




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.



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]



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.



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



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.



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



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



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


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


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.



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.



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:

MM/DD/YYYY

StartTime durante, después La hora a la que el operador inició la ejecución, con el formato:

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"]



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.



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) sentencia

Crear bucles mientras una prueba es verdadera.

for/in Sentencia for (variable_in_object) Crear bucles de las propiedades de un

objeto.

Consulte La sentencia de bucle for/in.



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)



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



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"



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.



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.



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



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;

}



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

}



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"



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.


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.


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.

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


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. Expanda Vínculos y haga clic en Iniciar solicitud.

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

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.


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.



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.

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.



Elemento:

Descripción:

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)



Elementos de formulario

Este tema presenta ejemplos básicos de cada tipo de elemento de formulario.

Element

o:

Descripción:

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.



Elemento:

Descripción:

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.

Elemento:

Descripción:

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.



Elemento:

Descripción:

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



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.



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.


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



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.



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.


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.



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.



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.



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.



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.


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.



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.


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.



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.



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.



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.



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.



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.



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.



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").



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.



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)



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.


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



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.


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.



ca_pam_convertToSimpleArray (objectArray, fieldName)

Crea una matriz simple de cadenas a partir de cualquier matriz de objetos de JavaScript más compleja.


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



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.


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);



Casilla de verificación

ca_pam_isSelectedCheckBox(_id)

Determina si una casilla de verificación está seleccionada (verdadero) o desactivada (falso).


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



2. Acceda a la carpeta Formularios de interacción del usuario, 02 Show and Hide Form Element: Show and Hide Form Element.



ca_pam_selectCheckBox(_id, isSelect)

Selecciona o desactiva una casilla de verificación especificada.


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


_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')



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


_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).


_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')



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


_id (string)


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


_id (string)


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.



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


_id (string)


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.


_id (string)


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);



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.


_id (string)


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.



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


_id


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.



Campo de búsqueda

ca_pam_getTextFieldValue(_id)

Devuelve un valor procedente de un campo de texto.


_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'))



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.



ca_pam_setTextFieldValue(_id, val)

Define el valor de un campo de texto.


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



Este ejemplo devuelve el valor del campo top_vendors y configura dynamic_field con ese valor.



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.



Botones de opción

ca_pam_isSelectRadio (_id, radio_id)

Determina si un botón de selección específico está seleccionado.


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



ca_pam_selectRadio(_id, radio_id)

Permite elegir un botón de selección específico en un campo Botones de opción.


_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



Seleccionar

ca_pam_getSelectedOptions(_id)

Devuelve el valor de índice de la opción seleccionada actualmente en un campo Seleccionar.


_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).



ca_pam_getSelectedOptionValues(_id)

Devuelve el valor de la opción seleccionada actualmente en un campo Seleccionar.


_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).



2. Acceda a la carpeta Formularios de interacción del usuario, 06 Populate Dropdown DB: Populate Dropdown from DB.



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.


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



ca_pam_selectOptionByIndex(_id, index, isSelect)

Selecciona o deselecciona una opción en un campo Seleccionar basado en el índice.


_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).



ca_pam_addValuesInSelectStore(_id, values)

Agrega nuevas opciones al campo Seleccionar con un conjunto sencillo de valores que se define en el código.


_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 ))



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.



ca_pam_clearSelectStore(_id)

Borra todas las opciones del campo Seleccionar.


_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)






ca_pam_createSelectStore(nameArray, valueArray)

Se utiliza para crear un conjunto de opciones para un campo Seleccionar.


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);



ca_pam_createSelectStoreFromSQLResult(resultFromSQLQuery, nameColumnID, valueColumnID)

Crea un conjunto de opciones para el campo Seleccionar directamente a partir del resultado de una consulta SQL.


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'));






Campo de texto




_id (string)


Valor de retorno


Ejemplo
















_id (string)


val (string)


Valor de retorno

Ninguno.

Ejemplo



because: ')










Área de texto




_id (string)


Valor de retorno


Ejemplo
















_id (string)


val (string)


Valor de retorno

Ninguno.

Ejemplo



because: ')










Texto de varias líneas




_id (string)


Valor de retorno


Ejemplo
















_id (string)


val (string)


Valor de retorno

Ninguno.

Ejemplo



because: ')










Tabla

ca_pam_clearTableData(_id, startIndex, endIndex)

Suprime una o más filas de datos de una tabla.


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



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.



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.


_id (string)



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);

}

}

}



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.


_id (string)


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.








ca_pam_setTableData(_id, values)

Establece los datos en una tabla.


_id (string)


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.



ca_pam_setTableDataFromJSObject(_id, values)

Rellena una tabla con la matriz de objetos de JavaScript.


_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;





ca_pam_setTableDataFromJSObject('Form.names',tableData );








Matriz simple

ca_pam_clearTableData(_id, startIndex, endIndex)

Suprime una o más filas de datos de una tabla.


_id (string)



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.



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.



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.


_id (string)



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);

}

}

}



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.


_id (string)


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.








ca_pam_setTableData(_id, values)

Establece los datos en una tabla.


_id (string)


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


Este ejemplo configura la tabla employeeList con los valores que devuelve la variable de resultado.



ca_pam_setTableDataFromJSObject(_id, values)

Rellena una tabla con la matriz de objetos de JavaScript.


_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();









ca_pam_setTableDataFromJSObject('Form.names',tableData );








Referencia de objeto




_id (string)


Valor de retorno


Ejemplo
















_id (string)


val (string)


Valor de retorno

Ninguno.

Ejemplo



because: ')








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.




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




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)


Valor de retorno


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.






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”+.


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 parsedJSON = ca_pam_convertJSONToJSObject(jsonString);

var menuObj = parsedJSON.menu;

var popUpObj = menuObj .popup;

var menuItemArray = popUpObj .menuitem.;

var secondElementOfMenuItemArray = menuItemArray[1];

var onclickElement = secondElementOfMenuItemArray.onclick;





2. Acceda a la carpeta Formularios de interacción del usuario y, a continuación, 07 Populate Table RESTful WS: Populate Table RESTful WS.



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);


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)


Valor de retorno


Ejemplo

Esta función se puede encontrar en el contenido listo para usar en CA Process Automation.





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)


url (string)


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.





headers (objetos)


callBack (object)


Valor de retorno




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 (url, callBack)

ca_pam_postRESTData (url, body, callBack)

ca_pam_postRESTData (url, body, contentType, callBack)

ca_pam_postRESTData (url, body, contentType, doNotValidateCert,

callBack)


url (string)


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.





headers (objetos)


callBack (object)


Valor de retorno




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, userName, password, callBack)

ca_pam_postRESTDataAuth(url, userName, password, body, callBack)

ca_pam_postRESTDataAuth(url, userName, password, body, contentType,

callBack)

ca_pam_postRESTDataAuth(url, userName, password, body, contentType,

doNotValidateCert, callBack)


url (string)


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.





headers (objetos)




callBack (object)


Valor de retorno


Ejemplo

Esta función se puede encontrar en el contenido listo para usar en CA Process Automation.



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:



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.


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.



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)


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)




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.



Ejemplo: método SOAP



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:

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>



<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 ;

}



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);

}

}


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.



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.


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];



■ 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:


<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;



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.



Ejemplo


<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 parsedXML= ca_pam_convertXMLToJavaScriptObject(xmlString);

var textNode= parsedXML["_text"][0];

var attributeValue= parsedXML["_text"][1];

var 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"






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



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:


b. Su formulario (por ejemplo, Interaction_Request_Form_4)

c. Vista de página

d. Página



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.



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.



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.



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

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.



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. Haga clic en el campo Código de inicialización de datos de formularios para ampliarlo.

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


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)

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.

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.



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.

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.



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



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.

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.



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.

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.


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:

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

5. Haga doble clic el operador Recurso para configurar las opciones.

Aparecen las paletas Conjunto de datos y Propiedades de recursos.

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.


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.


La nueva acción se agrega a la lista Acción.

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.


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



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.


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.



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.


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.



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.


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.


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.

Calendarios


Creación de un objeto de calendario

Se puede crear un objeto de calendario en cualquier carpeta en el explorador de bibliotecas.



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.

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.

Elemento:

Descripción:

Calendarios


Elemento:

Descripción:

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.

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.

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.

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.

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

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

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.

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




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.

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




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.

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.

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.

Calendarios


Calendarios


Elemento:

Descripción:

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.

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

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.

Planificaciones


Planificaciones


Elemento:

Descripción:

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


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


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

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.


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.

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.


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.

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.


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.

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.

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.



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.



2. Expanda el panel Vínculos en la página Operaciones.

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.

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.

Gestión de tareas


Al crear una tarea, se pueden especificar los siguientes atributos:


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.


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:

■ Configuración de ejecución

■ Simulación

■ Información

6. En la barra de herramientas Diseñador, haga clic en Guardar.

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

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.



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.



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.



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.



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.

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"> 

CA AuthMinder

<user>pamadmin</user> 

<password>pamadmin</password> 

</auth>

<options> 

<startDate></startDate> <!—Fecha de inicio en formato [MM/dd/yyyy] -->

<startTime></startTime> 

</options>

<params> 

<param name="ParamOne">Using file trigger</param>

<param name="ParamTwo">Second parameter from file trigger</param>

</params>

</flow>

</c2oflow>



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.


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.



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



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.


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)

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



Elemento:

Descripción:

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.



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.



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.


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.



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.




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.




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.



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

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.

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




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.



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.

■ Desactive Ejecutar como propietario.

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 la validación e imposición de la propiedad del proceso en tiempo de ejecución.

Seleccione Desactivar en el campo Seguridad de tiempo de ejecución. Esta opción ayuda a garantizar la compatibilidad con versiones anteriores para procesos

existentes.

Tratamiento de excepciones


Más información:

Cuándo seleccionar Ejecutar como propietario (en la página 76)


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.



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.



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.



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.



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.


Se agrega la nueva regla de excepción.



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.


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

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


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.



Más información:


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.



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.


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



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.



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.


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


■ 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)



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:


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



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.



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.



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.

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.


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:



<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

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.


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.



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.




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.


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.

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.


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.



Simulación del procesamiento de un operador seleccionado

Se puede simular el procesamiento de un operador seleccionado.


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.



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.


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.


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.


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

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




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.


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. (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)

4. 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 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:

Versiones de publicación



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


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.



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.



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.



Se puede establecer la versión de publicación del siguiente modo:

Desde la 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.



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




La versión actual del objeto se abre en el Editor de objetos.


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



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.



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.


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.

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.



2. Haga clic con el botón secundario del ratón en un paquete de contenidos y seleccione Propiedades.


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.


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.



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.



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



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.



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.



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


Se exporta el objeto.

Exportación de carpetas






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


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:



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



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.




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.



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.



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.



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



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:


■ 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



Ejemplo: exportación de carpetas


■ 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



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



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:


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)



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:


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.



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:

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

4. Haga clic con el botón secundario del ratón en cada objeto que devuelva la búsqueda y seleccione Copiar.



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.


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.



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.



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



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.




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.



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.



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.



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.



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:



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 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 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:



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


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



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:

0 1 2 3 4 5 6 7 8 9

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.



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


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 regular

Descripción Ejemplo

. El operador de punto representa cualquier carácter excepto un carácter de

fin de línea.

La expresión a.b coincide con cualquier cadena de tres caracteres que comience

con “a” y finalice con “b”.





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

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.

La expresión

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





[ ] Se utiliza para definir una clase de caracteres por inclusión. Es una lista compuesta de caracteres individuales e intervalos (intervalos).

Esta construcción coincide con un carácter individual. [0-9] coincide con un dígito.

[aeiou] coincide con una vocal.

[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".





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

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 C: Cómo se procesan los objetivos de un operador

Este apéndice describe cómo procesa CA Process Automation objetivos del operador.


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.

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.


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.



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.



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

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



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

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



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:


■ 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)

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:


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

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.

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.



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


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


Touchpoint/Orchestrator: TP_user01-w500 Recovery... Recovering 'System_Error'

Operators that ran against: TP_user01-w500 and belong to 'Waiting' or 'Running'


2011-03-28 19:23:00,000 DEBUG




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



TP_user01-w500 recovery.



■ 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


recoverSystemErrorProcesses: Queueing recovery of process with ROID - 2889 for


2011-03-28 19:23:00,015 DEBUG


recoverSystemErrorProcesses: Special Response for process recovery. ROID is 2889

UUID is 3fe95f08-a347-4d6d-a0a3-b3639836e130

2011-03-28 19:23:00,015 DEBUG


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


Touchpoint/Orchestrator: TP_user01-w500_3 Recovery. Recovering 'System_Error'

Operators that ran against: TP_user01-w500_3 and belong to 'Waiting' or 'Running'


2011-03-28 19:23:00,015 DEBUG




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



TP_user01-w500_3 recovery.

2011-03-28 19:23:00,031 INFO


Processes to recover for Touchpoint/Orchestrator: TP_user01-w500_3 Recovery.



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



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


Touchpoint/Orchestrator: HG_user01-w500 Recovery. Recovering 'System_Error'

Operators that ran against: HG_user01-w500 and belong to 'Waiting' or 'Running'


2011-03-28 19:23:41,444 WARN



HG_user01-w500 recovery.

2011-03-28 19:23:41,444 INFO


Processes to recover for Touchpoint/Orchestrator: HG_user01-w500 Recovery...

2011-03-28 19:23:41,444 INFO


Touchpoint/Orchestrator: TP_user01-w500 Recovery... Recovering 'System_Error'

Operators that ran against: TP_user01-w500 and belong to 'Waiting' or 'Running'


2011-03-28 19:23:41,444 WARN




2011-03-28 19:23:41,444 INFO


Processes to recover for Touchpoint/Orchestrator: TP_user01-w500 Recovery...

2011-03-28 19:23:41,444 INFO


Touchpoint/Orchestrator: TP_user01-w500_3 Recovery... Recovering 'System_Error'

Operators that ran against: TP_user01-w500_3 and belong to 'Waiting' or 'Running'




■ 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




2011-03-28 19:23:41,444 WARN




2011-03-28 19:23:41,444 INFO


for Touchpoint: TP_user01-w500_3 Recovery... Recovering Processes with the


2011-03-28 19:23:41,444 WARN




2011-03-28 19:23:41,444 WARN




2011-03-28 19:23:41,444 INFO


for Touchpoint: TP_user01-w500_3 Recovery... Recovering Processes with the




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

ca process automation - support.ca.com process automation 04 2 00-esp... · esta documentación...

Documents