Werkboekfuncties gebruiken in Excel met Microsoft Graph

• 3/9/2021
• 2 minuten om te lezen
• • l
  • k
  • L
  • j
  • O
  • +2

U kunt elke werkboekfunctie oproepen met behulp van de volgende syntaxis: POST /me/drive/root/workbook/functions/{function-name}. U geeft het argument (de argumenten) van de functie op in de body met behulp van een JSON-object. De resulterende value van de functie en eventuele error strings worden geretourneerd in het functie-resultaatobject. De error waarde van null geeft aan dat de functie met succes is uitgevoerd.

De volledige lijst van ondersteunde functies staat hier vermeld. Raadpleeg de functiehandtekening voor specifieke parameternamen en gegevenstypen.

Belangrijke opmerkingen:

• De invoerparameter voor het bereik wordt geleverd met behulp van een bereikobject in plaats van de bereikadresstring.
• De indexparameter is 1-geïndexeerd in tegenstelling tot de 0-index die in de meeste API’s wordt gebruikt.

Voorbeeld: vlookup

In een Excel-spreadsheet neemt de functie vlookup de volgende argumenten:

1. lookup_value (vereist) De waarde die u wilt opzoeken.
2. table_array (vereist) Het bereik van cellen waar de lookup-waarde zich bevindt. Onthoud dat de lookup waarde altijd in de eerste kolom van het bereik moet staan om VLOOKUP correct te laten werken. Bijvoorbeeld, als uw lookup waarde in cel C2 staat dan moet uw bereik beginnen met C.
3. col_index_num (verplicht) Het kolom nummer in het bereik dat de return waarde bevat. Bijvoorbeeld, als u B2: D11 als bereik opgeeft, moet je B als eerste kolom tellen, C als tweede, enzovoort.
4. bereik_lookup (optioneel) De logische waarde die aangeeft of je wilt dat VLOOKUP een benaderende of een exacte overeenkomst vindt. Specificeer TRUE als u een benadering wilt of FALSE als u een exacte overeenkomst wilt. Als je niets specificeert, zal de standaardwaarde altijd TRUE zijn of een benaderende overeenkomst.

In een cel ziet de vlookup functie er als volgt uit:

=VLOOKUP(opzoekwaarde, bereik met de opzoekwaarde, het kolomnummer in het bereik met de retourwaarde, specificeer optioneel TRUE voor een benaderende overeenkomst of FALSE voor een exacte overeenkomst)

(Zie de documentatie voor de VLOOKUP Excel functie.)

Vraag:

Het volgende voorbeeld laat zien hoe u de vlookup functie kunt aanroepen en deze parameters kunt doorgeven met de Excel REST API.

POST https://graph.microsoft.com/beta/me/drive/root:/book1.xlsx:/workbook/functions/vlookupcontent-type: Application/Jsonauthorization: Bearer {access-token}workbook-session-id: {session-id}{ "lookupValue": "Temperature", "tableArray": { "Address": "Sheet1!E1:G5" }, "colIndexNum": 2, "rangeLookup": false}

Respons

HTTP code: 200 OKcontent-type: application/json;odata.metadata{ "@odata.context": "https://graph.microsoft.com/beta/$metadata#workbookFunctionResult", "@odata.type": "#microsoft.graph.workbookFunctionResult", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/root/workbook/functions/vlookup()", "error": null, "value": "28.3"}

Voorbeeld: median

In een Excel-spreadsheet neemt de functie median een array van een of meer invoerbereiken.

In een cel ziet de median functie er als volgt uit:

=MEDIAN(A2:A6)

(Zie de documentatie voor de Excel-functie MEDIAN.)

Vraag

Het volgende voorbeeld laat zien hoe u de median functie en een of meer invoerbereiken kunt oproepen met de Excel REST API.

POST https://graph.microsoft.com/beta/me/drive/root:/book1.xlsx:/workbook/functions/mediancontent-type: Application/Jsonauthorization: Bearer {access-token}workbook-session-id: {session-id}{"values" : }

Respons

HTTP code: 200 OKcontent-type: application/json;odata.metadata{ "@odata.context": "https://graph.microsoft.com/beta/$metadata#workbookFunctionResult", "@odata.type": "#microsoft.graph.workbookFunctionResult", "@odata.id": "/users('2abcad6a-2fca-4b6e-9577-e358a757d77d')/drive/root/workbook/functions/median()", "error": null, "value": 30}

Zie ook

• Sessies beheren in Excel met Microsoft Graph
• Schrijven naar een Excel-werkmap met Microsoft Graph
• De opmaak van een bereik bijwerken in Excel met Microsoft Graph
• Een grafiekafbeelding weergeven in Excel met Microsoft Graph
• De Excel REST API gebruiken