Del via

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

  • Artikel

[Denne artikel er til dokumentationen til den foreløbige udgivelse. Der kan forekomme ændringer.]

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

  • Opret en Power Automate-løsning med din HTTPS-connector, og opbrug de brugerdefinerede API'er for at udløse Power Automate-flows og indtage data til Dataverse.
  • Forbruger de indgående brugerdefinerede API'er til behandling af Power Automate flowsvar i Dataverse.
  • Forbrug de udgående brugerdefinerede API'er til Dataverse-udløsere.
  • Konfigurer et Power Automate flow til at udføre alle relevante handlinger i et partnersystem ved hjælp af Power Automate forbindelser. 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 flowet Power Automate er fuldfører alle nødvendige handlinger, sender det et svar til en indgående brugerdefineret API via Dataverse-connectors ubundne 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.

I følgende tabel defineres den indgående API for hver proces:

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

Følgende API-parametre angiver den generiske datakontrakt for alle enhedsleverandører:

Parameter Type Beskrivelse
Statuskode Heltal Status for handlingen
Fejlmeddelelse Streng Fejlmeddelelser 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 til Indhold sammen med 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 multifunktionsapp 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.