Compartir a través de

Tutorial: Módulo 1: Envío y recepción de mensajes con el adaptador de Windows SharePoint Services

  • Artículo

Este tutorial le muestra cómo configurar Windows SharePoint Services y BizTalk Server para que pueda enviar y recibir mensajes mediante el adaptador de Windows SharePoint Services y el enrutamiento por contenidos (CBR). El enrutamiento por contenidos elimina la necesidad de suscribir mensajes para los mensajes enlazados de forma determinista a puertos específicos. Asimismo, proporciona flexibilidad adicional para los usuarios que deseen enrutar los mensajes según las propiedades del sobre o simplemente según las propiedades de configuración del puerto de recepción. Para obtener una introducción al adaptador de Windows SharePoint Services, consulte ¿Qué es el adaptador de Windows SharePoint Services?.

Requisitos previos

A continuación, se enumeran los requisitos previos para efectuar los procedimientos de este tema:

Configurar Windows SharePoint Services

En este procedimiento, se creará un sitio Web de nivel superior de SharePoint que contiene tres bibliotecas de documentos. El adaptador de Windows SharePoint Services utiliza estas bibliotecas para trasladar un mensaje a una biblioteca de destino desde una biblioteca de origen. Este mensaje también se archiva en una biblioteca de documentos. Este procedimiento resulta necesario para proporcionar el sitio de Windows Sharepoint Services al que tiene acceso el adaptador de Windows Sharepoint Services en este tutorial, así como para definir derechos de usuario que hagan posible el acceso a este sitio.

Crear un sitio de Windows SharePoint Services

  1. Haga clic en Inicio, seleccione Todos los programas, Herramientas administrativas y, a continuación, haga clic en Administración central de SharePoint.

  2. En Configuración del servidor virtual, haga clic en Crear un sitio web de nivel superior.

  3. En Lista de servidores virtuales, seleccione el sitio web en el que instaló el adaptador de Windows SharePoint Services. Por ejemplo, Default Web Site.

  4. En la sección Dirección del sitio web , en el campo Nombre de dirección URL , escriba WSSAdapterWalkthrough.

  5. En la sección Propietario de la colección de sitios, en el campo Nombre de usuario, escriba un nombre de usuario. El usuario será el propietario del sitio Web y no necesita permisos especiales para utilizar BizTalk Server.

  6. En la sección Propietario de la colección de sitios, en el campo Correo electrónico, escriba una dirección de correo electrónico.

  7. Haga clic en OK.

  8. En la página Sitio de nivel superior creado correctamente , haga clic en el nuevo sitio web de nivel superior que acaba de crear. Por ejemplo, http://<server_name>/sites/WSSAdapterWalkthrough.

  9. Seleccione la plantilla Sitio de grupo en la lista de plantillas y, a continuación, haga clic en Aceptar. De este modo se abre la página principal del sitio Web del equipo.

Crear una biblioteca de documentos de “origen”

  1. En la página principal del sitio web de grupo, en la barra de navegación superior, haga clic en Crear.

  2. En Bibliotecas de documentos, haga clic en Biblioteca de documentos.

  3. En la sección Nombre y Descripción , en el campo Nombre, escriba Source.

  4. En la sección Navegación , seleccione Sí para mostrar esta biblioteca de formularios en la barra Inicio rápido.

  5. En la sección Plantilla de documento , en la lista desplegable Plantilla de documento , seleccione None.

  6. Haga clic en Crear. Se creará la biblioteca de documentos y tendrá lugar una redirección a la biblioteca vacía.

Crear una biblioteca de documentos de "destino"

  1. En la página principal del sitio web de grupo, en la barra de navegación superior, haga clic en Crear.

  2. En Bibliotecas de documentos, haga clic en Biblioteca de documentos.

  3. En la sección Nombre y Descripción , en el campo Nombre, escriba Destination.

  4. En la sección Navegación , seleccione Sí para mostrar esta biblioteca de formularios en la barra Inicio rápido.

  5. En la sección Plantilla de documento , en la lista desplegable Plantilla de documento , seleccione None.

  6. Haga clic en Crear. Se creará la biblioteca de documentos y tendrá lugar una redirección a la biblioteca vacía.

Crear una biblioteca de documentos de "archivo"

  1. En la página principal del sitio web de grupo, en la barra de navegación superior, haga clic en Crear.

  2. En Bibliotecas de documentos, haga clic en Biblioteca de documentos.

  3. En la sección Nombre y Descripción, en el campo Nombre, escriba Archive.

  4. En la sección Navegación , seleccione Sí para mostrar esta biblioteca de formularios en la barra Inicio rápido.

  5. En la sección Plantilla de documento , en la lista desplegable Plantilla de documento , seleccione None.

  6. Haga clic en Crear. Se creará la biblioteca de documentos y tendrá lugar una redirección a la biblioteca vacía.

  7. Cierre el WSSAdapterWalkthrough sitio web.

  8. Cierre el sitio web de Administración central de SharePoint .

Configuración de la seguridad de Windows

  1. Haga clic en Inicio, elija Todos los programas, seleccione Herramientas administrativas y, a continuación, haga clic en Administración de equipos.

  2. En el árbol de consola, expanda Usuarios y grupos locales y, a continuación, haga clic en Grupos.

  3. Haga clic con el botón derecho en el grupo Hosts habilitados para SharePoint , haga clic en Agregar al grupo y, a continuación, haga clic en Agregar.

  4. En el cuadro de diálogo Seleccionar los usuarios, equipos o grupos, en Escriba los nombres de objeto que desea seleccionar, escriba el nombre de la cuenta que configuró para que se ejecutara con la instancia de host de BizTalk Server y haga clic en Aceptar.

  5. En el árbol de consola, expanda Servicios y aplicaciones y, a continuación, haga clic en Servicios.

  6. Haga clic con el botón derecho en Grupo de BizTalk Service de BizTalk: <BizTalk_Host_Name> y, a continuación, haga clic en Reiniciar.

    Nota

    <> BizTalk_Host_Name es el nombre del host. De forma predeterminada, es BizTalkServerApplication.

    Nota

    La suscripción no tiene ningún efecto hasta que se reinicie el servicio.

  7. Cierre Administración de equipos.

Configurar seguridad de SharePoint

  1. Abra un explorador web y vaya a la dirección URL del sitio creado. Por ejemplo, http://<server_name>/sites/WSSAdapterWalkthrough.

  2. En la página principal del sitio web de grupo, en la barra de navegación superior, haga clic en Configuración del sitio.

  3. En Administración, haga clic en Administrar usuarios.

  4. Haga clic en Agregar usuarios.

  5. En paso 1: Elija Usuarios, escriba el nombre de la cuenta en la que se ejecuta la instancia de host de BizTalk Server.

  6. En paso 2: Elija Grupos de sitios, active las casillas Lector y Colaborador .

  7. Haga clic en Next.

  8. Desactive la casilla Enviar el siguiente correo electrónico para permitir que estos usuarios ahora se hayan agregado y, a continuación, haga clic en Finalizar.

  9. Cierre el WSSAdapterWalkthrough sitio web.

Crear y configurar los puertos de BizTalk Server

En este procedimiento se crearán y configurarán los puertos de recepción, las ubicaciones de recepción y los puertos de envío de BizTalk Server para el adaptador de Windows SharePoint Services. Estos puertos son puntos de entrada y salida de BizTalk Server para documentos recibidos y enviados por el adaptador de Windows Sharepoint Services.

Crear el puerto de recepción

  1. Haga clic en Inicio, Todos los programas, Microsoft BizTalk Server 20xx y, a continuación, haga clic en Administración de BizTalk Server.

  2. Expanda administración de BizTalk Server, grupo de BizTalk, aplicaciones, aplicación de BizTalk 1, haga clic con el botón derecho en Puertos de recepción, haga clic en Nuevo y, a continuación, haga clic en Puerto de recepción unidireccional...

  3. En el cuadro de diálogo Propiedades del puerto de recepción, en General, escriba FromSource en el campo Nombre .

  4. Haga clic en OK.

