Como efetuar logging no ERP?
Obter informações sobre as operações efetuadas pelo utilizador é muito importante para qualquer aplicação transacional. É através deste registo que conseguimos despistar eventuais problemas, erros ou até mesmo perceber o que está a acontecer quando o código é executado. O mecanismo de registo de log do ERP foi amplamente melhorado para dar mais informação ao utilizador e para que esta informação possa ser carregada para Excel. Este mecanismo encontra-se na assembly Primavera.Platform.Helpers, que deve referenciar nos seus projetos em que pretende utilizar esta funcionalidade. Os métodos disponíveis pertencem à classe StdLoggingHandler e são os seguintes: O método FileTraceIgnoredException deve ser usado para registar no log exceções que vão ser ignoradas. É possível identificar estes registos através da tag [IGNORED]. De forma semelhante, o método FileTraceWithThrow deve ser usado quando as exceções não vão ser ignoradas e vão ser devolvidas ao método anterior. Neste caso, o registo de log é gerado com a tag [THROWED]. O método FileTraceEnterMethod deve ser usado no início da execução de um método (ou função) para registar a sua entrada. As entradas de log seguintes são indentadas no ficheiro, voltando ao normal depois de invocar o método FileTraceExitMethod. Quando o mecanismo de registo de log é ativado, é criado um ficheiro com o nome erp.log na pasta c:\temp. Quando este mecanismo é desativado, o ficheiro é removido. Este ficheiro também pode ser criado manualmente nesta pasta, o que faz com que o mecanismo seja automaticamente ativado no arranque de cada sessão do ERP. Pode encontrar vários exemplos de utilização destes métodos neste projeto do GitHub.ActivateLog Ativa o registo de log do ERP sem ser necessário reiniciar a aplicação DeactivateLog Desliga o registo de log para a sessão atual do ERP ClearLogFile Limpa o ficheiro de log em runtime FileTrace Regista uma mensagem definida pelo programador FileTraceEnterMethod Regista a entrada no método de invocação (com ou sem mensagem) FileTraceExitMethod Regista a saída no método de invocação (com ou sem mensagem) FileTraceFirstChanceException Registo colocado no handler de First Change Exception do ERP FileTraceIgnoredException Regista exceções ignoradas FileTraceOnlyOnVerbose Apenas faz registos de log se o modo verbose estiver ativo FileTraceVerbose Faz um registo com mais detalhes da stack de invocação FileTraceWithThrow Regista exceções que fazem throw FullMessageFromException Regista a mensagem total de uma excepção (incluindo inner exceptions) GetActiveLogContent Permite visualizar os registos do log GetActiveLogTail Permite visualizar os últimos n registos do log GetActiveLogFile Devolve o nome do ficheiro de log ativo Indent Indenta (adiciona uma tabulação inicial) as chamadas seguintes no log Outdent Remove o espaçamento inicial FileTraceIgnoredException vs FileTraceWithThrow
FileTraceEnterMethod vs FileTraceExitMethod
ActivateLog vs DeactivateLog
Para o registo de log funcionar em modo verbose, o nome do ficheiro deve ser erp.verbose.log.
login para deixar a sua opinião.