Documento de BO

Produto:	Datasul
Ocorrência:	Documentação de BO
Nome Físico	inbo/boin01038.p
Include com Parâmetros	inbo/boin01038.i
Banco:	movind
Tabela:	envio-solicit-cotac

Considerações Gerais

Objetivo

Esta BO tem como objetivo a manipulação dos dados referentes a tabela envio-solicit-cotac (Envio da Solicitação de Cotação).

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/boin01038.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

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

RowObject					Entrada/Saída
Envio da Solicitação de Cotação					Entrada/Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
cdd-solicit	DECIMAL	>>>,>>>,>>>,>>>,>>9	Código da solicitação de cotação	Sim
seq	INTEGER	>>>>9	Sequência do envio	Sim
dat-envio	DATE	99/99/9999	Data Envio	Sim
dtm-liber	DATETIME	99/99/9999 hh:mm:ss	Data/Hora Liberação	Não
dtm-expirac	DATETIME	99/99/9999 hh:mm:ss	Data/Hora Expiração	Não
idi-situacao	INTEGER	9	Situação	Não
cod-obs	CHARACTER	X(500)	Observação	Não
cod-livre-1	CHARACTER	x(500)	Livre 1	Não
cod-livre-2	CHARACTER	x(500)	Livre 2	Não
cod-livre-3	CHARACTER	x(500)	Livre 3	Não
cod-livre-4	CHARACTER	x(500)	Livre 4	Não
dat-livre-1	DATE	99/99/9999	Livre 1	Não
dat-livre-2	DATE	99/99/9999	Livre 2	Não
dat-livre-3	DATE	99/99/9999	Livre 3	Não
dat-livre-4	DATE	99/99/9999	Livre 4	Não
log-livre-1	LOGICAL	Sim/Não	Livre 1	Não
log-livre-2	LOGICAL	Sim/Não	Livre 2	Não
log-livre-3	LOGICAL	Sim/Não	Livre 3	Não
log-livre-4	LOGICAL	Sim/Não	Livre 4	Não
num-livre-1	INTEGER	>>>>>>>>9	Livre 1	Não
num-livre-2	INTEGER	>>>>>>>>9	Livre 2	Não
num-livre-3	INTEGER	>>>>>>>>9	Livre 3	Não
num-livre-4	INTEGER	>>>>>>>>9	Livre 3	Não
val-livre-1	DECIMAL	->>>>>>>>>>>9.99999999	Livre 1	Não
val-livre-2	DECIMAL	->>>>>>>>>>>9.99999999	Livre 2	Não
val-livre-3	DECIMAL	->>>>>>>>>>>9.99999999	Livre 3	Não
val-livre-4	DECIMAL	->>>>>>>>>>>9.99999999	Livre 4	Não
log-cancel	LOGICAL	Sim/Não	Cancelado	Não
des-motiv-cancel	CHARACTER	x(500)	Motivo Cancelamento	Não
dtm-cancel	DATETIME	99/99/9999 HH:MM:SS.SSS	Data/Hora Cancelamento	Não
r-Rowid	ROWID	x(8)	Rowid do Registro	Não

ttSendedQuotationProcess					Entrada/Saída
Informações do envio da solicitação de cotação					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
cdd-solicit	DECIMAL	>>>,>>>,>>>,>>>,>>9	Código da Solicitação de Cotação	Sim
seq	INTEGER	>>>>9	Sequência de envio	Sim
dat-envio	DATE	99/99/9999	Data Envio	Não
dtm-liber	DATETIME	99/99/9999 hh:mm:ss	Data/Hora Liberação	Não
dtm-expirac	DATETIME	99/99/9999 hh:mm:ss	Data/Hora Expiração	Não
idi-situacao	INTEGER	9	Situação	Não
cod-obs	CHARACTER	X(500)	Observação	Não
cod-livre-1	CHARACTER	x(500)	Livre 1	Não
cod-livre-2	CHARACTER	x(500)	Livre 2	Não
cod-livre-3	CHARACTER	x(500)	Livre 3	Não
cod-livre-4	CHARACTER	x(500)	Livre 4	Não
dat-livre-1	DATE	99/99/9999	Livre 1	Não
dat-livre-2	DATE	99/99/9999	Livre 2	Não
dat-livre-3	DATE	99/99/9999	Livre 3	Não
dat-livre-4	DATE	99/99/9999	Livre 4	Não
log-livre-1	LOGICAL	Sim/Não	Livre 1	Não
log-livre-2	LOGICAL	Sim/Não	Livre 2	Não
log-livre-3	LOGICAL	Sim/Não	Livre 3	Não
log-livre-4	LOGICAL	Sim/Não	Livre 4	Não
num-livre-1	INTEGER	>>>>>>>>9	Livre 1	Não
num-livre-2	INTEGER	>>>>>>>>9	Livre 2	Não
num-livre-3	INTEGER	>>>>>>>>9	Livre 3	Não
num-livre-4	INTEGER	>>>>>>>>9	Livre 3	Não
val-livre-1	DECIMAL	->>>>>>>>>>>9.99999999	Livre 1	Não
val-livre-2	DECIMAL	->>>>>>>>>>>9.99999999	Livre 2	Não
val-livre-3	DECIMAL	->>>>>>>>>>>9.99999999	Livre 3	Não
val-livre-4	DECIMAL	->>>>>>>>>>>9.99999999	Livre 4	Não
log-cancel	LOGICAL	Sim/Não	Cancelado	Não
des-motiv-cancel	CHARACTER	x(500)	Motivo Cancelamento	Não
dtm-cancel	DATETIME	99/99/9999 HH:MM:SS.SSS	Data/Hora Cancelamento	Não

ttItemSendedQuotationProcess / ttVendorSendedQuotationProcess					Entrada/Saída
Informações do item do envio da solicitação de cotação					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
cdd-solicit	DECIMAL	>>>,>>>,>>>,>>>,>>9	Solicitação	Sim
cdn-fornec	INTEGER	>>>>>>>>9	Código do Fornecedor	Sim
numero-ordem	INTEGER	zzzzz9,99	Ordem de compra	Sim
seq	INTEGER	>>>>9	Sequência do envio	Sim
log-responde-via-web	LOGICAL	Sim/Não	Responde Via Web	Não
log-planilha-envda	LOGICAL	Sim/Não	Planilha enviada	Não
log-confir-entreg	LOGICAL	Sim/Não	Confirmação Entrega	Não
log-confir-recebto	LOGICAL	Sim/Não	Confirmação Recebimento	Não
des-e-mail	CHARACTER	x(2000)	E-Mails para envio	Não
assunto-email	CHARACTER	x(100)	Assunto do e-mail	Não
dsl-texto	CHARACTER	x(2000)	Texto do e-mail	Não
idi-situacao	INTEGER	9	Situação do envio	Não
cod-obs	CHARACTER	X(500)	Observação	Não
des-link-cotac	CHARACTER	x(500)	Link da Cotação (RFI)	Não
log-rejtdo	LOGICAL	Sim/Não	Rejeitado	Não
des-motiv-rej	CHARACTER	x(500)	Motivo Rejeição	Não
dtm-rej	DATETIME	99/99/9999 HH:MM:SS.SSS	Data/Hora Rejeição	Não
log-rej-reg-fornec	LOGICAL	Sim/Não	Rejeite registrado pelo fornecedor	Não
log-cancel	LOGICAL	Sim/Não	Cancelado	Não
des-motiv-cancel	CHARACTER	x(500)	Motivo Cancelamento	Não
dtm-cancel	DATETIME	99/99/9999 HH:MM:SS.SSS	Data/Hora Cancelamento	Não
cod-livre-1	CHARACTER	x(500)	Livre 1	Não
cod-livre-2	CHARACTER	x(500)	Livre 2	Não
cod-livre-3	CHARACTER	x(500)	Livre 3	Não
cod-livre-4	CHARACTER	x(500)	Livre 4	Não
dat-livre-1	DATE	99/99/9999	Livre 1	Não
dat-livre-2	DATE	99/99/9999	Livre 2	Não
dat-livre-3	DATE	99/99/9999	Livre 3	Não
dat-livre-4	DATE	99/99/9999	Livre 4	Não
log-livre-1	LOGICAL	Sim/Não	Livre 1	Não
log-livre-2	LOGICAL	Sim/Não	Livre 2	Não
log-livre-3	LOGICAL	Sim/Não	Livre 3	Não
log-livre-4	LOGICAL	Sim/Não	Livre 4	Não
num-livre-1	INTEGER	>>>>>>>>9	Livre 1	Não
num-livre-2	INTEGER	>>>>>>>>9	Livre 2	Não
num-livre-3	INTEGER	>>>>>>>>9	Livre 3	Não
num-livre-4	INTEGER	>>>>>>>>9	Livre 3	Não
val-livre-1	DECIMAL	->>>>>>>>>>>9.99999999	Livre 1	Não
val-livre-2	DECIMAL	->>>>>>>>>>>9.99999999	Livre 2	Não
val-livre-3	DECIMAL	->>>>>>>>>>>9.99999999	Livre 3	Não
val-livre-4	DECIMAL	->>>>>>>>>>>9.99999999	Livre 4	Não
nome-abrev	CHARACTER	X(12)	Nome Abreviado fornecedor	Não
nome-emit	CHARACTER	x(80)	Nome fornecedor	Não
cgc	CHARACTER	x(19)	CGC/CPF do fornecedor	Não

