Verwenden des Oracle-Datenbankadapters mit SharePoint

Artikel
07/21/2023

Der Assistent für die Entwicklung des WCF-Adapterdiensts für Visual Studio ermöglicht die direkte Nutzung des Microsoft BizTalk-Adapters für Oracle-Datenbank und des Microsoft BizTalk-Adapters für Oracle E-Business Suite als externe Datenquelle in Microsoft SharePoint. Der Assistent zum Hinzufügen von Diensten, der dieses Feature unterstützt, wird mit der WCF-Adapterdienstvorlage zum Erstellen neuer Visual C#-Websites in Visual Studio gestartet. Die Vorlage ist im BizTalk-Adapterpaket enthalten. Sie müssen auch das Branchenadapter-SDK für Microsoft Windows Communication Foundation (WCF) installieren.

Unterstützung für SharePoint-Vorgänge

Der Assistent für die Adapterdienstentwicklung generiert einen speziellen Dienstvertrag für die Oracle-Adapter, der mit Microsoft SharePoint kompatibel ist. Der Assistent generiert einen Dienstvertrag, der die folgenden Vorgänge für die Integration des Adapters in Microsoft SharePoint enthält:

Erstellen: Wird vom CreateItem_-Vorgang unterstützt.
Lesen: Wird vom ReadItem_-Vorgang unterstützt.
Aktualisieren: Wird vom UpdateItem_-Vorgang unterstützt.
Löschen: Wird vom DeleteItem_-Vorgang unterstützt.
Abfrage: Wird vom ReadList-Vorgang unterstützt.
Zuordnen: Wird vom Associate_-Vorgang unterstützt.

