Analytiikan lisääminen työtiloihin Power BI Embeddedin avulla

Muistiinpano

Toimintoa tuetaan talous- ja toimintosovelluksissa (versio 7.2 ja uudemmat).

Johdanto

Tässä artikkelissa kerrotaan, miten Microsoft Power BI -raportti upotetaan työtilan Analytiikka-välilehteen. Tässä esimerkissä Kuljetuskaluston hallinta -sovelluksen Varausten hallinta -työtila laajennetaan upottamaan analyysityötila Analytiikka-välilehteen.

Edellytykset

• Ympäristön päivityksessä 8 tai sitä uudemmassa päivityksessä käytössä olevan kehitysympäristön käyttö.
• Microsoft Power BI Desktopilla luotu analyysiraportti (.pbix-tiedosto), jonka tietomallin lähteenä on Yksikkösäilö-tietokanta.

Yleiskuvaus

Riippumatta siitä laajennatko aiemmin luodun sovellustyötilan vai otatko käyttöön oman uuden työtilan, voit käyttää upotettuja analyysinäkymiä ja saada niiden kautta hyödyllistä ja vuorovaikutteista tietoa liiketoimintatiedoista. Analyysityötilan välilehti lisätään neljässä vaiheessa.

1. Lisää .pbix-tiedosto Dynamics 365 -resurssina.
2. Määritä analyysityötilan välilehti.
3. Upota .pbix-resurssi työtilan välilehteen.
4. Valinnainen: Lisää laajennuksia näkymää mukauttamalla.

Muistiinpano

Lisätietoja analyysiraporttien luomisesta on kohdassa Power BI Desktopin käytön aloittaminen. Tällä sivulla on tietoja tavoista, joilla voit luoda vaikuttavia analyysiraporttiratkaisuja.

.pbix-tiedoston lisääminen resurssina

Ennen aloittamista on luotava tai haettava työtilaan upotettava Power BI -raportti. Lisätietoja analyysiraporttien luomisesta on kohdassa Power BI Desktopin käytön aloittaminen.

Lisää .pbix-tiedosto Visual Studio -projektin artefaktina.

1. Luo uusi projekti sopivassa mallissa-

2. Valitse ratkaisunhallinnassa projekti, napsauta hiiren kakkospainikkeella ja valitse sitten Lisää>Uusi nimike.

3. Valitse Lisää uusi nimike -valintaikkunan Toimintojen artefaktit -kohdassa Resurssi-malli.

4. Anna nimi, jolla viitataan X++-metatietojen raporttiin ja valitse sitten Lisää.

   

5. Etsi analyysiraportin määritelmän sisältävä .pbix-tiedosto ja valitse sitten Avaa.

   

Nyt kun .pbix-tiedosto on lisätty Dynamics 365 -resurssina, voit upottaa raportteja työtiloihin ja lisätä suoria linkkejä valikkovaihtoehtojen avulla.

Välilehtiohjausobjektin lisääminen sovelluksen työtilaan

Tässä esimerkissä Kuljetuskaluston hallinta -mallin Varausten hallinta -työtilaa laajennetaan lisäämällä Analytiikka-välilehti FMClerkWorkspace-lomakkeen määritelmään.

Seuraavassa kuvassa näytetään, miltä FMClerkWorkspace-lomake näyttää Microsoft Visual Studion suunnittelutoiminnossa.

Laajenna Varausten hallinta -työtilan lomakemääritystä seuraavien ohjeiden mukaisesti.

1. Laajenna suunnittelumääritelmä avaamalla lomakkeen suunnittelutila.
2. Valitse suunnittelumäärityksessä ylin elementti, jonka nimi on Rakenne | Kuvio: työtila toiminnassa.
3. Napsauta hiiren kakkospainikkeella, valitse Uusi>Välilehti ja lisää uusi FormTabControl1-niminen ohjausobjekti.
4. Valitse lomakkeen suunnittelutilassa FormTabControl1.
5. Napsauta hiiren kakkospainikkeella ja lisää uusi välilehtisivu valitsemalla Uusi välilehtisivu.
6. Anna välilehtisivulla uusi merkityksellinen nimi, kuten Työtila.
7. Valitse lomakkeen suunnittelutilassa FormTabControl1.
8. Napsauta hiiren kakkospainikkeella ja valitse sitten Uusi välilehtisivu.
9. Anna välilehtisivulla uusi merkityksellinen nimi, kuten Analytiikka.
10. Valitse lomakkeen suunnittelutilassa Analytiikka (välilehtisivu).
11. Määritä Kuvaus-ominaisuuden arvoksi Analytiikka ja määritä Automaattinen ilmoitus -ominaisuuden arvoksi Kyllä.
12. Napsauta ohjausobjektia hiiren kakkospainikkeella ja lisää sitten uusi lomakeryhmän ohjausobjekti valitsemalla Uusi>Ryhmä.
13. Anna lomakeryhmälle uusi merkityksellinen nimi, kuten powerBIReportGroup.
14. Valitse lomakkeen suunnittelutilassa PanoramaBody (välilehti) ja vedä ohjausobjekti sitten Työtila-välilehteen.
15. Valitse suunnittelumäärityksessä ylin elementti, jonka nimi on Rakenne | Kuvio: työtila toiminnassa.
16. Napsauta hiiren kakkospainikkeella ja valitse sitten Poista kuvio.
17. Napsauta hiiren kakkospainikkeella uudelleen ja valitse sitten Lisää kuvio>Välilehdellinen työtila.
18. Tarkista muutokset luomalla koontiversio.

Seuraava kuva osoittaa, miltä rakenne näyttää muutosten jälkeen.

Nyt kun työtilan raportin upottamiseen käytettävät lomakkeen ohjausobjektit on lisätty, pääohjausobjektin koko on määritettävä asetteluun sopivaksi. Oletusarvoisesti sekä Suodatinruutu-sivu että Välilehti-sivu näkyvät raportissa. Voit kuitenkin muuttaa näiden ohjausobjektien näkyvyyttä raportin kohdekäyttäjän mukaan.

Muistiinpano

Upotetuissa työtiloissa kannattaa käyttää laajennuksia, jotka piilottavat yhdenmukaisuuden vuoksi sekä Suodatinruutu- että Välilehti-sivut.

Olet nyt suorittanut sovelluksen lomakemäärityksen laajennustehtävän. Lisätietoja mukautusten tekemisestä laajennusten avulla on kohdassa Mukauttaminen laajennusten ja lisäysten avulla.

Katseluohjausobjektin upottaminen lisäämällä X++-liiketoimintalogiikka

Lisää näiden ohjeiden mukaisesti liiketoimintalogiikka, joka käynnistää Varausten hallinta -työtilaan upotetun raportin katseluohjelman ohjausobjektin.

1. Laajenna suunnittelumääritys avaamalla FMClerkWorkspace-lomakkeen suunnittelutila.

2. Käytä koodimäärityksen taustalla olevaa koodia F7-näppäimellä.

3. Lisää seuraava X++-koodi.

   [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. Tarkista muutokset luomalla koontiversio.

Olet nyt suorittanut tehtävän, jolla upotetun raportin katseluohjelman ohjausobjektin käynnistävä liiketoimintalogiikka lisätään. Seuraava kuva osoittaa, miltä työtila näyttää muutosten jälkeen.

Muistiinpano

Voit käyttää aiemmin luotua toimintonäkymää käyttämällä sivun otsikkoon kuuluvia työtilan välilehtiä.

Viite

PBIReportHelper.initializeReportControl-menetelmä

Tässä osassa on tietoja aputoimintoluokasta, jolla Power BI -rapotti (.pbix-resurssi) upotetaan lomakeryhmän ohjausobjektiin.

Syntaksi

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

Parametrit

Nimi	kuvaus
resourceName	.pbix-resurssin nimi.
formGroupControl	Lomakeryhmän ohjausobjekti, johon Power BI -raportin ohjausobjektia käytetään.
defaultPageName	Oletussivun nimi.
showFilterPane	Totuusarvo, joka ilmaisee, näytetäänkö suodatinruutu (tosi) vai piilotetaanko se (epätosi).
showNavPane	Totuusarvo, joka ilmaisee, näytetäänkö siirtymisruutu (tosi) vai piilotetaanko se (epätosi).
defaultFilters	Power BI -raportin oletussuodattimet.