Automatize a oportunidade do Salesforce para fazer pedidos no BigQuery

Neste tutorial, descrevemos um caso de uso sobre como usar a Application Integration para automatizar um fluxo de gerenciamento de pedidos entre um aplicativo de gestão de relacionamento com o cliente (CRM) e um aplicativo de planejamento de recursos empresariais (ERP).

Visão geral

As empresas usam vários aplicativos de CRM e ERP para criar, processar, gerenciar e manter pedidos de vendas. Cada um desses aplicativos é processado por diferentes equipes ou organizações, e é difícil garantir que o pedido seja constantemente rastreado e, ao mesmo tempo, oferecer atualizações oportunas aos clientes.

Neste tutorial, você vai criar uma integração que usa um acionador do Salesforce para se inscrever em um novo evento de oportunidade no Salesforce. Quando uma nova oportunidade é criada, a integração recupera detalhes adicionais da oportunidade, como ID e nome da conta. Esses detalhes são verificados em uma tabela do BigQuery para criar e atualizar a oportunidade com um número de pedido de rastreamento. Durante a validação, se as informações da conta não existirem no BigQuery, a integração vai criar automaticamente uma nova entrada na tabela do BigQuery e na instância do ServiceNow anexada usando os Integration Connectors.

Oportunidade do Salesforce para diagrama de pedidos do BigQuery Oportunidade do Salesforce para diagrama de pedidos do BigQuery

Objetivos

Neste tutorial, mostramos como concluir as seguintes tarefas na sua integração:

  • Configure o gatilho do Salesforce para invocar sua integração.
  • Adicione e configure tarefas de conectores para conexões do Salesforce, BigQuery e ServiceNow.
  • Adicione e configure tarefas de mapeamento de dados para extrair e mapear detalhes de oportunidades.

Custos

Neste tutorial, você usará os seguintes componentes faturáveis do Google Cloud:

As instruções deste tutorial foram projetadas para manter seu uso de recursos dentro dos limites do nível Sempre gratuito do Google Cloud.

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Saiba mais em Limpeza.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

  2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Ative a API BigQuery.

    Ative a API

  5. Crie uma conta de serviço:

    1. No Console do Google Cloud, acesse a página Criar conta de serviço.

      Acesse "Criar conta de serviço"
    2. Selecione o projeto.

    3. No campo Nome da conta de serviço, insira um nome. O Console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.

      No campo Descrição da conta de serviço, insira uma descrição. Por exemplo, Service account for quickstart.

    4. Clique em Criar e continuar.

    5. Conceda os papéis a seguir à conta de serviço: 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 conceder um papel, encontre a lista Selecionar um papel e escolha uma opção.

      Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.

    6. Clique em Continuar.

    7. Clique em Concluído para terminar a criação da conta de serviço.

  6. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  7. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  8. Ative a API BigQuery.

    Ative a API

  9. Crie uma conta de serviço:

    1. No Console do Google Cloud, acesse a página Criar conta de serviço.

      Acesse "Criar conta de serviço"
    2. Selecione o projeto.

    3. No campo Nome da conta de serviço, insira um nome. O Console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.

      No campo Descrição da conta de serviço, insira uma descrição. Por exemplo, Service account for quickstart.

    4. Clique em Criar e continuar.

    5. Conceda os papéis a seguir à conta de serviço: 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 conceder um papel, encontre a lista Selecionar um papel e escolha uma opção.

      Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.

    6. Clique em Continuar.

    7. Clique em Concluído para terminar a criação da conta de serviço.

Prepare o ambiente

Verificar a configuração de usuário do Salesforce

Neste tutorial, presumimos que você tenha uma conta de desenvolvedor do Salesforce com a configuração de usuário e a permissão definidas. Verifique se a Captura de dados alterados (CDC) está ativada na conta. Saiba como criar uma nova conta em Configurar um usuário de integração.

Configurar o conjunto de dados e a tabela do BigQuery

Neste tutorial, você precisa configurar um conjunto de dados do BigQuery e criar duas tabelas para armazenar os detalhes da oportunidade do Salesforce e as informações da conta do ServiceNow.

Configurar o conjunto de dados do BigQuery

Para configurar o conjunto de dados do BigQuery, faça o seguinte:

  1. Acesse a página do BigQuery no Console do Google Cloud.

    Acessar o BigQuery

  2. Clique no painel Explorer e selecione o projeto que você está usando para este tutorial.
  3. Expanda (Ações) e selecione Criar conjunto de dados.
  4. Configure os seguintes detalhes na página Criar conjunto de dados:
    1. ID do conjunto de dados: insira Demo_order_dataset.
    2. Tipo de local > Região:escolha a região us-central1 (lowa).
  5. Clique em Criar conjunto de dados.

    6. O novo conjunto de dados Demo_order_dataset aparecerá no painel Explorer do projeto.

Configurar tabelas do BigQuery

Para criar as tabelas do BigQuery, faça o seguinte:

  1. No painel Explorer, clique e abra o conjunto de dados Demo_order_dataset criado.
  2. Siga estas etapas para criar uma tabela Orders vazia e armazenar os detalhes da oportunidade do Salesforce:
    1. Clique em Criar tabela.
    2. Na seção Destino, insira Orders como o nome da tabela.
    3. Na seção Esquema, clique em Editar como texto e cole a seguinte definição 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. Clique em Criar tabela.
  3. Siga estas etapas para criar uma tabela Accounts vazia e armazenar os detalhes da conta do Salesforce:
    1. Clique em Criar tabela.
    2. Na seção Destino, insira Accounts como o nome da tabela.
    3. Na seção Esquema, clique em Editar como texto e cole a seguinte definição 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. Clique em Criar tabela.

    As novas tabelas Orders e Accounts agora devem aparecer no conjunto de dados Demo_order_dataset no painel Explorer.

Verificar a instância do ServiceNow

Este tutorial usa uma instância de desenvolvedor pessoal (PDI) gratuita do ServiceNow. É possível usar a instância do ServiceNow existente ou criar uma nova. Verifique se a instância está ativa e anote o URL dela. Para mais informações sobre PDI, consulte a documentação do ServiceNow PDI.

Configurar conexões

Para este tutorial, é preciso configurar as seguintes conexões nos Conectores de integração:

Conexão com o Salesforce
Configurar uma conexão do Salesforce nos Integration Connectors. Para informações sobre a configuração de um conector do Salesforce, consulte Conector do Salesforce.
Conexão com o BigQuery
Configure uma conexão do BigQuery nos Integration Connectors para receber, atualizar e validar detalhes do pedido e da conta no conjunto de dados Demo_order_dataset. Para informações sobre a configuração de um conector do BigQuery, consulte Conector do BigQuery.
Conexão do ServiceNow
Configure uma conexão do ServiceNow nos Integration Connectors usando o URL da instância para criar e recuperar detalhes da conta. Para informações sobre a configuração de um conector do ServiceNow, consulte Conector do ServiceNow.

Criar integração

Para criar uma nova integração, execute as seguintes etapas:

  1. No console do Google Cloud, acesse a página Application Integration.

    Acessar o Application Integration

  2. No menu de navegação, clique em Integrações. A página Lista de integrações é exibida.
  3. Clique em Criar integração e forneça os seguintes detalhes na página Criar integração:
    1. Nome da integração:insira opportunity-to-order-integration.
    2. Descrição:insira Demo integration created for tutorial.
    3. Região:selecione us-central1 na lista de regiões com suporte.
    4. Clique em Criar para abrir o editor de integração.

Configurar o gatilho de integração

Depois de criar a integração, é possível adicionar e configurar um gatilho de integração que invoque a integração para um evento identificado.

