Creación de asociaciones de tipo de contenido externo de SharePoint Server 2010 mediante SharePoint Designer 2010

SharePoint 2010

Resumen: aprenda a usar Servicios de conectividad empresarial (BCS) de Microsoft para crear asociaciones entre tipos de contenido externo en Microsoft SharePoint Designer 2010 sin usar código.

Última modificación: miércoles, 12 de enero de 2011

Hace referencia a: Business Connectivity Services | Open XML | SharePoint Designer 2010 | SharePoint Foundation 2010 | SharePoint Online | SharePoint Server 2010 | Visual Studio

En este artículo
Introducción
Asociaciones compatibles con SharePoint Designer 2010
Asociaciones no compatibles con SharePoint Designer 2010
Creación de una asociación de tipo de contenido externo basada en base de datos
Creación de una asociación inversa
Creación de asociaciones de tipo de contenido externo basadas en WCF
Conclusión
Recursos adicionales

Se aplica a:   Microsoft SharePoint Server 2010 | Microsoft SharePoint Designer 2010
Proporcionado por:   Russell Palmer, Microsoft Corporation | Goksel Genc, Microsoft Corporation

Contenido

Este artículo está dirigido a desarrolladores de soluciones de Servicios de conectividad empresarial (BCS) de Microsoft en Microsoft SharePoint Server 2010 que desean crear asociaciones entre tipos de contenido externo mediante declaración, es decir, sin usar código. En este artículo, obtendrá información sobre los tipos de asociaciones compatibles y no compatibles, y sobre cómo crear asociaciones basadas en base de datos, asociaciones inversas y asociaciones de tipo de contenido externo basadas en Windows Communication Foundation (WCF) mediante Microsoft SharePoint Designer 2010.

¿Necesita ayuda para comprender un concepto? Lea las secciones relevantes que se presentan a continuación:

Como un modelo de objeto y plataforma, Servicios de conectividad empresarial ofrece varios tipos de asociaciones diferentes. SharePoint Designer 2010Diseñador de tipos de contenido externo permite crear fácilmente un subconjunto de todos los tipos de asociaciones posibles, con compatibilidad con asociaciones de "uno a varios" en función de una clave externa.

Un ejemplo de la asociación de tipo "uno a varios" es la relación entre una banda musical y un álbum que contiene la música de la banda. Una banda puede producir varios álbumes, aunque cada álbum siempre está asociado a una banda que lo creó.

Debe haber una clave externa en el sistema externo, lo que significa que los metadatos del álbum (título, precio, fecha de lanzamiento y otra información) deben contener la información exclusiva que identifica a una banda.

Las siguientes asociaciones no son compatibles con SharePoint Designer 2010.

Asociaciones de "varios a varios" (sin claves externas)

SharePoint Designer 2010Diseñador de tipos de contenido externo no puede crear una asociación donde un elemento de un tipo no tiene información para identificar un elemento relacionado de otro tipo.

Un ejemplo de este tipo de asociación es la relación entre un género musical y un músico. El género "clásico" nunca puede contener una lista finita de todos los músicos clásicos, es sólo el nombre de la clasificación. Un músico además puede clasificarse en varios géneros: "rock", "pop", "alternativo", "clásico", etc. Para algunos negocios, puede que deba crear dicha lista.

Los usuarios deben desarrollar manualmente estas asociaciones en el código XML de los archivos de modelo de BDC mediante un editor XML o mediante otro diseñador de tipo de contenido externo como, por ejemplo, Microsoft Visual Studio 2010.

Asociaciones con varios tipos de contenido externo relacionados

SharePoint Designer 2010Diseñador de tipos de contenido externo no puede crear ni editar una asociación en donde se requieren varios tipos de contenido externo para identificar un elemento único.

