Documento de BO

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

Considerações Gerais

Objetivo

Tratamento da regra de negócio da tabela crm_log_exc_proces.

Funcionamento

A BO possibilita tratamento e validação da regra de negócio 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 sintaxe para a chamada da BO é:

run crmbo/boCrmParamMovimenPessoa.p

A sintaxe para executar a BO em modo persistente é:

run crmbo/boCrmParamMovimenPessoa.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 API.

Tabelas Temporárias

Nos atributos das tabelas temporárias de entrada e saída:

RowObject					Entrada/Saída
Tabela temporária padrão para BO’S, sua definição é “like” , ou seja, possuí todos os campos da tabela física utilizada na geração da BO, mais o campo r-rowid do to tipo rowid.					Ver método básico e método de negócio
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
num_id	Int	99999999	Chave primária	Sim
num_dias	Int	99999999	Numero de dias	Sim
num_id_filtro	Int	99999999	filtro	não
num_id_grp	Int	99999999	Grupo notificação	Sim
num_id_segmntcao	Int	99999999	Grupo de informação	Não
num_tip_monitorar	Int	99999999	Tipo de monitoração	Sim
cdd_version	Dec	zzz,zzz,zz9.9	Controle de versão da alteração	Não
val_livre_1	Dec	zzz,zzz,zz9.9	Campo livre 1	Não
val_livre_2	Dec	zzz,zzz,zz9.9	Campo livre 2	Não
dat_livre_1	Data	99/99/9999	Campo livre 1	Não
dat_livre_2	Data	99/99/9999	Campo livre 2	Não
dat_timestamp	Data	99/99/9999	Data hora alteração	Não
cod_livre_1	Char	X(100)	Campo livre 1	Não
cod_livre_2	Char	X(100)	Campo livre 2	Não
log_livre_1	Log	Yes/no	Campo livre 1	Não
log_livre_2	log	Yes/no	Campo livre 2	Não
num_livre_1	Int	99999999	Campo livre 1	Não
num_livre_2	Int	99999999	Campo livre 2	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	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	getCharField in h-handle (input pFieldName, output pFieldValue).
Descrição	Método usado para retornar valores de campos do tipo caracter para a tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pFieldName	Nome do campo para retornar o valor (character)
	pFieldValue	Valor do campo solicitado (character)
Retorno	A BO irá setar o parâmetro de output de forma a informar ao programa “chamador” o valor daquele campo para o registro posicionado pela BO. Os Erros serão tratados temp-table RowErrors.

getIntField
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	getCharField in h-handle (input pFieldName, output pFieldValue).
Descrição	Método usado para retornar valores de campos do tipo inteiro para a tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pFieldName	Nome do campo para retornar o valor (character)
	pFieldValue	Valor do campo solicitado (integer)
Retorno	A BO irá setar o parâmetro de output de forma a informar ao programa “chamador” o valor daquele campo para o registro posicionado pela BO. Os Erros serão tratados temp-table RowErrors.

getIntField
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	getCharField in h-handle (input pFieldName, output pFieldValue).
Descrição	Método usado para retornar valores de campos do tipo Decimal para a tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pFieldName	Nome do campo para retornar o valor (character)
	pFieldValue	Valor do campo solicitado (integer)
Retorno	A BO irá setar o parâmetro de output de forma a informar ao programa “chamador” o valor daquele campo para o registro posicionado pela BO. Os Erros serão tratados temp-table RowErrors.

getDecField
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	getCharField in h-handle (input pFieldName, output pFieldValue).
Descrição	Método usado para retornar valores de campos do tipo Decimal para a tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pFieldName	Nome do campo para retornar o valor (character)
	pFieldValue	Valor do campo solicitado (Decimal)
Retorno	A BO irá setar o parâmetro de output de forma a informar ao programa “chamador” o valor daquele campo para o registro posicionado pela BO. Os Erros serão tratados temp-table RowErrors.

getDateField
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	getCharField in h-handle (input pFieldName, output pFieldValue).
Descrição	Método usado para retornar valores de campos do tipo Data para a tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pFieldName	Nome do campo para retornar o valor (character)
	pFieldValue	Valor do campo solicitado (Date)
Retorno	A BO irá setar o parâmetro de output de forma a informar ao programa “chamador” o valor daquele campo para o registro posicionado pela BO. Os Erros serão tratados temp-table RowErrors

getLogField
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	getCharField in h-handle (input pFieldName, output pFieldValue).
Descrição	Método usado para retornar valores de campos do tipo Lógico para a tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pFieldName	Nome do campo para retornar o valor (character)
	pFieldValue	Valor do campo solicitado (Logical)
Retorno	A BO irá setar o parâmetro de output de forma a informar ao programa “chamador” o valor daquele campo para o registro posicionado pela BO. Os Erros serão tratados temp-table RowErrors

getKey
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	getKey in h-handle (output pnum_id).
Descrição	Método usado para retornar o valor do identificador sequencial da tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pnum_id	Identificador sequencial (integer)
Retorno	A BO irá setar o parâmetro de output de forma a informar ao programa “chamador” o valor do campo usado como identificador sequencial para o registro posicionado pela BO. Os Erros serão tratados temp-table RowErrors.

goToKey
Requisito	Executar a BO persistente.
Sintaxe	goToKey in h-handle (input pnum_id).
Descrição	Método usado para posicionar a BO em um determinado registro, de acordo identificador sequencial da tabela crm_log_exc_proces.
	Parâmetros	Descrição
	pnum_id	Identificador sequencial (integer)
Retorno	A 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 Erros serão tratados temp-table RowErrors.

validateRecord
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	validateRecord in h-handle (input pType).
Descrição	Método usado para efetuar as devidas validações ao adicionar, atualizar ou remover um registro da tabela. este é executado automaticamente pela BO sempre que executar um dos métodos padrões (createRecord, updateRecord, deleteRecord).
	Parâmetros	Descrição
	pType	Tipo de operação (character) “create,update or delete”.
Retorno	A 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 Erros serão tratados na temp-table RowErrors.

OpenQuery / SetConstraint / LinkTo

OpenQueryStatic
Requisito	Executar a BO persistente.
Sintaxe	run openQueryStatic in h-handle (input “Default”).
Descrição	Seta as restrições para abertura da query, no caso da opção default não há restrições.
	Parâmetros	Descrição
	Não contém
Retorno	A 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).

Árvore de páginas

boCrmParamMovimenPessoa - DBO para tabela crm_param_movimen_pessoa, contém a lógica de negócio e acesso a dados da tabela.

Documento de BO

Considerações Gerais

Tabelas Temporárias

Método Básico

OpenQuery / SetConstraint / LinkTo