Leer columna

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumnConnections

Descripción

Utiliza la API Obtener rango de Microsoft Graph para recuperar valores de celda de una columna específica (CeldaDeInicio) en una hoja de cálculo (NombreDeLaHoja) de un libro de trabajo (Libro).

Después de recuperar el valor de la celda, la actividad devuelve el valor de la columna en una Object[] (columna).

Ámbitos

Esta actividad requiere los siguientes ámbitos:

• Archivos.LeerEscribir

O

• Archivos.leerEscribir todo

O

• Sitios. LeerEscribir.todo

Compatibilidad de proyectos

Windows | Multiplataforma

Configuración

• Microsoft OneDrive y SharePoint: la conexión de la cuenta de Microsoft 365 que se utilizará en la actividad.
• Libro : el DriveItem cuyos datos se leen.
• Ejemplo de libro : selecciona un archivo con los mismos rangos que el archivo de variables. Este campo se vuelve visible cuando seleccionas Usar plantilla de libro.
• 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 : la dirección de la celda inicial de la columna. Se devuelven todas las celdas contiguas por debajo de esta. Introduce la dirección de una sola celda en notación de estilo A1. Esta propiedad no admite un rango de celdas (por ejemplo, "A1:A5"). Esta propiedad admite variables String y valores en formato de cadena.

Entrada

• Tipo de valor : el tipo de datos que se leen del documento. Utiliza la lista desplegable para seleccionar una de las siguientes 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).
  • Valores y fórmulas : recupera los valores y fórmulas solo de la celda especificada (por ejemplo, =SUM(A1,B1)).
  • 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

• Columna: los valores de la columna como una matriz de objetos. Este campo solo admite variables Object[]. Es obligatorio si tienes previsto usar 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.
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 columna 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.