- 3/9/2021
- 2 minutes de lecture
-
-
l -
k -
L -
j -
O -
+2
.
-
Vous pouvez invoquer n’importe quelle fonction du classeur en utilisant la syntaxe suivante : POST /me/drive/root/workbook/functions/{function-name}. Vous fournissez le ou les arguments de la fonction dans le corps en utilisant un objet JSON. Le value résultant de la fonction et toute error chaîne de caractères sont retournés dans l’objet de résultat de la fonction. La valeur error de null indique une exécution réussie de la fonction.
La liste complète des fonctions prises en charge est répertoriée ici. Reportez-vous à la signature de la fonction pour les noms de paramètres et les types de données spécifiques.
Notes importantes :
- Le paramètre d’entrée range est fourni en utilisant un objet range au lieu de la chaîne d’adresse range.
- Le paramètre index est indexé 1 contrairement à l’index 0 utilisé dans la plupart des API.
Exemple : vlookup
Dans une feuille de calcul Excel, la fonction vlookup prend les arguments suivants :
- valeur à consulter (obligatoire) La valeur que vous voulez consulter.
- table_array (obligatoire) La plage de cellules où se trouve la valeur à consulter. N’oubliez pas que la valeur de consultation doit toujours se trouver dans la première colonne de la plage pour que VLOOKUP fonctionne correctement. Par exemple, si votre valeur de consultation se trouve dans la cellule C2, alors votre plage doit commencer par C.
- col_index_num (obligatoire) Le numéro de la colonne dans la plage qui contient la valeur de retour. Par exemple, si vous spécifiez B2 : D11 comme plage, vous devez compter B comme première colonne, C comme deuxième, et ainsi de suite.
- plage_lookup (facultatif) La valeur logique qui spécifie si vous voulez que VLOOKUP trouve une correspondance approximative ou exacte. Spécifiez TRUE si vous voulez une correspondance approximative ou FALSE si vous voulez une correspondance exacte de la valeur de retour. Si vous ne spécifiez rien, la valeur par défaut sera toujours TRUE ou correspondance approximative.
Dans une cellule, la fonction vlookup ressemble à ceci :
=VLOOKUP(valeur de consultation, plage contenant la valeur de consultation, le numéro de colonne dans la plage contenant la valeur de retour, spécifier éventuellement TRUE pour une correspondance approximative ou FALSE pour une correspondance exacte)
(Voir la documentation de la fonction Excel VLOOKUP.)
Requête:
L’exemple suivant montre comment appeler la fonction vlookup et passer ces paramètres avec l’API REST Excel.
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}Réponse
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"}Exemple : median
Dans une feuille de calcul Excel, la fonction median prend un tableau d’une ou plusieurs plages de saisie.
Dans une cellule, la fonction median se présente comme cet exemple :
=MEDIAN(A2:A6)
(Voir la documentation de la fonction Excel MEDIAN.)
Requête
L’exemple suivant montre comment appeler la fonction median et une ou plusieurs plages d’entrée avec l’API REST Excel.
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" : }Réponse
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}Voir aussi
- Gérer les sessions dans Excel avec Microsoft Graph
- Écrire dans un classeur Excel. en utilisant Microsoft Graph
- Mettre à jour le format d’une plage dans Excel avec Microsoft Graph
- Afficher une image de graphique dans Excel avec Microsoft Graph
- Utiliser l’API REST d’Excel
.