ViREQHandbuch
Start › Mirth Connect Plugins

Mirth Connect (CE) - LDTx Datatype Plugin

23 Abschnitte · zuletzt aktualisiert 2022-11-21

LDTx Datatype Plugin#

Beschreibung

Dieses Plugin bietet die Funktion LDTx Formate in Mirth Connect zu verarbeiten.

Wie installiert man das LDTx Data-Type Plugin ?#

Schritt 1

Nachdem das Plugin heruntergeladen wurde, muss es installiert werden.

Wählen Sie die Schaltfläche "Extensions" unter "Mirth Connect" um zu einer Übersicht der installierten Plugins zu gelangen.

Pfad auswählen#

Schritt 2

Unten kann der Pfad des Plugins entweder direkt angegeben werden, oder mithilfe der "browse" Schaltfläche manuell im Dateiexplorer gesucht werden.

Plugin auswählen#

Schritt 3

Auswahl mithilfe der "browse" Schaltfläche

Die "browse" Schaltfläche öffnet ein Fenster in dem zu installierende Plugin ausgewählt werden kann. Diese Auswahl wird mit "Open/Öffnen" bestätigt.

Installation#

Schritt 4

Nachdem das zu installierende Plugin ausgewählt wurde, muss dieses mit einem Klick auf die "install" Schaltfläche installiert werden.

Server und Client Neustarten#

Schritt 5

Wenn das Plugin erfolgreich installiert wurde müssen der "Mirth Server" sowie der "Mirth Connect Administrator" neugestartet werden, damit die Plugins aktiv werden.

Installation überprüfen#

Schritt 6

Nach einem Neustart sollten die Plugins in der "installed Plugins" Liste auftauchen. Diese kann als Untermenü unter "Mirth Connect" gefunden werden.

Glückwunsch, Sie haben das LDTx Data-Type Plugin erfolgreich installiert !

Einen Channel erstellen#

Schritt 1

Als erstes muss die "Channel" Schaltfläche auf der linken Seite, unter "Mirth Connect" ausgewählt werden. Danach können mit einem Klick auf "New Channel" unter dem Reiter Channel Tasks neue Channel erstellt werden.

Einen Channel mit LDTx konfigurieren#

Schritt 2

Wird ein neues Channel erstellt, öffnet sich sein administration menu, in welchem der Name sowie der Datentype des Channels konfiguriert werden kann. Nachdem der Channel benannt wurde, kann die Konfiguration des Datentyps mit einem Klick auf die Schaltfläche "Data Types" erledigt werden.

Konfiguration des Datentyps#

Schritt 3

In diesem Menü kann der Channel konfiguriert werden, in diesem Beispiel muss LDTx als Datentyp für die inbound und das gewünschte outbound Format festgelegt werden. Intern konvertiert Mirth die Nachricht in das XML Format, von welchem die Nachricht in jedes beliebige Ausgangsformat konvertiert werden kann. (Als Standard LDTx zu LDTx)

Inbound und Outbound Konfiguration#

Inbound and Outbound Konfiguration

Nachdem die Datentypen festgelegt wurde können noch weitere Einstellungen getätigt werden !

EinstellungBeschreibung
descriptionAttributDas "descriptionAttribut" setzt die Feldbeschreibung im "Description Tag"
typeHier kann der Datentyp ausgewählt werden.
Log Unknown FieldsLoggt unbekannte Feldfunktionen und speichert diese.
LDT VersionDie LDTx Version kann in den "Channel Properties" ausgewählt werden. Wenn Auto ausgewählt ist, wird die Version der ankommenden Nachricht automatisch bestimmt. Wird eine spezifische Version angegeben, wird nur diese akzeptiert

Es können verschiedene Outbound-Formate für jedes Ziel festgelegt werden.

Funktionen#

Funktionen und Möglichkeiten des Plugins werden hier dargestellt

Wie gelangt man zur Nachrichtenkonfiguration ?#

Schritt 1

Um zur Nachrichtenkonfiguration zu gelangen wählen Sie als erstes "Channels" im "Mirth Connect" Reiter und doppelklicken Sie den Channel welcher bearbeitet werden soll.

