Mikä on Fabric Apps (Preview)?

Fabric Apps (esikatselu) perustuu Rayfin SDK:hon ja mahdollistaa kehittäjille datalähtöisten sovellusten luomisen Fabric-pohjalle yhtenäisen kehitystyönkulun avulla. Kehittäjät määrittelevät tietomalleja TypeScriptissä, ja Fabric Apps generoi automaattisesti API:t, hoitaa todennuksen, tarjoaa isännöintipalveluita ja integroituu Fabric-palveluihin. Fabric Apps tukee TypeScriptiä tietomalleille, asiakaskoodille ja sovelluslogiikaleelle. Lue lisää Rayfin SDK:n yleiskatsauksesta.

Tärkeimmät ominaisuudet

Fabric Apps tarjoaa seuraavat ominaisuudet:

• Datamallit API:ksi – Koristele TypeScript-luokat , @entity()@text(), @uuid(), ja muilla sisustajilla. Fabric Apps luo tietokantaskeemat ja GraphQL-päätepisteet automaattisesti.
• Tyyppiturvalliset asiakkaat – Asiakas-SDK validoi kyselyt ja mutaatiot ennen kuin ne saavuttavat taustajärjestelmän, ja havaitsee virheitä kehityksen aikana.
• Sisäänrakennettu tunnistautuminen – Istuntojen hallinta, tokenien käsittely ja todennusprosessit sisältyvät mukana. Määritä Fabric SSO käyttöönotetuille sovelluksille tai käytä sähköpostia ja salasanaa paikallisen kehityksen aikana.
• Staattinen isännöinti – Rakenna ja palvele frontend-sovellustasi yhdessä backend-API:idesi kanssa yhdellä käyttöönottokomennolla.
• Paikallinen kehitys – Aja koko stack paikallisesti Dockerilla nopeaa iterointia varten ja ota se käyttöön Fabric-ohjelmaan, kun se on valmis tuotantoon. Scaffold-projektit, kehitä GitHub Copilot -ohjelmalla ja otetaan käyttöön Fabric-järjestelmässä Rayfin CLI:n avulla.

Tuetut alueet

Fabric-sovelluksia ei vielä ole saatavilla kaikilla alueilla. Katso tuetut alueet Fabric-sovellukselle saadaksesi lisätietoja.

Edellytykset

Fabric-kapasiteetti

Työtilassasi täytyy olla Fabric-kapasiteetti määritettynä. Kun luot uutta työtilaa, valitse Fabric-kapasiteetti, johon liitetään. Fabric Apps -palvelut käyttävät kapasiteettiyksiköitä määritetystä kapasiteetista.

Vuokralaisten ylläpitoasetukset

Fabric-vuokralaisen ylläpitäjän on otettava Fabric Apps -työkuorma käyttöön ennen kuin käyttäjät voivat luoda kohteita.

1. Kirjaudu Fabric hallintaportaaliin.
2. Siirry Vuokralaisasetuksiin.
3. Kohdasta Fabric Apps (preview) vaihda asetus Enabled.
4. Valitse, otetaanko se käyttöön koko organisaatiolle vai tietyille turvallisuusryhmille.
5. Valitse Käytä.

Muutosten leviäminen voi kestää muutaman minuutin.

Näin se toimii

Fabric-sovellus toimii hallittuna palveluna Fabric-järjestelmässä, jossa on joukko palveluita, jotka määrittelevät taustajärjestelmän, kuten sovellusten isännöinti, tietokanta, GraphQL-rajapinnat ja autentikointi. Fabric hoitaa isännöinnin, verkottumisen ja skaalaamisen. Tunnistautuminen käyttää yksinomaan Fabric SSO:ta (Microsoft Entra ID single sign-on) – muita autentikointipalveluntarjoajia ei ole saatavilla käyttöönoton jälkeen.

Kun otat sovelluksesi käyttöön rayfin up:lla, Fabric luo lapsipalveluita rayfin.yml-konfiguraatiosi perusteella. Nämä lastensuojelut näkyvät lapsituotteina Fabric-sovelluksessa Fabric-portaalissa.

App backend URL

Jokaisella Fabric-sovelluksella on yksi päätepiste, joka tarjoaa pääsyn kaikkiin palveluihin:

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

Päätepiste avaa polun jokaiselle palvelulle:

Hallinta Fabric-portaalissa

