CPQ campos, campos do sistema e campos do parceiro
Saiba mais sobre os três tipos de campos em CPQ- CPQ, campos do sistema e campos do parceiro. Entenda como cada tipo armazena, recupera e exibe dados em configurações e como eles interagem com a Salesforce e os sistemas de parceiros para uma integração de dados perfeita.
Há três categorias de campos no CPQ ambiente: CPQ campos, campos do sistema e campos do parceiro.
campos de CPQ
R CPQ o campo é um campo definido pelo usuário que é personalizado para CPQ ambiente. Seu tipo pode ser número, texto, lista de seleção, conjunto ou seletor de produto. Quando os usuários criam campos no CPQ, eles podem atribuir manualmente valores padrão na definição de campo ou podem definir valores por meio de ações de determinação.
O exemplo a seguir mostra como um usuário definiria um CPQ Campo em um no aprimoramento Configurar/Reconfigurar:
cfgRequest.testField.set("value", "Hello World"); Para obter uma descrição mais completa de CPQ campos, consulte Configurar campos.
Campos do sistema
Os campos do sistema são predefinidos. Os campos do sistema não podem ser atribuídos a um valor padrão porque eles aproveitam o cache do produto SFDC (ou a data e hora atuais) para gerar seus valores.
O exemplo a seguir mostra como um usuário chamaria um campo do sistema em um aprimoramento Configurar/Reconfigurar:
let pC = {"input2":cfgRequest.sys.productCode.value};Os campos do sistema podem ser adicionados diretamente a qualquer layout. Não há problemas em exibi-los, independentemente de eles conterem dados predefinidos.
No editor de layout:
Na IU do Configurador:
A unidade de medida está em branco porque, neste exemplo, ela não foi definida no SFDC.
O mapeamento de cada um desses campos do sistema para o respectivo objeto SFDC é o seguinte. O nome da API do campo está entre parênteses.
- sys.productUOM > Produto: Unidade de medida de quantidade (QuantityUnitDeMeasure)
- sys.productName > Produto: Nome do produto (nome)
- sys.productFamily > Produto: Família de produtos (família)
- sys.productDescription > Produto: Descrição do produto (Descrição)
- sys.productCode > Produto: Código do produto (ProductCode)
- O padrão sys.enableValidation: O valor é verdadeiro
- SYS.CURRENTDADATE: Chamada de API de tempo simples, retorna a data de UTC
- SYS.actionContext > Linha de cotação: Contexto de ação (LGK ActionContext c)
- sys.productPrice > Entrada do catálogo de preços: Preço de lista (unitPrice)
- sys.productId: O valor depende das configurações do administrador
sys.productId muda para o que estiver definido em seu CPQ configurações de ambiente. Por exemplo, se o campo ID do produto estiver definido como Código do produto, os dados resultantes serão Código do produto, tornando-o idêntico ao campo sys.productCode.
Se o campo ID do produto tiver sido definido como ID do parceiro, os dados serão extraídos do ID do produto do campo do SFDC (ID como o nome da API do campo):
Campos do parceiro
Os campos de parceiro são campos que usam uma PÓS-chamada para inicializar uma configuração via API. Os campos do parceiro aproveitam o conjunto de dados do parceiroʼs para gerar valores de campo.
O mapeamento de cada um desses campos de parceiro para o respectivo objeto SFDC é o seguinte. O nome da API do campo está entre parênteses.
- Partner.quote.id Cotação > ID do registro (ID)
- Partner.quote.lineId Linha de cotação > ID do registro (ID)
- Partner.quote.pricebookId Cotação > ID do catálogo de preços (SBQPricebookIdc)
- Partner.quote.currencyIsoCode Quote > CurrencyIsoCode
O padrão Partner.quote.currencyIsoCode é USD se sua organização não tiver várias moedas habilitadas na organização do Salesforce. Para habilitar várias moedas, siga as etapas neste artigo do Salesforce: Ative várias moedas .
Ao usar esses campos, é importante observar que alguns dos dados podem não ter nenhum valor (nulo) quando o produto é configurado pela primeira vez. Para garantir que não haja erros de inicialização, inclua verificações nulas em todas as regras ou scripts que utilizam campos de parceiro.
Esses campos não podem ser adicionados diretamente a um layout, como os campos do sistema. Em vez disso, você pode usar CPQ campos para preencher os dados nos campos do parceiro por meio de um aprimoramento de inicialização.
O aprimoramento de inicialização de exemplo a seguir preenche os valores dos campos do parceiro no configurador:
let quoteId = cfgRequest.partner.quote.id.value;
let lineID = cfgRequest.partner.quote.lineId.value;
let currencyISO = cfgRequest.partner.quote.currencyIsoCode.value;
let priceBookID = cfgRequest.partner.quote.pricebookId.value;
if (quoteId != null) {
cfgRequest.quoteIDTest.set("value", quoteId);
}
if (lineID != null) {
cfgRequest.lineIDTest.set("value", lineID);
}
if (currencyISO != null) {
cfgRequest.currencyISOCodeTest.set("value", currencyISO);
}
if (priceBookID != null) {
cfgRequest.pricebookIDTest.set("value", priceBookID);
}
return cfgRequest;Configuração inicial:
Reconfiguração:
O ID da linha agora está preenchido.
A forma como você usa os campos de parceiro e sistema depende de você. Algumas organizações acham útil exibir essas informações no configurador para o usuário final, enquanto outras as usam em segundo plano em regras para orientar as condições de preço.