Para cada monitor podemos ter um ou mais itens. Mas em cada item define-se os dados que aparecem na Coluna 1,2 e 3.

Cada Item de Monitor pode ser criado através do respetivo ecrã, ou opcionalmente por uma questão prática, diretamente num Monitor (previamente criado), com recurso ao botão , onde se podem visualizar os itens de monitor já associados a um Monitor e posteriormente, caso o utilizador queira criar um novo, basta clicar no botão .

À semelhança de outros ecrãs da aplicação, o utilizador pode aceder ao ecrã com intenção de introduzir/alterar um registo, ou simplesmente consultar


Ecrã em modo de Introdução

Uma vez em modo de introdução ou alteração, o utilizador dispõe de diversos campos que terá de preencher. No decorrer da elaboração ou modificação do registo, pode criar diversas Expressões, onde colocará código e poderá em tempo real, e/ou as próprias expressões. Nos campos em que se pode colocar código tem também 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 dispõe dos campos que em seguida se explicam, para configurar o item de Monitor:

Resumo
É o campo onde o utilizador deve definir a identificação do Item de Monitor. O mesmo é de preenchimento obrigatório.
Caso não haja definição de dados para a Coluna 1, do Monitor, será o texto que aparece numa das linhas da grelha da Coluna 1.

Monitor
Define o monitor a que este item está ligado.
Pode efetuar uma procura através do botão ou introduzir um ou mais carateres diretamente no campo, assim irá surgir uma lista com todos os resultados da procura iniciados pelo carater introduzido. Conforme é introduzido mais carateres esta procura vai sendo refinada.
Caso o utilizador introduza um item diretamente através do ecrã de um Monitor, este campo ficará automaticamente preenchido com a respetiva identificação do Monitor. Mas, se o utilizador necessitar de redirecionar o Item de Monitor poderá fazê-lo, efetuando também uma pesquisa.

Inativo
Aqui define-se se este item está ativo no respetivo Monitor.

Ordem
Permite indicar a ordem do Item de Monitor no respetivo Monitor.

Tipo de item
Este campo está disponível nas gamas Enterprise e Advanced para quem tem o módulo BPM Intranet. Permite indicar se é do tipo "Ações em aberto de workflow" ou "Normal".
Deve ser selecionado "Ações em aberto de workflow" quando se pretende configurar um monitor para apresentar as ações em aberto de workflows



A Coluna 1 pode ter uma linha com o resumo do item ou uma lista de registos relacionados com o item. Se desejar uma lista de registos pode no campo Expressão para a listagem da Coluna 1, colocar a expressão Transact-SQL ou definir como programa.
Poderá criar uma expressão de dados para aparecerem na Coluna 1, ao invés do resumo do item. A expressão deve obrigatoriamente conter os campos Resumo com o texto para aparecer na Coluna 1 e o campo Stamp com a chave única de cada linha, podendo esta ser a mesma do resumo, opcionalmente um campo numérico Soma com o total de registos.
Se for um programa deve retornar um objeto do tipo Datatable com aqueles campos.
Se o monitor tem caixa de procura então poderá usar aqui o texto #PROCURA# que conterá o que o utilizador escreveu.

Agrupa pela coluna de grupo
Pode agrupar a Coluna 1 apresentando o valor do agrupador de cada vez que o mesmo muda. Para isso, é necessário que a expressão de dados retorne uma coluna com o nome Grupo e que a mesma contenha o valor do agrupador de cada registo.



Para criar a Coluna 2 tem diversas opções a definir:

Cabeçalho
Aqui, o utilizador define o texto que aparece na Coluna 2 quando o item é selecionado na Coluna 1, ou seja, o texto em HTML puro a aparecer na Coluna 2, logo no início, antes dos dados. Poderá usar neste campo, a variável #STAMP# para apresentar o stamp da respetiva escolha da Coluna 1 e o texto #RESUMO# para o resumo do registo selecionado, quando utilizar Expressão para a Coluna 1. Se for um programa a variável MSTAMP está disponível no código com stamp da linha selecionada na Coluna 1. Para que possa personalizar o texto em HTML de forma pártica e fácil, foi criado um Editor de HTML que facilita a criação desse texto, possibilitando a utilização de conteúdos em HTML.

