...
Os exemplos a seguir considerarão os Web Services hospedados no RM.HOST.
Nota |
---|
A utilização do WebseA utilização do WebseOBS: Para testar os webservices, deve-se utilizar um aplicativo que trabalhe com o protocolo SOAP nas chamadas. Indicamos o SoapUI ou o “WS TOTVS Client” disponibilizado na pasta de instalação do RM. |
...
Deck of Cards |
---|
|
Card |
---|
id | Passo 1 |
---|
label | Passo 1 |
---|
title | Passo 1 |
---|
| Configurar o WS TOTVS Client Para que o TOTVS WS Client consiga acessar os WebServices do RM, é necessário que os mesmos estejam ativos e que o DefaultDB esteja configurado. Para saber como configurar o DefaultDB acesse o link: http://tdn.totvs.com/x/sQSqC Para uso do sistema "TOTVS WS Client" é necessário copiar os arquivos: "TotvsWSClient.exe" e "TotvsWSClient.exe.config" para a pasta RM.Net do seu ambiente configurado. Em seguida, basta editar o arquivo "TotvsWSClient.exe.config" alterando as Tag's "Host", "Port" e "WS-Server" para as configurações do ambiente desejado. Conforme exemplo abaixo: TotvsWSClient.exe.config | <?xml version="1.0"?> <configuration> <appSettings> <add key="Host" value="localhost" /> <add key="Port" value="1180" /> <add key="EnableCompression" value="False" /> <add key="WS-Server" value="http://localhost:8051" /> <add key="WS-UserName" value="mestre" /> <add key="WS-DataServerName" value="GlbUsuarioData" /> <add key="WS-ProcessName" value="GlbAcessoData" /> <add key="WS-CodColigadaSQL" value="" /> <add key="WS-CodSistemaSQL" value="" /> </appSettings> </configuration> |
|
|
Card |
---|
id | Passo 2 |
---|
label | Passo 2 |
---|
title | Passo 2 |
---|
| Localizando o serviço RM que deseja integrar Os serviços do RM são disponibilizados de três formas: - Dataserver: Se você deseja executar operações de CRUD em algum cadastro do RM, utilize esta opção.
- Process: Se você precisa integrar com algum processo do RM (ex: baixa de lançamento, faturar movimento etc), utilize esta opção.
- Consulta SQL: Caso deseje retornar alguma informação do RM que não esteja normalizada em cadastro ou que exista uma Consulta SQL cadastrada, utilize esta opção. Mais informações, clique aqui.
Deck of Cards |
---|
| Card |
---|
id | Dataserves |
---|
label | Dataserves |
---|
title | Dataserves |
---|
| 1) DataServers: Todos os CRUDS dos cadastros desenvolvidos na tecnologia .NET do RM são disponibilizados através do Web Services WsDataServer. Basicamente, oferece quatro métodos principais: - GetSchema: responsável por retornar o schema (XSD) do XML necessário para salvar um registro (saverecord).
- ReadView: responsável por efetuar a leitura do cadastro do RM e retornar um XML contendo registros de acordo com o contexto e o filtro informado.
- ReadRecord: responsável por efetuar a leitura do cadastro do RM e retornar um XML contendo registros de acordo com a chave primária e o contexto informado.
- SaveRecord: responsável por efetuar alterações de registros do cadastro do RM de acordo com o XML informado.
A lista de dataservers (com o ID) disponíveis pode ser obtido aqui ou usando a opção de localizar do aplicativo “TOTVS WS Client” conforme imagem abaixo: ![](/download/attachments/219682921/image2015-12-16%208%3A33%3A3.png?version=1&modificationDate=1450254827000&api=v2) Nota |
---|
| Importante: o passo 4 define o nome do ID que deverá ser passado no parâmetro “DataServer” dos Web Services acima. |
|
Card |
---|
id | ConsultaSQL |
---|
label | ConsultaSQL |
---|
title | ConsultaSQL |
---|
| ConsultaSQL: Retorna o resultado de uma consulta SQL cadastrada no RM. Consultas SQLs são visões de dados criados no RM considerando uma ou mais tabelas e respeitando fórmulas e contextos da aplicação. Detalhes de como criar um consulta sql podem ser obtidos clicando aqui.A utilização do Webse Mais informações sobre a criação de WebServices de consulta SQL, pode ser visto abaixo: http://tdn.totvs.com.br/display/public/rm/TBC+-+Web+Service+ConsultaSQL |
|
|
Card |
---|
id | Passo3 |
---|
label | Passo 3 |
---|
title | Passo 3 |
---|
| Importando os arquivos dos aceleradores para o Fluig: Após a escolha de um cadastro (proveniente de um Dataserver), a opção "Aceleradores Fluig" ficará disponível e permitirá gerar os arquivos de integração do Fluig com o RM. Para ser exato, o aplicativo gera o formulário que expõem os campos marcados como visíveis no TOTVSWSCLIENT, o scritp que consome o Web Service que provê os dados e a classe de Datasets de comunicação com os lookups do RM. Você poderá modificar estes arquivos de acordo com a necessidade de cada projeto e usá-los apenas como ponto de partida para a sua implementação.
![](/download/attachments/219682921/image2015-12-8%2016%3A23%3A26.png?version=1&modificationDate=1449591840000&api=v2)
Após salvar os arquivos, basta importar o projeto “*.fluigprj” para dentro do seu projeto. |
|
...