Gestão de estados abertos

O modelo de estado aberto é uma estrutura programática na API do modelo de estado de configuração, que permite programar variações nas opções de produto que aparecem no legado configurador de produtos em Gestão de relacionamento com clientes de vendas. A estrutura de API fornece determinados estados e métodos de API auxiliares para controlar os nós de How no legado configurador de produtos a interface do usuário é exibida.

Como desenvolvedores, você pode usar pontos de extensão para gestão de estado aberto para definir os estados somente exibição ou editáveis em qualquer nó do configurador, com base nos eventos que ocorrem no carregamento ou quando as seleções de produto mudam. Opcionalmente, você também pode criar scripts de mensagens de informações junto com a mudança do estado do nó. Essas mensagens são exibidas contextualmente na interface do usuário do configurador de produto. Vários métodos de API auxiliar estão disponíveis para leitura e configuração de estados em qualquer nó, eliminando a necessidade de scripts JSON extensivos.

Nota:

Verifique seus direitos para determinar se você tem acesso a esses recursos.

Casos de uso para gestão de estado de configuração

A tabela a seguir mostra diferentes maneiras de controlar as opções de produto exibidas no legado configurador de produtos.

Tabela 1. Exemplos de caso de uso do modelo de estado de configuração

Caso de uso do configurador de produto	Exemplo
Oculte determinadas opções de um cliente	Uma seleção de atributo de produto não é exibida para clientes na Califórnia devido às regulamentações estaduais de segurança​.
Defina determinadas opções padrão para um cliente	Para upgrades, somente o plano Ultimate é exibido para clientes existentes que têm um plano premium.
Permita que somente determinadas opções sejam selecionadas com base em outras opções de atributo	Para determinados produtos, como laptops, exiba todos os tamanhos 13", 15" e 17", mas exiba somente notebooks 15" e 17" se somente o recurso de tela sensível ao toque for necessário.
Permitir que a quantidade seja definida para produtos	Alguns produtos podem ter valores de quantidade padrão diferentes. Permita que os agentes configurem a quantidade, desde que o valor esteja dentro dos limites de uma quantidade mínima e uma quantidade máxima permitida para esse produto.
Permita que somente determinadas seleções de característica sejam feitas	Determinadas seleções de produto exigem que um valor de característica específico seja escolhido. Por exemplo, após a seleção do Plano Ultimate de Internet, a velocidade de conetividade que pode ser escolhida é 5G.

Você pode gerenciar a exibição de opções no legado configurador de produtos Usando a Estrutura da API do modelo de estado de configuração.

estados do nó

Os nós no configurador de produto legado exibem grupos de relacionamento de produto, produtos secundários e opções de característica. Os nós podem ter os seguintes estados:

Visível - Sim (tornar o nó visível) ou Não (tornar o nó invisível)

Configurações visíveis ou não visíveis para o agente no configurador de produto legado. As opções podem não estar visíveis se forem incompatíveis com outras seleções feitas pelo agente. Por exemplo, para um tamanho de roda de carro específico, as opções de pneus incompatíveis não estão visíveis.

Editável - Sim (mostrar nó e torná-lo selecionável) ou Não (mostrar nó, mas torná-lo não selecionável)

Configurações editáveis ou não editáveis pelo agente no configurador de produto legado. Os agentes podem personalizar determinados aspectos do produto, mantendo as restrições necessárias para o produto. Por exemplo, para um modelo de automóvel específico, apenas cores exteriores compatíveis são editáveis.

Quantidade - Visível (Sim/Não), Editável (Sim/Não)

Configurações que definem a quantidade em um produto, aplicam regras relacionadas à quantidade e mostram mensagens informativas e de erro relacionadas à quantidade no nó apropriado.

Marcado - Sim (mostrar seleções de nó) ou Não (tornar as seleções de nó invisíveis)

Configurações que mostram as opções de configuração para seleção com base no contexto.

Valor - Visível (Sim/Não), Editável (Sim/Não)

Configurações que definem um valor para uma característica, aplicam regras relacionadas à característica e mostram mensagens informativas ou de erro relacionadas ao nó apropriado.

