Documento de BO

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

Considerações Gerais

Objetivo

Tratamento da regra de negócio da tabela crm_log_uniao_ctas_gpl.

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/boCrmLogUniaoCtasGpl.p

A sintaxe para executar a BO em modo persistente é:

run crmbo/boCrmLogUniaoCtasGpl.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áia	Sim
num_id_pessoa_ant	Int	99999999	Conta desativada	Sim
num_id_pessoa_atual	Int	99999999	Conta ativa	Sim
Idi_tip_reg_transfdo	Int	99999999	Tipo de registro transferido	Sim
num_livre_1	Int	99999999	Campo livre 1	Não
num_livre_2	Int	99999999	Campo livre 2	Não
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
data_exec	data	99/99/9999	Data da execução	Sim
hora_exec	Char	X(08)	Hora execução	Sim
cod_livre_1	Char	X(100)	Campo livre 1	Não
cod_livre_2	Char	X(100)	Campo livre 2	Não
cod_usuar	Log	Yes/no	Movimenta ocorrência?	Sim
log_livre_1	Log	Yes/no	Campo livre 1	Não
log_livre_2	log	Yes/no	Campo livre 2	Não
num_id_reg	Int	99999999	Identificador do template	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_uniao_ctas_gpl.
	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_uniao_ctas_gpl.
	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_uniao_ctas_gpl.
	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_uniao_ctas_gpl.
	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_uniao_ctas_gpl.
	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 seqüencial da tabela crm_log_uniao_ctas_gpl.
	Parâmetros	Descrição
	pnum_id	Identificador seqüencial (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 seqüencial 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 seqüencial da tabela crm_log_uniao_ctas_gpl.
	Parâmetros	Descrição
	pnum_id	Identificador seqüencial (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 automáticamente 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.

Método Negócio

validateRegAcaoAuto
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	validateRegAcaoAuto in h-handle (input pNumId, input pNumIdRestdo, input pNumIdAcaoCamp).
Descrição	Método usado para validar se o resultado selecionado onde não poderá ser informado um resultado que finalize ou que tenha próximas ações.
	Parâmetros	Descrição
	pNumId
	pNumIdRestdo
	pNumIdAcaoCamp	Identificador (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 na temp-table RowErrors, caso haja erro será adicionado a mensagem de erro com código 52885.

validateDescription
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	validateDescription in h-handle (input pNumId, input pDescription).
Descrição	Método usado para validar se a descrição informado no regisro é única, não deve haver mais de um registro com mesma descrição.
	Parâmetros	Descrição
	pNumId
	pDescription	Identificador (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 na temp-table RowErrors, caso haja erro será adicionado a mensagem de erro com código 51748.

validateDeleteConfig
Requisito	Executar a BO persistente e estar previamente posicionado em um registro.
Sintaxe	validateDescription in h-handle (input pNumId, input pDescription).
Descrição	Método usado para validar se a descrição informado no regisro é única, não deve haver mais de um registro com mesma descrição.
	Parâmetros	Descrição
	pNumId
	pDescription	Identificador (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 na temp-table RowErrors, caso haja erro será adicionado a mensagem de erro com código 51748.

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
	-i	-
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

boCrmLogUniaoCtasGpl - Tabela de log para as contas unificadas a partir do Gestão de Planos