Neste tutorial, um gatilho do Salesforce é usado para invocar a integração para cada nova oportunidade criada na instância do Salesforce. Para adicionar e configurar um gatilho do Salesforce na sua integração do opportunity-to-order-integration, faça o seguinte:

  1. No editor de integração, clique em Acionadores para exibir uma lista de acionadores disponíveis.
  2. Clique e coloque o elemento acionador do Salesforce no editor de integração.
  3. Selecione o elemento Trigger do Salesforce na tela do designer para abrir o painel de configuração do gatilho do Salesforce.
  4. Configure os campos a seguir em Trigger Input:
    1. Tipo de evento: selecione Alterar captura de dados (CDC) na lista suspensa.
    2. Configuração da instância do Salesforce: clique na opção + Add new Salesforce instance configuration na lista suspensa.

      Na caixa de diálogo Add Salesforce instance configuration, faça o seguinte:

      • Nome da conexão da instância do Salesforce: insira um nome de conexão para a instância do Salesforce. Por exemplo, test.
      • Domínio do Salesforce: digite seu nome de domínio do Salesforce. Você encontra essas informações na página Conta do Salesforce > Ver perfil.
      • Perfil de autenticação: selecione um perfil de autenticação. Se você não tiver um perfil de autenticação, crie um novo. Para mais informações, consulte Criar um novo perfil de autenticação.
      • Clique em Adicionar.
    3. Configuração de canal do Salesforce: clique na opção + Adicionar nova configuração de canal do Salesforce na lista suspensa.

      Na caixa de diálogo Add Salesforce channel, faça o seguinte:

      • Nome do objeto do Salesforce: digite Opportunity.
      • Clique em Adicionar.
    4. Operação: selecione Criar na lista suspensa

      5. As alterações nas propriedades são salvas automaticamente.

Mapear payload do gatilho para o conector do Salesforce

Quando a integração é invocada usando o gatilho do Salesforce, você extrai o ID da oportunidade e o mapeia para um conector do Salesforce para recuperar mais detalhes.

Conectar-se à conta do Salesforce

Siga as etapas abaixo para adicionar e configurar uma tarefa Connectors e recuperar os detalhes da oportunidade usando a conexão do Salesforce:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e coloque o elemento Conectores no editor de integração.
  3. Selecione o elemento de tarefa Conectores no designer para visualizar o painel de configuração da tarefa Conectores.
  4. Clique em e renomeie o rótulo Conectores como Fetch Salesforce Data.
  5. Clique em Configurar conector.
  6. Faça o seguinte na página Editor de tarefas de conectores:
    1. Em Selecionar conexão, escolha a região us-central1.
    2. Selecione sua conexão do Salesforce na lista de conexões disponíveis.
    3. Clique em Próxima.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione Oportunidade na lista de entidades disponíveis e escolha Obter como a Operação.
    6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Extrair e mapear o ID da oportunidade

Uma tarefa de Mapeamento de dados é usada para mapear e extrair os detalhes da oportunidade entre esse acionador e o conector do Salesforce.

Para adicionar e configurar o mapeamento de dados na sua integração, faça o seguinte:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
  3. Selecione o elemento Mapeamento de dados no designer para visualizar o painel de configuração da tarefa.
  4. Clique em e renomeie a tarefa Mapeamento de dados como Map to opportunity ID.
  5. Clique em Abrir editor de mapeamento de dados.

    O Editor de mapeamento de dados permite mapear variáveis de entrada para as variáveis de saída desejadas, usando as funções de transformação disponíveis. A saída é disponibilizada como uma variável para qualquer outra tarefa ou gatilho de integração. Para mais detalhes sobre variáveis de mapeamento, consulte Adicionar um mapeamento.

  6. Associe a variável de entrada do acionador (SalesforceTriggerCdcRecordID) à variável de entrada entityId(Fetch Salesforce Data) do conector gerado automaticamente.

    Quando o mapeamento for concluído, feche o painel. Todas as alterações serão salvas automaticamente.

  7. Adicione uma conexão de borda do gatilho Salesforce à tarefa Mapear para o ID da oportunidade.
  8. Adicione uma conexão de borda da tarefa Mapear para o ID da oportunidade ao conector Buscar dados do Salesforce.

