Sistema básico de mensagens e notificações

Índice

Mensagens do sistema

MSGCORE.CAD_MENSAGENS_SISTEMAS

Descrição

Consulta e envio de mensagens para usuários do sistema.

Dicas:

Apresentar imagens na mensagem cujo arquivo está em outro local/servidor:

Pode-se apresentar imagens utilizando a tag img do HTML, conforme exemplo abaixo:
<img src="http://prd.eligo.com.br:8080/ADS2/file/2020/07/03/aa1c38ef-fe44-47d8-ab23-0204401f1dba/cad_pessoas.jpg" />



Utilizar tags Wiki:

Pode-se utilizar as tags do domínio Wiki nas mensagens para enriquecer a apresentação visual e funcional das mensagens. P.ex.: Usar a tag sys: para criar link para uma determinada interface:
[sys:pessoas.cad_pessoas;title]

Campos:

Título ou assunto da mensagem.
Pasta onde se encontra a mensagem.
  • Enviados
  • Caixa de entrada
  • Lixeira
  • Rascunho
Data e hora em que a mensagem foi enviada.
Indica o formato utilizado para editar a mensagem.
  • HTML - A mensagem é formatada em HTML.
  • Texto - A mensagem é editada como texto puro.
  • Wiki - A mensagem é editada com formatação Wiki.
Mensagem propriamente dita. O conteúdo da mensagem é formatado de acordo com formato definido para ela.
Apresenta a mensagem formatada da forma desejada (texto simples, Wiki ou HTML)
Diferentes tipos de mensagem são apresentados de diferentes formas no sistema.
  • Normal - Mensagens normais são apenas apresentadas para os usuários, sem nenhuma necessidade de interação.
  • Alerta - Mensagens de alerta são apresentadas de forma invasiva em um diálogo onde o usuário precisa interagir, fechando o diálogo, para continuar a usar o sistema. Este tipo de mensagem somente pode ser utilizada para assuntos realmente importantes.
  • Dica de uso - Mensagens de dica de uso são apresentadas em um canal específico para dicas de uso (diferente do canal utilizado para as mensagens normais e alertas). Geralmente, as dicas de uso são vinculadas a determinadas interfaces e são apresentadas logo que o usuário acessa a mesma pela primeira vez.
Código (único) de identificação da pessoa (física ou jurídica).
Nome completo da pessoa física ou razão social da pessoa jurídica. Razão social é o nome devidamente registrado sob o qual uma pessoa jurídica se individualiza e exerce suas atividades. A razão social diferencia-se do nome dado a um estabelecimento ou do nome comercial com que a empresa pode ser reconhecida junto ao público, o qual é conhecido como nome fantasia.
Determina que a mensagem será distribuída a servidores de um determinado sistema (build).
Lista de destinatários para onde a mensagem deve ser enviada.
Apresenta uma lista de todos os usuários que já leram a mensagem.
Apresenta uma lista de todos os usuários que ainda não leram a mensagem.
Data de início ou publicação da mensagem. Uma data futura permite a inclusão de uma mensagem que será distribuída com antecedência mas que estará disponível para leitura apenas a partir da data (e hora) informada neste campo.
Caso não informada, a mensagem estará disponível imediatamente.
Data de término da validade e apresentação da mensagem. Quando informada, a mensagem não será mais apresentada a partir deste data e hora.
Quando informado, indica que esta mensagem somente deve ser apresentada quando a versão do sistema for igual o superior à informada. Este atributo é utilizado apenas para mensagens emitidas pelas releases de atualização do sistema.
Quando informado, indica que esta mensagem deve ser apresentada apenas quando a versão atual do sistema for igual ou inferior à informada. Este atributo é útil para informar correções ou melhorias disponíveis no sistema.

Operações

Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos práticos e importantes para o usuário:
EnviadosNormal
Caixa de entradaAlerta
LixeiraDica de uso
RascunhoNormal
Comportamento:Topo

Pesquisar

Ao pesquisar, o usuário poderá informar critérios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usuário deverá executar a operação [b:Listar].
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Topo

Consultar

A consulta de um registro é realizada quando o usuário clica no primeiro link de um dos registros resultantes a operação [b:Listar]. A tela apresenta as informações detalhadas do registro, bem como as ações que o usuário pode disparar a partir dele (alterar, excluir, cancelar, etc.).
Comportamento:Topo

Novo

Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
Comportamento:Topo

Alterar

A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo.
O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Comportamento:Topo

Excluir

A exclusão está disponível apenas para o usuário que emitiu a mensagem. A exclusão da mensagem exclui a mesma em definitivo, inclusive para todos os destinatários.
Topo

Enviar

Envia a mensagem.
Topo

Marcar como não lida

Marca a mensagem como não lida.
Topo

Apagar

Apaga a mensagem apenas da lista de mensagens do usuário. Esta operação não exclui a mensagem propriamente dito, apenas marca para que ela não seja mais apresentada para o usuário. A mensagem continua visível na "Lixeira".
Topo

Pesquisa simples (SEARCH)

Campos utilizados para pesquisa genérica
Topo

Enviar

Salva e envia a mensagem.
Topo

Visualizar destinatários

Operação que libera apenas usuários específicos a visualizar quem recebeu/leu as mensagens de outros destinatários.
Por padrão, apenas o emitente tem acesso a esta informação.

Regras

Ajustar autocomplete dos destinatários

Ajusta o autocompletar dos destinatários de acordo com o que está informado no campo Build.
Eventos que disparam esta regra:
  • Antes de inciar um auto-complete formulário "Alterar"
  • Antes de inciar um auto-complete formulário "Novo"

Ajustar ações conforme o contexto

Apenas o emitente de uma mensagem pode literalmente excluí-la. Os demais usuários poderão apenas apaga-la.

Emitir uma mensagem somente é possível para mensagens que ainda estão pendentes.
Eventos que disparam esta regra:
  • Antes de apresentar uma tela formulário "Consultar"

Ajustar suporte a build

Caso o sistema tenha suporte a builds (Telescope), então tornar o campo "Build" editável.
Eventos que disparam esta regra:
  • Antes de apresentar uma tela formulário "Alterar"
  • Antes de apresentar uma tela formulário "Novo"

Apresentar leituras dos usuários

Monta os campos que apresentam os usuários que leram e que faltam ler a mensagem.
Eventos que disparam esta regra:
  • Antes de apresentar cada registro formulário "Consultar"
  • Antes de apresentar uma tela formulário "Listar"

Formatar mensagem

Formata a mensagem para a sua apresentação de acordo com o formato escolhido (texto puro, Wiki ou HTML).
Eventos que disparam esta regra:
  • Antes de apresentar cada registro formulário "Consultar"

Ler destinatários

Monta o campo contendo a lista de destinatários.
Eventos que disparam esta regra:
  • Antes de apresentar cada registro formulário "Alterar"
  • Antes de apresentar cada registro formulário "Consultar"
  • Antes de apresentar cada registro formulário "Listar"

Marcar como lida

Quando o usuário visualizar a mensagem pela primeira vez, ela é marcada como lida. Isso é realizado através do preenchimento da data e hora em que o usuário leu a mensagem.
Eventos que disparam esta regra:
  • Antes de apresentar uma tela formulário "Consultar"

Realçar mensagens não lidas

Quando as mensagens são listadas, as que não tiverem uma data de leitura informada, a linha da lista é marcada com a classe CSS "unread-message".
Eventos que disparam esta regra:
  • Antes de apresentar cada registro formulário "Listar"

Salvar destinatários

Interpreta o campo "Destinatários" e salva-os na entidade.
Ver Salvar destinatários
Eventos que disparam esta regra:
  • Depois de alterar formulário "Alterar"
  • Depois de inserir formulário "Novo"