System benutzerdefinierter Felder
Benutzerdefinierte Felder anlegen
Benutzerdefinierte Felder in Kontaktformularen
Das System benutzerdefinierter Felder ermöglicht die Anpassung von Kontaktformularen an Ihre Geschäftsbedürfnisse:
Feld-Erstellungsprozess:
- Benutzerdefinierte Felder werden über eine dedizierte Modal-Oberfläche angelegt
- Felder werden automatisch dem aktuellen Team zugeordnet
- Jedes Feld benötigt einen Namen und eine Typangabe
- Felder sind mit bestimmten Modellen (z. B. Kontakten) verknüpft
Pflichtangaben:
- Feldname: Aussagekräftiger Name für das benutzerdefinierte Feld (Pflicht, max. 255 Zeichen)
- Feldtyp: Datentyp des Feldes (Text oder Zahl)
- Zielmodell: Für Kontaktfelder automatisch auf „App\Models\Contact“ gesetzt
Erstellungsoberfläche:
- Modal-basierte Erstellung für einfaches Hinzufügen von Feldern
- Echtzeit-Validierung der Feldanforderungen
- Automatische Teamzuordnung für korrekte Zugriffskontrolle
- Integration in Kontakt-Erstellungs- und -Bearbeitungsformulare
Feldverwaltung und -organisation
Benutzerdefinierte Felder sind innerhalb von Teams systematisch organisiert:
Teambezogene Organisation:
- Alle benutzerdefinierten Felder sind bestimmten Teams zugeordnet
- Team-Isolation stellt sicher, dass Felder nur für Teammitglieder sichtbar sind
- Felder werden in allen Abfragen nach Team-ID gefiltert
- Zugriff auf Felder anderer Teams ist unterbunden
Modellspezifische Felder:
- Felder sind über das Attribut „fieldable“ mit bestimmten Modellen verknüpft
- Kontakt-Benutzerfelder sind von anderen Modellfeldern getrennt
- Polymorphe Beziehung ermöglicht die Nutzung von Feldern über verschiedene Modelle
- Modellspezifische Filterung sorgt dafür, dass relevante Felder in den richtigen Formularen erscheinen
Feldtypen und Validierung
Verfügbare Feldtypen
Das System unterstützt mehrere Feldtypen für unterschiedliche Datenanforderungen:
Grundlegende Feldtypen:
- Textfelder: Für Zeichenketten-Eingabe mit Standard-Textvalidierung
- Zahlenfelder: Für numerische Daten mit zahlenspezifischer Validierung
- Boolesche Felder: Für Ja/Nein-Daten (in Migrations-Kommentaren referenziert)
- Datumsfelder: Für datumspezifische Eingaben (in Migrations-Kommentaren referenziert)
Feldtyp-Implementierung:
- Typvalidierung stellt sicher, dass nur unterstützte Typen verwendet werden
- Frontend-Komponenten rendern passende Eingabetypen je nach Feldtyp
- Textfelder nutzen Standard-Text-Eingabekomponenten
- Zahlenfelder nutzen HTML-Zahl-Eingabe mit numerischer Validierung
Validierungsregeln:
- Feldnamen sind Pflicht und auf 255 Zeichen begrenzt
- Feldtypen müssen gültige unterstützte Typen sein
- Teamzuordnung ist für alle Felder erforderlich
- Modellzuordnung (fieldable) ist für die richtige Organisation erforderlich
Verwaltung von Feldwerten
Werte benutzerdefinierter Felder werden über ein separates Wertesystem verwaltet:
Wertspeicherung:
- Werte werden in einer dedizierten Tabelle custom_field_values gespeichert
- Polymorphe Beziehung verknüpft Werte mit bestimmten Datensätzen (Kontakten)
- Jeder Wert ist über custom_field_id einem benutzerdefinierten Feld zugeordnet
- Werte unterstützen Textspeicherung mit nullable Werten
Wertoperationen:
- Erstellen: Werte werden erstellt, wenn Kontakte mit Benutzerfelddaten angelegt werden
- Aktualisieren: Werte nutzen updateOrCreate für effiziente Wertverwaltung
- Lesen: Werte werden mit Kontakten geladen für die Anzeige in Formularen
- Löschen: Werte werden kaskadiert gelöscht, wenn benutzerdefinierte Felder entfernt werden
Werte benutzerdefinierter Felder
Verwaltung von Felddaten
Werte benutzerdefinierter Felder sind in Kontaktmanagement-Workflows integriert:
Wert-Erstellung:
- Werte werden bei der Kontakterstellung erstellt, wenn Benutzerfelddaten angegeben werden
- Jeder Wert eines benutzerdefinierten Feldes verknüpft ein bestimmtes Feld und einen Kontakt
- Werte können für optionale Felder null/leer sein
- Automatische Werterstellung für alle definierten benutzerdefinierten Felder
Wert-Aktualisierungen:
- Kontaktbearbeitung umfasst Aktualisierungen der Werte benutzerdefinierter Felder
- UpdateOrCreate-Muster stellt die korrekte Pflege der Werte sicher
- Bestehende Werte werden aktualisiert, neue bei Bedarf erstellt
- Entfernen eines Feldes aus Formularen löscht bestehende Werte nicht
Wertanzeige:
- Werte benutzerdefinierter Felder werden mit Kontaktdaten zum Bearbeiten geladen
- Werte werden den benutzerdefinierten Feldern für die korrekte Formularbefüllung zugeordnet
- Anzeige umfasst Feldnamen und aktuelle Werte
- Formularkomponenten rendern je nach Feldtyp passende Eingabetypen
Wert-Integration in Kontaktformulare
Werte benutzerdefinierter Felder sind nahtlos in Kontaktformulare integriert:
Formularintegration:
- Benutzerdefinierte Felder erscheinen in Kontakt-Erstellungsformularen
- Bestehende Werte füllen Bearbeitungsformulare automatisch aus
- Formularvalidierung berücksichtigt Anforderungen benutzerdefinierter Felder
- Werte werden als Teil der Kontaktdaten übermittelt
Datenstruktur:
- Werte werden als Array custom_field_values in Formularen übergeben
- Jeder Wert enthält custom_field_id und Wertdaten
- Formularkomponenten ordnen Werte den passenden Feldtypen zu
- Validierung erfolgt auf Frontend- und Backend-Ebene
Feldorganisation
Organisation nach Team und Zweck
Benutzerdefinierte Felder sind systematisch für effiziente Verwaltung organisiert:
Trennung nach Teams:
- Alle benutzerdefinierten Felder sind über team_id bestimmten Teams zugeordnet
- Team-Filterung stellt sicher, dass Felder nur für die richtigen Benutzer sichtbar sind
- Zugriff auf Felder anderer Teams ist vollständig unterbunden
- Team-spezifische Feldverwaltung und -organisation
Modellspezifische Organisation:
- Felder sind über das Attribut „fieldable“ nach Zielmodell organisiert
- Kontaktfelder sind von Deal-Feldern oder anderen Modellfeldern getrennt
- Modellspezifische Abfragen sorgen dafür, dass relevante Felder im richtigen Kontext erscheinen
- Polymorphe Beziehungen unterstützen flexible Feldnutzung
Zweckbasierte Nutzung:
- Felder können nach Geschäftszweck oder Datentyp organisiert werden
- Feldnamen unterstützen beschreibende Organisation
- Label-Erzeugung ermöglicht benutzerfreundliche Feldanzeige
- Reihenfolge und Sortierung sind für künftige Organisation vorgesehen
Feldanzeige und -verwaltung
Benutzerdefinierte Felder werden in übersichtlichen, benutzerfreundlichen Oberflächen dargestellt:
Anzeigefunktionen:
- Automatische Label-Erzeugung aus Feldnamen in Title Case
- Feldtypen bestimmen die passenden Eingabekomponenten
- Übersichtliche Darstellung in Kontaktformularen und -listen
- Integration in bestehende Kontaktverwaltungsoberflächen
Verwaltungsoberfläche:
- Modal-basierte Felderstellung für straffe Verwaltung
- Feldliste und -organisation im Teamkontext
- Integration in Kontakt-Index- und Verwaltungsseiten
- Echtzeit-Feldergänzung und Formularaktualisierungen
Integration benutzerdefinierter Felder
Integration in Kontakt-Workflows
Benutzerdefinierte Felder sind tief in Kontaktmanagement-Prozesse integriert:
Kontakt-Erstellungs-Integration:
- Benutzerdefinierte Felder erscheinen in Kontakt-Erstellungsformularen
- Feldwerte werden im Kontakt-Erstellungsprozess gespeichert
- Validierung berücksichtigt Anforderungen benutzerdefinierter Felder
- Automatische Anlage der Feld-Wert-Beziehung
Kontakt-Bearbeitungs-Integration:
- Bestehende Werte benutzerdefinierter Felder füllen Bearbeitungsformulare aus
- Werte können über den Standard-Bearbeitungsprozess geändert werden
- UpdateOrCreate-Muster gewährleistet Datenkonsistenz
- Feldänderungen werden mit Kontaktaktualisierungen erfasst
Kontakt-Anzeige-Integration:
- Benutzerdefinierte Felder erscheinen in Kontaktdetailansichten
- Feldwerte werden mit passender Formatierung angezeigt
- Integration in Kontaktsuche und -filterung
- Felddaten in Kontakt-Export und -Berichterstattung einbezogen
Systemweite Integration
Benutzerdefinierte Felder sind in übergreifende Systemfunktionen integriert:
Suchintegration:
- Werte benutzerdefinierter Felder sind in Kontaktsuchen enthalten
- Felddaten unterstützen Filterung und Organisation
- Integration in globale Suchfunktionen
- Feldbasierte Kontaktorganisation und -gruppierung
Berichtsintegration:
- Daten benutzerdefinierter Felder für Berichte und Analysen verfügbar
- Feldwerte in Kontaktdaten-Exporten enthalten
- Integration in Team-Berichte und -Analysetools
- Metriken und Nutzungsverfolgung benutzerdefinierter Felder
Team-Zusammenarbeit:
- Benutzerdefinierte Felder unterstützen teamweites Kontaktmanagement
- Felddefinitionen werden mit Teammitgliedern geteilt
- Einheitliche Feldnutzung in Team-Workflows
- Feldbasierte Kontaktorganisation und -zuordnung