Árvore de páginas

Versões comparadas

Chave

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

...

Monitor Integração TSA – Pasta Movto TSA

Objetivo da tela:

Permitir a configuração da integração entre o produto TOTVS Linha Datasul HCM com o produto TOTVS Segurança e Acesso (TSA).

Permitir o monitoramento da geração e integração de movimentos entre o produto TOTVS Linha Datasul HCM com o produto TOTVS Segurança e Acesso (TSA).

 


Outras Ações/Ações Relacionadas:

 

Ação:

Descrição:

Configuração

Quando acionado, permite acesso ao programa Configuração Integração TSA – FP8870C, no qual é possível realizar a configuração da integração.

Carga

Quando acionado, permite acesso ao programa Carga Informações TSA – FP8875

Resumo de Movimentos Pendentes

Quando acionado, é possível consultar a quantidade de movimentos que estão com situação “Aguardando Envio”, Retorno com Erro e atingiram o limite de reprocessamento.

Atualizar Consulta

Quando acionado, ocorre a atualização das informações da Grid de Movimentos. 

Filtro

Quando acionado, é possível filtrar as informações que serão demonstradas na Grid de Movimentos. São elas:

  • Pedido Execução: inserir a faixa de pedidos em execução a ser considerada na consulta na grid de movimentos.

  • Origem: assinalar quais as origens do movimento: processo de carga, atualização feita pelo processo de movimentação ou exclusão feita pelo processo de movimentação.

  • Situação do Movimento: assinalar quais as situações serão consideradas na consulta na grid de movimentos. As situações que vem inicialmente marcadas são “Aguardando Envio”, “Enviando”, “Retorno com Erro” e “Limite de Reprocessamento”.

  • Tipo Erro: assinalar os tipos de erros que serão considerados na consulta na grid de movimentos. As opções disponíveis são: Nenhum Erro, Conexão TSA, Retorno TSA, Execução Webservice, Timeout.

  • Processo: assinalar os processos a serem considerados na consulta na grid de movimentos. As opções disponíveis são: Online e Batch.

  • Tipo de Informação: assinalar os tipos de informações a serem considerados na consulta na grid de movimentos.

Atenção:
Atentar para a correta seleção do filtro para não ocorrer dificuldades de performance devido a quantidade de informações da seleção e filtro.

XML

Quando acionado, permite a consulta do XML que foi utilizado para a integração da informação como TSA.

Erros

Quando acionado, permite a consulta dos erros retornados pelo TSA ou ocasionados no momento da integração do movimento com o TSA. Esta consulta demonstra o código retornado pelo TSA, a chave externa e a descrição do erro. Alguns tipos de erro não retornam a chave externa então o campo fica em branco.

XML Retorno

Quando acionado, permite a consulta do XML que retornou do TSA. Com base neste XML é que o sistema identifica se a integração ocorreu com sucesso ou com erro. Caso seja com sucesso, são demonstrados o código de retorno () que aparece no programa de configuração da integração. Caso seja com erro, o TSA retorna um erro padrão () e a descrição da situação ocorrida (). Estas informações de erro são atualizadas no botão Erro. Quando ocorrem erros de “Execução Webservice”, não são retornados XML pelo TSA.

Reprocessar

Quando acionado, permite reprocessar um movimento com erro. Este botão chama o programa Integrador de Movimentos TSA – FP8876. O reprocessamento integra com o TSA e atualiza o retorno do TSA na fila.

Executar

Quando acionado, gera o CSV, arquivo informado no campo Arquivo CSV conforme seleção feita no campo Forma de Geração.

...


Principais Campos e Parâmetros:

 


Campo:

Descrição:

Data Envio

Data em que o movimento foi gerado ou que ocorreu a integração. O período é inicializado com o dia atual.

Hora Envio

Horário em que o movimento foi gerado ou ocorreu a integração. O período é inicializado com “00:00:00” e “23:59:59”.

 


Status Conexão:


Campo:

Descrição:

TSA

Status da integração com TSA. Caso seja diferente de Ativo, a integração não ocorrerá. É possível atualizar o Status TSA pressionando o botão “Verificar Conexão TSA e RPW”.

A seguir o quadro com possíveis situações, causas e soluções:

Conexão

Status

Consequência

Solução

TSA

Não Configurado

Movimentos com situação "Retorno com Erro" e o tipo de erro Conexão

Configurar a URL Webservice no programa de configuração.

TSA

Erro Conexão

Movimentos com situação "Retorno com Erro" e o tipo de erro Conexão

