Árvore de páginas

Documento de BO

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físico

 frbo/bofr057

 

Objetivo

Validação, Manutenção e acesso rápido a tabela “mab-item-abastec”.

 

Funcionamento

A BO irá validar os dados, manutenir a tabela e fazer a leitura dos registros da tabela “mab-item-abastec”.

Na forma padrão, realiza-se a chamada através de um comando RUN.

A sintaxe para a chamada BO é:

run frbo\bofr057.p.

 

A execução na forma persistente...

A sintaxe para executar a BO em modo persistente é:

run frbo\bofr057.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:

Tabela Temporária

Descrição

Entrada/Saída

RowObject

Tabela de comunicação entre Interface e banco de dados da tabela “mab-item-abastec”.

Entrada/Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

num-docto

int

>>>,>>>,>>9

Número Documento

Sim  /  Key

001

cod-posto

char

x(8)

Código do Posto

Sim  /  Key

001

cod-bomba

char

x(12)

Código da Bomba

Sim  /  Key

001

it-codigo

char

x(16)

Código do Item de Estoque

Sim  /  Key

001

val-quant

dec

>>>,>>9.99

Quantidade Abastecida

Sim

001

val-mater-1

dec

>>>,>>>,>>9.999

Valor do abastecimento na moeda 0.

Não

001

val-mater-2

dec

>>>,>>>,>>9.999

Valor do abastecimento na moeda 1.

Não

001

val-mater-3

dec

>>>,>>>,>>9.999

Valor do abastecimento na moeda 2.

Não

001

ep-codigo

int

>>9

Empresa Equipamento

Sim

001

cod-eqpto

char

x(16)

Código Equipamento

Sim

001

val-dat-hora-invrtda

dec

999999999999

Valor da Data e Hora Invertidas do Apontamento

Sim

001

cod-tip-mater

char

x(16)

Código do Tipo de Material

Sim

001

log-abastec-prim

log

Sim/Não

Abastecimento de Combustível Primário?

Sim

001

cod-refer

char

x(8)

Referência do Item de Estoque

Não

001

cod-localiz

char

x(10)

Localização do Item de Estoque

Não

001

lote

char

x(10)

Lote do Item de Estoque

Não

001

nr-trans

int

>>>,>>>,>>9

Número da transação ocorrida no estoque (CEAPI001).

Não

001

cod-livre-1

char

x(1000)

Character Livre

Não

001

cod-livre-2

char

x(1000)

Character Livre

Não

001

log-livre-1

log

Sim/Não

Logical Livre

Não

001

log-livre-2

log

Sim/Não

Logical Livre

Não

001

num-livre-1

int

->>>>>>>>>9

Inteiro Livre

Não

001

num-livre-2

int

->>>>>>>>>9

Inteiro Livre

Não

001

val-livre-1

dec

->>>>>>>>>>>9.9

Decimal Livre

Não

001

val-livre-2

dec

->>>>>>>>>>>9.9

Decimal Livre

Não

001

dat-livre-1

date

99/99/9999

Data livre

Não

001

dat-livre-2

date

99/99/9999

Data livre

Não

001

r-rowid

rowid

padrão

Rowid da Tabela

Não

001

cod-estabelcharx(5)Estabelecimento do EquipamentoNão001
cod-cta-ctblcharx(20)Conta Contábil AbastecimentoNão001
cod-ccustocharx(20)Centro de Custo AbastecimentoNão001

Tabela Temporária

Descrição

Entrada/Saída

RowErrors

Contém os erros ocorridos na BO.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

ErrorSequence

integer

padrão

Seqüência dos erros

Sim

001

ErrorNumber

integer

padrão

Número do erro

Sim

001

ErrorDescription

char

padrão

Descrição do erro

Sim

001

ErrorParameters

char

padrão

Parâmetros passados para criar mensagem

Não

001

ErrorType

char

padrão

Tipo do erro:

WARNING: Aviso

ERROR: Erro

Sim

001

ErrorHelp

char

padrão

Texto de ajuda do erro

Sim

001

ErrorSubType

char

padrão

Sub Tipo da mensagem de erro

Não

001

-bloq-informa-cont

 

Tabela Temporária

Descrição

Entrada/Saída

ttApont

Tabela utilizada para a eliminação da tabela “mab-abastec-lubrific”.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

num-docto

int

>>>,>>>,>>9

Número Documento

Sim  /  Key

001

