Manual de instalação e configuração RMS | API Coletor Android

01. DADOS GERAIS:

02. PRÉ-REQUISITOS:

*Sugerimos que após realizar todas as instalações acima, reinicie o servidor.

Atenção: É necessário o webservice do não endereçado ou storemobile, pois o mesmo vai ser utilizado no passo 35, ao qual deve ser informado o caminho.

03. INSTALAÇÃO - Implantação das APIs:

Conforme listado nos pré-requisitos é necessário que a estrutura de diretórios esteja devidamente estruturada na pasta "...\inetpub\wwwroot";

Será necessário liberar permissão total do diretório "wwwroot" para os os usuários IIS (IIS_IUSRS); Esse processo é necessário para que os projetos possam manipular arquivos.

1. Localize a pasta RMS (pacote baixado na central de downloads) ;
2. Copie a pasta RMSServices para o diretório RMS, dentro da estrutura do IIS.
3. 
   1. Caso, já exista esta pasta, basta copiar apenas o conteúdo, para seu diretório RMSServices.
4. Copie a API: Implantar-API,AUTH e NATIVE para o diretório: RMSServices;
5. Acesse a pasta RMSService;
6. Entre na pasta IIS e Crie um pool de aplicação para o Auth;
7. 
8. Selecione o pool criado, clique com o botão direito do mouse e clique em "Advanced Settings" (Opções avançadas);
9. Em "Enable 32-bit Applications" (Habilitar Aplicações 32-bit), altere a opção para "True" (verdadeiro/Sim);
10. 
11. Em "Identity" altere a opção para "LocalSystem";
12. 
13. Clique em "OK" para concluir a alteração do pool.
14. Localize na arvore da esquerda, o diretório RMS>RMSServices;
15. 
16. Clique com o botão direito em "Auth" em seguida Clique em "Convert to Application" (Converter para aplicação);
17. Selecione o pool de aplicação criado no passo 7;
18. Clique em "OK";
19. 
20. Repita o processo para o outro diretório (RMSNative);
21. Acesse o diretório ".../RMSServices/Auth", localize o arquivo "appsettings.json";
22. Abra com o editor de texto de sua preferencia;
23. 
24. Insira as informações de sua base de dados:
    1. HOST = IP do BANCO DE DADOS;
    2. SERVICE_NAME = Nome do serviço (encontrado no arquivo "tnsnames.ora") ;
    3. id = Usuário do BD;
    4. password = Senha BD;
25. Em seguida informe o IP do servidor RMS;
26. Salve o arquivo e feche-o;
27. Para testar, selecione e clique com o botão direito do mouse em "Auth" > Manage Application > Browse;
28. 
29. Assim que a pagina web for carregada, acrescente ao final da URL: "/swagger";
30. Como resultado, você verá esta pagina: 
31. 
32. Acesse a pasta Implantar-API Encontre o arquivo "appsettings.json";
33. 
34. Abra-o com o editor de texto de sua preferencia;
35. Edite o valores das propriedades abaixo:
    
    1. "URL_API": "http://localhost/RMS/RMSServices/Windows-ce/";
    2. "URL_AUTH": "https://XXX.XXX.XX.XXX/RMS/RMSService/Auth/";
    3. (onde 'X' é IP DO SERVIDOR)
36. Abra o IIS;
37. Crie um pool de aplicação para a API.
    1. 
    2. Clique em OK;
    3. Selecione o pool criado, clique com o botão direito do mouse e clique em "Advanced Settings" (Opções avançadas);
    4. Em "Identity" altere a opção para "LocalSystem";
    5. 
       1. Este passo é necessário para que a API consiga manipular arquivos com permissões do sistema operacional.
38. Localize na arvore da esquerda, o diretório RMS>RMSServices;
    1. Identifique a pasta Implantar-API;
39. Converta-o para aplicação vinculando o pool de aplicação criado no passo 13;
    1. Clique com o botão direito em "Implantar-API" em seguida Clique em "Convert to Application" (Converter para aplicação);
40. Para testar, selecione e clique com o botão direito do mouse em "Implantar-API" > Manage Application > Browse;
    1. Quando o navegador abrir, adicione uma "barra"( / ) no final da url.
       1. Feito para acessar a documentação da API.
41. O resultado esperado é esta tela:
    1. 
42. Com isso finalizamos a implantação e configuração da API.
43. Agora volte para o Manual do Coletor Android
44. https://tdn.totvs.com/display/LRMS/WMS0001+Coletor+Plataforma+Android