~~ODT~~

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


====== Relatório de Mão de Obra Contratada ======

Este caso de uso é utilizado pelos gestores de organizacionais com a finalidade de criação de um relatório do quadro geral da mão de obra contratada.

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

O caso de uso é acionado quando o usuário acessa a opção: SIGRH -> Chefia de Unidade -> Dimensionamento -> Relatórios -> Mão de Obra Contratada. Os seguintes filtros são exibidos na busca:

   * **Unidade**: Formato - Nome da Unidade (Código da Unidade), Tipo - TEXTO;
   * **Vigência do Contrato**: Formato - DD/MM/AAAA, Tipo - DATA.

O relatório gerado possui as seguintes informações:
   * **__Número/Ano__**: Tipo - Numérico, Formato - 999/AAAA
   * **__Vigência do Contrato__**: Tipo - DATA, Formato - DD/MM/AAAA a DD/MM/AAAA
   * **__Objeto__**: Tipo - Texto
   * **__Unidade__**: Tipo - Texto, Nome da Unidade (Código)
   * **__Quant.__**: Tipo - Numérico. Indica a quantidade registrada inicialmente no cadastro do contrato.
   * **__Quant. Adicionado__**: Tipo - Numérico. Indica a quantidade adicionada após o cadastro do contrato.
   * **__Quant. Reduzido__**: Tipo - Numérico. Indica a quantidade reduzida após o cadastro do contrato.
   * **__Total__**: Tipo - Numérico. Representa o total atual de mão de obra que existe no projeto.

O relatório é composto para impressão conforme o seguinte modelo:

^Unidade ^Quant. ^Quant.Adicionado ^Quant.Reduzido ^Total^
||||||
|Número/Ano: 999/2011|||||
|Vigência do Contrato: 88/88/8888 a 99/99/9999|||||
|Objeto: Descrição|||||
|UNIDADE (90.90)|2|3|4|5|
|UNIDADE (80.80)|1|4|3|2|
|UNIDADE (70.80)|8|2|3|6|

O caso de uso é finalizado.

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

  * **RN01** - Quando o usuário logado possuir papel com exigência de vinculação a uma unidade, todas as operações somente podem ser realizadas para servidores lotados na unidade que foi vinculada ao papel. Caso contrário, as operações podem ser realizadas para servidores lotados em qualquer unidade.

  * **RN02** - Se for gestor organizacional, pode consultar de qualquer unidade de lotação. Se for chefe ou vice de unidade, o combo deve vir apenas com as unidades da responsabilidade do servidor.
<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.Contrato             | administrativo.contratos.contrato              |
| br.ufrn.sipac.contratos.dominio.AdicionalContratacao | administrativo.contratos.adicional_contratacao |
| br.ufrn.sipac.contratos.dominio.MaoDeObraContratada  | administrativo.contratos.mao_obra_contratada   |




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

Sistema: SIGRH

Módulo: Dimensionamento

Link(s): Operações -> Relatórios -> Mão de Obra Contratada

Usuário: alc

Papel que usuário deve ter: SipacPapeis.GESTOR_ORGANIZACIONAL, SigrhPapeis.GESTOR_UNIDADE, SigrhPapeis.VICE_GESTOR_UNIDADE

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

--RNS--

A regra de negócio ([[#Principais Regras de Negócio|RN01]]) pode ser validada da seguinte forma: [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cenarios_de_testes_comuns#ct01|CT01]]

A regra de negócio ([[#Principais Regras de Negócio|RN02]])pode ser validada seguindo os seguintes passos:

1º No SigAdmin -> Gestão de Unidades -> Responsáveis Por Unidade -> Cadatrar/Alterar(com login "gleydson"), cadastrar um "Chefes" e um "Vice chefes" para uma unidade (Apenas unidades com servidores Lotados - vide select em dados para teste);

*Importante focar que os servidores que serão cadastrados no passo 1º, deverão ter também o papel "SigrhPapeis.EMITE_RELATORIO_CALCULOS".

2º Acessar o link do UC descrito no Plano de Teste com os usuários cadastrados no passo um e gerar o relatório (Em formato Impressão e em formato PDF).

-- Passo a passo UC --

Para realizar o teste da funcionalidade do quadro demonstrativo geral, o testador deve fornecer dados de um contrato que possua o sub-tipo LOCAÇÂO DE MÃO DE OBRA, caso o contrato o sistema deve criticar.

Se as informações sobre a mão de obra contratada ainda não foram especificadas para o contrato, não será possível prosseguir com a operação

Caminho para realização do teste: SIPAC ? Módulo Contratos ? Aba Consultas/Relatórios ? Locação de Mão de Obra ? Quadro Demonstrativo Por Unidade. 

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

É preciso fornecer um contrato com o sub-tipo LOCAÇÃO DE MÃO DE OBRA, para isso o testador pode buscar essa informação na listagem de contratos, onde há essa opção de filtro, segue abaixo o caminho para obter essa informação:

SIPAC -> Contratos -> Aba Consulta/Relatórios -> Listar Contratos

A consulta abaixo apresenta todos os contratos de mão de obra contratada já registradas no sistema.

<code sql>

select unid.nome as "Nome da Unidade", unid.codigo_unidade as "Código da Unidade", c.numero as "Número do Contrato", 

c.ano as "Ano do Contrato", c.data_inicio as "Inicio do Contrato", c.data_fim as "Fim do Contrato", c.objeto, 

sum(mao_obra.quantidade) as "quantidade", sum(mao_obra.quant_adicionada) as "quant_adicionada", 

sum(mao_obra.quant_reduzida) as "quant_reduzida", sum((mao_obra.quantidade + (mao_obra.quant_adicionada - mao_obra.quant_reduzida)) * mao_contratada.valor) as "valor_total"  

from contratos.contrato c 

inner join contratos.unidade_beneficiada unid_benef on unid_benef.id_contrato = c.id 

inner join comum.unidade unid on unid.id_unidade = unid_benef.id_unidade 

inner join contratos.mao_obra_unidade_beneficiada mao_obra on mao_obra.id_unidade_beneficiada = unid_benef.id 

inner join contratos.mao_obra_contratada mao_contratada on mao_contratada.id_mao_obra_contratada = mao_obra.id_mao_obra_contratada 

and mao_contratada.id_contrato = c.id where c.id_sub_tipo = 3

group by unid.nome, unid.codigo_unidade, c.numero, c.ano, c.denominacao, c.data_inicio, c.data_fim, c.objeto order by unid.nome 

</code>

</ifauth>