ep-codigo

int

>>9

Empresa Equipamento

Sim

001

cod-eqpto

char

x(16)

Código Equipamento

Sim

001

dat-movto

date

99/99/9999

Data do Movimento

Sim

001

hra-inicial

char

99:99:99

Hora Inicial

Sim

001

hra-final

char

99:99:99

Hora Final

Sim

001

cod-matr

char

x(10)

Código Matrícula Motorista

Sim

001

cod-rota

char

x(12)

Código da Rota

Sim

001

cod-usuar

char

x(12)

Código do Usuário EMS

Não

001

val-hodom-horim

dec

>,>>>,>>9.9

Valor do Contador do Equipamento

Sim

001

val-km-percur

dec

>,>>>,>>9.9

Valor da Quilometragem percorrida pelo Equipamento

Não

001

idi-consist

int

99

Status do Apontamento

1 = Ficha não consistida

2 = Consumo Real maior que máximo permitido

3 = Consumo Real menor que mínimo permitido

4 = Contador padrão

5 = Contador menor que anterior

6 = Diferença Contador maior desempenho tanque

21 = Apontamento correto

22 = Apontamento liberado consumo

23 = Apontamento liberado usuário

Sim

001

idi-integr

int

9

Apontamento Integrado com estoque?

1 = Não Integrado

2 = Integrado

Sim

001

cc-codigo

char

x(20)

Código Centro de Custo.

Este campo será atualizado pelo cadastro de Histórico Atividade.

Não

001

ct-codigo

char

x(20)

Código Conta.

Este campo será atualizado pelo cadastro de Histórico Atividade.

Não

001

cod_unid_negoc

char

x(3)

Código Unidade de Negócio.

Este campo será atualizado pelo cadastro de Histórico Atividade.

Não

001

nr-nota-fis

char

x(16)

Número da Nota Fiscal

Não

001

serie

char

x(5)

Série da Nota Fiscal

Não

001

cod-ativid

char

x(8)

Código da Atividade

Não

001

cod-posto

char

x(8)

Código do Posto de Abastecimento

Sim

001

val-dat-hora-invrtda

dec

999999999999

Valor da Data e Hora Invertidas do Movimento

Não

001

log-consist

log

Sim/Não

Apontamento Consistido (Correto)?

Não

001

cod-livre-1

char

x(1000)

Character Livre

Não

001

cod-livre-2

char

x(1000)

Character Livre

Não

001

log-livre-1

log

Sim/Não

Logical Livre

Não

001

log-livre-2

log

Sim/Não

Logical Livre

Não

001

num-livre-1

int

->>>>>>>>>9

Inteiro Livre

Não

001

num-livre-2

int

->>>>>>>>>9

Inteiro Livre

Não

001

val-livre-1

dec

->>>>>>>>>>>9.9

Decimal Livre

Não

001

val-livre-2

dec

->>>>>>>>>>>9.9

Decimal Livre

Não

001

dat-livre-1

date

99/99/9999

Data livre

Não

001

dat-livre-2

date

99/99/9999

Data livre

Não

001

r-rowid

rowid

padrão

Rowid da Tabela

Não

001

Tabela Temporária

Descrição

Entrada/Saída

RowErrorsApont

Contém os erros ocorridos na BO da tabela “mab-abastec-lubrific”.

Entrada

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

ErrorSequence

integer

padrão

Seqüência dos erros

Sim

001

ErrorNumber

integer

padrão

Número do erro

Sim

001

ErrorDescription

char

padrão

Descrição do erro

Sim

001

ErrorParameters

char

padrão

Parâmetros passados para criar mensagem

Não

001

ErrorType

char

padrão

Tipo do erro:

WARNING: Aviso

ERROR: Erro

Sim

001

ErrorHelp

char

padrão

Texto de ajuda do erro

Sim

001

ErrorSubType

char

padrão

Sub Tipo da mensagem de erro

Não

001

Métodos

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

 

Método Básico

goToKey

Requisito

Nenhum

Sintaxe

run goToKey in h-handle (input <integer>,

                         input <character>,

                         input <character>,

                         input <character>).

Descrição

Reposiciona a query com base na chave primária da tabela.

 

Parâmetros

Descrição

 

pnum-docto

Número do Documento

 

pcod-posto

Código do Posto de Combustível

 

pcod-bomba

Código da Bomba

 

pit-codigo

Código do Item de Estoque

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getKey

Requisito

Nenhum

Sintaxe

run getKey in h-handle (output <integer>,

                        output <character>,

                        output <character>,

                        output <character>).

Descrição

Retorna os campos da chave primária da tabela.

 

Parâmetros

Descrição

 

pnum-docto

Número do Documento

 

pcod-posto

Código do Posto de Combustível

 

pcod-bomba

Código da Bomba

 

pit-codigo

Código do Item de Estoque

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getCharField

Requisito

Nenhum

Sintaxe

run getCharField in h-handle (input  <character>,

                              output <character>).

Descrição

Retorna os valores dos campos da tabela que são caracteres.

 

Parâmetros

Descrição

 

pFieldName

Nome do campo a ser retornado

 

pFieldValue

Valor do campo.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getDateField

Requisito

Nenhum

Sintaxe

run getDateField in h-handle (input  <character>,

                              output <date>).

Descrição

Retorna os valores dos campos da tabela que são data.

 

Parâmetros

Descrição

 

pFieldName

Nome do campo a ser retornado

 

pFieldValue

Valor do campo.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getDecField

Requisito

Nenhum

Sintaxe

run getDecField in h-handle (input  <character>,

                             output <decimal>).

Descrição

Retorna os valores dos campos da tabela que são decimais.

 

Parâmetros

Descrição

 

pFieldName

Nome do campo a ser retornado

 

pFieldValue

Valor do campo.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getIntField

Requisito

Nenhum

Sintaxe

run getIntField in h-handle (input  <character>,

                             output <integer>).

Descrição

Retorna os valores dos campos da tabela que são inteiros.

 

Parâmetros

Descrição

 

pFieldName

Nome do campo a ser retornado

 

pFieldValue

Valor do campo.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getLogField

Requisito

Nenhum

Sintaxe

run getLogField in h-handle (input  <character>,

                             output <logical>).

Descrição

Retorna os valores dos campos da tabela que são Lógicos.

 

Parâmetros

Descrição

 

pFieldName

Nome do campo a ser retornado

 

pFieldValue

Valor do campo.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getRawField

Requisito

Nenhum

Sintaxe

run getRawField in h-handle (input  <character>,

                             output <raw>).

Descrição

Retorna os valores dos campos da tabela que são caracteres longos.

 

Parâmetros

Descrição

 

pFieldName

Nome do campo a ser retornado

 

pFieldValue

Valor do campo.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getRecidField

Requisito

Nenhum

Sintaxe

run getRecidField in h-handle (input  <character>,

                               output <recid>).

Descrição

Retorna os valores dos campos da tabela que são numéricos e definem uma seqüência única para a tabela dentro do database.

 

Parâmetros

Descrição

 

pFieldName

Nome do campo a ser retornado

 

pFieldValue

Valor do campo.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

getRowid

Requisito

Nenhum

Sintaxe

run getRowid in h-handle (output <rowid>).

Descrição

Retorna o ROWID do registro corrente da Query que está aberta na BO. Este método não aparece para ser manutenido.

 

Parâmetros

Descrição

 

pRowid

Rowid da tabela.

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

 

OpenQuery / SetConstraint / LinkTo

linkToApontamento

Requisito

Ser chamado somente quando há o Join entre a tabela em questão e a tabela mab-abastec-lubrific.

Sintaxe

run linkToApontamento in h-handle (input <hanlde>).

Descrição

Faz o JOIN entre as tabelas “mab-abastec-lubrific” e “mab-item-abastec”.

Recebe como parâmetro o handle da BO da tabela mab-abastec-lubrific, para buscar a chave primária da mesma (do registro corrente na BO), para setar as restrições “setConstraintApontamento”.

 

Parâmetros

Descrição

 

pHandle

Handle da BO “mab-abastec-lubrific” (Apontamento Abastec/Lubrific.).

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

setConstraintAbastecimento

Requisito

Nenhum

Sintaxe

run setConstraintAbastecimento in h-handle (input <integer>,

                                            input <integer>,

                                            input <character>,

                                            input <character>,

                                            input <character>,

                                            input <character>,

                                            input <character>,

                                            input <character>,).

Descrição

Seta asretrições para as faixas da chave primária da tabela.

 

Parâmetros

Descrição

 

pDocIni

Documento inicial

pDocFim

Documento final

pPostoIni

Posto Inicial

pPostoFim

Posto Final

pBombaIni

Bomba Inicial

