Documento de BO
Produto: | Datasul |
Ocorrência: | Documentação de BO |
Nome Físico | frbo/bofr085 |
Objetivo
Validação, Manutenção e acesso rápido a tabela “mgf-cust-eqpto”.
Funcionamento
A BO irá validar os dados, manutenir a tabela e fazer a leitura dos registros da tabela “mgf-cust-eqpto”.
Na forma padrão, realiza-se a chamada através de um comando RUN.
A sintaxe para a chamada BO é:
run frbo\bofr085.p.
A execução na forma persistente ...
A sintaxe para executar a BO em modo persistente é:
run frbo\bofr085.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 “mgf-cust-eqpto”. | Entrada/Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ep-codigo | Int | >>9 | Código da empresa do equipamento | Sim | |
cod-eqpto | Char | x(16) | Código do equipamento | Sim | |
dat-movto | Date | 99/99/9999 | Data do Movimento | Sim | |
cod-estabel | Char | x(3) | Código do Estabelecimento. | Sim | |
val-hora-manut | Dec | >>,>>9.99 | Horas Manutenção | | |
val-hora-reporte | Dec | >>,>>9.99 | Horas reportadas pelos funcionários manutenção | | |
val-km-percur | Dec | >,>>>,>>9.9 | Indica o total do percurso realizado | | |
val-quant-combust | Dec | >>>,>>>,>>9.99 | Quantidade Combustível | | |
val-ggf-1-corren | Dec | >,>>>,>>9.99 | Gasto GGF 1 Moeda Corrente | | |
val-ggf-1-moed-1 | Dec | >>,>>>,>>9.99 | Valor GGF 1 - moeda alternativa 1 | Sim | |
val-ggf-1-moed-2 | Dec | >>,>>>,>>9.99 | Valor GGF 1 - moeda alternativa 2 | | |
val-ggf-2-corren | Dec | >>,>>>,>>9.99 | Valor GGF 2 - moeda corrente | Sim | |
val-ggf-2-moed-1 | Dec | >>,>>>,>>9.99 | Valor GGF 2 - moeda alternativa 1 | | |
val-ggf-2-moed-2 | Dec | >>,>>>,>>>,>>9.99 | Valor GGF 2 - moeda alternativa 2 | | |
val-ggf-3-corren | Dec | >>,>>>,>>9.99 | Valor GGF 3 - moeda corrente | | |
val-ggf-3-moed-1 | Dec | >>,>>>,>>9.99 | Valor GGF 3 - moeda alternativa 1 | Sim | |
val-ggf-3-moed-2 | Dec | >>,>>>,>>9.99 | Valor GGF 3 - moeda alternativa 2 | | |
val-ggf-4-corren | Dec | >>,>>>,>>9.99 | Valor GGF 4 - moeda corrente | | |
val-ggf-4-moed-1 | Dec | >>,>>>,>>9.99 | Valor GGF 4 - moeda alternativa 1 | | |
val-ggf-4-moed-2 | Dec | >>,>>>,>>9.99 | Valor GGF 4 - moeda alternativa 2 | | |
val-ggf-5-corren | Dec | >>,>>>,>>9.99 | Valor GGF 5 - moeda corrente | | |
val-ggf-5-moed-1 | Dec | >>,>>>,>>9.99 | Valor GGF 5 - moeda alternativa 1 | | |
val-ggf-5-moed-2 | Dec | >>,>>>,>>9.99 | Valor GGF 5 - moeda alternativa 2 | | |
val-ggf-6-corren | Dec | >>,>>>,>>9.99 | Valor GGF 6 - moeda corrente | | |
val-ggf-6-moed-1 | Dec | >>,>>>,>>9.99 | Valor GGF 6 - moeda alternativa 1 | | |
val-ggf-6-moed-2 | Dec | >>,>>>,>>9.99 | Valor GGF 6 - moeda alternativa 2 | | |
val-mdo-corren | Dec | ->>,>>>,>>9.99 | Valor mão-de-obra direta - moeda corrente | | |
val-mdo-moed-1 | Dec | ->>,>>>,>>9.99 | Valor mão-de-obra direta - moeda alternativa 1 | | |
val-mdo-moed-2 | Dec | ->>,>>>,>>9.99 | Valor mão-de-obra direta - moeda alternativa 2 | | |
val-nota-corren | Dec | ->>>,>>>,>>9.99 | Valor Nota Fiscal - moeda corrente | | |
val-nota-moed-1 | Dec | ->>>,>>>,>>9.99 | Valor Nota Fiscal - moeda alternativa 1 | | |
val-nota-moed-2 | Dec | ->>>,>>>,>>9.99 | Valor Nota Fiscal - moeda alternativa 2 | | |
val-item-corren | Dec | ->>>,>>>,>>9.99 | Valor item - moeda corrente | | |
val-item-moed-1 | Dec | ->>>,>>>,>>9.99 | Valor item - moeda alternativa 1 | | |
val-item-moed-2 | Dec | ->>>,>>>,>>9.99 | Valor Item - moeda alternativa 2 | | |
val-quant-transp | Dec | >,>>>,>>9.99 | Quantidade Transportada | | |
num-viagem | Int | >>,>>9 | Número de Viagens | | |
val-combust-corren | Dec | >>>,>>>,>>9.99 | Valor Total combustível na Moeda Corrente | | |
val-combust-moed-1 | Dec | >>>,>>>,>>9.99 | Valor Combustível na moeda alternativa 1 | | |
val-combust-moed-2 | Dec | >>>,>>>,>>9.99 | Valor Total de Combustível na moeda alternativa 2 | | |
val-lubrific-corren | Dec | >>>,>>>,>>9.99 | Valor de lubrificantes na moeda corrente | | |
val-lubrific-moed-1 | Dec | >>>,>>>,>>9.99 | Valor de lubrificantes na moeda alternativa 1 | | |
val-lubrific-moed-2 | Dec | >>>,>>>,>>9.99 | Valor de lubrificantes na moeda alternativa 2 | | |
val-filtro-corren | Dec | >>>,>>>,>>9.99 | Valor Total de filtros na moeda corrente | | |
val-filtro-moed-1 | Dec | >>>,>>>,>>9.99 | Valor total de filtros na moeda alternativa 1 | | |
val-filtro-moed-2 | Dec | >>>,>>>,>>9.99 | Valor dos filtros gastos na moeda alternativa 2 | | |
val-pneu-corren | Dec | >>>,>>>,>>9.99 | Valor total de pneus na moeda corrente | | |
val-pneu-moed-1 | Dec | >>>,>>>,>>9.99 | Valor de Pneus na moeda alternativa 1 | Sim | |
val-pneu-moed-2 | Dec | >>>,>>>,>>9.99 | Valor de Pneus na Moeda Alternativa 2 | Sim | |
val-serv-corren | Dec | >>>,>>>,>>9.99 | Valor dos serviços realizados por terceiros | Sim | |
val-serv-moed-1 | Dec | >>>,>>>,>>9.99 | Valor serviço terceiros na moeda alternativa 1 | Sim | |
val-serv-moed-2 | Dec | >>>,>>>,>>9.99 | Valor serviço terceiros na moeda alternativa 2 | Sim | |
val-deprec-corren | Dec | >>>,>>>,>>9.99 | Valor total da deperciação na moeda corrente | | |
val-deprec-moed-1 | Dec | >>>,>>>,>>9.99 | Valor total da deperciação na moeda 1 | | |
val-deprec-moed-2 | Dec | >>>,>>>,>>9.99 | Valor total da deperciação na moeda 2 | | |
cod-livre-1 | Char | x(100) | Character Livre | | |
cod-livre-2 | Char | x(100) | Character Livre | | |
log-livre-1 | Log | Sim/Não | Logical Livre | | |
log-livre-2 | Log | Sim/Não | Logical Livre | | |
num-livre-1 | Int | ->>>>>>>>9 | Inteiro Livre | | |
num-livre-2 | Int | ->>>>>>>>9 | Inteiro Livre | | |
val-livre-1 | Dec | ->>>>>>>>>>>9.9999 | Decimal Livre | | |
val-livre-2 | Dec | ->>>>>>>>>>>9.9999 | Decimal Livre | | |
dat-livre-1 | Date | 99/99/9999 | Data Livre | | |
dat-livre-2 | Date | 99/99/9999 | Data Livre | | |
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 | |
ErrorNumber | integer | padrão | Número do erro | Sim | |
ErrorDescription | char | padrão | Descrição do erro | Sim | |
ErrorParameters | char | padrão | Parâmetros passados para criar mensagem | Não | |
ErrorType | char | padrão | Tipo do erro: WARNING: Aviso ERROR: Erro | Sim | |
ErrorHelp | char | padrão | Texto de ajuda do erro | Sim | |
ErrorSubType | char | padrão | Sub Tipo da mensagem de erro | Não | |
Métodos
Quando a API/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 <date>, input <character>). |
Descrição | Reposiciona a query com base na chave primária da tabela. |
| Parâmetros | Descrição |
| pep-codigo | recebe valor do campo ep-codigo |
pcod-evento | recebe valor do campo cod-evento |
pdat-movto | recebe valor do campo dat-movto |
pcod-estabel | recebe valor do campo cod-estabel |
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 (input <integer>, input <character>, input <date>, input <character>). |
Descrição | Retorna os campos da chave primária da tabela. |
| Parâmetros | Descrição |
| pep-codigo | recebe valor do campo ep-codigo |
pcod-evento | recebe valor do campo cod-evento |
pdat-movto | recebe valor do campo dat-movto |
pcod-estabel | recebe valor do campo cod-estabel |
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
setConstraintCusto
Requisito | Nenhum |
Sintaxe | run setConstraintCusto in h-handle (input <integer>, input <integer>, input <character>, input <character>, input <date>, input <date>, input <character>, input <character>). |
Descrição | Recebe as faixas da Chave primária da tabela. |
| Parâmetros | Descrição |
| pi-ep-codigo-ini | Código da Empresa Inicial |
pi-ep-codigo-fim | Código da Empresa Final |
pc-cod-eqpto-ini | Código do Equipamento Inicial |
pc-cod-eqpto-fim | Código do Equipamento Final |
pdt-dat-movto-ini | Data do Movimento Inicial |
pdt-dat-movto-fim | Data do Movimento Final |
pc-cod-estabel-ini | Código do Estabelecimento Inicial |
pc-cod-estabel-fim | Código do Estabelecimento 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. |
openQueryCusto
Requisito | A setConstraintCusto ter sido executada anteriormente. |
Sintaxe | run openQueryCusto in h-handle. |
Descrição | Abre a query da BO conforme as restrições passadas na procedure setConstraintCusto. |
|
| 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. |
piDepreciacaoGrupo
Requisito | Nenhum |
Sintaxe | run piDepreciacaoGrupo in h-handle (input <character>, input <character>, input <character>, input <decimal>, input <decimal>, input <decimal>). |
Descrição | Atualiza Valores de Depreciação por Grupo de Equipamento. |
| Parâmetros | Descrição |
| pc-cod-grp-eqpto | Código do Grupo de Equipamento |
pc-cod-estabel | Código do Estabelecimento |
pc-dat-movto | Data do Movimento |
pde-val-corren | Valor total da depreciação na moeda corrente |
pde-val-moed-1 | Valor total da depreciação na moeda 1 |
pde-val-moed-2 | Valor total da depreciação na moeda 2 |
#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))