Arbeitsmappenfunktionen in Excel mit Microsoft Graph verwenden

• 3.9.2021
• 2 Minuten zu lesen
• • l
  • k
  • L
  • j
  • O
  • +2

Sie können jede beliebige Arbeitsmappenfunktion mit der folgenden Syntax aufrufen: POST /me/drive/root/workbook/functions/{function-name}. Sie geben das/die Funktionsargument(e) im Body mit einem JSON-Objekt an. Das Ergebnis der Funktion value und eventuelle error-Strings werden im Funktionsergebnisobjekt zurückgegeben. Der error Wert von null zeigt die erfolgreiche Ausführung der Funktion an.

Die vollständige Liste der unterstützten Funktionen ist hier aufgeführt. Spezifische Parameternamen und Datentypen finden Sie in der Funktionssignatur.

Wichtige Hinweise:

• Der Range-Eingangsparameter wird mit einem Range-Objekt anstelle des Range-Adress-Strings übergeben.
• Der Index-Parameter ist 1-indiziert, im Gegensatz zu dem in den meisten APIs verwendeten 0-Index.

Beispiel: vlookup

In einer Excel-Tabelle nimmt die vlookup-Funktion die folgenden Argumente entgegen:

1. lookup_value (erforderlich) Der Wert, den Sie nachschlagen möchten.
2. table_array (erforderlich) Der Bereich der Zellen, in dem sich der Lookup-Wert befindet. Denken Sie daran, dass sich der Nachschlagewert immer in der ersten Spalte des Bereichs befinden sollte, damit VLOOKUP korrekt funktioniert. Wenn sich der Nachschlagewert zum Beispiel in Zelle C2 befindet, sollte der Bereich mit C beginnen.
3. col_index_num (erforderlich) Die Spaltennummer im Bereich, die den Rückgabewert enthält. Wenn Sie zum Beispiel B2: D11 als Bereich angeben, sollten Sie B als erste Spalte zählen, C als zweite und so weiter.
4. range_lookup (optional) Der logische Wert, der angibt, ob VLOOKUP eine ungefähre oder eine genaue Übereinstimmung finden soll. Geben Sie TRUE an, wenn Sie eine ungefähre Übereinstimmung wünschen, oder FALSE, wenn Sie eine exakte Übereinstimmung des Rückgabewerts wünschen. Wenn Sie nichts angeben, ist der Standardwert immer TRUE oder ungefähre Übereinstimmung.

Innerhalb einer Zelle sieht die vlookup-Funktion wie folgt aus:

=VLOOKUP(Nachschlagewert, Bereich mit dem Nachschlagewert, die Spaltennummer im Bereich mit dem Rückgabewert, optional Angabe von TRUE für ungefähre Übereinstimmung oder FALSE für eine exakte Übereinstimmung)

(Siehe die Dokumentation zur Excel-Funktion VLOOKUP.)

Abfrage:

Das folgende Beispiel zeigt, wie Sie die vlookup-Funktion aufrufen und diese Parameter mit der Excel REST API übergeben.

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}

Antwort

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

Beispiel: median

In einer Excel-Tabelle nimmt die Funktion median ein Array mit einem oder mehreren Eingabebereichen entgegen.

Innerhalb einer Zelle sieht die median-Funktion wie dieses Beispiel aus:

=MEDIAN(A2:A6)

(Siehe die Dokumentation zur Excel-Funktion MEDIAN.)

Abfrage

Das folgende Beispiel zeigt, wie Sie die median-Funktion und einen oder mehrere Eingabebereiche mit der Excel REST API aufrufen.

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

Antwort

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}

Siehe auch

• Verwalten von Sitzungen in Excel mit Microsoft Graph
• Schreiben in eine Excel-Arbeitsmappe mit Microsoft Graph
• Das Format eines Bereichs in Excel mit Microsoft Graph aktualisieren
• Ein Diagrammbild in Excel mit Microsoft Graph anzeigen
• Die Excel REST API verwenden