Geharmoniseerde patiëntweergave configureren

Artikel
10/07/2023

In de geharmoniseerde patiëntweergave worden patiëntgegevens weergegeven in modelgestuurde Dynamics-apps, inclusief demografische informatie en klinische gegevens. Het bevat tevens de klinische tijdlijn en besturingselementen voor zorgteams. U kunt deze installeren met Microsoft Cloud-oplossingencentrum.

De geharmoniseerde patiëntweergave is het formulier dat wordt meegeleverd met modelgestuurde toepassingen van Microsoft Cloud for Healthcare (zoals Zorgmanagement). U kunt het ook onafhankelijk gebruiken. Als u het onafhankelijk van de mode gestuurde toepassingen downloadt, krijgt u de toepassing Beheer van gezondheidszorg met de geharmoniseerde patiëntweergave en hebt u de mogelijkheid om de geharmoniseerde patiëntweergave toe te voegen aan elke modelgestuurde toepassing die u maakt.

De geharmoniseerde patiëntweergave omvat twee formulieren. Op het ene formulier Patiënt - klinisch, worden klinische gegevens weergegeven, terwijl het andere, Patiënt - administratief, alleen niet-klinische gegevens bevat. Met de beveiligingsrollen, respectievelijk Gezondheidszorggebruiker en Niet-klinische gebruiker in de gezondheidszorg, wordt de toegang bepaald.

Het besturingselement voor de klinische tijdlijn uitbreiden

U kunt de klinische tijdlijn configureren om andere aangepaste entiteiten weer te geven dan de entiteiten die standaard zijn geconfigureerd in het webresourcebestand msemr_timelinecustomschema.xml.

Maak een kopie van het webresourcebestand msemr_timelinecustomschema.xml. Het webresourcebestand heeft het volgende schema:

Bezit	Omschrijving
logicalName	De logische naam van de entiteit.
primaryIdField	Het primaire veld van de entiteit.
displayName	De weergavenaam van de entiteit op de klinische tijdlijn.
titleField	Het veld dat wordt weergegeven als de titel op de kaarten op de klinische tijdlijn.
descriptionField	Het veld dat wordt weergegeven als de beschrijving op de kaarten op de klinische tijdlijn.
startDateField	Het veld dat wordt weergegeven als de begindatum op de kaarten op de klinische tijdlijn.
endDateField	Het veld dat wordt weergegeven als de einddatum op de kaarten op de klinische tijdlijn.
regardingField	Het opzoekveld voor de entiteit Contactpersoon.
modalDialogFormId	De id van het weergegeven formulier om een record te bekijken, te maken en te bewerken vanaf de klinische tijdlijn.

Bewerk het XML-bestand door de definitie voor de nieuwe entiteit toe te voegen en definities te verwijderen die niet voor het besturingselement moeten worden weergegeven. Hier ziet u een voorbeeld van het XML-bestand voor de entiteit Zorgplanactiviteit.

{
    "primaryIdField": "msemr_careplanactivityid",
    "logicalName": "msemr_careplanactivity",
    "displayName": "Coaching Plan Activity",
    "titleField": "msemr_description",
    "descriptionField": "msemr_activitydescription",
    "startDateField": "msemr_activitystartdate",
    "endDateField": "msemr_activityenddate",
    "regardingField": "msemr_patient",
    "modalDialogFormId": "02c4cfef-512a-4035-bb56-f2e681831515"
}

Publiceer dit XML-bestand als een webresource.
Configureer het besturingselement voor de klinische tijdlijn om naar deze webresource te verwijzen door de eigenschap Aangepaste schema-XML van het besturingselement in te stellen.
Werk het formulier bij en publiceer het. Het besturingselement voor de klinische tijdlijn in het bijgewerkte formulier geeft nu de nieuwe entiteit weer.

Het besturingselement voor de klinische tijdlijn toevoegen aan een ander formulier

De volgende twee opties zijn beschikbaar om het besturingselement voor de klinische tijdlijn aan een ander formulier toe te voegen:

Een nieuw formulier maken en het besturingselement voor de klinische tijdlijn toevoegen.
Een bestaand patiëntenformulier kopiëren.

In de volgende sectie behandelen we de eerste optie van het maken van een nieuw formulier en het toevoegen van het besturingselement.

