
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.
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.









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:
















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

Por exemplo, neste caso o upload iniciou em dezembro/2023, portanto foi informada a data 01/12/2023:


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








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


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.




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
