Partager via

Procédure pas à pas : Module 1 - Envoi et réception de messages à l’aide de l’adaptateur Windows SharePoint Services

  • Article

Cette procédure pas à pas vous montre comment configurer Windows SharePoint Services et BizTalk Server afin de pouvoir envoyer et recevoir un message à l’aide de l’adaptateur de Windows SharePoint Services et du routage basé sur le contenu (CBR). Ce dernier dispense de l'inscription aux messages pour les messages liés à des ports spécifiques. Il offre également plus de souplesse aux utilisateurs souhaitant acheminer des messages en se basant sur les propriétés d'enveloppe ou simplement sur les propriétés de configuration des ports de réception. Pour une présentation de l’adaptateur Windows SharePoint Services, consultez Qu’est-ce que l’adaptateur Windows SharePoint Services ?.

Prérequis

La configuration suivante est requise pour exécuter les procédures décrites dans cette rubrique :

  • Vous devez disposer d’un déploiement à serveur unique avec une installation complète de BizTalk Server s’exécutant sur Windows Server 2008 SP2 ou Windows Server 2008 R2.

    Pour plus d’informations sur l’utilisation de l’adaptateur Windows SharePoint Services dans un déploiement multiserveur, consultez Configuration et déploiement de l’adaptateur Windows SharePoint Services.

Configurer Windows SharePoint Services

Cette procédure permet de créer un site Web de niveau supérieur SharePoint contenant trois bibliothèques de documents. L'adaptateur Windows SharePoint Services utilise ces bibliothèques pour déplacer un message d'une bibliothèque source vers une bibliothèque de destination. Ce message est également archivé dans une bibliothèque de documents. Cette procédure permet de créer le site Windows Sharepoint Services auquel accède l'adaptateur Windows Sharepoint Services au cours de cette procédure pas à pas, ainsi que de définir les droits d'accès des utilisateurs à celui-ci.

Pour créer un site Windows SharePoint Services

  1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Outils d’administration, puis cliquez sur Administration centrale de SharePoint.

  2. Sous Configuration du serveur virtuel, cliquez sur Créer un site web de niveau supérieur.

  3. Sous Liste des serveurs virtuels, sélectionnez le site web sur lequel vous avez installé l’adaptateur Windows SharePoint Services. Par exemple : Default Web Site.

  4. Dans la section Adresse du site web, dans le champ Nom de l’URL, tapez WSSAdapterWalkthrough.

  5. Dans la section Propriétaire de la collection de sites, dans le champ Nom d’utilisateur, tapez un nom d’utilisateur. Cet utilisateur sera le propriétaire du site web et n’a pas besoin d’autorisations spéciales dans BizTalk Server.

  6. Dans la section Propriétaire de la collection de sites, dans le champ Courrier électronique , tapez une adresse de messagerie.

  7. Cliquez sur OK.

  8. Dans la page Site de niveau supérieur créé avec succès , cliquez sur le nouveau site Web de niveau supérieur que vous venez de créer. Par exemple : http://<server_name>/sites/WSSAdapterWalkthrough.

  9. Sélectionnez le modèle Site d’équipe dans la liste des modèles, puis cliquez sur OK. La page d'accueil du site Web d'équipe s'affiche.

Pour créer une bibliothèque de documents « sources »

  1. Dans la page d’accueil du site web d’équipe, dans la barre de navigation supérieure, cliquez sur Créer.

  2. Sous Bibliothèques de documents, cliquez sur Bibliothèque de documents.

  3. Dans la section Nom et Description , dans le champ Nom, tapez Source.

  4. Dans la section Navigation , sélectionnez Oui pour afficher cette bibliothèque de formulaires dans la barre de lancement rapide.

  5. Dans la section Modèle de document , dans la liste déroulante Modèle de document, sélectionnez None.

  6. Cliquez sur Créer. La bibliothèque de documents est créée et vous êtes redirigé vers la bibliothèque vide.

