Luo sovellus, joka on yhdistetty semanttiseen malliin

Käytä datasovelluspohjaa Fabric-semanttisen malliliittimen kanssa analyyttisen Fabric-sovelluksen rakentamiseen. Mallipohja tarjoaa visualisoinnin, muotoilun, tietoruudukon ja selaimen validointimallit. Liitin tarjoaa tyypitetyn ja delegoidun pääsyn semanttiseen malliin Fabric Apps -asiakasohjelman kautta.

Laatikosta otettuna mallipohjalla luodut sovellukset ovat:

• Fabric Authentication.
• Korkealaatuinen DAX (Data Analysis Expressions) -generointiohjeistus.
• Yritysvalmiita visuaalisia komponentteja, jotka on suunniteltu analyyttisiin sovelluksiin.
• Dataruudukko, teema, muotoilu ja selaimen validointimallit.

Note

Tällä hetkellä Rayfin CLI on tuettu tapa luoda sovelluksia käyttämällä datasovelluspohjaa.

Miksi käyttää datasovelluspohjaa?

Ilman näitä sisäänrakennettuja ominaisuuksia koodausagentin täytyy ratkaista tunnistautuminen, DAX-generointi ja visualisointisuunnittelu alusta alkaen jokaisessa sessiossa. Se voi johtaa:

• Lisää epäonnistumisia ja rikkinäisiä tai tyhjiä visuaaleja.
• Epäjohdonmukainen karttakäyttäytyminen.
• Tarpeettomat DAX-kyselyt kehityksen ja ajonajan aikana.

Mallipohja tarjoaa uudelleenkäytettäviä kuvioita, jotka parantavat luotettavuutta, tuottavat yhtenäisempiä visuaaleja, jotka ovat linjassa raportoinnin parhaiden käytäntöjen kanssa, ja vähentävät kyselyjen kuormitusta. Liitin standardisoi semanttisen mallin konfiguroinnin ja ajonaikaisen pääsyn.

Edellytykset

• Node.js 20 vuotta tai vanhempia.
• Access to Fabric.
• Fabric-työtila, jossa sinulla on Contributor-, Member- tai Admin-oikeudet.
• Fabric Apps -työkuorma on käytössä vuokralaisessasi. Katso Luo ensimmäinen Fabric-sovelluksesi.
• Semantic Model Execute Queries REST API -vuokralaisen asetus käytössä.
• Rakenna ja lue oikeudet semanttiseen malliin, joka on isännöity Fabric- tai Power BI-kapasiteetissa.
• Työtilan ID ja semanttisen mallin kohde-ID.

Sovelluksen luominen

Luo projekti datasovelluksen mallipohjasta:

npm create @microsoft/rayfin@latest -- "<app-name>" --template dataapp --workspace <workspace-name>

Korvaa <app-name> ja <workspace-name> käytä sovelluksesi ja Fabric-työtilan nimiä. Avaa sitten uusi projektikansio:

cd <app-name>

Lisää semanttinen malliliitin

Jos et tiedä semanttisen mallin kohteen ID:tä, listaa semanttiset mallit työtilassa:

npx rayfin connector search --workspace-id <workspace-id> --type fabric-semanticmodel --json

Lisää semanttinen malli liittimeksi:

npx rayfin connector add --type fabric-semanticmodel --workspace-id <workspace-id> --item-id <semantic-model-item-id> --name salesModel --operations executeQuery

Komento:

• Lisää liittimen salesModel .rayfin/rayfin.yml
• Luo skeeman alle rayfin/connectors/salesModel/.
• Tulostaa versionmukaisen npm install komennon liitinpaketeille.

Suorita tarkka asennuskomento, joka on tulostettu komentoketjun toimesta.

Generoitu konfiguraatio muistuttaa seuraavaa esimerkkiä:

connectors:
  - name: salesModel
    type: fabric-semanticmodel
    config:
      workspaceId: "<workspace-id>"
      itemId: "<semantic-model-item-id>"
    auth:
      type: delegated
    version: "1"
    operations:
      - name: executeQuery

Pidä tuotettu version arvo.

Yhdistä malli semanttiseen malliin

Mallipohja sisältää analyyttisiä komponentteja ja agentin ohjausta, joita voit käyttää uudelleen liittimen kanssa. Määritä sen data-access -kerros luomaan ConnectorsRayfinClient ja rekisteröimään semanttisen mallin ajonaika:

Tärkeää

