Gerenciador de transações: Integração - OBTER

Saiba como acessar dados de uma aplicação de terceiros, como o Salesforce, usando a integração GET.

Este artigo descreve como recuperar o ID de oportunidade do Salesforce, juntamente com os detalhes da transação, incluindo o nome da conta, o nome da oportunidade, o endereço de envio e o endereço de cobrança, e escrevê-los em CPQ campos de transação. Este padrão é relevante para qualquer integração que exija CPQ para solicitar dados de um terceiro.

Objetivo: Fluxo do usuário final (buyside)

Começamos abrindo uma transação do Gerenciador de transações no Salesforce. Em seguida, clicando em Obter dados de SF Na IU de compra, acionamos o evento Obter dados SF. Este evento inicia várias integrações que se conectam ao Salesforce, extraindo os dados de transação relevantes (ID da oportunidade, nome da oportunidade, endereço de envio, endereço de cobrança, ID da conta, e nome da conta) e preenchendo os campos correspondentes na IU de compra.

Na IU de transação de compra, clique em Obter dados de SF .

Observe que os detalhes estão todos preenchidos.

O restante deste artigo lista as etapas em CPQ Para criar as integrações que obtêm os dados do Salesforce.

Configuração de administração: Pré-requisitos

Este guia pressupõe um CPQ Ambiente com recursos do Gerenciador de transações habilitados, bem como a instalação da Extensão de integração do Gerenciador de transações Logik em um ambiente Salesforce correspondente. Para exibir as instruções de instalação, consulte Instalando a extensão do pacote de integração do gerenciador de transações do Salesforce.

CPQ: Adicionar uma conexão

Um registro de conexão contém os dados necessários para iniciar uma integração do Gerenciador de transações. Isso inclui detalhes de autenticação, URL do host, caminho e cabeçalhos. Para exibir um registro de conexão, em CPQ Administrador, acesse Utilitários e clique em Conexões .

Para obter informações sobre como adicionar uma conexão, consulte a seção "Criar uma conexão" em Gerenciador de transações: Integrações. Para os fins deste artigo, usamos uma conexão com um ambiente do Salesforce.

CPQ: Adicione a integração

1. Aberto CPQ E vá para a seção Integrações.
2. Clique em Adicionar integração . Crie uma nova integração usando qualquer nome adequado. Neste exemplo, usamos o nome "Obter ID da oportunidade".

   

   

   A página de detalhes da integração mostrada acima inclui as seguintes seções:

   • Configurações de integração
   • Transformação da solicitação
   • Conexão com o endpoint
   • Transformação da resposta

   Detalhes sobre essas seções a seguir.

• Configurações de integração:
  • Método HTTP: GET
  • Caminho: /Services/data/vXX.X/query/

    A solicitação GET recupera o. Namee. LGK__OpportunityId__ccampos do LGK__Transaction__cObjeto no Salesforce, filtrando pelo ID da transação "txn.id" no LGK__ID__ccampo.

    No caminho, <vXX.X> é a versão de gráfico composto mais recente. Você pode verificar a versão mais recente aqui .

  • Detalhes do item de linha a serem incluídos: Linhas selecionadas
  • Tempo limite: 2000 ms

  

  Clique em Avançar.

• Transformação da solicitação: Não necessário quando estamos criando uma integração GET.
• Conexão com o endpoint: Neste exemplo, estamos consultando Salesforce . Se você estiver configurando uma integração com outro sistema, selecione a conexão apropriada.

  

  Clique em Avançar.

• Transformação de resposta: Consulte este modelo de transformação de resposta de amostra.

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

Nova integração: Recupere detalhes da oportunidade

Crie outra integração para obter detalhes adicionais txn.opportunity.id.

Agora que temos o ID da oportunidade, a próxima etapa na integração envolve usá-lo como referência para recuperar detalhes adicionais da oportunidade e preencher os campos de transação de LGK relevantes.

• Configurações de integração:
  • Método HTTP: GET
  • Caminho: Nome,Proprietário.Username,AccountId,Conta.Nome,Conta.Endereço de faturamento,Conta.Endereço de envio DA oportunidade EM QUE ID

    Esta consulta recupera campos de um registro de oportunidade no Salesforce, com base no ID exclusivo da oportunidade. Ele também recupera detalhes da conta relacionados, como o nome da conta, o endereço de cobrança e o endereço de envio. A consulta retorna dados de uma oportunidade específica identificada por {{txn.opportunity.id}}.

    Para obter os detalhes do campo do Salesforce, clique em Configuração > Gerenciador de objetos > Oportunidade > Campos e Relacionamentos.

    

  • Detalhes do item de linha a serem incluídos: Linhas selecionadas
  • Tempo limite: 2000 ms

    

  Clique em Avançar.

