Documento de BO

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físicodibo/bodi00893.p


Considerações Gerais

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela sdo-item-loja (Saldo Item Loja).


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/bodi00893.p PERSISTENT SET h-bodi00893.

A variável denominada h-bodi00893 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-sdo-item-loja

Entrada/Saída

Saldo item loja

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-depos

character

x(03)

Código do depósito

Sim

 

cod-estabel

character

x(05)

Código do estabelecimento

Sim

 

cod-localizcharacterx(20)Código da localizaçãoSim 
lotecharacterx(40)Código do loteSim 
it-codigocharacterx(16)Código do itemSim 
cod-refercharacterx(08)Código da referênciaSim 
quantidadedecimal->>>>,>>>,>>9.9999QuantidadeNão 
dt-atualizacaodate99/99/99999Data de AtualizaçãoNão 
cod-livre-1characterx(100)Livre 1Não 
cod-livre-2characterx(500)Livre 2Não 
   cod-livre-3characterx(100)Livre 3Não 
   cod-livre-4characterx(100)Livre 4Não 
log-livre-1logicalSim/NãoLivre 1Não 
log-livre-2logicalSim/NãoLivre 2Não 
   log-livre-3logicalSim/NãoLivre 3Não 
   log-livre-4logicalSim/NãoLivre 4Não 
num-livre-1integer>>>>>>>>9Livre 1Não 
num-livre-2integer>>>>>>>>9Livre 2Não 
num-livre-3integer>>>>>>>>9Livre 3Não 
num-livre-4integer>>>>>>>>9Livre 4Não 
val-livre-1decimal->>>>>>>>>>>9.99999999Livre 1Não 
val-livre-2decimal->>>>>>>>>>>9.99999999Livre 2Não 
val-livre-3decimal->>>>>>>>>>>9.99999999Livre 3Não 
val-livre-4decimal->>>>>>>>>>>9.99999999Livre 4Não 
dat-livre-1date99/99/9999Livre 1Não 
dat-livre-2date99/99/9999Livre 2Não 
dat-livre-3date99/99/9999Livre 3Não 
dat-livre-4date99/99/9999Livre 4Nã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 <character>,

                                     OUTPUT <character>,

                                     OUTPUT <character>,

                                     OUTPUT <character>).

Descrição

Retorna valor do campo do índice sdtmlj_ix2

Parâmetros

Descrição

pcod-deposCódigo do Depósito

 

pcod-estabel

Código do Estabelecimento

 pcod-localizCódigo da Localização
 ploteCódigo do Lote
 pit-codigoCódigo do Item
 pcod-referCódigo da Referência

Retorno

A BO irá retornar o valor contido no campo código depósito, código estabelecimento, código localização, código lote, código item e código referência que foi solicitado a BO

 

goToKey

Requisito

Nenhum

Sintaxe

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

                                           INPUT <character>,

                                           INPUT <character>,

                                           INPUT <character>,

                                           INPUT <character>,

                                           INPUT <character>).

Descrição

Reposiciona registro com base no índice sdtmlj_ix2

Parâmetros

Descrição

 

pcod-depos

Código do Depósito

 pcod-estabelCódigo do Estabelecimento
 pcod-localizCódigo da Localização
 ploteCódigo do Lote
 pit-codigoCódigo do Item
 pcod-referCódigo da Referência

Retorno

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

 

Métodos de Negócio

 

OpenQuery / SetConstraint

 

openQueryMain

Requisito

Nenhum

Sintaxe

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

Descrição

Faz a abertura da tabela principal.

Parâmetros

Descrição

 N/A

 N/A

Retorno

 N/A

 

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 Histórico de Relacionamento do Estabelecimento de Atendimento

Parâmetros

Descrição

 

pType

Parâmetro character para indicar 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