Käytä connector-asiakasohjelmaa semanttisiin mallikyselyihin. Jos rakenne sisältää toisen semanttisen mallin asiakasohjelman, korvaa sen kutsut sen sijaan, että ylläpidettäisiin kahta datan käyttöpolkua.

import { ConnectorsRayfinClient } from '@microsoft/rayfin-client';
import { fabricSemanticModel } from '@microsoft/rayfin-connector-fabric-semanticmodel';
import {
  connectorConfig,
  type SalesModelSchema,
} from '../../rayfin/connectors/salesModel/schema.js';

type AppConnectorsSchema = {
  salesModel: SalesModelSchema;
};

export const client = new ConnectorsRayfinClient<
  Record<string, never>,
  Record<string, never>,
  AppConnectorsSchema
>(
  {
    baseUrl: '<app-api-url>',
    publishableKey: '<publishable-key>',
    authStorage: true,
    connectors: {
      salesModel: connectorConfig,
    },
  },
  {
    salesModel: fabricSemanticModel(),
  }
);

Käytä API-URL-osoitetta ja julkaistavaa avainta Fabric Apps -projektistasi. Pidä mallipohjan olemassa oleva Fabric-kirjautumisvirta.

Lähetä DAX liittimen kautta:

const result = await client.connectors.salesModel.executeQuery({
  query: 'EVALUATE TOPN(10, Sales)',
});

if (result.status === 'success') {
  console.log(result.table.columns, result.table.rows);
} else {
  console.error(result.error.category, result.error.message);
}

Korvaa Sales se taulukolla semanttisessa mallissasi. Tarkista palautustila ennen kuin siirrät sarakkeet ja rivit visuaalille.

Lisätietoja liittimien konfiguraatiosta ja tietoturvasta löytyy kohdasta Connect Fabric Apps to Fabric data.

Rakenna sovellus koodausagentilla

Telineessä on ohjeet ja taitoja koodausagenteille. Avaa projekti haluamallasi agentilla ja kuvaile sovelluksen kohderyhmä, kysymykset, vuorovaikutukset ja visualisoinnit.

Voit esimerkiksi tehdä seuraavaa:

• Avaa projekti Visual Studio Code:ssa ja avaa sitten GitHub Copilot Chat -paneeli.
• Avaa terminaali projektissa ja suorita copilotsitten .

Käytä tätä kehotetta lähtökohtana:

Build an analytical Fabric app that uses the existing salesModel connector.

Before editing:
1. Read the repository instructions and skills.
2. Inspect rayfin/connectors/salesModel/schema.ts and the template's data-access,
   visualization, data grid, formatting, and validation patterns.
3. Query the semantic model metadata before writing DAX. Don't guess table,
   measure, or column names.

Requirements:
- Use ConnectorsRayfinClient and fabricSemanticModel() for semantic model access.
- Call client.connectors.salesModel.executeQuery() for DAX queries.
- Keep the existing Fabric sign-in flow. Don't add credentials, access tokens,
  another authentication flow, or direct calls to the Execute Queries REST API.
- Reuse query results where practical, and bound large result sets.
- Apply semantic model format strings consistently to cards, charts, tooltips,
  and data grids.
- Include loading, empty, and error states.
- Use the template's browser-validation workflow at desktop and mobile sizes.

Give me a short implementation plan, make the changes, run the existing build,
and report the results.

Käytä mallipohjan ominaisuuksia

Datasovelluspohja sisältää uudelleenkäytettäviä kuvioita analyyttisiin sovelluksiin.

Fabric-sovellukset ovat tavallisia verkkosovelluksia, joten voit toteuttaa ominaisuuksia näiden mallien ulkopuolelta. Ominaisuudet, joita ei sisälly malliin, saattavat vaatia enemmän räätälöityä suunnittelua ja validointia.

Visuaaliset tehosteet

Mallipohja sisältää ristiinkorostuksen ja ennalta konfiguroidut primitiivit:

• Pylväskaaviot, mukaan lukien pystysuorat, vaakatasoiset, ryhmittely- ja pinotut asettelut.
• Viivakaavioita valinnaisilla merkeillä.
• Aluekarttoja.
• Hajontakaavioita.
• Piirakka- ja donitsitaulukot.
• Lämpökarttoja.
• Kuplakaaviot.
• Vesiputouskartat.
• Yksiarvoiset kortit KPI-kutsuille.
• Kerrostettuja ja yhdistettyjä kuvioita, kuten palkkeja, joissa on tietotunnisteet, ja kaksiakseliset viivakaaviot.

