Leer rango

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

Descripción

Utiliza la API Obtener rango de Microsoft Graph para recuperar valores de un rango de celdas especificado (Rango) en una hoja de cálculo (Workbook) de un libro (NombreDeLaHoja). Después de recuperar el rango de datos de la celda, la actividad genera los valores en una DataTable (TablaDeDatos).

Ámbitos

Esta actividad requiere los siguientes ámbitos:

• Sitios. Leer.todos

O

• Sitios. LeerEscribir.todo

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

Propiedades

Común

• NombreParaMostrar : el nombre para mostrar de la actividad. Esta propiedad admite variables String y valores en formato de cadena.

Entrada

• Intervalo : el intervalo de celdas que se leerán. Si no se especifica ningún rango, se lee toda la hoja. Introduce tu rango de celdas en notación de estilo A1 (por ejemplo, "A1:A5"). Esta propiedad admite variables String y valores en formato de cadena.
• Nombre de la hoja : el nombre de la hoja desde la que se leen los datos. Esta propiedad admite variables String y valores en formato de cadena.
• Libro : el DriveItem cuyos datos se leen. Este objeto se puede recuperar utilizando la actividad Buscar archivos y carpetas . Utiliza la variable de propiedad de salida de las actividades Buscar archivos y carpetas (Primeros o Resultados) o Crear libro (Libro de trabajo). Al utilizar la propiedad de salida Resultados de la actividad Buscar archivos y carpetas , asegúrate de especificar qué elemento de la matriz deseas utilizar (por ejemplo, myWorkbooks(0)).

Otros

• Privado : si se selecciona, los valores de las variables y los argumentos ya no se registran en el nivel Detallado. Este campo admite valores booleanos.

Opciones

• Añadir encabezados : si se selecciona, la primera fila del rango se añade a los encabezados de columna sd en la TablaDeDatos. Este campo admite valores booleanos.
• Value Type - The type of data that is read from the document. Use the drop-down list to select one of the three options:
  • Values - Default. Retrieves the coded value (i.e., backend) of the cells in the row. This might differ from the format value shown in the Excel worksheet (e.g., if the cell displays 23.00 in the worksheet, the coded value returned is 23).
  • Formulas - Retrieves the formula of the specified cell only (e.g., =SUM(A1,B1)). If you select Formulas and the specified cell doesn't contain a formula, the returned value defaults to Values.
  • Text - Retrieves the Excel worksheet value of the cell (e.g., if the cell displays 23.00 in the worksheet, the text value returned is 23.00).

Salida

• TablaDeDatos : el resultado de la lectura. Este campo solo admite variables DataTable . Obligatorio si planeas utilizar los datos de salida en actividades posteriores. Para obtener el contenido de la TablaDeDatos , utiliza una actividad que tenga una propiedad de entrada DataTable (por ejemplo, Tabla de datos de salida, Para cada fila, Anexar a CSV, etc.).

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos.
2. Añade la actividad Ámbito de Microsoft Office 365 a tu proyecto.
3. Añade una actividad o ejecuta un proceso externo que genere un objeto DriveItem (por ejemplo, Buscar archivos y carpetas, Crear libro, Copiar elemento).
4. Add the Read Range activity inside the Microsoft Office 365 Scope activity.
5. Introduce valores para las propiedades de entrada.
6. Crea e introduce una variable DataTable para la propiedad Salida.
7. Ejecuta la actividad.
   • Los valores de propiedad de entrada se envían a la API ObtenerRango .
   • La API devuelve el valor DataTable a su variable de propiedad de salida.