Automatize as atribuições de encaminhamento de registos do Salesforce

Este tutorial descreve um exemplo de utilização de como pode usar a integração de aplicações para automatizar o fluxo do processo empresarial de encaminhamento e atribuição de um registo de cliente do Salesforce.

Vista geral

Neste tutorial, vai criar uma integração que usa um acionador do Salesforce para subscrever um canal de registo no Salesforce. Um novo registo no Salesforce invoca a integração, que extrai o ID do registo e o tipo de registo. Consoante o tipo de registo, é criado um novo problema ou incidente no Jira Cloud ou no ServiceNow, respetivamente.

Diagrama de fluxo de casos do Salesforce Diagrama de fluxo de casos do Salesforce

Prepare o seu ambiente

Valide a configuração do utilizador do Salesforce

Este tutorial pressupõe que tem uma conta de programador do Salesforce existente com a configuração de utilizador e o conjunto de autorizações necessários. Verifique se a sua conta tem a captura de dados de alterações (CDC) ativada. Para ver informações sobre como criar uma nova conta, consulte o artigo Configure um utilizador de integração.

Valide a conta do Jira Cloud

Este tutorial usa o Jira Cloud. Pode usar a sua conta do Jira Cloud existente ou criar uma nova. Verifique se o projeto e os quadros do Jira Cloud estão configurados. Para mais informações sobre o Jira Cloud, consulte a documentação do software Jira.

Valide a instância do ServiceNow

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

Configurar ligações

Para este tutorial, tem de configurar as seguintes associações em Conetores de integração:

Associação ao Salesforce
Configure uma ligação do Salesforce nos Conetores de integração. Para informações sobre a configuração de um conetor do Salesforce, consulte o artigo Conetor do Salesforce.
Ligação ao Jira Cloud
Configure uma ligação do Jira Cloud nos Integration Connectors através do URL do projeto para criar problemas do Jira no seu projeto. Certifique-se de que anota o ID do projeto e o ID do problema. Para obter informações sobre a configuração de um conetor do Jira Cloud, consulte o artigo Conetor do Jira Cloud.
Ligação ao ServiceNow
Configure uma ligação do ServiceNow nos Integration Connectors através do URL da instância para criar incidentes no ServiceNow. Para ver informações sobre a configuração de um conetor do ServiceNow, consulte o artigo Conetor do ServiceNow.

Criar integração

Para criar uma nova integração, siga estes passos:

  1. Na Google Cloud Console, aceda à página Integração de aplicações.

    Aceda à solução Application Integration

  2. Clique em Integrações no menu de navegação do lado esquerdo para abrir a página Integrações.
  3. Clique em Criar integração e indique os seguintes detalhes na página Criar integração:
    1. Nome da integração: introduza salesforce-case-integration.
    2. Descrição: introduza Demo integration created for tutorial.
    3. Região: selecione us-central1 na lista de regiões suportadas.
    4. Clique em Criar para abrir o editor de integração.

Configure o acionador de integração

Depois de criar com êxito a integração, pode adicionar e configurar um acionador de integração que invoca a integração para um evento identificado.

Para este tutorial, é usado um acionador do Salesforce para invocar a integração para cada novo registo criado no Salesforce. Para adicionar e configurar um acionador do Salesforce na sua integração do salesforce-case-integration, faça o seguinte:

  1. No editor de integração, clique em Acionadores para apresentar uma lista de acionadores disponíveis.
  2. Clique e coloque o elemento Acionador do Salesforce no editor de integração.
  3. Selecione o elemento Acionador do Salesforce na tela de design para abrir o painel de configuração do acionador do Salesforce.
  4. Configure os seguintes campos em Entrada do acionador:
    1. Tipo de evento: selecione Captura de dados de alterações (CDC) na lista pendente.
    2. Configuração da instância do Salesforce: clique na opção + Adicionar nova configuração da instância do Salesforce na lista pendente.

      Na caixa de diálogo Adicionar configuração da instância do Salesforce, faça o seguinte:

      • Nome da ligação da instância do Salesforce: introduza um nome de ligação para a instância do Salesforce. Por exemplo, test.
      • Domínio do Salesforce: introduza o nome do seu domínio do Salesforce. Pode encontrar estas informações na página Conta do Salesforce > Ver perfil.
      • Perfil de autenticação: selecione um perfil de autenticação. Se não tiver um perfil de autenticação, crie um novo. Para mais informações, consulte o artigo Crie um novo perfil de autenticação.
      • Clique em Adicionar.
    3. Configuração do canal do Salesforce: clique na opção + Adicionar nova configuração do canal do Salesforce na lista pendente.

      Na caixa de diálogo Adicionar canal do Salesforce, faça o seguinte:

      • Nome do objeto do Salesforce: introduza Case.
      • Clique em Adicionar.
    4. Operação: selecione Criar na lista pendente

      5. As alterações às propriedades são guardadas automaticamente.

