Partager via


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 table prend 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 table retourne 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 le Select Query paramè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 Forbidden une erreur. En outre, le connecteur renvoie l’erreur 502 BadGateway si 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 Query les 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, le key column champ est case-sensitive.
  • En cas de correspondances multiples dans des opérations telles que Update a rowles opérations, Delete a row seules 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 row ne 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 table l’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 row en 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 celle key column qui 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 .

Ajoutez une nouvelle ligne dans le tableau Excel.

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

Les sorties de cette opération sont dynamiques.

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

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

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

Les sorties de cette opération sont dynamiques.

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

Les sorties de cette opération sont dynamiques.

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

Les sorties de cette opération sont dynamiques.

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.