Types de contenus externes étendus aux compléments dans SharePoint

Article
03/21/2023

Découvrez les types de contenu externe installés ou étendus au niveau du complément dans SharePoint et vous permettent de créer des compléments SharePoint riches en données à l’aide de sources de données externes.

Vue d’ensemble des types de contenu externe étendus aux compléments dans SharePoint

Dans SharePoint 2010, vous pouvez installer et utiliser des types de contenu externe uniquement au niveau de la batterie. Cela provoque souvent des problèmes pour les développeurs, car le même pour les applications simples, un administrateur devait être impliqués en raison de droits d'accès qui sont nécessaires pour installer au niveau de la batterie de serveurs.

Dans SharePoint, les applications sont fondamentalement isolées en unités plus autonomes appelées compléments. Les compléments contiennent toutes les ressources dont ils ont besoin pour s’exécuter. Cette approche permet à une application en cours d’exécution d’être isolée des autres applications. Les avantages de cette architecture sont les suivants :

Vous pouvez créer des compléments alignés sur le nouveau modèle d’application de SharePoint.
Vous pouvez créer des compléments qui accèdent aux données externes à partir de SAP, les Netflix et les propriétaires et les autres types de données sans intervention de l'administrateur de clients.
Accès aux applications externes est gérée via Business Connectivity Services (BCS), qui fournit une interface cohérente et uniforme qui peut être utilisée par d'autres applications SharePoint.

Types de contenu externe ajouter dans-étendue de fournissent un accès à des données externes au sein d'une application.

Conditions préalables pour l'utilisation de types de contenu externe ajouter dans-étendus

La configuration requise pour le développement de types de contenu externe qui sont limitées au niveau de la macro complémentaire sont les suivantes :

Visual Studio 2012
Outils de développement Office pour Visual Studio 2012
SharePoint

Pour plus d’informations sur la configuration de votre environnement de développement SharePoint, voir Configurer un environnement de développement général pour SharePoint.

Notions de base de type de contenu externe ajouter dans-étendus

Le tableau 1 contient certains concepts clés que vous devez être familiarisé avec lorsque vous travaillez avec des types de contenu externe ajouter dans-étendue.

Tableau 1. Concepts de base pour la compréhension des types de contenu externe étendus aux compléments

Article	Description
Types de contenus externes dans SharePoint	Découvrez comment créer des types de contenu externe BCS.
Compléments	Découvrez le nouveau modèle de complément de SharePoint qui permet de créer des compléments, c’est-à-dire de petites solutions simples d’utilisation pour les utilisateurs finaux.
Commencer à créer des compléments SharePoint hébergés par SharePoint	Découvrez comment créer un base hébergée par SharePoint complément à l'aide de la Outils de développement Office pour Visual Studio 2012.

Que pouvez-vous faire avec des types de contenu externe ajouter dans-étendue ?

La raison principale à l'ajout d'un type de contenu externe add-de-étendue est pour fournir l'accès aux données externes à partir d'un complément individuel. Vous pouvez ainsi effectuer les opérations suivantes :

Limiter l'accès aux types de contenu externe à une application particulière.
Déployer des types de contenu externe au sein d'une application.

Créer des types de contenu externe ajouter dans-étendus

Le concept d'un catalogue de métadonnées basées sur le fichier a été introduit dans SharePoint 2010. Elle vous permet de spécifier un fichier qui contient le code XML nécessaires à la définition des types de contenu externe. Ce fichier peut être déployé dans un package WSP et s'applique uniquement à l'application qu'il est étendu pour. À l'aide de ce fichier de métadonnées, les types de contenu externes peuvent être limités au niveau de la macro complémentaire.

Dans SharePoint, SPListDataSource a été modifié pour ajouter une propriété qui indique l’étendue de l’application.

Cette classe sert de passerelle entre SPList et une liste externe. Utilisez le associée SPList permet de récupérer des données et des champs d'entités. Récupérer une instance de SPListDataSource à partir de la propriété HasExternalDataSource. Lorsque HasExternalDataSource n’est pas null, les données de l’objet SPList sont externes à SharePoint.

Lorsque vous souhaitez ajouter un type de contenu externe add-de-portée, cette propriété est définie à Add-in.

La propriété MetadataCatalogFileName est utilisée pour définir le fichier de modèle BDC qui contient la définition de type de contenu externe. Cette propriété peut être définie de manière déclarative ou par programme, mais pas dans l'utilisateur SharePoint (IU).

L'exemple suivant montre comment définir la propriété MetadataCatalogFileName de manière déclarative.


<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>

Remarque

[!REMARQUE] Les administrateurs de site peuvent installer des compléments qui utilisent ECT étendue de l'application, mais seuls les administrateurs SiteCollection peuvent accorder des autorisations pour les applications à utiliser les connexions BCS.

Déployer un type de contenu externe add-de-étendue dans une fonction personnalisée dans un fichier WSP

Vous pouvez inclure un modèle BDC dans un fichier WSP pour le déploiement. L'exemple suivant montre comment inclure un modèle BDC dans l'application.


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

Importante

[!IMPORTANTE] Seul un fichier de modèle BDC peut être fourni par le complément. Alors que le nom de fichier dans cet exemple est BDCMetadata.bdcm, le fichier de modèle peut être réellement est de n'importe quel nom de que votre choix dans la mesure où le nom de fichier correspond à celui de l'attribut Path du fichier de modèle BDC.

Remarque

[!REMARQUE] Seules les connexions Open Data protocol (OData) sont autorisées pour les types de contenu externes ajouter dans étendue.

Définir les informations d'identification de sécurité d'un système externe

Pour pouvoir accéder aux données sur un système externe sécurisé, vous devez configurer le modèle BDC avec les informations d'identification appropriées.

L'exemple suivant montre comment définir les informations d'identification de sécurité d'un système externe dans les types de contenu externe ajouter dans-étendus en modifiant le fichier Elements.xml de l'application.


<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>

Share via