Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Fabric Apps is gebouwd op de Rayfin SDK en stelt ontwikkelaars in staat om datagedreven applicaties op Fabric te maken met behulp van een uniforme ontwikkelworkflow. Ontwikkelaars definiëren gegevensmodellen in TypeScript en Fabric Apps automatisch API's genereert, verificatie afhandelt, hosting biedt en integreert met Fabric-services. Fabric Apps ondersteunt TypeScript voor gegevensmodellen, clientcode en toepassingslogica. Meer informatie vindt u in het overzicht van de Rayfin SDK.
Belangrijkste kenmerken
Fabric Apps biedt deze mogelijkheden:
-
Datamodellen naar API's – Decoreer TypeScript-klassen met
@entity(),@text(),@uuid(), en andere decorators. Fabric Apps genereert automatisch databaseschema's en GraphQL-eindpunten. - Server-side functies - Voer TypeScript-logica uit op de server en roep deze aan vanaf je frontend via de getypeerde client. Krijg toegang tot app-gegevens, werk met geheimen en roep externe API's aan. Zie Functies gebruiken in Fabric-apps.
- Breng je eigen data mee met connectors - Voeg getypte toegang toe tot een bestaande lakehouse, warehouse, SQL-database in Fabric of semantisch model. Ondersteunde bewerkingen hangen af van de connector. Zie Connect Fabric Apps to Fabric data.
- Bestandsopslag - Definieer getypeerde mappen, beheer toegang met geauthenticeerde beleidsregels, en upload, download, geef bestanden weer en verwijder bestanden in Fabric. Zie Bestanden opslaan en beheren.
- Type-safe clients – De client SDK valideert queries en mutaties voordat ze de backend bereiken, en ontdekt fouten tijdens de ontwikkeling.
- Ingebouwde authenticatie – Sessiebeheer, tokenafhandeling en authenticatieflows zijn inbegrepen. Configureer Fabric SSO voor geïmplementeerde toepassingen of gebruik een e-mailadres en wachtwoord tijdens lokale ontwikkeling.
- Statische hosting – Bouw en serveer je frontend-applicatie naast je backend-API's. Toegang tot Fabric-items vereisen of anonieme toegang tot gehoste resources toestaan.
- Ontwikkelworkflow - Scaffold-projecten, ontwikkel met GitHub Copilot of andere codeeragenten, en deploy naar Fabric met behulp van de Rayfin CLI. Gebruik Fabric-ondersteunde services tijdens de ontwikkeling of Docker voor ondersteunde lokale diensten. Bestandsopslag maakt gebruik van Fabric-opslag zowel bij ontwikkeling als implementatie.
Ondersteunde regio's
Zie Fabric regiobeschikbaarheid voor regiobeschikbaarheid.
Prerequisites
Licentie en werkruimte
Werkruimtevereisten hangen af van de licentieoptie van uw app:
- Wijs voor een capaciteitsondersteunde app Fabric-capaciteit of een actieve Fabric-proefcapaciteit toe aan de workspace. App-diensten verbruiken capaciteitseenheden uit die capaciteit.
- Voor de Power BI Pro-ervaring, gebruik een Pro-werkruimte. Je hoeft geen Fabric-capaciteit toe te wijzen. De limieten van Power BI Pro zijn van toepassing.
Voor licentievereisten, zie Kies een licentieoptie voor Fabric Apps. Om een app met een van beide opties te maken, volg je Een app aanmaken vanuit het portaal.
Tenantbeheerdersinstellingen
Een Fabric tenantbeheerder moet de workload Fabric Apps inschakelen voordat gebruikers items kunnen maken.
- Meld u aan bij de Fabric-beheerportal.
- Navigeer naar Tenantinstellingen.
- Zet onder Fabric Apps de instelling op Ingeschakeld.
- Kies of u wilt inschakelen voor de hele organisatie of specifieke beveiligingsgroepen.
- Selecteer de optie Toepassen.
Het kan enkele minuten duren voordat wijzigingen zijn doorgevoerd.
Hoe werkt het?
Een Fabric-app brengt frontendhosting en beheerde backenddiensten samen. Uw frontend gebruikt de Rayfin-client om toegang te krijgen tot data-API's, functies aan te roepen, bestanden te beheren en verbonden gegevens te bevragen. Fabric beheert de hosting, netwerken en schalen. Geïmplementeerde apps gebruiken Fabric SSO (Microsoft Entra ID single sign-on) voor gebruikersauthenticatie; andere aanmeldproviders zijn na implementatie niet beschikbaar.
Wanneer u met de Rayfin-CLI implementeert, richt Fabric de in rayfin.yml ingeschakelde services in of werkt deze bij. Kies de diensten die uw app nodig heeft:
| Dienst | Wat het biedt |
|---|---|
| Data en GraphQL-API’s | Gestructureerde app-gegevens in een SQL-database in Fabric, met schema's en API's gegenereerd vanuit uw TypeScript-datamodellen en autorisatieregels. |
| Functions | Server-side TypeScript-logica beschikbaar gesteld via aanroepbare HTTP-eindpunten, met getypte clientaanroepen en toegang tot app-data en externe diensten. |
| Bestandsopslag | opslag ondersteund door OneLake voor documenten, afbeeldingen en bijlagen, met getypeerde mappen en geauthenticeerde toegangsregels. Opslag vereist de Data-service. |
| Authentication | Fabric SSO voor uitgerolde apps, zodat gebruikers inloggen met hun bestaande Fabric-identiteit. |
| Statische hostingservice | Uw gebouwde frontendbestanden worden geserveerd via een hosting-URL, met beveiligde of anonieme toegang tot de statische content. |
Beheer in de Fabric-portal
Na de implementatie kunt u uw Fabric-app rechtstreeks in de Fabric-portal beheren.
Een Fabric-beheerder kan tijdelijk andere gebruikers verhinderen je app te laden. Als eigenaar van de app kun je de app nog steeds openen. Voor meer informatie, zie Fabric-apps blokkeren en deblokkeren.
Als je een geblokkeerde app bezit of gebruikt, zie Wat gebeurt er wanneer een app wordt geblokkeerd.
Itemtoegang
Werkruimterollen vervangen geen machtigingen op itemniveau. Als ze een app willen delen met iemand in uw organisatie, hebben ze de machtiging Uitvoeren en communiceren (lezen en uitvoeren) nodig om de app uit te voeren en de back-end-API's aan te roepen.
| Toestemming | Wat het toestaat |
|---|---|
| Uitvoeren en interageren (standaard) | Open en gebruik de geïmplementeerde toepassing. Alle leden van de werkruimte ontvangen dit niveau standaard. |
| Bewerken (Schrijven) | Wijzig de Fabric-app: implementeer code met rayfin up, pas schemawijzigingen toe, update-instellingen en beheer onderliggende services. |
| Opnieuw delen | Andere gebruikers toegang verlenen tot de Fabric-app. Hiervoor is de beheerdersrol in de werkruimte vereist. |
Meer informatie over werkruimterollen.
Voor de deelworkflow, machtigingen voor gerelateerde items en toegangsverzoeken, zie Een Fabric-app delen.
Ontwikkeling met Rayfin CLI
De CLI zet nieuwe projecten op, start lokale infrastructuur op, synchroniseert schemawijzigingen en rolt uit naar Fabric. Installeer het met npm create @microsoft/rayfin@latest.
Sleutelopdrachten:
| Opdracht | Purpose |
|---|---|
npm create @microsoft/rayfin@latest |
Maak een nieuw project op basis van een sjabloon. |
npx rayfin up |
Implementeer uw project in Fabric. |
npx rayfin up db apply |
Wijzigingen in databaseschema's toepassen. |
Zie CLI-naslaginformatie voor een volledige opdrachtreferentie.
Decorators voor gegevensmodellen
Gegevensmodellen definiëren met Behulp van TypeScript-decorators:
De standaard blankapp scaffold is een Universal App-werkruimte. Data is opt-in: activeer het voordat entiteiten worden toegevoegd aan packages/data/src/, en houd klantgerichte contracten in packages/shared/src/. Flat templates kunnen rayfin/data/ in plaats daarvan gebruikt worden. Zie Gegevensmodellen definiëren.
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({ max: 255 }) user_id!: string;
}
Je kunt ook verbinding maken met bestaande data in plaats van alle gegevens in de database van de app op te slaan. Connectors bieden leestoegang tot een lakehouse via het SQL Analytics-eindpunt, ondersteunde lees- en schrijfbewerkingen op een warehouse of SQL-database in Fabric, en queries tegen een semantisch model. Connectortoegang vereist de juiste bronmachtigingen; het verleent geen toegang tot de onderliggende gegevens. Zie Connect Fabric Apps to Fabric data.
Gebruik voor data en diensten buiten deze connectors functies om externe API's en ondersteunde Azure- en Fabric-resources aan te roepen. Externe verbindingen gebruiken de machtigingen van de app-identiteit, terwijl toegang tot de database van de app via een functie de machtigingen van de aanroeper behoudt. Houd inloggegevens en resourcetokens op de server. Zie Verbind functies met externe bronnen.
Wanneer gebruikt u Fabric Apps
Fabric Apps is ideaal voor:
- Snelle prototyping – Ga binnen enkele minuten van idee naar live URL met vooraf geconfigureerde infrastructuur.
- Interne tools en dashboards – Bouw geauthenticeerde beheerdersinterfaces zonder backend-boilerplate te schrijven.
- Data-exploratie en visualisatie – Gebruik connectors om ondersteunde Fabric-data-items op te vragen en de resultaten in aangepaste frontends weer te geven.
- AI en agentapplicaties – Bieden gestructureerde backenddiensten voor AI-agenten die persistent state nodig hebben.
Fabric Apps zijn mogelijk niet geschikt voor:
- Toepassingen waarvoor complexe transacties met meerdere stappen of opgeslagen procedures vereist zijn.
- Apps die andere aanmeldproviders dan Fabric SSO vereisen na implementatie.
Beveiligingsverantwoordelijkheden
Fabric biedt: Fabric Single Sign On (Microsoft Entra ID), beveiliging op rijniveau via @role decoratoren, HTTPS, PKCE, en werkruimte- en itemniveau-permissies.
U bent verantwoordelijk voor:
- Geheimen, API-sleutels en gevoelige gegevens uit uw code, frontend-assets en repository houden. Sla geen geheimen op in frontend-assets, ongeacht de geconfigureerde hosting-toegang.
- Wat uw app via Fabric SSO beschikbaar stelt, bepaalt het aanmelden, omdat uw code bepaalt wat geverifieerde gebruikers zien en doen.
- Contributors alleen de machtigingen geven die ze nodig hebben om de app te implementeren of te beheren.
- Juridische en nalevingsverantwoordelijkheid voor de gegevens die uw app verzamelt, verwerkt en opslaat.