Produto: | Datasul |
Ocorrência: | Documentação de BO |
Nome Físico: | cxbo/bocx00469.p |
Include com Parâmetros | cxbo/bocx00469.i |
Banco: | mgcex |
Tabela: | due-item-lpco |
Objetivo
Esta BO tem como objetivo a manipulação dos dados referentes a tabela due-item-lpco (Licenças, Permissões, Certificados e Outros de Item da DU-E).
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 cxbo/bocx00469.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.
Atributos das tabelas temporárias de entrada e saída:
RowObject | Entrada/Saída | ||||
Licenças, Permissões, Certificados e Outros de Item da DU-E | Entrada/Saída | ||||
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
| cdd-due-ems | DECIMAL | >>>>>>>>>>>>>>>9 | Número Interno DU-E | Sim | |
| num-versao-due | INTEGER | >>>>,>>9 | Versão DU-E | Sim | |
| num-seq-it-due | INTEGER | >>9 | Sequência do Item na DU-E | Sim | |
| cod-lpco | CHARACTER | x(30) | Código LPCO do Item da DU-E | Sim | |
| des-lpco | CHARACTER | x(200) | Descrição LPCO | Não | |
| cod-livre-1 | CHARACTER | x(500) | Livre 1 | Não | |
| cod-livre-2 | CHARACTER | x(500) | Livre 2 | Não | |
| dat-livre-1 | DATE | 99/99/9999 | Livre 1 | Não | |
| dat-livre-2 | DATE | 99/99/9999 | Livre 2 | Não | |
| log-livre-1 | LOGICAL | Sim/Não | Livre 1 | Não | |
| log-livre-2 | LOGICAL | Sim/Não | Livre 2 | Não | |
| num-livre-1 | INTEGER | >>>>>>>>9 | Livre 1 | Não | |
| num-livre-2 | INTEGER | >>>>>>>>9 | Livre 2 | Não | |
| val-livre-1 | DECIMAL | ->>>>>>>>>>>9.99999999 | Livre 1 | Não | |
| val-livre-2 | DECIMAL | ->>>>>>>>>>>9.99999999 | Livre 2 | Não | |
| r-rowid | ROWID | x(8) | Rowid do registro | Não | |
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 <pcdd-due-ems>, OUTPUT <pnum-versao-due>, OUTPUT <pnum-seq-it-due>, OUTPUT <pcod-lpco>). | |
Descrição | Retorna chave primária e única da tabela. | |
Parâmetros | Descrição | |
| pcdd-due-ems (decimal) | Código Interno da DU-E |
| pnum-versao-due (integer) | Versão da DU-E | |
| pnum-seq-it-due (integer) | Sequência do item da DU-E | |
| pcod-lpco (character) | Código do LPCO | |
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-due-ems>, INPUT <pnum-versao-due>, INPUT <pnum-seq-it-due>, INPUT <pcod-lpco>). | |
Descrição | Reposiciona registro com base no índice primário e único da tabela. | |
Parâmetros | Descrição | |
| pcdd-due-ems (decimal) | Código Interno da DU-E |
| pnum-versao-due (integer) | Versão da DU-E | |
| pnum-seq-it-due (integer) | Sequência do item da DU-E | |
| pcod-lpco (character) | Código do LPCO | |
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 | ||
piDesvinculaItemLpco | ||
Requisito | DU-E cadastrada no sistema com item. | |
Sintaxe | Run piDesvinculaItemLpco in handle (input <decimal>, input <integer>, input <integer>). | |
Descrição | Elimina os registros referente a LPCO do item da DU-E informado. | |
Parâmetros | Descrição | |
p-cdd-due-ems | Número Interno da DU-E | |
| p-num-versao-due | Versão da DU-E | |
| p-num-seq-it-due | Sequência do Item da DU-E | |
Retorno | ||
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 | ||
openQueryByDueItem | ||
Requisito | Execução da procedure "setConstraintByDueItem" | |
Sintaxe | run openQueryStatic in h-handle (input "ByDueItem":U). | |
Descrição | Faz a abertura da query para os LPCO do item da DU-E | |
Parâmetros | Descrição | |
| ||
Retorno | ||
setConstraintByDueItem | ||
Requisito | Nenhum. | |
Sintaxe | Run setConstraintByDueItem in handle (input <decimal>, input <integer>, input <integer>). | |
Descrição | Recebe os parâmetros para abertura das queries "ByDueItem" | |
Parâmetros | Descrição | |
p-cdd-due-ems | Número Interno da DU-E | |
| p-num-versao-due | Versão da DU-E | |
| p-num-seq-it-due | Sequência do Item da DU-E | |
Retorno | ||
