Megosztás a következőn keresztül:

DataSourceInfo függvény

  • Cikk

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 nyújtanak információt. Ha nincs megadva egy adott információ, a rendszer az alapértelmezett értéket használja, vagy üres értéket ad vissza.

Feljegyzés

A DataSourceInfo függvény jelenleg nem támogatott a listákban Microsoft .

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 DataSourceInfo igaz értéket ad vissza , ha nem tudja megállapítani, 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 – Kötelező. A használni kívánt adatforrás.
  • Információ – 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:

Fagylalt példa.

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? igaz
DataSourceInfo( Jégkrém, DataSourceInfo.Required, mennyiség ) Kötelező kitölteni a Jégkrém adatforrás Mennyiség oszlopát? téves
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? igaz
DataSourceInfo( Jégkrém, DataSourceInfo.EditPermission) Szerkesztheti a jelenlegi felhasználó a Jégkrém adatforrás rekordjait? igaz
DataSourceInfo( Jégkrém, DataSourceInfo.CreatePermission) Létrehozhat a jelenlegi felhasználó rekordokat a Jégkrém adatforrásban? téves
DataSourceInfo( Jégkrém, DataSourceInfo.DeletePermission) Törölhet a jelenlegi felhasználó rekordokat a Jégkrém adatforrásból? téves