É no ecrã Painel ( menu
Menu >Toolbox > Paineis > Desenhar Painel) onde será feita a configuração do seu painel.
O widget manage_search Autocomplete consiste em disponibilizar um campo de tipo lista Dropdown com possibilidade de criação e edição de itens dessa lista. 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: Campo para definir o nome do widget.
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).
Comprimento: Campo utilizado para definir o número de carateres máximo a ser aceite pelo automplete. Se for preenchido com valor "0" (zero), assumirá o tamanho máximo permitido na base de dados.
Utiliza opções fixas: Ao ativar esta opção passa a ser possível indicar que o que alimenta o Autocomplete é uma lista de valores em vez de uma query, pelo que os campo runSearch, Campo para valor, Campo para descrição, Campo para desnormalização ficam desabilitados e passam a ser origatórios os campos Lista de valores e Lista de títulos.
Function runSearch: Campo onde é definido a query que será efetuada à base de dados para preencher o Autocomplete.
Exemplo de código para apresentar no Autocomplete todos os artigos: query.entityName = "ST"
Campo para valor: Campo da entidade definida no run Search que irá guardar no valor do campo Nome definido no separador Geral.
Exemplo: ref ==> relativo à entidade definida no QueryVO: ST (tabela de artigos e serviços).
Campo para descrição: Campo da Entidade definida no runSearch que irá guardar no valor do campo Campo para valor.
Exemplo: design ==> relativo à entidade definida no QueryVO: ST (tabela de artigos e serviços).
Campo para desnormalização: Campo da Entidade de Extensão que irá guardar o valor do campo Campo para descrição.
Lista de valores: Este campo só deve ser preenchido quando a opção Utiliza opções fixas está ativa e deve ter os valores que vão ser guardados no campo separados por vírgula. Exemplo: 1,2,3,4.
Lista de títulos: Este campo só deve ser preenchido quando a opção Utiliza opções fixa está ativa e deve ter os valores que vão aparecer visíveis ao utilizador no Autocomplete separados por vírgula. Exemplo: Um, Dois, Três, Quatro. Deve ter o mesmo número de valores que foram definidos no campo Lista de valores.
Obrigatório: Ao ativar esta opção, o preenchimento do objeto no painel será obrigatório. Caso o objeto não seja preenchido será inválidado pela aplicação, podendo impedir ou desencadear a realização de uma ação sobre outro objeto no painel (dependendo do código que estiver associado ao painel).
Readonly: Ao ativar esta opção, o valor do objeto passa a ser somente de leitura, ou seja, não poderá ser alterado pelo utilizador.
Inativo: Ao ativar esta opção, o objeto não será exibido ao utilizador.
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.
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