Documento de BO

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

RecordSet

Temp-Table principal utilizada para comunicação dos métodos da BO com o mundo externo e suas respectivas definições.

ttSolicServ
Atributo	Tipo	Formato	Descrição	Obr.
nr-soli-serv	inte	>>>,>>>,>>9	Solicitação Serviço	Sim
data	date	99/99/9999	Data	Sim
hora	char	x(8)	Hora
nome-usua	char	x(20)	Usuário
cc-codigo	char	x(8)	Centro Custo	Sim
tipo-solic	inte	9	Tipo Solic
dt-termino	date	99/99/9999	Data Término
dt-inicio	date	99/99/9999	Data Início
prioridade	inte	999	Prioridade	Sim
estado	inte	9	Estado	Sim
mot-cancelado	char	x(2000)	Motivo Cancelamento
dt-canc	date	99/99/9999	Data Cancelamento
mot-aguardo	char	x(2000)	Motivo Aguardo
dt-aguar	date	99/99/9999	Data Aguardo
parada	logi	Sim/Não	Manutenção Parada
cd-tag	char	x(16)	TAG	Sim
fm-equipto	char	x(8)	Família	Sim
cd-equip-res	char	x(8)	Equipe Responsável
cd-parada	char	x(8)	Parada
cd-manut	char	x(8)	Manutenção
cd-causa-padr	char	x(8)	Causa
cd-equipto	char	x(16)	Equipamento
cd-interv-padr	char	x(8)	Intervenção
cd-sint-padr	char	x(8)	Sintoma
char-1	char	x(100)
char-2	char	x(100)
dec-1	deci-8	->>>>>>>>>>>9.9
dec-2	deci-8	->>>>>>>>>>>9.9
int-1	inte	->>>>>>>>>9
int-2	inte	->>>>>>>>>9
log-1	logi	Sim/Não
log-2	logi	Sim/Não
data-1	date	99/99/9999
data-2	date	99/99/9999
cd-planejado	char	x(12)	Planejador
vl-orcado-mat	deci-2	->>>,>>>,>>9.99	Valor Orçado Material
vl-orcado-mob	deci-2	->>>,>>>,>>9.99	Valor Orçado MOB
check-sum	char	x(20)	Check-sum
plano-orig	char	X(12)	Plano Origem
descricao	char	x(50)	Descrição
r-Rowid	rowid		Rowid do registro na tabela Solic-Serv

Métodos Básicos

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

Método:

gotokey

Descrição:

Reposiciona o registro de Solicitação de Serviço através do número da Solicitação.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
nr-soli-serv	inte	>>>,>>>,>>9	X			Solicitação Serviço

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:

openQueryStatic (“Default”)

Descrição:

Busca conjunto de registros da tabela solic-serv.

Os registros são ordenados pelo número da Solicitação de Serviço.

Método:

openQueryStatic (“CausaPadrao”)

Descrição:

Busca conjunto de registros da tabela solic-serv com a Causa Padrão informada e conforme parâmetros informados (setContraintParametros).

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintCausaPadrao e setConstraintParametros.

Método:

openQueryStatic (“CdEquipRes”)

Descrição:

Busca conjunto de registros da tabela solic-serv com a Equipe dentro da faixa informada e com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintCdEquipRes e setConstraintParametros.

Método:

openQueryStatic (“CdEquipto”)

Descrição:

Busca conjunto de registros da tabela solic-serv com o Equipamento dentro da faixa informada e com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintCdEquipto e setConstraintParametros.

Método:

openQueryStatic (“CdTag”)

Descrição:

Busca conjunto de registros da tabela solic-serv com o Tag dentro da faixa informada e com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintCdTag e setConstraintParametros.

Método:

openQueryStatic (“Descricao”)

Descrição:

Busca conjunto de registros da tabela solic-serv com a Descrição dentro da faixa informada e com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintDescricao e setConstraintParametros.

Método:

openQueryStatic (“Equipe”)

Descrição:

Busca conjunto de registros da tabela solic-serv com a Equipe informada e conforme parâmetros informados (setContraintParametros).

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintEquipe e setConstraintParametros.

Método:

openQueryStatic (“Estados”)

Descrição:

Busca conjunto de registros da tabela solic-serv com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar o método setConstraintParametros.

Método:

openQueryStatic (“FmEquipto”)

Descrição:

Busca conjunto de registros da tabela solic-serv com a Família do Equipamento dentro da faixa informada e com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintFmEquipto e setConstraintParametros.

Método:

openQueryStatic (“IntervPadrao”)

Descrição:

Busca conjunto de registros da tabela solic-serv com a Intervenção Padrão informada e conforme parâmetros informados (setContraintParametros).

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintIntervPadrao e setConstraintParametros.

Método:

openQueryStatic (“MntPlanejador”)

Descrição:

Busca conjunto de registros da tabela solic-serv com o Planejador informado e conforme parâmetros informados (setContraintParametros).

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintMntPlanejador e setConstraintParametros.

Método:

openQueryStatic (“NomeUsua”)

Descrição:

Busca conjunto de registros da tabela solic-serv com o Usuário dentro da faixa informada e com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintNomeUsua e setConstraintParametros.

Método:

openQueryStatic (“NrSoliServ”)

Descrição:

Busca conjunto de registros da tabela solic-serv com o número da Solicitação de Serviço dentro da faixa informada e com os Estados informados.

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintNrSoliServ e setConstraintParametros.

Método:

openQueryStatic (“SintPadrao”)

Descrição:

Busca conjunto de registros da tabela solic-serv com o Sintoma Padrão informado e conforme parâmetros informados (setContraintParametros).

Os registros são ordenados pelo número da Solicitação de Serviço.

Constraints Associados:

Executar os métodos setConstraintSintPadrao e setConstraintParametros.

Método:

setConstraintCausaPadrao

Descrição:

Carrega variável com código da Causa Padrão.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pCd-causa-padr	char	x(8)		X			Causa

Método:

setConstraintCdEquipRes

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Equipe.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
p-equipe-ini	char	x(8)		X			Equipe Inicial
p-equipe-fim	char	x(8)		X			Equipe Final

Método:

setConstraintCdEquipto

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Equipamento.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
p-equipto-ini	char	x(16)		X			Equipamento Inicial
p-equipto-fim	char	x(16)		X			Equipamento Final

Método:

setConstraintCdTag

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Tag.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pCdTagIni	char	x(16)		X			Tag Inicial
pCdTagFim	char	x(16)		X			Tag Final

Método:

setConstraintData

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Datas.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pDataIni	date	99/99/9999		X			Data Inicial
pDataFim	date	99/99/9999		X			Data Final

Método:

setConstraintDescricao

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Descrição.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pDescricaoIni	char	x(50)		X			Descrição Inicial
pDescricaoFim	char	x(50)		X			Descrição Final

Método:

setConstraintEquipe

Descrição:

Carrega variável com código da Equipe.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pCd-equip-res	char	x(8)		X			Equipe Responsável

Método:

setConstraintFmEquipto

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Família de Equipamento.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pFmEquipamentoIni	char	x(8)		X			Família de Equipamento Inicial
pFmEquipamentoFim	char	x(8)		X			Família de Equipamento Final

Método:

setConstraintIntervPadrao

Descrição:

Carrega variável com código da Intervenção Padrão.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pCd-interv-padr	char	x(8)		X			Intervenção Padrão

setConstraintMntPlanejador

Descrição:

Carrega variável com código do Planejador.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pCd-planejado	char	x(12)		X			Planejador

Método:

setConstraintNomeUsua

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Usuário.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
p-usuario-ini	char	x(8)		X			Usuário Inicial
p-usuario-fim	char	x(8)		X			Usuário Final

Método:

setConstraintNrSoliServ

Descrição:

