Icon

Gestão Integrada TMS | Como criar Bases de Dados e Workflows no Data Builder

Aprenda a criar e configurar bases de dados e workflows no Data Builder para alimentar painéis e gráficos analíticos de forma eficaz.

By Product Owners Accountfy

Neste guia, vamos aprender a criar bases de dados e workflows no Data Builder para alimentar nossos painéis do Analytics.

Vamos começar!

Primeiro, é necessário criar as bases de dados onde os dados serão armazenados e, em seguida, criaremos os workflows que serão utilizados na rotina de atualização das informações.

Vamos criar alguns exemplos neste passo a passo, mas ele deverá ser repetido algumas vezes, havendo 7 bases de dados e 7 workflows no total.

1
Clique no produto Data Builder:
Step #1: Clique no produto Data Builder:
2
No menu lateral, acesse o módulo Base de Dados:
Step #2: No menu lateral, acesse o módulo Base de Dados:
3
Clique em Criar Base de Dados para iniciar o primeiro cadastro:
Step #3: Clique em Criar Base de Dados para iniciar o primeiro cadastro:
4
Informe o Nome da Base de Dados e em seguida os parâmetros que ela deverá conter, conforme descritos acima:
Step #4: Informe o Nome da Base de Dados e em seguida os parâmetros que ela deverá conter, conforme descritos acima:
5
Após informar o nome do parâmetro, selecione seu Tipo no menu ao lado:
Step #5: Após informar o nome do parâmetro, selecione seu Tipo no menu ao lado:
6
Após incluído o primeiro parâmetro, clique no ícone indicado para criar os demais.
Step #6: Após incluído o primeiro parâmetro, clique no ícone indicado para criar os demais.
7
Após a definição e revisão dos parâmetros criados, selecione a opção "Substituição Total" no Tipo de Atualização. E utilize o gerenciamento de acessos para realizar a liberação como administrador aos usuários: Charline Pires, João Mano e Ester Nery:
Step #7: Após a definição e revisão dos parâmetros criados, selecione a opção "Substituição Total" no Tipo de Atualização. E utilize o gerenciamento de acessos para realizar a liberação como administrador aos usuários: Charline Pires, João Mano e Ester Nery:
8
Por fim, clique em Criar Base de Dados:
Step #8: Por fim, clique em Criar Base de Dados:
9
Para criar as demais Bases de Dados clique no ícone indicado, e siga os mesmos passos anteriores para cada uma delas:
Step #9: Para criar as demais Bases de Dados clique no ícone indicado, e siga os mesmos passos anteriores para cada uma delas:

As informações para a criação de cada Base de Dados a serem criadas são:

1 - Nome da Base de Dados: parcelas_dividas

  • Parametrização:

  • # Colunas Tipo

  • 01 id_gestao_divida Inteiro

  • 02 gestao_divida Texto

  • 03 data_vencimento Data

  • 04 valor_saldo Decimal

  • 05 numero_parcela Inteiro

  • 06 quantidade_parcelas Inteiro

    07 valor_amortizacao Decimal

  • 08 valor_indice_juros Decimal

  • 09 valor_saldo_devedor Decimal

  • 10 valor_parcela Decimal

  • 11 status Texto

  • 12 valor_pago Decimal

  • 13 data_pagamento Data

  • 14 custo_efetivo Decimal

2 - Nome da Base de Dados: movimentacao_extrato_bancario

  • Parametrização:

  • # Colunas Tipo

  • 01 id Texto

  • 02 cliente_fornecedor Texto

  • 03 num_documento Texto

  • 04 descricao Texto

  • 05 valor_extrato Texto

  • 06 valor_a_conciliar Texto

  • 07 valor_saldo_do_dia Texto

  • 08 dt Texto

  • 09 data_gerado_pelo_razao Texto

  • 10 origem Texto

  • 11 dt_ultima_atualizacao Texto

  • 12 identificador_externo Texto

  • 13 descricao_classificacao Texto

  • 14 moeda Texto

  • 15 nome_conta Texto

  • 16 agencia_conta_bancaria Texto

  • 17 agencia Texto

  • 18 conta_bancaria Texto

  • 19 valor Texto

  • 20 tem_liqd Texto

  • 21 empresa Texto

  • 22 banco Texto

  • 23 codigo_banco Texto

  • 24 estrutura_gerencial Texto

  • 25 id_cliente_gestor Texto

  • 26 id_grupo_economico Texto

  • 27 grupo_economico Texto

3 - Nome da Base de Dados: lancamentos_financeiros

  • Parametrização:

  • # Colunas Tipo

  • 01 id_parcela_financeira Texto

  • 02 id_razao Texto

  • 03 descricao Texto

  • 04 cliente_fornecedor Texto

  • 05 empresa Texto

  • 06 tipo_parcela_financeira Texto

  • 07 grupo_economico Texto

  • 08 origem Texto

  • 09 dt_emissao Texto

  • 10 quantidade_parcelas Texto

  • 11 valor_titulo Texto

  • 12 id_parcela Texto

  • 13 numero_parcela Texto

  • 14 valor_parcela Texto

  • 15 valor_realizado Texto

  • 16 valor_realizado_juros Texto

  • 17 valor_realizado_multa Texto

  • 18 valor_realizado_desconto Texto

  • 19 valor_ajustado Texto

  • 20 saldo_liquidar Texto

  • 21 status Texto

  • 22 data_vencimento Texto

  • 23 data_vencimento_ajustada Texto

  • 24 data_realizado Texto

  • 25 codigo_banco Texto

  • 26 banco Texto

  • 27 nome_conta Texto

  • 28 conta_bancaria Texto

  • 29 agencia_only Texto

  • 30 conta_bancaria_only Texto

  • 31 codigo_banco_ajustado Texto

  • 32 banco_ajustado Texto

  • 33 nome_conta_ajustada Texto

  • 34 conta_bancaria_ajustada Texto

  • 35 agencia_ajustada_only Texto

  • 36 conta_bancaria_ajustada_only Texto

  • 37 estrutura_gerencial Texto

  • 38 estrutura_gerencial_ajustada Texto

  • 39 id_cliente_gestor Texto

  • 40 moeda Texto

  • 41 natureza Texto

  • 42 valor_imposto Texto

4 - Nome da Base de Dados: garantias_dividas

  • Parametrização:

  • # Colunas Tipo

  • 01 id_gestao_divida Inteiro

  • 02 id_garantia Inteiro

  • 03 valor_garantia Decimal

  • 04 status_garantia Texto

  • 05 vencimento_garantia Data

  • 06 descricao_garantia Texto

5 - Nome da Base de Dados: dividas_cadastradas

  • Parametrização:

  • # Colunas Tipo

  • 01 id Texto

  • 02 usuario Texto

  • 03 nome Texto

  • 04 status Texto

  • 05 valor Texto

  • 06 numero_parcelas Texto

  • 07 vencimento_divida Texto

  • 08 spread Texto

  • 09 data_credito Texto

  • 10 data_fechamento Texto

  • 11 dt_criacao Texto

  • 12 dt_edicao Texto

  • 13 carencia_parcelas Texto

  • 14 carencia_juros Texto

  • 15 taxa_juros Texto

  • 16 id_cliente_gestor Texto

  • 17 dt_ultimo_recalculo Texto

  • 18 dt_ultima_atualizacao_indicador Texto

  • 19 numero_contrato Texto

  • 20 amortizado Texto

  • 21 periodicidade Texto

  • 22 empresa Texto

  • 23 descricao Texto

  • 24 modelo_atualizado_recente Texto

  • 25 situacao Texto

  • 26 custo_efetivo Texto

  • 27 pais Texto

  • 28 banco Texto

  • 29 moeda Texto

  • 30 codigo_traducao Texto

  • 31 tx_indicador_economico Texto

6 - Nome da Base de Dados: demonstracoes_financeiras

  • Parametrização:

  • # Colunas Tipo

01 empresa Texto

02 data Texto

03 ecge Texto

04 macrotipo Texto

05 valor Decimal

7 - Nome da Base de Dados: atualizar_dados

  • Parametrização:

  • # Colunas Tipo

  • 01 data Data

Após finalizada a criação de todas as Bases de Dados, a próxima etapa será a criação dos Workflows, encarregados pela rotina de atualização das informações:

10
No menu lateral, acesse o módulo Workflows:
Step #10: No menu lateral, acesse o módulo Workflows:
11
Clique em Criar Workflow para iniciar o processo:
Step #11: Clique em Criar Workflow para iniciar o processo:
12
Informe o Nome do Workflow:
Step #12: Informe o Nome do Workflow:
13
Sua Descrição:
Step #13: Sua Descrição:
14
Selecione sua Origem:
Step #14: Selecione sua Origem:
15
E seu Destino como sendo Base de Dados e, em seguida, selecione a base de dados correspondente:
Step #15: E seu Destino como sendo Base de Dados e, em seguida, selecione a base de dados correspondente:
16
Faça a liberação de acesso como usuários administradores à Charline Pires, João Mano e Ester Nery:
Step #16: Faça a liberação de acesso como usuários administradores à Charline Pires, João Mano e Ester Nery:
17
E clique em Continuar:
Step #17: E clique em Continuar:
18
O primeiro passo da criação foi concluído. Em seguida, ao passar o mouse pelas opções no menu superior do Workflow criado, selecione a opção Visualizar Flow:
Step #18: O primeiro passo da criação foi concluído. Em seguida, ao passar o mouse pelas opções no menu superior do Workflow criado, selecione a opção Visualizar Flow:
19
E clique em Adicionar Etapa.
Step #19: E clique em Adicionar Etapa.
20
Informe seu Nome:
Step #20: Informe seu Nome:
21
Sua Descrição:
Step #21: Sua Descrição:
22
E selecione o tipo de Transformação que será realizada nesta etapa. Você pode digitar no campo de pesquisa para facilitar a seleção:
Step #22: E selecione o tipo de Transformação que será realizada nesta etapa. Você pode digitar no campo de pesquisa para facilitar a seleção:
23
Por fim, clique em Criar:
Step #23: Por fim, clique em Criar:
24
Clique na seta ao lado do nome do Workflow para retornar ao menu inicial:
Step #24: Clique na seta ao lado do nome do Workflow para retornar ao menu inicial:
25
Para criar os demais Workflows selecione o botão indicado no menu superior da tela:
Step #25: Para criar os demais Workflows selecione o botão indicado no menu superior da tela:

Seguem abaixo as informações de cada workflow a ser criado:

1 - Nome do Workflow: Parcelas das Dívidas

Descrição: Exportação das informações sobre as parcelas das dívidas cadastradas.

Origem: Conector

Destino: Base de Dados - Parcelas Dívidas

Nome da etapa do workflow: Exportação das parcelas das dívidas

Descrição da etapa do workflow: Obtenção das informações sobre as parcelas das dívidas cadastradas.

Transformação: Exportação das parcelas da gestão de dívidas

2 - Nome do Workflow: Movimentação Extrato Bancário

Descrição: Movimentação Extrato Bancário

Origem: Conector

Destino: Base de Dados - Movimentação Extrato Bancário

Nome da etapa do workflow: Exportação das movimentações do extrato bancário

Descrição da etapa do workflow: Obtenção dos dados do extrato bancário

Transformação: Extrato fluxo de caixa

3 - Nome do Workflow: Lançamentos Financeiros (CP e CR)

Descrição: Lançamentos Financeiros (CP e CR)

Origem: Conector

Destino: Base de Dados - Lançamentos Financeiros (CP e CR)

Nome da etapa do workflow: Exportação dos lançamentos financeiros

Descrição da etapa do workflow: Obtenção dos lançamentos financeiros de contas a pagar e receber.

Transformação: Dados sobre títulos financeiros e parcelas

4 - Nome do Workflow: Garantias das Dívidas

Descrição: Obtenção das informações sobre as garantias das dívidas cadastradas.

Origem: Conector

Destino: Base de Dados - Garantias das Dívidas

Nome da etapa do workflow: Exportação das garantias das dívidas

Descrição da etapa do workflow: Exportação das garantias das dívidas

Transformação: Exportação de contratos de garantias e dívidas

5 - Nome do Workflow: Dívidas Cadastradas

Descrição: Obtenção das informações sobre as dívidas cadastradas.

Origem: Conector

Destino: Base de Dados - Dívidas Cadastradas

Nome da etapa do workflow: Exportação de contratos de dívidas

Descrição da etapa do workflow: Exportação de contratos de dívidas e seus atributos

Transformação: Exportação de contratos de dívidas e seus atributos

6 - Nome do Workflow: Dados Demonstrações Financeiras

Descrição: Atualização dos dados das demonstrações financeiras.

Origem: Conector

Destino: Base de Dados - Dados Demonstrações Financeiras

Nome da etapa 1 do workflow: Consulta às DFs

Descrição da etapa 1 do workflow: Exportação das informações das DFs.

Transformação da etapa 1 do workflow: Gera arquivo de DFs à nível de estruturas gerenciais

26
Ao criar a primeira etapa deste Workflow clique em Parâmetros:
Step #26: Ao criar a primeira etapa deste Workflow clique em Parâmetros:
27
E insira no campo Data Inicial a primeira data de upload do ambiente do cliente.
Por exemplo, neste caso o upload iniciou em dezembro/2023, portanto foi informada a data 01/12/2023:
Step #27: E insira no campo Data Inicial a primeira data de upload do ambiente do cliente.Por exemplo, neste caso o upload iniciou em dezembro/2023, portanto foi informada a data 01/12/2023:
28
Após clicar em retornar e salvar a primeira etapa, clique no botão indicado para adicionar uma nova etapa:
Step #28: Após clicar em retornar e salvar a primeira etapa, clique no botão indicado para adicionar uma nova etapa:

As informações desta nova etapa são:

Nome da etapa 2 do workflow: Python

Descrição da etapa 2 do workflow: ...

Transformação da etapa 1 do workflow: Executar um bloco de códigos em Python

29
Informe seu Nome e Descrição, conforme as informações acima:
Step #29: Informe seu Nome e Descrição, conforme as informações acima:
30
Selecione a Transformação "Executar um bloco de códigos em Python":
Step #30: Selecione a Transformação "Executar um bloco de códigos em Python":
31
Clique em Continuar:
Step #31: Clique em Continuar:
32
Clique sobre a nova etapa adicionada:
Step #32: Clique sobre a nova etapa adicionada:
33
E selecione a opção de Editar:
Step #33: E selecione a opção de Editar:
34
Acesse a função Configurações:
Step #34: Acesse a função Configurações:
35
E, no menu superior, a opção Regras de Negócio:
Step #35: E, no menu superior, a opção Regras de Negócio:
36
Na tela apresentada, cole o código descrito logo abaixo:
Step #36: Na tela apresentada, cole o código descrito logo abaixo:

Regras de Negócio:

import pandas as pd

columns_to_keep = ['empresa', 'dt', 'ecge', 'valor', 'macro_tipo_ecge']

df_filtrado = df[columns_to_keep]

new_column_names = {

'dt': 'data',

'macro_tipo_ecge': 'macrotipo'

}

df_renomeado = df_filtrado.rename(columns=new_column_names)

# Transformando o formato da coluna 'data' para MM-YYYY

df_renomeado['data'] = pd.to_datetime(df_renomeado['data']).dt.strftime('%Y-%m')

# Atualizando o DataFrame principal

df = df_renomeado

37
E clique em Salvar Etapa:
Step #37: E clique em Salvar Etapa:
38
Em seguida, clique em Editar Depois:
Step #38: Em seguida, clique em Editar Depois:

O último Workflow a ser criado será responsável por executar todos os demais. Por este motivo suas etapas consistem na atualização de cada um dos workflows criados anteriormente.

7 - Nome do Workflow: Atualizar Dados

Descrição: Atualizar Dados

Origem: Conector

Destino: Base de Dados - Atualizar Dados

O que vai diferir dos demais workflows será na criação das etapas. Será uma etapa para cada workflow já criado, portanto, 6 etapas ao todo e faremos a referência para cada uma delas.

39
Ao adicionar uma nova etapa, após indicar seu Nome e Descrição, selecione a opção Workflow:
Step #39: Ao adicionar uma nova etapa, após indicar seu Nome e Descrição, selecione a opção Workflow:
40
E selecione o Workflow:
Step #40: E selecione o Workflow:
41
Por fim, clique em Criar:
Step #41: Por fim, clique em Criar:
42
Siga criando as novas etapas até completar a seleção de todos os Workflows:
Step #42: Siga criando as novas etapas até completar a seleção de todos os Workflows:

Etapas a serem criadas (Nome e Descrição):

  • Atualização Demonstrações Financeiras

  • Atualização CP e CR

  • Atualização Extrato Bancário

  • Atualização Dívidas

  • Atualização Parcelas Dívidas

  • Atualização Garantias dasDívidas

43
Ao final, deverá conter 7 Workflows criados conforme imagem abaixo:
Step #43: Ao final, deverá conter 7 Workflows criados conforme imagem abaixo: