Logar

Envia Gera um log para a na saída do console de acordo como for configurado.

Parâmetros 

com a configuração do nível de log. Quanto maior a abrangência do Nível de log, mais logs serão gerados. Para mais detalhes, acesse a documentação oficial.

 Image Added

Figura 1 – Bloco Logar

Compatibilidade

• Bloco servidor: cronapi.util.Operations.log()

Retorno

Bloco sem retorno.

Parâmetros

Categoria

Chave de referência da mensagem do log.

Parâmetro 2StringNível e tipo de log.

O Cronapp utiliza a categoria "General" por padrão, porém, é possível personalizar a categoria para facilitar a identificação da mensagem em meio a um documento de log muito extenso.

• Posição: 1
• Inglês: Category
• Tipo: Texto / String
• Exemplo: "General"

Nível de log

Define o nível e tipo de log. Por padrão, o sistema do Cronapp é configurado com os níveis de log "Informação", "Erro" e "Aviso". Para exibir o log das demais opções, será necessário criar um novo parâmetro do sistema. Assim, acesse no menu do sistema Projeto > Parâmetros do sistema. Na janela que será exibida, clique em "Novo" para criar um novo parâmetro e, nele, escolha a opção Nível de log. A exibição do log ocorre por ordem hierárquica, ou seja, habilitar o log em um determinado nível também habilitará o log em todos os níveis superiores.

• Posição: 2
• Inglês:  Log Level
• Tipo: Texto / String
• Exemplo: configurando a opção Refinado Médio no parâmetro do sistema e Refinado Médio no bloco, ele irá exibir os logs de Refinado Médio e todas as outras antes dele, e assim por diante.
• Níveis em ordem decrescente:
  • Erro (SEVERE (maior valor)): mensagens de erro devem descrever eventos de considerável importância que impedirão a execução normal do programa.
  • Aviso (WARNING): mensagens de aviso devem descrever eventos que indicam problemas potenciais para usuários finais e administradores do sistema.
  • Informação (INFO): as mensagens de informação devem ser usadas apenas para mensagens razoavelmente significativas que façam sentido para usuários finais e administradores do sistema.
  • Configuração (CONFIG): mensagens de configuração são destinadas a fornecer uma variedade de informações de configuração estática para auxiliar na solução de problemas associados a configurações específicas. Por exemplo, uma mensagem de configuração pode incluir o tipo de CPU, a profundidade gráfica e a aparência da interface gráfica.
  • Refinado Baixo (FINE): mensagens fine podem incluir informações sobre falhas menores (recuperáveis). Questões que indicam potenciais problemas de desempenho também valem a pena ser registradas nesse nível.
  • Refinado Médio (FINER): indica uma mensagem de rastreamento bastante detalhada. Por padrão, chamadas de registro para entrada, retorno ou lançamento de uma exceção são rastreadas neste nível.
  • Refinado Alto (FINEST (menor valor)): indica uma mensagem de rastreamento altamente detalhada.

Mensagem de log

Texto que será enviado para o log.

• Posição: 3
• Inglês: Log Menssage
• Tipo: Texto / String
• Exemplo: "E-mail enviado com sucesso."

Detalhe de log

Poderá ser um texto ou um objeto de exceção contendo os detalhes do log.

Retorno

Por padrão, retorna um log para o console.

Compatibilidade

Image Removed Servidor

• Posição: 4
• Inglês:  Log Detail
• Tipo: Objeto / Object 
• Exemplo: é possível utilizar um bloco texto ou uma variável de parâmetro da função, como no exemplo da figura 2.

Exemplo 

A função abaixo enviará para o console uma mensagem de log do tipo Informação após um e-mail ser enviado.

Image RemovedImage Added

Figura 1 2 - Enviando log para o console com o bloco Logar

Após a função acima ser executada, é exibido no console o log que foi configurado no bloco Logar. 

Image RemovedImage Added

Figura 2.1 - Retorno Log gerado no console do log