Árvore de páginas

Documento de BO

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físicodibo/bodi271.p

 

RecordSet

 

Tabela principal utilizada para comunicação dos métodos da BO com o mundo externo e suas respectivas definições.

Item Bonif Cliente

Atributo

Tipo

Formato

Descrição

Obr.

cdn-cliente

Inte    

>>>>>>>>9

Código do cliente

 

cod-item-venda      

Char 

x(16)

Código do item de venda

Sim

cod-refer-venda

Char    

x(8)

Código da referência do item de venda

Sim

cod-item-bonif

Char    

x(16)

Código do item de bonificação

Sim

cod-refer-bonif

Char   

x(8)

Código da referência do item de venda

Sim

dat-inic-validade

date    

99/99/9999

Data de início de validade

Sim

dat-fim-validade

Date

99/99/9999

Data de fim de validade

Sim

qtd-item-venda

Deci-4

>>>,>>>,>>9.999

Quando esta quantidade não for informada, significa que na tabela de desconto haverá um percentual que determina o montante de bonificação. Quantidade de venda do item

 

Sim

qtd-item-bonif

Deci-4

>>>,>>>,>>9.999

Quando esta quantidade não for informada, significa que na  tabela de desconto haverá um percentual que determina o montante de bonificação. Quantidade de bonificação do item

 

Sim

val-pct-proporcao-rateio

Deci-2 

>>9.99        

Percentual de rateio para determinação das quantidades de cada um dos itens na geração automática dos pedidos de bonificação. Percentual de rateio para determinação das quantidades

 

Sim

num-transacao      

Inte    

>>>,>>>,>>9   

Campo seqüencial para atender a Necessidade do Oracle de ter pelo menos um índice único Número da transação

 

char-1

Char  

x(100)

 

 

char-2

Char  

x(100)

 

 

log-1

Logical  

Sim/Não

 

 

log-2           

Logical

Sim/Não

 

 

dec-1

Decimal 

->>>>>>>>>>>9.9

 

 

dec-2

Decimal

->>>>>>>>>>>9.9

 

 

int-1

Integer

->>>>>>>>>9   

 

 

int-2

integer  

->>>>>>>>>9   

 

 

data-1               

Date  

99/99/9999    

 

 

data-2

date   

99/99/9999    

 

 

 

Métodos Básicos    

 

Métodos básicos de acesso ao banco de dados, que serão utilizados na base EMS 2.0.

 

 

Método:

findCh_codigo

 

Descrição:

Reposiciona o registro da tabela item-bonif-cliente através da código do cliente (i-cdn-cliente), código do item de venda (c-cod-item-venda) .

 

Requisitos:

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

i-cdn-cliente

Integer

 

X

 

 

Código Cliente

c-cod-item-venda

Char

 

X

 

 

Código Item Venda

c-cod-refer-venda

Char

 

X

 

 

Código Referência Venda

c-cod-item-bonif

Char

 

X

 

 

Código Item Bonificação

c-cod-refer-bonif

Char

 

X

 

 

Código Referência Bonificação

da-dat-inic-validade

Date

 

X

 

 

Data Início Validade

c-return

Char

 

 

X

 

Retorna Status

 

Queries e Constraints

 

Definição das Queries (acesso ao banco de dados) e Contraints (regras de leitura)  utilizadas para buscar grupos de registros da base de dados.              

 

 

Método:

OpenQuery2

 

Descrição: Busca um conjunto de registro  da tabela param-bonif a partir do p-cod-estabel passado como parâmetro.

 

Constraints Associados:

Setconstraint2

 

Método:

Setconstraint2

 

Descrição:

Recebe os parâmetros da tabela canal-cliente.


Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

p-inicial1

char

 

X

 

 

Código Cliente

p-inicial2

Char

 

X

 

 

Código Item Venda

p-inicial3

Char

 

X

 

 

Código Referência Venda

p-inicial4

Char

 

X

 

 

Código Item Bonificação

p-inicial5

Char

 

X

 

 

Código Referência Bonificação

p-inicial6

Char

 

X

 

 

Data Inicial Validade

p-inicial7

Char

 

X

 

 

Código do Emitente

 

 

Método:

OpenQuery3

 

Descrição:

Busca um conjunto de registros da tabela item-bonif-cliente a partir do p-cod-emit passado como parâmetro.

 

Constraints Associados:

Setconstraint3

 

 

Método:

Setconstraint3

 

Descrição: 

Recebe o parâmetro da tabela item-bonif-cliente.


Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

p-cod-emit

Char

 

X

 

 

Código Emitente

 

Método:

OpenQuery4

 

Descrição:

Busca um conjunto de registros da tabela item-bonif-cliente a partir do código do item de venda (cod-item-venda), código de referência de venda (cod-refer-venda),  código do item de bonificação (cod-item-bonif), código de referência de bonificação (cod-refer-bonif), data de início de validade (dat-inic-validade) e código do cliente (cdn-cliente), passados como parâmetros.

 

Métodos Negócio

 

Métodos adicionais de atualização e acesso a base de dados .

 

 

Método: 

ValidateFields

 

Descrição:

Método padrão que foi customizado para validar os campos que não fazem parte chave da tabela.

Validações:

  • Percentual de Rateio deve ser maior que zero e menor ou igual a 100 e o valor total

deste percentual de todas as ocorrências do mesmo cliente, item de venda, referência  de venda e data de início da validade devem totalizar 100%.


Requisitos:

Nenhum

 

 

Método: 

ValidateUpdate

 

Descrição:

Método padrão que foi customizado para validar os campos que não fazem parte chave da tabela.

Validações:

  • A data de fim de validade deve ser maior ou igual a de início de validade.


Requisitos:

Nenhum

 

 

Método: 

ValidarCamposChaveItemBonifCliente

 

Descrição

Procedure criada para validar os campos chave da tabela

Validações:

 

  • Cliente pode ser preenchido com "?" ou com um código que esteja cadastrado na tabela  e que não seja exclusivamente de um fornecedor (emitente.identif=2);
  • Cliente deve estar cadastrado na tabela;
  • Cliente não pode estar cadastrado como fornecedor;
  • Informações obrigatórias: código do item de venda, código do item de bonificação,

      datas de validade e percentual de rateio;

  • Item de Venda deve estar cadastrado na tabela;
  • A referência do item de venda somente pode ser preenchida se o mesmo for controlado

      por referencia (item.tipo-con-est = 4);

  • Referência de venda deve estar cadastrada na tabela;
  • Item de Bonificação deve estar cadastrado na tabela;
  • Itens Compostos e Configurados (item.politica = 5 ou 6) não podem ser relacionados

      como itens de bonificação;

  • Se a referencia do item de bonificação for preenchida, o relacionamento item x referencia deve estar cadastrado na tabela ref-item;
  • Referência de bonificação deve estar cadastrada na tabela;
  • A data de fim de validade deve ser maior ou igual a de início de validade;
  • Quantidade Venda não deve ser menor zero;
  • Quantidade Bonificação não deve ser menor zero;

 

Método: 

IncrementarSequenciaTransacao

 

Descrição:

Método implementado para incrementar a seqüência da transação.

Será chamado a cada nova inclusão de um registro. Estará enviando para a interface o parâmetro num-transacao, que contém a última seqüência mais um.


Requisitos: Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

Num-transacao

Integer

 

 

X

 

Número da Transação