Używanie funkcji skoroszytu w programie Excel z Microsoft Graph

• 3/9/2021
• 2 minuty na przeczytanie
• • l
  • k
  • L
  • j
  • O
  • +2

Dowolną funkcję skoroszytu można wywołać za pomocą następującej składni: POST /me/drive/root/workbook/functions/{function-name}. Argumenty funkcji są przekazywane w treści za pomocą obiektu JSON. Wynik działania funkcji value oraz wszelkie error łańcuchy są zwracane w obiekcie wyniku funkcji. Wartość errornull oznacza pomyślne wykonanie funkcji.

Pełna lista obsługiwanych funkcji znajduje się tutaj. Odnieś się do sygnatury funkcji, aby uzyskać konkretne nazwy parametrów i typy danych.

Ważne uwagi:

• Parametr wejściowy zakresu jest dostarczany przy użyciu obiektu zakresu zamiast łańcucha adresu zakresu.
• Parametr indeksu jest indeksowany 1- w przeciwieństwie do indeksu 0 używanego w większości API.

Przykład: vlookup

W arkuszu kalkulacyjnym Excel, funkcja vlookup przyjmuje następujące argumenty:

1. lookup_value (wymagane) Wartość, którą chcesz sprawdzić.
2. table_array (wymagane) Zakres komórek, w których znajduje się wartość lookup. Pamiętaj, że aby funkcja VLOOKUP działała poprawnie, wartość szukana powinna zawsze znajdować się w pierwszej kolumnie zakresu. Na przykład, jeśli wartość odnośnika znajduje się w komórce C2, to zakres powinien zaczynać się od C.
3. col_index_num (wymagane) Numer kolumny w zakresie, która zawiera wartość zwrotną. Na przykład, jeśli określisz B2: D11 jako zakres, powinieneś policzyć B jako pierwszą kolumnę, C jako drugą, i tak dalej.
4. range_lookup (opcjonalne) Wartość logiczna określająca, czy chcesz, aby VLOOKUP znalazł przybliżone czy dokładne dopasowanie. Określ TRUE, jeśli chcesz uzyskać przybliżone dopasowanie lub FALSE, jeśli chcesz uzyskać dokładne dopasowanie wartości zwracanej. Jeśli nic nie określisz, domyślną wartością będzie zawsze TRUE lub dopasowanie przybliżone.

Wewnątrz komórki funkcja vlookup wygląda następująco:

=VLOOKUP(wartość szukana, zakres zawierający wartość szukaną, numer kolumny w zakresie zawierającym wartość zwracaną, opcjonalnie można określić TRUE dla dopasowania przybliżonego lub FALSE dla dopasowania dokładnego)

(Zobacz dokumentację funkcji VLOOKUP w Excelu.)

Wniosek:

Następujący przykład pokazuje, jak wywołać funkcję vlookup i przekazać te parametry za pomocą interfejsu 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}

Odpowiedź

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"}

Przykład: median

W arkuszu kalkulacyjnym Excel, funkcja median przyjmuje tablicę jednego lub więcej zakresów wejściowych.

Wewnątrz komórki funkcja median wygląda jak w tym przykładzie:

=MEDIAN(A2:A6)

(Zobacz dokumentację funkcji MEDIANa w Excelu.)

Wniosek

Następujący przykład pokazuje, jak wywołać funkcję median i jeden lub więcej zakresów wejściowych za pomocą interfejsu 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" : }

Odpowiedź

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}

Zobacz także

• Zarządzaj sesjami w programie Excel za pomocą Microsoft Graph
• Zapisuj do skoroszytu programu Excel za pomocą Microsoft Graph
• Uaktualnij format zakresu w programie Excel za pomocą Microsoft Graph
• Wyświetl obraz wykresu w programie Excel za pomocą Microsoft Graph
• Używaj interfejsu REST API programu Excel