...

Permite incluir e excluir marcações no ponto eletrônico para os técnicos relacionados à um funcionário, através dos atendentes, baseando-se nos atendimentos de Ordens de Serviços.

Os atendimentos gerados com seus respectivos horários de início e fim, são extraídos e processados para que sejam realizadas as marcações no são enviados para o módulo de Ponto Eletrônico.

...

Informações

title	Nota

É importante considerar que as informações deste relatório dependem de precondições pré-condições cadastradas nas seguintes rotinas:

Funcionários
Atendentes.
Ordem de Serviço.
Atendimento da Ordem de Serviço.
Períodos de Apontamento no módulo SIGAPON.

...

Deck of Cards

effectDuration	0.5
history	false
id	samples
effectType	fade

Card

default	true
id	1
label	Wizard de Configuração	Procedimento

O passo-a-passo abaixo descreve a utilização da rotina:

Gerar um orçamento de serviços.

Antes de acessar a rotina deve-se:

Gerar uma proposta comercial (orçamento), por meio da rotina "Oportunidade de Venda",

Acessar o "Assistente de Contrato"

e finalizar o oportunidade gerada,

e gerar o contrato do orçamento
Fazer alocação de atende

(s)

no "Gestão de Escala

",

" ou "Gestão de Contratos".
Utilizar a rotina "Geração de Atendimentos de Ordens de Serviços" para gerar as ordens de serviços

, de acordo com o tempo colocado,

para a agenda de trabalho dos atendentes.

Image Removed Image Added

Figura 1 - Geração de O.S.

Fazer a geração de marcações, de acordo com os parâmetros abaixo, os dias que serão preenchidos com as marcações esta relacionado a data passada no parâmetro da rotina, e o mesmo deve estar dentro do tempo MV_PAPONTA,

5. Acessar a rotina de geração das marcações:

Image Added

Figura 3 - Parâmetros da rotina. Figura 2 - Geração de marcações.

Informações

title	Nota

A partir da versão de 22/04/2020 10:27:23, essa rotina permitirá realizar o envio das marcações para várias filiais, ao mesmo tempo, ou alterar a filial de processamento, utilizando o campo Filial?.

Obs.: Caso a rotina esteja atualizada, o pergunte deverá ser criado, conforme orientações no documento técnico: DSERSGS-8326 DT Envio das marcações em modo multifilial. Se a opção não for criada, o comportamento da rotina permanece inalterado.

Image Added

Figura 4 - Parâmetro para escolha de filial.

Aviso

title	Mobile

Para a integração com mobile será possível a utilização do parâmetro MV_GSHRPON. Ele tem como valor padrão 2 (desativado).

O parâmetro pega as informações do campo ABB_HRCHIN e ABB_HRCHOUT, que são preenchidos com a integração.

Campo

Descrição

Tipo

MV_GSHRPON

Valor 1 : "SIM"

Pega o campo de integração para preenchimento de horas.

Valor Padrão 2 : "NÃO"

Segue o padrão pega os campos de entrada e saída da ABB( ABB_HRINI e ABB_HRFIM).

Carácter

Card

id	2
label	MV_GSOUT

Esta rotina possui 3 opções de saída, conforme o conteúdo do parâmetro MV_GSOUT

Caso uma das opções de saída seja o Protheus, visualizar na rotina do SIGAPON "Marcações", selecione um atendente escolhido no 3° processo e observe as marcações geradas.

Image Added Image Removed

Figura 2 - Geração de marcações.

Visualizar no SIGAPON na rotina "Marcações", seleciona o atendente escolhido no 3° processo, e observe os pontos gerados.

Image Removed

Figura 3 - Visualização do atendente no SIGAPON.

Informações

title	Nota

Os pontos gerados no SIGAPON depende da data passada na rotina MV_PAPONTA.

...

Figura 4 - Visualização do atendente no SIGAPON.

Caso uma das opções de saída seja o Ponto de Entrada, a saída será definida no ponto de Entrada At910CMa
Caso um das opções de saída seja o Arquivo CSV, a saída será o arquivo At910[nOpcAuto][AAAAMMDDHHMMSS].csv, gravado no local definido no parâmetro MV_GSRHDIR onde:

nOpcAuto - Operação onde: 3 - Inclusão; 5 - Exclusão

AAAAMMDD - Data/Hora da geração do Arquivo

Card

id	3
label	API REST

É possível utilizar a rotina "Geração das Marcações" via API REST.

