Linha Datasul

Árvore de páginas

Assunto 

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físico:

inbo/boin771.p

Include com Parâmetros:Inbo/boin771.i 
Bancomgind
Tabelamla-lista-aprov-ref

 

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela mla-lista-aprov-ref (Lista de aprovadores da referência).


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/boin771.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 da referência.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-tip-doc

integer 

 >>9                  

Código do Documento      

Sim

 

codigo    

character

 x(20)                

Referência     

Sim

 

seq-aprov 

integer 

 >9                   

Sequência      

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-ref-origem

Entrada/Saída

Lista de aprovadores da referência (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

situcao

character

x(20)

Descrição da situação do registro

Não

 

id-sit

integer

 

Situação do registro

Não

 

r-rowid

rowid

 

Rowid do registro

Não

 

tt-mla-lista-aprov-ref-destino

Entrada/Saída

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

OBS: Mesmos campos da tt-mla-lista-aprov-ref-origem.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

      

tt-lista

Entrada/Saída

Lista de Aprovadores.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

seq-aprov     

integer 

>9                   

Sequência     

Sim

 

cod-usuar-aprov

character

X(12)                

Aprovador       

Sim

 

limite-aprov  

decimal

>>,>>>,>>9.99

Limite de aprovação          

Não

 

rowlista      

rowid

 

Rowid do registro

Nã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 <integer>,

                                           OUTPUT <character>,

                                           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

pcodigo    

pseq-aprov 

Código da empresa

Códido do estabelecimento

Código do documento

Código referência

Sequência da aprovação

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

                                             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

pcodigo    

pseq-aprov 

Código da empresa

Códido do estabelecimento

Código do documento

Código referência

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.

Parâmetros

Descrição

 

prowid

Rowid do registro que será posicionado.

Retorno

A BO irá reposicionar no registro que foi solicitado.

validateRecord

Requisito

Query posicionada no regisro.

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

 

initializeBO

Requisito

nenhum

Sintaxe

Run initalizeBO in handle.

Descrição

Inicializa as handles da BO.

Parâmetros

Descrição

 

 

Retorno

 

 

Método Negócio

 

getListaAprov

Requisito

Nenhum

Sintaxe

RUN getListaAprov in handle (INPUT <character>,

                                               INPUT <character>,

                                               INPUT <integer>,

                                               INPUT <character>,

                                               INPUT <decimal>,

                                               INPUT <logical>,

                                               INPUT-OUTPUT TABLE tt-lista)

Descrição

Fornece a lista de aprovadores da referência com base nos parâmetros recebidos.

Parâmetros

Descrição

p-ep-codigo    

p-cod-estabel  

p-cod-tip-doc  

p-cod-referencia

p-valor-doc    

p-somente-limite

tt-lista      

Código da empresa

Código do estabelecimento

Tipo de documento

Código referência

Valor do documento

Considera somente usuários com limite de aprovação

Aprovadores da referência

Retorno

Retorna a lista de aprovadores da referência.

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-ref-origem,

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

Descrição

Substitui e/ou elimina usuário da lista de aprovadores da referência.

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 (que terá suas pendências transferidas para outro usuário).

 

pcDestino                     

Usuário destino (que receberá as pendências transferidas).

 

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-lista-aprov-ref-origem

Contém os dados dos registros(Aprovadores da referência) do usuário origem.

 

tt-mla-lista-aprov-ref-destino

Contém os dados dos registros(Aprovadores da referência) do usuário destino.

Retorno

Retorna as temp-tables tt-mla-lista-aprov-ref-origem e tt-mla-lista-aprov-ref-destino carregadas com informações dos aprovadores referência. 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.

Abertura principal: run openQuery in h-handle (input “Main”:U).

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