Moderniser ældre applikationer med React-webressourcer og brugerdefinerede API'er til Dataverse

I denne artikel præsenteres et arkitekturmønster til modernisering af ældre programmer ved at kombinere Power Platform med React-webressourcer og brugerdefinerede Dataverse-API'er. Tilgangen bruger standardfunktioner i Power Platform til kernefunktioner i virksomheden og udvider kun programmet med brugerdefineret kode, hvor der kræves specialiserede brugeroplevelser eller komplekse integrationer.

Tip

Denne artikel indeholder et eksempelscenarie og en visuel repræsentation af, hvordan du kombinerer Power Platform, React-webressourcer og brugerdefinerede Dataverse-API'er for at modernisere ældre programmer. Denne løsning er et generelt eksempel på arkitektur, som du kan bruge til mange forskellige scenarier og brancher. Denne artikel er begrænset til bedste praksis.

Arkitekturdiagram

Arkitekturdiagram, der viser en modeldrevet app til Power Platform med en React-webressource, der bruger et Dataverse-plug-in til en brugerdefineret API til at hente hemmeligheder fra Azure Key Vault og kalde en ekstern API.

Workflow

Denne arkitektur bruger Power Platform til standardforretningsfunktioner (trin 1). Et React SPA (single-page-applikation) er integreret for en bestemt komponent, hvor kompleks ekstern API-integration og tilpasset brugergrænseflade er enklere at implementere med TypeScript (trin 2 til 6).

  1. Brugergodkendelse: Brugeren logger på med Microsoft Entra ID og får adgang til den modeldrevne app. Standardmodelbaserede appformularer håndterer oprettelse, redigering og visning af poster. Dataverse administrerer datalager og forretningsregler.

  2. Navigation: Brugeren åbner en specialiseret funktion, f.eks. produktkonfiguration med komplekse beregninger, fra webstedsoversigten for den modeldrevne app. React SPA indlæses som en webressource ved hjælp af den eksisterende Dataverse-session.

    Brugerinteraktion: Brugeren arbejder med den brugerdefinerede brugergrænseflade til dataindtastning eller beregninger.

  3. Brugerdefineret API-kald: React kalder en Dataverse-brugerdefineret API via Xrm.WebApi med et typebestemt anmodningsobjekt.

  4. Logonoplysninger: Den brugerdefinerede API-plug-in henter logonoplysninger fra Azure Key Vault ved hjælp af en administreret identitet.

  5. Eksternt opkald: Den brugerdefinerede API-plug-in transformerer anmodningen, kalder den eksterne tjeneste og transformerer svaret.

  6. Svar og persistens: React modtager det indtastede svar og opdaterer brugergrænsefladen. Resultaterne gemmes i Dataverse, hvis det er nødvendigt.

Komponenter

Arkitekturen kombinerer kernetjenester i Power Platform med brugerdefineret udvikling for at levere brugeroplevelsen og ekstern integration.

Centrale komponenter i Power Platform

Brugerdefineret udvikling

  • React-webressource: SPA bygget med React og TypeScript. Udrullet som statiske filer i Dataverse. Håndterer den komplekse brugergrænseflade og kalder kun brugerdefinerede API'er og aldrig eksterne tjenester direkte. Der kræves ingen ekstern hosting. Programmet nedarver brugersessionen, og filerne pakkes i løsningen til ALM (Application Lifecycle Management).

  • Brugerdefinerede API'er til Dataverse: C#-plug-ins, der håndterer ekstern integration. Bruger et mønster med ét inputobjekt og ét outputobjekt. Plug-ins henter legitimationsoplysninger fra Key Vault, kalder eksterne tjenester og transformerer svar.

  • Azure Key Vault: Gemmer eksterne API-legitimationsoplysninger. Tilgås ved hjælp af administreret identitet for Dataverse-plug-ins, så der gemmes ingen legitimationsoplysninger i kode.

