Configurando o serviço REST via APWebWizard / SRVWizard
O APWebWizard ou SRVWizard é responsável por fazer as atualizações no seu arquivo "appserver.ini" de acordo com sua necessidade para a criação dos mais diversos serviços. Para iniciarmos, conforme imagem abaixo, realize a chamada via smartclient para o seu ambiente desejado:
Image Removed
Image Added
| Card |
|---|
| label | Inicialmente, caso ainda não possua um serviço HTTP, precisaremos criá-lo, como no exemplo da imagem abaixo: |
|---|
|
1) |
...
Configurando serviço HTTP.Inicialmente, caso ainda não possua um serviço HTTP, precisaremos |
...
criá-lo, como no exemplo da imagem abaixo: Informando uma pasta do servidor com o caminho para os serviços Web, a porta do HTTP |
...
, o ambiente a ser utilizado |
...
e a opção de "Protocolo habilitado" |
...
marcada.  Image Added
Após finalizar essa |
Image Removed
...
configuração, encontraremos as seguintes tags no arquivo "appserver.ini": |
...
9293
COMPRESSION=1 (Tag opicional e não carregada pelo wizard)
PATH=C:\ |
|---|
|
|
...
P12BASES\P12127SISTDB\PROTHEUS_DATA_SIS\web
ENVIRONMENT=P12127SISTDB |
|---|
|
| Informações |
|---|
| Apontamos para a PATH da pasta web localizada dentro da estrutura da system, pois outros portais como Portal Gestão Capital Humano e Portal do Candidato necessitaram utilizar as mesmas localizações de path para criação de seus arquivos. Solicitamos a inclusão manual da configuração para compressão GZIP no servidor HTTP, conforme exemplo abaixo, disponível em builds superiores a 7.00.131227A. Essa funcionalidade permite ao servidor realizar automaticamente a compressão dos arquivos antes se serem enviados ao requisitante, permitindo que os arquivos trafegados tenham o seu tamanho reduzido durante o seu download, otimizando o tempo de carregamento inicial do aplicativo. Os arquivos comprimidos são descompactados pelos browsers antes de sua utilização! Valores válidos para a tag "COMPRESSION" Valor | Descrição |
|---|
0 | Desabilitado (padrão) | 1 | Habilitado |
Para mais conhecimentos sobre as tags que você poderá inserir segue um documento de referência TOTVSTEC - Arquivos de Configuração. |
|
...
| Card |
|---|
|
2) Configurando serviço REST. |
Nessa fase vamos habilitar o serviço REST no server Protheus: Escolha a opção REST do menu, em seguida o item |
...
HTTPV11 e clique no botão "editar configurações". |
...
É importante selecionar o item "habilitado" para permitir ao servidor responder as requisições que chegarem!
Também é importante, marcar o item "Autenticação", para que os acessos sejam validados, visto que por padrão todos os serviços REST da TOTVS são públicos.
Na parte inferior da imagem, devemos informar as configurações para a montagem da URL que estará disponível com a relação dos serviços a serem consumidos.
Sendo possível configurar uma URL diferente para cada empresa, nesse momento devemos sempre utilizar a palavra "/rest" seguido com o ID da sua empresa. Por exemplo, na montagem desse exemplo, a minha empresa é "T1", ou seja, meus dicionários são "SX2T10", "SX3T10", etc.
| Informações |
|---|
A utilização obrigatória da palavra "rest" na URL do REST é uma necessidade do app MeuRH, pois é utilizado internamente quando utilizado via aplicativo baixado da apple store ou google play instalado nos celulares. |
...
Image Removed
...
Precisaremos efetuar as configurações na parte superior (Configuração de Sockets) e inferior (Configuração de URIs).  Image Added
Configuração de Sockets, preencha: - Marque a opção de "Habilitado".
- Preencha o Nome → HTTPREST
- Preencha Porta → De própria escolha, no exemplo abaixo usamos 9191.
- Marque item "Autenticação".
 Image Added
Configuração de URIs, preencha: - Preencha o Nome → preferencialmente HTTPENV.
- URL → obrigatório ter a expressão inicial "/rest", posteriormente a essa expressão pode complementar, por exemplo, com o identificador da sua empresa "/rest01" ou "/restT1".
- Empresa/Filial para preparação de ambiente → em geral informamos apenas o código da empresa, e consequentemente, todas as filiais pertencentes serão atendidas. Exceto quando se utiliza o login integrado ao Protheus, pois nesse caso a chave precisa obrigatoriamente conter o valor "ALL".
- Mínimo de Working Threads Ativas, Máximo de Working Threads Ativas, Mínimo de Working Threads Livres, Quantidade de Working Threads de Incremento (dependendo da quantidade de licenças de uso pode ser ajustado)
- Habilitar Cors → deve estar marcado.
- Allow Origin → preenchido com * (asterisco)
- Endpoints Públicos → deverá estar preenchido com as informações: fwjwt/refresh_token,auth
 Image Added
 Image Added
