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 tableacción. - La
List rows present in a tableacció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 tableacció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 tableacció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 enSelect Queryel 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 Forbiddenun error. Además, el conector devolverá el502 BadGatewayerror 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 QueryLos 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, elkey columncampo escase-sensitive. - En el caso de varias coincidencias en operaciones como
Update a row,Delete a rowsolo se actualizará o eliminará la primera fila. - Los cambios confirmados por operaciones como
Create a row,Update a row,Delete a rowno 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 tablese 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 rowdebido 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 quekey columnse 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 .
|
| 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
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
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
- Body
- WorksheetMetadata
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
- Body
- TableMetadata
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
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
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. |