Von IBM BPM auf den SharePoint-CMIS-Provider zugreifen

In IBM® Business Process Manager wird der CMIS-Standard (CMIS - Content Management Interoperability Services) verwendet, um die Integration mit ECM-Systemen (ECM - Enterprise Content Management) wie beispielsweise Microsoft SharePoint bereitzustellen. Die CMIS-Funktionalität besteht aus neun voneinander getrennten Web-Service-Endpunkten.

Informationen zu diesem Vorgang

In Process Designer werden ECM-Server im Editor 'Einstellungen für Prozessanwendungen' oder im Editor 'Toolkiteinstellungen' konfiguriert, indem der Host, der Port und der Kontextpfad angegeben werden. Wenn die URL des CMIS-Web-Service zur Laufzeit erstellt wird, beinhaltet die URL den angegebenen Host, Port und Kontextpfad des ECM-Servers und der Servicename wird automatisch an die URL angehängt. Diese Methode ermöglicht es IBM BPM, erfolgreich eine Verbindung zu IBM FileNet Content Manager, IBM Content Manager und weiteren ECM-Systemen herzustellen, für die es erforderlich ist, dass die Web-Service-URL an den Servicenamen angehängt wird. FileNet beispielsweise verwendet die folgende Namenskonvention, um die CMIS-Endpunkt-URL RepositoryService verfügbar zu machen:

http://Hostname:Portnummer/fncmis/RepositoryService

Die URL eines SharePoint-CMIS-Web-Service verwendet jedoch nicht dieselbe Namenskonvention, da die URL nicht an den Servicenamen angehängt wird. Die URL folgt stattdessen einer Namenskonvention, ähnlich der in den folgenden Beispielen:

http://Hostname:Portnummer/_vti_bin/cmis/soap/RepositoryService.svc/basic
http://hostName:Portnummer/_vti_bin/cmis/soap/RepositoryService.svc/kerberos
http://Hostname:Portnummer/_vti_bin/cmis/soap/RepositoryService.svc

Anmerkung: Die obige Kerberos-URL stellt ein Beispiel für die Namenskonvention dar, die bei SharePoint-CMIS-Web-Service-URLs verwendet wird. Dieses Hilfethema enthält jedoch keine Informationen zur Kerberos-Authentifizierung. Es erläutert die Zuordnung zu den von IBM BPM verwendeten URL-Syntaxkonventionen.

Wenn IBM BPM versucht, eine Verbindung zum SharePoint-Server mithilfe der folgenden URL herzustellen, kann die Verbindung nicht hergestellt werden, weil die Web-Service-Adresse nicht bekannt ist:

http://Hostname:Portnummer/_vti_bin/cmis/soap/RepositoryService

Damit IBM BPM die in SharePoint verwendete Namenskonvention verwenden kann, ist das Microsoft URL-Rewrite-Modul 2.0 für Internet Information Services (IIS) 7 erforderlich. Das URL-Rewrite-Modul stellt einen regelbasierten Mechanismus zur Verfügung, mit dem die URL der von IBM BPM eingehenden Anforderung umgeschrieben wird, bevor sie vom Web-Server verarbeitet wird. Betrachten Sie zum Beispiel die folgende Anforderungs-URL von IBM BPM:

http://Hostname:Portnummer/_vti_bin/cmis/soap/RepositoryService

Durch das Modul für die URL-Umschreibung (URL Rewrite Module) kann die URL in das SharePoint-Format umgeschrieben werden, das im folgenden Beispiel angezeigt wird:

http://Hostname:Portnummer/_vti_bin/cmis/soap/RepositoryService.svc

Folgende Tasks müssen ausgeführt werden, damit das URL-Rewrite-Modul von IBM BPM eingehende Anforderungs-URLs umschreiben kann:

URL Rewrite Module 2.0 for Microsoft IIS 7 herunterladen
Regeln für das Umschreiben in IIS Manager definieren
Von Process Designer auf den SharePoint-CMIS-Provider zugreifen

Führen Sie die Schritte der folgenden Vorgehensweise aus, um die Tasks auszuführen:

Vorgehensweise

Laden Sie URL Rewrite Module 2.0 for IIS 7 herunter, indem Sie die folgenden Schritte ausführen:
1. Stellen Sie sicher, dass IIS 7 installiert ist.
2. Wenn Microsoft URL Rewrite Module 2.0 noch nicht in Ihrer IIS 7-Installation enthalten ist, laden Sie es von einer der folgenden Webseiten herunter. Installieren Sie es anschließend anhand der Anweisungen, die auf den folgenden Webseiten vorhanden sind:
  - (x64) http://www.microsoft.com/en-us/download/details.aspx?id=7435
  - (x86) http://www.microsoft.com/en-us/download/details.aspx?id=5747
Definieren Sie die Regeln für das Umschreiben in IIS Manager, indem Sie die folgenden Schritte ausführen:
1. Wählen Sie in Ihrem Desktop die Optionen Start > Verwaltungstools > Internet Information Services (IIS) Manager aus. IIS Manager wird geöffnet.
2. Wählen Sie eine Verbindung aus.
3. Wählen Sie IIS > URL Rewrite aus.
4. Wählen Sie Rule > Inbound rules > Blank rule aus.
5. Geben Sie im Bereich Name die Option CMIS URL rewrite rule an.
6. Führen Sie im Abschnitt Match URL folgende Schritte aus:
  1. Wählen Sie in der Dropdown-Liste Requested URL die Option Matches the Pattern.
  2. Wählen Sie in der Dropdown-Liste Using die Option Regular Expressions aus.
  3. Geben Sie im Feld Pattern das folgende Muster an:
```
^.*cmis/soap/(.*)$
```
  4. Wählen Sie Ignore case aus.
7. Führen Sie im Abschnitt Conditions die folgenden Schritte aus:
  1. Klicken Sie auf Hinzufügen. Das Dialogfenster zum Hinzufügen einer Bedingung wird geöffnet.
  2. Geben Sie im Feld Condition input die folgende Bedingungseingabe an:
```
{R:1}
```
  3. Wählen Sie in der Liste Check if input string die Option Does Not Match the Pattern aus.
  4. Geben Sie im Feld Pattern das folgende Muster an:
```
(.*).svc(.*)
```
  5. Wählen Sie Ignore case aus.
  6. Klicken Sie auf OK.
8. Führen Sie im Abschnitt Actions die folgenden Schritte aus:
  1. Wählen Sie in der Dropdown-Liste Action type die Option Rewrite aus.
  2. Geben Sie im Feld Rewrite URL eine umgeschriebene URL an, die für Ihre Konfiguration passend ist. Beispiel:
```
{R:0}.svc
```
  3. Wählen Sie Append query string aus.
9. Klicken Sie auf der rechten Seite der Seite auf Apply, um die Änderungen zu speichern.
Führen Sie folgende Schritte aus, um von IBM Process Designer auf den SharePoint-CMIS-Provider zuzugreifen:
1. Öffnen Sie den Editor 'Einstellungen für Prozessanwendungen' und wählen Sie die Registerkarte Server aus.
2. Geben Sie in den Abschnitten Serverdetails und Serverpositionen die entsprechenden Serverinformationen für Ihre SharePoint-Installation an. Stellen Sie sicher, dass Sie Enterprise Content Management Server im Feld Typ angeben. Stellen Sie außerdem sicher, dass Sie den richtigen Kontextpfad im Feld Kontextpfad angeben. Der Standardkontextpfad lautet:
```
_vti_bin/cmis/soap
```
3. Klicken Sie auf Verbindung testen, um sicherzustellen, dass eine erfolgreiche Verbindung vorhanden ist.