Pré‐Requisitos

Importação do componente ‘Notes’

1. Com o projeto aberto, vá em ‘Run’ -> ‘Extensions’ -> ‘Components’;

   1. Verifique se o diretório dos componentes está correto;

   2. Clique no botão ‘Refresh’;

2. Selecione o componente ‘Notes’;

   1. Clique no botão ‘Add Component...’

   2. Selecione a opção ‘Add and merge to project’, e clique em ‘Ok’;

3. Aguarde a importação;

4. Vá em ‘Run’ -> ‘Build’;

   1. Selecione todas as opções disponível para o build;

   2. Clique em ‘Build...’;

Utilização do atributo Nível (Assets) nas Tags

Todas as Tags que utilizam as funcionalidades de anotações devem, obrigatoriamente, ter um nível (Level) associado a elas. Para maiores informações sobre cadastro de Levels, favor verificar o item"Criando Níveis (Assets)".

Configurações

Cadastro de Tipos e Status de Anotações

Inicialmente devem ser configurados a lista de status e a lista de tipos de anotações. Cada lista é configurada em uma determinada Tag de sistema separando os itens das listas por ponto e vírgula
O cadastro deve ser feito no "template" ZLAT_NotesRepository na propriedade "StartValue" ou na propriedade "Comments" da Tag. Quando o projeto é executado, os scripts de anotações verificam se a propriedade "StartValue" está vazia. Caso esteja, ele verifica se a propriedade "Comments" foi configurada e passa o valor da mesma para a propriedade value da Tag de sistema. Caso a propriedade "StartValue" esteja configurada, o script passa o conteúdo desta propriedade para a propriedade "Value" da Tag de sistema.
A tabela abaixo apresenta as Tags de sistema configuráveis para apresentação da lista de status e tipos de anotações.

Chamadas de Telas

Cadastro

Para a chamada da tela de cadastro de anotações, se faz necessário a criação de um botão, um menu, um label, enfim, qualquer controle que contenha dinâmicas de ação associadas a ele em alguma página do projeto.
Nas dinâmicas de ação do controle, configure "Run Expressions" ou script. Insira a dinâmica a seguir no primeiro campo expression:

Display.ZLAW_Notes.NewPopup("tagName='" + Tag.NomeDaTag.GetName() + "';tagLevel='" + Tag.NomeDaTag.Level + "'")

Onde:
  Tag.NomeDaTag.GetName() é o nome da tag a qual será adicionada uma anotação;
  Tag.NomeDaTag.Level é o nível a qual a tag está associada.

Esta dinâmica abre a tela de cadastro de anotações como popup e passa como parâmetros para a janela o nome da tag e o Level da mesma.

Sumário de Anotações

A tela de sumário de anotações pode ser chamada diretamente a partir de uma dinâmica de ação de qualquer controle que suporte este tipo de dinâmica ou a partir do botão de relatórios do Ribbon e seus botões correspondentes nas demais telas de cabeçalho do projeto (AN_Header, AN_Header2, AN_Header3).
A chamada por dinâmica de ação se faz através da opção:

• "OpenDisplay" passando como parâmetro a tela Display.ZLAR_NotesSummary, ou

• "Run Expressions" passando o comando Display.ZLAR_NotesSummary.Open() no campo "Expression" ou

• Por script usando-se o comando "@ Display.ZLAR_NotesSummary.Open()".

A chamada pelas telas de cabeçalho é feita apenas selecionando a propriedade "Show on Page selector object" no módulo "Draw" do projeto. Isto fará a tela ser mostrada na lista de relatórios do "Runtime".
Show on Page Selector e tela de seleção de Relatórios

Funcionalidades

Criar / Editar / Remover Anotações

A preparação para a chamada da tela de cadastros descrita no item 7.1.3 habilita o usuário, em tempo de execução do projeto, cadastrar novas anotações ou editar anotações já existentes de uma determinada Tag de projeto. Seja qual foi o método usado para a chamada da tela de cadastro, ao se executar este método, a tela a seguir será mostrada:

• No agrupamento "Detalhes", temos as funcionalidades de criação e de edição de anotações para a Tag selecionada.

1. Ao clicar o botão "Novo", a tela de cadastro de anotações é limpa, como mostrado na figura acima e configura os valores de data / hora de emissão e conclusão para o momento atual, a Tag e o nível da Tag para a Tag selecionada antes da chamada da tela, o nome de operador para o nome do operador atual daquela instância e a estação para o nome da estação atual daquela instância. Os outros campos devem ser configurados pelo usuário.

2. Ao clicar no botão "Salvar" a data / hora de conclusão é configurada para o momento atual. Caso o usuário esteja criando uma nova anotação, as configurações selecionadas são inseridas no banco de dados. Caso esteja editando uma anotação anterior, as alterações feitas assim como a alteração da data / hora de conclusão são substituídas no banco de dados.

3. Ao clicar no botão "Remover", o item selecionado é removido do banco de dados. O botão remover, por padrão, é habilitado apenas aos usuários com permissão do tipo "Administrator". Como cada projeto pode conter requisitos divergentes quanto à questão de segurança. Fica a critério da equipe implementadora do projeto habilitar / desabilitar o botão a outros grupos de permissão. Para isto, basta acessar as propriedades "Security" do botão "Remover" da tela "ZLAW_Notes". Veja a figura seguinte:
   

4. Ao clicar o botão "Sair", a tela é fechada. Caso alguma alteração tenha sido feita e não tiver sido salva, ela será perdida.

• No agrupamento "Lista de Anotações", é apresentada uma lista com as últimas 5 anotações referentes à Tag selecionada antes da abertura da janela.

1. Ao se selecionar uma linha desta lista, os valores da linha são configurados nos controles da aba de "Detalhes".

2. Se houverem sido feitas alterações no agrupamento de detalhes que não tenham sido salvas, estas alterações serão perdidas. Caso seja necessário, é possível realizar alterações nas configurações de uma linha selecionada e salvar estas alterações clicando no botão "Salvar".

Sumário de Anotações

A preparação para a Chamada da tela de Cadastro descrita acima, habilita o usuário para em tempo de execução do projeto, poder visualizar todas as anotações criadas no sistema, podendo filtrá-las por data / hora de emissão das anotações e podendo filtrar e agrupar os resultados por nome de Tag, nível, tipo, status, operador e estação.

Os campos "Data / hora inicial" e "Data / hora final" referem-se aos filtros de data de emissão de anotações.
Ao clicar o botão "Pesquisar", uma nova pesquisa é feita a partir do filtro selecionado.
Para ordenar ou filtrar pelas demais propriedades de anotações, utiliza-se as colunas referentes a cada propriedade.