DATASUL 11 – APIs

Agosto_2014

DATASUL 11 – APIs.

2 Versão 3.0

Título do documentoDATASUL 11

Este material apresenta a forma de visualização dos dados das APIs do produto DATASUL 11, 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-SPBrasil – www.totvs.com

3Versão 3.0

DATASUL 11 – M.E.R

SumárioIntrodução..............................................................................................................................................................4

Utilização...............................................................................................................................................................4

Documentação......................................................................................................................................................8

Exemplos...............................................................................................................................................................8

DATASUL 11 – APIs.

4 Versão 3.0

Título do documentoIntroduçã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 11, 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

5Versão 3.0

DATASUL 11 – 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

DATASUL 11 – APIs.

6 Versão 3.0

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

Selecionar a api desejada para criar o webservice

7Versão 3.0

DATASUL 11 – 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:

DATASUL 11 – APIs.

8 Versão 3.0

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.