Utilizar funciones del libro de trabajo en Excel con Microsoft Graph

• 3/9/2021
• 2 minutos para leer
• • l
  • k
  • L
  • j
  • O
  • +2

Se puede invocar cualquier función del libro de trabajo utilizando la siguiente sintaxis: POST /me/drive/root/workbook/functions/{function-name}. Proporcionas el argumento o argumentos de la función en el cuerpo utilizando un objeto JSON. Las cadenas resultantes de la función value y cualquier error se devuelven en el objeto resultado de la función. El valor de error de null indica que la función se ha ejecutado con éxito.

La lista completa de funciones admitidas aparece aquí. Consulte la firma de la función para conocer los nombres de los parámetros específicos y los tipos de datos.

Notas importantes:

• El parámetro de entrada de rango se suministra utilizando un objeto de rango en lugar de la cadena de dirección de rango.
• El parámetro de índice tiene un índice 1 a diferencia del índice 0 utilizado en la mayoría de las API.

Ejemplo: vlookup

En una hoja de cálculo de Excel, la función vlookup toma los siguientes argumentos:

1. lookup_value (requerido) El valor que se quiere buscar.
2. table_array (requerido) El rango de celdas donde se encuentra el valor de búsqueda. Recuerde que el valor de búsqueda debe estar siempre en la primera columna del rango para que VLOOKUP funcione correctamente. Por ejemplo, si su valor de búsqueda está en la celda C2, entonces su rango debe comenzar con C.
3. col_index_num (requerido) El número de columna en el rango que contiene el valor de retorno. Por ejemplo, si especifica B2: D11 como rango, debe contar B como la primera columna, C como la segunda, y así sucesivamente.
4. range_lookup (opcional) El valor lógico que especifica si desea que VLOOKUP encuentre una coincidencia aproximada o exacta. Especifique TRUE si desea una coincidencia aproximada o FALSE si desea una coincidencia exacta del valor de retorno. Si no especifica nada, el valor por defecto será siempre TRUE o coincidencia aproximada.

Dentro de una celda, la función vlookup tiene el siguiente aspecto:

=VLOOKUP(valor de búsqueda, rango que contiene el valor de búsqueda, el número de columna en el rango que contiene el valor de retorno, opcionalmente especificar TRUE para una coincidencia aproximada o FALSE para una coincidencia exacta)

(Consulte la documentación de la función VLOOKUP de Excel.)

Solicitud:

El siguiente ejemplo muestra cómo llamar a la función vlookup y pasar estos parámetros con la API REST de 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}

Respuesta

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

Ejemplo: median

En una hoja de cálculo de Excel, la función median toma un array de uno o más rangos de entrada.

Dentro de una celda, la función median se parece a este ejemplo:

=MEDIAN(A2:A6)

(Consulte la documentación de la función MEDIAN de Excel.)

Solicitud

El siguiente ejemplo muestra cómo llamar a la función median y a uno o más rangos de entrada con la API REST de 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" : }

Respuesta

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}

Ver también

• Gestionar sesiones en Excel con Microsoft Graph
• Escribir en un libro de Excel utilizando Microsoft Graph
• Actualizar el formato de un rango en Excel con Microsoft Graph
• Mostrar una imagen de gráfico en Excel con Microsoft Graph
• Utilizar la API REST de Excel

.