Share via


Partnerintegration til enhedsdatasupport i Administration af pleje (forhåndsversion)

Vigtigt

  • Dette er en forhåndsversion af funktionen.
  • Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Enhedsdatasupport i funktioner til administration af pleje (forhåndsversion) definerer indgående og udgående brugerdefinerede API'er for partnere og kunder, så deres enhedsadministrationstjenester kan integreres uden problemer. API'erne aktiverer følgende funktioner:

  • Du kan oprette en Power Automate-løsning til HTTPS-connectoren og forbruge de brugerdefinerede API'er til at udløse dine Power Automate-flow og indtage dataene i Dataverse.
  • Du kan forbruge de indgående brugerdefinerede API'er til behandling af Power Automate-flowsvar i Dataverse.
  • Du kan forbruge de udgående brugerdefinerede API'er for Dataverse-udløsere.
  • Du kan også konfigurere et Power Automate-flow til at udføre alle relevante handlinger i et partnersystem ved hjælp af Power Automate-connectorer. Hvis du vil udløse Power Automate-flowet, skal du bruge Dataverse-handlingsudløseren. Du kan finde flere oplysninger i Udløse flow med handlinger.

Bemærk

Hvis du vil filtrere de brugerdefinerede API'er, mens du bruger en handlingsudløser, skal du vælge Enhedsadministration for Katalog og Udgående partnerintegration til enhedsadministration for Kategori.

Et skærmbillede, der viser den brugerdefinerede API-filtrering.

Følgende udgående API'er definerer udløseren for hver proces:

Procesnavn Dataverse-udløser Udgående brugerdefineret API API-beskrivelse
Tilmelde en patient Vælg Tilmeld nu Opret udgående enhedstilmelding Udløser Power Automate-flowet til oprettelse af en patientprofil i partnersystemet
Afslut tilmelding for en patient Vælg Afslut tilmelding Slet udgående enhedstilmelding Udløser Power Automate-flowet til sletning af en patientprofil i partnersystemet
Synkroniser enheder med en enhedsleverandørs system Vælg Synkroniser enheder Udgående synkroniser enheder Udløser Power Automate-flowet til hentning af enhedsdata til partnersystemet
Tildel en enhed til en patient Vælg Tildel enhed Tildel udgående enhed Udløser Power Automate-flowet til tildeling af en enhed til en patient
Fjern tildeling af en enhed fra en patient Vælg Fjern tildeling af enhed Fjern tildeling af udgående enhed Udløser Power Automate-flowet til fjernelse af tilknytning mellem en enhed og en patient

Når et Power Automate-flow fuldfører alle nødvendige handlinger, sender det et svar på en indgående brugerdefineret API via Dataverse-connectorens ikke-bundne handling. Den indgående brugerdefinerede API behandler svaret i Dataverse.

I følgende diagram illustreres det, hvordan flowet sender responset på en ubundet handling i et vellykket scenario.

Et skærmbillede, der viser det svar, der er sendt til en ikke-bundet handling i et vellykket scenarie.

Den indgående API for hver proces definerer følgende:

Procesnavn Indgående brugerdefineret API API-beskrivelse Tilsvarende udgående brugerdefineret API
Tilmelde en patient Opret indgående enhedstilmelding Behandler det svar, der oprettes, når der oprettes en patientprofil i partnersystemet Opret udgående enhedstilmelding
Afslut tilmelding for en patient Slet indgående enhedstilmelding Behandler det svar, der oprettes, når der slettes en patientprofil i partnersystemet Slet udgående enhedstilmelding
Synkroniser enheder med en enhedsleverandørs system Indgående synkroniser enheder Behandler det svar, der oprettes under synkronisering af enheder fra partnersystemet til Dataverse Udgående synkroniser enheder
Tildel en enhed til en patient Tildel indgående enhed Behandler det svar, der oprettes, når en enhed tildeles til en patient i partnersystemet Tildel udgående enhed
Fjern tildeling af en enhed fra en patient Fjern tildeling af indgående enhed Behandler det svar, der oprettes, når tildeling af en enhed fjernes fra en patient i partnersystemet Fjern tildeling af udgående enhed

De brugerdefinerede API'er integrerer enhedsleverandørerne. Følgende API-parametre angiver den generiske datakontrakt for alle leverandører:

Parameter Type Beskrivelse
Statuskode Integer Status for handlingen
Fejlmeddelelse Streng Fejlmeddelelse(r) for en mislykket handling
Udgående anmodning Streng Udgående forespørgsel, der sendes til Power Automate-flowet (for den tilsvarende udgående API-anmodningsparameter)
URL-adresse for flow Streng URL-adresse til kørselsoversigten for et Power Automate-flow

Flowet Hent enheder skal bruge endnu en parameter Indhold ud over de fire viste parametre.

Parameter Type Beskrivelse
Indhold Streng Liste over enheder, der er angivet i følgende JSON-format

Format:

{
  "ResponseFormat": "<Format in which the responses are bundled>",
  "Devices": [
    {
      "Name": "<Device name>",
      "Model": "<Device model>",
      "SerialNumber": "<Device's unique serial number>"
    }
  ]
}

Eksempel:

{
  "ResponseFormat": "default",
  "Devices": [
    {
      "Name": "Device 1",
      "Model": "Thermometer",
      "SerialNumber": "AutomatedTIP1"
    },
    {
      "Name": "Device 2",
      "Model": "Weighing machine",
      "SerialNumber": "AutomatedTIP2"
    }
  ]
}

I følgende diagram illustreres det, hvordan flowet sender responset på en ubundet handling i et ikke vellykket scenario.

Et skærmbillede, der viser det svar, der er sendt til en ikke-bundet handling i et mislykket scenarie.

I forbindelse med alle de processer, der er anført i denne artikel, initierer brugerudløserne handlingsrækken fra Dataverse til enhedens leverandør og tilbage igen. Du kan se meddelelser om fuldførelser eller fejl i programmet. Når siden er opdateret, kan du også se den opdaterede brugergrænseflade for en vellykket handling.

Forudsætninger for integration uden Microsoft-partnere

For brugere, der integrerer funktioner uden Microsoft-partnere, skal du have følgende konfiguration på plads:

  1. To private slutpunkter, der opretter forbindelse til din Azure-lejer. Den slutpunkt til Azure Key Vault, og den anden er til Azure Event Hubs-tjenesten. Det anbefales, at du installerer de private slutpunkter på et virtuelt netværk for at øge sikkerheden.

  2. En app med flere lejere til afsendelse af de sendte enhedsdata til din Azure-lejer. Du skal angive det tilsvarende program-id i din Azure-lejer. Ved hjælp af denne programregistrering godkendes også adgangen til nøgleboksen fra det private slutpunkt.

  3. De Power Automate-flow, der er angivet i afsnittet Partnerintegration, hvor de nævnte udløsere bruges. Brug de angivne indgående brugerdefinerede API'er til at behandle svarene i Dataverse.

Bemærk

Hvis du tester uden en enhedsleverandør, skal du konfigurere Power Automate-flowene uden trinnene til partnerintegration.

Se også

Hvad er Microsoft Cloud for Healthcare?
Konfigurere enhedsdatasupport (forhåndsversion)
Oprette eksempeldata til enhedsdatasupport (forhåndsversion)
Foretage fejlfinding af enhedsdatasupport (forhåndsversion)
Bruge enhedsdatasupport (forhåndsversion)