É necessário possuir o fonte TECM910.prw compilado no repositório. O caminho da API é o api/tec/v1/SMTimeTrack/ e a requisição é através de uma operação de POST.

A tabela abaixo indica quais propriedades do JSON no POST correspondem com quais parâmetros da rotina:

Propriedade	Parâmetro	Tipo	Obrigatório
employeeFrom	MV_PAR01	texto	Sim, se não possuir a propriedade employees.
employeeTo	MV_PAR02	texto	Sim, se não possuir a propriedade employees.
startDate	MV_PAR03	texto, no formato YYYY-MM-DD	Sim
endDate	MV_PAR04	texto, no formato YYYY-MM-DD	Sim
operation	MV_PAR05	numérico (1 ou 2) 1 = Inclusão 2 = Exclusão	Sim
keepShiftBreak	MV_PAR06	numérico (1 ou 2) 1 = Sim 2 = Não	Sim
employees		array	Sim, se não possuir as propriedades employeeFrom e employeeTo

A propriedade "employees" pode ser utilizada para listar quais atendentes (AB9_CODTEC) devem ser considerados.

Exemplo 1 de requisição:

{
"employees": ["TEC01900000135","TEC01900000136","TEC01900000137"],
"startDate": "2019-05-07",
"endDate": "2019-05-08",
"operation": 1,
"keepShiftBreak": 1
}

Exemplo 2 de requisição:

{
"employeeFrom": "TEC01900000135",
"employeeTo": "TEC01900000137",
"startDate": "2019-05-07",
"endDate": "2019-05-08",
"operation": 1,
"keepShiftBreak": 1
}

A API pode retornar status 200 - OK caso alguma marcação seja inclusa ou 400 caso nenhuma marcação seja processada. No retorno também existe uma propriedade "message" que exibe o mesmo retorno que seria exibido caso a rotina fosse executada via interface.

{
"message": "Foram processadas: 4 marcações de entrada e saída."
}

Saiba mais em:

Web Services REST/Server

Configuração REST do Protheus

FWRestModel - API RESTful dos modelos de dados do Protheus

Card

id	4
label	Envio das Marcações sem OS

A partir do dia 15/07/2019 será possível a utilização do parâmetro MV_GSGEROS. Ele tem como valor padrão "1" (ativo).

Com a ativação do parametro MV_GSGEROS não será gerada Ordem de Serviço na Geração do Atendimento, e com isso a projeção da agenda(ABB) do atendente será a base para o envio das marcações para o ponto. Para tal, deverá ser criado o campo ABB_MPONTO, que será usado como base para o envio das marcações para o ponto. Apenas as agendas marcadas como atendidas através do processo de Confirmação de Atendimento serão enviadas para o ponto

Maior informação sobre o outra parte do processo do parâmetro: Ordem de Serviço.

Para criação do campo, ABB_MPONTO, deve respeitar:

Image Added

Figura 1 - Campo.

Image Added

Figura 2 - Informações.

Image Added

Figura 4 - Validações.

Image Added

Figura 5 - Uso.

Image Added

Figura 6 - Módulo.

Image Added

Figura 7 - Regras de dependência.

Caso opte pelo preenchimento pelo X3:

Campo	Conteúdo
X3_ARQUIVO	ABB
X3_CAMPO	ABB_MPONTO
X3_TIPO	L
X3_TAMANHO	1
X3_DECIMAL	0
X3_TITULO	Marc. Ponto
X3_DESCRIC	Marcacao Ponto Eletronico
X3_USADO	€€€€€€€€€€€€€€
X3_RELACAO	.F.
X3_NIVEL	1
X3_RESERV	þÀ
X3_PROPRI	U
X3_BROWSE	N
X3_VISUAL	V
X3_CONTEXT	R
X3_ORTOGRA	N
X3_IDXFLD	N
X3_POSLGT	1
X3_MODAL	2

Card

id	5
label	Hora Extra

A partir do dia 15/07/2019 é possível aplicar hora extra no intervalo e ao enviar par ao ponto o mesmo é "eliminado" ficando assim o período completo sem o intervalo.

Aviso

title	Importante

O processo só funcionará de fato, se a saída for exatamente a mesma hora da próxima entrada.

Image Added

Figura 1 - Mesa Operacional aplicação da Hora Extra.

Realize o procedimento normal:

Faça a Geração de Atendimento de Ordens de Serviços (TECA 900)
Envie para o ponto o período desejado.

Visualize no ponto as marcações.

Image Added

Figura 2 - Visualização no ponto.

