ViREQHandbuch
Start › Mirth Connect Plugins

Mirth Connect (CE) - KV Connect Plugin

17 Abschnitte · zuletzt aktualisiert 2023-02-03

KV Connect Plugin#

Einleitung

Mit unserem Plugin KV-Connect können Sie die KV-Mailbox der KV-Telematik bedienen. Sowohl das Senden als auch das Empfangen von Nachrichten ist über das KV-SafeNet möglich.

Installation#

Schritt 1

Wähle die Schaltfläche "Extensions" im Reiter Mirth Connect aus um zu einer Übersicht der installierten Plugins zu gelangen.

Auswahl des Pfads#

Schritt 2

Unten kann der Pfad des Plugins direkt angegeben werden, oder dieses wird mithilfe der Schaltfläche "Browse" im Datei-Explorer gesucht.

Auswahl des Plugins#

Schritt 3

Die Schaltfläche "Browse" öffnet ein Fenster in dem das gewünschte Plugin ausgewählt werden kann, bestätigt wird die Auswahl mit "Open / Öffnen"

Der Pfad entspricht dem Speicherort welcher beim Download ausgewählt wurde (siehe Bild).

Installation des Plugins#

Schritt 4

Nachdem das gewünschte Plugin ausgewählt wurde muss auf die "Install / Installieren" Schaltfläche geklickt werden, um das Plugin zu installieren.

Neustarten des Servers und Clients#

Schritt 5

Wenn das Plugin erfolgreich importiert wurde muss der Mirth Connect Server und der Mirth Connect Administrator neugestartet werden, damit die Plugins aktiviert werden.

Überprüfung der Installation#

Schritt 6

Nach einem Neustart sollte das installierte Plugin in der Liste "Installed Plugins" auftauchen. Diese findet man als Tabelle unter der Schaltfläche "Extensions" im "Mirth Connect" Reiter.

Glückwunsch, Sie haben das KV-Connect Plugin erfolgreich installiert!

Bedienungsanleitung#

Wie muss dieses Plugin konfiguriert werden ?

Empfänger#

Wird das KV-Connect Plugin bei der Source eines Channels als Connector ausgewählt, können Sie Nachrichten empfangen:

Channel Konfiguration#

Schritt 1

Wie gelangen Sie zur Source eines Channels?

Klicken sie auf die Schaltfläche Channels unter "Mirth Connect" und doppelklicken sie den Channel welchen sie bearbeiten möchten, oder erstellen sie einen neuen.

Source festlegen / Channel als KV-Empfänger konfigurieren#

Schritt 2

Um den Channel als KV-Connect-Empfänger zu konfigurieren muss "KV-Connect-Empfänger" als Connector Type ausgewählt werden. Navigieren Sie dazu im oberen Reiter der Channel Einstellungen zu "Source" und wählen Sie unter "Connector Type" KV-Connect-Empfänger aus.

Polling Einstellungen#

EinstellungenBeschreibung
Poll Once on Start:Wähle yes um beim Starten sofort einmal die Nachrichten abzurufen. Alle weiteren Aktualisierungen folgen dem gesetzten Zeitplan.
IntervalHier kann der Intervall festgelegt werden wie oft Nachrichten abgerufen werden sollen. (In Millisekunden, Sekunden, Minuten oder Stunden). Mit einem Klick auf die Schaltfläche mit dem Schraubenzieher können erweiterte Zeitpläne festgelegt werden.

Source Einstellungen#

EinstellungenBeschreibung
Source Queue:Wenn "Off" ausgewählt ist wird die Nachricht vor dem Senden der Antwort verarbeitet (kann Antwort von destinations verwenden)
Wenn "On" ausgewählt ist werden die Nachrichten gesammelt (kann Antwort von destinations NICHT verwenden)
Queue Buffer Size:So viele Nachrichten dürfen im Buffer gespeichert werden.
Response:None:
Es wird keine Antwort gesendet.
Auto generate (before processing):
Antwort wird vor der Verarbeitung der Nachricht erstellt.
Auto generate (after source Transformer)
Antwort wird erstellt, nachdem die Nachricht verarbeitet wurde.
Auto generate (destinations completed)
Antwort wird erstellt nachdem die Nachricht verarbeitet wurde, und mit einem Status der Destination
Process BatchWird "yes" ausgewählt aktiviert das die Batch-Verarbeitung
Batch Nachrichten werden nur unterstützt wenn die "Inbound-properties" des Connectors eine Batch Sektion enthalten.
Batch Response:Jede Nachricht im Batch enthält ihre eigene Antwort, welche mit der oben ausgewählten Methode erstellt wird. Hier kann entweder die erste oder letzte Nachricht gewählt werden, um diese an das Ursprungs-System zurückzusenden.
Max Processing Threads:Legt die Anzahl der maximalen Nachrichten fest, die gleichzeitig durch den Channel geleitet werden dürfen.
(wenn dieser Wert größer als 1 ist, wird die Nachrichten Reihenfolge nicht garantiert.)