RowErrors					Entrada/Saída
Erros ocorridos durante a execução do programa.					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
ErrorSequence	INTEGER		Sequência	Sim
ErrorNumber	INTEGER		Número	Sim
ErrorDescription	CHARACTER		Descrição	Não
ErrorParameters	CHARACTER		Parâmetros	Não
ErrorType	CHARACTER		Tipo de erro	Não
ErrorHelp	CHARACTER		Texto de ajuda	Não
ErrorSubType	CHARACTER		Sub-tipo do erro	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.

getDatetimeField
Requisito	Query posicionada no registro.
Sintaxe	RUN getDatetimeField IN handle (INPUT <character>, OUTPUT <datetime>).
Descrição	Retorna valor dos campos do tipo data
	Parâmetros	Descrição
	pFieldName	Nome do campo datetime que será retornado o valor
	pFieldValue	Valor contido no campo solicitado
Retorno	A BO irá retornar o valor contido no campo datime 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 <pcdd-solicit>, OUTPUT <pseq>).
Descrição	Retorna chave primária e única da tabela.
	Parâmetros	Descrição
	pcdd-solicit (decimal)	Código da Solicitação de Cotação
	pseq (integer)	Sequência do envio
Retorno	A BO irá retornar o valor contido na chave primária e única do registro que foi solicitado.

goToKey
Requisito	Query estar aberta.
Sintaxe	RUN goToKey IN h-handle (INPUT <pcdd-solicit>, INPUT <pseq>).
Descrição	Reposiciona registro com base no índice primário e único da tabela.
	Parâmetros	Descrição
	pcdd-solicit (decimal)	Código da Solicitação de Cotação
	pseq (integer)	Sequência do envio
Retorno	A BO irá reposicionar no registro que foi solicitado.

ValidateRecord
Requisito	Query posicionada no registro.
Sintaxe	Run validateRecord in handle (input <character>).
Descrição	Validações pertinentes ao DBO.
	Parâmetros	Descrição
	pType	Recebe o tipo de validação (Create, Delete, Update) 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

getSendedQuotationProcessByPurchOrder
Requisito	Processo de cotação com ordens vinculadas.
Sintaxe	RUN getSendedQuotationProcessByPurchOrder IN h-handle (INPUT <pNumeroOrdem>, OUTPUT TABLE <ttSendedQuotationProcess>, OUTPUT TABLE <ttItemSendedQuotationProcess>, OUTPUT TABLE <RowErrors>).
Descrição	Retorna informações sobre os envios de solicitações de cotação realizados para a ordem de compra.
	Parâmetros	Descrição
	pNumeroOrdem (integer)	Número da ordem de compra
	ttSendedQuotationProcess (temp-table)	Informações do envio da solicitação de cotação.
	ttItemSendedQuotationProcess (temp-table)	Informações do item do envio da solicitação de cotação.
	RowErrors (temp-table)	Erros ocorridos no processo.
Retorno	Dados de envios, itens de envio e temp-table com erros ocorridos no processo.

getSendedQuotationProcessByProcess
Requisito	Processo de cotação com ordens vinculadas.
Sintaxe	RUN getSendedQuotationProcessByProcess IN h-handle (INPUT <pQuotationProcessNumber>, OUTPUT TABLE <ttSendedQuotationProcess>, OUTPUT TABLE <ttVendorSendedQuotationProcess>, OUTPUT TABLE <RowErrors>).
Descrição	Retorna informações sobre os envios de solicitações de cotação realizados para um processo de cotação.
	Parâmetros	Descrição
	pQuotationProcessNumber (decimal)	Número do processo de cotação
	ttSendedQuotationProcess (temp-table)	Informações do envio da solicitação de cotação.
	ttVendorSendedQuotationProcess(temp-table)	Informações do item do envio da solicitação de cotação.
	RowErrors (temp-table)	Erros ocorridos no processo.
Retorno	Dados de envios de solicitação e temp-table com erros ocorridos no processo.

OpenQuery / SetConstraint / LinkTo

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

Retorno