DATASUL 12 – APIs

Agosto_2014
 DATASUL 12 – APIs.

Título do documento
DATASUL 12

Este material apresenta a forma de visualização dos dados das APIs do produto DATASUL 12, com base na utilização do
ProxyGen, disponível na instalação do Progress.

Copyright © 2014 TOTVS. – Todos os direitos reservados.

Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou transmitida por qualquer meio eletrônico ou
mecânico, na sua totalidade ou em parte, sem a prévia autorização escrita da TOTVS, que se reserva o direito de efetuar
alterações sem aviso prévio. A TOTVS não assume qualquer responsabilidade pelas consequências de quaisquer erros ou
inexatidões que possam aparecer neste documento.

TOTVS S.A.
Av. Braz Leme, 1717 – São Paulo-SP
Brasil – www.totvs.com

2 Versão 3.0
 DATASUL 12 – M.E.R

Sumário
Introdução..........................................................................................................................................4
Utilização............................................................................................................................................4
Documentação....................................................................................................................................8
Exemplos............................................................................................................................................8

Versão 3.0 3
 DATASUL 12 – APIs.

Título do documento
Introdução

Uma API (Application Programming Interface) é um programa que recebe parâmetros específicos e executa uma tarefa
determinada no Datasul EMS Framework. A tarefa pode ser uma atualização ou pode retornar informações, resultados de um
cálculo ou um gráfico. Uma API é uma interface aberta para as funções de negócio do Datasul EMS Framework.
Este material apresenta a geração de webservices (.wsdl) com base nas api’s do produto Datasul 12, utilizando o Proxy
Generator o cujo processo é bastante simples.

Utilização

As APIs do produto ficam na estrutura de instalação padrão do produto, por exemplo:<rootpath>/dts_versão/ERP/ems2/acp e são
arquivos binários progress (.r).

Exemplos de Pastas do produto com binários 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

4 Versão 3.0
 DATASUL 12 – M.E.R

No menu do servidor/estação 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 botão New, adicionar o diretório onde se encontram os binários do produto Datasul
- acessar a aba procedures

Versão 3.0 5
 DATASUL 12 – APIs.

- Clicar com o botão direito na caixa percistent procedure -> add -> Persistent...
Título do documento

Selecionar  a api  desejada para criar o webservice

6 Versão 3.0
 DATASUL 12 – M.E.R

Ir em file - > generate e selecionar a opção webservice, será gerado um arquivo wsdl  no c:\tmp.

Para gerar a documentação 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 documentação serão gerados no c:\tmp , conforme exemplo abaixo:

Versão 3.0 7
 DATASUL 12 – APIs.

Título do documento

Documentação

Para buscar as informações sobre o funcionamento, descrição dos parâmetros e dados de retorno recomenda verificar a
documentação das API’s que é dispontilizada com o produto. Um exemplo da estrutura, para consulta dentro do servidor com o
DATASUL instalado é:

<rootpath>\Datasul\dts_versão\ERP\ems2\docapi
<rootpath>\Datasul\dts_versão\ERP\ems5\docapi

Exemplos

Neste material os exemplos gerados são:

EMS2: apapi007.r – gerado na pasta “apapi007”

EMS5: fas735zf – gerado na pasta “fas735zf”

Documentacao (presente na mídia de instalação)

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.

8 Versão 3.0