Árvore de páginas

Versões comparadas

Chave

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

...

Produto:

Microsiga Protheus®

Ambiente:Gestão de Pessoal (SIGAGPE)

Ocorrência:

Como realizar a configuração do Smart View?

Passo a passo:
Dica
Aviso
titleImportante

A utilização do Smartview está disponível a partir do release 12.1.2310


Os relatórios Smart View liberados para os módulos de RH - Protheus, são:
Smart View - Recursos Humanos - Arquitetura Organizacional
Smart View - Recursos Humanos - Cargos e Salários
Smart View - Recursos Humanos - Gestão de Pessoas
Smart View - Recursos Humanos - Ponto Eletrônico

É de responsabilidade do Suporte:
→ Auxiliar o cliente na inclusão dos relatórios no Menu via Configurador
→ Sanar dúvidas sobre a regra de negócio relacionada aos relatórios de RH.

É de responsabilidade do Framework:
→ Apoio ao cliente em dúvidas/configuração do REST (caso o cliente seja Cloud, a dúvida deve então ser direcionada pra eles)
→ Auxiliar nas configurações gerais do Smart View no Configurador/Web e cadastro do Provedor 
→ Dúvidas sobre customizações de objeto de negócio (o 'fonte' do relatório. Em casos mais aprofundados, o Frame direciona o cliente para o time de ADVPL)

Alguns relatórios já existem no menu da 2310 pois foram expedidos antes do release ser lançado. Os demais relatórios devem ser incluídos manualmente no menu, via Configurador.

Para acesso a pagina do Smart View, deve ser acessado o link http://localhost:7019/startup/

OBS: para facilitar o entendimento, foram inseridos prints dos processos em todo o passo a passo. Todas as palavras em 'azul', representam uma imagem, para abri-la, basta clicar em cima da palavra com o hiperlink.
Exemplo da uma imagem anexada a nossa documentação aqui.

Deck of Cards
idSmart View RH
Card
label1. Configuração do REST + Portas Multiprotocolo

Para configuração do serviço REST, pode ser seguida esta documentação: Configuração do serviço REST
Outra opção mais rápida, seria a configuração do serviço REST diretamente no arquivo appserver.ini do seu ambiente. Para isso, pode ser seguido este exemplo de configuração de REST.

Com base no exemplo de REST listado acima, para conferir se ele está ativo e no ar, você deve abrir o seu Appserver do Protheus e deverá aparecer no console os dados do REST.
Após esta conferência, para acessar o seu REST e conferir a lista de APIs disponíveis, é necessário acessar o endereço web com os dados:  localhost: o número da sua porta informada na sessão HTTPREST no appserver.ini /REST. Com base no nosso exemplo, o endereço de acesso ficaria http://localhost:8085/REST. O usuário e senha pedidos para acessar o REST são os mesmos utilizados por você no acesso ao Protheus.

Aviso
titleImportante

A chave Security deve obrigatoriamente estar como 1. Isso faz com que o REST exija autenticação, ou seja, usuário e senha, o que torna o tráfego dos dados mais seguro.

Também é obrigatorio que o seu usuário do Protheus tenha senha cadastrada no Configurador.


Caso não consiga configurar com a documentação acima, veja o vídeo a seguir: Como configurar o REST

Para a utilização do Smart View, é necessário o uso das portas Multiprocolo, informadas na seção Drivers do appserver.ini:
→ MULTIPROTOCOLPORT=1
→ MULTIPROTOCOLPORTSECURE=0

E também a chave para habilitar as telas na nova interface em PO UI:
APP_ENVIRONMENT= nome do seu ambiente Protheus

Card
label2. Configuração do Smart View

Para iniciar a instalação do Smart View, siga os passos abaixo:
→ Faça download do Instalador do Smart View Agent clicando neste link
Extrair todo o conteúdo do arquivo zip e execute o arquivo SMARTVIEW.AGENTINSTALLER.EXE 
Selecione o diretório de instalação e prossiga para a próxima etapa. Recomendamos que a instalação seja feita no diretório C:\TOTVS
O instalador irá realizar a instalação na pasta SMART-VIEW, criada automaticamente no diretório selecionado
Caso o diretório SMART-VIEW já exista, o instalador perguntará se deseja sobrescrever a instalação anterior, caso não queira, um novo diretório deverá ser informado
Após conclusão, clique na opção Prosseguir.

Você será direcionado para uma página de diagnóstico do Smart View, então nela, clique na opção Configuração do Smart View.

Expandir
title1. Armazenamento de Dados