Mapeie a carga útil do acionador para o conetor do Salesforce

Quando a integração é invocada através do acionador do Salesforce, extrai o ID do registo e mapeia-o para um conetor do Salesforce para obter detalhes adicionais do registo.

Associe a conta do Salesforce

Execute os seguintes passos para adicionar e configurar uma tarefa Conetores para obter os detalhes do registo através da ligação Salesforce:

  1. No editor de integração, clique em Tasks para apresentar uma lista de tarefas disponíveis.
  2. Clique e coloque o elemento Conetores no editor de integração.
  3. Selecione o elemento de tarefa Conetores no criador para ver o painel de configuração da tarefa de conetores.
  4. Clique em e mude o nome da etiqueta Conectores para Fetch Salesforce Data.
  5. Clique em Configurar conetor.
  6. Faça o seguinte na página Editor de tarefas de conetores:
    1. Em Selecionar ligação, escolha a região us-central1.
    2. Selecione a sua ligação do Salesforce na lista de ligações disponíveis.
    3. Clicar em Seguinte.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione Registo na lista de entidades disponíveis e, de seguida, selecione Obter como Operação.
    6. Clique em Concluído para concluir a configuração da associação e fechar o painel.

Extraia e mapeie o ID do registo

Uma tarefa de mapeamento de dados é usada para mapear e extrair os detalhes do registo entre esse acionador do Salesforce e o conetor 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 Tasks para apresentar uma lista de tarefas disponíveis.
  2. Clique e coloque o elemento Mapeamento de dados no editor de integração.
  3. Selecione o elemento Mapeamento de dados no criador para ver o painel de configuração da tarefa.
  4. Clique em e mude o nome da tarefa Mapeamento de dados para Get Case ID.
  5. Clique em Abrir editor de mapeamento de dados.

    O editor de mapeamento de dados permite-lhe mapear variáveis de entrada para as variáveis de saída pretendidas, através das funções de transformação disponíveis. A saída fica, então, disponível como uma variável para qualquer outra tarefa de integração ou acionador. Para ver mais detalhes sobre como mapear variáveis, consulte o artigo Adicione um mapeamento.

  6. Mapeie a variável de saída do acionador —SalesforceTriggerCdcRecordID— para a variável de entrada do conector gerado automaticamente —entityId(Fetch Salesforce Data)—.

    Quando o mapeamento estiver concluído, feche o painel. As alterações são guardadas automaticamente.

  7. Adicione uma ligação de aresta do acionador Salesforce à tarefa Obter ID do registo.
  8. Adicione uma ligação de limite da tarefa Obter ID do registo ao conetor Obter dados do Salesforce.

Extraia o tipo de registo

Depois de obter todos os detalhes do registo do conetor do Salesforce, extrai o tipo de registo e encaminha-o para a aplicação Jira Cloud ou ServiceNow.

Para extrair o tipo de registo do Salesforce, faça o seguinte:

  1. No editor de integração, clique em Tasks para apresentar uma lista de tarefas disponíveis.
  2. Clique e coloque o elemento Mapeamento de dados no editor de integração.
  3. Clique no elemento Mapeamento de dados no criador para ver o painel de configuração da tarefa.
  4. Clique em e mude o nome da tarefa Mapeamento de dados para Get case type.
  5. Clique em Abrir editor de mapeamento de dados.
  6. Clique em + Adicionar nova variável e crie a seguinte variável de saída:
    Nome da variável de saída Tipo de dados
    sf_case_type STRING
  7. Crie o seguinte mapeamento entre a variável de payload do conetor do Salesforce e a variável local:
    Entrada Resultado 
    connectorOutputPayload (Fetch Salesforce Data)
