Documentação de API - ENAPI209 - API para consultas de Estrutura Via Onde-se-usa

Objetivo

Esta API tem a funcionalidade de realizar consultas de estruturas via onde-se-usa, 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 onde os mesmos são usados.

...

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

tt-param - Utilizada para filtrar os itens que farão parte da consulta. Apenas itens cujos dados se enquadrarem em todos os quesitos serão selecionados.

A include enapi209.i1 contém a definição das temp-tables citadas e deve ser chamada no início do programa que fará a execução da API. Segue abaixo as definições:

A API pode ser executada de forma persistente ou de forma direta, conforme abaixo:

De forma direta:

Run enp/enapi209.p (input table tt-param,
                                      Input  Input table tt-digita,
                                     Output table tt-estrutura).

...

Run enp/enapi209.p persistent set h-enapi209 (input table tt-param,
                                                                              Input table tt-digita,
                                                                             Output Output table tt-estrutura).

 Detalhe da execução dos modos, serão descritos abaixo. 

Existem 3 formas para realizar a consulta de estruturas.

...

Obs.: Somente serão pesquisados os itens desta faixa se não houver nenhum registro na tabela temporária tt-digita. 

• Por Itens selecionados (tt-digita);

...

 Obs: Somente serão pesquisados, quando houver registro na tt-digita. Com esta parametrização, alguns filtros não são realizados. 

• Pesquisa por item :

 Este método somente pode ser executado de forma persistente e não é necessário a execução do método pesquisaitens.

...

RUN getTTEstrutura IN h-enapi209 (OUTPUT TABLE tt-estrutura).

Tabelas Temporárias

...

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

TT-PARAM – Temp-table utilizada para seleção e filtro
Atributo	Tipo	Formato
Ge-codigo-ini	Integer	>>9

 

Ge-codigo-fim	Integer	>>9

 

Fm-codigo-ini	Char	>>>>>,>>9.9999

 

Fm-codigo-fim	Char	>>>>>,>>9.9999

 

It-codigo-ini	Char	>>>>>,>>9.9999

 

It-codigo-fim	Char	xx

 

Dt-corte	Date	99/99/9999

 

Nr-niveis	Integer	99/99/9999

 

De-quantidade	Decimal	x(12)

 

Ind-process-mrp	Integer	>9

 

Cod-estabel	Char	Sim/Não

 

Nr-linha	Integer	Sim/Não

 

Cod-unid-negoc	Char	x(3)

 

Sumariza	Logical	>>>,>>>,>>9

 

Estado	Log (Extent 4)	99/99/9999

 

l-agrup-lista	Logical	x(8)

 

 

 

TT-DIGITA – Temp-table que receberá os itens que serão consultados
Atributo	Tipo	Formato	Evolução
It-codigo	Char	“x(16)”

 

Cod-refer	Char	“x(8)”

 

Descricao	Char	“x(36)”

 

Un	Char	“x(2)”

 

Quant-Orig	Decimal	“->>>>>,>>9.9999”

 

Parâmetros de Saída

No retorno da execução enapi209.p, será retornado a tabela temporária tt-estrutura, conforme estrutura abaixo

...

Esta temp-table possui os índices, conforme abaixo

...