Automatizar la oportunidad de Salesforce para un pedido de BigQuery

---

En este instructivo, se describe un caso de uso sobre cómo puedes 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 de negocios usan 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 garantizar que se realice un seguimiento constante del pedido mientras se proporcionan actualizaciones oportunas a los clientes es un desafío.

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 conectada mediante Integration Connectors.

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.
• Agregar y configurar tareas de asignación de datos para extraer y mapear detalles de la oportunidad

Costos

En este instructivo, usarás los siguientes componentes facturables de Google Cloud:

• Application Integration
• Conectores de Integration
• BigQuery
• Secret Manager

Las instrucciones de este instructivo se diseñaron para mantener el 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

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

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. Habilita la API de BigQuery.

   Habilita la API

5. Crear una cuenta de servicio:

   1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

      Ve a Crear cuenta de servicio
   2. Elige tu proyecto.

   3. Ingresa un nombre en el campo Nombre de cuenta de servicio. La consola de Google Cloud completa el campo ID de cuenta de servicio en función de este nombre.

      Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

   4. Haz clic en Crear y continuar.

   5. Otorga los siguientes roles a la cuenta de servicio: 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).

      Para otorgar un rol, busca la lista Selecciona un rol y, luego, selecciona el rol.

      Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.

      Nota: El campo Rol afecta a qué recursos puede acceder tu cuenta de servicio en el proyecto. Puedes revocar estos roles o asignar otros más adelante. En entornos de producción, no otorgues los roles de propietario, editor o visualizador. En su lugar, otorga un rol predefinido o un rol personalizado que satisfaga tus necesidades.
   6. Haga clic en Continuar.

   7. Haz clic en Listo para terminar de crear la cuenta de servicio.

6. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

7. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

8. Habilita la API de BigQuery.

   Habilita la API

9. Crear una cuenta de servicio:

   1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

      Ve a Crear cuenta de servicio
   2. Elige tu proyecto.

   3. Ingresa un nombre en el campo Nombre de cuenta de servicio. La consola de Google Cloud completa el campo ID de cuenta de servicio en función de este nombre.

      Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

   4. Haz clic en Crear y continuar.

   5. Otorga los siguientes roles a la cuenta de servicio: 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).

      Para otorgar un rol, busca la lista Selecciona un rol y, luego, selecciona el rol.

      Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.

      Nota: El campo Rol afecta a qué recursos puede acceder tu cuenta de servicio en el proyecto. Puedes revocar estos roles o asignar otros más adelante. En entornos de producción, no otorgues los roles de propietario, editor o visualizador. En su lugar, otorga un rol predefinido o un rol personalizado que satisfaga tus necesidades.
   6. Haga clic en Continuar.

   7. Haz clic en Listo para terminar de crear la cuenta de servicio.

Nota: Todas las demás APIs obligatorias de Google Cloud, como la API de Application Integration, la API de Secret Manager y la API de Connectors, se habilitan durante la configuración de Application Integration. Para obtener más detalles, consulta Configura Application Integration.

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). Si deseas obtener información para 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 el conjunto de datos de BigQuery

Para configurar el conjunto de datos de BigQuery, haz lo siguiente:

1. Ve a la página de BigQuery en la consola de Google Cloud.

   Ir a BigQuery

2. Haz clic en el panel Explorador y selecciona el proyecto que usarás para este instructivo.
3. Expande (Acciones) y selecciona Crear conjunto de datos.
4. Configura los siguientes detalles en la página Crear conjunto de datos:
   1. ID del conjunto de datos: Ingresa Demo_order_dataset.
   2. Tipo de ubicación > Región: Elige la región us-central1 (lowa).
5. Haz clic en Crear conjunto de datos.

El nuevo conjunto de datos Demo_order_dataset ahora debería aparecer en el panel Explorador de tu proyecto.

Configura tablas de BigQuery

Para crear las tablas de BigQuery, haz lo siguiente:

