Home

Linha Microsiga Protheus

Páginas filhas
  • Melhorias Integração Ponto Eletrônico X Aplicativo TSA -- 116950

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/327912/newLayout.css
Portuguese

Pagetitle
Melhorias Integração Ponto Eletrônico X Aplicativo TSA
Melhorias Integração Ponto Eletrônico X Aplicativo TSA

Boletim Técnico: Melhorias Integração Ponto Eletrônico X Aplicativo TSA
Ocorrência
Nova Rotina
Resumo
Implementada melhoria na funcionalidade de retorno dos Web Services, com a disponibilização da geração do conteúdo em arquivo.
ID do Chamado
TDW484
Aplicabilidade
Melhorias Integração Ponto Eletrônico X Aplicativo TSA
Produtos
  • Microsiga 11
  • Módulos
    • SIGAPON
    Traduções
    • Português (Brasil)
    Sistema Operacional
  • todos
  • Bancos de Dados
    • todos
    Nome + Fonte
    PONM430
    Parâmetros Envolvidos
    MV_TSADARQ, MV_TSATLOG
    Ajustes no Compatibilizador
    Sim
    Integridade Referencial
    Sim
    Aplicação de Patch
    Compatibilizador 1
    - RHUPDMOD
    Procedimentos para Implementação
    1.        Em Smart Client, digite RHUPDMOD no campo Programa Inicial.
    Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 18/10/2011, e que a atualização da opção 18 – Atualização Unificada Portaria 1.510 tenha sido aplicada anteriormente.
    2.        Clique no botão OK para continuar.
    3.        Será apresentada uma tela de seleção de módulos.
    4.        Selecione SIGAPON – Ponto Eletrônico.
    5.        Clique em Ok para prosseguir.
    6.        Após a confirmação é apresentada uma tela para seleção do compatibilizador.
    7.        Selecione a opção 19 – Melhorias Integração Ponto Eletrônico X Aplicativo TSA.
    8.        Ao confirmar, é apresentada uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    9.        Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
    10.     É apresentada uma mensagem explicativa na tela.
    11.     Em seguida, é apresentada a janela de Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização, são exibidos somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existam no dicionário de dados.
    12.     Clique no botão Gravar para salvar o histórico (log) apresentado.
    13.     Clique no botão OK para encerrar o processamento.
    Descrição de Ajustes
    Implementada melhoria na funcionalidade de retorno dos Web Services, com a disponibilização da geração do conteúdo em arquivo. Sendo assim, criou-se os seguintes Parâmetros:
    · MV_TSADARQ: Define o local onde os arquivos de log de retorno da integração com o WebServices do aplicativo TSA é gravado
    · MV_TSATLOG: Define qual o tipo de envio do Log de inconsistências da integração do Ponto Eletrônico X TSA. Com as seguintes opções:
    ·         0 = Não gera o conteúdo;
    ·         1 = Envia o conteúdo por e-mail apenas (como já existia);
    ·         2 = Envia o conteúdo em arquivo apenas;
    ·         3 = Ambos, envia por email e gera no diretório especificado.
    O Parâmetro MV_TSATLOG permite quetodas as rotinas de integração com o aplicativo TSA (Totvs Controle de Acesso) gerem um log de retorno com as críticas realizadas pelas regras do aplicativo.
     
    Exemplo:
     
    Em Centro de Custos (CTBA030) toda manipulação é enviada para o aplicativo TSA, tendo como retorno a string abaixo:
     
    Rotina Protheus: CTBA030 – Centro de Custo
    Nome do Serviço: CostCenter
    Nome do Arquivo: sc023830_costcenter.txt
    Conteudo:
     
    CDESCRIPTION: CENTRO DE CUSTO - TESTE TSA            
    CEXTERNALKEY: 9901000015  
    CSTATUSCODE: (vide Tabela de Ocorrências )
    CSTATUSDESCRIPTION: (vide Tabela de Ocorrências)
     
    WSCERR044 / Não foi possível POST : URL http://localhost:8080/tsa-ejb-11.6.0/CostCenterIntegrationServiceBean ( 10061 : Connection refused. )
    ADVPL WSDL Client 1.110425 / TOTVS Manufatura MSSQL7 P11_bra on 20111017 15:12:13
    Recomenda-se que a aplicação das rotinas envolvidas nessa implementação seja realizada apenas no início do próximo período de apontamento e não no período em andamento.
     
    · Segue abaixo os nomes das rotinas e seus serviços relacionados:
                                                    Rotina
    Nome do Serviço
    Schedule Empresa
    LegalPerson
    Schedule Unidade
    Unit
    Schedule Unidade de Lotação
    AllocationUnit
    Schedule Localidade
    Location
    Schedule Tabelas 30/31 – Módulo Configurador
    AbsenceReason, UnitAbsenceReason
    CSAM080 – Cadastro de Aumento programado
    User
    CTBA030 – Cadastro de Centro de Custos
    CostCenter
    GPEA010 – Cadastro de Funcionários
    User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason, RemoveUserAbsenceReason
    GPEA030 – Cadastro de Funções
    PositionLevel
    GPEA080 – Cadastro de Turno de Trabalho
    ShiftWork
    GPEA180 – Cadastro de Transferência de Funcionários
    Scale
    GPEA240 – Cadastro de Afastamentos
    UserAbsenceReason
    GPEA265 – Cadastro de Autônomos
    User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason, RemoveUserAbsenceReason
    GPEA340 – Cadastro de Sindicatos
    SindicatoLegal
    GPEM030 – Cadastro de Férias
    User, UserAbsenceReason
    GPEM040 – Cadastro de Rescisão
    User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason
    GPEM060 – Férias Coletivas/Programadas
    User, UserAbsenceReason
    PONA020 – Cadastro de Feriado
    DayNotWorked
    PONA080 – Manutenção da Tabela de Horário Padrão
    ShiftWork,Scale
    PONA090 – Cadastro de Exceções por Periodo
    Exception
    PONA140 – Cadastro de Exceções por Funcionário
    Exception
    PONA160 – Troca de Turno
    User, UserShiftWork
    PONM430 – Integração TSA
    Todos
    TRMA100 – Cadastro de Funcionários
    User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason, RemoveUserAbsenceReason
    TRMA210 – Cadastro de Funções
    Position
     
    Tabela de Serviços Disponibilizados – Web Services:
    ·       Serviços disponibilizados para configuração de rotinas no Schedule:
    Descrição
    Serviço para atualização agendada da integração Protheus  x TSA, cadastrado no módulo configurador, item menu Ambiente/Schedule (opção processos especiais).
    Nome do Serviço
    WFRHTrep
    Parâmetros disponíveis
    EMPRESA/UNIDADE/LOTACAO
    SINDICATO
    TURNO/ESCALA
    FUNCIONÁRIO
    AUSÊNCIAS
    EXCEÇÕES
    CARGOS/FUNÇÕES
    CCUSTO
    AFASTAMENTOS
    Parâmetro Empresa
    Informar o código da empresa
    Parâmetro Filial
    Informar o código da filial
    Exemplo para execução
    WFRHTRep("EMPRESA/UNIDADE/LOTACAO",”99”,”01”)
     
    Tabela de Ocorrências na Integração com Aplicativo TSA:
    Código do Retorno
    Descrição do código de retorno
    Informações
    00101
    Inclusão/Alteração da Empresa Jurídica realizada com sucesso.
    00102
    Chave externa da Empresa Jurídica é obrigatória.
    00103
    Deve ser informado pelo menos o CNPJ ou CEI.
    00104
    Exclusão da unidade realizada com sucesso.
    00105
    Deve ser informado apenas um dos campos: CNPJ ou CEI.
    00106
    Nome da pessoa jurídica é obrigatória.
    00107
    Pessoa jurídica está sendo usada, não é possível realizar a exclusão.
    00100
    Erro Técnico (retornar erros ocorridos durante a execução).
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00201
    Inclusão/Alteração da unidade realizada com sucesso.
    00202
    Chave externa da Unidade é obrigatória.
    00203
    Chave externa de Pessoa Jurídica é obrigatória.
    00204
    Código da unidade é obrigatório.
    00205
    Tipo da unidade é obrigatório.
    00206
    Exclusão da unidade realizada com sucesso.
    00207
    Inclusão de relacionamento realizada com sucesso.
    00208
    Exclusão de relacionamento realizada com sucesso.
    00209
    Inclusão de relacionamento realizada parcialmente.
    00210
    Unidade está sendo usada, não é possível realizar a exclusão.
    00211
    Inclusão de relacionamento não realizada, nenhuma chave externa é existente.
    00212
    Exclusão de relacionamento não realizada, nenhuma chave externa é existente.
    00213
    Usuário ou senha são inválidos.
    00214
    Unidade está sendo usada, não é possível realizar a exclusão.
    00215
    Descrição da Unidade é Obrigatória
    00216
    Nenhum registro encontrado com a chave externa
    00200
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00301
    Inclusão/Alteração do Centro de Custo realizada com sucesso.
    00302
    Chave externa do Centro de Custo é obrigatória.
    00303
    Exclusão da unidade realizada com sucesso.
    00304
    Usuário ou senha são inválidos.
    00305
    Descrição do Centro de Custo é obrigatória.
    00306
    Centro de Custo está sendo usado, não é possível realizar a exclusão.
    00300
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00401
    Inclusão/Alteração da Unidade de Lotação realizada com sucesso.
    00402
    Chave externa da Unidade de Lotação é obrigatória.
    00403
    Exclusão da Unidade de Lotação realizada com sucesso.
    00404
    Usuário ou senha são inválidos.
    00405
    Descrição da Unidade de Lotação é obrigatória.
    00406
    Unidade de Lotação está sendo usada, não é possível realizar a exclusão.
    00400
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00501
    Inclusão/Alteração do Turno realizada com sucesso.
    00502
    Chave externa do Turno é obrigatória.
    00503
    Data de início é obrigatória.
    00504
    Data de início deve ser uma data válida.
    00505
    Exclusão do Turno realizada com sucesso.
    00506
    Pelo menos uma escala deve estar informada e deve conter pelo menos um intervalo de horário do tipo Jornada.
    00507
    Descrição é obrigatória.
    00509
    Turno está sendo usado, não é possível realizar a exclusão.
    00500
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00601
    Inclusão/Alteração da Grade de Trabalho realizada com sucesso.
    00602
    Chave externa da Grade de trabalho é obrigatória.
    00603
    A chave externa do turno é obrigatório.
    00604
    A escala deve conter pelo menos um par de horário do tipo Jornada.
    00605
    Os pares de horários informados estão incorretos.
    00606
    A sequência de inicio é obrigatória.
    00607
    A sequência de término é obrigatória.
    00608
    O tipo é obrigatório.
    00609
    A entrada de jornada é obrigatória.
    00610
    A saída de jornada é obrigatória.
    00611
    A sequência de início não pode ser superior a sequência de término.
    00612
    Exclusão do Turno realizada com sucesso.
    00613
    Usuário ou senha são inválidos.
    00614
    Escala está sendo usada, não é possível realizar a exclusão.
    00600
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00701
    Inclusão/Alteração da Pessoa física realizada com sucesso.
    00702
    Chave externa da Pessoa Física é obrigatória.
    00703
    Pelo menos o CPF ou RG deve ser informado.
    00704
    Exclusão da pessoa física realizada com sucesso.
    00705
    Usuário ou senha são inválidos.
    00706
    Pessoa física está sendo usada, não é possível realizar a exclusão.
    00700
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00801
    Inclusão/Alteração da Localidade realizada com sucesso.
    00802
    Chave externa da Localidade é obrigatória.
    00803
    Exclusão da localidade realizada com sucesso.
    00804
    Usuário ou senha são inválidos.
    00805
    Pelo menos País, Estado ou Cidade deve ser informada.
    00806
    Descrição de País deve ser informada.
    00807
    Descrição de Estado deve ser informada.
    00808
    Descrição de Cidade deve ser informada.
    00809
    Localidade está sendo usada, não é possível realizar a exclusão.
    00800
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    00901
    Inclusão/Alteração do cargoNivel realizada com sucesso.
    00902
    Chave externa do cargoNivel é obrigatória.
    00903
    Descrição é obrigatória.
    00904
    Exclusão do cargoNivel realizada com sucesso.
    00905
    Usuário ou senha são inválidos.
    00906
    CargoNivel está sendo usado, não é possível realizar a exclusão.
    00900
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    01001
    Inclusão/Alteração da situação de afastamento realizada com sucesso.
    01002
    Chave externa da situação de afastamento é obrigatória.
    01003
    Tipo da situação de afastamento é obrigatório.
    01004
    Exclusão da situação de afastamento realizada com sucesso.
    01005
    Data início e Data término são obrigatórias.
    01006
    Exclusão do relacionamento realizado com sucesso.
    01007
    Usuário ou senha estão inválidos.
    01008
    Descrição da situação de afastamento é obrigatória.
    01009
    Situação de Afastamento está sendo usada, não é possível realizar a exclusão.
    01010
    Inclusão do relacionamento realizado com sucesso.
    01000
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    01101
    Inclusão/Alteração da exceção realizada com sucesso.
    01102
    Chave externa da exceção é obrigatória.
    01103
    Tipo da exceção é obrigatório.
    01104
    Origem é obrigatório.
    01105
    Data início é obrigatória.
    01106
    Data Término é obrigatória.
    01112
    Exclusão da exceção realizada com sucesso.
    01113
    Pelo menos um período deve ser informado.
    01114
    Usuário ou senha inválidos.
    01115
    Os pares de horários informados estão incorretos.
    01106
    Direção é obrigatório.
    01100
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    01201
    Inclusão/Alteração do dia não trabalhado realizado com sucesso.
    01202
    Chave externa do dia não trabalhado é obrigatória.
    01203
    Recorrente é obrigatório.
    01204
    Data é obrigatória
    01205
    Exclusão do dia não trabalhado realizada com sucesso.
    01206
    O turno deve ser informado.
    01207
    A localidade deve ser informada
    01208
    Usuário ou senha Inválidos.
    01209
    Dia não Trabalho está sendo usado, não é possível realizar a exclusão.
    01200
    Erro Técnico (retornar erros ocorridos durante a execução)
    01210
    Inclusão do relacionamento Dia Não Trabalhado/Localidade/Turno realizado com sucesso.
    01211
    Exclusão do relacionamento Dia Não Trabalhado/Localidade/Turno realizado com sucesso.
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    01301
    Inclusão/Alteração do usuário realizado com sucesso.
    01302
    Chave externa do usuário não foi informada.
    01303
    Chave externa de pessoa física não foi informada.
    01304
    O tipo papel não foi informado.
    01305
    Data início de validade do turno deve ser informada.
    01306
    Data término de validade do turno deve ser informada.
    01307
    Data início de validade do Centro de custo deve ser informada.
    01308
    Data término de validade do Centro de Custo deve ser informada.
    01309
    Data início de validade do CargoNivel deve ser informada.
    01310
    Data término de validade do CargoNivel deve ser informada.
    01311
    Data início de validade da Unidade de Lotação deve ser informada.
    01312
    Data término de validade da Unidade de Lotação deve ser informada.
    01313
    Data início de validade da Localidade deve ser informada.
    01314
    Data término de validade da Localidade deve ser informada.
    01315
    Chave externa de pessoa Física não existe.
    01316
    Chave externa de turno não existe.
    01317
    Chave externa de centro de custo não existe.
    01318
    Chave externa de cargonivel não existe.
    01319
    Chave externa de unidade de lotação não existe.
    01320
    Chave externa de localidade não existe.
    01321
    Chave externa de usuário não existe.
    01322
    Relacionamento incluído/alterado com sucesso.
    01323
    Usuário ou senha Inválidos.
    01324
    Usuário está sendo usado, não é possível realizar a exclusão.
    01325
    Exclusão do usuário realizada com sucesso.
    01326
    Exclusão do relacionamento de usuário com “nome do relacionamento”, realizada com sucesso.
    01327
    Exclusão do relacionamento de usuário com “nome do relacionamento”, não realizada.
    01301
    Inclusão/Alteração do usuário realizado com sucesso.
    01302
    Chave externa do usuário não foi informada.
    01303
    Chave externa de pessoa física não foi informada.
    01300
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    Código do Retorno
    Descrição do código de retorno
    Informações
    01401
    Importação da batida realizada no REP: “número do rep” e NSR: “número do nsr” foi importada com sucesso.
    01402
    Importação da batida realizada no REP: “número do rep” e NSR: “número do nsr” não foi importada.
    01400
    Erro Técnico (retornar erros ocorridos durante a execução)
     
    As implementações descritas nesse documento somente se aplicam aos dados gerados após a atualização do RPO. Os dados gerados anteriormente, não são contemplados pelas modificações realizadas. Além disso, as alterações são extensas e devem refletir na regra de negócios da empresa, portanto, os impactos dessa atualização devem ser analisados cuidadosamente. Assim, antes de realizar a atualização e proceder com a adequação das tabelas é imprescindível que realize a cópia das Tabelas utilizadas pelo SIGAPON.
    Procedimentos para Configuração
    1.     Criação no arquivo SX6 – Parâmetros:
     
    2.     Nome da Variável
    MV_TSADARQ
    Tipo
    Caracter
    Descrição
    Define o nome do diretório onde serão gravados os arquivos de Log de erros gerados da integração do módulo Ponto Eletrônico X Aplicativo TSA.
    Valor Padrão
    \logwsrhtsa\
     
     
     
     
    Nome da Variável
    MV_TSATLOG
    Tipo
    Numérico
    Descrição
    Define qual será o tipo de envio do Log de erros da integração do módulo Ponto Eletrônico X Aplic. TSA ( 0=Não gera, 1=E-mail, 2=Arquivo e 3-Ambos).
    Valor Padrão
    3
    Informações Técnicas
    Tabelas utilizadas:

    CTT – Centro de Custo

    RCE – Sindicatos

    SPA – Regra de Apontamento

    SPJ – Tabela de Horário Padrão

    SP2 – Exceções

    SP3 – Feriados

    SPF – Transferência de Turno

    SPJ – Horário Padrão

    SR6 – Turnos de Trabalho

    SR8 – Controle de Ausências

    SRA – Funcionários

    SRG – Rescisões

    SRH – Férias

    SRJ – Funções

    Funções envolvidas:

    CSAM080 – Cadastro de Aumento programado

    CTBA030 – Cadastro de Centro de Custos

    GPEA010 – Cadastro de Funcionários

    GPEA030 – Cadastro de Funções

    GPEA080 – Cadastro de Turno de Trabalho

    GPEA180 – Cadastro de Transferência de Funcionários

    GPEA240 – Cadastro de Afastamentos

    GPEA265 – Cadastro de Autônomos

    GPEA340 – Cadastro de Sindicatos

    GPEM030 – Cadastro de Férias

    GPEM040 – Cadastro de Rescisão

    GPEM060 – Férias Coletivas/Programadas

    GPEXFUN1 – Biblioteca de Funções do SIGAGPE

    PONA020 – Cadastro de Feriado

    PONA080 – Manutenção da Tabela de Horário Padrão

    PONA090 – Cadastro de Exceções por Periodo

    PONA140 – Cadastro de Exceções por Funcionário

    PONA160 – Troca de Turno

    PONM430 – Integração TSA

    PONXFUN – Biblioteca de Funções do SIGAPON

    PONXFUN1 – Biblioteca de Funções do SIGAPON

    PTSREPOBJ – Biblioteca de Funções do SIGAPON

    RHUPDPON – Atualizador do Ponto Eletrônico

    TRMA100 – Cadastro de Funcionários

    TRMA210 – Cadastro de Funções