Gerenciador de transações: Integrações

Use integrações para trocar dados com fontes de terceiros, incluindo Salesforce.

Para coletar informações de fontes de dados externas, como Salesforce no Gerenciador de transações, o administrador cria integrações. As integrações do Gerenciador de transações definem as informações necessárias para se conectar a uma fonte de dados, extrair informações e mapear os dados no Gerenciador de transações. As integrações também podem ser usadas para extrair informações do Gerenciador de transações e enviá-las para serem mapeadas em um ambiente de terceiros.

Para que uma integração possa ser definida para o Gerenciador de transações, o administrador deve primeiro criar uma conexão com o ambiente de terceiros, assim como uma conexão externa no ambiente de configuração. As conexões são definidas na seção Utilitários da IU do administrador.

Criando uma conexão

Antes de definir uma integração, o administrador deve definir uma conexão com a fonte de terceiros para os dados usados pela integração.

Para criar uma nova conexão, na área Utilitários da IU do administrador, clique em Conexões . Em seguida, clique em - Novo Para exibir a página Nova conexão.

Na página Nova conexão, nomeie a nova conexão e atribua um nome de variável. Em seguida, escolha o tipo de integração: Salesforce ou Externo.

Se você estiver criando uma conexão com o Salesforce, nenhum dos outros campos será obrigatório. CPQ Sabe como autenticar e conhece os endpoints necessários para usar ao se comunicar com a Salesforce.

Se você estiver criando uma integração externa, escolha o tipo de autenticação. Os métodos de autenticação compatíveis são Nenhum, Token do portador e OAuth. Se você escolher Token do portador, use o campo Token de autenticação para fornecer o token do portador do site com o qual você está se comunicando. Se você escolher OAuth, use os campos ID do cliente, Segredo do cliente e URL do token para fornecer as informações de OAuth necessárias.

No campo Host, insira o URL do site de terceiros com o qual você se comunicará.

No campo Caminho, insira o caminho para o endpoint que você está tentando acessar no site de terceiros.

Use o campo Cabeçalhos adicionais para adicionar informações de cabeçalho adicionais necessárias ao site de terceiros para executar o endpoint desejado.

Criando uma integração

Para criar uma nova integração, clique em - Adicionar integração . A janela Nova integração é exibida. Dê à nova integração um nome e um nome de variável e clique em Salvar .

A página Editor de integração é aberta. Continue definindo a nova integração definindo as seguintes configurações:

• Método HTTP : Você pode executar uma operação GET, POST, PATCH, PUT ou DELETE, dependendo do endpoint que você está usando no site de terceiros.
• Detalhes do item de linha a serem incluídos : Defina com que tipo de itens de linha você trabalhará na integração. As opções são Linhas selecionadas, Linhas modificadas e Linhas excluídas.
• Caminho adicional : Insira o comando de consulta a ser executado no site de terceiros. Se você estiver se conectando ao Salesforce, provavelmente será uma consulta SOQL. Em outras plataformas, pode ser uma consulta SQL padrão.
• Tempo limite : Define a quantidade de tempo (em milissegundos) que a solicitação aguardará uma resposta antes de declarar um erro.
• Assíncrono : Esta alternância permite executar a consulta de forma assíncrona em segundo plano para que o usuário possa continuar trabalhando.
• Cabeçalhos : Você pode usar texto estático em campos do Gerenciador de transações no nível do cabeçalho usando a sintaxe simples do handlebar, pode definir pares de chave-valor para cabeçalhos ou pode combinar ambos os métodos. (txn.fieldname)

Em seguida, você precisa definir a conexão com o endpoint. Aqui, você pode escolher em uma lista de conexões criadas anteriormente na área Utilitários para definir a qual site de terceiros se conectar para esta integração.

Por fim, você precisa definir o modelo de transformação, que permite mapear dados de terceiros para CPQ campos ou mapa CPQ campos de fonte de dados de terceiros.

JSON é usado para definir o mapeamento, como no exemplo a seguir.

{
  "fields": [
    {
      "variableName": "txn.custom.tXNNumber",
      "value": "{{#each records}}{{Name}}{{/each}}"
    },
    {
      "variableName": "txn.opportunity.id",
      "value": "{{#eachrecords}}{{LGK__OpportunityId__c}} {{/each}}"
    },
    {
      "variableName": "txn.custom.primaryContact",
      "value": "{{#eachrecords}}{{Contact.FirstName}}{{/each}}"
    }
  ]
}

Este exemplo usa a sintaxe do Bigode para os dados do Salesforce que foram extraídos do site do Salesforce. Cada mapeamento de campo inclui o nome da variável do CPQ Campo que recebe os dados extraídos, seguido pelo valor que identifica o campo do Salesforce em que os dados foram extraídos. . cada um e. /cada a nomenclatura denota que cada registro na resposta da consulta é pesquisado para cada um dos três valores de campo no modelo.

Você pode usar a área Dados de retorno de amostra e a área Resultado da transformação para solucionar problemas de uma integração que não está funcionando. Se você executar a consulta em uma ferramenta como o Postman, onde você pode ver e copiar a resposta da consulta, poderá colar a resposta da consulta na área Dados de resposta de amostra e clicar em Executar transformação Abaixo da área Modelo de transformação. Os dados de resposta da consulta são executados por meio do modelo de transformação definido, e os resultados da transformação são exibidos na área Resultado da transformação.