Automatizar a conversão de oportunidades do Salesforce em pedidos do BigQuery

Prepare o ambiente

Verificar a configuração do 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, na sigla em inglês) está ativada na sua conta. Para saber como criar uma conta, consulte Configurar um usuário de integração.

Configurar o conjunto de dados e a tabela do BigQuery

Neste tutorial, você precisa configurar um dataset 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 more_vert (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.

O novo conjunto de dados Demo_order_dataset vai aparecer no projeto no painel Explorer.

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 add_box 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 Contas vazia e armazenar os detalhes da conta do Salesforce:
   1. Clique em add_box 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 aparecerão 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, na sigla em inglês) gratuita do ServiceNow. É possível usar sua instância do ServiceNow ou criar uma nova. Verifique se a instância está ativa e anote o URL dela. Para mais informações sobre o PDI, consulte a documentação correspondente do ServiceNow.

Configurar conexões

Para este tutorial, você precisa configurar as seguintes conexões nos Integration Connectors:

Conexão com o Salesforce

Configurar uma conexão do Salesforce no Integration Connectors. Para informações sobre como configurar um conector do Salesforce, consulte Conector do Salesforce.

Conexão com o BigQuery

Configurar uma conexão do BigQuery no Integration Connectors para receber, atualizar e validar detalhes da ordem e da conta no conjunto de dados Demo_order_dataset. Para saber como configurar um conector do BigQuery, consulte Conector do BigQuery.

Conexão do ServiceNow

Configure uma conexão do ServiceNow nos Conectores de integração usando o URL da sua instância para criar e recuperar detalhes da conta no ServiceNow. Para informações sobre como configurar um conector 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 add_box 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 gatilho de integração

Depois de criar sua integração, você pode adicionar e configurar um gatilho de integração que invoca 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 com o 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 gatilho do Salesforce no editor de integração.
3. Selecione o elemento gatilho 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 Adicionar configuração da instância do Salesforce, 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 Adicionar canal do Salesforce, faça o seguinte:

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

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

Mapear o payload do acionador 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 da oportunidade.

Conectar à conta do Salesforce

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

1. No editor de integração, clique em Tasks para mostrar 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 a tarefa Conectores painel de configuração.
4. Clique em edit e renomeie o rótulo Conectores como Fetch Salesforce Data.
5. Clique em Configurar conector.
6. Faça o seguinte na página do 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 Type, escolha Entities.
   5. Em Definir entidades/ações, selecione Oportunidade na lista de entidades disponíveis e Obter como Operação.
   6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Extrair e mapear ID da oportunidade

Uma tarefa Data Mapping é usada para mapear e extrair os detalhes da oportunidade entre o acionador e o conector do Salesforce.

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

1. No editor de integração, clique em Tasks para mostrar 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 de tarefas.
4. Clique em edit e renomeie a tarefa Mapeamento de dados para 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. Mapeie a variável de saída do acionador (SalesforceTriggerCdcRecordID) para a variável de entrada do conector gerada automaticamente (entityId(Fetch Salesforce Data)).

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

Realize as etapas a seguir para configurar uma tarefa de Conectores que lê as tabelas de Contas do BigQuery usando a conexão do BigQuery:

1. No editor de integração, clique em Tasks para mostrar 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 edit e renomeie os Conectores como Check account in BigQuery.
5. Clique em Configurar conector.
6. Faça o seguinte na página do Editor de tarefas de conectores:
   1. Em Selecionar conexão, escolha a região us-central1.
   2. Selecione sua conexão do BigQuery na lista de conexões disponíveis.
   3. Clique em Próxima.
   4. Em Type, escolha Entities.
   5. Em Definir entidades/ações, selecione contas na lista de entidades disponíveis e escolha 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 Tasks para mostrar uma lista das tarefas disponíveis.
2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
3. Clique no elemento Mapeamento de dados no designer para conferir o painel de configuração da tarefa.
4. Clique em edit e renomeie a tarefa Mapeamento de dados para 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 dado
   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, siga estas etapas para criar uma nova conta no BigQuery, se ela não existir. Você também usa as mesmas informações para criar uma conta no ServiceNow.

Adicionar conta ao BigQuery

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

1. No editor de integração, clique em Tasks para mostrar 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 edit e renomeie os Conectores como Create account in BigQuery.
5. Clique em Configurar conector.
6. Faça o seguinte na página do Editor de tarefas de conectores:
   1. Em Selecionar conexão, escolha a região us-central1.
   2. Selecione sua conexão do BigQuery na lista de conexões disponíveis.
   3. Clique em Próxima.
   4. Em Type, escolha Entities.
   5. Em Definir entidades/ações, selecione contas na lista de entidades disponíveis e Criar como 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 de Conectores que adiciona uma nova conta à instância do ServiceNow:

1. No editor de integração, clique em Tasks para mostrar 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 edit e renomeie os Conectores como Create account in ServiceNow.
5. Clique em Configurar conector.
6. Faça o seguinte na página do Editor de tarefas de conectores:
   1. Em Selecionar conexão, escolha a região us-central1.
   2. Selecione sua conexão do 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 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 para os conectores do BigQuery e do ServiceNow, faça o seguinte:

1. No editor de integração, clique em Tasks para mostrar uma lista das tarefas disponíveis.
2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
3. Clique no elemento Mapeamento de dados no designer para visualizar o painel de configuração de tarefas.
4. Clique em edit e renomeie a tarefa Mapeamento de dados para 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 dado
   new_BQaccount	JSON
   new_SNaccount	JSON

7. Crie o seguinte mapeamento para associar o ID e o nome da conta do Salesforce à 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 ordem ao BigQuery

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

1. No editor de integração, clique em Tasks para mostrar 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 edit e renomeie os Conectores como Create order in BigQuery.
5. Clique em Configurar conector.
6. Faça o seguinte na página do Editor de tarefas de conectores:
   1. Em Selecionar conexão, escolha a região us-central1.
   2. Selecione sua conexão do BigQuery na lista de conexões disponíveis.
   3. Clique em Próxima.
   4. Em Type, escolha Entities.
   5. Em Definir entidades/ações, selecione Pedidos na lista de entidades disponíveis e, em seguida, selecione Criar como Operação.
   6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Gerar pedido e mapear para o BigQuery

1. No editor de integração, clique em Tasks para mostrar uma lista das tarefas disponíveis.
2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
3. Clique no elemento Mapeamento de dados no designer para visualizar o painel de configuração de tarefas.
4. Clique em edit e renomeie a tarefa Mapeamento de dados para 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 dado
   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 Mapeamento para criação de pedidos.
9. Adicione uma conexão de borda do conector Criar conta no ServiceNow à tarefa Mapeamento para a criação de pedidos.
10. Adicione uma conexão de borda da tarefa Mapeamento para criação de pedidos ao conector Criar pedido no BigQuery.

Atualizar oportunidade do Salesforce

Depois de gerar o novo número do pedido, atualize a oportunidade de origem do Salesforce.

Configurar o conector do Salesforce

Siga estas etapas para configurar uma tarefa de Conectores que atualiza a oportunidade atual do Salesforce:

1. No editor de integração, clique em Tasks para mostrar 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 a tarefa Conectores painel de configuração.
4. Clique em edit e renomeie os Conectores como Update Salesforce.
5. Clique em Configurar conector.
6. Faça o seguinte na página do 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 Type, escolha Entities.
   5. Em Definir entidades/ações, selecione Oportunidade na lista de entidades disponíveis e Atualizar como Operação.
   6. Clique em Concluído para concluir a configuração da conexão e feche o painel.

Mapear número de pedido para o Salesforce

1. No editor de integração, clique em Tasks para mostrar uma lista das tarefas disponíveis.
2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
3. Clique no elemento Mapeamento de dados no designer para visualizar o painel de configuração de tarefas.
4. Clique em edit e renomeie a tarefa Mapeamento de dados para Mapping to update opportunity.
5. Clique em Abrir editor de mapeamento de dados.
6. Crie o seguinte mapeamento 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 pedido no BigQuery à tarefa Mapeamento para atualizar a oportunidade.
8. Adicione uma conexão de borda da tarefa Mapear para atualizar a oportunidade ao conector Atualizar o 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, adicione uma condição de borda para definir o fluxo da integração.

A condição de borda a seguir 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 Mapeamento 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.

Publique e teste 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 os registros, clique em Acessar os 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 nova oportunidade. Você precisa criar a oportunidade em uma conta nova ou 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 Orders e verifique se os novos detalhes do pedido foram inseridos.
2. Acesse sua instância do ServiceNow.
   • Confirme se uma nova conta foi adicionada à instância com o mesmo ID da conta de oportunidade do Salesforce.
3. Abra o Salesforce.
   • Verifique se a oportunidade foi 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 no BigQuery

Teste a integração fazendo login na instância do Salesforce e criando uma nova oportunidade. Você precisa criar a oportunidade em uma conta que também exista 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 da conta foi inserido.
   • Abra a tabela Pedidos e verifique para confirmar a inserção dos novos detalhes do pedido.
2. Abra o Salesforce.
   • Verifique se a oportunidade foi 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 no Integration Connectors.

• Para cancelar a publicação dessa 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 mais informações sobre como excluir uma conexão, consulte Gerenciar conectores.