...
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 Ordens de serviçosServiç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 |
---|
|
É importante considerar que as informações deste relatório dependem de 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.
|
Mapa Mental
Conheça neste diagrama as informações que contemplam as funcionalidades da rotina:
![](/download/attachments/244713632/Gera%C3%A7%C3%A3o%20de%20Marca%C3%A7%C3%B5es_1.jpg?version=2&modificationDate=1470334103000&api=v2)
Na página principal da rotina, estão disponíveis as opções:
Deck of Cards |
---|
effectDuration | 0.5 |
---|
history | false |
---|
id | samples |
---|
effectType | fade |
---|
|
Card |
---|
default | true |
---|
id | 1 |
---|
label | Procedimento |
---|
| O passo-a-passo abaixo descreve a utilização da rotina: - Gerar um orçamento de serviços.
- Acessar o "Assistente de Contrato" e gerar o contrato do orçamento
- Fazer alocação de atende no "Gestão de Escala" ou "Gestão de Contratos".
- Utilizar a rotina "Geração
| de Marcação com turno = sim Para a geração de marcação, acesse Atualizações / Efetivo Operacional / Geração de Marcações. 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 |
---|
default | true |
---|
id | 2 |
---|
label | Geração de Marcação com turno = não |
---|
| Para a geração de marcação, acesse Atualizações / Efetivo Operacional / Geração de Marcações. 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 |
---|
default | true |
---|
id | 3 |
---|
label | Excluir geração de marcação turno = sim |
---|
| Para a exclusão, acesse Atualizações / Efetivo Operacional / Geração de Marcações. 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 |
---|
default | true |
---|
id | 4 |
---|
label | Excluir geração de marcação turno = não |
---|
| Para a exclusão, acesse Atualizações / Efetivo Operacional / Geração de Marcações. 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. |
|
...
- 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 Figura 3 - Parâmetros da rotina. Figura 2 - Geração de marcações. Informações |
---|
| 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 |
---|
| 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 |
---|
| 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 |
---|
| É 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 |
---|
| 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 |
---|
| 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. |
|
Parâmetros
Os parâmetros definem os filtros para fazer a geração somente do atendente desejado.
...
Campo: | Descrição |
Atendente De ? |
Pressione F3 e selecione o código inicial do atendente. Exemplo: 000000000002TEC | Atendente Até? | Pressione F3 e selecione o código final do atendente. Exemplo: 000000000003TEC |
Selecione o 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ática062016 AtéInforme a data final para a geração automáticaData 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: |
15062016Processamento ? | 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 |
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 |
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
...