Carrega variáveis com os as valores inicial e final para faixa de Solicitação de Serviço.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pNrSoliServIIni	int	>>>,>>>,>>9		X			Solicitação de Serviço Inicial
pNrSoliServIFim	int	>>>,>>>,>>9		X			Solicitação de Serviço Final

Método:

setConstraintParametros

Descrição:

Carrega variáveis com os parâmetros relacionados abaixo.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
p-pendente	log			X			Considera SS com estado igual a Pendente
p-aprovada	log			X			Considera SS com estado igual a Aprovada
p-aberta-ordem	log			X			Considera SS com estado igual a Aberta Ordem
p-cancelada	log			X			Considera SS com estado igual a Cancelada
p-encerrada	log			X			Considera SS com estado igual a Encerrada
p-usuario-ini	char	x(8)		X			Usuário Inicial
p-usuario-fim	char	x(8)		X			Usuário Final
p-equipto-ini	char	x(16)		X			Equipamento Inicial
p-equipto-fim	char	x(16)		X			Equipamento Final
p-cc-codigo-ini	char	x(8)		X			Centro Custo Inicial
p-cc-codigo-fimi	char	x(8)		X			Centro Custo Final
p-planejador-ini	char	x(12)		X			Planejador Inicial
p-planejador-fim	char	x(12)		X			Planejador Final
p-equipe-ini	char	x(8)		X			Equipe Inicial
p-equipe-fim	char	x(8)		X			Equipe Final

setConstraintSintPadrao

Descrição:

Carrega variável com código do Sintoma Padrão.

Parâmetros:

Parâmetro	Tipo		Formato	I	O	IO	Descrição
pCd-sint-padr	char	x(8)		X			Sintoma Padrão

Método:

linkToCausaPadrao

Descrição:

Seta as variáveis de controle para criar o linkTo com a tabela pai “Causa-Padrao” contendo o campo cd-causa-padr.

Requisitos:

Posicionar a query do BO de Causa-Padrao no registro desejado.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pHandle	Handle		X			Handle BO da tabela Causa Padrão

Método:

linkToEquipe

Descrição:

Seta as variáveis de controle para criar o linkTo com a tabela pai “Equipe” contendo o campo cd-equip-res.

Requisitos:

Posicionar a query do BO de Equipe no registro desejado.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pHandle	Handle		X			Handle BO da tabela Equipe

Método:

linkToEquipto

Descrição:

Seta as variáveis de controle para criar o linkTo com a tabela pai “Equipto” contendo o campo cd-equipto.

Requisitos:

Posicionar a query do BO de Equipto no registro desejado.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pHandle	Handle		X			Handle BO da tabela Equipamento

Método:

linkToIntervPadr

Descrição:

Seta as variáveis de controle para criar o linkTo com a tabela pai “Interv-Padr” contendo o campo cd-interv-padr.

Requisitos:

Posicionar a query do BO de Interv-Padr no registro desejado.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pHandle	Handle		X			Handle BO da tabela Intervenção Padrão

Método:

linkToMntPlanejador

Descrição:

Seta as variáveis de controle para criar o linkTo com a tabela pai “Mnt-Planejador” contendo o campo cd-planejado.

Requisitos:

Posicionar a query do BO de Mnt-Planejador no registro desejado.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pHandle	Handle		X			Handle BO da tabela Planejador

Método:

linkToSintPadrao

Descrição:

Seta as variáveis de controle para criar o linkTo com a tabela pai “Sint-Padrao” contendo o campo cd-sint-padr.

Requisitos:

Posicionar a query do BO de Sint-Padr no registro desejado.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pHandle	Handle		X			Handle BO da tabela Sintoma Padrão

Métodos Negócio

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

Método:

carregaPlanos

Descrição:

Retorna a lista dos tipos de vinculações existentes com o código da manutenção, equipamento e tag informados.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pCdManut	char	x(08)	X			Código da Manutenção
pCdEquipto	char	x(16)	X			Equipamento
pCdTag	char	x(16)	X			Código do Tag
pListaPlanos	char			X		Lista com a descrição das vinculações

Método:

criaOrdManut

Descrição:

Para cada registro da temp-table ttOrdem gerado pelo método gerattOrdem deve-se executar esse método, no qual será criada a Ordem de Manutenção. Os campos recebidos por este método são os mesmos da temp-table ttOrdem do método gerattOrdem.

Requisitos:

Executar o método gerattOrdem.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
iNrOrdProdu	int		X			Número da Ordem de Manutenção
Descricao	char	X(50)	X			Descrição da Ordem de Manutenção
pCdEquipto	char	X(16)	X			Equipamento
pCdManut	char	X(08)	X			Código da Manutenção
iCdTipo	int		X			Tipo de Manutenção
daManut	date	99/99/9999	X			Data da Ordem de Manutenção
cPlanoOrig	char		X			Plano de Origem da Manutenção da Ordem
iNrSoliServPai	int		X			Número da SS Pai (geradora da Ordem)

Método:

findSolicServAtivaEquipto

Descrição:

Verifica se existe alguma Solicitação com o Equipamento informado e com estado diferente de Cancela ou Encerrada, retornando "OK" caso encontre e "NOK" caso não encontre.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pCdEquipto	Char	X(16)	X			Equipamento

Método:

findSolicServAtivaTag

Descrição:

Verifica se existe alguma Solicitação com o Tag informado e com estado diferente de Cancela ou Encerrada, retornando "OK" caso encontre e "NOK" caso não encontre.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pCdTag	Char	X(16)	X			Tag

Método:

geraNrSolicServ

Descrição:

Procura e retorna o número da próxima Solicitação de Serviço após o número de Solicitação informado (Caso informe ?, o método usará a próxima Solicitação dos Parâmetros de MI como base para procurar a próxima).

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pNrSoliServBase	int		X			Número Solicitação base para cálculo da próxima
pNrSoliServProx	Int			X		Número da Próxima Solicitação.

gerattOrdem

Descrição:

Gera temp-table com as possíveis Ordens de Manutenção a serem criadas a partir das Solicitações informadas, agrupadas conforme informado.

Temp-Tables:

define temp-table ttSolicServOrdem no-undo

field nr-soli-serv as integer

field cd-equipto as char

field nr-soli-pai as integer. /* campo de uso interno do método */

define temp-table ttOrdem no-undo

field nr-ord-produ as integer

field descricao as char

field cd-equipto like solic-serv.cd-equipto

field cd-manut like solic-serv.cd-manut

field cd-tipo as integer

field cd-tag like solic-serv.cd-tag

field plano-orig like solic-serv.plano-orig

field da-manut like solic-serv.dt-inicio

field nr-soli-pai as integer.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
iFormaAgrup	int		X			Recebe forma de agrupamento: 1 - Para um Equipamento; 2 - Por Equipamento; 3 - Não Agrupar
ttSolicServOrdem	table		X			Temp-table com Solicitações de Serviço
ttOrdem	table			X		Temp-table com possíveis Ordens de Manutenção

Método:

getttSolicServ

Descrição:

Retorna temp-table com Solicitações conforme parâmetros setados nos setConstraints e apenas Solicitações que não possuam documentos pendentes.

Temp-Table: define temp-table ttSolicServAux no-undo

like solic-serv

field r-Rowid as rowid

field ind as logical init no.

Requisitos:

Executar métodos: setConstraintParametros, setConstraintCdTag e setConstraintData

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
ttSolicServAux	table			X		Temp-table com Solicitações Serviço

Método:

retornaSolicServAprovador

Descrição:

Retorna temp-table com informações das Solicitações de Serviço do Aprovador (conforme variável global gr-aprovador). As Solicitações são aquelas que possuem documentos pendentes de aprovação com o Aprovador.

Temp-Table: def temp-table tt-solic-serv

field descricao like solic-serv.descricao

field nr-soli-serv like solic-serv.nr-soli-serv

field cd-equipto like solic-serv.cd-equipto

field cd-tag like solic-serv.cd-tag

field fm-equipto like solic-serv.fm-equipto

field nome-usua like solic-serv.nome-usua

field cc-codigo like solic-serv.cc-codigo

field data like solic-serv.data

field parada like solic-serv.parada

field cd-parada like solic-serv.cd-parada

field estado like solic-serv.estado

field vl-orcado-mat like solic-serv.vl-orcado-mat

field vl-orcado-mob like solic-serv.vl-orcado-mob

field rowid-ss as rowid.

Requisitos:

Executar métodos: setConstraintParametros, setConstraintCdTag e setConstraintData

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
ttSolicServAux	table			X		Temp-table com Solicitações Serviço

Método:

retornattSolicServTag

Descrição:

Retorna Solicitações do Tag informado, ou dos Tag que pertencem a estrutura do Tag informado. Considera Solicitações com os estados iguais aos setados.

Temp-Table: def temp-table ttSolicServTag no-undo

field nr-soli-serv like solic-serv.nr-soli-serv

field descricao like solic-serv.descricao

field nome-usua like solic-serv.nome-usua

field cd-tag like solic-serv.cd-tag

field cd-equipto like solic-serv.cd-equipto

field fm-equipto like solic-serv.fm-equipto

field cd-manut like solic-serv.cd-manut

field cc-codigo like solic-serv.cc-codigo

field cd-equip-res like solic-serv.cd-equip-res

field cd-planejado like solic-serv.cd-planejado

field estado like solic-serv.estado

field prioridade like solic-serv.prioridade

field dt-inicio like solic-serv.dt-inicio

field dt-termino like solic-serv.dt-termino

field vl-orcado-mob like solic-serv.vl-orcado-mob

field vl-orcado-mat like solic-serv.vl-orcado-mat

field r-Rowid as rowid.

Requisitos:

Executar métodos: setConstraintParametros.

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pCdTag	char	X(16)	X			Tag
ttSolicServTag	table			X		Temp-table com Solicitações Serviço do Tag

Método:

retornaValorOrcado

Descrição:

Calcula e retorna os valores orçados de Material e Mão-de-Obra de uma Manutenção.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pCdManut	char	x(8)	X			Manutenção
c-op-preco	char	x(1)	X			tipo de preco 1 – Medio; 2 – Reposicao; 3 – Ultima entrada; 4 – Base
i-moeda	int		X			Moeda em que será calculado:1 – corrente; 2 - moeda 2; 3 - moeda 3
de-tot-mat	dec			X		Valor orçado de Material
de-tot-mob	dec			X		Valor orçado de Mão-de-Obra

setaTextoSolicServ

Descrição:

Grava o valor do Texto Livre da Solicitação na variável c-msg-exp, para posterior uso na chamada dos métodos criaTextoSolicServ e alteraTextoSolicServ do bomn126.p (BO Msg-Solic-Serv).

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pMsgExp	char	x(15000)	X			Texto Livre da Solicitação de Serviço

setaValorOrcado

Descrição:

Atualiza valores orçados de Material e Mão-de-obra da Solicitação de Serviço com o rowid informado.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
rSolicServ	rowid		X			Rowid do registro na tabela solic-serv
de-tot-mat	dec		X			Valor orçado de Material
de-tot-mob	dec		X			Valor orçado de Mão-de-Obra

setConstraintTipoClassific

Descrição:

Atualiza o valor da variável “tipo de classificação”, utilizada na abertura de query’s.

Requisitos: Nenhum

Parâmetros:

Parâmetro	Tipo	Formato	I	O	IO	Descrição
pTipoClassific	Int		X			Tipo de Classificação

Documento de BO

RecordSet

Métodos Básicos

X

Queries e Constraints

Métodos Negócio

X

X

X

X

X