Crear una Biblioteca básica

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

Crear una biblioteca es similar a Crear un proceso básico. La diferencia es que una biblioteca es un paquete que contiene componentes reutilizables que pueden 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 de Excel que no requieren que Microsoft Excel esté instalado en tu máquina.

Vamos a comenzar.

Crear una biblioteca

1. Launch Studio. In the HOME Backstage view, select Library to create a new library project. The New Blank Library window is displayed.

   

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 de proyecto no puede superar los 128 caracteres y la descripción no puede superar los 500 caracteres.

   • Selecciona Mostrar opciones avanzadas y elige la ubicación donde crear el proyecto.

   • Selecciona Windows para la opción Compatibilidad y VB para Lenguaje.

3. Select Create. The new library is opened in Studio.

Resultado

The library project is created and opens in Studio, ready for activities to be added.

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 (Excel1, en este caso). 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 (Excel2, en este caso). 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. In the ribbon, select Run File or use Ctrl + F6 to execute the workflow. The data gathered from the first Excel spreadsheet is copied to another.

Resultado

The data from the first Excel spreadsheet is copied to the second. The workflow runs successfully.

Empaquetar una biblioteca

Para añadir esta biblioteca como componente reutilizable a otros proyectos de automatización, debes empaquetarla como un archivo .nupkg publicando el proyecto.

1. Abre el proyecto de biblioteca en Studio.

2. From the ribbon, select the Publish button. The Publish Library window opens.

   • 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. Select Publish. The package is now available in the local folder as a .nupkg file.

   

Resultado

The library is published as a .nupkg file to your custom feed folder and is ready to be installed in other projects.

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 como se explica en la página Crear un proceso básico.

Más información sobre las dependencias del proyecto en la página Dependencias del proyecto.

Añadir una Fuente personalizada

1. In the Studio ribbon, select Manage Packages > Settings. The default and user-defined feeds are displayed.

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. Select Add. Your new feed is added to the section.

   

Resultado

The custom feed is added to Studio. It is now available under All Packages when managing package dependencies.

Debes seguir los pasos descritos anteriormente cada vez que quieras añadir o eliminar una fuente definida por un usuario en Studio. Consulta la sección Acerca de los paquetes de actividades para obtener más Information 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. Select Install, then Save. The package is now installed in your project, and visible in the Project panel, under Dependencies.

   

Resultado

The package is installed as a dependency in your project. Its activities are available in the Activities panel.

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. In the Studio ribbon, select Run File or use Ctrl + F6 to execute the activity.

   

Resultado

The library activity runs successfully in the project. The reusable component is ready to use in any project where the package is installed.

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