Delen via


Excel Online (OneDrive)

Met de excel onlineverbindingsprovider (OneDrive) kunt u werken met Excel-bestanden die zijn opgeslagen in OneDrive. Deze verbindingsprovider ondersteunt alleen persoonlijke (MSA)-accounts.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Standaard Alle Power Automate-regio's , met uitzondering van het volgende:
     - China Cloud beheerd door 21Vianet
Logic-apps Standaard Alle Logic Apps-regio's
Power Apps - Niet beschikbaar
Power Automate Standaard Alle Power Automate-regio's , met uitzondering van het volgende:
     - China Cloud beheerd door 21Vianet
Connectormetagegevens
Uitgever Microsoft

Bekende problemen en beperkingen

  • De maximale grootte van een Excel-bestand dat wordt ondersteund door de Excel Online-connector (OneDrive) is 5 MB.
  • De gegevens zijn mogelijk niet up-to-date (er kan enige vertraging zijn) wanneer filteren of sorteren wordt gebruikt in de List rows present in a table actie.
  • De List rows present in a table actie ondersteunt basisfilters en -sortering:
    • Ondersteunt de volgende filterfuncties: eq, ne, contains, startswith, endswith.
    • Er kan slechts 1 filterfunctie worden toegepast op een kolom.
    • Er kan slechts één kolom worden gebruikt voor sorteren.
  • De List rows present in a table actie retourneert standaard maximaal 256 rijen. Schakel paginering in om alle rijen op te halen.
  • Een Excel-bestand is mogelijk vergrendeld in OneDrive voor een update of verwijder maximaal 12 minuten sinds het laatste gebruik van de connector.
  • Gelijktijdige bestandswijzigingen die door andere connectors of handmatige bewerkingen zijn aangebracht, worden niet ondersteund. Gebruikers moeten het schrijven van gegevens naar één Excel-bestand van meerdere clients tegelijkertijd vermijden (Excel Desktop, Excel Web, Power Automate, LogicApps of PowerApps). Dit kan mogelijke samenvoegingsconflicten en inconsistentie van gegevens veroorzaken.
  • De connector ondersteunt bestanden in Microsoft Excel Open XML Spreadsheet (*.xlsx) en indelingen van binaire Microsoft Excel-werkmappen (.xlxb).
  • De connector haalt rijen op voor maximaal 500 kolommen in de List rows present in a table actie. Rijen voor eerste 500 kolommen worden standaard geretourneerd. U kunt een door komma's gescheiden lijst met specifieke kolommen opgeven om op te halen in Select Query de parameter.
  • De connector biedt geen ondersteuning voor het gebruik van OData-parameters voor tabellen die verborgen kolommen bevatten.
  • De time-out van de connector die wordt veroorzaakt door nieuwe berekeningen, kan optreden, er zijn ingewikkelde formules of er zijn te veel rijen in het werkblad. In beide gevallen kunnen gegevens meerdere keren worden ingevoegd vanwege beleid voor opnieuw proberen. Als tijdelijke oplossing kunt u zien of de formules kunnen worden vereenvoudigd of verminderd. Anders kunt u de berekeningsmodus voor deze werkmap instellen op Handmatig. Raadpleeg hier voor meer informatie
  • Schrijftoegang tot een bestand is vereist voor alle acties, anders retourneert 403 Forbidden Graph API een fout. De connector retourneert ook de 502 BadGateway fout als het werkblad zich in de modus Alleen-lezen bevindt. Als u de modus Alleen-lezen wilt uitschakelen, vindt u hier meer informatie.
  • Filter Query / Order By / Select Query bewerkingsparameters ondersteunen alleen alfanumerieke kolomnamen.
  • Draaitabellen worden niet ondersteund vanwege Graph API-beperkingen.
  • Als een gebruiker binnen een korte periode te veel aanvragen indient, is het mogelijk om een 429-antwoord te krijgen. De beperkingslimiet is uniek voor elke aanvraag en varieert op basis van het aantal aanvragen, het gebruikte geheugen en andere belangrijke factoren.
  • In bewerkingen zoals Delete a row, het key column veld is case-sensitive.
  • In het geval van meerdere overeenkomsten in bewerkingen zoals Update a rowbewerkingen, Delete a row wordt alleen de eerste rij bijgewerkt/verwijderd.
  • Wijzigingen die zijn doorgevoerd door bewerkingen zoals Create a row, Update a rowworden Delete a row niet altijd direct na een geslaagde reactie van een bijbehorende Power Automate-, LogicApps- of Power Apps-acties beïnvloed. Vertragingen tot 30 seconden worden verwacht vanwege de beperkingen van de onderliggende back-endservice.
  • De connector kan maximaal 64000 rijen automatisch vullen als Insert auto generated id into Excel table de optie is geselecteerd tijdens een tabelimport in PowerApps.
  • Kolomkoppen in tabellen die slechts een getal bevatten, kunnen onverwacht gedrag veroorzaken in bewerkingen zoals Update a row, Delete a row vanwege onderliggende beperkingen van de back-endservice. Als tijdelijke oplossing wijzigt u de naam van dergelijke kolommen zodat deze ook andere tekens bevatten.
  • Een Excel-bestand kan worden gewijzigd en een nieuwe versie is mogelijk zichtbaar in de versiegeschiedenis van het bestand, zelfs wanneer een actie alleen-lezen wordt uitgevoerd. Dit gedrag is standaard vanwege interne opslagmechanismen van de back-endservice van de connector.
  • Versleuteld of gemarkeerd als beveiligde bladen, genereert een beschadigde bestandsfout, ook al kan het bestand handmatig worden geopend.

