Konfigurieren des SharePoint Services-Sendeports

In diesem Thema wird ein statischer Sendeport mit einem dynamischen Sendeport verglichen. Außerdem werden die Schritte zum Erstellen eines Windows SharePoint Services Sendeports aufgelistet. Dies gilt insbesondere in folgenden Fällen:

Statische Sendeports im Vergleich zu dynamischen Sendeports

Erstellen eines statischen Sendeports

Erstellen eines dynamischen Sendeports

Statische Sendeports im Vergleich zu dynamischen Sendeports

	Statischer Sendeport	Dynamischer Sendeport
Verwenden eines einzelnen Sendeports mit verschiedenen Adaptern.	No Beim Erstellen eines statischen Sendeports ist der Transporttyp erforderlich.	Yes Ein dynamischer Sendeport wird normalerweise einer Orchestrierung hinzugefügt. Der Transporttyp wird in der Orchestrierungslogik konfiguriert.
Verwenden eines einzelnen Sendeports mit verschiedenen Porteigenschaften (z. B. URL).	No Beim Erstellen eines statischen Sendeports müssen einige Adaptereigenschaften konfiguriert werden, z. B. die URL.	Yes Ein dynamischer Sendeport wird normalerweise einer Orchestrierung hinzugefügt. Die Eigenschaften werden in der Orchestrierungslogik konfiguriert.
Der Standardsendehandler muss verwendet werden.	No Der Sendehandler kann beim Erstellen eines Sendeports konfiguriert werden.	No Der Sendehandler kann beim Erstellen eines Sendeports konfiguriert werden.
Sollte verwendet werden, wenn das Nachrichtenziel unbekannt ist.	No Beim Erstellen eines statischen Sendeports geben Sie den Transporttyp und den Endspeicherort an.	Yes Der Endspeicherort kann in einer Orchestrierunng und in einem inhaltsbasierten Routingszenario konfiguriert werden. Regeln können ebenfalls zum Filtern des Sendeziels der Nachricht verwendet werden.
Verwenden eines einzelnen Sendeports zum Senden von Nachrichten an mehrere Partner.	No Beim Erstellen eines statischen Sendeports geben Sie den Transporttyp und den Endspeicherort an.	Yes Ein dynamischer Sendeport wird normalerweise einer Orchestrierung hinzugefügt. Die Eigenschaften werden in der Orchestrierungslogik und basierend auf von Ihnen angegebenen Regeln konfiguriert. Nachrichten können an mehrere Partner gesendet werden.

Erstellen eines statischen Sendeports

Wenn ein statischer Sendeport erstellt wird, verwendet dieser den Standardsendehandler, der dem Transporttyp zugeordnet ist. Bei Verwendung des Windows SharePoint Services-Adapters ist der Standardmäßige Sendehandler BizTalkServerApplication. Die Schritte zum Hinzufügen eines neuen Sendehandlers finden Sie unter Erstellen eines Adapterhandlers.

Erstellen des statischen Sendeports:

1. Erweitern Sie in der BizTalk Server VerwaltungskonsolebizTalk-Gruppe [Gruppenname], Anwendungen und dann die Anwendung, um den Sendeport zu enthalten.

2. Klicken Sie mit der rechten Maustaste auf Ports senden, klicken Sie auf Neu, und klicken Sie dann auf Statischer Unidirektionalen Sendeport.

   Wichtig

   Ein statischer Solicit-Response Sendeport ist mit dem Windows SharePoint Services-Adapter nicht konfigurierbar.

3. Klicken Sie unter Eigenschaften in der Dropdownliste Typ auf Windows SharePoint Services. Geben Sie die Eigenschaften Name, Send Handler und Send Pipeline ein.

