Procédure : Créer un type de contenu externe basé sur un service Web

Dernière modification : mercredi 28 juillet 2010

S’applique à : SharePoint Server 2010

Le Concepteur de type de contenu externe dans Microsoft SharePoint Designer 2010 prend en charge la création de types de contenu externe qui se connectent à des services Web. Il vous suffit de découvrir votre service Web, de pointer sur les méthodes Web qui effectueront les opérations souhaitées, puis de renvoyer les données requises et de les utiliser pour créer votre type de contenu externe sans écrire aucun code ou XML.

Dans cette rubrique, vous allez découvrir comment créer un type de contenu externe nommé Customer basé sur les tables Person.Contact, Sales.Customer et Sales.Individual dans l’exemple de base de données AdventureWorks SQL Server 2008.

Conditions préalables requises

• Serveur exécutant Microsoft SQL Server 2008.

• Serveur exécutant Microsoft SharePoint 2010.

• Microsoft SharePoint Designer 2010 installé sur l’ordinateur client.

• L’Exemple de code : Service Web ASP.NET AdventureWorks2008 fourni avec ce kit SDK déployé sur un serveur Web.

Création d’un type de contenu externe basé sur un service Web

SharePoint Designer 2010 nécessite un site SharePoint pour stocker les fichiers et artefacts (tels que les listes externes) qu’il génère lorsque vous utilisez le Concepteur de type de contenu externe pour créer des types de contenu externe. Par conséquent, en guise de première étape, vous devez créer un site SharePoint sur le serveur qui exécute SharePoint Server afin de stocker les artefacts du type de contenu externe et l’ouvrir dans SharePoint Designer sur le client.

Pour définir les paramètres de type de contenu externe généraux

1. Dans SharePoint Designer 2010, ouvrez le site SharePoint où vous souhaitez stocker les artefacts pour le type de contenu externe.

2. Dans le volet de navigation gauche, cliquez sur Types de contenu externe.

3. Dans le Ruban contextuel pour les entités, cliquez sur Type de contenu externe.

   Une nouvelle page Type de contenu externe s’affiche.

4. Cliquez sur le lien Nouveau type de contenu externe en regard du Nom et tapez WSCustomer.

5. Cliquez sur le lien Nouveau type de contenu externe en regard du Nom complet et tapez WSCustomer.

6. Sélectionnez Contact dans la liste déroulante Type d’élément Office. La figure ci-dessous montre les paramètres généraux pour le type de contenu externe.

   

Pour ajouter une connexion au système externe

1. Pour spécifier la source de données pour le type de contenu externe, cliquez sur Cliquez ici pour découvrir les sources de données externes et définir les opérations.

2. Cliquez sur le bouton Ajouter une connexion sous Sources de données externes.

3. Dans la boîte de dialogue Sélection du type de source de données externe, sélectionnez Service WCF comme indiqué ci-dessous et cliquez sur OK.

   

4. Dans la boîte de dialogue Connexion WCF qui s’affiche, entrez l’URL du wsdl du service Web dans le champ URL des métadonnées du service.

5. Ensuite, entrez l’URL de la page asmx dans la zone URL du point de terminaison du service

6. Entrez le nom « AdventureWorksWS ». La figure ci-dessous montre la boîte de dialogue Connexion WCF.

   

7. Conservez les autres paramètres par défaut et cliquez sur OK.

Une fois que vous avez validé la connexion à l’adresse de service Web spécifiée lors des étapes précédentes, le volet Mode de création d’opérations répertorie les méthodes dans la définition de service Web dans la fenêtre Explorateur de source de données, comme illustré ci-dessous.

Pour définir les opérations prises en charge et leurs paramètres et filtres

1. Créez une opération Création.

   1. Cliquez avec le bouton droit sur la méthode CreateCustomer, puis cliquez sur Nouvelle opération de création dans le menu contextuel. L’Assistant Création s’affiche.

   2. Dans l’Assistant Création, cliquez sur Suivant pour conserver les valeurs de nom et de nom complet par défaut pour l’opération.

   3. Cliquez sur le paramètre CustomerID dans la zone de groupe Éléments de la source de données.

   4. Activez la case à cocher Mapper sur l’identificateur dans la zone de groupe Propriétés comme illustré ci-dessous.

      

   5. Cliquez sur Suivant pour continuer à la page Configuration des paramètres de retour.

   6. Cliquez sur le paramètre CustomerID dans la zone de groupe Éléments de source de données.

   7. Activez la case à cocher Mapper sur l’identificateur dans la zone de groupe Propriétés.

   8. Cliquez sur Terminer pour mettre fin à l’opération Création.

2. Créez une opération Élément en lecture.

   1. Cliquez avec le bouton droit sur la méthode GetCustomerById dans l’Explorateur de source de données, puis sélectionnez Nouvelle opération Élément en lecture dans le menu contextuel. Celui-ci affiche tous les stéréotypes d’opérations pris en charge par SharePoint Designer.

      L’Assistant Élément en lecture s’affiche.

   2. Dans l’Assistant Élément en lecture, cliquez sur Suivant pour conserver les valeurs de nom et de nom complet par défaut pour l’opération.

   3. Dans la page Configuration des paramètres d’entrée, remarquez qu’il existe une erreur dans la zone de groupe Messages d’erreur. Vous devez par conséquent identifier le champ d’identificateur pour ce type de contenu externe.

   4. Pour cela, cliquez sur le champ CustomerId dans la zone de groupe Éléments de la source de données et activez la case à cocher Mapper sur l’identificateur dans la zone de groupe Propriétés.

      Le champ d’ID est alors défini comme identificateur de ce type de contenu externe, et pas simplement de ce paramètre. Le message d’erreur disparaît.

   5. Cliquez sur Suivant pour continuer à la page Configuration des paramètres de retour.

   6. Cliquez sur le paramètre CustomerID dans la zone de groupe Éléments de la source de données.

   7. Activez la case à cocher Mapper sur l’identificateur dans la zone de groupe Propriétés. Notez que ce champ est marqué automatiquement en lecture seule.

   8. Ensuite, vous devez mapper les champs tels que LastName et FirstName à des propriétés Outlook. Sélectionnez chaque champ qui peut être mappé à une propriété Outlook comparable et mappez-le en sélectionnant le champ approprié dans le champ de propriété Office.

   9. Cliquez sur Terminer pour mettre fin à l’opération Élément en lecture.

3. Créez une opération Liste en lecture.

   1. Cliquez avec le bouton droit sur la méthode GetCustomers, puis cliquez sur Nouvelle opération Liste en lecture dans le menu contextuel.

      L’Assistant Liste en lecture s’affiche.

   2. Dans l’Assistant Liste en lecture, cliquez sur Suivant pour conserver les valeurs de nom et de nom complet par défaut pour l’opération.

   3. Dans la page Configuration des paramètres d’entrée, cliquez sur Suivant pour continuer à la page Configuration des paramètres de retour.

   4. Cliquez sur le paramètre CustomerID dans la zone de groupe Éléments de la source de données.

   5. Dans le groupe Propriétés, activez la case à cocher Mapper sur l’identificateur.

   6. Sélectionnez le champ Nom et activez la case à cocher Afficher dans le sélecteur pour que le champ LastName soit affiché dans le sélecteur d’élément de données externes. Répétez cette étape pour FirstName.

   7. Cliquez sur Terminer pour mettre fin à l’opération Liste en lecture.

      Une fois que vous avez créé une opération Élément en lecture et une opération Liste en lecture, vous pouvez créer une liste externe à l’aide de ce type de contenu externe.

      À mesure que vous créez des opérations pour le type de contenu externe, celles-ci apparaissent dans la partie Opérations du type de contenu externe en Mode de création d’opérations.

4. Créez une opération Mise à jour.

   1. Cliquez avec le bouton droit sur la méthode UpdateCustomer, puis cliquez sur Nouvelle opération Mise à jour dans le menu contextuel.

   2. Dans l’Assistant Mise à jour, cliquez sur Suivant pour conserver les valeurs de nom et de nom complet par défaut pour l’opération.

   3. Cliquez sur le paramètre CustomerID dans la zone de groupe Éléments de la source de données.

   4. Activez la case à cocher Mapper sur l’identificateur dans la zone de groupe Propriétés.

      Laissez les autres paramètres activés.

   5. Cliquez sur Terminer pour mettre fin à l’opération Mise à jour.

Vous venez de créer les opérations de base pour le type de contenu externe Customer.

Pour enregistrer le type de contenu externe

• Appuyez sur Ctrl+S pour enregistrer le type de contenu externe dans le service BDC pour le site SharePoint.

Vous pouvez maintenant utiliser les fonctionnalités de présentation de Microsoft Business Connectivity Services (BCS) pour afficher les données externes dans Office 2010 et SharePoint 2010. La figure ci-dessous montre une liste externe basée sur le type de contenu externe WSCustomer.