CDS ou outras ferramentas de visualização de terceiros

  • Versão de lançamento: Zurich
  • Atualizado 8 de out. de 2025
  • 6 min. de leitura
  • 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.

    ServiceNow 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.

    Produto visual

    A integração entre ServiceNow CPQE o CDS é realizado na definição de layout do Blueprint. O arquivo CSV de layout a seguir contém uma amostra de como o. ServiceNow CPQO administrador define onde a visualização do CDS será renderizada. Também especifica o ambiente CDS e. ServiceNow CPQdados 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 ServiceNow CPQconfigurador.
    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 ServiceNow CPQ. Seu elemento de layout 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 ServiceNow CPQE o CDS é realizado na definição de layout do Blueprint. O arquivo CSV de layout a seguir contém uma amostra de como o administrador define onde na IU a visualização do CDS será renderizada. Também especifica o ambiente CDS e o. ServiceNow CPQdados 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.

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

    A partir daqui, você pode abrir as Configurações deste elemento de layout e configurar os campos abaixo usando o editor JSON de propriedades do CDS:

    Menu

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

    Nome da Propriedade Obrigatório 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 ServiceNow CPQNomes de variáveis e nomes de variáveis CDS.

    Um objeto terá pares chave:valor. A chave é o. ServiceNow CPQNome 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 ServiceNow CPQNomes de variáveis e nomes de variáveis CDS.

    Um objeto terá pares chave:valor. A chave é o. ServiceNow CPQNome 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 ServiceNow CPQNomes de variáveis e nomes de variáveis CDS.

    Um objeto terá pares chave:valor. A chave é o. ServiceNow CPQNome 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 camada Repetida

    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 ServiceNow CPQUm 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 ServiceNow CPQCampos passados para CDS. No passado, a norma era que os CDS corresponderiam suas variáveis ao ServiceNow CPQnomes de variáveis. Confirme se este é o caso da sua implementação com CDS.

      EventFields deve conter todos os campos que serão comunicados ServiceNow CPQE CDS (ou seja, ambos ServiceNow CPQCampos que controlam o visual do CDS e os campos que são passados de volta para ServiceNow CPQCom 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 ServiceNow CPQNome da variável e nomes de variáveis CDS.
      • Um objeto terá pares chave:valor. A chave é ServiceNow CPQNome 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 produtos 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 ServiceNow CPQcampos. O segundo modo permite que o usuário manipule o gráfico CDS, e o CDS atualizará o relevante ServiceNow CPQentradas de campo. Para campos padrão, o CDS grava de volta no mapeado ServiceNow CPQcampo. Se ServiceNow CPQos conjuntos estão sendo usados em uma configuração de comunicação bidirecional, ServiceNow CPQE os administradores do CDS precisarão coordenar a seguinte configuração:
      • . ServiceNow CPQO 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.
      • . ServiceNow CPQO administrador definirá regras de determinação que analisam o campo e preenchem o conjunto.