Integração ServiceNow CPQcom ferramentas de visualização
Saiba como ServiceNow CPQConeta-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) Reversão do visualizador: Para fornecedores compatíveis, as ações do usuário na tela podem atualizar campos.
Visão geral dos fornecedores compatíveis
| Fornecedor | Direção | O que você pode enviar | O que pode ser escrito de volta | Anotações |
|---|---|---|---|---|
| CDS | 1 vias e 2 vias | Conjuntos (primeiras 25 linhas), selecionadores de produtos (primeiras 25 opções), índice de conjuntos ativos | 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 | Conjuntos (primeiras 25 linhas), selecionadores de produtos (primeiras 25 opções), índice de conjuntos ativos | 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 |
| Threekit | 1 vias | Campos, 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 selecionadores de produtos, ServiceNow CPQpublica até 25 linhas/opções. Índices/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
- O componente de layout no Blueprint define o painel de visualização (posição, tamanho).
- As configurações de conexão autorizam e roteiam o tráfego (por exemplo, URL de script/app, token de autenticação, subdomínio).
- O bloco de mapeamento seleciona o quê ServiceNow CPQdados a serem enviados:
EventFieldsnomes de variáveis de campo e suas chaves de visualizador.EventSets- definir varnames (primeiras 25 linhas publicadas como matriz de objetos).EventProductPickers- opções selecionadas (primeiros 25) como matriz de objetos.ConfiguActiveTriggers- campos boolianos que indicam o índice ativo em um repetidor definido.
- (Somente 2-way) Um campo de ouvinte ( ServiceNow CPQCampo 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 2-way serão gravados de volta.
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
AssetIdOu 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/URLs do fornecedor apropriados para produto vs. não produzido . Certifique-se de seu Logik Cliente de tempo de execução as origens correspondem aos domínios de chamada.
- CSP (Política de segurança de conteúdo): Permitir hosts de script/app do fornecedor para incorporação e envio de mensagens. Coordene com sua equipe de segurança e o suporte Logik 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
- Precisa de edições bidirecionais na tela? Escolha kBridge ou CDS e implemente um campo de ouvinte e regras de análise.
- Precisa de 3D de alta fidelidade com gestão de ativos e atualizações de 1 vias? Escolha Threekit com uma estratégia de campo assetId ou assetId.
- UX pesada orientada por conjunto? Prefira CDS ou kBridge para manipulação de JSON de conjunto de 2 vias e sincronização de índice de conjunto ativo.
Práticas recomendadas
- Mapeie somente o que você precisa: Limite
EventFields,EventSets, e.EventProductPickerspara dados essenciais para desempenho. - Design para o CAP de 25 itens: Se os usuários puderem exceder 25 linhas definidas ou seleções do seletor de produtos, adicione proteções (validação, paginação ou resumo).
- Normalizar para 2-way: 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 (tokens, 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. ServiceNow CPQentradas do depurador para reproduzir estados.