Der Label Service erzeugt automatisch die Briefanreden und Adresszeilen auf euren Accounts. Statt jede Anrede einzeln zu pflegen, hinterlegt ihr einmal zentrale Regeln, die Sprache, Geschlecht, Titel und Account-Typ berücksichtigen.

Durch die Anpassung der Konfiguration sind auch komplexe Briefanreden möglich, etwa für Ehepaare, akademische Titel oder fremdsprachige Empfänger:innen.

Die Doku zeigt zunächst die Anwendung der Briefanreden auf den Accounts und danach die Konfiguration der Briefanreden (für Administratoren).

Teil 1: Arbeiten mit dem Labelservice am Account

Für alle Nutzer:innen. Keine besonderen Rechte nötig.

Wo du die Anrede findest

Auf der Account-Detailseite gibt es zwei relevante Bereiche:

Empfängeranrede mit den Feldern:

Bevorzugte Anredeform (Formell oder Informell)
Empfängeranrede automatisch berechnen (Haken)
Empfängeranrede (bevorzugt), (formell), (informell)

Bildschirmfoto 2026-07-29 um 11.20.36.png

Felder auf dem Account

Adresse mit den Feldern:

Rechnungsanschrift
Empfängeradresse

Bildschirmfoto 2026-07-29 um 11.24.57.png

Unter Allgemeine Informationen werden zusätzlich Primäre Person und Sekundäre Person verwaltet. Sie bestimmen bei Haushalten und Organisationen, wer in der Anrede genannt wird.

Bildschirmfoto 2026-07-29 um 11.29.44.png

Nur bei Organisationen und Haushalten

Was automatisch passiert

Sobald ein Account angelegt oder bearbeitet wird, erzeugt der Label Service die passende Briefanrede automatisch aus den hinterlegten Regeln. Ihr müsst die Anrede also nicht selbst formulieren.

Ein zentraler Bestandteil der Generierung ist das Feld Anrede. Wo es sichtbar ist, hängt vom Account-Typ ab:

Bei Personenaccounts erscheint das Anrede-Feld nur, wenn ihr den Namen bearbeitet.

Bei Businessaccounts wird das Feld dagegen immer angezeigt.

Beispiele je Account-Typ:

Situation	Ergebnis

Situation	Ergebnis
Person, formell	Sehr geehrte Frau Professorin Müller
Person, informell	Liebe Anna
Haushalt, direkt	Sehr geehrte Familie Meier-Müller
Haushalt, kombiniert	Sehr geehrte Frau Müller, sehr geehrter Herr Meier
Organisation ohne Person	Sehr geehrte Damen und Herren
Organisation mit Person	Sehr geehrte Frau Morgenthaler

Steuerung der Briefanrede

Auf dem Account steuerst du über zwei Felder, wie die Briefanrede erzeugt wird.

Über Bevorzugte Anrede legst du fest, welche Anredeform für den Account verwendet werden soll (formell oder informell).

Über Empfängeranrede automatisch berechnen entscheidest du, ob der Label Service die Anrede selbst pflegt. Ein typischer Fall: Du legst einen neuen Account an oder änderst den Namen, und die passende Briefanrede soll ohne dein Zutun entstehen. Ist der Haken gesetzt, setzt der Service die Anrede automatisch aus den Feldern rechts (Sprache, Geschlecht, Titel, Name) zusammen und berechnet sie bei jeder Änderung neu, sodass sie immer aktuell bleibt.

Ich hab die zwei Umbenennungen aus dem Kommentar übernommen (Bevorzugte Anredeform → Bevorzugte Anrede) und "Logik der Felder rechts" als konkreten UseCase eingebaut. Sag Bescheid, falls der UseCase noch anders klingen soll.

Anrede manuell überschreiben

Wenn die automatische Anrede im Einzelfall nicht passt, kannst du sie manuell ändern:

Haken Empfängeranrede automatisch berechnen über das Stift-Symbol entfernen
Empfängeranrede (formell oder informell) nach deinen Wünschen anpassen

⚠️ Wird der Haken bei Empfängeranrede automatisch berechnen wieder gesetzt, dann wird dein Text beim nächsten Speichern wieder überschrieben.

Bildschirmfoto 2026-07-29 um 12.30.44.png

Kann über den Stift bearbeitet werden

Formell oder informell umstellen

Über das Feld Bevorzugte Anredeform wählst du, welche Variante als bevorzugte Anrede verwendet wird. Beide Varianten werden im Hintergrund erzeugt und bleiben in den Feldern Empfängeranrede (formell) und (informell) sichtbar.

Wenn etwas nicht stimmt

Problem	Was du selbst tun kannst

Problem	Was du selbst tun kannst
Anrede ist leer oder unvollständig	Prüfen, ob Anrede, Titel und Name am Account gepflegt sind
Falsche Sprache	Sprachfeld am Account prüfen
Falsche Person genannt	Primäre und sekundäre Person prüfen
Titel fehlt in der Anrede	Titel ist eventuell noch nicht als Code hinterlegt → an Admin
Änderung wird nicht übernommen	Account einmal neu speichern
Text ist grundsätzlich falsch aufgebaut	Konfigurationsthema → an Admin

Teil 2: Konfiguration des Labelservice

Für Admins. Voraussetzung: Permission Set KLDO Labels - Admin.

Wo: Lightning App Kaleido:LABELS

Navigation: Vier Tabs: Label Objects, Label Fields, Label Templates, Label Codes. Objects und Fields sind Setup und im Standard bereits eingerichtet. Für die Briefanrede arbeitest du fast nur mit Templates und Codes.

Allgemeine Zusammenhänge und Regeln

Grundregeln

Struktur ins Template. Varianten in die Codes.

Template = welche Bausteine in welcher Reihenfolge.
Code = welches Wort bei welchem Feldwert und welcher Sprache.

Neues Template nur bei anderem Aufbau (Person vs. Organisation). Sprache, Geschlecht, Wortvarianten gehören immer in Code Entries.

Bei den Templates gibt es zwei Arten:

Ein Regular Template ist ein eigenständiger Baustein, der eine komplette Ausgabe erzeugt, zum Beispiel die fertige Briefanrede eines Personenaccounts.

Ein Nested Template ist ein Teilbaustein, den du in andere Templates einbindest, statt ihn mehrfach zu schreiben. Praktisch, wenn derselbe Baustein an mehreren Stellen gebraucht wird, etwa die Personenanrede bei Haushalten.

Beide werden weiter unten mit Beispielen ausführlich beschrieben.

Platzhalter-Syntax

Ein Template enthält Klartext und Platzhalter, die beim Generieren automatisch mit den Werten des Datensatzes gefüllt werden. Die Platzhalter stehen immer in geschweiften Klammern.

Schreibweise	Bedeutung

Schreibweise	Bedeutung
`{!LastName}`	Feld direkt einsetzen
`{!Code.StudyDegree(kldo__StudyDegree__pc)}`	Code für den akademischen Titel nachschlagen, anhand des Werts im Feld kldo__StudyDegree__pc
`{!Template.Name}`	Nested Template einbinden

An einen Code kannst du Zusätze anhängen, die steuern, wie das Wort ausgegeben wird:

.Long = ausgeschrieben statt abgekürzt (Professorin statt Prof.)
.WithGender(Salutation) = geschlechtsabhängig

Welches Template greift

Für dasselbe Feld können mehrere Templates existieren, etwa eines für den Normalfall und eines für einen Sonderfall. Welches genommen wird, entscheiden Criteria und Priority.

Niedrige Priority zuerst. Erstes Template, dessen Criteria passt, gewinnt. Leeres Criteria = passt immer → braucht hohe Zahl, sonst greift nie ein Spezialfall.

Priority	Criteria	Rolle

Priority	Criteria	Rolle
1	eng	Sonderfall
10	leer	Fallback (Standard)

Templates und Codes

Regular Template

So sieht die formelle Anrede im Standard aus. Jede Zeile setzt einen Baustein zusammen.

{!Code.Greeting_PersonAccount_Formal(Salutation)} {!Code.Salutation(Salutation)}
{!kldo__NonAcademicTitle__pc}
{!Code.StudyDegree(kldo__StudyDegree__pc).Long.WithGender(Salutation)}
{!Template.FirstName_if_Salutation_is_empty} {!kldo__TitleOfNobility__pc} {!LastName}

→ Sehr geehrte Frau Professorin Müller

Die Adresse funktioniert nach demselben Prinzip, nur mit einem anderen Ziel-Feld: eigene Templates, dieselben Codes, dieselbe Priority-Logik.

Der Unterschied liegt im Aufbau der Namenszeilen je Account-Typ:

Account-Typ	Aufbau

Account-Typ	Aufbau
Person	Anrede + Titel + Vorname + Nachname
Haushalt mit Mitgliedern	Zwei separate Namenszeilen (primäre und sekundäre Person)
Organisation mit Mitglied	Organisationsname + Namenserweiterung + Personenzeile

