Was ist der Windows SharePoint Services-Adapter?

Der BizTalk Server-Adapter für Windows SharePoint Services bietet eine engere Integration in Windows SharePoint Services und Microsoft Office InfoPath. Im folgenden Thema werden die Features beschrieben und eine Übersicht zur Funktionsweise der Windows SharePoint Services-Adapter bereitgestellt.

Features des Windows SharePoint Services-Adapters

In der folgenden Liste sind wichtige Features des Windows SharePoint Services-Adapters beschrieben:

• Die Möglichkeit zum Senden von XML- und binären Nachrichten von BizTalk Server an SharePoint-Dokumentbibilotheken.

• Integration in InfoPath: Sie können ausgehende BizTalk Server XML-Nachrichten so transformieren, dass sie automatisch in InfoPath geöffnet werden, wenn sie von der Windows SharePoint Services-Website geöffnet werden.

• Eigenschaftenheraufstufung für Nachrichten, die in Windows SharePoint Services gelangen. Es können bis zu 16 SharePoint-Spalten mit BizTalk Server-Metadaten zur nachrichtenartigen Orchestrierungsinstanz-ID, Nachrichten-ID oder zu Werten aktualisiert werden, die aus der Nachricht extrahiert wurden.

• Dateinamendefinition, die auf Nachrichteninhalten und BizTalk Server-Eigenschaften basiert.

• Die Möglichkeit, Dokumente an eine beliebige Liste (statt an eine Dokumentbibliothek) zu senden: In diesem Fall wird das Dokument selbst nicht in Windows SharePoint Services aber die Eigenschaftsaufstufung erfolgt weiterhin, sodass ein neues Listenelement erstellt und die Spaltenwerte aus der Nachricht abgerufen werden.

• Die Möglichkeit, Nachrichten aus einer beliebigen Ansicht einer beliebigen Dokumentbibliothek zu empfangen und diese mithilfe des angegebenen Dateinamen in einer bestimmten Dokumentbibliothek zu archivieren.

• Höherstufung von Windows SharePoint Services Adaptereigenschaften in BizTalk Server: Windows SharePoint Services Dateiinformationen werden in BizTalk Server als Nachrichtenkontexteigenschaften zur Verfügung gestellt. Auf die Nachrichtenkontexteigenschaften kann über Pipelines, Orchestrierungen usw. zugegriffen werden. Auf benutzerdefinierte SharePoint-Spalten kann über das Dokument WSS.InPropertiesXml zugegriffen werden.

• Vollständige Unterstützung für dynamische Ports: Sendeadapter können statische URI-Bindung (definiert vom Benutzer beim Erstellen des Sendeports) oder dynamische URI-Bindung (definiert durch die Orchestrierung beim Senden der Nachricht) unterstützen. Alle Konfigurationsinformationen können über Nachrichtenkontexteigenschaften definiert werden, z. B. WSS.Filename und WSS.ConfigTimeout für dynamische Sendeports sowie für physikalische Sendeports.

• Leistungsindikatoren

Funktionsweise des Windows SharePoint Services-Adapters

Der BizTalk Server-Adapter für Windows SharePoint Services besteht aus drei Standard Komponenten:

• Windows SharePoint Services-Adapterwebdienst

• Windows SharePoint Services-Empfangsadapter

• Windows SharePoint Services-Sendeadapter

  Auf dem Windows SharePoint Services-Server wird der Webdienst (BTSharePointAdapterWS.asmx) installiert, um den Zugriff auf die Windows SharePoint Services-Bibliotheken und -Listen bereitzustellen. Der Webdienst stellt Methoden zum Abrufen, Ablegen, Löschen und Archivieren von Dokumenten aus bzw. in einer SharePoint-Bibliothek bereit. Der Empfangsadapter empfängt Dateien vom Webdienst und der Sendeadapter sendet Dateien an ihn.

  Die folgende Abbildung zeigt die Standard Komponenten des BizTalk Server-Adapters für Windows SharePoint Services, die diese Funktionen bereitstellen.

  

Empfangen von Dokumenten von Windows SharePoint Services

Der Empfangsadapter fragt Windows SharePoint Services-Dokumentbibliotheksansichten ab. Er ruft auf dem Windows SharePoint Services-Server eine Webmethode auf, die das Windows SharePoint Services-Objektmodell zum Durchsuchen der Bibliothek, zum Auschecken der Dateien und zum Zurückgeben der Dateidaten an den Adapter verwendet. Der Adapter übermittelt die Dateien dann an die BizTalk Server-MessageBox und ruft eine weitere Webmethode auf, um die Dateien aus Windows SharePoint Services zu löschen oder zu archivieren. Der Adapter ruft die Windows SharePoint Services-Bibliothek über eine Windows SharePoint Services-Ansicht ab, um die Dateien in einer Windows SharePoint Services-Bibliothek zu filtern.

Der zentrale Ansatz (zum Abrufen) bietet ein einfaches Verwaltungsmodell, bei dem die Konfiguration auf dem BizTalk-Server erfolgt. Er bietet auch aufgrund der Tatsache eine bessere Leistung, dass er die Batchverarbeitung von Nachrichten gestattet.

Da die Transaktionsunterstützung auf Plattformebene in Windows SharePoint Services, Webdiensten und BizTalk Server nicht verfügbar ist, wird der Auscheckmechanismus zum Minimieren von Fehlern verwendet, die mit Fehlerbedingungen zusammenhängen. Unter bestimmten Bedingungen (d. h., Dateien werden erfolgreich in die MessageBox-Datenbank von BizTalk Server gesendet, können aber nicht aus Windows SharePoint Services gelöscht werden) bleiben die Dateien auf dem Windows SharePoint Services-Server ausgecheckt, obwohl sie an BizTalk Server übermittelt wurden. Fehler werden im Ereignisprotokoll auf dem BizTalk-Server protokolliert.

Senden von Dokumenten an Windows SharePoint Services

Der Adapter sendet Dokumente an Windows SharePoint Services, indem eine Webmethode auf dem Windows SharePoint Services-Server aufgerufen wird. Der Adapter gibt die URL der Windows SharePoint Services-Site, die Dokumentbibliothek oder die Listen-URL relativ zur Website, die Datei oder Listenelementnamen sowie höher gestufte Eigenschaften an, die der Datei zugeordnet werden.

Sie können für den Dateinamen eine feste Zeichenfolge oder einen Namen festlegen, der aus den XML-Daten im Dokument abgeleitet wird. Das Ableiten des Namens kann sehr hilfreich sein, um Standardbenennungskonventionen durchzusetzen. Der Adapter kann auch höher gestufte Eigenschaftenwerte für die Datei als Spaltenwerte festlegen. Wie die Dateinamen können die höher gestuften Eigenschaftenwerte feststehen oder aus den XML-Daten im Dokument abgeleitet werden.

Wichtig

Höher gestufte Eigenschaften im Windows SharePoint Services-Adapter sind andere Entitäten als höher gestufte Eigenschaften in BizTalk Server oder als höher gestufte Eigenschaften in Windows SharePoint Services.

Höher gestufte Eigenschaften in Windows SharePoint Services werden dazu verwendet, um XML-Elemente beim Durchsuchen einer Windows SharePoint Services-Formularbibliothek sichtbar zu machen. Wenn ein InfoPath-Formular in einer Windows SharePoint Services-Formularbibliothek veröffentlicht wird, konfiguriert InfoPath die Formularbibliothek für das Heraufstufen von Schlüsselelementen, wodurch dies automatisch erfolgt. Dieses Feature ist in Windows SharePoint Services nur verfügbar, wenn InfoPath-Formularbibliotheken verwendet werden (Dokumentbibliotheken, die InfoPath-Formulare mit demselben XSD-Schema und derselben InfoPath-Projektmappe speichern).

Durch das Heraufstufen der Windows SharePoint Services-Adaptereigenschaft kann der Benutzer Eigenschaften in Windows SharePoint Services höher stufen, wenn Dokumente mit verschiedenen Schemas in derselben Dokumentbibliothek gespeichert werden.

Das Heraufstufen von BizTalk Server-Eigenschaften folgt einem ähnlichen Konzept, mit der Ausnahme, dass Eigenschaften für die Orchestrierung als Eigenschaften für die Nachricht und nicht über die Benutzeroberfläche für den Endbenutzer sichtbar gemacht werden. Außerdem unterstützt BizTalk Server ein Konzept der Eigenschaftenherabstufung, wenn die Eigenschaftenwerte wieder im Dokument gespeichert werden.

