4.0 KiB

Raw Blame History

Benutzerdefinierte Attribute (Custom Attributes)

Diese Dokumentation erklärt, wie Sie benutzerdefinierte Attribute in LibreBooking über die n8n Nodes verwenden können.

Überblick

LibreBooking unterstützt benutzerdefinierte Attribute für:

Reservierungen (Kategorie-ID: 1)
Benutzer (Kategorie-ID: 2)
Ressourcen (Kategorie-ID: 4)
Ressourcen-Typen (Kategorie-ID: 5)

Attribut-Typen

Typ	Beschreibung	Wert
Einzeilig	Einfaches Textfeld	1
Mehrzeilig	Textbereich	2
Auswahlliste	Dropdown-Menü	3
Checkbox	Ja/Nein Feld	4
Datum/Zeit	Datums-/Zeitauswahl	5

Attribute abrufen

Alle Attribute einer Kategorie abrufen

Wählen Sie Ressource: Attribut
Wählen Sie Operation: Nach Kategorie Abrufen
Wählen Sie Kategorie-ID: z.B. Reservierung

Die Antwort enthält alle Attribute mit ihren IDs und Eigenschaften.

Einzelnes Attribut abrufen

Wählen Sie Ressource: Attribut
Wählen Sie Operation: Abrufen
Geben Sie die Attribut-ID ein

Attribute bei Reservierungen setzen

Bei Erstellen einer Reservierung

Wählen Sie Ressource: Reservierung
Wählen Sie Operation: Erstellen
Füllen Sie die Pflichtfelder aus
Unter Benutzerdefinierte Attribute:
- Klicken Sie auf "Attribut hinzufügen"
- Geben Sie die Attribut-ID ein (z.B. 1)
- Geben Sie den Wert ein (z.B. Meetingraum-Konfiguration)

Bei Aktualisieren einer Reservierung

Gleiche Vorgehensweise wie beim Erstellen.

Beispiel JSON für API-Request

{
  "resourceId": 1,
  "startDateTime": "2024-01-15T10:00:00+01:00",
  "endDateTime": "2024-01-15T11:00:00+01:00",
  "title": "Team Meeting",
  "termsAccepted": true,
  "customAttributes": [
    {
      "attributeId": 1,
      "attributeValue": "Standard-Setup"
    },
    {
      "attributeId": 2,
      "attributeValue": "10"
    }
  ]
}

Attribute bei Ressourcen setzen

Bei Erstellen einer Ressource

Wählen Sie Ressource: Ressource
Wählen Sie Operation: Erstellen
Füllen Sie die Pflichtfelder aus (Name, Zeitplan-ID)
Unter Benutzerdefinierte Attribute:
- Klicken Sie auf "Attribut hinzufügen"
- Geben Sie die Attribut-ID und den Wert ein

Beispiel: Raum mit Ausstattung

{
  "name": "Konferenzraum A",
  "scheduleId": 1,
  "customAttributes": [
    {
      "attributeId": 10,
      "attributeValue": "Beamer, Whiteboard"
    },
    {
      "attributeId": 11,
      "attributeValue": "20"
    }
  ]
}

Attribute bei Benutzern setzen

Bei Erstellen eines Benutzers

Wählen Sie Ressource: Benutzer
Wählen Sie Operation: Erstellen
Füllen Sie die Pflichtfelder aus
Unter Benutzerdefinierte Attribute:
- Klicken Sie auf "Attribut hinzufügen"
- Geben Sie die Attribut-ID und den Wert ein

Neue Attribute erstellen (Admin)

Wählen Sie Ressource: Attribut
Wählen Sie Operation: Erstellen
Füllen Sie aus:
- Kategorie-ID: Ziel-Kategorie (1, 2, 4 oder 5)
- Attribut-Label: Anzeigename
- Attribut-Typ: Feldtyp
Optional unter Attribut-Optionen:
- Erforderlich: Pflichtfeld?
- Nur Admin: Nur für Admins sichtbar?
- Mögliche Werte: Für Auswahllisten (komma-getrennt)

Tipps

Attribut-IDs herausfinden

Nutzen Sie die Operation "Nach Kategorie Abrufen"
Notieren Sie sich die id der benötigten Attribute

Checkbox-Attribute

Für Checkbox-Attribute verwenden Sie:

"1" oder "true" für aktiviert
"0" oder "false" für deaktiviert

Auswahllisten

Der Wert muss exakt einem der möglichen Werte entsprechen.

Fehlerbehebung

Attribut wird nicht gespeichert

Prüfen Sie, ob die Attribut-ID korrekt ist
Prüfen Sie, ob das Attribut für diese Kategorie gilt
Prüfen Sie, ob der Wert dem Attribut-Typ entspricht

Zugriff verweigert

Einige Attribute sind nur für Admins verfügbar
Prüfen Sie die Berechtigungen in LibreBooking

4.0 KiB Raw Blame History