DataSourceInfo-funktio

Koskee seuraavia: pohjaan perustuvat sovellukset Mallipohjaiset sovellukset

Antaa tietolähteen tietoja.

Yleiskuvaus

Tietolähteet voivat tarjota paljon tietoja käyttökokemuksen optimointiin.

Voit käyttää saraketason tietoja vahvistamaan käyttäjän syötteen ja antamaan käyttäjälle välitöntä palautetta ennen Patch-funktion käyttöä. Validate-funktio käyttää näitä samoja tietoja.

Voit käyttää tietoja tietolähdetasolla esimerkiksi Muokkaa- ja Uusi-painikkeiden poistamiseen käytöstä tai piilottamiseen, jos käyttäjillä ei ole oikeuksia muokata tai luoda uusia tietueita.

Tietolähteiden antamat tietomäärät vaihtelevat ja joissain tapauksissa tietoja ei saada yhtään. Kokoelmat eivät anna tietoja. Jos jotakin tietoa ei anneta, käytetään oletusta tai palautetaan tyhjä arvo.

Muistiinpano

Tällä hetkellä DataSourceInfo-funktiota ei tueta luetteloissa Microsoft .

Description

Sarakkeen tiedot

Voit käyttää DataSourceInfo-funktiota hakemaan tietoja tietolähteen tietystä sarakkeesta:

Tietoargumentti	Tuloksen tyyppi	Kuvaus
DataSourceInfo.DisplayName	Merkkijono	Näyttää sarakkeen nimen. Jos näyttönimeä ei ole määritetty, tämä palauttaa sarakkeen nimen.
DataSourceInfo.MaxLength	Luku	Sarakkeen sisältävien merkkien enimmäismäärä. Koskee vain sarakkeita, jotka sisältävät merkkijonoja. Jos enimmäismäärää ei ole asetettu, palauttaa tyhjän arvon.
DataSourceInfo.MaxValue	Luku	Suurin numeroarvo, jonka sarake voi sisältää. Koskee vain sarakkeita, jotka sisältävät numeroita. Jos enimmäismäärää ei ole asetettu, palauttaa tyhjän arvon.
DataSourceInfo.MinValue	Luku	Pienin numeroarvo, jonka sarake voi sisältää. Koskee vain sarakkeita, jotka sisältävät numeroita. Jos vähimmäismäärää ei ole asetettu, palauttaa tyhjän arvon.
DataSourceInfo.Pakollinen	Boolean	Vaaditaanko tälle sarakkeelle arvo? Jos tietolähde ei aseta tätä, palauttaa arvon false.

Kolmas argumentti on sarakkeen nimi merkkijonona. Esimerkiksi sarake Puhelin kokoelmassa Ihmiset välitettäisiin muodossa "Puhelin", mukaan lukien lainausmerkit.

Tietolähteen tiedot

Voit käyttää DataSourceInfo-funktiota hakemaan tietoja tietolähteestä kokonaisuutena:

Tietoargumentti	Tuloksen tyyppi	Kuvaus
DataSourceInfo.AllowedValues	Boolean	Mitä käyttöoikeuksia käyttäjille voidaan antaa tähän tietolähteeseen? Jos tietolähde ei aseta tätä, palauttaa tyhjän arvon.
DataSourceInfo.CreatePermission	Boolean	Onko nykyisellä käyttäjällä oikeus luoda tietueita tässä tietolähteessä? Jos tietolähde ei aseta tätä, palauttaa arvon true.
DataSourceInfo.DeletePermission	Boolean	Onko nykyisellä käyttäjällä oikeus poistaa tietueita tässä tietolähteessä? Jos tietolähde ei aseta tätä, palauttaa arvon true.
DataSourceInfo.EditPermission	Boolean	Onko nykyisellä käyttäjällä oikeus muokata tietueita tässä tietolähteessä? Jos tietolähde ei aseta tätä, palauttaa arvon true.
DataSourceInfo.ReadPermission	Boolean	Onko nykyisellä käyttäjällä oikeus lukea tietueita tässä tietolähteessä? Jos tietolähde ei aseta tätä, palauttaa arvon tosi.

Muistiinpano

DataSourceInfo palauttaa arvon true , jos se ei pysty määrittämään, onko nykyisellä käyttäjällä pyydetty käyttöoikeus. Palvelin tarkistaa oikeudet uudelleen, kun todellinen toiminto suoritetaan loppuun. Näkyviin tulee virhe, jos sitä ei sallita. Tällä hetkellä oikeuksien tarkistaminen DataSourceInfon avulla on mahdollista vain Microsoft Dataversea käytettäessä.

Syntaksi

DataSourceInfo(DataSource,Information [, ColumnName ] )

• Tietolähde – Pakollinen. Käytettävä tietolähde.
• Tiedot – Pakollinen. Haettavan tiedon tyyppi.
• ColumnName – Valinnainen. Sarakenimi, jolle noudetaan saraketason tietoja. ColumnName-argumenttia ei voi käyttää tietolähdetason tietoja varten.

Muistiinpano

Ennen Power Appsin versiota 3.24042 sarakenimet määritettiin tekstimerkkijonolla käyttäen lainausmerkkejä, ja jos ne oli yhdistetty tietolähteeseen, niiden oli oltava myös loogisia nimiä. Esimerkiksi looginen nimeä "cr43e_name" lainausmerkissä käytettiin näyttönimen lainausmerkittömän näyttönimen Nimi sijaan. SharePoint- ja Excel-tietolähetissä, jotka sisältävät välimerkillisiä sarakenimiä, jokaista välimerkkiä merkitsi "_x0020_". Tällöin esimerkiksi "Sarakkeen nimi" oli "Sarakkeen_x0020_nimi". Kyseisen version jälkeen kaikki sovellukset päivitettiin automaattisesti käyttämään tässä artikkelissa kuvattua uutta syntaksia.

Esimerkkejä

Tämän osion esimerkeissä käytetään tietolähdettä nimeltä IceCream:

Tietolähde on antanut myös nämä tiedot:

• Kohdan Quantity näyttönimi on "Quantity on Hand".
• Kohdan Flavor enimmäispituus on 30 merkkiä.
• Flavor-sarakkeen täytyy sisältää arvo. Quantity-sarake ei ole pakollinen.
• Quantity-kohdan vähimmäisarvo on 0.
• Quantity-kohdan enimmäisarvo on 100.
• Nykyinen käyttäjä voi lukea ja muokata IceCream-tietolähteen tietueita, mutta ei luoda tai poistaa tietueita.

Kaava	Kuvaus	Tulos
DataSourceInfo( Jäätelö, DataSourceInfo.DisplayName, määrä )	Palauttaa IceCream-tietolähteen Quantity-sarakkeen näyttönimen.	"Quantity on Hand"
DataSourceInfo (jäätelö, DataSourceInfo.MaxLength, maku)	Palauttaa IceCream-tietolähteen Flavor-sarakkeen merkkijonon enimmäispituuden.	30
DataSourceInfo(jäätelö, DataSourceInfo.Required, maku)	Onko IceCream-tietolähteen Flavor-sarake pakollinen?	tosi
DataSourceInfo( Jäätelö, DataSourceInfo.Required, määrä )	Onko IceCream-tietolähteen Quantity-sarake pakollinen?	väärä
DataSourceInfo( Jäätelö, DataSourceInfo.MaxValue, määrä )	Palauttaa IceCream-tietolähteen Quantity-sarakkeen enimmäisnumeroarvon.	100
DataSourceInfo( Jäätelö, DataSourceInfo.MinValue, määrä )	Palauttaa IceCream-tietolähteen Quantity-sarakkeen vähimmäisnumeroarvon.	0
DataSourceInfo( Jäätelö, DataSourceInfo.ReadPermission)	Voiko nykyinen käyttäjä lukea IceCream-tietolähteen tietueita?	tosi
DataSourceInfo( Jäätelö, DataSourceInfo.EditPermission)	Voiko nykyinen käyttäjä muokata IceCream-tietolähteen tietueita?	tosi
DataSourceInfo( Jäätelö, DataSourceInfo.CreatePermission)	Voiko nykyinen käyttäjä luoda IceCream-tietolähteen tietueita?	väärä
DataSourceInfo( Jäätelö, DataSourceInfo.DeletePermission)	Voiko nykyinen käyttäjä poistaa IceCream-tietolähteen tietueita?	väärä