Histórico da Página

Objetivo

Funcionamento

Tabelas Temporárias

Métodos

Árvore de páginas

Versões comparadas

Chave

Objetivo

Funcionamento

Tabelas Temporárias

Métodos

goToKey

getKey

getCharField

getDateField

getDecField

getDecField

getIntField

getLogField

getRawField

getRecidField

getRecidField

getRowid

setConstraintCodPneu

setConstraintMpn-pneu

openQueryCodPneu

openQueryMain

openQueryMpn-pneu

validateRecord

afterCreateRecord

afterUpdateRecord

atualizaSulco

beforeUpdateRecord

buscaItem

buscaValor

Versão antiga 1

Nova versão Atual

goToKey

getKey

getCharField

getDateField

getDecField

getDecField

getIntField

getLogField

getRawField

getRecidField

getRecidField

getRowid

setConstraintCodPneu

setConstraintMpn-pneu

openQueryCodPneu

openQueryMain

openQueryMpn-pneu

validateRecord

afterCreateRecord

afterUpdateRecord

atualizaSulco

beforeUpdateRecord

buscaItem

buscaValor

...

Produto:	Datasul
Ocorrência:	Documentação de BO
Nome Físico	frbo/bofr045

Validação, Manutenção e acesso rápido a tabela “mpn-histor-vida”.

A BO irá validar os dados, manutenir a tabela e fazer a leitura dos registros da tabela “mpn-histor-vida”.

...

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da BO.

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 “mpn-histor-vida”.	Entrada/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

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

...

Método Básico

Requisito	Nenhum
Sintaxe	run goToKey in h-handle (input <character>, input <integer>).
Descrição	Reposiciona a query com base na chave primária da tabela.
	Parâmetros	Descrição
	pcod-pneu	Código do Pneu
	pnum-vida	Número da Vida do Pneu
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.

Requisito	Nenhum
Sintaxe	run getKey in h-handle (output <character>, output <integer>).
Descrição	Retorna os campos da chave primária da tabela.
	Parâmetros	Descrição
	pcod-pneu	Código do Pneu
	pnum-vida	Número da Vida do Pneu
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.

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.

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.

...

Requisito

Nenhum

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.

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.

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.

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.

...

Requisito

Nenhum

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

...

Requisito	Ser chamado somente quando há o Join entre a tabela em questão e a tabela mpn-pneu.
Sintaxe	run linkToMpn-Pneu in h-handle (input <hanlde>).
Descrição	Faz o JOIN entre as tabelas “mpn-pneu” e “mpn-histor-vida”. Recebe como parâmetro o handle da BO da tabela mpn-pneu, para buscar a chave primária da mesma (do registro corrente na BO), para setar as restrições “setConstraintMpn-pneu”.
	Parâmetros	Descrição
	pHandle	Handle da BO “mpn-pneu” (Pneu).
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.

Requisito	Nenhum
Sintaxe	run setConstraintCodPneu in h-handle (input <character>, input <character>).
Descrição	Seta as restrições para abrir a query para uma faixa de pneus.
	Parâmetros	Descrição
	pCodPneuIni	Código do Pneu Inicial
	pCodPneuFim	Código do Pneu 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.

Requisito	Nenhum
Sintaxe	run setConstraintMpn-pneu in h-handle (input <character>).
Descrição	Seta as restrições para abrir a query para um pneu.
	Parâmetros	Descrição
	pCodPneu	Código do Pneu
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.

Requisito	A setConstraintCodPneu ter sido executada anteriormente.
Sintaxe	run openQueryCodPneu in h-handle.
Descrição	Abre a query da BO conforme a faixa de código do pneu passado na procedure setConstraintCodPneu.
	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.

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.

RowErrors.

Requisito	A setConstraintMpn-pneu ter sido executada anteriormente.
Sintaxe	run openQueryMpn-pneu in h-handle.
Descrição	Abre a query da BO conforme o código do pneu passado na procedure setConstraintMpn-pneu.
		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

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.

Requisito	Procedure chamada pelo método interno CreateRecord. Não deve ser chamada externamente.
Sintaxe	run afterCreateRecord in this-procedure.
Descrição	Atualiza os campos de Valor do Sulco da tabela mpn-pneu (Pneu).
	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....

Requisito	Procedure chamada pelo método interno UpdateRecord. Não deve ser chamada externamente.
Sintaxe	run afterUpdateRecord in this-procedure.
Descrição	Atualiza os campos de Valor do Sulco da tabela mpn-pneu (Pneu).
		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....

..

Requisito	Nenhum
Sintaxe	run atualizaSulco in h-handle (input <character>, input table RowObject).
Descrição	Atualiza campos internos que não aparecem no cadastro do programa pai (mpn-pneu) e são atualizados na movimentação dos pneus. (Localização Atual do Pneu) Atualiza os valores dos sulcos do pneu.
		Parâmetros	Descrição
	pCodPneu	Código do Pneu
	RowObject	Temp-Table Comunicação da tabela mpn-histor-vida (Histórico Vida Pneu)
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....

Requisito	Procedure chamada pelo método interno UpdateRecord. Não deve ser chamada externamente.
Sintaxe	run beforeUpdateRecord in this-procedure.
Descrição	Validação para atualizar os valores dos sulcos da tabela mpn-pneu (Pneu), se ocorreu a Ressulcagem (pn0302).
	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....

Requisito	Nenhum
Sintaxe	run buscaItem in h-handle (input <character>, input <character>, input <integer>, output <character>).
Descrição	Retorna o código do item registrado no Percurso padrão por Desenho/Medida/Vida, como sugestão na inclusão do registro.
	Parâmetros	Descrição
	pCodDesen	Código do Desenho
	pCodMedid	Código da Medida
	pNumVida	Vida
	pItem	Código do Item
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 valor para o return-value é OK (execução correta). O código do Item retornará em branco quando não achar nenhum Percurso que satisfaça os parâmetros.

Requisito	Nenhum
Sintaxe	run buscaValor in h-handle (input <character>, input <character>, output <decimal>).
Descrição	Retorna o valor atual do item no estoque, como sugestão na inclusão do registro.
		Parâmetros	Descrição
	pCodEstabel	Código do Estabelecimento
	pItCodigo	Código do Item
	Pvalor	Valor atual do item no 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 valor para o return-value é OK (execução correta). O valor do Item retornará zero quando não achar movimento no estoque que satisfaça os parâmetros.

Requisito

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.