Pour créer une bibliothèque de documents de « destination »

  1. Dans la page d’accueil du site web d’équipe, dans la barre de navigation supérieure, cliquez sur Créer.

  2. Sous Bibliothèques de documents, cliquez sur Bibliothèque de documents.

  3. Dans la section Nom et Description , dans le champ Nom, tapez Destination.

  4. Dans la section Navigation , sélectionnez Oui pour afficher cette bibliothèque de formulaires dans la barre de lancement rapide.

  5. Dans la section Modèle de document , dans la liste déroulante Modèle de document, sélectionnez None.

  6. Cliquez sur Créer. La bibliothèque de documents est créée et vous êtes redirigé vers la bibliothèque vide.

Pour créer une bibliothèque de documents « d'archive »

  1. Dans la page d’accueil du site web d’équipe, dans la barre de navigation supérieure, cliquez sur Créer.

  2. Sous Bibliothèques de documents, cliquez sur Bibliothèque de documents.

  3. Dans la section Nom et Description, dans le champ Nom, tapez Archive.

  4. Dans la section Navigation , sélectionnez Oui pour afficher cette bibliothèque de formulaires dans la barre de lancement rapide.

  5. Dans la section Modèle de document , dans la liste déroulante Modèle de document, sélectionnez None.

  6. Cliquez sur Créer. La bibliothèque de documents est créée et vous êtes redirigé vers la bibliothèque vide.

  7. Fermez le WSSAdapterWalkthrough site Web.

  8. Fermez le site Web De l’Administration centrale de SharePoint .

Configurer la sécurité Windows

  1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Outils d’administration, puis cliquez sur Gestion de l’ordinateur.

  2. Dans l’arborescence de la console, développez Utilisateurs et groupes locaux, puis cliquez sur Groupes.

  3. Cliquez avec le bouton droit sur le groupe Hôtes avec SharePoint , cliquez sur Ajouter au groupe, puis sur Ajouter.

  4. Dans la boîte de dialogue Sélectionner des utilisateurs, des ordinateurs ou des groupes, sous Entrez les noms d’objets à sélectionner, tapez le nom du compte sous lequel vous avez configuré l’BizTalk Server’instance d’hôte à exécuter, puis cliquez sur OK.

  5. Dans l’arborescence de la console, développez Services et applications, puis cliquez sur Services.

  6. Cliquez avec le bouton droit sur BizTalk Service BizTalk Group : <BizTalk_Host_Name>, puis cliquez sur Redémarrer.

    Notes

    <> BizTalk_Host_Name est le nom de votre hôte. Par défaut, il s’agit de BizTalkServerApplication.

    Notes

    L'adhésion ne prend pas effet tant que le service n'a pas été redémarré.

  7. Fermez Gestion de l’ordinateur.

Pour configurer la sécurité de SharePoint

  1. Ouvrez un navigateur Web, puis accédez à l'URL du site que vous avez créé Par exemple : http://<server_name>/sites/WSSAdapterWalkthrough.

  2. Dans la page d’accueil du site web d’équipe, dans la barre de navigation supérieure, cliquez sur Paramètres du site.

  3. Sous Administration, cliquez sur Gérer les utilisateurs.

  4. Cliquez sur Add Users.

  5. À l’étape 1 : Choisissez Utilisateurs, tapez le nom du compte sous lequel s’exécute l’instance hôte BizTalk Server.

  6. À l’étape 2 : Choisissez Groupes de sites, sélectionnez les zones Lecteur et Contributeur case activée.

  7. Cliquez sur Suivant.

  8. Désactivez la zone Envoyer l’e-mail suivant pour permettre à ces utilisateurs d’être ajoutés case activée, puis cliquez sur Terminer.

  9. Fermez le WSSAdapterWalkthrough site Web.

Pour créer et configurer les ports BizTalk Server

Dans cette procédure, vous allez créer et configurer les BizTalk Server ports de réception, les emplacements de réception et les ports d’envoi pour l’adaptateur Windows SharePoint Services. Ces ports sont des points d’entrée et de sortie de BizTalk Server pour les documents reçus et envoyés par l’adaptateur Windows Sharepoint Services.

