Gestión de argumentos

Los argumentos se usan para pasar datos de un proyecto a otro. En un sentido global, se asemejan a las variables, ya que almacenan datos de forma dinámica y los transmiten. Las variables pasan datos entre actividades, mientras que los argumentos pasan datos entre automatizaciones. Como resultado, le permiten reutilizar ciertos proyectos una y otra vez.

Studio admite un gran número de tipos de argumentos, que coinciden con los tipos de variables. Por lo tanto, puedes crear argumentos de Valor genérico, String, Booleano, Objeto, Matriz o Tabla de datos, y también puedes buscar tipos .Net, al igual que en el caso de las variables.

Además, los argumentos tienen direcciones específicas (Entrada, Salida, Entrada/Salida, Propiedad) que le dicen a la aplicación dónde se supone que debe ir la información almacenada en ellos.

Importante:

• Si una variable y un argumento tienen el mismo nombre, la variable será siempre la predeterminada y se utilizará en el runtime.
• El envío de argumentos de entrada a una actividad Invocar archivo de flujo de trabajo que no está aislada actúa como si se enviara una referencia, lo que significa que cualquier cambio hecho al objeto del flujo de trabajo invocado cambiará el objeto del flujo de trabajo principal.

Ten en cuenta que si creas un argumento de entrada/salida con un valor de entrada cuando se usa en la actividad Invocar flujo de trabajo, y luego cambias el valor a salida, puedes notar que se activa un error al ejecutar el proyecto. Esto se debe a que la actividad Invocar flujo de trabajo no devolvió los valores por referencia. Usa un Controlador global en tu proyecto para tener acceso a los valores exactos que tenían los argumentos dentro del flujo de trabajo invocado.

Por último, estos argumentos pueden utilizarse para integrarse con otras herramientas de tu empresa, ya que también están expuestos en Orchestrator. Esto significa que ahora cualquier proceso que crees puede recibir parámetros de entrada a través de la API o interfaz de Orchestrator, así como devolver una salida a todo lo anterior. Más información aquí.

Crear argumentos

Los nombres de los argumentos deberán estar en CamelCase superior con un prefijo que indique la dirección del argumento, como in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber. Puedes comprobar nuestras recomendaciones sobre las Convenciones de nombres para el diseño de flujos de trabajo para obtener más detalles.

Desde el Gestor de datos

1. Abre el Gestor de datos, a continuación selecciona Nuevo > Nuevo Argumento.
2. Se añade un nuevo elemento con el nombre predeterminado argument en Argumentos.

3. Configurar el argumento creado:

   • Haz clic en el nombre del argumento para editar su nombre.
   • Expande el argumento utilizando la flecha a su izquierda, y establece la Dirección, el Tipo de datos, si es un Requisito, y de forma opcional, el Valor predeterminado.

Desde el Gestor de datos, también puedes crear argumentos por lotes haciendo clic derecho en el nodo Argumentos y luego seleccionando Crear argumentos en lotes. Se muestra una ventana nueva donde puedes añadir y configurar varios argumentos.

Desde el cuerpo de una actividad

1. Desde el panel de Actividades, arrastra una actividad al panel del Diseñador. Haz clic con el botón derecho en un campo y selecciona Crear argumento de entrada o Crear argumento de salida en el menú contextual. Alternativamente, presiona Ctrl+M o Ctrl+Mayús+M. Se mostrará el campo Establecer Arg.
2. Rellena el nombre y presiona Into. El argumento se crea y es visible en el campo. Comprueba tu dirección y escribe en el panel de Argumentos.

De expresiones

Alternativamente, los argumentos pueden ser creados a partir de expresiones directamente en un campo de entrada de actividad o en el Editor de Expresiones Editor de Expresiones:

1. Selecciona una parte de la expresión y presiona Ctrl+M o Ctrl+Mayús+M. Se mostrará el campo Establecer Arg.

2. Escribe el nombre y presiona Entrar. El argumento está creado. Comprueba su tipo y dirección en el panel Argumentos.

   
   

   

   
   

Los argumentos creados de esta manera reciben automáticamente el tipo de acuerdo con la actividad. Por ejemplo, si creas un argumento en el campo Data Table de una actividad Intervalo de escritura, el tipo de argumento se establece en DataTable. Si creas un argumento en el campo Text de una actividad Línea de escritura, el tipo de argumento se establece en String.

Desde el panel de Propiedades

1. En el panel de Propiedades de cualquier actividad, haz clic con el botón derecho en un campo que se pueda editar y seleccionar Crear argumento de entrada o Crear argumento de salida en el menú contextual. Alternativamente, presiona Ctrl+M o Ctrl+Mayús+M. Se mostrará el campo Establecer Arg.
2. Rellena el nombre y presiona Into. El argumento se crea y es visible en el campo. Comprueba tu dirección y escribe en el panel de Argumentos.

El tipo de argumento se generará automáticamente en función de la propiedad seleccionada.

Desde el Panel de Argumentos

1. En el panel del Diseñador, haz clic en Argumentos. Se mostrará el panel de Argumentos.

2. Haz clic en la línea de Crear argumento, y rellena el nombre. Se creará un nuevo argumento.

   Nota: De forma predeterminada, todos los argumentos son de tipo String y tienen una dirección de Entrada.

Eliminar Argumentos

Puedes eliminar variables desde el Gestor de datos o desde el panel Variables.

Desde el Gestor de datos

1. Abre el Gestor de datos y expande el nodo *Variables.
2. Haz clic derecho en un argumento, y a continuación selecciona Eliminar. De forma alternativa, selecciónala y pulsa la tecla Suprimir.

Desde el Panel de Argumentos

1. Abre el panel Argumentos.

2. Haz clic derecho en un argumento, y a continuación selecciona Eliminar. De forma alternativa, selecciónala y pulsa la tecla Suprimir.

   
   

   

   
   

Eliminar todos los Argumentos no utilizados

Para eliminar todos los argumentos que no están siendo utilizados en ninguna parte en el archivo actual, selecciona Eliminar no utilizados > Argumentos en la cinta de Studio y a continuación selecciona Sí cuando se te pida confirmación.

Configurar propiedades de argumento

La ventana Propiedades de argumento centraliza los argumentos utilizados en todo tu proyecto, así como sus propiedades. Después de publicar el proyecto, esta información es visible en Orchestrator, Assistant y Automation Ops: canalizaciones.

Para configurar las propiedades de argumento, abre el panel Proyecto, haz clic con el botón derecho en un archivo XAML establecido como principal o marcado como punto de entrada al proyecto y selecciona la opción Propiedades de argumento. Puedes reorganizar los argumentos enumerados en la ventana arrastrando y soltándolos en el menú del lado izquierdo.

Selecciona un argumento en el menú del lado izquierdo e introduce lo siguiente:

• Nombre para mostrar: la etiqueta que aparece para el argumento.
• Descripción emergente: información sobre la herramienta visible cuando mantienes el puntero sobre el argumento.
• Requisito: si el argumento es obligatorio.