Verwerking van kolomnamen

Houd er rekening mee dat kolomnamen in de antwoordresultaten van de actie kunnen worden getransformeerd om compatibel te zijn met de OData-indeling:

Karakter Gecodeerde waarde
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

Column [one]#1 Bijvoorbeeld :>Column [one]_x0023_1

Concepten en voorbeelden

  • Key column: kolom in een tabel die wordt gebruikt om een waarde te doorzoeken (key value)
  • Key value: waarde in de key column waarde die wordt gebruikt om een specifieke rij te identificeren.

Neem de volgende tabel als voorbeeld. Als u een rijbewerking wilt uitvoeren in de tweede rij van de tabel, moet dit key column zijn Column 1 en key value moet het zijn 200.

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

Algemene limieten

Naam Waarde
Maximum aantal identiteitskolomvarianten dat kan worden gebruikt voor het ophalen/invoegen/bijwerken/verwijderen van een rij uit één Excel-tabel. De huidige waarde is ingesteld op 2, wat betekent dat maximaal twee kolomnaamvarianten voor één bepaalde tabel moeten worden gebruikt. 2
Het maximum aantal rijen dat de connector automatisch kan vullen als de optie Automatisch gegenereerde id invoegen in Excel-tabel is geselecteerd tijdens het importeren van een tabel in PowerApps. 64000

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Een rij bijwerken

Een rij bijwerken met behulp van een sleutelkolom. De invoerwaarde overschrijft de opgegeven cellen en kolommen die leeg blijven, worden niet bijgewerkt. Als u een waarde wilt toevoegen (in plaats van overschrijven), gebruikt u de actie 'Een rij ophalen' om eerst de inhoud op te halen.

Een rij ophalen

Haal een rij op met behulp van een sleutelkolom. Met deze actie worden alle waarden van de opgegeven rij opgehaald op basis van een kolom en sleutelkolom.

Een rij toevoegen aan een tabel

Voeg een nieuwe rij toe aan de Excel-tabel.

