Julho

13/07/2022

Permitido inserir Aliases para um campo adicional

Foi disponibilizado na janela de configurações de campos adicionais, logo abaixo da propriedade “Nome da Variável”, a possibilidade de se manter uma lista de aliases (apelidos) para cada campo contido na configuração. Esses aliases podem ser utilizados para se referenciar esses campos na ferramenta de scripts, fazendo com que o campo possa ser chamado tanto pelo nome original da variável, como por qualquer um dos apelidos da mesma.

Essa necessidade surgiu para atender as demandas de alterações de nomes de variáveis originadas normalmente de processos de migração ou própria configuração equivocada na criação dos campos adicionais, onde o campo ficava com o nome diferente do esperado por extensões de prestação de contas ou relatórios padrões do sistema, por exemplo. Após essa entrega, o próprio técnico de implantação possui autonomia para estar solucionando essa divergência dos nomes, sem a necessidade de se registrar um ticket para ser atendido pelo setor de desenvolvimento.

É possível inserir quantos aliases quanto necessários para um campo clicando no botão +, e posteriormente removê-los clicando no botão de lixeira se necessário. Após a configuração dos aliases, basta salvar e publicar a configuração, e os mesmo já estarão disponíveis para uso.

Recomenda-se a utilização dessa funcionalidade em cenários onde o nome da variável do campo está diferente do nome esperado por relatórios/scripts flexibilizados, por exemplo: O processo de migração gerou na entidade um campo adicional com uma variável chamada “cod_tce”, mas uma determinada extensão de prestação de contas espera uma variável de nome “codigo_tce”, logo a execução não consegue retornar o valor do campo desejado. Para solucionar, pode-se adicionar o alias “codigo_tce” na variável “cod_tce”, para dessa forma a extensão conseguir realizar a leitura corretamente, evitando a necessidade de se customizar o artefato ou abrir um ticket solicitando o ajuste do nome da variável.

Ao acessar o explorador de fonte de dados das ferramentas de scripts e/ou relatórios, é possível visualizar que para os campos que possuem pelo menos um alias cadastrado, aparecerá um ícone de agenda permitindo exibir a listagem dos apelidos cadastrados para aquele campo. Qualquer um dos nomes da lista (assim como o nome original) podem ser utilizados para se referenciar o campo na ferramenta de extensões.

A imagem abaixo exemplifica a chamada de um campo adicional utilizando o alias configurado no cadastro de campos. Nota-se que mantém-se o funcionamento padrão da chamada, apenas utilizando o nome do alias sem se fazer necessário nenhuma outra alteração.

O alias utilizado na configuração deve ser obrigatoriamente único, ou seja, não é permitido utilizar o mesmo apelido para dois campos diferentes na mesma configuração, assim como não é permitido utilizar um alias que possua o mesmo nome da variável principal de outro campo.