Leer celda

UiPath.MicrosoftOffice365.Activities.Excel.ReadCell

Descripción

Utiliza la API Obtener rango de Microsoft Graph para recuperar el valor de una celda especificada (CellAddress) en una hoja de cálculo de un libro (Workbook) (SheetName).

After retrieving the cell value, the activity returns it as a String according to the selected value type (ValueType).

Ámbitos

Esta actividad requiere los siguientes ámbitos:

• Sitios. Leer.todos

O

• Sitios. LeerEscribir.todo

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

Panel de propiedades

Común

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

Entrada

• Dirección de celda : la dirección de la celda desde la que se leen los datos. 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.
• 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

• 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

• CellValue - The cell's contents. Required if you plan to use the output data in subsequent activities.

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 Cell activity inside the Microsoft Office 365 Scope activity.
5. Introduce valores para las propiedades de entrada.
6. Crea e introduce una variable String 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 String a su variable de propiedad de salida.