Histórico de Eventos
App Builder registra a execução do evento na tabela de histórico de eventos. Os seguintes eventos são registrados:
- Eventos executados em segundo plano, sejam eles agendados ou iniciados por um usuário.
- Qualquer evento que gere uma exceção.
- Qualquer evento que leve mais de 10 segundos para ser executado.
O histórico de eventos está disponível para administradores por meio do IDE > Monitoramento. O histórico de eventos também está disponível para desenvolvedores programaticamente por meio do objeto de dados públicos EventHistory. O objeto de dados públicos EventHistory expõe as seguintes colunas:
EventHistoryId
- Inteiro monotonicamente crescente.ContextId
- Identificador exclusivo que pode ser usado para correlacionar eventos que ocorrem dentro de uma única operação, como uma regra CRUD de negócios. Este valor é acessível para regras usando a função de tempo de execução mvSQL event('contextid').TableId
- A tabela na qual o evento foi invocado.EventName
- O nome do evento invocado.Result
- O resultado do evento. Os valores possíveis incluem Success, Error e Cancelled.StartedOn
- A data e hora em que o evento foi invocado.CompletedOn
- A data e hora em que o evento terminou, com sucesso ou não.Duration
- A duração da execução do evento em milissegundos. Como muitos campos de timestamp SQL não têm precisão de milissegundos, esse número pode diferir do valor derivado subtraindo StartedOn de CompletedOn.RanAsUserId
- O identificador do principal do usuário sob o qual o evento foi executado. Este valor é acessível às regras por meio da função de tempo de execução mvSQL who('userid').Bindings
- Critérios de vinculação usados para recuperar a linha na qual o evento foi executado. Os critérios são serializados usando codificação de URL (por exemplo, Nome1=Valor1&Nome2=Valor2). Vinculações não estão disponíveis para todos os eventos.Exception
- Mensagem de exceção se o evento falhou como resultado de uma exceção. Este valor é acessível a manipuladores de falha de ação usando a função de tempo de execução mvSQL event('exception').SessionId
- No caso de um evento iniciado pelo usuário, o identificador de sessão do usuário. No caso de um evento agendado, um identificador de sessão efêmero. Este valor é acessível para regras usando a função de tempo de execução session() mvSQL.RowId
- Identificador exclusivo para a linha na qual o evento foi invocado. No caso de uma regra CRUD de negócios, isso se refere ao identificador da linha de destino. Esse valor é acessível para regras usando a função de tempo de execução mvSQL event('rowid').SourceRowId
- Identificador exclusivo para a linha de origem de Inserção e Atualização do CRUD empresarial. Este valor é acessível para regras de CRUD empresarial usando a função de tempo de execução mvSQL event('source.rowid').
Nota
A entrada é escrita no histórico de eventos após o evento ter sido executado. Como consequência, o próprio evento não pode acessar sua entrada de histórico.