Compartir a través de

Tutorial: Módulo 3: Obtener acceso a las propiedades de SharePoint desde una orquestación

  • Artículo

Este tutorial es una continuación de Tutorial: Módulo 2: Integración de Office con el adaptador de Windows SharePoint Services y muestra cómo acceder a las propiedades de contexto de Windows SharePoint Services de un mensaje entrante en tiempo de ejecución y, a continuación, determinar el destino de ese mensaje en función de una propiedad mediante puertos dinámicos en un Orquestació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:

Modificar el proyecto de BizTalk

En este procedimiento, modificará el esquema PurchaseOrder de Walkthrough: Module 2 - Integrating Office with the Windows SharePoint Services Adapter. En este procedimiento se muestra cómo promocionar una propiedad de esquema para facilitar el acceso en una orquestación de BizTalk.

Modificar el esquema PurchaseOrder.xsd

  1. Inicie Microsoft Visual Studio.

  2. Haga clic en Archivo, en Abriry, a continuación, en Proyecto o solución.

  3. Vaya al archivo y, a OrderProcess.sln continuación, haga clic en Abrir.

  4. En Explorador de soluciones, haga clic con el botón derecho en el OrderProcessSchema.xsd archivo y, a continuación, haga clic en Abrir.

  5. En el Editor de BizTalk, expanda PurchaseOrder.

  6. Haga clic con el botón derecho en , haga clic en AmountPromovery, a continuación, haga clic en Promoción rápida.

  7. Haga clic en OK.

    Nota

    Visual Studio crea un esquema de propiedades para esto en el proyecto actual.

  8. Guarde PurchaseOrder.xsd.

Crear una orquestación

En este procedimiento, se creará una nueva orquestación de BizTalk. En él, se crea la orquestación que se utiliza para procesar un mensaje recibido por el adaptador de Windows Sharepoint Services.

Agregar una orquestación de BizTalk

  1. En Explorador de soluciones, haga clic con el botón derecho en el OrderProcess proyecto, haga clic en Agregar y, a continuación, haga clic en Nuevo elemento.

  2. En Categorías, seleccione Archivos de orquestación.

  3. En Plantillas, seleccione Orquestación de BizTalk.

  4. Escriba MyCompanyOrderProcessing el campo Nombre y, a continuación, haga clic en Agregar.

Crear información de recepción

En este procedimiento, creará un mensaje, un puerto de recepción y una forma de recepción nuevos para la orquestación. En él se muestra cómo configurar una orquestación para recibir un mensaje de BizTalk Server.

Crear un nuevo mensaje

  1. En vista de orquestación, haga clic con el botón derecho en Mensajes y, a continuación, haga clic en Nuevo mensaje. Esto generará un nuevo mensaje con el nombre Message_1.

  2. Haga clic con el botón derecho en , haga clic en Message_1Cambiar nombreyMessage_PO escriba .

  3. Haga clic con el botón derecho en Message_POy, a continuación, haga clic en Ventana Propiedades.

  4. En la propiedad Tipo de mensaje , expanda Esquemas y, a continuación, seleccione OrderProcess.OrderProcessSchema esquema.

Agregar un puerto de recepción a la orquestación

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma Puerto a la superficie de puerto. Se iniciará el Asistente para configuración de puertos.

  2. En la pantalla de bienvenida, haga clic en Siguiente.

  3. Escriba ReceivePurchaseOrder el campo Nombre y, a continuación, haga clic en Siguiente.

  4. Seleccione Crear un nuevo tipo de puerto.

  5. Escriba PurchaseOrderPT el campo Nombre del tipo de puerto y, a continuación, haga clic en Siguiente.

  6. En la pantalla Enlace de puerto, deje los valores predeterminados y, a continuación, haga clic en Siguiente.

  7. Haga clic en Finalizar

  8. En vista orquestación, en Tipos de puerto, expanda el tipo de PurchaseOrderPT puerto.

  9. Haga clic con el botón derecho en , haga clic en Operation_1Cambiar nombreyPurchaseOrderOperation escriba .

Agregar una forma Recepción a la orquestación

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma Recibir a la orquestación.

  2. Haga clic con el botón derecho en la forma Recibir y, a continuación, haga clic en Ventana Propiedades.

  3. Establezca la propiedad TrueActivate en .

    Nota

    Si la propiedad Activar está establecida en False, obtendrá el siguiente error: "error X2214: debe especificar al menos una correlación ya inicializada establecida para una recepción de no activación de un puerto no autocorrelacionado"

  4. Escriba Receive_PO en el campo Nombre .

  5. En la ventana Propiedades, seleccione Message_PO para la propiedad Message.

  6. Seleccione ReceivePurchaseOrder.PurchaseOrderOperation.Request para la propiedad Operation . Con esto, se asociará el puerto a la forma Recepción en el Diseñador de orquestaciones.

