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

Image Removed

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.

Tag de Sistema

Prerequisites

Importing the 'Notes' component

1. With the project open, go to 'Run' -> 'Extensions' -> 'Components';

   1. Make sure the component directory is correct;

   2. Click the 'Refresh' button;

2. Select the 'Notes' component;

   1. Click the 'Add Component...' button

   2. Select the 'Add and merge to project' option, and click 'Ok';

3. Wait for the import;

4. Go to 'Run' -> 'Build';

   1. Select all available options for the build;

   2. Click 'Build...';

Using the Level attribute (Assets) in Tags

All Tags that use annotation features must have a level associated with them. For more information on registering Levels, please check the item"Creating Levels (Assets)".

Settings

Registration of Types and Status of Notes

Image Added

Initially, the status list and the list of annotation types should be configured. Each list is configured in a given system tag by separating items from lists by a semicolon
Registration must be made in the template ZLAT_NotesRepository the "StartValue" property or the "Comments" property of the tag. When the project runs, annotation scripts verify that the "StartValue" property is empty. If it is, it checks whether the "Comments" property has been set and passes its value to the system tag value property. If the "StartValue" property is configured, the script passes the contents of this property to the "Value" property of the system tag.
The table below shows the configurable system tags for displaying the list of statuses and types of annotations.

Chamadas de Telas

Cadastro

Screen Calls

Cadastre

For the call of the annotation registration screen, it is necessary to create a button, a menu, a label, finally, any control that contains action dynamics associated with it on some page of the project.
In the control's action dynamics, configure "Run Expressions" ou script. Insira a dinâmica a seguir no primeiro campo expressionor script. Enter the following dynamics in the first expression field:

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

Onde:
  Tag.NomeDaTagTagName.GetName() éis o nomethe da tag aname qualassociated será adicionada uma anotaçãoto annotation;
  Tag.NomeDaTagTagName.Level is éthe asset o nível(level) ato qualwith ais tagassociated estáthe 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.

Image Removed

Sumário de Anotações

annotation.

This dynamic opens the annotations as popup registration screen and passes as parameters to the window the name of the tag and the level of the same.

Image Added

Summary of Notes

The annotation summary screen can be called directly from an action dynamic of any control that supports this type of dynamics or from the Ribbon report button and its corresponding buttons on the other project header screens (AN_Header, AN_Header2, AN_Header3).
A chamada por dinâmica de ação se faz através da opçãoThe call by action dynamics is made through the option:

• "OpenDisplay" passando como parâmetro a tela by parameterising the Display.ZLAR_NotesSummary, ouor

• "Run Expressions" passando o comando by passing the Display.ZLAR_NotesSummary.Open() no campo command in the "Expression" oufield or

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

A chamada pelas telas de cabeçalho é feita apenas selecionando a propriedade The call by the header screens is made only by selecting the "Show on Page selector object" no módulo property in the "Draw" do projeto. Isto fará a tela ser mostrada na lista de relatórios do module of the project. This will make the screen be shown in the "Runtime" report list.
Show on Page Selector e tela de seleção de Relatóriosand Report Selection Screen

Features

Create /

Edit /

Remove Notes

Preparing for the lead screen call described in 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:

Image Removed

• 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:
   

Image Removed

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.
Image Removed
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.

enables the user, at project runtime, to register new annotations or edit existing annotations of a particular project tag. Whatever method was used for the lead screen call, when you run this method, the following screen will be shown:

Image Added

• In the grouping "Details", we have the features of creating and editing annotations for the selected tag.

1. By clicking the "New", the annotation stumbling screen is cleared, as shown in the figure above, and sets the issue date/time and completion values to the current time, the tag, and tag level for the tag selected before the screen call, the operator name for the current operator name of that instance, and the station for the current station name of that instance. The other fields must be configured by the user.

2. By clicking the "Save" the due date/time is set to the current time. If the user is creating a new annotation, the selected settings are entered into the database. If you are editing a previous annotation, changes made as well as the change in the due date/time are overwritten in the database.

3. By clicking the "Remove", the selected item is removed from the database. The remove button, by default, is enabled only for users with permission of type "Administrator". How each project may contain divergent requirements on the security issue. It is at the discretion of the project implementing team to enable/disable the button to other permission groups. To do this, simply access the "Security" properties of the "Remove" button from the "ZLAW_Notes" screen. See the following figure:
   

Image Added

4. By clicking the "Get out", the screen closes. If any changes have been made and have not been saved, it will be lost.

• In the grouping "List of Notes", a list of the last 5 annotations for the selected tag before the window is opened is displayed.

1. When selecting a line from this list, the line values are configured in the controls in the "Details".

2. If changes have been made to the grouping of details that have not been saved, these changes are lost. If necessary, you can make changes to the settings of a selected row and save these changes by clicking the "Save".

Summary of Notes

The preparation for the Call from the Registration screen described above, enables the user to at project runtime, to be able to view all the annotations created in the system, being able to filter them by date / time of issue of the annotations and being able to filter and group the results by tag name, level, type, status, operator and station.
Image Added
The "Start date/time" and "End date/time" fields refer to the note date/date filters.
By clicking the "Search" button, a new search is done from the selected filter.
To sort or filter by other annotation properties, you use the columns for each property.