Assunto
Produto: | Datasul |
Ocorrência: | Documentação de BO |
Nome Físico: | inbo/boin792.p |
Include com Parâmetros: | Inbo/boin792.i |
Banco | mgind |
Tabela | mla-hierarquia-aprov |
Objetivo
Esta BO tem como objetivo a manipulação dos dados referentes a tabela mla-hierarquia-aprov (Hierarquia de Aprovadores).
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/boin792.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 de entrada e saída:
RowObject | Entrada/ Saída |
Hierarquia de Aprovadores | Entrada/ Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
cod-tip-doc | integer | >>9 | Documento | Sim | |
cod-lotacao | character | x(20) | Lotação | Sim | |
seq-aprov | integer | >9 | Sequência | Sim | |
cod-usuar | character | X(12) | Aprovador | Não | |
log-depend | logical | Sim/Não | Dependência | Sim | |
char-1 | character | x(100) | | Não | |
char-2 | character | x(100) | | Não | |
dec-1 | decimal | ->>>>>>>>>>>9.99999999 | | Não | |
dec-2 | decimal | ->>>>>>>>>>>9.99999999 | | Não | |
int-1 | integer | >>>>>>>>>9 | | Não | |
int-2 | integer | >>>>>>>>>9 | | Não | |
log-1 | logical | Sim/Não | | Sim | |
log-2 | logical | Sim/Não | | Não | |
data-1 | date | 99/99/9999 | | Não | |
data-2 | date | 99/99/9999 | | Não | |
char-3 | character | x(100) | | Não | |
char-4 | character | x(100) | | Não | |
char-5 | character | x(100) | | Não | |
dec-3 | decimal | ->>>>>>>>>>>9.99999999 | | Não | |
dec-4 | decimal | ->>>>>>>>>>>9.99999999 | | Não | |
dec-5 | decimal | ->>>>>>>>>>>9.99999999 | | Não | |
int-3 | integer | >>>>>>>>>9 | | Não | |
int-4 | integer | >>>>>>>>>9 | | Não | |
int-5 | integer | >>>>>>>>>9 | | Não | |
log-3 | logical | Sim/Não | | Não | |
log-4 | logical | yes/no | | Não | |
log-5 | logical | yes/no | | Não | |
data-3 | date | 99/99/9999 | | Não | |
data-4 | date | 99/99/9999 | | Não | |
data-5 | date | 99/99/9999 | | Não | |
ep-codigo | character | x(3) | Empresa | Sim | |
cod-estabel | character | x(5) | Estabelecimento | Sim | |
tt-mla-hierarquia-aprov-origem | Entrada/Saída |
Lista de hierarquia de aprovadores (do usuário origem – Utilizado pela procedure piSubstituiAprovador). OBS: Mesmos campos da temp-table RowObject, mais os campos abaixo. | Entrada/Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
Id-sit | Integer | | Situação | Não | |
Situacao | Character | x(20) | Descrição da situação | Não | |
r-rowid | Rowid | | Rowid do registro | Não | |
tt-mla-hierarquia-aprov-destino | Entrada/Saída |
Lista de hierarquia de aprovadores (do usuário destino – Utilizado pela procedure piSubstituiAprovador). OBS: Mesmos campos da tt-mla-hierarquia-aprov-destino. | Entrada/Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evoluçã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. |
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 <character>, OUTPUT <character>, OUTPUT <character >, OUTPUT <integer>, OUTPUT <integer >). |
Descrição | Retorna valores dos campos do índice primário e único da tabela. |
Parâmetros | Descrição |
| pep-codigo pcod-estabel pcod-lotacao pcod-tip-doc pseq-aprov | Empresa Estabelecimento Lotação Documento Sequência |
Retorno | A BO irá retornar o valor contido nos campos do índice primário e único da tabela. |
goToKey |
Requisito | Query estar aberta. |
Sintaxe | RUN goToKey IN h-handle (INPUT <character>, INPUT <character>, INPUT <character >, INPUT <integer>, INPUT <integer >). |
Descrição | Reposiciona registro com base no índice primário e único da tabela. |
Parâmetros | Descrição |
| pep-codigo pcod-estabel pcod-lotacao pcod-tip-doc pseq-aprov | Empresa Estabelecimento Lotação Documento Sequência |
Retorno | A BO irá reposicionar no registro que foi solicitado a BO. |
validateRecord |
Requisito | Queyr posicionada no registro. |
Sintaxe | Run validateRecord in handle (intpu pType). |
Descrição | Validações pertinentes ao DBO. |
Parâmetros | Descrição |
pType | Recebe o tipo de validação. 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 | |
Método Negócio
piSubstituiAprovador |
Requisito | Nenhum |
Sintaxe | RUN piSubstituiAprovador in handle (INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <logical>, OUTPUT TABLE tt-mla-hierarquia-aprov-origem, OUTPUT TABLE tt-mla-hierarquia-aprov-destino). |
Descrição | Substitui usuário na hierarquia de aprovadores |
Parâmetros | Descrição |
| pcEmpresaIni | Empresa inicial a ser considerada para substituição dos aprovadores |
| pcEmpresaFim | Empresa final a ser considerada para substituição dos aprovadores |
| pcEstabIni | Estabelecimento inicial a ser considerado para substituição dos aprovadores |
| pcEstabFim | Estabelecimento final a ser considerado para substituição dos aprovadores |
| pcDestino | Usuário destino a ser considerado para substituição dos aprovadores |
| pcOrigem | Usuário origem a ser considerado para substituição dos aprovadores |
| plSimulaAlteracao | Indica se é apenas um simulação(cria as temp-tables porém não efetiva as alterações na base). |
| tt-mla-hierarquia-aprov-origem | Contém os dados dos registros(Hierarquia de aprovadores) do usuário origem. |
| tt-mla-hierarquia-aprov-destino | Contém os dados dos registros(Hierarquia de aprovadores) do usuário destino. |
Retorno | Retorna as temp-tables tt-mla-hierarquia-aprov-origem e tt-mla-hierarquia-aprov-destino com informações com as hierarquias de aprovadores. As temp-tables contem a situação da atualização de cada um dos registros. |
OpenQuery / SetConstraint / LinkTo
openQuery |
Requisito | Nenhum |
Sintaxe | run openQuery in h-handle (input <character>). |
Descrição | Faz abertuda das querys. |
Parâmetros | Descrição |
p-ordem | Ordenação da abertura. “main” – Abertura da query principal. |
Retorno | Retorna um return-value com o valor “OK” se foi executado com sucesso. |
openQueryMain |
Requisito | Nenhum |
Sintaxe | run openQueryStatic in h-handle (input "Main":U). |
Descrição | Faz a abertura da tabela principal. |
Parâmetros | Descrição |
| |
Retorno | |
#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))