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 :
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 :
Avant de compiler notre solution, il va falloir signer l’assembly :
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 :
Modifier le code comme suit :

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

SOMMAIRE

1. INTRODUCTION

1.1. Description

1.2. Pré-requis

2. VERIFIER L’EXISTENCE DU WEB SERVICE

3. CREER LA DLL DE PROXY

3.1. Création de la DLL

3.2. Enregistrement dans le GAC

4. EXEMPLE DE PROJET SOUS SSIS