pBombaFim

Bomba Final

pItemIni

Item Inicial

pItemFim

Item Final

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

setConstraintApontamento

Requisito

Nenhum

Sintaxe

run setConstraintApontamento in h-handle (input <integer>).

Descrição

Seta as restrições para abrir a query por número do documento do apontamento.

 

Parâmetros

Descrição

 

pDocumento

Número do Documento

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

setConstraintEquipamento

Requisito

Nenhum

Sintaxe

run setConstraintEquipamento in h-handle (input <integer>,

                                          input <integer>,

                                          input <character>,

                                          input <character>).

Descrição

Seta as retrições para as faixas de equipamento.

 

Parâmetros

Descrição

 

pEmpIni

Empresa Inicial

pEmpFim

Empresa Final

pEqptoIni

Equipamento Inicial

pEqptoFim

Equipamento Final

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

openQueryAbastecimento

Requisito

A setConstraintAbastecimento ter sido executada anteriormente.

Sintaxe

run openQueryAbastecimento in h-handle.

Descrição

Abre a query com os registros da faixa da chave primária.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

openQueryApontamento

Requisito

A setConstraintApontamento ter sido executada anteriormente.

Sintaxe

run openQueryApontamento in h-handle.

Descrição

Abre a query da BO conforme o número do documento do apontamento passado na procedure setConstraintApontamento.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

openQueryApontPrimario

Requisito

A setConstraintApontamento ter sido executada anteriormente.

Sintaxe

run openQueryApontPrimario in h-handle.

Descrição

Abre a query da BO conforme o número do documento do apontamento passado na procedure setConstraintApontamento traz somente os apontamentos de combustível primário.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

openQueryEquipamento

Requisito

A setConstraintEquipamento ter sido executada anteriormente.

Sintaxe

run openQueryEquipamento in h-handle.

Descrição

Abre a query com os registros da faixa de equipamento.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

openQueryMain    

Requisito

Nenhum

Sintaxe

run openQueryMain in h-handle.

Descrição

Abre a query da BO com todos os registros.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

 

Método   Negócio

validateRecord

Requisito

Ter sido executada alguma ação para manutenção do registro da tabela. Esta procedure é executada somente internamente pela BO.

Sintaxe

run validate in this-procedure (input <character>).

Descrição

Valida as ações feitas em cima do registro da tabela corrente da BO. Estas ações podem ser: “CREATE”, “UPDATE” e “DELETE”.

 

Parâmetros

Descrição

 

pType

Tipo de ação:

“CREATE”

“UPDATE”

“DELETE”

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

validaEstoque

Requisito

Procedure chamada pelo método interno validateRecord. Não deve ser chamada externamente.

Sintaxe

run validaEstoque in this-procedure (input <character>).

Descrição

Faz as validações para os atributos do estoque.

it-codigo = Código do Item

cod-refer = Código da Referência

cod-localiz = Código da Localização

lote = Código do Lote

 

Parâmetros

Descrição

 

pPosto

Código do Posto de Abastecimento

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

validaItem

Requisito

Nenhum.

Sintaxe

run validaItem in this-procedure (input <integer>,

                                  input <character>,

                                  input <character>,

                                  input <character>,

                                  input <character>,

                                  input <date>).

Descrição

Valida se item informado está relacionado a um Tipo de Material e se este tipo de material está associado a bomba do posto, quando o posto abastecimento for próprio.

 

Parâmetros

Descrição

 

pEmpresa

Código da Empresa

pEqpto

Código do equipamento

pPosto

Código do Posto

pBomba

Código da bomba

pItem

Código do Item

pData

Data do Movimento

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.

afterCreateRecord

Requisito

Procedure chamada pelo método interno CreateRecord. Não deve ser chamada externamente.

Sintaxe

run afterCreateRecord in this-procedure.

Descrição

Verifica se execução da API de consistência dos Abastec./Lubrific. será feita.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

afterDeleteRecord

Requisito

Procedure chamada pelo método interno DeleteRecord. Não deve ser chamada externamente.

Sintaxe

run afterDeleteRecord in this-procedure.

Descrição

Verifica se o movimento de abastecimento eliminado, está integrado com estoque.

Se estiver integrado, será gerado um movimento de Devolução dos materiais na CPAPI001 (API de estoque).

Se o programa que estiver executando a BO for o AB0306 (Apontamentos de Abastecimento), chama a procedure “piEliminaFicha”, para validar a eliminação da Ficha de Abastecimento/Lubrificação.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

