Legge til analyse i arbeidsområder ved hjelp av Power BI Embedded

Notat

Denne funksjonen støttes i økonomi og drift (versjon 7.2 og nyere).

Innledning

Denne artikkelen forklarer hvordan du bygger inn en Microsoft Power BI-rapport i kategorien Analyse i et arbeidsområde. For eksempelet som er angitt her, vil vi utvide arbeidsområdet Reservasjonsbehandling i programmet Fleet Management til å bygge inn et analytisk arbeidsområde på en Analyse-kategori.

Forutsetninger

• Tilgang til et utviklermiljø som kjører plattformoppdatering 8 eller senere.
• En analytisk rapport (.pbix-fil) som ble opprettet ved hjelp av Microsoft Power BI Desktop, og som har en datamodell som har Enhetslager-databasen som kilde.

Oversikt

Enten du utvider et eksisterende arbeidsområde for programmet eller introdusere et nytt arbeidsområde på egen hånd, kan du bruke innebygde analytiske visninger for å levere innsiktsfulle og interaktive visninger av forretningsdataene. Prosessen for å legge til en analytisk arbeidsområdet kategori har fire trinn.

1. Legge til en .pbix-fil som en ressurs for Dynamics 365.
2. Definer en analytisk arbeidsområdet-kategorien.
3. Bygge inn ressursen .pbix i kategorien arbeidsområde.
4. Valgfritt: Legg til filtyper hvis du vil tilpasse visningen.

Notat

Hvis du vil ha mer informasjon om hvordan du oppretter analyserapporter, se Komme i gang med Power BI Desktop. Denne siden er en god kilde for innsikt som kan hjelpe deg med å opprette overbevisende analytiske rapporteringsløsninger.

Legge til en .pbix-fil som en ressurs

Før du begynner, må du opprette eller få tak i Power BI-rapporten som du vil bygge inn i arbeidsområdet. Hvis du vil ha mer informasjon om hvordan du oppretter analyserapporter, se Komme i gang med Power BI Desktop.

Følg denne fremgangsmåten for å legge til en .pbix-fil som en artefakt i et Visual Studio-prosjekt.

1. Opprett et nytt prosjekt i den aktuelle modellen.

2. Velg prosjektet i Solution Explorer, høyreklikk, og velg deretter Legg til>Nytt element.

3. I dialogboksen Legg til nytt element under Operations-artefakter velger du Ressurs-malen.

4. Angi et navn som skal brukes til å referere til rapporten i X++-metadataene, og klikk deretter Legg til.

   

5. Finn .pbix-filen som inneholder definisjonen av den analytiske rapporten, og klikk deretter Åpne.

   

Nå som du har lagt til .pbix-filen som en Dynamics 365-ressurs, kan du bygge inn rapportene i arbeidsområder og legge til direkte koblinger ved å bruke menyelementer.

Legge til en kategorikontroll i et arbeidsområde for program

I dette eksemplet vil vi utvide arbeidsområdet Reservasjonsbehandling i Fleet Management-modellen ved å legge til Analyse-kategorien med definisjonen av FMClerkWorkspace-skjemaet.

Illustrasjonen nedenfor viser hvordan FMClerkWorkspace-skjemaet ser ut i utformingen i Microsoft Visual Studio.

Følg denne fremgangsmåten for å utvide skjemadefinisjonen for den Reservasjonsbehandling-arbeidsområdet.

1. Åpne skjemautformingen for å utvide definisjonen av utformingen.
2. I designdefinisjonen velger du det øverste elementet som heter Design | Pattern: Workspace Operational.
3. Høyreklikk, og velg deretter Ny>Kategori for å legge til en ny kontroll som heter FormTabControl1.
4. Velg FormTabControl1 i skjemautformingen.
5. Høyreklikk, og velg deretter Ny kategoriside for å legge til en ny kategoriside.
6. Endre navnet på kategorisiden til noe som gir mening, som Arbeidsområde.
7. Velg FormTabControl1 i skjemautformingen.
8. Høyreklikk, og velg deretter Ny kategoriside.
9. Endre navnet på kategorisiden til noe som gir mening, som Analyse.
10. I skjemautformingen velger du Analyse (kategoriside).
11. Sett egenskapen Overskrift til Analyse, og sett egenskapen Automatisk erklæring til Ja.
12. Høyreklikk kontrollen, og velg deretter Ny>Gruppe for å legge til en ny skjemagruppekontroll.
13. Endre navnet på skjemagruppen til noe som gir mening, som powerBIReportGroup.
14. I skjemautformingen velger du PanoramaBody (kategori), og dra deretter kontrollen til Arbeidsområde-kategorien.
15. I designdefinisjonen velger du det øverste elementet som heter Design | Pattern: Workspace Operational.
16. Høyreklikk, og velg deretter Fjern mønster.
17. Høyreklikk på nytt, og velg deretter Legg til mønster>Arbeidsområde med kategorier.
18. Utfør et bygg for å bekrefte endringene.

