Étape 4: test et appel des fonctions définies par l'utilisateur dans des cellules

Article
09/18/2014

Dernière modification : vendredi 30 mai 2008

S’applique à : SharePoint Server 2010

Dans cette étape, vous allez tester l'assembly SampleUdf.dll créé, déployé et activé dans les étapes précédentes. Pour tester la fonction définie par l'utilisateur, vous allez effectuer les opérations suivantes :

Créer un classeur avec une plage nommée qui appelle les fonctions contenues dans le fichier SampleUdf.dll.
Enregistrer le classeur dans une bibliothèque de documents SharePoint qui soit un emplacement approuvé.

Notes

Cette étape suppose que vous ayez déjà créé une bibliothèque de documents SharePoint qui soit un emplacement approuvé. Pour plus d'informations sur l'approbation d'un emplacement, voir la section relative à l'approbation d'un emplacement dans Étape 3 : déploiement et activation des fonctions définies par l'utilisateur (UDF).
Modifier des paramètres pour recalculer le classeur.

Test des fonctions définies par l'utilisateur

Pour appeler les fonctions définies par l'utilisateur dans des cellules

Démarrez Microsoft Office Excel 2007.
Dans la cellule A1, tapez la formule pour appeler la fonction MyDouble contenue dans le fichier SampleUdf.dll. La fonction MyDouble accepte un argument de type double. Dans cet exemple, vous allez prendre l'argument de la cellule B1. Dans la cellule A1, tapez =MyDouble(B1).

Notes

La formule retourne l'erreur « #NOM? » dans Excel. Elle ne sera évaluée que lorsque le classeur sera affichée dans Excel Services.

Notes

Vous pouvez exécuter des fonctions définies par l'utilisateur sur le client et le serveur. Cette possibilité sera décrite en détail dans un prochain article publié sur MSDN. Elle n'est pas abordée ici pour des questions de simplicité.
Dans la cellule B1, tapez le chiffre 8.
Faites de la cellule B1 une plage nommée. Pour ce faire, cliquez sur l'onglet Formules. Cliquez ensuite sur la cellule B1 pour la sélectionner. Sous l'onglet Formules, dans le groupe Noms définis, cliquez sur Définir un nom. Dans la boîte de dialogue Nouveau nom, tapez MyDoubleParam dans la zone Nom.
Dans la cellule A2, tapez la formule pour appeler la fonction ReturnDateTimeToday. Tapez =ReturnDateTimeToday().
Dans la cellule A3, tapez la formule pour appel la fonction ReturnDateTimeToday. Tapez =ReturnDateTimeToday(). Cliquez ensuite avec le bouton droit sur la cellule A3 pour afficher le menu contextuel. Cliquez sur Format de cellules.
Dans la boîte de dialogue Format de cellules, sélectionnez l'option Date sous l'onglet Nombre. Sélectionnez un type de format de date dans la liste Type (*3/4/2001, par exemple).
Cliquez sur OK.
Enregistrez le classeur à un emplacement de votre choix sur le lecteur local. Attribuez-lui le nom « TestSampleUdf.xlsx ».

Pour effectuer l'enregistrement dans Excel Services

Cliquez sur le bouton Microsoft Office, pointez sur Publier, puis cliquez sur Excel Services.
Dans la boîte de dialogue Enregistrer sous, cliquez sur Options Excel Services.
Dans la boîte de dialogue Options Excel Services, vérifiez que l'option Classeur entier est sélectionnée sous l'onglet Afficher.
Cliquez sur Paramètres.
Dans la liste Ajouter des paramètres, activez la case à cocher MyDoubleParam.
Cliquez sur OK. « MyDoubleParam » doit s'afficher dans la liste Paramètres.
Cliquez sur OK.
Dans la boîte de dialogue Enregistrer sous, vérifiez que la case à cocher Ouvrir dans Excel Services est activée.
Dans la zone Nom du fichier, tapez le chemin d'accès à la bibliothèque de documents SharePoint approuvée dans laquelle vous souhaitez stocker ce classeur (http://MyServer002/Shared%20Documents/TestSampleUdf.xlsx, par exemple).
Cliquez sur Enregistrer. Le fichier TestSampleUdf.xlsx doit s'afficher dans Excel Web Access. La valeur « 72 » doit apparaître dans la cellule A1, car cellule B1 * 9 = 8 * 9, ce qui est égal à 72. La cellule A2 doit également contenir un nombre. La cellule A3, en revanche, doit afficher la date du jour.

Notes

Dans la cellule A2, le nombre correspond au nombre de jours depuis le 1/1/1900 (ou 1/1/1904 si l'option « Utiliser le calendrier depuis 1904 » est activée). Il s'agit de la représentation interne des dates dans Excel.

Pour modifier des paramètres afin de tester les fonctions définies par l'utilisateur

Dans le volet Paramètres, la plage nommée de la cellule B1, c'est-à-dire « MyDoubleParam » doit être affichée.
Vous pouvez modifier la valeur de la cellule B1 en tapant un chiffre dans la zone en regard de « MyDoubleParam ». Par exemple, lorsque vous tapez 3 et que cliquez ensuite sur Appliquer, Excel Services recalcule le classeur. La cellule A1 contient alors la valeur « 27 » à la place de la valeur « 72 ».