Schritt 2: Erstellen einer Anwendungsdefinitionsdatei für oracle E-Business Suite-Artefakte

Zeit für den Abschluss: 15 Minuten

Objektiv: Das Feature "Geschäftsdatenkatalog" in Microsoft SharePoint Server macht Daten aus Branchenanwendungen in Portale verfügbar und integriert diese. Um diese Daten in Ihre Portalwebsite zu integrieren, müssen Sie eine Anwendungsdefinitionsdatei erstellen, die Microsoft Office SharePoint Server nutzen kann.

Mit dem Tool "Geschäftsdatenkatalogdefinitions-Editor", das mit dem Microsoft Office SharePoint Server 2007 SDK verfügbar ist, können Sie eine Anwendungsdefinitionsdatei für den Geschäftsdatenkatalog erstellen. Dieses Tool generiert automatisch eine XML-Datei für die Definitionsdatei, daher müssen Sie die Datei nicht manuell in einem XML-Editor erstellen.

Der Zweck der Microsoft Office SharePoint Server-Anwendung, die Sie erstellen, ist:

• Abfragen eines Mitarbeiters in der MS_SAMPLE_EMPLOYEE Schnittstellentabelle mithilfe eines Geschäftsdatenlisten-Webparts basierend auf einem Mitarbeiternamen.

• Führen Sie eine Volltextsuche aus Microsoft Office SharePoint Server in der MS_SAMPLE_EMPLOYEE Schnittstellentabelle aus.

  Für jede dieser Anforderungen müssen Sie eine Reihe von Aufgaben im Geschäftsdatenkatalogdefinitions-Editor-Tool ausführen. Dieses Thema enthält Anweisungen zum Ausführen dieser Aufgaben.

Voraussetzungen

• Sie müssen den Geschäftsdatenkatalogdefinitions-Editor im Rahmen des Microsoft Office SharePoint Server 2007 SDK installiert haben.

• Veröffentlichen Sie den WCF-Dienst wie in Schritt 1 beschrieben: Verwenden Sie den Oracle E-Business-Adapter zum Erstellen und Veröffentlichen eines WCF-Diensts.

Herstellen einer Verbindung zum WCF LOB Service und Erzeugung einer Entität

Sie müssen eine Verbindung mit dem WCF-Dienst herstellen, um die Webdienstbeschreibungssprache (Web Services Description Language, WSDL) für den Dienst zu extrahieren. Im WSDL extrahiert der Geschäftsdatenkatalogdefinitions-Editor die Methoden. Diese Methoden können zum Erstellen von Entitäten verwendet werden. Für dieses Lernprogramm wird eine Entität erstellt.

So stellen Sie eine Verbindung mit dem WCF-Dienst her und erstellen Entitäten

1. Starten Sie den Geschäftsdatendefinitionskatalog-Editor. Klicken Sie im Startmenü auf den Microsoft Business Data Catalog Definition Editor.

2. Klicken Sie auf der Symbolleiste auf LOB-System hinzufügen.

3. Klicken Sie im Fenster "LOB-System hinzufügen" auf Mit Webdienst verbinden.

4. Geben Sie im Feld "URL " die URL für den WCF-Dienst ein. Für dieses Lernprogramm lautet die URL:

   https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc
   

   Die URL ist verfügbar, wenn Sie testen, ob der WCF-Dienst erfolgreich veröffentlicht wird, wie in Schritt 1 beschrieben: Verwenden des Oracle E-Business-Adapters zum Erstellen und Veröffentlichen eines WCF-Diensts.

5. Klicken Sie auf Verbinden.

6. Klicken Sie auf die Registerkarte " Webmethode hinzufügen ", um die im Assistenten für die Entwicklung des WCF-Adapterdiensts ausgewählten Vorgänge anzuzeigen. Die folgende Methode wird angezeigt: Select.

7. Ziehen Sie die Select-Methoden auf die Entwurfsoberfläche. Wenn Sie die Methode auf das Design Surface ziehen, wird eine Entität erstellt, und die Methode wird Teil dieser Entität.

   

8. Klicke auf OK.

9. Geben Sie im Dialogfeld „LOB-System“ einen Namen in das Feld „LOB-Systemname“ ein. Rufen Sie es in diesem Beispiel MS_SAMPLE_EMPLOYEE auf, und klicken Sie dann auf "OK".

10. Im Geschäftsdatenkatalogdefinitions-Editor wird die neu erstellte Entität als Entität0 aufgeführt. Benennen Sie die Entität in "Mitarbeiter" um. Führen Sie die folgenden Schritte aus, um die Entität umzubenennen:

    1. Erweitern Sie den Knoten MS_SAMPLE_EMPLOYEE, und erweitern Sie dann den Knoten Entities.

    2. Wählen Sie den Knoten "Entity0" aus.

    3. Geben Sie im Eigenschaftenbereich " Mitarbeiter " in das Feld "Name " ein.

       

