Freigeben über

Schritt 1: Verwenden des Oracle E-Business-Adapters zum Erstellen und Veröffentlichen eines WCF-Diensts

  • Artikel

Schritt 1 von 4

Dauer: 15 Minuten

Ziel: Sie können den WCF-Adapterdienstentwicklungs-Assistenten verwenden, um einen WCF-Dienst aus den Artefakten der Oracle E-Business Suite 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

Installieren Sie vor dem Ausführen des Assistenten Folgendes:

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

  • Microsoft BizTalk-Adapter für Oracle E-Business Suite aus dem BizTalk-Adapterpaket.

    Weitere Informationen zu diesen Voraussetzungen finden Sie im Installationshandbuch für das BizTalk-Adapterpaket. Das Installationshandbuch wird in der Regel unter <Installationslaufwerk>:\Programme\Microsoft BizTalk Adapter Pack\Documents installiert.

Hinweis

Sie müssen auch das skript create_apps_artifacts.sql ausführen, das mit dem Microsoft Office SharePoint Server-Beispiel bereitgestellt wird, um die MS_SAMPLE_EMPLOYEE-Schnittstellentabelle in der Anwendung Application Object Library zu erstellen. Diese Schnittstellentabelle wird in diesem Tutorial verwendet.

Erstellen eines WCF-Diensts für den Vorgang in Oracle E-Business Artefakt

Dieser Abschnitt enthält die Schritte zum Erstellen eines WCF-Diensts für den Select-Vorgang für die MS_SAMPLE EMPLOYEE-Schnittstellentabelle.

So erstellen Sie einen WCF-Dienst für den Select-Vorgang in der MS_SAMPLE EMPLOYEE-Schnittstellentabelle

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

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

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

    Dialogfeld

    Hinweis

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

    Der Oracle E-Business-Adapter unterstützt jedoch nur Websites, die im Dateisystem erstellt werden. Daher müssen Sie beim Erstellen einer Website im Dialogfeld Neue Website in der Liste Speicherort auf Dateisystem klicken.

  3. Geben Sie einen Namen und einen Speicherort für die Projektmappe an, und klicken Sie dann auf OK. Der Assistent für die Entwicklung des WCF-Adapterdiensts 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 Oracle E-Business Suite herzustellen. Gehen Sie folgendermaßen vor:

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

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

      1. Wählen Sie unter der Kategorie Allgemein für die Bindungseigenschaft ClientCredentialTypedie Option EBusiness aus.

      2. Geben Sie unter der Kategorie OracleEBS die entsprechenden Werte für die Bindungseigenschaften OracleUserName, OraclePassword und OracleEBSResponsibilityName an. In diesem Fall müssen Sie Datenbankanmeldeinformationen für die Bindungseigenschaften OracleUserName und OraclePassword angeben.

      3. Wählen Sie unter der Kategorie Metadaten für die Bindungseigenschaft EnableSafeTypingdie Option True aus. Wenn Sie Werte für die Datumsspalte abrufen, empfiehlt es sich, die Bindungseigenschaft EnableSafeTyping beim Generieren der Metadaten auf True festzulegen.

    3. 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 Oracle E-Business-Adapter finden Sie unter Erstellen des Oracle E-Business Suite-Verbindungs-URI.

    4. Klicken Sie auf die Registerkarte Sicherheit , und wählen Sie in der Liste Clientanmeldeinformationstypdie Option Benutzername aus. Geben Sie einen gültigen Oracle E-Business Suite-Benutzernamen und ein gültiges Kennwort für die Verbindung mit Oracle E-Business Suite an.

    5. Klicken Sie auf OK , um das Dialogfeld Adapter konfigurieren zu schließen, und klicken Sie dann auf Verbinden. Nachdem Visual Studio erfolgreich eine Verbindung mit Oracle E-Business Suite hergestellt hat, wird die verbindung status als Verbunden angezeigt. Die Metadaten der Oracle E-Business Suite werden auch auf der Seite Vorgänge auswählen angezeigt.

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

  7. Navigieren Sie im Feld Kategorie auswählen zur MS_SAMPLE_EMPLOYEE-Schnittstellentabelle in der Anwendungsobjektbibliotheksanwendung. Informationen zum Durchsuchen eines Artefakts im Adapter finden Sie unter Durchsuchen, Suchen und Abrufen von Metadaten für Oracle E-Business-Vorgänge.

  8. Wählen Sie im Feld Verfügbare Kategorien und Vorgänge den Vorgang Auswählen aus, und klicken Sie dann auf Hinzufügen. Der Select-Vorgang wird dem Feld Hinzugefügte Kategorien und Vorgänge hinzugefügt.

    Hinzufügen des 02_MSB_GUI

    Hinweis

    Sie können für jedes Artefakt mehrere Vorgänge hinzufügen. Sie können auch Vorgänge für verschiedene Artefakte der Oracle E-Business Suite hinzufügen. Sie können beispielsweise einen Vorgang für eine Schnittstellentabelle und einen weiteren für ein gleichzeitiges Programm hinzufügen. Darüber hinaus können Sie nach bestimmten Vorgängen suchen, indem Sie in Suchausdrücken Wildcardzeichen angeben. Weitere Informationen zu den unterstützten Sonderzeichen und den Knotenebenen, auf denen Sie nach den Vorgängen suchen können, finden Sie unter Suchen nach Oracle E-Business Suite-Vorgängen.

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

  10. 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 dies 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. Geben Sie für dieses Tutorial customServiceBehavior ein.
      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.

      Hinweis

      Da wir für dieses Tutorial keine Dienstzertifikate verwenden, müssen Sie keine Werte für die Eigenschaften FindValue, StoreLocation, StoreName und X509FindType angeben. Weitere Informationen zu den Zertifikaten und den zugehörigen Eigenschaften finden Sie unter "X509ClientCertificateCredentialsElement Properties" unter https://go.microsoft.com/fwlink/?LinkId=103771.

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

      Für die -Eigenschaft Angeben des Werts
      Authentifizierungstyp Damit Microsoft Office SharePoint Server den WCF-Dienst nutzen kann, sollten Sie dies als HTTPUserNamePassword festlegen. Dadurch können Clients Benutzername und Kennwort als Teil des HTTP-Headers angeben.
      Name Geben Sie einen Namen für die Endpunktverhaltenskonfiguration an. Geben Sie für dieses Tutorial customEndpointBehavior ein.
      UsernameHeader Name für den Benutzernamenheader. Geben Sie für dieses 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 für dieses 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

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

  12. Auf der Seite Dienstendpunktbindung und -adresse konfigurieren wird unter Zu konfigurierenden Vertrag auswählen das von Ihnen konfigurierte Artefakt (MS_SAMPLE_EMPLOYEE) angezeigt. Im Feld Vorgänge unter dem ausgewählten Vertrag wird auf der Seite Vorgänge auswählen der Vorgang auswählen angezeigt, den Sie für das Artefakt ausgewählt haben.

  13. 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-Member" unter https://go.microsoft.com/fwlink/?LinkId=103773.
    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 Übernehmen.

    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 04_Service_Endpoint_Binding

  14. Klicken Sie auf der Seite Dienstendpunktbindung und -adresse konfigurieren auf Weiter. Auf der Seite Zusammenfassung wird eine Struktur des Oracle E-Business Suite-Artefakts und des für das Artefakt ausgewählten Vorgangs aufgelistet.

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

  16. 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)

