✎ desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:relatorios:processos_tecnicos:areas_do_cnpq:crescimento_por_area_cnpq [WIKI

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.
~~ODT~~

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

====== Crescimento por Área CNPq ======

Este relatório lista o crescimento do acervo. Para cada coleção, os totais de títulos, materiais físicos (exemplares e fascículos) e materiais digitais, separados por [[desenvolvimento:especificacoes:sigaa:biblioteca:negocio#áreas_do_cnpq|Área do CNPq]], em um determinado período.

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

O caso de uso se inicia quando o usuário acessa //SIGAA -> Menu Biblioteca -> Relatórios -> Processos Técnicos -> Áreas do CNPQ -> Crescimento por Área CNPq //.

Para gerar o relatório, utilizam-se os seguintes filtros:
  * ** Biblioteca **: O usuário deve escolher uma ou mais bibliotecas. Somente materiais dessas bibliotecas serão levados em conta no relatório.
  * ** Coleções **: //Todas// ou um dos tipos de coleções disponíveis no sistema. Tipo - SELEÇÃO MÚLTIPLA.
  * ** Tipos de Material **: //Todos// ou um dos tipos disponíveis (Livro, CD-ROM, Mapa, etc.). Tipo - SELEÇÃO MÚLTIPLA.
  * ** Situações do Material **: //Todas// ou uma das situações dos materiais no acervo (disponível, emprestado, fora de empréstimo).  Tipo - SELEÇÃO MÚLTIPLA.
  * ** Formas de Documento **: //Todas// ou uma das possíveis Formas de Documento dos Materiais.  Tipo - SELEÇÃO MÚLTIPLA.
  * ** Período ***: A data de cadastro do material no acervo. Formato - DD/MM/AAAA, Tipo - DATA.
  * ** Materiais Mostrados **: Indica que materiais são mostrados: //Exemplares// ou //Fascículos//. Tipo - SELEÇÃO SIMPLES RADIO.
  * **Mostrar a quantidade anterior** : Mostra a quantidade anterior existente no acervo somado com a quantidade que foi adicionada no período informado. Tipo - Booleano
  * ** 1º Agrupamento ** - Indica qual será o primeiro agrupamento utilizado. O usuário pode escolher uma dentre as opções //Coleção//, //Tipo de Material//, //Situação de Material//, //Biblioteca//.  Tipo - SELEÇÃO SIMPLES.
  * **Nível de detalhe**: Se vai ser gerado o relatório básico que agrupa por tipo de material e coleção e não mostra a quantidade anterior existente ou o relatório detalhado, que agrupa por ano, mês, um agrupamento escolhido pelo usuário e pode mostrar a quantidade anterior existente no acervo se o usuário escolhoer. Tipo - SELEÇÃO SIMPLES RADIO //(adicionado em 18/06/2012 #87562  Relatório de Crescimento por Área do CNPq ) //
\\
\\
**São realizadas duas consultas, uma que mostra a quantidade de crescimento de Títulos //(utilizando a data de cadastros do Título no acervo)// e outra que mostra separadamente o crescimento de materiais// (utilizando a data de cadastros do Material no acervo)//  no período solicitado. **
\\
\\
\\
O relatório **básico** é agrupado por tipo de material e coleção.
\\
\\
Modelo do relatório:

|      Crescimento de Títulos      |||
^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
|        3344            |      234             | 3578    |

\\
\\
\\

|     Crescimento de Títulos Agrupado      ||||
^ Área CNPq 1 ^^^^ 
^                   ^     Coleção 1   ^    Coleção N   ^  Total  ^
| Tipo de Material 1 |        3344            |      234             | 3578    |
| Tipo de Material N |        10            |      100             | 110    |
^  Total             ^         3354         ^       334           ^  3688   ^ 
^ Área CNPq N ^^^^ 
^                   ^     Coleção 1   ^    Coleção N   ^  Total  ^
| Tipo de Material 1 |        10            |      20             | 30    |
| Tipo de Material N |        40            |      50             | 60    |
^  Total             ^         50         ^       70          ^  90   ^ 
\\
\\
\\
|      Crescimento de Materiais     ||||
^ Área CNPq 1 ^^^^ 
^                   ^     Coleção 1   ^    Coleção N   ^  Total  ^
| Tipo de Material 1 |        33440      |      2340      | 35780    |
| Tipo de Material N |        100        |      1000      | 1100     |
^  Total             ^        33540      ^     3340       ^  36880   ^ 
^ Área CNPq N ^^^^ 
^                   ^     Coleção 1   ^    Coleção N   ^  Total  ^
| Tipo de Material 1 |        100      |      200     |  300    |
| Tipo de Material N |        400      |      500     |  600    |
^  Total             ^        500      ^      700     ^  900    ^ 
\\
\\
\\
O relatório **detalhado** é agrupado por meses e  por ano.
\\
\\

Modelo do relatório:

|     Crescimento de Títulos     |||
^     Ano 1              ^^^ 
|     Mês 1              ||| 
^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
|        1            |      1             | 2    |
|     Mês N              ||| 
^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
|        1           |      1             | 2    |
^     Total por ano:   4            ^^^  
^     Ano N              ^^^ 
|     Mês 1              ||| 
^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
|        2           |      3             | 5   |
^     Total por ano:   5            ^^^  
\\
\\
\\
|     Crescimento de Títulos Agrupados     ||||
^     Ano 1              ^^^^ 
|     Mês 1              ||||
^               ^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
| Agrupamento 1 |        1            |      1             | 2    |
|     Mês N              ||||
^               ^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
| Agrupamento 1 |        1           |      1             | 2    |
| Agrupamento 2 |        3           |      3             | 6    | 
^     Total por ano:   10            ^^^^  
^     Ano N              ^^^^ 
|     Mês 1              |||| 
^               ^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
| Agrupamento 1 |        2           |      3             | 5   |
^     Total por ano:   5            ^^^^  
\\
\\
\\
|     Crescimento de Materiais     ||||
^     Ano 1              ^^^^ 
|     Mês 1              ||||
^               ^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
| Agrupamento 1 |        10            |      10             | 20    |
|     Mês N              ||||
^               ^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
| Agrupamento 1 |        10           |      10             | 20    |
| Agrupamento 2 |        30           |      30             | 60    | 
^     Total por ano:   100            ^^^^  
^     Ano N              ^^^^ 
|     Mês 1              |||| 
^               ^     Área CNPq 1    ^    Área CNPq N   ^  Total  ^
| Agrupamento 1 |        20           |      30             | 50   |
^     Total por ano:   50            ^^^^ 
\\
\\
\\

Ao final também é apresentado um gráfico mostrando a variação de crescimento do material em relação ao período informado.

**Crescimento Absoluto:**

{{:desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:relatorios:processos_tecnicos:classificacao_cdu_black:grafico_crescimento_geral.png?800|Gráfico do Crescimento Absoluto}}

**Crescimento Relativo à quantidade anterior existente no acervo:**

{{:desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:relatorios:processos_tecnicos:classificacao_cdu_black:grafico_crescimento.png?800| Gráfico do Crescimento Relativo }}

O caso de uso é finalizado.

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

  * **RN01** - Os títulos e materiais informacionais que aparecerem na contagem devem estar ativos no acervo. Materiais ativos são aqueles que não foram removidos e nem estão na [[desenvolvimento:especificacoes:sigaa:biblioteca:negocio#formatos_de_materiais|Situação de baixa]].
  * **RN02** -  Somente as coleções, tipos de materias, situações de materiais e bibliotecas que sofreram crescimento são exibidas.


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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.biblioteca.processos_tecnicos.dominio.TituloCatalografico | sigaa.biblioteca.titulo_catalografico |
| br.ufrn.sigaa.biblioteca.processos_tecnicos.dominio.MaterialInformacional | sigaa.biblioteca.material_informacional |
| br.ufrn.sigaa.biblioteca.processos_tecnicos.dominio.Exemplar | sigaa.biblioteca.exemplar |
| br.ufrn.sigaa.biblioteca.processos_tecnicos.dominio.Fasciculo | sigaa.biblioteca.fasciculo |
| br.ufrn.sigaa.biblioteca.processos_tecnicos.dominio.Assinatura | sigaa.biblioteca.assinatura |
| br.ufrn.sigaa.dominio.AreaConhecimentoCnpq | sigaa.area_conhecimento_cnpq |
| br.ufrn.sigaa.biblioteca.circulacao.dominio.Colecao | sigaa.biblioteca.colecao |
| br.ufrn.sigaa.biblioteca.circulacao.dominio.TipoMaterial | sigaa.biblioteca.tipo_material_informacional |
| br.ufrn.sigaa.biblioteca.circulacao.dominio.SituacaoMaterialInformacional | sigaa.biblioteca.situacao_material_informacional |
| br.ufrn.sigaa.biblioteca.dominio.Biblioteca | sigaa.biblioteca.biblioteca |

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

Sistema: Sigaa

Módulo: Biblioteca

Link: Sigaa -> Biblioteca -> Relatórios -> Processos Técnicos -> Áreas do CNPq -> Crescimento por Área CNPq 

Usuários: sleite, clediane, margareth

Papel: SigaaPapeis.BIBLIOTECA_SETOR_CONTOLE_ESTATISTICO

===== Cenários de Teste =====
  * Gerar o relatório com todas as combinações possíveis de filtro e verificar se os resultados são condizentes. Verificar se o somatório apresentado está correto.
  * Baixar e desfazer baixas de materiais utilizando os casos de uso em //Processos Técnicos -> Gerenciamento de Materiais -> Exemplares// e //Processos Técnicos -> Gerenciamento de Materiais -> Fascículos//.
  * Alterar materiais e verificar se o relatório reflete as alterações.
  * Verificar se as totalizações estão corretas.
  * Gerar relatório para bibliotecas e conjuntos de bibliotecas.
  * Verifica se o total de relatório detalhado bate com o total do básico.

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

Para verificar as variações nos dados, baixar e desfazer baixas de materiais utilizando os casos de uso em //Processos Técnicos -> Gerenciamento de Materiais -> Exemplares// e //Processos Técnicos -> Gerenciamento de Materiais -> Fascículos//.

Para obter a quantidade de materiais e títulos por classe cdu, devem-se buscar os títulos e agrupá-los pela sua classe principal cdu. Após isso, buscam-se todos os materiais que são desses títulos, que não possuem situacao de baixa e são da biblioteca especificada, agrupados por coleção, como no sql abaixo. 

<code sql>

--- para pegar o id da biblioteca
select id_biblioteca, descricao from biblioteca.biblioteca  where id_unidade is not null order by descricao

---
---  Quantidade total de titulos adicionados no período
---
SELECT count(DISTINCT titulo.id_titulo_catalografico) 
FROM biblioteca.titulo_catalografico  titulo
WHERE titulo.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
 
 
---
---  Quantidade total de titulos adicionados no período pela primeira classificação cadastrada
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_1, count(DISTINCT titulo.id_titulo_catalografico) 
FROM biblioteca.titulo_catalografico  titulo
WHERE titulo.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_1
 
 
 
---
---  Quantidade total de titulos adicionados no período pela segunda classificação cadastrada
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_2, count(DISTINCT titulo.id_titulo_catalografico) 
FROM biblioteca.titulo_catalografico  titulo
WHERE titulo.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_2

---
---  Quantidade total de titulos adicionados no período pela terceira classificação cadastrada
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_3, count(DISTINCT titulo.id_titulo_catalografico) 
FROM biblioteca.titulo_catalografico  titulo
WHERE titulo.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_3 
 
---
---  Quantidade total de exemplares adicionados no período para uma biblioteca
---
SELECT count(DISTINCT e.id_exemplar)  
FROM biblioteca.exemplar e
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = e.id_exemplar
WHERE m.ativo = true
AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399 
 

 
---
---  Quantidade total de fascículos adicionados no período
---
SELECT count(DISTINCT f.id_fasciculo)  
FROM biblioteca.fasciculo f
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = f.id_fasciculo
WHERE m.ativo = true
AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399
 
---
---  Quantidade total de exemplares adicionados no período por classificao 1
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_1, count(DISTINCT e.id_exemplar)  
FROM biblioteca.exemplar e
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = e.id_exemplar
INNER JOIN biblioteca.titulo_catalografico  titulo ON titulo.id_titulo_catalografico = e.id_titulo_catalografico
WHERE m.ativo = true
AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_1


---
---  Quantidade total de exemplares adicionados no período por classificao 2
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_2, count(DISTINCT e.id_exemplar)  
FROM biblioteca.exemplar e
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = e.id_exemplar
INNER JOIN biblioteca.titulo_catalografico  titulo ON titulo.id_titulo_catalografico = e.id_titulo_catalografico
WHERE m.ativo = true
AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_2

---
---  Quantidade total de exemplares adicionados no período por classificao 3
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_3, count(DISTINCT e.id_exemplar)  
FROM biblioteca.exemplar e
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = e.id_exemplar
INNER JOIN biblioteca.titulo_catalografico  titulo ON titulo.id_titulo_catalografico = e.id_titulo_catalografico
WHERE m.ativo = true
AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_3
 
 
---
---  Quantidade total de fascículos adicionados no período por classsificação 1
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_1, count(DISTINCT f.id_fasciculo)  
FROM biblioteca.fasciculo f
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = f.id_fasciculo
INNER JOIN biblioteca.assinatura  a ON a.id_assinatura = f.id_assinatura
INNER JOIN biblioteca.titulo_catalografico  titulo ON titulo.id_titulo_catalografico = a.id_titulo_catalografico
WHERE m.ativo = true AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_1
 
---
---  Quantidade total de fascículos adicionados no período por classsificação 2
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_2, count(DISTINCT f.id_fasciculo)  
FROM biblioteca.fasciculo f
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = f.id_fasciculo
INNER JOIN biblioteca.assinatura  a ON a.id_assinatura = f.id_assinatura
INNER JOIN biblioteca.titulo_catalografico  titulo ON titulo.id_titulo_catalografico = a.id_titulo_catalografico
WHERE m.ativo = true AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_2



---
---  Quantidade total de fascículos adicionados no período por classsificação 3
---
SELECT titulo.id_area_conhecimento_cnpq_classificacao_3, count(DISTINCT f.id_fasciculo)  
FROM biblioteca.fasciculo f
INNER JOIN biblioteca.material_informacional m ON m.id_material_informacional = f.id_fasciculo
INNER JOIN biblioteca.assinatura  a ON a.id_assinatura = f.id_assinatura
INNER JOIN biblioteca.titulo_catalografico  titulo ON titulo.id_titulo_catalografico = a.id_titulo_catalografico
WHERE m.ativo = true AND m.data_criacao BETWEEN '01/01/2010 00:00:00.000' AND '01/01/2011 23:59:59.999'
AND m.id_biblioteca = 661399
GROUP BY titulo.id_area_conhecimento_cnpq_classificacao_3
  
</code>

</ifauth>