4. Klicken Sie auf Konfigurieren. Konfigurieren Sie unter Eigenschaften Folgendes:

   Eigenschaft	BESCHREIBUNG
   Port des Adapter-Webdiensts	Erforderlich. Der Port, der auf der IIS-Website konfiguriert ist, auf der der SharePoint Services-Adapterwebdienst gehostet wird. Der Standardwert ist Port 80, d. h. der HTTP-Standardport. Aktualisieren Sie diesen Wert, wenn ein anderer Port als Port 80 verwendet wird.
   Timeout	Erforderlich. Dieser Wert ermittelt (in Millisekunden), wann der Adapter eine Antwort vom Webdienst empfängt. Der Standardwert ist 100000 ms (100 Sekunden). Erhöhen Sie diesen Wert, wenn die Nachrichten- oder Batchgröße höher als erwartet ist. Der Timeoutwert (in Millisekunden) für die Webdienstaufrufe des Adapter-Laufzeitmoduls an den Webdienst für den Windows SharePoint Services-Adapter. Wenn die Nachrichten- oder Batchgröße über dem vom Adapter erwarteten Durchschnitt liegt, müssen Sie diesen Wert möglicherweise erhöhen.
   Client-OM verwenden	Erforderlich. Ermittelt, ob SharePoint CSOM (Client Side Object Model) oder SSOM (Service Side Object Model) verwendet wird. Der Standardwert ist Ja. Legen Sie auf Ja fest, um das SharePoint-CSOM auf dem BizTalk Server zu verwenden. Es gibt keine Anforderungen für den SharePoint Services Computer. Legen Sie auf Nein fest, um das SharePoint-SSOM zu verwenden, das den auf dem SharePoint Services Computer installierten Webdienst enthält. Anhang B: Installieren des Microsoft SharePoint-Adapters enthält spezifische Informationen zu den SSOM- und CSOM-Komponenten, die vom SharePoint Services-Adapter verwendet werden.
   Zielordner-URL	Erforderlich. Die SharePoint Services Ordner-URL zum Speichern der Dokumente. Geben Sie den relativen Pfad zur SharePoint-Website ein. Beispiel: Freigegebene Dokumente oder freigegebene Dokumente/Bestellungen/. Eine Liste kann ebenfalls als Ziel verwendet werden. Beispiel : Listen/Aufgaben. Wenn Sie eine Liste angeben, wird der Nachrichtentext nicht mit dem Listeneintrag gespeichert. Die aus der Nachricht extrahierten Werte werden in die SharePoint-Spalten höher gestuft. Hinweis: Die SharePoint-Dokumentbibliothek oder ordner-URL kann sich von ihrem Namen unterscheiden. Überprüfen Sie die Adresse im Webbrowser auf die richtige URL.
   Dateiname	Optional: Geben Sie den Namen SharePoint Services Dateinamen ein. Geben Sie einen Dateinamen ein, z. B.PurchaseOrder0001.xml oder einen Ausdruck. Ausdrücke enthalten eine beliebige Kombination aus Literalen, Makros und XPATH-Abfragen. Geben Sie beispielsweise PurchOrd-%XPATH=/po:PurchaseOrderId%-%MessageID%.xmlein. Wenn kein Dateiname angegeben wird, wird der Name der Originaldatei, der von der Orchestrierung angegebene Wert oder Msg-%Nachrichten-ID%.xml verwendet. Weitere Informationen finden Sie unter Windows SharePoint Services Adapterausdrücke. Hinweis: Beim Senden von Nachrichten an eine Liste wird dieser Dateiname-Wert ignoriert und nicht in einer SharePoint-Spalte gespeichert. Aktualisieren Sie stattdessen die Spalte Titel, und verwenden Sie dabei eine der 16 verfügbaren Spalten. In SharePoint-Listen ist keine Spalte namens Dateiname enthalten.
   Namespacealiase	Optional: Eine durch Kommas oder Semikolons getrennte Liste von Definitionen für Namespacealiase. In diesem Feld können Sie die Namespacealiase definieren, die bei den XPATH-Abfragen in Feldern wie etwa Dateiname oder Spaltenwert verwendet werden. Geben Sie beispielsweise po='http://OrderProcess/POrder', conf='http://OrderProcess/Confirmation' xmlns=""; ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}' ein. Hinweis: Diese Eigenschaft überschreibt die WSS nicht. ConfigNamespacesAliases-Nachrichtenkontexteigenschaft, die durch die Orchestrierung definiert wird. Stattdessen werden die beiden Werte zusammengeführt.
   Overwrite	Erforderlich. Legt fest, ob die Datei überschrieben wird, wenn bereits eine Datei vorhanden ist. Der Standardwert ist Nein. Beispiele für Optionen: - Nein: Löst einen Fehler aus und hält die Meldung an, wenn eine Datei mit demselben Namen vorhanden ist. - Orchestrierung: Verwendet den in der Orchestrierung definierten Wert, wenn eine Datei mit demselben Namen vorhanden ist. - Umbenennen: Benennt die neue Datei um, wenn eine Datei mit demselben Namen vorhanden ist. - Ja: Überschreibt eine vorhandene Datei, wenn sie denselben Namen hat. Wenn diese Einstellung auf Ja festgelegt ist, kann das Senden einer großen Anzahl von Nachrichten mit demselben Namen zu SharePoint-Ereignisanzeige-Fehlern führen. Diese Fehler wirken sich nicht auf den Adapter aus, und für alle Nachrichtenfehler wird ein Wiederholungsversuch ausgeführt.
   URL der SharePoint-Site	Erforderlich. Die vollständige URL der SharePoint Services-Website. Beispiel: http:// SharePointServer/sites/TestSite. Hinweis: Ein Sendeport- oder Empfangsspeicherort-URI darf 256 Zeichen nicht überschreiten.
   Microsoft Office-Integration	Erforderlich. Für binäre Nachrichten müssen Sie Nein oder Optional verwenden. Der Standardwert ist Optional. Beispiele für Optionen: Nein: Speichert das Dokument unverändert. Für binäre Nachrichten kann diese Option verwendet werden. Optional: Ändert das Dokument, sodass es automatisch in einer Office-Anwendung wie InfoPath geöffnet wird. Wenn die Verarbeitungsanweisungen nicht gefunden werden, wird das Dokument unverändert verarbeitet. Für binäre Nachrichten kann diese Option verwendet werden. Orchestrierung: Verwendet den in der Orchestrierung definierten Wert. Ja: Ändert das Dokument, sodass es automatisch in einer Office-Anwendung wie InfoPath geöffnet wird. Wenn die Verarbeitungsanweisungen nicht gefunden werden, wird die Nachricht angehalten. Bei Festlegung auf Ja ist mindestens eines der folgenden Eigenschaftenpaare erforderlich: Vorlagen-Dokumentbibliothek und Vorlagennamespacespalte Vorlagen-Fallbackdokumentbibliothek und Fallbacknamespacespalte für Vorlagen Ja (InfoPath-Formularbibliothek): Wenn sich eine InfoPath-Projektmappe in der Formularbibliothek befindet, wird das Dokument so geändert, dass es automatisch in einer Office-Anwendung wie InfoPath geöffnet wird. Wenn in der Formularbibliothek keine Lösung vorhanden ist, wird die Nachricht angehalten.
   Vorlagendokumentbibliothek	Nur erforderlich, wenn die Vorlagennamespacespalte aufgefüllt wird. Die SharePoint-Dokumentbibliothek, in der die InfoPath-Lösungen gespeichert sind. Beispiel: Meine Lösungen. Der Adapter sucht in der Vorlagendokumentbibliothek nach einer passenden InfoPath-Lösung. Wenn keine Lösung gefunden wird, sucht der Adapter in der Vorlagenfallbackdokumentbibliothek. Hinweis: Die Vorlagendokumentbibliothek erfordert mindestens eine SharePoint-Spalte "Einzelne Textzeile", die mit Folgendem aufgefüllt wird: Mit dem Namespace und dem Stammknoten der XML-Dokumente, die mit der InfoPath-Lösung geöffnet werden. ODER mit dem Stammknoten des XML-Dokuments. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Modul 2 – Integrieren von Office in den Windows SharePoint Services Adapter.
   Vorlagen-Fallbackdokumentbibliothek	Nur erforderlich, wenn die Vorlagenfallbacknamespace-Spalte aufgefüllt wird. Die SharePoint-Dokumentbibliothek, in der die InfoPath-Lösungen gespeichert sind. Beispiel: Vorlagen. Wenn in der Vorlagendokumentbibliothek keine Lösung gefunden wird, sucht der Adapter in der Vorlagenfallbackdokumentbibliothek nach einer passenden InfoPath-Lösung. Die Felder Vorlagenfallback Dokumentbibliothek und Vorlagen Dokumentbibliothek können mit zwei Sätzen von InfoPath-Lösungen verwendet werden. So sind allgemeine InfoPath-Lösungen für alle allgemeinen Zwecke verfügbar, und es gibt spezielle InfoPath-Lösungen, die nur für einen bestimmten Partner verwendet werden. Das Feld Vorlagenfallbackdokumentbibliothek sollte auf die generischen Lösungen verweisen, und die Vorlagendokumentbibliothek sollte auf die spezialisierten Lösungen für den jeweiligen Partner verweisen. Hinweis:Die Vorlagenfallbackdokumentbibliothek erfordert mindestens eine SharePoint-Spalte "Einzelne Textzeile", die mit Folgendem aufgefüllt wird: Mit dem Namespace und dem Stammknoten der XML-Dokumente, die mit der InfoPath-Lösung geöffnet werden. ODER mit dem Stammknoten des XML-Dokuments. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Modul 2 – Integrieren von Office in den Windows SharePoint Services Adapter.
   Spalte für Vorlagenfallback-Namespaces	Nur erforderlich, wenn die Vorlagenfallbackdokumentbibliothek aufgefüllt wird. Die SharePoint-Dokumentbibliothek, in der der Namespace der InfoPath-Lösungen gespeichert sind. Beispiel: myNamespace. Hinweis: Bei diesem Feld wird die Groß-/Kleinschreibung beachtet.
   Spalte für Vorlagennamespaces	Nur erforderlich, wenn die Vorlagendokumentbibliothek aufgefüllt wird. Die Dokumentbibliotheksspalte für SharePoint-Vorlagen, in der der Namespace der InfoPath-Lösung gespeichert wird. Beispiel: myNamespace. Hinweis: Bei diesem Feld wird die Groß-/Kleinschreibung beachtet.
   Kennwort für SharePoint Online	Optional: Das Kennwort für das SharePoint Online-Konto.
   Benutzername für SharePoint Online	Optional: Der Benutzername für das SharePoint Online-Konto.
   Spalte n	Optional: Die SharePoint-Spalte, die in der Zieldokumentbibliothek vorhanden ist. Aktualisieren Sie diese Spalte mit dem Wert, der aus der Nachricht extrahiert oder im Feld Spaltenwert angegeben wurde. Hinweis: Es können bis zu 16 Spalten angegeben werden. Für dieses Feld wird zwischen Groß- und Kleinschreibung unterschieden.
   Spaltenwert n	Optional: Geben Sie den für die Nachricht festzulegenden Spaltenwert ein. Sie können einen Literalwert wie "Bestellung" oder einen Ausdruck eingeben. Ausdrücke können eine beliebige Mischung aus Literalen, Makros und XPATH-Abfragen enthalten. Geben Sie beispielsweise "%XPATH=//po:POAmount%", "%SendingOrchestrationID%" ein. Hinweis: Es können bis zu 16 Spalten angegeben werden.

