Freigeben über

Schritt 1: Veröffentlichen der Siebel-Geschäftskomponentenvorgänge als WCF-Dienst

  • Artikel

Schritt 1 von 4

Abgeschlossene Zeit: 10 Minuten

Ziel: Sie können den WCF-Adapterdienstentwicklungs-Assistenten verwenden, um einen WCF-Dienst zu generieren, der in einer Hostingumgebung wie Internetinformationsdienste (IIS) oder Windows Process Activation Service (WAS) gehostet werden kann. In diesem Thema wird veranschaulicht, wie Sie mithilfe des Assistenten eine WCF-Dienstdatei generieren.

Voraussetzungen

Bevor Sie den Assistenten ausführen, installieren Sie Folgendes:

  • Microsoft Windows Communication Foundation (WCF) Branchenadapter-SDK (LOB) entweder mit der Option Vollständig oder der Option Benutzerdefiniert (und wählen Sie in dieser Option Extras aus). Dadurch wird die Visual Studio-Vorlage für den WCF-Adapterdienstentwicklungs-Assistent installiert.

  • Microsoft BizTalk Adapter für Siebel eBusiness-Anwendungen

  • Der erforderliche Siebel-Client.

    Weitere Informationen zu diesen Voraussetzungen finden Sie im Installationshandbuch für das BizTalk Adapter Pack. Die Installationsanleitung wird normalerweise unter <Installationslaufwerk>:\Programme\Microsoft BizTalk Adapter Pack\Documents installiert.

Veröffentlichen der Siebel Business Components als WCF-Dienst

  1. Starten Sie Visual Studio, und erstellen Sie dann ein Projekt.

  2. Wählen Sie im Dialogfeld Neues Projekt im Bereich Projekttypendie Option Visual C# aus. Wählen Sie im Bereich Vorlagen die Option WCF-Adapterdienst aus.

    Erweitern Sie alternativ im Bereich Projekttypenvisual C#, und wählen Sie dann Web aus. Wählen Sie im Bereich Vorlagen die Option WCF-Adapterdienst aus.

    Hinweis

    Wenn Sie Visual Studio mit der Webentwicklungskomponente installiert haben, ist die WCF-Adapterdienst-Vorlage auch über die Option Neue Website verfügbar.

  3. Geben Sie einen Namen und einen Speicherort für die Projektmappe an, und klicken Sie dann auf OK. Der WCF-Adapterdienstentwicklungs-Assistent wird gestartet.

  4. Klicken Sie auf der Seite Willkommenauf Weiter.

  5. Geben Sie auf der Seite Vorgänge auswählen einen Verbindungszeichenfolge an, um eine Verbindung mit dem Siebel-System herzustellen. Gehen Sie folgendermaßen vor:

    1. Klicken Sie in der Liste Bindung auswählen auf siebelBinding, und klicken Sie dann auf Konfigurieren.

    2. Klicken Sie im Dialogfeld Adapter konfigurieren auf die Registerkarte Sicherheit .

    3. Wählen Sie in der Liste Clientanmeldeinformationentypdie Option Benutzername aus, und geben Sie dann den Benutzernamen und das Kennwort an, um eine Verbindung mit dem Siebel-System herzustellen.

    4. Klicken Sie auf die Registerkarte URI-Eigenschaften , und geben Sie dann Werte für die Verbindungsparameter an. Weitere Informationen zum Verbindungs-URI für den Siebel-Adapter finden Sie unter Erstellen des Siebel-Systemverbindungs-URI.

      Hinweis

      Wenn die Verbindungsparameter reservierte Zeichen (z. B. XML-Sonderzeichen) enthalten, müssen Sie sie unverändert auf der Registerkarte URI-Eigenschaften angeben, d. h. ohne Escapezeichen. Wenn Sie den URI jedoch direkt im Feld URI konfigurieren angeben und die Verbindungsparameter reservierte Zeichen enthalten, müssen Sie die Verbindungsparameter mithilfe der richtigen Escapezeichen angeben.

    5. Klicken Sie auf die Registerkarte Bindungseigenschaften , und geben Sie dann Werte für die Bindungseigenschaften an, falls vorhanden, die für die Vorgänge erforderlich sind, die Sie als Ziel verwenden möchten.

      Weitere Informationen zu Bindungseigenschaften finden Sie unter Informationen zum BizTalk-Adapter für Siebel-Bindungseigenschaften.

    6. Klicken Sie auf OK, und klicken Sie dann auf Verbinden. Nachdem die Verbindung hergestellt wurde, wird die verbindung status als Verbunden angezeigt.

  6. Klicken Sie auf der Seite Vorgänge auswählen in der Liste Vertragstyp auswählen auf Client (Ausgehende Vorgänge).

  7. Erweitern Sie im Feld Kategorie auswählen den Knoten Siebel Business Objects , um die Liste der Geschäftsobjekte im Siebel-Repository anzuzeigen. Gehen Sie in diesem Beispiel wie folgt vor:

    1. Erweitern Sie das Geschäftsobjekt Konto , und klicken Sie dann auf die Geschäftskomponente Konto .

    2. Wählen Sie im Feld Verfügbare Kategorien und Vorgänge den Abfragevorgang aus, und klicken Sie dann auf Hinzufügen. Der ausgewählte Vorgang wird im Feld Hinzugefügte Kategorien und Vorgänge aufgeführt.

      Auswählen von Siebel-Geschäftskomponentenvorgängen

  8. Klicken Sie auf der Seite Vorgänge auswählen auf Weiter.

  9. Geben Sie auf der Seite Dienst- und Endpunktverhalten konfigurieren Werte an, um das Dienst- und Endpunktverhalten zu konfigurieren.

    1. Geben Sie im Feld Dienstverhaltenskonfiguration Werte für Folgendes an:

      Für die Eigenschaft Angeben des Werts
      EnableMetadataExchange Legen Sie dies auf True fest, um einen Metadatenaustauschendpunkt zu erstellen. Wenn Sie dies auf True festlegen, stellen Sie die Dienstmetadaten mithilfe standardisierter Protokolle zur Verfügung, z. B. WS-Metadata Exchange (MEX) und HTTP/GET-Anforderungen.

      Der Standardwert ist False.
      IncludeExceptionDetailsinFault Legen Sie diesen Wert auf True fest, um verwaltete Ausnahmeinformationen im Detail zu SOAP-Fehlern einzuschließen, die zu Debugzwecken an den Client zurückgegeben werden. Der Standardwert ist False.
      Name Name für die Dienstverhaltenskonfiguration.
      UseServiceCertificate Gibt an, ob Sie den Sicherheitsmodus auf Nachrichtenebene von WCF verwenden möchten. Der Standardwert ist true.

      Für dieses Tutorial müssen Sie dies auf False festlegen.
      FindValue Eine Zeichenfolge, die den Wert angibt, nach dem im X.509-Zertifikatspeicher gesucht werden soll.

      Hinweis: Geben Sie nur einen Wert für diese Eigenschaft an, wenn UseServiceCertificate auf True festgelegt ist.
      StoreLocation Ein Wert, der den Speicherort des Zertifikatspeichers angibt, den der Dienst zum Überprüfen des Zertifikats des Clients verwenden kann.

      Hinweis: Geben Sie nur einen Wert für diese Eigenschaft an, wenn UseServiceCertificate auf True festgelegt ist.
      StoreName Name des zu öffnenden X.509-Zertifikatspeichers.

      Hinweis: Geben Sie nur einen Wert für diese Eigenschaft an, wenn UseServiceCertificate auf True festgelegt ist.
      X509FindType Der Typ der X.509-Suche, der ausgeführt werden soll.

      Hinweis: Geben Sie nur einen Wert für diese Eigenschaft an, wenn UseServiceCertificate auf True festgelegt ist.

      Hinweis

      Weitere Informationen zu den Zertifikaten und den zugehörigen Eigenschaften finden Sie unter X509ClientCertificateCredentialsElement Properties.

    2. Geben Sie im Feld Endpunktverhaltenskonfiguration Werte für Folgendes an:

      Für die Eigenschaft Angeben des Werts
      Authentifizierungstyp Legen Sie dies auf ClientCredentialUserNamePassword fest, damit die Clients den Benutzernamen und das Kennwort angeben können, während sie den WCF-Dienst nutzen.

      – Legen Sie dies auf HTTPUserNamePassword fest, damit Clients Benutzernamen und Kennwort als Teil des HTTP-Headers angeben können.

      – Legen Sie dies auf Auto fest, damit Clients zunächst anmeldeinformationen über die ClientCredential-Schnittstelle angeben können. Wenn dies fehlschlägt, können Clients Anmeldeinformationen als Teil des HTTP-Headers übergeben.

      Der Standardwert ist Auto. Damit Microsoft Office SharePoint Server den WCF-Dienst nutzen kann, sollten Sie dies auf HTTPUserNamePassword festlegen.
      Name Geben Sie einen Namen für die Endpunktverhaltenskonfiguration an.
      UsernameHeader Name für den Benutzernamenheader. Geben Sie in diesem Beispiel MyUserHeader an. Weitere Informationen zu HTTP-Headern finden Sie unter "Unterstützung für benutzerdefinierte HTTP- und SOAP-Header" unter https://go.microsoft.com/fwlink/?LinkId=106692.

      Hinweis: Sie müssen einen Wert für diese Eigenschaft angeben, wenn der Authentifizierungstyp auf HTTPUserNamePassword festgelegt ist. Wenn Authentifizierungstyp auf Auto festgelegt ist, ist diese Eigenschaft optional.
      PasswordHeader Name für den Kennwortheader. Geben Sie in diesem Beispiel MyPassHeader an. Weitere Informationen zu HTTP-Headern finden Sie unter "Unterstützung für benutzerdefinierte HTTP- und SOAP-Header" unter https://go.microsoft.com/fwlink/?LinkId=106692.

      Hinweis: Sie müssen einen Wert für diese Eigenschaft angeben, wenn der Authentifizierungstyp auf HTTPUserNamePassword festgelegt ist. Wenn Authentifizierungstyp auf Auto festgelegt ist, ist diese Eigenschaft optional.

      Die folgende Abbildung zeigt die Seite Dienst- und Endpunktverhalten konfigurieren mit den angegebenen Werten.

      Seite

  10. Klicken Sie auf der Seite Dienst- und Endpunktverhalten konfigurieren auf Weiter.

  11. Auf der Seite Dienstendpunktbindung und -adresse konfigurieren werden im Feld Zu konfigurierende Verträge auswählen die Verträge für die Siebel-Geschäftskomponenten aufgelistet, für die Siebel auf der Seite Vorgänge auswählen die Vorgänge ausgewählt haben. Im Feld Vorgänge unter dem ausgewählten Vertrag werden die Vorgänge angezeigt, die Sie für jedes Artefakt auf der Seite Vorgänge auswählen ausgewählt haben.

  12. Geben Sie im Feld Adresse und Bindung für den Vertrag konfigurieren Werte für Folgendes an:

    Für die -Eigenschaft Angeben des Werts
    Bindungskonfiguration Der Assistent unterstützt nur die grundlegende HTTP-Bindung. Daher wird das Bindungskonfigurationsfeld automatisch in System.ServiceModel.Configuration.BasicHttpBindingElement aufgefüllt.

    Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...) , um die Eigenschaften für die HTTP-Bindung zu ändern. Um einen sicheren Kommunikationskanal zu verwenden, müssen Sie die Eigenschaft Mode immer auf Transport festlegen. Der Assistent legt den Standardwert für die Mode-Eigenschaft auf Transport fest.

    Weitere Informationen zu den anderen verfügbaren Bindungen finden Sie unter BasicHttpBindingElement-Klasse.
    Endpoint Name (Endpunktname) Geben Sie einen Endpunktnamen für den Vertrag an.

    Die anderen Felder auf dieser Seite werden automatisch basierend auf den Werten aufgefüllt, die Sie auf den vorherigen Seiten angegeben haben.

    Klicken Sie auf Anwenden. Führen Sie diesen Schritt für alle Verträge aus, die unter dem Feld Zu konfigurierenden Vertrag auswählen angezeigt werden.

    Hinweis

    Wenn Sie auf dieser Seite keine Werte angeben, werden die Standardwerte für alle Verträge akzeptiert.

    Die folgende Abbildung zeigt die Seite Dienstendpunktbindung und -adresse konfigurieren mit den angegebenen Werten.

    Konfigurieren der Dienstendpunktbindung und der Adresse

  13. Klicken Sie auf der Seite Dienstendpunktbindung und -adresse konfigurieren auf Weiter. Auf der Seite Zusammenfassung wird eine Struktur der Verträge für die ausgewählten Siebel-Geschäftskomponenten und darunter die für jede Geschäftskomponente ausgewählten Vorgänge aufgelistet.

  14. Überprüfen Sie die Zusammenfassung, und klicken Sie dann auf Fertig stellen.

  15. Der Assistent erstellt einen WCF-Dienst und fügt dem Visual Studio-Projekt die folgenden Dateien hinzu:

    1. SVC-Datei. Dies ist die WCF-Dienstdatei. Der Assistent generiert eine Datei für jeden Vertrag.

    2. Web.config Datei.

    3. Dienstcode (CS-Datei).

  16. Veröffentlichen Sie den WCF-Dienst.

    1. Stellen Sie sicher, dass SSL für Internetinformationsdienste (IIS) aktiviert ist. Weitere Informationen finden Sie unter Einrichten von SSL.

    2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und klicken Sie dann auf Veröffentlichen.

    3. Geben Sie im Dialogfeld Web veröffentlichen eine URL für den WCF-Dienst an. Beispiel:

      https://<computer_name>/Siebel_Account/

    4. Klicken Sie im Feld Kopieren auf Alle Projektdateien.

    5. Klicken Sie auf Veröffentlichen.

  17. Überprüfen Sie, ob der WCF-Dienst erfolgreich veröffentlicht wurde.

    1. Starten Sie die IIS-Microsoft-Verwaltungskonsole. Klicken Sie auf Start, zeigen Sie auf Verwaltung, und klicken Sie dann auf Internetinformationsdienste.

    2. Navigieren Sie zu dem Knoten, auf dem Sie den Dienst veröffentlicht haben. Navigieren Sie für den Siebel_Account-Dienst zu Internetinformationsdienste><Computername>>Websites>Standardwebsite>Siebel_Account.

    3. Klicken Sie im rechten Bereich mit der rechten Maustaste auf die Datei BusinessObjects_Account_Account_Operation.svc, und klicken Sie dann auf Durchsuchen.

    4. Die Webseite wird mit der URL zum Abrufen der WSDL angezeigt. Möglicherweise möchten Sie den Metadatenabruf mit dem Befehl svcutil testen. Der Befehl zum Abrufen von Metadaten für den Siebel_Account Dienst lautet beispielsweise:

      svcutil.exe https://localhost/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl

Nächste Schritte

Sie verfügen jetzt über einen WCF-Dienst für die Geschäftskomponente Siebel. Verwenden Sie den Business Data Catalog Definition Editor, um eine Anwendungsdefinitionsdatei für die Siebel-Geschäftskomponentenvorgänge zu erstellen. Anweisungen finden Sie unter Schritt 2: Erstellen einer Anwendungsdefinitionsdatei für Siebel Business Component Operations . Die Anwendungsdefinitionsdatei gibt an, wo die LOB-Daten gespeichert werden und in welchem Format sie gespeichert werden.

Weitere Informationen

Tutorial 1: Darstellen von Daten eines Siebel-Systems auf einer SharePoint-Website