Tutorial: Desarrollar una aplicación personalizada mediante Excel Web Services

  • Artículo

En el tutorial de esta sección se describe el proceso que hay que seguir para tener acceso a Servicios web de Excel desde una aplicación creada con Microsoft Visual C#.

Durante este tutorial aprenderá a:

  • Crear una aplicación cliente con la plantilla de proyecto Aplicación de consola de Visual Studio.

  • Agregar una referencia web para Servicios web de Excel.

  • Escribir código para obtener acceso al servicio web. Aprenderá a abrir un libro, obtener el identificador de la sesión, pasar las credenciales predeterminadas, obtener información de la versión del servicio web, definir el objeto de coordenadas de rango, obtener el rango que usa el objeto de coordenadas de rango, cerrar el libro y captar la excepción de SOAP.

  • Probar y ejecutar la aplicación de consola en modo de depuración.

Una aplicación de consola cliente es una de las formas de obtener acceso al servicio web. Una forma más habitual consistiría en usar aplicaciones de servidor, como aplicaciones Microsoft ASP.NET. En este tutorial se usa un ejemplo de aplicación de consola por motivos de sencillez, para centrarse en los aspectos de la API de Servicios web de Excel.

Requisitos previos

Para poder completar este tutorial, necesitará:

  • Microsoft SharePoint Server 2010.

  • Visual Studio o una herramienta de desarrollo similar compatible con Microsoft .NET Framework.

  • Permisos suficientes (como mínimo, permisos para "ver") para poder tener acceso a Servicios web de Excel en el equipo en el que se encuentra SharePoint Server 2010.

    Nota:

    Para obtener más información acerca de los permisos de los libros, consulte la sección siguiente, "Permisos de libro".

  • Un libro de ejemplo instalado en una unidad de disco local o en la biblioteca de documentos de SharePoint local.

  • Una ubicación de confianza para almacenar los libros a los que desea obtener acceso con Servicios web de Excel. Si los libros no se almacenan en una ubicación de confianza, se producirán errores en las llamadas de Servicios web de Excel para abrir el libro. En este tutorial se da por supuesto que el libro se encuentra en el equipo local.

    Nota:

    Para obtener información sobre cómo confiar en una ubicación, vea Cómo: Confiar en una ubicación y Cómo: Confiar en las ubicaciones del libro mediante script.

  • Crear el libro mediante Excel.

  • Guardar el libro como archivos .xlsx o .xlsb.

El libro usado en este ejemplo tiene una hoja de cálculo denominada "Sheet1". La hoja de cálculo tiene 11 columnas y 19 filas. Cada una de las celdas desde A1 a K19 contiene un valor numérico; por ejemplo, 4245,955, 6960,673, etc.

Permisos del libro

  • Para obtener todo el libro (por ejemplo, llamando al método GetWorkbook), el llamador necesita permisos para abrir el libro.

  • No son necesarios permisos para llamar al método GetApiVersion.

  • Para el resto de los métodos de Servicios web de Excel, el llamador necesita permisos para ver (en Microsoft SharePoint Foundation) o leer (en un recurso compartido de archivos) el libro.

    Nota:

    Para obtener más información sobre la configuración de permisos, consulte la documentación de SharePoint Foundation.

Vea también