Paso 3a: Recibir notificación de oportunidades de Salesforce en BizTalk Server

En este paso, empezamos a crear un servidor de BizTalk Server. Primero debemos incluir el esquema de mensajes para el mensaje de notificación de oportunidades que obtendremos de Salesforce y, a continuación, empezaremos a crear una orquestación para procesar el mensaje.

Para incluir el esquema de notificación de oportunidades de Salesforce

1. Inicie sesión en el portal de Salesforce.com. En el portal de Salesforce, haga clic en el nombre de inicio de sesión en la esquina superior derecha de la página y, a continuación, haga clic en Configurar.

2. En el panel izquierdo, en Configuración de la aplicación, expanda Crear, expanda Flujo de trabajo y aprobaciones y, a continuación, haga clic en Reglas de flujo de trabajo.

3. En la página Todas las reglas de flujo de trabajo , haga clic en el flujo de trabajo De oportunidad cerrada que creó anteriormente.

4. En la página de reglas de flujo de trabajo Oportunidad Cerrada, haga clic en la acción de flujo de trabajo de mensaje de salida NewOp1.

5. En la página de acciones del flujo de trabajo del mensaje de salida NewOp1, haga clic con el botón secundario en el vínculo Click for WSDL, haga clic en Guardar destino como y, a continuación, especifique la ubicación donde desea guardar el WSDL.

   Nota:

   Debe guardar el archivo con una extensión .wsdl.

6. Cree una instancia de BizTalk Server en Visual Studio. En este tutorial, vamos a asignar un nombre al proyecto como BtsSalesforceIntegration.

7. Haga clic con el botón derecho en el proyecto de BizTalk Server en el Explorador de soluciones, seleccione Agregar y, a continuación, haga clic en Agregar elementos generados.

8. En el cuadro de diálogo Agregar elementos generados , haga clic en Consumir servicio WCF y, a continuación, haga clic en Agregar para iniciar el Asistente para consumo de servicios WCF de BizTalk . En la página principal, haga clic en Siguiente.

9. En la página Origen de metadatos , seleccione la opción Archivos de metadatos (WSDL y XSD) y, a continuación, haga clic en Siguiente.

10. En la página Archivos de metadatos , haga clic en Agregar y, a continuación, vaya a la ubicación donde guardó el archivo WSDL descargado desde el portal de Salesforce. Seleccione el archivo WSDL y haga clic en Siguiente.

11. En la página siguiente, establezca el espacio de nombres como NotificationService y, a continuación, haga clic en Importar. El asistente agrega los archivos de esquema y una orquestación al proyecto de BizTalk Server. El esquema de mensajes para recibir notificaciones de oportunidades de Salesforce es NotificationService_soap_sforce_com_2005_09_outbound.xsd.

Para crear una orquestación que reciba el mensaje de notificación

1. Después de completar el Asistente para consumo de servicios WCF de BizTalk , se agrega una orquestación (NotificationService.odx, en este ejemplo) al proyecto de BizTalk Server.

2. Abra el archivo de orquestación y, en la vista Orquestación, agregue dos nuevas variables de mensaje. Nómbralos NotificationMessage y NotificationAck. Establezca el tipo de mensaje para estas variables de mensaje de la siguiente manera:

   1. Establezca NotificationMessage en NotificationService.NotificationService_soap_sforce_com_2005_09_outbound.notifications. Esta variable de mensaje representa el mensaje de notificación de oportunidad recibido de Salesforce.

   2. Establezca NotificationAck en NotificationService.NotificationService_soap_sforce_com_2005_09_outbound.notificationsResponse. Esta variable de mensaje representa el mensaje de confirmación de notificación de oportunidad enviado de vuelta a Salesforce.

3. Agregue un elemento de recepción a la orquestación. Establezca las siguientes propiedades en la forma:

   1. Establezca Activar en True.

   2. Establezca Nombre en ReceiveNotificationMessage.

   3. Establezca Message en NotificationMessage.

4. Agregue una forma Construct Message después de la forma Receive. Asigne un nombre a la forma del mensaje como ConstructNotificationResponse y establezca la propiedad Mensajes Construidos en NotificationAck. Como parte del mensaje de construcción, también crearemos un mapa para generar un mensaje de confirmación de notificación que se devolverá a Salesforce.

   1. En la forma Construir mensaje, agregue una forma Transformar. Haga doble clic en la forma Transformar y, en el cuadro de diálogo Configuración de Transformación, seleccione la opción Nuevo mapa.

   2. Especifique el nombre del mapa como BtsSalesforceIntegration.MapNotificationResponse.

   3. Establezca Source como NotificationMessage y Destination como NotificationAck.

   4. Asegúrese de que la casilla Cuando haga clic en Aceptar, inicie el asignador de BizTalk está seleccionada.

   5. En MapNotificationResponse.btm, crearemos una respuesta de notificación para que se devuelva a Salesforce. Cada vez que Salesforce envía una notificación, espera una confirmación a cambio. El esquema del mensaje de respuesta de notificación muestra que el elemento Ack de la respuesta es de tipo Boolean. Por lo tanto, en el mapa, debe colocar un functoid de asignación de valores y establecer sus dos valores de entrada (Condición y Resultado) en true. Haga clic en Aceptar para guardar el functoid.

   6. Conecte el functoid de Asignación de valores al elemento Ack en el esquema de destino.

5. En la orquestación, después del elemento Construir mensaje, agregue un elemento Enviar que se usará para enviar la confirmación de vuelta a Salesforce.

   • Establezca Nombre en SendNotificationAck.

   • Establezca Message en NotificationAck.

6. En la orquestación, agregue un puerto para recibir el mensaje de notificación de Salesforce y envíe la confirmación en respuesta. En el Asistente para configuración de puertos, seleccione las siguientes opciones:

   • Especifique el nombre del puerto como SalesforceNotificationPort.

   • Seleccione la opción para crear un nuevo tipo de puerto.

   • Establezca Patrón de comunicación en Request-Response.

   • Establezca dirección de comunicación del puerto en Recibiré una solicitud y enviaré una respuesta y establezca vinculación de puerto en Especificar más adelante.

     Conecte la operación de solicitud del puerto a la forma Receive (ReceiveNotificationMessage) y la operación response del puerto a la forma Send (SendNotificationAck). En la captura de pantalla siguiente se muestra la parte de la orquestación que recibe una notificación de oportunidad de Salesforce y devuelve una confirmación:

     

   Por ahora, hemos configurado la solución en la que se recibe una notificación de oportunidad de Salesforce y se devuelve una confirmación. En los temas posteriores, nos basaremos en esta solución para empezar a procesar la notificación de la oportunidad y obtener más detalles sobre el tipo de oportunidad de ventas disponible.

Véase también

Paso 3: Crear la solución de BizTalk Server en Visual Studio