Erstellen eines externen Inhaltstyps aus einer OData-Quelle in SharePoint

In diesem Artikel erfahren Sie, wie Sie Visual Studio 2012 verwenden, um eine veröffentlichte OData-Quelle zu erkennen und einen wieder verwendbaren externen Inhaltstyp für die Verwendung in Business Connectivity Services (BCS) in SharePoint zu erstellen.

Voraussetzungen für das Erstellen von OData-basierten externen Inhaltstypen

Zum Erstellen eines externen Inhaltstyps aus einer Open Data-Protokollquelle (OData) benötigen Sie Folgendes:

• Eine Instanz von SharePoint

• Visual Studio 2012

• Office Developer Tools für Visual Studio 2012

• Einen veröffentlichten OData-Dienst, der über das Internet verfügbar ist

Informationen zum Einrichten Ihrer SharePoint-Entwicklungsumgebung finden Sie unter Einrichten einer allgemeinen Entwicklungsumgebung für SharePoint.

Kernkonzepte für das Arbeiten mit externen OData-Inhaltstypen

Die folgenden Artikel enthalten Informationen zu OData und dem OData-Connector in SharePoint.

Tabelle 1. Kernkonzepte für externe OData-Inhaltstypen

Erstellen eines OData-basierten externen Inhaltstyp

Die folgenden Schritte zeigen, wie Sie Visual Studio 2012 zum Erstellen eines externen Inhaltstyps auf der Basis einer OData-Quelle verwenden.

So erstellen Sie ein neues SharePoint-Add-In

1. Erstellen Sie in Visual Studio 2012 ein neues App für SharePoint-Projekt, das sich unter dem Knoten SharePoint-Vorlage befindet.

2. Benennen Sie Ihr Projekt, und wählen Sie OK aus.

3. Geben Sie zum Angeben der Einstellungen für SharePoint einen Namen für Ihre App und die URL des SharePoint-Servers ein, den Sie für das Debuggen verwenden.

4. Wählen Sie Fertig stellen aus.

Nachdem das Projekt erstellt wurde, verwenden Sie das neue Tool für die automatische Generierung für OData-Quellen, und fügen Sie Ihrer App ein BDC-Modell für die OData-Quelle hinzu.

So fügen Sie ein neues BDC-Modell hinzu

1. Öffnen Sie im Projektmappen-Explorerdas Kontextmenü für das Projekt, und wählen Sie Hinzufügen und Inhaltstypen für externe Datenquelle aus.

   Damit wird ein Assistent gestartet, der Ihnen hilft, die ausgewählte Datenquelle zu ermitteln und das BDC-Modell zu erstellen.

2. Auf der ersten Seite des Assistenten wird die URL des Datendiensts ermittelt. Geben Sie auf der Seite OData-Quelle angeben die URL des OData-Diensts ein, mit dem Sie eine Verbindung herstellen möchten. Die URL sollte etwa folgendermaßen aussehen: http://services.odata.org/Northwind/Northwind.svc/.

   Hinweis

   Sie zeigen den Northwind-Dienst an, der in der Liste der Produzenten auf der Open Data Protocol-Website verfügbar ist.

3. Wählen Sie einen Namen für Ihre OData-Datenquelle, und wählen Sie dann Weiter.

4. Eine Liste von Datenentitäten, die von dem OData-Dienst verfügbar gemacht werden, wird angezeigt. Wählen Sie eine oder mehrere der Entitäten und dann Fertig stellen aus.

So zeigen Sie die Struktur der Entitäten an

• Beachten Sie, dass Visual Studio einen neuen Ordner namens „Externe Inhaltstypen" erstellt hat. In diesem Ordner finden Sie einen Unterordner mit dem Namen der neuen Datenquelle. Wenn Sie diesen weiter erweitern, sehen Sie ein Element, das die von Ihnen ausgewählte Entität darstellt. Zum Anzeigen einer grafischen Übersicht über die Entitäten und deren Typen öffnen Sie die ECT-Datei, die Sie anzeigen möchten.

  Sie können auch den XML-Code der Entitäten anzeigen, indem Sie die ECT-Dateien in einem XML-Editor öffnen.

Verwenden eines StreamAccessors für die OData-Quelle

Mit dem folgenden Code können Sie auf einen Datenstrom zugreifen, den der OData-Connector verwenden kann.

/*Invoke  Stream Accessor Method */
        internal void ExecuteStreamAccessorMethod(IEntityInstance entityInstance, string streamAccessorName)
        {
            this.Log.Comment("ExecuteStreamAccessorMethod enter");
            this.Log.Comment("streamAccesor method" + streamAccessorName);
            IStreamableField isf = entityInstance.GetStreamableField(streamAccessorName);
            Stream resStream = isf.GetData();
            using (BinaryReader reader = new BinaryReader(resStream))
            {
                using (FileStream fs = File.Create(@"C:\\" + entityInstance.GetIdentity().GetIdentifierValues()[0] + ".jpg"))
                {
                    int bytesRead = 0;
                    do
                    {
                        int nrBytes = 80 * 1000 * 1000;
                        byte[] streamData = new byte[nrBytes];
                        bytesRead = reader.Read(streamData, 0, nrBytes);
                        this.Log.Comment("Total Bytes Read - " + bytesRead);
                        if (bytesRead > 0)
                        {
                            fs.Write(streamData, 0, bytesRead);
                        }
                    } while (bytesRead > 0);
                }
            }
            isf.Dispose();
            this.Log.Comment("ExecuteStreamAccessorMethod Exit" );
        }

Nächste Schritte

Nachdem Sie einen externen Inhaltstyp erstellt haben, können Sie diesen verwenden, um Daten in SharePoint mithilfe der integrierten Objekte (externe Listen, Geschäftsdaten-Webparts oder benutzerdefinierter Code) zur Verfügung zu stellen.

Weitere Informationen finden Sie unter Vorgehensweise: Erstellen einer externen Liste mithilfe einer OData-Datenquelle in SharePoint.

Siehe auch

• Verwenden von OData-Quellen mit Business Connectivity Services in SharePoint

• Externe Inhaltstypen in SharePoint

• Was ist neu in Business Connectivity Services in SharePoint

• Business Connectivity Services in SharePoint