Créer le port de réception

  1. Cliquez sur Démarrer, Tous les programmes, Microsoft BizTalk Server 20xx, puis sur Administration BizTalk Server.

  2. Développez BizTalk Server Administration, BizTalk Group, Applications, BizTalk Application 1, cliquez avec le bouton droit sur Ports de réception, cliquez sur Nouveau, puis cliquez sur Port de réception unidirectionnel...

  3. Dans la boîte de dialogue Propriétés du port de réception, sous Général, tapez FromSource le champ Nom .

  4. Cliquez sur OK.

Pour créer un emplacement de réception

  1. Dans la console d’administration BizTalk, cliquez avec le bouton droit sur le nœud Emplacements de réception , cliquez sur Nouveau, puis sur Emplacement de réception unidirectionnel.

  2. Dans la boîte de dialogue Sélectionner un port de réception , sélectionnez FromSource, puis cliquez sur OK.

  3. Dans la boîte de dialogue Propriétés de l’emplacement de réception, sous Général, tapez SourceLocation le champ Nom .

  4. Dans la section Transport , dans la liste déroulante Type , sélectionnez Windows``SharePoint``Services.

  5. Cliquez sur Configurer pour configurer les propriétés de l’adaptateur Windows SharePoint Services.

  6. Dans la propriété Port du service web de l’adaptateur, tapez le numéro de port du serveur virtuel sur lequel le service Web de l’adaptateur Windows SharePoint Services a été installé. Par défaut, il s’agit du port 80.

  7. Tapez Archive la propriété Emplacement d’archivage .

  8. Tapez 10 la propriété Interval d’interrogation .

  9. Tapez l’URL de votre site SharePoint dans la propriété Url du site oint ShareP. Par exemple : http://<server_name>/sites/WSSAdapterWalkthrough.

  10. Tapez Source pour la propriété Bibliothèque de documents sources .

  11. Cliquez sur OK.

  12. Dans la boîte de dialogue Propriétés de l’emplacement de réception, sélectionnez BizTalkServerApplication comme gestionnaire de réception.

  13. Dans la liste déroulante Pipeline de réception, sélectionnez PassThruReceive.

  14. Cliquez sur OK.

Pour créer un port d'envoi

  1. Dans la console d’administration BizTalk, cliquez avec le bouton droit sur le nœud Ports d’envoi , cliquez sur Nouveau, puis sur Port d’envoi unidirectionnel statique.

  2. Dans la boîte de dialogue Propriétés du port d’envoi, sous Général, tapez SendToDestination dans le champ Nom .

  3. Dans la section Transport , sélectionnez Windows SharePoint Services le type.

  4. Cliquez sur Configurer pour configurer les propriétés de l’adaptateur Windows SharePoint Services.

  5. Dans la propriété Port du service web de l’adaptateur, tapez le numéro de port du serveur virtuel sur lequel le service Web de l’adaptateur Windows SharePoint Services a été installé. Par défaut, il s’agit du port 80.

  6. Tapez pour Destination la propriété Dossier de destination .

  7. Tapez pour PurchaseOrder1-%MessageID%.xml la propriété Filename .

  8. Définissez la propriété Overwrite sur Yes.

  9. Tapez l’URL de votre site SharePoint dans la propriété Url du site SharePoint . Par exemple : http://<server_name>/sites/WSSAdapterWalkthrough.

  10. Définissez la propriété Microsoft Office Integration sur No.

  11. Cliquez sur OK.

  12. Dans la boîte de dialogue Propriétés du port d’envoi, dans la liste déroulante Gestionnaire d’envoi, sélectionnez BizTalkServerApplication.

  13. Dans la liste déroulante Envoyer le pipeline , sélectionnez PassThruTransmit.

  14. Cliquez sur l’onglet Filtres .

  15. Sélectionnez WSS.InListName dans le champ Propriété .

  16. Sélectionnez == dans le champ Opérateur .

  17. Tapez Source dans le champ Valeur .

  18. Cliquez sur OK.

Pour activer et démarrer l'emplacement et le port de réception

Ces procédures permettent d'activer l'emplacement de réception et de démarrer le port de réception. Vous devez mener à bien cette procédure afin de permettre à l'adaptateur Windows Sharepoint Services d'envoyer et de recevoir des messages via le port d'envoi et l'emplacement de réception spécifiés.

