Pular para o conteúdo
Toda a documentação

O Que É a Seção de Banco de Dados?

Modelos financeiros precisam de dados históricos como base. Esses dados normalmente residem em um arquivo externo -- uma pasta de trabalho Excel, uma exportação CSV de um sistema ERP ou um extrato estruturado de dados. A seção de Banco de Dados informa ao motor do modelo como ler esses dados externos, mapeando os títulos de coluna do seu arquivo de dados para os papéis semânticos que o modelo compreende.

Pense nela como uma camada de tradução: seu arquivo de dados pode chamar uma coluna de "Descricao da Conta" enquanto o motor do modelo espera "Account Description." A seção de Banco de Dados faz essa ponte.

Os Nove Mapeamentos de Coluna

Cada mapeamento corresponde a um papel específico que o motor do modelo precisa localizar no seu arquivo de dados. O motor busca esses títulos de coluna na linha de cabeçalho dos dados importados.

Registro

Um identificador sequencial de linha. O modelo usa isso para rastrear registros individuais de dados e manter a ordem de importação. Na maioria das exportações de dados, isso é simplesmente um número de linha ou ID de registro.

Fonte

Identifica a qual conjunto de fonte de dados um registro pertence (ex.: "Orçamento", "Previsão", "Realizado"). Esta coluna se vincula à seção de Fontes da especificação. Se seu arquivo de dados contém registros de múltiplas fontes, esta coluna informa ao motor como separá-los.

Incluir

Uma coluna de marcação (tipicamente "Sim"/"Não" ou "1"/"0") que determina se um registro deve ser incluído no modelo. Isso oferece uma forma simples de filtrar dados sem excluir linhas do arquivo de origem.

Período

O período de tempo ao qual um registro pertence (ex.: "2024", "T1 2025", "Jan-2024"). Esta coluna se vincula à seção de Períodos da especificação. Os valores devem corresponder aos identificadores de período definidos lá.

Unidade

A unidade de negócio à qual um registro está associado. Esta coluna se vincula à seção de Unidades de Negócio. Para modelos de entidade única, todos os registros normalmente têm o mesmo valor de unidade.

Código da Conta

O código hierárquico da conta (ex.: "3.01.01") que identifica a qual conta um registro pertence. Esta é a chave primária que vincula os dados importados ao plano de contas definido na seção de Contas.

Descrição da Conta

Uma descrição legível da conta. Embora o modelo dependa principalmente do Código da Conta para correspondência, a descrição fornece contexto e é utilizada na rotulagem de relatórios.

Valor

O valor monetário ou numérico do registro. Este é o ponto de dados principal -- o número financeiro real sendo importado no modelo.

Valor de Análise

Uma coluna de valor auxiliar utilizada para desdobramentos analíticos, acompanhamento de variações ou cálculos suplementares. Nem todos os arquivos de dados incluem esta coluna; quando ausente, ela pode ser deixada sem mapeamento.

Padrões Dependentes de Idioma

Ao abrir a seção de Banco de Dados pela primeira vez, os títulos de coluna são pré-preenchidos com padrões que correspondem ao idioma selecionado na Configuração Geral. Por exemplo:

  • Em Inglês, a coluna de Período tem como padrão "Period" e Código da Conta tem como padrão "Account Code."
  • Em Português, as mesmas colunas têm como padrão "Periodo" e "Codigo da Conta."

Esses padrões correspondem ao formato de exportação padrão de sistemas contábeis comuns em cada idioma. Se seu arquivo de dados utiliza esses nomes padrão, você não precisa alterar nada.

O Botão Redefinir

Se você personalizou os mapeamentos de coluna e deseja retornar aos padrões dependentes de idioma, use o botão Redefinir. Isso sobrescreve todos os nove mapeamentos com os valores padrão para o idioma atualmente selecionado.

Atenção: A redefinição não pode ser desfeita. Se você configurou cuidadosamente mapeamentos personalizados, anote-os antes de redefinir.

Quando Personalizar

A maioria dos usuários não precisará alterar os mapeamentos padrão. A personalização é necessária quando:

  • Seu arquivo de dados utiliza nomes de coluna não padrão. Por exemplo, se seu ERP exporta "Conta" em vez de "Codigo da Conta" para códigos de conta, atualize o mapeamento de Código da Conta.
  • Seu arquivo de dados está em um idioma diferente do modelo. Se você está construindo um modelo em português mas importando dados de um sistema em inglês, ajuste os mapeamentos para corresponder aos cabeçalhos de coluna em inglês no arquivo de dados.
  • Seu arquivo de dados utiliza cabeçalhos abreviados ou codificados. Alguns sistemas exportam colunas com códigos curtos (ex.: "ACCT_CD" em vez de "Account Code"). Mapeie-os para os papéis semânticos corretos.
  • Você tem colunas extras ou reordenadas. O motor busca pelo título da coluna, não pela posição, então a ordem das colunas não importa. Mas os títulos devem corresponder exatamente.

Boas Práticas

  1. Verifique os cabeçalhos do seu arquivo de dados primeiro. Abra seu arquivo de dados e anote os títulos exatos das colunas antes de configurar esta seção.
  2. Combine os títulos exatamente. O mapeamento é sensível a maiúsculas/minúsculas e espaços. "Account Code" não é o mesmo que "account code" ou "Account Code" (espaço duplo).
  3. Defina o idioma antes de configurar o Banco de Dados. Se você alterar o idioma depois, os padrões mudarão, o que pode sobrescrever seus mapeamentos personalizados.