Add-in-bezogenen externen Inhaltstypen in SharePoint

Artikel
03/21/2023

Erfahren Sie mehr über externe Inhaltstypen, die installiert oder auf der Ebene-Add-Ins in SharePoint ausgelegt sind, und aktivieren Sie reichhaltige SharePoint-Add-Ins mit externen Datenquellen erstellen.

Übersicht über die add-in-bezogenen externen Inhaltstypen in SharePoint

In SharePoint 2010 können Sie installieren und Verwenden von externen Inhaltstypen nur auf Farmebene. Daraufhin wird häufig Probleme für Entwickler, da auch für einfache Applications Administrator beteiligten aufgrund der Zugriffsrechte sein, die erforderlich sind musste, um auf Farmebene zu installieren.

In SharePoint werden Anwendungen im Grunde in autonomere Einheiten isoliert, die als Add-Ins bezeichnet werden. Add-Ins enthalten alle Ressourcen, die sie zum Ausführen benötigen. Dieser Ansatz ermöglicht es, eine ausgeführte Anwendung von anderen Anwendungen zu isolieren. Diese Architektur bietet folgende Vorteile:

Erstellen Sie add-ins, die an das neue Anwendungsmodell des SharePoint ausgerichtet werden.
Erstellen Sie add-ins, die Zugriff auf externe Daten von SAP, Netflix, und proprietäre und andere Typen von Daten ohne im Zusammenhang mit der mandantenadministrator.
Zugriff auf externe Anwendungen wird durch Business Connectivity Services (BCS), beibehalten, die eine konsistente und einheitliche Benutzeroberfläche bereitstellt, die von anderen SharePoint-Anwendungen verwendet werden kann.

Add-in-bezogenen externe Inhaltstypen ermöglichen den Zugriff auf externe Daten in einer app.

Erforderliche Komponenten für die Arbeit mit der add-in-bezogenen externen Inhaltstypen

Im folgenden sind die Anforderungen für die Entwicklung von externen Inhaltstypen, die auf der Ebene der Add-in-Bereich haben:

Visual Studio 2012
Office Developer Tools für Visual Studio 2012
SharePoint

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

Add-in-bezogenen externen Inhaltstyp essentials

Tabelle 1 enthält einige wichtige Konzepte, denen Sie mit vertraut beim Arbeiten mit der add-in-bezogenen externen Inhaltstypen sein sollten.

Tabelle 1. Kernkonzepte für das Verständnis von add-in-bereichsbezogenen externen Inhaltstypen

Artikel	Beschreibung
Externe Inhaltstypen in SharePoint	Erfahren Sie, wie BCS externen Inhaltstypen erstellen.
SharePoint-Add-Ins	In diesem Artikel erfahren Sie mehr über das neue Add-In-Modell in SharePoint, das Sie zur Erstellung von Add-Ins verwenden können, die einfache, benutzerfreundliche Lösungen für Endanwender darstellen.
Erste Schritte beim Erstellen von von SharePoint gehosteten SharePoint-Add-Ins	Informationen Sie zur Erstellung eines einfachen SharePoint-Hosting add-Ins mithilfe der Office Developer Tools für Visual Studio 2012.

Was können Sie mit der add-in-bezogenen externen Inhaltstypen?

Der Hauptgrund für das Hinzufügen eines Add-in-bezogenen externen Inhaltstyps ist für den Zugriff auf externe Daten aus einer einzelnen-Add-in. Hiermit können Sie folgende Aktionen ausführen:

Einschränken des Zugriffs auf externe Inhaltstypen zu einer bestimmten app.
Bereitstellen von externen Inhaltstypen in einer app.

Erstellen von add-in-bezogenen externen Inhaltstypen