Een rij toevoegen aan een tabel [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan Een rij toevoegen aan een tabel .

Voeg een nieuwe rij toe aan de Excel-tabel.

Een rij verwijderen

Een rij verwijderen met behulp van een sleutelkolom.

Een sleutelkolom toevoegen aan een tabel

Voeg een sleutelkolom toe aan een Excel-tabel. De nieuwe kolom wordt aan de rechterkant toegevoegd. De nieuwe sleutelkolom moet uniek zijn in de tabel.

Rijen weergeven die aanwezig zijn in een tabel

Rijen weergeven die aanwezig zijn in een tabel.

Tabel maken

Maak een nieuwe tabel in de Excel-werkmap.

Tabellen ophalen

Een lijst met tabellen ophalen in de Excel-werkmap.

Werkblad maken

Maak een nieuw werkblad in de Excel-werkmap.

Werkbladen ophalen

Een lijst met werkbladen ophalen in de Excel-werkmap.

Een rij bijwerken

Een rij bijwerken met behulp van een sleutelkolom. De invoerwaarde overschrijft de opgegeven cellen en kolommen die leeg blijven, worden niet bijgewerkt. Als u een waarde wilt toevoegen (in plaats van overschrijven), gebruikt u de actie 'Een rij ophalen' om eerst de inhoud op te halen.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Table
table True string

Selecteer een tabel in de vervolgkeuzelijst.

Sleutelkolom
idColumn True string

Selecteer een kolom in de vervolgkeuzelijst.

Sleutelwaarde
id True string

Voer de sleutelwaarde in.

Geef de itemeigenschappen op
item True dynamic

Geef de itemeigenschappen op.

Datum/tijd-notatie
dateTimeFormat string

Datum/tijd-indeling.

Retouren

De uitvoer van deze bewerking is dynamisch.

Een rij ophalen

Haal een rij op met behulp van een sleutelkolom. Met deze actie worden alle waarden van de opgegeven rij opgehaald op basis van een kolom en sleutelkolom.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Table
table True string

Selecteer een tabel in de vervolgkeuzelijst.

Sleutelkolom
idColumn True string

Selecteer een kolom in de vervolgkeuzelijst.

Sleutelwaarde
id True string

Voer de sleutelwaarde in.

Datum/tijd-notatie
dateTimeFormat string

Datum/tijd-indeling.

Retouren

De uitvoer van deze bewerking is dynamisch.

Een rij toevoegen aan een tabel

Voeg een nieuwe rij toe aan de Excel-tabel.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Table
table True string

Selecteer een tabel in de vervolgkeuzelijst.

Row
item True dynamic

Rij die moet worden toegevoegd aan de opgegeven Excel-tabel.

Datum/tijd-notatie
dateTimeFormat string

Datum/tijd-indeling.

Retouren

De uitvoer van deze bewerking is dynamisch.

Een rij toevoegen aan een tabel [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan Een rij toevoegen aan een tabel .

Voeg een nieuwe rij toe aan de Excel-tabel.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Table
table True string

Selecteer een tabel in de vervolgkeuzelijst.

Row
item True dynamic

Rij die moet worden ingevoegd in de opgegeven Excel-tabel.

Een rij verwijderen

Een rij verwijderen met behulp van een sleutelkolom.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Table
table True string

Selecteer een tabel in de vervolgkeuzelijst.

Sleutelkolom
idColumn True string

Selecteer een kolom in de vervolgkeuzelijst.

Sleutelwaarde
id True string

Voer de sleutelwaarde in.

Een sleutelkolom toevoegen aan een tabel

Voeg een sleutelkolom toe aan een Excel-tabel. De nieuwe kolom wordt aan de rechterkant toegevoegd. De nieuwe sleutelkolom moet uniek zijn in de tabel.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Table
table True string

Selecteer een tabel in de vervolgkeuzelijst.

Sleutelkolom
idColumn string

Geef de naam van de sleutelkolom op.

Rijen weergeven die aanwezig zijn in een tabel

Rijen weergeven die aanwezig zijn in een tabel.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Table
table True string

Selecteer een tabel in de vervolgkeuzelijst.

Filterquery
$filter string

Een ODATA-filterquery om de geretourneerde vermeldingen te beperken.

Bestellen op
$orderby string

Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen.

Aantal tops
$top integer

Totaal aantal items dat moet worden opgehaald (standaard = alle).

Aantal overslaan
$skip integer

Het aantal items dat moet worden overgeslagen (standaard = 0).

Query selecteren
$select string

Door komma's gescheiden lijst met kolommen die moeten worden opgehaald (standaard eerste 500).

Datum/tijd-notatie
dateTimeFormat string

Datum/tijd-indeling.

Retouren

De uitvoer van deze bewerking is dynamisch.

Tabel maken

Maak een nieuwe tabel in de Excel-werkmap.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Tabelnaam
TableName string

Voer de naam van de Excel-tabel in.

Tabelbereik
Range True string

Voer het tabeladres in met behulp van A1-notatie.

Kolomnamen
ColumnsNames string

Voer de kolomnamen in, gescheiden door ';' of '.

Retouren

Metagegevens van tabel

Tabellen ophalen

Een lijst met tabellen ophalen in de Excel-werkmap.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Retouren

Name Pad Type Description
waarde
value array of object
Identiteitsbewijs
value.id string

Tabel-id.

Naam
value.name string

Tabelnaam.

Gestreepte kolommen weergeven
value.showBandedColumns boolean

Gestreepte kolommen weergeven.

Eerste kolom markeren
value.highlightFirstColumn boolean

Eerste kolom markeren.

Laatste kolom markeren
value.highlightLastColumn boolean

Laatste kolom markeren.

Gestreepte rijen weergeven
value.showBandedRows boolean

Gestreepte rijen weergeven.

Filterknop weergeven
value.showFilterButton boolean

Knop Filter weergeven.

Kopteksten weergeven
value.showHeaders boolean

Kopteksten weergeven.

Totalen weergeven
value.showTotals boolean

Totalen weergeven.

Stijl
value.style string

Tabelstijl.

Werkblad maken

Maak een nieuw werkblad in de Excel-werkmap.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Naam
name string

Werkbladnaam.

Retouren

Werkbladen ophalen

Een lijst met werkbladen ophalen in de Excel-werkmap.

Parameters

Name Sleutel Vereist Type Description
Bestand
file True string

Selecteer een Excel-bestand via Bestand bladeren.

Retouren

Name Pad Type Description
waarde
value array of WorksheetMetadata

Definities

TableMetadata

Metagegevens van tabel

Name Pad Type Description
naam
name string

Tabelnaam

title
title string

Tabeltitel

x-ms-permission
x-ms-permission string

Tabelmachtiging

x-ms-capabilities
x-ms-capabilities TableCapabilitiesMetadata

Metagegevens voor een tabel (mogelijkheden)

schema
schema Object
naar entiteiten waarnaar wordt verwezen
referencedEntities Object
webUrl
webUrl string

Url-koppeling

TableCapabilitiesMetadata

Metagegevens voor een tabel (mogelijkheden)

Name Pad Type Description
sortRestrictions
sortRestrictions TableSortRestrictionsMetadata

Metagegevens voor een tabel (sorteerbeperkingen)

filterRestrictions
filterRestrictions TableFilterRestrictionsMetadata

Metagegevens voor een tabel (filterbeperkingen)

selectRestrictions
selectRestrictions TableSelectRestrictionsMetadata

Metagegevens voor een tabel (beperkingen selecteren)

isOnlyServerPagable
isOnlyServerPagable boolean

Beperkingen voor paging van servers

filterFunctionSupport
filterFunctionSupport array of string

Lijst met ondersteunde filtermogelijkheden

serverPagingOptions
serverPagingOptions array of string

Lijst met ondersteunde servergestuurde pagingmogelijkheden

Object

TableSortRestrictionsMetadata

Metagegevens voor een tabel (sorteerbeperkingen)

Name Pad Type Description
sorteerbaar
sortable boolean

Geeft aan of deze tabel sorteerbare kolommen bevat

unsortableProperties
unsortableProperties array of string

Lijst met niet-gesorteerde eigenschappen

oplopendOnlyProperties
ascendingOnlyProperties array of string

Lijst met eigenschappen die alleen oplopende volgorde ondersteunen

TableFilterRestrictionsMetadata

Metagegevens voor een tabel (filterbeperkingen)

Name Pad Type Description
filteren mogelijk
filterable boolean

Geeft aan of deze tabel filterbare kolommen bevat

nonFilterableProperties
nonFilterableProperties array of string

Lijst met niet-filterbare eigenschappen

requiredProperties
requiredProperties array of string

Lijst met vereiste eigenschappen

TableSelectRestrictionsMetadata

Metagegevens voor een tabel (beperkingen selecteren)

Name Pad Type Description
Selecteerbaar
selectable boolean

Geeft aan of deze tabel selecteerbare kolommen bevat

WorksheetMetadata

Name Pad Type Description
Identiteitsbewijs
id string

Werkblad-id.

Naam
name string

Werkbladnaam.

Position
position integer

Werkbladpositie.

Zichtbaarheid
visibility string

Zichtbaarheid van werkbladen.