Hvad er Fabric Apps (Preview)?

Fabric Apps (preview) hjælper dig med at bygge datadrevne applikationer på Microsoft Fabric ved at kombinere datamodeller, genererede API'er, autentificering og hosting i én udviklingsarbejdsgang. Du definerer dine datamodeller i TypeScript, og Fabric Apps bruger dem til at generere de backend-dele, din app har brug for. Fabric Apps understøtter TypeScript som sprog for datamodeller, klientkode og applikationslogik.

Nøglefunktioner

Fabric Apps tilbyder disse funktioner:

• Datamodeller til API'er – Dekorer TypeScript-klasser med @entity(), @text(), @uuid(), og andre dekoratorer. Fabric Apps genererer automatisk databaseskemaer og GraphQL-endpoints.
• Type-sikre klienter – Client SDK'en validerer forespørgsler og mutationer, før de når backend, og opdager fejl under udviklingen.
• Indbygget autentificering – Sessionsstyring, tokenhåndtering og autentificeringsprocesser er inkluderet. Konfigurér Fabric SSO til deployerede applikationer eller brug e-mail og adgangskode under lokal udvikling.
• Statisk hosting – Byg og server din frontend-applikation sammen med dine backend-API'er med en enkelt deployment-kommando.
• Lokal udvikling – Kør full stack lokalt med Docker for hurtig iteration, og udrul derefter til Microsoft Fabric, når den er klar til produktion. Scaffold-projekter, udvikle med GitHub Copilot og deploye til Fabric ved hjælp af Rayfin CLI.

Forudsætninger

Stofkapacitet

Dit arbejdsområde skal have tildelt Fabric-kapacitet. Når du opretter et nyt arbejdsområde, skal du vælge en Fabric-kapacitet, der skal tilknyttes det. Fabric Apps-tjenester forbruger kapacitetsenheder fra den tildelte kapacitet.

Lejeradministrationsindstillinger

En Fabric-lejeradministrator skal aktivere Fabric Apps-arbejdsbyrden, før brugerne kan oprette elementer.

1. Log ind på Fabric admin-portalen.
2. Gå til Lejerindstillinger.
3. Under Fabric Apps (preview) kan du slå indstillingen til Enabled.
4. Vælg om du vil aktivere for hele organisationen eller specifikke sikkerhedsgrupper.
5. Vælg Anvend.

Ændringer kan tage et par minutter at sprede sig.

Sådan fungerer det

En Fabric-app kører som en managed service i Microsoft Fabric med en suite af tjenester, der definerer backend, såsom app-hosting, database, GraphQL API'er og autentificering. Fabric står for hosting, netværk og skalering. Autentificering bruger udelukkende Fabric SSO (Microsoft Entra ID single sign-on) – ingen andre autentificeringsudbydere er tilgængelige efter udrulning.

Når du deployer din applikation med rayfin up, opretter Fabric child services baseret på din rayfin.yml-konfiguration. Disse børnetjenester vises som børne-elementer under Fabric-appen i Fabric-portalen.

App backend URL

Hver Fabric-app har et enkelt endepunkt, der giver adgang til alle tjenester:

https://<your-app>-app.rayfin.windows.net/

Endepunktet eksponerer en sti for hver service:

Styring i Fabric-portalen

Efter udrulning kan du administrere din Fabric-app direkte i Fabric-portalen.

Se genstandsegenskaber

Åbn Fabric-appen i portalen for at se:

• App Backend URL — Dette endpoint bruges til alle backend-tjenester, som applikationen bruger.
• App URL — Den offentlige URL, hvor dit statiske indhold hostes. Fabric SSO er påkrævet for at få adgang til appen.

Administrer underordnede elementer

Vælg Fabric-appen for at se dens børnetjenester:

• SQL-database i Fabric — Åbner elementet Fabric SQL Database for at se objektudforskeren. Du kan køre læste forespørgsler mod dine data. Skemaændringer bør altid foretages i koden under rayfin/data mappen. Skemakonflikter kan opstå, hvis skemaet ændres direkte i SQL-databasen, og det kan ødelægge appen.

Elementtilladelser

Workspace-roller overgår ikke elementniveau-tilladelser. For at dele en app med nogen i din organisation skal de have tilladelse til at køre og interagere (læse og eksekvere) for at køre appen og starte backend-API'erne.

Lær mere om Workspace-roller.

Udvikling med Rayfin CLI

CLI'en støtter nye projekter, opsender lokal infrastruktur, synkroniserer skemaændringer og deployerer til Fabric. Installer den med npm create @microsoft/rayfin@latest.

Nøglekommandoer:

For en komplet kommandoreference, se CLI-reference.

Datamodel-dekoratorer

Definér datamodeller ved hjælp af TypeScript-dekoratorer:

import {
  entity,
  role,
  text,
  boolean,
  date,
  uuid,
} from '@microsoft/rayfin-core';

@entity()
@role('authenticated', '*', {
  policy: (claims, item) => claims.sub.eq(item.user_id),
})
export class Todo {
  @uuid() id!: string;
  @text({ min: 1, max: 100 }) title!: string;
  @boolean() isCompleted!: boolean;
  @date() createdAt!: Date;
  @date({ optional: true }) dueDate?: Date;
  @text() user_id!: string;
}

Fabric Apps analyserer disse dekoratører og genererer:

• Databasetabeldefinitioner
• GraphQL API-endepunkter
• Række-niveau autorisationsregler
• Type-sikre klientmetoder

Hvornår skal man bruge Fabric Apps

Fabric Apps er ideelt til:

• Hurtig prototyping – Gå fra idé til live URL på få minutter med forudkonfigureret infrastruktur.
• Interne værktøjer og dashboards – Byg autentificerede admin-grænseflader uden at skrive backend-standardløsninger.
• Dataudforskning og visualisering – Forespørg Fabric data via GraphQL og vis dem i brugerdefinerede frontends.
• AI og agentapplikationer – Leverer strukturerede backend-tjenester til AI-agenter, der har brug for vedvarende tilstand.

Fabric Apps er måske ikke egnede til:

• Applikationer, der kræver komplekse flertrinstransaktioner eller lagrede procedurer.
• Apps, der kræver brugerdefinerede autentificeringsudbydere ud over Fabric SSO og e-mail/adgangskode.

Sikkerhedsansvar

Fabric tilbyder: Fabric Single Sign on (Microsoft Entra ID), række-niveau sikkerhed via @role decorators, HTTPS, PKCE samt arbejdsområde- og objektniveau-tilladelser.

Du er ansvarlig for:

• At holde hemmeligheder, API-nøgler og følsomme data ude af din kode, frontend-assets og repository. Statisk indhold leveres fra en offentlig URL.
• Det, din app eksponerer gennem Fabric SSO, styrer login, da din kode styrer, hvad autentificerede brugere ser og gør.
• Kun de tilladelser, bidragydere har brug for til at udrulle eller administrere appen.
• Juridisk og overholdelsesmæssig ansvarlighed for de data, din app indsamler, behandler og gemmer.

Næste trin

• Opret dit første Fabric Apps-projekt
• Definér datamodeller med dekoratorer
• Udrul til Microsoft Fabric
• Konfigurer godkendelse