Funzionalità dell'interfaccia

L'interfaccia web di beancount.io (basata su Fava) fornisce una suite completa di strumenti per gestire, interrogare e visualizzare i tuoi dati finanziari. Questa guida copre le sue funzionalità principali, dalla gestione dei dati di base alla personalizzazione avanzata e alla risoluzione dei problemi.

Esplora il registro live →

1. Modifica e Gestione dei Dati​

L'Editor Integrato​

L'interfaccia include un potente editor di testo per apportare modifiche dirette ai tuoi file Beancount. Le funzionalità principali includono:

• Auto-completamento: Premi Tab per completare nomi di conti, beneficiari, tag e collegamenti.

• Scorciatoie da Tastiera:

  • Ctrl+Spazio: Attiva l'auto-completamento.
  • Ctrl+/: Commenta o decommenta le righe.
  • Ctrl+D: Duplica la riga corrente.
  • Alt+Freccia Su/Giù: Sposta la riga corrente verso l'alto o il basso.

• Posizionamento Intelligente del Cursore: Utilizza l'opzione $insert-entry$ nel tuo file per posizionare automaticamente il cursore sulla transazione più recente per un conto specifico all'apertura dell'editor.

  option "insert-entry" "Spese:Cibo:Ristoranti"

Aggiunta di Transazioni​

Fai clic sul pulsante + (o premi n) per aprire il modulo di transazione.

• Inserimento Rapido: Il modulo suggerisce conti recenti e ricorda gli importi comuni per i beneficiari.

• Tag/Collegamenti Inline: Aggiungi tag e collegamenti direttamente nel campo della descrizione (es., Pranzo #cibo ^ricevuta-001).

• Modelli di Transazione: Crea voci con data futura con un tag #template. Puoi quindi utilizzare il modulo per trovarle e compilarle.

  2099-01-01 * "Pagamento Affitto Mensile" #template
      Spese:Abitazione:Affitto      1500.00 USD
      Attività:ContoCorrente       -1500.00 USD

2. Gestione dei Documenti​

Collega in modo efficiente ricevute, estratti conto e altri file alle tue transazioni.

• Caricamento tramite Trascinamento:

  • Trascina un file su un nome di conto per salvarlo nella cartella di quel conto.
  • Trascina un file su una transazione nel giornale per collegarlo direttamente.

• Archiviazione dei Documenti: I file vengono salvati nella cartella specificata dalla direttiva $option "documents" "percorso/ai/tuoi/documenti"$ nel tuo file Beancount.

• Collegamento Automatico: Beancount può scoprire e collegare automaticamente i documenti alle transazioni. Abilita questa funzione con i seguenti plugin:

  plugin "fava.plugins.link_documents"
  plugin "fava.plugins.tag_discovered_documents"

3. Query e Analisi con BQL​

La pagina Query ti consente di eseguire query in linguaggio BQL (Beancount Query Language), simile allo strumento da riga di comando bean-query.

• Visualizzazione: I risultati delle query vengono automaticamente renderizzati come tabelle. Se la tua query restituisce due colonne (come data/stringa e numero), l'interfaccia genererà anche un grafico a linee, a barre o ad albero.
• Esportazione: Scarica qualsiasi risultato di query come file CSV.

Esempi Pratici di Query​

• Riepilogo Spese Mensili:

  SELECT account, SUM(position) AS totale
  FROM postings
  WHERE account ~ '^Spese' AND date >= 2024-01-01 AND date < 2024-02-01
  GROUP BY account
  ORDER BY totale DESC;

• Entrate vs. Spese per Mese:

  SELECT YEAR(date) as anno, MONTH(date) as mese,
         SUM(IIF(account ~ '^Entrate', -position, 0)) as entrate,
         SUM(IIF(account ~ '^Spese', position, 0)) as spese
  FROM postings
  GROUP BY anno, mese
  ORDER BY anno, mese;

4. Personalizzazione e Flusso di Lavoro​

Personalizzazione della Visualizzazione​

Personalizza la visualizzazione dell'interfaccia con queste opzioni nel tuo file Beancount:

• Visibilità dei Conti: Controlla quali conti appaiono nella barra laterale.

  option "show-closed-accounts" "false"
  option "show-accounts-with-zero-balance" "false"
  option "collapse-pattern" "Attività:Investimenti:.*"

• Indicatori di Aggiornamento: Punti colorati accanto ai conti mostrano il loro stato (verde per saldo superato, rosso per saldo fallito, giallo per nessuna verifica recente del saldo). Abilita questa funzione nella direttiva open di un conto:

  2020-01-01 open Attività:ContoCorrente   fava-uptodate-indication: "TRUE"

Collegamenti nella Barra Laterale​

Aggiungi collegamenti personalizzati a report utilizzati di frequente o viste filtrate nella barra laterale.

2024-01-01 custom "fava-sidebar-link" "Spese di Questo Mese" "/income_statement/?time=month"
2024-01-01 custom "fava-sidebar-link" "Tutti i Documenti" "/journal/?show=document"

Configurazione Generale​

• Più File: Se carichi più file .beancount, puoi passare da uno all'altro utilizzando il menu a discesa in alto a sinistra.
• Editor Esterno: Configura l'interfaccia per aprire i file direttamente nel tuo editor locale utilizzando l'opzione $use-external-editor$ e un gestore di URL.
• Lingua: Imposta la lingua dell'interfaccia con l'opzione $language$, oppure lascia che venga rilevata automaticamente dal tuo browser.
• Esportazione: Esporta qualsiasi vista filtrata del giornale in formato Beancount utilizzando il pulsante Esporta.

5. Prestazioni e Risoluzione dei Problemi​

Gestione di File di Grandi Dimensioni​

Per registri con migliaia di transazioni, migliora le prestazioni:

• Utilizzo di Include: Dividi il tuo registro in più file per anno o mese e utilizza la direttiva include.

  include "conti.beancount"
  include "transazioni/2023.beancount"
  include "transazioni/2024.beancount"

• Filtri: Utilizza opzioni di tempo e filtro per limitare la quantità di dati visualizzati contemporaneamente.

Problemi Comuni e Soluzioni​

• Interfaccia che non si Carica:

  1. Controlla il tuo file per errori di sintassi utilizzando lo strumento da riga di comando bean-check.
  2. Cerca messaggi di errore in fondo alla pagina web.
  3. Svuota la cache del browser.

• Prestazioni Lente:

  1. Riduci l'intervallo di date attivo nell'interfaccia.
  2. Semplifica le query BQL complesse.

• Errori di Configurazione: Assicurati che i nomi delle opzioni e i tipi di direttive personalizzate siano racchiusi tra virgolette.

  ; Corretto
  option "documents" "/percorso/ai/documenti"
  custom "fava-sidebar-link" "Etichetta" "URL"
   
  ; Errato (causerà errori)
  option documents "/percorso/ai/documenti"
  custom fava-sidebar-link "Etichetta" "URL"