Variablen können in verschiedenen Situationen genutzt werden:
zur Anzeige ihres Inhalts in einem Text (Fragetitel, Fragebeschreibung, Infotexte) und werden dazu in zwei geschwungene Klammern gesetzt, also z.B. {{inline.variablenname}}.
zur Nutzung als Bedingung (if-then/else) in einem Text
In Abhängigkeiten können sie im "erweiterten Modus" genutzt werden.
Dann kann man z.B. das Patientenalter (client.age) verwenden, das Geschlecht, einen ermittelten Score etc,....In Formeln können Variablen ebenfalls verwendet werden
Zum Einbetten in eine GDT-Rückgabe
Um Variablen in Texten zu verwenden müssen diese immer zwischen zwei geschwungenen Klammern stehen, also {{variablentyp.variablenname}}.
Übersicht der verfügbaren Variablentypen
Stammdaten: {{client.eigenschaft}}
Scorings: {{scoring.variablenname}}
Formelergebnisse sind immer: {{formula.variablenname}}
Fragebogen-Variablen sind immer: {{inline.variablenname}}
Allgemeine verfügbare Variablen:
Datum: {{dateFormat date}}
Datum: {{date}}
Uhrzeit: {{time}}
Die folgenden Variablen stehen im Fragebogen immer zur Verfügung, da sie zum Client/Patient gehören.
Die Variablen sind natürlich nur “gefüllt”, wenn der Client auch entsprechende Daten im entsprechenden Feld enthält.
Die Variablen können sowohl in Frage-Abhängigkeiten im “Erweiterten Modus” als Bedingung als auch in Frage-Beschreibungstexten als Platzhalter verwendet werden.
Die beiden Variablen age und ageInMonth können, da sie reine Zahlenwerte enthalten, auch in Formeln verwendet werden.
Fallnummer und Patientennummer sind vom Typ “String” und können neben Zahlen auch Buchstaben enthalten, können daher nicht in Formeln verwendet werden.
Stammdaten/-Eigenschaften:
Anrede: {{client.salutation}}
Name (Vorname + Nachname): {{client.name}}
Vorname: {{client.firstName}}
Nachname: {{client.lastName}}
Vor/-Nachname kombiniert: {{client.name}}
Adresse: {{client.address}}
Fallnummer: {{client.caseNr}}
Patientennummer: {{client.customerNr}}
Standort: {{client.location}}
Geburtsdatum (formatiert): {{dateFormat client.birthDate}}
Alter in Jahren: {{client.age}}
Alter in Monaten: {{client.ageInMonth}}
Status: {{client.status}}
Ist männlich (wenn "true" bzw. Wert gleich 1): {{client.isMale}}
Ist weiblich (wenn "true" bzw. Wert gleich 1) : {{client.isFemale}}
Ist anonym (wenn "true" bzw. Wert gleich 1): {{client.anonymous}}
Ist pseudonym (wenn "true" bzw. Wert gleich 1): {{client.pseudonymous}}
Platzhalter für Antworten in GDT-Rückgabezeilen:
Bei der Rückgabe von Texten über die GDT-Schnittstelle können Variablen im Rückgabetext verwendet werden.
Platzhalter in GDT-Rückgabezeilen:
Um in einer GDT-Rückgabezeile einer Frage die dort gegebene Antwort einzufügen, wird hierzu der Platzhalter ${var} im GDT-Rückgabetext eingefügt.
Beispiel bei der Frage nach einem Datum wäre also: Der Patient hat seit dem ${var} Beschwerden.
Der Fragetyp ist relevant:
Einfache Antwort: Es wird die gewählte Antwort in den Text eingefügt
Mehrfache Antwort: Es werden alle gewählten Antworten kommagetrennt an der Stelle des Platzhalters eingefügt
Freitext: Es wird die Freitext-Antwort an der Stelle des Platzhalters eingefügt
Zahlen-Frage: Es wird die eingegebene Zahl eingefügt.
Datum-Frage: Es wird das ausgewählte Datum an der Stelle des Platzhalters eingefügt
Variable in GDT-Rückgabezeilen:
Um in einer GDT-Rückgabezeile den Inhalt einer Variable aus einer beliebigen Stelle des Fragebogens einzufügen wird hierzu die Variable in der Form ${variablentyp.variablenname} in den GDT-Rückgabetext eingefügt.
Achtung: nur eine (statt wie in der Verwendung von Variablen im Textebereich zwei Stück) geschwungene Klammer und ein einleitendes $-Zeichen
Beispiel: Das Ergebnis der Formel ist: ${formula.variablenname} .
Sonderfall Scoring-Variablen:
Die Übertragung von Scoring-Ergebnissen per GDT kann in den OPTIONEN der Fragebogenvorlage aktiviert werden und mit einem eigenen GDT-Rückgabetext versehen werden:
Aktivieren Sie dazu in den Optionen im Reiter GDT die Funktion “Scoring Ergebnisse in GDT Datei einfügen”, klicken sie dann den Variablen-Button (</>) neben der entsprechenden Scoring-Variable und legen sowohl die GDT-Feldkennung (im Beispiel “Befunde 6220”) sowie den GDT-Rückgabetext fest. In den GDT-Rückgabetext können sie das Scoring-Ergebnis durch den bereits ganz oben erläuterten Platzhalter ${var} einfügen.
If-then/Else Funktion / Variablen als Bedingungen innerhalb eines Texts
myMedax bietet Ihnen die Möglichkeit, innerhalb von Beschreibungstexten Abhängigkeiten zu nutzen.
Hierzu stellen wir Ihnen eine if-then/else Funktion zur Verfügung.
Um in einem Text Bedingungen zu nutzen müssen zunächst mal Fragebogen-Variablen (auch verwendbar nach dem Muster {{inline.variablenname}} ) angelegt werden.
Im Beispiel erhält jede Antwort-Option einen Variablennamen, z.B. answerYes, answerNo und answerMisc.
Achtung: Variablennamen sind immer case-sensitiv, die Groß-/Kleinschreibung wird also berücksichtigt!
Für den Fall dass die Antwortoption “Sonstiges” gewählt wird, welches einer Freitextantwort enspricht wird der Variablenname answerMiscText verwendet.
Im Beschreibungstext (der natürlich auch in jeder anderen Frage des gleichen Fragebogens stehen darf, die Fragebogen-Variablen sind an allen Stellen des Fragebogens verfügbar) wird nun eine IF-Bedingung eingefügt.
Diese beginnt immer mit zwei geschweiften Klammern, einem Raute-Zeichen und dem Schlüsselwort if, also {{#if gefolgt von der Bedingung und zwei geschweiften Klammern }} , gefolgt von dem unter dieser Bedingung anzuzeigenden Text und dem Abschluss der Funktion mit einem {{/if}}.
Es können auch mehrere IFs in Folge gesetzt werden, daher der Text mit den Abhängigkeiten aus dem Beispiel hier nochmal etwas aufgeschlüsselt:
{{#if (eq inline.answerYes true)}}Sie haben Ja gewählt.{{/if}} {{#if (eq inline.answerNo true)}}Sie haben Nein gewählt.{{/if}} {{#if (eq inline.answerMisc true)}}Sie haben Sonstiges gewählt und folgendes eingetragen: {{inline.answerMiscText}}.{{/if}}
Statt viele verschiedene IFs zu verwenden können Sie aber auch für “alle anderen Möglichkeiten”, die eben nicht mit IFs abgedeckt wurden, ein ELSE einfügen.
Hierzu folgendes Beispiel einer IF-ELSE-Funktion:
{{#if (eq inline.answerYes true)}}Sie haben Ja gewählt. {{else}}Sie haben wohl Nein oder Sonstiges gewählt. {{/if}}
Als Helper bzw. Vergleichsoperatoren in Bedingungen kann man folgende Functions verwenden:
Helper | Bedeutung | Beispiel |
eq | gleich | {{#if (eq var1 "value")}}var1 ist gleich "value"{{/if}} |
ne | nicht gleich | {{#if (ne var1 "value")}}var1 ist nicht gleich "value"{{/if}} |
lt | kleiner als | {{#if (lt numberVar 10)}}Zahl ist kleiner als 10{{/if}} |
gt | größer als | {{#if (gt numberVar 10)}}Zahl ist größer als 10{{/if}} |
lte | kleiner oder gleich | {{#if (lte numberVar 10)}} Zahl ist kleiner als oder gleich 10{{/if}} |
gte | größer oder gleich | {{#if (gte numberVar 10)}} Zahl ist größer als oder gleich 10{{/if}} |
and | und | {{#if (and (eq var1 "value1") (eq var2 "value2"))}}Beide Bedingungen sind wahr{{/if}} |
or | oder | {{#if (or (eq var1 "value1") (eq var2 "value2"))}}Mindestens eine der Bedingungen ist wahr{{/if}} |
dateFormat | formatiertes Datum | Das formatierte Datum ist: {{dateFormat "2023-01-01"}} // 01.01.2023 |
Einen Musterfragebogen mit weiteren Beispielen sowie allen Vergleichsoperatoren können Sie hier herunterladen und in Ihr myMedax importieren.