Assunto

Produto:	Datasul
Ocorrência:	Documentação de BO
Nome Físico:	inbo/boin796.p
Include com Parâmetros:	Inbo/boin796.i
Banco	mgind
Tabela	mla-lista-aprov-fam

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela mla-lista-aprov-fam (Lista de aprovadores da família).

Funcionamento

Na forma padrão, realiza-se a chamada através de um comando RUN normal, passando-se as temp-tables carregadas com as informações necessárias.

A execução na forma persistente é realizada através da chamada de um comando RUN conforme exemplo a seguir.

A sintaxe para executar a BO em modo persistente é:

RUN inbo/boin796.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 de entrada e saída:

RowObject					Entrada/Saída
Lista de aprovadores da família					Entrada/Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
seq-aprov	integer	>9	Sequência de aprovação	Sim
cod-usuar	character	X(12)	Aprovador	Não
fm-codigo	character	X(8)	Família	Sim
char-1	character	x(100)		Não
char-2	character	x(100)		Não
dec-1	decimal	->>>>>>>>>>>9.99999999		Não
dec-2	decimal	->>>>>>>>>>>9.99999999		Não
int-1	integer	>>>>>>>>>9		Não
int-2	integer	>>>>>>>>>9		Não
log-1	logical	Sim/Não		Não
log-2	logical	Sim/Não		Não
data-1	date	99/99/9999		Não
data-2	date	99/99/9999		Não
char-3	character	x(100)		Não
char-4	character	x(100)		Não
char-5	character	x(100)		Não
dec-3	decimal	->>>>>>>>>>>9.99999999		Não
dec-4	decimal	->>>>>>>>>>>9.99999999		Não
dec-5	decimal	->>>>>>>>>>>9.99999999		Não
int-3	integer	>>>>>>>>>9		Não
int-4	integer	>>>>>>>>>9		Não
int-5	integer	>>>>>>>>>9		Não
log-3	logical	Sim/Não		Não
log-4	logical	yes/no		Não
log-5	logical	yes/no		Não
data-3	date	99/99/9999		Não
data-4	date	99/99/9999		Não
data-5	date	99/99/9999		Não
ep-codigo	character	x(3)	Empresa	Sim
cod-estabel	character	x(5)	Estabelecimento	Sim

tt-lista-aprov-fam-origem					Entrada/Saída
Lista de aprovadores da família(do usuário origem – Utilizado pela procedure piSubstituiAprovador). Obs: Mesmos campos da temp-table RowObject, mais os definidos abaixo.					Entrada/Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
id-sit	integer		Situação	Não
situacao	character	x(20)	Descrição da situação	Não
r-rowid	rowid		Rowid do registro	Não

tt-lista-aprov-fam-destino					Entrada/Saída
Lista de aprovadores da família(do usuário destino – Utilizado pela procedure piSubstituiAprovador). Obs: Mesmos campos da temp-table tt-lista-aprov-fam-origem.					Entrada/Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução

tt-lista					Entrada/Saída
Lista de aprovadores.					Entrada/ Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
seq-aprov	integer	>9	Sequência de aprovação	Sim
cod-usuar-aprov	character	x(12)	Aprovador	Não
limite-aprov	decimal	->>,>>>,>>9.99	Limite de aprovação	Não
rowlista	rowid		Rowid registro	Não

Método Básico

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

getCharField
Requisito	Query posicionada no registro.
Sintaxe	RUN getCharField IN handle (INPUT <character>, OUTPUT <character>).
Descrição	Retorna valor dos campos do tipo caracter
	Parâmetros	Descrição
	pFieldName	Nome do campo caracter que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo caracter que foi solicitado.

getDateField
Requisito	Query posicionada no registro.
Sintaxe	RUN getDateField IN handle (INPUT <character>, OUTPUT <date>).
Descrição	Retorna valor dos campos do tipo data
	Parâmetros	Descrição
	pFieldName	Nome do campo data que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo data que foi solicitado.

getDecField
Requisito	Query posicionada no registro.
Sintaxe	RUN getDecField IN handle (INPUT <character>, OUTPUT <decimal>).
Descrição	Retorna valor dos campos do tipo decimal
	Parâmetros	Descrição
	pFieldName	Nome do campo decimal que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo decimal que foi solicitado.

getIntField
Requisito	Query posicionada no registro.
Sintaxe	RUN getIntField IN handle (INPUT <character>, OUTPUT <integer>).
Descrição	Retorna valor dos campos do tipo inteiro
	Parâmetros	Descrição
	pFieldName	Nome do campo inteiro que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo inteiro que foi solicitado.

getLogField
Requisito	Query posicionada no registro.
Sintaxe	RUN getLogField IN handle (INPUT <character>, OUTPUT <logical>).
Descrição	Retorna valor dos campos do tipo logico
	Parâmetros	Descrição
	pFieldName	Nome do campo logico que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo logico que foi solicitado.

getRawField
Requisito	Query posicionada no registro.
Sintaxe	RUN getRawField IN handle (INPUT <character>, OUTPUT <raw>).
Descrição	Retorna valor dos campos do tipo raw
	Parâmetros	Descrição
	pFieldName	Nome do campo raw que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo raw que foi solicitado.

getRecidField
Requisito	Query posicionada no registro.
Sintaxe	RUN getRecidField IN handle (INPUT <character>, OUTPUT <recid>).
Descrição	Retorna valor dos campos do tipo recid
	Parâmetros	Descrição
	pFieldName	Nome do campo recid que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo recid que foi solicitado.

getKey
Requisito	Query posicionada no registro.
Sintaxe	RUN getKey IN handle (OUTPUT <character>, OUTPUT <character>, OUTPUT <character >, OUTPUT <integer>).
Descrição	Retorna valores dos campos do índice primário e único da tabela.
	Parâmetros	Descrição
	pep-codigo pcod-estabel pfm-codigo pseq-aprov	Empresa Estabelecimento Família Sequência
Retorno	A BO irá retornar o valor contido nos campos do índice primário e único da tabela.

goToKey
Requisito	Query estar aberta.
Sintaxe	RUN goToKey IN h-handle (INPUT <character>, INPUT <character>, INPUT <character >, INPUT <integer>).
Descrição	Reposiciona registro com base no índice primário e único da tabela.
	Parâmetros	Descrição
	pep-codigo pcod-estabel pfm-codigo pseq-aprov	Empresa Estabelecimento Família Sequência
Retorno	A BO irá reposicionar no registro que foi solicitado.

goToKeyRowid
Requisito	Query estar aberta.
Sintaxe	RUN goToKeyRowid IN h-handle (INPUT <rowid>).
Descrição	Reposiciona registro com base no rowid recebido.
	Parâmetros	Descrição
	Prowid	Rowid do registro a ser posicionado
Retorno	A BO irá reposicionar no registro que foi solicitado.

initializeBO
Requisito	nenhum
Sintaxe	Run initializeBO in handle.
Descrição	Inicialização das handles da BO.
	Parâmetros	Descrição

Retorno

validateRecord
Requisito	Query posicionada no registro.
Sintaxe	Run validateRecord in handle (intpu pType).
Descrição	Validações pertinentes ao DBO.
	Parâmetros	Descrição
	pType	Recebe o tipo de validação create: Indica a criação de um registro update: Indica a atualização de um registro delete: Indica a eliminação de um registro
Retorno

Método Negócio

piSubstituiAprovador
Requisito	Nenhum
Sintaxe	RUN piSubstituiAprovador in handle (INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <logical>, INPUT <logical>, OUTPUT TABLE tt-mla-lista-aprov-fam-origem, OUTPUT TABLE tt-mla-lista-aprov-fam-destino).
Descrição	Substitui e/ou elminada usuário na lista de aprovadores da família
Descrição	Parâmetros	Descrição
	pcEmpresaIni	Empresa inicial a ser considerada para substituição dos aprovadores
	pcEmpresaFim	Empresa final a ser considerada para substituição dos aprovadores
	pcEstabIni	Estabelecimento inicial a ser considerado para substituição dos aprovadores
	pcEstabFim	Estabelecimento final a ser considerado para substituição dos aprovadores
	pcDestino	Usuário destino a ser considerado para substituição dos aprovadores
	pcOrigem	Usuário origem a ser considerado para substituição dos aprovadores
	plManterUsuario	Indica se o usuário deve ser mantido ou não na lista caso já exista o usuário detino na lista corrente.
	plSimulaAlteracao	Indica se é apenas um simulação(cria as temp-tables porém não efetiva as alterações na base).
	tt-mla-lim-aprov-fam-origem	Contém os dados dos registros(Lista de aprovadores da família) do usuário origem.
	tt-mla-lim-aprov-fam-destino	Contém os dados dos registros(Lista de aprovadores da família) do usuário destino.
Retorno	Retorna as temp-tables tt-mla-lista-aprov-fam-origem e tt-mla-lista-aprov-fam-destino com informações das listas de aprovadores da família. As temp-tables contem a situação da atualização de cada um dos registros.

getListaAprov
Requisito	Nenhum
Sintaxe	RUN getListaAprovin handle (INPUT <character>, INPUT <character>, INPUT <character>, INPUT <integer>, INPUT <decimal>, INPUT <logical>, OUTPUT TABLE tt-lista).
Descrição	Fornece a lista de aprovadores da família
	Parâmetros	Descrição
	p-ep-codigo p-cod-estabel p-fm-codigo p-cod-tip-doc p-valor-doc p-somente-limite tt-lista	Empresa Estabelecimento Família Documento Valor documento Considera somente usuários com limite Temp-table com a lista de aprovadores da família.
Retorno	Retorna a temp-table com as listas de aprovadores da família.

OpenQuery / SetConstraint / LinkTo

openQuery
Requisito	Nenhum
Sintaxe	run openQuery in h-handle (input <character>).
Descrição	Faz abertuda das querys.
	Parâmetros	Descrição
	p-ordem	Ordenação da abertura. “main” – Abertura da query principal.
Retorno	Retorna um return-value com o valor “OK” se foi executado com sucesso.

openQueryMain
Requisito	Nenhum
Sintaxe	run openQueryStatic in h-handle (input "Main":U).
Descrição	Faz a abertura da tabela principal.
	Parâmetros	Descrição

Retorno

Árvore de páginas

BOIN796 - Lista de Aprovadores da Família

Assunto

Tabelas Temporárias

Método Básico

Método Negócio

OpenQuery / SetConstraint / LinkTo