Leer rango

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

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

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 ( NombreDeLaHoja) de un libro (Workbook). Después de recuperar el rango de datos de la celda, la actividad genera los valores en una DataTable (TablaDeDatos).

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

Propiedades

Común

• NombreParaMostrar: el nombre de la actividad que se muestra. Esta propiedad admite variables String y valores en formato de cadena.

Entrada

• Intervalo : el intervalo de celdas que se van a leer. Si no se especifica ningún rango, se lee toda la hoja. Introduce tu rango de celdas en notación 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 . Use la variable de propiedad de salida de las actividades Buscar archivos y carpetas (Primero o Resultados) o Crear libro (libro). Cuando utilice la propiedad de salida de resultados de la actividad Buscar archivos y carpetas , asegúrese de especificar qué elemento de la matriz desea utilizar (por ejemplo, mis libros (0)).

Otros

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

Opciones

• Agregar encabezados : si se selecciona, la primera fila del rango se agregan encabezados de columna sd en la TablaDeDatos. Este campo admite valores booleanos.

• Tipo de valor : el tipo de datos que se leen del documento. Utilice la lista desplegable para seleccionar una de las tres opciones:

  • Valores : predeterminado. Recupera el valor codificado (es decir, el backend) de las celdas de la fila. Esto puede diferir del valor de formato que se muestra en la hoja de cálculo de Excel (por ejemplo, si la celda muestra 23,00 en la hoja de cálculo, el valor codificado devuelto es 23).
  • Fórmulas : recupera solo la fórmula de la celda especificada (p. Ej., = SUM (A1, B1)). Si seleccionas fórmulas y la celda especificada no contiene una fórmula, el valor devuelto se establece de forma predeterminada en Valores.
  • Texto : recupera el valor de la celda de la hoja de cálculo de Excel (por ejemplo, si la celda muestra 23,00 en la hoja de cálculo, el valor del texto devuelto es 23,00).

Salida

• TablaDeDatos : el resultado de la lectura. Este campo solo admite variables DataTable . Obligatorio si tienes previsto 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 de configuración .
2. Agrega la actividad de Á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. Añade la actividad Leer rango dentro de la actividad Ámbito de Microsoft Office 365.
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 las propiedades de entrada se envían a la API ObtenerRango.
   • La API devuelve el valor DataTable a su variable de propiedad de salida.