Käytä kenttiä ja mittareita, jotka ovat olemassa yhdistetyssä semanttisessa mallissa. Älä korvaa epäonnistunutta liitinkyselyä mock-datalla.

Voit pyytää koodausagenttiasi luomaan muita visuaaleja. Visuaalit ilman pohjapohjaa saattavat vaatia lisää iteraatioita ja validointia.

Tietoverkko-ominaisuudet

Mallipohja sisältää dataruudukon, jossa on seuraavat ennalta konfiguroidut ominaisuudet:

• Sarakeotsikot, jotka on johdettu semanttisesta mallin metatiedoista.
• Numero- ja päivämäärämuotoilu sovellettiin sarakkeeseenkin muotomerkkijonojen kautta.
• Lajittelu.
• Vieritettävät rivit ylivuotokäsittelyllä.
• Vaalean ja tumman teeman tuki.
• Mukautetut solujen renderöintiohjelmat:
  • Datapalkit numeerisille arvoille.
  • Boolen indikaattorit.
  • Klikattavat URL-osoitteet.
  • Kuvasolut valolaatikkokerroksella.
  • Monikenttäsolut, kuten nimi ja rooli yhdessä sarakkeessa.

Voit lisätä muita datagrid-ominaisuuksia, mutta ne saattavat vaatia enemmän räätälöityä suunnittelua.

Teemasisältö

Anna koodausagentillesi brändi- tai tyylivaatimuksia, kuten väripaletti, kulmatyyli tai fontti. Mallipohja pitää jaetut tyylit yhdessä keskitetyssä paikassa, jolloin virtaus muuttuu kortteihin, painikkeisiin, kaavioihin, dataruudukoihin ja työkaluvihjeisiin.

Keskitetty tyylitys välttää epäyhteensopivat värit, epäjohdonmukaiset fontit ja asettelun erot, joita voi esiintyä, kun jokainen osa on erikseen tyylitelty.

Muotoilumerkkijonot

Määrittele muotoilu kerran per tulossarakke. Mallipohja voi käyttää semanttisia mallimuotoisia merkkijonoja kaavioakselien, työkaluvihjeiden, tietotunnisteiden, korttien ja dataruudun solujen välillä.

Esimerkiksi yksittäinen muotomääritelmä näkyy 1500.5 ja $1,500.500.2525% näkyy siellä, missä nuo arvot esiintyvät.

Selaimen validointi

Ennen kuin julkaiset sovelluksen, käytä mukana olevaa Playwright-selaimen validointityönkulkua avataksesi sen oikeassa selaimessa ja tarkistaaksesi:

• Visuaalit renderöityvät oikein.
• Kaavioita ei katkaista tai purista.
• Teksti on luettavaa.
• Dataruudukot käsittelevät ylivuotoa.
• Lataus-, tyhjä- ja virhetilat ovat käytettävissä.
• Suodattimet, ristiinkorostus ja datan muotoilu toimivat odotetusti.
• Selaimen konsolissa ei ole odottamattomia virheitä.

Tämä työnkulku havaitsee asettelu- ja renderöintiongelmat ennen kuin käyttäjät näkevät ne. Selaimen validointi vahvistaa frontendin käytöksen. Testaa otettu liitin erikseen käyttäjällä, jolla on pääsy sekä Fabric-sovellukseen että semanttiseen malliin.

Ota käyttöön ja varmista sovellus

Ota käyttöön sovellus ja liitinasetukset:

npx rayfin up

Avaa käyttöön otettu sovellus Fabric-portaalista. Kirjaudu sisään, suorita jokainen käyttäjävuorovaikutus ja vertaa tärkeitä tuloksia semanttiseen malliin.

Jos kysely epäonnistuu:

• Vahvista työtilan ja semanttisen mallin tunnisteet kohdassa rayfin.yml.
• Vahvista, että Semantic Model Execute Queries REST API -vuokralaisasetus on käytössä.
• Vahvista, että käyttäjällä on Build- ja Read-oikeudet semanttiseen malliin.
• Varmista, että DAX viittaa olemassa oleviin taulukoihin, sarakkeihin ja mittareihin.
• Tarkista liittimen tuloksen virhekategoria ja viesti.
• Tarkista selaimen konsoli asiakaspuolen virheiden varalta.

Liittyvä sisältö

• Yhdistä Fabric-sovellukset Fabric-dataan
• Luo semanttinen mallisovellus GitHub Copilot -ohjelmalla
• Tunnistautuminen Fabric-sovelluksille
• Ota käyttöön Fabric-sovellus Fabric