Linha Datasul

Árvore de páginas

Assunto

 

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físico:

inbo/boin795.p

Include com Parâmetros:Inbo/boin795.i 
Bancomgind
Tabelamla-lista-aprov-doc

 

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela mla-lista-aprov-doc (Lista de aprovadores do documento).

 

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/boin795.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

Lista de aprovadores do documento

Entrada/

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-tip-doc

integer 

>>9                  

Documento     

Sim

 

seq-aprov 

integer 

>9                   

Sequência de aprovação    

Sim

 

cod-usuar 

character

X(12)                

Aprovador       

Não

 

char-1    

character

x(100)               

              

Não

 

char-2    

character

x(100)               

              

Não

 

dec-1     

decimal 

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

              

Não

 

dec-2     

decimal 

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

              

Não

 

int-1     

integer 

>>>>>>>>>9           

              

Não

 

int-2     

integer 

>>>>>>>>>9           

              

Não

 

log-1     

logical 

Sim/Não              

              

Não

 

log-2     

logical 

Sim/Não              

              

Não

 

data-1    

date    

99/99/9999           

              

Não

 

data-2    

date    

99/99/9999           

              

Não

 

char-3    

character

x(100)               

              

Não

 

char-4    

character

x(100)               

              

Não

 

char-5    

character

x(100)               

              

Não

 

dec-3     

decimal 

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

              

Não

 

dec-4     

decimal 

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

              

Não

 

dec-5     

decimal 

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

              

Não

 

int-3     

integer 

>>>>>>>>>9           

              

Não

 

int-4     

integer 

>>>>>>>>>9           

              

Não

 

int-5     

integer 

>>>>>>>>>9           

              

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-3    

date    

99/99/9999           

              

Não

 

data-4    

date    

99/99/9999           

              

Não

 

data-5    

date    

99/99/9999           

              

Não

 

ep-codigo 

character

x(3)                 

Empresa       

Sim

 

cod-estabel

character

x(5)                 

Estabelecimento

Sim

 

tt-mla-lista-aprov-doc-origem

Entrada/Saída

Lista de aprovadores do documento (do usuário origem – Utilizado pela procedure piSubstituiAprovador).

Obs: Mesmos campos da temp-table RowObject, mais os definidos abaixo.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

id-sit

integer

 

Situação

Não

 

situacao

character

x(20)

Descrição da situação

Não

 

r-rowid

rowid

 

Rowid do registro

Não

 

tt-mla-lista-aprov-doc-destino

Entrada/Saída

Lista de aprovadores do documento (do usuário destino – Utilizado pela procedure piSubstituiAprovador).

Obs: Mesmos campos da temp-table tt-mla-lista-aprov-doc-origem.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

      

tt-lista

Entrada/Saída

Lista de aprovadores do documento.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

seq-aprov 

integer 

>9                   

Sequência da aprovação    

Sim

 

cod-usuar-aprov

character

x(12)

Aprovador

Não

 

limite-aprov

decimal

->>,>>>,>>9.99

Limite de aprovação

Não

 

rowlista

rowid

 

Rowid registro

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 <character>,

                                           OUTPUT <character>,

                                           OUTPUT <integer >,

                                           OUTPUT <integer>).

 

Descrição

Retorna valores dos campos do índice primário e único da tabela.

Parâmetros

Descrição

 

pep-codigo 

pcod-estabel

pcod-tip-doc

pseq-aprov 

Empresa

Estabelecimento

Documento

Sequência

Retorno

A BO irá retornar o valor contido nos campos do índice primário e único da tabela.

goToKey

Requisito

Query estar aberta.

Sintaxe

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

                                                  INPUT <character>,

                                                  INPUT <integer >,

                                                  INPUT <integer>).

 

Descrição

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

Parâmetros

Descrição

 

pep-codigo 

pcod-estabel

pcod-tip-doc

pseq-aprov 

Empresa

Estabelecimento

Documento

Sequência

Retorno

A BO irá reposicionar no registro que foi solicitado.

goToKeyRowid

Requisito

Query estar aberta.

Sintaxe

RUN goToKeyRowid IN h-handle (INPUT <rowid>).

Descrição

Reposiciona registro com base no rowid recebido.

Parâmetros

Descrição

 

Prowid

Rowid do registro a ser posicionado

Retorno

A BO irá reposicionar no registro que foi solicitado.

 

 

initializeBO

Requisito

nenhum

Sintaxe

Run initializeBO in handle.

Descrição

Inicialização das handles da BO.

Parâmetros

Descrição

 

 

Retorno

 

 

 

validateRecord

Requisito

Query posicionada no registro.

Sintaxe

Run validateRecord in handle (intpu pType).

Descrição

Validações pertinentes ao DBO.

Parâmetros

Descrição

pType

Recebe o tipo de validação

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

 

piSubstituiAprovador

Requisito

Nenhum

Sintaxe

RUN piSubstituiAprovador in handle (INPUT <character>,

                                                           INPUT <character>,

                                                           INPUT <character>,

                                                           INPUT <character>,

                                                           INPUT <character>,

                                                           INPUT <character>,

                                                           INPUT <logical>,

                                                           INPUT <logical>,

                                                           OUTPUT TABLE tt-mla-lista-aprov-doc-origem,

                                                           OUTPUT TABLE tt-mla-lista-aprov-doc-destino).

Descrição

Substitui e/ou elminada usuário na lista de aprovadores do documento.

Parâmetros

Descrição

 

pcEmpresaIni                  

Empresa inicial a ser considerada para substituição dos aprovadores                                                                                      

 

pcEmpresaFim          

Empresa final a ser considerada para substituição dos aprovadores     

 

pcEstabIni

Estabelecimento inicial a ser considerado para substituição dos aprovadores

 

pcEstabFim

Estabelecimento final a ser considerado para substituição dos aprovadores   

 

pcOrigem 

Usuário origem a ser considerado para substituição dos aprovadores

 

pcDestino  

Usuário destino a ser considerado para substituição dos aprovadores

 

plManterUsuario

Indica se o usuário deve ser mantido ou não na lista caso já exista o usuário detino na lista corrente.

 

plSimulaAlteracao             

Indica se é apenas um simulação(cria as temp-tables porém não efetiva as alterações na base).         

 

tt-mla-lim-aprov-doc-origem

Contém os dados dos registros(Lista de aprovadores do documento) do usuário origem.

 

tt-mla-lim-aprov-doc-destino

Contém os dados dos registros(Lista de aprovadores do documento) do usuário destino.

Retorno

Retorna as temp-tables tt-mla-lista-aprov-doc-origem e tt-mla-lista-aprov-doc-destino com informações das listas de aprovadores do documento. As temp-tables contem a situação da atualização de cada um dos registros.

 

OpenQuery / SetConstraint / LinkTo

openQuery

Requisito

Nenhum

Sintaxe

run openQuery in h-handle (input <character>).

Descrição

Faz abertuda das querys.

Parâmetros

Descrição

p-ordem

Ordenação da abertura.

“main” – Abertura da query principal.

Retorno

Retorna um return-value com o valor “OK” se foi executado com sucesso.

 

 

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