Tapahtumat
Liity seuraamme FabCon Vegasiin
31. maalisk. klo 23 - 2. huhtik. klo 23
Lopullinen Microsoft Fabric-, Power BI-, SQL- ja tekoälyyhteisöjohtoinen tapahtuma. 31.3.–2.4.2025.
Rekisteröidy jo tänäänTätä selainta ei enää tueta.
Päivitä Microsoft Edgeen, jotta voit hyödyntää uusimpia ominaisuuksia, suojauspäivityksiä ja teknistä tukea.
Kaikki visualisoinnit alkavat luokalla, joka ottaa käyttöön -liittymän IVisual
. Voit nimetä luokan miksi tahansa, kunhan olemassa on täsmälleen yksi luokka, joka ottaa käyttöön -liittymän IVisual
.
Huomautus
Visualisoinnin luokan nimen on oltava sama kuin visualClassName
-tiedostossa pbiviz.json
.
Visualisointiluokan tulee toteuttaa seuraavat menetelmät seuraavassa mallissa esitetyllä tavalla:
constructor
– vakiokonstruktori, joka alustaa visualisoinnin tilanupdate
– visualisoinnin tietojen päivittäminengetFormattingModel
, palauttaa muotoilumallin, joka täyttää ominaisuusruudun (muotoiluasetukset), jossa voit muokata ominaisuuksia tarpeen mukaandestroy
- vakiodestruktori puhdistusta vartenclass MyVisual implements IVisual {
constructor(options: VisualConstructorOptions) {
//one time setup code goes here (called once)
}
public update(options: VisualUpdateOptions): void {
//code to update your visual goes here (called on all view or data changes)
}
public getFormattingModel(): FormattingModel {
// returns modern format pane formatting model that contain all format pane components and properties (called on opening format and analytics pane or on editing format properties)
}
public destroy(): void {
//one time cleanup code goes here (called once)
}
}
constructor
Visualisointiluokkaa kutsutaan, kun visualisoinnin esiintymä luodaan. Sitä voidaan käyttää missä tahansa visualisoinnin tarvitsemisen toimintojen määrittämisessä.
constructor(options: VisualConstructorOptions)
Nämä liittymät päivitetään jokaisen uuden ohjelmointirajapintaversion mukana. Saat päivitetyimmän liittymämuodon GitHub-säilöstä.
Seuraavassa luettelossa kuvataan joitain liittymän VisualConstructorOptions
ominaisuuksia:
element: HTMLElement
– viittaus DOM-elementtiin, joka sisältää visualisoinnin
host: IVisualHost
– kokoelma ominaisuuksia ja palveluja, joita voidaan käyttää vuorovaikutuksessa visualisoinnin isännän (Power BI) kanssa
IVisualHost
sisältää seuraavat palvelut:
createSelectionIdBuilder
– luo ja tallentaa metatietoja visualisoinnin valittavissa olevia kohteita vartencreateSelectionManager
- luo viestintäsillan, jonka avulla visualisoinnin isännälle ilmoitetaan valintatilan muutoksista; katso Valinnan ohjelmointirajapinta.hostCapabilities
refreshHostData
downloadService
- palauttaa latauksen laajennetut tulostiedot.eventService
- palauttaa tietoja tapahtumien hahmontamisesta.hostEnv
displayWarningIcon
– palauttaa virheen tai varoitussanoman.licenseManager
– palauttaa käyttöoikeustiedot.createLocalizationManager
– luo esimiehen lokalisointia varten applyJsonFilter
- käyttää tiettyjä suodatintyyppejä. Katso Suodattimen ohjelmointirajapintaapplyCustomSort
- sallii mukautetut lajitteluasetukset.acquireAADTokenService
– palauttaa Microsoft Entra ID - todennustiedot.webAccessService
– palauttaa etäresurssien käyttöoikeuksien tilan.openModalDialog
– palauttaa valintaikkunan.persistProperties
- käyttäjät voivat luoda pysyviä asetuksia ja tallentaa ne visualisoinnin määrityksen mukana, jolloin ne ovat käytettävissä seuraavassa uudelleenlatauksessaeventService
– palauttaa tapahtumapalvelun, joka tukee Hahmonna-tapahtumiastorageService
– palauttaa palvelun, joka helpottaa paikallisen tallennustilan käyttöä visualisoinnissastorageV2Service
– palauttaa palvelun, joka helpottaa paikallisen tallennusversion 2 käyttämistä visualisoinnissatooltipService
– palauttaa työkaluvihjepalvelun, joka helpottaa työkaluvihjeiden käyttöä visualisoinnissatelemetry
drill
launchUrl
– auttaa käynnistämään URL-osoitteen seuraavassa välilehdessäauthenticationService
– palauttaa Microsoft Entra ID -tunnuksen.locale
– palauttaa aluekohtaisen merkkijonon; katso LokalisointiinstanceId
– palauttaa merkkijonon, jonka avulla visualisoinnin nykyinen esiintymä tunnistetaancolorPalette
– palauttaa väripaletin, jota tarvitaan värien käyttöön tiedoissafetchMoreData
- tukee vakiorajaa (1 000 riviä) suuremman tietorajan käyttämistä. Katso Lisätietojen noutaminenswitchFocusModeState
– auttaa muuttamaan kohdistustilaaKaikkien visualisointien on käytettävä julkista päivitysmenetelmää, jota kutsutaan aina, kun tietoja tai isäntäympäristöä muutetaan.
public update(options: VisualUpdateOptions): void
viewport: IViewport
- sen näyttöraportin mitat, jossa visualisointi tulisi hahmontaadataViews: DataView[]
– tietonäkymäobjekti, joka sisältää kaikki visualisoinnin hahmontamiseen tarvittavat tiedot (visualisointi käyttää yleensä DataView-kohdan alla olevaa luokittaista ominaisuutta)type: VisualUpdateType
- merkintä, joka ilmaisee päivitettävien tietojen tyypin (Tietojen | | ResizeEnd)viewMode: ViewMode
- merkintä, joka ilmaisee visualisoinnin näkymätilan (Näytä | Muokkaa | inFocusEdit)editMode: EditMode
- merkintä, joka ilmaisee visualisoinnin muokkaustilan (oletusasetukset | ) (jos visualisointi tukee AdvancedEditMode-tilaa, sen pitäisi hahmontaa käyttöliittymän lisäohjausobjektit vain, kun editMode-asetuksena on Lisäasetukset, katso AdvancedEditMode)operationKind?: VisualDataChangeOperationKind
- merkintä, joka ilmaisee tietojen muutoksen tyypin (Luo | lisä)jsonFilters?: IFilter[]
- kokoelma käytössä olevista json-suodattimistaisInFocus?: boolean
– merkintä, joka ilmaisee, onko visualisointi kohdistustilassaTätä menetelmää kutsutaan kerran aina, kun avaamme Ominaisuudet-ruudun tai käyttäjä muokkaa jotakin ruudun ominaisuuksista. Se palauttaa FormattingModel
kaikki tiedot ominaisuusruudun rakenteesta, hierarkiasta, ominaisuuksista ja uusimmista muotoiluarvoista.
getFormattingModel(): visuals.FormattingModel;
Destroy-funktiota kutsutaan, kun visualisointi puretaan, ja sitä voidaan käyttää tehtävien tyhjentämiseen, kuten tapahtumien kuuntelutoimintojen poistamiseen.
public destroy(): void
Vihje
Power BI ei tavallisesti kutsu -funktiota destroy
, koska on nopeampaa poistaa koko IFrame, joka sisältää visualisoinnin.
Tapahtumat
Liity seuraamme FabCon Vegasiin
31. maalisk. klo 23 - 2. huhtik. klo 23
Lopullinen Microsoft Fabric-, Power BI-, SQL- ja tekoälyyhteisöjohtoinen tapahtuma. 31.3.–2.4.2025.
Rekisteröidy jo tänään