Attributzuordnungen konfigurieren

Artikel
06/19/2023

Anmerkung

Der Synchronisierungs-Agent für FHIR wurde jetzt in Datenintegrations-Toolkit umbenannt.

Das Datenintegrations-Toolkit liefert Standardkarten, die der HL7 FHIR-Spezifikation entsprechen. Allerdings werden sowohl Entitäts- als auch Attributzuordnungen als Dataverse-Datensätze bereitgestellt und sind hochgradig konfigurierbar, um Ihren verschiedenen Lösungsanforderungen gerecht zu werden.

Um mehr über Attributzuordnungen zu erfahren, gehen Sie zu Übersicht über Attributzuordnungen.

Trinkgeld

Sie können die Option Nach Excel exportieren in der Befehlsleiste zum Exportieren der Zuordnungsinformationen in eine Excel-Datei verwenden. Weitere Informationen zum Exportieren von Daten aus der App in eine Excel-Datei finden Sie unter Daten nach Excel exportieren.

Attributszuordnungs-Felder

Attributzuordnungen stellen die Zuordnung von FHIR-Knoten zu Dataverse-Feldebenen bereit. Sie müssen verschiedene Datentypen berücksichtigen.

Feldname	Beschreibung
Deaktivieren	Flag, die angibt, ob die Attributzuordnung deaktiviert ist. Wenn der Wert auf `True` gesetzt ist, überspringt die Dataverse Healthcare API die Attributzuordnung bei der Verarbeitung einer FHIR-Ressource für die zugehörige Entitätszuordnung.
Erforderliches FHIR-Attribute	Wenn das Zurückschreiben aktiviert ist, gibt dieses Flag an, ob das Attribut beim Senden von Daten an den FHIR-Server erforderlich ist.
Entitätszuordnung des Update-Service	Suchen Sie nach der Attributzuordnung in der übergeordneten Entitätszuordnung.
Entitätsname	Der Schemaname der Dataverse-Tabelle für die übergeordnete Entitätszuordnung.
Attributname	Der Schemaname der Dataverse-Spalte, der die FHIR-Werte zugeordnet werden würden. Diese Liste ändert sich je nach Auswahl der Entitätszuordnung.
Aktionstyp	Der Typ der Wertzuordnung, die für das Attribut erfolgt. Im folgenden Abschnitt werden die verschiedenen Aktionstypwerte aufgeführt: Daten kopieren: Direkte Kopie der Daten ohne jegliche Art von Transformation. Dieser Aktionstyp wird vor allem dann verwendet, wenn die Datentypen in beiden Systemen übereinstimmen. Standardwert festlegen: Legen Sie in CDS immer einen Standardwert fest. Dieser Aktionstyp ist hilfreich, wenn das Attribut benötigt wird, aber im Quellsystem nicht vorhanden ist. Zugeordneter Wert: Transformation und Zuordnung der Daten. Dieser Aktionstyp wird am besten verwendet, wenn Datentypen nicht übereinstimmen, z. B. bei Dataverse Auswahlmöglichkeiten oder Ja oder Nein Optionen. Lookup: Ordnet FHIR-Referenzen Dataverse -Suchwerten zu. Kodierbares Konzept: Ordnet einen FHIR-Kodierungsknoten einer kodierbaren Konzeptsuche in Dataverse zu. Erweitern: Ordnet einen FHIR-Knoten vom Typ Array einer zugehörigen Erweiterungstabelle zu.
FHIR-Elementtyp	Wert, der den Datentyp des Elements in der FHIR-JSON-Nachricht angibt.
FHIR-Elementzuordnung	Feld, das die JSONPath-Abfrage für den spezifischen FHIR-Knoten enthält. Es enthält Anweisungen zum Abrufen des eingehenden Werts und zum Strukturieren des ausgehenden Werts für das Zurückschreiben. Weitere Informationen zu diesem Feld finden Sie unter FHIR-Elementzuordnung.
Zuordnung von Erweiterungsentitäten	Wenn Sie Erweitern als Aktionstyp auswählen, ist dieser Wert eine Suche nach der zugehörigen Entitätszuordnung des Typs Erweiterung. Weitere Informationen zu Erweiterungskarten finden Sie unter Erweiterungszuordnungen konfigurieren.
In Datensatzzuordnung verwendet	Bei Attributzuordnungen im Zusammenhang mit Erweiterungsentitätszuordnungen gibt dieses Feld an, ob das Feld Dataverse ein Schlüssel oder Teil eines zusammengesetzten Schlüssels ist, der den an Dataverse gesendeten Datensatz eindeutig identifiziert. Weitere Informationen finden Sie unter Bei der Datenzuordnung verwendet.

