Procedimiento para crear un tipo de contenido externo basado en una tabla de SQL Server

Última modificación: martes, 10 de agosto de 2010

Hace referencia a: SharePoint Server 2010

La creación de tipos de contenido externo que se conecten a Microsoft SQL Server es muy sencilla con Servicios de conectividad empresarial (BCS) de Microsoft. El Diseñador de tipos de contenido externo de Microsoft SharePoint Designer 2010 admite bases de datos de Microsoft SQL Server. Puede simplemente detectar la base de datos, apuntar a la tabla, vista o procedimiento almacenado que llevará a cabo la operación deseada y, a continuación, devolver los datos necesarios y usarlos para crear el tipo de contenido externo sin necesidad de escribir código o XML.

En este tema, aprenderá a crear un tipo de contenido externo denominado Customer basado en la tabla de clientes de la base de datos de ejemplo Northwind SQL Server 2000.

Requisitos previos

• Con el fin de simplificar este procedimiento, debe estar instalado Microsoft SQL Server 2005 o posterior en el servidor que ejecuta SharePoint Server. Si Microsoft SQL Server está instalado en otra máquina, deberá configurar el Servicio de almacenamiento seguro. Para obtener más información, vea Procedimiento para usar el servicio de almacenamiento seguro para conectarse a un sistema externo.

• La base de datos de Northwind SQL Server 2000 instalada en el servidor que ejecuta Microsoft SQL Server.

• Microsoft SharePoint Designer 2010 instalado en un equipo cliente.

Creación de un tipo de contenido externo basado en una tabla de SQL Server

SharePoint Designer 2010 requiere un sitio de SharePoint para almacenar los archivos y artefactos que genera (como listas externas) cuando se usa el Diseñador de tipos de contenido externo para crear tipos de contenido externo. Por lo tanto, como primer paso, necesita crear un sitio de SharePoint en el servidor que ejecuta SharePoint Server para almacenar los artefactos del tipo de contenido externo y abrirlo en SharePoint Designer en el cliente.

Para crear y abrir un sitio de SharePoint en SharePoint Designer

1. Busque el servidor que ejecuta SharePoint Server y cree un nuevo sitio web.

2. Escriba la dirección URL del nuevo sitio web como http://nombreDelServidor/sdksamples.

3. Seleccione cualquier plantilla de sitio, por ejemplo, Sitio en blanco.

4. Haga clic en Aceptar para crear el sitio.

5. En el equipo cliente, inicie SharePoint Designer y abra el sitio que ha creado. El sitio se debería abrir en la ventana principal de SharePoint Designer.

Observe el nuevo panel de navegación de SharePoint Designer. Este panel está diseñado para hospedar a todos los objetos de SharePoint (como listas y bibliotecas, tipos de contenido externo, páginas maestras y flujos de trabajo) que se pueden crear y editar en SharePoint Designer.

Para definir la configuración del tipo de contenido externo

1. Para crear un tipo de contenido externo, comience por hacer clic en Tipos de contenido externo.

2. En la Cinta, haga clic en el botón Tipo de contenido externo, como se muestra en la siguiente figura. Aparecerá el Diseñador de tipos de contenido externo para crear un tipo de contenido externo.

   

3. En la página Nuevo tipo de contenido externo, especifique el Nombre, Nombre para mostrar, Espacio de nombres y Tipo de elemento de Office, como se muestra en la siguiente figura. El tipo de elemento de Office seleccionado determinará el comportamiento de Outlook que se desea adjuntar al tipo de contenido externo. En este ejemplo, el tipo de contenido externo Customer se comportará como un elemento de contacto nativo al desconectarlo en Outlook. El campo de sincronización sin conexión para lista externa determina si se permitirá a los usuarios desconectar listas externas basadas en este tipo de contenido externo en Microsoft Outlook o SharePoint Workspace. En este ejemplo, acepte el valor Habilitado predeterminado.

   

Para agregar una conexión al sistema externo

1. Para especificar el origen de datos para el tipo de contenido externo, haga clic en Haga clic aquí para detectar orígenes de datos externos y definir operaciones.

2. Haga clic en el botón Agregar conexión, seleccione SQL Server en el cuadro de diálogo Selección de tipo de origen de datos externo y, a continuación, haga clic en Aceptar.

3. En el cuadro de diálogo SQL Server Connection, especifique el nombre del servidor SQL Server y escriba Northwind como el nombre de la base de datos como se muestra en la siguiente figura y, a continuación, haga clic en Aceptar.

   

4. Una vez validada la conexión al servidor que ejecuta SQL Server especificada en el paso anterior, el explorador de orígenes de datos mostrará los objetos de base de datos de la base de datos Northwind. Expanda la base de datos para ver las tablas, las vistas y los procedimientos almacenados que esta contiene. En este ejemplo, seleccione la tabla de clientes.

Ahora podrá definir las operaciones que pueden realizarse en el tipo de contenido externo Customer.

Para definir las operaciones admitidas y sus parámetros y filtros

