# Eigene Felder verwenden

> Wo ein im Feld Editor angelegtes eigenes Feld automatisch überall erscheint – als Textmarke in Vorlagen, als Spalte und Filter in Listen, in der Sammelaktion Spalteninhalt bearbeiten, in der Import-Zuordnung und in der API – und was beim Umbenennen und Löschen passiert.

Ein eigenes Feld, das du im Feld Editor anlegst, steht nicht nur im Fenster: i-Planner gibt es automatisch auch für Vorlagen, Listen, Sammelaktionen, den Import und die API frei. Hier steht, wo du es findest und worauf du beim Umbenennen und Löschen achten musst.

## Voraussetzungen

Eigene Felder legst du mit dem Recht **Feld Editor** an: in den [Benutzerrollen](/organisation/einstellungen/team-und-rollen/benutzerrollen) im Block **Kundenverwaltung** hinter der Zeile **Einstellungen**. Wie das geht, steht unter [Felder](/kundenverwaltung/einstellungen/felder/uebersicht). Für Listen, Sammelaktionen und den Import brauchst du die Rechte des jeweiligen Bereichs.

## Wissen, wo ein eigenes Feld automatisch erscheint

Sobald du mit **Neues Feld** ein Feld anlegst, schaltet i-Planner es für diese Stellen frei:

| Wo | Was du damit machst |
|---|---|
| Vorlagen | Das Feld bekommt eine **Textmarke**, mit der sein Inhalt in Textvorlagen und im Dokumenteneditor erscheint. |
| Listen des Bereichs | Das Feld steht als Spalte zur Wahl, lässt sich filtern, sortieren und gruppieren und in der Liste bearbeiten. |
| Sammelaktion **Spalteninhalt bearbeiten** | Du füllst das Feld für viele Einträge auf einmal. |
| Import | Du ordnest einer Spalte deiner Importdatei das Feld zu. |
| API | Das Feld ist über seine **Feld - ID** ansprechbar. |

Die folgenden Abschnitte erklären jede Stelle.

## Die Textmarke eines eigenen Feldes in Vorlagen nutzen

Jedes eigene Feld bekommt beim Anlegen automatisch eine Textmarke. Sie ist so aufgebaut: Anfang des Bereichs, **Feld - ID**, Feldname in Großbuchstaben, dazwischen Unterstriche, am Ende ein Prozentzeichen. Ein neues Feld in einem Vertragsfenster heißt zum Beispiel zunächst **%VERTRAG_10000005_NEUES_FELD%**.

Der Anfang hängt vom Bereich ab, zum Beispiel **%VERTRAG_** bei Verträgen, **%VERTRAG_PERSON_** bei Personen im Vertrag, **%SCHADEN_** bei Schäden, **%ZIEL_** bei Wünschen & Zielen, **%FINANZDATEN_** bei Finanzdaten und **%ANSPRECHPARTNER_** bei Ansprechpartnern von Produktpartnern. Im Feld Editor steht der feste Anfang im Feld **Textmarke** schon da; bearbeiten kannst du nur den Teil danach.

So nutzt du die Textmarke:

1. Klicke das Feld im Feld Editor an und lies im Abschnitt **Feld** die **Textmarke** ab.
2. Füge sie in deine Vorlage ein. Die Textmarke eines eigenen Feldes steht auch in der Platzhalter-Liste, siehe [Platzhalter](/kundenverwaltung/einstellungen/textvorlagen/platzhalter).

Beim Erstellen des Textes ersetzt i-Planner die Textmarke durch den Inhalt des Feldes.

## Ein eigenes Feld umbenennen, ohne Vorlagen zu beschädigen

Benennst du ein eigenes Feld unter **Feldname** um, ändert i-Planner seine Textmarke mit: Der neue Name kommt in Großbuchstaben hinein, Leerzeichen werden zu Unterstrichen. Aus **%VERTRAG_10000005_NEUES_FELD%** wird bei „Makler Notiz" zum Beispiel **%VERTRAG_10000005_MAKLER_NOTIZ%**. Der neue Name gilt überall, wo das Feld steht.

::callout
---
icon: i-heroicons-exclamation-triangle
color: amber
---
Beim Umbenennen über **Feldname** schreibt i-Planner vorhandene Vorlagen nicht um. Steht dort noch die alte Textmarke, wird sie nicht mehr ersetzt. Prüfe nach dem Umbenennen deine Textvorlagen, Formulare und Dokumente.
::

Änderst du dagegen direkt das Feld **Textmarke**, gilt:

- i-Planner schreibt Betreff und Text aller Textvorlagen auf die neue Textmarke um. Formulare und Dokumente schreibt es nicht um.
- Ist der Name schon vergeben, hängt i-Planner eine Zahl an.
- Leerst du das Feld, setzt i-Planner die Textmarke auf den Standard zurück.

Ein Systemfeld heißt nach dem Umbenennen nur in dieser Gruppe dieses Fensters anders.

## Ein eigenes Feld als Spalte und Filter in Listen nutzen

In den Listen des Bereichs ist ein eigenes Feld automatisch als Spalte und als Filter eingeschaltet, zum Beispiel ein Feld im Kundenprofil in den Kundenlisten. Du kannst nach ihm sortieren und gruppieren. Es ist in der Liste bearbeitbar, wenn du die Zellbearbeitung einschaltest.

- **Als Spalte zeigen:** Wähle das Feld in den Einstellungen der Liste aus, siehe [Eigene Listen](/kundenverwaltung/grundlagen/listen/eigene-listen), Abschnitt **Spalten auswählen**.
- **Danach filtern:** Lege einen Filter mit dem Feld an, siehe [Eigene Listen](/kundenverwaltung/grundlagen/listen/eigene-listen), Abschnitt **Filter festlegen**.
- **Direkt in der Liste ändern:** Schalte in der Werkzeugleiste unter **Spalten bearbeiten** die **Zellbearbeitung aktivieren** ein, siehe [Listen](/kundenverwaltung/grundlagen/listen/uebersicht).

## Ein eigenes Feld für viele Einträge auf einmal füllen

Mit der Sammelaktion **Spalteninhalt bearbeiten** trägst du denselben Wert bei vielen markierten Einträgen einer Liste ein. Angeboten werden die bearbeitbaren Spalten der Liste; eigene Felder gehören automatisch dazu.

1. Markiere in der Liste die Einträge.
2. Wähle die Sammelaktion **Spalteninhalt bearbeiten**.
3. Wähle unter **Bitte wähle eine Spalte aus..** dein Feld, gib den Wert ein und klicke auf **Speichern**.

Dafür brauchst du das Bearbeitungsrecht des Bereichs. Wie Sammelaktionen allgemein funktionieren, steht unter [Sammelaktionen](/kundenverwaltung/grundlagen/listen/sammelaktionen).

## Ein eigenes Feld beim Import befüllen

Eigene Felder stehen im Import zur Zuordnung bereit. Hat deine Importdatei eine Spalte, die es in i-Planner noch nicht gibt, lege das Feld zuerst im Feld Editor im passenden Fenster an.

1. Lege das eigene Feld im Feld Editor an, zum Beispiel unter **Kontakte › Profil**.
2. Starte den Import und ordne im Schritt **Spalten abgleichen** der Spalte über **Feld zuordnen...** dein Feld zu, siehe [Spalten abgleichen](/kundenverwaltung/einstellungen/import/spalten-abgleichen).

## Ein eigenes Feld über die API ansprechen

Eigene Felder sind für die API freigegeben. In der API erkennst du ein Feld an seiner **Feld - ID**, die der Feld Editor im Abschnitt **Feld** anzeigt. Die API liest die Felder aus den Gruppen des jeweiligen Fensters. Den Zugang zur API richtest du unter [API Tokens](/organisation/einstellungen/entwickler/api-tokens) ein.

## Wissen, was beim Löschen eines eigenen Feldes verloren geht

Steht ein eigenes Feld nur in einem Fenster, löscht i-Planner es mit allen Inhalten, seinen Listenspalten und Filtern und seinen Auswahlwerten. Steht es in mehreren Fenstern, nimmt i-Planner es nur aus dem gewählten Fenster. Die Einzelheiten stehen unter [Felder](/kundenverwaltung/einstellungen/felder/uebersicht), Abschnitt **Felder ausblenden oder löschen**.

::callout
---
icon: i-heroicons-exclamation-triangle
color: amber
---
Gelöschte Inhalte eines eigenen Feldes lassen sich nicht wiederherstellen. Blende ein Feld aus, wenn du es nur nicht mehr sehen willst.
::

## Häufige Fragen

### Wie finde ich den Platzhalter für mein eigenes Feld?

Klicke das Feld im Feld Editor an. Im Abschnitt **Feld** steht die **Textmarke**. Sie steht auch in der Platzhalter-Liste, siehe [Platzhalter](/kundenverwaltung/einstellungen/textvorlagen/platzhalter).

### Warum funktioniert mein Platzhalter nicht mehr, seit ich das Feld umbenannt habe?

Beim Umbenennen über **Feldname** ändert sich die Textmarke mit, vorhandene Vorlagen schreibt i-Planner aber nicht um. Ersetze die alte Textmarke in deinen Vorlagen durch die neue aus dem Abschnitt **Feld**.

### Warum sehe ich mein neues Feld nicht in der Liste?

Ein eigenes Feld steht in den Listen seines Bereichs als Spalte zur Wahl, zum Beispiel ein Feld aus **Kontakte › Profil** in den Kundenlisten. Fehlt die Spalte in deiner Liste, wähle sie in den Einstellungen der Liste unter **Spalten auswählen** aus, siehe [Eigene Listen](/kundenverwaltung/grundlagen/listen/eigene-listen).

### Kann ich ein eigenes Feld beim Import mit Daten füllen?

Ja. Lege das Feld vor dem Import im Feld Editor an und ordne es im Schritt **Spalten abgleichen** der passenden Spalte deiner Datei zu.

### Wie ändere ich ein eigenes Feld bei vielen Kunden gleichzeitig?

Markiere die Kunden in der Liste und nutze die Sammelaktion **Spalteninhalt bearbeiten**. Wähle dein Feld, gib den Wert ein und klicke auf **Speichern**.