Un ejemplo de esto es una reunión programada en un edificio que tiene muchas salas de reunión. Un elemento de este tipo se identifica por medio de dos elementos diferentes relacionados: "sala" y "hora". Si se especificó una sala de reunión de un edificio y luego se especificó una referencia de hora, se ha especificado la cita que se llevó a cabo en dicha sala a la hora especificada.

  1. Abra el sitio mediante SharePoint Designer 2010 y, a continuación, vaya a la vista Diseñador de tipos de contenido externo .

    Figura 1. Página de la lista Tipos de contenido externo de SharePoint Designer 2010

    Diseñador de tipos de contenido externo
  2. Cree tipos de contenido externo, que se pueden basar en una combinación de tablas, vistas, procedimientos almacenados, métodos web, métodos de Microsoft .NET Framework, etc., tal como se muestra en la figura 2.

    Figura 2. Creación de tipos de contenido externo

    Creación de tipos de contenido externo
  3. En SharePoint Designer 2010, abra el tipo de contenido externo que contiene la clave externa del tipo de contenido externo relacionado. Por ejemplo, puede crear dos tipos de contenido externo, X e Y, como se muestra en la figura 3.

    Figura 3. Dos tipos de contenido externo relacionados

    Dos tipos de contenido externo relacionados

    Si X contiene una clave externa con un valor que especifica un elemento de tipo de contenido externo Y, abra X en SharePoint Designer y vaya a Diseñador de operaciones, como se muestra en la figura 4.

    Figura 4. Diseñador de operaciones

    Diseñador de operaciones
  4. Determine la asociación que desee crear.

    Una asociación puede recuperar y mostrar los elementos de un tipo cuando se selecciona un elemento de otro tipo, según sus relaciones, como se muestra en la figura 5.

    Figura 5. Dos tipos de asociaciones en SharePoint Designer

    Dos tipos de asociaciones en SharePoint Designer

    En la mayoría de los casos, la asociación es todo lo que se necesita. (Las asociaciones inversas se explican en Creación de una asociación inversa).

    Nota Nota

    La asociación con la etiqueta Asociación de la figura 5 también se puede considerar como una asociación directa. Como se describe, normalmente es todo lo necesario para crear una asociación entre dos entidades.

  5. En Diseñador de operaciones, expanda el origen de datos en el Explorador de origen de datos.

    La creación de una asociación para las bases de datos (una conexión de origen de datos de Microsoft SQL Server) difiere ligeramente de la creación de una asociación para una conexión de tipo .NET Framework o un servicio de WCF. Este ejemplo comienza con las bases de datos y continúa con WCF en Creación de asociaciones de tipo de contenido externo basadas en WCF.

  6. Si desea crear una asociación en una tabla, haga clic con el botón secundario en la misma tabla que usó para crear las demás operaciones para ese tipo de contenido externo (consulte la figura 6).

    Figura 6. Selección de una tabla en el explorador de origen de datos

    Selección de una tabla en el explorador de orígenes de datos
  7. Haga clic en Nueva asociación.

    Se abre el Asistente para asociación que contiene una sección Propiedades de la asociación y tres secciones de parámetros : Parámetros de entrada , Parámetros de filtro y Parámetro de devolución, como se muestra en la figura 7.

    Figura 7. Asistente para la asociación

    Asistente para la asociación
  8. Ahora se le solicitará que seleccione un tipo de contenido externo relacionado. (Consulte el panel Errores y advertencias para obtener instrucciones del asistente). Haga clic en Examinar y, en el cuadro de diálogo Selección de tipo de contenido externo, seleccione el tipo de contenido externo que desee asociar con el tipo de contenido externo actual, como se muestra en la figura 8. Debe ser el tipo de contenido externo actualmente abierto en SharePoint Designer.

    Figura 8. Cuadro de diálogo Selección de tipo de contenido externo

    Cuadro de diálogo de selección de tipos de contenido externo
    Nota Nota

    El tipo de contenido externo actual le adjunta la palabra (Actual) para su orientación.

  9. Después de seleccionar un tipo de contenido externo relacionado, aparece una tabla (consulte la figura 9). Esta tabla enumera todos los identificadores que están presentes en ese tipo de contenido externo.

    Figura 9. Identificadores presentes en el tipo de contenido externo

    Identificadores presentes en el tipo de contenido externo
  10. Para que esta asociación funcione en todos los escenarios de usuario (es decir, aquellos que utilizan el Selector de tipo de contenido externo), todas las apariciones del campo Clave externa de cada operación del tipo de contenido externo actual (Leer elemento, Leer lista, Crear o Actualizar) deben estar marcadas con un identificador externo. Tal como se indica en el texto que aparece sobre la tabla en la figura 9, seleccione un campo en la lista de todos los campos en el tipo de contenido externo actual, que debe estar asignado al identificador.

    Nota Nota

    Normalmente, este campo es el campo Clave externa. Si los nombres son iguales, se asigna automáticamente y el mensaje de error desaparecerá.

  11. En la siguiente página del asistente, que se muestra en la figura 10, configure los parámetros de entrada para la asociación. En muchos casos, los nombres de los campos y las columnas son los mismos; por lo tanto, este paso es similar al paso anterior, en el que se configuran las propiedades.

    Figura 10. Página Configuración de los parámetros de entrada

    Página de configuración de los parámetros de entrada
  12. En esta página del asistente, configure la "entrada" a la asociación (por ejemplo, un elemento que se especifica o proporciona a través de un elemento web). Debe asignar el elemento de origen de datos (normalmente, la columna Clave externa) a un identificador del tipo de contenido externo relacionado como entrada para la asociación. En el panel Elementos de origen de datos del lado izquierdo, seleccione el elemento de origen de datos de la lista. En el panel Propiedades del lado derecho, active la casilla de verificación Asignar a identificador. En la lista Identificador, seleccione el identificador correspondiente, como se muestra en la figura 12.

    Para ver el nombre del tipo de contenido externo y el nombre de su identificador, consulte el panel Errores y advertencias, como se muestra en la figura 11.

    Figura 11. Panel Errores y advertencias que muestra el tipo de contenido externo y los nombres de identificadores

    Panel Errores y advertencias

    Figura 12. Selección del identificador

    Selección del identificador
  13. En la sección Parámetros de filtro, puede crear un filtro para restringir la devolución de la asociación (consulte la figura 13). Esto no es necesario y normalmente no se hace. Un ejemplo posible de uso de esta característica podría ser cuando se filtra una asociación para un Empleado y se filtra el personal a tiempo parcial del personal a tiempo completo .

    Figura 13. Página Configuración de los parámetros de filtro

    Página de configuración de los parámetros de filtro
  14. Al igual que la sección Parámetros de entrada, la sección Parámetros de devolución permite configurar la devolución de datos (por ejemplo, si se especifica un elemento de un tipo, puede configurar la lista de elementos que se devuelven y que están asociados o relacionados con ese elemento, como todos los Pedidos de un Cliente.

    En esta página, asigne el campo del tipo de contenido externo actual al identificador del tipo de contenido externo actual, si aún no lo hizo (consulte la figura 14). En algunos casos, esta página está configurada para usted.

    Figura 14. Página Configuración de parámetros de devolución

    Página de configuración de parámetros de devolución
  15. Haga clic en Finalizar para guardar el tipo de contenido externo. La asociación ahora está habilitada en los elementos web, el selector y la memoria caché.

    Figura 15. Operaciones de tipos de contenido externo

    Operaciones de tipos de contenido externo

Puede ver la asociación mediante la creación de una página de perfil, como se muestra en la figura 16.

Figura 16. Página Perfil

Página del perfil
Nota Nota

Al crear una página de perfil, la asociación se muestra en el elemento web relacionado de la lista, que se configura automáticamente en la página. En este caso, se muestran todas las encuestas de los clientes que las completaron. Si se selecciona y muestra otro cliente en la página de perfil, la lista de elementos de la encuesta cambia en consecuencia (consulte la figura 17).

Figura 17. Página de perfil del cliente y las encuestas relacionadas

Página del perfil del cliente y las encuestas relacionadas

Para crear una asociación inversa, debe tener un procedimiento almacenado. No puede crear una asociación inversa en una tabla para el tipo de contenido externo actual. Si ya ha creado una asociación, no se necesita una asociación inversa para habilitar asociaciones en elementos web y el selector.

Tenga en cuenta que una asociación es una forma de devolver varios elementos del tipo actual (el tipo de contenido externo abierto en SharePoint Designer). Sin embargo, una asociación inversa es una forma de devolver un único elemento del tipo de contenido externo relacionado (no el tipo de contenido externo en el que va a crear operaciones).

No puede crear una asociación inversa en la tabla para el tipo de contenido externo actual dado que devolvería información basada en esa tabla, que no proporciona información sobre el tipo de contenido externo relacionado. Un procedimiento almacenado puede salvar esta distancia mediante la implementación de la consulta necesaria.

La ventaja de crear una asociación inversa es que el asistente administra las asignaciones del identificador externo en las otras operaciones de tipo de contenido externo. Para obtener una lista externa sin conexión de Microsoft Outlook 2010 o Microsoft SharePoint Workspace 2010, puede crear una asociación simple [1..1] con una asociación inversa para habilitar el selector, la recuperación de elementos de la memoria caché, etc.

Un ejemplo de una asociación simple de "uno a uno" basada en clave externa es un álbum de música con la portada de un álbum.

  1. Para crear asociaciones de conexiones de servicios de WCF, sólo tiene que crear la asociación en el método web apropiado. Nuevamente, debe crear la asociación en el tipo de contenido externo que contiene la clave externa. En este ejemplo, se sabe que en los metadatos de cada producto hay una subcategoría para ese producto en particular. Por lo tanto, se abre el producto en SharePoint Designer y se crea una asociación allí.

    Por ejemplo, es posible que desee crear la asociación GetProductsofSubcategory entre lo siguiente (consulte la figura 18):

    • Producto del tipo de contenido externo (Identificador = ProductId y campo de clave externa = ProductSubcategoryKey)

    • Subcategoría del tipo de contenido externo (Identificador = ProductSubcategoryID)

    Figura 18. Creación de una nueva asociación

    Creación de una nueva asociación
  2. El resto del asistente es el mismo que en el ejemplo anterior. En este ejemplo se muestra un escenario en el que el nombre del identificador en el tipo de contenido externo relacionado (ProductSubcategoryID de la Subcategoría) es diferente al nombre del campo Clave externa en el tipo de contenido externo actual (ProductSubcategoryKey del producto).

    Nota Nota

    Dado que los nombres de ProductSubcategoryID y de ProductSubcategoryKey son diferentes, esta asociación no se puede realizar en la página Propiedades de la asociación. Debe seleccionar el campo correcto en la lista Campo , como se muestra en la figura 19.

    Figura 19. Página Propiedades de la asociación

    Página de propiedades de asociación
  3. Seleccione el campo en el tipo de contenido externo actual (Producto) que indica la clave externa para el tipo de contenido externo relacionado (Subcategoría), que es ProductSubcategoryKey. Esto se asigna al identificador ProductSubcategoryID de la Subcategoría.

    Figura 20. Selección del campo ProductSubcategoryKey en Propiedades de la asociación

    Selección del campo ProductSubcategoryKey
  4. En la página Parámetros de entrada, debe configurar la entrada para la asociación. En Errores y advertencias, el mensaje indica que se debe seleccionar un elemento de origen de datos. El elemento que seleccione debe representar al identificador de la entrada de la asociación.

    Figura 21. Selección de elementos de origen de datos en Parámetros de entrada

    Selección de elementos de origen de datos en los parámetros de entrada
  5. Nuevamente, la asociación que se está creando es GetProductsofSubcategory . La entrada de la asociación es la Subcategoría y lo que está "obteniendo" (devolución) son los Productos. Como Subcategoría es la entrada, en el panel Elementos de origen de datos, seleccione el identificador Subcategoría y asígnelo, como se muestra en la figura 22.

    Figura 22. Asignación de ProductSubcategoryID

    Asignación de ProductSubcategoryID
  6. No se pueden crear parámetros de filtro para asociaciones de tipo de contenido externo basadas en servicios de WCF, de modo que no hay ninguna página del asistente para ello. Haga clic en Siguiente para ir a la página Parámetro de devolución.

  7. Por último, para devolver los productos, debe configurar los parámetros de devolución para Producto. Como se indicó anteriormente, el identificador de Producto es ProductID. En Errores y advertencias, el mensaje de error lo guía en la asignación de este identificador, como se muestra en la figura 23.

    Figura 23. Asignación del identificador en Configuración del parámetro de devolución

    Identificador en la configuración de parámetros de devolución

    En este método web de servicios web en particular, los creadores del servicio cambiaron el nombre del elemento de origen de datos a ProductKey en lugar de ProductID, como se muestra en la figura 24.

    Nota Nota

    Ya habrá asignado las demás operaciones (por ejemplo, la operación Leer elemento) de igual forma en la página Configuración del parámetro de devolución del asistente.

    Figura 24. Operación Leer elemento

    Operación de lectura de elementos
  8. Asigne el identificador del parámetro de devolución mediante la activación de la casilla de verificación Asignar a identificador y, a continuación, seleccione el identificador de la lista Identificador como se muestra en la figura 25.

    Figura 25. Asignación del parámetro de devolución

    Asignación del parámetro de devolución
  9. Haga clic en Finalizar para guardar el tipo de contenido externo. La asociación ahora está habilitada en los elementos web, el selector y la memoria caché, como se muestra en la figura 26.

    Figura 26. Asociación habilitada

    La asociación está habilitada
  10. Nuevamente, puede crear una página de perfil para ver la asociación actual, como se muestra en la figura 27.

    Figura 27. Página de perfil que muestra la asociación actual

    Página del perfil con asociación de trabajo

Este artículo, dirigido a los usuarios experimentados de Servicios de conectividad empresarial (BCS) de Microsoft en Microsoft SharePoint Server 2010, describe cómo crear asociaciones entre tipos de contenido externo mediante declaración (es decir, sin necesidad de usar código). El artículo explica las siguientes asociaciones de tipos de contenido externo:

  • Asociaciones compatibles con Microsoft SharePoint Designer 2010

  • Asociaciones no compatibles con SharePoint Designer 2010

  • Asociaciones basadas en base de datos

  • Asociaciones inversas

  • Asociaciones basadas en Windows Communication Foundation (WCF)

Mostrar: