Objeto de ação

Nome	Objeto de ação
Tecla de atalho	Nenhuma
Ícone
Objeto gráfico	Não

ObjAction

Este objeto é utilizado para permitir associar ações à tela ou aos seus objetos. Desta forma não é necessário criar scripts para alguns eventos do sistema.

Nota

Os possíveis eventos sobre os objetos dependem do nível hierárquico do mesmo, portanto, quanto mais especifico o objeto menos eventos ele pode apresentar. Ex: Uma ação sobre um objeto que realiza eventos, como um navigator, nao apresenta evento algum, enquanto um objeto de edição pode apresentar um evento de click ou de mudança(onChange). Repare que um edit é mais genérico e pode ter uma ação de inserção ou alteração, enquanto um navigator ja tem ações bem definidas.

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)
Argumentos	Neste campo pode-se inserir uma string que será o valor da propriedade Argument do item. A string fornecida é uma forma geral de passagem de parâmetros para os scripts associados ao objeto durante sua execução.	(Nenhum)

Propriedades Comuns
Propriedade	Descrição	Default
Descrição	Pode-se acrescentar uma breve descrição sobre o objeto. Este campo é apenas documental, não sendo utilizado no projeto. Este campo não é obrigatório.	(Nenhuma)

Na tabela Configuração da ação - Geral constam as propriedades que são comuns a todas as Categorias de Ações. As propriedades mais específicas de cada categoria são apresentadas em outras tabelas mais adiante nessa documentação.

Configuração da ação - Geral
Propriedade	Descrição	Default
Tipo de Evento	Permite selecionar o tipo de evento no qual se deseja executar a ação. Opções: OnAfterRefresh OnChange OnClick OnClickButtonLabelYAxis OnClickSeries OnClickYAxis OnCreate OnDbClick OnDestroy OnExit OnMouseDown OnMouseUp OnRelease OnSelect OnShow O Tipo de evento depende do objeto que realizará a ação, assim, somente algumas (ou nenhuma) das opções acima vão aparecer na criação do Object Action.	(Nenhum)
Categoria de ações	Define em qual categoria da árvore de estrutura do projeto o Evento será realizado. Todas as possíveis categorias de ações disponíveis: Telas Tags Relatórios Usuários Geral Data Source	(Nenhuma)
Ação	Permite selecionar a ação associada ao evento. Todos os tipos de ações disponíveis: Abre Tela Fecha Tela Envia Valor para Tag Inverte Valor de Tag Abre Relatório Atualiza Preview de Relatório Efetua Logout Configura Senha do Usuário Acessa Gerência de Usuários Fecha Aplicação Exibe caixa de mensagem Executa script Filtra registros Retira filtro de registros Localiza registro Ordena registros Atualiza registros Insere registro Remove registro selecionado Edita registro selecionado Salva edição do registro selecionado Cancela edição do registro selecionado Aplica alterações Não aplica alterações Obtém valor do campo(field) selecionado Atribui valor no campo(field) selecionado	(Nenhuma)
Interrompe próximas ações(falha/ cancelamento)	Define se a ação corrente irá interromper outras ações do projeto caso haja falha ou cancelamento da ação atual.	Não

Cada Categoria de Ação tem suas Propriedades e Ações específicas, que são habilitadas quando uma Categoria e/ou ação é selecionada. A seguir para cada categoria temos duas tabelas: * A primeira descreve as ações disponíveis relacionadas à cetegoria selecionada. * A segunda descreve as propriedades disponíveis relacionadas à categoria selecionada.

Telas

Categoria de Ação - Telas
Ação	Descrição
Abre Tela	Define a ação de abrir uma Tela onde a ação será executada. Esta ação é semelhante a abertura de tela via script utilizando a função Screens.Open(), que recebe como parâmetro o apelido da tela e o seu caminho completo. O apelido é uma string definida pelo usuário no script que visa identificar unicamente a tela para que possa ser recuperada através de outras funções como: Screens.Get() e Screens.Close(), que recebem como parâmetro apenas o apelido da tela. Já no caso da abertura de tela via ação, o apelido utilizado possui o seguinte formato: GrupoDaTela.NomeDaTela É utilizado o nome do grupo da tela na definição do apelido para que eventuais repetições de nome de uma tela em grupos distintos não gerem inconsistências na abertura das mesmas via uma ação. Portanto, caso seja necessário obter a tela via script(através de alguma função que utiliza o apelido), deve-se fornecer no formato GrupoDaTela.NomeDaTela.
Fecha Tela	Define a ação de fechar uma Tela onde a ação será executada.

Categoria de Ação - Telas
Propriedade	Ação Associada	Descrição	Default
Tela	Abre Tela	Define sobre qual tela a ação deve ser configurada/executada.	(Nenhuma)
Abrir tela na posição da tela atual	Abre Tela	Define se a nova tela deve abrir sobre a tela corrente ou se a mesma deve abrir na posição definida pelo projeto.	Não
Fecha tela atual	Fecha Tela	Define a ação de fechar uma tela atual em execução.Não é possível fechar uma tela de um projeto onde essa tela é única.	Sim

Tags

Categoria de Ação - Tags
Ação	Descrição
Envia valor para Tag	Define o envio de um valor para um Tag na ocorrência de uma ação.
Inverte valor de Tag	Define a inversão entre dois valores em um Tag na ocorrência de uma ação.

Categoria de Ação - Tags
Propriedade	Ação Associada	Descrição	Default
Nome do Tag	Envia valor para Tag Inverte valor de Tag	Define o tag responsável por fornecer/receber os dados que serão gerados ou utilizados em uma determinada ação.	(Nenhum)
Índice	Envia valor para Tag Inverte valor de Tag	Define para qual índice de um vetor de Tags o valor definido será enviado.Se o Tag definida não é um vetor, sua posição de indice é 1.	1
Valor a ser enviado	Envia valor para Tag	Define o valor desejado que será enviado para o Tag.	(Nenhum)
Valor 1	Inverte valor de Tag	Na ação de inversão de valores, define um primeiro valor para um Tag que pode ser trocado na ocorrência de uma ação.	(Nenhum)
Valor 2	Inverte valor de Tag	Na ação de inversão de valores, define um segundo valor para um Tag que pode sobrescrever o Valor 1 na ocorrência de uma ação.	(Nenhum)
Envia valor default	Inverte valor de Tag	Define se será enviado para o tag um valor default que pode ser definido pelo usuário.	Não
Valor default	Inverte valor de Tag	Define o valor que será enviado para o Tag como default na ocorrência de uma ação.	(Nenhum)

Relatórios

Categoria de Ação - Relatórios
Ação	Descrição
Abre Relatório	Define a ação de abertura de um relatório previamente criado no módulo Reports. Essa ação cria uma janela externa à aplicação onde é possível operar sobre o relatório gerado. (Salvar como PDF, Imprimir, etc).
Atualiza Preview de Relatório	Define abertura de um preview do relatório dentro da própria aplicação. Não é possível imprimir ou salvar esse Preview.

Categoria de Ação - Relatórios
Propriedade	Ação Associada	Descrição	Default
Relatório	Abre relatório	Define o relatório que será relacionado à ocorrência da ação.	(Nenhum)
Preview	Atualiza preview de relatório	Define o preview que será associado à ocorrência da ação, sendo um relatório associado ao preview selecionado.	(Nenhum)

Usuários

Categoria de Ação - Usuários
Ação	Descrição
Efetua Logout	Define a ação de logout da aplicação. Uma janela de confirmação para a ação pode ser configurada.
Configura Senha do Usuário	Define a ação de configurar uma nova senha para o usuário. Na ocorrência da ação, o formulário exibe primeiro uma janela para inserir o usuário e senha atuais. Confirmados os dados, exibe os campos para nova senha e confirmação da mesma.
Acessa Gerência de Usuários	Define a ação de acesso a área de Gerência de Usuários. Na ocorrência da ação, a área de gerencia abre em uma nova janela fora da aplicação.

Categoria de Ação - Usuários
Propriedade	Ação Associada	Descrição	Default
Solicita confirmação ao usuário	Efetua logout	Define a exibição de uma mensagem de confirmação onde a ação será executada.	Não

Geral

Categoria de Ação - Geral
Ação	Descrição
Fecha aplicação	Define o fechamento de toda aplicação na ocorrência da ação. Essa ação fecha apenas o Viewer, mantendo o Kernel em execução.
Exibe caixa de mensagem	Define a abertura de uma caixa de mensagem na ocorrência de uma ação.
Executa script	Define a execução de um script na ocorrência de uma ação.

Categoria de Ação - Geral
Propriedade	Ação Associada	Descrição	Default
Solicita confirmação ao usuário	Fecha aplicação	Define a exibição de uma mensagem de confirmação onde a ação será executada.	Não
Tipo de caixa de mensagem	Exibe caixa de mensagem	Define se a caixa de mensagem será do tipo informação (exibe uma mensagem informativa como “Processo concluido”) ou do tipo seleção (exibe uma mensagem com botões onde se pode confirmar, negar ou repetir um processo)	Informação
Texto da mensagem	Exibe caixa de mensagem	Define o texto que será exibido quando a caixa de mensagem aparece.	(Nenhum)
Tipo de notificação	Exibe caixa de mensagem	Define se a caixa de texto será do tipo informativa , de aviso ou de erro .	Informação
Tipo de seleção	Exibe caixa de mensagem	Define quais os botões irão aparecer na caixa de seleção.	Ok ou Cancela
Seleção padrão	Exibe caixa de mensagem	Define qual dos botões da caixa será o padrão caso um processo finalize. (Botão que será acionado quando apertarmos a tecla Enter no teclado)	Botão Ok
Script	Executa script	Define o script que será executado quando uma ação for executada.	(Nenhum)
Aguarda término do script para executar as próximas ações	Executa script	Define se outras ações, em sequência da execução do script, podem ser executadas ou devem esperar o término da execução do script.	Sim

Data Source

Categoria de Ação - Data Source
Ação	Descrição
Filtra registros	Define a ação de filtrar e retornar os registros do DataSource segundo algum critério de comparação.
Retira filtro de registros	No caso de uma ação de filtragem para retorno de registros já realizada, define a ação de remover o filtro, retornando todos os registros.
Localiza registro	Define a ação de localizar um registro de acordo com um valor definido.
Ordena registros	Define a ação de ordenar registros de acordo com um tipo de ordenação.
Atualiza registros	Define a ação de atualizar os registros trazendo o último estado salvo do DataBase para o DataSource.
Insere registro	Define a ação de inserir um novo registro no DataSource.
Remove registro selecionado	Define a ação de remover um registro no DataSource.
Edita registro selecionado	Define a ação de editar um registro já existente no DataSource.
Salva edição de registro selecionado	Define a ação de salvar a edição feita em um registro no DataSource.
Cancela edição do registro selecionado	Define a ação de não salvar a edição feita em um registro no DataSource. Essa ação retorna o último estado do registro antes da edição.
Aplica alterações	Define a ação de aplicar as alterações feitas no DataSource para o Data Base.
Não aplica alterações	Define a ação de não aplicar as alterações feitas no DataSource para o DataBase. O último estado do DataBase é retornado para o DataSource.
Obtém valor do campo(field) selecionado	Define a ação de obter um valor de um campo do DataSource para que possa ser utilizado. Retorna um campo de um registro para um Tag.
Atribui valor no campo(field) selecionado	Define a ação de atribuir um valor em um campo do DataSource. Atribui um valor de um Tag para um campo de registro.

Categoria de Ação - Data Source
Propriedade	Ação Associada	Descrição	Default
Data Source	Todas as ações	Define o DataSource utilizado para realizar/aplicar as ações e eventos.	(Nenhum)
Campo do Data Source	Filtra registros Localiza registro Ordena registros Obtém valor do campo(field) selecioando Atribui valor no campo(field) selecionado	Define o campo do data source em que será aplicada as ações.	Sem DataSource definido
Tipo de filtro	Filtra registros	Define um comparador que será usado entre o valor do Tag e os registros do DataSource.	Igual
Nome Tag	Filtra registros Localiza registro Obtém valor do campo(field) selecioando Atribui valor no campo(field) selecionado	Define o tag responsável por fornecer/receber os dados que serão gerados ou utilizados em uma determinada ação.	(Nenhum)
Tipos de ordenação	Ordena registros	Define como os registros do DataSource serão ordenados pela ação, sendo em ordem Ascendente, Descendente ou em Ambos. (Ordenção em Ambos quer dizer que na ocorrência de um evento (click por exemplo), a ordem será ascendente, com outro clique, a ordem será descendente)	Ascendente
Aplica alterações	Atribui valor no campo(field) selecionado	Define, na atribuição de valor de um campo selecionado, se o valor do Tag será aplicado no DataSource diretamente.	Não

Ver também

• Telas Sinópticas

• Lista completa dos objetos de tela