Após finalizar essa configuração, encontraremos as seguintes tags no arquivo "appserver.ini": | Card |
|---|
| [HTTPV11]
ENABLE=1
Sockets=HTTPREST [HTTPREST]
Port=9191
SECURITY=1
URIs=HTTPENV
IPsBind= [HTTPENV]
URL=/RESTT1
PrepareIn=T1,D MG 01
Instances=2,5,1,1
Public=fwjwt/refresh_token,auth
CORSEnable=1
AllowOrigin=* |
|---|
|
| Informações |
|---|
| Os endpoints públicos são APIs não exigem autenticação para que o server Protheus possa responder qualquer requisição! Por exemplo, as APIs do MeuRH que pertencem aos processos de autenticação, visto que são nelas que os nossos serviços realizam as identificações e geração do token para que todas as APIs que necessitam de identificação possam ser executadas. Nas informações acima, foram solicitados que estejam liberadas de autenticação as APIs: Complementando a informação, ao informar "auth" estamos liberando todos os endpoints desse serviço, que basicamente seria o mesmo que informar manualmente todos os métodos existentes até o momento, por exemplo: - auth/login, auth/logout, auth/isLogged, auth/isFirstLogin, auth/renewPassword, auth/resetPassword, auth/ChangePassWithLastPass
Você pode optar por informar manualmente ou todos de uma única vez! |
|
...
- "Habilitar Cors" deve estar marcado, assim como "Allow Origin" preenchido com '*' (asterisco) para permitir que o server possa responder requisições de outros servidores.
- "Endpoints publicos" deverá estar preenchido com as informações 'fwjwt/refresh_token,auth' , pois são os endpoints iniciais responsáveis pela autenticação e geração do token de acesso aos serviços.
Após clicar no botão de confirmação, deverá ser possível visualizar a terceira imagem final da sequencia desse item 2 de configuração!
| Informações |
|---|
|
É possível utilizar um servidor Protheus (AppServer) apenas com os serviços REST, sem a necessidade de configurar os outros jobs e webservices do padrão webex/soap referente ao portal tradicional Gestão do Capital Humano. O aplicativo MeuRH utiliza somente serviços REST em sua utilização, sendo assim, permite a flexibilidade da criação de servidores separados, podendo, caso necessário, reinicializar um server sem prejudicar o outro! |
|
Image Removed
...
Image Removed
...
Caso utilize licenças do tipo OnDemand, faz-se necessário informar de qual módulo as licenças serão consumidas. Essa informação deverá constar dentro do bloco [HTTPENV], contudo, não deve ser informado quando se utiliza o login Integrado ao Protheus. Abaixo um exemplo: [HTTPENV] MODULE=7 |
|
| Card |
|---|
|
3) Configurando processo HTTPJOB.Neste passo, iremos configurar o processo comum que criará um |
...
"JOB" para inicializar o serviço do REST criado anteriormente: Como na imagem abaixo, devemos informar: |
...
- Nome do Job
- Ambiente
- Função Advpl → informar
|
...
- o nome da função que inicializa o serviço, obrigatoriamente:
|
...
...
...
- Habilitar job no start do servidor Protheus
|
...
Image Removed
Abaixo a imagem do Job criado, após a confirmação no botão finalizar!
Image Removed
...
 Image Added
Após finalizar essa configuração, encontraremos as seguintes tags no arquivo "appserver.ini": |
...
[HTTPV11]
Enable=1
Sockets=HTTPREST
[HTTPREST]
Port=8103
URIs=HTTPENV
SECURITY=1
...
...
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT= |
|---|
|
...
P12127SISTDB [ONSTART]
jobs=HTTPJOB |
|---|
|
...
Carregando serviço RESTApós essas configurações do serviço REST, podemos |
...
...
e identificar na imagem abaixo a inicialização dos serviços: |
Image Removed
5) Para validar se o seu serviço REST está sendo carregado adequadamente, verifique se é possível realizar o carregamento dos serviços via browser:
Observe que utilizamos a porta 8103 do REST criada anteriormente, assim o nome da URL definida "/restT1".
Image Removed
 Image Added
|
| Button |
|---|
| Cor | #00BFFF |
|---|
| Texto | Próximo passo! |
|---|
| Link | httphttps://tdn.totvs.com/display/NPR/0.2.4++Passo+4x/RMmmHQ |
|---|
|
Demais passos da configuração: