Documento de BO
Produto: | Datasul |
Ocorrência: | Documentação de BO |
Nome Físico | dibo/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 |