Informações Gerais

Objetivo

Definir a regra dos extratores do Financeiro que alimentam os dados para o TOTVS Smart Analytics.

Definição da Regra de Negócio

Dimensões

Fatos

Os conceitos utilizados para a extração dos dados são disponibilizados no caminho {PATH_RM}\ObjetosGerenciais\Conceito\TOTVSBA.

Ex.: C:\totvs\CorporeRM\ObjetosGerenciais\Conceito\TOTVSBA

As fórmulas visuais para execução dos conceitos serão disponibilizadas no caminho {PATH_RM}\ObjetosGerenciais\Fórmulas Visuais\TOTVSBA.

 Ex.: C:\totvs\CorporeRM\ObjetosGerenciais\Fórmulas Visuais\TOTVSBA

Os extratores RM utilizam a versão nova do conceito RM para extrair os dados da base. Para utilização dos extratores é necessário dicionar a tag abaixo para aumentar o timeout de execução dos DataServers

<add key="DBSCommandTimeout" value="100000" />

Configuração do BA

 O Configurador do extrator do TOTVS Smart Analytics se encontra no módulo Integração aba Ferramentas do RM.exe. Na primeira tela informamos o usuário e senha da base do Corpore e na tela seguinte selecionamos o projeto de integração TOTVS Business Analytics. Na tela seguinte deve-se informar os dados para conexão na base stage (Fluig Smart Data) e o caminho onde se encontram os conceitos dos extratores. Os conceitos serão importados já configurados para a base RM como origem e para a base stage (Fluig Smart Data) como destino. Todas as tabelas e views do BA serão recriadas e o configurador irá criar/atualizar as tabelas da base stage área (Fluig Smart Data), criar os parâmetros utilizados nos extratores e realizar a carga inicial nas tabelas.

 O configurador não faz a importação das fórmulas visuais. Elas devem ser importadas manualmente após rodar o configurador pelo processo Importação de Fórmula Visual na visão da mesma. Para cada fórmula ser importada é necessário marcar “Todas Coligadas” na Seleção da Coligada, informar uma categoria na aba Parâmetros e selecionar a consulta da fórmula e selecionar “Fixo” no “Código da Consulta SQL”.

Parametrizador BA

Após a execução do Configurador é necessário acessar os Parâmetros localizado no módulo Integração.Os parâmetros do BA são divididos entre Parâmetros Globais (divididos em Gerais, Extração, TOTVS Smart Analytics, Educacional e Recursos Humanos) e Parâmetros por Empresa (divididos em Educacional, Recursos Humanos, Controladoria, Materiais, Comercial e Financeiro). Vamos detalhar aqueles que influenciam o Financeiro.

Globais: 

• Gerais: o parâmetro Ativar integração vem por padrão desmarcado, o parâmetro Portador serve para indicar qual tabela opcional do financeiro será utilizada para definir o portador. As tabelas opcionais são definidas nos parâmetros de Contas a Pagar do Financeiro na etapa Tabelas Opcionais do Financeiro.
• Extração: aqui é definido o período de extração dos dados do RM. Ele pode ser fixo ou variável. No modo fixo é definida uma data inicial e uma data final para a extração dos dados.  Esta forma é muito útil para validação das informações e carga inicial da stage área (Fluig Smart Data). No modo Variável pode-se escolher entre intervalos mensais ou intervalos diários. Ao se executar o conceito inicial de extração a data inicial e a data final são calculadas em função da data de execução e dos períodos configurados. Dias/Meses a serem subtraídos da data atual para calcular a data inicial e Dias/Meses a serem adicionados a data atual para calcular a data final. O parâmetro Extração por Fato define os períodos de extração específicos para cada fato. O parâmetro já vem preenchido com todas as fatos disponíveis na linha RM com a configuração sugerida de período de extração. Para que esta configuração sobrescreva a configuração padrão é necessário habilitá-la.
• Educacional: no parâmetro Instituição de Ensino define-se como o nome da instituição de ensino será formado. As opções são Coligada, Filial ou Coligada - FiIial.

Por empresa:

• Educacional: os parâmetros do Educacional são Situação de Matrícula, que serve para identificar as situações de matriculas que são consideradas perda de aluno para a instituição de ensino, e Bolsa de Estudo, que serve para identificar o campo complementar do Financeiro que é utilizado para armazenar o valor da bolsa oferecida aos alunos.
• Financeiro: os parâmetros Financeiros são Tipos de Documento a Pagar, que que indica quais os tipos de documento a pagar que serão enviados para o BA, e Tipos de Documento a Receber, que indica quais os tipos de documento a receber que serão enviados para o BA.

Fórmulas Visuais BA

As fórmulas visuais do BA são responsáveis em executar os conceitos do BA (extratores), enviar um e-mail com o status da execução e gravar o log da execução no server. No caso do GoodData ela também chama o Smart Analytics Agent para enviar os dados para a nuvem GoodData e envia o log da execução do Agent junto no e-mail da execução do extrator.

 Atividades TOTVS BA

• Executa Conceito BA: Recebe uma consulta SQL e executa os conceitos passados na consulta. Retorna o log e o status da execução.
• Executa Smart Analytics Agent: Recebe o endereço do java.exe, do programa Agent (jar) e do arquivo de configuração do Agent. Retorna o log de execução do Agent.

Layout Fórmula Visual TOTVS BA

Layout Fórmula Visual TOTVS BA (GoodData)

Métricas do Financeiro

Server de extração de dados

• Contas a pagar - Carteira

ASSUNTO: Gestão de Pagamentos / Contas a Pagar, FATO: Contas a Pagar Carteira, Tabela: HLK

Filtra os títulos a receber em aberto ou parcialmente baixados: FLAN.PAGREC = 2 AND (FLAN.STATUSLAN = 0 OR FLAN.STATUSLAN = 4)

Campo Saldo: VALOR_PAGAR = VALORORIGINAL - VALORBAIXADO

• Contas a pagar - Pagamento

ASSUNTO: Gestão de Pagamentos / Contas a Pagar, FATO: Contas a Pagar Pagamento, TABELA: HLI

Traz os lançamentos baixados (total ou parcial), ou seja, o que já foi pago dentro de um período (baseado na data da baixa).

Filtro:  FLAN.PAGREC = 2 AND (FLAN.STATUSLAN = 1 OR FLAN.STATUSLAN = 4) AND FLAN.DATABAIXA BETWEEN :DataInicial AND :DataFinal

onde :DataInicial e :DataFinal são os parâmetros para data de extração.

Campo Saldo: VALOR_PAGO = VALORBAIXADO

• Contas a pagar - Vencimento

ASSUNTO: Gestão de Pagamentos / Contas a Pagar, FATO: Contas a Pagar Vencimento, TABELA: HLD

Traz os lançamentos em aberto (total ou parcial), ou seja os pendentes a pagar vencendo num período.

Filtro: FLAN.PAGREC = 2 AND FLAN.STATUSLAN NOT IN (1, 2, 3) AND FLAN.DATAVENCIMENTO BETWEEN :DataInicial AND :DataFinal

onde :DataInicial e :DataFinal são os parâmetros para data de extração.

Campo Saldo: VALOR_VENCIMENTO = chama cálculo do valor líquido com data atual

• Contas a receber - Carteira

ASSUNTO: Gestão de Pagamentos / Contas a Receber, FATO: Contas a Receber Carteira, Tabela: HLL

Traz os lançamentos pendentes pra receber, filtra os títulos a receber em aberto ou parcialmente baixados.

Filtro: FLAN.PAGREC = 1 AND (FLAN.STATUSLAN = 0 OR FLAN.STATUSLAN = 4)

Campo Saldo: VALOR_RECEBER = VALORORIGINAL- VALORBAIXADO

• Contas a receber - Recebimento

ASSUNTO: Gestão de Pagamentos / Contas a Receber, FATO: Contas a Receber Pagamento, TABELA: HLJ

Traz os títulos a receber baixados ou parcialmente baixados

Filtro: FLAN.PAGREC = 1 AND (FLAN.STATUSLAN = 1 OR FLAN.STATUSLAN = 4) AND FLAN.DATABAIXA BETWEEN :DataInicial AND :DataFinal

onde :DataInicial e :DataFinal são os parâmetros para data de extração.

Campo Saldo: VALOR_RECEBIDO = VALORBAIXADO

• Contas a receber - Vencimento

ASSUNTO: Gestão de Pagamentos / Contas a Pagar, FATO: Contas a Pagar Vencimento, TABELA: HLD

Traz os lançamentos em aberto (total ou parcial), ou seja os pendentes a receber vencendo num período.

Filtro: FLAN.PAGREC = 1 AND (FLAN.STATUSLAN = 0 OR FLAN.STATUSLAN = 4) AND FLAN.DATAVENCIMENTO BETWEEN :DataInicial AND :DataFinal

onde :DataInicial e :DataFinal são os parâmetros para data de extração.

Campo Saldo: VALOR_VENCIMENTO = chama cálculo do valor líquido com data atual

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.

Informações Gerais

Objetivo

Definir a regra dos extratores do Financeiro que alimentam os dados para o TOTVS Smart Analytics.

Definição da Regra de Negócio

Dimensões

Fatos

Os conceitos utilizados para a extração dos dados são disponibilizados no caminho {PATH_RM}\ObjetosGerenciais\Conceito\TOTVSBA.

Ex.: C:\totvs\CorporeRM\ObjetosGerenciais\Conceito\TOTVSBA

As fórmulas visuais para execução dos conceitos serão disponibilizadas no caminho {PATH_RM}\ObjetosGerenciais\Fórmulas Visuais\TOTVSBA.

 Ex.: C:\totvs\CorporeRM\ObjetosGerenciais\Fórmulas Visuais\TOTVSBA

Os extratores RM utilizam a versão nova do conceito RM para extrair os dados da base. Para utilização dos extratores é necessário dicionar a tag abaixo para aumentar o timeout de execução dos DataServers

<add key="DBSCommandTimeout" value="100000" />

Configuração do BA

 O Configurador do extrator do TOTVS Smart Analytics se encontra no módulo Integração aba Ferramentas do RM.exe. Na primeira tela informamos o usuário e senha da base do Corpore e na tela seguinte selecionamos o projeto de integração TOTVS Business Analytics. Na tela seguinte deve-se informar os dados para conexão na base stage (Fluig Smart Data) e o caminho onde se encontram os conceitos dos extratores. Os conceitos serão importados já configurados para a base RM como origem e para a base stage (Fluig Smart Data) como destino. Todas as tabelas e views do BA serão recriadas e o configurador irá criar/atualizar as tabelas da base stage área (Fluig Smart Data), criar os parâmetros utilizados nos extratores e realizar a carga inicial nas tabelas.

O configurador não faz a importação das fórmulas visuais. Elas devem ser importadas manualmente após rodar o configurador pelo processo Importação de Fórmula Visual na visão da mesma. Para cada fórmula ser importada é necessário marcar “Todas Coligadas” na Seleção da Coligada, informar uma categoria na aba Parâmetros e selecionar a consulta da fórmula e selecionar “Fixo” no “Código da Consulta SQL”.

Parametrizador BA

Após a execução do Configurador é necessário clicar no botão Parâmetros localizado no módulo Integração aba Ferramentas.

<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.