Creación de la ubicación de recepción

  1. En la Consola de administración de BizTalk, haga clic con el botón derecho en el nodo Ubicaciones de recepción , haga clic en Nuevo y, a continuación, en Ubicación de recepción unidireccional.

  2. En el cuadro de diálogo Seleccionar un puerto de recepción , seleccione FromSourcey, a continuación, haga clic en Aceptar.

  3. En el cuadro de diálogo Propiedades de ubicación de recepción, en General, escriba SourceLocation en el campo Nombre .

  4. En la sección Transporte , en la lista desplegable Tipo , seleccione Windows``SharePoint``Services.

  5. Haga clic en Configurar para configurar las propiedades del adaptador de Windows SharePoint Services.

  6. En la propiedad Puerto de servicio web del adaptador, escriba el número de puerto del servidor virtual donde se instaló el servicio web del adaptador de Windows SharePoint Services. De forma predeterminada, éste es el puerto 80.

  7. Escriba Archive en la propiedad Ubicación de archivo .

  8. Escriba 10 en la propiedad Intervalo de sondeo .

  9. Escriba la dirección URL del sitio de SharePoint en la propiedad Url del sitio de oint de ShareP. Por ejemplo, http://<server_name>/sites/WSSAdapterWalkthrough.

  10. Escriba Source para la propiedad Biblioteca de documentos de origen.

  11. Haga clic en OK.

  12. En el cuadro de diálogo Propiedades de ubicación de recepción, seleccione BizTalkServerApplication como controlador de recepción.

  13. En la lista desplegable Receive pipeline (Canalización de recepción), seleccione PassThruReceive.

  14. Haga clic en OK.

Crear el puerto de envío

  1. En la Consola de administración de BizTalk, haga clic con el botón derecho en el nodo Puertos de envío, haga clic en Nuevo y, a continuación, haga clic en Puerto de envío unidireccional estático.

  2. En el cuadro de diálogo Propiedades del puerto de envío, en General, escriba SendToDestination en el campo Nombre .

  3. En la sección Transporte , seleccione Windows SharePoint Services para el tipo.

  4. Haga clic en Configurar para configurar las propiedades del adaptador de Windows SharePoint Services.

  5. En la propiedad Puerto de servicio web del adaptador, escriba el número de puerto del servidor virtual donde se instaló el servicio web del adaptador de Windows SharePoint Services. De forma predeterminada, éste es el puerto 80.

  6. Escriba en Destination la propiedad Carpeta de destino .

  7. Escriba en PurchaseOrder1-%MessageID%.xml la propiedad Filename .

  8. Establezca la propiedad Overwrite en Yes.

  9. Escriba la dirección URL del sitio de SharePoint en la propiedad Url del sitio de SharePoint . Por ejemplo, http://<server_name>/sites/WSSAdapterWalkthrough.

  10. Establezca la propiedad Integración de Microsoft Office en No.

  11. Haga clic en OK.

  12. En el cuadro de diálogo Propiedades del puerto de envío, en la lista desplegable Send handler (Controlador de envío), seleccione BizTalkServerApplication.

  13. En la lista desplegable Enviar canalización , seleccione PassThruTransmit.

  14. Haga clic en la pestaña Filtros .

  15. Seleccione WSS.InListName en el campo Propiedad .

  16. Seleccione == en el campo Operador .

  17. Escriba Source en el campo Valor .

  18. Haga clic en OK.

Habilite e inicie la ubicación de recepción y el puerto de envío

Con estos procedimientos, se habilita la ubicación de recepción y se inicia el puerto de recepción. Este procedimiento debe completarse para permitir que el adaptador de Windows Sharepoint Services envíe y reciba mensajes a través de la ubicación de recepción y del puerto de envío especificados.

