Instrucciones para los servicios web
Última modificación: miércoles, 07 de julio de 2010
Hace referencia a: SharePoint Foundation 2010
Los servicios web de Microsoft SharePoint Foundation proporcionados por el espacio de nombres de Microsoft.SharePoint.SoapServer incluyen métodos para obtener acceso al contenido de un sitio web, por ejemplo, para trabajar con listas o datos de sitio, así como métodos para personalizar reuniones, creación de imágenes, áreas de trabajo de documentos o búsquedas.
.gif "Nota importante") Importante |
|---|
Siempre que sea posible, se recomienda usar el nuevo modelo de objetos cliente para trabajar de forma remota con datos de SharePoint Foundation, en lugar de usar los servicios web ASP.NET heredados que se describen aquí. |
Mediante las interfaces SOAP usadas en estos servicios, los programadores de Microsoft .NET Framework obtienen modelos de objetos para crear soluciones que funcionen con SharePoint Foundation de forma remota desde una aplicación de cliente o personalizada. Las interfaces se definen a través del modelo de objetos del lado servidor del ensamblado de Microsoft.SharePoint, y su diseño está optimizado para reducir la cantidad de viajes de ida y vuelta entre el equipo cliente y el servidor.
La mayoría de los servicios web ofrecen su funcionalidad a través del directorio virtual /_vti_bin, que se asigna al directorio físico %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI del sistema de archivos. El servicio de administración web usa el directorio virtual /_vti_adm, el cual se asigna a %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ADMISAPI.
Nota
SharePoint Foundation no requiere la implementación de una versión concreta de SOAP. La respuesta de SOAP en cualquier transacción con SharePoint Foundation se administra mediante .NET Framework.
Instrucciones para usar los servicios web de ASP.NET
Puede crear un proyecto en Microsoft Visual Studio, como por ejemplo una aplicación de Windows Forms o una aplicación de consola, que use un servicio web de SharePoint Foundation para interactuar con datos de la lista y el sitio de SharePoint. Después de crear un proyecto, debe establecer una referencia al servicio web que desee implementar en el código, especificando la ruta de acceso completa al servicio web en relación con el sitio que contiene los datos.
Procedimiento para agregar una referencia a un servicio web de SharePoint Foundation en Visual Studio
En el Explorador de soluciones, haga clic con el botón secundario en Referencias y, a continuación, haga clic en Agregar referencia de servicio.
En el cuadro de diálogo Agregar referencia de servicio, haga clic en Opciones avanzadas, y en el cuadro de diálogo Configuración de referencia de servicio, haga clic en Agregar referencia web.
En el cuadro de diálogo Agregar referencia web, en Dirección URL, escriba la dirección URL absoluta para el servicio web, especificando una ruta de acceso que incluya el sitio web para el cual estará disponible el servicio web. Por ejemplo, si desea agregar una referencia al servicio web de listas, especifique una ruta de acceso en el siguiente formato:
http://MyServer/[sites/][MySite/][MySubsite/]_vti_bin/Lists.asmxSi se usan métodos en el servicio de web de administración, especifique una ruta de acceso que vaya al puerto de administración y use _vti_adm como directorio virtual, de la siguiente manera:
http://MyServer:Port_Number/_vti_adm/Admin.asmxPara obtener una lista de los servicios web ASP.NET predeterminados proporcionados por SharePoint Foundation, vea Servicios web de SharePoint Foundation 2010.
Escriba un nombre de referencia web y, a continuación, haga clic en Agregar referencia.
Creación de instancias de un servicio
Cree una instancia de un servicio web dentro del código mediante un constructor de la siguiente manera: Web_Reference.Service_NameServiceInstance = new Web_Reference.Service_Name(). referenciaWeb representa el nombre usado para la referencia al servicio web en Visual Studio y nombreServicio representa el nombre de la clase que proporciona métodos a los que se puede llamar por medio del servicio web.
Establecimiento de credenciales de usuario
Para establecer las credenciales del sistema para el contexto de seguridad actual en que se ejecuta la aplicación, agregue la siguiente línea después de la línea anterior. Esto permite autenticar al usuario o al grupo en el que se ejecuta el código pasando sus credenciales predeterminadas al servicio web desde la memoria caché de credenciales del sistema.
ServiceInstance.Credentials = System.Net.CredentialCache.DefaultCredentials
ServiceInstance.Credentials = System.Net.CredentialCache.DefaultCredentials;
Tareas de programación
Las siguientes tareas básicas de programación muestran cómo usar uno de los servicios web predeterminados proporcionados en SharePoint Foundation:
Procedimiento para agregar usuarios a un grupo
Procedimiento para devolver listas
Procedimiento para devolver elementos de lista
Procedimiento para actualizar elementos de listas
Procedimiento para personalizar áreas de trabajo de reunión mediante el servicio web Meetings
Procedimiento para eliminar una reunión de un área de reuniones
Para obtener información acerca de cómo crear un servicio web personalizado de ASP.NET que implementa el modelo de objetos del lado servidor de SharePoint Foundation, vea Tutorial: creación de un servicio web personalizado ASP.NET. Para obtener información acerca de cómo crear un servicio personalizado de WCF que implementa el modelo de objetos, que es la forma recomendada de crear un servicio web en SharePoint Foundation, vea Tutorial: Creación e implementación de un servicio personalizado de WCF en SharePoint Foundation.