Procédure : déployer des UDF à l'aide de solutions Windows SharePoint Services

Cet exemple montre comment déployer un fichier DLL de fonctions définies par l'utilisateur (UDF) à l'aide de l'infrastructure de solutions Windows SharePoint Services.

L'infrastructure de solutions Windows SharePoint Services vous permet de grouper tous les composants pour étendre Windows SharePoint Services dans un nouveau fichier appeler fichier de solution (un fichier basé sur le format CAB avec une extension .wsp). Une solution est un package déployable et réutilisable qui peut contenir un ensemble de fonctionnalités, de définitions de sites et d'assemblys que vous pouvez appliquer à un site et activer ou désactiver individuellement. Vous pouvez aussi utiliser le fichier de solution pour déployer le contenu d'un package de composants WebPart, comprenant des assemblys, des ressources de classes, des fichiers .dwp et d'autres composants des packages. Pour plus d'informations sur l'infrastructure de solutions Windows SharePoint Services, voir le Kit de développement (Solutions et packages de composants WebPart) (https://msdn2.microsoft.com/en-us/library/ms413687.aspx) de Windows SharePoint Services 3.0.

La procédure de création et de déploiement d'un assembly UDF à l'aide de Windows SharePoint Servicesest la suivante :

1. Créez le fichier manifeste de la solution, Manifest.xml.

   Le manifeste de la solution (toujours appelé Manifest.xml) est stocké à la racine d'un fichier de solution. Ce fichier définit la liste des fonctionnalités, les définitions du site, les ressources du site, les fichiers de composants WebPart et les assemblys à traiter. Il ne définit pas la structure des fichiers ; si des fichiers sont inclus dans une solution mais qu'ils ne figurent pas dans le fichier XML manifeste, ils ne sont pas traités.

   Notes

   Pour plus d'informations sur la structure du fichier XML manifeste, voir la documentation de Windows SharePoint Services 3.0.

2. Créez un package avec l'assembly UDF et le fichier Manifest.xml sous la forme d'un fichier CAB.

3. Vérifiez que le service Administration de Windows SharePoint Services est en cours d'exécution sur le serveur.

4. Ajoutez la solution au serveur à l'aide de stsadm.exe.

5. Déployez la solution à l'aide de stsadm.exe.

Chaque emplacement approuvé d'Services Excel du fournisseur de services partagés a un indicateur AllowUdfs.

Pour permettre aux UDF d'être appelées à partir d'un emplacement approuvé spécifique, vous devez :

• Définir la valeur de AllowUdfs à true. La valeur par défaut est false.

• Ajouter l'assembly UDF à la liste des UDF approuvées pour permettre à l'UDF d'être appelé à partir d'un classeur.

Pour plus d'informations sur l'activation des UDF et sur l'ajout d'UDF à la liste des UDF approuvées, voir Comment : activer les UDF.

Procédure

Pour créer le fichier Manifest.xml

1. Cliquez avec le bouton droit sur votre projet dans l'Explorateur de solutions, pointez sur Ajouter, puis cliquez sur Nouvel élément.

2. Sélectionnez Fichier XML et nommez le fichier Manifest.xml.

3. Cliquez sur Ajouter.

4. Ajoutez le contenu suivant au fichier :

   <?xml version="1.0" encoding="utf-8" ?>
   <Solution xmlns="https://schemas.microsoft.com/sharepoint/" SolutionId="{57568687-2CC0-45bf-B66A-2D50D57108CA}" DeploymentServerType="ApplicationServer">
     <Assemblies>
       <Assembly DeploymentTarget="GlobalAssemblyCache" Location="EcsUdfsCommonSet.dll"/>
     </Assemblies>
   </Solution>
   

   Notes

   Vous devez générer un GUID unique pour chaque solution. Pour plus d'informations sur l'élément Solution, voir le Solutions et packages de composants WebPart (https://msdn2.microsoft.com/en-us/library/ms413687.aspx) de Windows SharePoint Services 3.0.

Pour créer un package de solution

• Pour plus d'informations sur la façon de créer le fichier de solution, voir la rubrique « Création d'une solution » sous le nœud « Solutions et packages de composants WebPart » dans le Kit de développement (SDK) de Windows SharePoint Services 3.0.

Pour vérifier si le service Administration de Windows SharePoint Services s'exécute

1. Cliquez sur Démarrer, pointez sur Outils d'administration, puis double-cliquez sur Services.

   La boîte de dialogue Services s'affiche.

2. Assurez-vous que l'état du service Administration de Windows SharePoint Services affiche Démarré. Dans le cas contraire, cliquez avec le bouton droit sur Administration de Windows SharePoint Services, puis sélectionnez Démarrer.

Pour ajouter la solution

1. Cliquez sur Démarrer, cliquez sur Exécuter, puis tapez cmd.

   La console d'invite de commandes s'affiche.

2. Exécutez le script suivant pour ajouter la solution au serveur SharePoint :

   stsadm.exe -o addsolution -filename <chemin_vers_fichier_CAB>

   Notes

   Vous pouvez trouver l'utilitaire Stsadm.exe à l'emplacement suivant :

   C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\BIN.

   Notes

   Pour plus d'informations sur les options de la commande Stsadm.exe, voir la documentation et le guide destiné au personnel informatique et aux administrateurs (https://technet.microsoft.com/fr-fr/library/cc263143.aspx).

Pour déployer la solution

1. Cliquez sur Démarrer, cliquez sur Exécuter, puis tapez cmd.

   La console d'invite de commandes s'affiche.

2. Exécutez le script suivant pour déployer la solution sur le serveur SharePoint :

   stsadm.exe -o deploysolution -name <nom_fichier_CAB> -immediate -allowGacDeployment

   Vous devez maintenant voir votre fichier DLL d'UDF dans le Global Assembly Cache.

Voir aussi

Autres ressources

Procédure pas à pas : développement d'une UDF avec code managé
Procédure : créer une UDF qui appelle un service Web
Forum Aux Questions sur les UDF Excel Services
Présentation des fonctions définies par l'utilisateur Excel Services
Comment : activer les UDF
Procédure : restreindre les autorisations de sécurité d'accès du code UDF