Wenn Sie den Windows SharePoint Services-Adapter mit InfoPath-Formularen und Formularbibliotheken verwenden (anstelle von frei wählbaren XML- und Dokumentbibliotheken) müssen Sie die höher gestuften Eigenschaften nicht über den Sendeadapter festlegen. Stattdessen kann das Dokument innerhalb der Orchestrierung geändert werden (direkt durch Ändern der Nachricht oder indirekt durch Herabstufen von Eigenschaften). Die Werte werden automatisch von Windows SharePoint Services höher gestuft.

Sicherheitsüberlegungen für den Windows SharePoint Services-Adapter

Der Windows SharePoint Services-Adapter besteht aus Subsystemen, dem auf der Windows SharePoint Services-Site ausgeführten BTSharePointAdapterWS-Webdienst und dem Adapter-Laufzeitmodul, das auf dem BizTalk-Server innerhalb des BizTalk Server-Hostinstanzprozesses ausgeführt wird. Das Adapter-Laufzeitmodul ruft den BTSharePointAdapterWS-Webdienst auf, der über die Berechtigungen zum Ausführen bestimmter Aufgaben innerhalb von Windows SharePoint Services verfügen muss. Da diese Komponente als Aufrufer ausgeführt wird, müssen die Berechtigungen dem Aufrufer erteilt werden. Dies bedeutet, dass der BizTalk-Host instance als Mitwirkender auf der SharePoint-Website festgelegt werden muss, um Nachrichten von dieser Website senden und empfangen zu können. Der BTSharePointAdapterWS-Webdienst kann nur von Mitgliedern der Gruppe SharePoint Enabled Hosts aufgerufen werden. Damit ein BizTalk-Host instance, der die Adapterlaufzeit ausführt, mit dem Webdienst interagieren kann, muss der Host instance Windows-Konto mitglied der Gruppe SharePoint Enabled Hosts werden. Es liegt in der Verantwortung des Administrators, Konten dieser Gruppe hinzuzufügen und daraus zu entfernen sowie den Host instance Konten mitglieder der Rolle SharePoint-Mitwirkender zu machen.

Komponente	Prozessidentität	Berechtigung
BTSharePointAdapterWS-Webdienst	Aufruferidentität	Berechtigung aufrufen, die der Gruppe „SharePoint-aktivierte Hosts“ erteilt wurde
Adapter-Laufzeitmodul	Identität des BizTalk-Hosts	–
Windows SharePoint Services-Objektmodell	–	Die Gruppe SharePoint-aktivierte Hosts muss Mitglied der Rolle Mitwirkender in SharePoint Services sein.

BizTalk Server Setup konfiguriert die Berechtigungen für den BTSharePointAdapterWS-Webdienst, sodass nur die Konten, die Mitglieder der Gruppe SharePoint Enabled Hosts sind, auf diesen Webdienst zugreifen können. Wenn Hosts den Windows SharePoint Services-Adapter ausführen sollen, muss der Administrator die NT-Gruppe, die diesem Host zugeordnet ist, der Gruppe SharePoint-aktivierte Hosts hinzufügen und die Gruppe SharePoint-aktivierte Hosts der Rolle Windows SharePoint Services Mitwirkender hinzufügen.

Die Berechtigungen für die Windows SharePoint Services-Dateien, Listen und Dokumentbibliotheken sind mithilfe der Windows SharePoint Services-Sicherheit eingeschränkt. Die Nachrichten werden von Windows SharePoint Services direkt an BizTalk Server gesendet. Die Kommunikation zwischen dem Adapter-Laufzeitmodul und dem Webdienst erfolgt über HTTP oder HTTPS.

Der Adapter nimmt an, dass der BTSharePointAdapterWS-Webdienst dasselbe HTTP-Schema (HTTP oder HTTPS) wie die Windows SharePoint Services-Website verwendet. Das bedeutet, dass der Adapter HTTPS für die Kommunikation mit dem BTSSharePointAdapterWS-Webdienst verwendet, wenn die Windows SharePoint Services-Website auf einer sicheren IIS-Website erstellt wird. Oder der Adapter verwendet HTTP für die Kommunikation mit dem BTSSharePointAdapterWS-Webdienst, wenn die Windows SharePoint Services-Website auf einer IIS-Website ohne Serverzertifikat erstellt wird.

Weitere Informationen

Einrichten und Bereitstellen des Windows SharePoint Services-Adapters
Konfigurieren des Windows SharePoint Services-Adapters
Windows SharePoint Services-Adapter – Exemplarische Vorgehensweisen