Teilnehmer*in an einer Bildungsmaßnahme; auch: Teilnahme. und/oder der dazugehörige Auftrag geöffnet sein oder der Personenfilter eingestellt werden.Video: Das Platzhalterverzeichnis
Video: Platzhalter einsetzen für Einzel- und Seriendokumente
Platzhalter werden verwendet, um Qualli.life zu "sagen", welche Daten wo eingefügt werden sollen. Dabei werden die Platzhalter durch die entsprechenden Daten im Text ersetzt und werden deshalb in Vorlagen genutzt. Platzhalter erkennen Sie immer am vorangestellten # ("Raute" oder zu Neudeutsch auch "Hashtag").
Die Verwendung der Platzhalter ist kontextabhängig, d.h. ja nachdem, was für ein Schriftgut Sie erstellen möchten, muss ein Tn Teilnehmer*in an einer Bildungsmaßnahme; auch: Teilnahme. und/oder der dazugehörige Auftrag geöffnet sein oder der Personenfilter eingestellt werden.
Folgendes Schriftgut können Sie mit Platzhaltern erstellen:
Beachten Sie unbedingt den Unterschied zwischen Serienbrief und Mehrfachdokument. Benutzen Sie ausschließlich #Adresse-Platzhalter für einen Serienbrief und #Sd-, #Ma- oder #Tn-Platzhalter für Mehrfachdokumente.
Serienbrief und Mehrfachdokument können nicht kombiniert werden, weil kein eindeutiger Bezug zwischen unterschiedlichen Inhalten und Empfängern hergestellt werden kann.
In folgenden Programmbereichen und -funktionen sind Platzhalter anwendbar:
Ab Qualli.life Version 16 wurde die Systematik der Platzhalter reformiert. Dadurch ist es Ihnen möglich Daten aus fast allen Programmbereichen in Schriftstücke oder Vorlagen einzufügen. Dementsprechend wurde auch die Platzhalterliste neu strukturiert, um das Auffinden von Platzhaltern zu erleichtern.
Die alten Platzhalter können selbstverständlich weiterhin genutzt werden. Sie werden intern in die neuen übersetzt.
Platzhalterliste: Basis-Platzhalter
Das Platzhalter-Verzeichnis können Sie aufrufen unter
In der Liste werden Ihnen die sog. Basisplatzhalter angezeigt. I.d.R. reichen diese für die meisten Einsatzszenarien aus. Diese sind nach ihrem Zweck gruppiert:
Die meisten Platzhalter sind immer gleich Aufgebaut:
Nachfolgend sind die Basis-Platzhalter aufgeführt, werden kurz erläutert und sukzessiv mit einigen Beispielen befüllt.
#Tn
Dies sind die Platzhalter, die Sie wahrscheinlich am häufigsten nutzen werden, weil diese in fast jedem Kontext verwendet werden können, die sich auf Teilnehmende und deren Teilnahmen beziehen.
Viele der #Tn-Platzhalter können auch mit #Ma ersetzt werden, sofern dieselben Programmbereiche auch für die Personenart "Mitarbeiter" existieren. Dies gilt insbesondere für allgemeine Stammdaten, Weitere Informationen oder medizinische Stammdaten.
Diese Platzhalter können die meisten Daten aus dem Programmbereich TEILNEHMER in einem Dokument ausgeben, sprich personenabhängige und/oder teilnahmeabhängige Daten. Sie müssen im SgA Die interne Abkürzung für "Schriftgut-Assistent". Der Assistent ermöglicht das Generieren von Dokumenten. jedoch vorher den Personenfilter auf "Teilnehmer" stellen. Nachfolgend werden die Programmbereiche aufgelistet und die möglichen Platzhalter angegeben.
Für die Daten aus dem Bereich QUALIFIZIERUNG existieren keine Platzhalter. Um Daten aus diesem Bereich in ein Dokument auszugeben, können Sie den Berichtsgenerator oder die Druckfunktion im jeweiligen Programmbereich verwenden.
Daten aus "Allgemeine Stammdaten"
| Daten | Platzhalter |
|---|---|
| Anrede | #Tn.Name.Anrede |
| Ausweisnummer | #Tn.Ausweisnummer |
| Geburtsdatum | #Tn.Geburtsdatum |
| Geburtsname | #Tn.Geburtsname |
| Geburtsort | #Tn.Geburtsort |
| Geschlecht | #Tn.Geschlecht |
| Nach- und Vorname | #Tn.Name.NachnameVorname |
| Nachname | #Tn.Name.Nachname |
| Staatsangehörigkeit(en) | #Tn.Staatsangehörigkeit |
| Titel | #Tn.Name.Titel |
| Vor- und Nachname | #Tn.Name.VornameNachname |
| Vorname | #Tn.Name.Vorname |
#Tn.Nr(Bezeichnung der Referenznummer): Geben Sie in die Klammer die genaue Bezeichnung oder Kurzbezeichnung der Referenznummer ein:
| Bezeichnung Referenznummer | Platzhalter (mit Kurzform) |
|---|---|
| ABH ausbildungsbegleitende Hilfen (Verfahrenszweig 01). Nicht zu verwechseln mit "ABH"="Ausländerbehörde"-Aktenzeichn |
#Tn.Nr(ABH-Az.) |
| Aktenzeichen | #Tn.Nr(Az.) |
| BA Bundesagentur für Arbeit-Kundennummer |
#Tn.Nr(BA-Nr.) |
| BAMF Bundesamt für Migration und Flüchtlinge-Aktenzeichen |
#Tn.Nr(BAMF-Az.) |
| BAMF-Aktenzeichen (Erstverfahren) | #Tn.Nr(BAMF-Az.EV) |
| BAMF-Aktenzeichen (Wiederholverfahren) | #Tn.Nr(BAMF-Az.WV) |
| BVA Bundesverwaltungsamt-Aktenzeicen |
#Tn.Nr(BVA-Az.) |
| Debitorennummer | #Tn.Nr(Deb.-Nr.) |
| Kreditorennummer | #Tn.Nr(Kred.-Nr.) |
| Kundenummer | #Tn.Nr(Kunden-Nr.) |
| Personalnummer | #Tn.Nr(Pers.-Nr.) |
| Steuernummer | #Tn.Nr(Steuer-Nr.) |
| TGS Träger der Grundsicherung-Aktenzeichen |
#Tn.Nr(TGS-Az.) |
Dieses Prinzip gilt für alle Referenznummern, die Sie in Qualli.life eingeben können. Ersetzen Sie #Tn einfach mit #Sd, #Ma, #Benutzer, #Kt, #Mandant Ein System auf einem Server, die Benutzer bedienen können, ohne dass sie gegenseitigen Einblick in Daten, Benutzerverwaltung o.Ä. haben. Der Mandant (engl. "tenant") ist die oberste Ordnungsinstanz in dem IT-System und stellt eine datentechnisch und organisatorisch abgeschlossene Einheit im System dar. Der Mandant strukturiert somit die Nutzung des Systems., #Auftrag. Beachten Sie, dass jede Datenart andere Referenznummer-Bezeichnungen hat.
#Sd.Merkmal(Bezeichnung des Merkmals): Geben Sie in die Klammer die Bezeichnung des Merkmals ein, das Sie hinterlegt haben (siehe auch "Merkmale").
Die Unterscheidung zwischen personenabhängigen und teilnahmeabhängigen Daten ist besonders für Merkmale entscheidend, weil sie personenabhängig, teilnahmeabhängig oder beides sein können.
Der Platzhalter #Tn.Merkmal gibt grundsätzlich teilnahmeabhängige Merkmale aus. Wenn Sie personenabhängige Merkmale ausgeben möchten, verwenden Sie den Platzhalter #Sd.Merkmal.
Diese Angaben sind Merkmale. Verwenden Sie den Platzhalter #Tn.Merkmal() und geben Sie in die Klammer die Bezeichnung des Datenfelds ein.
#Tn.Bemerkungen
Das Prinzip für Adressen ist für alle Platzhalter dasselbe.
Bei allen Adressen können zwei Arten festgelegt werden, die Daten in einem festgelegten Format ausgeben:
Im Bereich "Adressen" sind diese erkennbar an den Symbolen (Haus für Hauptanschrift, Brief für Korrespondenzanschrift).
Geben Sie diese Platzhalter auch in die Filterzeile der Platzhalterliste ein, um sich alle Möglichkeiten anzeigen zu lassen. Wenn Sie bestimmte Daten ausgeben möchten, hängen Sie sie an den gewünschten Platzhalter an, z.B.:
Die Platzhalter für Adressen sind sehr flexibel und können mit anderen Platzhaltern kombiniert werden, die insbesondere Personendaten ausgeben, beispielsweise Zuständigkeiten, Kontaktpersonen oder Ansprechpartner (siehe auch "#Tn.Med.Zust").
Daten aus "Weitere Informationen"
Die meisten Daten dieses Programmbereichs können durch Platzhalter ausgegeben werden, wenn die Bezeichnung des Datenfelds oder des Dropdowns angehängt wird.
| Daten | Platzhalter |
|---|---|
| Rechtskreis | #Tn.Rechtskreis |
| Bedarfsgemeinschaft | #Tn.Bedarfsgemeinschaft |
| ALG I/II | #Tn.ALGI/#Tn.ALGII |
| Sozialhilfe | #Tn.Sozialhilfe |
| Härtefallregelung | #Tn.Härtefall |
| Migrationshintergrund vorhanden | #Tn.Migrationshintergrund |
| Ist Aussiedler | #Tn.Aussiedler |
| Ist Spätaussiedler | #Tn.Spätaussiedler |
| Ist unbegleitet, minderjähriger Flüchtling | #Tn.UnbegleiteterFlüchtling |
| Arbeitserlaubnis liegt vor | #Tn.Arbeitserlaubnis |
| Reha-Fall | #Tn.RehaFall |
| Eltern sind getrennt lebend | #Tn.ElternGetrennt |
| Familienstand | #Tn.Familienstand |
| Anzahl Kinder | #Tn.AnzahlKinder |
| Kinderbetreuung erforderlich | #Tn.KinderBetreuung |
| Konfession | #Tn.Konfession |
| Führerschein vorhanden | #Tn.Führerschein |
| Fahrerlaubnisklasse(n) | #Tn.Fahrerlaubnisklassen |
| geeignetes Kfz vorhanden | #Tn.Kfz |
| Konfektionsgröße | #Tn.Konfektionsgröße |
| Schuhgröße | #Tn.Schuhgröße |
Geben Sie den Platzhalter #Tn.Unterbringung in die Filterzeile ein, um sich alle möglichen Platzhalter aus dem Bereich "Unterbringung" ausgeben zu lassen.
Geben Sie in die Filterzeile #Tn.Konto ein, um sich alle möglichen Platzhalter des primären Kontos aus dem Bereich "Bankverbindungen" ausgeben zu lassen.
Daten aus "medizinische Stammdaten"
Die Daten für diesen Platzhalter werden entnommen aus dem Programmbereich
Diese werden z.B. häufig für Reha-Maßnahmen gebraucht. Während der Pandemie wird wahrscheinlich der Unterpunkt "Impfungen" wichtiger und unter "Zuständigkeiten" können ggfs. Ärzte oder Notfallkontakte hinterlegt werden. Diese Daten sind selbstverständlich nicht nur auf die Personenart Tn beschränkt. Zu den Platzhaltern #Tn.Med.Impfung und #Tn.Med.Zust gibt es jedoch einige Besonderheiten, die Sie beachten müssten.
Geben Sie #Tn.Med in die Filterzeile ein, um sich alle möglichen Platzhalter aus diesem Bereich anzeigen zu lassen.
#Tn.Med.Impfungen und #Tn.Med.Impfung
Diese rufen die Daten aus dem Unterpunkt "Impfungen" ab. Diese beiden Platzhalter unterscheiden sich wie folgt:
#Tn.Med.Impfungen(\n) →
22.03.2021: Corona (Schutz bis 21.05.2021),
01.01.2019: Polio (Schutz bis 31.12.2023),
15.03.2018: Masern (Schutz bis 15.03.2022)
Die Reihenfolge der ausgegebenen Daten ist chronologisch geordnet von der jüngsten zur ältesten Impfung.
Wenn Sie eine bestimmte Impfung von der obigen Liste ausgeben möchten, müssen Sie die Position der Impfung in der ausgegebenen Liste angeben. Im obigen Beispiel ist die Polio-Impfung an zweiter Stelle, d.h. eine "2" als Parameter gibt nur diese aus:
#Tn.Med.Impfungen(2) → 01.01.2019: Polio (Schutz bis 31.12.2023)
#Tn.Med.Impfungen(1).Bemerkungen → Impfstoff: BionGineering
Zweite Impfdosis am 21.05.2021 (Impfung aktualisieren!!!)
#Tn.Med.Impfungen(2).Bemerkungen → Vierfachimpfung Boostrix
#Tn.Med.Impfungen(3).Bemerkungen → Nachweis als Kopie in Stammakte gespeichert
#Tn.Med.Impfung(Masern) → 15.03.2018: Masern (Schutz bis 15.03.2022)
01.07.2021: #Tn.Med.Impfung(Masern).SchutzAktiv → ja
16.03.2022: #Tn.Med.Impfung(Masern).SchutzAktiv → nein
Da die ausgegebenen Daten Boole'sche Werte sind, können Sie auch alternative Werte definieren (siehe auch "Boole'sche Werte (ja-/nein-werte)").
#Tn.Med.Zust
Mit diesem Platzhalter können Sie medizinische Zuständigkeiten abrufen. Diese können Ärzte, Notfallkontakte oder Wirkungskreise sein. Um den hinterlegten Kontakt auszugeben, muss die Bezeichnung des Kontakts als Parameter eingefügt werden. Als Beispiel wurde eine Zuständigkeit in den medizinischen Stammdaten als "Notfallkontakt" und eine als "Behandelnder Arzt" angelegt:
Es muss nicht die genaue Bezeichnung in Klammern eingegeben werden. Qualli.life erkennt die Bezeichnung auch, wenn ein Teil der Bezeichnung eingegeben wird, wie z.B. bei "Behandelnder Arzt" → (Arzt).
Wurden mehrere Zuständigkeiten unter derselben Bezeichnung angelegt, z.B. Notfallkontakt, werden alle Personen, die unter dieser Bezeichnung hinterlegt wurden als Liste ausgegeben. Somit sind auch wieder die Listen-Parameter möglich (siehe auch "Listen (Auflistung)"):
Weil die hinterlegte Zuständigkeit an einen Kontakt aus dem Adressbuch verknüpft ist, können auch alle hinterlegten Daten des Kontakts ausgegeben werden. Dabei können sowohl Hauptadresse (HA) als auch Korrespondenzadresse (KA) ausgegeben werden, z.B.:
Daten aus "Schule und Beruf"
| Daten | Platzhalter |
|---|---|
| Anzahl Schuljahre | #Tn.Bildung.AnzahlSchuljahre |
| Bildungsstand (ISCED International Standard Classification of Education
Dient der Klassifizierung von Schultypen und Schulsystemen und wird auch für die Angabe des Bildungsniveaus verwendet.) |
#Tn.Bildung.IscedLevel |
| Deutsch-Fremdsprache | #Tn.Bildung.DeutschFremdsprache |
| Muttersprache | #Tn.Bildung.Muttersprache |
|
Niederschwellige Angebote |
#Tn.Bildung.Niederschwellig |
| Schreibkundigkeit | #Tn.Bildung.Schreibkundigkeit |
| Schulpflicht | #Tn.Bildung.Schulpflicht |
| Sprachlevel | #Tn.Bildung.Sprachkundigkeit |
| Sprachlevel-Zusatz | #Tn.Bildung.SprachkundigkeitZusatz |
Daten aus "Teilnahmeverlauf"
| Daten | Platzhalter |
|---|---|
| Bezeichnung | #Tn.Auftrag.Anzeigename |
| Teilnahmestatus | #Tn.Status |
| Datum des letzten Statuswechsels | #Tn.StatusSeit |
| Förderzeitraum | #Tn.Förderzeitraum, #Tn.Förderzeitraum.Von, #Tn.Förderzeitraum.Bis |
| Teilnahmezeitraum | #Tn.Zeitraum, #Tn.Zeitraum.Von, #Tn.Zeitraum.Bis |
Arbeitsgelegenheiten
(Verfahrensweig 06): Geben Sie diesen Platzhalter in die Filterzeile ein, um sich alle möglichen Platzhalter aus dem Bereich Aktuelle Teilnahme→Zusätzliche Angaben für die AGH-Maßnahme anzeigen zu lassen. Berufsausbildung in außerbetrieblichen Einrichtungen
(Verfahrenszweig 01) in den Ausprägungen BaE integrativ [BaE 1], Bae kooperativ [BaE 2] und BaE kombiniert [BaE 3]: Geben Sie diesen Platzhalter in die Filterzeile ein, um sich alle möglichen Platzhalter aus dem Bereich Aktuelle Teilnahme→Zusätzliche Angaben für die BaE- bzw. AuW-Maßnahme anzeigen zu lassen. Deutschtest für Zuwanderer
Ein Sprachtest, der den Abschluss der Teilnahme an den Integrationskursen bildet. Er ist i.d.R. eine Voraussetzung für den Daueraufenthalt oder die Einbürgerung von Migranten.: Geben Sie diesen Platzhalter in die Filterzeile ein, um sich alle möglichen Platzhalter aus dem Bereich Aktuelle Teilnahme→Zusätzliche Angaben für Sprachtests (DTZ) anzeigen zu lassen. Integrationskurs: Geben Sie diesen Platzhalter in die Filterzeile ein, um sich alle möglichen Platzhalter aus dem Bereich TEILNEHMER→Einstufungstest Kursanmeldung→Anmeldedaten anzeigen zu lassen.| Daten | Platzhalter |
|---|---|
| EMAW Elektronische Maßnahmeabwicklung
(Verfahren, das die Art und Weise der Datenübertragung zwischen der Bundesagentur für Arbeit und dem Bildungsträger beschreibt)
Aussprache: emaw aktiv? |
#Tn.EmawAktiv |
| Bemerkungsverlauf der EMAW-Nachricht | #Tn.EmawBemerkungen |
| Ansprechpartner der EMAW-Nachricht | #Tn.AnsprechpartnerBA |
| Träger-CoSach-ID der EMAW-Nachricht | #Tn.TrägerCoSachID |
| Maßnahme-CoSach-ID der EMAW-Nachricht | #Tn.MaßnahmeCoSachID |
| Kunde-CoSach-ID der EMAW-Nachricht | #Tn.KundeCoSachID |
| Maßnahmereferenznummer des Auftrags |
#Tn.Auftrag.eMaw.Mrf Diese kann noch |
| Trägerreferenznummer des Auftrags | #Tn.Auftrag.eMaw.Trf |
#Tn.Merkmal(Bezeichnung des Merkmals): Geben Sie in die Klammer die Bezeichnung des Merkmals ein, das Sie hinterlegt haben (siehe auch "Merkmale").
Die Unterscheidung zwischen personenabhängigen und teilnahmeabhängigen Daten ist besonders für Merkmale entscheidend, weil sie personenabhängig, teilnahmeabhängig oder beides sein können.
Der Platzhalter #Tn.Merkmal gibt grundsätzlich teilnahmeabhängige Merkmale aus. Wenn Sie personenabhängige Merkmale ausgeben möchten, verwenden Sie den Platzhalter #Sd.Merkmal.
Zudem kann auch die hinterlegte Adresse der Person mit den Zusätzen des Adresse-Platzhalters ausgegeben werden, z.B.:
#Tn.Zust(Ausbilder).HA→Wohnort (Rankestraße 9, 86562 Berg im Gau)
#Tn.Zust(Ausbilder).HA.Telefon1→08433 95 89 23
#Tn.Zust(Ausbilder).HA.Email1→AmaldaBolger@cuvox.de
Daten aus dem Bereich QUALIFIZIERUNG
Aus dem Bereich QUALIFIZIERUNG können nur einige Daten durch Platzhalter ausgegeben werden. Der Großteil der Daten aus diesem Bereich kann nicht durch Platzhalter ausgegeben werden. Dies ist nur durch Druck oder dem Generieren eines Berichts möglich.
| Daten | Platzhalter |
|---|---|
| Qualifizierungsziel | #Tn.Qualifizierungsziel |
| Hauptschulabschluss als Ziel | #Tn.HsaAlsZiel |
| Förderbedarf | #Tn.Förderbedarf |
| komplexer Förderbedarf | #Tn.KomplexerFörderbedarf |
#Adresse
#Adresse-Platzhalter werden nur für den Einsatz in Serienbriefen verwendet und werde ausschließlich im SgA aktiviert. Darin öffnet sich ein Fenster, wo sämtliche Empfänger aus der Adressverwaltung ausgewählt werden können.
| Platzhalter in Vorlage | Ergebnis |
|---|---|
|
#Adresse.Firmenname z. Hd. #Adresse.Geschlecht("Herr", "Frau") #Adresse.Name.NachnameVorname #Adresse.Straße #Adresse.PlzOrt |
Bob-Floy z. Hd. Frau Ebenholz Zoisyte Hydrargyrum-Chaussee 56 19654 Castor
|
Die in der Klammer stehenden Ausdrücke sind sog. Parameter. Parameter bestimmen den Platzhalter genauer. Für jede Datenart gibt es individuelle Parameter, die eigene Funktionen haben (siehe auch "Parameter").
Im Fall des Platzhalters #Geschlecht("Herr", "Frau") wird Qualli.life "gesagt": Wenn der Ansprechpartner männlich ist, dann nehme "Herr"; wenn der Ansprechpartner weiblich ist, dann nehme "Frau"; wenn kein Geschlecht angegeben wurde, dann lasse es weg.
Dieser kann jedoch auch in Fließtexten verwendet werden, sodass der Genus automatisch angepasst wird. Mehr zu diesem besonderen Platzhalter, erfahren Sie unter "#Geschlecht".
#Eingabe
Dieser spezielle Platzhalter wird nur im SgA aktiviert. Damit können zusätzliche Daten im SgA eingegeben werden. Dies ist für Daten oder Informationen gedacht, die Benutzer beim Erstellen des Dokuments eingegeben müssen. Im SgA erscheint dann ein Feld, in der der Benutzer selbst Daten oder Informationen eingeben kann. Die Parameter (Ausdruck in Klammern) bestimmen, welche Angaben der Benutzer machen darf. In einem #Eingabe-Platzhalter können mehrere Parameter eingetragen werden.
Die hier eingegebene Bezeichnung wird dem Benutzer angezeigt. Daran erkennt er, welche Eingabe von ihm verlangt wird.
| Platzhalter in Vorlage | Ergebnis |
|---|---|
#Eingabe(Abwesenheitsgrund) | Anzeige im SgA:
Ausgabe im Dokument: Arztbesuch |
Gibt an, welche Art von Daten eingegeben werden sollen. Zur Verfügung stehen:
Zur Eingabe von Texten mit beliebigem Inhalt. Diesen Parameter müssen Sie nicht zusätzlich als Parameter angeben. Die Zeichenlänge im Eingabefeld ist allerdings auf 1.016 Zeichen begrenzt. So sähe es im SgA mit Vorschau aus:
Eingabe oder Auswahl eines Datums. Durch den zusätzlichen Parameter "Format", können Sie ein Format für das Datum festlegen. Wenn Sie Datum und Uhrzeit im Dokument haben möchten, fügen Sie dem Dokument einen weiteren #Eingabe-Platzhalter mit dem Parameter "Uhrzeit" hinzu.
Eingabe oder Auswahl einer Uhrzeit. Durch den zusätzlichen Parameter "Format", können Sie ein Format für das Datum festlegen. Wenn Sie Uhrzeit und Datum im Dokument haben möchten, fügen Sie dem Dokument einen weiteren #Eingabe-Platzhalter mit dem Parameter "Datum" hinzu.
Stellt ein Auswahlfeld mit vordefinierten Einträgen zur Verfügung. Der Benutzer kann jedoch immer noch einen beliebigen Text eingeben. Im SgA werden dann die Auswahlmöglichkeiten angezeigt, die Sie eingegeben haben
Das Prinzip ist das gleiche wie beim Parameter "Auswahl". Hier kann jedoch der Benutzer keine eigenen Texte eingeben, sondern muss eine der Auswahlmöglichkeiten nehmen.
Stellt ein Auswahlfeld wie bei "Auswahl" zur Verfügung. Der Benutzer kann jedoch mehrere Einträge aus der Liste auswählen. Diese werden hintereinander und durch Kommata getrennt im Dokument ausgegeben.
Dieser Parameter ist optional für die Datentypen "Datum" sowie "Uhrzeit" und gibt das Ausgabeformat an. Zur Verfügung stehen:
#Auftrag
Mit diesem Platzhalter, können Sie alle Daten aus der Registerkarte AUFTRAG in Dokumente ausgeben. Die ausgegebenen Daten beziehen sich immer auf den derzeit ausgewählten Auftrag (→Blick auf den Auftrags-Infobereich). Im SgA können Sie jedoch auch einen anderen Auftrag auswählen.
Dieser Platzhalter bezieht sich immer nur auf einen Auftrag. Mehrfachdokumente, die sich ausschließlich auf unterschiedliche Aufträge beziehen, sind daher nicht möglich. Der Bezug bei diesem Platzhalter liegt immer auf Teilnahmen; also sobald eine Person an einen Auftrag geknüpft wurde. Die Platzhalter #Auftrag.[...] werden dann mit den Auftragsdaten der jeweiligen Teilnahme ersetzt.
#Praktikum
Mit diesem Platzhalter, können Sie in einem Dokument Daten zu einer praktischen Tätigkeit ausgeben. Direkt aus dem Programmbereich QUALIFIZIERUNG→Praktische Tätigkeiten mit der Aktion: Tätigkeitsbezogenes Dokument erstellen, wird die aktuelle praktische Tätigkeit verwendet.
Mithilfe des SgA wird Ihnen bei Einzel- und Mehrfachdokumenten die Möglichkeit gegeben eine bestimmte praktische Tätigkeit auszuwählen.
In allen Fällen müssen im gewünschten Dokument diese Platzhalter verwendet werden.
Dieser Platzhalter gilt für alle Personenarten, die Einträge im Bereich "Praktische Tätigkeiten" haben. Für die Personenart Tn kann auch alternativ der Platzhalter #Tn.Praktikum.[...] verwendet werden.
#Kt
Das Prinzip dieses Platzhalter ist dasselbe wie zum Ausgeben von siehe auch "Adressen".
Dieser funktioniert nur im SgA. Hiermit können Sie Daten eines bestimmten Kontakts mit dem SgA ausgeben, wenn Sie im SgA "Einen Kontakt aus dem Adressbuch" auswählen.
Im Anschluss daran, haben Sie die Möglichkeit einen Kontakt aus dem Adressbuch auszuwählen, auf den sich das Dokument bezieht.
#Mandant
Mit diesem Platzhalter, können Sie Ihre Mandantendaten ausgeben. Dieser wird meist in Geschäftsbriefen in Kopf-, Fuß- oder Adresszeilen verwendet, um z.B. die Firmenadresse sowie Bankverbindungen oder USt-ID anzugeben.
Dieser Platzhalter kann für alle Dokumente verwendet werden. Die Daten beziehen sich dabei immer auf die Mandantenstammdaten.
#Benutzer
Dieser Platzhalter gibt die Daten des Benutzers im Dokument aus. Diese stammen von Ihren Mitarbeiterstammdaten. Dieser wird meist in Adresszeilen, Grußzeilen oder Unterschriftenzeilen verwendet.
Dieser Platzhalter kann für alle Dokumente verwendet werden. Die Daten beziehen sich dabei immer auf die eigenen Benutzerstammdaten.
#Ma
Die meisten dieser Platzhalter ähneln denen der ""-Platzhalter. Sofern dieselben Programmbereiche auch für die Personenart Tn existieren, kann einfach #Tn mit #Ma ersetzt werden. Dabei können dann die Daten des aktuell ausgewählten Mitarbeiters ausgewählt werden.
Dieser Platzhalter gibt Daten der Mitarbeiter im Dokument aus. Sie müssen jedoch vorher den Personenfilter auf "Mitarbeiter" stellen.
#Sd
Diese Platzhalter gelten für alle Personenarten und geben Stammdaten aus, je nachdem welche Personenart im Personenfilter eingestellt ist. Benutzen Sie diese Platzhalter für Schriftgut, das auf sämtliche Personenarten zutrifft, z.B. allgemeine Datenschutzerklärungen.
#Datum
Dies ist ein besonderer Platzhalter, der das aktuelle Datum oder einen Stichtag ausgibt.
Der Stichtag ist das Referenzdatum, das im aktuellen Kontext zum Füllen des Platzhalters verwendet wird. Beim Erstellen eines Dokuments wird explizit nach dem Stichtag gefragt, damit die richtigen Daten ausgegeben werden können, die bis zum Stichtag galten.
#Geschlecht
Dieser Platzhalter ist auch in allen Personenplatzhaltern enthalten, die das Merkmal "Geschlecht" besitzen, z.B. #Tn.Geschlecht. Verwenden Sie zukünftig diese Platzhalter, da der Kontext berücksichtigt wird und der allgemeine Platzhalter #Geschlecht langfristig wegfällt.
Dies ist ein sehr flexibler Platzhalter speziell für Personen. Wie unter "#Adresse" bereits erwähnt, nimmt Qualli.life genau den Ausdruck für Personen, den Sie als "männlich" oder "weiblich" angegeben haben. Der Aufbau des Parameters ist dabei immer der gleiche:
#Geschlecht("männliche Form"; "weibliche Form"; "unbestimmte Form")
Die letzte Position "unbestimmte Form" kann auch ausgelassen werden, wenn Sie keinen verwenden. Mit diesem Platzhalter können auch ganze Texte bezüglich des Geschlechts einer Person angepasst werden. Ein Beispiel:
Sehr geehrte Damen und Herren,
der Tn Diego Quandto ist wiederholt nicht zur Maßnahme erschienen. Aufgrund des festgestellten Pflichtverstoßes erhält er eine Abmahnung. Wir haben den Tn bereits ausdrücklich darauf hingewiesen, dass er sich künftig an die bekannten Betriebsregeln unseres Hauses zu halten hat. Ein weiterer Verstoß kann zur Kündigung/Abmeldung aus der Maßnahme führen.
In diesem Beispiel müssen die Artikel und Pronomen nach dem Geschlecht des Tn angepasst werden. Betroffen sind hierbei folgende Sätze:
Dies erreicht man durch den Platzhalter #Geschlecht("m"; "w"; "x"). Die möglichen Formen müssen als Parameter in die Klammer eingefügt werden. Damit Qualli.life also automatisch die Artikel und Pronomen nach dem Geschlecht des Tn anpasst, müssen sie wie folgt in der Vorlage ersetzt werden:
| Vorlage | Ergebnis |
|---|---|
| #Geschlecht("der"; "die") Tn #Tn.Name.VornameNachname ist [...] erschienen. |
Männliche Form: der Tn Diego Quandto ist [...] erschienen. Weibliche Form: die Tn Cana Alberona ist [...] erschienen. |
| Aufgrund [...] #Geschlecht("er"; "sie") eine Abmahnung. |
Männliche Form: Aufgrund [...] er eine Abmahnung. Weibliche Form: Aufgrund [...] sie eine Abmahnung. |
| Wir haben #Geschlecht("den"; "die") Tn [...], dass #Geschlecht("er"; "sie") sich künftig [...] zu halten hat. |
Männliche Form: Wir haben den Tn [...], dass er sich künftig [...] zu halten hat. Weibliche Form: Wir haben die Tn [...], dass sie sich künftig [...] zu halten hat. |
#Vorlage
Diese Platzhalter funktionieren nur im SgA sowie im Vorlagenmanager und beziehen sich auf das Dokument selbst. Diese gibt die Eigenschaften (Metadaten auch Metainformationen. Strukturierte Daten die Informationen über Merkmale anderer Daten enthalten. Metadaten werdne oft dazu eingesetzt, um Informationsressourcen zu beschreiben und dadurch besser auffindbar zu machen und Beziehungen zwischen den Materialien herzustellen; z.B. werden in einer Bibliothek Metadaten aller Ressourcen gesammelt, damit Recherchierende genau das Meterial erhalten, die ihrem Zweck dient (Bachelor-, Masterarbeit etc.). Metadaten dienen auch der eindeutigen Angabe einer Quelle.) des Dokuments aus, die Sie unter "Eigenschaften" finden (Rechtsklick auf das Dokument).
Dies öffnet ein Dialogfenster mit den Metadaten des Dokuments:
#Seite
Mit dem #Seite-Platzhalter können nur Daten aus der Kategorie "Eingabe" und "Vorlage" ausgegeben werden (siehe auch "Der Seitenkonfigurator").
Mit diesem Platzhalter, können Sie Daten aus selbsterstellten Seiten in Dokumente ausgegeben werden. Um die richtigen Daten auszugeben muss der Pfad des gewünschten Datenfeldes als Parameter angegeben werden: #Seite(Seitenname.[Containerelement.]Feldname)
Beachten Sie dabei folgende Grundsätze:
die Gestaltung eines Objekts; ursprünglich aus der Drucktechnik: Texte und Bilder wurden auf einer Seite so arrangiert, dass es ein stimmiges Gesamtbild entsteht. Im IT-Bereich wird meist die konsistente Visualisierung von Programmbereichen bezeichnet. Qualli.life nutzt z.B. zwei vorherrschende Layouts: Formular- und Tabellen-Layout-Elemente "Expanderfeld" oder "Tabelle" verschachtelt wurde. Für einige Seitenelemente ist es empfehlenswert den internen Feldnamen allgemein zu halten. Falls Seitenelemente sich nämlich ändern sollten (z.B. die Bezeichnung des Elements), bleibt der Platzhalter für andere Anwendungsfälle erhalten.
Parameter
Parameter dienen dazu Inhalte der Platzhalter näher zu bestimmen oder ggfs. das Format zu ändern. Parameter sind immer die Ausdrücke in Klammern und können, abhängig vom Platzhalter, obligatorisch oder fakultativ sein.
Je nach Eigenschaft und Datentyp des Platzhalters , also ob es sich beim Platzhalter um Text, Zahl, Datum etc. handelt, können unterschiedliche Parameter verwendet werden. Aus diesem Grund sind die nachfolgenden Parameter nach Datentypen sortiert.
Namen
Damit sind alle Platzhalter gemeint, die die Eigenschaft "Name" enthalten und den Datentyp "Text" haben, z.B.:
Mit den Parametern, kann die Reihenfolge und Form eines Namens bestimmt werden:
Anstatt der Parameter-Texte, können auch Zahlen verwendet werden. Jede Zahl steht dabei für ein Format bzw. Namensteil:
Datums-uhrzeitangaben
Damit sind Platzhalter des Typs "Datums-/Uhrzeitangabe" gemeint. Nachfolgende Parameter kennen Sie bereits aus dem #Eingabe-Platzhalter. Diese sind an Excel angelehnt und gelten in allen deutschsprachigen Rechnern:
T=Tag, M=Monat (nur bei Datum als "Monat" definiert), J=Jahr, H=Stunde, M=Minute (nur bei Uhrzeit als "Minute" definiert), S=Sekunde
Nachfolgende Formate können Sie auch verwenden, sind jedoch abhängig von der im PC eingestellten Sprache:
d=Date, t=Time, y=Year, m=Month, g=vollständiges Datum-Uhrzeit-Format
Wenden Sie sich gerne an den Support, falls Sie weitere Formate wünschen als die oben aufgeführten.
Zahlen
Bei Zahlen können Sie das Format bestimmen und ggfs. die Standardwährung ausgeben. Diese Parameter funktionieren bei allen Platzhaltern, die Zahlen ausgeben, d.h. auch bei Datumsangaben, die z.B. nur den Tag ausgeben: #Tn.Versorgungsamt.GdB(D3) → 060
Folgende Parameter können Sie verwenden:
Gibt die Zahl mit zwei Nachkommastellen und der Standardwährung aus. Die Standardwährung wird aus der eingestellten Sprache des Rechners entnommen. Falls Sie mehr Nachkommastellen wünschen, können Sie die Anzahl der Nachkommastellen angeben. Für drei Nachkommastellen, müssen Sie als Parameter "(c3)" eintragen um das Ergebnis "15,590 €" zu erhalten.
Wenden Sie sich gerne an den Support, falls Sie weitere Formate wünschen als die oben aufgeführten.
Texte
Texte können Sie mit Parametern kürzen oder begrenzen. Dies eignet sich insbesondere für Formulare, um Texte, Namen oder Kundennummern platzsparend einzufügen. Nachfolgend werden diese anhand von Beispielen erläutert:
Wenn die angefügte Zeichenfolge Semikolon oder Leerzeichen beinhalten soll, müssen sie in Anführungszeichen:
Boole'sche Werte (ja-/nein-werte)
Boole'sche Werte sind typische Daten mit Kontrollkästchen, die drei Zustände haben können. In Qualli.life sind die drei möglichen Zustände "ja" (✓), "nein" (☓) oder "unbekannt" (-). Diese können Sie auch in Dokumenten ausgeben, z.B.
#Tn.HsaAlsZiel → ja, nein oder unbekannt
Sie haben jedoch auch die Möglichkeit die drei Zustände genauer zu beschreiben, indem Sie die Beschreibung als Parameter einfügen. Dabei müssen Sie, wie im #Geschlecht-Platzhalter, die Reihenfolge im Parameter beachten: ("Ja-Ausdruck"; "Nein-Ausdruck"; "Unbekannt-Ausdruck")
z.B. Ausgabe #Tn.HsaAlsZiel("wird angestrebt"; "wird nicht angestrebt"; "anderer Abschluss angestrebt"):
Enumerationen (Vorgabewerte)
Hierzu gehören besonders die Teilnahmestatus, die Sie in Dokumenten ausgeben können: #Tn.Status → wartet, aktiv, beendet etc. Sie haben jedoch noch die Möglichkeit weitere Formate auszugeben:
Listen (Auflistung)
Platzhalter können mehrere Daten enthalten. Dazu gehören die Platzhalter für Unterrichtszeiten und Personengruppen.
Standardmäßig werden die Gruppen durch Kommata separiert: #Tn.Gruppe → Gruppe 1, Gruppe 2, Gruppe 3 etc.
Wenn Sie die Gruppenliste durch Leerzeichen oder Semikolon (o.ä.) trennen möchten, müssen diese als Parameter in Anführungsstrichen eingegeben werden:
Auch ein Umbruch ist bei der Ausgabe möglich durch den Parameter ("\n").
"\" ist ein umgekehrter Schrägstrich auch bekannt als "Backslash", den Sie mit der Tastenkombination Alt Gr+ß eintippen.
Aus der Gruppenliste in Qualli.life können auch bestimmte Daten ausgegeben werden, z.B. möchten Sie nicht die gesamte Gruppenliste ausgegeben haben, sondern nur einzelne oder einen bestimmten Bereich. Dies erreichen Sie, wenn Sie einen zweiten Parameter eingeben, der den Bereich spezifiziert: #Tn.Gruppen(Trennzeichen; Bereich)
Diese sind nur in den Auftragstypen IntK abrufbar.
In einigen Formularen des BAMF müssen die Unterrichtszeiten angegeben werden. In Qualli.life werden sie im Programmbereich "Integrationskursdaten" ()eingegeben. Um sie in Dokumente des BAMF einfügen zu können gibt es die Platzhalter #Auftrag.Intk.UZeiten. Standardmäßig werden die einzelnen Unterrichtstage durch Kommata separiert ausgegeben:
#Auftrag.Intk.UZeiten → Mo: 08:00 - 16:00 Uhr (5 Std.), Do: 08:00 - 16:00 Uhr (5 Std.)
Auch hier können Sie beliebige Trennzeichen und den Umbruch-Parameter verwenden:
#Auftrag.Intk.UZeiten(" und\n") →
Mo: 08:00 - 16:00 Uhr (5 Std.) und
Do: 08:00 - 16:00 Uhr (5 Std.)
Platzhalter für AGH-Abrechnungen
Die nachfolgenden Platzhalter können nur Qualli.life-intern bei der Erstellung von AGH-Abrechnungen verwendet werden, genauer gesagt sie können nicht in Word-Dokumenten ausgegeben werden; auch die Test-Funktion "Platzhalter testen" wird hierbei nicht unterstützt. Die Platzhalter können jedoch in allen Textfeldern einer Rechnung/Gutschrift (individuelle Rechnung oder Vorlage) verwendet werden.
Diese Platzhalter werden standardmäßig nicht angezeigt, da sie nicht zu den sog. Basis-Platzhaltern gehören. Um sie anzuzeigen, starten Sie die
Nach einer kurzen Ladezeit, werden Ihnen alle verfügbaren Platzhalter angezeigt. Die Platzhalter für AGH-Abrechnungen befinden sich unter
Diese sind auftragsabhängig und beziehen sich auf die Monatsabrechnung eines Auftrags des Typs "AGH". Hiermit können Sie z.B.
in einer (Sammel-)Rechnung ausgeben. Sie haben jedoch auch die Möglichkeit teilnahmeabhängige Daten in einer AGH-Abrechnung auszugeben. Diese befinden sich unter
Diese können Sie sowohl für (Sammel-)Rechnungen also auch für (Einzel-)Gutschriften verwenden und beziehen sich immer auf einen Tn. Hiermit können Sie z.B.
Mehraufwandsentschädigung pro Stunde (#Auftrag.AghAbr.Tn.MaeProStunde)in einer Rechnung/Gutschrift ausgeben.
Besondere Eigenschaften des Seitenelements "Optionslisten"
Auch bei Optionslisten können Sie Daten mithilfe von Platzhaltern ausgeben, wenn die eigene Seite veröffentlicht wurde und Daten eingegeben wurden. Welche Platzhalter möglich sind, wird anhand eines Beispiels erläutert:
Die Platzhalter gelten für beide Arten von Optionslisten; Einfach- oder Mehrfachauswahl.
Der Platzhalter ohne besondere Eigenschaften, gibt die Daten des Seitenelements als Liste aus. Dies bedeutet, dass die Parameter für Listen möglich sind (siehe auch "Listen (Auflistung)"):
Die Struktur der Datenausgabe ist dabei immer dieselbe: [Option‑Id]‑[Ausgewählt ja/nein]: [Optionstext]
Wenn Sie die Frage und die dazugehörigen Antworten ausgeben möchten, verwenden Sie bei einem Platzhalter den Zusatz ".Frage" und beim anderen".Antwort":
Wenn Sie wissen möchten, ob eine Optionsliste eine Einfach- oder Mehrfachauswahl ist, können Sie dies mit den Zusätzen ".IstEinfach" und ".IstMehrfach" erfragen:
Wenn Sie nur bestimmte Antworten ausgeben möchten, dann verwenden Sie den Zusatz ".Antwort([Option-Id])":
Wenn Sie bestimmte Bestandteile einer Antwort ausgeben möchten, können Sie die Zusätze ".Id" oder ".Wert" verwenden:
Zusätzlich können Sie "erfragen", ob eine Antwort ausgewählt wurde oder nicht; der Zusatz ".An" erfragt, ob die Antwort ausgewählt wurde; der Zusatz ".Aus" ist die Negation des Zusatzes ".An". Also:
Dies wird anhand von zwei Beispielen deutlich:
