Paso 3a: Recibir notificaciones de oportunidades de Salesforce en BizTalk Server

En este paso, empezaremos a crear un BizTalk Server. Debemos incluir primero el esquema para el mensaje de notificación de oportunidades que obtendremos de Salesforce y después comenzaremos 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 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 & 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 Regla de flujo de trabajo De oportunidad cerrada , haga clic en NuevaOp1 acción de flujo de trabajo de mensaje saliente.

5. En la página de acción De flujo de trabajo de mensaje de salida NewOp1 , haga clic con el botón derecho en el vínculo Haga clic en Hacer clic en 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 la extensión .wsdl.

6. Cree un 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 de bienvenida, haga clic en Next (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 para recibir 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 variables de mensaje nuevas. Asígneles los nombres NotificationMessage y NotificationAck. Establezca el tipo de mensaje para estas variables de mensaje como se indica a continuación:

   1. Establezca NotificationMessageen 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 NotificationAcken 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 a Salesforce.

3. Agregar una forma 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 Construir mensaje después de la forma Recepción. Asigne un nombre a la forma del mensaje como ConstructNotificationResponse y establezca la propiedad NotificationAckMensajes construidos en . Como parte de la forma Construir mensaje, crearemos también una asignación para generar un mensaje de confirmación de notificación para enviarlo a Salesforce.

   1. Dentro de la forma Construir mensaje, agregue una forma Transformación. Haga doble clic en la forma Transformar y, en el cuadro de diálogo Transformar configuració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 de vuelta. 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 quitar 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 Asignación de valores al elemento Ack en el esquema de destino.

5. En la orquestación, después de la forma Construir mensaje, agregue una forma Envío que se usará para enviar la confirmación 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 enviar 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 Crear un nuevo tipo de puerto.

   • Establezca Patrón de comunicación en Solicitud-respuesta.

   • Establezca Dirección del puerto de la comunicación en Recibiré una solicitud y enviaremos una respuesta y estableceremos Enlace de puerto en Especificar más adelante.

     Conecte la operación request de port a la forma Receive (ReceiveNotificationMessage) y la operación Response del puerto a la forma Send (SendNotificationAck). La siguiente captura de pantalla muestra la parte de la orquestación que recibe una notificación de oportunidad de Salesforce y envía una confirmación de vuelta:

     

   Por ahora, hemos configurado la solución donde se recibe una notificación de oportunidad de Salesforce y se envía una confirmación de vuelta. En los temas siguientes, ampliaremos esta solución para comenzar a procesar la notificación de oportunidad con el fin de obtener más detalles acerca del tipo de oportunidad de venta disponible.

Consulte también

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