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



====== Modificar Requisição (Passagem) ======

Através deste caso de uso é possível modificar as requisições de passagem gravadas em [[cadastrar_requisicao|Cadastrar Requisição]].

O caso de uso é acessado por usuários que possuem papel de requisitor de passagem.


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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Requisições -> Diárias/Passagem -> Passagem -> Modificar Requisição//.

Ao acessar o caso de uso são listadas as requisições que o usuário tem acesso ([[#principais_regras_de_negócio|RN01]]) ([[#principais_regras_de_negócio|RN03]]).

  * **__Requisição__**: Formato - NÚMERO/ANO, Tipo - TEXTO.
  * **__Proposto__**: Formato - NOME DO PROPOSTO, Tipo - TEXTO.
  * **__Trechos__**: Formato - DESCRIÇÃO DOS TRECHOS (ORIGEM - DESTINO), Tipo - TEXTO.
  * **__Valor__**: Formato - R$ 9.999,99, Tipo - NUMÉRICO.

Para cada requisição é possível realizar as seguintes operações ([[#principais_regras_de_negócio|RN02]]):

=== Enviar Requisição ===

==Passo 1==

São mostradas as informações gerais da requisição:

  * **__Tipo da Requisição__**: Formato - NOME DO TIPO DA REQUISIÇÃO, Tipo - TEXTO.
  * **__Requisição__**: Formato - NÚMERO/ANO, Tipo - TEXTO.
  * **__Unidade de Custo__**: Formato - CÓDIGO - NOME DA UNIDADE (SIGLA), Tipo - TEXTO.
  * **__Unidade de Requisitante__**: Formato - CÓDIGO - NOME DA UNIDADE (SIGLA), Tipo - TEXTO.
  * **__Usuário__**: Formato - LOGIN - NOME COMPLETO (Ramal: NÚMERO DO RAMAL), Tipo - TEXTO.
  * **__Data__**: Formato - DD/MM/AAAA HH:MM, Tipo - DATA.
  * **__Observações__**: Formato - LIVRE, Tipo - TEXTO.
  * **__Opção Orçamentária__**: Formato - LIVRE, Tipo - TEXTO.
  * **__Status__**: Formato - STATUS DA REQUISIÇÃO, Tipo - TEXTO.
  * **__Valor da Requisição__**: Formato - R$ 9.999,99, Tipo - NUMÉRICO.

Informações do proponente:

  * **__Nome__**: Formato - NOME DO PROPOSTO, Tipo - TEXTO.
  * **__Atividade__**: Formato - NOME DA ATIVIDADE, Tipo - TEXTO.
  * **__Matrícula__**: Formato - 9999999, Tipo - NUMÉRICO.
  * **__Unidade__**: Formato - NOME DA UNIDADE, Tipo - TEXTO.

Informações do proposto:

  * **__Nome__**: Formato - NOME DO PROPOSTO, Tipo - TEXTO.
  * **__Tipo do Proposto__**: Formato - NOME DO TIPO DE PROPOSTO, Tipo - TEXTO.
  * **__Matrícula__**: Formato - 9999999, Tipo - NUMÉRICO.
  * **__CPF__**: Formato - 999.999.999-99, Tipo - NUMÉRICO.
  * **__Cargo/Função__**: Formato - NOME DO CARGO, Tipo - TEXTO.
  * **__Lotação__**: Formato - NOME DA UNIDADE DE LOTAÇÃO, Tipo - TEXTO.

Informações da passagem:

  * **__Descrição__**: Tipo - TEXTO.
  * **__Início do Afastamento__**: Formato - DD/MM/AAAA, Tipo - DATA.
  * **__Fim do Afastamento__**: Formato - DD/MM/AAAA, Tipo - DATA.
  * **__Tipo__**: Formato - TIPO DA PASSAGEM, Tipo - TEXTO.
  * **__Número da Reserva__**: Formato - 9999, Tipo - NUMÉRICO.
  * **__Trechos__**: Formato - DESCRIÇÃO DOS TRECHOS (ORIGEM - DESTINO), Tipo - TEXTO.

==Passo 2==

Neste passo deve-se selecionar um vínculo orçamentário para arcar com as despesas da passagem. Este fluxo está especificado em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_vinculo_orcamentario_requisicoes|Fluxo do vínculo orçamentário das requisições]].






===Alterar Requisição===

Segue o mesmo fluxo do caso de uso [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:diarias_passagem:passagem:cadastrar_requisicao|Cadastrar Requisição]].

===Remover Requisição===

Remove a requisição gravada.

O caso de uso é finalizado.


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

   * **RN01** - Não é apresentada na listagem Requisições com o status de enviada.
   * **RN02** - Só é possível alterar ou enviar uma requisição se o ano desta requisição for igual ao ano atual.
   * **RN03** - Se o usuário possuir o papel ''RESPONSAVEL_UNIDADE'', serão listadas as requisições da sua unidade. Se o usuário não possuir este papel, serão listadas somente as requisições que ele cadastrou.

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

Não se aplica.


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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.passagens.dominio.RequisicaoPassagem | administrativo.requisicoes.requisicao_passagem|


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

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): Requisições -> Diárias/Passagem -> Passagem -> Modificar Requisição

Usuário: marcilia

Papel que usuário deve ter: SipacPapeis.REQUISITOR, SipacPapeis.REQUISITOR_PASSAGEM.


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

[[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:diarias_passagem:passagem:cadastrar_requisicao|Cadastrar]] requisições de passagem e observá-las em ''Modificar Requisição''.

Verificar se as regras de negócio estão sendo respeitadas no caso de uso.


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

Para cadastrar novas requisições de passagem deve-se usar o caso de uso [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:diarias_passagem:passagem:cadastrar_requisicao|Cadastrar Requisição]].

A consulta abaixo mostra as requisições de passagem com status ''CADASTRADA'' filtradas pela unidade ou pelo usuário que cadastrou:

<code sql>
SELECT req.numero, req.ano, proposto_externo.nome AS proposto_externo, 
proposto.nome AS proposto, req.valor, un.codigo_unidade, u.login
FROM requisicoes.requisicao_passagem req
JOIN comum.unidade un ON req.id_unidade_req = un.id_unidade
LEFT JOIN comum.pessoa proposto ON proposto.id_pessoa = req.id_proposto
LEFT JOIN comum.proposto_externo proposto_externo ON proposto_externo.id_proposto_externo = req.id_proposto_externo
JOIN comum.usuario u ON u.id_usuario = req.id_usuario
WHERE req.id_status = 100
AND un.codigo_unidade = <CÓDIGO DA UNIDADE AQUI, EX.: 1132>
--AND u.login = <NOME DO USUÁRIO QUE CADASTROU AQUI, EX.: bruma>
ORDER BY req.ano DESC, req.numero DESC;
</code>