Alternative muligheder

  • Brugerdefineret side eller integreret lærredapp: Lærred-sider med lav kode, der er integreret i modelbaserede apps. Selvom denne fremgangsmåde fungerer godt til enklere integrationer, bliver det svært at fortolke dybt indlejrede JSON i Power Fx.

  • Kodeapp: Code-first React- eller Vue-app, der hostes på Power Platform. Kodeapps kan kalde Dataverse-handlinger og brugerdefinerede API'er. En kodeapp kører dog som sin egen app, så den skal indlejres i den modeldrevne app via en iframe, hvor postkonteksten overføres i URL-adressen. Denne fremgangsmåde understøtter heller ikke Git-integration af Power Platform.

  • Appopbygning i Copilot Cowork (Frontier) og Copilot Studio (preview): AI-baseret appgenerering fra naturligt sprog. Ikke en produktionsmulighed for dette scenarie. Få mere at vide om udvikling af apps med Copilot Cowork og appoprettelse i Copilot Studio.

  • Kodekomponenter: Brugerdefinerede kontrolelementer, der er bundet til formularfelter. Selvom brugerdefinerede kontrolelementer er velegnet til tilpasning på feltniveau, har dette scenarie brug for et komplet program med flere visninger og ikke et enkelt kontrolelement.

  • Ekstern hosting indlejret i Dynamics 365: Host SPA'en eksternt, og integrer den via en iframe. Denne fremgangsmåde tilføjer hostingkompleksitet, CORS-konfiguration og separat autentificering, hvilket er unødvendigt spild, når du kan bruge webressourcer.

  • Generative sider: AI-genererede React-sider, der kører nativt i modeldrevne apps. Generative sider gør det muligt at køre React-kode i en modeldrevet app. Dette scenarie bruger dem dog ikke, fordi sidedata-API'en kun håndterer Dataverse-tabelhandlinger og ikke kan kalde en brugerdefineret API. Connectorunderstøttelse, som er en prøveversion, kan gøre generative sider til en praktisk mulighed. Da serversiden af denne arkitektur forbliver den samme, kan generative sider være omfattet af et opfølgningsmønster.

Der blev valgt en React-webressource, fordi det på det tidspunkt var den nemmeste løsning, der opfyldte alle kravene til denne komponent.

Detaljer om scenariet

Når du moderniserer et eksisterende program, håndterer Power Platform de fleste forretningsmæssige krav, herunder formularer, arbejdsprocesser, rapportering og godkendelser. Specialiserede funktioner kan dog kræve brugerdefinerede integrationer eller en skræddersyet brugeroplevelse.

Udfordring

En specialiseret forretningsfunktion i et ældre program er afhængig af en ekstern API, der returnerer dybt indlejrede JSON-svar med tre eller fire indlejringsniveauer. Forskellige svartyper kræver forskellig behandlingslogik, og brugeroplevelsen passer ikke godt til standardformularer for modeldrevne apps.

Løsning

Brug Power Platform til standardkrav til applikationer:

  • Modeldrevne apps til standardindtastning og navigation af data
  • Power Automate til arbejdsprocesser og meddelelser
  • Dataverse brugerdefinerede API'er til håndtering af ekstern integration på serversiden

Byg en React SPA, og udrul den som en webressource for de komplekse komponenter i brugergrænsefladen.

Hvorfor en React-webressource blev valgt

Brugerdefinerede sider eller integrerede lærredsapps virkede oprindeligt som en god pasform. I dette scenarie stødte teamet dog på udfordringer, da programlogik blev mere kompleks:

  • Det blev svært at parse dybt indlejrede JSON i Power Fx.
  • Fejlhåndteringen blev mere kompleks.
  • Det var ikke praktisk at teste komplekse formler i dette scenarie.
  • Flere udviklere, der arbejder på de samme formler, forårsagede konflikter.

Brugerdefinerede sider eller integrerede lærredsapps kan fungere godt i enklere scenarier, men kravene til denne komponent fik teamet til at vælge en React-webressource. Med denne fremgangsmåde kan du oprette en komplet brugergrænseflade med flere visninger i React og TypeScript, og du kan enhedsteste transformationslogikken. SPA'en kører i den modeldrevne app, genbruger den eksisterende Dataverse-session og kalder den brugerdefinerede API direkte. Webressourcen, den brugerdefinerede API og plug-in'en er alle Dataverse-løsningskomponenter, så de følger ALM-mønsteret for Power Platform. Der kræves ingen yderligere hosting eller godkendelse.

Få mere at vide: Optimer ydeevnen for lærredsapps, der kræver kompleks forretningslogik

Hvornår skal man bruge dette mønster

Brug denne tilgang, når:

  • Eksterne API'er returnerer komplekse indlejrede svar, der er svære at fortolke i Power Fx.
  • Du skal bruge enhedstest til transformationslogik.
  • Kravene til brugergrænsefladen passer ikke til standardformularer eller canvasapps.
  • Du har udviklere, der kan skrive TypeScript og C#.

Brancher, der kan drage fordel af dette mønster:

  • Energi: Udstyrskonfiguration med eksterne prissætningsprogrammer.
  • Produktion: Produktkonfigurationer med komplekse afhængigheder mellem valgmuligheder.
  • Financial Services: Tilbuds- og forslagsberegnere, der kalder eksterne bedømmelsessystemer.
  • Healthcare: Kliniske systemintegrationer med kompleks datamapping.

