> For the complete documentation index, see [llms.txt](https://joinpoints.gitbook.io/test-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://joinpoints.gitbook.io/test-doc/einrichtung/customizing/klammersprache.md).

# Klammersprache

Mit der Joinpoints-Klammersprache fügst du Prozessdaten als Platzhalter in Texte ein. Joinpoints ersetzt sie bei der Ausführung automatisch durch die passenden Werte.

Das eignet sich für Notizen, E-Mails, SMS und Automationen.

### So funktionieren Platzhalter

Statt den Projekttitel jedes Mal manuell einzutragen, verwendest du einen Platzhalter:

```
Projekt: {jp.title}
```

Für einen Prozess mit dem Titel „Website Relaunch“ lautet die Ausgabe:

```
Projekt: Website Relaunch
```

### Aufbau

Ein Platzhalter hat immer dieses Format:

```
{id.feldname}
```

Dabei steht:

* `id` für den Bereich oder die Datenquelle.
* `feldname` für das Feld, dessen Wert ausgegeben wird.

Beispiel:

```
{jp.title}
```

Hier bezeichnet `jp` die Prozessdaten. `title` gibt den Prozesstitel aus.

### Häufig verwendete Platzhalter

| Feld             | Platzhalter                |
| ---------------- | -------------------------- |
| Titel            | `{jp.title}`               |
| Kontakt          | `{jp.customer}`            |
| Kontaktperson    | `{jp.contact_person}`      |
| Phase            | `{jp.currentProcessPhase}` |
| Erstellt am      | `{jp.createdAt}`           |
| Abgeschlossen am | `{jp.closedAt}`            |
| Gesamtzeit       | `{jp.trackedTime}`         |
| Geplanter Betrag | `{jp.amount}`              |
| IST-Betrag       | `{jp.realAmount}`          |
| Letzte Aktivität | `{jp.lastContact}`         |
| Zugeteilt an     | `{jp.workingUsers}`        |

### E-Mails und SMS personalisieren

In E-Mails und SMS kannst du auch Informationen über Absender und Empfänger verwenden.

#### Absender

| Feld       | Platzhalter       |
| ---------- | ----------------- |
| Name       | `{sender.name}`   |
| Geschlecht | `{sender.gender}` |

#### Empfänger

| Feld               | Platzhalter            |
| ------------------ | ---------------------- |
| Vorname            | `{receiver.firstname}` |
| Nachname           | `{receiver.lastname}`  |
| Vollständiger Name | `{receiver.name}`      |
| Geschlecht         | `{receiver.gender}`    |

Damit personalisierst du Nachrichten automatisch.

### Eigene Felder verwenden

Auch eigene [Datenfelder](/test-doc/einrichtung/customizing/datenstruktur.md) lassen sich als Platzhalter verwenden. Jedes Feld besitzt eine eigene Feld-ID.

Ein eigenes Feld mit folgenden Werten:

* Feldname: `CustomText`
* Feld-ID: `c_386`

verwendest du so:

```
{c_386.customtext}
```

{% hint style="info" %}
Die Feld-ID ist für jedes eigene Feld unterschiedlich.
{% endhint %}

<div align="left"><figure><img src="/files/jQTYdXPx5XAbUclcz0Pj" alt="" width="375"><figcaption></figcaption></figure></div>

### Klammersprache in Automationen

Verwende Platzhalter, um Inhalte in [Automationen](/test-doc/automationen/prozess-designer/automationen.md) dynamisch zu erstellen.

Ein häufiger Anwendungsfall ist **Notiz in Timeline schreiben**. Öffne dafür in deiner Pipeline den Bereich **Automation** und füge diese Automation hinzu.

Du kannst den Titel anschließend in einer [Bedingung](/test-doc/automationen/prozess-designer/bedingungen.md) prüfen:

* Wenn `{jp.title}` den Wert `Test 4` enthält, schreibt Joinpoints `Ja, Titel ist Test 4` in die Timeline.
* Andernfalls schreibt Joinpoints `Nein, Titel ist nicht Test 4` in die Timeline.

Verschiebe zum Testen einen Prozess mit dem Titel `Test 4` in die entsprechende Phase. Die Automation wird ausgeführt und erstellt die passende Notiz.
