DataSourceInfo-funktio
Soveltuu:
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 Microsoft-luetteloissa.
Kuvaus
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.Required | 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 tosi-arvon, jos se ei voi määrittää, onko nykyinen käyttäjä pyytänyt oikeutta. 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] )
- DataSource – Pakollinen. Käytettävä tietolähde.
- Information – 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( IceCream, DataSourceInfo.DisplayName, Quantity ) | Palauttaa IceCream-tietolähteen Quantity-sarakkeen näyttönimen. | "Quantity on Hand" |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor ) | Palauttaa IceCream-tietolähteen Flavor-sarakkeen merkkijonon enimmäispituuden. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) | Onko IceCream-tietolähteen Flavor-sarake pakollinen? | true |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity ) | Onko IceCream-tietolähteen Quantity-sarake pakollinen? | false |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity ) | Palauttaa IceCream-tietolähteen Quantity-sarakkeen enimmäisnumeroarvon. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity ) | Palauttaa IceCream-tietolähteen Quantity-sarakkeen vähimmäisnumeroarvon. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Voiko nykyinen käyttäjä lukea IceCream-tietolähteen tietueita? | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Voiko nykyinen käyttäjä muokata IceCream-tietolähteen tietueita? | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Voiko nykyinen käyttäjä luoda IceCream-tietolähteen tietueita? | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Voiko nykyinen käyttäjä poistaa IceCream-tietolähteen tietueita? | false |