Guia de instalação e configuração para ambientes vinculados a organizações do Salesforce

Instruções passo a passo para configurar CPQ Em um ambiente vinculado a uma organização do Salesforce.

Antes de Iniciar

Forneça o nome de usuário de um usuário na organização que servirá como o primeiro CPQ usuário administrador. Este usuário precisará conceder acesso a outros usuários depois que eles tentarem acessar o. CPQ E aparecem na lista de usuários de acesso do usuário. Para obter mais informações, consulte Acesso do usuário.

Fornecer CPQ Suporte com as seguintes informações:

• O ID da organização da sua organização (encontrado em Configuração > Informações da empresa)
• O URL do Meu domínio da organização (encontrado em Configuração > Meu domínio)

. CPQ A equipe de DevOps provisionará o ambiente. Quando estiver pronto, o Suporte confirmará com seu CPQ URL personalizado.

Nota:

Se o seu site do Salesforce foi atualizado de outro anteriormente CPQ Site do Salesforce conectado, desinstale o. CPQ app conectado antes de continuar. Ele contém metadados associados ao CPQ Ambiente conectado ao site original do Salesforce. Para desinstalar, navegue até Configuração > Gerenciar apps conectados > Logik Connected App > Desinstalar.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Se o seu ambiente nunca teve CPQ instalado, comece na etapa 1. Se você estiver atualizando pacotes existentes, comece na etapa 7.

Procedimento

1. Navegue até seu CPQ URL personalizado e clique na guia Configurações no menu de navegação.
2. Crie um nome de usuário do token de atualização.
   O nome de usuário pode ser qualquer usuárioʼs username, mas CPQ recomenda um usuário com um perfil de administrador do sistema.
3. Quando solicitado na janela pop-up, permita o acesso para CPQ App conectado pelo usuário da API.
   Se você estiver usando um usuário de integração que não seja um administrador do sistema, estes são os requisitos necessários para o usuário de integração (ou um conjunto de permissões associado a esse usuário/perfil):

   • O usuário deve estar habilitado para API
   • O usuário precisará de acesso Criar e Editar para os seguintes objetos:
     • LGK__ConfigurationLineItem__c
     • LGK__ConfigurationFieldData__c
     • __QuoteLine__c
   • O usuário precisará de acesso Ler/Exibir tudo aos seguintes objetos:
     • Produto2
     • Preço2
     • PricebookEntry
   • Para a gestão de assinaturas, o usuário com também precisa de acesso Ler/Exibir tudo ao objeto ProductSellingModel.
4. Em um novo navegador, navegue até CPQ URL personalizada novamente e confirme se o nome de usuário do token de atualização foi atualizado corretamente.
5. Clique em redefinir novamente para obter um novo refreshToken ou navegue até https://<YourLogikURL>/refreshToken.
6. Insira a configuração do Salesforce e pesquise na caixa Localização rápida o uso de OAuth de apps conectados.
   1. Encontre o Logik Connected App e clique em Instalar .
   2. Clique em Permitir .
   3. Edite políticas de OAuth.
      Os usuários permitidos devem ser definidos como Os usuários aprovados pelo administrador são pré-autorizados .
   4. Role até Gerenciar perfis e vincule ao perfil do administrador do sistema ou a quaisquer outros perfis que serão usados CPQ como administrador.
7. Clique no ícone de engrenagem no canto superior direito e vá para a página "Configuração" da sua organização do SFDC.

   Se você estiver atualizando o pacote gerenciado de base Logik de uma versão principal para uma versão principal mais recente (por exemplo, de 1.x para 2.x), envie um caso de suporte anotando isso. CPQ precisa atualizar a versão do pacote para seu ambiente em nosso banco de dados.

8. Navegue até Pacotes instalados.
   Se você estiver atualizando apenas o existente CPQ pacotes, esta é a única etapa que você deve concluir.
   1. Instale o pacote gerenciado de base Logik e selecione Instalação para todos os usuários .
      • Se sua organização fizer login por meio de test.salesforce.com ou tiver uma área restrita no URL do Meu domínio da organização, clique em aqui .
      • Se sua organização fizer login por meio de login.salesforce.com, clique em aqui .

      A chave de instalação é Logik.io-2025!
   2. Se estiver usando com o Salesforce CPQ, certifique-se de que o Salesforce CPQ esteja instalado e seja a versão 244,2 ou posterior, instale o. CPQ Pacote CPQ de extensão do Salesforce.
      • Se sua organização fizer login por meio de test.salesforce.com ou tiver uma área restrita no URL do Meu domínio da organização, clique em aqui .
      • Se sua organização fizer login por meio de login.salesforce.com, clique em aqui .

      A chave de instalação é Logik.io-2025!
