DigitalLabs - AG - Módulo Campos Adicionais

Documentação técnicaMódulo Campos Adicionais Área de Gestão 1 de 9

Índice1) Configurador de atributos............................................................................................................ 3 1.1 Descrição............................................................................................................................ 4 1.2 Tipo..................................................................................................................................... 4 1.3 Conexão ............................................................................................................................. 5 1.4 SQL Valida ......................................................................................................................... 6 1.5 Valor default ....................................................................................................................... 7 1.6 Máscara .............................................................................................................................. 7 1.7 Obrigatório.......................................................................................................................... 7 1.8 Módulos .............................................................................................................................. 72) Configurador de grupos de atributos .......................................................................................... 83) Configurador de atributos por módulo ........................................................................................ 9 2 de 9

1) CONFIGURADOR DE ATRIBUTOSO módulo de configuração de atributos permite definir campos específicos que poderão estarpresentes nos módulos que pretendermos e desta forma podemos acrescentar informaçõesrelevantes para um determinado módulo de forma simples e dinâmica.É possível definir várias características dos atributos, o que permite controlar de forma mais eficaza introdução de valores nestes campos, nos respetivos módulos. 3 de 9

1.1 DescriçãoNome do campo que irá aparecer na lista de campos adicionais do módulo.1.2 TipoEsta característica permite identificar qual o tipo de dados a recolher:  Data: O formato apresentado no campo será uma data (dd/mm/aaaa).  Tempo: O formato apresentado no campo será uma hora (hh:mm).  Texto: O formato apresentado no campo será um texto.  Número: este tipo apenas permite introduzir valores com algarismos, caracteres não são admitidos. Adicionalmente pode ser configurada uma máscara que define o formato a aparecer do número, como por exemplo a introdução de casas decimais.  Lista: permite criar uma lista de valores para seleção. Este tipo de atributo precisa ter um código de SQL configurado no respetivo campo de acordo com a lista que se precisa obter para seleção. Exemplos: 4 de 9

 “Booleano”: Este tipo permite indicar valores do tipo verdadeiro ou falso.  Ficheiro: permite especificar a localização física de um determinado ficheiro. O símbolo com os binóculos permite selecionar a localização do ficheiro e o botão da lupa permite abrir o ficheiro que estiver especificado.  Separador: o tipo separador é utilizado para dividir ou agrupar campos na lista de campos adicionais. Os campos deste tipo não têm introdução de valores e surgem com o fundo azul.1.3 ConexãoQuando se pretende obter listas de seleção (definidas nos campos SQL) em que a fonte destesdados se localiza numa outra base de dados (como por exemplo a do LabWay-Lims) é possíveldefinir a conexão a essa base de dados neste campo. 5 de 9

Por outro lado, quando se pretende obter listas de seleção baseadas em registos da própria basede dados ou de outra base de dados que não a atual, é necessário definir cláusulas SQL maisavançadas. Este tipo de cláusulas deve ser solicitado à Ambidata, uma vez que a sua construçãoimplica o conhecimento da estrutura das Base de Dados.Um exemplo desta utilização é a possibilidade de selecionar, na base de dados atual, a lista detodos os departamentos.Outro exemplo seria selecionar uma lista de pontos de amostragem que se encontram na base dedados do LabWay-Lims.1.4 SQL ValidaÉ também possível criar regras para controlar a introdução de valores nos campos definidos. Porexemplo, se se pretende que num campo que recebe dados em percentagem não sejamintroduzidos valores fora da gama [0-100] %, é possível criar essa regra.A construção destas cláusulas inicia com a palavra If seguida da condição. Caso se verifique acondição, a mensagem de erro que deverá surgir é configurada através da cláusula Raiserror.Dois exemplos podem ser a comparação do valor num determinado intervalo ou a verificação daexistência de um valor num determinado conjunto de valores: 1. Verificação em intervalo: If [@Valor]<0 or [@Valor]>100 Raiserror(‘O valor só pode estar compreendido entre 0 e 100 %’,16,1) 2. Verificação num conjunto de valores If [@Valor]<>’A’ and [@Valor]<>’B’ and [@Valor]<>’C’ Raiserror(‘O valor só pode ser A,B ou C’,16,1) 6 de 9

1.5 Valor defaultNeste campo é possível definir o valor que se pretende que apareça por omissão quando surge ocampo adicional. Para os campos adicionais de tipo “Booleano”, este valor default deverá serpreenchido com “True” ou “False”.1.6 MáscaraÉ possível especificar o formato dos valores numéricos, definindo uma máscara para esse efeito.Para cada algarismo deverá ser indicado o valor n, para o separador dos milhares deverá serindicada uma virgula (,) e para o separador decimal deverá ser indicado um ponto(.).1.7 Obrigatório Este campo indica se o valor do campo adicional é de preenchimento obrigatório ou não.1.8 Módulos Nesta secção são definidos em que módulos se pretende que o campo adicional esteja disponível. Na coluna “Fixo” é ainda possível indicar se o campo adicional aparece sempre nos módulos definidos. 7 de 9

2) CONFIGURADOR DE GRUPOS DE ATRIBUTOSEste módulo permite agrupar atributos de forma a simplificar a inserção dos mesmos nos módulosem que estão configurados.O processo de configuração inicia-se por definir o nome do grupo e indicar o módulo em que seráutilizado. Depois, basta escolher os atributos a inserir nesse módulo.Ao clicar na combo de uma linha aparece uma lista com os atributos que foram previamenteconfigurados para o módulo indicado. Basta selecionar os atributos de interesse e gravar. 8 de 9

3) CONFIGURADOR DE ATRIBUTOS POR MÓDULOEste módulo permite ter uma visão mais detalhada sobre os atributos configurados por cada módulo.Além disso, possibilita definir de uma forma simples se o atributo é fixo e, caso aplicável, a ordempela qual os atributos serão apresentados.Para isso é necessário selecionar o tipo de módulo para carregar todos os atributos afetos aomesmo, clicar em ‘Alterar’ para realizar as configurações necessárias e, por fim, gravar asmodificações efetuadas. 9 de 9