Pasta Opções

Procedimentos

Para preencher a pasta Opções:

1. Clique na pasta Opções para cadastrar as opções disponíveis para o campo;

Preencha os campos conforme descrição a seguir.

Lista Opções

Quando o campo for acessado no ambiente, será aberta uma lista de opções permitindo ao usuário selecionar uma delas, agilizando o trabalho de digitação.

Para utilizar este recurso:

a) Defina o parâmetro MV_BOX com S (opção Parâmetros menu Ambiente);

b) Efetue a inclusão do campo que deve ser tipo caracter;

c) No campo Lista de Opções, informe os itens que devem ser apresentados na caixa de opções (combo box), da seguinte forma:

<opção>=<descrição>;<opção>=<descrição>;...

Exemplo:

R = Representante; C = Consumidor ; L = Rural ; X = Exportador

O conteúdo do campo será o que estiver à esquerda do sinal de igual =.

Caso o conteúdo tenha mais que uma posição, deverá ser informado na lista de opções com todo o seu conteúdo.

Exemplo: IRF = Imposto de Renda;

ISS = Imposto sobre Serviço;

IPI = Imposto s/ Prod Industrial.

Para definir qual a opção preferencial, ou seja, em qual opção o cursor estará posicionado quando o campo for acessado, basta preencher o inicializador padrão do campo. No exemplo anterior, poderíamos definir que a opção preferencial será o IPI, colocando-se IPI no Inicializador Padrão deste campo.

15c38020-10c3-44fa-9f48-9335c01c7d39Dica:

Os sinais de igual (=) e ponto e vírgula (;)  são fundamentais para a funcionalidade da operação.
Se estiver em uso a função de \"Lista de Opções\", não será possível definir a \"Consulta Padrão via [F3]\". O usuário deve optar por utilizar apenas uma destas funções.
Lista Espanhol

Informe o mesmo conteúdo do campo Lista Opções em espanhol.

Lista Inglês

Informe o mesmo conteúdo do campo Lista Opções em inglês.

Inicializador Padrão

Informar o conteúdo inicial padrão para o campo. Este dado será sugerido na inclusão de um novo registro.

Exemplo:

DATE() + 30

Ddatabase + X (onde X = número)

Para definição do conteúdo inicial podem ser utilizadas fórmulas em linguagem AdvPL e Microsiga Protheus®, conforme abaixo:

ProxReg  Adiciona o número especificado ao conteúdo do campo chave do último registro do arquivo e o atribui ao campo chave do próximo registro.

Sintaxe: ProxReg(ExpN1,ExpN2)

ExpN1: Número de incremento.

ExpN2: Número de dígitos a serem apresentados.

Exemplo: ProxReg(1,10)

Formula   Utiliza a fórmula referenciada para iniciar o conteúdo do campo. A fórmula deve ser criada previamente no arquivo de fórmula.

Sintaxe: Formula(ExpC1)

ExpC1: Código da fórmula no arquivo.

Exemplo: Código da fórmula: 001

Função : Formula(001)

Inic. Browse

O campo X3_INIBRW irá suportar a apresentação de um campo virtual com qualquer conteúdo durante a função mBbrowse. Assim, este campo deverá possuir um comando (execblock, por exemplo), que devolve um campo ou expressão de qualquer outro lugar.

Exemplo:

Demonstrar a descrição da conta contábil no browse de lançamentos

A. Criar um campo virtual no SI2

B. Escrever uma função que lê o SI1(Plano de Contas) pelo campo da conta contábil do SI2

C. Devolver a descrição da Conta Contábil

Modo Edição

O campo X3_WHEN permite a edição de um campo apenas quando determinada condição for verdadeira. A regra poderá ser uma condição, função ou execblock. Note que o retorno obrigatoriamente deverá ser do tipo Lógico (True ou False).

Consulta Padrão [F3]

Neste campo deve ser informado o nome da consulta padrão ou número da tabela a ser chamada sempre que a tecla [F3] for acionada. Clique na  caixa de opções (combo box) para selecionar.

O Sistema suporta rotinas externas na função de acesso à arquivos via [F3]. Para tal, foi criada uma nova classe de registro no arquivo SXBnn0 que deverá possuir a seguinte característica:

No campo XB_COLUNA deverá ter RE ( Rotina Externa)
No XB_TIPO = 2 (rodapé da Consulta) colocar Execblock( ExpC1,ExpL1,ExpL2,ExpX1,ExpL3)
No XB_TIPO = 5 o próprio retorno da Consulta

Esta rotina não chamará a consulta e sim executará a rotina em questão no momento em que for teclado [F3].

Exemplo:

XB_ALIAS

XB_TIPO

XB_SEQ

XB_COLUNA

CB_DESCRI

XB_CONTEM

XXX

1

01

RE

Clientes

SA1

XXX

2

01

01

 

Execblock (!XXX\",.f.,.f.)

XXX

5

01

01

 

SA1->A1_COD