Integração CPQ com ferramentas de visualização

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 4 min. de leitura

    • Saiba como CPQ Coneta-se a mecanismos de visualização de terceiros (CDS, kBridge e Threekit) para renderizar exibições de produtos 2D/3D que respondem a entradas de configuração em tempo real.

    Você pode fazer o seguinte:
    • Mostrar visuais ao vivo conforme os usuários configuram: Cores, dimensões, opções e pacotes podem atualizar o visualizador instantaneamente.
    • Coordene IU e estados visuais: Publique valores de campo, defina linhas e produtos selecionados para o renderizador.
    • (Opcional) Anotar do visualizador: Para fornecedores compatíveis, as ações do usuário na tela podem atualizar campos.

    Visão geral dos fornecedores compatíveis

    Tabela 1. Lista de fornecedores
    Fornecedor Direção O que você pode enviar O que pode ser escrito de volta Anotações
    CDS 1 vias e 2 vias Campos, Conjuntos (primeiras 25 linhas), seletores de produto (primeiras 25 opções), índice de conjunto ativo Campos; define por meio do campo de ouvinte json e análise de regra Bom para CAD/2D/3D; objetos de mapeamento flexíveis
    KBridge 1 vias e 2 vias Campos, Conjuntos (primeiras 25 linhas), seletores de produto (primeiras 25 opções), índice de conjunto ativo Campos; define por meio do campo de ouvinte json e análise de regra 3D em tempo real com modelo avançado de evento e ouvinte
    Kit triplo 1 vias ID do ativo (estático ou via campo), índice de conjunto ativo (somente foco visual) Não compatível (visualizador → Logik) Use para visuais de alta fidelidade; mapear campos e seleção de ativos
    Nota:
    Ao enviar conjuntos ou seletores de produtos, CPQ publica até 25 linhas/opções. Índices e opções além de 25 não são transmitidos. Ao usar Repetidores de conjunto, você pode publicar um gatilho de índice de conjunto ativo para que o visualizador mostre a linha que o usuário está editando.

    Como a integração funciona

    1. O componente de layout no blueprint define a posição e o tamanho do painel de visualização.
    2. As configurações de conexão autorizam e roteiam o tráfego (por exemplo, o URL do script ou do app, o token de autenticação e o subdomínio).
    3. O bloco de mapeamento seleciona o quê CPQ dados a serem enviados:
      • EventFields nomes de variáveis de campo e suas chaves de visualizador
      • EventSets - definir nomes de variáveis (primeiras 25 linhas publicadas como uma matriz de objetos)
      • EventProductPickers - opções selecionadas (primeiras 25) como uma matriz de objetos
      • ConfiguActiveTriggers - Campos boolianos que indicam o índice ativo em um repetidor definido
    4. (Somente bidirecional) Um campo de ouvinte ( CPQ Campo de texto) Recebe JSON do visualizador.
      • Adicione uma regra de determinação (ou aprimoramento) para analisar esse JSON e atualizar campos ou definir linhas.
      • Se um campo de ouvinte estiver presente, somente mapeamentos explicitamente configurados para bidirecional serão gravados de volta.

    Formato tabular para mostrar recursos compatíveis e não compatíveis das ferramentas de visualização.

    Dados trocados

    • Campos: Valores escalares (texto, número, booliano, seleção de lista de seleção).
    • Conjuntos: Matriz de objetos de linha (primeiros 25). Use o índice de conjunto ativo para manter o visual em sincronia com a linha que está sendo editada em um repetidor.
    • Seletores de produto: Matriz de objetos de opção selecionados (primeiros 25).
    • Ativos (ThreeKit): Forneça uma estática AssetId Ou um campo de ID de ativo no Logik para habilitar a seleção dinâmica de ativos.

    Segurança e ambientes

    • Autenticação e origem: Use tokens do fornecedor e URLs apropriados para produzir versus não produzir. Certifique-se de CPQ As origens do cliente de tempo de execução correspondem aos domínios de chamada.
    • CSP (Política de segurança de conteúdo): Permitir scripts do fornecedor ou hosts de aplicações para incorporação e envio de mensagens. Coordene com sua equipe de segurança e. CPQ suporte para adicionar domínios.
    • Separação de preocupações: Mantenha as credenciais e tokens do fornecedor fora dos layouts compartilhados entre ambientes. Troque tokens ao promover.

    Quando escolher qual ferramenta

    • Se você precisar de edições bidirecionais na tela, escolha kBridge ou CDS e implemente um campo de ouvinte e regras de análise.
    • Se você precisar de 3D de alta fidelidade com gestão de ativos e atualizações unidirecionais, escolha Threekit com uma estratégia de campo assetId ou assetId.
    • Se você tiver uma UX orientada por conjunto pesado, prefira CDS ou kBridge para manipulação de JSON de conjuntos bidirecional e sincronização de índice de conjuntos ativos.

    Diretrizes gerais

    • Mapeie somente o que você precisa: Limite EventFields , EventSets e. EventProductPickers para dados essenciais para desempenho.
    • Design para o CAP de 25 itens: Se os usuários puderem exceder 25 linhas definidas ou seleções de selecionador de produto, adicione proteções (como validação, paginação ou resumo).
    • Normalizar para bidirecional: Defina um esquema JSON estável para cargas do ouvinte e centralize a lógica de análise em uma regra gerenciada ou aprimoramento.
    • Promover com segurança: Externalize valores específicos do ambiente, como tokens e URLs. Verifique os visuais em teste antes da promoção de produção.
    • Solucionar problemas sistematicamente:
      • Verifique se há erros de tempo de execução ou script nos logs do administrador.
      • Verifique o CSP e o acesso à rede aos domínios do fornecedor.
      • Use o console/devtools do visualizador e. CPQ entradas do depurador para reproduzir estados.