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 definidospelo usuário a campos de formulário para automatizar a entrada de dados emformulários e documentos. Você aprenderá a adicionar uma lista de valores comovalores definidos pelo usuário e utilizar uma consulta como valores definidos pelousuário também.

2

Aqui temos dois exemplos de requisitos que podem ser atendidos pela adição devalores definidos pelo usuário aos campos de formulário:

• No primeiro exemplo, a empresa quer que a data de entrega (campoobrigatório) seja calculada automaticamente em pedidos de venda, para que ovendedor não precise inseri-la manualmente. No processo empresarial, a datade entrega não é utilizada, porque os pedidos de venda são enviadosimediatamente para entrega.

• No segundo exemplo, o vendedor precisa poder visualizar instantaneamente osaldo da conta de um cliente ao processar um novo pedido de venda portelefone. Com valores definidos pelo usuário, o vendedor não precisa fazer drilldown manualmente até o cadastro.

3

Você pode adicionar UDVs a qualquer campo de cabeçalho editável emdocumentos e formulários, a campos em nível de linha em documentos eformulários, e a campos definidos pelo usuário adicionados a objetos (comodocumentos e cadastro, por exemplo).Os valores definidos pelo usuário podem auxiliar na entrada de dadosautomatizando-a para os usuários.Se adicionados no nível de linha, os valores definidos pelo usuário se aplicam atodas 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 valorespredefinidos para o campo.•Consulta do usuário. Quando a consulta é executada, os resultados dela sãoarmazenados no campo. No exemplo, uma consulta foi adicionada ao campo dedata de entrega. A consulta calculará uma data válida para a entrega. A utilizaçãode uma consulta é a opção mais flexível, já que essa pode ser configurada paraser executada manual ou automaticamente.

4

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

5

Para adicionar valores definidos pelo usuário a um campo, selecione o campo nodocumento ou formulário e pressione a combinação de teclas Alt + Shift + F2, ouselecione 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 docaminho 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 dastrês opções.A primeira opção, Sem busca nos valores definidos pelo usuário, pode serutilizada para remover do campo os valores definidos pelo usuário que foramadicionados 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 documentosgravados no sistema manterão os valores inseridos.

7

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

8

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

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

9

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

10

Em muitas situações, a consulta precisa referenciar um campo na janela ativa. Noexemplo mostrado, você adicionou os valores definidos pelo usuário a um campono pedido de venda. A consulta buscará o saldo da conta do cliente no registro decadastro e mostrará o saldo no campo de pedido de venda. O pedido de vendaestá 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 oCardCode 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ãoarmazenados no banco de dados, como o campo de saldo no registro decadastro, não precisam do símbolo $.

11

Para testar uma consulta que referencia a janela ativa, mantenha o documentocomo 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 pelousuário, você pode decidir se deseja que a consulta seja executadaautomaticamente sem o envolvimento do usuário.O campo de seleção Atualização automática ao modificar campo determina se aconsulta é executada automaticamente.Se você não marcar esse campo de seleção, a consulta não será automática, elasó será executada quando o usuário clicar na lupa ou pressionar Shift + F2 nocampo.

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 é executadaautomaticamente quando o valor do campo dependente é modificado ou ousuário insere um valor no campo dependente.

14

Aqui temos um exemplo que mostra o funcionamento da função de atualizaçãoautomática.Uma consulta é adicionada a um campo no pedido de venda por meio de valoresdefinidos pelo usuário. O Código do cliente/fornecedor é selecionado comocampo dependente. Quando o usuário seleciona o código do parceiro denegó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 novodocumento de marketing. Portanto, é comum utilizar o Código docliente/fornecedor como um campo dependente para acionar a execução daconsulta.

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ê podeselecionar um campo de cabeçalho ou um campo em nível de linha como campodependente.Para selecionar um campo de cabeçalho como o campo dependente, selecioneQuando 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 tipoespecífico de documento de marketing, como um pedido de venda, outros tiposde documento semelhantes, como entregas e notas fiscais, não são afetados. Emoutras palavras, os valores definidos pelo usuário se comportam de maneiradiferente dos campos definidos pelo usuário e não são herdados por outros tiposde documento. Portanto, você precisa adicionar valores definidos pelo usuário acada 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 Copiarpara/Copiar de.

18

Quando você seleciona Atualização automática ao modificar campo, outras duasopções são exibidas. Essas opções determinam se a consulta é executadaapenas 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. Aconsulta calcula uma data de entrega com base na data do sistema. Você querque a consulta seja executada apenas uma vez. Se a consulta for executadavárias vezes, a data de entrega poderá ser atualizada de maneira incorreta.

19

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

20

Aqui temos alguns pontos importantes relacionados a valores definidos pelo usuário. Reservealguns 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 campodefinido 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ê podeativá-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, maiscomumente, uma consulta do usuário.•Se uma lista de valores for utilizada, o usuário abrirá a lista selecionando o indicador de lupa oupressionando Shift + F2 no campo.•Se uma consulta for utilizada, os resultados dela serão gravados no campo de destino. Paraconfigurar 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 duasopções disponíveis para executar a consulta:

• Se você selecionar Atualizar regularmente, a consulta será executada toda vez que ocampo dependente for modificado ou selecionado, ou quando você navegar pelosregistros. Isso poderia levar a resultados inconsistentes, dependendo da consulta, oucausar 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á quemantém o valor inicial do campo, mas sua seleção depende da necessidade comercial eda 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 pelaparticipação.

22

23