---

Übersicht

Benutzerdefinierte Felder ermöglichen es Ihnen, die Standarddatensatzstruktur von Blue mit zusätzlichen Datenfeldern zu erweitern, die spezifisch auf die Bedürfnisse Ihres Unternehmens zugeschnitten sind. Sie bieten eine leistungsstarke Möglichkeit, strukturierte Daten über die integrierten Felder wie Titel, Beschreibung und Fälligkeitsdatum hinaus zu erfassen.

Benutzerdefinierte Felder werden auf Projektebene definiert und können in allen Datensätzen (To-Dos) innerhalb dieses Projekts verwendet werden. Jedes Feld hat einen spezifischen Typ, der seine Validierungsregeln, Eingabeformate und Anzeigeverhalten bestimmt.

Verfügbare Operationen

Verwaltung von Kernfeldern

Operation	Beschreibung	Link
List Custom Fields	Abfragen und Filtern von benutzerdefinierten Feldern	View Details →
Create Custom Field	Neue benutzerdefinierte Felder zu Projekten hinzufügen	View Details →
Delete Custom Field	Benutzerdefinierte Felder mit ordnungsgemäßer Bereinigung entfernen	View Details →

Feldwerte

Operation	Beschreibung	Link
Set Field Values	Benutzerdefinierte Feldwerte in Datensätzen festlegen und aktualisieren	View Details →

Typen von benutzerdefinierten Feldern

Textfelder

Typ	Beschreibung	Anwendungsfälle	Link
TEXT_SINGLE	Eingabe für einzeilige Texte	Names, titles, short descriptions	View Details →
TEXT_MULTI	Mehrzeiliges Textfeld	Lange Beschreibungen, Notizen, Kommentare	View Details →

Auswahlfelder

Typ	Beschreibung	Anwendungsfälle	Link
SELECT_SINGLE	Dropdown für Einzelauswahl	Status, priority, category	View Details →
SELECT_MULTI	Dropdown für Mehrfachauswahl	Tags, skills, categories	View Details →
CHECKBOX	Boolean-Checkbox-Feld	Flags, approvals, confirmations	View Details →

Numerische Felder

Typ	Beschreibung	Anwendungsfälle	Link
NUMBER	Numerische Eingabe	Quantities, scores, measurements	View Details →
CURRENCY	Währungsbetrag	Budgets, costs, pricing	View Details →
PERCENT	Prozentwert	Completion rates, discounts	View Details →
RATING	Sternebewertung mit benutzerdefinierter Skala	Performance ratings, satisfaction	View Details →
FORMULA	Berechnetes Feld basierend auf anderen Feldern	Totals, computations, aggregations	View Details →

Kontaktfelder

Typ	Beschreibung	Anwendungsfälle	Link
EMAIL	E-Mail-Adresse mit Validierung	Kontaktinformationen, Benachrichtigungen	View Details →
PHONE	Telefonnummer mit internationalem Format	Contact details, emergency contacts	View Details →
URL	Web-URL mit Validierung	Links, references, resources	View Details →

Datums- und Zeitfelder

Typ	Beschreibung	Anwendungsfälle	Link
DATE	Datumsauswahl	Deadlines, milestones, events	View Details →
TIME_DURATION	Zeitverfolgungsfeld	Work hours, duration estimates	View Details →

Standort und Geografie

Typ	Beschreibung	Anwendungsfälle	Link
LOCATION	Geografischer Standort (Breitengrad/Längengrad)	Addresses, venues, service areas	View Details →
COUNTRY	Länderauswahl	Regional assignments, localization	View Details →

Datei und Medien

Typ	Beschreibung	Anwendungsfälle	Link
FILE	Dateianhang	Documents, images, resources	View Details →

Systemfelder

Typ	Beschreibung	Anwendungsfälle	Link
UNIQUE_ID	Automatisch generierte eindeutige Kennung	Ticket numbers, order IDs	View Details →
REFERENCE	Link zu Datensätzen in einem anderen Projekt	Cross-project relationships	View Details →
LOOKUP	Daten aus referenzierten Datensätzen abrufen	Aggregate data from related records	View Details →

Interaktive Felder

Typ	Beschreibung	Anwendungsfälle	Link
BUTTON	Handlungsfähiges Schaltflächenfeld	Triggers, actions, workflows	View Details →
CURRENCY_CONVERSION	Währungsumrechnungsfeld	Multi-currency calculations	View Details →

Schlüsselkonzepte

Felddefinition

• Benutzerdefinierte Felder werden auf Projektebene definiert
• Jedes Feld hat einen eindeutigen Namen und Typ
• Felder können Validierungsregeln und Einschränkungen enthalten
• Die Konfigurationsoptionen variieren je nach Feldtyp

Feldwerte

• Werte werden in einzelnen Datensätzen (To-Dos) gespeichert
• Jeder Datensatz kann unterschiedliche Werte für dasselbe Feld haben
• Leere/null-Werte sind für optionale Felder zulässig
• Werte werden gemäß den Regeln des Feldtyps validiert

Berechtigungsmodell

Benutzerdefinierte Felder respektieren die Berechtigungen auf Projektebene:

Rolle	Felder erstellen	Felder bearbeiten*	Werte festlegen	Werte anzeigen
OWNER	✅ Ja	✅ Ja	✅ Ja	✅ Ja
ADMIN	✅ Ja	✅ Ja	✅ Ja	✅ Ja
MEMBER	❌ Nein	❌ Nein	✅ Ja	✅ Ja
CLIENT	❌ Nein	❌ Nein	✅ Eingeschränkt	✅ Eingeschränkt

*Felder bearbeiten bezieht sich auf die Änderung von Feldeinstellungen (Name, Typ, Optionen, Validierungsregeln) - nicht auf das Festlegen von Feldwerten in Datensätzen

Berechtigungen für benutzerdefinierte Rollen

• Projekte können benutzerdefinierte Rollen mit feldspezifischen Berechtigungen haben
• Felder können je nach Rolle als bearbeitbar/nicht bearbeitbar markiert werden
• Benutzerdefinierte Rollen können den Zugriff auf spezifische Felder einschränken

Häufige Muster

Erstellen eines grundlegenden benutzerdefinierten Feldes

mutation CreateCustomField {
  createCustomField(input: {
    name: "Priority Level"
    type: SELECT_SINGLE
    description: "Task priority level"
    customFieldOptions: [
      { title: "Low", color: "#28a745" }
      { title: "Medium", color: "#ffc107" }
      { title: "High", color: "#fd7e14" }
      { title: "Critical", color: "#dc3545" }
    ]
  }) {
    id
    name
    type
    customFieldOptions {
      id
      title
      color
    }
  }
}

Festlegen von Feldwerten in Datensätzen

mutation SetFieldValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    customFieldOptionId: "option_789"  # For SELECT_SINGLE
  })
}

Abfragen von Datensätzen mit benutzerdefinierten Feldern

query GetTodosWithCustomFields {
  todos(projectId: "project_123") {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      # Type-specific value fields
      text           # TEXT_SINGLE, TEXT_MULTI, EMAIL, etc.
      number         # NUMBER, CURRENCY, PERCENT, RATING
      selectedOption # SELECT_SINGLE
      selectedOptions # SELECT_MULTI
      checked        # CHECKBOX
      date           # DATE
    }
  }
}

Erstellen von Datensätzen mit benutzerdefinierten Feldwerten

mutation CreateTodoWithCustomFields {
  createTodo(input: {
    title: "New task"
    todoListId: "list_123"
    customFields: [
      { customFieldId: "priority_field", value: "high_priority_option" }
      { customFieldId: "budget_field", value: "5000" }
      { customFieldId: "notes_field", value: "Additional context here" }
    ]
  }) {
    id
    title
    customFields {
      customField { name }
      value
    }
  }
}

Beste Praktiken

Feldgestaltung

1. Verwenden Sie beschreibende Namen - Machen Sie die Zwecke der Felder klar
2. Wählen Sie geeignete Typen - Passen Sie den Feldtyp an die Datenanforderungen an
3. Setzen Sie Validierungsregeln - Verwenden Sie Min/Max-Werte, erforderliche Felder
4. Logisch organisieren - Gruppieren Sie verwandte Felder zusammen

Leistungsüberlegungen

1. Feldanzahl begrenzen - Zu viele Felder können die Leistung beeinträchtigen
2. Pagination verwenden - Bei der Abfrage großer Datensätze
3. Schlüssel-Felder indizieren - Für Felder, die beim Filtern/Sortieren verwendet werden
4. Tiefe Verschachtelung vermeiden - Halten Sie die Feldbeziehungen einfach

Datenqualität

1. Eingaben validieren - Verwenden Sie geeignete Feldtypen mit Validierung
2. Standards bereitstellen - Setzen Sie sinnvolle Standardwerte, wo angebracht
3. Konsistente Formate verwenden - Standardisieren Sie die Dateneingabemuster
4. Regelmäßige Bereinigung - Entfernen Sie ungenutzte Felder und Optionen

Benutzererfahrung

1. Klare Beschreibungen - Stellen Sie hilfreiche Feldbeschreibungen bereit
2. Logische Anordnung - Positionieren Sie Felder in natürlicher Workflow-Reihenfolge
3. Visuelle Hierarchie - Verwenden Sie Farben und Formatierungen effektiv
4. Progressive Offenlegung - Zeigen Sie Felder an, wenn sie relevant sind

Fehlerbehandlung

Häufige Fehler bei der Arbeit mit benutzerdefinierten Feldern:

Fehlercode	Beschreibung	Lösung
CUSTOM_FIELD_NOT_FOUND	Feld existiert nicht	Verify field ID and project access
VALIDATION_ERROR	Wert entspricht nicht dem Feldtyp	Check format and validation rules
UNAUTHORIZED	Unzureichende Berechtigungen	Ensure proper role level
CUSTOM_FIELD_VALUE_PARSE_ERROR	Ungültiges Werteformat	Review field type requirements

Verwandte Ressourcen

• API für Datensätze - Arbeiten mit Datensätzen, die benutzerdefinierte Felder enthalten
• API für Projekte - Verwaltung von Projekten, die benutzerdefinierte Felder enthalten
• API für Automatisierungen - Automatisierung von Workflows mit Auslösern für benutzerdefinierte Felder
• API für Benutzerverwaltung - Verwaltung der Berechtigungen für benutzerdefinierte Felder