DataSourceInfo függvény
A következőkre vonatkozik:
Vászonalapú alkalmazások Modellvezérelt alkalmazások
Információkkal szolgál egy adatforrásról.
Áttekintés
Az adatforrások rengeteg információval szolgálhatnak a felhasználói élmény teljesebbé tételéhez.
Az oszlopszintű adatok segítségével ellenőrizheti a felhasználó által megadott adatokat, és azonnali visszajelzést küldhet neki a Patch függvény használata előtt. A Validate függvény ugyanezeket az adatokat használja.
Az információkat az adatforrás szintjén használhatja – például a Szerkesztés vagy az Új gomb letiltására vagy elrejtésére olyan felhasználóknál, akiknek nincs engedélye rekordokat szerkeszteni és létrehozni.
Az adatforrások által nyújtott információ mennyisége eltérő lehet. Az is lehetséges, hogy semmilyen információval nem szolgálnak. A Gyűjtemények nem szolgálnak információkkal. Ha nincs megadva egy adott információ, a rendszer az alapértelmezett értéket használja, vagy üres értéket ad vissza.
Feljegyzés
Jelenleg a DataSourceInfo függvény nem támogatott a Microsoft Lists szolgáltatásban.
Description
Oszlop adatai
A DataSourceInfo függvénnyel adatokat kérhet le az adatforrás egy adott oszlopából:
| Információs argumentum | Eredmény típusa | Ismertetés |
|---|---|---|
| DataSourceInfo.DisplayName | Karakterlánc | Az oszlop megjelenített neve. Ha nincs megadva megjelenített név, az oszlop nevét adja vissza. |
| DataSourceInfo.MaxLength | Szám | A karakterek maximális száma, amelyet az oszlop tartalmazhat. Csak sztringeket tartalmazó oszlopokra vonatkozik. Ha nincs beállítva maximális érték, üres értéket ad vissza. |
| DataSourceInfo.MaxValue | Szám | A numerikus értékek maximális száma, amelyet az oszlop tartalmazhat. Csak számokat tartalmazó oszlopokra vonatkozik. Ha nincs beállítva maximális érték, üres értéket ad vissza. |
| DataSourceInfo.MinValue | Szám | A numerikus értékek minimális száma, amelyet az oszlop tartalmazhat. Csak számokat tartalmazó oszlopokra vonatkozik. Ha nincs beállítva minimális érték, üres értéket ad vissza. |
| DataSourceInfo.Required | Boolean | Kötelező értéket megadni ebben az oszlopban? Ha az adatforrás nem állította be, false értéket ad vissza. |
A harmadik argumentum az oszlop neve sztringként. A rendszer az Emberek gyűjtemény Telefon oszlopát például "Telefon" néven adná át, idézőjelekkel együtt.
Adatforrás információi
A DataSourceInfo függvényt arra is használhatja, hogy adatokat kérjen le egy adatforrás egészéről:
| Információs argumentum | Eredmény típusa | Ismertetés |
|---|---|---|
| DataSourceInfo.AllowedValues | Boolean | Milyen típusú engedélyeket kaphatnak a felhasználók ehhez az adatforráshoz? Ha az adatforrás nem állította be, üres értéket ad vissza. |
| DataSourceInfo.CreatePermission | Boolean | Van az aktuális felhasználónak engedélye rekordok létrehozására ebben az adatforrásban? Ha az adatforrás nem állította be, true értéket ad vissza. |
| DataSourceInfo.DeletePermission | Boolean | Van az aktuális felhasználónak engedélye rekordok törlésére ebben az adatforrásban? Ha az adatforrás nem állította be, true értéket ad vissza. |
| DataSourceInfo.EditPermission | Boolean | Van az aktuális felhasználónak engedélye rekordok szerkesztésére ebben az adatforrásban? Ha az adatforrás nem állította be, true értéket ad vissza. |
| DataSourceInfo.ReadPermission | Boolean | Van az aktuális felhasználónak engedélye rekordok olvasására ebben az adatforrásban? Ha az adatforrás nem állította be, true értéket ad vissza. |
Feljegyzés
A DataSourceInfoigaz értéket ad vissza, ha nem tudja meghatározni, hogy az aktuális felhasználó rendelkezik-e a kért engedéllyel. A kiszolgáló újra ellenőrzi az engedélyeket, ha a tényleges műveletet végrehajtják, és akkor hibaüzenet jelenik meg, ha az nem engedélyezett. Jelenleg az engedélyek ellenőrzése a DataSourceInfo használatával csak a Microsoft Dataverse használata esetén lehetséges.
Szintaxis
DataSourceInfo( DataSource;Information [; ColumnName] )
- DataSource (Adatforrás) – kötelező. A használni kívánt adatforrás.
- Information – Kötelező. A lekérni kívánt információ típusa.
- ColumnName – Nem kötelező. Az oszlop neve, amelynek oszlopszintű adatait le szeretné kérni. Adatforrásszintű információknál a ColumnName argumentum nem használható.
Feljegyzés
A Power Apps 3.24042 verzió előtt az oszlopneveket idézőjelbe tett szöveges karakterlánccal adták meg, és ha adatforrás kapcsolódtak, logikai neveknek is kellett lenniük. Például a "cr43e_name" logikai nevet idézőjelek nélkül használtuk a megjelenítendő név Név idézőjelek nélkül. A szóközöket tartalmazó oszlopneveket tartalmazó Excel-adatforrások esetében SharePoint minden szóköz a "_x0020_" szóval lett megadva, például "Oszlopnév" mint "Column_x0020_Name". Ezt a verziót követően az összes alkalmazás automatikusan frissült a cikkben ismertetett új szintaxisra.
Példák
Az ebben a szakaszban látható példák a Jégkrém nevű adatforrást használják:
Az adatforrás az alábbi információkat biztosította:
- A Mennyiség megjelenített neve: „Meglévő mennyiség”.
- Az Íz maximális hossza 30 karakter.
- Az Íz oszlopnak tartalmaznia kell egy értéket. A Mennyiség oszlopot nem kötelező kitölteni.
- A Mennyiség minimális értéke 0.
- A Mennyiség maximális értéke 100.
- A jelenlegi felhasználó olvashatja és szerkesztheti a Jégkrém adatforrás rekordjait, de nem hozhat létre és nem törölhet rekordokat.
| Képlet | Ismertetés | Eredmény |
|---|---|---|
| DataSourceInfo( Jégkrém, DataSourceInfo.DisplayName, mennyiség ) | A Jégkrém adatforrás Mennyiség oszlopának megjelenített nevét adja vissza. | „Meglévő mennyiség” |
| DataSourceInfo( Fagylalt, DataSourceInfo.MaxLength, Íz ) | A Jégkrém adatforrás Íz oszlopának maximális sztringhosszát adja vissza. | 30 |
| DataSourceInfo( Fagylalt, DataSourceInfo.Required, Íz ) | Kötelező kitölteni a Jégkrém adatforrás Íz oszlopát? | true |
| DataSourceInfo( Jégkrém, DataSourceInfo.Required, mennyiség ) | Kötelező kitölteni a Jégkrém adatforrás Mennyiség oszlopát? | false |
| DataSourceInfo( Jégkrém, DataSourceInfo.MaxValue, Mennyiség ) | A Jégkrém adatforrás Mennyiség oszlopának maximális numerikus értékét adja vissza. | 100 |
| DataSourceInfo( Jégkrém, DataSourceInfo.MinValue, Mennyiség ) | A Jégkrém adatforrás Mennyiség oszlopának minimális numerikus értékét adja vissza. | 0 |
| DataSourceInfo( Jégkrém, DataSourceInfo.ReadPermission) | Olvashatja a jelenlegi felhasználó a Jégkrém adatforrás rekordjait? | true |
| DataSourceInfo( Jégkrém, DataSourceInfo.EditPermission) | Szerkesztheti a jelenlegi felhasználó a Jégkrém adatforrás rekordjait? | true |
| DataSourceInfo( Jégkrém, DataSourceInfo.CreatePermission) | Létrehozhat a jelenlegi felhasználó rekordokat a Jégkrém adatforrásban? | false |
| DataSourceInfo( Jégkrém, DataSourceInfo.DeletePermission) | Törölhet a jelenlegi felhasználó rekordokat a Jégkrém adatforrásból? | false |