~~ODT~~

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

====== Sincronizar servidores via Webservices do SIAPE ======

Este caso de uso permite efetuar a sincronização dos dados dos servidores já cadastrados no sistema com os dados disponíveis no SIAPE através do WebService, que traz as mesmas informações da Fita Espelho do SIAPE, sem a necessidade de aguardar o fim do mês para efetuar a importação. 

Pré condições: os seguintes parâmetros para acesso do WebService estejam preenchidos: ''WS_SIAPE_SIGLA_SISTEMA, WS_SIAPE_NOME_SISTEMA, WS_SIAPE_SENHA, WS_SIAPE_ORGAO'' e ''WS_SIAPE_ATIVO'' em [[desenvolvimento:especificacoes:sigadmin:casos_de_uso:portal_da_administracao:config_do_sistema::parametros:listar_alterar_parametros|Listar/Alterar Parâmetros]].

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

Este caso de uso inicia quando o usuário acessa a opção //SIGRH → Administração de Pessoal → Administração → Importação SIAPE -> Integração SIAPE → Sincronizar servidores via Webservices do SIAPE//.

Para iniciar a sincronização é necessário informar:
  * **Unidade**: Tipo TEXTO. São listadas todas as Unidades de Lotação.
  * **Servidor**: Tipo AUTOCOMPLETE. Entada de dados: NOME SERVIDOR, MATRÍCULA SIAPE, MATRÍCULA INTERNA, CPF.

O sistema acessa o WebService. ([[#Principais Regras de Negócio|RN01]], [[#Principais Regras de Negócio|RN02]])

O caso de uso é finalizado. 

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

   * **RN01**- O WebService consulta os dados do servidor através do CPF informado, caso encontre esta informação e ela esteja diferente da existente no banco de dados do SIGRH, então ela é importada.
   * **RN02**- Se houver algum erro durante o processamento, o sistema grava em uma tabela de crítica que a sincronia para um determinado servidor não foi efetuada e informa o motivo. Ele também grava quando o servidor é atualizado com sucesso.

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

<ifauth @admin>

===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe ^ Tabela |
| br.ufrn.sigrh.funcional.dominio.Servidor.Servidor | sigrh.rh.servidor |
| br.ufrn.sigrh.pessoal.dominio.Pessoa | sigrh.comum.pessoa |

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

Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Administração → Importação SIAPE -> Integração SIAPE → Sincronizar servidores via Webservices do SIAPE

Usuário: mirian

Papel que usuário deve ter: SigrhPapeis.ADMINISTRADOR_DAP

===== Cenários de Teste =====
O teste pode ser realizado utilizando qualquer servidor válido da instituição.

===== Dados para o Teste =====
Os dados serão obtidos através de consulta (ver SQL abaixo) ao banco de dados do SIGRH (administrativo).

<code sql>
SELECT p.id_pessoa, p.nome, p.cpf_cnpj, p.ultima_atualizacao 
AS ultima_atualizacao_pessoa, s.id_servidor, s.siape, s.ultima_atualizacao 
AS ultima_atualizacao_servidor 
  FROM comum.pessoa p, rh.servidor s
 WHERE p.nome LIKE 'NOME_DO_SERVIDOR' 
   AND p.tipo = 'F'
   AND p.id_pessoa = s.id_pessoa
</code>

A consulta acima retorna o **id da pessoa**, o **nome**, o **cpf**, a **data de ultima atualizacao da pessoa**, o **id do servidor**, a **matricula siape** e a **data da ultima atualização do servidor** informado na consulta, onde, "__NOME_DO_SERVIDOR__" deve ser substituído pelo nome do servidor utilizado no caso de uso. 

As colunas de **data de última atualização** devem ser observadas, os valores presentes em ambas as colunas devem ser o da //data de execução do caso de uso//.

</ifauth>