Configurar actividades

Opciones de configuración de actividades en Studio Web, que cubren datos de entrada y salida, propiedades visibles predeterminadas y propiedades adicionales accesibles desde la tarjeta de actividad.

Las actividades pueden recibir datos como entrada y pueden generar datos de salida que pueden utilizarse como entrada en otras actividades. Las opciones o propiedades clave de la actividad son visibles de forma predeterminada en las tarjetas de actividad, y si una actividad tiene propiedades adicionales, puedes configurarlas seleccionando Mostrar propiedades adicionales.

El panel Propiedades te permite controlar cómo aparecen las propiedades de la actividad. También puedes utilizar este panel para cambiar el nombre del proyecto o el nombre del flujo de trabajo que se selecciona en el Explorador de proyectos.

Para acceder al panel, selecciona el icono correspondiente en la parte superior derecha de la página del proyecto. Dentro del panel Propiedades, puedes cambiar en cualquier momento entre dos vistas:

• Vista de lienzo : todas las propiedades de la actividad seleccionada aparecen en la tarjeta de actividad.

• Vista de panel : todas las propiedades de la actividad seleccionada, incluidas las propiedades avanzadas, aparecen solo en el panel Propiedades y la tarjeta de actividad está contraída.

  

Seleccionando Ver más junto a un campo de actividad muestra las opciones para ese campo. Las opciones para la mayoría de los campos son:

• Creador de texto
• Variables
• Editor de expresiones
• Crear variable
• Create argument
• Clear value
  Nota:

  Las opciones disponibles pueden variar en función de los tipos de datos asociados al campo.

Hay controles de entrada, editores y creadores disponibles para ayudarte a configurar actividades en función del tipo de datos, ya sea directamente desde la actividad en el diseñador de proyectos o desde un editor o un creador.

If you switch a field back to its original control from the See more options, for example Autocomplete, Studio Web keeps the value only if it's valid for that control.

Algunas actividades definen un ámbito o las condiciones que deben cumplirse para la ejecución de otras actividades añadidas a ellas. Se denominan actividades de contenedor y, entre otros ejemplos se incluyen:

• Para cada actividad
  • Define una colección de elementos y repite las actividades añadidas dentro de ellos una vez para cada uno de esos elementos.
• Si: evalúa una condición y determina el flujo de la automatización mediante la ejecución de actividades específicas en función de si se cumple la condición.
• Usar navegador: se adjunta a una página en tu navegador y ejecuta todas las actividades de UI Automation añadidas a esa página.

En las siguientes secciones se describe cómo puedes utilizar algunos de los editores y creadores disponibles.

Editor de expresiones

Write complex expressions to configure activity properties. The Expression editor is available for most activity properties and features intelligent code completion for variables, arguments, methods, properties, classes, or keywords. You can write expressions on multiple lines and use Ctrl + Space to see the list of available options. You can also select Insert variable to open the variable selection window and select a variable, argument, or property.

Utiliza Ctrl + F dentro del editor para abrir las capacidades de búsqueda y reemplazo. El icono de error indica si hay una incompatibilidad entre una expresión y el tipo de propiedad de la actividad (por ejemplo, utilizar una expresión de tipo String en una propiedad de tipo Boolean).

Puedes probar el valor de las expresiones válidas seleccionando Prueba. No se admite la prueba de expresiones que utilizan valores complejos.

Generar expresiones utilizando Autopilot

You can also utilize natural language to describe your expression using Autopilot generative AI capabilities. Instead of manually writing an expression in the Expression editor, you can use the generate expression field to describe your desired action (for example, “Extract the total revenue from the sales report”).

El modelo de IA generará una expresión basada en la descripción proporcionada, que luego se mostrará en el editor. A continuación, puede modificar la expresión generada o aceptarla tal cual. El modelo de IA aprende continuamente de las descripciones que envías, lo que le permite refinar y mejorar su rendimiento con el tiempo. El modelo también es capaz de utilizar variables y argumentos definidos por el usuario y es consciente de cualquier expresión ya utilizada.

Selecciona el botón Corregir junto a un icono de error y Autopilot intentará corregir la falta de coincidencia y proporcionar una expresión válida. Un mensaje de error te informa si la expresión no se puede corregir automáticamente.

Example of using the Expression editor with Autopilot capabilities

Una forma sencilla de probar las capacidades de Autopilot es transformar una variable de minúsculas a mayúsculas. Para ello:

1. Crea un nuevo proyecto con un desencadenador manual y crea una nueva variable (por ejemplo, MyVariable).

2. Establece el tipo de variable en Texto y el valor predeterminado en "ejemplo".

3. Añade una actividad Establecer valor de variable .

4. In the Set value field, select See more > Expression editor.

5. En el campo Generar expresión, escribe tus instrucciones en lenguaje natural (por ejemplo, "Convertir MyVariable a mayúsculas").

6. Select to generate your expression. Optionally, select Test in the Expression editor to test the new value of the variable.

