# 18. FilaManDB – Community-Datenbank

**URL (Admin-Import):** `http(s)://url/admin/system/filamentdb-import`

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.

FilaMan bietet zwei Wege, diese Datenbank zu nutzen:

1. **Massen-Import** (Admin-Bereich) – Viele Hersteller und Filamente auf einmal importieren
2. **Inline-Lookup** (in Formularen) – Einzelne Einträge direkt beim Erstellen/Bearbeiten aus der FilaManDB laden

> **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.

---

## 18.1 Massen-Import (Admin-Bereich)

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.

### Schritt 1: Hersteller auswählen

1. Klicken Sie auf **„Vorschau laden"** – FilaMan lädt die verfügbaren Daten aus der FilaManDB (Hersteller, Materialien, Farben, Filamente, Spulenprofile)
2. Eine **Zusammenfassung** zeigt die verfügbare Datenmenge an
3. Optional: Über den **Material-Filter** können Sie die Herstellerliste auf bestimmte Materialtypen einschränken (z. B. nur Hersteller, die PLA anbieten)
4. Wählen Sie die gewünschten Hersteller per Checkbox aus
   - Bereits in FilaMan vorhandene Hersteller werden mit **„Already exists"** markiert
   - Buttons: **„Select all"**, **„Select all new"** (nur neue), **„Deselect all"**

### Schritt 2: Filamente auswählen

1. Nach der Herstellerauswahl werden die zugehörigen Filamente geladen
2. Für jeden ausgewählten Hersteller wird die Liste der verfügbaren Filamente angezeigt
3. Wählen Sie die gewünschten Filamente per Checkbox aus

### Schritt 3: Import-Einstellungen & Ausführung

**Spulenprofil-Ziel:** Wählen Sie, wo die Spulenprofil-Informationen (Leergewicht, Durchmesser, Breite, Material) gespeichert werden sollen:

| Option | Beschreibung |
|--------|--------------|
| **Am Filament** | Spulendaten werden an jedem Filament gespeichert |
| **Am Hersteller** | Spulendaten werden einmalig am Hersteller gespeichert |
| **Beides** | Spulendaten werden sowohl am Filament als auch am Hersteller gespeichert |

Klicken Sie auf **„Import starten"**, um den Import durchzuführen. Nach Abschluss wird eine **Ergebnis-Zusammenfassung** angezeigt:

| Kategorie | Anzeige |
|-----------|---------|
| **Hersteller** | Erstellt / Übersprungen / Fehlgeschlagen |
| **Logos** | Heruntergeladen / Fehlgeschlagen |
| **Farben** | Erstellt / Übersprungen |
| **Filamente** | Erstellt / Übersprungen / Fehlgeschlagen |

Falls Warnungen oder Fehler aufgetreten sind, werden diese ebenfalls angezeigt.

---

## 18.2 Vorhandene Filamente aktualisieren

Wenn bereits Filamente importiert wurden und sich Daten in der FilaManDB geändert haben, können diese aktualisiert werden:

1. Aktivieren Sie den Toggle **„Vorhandene aktualisieren"** im Import-Assistenten
2. FilaMan berechnet automatisch einen **Diff** (Vergleich) zwischen den lokalen und den aktuellen FilaManDB-Daten
3. Änderungen werden als Tabelle angezeigt: **Feldname**, **Aktueller Wert**, **Neuer Wert**
4. Nur tatsächlich geänderte Filamente werden aktualisiert

---

## 18.3 Fuzzy-Matching

Beim Import erkennt FilaMan bereits vorhandene Filamente auch dann, wenn der Name **leicht abweicht** (z. B. durch Tippfehler, unterschiedliche Schreibweisen oder fehlende Sonderzeichen).

**So funktioniert es:**
- Die Namen werden normalisiert (Kleinschreibung, Sonderzeichen entfernt) und in einzelne Wörter (Tokens) aufgeteilt
- Zwei Namen gelten als übereinstimmend, wenn mindestens **75 %** der Wörter übereinstimmen
- Fuzzy-Treffer werden im Import visuell hervorgehoben

> **Beispiel:** „Prusament PLA Galaxy Black" und „Prusament PLA Galaxy-Black 1.75mm" werden als übereinstimmend erkannt.

---

## 18.4 Inline-Lookup in Formularen

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:

### Hersteller erstellen / bearbeiten

Beim Erstellen eines neuen Herstellers können Sie zwischen zwei Modi wählen:
- **„Aus FilaManDB erstellen"** – Suchen Sie in der Community-Datenbank und übernehmen Sie Name, Website und Logo
- **„Manuell erstellen"** – Geben Sie die Daten wie bisher von Hand ein

Auch beim **Bearbeiten** eines vorhandenen Herstellers steht der Button **„Aus FilaManDB laden"** zur Verfügung, um die Daten zu aktualisieren.

→ Siehe [Kapitel 5: Hersteller](/Docs/De/05-Hersteller)

### Filament erstellen / bearbeiten

Nach Auswahl eines Herstellers erscheint der Button **„Aus FilaManDB laden"**. Damit können Sie:
- Ein Filament in der Community-Datenbank suchen
- Alle Felder werden automatisch vorausgefüllt (Bezeichnung, Material, Durchmesser, Farben, Preis usw.)
- Falls der Hersteller oder Farben noch nicht lokal existieren, werden diese automatisch angelegt

→ Siehe [Kapitel 6: Filamente](/Docs/De/06-Filamente)

### Spule erstellen / bearbeiten

Beim Erstellen oder Bearbeiten einer Spule steht der Button **„Aus FilaManDB laden"** für die **Spulenprofil-Daten** zur Verfügung:
- Suchen Sie nach einem Spulenprofil (z. B. nach Hersteller oder Material)
- Leergewicht, Durchmesser und Breite werden automatisch übernommen
- Falls verfügbar, wird ein Bild des Spulenprofils angezeigt

→ Siehe [Kapitel 7: Spulen](/Docs/De/07-Spulen)

---

> **Hinweis:** Alle FilaManDB-Buttons und -Funktionen werden nur angezeigt, wenn das FilamentDB-Plugin unter [Admin → System](/Docs/De/11-Admin) aktiviert ist.

---

← [Zurück: Plugin: Bambuddy](/Docs/De/17-Plugin-Bambuddy) | [Weiter: Installation auf dem Raspberry Pi →](/Docs/De/20-Installation-Raspberry-Pi)
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9