Der folgende Dienstvertrag wurde mit für den Microsoft BizTalk-Adapter für Oracle-Datenbank als Beispiel generiert. Der Adapter ist für den Zugriff auf die EMP-Tabelle konfiguriert.

    [System.ServiceModel.ServiceContractAttribute()]  
    public interface ISCOTT_EMP {  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadList(System.Nullable<int> Limit);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void CreateItem(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void UpdateItem_EMPNO(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void DeleteItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] Associate_DEPTNO(System.Nullable<decimal> DEPTNO);  
}

Erstellen einer neuen Website zum Hosten der Oracle-Datenbank in IIS

Diese Schritte enthalten ein Beispiel für die Verwendung des Assistenten für die Entwicklung des WCF-Adapterdiensts, um einen neuen WCF-Webdienst zu erstellen, der den Microsoft BizTalk-Adapter für Oracle-Datenbank hosten soll. Der Dienstvertrag umfasst Vorgänge, die direkt mit SharePoint kompatibel sind. Damit sie direkt als externe Datenquelle genutzt werden kann. Der Adapter ist für die Authentifizierung bei der Oracle-Datenbank mit dem SCOTT-Konto konfiguriert. Wenn das SCOTT-Konto gesperrt ist, können Sie das Konto entsperren, indem Sie sich bei SQL Plus als SYSDBA anmelden.

<Oracle Installation Bin Directory>\Sqlplus.exe SYS AS SYSDBA

Führen Sie dann den folgenden Befehl aus:

SQL> ALTER USER scott ACCOUNT UNLOCK;

Erstellen des neuen Websiteprojekts

Öffnen Sie Visual Studio.
Wählen Sie in Visual Studio im Menü Datei die Option Neu aus, und klicken Sie dann auf Projekt.
Erweitern Sie im Dialogfeld Neues Projekt den Eintrag Andere Sprachen , und klicken Sie auf Visual C#. Suchen Sie den WCF-Adapterdienst in der Vorlagenliste, und klicken Sie darauf, um ihn auszuwählen.

Hinweis

Die Wcf-Adapterdienstvorlage ist nicht verfügbar, wenn das BizTalk Adapter Pack 2013 nicht installiert ist. Installieren Sie auf x64-Systemen sowohl die x86- als auch die x64-Versionen des BizTalk Adapter Pack 2013.
Geben Sie ScottEMP als Namen an, und klicken Sie dann auf OK. Der Assistent für die Entwicklung des WCF-Adapterdiensts wird gestartet.
Klicken Sie auf der Seite Einführung auf Weiter.
Geben Sie auf der Seite Vorgänge auswählen die OracleDBBinding-Bindung an .
Klicken Sie auf die Schaltfläche Konfigurieren . Das Dialogfeld Adapter konfigurieren wird angezeigt.
Wählen Sie auf der Registerkarte Sicherheit im Dropdownlistenfeld Clientanmeldeinformationstyp die Option Benutzername aus.
Geben Sie SCOTT als Benutzername ein, und geben Sie das richtige Kennwort für das SCOTT-Konto ein. Das Standardkennwort für das SCOTT-Konto ist tiger.
Klicken Sie auf die Registerkarte URI-Eigenschaften , und geben Sie im Feld ServerAddress die IP-Adresse oder den Hostnamen für Ihren Oracle-Server ein.
Geben Sie im Feld ServiceName den richtigen Oracle-Datenbankdienst instance Namen ein. Sie können die instance Namensinformationen aus Oracle Enterprise Manager kopieren.
Klicken Sie im Dialogfeld Adapter konfigurieren auf die Schaltfläche OK.
Klicken Sie auf der Seite Vorgänge auswählen des Assistenten auf die Schaltfläche Verbinden , und warten Sie einige Augenblicke, bis die Kategorien für die Oracle-Datenbank erstellt werden.
Nachdem die Kategorien in der Liste Kategorie auswählen hinzugefügt wurden, scrollen Sie nach unten zu SCOTT , und erweitern Sie sie. Erweitern Sie dann Tabelle, und klicken Sie auf den Emp-Tabelleneintrag .
Wählen Sie in der Liste Verfügbare Kategorien und Vorgänge alle Vorgänge in der Liste aus, und klicken Sie auf die Schaltfläche Hinzufügen . Alle Vorgänge werden der Liste Hinzugefügte Kategorien und Vorgänge hinzugefügt.
Klicken Sie auf der Seite Vorgänge auswählen auf die Schaltfläche Weiter .
Legen Sie auf der Seite Dienst- und Endpunktverhalten konfigurieren für dieses Beispiel das Verhalten UseServiceCertificate Service auf false fest. Klicken Sie dann auf die Schaltfläche Weiter .
Klicken Sie auf der Seite Dienstendpunktbindung und -adresse konfigurieren auf die Schaltfläche Übernehmen . Klicken Sie dann auf die Schaltfläche Weiter .
Klicken Sie auf der Seite Zusammenfassung auf die Schaltfläche Fertig stellen .
Klicken Sie auf die Menüoption Erstellen und dann auf Projektmappe erstellen. Überprüfen Sie, ob der Projektbuild ohne Fehler erfolgreich war.

Veröffentlichen des neuen Diensts in IIS

In diesem Beispiel veröffentlichen Sie den Adapterhostdienst auf dem lokalen IIS-Webserver.

Klicken Sie in Projektmappen-Explorer für Visual Studio mit der rechten Maustaste auf das Projekt ScottEmp, und klicken Sie auf Eigenschaften. Die Registerkarten project Designer werden angezeigt.
Klicken Sie auf die Registerkarte Web und dann auf die Option Lokalen IIS-Webserver verwenden .
Klicken Sie auf die Schaltfläche Virtuelles Verzeichnis erstellen.
Öffnen Sie einen Webbrowser mit der Dienstadresse http://localhost/ScottEmp/ISCOTT_EMP.svc. Sie sollten eine Meldung mit der Meldung "Sie haben einen Dienst erstellt" erhalten, der angibt, dass der Adapter in IIS gehostet wird.

Hinzufügen der externen Datenquelle zu einer SharePoint-Website mithilfe von SharePoint-Designer

In diesem Abschnitt wird beschrieben, wie Sie den WCF-Dienst mithilfe von SharePoint-Designer einer neuen Website als externe Datenquelle hinzufügen.

Öffnen Sie SharePoint Designer, und erstellen Sie eine neue Website.
Erweitern Sie in SharePoint Designer Navigation, und klicken Sie in der Liste Websiteobjekte auf Externe Inhaltstypen.
Klicken Sie auf die Menüschaltfläche Externer Inhaltstyp , um einen neuen externen Inhaltstyp zu erstellen.
Klicken Sie auf den Text neben Name , um den Namen des neuen externen Inhaltstyps zu bearbeiten. Geben Sie OracleEMP als Namen ein.
Klicken Sie auf den Textlink neben Externes System mit der Bezeichnung Klicken Sie hier, um externe Datenquellen und Vorgänge zu ermitteln. Dadurch wird der vorgangsbezogene Designer für den externen Inhaltstyp OracleEMP geöffnet.
Klicken Sie auf dem Ermittlungsbildschirm auf die Schaltfläche Verbindung hinzufügen .
Wählen Sie im Dialogfeld Auswahl des externen Datenquellentyps die Option WCF-Dienst aus, und klicken Sie auf die Schaltfläche OK .
Geben Sie im Dialogfeld WCF-Verbindung im Feld Dienstmetadaten-URL die Zeichenfolge ein. https://localhost/ScottEmp/ISCOTT_EMP.svc?wsdl
Geben Sie im Feld Dienstendpunkt-URL die Zeichenfolge ein. https://localhost/ScottEmp/ISCOTT_EMP.svc
Klicken Sie auf die Schaltfläche OK , um das Dialogfeld WCF-Verbindung zu schließen.
Nachdem die Datenquelleninformationen aufgefüllt wurden, erweitern Sie die https://localhost/ScottEmp/ISCOTT_EMP.svc Datenquelle, und erweitern Sie Webmethoden.
Klicken Sie mit der rechten Maustaste auf die ReadList-Webmethode , und klicken Sie auf Neuer Leselistenvorgang. Das Konfigurationsdialogfeld Liste lesen wird gestartet.
Klicken Sie im Dialogfeld Liste lesen auf Rückgabeparameter , und klicken Sie in den Datenquellenelementen auf EMPNO . Klicken Sie auf den Bezeichner Zuordnung zu.
Klicken Sie im Dialogfeld Liste lesen auf Fertig stellen .
Speichern Sie die neue externe Datenquelle, indem Sie STRG+s eingeben.

Testen der Externen Datenquellenverbindung

Klicken Sie auf der neuen Website auf die Schaltfläche Listen und Formulare erstellen . Das Dialogfeld Liste und Formular für OracleEMP erstellen wird angezeigt.
Geben Sie als Listenname OracleEMP_List ein, und klicken Sie auf die Schaltfläche OK .
Nachdem die Liste erstellt wurde, klicken Sie im Menü auf die Schaltfläche Zusammenfassungsansicht .
Klicken Sie unter Externe Listen auf OracleEMP_List .
Klicken Sie im Menü auf die Schaltfläche Vorschau im Browser , um den ReadList-Vorgang des Adapters zu testen.

Problembehandlung

Auf 64-Bit-Computern müssen Sie sicherstellen, dass auch 32-Bit-Oracle-Clientkomponenten installiert sind. Dies liegt daran, dass Visual Studio und seine Assistenten als 32-Bit-Prozess ausgeführt werden, der während der Entwicklung Zugriff auf 32-Bit-Komponenten erfordert.

Freigeben über