Incontrol ist um den leistungsstarken Form Builder herum aufgebaut. Mit Aliasen kannst du ausgefüllte Daten aus deinem Formular an anderen Stellen erneut verwenden. So holst du mehr aus Incontrol heraus und arbeitest effizienter.
In diesem Artikel lernst du, was Aliase sind, wie du sie einrichtest und wie du sie verwendest.
Inhaltsverzeichnis
Was sind Aliase?
Ein Alias ist ein einzigartiger Name, den du einem Formularelement zuweist. Damit kannst du den ausgefüllten Wert an anderen Stellen wiederverwenden, zum Beispiel in statischem Text oder in einem Dokument. Mit einem Alias kannst du verschiedene Aktionen durchführen und Daten miteinander verknüpfen.
Aliase einrichten
Du kannst für die meisten Formularelemente und automatischen Nummerierungen einen Alias festlegen.
So geht’s:
-
Öffne die Einstellungen des Formularelements.
-
Gib im Feld „Alias“ einen logischen Namen ein.
-
Klicke rechts im Alias-Feld auf den Text, um das Label automatisch zu verwenden.
-
Du kannst auch direkt im Element rechts auf den Alias klicken und ihn anpassen.
Tipp: Wähle einen logischen Namen, damit du später einfach nachvollziehen kannst, welcher Alias wo verwendet wurde.
Wichtig: Nur Elemente mit einem Alias können exportiert werden.
Einen eingegebenen Wert in statischem Text wiederverwenden
Dank der Aliase kannst du Werte, die der Benutzer in ein Formularelement eingegeben hat, in einem statischen Text wiederverwenden.
Beispiel:
Ein Textelement hat den Alias "vorname". Der Benutzer gibt "Frits" ein. In einem statischen Text gibst du @vorname ein und Incontrol zeigt "Frits" an.
Wichtig:
Wenn mehrere Formularelemente denselben Alias haben, trennt Incontrol die Werte im statischen Text mit einem Komma.
Beispiel:
Zwei Textelemente haben beide den Alias @vorname. Der Benutzer gibt "Piet" und "Klaas" ein. Im statischen Text wird dann "Piet, Klaas" angezeigt.
Automatische Nummerierung verwenden
Du kannst eine eingestellte automatische Nummerierung in einem statischen Text anzeigen, indem du den Alias mit einem $-Zeichen statt eines @-Zeichens verwendest.
Beispiel:
$nummering_id zeigt die generierte Nummer an.
Wichtig zu wissen:
Da das $-Zeichen und das @-Zeichen in der Anwendung als automatische Nummerierung und Alias erkannt werden, kannst du diese Zeichen nicht einfach so in einem statischen Text verwenden.
Wenn du beispielsweise eine E-Mail-Adresse anzeigen möchtest, verwende @@ für ein @ und $$ für ein $.
Beispiel:
Gib im statischen Text ein:
support@@incontrol.app
Dies wird angezeigt als:
support@incontrol.app
Statische Aliassen aus Serverdaten
Einige Daten sind nur auf dem Server oder im System bekannt. Du kannst diese Daten in deinem statischen Text oder in PDF-Vorlagen verwenden, indem du den entsprechenden Alias verwendest.
Hier ist eine Übersicht der verfügbaren statischen Aliassen und was sie anzeigen:
| Alias | Beschreibung | Sichtbar in? |
|---|---|---|
| @user.name | Der Name des Benutzers | PDF & Web |
| @user.id | Die UUID des Benutzers | |
| @user.firstname | Der Vorname des Benutzers | PDF & Web |
| @user.lastname | Der Nachname des Benutzers | PDF & Web |
| @user.email | Die E-Mail-Adresse des Benutzers | PDF & Web |
| @user.reference | Der Referenzwert des Benutzers, der von der Public API oder dem CMS bereitgestellt wird | PDF & Web |
| @user.* | Der Wert, der in einem zusätzlichen Benutzerfeld festgelegt wurde | PDF & Web |
| @organization.name | Der Name der Organisation | PDF & Web |
| @organization.reference | Der Referenzwert der Organisation, der von der Public API oder dem CMS bereitgestellt wird | PDF & Web |
| @organization.* | Der Wert, der in einem zusätzlichen Organisationsfeld festgelegt wurde | PDF & Web |
| @organization.id | Die UUID der Organisation | |
| @organization.addressline | Die Adresse der Organisation | |
| @organization.zipcode | Die Postleitzahl der Organisation | |
| @organization.city | Die Stadt der Organisation | |
| @organization.country | Das Land der Organisation | |
| @organization.phone | Die Telefonnummer der Organisation | |
| @form.name | Der Name des Formulars | Immer sichtbar |
| @form.reference | Der Referenzwert des Formulars, der von der Public API oder dem CMS bereitgestellt wird | Immer sichtbar |
| @form.id | Die UUID des Formulars | |
| @folder.id | Die UUID des Ordners (falls zutreffend) | |
| @folder.name | Der Name des Ordners (falls zutreffend) | |
| @folder.datetime | Erstellungsdatum und -zeit des Ordners | |
| @folder.date | Erstellungsdatum des Ordners | |
| @folder.time | Erstellungszeit des Ordners | |
| @folder.* | Aliaswert eines Elements in den Ordnerdetails | |
| @draft.name | Der Name des Entwurfs | Immer sichtbar |
| @draft.datetime | Das Erstellungsdatum und die -zeit des Entwurfs als Code (yyMMdd-HHmmss) | |
| @draft.date | Das Erstellungsdatum des Entwurfs | |
| @draft.time | Die Erstellungszeit des Entwurfs | |
| @draft.reference | Der Referenzwert, wenn der Entwurf über die Public API erstellt wurde | |
| @draft.id | Die UUID des Entwurfs | |
| @draft.localdatetime | Das lokale Erstellungsdatum und die -zeit des Entwurfs | |
| @draft.localdate | Das lokale Erstellungsdatum des Entwurfs | |
| @draft.localtime | Die lokale Erstellungszeit des Entwurfs | |
| @document.time | Die Zeit des PDF | |
| @document.datetimecode | Das Datum und die Zeit des PDFs als Code (yyMMdd-HHmmss) | |
| @document.datetime | Das Datum und die Zeit des PDFs | |
| @document.date | Das Datum des PDFs | |
| @document.name | Der Name des Dokuments | |
| @document.id | Die UUID des Dokuments (kann sich nach Abschluss des Entwurfs ändern) | |
| @document.localdatetime | Das lokale Erstellungsdatum und die -zeit des Dokuments | |
| @document.localdatetimecode | Das lokale Erstellungsdatum und die -zeit des Dokuments als Code | |
| @document.localdate | Das lokale Erstellungsdatum des Dokuments | |
| @document.localtime | Die lokale Erstellungszeit des Dokuments | |
| @document.reference | Der Referenzwert beim Erstellen über die Public API | |
| @document.outputname | Der Name des Dokuments, wenn er vom @form.name abweicht |
Beispiel mit Benutzer
Der angemeldete Benutzer ist Piet Jansen.
-
@user.firstname zeigt "Piet" an
-
@user.lastname zeigt "Jansen" an
-
@user.name zeigt "Piet Jansen" an
Beispiel mit Dokumentdatetime
Das Konzept wurde am 2020-05-01 um 11:00 Uhr gestartet und am 2020-05-02 um 03:00 Uhr abgeschlossen.
${@document.datetime-@draft.datetime} zeigt 4 Stunden an.
Scoped Aliassen in Dynamischer Inhalt
Aliase zeigen ausgefüllte Daten erneut an. Dies gilt auch für Daten innerhalb von dynamischem Inhalt.
Wenn du Aliase in dynamischem Inhalt verwendest, möchtest du häufig ein scoped alias verwenden. Dies ist ein Alias mit einem Punkt davor.
Beispiel:
-
@alias (normales Alias): zeigt alle Werte mit diesem Alias aus dem ganzen Formular, getrennt durch Kommata.
-
@.alias (scoped Alias): zeigt nur den Wert innerhalb des spezifischen dynamischen Inhalts an.
Scoped Aliase sind besonders nützlich, wenn du mit dem Wiederholungs-Element arbeitest.