BrewForge Docs

Eigene Felder für Sude

Lege eigene typisierte Felder für Sude und Sudnotizen in BrewForge an, etwa einen Link zum Laborbericht, einen pH-Wert oder eine Fassnummer.

BrewForge deckt die üblichen Braudaten ab, aber jede Brauerei erfasst noch etwas Eigenes: einen Link zum Laborbericht, das Fass, in das ein Sud ging, die Wasserquelle, eine Bewertung. Mit Eigene Felder legst du solche Felder einmal an. Sie erscheinen dann in jedem Sud (oder jeder Sudnotiz) zum Ausfüllen, und Integrationen können sie über die API lesen.

Der Tab Eigene Felder in den Einstellungen

Ein Feld anlegen

Öffne Einstellungen, wechsle zum Tab Eigene Felder und klicke auf Feld hinzufügen.

Der Dialog Neues eigenes Feld

Gib einen Namen ein, zum Beispiel „Link zum Laborbericht“. BrewForge schlägt daraus eine ID für Integrationen vor (link-zum-laborbericht). Du kannst die ID ändern, bis das Feld angelegt ist; danach steht sie fest.

Wähle den Typ und unter Gilt für, wozu das Feld gehört (siehe unten). Bei Sud-Feldern wählst du außerdem, wo es Angezeigt in wird.

Optional ergänzt du eine Einheit (bei Zahlenfeldern) und machst das Feld zum Pflichtfeld. Beschreibung, Platzhaltertext und Standardwert stehen unter Weitere Optionen.

Klicke auf Feld anlegen.

Feldtypen

FeldtypSpeichert
TextFreien Text
ZahlEine Dezimalzahl, optional mit Einheit wie pH, °C oder g/L
GanzzahlEine ganze Zahl, optional mit Einheit
Datum, Uhrzeit, Datum & UhrzeitEin Datum, eine Uhrzeit oder beides
Ja/NeinEinen Schalter
AuswahllisteEinen Wert aus einer Liste, die du festlegst (mindestens zwei Einträge)
URLEinen Link

Gilt für und Position

Gilt für legt fest, wozu das Feld gehört:

  • Sud: ein Wert pro Sud. Die Position bestimmt, in welchem Teil des Suds das Feld erscheint: Suddetails, Brautag, Gärung, Abfüllung oder Verkostung.
  • Sudnotiz: ein Wert pro Sudnotiz, den du beim Schreiben der Notiz ausfüllst. Sudnotiz-Felder haben keine Position.

Ein Pflichtfeld wirkt je nach Art unterschiedlich. Ein Sud-Feld wird hervorgehoben, solange es leer ist. Ein Sudnotiz-Feld muss ausgefüllt sein, bevor die Notiz gespeichert werden kann.

Ein Feld ändern

Klicke ein Feld in der Liste an, um es zu bearbeiten. Name, Beschreibung, Position, Einheit, Platzhalter, Standardwert und Pflichtfeld kannst du ändern. Typ, Gilt für und ID für Integrationen stehen fest, sobald das Feld existiert, weil Werte und Integrationen davon abhängen.

Gespeicherte Einträge einer Auswahlliste sind schreibgeschützt. Zum Umbenennen fügst du den neuen Eintrag hinzu und entfernst dann den alten. Beim Entfernen zeigt BrewForge, wie viele Sude und Sudnotizen den Eintrag verwenden. Bereits erfasste Werte bleiben lesbar, für neue Werte steht der Eintrag aber nicht mehr zur Auswahl.

Archivieren, wiederherstellen und löschen

  • Archivieren (im Bearbeiten-Dialog) blendet ein Feld in deinen Suden aus, ohne etwas zu löschen. Archivierte Felder findest du unter N archiviert am Ende des Tabs, wo du sie Wiederherstellen kannst.
  • Endgültig löschen (Löschen… neben einem archivierten Feld) lassen sich nur archivierte Felder. BrewForge zeigt, wie viele Sude und Sudnotizen einen Wert haben, und du bestätigst, indem du die ID des Felds eintippst. Die Definition und alle erfassten Werte werden gelöscht, und die ID wird wieder frei.

Wenn eine Integration noch die ID eines gelöschten Felds nutzt und du später ein neues Feld mit derselben ID anlegst, liest die Integration die Daten des neuen Felds.

Eigene Felder in der API

Jedes Feld wird über seine ID für Integrationen angesprochen. API-Token mit der Berechtigung custom-fields:read können die Felddefinitionen auflisten. Siehe API-Token und die API-Referenz (auf Englisch).

Auf dieser Seite