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 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 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 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 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/2011e se foi aplicada anteriormente a atualização da opção 16 – Atualização Unificada Portaria 1.510.
