My App

Tags

Vollständige Referenz aller verfügbaren Template-Tags in MDScribe

Einführung in Tags

Tags sind spezielle Markierungen in Ihren Templates, die dynamische und interaktive Inhalte ermöglichen. Mit Tags können Sie:

  • Variable Informationen einfügen (Patientennamen, Daten, Werte)
  • Bedingte Inhalte basierend auf verschiedenen Szenarien anzeigen
  • Automatische Berechnungen durchführen
  • Strukturierte, wiederverwendbare Templates erstellen

MDScribe bietet vier Haupttypen von Tags: Info, Switch/Case, und Score.

Info-Tag

Das Info-Tag ist das am häufigsten verwendete Tag und dient zur Darstellung variabler Informationen.

Syntax

{% info "Feldname" /%}

Parameter

ParameterTypPflichtStandardBeschreibung
primaryStringJa-Der Name des Feldes/der Variable
typeStringNein"string"Datentyp: "string", "number", "date", "boolean"
unitStringNein-Einheit für den Wert (z.B. "kg", "mmHg")
renderUnitBooleanNeinfalseOb die Einheit angezeigt werden soll

Beispiele

Einfaches Textfeld:

**Patient**: {% info "Patientenname" /%}

Datum:

**Aufnahmedatum**: {% info "Aufnahmedatum" type="date" /%}

Zahl mit Einheit:

**Gewicht**: {% info "Gewicht" type="number" unit="kg" renderUnit=true /%}

Weitere Beispiele:

**Alter**: {% info "Alter" type="number" unit="Jahre" renderUnit=true /%}

**Blutdruck systolisch**: {% info "RR_sys" type="number" unit="mmHg" renderUnit=true /%}

**Allergie bekannt**: {% info "Allergie" type="boolean" /%}

Funktionsweise

  1. Das Info-Tag erstellt ein Eingabefeld in der KI-Dokumentation
  2. Der Benutzer füllt das Feld aus
  3. Der Wert wird im Dokument automatisch angezeigt
  4. Der Wert erscheint als blauer Badge im generierten Dokument

Best Practices

  • ✅ Verwenden Sie beschreibende Namen: "Patientenname" statt "name"
  • ✅ Nutzen Sie den korrekten Typ für bessere Validierung
  • ✅ Setzen Sie Einheiten bei numerischen Werten
  • ❌ Vermeiden Sie zu lange Feldnamen
  • ❌ Verwenden Sie keine Sonderzeichen im Feldnamen (Ausnahme: Unterstrich)

Switch/Case-Tags

Switch/Case-Tags ermöglichen bedingte Inhalte basierend auf verschiedenen Optionen oder Szenarien.

Syntax

{% switch "Variablenname" %}
{% case "Option1" %}Inhalt für Option 1{% /case %}
{% case "Option2" %}Inhalt für Option 2{% /case %}
{% case "Option3" %}Inhalt für Option 3{% /case %}
{% /switch %}

Parameter

Switch-Tag:

ParameterTypPflichtBeschreibung
primaryStringJaDer Name der Auswahlvariable

Case-Tag:

ParameterTypPflichtBeschreibung
primaryStringJaDer Wert, bei dem dieser Case angezeigt wird

Beispiele

Therapieart:

## Therapie

Der Patient wurde {% switch "Therapieart" %}{% case "Konservativ" %}konservativ behandelt{% /case %}{% case "Operativ" %}operativ versorgt{% /case %}{% case "Interventionell" %}interventionell behandelt{% /case %}{% /switch %}.

Entlassungsmodus:

## Entlassung

Der Patient wird {% switch "Entlassungsmodus" %}{% case "Nach Hause" %}in die häusliche Umgebung entlassen{% /case %}{% case "Rehabilitation" %}zur Anschlussheilbehandlung verlegt{% /case %}{% case "Pflegeheim" %}in ein Pflegeheim verlegt{% /case %}{% case "Verstorben" %}ist leider verstorben{% /case %}{% /switch %}.

Geschlecht-spezifische Formulierungen:

{% switch "Geschlecht" %}{% case "männlich" %}Der Patient wurde{% /case %}{% case "weiblich" %}Die Patientin wurde{% /case %}{% case "divers" %}Die Person wurde{% /case %}{% /switch %} am {% info "Aufnahmedatum" type="date" /%} aufgenommen.

Komplexes Beispiel mit mehreren Sätzen:

## Risikofaktoren

{% switch "Raucher" %}
{% case "Aktiv" %}
Der Patient ist aktiver Raucher mit einem Konsum von {% info "Packyears" type="number" /%} Packungsjahren.
{% /case %}
{% case "Ex-Raucher" %}
Der Patient ist Ex-Raucher, Nikotinabusus beendet seit {% info "RaucherSeit" /%}.
{% /case %}
{% case "Nie" %}
Der Patient hat nie geraucht.
{% /case %}
{% /switch %}

Funktionsweise

  1. Das Switch-Tag erstellt ein Dropdown-Menü in der KI-Dokumentation
  2. Der Benutzer wählt eine der definierten Optionen aus
  3. Nur der Inhalt des passenden Case-Tags wird angezeigt
  4. Der ausgewählte Wert erscheint als grüner Badge im Dokument

Wichtige Hinweise

  • ⚠️ Keine Zeilenumbrüche innerhalb von Case-Tags verwenden (führt zu Darstellungsproblemen)
  • ⚠️ Wenn kein Case passt, wird nichts angezeigt
  • ✅ Definieren Sie alle möglichen Optionen als separate Cases
  • ✅ Verwenden Sie konsistente Schreibweise für Case-Werte

Best Practices

<!-- ✅ GUT: Inline ohne Umbrüche -->
{% switch "Status" %}{% case "Aktiv" %}aktiv behandelt{% /case %}{% case "Beobachtung" %}unter Beobachtung{% /case %}{% /switch %}

<!-- ❌ SCHLECHT: Mit Zeilenumbrüchen -->
{% switch "Status" %}
  {% case "Aktiv" %}
    aktiv behandelt
  {% /case %}
{% /switch %}

<!-- ✅ GUT für längere Texte: Umbrüche nur zwischen Cases -->
{% switch "Komplikationen" %}{% case "Keine" %}Der Verlauf war komplikationslos.{% /case %}{% case "Leicht" %}Es traten leichte Komplikationen auf, die konservativ behandelt werden konnten.{% /case %}{% case "Schwer" %}Es kam zu schweren Komplikationen, die eine intensivmedizinische Behandlung erforderten.{% /case %}{% /switch %}

Score-Tag

Das Score-Tag führt automatische Berechnungen basierend auf Formeln durch.

Syntax

{% score formula="[Variable1] + [Variable2]" /%}

Parameter

ParameterTypPflichtBeschreibung
formulaStringJaDie mathematische Formel
unitStringNeinEinheit für das Ergebnis
renderUnitBooleanNeinOb die Einheit angezeigt werden soll

Formel-Syntax

Variablen werden in eckigen Klammern referenziert: [Variablenname]

Unterstützte Operatoren:

  • Addition: +
  • Subtraktion: -
  • Multiplikation: *
  • Division: /
  • Potenz: ^
  • Klammern: ()

Beispiele

Body-Mass-Index (BMI):

**BMI**: {% score formula="[Gewicht] / ([Groesse] / 100) ^ 2" unit="kg/m²" renderUnit=true /%}

Mittlerer arterieller Druck (MAP):

**MAP**: {% score formula="([RR_sys] + 2 * [RR_dia]) / 3" unit="mmHg" renderUnit=true /%}

Einfache Summe:

**Gesamtscore**: {% score formula="[Score1] + [Score2] + [Score3]" /%}

CHA₂DS₂-VASc-Score (vereinfacht):

**CHA₂DS₂-VASc-Score**: {% score formula="[Herzinsuffizienz] + [Hypertonie] + [Alter75] * 2 + [Diabetes] + [Schlaganfall] * 2 + [Gefaesserkrankung] + [Alter65] + [Geschlecht]" /%}

<!-- Dabei sind die Variablen: -->
<!-- Herzinsuffizienz: 0 oder 1 -->
<!-- Hypertonie: 0 oder 1 -->
<!-- Alter75: 0 oder 1 (≥75 Jahre) -->
<!-- etc. -->

Funktionsweise

  1. Das Score-Tag referenziert andere Variablen aus Info-Tags
  2. Die Formel wird automatisch berechnet, wenn Werte eingegeben werden
  3. Das Ergebnis wird gerundet auf 2 Dezimalstellen
  4. Bei fehlenden oder ungültigen Werten wird ... angezeigt
  5. Das Ergebnis erscheint als orangener Badge im Dokument

