Linha Datasul

Árvore de páginas

Assunto

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físico:

inbo/boin769.p

Include com Parâmetros:Inbo/boin769.i 
Bancomovind
Tabelamla-log-reg

 

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela mla-log-reg (Log de registros).


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 inbo/boin769.p PERSISTENT SET h-handle.

 

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:

 

RowObject

Entrada/Saída

Log’s de registros

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

nr-trans  

integer 

>>>,>>>,>>9          

Transação     

Sim

 

cod-usuar 

character

X(12)                

Usuário       

Não

 

ep-codigo 

character

x(3)                 

Empresa       

Não

 

cod-estabel

character

x(5)                 

Estabelecimento

Não

 

cod-tabela

integer 

>9                   

Tabela        

Não

 

chave-reg 

character

X(32)                

Chave do registro      

Não

 

tipo-reg  

integer 

9                    

Tipo de registro(1 - Criação,  2 - Alteração, 3 - Eliminação)         

Não

 

data-reg  

date    

99/99/9999           

Data          

Não

 

hora-reg  

character

X(5)                 

Hora          

Não

 

log-reg   

character

X(2000)              

Log com as alterações          

Não

 

char-1    

character

x(100)               

 

Não

 

char-2    

character

x(100)               

 

Não

 

char-3    

character

x(100)               

 

Não

 

char-4    

character

x(100)               

 

Não

 

char-5    

character

x(100)               

 

Não

 

dec-1     

decimal 

>>>>>>>>>>>9.99999999

 

Não

 

dec-2     

decimal 

>>>>>>>>>>>9.99999999

 

Não

 

dec-3     

decimal 

>>>>>>>>>>>9.99999999

 

Não

 

dec-4     

decimal 

>>>>>>>>>>>9.99999999

 

Não

 

dec-5     

decimal 

>>>>>>>>>>>9.99999999

 

Não

 

int-1     

integer 

>>>>>>>>>9           

 

Não

 

int-2     

integer 

>>>>>>>>>9           

 

Não

 

int-3     

integer 

>>>>>>>>9            

 

Não

 

int-4     

integer 

>>>>>>>>9            

 

Não

 

int-5     

integer 

>>>>>>>>9            

 

Não

 

log-1     

logical 

Sim/Não              

 

Não

 

log-2     

logical 

Sim/Não              

 

Não

 

log-3     

logical 

Sim/Não              

 

Não

 

log-4     

logical 

yes/no               

 

Não

 

log-5     

logical 

yes/no               

 

Não

 

data-1    

date    

99/99/9999           

 

Não

 

data-2    

date    

99/99/9999           

 

Não

 

data-3    

date    

99/99/9999           

 

Não

 

data-4    

date    

99/99/9999           

 

Não

 

data-5    

date    

99/99/9999           

 

Não

 

 

Metodo Básico

 

Quando a BO for executada em modo persistente, os seguintes métodos estarão disponíveis para execução:

getCharField

Requisito

Query posicionada no registro.

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.

getDateField

Requisito

Query posicionada no registro.

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.

getDecField

Requisito

Query posicionada no registro.

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.

getIntField

Requisito

Query posicionada no registro.

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.

getLogField

Requisito

Query posicionada no registro.

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.

getRawField

Requisito

Query posicionada no registro.

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.

getRecidField

Requisito

Query posicionada no registro.

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.

getKey

Requisito

Query posicionada no registro.

Sintaxe

RUN getKey IN handle (OUTPUT <integer>).

Descrição

Retorna chave primária e única da tabela.

Parâmetros

Descrição

 

pnr-trans

Transação

Retorno

A BO irá retornar o valor contido na chave primária e única do registro que foi solicitado.

goToKey

Requisito

Query estar aberta.

Sintaxe

RUN goToKey IN h-handle (INPUT <integer>).

 

Descrição

Reposiciona registro com base no índice primário e único da tabela.

Parâmetros

Descrição

 

pnr-trans

Transação

Retorno

A BO irá reposicionar no registro que foi solicitado.

ValidateRecord

Requisito

Query posicionada no registro.

Sintaxe

Run validateRecord in handle (input <character>).

Descrição

Validações pertinentes ao DBO.

Parâmetros

Descrição

pType

Recebe o tipo de validação (Create, Delete, Update)

create: Indica a criação de um registro

update: Indica a atualização de um registro

delete: Indica a eliminação de um registro

Retorno

 

 

Método Negócio

 

pi-gera-log

Requisito

Nenhum

Sintaxe

RUN pi-gera-log in handle (INPUT pCodTabela,

                                            INPUT pRowid,

                                            INPUT pTipo-reg,

                                            INPUT pLog-reg)

Descrição

Gera os logs de alteração de acordo com os parâmetros recebidos.

Parâmetros

Descrição

pCod-tabela

Código da tabela

                   1 - mla-chave-doc-aprov

                   2 - mla-emails

                   3 - mla-faixa-aprov

                   4 - mla-hierarquia-aprov

                   5 - mla-hierarquia-faixa

                   6 - mla-lim-aprov-fam

                   7 - mla-lista-aprov-doc

                   8 - mla-lista-aprov-fam

                   9 - mla-lista-aprov-item

                   10 - mla-lista-aprov-ref

                   11 - mla-lotacao

                   12 - mla-param-aprov

                   13 - mla-perm-aprov

                   14 - mla-perm-lotacao

                   15 - mla-referencia

                   16 - mla-rej-aprov

                   17 - mla-tipo-aprov

                   18 - mla-tipo-aprov-doc

                   19 - mla-tipo-aprov-fam

                   20 - mla-tipo-aprov-item

                   21 - mla-tipo-aprov-ref

                   22 - mla-tipo-doc-aprov

                   23 - mla-usuar-aprov

                   24 - mla-usuar-aprov-altern

                   25 - mla-usuar-padrao

                   26 - mla-verba-aprov

 

pRowid    

Rowid da tabela origem

 

pTipo-reg 

Tipo da transação. ( 1 - Criação,  2 - Alteração, 3 - Eliminação)         

 

pLog-reg  

Detalhes da inclusão, alteração ou eliminação

Retorno

A BO irá setar o return-value de forma a informar ao programa “chamador” se a execução foi realizada com sucesso ou não. Os valores possíveis para o return-value são: OK (execução correta).

 

OpenQuery / SetConstraint / LinkTo

 

openQueryMain

Requisito

Nenhum

Sintaxe

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

Descrição

Faz a abertura da query principal.

Parâmetros

Descrição

 

 

Retorno