Quando o equipamento fica desligado, o gráfico de tendência traça uma reta sobre o intervalo sem dados. A propriedade EnableQualityLogs do Histórico (DB.Hist) resolve isso na origem.
01. Introdução
Ao exibir dados históricos em um gráfico de tendência (E3Chart), é comum haver períodos sem dados — por exemplo, quando o equipamento fica desligado ou o servidor de coleta é interrompido por um intervalo. Nesses casos, o E3Chart liga automaticamente o último ponto anterior à parada ao primeiro ponto após a religação, traçando uma linha reta sobre todo o período em que não houve coleta.
Esse comportamento é padrão do E3Chart: o gráfico conecta os pontos retornados pela consulta ao banco de dados, independentemente do intervalo de tempo entre eles. Não existe uma propriedade no próprio E3Chart que desabilite essa ligação. A linha reta, porém, não representa o processo real e pode induzir o operador a interpretações equivocadas.
A forma correta de resolver isso é tratar o problema na origem, no objeto Histórico (DB.Hist), por meio da propriedade EnableQualityLogs. Ela registra automaticamente uma marca de qualidade ruim no início de cada coleta, fazendo o E3Chart quebrar a pena (interromper a linha) no ponto correto, em vez de conectar os dois trechos.
Reprodução do E3Chart. À esquerda, a pena atravessa o período sem coleta (marcado em vermelho) com uma reta indevida. À direita, o registro de qualidade ruim (○) faz a pena ser interrompida no ponto correto.
02. O que é a propriedade EnableQualityLogs
EnableQualityLogs é uma propriedade booleana do objeto Histórico, com valor padrão False (desabilitada).
Quando habilitada (True), sempre que a coleta do Histórico é iniciada o E3 grava, antes do primeiro registro real, um registro adicional com:
- os mesmos valores do primeiro registro coletado;
- qualidade ruim (0);
- carimbo de tempo (TimeStamp) de 1 segundo antes do primeiro registro real.
Esse registro de qualidade ruim é o “marcador” que o E3Chart usa para identificar que ali houve uma descontinuidade na coleta e, portanto, a pena não deve ser ligada ao trecho anterior.
Por que a qualidade ruim resolve o problema?
O E3Chart interrompe automaticamente o traçado de uma pena quando encontra um ponto com qualidade ruim. Ao inserir esse ponto no exato instante em que a coleta recomeça, o gráfico exibe uma quebra visível (gap) no lugar da linha reta que antes conectava os dois períodos de operação.
03. Quando o registro é gerado
O registro de marcação é criado nas seguintes situações:
| Situação | Comportamento com EnableQualityLogs = True |
|---|---|
| Ativação do Histórico (início do domínio / religação do servidor) | Grava um registro de qualidade ruim datado 1 segundo antes do primeiro registro real. |
Chamada do método StartAcquisition |
Idem — o registro de marcação também é gerado ao retomar a coleta por script. |
Chamada de StopAcquisition seguida de nova coleta |
A próxima retomada gera novamente a marca de início. |
Dessa forma, o comportamento vale tanto para a inicialização normal da aplicação quanto para pausas e retomadas de coleta feitas via script (por exemplo, durante uma manutenção ou calibração de instrumentos).
04. Como habilitar
Pelo E3 Studio
- No Organizer, localize o objeto Histórico (DB.Hist) desejado.
- Abra a Lista de Propriedades do objeto.
- Localize a propriedade
EnableQualityLogse altere seu valor para True. - Salve o projeto.
Por script
A propriedade pode ser lida e escrita em tempo de execução:
' Habilitar o registro de marca de início no Histórico:
Application.GetObject("HistProcesso").EnableQualityLogs = True
Exemplo dentro de uma rotina de configuração do Histórico:
Sub ConfigurarHistorico()
Dim hist
Set hist = Application.GetObject("HistProcesso")
hist.DBServer = "BancoDados"
hist.TableName = "Processo"
hist.ScanTime = 5000 'grava a cada 5 s
hist.EnableQualityLogs = True 'marca a parada/retomada da coleta
hist.StartAcquisition 'ao iniciar, gera o registro de qualidade ruim
End Sub
Observação: As chamadas aos métodos StartAcquisition e StopAcquisition respeitam a configuração da propriedade EnableQualityLogs. Quando essa propriedade está habilitada, cada retomada da coleta gera automaticamente um registro de qualidade ruim, marcando a descontinuidade para que o E3Chart interrompa a linha no ponto correspondente.
05. Resultado no E3Chart
Com EnableQualityLogs habilitado, ao carregar os dados históricos o E3Chart passa a apresentar uma interrupção (gap) em cada ponto de reinício da coleta, em vez de uma reta ligando períodos distintos de operação.
| Configuração | Comportamento da pena |
|---|---|
| Sem EnableQualityLogs | A pena liga o último valor antes da parada ao primeiro valor após a religação, criando uma reta sobre o período sem dados. |
| Com EnableQualityLogs | A pena é interrompida no instante em que a coleta parou, refletindo fielmente que não houve dados naquele intervalo. |
Como a solução atua no momento da gravação do histórico, ela não exige nenhuma configuração adicional no E3Chart e beneficia igualmente qualquer outro consumidor dos dados (E3Browser, relatórios, consultas).
06. Observações e boas práticas
- A propriedade nasce desabilitada (False); habilite-a nos Históricos em que a interpolação entre períodos de parada é indesejada — tipicamente penas de tendência exibidas ao operador.
- O registro de marcação recebe qualidade 0 (ruim). Ao montar consultas (E3Query) com cálculos estatísticos (média, integral etc.), considere filtrar pela coluna de qualidade para não incluir esse ponto artificial no cálculo.
- O comportamento funciona tanto para as tabelas nativas do E3 quanto para tabelas de usuário, e independe de a gravação ser por tempo (ScanTime) ou por evento (WriteRecord).
- Não há, no E3Chart, uma opção que desligue a conexão automática entre pontos — por isso a marcação de qualidade ruim no Histórico é a abordagem recomendada.
- A funcionalidade está disponível a partir do E3 versão 1.2.