.GET_PROPERTY("Type")
    		sf_case_type

    Quando o mapeamento estiver concluído, feche o painel. As alterações são guardadas automaticamente.

  8. Adicione uma ligação de aresta do conetor Obter dados do Salesforce à tarefa Obter tipo de registo.

Crie um novo problema do Jira

Depois de extrair o tipo de registo do Salesforce e se o registo for do tipo: Engineering, encaminhe-o para o Jira Cloud como um novo problema.

Associe a um projeto do Jira

Siga os passos abaixo para configurar uma tarefa de Conetores que cria um novo problema no seu projeto do Jira:

  1. No editor de integração, clique em Tasks para apresentar uma lista de tarefas disponíveis.
  2. Clique e coloque o elemento Conetores no editor de integração.
  3. Clique no elemento de tarefa Conetores no criador para ver o painel de configuração da tarefa Conetores.
  4. Clique em e mude o nome dos Conectores para Create issue in Jira.
  5. Clique em Configurar conetor.
  6. Faça o seguinte na página Editor de tarefas de conetores:
    1. Em Selecionar ligação, escolha a região us-central1.
    2. Selecione a sua associação do Jira Cloud na lista de associações disponíveis.
    3. Clicar em Seguinte.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione Problemas na lista de entidades disponíveis e, de seguida, selecione Criar como a Operação.
    6. Clique em Concluído para concluir a configuração da associação e fechar o painel.

Transforme e mapeie os detalhes dos problemas

Para transformar os detalhes do registo e mapeá-los para um problema do Jira, faça o seguinte:

  1. No editor de integração, clique em Tasks para apresentar uma lista de tarefas disponíveis.
  2. Clique e coloque o elemento Mapeamento de dados no editor de integração.
  3. Clique no elemento Mapeamento de dados no criador para ver o painel de configuração da tarefa.
  4. Clique em e mude o nome da tarefa Mapeamento de dados para Mapping for issue creation.
  5. Clique em Abrir editor de mapeamento de dados.
  6. Clique em + Adicionar nova variável e crie as seguintes variáveis:
    Nome da variável Tipo de dados Valor predefinido
    jira_project-id STRING 
    JIRA_PROJECT_ID
     Substitua JIRA_PROJECT_ID pelo ID do seu projeto do Jira.
    jira_issue_type_id STRING 
    JIRA_ISSUE_TYPE_ID
     Substitua JIRA_ISSUE_TYPE_ID por qualquer um dos seguintes IDs de tipo de problema:
    • 1000 - para Epic
    • 1001 – para História
    • 1002 - para Tarefa
    • 1003 - para subtarefa
    • 1004 - para erro
  7. Crie o seguinte mapeamento:
    Entrada Resultado 
    "{ "IssueTypeId": jira_issue_type_id, "ProjectId": jira_project_id }"
.TO_JSON()
.SET_PROPERTY(
connectorOutputPayload.Description (Fetch Salesforce Data),  
"Description"
)
.SET_PROPERTY(
connectorOutputPayload.Subject (Fetch Salesforce Data),  
"Summary"
)
    		connectorInputPayload (Create issue in Jira)

    Quando o mapeamento estiver concluído, feche o painel. As alterações são guardadas automaticamente.

  8. Adicione uma associação de aresta da tarefa Mapeamento para a criação de problemas ao conetor Criar problema no Jira.

Crie um novo incidente do ServiceNow

Se o registo extraído do Salesforce for do tipo: Sales, encaminhe-o para o ServiceNow como um novo incidente.

Associe ao ServiceNow

