DATASUL 11 APIs

Agosto_2014

DATASUL 11 M.E.R

DATASUL 11

Este material apresenta a forma de visualizao dos dados das APIs do produto DATASUL 11, com base na utilizao do
ProxyGen, disponvel na instalao do Progress.

Copyright 2014 TOTVS. Todos os direitos reservados.

Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou transmitida por qualquer meio eletrnico ou
mecnico, na sua totalidade ou em parte, sem a prvia autorizao escrita da TOTVS, que se reserva o direito de efetuar
alteraes sem aviso prvio. A TOTVS no assume qualquer responsabilidade pelas consequncias de quaisquer erros ou
inexatides que possam aparecer neste documento.
TOTVS S.A.
Av. Braz Leme, 1717 So Paulo-SP
Brasil www.totvs.com

Verso 3.0

DATASUL 11 M.E.R
Sumrio
Introduo........................................................................................................... 4
Utilizao............................................................................................................. 4
Documentao.................................................................................................... 8
Exemplos............................................................................................................. 8

Verso 3.0

DATASUL 11 APIs.

Introduo

Ttulo do documento

Uma API (Application Programming Interface) um programa que recebe parmetros especficos e executa uma tarefa
determinada no Datasul EMS Framework. A tarefa pode ser uma atualizao ou pode retornar informaes, resultados de um
clculo ou um grfico. Uma API uma interface aberta para as funes de negcio do Datasul EMS Framework.
Este material apresenta a gerao de webservices (.wsdl) com base nas apis do produto Datasul 11, utilizando o Proxy
Generator o cujo processo bastante simples.

Utilizao
As APIs do produto ficam na estrutura de instalao padro do produto, por exemplo:<rootpath>/dts_verso/ERP/ems2/acp e so
arquivos binrios progress (.r).

Exemplos de Pastas do produto com binrios com as APIs:

C:\totvs\datasul\dts-11.5.12-oracle\ERP\ems2\acp Arquivos com nome acapi*
C:\totvs\datasul\dts-11.5.12-oracle\ERP\ems2\abp Arquivos com nome abppi*
C:\totvs\datasul\dts-11.5.12-oracle\ERP\ems2\frbo

Verso 3.0

DATASUL 11 M.E.R

No menu do servidor/estao com o Progress 102B ou superior instalado, existe o programa Proxy Generator:
Abrir o programa proxygen da progress:
- File -> New
- Renomear o nome do Webservice - ex: Datasul
- no boto New, adicionar o diretrio onde se encontram os binrios do produto Datasul
- acessar a aba procedures

Verso 3.0

DATASUL 11 APIs.
- Clicar com o boto direito na caixa percistent procedure -> add -> Persistent...

Ttulo do documento

Selecionar a api desejada para criar o webservice

Verso 3.0

DATASUL 11 M.E.R

Ir em file - > generate e selecionar a opo webservice, ser gerado um arquivo wsdl no c:\tmp.
Para gerar a documentao do webservice, deve-se acessar a proenv do progress e executar o comando do WSDL Analyzer
OPENEDGE
bprowsdldoc [option] wsdl URL or filename [target directory]
exe: bprowsdldoc C:\tmp\Datasul.wsdl c:\tmp
Os arquivos de documentao sero gerados no c:\tmp , conforme exemplo abaixo:

Verso 3.0

DATASUL 11 APIs.

Ttulo do documento

Documentao
Para buscar as informaes sobre o funcionamento, descrio dos parmetros e dados de retorno recomenda verificar a
documentao das APIs que dispontilizada com o produto. Um exemplo da estrutura, para consulta dentro do servidor com o
DATASUL instalado :
<rootpath>\Datasul\dts_verso\ERP\ems2\docapi
<rootpath>\Datasul\dts_verso\ERP\ems5\docapi

Exemplos
Neste material os exemplos gerados so:
EMS2: apapi007.r gerado na pasta apapi007
EMS5: fas735zf gerado na pasta fas735zf
Documentacao (presente na mdia de instalao)
EMS 2: consulte a pasta <rootpath>\Exemplo_pastas_instalacao\datasul\11.5.12\ems2
EMS 5 consulte a pasta <rootpath> Exemplo_pastas_instalacao\datasul\11.5.12\ems5.

Verso 3.0