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.

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.

Data Envio

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

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:

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.

Dt Integr TSA

Data 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:

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.

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. 

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.

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.

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.