afterUpdateRecord

Requisito

Procedure chamada pelo método interno UpdateRecord. Não deve ser chamada externamente.

Sintaxe

run afterUpdateRecord in this-procedure.

Descrição

Verifica se execução da API de consistência dos abastec./Lubrific. será feita.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

beforeDeleteRecord

Requisito

Procedure chamada pelo método interno DeleteRecord. Não deve ser chamada externamente.

Sintaxe

run beforeDeleteRecord in this-procedure.

Descrição

 

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

piEliminaFicha

Requisito

Procedure chamada pelo método interno afterDeleteRecord. Não deve ser chamada externamente.

Sintaxe

run piEliminaFicha in this-procedure.

Descrição

Verifica se a Ficha de Abastecimento/Lubrificação contém mais abastecimentos ou lubrificações, se não tiver mais relacionamentos, chama a BO (bofr055), para eliminação da ficha, utilizando as validações da BO.

Se ocorreu erro na eliminação, os erros serão mostrados em tela.

Obs: Esta procedure é utilizada pelo programa de Apontamento de Abastecimento (AB0306).

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

buscaTipoMaterial

Requisito

Nenhum

Sintaxe

run buscaTipoMaterial in h-handle (input <integer>,

                                   input <character>,

                                   input <character>,

                                   input <date>,

                                   output <character>,

                                   output <logical>,

                                   output <decimal>).

Descrição

Verifica qual o tipo de material do item de estoque informado e retorna se é um abastecimento primário e a capacidade de armazenamento no tanque de combustível.

 

Parâmetros

Descrição

 

pEmpresa

Código da Empresa

 

pEqpto

Código do Equipamento

 

pItem

Código do Item de Estoque

 

pData

Data do Apontamento

 

pTipo

Código do Tipo de Material

 

pLog

Abastecimento Primário?

 

pTanque

Valor da capacidade do tanque de combustível

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

buscaTipoPosto

Requisito

Nenhum

Sintaxe

run buscaTipoPosto in h-handle (input  <character>,

                                output <integer>).

Descrição

Busca o tipo de posto de combustível.

1 = Próprio

2 = Terceiros

 

Parâmetros

Descrição

 

pPosto

Código do Posto de Combustível

 

pTipo

Tipo de posto

1 = Próprio

2 = Terceiros

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

piChamaABAPI001          

Requisito

Nenhum

Sintaxe

run piChamaABAPI001 in h-handle.

Descrição

Chama a API de Atualização das fichas de abastecimento/lubrificação.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

setaPrograma        

Requisito

Nenhum

Sintaxe

run setaPrograma in h-handle.

Descrição

Seta o Programa chamador da BO

 

Parâmetros

Descrição

 

pPrograma

Código do programa

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

sendMessageEAI

Requisito

Nenhum.

Sintaxe

run sendMessageEAI in this-procedure.

Descrição

Gera uma msg xml caso houver integração com agroindustria.

 

Parâmetros

Descrição

 

tt-mab-abastec-lubrific-eai

Temp-table

Retorno

A API/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) e NOK (execução com problemas).

setaExecutaAPI

Requisito

Nenhum

Sintaxe

run setaExecutaAPI in h-handle.

Descrição

Informa se executa API de atualização das fichas (ABAPI001)

 

Parâmetros

Descrição

 

pExecutaAPI

Executa API ABAPI001

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro....

 

pi-cria-tt-movto-un

Requisito

Procedure chamada pelo método interno afterDeleteRecord. Não deve ser chamada externamente.

Sintaxe

run pi-cria-tt-movto-un in this-procedure.

Descrição

Cria a temp-table de Unidade de Negócio com base na Matriz do Histórico.

 

Parâmetros

Descrição

 

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro.

 

inicializaHandle

Requisito

Nenhum

Sintaxe

run inicializaHandle in h-handle.

Descrição

Inicialização de handle para chamada a partir do programa ab0705

Obs.: Uso Interno.

 

Parâmetros

Descrição

                     

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro.

finalizaHandle

Requisito

Nenhum

Sintaxe

run finalizaHandle in h-handle.

Descrição

Finalização de handle para chamada a partir do programa ab0705

Obs.: Uso Interno.

 

Parâmetros

Descrição

                     

Não Contém

 

Retorno

A API/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) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table tt-erro.