Habilitar la ubicación de recepción

  1. En la Consola de administración de BizTalk, haga clic en el nodo Ubicaciones de recepción .

  2. Haga clic con el botón derecho en SourceLocationy, a continuación, haga clic en Habilitar.

Iniciar el puerto de envío.

  1. En la Consola de administración de BizTalk, haga clic en el nodo Puertos de envío.

  2. Haga clic con el botón derecho en SendToDestinationy, a continuación, haga clic en Iniciar.

  3. Cierre la consola de administración de BizTalk.

Envío de un mensaje a través del sistema

Con este procedimiento, creará un documento XML y lo cargará en el sitio Web de Windows SharePoint Services. El adaptador de Windows SharePoint Services tomará el mensaje, lo archivará en la biblioteca de documentos de archivo y, a continuación, lo enviará a la biblioteca de documentos de destino. En este procedimiento se demuestra cómo un documento se transfiere de un sitio Web de Sharepoint, a través de BizTalk Server, a un sitio Web de Sharepoint Services mediante el adaptador de Windows Sharepoint Services.

Creación de un directorio de trabajo

  • Cree un directorio en el equipo denominado WSSAdapterWalkthrough. Por ejemplo, C:\WSSAdapterWalkthrough.

Crear un archivo XML.

  1. Haga clic en Inicio, seleccione Todos los programas, Accesorios y, a continuación, haga clic en Bloc de notas.

  2. Escriba lo siguiente:

    <?xml version="1.0"?>  
<PurchaseOrder>  
    <ID>1001</ID>  
    <FirstName>John</FirstName>  
    <LastName>Doe</LastName>  
    <Amount>750</Amount>  
</PurchaseOrder>

  3. Guarde el archivo en el directorio de trabajo como PurchaseOrder1.xml. Por ejemplo, C:\WSSAdapterWalkthrough\PurchaseOrder1.xml.

Cargar el archivo XML

  1. Abra un explorador Web y desplácese a la dirección URL del sitio creado en la última tarea. Por ejemplo, http://<server_name>/sites/WSSAdapterWalkthrough.

  2. En el lado izquierdo, en Documentos, haga clic en Origen.

  3. Haga clic en Cargar documento.

  4. En el cuadro Nombre , escriba o busque el archivo XML que creó anteriormente. Por ejemplo, y, a continuación, C:\WSSAdapterWalkthrough\PurchaseOrder1.xmlhaga clic en Guardar y cerrar. Debería poder ver el archivo en la lista.

  5. Actualice la ventana del explorador. El PurchaseOrder1.xml archivo ya no aparecerá en esta biblioteca.

    Nota

    Es posible que tenga que actualizar el explorador varias veces ya que el intervalo de sondeo está establecido en 10 segundos.

  6. En la barra de navegación superior, haga clic en Documentos y listas.

  7. En Bibliotecas de documentos, haga clic en Destino.

  8. En la biblioteca de documentos de destino, ahora verá el mensaje incluido en la lista. También encontrará una copia archivada en la biblioteca de documentos de archivo.

    Nota

    Si el mensaje no aparece en la biblioteca de documentos de destino, consulte "Solución de problemas del adaptador de Windows SharePoint Services" en BizTalk Server Ayuda.

Resumen

En este tutorial ha visto cómo configurar Windows SharePoint Services y BizTalk Server para enviar y recibir mensajes utilizando el adaptador de Windows SharePoint Services y el enrutamiento por contenidos (CBR).

Pasos siguientes

Ahora que ha completado este tutorial, realice el tutorial Tutorial: Módulo 2: Integración de Office con el tutorial adaptador de Windows SharePoint Services, que se expande en el trabajo que ha realizado con este tutorial y muestra cómo integrar Office con el adaptador de Windows SharePoint Services.

Consulte también

¿Qué es el adaptador de Windows SharePoint Services?
Tutoriales del adaptador de Windows SharePoint Services