> For the complete documentation index, see [llms.txt](https://joinpoints.gitbook.io/doku/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/doku/einrichtung/customizing/klammersprache.md). # Klammersprache Verwende Platzhalter, um Daten in Texten, Automationen und Exporten dynamisch auszugeben. Mit der Joinpoints-Klammersprache greifst du dynamisch auf Daten zu. Joinpoints ersetzt den Ausdruck durch den passenden Wert. Das eignet sich für Texte, E-Mails, SMS, Automationen und Exportvorlagen. ### Platzhalter für Projekte in Pipelines Verwende Platzhalter, wenn du Werte aus Projekten in der aktuellen Pipeline ausgeben möchtest: ``` Projekt: {jp.title} ``` Für einen Projekt mit dem Titel „Website Relaunch“ lautet die Ausgabe: ``` Projekt: Website Relaunch ``` `jp` steht für das Projekt, von welchem man einen Schritt in dessen Felder gehen kann. Nach dem Punkt folgt das gewünschte Feld. ### Häufige Platzhalter | Wert | Platzhalter | | ---------------- | -------------------------- | | Titel | `{jp.title}` | | Kontakt | `{jp.customer}` | | Kontaktperson | `{jp.contact_person}` | | Aktuelle 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}` | | Zugewiesen an | `{jp.workingUsers}` | ### E-Mails personalisieren Verwende in E-Mails auch Angaben zu Absendern und Empfängern. #### Absender | Wert | Platzhalter | | ---------- | ----------------- | | Name | `{sender.name}` | | Geschlecht | `{sender.gender}` | #### Empfänger | Wert | Platzhalter | | ------------------ | ---------------------- | | Vorname | `{receiver.firstname}` | | Nachname | `{receiver.lastname}` | | Vollständiger Name | `{receiver.name}` | | Geschlecht | `{receiver.gender}` | ### Eigene Felder verwenden Auch eigene [Datenstruktur](/doku/einrichtung/customizing/datenstruktur.md) lassen sich als Platzhalter verwenden. Jedes Feld besitzt eine eigene Feld-ID. Ein Feld mit der ID `c_386` verwendest du so: ``` {jp.c_386} ``` {% hint style="info" %} Feld-IDs sind je Account unterschiedlich. Kopiere sie nicht ungeprüft aus anderen Accounts. {% endhint %}
### Klammersprache in Automationen Verwende Platzhalter, um Inhalte in [Automationen](/doku/automationen/grundlagen-zum-prozess-designer/automationen.md) dynamisch zu erstellen. Ein häufiger Anwendungsfall ist **Notiz in Timeline schreiben**. Füge die Automation in deiner Pipeline hinzu. Du kannst den Titel anschließend in einer [Bedingungen](/doku/automationen/grundlagen-zum-prozess-designer/bedingungen.md) prüfen: * Enthält `{jp.title}` den Wert `Test 4`, schreibe `Ja, Titel ist Test 4`. * Andernfalls schreibe `Nein, Titel ist nicht Test 4`. Verschiebe zum Testen einen Prozess mit dem Titel `Test 4` in die entsprechende Phase. Die Automation wird ausgeführt und erstellt die passende Notiz. ### Klammersprache in Exportvorlagen Exportvorlagen verwenden Ausdrücke in geschwungenen Klammern. Damit greifst du auf den aktuellen Datensatz und verknüpfte Datensätze zu. Ein Ausdruck folgt diesem Muster: ``` {jp.verknuepfung.feld} ``` `jp`bezeichnet den aktuell exportierten Datensatz. Die Punkte folgen Verknüpfungen bis zum gewünschten Feld. Bei einer Eingangsrechnung kann der Ausdruck so aussehen: ``` {jp.customer.title} ``` Joinpoints startet bei der Rechnung, öffnet die Kundenverknüpfung und gibt deren Titel aus. ### Root als Startpunkt Man kann in der Klammersprache auch dirket vom Root-Joinpoint aus auf dessen Felder zugreifen. Besonders relevant ist das, wenn man Joinpoints in einer eigenen Ansicht als Startpunkt ({jp...} hat. Dann wäre der normale Weg vom Joinpoint außerhalb der Eigenen Ansicht: ``` {jp.customer.title} ``` Innerhalb der Eigenen Ansicht kann man direkt auf den Root zugreifen, sollte man sich in einer Eigenen Ansicht befinden (z.B. Buchungen bei Splitrechnungen): ``` {root.customer.title} ``` ### Direkte Feldauswahl, fester Wert oder Klammersprache Wähle die Ausgabeart passend zur Datenquelle: * **Direktes Joinpoints-Feld:** Der Wert liegt im aktuellen Datensatz. Beispiel: **Rechnungsdatum**. * **Fester Wert:** Der Inhalt ist für jeden Datensatz gleich. Beispiel: `ER`. * **Klammersprache:** Der Wert liegt in einer Verknüpfung oder wird dynamisch ermittelt. Beispiel: `{jp.customer.title}`. Beim [CSV](/doku/grundfunktionen/export/csv.md) kannst du über **Neue leere Spalte hinzufügen** einen festen Text oder einen Ausdruck eintragen. ### Verknüpfte Daten und eigene Felder exportieren Klammersprache eignet sich besonders für Daten aus verknüpften Datenbanken. Du vermeidest damit doppelt gepflegte Angaben. Eine Eingangsrechnung kann beispielsweise mit einem Lieferanten verknüpft sein. Den Lieferantennamen gibst du dann über die Verknüpfung aus, statt ihn auf jeder Rechnung zu speichern. Auch eigene Felder können in Exportausdrücken erscheinen: ``` {jp.customer.c_6} ``` Kennzeichnungen wie `c_6` oder `c_14` sind interne Feld-IDs. Sie können in jedem Account anders sein. {% hint style="warning" %} Kopiere Exportausdrücke mit eigenen Feldern nicht aus fremden Accounts. Verwende nach Möglichkeit eine Joinpoints-Vorlage. {% endhint %} ### DATEV- und BMD-Exporte Beim [DATEV](/doku/grundfunktionen/export/datev.md) sind die Exportspalten vorgegeben. Wähle je Spalte ein Joinpoints-Feld oder freien Text mit Klammersprache. Das Eingangsrechnungs-Template erstellt häufig Verknüpfungen zu Lieferanten, Buchhaltungskonten und Steuersätzen. DATEV-Ausdrücke können auf diese Daten zugreifen. Auch der [BMD](/doku/grundfunktionen/export/bmd.md) nutzt Klammersprache für verknüpfte Werte. Rechnungsnummer, Datum, Bruttobetrag und Währung lassen sich oft direkt auswählen. Nutze die mitgelieferte Exportvorlage als Ausgangspunkt. Sie enthält passende Verknüpfungen und Feld-IDs für deinen Account. ### Kurz zusammengefasst * Verwende `{jp.feld}` für Prozessdaten in Texten und Automationen. * Verwende `{root.verknuepfung.feld}` für verknüpfte Daten in Exporten. * Verwende Vorlagen, wenn eigene Felder oder komplexe Verknüpfungen beteiligt sind.