Crear una Biblioteca básica

El siguiente tutorial te guía por los pasos a seguir para crear una biblioteca en Studio, publicarla y utilizarla en otros proyectos de automatización.

Crear una biblioteca es parecido a Crear un proceso básico. La diferencia es que una biblioteca es un paquete que contiene componentes reutilizables que puede utilizarse en el contexto de otros proyectos.

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 Excel que no requieren tener Microsoft Excel 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. En la ventana Nueva biblioteca en blanco:
   • Especifica un nombre para el nuevo proyecto y una descripción que resuma lo que intentas conseguir con esta automatización. Para este ejemplo, puedes usar el nombre BibliotecaRapida.
     Nota: el nombre del proyecto no puede superar los 128 caracteres, ni la descripción los 500.
   • Selecciona la ubicación en la que quieres crear el proyecto.

   • Selecciona Windows: heredado en la opción Compatibilidad y VB en Lenguaje.

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 del 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 navega hasta el archivo de Excel en el que 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 botón 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 (en nuestro caso Excel2.Sheet("Sheet1")). Tu proyecto debería parecerse a la imagen a continuación.
   
   

   

   
   
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

Para añadir esta biblioteca como componente reutilizable a otros proyectos de automatización, deberás empaquetarla como archivo .nupkg al publicar el proyecto.

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

Para utilizar el paquete en otro proyecto, primero tienes que añadirlo como dependencia del proyecto. Para comenzar, crea un nuevo Proceso en Studio, tal y como se explica en la página Crear un proceso básico.

Consulta más información sobre las dependencias de proyecto en la página Acerca de las dependencias.

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.
   
   

   

   
   

Debes seguir los pasos descritos anteriormente cada vez que quieres añadir o eliminar una fuente definida por un usuario en Studio. Consulta Acerca de los paquetes de actividades para obtener más información sobre las fuentes de actividades.

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 rango automáticamente, pero estas requiere tener instalado Microsoft Excel 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