FHIR-Elementzuordnung

Die Entitätsattributzuordnungsdefinitionen auf Microsoft Dataverse enthalten ein FHIR-Elementzuordnungsfeld. Dieses Feld definiert, wie Werte zwischen dem Azure Health Data Services-FHIR-Dienst und FHIR-aktivierten Endpunkten abgerufen und gesendet werden.

Diese Zuordnungsdefinitionen sind in einem serialisierten JSON-Objekt mit Einträgen zur Unterstützung der JSONPath-Auswahl zum Abrufen und Aktualisieren vorhandener Eigenschaftswerte enthalten. Es enthält auch Definitionen zum Einfügen neuer Eigenschaftswerte, die auf der empfangenden Plattform noch nicht vorhanden sind.

Definition des JSON-Objekts

{
    "s": "",
    "c": { 
            "p": "",
            "a": [
                   ""
                 ]
}

Dabei gilt Folgendes:

„s“ = Ein gültiger JSONPath-Ausdruck, der verwendet wird, um eine vorhandene JSON-Eigenschaft der FHIR-Ressource auszuwählen, aus der Werte extrahiert oder auf Dataverse festgelegt werden sollen.
„c“ = JSON-Eigenschaftsfelder, die zum Einfügen oder Erstellen von JSON-Eigenschaften verwendet werden, wenn der Auswahlpfad im JSON-Objekt der Ressource nicht vorhanden ist.
„p“ = Der Name der zu erstellenden übergeordneten JSON-Eigenschaft.
„a“ = Array der Attribute, die für die ausgewählte JSON-Eigenschaft festgelegt werden sollen.

Weitere Details und Beispiele zur Attributzuordnungskonfiguration finden Sie unter Attributzuordnungsbeispiele.

In Datensatzzuordnung verwendet

Da untergeordnete Arrays in FHIR-JSON-Nachrichten keine eindeutigen Bezeichner wie FHIR-Ressourcen auf Stammebene enthalten, erfordern Dataverse Healthcare APIs der Rückschreibprozess und die virtuellen Gesundheitsdatentabellen andere Kriterien, um sicherzustellen, dass die richtigen Werte erstellt und aktualisiert werden. Mit dem Feld Bei der Datensatzzuordnung verwendet können Sie identifizieren, welches Erweiterungskartenattribut verwendet werden soll, um Eindeutigkeit zu signalisieren. Dies ist wichtig für Erweiterungskarten und für die Aufrechterhaltung der Datenintegrität beim Aktualisieren von Dataverse-Datensätzen.

Damit der Wert Bei der Datensatzzuordnung verwendet auf True gesetzt wird, müssen Sie mindestens eine Attributzuordnung für eine Erweiterungsentitätszuordnung haben. Wenn dieses Feld bei mehr als einer Attributzuordnung als True markiert ist, stellt die kombinierte Liste der Attributzuordnungen zusammen einen zusammengesetzten Schlüssel bereit, wenn neue Datensätze auf Erweiterungsebene erstellt und aktualisiert werden.

Anmerkung

Das Ändern dieses Feldwerts, nachdem ein System in Betrieb genommen wurde, kann möglicherweise zu Datenkorruptionsproblemen führen, wenn vorhandene Datensätze geändert werden. Stellen Sie sicher, dass Ihr Interoperabilitätsteam dies überprüft, bevor Sie Änderungen vornehmen.

Attributzuordnungs-Datensätze verwalten

In den folgenden Abschnitten werden einige allgemeine Schritte zum Konfigurieren und Verwalten von Attributzuordnungen aufgeführt. Ausführliche Beispiele finden Sie unter Beispiele für Attributzuordnungen.

Der Entitätzuordnung eine Attributzuordnung hinzufügen

Öffnen Sie die Entitätszuordnung.
Wählen Sie auf der Registerkarte Allgemein unter Zugehörige Attributzuordnungen+ Neue Aktualisierungs-Service-Attributzuordnung aus.

Zuordnung einer Attribut-Map deaktivieren

Wenn Sie keine im Datenintegrations-Toolkit enthaltene Attributzuordnung als Standardzuordnung benötigen, können Sie die Attributzuordnung deaktivieren. Beispielsweise müssen Sie für die Behandlungsentität möglicherweise nicht über das Attribut im Auftrag von verfügen, das synchronisiert und im ePA-System gespeichert wird.

Unter Zuordnung einrichten wählen Sie Attributszuordnungen aus.
Wählen Sie die Entität msemr_encounter und dann Bearbeiten aus.
Wählen Sie in Zugehörige Attributzuordnungen erst msemr_onbehalfof und dann Bearbeiten aus.
Legen Sie den Wert auf Deaktiviert auf Ja fest.
Wählen Sie Speichern.

Archivieren einer Attributzuordnung

Sie können jede Attributzuordnung deaktivieren, sie wird jedoch weiterhin in der Ansicht Aktive Attributzuordnungen des Update-Service angezeigt. Sie entfernen Sie eine Attributzuordnung aus dieser Ansicht, indem Sie die Attributzuordnung archivieren.

Öffnen Sie die Entitätszuordnung.
Auf der Registerkarte Allgemein wählen Sie unter Zugehörige Attributzuordnungen die Attributzuordnung aus.
Wählen Sie in der Kopfzeile Aktive Attributzuordnungen des Update-ServiceArchivieren aus.

Archivierte Attributzuordnungen anzeigen

Öffnen Sie die Entitätszuordnung.
Wählen Sie auf der Registerkarte Allgemein unter Zugehörige AttributzuordnungenAktive Attributzuordnungen des Update-Service und dann Archivierte Attributzuordnungen des Update-Service.

Dienstattributzuordnung erstellen

Die Kontaktentität in Dataverse wird der Patientenressource in Azure-FHIR zugeordnet. Sie können der Entitätszuordnung Attributzuordnungen hinzufügen.

Unter Zuordnung einrichten wählen Sie Entitätszuordnungen aus.
Wählen Sie in der Liste der Entitäten Kontakt, die der FHIR-Ressource Patient zugeordnet ist, und wählen Sie dann Bearbeiten.
Wählen Sie in Zugehörige Attributzuordnungen+ Neue Attributzuordnung des Update-Service.
Legen Sie den Wert Erforderliches FHIR Attribut auf Nein fest.

Diese Einstellung gibt an, wie der Datenfluss zum konfigurierten FHIR-Endpunkt ervicebus zurückfließt. Wenn eine Änderung innerhalb von Dataverse für diesen Patienten erfolgt und das FHIR Erforderliche Attribut auf Ja festgelegt ist, wird die Dataverse-Änderung in Dataverse gespeichert, aber nicht an den FHIR-Endpunkt gesendet. Das Ereignis wird in die Protokolle geschrieben.
Für Attributname wählen Sie Vorname (Vorname) aus.
Für Aktionstyp wählen Sie Daten kopieren aus. Diese Wert bedeutet, dass die Zeichenfolgendaten auf einem System auf das andere System kopiert werden.
Für FHIR-Elementzuordnung fügen Sie die JSON-Suchzeichenfolge hinzu, die mit der FHIR-API funktioniert. Sie könnten zum Beispiel einen JSON-Suchstring hinzufügen, der es Ihnen erlaubt, zum FHIR-Element „Vorname“ zu gelangen.
Wählen Sie Speichern. Der Abschnitt Wertzuordnungen wird jetzt im selben Fenster mit der Option + Neue Attributwertzuordnung angezeigt. Eine Wertezuordnung ist für die Kontaktentitä nicht erforderlich, da es sich um eine Zeichenfolge handelt.
In der Entitätszuordnung für Kontakt in Zugehörige Attributzuordnungen können Sie nun die Attributzuordnung für den Namen Vornamen in den Listenattributzuordnung anzeigen.

Siehe auch

Was ist Microsoft Cloud for Healthcare?
Übersicht über das Datenintegrations-Toolkit
FHIR-Daten mit dem Datenintegrations-Toolkit verwalten
Entitätszuordnungen konfigurieren
Konfigurieren Erweiterungskarten
Datenintegrations-Toolkit-Zuordnung: Beispiele und Anwendungsfälle

Share via