Del via

Oversigt over tilbageskrivning til Dataverse healthcare API'er

  • Artikel

Dataverse healthcare upsert-API gør det nemmere at indtage data om FHIR (Fast Healthcare Interoperability Resources) i Dataverse. Når dataene er tilgængelige i Dataverse, kan brugerne opdatere de nye poster, f.eks. opdatere patienters demografiske oplysninger. Tilbageskrivningsløsningen Dataverse healthcare API'er gør det muligt at skrive disse ændringer tilbage til den oprindelige FHIR-server.

Løsningen tilbyder visse udvidelsesmuligheder for tilbageførselsprocessen. Konfigurationen af tilbageførslen kan også målrettes mod en slutpunkt, hvis brugere skal tilpasse den brugerdefinerede logik til denne proces. En brugerdefineret Azure Logic App kan f.eks. målrettes mod den udgående meddelelse, der udfører yderligere behandling eller routing. Dette alternative udgående slutpunkt skal understøtte godkendelse via OAuth 2.0 ved hjælp af et klient-id og en klienthemmelighed.

Følgende flowdiagram viser den generelle tilbageskrivningsproces:

Et diagram, der viser oversigten over tilbageførselsprocessen.

Standardbehandlingstrinnene er følgende:

  1. Du opdaterer en post i Dataverse​.
  2. Dataverse evaluerer ændringen og opretter en ny FHIR-ressource, der er sendt til FHIR API-slutpunkt.
  3. FHIR-slutpunktet behandler FHIR-ressourcen og returnerer svaret for driftsresultatet til Dataverse​.
  4. Dataverse logfører driftsresultaterne i dataintegrationsværktøjssættets logfiler. Du administrator gennemgå eventuelle fejl her.

Hvis det er muligt at udvide, kan du angive en alternativ tilgang til tilbageskrivning, hvis det er nødvendigt.

  1. Dataverse sender FHIR-ressourceanmodningen til det definerede slutpunkt.
  2. Det definerede slutpunkt er ansvarlig for at behandle den indsendte FHIR-ressource og sende den til FHIR API.
  3. Du er ansvarlig for logføring af eventuelle driftsfejl, så administratoren kan gennemse eventuelle fejl, mens der sendes data til det brugerdefinerede slutpunkt.

Bemærk

I den aktuelle version af Dataverse Healthcare-API'er og tilbageførselsprocessen antager, at en FHIR-tjeneste er tilgængelig til oprettelse og validering af den udgående FHIR-ressource. Denne konfiguration kræves, både hvis du skal skrive direkte til FHIR-tjenesten eller et alternativt udgående slutpunkt. Den sikrer integriteten af den udgående FHIR-ressource, når der indtræffer en tilbageførselshændelse. Denne konfiguration er testet og valideret i forhold til en FHIR-tjenesten Azure Health Data Services.

Der sendes også en post af typen FHIR-oprindelse til FHIR-slutpunktet, når tilbageførselshændelsen er behandlet. Oprindelsesressourcen sporer oplysninger om den aktivitet, der har oprettet, revideret, slettet eller signeret en version af en ressource. I artiklen beskrives også de involverede objekter og medarbejdere. Du kan bruge disse oplysninger til at danne dig en vurdering af kvaliteten, pålideligheden og troværdigheden. De indeholder også retningslinjer for, hvor du kan gå hen for yderligere at undersøge ressourcens oprindelse og oplysningerne i den.

Du kan finde flere oplysninger om FHIR-oprindelse ved at gå til Oprindelse af FHIR-ressource.

Aktivér tilbageskrivning

Processen til aktivering af tilbageførsel omfatter følgende tre primære trin:

  1. Angive detaljer om forbindelse
  2. Opdatere tilknytninger af objekt
  3. Anvende patientsamtykke

Angive detaljer om forbindelse

Angiv oplysninger om forbindelsen for det FHIR-slutpunkt, der modtager de indsendte FHIR-ressourcer. Du kan finde disse konfigurationsværdier i sektionens dataintegrationsværktøjssættets integrationsindstillinger.

Du kan finde flere oplysninger om disse indstillinger under Konfigurere integrationsindstillinger.

Opdatere tilknytninger af objekt

