~~ODT~~

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

Mecanismo utilizado para acelerar a criação de turmas virtuais por parte dos Docentes. Esta funcionalidade permite que o docente importe vários itens de turmas dos semestres anteriores e modifique apenas o que for necessário para a turma do semestre corrente.
===== Descrição do Caso de Uso =====

Este caso de uso inicia-se quando o usuário acessa a opção : SIGAA -> Portal do Docente -> Turma Virtual -> Configurações -> Importação de Dados 

O caso de uso inicia exibindo uma lista com as turmas anteriores (Turmas ou turmas agrupadoras, [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:configuracoes:importacao_de_dados#Principais regras de negócio|RN04]]) que possuem dados que podem ser importados para turma atual. Para cada uma são exibidos:
  * **__Componente Curricular__ **: Tipo - TEXTO.
  * **__Turma __**: Tipo - NUMÉRICO.
  * ** __Ano-Período__ **: Tipo - NUMÉRICO.

Ao selecionar uma turma são exibidos os tipos de dados que podem ser importados:

  * **__Tópicos de Aula__**
    * **__Título__**: Tipo - TEXTO.
    * **__Data Inicial__**: Tipo - DATA.
    * **__Data Final__**: Tipo - DATA.
  * **__Plano de Curso__**
  * **__Conteúdos__**
  * **__Arquivos__**
  * **__Referências__**
  * **__Vídeos__**

Os tópicos de aula aparecerão como marcados, pois os outros materiais precisam estar associados a um tópico de aula. 

É possível preencher as datas dos tópicos de aula automaticamente clicando no botão "Preencher Datas dos Tópicos Automaticamente", no entanto, para que a operação seja bem sucedida é necessário exister uma relação entre as datas dos tópicos da turma dos semestre anterior e as datas dos tópicos das turmas do semestre atual. 

Todos os tópicos de aula da turma que terão seus dados importados serão listados e o docente poderá selecionar as novas datas de início e fim dos tópicos.
Os tópicos importados serão ordenados na turma virtual através de suas datas.      

Após importar os dados ([[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:configuracoes:importacao_de_dados#Principais regras de negócio|RN01]], [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:configuracoes:importacao_de_dados#Principais regras de negócio|RN02]]), eles devem aparecer no menu principal da turma, com as datas atualizadas. 

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

  * ** RN01: ** O docente só pode importar dados de uma turma na qual ele já foi docente.
  * ** RN02: ** A data final do tópico de aula importado não deve vir antes que sua data inicial.
  * ** RN03: ** Se o tópico de aula importado tiver um pai suas datas deverão está contidas no intervalo das datas do tópico pai.
  * ** RN04: ** A lista não deve exibir subturmas, pois estas não possuem tópicos de aulas ou materiais. Estes ficam sempre na turma agrupadora.

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

Não se Aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ava.dominio.TopicoAula | academico.ava.topico_aula |
| br.ufrn.sigaa.ava.dominio.ConteudoTurma | academico.ava.conteudo |
| br.ufrn.sigaa.ava.dominio.ArquivoTurma | academico.ava.arquivo_turma |
| br.ufrn.sigaa.ava.dominio.IndicacaoReferencia | academico.ava.indicacao_referencia |
| br.ufrn.sigaa.ava.dominio.VideoTurma | academico.ava.video_turma |

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

Sistema: SIGAA

Módulo: Turma Virtual

Link(s): Configurações -> Importação de Dados

Usuário: petrus, jmarcos, snm, madruga.

Papel que usuário deve ter: SigaaPapeis.DOCENTE

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

  - Deve-se testar a importação de dados de uma turma para outra.
  - Entrar na opção //**SIGAA -> Portal do Docente -> Turma Virtual -> Principal**//
  - Deve-se testar se os dados importados estão relacionados com seus respectivos tópicos de aula. Por exemplo: Se um contéudo está relacionado a um tópico de aula na turma anterior, sua cópia deve estar relacionada com a cópia do tópico. Os dados para serem testados incluem sub-tópicos, contéudos, referências e arquivos.
  - Deve-se testar se é possível colocar as datas de início de fim nos tópicos de aula e se a importação ocorre com sucesso.
  - Deve-se testar se ao colocar uma data final superior que a data inicial é exibida uma mensagem de erro.
  - Deve-se testar se ao colocar as datas de um tópico filho fora do intervalo das datas do tópico pai é exibida uma mensagem de erro.
  - Deve-se testar se caso a turma pra onde está sendo realizada a importação, possuir turmas importadas, que são subTurmas, deve-se mostrar não as subturmas, mas a turma agrupadora delas.  
  - Deve-se testar se é possível importar turmas equivalentes.  

===== Dados para o teste =====

A consulta abaixo mostra os docentes que possuem turmas agrupadoras:
A consulta filtra pela situação da turma, ano e período.

<code>

select u.login from comum.usuario as u 
inner join rh.servidor as s using (id_servidor)
inner join ensino.docente_turma as d on (d.id_docente = s.id_servidor)
inner join ensino.turma as t using (id_turma)
inner join ensino.componente_curricular as c on t.id_disciplina = c.id_disciplina
join ensino.matricula_componente m using (id_turma)
where 
c.nivel = 'G' and t.id_situacao_turma = 1 and t.ano = 2011 and t.id_turma_agrupadora is not null 
group by t.id_turma , u.login 

</code>


A consulta abaixo mostra as disciplinas equivalentes de um componente cujo código é passado como parâmetro:

<code>

select equivalente.codigo from ensino.componente_curricular disciplina 
join ensino.componente_curricular_detalhes detalhe on disciplina.id_detalhe = detalhe.id_componente_detalhes
join ensino.componente_curricular equivalente on detalhe.equivalencia like  '% '||equivalente.id_disciplina||' %'
where disciplina.codigo like '<Código da Disciplina>'

</code>