Passo a passo: | Abaixo indicamos os cadastros necessários para acesso ao Portal do Vendedor:
| Expandir |
|---|
| title | 1 - Configurando o WEBSERVICES |
|---|
| Para habilitar os Portais Protheus, é necessário que os WebServices estejam ativos. Ambos serviços dependem do serviço HTTP do Protheus, que permite que as informações sejam publicadas na WEB. A configuração inicia-se habilitando o serviço HTTP e configurando a porta que todos os outros serviços dependentes deste irão utilizar para a publicação das informações.
| Informações |
|---|
Os serviços devem ser configurados pelo WIZARD, pois a cada módulo WEB instalado são descompactados arquivos importantes no diretório informado na configuração. Estes arquivos são de extensão exclusiva da Microsiga, os *.MZP, e que apenas com o Wizard será possível a correta instalação. No exemplo acima, a configuração está sendo realizada para o caminho LOCALHOST. Para publicá-lo informe o nome da máquina ou o endereço IP. Caso seu serviço HTTP esteja configurado para a porta 80, não deve informá-lo no host. Exemplo localhost/ws. |
| Deck of Cards |
|---|
| | Card |
|---|
| label | Se não for multifilial |
|---|
| | Card |
|---|
| default | true |
|---|
| id | Custo Médio |
|---|
| label | Configuração dos Web Services |
|---|
| A - Acesse o Wizard de configuração dos Serviços;
B - Em Servidor Internet (HTTP/FTP), verifique se o serviço de HTTP já existe, confirme se está habilitado e para qual porta está configurada. Pois estas são informações indispensáveis para o correto funcionamento dos WebServices e Portais.
| Expandir |
|---|
| title | C - Configurando HTTP/FTP |
|---|
| - Realize o Download dos Arquivos de Portais (web_files) do Portal do Cliente;
- Inclua uma pasta web dentro da Protheus Data do Sistema e insira os web_files;
- Insira também os arquivo web_files na pasta systemload
- Selecionar a opção: <HTTP> e clicar na barra superior <Editar> conforme exemplo;
- O sistema apresentará a tela para Configuração da Seçãoonde os principais campos são:
- Flag para Habilitar o Protocolo;
- Path de Arquivos = Caminho da Pasta Web;
- Ambiente = Nome do Ambiente;
- Porta de Conexão = Porta de configuração dos Serviços;
| Dica |
|---|
| Na configuração da Seção, inserimos como exemplo a porta 92, porém ela pode ser alterada caso prefira. Caso definida a porta padrão do serviço HTTP que é a 80, não é necessário especificá-la na configuração do WS e Portais. |
Basta confirmar e gravar as configurações |
D - Configure os Módulos da Web: | Expandir |
|---|
| title | WS TOTVS Linha Protheus Web Services |
|---|
| - Realize as configurações básicas, campos importantes:
- Módulo Web = WS - TOTVS Linha Protheus Web Services;
- Nome da Instância = ws;
- Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "ws";
- Selecione o Environment = Nome do Ambiente;
- Flag para habilitar processos na inicialização do Servidor.
- Realize a Configuração de Host x Empresas/Filiais, campos importantes:
- Host = Server e porta dos Web Services (Deve ser informada a porta informada na Configuração HTTP/FTP);
- Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
- Clique em "Relacionar" e em "Avançar".
Finalizar e confirmar a configuração. |
E - Configure o Portal (Protheus) | Expandir |
|---|
| - Realize as configurações básicas, campos importantes:
- Módulo Web = PP - Portal Protheus;
- Nome da Instância = pp;
- Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "pp";
- Selecione o Environment = Nome do Ambiente;
- URL do Protheus Web Services = Server e Porta de configuração dos Web Services.
- Realize a Configuração de Host x Empresas/Filiais, campos importantes:
- Host = Server e porta do Portal (Deve ser informada a porta informada na Configuração HTTP/FTP);
- Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
- Clique em "Relacionar" e em "Avançar".
- Realize a Configuração de Usuários, onde irá definir o número mínimo e máximo de usuários para acesso.
Finalizar e confirmar a configuração. Inclua na pasta pp os colocar o arquivos da pasta web na systemload |
F - Após as configurações acima, o sistema irá inserir as informações de acesso aos Web Services no arquivo AppServer.ini do Protheus, verifique se as informações estão de acordo com o exemplo abaixo, caso não estejam realize ajustes (Lembrando que a Porta e o Nome do Ambiente serão os que preencheu durante a configuração): | Expandir |
|---|
| [HTTP] ENABLE=1 PORT=81
[localhost:92/ws] ENABLE=1 PATH=c:\seuambiente\Protheus_Data\web\ws ENVIRONMENT=12.1.025 INSTANCENAME=ws RESPONSEJOB=JOB_WS_9901 DEFAULTPAGE=wsindex.apw SECURITY=0
[JOB_WS_9901] TYPE=WEBEX ENVIRONMENT=12.1.025 INSTANCES=1,1 SIGAWEB=WS INSTANCENAME=ws ONSTART=__WSSTART ONCONNECT=__WSCONNECT PREPAREIN=99,01 SECURITY=0
[localhost:92/pp] ENABLE=1 PATH=c:\seuambiente\Protheus_Data\web\pp ENVIRONMENT=12.1.025 INSTANCENAME=pp RESPONSEJOB=JOB_PP SECURITY=0
[JOB_PP] TYPE=WEBEX ENVIRONMENT=ENVIRONMENT INSTANCES=1,1 SIGAWEB=PP INSTANCENAME=pp ONSTART=STARTWEBEX ONCONNECT=CONNECTWEBEX ONEXIT=FINISHWEBEX WEBSERVICELOCATION=http://localhost:92/ws SECURITY=0
| Dica |
|---|
| "Fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização." |
|
G - Por fim, reinicie o Server do Protheus e verifique se o serviço do WebService subiu de forma correta no Browser, basta digitar o caminho que configurou no Wizard e verificar se o sistema indica como Habilitado: 
|
|
| Card |
|---|
| | Card |
|---|
| default | true |
|---|
| id | 060720201 |
|---|
| label | Configuração dos Web Services Multifilial |
|---|
| O processo de configuração para uma nova filial é basicamente o mesmo, mas é necessário ter um novo WebService e Portal.
| Expandir |
|---|
| title | A - Configurar WS TOTVS Linha Protheus Web Services |
|---|
| - Realize as configurações básicas, campos importantes:
- Módulo Web = WS - TOTVS Linha Protheus Web Services;
- Nome da Instância = ws;
- Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "ws";
- Selecione o Environment = Nome do Ambiente;
- Flag para habilitar processos na inicialização do Servidor.
- Realize a Configuração de Host x Empresas/Filiais, campos importantes:
- Host = Server e porta dos Web Services (Deve ser informada a porta informada na Configuração HTTP/FTP);
- Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
- Clique em "Relacionar" e em "Avançar".
Finalizar e confirmar a configuração. |
| Expandir |
|---|
| title | B - Configurar PP Portal Protheus |
|---|
| - Realize as configurações básicas, campos importantes:
- Módulo Web = PP - Portal Protheus;
- Nome da Instância = pp;
- Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "pp";
- Selecione o Environment = Nome do Ambiente;
- URL do Protheus Web Services = Server e Porta de configuração dos Web Services.
- Realize a Configuração de Host x Empresas/Filiais, campos importantes:
- Host = Server e porta do Portal (Deve ser informada a porta informada na Configuração HTTP/FTP);
- Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
- Clique em "Relacionar" e em "Avançar".
Finalizar e confirmar a configuração. |
| Informações |
|---|
Os serviços devem ser configurados pelo WIZARD, pois a cada módulo WEB instalado são descompactados arquivos importantes no diretório informado na configuração. Estes arquivos são de extensão exclusiva da Microsiga, os *.MZP, e que apenas com o Wizard será possível a correta instalação. No exemplo acima, a configuração está sendo realizada para o caminho LOCALHOST. Para publicá-lo informe o nome da máquina ou o endereço IP. Caso seu serviço HTTP esteja configurado para a porta 80, não deve informá-lo no host. Exemplo localhost/ws. Pra cada filial nova é necessário configurar um novo portal. |
C - Após as configurações acima, o sistema irá inserir as informações de acesso aos Web Services no arquivo AppServer.ini do Protheus, verifique se as informações estão de acordo com o exemplo abaixo, caso não estejam realize ajustes (Lembrando que a Porta e o Nome do Ambiente serão os que preencheu durante a configuração): | Expandir |
|---|
| [HTTP]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\Web
PORT=91
ENVIRONMENT=nome do ambiente [localhost:91/ws]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\WS
ENVIRONMENT=nome do ambiente
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_9901 → (Filial 01)
DEFAULTPAGE=wsindex.apw [JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01 → (Filial 01) [ONSTART]
;JOBS=JOB_WS_9901,JOB_PP,JOB_WS02_9902,JOB_PP02 [localhost:91/pp]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\pp
ENVIRONMENT=nome do ambiente
INSTANCENAME=pp
RESPONSEJOB=JOB_PP [JOB_PP]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=PP
INSTANCENAME=PP
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://localhost:91/ws → (URL da filial 01)
[localhost:91/ws02]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\WS02
ENVIRONMENT=nome do ambiente
INSTANCENAME=WS02
RESPONSEJOB=JOB_WS02_9902 → (Filial 02)
DEFAULTPAGE=wsindex.apw [JOB_WS02_9902]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=WS02
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,02 → (Filial 02) [localhost:91/pp02]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\pp02
ENVIRONMENT= nome do ambiente
INSTANCENAME=pp02
RESPONSEJOB=JOB_PP02 [JOB_PP02]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=PP
INSTANCENAME=pp02
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://localhost:91/ws02 → (URL da Filial 02) |
D - Por fim, reinicie o Server do Protheus e verifique se o serviço do WebService subiu de forma correta no Browser, basta digitar o caminho que configurou no Wizard e verificar se o sistema indica como Habilitado:
|
|
|
|
| Expandir |
|---|
| title | 2 - Portal Configurando o acesso do vendedorusuário |
|---|
| | Card |
|---|
| default | true |
|---|
| id | 060720201 |
|---|
| label | Portal do Vendedor |
|---|
| Após a configuração dos Web Services, iniciaremos a configuração do Portal do Vendedor. Para isso: - Acesse Faturamento / Atualizações / Portal / Web Service e clique em Automático;
- Serão carregados os Web Services;
- Acesse Faturamento / Atualizações / Portal /Menu dos Portais e verifique se os menus estão carregados;
Agora é necessário realizar a configuração do Usuário do Portal. Para isso: |
|
| Expandir |
|---|
| title | 3 - Configurando o Portal do vendedor |
|---|
| | Card |
|---|
| default | true |
|---|
| id | 060720201 |
|---|
| label | Portal do Vendedor |
|---|
| Acesse Faturamento / Atualizações / Portal / Usuários e inclua um novo usuário; - Digite o usuário, o nome e a senha de acesso do usuário;
- Vincule um usuário interno do sistema que esteja vinculado com um vendedor;
- Após salvar, visualize o Usuário do Portal, será preenchida automaticamente a linha de vendedor;
- Clique na aba direitos, do cadastro de usuário do Portal, selecione Ações relacionadas / Carrega Direitos e serão carregados os direitos.
Para acessar o Portal do Vendedor, verifique se o serviço do WebService <PP> subiu de forma correta no Browser. Digitando usuário e senha do Portal cadastrados, é possível visualizar as rotinas no Portal do Vendedor.
| Dica |
|---|
| MV_PORTAL1 - permite que seja especificado o caminho (path) do arquivo txt que contém o fonte html que apresenta um texto institucional (ou outro, se desejado) a ser exibido na Pagina principal do Portal Protheus.
O texto a ser exibido pode ser livremente editado, utilizando-se de todos os recursos disponíveis em html, como formatação do texto, cor, indentação, entre outros. O arquivo deve obrigatoriamente ser armazenado dentro da Raiz RootPath do Microsiga Protheus Server.
Recomenda-se que o mesmo seja mantido dentro do diretório web do Portal Protheus, por questões de organização, embora esta seja uma pratica facultativa. Exemplo:\web\portal_protheus\institucional.txt
Utilizar um caminho/diretório errado neste parâmetro, assim como nos demais parâmetros MV_PORTAL (2,3 e 4) , pode travar o acesso as rotinas por meio do menu e trazer falha de comunicação com a base de dados
A linguagem do Portal será demonstrada de acordo com o preenchimento da chave "RpoLanguage" dentro do appserver.ini do ambiente configurado. Conforme a linguagem que for carregada nesta chave, esta será demonstrada no portal quando o usuário efetuar o acesso. Exemplo: RpoLanguage = Portuguese fará com que o portal seja demonstrado na linguagem selecionada. |
|
|
|
