Extrator EPA

Objetivo

A funcionalidade Extrator EPA permite automatizar o alvo, o resultado de indicadores e o cadastro de pessoas/clientes a partir de qualquer banco de dados, utilizando uma consulta SQL com layout específico.

Quando utilizar

Use esta funcionalidade quando for necessário:

• automatizar a carga de resultados de indicadores;
• automatizar a importação de alvos dos indicadores;
• automatizar o cadastro de pessoas/clientes;
• configurar integrações com banco de dados de origem;
• monitorar e executar sincronizações manualmente.

Como realizar esta ação

1. Acesse o menu do EPA.
2. Clique em Planejamento > Funcionalidades > Extrator EPA.
3. Configure a conexão com o banco de dados de origem.
4. Cadastre as classificações que serão usadas para organizar as automatizações.
5. Clique em + Adicionar Indicador para criar a automatização desejada.
6. Defina o tipo de automatização, a conexão, a classificação e a consulta SQL.
7. Clique em Salvar.
8. Quando necessário, execute a sincronização manualmente ou acompanhe os logs do extrator.

Campos e configurações

1. Configurar conexão com banco de dados de origem

Para criar uma nova conexão, clique em Conexões. O EPA abrirá o formulário de conexão.

Campo	Descrição
Banco de Dados	Define o tipo de banco de dados de origem. Se o banco utilizado na empresa não estiver listado, será necessário contato com a Simeon para configuração.
IP	Informa o endereço do servidor do banco de dados.
Nome do banco	Informa a base de dados de origem.
Usuário	Usuário de acesso ao banco, podendo ser apenas de leitura.
Senha	Senha do usuário informado.
Porta	Porta utilizada na conexão com o banco.
Nome da conexão	Identificação da conexão cadastrada no extrator.

2. Criar classificações

As classificações são utilizadas para organizar os indicadores automatizados por grupos.

Exemplo:

• Ocorrências: para agrupar todos os indicadores do módulo de Ocorrências.

Para criar uma classificação, clique em + Classificações.

3. Configurar indicadores

Para criar a automatização de indicadores, clique em + Adicionar Indicador.

Ao criar a automatização, será necessário:

• informar um nome para a automatização;
• informar o código do indicador no EPA;
• selecionar a conexão criada no passo 1;
• informar o horário de sincronização e confirmar com Enter;
• informar o formato de data do banco de dados de origem;
• selecionar a classificação;
• informar a quantidade de meses retroativos, quando necessário;
• definir se a sincronização será executada mês a mês;
• clicar em Salvar.

Configurações adicionais da automatização

Campo	Descrição
Qtde Mês Retroativo	Define quantos meses anteriores também serão considerados na importação automática. Exemplo: se informado 2, o sistema buscará automaticamente os últimos dois meses além do mês atual.
Executar Mês a Mês	Utilizado quando a consulta considera apenas uma data final. Exemplo: inadimplência, em que se deseja buscar tudo que está em aberto até o final do mês, independentemente da data de origem do débito.

Tipos de automatização e layout da SQL

O layout da consulta SQL deve corresponder ao tipo de automatização selecionado.

Tipo: Indicador

SELECT
  campo as data,
  campo as valor,
  campo as obs1,
  campo as obs2,
  campo as obs3,
  campo as obs4,
  campo as obs5,
  campo as obs6,
  campo as obs7,
  campo as obs8,
  campo as obs9,
  campo as obs10,
  campo as usuario,
  campo as codigoexterno
FROM ???????
WHERE ???????
  data >= '$datainicio'
  and data <= '$datafim'

Campos opcionais:

• campo_filho: quando existe subindicador;
• peso: quando o indicador utilizar média ponderada;
• numerador, denominador: quando o indicador tiver a configuração Executar divisão dos valores no cálculo do resultado. Fator de multiplicação;
• etapa_composta: quando for necessário importar valores específicos para a etapa composta.

Tipo: Alvo

SELECT
  0 as alvoTipo,
  0 as usuario,
  data,
  campo as ncriterio_1,
  campo as ncriterio_2,
  campo as ncriterio_3,
  campo as ncriterio_4,
  campo as ncriterio_5,
  campo as ncriterio_6,
  campo as ncriterio_7,
  campo as ncriterio_8,
  campo as ncriterio_9,
  campo as ncriterio_10,
  campo as valor
FROM ???????
WHERE ???????
  data >= '$datainicio'
  and data <= '$datafim'

Campos opcionais:

• campo_filho;
• peso;
• etapa: quando informado, o sistema ignora o campo data.

Tipo: Clientes

SELECT
  campo as nome,
  campo as fantasia,
  campo as tipo,
  campo as endereco,
  campo as bairro,
  campo as cidade,
  campo as uf,
  campo as cep,
  campo as cpf,
  campo as email,
  campo as nascimento,
  campo as matricula,
  campo as origem,
  campo as codigo,
  campo as data_cadastro,
  campo as telefone,
  campo as celular,
  campo as empresa,
  campo as codigo_protocolo,
  campo as questionario_id,
  campo as campanha_nps,
  campo as data_envio_questionario,
  id_externo_unidade,
  campo as data_atendimento_importacao
FROM ???????
WHERE ???????
  data_cadastro >= '$datainicio'

Regras importantes:

• origem é obrigatório para evitar duplicidade de registros;
• codigo é obrigatório para evitar duplicidade de registros;
• telefone corresponde ao campo Telefone 1 do cadastro da pessoa;
• questionario_id, campanha_nps e data_envio_questionario são opcionais, mas passam a ser obrigatórios se o cliente for utilizado como participante em uma Campanha NPS;
• codigo_protocolo e id_externo_unidade são campos numéricos inteiros, não obrigatórios;
• para adicionar um cliente com origem vinculada a unidade gerencial, é necessário informar codigo_protocolo e id_externo_unidade.

Atualizar indicador manualmente

Independentemente do horário configurado, um usuário com permissão pode executar a atualização manual de um indicador no Extrator EPA.

Para isso, ele deve:

1. informar o período desejado;
2. localizar o indicador;
3. clicar no botão de atualizar do indicador correspondente.

Monitoramento do extrator

O Extrator EPA possui a opção de Log, em que podem ser acompanhadas as últimas execuções realizadas.

Esse monitoramento ajuda a validar:

• se a sincronização foi executada;
• se houve falha na consulta;
• se o agendamento está ocorrendo conforme esperado.

Melhorias de busca e layout

O extrator passou a permitir a pesquisa dos indicadores:

• pelo nome;
• pelo código.

Também foram feitas melhorias de layout para organizar melhor as ações disponíveis.

Novos recursos da tela

Item	Descrição
Data início e Data fim para sincronização	Define o período da sincronização manual.
Botão para sincronizar todos os indicadores	Executa a sincronização em lote.
Botão para reagendar sincronizações	Permite reagendar as execuções do extrator.
Campo de pesquisa por nome ou código	Permite localizar rapidamente um indicador na listagem.
Seleção das classificações	Filtra os indicadores automatizados conforme a classificação cadastrada.
Listagem dos indicadores automatizados	Exibe os indicadores já configurados no extrator.

Atenção

• O layout da consulta SQL deve corresponder exatamente ao tipo de automatização escolhido.
• Se o banco de dados de origem não estiver entre as opções do sistema, será necessário contato com a Simeon.
• Revise cuidadosamente o formato da data, a classificação e os campos opcionais antes de salvar a automatização.
• O log do extrator deve ser consultado sempre que houver dúvida sobre o resultado de uma sincronização.