Card

id	6
label	Troca de Turno

Acessando a Mesa Operacional (TECA190D) é possivel realizar a alocação do atendente de forma composta defindo mais de um POSTO ao atendente:

Image Added

Ao realizar a geração das marcações (TECA910), é efetuada verificação dos POSTOS vinculados ao atendente.

Image Added

Aviso

title	Importante

A Geração das Marcações tem por definição já encaminhar os dados para integração com o TAF (MV_RHTAF = .T.) referente a Troca de Turno, não sendo possível configurar os eventos para execução via JOB.

Parâmetros

Os parâmetros definem os filtros para fazer a geração somente do atendente desejado.

Campo:	Descrição
Atendente De ?	Selecione o primeiro atendente para começar a marcação. Caso queria sem filtro, apenas deixe em branco o valor. Exemplo: Exemplo: TEC01900000002
Atendente Ate ?	Selecione até qual o atendente iráprocessar. Caso queria sem filtro, coloque preencha com a letra "zZ" em todo seu preenchimento. Exemplo: Exemplo: TEC01900000015 ZZZZZZZZZZZZZZ
Data de Inicio De ? *	Data inicial para a geração de marcação automática. O inicio do período, tem que estar alinhado com a data cadastrado no parâmetro MV_PAPONTA.* Exemplo: 01/04/2019
Data de Fim Ate ? *	Data final da geração de marcação automática. O fim do período, tem que estar alinhado com o fim da data cadastrado no parâmetro MV_PAPONTA.* Exemplo: 30/04/2019
Processamento ?	Qual o tipo de processo que será feito. 1 - Inclusão 2 - Exclusão
Mantem Intervalo Turnos ?	Define se irá conter os atendimentos de ordens de serviço para gerar marcações em apenas uma entrada e uma saída. 1 - Sim 2 - Não

Deck of Cards

effectDuration	0.5
history	false
id	samples
effectType	fade

Card

default	true
id	1
label	MV_PAPONTA

O parametro MV_PAPONTA indica qual é o período que está em aberto. Cuidado, pois pode ocorrer confusões, ou pode estar usando um período menor que 30 dias por algum motivo e na hora de fazer a leitura se esquece de informar na data base do sistema. Inclusive é importante olhar como está o parâmetro MV_PONMES e MV_PAPONTA porque quando ele está errado, ou seja, com algum período incoerente ou MAIOR que 30/31 dias quando o cliente entra emlançamentos / marcaçõespra lançar marcações e volta na tela, as informações não são gravadas.

O preenchimento do campo é diferente entre as filiais. A data tem formato AAAAMMDD/AAAAMMDD onde o primeiro dado refere ao inicio e o segundo o final.

Exemplo:

20190401/20190430

Filial?	Define para qual filial será realizado o processamento. Permite a seleção de várias filiais. Exemplos: Preenchimento: D MG 01; D MG 02 → Realiza a geração das marcações para as filiais D MG 01 e D MG 02 Preenchimento: em branco → Realiza a geração das marcações para a filial logada.
Local De?	Selecione o primeiro Local de Atendimento para começar a marcação. Caso queria sem filtro, apenas deixe em branco. Exemplo: Exemplo: 00000001
Local Até?	Selecione até qual Local de Atendimento processar. Caso queria sem filtro, preencha com a letra "Z". Exemplo: Exemplo: 00000009 ZZZZZZZZZZZZZZ
Processa Todas as Filiais ?	Define se a rotina deve executar em todas as filiais (conforme parâmetro MV_GSMSFIL) ou apenas nas filiais definidas no Pergunte de Filiais.
Processa em MultiThread ?	Opção disponível apenas para Envio. Define se o processamento deve ser executado em multiplas threads.
Quantidade de threads ?	Define quantas threads a rotina deve iniciar para o processamento. Verificar características do servidor antes de preencher este parâmetro.
Aglutina marcações ?	Define se o sistema deve modificar o valor dos campos TDV_HRMEN e TDV_HRMAI de forma que todas as marcações para a mesma data de referência sejam preservadas no Ponto com a mesma data.
Local do Arquivo de Log	Escolha um local para geração do arquivo de Log. Caso não seja informado será gravado no servidor.

Conteúdos Relacionados

...

Árvore de páginas

Versões comparadas

Versão antiga 18

Nova versão Atual

Chave

Parâmetros

Conteúdos Relacionados

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 18

Nova versão Atual

Chave

Parâmetros

Conteúdos Relacionados