Especificao Tcnica de

Integrao UC0284
Relatrio sinttico de
crditos em conta
efetivados e rejeitados

SIBEN Sistema de Gesto e

Operao de Benefcios Sociais

CAIXA

Confidencial 1
 ESPECIFICAO TCNICA DE
INTEGRAO

CONTROLE DE VERSES

VERSO DATA AUTOR ALTERAES

1.0 31/11/2016 Capgemini Criao do Documento

APROVAES

EMPRESA NOME DATA ASSINATURA

Confidencial 2
 ESPECIFICAO TCNICA DE
INTEGRAO

Sumrio

1 Objetivo da chamada do servio de integrao:..........................................................4

2 Escopo:.............................................................................................................................4

3 Referncias:.....................................................................................................................4

4 Caractersticas do servio de integrao:....................................................................4

5 Condies de execuo do servio de integrao (Requisio/Envio):...................5

5.1 Condies de execuo do servio de integrao:..............................................7

5.1.1 Processamento BATCH Cram:...........................................................................7

5.1.2 Processamento PowerCenter para Gerao do Relatrio:...............................8

6 Ambientes:.......................................................................................................................8

7 Diagrama de Sequncia..................................................................................................9

8 Casos de uso da integrao...........................................................................................9

8.1 Processamento Cram BATCH:..............................................................................9

8.2 Processamento PowerCenter para Gerao do Relatrio:.................................11

9 Estrutura do Arquivo:....................................................................................................12

9.1 Leiaute do Arquivo de Envio:........................................................................................................... 12

Confidencial 3
 ESPECIFICAO TCNICA DE
INTEGRAO

1 Objetivo da chamada do servio de integrao:

O objetivo desse documento elucidar o processo de gerao relatrio sinttico de crditos em conta
efetivados e rejeitados para os programas geridos pela CAIXA (PBF, PETI e pactos), relatrio que deve
ser gerado mensalmente e disponibilizado para o gestor da CAIXA.

2 Escopo:
lO escopo deste documento tem como intuito explanar os servios de integrao para disponibilizao
dos arquivos com as informaes dos relatrio sinttico de crditos em conta efetivados e rejeitados
para todos os programas sociais e folhas, integraes que acontecem entre o sistema SIBEN e o
gestor da CAIXA

3 Referncias:
Caso de Uso:

SIBEN_UC0284_Disponibiliza_Relatorio_Sintetico_Credito_Conta_Efetivado_Rejeitado;

Descrio da Interface do Caso de Uso:

SIBEN_DI_UC0284_Disponibiliza_Relatorio_Sintetico_Credito_Conta_Efetivado_Rejeitado;

Mensagens do Sistema: SIBEN_Mensagem_Sistema;

Modelo de Domnio: SIBEN_Modelo_Dominio;

Regras de Negcio: SIBEN_Regras_Negocio;

Glossrio: SIBEN_Glossario;

Desenho Tcnico:

SIBEN_UC0284_DT_Disponibiliza_Relatorio_Sintetico_Credito_Conta_Efetivado_Rejeitado;

Especificao Suplementar: SIBEN_Especificao_Suplementar.

4 Caractersticas do servio de integrao:

Nome fsico do arquivo que ser gerado

Nome do arquivo de envio / recebimento
Esta informao deve ser repassada pela CAIXA TI
Preencher com o tamanho em bytes da entrada
Tamanho mdio do arquivo de envio /
Informao ser extrada da DTI elaborada pela
recebimento
CAIXA

Confidencial 4
 ESPECIFICAO TCNICA DE
INTEGRAO

Local de disponibilizao do arquivo de

Esta informao deve ser repassada pela CAIXA TI
envio / recebimento
Nome do arquivo de retorno No se aplica.

Tamanho mdio do arquivo de retorno No se aplica.

Local de disponibilizao arquivo de

No se aplica.
retorno

Frequncia de execuo Mensal.

5 Condies de execuo do servio de integrao (Requisio/Envio):

Os relatrio sinttico de crditos em conta efetivados e rejeitados so gerados quando o temporizador
identifica o perodo pr-determinado para execuo da rotina de gerao deste arquivo , com execuo
agendada via ferramenta de agendamento Control-M.

O sistema SIBEN atravs do processo Cram BATCH, armazena um registro para o relatrio sinttico
de crditos em conta efetivados e rejeitados na tabela de controle da stage em situao Em
Processamento.

Seguidamente o processo Cram BATCH recupera as informaes dos benefcios reavaliados, as

formata conforme devem ser apresentadas no relatrio e as armazena na base da stage
ReportOData, existente para guardar as informaes necessrias para gerao de relatrios.

Caso acontea algum erro tcnico nos acessos s bases da stage ou do SIBEN, o processo Cram
BATCH finalizar. Na tabela de controle da stage ficar registrado o relatrio na situao Processado
com Erros. Somente no caso da atualizao da situao do relatrio na tabela de controle no ser
efetuada com sucesso, o relatrio ficaria na situao Em Processamento.
Tambm ficaro armazenados na tabela da stage ReportOData onde se formata o relatrio os
registros que foram inseridos at o momento de acontecer o erro.
Para finalizar o processamento de gerao do relatrio que ficou sem processar completamente, a rea
de TI da CAIXA dever analisar o motivo pelo qual se produziu o erro no acesso s bases, corrigir o
problema e reprocessar o processo Cram BATCH que parou. A execuo do novo processo Cram
BATCH verificar a existncia de um arquivo em situao Processado com Erros ou Em
Processamento e armazenar os registros nesta base da stage at a finalizao da gerao do
relatrio.

O diagrama bsico do processo Cram BATCH do SIBEN o seguinte:

Confidencial 5
 ESPECIFICAO TCNICA DE
INTEGRAO

Finalmente, uma vez finalizado o processo de gerao do relatrio pelo Cram BATCH, o sistema
SIBEN, atravs da ferramenta Powercenter, verifica a existncia de um relatrio com a situao igual a
Processado com Sucesso na tabela de controle da stage.

O Powercenter recupera todos os registros (que j esto formatados) da base da stage ReportOData
e os disponibiliza, em formato de arquivo CSV, em um diretrio Relatrios para serem acessadas
pelo B2B.

Caso o relatrio no apresente nenhum registro (contador de registros zerado), o Powercenter dever
gerar o arquivo CSV com o cabealho, mas sem nenhum registro no detalhe do arquivo.

O Powercenter tambm atualiza a situao do relatrio na tabela de controle da stage para

Finalizado.

Caso acontecer algum erro tcnico nos acessos s bases da stage, o processo PowerCenter finalizar
sem registrar nenhuma informao nas bases de controle da stage e sem gerar o arquivo CSV.

Desta forma, quando o processo PowerCenter seja executado de novo, voltar executar o processo
desde o comeo, encontrando o relatrio na situao Processado com Sucesso.

Confidencial 6
 ESPECIFICAO TCNICA DE
INTEGRAO

O diagrama bsico deste processo que finaliza com a disponibilizao do arquivo para o B2B o
seguinte:

5.1 Condies de execuo do servio de integrao:

5.1.1 Processamento BATCH Cram:

TIPO DE DESCRIO
## TRATAMENTO
EXCEO EXCEO

Confidencial 7
 ESPECIFICAO TCNICA DE
INTEGRAO

1. Cram BATCH armazena um erro tcnico na

tabela de erros do SIBEN, informando sobre o
erro no acesso base da stage e o servio de
Erro Erro ao acessar integrao onde se apresentou o erro, neste caso
E.01
Tcnico base da stage o processo do Cram BATCH onde se
apresentou o problema;
2. Cram BATCH gera e disponibiliza log do
processo.
1. Cram BATCH armazena um erro tcnico na
tabela de erros do SIBEN, informando sobre o
Erro no erro no armazenamento de dados na stage e o
Erro armazenamento servio de integrao onde se apresentou o erro,
E.02
Tcnico de dados na neste caso o processo do Cram BATCH e a
stage tabela da stage onde se apresentou o problema;
2. Cram BATCH gera e disponibiliza log do
processo.
1. Cram BATCH armazena um erro tcnico na
tabela de erros do SIBEN, informando sobre o
erro na leitura de dados no SIBEN e o servio de
Erro Erro na leitura de integrao onde se apresentou o erro, neste caso
E.03
Tcnico dados no SIBEN o processo do Cram BATCH e a tabela da stage
onde se apresentou o problema;
2. Cram BATCH gera e disponibiliza log do
processo.

5.1.2 Processamento PowerCenter para Gerao do Relatrio:

TIPO DE DESCRIO
## TRATAMENTO
EXCEO EXCEO
1. PowerCenter armazena um erro tcnico na tabela
de erros do SIBEN, informando sobre o erro na
leitura de dados na stage e o servio de
Erro Erro na leitura de
E.01 integrao onde se apresentou o erro, neste caso
Tcnico dados na stage
PowerCenter;
2. PowerCenter gera e disponibiliza log do
processo.
1. PowerCenter armazena um erro tcnico na tabela
de erros do SIBEN, informando sobre o erro no
Erro no
armazenamento de dados na stage e o servio
Erro armazenamento
E.02 de integrao onde se apresentou o erro, neste
Tcnico de dados na
caso PowerCenter;
stage
2. PowerCenter gera e disponibiliza log do
processo.

6 Ambientes:

Ambiente SIBEN <Servio Integrao>

DESENVOLVIMENTO <informar host> <informar host>

HOMOLOGAO <informar host> <informar host>

Confidencial 8
 ESPECIFICAO TCNICA DE
INTEGRAO

PRODUO <informar host> <informar host>

7 Diagrama de Sequncia

8 Casos de uso da integrao

8.1 Processamento Cram BATCH:

O fluxo normal e alternativo o seguinte:
SIBEN atravs dos processos Cram BATCH estabelece comunicao com a base de controle da stage
onde se armazenam os relatrios gerados:
Se o processo Cram BATCH no consegue estabelecer a comunicao com a base da stage, o
processo Cram BATCH armazena um erro tcnico na base de erros do SIBEN e gera e
disponibiliza o log do processo;

Confidencial 9
 ESPECIFICAO TCNICA DE
INTEGRAO

Se o processo Cram BATCH consegue estabelecer a comunicao com a base da stage, o

processo Cram BATCH verifica se existe algum relatrio sinttico de crditos em conta efetivados e
rejeitados na situao de Em Processamento ou Processado com Erros na tabela de controle
da stage:

Se no existe nenhum relatrio nessas situaes, o processo Cram BATCH inclui um registro
para o relatrio na tabela de controle da stage na situao "Em Processamento":
o Se a incluso na base de controle da stage foi efetuada com sucesso, o Cram BATCH
processa a gerao do relatrio desde o primeiro registro;
o Se a incluso da base de controle da stage no foi efetuada com sucesso, o Cram BATCH
armazena um erro tcnico na base de erros do SIBEN e gera e disponibiliza o log do
processo.

Se existe um relatrio na situao Processado com Erros, o processo Cram BATCH atualiza
a situao do arquivo na tabela de controle da stage para "Em Processamento":
o Se a atualizao da base de controle da stage foi efetuada com sucesso, o Cram BATCH
processa a gerao do relatrio a partir do ultimo registro que foi inserido em um
processamento anterior;
o Se a atualizao da base de controle da stage no foi efetuada com sucesso, o Cram
BATCH armazena um erro tcnico na base de erros do SIBEN e gera e disponibiliza o log do
processo.

Se existe um relatrio na situao Em Processamento, o processo Cram BATCH processa a

gerao do relatrio a partir do ultimo registro que foi inserido em um processamento anterior.

