Os "Eventos" servem para executar reações a determinadas situações que ocorrem na utilização da aplicação.

Na elaboração do evento, o utilizador poderá usufruir do Editor de Código sempre que encontre junto de um campo o botão .

De seguida vai ser explicado como dar uma mensagem ao utilizador que abre um pedido de assistência, no seguimento da apresentação dos campos existentes em modo de introdução.

Se o utilizador assim o desejar, poderá interagir com o registo do evento, quando  aceder ao ecrã em modo de consulta.

Ecrã "Eventos" em modo de introdução/alteração:

Para criar um evento o utilizador dispõe dos seguintes campos:

Resumo do evento - Serve para introduzir um pequeno resumo do evento e é de preenchimento obrigatório.

Número - Este número é sequencial e não controlado pelo utilizador. Poderá ser utilizado em posteriores consultas.

Inativo - Esta opção permite marcar o evento como inativo, indicando que deixa de ser executado.

Ecrã - Define qual o ecrã onde vai ser feito o evento.

Por exemplo: boform; encform; fminform; foform; ftform; ftview; login; opcoesdomenu; paform; regfpform, szadrsform.

Tabela - Define qual a tabela onde vai ser executado o evento. Este campo, apenas está disponível, se o campo "Ecrã" estiver preenchido com "configmon".

Caso pretenda, pode consultar um exemplo no tópico "Monitor de Configurações".

Reação ao evento - Neste campo, o utilizador pode escolher a reação que pretende efetuar quando o evento correr na aplicação:

• eMail
• Programa Interno
• Envio de SMS

Nome do evento - Extistem eventos gerais que são disponibilizados independentemento da indicação que o utilzador der no campo Ecrã. São eles:

- AoAlterar
- AoIntroduzir - Este evento corre no momento da introdução de um registo.
- AposAlterar
- AposApagar
- AposAssinatura
- AposCancelar - O evento corre depois do utilizador cancelar um registo.
- AposCriarGrelha - Corre logo a seguir a ser criada a grelha nas páginas que têm esse objecto.
- AposGravarDialogo
- AposIntroduzir - O evento corre depois do utilizador cancelar um registo.
- AposOnInit - Quando os objetos ainda não estão criados;
- AposOnLoad - Quando os objetos já estão no ecrã, por exemplo para torná-los invisíveis.
- AposPreRender - Este evento, disponível em todos os ecrãs de PHC CS Web, corre a seguir aos eventos AposOnInit e/ou AposOnLoad de forma a permitir configurar globalmente todos os objetos do ecrã.
- AposRefrescar
- AposUpload
- IntroduzirTabelasRelacionadas - Permite criar ecrãs de utilizador para qualquer tabela base com ligação a campos de tabelas secundárias.

Mas se no campo Ecrã o utilizador especificar um dos ecrãs que se indicam, poderá usufruir de eventos especificos, dedicados a esses ecrãs. Como por exemplo:

1. Ecrã "boform" (Dossiers Internos - intranet ou extranet) ou "encform" (Encomendas - extranet), terá também especificamente acesso ao(s) evento(s):

    BoAposActualizarRef

    BoAposAlterarValorEmLinha (apenas para utilizadores com gama Advanced ou Enterprise).

2. Ecrã "fminform" (Inscrição - intranet ou extranet), terá também especificamente acesso ao(s) evento(s):
    AposCancelarInscricao

3. Ecrã "foform" (Compras), terá também especificamente acesso ao(s) evento(s):
    FoAposAlterarValorEmLinha (apenas para utilizadores com gama Advanced ou Enterprise) 

4. Ecrã "ftform" (Documentos de faturação - intranet), terá também especificamente acesso ao(s) evento(s):
    FtAposActualizarRef
    FtAposAlterarValorEmLinha (apenas para utilizadores com gama Advanced ou Enterprise) 

5. Ecrã "ftview" (Documentos de Faturação - extranet), dedicado à extranet, terá também especificamente acesso ao(s) evento(s):
    AoPagarPaypal
    AoPagarUnicre
    AoSubscreverPaypal

6. Ecrã "Login" terá também especificamente acesso ao(s) evento(s):
    AposLogin

7. Ecrã opcoesdomenu, terá também especificamente acesso ao(s) evento(s):
    AposDefinirMenu

8. Ecrã "paform" (Pedidos de Assistência - Intranet ou extranet), passará também especificamente acesso ao(s) evento(s):
    AposAdicionarDialogo (intranet)
    AposClassificarPAT(extranet)
    AposFechar (intranet)
    AposReabrirPAT (extranet)

9. Ecrã "regfpform", terá também especificamente acesso ao(s) evento(s):
    AposMarcarFerias

Ordem do evento - No caso de existirem vários eventos para o mesmo ecrã, estes são executados mediante a ordem definida neste campo.

Separador "Condição do evento":

Condição:

Este campo é utilizado para colocar o programa que vai validar o evento - Tem de retornar um valor lógico (TRUE ou FALSE).

Este campo tem intellisense, ou seja, quando é colocada uma letra na caixa de texto é aberta uma caixa com todas as sugestões de código disponíveis para completar aquela palavra, à medida que se vai escrevendo as opções mostradas começadas pelas letras introduzidas vão reduzindo e aproximando do que se pretende.

Também se pode pressionar as teclas ctrl + espaço ou ctrl + seta baixo para aparecer essa mesma caixa mas com todas as opções de código disponíveis, sendo que ao escrever texto as opções na caixa vão sendo filtradas.

Podendo o utilizador, numa primeira abordagem à condição, compilar a expressão com recurso ao botão para validar a existência de eventuais erros.

Nota: Se este campo (condição) estiver vazio o evento corre sempre. 

Separador "Email":

Caso o utilizador opte por efetuar um programa em algum dos campos deste separador, terá que ter em atenção que o mesmo deverá ter a opção "é um programa" ativa e deve devolver um texto para ser interpretado como "string". Caso esta opção esteja ativa o campo tem intellisense, ou seja, quando é colocada uma letra na caixa de texto é aberta uma caixa com todas as sugestões de código disponíveis para completar aquela palavra, à medida que se vai escrevendo as opções mostradas são filtradas e vão reduzindo até se aproximando do que se pretende.

Após o desenvolvimento do código, o utilizador poderá recorrer ao botão  .   

Campos disponiveis no separador Email:

• Para Serve para colocar os endereços de e-mail dos destinatários. No caso de serem mais do que um, devem ser separados por ponto e vírgula.
• C/c Serve para colocar os endereços de e-mail. No caso de serem mais do que um, devem ser separados por ponto e vírgula.
• Assunto Local onde é colocado o assunto do e-mail.
• Conteúdo Define o texto do e-mail.
• É em formato HTML Permite ao utilizador indicar à aplicação se o texto introduzido no campo Conteúdo deve ser interpretado como código HTML. 

Separador "Se programa interno":

Expressão

É possível construir um programa em VB.NET. Este campo tem intellisense, ou seja, quando é colocada uma letra na caixa de texto é aberta uma caixa com todas as sugestões de código disponíveis para completar aquela palavra, à medida que se vai escrevendo as opções mostradas começadas pelas letras introduzidas vão reduzindo e aproximando do que se pretende. Também se pode pressionar as teclas ctrl + espaço ou ctrl + seta baixo para aparecer essa mesma caixa mas com todas as opções de código disponíveis, sendo que ao escrever texto as opções na caixa vão sendo filtradas. O utilizador tem disponíveis:

A variável MPAGE do tipo "page" - contém a página onde o evento está a correr;
A variável MSTAMP - string com o stamp do registo que está a fazer correr o evento;
E o objeto MAINFORMDATASET - contém todos os dados do registo e respetivas tabelas associadas do ecrã de onde está a correr o evento.
 

Separador "Envio de SMS":

Quando ativada a reação "Envio de SMS,no ecrã "Eventos, surge o separador "Envio SMS".
Esta reação permite aos utilizadores enviar mensagens SMS através de eventos de utilizador de forma simples e eficiente, garantindo integração com a API da InvisibleLink.

Campos disponívels no Separador "Envio de SMS":

• Descrição: Assunto da mensagem. Este campo é registado na tabela SMS, mas não utilizado no envio.

• Destinatário: Nome da pessoa ou do grupo de pessoas que irão receber a mensagem. Este campo é registado na tabela SMS, mas não utilizado no envio.

• Para: Número(s) de contacto para onde a mensagem será enviada, registado na tabela SMS e utilizado no envio.

• Texto: Conteúdo da mensagem a ser enviada. Este campo é registado na tabela SMS e utilizado no envio. Se pretender colocar emogis nas mensagens SMS deverá colocar na mensagem o código UTF-8 disponivel aqui  Emoticons and Emoji Chart.

• Força envio imediato: Se ativado, o SMS é enviado imediatamente, desde que o parâmetro "Envio fica em Stand By" esteja ativado.

Condições da Opção "Força Envio Imediato"

• Apenas visível caso o parâmetro "Envio fica em Stand By" esteja ativo.
• O parâmetro "Envio fica em Stand By" apenas está disponível no PHC CS Desktop.
• Se o "Envio fica em Stand By" estiver inativo, o envio ocorre imediatamente sem exibição desta opção.

Separador "Packages":

Um evento pode estar disponível nos diversos packages que o cliente tiver instalado, pode neste local definir onde aparecerá o evento criado. Poderá optar pelos seguintes packages:

• Portal
• Intranet
• PocketServices
• Extranet
• Frontwebservice
• Internet

Por exemplo, se o utilizador quiser que o evento da aplicação ocorra com o módulo PHC CS Suporte extranet web, deve configurar este campo da seguinte forma:

Nota: Poderá consultar exemplos de eventos no Tópico de Manual "Exemplos de Eventos"

Ecrã "Eventos" em modo de consulta:

Ao consultar o registo do evento, o utilizador poderá usufruir das opções de registo, procurar um registo, alterar e/ ou apagar um registo e ao aceder a 

 poderá  aceder diretamente ao ecrã de "Log de Código de Utilizador" .