Angeben von Benutzernamen- und Kennwortheadern für die Methoden

Beim Erstellen eines WCF-Diensts für den Auswahlvorgang in der Schnittstellentabelle MS_SAMPLE_EMPLOYEE in der Oracle E-Business Suite haben Sie den Benutzernamen und den Kennwort-Header im Rahmen der Endpunktverhaltenskonfiguration in Schritt 1 angegeben: Verwenden Sie den Oracle E-Business-Adapter zum Erstellen und Veröffentlichen eines WCF-Diensts. Sie müssen dieselben Werte für die Select-Methodeneigenschaft angeben.

So legen Sie die Header für Benutzername und Passwort für die Select-Methode fest.

1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ", und erweitern Sie dann den Knoten "Methoden ".

2. Klicken Sie auf den Auswählen-Knoten und im Eigenschaftenbereich auf die Schaltfläche mit den Auslassungspunkten (…) neben dem Eigenschaften-Feld.

3. Klicken Sie im Eigenschaftenansicht-Sammlungs-Editor-Fenster auf "Hinzufügen", und geben Sie im Eigenschaftenbereich "HttpHeaderUserName " für das Feld "Name " ein. Geben Sie "MyUserHeader" für das Feld "PropertyValue " ein. Wählen Sie "System.String " für das Feld "Typ " aus.

4. Klicken Sie im Eigenschaftenansicht-Sammlungs-Editor-Fenster auf "Hinzufügen", und geben Sie im Eigenschaftenbereich "HttpHeaderPassword " für das Feld "Name " ein. Geben Sie "MyPasswordHeader" für das Feld "PropertyValue" ein. Wählen Sie "System.String " für das Feld "Typ " aus.

   

5. Klicke auf OK.

Szenario 1: Abfrage von Mitarbeitern mithilfe eines Geschäftsdatenlisten-Webteils

Um eine Anwendungsdefinitionsdatei zu erstellen, die zum Suchen nach Mitarbeitern aus einem Geschäftsdatenlisten-Webpart und basierend auf dem Mitarbeiternamen verwendet werden kann, müssen Sie die folgenden Aufgaben ausführen.

1. Erstellen Sie in der Select-Methode einen Filter, und ordnen Sie ihn dem FILTER-Parameter zu.

2. Erstellen Sie eine Finder-Methodeninstanz für die Select-Methode . Eine Finder-Methode ruft eine Liste von Datensätzen basierend auf einem Filter ab.

So erstellen Sie einen Filter und ordnen ihn dem FILTER-Parameter zu

1. Erstellen Sie einen Filter.

   1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ", und erweitern Sie dann den Knoten "Methoden ".

   2. Erweitern Sie die Select-Methode , klicken Sie mit der rechten Maustaste auf "Filter", und klicken Sie dann auf "Filter hinzufügen".

      

   3. Wählen Sie im Eigenschaftenbereich für die FilterType-Eigenschaft"Gleich" aus.

   4. Geben Sie im Eigenschaftenbereich " EmployeeName" in das Feld "Name " ein.

      

2. Ordnen Sie den Filter dem Filterparameter in der Select-Methode zu.

   1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ", und erweitern Sie dann den Knoten "Methoden ".

   2. Erweitern Sie die Select-Methode , und erweitern Sie dann den Knoten "Parameters ".

   3. Erweitern Sie den FILTER-Knoten, und klicken Sie auf den zweiten FILTER-Knoten.

   4. Wählen Sie im Eigenschaftenbereich "EmployeeName" aus der Liste "FilterDescriptor" aus .

      

So erstellen Sie eine Finder-Methodeninstanz für die Select-Methode

1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ", und erweitern Sie dann den Knoten "Methoden ".

2. Erweitern Sie den Knoten "Auswählen ", klicken Sie mit der rechten Maustaste auf "Instanzen", und klicken Sie dann auf " Methodeninstanz hinzufügen".

   

3. Klicken Sie im Fenster "Methodeninstanz erstellen" auf "Finder " für den Methodeninstanztyp. Wählen Sie „Return“ für „Return TypeDescriptor“.

   

4. Klicke auf OK.

5. Geben Sie im Eigenschaftenbereich im Feld "Name" Finder_Instance ein.

   

Szenario 2: Full-Text Suche in der MS_SAMPLE_EMPLOYEE-Schnittstellentabelle von Microsoft Office SharePoint Server

Zum Erstellen einer Anwendungsdefinitionsdatei, die zum Ausführen einer Volltextsuche in MS_SAMPLE_EMPLOYEE Schnittstellentabelle von Microsoft Office SharePoint Server verwendet werden kann, müssen Sie die folgenden Aufgaben ausführen.

• Erstellen Sie in der Select-Methode einen Bezeichner, und ordnen Sie ihn dem FILTER-Parameter und dem Rückgabewert zu, der den Mitarbeiternamen speichert.

• Erstellen Sie eine Bestimmte Finder-Methodeninstanz für die Auswahl. Die Specific Finder-Methode findet einen bestimmten Datensatz basierend auf dem Bezeichner, d. h. einem Mitarbeiternamen.

• Erstellen Sie eine ID-Enumerator-Methodeninstanz.

Um einen Bezeichner zu erstellen und ihn dem FILTER-Parameter sowie dem Rückgabewert für den Mitarbeiternamen zuzuordnen

1. Erstellen Sie einen Bezeichner für die Mitarbeiterentität.

   1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ".

   2. Klicken Sie mit der rechten Maustaste auf den Knoten "Bezeichner" , und wählen Sie dann "Bezeichner hinzufügen" aus.

      

   3. Geben Sie im Eigenschaftenbereich " EmployeeName" in das Feld "Name " ein.

   4. Wählen Sie "System.String " für das Feld "Typ " aus.

      

2. Ordnen Sie den Bezeichner dem FILTER-Parameter für die Select-Methode zu.

   1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ", und erweitern Sie dann den Knoten "Methoden ".

   2. Erweitern Sie die Select-Methode , und erweitern Sie dann den Knoten "Parameters ".

   3. Erweitern Sie den FILTER-Parameter , und klicken Sie dann auf den zweiten FILTER-Knoten .

   4. Wählen Sie im Eigenschaftenbereich aus der Liste BezeichnerEmployeeName[Employee] aus.

      

3. Ordnen Sie den Bezeichner dem Rückgabewert für den Mitarbeiternamen zu.

   1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ", und erweitern Sie dann den Knoten "Methoden ".

   2. Erweitern Sie die Select-Methode , und erweitern Sie dann den Knoten "Parameters ".

   3. Erweitern Sie den Rückgabeknoten , dann den zweiten Rückgabeknoten , dann den Knoten "Element ", und klicken Sie dann auf den Knoten "Name ".

   4. Wählen Sie im Eigenschaftenbereich EmployeeName[Employee] aus der Bezeichnerliste aus.

So erstellen Sie eine Bestimmte Finder-Methodeninstanz für die Select-Methode

1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter " und dann den Knoten "Methoden ".

2. Erweitern Sie den Knoten "Auswählen ", klicken Sie mit der rechten Maustaste auf "Instanzen", und wählen Sie dann " Methodeninstanz hinzufügen " aus, um das Fenster "Methodeninstanz erstellen" zu öffnen.

   

3. Wählen Sie im Fenster "Methodeninstanz erstellen" die Option "Specific Finder for Method Instance Type" aus. Wählen Sie Return für den TypeDescriptor aus.

   

4. Klicke auf OK.

5. Geben Sie im Eigenschaftenbereich SpeciFinder_Instance für das Feld "Name " ein.

So erstellen Sie eine Id Enumerator-Methodeninstanz für die Select-Methode

1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter " und dann den Knoten "Methoden ".

2. Erweitern Sie den Knoten "Auswählen ", klicken Sie mit der rechten Maustaste auf "Instanzen", und wählen Sie dann " Methodeninstanz hinzufügen " aus, um das Fenster "Methodeninstanz erstellen" zu öffnen.

   

3. Wählen Sie im Fenster "Methodeninstanz erstellen" die Option "Id Enumerator " für den Methodeninstanztyp aus. Wählen Sie Rückgabe für Rückgabetyp aus.

   

4. Klicke auf OK.

5. Geben Sie im Eigenschaftenbereich IDEnumerator_Instance für das Feld "Name " ein.

Festlegen von Standardparametern für die Methodeninstanzen

Für die Select-Methode müssen Sie die Spaltennamen angeben. Daher müssen Sie einen Standardwert für den parameter COLUMN_NAMES für die zuvor erstellten Instanzen der Finder-, Specific Finder- und Id-Enumerator-Methode angeben. Darüber hinaus sollten Sie auch einen Standardwert für den FILTER-Parameter für die Id Enumerator-Methodeninstanz angeben.

So legen Sie die Standardparameter für die Methodeninstanzen fest

1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten " Mitarbeiter ", und erweitern Sie dann den Knoten "Methoden ".

2. Erweitern Sie den Knoten "Auswählen" , und erweitern Sie dann den Knoten "Parameter ".

3. Erweitern Sie den knoten COLUMN_NAMES , und wählen Sie dann den parameter COLUMN_NAMES aus.

4. Klicken Sie im Eigenschaftenbereich auf die Schaltfläche mit den Auslassungspunkten (...) gegen das Feld "Standardwerte".

5. Klicken Sie im Dialogfeld "DefaultValueView-Sammlungs-Editor" auf "Hinzufügen", und klicken Sie im Eigenschaftenbereich in der Liste "SelectMethodInstance" auf Finder_Instance.

   

6. Geben Sie * im Feld "Wert" ein.

7. Wiederholen Sie auch die Schritte 5 und 6, um Standardwerte für die Instanzen der SpecificFinder_Instance und IDEnumerator_Instance Methoden hinzuzufügen.

8. Klicken Sie im Dialogfeld "DefaultValueView-Sammlungs-Editor " auf "OK".

9. Fügen Sie als Nächstes einen Standardwert für den FILTER-Parameter für die IDEnumerator_Instance Methodeninstanz hinzu. Erweitern Sie den Knoten FILTER , und wählen Sie dann den FILTER-Parameter aus.

10. Klicken Sie im Eigenschaftenbereich auf die Schaltfläche mit den Auslassungspunkten (…) neben dem Feld „Standardwerte“.

11. Klicken Sie im Dialogfeld "DefaultValueView-Sammlungs-Editor" auf "Hinzufügen", und klicken Sie im Eigenschaftenbereich in der Liste "SelectMethodInstance" auf IDEnumerator_Instance.

12. Geben Sie % in die Box "Wert" ein.

    

13. Klicken Sie im Dialogfeld "DefaultValueView-Sammlungs-Editor " auf "OK".

Einrichten von Single Sign-On für die Verbindung mit Oracle E-Business Suite

Nachdem Sie alle Verfahren in diesem Thema ausgeführt haben, haben Sie eine Anwendungsdefinitionsdatei erstellt, die in eine SharePoint-Anwendung importiert werden kann. Aus der Anwendung rufen Sie die Methoden auf, um relevante Daten aus Oracle E-Business Suite abzurufen. Um dies zu aktivieren, müssen Sie eine Zuordnung zwischen einem Benutzer in der Oracle E-Business Suite und dem Benutzer in der SharePoint-Anwendung erstellen. Sie erstellen diese Zuordnung in der SharePoint-Zentraladministrationskonsole, nachdem Sie die Anwendungsdefinitionsdatei importiert haben.

Zum Erstellen der Zuordnung müssen Sie jedoch eine Eigenschaft SecondarySsoApplicationId im Geschäftsdatenkatalogdefinitions-Editor festlegen.

So legen Sie die SecondarySsoApplicationId-Eigenschaft fest

1. Erweitern Sie im Bereich "Metadatenobjekte" den Knoten MS_SAMPLE_EMPLOYEE , und erweitern Sie dann den Knoten "Instanzen ".

2. Klicken Sie auf MS_SAMPLE_EMPLOYEE_Instance, und klicken Sie im Eigenschaftenbereich auf die Schaltfläche mit den Auslassungspunkten (...) im Feld "Eigenschaften".

3. Klicken Sie im Dialogfeld "PropertyView-Sammlungs-Editor " auf "Hinzufügen", und geben Sie im Eigenschaftenbereich "SecondarySsoApplicationId " für das Feld "Name " ein. Geben Sie auch OracleSSO für das Feld "PropertyValue" ein. Wählen Sie "System.String " für das Feld "Typ " aus.

   

4. Klicke auf OK.

Exportieren der Anwendungsdefinition in eine Datei

Sie haben jetzt eine Anwendungsdefinition erstellt, die Oracle E-Business Suite-Instanzmetadaten enthält. Sie müssen diese Definition in eine XML-Datei exportieren, die in Microsoft Office SharePoint Server importiert werden kann.

So exportieren Sie die Anwendungsdefinition in eine Datei

1. Klicken Sie im Bereich "Metadatenobjekte" mit der rechten Maustaste auf den knoten MS_SAMPLE_EMPLOYEE , und klicken Sie dann auf "Exportieren".

2. Speichern Sie die Datei als Employee.xml.

Nächste Schritte

Sie müssen jetzt eine SharePoint-Anwendung erstellen, um Daten aus Oracle E-Business Suite abzurufen. Anweisungen finden Sie in Schritt 3: Erstellen einer SharePoint-Anwendung zum Abrufen von Daten aus Oracle E-Business Suite.

Siehe auch

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