Cadastrar Horário de Retorno  

Durante o processo de geração da escala programada, o SIGEM não informará o horário de início da tarefa de retorno. Para planejar e operacionalizar a programação de tais horários, o responsável pela escala deve levantar quais horários serão necessários no destacamento ou no local de troca de equipe e cadastrá-los no sistema.
Este caso de uso permite ao usuário do sistema efetuar o cadastramento e manutenção dos horários de retorno com o objetivo de disponibilizá-los para a programação das tarefas de retorno das equipagens na tela  “Acompanhar Retorno”.

Campos de Filtro:

• Ferrovia: campo obrigatório na pesquisa de M.O., apresenta somente as Ferrovias que o usuário tem permissão de acesso;
• Corredor: depende da ferrovia selecionada;
• Local: lista de locais ferroviários que o usuário tem permissão de acesso;
• Sentido: lista de tarefas relacionadas à ferrovia;
• Ordenado por:campo que permite ordenar o resultado da consulta na grade;
• Sem paginação: o usuário pode optar por apresentar a lista de resultados com ou sem paginação.

Grade de Consulta: o sistema apresenta uma grade de consulta contendo as seguintes colunas:

• Sentido: retorna um ícone representado o sentido do trem;
• Local: retorna os locais ferroviários;
• Colunas de 00 a 23: representam os Horários (00: 00 h às 23: 00 h).
  

Botão "Consultar":

1. O usuário preenche os campos dos filtros e clica sobre o botão "Consultar".
2. O sistema carrega a grade com os parâmetros informados.  A grade pode ser apresentada "com paginação" ou "sem paginação". 

Botão "Incluir":

1. Redireciona o usuário para a tela de inclusão, descrita a seguir.

Link na coluna "Local":

1. O conteúdo da coluna "Local" possuirá um link que dará acesso à tela de Atualização e Exclusão dos Horários de Retorno.

Incluir:

1. Esta tela é iniciada quando o usuário clica sobre o botão “Incluir”.
2. O sistema apresenta tela com os seguintes campos:
   
   
   1. Ferrovia:campo obrigatório para informra basta selecionar um item da lista de ferrovias;
   2. Corredor:campo obrigatório depende da ferrovia selecionada e para informar basta selecionar um campo da lista;
   3. Local:campo obrigatório que contém o código do local pertencente ao corredor selecionado. O sistema também apresenta a descrição resumida.O sistema apresenta os  Destacamentos e os locais com ponto de troca.Todos os locais apresentado na lista são ativos;
   4. Sentido: campo obrigatório onde o usuário deverá informar o sentido do trem;
   5. Horário: campo obrigatório onde o usuário deverá informar o Horário de programação de retorno.
   6. Equipes: campo obrigatório onde o usuário deverá informar o Número de maquinistas que deverão estar disponíveis no horário especificado.
      

3. O sistema irá verificar os campos obrigatórios, se os campos obrigatórios não estiverem todos preenchidos o sistema retorna a mensagem padrão de campos obrigatórios não preenchidos;
4. Se todos os requisitos forem respeitados o sistema irá armazenar o Horário de retorno com sucesso.

Atualizar:

1. Esta tela é iniciada quando o usuário clica sobre o link de um registro da coluna “Local” da grade de consulta.
2. O sistema apresenta a tela de Atualização e Exclusão (idêntica a tela de Inclusão) com os campos “Ferrovia”, “Corredor”, “Local” e “Sentido” desabilitados para edição.
3. O sistema carrega os campos e a grade de horários.
4. O usuário altera os campos desejados. Não existe um número máximo para Horários e em seguida clica sobre o botão “Salvar”.
5. O sistema retorna mensagem padrão de confirmação de alteração. Se o usuário cancelar a mensagem, o sistema mantém os valores dos campos e não efetua a operação.  Se o usuário confirmar a mensagem, o sistema verificar todas as dependências necessárias e se todos os requisitos forem respeitados o sistema irá altear o Horário de retorno com sucesso.
   

Excluir:

1. Esta tela é iniciada quando o usuário clica sobre link de um registro da coluna “local” da grade de consulta.
2. O sistema apresenta a tela de Atualização e Exclusão (idêntica a de Inclusão) com os campos “Ferrovia”, “Corredor”, “Local” e “Sentido” desabilitados para edição.
3. O sistema carrega os campos e a grade de horários.
4. Quando o usuário clica sobre o botão “Excluir” , o sistema retorna mensagem padrão de confirmação de exclusão. Se o usuário cancelar a mensagem, o sistema mantém os valores dos campos e não efetua a operação.  Se o usuário confirmar a mensagem, o sistema verificar todas as dependências se se todas forem respeitadas o sistema remove o registro.

Botão “Incluir” da grade de horários

1. O usuário clica sobre o botão “Incluir” da grade de horários.
2. Se o usuário clicar sobre o botão “Incluir” com o campo “Horário” ou campo “Equipes” vazio, o sistema apresenta  a mensagem “Os campos horário e número de equipes devem ser informados.”. Não existe um número máximo para Horários.
3. O sistema verifica se a horário já foi cadastrada anteriormente. Caso positivo, o sistema  retorna a mensagem “Este horário já foi cadastrado. Altere o número de equipagens ” , o usuário confirma a mensagem e o sistema não inclui o horário na grade.
4. Se os critérios forem respeitados, o sistema retorna a grade atualizada.
5. Na inclusão dos horários de retorno, o sistema desabilita os campos “Ferrovia”, “Corredor” e “Local” e “Sentido”.  

Botão “Atualizar” da grade de horários

1. O usuário clica no botão “Atualizar” da grade de horários;
2. Se não houver um horário selecionado, o sistema apresenta a mensagem “Um horário deve ser selecionado“;
3. A grade não deve permitir a seleção múltipla dos elementos;
4. O ususário seleciona uma linha da grade de Horários de Retorno;
5. O sistema carrega o campo “Horário” e “Equipes”. O campo Horário deve estar desabilitado para edição.
   
6. O sistema deve verificar todas as dependências necessárias;
7. O sistema atualiza o campo “Equipes”.
   

Botão “Excluir”

1. O usuário clica no botão “Exluir” da grade de horários;
2. Se não houver um horário selecionado, o sistema apresenta a mensagem “Um horário deve ser selecionado“;
3. A grade não deve permitir a seleção múltipla dos elementos;
4. O ususário seleciona uma linha da grade de Horários de Retorno; 
5. O sistema carrega o campo “Horário” e “Equipes”. O campo Horário deve estar desabilitado para edição.
   
6. O sistema remove o “Horário” selecionado da grade de Horários de Retorno.
7. 7.    Se a grade de Horários de Retorno estiver vazia, o sistema habilita os campos “Ferrovia”, “Corredor” e “Local” e “Sentido”.