5. Klicken Sie auf OK , um die Einstellungen zu speichern.

6. Die folgenden weiteren Sendeport-Konfigurationsoptionen sind verfügbar:

   1. Konfigurieren erweiterter Transportoptionen für einen Sendeport

   2. Konfigurieren sekundärer Transportoptionen für einen Sendeport

   3. Konfigurieren von ausgehenden Zuordnungen für einen Sendeport

   4. Konfigurieren von Filtern für einen Sendeport

   5. Zuweisen eines Zertifikats zu einem Sendeport

   6. Konfigurieren der Überwachung für einen Sendeport

Erstellen eines dynamischen Sendeports

Beim Erstellen eines dynamischen Sendeports ist der Sendehandler für jeden Adapter konfigurierbar. Ein einzelner dynamischer Sendeport kann von mehreren Adaptern verwendet werden. Die Schritte zum Konfigurieren des Handlers für dynamische Sendeports finden Sie unter Dynamischer Sendeporthandler ist konfigurierbar .

1. Erweitern Sie in der BizTalk Server Verwaltungskonsoledie Option BizTalk-Gruppe [Gruppenname], Anwendungen, und erweitern Sie dann die Anwendung, um den Sendeport zu enthalten.

2. Klicken Sie mit der rechten Maustaste auf Sendeports, klicken Sie auf Neu, und wählen Sie dann Dynamischer unidirektionale Sendeport oder Dynamischer Solicit-Response Sendeport aus.

3. Geben Sie unter Eigenschaften die Eigenschaften Name und Pipeline ein.

   Klicken Sie auf Konfigurieren.

4. Wählen Sie im Fenster Send Handler konfigurieren den Sendehandler für die einzelnen Adapter aus. Der Standardmäßige Sendehandler ist BizTalkServerApplication. Die Schritte zum Hinzufügen eines neuen Sendehandlers finden Sie unter Erstellen eines Adapterhandlers.

   Es gibt zahlreiche Gründe für die Verwendung separater Hosts:

   • 32-Bit-Anforderungen: Einige Adapter erfordern einen 32-Bit-Host, z. B. die FTP- und POP3-Adapter. Sie können alle oder einzelne 32-Bit-Adapter in ihrem eigenen Host gruppieren.

     64-Bit-Unterstützung für BizTalk Server

   • Host nach Zweck: Erstellen Sie einen Host für das Senden, einen Host für den Empfang, einen Host für die Verarbeitung von Orchestrierungen und einen Host für die Nachverfolgung.

   • Unterschiedliche Hosteinstellungen: Viele Einstellungen werden auf Hostebene implementiert. Daher sind verschiedene Drosselungseinstellungen für jeden Host konfigurierbar. Sie können Drosselung beispielsweise auf HostA deaktivieren. Verfolgen Sie jedes Ereignis auf HostB nach. Ändern Sie die .NET CLR-Einstellungen für HostC. Erhöhen Sie die Speicherverwendung auf HostD.

   • Sicherheit: Die Sicherheit wird auf Hostebene implementiert. Jeder Host wird unter seinem eigenen Windows-Konto ausgeführt. HostA verwendet z. B. den FILE-Adapter für den Zugriff auf eine Dateifreigabe. Erteilen Sie dem HostA-Benutzerkonto Berechtigungen für die Dateifreigabe. HostB verwendet einen Webdienst, der auf einem IIS-Server gehostet wird. Erteilen Sie dem HostB-Benutzerkonto Autorisierung für den Webdienst. Auf diese Weise wird außerdem verhindert, dass andere Hostkonten auf Entitäten zugreifen, auf die sie nicht zugreifen müssen.

   • Separate Adapter: Beispielsweise verfügen Sie über mehrere Artefakte (Empfangsspeicherort und Sendeports), die den HTTP-Adapter verwenden. Sie möchten alle dem HTTP-Adapter zugeordneten Elemente auf einem eigenen Host verwalten.

   • Separate Orchestrierungen: Einzelne Orchestrierungen können sich in einem eigenen Host befinden. Wenn eine Orchestrierung z. B. Arbeitsspeicher oder CPU in großem Ausmaß verwendet, speichern Sie diese Orchestrierung auf ihrem eigenen Host.

     BizTalk Server Handbuch zur Leistungsoptimierung und How to maintain and troubleshooting BizTalk Server datenbanken bieten Leistungsvorschläge.

5. Klicken Sie auf OK , um die Einstellungen zu speichern.

6. Die folgenden weiteren Sendeport-Konfigurationsoptionen sind verfügbar:

   1. Konfigurieren erweiterter Transportoptionen für einen Sendeport

   2. Konfigurieren von ausgehenden Zuordnungen für einen Sendeport

   3. Konfigurieren von Filtern für einen Sendeport

   4. Zuweisen eines Zertifikats zu einem Sendeport

   5. Konfigurieren der Überwachung für einen Sendeport

7. Klicken Sie auf OK , um die Einstellungen zu speichern.

   Weitere Themen zum Sendeport:

   Erstellen und Konfigurieren von Sendeports

   Erstellen und Konfigurieren von Sendeportgruppen

Weitere Informationen

Problembehandlung bei SharePoint Services Adapterconfigure SharePoint Services Receive LocationCSOM: SharePoint Services Adapter