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 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/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

Home

Linha Microsiga Protheus

Páginas filhas