¿Qué es el adaptador de Windows SharePoint Services?

El adaptador de BizTalk Server para Windows SharePoint Services proporciona una integración más estrecha con Windows SharePoint Services y Microsoft Office InfoPath. En el tema siguiente se describen las características y una introducción a cómo funciona el adaptador de Windows SharePoint Services.

Características del adaptador de Windows SharePoint Services

En la lista siguiente se describen las características importantes del adaptador de Windows SharePoint Services:

• La capacidad de enviar mensajes XML y binarios de BizTalk Server a bibliotecas de documentos de SharePoint.

• Integración con InfoPath: puede transformar los mensajes XML salientes de BizTalk Server para abrirlos automáticamente en InfoPath cuando se abren desde el sitio de Windows SharePoint Services.

• Promoción de propiedades para mensajes que van a Windows SharePoint Services. Se pueden actualizar hasta 16 columnas de SharePoint con metadatos de BizTalk Server sobre el ID de instancia de orquestación similar a un mensaje, el ID de mensaje o los valores extraídos del mensaje.

• Definición de nombre de archivo basada en el contenido del mensaje y las propiedades de BizTalk Server.

• La capacidad de enviar documentos a una lista arbitraria (en lugar de a una biblioteca de documentos): en este caso, el propio documento no se almacena en Windows SharePoint Services, pero la promoción de propiedades sigue sucediendo para que se cree un nuevo elemento de lista y los valores de columna se recuperen del mensaje.

• La capacidad de recibir mensajes de cualquier vista de cualquier biblioteca de documentos y archivarlos en una biblioteca de documentos especificada mediante el nombre de archivo especificado.

• Promoción de las propiedades del adaptador de Windows SharePoint Services en BizTalk Server: la información del archivo de Windows SharePoint Services está disponible en BizTalk Server como propiedades de contexto de mensaje. Se puede acceder a las propiedades de contexto del mensaje desde canalizaciones, orquestaciones, etc. Las columnas de SharePoint personalizadas se pueden acceder a través del documento WSS.InPropertiesXml.

• Compatibilidad completa con puertos dinámicos: los adaptadores de envío pueden admitir el enlace de URI estático (definido por el usuario cuando se crea el puerto de envío) o el enlace de URI dinámico (definido por la orquestación al enviar el mensaje). Toda la información de configuración se puede definir a través de propiedades de contexto de mensaje, como WSS. Nombre de archivo y WSS. ConfigTimeout, para puertos de envío dinámicos, así como puertos de envío físicos.

• Contadores de rendimiento

Funcionamiento del adaptador de Windows SharePoint Services

El adaptador de BizTalk Server para Windows SharePoint Services consta de tres componentes principales:

• Servicio web del adaptador de Windows SharePoint Services

• Adaptador de recepción de Windows SharePoint Services

• Adaptador de envío de Windows SharePoint Services

  En el servidor de Windows SharePoint Services, el servicio web (BTSharePointAdapterWS.asmx) se instala para proporcionar acceso a las listas y bibliotecas de Windows SharePoint Services. El servicio web expone métodos para obtener, colocar, eliminar y archivar documentos de una biblioteca de SharePoint. El adaptador de recepción recupera archivos del servicio web, y el adaptador de envío los publica en él.

  En la ilustración siguiente se muestran los componentes principales del adaptador de BizTalk Server para Windows SharePoint Services que proporcionan estas funcionalidades.

  

Recepción de documentos de Windows SharePoint Services

El adaptador de recepción sondea las vistas de las bibliotecas de documentos de Windows SharePoint Services. Llama a un método web en el servidor de Windows SharePoint Services que usa el modelo de objetos de Windows SharePoint Services para examinar la biblioteca, comprobar los archivos y devolver los datos de archivo al adaptador. A continuación, el adaptador envía los archivos al Cuadro de mensajes de BizTalk Server y llama a otro método web para eliminar o archivar los archivos de Windows SharePoint Services. Para filtrar archivos en una biblioteca de Windows SharePoint Services, el adaptador sondea la biblioteca de Windows SharePoint Services a través de una vista de Windows SharePoint Services.

El enfoque centralizado (sondeo) ofrece un modelo de administración sencillo donde se realiza la configuración en el servidor de BizTalk. También ofrece un mejor rendimiento debido al hecho de que permite el procesamiento por lotes de los mensajes.

Dado que la compatibilidad con transacciones de nivel de plataforma no está disponible en Windows SharePoint Services, Servicios Web y BizTalk Server, el mecanismo de desprotección se usa para minimizar los errores asociados a las situaciones de fallo. En ciertas condiciones (es decir, los archivos se envían con éxito a la base de datos MessageBox de BizTalk Server, pero no se pueden eliminar de Windows SharePoint Services), los archivos permanecerán registrados para edición en el servidor de Windows SharePoint Services, aunque se hayan enviado a BizTalk Server. Los errores se registrarán en el registro de eventos en el servidor de BizTalk.

Envío de documentos a Windows SharePoint Services

El adaptador envía documentos a Windows SharePoint Services llamando a un método web en el servidor de Windows SharePoint Services. El adaptador especifica la dirección URL del sitio de Windows SharePoint Services, la biblioteca de documentos o la dirección URL de lista en relación con el nombre del sitio, el archivo o el elemento de lista y las propiedades promocionadas para asociar con el archivo.

Puede establecer el nombre de archivo en una cadena fija o en un nombre derivado de los datos XML del documento. Derivar el nombre puede ser muy útil para aplicar convenciones de nomenclatura estándar. El adaptador también puede establecer valores de propiedad promocionados en el archivo como valores de columna. Al igual que con los nombres de archivo, los valores de propiedad promocionados se pueden corregir o se pueden derivar de los datos XML del documento.

Importante

Las propiedades promocionadas en el adaptador de Windows SharePoint Services son diferentes a las propiedades promocionadas en BizTalk Server o propiedades promocionadas en Windows SharePoint Services.

Las propiedades promocionadas de Windows SharePoint Services se usan para hacer que los elementos XML sean visibles al examinar una biblioteca de formularios de Windows SharePoint Services. Cuando se publica un formulario de InfoPath en una biblioteca de formularios de Windows SharePoint Services, InfoPath configura la biblioteca de formularios para promover elementos clave, lo que hace que esto suceda automáticamente. Esta característica solo está disponible en Windows SharePoint Services cuando se usan bibliotecas de formularios de InfoPath (bibliotecas de documentos que almacenan formularios de InfoPath con el mismo esquema XSD y la misma solución de InfoPath).

La promoción de propiedades del adaptador de Windows SharePoint Services permite al usuario promover propiedades en Windows SharePoint Services cuando los documentos con esquemas diferentes se almacenan en la misma biblioteca de documentos.

La promoción de propiedades de BizTalk Server es un concepto similar, solo que las propiedades se hacen visibles para la orquestación como propiedades en el mensaje y no para el usuario final en la interfaz de usuario. Además, BizTalk Server admite un concepto de democión de propiedad cuando los valores de propiedad se guardan de nuevo en el documento.

Al usar el adaptador de Windows SharePoint Services con formularios y bibliotecas de formularios de InfoPath (en lugar de bibliotecas XML y de documentos arbitrarias), no es necesario establecer las propiedades promocionadas a través del adaptador de envío. En cambio, el documento se puede cambiar dentro de la orquestación (cambiando directamente el mensaje o indirectamente a través de las propiedades que serán rebajadas). Windows SharePoint Services promoverá automáticamente los valores.

Consideraciones de seguridad para el adaptador de Windows SharePoint Services

El adaptador de Windows SharePoint Services consta de subsistemas, el servicio web BTSharePointAdapterWS que se ejecuta en el sitio web de Windows SharePoint Services y el entorno de ejecución del adaptador que se ejecuta en el servidor de BizTalk server dentro del proceso de instancia de host de BizTalk Server. El tiempo de ejecución del adaptador invoca el servicio web BTSharePointAdapterWS que debe tener permisos para realizar determinadas tareas en Windows SharePoint Services. Dado que este componente se ejecuta como autor de la llamada, los permisos deben concederse al autor de la llamada. Esto significa que la instancia de host de BizTalk debe ser colaborador en el sitio de SharePoint para poder enviar y recibir mensajes de ese sitio. Los miembros del grupo hosts habilitados para SharePoint pueden invocar el servicio web BTSharePointAdapterWS. Para permitir que una instancia de host de BizTalk, que ejecute el entorno de ejecución del adaptador, interactúe con el servicio web, la cuenta de Windows de la instancia de host debe ser miembro del grupo hosts habilitados para SharePoint . Es responsabilidad del administrador agregar y quitar cuentas de este grupo, así como hacer que las cuentas de la instancia de host sean miembros del rol Colaborador de SharePoint.

Componente	Identidad del proceso	Permiso
Servicio web BTSharePointAdapterWS	Identidad del autor de la llamada	Permiso de invocación concedido al grupo de Hosts Habilitados para SharePoint
Tiempo de ejecución del adaptador	Identidad del host de BizTalk	No disponible
Modelo de objetos de Windows SharePoint Services	No disponible	El grupo Hosts habilitados para SharePoint debe ser miembro del rol Colaborador en SharePoint Services.

El programa de instalación de BizTalk Server configura los permisos en el servicio web BTSharePointAdapterWS para que solo las cuentas que sean miembros del grupo hosts habilitados para SharePoint puedan acceder a este servicio web. Si desea que los hosts ejecuten el adaptador de Windows SharePoint Services, el administrador tendrá que agregar el grupo NT asociado a ese host al grupo Hosts habilitados para SharePoint y agregar también el grupo Hosts habilitados para SharePoint al rol Colaborador de Windows SharePoint Services.

Los permisos para archivos, listas y bibliotecas de documentos de Windows SharePoint Services están restringidos mediante la seguridad de Windows SharePoint Services. Los mensajes se envían desde Windows SharePoint Services directamente a BizTalk Server. La comunicación entre el tiempo de ejecución del adaptador y el servicio web se realiza a través de HTTP o HTTPS.

El adaptador supone que el servicio web BTSharePointAdapterWS usa el mismo esquema HTTP (HTTP o HTTPS) que el sitio de Windows SharePoint Services. Esto significa que el adaptador usará HTTPS para comunicarse con el servicio web BTSSharePointAdapterWS cuando se crea el sitio de Servicios de Windows SharePoint en un sitio web de IIS seguro o usará HTTP para comunicarse con el servicio web BTSharePointAdapterWS cuando el sitio de Windows SharePoint Services se crea en un sitio web de IIS sin un certificado de servidor.

Véase también

Configurar e implementar el adaptador de Windows SharePoint Services
Configuración del adaptador de Windows SharePoint Services
Tutoriales del adaptador de Windows SharePoint Services