Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As funções definidas pelo utilizador (UDFs) de JavaScript são novas no Serviços do Excel no SharePoint. Este artigo fornece uma visão de alto nível UDFs JavaScript, inclusive informações básicas sobre como eles funcionam no Serviços do Excel.
Observação
Se estiver à procura de informações sobre funções personalizadas javaScript para Suplementos do Office, consulte: Criar funções personalizadas no Excel.
Cite UDFs.
Uma função definida pelo usuário (UDF) é uma função que podem ser criados por você e, em seguida, adicionar à lista de funções disponíveis no Excel quando Excel não oferece o tipo de função que você deseja que direita imediato.
Serviços do Excel already allows you to create UDFs using managed code, so if you have worked with the existing Serviços do Excel UDFs, JavaScript UDFs should look familiar to you. Para obter mais informações sobre a criação de UDFs com código gerido, veja Serviços do Excel User-Defined Functions (Funções do Serviços do Excel User-Defined).
UDFs de JavaScript
UDFs de JavaScript são UDFs que são executados no navegador em uma página da Web que tenha uma pasta de trabalho incorporado Excel. Use o UDF JavaScript dentro da pasta de trabalho incorporada. Enquanto você estiver trabalhando com a pasta de trabalho no navegador, você pode usar JavaScript UDF exatamente como se você usar as funções internas Excel. Quando a página da Web é fechada, o UDF JavaScript não está mais disponível.
Como funcionam os UDFs JavaScript?
Para usar um UDF JavaScript, você precisa ter a capacidade de modificar o conteúdo de página da Web onde você incorporar a pasta de trabalho. Depois que você faz referência o arquivo de origem do JavaScript correto Serviços do Excel, você adicionar seu código JavaScript UDF para a página. Além disso, antes de usar seu UDF JavaScript, primeiro você precisa registrar o UDF com o Serviços de Cálculo do Excel. A API do JavaScript UDF fornece métodos para registrar e cancelar o registro de suas UDF JavaScript.
Quando a página Web com a peça Web excel Web Access ou livro incorporado for composta, pode invocar o UDF de JavaScript no livro, tal como qualquer outro livro do Excel.
Por exemplo, você pode ter uma função que obtém o preço de estoque atual de uma ação específica. Você pode adicionar um JavaScript UDF para a página da Web que hospeda sua Excel pasta de trabalho (supondo que você tem a criação de direitos da página da Web) que usa o código de JavaScript da seguinte maneira.
function StockInfo(symbol, measure) {
var req = new XMLHttpRequest();
req.open('GET', 'http://www.contoso-stock-quotes.com/quote/' + symbol + '/' + measure, false);
req.send(null);
if (req.status == 200) {
return req.responseText;
} else {
throw new Error(ExcelCalcError.Value);
}
ewa.BrowserUdfs.add("StockQuote",
StockInfo,
"Gets a stock quote given a security symbol and measure to return."
false,
false
);
Em seguida, você poderia chamar o UDF JavaScript, StockInfo, em uma fórmula de uma célula dentro de Excel Online.
Figura 1. JavaScript UDF invocado no Excel Online
Onde posso usar JavaScript UDFs?
Pode criar e utilizar UDFs javaScript em livros apresentados em peças Web do SharePoint Excel Web Access ou numa página Web de anfitrião que tenha um livro incorporado. A pasta de trabalho deve ser armazenada em Microsoft OneDrive. A principal diferença é que os UDFs de JavaScript adicionados a peças Web do Excel Web Access necessitam de um servidor SharePoint. UDFs de JavaScript adicionados às páginas da Web de host que tiverem incorporado pastas de trabalho exigir apenas que a pasta de trabalho ser armazenados em OneDrive.
Principais pontos
UDFs de JavaScript live apenas enquanto estiverem em página da Web que está sendo exibida. Eles não persistem além do tempo de vida de página da Web onde eles foram criados.
Você não pode fazer chamadas para o modelo de objeto JavaScript de Serviços do Excel de dentro de um UDF JavaScript.