Výrazy v aplikácii Power BI Zostavovač zostáv
VZŤAHUJE SA NA: Power BI Zostavovač zostáv Power BI Desktop
Výrazy sa bežne používajú v službe Power BI Zostavovač zostáv stránkovaných zostáv na načítanie, výpočet, zobrazenie, zoskupenie, zoradenie, filtrovanie, parametrizovanie a formátovanie údajov.
Mnohé vlastnosti položky zostavy je možné nastaviť na výraz. Výrazy pomáhajú riadiť obsah, návrh a interaktivitu zostavy. Výrazy sú napísané v jazyku Microsoft Visual Basic, uložené v definícii zostavy a vyhodnocované procesorom zostavy pri spustení zostavy.
Na rozdiel od aplikácií, ako je napríklad Microsoft Excel, v ktorých pracujete s údajmi priamo v hárku, v zostave pracujete s výrazmi, ktoré sú zástupnými symbolmi údajov. Ak chcete zobraziť skutočné údaje z vyhodnotených výrazov, musíte zobraziť ukážku zostavy. Pri spustení zostavy procesor zostavy vyhodnotí každý výraz a skombinuje údaje zostavy a prvky rozloženia zostavy, ako sú napríklad tabuľky a grafy.
Pri navrhovaní zostavy sa mnohé výrazy pre položky zostavy nastavia za vás. Keď napríklad potiahnete myšou pole z tably údajov do bunky tabuľky v oblasti návrhu zostavy, hodnota textového poľa pre dané pole sa nastaví na jednoduchý výraz. Na table Údaje zostavy na nasledujúcom obrázku sú zobrazené polia množiny údajov ID, Name, SalesTerritory, Code a Sales. Do tabuľky sa pridali tri polia: [Name]
, [Code]
a [Sales]
. [Name]
Zápis v oblasti návrhu predstavuje základný výraz =Fields!Name.Value
.
Keď zobrazíte ukážku zostavy, procesor zostavy skombinuje oblasť tabuľkových údajov so skutočnými údajmi z údajového pripojenia a zobrazí v tabuľke riadok za každý riadok v množine výsledkov.
Ak chcete zadať výrazy manuálne, vyberte položku v oblasti návrhu a nastavte vlastnosti položky pomocou kontextových ponúk a dialógových okien. Keď sa v rozbaľovacom zozname zobrazuje tlačidlo (fx) alebo hodnota <Expression>
, znamená to, že môžete nastaviť vlastnosť na výraz.
Vysvetlenie jednoduchých a komplexných výrazov
Výrazy začínajú znamienkom rovnosti (=) a sú napísané v jazyku Microsoft Visual Basic. Výrazy môžu obsahovať kombináciu konštáv, operátorov a odkazov na vstavané hodnoty (polia, kolekcie a funkcie) a na externý alebo vlastný kód.
Pomocou výrazov môžete určiť hodnotu mnohých vlastností položky zostavy. Najbežnejšie vlastnosti sú hodnoty pre textové polia a zástupný text. Ak textové pole obsahuje iba jeden výraz, výraz je zvyčajne hodnotou vlastnosti textového poľa. Ak textové pole obsahuje viacero výrazov, každý výraz je hodnotou zástupného textu v textovom poli.
V oblasti návrhu zostavy sa výrazy predvolene zobrazujú ako jednoduché alebo komplexné výrazy.
Jednoduché: Jednoduchý výraz obsahuje odkaz na jednu položku vo vstavanej kolekcii, napríklad na pole množiny údajov, parameter alebo vstavané pole. Jednoduchý výraz sa v oblasti návrhu zobrazuje v hranatých zátvorkách. Napríklad
[FieldName]
výraz zodpovedá základnému výrazu=Fields!FieldName.Value
. Jednoduché výrazy sa vytvárajú automaticky pri vytváraní rozloženia zostavy a presúvaní položiek z tably Údaje zostavy do oblasti návrhu. Ďalšie informácie o symboloch predstavujúcich rôzne vstavané kolekcie nájdete v téme Vysvetlenie symbolov predpony pre jednoduché výrazy.Komplexné: Komplexný výraz obsahuje odkazy na viaceré vstavané odkazy, operátory a volania funkcie. Komplexný výraz sa zobrazí, keď
<<Expr>>
hodnota výrazu obsahuje viac než len jednoduchý odkaz. Ak chcete zobraziť výraz, ukážte naň myšou a použite popis. Ak chcete výraz upraviť, otvorte ho v dialógovom okne Výraz .
Na nasledujúcom obrázku sú zobrazené typické jednoduché a komplexné výrazy pre textové polia aj zástupný text.
Ak chcete pre výrazy zobraziť namiesto textu vzorové hodnoty, použite formátovanie na textové pole alebo zástupný text. Na nasledujúcom obrázku je zobrazená oblasť návrhu zostavy prepli na zobrazenie vzorové hodnoty:
Vysvetlenie symbolov predpony v jednoduchých výrazoch
Jednoduché výrazy pomocou symbolov udávajú, či ide o odkaz na pole, parameter, vstavanú kolekciu alebo kolekciu ReportItems . V nasledujúcej tabuľke sú uvedené príklady zobrazovaného textu a textu výrazu:
Položka | Príklad zobrazovaého textu | Príklad textu výrazu |
---|---|---|
Polia množiny údajov | [Sales] [SUM(Sales)] [FIRST(Store)] |
=Fields!Sales.Value =Sum(Fields!Sales.Value) =First(Fields!Store.Value) |
Parametre zostavy | [@Param] [@Param.Label] |
=Parameters!Param.Value =Parameters!Param.Label |
Vstavané polia | [&ReportName] |
=Globals!ReportName.Value |
Doslovné znaky používané pre zobrazovaný text | \[Sales\] |
[Sales] |
Písanie komplexných výrazov
Výrazy môžu obsahovať odkazy na funkcie, operátory, konštanty, polia, parametre, položky zo vstavaných kolekcií a na vložený vlastný kód alebo vlastné zostavy.
Nasledujúca tabuľka uvádza druhy odkazov, ktoré môžete zahrnúť do výrazu:
Odkazy | Description | Príklad |
---|---|---|
Konštanty | Popisuje konštanty, ku ktorým môžete interaktívne pristupovať pri vlastnostiach, ktoré vyžadujú konštantné hodnoty, ako sú napríklad farby písma. | ="Blue" |
Operátory | Popisuje operátory, ktoré môžete použiť na kombinovanie odkazov vo výraze. Napríklad operátor & sa používa pre zreťazenie reťazcov. | ="The report ran at: " & Globals!ExecutionTime & "." |
Vstavané kolekcie | Popisuje vstavané kolekcie, ktoré môžete zahrnúť do výrazu, ako Fields sú napríklad , Parameters a Variables . |
=Fields!Sales.Value =Parameters!Store.Value =Variables!MyCalculation.Value |
Vstavané funkcie zostavy a agregačné funkcie | Popisuje vstavané funkcie, ako Sum sú napríklad alebo Previous , ku ktorým máte prístup z výrazu. |
=Previous(Sum(Fields!Sales.Value)) |
Odkazy na vlastný kód a zostavu vo výrazoch v službe Zostavovač zostáv | Popisuje možný spôsob prístupu k vstavaným triedam xref:System.Math CLR a xref:System.Convert , iným triedam CLR, funkciách knižnice režimu run-time jazyka Visual Basic alebo metódam z externej zostavy.Popisuje možný spôsob prístupu k vlastnému kódu, ktorý je vložený v zostave alebo ktorý kompilujete a inštalujete ako vlastnú zostavu do klienta zostáv aj na server zostáv. |
=Sum(Fields!Sales.Value) =CDate(Fields!SalesDate.Value) =DateAdd("d",3,Fields!BirthDate.Value) =Code.ToUSD(Fields!StandardCost.Value) |
Overenie výrazov
Odkazy, ktoré môžete zahrnúť do výrazu pri vytváraní výrazu pre konkrétnu vlastnosť položky zostavy, závisia od hodnôt, ktoré môže daná vlastnosť položky zostavy prijať, a od rozsahu, v ktorom sa vlastnosť vyhodnocuje. Napríklad:
Výraz
[Sum]
predvolene vypočíta súčet údajov, ktoré sú v rozsahu v čase vyhodnocovania výrazu. V prípade bunky tabuľky rozsah závisí od členskej skupiny riadkov a stĺpcov.V prípade hodnoty pre vlastnosť Font sa hodnota musí vyhodnotiť ako názov písma.
Syntax výrazu sa overí v čase návrhu. Overenie rozsahu výrazu sa vykoná pri publikovaní zostavy. Pri overení závislom od skutočných údajov sa chyby dajú zistiť iba v čase spustenia. Niektoré z týchto výrazov spôsobia #Error ako chybové hlásenie vo vykreslenej zostave.