Leer columna

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumn

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).

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 columna. Todas las celdas contiguas por debajo de esta se devuelven. Introduzca la dirección de una sola celda en notación tipo A1. Esta propiedad no admite un intervalo de celdas (por ejemplo, "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

• 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 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 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.