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 tableactie. - De
List rows present in a tableactie 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 tableactie 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 tableactie. Rijen voor eerste 500 kolommen worden standaard geretourneerd. U kunt een door komma's gescheiden lijst met specifieke kolommen opgeven om op te halen inSelect Queryde 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 ForbiddenGraph API een fout. De connector retourneert ook de502 BadGatewayfout 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 Querybewerkingsparameters 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, hetkey columnveld iscase-sensitive. - In het geval van meerdere overeenkomsten in bewerkingen zoals
Update a rowbewerkingen,Delete a rowwordt alleen de eerste rij bijgewerkt/verwijderd. - Wijzigingen die zijn doorgevoerd door bewerkingen zoals
Create a row,Update a rowwordenDelete a rowniet 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 tablede 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 rowvanwege 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 dekey columnwaarde 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 .
|
| 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
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
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
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
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
- Body
- TableMetadata
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
- Body
- WorksheetMetadata
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. |