Base de Históricos

Esta página apresenta os itens para gerência de Históricos.

Um Histórico é responsável pelo armazenamento de valores de Tags coletados durante a execução de uma aplicação em um Banco de Dados externo a mesma. Este armazenamento pode ser realizado por determinados períodos ou na ocorrência de algum evento, devendo este ser configurado de acordo com a necessidade da aplicação.

Fig. Árvore de itens de HistoryBases

A criação e configuração de Históricos requerem a prévia criação dos itens DataBase e List, onde estes serão utilizados na configuração do Histórico para determinar qual o banco de dados para armazenagem e quais os Tags que serão historiados.

HistoryBases

Este item permite a criação de históricos a serem utilizados na aplicação.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item “HistoryBases” no painel de projeto.

Identificação
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)

HistoryGroup

Para adicionar um Histórico, primeiramente deve-se criar um grupo de Históricos. Para isso, clique com botão direito do mouse sobre o item “HistoryBases” e selecione o menu “Adiciona Item/HistoryGroup”.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item “HistoryGroup” no painel de projeto:

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Descrição	Texto opcional que permite a inclusão de uma breve descrição do item associado. Este campo é apenas documental.	(Nenhum)

History

Uma vez adicionado o grupo pode-se criar um Histórico. Para isso, clique com botão direito sobre o grupo desejado e selecione o menu “Adiciona Item/History”.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item “History” no painel de projeto.

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Descrição	Texto opcional que permite a inclusão de uma breve descrição do item associado. Este campo é apenas documental.	(Nenhum)

Conexão e Dados
Propriedade	Descrição	Default
DataBase	Define o Banco de Dados onde serão salvos os dados a serem historiados.	(Nenhum)
Lista de Tags	Define a Lista com as referências de Tags que serão utilizadas para geração do Histórico.	Sem Lista de Tags definida
Define nome da tabela	Define se o nome da tabela no banco de dados será definido pelo usuário ou se terá o valor padrão.	Não
Nome da tabela	Nome a ser utilizado para a tabela no banco de dados.	(Nenhum)
Gerar tabela	Cria tabela de histórico no banco de dados.
Limpar tabela	Limpa dados da tabela de histórico.

Caso não exista na aplicação um Banco de Dados (DataBase) e uma Lista de Tags(List) previamente criadas, as propriedades acima exibirão as mensagens de “Sem DataBase definida” ou “Sem Lista de Tags definida” respectivamente.

Período de Amostragem
Propriedade	Descrição	Default
Período de amostragem padrão [s]	Define o período (intervalo), em segundos, em que os dados associados ao histórico serão acrescentados no banco de dados. Caso este valor seja 0, esta funcionalidade estará desabilitada. Se o usuário associar um Tag no campo de inserção de registro dos dados, o ‘Período de amostragem’ será removido do editor de propriedades, e sua funcionalidade estará desabilitada.	0
Utiliza tag para obter período de amostragem	Habilita ou desabilita a utilização de um tag para obter o período de amostragem. Caso seja habilitado, os dois próximos atributos serão exibidos.	Não
Tag fonte do período de amostragem	Permite selecionar o tag que contem o valor de amostragem a ser utilizado.	(Nenhum)
Offset do Tag fonte do período de amostragem	Caso o Tag período de amostragem seja um vetor, este campo indica o offset do valor a ser utilizado.	1

Habilitação e Inserção
Propriedade	Descrição	Default
Tag de habilitação do histórico	Tag utilizado para determinar se o registro de dados no banco de dados está habilitado.	(Nenhum)
Offset do Tag de habilitação	Caso o Tag de habilitação seja um vetor, este campo indica o offset do valor a ser utilizado.	1
Tag de inserção de registro	Quando o valor deste Tag for alterado será realizado um registro no histórico.	(Nenhum)
Offset do Tag de inserção de registro	Caso o Tag de inserção de registro seja um vetor, este campo indica o offset do valor a ser utilizado.	1