Versões comparadas

Chave

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

...

Linha de Produto:

TOTVS Automação de Ponto

Versão:

12.x

Passo a Passo:

Neste documento iremos realizar a parametrização do ambiente que irá realizar a integração entre o RM e o Suricato (Telemática).

Para iniciarmos a parametrização da integração, siga os passos abaixo:


Webservice 

O Webservice é o meio de comunicação que o RM realiza com o Suricato. Para obter o Webservice, acesse o portal de download da totvs ( http://suporte.totvs.com.br ) e baixe o seguinte arquivo: “INTEGRACAO CHRONUS X TSA”.

Image Added

Observação 1: Este arquivo poderá ser executado apenas para as versões 12x.

Observação 2: A nomenclatura do instalador do Webservice será alterada, porém, não interferirá em nada a comunicação entre RM & Suricato. Podendo assim, ser executado normalmente.

Após realizar o download do arquivo, será necessário realizar a instalação do mesmo. 

Execute o MSI e siga as instruções abaixo:
Nesta tela, deverá ser informado um local para que o Webservice possa ser instalado.

Image Added

Image Added

Na tela acima, é informado no arquivo “Alias.dat” do seu Webservice os dados do servidor onde se encontra a base de dados RM e o “Alias” representa o nome da base de dados (no caso deste documento, a base RM utilizada para a integração com o Suricato, é a base Exemplo_Integracao_RM_TSA.

Na tela abaixo, será necessário informar a mesma porta que foi informada na instalação do Suricato e informe também o servidor do serviço para o Suricato.

Image Added

A tela abaixo permite ao usuário informar uma pasta onde será salvo o LOG de informações que serão geradas durante a integração. No item IIS (Internet Information Services) será utilizado para inclusão de um diretório virtual.

Image Added

Após estes procedimentos, avance até o final do processo e finalize a instalação do Webservice RM.

Para verificar se as informações foram criadas corretamente de acordo com a instalação, acesse a pasta onde foi informada (No caso do exemplo será a pasta C:\TSA).

Image Added

Esta pasta TSA é o Webservice RM que criamos anteriormente. O Webservice possui dois arquivos de extrema importância para que a integração entre o RM e o Suricato funcione corretamente. Os arquivos possuem as seguintes descrições:

Arquivo Alias.dat

Image Added

Image Added

Observação: As informações acima, são preenchidas no momento da instalação do Webservice RM. Estas informações são referentes a conexão com a base de dados RM.


Arquivo Web.config

Image Added

O Web.config, possui informações que são tanto do RM quanto do Suricato;

Neste arquivo será informado na tag “<add key="Alias" value="CorporeRM" />” o mesmo Alias de acesso utilizado no arquivo Alias.dat (Neste caso, será utilizado o Alias “CorporeRM”). Já as tags que se iniciam com as informações de “add key="TSA_WebServices...” são referentes aos serviços do TSA.

Exemplo:

<add key="TSA_WebServices.ShiftWorkIntegrationServiceBeanService.ShiftWorkIntegrationServiceBeanService" value="http://BHD050100892:8080/tsa-ejb/ShiftWorkIntegrationServiceBean" />

Nesta tag está sendo informado o serviço “ShiftWorkIntegrationServiceBean”, este serviço é referente ao Turno(Horários) que se encontra no Automação de Ponto. Na tag citada como exemplo, encontra-se ainda a informação do serviço do Suricato, constando o servidor do serviço e a porta (informados no momento da instalação do Webservice RM).

TimeOut

Dentro do arquivo Web.config, será necessário a inclusão da tag “<add key="ConEAITimeOut" value="390000000" />” para o controle/aumento do tempo de execução dos processos envolvendo a integração entre os produtos RM & Suricato.

Para finalizar a montagem dos ambientes RM e Suricato, montaremos um diretório virtual no IIS do sistema operacional. Para criar este diretório, iremos acessar o IIS (Internet Information Services), acesse o menu iniciar do seu computador e digite IIS.

Image Added

Image Added

Após abrir o IIS, clique em Sites / Default Web Site.

Image Added

Clique com o botão direito em “Default Web Site” -> Adicionar Aplicativo.

Image Added

Será aberto uma tela de cadastro onde deverá ser informado o Alias e o Caminho físico.
Image Added

Dê um nome para o Alias (Dica: Utilize o mesmo nome da pasta que você informou para o Webservice RM. O campo “Caminho Físico” deverá ser preenchido com o endereço do Webservice RM. 

Clique em “Ok” e salve o cadastro do diretório virtual.

Após salvar o cadastro do diretório criado, selecione o diretório que criou (No caso o “TSA” → Nome da pasta que contém o WebService) e clique em “Procurar *:80(http) para conferir se a conexão está funcionando. (Veja exemplo abaixo).

Image Added

Ao clicar, o browser que será aberto deverá conter a seguinte informação:

Image Added

Tendo estas informações em sua tela, significa que existe uma conexão estabelecida.


Criação de Tabela intermediária para integração TSA/Suricato:

É necessário executar script para criação de tabela intermediária.


Os próximos passos deverão ser executados na MDI do RM.:

Acessar o módulo "Serviços Globais" para definir as permissões de acessos aos menus que serão utilizados durante o procedimento de parametrização dos produtos da linha RM.

Verificar os perfis associados ao usuário logado.

Observação: Verificar os usuários dos seguintes produtos (Automação de Ponto / Folha de Pagamento / Gestão de Pessoas):

Edite o usuário desejado e vá na aba “Segurança”


Verifique agora as permissões do usuário da parte de “Integração”

Edite o usuário desejado

Após verificação acima, acesse o menu Segurança / Perfis selecione o perfil de “Integração”

Recolha tudo. Expanda os itens 02 e 02.01 e permita acesso ao item 02.01.02

Na medida em que forem encontrando itens sem permissão, acesse o módulo "Serviços Globais", e dê permissão ao menu desejado.

O próximo passo para parametrizar o ambiente é configurar o Webservice no Conector.

Acesse: RM / Integração

Ao clicar em Integração, vá ao menu Ferramentas / Parâmetros. Avance até chegar na tela abaixo:

Selecione a primeira opção (50.01 – Configurações Gerais ByYou ESB) e preencha os campos com as seguintes informações:

O campo URL do WebService deverá ser preenchido de acordo com o servidor onde se encontra instalado o Webservice RM. Neste exemplo, foi utilizado o servidor “BHD050100892”.

Avance até o final do processo.

Fórmula Visual

Dando continuidade na parametrização para integrar o RM com o Suricato, iremos realizar a importação das fórmulas visuais no sistema para realizar a integração. Para importar as fórmulas visuais, primeiramente temos que definir uma categoria contendo o perfil desejado para realizar a importação das fórmulas.

Acesse RM / Serviços Globais / Gestão

Ao acessar o menu “Gestão”, vá em Fórmula Visual / Categorias

Ao entrar no menu Categoria, crie uma categoria específica para o Suricato


Ao clicar para incluir uma nova categoria, dê uma descrição para sua categoria e acesse a aba “Perfis da Categoria da Fórmula Visual”

Selecione os perfis referente aos produtos abaixo:

- Folha de Pagamento;
- Automação de Ponto;
- Gestão de Pessoas;

Após selecionar os três produtos, a tela de perfil de categoria deverá ficar conforme exemplo abaixo:

Salve a categoria para que em sequência seja possível realizar a importação das fórmulas visuais.

Após o cadastro da categoria de perfil, acesse novamente a opção Fórmula Visual, clique em Fórmula Visual

Ao entrar em fórmula visual, vá em “Processos / Importação de Fórmula Visual”

Siga conforme as imagens abaixo:


Para importar as fórmulas visuais referentes ao Suricato, acesse o caminho (C:\totvs\CorporeRM\ObjetosGerenciais\Fórmulas Visuais) e selecione a fórmula visual “Formulas_Visuais_TSA.TotvsWF”.

Observação: A nomenclatura da fórmula visual será alterada, porém, não interferirá em nada a comunicação entre RM & Suricato. Podendo assim, ser importada normalmente.

Ao selecionar a fórmula visual do TSA, deverá ser exibida a tela abaixo:

Esta tela demonstra todas as fórmulas visuais que deverão ser importadas para que a integração entre o RM e o Suricato funcione corretamente.



O usuário terá opção de importar as fórmulas para uma ou mais coligadas.

O usuário deverá preencher o campo “Categoria” com a categoria criada anteriormente. Já o parâmetro “Importar Gatilhos”, tem como função importar automaticamente o gatilho da fórmula visual em seu devido processo, exemplo:

A fórmula visual que está selecionada na imagem anterior, é referente ao cadastro de coligadas. Caso o parâmetro “Importar Gatilhos” esteja marcado, não será necessário o usuário alocar manualmente a fórmula visual no cadastro de coligadas, neste caso, com o parâmetro marcado o sistema irá fazer o processo automaticamente.

Observação: Faça o mesmo processo para TODAS fórmulas visuais que estão nesta visão.

Após realizar este procedimento para todas fórmulas, execute o processo e deverá obter o seguinte resultado.



Para verificarmos se as fórmulas visuais foram importadas corretamente, acesse 1 processo para conferência. Exemplo:




Acesse o menu RM / Serviços Globais / Coligadas, vá em “Processos / Fórmula Visual / Gerenciar”


Ao entrar em “Gerenciar” verá que a fórmula visual da coligada foi importada corretamente, conforme imagem abaixo:

Para finalizarmos as parametrizações e começarmos a integrar informações do RM ao Suricato, será necessário acessar RM / RH / Automação de Ponto

Ao acessar o sistema de Automação de Ponto, vá na aba “Configurações / Parametrizador”

Siga as etapas abaixo:

Avance até a etapa 5 – “Integração”. Marque o parâmetro “Utilizar integração com o TSA”.

Avance até o final para concluir a alteração realizada no parametrizador.

Observação: A nomenclatura o parâmetro “Utiliza integração com o TSA” será alterada, porém, não interferirá em nada a comunicação entre RM & Suricato. Podendo assim, ser marcada normalmente.

Ainda no sistema de ponto, acesse a aba “Entrada de Dados / Importar”.

Ao clicar em “Importar”, marque a opção “Utilizar integração com o TSA” .

Marcando este parâmetro, todas as batidas realizas realizadas pelos funcionários serão armazenadas em uma tabela da base de dados do RM chamado MSA_CONTROL_MARCAC. Com as batidas armazenadas nesta tabela e este parâmetro no RM marcado, o usuário terá apenas que realizar a execução do processo.

Observação 1: A marcação e a filtragem de funcionários a serem executados, serão utilizadas de acordo com a necessidade do usuário.

Observação 2: A nomenclatura do parâmetro “Utilizar integração com o TSA” será alterada, porém, não interferirá em nada a comunicação entre RM & Suricato. Podendo assim, ser marcada normalmente.

Acesse o RM / RH / Folha de Pagamento.

Ao acessar o Folha de Pagamento, vá na aba “Seções”.

Ao abrir as seções, acesse “Processos / Fórmula Visual / Gerenciar”.

Ao abrir a tela de “Gerenciar” verá que já existe uma fórmula visual vinculada a um processo, porém, será necessário vincular também a fórmula visual de “Carga Inicial”. Para vincular a fórmula visual da carga inicial, siga conforme as imagens abaixo:

A parametrização para realizar a integração entre os produtos RM e Suricato está finalizada. Antes de executar a carga inicial, devemos realizar o procedimento de verificação de base que se encontra no sistema de Automação de ponto.

Acesse RM / RH / Automação de Ponto / Configurações / Verificação de Base.

A verificação de base é importante para verificarmos se existe algum horário inconsistente na base de dados, para que a carga inicial não seja interrompida.

Carga Inicial

A Carga inicial é executado pelo RM, e se encontra na tela de seções do sistema de folha de pagamento. Tem como objetivo transmitir os dados do RM ao Suricato, por exemplo (Funcionários, Seções, Centro de Custo, Horários, etc...)

Confira no exemplo abaixo como realizar a carga inicial.

Acesse o cadastro de seção, selecione as seções desejadas e gere a carga inicial.

Webservice 

O Webservice é o meio de comunicação que o RM realiza com o Suricato. Para obter o Webservice, acesse o portal de download da totvs ( http://suporte.totvs.com.br ) e baixe o seguinte arquivo: “INTEGRACAO CHRONUS X TSA”.

Image Removed

Observação 1: Este arquivo poderá ser executado apenas para as versões 12x.

Observação 2: A nomenclatura do instalador do Webservice será alterada, porém, não interferirá em nada a comunicação entre RM & Suricato. Podendo assim, ser executado normalmente.

Após realizar o download do arquivo, será necessário realizar a instalação do mesmo. 

Execute o MSI e siga as instruções abaixo:
Nesta tela, deverá ser informado um local para que o Webservice possa ser instalado.
Image Removed

Image Removed

Na tela acima, é informado no arquivo “Alias.dat” do seu Webservice os dados do servidor onde se encontra a base de dados RM e o “Alias” representa o nome da base de dados (no caso deste documento, a base RM utilizada para a integração com o Suricato, é a base Exemplo_Integracao_RM_TSA.

Na tela abaixo, será necessário informar a mesma porta que foi informada na instalação do Suricato e informe também o servidor do serviço para o Suricato.

Image Removed

A tela abaixo permite ao usuário informar uma pasta onde será salvo o LOG de informações que serão geradas durante a integração. No item IIS (Internet Information Services) será utilizado para inclusão de um diretório virtual.

Image Removed

Após estes procedimentos, avance até o final do processo e finalize a instalação do Webservice RM.

Para verificar se as informações foram criadas corretamente de acordo com a instalação, acesse a pasta onde foi informada (No caso do exemplo será a pasta C:\TSA).

Image Removed

Esta pasta TSA é o Webservice RM que criamos anteriormente. O Webservice possui dois arquivos de extrema importância para que a integração entre o RM e o Suricato funcione corretamente. Os arquivos possuem as seguintes descrições:

Arquivo Alias.dat

Image Removed

Image Removed

Observação: As informações acima, são preenchidas no momento da instalação do Webservice RM. Estas informações são referentes a conexão com a base de dados RM.

Arquivo Web.config

Image Removed

O Web.config, possui informações que são tanto do RM quanto do Suricato;
Neste arquivo será informado na tag “<add key="Alias" value="CorporeRM" />” o mesmo Alias de acesso utilizado no arquivo Alias.dat (Neste caso, será utilizado o Alias “CorporeRM”). Já as tags que se iniciam com as informações de “add key="TSA_WebServices...” são referentes aos serviços do TSA.

Exemplo:

<add key="TSA_WebServices.ShiftWorkIntegrationServiceBeanService.ShiftWorkIntegrationServiceBeanService" value="http://BHD050100892:8080/tsa-ejb/ShiftWorkIntegrationServiceBean" />

Nesta tag está sendo informado o serviço “ShiftWorkIntegrationServiceBean”, este serviço é referente ao Turno(Horários) que se encontra no Automação de Ponto. Na tag citada como exemplo, encontra-se ainda a informação do serviço do Suricato, constando o servidor do serviço e a porta (informados no momento da instalação do Webservice RM).

TimeOut
Dentro do arquivo Web.config, será necessário a inclusão da tag “<add key="ConEAITimeOut" value="1000000" />” para o controle/aumento do tempo de execução dos processos envolvendo a integração entre os produtos RM & Suricato.

Para finalizar a montagem dos ambientes RM e Suricato, montaremos um diretório virtual no IIS do sistema operacional. Para criar este diretório, iremos acessar o IIS (Internet Information Services), acesse o menu iniciar do seu computador e digite IIS.

Image Removed

Image Removed

Após abrir o IIS, clique em Sites / Default Web Site.

Image Removed

Clique com o botão direito em “Default Web Site” -> Adicionar Aplicativo.

Image Removed

Será aberto uma tela de cadastro onde deverá ser informado o Alias e o Caminho físico.
Image Removed

Dê um nome para o Alias (Dica: Utilize o mesmo nome da pasta que você informou para o Webservice RM. O campo “Caminho Físico” deverá ser preenchido com o endereço do Webservice RM. 

Clique em “Ok” e salve o cadastro do diretório virtual.
Após salvar o cadastro do diretório criado, selecione o diretório que criou (No caso o “TSA” → Nome da pasta que contém o WebService) e clique em “Procurar *:80(http) para conferir se a conexão está funcionando. (Veja exemplo abaixo).Image Removed

Ao clicar, o browser que será aberto deverá conter a seguinte informação:

Image Removed
Tendo estas informações em sua tela, significa que existe uma conexão estabelecida


Ao abrir as seções, acesse “Processos / Fórmula Visual / Gerenciar”.

Image Added


Ao abrir a tela de “Gerenciar” verá que já existe uma fórmula visual vinculada a um processo, porém, será necessário vincular também a fórmula visual de “Carga Inicial”. Para vincular a fórmula visual da carga inicial, siga conforme as imagens abaixo:

Image Added

Image Added

Image Added

Image Added

A parametrização para realizar a integração entre os produtos RM e TSA está finalizada. Antes de executar a carga inicial, devemos realizar o procedimento de verificação de base que se encontra no sistema de Automação de ponto.

Acesse RM / RH / Automação de Ponto / Configurações / Verificação de Base.

Observação: A verificação de base é importante para verificarmos se existe algum horário inconsistente na base de dados, para que a carga inicial não seja interrompida.

Carga Inicial

A Carga inicial é executado pelo RM, e se encontra na tela de seções do sistema de folha de pagamento. Tem como objetivo transmitir os dados do RM ao TSA, por exemplo (Funcionários, Seções, Centro de Custo, Horários, etc...)

Confira no exemplo abaixo como realizar a carga inicial.

Acesse o cadastro de seção, selecione as seções desejadas e gere a carga inicial.

Image Added


Verifique se as informações foram enviadas ao TSA.

Image Added

Cadastro de Funcionários (TSA): Funcionários do RM integrados corretamente.

Image Added

Cadastro de Seção (TSA): Seções integradas corretamente.

Image Added

Conforme imagens acima, a integração entre o RM e o TSA foi concluída com sucesso. Os dados do RM foram transmitidos ao TSA com exito.