Validar a conta do Salesforce na tabela do BigQuery

Depois de recuperar todos os detalhes da oportunidade no conector do Salesforce, extraia e mapeie o ID da conta associado à oportunidade e valide a existência dela na sua tabela do BigQuery.

Conectar-se à tabela do BigQuery

Siga estas etapas para configurar uma tarefa Conectores que lê as tabelas Accounts do BigQuery usando a conexão do BigQuery:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e coloque o elemento Conectores no editor de integração.
  3. Clique no elemento de tarefa dos Conectores no designer para ver o painel de configuração da tarefa dos Conectores.
  4. Clique em e renomeie os Conectores como Check account in BigQuery.
  5. Clique em Configurar conector.
  6. Faça o seguinte na página Editor de tarefas de conectores:
    1. Em Selecionar conexão, escolha a região us-central1.
    2. Selecione sua conexão com o BigQuery na lista de conexões disponíveis.
    3. Clique em Próxima.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione contas na lista de entidades disponíveis e selecione Lista como a Operação.
    6. Clique em Concluído para concluir a configuração da conexão e feche o painel.
  7. Adicione uma conexão de borda do conector Buscar dados do Salesforce ao conector Verificar conta no BigQuery.

Extrair e validar o ID da conta do Salesforce

Para extrair, mapear e validar o ID da conta da oportunidade, faça o seguinte:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
  3. Clique no elemento Data Mapping no designer para visualizar o painel de configuração da tarefa.
  4. Clique em e renomeie a tarefa Mapeamento de dados como Check account.
  5. Clique em Abrir editor de mapeamento de dados.
  6. Clique em + Adicionar nova variável e crie as seguintes variáveis de saída:
    Nome da variável de saída Tipo de dados
    sf_account_id STRING
    sf_account_name STRING
    account_exists BOOLEAN
  7. Crie o seguinte mapeamento entre a variável de payload do conector do Salesforce e a variável local:
    Entrada Saída 
    
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

    Quando o mapeamento for concluído, feche o painel. Todas as alterações serão salvas automaticamente.

  8. Adicione uma conexão de borda do conector Verificar conta no BigQuery à tarefa Verificar conta.

Criar nova conta do BigQuery

Depois de validar a conta do Salesforce no BigQuery, se ela não existir, faça o seguinte para criar uma nova conta no BigQuery. Você também vai usar as mesmas informações para criar uma conta no ServiceNow.

Adicionar conta ao BigQuery

Siga estas etapas para configurar uma tarefa Conectores que cria uma nova entidade na tabela Contas do BigQuery:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e coloque o elemento Conectores no editor de integração.
  3. Clique no elemento de tarefa dos Conectores no designer para ver o painel de configuração da tarefa dos Conectores.
  4. Clique em e renomeie os Conectores como Create account in BigQuery.
  5. Clique em Configurar conector.
  6. Faça o seguinte na página Editor de tarefas de conectores:
    1. Em Selecionar conexão, escolha a região us-central1.
    2. Selecione sua conexão com o BigQuery na lista de conexões disponíveis.
    3. Clique em Próxima.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione contas na lista de entidades disponíveis e escolha Criar como a Operação.
    6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Criar uma nova conta do ServiceNow

Siga as etapas abaixo para configurar uma tarefa Connectors que adiciona uma nova conta à instância do ServiceNow:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e coloque o elemento Conectores no editor de integração.
  3. Clique no elemento de tarefa dos Conectores no designer para ver o painel de configuração da tarefa dos Conectores.
  4. Clique em e renomeie os Conectores como Create account in ServiceNow.
  5. Clique em Configurar conector.
  6. Faça o seguinte na página Editor de tarefas de conectores:
    1. Em Selecionar conexão, escolha a região us-central1.
    2. Selecione sua conexão com o BigQuery na lista de conexões disponíveis.
    3. Clique em Próxima.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione system_user na lista de entidades disponíveis e depois selecione Criar como a Operação.
    6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Transformar e mapear detalhes da conta