Crear información de envío

En este procedimiento, creará un mensaje, puertos de envío y una estructura de decisión nuevos en la orquestación. En él, se muestra cómo configurar una orquestación con lógica de decisiones, además de cómo configurar una orquestación para enviar un mensaje a un puerto de envío.

Crear un nuevo mensaje

  1. En vista de orquestación, haga clic con el botón derecho en Mensajes y, a continuación, haga clic en Nuevo mensaje. Esto generará un nuevo mensaje con el nombre Message_1.

  2. Haga clic con el botón derecho en , haga clic en Message_1Cambiar nombreyMessage_Task escriba .

  3. Haga clic con el botón derecho en Message_Tasky, a continuación, haga clic en Ventana Propiedades.

  4. En la propiedad Tipo de mensaje , expanda Esquemas y, a continuación, seleccione OrderProcess.OrderProcessSchema esquema.

Agregar un puerto de envío a la orquestación

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma Puerto a la superficie de puerto. Se iniciará el Asistente para configuración de puertos.

  2. En la pantalla de bienvenida, haga clic en Siguiente.

  3. Escriba SendPurchaseOrder el campo Nombre y, a continuación, haga clic en Siguiente.

  4. Seleccione Usar un tipo de puerto existente.

  5. En Tipos de puerto disponibles, seleccione OrderProcess.PurchaseOrderPTy, a continuación, haga clic en Siguiente.

  6. En la pantalla Enlace de puerto, en Dirección del puerto de comunicación, seleccione I'll always be sending messages on this porty, a continuación, haga clic en Siguiente.

  7. Haga clic en Finalizar

Agregar una forma Envío a la orquestación

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma Enviar al Designer de orquestación. Colóquelo debajo de la Receive_PO forma Recibir.

  2. Haga clic con el botón derecho en la forma Enviar y, a continuación, haga clic en Ventana Propiedades.

  3. Escriba Send_PO en el campo Nombre .

  4. Seleccione Message_PO para la propiedad Message .

  5. Seleccione SendPurchaseOrder.PurchaseOrderOperation.Request para la propiedad Operation . Con esto, se asociará el puerto a la forma Envío en el Diseñador de orquestaciones.

Agregar una forma Decidir a la orquestación

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma Decidir al Designer de orquestación. Colóquelo debajo de la Send_PO forma Enviar.

  2. Haga clic con el botón derecho en la forma Decidir y, a continuación, haga clic en Ventana Propiedades.

  3. Escriba NeedsApproval en el campo Nombre .

  4. En Orquestación Designer, haga clic en Rule_1 en la forma Decidir.

  5. En las ventanas Propiedades, escriba ApprovalRequired para la propiedad Name .

  6. Haga clic en el campo Propiedad expresión y, a continuación, haga clic en el botón de puntos suspensivos (...).

  7. En el Editor de expresiones de BizTalk, escriba o copie lo siguiente:

    Message_PO(OrderProcess.PropertySchema.Amount) > 1000

  8. Haga clic en OK.

Agregar otro puerto de envío a la orquestación

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma Puerto a la superficie de puerto. Se iniciará el Asistente para configuración de puertos.

  2. En la pantalla de bienvenida, haga clic en Siguiente.

  3. Escriba SendToTasksList en el campo Nombre y, a continuación, haga clic en Siguiente.

  4. Seleccione Usar un tipo de puerto existente.

  5. En Tipos de puerto disponibles, seleccione OrderProcess.PurchaseOrderPTy, a continuación, haga clic en Siguiente.

  6. En la pantalla Enlace de puerto, en Dirección del puerto de comunicación, seleccione I'll always be sending messages on this port.

  7. En Enlace de puerto, seleccione Dynamicy, a continuación, haga clic en Siguiente.

  8. Haga clic en Finalizar