Execute os seguintes passos para configurar uma tarefa de Conectores que crie um novo incidente na sua instância do ServiceNow:

  1. No editor de integração, clique em Tasks para apresentar uma lista de tarefas disponíveis.
  2. Clique e coloque o elemento Conetores no editor de integração.
  3. Clique no elemento de tarefa Conetores no criador para ver o painel de configuração da tarefa Conetores.
  4. Clique em e mude o nome dos Conectores para Create incident in ServiceNow.
  5. Clique em Configurar conetor.
  6. Faça o seguinte na página Editor de tarefas de conetores:
    1. Em Selecionar ligação, escolha a região us-central1.
    2. Selecione a sua associação do ServiceNow na lista de associações disponíveis.
    3. Clicar em Seguinte.
    4. Em Tipo, escolha Entidades.
    5. Em Definir entidades/ações, selecione incidente na lista de entidades disponíveis e, de seguida, selecione Criar como a Operação.
    6. Clique em Concluído para concluir a configuração da associação e fechar o painel.

Transforme e mapeie os detalhes dos incidentes

Para transformar os detalhes do registo e mapeá-los para um incidente do ServiceNow, faça o seguinte:

  1. No editor de integração, clique em Tasks para apresentar uma lista de tarefas disponíveis.
  2. Clique e coloque o elemento Mapeamento de dados no editor de integração.
  3. Clique no elemento Mapeamento de dados no criador para ver o painel de configuração da tarefa.
  4. Clique em e mude o nome da tarefa Mapeamento de dados para Mapping for incident 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:
  7. Crie o seguinte mapeamento:
    Entrada Resultado 
    "{}"
.TO_JSON()
.SET_PROPERTY(
connectorOutputPayload.Description (Fetch Salesforce Data),  
"description"
)
.SET_PROPERTY(
connectorOutputPayload.Subject (Fetch Salesforce Data),  
"short_description"
)
    		connectorInputPayload (Create incident in ServiceNow)

    Quando o mapeamento estiver concluído, feche o painel. As alterações são guardadas automaticamente.

  8. Adicione uma ligação de limite da tarefa Mapeamento para a criação de incidentes ao conetor Criar incidente no ServiceNow.

Adicione uma condição limite

Uma condição limite permite-lhe especificar as condições que têm de ser cumpridas para que o controlo de uma integração seja transmitido à tarefa ligada pelo limite. Agora que adicionou e configurou as tarefas necessárias, pode adicionar uma condição de limite para definir o fluxo da integração.

A seguinte condição limite controla o fluxo da integração com base no tipo de registo do Salesforce:

  1. Adicione uma ligação de aresta da tarefa Get case type à tarefa Mapping for issue creation com a seguinte condição de aresta: 
      $sf_case_type$ = "Engineering"
  2. Adicione outra ligação de aresta da tarefa Get case type à tarefa Mapping for incident creation com a seguinte condição de aresta: 
      $sf_case_type$ = "Sales"

Fluxo de integração de amostra

A figura seguinte mostra um exemplo de esquema da integração criada com este tutorial.

Imagem de exemplo que mostra o fluxo de integração Imagem de exemplo que mostra o fluxo de integração

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 publicar com êxito a integração, pode ver e inspecionar os registos de execução da integração publicada. Para ver os registos, clique em Imagem que mostra o ícone dos registos de execuçãoVer registos de execução desta integração. É apresentada a página Registos de execução.

Caso de teste 1: para verificar se é criado um problema do Jira para um registo de engenharia

Teste a integração iniciando sessão na instância do Salesforce e criando um novo registo. Tem de introduzir Engineering no campo Type (Tipo) ao criar o registo.

Para verificar o êxito da integração:

Aceda à sua conta do Jira Cloud.

  • Verifique se é criado um novo problema no seu projeto com a descrição e o resumo do registo do Salesforce.

Caso de teste 2: para verificar se é criado um incidente do ServiceNow para um registo de vendas

Teste a integração iniciando sessão na instância do Salesforce e criando um novo registo. Tem de introduzir Sales no campo Type (Tipo) ao criar o registo.

Para verificar o êxito da integração:

Aceda à sua instância do ServiceNow.

  • Verifique se é criado um novo incidente na sua instância com a descrição e o resumo do registo do Salesforce.

Limpar

Para evitar incorrer em custos na sua conta do Google Cloud pelos recursos usados neste tutorial, anule a publicação da integração e elimine as associações criadas no Integration Connectors.

  • Para anular a publicação desta integração, clique em Anular publicação na barra de ferramentas do editor de integração. Consulte o artigo Elimine integrações para mais informações.
  • Para obter informações sobre como eliminar uma associação, consulte o artigo Faça a gestão dos conetores.