Integração de CDS ou outras ferramentas de visualização de terceiros

Integre o CDS Visual ou outras ferramentas de terceiros para visualização técnica. Sincronize entradas de configuração com atualizações visuais para aprimorar a experiência do usuário.

CPQ pode ser implementado para compartilhar valores de campo com ferramentas de visualização de terceiros para que a visualização seja atualizada em tempo real conforme o usuário muda as entradas de configuração. Este artigo discute a integração da ferramenta Visual CDS como um exemplo. Dependendo da configuração do modelo CDS, a visualização pode ser renderizada como desenhos CAD, imagens 2D e imagens interativas 3D.

A integração entre CPQ E o CDS é realizado na definição de layout do Blueprint. O arquivo CSV de layout a seguir contém uma amostra de como o. CPQ O administrador define onde a visualização do CDS será renderizada. Ele também especifica o ambiente CDS e. CPQ dados do campo a serem enviados.

Layout_cds_in_sidebar [Planilha do Google]

Guia passo a passo

Este artigo pode ajudá-lo a decidir como adicionar a configuração do CDS.

1. Abra o editor de layout no CPQ configurador.
2. Baixe seu arquivo de layout CSV.
3. Abra seu arquivo de layout CSV e adicione os campos de elemento de layout do CDS (destacados em detalhes abaixo).
4. Carregue novamente seu arquivo de layout CSV para CPQ. O elemento de layout do CDS agora deve estar presente no layout.
5. Abra as opções de configuração do elemento de layout CDS e adicione as linhas de dados JSON necessárias.

Opções de configuração técnica

A integração entre CPQ E o CDS é realizado na definição de layout do Blueprint. O arquivo CSV de layout a seguir ajuda a demonstrar como o administrador define onde na IU a visualização do CDS será renderizada. Também especifica o ambiente CDS e o. CPQ dados do campo a serem enviados.

O layout pode ser atualizado diretamente no editor de layout. No editor de layout, crie uma nova seção chamada CDS no arquivo CSV usando os campos destacados em vermelho abaixo e carregue o novo arquivo no layout.

Aqui, você pode abrir as configurações deste elemento de layout e configurar os seguintes campos usando o editor JSON de propriedades do CDS:

Essas propriedades podem ser configuradas neste elemento. A tabela a seguir fornece o nome e a descrição de cada elemento.

Tabela 1. Propriedades do elemento de layout CDS

Nome da propriedade	Necessários	Descrição
EventFields	não	Matriz ou objeto de campos a serem enviados para CDS. Uma matriz assumirá que as cadeias de caracteres contidas são ambas CPQ Nomes de variáveis e nomes de variáveis CDS. Um objeto terá pares chave:valor. A chave é o. CPQ Nome da variável e o valor é o nome da variável CDS. Os campos definidos podem ser definidos aqui, usando o formato: .SetVariableName.FieldVariableName
EventSets	não	Matriz ou objeto de conjuntos a serem enviados para CDS. Uma matriz assumirá que as cadeias de caracteres contidas são ambas CPQ Nomes de variáveis e nomes de variáveis CDS. Um objeto terá pares chave:valor. A chave é o. CPQ Nome da variável e o valor é o nome da variável CDS. O conjunto será enviado como um todo, com até 25 índices de comprimento: setVariableName: [ { field1: 'value', field2: 'value' } { field1: 'value', field2: 'value' } ]
EventProductPickers	não	Envia todos os dados do seletor de produtos como uma matriz de objetos para o CDS. Uma matriz assumirá que as cadeias de caracteres contidas são ambas CPQ Nomes de variáveis e nomes de variáveis CDS. Um objeto terá pares chave:valor. A chave é o. CPQ Nome da variável e o valor é o nome da variável CDS. O seletor de produto será enviado como um todo, com até 25 índices de comprimento. Opção nº 1: { "eventProductPickers": [ "productPicker1", "productPicker2" ] } Opção nº 2: { "eventProductPickers": { "logikProductPicker1": "cdsProductPickerName1", "logikProductPicker2": "cdsProductPickerName2" } }
domínio	sim	Domínio da visualização de CDS
env	não	O padrão é "qa" se não for fornecido
ConfiguActiveTriggers	não	Uma matriz de nomes de variáveis correspondentes a um campo booliano em um conjunto. Os campos listados servirão como um gatilho para indicar qual índice do conjunto está ativo ao ser usado em um repetidor de conjunto. Estes são necessários se estiver usando um contêiner básico ou uma seção expansível como o tipo de nível repetido
altura	não	A altura da janela de visualização em px - o padrão é 500
largura	não	A largura da janela de visualização em px - o padrão é 500

Formatação de cadeia de caracteres JSON

A formatação final da cadeia de caracteres JSON deve ser semelhante à seguinte:

{

"domain": "exampleDomain", "env": "qa"

"eventFields": ["field1", "field2", "field3"]

}

Anotações

• Na amostra de definição de layout, a renderização do CDS será exibida em uma barra lateral do contêiner básico posicionada no canto superior direito.
  • OS CDS podem passar CPQ Um objeto JSON para um campo de texto.
  • Use regras avançadas para analisar as respostas JSON do CDS.

• O JSON fornecido na coluna "Valor" (coluna I) da linha do elemento CDS contém a seguinte sintaxe:

  {
  "eventFields": [ "FIELD1",
  "FIELD2", "FIELD3"
  ],
  "domain": "CDS_DOMAIN", "env": "CDS_ENV_SECTOR"
  }

  domínio : O nome do domínio que atende ao seu projeto, conforme fornecido pelo CDS.

  env : O nome do serviço de ambiente do seu projeto, conforme fornecido pelo CDS. Exemplo: "qa".

  A matriz eventFields contém os nomes de variáveis do CPQ Campos passados para CDS. No passado, a norma era que os CDS corresponderiam suas variáveis ao CPQ nomes de variáveis. Confirme se este é o caso da sua implementação com CDS.

  EventFields deve conter todos os campos que serão comunicados entre CPQ E CDS (ou seja, ambos CPQ Campos que controlam o visual do CDS e os campos que são passados de volta para CPQ Com base nas mudanças feitas na visualização do CDS).

• Os conjuntos também podem ser passados para CDS, embora somente os primeiros 25 índices possam ser enviados. Isso espelha o processo acima, exceto que o nome da propriedade é EventSets em vez de EventFields .
• Matriz ou objeto de conjuntos a serem enviados para CDS:
  • Uma matriz assumirá que as cadeias de caracteres contidas são ambas CPQ Nome da variável e nomes de variáveis CDS.
  • Um objeto terá pares chave:valor. A chave é CPQ Nome da variável e o valor é o nome da variável CDS.

  • Isso será enviado como um todo, até 25 índices de comprimento usando a seguinte sintaxe:

    setVariableName: [
    {
    field1: 'value', field2: 'value'
    },
    {
    field1: 'value', field2: 'value'
    },
    ]

• Os seletores de produto também podem ser passados para CDS com uma restrição de que somente os primeiros 25 índices possam ser enviados. Isso espelha o processo acima, exceto que o nome da propriedade é EventProductPickers em vez de EventFields ou SetFields . As duas sintaxes a seguir funcionam:

  {
    "eventProductPickers": ["productPicker1", "productPicker2"]
  }

  {
    "eventProductPickers": {
      "logikProductPicker1": "cdsProductPickerName1",
      "logikProductPicker2": "cdsProductPickerName2"
    }
  }

• OS CDS podem ser configurados para comunicação bidirecional. A comunicação unidirecional atualiza o gráfico do CDS quando o usuário atualiza o relevante CPQ campos. O segundo modo permite que o usuário manipule o gráfico CDS, e o CDS atualizará o relevante CPQ entradas de campo. Para campos padrão, o CDS grava de volta no mapeado CPQ campo. Se CPQ os conjuntos estão sendo usados em uma configuração de comunicação bidirecional, CPQ E os administradores do CDS precisarão coordenar a seguinte configuração:
  • . CPQ O administrador definirá um campo de evento distinto no qual os dados do conjunto serão gravados a partir do CDS.
  • O administrador do CDS especificará este campo como o destino dos dados definidos.
  • . CPQ O administrador definirá regras de determinação que analisam o campo e preenchem o conjunto.