Étape 3 : déploiement et activation des fonctions définies par l'utilisateur (UDF)

Article
09/18/2014

Dernière modification : mercredi 17 mars 2010

S’applique à : SharePoint Server 2010

Dans cet article
Déploiement des fonctions définies par l'utilisateur
Approbation d'un emplacement
Activation des fonctions définies par l'utilisateur

Dans cette étape, vous allez effectuer les tâches suivantes :

Déployer SampleUdf.dll, que vous avez créé dans Étape 2 : création d'une UDF de code managé, dans un dossier sur un ordinateur où Microsoft SharePoint Server 2010 est installé.
Faire en sorte que les fonctions définies par l'utilisateur puissent être appelées à partir d'un emplacement approuvé spécifique, par exemple un emplacement de documents partagés.
Activer SampleUdf.dll.

Déploiement des fonctions définies par l'utilisateur

Pour déployer des fonctions définies par l'utilisateur

Créez un dossier appelé « UDF » sur le lecteur local de l'ordinateur où vous souhaitez déployer les fonctions définies par l'utilisateur, par exemple « C:\UDF ».
Copiez l'assembly SampleUdf.dll.
Enregistrez SampleUdf.dll dans « C:\UDF ».

Approbation d'un emplacement

Pour approuver un emplacement

Dans le menu Démarrer, cliquez sur Tous les programmes.
Pointez sur Produits Microsoft SharePoint 2010 et cliquez sur Administration centrale de SharePoint.
Sous Gestion des applications cliquez sur Gérer les applications de service.
Dans la page Gérer les applications de service, cliquez sur Application Excel Services.
Dans la page Application Excel Services, cliquez sur Emplacements de fichiers approuvés.
Dans la page Emplacements de fichiers approuvés, cliquez sur Ajouter un emplacement de fichier approuvé.
Dans la page Ajouter un emplacement de fichier approuvé, dans la zone Adresse, tapez l’emplacement où vous allez enregistrer votre classeur, par exemple http://MyServer002/Shared%20Documents.
Sous Type d’emplacement, cliquez sur le type d’emplacement approprié. Dans cet exemple, sélectionnez Microsoft SharePoint Foundation.
Sous Approuver les enfants, sélectionnez Enfants approuvés pour approuver des bibliothèques ou des répertoires enfants.
Sous Autoriser les fonctions définies par l'utilisateur, sélectionnez Fonctions définies par l'utilisateur autorisées pour que les fonctions définies par l'utilisateur puissent être appelées à partir des classeurs stockés dans cet emplacement approuvé.
Cliquez sur OK.

Activation des fonctions définies par l'utilisateur

Pour les étapes suivantes, vous devez utiliser un ordinateur où SharePoint Server 2010 est installé.

Pour activer les fonctions définies par l'utilisateur

Suivez les étapes 1 à 3 de la procédure précédente (« Pour approuver un emplacement ») pour afficher la page d'accueil Services Partagés d'un fournisseur de services partagés.
Sous Paramètres Excel Services, cliquez sur Assemblys de fonctions définies par l'utilisateur.
Dans la page Excel Services des fonctions définies par l'utilisateur, cliquez sur Ajouter une fonction définie par l'utilisateur pour ouvrir la page ExcelServices Ajouter un assembly de fonction définie par l'utilisateur.
Dans la zone Assembly, tapez le chemin menant à l'assembly SampleUdf.dll. Dans cet exemple, ce doit être C:\UDFs\SampleUdf.dll.
Sous Emplacement de l'assembly, cliquez sur Chemin d'accès.
Sous Activer l'assembly, la case à cocher Assembly activé doit être activée par défaut.
Cliquez sur OK.

Programmation fiable

Si la valeur de AllowUdfs est false au démarrage d'une session sur un classeur avec des appels à des fonctions définies par l'utilisateur, ces appels échouent.

Notes

L'indicateur AllowUdfs est positionné par l'option Fonctions définies par l'utilisateur autorisées (étape 9 de la section « Approbation d'un emplacement »).

Si vous modifiez la valeur de AllowUdfs pour choisir true après le démarrage d'une session, les appels aux fonctions définies par l'utilisateur échouent également. En effet, les modifications apportées à l'indicateur AllowUdfs entrent en application à la prochaine session. Pour éviter cela, réinitialisez Microsoft Internet Information Services (IIS), ce qui a pour effet de recharger les fonctions définies par l'utilisateur.

Pour plus d'informations sur la réinitialisation des services IIS, voir Comment : activer les UDF.