| Passo a passo: | | Aviso |
|---|
| 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 e TAF - 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→ Smart View - Recursos Humanos - Medicina e Segurança do Trabalho→ Smart View - TAF Automação Fiscal
É 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/7017
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 |
|---|
| | Card |
|---|
| label | 1. 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 |
|---|
| 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
| Dica |
|---|
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 |
|---|
| label | 2. 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 |
|---|
| title | 1. 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 |
|---|
| 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. |
|
| Card |
|---|
| label | 3. Configurador (SIGACFG) |
|---|
| card | | label | 4. 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 |
|---|
| 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.Para que o Protheus consiga se comunicar com o Smart View e fornecer acesso aos relatórios, é necessário configurar o tipo de autenticação.
Para isso, acesse o Configurador > Ambiente - Cadastros > Configuração Smart View.
Selecione a opção Token Protheus e Avançar > Informar como URL Base Smart View o endereço http://localhost:7017 e Testar Conexão > Com a conexão funcionando, clique em Confirmar para finalizar o cadastro. |
| Card |
|---|
| Para acesso aos relatórios Smart View no menu do Protheus, é necessária a inclusão manual de grande parte deles, através do Configurador.
Para isso, acesse Configurador > Cadastros > Menus.
Desmarque a opção Todos os Menus e selecione apenas o menu do módulo que você vai fazer a inserção do menu. Neste exemplo, usaremos o SIGAGPE.
Posicione no nome do módulo > Adicionar, para que todos os menus fiquem à direita da nossa tela.
Localize a pasta Smart View > Novo Item.
Preencha os dados conforme relatório que será incluído no menu e clique em OK.
Após as inclusões necessárias, clique em Gerar > informe SIGAGPE > Gerar.
Com estas configurações, o relatório já está disponível no menu do módulo SIGAGPE e pronto para uso pelo usuário. =)
| Dica |
|---|
Os nomes dos Programas informados no cadastro dos menus, estão disponíveis nas documentações do Desenvolvimento. |
|
|
|
