Hoje vamos falar sobre a configuração de ativação de HEST, uma etapa importante se você deseja integrar o web service e API em Rest no seu sistema de RP toto, permitindo que o sistema possa se comunicar de forma eficiente em aplicações como sites de e-commerce, aplicações móveis e ferramenta de viagem. E esse conteúdo aqui, ele faz parte do nosso combo desenvolvedor. Lá, além de rest, você vai aprender web service, MVC, POI e muito mais.
E por que vale muito a pena você ou a sua empresa investir num treinamento como esse? Porque todo mundo sabe que é extremamente custoso você desenvolver um relatório, customizar um processo específico da sua empresa. E se você aprender como se faz esse tipo de programação, automaticamente você vai reduzir os custos da sua empresa.
E o que que acontece com um profissional que consegue trazer reduções de custo para sua empresa, automaticamente se torna um profissional muito mais valorizado. Então eu vou deixar um link desse nosso combo desenvolvedor aqui na descrição do vídeo. E quero dizer também que se você tem uma demanda muito grande de desenvolvimento, precisa que seja customizado algum processo específico, pode contar conosco.
RP Sistemas tem excelentes desenvolvedores que podem auxiliar a sua empresa. Vou deixar todos os nossos contatos aqui na descrição do vídeo e não vou te pedir um like, não. Assiste esse conteúdo até o final e depois a gente conversa.
Bom, já vale demais. Bora que tela com computador. >> Olá, seja bem-vindo a mais uma aula do nosso curso de desenvolvimento REST.
Na aula de hoje, nós vamos falar sobre a configuração dos serviços RES para que nós possamos consumir as nossas APIs. Então, eu já trouxe uma documentação para nos auxiliar aqui no processo de configuração. Lembrando que essa é a configuração mais simples que tem para a versão 12.
12410, que é a mais recente do sistema, no momento da gravação dessa aula. Então, antes de iniciarmos aqui todos os procedimentos dessa documentação, nós temos que ir lá onde estão armazenados o nosso sistema Protus. Então, aí na sua base, você deve localizar aonde está o seu app, pois uma vai ter as configurações padrões aí que já vem configurados e a outra que vai ser a nossa utilizada aí pros serviços rest, pois nem sempre você precisa est com o rest ativo, dependendo do tipo de aplicação que você está desenvolvendo e acaba consumindo algumas licenças.
Então, fazendo dessa forma, você só vai ativar os serviços rest quando ele se fazer necessário. No nosso caso aqui do curso, como é para o desenvolvimento de REST, nós vamos usar ele na maioria do tempo, OK? Bom, então vamos fazer uma cópia dele aqui.
Bom, então foi feita a cópia. Eu vou renomear ele aqui só para nós conseguirmos distinguir. Então, underline rest aqui.
Então, vamos ter o nosso app server normal, viu? App server rest. E aí dentro dele que foi feito a cópia, você deve localizar aqui o appsver.
E aqui dentro do appsserver. iniin nós vamos utilizar a documentação para fazermos as nossas configurações. Bom, então já estamos aqui na nossa documentação e paraa ativação do REST, nós precisamos incluir algumas chaves no nosso arquivo.
E aqui na própria documentação ele já descreve quais são elas. Então nós vamos ter o HTTP Job, que é a rotina que inicializa o servidor Rest e configura qual ambiente do Proteus será acessado. Também vamos ter aqui o HTTP REST, que configura um socket que o servidor utilizará para a comunicação, possibilita agrupar as URIs para atender diferentes ambientes e configura se o Rest Server solicitará autenticação de usuário.
E aqui esse ponto é muito importante, pois aqui a partir da versão 12. 410 é obrigatório o uso da chave de autenticação que é o security. Mais pra frente quando nós terminarmos de configurar ele vai abrir uma tela aonde nós devemos colocar um usuário e a senha para acessar os serviços disponíveis do REST.
E aí entra nessa questão aqui de autenticação, OK? Avançando, nós vamos ter aqui o HTTP V11, que ele habilita o uso do WH Server. e agrupa aqui as configurações de soquetes de comunicação.
E por último, vamos ter o HTTP URI, que ele controla a URL base de onde os serviços serão disponibilizados, possui as informações para a preparação do ambiente e controla a quantidade de threads que ficarão disponíveis para responder a requisição. E aqui rapidamente essas trends, só para trazer um significado aqui para vocês, elas são os serviços, né? Então são as execuções que são feitas através do serviço rest.
Cada solicitação tem a sua própria trend aí e um tempo de resposta. Mais paraa frente, quando nós formos falar instâncias aqui no curso, eu trago mais detalhes aqui para vocês, para ficar mais claro este ponto. Mas continuando aqui, o nosso foco agora é a configuração dos serviços.
Então aqui ele já traz uma configuração para nós. Eu vou copiar aqui do HTTP V11 até aqui o HTTPJob. Vou colar lá no nosso appsserver.
iniin e já venho explicando para vocês o que é cada um deles. Bom, então já estou aqui no nosso appsserver. E logo abaixo aqui do web app, eu vou colar as nossas configurações que eu tirei lá da documentação.
Então aqui, pessoal, como não havia comentado com vocês, nós vamos ter o HTTPV11, que ele ativa aqui os serviços rest e ativa também aqui os nossos soquetes. Ou seja, ele tá chamando aqui, ó, a chave abaixo. Logo abaixo aqui no nosso serviço, ele vai definir a porta que será a 8080, a questão da segurança que eu já citei para vocês que é para colocar um login.
Então quando está um é porque está ativo. Zero é sem nenhum tipo de segurança, mas aqui na versão 12. 12410 2410 e acredito que em diante será necessário.
E aqui onde é definido as nossas uris. E aí ele vai chamar a nossa chave aqui de URI, aonde está configurado a nossa URL. Essas URLs vão servir para chamar o nosso serviço na hora que nós tivermos chamando lá os serviços R para acessar a pasta.
Vai ficar algo parecido com isso. Vou colocar entre parênteses apenas para demonstrar para você. local host dois pontos 8080 que é a porta barra rest.
Se você colocasse outro nome aqui, por exemplo, API, aqui no serviço deve ser colocado API também, ficando dessa forma, mas aqui na configuração da documentação está rest. E aqui a nossa URL também vai se chamar rest. Eu trouxe aqui apenas para complementar a explicação.
Esse prepa in, ele se refere aqui a quais ambientes serão preparados os serviços rest qual você quer utilizar. Aqui está a porque é todos. Então ele ele vai englobar todos os ambientes da nossa base, ou seja, tanto as matrizes quanto as filiais, independente de quantas você tiver aí ele será ativo.
E por último aqui as instâncias, aonde é definido aqui o número de trends para execução e qual o número máximo de trends disponíveis. Aqui está dois, pois numa base de teste só é permitido o uso de até duas licenças aí que ele é consumido. Porém, dependendo da quantidade de licenças que você tiver disponível aí você pode configurar mais aqui nas instâncias.
Eu vou entrar mais para frente aqui no nosso curso de uma aula focado apenas nele para ficar mais claro para vocês, pois nós conseguimos configurar mais algumas chaves aqui. Porém aqui, como é uma configuração simples, eu não vou entrar tanto a fundo. Aqui nós vamos ter a chave onart, que é quando inicio o serviço.
Ele vai chamar aqui os jobs http job e o tempo de atualização, que a cada 30 segundos aqui. Avançando, ele chamou aqui a nossa chave HTTP Shop, que chama o serviço principal do HTTP Start, e o ambiente, que é o nome do seu ambiente, que aqui no nosso caso é o environment. Então essa é a configuração mais simples possível pra utilização aí do REST.
Bom, agora para finalizar vamos salvar aqui o nosso appsver. Vou fechar ele aqui e aqui no nosso arquivou criar um atalho dele. Então para criar um atalho aqui do nosso appsver.
Xe basta dar um clique inverso, vira aqui em mostrar mais opções e dentro de mais opções criar um atalho. Bom, ele criou aqui o nosso atalho e aí basta você vir aqui em propriedades e colocar aqui o nosso atalho como menos console. Eu vou recortar ele daqui e colar lá na pasta onde estão os demais serviços do Proteus.
Então aqui tenho os serviços do Proteus. Colei aqui o nosso app server. E aí eu vou colocar esse aqui como rest.
E agora aqui para acessar os nossos serviços é muito simples. Vamos subir aqui o sistema. Então primeiramente o license.
Na sequência vamos subir o nosso DB access. E aí vamos acessar aqui o nosso appsver aqui. Traço o rest.
Então ele começa a carregar aqui as informações e aí ele mostra a ativação do rest. Ele deve aparecer esta mensagem aqui pro REST estar ativo. Então aqui ele traz logo na sequência algumas informações sobre o HTTP V11 que dá o início ali do nosso serviço.
Então ele traz a porte 8080 que nós configuramos e a pasta é onde estão os nossos parâmetros para acessar que é o barra rest. Bom, então com o serviço de rest ativo, nós vamos usar o nosso navegador para conferir se está tudo funcionando corretamente. Então, já estou aqui no meu navegador e para acessar você deve colocar local host dois pontos, o número da porta que é o 808 80/restro da nossa pasta.
Ele vai ficar desta forma. E aí você deve pressionar o enter. Bom, então você será redirecionado para essa página onde é possível acessar aqui os serviços de Rest.
E aqui você faz o login com a um usuário de administrador ou que tenha permissão de administrador. Então aqui no nosso caso eu vou usar o login padrão que é admin e a senha que eu defini que aqui no caso é o número um. Vou clicar aqui para entrar.
E aí ele vai abrir aqui uma lista com todas as APIs aí que você pode fazer o consumo. Então por exemplo aqui clicando em companies e for more details, você já consegue fazer aqui a alguma consulta utilizando o método get sobre as empresas disponíveis aí na sua base de teste. E aí, descendo aqui na lista, são inúmeras possibilidades que você tem aí, você pode descer e explorar toda a documentação e APIs aí disponíveis para consumo.
Bom, pessoal, espero que você tenha gostado dessa aula. Caso tenha ficado com alguma dúvida, deixa aqui nos comentários, que a nossa equipe de suporte terá o maior prazer em auxiliar você. E na próxima aula nós vamos continuar com as nossas configurações, só que agora fazendo as configurações aqui de acesso aos serviços de API com um pouco mais de segurança, configurando os nossos certificados SSL, entre outros parâmetros.
Então, estou aguardando você na nossa próxima aula. Um grande abraço e nos vemos em breve. Bom, se você chegou até aqui é porque você curtiu esse conteúdo.
Então agora sim, amigo, vou te pedir aquele like para dar uma força aqui pro nosso canal e nos incentivar trazer mais conteúdos como esse. E quer aprender sobre HEST, MVC, ADVPL, TL+, POI e muito mais, então eu vou deixar um link do nosso combo desenvolvedor aqui na descrição do vídeo. Espero que em breve você se torne um aluno da FB Sistemas.
Muito obrigado por ter assistido esse conteúdo até agora e aguardo você na próxima semana. Muito mais.