KV-Connect-Empfänger Einstellungen#

Im Source Tab muss der KV Connect Connector konfiguriert werden:

EinstellungenBeschreibung
VerbindungsinformationenHier müssen die Verbindungsinformationen ihres KV-Connect-Kontos eingegeben werden. Dazu benötigen Sie ihren Benutzernamen, ihr Passwort, den Zertifikatsspeicher und ihre PIN.
VerarbeitungHier wählen Sie ob der Connector Nachrichten oder Adressbücher verarbeiten soll.
NachrichtenfilterWenn bei der Verarbeitung Nachrichten gewählt wurde:
Hier können Eigenschaften zum Filtern einer Nachricht angegeben werden, darunter den Nachrichtentyp, den Betreff. die XKVC-Dienstkennung und den Absender.
NachrichtenverarbeitungWenn bei der Verarbeitung Nachrichten gewählt wurde:
Hier steht zur Auswahl ob eine einzelne Nachricht, oder ein Nachrichtensegment verarbeitet werden soll. Wählt man Nachrichtensegment, muss dieses benannt werden. Zusätzlich kann ausgewählt werden ob die Mail nach der Verarbeitung gelöscht werden soll, und ob eine Message Disposition Notification (MDN) versendet werden soll.
AdressbuchfilterWenn bei der Verarbeitung Adressbuch gewählt wurde:
Ein Adressbuchfilter kann nach:

• Accountname
• Firma
• Nachname
• Vorname
• Mail
• Straße
• PLZ
• Stadt
filtern. Dazu muss mithilfe der Schaltfläche neben "Adressbuchfilter:" eine der oben genannten Filter ausgewählt werden und die Bezeichnung in das Textfeld daneben geschrieben werden.
AdressbuchverarbeitungWenn bei der Verarbeitung Adressbuch gewählt wurde:
Hier kann nochmal ausgewählt werden ob die Adressbuchverarbeitung Einzelaccounts oder eine Accountliste verarbeiten soll.

Sender#

Möchten Sie Nachrichten versenden, müssen Sie das Plugin als Destination einrichten:

Destination Einstellungen#

SettingsDescription
Queue MessagesNever:
Deaktiviert die Warteschlange
On Failure:
Versucht die Nachricht erst zu senden bevor sie in die Warteschlange kommt, das erlaubt den Destinations und den Weiterverarbeitern die Antwort dieser Destination zu verwenden, wenn Sie erfolgreich vor dem sammeln in der Warteschlange abgesendet wird.
Always:
Die Nachricht wird immer in der Warteschlange gesammelt, die Nachfolgenden "Destinations" sehen diese Nachricht immer als in der Warteschlange
Advanced Queue Settingserweiterte Einstellungen zur Queue
Validate ResponseWählen Sie „Yes“, um die Antwort zu validieren. Dies ist nur möglich, wenn die eingehenden Eigenschaften einen Antwortvalidierungsabschnitt enthalten
Reattach Attachments

KV-Connect Sender Einstellungen#

EinstellungenBeschreibung
KV-Connect System
• BenutzernameTragen Sie hier ihren KVB Benutzernamen ein
• PasswortTragen Sie hier das Passwort für Ihren KVB Account ein
• ZertifikatsspeicherGeben Sie hier Ihren Zertifikatsspeicher an
• PinGeben Sie hier Ihre Pin ein
EmpfängerSpezifizieren Sie hier den Empfänger der Nachrichten (kann über die Schaltfläche mit "..." ausgewählt werden)
NachrichtentypWählen Sie hier einen Nachrichtentyp aus
BetreffTragen Sie hier den Betreff der zu sendenden Nachricht ein.
HeaderÜber "Neu" besteht die Möglichkeit neue Header einzufügen, und diese danach mit einem Doppelklick zu bearbeiten.
SegmenteÜber "Neu" besteht die Möglichkeit neue Segmente einzufügen, und diese danach mit einem Doppelklick zu bearbeiten.