Maak een nieuw hoofdformulier en stel vervolgens de naam van het formulier in.
Voeg een nieuw tabblad met één kolom in het formulier in en geef een tabbladlabel op.
Voeg in de tabbladsectie een subraster toe. Configureer het subraster om de entiteit Activiteiten en de weergave Alle activiteiten weer te geven. U kunt ook andere weergaven kiezen, omdat deze instelling geen invloed heeft op de gegevens die op het besturingselement worden weergegeven.
Op het tabblad Besturingselementen voor het subraster selecteert u het besturingselement Klinische tijdlijn en voegt u dit toe.
Configureer de eigenschap Aangepaste schema-XML. Stel de waarde van deze eigenschap in op msemr_timelinecustomschema.xml
Selecteer Web en Tablet voor de weergavemodi.
Bekijk de klinische tijdlijn in het nieuwe formulier door naar de modelgestuurde app te gaan, een record Contactpersoon te openen en het nieuwe formulier te selecteren.

Patiëntkoppelingen configureren

Volgens de FHIR-norm wordt met het element Patient.link een koppeling tot stand gebracht naar een andere patiëntresource die betrekking heeft op dezelfde daadwerkelijke patiënt. In de geharmoniseerde patiëntweergave worden de koppelingen van een record weergegeven op het tabblad Gekoppelde records op het patiëntenformulier. U kunt configureren hoe de eindgebruiker de koppelingen en de bijbehorende gegevens van gekoppelde records visualiseert.

Er zijn vier kopplingstypen in de FHIR-norm:

Type koppeling	Omschrijving
Zie ook en Raadpleeg	Brengt een koppeling tot stand met een geldige patiëntrecord die aanvullende informatie over de patiënt bevat.
Primair (Vervangen door in FHIR)	Brengt een koppeling tot stand met de primaire actieve record voor deze patiënt.
Inactief (Vervangt in FHIR)	Brengt een koppeling tot stand met een inactieve patiëntrecord die niet moet worden gebruikt.

De nieuwste update voor patiëntkoppelingen biedt een verbeterde gebruikservaring en biedt de volgende verbeterde mogelijkheden:

Wanneer u koppelingen verwijdert van het type Primair (Vervangen door in FHIR) of Inactief (Vervangt in FHIR), wordt de inactieve patiëntrecord nu automatisch opnieuw geactiveerd in Dataverse. Als u koppelingen bijwerkt, verwijdert of deactiveert, wordt de patiënt opnieuw geactiveerd als er geen andere koppelingen zijn die deze patiënt inactief maken. Met een veld dat de reden(en) voor deactivering bijhoudt, wordt de nieuwe activering geregeld.
Het tabblad Patiëntoverzicht geeft een bannermelding weer als een gebruiker een gekoppelde record selecteert in de tabel met koppelingen en wordt omgeleid naar de primaire record.

Neem bijvoorbeeld een scenario waarin Olivia Wilson de primaire record is en Olivia James een gekoppelde record voor deze primaire record is. Wanneer een gebruiker de gekoppelde record Olivia James selecteert en wordt doorgestuurd naar de primaire record Olivia Wilson, ziet de gebruiker het volgende bericht - "U bent hierheen doorgestuurd omdat dit patiëntendossier het primaire dossier voor Olivia James is geworden."

Instellingenpagina

Als u patiëntkoppelingen wilt configureren, navigeert u naar het tabblad Gekoppelde records in het gebied Administratieve instellingen van de app Beheer van gezondheidszorg.

De instellingenpagina bevat de volgende configuratieopties voor beheerders:

Modus Gegevens samentellen: selecteer een van de volgende twee modi voor hoe de koppelingen en de bijbehorende gegevens van gekoppelde patiëntrecords worden gevisualiseerd:
1. Geen samentelling: gegevens die zijn gekoppeld aan gekoppelde records worden op afzonderlijke pagina's weergegeven en niet samengeteld in de primaire record. Omleiding van inactieve records naar het primaire record is uitgeschakeld.
2. Gegevens van inactieve patiëntrecords samentellen: geselecteerde gegevens uit inactieve patiëntrecords verschijnen in de primaire record van de patiënt. Denk bijvoorbeeld aan drie records A, B en C voor een enkele patiënt. Stel dat er een koppeling is van het type Inactief van A naar B en een andere koppeling van B naar C. In de record van A kunnen gebruikers gegevens zoals afspraken of kennismakingen van A, B en C weergeven. Omleiding van inactieve records naar de primaire record is ingeschakeld.
  
  Naast het configureren van welke gegevenstypen worden samengeteld in de modus Gegevens samentellen, kunt u ook het meldingsgedrag configureren.
