Tempo aproximado para leitura: 00 min


ÍNDICE

  1. Visão Geral
  2. Exemplo de utilização

01. VISÃO GERAL

Abaixo você verá um exemplo de configuração do REST no arquivo appserver.ini para utilização dos aplicativos móveis.

Para informações mais detalhadas sobre o REST do Protheus, consulte a documentação complementar:

REST com ERP Microsiga Protheus

Configuração do REST

02. EXEMPLO DE UTILIZAÇÃO


Habilitar o servidor HTTP do Protheus, na versão 1.1, utilizando a seção HTTPV11.

Nesta seção, será indicado também qual seção será responsável por identificar os sockets que irão responder as requisições de entrada.

[HTTPV11] 

Enable=1 

Sockets=HTTPREST

O segundo passo é criar a seção indicada HTTPREST, nela será inserida a porta onde o REST estará rodando (no exemplo: 8084), quais URIs serão atendidas e se a segurança estará habilitada ou não (para uso com os aplicativos móveis, é obrigatório que esteja habilitado).

[HTTPREST] 

Port=8084

URIs=URIHTML

SECURITY=1

Criar a seções com as URIs (observar o nome colocado no passo anterior.

  • URL: Informar a URL em que os serviços serão expostos.
  • PrepareIn: Qual empresa e filial será utilizada (note que isto impacta diretamente no consumo de licenças do REST).
  • Instances: Quantas instâncias de serviço serão configuradas (note que isto impacta diretamente no consumo de licenças do REST).
  • CORSEnable: Habilitar as requisições de cross-origens compartilhadas (obrigatório para o uso com mobile)
  • AllowOrigin: As origens aceitas no CORS. (* = todas)


[URIHTML]

URL=/rest

PrepareIn=All

Instances=2,2

CORSEnable=1

AllowOrigin=*

Configurar o appserver para iniciar um job chamado HTTPJOB quando for iniciado.

[ONSTART]

jobs=HTTPJOB

RefreshRate=30



Configurar o JOB para que ele inicie o HTTPServer.

[HTTPJOB]

MAIN=HTTP_START

ENVIRONMENT=environment


Abaixo um exemplo de todas as seções configuradas:

[HTTPV11] 

Enable=1 

Sockets=HTTPREST


[HTTPREST] 


Port=8084


URIs=URIHTML


SECURITY=1


[URIHTML]


URL=/rest


PrepareIn=All


Instances=2,2


CORSEnable=1


AllowOrigin=*


[ONSTART]


jobs=HTTPJOB


RefreshRate=30


[HTTPJOB]


MAIN=HTTP_START


ENVIRONMENT=environment



Após executar todas as configurações, ao iniciar o appserver em modo console, deve ser possível visualizar a marcação do REST:


<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>