Das x-Kommando

Einführung

Das x-Kommando ist ein sehr vielfältiges Werkzeug zum Auslesen von Informationen aus dem Dossier und es gibt zahlreiche praktische Anwendungsmöglichkeiten.

Mit dem x-Kommando können Sie sich beispielsweise…
(dies sind erste Anwendungsbeispiele, eine detaillierte Erläuterung der Syntax des x-Kommandos folgt unten unter Die Parameter im x-Kommando)

• …alle aktiven Dauerdiagnosen ausgeben lassen.
  Das geht mit dem Kommando:
  $[x DDI _ _ _ NN NNJN NNNN ICDvornstripMednurAktiveDiagnosen K _]$
  
  
• …sich für alle Diagnosen und Dauerdiagnosen des Patienten die ICD-Codes ausgeben lassen.
  Das geht mit dem Kommando:
  $[x (DDI;DIA) _ _ _ NN NNNN NN0N invTimemitICD U _]$
  
  
• …durch eine Kombination mit dem familie-Kommando für die Ehefrau eines Patienten deren Cave-Karteieinträge auslesen.
  Das geht mit dem Kommando:
  $[familie Ehefrau x cav _ _ _ NN NNJN NJNN _ U _]$

Mit den folgenden Ausführungen lernen Sie…

• wie Sie Ihr individuelles x-Kommando im Kommandofenster zur Übernahme von Karteieinträgen in Arztbriefen konfigurieren können.
• welche Syntax das x-Kommando hat.
• was die diversen Parameter des x-Kommandos bedeuten.

Erstellung von x-Kommandos

Die Fenster zur Erstellung von x-Kommandos finden Sie unter Admin → Kommandos und dort im Kommandofenster:
Dazu in diesem Fenster auf das Hakensymbol «>» links neben «Konfiugratoren» klicken und im dann ausklappenden Menü «x» auswählen.

An dieser Stelle stehen Ihnen zwei verschiedene Funktionen zur Verfügung:

• Über die Auswahlmöglichkeiten können Sie neue x-Kommandos erstellen.
• Durch Einfügen eines bestehenden x-Kommandos in die Zeile «Platzhalter» können Sie herausfinden, welche Einstellungen diesem x-Kommando zugrunde liegen. Sobald ein x-Kommando eingetragen wird, passen sich die Filter oben automatisch an, um anzuzeigen, welche für dieses Kommando genutzt wurden.

Tipp: Aktivieren Sie die tomedo Einstellung «Formatierung von Dossiereintragstexten und Textbausteinen/Makros in Briefen beibehalten» (Einstellung → Praxis → Brief/Fax/Tel), um die Formatierung auch in Briefen zu verwenden. Soll die Formatierung nur von bestimmten Dossiereintragstypen übernommen werden, können Sie in den Einstellungen auch eine entsprechende Einschränkung vornehmen.

Die Parameter im x-Kommando

Die allgemeine Struktur des x-Kommandos lautet:

[x a b₁b₂b₃ c₁c₂ d₁d₂d₃d₄ e₁e₂e₃e₄ f g₁ g₂].

Die Bedeutung der Parameter a, b₁, b₂, … , g₂ in diesem x-Kommando und welche Werte diese Parameter annehmen können, wird im Folgenden erläutert.

Der Parameter a

Mit dem Parameter a können Sie steuern, von welchen Dossiereinträgen das x-Kommando ausgelesen werden.

Der Parameter a kann z.B. diese Werte mit folgenden Bedeutungen annehmen:

…	alle Dossiereinträge werden ausgelesen
BES	nur Dossiereinträge vom Typ BES werden ausgelesen
-(BES),…	alle Dossiereinträge außer vom Typ BES werden ausgelesen
BES,…	erst werden die Dossiereinträge vom Typ BES und dann alle anderen ausgelesen
(ANA;BES)	es werden nur die Dossiereinträge vom Typ ANA und BES ausgelesen
(ANA;BES),UNF	es werden zuerst die Dossiereinträge vom Typ ANA und BES und danach UNF ausgelesen
(ANA;BES),…	es werden zuerst die Dossiereinträge vom Typ ANA und BES und dann alle anderen ausgelesen

Der Parameter b₁

Mit dem Parameter b₁ können Sie einschränken, welche Anzahl an Dossiereinträgen angezeigt werden.

Es gibt die folgenden Möglichkeiten, Werte für b₁ auszuwählen:

• b₁ = inf oder _ für keine Einschränkung der Anzahl der Dossiereinträge
• jegliche natürliche Zahl (z.B. b₁ = 1 oder b₁ = 18) für eine genaue Anzahl an Dossiereinträgen, die höchstens angezeigt wird

