Crear un tipo de contenido externo a partir de una fuente de OData en SharePoint

  • Artículo

Aprenda a usar Visual Studio 2012 para descubrir un origen OData publicado y crear un tipo de contenido externo reutilizable para usarlo en Servicios de conectividad empresarial (BCS) de SharePoint.

Requisitos previos para crear tipos de contenido externo basados en OData

Para poder crear un tipo de contenido externo a partir de un origen del protocolo Open Data (OData), necesitará lo siguiente:

  • Una instancia de SharePoint

  • Visual Studio 2012

  • Office Developer Tools para Visual Studio 2012

  • Un servicio OData publicado y disponible a través de Internet.

Para obtener información sobre cómo configurar el entorno de desarrollo de SharePoint, vea Configurar un entorno de desarrollo general para SharePoint.

Nota:

[!NOTA] SharePoint Designer 2013 no se puede usar para generar automáticamente modelos de conectividad a datos profesionales desde un origen de OData. Puede usar Visual Studio 2012 en su lugar.

Conceptos básicos para trabajar con tipos de contenido externo OData

Los siguientes artículos ofrecen información sobre OData y el conector OData en SharePoint.

Tabla 1. Conceptos básicos para tipos de contenido externo OData

Título del artículo Descripción
Uso de orígenes OData con Servicios de conectividad empresarial en SharePoint
Comience a crear tipos de contenido externo basados en orígenes OData y aprenda cómo usar esos datos en componentes de SharePoint u Office.
Tipos de contenido externo en SharePoint
Aprenda sobre los tipos de contenido externo de BCS y elementos necesarios para empezar a crearlos en SharePoint.

Crear un tipo de contenido externo basado en OData

Las instrucciones siguientes muestran cómo usar Visual Studio 2012 para crear un tipo de contenido externo basado en un origen OData.

Para crear un nuevo complemento de SharePoint

  1. En Visual Studio 2012, cree un nuevo proyecto Aplicación para SharePoint, que está ubicado bajo el nodo Plantilla de SharePoint.

  2. Asigne un nombre al proyecto y seleccione Aceptar.

  3. Para especificar la configuración de SharePoint, escriba un nombre para la aplicación y la URL del servidor de SharePoint con el que va a depurar.

  4. Seleccione Finalizar.

Después de crear el proyecto, use la nueva herramienta de autogeneración para orígenes OData y agregue a su aplicación un modelo BDC para el origen OData.

Para agregar un modelo BDC nuevo

  1. En Explorador de soluciones, abra el menú contextual del proyecto y elija Agregar, Tipos de contenido para origen de datos externos.

    Esto inicia un asistente que le ayudará a descubrir el origen de datos seleccionado y crear el modelo BDC.

  2. La primera página del asistente se usa para recopilar la URL del servicio de datos. En la página Especificar origen OData, escriba la URL del servicio OData al que desea conectarse. La URL debe tener un aspecto similar a: http://services.odata.org/Northwind/Northwind.svc/.

    Nota:

    Mostrará el servicio Northwind que está disponible en la lista de productores que se encuentra en el sitio web de Open Data Protocol.

  3. Elija un nombre para el origen OData y después seleccione Siguiente.

  4. Aparecerá una lista de entidades de datos que expone el servicio OData. Seleccione una o varias entidades y elija Finalizar.

Para ver la estructura de las entidades

  • Tenga en cuenta que Visual Studio creada una nueva carpeta denominada tipos de contenido externo. Dentro de esa carpeta, encontrará una subcarpeta con el nombre del nuevo origen de datos. Si expandir aún más esto, verá un elemento que representa la entidad seleccionada. Para ver una lista de las entidades y sus tipos de gráfica, abra el archivo de ect que desea ver.

    También podrá ver el XML de las entidades si abre los archivos ect en un editor XML.

Usar un descriptor de acceso de secuencia para el origen OData

Mediante el siguiente código, se puede tener acceso a una secuencia de datos que puede usar el conector OData.


/*Invoke  Stream Accessor Method */
        internal void ExecuteStreamAccessorMethod(IEntityInstance entityInstance, string streamAccessorName)
        {
            this.Log.Comment("ExecuteStreamAccessorMethod enter");
            this.Log.Comment("streamAccesor method" + streamAccessorName);
            IStreamableField isf = entityInstance.GetStreamableField(streamAccessorName);
            Stream resStream = isf.GetData();
            using (BinaryReader reader = new BinaryReader(resStream))
            {
                using (FileStream fs = File.Create(@"C:\\" + entityInstance.GetIdentity().GetIdentifierValues()[0] + ".jpg"))
                {
                    int bytesRead = 0;
                    do
                    {
                        int nrBytes = 80 * 1000 * 1000;
                        byte[] streamData = new byte[nrBytes];
                        bytesRead = reader.Read(streamData, 0, nrBytes);
                        this.Log.Comment("Total Bytes Read - " + bytesRead);
                        if (bytesRead > 0)
                        {
                            fs.Write(streamData, 0, bytesRead);
                        }
                    } while (bytesRead > 0);
                }
            }
            isf.Dispose();
            this.Log.Comment("ExecuteStreamAccessorMethod Exit" );
        }

Pasos siguientes

Después de que haya compilado un tipo de contenido externo, puede usarlo para presentar datos dentro de SharePoint con los objetos integrados (listas externas, elementos web de datos empresariales o código personalizado).

Para obtener más información, vea How to: Create an external list using an OData data source in SharePoint (Cómo: Crear una lista externa mediante un origen de datos de OData en SharePoint).

Vea también