Documento de BO
Produto: | Datasul |
Ocorrência: | Documentação de BO |
Nome Físico | frbo/bofr112 |
Objetivo
Validação, Manutenção e acesso rápido a tabela “mnd-enquad”.
Funcionamento
A BO irá validar os dados, manutenir a tabela e fazer a leitura dos registros da tabela “mnd-enquad”.
Na forma padrão, realiza-se a chamada através de um comando RUN.
A sintaxe para a chamada BO é:
run frbo/bofr112.p.
A sintaxe para executar a BO em modo persistente é:
run frbo/bofr112.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:
Tabela Temporária | Descrição | Entrada/Saída |
RowObject | Tabela de comunicação entre Interface e banco de dados da tabela “mnd-enquad”. | Entrada/Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
cod-enquad | char | X(12) | Código Enquadramento | Sim / Key | |
des-enquad | char | x(500) | Descrição Enquadramento | Sim | |
cdn-gravid | int | >>9 | Código Gravidade | Sim | |
cdn-infrat | int | >>9 | Código Infrator | Sim | |
cod-grp-enquad | char | x(8) | Código Grupo Enquadramento | Sim | |
cod-evento | char | X(8) | Código do Evento | Sim | |
cod-livre-1 | char | x(1000) | Character Livre | Não | |
cod-livre-2 | char | x(1000) | Character Livre | Não | |
log-livre-1 | log | Sim/Não | Logical Livre | Não | |
log-livre-2 | log | Sim/Não | Logical Livre | Não | |
num-livre-1 | int | ->>>>>>>>>9 | Inteiro Livre | Não | |
num-livre-2 | int | ->>>>>>>>>9 | Inteiro Livre | Não | |
val-livre-1 | dec | ->>>>>>>>>>>9.9 | Decimal Livre | Não | |
val-livre-2 | dec | ->>>>>>>>>>>9.9 | Decimal Livre | Não | |
dat-livre-1 | date | 99/99/9999 | Data livre | Não | |
dat-livre-2 | date | 99/99/9999 | Data livre | Não | |
idi-niv-aprovac | int | >9 | Nível Aprovação do Enquadramento | Não | |
des-abrevi | char | x(100) | Descrição Abreviada | Não | |
Tabela Temporária | Descrição | Entrada/Saída |
RowErrors | Contém os erros ocorridos na BO. | Saída |
| | | | | |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ErrorSequence | integer | Padrão | Seqüência dos erros | Sim | |
ErrorNumber | integer | Padrão | Número do erro | Sim | |
ErrorDescription | char | Padrão | Descrição do erro | Sim | |
ErrorParameters | char | Padrão | Parâmetros passados para criar mensagem | Não | |
ErrorType | char | Padrão | Tipo do erro: WARNING: Aviso ERROR: Erro | Sim | |
ErrorHelp | char | Padrão | Texto de ajuda do erro | Sim | |
ErrorSubType | char | Padrão | Sub Tipo da mensagem de erro | Não | |
Métodos
Quando a BO for executada em modo persistente, os seguintes métodos estarão disponíveis para execução:
Método Básico
goToKey
Requisito | Nenhum |
Sintaxe | run goToKey in h-handle (input <character>). |
Descrição | Reposiciona a query com base na chave primária da tabela. |
| Parâmetros | Descrição |
| pcod-enquad | Código do Enquadramento |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getKey
Requisito | Nenhum |
Sintaxe | run getKey in h-handle (output <character>). |
Descrição | Retorna os campos da chave primária da tabela. |
| Parâmetros | Descrição |
| pcod-enquad | Código do Enquadramento |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getCharField
Requisito | Nenhum |
Sintaxe | run getCharField in h-handle (input <character>, output <character>). |
Descrição | Retorna os valores dos campos da tabela que são caracteres. |
| Parâmetros | Descrição |
| pFieldName | Nome do campo a ser retornado |
| pFieldValue | Valor do campo. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getDateField
Requisito | Nenhum |
Sintaxe | run getDateField in h-handle (input <character>, output <date>). |
Descrição | Retorna os valores dos campos da tabela que são data. |
| Parâmetros | Descrição |
| pFieldName | Nome do campo a ser retornado |
| pFieldValue | Valor do campo. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getDecField
Requisito | Nenhum |
Sintaxe | run getDecField in h-handle (input <character>, output <decimal>). |
Descrição | Retorna os valores dos campos da tabela que são decimais. |
| Parâmetros | Descrição |
| pFieldName | Nome do campo a ser retornado |
| pFieldValue | Valor do campo. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getIntField
Requisito | Nenhum |
Sintaxe | run getIntField in h-handle (input <character>, output <integer>). |
Descrição | Retorna os valores dos campos da tabela que são inteiros. |
| Parâmetros | Descrição |
| pFieldName | Nome do campo a ser retornado |
| pFieldValue | Valor do campo. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getLogField
Requisito | Nenhum |
Sintaxe | run getLogField in h-handle (input <character>, output <logical>). |
Descrição | Retorna os valores dos campos da tabela que são Lógicos. |
| Parâmetros | Descrição |
| pFieldName | Nome do campo a ser retornado |
| pFieldValue | Valor do campo. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getRawField
Requisito | Nenhum |
Sintaxe | run getRawField in h-handle (input <character>, output <raw>). |
Descrição | Retorna os valores dos campos da tabela que são caracteres longos. |
| Parâmetros | Descrição |
| pFieldName | Nome do campo a ser retornado |
| pFieldValue | Valor do campo. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getRecidField
Requisito | Nenhum |
Sintaxe | run getRecidField in h-handle (input <character>, output <recid>). |
Descrição | Retorna os valores dos campos da tabela que são numéricos e definem uma seqüência única para a tabela dentro do database. |
| Parâmetros | Descrição |
| pFieldName | Nome do campo a ser retornado |
| pFieldValue | Valor do campo. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
getRowid
Requisito | Nenhum |
Sintaxe | run getRowid in h-handle (output <rowid>). |
Descrição | Retorna o ROWID do registro corrente da Query que está aberta na BO. Este método não aparece para ser manutenido. |
| Parâmetros | Descrição |
| pRowid | Rowid da tabela. |
Retorno | A API/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 motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors. |
OpenQuery / SetConstraint / LinkTo
openQueryMain
Requisito | Nenhum |
Sintaxe | run openQueryMain in h-handle. |
Descrição | Abre a query da BO com todos os registros. |
| Parâmetros | Descrição |
| Não Contém | |
Retorno | A API/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). |
openQueryEnquad
Requisito | A setConstraintEnquad ter sido executada anteriormente. |
Sintaxe | run openQueryEnquad in h-handle. |
Descrição | Abre a query da BO conforme a faixa de Código do Modelo do Equipamento passada na procedure setConstraintEnquad. |
Retorno | A API/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). |
setConstraintEnquad
Requisito | Nenhum |
Sintaxe | run setConstraintEnquad in h-handle (input <character>, input <character>). |
Descrição | Seta as restrições para abrir a query por faixa de código do enquadramento. |
| Parâmetros | Descrição |
| pCodEnquadIni | Cód Enquadramento Inicial |
| pCodEnquadFim | Cód Enquadramento Final |
Retorno | A API/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). |
openQueryGravInfr
Requisito | A setConstraintGravInfr ter sido executada anteriormente. |
Sintaxe | run openQueryGravInfr in h-handle. |
Descrição | Abre a query da BO conforme a faixa de Código da Gravidade e Código do Infrator passada na procedure setConstraintGravInfr. |
Retorno | A API/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). |
setConstraintGravInfr
Requisito | Nenhum |
Sintaxe | run setConstraintGravInfr in h-handle (input <integer>, input <integer>, input <integer>, input <integer>). |
Descrição | Seta as restrições para abrir a query por faixa de código da gravidade e código do infrator. |
| Parâmetros | Descrição |
| pCdnGravidIni | Cód Gravidade Inicial |
| pCdnGravidFim | Cód Gravidade Final |
| pCdnInfratIni | Cód Infrator Inicial |
| pCdnInfratFim | Cód Infrator Final |
Retorno | A API/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). |
openQueryGrupo
Requisito | A setConstraintGrupo ter sido executada anteriormente. |
Sintaxe | run openQueryGrupo in h-handle. |
Descrição | Abre a query da BO conforme a faixa de Código de Grupo de Enquadramento passada na procedure setConstraintGrupo. |
Retorno | A API/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). |
setConstraintGrupo
Requisito | Nenhum |
Sintaxe | run setConstraintGrupo in h-handle (input <character>, input <character>). |
Descrição | Seta as restrições para abrir a query por faixa de código de grupo de enquadramento. |
| Parâmetros | Descrição |
| pCodGrpIni | Cód Grupo de Enquadramento Inicial |
| pCodGrpFim | Cód Grupo de Enquadramento Final |
Retorno | A API/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). |
Método Negócio
validateRecord
Requisito | Ter sido executada alguma ação para manutenção do registro da tabela. Esta procedure é executada somente internamente pela BO. |
Sintaxe | Run validate in this-procedure (input <character>). |
Descrição | Valida as ações feitas em cima do registro da tabela corrente da BO. Estas ações podem ser: “CREATE”, “UPDATE” e “DELETE”. |
| Parâmetros | Descrição |
| pType | Tipo de ação: “CREATE” “UPDATE” “DELETE” |
Retorno | A API/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 motivos para a rejeição do movimento de criação são especificados na temp-table RowErrors. |
#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))