Qu’est-ce que l’adaptateur Windows SharePoint Services ?

L’adaptateur BizTalk Server pour Windows SharePoint Services fournit une intégration plus étroite avec Windows SharePoint Services et Microsoft Office InfoPath. La rubrique suivante décrit les fonctionnalités et une vue d’ensemble du fonctionnement de l’adaptateur Windows SharePoint Services.

Fonctionnalités de l’adaptateur Windows SharePoint Services

La liste suivante décrit les fonctionnalités importantes de l’adaptateur Windows SharePoint Services :

• Possibilité d’envoyer des messages XML et binaires BizTalk Server aux bibliothèques de documents SharePoint.

• Intégration à InfoPath : vous pouvez transformer les messages XML BizTalk Server sortants pour s’ouvrir automatiquement dans InfoPath lors de l’ouverture à partir du site Windows SharePoint Services.

• Promotion des propriétés pour les messages entrant dans Windows SharePoint Services. Jusqu’à 16 colonnes SharePoint peuvent être mises à jour avec des métadonnées de BizTalk Server concernant des éléments tels que l'ID de l'instance d'orchestration, l'ID du message, ou des valeurs extraites du message.

• Définition de nom de fichier basée sur le contenu du message et les propriétés BizTalk Server.

• Possibilité d’envoyer des documents à une liste arbitraire (au lieu d’une bibliothèque de documents) : dans ce cas, le document lui-même n’est pas stocké dans Windows SharePoint Services, mais la promotion des propriétés se produit de sorte qu’un nouvel élément de liste est créé et les valeurs de colonne sont récupérées à partir du message.

• Possibilité de recevoir des messages d’une vue quelconque de n’importe quelle bibliothèque de documents et de les archiver dans une bibliothèque de documents spécifiée à l’aide du nom de fichier spécifié.

• Promotion des propriétés de l’adaptateur Windows SharePoint Services dans BizTalk Server : les informations de fichier Windows SharePoint Services sont disponibles dans BizTalk Server en tant que propriétés de contexte de message. Les propriétés de contexte de message sont accessibles à partir de pipelines, d’orchestrations, etc. Les colonnes SharePoint personnalisées sont accessibles via le document WSS.InPropertiesXml.

• Prise en charge complète des ports dynamiques : les adaptateurs d’envoi peuvent prendre en charge la liaison d’URI statique (définie par l’utilisateur lorsque le port d’envoi est créé) ou la liaison d’URI dynamique (définie par l’orchestration lors de l’envoi du message). Toutes les informations de configuration peuvent être définies via des propriétés de contexte de message, telles que WSS. Nom de fichier et WSS. ConfigTimeout, pour les ports d’envoi dynamiques ainsi que les ports d’envoi physiques.

• Compteurs de performance

Fonctionnement de l’adaptateur Windows SharePoint Services

L’adaptateur BizTalk Server pour Windows SharePoint Services se compose de trois composants principaux :

• Service Web d’adaptateur Windows SharePoint Services

• Adaptateur de réception Windows SharePoint Services

• Adaptateur d’envoi Windows SharePoint Services

  Sur le serveur Windows SharePoint Services, le service Web (BTSharePointAdapterWS.asmx) est installé pour fournir l’accès aux bibliothèques et listes Windows SharePoint Services. Le service Web expose des méthodes pour obtenir, placer, supprimer et archiver des documents à partir d’une bibliothèque SharePoint. L'adaptateur de réception récupère les fichiers du service Web, et l'adaptateur d'envoi les publie vers ce service.

  La figure suivante montre les principaux composants de l’adaptateur BizTalk Server pour Windows SharePoint Services qui fournissent ces fonctionnalités.

  

Réception de documents à partir de Windows SharePoint Services

L’adaptateur de réception interroge les vues de bibliothèques de documents des services Windows SharePoint. Il appelle une méthode Web sur le serveur Windows SharePoint Services qui utilise le modèle objet Windows SharePoint Services pour parcourir la bibliothèque, extraire les fichiers et renvoyer les données de fichier à l’adaptateur. L’adaptateur envoie ensuite les fichiers à BizTalk Server MessageBox et appelle une autre méthode web pour supprimer ou archiver les fichiers de Windows SharePoint Services. Pour filtrer les fichiers dans une bibliothèque Windows SharePoint Services, l’adaptateur interroge la bibliothèque Windows SharePoint Services via une vue Windows SharePoint Services.

L’approche centralisée (interrogation) offre un modèle de gestion simple où la configuration est effectuée sur le serveur BizTalk. Il offre également de meilleures performances en raison du fait qu’il autorise le traitement par lots des messages.

Étant donné que la prise en charge des transactions au niveau de la plateforme n’est pas disponible à travers Windows SharePoint Services, les Services Web et BizTalk Server, le mécanisme d’extraction est utilisé pour réduire les erreurs associées aux situations de panne. Dans certaines conditions (autrement dit, les fichiers sont correctement envoyés dans la base de données BizTalk Server MessageBox, mais ne peuvent pas être supprimés de Windows SharePoint Services), les fichiers restent extraits sur le serveur Windows SharePoint Services même s’ils ont été envoyés à BizTalk Server. Les erreurs sont consignées dans le journal des événements sur le serveur BizTalk.

Envoi de documents à Windows SharePoint Services

L’adaptateur envoie des documents à Windows SharePoint Services en appelant une méthode Web sur le serveur Windows SharePoint Services. L’adaptateur spécifie l’URL du site Windows SharePoint Services, la bibliothèque de documents ou l’URL de liste relative au site, au fichier ou au nom de l’élément de liste et aux propriétés promues à associer au fichier.

Vous pouvez définir le nom de fichier sur une chaîne fixe ou sur un nom dérivé des données XML dans le document. La dérivation du nom peut être très utile pour appliquer des conventions d’affectation de noms standard. L’adaptateur peut également définir des valeurs de propriété promues sur le fichier en tant que valeurs de colonne. Comme pour les noms de fichiers, les valeurs de propriété promues peuvent être fixes ou dérivées des données XML du document.

Important

Les propriétés promues dans l’adaptateur Windows SharePoint Services sont des entités différentes des propriétés promues dans BizTalk Server ou des propriétés promues dans Windows SharePoint Services.

Les propriétés promues de Windows SharePoint Services sont utilisées pour rendre les éléments XML visibles lors de la navigation dans une bibliothèque de formulaires Windows SharePoint Services. Lorsqu’un formulaire InfoPath est publié dans une bibliothèque de formulaires Windows SharePoint Services, InfoPath configure la bibliothèque de formulaires pour promouvoir les éléments clés, ce qui se produit automatiquement. Cette fonctionnalité est disponible dans Windows SharePoint Services uniquement lors de l’utilisation de bibliothèques de formulaires InfoPath (bibliothèques de documents qui stockent les formulaires InfoPath avec le même schéma XSD et la même solution InfoPath).

La promotion des propriétés de l’adaptateur Windows SharePoint Services permet à l’utilisateur de promouvoir des propriétés dans Windows SharePoint Services lorsque des documents avec différents schémas sont stockés dans la même bibliothèque de documents.

La promotion des propriétés BizTalk Server est un concept similaire, mais uniquement dans la mesure où les propriétés sont rendues visibles par l’orchestration en tant que propriétés du message et non à l’utilisateur final sur l’interface utilisateur. En outre, BizTalk Server prend en charge un concept de rétrogradation de propriété lorsque les valeurs de propriété sont enregistrées dans le document.

Lorsque vous utilisez l’adaptateur Windows SharePoint Services avec des formulaires et des bibliothèques de formulaires InfoPath (plutôt que des bibliothèques XML arbitraires et de documents), vous n’avez pas besoin de définir les propriétés promues via l’adaptateur d’envoi. Au lieu de cela, le document peut être modifié dans l’orchestration (directement en modifiant le message ou indirectement par le biais de propriétés qui seront rétrogradées). Les valeurs seront automatiquement promues par Windows SharePoint Services.

Considérations relatives à la sécurité pour l’adaptateur Windows SharePoint Services

L’adaptateur Windows SharePoint Services se compose de sous-systèmes, du service Web BTSharePointAdapterWS qui s’exécute sur le site Web Windows SharePoint Services et du runtime de l’adaptateur qui s’exécute sur le serveur BizTalk au sein du processus d’instance hôte BizTalk Server. Le runtime de l’adaptateur appelle le service Web BTSharePointAdapterWS qui doit disposer des autorisations nécessaires pour effectuer certaines tâches dans Windows SharePoint Services. Étant donné que ce composant s’exécute en tant qu’appelant, les autorisations doivent être accordées à l’appelant. Cela signifie que l'instance hôte BizTalk doit être désignée comme contributeur sur le site SharePoint afin de pouvoir envoyer et recevoir des messages sur ce site. Le service Web BTSharePointAdapterWS ne peut être appelé que par les membres du groupe Hôtes sharePoint activés . Pour autoriser une instance hôte BizTalk, en exécutant le runtime de l’adaptateur, à interagir avec le service Web, le compte Windows de l’instance hôte doit être membre du groupe Hôtes activés pour SharePoint . Il incombe à l’administrateur d’ajouter et de supprimer des comptes de ce groupe, ainsi que de rendre les comptes d’instance hôte membres du rôle Contributeur SharePoint.

Composant	Identité du processus	Autorisation
Le service web BTSharePointAdapterWS	Identité de l’appelant	Appeler l’autorisation accordée au groupe Hôtes activés pour SharePoint
Runtime de l’adaptateur	Identité de l’hôte BizTalk	N/A
Modèle objet Windows SharePoint Services	N/A	Le groupe Hôtes activés pour SharePoint doit être membre du rôle Contributeur dans SharePoint Services.

Le programme d’installation de BizTalk Server configure les autorisations sur le service Web BTSharePointAdapterWS afin que seuls les comptes membres du groupe Hôtes sharePoint activés puissent accéder à ce service web. Si vous souhaitez que les hôtes exécutent l’adaptateur Windows SharePoint Services, l’administrateur doit ajouter le groupe NT associé à cet hôte au groupe Hôtes activés pour SharePoint et ajouter également le groupe Hôtes activés SharePoint au rôle Contributeur Windows SharePoint Services.

Les autorisations accordées aux fichiers, listes et bibliothèques de documents Windows SharePoint Services sont limitées à l’aide de la sécurité de Windows SharePoint Services. Les messages sont envoyés directement à partir de Windows SharePoint Services dans BizTalk Server. La communication entre le runtime de l’adaptateur et le service Web est effectuée via HTTP ou HTTPS.

L’adaptateur suppose que le service Web BTSharePointAdapterWS utilise le même schéma HTTP (HTTP ou HTTPS) que le site Windows SharePoint Services. Cela signifie que l’adaptateur utilise HTTPS pour communiquer avec le service Web BTSSharePointAdapterWS lorsque le site Windows SharePoint Services est créé sur un site web IIS sécurisé, ou utilise HTTP pour communiquer avec le service web BTSharePointAdapterWS lorsque le site Windows SharePoint Services est créé sur un site web IIS sans certificat de serveur.

Voir aussi

Configuration et déploiement de l’adaptateur Windows SharePoint Services
Configuration de l’adaptateur Windows SharePoint Services
Procédures pas à pas de l’adaptateur Windows SharePoint Services