~~ODT~~

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

====== Cancelar Encaminhamento ======

Este caso de uso possibilita o cancelamento dos encaminhados de memorandos feitos pelo usuário.

Todos os usuários ativos da instituição possuem acesso a esta funcionalidade.

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

O caso de uso é acessado através do caminho: //SIPAC -> Protocolo -> Memorandos -> Movimentação -> Cancelar Encaminhamento//.

=== Passo 1 ===

O caso de uso inicia exibindo uma lista com dos [[encaminhar_memorando|encaminhamentos]] realizados pelo usuário. São exibidas as seguintes informações sobre os encaminhamentos: 
  * **__Memorandos__**: Tipo - NUMÉRICO e TEXTO, Formato - 999999999/AAAA - SIGLA UNIDADE DE ORIGEM.
  * **__Encaminhado Em__**: Tipo - DATA, Formato - DD/MM/AAAA.
  * **__Destinatário__**: Tipo: TEXTO.
  * **__Nível de Acesso__**: Tipo: TEXTO, podendo ser: 
    * RESPONSÁVEIS PELA UNIDADE;
    * RESPONSÁVEIS E SECRETARIA DA UNIDADE;
    * TODOS SERVIDORES DA UNIDADE;
    * TODOS FUNCIONÁRIOS DA UNIDADE.
  
Para cada encaminhamento existem as seguintes opções:  

  * //[[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:memorandos:consultas:visualizar_memorando | Visualizar Memorando]]// 
    * Ao ser selecionada, essa opção permite a leitura do memorencaminhamento pelo usuário. Na exibição do memorando, são mostrados o cargo ou a atividade dos servidores autenticadores e dos servidores destinatários. O cargo ou a atividade exibida é referente à data de criação ou autenticação do memorando.
  * //[[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:memorandos:consultas:memorando_detalhado | Memorando Detalhado]]// 
    * Ao ser selecionada, são disponibilizadas informações detalhadas acerca desse documento. 
  * //Cancelar Encaminhamento//: segue passo 2.

=== Passo 2 ===

Nesse passo temos as informações do memorando encaminhado, os dados do encaminhamento a ser cancelado e um espaço para o usuário inserir os motivos do cancelamento:
   * **__Tipo__**: Tipo - TEXTO, Formato - MEMORANDO ELETRÔNICO | MEMORANDO CIRCULAR.
   * **__Número__**: Tipo - NUMÉRICO, Formato - 9999/AAAA.
   * **__Origem__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE).
   * **__Assunto__**: Tipo - TEXTO.
   * **__Destino__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE) | NOME SERVIDOR (MATRICULA SIAPE).
   * **__CC__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE) | NOME SERVIDOR (MATRICULA SIAPE).
   * **__Situação Atual__**: Tipo - TEXTO, Formato - DESCRIÇÃO DA SITUAÇÃO.
   * **__Dados do Encaminhamento__**:
     * **__Origem__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE).
     * **__Encaminhado Em__**: Tipo - DATA, Formato - DD/MM/AAAA.
     * **__Destino__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE) | NOME SERVIDOR (MATRICULA SIAPE).
     * **__Nível de Acesso__**: Tipo: TEXTO, podendo ser: 
       * RESPONSÁVEIS PELA UNIDADE;
       * RESPONSÁVEIS E SECRETARIA DA UNIDADE;
       * TODOS SERVIDORES DA UNIDADE;
       * TODOS FUNCIONÁRIOS DA UNIDADE.
   * **__Dados do Cancelamento__**:
     * **Observação**: Tipo - TEXTO.

Fim do caso de uso.

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

  * **RN01** - Apenas os encaminhamentos do usuários são mostrados nesse caso de uso.
  * **RN02** - Para encaminhamentos antigos, ou seja, quando o encaminhamento era feito criando uma nova movimentação no memorando, o cancelamento do encaminhamento implica no cancelamento desse movimento. O memorando volta a aparecer na unidade do movimento anterior ao encaminhamento cancelado. 
  * **RN03** - Para os novos encaminhamentos, ou seja, quando um cópia do memorando é gerada para a movimentação, não afetando, assim, o memorando original, o cancelamento do encaminhamento implica no cancelamento da cópia. A cópia é descartada do sistema e não será mais possível a sua consulta.
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sipac.protocolo.dominio.LeituraDocumento | administrativo.protocolo.leitura_documento |
| br.ufrn.sipac.protocolo.dominio.Documento | administrativo.protocolo.documento |
| br.ufrn.sipac.protocolo.dominio.TipoDocumentoProtocolo | administrativo.protocolo.tipoDocumento |
| br.ufrn.sipac.protocolo.dominio.AutenticadorDocumento | administrativo.protocolo.autenticador_documento |


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

Sistema: SIPAC

Módulo: Protocolo

Link(s): Memorandos -> Movimentação -> Cancelar Encaminhamento

Usuário: marcilia, jbb, paulinho.

Papel que usuário deve ter: Sem checagem de papéis. Qualquer usuário com acesso ao módulo Protocolo pode acessar este caso de uso.


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

  * Verificar o cancelamento de encaminhamento antigos e novos.

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

Não se aplica.