Linha Datasul

Árvore de páginas

Assunto

 

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físico:

inbo/boin793.p

Include com Parâmetros:Inbo/boin793.i 
Bancomgind
Tabelamla-hierarquia-faixa

 

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela mla-hierarquia-faixa (Hierarquia da Faixa).


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

Hierarquia de aprovadores da faixa.

Entrada/

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-tip-doc

integer  

>>9          

Documento        

Sim

 

cod-lotacao

character

x(20)                

Lotação          

Sim

 

num-faixa 

integer  

>9                   

Número da Faixa            

Sim

 

seq-aprov 

integer  

>9                   

Sequência  de aprovação      

Sim

 

cod-usuar 

character

X(12)                

Aprovador          

Não

 

log-depend

logical  

Sim/Não              

Indica depedência

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-hierarquia-faixa-origem

Entrada/Saída

Lista de aprovadores da faixa (do usuário origem – Utilizado pela procedure piSubstituiAprovador)

OBS: Mesmos campos da temp-table RowObject, mais os campos 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-hierarquia-faixa-destino

Entrada/Saída

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

OBS: Mesmos campos da tt-mla-hierarquia-faixa-origem.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

      

 

Método 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 <character >,

                                       OUTPUT <integer>,

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

pcod-tip-doc

pnum-faixa 

pseq-aprov 

Empresa

Estabelecimento

Lotação

Documento

Faixa

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

                                                  INPUT <integer>,

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

pcod-tip-doc

pnum-faixa 

pseq-aprov 

Empresa

Estabelecimento

Lotação

Documento

Faixa

Sequência

Retorno

A BO irá reposicionar no registro que foi solicitado.

goToKeyRowid

Requisito

Query posicionada no registro.

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.

 

 

validateRecord

Requisito

Query estar 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>,

                                                           OUTPUT TABLE tt-mla-hierarquia-faixa-origem,

                                                           OUTPUT TABLE tt-mla-hierarquia-faixa-destino).

Descrição

Substitui usuário na hierarquia de faixa de aprovadores

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

 

pcDestino  

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

 

pcOrigem 

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

 

plSimulaAlteracao             

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

 

tt-mla-hierarquia-faixa-origem

Contém os dados dos registros(Hierarquia da faixa) do usuário origem.

 

tt-mla-hierarquia-faixa-destino

Contém os dados dos registros(Hierarquia da faixa) do usuário destino.

Retorno

Retorna as temp-tables tt-mla-hierarquia-faixa-origem e tt-mla-hierarquia-faixa-destino com informações dos aprovadores das hierarquias da faixa. 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