Beruflich Dokumente
Kultur Dokumente
pageId=244423721
Assunto
Versões: 12.X
Passo a Neste documento iremos realizar a montagem do ambiente que irá realizar a integração entre o RM e o TSA.
passo:
Base SQL
Para iniciarmos a montagem do ambiente TSA, iremos primeiro criar uma base de dados, para futuramente alimentá-la com os scripts ao TSA (como por exemplo:
Tabelas, Views, etc).
Acesse o seu banco de dados e clique em “Databases”:
Após clicar em “New Database”, será aberto uma aba de cadastro. Nesta aba de cadastro, apenas preencha o campo “Database Name” para dar nome a sua base
de dados do TSA.
1 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Ao clicar em “New User”, será aberto uma nova aba de cadastro. Esta tela de cadastro será para criar um usuário para a base de dados TSA. Segue exemplo
abaixo e suas devidas permissões:
2 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Instalando o TSA
Após criarmos a base de dados com nome TSA, iremos realizar a instalação do TSA.
Para iniciarmos a instalação do TSA, primeiramente, precisaremos de baixar o executável do TSA ( Para baixar o executável do TSA, acesse o site:
http://suporte.totvs.com.br , vá na parte de “Download e Atualizações” / Produto: Datasul / TOTVS Segurança e Acesso (TSA) e faça o download do arquivo que
possui a descrição MIDIA_TSA).
Após clicar no setup.exe, siga os passos abaixo para realizar a instalação do TSA.
3 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Nesta tela, basta apenas informar um nome de usuário e o nome de sua empresa.
Esta tela é apenas para que seja informado o caminho para onde a pasta do TSA será criada.
4 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
A partir desta tela, o andamento da instalação requer mais atenção, pois nesta tela você irá informar em qual porta o serviço do JBOSS irá ser utilizado.
Na tela acima, o usuário irá informar em qual banco o TSA irá rodar. Neste caso, iremos utilizar o SQL Server.
5 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Nesta tela, o usuário irá informar em qual servidor a base de dados do TSA está restaurada. No exemplo acima, foi utilizado “localhost”, pois a base foi criada em
uma máquina local. A porta informada, é a porta padrão do banco de dados SQL. Caso seu banco de dados seja Oracle, a porta será 1521 e MySQL 3306.
Nesta tela, você irá informar o nome da base de dados do TSA. Seguindo o exemplo deste roteiro, iremos utilizar o nome da base criada.
6 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Na tela acima, o usuário deverá informar a instancia SQL que é utilizada para ter acesso a base de dados do TSA.
Nesta tela, deverá ser informado o usuário de acesso a base de dados TSA. Conforme utilizado na criação da base de dados, o usuário será o “rm”.
7 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Na tela acima, selecione o sistema externo que irá realizar a integração com o TSA. Em nosso caso, o sistema externo será o RM.
8 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Observação: A partir desta tela, os campos a serem preenchidos serão o do sistema externo (RM).
9 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Na tela acima, informei o nome da base de dados do RM em que será parametrizada para a utilização da integração com o TSA.
Abaixo, deverá ser preenchido nos campos Usuário/Senha o usuário e a senha utilizada para acessar a base de dados do RM.
10 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Após preencher todos os campos acima, clique em avançar e finalize a instalação do TSA.
Finalizado a instalação, acesse o caminho que o TSA foi instalado e abra a pasta “TSA”.
11 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
O TSA não é um aplicativo que possua um executável, então para acessá-lo, você terá que entrar pelo atalho “TSA – Controle de Acesso TOTVS”.
Ao entrar no atalho do TSA, a seguinte mensagem será exibida em seu browser:
Esta mensagem é exibida devido ao serviço do JBOSS não estar iniciado. Para iniciar o serviço do JBOSS, acesse: Iniciar do seu sistema operacional / Serviços.
12 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
O serviço que deverá ser iniciado é o serviço “TOTVS Controle de Acesso (TSA) – 8080”, que representa o serviço do JBOSS.
Inicie o serviço e acesse novamente o atalho na pasta tsa.
Ao clicar no atalho do TSA novamente, será aberto a seguinte tela:
A tela acima, representa a parte de login da aplicação. Para acessar o TSA, o usuário deverá digitar as seguintes informações para os campos “Login / Senha”
Login: adm
Senha: 123
Ao tentar acessar o TSA, será exibida a seguinte mensagem:
"Erro no sistema!
13 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Ocorreu um erro ocasionado pela falha na conexão com o banco de dados. Por favor, entre em contato com o administrador do sistema ou tente novamente mais tarde."
Esta mensagem é referente a falta de script executado na base de dados do TSA. Para executar os scripts dentro da base de dados do TSA, acesse a pasta do TSA
(C:\totvs\tsa\scripts) e selecione o seguinte script:
- databaseInitialization-TSA-SQLSERVER-schema.sql
O script informado é para criar toda estrutura da base de dados TSA. Para executar o script, o usuário poderá dar dois cliques no script e direcioná-lo para a base de
dados TSA dentro do bando de dados SQL ou poderá abrir o script com um leitor de texto, copiar toda estrutura e colar no sql apontando para a base de dados TSA.
Após executar o script, abra o TSA novamente e acesse a aplicação.
Acesse a pasta (C:\totvs\tsa\scripts) e selecione o script “databaseInitialization-TSA_EXT-SQLSERVER-schema.sql”. O script solicitado será executado na base de
dados RM, para que seja criada a tabela ** MSA_CONTROL_MARCAC.
Webservice
O Webservice é o meio de comunicação que o RM realiza com o TSA. 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”.
14 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Observação: Este arquivo poderá ser executado apenas para as versões 12x.
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.
Observação: O que está sendo instalado agora é o Webservice do RM e não o aplicativo do TSA. O usuário poderá alterar o nome da pasta do Webservice da forma
que achar melhor.
Dica: Uma forma simples de diferenciar o Webservice RM do TSA (caso o usuário não queria alterar o nome da pasta) é que a pasta do Webservice RM possui as
iniciais “TSA” maiúsculas e o aplicativo do TSA possui as inicias “tsa” minúsculas).
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 TSA, é a base Exemplo_Integracao_RM_TSA.
Na tela abaixo, será necessário informar a mesma porta que foi informada na instalação do TSA e informe também o servidor do serviço para o TSA.
15 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
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.
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).
16 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
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
TSA funcione corretamente. Os arquivos possuem as seguintes descrições:
Arquivo Alias.dat
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
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 TSA, constando o servidor do serviço e a porta (informados no momento da instalação
do Webservice RM).
Para finalizar a montagem dos ambientes RM e TSA, 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.
17 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Clique com o botão direito em “Default Web Site” -> Adicionar Aplicativo.
18 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Será aberto uma tela de cadastro onde deverá ser informado o Alias e o Caminho físico.
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”) e clique em “Procurar *:80(http) para conferir se a conexão está
funcionando. (Veja exemplo abaixo).
19 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Tendo estas informações em sua tela, significa que existe uma conexão estabelecida.
20 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
21 of 22 06/08/2018 21:26
Integração RM x TSA - Montagem de Ambiente - Linha RM - TDN http://tdn.totvs.com/pages/releaseview.action?pageId=244423721
Observações:
base_de_conhecimento
22 of 22 06/08/2018 21:26