Een Handleiding voor de beancount.io Webinterface

De beancount.io webinterface (aangedreven door Fava) biedt een uitgebreide set tools voor het beheren, opvragen en visualiseren van uw financiële gegevens. Deze handleiding behandelt de belangrijkste functies, van basisgegevensinvoer tot geavanceerde aanpassing en probleemoplossing.

1. Bewerken en Gegevensinvoer

De Ingebouwde Editor

De interface bevat een krachtige teksteditor voor het rechtstreeks aanbrengen van wijzigingen in uw Beancount-bestanden. Belangrijkste kenmerken zijn:

• Auto-aanvulling: Druk op Tab om accountnamen, betalingsgegevens, tags en links te voltooien.

• Sneltoetsen:

  • Ctrl+Space: Auto-aanvulling activeren.
  • Ctrl+/: Regels commentariëren of uncommentariëren.
  • Ctrl+D: Dupliceer de huidige regel.
  • Alt+Omhoog/Omlaag: Verplaats de huidige regel omhoog of omlaag.

• Slimme Cursorplaatsing: Gebruik de $insert-entry$ optie in uw bestand om de cursor automatisch te plaatsen bij de meest recente vermelding voor een specifiek account wanneer de editor wordt geopend.

  option "insert-entry" "Expenses:Food:Dining-Out"

Transacties Toevoegen

Klik op de + knop (of druk op n) om het transactieformulier te openen.

• Snelle Invoer: Het formulier stelt recente accounts voor en onthoudt veelvoorkomende bedragen voor betalingsgegevens.

• Inline Tags/Links: Voeg tags en links rechtstreeks toe in het narratieveld (bijv. Lunch #food ^receipt-001).

• Transactiesjablonen: Maak toekomstige vermeldingen met een #template tag. U kunt vervolgens het formulier gebruiken om ze te vinden en in te vullen.

  2099-01-01 * "Maandelijkse Huurbetaling" #template
      Expenses:Housing:Rent      1500.00 USD
      Assets:Checking           -1500.00 USD

2. Documentbeheer

Link efficiënt bonnen, afschriften en andere bestanden aan uw transacties.

• Uploaden via Slepen-en-Neerzetten:

  • Sleep een bestand naar een accountnaam om het op te slaan in de map van dat account.
  • Sleep een bestand naar een transactie in het journaal om het rechtstreeks te koppelen.

• Documentopslag: Bestanden worden opgeslagen in de map die is opgegeven door de $option "documents" "path/to/your/documents"$ richtlijn in uw Beancount-bestand.

• Automatische Koppeling: Beancount kan automatisch documenten ontdekken en koppelen aan transacties. Schakel dit in met de volgende plugins:

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

3. Opvragen en Analyse met BQL

De Query pagina stelt u in staat om Beancount Query Language (BQL) queries uit te voeren, vergelijkbaar met de command-line bean-query tool.

• Visualisatie: Query resultaten worden automatisch weergegeven als tabellen. Als uw query twee kolommen retourneert (zoals een datum/string en een getal), zal de interface ook een lijn-, staaf- of treemap-diagram genereren.
• Export: Download elk query resultaat als een CSV-bestand.

Praktische Query Voorbeelden

• Maandelijks Overzicht van Uitgaven:

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

• Inkomsten vs. Uitgaven per Maand:

  SELECT YEAR(date) as year, MONTH(date) as month,
         SUM(IIF(account ~ '^Income', -position, 0)) as income,
         SUM(IIF(account ~ '^Expenses', position, 0)) as expenses
  FROM postings
  GROUP BY year, month
  ORDER BY year, month;

4. Aanpassing en Workflow

De Weergave Aanpassen

Pas de weergave van de interface aan met deze opties in uw Beancount-bestand:

• Accountzichtbaarheid: Bepaal welke accounts in de zijbalk verschijnen.

  option "show-closed-accounts" "false"
  option "show-accounts-with-zero-balance" "false"
  option "collapse-pattern" "Assets:Investments:.*"

• Up-to-Date Indicatoren: Gekleurde stippen naast accounts tonen hun status (groen voor een kloppend saldo, rood voor mislukt, geel voor geen recente saldocheck). Schakel dit in in de open richtlijn van een account:

  2020-01-01 open Assets:Checking   fava-uptodate-indication: "TRUE"

Zijbalk Links

Voeg aangepaste links toe aan veelgebruikte rapporten of gefilterde weergaven in de zijbalk.

2024-01-01 custom "fava-sidebar-link" "Deze Maand Uitgaven" "/income_statement/?time=month"
2024-01-01 custom "fava-sidebar-link" "Alle Documenten" "/journal/?show=document"

Algemene Configuratie

• Meerdere Bestanden: Als u meerdere .beancount bestanden laadt, kunt u tussen deze bestanden schakelen met behulp van de dropdown linksboven.
• Externe Editor: Configureer de UI om bestanden rechtstreeks in uw lokale editor te openen met behulp van de $use-external-editor$ optie en een URL-handler.
• Taal: Stel de interfacetaal in met de $language$ optie, of laat deze automatisch detecteren vanuit uw browser.
• Exporteren: Exporteer elke gefilterde journaalweergave in Beancount-formaat met behulp van de Export knop.

5. Prestaties en Probleemoplossing

Omgaan met Grote Bestanden

Voor grootboeken met duizenden transacties, kunt u de prestaties verbeteren door:

• Includes te Gebruiken: Splits uw grootboek in meerdere bestanden per jaar of maand en gebruik de include richtlijn.

  include "accounts.beancount"
  include "transactions/2023.beancount"
  include "transactions/2024.beancount"

• Filteren: Gebruik tijd- en filteropties om de hoeveelheid weergegeven gegevens te beperken.

Veelvoorkomende Problemen en Oplossingen

• Interface Laadt Niet:

  1. Controleer uw bestand op syntaxisfouten met behulp van de bean-check command-line tool.
  2. Zoek naar foutmeldingen onder aan de webpagina.
  3. Leeg uw browsercache.

• Trage Prestaties:

  1. Verminder het actieve datumbereik in de UI.
  2. Vereenvoudig complexe BQL-queries.

• Configuratiefouten: Zorg ervoor dat optienamen en aangepaste richtlijntypes tussen aanhalingstekens staan.

  ; Correct
  option "documents" "/path/to/docs"
  custom "fava-sidebar-link" "Label" "URL"
  
  ; Incorrect (zal fouten veroorzaken)
  option documents "/path/to/docs"
  custom fava-sidebar-link "Label" "URL"