Maximale koppelingsdiepte: met deze waarde wordt verwezen naar het maximum aantal koppelingen dat moet worden gevolgd vanuit de primaire record bij het samentellen van gegevens uit andere patiëntrecords. Neem het eerdere voorbeeld met records A, B en C. Als u Maximale koppelingsdiepte instelt op 1 en Gegevens van inactieve patiëntrecords samentellen selecteert, worden in de record van A alleen de gekoppelde gegevens van A en B weergegeven. Als u Maximale koppelingsdiepte echter instelt op 2 of hoger, worden in de record van A de gekoppelde gegevens van A, B en C weergegeven.

Zichtbare koppelingen: gebruik deze instelling om de zichtbaarheid van koppelingen voor niet-beheerders te regelen. U kunt een van de volgende waarden selecteren om het type koppelingen te bepalen dat niet-beheerders kunnen zien op het tabblad Gekoppelde records:

Weergegeven als	Omschrijving
Alle koppelingen	Niet-beheerders kunnen alle koppelingstypen zien
Raadpleeg en zie ook	Niet-beheerders kunnen alleen koppelingen zien van het type Raadpleeg en Zie ook
Geen	Niet-beheerders kunnen geen koppelingen zien

Notitie

Beheerders kunnen standaard alle koppelingen zien.
Per ontwerp wordt de configuratie Melding over gekoppelde record uitgeschakeld als u de waarde voor koppelingszichtbaarheid voor niet-beheerders instelt op Geen.

Melding over gekoppelde record: gebruik deze instelling om de weergave van meldingen te bepalen en de voorkeur in te stellen voor meldingen over gekoppelde records voor niet-beheerders. Als u meldingen inschakelt, verschijnt er een bericht in elk patiëntendossier dat is ingesteld om zichtbare koppelingen weer te geven.

U kunt een van de volgende waarden selecteren voor het weergeven van meldingen over gekoppelde records:

Weergegeven als	Omschrijving
Standaardmeldingstekst	De standaardmeldingstekst geeft het volgende bericht weer aan niet-beheerders - "Deze patiëntrecord is gekoppeld aan andere records. Zoek de gerelateerde records op het tabblad Gekoppelde records' en verschaft een koppeling naar het tabblad Gekoppelde records.
Aangepast meldingsbericht	Gebruik een aangepast meldingsbericht dat u wilt weergeven aan niet-beheerders.
Melding over gekoppelde records niet weergeven	Niet-beheerders krijgen geen gekoppelde recordmeldingen te zien.

Beheerweergave

Beheerders hebben een iets andere gebruikerservaring dan andere gebruikers. Beheerders hebben leesrechten voor de entiteit Controleoverzicht. Zij zien een iets andere weergave voor patiëntkoppelingen die het koppelingstype en alle koppelingen in één tabel bevat.

Notitie

Systeembeheerders krijgen geen meldingen over gekoppelde records te zien.

Beheerders kunnen ook omleiding in- en uitschakelen vanuit inactieve records via de Lintknop voor omleidingsopdracht uitschakelen.

Weergavenaam voor koppelingstypen

Beheerders kunnen de weergavenaam wijzigen voor koppelingstypen. Deze weergavenaam is alleen voor hen zichtbaar.

Navigeer naar het formulier Codeable concept voor het koppelingstype.
Wijzig het veld Tekst om de tekst te gebruiken die u wilt weergeven.

Belangrijk

Wijzig de velden Type en Code niet.

Alleen beheerders kunnen de knopinfo zien waarmee de koppelingstypen worden uitgelegd. Met de weergavenaam (het veld Tekst) wordt de knopinfo bepaald. Tekst van knopinfo wordt alleen weergegeven voor de volgende namen (hoofdlettergevoelig). Standaardnamen zijn in cursief (de overige zijn gebaseerd op de FHIR-standaard).

Weergavenaam (veld Tekst)	Tekst van knopinfo
Zie ook, Raadpleeg	Brengt een koppeling tot stand met een geldige patiëntrecord die aanvullende informatie over de patiënt bevat
Primair, Vervangen door	Brengt een koppeling tot stand met de primaire actieve record voor deze patiënt
Inactief, Vervangt	Brengt een koppeling tot stand met een inactieve patiëntrecord die niet moet worden gebruikt

Het besturingselement voor kaartweergave configureren

