Crear una Biblioteca básica

The following tutorial walks you through the steps of creating a library in Studio, publishing and using it in other automation projects.

Creating a library is similar to Creating a Basic Process. The difference is that a library is a package containing reusable components which can be used in the context of other projects.

Este ejemplo obtiene datos de una hoja de cálculo de Excel y los añade a otro archivo de Excel. Después, te dirige por los pasos para empaquetar y publicar el proyecto en una fuente personalizada, instalar el paquete en otro proyecto y utilizar la actividad en su interior.

Este ejemplo utiliza actividades de Excel que no requieren que Microsoft Excel esté instalado en tu máquina.

Vamos a comenzar.

Crear una biblioteca

1. Inicia Studio. En la vista Backstage de INICIO, haz clic en Biblioteca para crear un nuevo proyecto de biblioteca. Se mostrará la ventana Nueva biblioteca en blanco.

   

2. Escribe un nombre para el proyecto; utiliza BibliotecaRápida para este ejemplo. Añade una breve descripción y selecciona una ubicación.

   Nota:

   El nombre de proyecto no puede superar los 128 caracteres y la descripción no puede superar los 500 caracteres.

3. Haz clic en Crear. Se abrirá la nueva biblioteca en Studio.

Añadir actividades de Excel

1. En el panel Actividades, busca la actividad Ámbito de proceso de Excel y suéltala en el panel Diseñador.

2. Añade una actividad Usar archivo de Excel a la secuencia. Esta actividad es necesaria para la mayoría de las actividades relacionadas con Excel.

3. En el campo Archivo de Excel, navega hasta el archivo de Excel desde el que quieres obtener los datos. De manera opcional, puedes utilizar

   el campo Referencia como para cambiar la forma en que se hace referencia a este archivo en el flujo de trabajo (en este caso Excel1).

4. Añade una segunda actividad Usar archivo de Excel dentro de la primera actividad Usar archivo de Excel y ve al archivo de Excel donde quieres copiar los datos.Añade una referencia opcional a este segundo archivo (en este caso Excel2).

5. Añade una actividad Copiar/Pegar intervalo.

6. En el campo Origen , selecciona el signo Más para indicar el nombre de la hoja en el primer libro. Para este ejemplo, el campo debería decir Excel1.Sheet("Sheet1").

7. En el campo "Destino", selecciona Más para indicar el nombre de la hoja en el segundo libro (Excel2.Sheet("Sheet1") en nuestro caso). Tu proyecto debería parecerse a la siguiente imagen.

   

8. En la cinta, haz clic en Ejecutar archivo o utiliza Ctrl + F6 para ejecutar el flujo de trabajo. Los datos recopilados de la primera hoja de cálculo de Excel se copian a otra.

Empaquetar una biblioteca

To add this library as a reusable component to other automation projects, you need to package it as a .nupkg file by publishing the project.

1. Abre el proyecto de biblioteca en Studio.

2. En la cinta, haz clic en el botón Publicar. Se abrirá la ventana Publicar biblioteca.

   • En la pestaña Propiedades del paquete, introduce el nombre de un paquete. En el campo Notas de la versión, añade algunos detalles sobre la biblioteca. Es útil para llevar la cuenta de los cambios realizados a la biblioteca con cada nueva versión publicada.
   • En la pestaña Opciones de publicación, selecciona Publicar en > Personalizar y luego, en el campo URL personalizada, añade la ruta a una carpeta local. Por ejemplo, puedes crear una carpeta myfeed en tu Escritorio.

3. Haz clic en Publicar. El paquete estará ya disponible en la carpeta local como archivo .nupkg.

   

Instalar Componentes reutilizables

To use the package in another project, you first need to add it as a project dependency. To get started, create a new Process in Studio, as explained in the Creating a Basic Process page.

Read more about project dependencies in the About Dependencies page.

Añadir una Fuente personalizada

1. Haz clic en Gestionar paquetes > Configuración, en la cinta de Studio. Se mostrarán las fuentes tanto predeterminadas como definidas por el usuario.

2. En el contenedor Origen de los paquetes definidos por el usuario, añade un nombre para tu fuente en el campo Nombre. En el campo Origen, añade la ruta hacia la carpeta en la que hayas publicado tu biblioteca.

3. Haz clic en Añadir. Tu nueva fuente se añadirá a la sección.

   

You need to follow the above steps whenever you want to add or remove a user-defined feed in Studio. Check out the About Activities Packages to read more information about activities feeds.

Instalar el Paquete

1. En la ventana Administrar paquetes, ve a la fuente añadida previamente en la pestaña Todos los paquetes a la izquierda. Se mostrará la lista de paquetes disponibles en la fuente.

2. Busca el paquete y selecciónalo. En nuestro ejemplo, el nombre del paquete es BibliotecaRápida.

3. Haz clic en Instalar, y luego en Guardar. El paquete se instalará entonces en tu proyecto, y será visible en el panel Proyecto, dentro de Dependencias.

   

Añadir actividades de la Biblioteca

1. Busca el nombre del paquete en el panel Actividades, en nuestro caso Quick Library.

2. Suelta la actividad en el panel Diseñador.

3. En la cinta de Studio, haz clic en Ejecutar archivo o utiliza Ctrl + F6 para ejecutar la actividad.

   

Puedes añadir otras actividades como Copiar hoja o Rellenar intervalo automáticamente, pero estas requieren que Microsoft Excel esté instalado en tu máquina.

La ventaja de los componentes reutilizables es que reducen las repeticiones. Se crean una vez y pueden reutilizarse en otros proyectos.

Para descargar la biblioteca que hemos creado antes, haz clic en el botón a continuación:

Descargar ejemplo