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 reside en que los paquetes sirven para crear componentes reutilizables que se utilizarán 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 Leer rango en Sistema > Archivo > Libro, y suéltala en el panel Diseñador.
   • En el campo Ruta del libro, añade la ruta hacia el archivo de Excel del que quieres sacar los datos.
   • En el campo Nombre de la hoja, añade el nombre de la hoja de cálculo. Para este ejemplo, se mantiene el nombre predeterminado Sheet1.
   • En el campo Rango, añade el rango de celdas que se han de leer. Para este ejemplo, deja el campo vacío para que se lean todas las celdas.
2. En el panel Propiedades de la actividad Leer rango, haz clic en el campo junto a TablaDeDatos, después utiliza el atajo de teclado Ctrl + K para abrir el campo de la variable y añade el nombre GetRange. La variable de tipo DataTable almacena los datos de las celdas leídas.
   
   

   

   
   

   
   

   

   
   
3. En el panel Actividades, busca la actividad Anexar rango en Sistema > Archivo > Libro. Añádelo bajo la actividad Leer rango.
   • En la Ruta del libro, añade la ruta hacia el archivo donde quieres anexar los datos copiados.
   • En Nombre de la hoja, introduce el nombre de la hoja. Para este ejemplo, deja el valor predeterminado Sheet.
   • En el campo Tabla de datos, añade la variable GetRange que has creado antes y que almacena la información. Tu proyecto debería parecerse a la imagen a continuación.
     
     

     

     
     
4. 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 añaden a otra. No sustituye los datos que ya existen en la segunda hoja de cálculo.

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