U kunt het besturingselement voor kaartweergave aan een subraster toevoegen. De eigenschappen van de weergave die aan het subraster is gekoppeld, sturen de volgende kenmerken aan in de kaartweergave:

Titel van het besturingselement
Sorteervolgorde en filter voor de weergegeven records
Velden die op elke kaart worden weergegeven en hun volgorde (overeenkomend met de eerste drie kolommen van de weergave en hun volgorde)

Het maximale aantal getoonde kaarten komt overeen met de eigenschap Aantal rijen voor het subraster.

U kunt ook de volgende eigenschappen configureren voor het besturingselement voor kaartweergave:

Formulier-id: de unieke id van het dialoogvenster voor het modale formulier dat wordt geopend bij selectie van een kaart.
Aangepaste kleur (optioneel): een hexadecimale code voor de kleur van de pictogramachtergrond en de kaartstroken. Indien leeg, wordt de kleur standaard ingesteld op de vooraf gedefinieerde entiteitskleur.
URL van pictogrambron (relatief) (optioneel): Een aangepast pictogram voor de koptekst van het besturingselement. Deze waarde zou het relatieve pad moeten zijn van de te gebruiken SVG-webresource. Indien leeg, wordt het pictogram standaard ingesteld op het vooraf gedefinieerde entiteitspictogram. Als er geen vooraf gedefinieerd entiteitspictogram is, wordt standaard een generiek pictogram gebruikt.
Dialoogpositie (optioneel): geeft aan of het dialoogvenster naar de zijkant of het midden wordt geopend. Indien leeg, wordt standaard de zijkant gebruikt als positie voor het dialoogvenster.
Breedte dialoogvensterformulier (optioneel) en Breedte-eenheid dialoogvenster (optioneel): de breedte van het dialoogvensterformulier en de eenheid voor de breedte hiervan (pixels of percentage van schermbreedte).

Besturingselement voor momentopname patiënt voor patiëntformulier (preview)

Belangrijk

Dit is een preview-functie.
Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Het besturingselement voor een momentopname van de patiënt biedt een algemeen overzicht van de patiëntinformatie. De native Dynamics 365-tools, zoals snelle-weergaveformulieren die als basis dienen voor het gegevensmodel van het besturingselement, zijn de drijvende kracht achter de aanpassing. Momentopname van patiënt ondersteunt momenteel verschillende soorten veldgegevenstypen. Deze gegevenstypen omvatten telefoon, e-mailadres, datum/tijd, zoekopdracht, berekende velden en subrasters voor gerelateerde entiteiten voor veel-op-een en veel-op-veel relaties.

Besturingselement voor momentopname van een patiënt in het patiëntformulier

Maak een snelle-weergaveformulier om het besturingselement voor momentopname van een patiënt te configureren dat u aan uw app gaat toevoegen. Ga voor stappen om het snelle-weergaveformulier te configureren naar Snelle-weergaveformulier voor momentopname van patiënt configureren.
Open het contactpersoonformulier waaraan u de momentopname voor een patiënt wilt toevoegen.
Maak een ankerveld dat de momentopname van de patiënt gaat gebruiken voor de weergave ervan.
Open het formulier in de klassieke modus en stel het besturingselement voor de momentopname van de patiënt in als standaardbesturingselement voor het weergeven van het ankerveld voor alle vormfactoren van het apparaat.
Geef de volgende invoer op voor het besturingselement voor een momentopname van de patiënt:
- Een sjabloon voor de weergavenaam van de momentopname van de patiënt. Hier kunt u de syntaxis {{LOGICAL_FIELD_NAME}} gebruiken om het besturingselement te dwingen de respectieve velden op te halen uit Dataverse die waarden in de weergavenaam op te nemen.
- De GUID van het snelle-weergaveformulier dat u hebt gemaakt om de weergave van de momentopname van de patiënt te configureren.
- De GUID van de hoofdentiteit om het besturingselement voor een momentopname van de patiënt met gegevens te vullen.
- De laatste wijzigingsdatum van de hoofdentiteit. U kunt het systeemveld met de naam modifiedon gebruiken om te bepalen wanneer de momentopname van de patiënt weer informatie over de entiteit moet ophalen, zelfs zonder een volledige paginavernieuwing.
Sla het formulier op.

In de volgende schermafbeelding wordt een voorbeeld weergegeven van de configuratie voor een patiëntmomentopname:

Een schermopname met een voorbeeld van de configuratie van een momentopname van een patiënt.

