Utilizar funções de pastas de trabalho em Excel com Microsoft Graph

• 3/9/2021
• 2 minutos para ler
• ul>
• l
• k
• L
• j
• O
• div>+2

P>É possível invocar qualquer função da pasta de trabalho utilizando a seguinte sintaxe: POST /me/drive/root/workbook/functions/{function-name}. Fornece o(s) argumento(s) da função no corpo usando um objecto JSON. O resultado da função value e qualquer error strings são devolvidos no objecto de resultado da função. O error valor de null indica a execução bem sucedida da função.

A lista completa de funções suportadas está listada aqui. Consultar a assinatura da função para nomes de parâmetros e tipos de dados específicos.

Notas importantes:

• O parâmetro de entrada de gama é fornecido utilizando um objecto de gama em vez da cadeia de endereços de gama.
• O parâmetro de índice é indexado a 1 ao contrário do índice 0 utilizado na maioria das APIs.

Exemplo: vlookup

Numa folha de cálculo do Excel, a função vlookup leva os seguintes argumentos:

1. lookup_value (obrigatório) O valor que se pretende pesquisar.
2. table_array (obrigatório) O intervalo de células onde se encontra o valor de pesquisa. Lembre-se que o valor de pesquisa deve estar sempre na primeira coluna do intervalo para que o VLOOKUP funcione correctamente. Por exemplo, se o seu valor de pesquisa estiver na célula C2 então o seu intervalo deve começar com C.
3. col_index_num (obrigatório) O número da coluna no intervalo que contém o valor de retorno. Por exemplo, se especificar B2: D11 como intervalo, deve contar B como primeira coluna, C como segunda, e assim por diante.
4. range_lookup (opcional) O valor lógico que especifica se deseja que VLOOOKUP encontre uma correspondência aproximada ou exacta. Especifique VERDADEIRO se quiser uma correspondência aproximada ou FALSO se quiser uma correspondência exacta do valor de retorno. Se não especificar nada, o valor por defeito será sempre VERDADEIRO ou FALSO se desejar uma correspondência aproximada.

Dentro de uma célula, a função vlookup parece assim:

=VLOOKUP(valor de pesquisa, intervalo contendo o valor de pesquisa, o número da coluna no intervalo contendo o valor de retorno, opcionalmente especificar VERDADEIRO para correspondência aproximada ou FALSO para uma correspondência exacta)

(Veja a documentação para a função VLOOKUP Excel.)

Pedido:

O exemplo seguinte mostra como chamar a função vlookup e passar estes parâmetros com o 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}

Resposta

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

Exemplo: median

Numa folha de cálculo Excel, a função median leva um conjunto de um ou mais intervalos de entrada.

Dentro de uma célula, a função median é semelhante a este exemplo:

=MEDIAN(A2:A6)

(Ver a documentação para a função MEDIAN Excel.)

Requerimento

O exemplo seguinte mostra como chamar a função median e uma ou mais faixas de entrada com o 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" : }

Resposta

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}

Veja também

• Sessões de gestão no Excel com o Microsoft Graph
• Escrever para uma pasta de trabalho do Excel usando o Microsoft Graph
• Atualizar um formato de gama no Excel com o Microsoft Graph
• Exibir uma imagem gráfica no Excel com o Microsoft Graph
• Utilizar o Excel REST API