Das x-Kommando

Einführung

Das x-Kommando ist ein sehr vielfältiges Werkzeug zum Auslesen von Informationen aus der Kartei 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)

• …den Karteieintrag zur aktuellsten AU-Bescheinigung im aktuellen Quartal ausgeben lassen.
  Das geht mit dem Kommando:
  $[x AU 1 _ aq NN NNNN NNNN _ K 0]$
  

• …den in der Kartei selektierten Karteieintrag einer AU-Bescheinigung ausgeben lassen.
  Das geht mit dem Kommando:
  $[x AU _ sel _ NN NNNN NNNN _ K 0]$
  

• …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.

Hinweis: Nutzen Sie das Kommando-Fenster, um Ihr individuelles x-Kommando zur Übernahme von Karteieinträgen in Artzbriefen zu konfigurieren.

Tipp: Aktivieren Sie die tomedo Einstellung „Formatierung von Karteieintragstexten 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 Karteieintragstypen ü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 Karteieinträgen das x-Kommando ausgelesen werden.

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

…	alle Karteieinträge werden ausgelesen
BES	nur Karteieinträge vom Typ BES werden ausgelesen
-(BES),…	alle Karteieinträge außer vom Typ BES werden ausgelesen
BES,…	erst werden die Karteieinträge vom Typ BES und dann alle anderen ausgelesen
(ANA;BES)	es werden nur die Karteieinträge vom Typ ANA und BES ausgelesen
(ANA;BES),UNF	es werden zuerst die Karteieinträge vom Typ ANA und BES und danach UNF ausgelesen
(ANA;BES),…	es werden zuerst die Karteieinträ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 Karteieinträ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 Karteieinträge
• jegliche natürliche Zahl (z.B. b₁ = 1 oder b₁ = 18) für eine genaue Anzahl an Karteieinträgen, die höchstens angezeigt wird

Der Parameter b₂

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

Es gibt diese Möglichkeiten:

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

Spezialfall: Wenn Sie bei tomedo® als Radiologe hinterlegt sind, so wird im Fenster „Kommandoliste“ für die x-Kommandoeinstellung für b₂ die zusätzliche Option „b₂ = bes“ freigeschaltet. Diese Einstellung steht für den aktuellen Besuch.

Der Parameter b₃

Mit dem Parameter b₃ können Sie die angezeigten Karteieinträ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. Dass 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 Karteieintrag 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 Karteieintrag 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 Karteieinträ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 Karteieinträ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 Karteieintrags angegeben wird.

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

In den beiden obigen Beispielen war diesen Parameter auf J.

Der Parameter e₃

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

• e₃ = N → ganzen Text der Karteieinträ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 = artzname	Karteieinträge mit Artznamen
f = scheinDiagnosen	Diagnosen von Schein
f = mitErlaeuterung	Diagnosen mit Erläuterung
f = mitICD	Diagnosed 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 Karteieintragstext

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 Karteieinträ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 Karteieinträ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 Karteieinträge werden berücksichtigt
• b₁ = _ → unbeschränkte Anzahl der angezeigten Karteieinträge
• b₂ = _ → Anzeige unabhängig von der Markierung in Kartei 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 Karteieintrags
• d₄ = N → kein Zeilenumbruch zwischen zwei Auflistungen von Karteieinträgen verschiedenen Typs
• e₁ = J → Typbezeichner wird angezeigt
• e₂ = J → Datum des Karteieintrags wird angezeigt
• e₃ = N → ganzer Text des Karteieintrags 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 NJ“N JJNN _ U _]$

Hier ist:

• a = (DDI;DIA),ANA
• b1 = _ (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 b1 ist der Platzhalter (_) angegeben. Somit bleibt der Standardwert für b1 (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 c1 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. Legt man 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.