Nachrichten Vorlage erstellen#

Schritt 2

Wählen Sie die "source" Schaltfläche im oberen Tab und klicken sie dann auf "Edit Transformer" unter "Channel Tasks"

Nachrichten Vorlage konfigurieren#

Schritt 3

Wie konfiguriert man eine Nachrichten Vorlage?

Klicken Sie auf die "Message Template" Schaltfläche um eine Nachrichten Vorlage einzurichten. Dazu muss der gewünschte Datentyp ausgewählt werden, und eine Nachrichten Vorlage eingefügt werden.

Nachrichten Vorlage Beispiel#

Schritt 4

So könnte eine Nachrichten Vorlage aussehen:

Zeige die Nachricht als Nachrichten Baum#

Schritt 5

Um die Nachricht als Nachrichten-Baum anzuzeigen klicken sie auf die Schaltfläche "Message Trees" im oberen rechten Reiter. Durch einen Klick auf das kleine Plus können die Nachrichtendetails angezeigt werden.

Als nächstes kann ein Nachrichten Filter konfiguriert werden.

Einen Filter für LDTx Nachrichten festlegen#

Schritt 6

Die Konfiguration eines Nachrichten-Filters ist sehr einfach mit dem LDTx Plugin. Durch Drag and Drop kann ein Datensatz (der mit dem grünen Punkt) vom Nachrichten Baum in das obere weiße Feld gezogen werden. Danach werden nur noch Nachrichten akzeptiert welche mindestens diesen Dateneintrag besitzen. (In unserem Beispiel der Vorname des Patienten) Nachrichten welche diesen Dateneintrag nicht besitzen, werden aussortiert.

Und so einfach wurde eine neue Filter-Regel erstellt.

Funktionstest / Nachricht senden#

Schritt 1

Als nächstes wollen wir unser System testen, indem wir das ankommen einer Nachricht im LDTx (LDT 2) Format simulieren.

Um das ankommen einer Nachricht zu simulieren, muss als erstes der Channel ausgewählt werden, welcher getestet werden soll. Diese Auswahl ist im Dashboard möglich. (In unserem Beispiel heißt der "Channel" "LDTx"). Dieser kann durch einen Doppelklick ausgewählt werden.

So kommen wir ins Nachrichten Menu unseres "Channels"

Nachricht an den Channel senden#

Schritt 2

Um eine Nachricht an den "Channel" zu senden, klicken Sie auf die "Send Message" Schaltfläche. Dadurch öffnet sich ein Fenster in welchem eine Nachricht eingegeben werden kann. (In diesem Beispiel wieder die Nachrichten Vorlage). Um die Nachricht zu verarbeiten klicken sie die "Process Message" Schaltfläche.

Die Nachricht wurde nun gesendet.

Nachricht anzeigen:

Nachricht suchen#

Schritt 3

Wird die Nachricht nicht sofort angezeigt, klicken Sie auf die "Search" Schaltfläche.

Nachricht anzeigen#

Schritt 4

Da eine Nachricht zum "Channel" gesendet wurde sollte diese nun unter Channel Messages auftauchen. Es gibt einen Eintrag für die Eingehende Nachricht, und eine beliebige Anzahl Dateneinträgen für jeden Zielort / Destination welche wir konfiguriert haben. (In diesem Beispiel nur ein Zielort)

Die Nachricht wird in "Raw" wie sie angekommen ist angezeigt. In "Transformed" im XML Format für die interne Verarbeitung und im Encoded Format welches für die ausgehende Nachricht festgelegt wurde. In diesem Beispiel von LDTx zu LDTx.

Gesendete Nachricht anzeigen#

Schritt 5

Unter Zielort 1 wird unsere konvertierte Nachricht angezeigt, bei dieser gibt es 2 neue Tabs: "Sent" und "Response". Unter "Sent" wird die gesendete Nachricht angezeigt und die Antworten, die darauf gegeben wurden, werden unter "Response" aufgelistet.