Når du har leveret oplysninger om forbindelsen, skal du som det næste opdatere de objekttilknytninger, der styrer, hvilke FHIR-ressourcer der skal deltage i tilbageførselsprocessen.

Tilbageførsels-plug-ins bruger de samme objekttilknytninger, der er konfigureret til upsert-API'en. De enkelte objekttilknytningen kan indeholde en attribut med titlen Aktivér tilbageførsels til FHIR. Når denne attributværdi angives til Ja, sender tilbageførsels-plug-ins opdateringer for den valgte Dataverse-tabel til FHIR-slutpunktet. Denne proces gør det muligt at få detaljeret tabelspecifik kontrol over, hvilke data der skal skrives tilbage til FHIR-slutpunktet.

Når du har aktiveret tilbageskrivning for objekttilknytningen, kan administratoren vælge, hvilke hændelser der udløser tilbageførslen, angivet af feltet Understøttede meddelelser. Tilbageførselsløsningen understøtter i øjeblikket meddelelser om oprettelse og opdatering.

Du kan finde flere oplysninger om, hvordan du konfigurerer objekttilknytninger ved at gå til Konfiguration af objekttilknytninger.

Patientressourcer inkluderer en ekstra konfigurationsindstilling for tilbageskrivning. Den person, der bruger programmet, kan vælge at acceptere eller afvise, at deres data opdateres i Dataverse-programmet. Attributten Azure FHIR-synkroniseringsaktiveret gemmer dette samtykke for hver patient.

Et skærmbillede, der viser attributten for samtykke af tilbageførsel for en eksempelpatient.

Når værdien for attributten Azure FHIR-synkroniseringsaktiveret angives til Ja og Patientobjekttilknytningen er konfigureret for tilbageskrivning, sendes eventuelle ændringer af de tilknyttede attributter til FHIR-slutpunktet. Ellers ignorerer tilbageførsels-plug-ins ændringerne i patientposten.

Almindelige advarsler og fejlscenarier

Advarsler og undtagelser, der kan forekomme under tilbageførselsprocessen, logføres i logfilerne for dataintegrationsværktøjssættet. Du kan finde flere oplysninger om loggene i Gennemse Dataverse Healthcare API-logfiler.

Ugyldige konfigurationsindstillinger

Hvis oplysningerne om forbindelsen i sektionen med integrationsindstillinger ikke er korrekte, logføres der en undtagelse i skriveprocessen, og behandlingen stoppes. Værdierne Program-/klient-id eller Klienthemmelighed kan f.eks. være forkert.

Meddelelse behandlet med advarsler

Du kan få vist visse advarsler eller oplysningsmeddelelser fra FHIR-slutpunktet, selvom anmodningen om tilbageslag behandles korrekt. Logfilerne underordnet for denne advarsel indeholder flere oplysninger, som administratorer kan gennemse.

Fejl i FHIR-oprindelse

Alle undtagelser, der er relateret til oprettelse af posten FHIR-oprindelse, logføres med en generel undtagelse sammen med de detaljer, der returneres af FHIR-slutpunktet.

Påkrævede attributter mangler

Behandlingen af tilbageførslen for udvidelsestilknytninger kræver en reference til den overordnede post. Hvis værdien for den overordnede linkattribut mangler, logføres der en undtagelse i tilbageførselsprocessen, og behandlingen stoppes.

Ugyldig kontakttype

I forbindelse med kontaktposter i Dataverse skal du angive indikatoren for Kontakttype korrekt, for at skrivning kan lykkes. Du skal f.eks. angive den til enten Patient eller Behandler. Hvis denne værdi ikke er til stede, logføres der en undtagelse i tilbageførselsprocessen, og behandlingen stoppes.

Begrænsninger

Der er i øjeblikket følgende begrænsninger for tilbageførselsløsningen:

  • Udgående formatering: Tilbageførselsløsningen understøtter ikke udgående formatering. Processen sender i øjeblikket den FHIR-ressource, der repræsenterer ændringerne for den opdaterede FHIR-ressource i Dataverse.
  • Godkendelse: Den løsning, der skal tilbageskrives, understøtter i øjeblikket kun afsendelse til slutpunkter, der bruger OAuth-godkendelse.