Home

Linha Microsiga Protheus

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

Boletim Técnico: Melhorias na 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
TDVXZZ
Produtos
  • Microsiga 10
  • Módulos
    • SIGAGPE
    Portais
    • Portal do cliente
    Países
    • Brasil
    Sistema Operacional
  • todos
  • Bancos de Dados
    • todos
    Ajustes no Compatibilizador
    Não
    Integridade Referencial
    Não
    Aplicação de Patch
    Não
    Procedimentos para Implementação
    Foram criados 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 serão gravados.

    ·  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 que todas 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 P10_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.

     

    ·  Seguem 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 Período

    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/LOTAÇÃO

    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ória.

    00604

    A escala deve conter pelo menos um par de horários 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 à 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ória.

    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 Trabalhado 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 IMPLEMENTAÇÃO

    Antes de executar o compatibilizador RHUPDMOD é imprescindível:

    a)       Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS10_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS10_DATA\ SYSTEM).

    b)       Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.

    c)        Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.

    d)       Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.

    e)       O compatibilizador deve ser executado com a Integridade Referencial desativada*.

     

     

    O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

     

    A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:

     

                         i.                        No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).

                       ii.                        Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções.

                      iii.                        Se Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou;

                      iv.                        Se Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação).

                        v.                        Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).

                      vi.                        Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.

                     vii.                        Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.

     

    Contate o Help Desk Framework EM CASO DE DÚVIDAS!

     

    1.        Em Microsiga Protheus Totvs Smart Client, digite RHUPDMOD no campo Programa Inicial.

    2.        Clique no botão OK para continuar.

    É apresentada a tela de seleção de módulos.

    3.        Selecione SIGAPON – Ponto Eletrônico.

    4.        Clique em Ok para prosseguir.

    5.        Após a confirmação é apresentada uma tela para seleção do compatibilizador.

    6.        Selecione a opção 20 – Melhorias Integração Ponto Eletrônico X Aplicativo TSA.

    7.        Ao confirmar, é apresentada uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.

    8.        Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.

    9.        É apresentada uma mensagem explicativa na tela.

    10.     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.

    11.     Clique no botão Gravar para salvar o histórico (log) apresentado.

    12.     Clique no botão OK para encerrar o processamento.

    Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 17/10/2011 e se foi  aplicada anteriormente  a atualização da opção 16 – Atualização Unificada Portaria 1.510.


     

    Descrição de Ajustes
     1.     Criação no arquivo SX6 – Parâmetros:

    Nome da Variável

    MV_TSADARQ

    Tipo

    Caracter

    Descrição

    Define o diretório onde serão gravados os arquivos de Log de erros gerados a partir da integração Sigapon 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 Ponto Eletrônico X Aplicativo TSA (0=Não gera, 1=Apenas e-mail, 2=Apenas arquivo e 3-Ambos).

    Valor Padrão

    3

    Procedimentos para Configuração
     
    Procedimentos para Utilização
     
    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 e SRJ – Funções.

    Rotinas 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 Período

    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

    Observações
     

    • Sem rótulos