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

Article
03/21/2023

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é.

Remarque

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 Step 3: Deploying and Enabling UDFs.
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

Start Microsoft Office Excel 2007.
Dans la cellule A1, tapez la formule pour appeler la MyDouble fonction dans SampleUdf.dll. The MyDouble function takes an argument of type double. In this example, you will take the argument from cell B1. In cell A1, type =MyDouble(B1).

Remarque

La formule prend la valeur « #NAME ? » dans Excel. La formule est évaluée uniquement lorsque le classeur est affiché dans Excel Services.

Remarque

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. They are omitted here for the sake of simplicity.
In cell B1, type the number 8.
Faites de la cellule B1 une plage nommée. Tout d’abord, 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 ReturnDateTimeToday fonction. Type=ReturnDateTimeToday().
Dans la cellule A3, tapez la formule pour appeler la ReturnDateTimeToday fonction. Type=ReturnDateTimeToday(). Next, right-click cell A3 to display the menu. Click Format Cells.
In the Format Cells dialog box, on the Number tab, select Date. Sélectionnez un type de format de date dans la liste Type (*3/4/2001, par exemple).
Click OK.
Save the workbook to a location of your choice on the local drive. 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.
Click Parameters.
In the Add Parameters list, select the MyDoubleParam check box.
Click OK. « MyDoubleParam » doit s'afficher dans la liste Paramètres.
Cliquez sur OK.
In the Save As dialog box, make sure that the Open this workbook in my browser after I save check box is selected.
In the File name box, type the path to the trusted SharePoint document library where you want to store this workbook. Par exemple : http://MyServer002/Shared%20Documents/TestSampleUdf.xlsx.
Cliquez sur Enregistrer. You should see TestSampleUdf.xlsx in Excel Web Access. In cell A1, you should see the number "72" because cell B1 * 9 = 8 * 9, which is 72. La cellule A2 doit également contenir un nombre. La cellule A3, en revanche, doit afficher la date du jour.

Remarque

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.
You can change the value in cell B1 by typing a number in the box next to "MyDoubleParam". For example, if you type 3 and then click Apply, Excel Services will recalculate the workbook. Cell A1 will contain "27" instead of "72".