Assunto
Produto: | Datasul |
Ocorrência: | Documentação de BO |
Nome Físico: | inbo/boin770.p |
Include com Parâmetros: | Inbo/boin770.i |
Banco | movind |
Tabela | mla-lista-aprov-item |
Objetivo
Esta BO tem como objetivo a manipulação dos dados referentes a tabela mla-lista-aprov-item (Lista de aprovadores do item).
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/boin770.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 | ||||
Lista de aprovadores do item. | Entrada/Saída | ||||
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
seq-aprov | integer | >9 | Sequência | Sim |
|
cod-usuar | character | X(12) | Aprovador | Não |
|
it-codigo | character | X(16) | Item | 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 |
| Não |
|
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-lista-aprov-item-origem | Entrada/Saída | ||||
Lista de aprovadores do item (do usuário origem – Utilizado pela procedure piSubstituiAprovador) Obs: Mesmos campos das temp-table RowObject, mais os definidos abaixo. | Entrada/Saída | ||||
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
situacao | character | x(20) | Descrição da situação do registro | Não |
|
id-sit | int |
| Situação do regisro | Não |
|
r-rowid | rowid |
| Rowid do registro | Não |
|
tt-mla-lista-aprov-item-destino | Entrada/Saída | ||||
Lista de aprovadores do item (do usuário destino – Utilizado pela procedure piSubstituiAprovador). OBS: Mesmos campos da temp-table tt-mla-lista-aprov-item-origem. | Entrada/Saída | ||||
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tt-lista | Entrada/Saída | ||||
Lista de aprovadores do item. Obs: Mesmos campos da temp-table RowObject, mais os definidos abaixo. | Entrada/Saída | ||||
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
seq-aprov | integer | >9 | Sequência | Sim |
|
cod-usuar-aprov | character | X(12) | Aprovador | Sim |
|
limite-aprov | decimal | >>,>>>,>>9.99 | Limite de aprovação | Não |
|
rowlista | rowid |
| Rowid do registro | 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. |
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>). | |
Descrição | Retorna valores dos campos do índice primário e único da tabela. | |
Parâmetros | Descrição | |
| pep-codigo pcod-estabel pit-codigo pseq-aprov | Código da empresa Códido do estabelecimento Código do item Sequência |
Retorno | A BO irá retornar o valor contido nos campos do índice primário e púnico da tabela. |
goToKey | ||
Requisito | Query estar aberta. | |
Sintaxe | RUN goToKey IN h-handle (INPUT <character>, INPUT <character>, INPUT <character>, INPUT <integer>). | |
Descrição | Reposiciona registro com base no índice primário e único da tabela. | |
Parâmetros | Descrição | |
| pep-codigo pcod-estabel pit-codigo pseq-aprov | Código da empresa Códido do estabelecimento Código do item Sequência |
Retorno | A BO irá reposicionar no registro que foi solicitado. |
goToKeyRowid | ||
Requisito | Query estar aberta. | |
Sintaxe | RUN goToKeyRowid IN h-handle (INPUT <rowid>). | |
Descrição | Reposiciona registro com base no rowid. | |
Parâmetros | Descrição | |
| prowid | Rowid do registro que será posicionado. |
Retorno | A BO irá reposicionar no registro que foi solicitado. |
validateRecord | ||
Requisito | Query estar 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 |
|
initializeBO | ||
Requisito | nenhum | |
Sintaxe | Run initalizeBO in handle. | |
Descrição | Inicializa as handles da BO. | |
Parâmetros | Descrição | |
|
| |
Retorno |
|
Método Negócio
getListaAprov | ||
Requisito | Nenhum | |
Sintaxe | RUN getListaAprov in handle (INPUT <character>, INPUT <character>, INPUT <character>, INPUT <integer>, INPUT <decimal>, INPUT <logical>, INPUT-OUTPUT TABLE tt-lista) | |
Descrição | Retorna a lista de aprovadores conforme os parâmetros recebidos. | |
Parâmetros | Descrição | |
p-ep-codigo p-cod-estabel p-it-codigo p-cod-tip-doc p-valor-doc p-somente-limite tt-lista | Código da empresa Código do estabelecimento Código do item Tipo de documento Valor do documento Considera somente usuários com limite de aprovação Temp-table com a lista de aprovadores. | |
Retorno | Retorna uma temp-table com a lista de aprovadores. |
piSubstituiAprovador | ||
Requisito | Nenhum | |
Sintaxe | RUN piSubstituiAprovador in handle (INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <character>, INPUT <logical>, INPUT <logical>, OUTPUT TABLE tt-mla-lista-aprov-item-origem, OUTPUT TABLE tt-mla-lista-aprov-item-destino). | |
Descrição | Substitui e/ou elimina usuário da lista de aprovadores do item. | |
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 |
| pcOrigem | Usuário origem (que terá suas pendências transferidas para outro usuário) |
| pcDestino | Usuário destino (que receberá as pendências transferidas). |
| plManterUsuario | Indica se o usuário deve ser mantido ou não na lista caso já exista o usuário detino na lista corrente. |
| plSimulaAlteracao | Indica se é apenas um simulação(cria as temp-tables porém não efetiva as alterações na base). |
| tt-mla-lista-aprov-item-origem | Contém os dados dos registros(Aprovadores do item) do usuário origem. |
| tt-mla-lista-aprov-item-destino | Contém os dados dos registros(Aprovadores do item) do usuário destino. |
Retorno | Retorna as temp-tables tt-mla-lista-aprov-item-origem e tt-mla-lista-aprov-item-destino carregadas com informações dos aprovadores do item. 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. Abertura principal: “main“. | |
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 |
|