Documentação de API - ENAPI205 - API para consultas de Estrutura

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).

Tabelas Temporárias

Nos atributos das tabelas temporárias de entrada e saída:

Parâmetros de Entrada

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

 


Parâmetros de Saída

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