Der Parameter b₂

Mit diesem Parameter können Sie die angezeigten Dossiereinträge in Abhängigkeit von der Auswahl in der Dossierkarte einschränken.

Es gibt diese Möglichkeiten:

• b₂ = all oder _ → keine Einschränkung
• b₂ = sel → nur markierte Dossiereinträge werden angezeigt
• b₂ = inv_sel → nur nicht-markierte Dossiereinträge werden angezeigt

Der Parameter b₃

Mit dem Parameter b₃ können Sie die angezeigten Dossiereinträge in Abhängigkeit von deren Alter einschränken.

Beispiele für mögliche Einstellungsoptionen:

• inf oder _ = keine Einschränkung
• 2d = maximal zwei Tage alt
• 1M = maximal einen Monat alt
• 1q = maximal ein Quartal
• 1y = maximal ein Jahr alt
• L = seit letztem Brief an gleichen Empfänger (ohne min-max Einstellmöglichkeit)
• aq = aktuelles Quartal
• 2-d = minimal zwei Tage alt
• 2-3d = minimal 2 Tage, maximal 3 Tage alt

Die im Folgenden diskutierten Parameter c₁, c₂, d₁, d₂, d₃, d₄, e₁, e₂, und e₄ beziehen sich auf die sogenannten Sammelbezeichner und Typbezeichner.

Sammelbezeichner und Typbezeichner

Die im Folgenden diskutierten Parameter c₁, c₂, d₁, d₂, d₃, d₄, e₁, e₂, und e₄ beziehen sich auf die sogenannten Sammelbezeichner und Typbezeichner. Diese beiden Begriffe sollen zunächst einmal an einem Beispiel erklärt werden.

Die folgende Ausgabe wurde für einen Patienten mit einem x-Kommando erzeugt, indem über den Parameter b₁ = ANA,BEF zuerst Anamnese und dann Befunde ausgelesen wurden.

Für dieses Beispiel sind die Sammelbezeichner das fettgedruckte Wort «Anamnese» über der Auflistung von Anamnesen und das fettgedruckte Wort «Befund» über dem ersten Befund. Typbezeichner sind die beiden nicht-fettgedruckten Wörter «Anamnese» für die beiden Anamnesen und die nicht-fettgedruckten Wörter «Befund» für die drei Befunde.

Hinweise:

• Wie im folgenden noch erläutert wird, können Sie mit den x-Kommandos auch steuern, ob die Sammel- und Typbezeichner fett oder nicht fett gedruckt werden. Das in diesem Beispiel die Sammelbezeichner fett gedruckt und die Typbezeichner nicht fett gedruckt worden sind, dient lediglich zur einfacheren optischen Unterscheidung dieser beiden Bezeichnertypen.
• Wenn in dem vorliegenden Beispiel der Parameter b₁ stattdessen b₁ = (ANA;BEF) lauten würde (also Anamnesen und Befunde nicht separat nacheinander aufgelistet werden), dann haben Sie nur einen Sammelbezeichner, welcher sich nach dem obersten Dossiereintrag in der Auflistung richtet. Die Ausgabe für das obige Beispiel sähe dann so aus:

Ein Sonderfall liegt vor, wenn Dauerdiagnosen und Diagnosen zusammen aufgelistet werden (also b₁ = (DDI;DIA)): Dann lautet der Sammelbezeichner immer Diagnosen unabhängig davon, ob der oberste Dossiereintrag in der Auflistung vom Typ Diagnose oder Dauerdiagnose ist.

Der Parameter c₁

Der Parameter c₁ steuert über die folgenden Werte, ob der Sammelbezeichner fettgedruckt wird:

• c₁ = J → Sammelbezeichner wird fettgedruckt
• c₁ = N → Sammelbezeichner wird nicht fettgedruckt

In den beiden obigen Beispielen hat dieser Parameter den Wert J.

Der Parameter c₂

Der Parameter c₂ steuert über die folgenden Werte, ob der Typbezeichner fettgedruckt wird:

• c₂ = J → Typbezeichner wird fettgedruckt
• c₂ = N → Typbezeichner wird nicht fettgedruckt

In den beiden obigen Beispielen hat dieser Parameter den Wert N.

Der Parameter d₁

d₁ kontrolliert den Zeilenvorschub nach dem Sammelbezeichner.

• d₁ = N → kein Umbruch
• d₁ = J → neue Zeile
• d₁ = A → neuer Absatz
• d₁ = 2 → Leerzeile

Der Unterschied zwischen «J» und «A» besteht insbesondere darin, dass in docx-Dokumenten für d₁= J bei Sichtbarmachung von Formatierungszeichen das Symbol ↵ für den Zeilenumbruch nach dem Sammelbezeichner auftritt. Bei d₁ = A tritt hingegen das Symbol für den Absatzumbruch ¶ auf.

Für d₁ = 2 treten zwei Zeilenumbrüche nacheinander auf, die zu einer Leerzeile führen.

In den beiden obigen Beispielen hat dieser Parameter den Wert J.

Der Parameter d₂

d₂ kontrolliert den Zeilenvorschub nach dem Typbezeichner. Analog zum Parameter d₁ gilt:

• d₂ = N → kein Umbruch
• d₂ = J → neue Zeile
• d₂ = A → neuer Absatz
• d₂ = 2 → Leerzeile

In den obigen beiden Beispielen hat dieser Parameter den Wert J.

Der Parameter d₃

d₃ kontrolliert den Zeilenvorschub nach Dossiereinträgen. Analog zum Parameter d₁ gilt:

• d₃ = N → kein Umbruch
• d₃ = J → neue Zeile
• d₃ = A → neuer Absatz
• d₃ = 2 → Leerzeile

In den beiden obigen Beispielen hat dieser Parameter den Wert 2.

Der Parameter d₄

Damit dieser Parameter Auswirkungen hat, müssen Sie z.B. b₁ = ANA,BEF wählen.

d₄ kontrolliert dann den Zeilenvorschub nach der Auflistung aller Dossiereinträge vom ANA, bevor die Auflistung der BEF-Einträge beginnt.

Analog zum Parameter d₁ gilt:

• d₄ = N → kein Umbruch
• d₄ = J → neue Zeile
• d₄ = A → neuer Absatz
• d₄ = 2 → Leerzeile

In den beiden obigen Beispielen hatte dieser Parameter den Wert J, dies hat jedoch nur im ersten Beispiel Auswirkungen.

Die Effekte von d₃ und d₄ addieren sich. Sie erhalten Sie z.B. für das erste der obigen Beispiele wegen d₃ = 2 und d₄ = J nach dem letzten ANA-Eintrag drei Zeilenumbrüche, die zu zwei Leerzeilen führen.

Der Parameter e₁

Mit dem Parameter e₁ kann gesteuert werden, ob der Typbezeichner angezeigt wird.

• e₁ = J → Typbezeichner wird angezeigt
• e₁ = N → Typbezeichner wird nicht angezeigt

In den beiden obigen Beispielen war dieser Parameter auf J.

Der Parameter e₂

Mit dem Parameter e₂ kann gesteuert werden, ob das Datum des Dossiereintrags angegeben wird.

• e₂ = J → Dossiereintragsdatum wird angezeigt
• e₂ = N → Dossiereintragsdatum wird nicht angezeigt

In den beiden obigen Beispielen war dieser Parameter auf J.

Der Parameter e₃

Mit dem Parameter e₃ kann gesteuert werden, wie viel Text der Dossiereinträge übernommen wird.

• e₃ = N → ganzen Text der Dossiereinträge übernehmen
• e₃ = 0 → Text nicht einfügen
• e₃ = 1 → nur ersten Absatz übernehmen
• e₃ = 2 → nur zweiten Absatz übernehmen
• e₃ = -2 → nur die ersten beiden Absätze übernehmen
• e₃ = 2-3 → Absätze zwei und drei übernehmen

Allgemein gilt: e₃ = n-m → n-ter Absatz bis einschließlich m-ter Absatz.

In den obigen Beispielen war dieser Parameter auf N.

Der Parameter e₄

Mit dem Parameter e₄ kann gesteuert werden, ob der Sammelbezeichner angezeigt werden soll.

• e₄ = J → Sammelbezeichner wird angezeigt
• e₄ = N → Sammelbezeichner wird nicht angezeigt.

In den obigen Beispielen war dieser Parameter auf N.

Der Parameter f

f beschreibt diverse Zusatzbedingungen und kann die folgenden Werte annehmen:

f = _	keine Zusatzbedingungen
f = invTime	zeitlich aufsteigende Sortierung
f = arztname	Dossiereinträge mit Arztnamen
f = _nutzer	Nur vom aktiven Nutzer angelegte Dossiereinträge
f = _betriebsstaette	Nur in der genutzten Betriebsstätte angelegte Dossiereinträge
f = scheinDiagnosen	Diagnosen von Schein
f = mitErlaeuterung	Diagnosen mit Erläuterung
f = mitICD	Diagnose mit ICD (*)
f = ICDVorn	Diagnosen vorne (*)
f = nurAktiveDiagnosen	nur aktive Diagnosen (**)
f = anamnestischeDiagnosen	nur anamnestische Diagnosen (**)
f = auchabgesetzteDiagnosen	alle (auch inaktive) Diagnosen (**)
f = stripMed	nur Medikamente aus Dossiereintragstext
f = diagAlsKe	Diagnosen und Dauerdiagnosen werden wie andere Dossiereinträge ausgelesen

Sie dürfen dabei Zusatzbedingungen miteinander kombinieren. Nur jeweils die mit * bzw. ** gekennzeichneten Bedingungen dürfen nicht miteinander kombiniert werden.

Beispielsweise bedeutet f = invTimestripMed eine zeitlich aufsteigende Sortierung, bei welcher aus den Dossiereinträgen nur die Medikamente berücksichtigt werden.

Hinweise zur Option f = diagAlsKe:

• Die Option f = diagAlsKe kann im Konfigurator für das x-Kommando im rechts unten platzierten Diagnosenbereich durch Anhaken der Option «keine Sonderbehandlung (s. Tooltip)» ausgewählt werden.
  
• Nutzt man diese Option, werden Diagnosen und Dauerdiagnosen wie andere Dossiereinträge auch ausgelesen, was dann zur Folge hat, dass einige andere Konfigurationsmöglichkeiten für die Ausgabe von Diagnosen im x-Kommando-Konfigurator nicht mehr ausgewählt werden können, weil sie bei Nutzung dieser Option keine Auswirkung mehr haben (siehe Bild unten).
  

Der Parameter g₁

Der Parameter g₁ bezieht sich auf Anhänge.

• g₁ = U → Anhänge stehen untereinander
• g₁ = N → Anhänge stehen nebeneinander
• g₁ = K → Anhänge werden nicht eingefügt

Außerdem kann an die oben genannten Einstellungen optional noch ein weiterer Buchstabe angehängt werden:

• F → auch Formulare
• D → auch docx-Dokumente
• V → auch Perzentile

Zum Beispiel bedeutet g₁ =UFVD, dass die Anhänge untereinander stehen und dabei auch Formulare, docx-Dokumente und Perzentile berücksichtigt werden.

Der Parameter g₂

Mit dem Parameter g₂ lässt sich die Anhangsbreite einstellen. Dabei können Sie das Platzhaltersymbol _ oder eine Zahl eingeben.

g₂ = _ bedeutet dabei, dass keine feste Anhangsbreite vorliegt.

Wählen Sie für g₂ hingegen eine Zahl, beispielsweise 10, dann steht g₂ = 10 für eine Breite von 10 cm.

Hinweis: Sie können im Fenster zur Erstellung von x-Kommandos für die Angabe der Anhangsbreite auch Fließkommazahlen (z.B. 10,25 für 10,25 cm Anhangsbreite) angeben; im x-Kommando werden diese dann in Fließpunktzahlen (z.B. g₂ = 10.25) umgewandelt.

Abkürzungen und die Standardkonfiguration des x-Kommandos

Es existieren zudem einige Abkürzungen für das x-Kommando. Diese können in Briefen anstelle des vollständigen x-Kommandos verwendet werden.

Für die Nutzung dieser Abkürzungen ist es wichtig, die Standardkonfiguration des x-Kommandos zu kennen, für die die Parameter ihre Standardwerte annehmen.

Diese Standardkonfiguration lautet:

$[x … _ _ _ NJ NJ2N JJNN _ U _]$

Dem entspricht:

• a = … → alle Dossiereinträge werden berücksichtigt
• b₁ = _ → unbeschränkte Anzahl der angezeigten Dossiereinträge
• b₂ = _ → Anzeige unabhängig von der Markierung in Dossier oder Besuch
• b₃ = _ → keine Einschränkung bezüglich des Zeitraums
• c₁ = N → Sammelbezeichner wird nicht fettgedruckt
• c₂ = J → Typbezeichner wird fettgedruckt
• d₁ = N → kein Zeilenumbruch nach dem Sammelbezeichner
• d₂ = J → neue Zeile nach dem Typbezeichner
• d₃ = 2 → Leerzeile nach dem Ende des Dossiereintrags
• d₄ = N → kein Zeilenumbruch zwischen zwei Auflistungen von Dossiereinträgen verschiedenen Typs
• e₁ = J → Typbezeichner wird angezeigt
• e₂ = J → Datum des Dossiereintrags wird angezeigt
• e₃ = N → ganzer Text des Dossiereintrags wird eingefügt
• e₄ = N → Sammelbezeichner wird nicht angezeigt
• f= _ → keine Zusatzbedingungen
• g₁ = U → Anhänge werden untereinander angegeben
• g₂ = _ → keine Breite der Anhänge festgelegt

