Compartir a través de


Excel Online (OneDrive)

El proveedor de conexiones de Excel Online (OneDrive) le permite trabajar con archivos de Excel almacenados en OneDrive. Este proveedor de conexiones solo admite cuentas personales (MSA).

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Estándar Todas las regiones de Power Automate excepto las siguientes:
     - China Cloud operado por 21Vianet
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps
Power Apps - No disponible
Power Automate Estándar Todas las regiones de Power Automate excepto las siguientes:
     - China Cloud operado por 21Vianet
Metadatos del conector
Publicador Microsoft

Problemas conocidos y limitaciones

  • El tamaño máximo de un archivo de Excel compatible con el conector de Excel Online (OneDrive) es de 5 MB.
  • Es posible que los datos no estén actualizados (puede haber algún retraso) al filtrar o ordenar se usa en la List rows present in a table acción.
  • La List rows present in a table acción admite el filtrado y la ordenación básicos:
    • Admite las siguientes funciones de filtro: eq, ne, contains, startswith, endswith.
    • Solo se puede aplicar 1 función de filtro en una columna.
    • Solo se pueden usar 1 columna para la ordenación.
  • La List rows present in a table acción devuelve hasta 256 filas de forma predeterminada. Para obtener todas las filas, active la paginación.
  • Un archivo de Excel puede bloquearse en OneDrive para una actualización o eliminar hasta 12 minutos desde el último uso del conector.
  • No se admiten modificaciones simultáneas de archivos realizadas por otros conectores o modificaciones manuales. Los usuarios deben evitar escribir datos en un único archivo de Excel desde varios clientes simultáneamente (Excel Desktop, Excel Web, Power Automate, LogicApps o PowerApps). Esto puede provocar posibles conflictos de combinación y incoherencia de datos.
  • El conector admite archivos en formatos de hoja de cálculo open XML de Microsoft Excel (*.xlsx) y libro binario de Microsoft Excel (.xlxb).
  • El conector recupera filas para 500 columnas como máximo en la List rows present in a table acción. Las filas de las primeras 500 columnas se devuelven de forma predeterminada. Puede proporcionar una lista separada por comas de columnas específicas para recuperarlas en Select Query el parámetro .
  • El conector no admite el uso de parámetros OData para tablas que contienen columnas ocultas.
  • El tiempo de espera del conector causado por los re-cálculos puede producirse, ya sea hay fórmulas complicadas o hay demasiadas filas en la hoja de cálculo. En ambos casos, los datos se pueden insertar varias veces debido a la directiva de reintento. Como solución alternativa, consulte si las fórmulas podrían simplificarse o reducirse. De lo contrario, puede establecer el modo de cálculo de este libro en Manual. Para obtener más información, consulte aquí.
  • El acceso de escritura a un archivo es necesario para todas las acciones; de lo contrario, Graph API devolverá 403 Forbidden un error. Además, el conector devolverá el 502 BadGateway error si la hoja de cálculo está en modo de solo lectura. Para deshabilitar el modo de solo lectura, obtenga más información aquí.
  • Filter Query / Order By / Select Query Los parámetros de operación solo admiten nombres de columna alfanuméricos.
  • Las tablas dinámicas no se admiten debido a las limitaciones de Graph API.
  • Si un usuario realiza demasiadas solicitudes en un breve período de tiempo, es posible obtener una respuesta 429. El límite es único para cada solicitud y varía en función del recuento de solicitudes, la memoria usada y otros factores importantes.
  • En operaciones como Delete a row, el key column campo es case-sensitive.
  • En el caso de varias coincidencias en operaciones como Update a row, Delete a row solo se actualizará o eliminará la primera fila.
  • Los cambios confirmados por operaciones como Create a row, Update a row, Delete a row no siempre afectan inmediatamente después de una respuesta correcta de las acciones correspondientes de Power Automate, LogicApps o Power Apps. Se esperan retrasos de hasta 30 segundos debido a las limitaciones del servicio back-end subyacente.
  • El conector puede rellenar automáticamente hasta 64000 filas si Insert auto generated id into Excel table se selecciona la opción durante una importación de tabla en PowerApps.
  • Los encabezados de columna de tablas que contienen solo un número pueden provocar un comportamiento inesperado en operaciones como Update a row, Delete a row debido a limitaciones del servicio back-end subyacentes. Como solución alternativa, cambie el nombre de estas columnas para que contengan también otros caracteres.
  • Un archivo de Excel se puede modificar y una nueva versión puede estar visible en el historial de versiones del archivo incluso cuando se ejecuta una acción de "solo lectura". Este comportamiento es por diseño debido a los mecanismos de guardado internos del servicio back-end del conector.
  • Se ha cifrado o marcado como hojas protegidas, se produce un error de archivo dañado, aunque el archivo se pueda abrir manualmente.

Control de nombres de columna

Tenga en cuenta que los nombres de columna de los resultados de la respuesta de la acción se pueden transformar para ser compatibles con el formato OData:

Carácter Valor codificado
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

Por ejemplo, Column [one]#1 ->Column [one]_x0023_1

Conceptos y ejemplos

  • Key column: columna de una tabla que se usará para buscar un valor (key value)
  • Key value: valor de que key column se usará para identificar una fila específica.

Tome la tabla siguiente como ejemplo. Para realizar una operación de fila en la segunda fila de la tabla, key column debe ser Column 1 y key value debe ser 200.

Columna 1 Columna 2 Columna 3
100 A-2 A-3
200 B-2 B-3
300 C-2 C-3

Límites generales

Nombre Importancia
Número máximo de variantes de columna de identidad que se pueden usar para obtener, insertar, actualizar o eliminar una fila de una sola tabla de Excel. El valor actual se establece en 2, lo que significa que hasta dos variantes de nombre de columna deben usarse en flujos de trabajo para una tabla determinada. 2
Número máximo de filas que el conector puede rellenar automáticamente si se selecciona la opción "Insertar identificador generado automáticamente en la tabla de Excel" durante una importación de tabla en PowerApps. 64000

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualizar una fila

Actualice una fila mediante una columna de clave. El valor de entrada sobrescribirá las celdas y columnas especificadas que quedan en blanco no se actualizarán. Para anexar (en lugar de sobrescribir) un valor, use la acción "Obtener una fila" para recuperar primero el contenido.

Agregar una columna de clave a una tabla

Agregue una columna de clave a una tabla de Excel. La nueva columna se anexará a la derecha. La nueva columna de clave debe ser única en la tabla.

Agregar una fila a una tabla

Agregue una nueva fila a la tabla de Excel.

Agregar una fila a una tabla [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Agregar una fila a una tabla .

Agregue una nueva fila a la tabla de Excel.

Crear hoja de cálculo

Cree una hoja de cálculo en el libro de Excel.

Crear tabla

Cree una nueva tabla en el libro de Excel.

Eliminar una fila

Elimine una fila mediante una columna de clave.

Enumerar filas presentes en una tabla

Enumera las filas presentes en una tabla.

Obtener hojas de cálculo

Obtenga una lista de hojas de cálculo en el libro de Excel.

Obtener tablas

Obtenga una lista de tablas en el libro de Excel.

Obtener una fila

Obtenga una fila mediante una columna de clave. Esta acción recuperará todos los valores de la fila especificada dada una columna y una columna de clave.

Actualizar una fila

Actualice una fila mediante una columna de clave. El valor de entrada sobrescribirá las celdas y columnas especificadas que quedan en blanco no se actualizarán. Para anexar (en lugar de sobrescribir) un valor, use la acción "Obtener una fila" para recuperar primero el contenido.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Table
table True string

Seleccione una tabla en la lista desplegable.

Columna de clave
idColumn True string

Seleccione una columna en la lista desplegable.

Valor de clave
id True string

Escriba el valor de clave.

Proporcionar las propiedades del elemento
item True dynamic

Proporcione las propiedades del elemento.

Formato DateTime
dateTimeFormat string

Formato DateTime.

Devoluciones

Las salidas de esta operación son dinámicas.

Agregar una columna de clave a una tabla

Agregue una columna de clave a una tabla de Excel. La nueva columna se anexará a la derecha. La nueva columna de clave debe ser única en la tabla.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Table
table True string

Seleccione una tabla en la lista desplegable.

Columna de clave
idColumn string

Proporcione el nombre de la columna de clave.

Agregar una fila a una tabla

Agregue una nueva fila a la tabla de Excel.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Table
table True string

Seleccione una tabla en la lista desplegable.

Row
item True dynamic

Fila que se va a agregar a la tabla de Excel especificada.

Formato DateTime
dateTimeFormat string

Formato DateTime.

Devoluciones

Las salidas de esta operación son dinámicas.

Agregar una fila a una tabla [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Agregar una fila a una tabla .

Agregue una nueva fila a la tabla de Excel.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Table
table True string

Seleccione una tabla en la lista desplegable.

Row
item True dynamic

Fila que se va a insertar en la tabla de Excel especificada.

Crear hoja de cálculo

Cree una hoja de cálculo en el libro de Excel.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Nombre
name string

Nombre de la hoja de cálculo.

Devoluciones

Crear tabla

Cree una nueva tabla en el libro de Excel.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Nombre de la tabla
TableName string

Escriba el nombre de la tabla de Excel.

Intervalo de tablas
Range True string

Escriba la dirección de tabla mediante notación A1.

Nombres de columnas
ColumnsNames string

Escriba los nombres de columna separados por ';' o ','.

Devoluciones

Metadatos de tabla

Eliminar una fila

Elimine una fila mediante una columna de clave.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Table
table True string

Seleccione una tabla en la lista desplegable.

Columna de clave
idColumn True string

Seleccione una columna en la lista desplegable.

Valor de clave
id True string

Escriba el valor de clave.

Enumerar filas presentes en una tabla

Enumera las filas presentes en una tabla.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Table
table True string

Seleccione una tabla en la lista desplegable.

Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas.

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Lista separada por comas de columnas que se van a recuperar (primero 500 de forma predeterminada).

Formato DateTime
dateTimeFormat string

Formato DateTime.

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener hojas de cálculo

Obtenga una lista de hojas de cálculo en el libro de Excel.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of WorksheetMetadata

Obtener tablas

Obtenga una lista de tablas en el libro de Excel.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of object
Id
value.id string

Id. de tabla.

Nombre
value.name string

Nombre de la tabla.

Mostrar columnas agrupadas
value.showBandedColumns boolean

Mostrar columnas agrupadas.

Resaltar la primera columna
value.highlightFirstColumn boolean

Resalte la primera columna.

Resaltar la última columna
value.highlightLastColumn boolean

Resalte la última columna.

Mostrar filas agrupadas
value.showBandedRows boolean

Mostrar filas agrupadas.

Botón Mostrar filtro
value.showFilterButton boolean

Botón Mostrar filtro.

Mostrar encabezados
value.showHeaders boolean

Mostrar encabezados.

Mostrar totales
value.showTotals boolean

Mostrar totales.

Style
value.style string

Estilo de tabla.

Obtener una fila

Obtenga una fila mediante una columna de clave. Esta acción recuperará todos los valores de la fila especificada dada una columna y una columna de clave.

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True string

Seleccione un archivo de Excel a través del examen de archivos.

Table
table True string

Seleccione una tabla en la lista desplegable.

Columna de clave
idColumn True string

Seleccione una columna en la lista desplegable.

Valor de clave
id True string

Escriba el valor de clave.

Formato DateTime
dateTimeFormat string

Formato DateTime.

Devoluciones

Las salidas de esta operación son dinámicas.

Definiciones

TableMetadata

Metadatos de tabla

Nombre Ruta de acceso Tipo Description
nombre
name string

Nombre de la tabla

title
title string

Título de tabla

x-ms-permission
x-ms-permission string

Permiso de tabla

x-ms-capabilities
x-ms-capabilities TableCapabilitiesMetadata

Metadatos de una tabla (funcionalidades)

schema
schema Object
referencedEntities
referencedEntities Object
webUrl
webUrl string

Vínculo url

TableCapabilitiesMetadata

Metadatos de una tabla (funcionalidades)

Nombre Ruta de acceso Tipo Description
sortRestrictions
sortRestrictions TableSortRestrictionsMetadata

Metadatos de una tabla (restricciones de ordenación)

filterRestrictions
filterRestrictions TableFilterRestrictionsMetadata

Metadatos de una tabla (restricciones de filtro)

selectRestrictions
selectRestrictions TableSelectRestrictionsMetadata

Metadatos de una tabla (seleccionar restricciones)

isOnlyServerPagable
isOnlyServerPagable boolean

Restricciones de paginación del servidor

filterFunctionSupport
filterFunctionSupport array of string

Lista de funcionalidades de filtro admitidas

serverPagingOptions
serverPagingOptions array of string

Lista de funcionalidades de paginación controladas por servidor admitidas

Objeto

TableSortRestrictionsMetadata

Metadatos de una tabla (restricciones de ordenación)

Nombre Ruta de acceso Tipo Description
sortable
sortable boolean

Indica si esta tabla tiene columnas ordenables.

unsortableProperties
unsortableProperties array of string

Lista de propiedades no ordenados

ascendingOnlyProperties
ascendingOnlyProperties array of string

Lista de propiedades que solo admiten orden ascendente

TableFilterRestrictionsMetadata

Metadatos de una tabla (restricciones de filtro)

Nombre Ruta de acceso Tipo Description
filterable
filterable boolean

Indica si esta tabla tiene columnas filtrables.

nonFilterableProperties
nonFilterableProperties array of string

Lista de propiedades no filtrables

requiredProperties
requiredProperties array of string

Lista de propiedades necesarias

TableSelectRestrictionsMetadata

Metadatos de una tabla (seleccionar restricciones)

Nombre Ruta de acceso Tipo Description
seleccionable
selectable boolean

Indica si esta tabla tiene columnas seleccionables.

WorksheetMetadata

Nombre Ruta de acceso Tipo Description
Id
id string

Id. de hoja de cálculo.

Nombre
name string

Nombre de la hoja de cálculo.

Position
position integer

Posición de la hoja de cálculo.

Visibilidad
visibility string

Visibilidad de la hoja de cálculo.