Das Konzept eines Katalogs dateibasierten Metadaten wurde in SharePoint 2010 eingeführt. Es können Sie angeben, dass eine Datei mit dem XML benötigt, um externe Inhaltstypen zu definieren. Diese Datei in eine WSP-Paket bereitgestellt werden kann und bezieht sich nur auf die Anwendung, der sie für ausgelegt ist. Mithilfe dieser Metadatendatei können externe Inhaltstypen auf die-Add-in-Ebene beschränkt.

In SharePoint wurde SPListDataSource geändert, um eine Eigenschaft hinzuzufügen, die den Bereich der Anwendung angibt.

Diese Klasse dient als die Brücke zwischen SPList und einer externen Liste. Verwenden Sie die zugeordneten SPList Entitätsfelder und Daten abgerufen. Eine Instanz des SPListDataSource aus der HasExternalDataSource -Eigenschaft abrufen. Wenn HasExternalDataSource nicht null ist, ist das SPList -Objekt Daten außerhalb SharePoint.

Wenn Sie einen Add-in-bezogenen externen Inhaltstyp hinzufügen möchten, ist diese Eigenschaft auf Add-infestgelegt.

Die MetadataCatalogFileName -Eigenschaft wird verwendet, um die BDC-Modelldatei zu definieren, die die Definition des externen Inhaltstyps enthält. Diese Eigenschaft kann deklarativ oder programmgesteuert definiert werden, aber nicht in der SharePoint-Benutzeroberfläche (UI).

Im folgenden Beispiel wird veranschaulicht, wie die MetadataCatalogFileName -Eigenschaft deklarativ festgelegt.


<DataSource>
  <Property Name="Entity" Value="Customer" />
  <Property Name="EntityNamespace" Value="SAP" />
  <Property Name="LobSystemInstanceName" Value="SAPClient1" />
  <Property Name="SpecificFinder" Value="ReadCustomer" />
  <Property Name=" MetadataCatalogFileName" Value="BDCMetadata.bdcm" />
</DataSource>

Hinweis

Websiteadministratoren können Add-Ins installieren, die App-bezogene externe Inhaltstypen verwenden, nur SiteCollection-Administratoren können jedoch Apps Berechtigungen zum Verwenden von BCS-Verbindungen gewähren.

Bereitstellen eines Add-In-bezogenen externen Inhaltstyps in einer benutzerdefinierten Funktion in einer WSP-Datei

Sie können ein BDC-Modell in eine WSP-Datei für die Bereitstellung einschließen. Im folgenden Beispiel wird veranschaulicht, wie ein BDC-Modell in der app werden soll.


<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <BdcModel Path="BDCMetadata.bdcm">
  </BdcModel>
</Elements>

Wichtig

Es kann nur eine BDC-Modelldatei pro Add-In verwendet werden. In diesem Beispiel lautet der Dateiname BDCMetadata.bdcm, der Modelldateiname kann beliebig sein, solange dieser dem Dateinamen im Path-Attribut der BDC-Modelldatei entspricht.

Hinweis

Nur Open Data Protocol (OData)-Verbindungen sind für Add-In-bezogene externe Inhaltstypen zulässig.

Festlegen von Sicherheitsanmeldeinformationen für ein externes System

Um Daten für eine sichere externe System zugreifen zu können, müssen Sie das BDC-Modell mit den entsprechenden Anmeldeinformationen konfigurieren.

Im folgenden Beispiel wird gezeigt, wie durch Bearbeiten der Datei "Elements.xml" der app Sicherheitsanmeldeinformationen für ein externes System add-in-bezogenen externen Inhaltstypen festgelegt.


<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <BdcModel Path="BDCMetadata.bdcm">
    <LobSystem Name="SAP">
       <LobSystemInstance Name="SAPInst" RequireCredentials="true" CredentialsDescription="Credentials to connect to SAP"/>
    </LobSystem>
    <LobSystem Name="SQL">
       <LobSystemInstance Name="App Database" DataSource="SQL-Azure" RequireCredentials="true" />
    </LobSystem>
  </BdcModel>
</Elements>