Når du ikke skal bruge dette mønster

  • Integrationen er ligetil (flad JSON, enkel mapping).
  • Brugerdefinerede sider eller kodekomponenter opfylder kravene.
  • Du har ikke pro-udviklerressourcer til løbende vedligeholdelse.

Overvejelser

Disse overvejelser implementerer søjlerne i Power Platform Well-Architected, et sæt vejledende principper, der forbedrer kvaliteten af en arbejdsbyrde. Få mere at vide i Microsoft Power Platform Well-Architected.

Pålidelighed

  • Fejlhåndtering: Brugerdefinerede API'er returnerer strukturerede fejlobjekter. React-appen viser brugervenlige meddelelser, ikke stack traces.

  • Genforsøgslogik: Plug-ins forsøger igen ved midlertidige fejl med eksponentiel backoff.

  • Uafhængighed: Hvis React-komponenten går i stykker, kan brugerne stadig bruge alle standardmodeldrevne appfunktioner. Den komplekse integration er additiv.

  • Test: Både TypeScript og C# understøtter enhedstest. Test transformationslogik før udrulning.

  • Datakonsistens: Plug-ins bruger Dataverse-transaktioner. Eksterne kald sker, når Dataverse har gemt ændringerne. Idempotency-nøgler forhindrer dublerede handlinger ved genforsøg.

Security

  • Loginoplysninger: Gem ikke loginoplysninger i frontendkoden. Gem dem i Key Vault, og hent dem via plug-ins via administreret identitet.

  • Brugerkontekst: Brugerdefinerede API'er kører som den kaldende bruger. Dataverse-sikkerhedsroller gælder normalt.

  • Ingen direkte eksterne kald: React taler kun til brugerdefinerede API'er. Al ekstern kommunikation går gennem serverkode.

  • Validering: Serverbaseret validering er autoritativ. Validering på klientsiden er kun for UX.

Driftsmæssig ekspertise

  • Versionsstyring: Gem React-appen og plug-in-koden i Git, og brug gennemsyn af pullanmodninger.

  • CI/CD: Brug Azure DevOps eller GitHub Actions til at bygge, teste og udrulle. Brug Dataverse-løsninger til ALM.

  • Miljøer: Brug den samme arkitektur i udvikling, test og prod. Brug miljøvariabler til konfiguration af endpoints.

  • Overvågning: Brug Application Insights til React-telemetri og plug-ins ud over standard-plug-in Trace Logs til serversiden.

Ydeevneeffektivitet

  • Timeout for plug-in: En Dataverse-meddelelseshandling, herunder dens synkrone plug-ins, har en hård grænse på to minutter, og Microsoft anbefaler, at plug-in-udførelsen bevares under to sekunder. Design eksterne kald med denne begrænsning i tankerne.

  • Caching: Cache Key Vault-legitimationsoplysninger under plug-in-udførelse. Cache referencedata, hvor det er relevant.

  • Bundle-størrelse: Minificer React-produktionsbuilds. Brug kodeopdeling til store apps.

  • API-design: Brug enkeltanmodningsmønstre. Undgå for mange kald mellem React og brugerdefinerede API'er.

Optimering af oplevelse

  • Visuel konsistens: Style React-komponenten, så den passer til modeldrevet appudseende (FluentUI).

  • Indlæsningstilstande: Brug tydelige indikatorer under API-kald.

  • Fejlmeddelelser: Angiv handlingsbare meddelelser, når der opstår fejl.

  • Tilgængelighed: React-komponenter følger WCAG (Web Content Accessibility Guidelines).

Næste trin

  • Kontrollér, om brugerdefinerede sider fungerer i dit scenarie, før du forpligter dig til denne fremgangsmåde.
  • Evaluer kodeapps og generative sider. Disse funktioner udvikler sig fortsat, så se den aktuelle dokumentation og køreplanen , før du beslutter dig.
  • Evaluer kodekomponenter, hvis kravet er felt- eller undergitterniveau, ikke en komplet app.
  • Konfigurer Key Vault og API'en, før du starter udviklingen.
  • Design brugerdefinerede API-kontrakter og TypeScript-modeller på forhånd.
  • Planlæg din ALM-strategi for blandede udrulninger med low-code og pro-code.

Bidragydere

Microsoft vedligeholder denne artikel. Følgende bidragydere skrev denne artikel.

Hovedforfattere:

Udvikling af Power Platform:

Azure integration:

Administration af programlivscyklus: