Blame

240011 Manuel Weiser 2026-04-08 20:25:37
docs: Add FilaManDB integration details and update related sections in user manuals
1
# 18. FilaManDB – Community-Datenbank
2
3
**URL (Admin-Import):** `http(s)://url/admin/system/filamentdb-import`
4
5
Die **FilaManDB** ist eine öffentliche Community-Datenbank unter [db.filaman.app](https://db.filaman.app), die Filamentdaten zahlreicher Hersteller enthält – inklusive Materialien, Farben, Spulenprofile und Logos.
6
7
FilaMan bietet zwei Wege, diese Datenbank zu nutzen:
8
9
1. **Massen-Import** (Admin-Bereich) – Viele Hersteller und Filamente auf einmal importieren
10
2. **Inline-Lookup** (in Formularen) – Einzelne Einträge direkt beim Erstellen/Bearbeiten aus der FilaManDB laden
11
12
> **Voraussetzung:** Das eingebaute Plugin **„FilamentDB Import"** muss unter [Admin → System](/Docs/De/11-Admin) aktiviert sein. Es handelt sich um ein Builtin-Plugin, das nicht deinstalliert werden kann.
13
14
---
15
16
## 18.1 Massen-Import (Admin-Bereich)
17
18
Der Massen-Import ist ein **3-Schritt-Assistent** im Admin-Bereich, über den sich große Mengen an Hersteller-, Filament- und Farbdaten aus der FilaManDB importieren lassen.
19
20
### Schritt 1: Hersteller auswählen
21
22
1. Klicken Sie auf **„Vorschau laden"** – FilaMan lädt die verfügbaren Daten aus der FilaManDB (Hersteller, Materialien, Farben, Filamente, Spulenprofile)
23
2. Eine **Zusammenfassung** zeigt die verfügbare Datenmenge an
24
3. Optional: Über den **Material-Filter** können Sie die Herstellerliste auf bestimmte Materialtypen einschränken (z. B. nur Hersteller, die PLA anbieten)
25
4. Wählen Sie die gewünschten Hersteller per Checkbox aus
26
- Bereits in FilaMan vorhandene Hersteller werden mit **„Already exists"** markiert
27
- Buttons: **„Select all"**, **„Select all new"** (nur neue), **„Deselect all"**
28
29
### Schritt 2: Filamente auswählen
30
31
1. Nach der Herstellerauswahl werden die zugehörigen Filamente geladen
32
2. Für jeden ausgewählten Hersteller wird die Liste der verfügbaren Filamente angezeigt
33
3. Wählen Sie die gewünschten Filamente per Checkbox aus
34
35
### Schritt 3: Import-Einstellungen & Ausführung
36
37
**Spulenprofil-Ziel:** Wählen Sie, wo die Spulenprofil-Informationen (Leergewicht, Durchmesser, Breite, Material) gespeichert werden sollen:
38
39
| Option | Beschreibung |
40
|--------|--------------|
41
| **Am Filament** | Spulendaten werden an jedem Filament gespeichert |
42
| **Am Hersteller** | Spulendaten werden einmalig am Hersteller gespeichert |
43
| **Beides** | Spulendaten werden sowohl am Filament als auch am Hersteller gespeichert |
44
45
Klicken Sie auf **„Import starten"**, um den Import durchzuführen. Nach Abschluss wird eine **Ergebnis-Zusammenfassung** angezeigt:
46
47
| Kategorie | Anzeige |
48
|-----------|---------|
49
| **Hersteller** | Erstellt / Übersprungen / Fehlgeschlagen |
50
| **Logos** | Heruntergeladen / Fehlgeschlagen |
51
| **Farben** | Erstellt / Übersprungen |
52
| **Filamente** | Erstellt / Übersprungen / Fehlgeschlagen |
53
54
Falls Warnungen oder Fehler aufgetreten sind, werden diese ebenfalls angezeigt.
55
56
---
57
58
## 18.2 Vorhandene Filamente aktualisieren
59
60
Wenn bereits Filamente importiert wurden und sich Daten in der FilaManDB geändert haben, können diese aktualisiert werden:
61
62
1. Aktivieren Sie den Toggle **„Vorhandene aktualisieren"** im Import-Assistenten
63
2. FilaMan berechnet automatisch einen **Diff** (Vergleich) zwischen den lokalen und den aktuellen FilaManDB-Daten
64
3. Änderungen werden als Tabelle angezeigt: **Feldname**, **Aktueller Wert**, **Neuer Wert**
65
4. Nur tatsächlich geänderte Filamente werden aktualisiert
66
67
---
68
69
## 18.3 Fuzzy-Matching
70
71
Beim Import erkennt FilaMan bereits vorhandene Filamente auch dann, wenn der Name **leicht abweicht** (z. B. durch Tippfehler, unterschiedliche Schreibweisen oder fehlende Sonderzeichen).
72
73
**So funktioniert es:**
74
- Die Namen werden normalisiert (Kleinschreibung, Sonderzeichen entfernt) und in einzelne Wörter (Tokens) aufgeteilt
75
- Zwei Namen gelten als übereinstimmend, wenn mindestens **75 %** der Wörter übereinstimmen
76
- Fuzzy-Treffer werden im Import visuell hervorgehoben
77
78
> **Beispiel:** „Prusament PLA Galaxy Black" und „Prusament PLA Galaxy-Black 1.75mm" werden als übereinstimmend erkannt.
79
80
---
81
82
## 18.4 Inline-Lookup in Formularen
83
84
Neben dem Massen-Import bietet FilaMan auch die Möglichkeit, **einzelne Einträge direkt in den Formularen** aus der FilaManDB zu laden. Diese Funktion ist auf folgenden Seiten verfügbar:
85
86
### Hersteller erstellen / bearbeiten
87
88
Beim Erstellen eines neuen Herstellers können Sie zwischen zwei Modi wählen:
89
- **„Aus FilaManDB erstellen"** – Suchen Sie in der Community-Datenbank und übernehmen Sie Name, Website und Logo
90
- **„Manuell erstellen"** – Geben Sie die Daten wie bisher von Hand ein
91
92
Auch beim **Bearbeiten** eines vorhandenen Herstellers steht der Button **„Aus FilaManDB laden"** zur Verfügung, um die Daten zu aktualisieren.
93
94
→ Siehe [Kapitel 5: Hersteller](/Docs/De/05-Hersteller)
95
96
### Filament erstellen / bearbeiten
97
98
Nach Auswahl eines Herstellers erscheint der Button **„Aus FilaManDB laden"**. Damit können Sie:
99
- Ein Filament in der Community-Datenbank suchen
100
- Alle Felder werden automatisch vorausgefüllt (Bezeichnung, Material, Durchmesser, Farben, Preis usw.)
101
- Falls der Hersteller oder Farben noch nicht lokal existieren, werden diese automatisch angelegt
102
103
→ Siehe [Kapitel 6: Filamente](/Docs/De/06-Filamente)
104
105
### Spule erstellen / bearbeiten
106
107
Beim Erstellen oder Bearbeiten einer Spule steht der Button **„Aus FilaManDB laden"** für die **Spulenprofil-Daten** zur Verfügung:
108
- Suchen Sie nach einem Spulenprofil (z. B. nach Hersteller oder Material)
109
- Leergewicht, Durchmesser und Breite werden automatisch übernommen
110
- Falls verfügbar, wird ein Bild des Spulenprofils angezeigt
111
112
→ Siehe [Kapitel 7: Spulen](/Docs/De/07-Spulen)
113
114
---
115
116
> **Hinweis:** Alle FilaManDB-Buttons und -Funktionen werden nur angezeigt, wenn das FilamentDB-Plugin unter [Admin → System](/Docs/De/11-Admin) aktiviert ist.
117
118
---
119
120
← [Zurück: Plugin: Bambuddy](/Docs/De/17-Plugin-Bambuddy) | [Weiter: Installation auf dem Raspberry Pi →](/Docs/De/20-Installation-Raspberry-Pi)