Histórico da Página
...
Produto: | Microsiga Protheus |
Versões: | 11.8 e 12 |
Ocorrência: | Como efetuar a configuração para colocar o portal GCH no ar? |
Passo a passo: | 1) ARQUIVOS DOS PORTAIS Os portais WEB’s do Protheus possuem alguns arquivos de layouts. Será necessário baixar esses arquivos, e descompactar em seus respectivos locais.
a) BAIXANDO OS ARQUIVOS DO PORTAL Esses precisam ser baixados do site de downloads da TOTVS. Procure pela linha de produto Protheus, categoria Arquivo de Portais, e faça o download da versão desejada. https://suporte.totvs.com/portal/p/10098/home
Faça o download do arquivo desejado. Descompacte esse arquivo, de preferência, na pasta “\Protheus_Data\systemload\”. Os arquivos que iremos utilizar são apenas esses:
b) DESCOMPACTANDO OS ARQUIVOS
Os arquivos MZP são arquivos “compactados”. Sendo assim, precisamos descompactar os mesmos. Para isso, iremos utilizar uma função padrão da TOTVS, chama MsDecomp - http://tdn.totvs.com/display/tec/MsDecomp Antes, precisamos estruturar nossas pastas onde esses arquivos serão descompactados. Por uma questão de “boa prática”, normalmente fazemos dessa forma: Dentro da pasta Protheus_Data, criamos a pasta Web, e nela criamos essas 3 pastas:
Agora, vamos descompactar esses arquivos. Para isso, iremos utilizar a função MsDecomp. Uma forma simples de fazer isso é abrir o cadastro de Lançamento Padrão, e no campo Cta Débito, digitar a função desejada:
Vamos ao entendimento da função MsDecomp:
O primeiro parâmetro, é o LOCAL e o ARQUIVO a ser descompactado. O segundo parâmetro é o LOCAL onde deseja descompactar o arquivo. Em ambos os parâmetros, se não for indicado a “raiz” do diretório, ele entende que esses se encontram no RootPath do seu sistema, que normalmente é o Protheus_Data.
Após digitar as informações e todos os parâmetros corretamente, e sair do campo, esse irá executar a função. Após isso, observe que no LOCAL informado no parâmetro 2, encontram-se os arquivos descompactados:
Faça isso para os demais arquivos, em suas respectivas pastas:
2) ARQUIVO INI Anexo segue um exemplo pronto de um arquivo INI do AppServer, porém, claro, esse deverá ser ajustado conforme o seu ambiente. Abaixo segue algumas pequenas explicações sobre o mesmo:
a) AMBIENTE
Elabore um ambiente COMUM, apontando para a base de dados desejada (normalmente a mesma do serviço principal), apontando para uma nova porta do TCP, pois esse será um novo serviço.
Uma sugestão complementar seria apenas ao RPO: utilizar outro que não seja o Oficial, pois, se precisarem compilar algo, será necessário parar também o serviço do Portal.
b) HTTP
Essa deverá ser ativada (Enable=1) em uma porta que esteja livre no seu servidor (Port=8099) A cláusula SessionTimeOut indica o TEMPO LIMITE, em segundos, que o portal ficará aberto sem a sessão expirar. Serve tanto para o RH quanto para o Candidato. c) ONSTART
Essa cláusula executa os serviços que serão utilizados pelo Server. Abaixo será explicado sobre cada serviço. d) WEBSERVICE
Esse é o serviço principal: WebService.
Os demais serviços irão consumir esse webservice para fazer a ligação com o sistema Protheus. A cláusula Environment indica o ambiente no qual esse serviço irá utilizar. A cláusula Instances indica quantas instancias serão abertas. Confesso que nunca entendi direito esse item, mas sempre mantive o valor 1,10. A cláusula SIGAWEB indica qual serviço será consumido dos portais do Protheus.
PREPAREIN
Essa é uma das cláusula principais, pois indica para qual EMPRESA e FILIAL será apontando esse serviço. No caso de base com empresas TESTE, basta colocar 99,01 que funciona belezinha. No caso dos clientes, com grupos de empresas e filiais, fica uma pergunta muito comum, que é: Como que faço para ver TODAS as minha empresas e filiais:
Vejamos alguns exemplos: Se for um cliente que possui GRUPOS DE EMPRESAS distintos, onde as operações administrativas sejam diferentes, sugiro criar um serviço para cada, pois sem dúvidas, os portais serão diferentes (exemplo: logotipo e acessos). Se forem FILIAIS, entra-se num empasse: Como cuidar disso?
Pensando em Candidato, a tabela de Currículos SQG acaba por ser COMPARTILHADA, sendo assim, não terá importância a filial indicada. Pensando em Portal RH, pode-se também compartilhar a tabela de Participantes RD0, e também não ter importância a filial indicada.
Por tratar-se de situação especifica deverá ser configurado conforme a necessidade. O nome das instâncias são apenas sugestivas ( ). Você pode mudar conforme a necessidade, porém, claro, deverá ajustar os demais lugares que fazem referência ao mesmo.
No exemplo acima, se mudarmos para JOB_WEB_TESTE, por exemplo, devemos lembrar de mudar ou incluir a chamada dessa instancia na cláusula ONSTART = JOBS, como também na cláusula da instancia abaixo.
Essa instancia é um complemento ao WebService, pois indica o endereço e a porta (com base na mesma porta indicada na instancia HTTP) que será utilizado pelo Portal.
Observe que na clausula ResponseJob é referenciado a instância do WebService.
A cláusula TCFUserTimeOut é um complemento ao Tempo Limite de conexão do usuário no Portal.
A cláusula DefaultPage indica a pagina principal inicial, sem a necessidade do usuário ter que digitar o endereço manualmente.
A cláusula Path indica o caminho dos arquivos web que foram descompactados no item 1 – B desse manual.
Nosso objetivo será em ter esse resultado:
e) SERVIÇOS DOS PORTAIS
Nos exemplos acima, as cláusulas dos JOBS seguem a mesma ideia do WebService.
Um complemento seria apenas as cláusulas WebServiceLocation, onde é referenciado todo o caminho da instancia do WebService.
As instancias acima seguem a mesma ideia do WS, porém, claro, cada uma referenciando o seu serviço de JOB.
Atente-se para o CAMINHO da pasta onde se encontra os arquivos web.
Nosso objetivo será esse:
f) “SUBINDO” O SERVIÇO
Após configurar corretamente TODOS os itens do arquivo INI, execute o serviço em modo CONSOLE, para analisar as ocorrências:
Em casos onde as configurações estejam corretas, e exista a licença Protheus I para as bases que não sejam da empresa 99, o serviço irá subir sem nenhuma inconsistencia.
Após isso, acesse o endereço do WebService para saber se realmente está OK. No meu exemplo, ficou assim: http://192.168.0.244:8099/ws
Observação:
Se você tentar acessar os portais do Candidato ou do RH, não terá sucesso, pois, antes, é preciso preparar os MENUS e cadastros no Protheus.
3) CRIANDO OS MENUS E USUÁRIOS - PROTHEUS
Pelo módulo 18 - Terminal de Consulta do Funcionário – SIGATCF, acesse as rotinas:
Nesse cadastro, se acessado pela 1ª vez, não terá nenhuma informação.
Para popular essa tabela, vá no menu Outros Ações > Automático, e pronto!
Se necessário, pode apagar a tabela AI7, e gerar novamente.
b) Menus
Esse cadastro provavelmente já estará populado automaticamente. Se não estiver, ou não tiver todas as opções desejadas, apague as tabelas AI8 e AI9, e acesse essa rotina novamente.
Para visualizar a estrutura do menu, vá em Ações Relacionadas > Menu
Sugestão: Não altere nada desse cadastro!!
c) USUÁRIOS
Para que os Participantes tenham acesso ao Portal do RH, é necessário criar um USUÁRIO com seu respectivo perfil de acesso.
Obs.: Não é necessário esse procedimento para o Portal do Candidato.
Para isso, clique em Atualizações > Configurações > Usuários > Genéricos:
Clique em Incluir, e preencha os campos obrigatórios conforme exemplo abaixo:
Em seguida, acesse Outras Ações > Carregar Direitos, para que o sistema carregue TODOS os direitos de acesso para esse usuário:
Com isso, esse USUÁRIO está apto a acessar as rotinas que serão disponibilizadas no menu do Portal do RH
Observação: Não é necessário criar 1 usuário para cada participante. Interprete esse cadastro de USUARIOS DO PORTAL como sendo um Perfil de Acesso.
Logo irei demonstrar na prática essa sugestão. d) PARTICIPANTES
Antes, precisamos verificar o campo RD0_LOGIN. Por padrão, esse não está indicado como USADO, no Configurador.
Sendo assim, acesse o MPSDU, abra a tabela SX3, e no campo X3_USADO, retire o ultimo caracter €:
Agora, acesso o módulo 53 – Avaliação e Pesquisa – SIGAAPD, e vá no cadastro de Participantes.
Inclua um participante, com os dados principais obrigatórios, e atente-se aos seguintes campos:
Indique o USUARIO DO PORTAL ao qual esse participante estará associado, e o seu respectivo LOGIN:
Após incluir esse participante, acesse o menu Alterar Senha, e informa a senha para o mesmo.
4) ACESSANDO OS PORTAIS
Agora, com todos os menus criados, e para o caso do portal do RH, os usuários vinculados ao participante, você terá acesso ao Portais:
a) PORTAL DO CANDIDATO
Acesse o endereço indicado no arquivo INI para o Portal do Candidato. No meu exemplo, ficou assim: http://192.168.0.244:8099/candidato
b) PORTAL DO GESTÃO DO CAPITAL HUMANO
Acesse o endereço indicado no arquivo INI para o Portal do RH – Gestão do Capital Humano. No meu exemplo, ficou assim: http://192.168.0.244:8099/pessoas/
Digite o Usuário e a Senha criado para o participante, selecione a opção Portal RH, e clique em Acessar Portal:
5) CRIANDO UM NOVO PERFIL PARA O PORTAL DO GCH
Conforme mencionei anteriormente, não é necessário criar um usuário do portal para cada participante, mas sim esse ser interpretado como um Perfil de Acesso.
Vamos a um exemplo prático:
O usuário criado (não é o Participante, e sim o Usuário do Portal) possui acesso a TODOS os itens do menu do GCH, conforme imagem abaixo:
Supondo então que desejamos que alguns participantes não tenham acesso a rotina de Demonstrativos > Pagamentos.
Para isso então vamos voltar ao MENU, para sabermos qual é o WebService dessa rotina. Observação Importante: Não exclua nada daqui, será apenas para Consultar:
Agora, vá no cadastro de Usuários do Portal, crie um novo usuário, carregue os Direitos, em seguida, localize o WebService que não deseja apresentar para esse perfil de usuário, e apague o mesmo:
Em seguida, vá no Participante desejado, e vincule o novo usuário do Portal:
Ao acessar o Portal com esse participante, observe que esse não tem mais acesso ao menu que foi deletado dos seus direitos:
6) ALTERANDO OS LOGOTIPOS DOS PORTAIS
Até o momento você deve estar se perguntando: A logomarca que aparece nos portais não são o da TOTVS. Como ele fez isso??
Simples: Pelo seu navegador preferido, acesse o código fonte do site (ou no caso do Chrome, Inspecionar), e veja o local da imagem:
Sendo assim, vá até a pasta do portal que você gostaria de alterar, localize a imagem referenciada, e altere conforme a necessidade:
|
Observações: |
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas