Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.

[[sigaa:lato_sensu:documentacao_tecnica:busca_geral_de_turmas| << Voltar]] <PHP> echo "<div style='display:block;float:right;'>"; echo "Última atualização: "; ver('', false); echo "</div>"; </PHP> ====== Consultar Turma ====== Entende-se por turma algo que seja composto por componentes curriculares, horário, docente e discente. As turmas são criadas nos módulos [[desenvolvimento:especificacoes:sigaa:infantil:casos_de_uso:alunos:turmas:cadastrar|Infantil]], [[desenvolvimento:especificacoes:sigaa:tecnico:casos_de_uso:turma:turma:cadastrar|Técnico]], [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:turmas:criar_turma|Graduação]], [[desenvolvimento:especificacoes:sigaa:lato_sensu:casos_de_uso:turma:turma:criar_turma|Lato Sensu]], [[desenvolvimento:especificacoes:sigaa:stricto_sensu:casos_de_uso:vinculos_matriculas:turmas:criar_turma|Stricto Sensu]], e [[desenvolvimento:especificacoes:sigaa:ensino_a_distancia:casos_de_uso:coordenacao:turmas:cadastrar|Ensino à Distância]], ou solicitadas nos portais [[desenvolvimento:especificacoes:sigaa:portal_coordenador_graduacao:casos_de_uso:turmas:solicitar_abertura_de_turmas|Coordenador de Graduação]], [[desenvolvimento:especificacoes:sigaa:portal_coordenador_lato_sensu:casos_de_uso:turmas:cadastrar_turma|Coordenador Lato Sensu]] e [[desenvolvimento:especificacoes:sigaa:portal_coordenador_stricto_sensu:casos_de_uso:turmas:criar_turma|Coordenador de Stricto Sensu]], para que os alunos possam cumprir o [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:ddp:estrutura_curricular::cadastrar|currículo do seu curso]]. De forma similar, este caso de uso é usado em vários portais e módulos do SIGAA, permitindo ao usuário buscar por turmas criadas. Essa funcionalidade é utilizada pelos funcionários do DAE (Departamento de Administração Escolar). ===== Descrição do Caso de Uso ===== Este caso de uso inicia-se quando a opção //SIGAA -> Graduação -> Consultas -> Consultas Gerais -> Turma// é acessada. Para realizar a busca por uma turma, o usuário poderá informar os parâmetros para restringir a busca: * **Nível:** Tipo - TEXTO. Restringe a busca pelo nível de ensino (infantil, médio, técnico, graduação, especialização, stricto sensu, mestrado, ou doutorado); * **Ano - Período:** Formato - AAAA.9. Ano-período da turma; * **Unidade:** Formato - TEXTO. Unidade que ofertou a turma; * **Código do componente:** Formato - AAA9999. Código do componente curricular ofertado da turma; * **Código da turma:** Formato - 99. Tipo - NUMÉRICO. O código serve para diferenciar as várias turmas criadas para a oferta de matrícula em um mesmo componente curricular; * **Local:** Tipo - TEXTO e NUMÉRICO. Local das aulas da turma; * **Nome do componente:** Tipo - TEXTO. Nome, ou parte do nome, do componente curricular ofertado na turma; * **Nome do docente:** Tipo - TEXTO. Nome do docente que ministrará as aulas na turma; * **Ofertadas ao curso:** Tipo - TEXTO. Esta opção surge apenas para turmas do nível de Graduação e restringe a busca à turmas que possuam reserva de vagas para o curso escolhido; * **Pólo:** Tipo - TEXTO. Pólo de funcionamento do curso à distância; * **Situação:** Tipo - TEXTO. Situação da turma (a definir docente, aberta, ou consolidada, podendo escolher todas); * **Tipo:** Tipo - TEXTO. Tipo da turma (regular, férias, ou ensino individual, podendo escolher todas); * **Somente turmas vinculadas ao Convênio Probásica:** Tipo - LÓGICO. Ao marcar esta opção, serão buscadas somente as turmas criadas no Convênio Probásica; * **Exibir resultado da consulta em formato de relatório:** Tipo - LÓGICO. Exibe o resultado da busca no formato de relatório. * **Ordenar por:** Tipo - TEXTO. Oferece alternativas de ordenação para o resultado da busca. São apresentadas as opções: ''ORDENAR POR COMPONENTE CURRICULAR, ORDENAR POR DIAS DA SEMANA E RESPECTIVOS HORÁRIOS, ORDENAR POR DOCENTE, DISCIPLINAS E RESPECTIVOS HORÁRIOS, ou ORDENAR POR LOCAL''. O resultado da busca lista as turmas informando o Código, docente(s), tipo, situação, horário, local, a quantidade de discentes matriculados e a capacidade da turma. ^ Ano Período ^ Docente(s) ^ Tipo ^ Situação ^ Horário ^ Local ^ Mat./Cap. | ^ CÓDIGO - NOME DA DISCIPLINA (NÍVEL) ^^^^^^^ | AAAA.2 | Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO e NUMÉRICO | Tipo - TEXTO e NUMÉRICO | Tipo - NUMÉRICO | Dependendo das permissões do usuário, pode-se: * **Adicionar Reserva:** adiciona uma reserva de vagas para um determinado curso; * **Alterar:** altera os dados da turma; * **Duplicar Turma**: os dados da turma serão copiados e o usuário será redirecionado para o caso de uso de [[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:chefia:turmas:criar_turma_sem_solicitacao|cadastro de turma]]. * **Cadastrar Notícia:** cadastra uma [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:turma::noticias|notícia]] para turma. * **Diário de turma:** emite o diário de turma; * **Lista de Frequência:** emite a lista de frequência de uma turma (lista a ser assinada pelos discentes); * **Fechar Turma:** muda o status da turma para CONSOLIDADA; * **Listar Alunos:** lista os alunos da turma, informando a matrícula, nome, matriz curricular, e situação da matrícula; * **Notas dos alunos:** gera um relatório das notas dos alunos; * **Notas dos tutores:** lista as notas dos tutores; * **Processamento da Matrícula:** exibe o resultado do processamento da matrícula para a turma; * **Processamento da Rematrícula:** exibe o resultado do processamento da rematrícula para a turma; * **Reabrir turma:** muda o status da turma para ABERTA, mudando o status dos alunos da turma para MATRICULADO. * **Remover:** remove a turma; * **Visualizar Turma:** visualiza os dados da turma, os quais são: * **__Componente Curricular__**: Tipo - TEXTO. * **__Tipo do Componente__**: Tipo - TEXTO. * **__CH __**<del> / Créditos</del>: Tipo - TEXTO. * **__Tipo da Turma__**: Tipo - TEXTO. * **__Docente(s)__**: Tipo - TEXTO. * **__Código da Turma__**: Tipo - TEXTO. * **__Local__**: Tipo - TEXTO. * **__Horário__**: Tipo - TEXTO. * **__Ano-Período__**: Tipo - NUMÉRICO. * **__Período de Aulas__**: Tipo - TEXTO. * **__Modalidade__**: Tipo - TEXTO. * **__Capacidade de Alunos__**: Tipo - NUMÉRICO. * **Alterar Status de Matrícula:** direciona o usuário para [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:matriculas:alterar_status_de_matricula_por_turmas|Alterar o Status de Matrícula da Turma]]. * **Visualizar Turma Virtual:** direciona o usuário para a [[desenvolvimento:especificacoes:sigaa:turma_virtual:principal|turma virtual]]. * **Enviar E-mail** direciona o usuário para o [[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:ensino:consultas:turmas:Enviar Mensagem Turma]]. O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01** - O usuário deverá informar um parâmetro para realizar a busca. * **RN02** - Adicionar Reserva * **RN02.1** - permitido somente usuários da PROGRAD ou do DAE; * **RN02.2** - o total de reservas não pode ser superior à capacidade da turma; * **RN02.3** - não é permitido cadastrar duas reservas para a mesma matriz. * **RN03** - Alterar: altera os dados da turma * **RN03.1** - Não é possível alterar turmas que não estão abertas. Caso seja usuário da PROGRAD ou do DAE, permitir emitindo um aviso que a turma não está aberta; * **RN03.2** - Não é permitido alterar uma turma de um nível de ensino ao qual o usuário não tem permissão. Por exemplo, o DAE só pode alterar turmas de graduação; * **RN04** - Cadastrar Notícia * **RN04.1** - Caso seja o usuário seja coordenador de curso, ele terá permissão de cadastrar notícias apenas para as turmas criadas para o curso o qual coordena; * **RN05** - Diário de turma: disponível apenas para coordenadores de curso (graduação ou stricto sensu), secretaria de pós-graduação, Pro Reitoria de Pós-Graduação, DAE, chefe de departamento ou gestor de curso à distância; * **RN06** - Lista de Frequência: disponível para coordenador de curso stricto sensu, secretários de pós-graduação, Pro Reitoria de Pós-Graduação, ou usuários do DAE; * **RN07** - Fechar Turma: somente usuários da PROGRAD ou do DAE poderão realizar esta operação; * **RN07.1** - A turma não deve possuir nenhum aluno matriculado. * **RN07.2** - A turma não deve possuir nenhum aluno com solicitação de matrícula. * **RN08** - Listar Alunos: disponível para usuários da PROGRAD ou DAE; chefes e secretários de departamento, desde que a turma seja do departamento; coordenadores ou secretários de curso de stricto sensu, desde que a turma seja do programa; gestor técnico; docente; ou secretário de curso de graduação; * **RN09** - Notas dos alunos: disponível para gestores do Ensino à Distância, tutores de Ensino à Distância ou coordenadores e secretários de curso de lato sensu; * **RN10** - Notas dos tutores: disponível para usuários com permissão de gestão de ensino à distância; * **RN11** - Processamento da Matrícula: disponível apenas para turmas de graduação e se a matrícula estiver processada; * **RN12** - Processamento da Rematrícula: disponível apenas para turmas de graduação e se a matrícula estiver processada; * **RN13** - Reabrir Turma: permitido apenas para PROGRAD; DAE; ou Gestor de Curso Lato Sensu * **RN13.1** - A turma deve estar consolidada para ser reaberta. * **RN14** - Remover: disponível ao chefe ou secretário do departamento, desde que a turma pertença ao departamento; coordenador ou secretário do curso stricto sensu, desde que a turma pertença ao programa; coordenador de curso, desde que a turma pertença ao curso; PROGRAD; DAE; ou a usuários de gestão de Cursos à distância; * **RN14.1** - Não é possível excluir a turma se possuir alunos matriculados (exceto se for DAE). * **RN15** - Visualizar Turma Virtual: disponível para todos desde que esta esteja disponível para acesso público; disponível para chefes de departamento, desde que a turma seja do departamento; PROGRAD; DAE; ou usuário gestor de curso técnico, desde que as turmas sejam da unidade do gestor, disponível para discentes que participam da turma. * **RN16** - O chefe do departamento poderá duplicar uma turma existente no período de ajuste de turmas. ==== Resoluções/Legislações Associadas ==== Não se aplica. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sigaa.dominio.Curso | sigaa.public.curso | | br.ufrn.sigaa.dominio.ModalidadeEducacao | sigaa.comum.modalidade_educacao | | br.ufrn.sigaa.ead.dominio.Polo | sigaa.ead.polo | | br.ufrn.sigaa.dominio.Unidade | sigaa.comum.unidade | | br.ufrn.sigaa.ensino.dominio.DocenteTurma | sigaa.ensino.docente_turma | | br.ufrn.sigaa.ensino.dominio.Turma | sigaa.ensino.turma | | br.ufrn.sigaa.pessoa.dominio.Pessoa | sigaa.comum.pessoa | | br.ufrn.sigaa.ensino.dominio.MatriculaComponente | sigaa.ensino.matricula_componente | ===== Plano de Teste ===== Sistema: SIGAA Módulo: Graduação Link(s): Consultas -> Consultas Gerais -> Turmas Usuário: adelardo, vanessa Papel que usuário deve ter: SigaaPapeis.DAE ===== Cenários de Teste ===== Será Necessário cadastrar uma turma em um componente curricular vinculado a uma unidade de coordenação de curso, para aplicar os testes de exibição das turmas. Cadastre uma turma em ([[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:turmas:criar_turma | Criar Turma]]) para uma componente do tipo atividade, com a Forma de Participação: ATIVIDADE ESPECIAL COLETIVA, e o parâmetro: "Aceita Criar Turma: Sim". Após realizar a criação da turma verificar se a turma é listada quando utiliza-se o filtro **Unidade** e selecionando a Coordenação de Curso da turma criada. ===== Dados para o Teste ===== A seguir uma consulta para listar os componentes curriculares vinculados a coordenações de curso. <code> select u.nome, ccd.nome, cc.codigo, t.descricao as "Tipo de Componente", ta.descricao as "Tipo de Atividade", forma.descricao as "Forma de Participação" from ensino.componente_curricular cc inner join comum.unidade u using(id_unidade) inner join ensino.componente_curricular_detalhes ccd ON ccd.id_componente_detalhes = cc.id_detalhe and ccd.id_componente = cc.id_disciplina inner join ensino.tipo_componente_curricular t ON t.id_tipo_disciplina = cc.id_tipo_componente inner join ensino.tipo_atividade ta ON cc.id_tipo_atividade = ta.id_tipo_atividade inner join ensino.forma_participacao_atividade forma ON forma.id_forma_participacao = cc.id_forma_participacao where u.tipo_academica = 6 </code>