Sisäiset kokoelmat – yleiset kohteet ja käyttäjäviittaukset sivutetuissa raporteissa (Power BI:n raportin muodostin)
KOSKEE: Power BI Report Builder Power BI Desktop
Sisäinen kentät-kokoelma, joka sisältää sekä yleiset kentät että Käyttäjä-kokoelmat, edustaa Reporting Servicesin tarjoamia globaaleja arvoja sivutetun raportin käsittelyn aikana. Yleiset-kokoelma sisältää arvoja, kuten raportin nimen, raportin käsittelyn alkamisen ajankohdan ja raportin ylä- tai alatunnisteen nykyiset sivunumerot. Käyttäjäkokoelma sisältää käyttäjätunnisteen ja kieliasetukset. Näitä arvoja voidaan käyttää lausekkeissa raportin tulosten suodattamiseen.
Yleisen kokoelman käyttäminen
Yleiset-kokoelma sisältää raportin yleiset muuttujat. Suunnittelualueella nämä muuttujat näkyvät etuliitteenä & (et-merkki), esimerkiksi [&ReportName]
. Seuraavassa taulukossa kuvataan Yleiset-kokoelman jäsenet.
Jäsen | Tyyppi | Kuvaus |
---|---|---|
ExecutionTime | Päivämäärä ja aika | Päivämäärä ja aika, jolloin raportin suorittaminen alkoi. |
PageNumber | Kokonaisluku | Tämä on sivun numero suhteessa sivunvaihtoihin, jotka nollaavat sivun numeron. Raportin käsittelyn alussa alkuarvoksi määritetään 1. Kunkin hahmonnetun sivun sivunumeron lisäykset. Jos haluat numeroida suorakulmion, tietoalueen, tietoalueryhmän tai kartan sivunvaihtojen sivuja PageBreak-ominaisuudessa, määritä ResetPageNumber-ominaisuuden arvoksi Tosi. Ei tueta tablix-sarakehierarkiaryhmissä. PageNumber-numeroa voi käyttää lausekkeessa vain sivun otsikossa tai sivun alatunnisteessa. |
TotalPages | Kokonaisluku | PageNumber-arvon palauttavien sivunvaihtojen kokonaismäärä suhteessa sivunvaihtoihin. Jos sivunvaihtoja ei ole määritetty, tämä arvo on sama kuin OverallTotalPages. TotalPages-sivuja voi käyttää vain sivun otsikon tai sivun alatunnisteen lausekkeessa. |
PageName | Merkkijono | Sivun nimi. Raportin käsittelyn alussa alkuarvoksi määritetään InitialPageName, joka on raportin ominaisuus. Kun kutakin raporttikohdetta käsitellään, tämä arvo korvataan vastaavalla PageName-arvolla suorakulmiosta, tietoalueesta, tietoalueryhmästä tai kartasta. Ei tueta tablix-sarakehierarkiaryhmissä. PageName-ominaisuuksia voi käyttää vain sivun otsikon tai sivun alatunnisteen lausekkeessa. |
OverallPageNumber | Kokonaisluku | Koko raportin nykyisen sivun sivunumero. ResetPageNumber ei vaikuta tähän arvoon. OverallPageNumber-arvoa voi käyttää lausekkeessa vain sivun otsikossa tai sivun alatunnisteessa. |
YleisetTotalPages-sivut | Kokonaisluku | Koko raportin sivujen kokonaismäärä. ResetPageNumber ei vaikuta tähän arvoon. OverallTotalPages-sivuja voi käyttää lausekkeessa vain sivun otsikossa tai sivun alatunnisteessa. |
RenderFormat | RenderFormat | Tietoja nykyisestä hahmontamispyynnöstä. Lisätietoja on seuraavassa osiossa kohdassa RenderFormat. |
Globals-kokoelman jäsenet palauttavat variantin. Jos haluat käyttää tämän kokoelman jäsentä lausekkeessa, joka edellyttää tiettyä tietotyyppiä, muuttuja on ensin muunnettava. Jos haluat esimerkiksi muuntaa suoritusajan muunnoksen Päivämäärä-muotoon, käytä kohdetta =CDate(Globals!ExecutionTime)
. Lisätietoja on kohdassa Tietotyypit lausekkeissa (Power BI:n raportin muodostin).
RenderFormat
Seuraavassa taulukossa kuvataan RenderFormat-kohteen jäsenet.
Jäsen | Tyyppi | Kuvaus |
---|---|---|
Nimi | Merkkijono | Rekisteröidyn hahmontimen nimi. Käytettävissä raportin käsittely-/hahmontamisjakson tietyissä osissa. |
IsInteractive | Totuusarvo | Määrittää, käyttääkö nykyinen hahmontamispyyntö vuorovaikutteista hahmontamismuotoa. |
DeviceInfo | Vain luku -nimi/arvokokoelma | Nykyisen hahmontamispyynnön deviceinfo-parametrien avain-/arvoparit. Merkkijonoarvot voidaan määrittää käyttämällä kokoelmassa joko avainta tai indeksiä. |
Esimerkit
Seuraavissa esimerkeissä näytetään, miten voit käyttää viittausta Yleiset-kokoelmaan lausekkeessa:
Tämä raportin alatunnisteessa olevaan tekstiruutuun sijoitettu lauseke antaa sivunumeron ja raportin kokonaissivumäärän:
=Globals.PageNumber & " of " & Globals.TotalPages
Tämä lauseke antaa raportin nimen ja sen suorittamisen kellonajan. Aika muotoillaan Microsoft .NET Framework lyhyen päivämäärän muotoilumerkkijonolla:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
Tämä valitun sarakkeen Sarakkeen näkyvyys -valintaikkunaan sijoitettu lauseke näyttää sarakkeen vain, kun raportti viedään Exceliin. Muussa tapauksessa sarake on piilotettu.
EXCELOPENXML
viittaa Office 2007:ään sisältyvään Excel-muotoon.EXCEL
viittaa Office 2003:een sisältyvään Excel-muotoon.=IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)
Käyttäjäkokoelman käyttäminen
Käyttäjäkokoelma sisältää tietoja käyttäjästä, joka suorittaa raporttia. Tämän kokoelman avulla voit suodattaa raportissa näkyviä tietoja, esimerkiksi näyttää vain nykyisen käyttäjän tiedot, tai näyttää UserID-tunnuksen esimerkiksi raportin otsikossa. Suunnittelualueella nämä muuttujat näkyvät etuliitteenä & (et-merkki), esimerkiksi [&UserID]
.
Seuraavassa taulukossa kuvataan Käyttäjä-kokoelman jäsenet.
Jäsen | Tyyppi | Kuvaus |
---|---|---|
Kieli | Merkkijono | Raporttia suorittavan käyttäjän kieli. Esimerkki: en-US . |
UserID | Merkkijono | Raporttia suorittavan käyttäjän tunnus. |
Käytä aluekohtaisia asetuksia
Lausekkeiden avulla voit viitata asiakastietokoneen aluekohtaisiin asetuksiin User.Language-arvon kautta määrittääksesi, miltä raportti näyttää käyttäjälle. Voit esimerkiksi luoda raportin, joka käyttää eri kyselylauseketta aluekohtaisten asetusten arvon perusteella. Kysely voi muuttua noutamaan lokalisoituja tietoja eri sarakkeesta palautetun kielen mukaan. Voit myös käyttää lauseketta raportti- tai raporttikohteiden kieliasetuksissa tämän muuttujan perusteella.
Muistiinpano
Vaikka voit muuttaa raportin kieliasetuksia, sinun on varottava mahdollisia mahdollisia ongelmia, joita tämä saattaa aiheuttaa. Esimerkiksi raportin aluekohtaisten asetusten muuttaminen voi muuttaa raportin päivämäärämuotoa, mutta se voi myös muuttaa valuuttamuotoa. Jos valuuttaa ei muunneta, virheellinen valuuttasymboli saattaa näkyä raportissa. Voit välttää tämän määrittämällä kielitiedot yksittäisistä kohteista, joita haluat muuttaa, tai määrittämällä valuuttatiedot sisältävän kohteen tietylle kielelle.