Pour activer l'emplacement de réception

  1. Dans la console d’administration BizTalk, cliquez sur le nœud Emplacements de réception .

  2. Cliquez avec le bouton droit sur SourceLocation, puis cliquez sur Activer.

Pour démarrer le port d'envoi

  1. Dans la console d’administration BizTalk, cliquez sur le nœud Ports d’envoi .

  2. Cliquez avec le bouton droit sur SendToDestination, puis cliquez sur Démarrer.

  3. Fermez la console d’administration BizTalk.

Pour envoyer un message via le système

Cette procédure permet de créer un document XML et de le télécharger sur le site Web Windows SharePoint Services. L'adaptateur Windows SharePoint Services prend ce message, l'archive dans la bibliothèque de documents d'archive, puis l'envoie dans la bibliothèque de documents de destination. Cette procédure montre comment un document circule à partir d’un site web Sharepoint, via BizTalk Server et vers un site Web Sharepoint Services à l’aide de l’adaptateur Windows Sharepoint Services.

Créer un répertoire de travail

  • Créez un répertoire sur votre ordinateur appelé WSSAdapterWalkthrough. Par exemple : C:\WSSAdapterWalkthrough.

Créer un fichier XML

  1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Accessoires, puis cliquez sur Bloc-notes.

  2. Tapez la commande suivante :

    <?xml version="1.0"?>  
<PurchaseOrder>  
    <ID>1001</ID>  
    <FirstName>John</FirstName>  
    <LastName>Doe</LastName>  
    <Amount>750</Amount>  
</PurchaseOrder>

  3. Enregistrez le fichier dans votre répertoire de travail en tant que PurchaseOrder1.xml. Par exemple : C:\WSSAdapterWalkthrough\PurchaseOrder1.xml.

Pour télécharger le fichier XML

  1. Ouvrez un navigateur Web, puis accédez à l'URL du site que vous avez créé lors de la tâche précédente Par exemple : http://<server_name>/sites/WSSAdapterWalkthrough.

  2. Sur le côté gauche, sous Documents, cliquez sur Source.

  3. Cliquez sur Charger le document.

  4. Dans la zone Nom , tapez ou accédez au fichier XML que vous avez créé ci-dessus. Par exemple, C:\WSSAdapterWalkthrough\PurchaseOrder1.xml, puis cliquez sur Enregistrer et fermer. Le fichier doit s'afficher dans la liste.

  5. Actualisez la fenêtre du navigateur. Le PurchaseOrder1.xml fichier ne sera plus répertorié dans cette bibliothèque.

    Notes

    Comme la fréquence d'interrogation est définie sur 10 secondes, il peut être nécessaire d'actualiser plusieurs fois le navigateur.

  6. Dans la barre de navigation supérieure, cliquez sur Documents et listes.

  7. Sous Bibliothèques de documents, cliquez sur Destination.

  8. Dans la bibliothèque de documents de destination, vous voyez maintenant votre message répertorié. Vous trouverez également une copie archivée dans la bibliothèque de documents d'archive.

    Notes

    Si le message n’apparaît pas dans la bibliothèque de documents de destination, reportez-vous à « Résolution des problèmes de l’adaptateur Windows SharePoint Services » dans BizTalk Server aide.

Résumé

Dans cette procédure pas à pas, vous avez vu comment configurer Windows SharePoint Services et BizTalk Server afin de pouvoir envoyer et recevoir un message à l’aide de l’adaptateur de Windows SharePoint Services et du routage basé sur le contenu (CBR).

Étapes suivantes

Maintenant que vous avez terminé cette procédure pas à pas, effectuez la procédure pas à pas : Module 2 - Intégration d’Office à l’adaptateur Windows SharePoint Services, qui développe le travail que vous avez effectué avec cette procédure pas à pas et vous montre comment intégrer Office à l’adaptateur Windows SharePoint Services.

Voir aussi

Présentation de l’adaptateur Windows SharePoint Services
Procédures pas à pas relatives à l’adaptateur Windows SharePoint Services