Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Tempo aproximado para leitura: 00 min


ÍNDICE

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela XXX
    1. Outras Ações / Ações relacionadas
  4. Tela XXX
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

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


Deck of Cards
id1
Card
labelPasso 1

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.

Informações
iconfalse

[HTTPV11] 

Enable=1 

Sockets=HTTPREST

Card
labelPasso 2

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).

Informações
iconfalse

[HTTPREST] 

Port=8084

URIs=URIHTML

SECURITY=1

03. TELA XXXXX

Outras Ações / Ações relacionadas

AçãoDescrição

Card
labelPasso 3

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)


Informações
iconfalse

[URIHTML]

URL=/rest

PrepareIn=All

Instances=2,2

CORSEnable=1

AllowOrigin=*

Card
labelPasso 4

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

Informações
iconfalse

[ONSTART]

jobs=HTTPJOB

RefreshRate=30



Card
labelPasso 5

Configurar o JOB para que ele inicie o HTTPServer.

Informações
iconfalse

[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:

Image Added

04. TELA XXXXX

Principais Campos e Parâmetros

CampoDescrição

Card documentos
InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
TituloIMPORTANTE!

05. TABELAS UTILIZADAS


HTML
<!-- 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>