10 Impl 14 CustomTools UserDefinedFields BR

Ferramentas
de customização:
Campos definidos pelo usuário
SAP Business One
Versão 10.0
PÚBLICO
Objetivos
Objetivos:
 Adicionar campos do usuário aos objetos no banco de
dados do SAP Business One
 Definir campos com diferentes tipos e estrutura,
inclusive campos obrigatórios
 Definir regras de verificação, valores predefinidos e
listas de valores para a entrada de dados
© 2020 SAP SE ou uma empresa afiliada da SAP. Todos os direitos reservados. ǀ PÚBLICO 2
Cenário empresarial
 É preciso monitorar um nível de status para cada cliente – ouro, prata

e bronze.
 O vendedor precisa registrar as instruções de entrega preferencial do cliente
ao processar um pedido de venda.
Solução: Esses requisitos podem ser implementados com campos definidos

pelo usuário.
Pedido Nota fiscal Contas

Entrega a receber
de venda de saída
Adição de campos definidos pelo usuário
Ferramentas → Ferramentas de configuração → Campos definidos pelo usuário – administração
 É possível adicionar novos

campos à maioria dos
objetos de negócio,
inclusive a documentos de
marketing e dados mestre
 Necessária autorização
geral: Ferramentas de
personalização >
Campos definidos pelo
usuário – administração
Campos de cabeçalho e linha de documento de marketing
 É possível adicionar campos tanto

no cabeçalho (título) como nas
linhas de documentos de marketing
 O novo campo é adicionado a todos
os tipos de documento de logística
Cabeçalho
(título)
Linha
Campos definidos pelo usuário – Nível de cabeçalho
 Os UDFs adicionados no nível

de cabeçalho são exibidos em
uma janela separada
Objeto (exemplo: pedido de venda)
 Para abrir essa janela, use o
menu Visão e selecione
ou pressione Ctrl+Shift+U
Visão
 Os UDF adicionados ao  Campos definidos pelo usuário
cabeçalho são editáveis após o
documento ter sido adicionado Ctrl+Shift+U
Mover campos definidos pelo usuário – nível de cabeçalho
 Os usuários autorizados
podem usar a função
Ferramentas > Processar IU
do formulário para arrastar Objeto (exemplo: pedido de venda)
UDFs para a área de
formulário principal,
dispensando a janela lateral
 Autorização geral obrigatória –
Geral > Processar IU
do formulário
 Os usuários autorizados Ferramentas

podem fazer essa modificação Processar IU do formulário
para uso próprio ou para outros
usuários por meio de um
Modelo de configuração
da IU
Configurações para os campos definidos pelo usuário
 Se você decidir manter os

UDFs na janela lateral, você
pode gerenciá-los pela janela
de configurações
 A janela de configurações é
diferente da janela de
configurações de formulário
padrão. Para abrir a janela
de configurações:
 Ctrl+Shift+B
 Ferramentas →
Ferramentas de
configuração →
Configurações
Copiar valores de UDF de documentos de marketing
 Quando você gera um

documento de um
documento base usando Objeto (exemplo: pedido de venda)
Copiar para/copiar de,
o valor inserido em um
campo definido pelo usuário Objeto (exemplo: entrega)
é transferido para um
documento de destino
 Isso também se aplica ao
Assistente de criação
de documentos
 Se múltiplos documentos
base são copiados com O valor inserido em um campo
valores diferentes em um definido pelo usuário é
UDF, o valor não é copiado transferido para um documento
de destino utilizando Copiar
para/Copiar de
Campos definidos pelo usuário – Nível de linha
 Os UDFs adicionados ao nível de linha

estão visíveis e ativos por padrão
 Use as configurações de formulário
padrão para posicionar na linha
Editando campos definidos pelo
usuário no nível da linha
 Para permitir o processamento de UDF de
nível de linha, quando as linhas não são
editáveis, marque a caixa nas
Configurações do documento,
para cada documento
 Para cada usuário, defina se a atualização
de UDF de nível de linha é ou não possível
Propriedades e estrutura dos campos definidos
pelo usuário
Propriedades dos campos definidos pelo usuário
 Os UDFs são adicionados à tabela

do objeto e têm o prefixo “U_”
 Os UDFs são mantidos durante o
upgrade e podem ser copiados para
uma nova empresa
 O campo novo é adicionado a todas
as instâncias do documento,
inclusive a registros que já foram
gravados no banco de dados
 Os UDFs funcionam como campos
normais e podem ser utilizados em
consultas e relatórios
 É possível importar dados para
campos definidos pelo usuário
utilizando o Data
Transfer Workbench.
Propriedades dos campos definidos pelo usuário (continuação)
 Quando você adiciona um campo novo,

a estrutura do banco de dados
é atualizada
 Se outros usuários estiverem

conectados, você terá a opção de:
 Esperar os usuários efetuarem logoff
 Forçar o fechamento dos
documentos abertos dos
usuários conectados
Tipo e estrutura
 Você pode selecionar um Tipo e,

opcionalmente, uma Estrutura para
cada campo definido pelo usuário
 A estrutura depende do tipo e

influencia o formato do campo
Observação: você não pode modificar o

tipo e estrutura depois de ter adicionado o
campo ao banco de dados. Se você
escolher o tipo ou a estrutura errada,
remova o campo e comece novamente.
Tipo e estrutura
Tipo Estrutura Comprimento máximo
Alfanumérico  Normal 254

 Endereço
 Nº de telefone
 Texto 2 GB (cabeçalho)/255 KB (linha)
Numérico -
Data/Hora  Data
 Hora
Unidades e totais  Taxa
 Valor
 Preço
 Quantidade
 Porcentagens
 Medida
Geral  Link
 Imagem
Tipo e estrutura

 Endereço
 Nº de telefone
Numérico -
Data/Hora  Data
 Hora
 Valor
 Preço
 Quantidade
 Porcentagens
 Medida
Geral  Link
 Imagem
Tipo e estrutura

 Endereço
 Nº de telefone
Numérico -
Data/Hora  Data
 Hora
 Valor
 Preço
 Quantidade
 Porcentagens
 Medida
Geral  Link
 Imagem
Tipo e estrutura

 Endereço
 Nº de telefone
Numérico -
Data/Hora  Data
 Hora
 Valor
 Preço
 Quantidade
 Porcentagens
 Medida
Geral  Link
 Imagem
Tipo e estrutura

 Endereço
 Nº de telefone
Numérico -
Data/Hora  Data
 Hora
 Valor
 Preço
 Quantidade
 Porcentagens
 Medida
É preciso definir o caminho para a pasta
Geral  Link
 Imagem Anexos ou Imagens em Configurações
gerais (aba Caminho).
Opções de validação
 Opção para definir as regras de verificação

ao inserir dados no campo definido
pelo usuário:
Vinculado a entidades
Valores válidos
Avançada
Opção
Vinculado Vincula o campo definido pelo usuário em um
a entidades formulário a um objeto de sistema, uma tabela
definida pelo usuário ou um objeto definido
pelo usuário
Opção
Valores válidos Defina uma lista de possíveis
valores para um campo definido
pelo usuário
O usuário seleciona um valor da

lista predefinida
O usuário não pode atualizar ou

adicionar valores à lista
Opção
Avançada Defina regras de verificação
para os valores inseridos
no UDF
O usuário somente pode inserir
valores que atendam à regra
Campo definido pelo usuário com valores definidos pelo usuário
adicionados
Pedido de venda
mentas > Valores definidos pelo usuário
 Ao usar os valores definidos pelo usuário,

você pode vincular uma consulta a um
campo definido pelo usuário
 A consulta pode preencher o valor do
campo automaticamente com base no
resultado da consulta
 A consulta pode ser configurada
manualmente pelo usuário ou
automaticamente acionada
quando outro campo for
inserido, por exemplo,
o código do cliente
Exemplo:
SELECT T0.“Balance” FROM OCRD T0
WHERE T0.“CardCode” = $[$4.0.0]
Campos obrigatórios e padrão
 O valor padrão pode ser definido para

qualquer campo definido pelo usuário
 O valor padrão será exibido em todas as
instâncias novas do objeto
 Opção de configurar o campo definido pelo

usuário como obrigatório. Se o campo for
obrigatório, o usuário não poderá adicionar o
registro sem inserir o valor do campo
 Inicialmente, para definir um campo como
obrigatório, você precisa fornecer um valor
padrão, mas pode removê-lo depois de
adicionar o campo definido pelo usuário ao
banco de dados
Campos definidos pelo usuário: Principais pontos
Principais pontos deste tópico:

 Você pode adicionar campos definidos pelo usuário (UDFs) para a maioria dos objetos
 Os campos definidos pelo usuário são adicionados à tabela do objeto no banco de dados e têm o
prefixo “U_”.
 Os campos podem ser adicionados aos documentos de marketing no nível do cabeçalho (título) e de linha
 Os campos definidos pelo usuário no nível de cabeçalho são mostrados, inicialmente,
em uma janela lateral separada. Utilizar o menu Visão para abrir essa janela lateral.
 Você pode mover os campos da janela lateral para a área principal do documento, usando a função
Processar IU do formulário e atribuir aos usuários em um modelo de configuração de IU
 O valor inserido em um campo definido pelo usuário é transferido para um documento de destino utilizando
Copiar para/Copiar de
 Os UDFs podem ter vários tipos e estruturas. A escolha da estrutura afeta o tipo de dados que você pode
inserir no campo. Você pode adicionar uma lista de valores válidos para um UDF, vinculá-lo a um objeto de
sistema, definir as regras para a entrada de dados, configurar um valor padrão ou torná-lo obrigatório.

10 Impl 14 CustomTools UserDefinedFields BR

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

10 Impl 14 CustomTools UserDefinedFields BR

Enviado por

Direitos autorais:

Formatos disponíveis

Ferramentas

 É preciso monitorar um nível de status para cada cliente – ouro, prata

Solução: Esses requisitos podem ser implementados com campos definidos

Pedido Nota fiscal Contas

Ferramentas → Ferramentas de configuração → Campos definidos pelo usuário – administração

 É possível adicionar novos

 É possível adicionar campos tanto

 Os UDFs adicionados no nível

 Os usuários autorizados Ferramentas

 Se você decidir manter os

 Quando você gera um

 Os UDFs adicionados ao nível de linha

 Os UDFs são adicionados à tabela

 Quando você adiciona um campo novo,

 Se outros usuários estiverem

 Você pode selecionar um Tipo e,

 A estrutura depende do tipo e

Observação: você não pode modificar o

Tipo Estrutura Comprimento máximo

Alfanumérico  Normal 254

Tipo Estrutura Comprimento máximo

Alfanumérico  Normal 254

Tipo Estrutura Comprimento máximo

Alfanumérico  Normal 254

Tipo Estrutura Comprimento máximo

Alfanumérico  Normal 254

Tipo Estrutura Comprimento máximo

Alfanumérico  Normal 254

 Opção para definir as regras de verificação

O usuário seleciona um valor da

O usuário não pode atualizar ou

 Ao usar os valores definidos pelo usuário,

 O valor padrão pode ser definido para

 Opção de configurar o campo definido pelo

Principais pontos deste tópico:

Você também pode gostar