Manuais
PHC GO Painéis - Widget Tabela de consulta
 
É no ecrã Painel ( menu Menu >Toolbox > Painéis > Desenhar Painel) onde será feita a configuração do seu painel.

O widget table_rows Tabela de consulta consiste em disponibilizar uma grelha/tabela que permite consultar os dados de determinada entidade. Para começarmos a configurar o widget, apenas temos de clicar no botão more_vert e de seguida em edit Edite.

Para conhecer todas as funcionalidades inerentes a este Widget, iremos explicar os campos que compõem a área da Informação Principal e o tabulador dos Dados Gerais.


INFORMAÇÃO PRINCIPAL


Esta área do ecrã é composta pelos seguintes campos:

Nome interno: Identificação do objeto. Este será o nome utilizado para a criação do respetivo objeto no painel, pelo que não deverá conter carateres especiais, acentuação, nem espaços.

Label: Título do objeto a ser exibido no Painel.

Tooltip: Campo opcional, a ser preenchido com uma mensagem informativa ou complementar do âmbito do campo. É exibida quando o utilizador passa o ponteiro do rato sobre o respetivo campo.

DADOS GERAIS


O tabulador de Dados Gerais é composto por vários separadores, os quais iremos detalhar individualmente. Para obter mais informações sobre os campos de um separador, carregue em Mostrar/Ocultar referente ao separador específico (ou em alternativa, pode carregar em Abrir todos).
 


Tabela com seleção: Ao ativar esta opção a tabela de consulta permite ao utilizador selecionar os registos presentes na lista.

Seleção individual: Ao ativar determina que apenas é possível a seleção de 1 único registo de cada vez.

Utiliza query para dados: Caso este campo esteja ativo, a query definida no campo abaixo irá ser a fonte de dados da tabela. Caso contrário será necessário construir o datasource através do ecrã das Regras de Negócio.

Function runSearch: Objeto que define a query que é efetuada à base de dados para retornar os valores da tabela de consulta.

Campo identificador único dos registos: Campo da entidade definida no runSearch responsável por identificar cada registo da tabela de consulta. Geralmente é um stamp ou algum outro campo identificador único.

Colunas da tabela: Esta área do ecrã é onde se efetua a configuração da tabela de consulta.

Ao clicar em Adicione coluna preencha os campos respetivos na grelha, nomeadamente:
  • Nome: nome do campo que a query retorna. É sensível a maiúsculas e minúsculas.
  • Título: este campo destina-se ao preenchimento dos títulos das colunas da tabela de consulta.
  • Tooltip: campo de registo opcional, a ser preenchido com uma mensagem informativa, exibida quando o utilizador passa o ponteiro do rato sobre a coluna da tabela de consulta.
  • Tipo de dados: deve indicar o tipo de dados da coluna que a query retorna.


Esta seção é composta por um botão de Adicione ação que ao ser clicado exibe uma janela popup composta pelos seguintes campos:

Título: Nome a atribuir à ação.

É uma ação de linha: Quando este parâmetro se encontra ativo, a ação fica disponível no contexto da linha da grelha. Caso contrário, ficará disponível no cabeçalho da grelha.

function runAction: Código que será executado ao clicar na ação. Neste editor de código, deverá implementar código na linguagem
Typescript
e poderá utilizar as funções disponíveis na biblioteca SDK do Frontend.

Exemplo:
sdk.publishMessage("Custom message", AlertTypes.WARNING)

sticky_note_2Notas

Para mais informações relacionadas com funções da biblioteca SDK do Frontend, carregue aqui.

function isActionAvaiable: Permite mostrar a ação consoante uma determinada condição. Neste editor de código, deverá implementar código na linguagem
Typescript
 .

  1. Caso defina:
    return true;
    A ação é sempre exibida na grelha.

  2. Por outro lado, caso defina:
    return currentRecord.meucampologico;
    A ação apenas é apresentada nos registos da grelha que tenham o campo meucampologico igual a 1.
  3. sticky_note_2Notas

    Nos editores de código de linguagem  
    Typescript
     , poderá utilizar o comando console.log para debugar o código implementado.

    Uma vez que a linguagem  
    Typescript
     é derivada do Javascript , as funções do Javascript também poderão ser utilizadas pelo developer.



--