Mit dem Wort "Integrationen" meinen wir technische Integrationen zwischen zwei oder mehr Systemen. Dabei handelt es sich um Anwendungen wie ein EHR oder ein BI-Tool und die Minddistrict-Plattform. Integrationen können für administrative oder Forschungszwecke nützlich sein.

Es gibt zwei Arten von Integrationen:

  1. Eine Integration für Authentifizierung: automatisches Login von einem System zu einem anderen System
  2. Integrationen für Synchronisation: Datenaustausch zwischen Systemen

Für jede unten beschriebene Integration finden Sie den entsprechenden Typ.

Mit der Bereitstellung und Konfiguration von Integrationen sind Kosten verbunden. Möchten Sie dies nutzen oder weitere Informationen erhalten? Bitte wenden Sie sich an Ihren Account Manager.
In der Konfigurationskachel der meisten Integrationen können Sie auf ein Fehlerprotokoll zugreifen. Läuft etwas nicht wie erwartet? Überprüfen Sie immer das Fehlerprotokoll.

Active Directory

Dies ist eine Integration zur Synchronisation von Daten.

Diese Integration erstellt, aktualisiert und deaktiviert automatisch Mitarbeiterkonten auf der Minddistrict-Plattform direkt aus der Quelldatenbank Ihrer Organisation. Somit wird die Verwaltung dieser Konten innerhalb von Minddistrict standardisiert, vereinfacht und auch deutlich sicherer.


Sobald diese Integration für Sie bereitgestellt wird, können Sie sie selbst konfigurieren. Jedes Feld und die Einführung enthalten eine Erklärung.



Nutzen Sie die Azure AD-Synchronisation in Kombination mit der Authentifizierungsmethode SAML, die dieselbe Registrierungsquelle verwendet? Dann bedeutet das Einloggen in die Arbeitsumgebung Ihrer Organisation, dass sich Fachkräfte nicht mehr manuell auf der Plattform anmelden müssen.

Minddistrict integriert sowohl mit Azure Active Directory als auch mit lokalem Active Directory (AD).
Überprüfen Sie das Fehlerprotokoll über die Schaltfläche oben rechts, wenn der API-Link nicht wie erwartet funktioniert. In der Regel finden Sie hier bereits relevante Informationen zum Problem.

API-Nutzer

Dies ist eine Integration zur Synchronisation von Daten.

Über die (REST) API können Aufgaben und Informationsabfragen automatisch ausgeführt werden.


Die (REST) API besteht aus verschiedenen sogenannten 'Endpoints'. Jeder Endpoint entspricht einer Funktion der Plattform. Sie können diese von einem anderen System, wie einem EPD, einem Klientenportal oder einem BI-Tool, abfragen. Abhängig von der Anfrage des Systems kann die REST API auf Informationsanforderungen reagieren, neue Daten erstellen oder bestehende Daten ändern.



1 API-Benutzer hinzufügen

Mit der Schaltfläche 'Hinzufügen' können Sie mehrere API-Benutzer hinzufügen. So können Sie die REST API für mehrere Interaktionen mit Ihrem EPD und/oder BI-Tool verwenden.


Sobald Sie auf 'Hinzufügen' klicken, gelangen Sie zu folgendem Bildschirm:



In diesem Bildschirm klicken Sie auf 'Hinzufügen', nachdem Sie die richtigen Details ausgefüllt haben. Anschließend werden Sie zu einem Bildschirm weitergeleitet, in dem Sie ein Token sehen:


Beachten Sie, dass Sie das Token nur einmal sehen. Speichern Sie dieses Token sofort an einem sicheren Ort.


2 Fehlerprotokoll

Funktioniert die REST API nicht wie erwartet? Überprüfen Sie das Fehlerprotokoll. Sie finden es über die Schaltfläche oben rechts.


Wenn Sie sich wegen eines Problems mit der API an den Minddistrict-Support wenden, werden Sie immer gebeten, dieses Fehlerprotokoll zu überprüfen und den Fehler zu melden.

Richten Sie gerade die REST API ein? Sehen Sie sich die verfügbaren technischen Dokumentationen zur API(öffnet in einem neuen Fenster) an.

Delegated logon

Dies ist eine Authentifizierungs-Integration.

Delegiertes Login (SSO) ermöglicht es Fachleuten und/oder Klienten, sich mit denselben Anmeldeinformationen in mehrere Systeme einzuloggen. Zum Beispiel: Ein Fachmann loggt sich in das EHR ein und wechselt von dort zur Minddistrict-Plattform, ohne sich erneut anmelden zu müssen. Oder ein Klient kann direkt über das SSO zur Plattform gelangen, ohne sich dort erneut anmelden zu müssen.



Sobald diese Integration für Sie verfügbar ist, konfigurieren Sie sie selbst (möglicherweise gemeinsam mit der Organisation, mit der Sie integrieren möchten).


Hinzufügen

Die Informationen beider Systeme werden durch einen Anmelde-Schlüssel integriert und gesichert. Sie generieren diesen Schlüssel innerhalb der Minddistrict-Plattform. Gehen Sie dazu auf die Seite, auf der dieser delegierte Anmelde-Schlüssel (Geheimschlüssel) über die Schaltfläche 'Hinzufügen' erstellt wird.


Bitte beachten Sie, dass Sie diesen Schlüssel aus Sicherheitsgründen nur einmal sehen werden. Aus denselben Gründen ist es notwendig, diesen Schlüssel sicher an das Drittanbietersystem zu übermitteln (E-Mail ist kein sicherer Weg, um diese Informationen auszutauschen).


Aktiv für Klienten und Freunde und/oder Fachleute

In diesen beiden Bereichen wählen Sie die Zielgruppe(n) aus, für die das delegierte Login (SSO) verfügbar sein wird.

Technische Dokumentation zum delegierten Login(öffnet in einem neuen Fenster) hilft Ihnen, das SSO (wieder) einzurichten oder wenn das SSO nicht wie erwartet funktioniert.

HL7

Bei der HL7-Integration werden Daten synchronisiert.

Die HL7-Integration ist eine passive Datenintegration. Das bedeutet, dass die Minddistrict-Plattform HL7-Nachrichten von einem externen System wie einem EHR empfangen und verarbeiten kann, jedoch selbst keine HL7-Nachrichten zurücksendet.


In der Plattform lösen die Nachrichten Aktionen aus, wie das Erstellen oder Aktualisieren eines Klientenaccounts oder das Herstellen einer Beziehung zwischen einem Therapeuten und einem Klienten. Dies unterstützt verschiedene Arbeitsabläufe innerhalb Ihrer Organisation.



Wurde die HL7-Integration für Sie verfügbar gemacht? Mögliche Fehler werden protokolliert und können über die Schaltfläche 'Fehlerprotokoll' aufgerufen werden.


HL7-Nachrichten werden in interne API-Aufrufe umgewandelt. Diese API validiert eingehende Informationen und wendet Änderungen an. Fehler, die auftreten, sind 60 Tage sichtbar und werden danach bereinigt.

Technische Dokumentation zur HL7-Integration(öffnet in einem neuen Fenster) kann verwendet werden, wenn Sie auf einen Fehler stoßen oder wenn Sie die Integration (wieder) einrichten möchten.

SAML

Dies ist eine Authentifizierungs-Integration.

SAML ist eine Single Sign-On (SSO)-Methode. Mit SAML müssen sich Mitarbeiter nicht mehr manuell in die Minddistrict-Plattform einloggen, wenn sie bereits in einem System wie einer Arbeitsumgebung oder einem EHR eingeloggt sind. Dies vereinfacht den Anmeldeprozess auf sichere und standardisierte Weise, insbesondere wenn die Arbeitsumgebung 2FA erfordert: Auf diese Weise ist die Zwei-Faktor-Authentifizierung der Plattform für den Fachmann nicht mehr erforderlich.


Setzt Ihre Organisation (Azure) Active Directory ein? Kombinieren! Dann wird es möglich, auch Minddistrict-Konten für Mitarbeiter automatisch aus derselben Registrierungsquelle zu erstellen und zu aktualisieren.