~~ODT~~

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

Este caso de uso tem por objetivo processar o arquivo importado do SIAPE contendo as informações das unidades da Instituição.\\ 
É recomendado que esta operação seja usada apenas na implantação do sistema, uma só vez, já que o layout não oferece informações completas do cadastro de unidades.

Após a importação, como algumas informações não são cadastradas ou são usados valores padrão, é necessário atualizar esses dados usando o [[desenvolvimento:especificacoes:sigadmin:casos_de_uso:portal_da_administracao:gestao_de_unidades:cadastro_de_unidades:cadastrar| Cadastro de Unidades do SIGAdmin]], assim como no caso de surgirem novas unidades ao longo do tempo.

Pré-condição: O arquivo de unidades da instituição deve ser importado por completo em sua estrutura. O não cumprimento dessa importação acarretará problemas no sistema em geral, principalmente no que se refere à lotação do servidor, como por exemplo:
  * Servidores com lotação incorreta tendo suas férias homologadas por uma chefia diferente.
  * Ao tentar homologar a frequência dos servidores em sua unidade, o servidor responsável não veria todos os servidores da mesma e veria servidores de outra lotação cuja frequência foge totalmente da responsabilidade dele.
  * O mesmo ocorre para homologação de afastamentos, 
Além disso, deverão ocorrer problemas com permissões vinculadas à alguma unidade específica e atribuições erradas de chefia de unidade.

As pessoas que utilizam esse caso de uso trabalham na área de recursos humanos.
===== Descrição do Caso de Uso =====

Este caso de uso deve ser acessado o seguinte caminho //SIGRH → Administração de Pessoal → Administração → Fita Espelho -> Arquivo Espelho SIAPE → Unidade → Processar Arquivo Unidade//.

O usuário deve informar os seguintes dados:
  * **SIAPECAD***: Tipo - NUMÉRICO. Código da Instituição no SIAPE.
  * **Arquivo de unidades***: Anexar arquivo.
  * **Arquivo de referência***: Anexar arquivo.
  * **Refazer os códigos das unidades**: Tipo - LÓGICO.


Os tipos de unidades:
   * Unidade Administrativa: Segmento da administração direta ao qual a lei orçamentária anual não consigna recursos e que depende de destaques ou provisões para executar seus programas de trabalho.
   * Unidade Orçamentária: É a repartição da Administração Federal a quem o orçamento da União consigna dotações específicas para a realização de seus programas de trabalho. 
   * Unidade Gestora: Unidade orçamentária ou administrativa investida do poder de gerir recursos orçamentários e financeiros, próprios ou sob descentralização. 
   * UORG: Unidade Organizacional. Utilizada para identificar a lotação ou o exercício do agente público.

O caso de uso é finalizado.

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

Não se aplica.

==== Resoluções/Legislações Associadas ====
   * {{:desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:administracao:fita_espelho:arquivo_espelho_siape:unidade:layout_unidade.doc|Layout do Arquivo de Unidades}}
   * Mais informações em: [[http://www.portaltransparencia.gov.br/glossario/DetalheGlossario.asp?letra=u|Glossário Unidade]]
   * [[cooperacao:tutoriais:extracao_unidade_siape|Passo a passo da extração UORGS]]

<ifauth @admin>

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

Não há classes persistentes para este caso de uso.

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

Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Administração → Fita Espelho -> Arquivo Espelho SIAPE → Unidade → Processar Arquivo Unidade

Usuário: diogoms, mirian, rodrigo

Papel que usuário deve ter: SigrhPapeis.ADMINISTRADOR_DAP

===== Cenários de Teste =====
1. Restaure o banco de dados "scratch" (apenas com dados iniciais pra implantação) do banco administrativo, sistemas_comum e sigaa.\\
2. Verifique se já existe a unidade raiz:

<code sql>
SELECT count(*) FROM comum.unidade;
</code>

3. Caso a consulta retorne um resultado, atualize os dados necessários. Para este caso de uso os principais são ''codigo_siapecad'' e ''codigo_unidade''.

<code sql>
UPDATE comum.unidade SET codigo_siapecad = 1, codigo_unidade = 1100;
</code>

O ''Código SIAPECAD'' vem no arquivo ou pode-se obtê-lo com o RH.


===== Dados para o Teste =====
Para a importação, apenas:
  - Para verificar se a importação foi bem sucedida, é preciso conhecer o organograma da instituição que está sendo importada.
  - Para ver a árvore de unidades, pode-se entrar no caso de uso Administração de pessoal -> Cadastros -> Designação.

Para a correção de códigos, apenas:
  - É necessário que a unidade que possui o código SIAPECAD informado no caso de uso já esteja no banco de dados e possua o campo "codigo_unidade" não nulo com 4 dígitos, no mínimo. Caso o valor tenha mais de 4 dígitos (sem iniciar com zeros), deve ser múltiplo de 2.
  - Após corrigido, os códigos seguem a sequência da hierarquia no formato a seguir, partindo da unidade raiz: 
<code>
 - 11.00 (raiz)
 - 11.01 (mesmo nível)
 - - 11.01.01 (primeira do segundo nível)
 - - 11.01.02 (segunda do segundo nível)
</code>
Para ver a árvore de unidades, pode-se entrar no caso de uso Administração de pessoal -> Cadastros -> Designação.

</ifauth>