Uma das funcionalidades do PHC GO é a possibilidade de podermos criar parâmetros de utilizador, para que possam depois ser usados nos mais variados desenvolvimentos.

Com este artigo, apresentamos um exemplo de como poderemos criar um parâmetro de utilizador do tipo autocomplete e ler o seu valor, tanto no Front-End como no Back-End.

Inicialmente, é necessário criar um parâmetro de utilizador ( Menu > GO Studio > Toolbox ), de seguida, selecionar a peça Parâmetros e introduzir um novo. Para o parâmetro do tipo autocomplete, tem disponível os seguinte campos:

• Nome: Campo obrigatório que representa a identicação única do parâmetro.

• Título: Campo obrigatório que irá representar o título do campo.

• Descrição: Campo para incluir uma descrição geral do parâmetro.

• Tipo: Campo obrigatório que identifica o tipo do parâmetro. Neste caso tipo será autocomplete.

  sticky_note_2Notas

  
  

  Se instalou um add-on com um Parâmetro de um determinado Tipo, caso altere posteriormente o Tipo desse Parâmetro, saiba que essa ação poderá ter impacto no add-on, pois a aplicação vai tentar converter o valor do parâmetro para o novo tipo. Caso não consiga, vai tentar aplicar o valor por defeito (caso exista) definido para o parâmetro. Proceda com precaução!
  
  Casos particulares da conversão

  • Conversão para Lista: será aplicado o valor por defeito sem tentativa de conversão.
  • Conversão para Número: Se a conversão falhar, o parâmetro assume o valor "0". Caso o valor "0" esteja fora do intervalo permitido, o parâmetro assume o valor mínimo definido.
  • Conversão para Password: O valor é encriptado.
  • Conversão de Password para outro tipo: O valor é convertido sem encriptação.

• Ordem: Campo para definir a ordem de visualização dentro do grupo do respetivo add-on.

• Subgrupo: Campo obrigatório que irá representar o subgrupo no qual o parâmetro de utilizador será mostrado na lista de parâmetros.

• Tooltip: Texto que irá surgir como explicação visual no campo criado.

• Obrigatório: Ao ativar este campo, o campo Valor por omissão passa a ser obrigatório.

• Valor por omissão: Data inicial quando o parâmetro é criado pela primeira vez na instalação final de cliente.

Sobre o Objeto de pesquisa, defina a seguinte query que permite listar todos os vendedores nos parâmetros:

query.entityName = "CM3"

Depois de definir o objeto de pesquisa, preencha os seguintes campos com:

• Campo para descrição: nome

• Campo par valor: cm

Após a criação do parâmetro, deve adicionar o respetivo registo ao add-on. Pode fazê-lo através da ação Adicione ao add-on do próprio registo, clicando no icone > Parâmetros de Utiliador > Adicione ao add-on.

Por outro lado, caso pretenda adicionar o parâmetro através do add-on, também é possível. Em modo de edição e sobre a área Peças, tem disponível o agrupador Parâmetros que ao ser expandido, exibe todos os parâmetros existentes.

Depois de efetuar a instalação do add-on, se acedermos aos parâmetros da aplicação, passará a ser apresentado o novo parâmetro que criou.

Como ler este valor no back-end?

Para lermos o valor do parâmetro, teremos de usar uma regra de negócio, com a seguinte configuração, por exemplo:

• Entidade: Clientes

• Título: Apresenta o vendedor que definimos nos parâmetros

• Tipo de código: Ao Sincronizar

• Expressão:

  MasterVO.vendedor = SDK.Parameters.getParameter("u4902_paraAutocomplete")

O valor que é passado como parâmetro na função getParameter, é o valor que se encontra entre parêntesis em frente ao novo parâmetro criado, neste caso (u4902_paraAutocomplete).

Como ler este valor no front-end?

Tal como acontece no back-end, onde existe a função getParameter, em front-end existe a função readParameter.

Por exemplo num evento de ecrã da entidade Clientes, bastará usar o seguinte comando:

sdk.setReadonly(FIELDS.CL_VENDEDOR, sdk.readParameter("u4902_paraAutocomplete"))

Ao introduzir um cliente, irá ser preenchido automaticamente o Vendedor com o nome do vendedor que está preenchido no parâmetro geral e com o seu estado a readonly.