Compartir a través de

Uso de la API de REST de Servicios de Excel 2010

  • Artículo

Pancarta de inicio rápido de SharePoint
Introducción al desarrollo de Web en SharePoint 2010: Aprenda a usar la API de REST de servicios de Excel para acceder a elementos y trabajar con datos en una hoja de cálculo.

Última modificación: jueves, 27 de enero de 2011

Hace referencia a: Excel Services | Office 2010 | SharePoint Foundation 2010 | SharePoint Server 2010 | Visual Studio 2010

En este artículo
Descubrimiento de elementos en un libro
Recuperación de varios elementos en formatos diferentes
Cambio de los valores de datos
Pasos siguientes

Se aplica a:   Microsoft SharePoint Foundation 2010 | Microsoft SharePoint Server 2010
Publicado:   septiembre de 2010
Proporcionado por:    Frank Rice, Microsoft Corporation

La API de REST 2010 de Servicios de Excel es un nuevo marco de programación que permite el descubrimiento fácil de los datos y los objetos en una hoja de cálculo, y el acceso a estos. Si puede escribir una dirección URL, puede usar la API de REST. Esto permite a quienes no son programadores acceder a la API de REST y, además, ofrece capacidades que la convierten en una poderosa herramienta para los programadores profesionales. En este escenario, verá varios ejemplos del uso de la API de REST para acceder a objetos y trabajar con datos en un libro de un sitio de SharePoint 2010. Para completar este escenario, siga estos pasos:

  • Descubrimiento de elementos en un libro

  • Recuperación de varios elementos en formatos diferentes

  • Cambio de los valores de datos

En este escenario, se supone que existe un libro llamado Sales_Report.xlsx guardado en una biblioteca de documentos de un sitio de SharePoint 2010. El libro contiene dos rangos, un gráfico, una tabla y una tabla dinámica.

Descubrimiento de elementos en un libro

En esta tarea, se usa la API de REST para descubrir varios objetos en el libro de muestra. Suponga que el libro está ubicado en http://miServidor/miSitioWeb/shared%20documents/Sales_Report.xlsx.

Para descubrir elementos en el libro

  1. Abra el sitio web que contiene el libro en un explorador.

  2. En la dirección URL que se encuentra en el cuadro de dirección del explorador, agregue _vti_bin/ExcelRest.aspx/ después del nombre del sitio web para que la dirección URL tenga un aspecto similar al del ejemplo siguiente.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx

  3. Después del nombre del libro, agregue la palabra Model. La dirección URL debe ser similar al ejemplo siguiente.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model

  4. Presione ENTRAR. Después de unos segundos, el explorador devuelve una página similar a la de la figura 1 en un formato de fuente ATOM.

    Figura 1. La API de REST devuelve esta página web

    La API de REST devuelve esta página web

Actualmente, la API de REST puede acceder a rangos, gráficos, tablas y tablas dinámicas. La API de REST devuelve elementos en los formatos siguientes:

  • Imagen

  • HTML

  • Fuente ATOM

  • Libro de Excel

Recuperación de varios elementos en formatos diferentes

En esta tarea, se escriben las direcciones URL con la notación de API de REST que devuelve varios elementos. Se pueden usar los elementos devueltos en páginas web, blogs, comunidades wiki; insertar gráficos activos como imagen vinculada en un documento de Word 2010, una presentación de PowerPoint 2010 o un mensaje de correo de Outlook 2010; crear mashups que usan Servicios de Excel para cálculos, creación de gráficos y como fuentes de datos.

Para recuperar los elementos del libro

  1. Abra un explorador web y, en el cuadro de dirección, escriba la siguiente dirección URL y, a continuación, presione ENTRAR.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Ranges

    Verá la página web que se muestra en la figura 2. Observe que se muestran los nombres de cuatro rangos especificados.

    Figura 2. Listas de rangos

    Listas de rangos

  2. En el cuadro de dirección del explorador, anexe lo siguiente a la dirección URL inmediatamente después de la palabra Ranges y, a continuación, presione ENTRAR. Esto muestra los datos del rango RegionalSalesSummary como HTML (consulte la figura 3).

    ('RegionalSalesSummary')?$format=HTML

    Figura 3. Datos de resumen de ventas regionales

    Datos de resumen de ventas regionales

  3. Descubrir los gráficos y las tablas, y acceder a ellos, también es simple. Escriba la siguiente dirección URL en el explorador y observe que el gráfico ResellerSalesChart se muestra como una imagen (consulte la figura 4).

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Sales%20Reports/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?$format=image

    Figura 4. Gráfico de ventas por revendedor

    Gráfico de ventas por revendedor

  4. Además de los rangos especificados, también puede devolver rangos regulares. La dirección URL siguiente devuelve el rango de A1 a D4 en la Hoja2.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Ranges(‘Sheet2!A1|D4’)?$format=HTML

    Recuerde que debe reemplazar los dos puntos en la notación de estilo de A1 para los rangos con un carácter de barra vertical.

Cambio de los valores de datos

La API de REST proporciona una forma de cambiar valores en el libro. Estos cambios solo afectan a los valores, a la información de representación en HTML o a los gráficos que devuelve la API de REST para esa solicitud en particular. Estos cambios no se guardan en el libro ni afectan a otras sesiones de explorador de API de REST o de Excel Web Access. En esta tarea, se escribe una dirección URL que cambiará los datos de venta para el tipo de revendedor Cadena de venta directa de $167.690 a $0 para ver el efecto en el Gráfico de ventas por revendedor. Antes del cambio, el gráfico (y el valor de la Cadena de venta directa) se asemeja a la figura 5.

Figura 5. Gráfico de ventas por revendedor antes del cambio

Gráfico de ventas por revendedor antes del cambio

Para cambiar los valores de datos en un gráfico

  1. Cambie la dirección URL del explorador a la siguiente, presione ENTRAR y observe el cambio realizado en el valor de Cadena de venta directa en la figura 6.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0

    Figura 6. Gráfico de ventas por revendedor después del cambio

    Gráfico de ventas por revendedor después del cambio

  2. También puede colocar valores en distintas celdas usando la siguiente dirección URL.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellersSalesChart')?Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011

  3. Además, puede colocar valores en distintas celdas y especificar el formato para cada una, o ambas tareas, usando las siguientes direcciones URL, respectivamente

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011?$format=HTML

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0&?format=HTML&Ranges('FiscalYear')=2011

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?$format=HTML&Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011

Pasos siguientes