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
