Guide pratique pour configurer un emplacement de réception Windows SharePoint Services

Cette rubrique explique comment créer et configurer un emplacement de réception Windows SharePoint Services à l’aide de la console d’administration BizTalk Server.

Pour créer et configurer un emplacement de réception Windows SharePoint Services

1. Vérifiez que vous disposez d’un port de réception correctement configuré. Pour plus d’informations sur la création et la configuration d’un port de réception, consultez Comment créer un port de réception.

2. Dans la console Administration de BizTalk Server, développez l’administrationde BizTalk Server, développez le groupe BizTalk [GroupName], développez applications, puis développez l’application dans laquelle vous souhaitez créer un emplacement de réception.

3. Cliquez avec le bouton droit sur Emplacements de réception, cliquez sur Nouveau, puis sur Emplacement de réception unidirectionnel.

4. Sélectionnez le port de réception qui contiendra cet emplacement de réception, puis cliquez sur OK.

5. Dans la boîte de dialogue Propriétés de l’emplacement de réception , sous Transport, dans la zone de liste déroulante Type , sélectionnez Windows SharePoint Services.

6. Cliquez sur Configurer.

7. Dans la boîte de dialogue Propriétés du transport Windows SharePoint Services , procédez comme suit :

   Utiliser cette option	Pour ce faire
   Port de service web d'adaptation	Port HTTP du site Web IIS où le service Web de l’adaptateur Windows SharePoint Services est installé. Par défaut, il s’agit du site web par défaut configuré sur le port 80. Si vous avez configuré le service Web Windows SharePoint Services sur n’importe quel site web IIS autre que le site web par défaut, vous devez mettre à jour cette valeur.
   Délai d'attente	Délai d’attente, en millisecondes, pour les appels de service Web runtime de l’adaptateur effectués au service Web de l’adaptateur Windows SharePoint Services. Vous devrez peut-être augmenter cette valeur si la taille du message ou du lot est supérieure à la moyenne attendue par l’adaptateur.
   Nom de fichier d'archive	(Facultatif) Nom du fichier archivé Windows SharePoint Services. Vous pouvez taper une valeur littérale telle que 'PurchaseOrder0001.xml' ou une expression. Les expressions peuvent inclure n’importe quel mélange de littéraux, de macros et de requêtes XPATH. Par exemple, « PurchOrd-%XPATH=//po :PurchaseOrderId%-%MessageID%.xml». Quand aucun nom de fichier n’est fourni, le nom du fichier source est utilisé. Pour plus d’informations sur les expressions, consultez Expressions d’adaptateur Windows SharePoint Services. Note: Les macros «%SendingOrchestrationID%» et «%SendingOrchestrationType%» ne sont pas prises en charge par ce champ.
   URL de l’emplacement d’archivage	URL du dossier Windows SharePoint Services, relative au site SharePoint, où les fichiers traités sont archivés. Par exemple, Archive ou /Documents partagés/Commandes traitées/. Si aucun emplacement d’archivage n’est spécifié, le document est supprimé après avoir été traité par l’adaptateur. Note: Parfois, la bibliothèque de documents SharePoint ou l’URL du dossier diffère du nom de cet élément. Vérifiez la barre d’adresses dans Internet Explorer pour découvrir l’URL correcte.
   Remplacer l’archive	Détermine si les fichiers existants dans l’archive sont remplacés. Sélectionnez « Oui » pour remplacer les fichiers existants. Sélectionnez « Non » pour que l’archive échoue si un fichier portant le même nom existe déjà dans l’archive. Dans ce cas, le fichier restera extrait et devra être archivé manuellement. Note: Lors de l’archivage des fichiers, nous vous recommandons d’utiliser les valeurs Archive Filename avec des macros pour rendre le nom de fichier unique. À cet effet, vous pouvez utiliser un nom de fichier d’archivage tel que PO-%MessageID%.xml ou PO-%XPATH=//ns0 :PurchaseOrder/ns0 :ID%.xml, où l’ID est l’ID unique de la commande d’achat.
   Taille du lot	Nombre maximal de documents que le service Web de l’adaptateur de messagerie Windows SharePoint Services traite en tant que lot. Un lot traité peut contenir moins de messages que la taille de lot définie ; toutefois, il ne contiendra jamais plus de messages.
   Seuil d’erreur	Nombre maximal d’échecs d’interrogation consécutifs rencontrés par l’adaptateur jusqu’à ce que l’emplacement de réception soit désactivé. Définissez ce champ sur 0 pour ne jamais désactiver l’emplacement de réception.
   Alias pour les espaces de noms	(Facultatif) Liste délimitée par des virgules ou des points-virgules des définitions d’alias d’espace de noms. Utilisez ce champ pour définir les alias d’espace de noms utilisés par les requêtes XPATH introduites dans le champ Archive Filename. Par exemple, po='http://OrderProcess/POrder', conf='http://OrderProcess/Confirmation' ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'
   Intervalle d’interrogation	Intervalle de temps, en secondes, entre deux requêtes consécutives effectuées par l’adaptateur pour voir si de nouveaux messages sont disponibles pour le traitement. Note: La spécification d’une valeur inférieure améliore le débit et le temps de réponse de l’adaptateur.
   SharePoint Site URL	URL complète du site web Windows SharePoint Services. Par exemple, http://BizTalkServer/sites/TestSite. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.
   URL de la bibliothèque de documents source	Il s’agit de l’URL de la bibliothèque de documents Windows SharePoint Services, par rapport au site SharePoint, où les documents sont récupérés. Par exemple, /Shared Documents/ ou /New Purchase Orders/. Note: Vous ne pouvez pas recevoir de messages d’une liste SharePoint. Vous ne pouvez pas recevoir de messages à partir d’un dossier SharePoint, sauf si vous utilisez une vue qui affiche les messages dans tous les dossiers. Pour ce faire, vous définissez la propriété Folders sur la valeur Afficher tous les documents sans dossiers lors de la création d’un affichage. Note: Parfois, la bibliothèque de documents SharePoint est différente du nom de cet élément. Vérifiez la barre d’adresses dans Internet Explorer pour découvrir l’URL correcte.
   Nom de la vue	Il s’agit de la vue Windows SharePoint Services utilisée pour filtrer les documents traités par l’adaptateur. Par exemple, commandes approuvées. Laissez ce champ vide pour traiter tous les documents existants dans la bibliothèque de documents source. Les dossiers affichés dans une vue et les messages contenus dans ces dossiers ne seront pas traités par l’adaptateur. Vous pouvez créer des vues plates qui affichent tous les documents d’une structure plate, y compris les documents existants dans les sous-dossiers. Note: Tous les messages d’une vue plate seront traités.
   Intégration de Microsoft Office	« Facultatif » pour tenter de supprimer les instructions de traitement InfoPath si possible, ou sinon, de les traiter telles quelles (par exemple, un document binaire). Choisissez « Oui » pour supprimer les instructions de traitement InfoPath ou ignorer le message en cas d’erreur. Choisissez « Non » pour traiter le document « tel quel ». Pour les messages binaires, vous devez utiliser les valeurs « Non » ou « Facultatif ».

8. Cliquez sur OK.

Voir aussi

Guide pratique pour configurer un gestionnaire d’envoi Windows SharePoint Services
Guide pratique pour configurer un port d’envoi Windows SharePoint Services
Guide pratique pour créer un port d’envoi
Informations de référence sur les propriétés de l’adaptateur Windows SharePoint Services
Expressions d’adaptateur Windows SharePoint Services
Types de colonnes Windows SharePoint Services pris en charge