~~ODT~~


====== Integração Online ======

A Integração Online é um mecanismo utilizado pela UFRN para possibilitar comunicação em tempo real com os sistemas estruturantes do governo mantidos pelo SERPRO que executam em uma plataforma Mainframe.

===== Emulador s3270 =====

A integração utiliza o emulador s3270, que é um tipo de terminal criado pela IBM para comunicação com mainframes. O emulador foi desenvolvido por Paul Mattes.

No DPF (Deparamento de Polícia Federal), Galileu Batista e Halisson Fabrício, integrantes da equipe responsável pela implantação dos sistemas da UFRN no DPF, 
desenvolveram uma API Java para utilização das funcionalidades deste emulador. A UFRN integrou esta API aos sistemas SIG, aprimorou, incluiu tratamento de exceções de menor granularidade
, desenvolveu novas funcionalidades e criou uma infraestrutura de autenticação automática no Serviço de Emulação 3270 Via Web Browser - HOD. Este último passo não é utilizado no DPF, 
pois há uma conexão direta entre a rede DPF e a rede SERPRO.

Mais informações sobre o emulador s3270 e derivados podem ser obtidas no endereço: [[http://x3270.bgp.nu]].
==== Instalação no Windows ====

O arquivo executável compilado e a dll do emulador estão disponíveis no link: {{:desenvolvimento:integracoes_sistemas_governo:integracao_online:s3270-bin.zip}}. Os dois arquivos devem ser extraídos e colocados no diretório raiz do sistema operacional, por exemplo: C:\Windows.

Para testar se o emulador está pronto para o uso,  acesse o terminal de comandos do Windows e digite: s3270. Em seguida, tecle "enter". O resultado deve ser similar ao da Figura abaixo:

[[https://docs.info.ufrn.br/lib/exe/fetch.php?media=desenvolvimento:integracoes_sistemas_governo:integracao_online:mainframe_s3270_windows_teste.png]]


==== Instalação no Linux ====

Em distriubuições Linux baseadas no Debian (Ubuntu, Ubuntu Server etc) o aplicativo "s3230" está disponível no repositório oficial e pode ser instalado via apt-get com o comando:

<code>
apt-get install s3270
</code>

O pacote .deb pode ser obtido no link: [[http://pkgs.org/debian-squeeze/debian-nonfree-amd64/s3270_3.3.10ga4-2_amd64.deb.html | s3270 no formato deb]].

Para testar se o emulador está pronto para o uso. Acesse o terminal de comandos do linux e digite: s3270. Em seguida, tecle "enter". O resultado deve ser similar ao da Figura abaixo:

[[https://docs.info.ufrn.br/lib/exe/fetch.php?media=desenvolvimento:integracoes_sistemas_governo:integracao_online:mainframe_s3270_linux_teste.png]]

==== Logs ====

É possível visualizar os logs das telas acessadas automaticamente pelas funcionalidades dos sistemas SIG que utitilizam a Integração Online. Os trechos essenciais da comunicação com o Mainframe realizam logs através do Framework Log4j. Os logs são registrados com o nível INFO. 
A Figura a seguir exibe um exemplo de tela acessada pela Integração Online registrada no console do Eclipse IDE:

[[https://docs.info.ufrn.br/lib/exe/fetch.php?media=desenvolvimento:integracoes_sistemas_governo:integracao_online:mainframe_log_eclipse.png]]


==== Integração Online no SIPAC ====

=== SIAFI - Integração Online X Integração Tradicional (Arquivo/Lote) ===

As duas formas de integração possuem objetivos diferentes. Logo, em um cenário ideal, ambas devem ser utilizadas. 
A integração via arquivo é adequada para processamentos em lote, ou seja, importação de uma grande quantidade de informações, preferencialmente, de forma automatizada. Já a integração online é adequada para situações em que se deseja importar uma informação de forma imediata (em tempo real), por exemplo: um empenho foi cadastrado no SIAFI a 30 segundos e já se deseja importar este para que seja detalhado (definição dos centros de custo) no SIPAC. Além disso, a integração Online é útil para resolução de pendências na importação dos arquivos orçamentários, sendo também uma forma mais direta de obter os dados que impediram a consolidação de algum registro.

Informações que atualmente podem ser importadas em tempo real do SIAFI:
  * Nota de Empenho 
  * Credor
  * Plano Interno
  * Programa de Trabalho Resumido
  * Programa de Trabalho
  * Fonte de Recurso
  * Natureza de Despesa