~~ODT~~
<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

======  Importar Arquivo CSV ======

Este caso de uso permite ao usuário importar o arquivo que será utilizado para cadastrar os discentes aprovados em concursos externos como, por exemplo, o [[http://sisu.mec.gov.br/|SiSU]]. Os dados importados são basicamente os dados pessoais, matriz curricular aprovado e classificação, e geralmente estes dados vem em um arquivo texto no formato [[http://pt.wikipedia.org/wiki/Comma-separated_values|CSV (Comma-Separated Values)]].

O usuário utilizará o sistema para fazer o upload do arquivo. Uma vez lido, o usuário deverá informar um mapeamento, isto é, qual a coluna (campo) no arquivo e o atributo correspondente no sistema, e a equivalência entre valores de atributos compostos como, por exemplo, matriz curricular. 

Os arquivos de importação, precisam de algumas customizações, listadas a seguir:

  - Adicionar uma coluna chamada MATRIZ_APROVADO, concatenando o campus, turno, curso, tipo de formação ex: FARMACIA - CAMPUS NATAL - VESPERTINO - BACHARELADO 
  - Adicionar uma coluna chamada MUNICIPIO_UF, concatenando a UF e o MUNICIPIO
  - No Arquivo do SiSU, na coluna "NU_NOTA_APROVADO", substituir todos os "pontos" por "vírgula" e formatar a coluna como numérica. Isso é necessário porque o Excel não entende as notas sem casas decimais como sendo células numéricas. ex: "721". Nesse caso a alteração é para que a nota seja convertida para "721,00" e passe a ser ordenado de forma correta.
===== Descrição do Caso de Uso =====

Este caso de uso inicia quando o usuário acessa a opção: //SIGAA -> Vestibular -> Importação/Convocação -> Vestibulares/Concursos Externos -> Importar Arquivo CSV//.

Será solicitado do usuário os seguintes parâmetros:

  * **Forma de Ingresso***: Tipo - TEXTO.
  * **Descrição***: Tipo - TEXTO.
  * **Arquivo***: Tipo - ARQUIVO.
  * **Dados Separados por***: Tipo - TEXTO. Onde o usuário tem a opção de escolher entre: ''Vírgula, Ponto e Vírgula e Tabulação''. 

==== Mapeamento dos Dados em Atributos de Discente  ====

O usuário deverá associar um campo do arquivo à um atributo no sistema. Alguns atributos são obrigatórios e estes são indicados na descrição da operação. Os atributos que podem ser mapeados são definidos direto no banco de dados.

==== Informar as Equivalências  ====

Alguns atributos são compostos como, por exemplo, a matriz curricular. Outros atributos já estão cadastrados no sistema e deverão ser utilizados ao invés de serem cadastrados novamente como, por exemplo, os municípios e Unidades Federativas. O usuário deverá informar o valor equivalente do sistema para cada valor do arquivo.

Há duas formas de definir as equivalências entre valores:

  * ComboBox: O usuário tem uma lista dos valores e um ComboBox para indicar a qual valor no banco ele corresponde.
  * Autocomplete: quando a quantidade de campos a fazer equivalência é grande, o uso de ComboBox aumenta o uso da memória e consequentemente a operação fica lenta. Embora seja um pouco mais trabalhoso desta forma.

O sistema ainda tenta definir alguns valores automaticamente quando os nomes são equivalentes, porém cabe ao usuário revisar e aceitar os valores definidos.

==== Confirmação ====

O usuário deverá confirmar os dados a serem importados.

O caso de uso é encerrado.

===== Principais Regras de Negócio =====

  * **RN01** - O usuário deverá informar um arquivo com os valores obrigatórios, que são definidos direto no banco de dados (podem variar com tempo).

==== Resoluções/Legislações Associadas ====

Não se aplica.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.vestibular.dominio.ImportacaoDiscenteOutrosConcursos | sigaa.vestibular.importacao_discente_outros_concurso |
| br.ufrn.sigaa.vestibular.dominio.AtributoClasseMapeavel | sigaa.comum.atributo_mapeavel |
| br.ufrn.sigaa.vestibular.dominio.HistoricoMapeamentoAtributo | sigaa.comum.historico_mapeamento_atributo |
| br.ufrn.sigaa.vestibular.dominio.ConvocacaoProcessoSeletivoDiscente | sigaa.vestibular.convocacao_processo_seletivo_discente |
| br.ufrn.sigaa.vestibular.dominio.InscricaoVestibular | sigaa.vestibular.inscricao_vestibular |
| br.ufrn.sigaa.vestibular.dominio.PessoaVestibular | sigaa.vestibular.pessoa_vestibular |
| br.ufrn.sigaa.vestibular.dominio.ConvocacaoProcessoSeletivo | sigaa.vestibular.convocacao_processo_seletivo |
| br.ufrn.sigaa.vestibular.dominio.ResultadoClassificacaoCandidato | sigaa.vestibular.resultado_classificacao_candidato |
| br.ufrn.sigaa.vestibular.dominio.ProcessoSeletivoVestibular | sigaa.vestibular.processo_seletivo |
| br.ufrn.sigaa.ensino.graduacao.dominio.MatrizCurricular | sigaa.graduacao.matriz_curricular |
| br.ufrn.sigaa.dominio.Curso | sigaa.curso |
| br.ufrn.sigaa.vestibular.dominio.ResultadoOpcaoCurso | sigaa.vestibular.resultado_opcao_curso |
| br.ufrn.sigaa.ensino.graduacao.dominio.Curriculo | sigaa.graduacao.curriculo |

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

Sistema: SIGAA

Módulos: Graduação

Link(s): Vestibular -> Importação/Convocação -> Vestibulares/Concursos Externos -> Importar Arquivo CSV

Usuário: edipo, acoelho

Papel que usuário deve ter: SigaaPapeis.VESTIBULAR

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

Importar arquivos.

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

Criar um arquivo CSV. Um formato sugerido é o da tabela abaixo, baseado no arquivo que é recebido do SiSU.

^ Cód. do Curso  ^ Nome do Curso  ^ Número inscrição do Candidato no Enem  ^ Nome do Candidato  ^ CPF do Candidato  ^ Data Nasc. do Candidato  ^ Sexo do Candidato  ^ RG do Candidato  ^ Nome mãe do Candidato  ^ Logradouro do Candidato  ^ Número Logradouro do Candidato  ^ Complemento Logradouro do Candidato  ^ UF do Candidato  ^ Município do Candidato  ^ Bairro do Candidato  ^ CEP do Candidato  ^ Telefone1 do Candidato  ^ Telefone2 do Candidato  ^ E-mail do Candidato  ^ Número inscrição do Candidato no SiSU  ^ Colocação do Candidato, no Curso  ^ Candidato aprovado        ^ Pais   ^ Raça   ^ Semestre  ^
| NUMÉRICO       | TEXTO          | NUMÉRICO                               | TEXTO              | NUMÉRICO          | DATA                     | TEXTO (F / M)      | NUMÉRICO         | TEXTO                  | TEXTO                    | NUMÉRICO                        | TEXTO                                | TEXTO (Ex.: RN)  | TEXTO                   | TEXTO                | NUMÉRICO          | TEXTO                   | TEXTO                   | TEXTO                | NUMÉRICO                               | NUMÉRICO                          | TEXTO (Exemplo: SIM/NÃO)  | TEXTO  | TEXTO  | NUMÉRICO  |


</ifauth>