Partager via

Vue d'ensemble des fonctions définies par l'utilisateur de JavaScript

Les fonctions javaScript définies par l’utilisateur (UDF) sont nouvelles dans Excel Services dans SharePoint. Cet article fournit un aperçu général d'UDF JavaScript, y compris les informations de base sur leur fonctionnement dans Excel Services.

Notes

Si vous recherchez des informations sur les fonctions personnalisées JavaScript pour les compléments Office, consultez : Créer des fonctions personnalisées dans Excel.

Quelles sont les UDF ?

Une fonction définie par l'utilisateur (UDF) est une fonction que vous pouvez créer vous-même et puis ajouter à la liste des fonctions disponibles dans Excel lorsque Excel ne fournit pas le type de fonction que vous souhaitez droite prêts à l'emploi.

Excel Services already allows you to create UDFs using managed code, so if you have worked with the existing Excel Services UDFs, JavaScript UDFs should look familiar to you. For more information about creating UDFs using managed code, see Excel Services User-Defined Functions.

JavaScript UDF

JavaScript UDF sont UDF qui s'exécutent dans le navigateur sur une page Web qui possède un classeur incorporé Excel. Vous utilisez le UDF JavaScript à l'intérieur du classeur incorporé. Dans la mesure où vous travaillez avec le classeur dans le navigateur, vous pouvez utiliser le UDF JavaScript comme vous utilisez les fonctions intégrées Excel. Lorsque la page Web est fermée, le UDF JavaScript n'est plus disponible.

Comment fonctionnent les UDF JavaScript ?

Pour utiliser un fichier UDF JavaScript, vous devez avoir la possibilité de modifier le contenu de la page Web où vous incorporez le classeur. Une fois que vous référencez le fichier source correct Excel Services JavaScript, vous ajoutez votre code JavaScript UDF à la page. En outre, avant d'utiliser votre UDF JavaScript, vous devez d'abord enregistrer le fichier UDF avec le Services de calcul Excel. L'interface API JavaScript UDF fournit des méthodes pour inscrire et désinscrire votre UDF JavaScript.

Lorsque la page web avec le composant WebPart Excel Web Access ou le classeur incorporé s’affiche, vous pouvez appeler la fonction UDF JavaScript dans le classeur comme n’importe quel autre classeur Excel.

Par exemple, vous pouvez avoir une fonction qui obtient le cours d'une action spécifique. Vous pouvez ajouter un JavaScript UDF à la page Web qui héberge votre classeur Excel (en supposant que vous disposez des droits pour la page Web de création) qui utilise le code de JavaScript comme suit.


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
                       );

Vous pouvez ensuite appeler l'UDF JavaScript, StockInfo, dans une formule d'une cellule à l'intérieur de la Excel Online.

La figure 1. UDF JavaScript appelé dans Excel Online

UDF JavaScript appelée dans Excel Online

Où puis-je utiliser des fonctions UDF JavaScript ?

Vous pouvez créer et utiliser des fonctions définies par l’utilisateur JavaScript sur des classeurs affichés dans des composants WebPart SharePoint Excel Web Access ou sur une page web hôte comportant un classeur incorporé. Le classeur doit être stocké sur Microsoft OneDrive. La principale différence est que les fonctions définies par l’utilisateur JavaScript ajoutées aux composants WebPart Excel Web Access nécessitent un serveur SharePoint. UDF JavaScript ajoutés aux pages Web hôte qui contiennent des classeurs nécessite uniquement que le classeur stocké sur OneDrive.

Points essentiels

  • JavaScript UDF live uniquement dans la mesure où la page Web qu'ils se trouvent sur est affichée. Ils ne sont pas conservées au-delà de la durée de vie de la page Web dans laquelle elles ont été créées.

  • Vous ne pouvez pas émettre des appels au modèle objet de JavaScript Excel Services d'un fichier UDF JavaScript.

Voir aussi

  • Last updated on