1. En el panel Explorador, haz clic y abre el conjunto de datos Demo_order_dataset creado.
2. Sigue estos pasos para crear una tabla Pedidos vacía y almacenar los detalles de la oportunidad de Salesforce:
   1. Haz clic en Crear tabla.
   2. En la sección Destino, ingresa Orders como nombre de la tabla.
   3. En la sección Esquema, haz clic en Editar como texto y pega la siguiente definición de esquema 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"
        }
      ]
      

   4. Haz clic en Crear tabla.
3. Sigue estos pasos para crear una tabla Cuentas vacía para almacenar los detalles de la cuenta de Salesforce:
   1. Haz clic en Crear tabla.
   2. En la sección Destino, ingresa Accounts como nombre de la tabla.
   3. En la sección Esquema, haz clic en Editar como texto y pega la siguiente definición de esquema 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"
        }
      ]
      

   4. Haz clic en Crear tabla.

   Las nuevas tablas Orders y Accounts deberían aparecer ahora en el conjunto de datos Demo_order_dataset en el panel Explorador.

Verifica la instancia de ServiceNow

En este instructivo, se usa una instancia de desarrollador personal (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 la PDI, consulta la documentación de PDI de ServiceNow.

Configurar conexiones

Para este instructivo, debes configurar las siguientes conexiones en Integration Connectors:

Sugerencia: Te recomendamos que crees las siguientes conexiones en la región us-central1(lowa).

Conexión de Salesforce

Configura una conexión de Salesforce en Integration Connectors. Para obtener información sobre la configuración de un conector de Salesforce, consulta Conector de Salesforce.

Conexión de BigQuery

Configura una conexión de BigQuery en Integration Connectors para obtener, actualizar y validar los detalles del pedido y la cuenta en el conjunto de datos Demo_order_dataset. Para obtener información sobre la configuración de 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 los detalles de la cuenta en ServiceNow. Para obtener información sobre cómo configurar un conector de ServiceNow, consulta Conector de ServiceNow.

Crear integración

Para crear una integración nueva, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones. Aparecerá la página Integrations List.
3. Haz clic en Create integration y proporciona los siguientes detalles en la página Create Integration:
   1. Nombre de la integración: Ingresa opportunity-to-order-integration.
   2. Descripción: Ingresa Demo integration created for tutorial.
   3. Región: Selecciona us-central1 de la lista de regiones compatibles.
   4. Haz clic en Crear para abrir el editor de integración.

Configura el activador de integración

Una vez que hayas creado correctamente tu integración, puedes agregar y configurar un activador de integración que invoque la integración para un evento identificado.

En este instructivo, se usa un activador de Salesforce para invocar la integración de 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:

1. En el editor de integración, haz clic en Activadores para ver una lista de los activadores disponibles.
2. Haz clic y coloca el elemento Activador de Salesforce en el editor de integración.
3. Selecciona el elemento Activador de Salesforce en el lienzo del diseñador para abrir el panel de configuración del activador de Salesforce.
4. Configura los siguientes campos en Entrada de activador:
   1. Tipo de evento: Selecciona Cambiar captura de datos (CDC) de la lista desplegable.
   2. 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 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.
      • Haz clic en Agregar.
   3. 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 un canal de Salesforce, sigue estos pasos:

      • Nombre del objeto de Salesforce: ingresa Opportunity.
      • Haz clic en Agregar.
   4. 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 la oportunidad y asignarlo a un conector de Salesforce para recuperar detalles adicionales de la oportunidad.

Cómo conectarse a la cuenta de Salesforce

Sigue estos pasos para agregar y configurar una tarea Conectores para recuperar los detalles de la oportunidad mediante la conexión de Salesforce:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Conectores en el editor de integración.
3. Selecciona el elemento de la tarea Conectores en el diseñador para ver el panel de configuración de tareas de conectores.
4. Haz clic en y cambia el nombre de la etiqueta Conectores a Fetch Salesforce Data.
5. Haz clic en Configurar conector.
6. Haz lo siguiente en la página Editor de tareas de conectores:
   1. En Seleccionar conexión, elige la región us-central1.
   2. Selecciona tu conexión de Salesforce en la lista de conexiones disponibles.
   3. Haz clic en Siguiente.
   4. En Tipo, elige Entidades.
   5. En Establecer entidades/acciones, selecciona Oportunidad en la lista de entidades disponibles y, luego, Obtener como la Operación.
   6. Haz clic en Listo para completar la configuración de conexión y cerrar el panel.

Extrae y asigna el ID de oportunidad

Una tarea de asignación de datos se usa para asignar y extraer los detalles de la oportunidad entre ese activador de Salesforce y el conector de Salesforce.

Para agregar y configurar la asignación de datos en tu integración, haz lo siguiente:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Asignación de datos en el editor de integración.
3. Selecciona el elemento Asignación de datos en el diseñador para ver el panel de configuración de tareas.
4. Haz clic en y cambia el nombre de la tarea Asignación de datos a Map to opportunity ID.
5. Haz clic en Abrir editor de asignación de datos.

   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 sobre la asignación de variables, consulta Agrega una asignación.

6. Asigna el activador (SalesforceTriggerCdcRecordID), que es la variable de salida, al conector generado automáticamente (entityId(Fetch Salesforce Data)), que es la variable de entrada.

   Una vez que hayas completado la asignación, cierra el panel. Los cambios se guardarán automáticamente.

7. Agrega una conexión perimetral del activador de Salesforce a la tarea Asignar al ID de oportunidad.
8. Agrega una conexión perimetral desde la tarea Asignar al ID de oportunidad al conector Recuperar datos de Salesforce.

Validar la cuenta de Salesforce en la tabla de BigQuery

Una vez que recuperes todos los detalles de la oportunidad del conector de Salesforce, debes extraer y asignar el ID de la cuenta asociado con la oportunidad, y validar 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 de Cuentas de BigQuery con la conexión de BigQuery:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Conectores en el editor de integración.
3. Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
4. Haz clic en y cambia el nombre de los Conectores a Check account in BigQuery.
5. Haz clic en Configurar conector.
6. Haz lo siguiente en la página Editor de tareas de conectores:
   1. En Seleccionar conexión, elige la región us-central1.
   2. Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
   3. Haz clic en Siguiente.
   4. En Tipo, elige Entidades.
   5. En Establecer entidades/acciones, selecciona cuentas de la lista de entidades disponibles y, luego, Lista como la Operación.
   6. Haz clic en Listo para completar la configuración de conexión y cerrar el panel.
7. Agrega una conexión perimetral desde el conector Recuperar 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:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Asignación de datos en el editor de integración.
3. Haz clic en el elemento Asignación de datos en el diseñador para ver el panel de configuración de tareas.
4. Haz clic en y cambia el nombre de la tarea Asignación de datos a Check account.
5. Haz clic en Abrir editor de asignación de datos.
6. 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

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

8. Agrega una conexión perimetral desde el conector de verificación de la cuenta en BigQuery a la tarea de verificación de la cuenta.

Crear nueva cuenta de BigQuery

Una vez que hayas validado la cuenta de Salesforce en BigQuery, y si la cuenta no existe, sigue estos pasos para crear una cuenta nueva en BigQuery. También usarás la misma información para crear una cuenta en ServiceNow.

Agrega una cuenta a BigQuery

Sigue estos pasos para configurar una tarea de Conectores que cree una entidad nueva en la tabla Cuentas de BigQuery:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Conectores en el editor de integración.
3. Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
4. Haz clic en y cambia el nombre de los Conectores a Create account in BigQuery.
5. Haz clic en Configurar conector.
6. Haz lo siguiente en la página Editor de tareas de conectores:
   1. En Seleccionar conexión, elige la región us-central1.
   2. Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
   3. Haz clic en Siguiente.
   4. En Tipo, elige Entidades.
   5. En Establecer entidades/acciones, selecciona cuentas de la lista de entidades disponibles y, luego, Crear como la Operación.
   6. Haz clic en Listo para completar la configuración de conexión y cerrar el panel.

Crear una cuenta de ServiceNow nueva

Sigue estos pasos para configurar una tarea de conectores que agregue una cuenta nueva a tu instancia de ServiceNow:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Conectores en el editor de integración.
3. Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
4. Haz clic en y cambia el nombre de los Conectores a Create account in ServiceNow.
5. Haz clic en Configurar conector.
6. Haz lo siguiente en la página Editor de tareas de conectores:
   1. En Seleccionar conexión, elige la región us-central1.
   2. Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
   3. Haz clic en Siguiente.
   4. En Tipo, elige Entidades.
   5. En Establecer entidades/acciones, selecciona system_user en la lista de entidades disponibles y, luego, Crear como la Operación.
   6. Haz clic en Listo para completar la configuración de conexión y cerrar el panel.

Transforma y asigna detalles de la cuenta

Para transformar los detalles de la cuenta y asignarlos a los conectores de BigQuery y ServiceNow, haz lo siguiente:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Asignación de datos en el editor de integración.
3. Haz clic en el elemento Asignación de datos en el diseñador para ver el panel de configuración de tareas.
4. Haz clic en y cambia el nombre de la tarea Asignación de datos a Mapping for Account Creation.
5. Haz clic en Abrir editor de asignación de datos.
6. Haz clic en + Agregar nueva variable y crea las siguientes variables de entrada:

   Nombre de variable de entrada	Tipo de datos
   new_BQaccount	JSON
   new_SNaccount	JSON

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

8. Agrega una conexión perimetral desde la tarea Asignación para la creación de cuenta al conector Crear una cuenta en BigQuery.
9. Agrega una conexión perimetral desde la tarea Asignación para la creación de cuentas al conector Crear cuenta en ServiceNow.

Crear un pedido nuevo en BigQuery

Haz lo siguiente para generar un número de pedido y agregarlo a BigQuery.

Agrega el pedido a BigQuery

Sigue estos pasos para configurar una tarea de Conectores que cree una entidad nueva en la tabla Pedidos de BigQuery:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Conectores en el editor de integración.
3. Haz clic en el elemento de tarea Conectores en el diseñador para ver el panel de configuración de tarea de Conectores.
4. Haz clic en y cambia el nombre de los Conectores a Create order in BigQuery.
5. Haz clic en Configurar conector.
6. Haz lo siguiente en la página Editor de tareas de conectores:
   1. En Seleccionar conexión, elige la región us-central1.
   2. Selecciona tu conexión de BigQuery de la lista de conexiones disponibles.
   3. Haz clic en Siguiente.
   4. En Tipo, elige Entidades.
   5. En Establecer entidades/acciones, selecciona Pedidos en la lista de entidades disponibles y, luego, Crear como la Operación.
   6. Haz clic en Listo para completar la configuración de conexión y cerrar el panel.

Genera un pedido y una asignación a BigQuery

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Asignación de datos en el editor de integración.
3. Haz clic en el elemento Asignación de datos en el diseñador para ver el panel de configuración de tareas.
4. Haz clic en y cambia el nombre de la tarea Asignación de datos a Mapping for Order Creation.
5. Haz clic en Abrir editor de asignación de datos.
6. Haz clic en + Agregar nueva variable y crea la siguiente variable:

   Nombre de la variable	Tipo de datos
   order_number	STRING

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

8. Agrega una conexión perimetral desde el conector Crear una cuenta en BigQuery a la tarea Asignación para la creación de pedidos.
9. Agrega una conexión perimetral desde el conector Crear cuenta en ServiceNow a la tarea Asignación para la creación de pedidos.
10. Agrega una conexión perimetral desde la tarea Asignación para la creación de pedidos al conector Crear pedido en BigQuery.

Actualizar oportunidad de Salesforce

Una vez que hayas generado el nuevo número de pedido, actualizarás la oportunidad de origen de Salesforce

Configura el conector de Salesforce

Sigue estos pasos para configurar la tarea Conectores que actualice la oportunidad existente de Salesforce:

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Conectores en el editor de integración.
3. Haz clic en el elemento de la tarea Conectores en el diseñador para ver el panel de configuración de tareas de conectores.
4. Haz clic en y cambia el nombre de los Conectores a Update Salesforce.
5. Haz clic en Configurar conector.
6. Haz lo siguiente en la página Editor de tareas de conectores:
   1. En Seleccionar conexión, elige la región us-central1.
   2. Selecciona tu conexión de Salesforce en la lista de conexiones disponibles.
   3. Haz clic en Siguiente.
   4. En Tipo, elige Entidades.
   5. En Establecer entidades/acciones, selecciona Oportunidad en la lista de entidades disponibles y, luego, Actualizar como la Operación.
   6. Haz clic en Listo para completar la configuración de conexión y cerrar el panel.

Asigna el número de pedido a Salesforce

1. En el editor de integración, haz clic en Tasks para mostrar una lista de las tareas disponibles.
2. Haz clic y coloca el elemento Asignación de datos en el editor de integración.
3. Haz clic en el elemento Asignación de datos en el diseñador para ver el panel de configuración de tareas.
4. Haz clic en y cambia el nombre de la tarea Asignación de datos a Mapping to update opportunity.
5. Haz clic en Abrir editor de asignación de datos.
6. 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.

7. Agrega una conexión perimetral desde el conector Crear pedido en BigQuery a la tarea Asignación para actualizar oportunidad.
8. Agrega una conexión perimetral desde la tarea Asignación para actualizar oportunidad al conector de Actualizar Salesforce.

Agregar 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 perimetral para definir el flujo de la integración.

La siguiente condición perimetral controla el flujo de la integración según la validación de la información de la cuenta:

1. Agrega una conexión perimetral de la tarea Verificar cuenta a la tarea Asignación para la creación de cuentas con la siguiente condición perimetral:

     $account_exists$ = False

2. Agrega otra conexión perimetral de la tarea Verificar cuenta a la tarea Asignación para creación de pedidos con la siguiente condición perimetral:

     $account_exists$ = True

Flujo de integración de muestra

En la siguiente figura, se muestra un ejemplo de diseño de la integración que se creó con este instructivo.

Publica y prueba la integración

Para publicar la integración, haz clic en Publicar 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: Para verificar si se creó 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 la tabla de BigQuery.

Para verificar el éxito de la integración, haz lo siguiente:

1. Ve a la página de BigQuery.

   Ir a BigQuery

   • Abre la tabla Cuentas y verifica la inserción del nuevo ID de la cuenta de oportunidad.
   • Abre la tabla Pedidos y verifica la inserción de los detalles del pedido nuevo.
2. Ve a tu instancia de ServiceNow.
   • Verifica si se agrega una nueva cuenta a tu instancia que contiene el mismo ID de cuenta de oportunidad de Salesforce.
3. Abre Salesforce.
   • Verifica si se actualizó la oportunidad 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 la tabla de BigQuery.

Para verificar el éxito de la integración, haz lo siguiente:

1. Ve a la página de BigQuery.

   Ir a BigQuery

   • Abre la tabla Cuentas y verifica que NO se haya insertado ningún ID de cuenta nuevo.
   • Abre la tabla Pedidos y verifica la inserción de los detalles del pedido nuevo.
2. Abre Salesforce.
   • Verifica si se actualizó la oportunidad con el nuevo número de pedido.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados 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 Cómo borrar integraciones para obtener más información.
• Si deseas obtener información para borrar una conexión, consulta Administra conectores.