¿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 siguiente tema se describen las características del adaptador de Windows SharePoint Services, así como una descripción general de su funcionamiento.
Características del adaptador de Windows SharePoint Services
En la siguiente lista se describen importantes características del adaptador de Windows SharePoint Services:
Capacidad para enviar mensajes binarios y XML de BizTalk Server a las bibliotecas de documentos de SharePoint.
Integración con InfoPath: puede transformar mensajes XML de BizTalk Server salientes para que se abran automáticamente en InfoPath cuando se abran desde el sitio de Windows SharePoint Services.
Promoción de propiedades para mensajes dirigidos a Windows SharePoint Services. Se pueden actualizar hasta 16 columnas de SharePoint con metadatos de BizTalk Server con respecto al Id. de instancia de orquestación de apariencia de mensaje, Id. de mensaje o a los valores extraídos del mensaje.
Definición de nombre de archivo basada en el contenido de mensajes y en 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 se sigue produciendo para que se cree un nuevo elemento de lista y los valores de columna se recuperen del mensaje.
Capacidad para recibir mensajes desde cualquier vista de cualquier biblioteca y archivarlos en una biblioteca de documentos concreta utilizando el nombre de archivo especificado.
Promoción de las propiedades del adaptador de Windows SharePoint Services en BizTalk Server: Windows SharePoint Services información del archivo está disponible en BizTalk Server como propiedades de contexto del mensaje. Se puede obtener acceso a las propiedades de contexto de mensaje a partir de canalizaciones, orquestaciones, etc. Se puede obtener acceso a las columnas de SharePoint personalizadas mediante el 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 mediante las propiedades de contexto de mensaje, como WSS.Filename y WSS.ConfigTimeout, tanto para puertos de envío dinámicos como para 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 presenta métodos para obtener documentos, colocarlos, eliminarlos y archivarlos desde una biblioteca de SharePoint. El adaptador de recepción recupera archivos desde el servicio Web, mientras que el adaptador de envío le envía archivos.
En la ilustración siguiente se muestran los componentes principales del adaptador de BizTalk Server para Windows SharePoint Services que proporcionan estas funcionalidades.
Recibir documentos desde Windows SharePoint Services
El adaptador de recepción efectúa un sondeo de las vistas de bibliotecas de documentos de Windows SharePoint Services. Efectúa una llamada al método Web del servidor de Windows SharePoint Services que utiliza el modelo de objetos de Windows SharePoint Services para examinar la biblioteca, desproteger los archivos y devolver los datos del archivo al adaptador. Seguidamente, el adaptador envía los archivos al cuadro de mensajes de BizTalk Server y efectúa una llamada a otro método Web para eliminar o archivar los archivos desde Windows SharePoint Services. Para filtrar los archivos en una biblioteca de Windows SharePoint Services, el adaptador realiza un sondeo de la biblioteca de Windows SharePoint Services mediante una vista de Windows SharePoint Services.
El enfoque centralizado (de sondeo) ofrece un modelo de administración sencillo en el que la configuración se efectúa en el servidor BizTalk Server. También ofrece un mejor rendimiento gracias al hecho de que permite procesar los mensajes por lotes.
Puesto que la compatibilidad de transacción de nivel de plataforma no se encuentra disponible en la totalidad de Windows SharePoint Services, de los servicios Web y de BizTalk Server, el mecanismo de desprotección se utiliza para minimizar los errores asociados a las condiciones de error. En ciertas condiciones (esto es, cuando los archivos se envían correctamente a la base de datos de cuadro de mensajes de BizTalk Server pero no se pueden eliminar de Windows SharePoint Services), los archivos permanecerán desprotegidos en el servidor de Windows SharePoint Services aun cuando se hayan enviado al servidor BizTalk Server. Los errores se recogerán en el registro de sucesos del servidor BizTalk Server.
Enviar 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, de la biblioteca de documentos o de la dirección URL de la lista relacionada con el nombre del elemento de lista, de archivo o de sitio, así como con las propiedades promocionadas que asocian al archivo.
Se puede establecer el nombre de archivo como una cadena fija o como un nombre derivado de los datos XML del documento. La derivación del nombre puede resultar muy útil para forzar las convenciones de denominación estándar. El adaptador también puede establecer valores de propiedades promocionadas en el archivo como valores de columna. Al igual que ocurre con los nombres de archivo, los valores de propiedades promocionadas se pueden establecer o pueden derivar de los datos XML del documento.
Importante
Las propiedades promocionadas del adaptador de Windows SharePoint Services son entidades distintas a las propiedades de BizTalk Server o a las propiedades promocionadas de Windows SharePoint Services.
Las propiedades promocionadas de Windows SharePoint Services se utilizan para hacer que los elementos XML resulten visibles cuando se examina 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 automáticamente. Esta característica se encuentra disponible en Windows SharePoint Services únicamente al utilizar las bibliotecas de formularios de InfoPath (bibliotecas de documentos que almacenan formularios de InfoPath con el mismo esquema XSD y la misma solución InfoPath).
La promoción de propiedades del adaptador de Windows SharePoint Services permite al usuario promocionar propiedades en Windows SharePoint Services cuando en la misma biblioteca de documentos se almacenan documentos con esquemas diferentes.
La promoción de propiedades de BizTalk Server es un concepto parecido, con la diferencia de que las propiedades se hacen visibles para la orquestación como propiedades en el mensaje, y no en la UI para el usuario final. Además, BizTalk Server admite un concepto de degradación de propiedades cuando los valores de éstas se vuelven a guardar en el documento.
Al utilizar el adaptador de Windows SharePoint Services con las bibliotecas de formularios y los formularios de InfoPath (en lugar de con bibliotecas de documentos y XML arbitrarias), no necesita establecer las propiedades promocionadas mediante el adaptador de envío. En lugar de eso, el documento se puede cambiar en la orquestación (directamente cambiando el mensaje, o indirectamente, a través de propiedades que se degradarán). Windows SharePoint Services promocionará los valores automáticamente.
Consideraciones de seguridad para el adaptador de Windows SharePoint Services
El adaptador de Windows SharePoint Services se compone de subsistemas, del servicio Web BTSharePointAdapterWS que se ejecuta en el sitio Web de Windows SharePoint Services y del tiempo de ejecución del adaptador que se ejecuta en el servidor BizTalk Server en el proceso de instancia de host de BizTalk Server. El tiempo de ejecución del adaptador invoca el servicio Web BTSharePointAdapterWS, que debe contar con permisos para efectuar ciertas tareas en Windows SharePoint Services. Puesto que este componente se ejecuta como autor de la llamada, hay que conceder los permisos 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. El servicio web BTSharePointAdapterWS solo los miembros del grupo hosts habilitados para SharePoint pueden invocarlo. Para permitir que una instancia de host de BizTalk, que ejecute el tiempo 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 de proceso | Permiso |
|---|---|---|
| Servicio Web BTSharePointAdapterWS | Identidad del autor de la llamada | El permiso de invocación se le concede al grupo Hosts habilitados de SharePoint. |
| Tiempo de ejecución del adaptador | Identidad del host de BizTalk | N/D |
| Modelo de objetos de Windows SharePoint Services | N/D | El grupo hosts habilitados para SharePoint debe ser miembro del rol Colaborador en SharePoint Services. |
BizTalk Server programa de instalación configura los permisos en el servicio web BTSharePointAdapterWS para que solo las cuentas que sean miembros del grupo hosts habilitados para SharePoint puedan tener acceso 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 con respecto a las bibliotecas de documentos, listas y archivos de Windows SharePoint Services se restringen utilizando 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 establece mediante HTTP o HTTPS.
El adaptador asume que el servicio Web BTSharePointAdapterWS utiliza el mismo esquema HTTP (HTTP o HTTPS) que el sitio de Windows SharePoint Services. Esto significa que el adaptador utilizará HTTPS para comunicarse con el servicio Web BTSSharePointAdapterWS cuando el sitio de Windows SharePoint Services se cree en un sitio Web de IIS seguro, o que utilizará HTTP para comunicarse con el servicio Web BTSharePointAdapterWS cuando el sitio de Windows SharePoint Services se cree en un sitio Web de IIS sin un certificado de servidor.
Consulte también
Configuración e implementación del adaptador de Windows SharePoint Services
Configuración del adaptador de Windows SharePoint Services
Tutoriales del adaptador de Windows SharePoint Services