API de Excel

Las API te permiten acceder e interactuar con los servicios ofrecidos en el menú Gestionar paquetes. Puedes utilizar estas API al diseñar automatizaciones. Visita Automatizaciones codificadas para obtener más información sobre las automatizaciones codificadas y cómo diseñarlas utilizando API.

Nota: Al utilizar Ir a definición (F12), puedes acceder a la definición de las API de UiPath para un determinado servicio. Recomendamos confiar solo en las API expuestas directamente al implementar automatizaciones codificadas. Otras API que no estén expuestas directamente a un servicio serán sujeto de cambios sin notificación previa.

Sobrecargas

Las API tienen sobrecargas con frecuencia, lo que significa que proporcionan varias versiones del mismo método con diferentes opciones de parámetros. Las sobrecargas te permiten personalizar el comportamiento de la API en función de tus requisitos específicos. Por ejemplo, una API de automatización de IU puede tener una sobrecarga que acepte un parámetro de tiempo de espera para especificar el tiempo máximo de espera para que aparezca un elemento de IU antes de finalizar la ejecución.

Al utilizar las API con sus respectivas sobrecargas, puedes lograr fácilmente la lógica y el comportamiento de automatización deseados.

Uso de API

Para utilizar las API de Excel, aplica los siguientes pasos:

1. Descarga el paquete de actividades.
2. Crear un flujo de trabajo codificado.
3. Llama al método excel.UseExcelFile para recuperar el identificador de un archivo de Excel.
   Nota: de forma predeterminada, el método excel.UseExcelFile utiliza las opciones de Excel de Configuración del proyecto para el manipulador resultante. Sin embargo, puedes cambiar el comportamiento anulando las opciones predeterminadas a través del método excel.ExcelProcessScope.
4. Utiliza el manipulador para realizar acciones. Con la automatización codificada de Excel, debes poder realizar las mismas operaciones que con las actividades modernas de Excel en un archivo .xaml.
   Nota: el manipulador IExcelProcess que se devuelve puede utilizarse con UseExcelFile para controlar mejor la aplicación de Excel. Por ejemplo, puedes controlar cómo se abre o cierra Excel al salir.
5. Para las actividades del libro, utiliza el método excel.UseWorkBook para recuperar el manipulador de un archivo de Excel. Las actividades disponibles también se implementan como métodos de extensión en la clase ExcelOperations.

Nota: las actividades de Excel se implementan en el servicio codificado como métodos de extensión para controladores. Para comprobar todos los métodos de extensión disponibles, escribe ExcelOperations. y luego Ctrl + Espacio.

Ejemplos

• UseExcelFile_1.Simple.cs: comprueba todos los métodos de extensión disponibles para los manipuladores.
• UseExcelFile_2MoreOptions.cs, UseExcelFile_3AllOptions.cs: utiliza el manipulador IExcelProcess para controlar mejor la aplicación de Excel.
• UseWorkbook_4.cs: recupera un manipulador de libro de Excel.
• UseExcelFile_Filter.cs: cómo filtrar Excel.
• UseExcelFile_PivotTable.cs: cómo crear y filtrar una tabla dinámica.
• UseExcelFile-ExecuteMacro.cs: cómo ejecutar una macro.

Los ejemplos mencionados pueden encontrarse en la ubicación de GitHub.