Nota:

Os agentes podem optar por definir mensagens em um nível de nó para fornecer justificativa para uma mudança de estado.

Eventos

Gerencie estados de nó usando a Estrutura da API do modelo de estado de configuração. Ative esses estados usando os dois eventos a seguir na Estrutura de eventos do Modelo de estado de configuração:

• Em carregamento - O estado (visibilidade, capacidade de edição) de cada nó é definido inicialmente como Sim (verdadeiro). O estado Aberto é invocado no carregamento.
• Na mudança - Esta função é chamada sempre que há uma mudança no valor de um nó no legado configurador de produtos interface do usuário. No entanto, este estado não é invocado quando ocorrem mudanças de quantidade no legado configurador de produtos. Esses estados podem ser definidos programaticamente de uma das seguintes maneiras: Em carregamento, durante seleções ou imediatamente antes de a instância ser sincronizada de volta à transação

Métodos de API auxiliar

Você pode usar os seguintes métodos de API auxiliar para ler e definir estados em qualquer nó.

Aplicar estados

Defina os estados visíveis e editáveis para grupos de relacionamento de produto, características do produto e opções de característica do produto usando os métodos Getter e Setter para ler e mudar o estado do modelo de configuração.

Métodos de obtenção

Obtenha caminhos de nó junto com os estados em qualquer nó de configuração:

• GetAllNodes() : Retorna JSON com o caminho do nó (referência ao código) e seu respectivo caminho relativo com todos os estados.
• GetNode (nodePath) : Retorna o objeto javascript do nó para o caminho do nó especificado, se ele existir.
• GetNodeDetails (nodePath : Retorna todos os estados do caminho do nó especificado, se ele existir.

Métodos de definição

• Defina os estados visíveis e editáveis para grupos de relacionamento de produto, características do produto e opções de característica do produto.
  • ConfiguVisível : Verdadeiro/Falso em todos os níveis
  • SetVisible (Verdadeiro/Falso)
  • SetEditável : Verdadeiro/Falso em todos os níveis
  • SetEditable (verdadeiro)
  • Exemplo de implementação:

    var newHandler = configInstance.getNode(nodePath);
    newHandler.setVisible(true, “This is a sample message for setVisible”);
    newHandler.setEditable(false, “This is a sample message for setEditable”);

• Defina a quantidade de ofertas e especificações. O nodePath determina o produto e o valor é a quantidade a ser definida.
  • SetQuantity(valor);
  • Exemplo de implementação:

    var newHandler = configInstance.getNode(nodePath);
    newHandler.setQuantity(value, “This is a sample message for setQuantity”);

• Defina as opções de configuração para ver o que está sendo selecionado.
  • SetChecked (valor); Verdadeiro/Falso
  • Exemplo de implementação:

    var nodePath = “QUADPLAYHO1/OPTIONALPRODUCTS/CONNECTEDC2/CONNECTEDC1/VIN”
    var newHandler = configInstance.getNode(nodePath);
    var newHandler.setChecked(true, “This is a sample message for setChecked”)
    

• Defina o valor de um nó de característica em que o tipo de entrada é uma única linha de texto.
  • Valor( valor);
  • Exemplo de implementação:

    var nodePath =
    “QUADPLAYHO1/OPTIONALPRODUCTS/CONNECTEDC2/CONNECTEDC1/VIN”
    var newHandler = configInstance.getNode(nodePath);
    newHandler.setValue(“9TKN332”, “This is a sample message for
    setValue”);

Métodos de variável de contexto do getter

Recupere variáveis de contexto dentro do legado configurador de produtos interface do usuário.

• ContextVariables() : Retorna uma lista de todas as variáveis de contexto de cabeçalho.
• ContextVariableValue(contextVariable) : Retorna um valor e o valor de exibição de uma variável de contexto específica no cabeçalho.
• GetLineContextVariables() : Retorna uma lista de todas as variáveis de contexto de linha.
• GetLineContextVariableValue(nodePath, contextVariable) : Retorna o valor de uma variável de contexto específica na linha.