Käyttöönoton jälkeen voit hallita Fabric-sovellustasi suoraan Fabric-portaalissa.

Näytä kohteen ominaisuudet

Avaa Fabric-sovellus portaalissa nähdäksesi:

• App Backend URL — Tätä päätepistettä käytetään kaikille sovelluksen käyttämille backend-palveluille.
• Sovelluksen URL — Julkinen URL, jossa staattinen sisältösi isännöidään. Fabric SSO vaaditaan sovelluksen käyttämiseen.

Hallinnoi lapsikohteita

Valitse Fabric-sovellus nähdäksesi sen lastenpalvelut:

• SQL-tietokanta Fabric — Avaa Fabric SQL-tietokanta-alkion objektiresurssienhallinnan tarkasteluun. Voit ajaa lukukyselyitä dataasi vastaan. Skeeman muutokset tulisi aina tehdä kansion rayfin/data alla olevassa koodissa. Skeemaristiriitoja voi syntyä, jos skeemaa muutetaan suoraan SQL-tietokannassa, mikä voi rikkoa sovelluksen.

Kohteen käyttöoikeudet

Työtilan roolit eivät syrjäytä kohdetason oikeuksia. Sovelluksen jakamiseen organisaatiossasi tarvitaan Run and Interact -oikeudet (Read and Execute) sovelluksen ajamiseen ja backend-API:n käynnistämiseen.

Lue lisää työtilarooleista.

Kehitys Rayfin CLI:n kanssa

Komentokeskus rakentaa uusia projekteja, käynnistää paikallisen infrastruktuurin, synkronoi skeemamuutokset ja ottaa käyttöön Fabric. Asenna se .npm create @microsoft/rayfin@latest

Keskeiset komennot:

Täydellisen komentoviitteen löydät CLI-viitteestä.

Tietomallien sisustajat

Määrittele tietomallit TypeScript-koristelijoilla:

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 analysoi näitä sisustajia ja tuottaa:

• Tietokantataulukon määritelmät
• GraphQL API -päätepisteet
• Rivitason valtuutussäännöt
• Tyyppiturvalliset asiakasmenetelmät

Milloin käyttää Fabric Appsia

Fabric Apps on ihanteellinen:

• Nopea prototyyppi – Siirry ideasta live-URL-osoitteeseen minuuteissa ennalta konfiguroidulla infrastruktuurilla.
• Sisäiset työkalut ja hallintapaneelit – Rakenna autentikoidut ylläpitäjän rajapinnat ilman backend-standardien kirjoittamista.
• Datan tutkimus ja visualisointi – Kysy Fabric dataa GraphQL:n kautta ja näytä se mukautetuissa käyttöliittymässä.
• Tekoäly- ja agenttisovellukset – Tarjoa jäsenneltyjä taustapalveluita tekoälyagenteille, jotka tarvitsevat pysyvää tilaa.

Fabric-sovellukset eivät välttämättä sovi seuraaviin tarkoituksiin:

• Sovellukset, jotka vaativat monimutkaisia monivaiheisia transaktioita tai tallennettuja prosesseja.
• Sovellukset, jotka vaativat räätälöityjä todennuspalveluita Fabric SSO:n ja sähköpostin/salasanan lisäksi.

Turvallisuusvastuut

Fabric tarjoaa: Fabric Single Sign on (Microsoft Entra ID), rivitason turvallisuuden @role sisustajien kautta, HTTPS, PKCE sekä työtila- ja tuotetason käyttöoikeudet.

Olet vastuussa seuraavista:

• Salaisuudet, API-avaimet ja arkaluonteiset tiedot pidetään poissa koodistasi, frontend-asseteistä ja arkistosta. Staattinen sisältö tarjotaan julkisesta URL-osoitteesta.
• Se, mitä sovelluksesi paljastaa Fabric SSO:n kautta, ohjaa kirjautumista, koska koodisi ohjaa, mitä todennetut käyttäjät näkevät ja tekevät.
• Myöntämällä vain ne oikeudet, joita käyttäjät tarvitsevat sovelluksen käyttöönottoon tai hallintaan.
• Oikeudellinen ja vaatimustenmukaisuuden vastuullisuus sovelluksesi keräämästä, käsittelemästä ja tallentamasta datasta.

Seuraavat vaiheet

• Luo ensimmäinen Fabric Apps -projektisi
• Määrittele tietomalleja koristelijoiden avulla
• Deploy Fabric
• Todentamisen määrittäminen