Illustrasjonen nedenfor viser hvordan utformingen ser ut etter at endringene er brukt.

Nå som du har lagt til skjemakontrollene som skal brukes til å bygge inn arbeidsområderapporten, må du definere størrelsen på den overordnede kontrollen, slik at den passer for oppsettet. Som standard er både filterrutesiden og kategorisiden synlig i rapporten. Du kan imidlertid endre synligheten for disse kontrollene etter behov for rapportens målbruker.

Notat

For innebygde arbeidsområder anbefaler vi at du bruker tilleggene for å skjule både filtreringsruten og kategorisidene, for konsekvens.

Du har nå fullført oppgaven for å utvide programskjemadefinisjonen. Hvis du vil ha mer informasjon om hvordan du bruker tillegg til å gjøre tilpasninger, se Tilpasse via utvidelse og overlag.

Legge til X ++-forretningslogikk for å bygge inn en visningskontroll

Gjør følgende for å legge til forretningslogikk som initialiserer rapportvisningskontrollen som er innebygd i arbeidsområdet Reservasjonsbehandling.

1. Åpne FMClerkWorkspace-skjemautformingen for å utvide definisjonen av utformingen.

2. Trykk F7 for å få tilgang til koden bak kodedefinisjonen.

3. Legg til følgende X++-kode

   [Form] 
   public class FMClerkWorkspace extends FormRun
   {
       private boolean initReportControl = true;
       protected void initAnalyticalReport()
       {
           if (!initReportControl)
           {
               return;
           }
           // Note: secure entry point into the Workspace's Analytics report
           if (Global::hasMenuItemAccess(menuItemDisplayStr(FMClerkWorkspace), MenuItemType::Display))
           {
               // initialize the PBI report control using shared helper
               PBIReportHelper::initializeReportControl('FMPBIWorkspaces', powerBIReportGroup);
           }
           initReportControl = false;
       }
       /// <summary>
       /// Initializes the form.
       /// </summary>
       public void init()
       {
           super();
           this.initAnalyticalReport();
       }
   }
   

4. Utfør et bygg for å bekrefte endringene.

Du har nå fullført oppgaven med å legge til forretningslogikk for å initialisere den innebygde rapportvisningskontrollen. Illustrasjonen nedenfor viser hvordan arbeidsområdet ser ut etter at endringene er brukt.

Notat

Du kan få tilgang til den eksisterende operasjonelle visningen ved hjelp av arbeidsområde-kategoriene under sidetittelen.

Referanse

PBIReportHelper.initializeReportControl-metoden

Denne delen gir informasjon om hjelpeklassen som brukes til å bygge inn en Power BI-rapport (.pbix-ressurs) i en skjemagruppekontroll.

Syntaks

public static void initializeReportControl(
    str                 _resourceName,
    FormGroupControl    _formGroupControl,
    str                 _defaultPageName = '',
    boolean             _showFilterPane = false,
    boolean             _showNavPane = false,
    List                _defaultFilters = new List(Types::Class))

Parametere

Navn	Beskrivelse
resourceName	Navnet på .pbix-ressursen.
formGroupControl	Skjemagruppekontrollen der Power BI-rapporten skal brukes.
defaultPageName	Standard sidenavn.
showFilterPane	En boolsk verdi som angir om filtreringsruten skal vises (true) eller skjules (false).
showNavPane	En boolsk verdi som angir om navigasjonsruten skal vises (true) eller skjules (false).
defaultFilters	Standardfiltrene for Power BI-rapporten.