Kenmerktoewijzingen configureren
De gegevensintegratietoolkit wordt geleverd met standaardkaarten die zijn gebouwd om te voldoen aan de HL7 FHIR-specificatie. Zowel entiteits- als kenmerktoewijzingen worden echter ingezet als Dataverse-records en zijn in hoge mate configureerbaar om tegemoet te komen aan uw verschillende oplossingsvereisten.
Ga voor meer informatie over kenmerktoewijzingen naar Overzicht van kenmerktoewijzingen.
Fooi
Gebruik de optie Exporteren naar Excel in de opdrachtbalk om de toewijzingsinformatie naar een Excel-bestand te exporteren. Ga voor meer informatie over het exporteren van gegevens uit uw app naar een Excel-bestaand naar Gegevens naar Excel exporteren.
Velden voor kenmerktoewijzingen
Kenmerktoewijzingen bieden de toewijzing op veldniveau van het FHIR-knooppunt naar Dataverse. Ze moeten rekening houden met verschillende gegevenstypen.
| Veldnaam | Omschrijving |
|---|---|
| Uitschakelen | Vlag die aangeeft of de kenmerktoewijzing is uitgeschakeld. Als de waarde is ingesteld op True, slaat de Dataverse Healthcare API de kenmerktoewijzing over bij het verwerken van een FHIR-resource voor de gerelateerde entiteitstoewijzing. |
| Vereist FHIR-kenmerk | Wanneer terugschrijven is ingeschakeld, geeft deze vlag aan of het kenmerk vereist is bij het verzenden van gegevens naar de FHIR-server. |
| Entiteitstoewijzing van de updateservice | Een opzoekbewerking voor de bovenliggende entiteitskaart voor de kenmerktoewijzing. |
| De naam van de entiteit | De schemanaam van de Dataverse-tabel voor de bovenliggende entiteitstoewijzing. |
| Kenmerknaam | De schemanaam van de Dataverse-kolom waaraan de FHIR-waarden zouden worden toegewezen. Deze lijst verandert afhankelijk van de entiteitskaartselectie. |
| Actietype | Het type waardetoewijzing voor het kenmerk. Hieronder staan de ondersteunde waarden voor actietypen: Gegevens kopiëren: directe kopie van de gegevens zonder enige vorm van transformatie. Dit actietype wordt voornamelijk gebruikt wanneer het gegevenstype in beide systemen overeenkomt. Standaardwaarde instellen: stel altijd een standaardwaarde in Dataverse in. Dit actietype is handig wanneer het kenmerk nodig is, maar niet bestaat in het bronsysteem. In kaart gebrachte waarde: transformeer en breng de gegevens in kaart. Dit actietype kan het beste worden gebruikt wanneer gegevenstypen niet overeenkomen, zoals met Dataverse-keuzes of Ja- of Nee- opties. Opzoeken: wijst FHIR-verwijzingen toe aan Dataverse opzoekwaarden. Codeable concept: wijst een FHIR-coderingsknooppunt toe aan een codeable concept-zoekopdracht in Dataverse. Uitbreiden: wijst een FHIR-knooppunt van het type matrix toe aan een gerelateerde uitbreidingstabel. |
| Type FHIR-element | Waarde die het gegevenstype aangeeft van het element in het FHIR JSON-bericht. |
| Toewijzing van FHIR-element | Veld met de JSONPath-query voor het specifieke FHIR-knooppunt. Dit bevat instructies voor het ophalen van de inkomende waarde en het structureren van de uitgaande waarde voor terugschrijven. Ga voor meer informatie over dit veld naar FHIR-elementtoewijzing. |
| Toewijzing voor uitbreidingsentiteiten | Wanneer u Uitbreiden selecteert als het Actietype, is deze waarde een opzoekbewerking naar de gerelateerde entiteitskaart van het type Uitbreiding. Ga voor meer informatie over uitbreidingstoewijzingen naar Uitbreidingstoewijzingen configureren. |
| Gebruikt bij matching aan records | Voor kenmerktoewijzingen die zijn gerelateerd aan toewijzing voor uitbreidingsentiteiten, geeft dit veld aan of het Dataverse-veld een sleutel is of deel uitmaakt van een samengestelde sleutel die op unieke wijze het record identificeert dat naar Dataverse is verzonden. Ga voor meer informatie naar Gebruikt bij matchen van records. |
Toewijzing van FHIR-element
De definities voor het toewijzen van entiteitskenmerken op Dataverse bevatten een veld voor Toewijzing van FHIR-element. Dit veld definieert hoe waarden moeten worden opgehaald en verzonden tussen de FHIR-service Azure Health Data Services en eindpunten waar FHIR voor is ingeschakeld.
Deze toewijzingsdefinities zijn opgenomen in een geserialiseerd JSON-object met vermeldingen ter ondersteuning van JSONPath-selectie voor het ophalen en bijwerken van bestaande eigenschapswaarden. Het bevat ook definities voor het invoegen van nieuwe eigenschapswaarden die nog niet bestaan in het ontvangende platform.
JSON-objectdefinitie
{
"s": "",
"c": {
"p": "",
"a": [
""
]
}
Waar
- "s" = Een geldige JSONPath-expressie die wordt gebruikt om een bestaande JSON-eigenschap van de FHIR-resource te selecteren om waarden van en naar Dataverse te extraheren of in te stellen.
- "c" = JSON-eigenschapsvelden die worden gebruikt om JSON-eigenschappen in te voegen of te maken wanneer het geselecteerde pad niet bestaat in het resource-JSON-object.
- "p" = De naam van de bovenliggende JSON-eigenschap die moet worden gemaakt.
- "a" = Matrix van kenmerken die moeten worden ingesteld op de geselecteerde JSON-eigenschap.
Ga voor meer details en voorbeelden van de configuratie van kenmerktoewijzingen naar Voorbeelden van kenmerktoewijzingen.
Gebruikt bij matchen van records
Onderliggende matrices in FHIR JSON-berichten bevatten geen unieke id's zoals FHIR-resources op rootniveau. Vanwege deze eigenschap hebben de Dataverse API's voor gezondheidszorg, het terugschrijfproces en de virtuele tabellen met gezondheidsgegevens andere criteria nodig om ervoor te zorgen dat de juiste waarden worden gemaakt en bijgewerkt. Met het veld Gebruikt bij matchen van records kunt u bepalen welk kenmerk van de uitbreidingstoewijzing moet worden gebruikt om uniciteit aan te geven. Dit veld is belangrijk voor uitbreidingskaarten en voor het behouden van de gegevensintegriteit bij het bijwerken van Dataverse-records.
Om de waarde Gebruikt bij het matchen van records ingesteld te krijgen op True, moet u ten minste één kenmerktoewijzing hebben voor een toewijzing voor uitbreidingsentiteit. Als dit veld voor meer dan één kenmerktoewijzing is gemarkeerd als True, vormt de gecombineerde lijst met kenmerktoewijzingen een samengestelde sleutel bij het maken en bijwerken van nieuwe records op uitbreidingsniveau.
Notitie
Als u deze veldwaarde wijzigt nadat een systeem live en in productie is, kan dit mogelijk gegevensbeschadigingsproblemen veroorzaken wanneer bestaande records worden gewijzigd. Zorg ervoor dat uw interoperabiliteitsteam dit controleert voordat u wijzigingen aanbrengt.
Records voor kenmerktoewijzingen beheren
In de volgende secties worden enkele algemene stappen beschreven voor het configureren en beheren van kenmerktoewijzingen. Ga voor gedetailleerde voorbeelden naar Voorbeelden van kenmerktoewijzingen.
Een kenmerktoeijzing toevoegen aan de entiteitstoewijzing
Open de entiteitstoewijzing.
Selecteer op het tabblad Algemeen onder Verwante kenmerktoewijzingen de optie + Nieuwe kenmerktoewijzing van de updateservice.
Een kenmerktoewijzing uitschakelen
Als u geen kenmerktoewijzing nodig hebt voor een entiteit die is opgenomen in de standaardtoewijzingen van de toolkit voor gegevensintegratie, kunt u deze uitschakelen. Het is bijvoorbeeld mogelijk dat u het kenmerk namens niet hoeft te synchroniseren en op te slaan in het EMR-systeem voor de entiteit zorgcontact.
Selecteer onder Toewijzingsinstellingen de optie Kenmerktoewijzingen.
Selecteer de entiteit msemr_encounter en selecteer vervolgens Bewerken.
In Verwante kenmerktoewijzingen, selecteert u msemr_innamens en vervolgens Bewerken.
Stel de waarde van het veld Uitgeschakeld in op Ja.
Selecteer Opslaan.
Een kenmerktoewijzing archiveren
U kunt elke kenmerktoewijzing uitschakelen. Dit verschijnt echter nog steeds in de weergave Actieve kenmerktoewijzingen van de updateservice. Als u een kenmerktoewijzing wilt verwijderen uit deze weergave, kunt u de kenmerktoewijzing archiveren.
Open de entiteitstoewijzing.
Selecteer de kenmerktoewijzing op het tabblad Algemeen onder Verwante kenmerktoewijzingen.
Selecteer Archiveren in de weergavekoptekst Actieve kenmerktoewijzingen van de updateservice.
Gearchiveerde kenmerkwaardetoewijzingen weergeven
Open de entiteitstoewijzing.
Selecteer op het tabblad Algemeen onder Verwante kenmerktoewijzingen Actieve kenmerktoewijzingen van de updateservice en vervolgens Gearchiveerde kenmerktoewijzingen van updateservice.
Servicekenmerktoewijzing maken
De contactentiteit in Dataverse wordt toegewezen aan de patiëntresource in Azure FHIR. Zo kunt u kenmerktoewijzingen aan deze entiteitskaart toevoegen:
Selecteer onder Toewijzingsinstellingen de optie Entiteitstoewijzingen.
Selecteer in de lijst met entiteiten de entiteit Contactpersoon die is toegewezen aan de FHIR-resource Patiënt en selecteer vervolgens Bewerken.
Selecteer in Verwante kenmerktoewijzingen de optie + Nieuwe kenmerktoewijzing van de updateservice.
Stel de waarde Vereist FHIR-kenmerk in op Nee.
Deze instelling geeft aan hoe gegevens terugstromen naar het geconfigureerde FHIR-eindpunt. Wanneer er een wijziging optreedt in Dataverse voor deze patiënt en het Vereist FHIR-kenmerk is ingesteld op Ja, moet u het kenmerk invullen. Als u het kenmerk niet invult, wordt de wijziging opgeslagen in Dataverse, maar niet naar het FHIR-eindpunt gepost. De gebeurtenis wordt naar de logboeken geschreven.
Selecteer voor Kenmerknaam de optie Voornaam (voornaam).
Voor Actietype selecteert u Gegevens kopiëren. Deze waarde betekent dat de stringgegevens op het ene systeem naar het andere systeem worden gekopieerd.
Voor FHIR-elementtoewijzing voegt u de JSON-zoekreeks toe die werkt met de FHIR-API. U kunt bijvoorbeeld een JSON-zoekreeks toevoegen waarmee u naar het FHIR-element kunt gaan, wat de voornaam is.
Selecteer Opslaan. De sectie Waardetoewijzingen wordt nu weergegeven in hetzelfde venster met de optie + Nieuwe kenmerkwaardetoewijzing. De entiteit Contact vereist geen waardetoewijzing omdat het een tekenreeks is.
In de entiteitstoewijzing voor Contact onder Verwante kenmerktoewijzingen, kunt u nu de kenmerktoewijzing met de naam voornaam bekijken.
