Linha Microsiga Protheus

Árvore de páginas

Configuração para acesso ao portal do vendedor

Produto:

Protheus
Ambiente:Faturamento (SIGAFAT)

Ocorrência:

Configuração completa para acesso ao portal do vendedor.

Passo a passo:

Abaixo indicamos os cadastros necessários para acesso ao Portal do Vendedor:


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.


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.



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.


  • 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;


Importante

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:

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

  • 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):

[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


Alerta de Risco

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

O processo de configuração para uma nova filial é basicamente o mesmo, mas é necessário ter um novo WebService e Portal.


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

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

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

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



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;



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.


Importante

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.



Pode lhe interessar:

Inclusão de Orçamento no Portal do Vendedor: https://tdn.totvs.com/x/l3-7I

Inclusão de Pedido no Portal do Vendedor: https://tdn.totvs.com/x/PPoDIQ

Invalid Class ARRAYOFUSERFIELD on GRIDLINESEX: https://tdn.totvs.com/x/eh59IQ - aba possíveis inconsistências