Usar funciones de libro en Excel con Microsoft GraphUse workbook functions in Excel with Microsoft Graph

Puede invocar cualquier función de libro con la sintaxis siguiente: POST /workbook/functions/{function-name}.You can invoke any workbook function by using the following syntax: POST /workbook/functions/{function-name}. Especifique los argumentos de la función en el cuerpo con un objeto JSON.You provide the function argument(s) in the body using a JSON object. Las cadenas value y error resultantes de la función se devuelven en el objeto de resultado de la función.The function's resulting value and any error strings are returned in the function result object. El errorvalor de null indica que la función se ha ejecutado correctamente.The error value of null indicates successful execution of the function.

La lista completa de funciones admitidas se encuentra aquí. Consulte la firma de la función para obtener tipos de datos y nombres de parámetros específicos.The complete list of supported functions are listed here. Refer to the function signature for specific parameter names and data types.

Notas importantes:Important notes:

  • El parámetro de entrada de intervalo se suministra mediante un objeto range en lugar de la cadena de dirección de intervalo.The range input parameter is supplied using a range object instead of the range address string.
  • El parámetro de índice es “1 indexado”, a diferencia del “índice 0” usado en la mayoría de las API.The index parameter is 1-indexed unlike the 0-index used in most of the APIs.

Ejemplo: BUSCARVExample: vlookup

En una hoja de cálculo de Excel, la función vlookup admite estos argumentos:In an Excel spreadsheet, the vlookup function takes the following arguments:

  1. valor_buscado (obligatorio) El valor que quiere buscar.lookup_value (required) The value you want to look up.
  2. matriz_buscar_en (obligatorio) El rango de celdas donde se encuentra el valor de búsqueda.table_array (required) The range of cells where the lookup value is located. Recuerde que el valor de búsqueda siempre tiene que estar en la primera columna del rango para que BUSCARV funcione correctamente.Remember that the lookup value should always be in the first column in the range for VLOOKUP to work correctly. Por ejemplo, si el valor de búsqueda se encuentra en la celda C2, el rango tiene que empezar con C.For example, if your lookup value is in cell C2 then your range should start with C.
  3. indicador_columnas (obligatorio) El número de columna en el rango que contiene el valor devuelto.col_index_num (required) The column number in the range that contains the return value. Por ejemplo, si especifica B2:D11 como el rango, B será la primera columna, C la segunda, etc.For example, if you specify B2: D11 as the range, you should count B as the first column, C as the second, and so on.
  4. búsqueda_en_rango (opcional) El valor lógico que especifica si quiere usar BUSCARV para encontrar una coincidencia exacta o una coincidencia aproximada.range_lookup (optional) The logical value that specifies whether you want VLOOKUP to find an approximate or an exact match. De forma opcional, puede especificar VERDADERO si quiere obtener una coincidencia aproximada, o bien FALSO si quiere obtener una coincidencia exacta del valor devuelto.Specify TRUE if you want an approximate match or FALSE if you want an exact match of the return value. Si no especifica nada, el valor predeterminado será siempre VERDADERO o coincidencia aproximada.If you don't specify anything, the default value will always be TRUE or approximate match.

Dentro de una celda, la función vlookup es similar a esta:Inside a cell, the vlookup function looks like this:

= BUSCARV(valor de búsqueda, rango que contiene el valor de búsqueda, el número de columna en el rango que contiene el valor devuelto, de forma opcional, especifique VERDADERO para obtener una coincidencia aproximada o FALSO para una coincidencia exacta)=VLOOKUP(lookup value, range containing the lookup value, the column number in the range containing the return value, optionally specify TRUE for approximate match or FALSE for an exact match)

(Vea la documentación de la Función de Excel BUSCARV).(See the documentation for the VLOOKUP Excel function.)

Solicitud:Request:

En el ejemplo siguiente, se muestra cómo realizar una llamada a la función vlookup y pasar estos parámetros con la API de REST de Excel.The following example shows how to call the vlookup function and pass these parameters with the Excel REST API.

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

Ejemplo: medianExample: median

En una hoja de cálculo de Excel, la función median admite una matriz de uno o más rangos de entrada.In an Excel spreadsheet, the median function takes an array of one or more input ranges.

Dentro de una celda, la función median es similar a este ejemplo:Inside a cell, the median function looks like this example:

=MEDIANA(A2:A6)=MEDIAN(A2:A6)

(Vea la documentación de la Función de Excel MEDIANA).(See the documentation for the MEDIAN Excel function.)

SolicitudRequest

En el ejemplo siguiente, se muestra cómo realizar una llamada a la función median y uno o más rangos de entrada con la API de REST de Excel.The following example shows how to call the median function and one or more input ranges with the Excel REST API.

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" },
      ]
}
RespuestaResponse
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
}

Vea tambiénSee also