1. Debe definir los métodos en el sistema externo que llevará a cabo la operación deseada y sus parámetros. Para una tabla de base de datos de SQL Server, esto es muy sencillo debido a que SharePoint Designer puede generar los métodos básicos automáticamente. En este ejemplo, va a crear todas las operaciones básicas para el tipo de contenido externo Customer: crear, leer elementos, actualizar, eliminar y leer listas.

   En el explorador de orígenes de datos, haga clic con el botón secundario en la tabla de clientes y, a continuación, haga clic en Crear todas las operaciones, como se muestra en la siguiente figura. Se crearán automáticamente los métodos para crear, eliminar, leer y actualizar registros de la tabla de clientes de la base de datos Northwind. En este momento, podrá seleccionar las columnas que desee exponer de la tabla de clientes y definir los parámetros.

   

   Nota

   En lugar de generar todas las operaciones básicas automáticamente, también puede crear las operaciones de forma individual mediante el uso de las diversas opciones del menú contextual. Esto puede resultar conveniente para una tabla de base de datos si no se desea permitir a los usuarios realizar todas las operaciones básicas o si la base de datos no admite ciertas operaciones. Además, el comando Crear todas las operaciones solo está disponible para tablas y vistas de SQL Server. En las vistas que abarcan varias tablas, asegúrese de que se admitan las operaciones de escritura; de lo contrario, Crear todas las operaciones dará error. Para orígenes de datos que no sean tablas (y vistas) de SQL Server (como servicios web o procedimientos almacenados de SQL Server), deberá crear cada operación de forma individual en SharePoint Designer

2. A continuación, seleccione las columnas que desea exponer, los parámetros de entrada y devolución para las operaciones y los parámetros de filtrado.

   Para configurar los parámetros, haga clic en Siguiente. El cuadro de diálogo de configuración de parámetros mostrará todas las columnas de la tabla de clientes. Observe que todas las columnas están seleccionadas de forma predeterminada. Si no son necesarias todas las columnas, anule la selección de las que no necesite. En este ejemplo, se aceptarán los valores predeterminados.

   1. Observe que el identificador de cliente es el campo seleccionado actualmente. Anule la selección de la casilla de verificación Obligatorio para evitar que los usuarios escriban el identificador de cliente en el formulario de actualización. No obstante, deje la casilla de verificación de solo lectura activada para habilitar la funcionalidad de actualización en el tipo de contenido externo. Si el campo de identificador no se establece en solo lectura, no se podrán actualizar los elementos en el sistema externo.

   2. A continuación, realice las dos configuraciones importantes siguientes. Si el tipo de contenido externo se asigna a un tipo de elemento de Outlook, asigne los campos del tipo de contenido externo a los campos del elemento de Outlook. Por ejemplo, para un elemento de contacto de Outlook, debe asignar el nombre que hay en la base de datos a la columna nombre en un contacto de Outlook; para ello, asígnelo al nombre del campo Propiedad de Office. Se asignará el campo nombre que hay en la base de datos al nmbre en el elemento de contacto de Outlook y se permitirá al campo del nombre aparecer en el campo de nombre del formulario de elementos de contacto de Outlook. En este ejemplo, primero asigne ContactName al campo FullName como se muestra en la figura. A continuación, repita este paso para los campos Address, Phone y Fax.

      

   3. Determine qué campos deben estar disponibles en el Selector de tipo de contenido externo. Si un campo debe estar disponible en el selector, seleccione el campo y active la casilla de verificación Mostrar en selector. En este ejemplo, active la casilla de verificación Mostrar en selector para los campos de nombre de contacto y de nombre de la compañía.

   Cuando termine, haga clic en Siguiente.

3. En el diálogo para la configuración de parámetros de filtrado, se definen los filtros para los datos. Los filtros ayudan a limitar los elementos externos (filas) devueltos desde la operación del origen de datos externo. Siempre se recomienda encarecidamente agregar un filtro de límite para limitar la cantidad de filas que se devolverán desde el sistema externo durante una operación de lectura. Para ello, haga clic en Parámetro para agregar filtro. En el panel de propiedades, haga clic en (Haga clic para agregar). En el cuadro de diálogo Configuración de filtro, asigne un nombre al nuevo filtro LimitFilter. En el campo Tipo de filtro, seleccione Límite. A continuación, haga clic en Aceptar.

   

   En el campo Valor predeterminado, escriba 1000 como la cantidad de filas que desea que se devuelvan desde la base de datos. Tenga en cuenta que esto limitará la cantidad de filas devueltas por una operación a solo 1000 filas. Haga clic en Siguiente.

   Nota

   Asegúrese de que el valor predeterminado especificado para el filtro de límite sea menor que 2000. Para conexiones de base de datos con más de 2000 filas, el Servicio de conectividad de datos profesionales (BDC) limita los resultados y, por lo tanto, no podrá devolver ningún dato desde el sistema externo. Si necesita devolver más de 2000 filas, un administrador deberá incrementar la cantidad predeterminada de limitaciones de peticiones en el servidor. Para obtener más información acerca de los límites de peticiones y cómo incrementarlos, consulte la guía de administradores en TechNet.

4. Haga clic en Finalizar. Se generarán todas las operaciones básicas, como se muestra en la siguiente figura.

   

5. Haga clic en el botón Guardar de la Cinta para almacenar la definición de tipo de contenido externo en el Repositorio de metadatos de BDC del servidor que ejecuta SharePoint Server. Ya ha creado correctamente un tipo de contenido externo.

El tipo de contenido externo debería estar disponible inmediatamente para todos los productos de servidor y cliente de Office para su uso por parte de las características de presentación de Servicios de conectividad empresarial y de soluciones personalizadas mediante el modelo de objetos de Servicios de conectividad empresarial. Para obtener más información, vea Procedimiento para crear listas externas en SharePoint para crear una lista externa para el tipo de contenido externo Customer que ha creado.