Agregar en ámbito tipos de contenido externo en SharePoint
Obtenga información sobre los tipos de contenido externo instalados o con ámbito en el nivel de complemento en SharePoint y le permiten crear complementos de SharePoint con datos enriquecidos mediante orígenes de datos externos.
Introducción a los tipos de contenido externo con ámbito de complemento en SharePoint
En SharePoint 2010, puede instalar y usar tipos de contenido externo sólo en el nivel de granja de servidores. A menudo esto causa problemas para los desarrolladores porque incluso para las aplicaciones sencillas, un administrador tenía que estar involucradas debido a los derechos de acceso que son necesarios para instalar en el nivel de granja de servidores.
En SharePoint, las aplicaciones se aíslan básicamente en unidades más autónomas denominadas complementos. Los complementos contienen todos los recursos que necesitan para ejecutarse. Este enfoque permite que una aplicación en ejecución se aísle de otras aplicaciones. Las ventajas de esta arquitectura son las siguientes:
Puede crear complementos que estén alineados con el nuevo modelo de aplicación de SharePoint.
Puede crear complementos que tienen acceso a datos externos de SAP, Netflix y propietario y otros tipos de datos sin necesidad del Administrador de inquilinos.
Se mantiene el acceso a las aplicaciones externas a través de Servicios de conectividad empresarial (BCS), que proporciona una interfaz coherente y uniforme que puede ser usada por otras aplicaciones de SharePoint.
Tipos de contenido externos de agregar en ámbito proporcionan acceso a datos externos de una aplicación.
Requisitos previos para trabajar con tipos de contenido externos de agregar en ámbito
Los siguientes son los requisitos para el desarrollo de tipos de contenido externo que tengan un ámbito en el nivel de complemento:
Visual Studio 2012
Office Developer Tools para Visual Studio 2012
SharePoint
Para obtener información sobre cómo configurar el entorno de desarrollo de SharePoint, vea Configurar un entorno de desarrollo general para SharePoint.
Conceptos básicos de agregar en el ámbito de tipo de contenido externo
La tabla 1 contiene algunos conceptos básicos que debería estar familiarizado con frecuencia al trabajar con tipos de contenido externos de agregar en ámbito.
Tabla 1. Conceptos básicos para comprender los tipos de contenido externo con ámbito de complemento
| Artículo | Descripción |
|---|---|
| Tipos de contenido externo en SharePoint |
Obtenga información sobre cómo crear tipos de contenido externo de BCS. |
| Complementos de SharePoint |
Obtenga información sobre el nuevo modelo de complementos de SharePoint, que permite crear complementos (pequeñas soluciones fáciles de usar para usuarios finales). |
| Introducción a la creación de complementos de SharePoint hospedados en SharePoint |
Aprenda a crear un básico hospedada en SharePoint complemento mediante el Office Developer Tools para Visual Studio 2012. |
¿Qué puede hacer con tipos de contenido externos de agregar en ámbito?
La razón principal para agregar un tipo de contenido externo agregar en el ámbito es proporcionar acceso a datos externos desde un complemento individual. Esto le permite hacer lo siguiente:
Limitar el acceso a los tipos de contenido externo para una aplicación determinada.
Implementar tipos de contenido externo dentro de una aplicación.
Crear tipos de contenido externos de agregar en ámbito
El concepto de un catálogo de metadatos basados en el archivo se introdujo en SharePoint 2010. Permite especificar un archivo que contiene el XML que se necesita para definir tipos de contenido externo. Este archivo se puede implementar dentro de un paquete WSP y se aplica sólo a la aplicación que lo tenga el ámbito de. Mediante el uso de este archivo de metadatos, se pueden restringidos el nivel de agregar tipos de contenido externo.
En SharePoint, SPListDataSource se ha modificado para agregar una propiedad que indica el ámbito de la aplicación.
Esta clase actúa como puente entre los SPList y una lista externa. Use el asociado SPList para recuperar datos y campos de entidad. Recuperar una instancia de SPListDataSource de la propiedad HasExternalDataSource. Cuando HasExternalDataSource no es null, los datos del objeto SPList son externos a SharePoint.
Cuando desea agregar un tipo de contenido externo agregar en el ámbito, esta propiedad se establece a Add-in.
La propiedad MetadataCatalogFileName se usa para definir el archivo de modelo de conectividad a datos profesionales que contiene la definición de tipo de contenido externo. Esta propiedad puede definirse de forma declarativa o mediante programación, pero no en el usuario de SharePoint de la interfaz (IU).
En el ejemplo siguiente se muestra cómo establecer la propiedad MetadataCatalogFileName mediante declaración.
<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>
Nota:
[!NOTA] Los administradores de sitios pueden instalar complementos que use ECT con ámbito de aplicación, pero sólo los administradores de SiteCollection pueden conceder permisos para las aplicaciones a utilizar las conexiones de BCS.
Implementar un complemento en el ámbito tipo de contenido externo en una característica personalizada en un archivo WSP
Puede incluir un modelo de conectividad a datos profesionales en un archivo WSP para la implementación. En el ejemplo siguiente se muestra cómo incluir un modelo BDC en la aplicación.
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
<BdcModel Path="BDCMetadata.bdcm">
</BdcModel>
</Elements>
Importante
[!IMPORTANTE] Solo un archivo de modelo de conectividad a datos profesionales pueden incluir por el complemento. Aunque el nombre de archivo en este ejemplo es BDCMetadata.bdcm, el archivo de modelo realmente puede ser cualquier nombre que elija siempre que coincide con el nombre de archivo que está en el atributo Path del archivo del modelo de conectividad a datos profesionales.
Nota:
[!NOTA] Se permiten conexiones de sólo Open Data protocol (OData) para agregar en el ámbito de tipos de contenido externo.
Establecer las credenciales de seguridad para un sistema externo
Con el fin de obtener acceso a datos en un sistema externo protegido, debe configurar el modelo de conectividad a datos profesionales con las credenciales apropiadas.
En el ejemplo siguiente se muestra cómo establecer las credenciales de seguridad para un sistema externo en tipos de contenido externos de agregar en ámbito modificando el archivo Elements.xml de la aplicación.
<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>