Histórico da Página

...

Produto:	Datasul
Ocorrência:	Documentação de BO
Nome Físico	mnbo/bomn249.p

Objetivo

Validação e gravação dos dados da tabela mi-histor-eqpto, mantendo então um histórico do equipamento.

...

RecordSet

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

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

A sintaxe para a chamada BO é:

run mnbo\bomn245.p.

A execução na forma persistente ...

A sintaxe para executar a BO em modo persistente é:

run mnbo\bomn245.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 “mi-histor-eqpto”.	Entrada/Saída

Unid-negoc-equipto

tt-item-controle
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução	Obr.
Cod-eqptocd-equipto	Char	X(16)	Código do Equipamento	Sim / Key	001
Dat-histor	Date	99/99/9999	Histórico	Sim	001
Ep-codigo	Int	>>9	Código da Empresa do Equipamento	Não	001
Yes
Cod-unid-negoc	Char	Cód-estabel	char	X(3)	Código do Estabelecimento do Equipamento	Não	001
cc-codigo	Char	X(8)	Centro de Custo	Não	001
cd-tag	Char	X(16)	Código do TAG do Equipamento	Não	001
Dsl-obs	Char	X(2000)	Observação	Não	001
da Unidade de Negócio	Yes
Val-perc-unid-neg	Dec	>>9.9999	Percentual Unidade de Negócio	Yes
Codcod-livre-1	charChar	xX(100)	Character Livre	Não	001
codCod-livre-2	charChar	xX(100)	Character Livre	Não	001
logDat-livre-1log	Date	Sim99/99/Não999	Logical Livre	Não	001
LogDat-livre-2Log	Date	Sim99/99/Não999	Logical Livre	Não	001
Num-livre-1	intInt	->>>>>>>>9>>>>>>>>>9	Inteiro Livre	Não	001
Num-livre-2	Int	->>>>>>>>9>>>>>>>>>9	Inteiro Livre	Não	001
Val-livre-1	decDec	->>>>>>>>>>>9.9999	Decimal Livre	Não		001
Val-livre-2	Dec	->>>>>>>>>>>9.9999	Decimal Livre	Não	001
DatLog-livre-1	Datelog	99SIM/99/9999	Date Livre	Não	001	NAO
LogDat-livre-2	Datelog	99SIM/99/9999	Date Livre	Não	001
Idi-sit-eqpto	Int	>9	Situação do Equipamento	Não	001
Idi-sit-histor	Int	>9	Situação Histórico	Não	001

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

Métodos

Métodos Básicos

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

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
	Pcd-equipto	Código do Equipamento
	Pdat-histor	Data do histórico
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.

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
	Pcd-equipto	Código do Equipamento
	Pdat-histor	Data do Histórico
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.

openQueryDefault

Requisito	Nenhum
Sintaxe	run openQueryDefault 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étodos de Negócio

validateRecord

NAO

Métodos Básicos

Métodos básicos de acesso ao banco de dados.

Método:

getCharField

Descrição: Retorna valor de campos do tipo caracter.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
PFieldName	Char		X			Campo
PfieldValue	Char			X		Valor

Método:

getDateField

Descrição: Retorna o valor de campos do tipo data.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pFieldName	char		X			Campo
PFieldValue	Data			X		Valor

Método:

getDecField

Descrição: Retorna o valor de campos do tipo decimal.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
PFieldName	char		X			Campo
pFieldValue	Dec			X		Valor

Método:

getIntField

Descrição: Retorna o valor de campo do tipo inteiro.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
PfieldName	Char		X			Campo
PfieldValue	Int			X		Valor

Método:

getKey

Descrição: Retorna o valor dos campos do índice id.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
Pcod-eqpto	Char			X		Código Equipamento
pCod-unid-negoc	Char			X		Código Unidade de Negócio

Método:

getLogField

Descrição: Retorna o valor de campos do tipo lógico.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
PfieldName	Char		X			Campo
PfieldValue	Log			X		Valor

Método:

getRawField

Descrição: Retorna o valor de campos do tipo raw.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
PfieldName	Char		X			Campo
PfieldValue	Raw			X		Valor

Método:

getRecidField

Descrição: Retorna o valor de campos do tipo recid.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
PfieldName	Char		X			Campo
PfieldValue	recid			X		Valor

Método:

goToKey

Descrição: Reposiciona registro com base no índice id.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
Pcod-eqpto	Char		X			Código Equipamento
Cod-unid-negoc	Char		X			Código Unidade de Negócio

Queries e Constraints

Definição das Queries (acesso ao banco de dados) e Contraints (regras de leitura) utilizadas para buscar grupos de registros da base de dados.

Método:

openQueryMain

Descrição:

Abre a query com todos os registros existentes da tabela unid-negoc-eqpto

Métodos Negócio

Métodos adicionais de atualização e acesso a base de dados.

Método:

ValidateRecord

Descrição: Validações pertinentes ao DBO.

Requisitos:

Parâmetros:

Parâmetro	Tipo	I	O	IO	Descrição
PType	Char	X			Recebe o tipo de validação

Método:

CarregaTTAux

Descrição: Carrega a temp-table ttUnidNegocioAux com as Unidade de Negócio da Ordem do Equipamento.

Parâmetros:

Parâmetro	Tipo	I	O	IO	Descrição
PC-cod-eqpto	Char	X			Código Equipamento
ttUnidNegocioAux	Temp-table	X			Temp-table com Matriz Unidade de Negócio Eqpto

Método:

CriaTTAux

Descrição: Carrega a temp-table ttUnidNegocioAux, com as unidades de negócio do Equipamento original, para posterior reutilização.

Parâmetros:

Parâmetro	Tipo	I	O	IO	Descrição
PC-cod-eqpto	Char	X			Código Equipamento
ttUnidNegocioAux	Temp-table		X		Temp-table com Matriz Unidade de Negócio Eqpto

Método:

criattUnidNegocEqpto

Descrição: Carrega a temp-table ttUnidNegocio com a matriz de Unidade de Negócio do Equipamento passada como parâmetro.

Parâmetros:

Parâmetro	Tipo	I	O	IO	Descrição
c-par-equipto	Char	X			Código do Equipamento
ttUnidNegocio	Temp-table		X	X	Temp-table com Matriz Unidade de Negócio Eqpto

Método:

deleteUnidNegocEqpto

Descrição: Deleta toda a matriz de Unidade de Negócio do equipamento passado como parâmetro.

Parâmetros:

Parâmetro	Tipo	I	O	IO	Descrição
PC-cod-eqpto	Char	X			Código Equipamento

Método:

validaPercentual

Descrição: Valida o percentual das unidades de negócio gravado para a mesma Ordem de Manutenção, sendo que essas tem de fechar na somatória 100%.

Parâmetros:

Parâmetro	Tipo	I	O	IO	Descrição
PC-cod-eqpto	Char	X			Código Equipamento
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.

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Objetivo

RecordSet

Tabelas Temporárias

Métodos

Métodos Básicos

getCharField

getDateField

getDecField

getIntField

getKey

getLogField

getRawField

getRecidField

goToKey

openQueryDefault

Métodos de Negócio

validateRecord

Métodos Básicos

Queries e Constraints

Métodos Negócio