Instrucciones para los servicios web
Los servicios web de Windows SharePoint Services 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.
Mediante las interfaces SOAP usadas en estos servicios, los programadores de Microsoft .NET Framework obtienen modelos de objetos para crear soluciones que funcionen con Windows SharePoint Services de forma remota desde una aplicación de cliente o personalizada. Las interfaces se definen a través del modelo de objetos del servidor del ensamblado de Microsoft.SharePoint y su diseño está optimizado para reducir el número 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 \\Program Files\Common Files\Microsoft Shared\web Server extensions\12\ISAPI del sistema de archivos. El servicio de administración web usa el directorio virtual /_vti_adm, el cual se asigna a \12\ADMISAPI.
Nota
Windows SharePoint Services no requiere la implementación de una versión concreta de SOAP. La respuesta de SOAP en cualquier transacción con Windows SharePoint Services se administra mediante .NET Framework.
Instrucciones
Puede crear un proyecto en Microsoft Visual Studio 2005, como por ejemplo una aplicación Windows o de consola, que use un servicio web de Windows SharePoint Services para interactuar con los datos de la lista y el sitio de SharePoint. Para obtener información general sobre cómo crear un proyecto en Visual Studio que funcione en el contexto de Windows SharePoint Services, consulte Introducción a la personalización mediante programación de un sitio web de SharePoint en Visual Studio. 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 Windows SharePoint Services en Visual Studio
En el Explorador de soluciones, haga clic con el botón secundario del mouse en Referencias y, a continuación, en Agregar referenciaWeb.
En el cuadro de diálogo Agregar referencia web, en Dirección URL, escriba la dirección URL absoluta para el servicio web en el formato siguiente: una ruta de acceso que incluya el sitio web para el cual estará disponible el servicio web.
http://MyServer/[sites/][MySite/][MySubsite/]_vti_bin/Web_Service.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_admcomo directorio virtual de la siguiente manera:http:// MyServer:Port_Number/_vti_adm/Admin.asmxEscriba 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_Name.Service_Name ServiceInstanceName = new Web_Reference _Name.Service_Name();
Web_Reference_Name representa el nombre usado para la referencia al servicio web en Visual Studio y Service_Name representa el nombre de la clase que proporciona métodos a los que se puede llamar a través 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 que ejecuta el código pasando sus credenciales predeterminadas al servicio web desde la memoria caché de credenciales del sistema.
ServiceInstanceName.Credentials = System.Net.CredentialCache.DefaultCredentials
ServiceInstanceName.Credentials = System.Net.CredentialCache.DefaultCredentials;
Tareas de programación
Las tareas de programación siguientes muestran cómo usar un servicio web en Windows SharePoint Services:
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 eliminar una reunión de un área de reuniones