Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físico

 frbo/bofr117

 

Objetivo

Validação, Manutenção e acesso rápido a tabela “mnd-movto-process”.

 

Funcionamento

A BO irá validar os dados, manutenir a tabela e fazer a leitura dos registros da tabela “mnd-movto-process”.

...

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:

...

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>).

Descrição

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

 

 

Parâmetros

Descrição

 

pnum-docto

Código 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.

    

getKey

  

Requisito

Nenhum

Sintaxe

run getKey in h-handle (output <integer>).

 

Descrição

Retorna os campos da chave primária da tabela.

 

 

Parâmetros

Descrição

 

pnum-docto

Código 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.

 

   

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.

 

   


OpenQuery / SetConstraint / LinkTo

setConstraintData

    

Requisito

Nenhum

Sintaxe

run setConstraintData in h-handle (input <date>,

                                   input <date>

                                   input <date>,

                                   input <date>,

                                   input <logical>,

                                   input <logical>

                                   input <logical>,

                                   input <logical>).

Descrição

Seta as restrições para abrir a query por faixa de datas.

 

Parâmetros

Descrição

 

pDtIncialIni

Data Inicial

 

pDtIncialFim

Data Inicial Final

 

pDtFinalIni

Data Final Inicial

 

pDtFinalFim

Data Final

 

pAberto

Aberto (Sim\Não)

 

pTerminado

Terminado (Sim\Não)

 

pCancelado

Cancelado (Sim\Não)

 

pSuspenso

Suspenso (Sim\Não)

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.

 

   

setConstraintDocto

    

Requisito

Nenhum

Sintaxe

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

                                   input <integer>,

                                   input <logical>,

                                   input <logical>,

                                   input <logical>,

                                   input <logical>).

Descrição

Seta as restrições para abrir a query por faixa de Código de Documento.

 

Parâmetros

Descrição

 

pDoctoIni

Código Documento Inicial

 

pDoctoFim

Código Documento Final

 

pAberto

Aberto (Sim\Não)

 

pTerminado

Terminado (Sim\Não)

 

pCancelado

Cancelado (Sim\Não)

 

pSuspenso

Suspenso (Sim\Não)

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

                                   input <integer>,

                                   input <logical>,

                                   input <logical>

                                   input <logical>,

                                   input <logical>).

Descrição

Seta as restrições para abrir a query por faixa de Código de Empresa e Código de Equipamento.

 

Parâmetros

Descrição

 

pEmpIni

Código Empresa Inicial

 

pEmpFim

Código Empresa Final

 

pEqptoIni

Código Equipamento Inicial

 

pEqptoFim

Código Equipamento Final

 

pAberto

Aberto (Sim\Não)

 

pTerminado

Terminado (Sim\Não)

 

pCancelado

Cancelado (Sim\Não)

 

pSuspenso

Suspenso (Sim\Não)

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.

 

   

setConstraintProcesso

    

Requisito

Nenhum

Sintaxe

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

                                       input <character>,

                                       input <logical>,

                                       input <logical>,

                                       input <logical>,

                                       input <logical>).

Descrição

Seta as restrições para abrir a query por faixa de Código de Processo.

 

Parâmetros

Descrição

 

pProcessoIni

Código do Processo Inicial

 

pProcessoFim

Código do Processo Final

 

pAberto

Aberto (Sim\Não)

 

pTerminado

Terminado (Sim\Não)

 

pCancelado

Cancelado (Sim\Não)

 

pSuspenso

Suspenso (Sim\Não)

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.

 

   

openQueryData

  

Requisito

A setConstraintData  ter sido executada anteriormente.

Sintaxe

run openQueryData in h-handle.

 

Descrição

Abre a query da BO conforme a faixa de Data.

 

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.

 

  

 

openQueryDocto

   

Requisito

A setConstraintDocto ter sido executada anteriormente.

Sintaxe

run openQuerydocto in h-handle.

Descrição

Abre a query da BO conforme a faixa de Código de Documento.

 

 

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 da BO conforme a faixa de Código 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.

    

openQueryProcess

   

Requisito

A setConstraintProcess ter sido executada anteriormente.

 

Sintaxe

run openQueryProcess in h-handle.

Descrição

