En este instructivo, se describe un caso de uso sobre cómo usar Application Integration para automatizar un flujo de administración de pedidos entre una aplicación de administración de relaciones con clientes (CRM) y una aplicación de planificación de recursos empresariales (ERP).
Descripción general
Las empresas utilizan varias aplicaciones de CRM y ERP para crear, procesar, administrar y mantener pedidos de venta. Cada una de estas aplicaciones está a cargo de diferentes organizaciones o equipos, por lo que es un desafío garantizar que se haga un seguimiento constante del pedido mientras se proporcionan actualizaciones oportunas a los clientes.
En este instructivo, crearás una integración que use un activador de Salesforce para suscribirse a un evento de oportunidad nuevo en Salesforce. Cuando se cree una oportunidad nueva, la integración recuperará detalles adicionales de la oportunidad, como el nombre y el ID de la cuenta. Estos detalles se verifican en una tabla de BigQuery para crear y actualizar la oportunidad con un número de pedido de seguimiento. Durante la validación, si la información de la cuenta no existe en BigQuery, la integración creará automáticamente una entrada nueva en la tabla de BigQuery y en la instancia de ServiceNow adjunta con los conectores de integración.
Objetivos
En este instructivo, se muestra cómo completar las siguientes tareas en tu integración:
- Configura el activador de Salesforce para invocar tu integración.
- Agrega y configura tareas de conectores para las conexiones de Salesforce, BigQuery y ServiceNow.
- Agrega y configura tareas de asignación de datos para extraer y asignar detalles de oportunidades.
Costos
En este instructivo, usarás los siguientes componentes facturables de Google Cloud:
Las instrucciones de este instructivo están diseñadas para mantener tu uso de recursos dentro de los límites del nivel Siempre gratuito de Google Cloud.
Cuando finalices las tareas que se describen en este documento, puedes borrar los recursos que creaste para evitar que continúe la facturación. Para obtener más información, consulta Cómo realizar una limpieza.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the BigQuery API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the following roles to the service account: BigQuery Data Editor (
roles/bigquery.dataEditor
), BigQuery Read Session User (roles/bigquery.readSessionUser
), Secret Manager Viewer (roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click
Add another role and add each additional role. - Click Continue.
-
Click Done to finish creating the service account.
-
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the BigQuery API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the following roles to the service account: BigQuery Data Editor (
roles/bigquery.dataEditor
), BigQuery Read Session User (roles/bigquery.readSessionUser
), Secret Manager Viewer (roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click
Add another role and add each additional role. - Click Continue.
-
Click Done to finish creating the service account.
-
Prepare el entorno
Verifica la configuración del usuario de Salesforce
En este instructivo, se supone que tienes una cuenta de desarrollador de Salesforce existente con la configuración del usuario y el conjunto de permisos necesarios. Verifica que tu cuenta tenga habilitada la captura de datos modificados (CDC). Para obtener información sobre cómo crear una cuenta nueva, consulta Cómo configurar un usuario de integración.
Configura el conjunto de datos y la tabla de BigQuery
En este instructivo, debes configurar un conjunto de datos de BigQuery y crear dos tablas para almacenar los detalles de la oportunidad de Salesforce y la información de la cuenta de ServiceNow.
Configura un conjunto de datos de BigQuery
Para configurar el conjunto de datos de BigQuery, sigue estos pasos:
- Ve a la página de BigQuery en la consola de Google Cloud.
- Haz clic en el panel Explorador y selecciona el proyecto que usas para este instructivo.
- Expande (Acciones) y selecciona Crear conjunto de datos.
- Configura los siguientes detalles en la página Crear conjunto de datos:
- ID del conjunto de datos: Ingresa
Demo_order_dataset
. - Tipo de ubicación > Región: Elige la región
us-central1 (lowa)
.
- ID del conjunto de datos: Ingresa
- Haz clic en Crear conjunto de datos.
El nuevo conjunto de datos Demo_order_dataset
debería aparecer ahora en el panel Explorador de tu proyecto.
Configura tablas de BigQuery
Para crear las tablas de BigQuery, sigue estos pasos:
- En el panel Explorador, haz clic y abre el conjunto de datos
Demo_order_dataset
creado. - Sigue estos pasos para crear una tabla Orders vacía y almacenar los detalles de la oportunidad de Salesforce:
- Haz clic en Crear tabla.
- En la sección Destino, ingresa
Orders
como el nombre de la tabla. - En la sección Esquema, haz clic en Editar como texto y pega la siguiente definición del esquema de JSON:
[ { "name": "order_number", "type": "STRING", "mode": "NULLABLE", "description": "Salesforce order number" }, { "name": "order_status", "type": "STRING", "mode": "NULLABLE", "description": "Sale order status" }, { "name": "tracking_number", "type": "INTEGER", "mode": "NULLABLE", "description": "Salesforce tracking number" } ]
- Haz clic en Crear tabla.
- Sigue estos pasos para crear una tabla Accounts vacía que almacene los detalles de la cuenta de Salesforce:
- Haz clic en Crear tabla.
- En la sección Destino, ingresa
Accounts
como nombre de la tabla. - En la sección Esquema, haz clic en Editar como texto y pega la siguiente definición del esquema de JSON:
[ { "name": "account_id", "type": "STRING", "mode": "NULLABLE", "description": "Account ID for the opportunity" }, { "name": "name", "type": "STRING", "mode": "NULLABLE", "description": "Account name for the opportunity" } ]
- Haz clic en Crear tabla.
Las nuevas tablas
Orders
yAccounts
ahora deberían aparecer en tu conjunto de datos Demo_order_dataset en el panel Explorador.
Verifica la instancia de ServiceNow
En este instructivo, se usa una instancia personal de desarrollador (PDI) gratuita de ServiceNow. Puedes usar tu instancia de ServiceNow existente o crear una nueva. Verifica que la instancia esté activa y anota su URL. Para obtener más información sobre PDI, consulta la documentación de PDI de ServiceNow.
Configurar conexiones
Para este instructivo, debes configurar las siguientes conexiones en Conectores de integración:
- Conexión de Salesforce
- Configura una conexión de Salesforce en Integration Connectors. Para obtener información sobre cómo configurar un conector de Salesforce, consulta Conector de Salesforce.
- Conexión de BigQuery
- Configura una conexión de BigQuery en los conectores de integración para obtener, actualizar y validar los detalles de los pedidos y las cuentas en el conjunto de datos Demo_order_dataset. Para obtener información sobre cómo configurar un conector de BigQuery, consulta Conector de BigQuery.
- Conexión de ServiceNow
- Configura una conexión de ServiceNow en Integration Connectors con la URL de tu instancia para crear y recuperar detalles de la cuenta en ServiceNow. Para obtener información sobre cómo configurar un conector de ServiceNow, consulta Conector de ServiceNow.
Crea la integración
Para crear una integración nueva, sigue estos pasos:
- En la consola de Google Cloud, ve a la página Application Integration.
- En el menú de navegación, haz clic en Integraciones. Aparecerá la página Integraciones.
- Haz clic en
- Nombre de la integración: Ingresa
opportunity-to-order-integration
. - Descripción: Ingresa
Demo integration created for tutorial
. - Región: Selecciona
us-central1
en la lista de regiones compatibles. - Haz clic en Crear para abrir el editor de integración.
Crear integración y proporciona los siguientes detalles en la página Crear integración:
- Nombre de la integración: Ingresa
Configurar activador de integración
Una vez que hayas creado correctamente la integración, puedes agregar y configurar un activador de integración que la invoque para un evento identificado.
En este instructivo, se usa un activador de Salesforce para invocar la integración para cada oportunidad nueva que se crea en la instancia de Salesforce. Para agregar y configurar un activador de Salesforce en tu integración de opportunity-to-order-integration
, haz lo siguiente:
- En el editor de integración, haz clic en Activadores para ver una lista de los activadores disponibles.
- Haz clic y colócalo en el elemento Activador de Salesforce en el editor de integración.
- Selecciona el elemento Activador de Salesforce en el lienzo del diseñador para abrir el panel de configuración del activador de Salesforce.
- Configura los siguientes campos en Entrada de activador:
- Tipo de evento: Selecciona Cambiar captura de datos (CDC) de la lista desplegable.
- Configuración de instancia de Salesforce: Haz clic en la opción + Agregar nueva configuración de instancia de Salesforce de la lista desplegable.
En el cuadro de diálogo Agregar configuración de instancia de Salesforce, haz lo siguiente:
- Nombre de conexión de la instancia de Salesforce: ingresa un nombre de conexión para la instancia de Salesforce. Por ejemplo,
test
- Dominio de Salesforce: Ingresa el nombre de dominio de Salesforce. Puedes encontrar esta información en la página Cuenta de Salesforce > Ver perfil.
- Perfil de autenticación: Selecciona un perfil de autenticación. Si no tienes un perfil de autenticación, crea uno nuevo. Para obtener más información, consulta Crea un perfil de autenticación nuevo.
- Haga clic en Agregar.
- Nombre de conexión de la instancia de Salesforce: ingresa un nombre de conexión para la instancia de Salesforce. Por ejemplo,
- Configuración del canal de Salesforce: Haz clic en la opción + Agregar nueva configuración del canal de Salesforce de la lista desplegable.
En el cuadro de diálogo Agregar canal de Salesforce, haz lo siguiente:
- Nombre del objeto de Salesforce: ingresa
Opportunity
. - Haz clic en Agregar.
- Nombre del objeto de Salesforce: ingresa
- Operación: Selecciona Crear en la lista desplegable.
Los cambios en las propiedades se guardan de forma automática.
Asigna la carga útil del activador al conector de Salesforce
Cuando se invoca la integración con el activador de Salesforce, debes extraer el ID de oportunidad y asignarlo a un conector de Salesforce para recuperar detalles adicionales de la oportunidad.
Conéctate a la cuenta de Salesforce
Sigue estos pasos para agregar y configurar una tarea Conectores para recuperar los detalles de la oportunidad con la conexión de Salesforce:
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Conectores en el editor de integración.
- Selecciona el elemento de la tarea Conectores en el diseñador para ver la tarea Conectores. de configuración.
- Haz clic en
Fetch Salesforce Data
.
y cambia el nombre de la etiqueta Conectores a - Haz clic en Configurar conector.
- Haz lo siguiente en la página Editor de tareas de Connectors:
- En Seleccionar conexión, elige la región
us-central1
. - Selecciona tu conexión de Salesforce de la lista de conexiones disponibles.
- Haz clic en Siguiente.
- En Tipo, elige Entidades.
- En Establecer entidades/acciones, selecciona Oportunidad en la lista de entidades disponibles y, luego, selecciona Obtener como la Operación.
- Haz clic en Listo para completar la configuración de conexión y cerrar el panel.
- En Seleccionar conexión, elige la región
Extrae y asigna el ID de oportunidad
Se usa una tarea de Asignación de datos para asignar y extraer los detalles de la oportunidad entre ese activador de Salesforce y su conector.
Para agregar y configurar la asignación de datos en tu integración, haz lo siguiente:
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Asignación de datos en el editor de integración.
- Selecciona el elemento Asignación de datos en el diseñador para ver el panel de configuración de la tarea.
- Haz clic en
Map to opportunity ID
.
y cambia el nombre de la tarea Asignación de datos a - Haz clic en Open Data Mapping Editor.
El Editor de asignación de datos te permite asignar variables de entrada a las variables de salida deseadas con las funciones de transformación disponibles. Entonces, el resultado está disponible como una variable para cualquier otra tarea o activador de integración. Para obtener más detalles variables de asignación, consulta Cómo agregar una asignación.
- Asigna la variable de salida del activador (
SalesforceTriggerCdcRecordID
) a la variable de entrada del conector generado automáticamente (entityId(Fetch Salesforce Data)
).Una vez que hayas completado la asignación, cierra el panel. Los cambios se guardarán automáticamente.
- Agrega una conexión perimetral del activador de Salesforce a la tarea Asignar al ID de oportunidad.
- Agrega una conexión perimetral de la tarea Asignar al ID de oportunidad al conector Obtener datos de Salesforce.
Valida la cuenta de Salesforce en la tabla de BigQuery
Una vez que recuperes todos los detalles de la oportunidad del conector de Salesforce, extrae y asigna el ID de la cuenta asociado con la oportunidad y valida su existencia en tu tabla de BigQuery.
Conéctate a la tabla de BigQuery
Sigue estos pasos para configurar una tarea de Conectores que lea las tablas Cuentas de BigQuery con la conexión de BigQuery:
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Conectores en el editor de integración.
- Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
- Haz clic en
Check account in BigQuery
.
y cambia el nombre de Connectors a - Haz clic en Configurar conector.
- Haz lo siguiente en la página Editor de tareas de Connectors:
- En Seleccionar conexión, elige la región
us-central1
. - Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
- Haz clic en Siguiente.
- En Tipo, elige Entidades.
- En Establecer entidades/acciones, selecciona cuentas en la lista de entidades disponibles y, luego, selecciona Lista como la Operación.
- Haz clic en Listo para completar la configuración de conexión y cerrar el panel.
- En Seleccionar conexión, elige la región
- Agrega una conexión perimetral del conector Obtener datos de Salesforce al conector Verificar cuenta en BigQuery.
Extrae y valida el ID de la cuenta de Salesforce
Para extraer, asignar y validar el ID de la cuenta de la oportunidad, haz lo siguiente:
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Asignación de datos en el editor de integración.
- Haz clic en el elemento Data Mapping en el diseñador para ver el panel de configuración de la tarea.
- Haz clic en
Check account
.
y cambia el nombre de la tarea de Asignación de datos a - Haz clic en Abrir editor de asignación de datos.
- Haz clic en + Add new variable y crea las siguientes variables de salida:
Nombre de la variable de resultado Tipo de datos sf_account_id
STRING
sf_account_name
STRING
account_exists
BOOLEAN
- Crea la siguiente asignación entre la variable de carga útil del conector de Salesforce y la variable local:
Entrada Salida connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("AccountId")
sf_account_id
connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("Name")
sf_account_name
connectorOutputPayload (Check account in BigQuery) .FILTER(~obj1 -> ~obj1 .GET_PROPERTY("account_id") .TO_STRING() .EQUALS(sf_account_id) ) .SIZE() .EQUALS("1")
account_exists
Una vez que hayas completado la asignación, cierra el panel. Los cambios se guardarán automáticamente.
- Agrega una conexión de borde del conector Check account in BigQuery a la tarea Check account.
Crea una nueva cuenta de BigQuery
Una vez que hayas validado la cuenta de Salesforce en BigQuery, y si la cuenta no existe, haz lo siguiente para crear una cuenta nueva en BigQuery. También usarás la misma información para crear una cuenta en ServiceNow.
Cómo agregar una cuenta a BigQuery
Sigue estos pasos para configurar una tarea de Conectores que cree una entidad nueva en la tabla Accounts de BigQuery:
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Conectores en el editor de integración.
- Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
- Haz clic en
Create account in BigQuery
.
y cambia el nombre de Connectors a - Haz clic en Configurar conector.
- Haz lo siguiente en la página Editor de tareas de Connectors:
- En Seleccionar conexión, elige la región
us-central1
. - Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
- Haz clic en Siguiente.
- En Tipo, elige Entidades.
- En Configurar entidades/acciones, selecciona accounts en la lista de entidades disponibles y, luego, selecciona Create como Operation.
- Haz clic en Listo para completar la configuración de conexión y cerrar el panel.
- En Seleccionar conexión, elige la región
Crea una cuenta nueva de ServiceNow
Sigue estos pasos para configurar una tarea de Conectores que agregue una cuenta nueva a tu instancia de ServiceNow:
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Conectores en el editor de integración.
- Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
- Haz clic en
Create account in ServiceNow
.
y cambia el nombre de los Conectores a - Haz clic en Configurar conector.
- Haz lo siguiente en la página Editor de tareas de Connectors:
- En Seleccionar conexión, elige la región
us-central1
. - Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
- Haz clic en Siguiente.
- En Tipo, elige Entidades.
- En Configurar entidades/acciones, selecciona system_user en la lista de entidades disponibles y, luego, selecciona Crear como Operación.
- Haz clic en Listo para completar la configuración de conexión y cerrar el panel.
- En Seleccionar conexión, elige la región
Transforma y asigna detalles de la cuenta
Para transformar los detalles de la cuenta y asignarlos a los conectores de BigQuery y ServiceNow, sigue estos pasos:
- En el editor de integración, haz clic en Tasks para mostrar una lista de tareas disponibles.
- Haz clic y coloca el elemento Asignación de datos en el editor de integración.
- Haz clic en el elemento Data Mapping en el diseñador para ver el panel de configuración de la tarea.
- Haz clic en
Mapping for Account Creation
.
y cambia el nombre de la tarea de Asignación de datos a - Haz clic en Abrir editor de asignación de datos.
- Haz clic en + Add new variable y crea las siguientes variables de entrada:
Nombre de la variable de entrada Tipo de datos new_BQaccount
JSON
new_SNaccount
JSON
- Crea la siguiente asignación para asignar el ID y el nombre de la cuenta de Salesforce a la tabla de BigQuery:
Entrada Salida new_BQaccount .SET_PROPERTY( sf_account_id, "account_id" ) .SET_PROPERTY( sf_account_name, "name" )
connectorInputPayload (Create account in BigQuery)
new_SNaccount .SET_PROPERTY( sf_account_id, "sys_id" ) .SET_PROPERTY( sf_account_name, "first_name" )
connectorInputPayload (Create account in ServiceNow)
Una vez que hayas completado la asignación, cierra el panel. Los cambios se guardarán automáticamente.
- Agrega una conexión perimetral desde la tarea Asignación para la creación de cuentas al conector Crear cuenta en BigQuery.
- Agrega una conexión perimetral de la tarea Asignación para la creación de cuentas al conector Crear cuenta en ServiceNow.
Crear un pedido nuevo en BigQuery
Sigue estos pasos para generar un número de pedido y agregarlo a BigQuery.
Agrega un pedido a BigQuery
Realiza los siguientes pasos para configurar una tarea de conectores que cree una entidad nueva en la tabla Pedidos de BigQuery:
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Conectores en el editor de integración.
- Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
- Haz clic en
Create order in BigQuery
.
y cambia el nombre de los Conectores a - Haz clic en Configurar conector.
- Haz lo siguiente en la página Editor de tareas de Connectors:
- En Seleccionar conexión, elige la región
us-central1
. - Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
- Haz clic en Siguiente.
- En Tipo, elige Entidades.
- En Establecer entidades/acciones, selecciona Pedidos en la lista de entidades disponibles y, luego, selecciona Crear como la Operación.
- Haz clic en Listo para completar la configuración de conexión y cerrar el panel.
- En Seleccionar conexión, elige la región
Genera el orden y asigna el mapa a BigQuery
- En el editor de integración, haz clic en Tareas para ver una lista de las tareas disponibles.
- Haz clic y coloca el elemento Asignación de datos en el editor de integración.
- Haz clic en el elemento Data Mapping en el diseñador para ver el panel de configuración de la tarea.
- Haz clic en
Mapping for Order Creation
.
y cambia el nombre de la tarea Asignación de datos a - Haz clic en Abrir editor de asignación de datos.
- Haz clic en + Add new variable y crea la siguiente variable:
Nombre de la variable Tipo de datos order_number
STRING
- Crea la siguiente asignación para generar un nuevo número de pedido y asignar los detalles del pedido al conector de BigQuery:
Entrada Salida GENERATE_UUID() .SPLIT("-") .GET("0")
new_order_number
"{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("DeliveryInstallationStatus__c") , "order_status" ) .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("TrackingNumber__c") , "tracking_number" ) .SET_PROPERTY( new_order_number , "order_number" )
connectorInputPayload (Create Order in BigQuery)
Una vez que hayas completado la asignación, cierra el panel. Los cambios se guardarán automáticamente.
- Agrega una conexión perimetral del conector Create account in BigQuery a la tarea Mapping for Order Creation.
- Agrega una conexión perimetral desde el conector Crear cuenta en ServiceNow a la tarea Asignación para la creación de pedidos.
- Agrega una conexión de borde de la tarea Asignación para la creación de pedidos al conector Create Order in BigQuery.
Actualiza la oportunidad de Salesforce
Una vez que hayas generado el número de pedido nuevo, actualiza la oportunidad de Salesforce de origen.
Configura el conector de Salesforce
Sigue estos pasos para configurar una tarea de Conectores que actualice la oportunidad existente de Salesforce:
- En el editor de integración, haz clic en Tasks para mostrar una lista de tareas disponibles.
- Haz clic y coloca el elemento Conectores en el editor de integración.
- Haz clic en el elemento de la tarea Conectores en el diseñador para ver la tarea Conectores. de configuración.
- Haz clic en
Update Salesforce
.
y cambia el nombre de los Conectores a - Haz clic en Configurar conector.
- Haz lo siguiente en la página Editor de tareas de Connectors:
- En Seleccionar conexión, elige la región
us-central1
. - Selecciona tu conexión de Salesforce de la lista de conexiones disponibles.
- Haz clic en Siguiente.
- En Tipo, elige Entidades.
- En Configurar entidades/acciones, selecciona Oportunidad en la lista de entidades disponibles y, luego, selecciona Actualizar como Operación.
- Haz clic en Listo para completar la configuración de conexión y cerrar el panel.
- En Seleccionar conexión, elige la región
Asigna el número de pedido a Salesforce
- En el editor de integración, haz clic en Tasks para mostrar una lista de tareas disponibles.
- Haz clic y coloca el elemento Asignación de datos en el editor de integración.
- Haz clic en el elemento Asignación de datos en el diseñador para ver el panel de configuración de la tarea.
- Haz clic en
Mapping to update opportunity
.
y cambia el nombre de la tarea de Asignación de datos a - Haz clic en Abrir editor de asignación de datos.
- Crea la siguiente asignación para actualizar la oportunidad de Salesforce:
Entrada Salida "{}" .TO_JSON() .SET_PROPERTY( new_order_number , "OrderNumber__c" )
connectorInputPayload (Update Salesforce)
entityId ( Fetch Salesforce Data)
entityId (Update Salesforce )
"'" .CONCAT(entityId ( Fetch Salesforce Data)) .CONCAT("'")
filterClause (Update Salesforce )
Una vez que hayas completado la asignación, cierra el panel. Los cambios se guardarán automáticamente.
- Agrega una conexión perimetral del conector Create Order in BigQuery a la tarea Mapping to update opportunity.
- Agrega una conexión perimetral de la tarea Asignación para actualizar la oportunidad al conector Actualizar Salesforce.
Agrega una condición perimetral
Una condición perimetral te permite especificar las condiciones que se deben cumplir para que el control de una integración pase a la tarea conectada por el perímetro. Ahora que agregaste y configuraste las tareas requeridas, puedes agregar una condición de borde para definir el flujo de la integración.
La siguiente condición de perímetro controla el flujo de la integración según la validación de la información de la cuenta:
- Agrega una conexión perimetral desde la tarea Verificar cuenta a la tarea Asignación para la creación de cuentas con la siguiente condición perimetral:
$account_exists$ = False
- Agrega otra conexión perimetral de la tarea Verificar cuenta a la tarea Asignación para la creación de pedidos con la siguiente condición perimetral:
$account_exists$ = True
Ejemplo de flujo de integración
En la siguiente figura, se muestra un diseño de ejemplo de la integración creada con este instructivo.
Publica y prueba la integración
Para publicar la integración, haz clic en Publish en la barra de herramientas del editor de integración.
Una vez que publiques tu integración de forma correcta, podrás ver e inspeccionar los registros de ejecución de la integración publicada. Para ver los registros, haz clic en Ver registros de ejecución de esta integración. Aparecerá la página Registros de ejecución.
Caso de prueba 1: Verificar si se crea un número de pedido para un ID de cuenta nuevo
Para probar la integración, accede a la instancia de Salesforce y crea una oportunidad nueva. Debes crear la oportunidad en una cuenta nueva o en una que no exista en tu tabla de BigQuery.
Para verificar el éxito de la integración, haz lo siguiente:
- Ve a la página de BigQuery.
- Abre la tabla Cuentas y verifica que se haya insertado el nuevo ID de cuenta de oportunidad.
- Abre la tabla Pedidos y marca la casilla para confirmar la inserción de los detalles del pedido nuevo.
- Ve a tu instancia de ServiceNow.
- Verifica si se agrega a tu instancia una cuenta nueva que contenga el mismo ID de cuenta de oportunidad de Salesforce.
- Abre Salesforce.
- Verifica si la oportunidad se actualizó con el nuevo número de pedido.
Caso de prueba 2: Verificar si se crea un número de pedido para un ID de cuenta existente en BigQuery
Para probar la integración, accede a la instancia de Salesforce y crea una oportunidad nueva. Debes crear la oportunidad en una cuenta existente que también exista en tu tabla de BigQuery.
Para verificar el éxito de la integración, haz lo siguiente:
- Ve a la página de BigQuery.
- Abre la tabla Cuentas y confirma que NO se insertó NINGÚN ID de cuenta nuevo.
- Abre la tabla Orders y verifica que se hayan insertado los detalles del pedido nuevo.
- Abre Salesforce.
- Confirma si la oportunidad se actualizó con el nuevo número de pedido.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en este instructivo, anula la publicación de la integración y borra las conexiones creadas en Integration Connectors.
- Para anular la publicación de esta integración, haz clic en Anular publicación en la barra de herramientas del editor de integración. Consulta Borra integraciones para obtener más información.
- Para obtener información sobre cómo borrar una conexión, consulta Administra conectores.