Nøglebegreber og funktioner

Værktøjspakken til udvidelsesmuligheder introducerer en række funktioner, der er designet til at bringe dit dataprogram til strukturen så enkelt som muligt. Disse funktioner gør det muligt for udviklere at bygge omfattende, integrerede oplevelser med minimal indsats. Med Extensibility Toolkit kan du nemt få adgang til Fabric-API'er direkte fra frontend, bevare elementdefinitionen (tilstanden) i Fabric, bruge et standardiseret elementoprettelsesflow og drage fordel af forbedret sikkerhed og interoperabilitet via iFrame-lempelse og offentlig API-understøttelse. Derudover strømliner det din udviklingslivscyklus med indbygget CI/CD-understøttelse, hvilket gør det nemmere at automatisere implementering og test. De følgende afsnit indeholder en oversigt over de vigtigste funktioner og vejledning i, hvordan du inkorporerer dem i dine arbejdsbelastninger.

Standardoplevelse for oprettelse af genstande

Elementoprettelsen standardiseres via et dedikeret Fabric-kontrolelement, der guider brugerne gennem processen. Dette kontrolelement giver brugerne mulighed for at vælge det arbejdsområde, hvor elementet oprettes, tildele følsomhedsmærkater og konfigurere andre relevante indstillinger. Ved at bruge denne standardiserede oplevelse behøver du ikke længere selv at håndtere kompleksiteten ved at oprette genstande eller bekymre dig om fremtidige ændringer i processen. Derudover gør denne fremgangsmåde det muligt at få vist elementoprettelse direkte på din arbejdsbelastningsside, hvilket giver en problemfri og integreret brugeroplevelse.

Brug vejledningen Sådan opretter du et element til at forstå, hvordan det kan implementeres.

Understøttelse af Frontend API

Med Extensibility Toolkit kan du få et Microsoft Entra On-Behalf-Of-token (OBO) direkte i dit frontend-program, hvilket giver sikker adgang til enhver Entra-beskyttet API. Denne funktion giver dig mulighed for at integrere dybt med Microsoft Fabric-tjenester – du kan f.eks. læse og gemme data i OneLake, oprette og interagere med andre Fabric-elementer eller bruge Spark som et behandlingsprogram via Livey-API'erne. Du kan få flere oplysninger i Microsoft Entra-dokumentationen, OneLake-dokumentationen, Fabric REST API'er og Spark i Fabric.

Brug vejledningen Sådan anskaffer du Microsoft Entra Token til at forstå, hvordan den kan implementeres. Brug også vejledningen Sådan får du adgang til Fabric API'er til at forstå, hvordan du kan interagere med Fabric.

Lagring af elementdefinition (tilstand) i Fabric

Denne funktion giver dig mulighed for at gemme elementets metadata – f.eks. elementkonfiguration og andre relevante oplysninger – direkte i OneLake i en skjult mappe, der ikke er synlig for slutbrugerne. Dataene gemmes i det samme format, der anvendes af offentlige API'er og CI/CD-processer, hvilket sikrer konsistens og interoperabilitet på tværs af forskellige integrationspunkter. Detaljer om formatet og dets brug med offentlige API'er og CI/CD beskrives i de følgende afsnit.

Brug definitionen Sådan opbevares vare til at forstå, hvordan den kan implementeres.

Hvad skal man gemme i definitionen

Tænk på tilstanden som noget, der indeholder alle de oplysninger, der er nødvendige for at gendanne et element, hvis det slettes eller kopieres et andet sted. Dette omfatter ikke selve dataene, som er gemt i OneLake (se Lagring af elementdata i OneLake).

Her er nogle praktiske eksempler:

• Notebook-element: Tilstanden gemmer notesbogens kode, cellerækkefølge og metadata, f.eks. hvilket udførelsesprogram (f.eks. Spark, SQL) der skal bruges. De faktiske data, der behandles af notesbogen, gemmes ikke i tilstanden.
• Arkivredigeringsemne: Tilstanden gemmer ikke selve arkivindholdet, men gemmer i stedet redigeringskonfigurationen – f.eks. farveskema, indstillinger til autofuldførelse, skriftstørrelse og andre brugerindstillinger.
• Installations- eller orkestreringselement: Hvis dit element installerer eller klargør andre komponenter (f.eks. databaser eller beregningsressourcer), skal tilstanden indeholde referencer (id'er, URI'er) til de elementer, den har oprettet. Dette giver din arbejdsbelastning mulighed for at kontrollere deres tilstand eller administrere dem senere.

Ved at fokusere på konfiguration, metadata og referencer sikrer du, at dit elements tilstand er bærbar, let og nem at gendanne eller overføre.

Lagring af varedata i OneLake

Hvert element kommer med sin egen Onelake-elementmappe, hvor udviklere kan gemme strukturerede såvel som ustrukturerede data. I lighed med et Lakehouse har elementet en tabelmappe, hvor data kan gemmes i Delta- eller Iceberg-format, og en filmappe, hvor ustrukturerede data kan gemmes.