Agregar una forma Envío a la forma Decidir

  1. En Orquestaciones de BizTalk en el cuadro de herramientas, arrastre una forma Enviar al Designer de orquestación. Colóquelo debajo de la ApprovalRequired forma.

  2. Haga clic con el botón derecho en la forma Enviar y, a continuación, haga clic en ventana Propiedades.

  3. Escriba CreateApprovalTask en el campo Nombre .

  4. Seleccione Message_Task para la propiedad Message .

  5. Seleccione SendToTasksList.PurchaseOrderOperation.Request para la propiedad Operation . Con esto, se asociará el puerto a la forma Envío en el Diseñador de orquestaciones.

Crear una expresión

En este procedimiento, agregará una forma Expresión a la solución, con lo que se asignará la ruta de acceso de Tareas a una variable. En él, se muestra cómo agregar lógica a una orquestación para modificar las propiedades de un puerto de envío dinámico.

Crear una nueva expresión

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma expresión antes de la CreateApprovalTask forma Enviar.

  2. Haga clic con el botón derecho en la forma Expresión y, a continuación, haga clic en Ventana Propiedades.

  3. Escriba SetPortDestination en el campo Nombre .

  4. Haga clic en el campo Propiedad expresión y, a continuación, haga clic en el botón de puntos suspensivos (...).

  5. En el Editor de expresiones de BizTalk, escriba lo siguiente:

    SendToTasksList(Microsoft.XLANGs.BaseTypes.Address) = "wss://localhost/sites/WSSAdapterWalkthrough/Lists/Tasks/";

  6. Haga clic en OK.

Construir un nuevo mensaje

En este procedimiento, agregará una forma Construir a la solución, con lo que se construirá una nueva instancia de un tipo de mensaje en la orquestación. En él, se muestra cómo crear un mensaje nuevo que sea una copia del mensaje de entrada y, seguidamente, modificar las propiedades de contexto del nuevo mensaje. Este paso es necesario porque los mensajes son inmutables en BizTalk; es decir, una vez construido el mensaje, no es posible modificar el original.

Agregar una forma Construir

  1. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma Construir mensaje antes de la SetPortDestination forma Expresión.

  2. Haga clic con el botón derecho en la forma Construir mensaje y, a continuación, haga clic en Ventana Propiedades.

  3. Escriba ConstructTaskMessageen el campo Nombre .

  4. Seleccione Message_Task para la propiedad Mensajes construidos .

  5. En Orquestaciones de BizTalk en el Cuadro de herramientas, arrastre una forma de asignación de mensajes a la ConstructTaskMessage forma Construir mensaje.

  6. En la ventana Propiedades, escriba InitTaskMessage en el campo Nombre .

  7. Haga clic en el campo Propiedad expresión y, a continuación, haga clic en el botón de puntos suspensivos (...).

  8. En el Editor de expresiones de BizTalk, escriba o copie lo siguiente:

    Message_Task = Message_PO;  
Message_Task(WSS.ConfigOverwrite) = "no";  
Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";  
Message_Task(WSS.ConfigPropertiesXml) = "<ConfigPropertiesXml><PropertyName1>Title</PropertyName1><PropertySource1>Approve %XPATH=//orchns:PurchaseOrder/orchns:PurchaseOrderID%</PropertySource1><PropertyName3>Status</PropertyName3><PropertySource3>Not Started</PropertySource3><PropertyName4>Priority</PropertyName4><PropertySource4>(1) High</PropertySource4></ConfigPropertiesXml>";

    Importante

    Al especificar los valores para estas propiedades de contexto, es preciso distinguir entre mayúsculas y minúsculas. Al establecer los valores de configuración para un puerto dinámico con propiedades de contexto, es necesario asegurarse de que se utilizan las mayúsculas y minúsculas del modo apropiado o, de lo contrario, se producirá un error cuando BizTalk intente enrutar el documento al puerto de envío designado.

  9. Haga clic en OK.

  10. Haga clic en Archivoy, a continuación, en Guardar todo.

Generar el proyecto de BizTalk

En este procedimiento, generará e implementará el proyecto de BizTalk. Este paso resulta necesario para crear e implementar el ensamblado que BizTalk Server utiliza en tiempo de ejecución.

Compilar e implementar la solución.

  1. Haga clic en Compilary, a continuación, haga clic en Build OrderProcess (Compilar orderProcess).

  2. Haga clic en Compilar y, a continuación, haga clic en Implementar OrderProcess.

  3. Cierre Microsoft Visual Studio.

Modificar la ubicación de recepción y el puerto de envío

En este procedimiento, modificará la ubicación de recepción y el puerto de envío existentes para utilizar el procesamiento XML para las canalizaciones. La canalización XML de recepción almacena las propiedades de mensaje utilizadas durante el procesamiento de la orquestación, mientras que la canalización XML de envío almacena las propiedades de mensaje que se aplican en la orquestación y que se utilizarán posteriormente para el enrutamiento de mensajes.

