Gerenciador de transações: Eventos

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 4 min. de leitura
  • Eventos como criação, modificação e exclusão de transações podem ser definidos para acionar grupos de regras ou integrações e mover uma transação de uma fase para outra.

    Os eventos são uma maneira de acionar regras e integrações de fase ou grupos de regras. Geralmente, esses eventos são ativados por botões ou API em um layout que ajudam um usuário a fazer a transição de uma fase para outra.

    Eventos do sistema

    Os eventos do sistema são comportamentos usados com frequência disponíveis para clientes prontos para uso.

    Transação (cabeçalho)

    Quando o Gerenciador de transações é incorporado em um CRM, o usuário recebe um botão na IU do CRM correspondente a esses eventos de transação. Quando o usuário clica em um desses botões, o CRM chama o correspondente CPQ API:

    • Criar transação: Evento acionado para criar uma nova transação.
    • Editar transação: Permite editar uma transação existente, habilitando regras baseadas em fases e ações de integração.
    • Copiar transação: Evento para clonar uma transação e seus itens de linha.
    • Upsert Lines: Este evento gerencia a criação/atualização de linhas de transação depois que o usuário navega pelo catálogo (efeito de IU "productSearch") para adicionar novas linhas ou reconfigurar uma linha existente. As linhas Upsert são executadas automaticamente depois que o usuário termina de selecionar produtos do catálogo, configurar produtos ou reconfigurar (efeito de IU "Reconfigurar"). Embora este evento funcione em linhas com a transação, ele funciona no nível da transação, em todas as linhas da transação.

      Para obter mais informações sobre efeitos de IU, consulte Gerenciador de transações: Layouts - Efeitos de IU.

    • Excluir transação: Evento acionado para excluir uma transação existente.

    Linha de transação:

    Os eventos de nível de linha do Gerenciador de transações são representados no nativo CPQ IU do Gerenciador de transações como botões:

    • Clonar linha: Clona uma linha e seus secundários, mas somente para linhas de nível superior na transação. As regras no nível do cabeçalho também se aplicam após a clonagem.
    • Excluir linhas: Exclui uma ou mais linhas de uma transação; a IU oferece suporte à seleção de linhas e os IDs podem ser passados no modo sem periféricos.

    APIs de evento

    As APIs de evento são autorizadas somente por meio de cookie de sessão.

    Aviso:
    Evite criar um cenário em que o usuário inicia um evento que dispara uma API de evento na mesma transação. Como a IU e as APIs estão agindo sobre o mesmo registro, essa implementação pode resultar em comportamento imprevisível.

    Eventos personalizados

    Além dos eventos do sistema, o administrador pode definir eventos personalizados para atender aos requisitos específicos dos negócios. Para criar um evento personalizado, siga estas etapas.

    1. Em Administrador do Gerenciador de transações, clique em Eventos e clique em Novo evento .

      Gerenciador de transações: Eventos

    2. Na janela Novo evento, insira um nome. À medida que o nome é inserido, ele é espelhado no Nome da variável campo. Por padrão, o nome da variável é o mesmo que o nome inserido, mas em caso de camel com todos os espaços e caracteres especiais removidos. Por exemplo, se você inserir o nome Total de linhas de fabricação, o nome da variável inserido automaticamente será totalOfManufacturingLines. Para criar um nome de variável personalizado, clique no ícone de lápis à direita do campo de nome da variável e insira seu próprio valor.

      Gerenciador de transações: Eventos

    3. Selecione Linha de transação e clique em Salvar .

    O editor de eventos é aberto. Por padrão, os eventos têm o acesso a eventos definido como Sem acesso. Clique em Editar acesso ao evento , altere o nível de acesso ao evento para Ativo e clique em Concluído para retornar ao editor de eventos.

    Gerenciador de transações: Eventos

    Gerenciador de transações: Eventos

    Na área Ações, você pode atribuir agrupamentos de regras ou integrações para disparar quando o evento for acionado. Para adicionar uma nova ação ao evento, clique em - Adicionar nova ação e escolha agrupamentos de regras ou integração. Um menu dos agrupamentos de regras ou integrações disponíveis é exibido. Escolha o agrupamento de regras ou a integração a ser aplicada ao evento. Você pode adicionar vários agrupamentos de regras ou integrações ao mesmo evento.

    Gerenciador de transações: Eventos

    Use o. Transição alterne para determinar se o evento faz a transição da transação para frente ou para trás na sequência de fases. Por padrão, o evento não faz a transição da transação para outra fase. Clicando em Transição a alternância ativa a função de transição.

    Gerenciador de transações: Eventos

    Gerenciador de transações: Eventos

    Ao terminar, clique em Salvar. O novo evento aparece na lista de eventos como um evento de nível de transação ou um evento de nível de linha de transação, dependendo do nível escolhido quando o evento foi criado.

    Gerenciador de transações: Eventos

    Configurações de evento: Validar itens configurados

    . Valide itens configurados a definição em eventos de cabeçalho personalizado valida as configurações do produto na transação quando o evento é executado. A validação ocorre antes das ações do evento, que são executadas independentemente do status de validação.

    A configuração inclui um período de validade que exclui produtos validados dentro de um intervalo de tempo. Por exemplo, se o período de validade for definido como 15 dias e um produto tiver sido validado há 7 dias, a configuração do produto não será validada. Se um produto foi validado há 20 dias, a configuração do produto será validada.

    Dois campos do sistema no nível de linha oferecem suporte a esta função: txn.line.configuration.status(Booliano) e txn.line.configuration.validatedAt (data).