Para transformar os detalhes da conta e mapeá-los nos conectores do BigQuery e do ServiceNow, faça o seguinte:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
  3. Clique no elemento Data Mapping no designer para visualizar o painel de configuração da tarefa.
  4. Clique em e renomeie a tarefa Mapeamento de dados como Mapping for Account Creation.
  5. Clique em Abrir editor de mapeamento de dados.
  6. Clique em + Adicionar nova variável e crie as seguintes variáveis de entrada:
    Nome da variável de entrada Tipo de dados
    new_BQaccount JSON
    new_SNaccount JSON
  7. Crie o seguinte mapeamento para mapear o ID e o nome da conta do Salesforce para a tabela do BigQuery:
    Entrada Saída 
    
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)

    Quando o mapeamento for concluído, feche o painel. Todas as alterações serão salvas automaticamente.

  8. Adicione uma conexão de borda da tarefa Mapeamento para criação de conta ao conector Criar conta no BigQuery.
  9. Adicione uma conexão de borda da tarefa Mapeamento para criação de conta ao conector Criar conta no ServiceNow.

Criar novo pedido no BigQuery

Faça o seguinte para gerar um número de pedido e adicioná-lo ao BigQuery.

Adicionar pedido ao BigQuery

Siga estas etapas para configurar uma tarefa Conectores que cria uma nova entidade na tabela Pedidos do BigQuery:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e coloque o elemento Conectores no editor de integração.
  3. Clique no elemento de tarefa dos Conectores no designer para ver o painel de configuração da tarefa dos Conectores.
  4. Clique em e renomeie os Conectores como Create order in BigQuery.
  5. Clique em Configurar conector.
  6. Faça o seguinte na página Editor de tarefas de conectores:
    1. Em Selecionar conexão, escolha a região us-central1.
    2. Selecione sua conexão com o BigQuery na lista de conexões disponíveis.
    3. Clique em Próxima.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione Pedidos na lista de entidades disponíveis e escolha Criar como a Operação.
    6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Gerar pedido e mapear para BigQuery

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
  3. Clique no elemento Data Mapping no designer para visualizar o painel de configuração da tarefa.
  4. Clique em e renomeie a tarefa Mapeamento de dados como Mapping for Order Creation.
  5. Clique em Abrir editor de mapeamento de dados.
  6. Clique em + Adicionar nova variável e crie a seguinte variável:
    Nome da variável Tipo de dados
    order_number STRING
  7. Crie o mapeamento a seguir para gerar um novo número de pedido e mapear os detalhes do pedido para o conector do BigQuery:
    Entrada Saída 
    
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)

    Quando o mapeamento for concluído, feche o painel. Todas as alterações serão salvas automaticamente.

  8. Adicione uma conexão de borda do conector Criar conta no BigQuery à tarefa Mapear para criação de pedidos.
  9. Adicione uma conexão de borda do conector Criar conta no ServiceNow à tarefa Mapear para criação de pedidos.
  10. Adicione uma conexão de borda da tarefa Mapping for Order Creation ao conector Create Order in BigQuery.

Atualizar oportunidade do Salesforce

Depois de gerar o novo número do pedido, você atualiza a oportunidade de origem do Salesforce

Configurar o conector do Salesforce

Siga estas etapas para configurar uma tarefa Connectors que atualiza a oportunidade do Salesforce existente:

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e coloque o elemento Conectores no editor de integração.
  3. Clique no elemento de tarefa Conectores no designer para visualizar o painel de configuração da tarefa Conectores.
  4. Clique em e renomeie os Conectores como Update Salesforce.
  5. Clique em Configurar conector.
  6. Faça o seguinte na página Editor de tarefas de conectores:
    1. Em Selecionar conexão, escolha a região us-central1.
    2. Selecione sua conexão do Salesforce na lista de conexões disponíveis.
    3. Clique em Próxima.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione Oportunidade na lista de entidades disponíveis e depois Atualizar como a Operação.
    6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Mapear o número do pedido para o Salesforce

  1. No editor de integração, clique em Tarefas para exibir uma lista das tarefas disponíveis.
  2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
  3. Clique no elemento Data Mapping no designer para visualizar o painel de configuração da tarefa.
  4. Clique em e renomeie a tarefa Mapeamento de dados como Mapping to update opportunity.
  5. Clique em Abrir editor de mapeamento de dados.
  6. Crie o mapeamento a seguir para atualizar a oportunidade do Salesforce:
    Entrada Saída 
    
"{}"
.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 )

    Quando o mapeamento for concluído, feche o painel. Todas as alterações serão salvas automaticamente.

  7. Adicione uma conexão de borda do conector Criar ordem no BigQuery à tarefa Mapeamento para atualizar a oportunidade.
  8. Adicione uma conexão de borda da tarefa Mapeamento para atualizar oportunidade ao conector Atualizar Salesforce.

Adicionar condição de borda

Uma condição de borda permite especificar as condições que precisam ser atendidas para que o controle de uma integração passe para a tarefa conectada pela borda. Agora que você adicionou e configurou as tarefas necessárias, pode adicionar uma condição de borda para definir o fluxo da integração.

A seguinte condição de borda controla o fluxo de integração com base na validação das informações da conta:

  1. Adicione uma conexão de borda da tarefa Verificar conta à tarefa Mapeamento para criação de conta com a seguinte condição de borda: 
      $account_exists$ = False
  2. Adicione outra conexão de borda da tarefa Verificar conta à tarefa Mapear para criação de pedidos com a seguinte condição de borda: 
      $account_exists$ = True

Exemplo de fluxo de integração

A figura a seguir mostra um exemplo de layout da integração criada usando este tutorial.

Imagem de exemplo mostrando o fluxo de integração Imagem de exemplo mostrando o fluxo de integração

Publicar e testar a integração

Para publicar a integração, clique em Publicar na barra de ferramentas do editor de integração.

Após a publicação da integração, você poderá ver e inspecionar os registros de execução da integração publicada. Para acessar registros, clique em imagem mostrando o ícone de registros de execuçãoExibir registros de execução para esta integração. A página Registros de execução é exibida.

Caso de teste 1: verificar se um número de pedido foi criado para um novo ID de conta

Para testar a integração, faça login na instância do Salesforce e crie uma oportunidade. Crie a oportunidade em uma nova conta ou em uma conta que não existe na sua tabela do BigQuery.

Para verificar o sucesso da sua integração:

  1. Acessar a página do BigQuery.

    Acessar o BigQuery

    • Abra a tabela Contas e confirme a inserção do novo ID da conta da oportunidade.
    • Abra a tabela Pedidos e verifique se os novos detalhes do pedido foram inseridos.
  2. Acesse sua instância do ServiceNow.
    • Confirme se uma nova conta foi adicionada à sua instância com o mesmo ID da conta de oportunidade do Salesforce.
  3. Abra o Salesforce.
    • Verifique se a oportunidade está atualizada com o novo número do pedido.

Caso de teste 2: verificar se um número de pedido foi criado para um ID de conta existente no BigQuery

Para testar a integração, faça login na instância do Salesforce e crie uma oportunidade. É preciso criar a oportunidade em uma conta atual que também existe na sua tabela do BigQuery.

Para verificar o sucesso da sua integração:

  1. Acessar a página do BigQuery.

    Acessar o BigQuery

    • Abra a tabela Contas e confirme se NENHUM novo ID de conta foi inserido.
    • Abra a tabela Pedidos e verifique se os novos detalhes do pedido foram inseridos.
  2. Abra o Salesforce.
    • Verifique se a oportunidade está atualizada com o novo número do pedido.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste tutorial, cancele a publicação da integração e exclua as conexões criadas nos Integration Connectors.

  • Para cancelar a publicação da integração, clique em Cancelar publicação na barra de ferramentas do editor de integração. Consulte Excluir integrações para mais informações.
  • Para informações sobre como excluir uma conexão, consulte Gerenciar conectores.