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

====== Relatório de Usuários Suspensos ======

Este caso de uso, utilizados pelos bibliotecários da seção de Controle Estatístico gera um relatório contendo uma listagem dos usuários suspensos, assim como as informações referentes às suspensões.

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

O caso de uso se inicia quando o usuário acessa SIGAA → Menu Biblioteca → Relatórios → Circulação → Empréstimos → Relatório de Usuários Suspensos.

Ao iniciar o caso de uso, o sistema mostra os filtros do relatório:
  * **Bibliotecas** - A(s) biblioteca(s) que devem ser levadas em consideração.
  * **Categorias de Usuário** - O(s) tipo(s) de usuário que devem ser retornados, que podem ser ''ALUNOS_INFANTIL, ALUNO DE GRADUAÇÃO, ALUNO DE NÍVEL MÉDIO/TÉCNICO, ALUNO DE PÓS-GRADUAÇÃO, SERVIDOR TÉCNICO-ADMINISTRATIVO, DOCENTE, BIBLIOTECA DA UFRN, BIBLIOTECA EXTERNA À UFRN, USUÁRIO EXTERNO À UFRN, DOCENTE EXTERNO''
  * **Período** - O período no qual a suspensão está ativa. Utilizado se o usuário quiser visualizar somente as suspensões que duram até o ano de 2015, por exemplo.
  * **Incluir suspensões manuais**. Indica se as suspensões cadastradas manualmente (que não vieram de empréstimos atrasados) serão incluídas no relatório.

Quando o usuário requisita que o relatório seja gerado, o sistema o gera e ele tem as seguintes informações.

Para cada usuário suspenso:
  * **__Nome__** - O nome do usuário ou instituição.
  * **__CPF__** - O CPF do usuário. Não é mostrada para bibliotecas internas e externas.

Para cada suspensão originada a partir de empréstimo atrasado, são exibidos:
  * **__Código de Barras__**
  * **__Data de empréstimo__**
  * **__Prazo de entrega__**
  * **__Data de entrega__**
  * **__Período de suspensão__**
  * **__Material__** - Título e autor do material.

Se a suspensão for manual, são exibidos:
  * **__Cadastrada por__**. O bibliotecário que cadastrou a suspensão.
  * **__Período de suspensão__**
  * **__Motivo__**

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

Não se aplica.

<ifauth @admin>
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sigaa.biblioteca.circulacao.dominio.Suspensao | sigaa.biblioteca.suspensao |
| br.ufrn.sigaa.biblioteca.circulacao.dominio.Emprestimo | sigaa.biblioteca.emprestimo |

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

Sistema: SIGAA

Módulo: Biblioteca

Link(s): SIGAA -> Menu Biblioteca -> Relatórios -> Circulação -> Empréstimos -> Relatório de Usuários Suspensos

Usuário: clediane, angelike, regina

Papel que usuário deve ter: SigaaPapeis.BIBLIOTECA_SETOR_CONTROLE_ESTATISTICO

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

  * Gerar relatórios utilizando várias combinações dos vários filtros.
  * Selecionar alguns usuários e verificar se realmente estão suspensos (use [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:controle_de_emprestimos:verificar_situacao_do_usuario_emitir_declaracao_de_quitacao|Verificar Situação do Usuário]]).
  * Devolver empréstimos atrasados para gerar novas suspensões. Utilize o [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:relatorios:circulacao:emprestimos:relatorio_de_usuarios_em_atraso|Relatório de usuários em atraso]] para descobrir materiais em atraso.

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

Utilize o caso de uso de [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:controle_de_emprestimos:verificar_situacao_do_usuario_emitir_declaracao_de_quitacao|Verificar situação do usuário]] para confirmar os dados retornados pelo relatório.

</ifauth>