...
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:  | 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.
Após salvar os arquivos, basta importar o projeto “*.fluigprj” para dentro do seu projeto. |
|
...
