- 3/9/2021
- 2 minuti per leggere
-
-
l -
k -
L -
j -
O -
+2
-
È possibile invocare qualsiasi funzione della cartella di lavoro utilizzando la seguente sintassi: POST /me/drive/root/workbook/functions/{function-name}. Si forniscono gli argomenti della funzione nel corpo usando un oggetto JSON. Il value risultante dalla funzione e qualsiasi error stringa sono restituiti nell’oggetto risultato della funzione. Il valore error di null indica la riuscita dell’esecuzione della funzione.
L’elenco completo delle funzioni supportate è elencato qui. Fate riferimento alla firma della funzione per i nomi dei parametri specifici e i tipi di dati.
Note importanti:
- Il parametro di input range è fornito usando un oggetto range invece della stringa di indirizzo range.
- Il parametro index è indicizzato a 1 a differenza dello 0-index usato nella maggior parte delle API.
Esempio: vlookup
In un foglio Excel, la funzione vlookup prende i seguenti argomenti:
- lookup_value (richiesto) Il valore che volete cercare.
- table_array (richiesto) L’intervallo di celle dove si trova il valore di lookup. Ricorda che il valore di ricerca dovrebbe essere sempre nella prima colonna dell’intervallo perché VLOOKUP funzioni correttamente. Per esempio, se il vostro valore di ricerca è nella cella C2 allora il vostro intervallo dovrebbe iniziare con C.
- col_index_num (richiesto) Il numero di colonna nell’intervallo che contiene il valore di ritorno. Per esempio, se specificate B2: D11 come intervallo, dovreste contare B come prima colonna, C come seconda, e così via.
- range_lookup (opzionale) Il valore logico che specifica se volete che VLOOKUP trovi una corrispondenza approssimativa o esatta. Specificate TRUE se volete una corrispondenza approssimativa o FALSE se volete una corrispondenza esatta del valore di ritorno. Se non specificate nulla, il valore predefinito sarà sempre TRUE o una corrispondenza approssimativa.
In una cella, la funzione vlookup si presenta così:
=VLOOKUP(valore di ricerca, intervallo contenente il valore di ricerca, il numero di colonna nell’intervallo contenente il valore di ritorno, specificare opzionalmente TRUE per una corrispondenza approssimativa o FALSE per una corrispondenza esatta)
(Vedere la documentazione della funzione VLOOKUP Excel.)
Richiesta:
L’esempio seguente mostra come chiamare la funzione vlookup e passare questi parametri con l’API REST di 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}Risposta
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"}Esempio: median
In un foglio di calcolo Excel, la funzione median prende un array di uno o più campi di input.
In una cella, la funzione median si presenta come questo esempio:
=MEDIAN(A2:A6)
(Vedere la documentazione della funzione MEDIAN Excel.)
Richiesta
L’esempio seguente mostra come chiamare la funzione median e uno o più campi di input con l’API REST di 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" : }Risposta
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}Vedi anche
- Gestire sessioni in Excel con Microsoft Graph
- Scrivere in una cartella di lavoro Excel usando Microsoft Graph
- Aggiornare il formato di un intervallo in Excel con Microsoft Graph
- Visualizzare l’immagine di un grafico in Excel con Microsoft Graph
- Utilizzare le API REST di Excel