====== Importar Dados de Manutenção ======

Este caso de uso é utilizado pelos gestores de transportes para realizar a importação de manuteções de arquivos fornecidos pelas empresas com contratos de manutenções. 

===== Descrição do Caso de Uso =====

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Transportes -> Aba Gastos/Manutenção -> Manutenção -> Importar Dados de Manutenção.

O caso de uso começa com o usuário acessando o sistema e preenchendo os dados do cadastro como segue abaixo:
  * **Empresa***: Empresa que forneceu, ou é responsável pelo produto. Formato: RAZÃO SOCIAL OU NOME (CNPJ), Tipo: AUTOCOMPLETE .
  * **Somente Importar? (Não consolidar)**: Tipo LÓGICO
  * **Arquivo possui cabeçalho?**: Tipo: LÓGICO 
  * **Arquivo***: Arquivo com os abastecimentos a serem importados no formato csv. Formato: CAMINHO DO ARQUIVO, Tipo: TEXTO. [[#principais_regras_de_negócio|(RN01)]]
   
Ao adicionar um arquivo, ele irá aparecer em uma lista com os seguintes atributos e com opção de //Remover Arquivo//:

^ Nº ^ Arquivo ^ Content/Type ^ Tamanho ^ 
| 999 |  NOME DO ARQUIVO IMPORTADO  |  TIPO DO ARQUIVO    |   99999.9     |  



Ao //Efetuar Importação// será exibido a seguinte tabela com os itens das manutenções [[#principais_regras_de_negócio|(RN02)]]:

^                                                                Confirmar Dados da Importação de Manutenção                                                                 ^^^^^^^^^
^ Linha         ^ Tipo                   ^ Origem                 ^ Gerou Custos     ^ Finalidade                   ^ Data         ^ Unidade ^ Placa do Veículo ^ Hodômetro          ^
| 99            |  <Tipo da Manutenção>  | <Origem da Manutenção> |  <Gerou Custos>  |  <Finalidade da Manutenção>  |  dd/mm/aaaa  |  9999   |     XXX-9999     |       999999       |
| Num Nota: 999 | Série Nota: 999        | Fornecedor: xx.xxx.xxx/xxxx-xx           || Data Emissão Nota: dd/mm/aaaa              || Valor Nota: 999.99        || Desc. Nota: 999.99 |
^ Denominação                           ^^ Número/Série           ^ Garantia Meses   ^ Garantia KM                  ^ Quantidade            ^^ Valor                                ^^
| <Denominação do Item> || 9999 | 9999 | mm | 999999 | 999 | 9999.99 ||


Se a opção ''Somente Importar? (Não consolidar)'' não foi marcada, para finalizar o caso de uso o usuário deve clicar em 'Consolidar Manutenções', caso contrário a opção será 'Importar Manutenções'.

Se os arquivos foram importados ou consolidados, o sistema é direcionado para o caso de uso [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:gastos_manutencao:manutencao:consolidacao_manual_importacao_manutencao |Consolidar Importações]].

O caso de uso é finalizado.

===== Principais Regras de Negócio =====
  * **RN01**: O arquivo a ser inserido deve obedecer ao seguinte formato: {{:desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:gastos_manutencao:manutencao:edicao_arquivo_importacao_manutencao.pdf|}}
  * **RN02**: Ao importar o arquivo com o item "Somente Importar? (Não consolidar)" marcado, não deverá haver a consolidação dos dados do arquivo, apenas a importação, não deverão ser geradas as manutenções.

==== Resoluções/Legislações Associadas ====
Não se aplica.

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe                                                                 ^ Tabela                                                             ^
| br.ufrn.sipac.transportes.dominio.ImportarManutencao                   | administrativo.transporte.importar_manutencao                      |
| br.ufrn.sipac.transportes.dominio.ManutencaoNova                       | administrativo.transporte.manutencao_nova                          |
| br.ufrn.sipac.transportes.dominio.LinhaImportacaoArquivoManutencao     | administrativo.transporte.linha_importacao_arquivo_manutencao      |
| br.ufrn.sipac.transportes.dominio.LinhaImportacaoArquivoItemManutencao | administrativo.transporte.linha_importacao_arquivo_item_manutencao |
| br.ufrn.sipac.transportes.dominio.OcorrenciaConsolidacaoImportacaoManutencao  | administrativo.transporte.ocorrencia_importacao_manutencao |

====== Plano de Teste ======

Sistema: SIPAC

Módulo: TRANSPORTES

Link(s): SIPAC → Módulo Transportes → Aba Gastos/Manutenção → Manutenção → Importar Dados de Manutenções 

Usuários: bergue

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, 
  * SipacPapeis.GESTOR_TRANSPORTES_MANUTENCAO.

===== Cenários de Teste =====

Para verificar se os dados foram cadastrados/alterados corretamente, pode-se verificar a listagem exibida em Menu Transportes -> Veículo -> Manutenção -> Listar/Alterar.

===== Dados para o Teste =====

Criar um arquivo de manutenções no formato .csv com dados de manutenções, seguindo o seguinte formato: {{:desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:gastos_manutencao:manutencao:edicao_arquivo_importacao_manutencao.pdf|}}.