Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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. 

...

Conheça neste diagrama as informações que contemplam as funcionalidades da rotina: 

Parâmetros

...

Campo:

...

Descrição

...

Selecione o primeiro atendente para começar a marcação.

*Caso queria sem filtro, apenas deixe em branco o valor. 

Exemplo:                                           Exemplo:

Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelProcedimento

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

  1. Gerar um orçamento de serviços.
  2. Acessar o "Assistente de Contrato" e gerar o contrato do orçamento
  3. Fazer alocação de atende no "Gestão de Escala" ou "Gestão de Contratos".
  4. Utilizar a rotina "Geração de Atendimentos de Ordens de Serviços" para gerar as ordens de serviços para a agenda de trabalho dos atendentes.

         

          Image Added

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

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

                

           Image Added

...

           Image Added             

...

Selecione até qual o atendente irá.

*Caso queria sem filtro, coloque a letra "z" em todo seu preenchimento.

...

            Figura 3 - Parâmetros da rotina.                                                         

...

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

     

...

Informações
titleNota

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
titleMobile

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.

CampoDescriçãoTipo
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
id2
labelMV_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

            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
id3
labelAPI 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:

PropriedadeParâmetroTipoObrigatório
employeeFromMV_PAR01textoSim, se não possuir a propriedade employees.
employeeToMV_PAR02textoSim, se não possuir a propriedade employees.
startDateMV_PAR03texto, no formato YYYY-MM-DDSim
endDateMV_PAR04texto, no formato YYYY-MM-DDSim
operationMV_PAR05

numérico (1 ou 2)

1 = Inclusão

2 = Exclusão

Sim
keepShiftBreakMV_PAR06

numérico (1 ou 2)

1 = Sim

2 = Não

Sim
employees
arraySim, se não possuir as propriedades employeeFromemployeeTo

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
id4
labelEnvio 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_CAMPOABB_MPONTO
X3_TIPOL
X3_TAMANHO1
X3_DECIMAL0
X3_TITULOMarc. Ponto
X3_DESCRICMarcacao Ponto Eletronico
X3_USADO€€€€€€€€€€€€€€ 
X3_RELACAO.F.
X3_NIVEL1
X3_RESERVþÀ
X3_PROPRIU
X3_BROWSEN
X3_VISUALV
X3_CONTEXTR
X3_ORTOGRAN
X3_IDXFLDN
X3_POSLGT1
X3_MODAL2
Card
id5
labelHora 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
titleImportante

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:

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

Visualize no ponto as marcações.

Image Added

Figura 2 - Visualização no ponto.

Parâmetros


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

...

Data inicial para a geração de marcação automática.

Exemplo:

01/04/2019 

...

Data final da geração de marcação automatica.

Exemplo:

30/04/2019 

...

Qual o tipo de processo que será feito.

1 - Inclusão

2 - Exclusão 

...

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

Na página principal da rotina, estão disponíveis as opções:

Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelGeração de Marcação com turno = sim

Para a geração de marcação, preencha a tela dos Parâmetros com Processamento = Inclusão e Intervalo de Turnos = Sim

As informações devem ser preenchidas de acordo com as orientações descritas em Principais Campos.

Veja também as funcionalidades disponíveis em Outras Ações.

Card
defaulttrue
id1
labelGeração de Marcação com turno = sim

Para a geração de marcação, preencha a tela dos Parâmetros com Processamento = Inclusão e Intervalo de Turnos = Sim

As informações devem ser preenchidas de acordo com as orientações descritas em Principais Campos.

Veja também as funcionalidades disponíveis em Outras Ações.

Card
defaulttrue
id2
labelGeração de Marcação com turno = não

Para a geração de marcação, preencha a tela dos Parâmetros com Processamento = Inclusão e Intervalo de Turnos = Não.

As informações devem ser preenchidas de acordo com as orientações descritas em Principais Campos.

Veja também as funcionalidades disponíveis em Outras Ações.

Card
defaulttrue
id3
labelExcluir geração de marcação turno = sim

Para a exclusão, preencha a tela dos Parâmetros com Processamento = Exclusão e Intervalo de Turnos = Sim.

As informações devem ser preenchidas de acordo com as orientações descritas em Principais Campos.

Veja também as funcionalidades disponíveis em Outras Ações.

Card
defaulttrue
id4
labelExcluir geração de marcação turno = não

Para a exclusão, preencha a tela dos Parâmetros com Processamento = Exclusão e Intervalo de Turnos = Não.

As informações devem ser preenchidas de acordo com as orientações descritas em Principais Campos.

Veja também as funcionalidades disponíveis em Outras Ações.

Informações
titleNota

De acordo com as informações cadastradas nas pré-condições, os Principais Campos podem ser preenchidos por meio da utilização da consulta padrão (tecla F3).

...

AtéInforme a data final para a geração automática15062016 ?

Campo:

Descrição

Atendente De ?

Selecione o

código inicial do atendente.

Exemplo:

000000000002TEC

Atendente Até?

Selecione o código final do atendente.

Exemplo:

000000000003TEC

primeiro atendente para começar a marcação.

Caso queria sem filtro, apenas deixe em branco. 

Exemplo:                                           Exemplo:

TEC01900000002                               

Atendente Ate ?

Selecione até qual o atendente processar.

Caso queria sem filtro, preencha com a letra "Z".

Exemplo:                                           Exemplo:

TEC01900000015                               ZZZZZZZZZZZZZZ

Data de Inicio De ? *

Data inicial para a geração de marcação.

*O inicio do período, tem que estar alinhado com a data cadastrado no parâmetro MV_PAPONTA

Data Início De?Informe a data inicial para a geração automática

.

Exemplo:

01/

06

04/

2016

2019 

Data de Fim Ate ? *

Data final da geração de marcação.

*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

Utilize a seta indicadora e selecione a opção.

Exemplo:

Inclusão

Exclusão

Mantêm intervalos de turnos ?

Utilize a seta indicadora e selecione a opção.

Exemplo:

Sim

Não

?

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

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

...