É 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.
manage_searchTópicos Relacionados
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
.
- Caso defina:
A ação é sempre exibida na grelha.
- 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.
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.
--
Tipo: Campo para selecionar o tipo de ligação associado ao objeto.
Tem disponíveis as opções:
- Endereço web - opção utilizada em casos que pretenda que a ligação do objeto encaminhe o utilizador para uma página fora do PHC GO
- Morada - opção utilizada caso a ligação represente uma morada, e nesse caso a navegação irá abrir a localização da morada num visualizador de mapas.
- Registo - opção utilizada em situações que pretenda que a ligação do objeto encaminhe o utilizador para um registo dentro do PHC GO.
Título: Nome a atribuir à ligação do objeto.
Entidade de destino: Este campo apenas está disponível para edição se o tipo de navegação for
Registo, devendo ser preenchido com a entidade destino da ligação.
Campo da série: Este campo apenas está disponível para edição se o tipo de navegação for
Registo. Se a
Entidade de destino utiliza séries de documentos, este campo deve ser preenchido com o campo do ecrã que terá a informação da série.
Campo de ligação: Campo da
Entidade de destino responsável por identificar o registo que queremos encaminhar o utilizador. Geralmente é um stamp ou algum outro campo identificador único. Exemplo: referência do artigo