Vorgehensweise: Erstellen einer BDC-Modelldatei für einen benutzerdefinierten Konnektor in SharePoint Designer

Artikel
09/18/2014

Mit Microsoft SharePoint Designer 2010 können Sie einen externen SharePoint Server 2010-Inhaltstyp erstellen, der auf einer benutzerdefinierten Konnektorassembly basiert.

Letzte Änderung: Freitag, 8. Oktober 2010

Gilt für: SharePoint Server 2010

Dazu stellen Sie die benutzerdefinierte Konnektorassembly im BDC-Metadatenspeicher bereit und erstellen anschließend mit dem Designer für externe Inhaltstypen in SharePoint Designer 2010 einen externen Inhaltstyp, der eine Verbindung mit der benutzerdefinierten Konnektorassembly herstellt.

So stellen Sie die benutzerdefinierte Konnektorassembly im BDC-Metadatenspeicher bereit

Die benutzerdefinierte Konnektorassembly muss in einem LobSystem-Objekt im BDC-Metadatenspeicher vorhanden sein. Erstellen Sie zum Hinzufügen der Assembly zum BDC-Metadatenspeicher eine leere BDC-Modelldatei, indem Sie das folgende Markup in eine Textdatei kopieren, die anschließend als XML-Datei gespeichert werden muss.

<?xml version="1.0"?>
<Model xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
Name="ScaterMultipleFields" xmlns="https://schemas.microsoft.com/windows/2007/BusinessDataCatalog">
    <LobSystems>
        <LobSystem Name="TestSystem" Type="DotNetAssembly">
            <Properties>
                <Property Name="SystemUtilityTypeName" Type="System.String">
                         [Proxy class Type] 
                </Property>
                <Property Name="InputUriProcessor" Type="System.String">
                          [Type of class implementing ILobUri] 
                </Property>
                <Property Name="OutputUriProcessor" Type="System.String">
                          [Type of class implementing INamingContainer] 
                </Property>
            </Properties>
            <LobSystemInstances>
                <LobSystemInstance Name="TestInstance">
                    <Properties>
                        < Property Name="AuthenticationMode"
 Type="Microsoft.SharePoint.BusinessData.SystemSpecific.Db.DbAuthenticationMode">
                          PassThrough
                        </Property>
                    </Properties>
                </LobSystemInstance>
            </LobSystemInstances>      
        </LobSystem>
    </LobSystems>
</Model>

Importieren Sie das Modell gemäß den Anweisungen im Abschnitt "Importieren eines BDC-Modells" in Verwalten von BDC-Modellen auf der Microsoft TechNet-Website.
Öffnen Sie auf dem Anwendungsserver die SharePoint-Verwaltungsshell. Weitere Informationen zu diesem Tool finden Sie unter Verwalten von Dienstanwendungen mit der SharePoint 2010-Verwaltungsshell.

Führen Sie zum Abrufen des LobSystem-Objekts aus dem Verwaltungsmetadatenkatalog die folgenden Befehle aus.

C:\PS>$site=”http://YourSiteName”
C:\PS>$LobSystemName = "TestSystem"
C:\PS>$lobsys = Get-SPBusinessDataCatalogMetadataObject –BdcObjectType LobSystem –ServiceContext $site -Name $LobSystemName

Führen Sie zum Importieren der Assembly das folgende SPBusinessDataCatalogDotNetAssemblyWindows PowerShell-Cmdlet aus.
```
C:\PS>Import-SPBusinessDataCatalogDotNetAssembly -Path [Path to dll] -LobSystem $lobsys
```

So erstellen Sie mit SharePoint Designer 2010 einen externen Inhaltstyp für den benutzerdefinierten Konnektor

Öffnen Sie SharePoint Designer 2010, und erstellen Sie einen externen Inhaltstyp gemäß den Anweisungen unter Gewusst wie: Erstellen eines externen Inhaltstyps basierend auf einem Webdienst. Mit Ausnahme des Schritts "So fügen Sie eine Verbindung mit dem externen System hinzu" sind die Schritte identisch.

Führen Sie die folgenden Schritte aus, um eine .NET Framework-Assembly hinzuzufügen:
1. Klicken Sie auf Klicken Sie hier, um externe Datenquellen zu ermitteln und Vorgänge zu definieren.
2. Klicken Sie im Dialogfeld Verbindung hinzufügen auf .NET-Typ.
3. Klicken Sie im Dialogfeld Auswahl des .NET-Typs auf die Schaltfläche Durchsuchen, um das externe System im BDC-Metadatenspeicher anzugeben, das den Verweis auf die .NET-Assembly enthält, mit der Sie eine Verbindung herstellen möchten. Wählen Sie das System aus, und klicken Sie dann auf OK.
Nun sollten alle in der Assembly definierten öffentlichen .NET-Typen sowie die darin enthaltenen Methoden angezeigt werden.
Wählen Sie den Proxyklassentyp aus, der alle Methoden des externen Systems enthält. Definieren Sie die Vorgänge wie bei einem Webdienst (siehe Gewusst wie: Erstellen eines externen Inhaltstyps basierend auf einem Webdienst).
Klicken Sie auf Speichern, um die Änderungen am BDC-Metadatenspeicher zu speichern.
Wechseln Sie zur Ansicht Externe Inhaltstypen, und klicken Sie dann auf den externen Inhaltstyp, den Sie erstellt haben.
Klicken Sie im Menüband für die Serverkomponente auf BDC-Modell exportieren, und speichern Sie die Modelldatei.
Öffnen Sie die im vorherigen Schritt gespeicherte Modelldatei in einem XML-Editor, und nehmen Sie die folgenden Änderungen vor:
- Löschen Sie das Proxy-Element.
- Ändern Sie den Wert des Type-Attributs des LobSystem-Elements von DotNetAssembly in Custom.
- Fügen Sie der Modelldatei weitere gewünschte Eigenschaften hinzu.
Speichern Sie die Modelldatei.

Sie können diese Modelldatei nun für einen benutzerdefinierten Konnektor verwenden.

Siehe auch

Aufgaben

Gewusst wie: Erstellen eines externen Inhaltstyps basierend auf einem Webdienst

Weitere Ressourcen

Verwalten von Dienstanwendungen mit der SharePoint 2010-Verwaltungsshell

Verwalten von BDC-Modellen (SharePoint Server 2010)

Freigeben über