MOSS 2007 : Comment modifier une liste SharePoint via un WebService sous SSIS ?

Tutoriel.

SOMMAIRE

  • 1. INTRODUCTION

     

     
     

  • 2. VERIFIER L’EXISTENCE DU WEB SERVICE
  • 3. CREER LA DLL DE PROXY

     

     
     

  • 4. EXEMPLE DE PROJET SOUS SSIS

  • 1. INTRODUCTION

     

    1.1. Description

     
    Voici une manière rapide de mettre à jour des métadonnées d’éléments d’une liste SharePoint grâce aux web services natifs de l’application. Ces web services seront appelés à partir de Microsoft SQL Server 2005 Integration Services (SSIS).

    1.2. Pré-requis

     
    Les logiciels suivants doivent être installés sur la machine :
     

      • WSS 3.0 et MOSS 2007

     

      • Visual Studio 2005

     

      • SQL Server 2005

     

    2. VERIFIER L’EXISTENCE DU WEB SERVICE

     
    Sous IE, taper l’URL suivante : http://serveur:port/_vti_bin/lists.asmx
     
     » serveur:port  » étant un site SharePoint dans lequel vous souhaitez attaquer les listes.
     
    L’écran suivant devrait s’afficher avec la liste complète des opérations que propose le Web Service :

    3. CREER LA DLL DE PROXY

     
    Une DLL de proxy fournit toutes les classes qui permettent de communiquer avec le Web Service. Il serait possible de développer soi-même ces classes, mais ce serait inutile, car la création de cette DLL est très simple. Elle nous permet de faire abstraction, entre autres, de l’utilisation du protocole SOAP et du formatage des requêtes à envoyer au serveur.
     
    Une DLL de proxy = Un Web Service.
     
    NB : SSIS est capable de communiquer directement avec des Web Services grâce à la  » Web Service Task « . Cependant, le Web Service List.asmx contient des paramètres de type complex qui ne sont pas gérés par SSIS. D’où la création de cette DLL qui sera fournie à SSIS.

    3.1. Création de la DLL

     
    Ouvrir Visual Studio 2005, même une version Express gratuite suffit. Ici nous utiliserons Visual C# 2005 Express Edition.
     
    Ajout d’une référence vers le Web Service :
     

      • Faire Fichier > Nouveau Projet > Class Library

     

      • Donner un nom du genre  » MOSSWebService  » et cliquer sur OK.

     

      • Dans l’explorateur de solution, faites un clic-droit sur  » Références  » et cliquer sur  » Ajouter une référence Web  » :

      • Dans la fenêtre qui apparait, renseigner l’URL du Web Service (la page comme vue précédemment devrait s’afficher en aperçu), et donner un nom à la référence (ici, MOSSWebService_Lists) :

      • Cliquer sur  » Ajouter la référence « .

     

      • NB : A partir de ce moment là, Visual Studio va générer automatiquement tout le code adapté au Web Service en utilisant WSDL.exe (qu’on aurait pu aussi utiliser  » à la main  » directement en ligne de commande).

     

      • Sauvegarder la solution dans un répertoire quelconque.

     
     
    Avant de compiler notre solution, il va falloir signer l’assembly :
     

      • Faire un clic-droit sur le projet (MOSSWebService), et faites  » Propriétés « .

     

      • Cliquer sur l’onglet  » Signature « .

     

      • Cliquer sur  » Signer l’assembly « 

     

      • Dans la liste déroulante en dessous, faire  » <nouveau�> « 

     

      • Une fenêtre surgit, donner un nom au fichier de clé (ici, MOSSWebService_Lists)

     

      • Décocher la case  » Protéger mon fichier par un mot de passe « 

     

      • Faire OK, vous devriez obtenir cet écran :

      • Faites CTRL + S avant de cliquer-droit sur la solution et cliquer sur  » Générer la solution « .

     
     
    La DLL est créée !

    3.2. Enregistrement dans le GAC

  • Copier la DLL, présente dans  » Repertoire_de_la_solution / MOSSWebService / bin / Release / « , vers le répertoire  » C: WINDOWS Microsoft.NET Framework v2.0.xxxxx « .
  • Ouvrir une fenêtre de commandes MSDOS.
  • Aller dans le répertoire  » C:WINDOWSMicrosoft.NETFrameworkv2.0.xxxxx « .
  • Taper  » gacutil –i MOSSWebService.dll  » et faites ENTREE.
  • L’assembly et ajoutée dans le cache et est disponible pour SSIS.
  •  
    NB : Certains diront qu’il suffit de faire un glisser-déposer de la DLL pour la placer dans le GAC. A cela je réponds : « C’est en faisant n’importe quoi qu’on devient n’importe qui » (L.Briand).

    4. EXEMPLE DE PROJET SOUS SSIS

  • Lancer SQL Server Business Intelligence Development Studio, et faire  » Fichier > Nouveau > Projet  » puis sélectionner  » Project Integration Service  » et faire OK.
  • Faire un  » Glisser – déposer  » d’une tâche de script de la boite à outils vers la page Flux de contrôle :
  • Double-cliquer sur la tache de script.
  • Une fenêtre d’édition de la tâche s’ouvre. Cliquer sur  » Script  » à gauche, puis sur le bouton  » Créer un script  » en bas :
  • Une nouvelle fenêtre Visual Studio s’ouvre, avec du code source prédéfini.
  • Dans l’  » explorateur de projet  » (ici à gauche), faire un clic-droit sur  » Références  » et cliquer sur  » Ajouter une référence  » :
  • Choisir la nouvelle DLL fraichement créée (MOSSWebService.dll), faire  » Ajouter  » puis  » OK « .
  • Faire de même pour les deux DLL suivantes :
      • System.XML.dll

     

      • System.Web.Services.dll

     
     

  • Modifier le code comme suit :
      • Ajouter deux lignes d’import :Imports MOSSWebService
        Imports MOSSWebService.MOSSWebService_Lists

     

      • Dans le corps de la fonction Main(), ajouter le code suivant :

     
     

  • Public Sub Main()
            Try
                ’’’ URL du Web Service
                Dim sUrl As String = "http://URL/_vti_bin/lists.asmx"
                ’’’ Objet représentant le Web Service
                Dim oListWS As New Lists
                oListWS.Credentials = System.Net.CredentialCache.DefaultCredentials
                oListWS.Url = sUrl
                ’’’ Génération de la requête CAML de mise à jour de la liste
                Dim xDoc As New System.Xml.XmlDocument
                Dim xBatch As System.Xml.XmlElement = xDoc.CreateElement("Batch")
                xBatch.SetAttribute("OnError", "Return")
                ’’’ Corps de la requête CAML : Cette requête va simplement changer la metadonnée "Title"
                ’’’ de l’item d’identifiant 20.
                Dim sBatch As String = ""
                sBatch += "20"
                sBatch += "Nouveau Titre"
                sBatch += ""
                xBatch.InnerXml = sBatch
                ’’’ Lancement de la fonction de MAJ de la liste "Bibliothèque des sinistres".
                Dim xReturn As System.Xml.XmlNode = oListWS.UpdateListItems("Bibliothèque des sinistres", xBatch)
                ’’’ Affichage de la réponse renvoyée par le serveur.
                Dts.Events.FireInformation(1, "", xReturn.InnerXml, "", 0, False)
                ’’’ La tâche s’est bien passée
                Dts.TaskResult = Dts.Results.Success
            Catch Ex As Exception
                ’’’ La tâche a échoué
                Dts.TaskResult = Dts.Results.Failure
            End Try
    	End Sub
    
  • Faire CTRL + S, et fermer la fenêtre Visual Studio.
  • De retour sur le SSIS, faire F5 pour lancer le package.
  • L’item d’identifiant 20 (s’il existe) aura son titre à  » Nouveau Titre  » (à vérifier sous le site SharePoint).