Guia de uso para os símbolos inclusos no projeto default
Símbolos
Datagrid_Filter
É um símbolo que pode ser utilizado em qualquer tela que possua uma janela do tipo DataGrid. É usado para inserir filtros rápidos de data / hora e opcionalmente também por nível de Tags e Tags específicas.
Configurações necessárias
Filtro por Data / Hora
Em uma tela que possua um elemento DataGrid, basta selecionar na lista de símbolos ‘Datagrid_Filter’ e o posicionar no local desejado.
Em seguida, deve-se abrir as configurações do DataGrid dando um duplo clique em cima do componente, ou selecionando a opção de ‘configurações’ nas configurações a esquerda da tela, e colocar o seguinte no campo de filtro:
Tag.ZZ_System.Filter.SQL.FilterSQL.Value
Por fim, basta abrir o ‘Códigos’ da tela, e colocar no método ‘DisplayOpening' o seguinte Script:
@Script.Class.Filter.StartUp(FILTRO_PADRÃO, DATE_FIELD, TAG_FIELD, LEVEL_FIELD);
Onde:
'FILTRO_PADRÃO' é o valor padrão do filtro do DataGrid, caso ele possua um;
'DATE_FIELD' é o valor para o nome da coluna de Data / Hora do DataGrid a ser filtrado;
'TAG_FIELD' é o valor para o nome da coluna de Tags do DataGrid a ser filtrado;
'LEVEL_FIELD' é o valor para o nome da coluna de Levels do DataGrid a ser filtrado;
Caso seja passado o valor ‘string.Empty’ nesses argumentos, seus valores padrões são:
'FILTRO_PADRÃO' - string.Empty;
'DATE_FIELD' - “ActiveTime_Ticks”;
'TAG_FIELD' - “TagName“;
'LEVEL_FIELD' - “Level“;
TEMPORÁRIO
Para o funcionamento completo do símbolo, deve-se após adicioná-lo na tela, clicar com o botão direito em cima dele e clicar em “Unmake symbol“.
Filtro por Tags e Nível de Tags
Na mesma tela em que foi adicionado o símbolo, selecione na lateral o componente 'Assets', e configure dando um duplo clique nele as seguintes Tags:
SelectedAsset
Tag.ZZ_System.Filter.Assets.SelectedAsset
SelectedLevel
Tag.ZZ_System.Filter.Assets.SelectedLevel
Funcionamento
Quando não há nenhum filtro ativo, o símbolo ficará com suas datas e horas opacas e quando ativo sua visualização ficará normal, como visto abaixo:
O símbolo possui duas entradas de tempo, sendo uma de data e outra de hora para o filtro de tempo inicial, e o mesmo para o tempo final. Além disso, possui dois botões, um para aplicar o filtro (aplica tanto o filtro de data/hora quanto de níveis/tags caso esteja sendo usado), e outro para limpar todos os filtros e manter apenas o valor do filtro padrão do DataGrid, ou mostrar todos os dados caso nenhum filtro padrão tenha sido configurado. O uso do componente ‘Assets’ permanece inalterado, sendo apenas necessário selecionar com um click de mouse no nível ou Tag desejada, em seguida clicar no botão de filtrar do símbolo para aplicar o filtro.