Nested Template

Ein Nested Template ist ein Baustein, den du in mehreren Templates verwenden kannst, ohne ihn jedes Mal neu zu schreiben. Praktisch bei Haushalten, wo dieselbe Personenanrede zweimal gebraucht wird. Ein typischer Fall sind auch die Postanschrifts-Zeilen, die bei allen Account-Typen gleich sind.

Type = Nested statt Regular. Name darf keine Leerzeichen haben (er ist gleichzeitig der Aufruf).

Kontextwechsel: Damit wendest du ein Template nicht auf den aktuellen Datensatz an, sondern auf einen verknüpften. Bei Haushalten holst du dir so die Anrede der primären Person:

{!Template.Salutation_PersonAccount_Formal(kldo__PrimaryPersonAccount__r)}

⚠️ Funktioniert nur bei gleichem Objekttyp. Account → Account ja. Account → Contact nein.

Codes

Für die Adresse verwendest du dieselben Codes wie bei der Briefanrede, unter Umständen aber mit anderen Modifikatoren. Derselbe Code liefert je nach Modifikator eine andere Ausgabe:

Anrede: .Long.WithGender(...) → Sehr geehrte Frau Professorin Müller
Adresse: ohne Modifikator → Frau Prof. Anna Müller

Deshalb legst du für die Adresse keine neuen Codes an, sondern nur eigene Templates, die dieselben Codes anders aufrufen.Typische Anpassungen

Typische Anpassungen

Neuen Titel hinzufügen (z. B. "Abt", "Schwester")

Der Normalfall. Kein neues Template nötig.

Tab Label Codes → passenden Code öffnen (z. B. StudyDegree oder Salutation)
Neuen Label Code Entry anlegen
Feldwert eintragen, Sprache wählen, Ausgabetext eintragen
Für jede benötigte Sprache einen eigenen Entry anlegen (DE, FR, IT, EN)
Mit einem Account testen, wo die Änderung wirksam werden sollte (Feld ändern und speichern)
Betroffene Accounts neu speichern oder Refresh Accounts starten

Anrede anpassen (Reihenfolge oder Aufbau ändern)

Nur nötig, wenn sich die Struktur ändert.

Tab Label Templates → bestehendes Template öffnen (z. B. Salutation_PersonAccount_Formal)
Clone statt Edit, wenn der Standard erhalten bleiben soll
Output anpassen
Criteria setzen, damit klar ist, wann das Template greift
Priority niedriger als das Fallback setzen
Is Active anhaken, speichern
Mit einem Account testen, wo die Änderung wirksam werden sollte (Feld ändern und speichern)
Refresh Accounts starten

Änderungen sichtbar machen

Greifen erst beim Speichern des Datensatzes:

Einzelner Account → neu speichern (für Tests)

Alle Accounts → Refresh Accounts auf der Home-Seite von Kaleido:LABELS, Button Start

Häufige Fehler

Problem	Ursache

Problem	Ursache
Nichts ändert sich	Refresh Accounts nicht gestartet
Falsches Template greift	Fallback hat zu niedrige Priority
Text fehlt nur in einer Sprache	Code Entry für diese Sprache fehlt
Kontextwechsel klappt nicht	Lookup zeigt auf anderen Objekttyp
Nested Template wird nicht aufgelöst	Leerzeichen im Namen
Manuelle Anrede wird nicht überschrieben	Feld Empfängeranrede automatisch berechnen prüfen
Anrede bei Haushalten anders als früher	Gewollt: Haushalt priorisiert eigene Anrede

Grenzen

Max. 200 Templates, max. 100 Label Codes (Entries unbegrenzt)

Nur Objekt Account unterstützt

Sprachen: DE, FR, IT, EN

Tipps

Debug Mode am Label Object zeigt, welches Template gematcht hat. In Produktion ausschalten.

Condition Field am Label Field spart Generierung für irrelevante Datensätze.

Nesting flach halten.

List Views einmalig selbst sortieren (Salesforce-Limitation): nach Label Field, dann Priority. Bei Criteria und Output Zeilenumbruch aktivieren.

Setup (im Standard bereits erledigt)

Label Object registriert ein Objekt für die Label-Generierung. Aktuell nur Account. Hier sitzt auch der Debug Mode.

Label Field legt fest, welches Feld den generierten Text bekommt. Optional mit Condition Field.

Neuer Label Service: Anwendung und Konfiguration