Aqui você poderá escolher em qual Banco de Dados o Smart View utilizará para salvar seus dados, podendo escolher entre SQLite, PostgreSQL, SQL Server e Oracle. 

Existem duas formas de configurar o banco:

SQLite
Nessa opção não é necessário inserir a senha de Administrador do Banco de Dados, pois ela é experimental, permite fazer alguns testes básicos em funcionalidades do Smart View.
Caso você não use o usuário 'sa' do SQL, recomendamos seguir por esta opção

SQL Server
Nesta opção, você deve ter acesso ao usuário 'sa' do SQL ou outro usuário com permissão de Administrador do banco de dados. Com isso, preencha os dados conforme abaixo:
• Data Source: Nome do Servidor do seu Banco de Dados, pode ser obtido Acessando o Banco
• Initial Catalog: Esse é o nome do seu Banco de dados, pode ser obtido Acessando seu Banco
• User Id: Nome do Usuário administrado do seu Banco de Dados (Exemplo: sa)
• Password: Senha do usuário administrador do Banco de Dados.

Expandir
title2. Configurações da Integração

Nesta etapa, você vai parametrizar os dados de acesso ao Smart View conforme abaixo:

→ Nome do Provedor: você pode escolher qualquer nome
→ Endereço de Descoberta: insira o endereço de seu REST + o texto: /.well-known/treports/security.Exemplo de como ficaria: http://localhost:8085/rest/.well-known/treports/security
→ Configurações avançadas: clique nessa opção - aba Servidor de Licença - informe o IP + Porta do Servidor de Licenças obtidos no appserver.ini + CNPJ da TOTVS 53.113.791/0001-22. Clique em Verificar Disponibilidade, e com o Servidor disponível, clique em Aplicar para finalizar o preenchimento da aba
→ Conectar ao ERP: insira seu usuário e senha de acesso ao Protheus e clique em logar. Com as informações para integração recuperadas com sucesso, clique em Concluir.

O Smart View fará a validação final dos dados, até chegar o fim desta primeira etapa de configuração.

Acessando o Smart View, será solicitado o usuário e senha de acesso ao Protheus.

Expandir
title3. Conectores

Na tela principal do Smart View, acesse o menu à esquerda e clique na opção Conectores.

Clique na opção +Incluir ou +, e escolha a opção Conector Nativo. O preenchimento deve estar conforme abaixo:
→ Nome: você pode cadastrar como preferir
→ Endereço: URL do seu REST

Após Testar a Conexão e o retorno for positivo para o funcionamento do Conector, basta clicar em Salvar.

Dentro do SIGAGPE, teremos que ajustar dados nas tabelas auxiliares S043 e S049, no menu Atualizações - Definições de Cálculo - Manutenção Tabelas.
Na S043, devemos preencher a coluna 'Tipo P&M/Feedz'.
Na S049, devemos preencher a coluna 'Agrupador P&M/Feedz'.
OBS: em ambos casos, o cliente deve decidir sobre qual a forma que considera mais adequada para preenchimento das tabelas.
Card
label3. Manutenção Tabelas
Configurador (SIGACFG)


Card
label4. De x Para de Cargos e Departamentos

O De x Para de Cargos (GPEA944B) é utilizado quando o cliente utiliza a tabela SQ3 com algum nível de exclusividade.
A Feedz não aceita a integração de dois Cargos com o mesmo nome existindo em Filiais diferentes, por este motivo, devemos utilizar esta rotina para 'amarrar' estes dados, de modo que uma única informação seja integrada para a Feedz.

No exemplo a seguir, tenho um Cargo com descrição 'Analista de Suporte' nas filiais M SP 01 e M SP 02.
Neste caso, os Cargos tem o mesmo nível/são exatamente iguais, portanto, antes de processar a integração farei a amarração destes dados.

Acessando a rotina De x Para de Cargos, clique em Incluir para iniciar o vínculo entre os dados.
Insira o código e descrição como preferir, e clique em Outras Ações - Vincular Cargos. Selecione os Cargos que são equivalentes e clique em Salvar.
Após isso, será demonstrada na parte inferior os Cargos vinculados a este cadastro de De x Para, e você pode vincular quantos cargos forem necessários. Finalizando a seleção, basta clicar em Confirmar.

Com isso, teremos nosso cadastro de De x Para do Cargo 'Analista de Suporte' criado e pronto para ser integrado.

A mesma regra é utilizada para os cadastros de Departamentos da tabela SQB, ou seja, caso exista qualquer nível de exclusividade, se faz obrigatório o cadastro de De x Para de Departamentos (GPEA944C).

No exemplo a seguir, tenho um Departamento com descrição 'Suporte' nas filiais M SP 01 e M SP 02.
Neste caso, os Departamentos tem o mesmo nível/são exatamente iguais, portanto, antes de processar a integração farei a amarração destes dados.

Acessando a rotina De x Para de Departamentos, clique em Incluir para iniciar o vínculo entre os dados.
Insira o código e descrição como preferir, e clique em Outras Ações - Vincular Departamentos. Selecione os Departamentos que são equivalentes e clique em Salvar.
Após isso, será demonstrada na parte inferior os Departamentos vinculados a este cadastro de De x Para, e você pode vincular quantos departamentos forem necessários. Finalizando a seleção, basta clicar em Confirmar.

Com isso, teremos nosso cadastro de De x Para do Departamento 'Suporte' criado e pronto para ser integrado.

OBS: o De x Para de Cargos e Departamentos  só é obrigatório se as tabelas  SQ3 ou SQB tiverem algum nível de exclusividade. Caso alguma das tabelas seja totalmente Compartilhada, não é necessário nenhum tipo de cadastro de De x Para, por exemplo: se a SQ3 for CCC e a SQB for EEE, não é necessário o De x Para de Cargos, apenas o de Departamentos.

Card
label5. Integração

Agora estamos prontos para iniciar nossas integrações \õ/

Para isso, vamos acessar a rotina Integração (GPEM939) - Avançar até o passo 2 - Configuração.
Nos parâmetros, teremos:
→ Verificação registro ativo: caso NÃO queira integrar demitidos, selecione a opção 'Somente pelo campo MSBLQL (se houver)'. Se quiser integrar demitidos, selecione então a opção 'Campo MSBLQL (se houver) + vínculo com registro ativo da SRA', com isso, será habilitada a pergunta 'Data de corte demissão'. As demissões anteriores à data informada nesta pergunta não serão integradas para a Feedz.
→ Verificação retorno da integração: caso queira visualizar o log de integração em tela, selecione a opção 'Aguardar o retorno da integração', com isso, será habilitada a pergunta 'Tempo limite (em minutos)'. Nela devemos informar o tempo que queremos aguardar para que seja gerado o log em tela. Caso NÃO queira aguardar o retorno da integração e consultar os dados enviados posteriormente na rotina de Consulta, basta deixar selecionada a opção 'Não aguardar o retorno da integração'.

Avançando para o passo 3 - Opções, teremos a listagem dos dados que podemos integrar para a Feedz.
É extremamente importante que a ordem de integração seja respeitada conforme consta na rotina, caso contrário, não será possível mais a frente a integração de Funcionários e Líderes.
Inicialmente, podemos selecionar as opções Filiais, Cargos, Departamentos e Grupos de Contrato e Avançar.

No passo 4 - Filtro, devemos minimamente fazer o filtro de Filiais para conseguir avançar.

Por fim, no passo 5 - Processamento, efetue a integração com a Feedz.

Ao finalizar a integração, será gerado o Log de Ocorrências em tela, onde é possível consultar quais filtros foram utilizados e se os dados foram integrados corretamente ou não.

Se todos os itens listados anteriormente foram integrados com sucesso, na sequência você pode integrar os Funcionários.
Para isso, retorne na rotina de Integração, no passo 3 - Opções, selecione 'Funcionários', no passo 4 - Filtro, selecione a Filial que o funcionário pertence e a matrícula se necessário (caso não seja uma integração geral da Filial) e conclua a integração. Se o cadastro do Funcionário tiver todos os dados necessários, no Log de Ocorrências será possível verificar a integração concluída com sucesso.

OBS: caso a tabela SQ3 ou SQB sejam totalmente compartilhadas, na rotina de Integração - passo 2 - Configuração, será demonstrada a pergunta 'Descrição Cargo/Departamento' com duas opções:
→ Somente Descrição: será integrada apenas a descrição do cadastro, por exemplo: Analista de RH (Cargo) ou Recursos Humanos (Departamento).
→ Descrição + Código: será integrado o código + descrição do cadastro, por exemplo: 01 - Analista de RH (Cargo) ou 00000001 - Recursos Humanos (Departamento).

OBS2: caso o cliente utilize o App MEU RH ou Portal GCH e tenha cadastro de Hierarquias, na rotina de Integração - passo 2 - Configuração, será demonstrada a pergunta 'Código da Visão', onde deverá ser selecionada qual cadastro de Visão existente no módulo 70 - Arquitetura Organizacional, será utilizado.




Pode lhe Interessar:

...