Bem-vindo ao tópico sobre valores definidos pelo usuário.

1
Após a conclusão deste tópico, você estará apto a adicionar valores definidos
pelo usuário a campos de formulário para automatizar a entrada de dados em
formulários e documentos. Você aprenderá a adicionar uma lista de valores como
valores definidos pelo usuário e utilizar uma consulta como valores definidos pelo
usuário também.

2
Aqui temos dois exemplos de requisitos que podem ser atendidos pela adição de
valores definidos pelo usuário aos campos de formulário:
• No primeiro exemplo, a empresa quer que a data de entrega (campo
obrigatório) seja calculada automaticamente em pedidos de venda, para que o
vendedor não precise inseri-la manualmente. No processo empresarial, a data
de entrega não é utilizada, porque os pedidos de venda são enviados
imediatamente para entrega.
• No segundo exemplo, o vendedor precisa poder visualizar instantaneamente o
saldo da conta de um cliente ao processar um novo pedido de venda por
telefone. Com valores definidos pelo usuário, o vendedor não precisa fazer drill
down manualmente até o cadastro.

3
Você pode adicionar UDVs a qualquer campo de cabeçalho editável em
documentos e formulários, a campos em nível de linha em documentos e
formulários, e a campos definidos pelo usuário adicionados a objetos (como
documentos e cadastro, por exemplo).
Os valores definidos pelo usuário podem auxiliar na entrada de dados
automatizando-a para os usuários.
Se adicionados no nível de linha, os valores definidos pelo usuário se aplicam a
todas as linhas.
Os valores definidos pelo usuário podem ser adicionados a um campo como:
•Lista de valores. O usuário escolhe os dados de uma lista de valores
predefinidos para o campo.
•Consulta do usuário. Quando a consulta é executada, os resultados dela são
armazenados no campo. No exemplo, uma consulta foi adicionada ao campo de
data de entrega. A consulta calculará uma data válida para a entrega. A utilização
de uma consulta é a opção mais flexível, já que essa pode ser configurada para
ser executada manual ou automaticamente.

4
O ícone de lupa indica que os valores definidos pelo usuário foram adicionados
ao campo.
Os usuários podem ativar e desativar a exibição desse ícone utilizando o menu
Visão > Exibição dos operadores de picking > Valores definidos pelo usuário.
No exemplo, podemos ver que os valores definidos pelo usuário foram
adicionados ao campo Data de entrega e a um campo definido pelo usuário no
cabeçalho do documento.

5
Para adicionar valores definidos pelo usuário a um campo, selecione o campo no
documento ou formulário e pressione a combinação de teclas Alt + Shift + F2, ou
selecione o caminho de menu Ferramentas > Ferramentas de configuração >
Valores definidos pelo usuário – configuração.
Apenas usuários autorizados podem adicionar UDVs. A autorização está
localizada na janela Autorizações gerais, que pode ser acessada por meio do
caminho Ferramentas de configuração > Valores definidos pelo usuário –
configuração.

6
Na janela de configuração para valores definidos pelo usuário, selecione uma das
três opções.
A primeira opção, Sem busca nos valores definidos pelo usuário, pode ser
utilizada para remover do campo os valores definidos pelo usuário que foram
adicionados anteriormente.
Não há restrições para remover de um campo valores definidos pelo usuário.
Depois que você remover os valores definidos pelo usuário, os documentos
gravados no sistema manterão os valores inseridos.

7
A segunda opção, Procurar nos valores existentes definidos pelo usuário, permite
que você defina uma lista de valores para o campo.
Ao definir os valores, verifique se o valor não excede o comprimento do campo
como definido no banco de dados.

8
Para selecionar dados da lista de valores, o usuário pode selecionar o indicador
de lupa ou pressionar Shift + F2 no campo.

A lista de valores pode ser mantida diretamente pelo usuário, e o usuário pode
adicionar novos valores à lista clicando em Novo. Observação: isso não ocorre
com uma lista de valores adicionada a um campo definido pelo usuário por meio
da janela Campos definidos pelo usuário – administração. Nesse caso, o usuário
não pode adicionar novos valores à lista, e a lista é mantida na janela Campos
definidos pelo usuário – administração.

9
A última opção, Procurar nos valores existentes definidos pelo usuário de acordo
com a consulta gravada, permite que você anexe uma consulta ao campo.
Essa opção é muito eficiente, já que o campo é preenchido com os resultados da
consulta.
A consulta pode definir um valor no campo, armazenar os resultados de um
cálculo no campo, ou buscar outro valor de campo no banco de dados para ser
inserido no campo.
A consulta pode solicitar a inserção de um parâmetro pelo usuário e utilizar esse
parâmetro para calcular os resultados.
No exemplo mostrado aqui, você pode utilizar uma consulta para calcular a data
de entrega com base na data atual. A consulta adiciona 7 dias à data atual e
armazena o resultado como a data de entrega.
Ao utilizar uma consulta, verifique se o resultado dela corresponde ao tipo de
campo no documento e não excede o tamanho do campo. Por exemplo, não
insira um resultado de cadeia alfanumérica em um campo definido como
numérico.

10
Em muitas situações, a consulta precisa referenciar um campo na janela ativa. No
exemplo mostrado, você adicionou os valores definidos pelo usuário a um campo
no pedido de venda. A consulta buscará o saldo da conta do cliente no registro de
cadastro e mostrará o saldo no campo de pedido de venda. O pedido de venda
está na janela ativa porque o usuário está trabalhando com ele.

A consulta faz a correspondência entre o CardCode presente na janela ativa e o

CardCode presente no cadastro.
Ao referenciar um campo na janela ativa, você deve sempre incluir um símbolo $
na frente do nome do campo para referenciar a janela ativa. Os campos que são
armazenados no banco de dados, como o campo de saldo no registro de
cadastro, não precisam do símbolo $.

11
Para testar uma consulta que referencia a janela ativa, mantenha o documento
como a janela ativa e execute a consulta selecionando Ferramentas > Consultas
> Consultas do usuário e escolhendo a categoria e o nome da consulta no menu.

12
Ao selecionar a opção de utilizar uma consulta como valores definidos pelo
usuário, você pode decidir se deseja que a consulta seja executada
automaticamente sem o envolvimento do usuário.
O campo de seleção Atualização automática ao modificar campo determina se a
consulta é executada automaticamente.
Se você não marcar esse campo de seleção, a consulta não será automática, ela
só será executada quando o usuário clicar na lupa ou pressionar Shift + F2 no
campo.

13
Se você marcar o campo de seleção Atualização automática ao modificar campo,
será solicitado a selecionar um campo dependente. A consulta é executada
automaticamente quando o valor do campo dependente é modificado ou o
usuário insere um valor no campo dependente.

14
Aqui temos um exemplo que mostra o funcionamento da função de atualização
automática.
Uma consulta é adicionada a um campo no pedido de venda por meio de valores
definidos pelo usuário. O Código do cliente/fornecedor é selecionado como
campo dependente. Quando o usuário seleciona o código do parceiro de
negócios em um pedido de venda, essa ação aciona a execução da consulta.
Geralmente, essa é a primeira ação quando um usuário processa um novo
documento de marketing. Portanto, é comum utilizar o Código do
cliente/fornecedor como um campo dependente para acionar a execução da
consulta.

15
Há duas regras para a seleção de campos dependentes.
Para uma consulta adicionada a um campo de cabeçalho em um documento,
você só pode selecionar outro campo de cabeçalho como campo dependente.
Isso inclui todos os campos do documento que não estão na tabela de linhas.

16
Para uma consulta adicionada a um campo em nível de linha, você pode
selecionar um campo de cabeçalho ou um campo em nível de linha como campo
dependente.
Para selecionar um campo de cabeçalho como o campo dependente, selecione
Quando o campo muda na lista de opções.
Para selecionar outro campo em nível de linha como o campo dependente,
selecione Ao sair da coluna modificada na lista de opções.

17
Note que, quando você adiciona valores definidos pelo usuário a um tipo
específico de documento de marketing, como um pedido de venda, outros tipos
de documento semelhantes, como entregas e notas fiscais, não são afetados. Em
outras palavras, os valores definidos pelo usuário se comportam de maneira
diferente dos campos definidos pelo usuário e não são herdados por outros tipos
de documento. Portanto, você precisa adicionar valores definidos pelo usuário a
cada tipo específico de documento, conforme necessário.
No entanto, o valor inserido em um campo com os valores definidos pelo usuário
é transferido para um documento de destino por meio da função Copiar
para/Copiar de.

18
Quando você seleciona Atualização automática ao modificar campo, outras duas
opções são exibidas. Essas opções determinam se a consulta é executada
apenas uma vez ou sempre que o campo dependente é modificado.
A opção padrão é Exibir valores definidos pelo usuário gravados. Ela é
recomendada porque mantém o resultado inicial da consulta. A consulta só é
executada uma vez quando o campo dependente é modificado. Ela não será
executada novamente mesmo se o campo dependente for modificado outra vez.
Um exemplo é uma consulta adicionada à Data de entrega em um documento. A
consulta calcula uma data de entrega com base na data do sistema. Você quer
que a consulta seja executada apenas uma vez. Se a consulta for executada
várias vezes, a data de entrega poderá ser atualizada de maneira incorreta.

19
Se você selecionar Atualizar regularmente, a consulta será executada toda vez
que o campo dependente for modificado ou selecionado em um documento.
Você deve utilizar essa opção com cautela porque ela pode resultar em
modificação inesperada do valor do campo.
A consulta será executada quando você navegar pelos registros ou fizer drill down
para abrir um documento que contém uma consulta. Quando a consulta for
executada, o status do documento será modificado para o modo Atualizar, e você
precisará gravar as modificações se quiser registrar os novos resultados da
consulta.
Um exemplo da utilização de Atualizar regularmente é uma consulta que mostra o
saldo atualizado da conta de um parceiro de negócios. Você quer que a consulta
seja executada sempre que você abre um documento ou navega nele para poder
visualizar sempre o saldo mais recente. No entanto, você ainda será solicitado a
atualizar o documento se quiser gravar os resultados da consulta.

20
Aqui temos alguns pontos importantes relacionados a valores definidos pelo usuário. Reserve
alguns minutos para revisá-los.
•Os valores definidos pelo usuário (UDVs) automatizam a entrada de dados para os usuários.
•Você pode adicionar UDVs a campos editáveis de linha e cabeçalho, além de a qualquer campo
definido pelo usuário. Para adicionar UDVs, selecione o campo e pressione Alt + Shift + F2.
•Um indicador de lupa mostra se há valores definidos pelo usuário para um campo. Você pode
ativá-lo no menu Visão > Exibição dos operadores de picking.
•Os valores definidos pelo usuário podem ser configurados como uma lista de valores ou, mais
comumente, uma consulta do usuário.
•Se uma lista de valores for utilizada, o usuário abrirá a lista selecionando o indicador de lupa ou
pressionando Shift + F2 no campo.
•Se uma consulta for utilizada, os resultados dela serão gravados no campo de destino. Para
configurar a consulta de modo que seja executada automaticamente sem envolvimento do usuário,
utilize a opção de atualização automática e selecione um campo dependente. Há outras duas
opções disponíveis para executar a consulta:
• Se você selecionar Atualizar regularmente, a consulta será executada toda vez que o
campo dependente for modificado ou selecionado, ou quando você navegar pelos
registros. Isso poderia levar a resultados inconsistentes, dependendo da consulta, ou
causar problemas de desempenho durante a navegação pelos registros.
• Se você selecionar Exibir valores definidos pelo usuário gravados, a consulta será
executada uma vez e manterá o resultado no campo. Essa opção é recomendada, já que
mantém o valor inicial do campo, mas sua seleção depende da necessidade comercial e
da consulta.
•As consultas devem ser escritas de modo a referenciar a janela ativa, onde necessário.

21
Você concluiu o tópico sobre valores definidos pelo usuário. Obrigado pela
participação.

22
23