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 a Microsoft OneDrive y 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.

  • Ejemplo 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 menú de botones 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 explorar los archivos/carpetas de OneDrive o SharePoint y seleccionar una hoja de cálculo. Esta opción acepta la entrada como IResource.

    • Utiliza el menú 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 últimos datos.

  • Introduzca la opción de ID :

    • Id del libro: el ID del libro en cuestión. Esta propiedad admite variables String y valores en formato de string.
    • Dirección del sitio de SharePoint : la URL del sitio de SharePoint que contiene el archivo o la carpeta. Esta propiedad admite variables String y valores en formato de cadena. Abre tu sitio de SharePoint en un navegador y copia 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. Esta propiedad admite variables String y valores en formato de 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.

  • Introduce la opción de URL:

    • URL del libro: la URL del libro en cuestión. Esta propiedad admite variables String y valores en formato de string. Recupera la URL abriendo el archivo en un explorador.
• Intervalo : el intervalo en el que escribir. Este campo se rellena previamente con la información recuperada de la hoja de cálculo o de muestra de hoja de cálculo seleccionada. Esta propiedad admite variables String y valores en formato de cadena.

  • Seleccione la opción Actualizar rangos si ha modificado sus hojas y necesita recuperar los datos más recientes.

• Incluir encabezados : esta propiedad admite valores booleanos. Establézcalo en Verdadero para incluir también los encabezados de TablaDeDatos en el libro.

• Cómo escribir : especifica cómo añadir los datos al intervalo 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 DataTable 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 especiales de caracteres 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.

	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 cuando trabajes con rangos. El límite es de 4 MB, por ejemplo, una media de 10 000 celdas con 20 caracteres cada una para las solicitudes de lectura y 4 000 celdas de 20 caracteres cada una para las solicitudes de escritura. Para obtener más información, consulta las 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 principio 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