Árvore de páginas

Documento de BO

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físicodibo/bodi605.p

 

Considerações Gerais

 

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela histor-pdven (Histórico Pedido de Venda).

 

Funcionamento

Na forma padrão, realiza-se a chamada através de um comando RUN normal, passando-se as temp-tables carregadas com as informações necessárias.

A execução na forma persistente é realizada através da chamada de um comando RUN conforme exemplo a seguir.

A sintaxe para executar a BO em modo persistente é:

 

RUN dibo/bodi605.p PERSISTENT SET h-bodi605.

 

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da BO.

 

Tabelas Temporárias

 

Nos atributos das tabelas temporárias de entrada e saída:

 

tt-histor-pdven

Entrada/Saída

Histórico Pedido de Venda

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

nom-abrevi-clien

character

x(12)

Nome Abreviado

Sim

 

cod-ped-clien

character 

x(12)

Pedido Cliente

Sim

 

cdn-grp-clien  

date

99/99/9999

Histórico

Sim

 

hra-histor

character

99:99:99

Hra Histórico

Sim

 

cod-classif

character

x(08)

Classificação

Sim

 

cdn-tip-histor

Integer

>>>,>>9

Tipo Histórico

Sim

 

des-histor

character

x(2000)

Histórico

Não

 

cod-usuar

character

x(12)

Código Usuário

Não

 

des-compl

character

x(40)

Complemento

Sim

 

cod-livre-1

character

x(100)

Código Livre 1   

Não

 

cod-livre-2

character

x(500)

Código Livre 2   

Não

 

dat-livre-1

date

99/99/9999

Data Livre 1   

Não

 

dat-livre-2

date

99/99/9999

Data Livre 2   

Não

 

log-livre-1

logical

Sim/Não

Lógico Livre 1    

Não

 

log-livre-2

logical

Sim/Não

Lógico Livre 2   

Não

 

num-livre-1

integer

>>>>>>>>9

Número Livre 1   

Não

 

num-livre-2

integer

>>>>>>>>9

Número Livre 2   

Não

 

val-livre-1

decimal

->>>>>>>>>>>9.99999999

Valor Livre 1   

Não

 

val-livre-2

decimal

->>>>>>>>>>>9.99999999

Valor Livre 2   

Não

 

r-Rowid

Rowid

 

 

Não

 

Método Básico

 

getCharField

Requisito

Nenhum

Sintaxe

RUN getCharField IN handle (INPUT <character>,

                                                OUTPUT <character>).

Descrição

Retorna valor dos campos do tipo caracter

Parâmetros

Descrição

pFieldName

Nome do campo caracter que será retornado o valor

 

pFieldValue

Valor contido no campo solicitado

Retorno

A BO irá retornar o valor contido no campo caracter que foi solicitado a BO.

getDateField

Requisito

Nenhum

Sintaxe

RUN getDateField IN handle (INPUT <character>,

                                                OUTPUT <date>).

Descrição

Retorna valor dos campos do tipo data

Parâmetros

Descrição

pFieldName

Nome do campo data que será retornado o valor

 

pFieldValue

Valor contido no campo solicitado

Retorno

A BO irá retornar o valor contido no campo data que foi solicitado a BO.

getDecField

Requisito

Nenhum

Sintaxe

RUN getDecField IN handle (INPUT <character>,

                                              OUTPUT <decimal>).

Descrição

Retorna valor dos campos do tipo decimal

Parâmetros

Descrição

pFieldName

Nome do campo decimal que será retornado o valor

 

pFieldValue

Valor contido no campo solicitado

Retorno

A BO irá retornar o valor contido no campo decimal que foi solicitado a BO.

getIntField

Requisito

Nenhum

Sintaxe

RUN getIntField IN handle (INPUT <character>,

                                            OUTPUT <integer>).

Descrição

Retorna valor dos campos do tipo inteiro

Parâmetros

Descrição

pFieldName

Nome do campo inteiro que será retornado o valor

 

pFieldValue

Valor contido no campo solicitado

Retorno

A BO irá retornar o valor contido no campo inteiro que foi solicitado a BO.

getLogField

Requisito

Nenhum

Sintaxe

RUN getLogField IN handle (INPUT <character>,

                                              OUTPUT <logical>).

Descrição

Retorna valor dos campos do tipo logico

Parâmetros

Descrição

pFieldName

Nome do campo logico que será retornado o valor

 

pFieldValue

Valor contido no campo solicitado

Retorno

A BO irá retornar o valor contido no campo logico que foi solicitado a BO.

getRawField

Requisito

Nenhum

Sintaxe

RUN getRawField IN handle (INPUT <character>,

                                                OUTPUT <raw>).

Descrição

Retorna valor dos campos do tipo raw

Parâmetros

Descrição

 

pFieldName

Nome do campo raw que será retornado o valor

 

pFieldValue

Valor contido no campo solicitado

Retorno

A BO irá retornar o valor contido no campo raw que foi solicitado a BO.

getRecidField

Requisito

Nenhum

Sintaxe

RUN getRecidField IN handle (INPUT <character>,

                                                 OUTPUT <recid>).

Descrição

Retorna valor dos campos do tipo recid

Parâmetros

Descrição

 

pFieldName

Nome do campo recid que será retornado o valor

 

pFieldValue

Valor contido no campo solicitado

Retorno

A BO irá retornar o valor contido no campo recid que foi solicitado a BO.

getKey

Requisito

Nenhum

Sintaxe

RUN getKey IN handle (OUTPUT <character>,

                                       OUTPUT <character>,

                                       OUTPUT <date>,

                                       OUTPUT <character>).

Descrição

Retorna a chave do registro posicionado

Parâmetros

Descrição

 

pnom-abrevi-clien

Indica o nome abreviado do cliente do pedido de venda

 

pcod-ped-clien

Indica o número do pedido do cliente do pedido venda

 

pdat-histor

Indica a data do histórico

 

phra-histor

Indica a hora do histórico

Retorno

A BO irá retornar o valor contido no campo modelo que foi solicitado a BO.

goToKey

Requisito

Nenhum

Sintaxe

RUN goToKey IN h-handle (INPUT <character>,

                                             INPUT <character>,

                                             INPUT <date>,

                                             INPUT <character>).

Descrição

Reposiciona registro com base na chave informada

Parâmetros

Descrição

 

pnom-abrevi-clien

Indica o nome abreviado do cliente do pedido de venda

 

pcod-ped-clien

Indica o número do pedido do cliente do pedido venda

 

pdat-histor

Indica a data do histórico

 

phra-histor

Indica a hora do histórico

Retorno

A BO irá reposicionar no registro que foi solicitado a BO.

validateRecord

Requisito

Nenhum

Sintaxe

RUN validateRecord IN h-handle (INPUT <character>).

Descrição

Efetua as validações do registro antes de ser gravado na tabela de campos do portal

Parâmetros

Descrição

 

pType

Indica o o tipo de gravação do registro (Create, Delete e Update).

Retorno

“OK” – Registro gravado corretamente

“NOK” – Registro inválido, Verificar a lista de erros na temp-table RowErrors

 

Método Negócio

 

verifyPreApprooved

Requisito

Nenhum

Sintaxe

RUN verifyPreApprooved IN h-handle (INPUT <character>,

                                                              INPUT <character>,

                                                              INPUT <integer>,

                                                              INPUT <decimal> ).

Descrição

Verifica se no histórico do pedido especificado houve um histórico de aprovação com percentual pré-aprovado maior ou igual ao informado.

Parâmetros

Descrição

nomeAbrev

Indica o nome abreviado do cliente do pedido de venda

 

nrPedCli

Indica o número do pedido do cliente do pedido de venda

 

processInstanceId

Indica qual o número do processo do workflow de aprovação de pedido por alçada de desconto que está sendo verificado a aprovação

 

valPctDescontoTotal

Indica o percentual de desconto do pedido solicitado pelo cliente.

Retorno

Retorna a próxima sequencia da tabela.

logCreateOrder

Requisito

Nenhum

Sintaxe

RUN logCreateOrder IN h-handle (INPUT <character>,

                                                        INPUT <character> ).

Descrição

Gera histórico de pedido para o evento de cadastro

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

Retorno

Nenhum

logUpdateOrder

Requisito

Nenhum

Sintaxe

RUN logUpdateOrder IN h-handle (INPUT <character>,

                                                        INPUT <character>,

                                                        INPUT <handle>,

                                                        INPUT <handle>,

                                                        INPUT <character>).

Descrição

Gera histórico de pedido para o evento de alteração.

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

hNewBuffer

Identifica o handle do buffer alterado no pedido

 

hOldBuffer

Identifica o handle do buffer original do pedido

 

cChanges

Lista de campos alterados no registro

Retorno

Nenhum

logCancelOrder

Requisito

Nenhum

Sintaxe

RUN logCancelOrder IN h-handle (INPUT <character>,

                                                        INPUT <character>,

                                                        INPUT <integer>,

                                                        INPUT <character>).

Descrição

Gera histórico de pedido para o evento de cancelamento

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

iReason

Código do motivo de cancelamento

 

cReason

Descrição do motivo de cancelamento

Retorno

Nenhum

logSuspendOrder

Requisito

Nenhum

Sintaxe

