~~ODT~~

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

====== Definir Localização Física ======

Este caso de uso permite que o usuário defina a localização física de um processo. Definir a localização física de um processo é descrever detalhadamente onde o processo está físicamente armazenado, ou seja, é dizer exatamente qual o prédio, o andar, a sala, o corredor, a estante, a prateleira e a caixa onde o processo está guardado.

É utilizado por servidores habilitados a realizar o cadastro de processos nas suas respectivas unidades.

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

Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Portal Administrativo -> Protocolo -> Processos -> Definir Localização Física

=== Passo 1 ===

É exibido um formulário de busca de processos, podendo-se escolher um dos filtros abaixo ([[definir_localizacao_fisica#Principais Regras de Negócio|RN01]]):

   * **Processos na Unidade**: Tipo - TEXTO. É solicitado para informar qual o vínculo em que se deseja realizar a busca.
   * **Número do Processo**: Formato - 99999.999999/AAAA-99, busca pelo processo com o número informado.
   * **Código de Barras**: Formato - 99999.999999/AAAA-99. Tipo - NUMÉRICO. 
   * **Assunto Detalhado**: Tipo - TEXTO, busca por processos que possuam o assunto detalhado informado.
   * **Todos os Processos na Unidade**: busca por todos os processos que estão na unidade do usuário.

Ao acessar o caso de uso já são listados todos os processos que estão na unidade do usuário. Nesta listagem, são exibidas as seguintes informações:

   * **__Processo__**: Formato - 99999.999999/AAAA-99, representa o número do processo.
   * **__Interessado(s)__**: Tipo - TEXTO, representam os interessados no processo.
   * **__Origem__**: Tipo - TEXTO, unidade de origem do processo.
   * **__Destino__**: Tipo - TEXTO, unidade de destino do processo.
   * **__Tipo do Processo__**: Tipo - TEXTO, representa o tipo do processo.
   * **__Assunto do Processo__**: Tipo - TEXTO, representa o assunto do processo.
   * **__Assunto Detalhado__**: Tipo - TEXTO, representa o assunto detalhado do processo.

É possível visualizar informações detalhadas para cada processo, acessando a opção //Processo Detalhado//.

Para definir a localização física de um processo, deve-se escolher a opção //Selecionar Processo//.


=== Passo 2 ===

São exibidos os dados gerais do processo selecionado com um campo para preencher a localização física:

   * **__Número__**: Formato - 99999.999999/AAAA-99, representa o número do processo.
   * **__Origem do Processo__**: Tipo - TEXTO, indica se a origem do processo é interna ou externa.
   * Se a origem do processo for externa são exibidas as informações:
       * **__Número Original do Processo__**: Tipo - TEXTO.
       * **__Órgão de Origem__**: Tipo - TEXTO.
       * **__Data de Autuação Original__**: Formato: DD/MM/AAAA, Tipo - DATA.
   * Se a origem do processo for interna são exibidas as informações:
       * **__Data de Autuação__**: Formato: DD/MM/AAAA HH:MM, Tipo - DATA, data e hora da autuação do processo.
       * **__Usuário de Autuação__**: Tipo - TEXTO, usuário responsável pela autuação do processo.
   * **__Tipo do Processo__**: Tipo - TEXTO.
   * **__Assunto do Processo__**: Tipo - TEXTO.
   * **__Assunto Detalhado__**: Tipo - TEXTO.
   * **__Natureza do Processo__**: Tipo - TEXTO.
   * **__Unidade de Origem__**: Tipo - TEXTO.
   * **__Status__**: Tipo - TEXTO.
   * **__Data de Cadastro__**: Formato: DD/MM/AAAA, Tipo - DATA.
   * **__Observação__**: Tipo - TEXTO.
   * **Localização Física**: Tipo - TEXTO, representa a localização física do processo.

Por fim, deve-se escolher a opção //Confirmar//.

O caso de uso é finalizado.


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

   * **RN01** - Apenas os usuários que apresentam a permissão de cadastro de processo na unidade na qual está logado no sistema pode acessar o caso de uso. Ou seja, além de ter o papel de cadastro de processo, o usuário deve ter permissão desse papel para a unidade que está acessando o sistema.
   * **RN02** - O link do caso de uso é exibido apenas quando o parâmetro ''PROTOCOLO_ELETRONICO_ATIVO'' for falso.

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.protocolo.dominio.Processo | administrativo.protocolo.processo |
| br.ufrn.sipac.protocolo.dominio.Movimento | administrativo.protocolo.movimento |

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

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): SIPAC -> Portal -> Administrativo Protocolo -> Processos -> Definir Localização Física

Usuário: elizabete, fabiobarreto

Papel que o usuário deve ter: ProtocoloPapeis.CADASTRAR_PROTOCOLO

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

Verificar se, após definir a localização física de um processo, a informação é persistida no banco.

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

Para verificar se a localização física foi persistida no banco, pode-se executar o comando SQL abaixo, substituindo adequadamente os valores referentes ao número do processo.

<code SQL>
-- Consulta que retorna algumas informações do processo de número 23077.35551/2008-61.
SELECT
	p.radical, p.num_protocolo, p.ano, p.dv, p.assunto, m.localizacao_fisica
FROM
	protocolo.movimento m
	JOIN protocolo.processo p ON (p.id_movimento_atual = m.id_movimento)
WHERE
	p.radical = 23077 -- Radical do processo.
	AND p.num_protocolo = 35551 -- Número do protocolo.
	AND p.ano = 2008 -- Ano do processo.
	AND p.dv = 61; -- Dígito verificador.
</code>