Brug Sådan gemmes data i Element til at forstå, hvordan det kan implementeres.

Genvejsdata

Som hvert element har, sin egen Onelake-mappe de kan også arbejde med genveje. Over Public Shortcut API-arbejdsbelastningsudviklere kan oprette forskellige genvejstyper fra eller ind i deres element for at deltage i løftet om en enkelt kopi fra OneLake.

Brug genvejen Sådan opretter du for at forstå, hvordan den kan implementeres.

Understøttelse af CRUD-vare-API

Brugere kan oprette, opdatere og slette elementer med indhold ved hjælp af standard-Fabric Item Rest API'er. Denne automatiske aktivering gør det meget nemmere at integrere med arbejdsbelastningselementer på samme måde som kerneelementer i Fabric, strømliner interoperabilitet og reducerer den indsats, der kræves for at opbygge robuste integrationer.

CI/CD-understøttelse

Notat

CI/CD-understøttelse af Extensibility Toolkit er i øjeblikket under udvikling. De funktioner, der beskrives nedenfor, er planlagte kapaciteter og kan ændres før udgivelsen.

CI/CD-understøttelse af alle varer er en af de højeste anmodninger fra kunderne. Med denne funktion kan alle elementer deltage i CICD ud af æsken uden behov for at implementere nogen specifik logik eller operationer. Det betyder, at du kan automatisere implementering, test og opdateringer af dine arbejdsbelastninger ved hjælp af standard Azure Pipelines og værktøjer. Elementformatet og API'erne er designet til at være fuldt kompatible med CI/CD-processer, hvilket sikrer en ensartet og pålidelig oplevelse på tværs af miljøer. Du kan finde flere oplysninger om integration med CI/CD i Fabric CICD-dokumentationen.

Item CRUD-meddelelses-API

Notat

CRUD-notifikations-API-understøttelse for Extensibility Toolkit er i øjeblikket under udvikling. De funktioner, der beskrives nedenfor, er planlagte kapaciteter og kan ændres før udgivelsen.

Der er tilfælde, hvor din arbejdsbyrde skal deltage i Item CRUD-hændelser. Da elementer oprettes på platformen direkte via UX,har offentlige API'er eller CI/CD-arbejdsbelastningsejere ikke kontrol, når der oprettes et nyt element over disse indgangspunkter. Som standard gemmer varer deres tilstand i Fabric og behøver ikke at blive informeret om ændringen af deres vare. Ikke desto mindre er der nogle tilfælde, hvor arbejdsbelastninger har behov for at deltage i CRUD-flowet. Dette er hovedsageligt tilfældet, hvis infrastruktur for elementer skal klargøres eller konfigureres (f.eks. databaser). I disse scenarier giver vi partnere mulighed for at implementere en Crud-meddelelses-API, som Fabric kalder på hver hændelse. I dette scenarie skal arbejdsbelastningsudvikleren sørge for, at deres API kan nås, da ellers mislykkes strukturhandlinger.

Stof-planlægning

Notat

Fabric scheduler-understøttelse til Extensibility Toolkit er i øjeblikket under udvikling. De funktioner, der beskrives nedenfor, er planlagte kapaciteter og kan ændres før udgivelsen.

Fabric understøtter jobplanlægning for arbejdsbelastninger. Denne funktion giver udviklere mulighed for at oprette arbejdsbelastninger, der får besked, selvom brugeren ikke er foran UX'en, og handle baseret på det job, der skal udføres (f.eks. kopiere data i Onelake). Partnere skal implementere en API og konfigurere deres arbejdsbelastning for at deltage i denne funktionalitet.

iFrame-afslapning

Udviklere kan anmode om flere iFrame-attributter for at muliggøre avancerede scenarier som f.eks. filoverførsler eller åbning af eksterne websteder. Denne funktion gør det muligt for din arbejdsbelastning at bede brugerne om eksplicit samtykke, før de udfører handlinger, der kræver bredere browserfunktioner – f.eks. start af downloads eller forbindelse mellem brugere og eksterne API'er ved hjælp af deres aktuelle Fabric-legitimationsoplysninger. Ved at angive disse krav i din arbejdsbelastningskonfiguration sikrer du, at brugerne er informeret og kan give de nødvendige tilladelser, hvilket muliggør problemfri integration med eksterne systemer, samtidig med at sikkerheden og brugertilliden opretholdes.

Brug Sådan slap du iFrame for at forstå, hvordan den kan implementeres.

Notat

Aktivering af denne funktion kræver, at brugerne giver mere Microsoft Entra-samtykke til lempelsesomfanget ud over det standard Fabric-omfang, der kræves til grundlæggende arbejdsbelastningsfunktionalitet.

Begrænsninger for funktioner

Privat link

Alle arbejdsbelastninger blokeres for forbrug og udvikling, hvis Private Link er aktiveret på lejer- eller arbejdsområdeniveau.