~~ODT~~

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

====== Gerar Planilha de Prestadores ======

Esta funcionalidade permite que sejam agrupadas requisições de pessoa física para a geração de uma planilha para exportação em Excel (.csv) dos prestadores contemplados nas requisições selecionadas.

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

Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Portal Administrativo -> Requisições -> Serviços -> Pessoa Física -> Gerar Planilha de Prestadores.

=== Passo 1 ===

Inicialmente, é apresentada tela para consulta de requisições, abaixo segue as //Opções de Busca//:
  * **Periodo da Solicitação**: Tipo - INTERVALO DE DATAS.     
  * **Requisição**: Tipo - NUMÉRICO.
  * **Unidade Requisitante**: Tipo - AUTOCOMPLETE.
  * **Unidade de Custo**: Tipo - AUTOCOMPLETE.

Eventos disponíveis: //Buscar//([[#principais_regras_de_negócio|RN01]])  e //Cancelar//.
    
Para realizar a combinação dos filtros acima citados, o usuário deve selecionar os filtros desejados marcando a caixa de seleção ao lado de cada filtro disponível.

=== Passo 2 ===

Ao realizar a busca, caso seja localizada alguma requisição, será exibida uma //Lista de Requisições Encontradas// contendo as seguintes informações:

  * **__Requisição__**: Tipo - TEXTO.     
  * **__Prestador__**: Tipo - TEXTO.  
  * **__Un. de Custor__**: Tipo - TEXTO.  
  * **__Status__**: Tipo - TEXTO.  
  * **__Usuário__**: Tipo - TEXTO.  
  * **__Valor Total__**: Tipo - TEXTO.  
    * Opção de //Visualizar Requisição//
    
Eventos disponíveis: //Adicionar Requisições Marcadas//([[#principais_regras_de_negócio|RN02]]).

Para realizar a adição das requisições é necessário marcar as requisições desejadas atraves da caixa de seleção localizada no início de cada registro localizado e acionar o botão //Adicionar Requisições Marcadas//.

=== Passo 3 ===

Ao realizar a adição, as requisição são exibidas na //Lista de Requisições Adicionadas // exibindo as informações abaixo:

  * **__Requisição__**: Tipo - TEXTO.     
  * **__Prestador__**: Tipo - TEXTO.  
  * **__Un. de Custor__**: Tipo - TEXTO.  
  * **__Status__**: Tipo - TEXTO.  
  * **__Usuário__**: Tipo - TEXTO.  
  * **__Valor Total__**: Tipo - TEXTO.  
    * Opção de //Visualizar Requisição//

Para realizar a remoção das requisições é necessário marcar as requisições desejadas atraves da caixa de seleção localizada no início de cada registro localizado e acionar o botão //Remover Requisições Marcadas//.

=== Passo 4 ===

Após todas a requisições adicionadas é necessário acionar o evento //Gerar Planilha//. O navagedor disponibilizará o arquivo planilhaPrestatores.cvs que pode ser importado no excel para visualização.

O caso de uso é finalizado.

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

  * **RN01** - As requisições devem possuir o status diferente de CANCELADA e ESTORNADA.
  * **RN02** - A requisição só pode ser adicionar uma unica vez para geração da planilha.

==== Resoluções/Legislações Associadas ====
Não se aplica.

===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe ^ Tabela |
|br.ufrn.sipac.cadastro.dominio.Unidade                       |administrativo.comum.unidade|
|br.ufrn.sipac.requisicoes.servico.dominio.ItemPrestador      |administrativo.requisicoes.item_prestador|
|br.ufrn.sipac.requisicoes.servico.dominio.ReqServPessoaFisica|administrativo.requisicoes.req_servico_pf|


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

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): Requisições -> Serviços -> Pessoa Física -> Gerar Planilha de Prestadores.

Usuário: dilson

Papel que usuário deve ter: SipacPapeis.REQUISITOR_SERVICO ou SipacPapeis.REQUISITOR

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

  * Verificar filtros da busca;
  * Verificar os eventos de adicionar e remover requisições;
  * Verifciar o arquivo gerado se o mesmo contém os prestadores associados as requisições adicionadas.
===== Dados para o Teste =====

  * Caso não haja requsições de pessoa fisíca cadastrada no sistema, a mesmo pode ser cadastrada em Portal Administrativo > Requisições > Serviços > Cadastrar Requisição
  * Caso existe, basta utilizar a busca da própria funcionalidade.