Snelle-weergaveformulier voor momentopname van patiënt configureren

Maak een nieuw snelle-weergaveformulier of werk het bestaande snelle-weergaveformulier Configuratie van klinische momentopname van patiënt voor het formulier Patiënt - Klinisch (of het snelle-weergaveformulier Configuratie van administratieve momentopname van patiënt voor het formulier Patiënt - administratief) van de contactpersoonentiteit bij. Noteer de formulier-id van het snelle-weergaveformulier.
Stel de waarde van het tabblad Label in of werk dit bij. Deze waarde wordt weergegeven als de naam van het besturingselement in het formulier. De standaard weergavenaam van het besturingselement is Momentopname van patiënt.
Zoals uitgelegd in Besturingselement voor momentopname van patiënt configureren op het patiëntformulier, kunt u de hoofdkop van het besturingselement instellen in de configuratie van het besturingselement. In de standaardconfiguratie worden in de hoofdkop van het besturingselement de voornaam en achternaam van de patiënt weergegeven.
In de eerste sectie van het formulier worden de subkoptekstvelden van het besturingselement weergegeven en in de hoofdkoptekst worden de eerste drie velden van deze sectie eronder weergegeven. Configureer de velden die u wilt weergeven als onderdeel van de subkop van het formulier (bijvoorbeeld velden zoals Leeftijd, Geslacht en Burgerlijke staat).
U kunt nog twee velden opnemen die in hun eigen afzonderlijke rijen worden weergegeven als onderdeel van de koptekst (bijvoorbeeld geboortedatum en medisch dossiernummer (MRN)).
Notitie
- Elk ander veld dat na het vijfde veld voor deze sectie wordt toegevoegd, wordt niet weergegeven in het besturingselement.
- U kunt het label voor deze velden beheren door de eigenschap Label verbergen van het veld in het snelle-weergaveformulier in of uit te schakelen.
De tweede sectie in het formulier bevat subrasters van entiteiten die aan de patiënt zijn gekoppeld. Deze sectie wordt in het besturingselement weergegeven als een lijst, gescheiden door een pijpsymbool (|). Als de koppeling wordt geselecteerd, worden details van de record weergegeven in het rechterpaneel van het formulier. Configureer de subrasters voor de contactgerelateerde entiteiten die u in het formulier wilt weergeven.

Notitie

Het aantal rijen en de weergave die voor het subraster is geselecteerd, worden gebruikt voor weergave in het besturingselement voor momentopnamen.
In de derde sectie van het formulier worden andere patiëntvelden in het besturingselement voor momentopname weergegeven, met relevante pictogrammen. U kunt configureren dat extra velden (zoals e-mailadres, telefoonnummers en adressen) in de laatste sectie van het besturingselement worden weergegeven.

Beperkingen van het besturingselement

Voor alle records die het besturingselement voor de momentopname van de patiënt moeten weergeven, moet het kenmerk voor de primaire naam zijn ingevuld. Het besturingselement ondersteunt geen aangepaste intersectie-entiteiten zonder een vooraf ingevuld kenmerk voor primaire naam.
Alle subrasterweergaven die het besturingselement momentopname van de patiënt moeten weergeven, moeten het besturingselement voor het primaire naamkenmerk bevatten in hun lijst met velden of kolommen.
Als u dynamische informatie moet opnemen in de kop met de weergavenaam van het besturingselement voor de momentopname van de patiënt, ondersteunt de weergavenaamsjabloon alleen logische veldnamen die rechtstreeks worden gehost door de hoofdentiteit.
Het besturingselement voor een momentopname van de patiënt biedt geen ondersteuning voor het rechtstreeks maken van nieuwe gerelateerde entiteiten vanuit de momentopnameweergave. U ziet een tijdelijke aanduiding voor lege waarden.
Het besturingselement voor een momentopname van de patiënt is ontworpen om te werken in een modelgestuurde app. We kunnen de werking ervan in canvas-apps niet garanderen.
U kunt maximaal drie secties hebben op het tabblad van een snelle-weergaveformulier.
U kunt maximaal vijf besturingselementen in de eerste sectie (koptekst) hebben. Drie van deze besturingselementen vormen de eerste rij (subtitel) in de momentopname van de patiënt.
In andere secties kunt u maximaal 15 besturingselementen hebben.

Zie ook

Wat is Microsoft Cloud for Healthcare?
Geharmoniseerde patiëntweergave gebruiken