Este campo tem a particularidade de ter no código do ecrã a expressão: "ehtml" por isso, o objeto do Editor HTML fica, por defeito, ativo. Ou seja, sempre que o utilizador entrar neste ecrã o Editor HTML estará visível por defeito.

Expressão
A expressão para o cálculo dos resultados a apresentar. Expressão para calcular a lista de dados da Coluna 2. Tem obrigatoriamente que possuir um campo STAMP a ser usado para a apresentação da Coluna 3. Aqui poderá usar os valores de variáveis com o formato #1#, para por exemplo a variável com o número 1, e o texto #STAMP# para o stamp escolhido da Coluna 1 caso use expressão para a Coluna 1. Os títulos das colunas poderão ter um underscore para serem substituídos por espaço aquando da apresentação. Se for um programa deverá retornar um objeto do tipo DATATABLE para ser apresentado.

Agrupa pela primeira coluna da coluna 2
Pode agrupar e separar os resultados pela primeira coluna escolhendo esta opção, ou seja, agrupada pela primeira coluna da Coluna 2. Vai retirar a primeira coluna da respetiva grelha e colocar o respetivo grupo na segunda coluna. A lista deve vir ordenada por este campo de agrupamento.

Sem cores alternadas nas linhas
Pode ainda definir se quer a grelha de resultados com ou sem cores alternadas em cada linha.

Coluna 2 em letra de tamanho reduzido
Pode definir que a grelha tenha um tamanho de letra menor, para que no mesmo espaço apareça mais informação.

Coluna 2 com totais
Pode definir que as colunas numéricas têm no fim uma linha com o valor total.

Coluna 2 com número de registos
Vai reduzir o tamanho da letra do conteúdo da grelha na coluna 2.

Coluna 2 sem títulos
Pode configurar para os títulos das colunas não aparecerem.

Texto para quando não há dados
Neste campo é possível redigir um texto em HTML puro que aparece em mensagem quando não há dados para apresentar. Se não estiver preenchido aparecerá uma mensagem genérica de que não existem dados para apresentar.

Variáveis
As variáveis são opções que se podem dar ao utilizador de modo a filtrar o resultado da Coluna 2. Cada variável possui um número. Para usar essa variável na expressão para a Coluna 2, basta colocar o seu numero entre cardinais, por exemplo, para a variável número 3, basta colocar na expressão o texto "#3#".
As variáveis podem ser dos seguintes tipos:

C - carater.
M - memo, ou seja, carater com várias linhas.
N - numérica.
L - lógica, de sim ou não.
D - data.
I - número, mas inteiro.
T - tabela simples, onde no campo de dados pode introduzir, separadas por vírgulas, as opções que surgem.
S - tabela SQL, onde no campo de dados pode colocar a expressão Transact SQL que retorna apenas um campo, que será apresentado como a lista de opções.

Pode ainda definir a ordem pela qual as variáveis são apresentadas ao utilizador.
Por fim, definir se é uma variável para filtrar a Coluna 2 ou se é uma variável "interativa". Ou seja, para ser usada na atualização de dados disponível na área da interatividade do item.



A interatividade existe para os casos em que se pretende que o utilizador altere alguns dados em função do lhe é apresentado. Esta interatividade pode ainda pedir dados ao utilizador para serem usados na atualização.
Ao definir que existe interatividade irá ser apresentado, a seguir ao conteúdo da Coluna 3, as variáveis e o botão para executar.

Tem interatividade
Define se irá existir interatividade neste item.