Es existieren zwei Regeln, mit denen Sie mit dieser Standardkonfiguration einfach Abkürzungen für x-Kommandos erstellen können:

1. Sie können im x-Kommando die Auflistung der Parameter abbrechen. Für alle noch fehlenden Parameter werden dann die Standardwerte angenommen.
2. Sie können für jeden Parameter den Platzhalter _ eingeben. In diesem Fall wird für diesen Parameter der Standardwert angenommen.

Beispiele

In den folgenden «Gleichungen» steht jeweils links das abgekürzte und rechts das entsprechende ausführliche x-Kommando.

1. Beispiel

$[x]$ = $[x … _ _ _ NJ NJ2N JJNN _ U _]$

Hier werden alle Parameter auf die Standardwerte gesetzt. Dies ist einfach die Standardkonfiguration.

2. Beispiel

$[x … 1]$ = $[x … 1 _ _ NJ NJ2N JJNN _ U _]$

Hier sind nur die Parameter a₁ = … und b₁ = 1 angegeben. Alle restlichen Parameter werden auf die Standardwerte gesetzt.

Für dieses x-Kommando wird durch b₁ = 1 nur der neuste Karteieintrag ausgelesen.

3. Beispiel

$[x (DDI;DIA) inf all aq]$ = $[x (DDI;DIA) _ _ aq NJ NJ2N JJNN _ U _]$

Hier ist a = (DDI;DIA). die beiden Parameterwerte b₁ = inf und b₂ = all sind äquivalent zu den Platzhaltern b₁ = _ und b₂ = _. Außerdem ist b₃ = aw. Die restlichen Parameter werden dann auf die Standardwerte gesetzt.

Dieses x-Kommando übernimmt also alle Dauerdiagnosen und Akutdiagnosen in zeitlicher Reihenfolge (a = (DDI;DIA)) aus dem aktuellen Quartal (b₃ = aq).

4. Beispiel

$[x (DDI;DIA),ANA _ sel sq _ N]$ = $[x (DDI;DIA),ANA _ sel aw NN NJ2N JJNN _ U _]$

Hier ist:

• a = (DDI;DIA),ANA
• b₁ = _ (also der Platzhalter)
• b₂ = sel
• b₃ = aq
• c₁ = _ (also der Platzhalter)
• c₂ = N

Die restlichen Parameter haben dann Standardwerte.

Dieses x-Kommando übernimmt zunächst alle Dauerdiagnosen und Akutdiagnosen (DDI;DIA) aus dem aktuellen Quartal (b₃ = aq). Danach übernimmt das Kommando Anamnesen (ANA) in einem eigenen Absatz (symbolisiert durch das Komma). Hier gilt ebenfalls die Einschränkung auf das aktuelle Quartal (b₃ = aq).

Für den Parameter b₁ ist der Platzhalter (_) angegeben. Somit bleibt der Standardwert für b₁ (inf) aktiv. Wegen b₂ = sel werden nur zuvor ausgewählte Karteieinträge berücksichtigt.

Für den Parameter c₁ ist der Platzhalter (_) angegeben. Somit bleibt der Standardwert (N) aktiv, was bedeutet, dass der Sammelbezeichner nicht fettgedruckt wird. Der Parameter c₂ ist auf N gesetzt, also wird auch der Typbezeichner nicht fettgedruckt.

Hinweis: Da für dieses Beispiel der Parameter e₄ auf seinem Standardwert N ist, ist der im obigen Absatz erwähnte Sammelbezeichner gar nicht vorhanden und die oben erwähnte Einstellung für den Parameter c₁ hat bezüglich des Fettdrucks des Sammelbezeichners keine Auswirkungen.

x-Platzhalter

Außerdem können Nutzer mit Administrator-Rechten x-Platzhalter als Ersatz für häufig genutzte x-Kommandos definieren: Dies ist im Fenster für die Konfiguration des
x-Kommandos (siehe oben unter Erstellung von x-Kommandos) unter dem Speichern-Symbol unten links möglich.

Die dort hinterlegten Platzhalternamen werden dann über $[<Platzhaltername>]$ aufgerufen. Legen Sie also wie oben im Bild illustriert x-Platzhalter an, würde z.B. das Briefkommando $[$xDOK5cm]$ die gleichen Auswirkungen wie das Briefkommando $[x DOK ___ JJ JJJ2 JJNJ _ U 5]$ haben.