Freigeben über

Verwenden von Arbeitsmappenfunktionen in Excel

  • Artikel

Sie können die Arbeitsmappenfunktionen in Excel mit Microsoft Graph verwenden, um eine beliebige Arbeitsmappenfunktion mit der folgenden Syntax aufzurufen: POST /me/drive/root/workbook/functions/{function-name}. Sie geben die Funktionsargumente im Text mithilfe eines JSON-Objekts an. Der Ergebniswert value der Funktion sowie alle Zeichenfolgen des Typs error werden im Funktionsergebnisobjekt zurückgegeben. Wird für den Wert errornull zurückgegeben, bedeutet das, dass die Funktion erfolgreich ausgeführt wurde.

Eine vollständige Liste der unterstützten Funktionen finden Sie unter Excel.Functions-Klasse. Die Namen der einzelnen Parameter sowie die Datentypen finden Sie in der Funktionssignatur.

Wichtig

  • Der Eingabebereichsparameter wird über ein Bereichsobjekt definiert, nicht über eine Bereichsadresszeichenfolge.
  • Der Indexparameter startet die Indexierung bei 1; die in den meisten anderen APIs genutzte Indexierung ab 0 wird nicht verwendet.

Beispiel: vlookup

In einer Excel-Tabelle verwendet die vlookup-Funktion die folgenden Argumente an:

  • lookup_value (erforderlich): Der Wert, den Sie suchen möchten.

  • table_array (erforderlich): Der Zellbereich, in dem sich der Nachschlagewert befindet. Denken Sie daran, dass sich der Nachschlagewert immer in der ersten Spalte des Bereichs befindet, damit SVERWEIS ordnungsgemäß funktioniert. Wenn sich der Nachschlagewert beispielsweise in Zelle C2 befindet, sollte der Bereich mit C beginnen.

  • col_index_num (erforderlich): Die Spaltennummer in dem Bereich, der den Rückgabewert enthält. Wenn Sie z. B. B2: D11 als Bereich angeben, sollten Sie B als erste Spalte, C als zweite Spalte usw. zählen.

  • range_lookup (optional): Der logische Wert, der angibt, ob SVERWEIS eine ungefähre oder eine genaue Übereinstimmung finden soll. Setzen Sie den Wert auf TRUE, wenn eine ungefähre Übereinstimmung mit dem Rückgabewert gesucht werden soll, und auf FALSE, wenn eine exakte Übereinstimmung gesucht werden soll. Wenn Sie nichts angeben, ist der Standardwert immer TRUE oder eine ungefähre Übereinstimmung.

Innerhalb einer Zelle sieht die vlookup-Funktion folgendermaßen aus:

=VLOOKUP(Nachschlagewert, Bereich, der den Nachschlagewert enthält, die Spaltennummer in dem Bereich, der den Rückgabewert enthält, geben Sie optional TRUE für die ungefähre Übereinstimmung oder FALSE für eine genaue Übereinstimmung an)

Weitere Informationen finden Sie in der Dokumentation zur SVERWEIS-Excel-Funktion.

Anforderung

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

POST https://graph.microsoft.com/beta/me/drive/root:/book1.xlsx:/workbook/functions/vlookup
content-type: Application/Json
authorization: Bearer {access-token}
workbook-session-id: {session-id}

{
    "lookupValue": "Temperature",
    "tableArray": { "Address": "Sheet1!E1:G5" },
    "colIndexNum": 2,
    "rangeLookup": false
}

Antwort

HTTP code: 200 OK
content-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 verwendet die median-Funktion ein Array eines oder mehrerer Eingabebereiche.

Innerhalb einer Zelle sieht die median-Funktion folgendermaßen aus:

=MEDIAN(A2:A6)

Weitere Informationen finden Sie in der Dokumentation zur MEDIAN Excel-Funktion.

Anforderung

Im folgenden Beispiel sehen Sie, wie Sie mit der Excel-REST-API die Funktion median sowie einen oder mehrere Eingabebereiche aufrufen können.

POST https://graph.microsoft.com/beta/me/drive/root:/book1.xlsx:/workbook/functions/median
content-type: Application/Json
authorization: Bearer {access-token}
workbook-session-id: {session-id}

{
"values" :  [
        { "address": "Sheet2!A1:A5" },
        { "address": "Sheet2!B1:B5" },
      ]
}

Antwort

HTTP code: 200 OK
content-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
}

Verwandte Inhalte