RUN logSuspendOrder IN h-handle (INPUT <character>,

                                                          INPUT <character>,

                                                          INPUT <character>).

Descrição

Gera histórico de pedido para o evento de suspensão

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cReason

Descrição do motivo de suspensão

Retorno

Nenhum

logReactivateOrder

Requisito

Nenhum

Sintaxe

RUN logReactivateOrder IN h-handle (INPUT <character>,

                                                             INPUT <character>,

                                                             INPUT <character> ).

Descrição

Gera histórico de pedido para o evento de reativação

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cReason

Descrição do motivo de reativação

Retorno

Nenhum

logCommitOrder

Requisito

Nenhum

Sintaxe

RUN logCommitOrder IN h-handle (INPUT <character>,

                                                         INPUT <character> ).

Descrição

Gera histórico de pedido para o evento de efetivação

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

Retorno

Nenhum

logUpdateOrderItem

Requisito

Nenhum

Sintaxe

RUN logUpdateOrderItem IN h-handle (INPUT <character>,

                                                               INPUT <character>,

                                                               INPUT <handle>,

                                                               INPUT <handle>,

                                                               INPUT <character>).

Descrição

Gera histórico de pedido para o evento de atualização do item

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

hNewBuffer

Identifica o handle do buffer alterado do item do pedido

 

hOldBuffer

Identifica o handle do buffer original do item do pedido

 

cChanges

Lista de campos alterados no registro

Retorno

Nenhum

logAddOrderItem

Requisito

Nenhum

Sintaxe

RUN logAddOrderItem IN h-handle (INPUT <character>,

                                                          INPUT <character>,

                                                          INPUT <character>,

                                                          INPUT <integer> ).

Descrição

Gera histórico de pedido para o evento de inclusão do item

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cItCodigo

Código do novo item do pedido

 

iNrSequencia

Sequencia do novo item do pedido

Retorno

Nenhum

logRemoveOrderItem

Requisito

Nenhum

Sintaxe

RUN logRemoveOrderItem IN h-handle (INPUT <character>,

                                                                 INPUT <character>,

                                                                 INPUT <character>,

                                                                 INPUT <integer> ).

Descrição

Gera histórico de pedido para o evento de exclusão de item

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cItCodigo

Código do item do pedido

 

iNrSequencia

Sequencia do item do pedido

Retorno

Nenhum

logCancelOrderItem

Requisito

Nenhum

Sintaxe

RUN logCancelOrderItem IN h-handle (INPUT <character>,

                                                               INPUT <character>,

                                                               INPUT <character>,

                                                               INPUT <integer>,

                                                               INPUT <integer>,

                                                               INPUT <character>  ).

Descrição

Gera histórico de pedido para o evento de cancelamento do item

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cItCodigo

Código do item do pedido

 

iNrSequencia

Sequencia do item do pedido

 

iReason

Código do motivo do cancelamento

 

cReason

Descrição do motivo do cancelamento

Retorno

Nenhum

logAllocateOrderItem

Requisito

Nenhum

Sintaxe

RUN logAllocateOrderItem IN h-handle (INPUT <character>,

                                                                INPUT <character>,

                                                                INPUT <character>,

                                                                INPUT <integer>,

                                                                INPUT <decimal>,

                                                                INPUT <character>  ).

Descrição

Gera histórico de pedido para o evento de alocação do item

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cItCodigo

Código do item do pedido

 

iNrSequencia

Sequencia do item do pedido

 

qtde

Quantidade alocada do item

 

cNrEmbarque

Número do embarque onde o item foi alocado

Retorno

Nenhum

logUnAllocateOrderItem

Requisito

Nenhum

Sintaxe

RUN logUnAllocateOrderItem IN h-handle (INPUT <character>,

                                                                     INPUT <character>,

                                                                     INPUT <character>,

                                                                     INPUT <integer>,

                                                                     INPUT <decimal>,

                                                                     INPUT <character>  ).

Descrição

Gera histórico de pedido para o evento de desalocação do item

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cItCodigo

Código do item do pedido

 

iNrSequencia

Sequencia do item do pedido

 

qtde

Quantidade alocada do item

 

cNrEmbarque

Número do embarque onde o item foi desalocado

Retorno

Nenhum

logSeparateOrderShipment

Requisito

Nenhum

Sintaxe

RUN logSeparateOrderShipmentIN h-handle (INPUT <character>,

                                                                         INPUT <character>,

                                                                         INPUT <character>,).

Descrição

Gera histórico de pedido para o evento de separação de embarque

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cNrEmbarque

Número do embarque onde o item foi alocado

Retorno

Nenhum

logInvoiceOrderShipment

Requisito

Nenhum

Sintaxe

RUN logInvoiceOrderShipment IN h-handle (INPUT <character>,

                                                                       INPUT <character>,

                                                                       INPUT <character>,

                                                                       INPUT <character>,

                                                                       INPUT <character> ).

Descrição

Gera histórico de pedido para o evento de faturamento de embarque

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cNrEmbarque

Número do embarque onde o item foi alocado

 

cNrFiscal

Número da nota fiscal que foi faturado o embarque do pedido

 

cSerie

Série da nota fiscal que foi faturado o embarque do pedido

Retorno

Nenhum

logReturnToSeparationOrderShipment

Requisito

Nenhum

Sintaxe

RUN logReturnToSeparationOrderShipment IN h-handle (INPUT <character>,

                                                                                            INPUT <character>,

                                                                                            INPUT <character>,).

Descrição

Gera histórico de pedido para o evento de retorno de separação de embarque

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cNrEmbarque

Número do embarque onde o item foi alocado

Retorno

Nenhum

 

 

logReturnToPreparationOrderShipment

Requisito

Nenhum

Sintaxe

RUN logReturnToPreparationOrderShipment IN h-handle (INPUT <character>,

                                                                                             INPUT <character>,

                                                                                             INPUT <character>,).

Descrição

Gera histórico de pedido para o evento de retorno de preparação de embarque

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cNrEmbarque

Número do embarque onde o item foi alocado

Retorno

Nenhum

logSendToSeparationOrderShipment

Requisito

Nenhum

Sintaxe

RUN logSendToSeparationOrderShipment IN h-handle (INPUT <character>,

                                                                                          INPUT <character>,

                                                                                          INPUT <character>,).

Descrição

Gera histórico de pedido para o evento de reenvio de separação de embarque

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cNrEmbarque

Número do embarque onde o item foi alocado

Retorno

Nenhum

logInvoiceOrder

Requisito

Nenhum

Sintaxe

RUN logInvoiceOrder IN h-handle (INPUT <character>,

                                                        INPUT <character>,

                                                        INPUT <character>,

                                                        INPUT <character>).

Descrição

Gera histórico de pedido para o evento de faturamento do pedido

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cNrFiscal

Número da nota fiscal que foi faturado o embarque do pedido

 

cSerie

Série da nota fiscal que foi faturado o embarque do pedido

Retorno

Nenhum

logCancelInvoice

Requisito

Nenhum

Sintaxe

RUN logCancelInvoice IN h-handle (INPUT <character>,

                                                          INPUT <character>,

                                                          INPUT <character>,

                                                          INPUT <character>,

                                                          INPUT <date>

                                                          INPUT <character>).

Descrição

Gera histórico de pedido para o evento de cancelamento do faturamento do pedido

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

cNrFiscal

Número da nota fiscal que foi faturado o embarque do pedido

 

cSerie

Série da nota fiscal que foi faturado o embarque do pedido

 

dtCancel

Data em que a nota fiscal foi cancelada

 

cDescMotivo

Motivo do cancelamento da nota fiscal

Retorno

Nenhum

logCredito

Requisito

Nenhum

Sintaxe

RUN logCredito IN h-handle (INPUT <character>,

                                               INPUT <character>).

Descrição

Gera histórico de pedido para o evento de avaliação de crédito do pedido

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

Retorno

Nenhum

logCopyOrder

Requisito

Nenhum

Sintaxe

RUN logCopyOrder IN h-handle (INPUT <character>,

                                                     INPUT <character>,

                                                     INPUT <character>,

                                                     INPUT <character>).

Descrição

Gera histórico de pedido para o evento de cópia do pedido

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

 

nrPedOrigem

Identifica o número do pedido de origem

 

nomeAbrevOrigem

Identifica o nome abreviado do pedido de origem

Retorno

Nenhum

logComercial

Requisito

Nenhum

Sintaxe

RUN logComercial IN h-handle (INPUT <character>,

                                                    INPUT <character>).

Descrição

Gera histórico de pedido para o evento de avaliação comercial do pedido

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

Retorno

Nenhum

pi-calculate-time

Requisito

Nenhum

Sintaxe

RUN pi-calculate-time IN h-handle (INPUT <character>,

                                                         INPUT <character>).

Descrição

Ajusta o horário do histórico de pedido.

Parâmetros

Descrição

nrPedCli

Identifica o número do pedido do cliente

 

nomeAbrev

Identifica o nome abreviado do pedido do cliente

Retorno

Nenhum

 

OpenQuery / SetConstraint / LinkTo

 

openQueryMain

Requisito

Nenhum

Sintaxe

run openQueryStatic in h-handle (input "Main":U).

Descrição

Faz a abertura da tabela principal.

Parâmetros

Descrição

 

 

Retorno