Abre a query da BO conforme a faixa de Código de Processo.

 

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.

 

    

afterCreateRecord

 

Requisito

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

 

Sintaxe

run afterCreateRecord in h-handle.

 

Descrição

Realiza override após criação de algum registro.

 

 

Parâmetros

Descrição

 

Nenhum

 

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

 

   

beforeCreateRecord

   

Requisito

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

Sintaxe

run beforeCreateRecord in h-handle.

 

Descrição

Realiza override antes da criação de algum registro.

 

Parâmetros

Descrição

 

Nenhum

 

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 h-handle.

Descrição

Realiza override antes de eleminar algum registro.

 

Parâmetros

Descrição

 

Nenhum

 

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

 

    

beforeUpdateRecord

   

Requisito

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

Sintaxe

run beforeUpdateRecord in h-handle.

Descrição

Realiza override antes de alterar algum registro.

 

 

Parâmetros

Descrição

 

Nenhum

 

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

 

  

 

atualizaSituacaoEquipamento

 

Requisito

Nenhum

Sintaxe

run atualizaSituacaoEquipamento in this-procedure.

 

Descrição

Atualiza situação dos equipamentos nos parâmetros de documentação.

 

 

Parâmetros

Descrição

 

Nenhum

 

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

 

    

buscaDocumento

 

Requisito

Nenhum

 

Sintaxe

run buscaDocumento in h-handle (output <integer>).

 

Descrição

Busca a próxima numeração do documento.

Os valores não podem ser menor que 1900.

 

 

Parâmetros

Descrição

 

pDoc

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 tt-erro....

 

   

buscaTTMovto

  

Requisito

Ser executado apenas quando é feita uma cópia de registro.

 

Sintaxe

run buscaTTMovto in h-handle (input <Rowid>,

                             output <temp-table>).

Descrição        

Realiza uma busca utilizando o rowid da tabela origem afim de recuperar todos os dados da mesma.

 

 

Parâmetros

Descrição

 

PRowid

Rowid da tabela

 

ttMovto

Temp-Table utilizada para armazenar os dados da tabela buscada.

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

 

   

verificaProcessosEqpto

   

Requisito

Nenhum.

Sintaxe

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

                                        input <character>).

Descrição

Realiza verificações nos processo que possuem determinado Equipamento.

 

 

Parâmetros

Descrição

 

pEmpresa

Código da Empresa

 

pEqpto

Código do Equipamento

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

 

   

atualizaMovimentos

  

Requisito

Procedure para uso interno.

Sintaxe

RUN atualizaMovimentos IN h-handle (input <date>,

                                    input <character>).

Descrição

Realiza a atualização das Parcelas “Movimentos de Eventos” relacionados ao documento de Processo Administrativo.

 

Parâmetros

Descrição

 

pDateFinal

Data de término da Parcela “Movimentos de Eventos”

 

pHorFinal

Hora de término da Parcela “Movimentos de Eventos”

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.

 

 

  

 

linkToEvento

Requisito

Procedure para uso interno.

 

Sintaxe

    {masterdetail/openqueriesson.i &Parent="Evento"

                                   &Query="Evento"

                                   &PageNumber="2"}

Obs.: Utilizado na abertura de  query 

 

Descrição

Utilizada para busca de relacionamento de registro Pai/Filho.

 

 

 

Parâmetros

Descrição

 

pHandle

Handle

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).

 

 

 

    

openQueryEvento

  

Requisito

A setConstraintEvento  ter sido executada anteriormente.

 

Sintaxe

run openQueryEvento in h-handle.

 

Descrição

Abre a query da BO conforme o número de documento passado na procedure setConstraintEvento

 

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.

 

  

 

removeMovimentos

  

Requisito

Procedure para uso interno.

Sintaxe

RUN removeMovimentos IN h-handle.

Descrição

Remove todas as Parcelas “Movimentos de Eventos” relacionados ao documento de Processo Administrativo.

 

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.

 

 

   

setConstraintEvento

   

Requisito

Nenhum

Sintaxe

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

Descrição

Seta as restrições para abrir a query por faixa do Número do Documento.

 

 

Parâmetros

Descrição

 

pNumDocto

Número do Documento do Processo Administrativo

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.