Expressão interativa
Expressão em VB.NET que corre ao executar o botão de interatividade. Nesta expressão poderá usar o texto #STAMP# para obter o stamp do registo selecionado na Coluna 2, e/ou as variáveis interativas com um cardinal à volta, como por exemplo #1# para o valor da variável interativa 1.
Só estão disponíveis neste momento as variáveis que sejam definidas como interativas.

Título do botão
Neste campo o utilizador pode colocar o texto que pretender para o botão de interatividade.

Tooltip do botão
Neste campo coloca-se o texto de ajuda com a explicação que esclarece o utilizador quanto ao objetivo do botão de interatividade.

Classe de Css do botão
A classe de CSS a ser usada para o botão. Se deixar vazio irá usar a classe por defeito. Pode usar como alternativas as classes de botões de bootstrap, como por exemplo, btn btn-danger btn-xs. Pode ainda usar como outros formatos de botão as classes btn-primary, btn-warning ou btn-default. Se pretender alinhar o botão à direita dentro do espaço para botões, pode ainda adicionar a classe pull-right.

Se refresca tudo depois da interatividade
Se refresca/recalcula tudo depois da interatividade. Se não estiver ativo refresca apenas a Coluna 3.



A Coluna 3 tem como objetivo apresentar o detalhe do registo selecionado na Coluna 2. No entanto, se nada definir nesta coluna, na prática ela não existirá, ocupando a Coluna 2 o seu espaço.
Assim, para preencher a Coluna 3 tem as seguintes opções:

Expressão de dados da coluna 3
Nesta expressão poderá ir buscar os dados sobre o registo selecionado na Coluna 2, para serem apresentados, ou seja, é a expressão de dados para construir a apresentação da Coluna 3. Pode usar o texto #STAMP# para obter o stamp do registo selecionado na Coluna 2. Todos os campos/colunas aqui criadas poderão ser usadas no template da Coluna 3, englobados em cardinais. Por exemplo se fizer: select nome,esaldo from cl where cl.clstamp='#STAMP#' , no template poderá usar os campos #NOME# e #ESALDO# para apresentação. Se for um programa está disponível a variável MSTAMP com o stamp do registo selecionado na Coluna 2. O utilizador pode ainda, colocar variáveis globais com o texto #G1#, por exemplo para a variável com o número 1.

Template de apresentação de dados da coluna 3
No template define o visual com que são apresentados aqueles dados obtidos na expressão de dados da Coluna 3, ou seja, é o template em HTML puro do que será apresentado na Coluna 3, após o utilizador selecionar um registo na Coluna 2. Pode usar entre cardinais qualquer dos campos/colunas criados na expressão da Coluna 3, como por exemplo, #NOME# se tiver colocado o campo Nome no Select ou Datatable da expressão da Coluna 3. Se for um número é apresentado com as decimais definidas para a moeda. Pode colocar outras decimais com a seguinte notação: por exemplo para 1 decimal: #VALOR,1# para um campo chamado Valor. Pode usar o texto #STAMP# ou a variável MSTAMP se for código para obter o stamp da linha selecionada na Coluna 2. Se for um programa está disponível o objeto Mainformdataset com uma tabela e uma linha contendo o resultado da expressão para a Coluna 3.
Aqui pode usar o texto #ENCSTAMP# com o stamp encriptado. É útil se dentro do texto quiser criar um link para o form que possui aquele registo, por exemplo: ../neg/clform.aspx?stamp=#ENCSTAMP#.



Para cada item monitor é possível definir o acesso por módulos e/ou mediante o tipo de acesso.

Ecrã em modo de consulta

Em modo de consulta, com recurso ao botão o utilizador poderá efetuar uma simulação do Item de Monitor, pré-visualizando o resultado pretendido.
Ao aceder ao botão o utilizador poderá verificar se existe alguma opção de ecrã ligada ao Item de Monitor.
Tem também a possibilidade de usufruir das opções de registo bem como alterar o registo e/ou apagar o mesmo.

Framework Phc Cs Web