145 lines
4.0 KiB
Markdown
145 lines
4.0 KiB
Markdown
# LibreBooking Config Node
|
|
|
|
Der Config Node ermöglicht die zentrale Konfiguration von Standardwerten, die in allen LibreBooking Operationen verwendet werden können.
|
|
|
|
## Überblick
|
|
|
|
Der LibreBooking Config Credential ist **optional** und dient dazu:
|
|
- Standardwerte zentral zu definieren
|
|
- Wiederholte Eingaben zu vermeiden
|
|
- Konsistente Einstellungen sicherzustellen
|
|
|
|
## Installation
|
|
|
|
Der Config Node wird automatisch mit der LibreBooking Node installiert. Er erscheint unter **Credentials** als "LibreBooking Config".
|
|
|
|
## Konfiguration
|
|
|
|
### 1. Config Credential anlegen
|
|
|
|
1. Gehen Sie zu **Credentials** in n8n
|
|
2. Klicken Sie auf **Add Credential**
|
|
3. Suchen Sie nach **LibreBooking Config**
|
|
4. Klicken Sie auf **Create**
|
|
|
|
### 2. Standardwerte definieren
|
|
|
|
| Einstellung | Beschreibung | Standard |
|
|
|-------------|--------------|----------|
|
|
| Standard Nutzungsbedingungen Akzeptiert | Vorauswahl für termsAccepted | `true` |
|
|
| Standard Teilnahme Erlauben | Vorauswahl für allowParticipation | `false` |
|
|
| Standard Ressourcen-ID | Standard-Ressource für Reservierungen | `0` (keine) |
|
|
| Standard Benutzer-ID | Standard-Benutzer für Reservierungen | `0` (angemeldeter Benutzer) |
|
|
| Standard Zeitplan-ID | Standard-Zeitplan für Ressourcen | `0` (keine) |
|
|
| Standard Zeitzone | Zeitzone für neue Benutzer | `Europe/Berlin` |
|
|
| Standard Sprache | Sprache für neue Benutzer | `de_de` |
|
|
|
|
### 3. Config mit Node verbinden
|
|
|
|
1. Öffnen Sie einen LibreBooking Node
|
|
2. Bei Ressourcen wie Reservierung, Ressource, Benutzer oder Konto erscheint ein optionales Credential-Feld für **LibreBooking Config**
|
|
3. Wählen Sie Ihre Config Credential aus
|
|
|
|
## Verwendung
|
|
|
|
### Beispiel: Reservierung erstellen
|
|
|
|
**Ohne Config Node:**
|
|
```
|
|
- Ressourcen-ID: 1
|
|
- Startzeit: ...
|
|
- Endzeit: ...
|
|
- Nutzungsbedingungen Akzeptiert: true (manuell)
|
|
```
|
|
|
|
**Mit Config Node:**
|
|
```
|
|
- Ressourcen-ID: 1 (oder aus Config wenn 0 = übernehmen)
|
|
- Startzeit: ...
|
|
- Endzeit: ...
|
|
- Nutzungsbedingungen Akzeptiert: (automatisch aus Config)
|
|
```
|
|
|
|
### Priorität der Werte
|
|
|
|
1. **Höchste Priorität**: Werte direkt im Node eingegeben
|
|
2. **Niedrigere Priorität**: Werte aus dem Config Node
|
|
3. **Fallback**: Eingebaute Standardwerte
|
|
|
|
## Anwendungsfälle
|
|
|
|
### 1. Automatisierte Buchungen
|
|
|
|
Wenn Sie einen Workflow haben, der automatisch Buchungen erstellt:
|
|
|
|
```
|
|
Config Node:
|
|
- Standard Nutzungsbedingungen Akzeptiert: true
|
|
- Standard Teilnahme Erlauben: false
|
|
```
|
|
|
|
So müssen Sie diese Werte nicht in jedem Create-Node angeben.
|
|
|
|
### 2. Standardressource für Abteilung
|
|
|
|
```
|
|
Config Node für Abteilung A:
|
|
- Standard Ressourcen-ID: 5 (Konferenzraum A)
|
|
|
|
Config Node für Abteilung B:
|
|
- Standard Ressourcen-ID: 8 (Konferenzraum B)
|
|
```
|
|
|
|
### 3. Mehrsprachige Umgebung
|
|
|
|
```
|
|
Config Node für deutschsprachige Workflows:
|
|
- Standard Zeitzone: Europe/Berlin
|
|
- Standard Sprache: de_de
|
|
|
|
Config Node für englischsprachige Workflows:
|
|
- Standard Zeitzone: Europe/London
|
|
- Standard Sprache: en_us
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
### 1. Benennung
|
|
|
|
Verwenden Sie aussagekräftige Namen für Ihre Config Credentials:
|
|
- `LibreBooking Config - Produktion`
|
|
- `LibreBooking Config - Test`
|
|
- `LibreBooking Config - Abteilung Marketing`
|
|
|
|
### 2. Dokumentation
|
|
|
|
Dokumentieren Sie Ihre Config-Einstellungen für Ihr Team.
|
|
|
|
### 3. Umgebungstrennung
|
|
|
|
Erstellen Sie separate Configs für verschiedene Umgebungen (Test/Produktion).
|
|
|
|
## Fehlerbehebung
|
|
|
|
### Config wird nicht angewendet
|
|
|
|
- Stellen Sie sicher, dass der Config Node mit dem LibreBooking Node verbunden ist
|
|
- Prüfen Sie, ob die Ressource den Config Node unterstützt (nur Reservierung, Ressource, Benutzer, Konto)
|
|
|
|
### Werte werden überschrieben
|
|
|
|
- Direkt im Node eingegebene Werte haben immer Vorrang
|
|
- Lassen Sie Felder leer, wenn der Config-Wert verwendet werden soll
|
|
|
|
## Technische Details
|
|
|
|
Der Config Node wird als n8n Credential implementiert, ist aber kein echtes Authentifizierungs-Credential. Er speichert lediglich Konfigurationswerte.
|
|
|
|
**Credential-Name**: `libreBookingConfig`
|
|
|
|
**Unterstützte Ressourcen**:
|
|
- Reservierung (`reservation`)
|
|
- Ressource (`resource`)
|
|
- Benutzer (`user`)
|
|
- Konto (`account`)
|