Verificar se o serviço do TSA está ativo ou se a URL foi informada corretamente.

TSA

Erro HTTPSYS

Movimentos são integrados com o TSA porém o Status do TSA fica com essa informação

Significa que a instalação do Progress está com algum problema. Necessário realizá-la novamente.

RPW

Status de configuração e agendamento do RPW. Caso seja diferente de Ativo, ocorrerá situações que não integrará todas as informações. É possível atualizar o Status RPW pressionando o botão “Verificar Conexão TSA e RPW”.

A seguir o quadro com possíveis situações, causas e soluções:

Conexão

Status

Consequência

Solução

RPW

Não Configurado

Carga: não é afetada, pois a carga é online.
Movimentação: os movimentos ficam como aguardando envio. Somente é possível integrar executando o programa manualmente.

Selecionar o Servidor RPW no programa de configuração.

RPW

Desativado

Carga: não é afetada, pois a carga é online.
Movimentação: os movimentos ficam como aguardando envio. Somente é possível integrar executando o programa manualmente.

Indica que o RPW encontra-se desativado. Necessário ativar para que a integração possa ocorrer com TSA.

RPW

Ativo - Sem Agendamento

Carga: não é afetada, pois a carga é online.
Movimentação: os movimentos ficam como aguardando envio. Somente é possível integrar executando o programa manualmente.

Criar agendamento ou parar o RPW, pois não foi encontrado.

RPW

Ativo - Empresa

Somente movimentos da empresa configurada são integrados.

Significa que uma empresa foi informada na configuração do RPW. A empresa não deve ser informada no cadastro do RPW.

Grp Mail

Grupo de e-mail parametrizado para a integração.

Arquivo CSV

Diretório mais o arquivo para a geração de um CSV dos movimentos que estão na Grid de Movimentos.

Forma Geração CSV

Forma de geração do CSV conforme a seguir:

  • Detalhe Erro: emite um CSV dos movimentos que estão na Grid combinando com os erros que estão sendo demonstrados no botão Erro do Movimento. Somente emite movimentos com erro.

  • Detalhe Chave Externa: emite um CSV dos movimentos que estão na Grid combinando com as respectivas chaves externas que são demonstrados na Grid Chave Externa.

  • Configuração TSA: emite um CSV com os registros das alterações relacionadas ao programa de configurações.


Na Grid de Movimentos, demonstra a fila de movimentos a serem integrados e os que já foram integrados:


Campo:

Descrição:

Dt Integr TSA

Data da geração ou da integração do movimento. 

Hr Integr

Hora da geração ou da integração do movimento. 

Prior

Prioridade de integração do movimento. As prioridades vão de 0 a 4. 0 são referentes aos cadastros que não dependente de nenhuma informação, já prioridade 1 são cadastros que dependente de uma informação da prioridade 0, e assim por diante. O programa Integrador de Movimentos TSA - FP8876 utiliza este campo para ordenar a integração por prioridade de informações.

Seq Integr TSA

Número de sequenciamento do movimento que é atualizado na geração do movimento. Esse é a chave do movimento.

Seq Origem

Número sequência do movimento origem que foi reprocessado e gerou esse movimento. 

Tipo Informação

Tipo de informação a que se refere aquele movimento. Os tipos informação podem ser:

  • 1 - Unidade de Lotação.

  • 2 - Cargo/Nível.

  • 3 - Localidade.

  • 4 - Pessoa Física.

  • 5 - Pessoa Jurídica.

  • 6 - Turno Escala.

  • 7 - Centro de Custo.

  • 8 - Feriados.

  • 9 - Estabelecimento.

  • 10 - Prestador de Serviço.

  • 11 - Situação de Afastamento.

  • 12 - Funcionário.

  • 13 - Histórico Lotação.

  • 14 - Histórico Cargo.

  • 15 - Histórico Localidade.

  • 16 - Histórico Turno.

  • 17 - Histórico Centro de Custo.

  • 18 - Histórico Afastamento.

  • 19 - Exceção - Autorização.

  • 20 - Exceção - Alteração Jornada.

  • 21 - Exceção - Calendário Func/Localidade.

  • 22 - Estabelecimento Sit. Afastamento.

  • 23 - Imagem Pessoa Física.

  • 24 - Exceção REP.

  • 25 - Empréstimo de Turno.

  • 26 - Feriado Turno Localidade.

Situação

Qual a situação do movimento no momento. São elas:

  • Aguardando Envio: quando o movimento foi gerado pelo processo de carga parametrizado para ser Batch ou pelo processo de movimentação. Este movimento fica aguardando na fila até o programa Integrador de Movimentos TSA - FP8876 integrá-lo com TSA.

  • Enviando: indica que o programa Integrador de Movimentos TSA - FP8876 processa este movimento. Ao final do processamento este movimento é atualizado para Retorno com Sucesso ou Retorno com Erro conforme o retorno da integração com TSA.

  • Retorno com Erro: indica que ocorreu algum erro na integração. Quando ocorre uma situação de erro, ela deverá ser avaliada para verificar qual ação tomar. Os Tipos de Erros serão detalhados no próximo item.

  • Retorno com Sucesso: indica que a integração ocorreu com sucesso. Não necessita de ação.

  • Reprocessado: indica que a origem do movimento foi Retorno com Erro e em algum movimento esse movimento foi reprocessado gerando uma nova mensagem para integração. Não necessita de nenhuma ação.

  • Cancelado: indica que o movimento foi cancelado por meio do programa Eliminação de Movimentos TSA - FP8878.

Tipo Erro

Qual o tipo de erro quando a situação do movimento é Retorno com Erro. São eles:

Tipo de Erro

Significado

Ação

Nenhum Erro

Indica que a mensagem é aguardando envio, ainda não foi integrada, portando, não ocorreu nenhum erro. Ou ainda quando a integração ocorreu e o retorno foi com sucesso.

Nenhuma ação.

Conexão TSA

Indica que o TSA está sem comunicação. Isso poderá ocorrer quando o serviço do TSA está parado ou quando a URL que foi informada no programa de configuração está errada.

Reestabelecer a comunicação com TSA.
Verificar se a URL está informada corretamente no programa de configuração.

Retorno TSA

Indica que ocorreu validação na integração com o TSA.

  1. Movimento de Funcionário com os seguintes erros: Pessoa Física não encontrada, Centro de Custo não encontrado, Cargo não Encontrado, Unidade de Lotação não encontrada, Turno não Encontrado, Localidade não encontrada, Unidade não encontrada. Indica que faltou integrar a informação de cadastro das informações que ocorreram erros.

  2. Movimentos de Exclusão com seguinte erro: Informação não encontrada para exclusão. Significa que a informação já foi excluída anteriormente.

  3. Erro Técnico. Indica que ocorreu algum erro Técnico no momento da integração com TSA.

 


  1. Verificar se existe algum movimento destes cadastros com situação “Aguardando Envio” ou “Retorno com Erro” na fila e tentar reprocessá-las. Caso não encontrar, executar um reenvio destas informações pelo programa FP8875 - Carga TSA (verificar item Reenvio de Informações).

  2. Essas mensagens podem ser canceladas, pois não serão processadas com sucesso.

  3. Necessário a abertura de chamado para verificação pelo suporte TOTVS.

Execução Webservice TSA

Indica que ocorreu erro no JBOSS do TSA ou erro de formatação do XML.

Indica que ocorreu algum erro no TSA. Necessário a abertura de chamado para verificação suporte TOTVS.

Timeout

Indica que ocorreu erro devido ao estouro do tempo aguardo do sistema pelo retorno do TSA. O valor do tempo limite é configurado no programa de configuração da integração, hoje esse tempo é 180 segundos como padrão. Quando ultrapasso esse limite então o movimento fica com essa situação.

Aumentar o tempo de Timeout do programa de configuração da integração.

Origem

Qual foi a origem de geração do movimento. Pode ser do processo de carga, ou de um processo de atualização (inclusão/alteração) no processo de movimentação ou exclusão de alguma informação também pelo processo de movimentação.

Processo

Qual o tipo de processo executado. Online ou Batch.

Qtde Chave TSA

Quantidade de chaves no movimento. No processo de carga são geradas listas de informação então a quantidade é mais de uma chave por mensagem. Já na movimentação são informações individuais então a quantidade é somente uma.

Pedido Exec

Número do pedido de execução que foi utilizado para processar essa mensagem pelo servidor RPW.

Num Reproces

Quantidade de vezes que o movimento foi reprocessado. Quando atinge o limite de reprocessamento informando no programa de configuração este movimento aparece em vermelho negrito no monitor e não é mais reprocessado pelo programa Integrador de Movimentos TSA - FP8876 de forma automática. O usuário deverá executar o programa selecionando a opção de reprocessar mensagens que atingiram o limite.

Configuração Integração TSA – Pasta Geral – FP8870C

Objetivo da tela:

Realizar a configuração geral da integração.


Principais Campos e Parâmetros: 


Campo:

Descrição:

Servidor Execução

Servidor de execução que foi parametrizado para agendamento do programa Integrador de Movimentos TSA - FP8876. Esta parametrização será necessária para monitoramento de status do servidor configurado na tela do FP8870, canto direito. 

Descrição

Apresenta a descrição do servidor de execução parametrizado. Fica sempre desabilitado.

Grupo Mail

Grupo de e-mail a qual deverá receber e-mail quando ocorre as situações da integração citadas abaixo:

  • O status do TSA está diferente de Ativo.

  • O Status do Servidor de Execução está diferente de Ativo.

  • Existe pelo menos um movimento do tipo Retorno com Erro que já atingiu limite de reprocessamento.

O grupo de e-mail deve ser cadastrado no programa Manutenção Grupos de Email - FP0903 para poder ser relacionado no campo. Caso o grupo de e-mail esteja parametrizado, os usuários do grupo receberão um e-mail por dia quando ocorrerem as situações citadas acima. 

Situação Integração TSA

Status que demonstrará qual é a etapa que o ambiente se encontra. Quando for iniciado o processo de carga, atualizar este campo para Realizando Carga. Caso o processo de carga tenha sido finalizado ou o cliente já utilizava esta integração com EAI/ESB, deve-se selecionar a opção "Realizando Movimentação" para que os movimentos sejam gerados na fila de integração. Atentar para quando o ambiente estiver na etapa "Realizando Movimentação", caso altere para outra situação, a movimentação para de ser gerada na fila podendo ocasionar erros de integridade de informação no TSA.

Processo Carga

Processo de carga será parametrizado para ocorrer Online ou Batch.

  • Caso seja selecionada a opção Online, ao executar a carga de uma informação pelo programa Carga Informações TSA - FP8875, a integração ocorre na mesma hora, já ocorrendo o retorno do TSA se foi com sucesso ou ocorreu algum erro.

  • Caso a opção selecionada seja Batch, ao executar a carga de uma informação pelo programa Carga Informações TSA - FP8875, é gerada um movimento na fila de integração com situação Aguardando Envio. Este movimento fica aguardando na fila até que o programa Integrador de Movimentos TSA - FP8876 seja executado para que ocorra a integração com TSA.

Integração com Suricato

Quando assinalado indica que a integração está ocorrendo com o Suricato.

Configuração Integração TSA – Pasta Técnica – FP8870C

Objetivo da tela:

Realizar a configuração técnica da integração.


Principais Campos e Parâmetros: 


Campo:

Descrição:

Segundos Timeout

Quantidade de segundos que o sistema aguarda o TSA retornar uma resposta para que possa finalizar a integração. O campo sempre será inicializado com 180 segundos. Este campo somente deverá ser alterado quando ocorrerem movimentos com erro do Tipo “Timeout”. Alguns processos podem levar mais tempo para que o TSA processe, pois depende do ambiente e quantidade de registros na mesma mensagem como, por exemplo, feriado e turno.

Limite Reprocessamento

Quantidade de vezes que um movimento será reprocessado quando o retorno for com erro. O valor inicial é 3. Não poderá ser inferior a esse número.

Limite Reg Integrador

Limite de registros processados por execução. Para cada execução do programa, o sistema irá ler somente o número de registros que estão parametrizados neste campo para evitar erros de “runtime” do Progress devido a quantidade de registros na fila. O limite inicial é 2000 registros.

URL Webservice

Caminho para conexão com os Webservices do TSA. Segue passo-a-passo para descobrir a URL:

  • Acesse o TSA via Navegador utilizando somente o servidor + porta.

  • Selecione a opção JBoss Web Services Console.

  • Selecione a opção “View a list of deployed services”.

  • No campo Endpoint Address copie o endereço até “/tsa-ejb”.

Lista Códigos Retorno TSA

Lista de códigos que retornam nos XML de resposta do TSA. Estes códigos indicam que a integração ocorreu com sucesso. Estas situações somente poderão ser atualizadas pela TOTVS.

Configuração Integração TSA – Pasta Empresa – FP8870C

Objetivo da tela:

Assinalar quais empresas integrarão com TSA.


Principais Campos e Parâmetros:
 


Campo:

Descrição:

Empresa

Na lista de empresas, assinalar quais delas integrarão com TSA. Para que a integração ocorra, pelo menos uma empresa deverá ser selecionada. As que não estão assinaladas não integram com TSA.


Conteúdos Relacionados:

Carga Informações TSA - FP8875

...