Escribir rango

UiPath.MicrosoftOffice365.Activities.Excel.WriteRangeConnections

Descripción

Escribe una variable de DataTable en un rango de celdas del libro de Excel especificado.

Ámbitos

Esta actividad requiere los siguientes ámbitos:

• Archivos.LeerEscribir

O

• Archivos.leerEscribir todo

O

• Sitios. LeerEscribir.todo

Compatibilidad de proyectos

Windows | Multiplataforma

Configuración

• Conexión de Microsoft OneDrive & SharePoint : la conexión de la cuenta de Microsoft 365 que se utilizará en la actividad.
• Libro : el libro de Excel que se va a utilizar. El método para especificar la carpeta que se va a recuperar: Selector de carpetas, Introducir Id, Introducir URL.

  • Muestra de libro : la plantilla de libro que se va a utilizar. El campo es visible después de hacer clic en Usar plantilla de libro. Navega por las carpetas de OneDrive y selecciona un libro. En Studio Desktop, la opción está disponible en Ver más junto a Tipo de rango. Para obtener más información, consulta Trabajar con plantillas.

  • Opción de selector de archivos/carpetas : haz clic en la carpeta para navegar por los archivos/carpetas de OneDrive o SharePoint y seleccionar una hoja de cálculo. Esta opción acepta entrada como IResource.

    • Utilice la Ver más para utilizar una variable o selecciona la opción Volver a cargar datos de carpeta si has modificado tus carpetas y necesitas recuperar los datos más recientes.

  • Opción Introducir ID :

    • Id del libro : el identificador del libro de interés. Este campo admite entrada de tipo String .
    • Dirección del sitio de SharePoint : la URL del sitio de SharePoint que contiene el archivo o carpeta. Este campo admite entrada de tipo String Abra su sitio de SharePoint en un navegador y copie su URL, por ejemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial.
    • Biblioteca de documentos de SharePoint : la biblioteca de documentos dentro del sitio de SharePoint indicado que contiene el archivo o carpeta. Este campo admite entrada de tipo String . Abre la pestaña Documentos en tu sitio de SharePoint y copia la URL, por ejemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx.

  • Introduzca la opción de URL :

    • URL del libro : la URL del libro de interés. Este campo admite entrada de tipo String . Recupera la URL abriendo el archivo en un navegador.
• Intervalo : el intervalo en el que escribir. Este campo se rellena previamente con información recuperada de la hoja de cálculo o la muestra de hoja de cálculo seleccionada. Esta propiedad admite variables String y valores en formato de cadena.
  • Selecciona la opción Actualizar rangos si has modificado tus hojas y necesitas recuperar los datos más recientes.
• Include headers - This property supports Boolean values. Set to True to also include the DataTable headers into the workbook.
• Cómo escribir : especifica cómo añadir los datos al rango especificado. Las opciones disponibles son:
  • Sobrescribir : sobrescribe cualquier dato anterior que exista.
  • Anexar : escribe los datos en la primera fila vacía encontrada.
  • Anexar a la derecha : escribe los datos en la primera columna vacía encontrada. Consulta la sección Anexar a continuación para obtener más información.
  • Insertar : inserta una fila.
• Posición de fila : la posición del índice de fila donde la actividad va a insertar la fila. El índice se puede utilizar iterando en las filas del rango utilizando Leer rango o Para cada fila. Este campo se muestra si seleccionas Cómo escribir – Insertar. Este campo admite entrada de tipo Int32 .
• Qué escribir : los datos de la TablaDeDatos que se escribirán en el libro. Este campo admite variables DataTable . Por ejemplo, puedes utilizar la variable de salida de una actividad Leer rango .

Nota:

Algunas combinaciones de caracteres especiales en la propiedad Nombre de hoja/rango pueden hacer que la actividad arroje un error. Por ejemplo, Sheet%Test es una entrada válida, pero Sheet%44 no lo es (%44 se transforma en D).

Anexar

Actualmente, la adición de datos no admite rangos con nombre.

Tipo de intervalo	Adjuntar (al final)	Anexar derecha
Rango simple (notación A1)	Escriba el rango en la primera fila vacía que se encuentre en el rango de destino. Crea el número de filas necesarias y completa el rango con el rango de entrada. Si no hay una fila vacía en el rango, agrega el rango al final insertando el número necesario de filas y agregando el rango de entrada.	Escriba el rango en la primera columna vacía que se encuentre en el rango de destino. Crea el número de columnas necesarias y completa el rango con el rango de entrada. Si no hay una columna vacía en el rango, anexe el rango a la derecha insertando el número necesario de columnas y agregando el rango de entrada.
RangoConBandas	Escriba el rango en la primera fila vacía que se encuentre en el rango de destino. Crea el número de filas necesarias y completa el rango con el rango de entrada. Si no hay una fila vacía en el rango, agrega el rango al final insertando el número necesario de filas y agregando el rango de entrada.	Escriba el rango en la primera fila vacía que se encuentre en el rango de destino. Crea el número de filas necesarias y completa el rango con el rango de entrada. Si no hay una fila vacía en el rango, agrega el rango al final insertando el número necesario de filas y agregando el rango de entrada.
Hojas	Escriba el rango en la primera fila vacía que se encuentra en la hoja de destino. Crea el número de filas necesarias y completa el rango con el rango de entrada. Si no hay una fila vacía en el rango, agrega el rango al final insertando el número necesario de filas y agregando el rango de entrada.	Escriba el rango en la primera columna vacía que se encuentra en la hoja de destino. Crea el número de columnas necesarias y completa el rango con el rango de entrada. Si no hay una columna vacía en el rango, anexe el rango a la derecha insertando el número necesario de columnas y agregando el rango de entrada.

Limitaciones conocidas de las solicitudes

Ten en cuenta los límites de solicitud/respuesta al trabajar con rangos. El límite es de 4 MB, por ejemplo, una media de 10 000 celdas de 20 caracteres cada una para solicitudes de lectura y 4000 celdas de 20 caracteres cada una para solicitudes de escritura. Para obtener más información, consulta Especificaciones y límites de Excel.

Limitación conocida

Se produce un error si utilizas Escribir fila/Escribir rango con la opción Anexar y el rango de destino es una hoja que contiene una tabla vacía al principio (sin otros datos). La actividad intenta insertar una fila en la hoja, al inicio de la tabla, pero Graph API devuelve un error.

Ejemplo

Consulte también:

• Actividades de Excel en línea
• Crear libro
• Eliminar hoja
• Leer celda