Como usar filas personalizadas para processar eventos

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 1 min. de leitura
  • Você pode usar filas personalizadas para aplicações que criam um grande volume de eventos ou eventos que demoram muito para serem processados. Esta tarefa mostra como criar uma fila personalizada, seu processo de monitoramento e usar um script para enviar eventos para a fila.

    Antes de Iniciar

    Função necessária: administrador

    Nota:
    Essas informações são para usuários avançados que entendem de processamento de eventos.

    Procedimento

    1. Navegar até Política do Sistema > Eventos > Registro.
    2. Selecione o evento para o qual você deseja criar uma fila personalizada.
      O formulário Registro de eventos é exibido.
    3. Preencha o campo Fila do evento no Registro de eventos.
      Use somente letras minúsculas, sem espaços e sem caracteres especiais, exceto sublinhado (_).

      Formulário Registro de eventos realçando o campo Fila que contém o nome da fila em minúsculas.

    4. Clique em Enviar.
      Um novo evento é listado na tabela Eventos [sysevent].

      No exemplo a seguir, quando o evento employeeOcasion é gerado, o evento é adicionado a my_queue. Os eventos estão parados na fila. Para resolver esse problema, crie um processo para observar a fila de eventos.Tabela de eventos que lista o evento com a fila adicionada listada no campo de fila.

    5. Navegar até Scheduler do Sistema > Trabalhos agendados > Trabalhos agendados e abra o trabalho agendado chamado processo de eventos de índice de texto.
      Tabela de programação com *texto no campo de pesquisa Nome e o nome da programação de processo de eventos de índice de texto realçado.
    6. Clique no ícone do menu de ações adicionais (menu do ícone de ações adicionais) e selecione Inserir e permanecer para criar uma cópia do processo de eventos de índice de texto.
      Importante:
      Certifique-se de copiar o trabalho e não substituir o trabalho agendado do processo de eventos de índice de texto.
    7. No item de programação copiado, altere o valor no campo Nome.
    8. No campo Contexto do trabalho, substitua o valor do parâmetro GlideEventManager() pelo nome da nova fila.
      Formulário Item de programação mostrando o item copiado renomeado e o nome da fila atualizado para GlideEventManager no campo decontexto do trabalho.
      O processo de monitoramento de fila procura e processa eventos no exemplo de fila de eventos my_queue.

      Tabela de eventos que destaca o conteúdo dos campos Processado e Fila.

    9. Use o quinto parâmetro do método gs.eventQueue() para enviar eventos para a fila personalizada.

      O código a seguir mostra como enviar um evento para a fila personalizada my_queue.

      gs.eventQueue('x_60157_employee_spe.employeeOccasion', todaysOccasions, todaysOccasions.number, todaysOccasions.u_employee.name, 'my_queue');
      Nota:
      Se um evento estiver no Registro de eventos e nenhum nome de fila for fornecido para gs.eventQueue, a fila do Registro de eventos ainda será atribuída ao evento. Por exemplo, gs.eventQueue('x_60157_employee_spe.employeeOcasião') ainda associa o evento a my_queue. Se o nome da fila for fornecido na chamada gs.eventQueue(), a fila terá prioridade.
      Você pode verificar se o evento chamado foi processado verificando a tabela Eventos [sysevent].

      Tabela de eventos que lista eventos processados filtrados pelo nome do evento.