7. Selecciona Guardar para utilizar la expresión generada por Autopilot.

8. En el campo de salida A variable , selecciona MiVariable.

   

9. Añade una actividad Mensaje de registro .

10. En el campo Mensaje , escribe el mensaje que deseas registrar (por ejemplo, "Mi variable, MyVariable, ahora está en mayúsculas") y selecciona un nivel de registro.

11. Selecciona Depurar en la nube en la parte superior del diseñador para probar la automatización, y comprueba el panel de salida de ejecución para ver la variable cambiada de minúsculas ("ejemplo") a mayúsculas ("EJEMPLO").

    

Creador de filtros

Crea un filtro complejo con una o más condiciones. Los filtros permiten que tus automatizaciones identifiquen los elementos exactos que deben utilizarse. Por ejemplo, la mayoría de los desencadenadores de eventos contienen filtros que te ayudan a determinar los criterios exactos que debe cumplir un evento para que se inicie la automatización.

Para crear un filtro:

1. Selecciona el elemento a filtrar desde el campo a la izquierda. Por ejemplo, al filtrar correos electrónicos, puedes seleccionar un campo correo electrónico como Desde o Cuerpo.
2. Selecciona un operador del menú desplegable en el centro para comparar con el elemento. Hay varios operadores de entre los que puedes elegir dependiendo del tipo de datos. Por ejemplo, al filtrar correos electrónicos por remitente, puedes seleccionar el operador Contiene o No contiene para el campo De.
3. Selecciona el valor, desde el campo a la derecha, con el que comparar el elemento seleccionado.

Para crear un filtro con varias condiciones, selecciona Añadir condición en el Creador de filtros y crea cada condición adicional de forma similar. Al añadir varias condiciones, aparece un menú desplegable en la parte superior de la ventana donde debes seleccionar cuándo se aplica el filtro: selecciona All (AND) si el filtro se aplica cuando se cumplen todas las condiciones, o Any (OR) si el filtro se aplica cuando se cumple alguna. de las condiciones se cumple.

Ejemplo de creación de un filtro

Diseñas una automatización que se desencadena por el evento Archivo creado en OneDrive o Google Drive y solo deseas que la automatización se ejecute cuando se creen archivos con las extensiones: pdf, tif, jpg, png y jpeg.

1. En la actividad del desencadenador, selecciona Filtros adicionales para abrir el Creador de filtros.

2. Añade una condición a cada extensión de archivo que se va a incluir en el filtro seleccionando Extensión a partir del primer campo, contiene a partir del segundo campo e introduciendo una extensión en el tercer campo.

3. Selecciona Cualquiera (O) en el menú desplegable de la parte superior de la ventana para indicar que la creación de archivos con cualquiera de las extensiones debe activar la automatización.

   

Creador de condición

Define una declaración verdadera o falsa que evalúa una actividad para determinar cómo debe continuar una automatización.

Para diseñar una condición:

1. Selecciona un primer valor para compararlo desde el campo a la izquierda, por ejemplo una variable de tu proyecto.
2. Selecciona un operador del menú desplegable en el centro para usarlo para comparar el primer valor. Hay varios operadores entre los que puedes elegir dependiendo del tipo de datos: greater than, greater than or equal, less than, less than or equal, equals, not equals, is empty text, is not empty text, is true, is false, starts with, does not start with, ends with, does not end with, contains, does not contain, has value, has no value, list is empty, list is not empty.
3. Dependiendo del operador, también tendrás que seleccionar en el campo de la derecha un segundo valor con el que comparar el primero.

To create a statement with multiple conditions, select Add in the Condition builder and provide the same information for each additional statement. When you add multiple statements, a dropdown menu appears at the top of the window where you must select when the statement is true: select All (AND) if the statement is true when all the conditions are met, or Any (OR) if the statements is true when any of the conditions are met.

Ejemplo de creación de una condición

Diseñas una automatización que mueve cada archivo que se crea en una determinada carpeta de tu Google Drive u OneDrive a una de las dos carpetas en función del tamaño de cada archivo: los archivos de 1 MB o más van a la carpeta Archivos grandes , mientras que los archivos de menos de 1 MB van a la carpeta Archivos pequeños.

1. Configura el desencadenador Archivo creado.

2. Add an If activity and select the Condition field to open the Condition builder.

3. In the Condition builder, add the condition "the file size is less than 1MB". We will use the SizeInBytes property of the created file, and 1MB = 1000000 Bytes.

   1. Selecciona el primer campo y selecciona Archivo creado > Mostrar más > Archivo > TamañoEnBytes.
   2. En el campo del medio, selecciona menor que.
   3. En el tercer campo, 1,000,000 y luego selecciona Guardar.

   

4. Añadiremos dos actividades Mover archivo para mover el archivo creado de la siguiente manera:

   • Una actividad en la rama Entonces de la actividad Si. Esta es la actividad que se ejecuta cuando se cumple la condición (el tamaño del archivo es inferior a 1 MB), por lo que seleccionaremos Archivos pequeños como carpeta de destino.
   • La otra actividad de la rama Si no de la actividad Si. Esta es la actividad que se ejecuta cuando la condición no se cumple (el tamaño del archivo no es inferior a 1 MB), por lo que seleccionaremos Archivos grandes como carpeta de destino.

   

