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.

Objetivos

Este tutorial mostra como concluir as seguintes tarefas na sua integração:

• Configure o acionador do Salesforce para invocar a integração.
• Adicione e configure tarefas de conetores para ligações do Salesforce, Jira Cloud e ServiceNow.
• Adicione e configure tarefas de mapeamento de dados para extrair e mapear detalhes de registos.

Custos

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

• Integração de aplicações
• Conetores de integração
• Secret Manager

As instruções neste tutorial foram concebidas para manter a sua utilização de recursos dentro dos limites do nível Sempre grátis do Google Cloud.

Quando terminar as tarefas descritas neste documento, pode evitar a faturação contínua eliminando os recursos que criou. Para mais informações, consulte o artigo Limpe.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator). Learn how to grant roles.

2. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
3. Select your project.

4. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

5. Click Create and continue.

6. Grant the following roles to the service account: Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click Add another role and add each additional role.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
7. Click Continue.

8. Click Done to finish creating the service account.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator). Learn how to grant roles.

2. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
3. Select your project.

4. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

5. Click Create and continue.

6. Grant the following roles to the service account: Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click Add another role and add each additional role.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
7. Click Continue.

8. Click Done to finish creating the service account.

Nota: todas as outras APIs Google Cloud necessárias, como a API Application Integration, a API Secret Manager e a API Connectors, são ativadas durante a configuração do Application Integration. Para mais detalhes, consulte o artigo Configure a integração de aplicações.

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:

Dica: recomendamos que crie as seguintes associações na região us-central1(lowa).

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

   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 Case na lista de entidades disponíveis e, de seguida, selecione Get 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 desejadas, 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.



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

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