Leer fila

UiPath.MicrosoftOffice365.Activities.Excel.ReadRow

Descripción

Utiliza la API Obtener rango de Microsoft Graph para recuperar los valores de las celdas de una fila especificada ( CeldaDeInicio) en una hoja de cálculo ( NombreDeLaHoja )de unlibro ( Workbook).

Después de recuperar los datos de todas las celdas de la fila, la actividad genera los valores en una Object[] (Fila).

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

• 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.
• Celda de inicio : la dirección de la celda de inicio de la fila. Se devuelven todas las celdas contiguas a la derecha de esta. Introduce la dirección de una sola celda en notación estilo A1. Esta propiedad no admite un rango de celdas (p. Ej., "A1: A5"). 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

• 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

• Fila : los valores de la fila como una matriz de objetos. Este campo solo admite Object[] variables. Obligatorio si planea utilizar los datos de salida en actividades posteriores.

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 fila dentro de la actividad Ámbito de Microsoft Office 365.
5. Introduce valores para las propiedades de entrada.
6. Crea e introduce una variable Object[] 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 Object[] a su variable de propiedad de salida.