Modificar la ubicación de recepción

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

  2. Expanda MicrosoftBizTalk ServerAgregar Complemento de administración, grupo de BizTalk, aplicaciones,aplicación de BizTalk 1 y, a continuación, haga clic en el nodo Ubicaciones de recepción.

  3. Haga clic con el botón derecho en SourceLocationy, a continuación, haga clic en Propiedades.

  4. En el cuadro de diálogo Propiedades de ubicación de recepción, en General, seleccione XMLReceive para la propiedad Canalización de recepción .

  5. Haga clic en OK.

Modificar el puerto de envío

  1. 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 Propiedades.

  3. En el cuadro de diálogo Propiedades del puerto de envío, en General, seleccione XMLTransmit para la propiedad Enviar canalización .

  4. Seleccione la pestaña Filtros .

  5. Seleccione la condición existente, presione DELETE y, a continuación, haga clic en Aceptar.

Iniciar un nuevo puerto de envío

  1. Haga clic en el nodo Puertos de envío .

  2. Haga clic con el botón derecho en OrderProcess_1.0.0.0_OrderProcess.MyCompanyOrderProcess_SendToTasksList_<GUID>y, a continuación, haga clic en Iniciar.

Nota

Puede que sea necesario actualizar la consola si no resulta visible.

Enlazar la orquestación

En este procedimiento, enlazará la orquestación a los puertos especificados. Este procedimiento resulta necesario para asociar puertos físicos a la orquestación generada e implementada.

Enlazar la orquestación

  1. En la consola de administración de BizTalk Server, haga clic en el nodo Orquestaciones.

  2. Haga clic con el botón derecho en la OrderProcess.MyCompanyOrderProcessing orquestación y, a continuación, haga clic en Propiedades.

  3. Seleccione la pestaña Enlaces .

  4. En Host, seleccione BizTalkServerApplication en el campo Host .

  5. En Enlaces, seleccione FromSource para el ReceivePurchaseOrder puerto lógico de entrada.

  6. En Enlaces, seleccione SendToDestination para el SendPurchaseOrder puerto lógico saliente.

  7. Haga clic en OK.

  8. Haga clic con el botón derecho en OrderProcess.MyCompanyOrderProcessing orquestación y, a continuación, haga clic en Iniciar.

Enviar un mensaje a través del sistema

En este procedimiento, creará un formulario de InfoPath 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. Durante el procesamiento del mensaje, se obtendrá acceso a las propiedades de contexto de Windows SharePoint Services que ayudan a determinar el destino.

Crear un formulario de InfoPath para su envío a través del sistema

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

  2. En el menú Inicio rápido, haga clic en InfoPathSolutions.

  3. Haga clic en el PurchaseOrder archivo para mostrar el cuadro de diálogo Descargar archivo y, a continuación, haga clic en Abrir. InfoPath cargará el formulario.

  4. En el campo Id. de pedido de compra , escriba 1003.

  5. En el campo Facturar a , escriba John Doe.

  6. En el campo Importe , escriba 1750.

  7. En el campo Fecha de pedido de compra , escriba 1/3/2005.

  8. Haga clic en Save(Guardar).

  9. En el cuadro de diálogo Guardar como , escriba http://<server_name>/sites/WSSAdapterWalkthrough/Sourceen el campo nombre de archivo y presione ENTRAR.

  10. Escriba PurchaseOrder3.xml el campo nombre de archivo y, a continuación, haga clic en Guardar.

  11. Cierre InfoPath.

  12. En el explorador web, haga clic en Documentos y listas.

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

  14. En la biblioteca de documentos de destino, verá ahora el mensaje incluido en esta biblioteca. También encontrará una copia archivada en la biblioteca de documentos archive.

  15. Haga clic en Inicio.

  16. En Listas, haga clic en Tareas.

  17. En la lista Tareas, verá la tarea de aprobación recién creada.

Nota

Puesto que el importe del pedido superaba los 1.000,00 dólares, se creó la tarea.

Resumen

En este tutorial, ha visto cómo obtener acceso a las propiedades de contexto de Windows SharePoint Services y cómo determinar el destino de los mensajes que circulan a través de puertos dinámicos.

Pasos siguientes

Continúe revisando el resto de la sección del adaptador de Windows SharePoint Services. Para obtener más información, vea los temas de Vea también.

Consulte también

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