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

====== Consultas Locais por Ano ======

Esse caso de uso tem como finalidade gerar um relatório que informe ao setor estatístico da biblioteca a quantidade de material consultado por classe CDU ou Black durante todos os meses de um determinado ano. Um material consultado é todo aquele que o usuário retira da estante, realiza as consultas desejadas e deixa em cima da mesa, para que posteriormente um funcionário da biblioteca em questão insira no sistema todos os materiais consultados no período.
===== Descrição do Caso de Uso =====

Este caso de uso se inicia quando o usuário acessa a opção: //SIGAA -> Biblioteca -> Relatórios -> Circulação -> Consultas CDU por Ano//.

Para gerar o relatório, utilizam-se os filtros 

  * **Bibliotecas***: Tipo - TEXTO. Pode-se escolher determinada biblioteca ou selecionar várias delas.
  * **Ano**: Tipo - NUMÉRICO.
  * **Classificação**: Tipo - TEXTO. Opções - ''CDU'' ou ''BLACK''
  
Modelo do relatório:

^ Mês \ Classe ^  0 ^  1 ^ 2 ^ ... ^  9 ^ Total ^
^ Janeiro      | 10 |  2 |   | ... |  3 |   43 |
^ Fevereiro    | 34 | 72 | 3 | ... |  7 |  154 |
^ ...          | .. | .. |   | ... | .. |  ... |
^ Total        | 50 | 90 | 7 | ... | 80 |  307 |


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

Não se aplica.


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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.biblioteca.informacao_referencia.dominio.ClasseMaterialConsultado | sigaa.biblioteca.classe_material_consultado |
| br.ufrn.sigaa.biblioteca.informacao_referencia.dominio.MovimentDiarioConsultaMateriais | sigaa.biblioteca.movimento_diario_consulta_materiais |

Obs.: Nada é persistido. Apenas um relatório é gerado. 

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

Sistema: Sigaa

Módulo: Biblioteca

Link: Relatórios -> Circulação -> Consultas CDU por Ano

Papel: SigaaPapeis.BIBLIOTECA_SETOR_CONTOLE_ESTATISTICO

Usuários: margareth, sleite, clediane

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

  * Gerar relatório para classificação CDU e para Black.
  * Gerar relatório para várias combinações de Bibliotecas e de Anos.

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

  * Utilizar os seguintes casos de uso e verificar se houve a devida mudança nos resultados deste relatório:
    * [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:consultas_locais:cadastrar_consultas_locais|Cadastrar Consultas Locais]]
    * [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:consultas_locais:cadastrar_consultas_locais_usando_leitor_otico|Cadastrar Consultas Locais Usando Leitor Ótico]]
  * Verificar se as totalizações batem com o [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:relatorios:circulacao:consultas_locais_por_turno|Relatório de Consultas Locais por Turno]] quando os mesmos filtros são escolhidos nos dois relatórios.

</ifauth>