Best Practices

  • ✅ Stellen Sie sicher, dass alle referenzierten Variablen existieren
  • ✅ Verwenden Sie klare Variablennamen ohne Leerzeichen
  • ✅ Verwenden Sie Unterstriche statt Leerzeichen: RR_sys statt RR sys
  • ✅ Testen Sie Ihre Formeln mit verschiedenen Werten
  • ❌ Vermeiden Sie Division durch Null (prüfen Sie Ihre Formeln)
  • ✅ Dokumentieren Sie komplexe Berechnungen mit Kommentaren

Tooltip-Funktion

Score-Tags zeigen beim Hovern ein Tooltip mit der verwendeten Formel an. Dies hilft Benutzern zu verstehen, wie der Wert berechnet wurde.

Tags kombinieren

Tags können miteinander kombiniert werden für komplexe Szenarien:

Beispiel: Conditional Score

## Nierenfunktion

**eGFR**: {% info "eGFR" type="number" unit="ml/min/1.73m²" renderUnit=true /%}

{% switch "Nierenfunktion" %}
{% case "Normal" %}Die Nierenfunktion ist normal.{% /case %}
{% case "Eingeschränkt" %}Die Nierenfunktion ist eingeschränkt (Stadium {% info "CKD_Stadium" type="number" /%}).{% /case %}
{% case "Dialyse" %}Der Patient ist dialysepflichtig.{% /case %}
{% /switch %}

Beispiel: Score mit Info-Tags

**Gewicht**: {% info "Gewicht" type="number" unit="kg" renderUnit=true /%}

**Größe**: {% info "Groesse" type="number" unit="cm" renderUnit=true /%}

**BMI**: {% score formula="[Gewicht] / ([Groesse] / 100) ^ 2" unit="kg/m²" renderUnit=true /%}

{% switch "BMI_Kategorie" %}
{% case "Untergewicht" %}Der Patient ist untergewichtig.{% /case %}
{% case "Normalgewicht" %}Der Patient hat Normalgewicht.{% /case %}
{% case "Übergewicht" %}Der Patient ist übergewichtig.{% /case %}
{% case "Adipositas" %}Der Patient hat Adipositas.{% /case %}
{% /switch %}

Häufige Fehler und Lösungen

Fehler: Score zeigt "..." an

Problem: Die referenzierten Variablen existieren nicht oder sind nicht ausgefüllt.

Lösung:

  • Überprüfen Sie, dass alle Variablen in der Formel auch als Info-Tags existieren
  • Stellen Sie sicher, dass die Variablennamen exakt übereinstimmen (inkl. Groß-/Kleinschreibung)

Fehler: Switch zeigt nichts an

Problem: Der ausgewählte Wert passt zu keinem Case.

Lösung:

  • Überprüfen Sie, dass alle möglichen Optionen als Case definiert sind
  • Achten Sie auf exakte Schreibweise (inkl. Leerzeichen und Groß-/Kleinschreibung)

Fehler: Tag wird als Text angezeigt

Problem: Die Tag-Syntax ist fehlerhaft.

Lösung:

  • Überprüfen Sie die Syntax: {% info "Name" /%} nicht {info "Name"}
  • Prüfen Sie, ob alle Anführungszeichen korrekt gesetzt sind
  • Self-closing Tags benötigen /%} am Ende

Zusammenfassung

TagFarbeVerwendungSyntax-Beispiel
Info🔵 BlauVariable Daten{% info "Name" /%}
Switch/Case🟢 GrünBedingte Inhalte{% switch "Var" %}{% case "A" %}Text{% /case %}{% /switch %}
Score🟠 OrangeBerechnungen{% score formula="[A] + [B]" /%}

Mit diesen Tags können Sie flexible, wiederverwendbare Templates erstellen, die sich automatisch an verschiedene Situationen anpassen!

Schnellstart

Erste Schritte mit MDScribe - Von der Anmeldung bis zur ersten Dokumentation

Übersicht

Einführung in MDScribe - Medizinische Dokumentation mit KI-Unterstützung

On this page

Einführung in TagsInfo-TagSyntaxParameterBeispieleFunktionsweiseBest PracticesSwitch/Case-TagsSyntaxParameterBeispieleFunktionsweiseWichtige HinweiseBest PracticesScore-TagSyntaxParameterFormel-SyntaxBeispieleFunktionsweiseBest PracticesTooltip-FunktionTags kombinierenBeispiel: Conditional ScoreBeispiel: Score mit Info-TagsHäufige Fehler und LösungenFehler: Score zeigt "..." anFehler: Switch zeigt nichts anFehler: Tag wird als Text angezeigtZusammenfassung