O processo Cram BATCH verifica a existncia de registros nas bases do SIBEN para gerao do
relatrio:
Se o processo Cram BATCH verifica que no existem registros nas bases do SIBEN para
gerao do relatrio, o processo Cram BATCH atualiza a situao do arquivo na tabela de
controle da stage para Processado com Sucesso, atualiza o contador de registros na tabela
de controle da stage e gera e disponibiliza o log do processo:
o Se o processo Cram BATCH verifica que a atualizao na base de controle da stage no foi
realizada corretamente, o processo Cram BATCH armazena um erro tcnico na base de
erros do SIBEN e gera e disponibiliza o log do processo;
o Se o processo Cram BATCH verifica que a atualizao na base de controle da stage foi
realizada corretamente, o processo Cram BATCH gera e disponibiliza o log do processo.

Confidencial 10
 ESPECIFICAO TCNICA DE
INTEGRAO

Se o processo Cram BATCH verifica que existem registros nas bases do SIBEN para gerao
do relatrio, o processo Cram BATCH recupera as informaes para o registro nas bases do
SIBEN:
o Se o processo Cram BATCH verifica que a leitura nas bases do SIBEN no foi realizada
corretamente, o processo Cram BATCH atualiza a situao do relatrio na tabela de controle
da stage para "Processado com Erros", armazena um erro tcnico na base de erros do
SIBEN e gera e disponibiliza o log do processo;
o Se o processo Cram BATCH verifica que a leitura nas bases do SIBEN foi realizada
corretamente, o processo Cram BATCH formata as informaes do registro conforme devem
ser apresentadas no relatrio e as armazena na tabela da stage ReportOData:
Se o processo Cram BATCH verifica que as informaes do registro no foram
armazenadas corretamente na tabela da stage, o processo Cram BATCH atualiza a
situao do relatrio na tabela de controle da stage para "Processado com Erros",
armazena um erro tcnico na base de erros do SIBEN e gera e disponibiliza o log do
processo;
Se o processo Cram BATCH verifica que as informaes do registro foram armazenadas
corretamente na tabela da stage, o processo Cram BATCH voltar verificar a existncia
de mais registros nas bases do SIBEN para gerao do relatrio, repetindo o ciclo de
processamento.

8.2 Processamento PowerCenter para Gerao do Relatrio:

O fluxo normal e alternativo o seguinte:
SIBEN atravs da ferramenta PowerCenter verifica a existncia de um relatrio na situao
Processado com Sucesso na tabela de controle da stage;
Powercenter l e seleciona todos os registros do relatrio na tabela da stage ReportOData:
Se aconteceu algum erro no acesso base da stage, o PowerCenter armazena um erro tcnico
na base de erros do SIBEN e gera e disponibiliza o log do processo no Servidor de Aplicao
PowerCenter;
Se no aconteceu nenhum erro no acesso base da stage, o PowerCenter atualiza a situao
do relatrio na tabela de controle da stage para "Finalizado":
o Se aconteceu algum erro na atualizao da tabela de controle da stage, o PowerCenter
armazena um erro tcnico na base de erros do SIBEN e gera e disponibiliza o log do
processo no Servidor de Aplicao PowerCenter
o Se no aconteceu nenhum erro na atualizao da tabela de controle da stage, o Powercenter
verifica o contador de registros do relatrio na tabela de controle da stage:

Confidencial 11
 ESPECIFICAO TCNICA DE
INTEGRAO

Se o contador de registros estiver zerado, o Powercenter gera um arquivo CSV com todas
as informaes do cabealho, mas sem registros e disponibiliza em diretrio de
Relatrios;
Se o contador de registros no estiver zerado, o Powercenter gera um arquivo CSV com
todas as informaes do cabealho e com todos os registros e disponibiliza em diretrio
de Relatrios.
.

9 Estrutura do Arquivo:

9.1 Leiaute do Arquivo de Envio:

O leiaute do arquivo de envio est definido no documento descrio da interface do caso de uso:

SIBEN_DI_UC0284_Disponibiliza_Relatorio_Sintetico_Credito_Conta_Efetivado_Rejeitado.

O arquivo ser gerado a partir da tabela da stage ReportOData, que ter o mesmo leiaute que o
arquivo, junto com os campos de controle necessrios.

Confidencial 12