Produto: | Datasul |
Versões: | 12.1.10 |
Ocorrência: | API para consultas de Estrutura |
Objetivo
Esta API tem a funcionalidade de realizar consultas de estruturas, seja de forma item a item ou por uma faixa de itens, de forma completa ou sumarizada. Baseado nos parâmetros recebidos, a API fará a listagem da estrutura do item.
Funcionamento
Como parâmetros iniciais, são recebidos 3 tabelas temporárias (temp-tables).
tt-param – Tabela temporária de entrada (input)
tt-digita – Tabela temporária de entrada (input)
tt-estrutura – Tabela temporária de saída (output).
A API pode ser executada de forma persistente ou de forma direta, conforme abaixo:
De forma direta:
Run enp/enapi205.p (input table tt-param,
Input table tt-digita,
Output table tt-estrutura).
Persistente:
Run enp/enapi205.p persistent set h-enapi205 (input table tt-param,
input table tt-digita,
Output table tt-estrutura).
Detalhe da execução dos modos, serão descritos abaixo.
Existem 3 formas para realizar a consulta de estruturas.
Este tipo de execução pode ser executado pela API de forma direta ou persistente.
Para execução persistente, basta executar o método pi-principal.
Run pi-principal in h-enapi205.
Obs.: Somente serão pesquisados os itens desta faixa se não houver nenhum registro na tabela temporária tt-digita.
Esta forma também pode ser executada de forma direta ou persistente, semelhante a execução do modo por faixa.
Obs: Somente serão pesquisados, quando houver registro na tt-digita. Com esta parametrização, alguns filtros não são realizados.
Este método somente pode ser executado de forma persistente e não é necessário a execução do método pi-principal.
Deve-se executar conforme abaixo:
RUN setTTParam IN h-enapi205 (INPUT TABLE tt-param).
RUN gera-tt-estrutura IN h-enapi205 (INPUT v-row-id-item,
INPUT c-cod-refer,
INPUT da-data-corte).
RUN getTTEstrutura IN h-enapi205 (OUTPUT TABLE tt-estrutura).
Nos atributos das tabelas temporárias de entrada e saída:
TT-PARAM – Temp-table utilizada para seleção e filtro | |||
Atributo | Tipo | Formato |
|
tipo | Integer |
|
|
nível | Integer |
| INITIAL 19 |
quant-itens | Decimal |
| INITIAL 1 |
validade | Date | 99/99/9999 | INITIAL 12/31/9999 |
item-compon | Logical | Sim/Não |
|
lista | Logical | Sim/Não |
|
item-folha | Logical | Sim/Não |
|
ge-codigo-ini | Integer | >9 |
|
ge-codigo-fim | Integer | >9 |
|
fm-codigo-ini | Char | x(8) |
|
fm-codigo-fim | Char | x(8) |
|
it-codigo-ini | Char | x(16) |
|
it-codigo-fim | Char | x(16) |
|
descricao-ini | Char | x(60) |
|
descricao-fim | Char | x(60) |
|
ref-ini | Char | x(8) |
|
ref-fim | Char | x(8) |
|
ativo | Logical |
|
|
ordem-aut | Logical |
|
|
tod-ordens | Logical |
|
|
obsol-tot | Logical |
|
|
lista-compon | Logical |
|
|
desc-item | Logical | Sim/Não |
|
parâmetro | Logical |
|
|
cod-unid-negoc-ini | Char | x(3) |
|
cod-unid-negoc-fim | Char | x(3) |
|
comprado | Logical |
|
|
fabricado | Logical |
|
|
processo | Char | x(18) |
|
cod-estabel | Char | x(5) |
|
nr-linha | Integer | >>9 |
|
cod-unid-negoc | Char | x(3) |
|
c-processo | Char | x(18) |
|
c-cod-estabel | Char | x(5) |
|
i-nr-linha | Integer | >>9 |
|
c-cod-unid-negoc | Char | x(3) |
|
TT-DIGITA – Temp-table que receberá os itens que serão consultados | ||||
Atributo | Tipo | Formato | Evolução | |
it-codigo | Char | x(16) |
| |
descricao | Char | x(60) |
| |
un | Char | x(2) |
| |
cod-refer | Char | x(8) |
| |
data-corte | Date | 99/99/9999 |
|
TT-Estrutura – Temp-table gerada pela api | |||
Atributo | Tipo | Formato | Evolução |
i-sequen | Int |
|
|
it-codigo | Char | “x(16)” |
|
es-codigo | Char | “x(16)” |
|
sequencia | Int | >>>>9 |
|
row-estrutura | Rowid |
|
|
nivel | Int | >>9 |
|
nivel-inv | Int | >>9 |
|
c-nivel | Char | “x(20)” |
|
chave | Char | “x(40)” |
|
chave-pai | Char | “x(40)” |
|
quant-usada | Decimal | ->>>,>>>,>>9.9999999999 |
|
quant-liquid | Decimal | ->>>,>>>,>>9.9999999999 |
|
quant-sumariz | Decimal | ->>>,>>>,>>9.9999999999 |
|
quant-liq-sum | Decimal | ->>>,>>>,>>9.9999999999 |
|
fator-perda | Decimal | >9.99 |
|
cod-lista-compon | Char | “x(16)” |
|
cod-ref-it | Char | “x(10)” |
|
cod-ref-es | Char | “x(10)” |
|
fantasma | Char |
|
|
data-valid | Char |
|
|
alternativo | Char |
|
|