Dataset

Tarjoaa ominaisuuksia ja menetelmiä tietojen työstämiseen ruudukoissa ja näkymissä.

Käytettävissä kohteelle

Mallipohjaiset ja pohjaan perustuvat sovellukset.

Majoituspaikkaa

Sarakkeet

Tässä tietojoukossa käytettävissä olevien sarakkeiden joukko. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa.

Tyyppi: Sarake[]

virhe

Ilmenikö tietojen noutamisessa virhe. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa.

Tyyppi: boolean

errorCode

Viimeiseen havaittuun virheeseen liittyvä virhekoodi, jos sellainen on käytettävissä.

errorMessage

Viimeiseen havaittuun virheeseen liittyvä virhesanoma, jos se on käytettävissä.

Tyyppi: number | string

suodatus

Nykyisen kyselyn sarakkeen suodatus. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa. Suodatus voidaan määrittää tietojoukolle asettamalla .context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>) Kun suodatin on määritetty, kutsuminen context.parameters.[dataset_property_name].refresh() noutaa suodatetut tiedot tietolähteestä.

Arvo	Ehdollinen operaattori	Mallipohjaiset sovellukset	Kaaviosovellukset
-1	Ei lainkaan	Kyllä	Kyllä
0	Yhtäläinen	Kyllä	Kyllä
1	Eriarvoisuus	Kyllä	Kyllä
2	Suurempi kuin	Kyllä	Kyllä
3	LessThan	Kyllä	Kyllä
4	Suurempi eriarvoisuus	Kyllä	Kyllä
5	Eriarvoisuus pienempi	Kyllä	Kyllä
6	Tykkäys	Kyllä	Kyllä
7	NotLike	Ei	Kyllä
8	Kohteessa	Kyllä	Kyllä
12	Tyhjäarvo	Kyllä	Kyllä
13	NotNull	Ei	Kyllä
14	Eilen	Kyllä	Ei
15	Today	Kyllä	Ei
16	Huomenna	Kyllä	Ei
17	Last7Days	Kyllä	Ei
18	Seuraavat7 päivää	Kyllä	Ei
19	LastWeek	Kyllä	Ei
20	ThisWeek	Kyllä	Ei
22	LastMonth	Kyllä	Ei
23	ThisMonth	Kyllä	Ei
25	Täsmälleen	Kyllä	Ei
26	OnOrBefore	Kyllä	Ei
27	OnOrAfter	Kyllä	Ei
28	LastYear	Kyllä	Ei
29	Tänä vuonna	Kyllä	Ei
33	LastXDays	Kyllä	Ei
34	NextXDays	Kyllä	Ei
37	LastXMonths	Kyllä	Ei
38	NextXMonths	Kyllä	Ei
49	Sisältää	Kyllä	Kyllä
54	BeginWith	Ei	Kyllä
55	DoesNotBeginWidth	Ei	Kyllä
56	EndsWidth	Ei	Kyllä
57	DesNotEndWith	Ei	Kyllä
70	InFiscalPeriodAndYear	Kyllä	Ei
75	Yläpuolella	Kyllä	Kyllä
76	Alapuolella	Kyllä	Kyllä
77	Ei alle	Kyllä	Kyllä
78	AboveOrEqual	Kyllä	Kyllä
79	UnderOrEqual	Kyllä	Kyllä
87	ContainValues	Kyllä	Kyllä
88	DoesNotContainValues	Ei	Kyllä

Note

Suodatusominaisuus on käytettävissä vain Dataverse-tietolähteelle.

Tyyppi: Suodatus

linkittäminen

Määrittää linkitetyn taulukon tiedot. Tuetaan vain mallipohjaisissa sovelluksissa.

Tyyppi: Linkitys

lastaaminen

Ilmaisee, latautuuko tietojoukko vai ei. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa.

Tyyppi: boolean

sivutus

Sivutuksen tila ja toiminnot. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa. Sivutustietoja voi käyttää ja määrittää tietojoukolle :n avulla context.parameters.[dataset_property_name].paging .

Note

Dataverse-tietolähde ei palauta sivutusobjektia totalRecordCount pohjaan perustuville sovelluksille. Sen sijaan se käyttää hasNextPage -sovellusta ja hasPreviousPage tarkistaa, onko enemmän tietueita noudettava.

Tietojoukon osien avulla context.parameters.[dataset_property_name].paging.setPageSize(pageSize) voidaan muuttaa sivukohtaista noudettavien tietueiden määrää.

Tyyppi: Sivutus

Records

Tunnusten yhdistäminen koko tietueen objektiin. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa.

Tyyppi: EntityRecord

sortedRecordIds

Tietojoukon tietueiden tunnukset järjestyksessä kyselyn vastauksen tuloksen mukaan. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa.

Tyyppi: string[]

lajittelu

Nykyisen kyselyn lajittelutila. Tuetaan sekä mallipohjaisissa sovelluksissa että pohjaan perustuvissa sovelluksissa. Tietojoukolle voidaan määrittää lajittelua asettamalla context.parameters.[dataset_property_name].sorting = [SortStatus]. Kun lajittelu on määritetty, lajittelu context.parameters.[dataset_property_name].refresh() noutaa lajiteltuja tietoja tietolähteestä.

Note

Lajitteluominaisuus on käytettävissä vain Dataverse-tietolähteelle. Jos lajittelu on määritetty uudelleen, se myös nollaa suodattimen. context.parameters.[dataset_property_name].filtering

Tyyppi: SortStatus[]

Menetelmät

Metodi	Description	Käytettävissä kohteelle
addColumn	Lisää sarakkeen sarakejoukkoon.	Mallipohjaiset sovellukset
clearSelectedRecordIds	Tyhjentää valittujen tietuetunnusten luettelon.	Mallipohjaiset ja pohjaan perustuvat sovellukset
poistaa	Poista tietueet tietolähteestä.	Kaaviosovellukset
getCommands	Tietojoukon komennot.	Kaaviosovellukset
getDataSetCapabilities	tietojoukon ominaisuudet.	Kaaviosovellukset
getSelectedRecordIds	Hakee kaikki valitut tietuetunnukset.	Mallipohjaiset ja pohjaan perustuvat sovellukset
getTargetEntityType	Palauttaa kohdetaulukkotyypin nimen.	Mallipohjaiset ja pohjaan perustuvat sovellukset
getTitle	Noutaa tietojoukon ominaisuuden käyttämän näkymän näyttönimen.	Mallipohjaiset ja pohjaan perustuvat sovellukset
getViewId	Palauttaa tietojoukkoparametrin käyttämän näkymän tunnuksen.	Mallipohjaiset ja pohjaan perustuvat sovellukset
newRecord	Alusta paikallinen tietue-objekti ohjausobjektia varten arvon määrittämiseksi. Ohjausobjektin save() on kutsuttava -menetelmä juuri luodussa tietueessa, jotta muutos säilyy.	Kaaviosovellukset
openDatasetItem	Avaa tietojoukkokohde annetulle EntityReference-kohteelle. Se tarkistaa, onko komentoa, jossa on komentopainikkeen tunnus Mscrm.OpenRecordItem. Jos se on olemassa, se suorittaa komennon, muussa tapauksessa se siirtyy vain liittyvään EntityReference-muotoon.	Mallipohjaiset ja pohjaan perustuvat sovellukset
virkistää	Päivittää tietojoukon uuden sarakkeen suodattimien, lajittelun, linkittämisen ja perusteella. Lisäksi päivitys palautuu sivuksi 1.	Mallipohjaiset ja pohjaan perustuvat sovellukset
retrieveRecordCommand	Tietueen liittyvien komentojen noutaminen. Jos luettelotiedostossa on useita tietojoukkoja, haeRecordCommand palauttaa ensimmäisen tietojoukon komennot.	Mallipohjainen
setSelectedRecordIds	Määritä valittujen tietueiden tunnukset.	Mallipohjaiset ja pohjaan perustuvat sovellukset

Hakusarakkeet

Dataverse-taulukon hakusarakkeet voi nyt noutaa. Jos pohjaan perustuvissa sovelluksissa hakusarake sisältyy tietojoukkoon, kaikki viitatun tietueen sarakkeet noudetaan. GetFormattedValue palauttaa tämän sarakkeen JSON-merkkijonon. GetValue -menetelmä palauttaa JSON-objektin suoraan.

Esimerkki

Lisätietoja tietojoukon menetelmien käyttöönotosta on kohdassa Tietojoukkoruudukko-osa

Aiheeseen liittyviä artikkeleita

Power Apps -osakehyksen API-tietoja
Power Apps -osakehyksen yleiskatsaus