Creador de colecciones

Crear una colección de elementos del mismo tipo.

Para crear una colección, selecciona el elemento y entonces selecciona Añadir entrada para cada entrada que quieras añadir.

Ejemplo de creación de una colección

Diseñas una automatización en la que se recuperan archivos en dos actividades de descarga diferentes. Luego deseas cargar los archivos en OneDrive o Google Drive usando una actividad Cargar archivos.

1. En la actividad Cargar archivos, selecciona Ver más > Crea una colección de archivos junto al campo Archivo(s) .

2. Selecciona Hacer clic para abrir el Creador de colecciones.

3. Selecciona Añadir y, a continuación, selecciona el primer campo y selecciona la salida de la primera actividad Descargar archivo. Repite el proceso para la salida de la segunda actividad y luego selecciona Guardar.

   

Selector de fecha y hora

Selecciona una fecha del calendario y una hora (hora y minuto). Disponible para campos que requieren un valor de fecha y hora.

Al utilizar una variable en un campo que acepta valores de fecha y hora, los fragmentos también estarán disponibles, lo que te permite añadir rápidamente variables comunes de fecha y hora:

• Hoy
• Ayer
• Mañana
• Hace dos días
• Inicio de la última semana laboral
• Final de la última semana laboral
• Iniciodelasiguientesemana
• Iniciodelsiguientemes
• Comienzo de esta semana
• Comienzo de este mes
• Comienzo del mes pasado
• Comienzo de este año
• Hace 3 meses
• Hace 6 meses
• ahora

Editor de asignación de datos

El editor de asignación de datos simplifica la automatización de procesos empresariales de extremo a extremo que involucran estructuras de datos complejas. La asignación de datos te ayuda a asignar objetos de datos complejos entre sistemas dentro de una sola actividad de Integration Service.

Para acceder al editor de asignación de datos:

1. Añade una actividad de Integration Service a tu flujo de trabajo.

2. Selecciona el botón Cambiar a vista de objeto en el cuerpo de la actividad.

3. Selecciona el campo de actividad que deseas editar. Se abre el editor de Asignación de datos.

   

Como alternativa, puedes acceder al editor de asignación de datos seleccionando Ver más > Asignación de datos junto al campo de actividad.

El editor tiene dos modos:

1. Un modo estándar que se abre cada vez que accedes al editor. Este es el modo predeterminado.
2. Un modo avanzado que puedes habilitar desde el botón Modo avanzado en la esquina superior derecha del editor.

Dentro del modo estándar, puedes:

• Usa los botones Expandir todos y Contraer todos para expandir o contraer todas las propiedades de los objetos anidados.
• Selecciona el icono de búsqueda para encontrar una propiedad o variable específica.
• Ver todas las propiedades del objeto en la columna Propiedades de destino . Algunas propiedades se pueden expandir para revelar propiedades anidadas adicionales (por ejemplo, propiedades de lista de tipos). Cada propiedad tiene un nombre para mostrar para distinguirla en la lista, así como el nombre de API exacto definido por la aplicación de terceros.
• Asigna una propiedad de objeto a una salida de actividad en la columna Asignación . Selecciona el campo junto a cada propiedad y elige una variable en el selector Usar variables . También puedes seleccionar Ver más botón para:
  • Abre el selector Usar variables .
  • Open the Expression editor.
  • Borra cualquier valor en el campo de salida de la actividad.
• Selecciona una variable que esté disponible en el flujo de trabajo en la columna Variables disponibles . Las variables se pueden arrastrar y soltar dentro de las salidas de actividad enumeradas en la columna Asignación .
• Habilita o deshabilita el modo avanzado. En el modo avanzado, solo puedes asignar propiedades escribiendo una expresión o utilizando el selector Usar variables . Arrastrar y soltar variables desde la columna Variables disponibles no está disponible.
  Nota:

  En Studio, el editor de asignación de datos solo está disponible en modo avanzado.

Un icono de error en el campo de salida de actividad indica si hay alguna incompatibilidad entre una variable y el tipo de salida de actividad.

Después de asignar una propiedad de objeto a una salida de actividad, selecciona el botón Guardar para registrar tus cambios.

Nota:

Si una propiedad anidada o una propiedad principal ya está asignada, la otra no se puede asignar.

Selecciona Cambiar a vista de campos en el cuerpo de la actividad para volver a actualizar los campos de actividad en línea.

Importante:

Para utilizar las salidas creadas en el editor de asignación de datos, asegúrate de que estás utilizando la actividad en la vista de objeto. Si la actividad se utiliza en la vista de campos, las asignaciones creadas en el editor de asignación de datos no se tienen en cuenta al ejecutar el flujo de trabajo.