9. Para uso de CPQ, navegue até Pacotes instalados novamente.
   1. Encontre o Salesforce CPQ e clique em Configurar .
   2. Em Configurações adicionais > URL do configurador externo, atualize para https://<YourLogikURL>/ui/configure e clique em Salvar .
   3. Marque a caixa ao lado de Configurador de terceiros e clique em Salvar .
10. Adicione seu domínio (https://<YourLogikURL>) ao objeto "Configurações personalizadas de administrador Logik.io" no Salesforce.
    Se necessário, defina um token de cliente de tempo de execução para usar Logik com a Comunidade de parceiros do Salesforce.
11. Clique em Salvar.
12. Para uso de CPQ: Navegue até "Gerenciador de apps" e encontre Salesforce CPQ/CPQ/QuoteQuickly.
    Este item pode ter nomes diferentes, dependendo das configurações da sua organização.
    1. Abra o menu suspenso à direita e clique em Editar .
    2. Nas guias disponíveis, encontre "Itens de linha de configuração" e "Conjuntos de dados do campo de configuração" e adicione-os às guias selecionadas.
       Se desejar, ajuste a ordem das guias selecionadas para torná-las mais facilmente acessíveis.
    3. Salvar.
13. Navegue até "URLs confiáveis" e clique em Novo URL confiável .
    Dê ao novo URL as seguintes configurações e clique em Salvar .

    • Na seção Nome da API, dê um nome ao URL, como "ServiceNow CPQ". (Pode ser qualquer nome, desde que você possa referenciá-lo mais tarde.)
    • Adicione seu domínio à seção de URL. (Se você quiser garantir que esta configuração retenha o acesso após uma atualização do SFDC, insira https://*logik.io para garantir que qualquer site logik.io seja confiável.
    • Verificar Ativo .
    • Defina o contexto do CSP como Todos .
    • Em Diretivas de CSP, verifique frame-src (conteúdo do iframe) e. img-src (imagens) opções.
14. Vá para o Gerenciador de objetos e use a caixa Localização rápida no canto superior direito para pesquisar o objeto Produto e selecione a opção cujo nome da API é Product2.
    1. Navegue até Layouts de página e clique em Atribuições de layout de página .
    2. Encontre o layout da página atribuído ao administrador do sistema ou a outros perfis que precisam CPQ Acesso de administrador (conforme determinado ao configurar o Logik Connected App acima).
    3. Selecione o layout de página atribuído ao administrador do sistema.
    4. Arraste Exibir configuração do Logik.io e. Logik.io habilitado para a seção desejada do layout da página (geralmente a parte superior).
15. Navegue até Salesforce CPQ para confirmar se as novas guias estão visíveis.
16. Na guia Produto, confirme se há uma nova exibição chamada Exibição Logik.io .
17. Teste criando ou editando um produto e verificando Logik.io habilitado caixa, verificando Caixa ativa E, em seguida, salvando e atribuindo a ela uma entrada do Catálogo de preços.
    • Na página de detalhes do novo produto, siga o link Clique aqui em Exibir configuração do Logik.io para garantir o acesso a. CPQ Admin
    • Se você receber o erro "Não é possível obter o produto configurável. O <ProductId> do produto não está disponível no cache" Ao tentar acessar um produto configurável, você pode ter ignorado a configuração do usuário do token de atualização na parte superior desta página. Crie o usuário e tente novamente.
    • Se você puder, conceda CPQ um usuário com o endereço de e-mail [e-mail] e podemos verificar a configuração depois de concluí-la.

• Se você receber o erro "Não é possível obter o produto configurável. O <ID> do produto não está disponível no cache" Quando você tenta acessar um produto configurável, você pode ter ignorado a etapa 2 para criar um nome de usuário do token de atualização. Repita a etapa 2.
• Se você receber um "Erro OAuth" com o código OAUTH_APPROVAL_ERROR_GENERIC quando tentar acessar seu URL Logik, seu usuário será bloqueado pelas mudanças recentes que o Salesforce fez nos apps conectados. Para resolver o problema, adicione o texto a seguir ao URL do Meu domínio do Salesforce e clique em Permitir :
  • Para o Logik Connected App:

    /identity/app/AppInstallApprovalPage.apexp?app_id=0Ci5e000000bn6b&app_org_id=00D5e000005AHE7

  • Para o app conectado ao usuário da API Logik:

    /identity/app/AppInstallApprovalPage.apexp?app_id=0Ci5e000000L18c&app_org_id=00D5e000005AHE7

  Em seguida, você poderá seguir as instruções de instalação completas.