Attributzuordnungen konfigurieren
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.
Tipp
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 | Ein Suchvorgang auf die Attributzuordnung 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 für das Attribut. Folgende Werte werden für den Aktionstyp unterstützt: Daten kopieren: Direktes Kopieren 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 Dataverse immer einen Standardwert fest. Dieser Aktionstyp ist hilfreich, wenn das Attribut benötigt wird, aber im Quellsystem nicht vorhanden ist. Zugeordneter Wert: Transformieren und ordnen Sie Daten zu. 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 Expandieren als Aktionstyp auswählen, ist dieser Wert ein Suchvorgang für die zugehörige 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 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": [
""
]
}
Wo
- „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
Untergeordnete Arrays in FHIR-JSON-Nachrichten enthalten keinen eindeutigen Bezeichner wie FHIR-Ressourcen auf Stammebene. Aufgrund dieser Eigenschaft erfordern die 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. Dieses Feld ist wichtig für Erweiterungskarten und zur Wahrung 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 eine Attributzuordnung für eine Entität, die zu den Standardzuordnungen des Datenintegrations-Toolkits gehört, nicht benötigen, können Sie sie deaktivieren. Vielleicht müssen Sie zum Beispiel das Attribut Im Auftrag von im ePA-System für die Entität Behandlung nicht synchronisieren und speichern.
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.
Setzen Sie den Wert des Feldes Deaktiviert auf Ja.
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-Service Archivieren aus.
Archivierte Attributzuordnungen anzeigen
Öffnen Sie die Entitätszuordnung.
Wählen Sie auf der Registerkarte Allgemein unter Zugehörige Attributzuordnungen Aktive 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. So können Sie dieser Entitätszuordnung Attributzuordnungen hinzufügen:
Unter Zuordnung einrichten wählen Sie Entitätszuordnungen aus.
Wählen Sie in der Liste der Entitäten die Kontakt-Entität aus, die der FHIR-Ressource Patient zugeordnet ist, und wählen Sie dann Bearbeiten aus.
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 bei Dataverse für diesen Patienten eine Änderung auftritt und das Erforderliche FHIR-Attribut auf Ja gesetzt ist, müssen Sie das Attribut ausfüllen. Wenn Sie das Attribut nicht ausfüllen, wird die Änderung in Dataverse gespeichert, jedoch 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. Dieser Wert bedeutet, dass die Zeichenfolgendaten aus einem System in 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 eine JSON-Suchzeichenfolge hinzufügen, die es Ihnen erlaubt, zum FHIR-Element zu gelangen, bei dem es sich um Vorname handelt.
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.