• Transformação de solicitação: Não necessário ao criar uma integração GET.
• Conexão ao endpoint:

  Selecione Conexão com o endpoint . Para este exemplo, estamos consultando a Salesforce. Se você estiver configurando uma integração com outro sistema, selecione a conexão apropriada.

  

  Clique em Avançar.

• Transformação da resposta: O snippet JSON a seguir define como preencher variáveis definidas em caminho adicional iterando em uma coleção de registros .

  Para txn.custom.opportunity, extrai o. Namecampo de cada registro, enquanto para txn.custom.billToAddress, extrai e concatena o. Account.BillingAddress.street,Account.BillingAddress.city,Account.BillingAddress.state,Account.BillingAddress.postalCodecampo. Guidão {{#each}}o loop é usado para processar cada registro, e os valores resultantes dependem da manipulação do sistema, seja como cadeias de caracteres concatenadas ou matrizes de valores.

  {
    "fields": [
      {
        "variableName": "txn.custom.opportunity",
        "value": "{{#each records}}{{Name}}{{/each}}"
      },
      {
        "variableName": "txn.account.id",
        "value": "{{#each records}}{{AccountId}}{{/each}}"
      },
      {
        "variableName": "txn.custom.accountName",
        "value": "{{#each records}}{{Account.Name}}{{/each}}"
      },
      {
        "variableName": "txn.custom.quoteNumber",
        "value": "{{#each records}}{{QuoteNumber}}{{/each}}"
      },
      {
        "variableName": "txn.custom.billToAddress",
        "value": "{{records.[0].Account.BillingAddress.street}}{{records.[0].Account.BillingAddress.city}}{{records.[0].Account.BillingAddress.state}}{{records.[0].Account.BillingAddress.postalCode}}"
      },
      {
        "variableName": "txn.custom.shipToAddress",
        "value": "{{records.[0].Account.ShippingAddress.street}}{{records.[0].Account.ShippingAddress.city}}{{records.[0].Account.ShippingAddress.state}}{{records.[0].Account.ShippingAddress.postalCode}}"
      }
    ]
  }

Acione a integração quando o usuário final clicar em um botão. Agora você pode clicar em Eventos para criar um novo evento ou selecionar um existente. Nesse caso, usamos o evento Obter dados SF (um botão na IU) para nos conectar às integrações que criamos anteriormente.

Clique em Adicionar nova ação .

Clique em Integrações .

PESQUISE e adicione a integração "Obter ID de oportunidade".

Clique em Salvar. Em seguida, clique em Adicionar nova ação E adicione "retrieveSFOptyData".

Clique nas setas para cima e para baixo ao lado dos itens de ação para organizá-los na ordem desejada. (Aqui, estamos selecionando "Obter ID da oportunidade", seguido de "Recuperar dados da opção de SF", para buscar o ID da oportunidade e recuperar dados relevantes.)

Clique em Salvar e implantar as mudanças.

Discutimos como integrações podem ser adicionadas com eventos. As integrações também podem ser configuradas no nível da fase. Para fazer isso, navegue até Fases > Editar Configurações > Adicionar nova ação > Integração.

Solução de problemas

Ao configurar integrações, é crucial garantir que a sequência de integrações seja configurada corretamente para recuperar detalhes precisos. A ordem de execução desempenha um papel significativo na manutenção da consistência e do alinhamento dos dados.

Para conseguir isso, siga estas etapas:

1. Buscar o ID da oportunidade: O ID da oportunidade serve como a principal referência para vincular dados relacionados. Esta etapa é essencial porque os detalhes da transação que você recupera mais tarde estão diretamente associados a uma oportunidade específica.
2. Buscar o ID da transação por meio dos detalhes da oportunidade: Use o ID da oportunidade para buscar o ID da transação. Como cada transação está vinculada a uma oportunidade específica, essa abordagem garante que você associe com precisão a transação correta à oportunidade correspondente.

Ao seguir esta ordem, você pode manter a integridade da integração e garantir que o fluxo de dados permaneça contínuo e confiável.

Conceitos relacionados

• Gerenciador de transações: Integração - POST