Uso del modelo de objetos de lista de SharePoint y el modelo de objetos de cliente de SharePoint con listas externas

Última modificación: jueves, 15 de abril de 2010

Hace referencia a: SharePoint Server 2010

En este artículo
Ventajas de usar el modelo de objetos de lista de SharePoint y el modelo de objetos de cliente
Limitaciones de usar el modelo de objetos de lista de SharePoint y el modelo de objetos de cliente
Aspectos que debe conocer cuando usa el modelo de objetos de lista con listas externas

Los datos externos que se exponen a través de los Servicios de conectividad empresarial (BCS) de Microsoft pueden manipularse mediante programación, a través de los siguientes modelos de objetos:

• El modelo de objetos de BDC, disponible en el servidor y el cliente.

• El modelo de objetos de Microsoft SharePoint 2010, que consiste en la clase SPList del modelo de objetos del lado servidor en el espacio de nombres Microsoft.SharePoint y su clase List equivalente del modelo de objetos del lado cliente en los espacios de nombres Microsoft.SharePoint.Client y Microsoft.SharePoint.Client.Silverlight.

En la tabla 1 se resumen los modelos de objetos disponibles.

Tabla 1. Modelos de objetos de cliente y de servidor de SharePoint disponibles

Modelo de objetos	Servidor	Cliente	Descripción
Modelos de objetos de BDC	Sí	Sí	Proporciona una biblioteca de espacios de nombres suministrados por los Servicios de conectividad empresarial. Está presente en SharePoint Foundation 2010, SharePoint Server 2010 y Office Professional Plus 2010. El modelo de objetos de BDC realiza operaciones de creación, lectura, actualización y eliminación (CRUD) a través de un tipo de contenido externo en los datos de sistema externo del servidor y el cliente de forma simétrica.
Clase SPList (modelo de objetos del lado servidor)	Sí	No	Representa una lista en un sitio web de SharePoint. (Microsoft.SharePoint.dll) La clase SPList se basa en el modelo de objetos de BDC para realizar operaciones CRUD en una lista externa desde el servidor.
Modelo de objetos del lado cliente	No	Sí	Representa las API de cliente de SharePoint Foundation 2010 para interactuar con sitios de SharePoint desde aplicaciones administradas de Microsoft .NET Framework, aplicaciones de Microsoft Silverlight y ECMAScript (JavaScript, JScript) que se ejecuta en el explorador. Las API proporcionan una forma de interactuar con datos de SharePoint desde un equipo remoto, mediante la recuperación de un objeto de contexto de cliente para obtener acceso a los objetos de cliente en el nivel de una colección de sitios o inferior. (Microsoft.SharePoint.Client.dll y Microsoft.SharePoint.Client.Silverlight.dll). El modelo de objetos del lado cliente se basa en la clase SPList para realizar operaciones CRUD desde el cliente a través de los servicios web de SharePoint.

El siguiente diagrama de arquitectura muestra qué modelos de objetos están presentes en el servidor y el cliente, cómo interactúan entre sí y con otros componentes de los Servicios de conectividad empresarial, y cómo interactúan con las soluciones creadas mediante los Servicios de conectividad empresarial.

Figura 1. Modelos de objetos en el servidor y el cliente

Puede elegir en qué punto de entrada de pila programar en el cliente o en el servidor. Sin embargo, la clase SPList tiene limitaciones, y si se producen, puede usar las API de nivel inferior en el modelo de objetos de BDC que manipulan los tipos de contenido externo reales.

Ventajas de usar el modelo de objetos de lista de SharePoint y el modelo de objetos de cliente

A continuación se enumeran las ventajas de usar los modelos de objetos de cliente y de lista de SharePoint.

• Modelo de objetos sencillo y conocido. El modelo de objetos de lista de SharePoint (clase SPList) es fácil de usar y resulta conocido para los programadores de SharePoint.

• Disponibilidad. El modelo de objetos de BDC solo está disponible en un cliente con Office Professional Plus 2010 instalado. Sin embargo, el modelo de objetos de SharePoint está disponible en el servidor y el cliente.

