Excel en ligne (OneDrive)
Le fournisseur de connexions Excel Online (OneDrive) vous permet d’utiliser des fichiers Excel stockés dans OneDrive. Ce fournisseur de connexions prend uniquement en charge les comptes personnels (MSA).
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Applications logiques | Norme | Toutes les régions Logic Apps |
| Power Apps | - | Non disponible |
| Power Automate | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
Problèmes connus et limitations
- La taille maximale d’un fichier Excel pris en charge par le connecteur Excel Online (OneDrive) est de 5 Mo.
- Les données peuvent ne pas être à jour (il peut y avoir un certain délai) lorsque le filtrage ou le tri est utilisé dans l’action
List rows present in a table. - L’action
List rows present in a tableprend en charge le filtrage et le tri de base :- Prend en charge les fonctions de filtre suivantes : eq, ne, contains, startswith, endswith.
- Seules 1 fonction de filtre peuvent être appliquées sur une colonne.
- Seules 1 colonne peuvent être utilisées pour le tri.
- L’action
List rows present in a tableretourne jusqu’à 256 lignes par défaut. Pour obtenir toutes les lignes, activez la pagination. - Un fichier Excel peut être verrouillé dans OneDrive pour une mise à jour ou supprimer jusqu’à 12 minutes depuis la dernière utilisation du connecteur.
- Les modifications simultanées apportées par d’autres connecteurs ou modifications manuelles ne sont pas prises en charge. Les utilisateurs doivent éviter d’écrire des données dans un seul fichier Excel à partir de plusieurs clients simultanément (Excel Desktop, Excel Web, Power Automate, LogicApps ou PowerApps). Cela peut entraîner des conflits de fusion et des incohérences de données possibles.
- Le connecteur prend en charge les fichiers dans les formats Feuille de calcul Microsoft Excel Open XML (*.xlsx) et Classeur binaire Microsoft Excel (.xlxb).
- Le connecteur récupère les lignes pour 500 colonnes maximum dans l’action
List rows present in a table. Les lignes des 500 premières colonnes sont retournées par défaut. Vous pouvez fournir une liste séparée par des virgules de colonnes spécifiques à récupérer dans leSelect Queryparamètre. - Le connecteur ne prend pas en charge l’utilisation des paramètres OData pour les tables qui contiennent des colonnes masquées.
- Le délai d’expiration du connecteur provoqué par les re-calculs peut se produire, soit il existe des formules complexes, soit il y a trop de lignes dans la feuille de calcul. Dans les deux cas, les données peuvent être insérées plusieurs fois en raison d’une stratégie de nouvelle tentative. Pour contourner ce problème, vérifiez si les formules peuvent être simplifiées ou réduites. Sinon, vous pouvez définir le mode de calcul de ce classeur sur Manuel. Pour plus d’informations, reportez-vous ici
- L’accès en écriture à un fichier est requis pour toutes les actions, sinon l’API Graph renvoie
403 Forbiddenune erreur. En outre, le connecteur renvoie l’erreur502 BadGatewaysi la feuille de calcul est en mode lecture seule. Pour désactiver le mode lecture seule, veuillez en savoir plus ici. -
Filter Query/Order By/Select Queryles paramètres d’opération prennent uniquement en charge les noms de colonnes alphanumériques. - Les tableaux croisés dynamiques ne sont pas pris en charge en raison des limitations de l’API Graph.
- Si un utilisateur effectue trop de requêtes dans un court laps de temps, il est possible d’obtenir une réponse 429. La limite de limitation est unique à chaque requête et varie en fonction du nombre de requêtes, de la mémoire utilisée et d’autres facteurs importants.
- Dans les opérations telles que
Delete a row, lekey columnchamp estcase-sensitive. - En cas de correspondances multiples dans des opérations telles que
Update a rowles opérations,Delete a rowseules la première ligne est mise à jour/supprimée. - Les modifications validées par des opérations telles que
Create a row,Update a rowDelete a rowne prennent pas toujours d’impact immédiatement après la réussite de la réponse d’une action Power Automate, LogicApps ou Power Apps correspondante. Les retards jusqu’à 30 secondes sont attendus en raison des limitations de service back-end sous-jacentes. - Le connecteur peut remplir jusqu’à 6 000 lignes automatiquement si
Insert auto generated id into Excel tablel’option est sélectionnée lors d’une importation de table dans PowerApps. - Les en-têtes de colonne de tables qui contiennent uniquement un nombre peuvent entraîner un comportement inattendu dans les opérations telles que
Update a row,Delete a rowen raison des limitations du service principal sous-jacent. Pour contourner ce problème, renommez ces colonnes afin qu’elles contiennent également d’autres caractères. - Un fichier Excel peut être modifié et une nouvelle version peut être visible dans l’historique des versions du fichier même lorsqu’une action « lecture seule » est exécutée. Ce comportement est dû à la conception à des mécanismes d’enregistrement internes du service principal du connecteur.
- Excrypté ou marqué comme feuilles protégées, lèvez une erreur de fichier endommagée, même si le fichier peut être ouvert manuellement.
Gestion des noms de colonnes
Notez que les noms de colonnes dans les résultats de réponse de l’action peuvent être transformés afin d’être compatibles avec le format OData :
| Caractère | Valeur encodée |
|---|---|
| . | _x002e_ |
| @ | _x0040_ |
| : | _x003a_ |
| # | _x0023_ |
Par exemple - Column [one]#1>Column [one]_x0023_1
Concepts et exemples
-
Key column: colonne dans une table qui sera utilisée pour rechercher une valeur (key value) -
Key value: valeur dans cellekey columnqui sera utilisée pour identifier une ligne spécifique.
Prenez le tableau suivant comme exemple. Pour effectuer une opération de ligne dans la deuxième ligne de la table, la key column valeur doit être Column 1 et key value doit être 200.
| Colonne 1 | Colonne 2 | Colonne 3 |
|---|---|---|
| 100 | A-2 | A-3 |
| 200 | B-2 | B-3 |
| 300 | C-2 | C-3 |
Limites générales
| Nom | Valeur |
|---|---|
| Nombre maximal de variantes de colonne d’identité qui peuvent être utilisées pour obtenir/insérer/mettre à jour/supprimer une ligne d’un tableau Excel unique. La valeur actuelle est définie sur 2, ce qui signifie que jusqu’à deux variantes de nom de colonne doivent être utilisées dans les workflows d’une table particulière. | 2 |
| Le nombre maximal de lignes que le connecteur peut remplir automatiquement si l’option « Insérer l’ID généré automatiquement dans l’option de tableau Excel » est sélectionnée lors d’une importation de table dans PowerApps. | 64000 |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Ajouter une colonne clé à une table |
Ajoutez une colonne clé à un tableau Excel. La nouvelle colonne est ajoutée à droite. La nouvelle colonne clé doit être unique dans la table. |
| Ajouter une ligne dans une table |
Ajoutez une nouvelle ligne dans le tableau Excel. |
| Ajouter une ligne dans une table [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt Ajouter une ligne dans une table .
|
| Créer une feuille de calcul |
Créez une feuille de calcul dans le classeur Excel. |
| Créer une table |
Créez un tableau dans le classeur Excel. |
| Mettre à jour une ligne |
Mettez à jour une ligne à l’aide d’une colonne clé. La valeur d’entrée remplacera les cellules et colonnes spécifiées à gauche vides ne seront pas mises à jour. Pour ajouter (au lieu de remplacer) une valeur, utilisez l’action « Obtenir une ligne » pour récupérer le contenu en premier. |
| Obtenir des feuilles de calcul |
Obtenez la liste des feuilles de calcul dans le classeur Excel. |
| Obtenir des tables |
Obtenez la liste des tableaux dans le classeur Excel. |
| Obtenir une ligne |
Obtenir une ligne à l’aide d’une colonne clé. Cette action récupère toutes les valeurs de la ligne spécifiée en fonction d’une colonne et d’une colonne clé. |
| Répertorier les lignes présentes dans une table |
Répertorier les lignes présentes dans un tableau. |
| Supprimer une ligne |
Supprimez une ligne à l’aide d’une colonne clé. |
Ajouter une colonne clé à une table
Ajoutez une colonne clé à un tableau Excel. La nouvelle colonne est ajoutée à droite. La nouvelle colonne clé doit être unique dans la table.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Table
|
table | True | string |
Sélectionnez un tableau dans la liste déroulante. |
|
Colonne clé
|
idColumn | string |
Indiquez le nom de la colonne clé. |
Ajouter une ligne dans une table
Ajoutez une nouvelle ligne dans le tableau Excel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Table
|
table | True | string |
Sélectionnez un tableau dans la liste déroulante. |
|
Ligne
|
item | True | dynamic |
Ligne à ajouter dans le tableau Excel spécifié. |
|
DateTime Format
|
dateTimeFormat | string |
Format DateTime. |
Retours
Ajouter une ligne dans une table [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt Ajouter une ligne dans une table .
Ajoutez une nouvelle ligne dans le tableau Excel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Table
|
table | True | string |
Sélectionnez un tableau dans la liste déroulante. |
|
Ligne
|
item | True | dynamic |
Ligne à insérer dans le tableau Excel spécifié. |
Créer une feuille de calcul
Créez une feuille de calcul dans le classeur Excel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Nom
|
name | string |
Nom de la feuille de calcul. |
Retours
- Corps
- WorksheetMetadata
Créer une table
Créez un tableau dans le classeur Excel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Nom de la table
|
TableName | string |
Entrez le nom du tableau Excel. |
|
|
Plage de tables
|
Range | True | string |
Entrez l’adresse de table à l’aide de la notation A1. |
|
Noms de colonnes
|
ColumnsNames | string |
Entrez les noms de colonnes séparés par « ; » ou « », |
Retours
Métadonnées de table
- Corps
- TableMetadata
Mettre à jour une ligne
Mettez à jour une ligne à l’aide d’une colonne clé. La valeur d’entrée remplacera les cellules et colonnes spécifiées à gauche vides ne seront pas mises à jour. Pour ajouter (au lieu de remplacer) une valeur, utilisez l’action « Obtenir une ligne » pour récupérer le contenu en premier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Table
|
table | True | string |
Sélectionnez un tableau dans la liste déroulante. |
|
Colonne clé
|
idColumn | True | string |
Sélectionnez une colonne dans la liste déroulante. |
|
Valeur de clé
|
id | True | string |
Entrez la valeur de clé. |
|
Fournir les propriétés de l’élément
|
item | True | dynamic |
Fournissez les propriétés de l’élément. |
|
DateTime Format
|
dateTimeFormat | string |
Format DateTime. |
Retours
Obtenir des feuilles de calcul
Obtenez la liste des feuilles de calcul dans le classeur Excel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | array of WorksheetMetadata |
Obtenir des tables
Obtenez la liste des tableaux dans le classeur Excel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
Id
|
value.id | string |
ID de table. |
|
Nom
|
value.name | string |
Nom de la table. |
|
Afficher les colonnes en bandes
|
value.showBandedColumns | boolean |
Afficher les colonnes en bandes. |
|
Mettre en surbrillance la première colonne
|
value.highlightFirstColumn | boolean |
Mettez en surbrillance la première colonne. |
|
Mettre en surbrillance la dernière colonne
|
value.highlightLastColumn | boolean |
Mettez en surbrillance la dernière colonne. |
|
Afficher les lignes en bandes
|
value.showBandedRows | boolean |
Afficher les lignes en bandes. |
|
Bouton Afficher le filtre
|
value.showFilterButton | boolean |
Bouton Afficher le filtre. |
|
Afficher les en-têtes
|
value.showHeaders | boolean |
Afficher les en-têtes. |
|
Afficher les totaux
|
value.showTotals | boolean |
Afficher les totaux. |
|
Style
|
value.style | string |
Style de tableau. |
Obtenir une ligne
Obtenir une ligne à l’aide d’une colonne clé. Cette action récupère toutes les valeurs de la ligne spécifiée en fonction d’une colonne et d’une colonne clé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Table
|
table | True | string |
Sélectionnez un tableau dans la liste déroulante. |
|
Colonne clé
|
idColumn | True | string |
Sélectionnez une colonne dans la liste déroulante. |
|
Valeur de clé
|
id | True | string |
Entrez la valeur de clé. |
|
DateTime Format
|
dateTimeFormat | string |
Format DateTime. |
Retours
Répertorier les lignes présentes dans une table
Répertorier les lignes présentes dans un tableau.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Table
|
table | True | string |
Sélectionnez un tableau dans la liste déroulante. |
|
Filtrer la requête
|
$filter | string |
Requête de filtre ODATA pour restreindre les entrées retournées. |
|
|
Commande par
|
$orderby | string |
Requête ODATA orderBy pour spécifier l’ordre des entrées. |
|
|
Nombre supérieur
|
$top | integer |
Nombre total d’entrées à récupérer (valeur par défaut = all). |
|
|
Ignorer le nombre
|
$skip | integer |
Nombre d’entrées à ignorer (valeur par défaut = 0). |
|
|
Sélectionner la requête
|
$select | string |
Liste séparée par des virgules de colonnes à récupérer (500 premiers par défaut). |
|
|
DateTime Format
|
dateTimeFormat | string |
Format DateTime. |
Retours
Supprimer une ligne
Supprimez une ligne à l’aide d’une colonne clé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | True | string |
Sélectionnez un fichier Excel via File Browse. |
|
Table
|
table | True | string |
Sélectionnez un tableau dans la liste déroulante. |
|
Colonne clé
|
idColumn | True | string |
Sélectionnez une colonne dans la liste déroulante. |
|
Valeur de clé
|
id | True | string |
Entrez la valeur de clé. |
Définitions
TableMetadata
Métadonnées de table
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
nom
|
name | string |
Nom de la table |
|
title
|
title | string |
Titre du tableau |
|
x-ms-permission
|
x-ms-permission | string |
Autorisation de table |
|
x-ms-capabilities
|
x-ms-capabilities | TableCapabilitiesMetadata |
Métadonnées d’une table (fonctionnalités) |
|
schéma
|
schema | Object | |
|
referencedEntities
|
referencedEntities | Object | |
|
webUrl
|
webUrl | string |
Lien d’URL |
TableCapabilitiesMetadata
Métadonnées d’une table (fonctionnalités)
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
sortRestrictions
|
sortRestrictions | TableSortRestrictionsMetadata |
Métadonnées d’une table (restrictions de tri) |
|
filterRestrictions
|
filterRestrictions | TableFilterRestrictionsMetadata |
Métadonnées d’une table (restrictions de filtre) |
|
selectRestrictions
|
selectRestrictions | TableSelectRestrictionsMetadata |
Métadonnées d’une table (restrictions de sélection) |
|
isOnlyServerPagable
|
isOnlyServerPagable | boolean |
Restrictions de pagination du serveur |
|
filterFunctionSupport
|
filterFunctionSupport | array of string |
Liste des fonctionnalités de filtre prises en charge |
|
serverPagingOptions
|
serverPagingOptions | array of string |
Liste des fonctionnalités de pagination basées sur le serveur prises en charge |
Objet
TableSortRestrictionsMetadata
Métadonnées d’une table (restrictions de tri)
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
sortable
|
sortable | boolean |
Indique si cette table comporte des colonnes triables |
|
unsortableProperties
|
unsortableProperties | array of string |
Liste des propriétés non triables |
|
ascendingOnlyProperties
|
ascendingOnlyProperties | array of string |
Liste des propriétés qui prennent en charge l’ordre croissant uniquement |
TableFilterRestrictionsMetadata
Métadonnées d’une table (restrictions de filtre)
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
filterable
|
filterable | boolean |
Indique si cette table a des colonnes filtrables |
|
nonFilterableProperties
|
nonFilterableProperties | array of string |
Liste des propriétés non filtrables |
|
requiredProperties
|
requiredProperties | array of string |
Liste des propriétés requises |
TableSelectRestrictionsMetadata
Métadonnées d’une table (restrictions de sélection)
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Sélectionnable
|
selectable | boolean |
Indique si cette table a des colonnes sélectionnables |
WorksheetMetadata
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
ID de feuille de calcul. |
|
Nom
|
name | string |
Nom de la feuille de calcul. |
|
Poste
|
position | integer |
Position de la feuille de calcul. |
|
Visibilité
|
visibility | string |
Visibilité de la feuille de calcul. |