...
Índice |
---|
maxLevel | 5 |
---|
outline | true |
---|
indent | 8.1.1 |
---|
exclude | .*ndice |
---|
style | none |
---|
|
Objetivo
Gera, automaticamente, atendimentos de ordens de serviços dos agendamentos que foram realizados pelo controle de alocação após a geração e implantação do contrato. Para agendamentos avulsos, sem vínculo com contratos, não há geração automática e o atendimento da ordem de serviço é manual.
Permite incluir e excluir marcações no ponto eletrônico para os atendentes, baseando-se nos atendimentos de Ordens de Serviços.
Os atendimentos gerados são enviados para o módulo de Ponto Eletrônico.
Informações |
---|
|
É possível gerar o atendimento da OS de forma automática sem a dependência do processo de 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
alocação de atendentes |
Mapa Mental
Conheça neste diagrama as informações que contemplam as funcionalidades da rotina:
Image Removed
Na página principal da rotina, estão disponíveis as opções:
Image Added
Deck of Cards |
---|
effectDuration | 0.5 |
---|
history | false |
---|
id | samples |
---|
effectType | fade |
---|
|
Card |
---|
default | true |
---|
id | 1 |
---|
label | Geração de Atendimentos de OS |
---|
| Para a geração de atendimento de ordens de serviços, acesse Atualizações / Efetivo Operacional / Geração de Atendimentos de Ordens de Serviços. Preencha a tela dos Parâmetros. 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. |
|
...
| 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 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. |
Card |
---|
| 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 |
---|
| 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. 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. Exemplo: 01/04/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 ? | 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. |
...
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 |
Data Início De? | Informe a data inicial. Exemplo: 01/06/2016 |
Data Fim Até? | Informe a data final. Exemplo: 15/06/2016 |
Cliente De? | Pressione F3 e selecione o código inicial do cliente. Exemplo: TEC001 |
Cliente Até? | Pressione F3 e selecione o código final do cliente. Exemplo: TEC005 |
Contrato De? | Pressione F3 e selecione o contrato inicial Exemplo: CRTATO120000013 |
Contrato Até? | Pressione F3 e selecione o contrato final.
Exemplo: CRTATO120000014 |
O.S De? | Pressione F3 e selecione a ordem de serviço inicial.
Exemplo: 000001 |
O.S Até? | Pressione F3 e selecione a ordem de serviço final.
Exemplo: 000004 |
Serviço Padrão? | Pressione F3 e selecione o serviço padrão.
Exemplo: 000008 |
Local De? | Pressione F3 e selecione o local de atendimento inicial.
Exemplo: 00000006 |
Local Até? | Pressione F3 e selecione o local de atendimento final.
Exemplo: 00000006 |
...
Conteúdos Relacionados
...