• Se ejecuta en un entorno de confianza parcial. El modelo de objetos de SharePoint se puede ejecutar en un entorno de confianza parcial. Esto no ocurre con los modelos de objetos de BDC.

Limitaciones de usar el modelo de objetos de lista de SharePoint y el modelo de objetos de cliente

A continuación se enumeran las limitaciones de usar los modelos de objetos de cliente y de lista de SharePoint.

• Requiere listas externas. Los modelos de objetos de cliente y de lista de SharePoint realizan operaciones CRUD en una lista externa desde el servidor. Por lo tanto, requieren la creación de una lista externa en el servidor. El modelo de objetos de BDC no tiene este requisito, ya que realiza operaciones CRUD directamente a través de un tipo de contenido externo.

• Solo funciona para tipos simples compatibles. Los modelos de objetos de cliente y de lista de SharePoint funcionan solo si la lista externa tiene campos simples. Por diseño, las listas externas son representaciones de datos planas, basadas en filas. Se omiten los tipos complejos y los tipos simples que no son compatibles con el sistema de tipos de lista de SharePoint. En concreto, no puede tener campos de los siguientes tipos:

  1. Tipos complejos  Por ejemplo, un campo "DirecciónDeCliente" como parte de la estructura "Cliente", que a su vez tiene elementos secundarios que definen "Calle", "Ciudad", "Estado" y "CódigoPostal".

  2. Tipos personalizados   Por ejemplo, un campo "Reanudar" como parte de la estructura "Candidato", que podría no tener elementos secundarios, pero que no se puede representar mediante uno de los tipos de campo de lista de SharePoint admitidos.

  3. Tipos de .NET no admitidos  Los siguientes tipos de .NET Framework no son compatibles con listas externas: System.GUID, System.Object, System.URI, System.UInt64 y System.Int64. Por lo tanto, si uno de los campos de la lista externa es uno de los tipos de .NET Framework enumerados aquí, se omitirá.

  El modelo de objetos de BDC no tiene este requisito y puede funcionar con todos los tipos de campos complejos mencionados aquí.

• No se admiten las características avanzadas de BDC.  Los modelos de objetos de cliente y de lista de SharePoint no admiten las siguientes características avanzadas compatibles con BDC:

  1. Paginación  Las listas externas no proporcionan paginación o fragmentación de datos.

  2. Operaciones masivas  Las listas externas no pueden realizar operaciones masivas, por ejemplo, leer 25 instancias simultáneamente.

  3. Transmisión por secuencias  No hay compatibilidad con transmisión por secuencias de datos, como objetos binarios grandes (BLOB) de sistemas externos.

  4. Asociaciones complejas  Las listas externas no son compatibles con asociaciones.

Aspectos que debe conocer cuando usa el modelo de objetos de lista con listas externas

• BdcIdentity es un campo del objeto de lista de SharePoint que representa la identidad de un elemento de lista específico. Se trata de la única manera determinista para identificar solamente un elemento de lista en particular. Se puede obtener mediante el uso de la colección Campos del objeto SPList. Vea Fragmentos de código: uso del modelo de objetos de lista de SharePoint con listas externas en el servidor y Fragmentos de código: Uso del modelo de objetos de cliente de SharePoint con listas externas para ver algunos ejemplos.

• ItemID para elementos de lista externa siempre es cero. En su lugar debe usar BdcIdentity.

• Cuando use el modelo de objetos de cliente de SharePoint con listas externas, deberá recordar algunos aspectos adicionales. Vea Fragmento de código: obtención de datos de elemento de una lista externa en el cliente para obtener más información.

Vea también

Conceptos

Establecimiento del contexto para el uso de los modelos de objetos de BDC

Otros recursos

Fragmentos de código: uso del modelo de objetos de lista de SharePoint con listas externas en el servidor

Fragmentos de código: Uso del modelo de objetos de cliente de SharePoint con listas externas

Fragmentos de código del modelo de objetos de Servicios de conectividad empresarial