| Pagetitle |
|---|
| Integração Protheus SIGAPON x TSA |
|---|
| Integração Protheus SIGAPON x TSA |
|---|
|
Boletim Técnico: Integração Protheus SIGAPON x TSA Resumo Esta atualização consiste na preparação do ambiente para utilização da integração do SIGAPON com o módulo TSA (TOTVS controle de Acesso) proporcionando além do controle de acesso, a gestão de marcações. Sistema Operacional todos Nome + Fonte RHUPDPON – Compatibilizador do Ponto. Número da FNC 000000141892011 Ajustes no Compatibilizador Sim Integridade Referencial Não Compatibilizador 1 - RHUPMOD 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 \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_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 há 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 há 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 ByYou 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 01/08/2011. 2. Clique em OK para continuar. 3. Após a confirmação é apresentada a janela para seleção do compatibilizador. Selecione o programa SIGAPON. 4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo. 5. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. 6. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados. 7. Clique em Gravar para salvar o histórico (log) apresentado. 8. Clique em OK para encerrar o processamento. O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) desta FNC. Descrição de Ajustes 1. Criação no arquivo SX3 – Campos: · Tabela CTT – Centro de Custo: Campo | CTT_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela RCE – Sindicatos: Campo | RCE_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SP2 – Exceções: Campo | P2_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SP3 – Feriados: Campo | P3_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SPA – Regras de Apontamento: Campo | PA_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SPE – Crachás Provisórios: Campo | PE_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SPF – Transferência de Turno: Campo | PF_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SPJ – Horário Padrão: Campo | PJ_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SR6 – Turnos de Trabalho: Campo | R6_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SR8 – Controle de Ausências: Campo | R8_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportacao RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SRA – Funcionários: Campo | RA_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SRG – Rescisões: Campo | RG_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SRJ – Férias: Campo | RJ_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
· Tabela SRH – Sindicatos: Campo | RH_RHEXP | Tipo | Caracter | Tamanho | 6 | Decimal | 0 | Título | Contr.Exp.RH | Descrição | Controle de Exportação RH | Nível | 1 | Usado | Não | Obrigatório | Não | Browse | Não | Help | Neste campo é armazenado a data da exportação para o aplicativo Totvs Controle de Acesso. |
1. 2. Alteração de Campo no arquivo SX3 – Campos: · Tabela SP0 – Relógio: Campo | P0_TIPOARQ | Val. Sistema | Pertence(“DxTxR”) |
Os tamanhos dos campos que possuem grupo podem variar conforme ambiente em uso. 3. Criação no arquivo SX6 – Parâmetros: Nome da Variável | MV_TSAMAIL | Tipo | Caracter | Descrição | Endereço de Email para recebimento de mensagens do Log de integração. |
Nome da Variável | MV_TSAREP | Tipo | Lógico | Descrição | Habilita a integração do SIGAPON com o TSREP. | Valor Padrão | .F. |
Nome da Variável | MV_TSASERV | Tipo | Caracter | Descrição | Endereço do servidor dos Webservices para integração com TSAREP. |
4. Serviços disponibilizados para configuração de rotinas no Schedule: Descrição | Serviço para atualização agendada da integração Protheus x TSA. | Nome do Serviço | WFRHTrep | Parâmetros disponíveis | "EMPRESA/UNIDADE/LOTACAO" | "SINDICATO" | “TURNO/ESCALA" | "FUNCIONARIO" | "AUSENCIAS" | “EXCECOES” | “CARGOS/FUNCOES” | “CCUSTO” | “AFASTAMENTOS” | Exemplo para execução | WFRHTRep("EMPRESA/UNIDADE/LOTACAO") |
5. Mensagens de retorno para divergências no processo de integração Protheus x 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 seqüência de inicio é obrigatória. | 00607 | A seqüencia 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 seqüencia de início não pode ser superior a seqüencia 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 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 Pais, Estado ou Cidade deve ser informada. | 00806 | Descrição de Pais 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) |
Procedimentos para Configuração PARA MENUS 1. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do SIGAPON, conforme instruções a seguir: Menu | Miscelânea | Submenu | S.r.e.p. | Nome da Rotina | Carga de Dados | Programa | PONM430 | Módulo | Ponto | Tipo | Função Protheus | Tabelas | SRA |
Informações Técnicas Tabelas Utilizadas | CTT – Centro de Custo,
RCE - Sindicatos,
SP2 - Exceções,
SP3 - Feriados,
SPA – Regras de Apontamento,
SPE – Crachás Provisórios.
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. |
|