Ändern der CS-Datei

Wenn Sie einen Dienst aus einem Oracle E-Business Suite-Artefakt mithilfe des Oracle E-Business-Adapters erstellen und ihn aus dem Business Data List-Webpart in Microsoft Office SharePoint Server verwenden möchten, wird erwartet, dass Sie die vollständige Filterklausel ab der WHERE-Klausel bereitstellen. Wenn Sie beispielsweise nach einem Mitarbeiter suchen möchten, der den Namen "John" hat, müssen Sie die folgende Filterklausel im Business Data List-Webpart angeben:

where NAME like ‘JOHN’

Wenn Sie jedoch möchten, dass der Benutzer nur den Namen als Eingabe für die Filterklausel angeben soll, ohne die gesamte Filterklausel zu erwähnen, können Sie in der CS-Datei einen Code hinzufügen, der die Filterklausel ändert, die aus dem Business Data List-Webpart in Microsoft Office SharePoint Server stammt, um sie im WHERE-Klauselformat an Oracle E-Business zu übergeben.

Wenn Der Benutzer in diesem Tutorial beispielsweise einen Mitarbeiternamen im Business Data List-Webpart in Microsoft Office SharePoint Server eingeben und einen Datensatz für diesen Mitarbeiter abrufen soll, können Sie den folgenden Code in der CS-Datei hinzufügen:

SelectResponse InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.Select(SelectRequest request)
{
     request.FILTER = "where NAME like '" + request.FILTER + "'"; // The code to avoid the users from specifying the WHERE clause in the filter from Business Data List Web Part.
     return base.Channel.Select(request);
}

Veröffentlichen des WCF-Diensts

Stellen Sie sicher, dass SSL für IIS aktiviert ist. Anweisungen zum Aktivieren von SSL für IIS finden Sie unter https://go.microsoft.com/fwlink/?LinkId=197170.

So veröffentlichen Sie den WCF-Dienst:

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

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

    https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/

    Hinweis

    Sie müssen den WCF-Dienst an einem SSL-fähigen Speicherort veröffentlichen. Anders ausgedrückt: Der Wert im Feld Zielstandort muss mit "https://" beginnen. Da die Benutzeranmeldeinformationen im HTTP-Header übergeben werden, hat der Assistent das Bindungsverhalten des Adapters automatisch so konfiguriert, dass "Transport" als Sicherheitsmodus verwendet wird, was die SSL-Verschlüsselung impliziert. Sie können natürlich zurückgehen und die web.config Datei bearbeiten, um den Wert des <Sicherheitsmodusparameters> zu ändern, aber die Verwendung von SSL ist immer eine bessere Option, wenn Sie vertrauliche Informationen im HTTP-Header als Klartext übertragen haben.

  3. Klicken Sie im Feld Kopieren auf Alle Projektdateien.

  4. Klicken Sie auf Veröffentlichen.

  5. Ü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 anschließend auf Internetinformationsdienste-Manager.

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

    3. Klicken Sie im rechten Bereich mit der rechten Maustaste auf die Datei InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.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 MS_SAMPLE_EMPLOYEE-Dienst lautet beispielsweise:

      svcutil.exe https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc?wsdl

Nächster Schritt

Verwenden Sie den Business Data Catalog Definition Editor, um eine Anwendungsdefinitionsdatei für das Oracle E-Business Suite-Artefakt zu erstellen. Anweisungen finden Sie unter Schritt 2: Erstellen einer Anwendungsdefinitionsdatei für die Oracle E-Business Suite Artifacts. Die Anwendungsdefinitionsdatei gibt an, wo die LOB-Daten gespeichert werden und in welchem Format sie gespeichert werden.

Weitere Informationen

Tutorial: Präsentieren von Daten aus der Oracle E-Business Suite auf einer SharePoint-Website