Pesquisa de ordens de compra

Características do Requisito

Objetivo

Retornar informações referente a ordens de compra.

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 API em modo persistente é:

RUN ccp/ccapi358.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 API.

dsOrderLineZoom			Entrada/Saída
Informações das ordens de compra. Agrupa a temp-table ttOrderLine			Saída

ttOrderLine					Entrada/Saída
Informações da ordem de compra					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
numero-ordem	INTEGER	zzzzz9,99	Ordem de compra	Sim
it-codigo	CHARACTER	X(16)	Código do item	Sim
desc-item	CHARACTER	x(60)	Descrição do item	Não
requisitante	CHARACTER	X(12)	Requisitante	Sim

ttFilters					Entrada/Saída
Filtros que serão aplicados na consulta.					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
cProperty	CHARACTER		Propriedade (Tabela e campo)	Sim
cStartValue	CHARACTER		Valor inicial do filtro	Sim
cEndValue	CHARACTER		Valor final do filtro	Não
iExtend	INTEGER		Tipo de filtro utilizado (1: Valor igual a, 2: Valor contém, 3: Valor começa com)	Sim
cType	CHARACTER		Tipo do campo Ex: string, stringrange, integer, integerrange, date, daterange	Sim

Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execução:

REST_POST_Zoom-ordem-compra
Requisito	Nenhum
Sintaxe	RUN REST_POST_Zoom-ordem-compra in handle (INPUT ttFilters , INPUT QP_start, INPUT REST_count, OUTPUT DATASET dsOrderLineZoom).
Descrição	Retornar os registros referentes ao zoom de ordens de compra.
	Parâmetros	Descrição
	ttFilters QP_start REST_count dsOrderLineZoom	Campos a serem filtrados e seus respectivos valores. Posição inicial para a busca de registros (paginação) Quantidade de registros encontrados (paginação) Informações das ordens de compra.
Retorno	Retorna um dataset contendos informações das ordens de compra (limitado a 50 registros) e quantidade total de registros encontrados.