Funkcija DataSourceInfo

  • Raksts

Attiecas uz: Pamatnes programmām Modeļa vadītas programmas

Nodrošina informāciju par datu avotu.

Pārskats

Datu avoti var sniegt daudz informācijas, lai optimizētu lietotāja pieredzi.

Varat izmantot kolonnas līmeņa informāciju, lai validētu lietotāja ievadi un nodrošinātu tūlītējas atsauksmes lietotājam, pirms izmantojat Patch funkciju. Validate funkcija izmanto to pašu informāciju.

Varat izmantot informāciju datu avota līmenī, piemēram, lai atspējotu vai slēptu pogas Rediģēt un Jauns lietotājiem, kuriem nav atļauju rediģēt un izveidot ierakstus.

Datu avoti atšķiras pēc tā, cik daudz informācijas tie nodrošina, tostarp nesniedzot vispār nekādu informāciju. Kolekcijas nesniedz nekādu informāciju. Ja informācija netiek sniegta, tiek izmantots noklusējums vai tiek atgriezta tukša vērtība.

Note

Patlaban funkcija DataSourceInfo nav atbalstīta pakalpojumā Microsoft Lists.

Apraksts

Informācija par kolonnu

Funkciju DataSourceInfo varat izmantot, lai iegūtu informāciju par konkrētu datu avota kolonnu:

Informācijas arguments Rezultāta tips Apraksts
DataSourceInfo.DisplayName Virkne Kolonnas parādāmais nosaukums Ja netiek definēts parādāmais nosaukum, atgriež kolonnas nosaukumu.
DataSourceInfo.MaxLength Numurs Maksimālais rakstzīmju skaits, ko var saturēt kolonna. Attiecas tikai uz kolonnām, kurās ir virknes. Ja nav iestatīts maksimums, atgriež tukšu.
DataSourceInfo.MaxValue Numurs Maksimālā skaitliskā vērtība, kuru var saturēt kolonna. Attiecas tikai uz kolonnām, kurās ir skaitļi. Ja nav iestatīts maksimums, atgriež tukšu.
DataSourceInfo.MinValue Numurs Minimālā skaitliskā vērtība, kuru var saturēt kolonna. Attiecas tikai uz kolonnām, kurās ir skaitļi. Ja nav iestatīts minimums, atgriež tukšu.
DataSourceInfo.Required Būla vērtība Vai šai kolonnai ir nepieciešama vērtība? Ja datu avots nav iestatījis, atgriež false.

Trešais arguments ir kolonnas nosaukums kā virkne. Piemēram, kolonnu Tālrunis kolekcijā Personas padotu kā "Tālrunis", ieskaitot pēdiņas.

Datu avota informācija

Funkciju DataSourceInfo varat arī izmantot, lai iegūtu informāciju par visu datu avotu:

Informācijas arguments Rezultāta tips Apraksts
DataSourceInfo.AllowedValues Būla vērtība Kāda veida atļaujas lietotājiem var piešķirt attiecībā uz šo datu avotu? Ja datu avots nav iestatījis, atgriež tukšu.
DataSourceInfo.CreatePermission Būla vērtība Vai pašreizējam lietotājam ir atļauja izveidot ierakstus šajā datu avotā? Ja datu avots nav iestatījis, atgriež true.
DataSourceInfo.DeletePermission Būla vērtība Vai pašreizējam lietotājam ir atļauja dzēst ierakstus šajā datu avotā? Ja datu avots nav iestatījis, atgriež true.
DataSourceInfo.EditPermission Būla vērtība Vai pašreizējam lietotājam ir atļauja rediģēt ierakstus šajā datu avotā? Ja datu avots nav iestatījis, atgriež true.
DataSourceInfo.ReadPermission Būla vērtība Vai pašreizējam lietotājam ir atļauja lasīt ierakstus šajā datu avotā? Ja datu avots nav iestatījis, atgriež true.

Note

DataSourceInfo atgriež vērtību patiess, ja tas nevar noteikt, vai pašreizējam lietotājam ir pieprasītā atļauja. Serveris atkal pārbaudīs atļaujas, kad tiek veikta faktiskā operācija, un tiks parādīta kļūda, ja tā nav atļauta. Šobrīd atļauju pārbaude ar DataSourceInfo ir iespējama tikai tad, ja izmantojat Microsoft Dataverse.

Sintakse

DataSourceInfo(DataSource,Information [, ColumnName ] )

  • DataSource – Obligāti. Lietojamais datu avots.
  • Informācija — Obligāti. Informācijas veids, kuru vēlaties izgūt.
  • ColumnName — Neobligāti. Kolonnas nosaukums, kuram jāizgūst kolonnas līmeņa informācija. Informācijai datu avota līmenī argumentu ColumnName nevar izmantot.

Piezīmes

Pirms Power Apps versijas 3.24042 kolonnu nosaukumi tika norādīti ar teksta virkni, izmantojot dubultās pēdiņas, un, ja tie ir savienoti ar datu avots, tiem bija jābūt arī loģiskiem nosaukumiem. Piemēram, parādāmā vārda vietā tika izmantots loģiskais nosaukums "cr43e_name" ar dubultām pēdiņām Vārds bez pēdiņām. Datu SharePoint avotiem Excel un Excel, kuros ir kolonnu nosaukumi ar atstarpēm, katra atstarpe tika norādīta ar "_x0020_", piemēram "Kolonnas nosaukums"kā"Column_x0020_Name". Pēc šīs versijas visas programmas tika automātiski atjauninātas uz jauno sintaksi, kas aprakstīta šajā rakstā.

Piemēri

Šīs sadaļas piemēros tiek izmantots šis datu avots ar nosaukumu IceCream:

Icecream piemērs.

Datu avots ir sniedzis arī šādu informāciju:

  • Daudzuma parādāmais nosaukums ir "Pieejamais daudzums".
  • Maksimālais Garšas garums ir 30 rakstzīmes.
  • Kolonnā Garša ir jābūt vērtībai. Kolonna Daudzums nav obligāta.
  • Minimālais Daudzums ir 0.
  • Maksimālais Daudzums ir 100.
  • Pašreizējais lietotājs var lasīt un rediģēt datu avota IceCream ierakstus, taču nevar ierakstus izveidot vai dzēst.
Formula Apraksts Rezultāts
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity ) Atgriež parādāmo nosaukumu datu avota IceCream kolonnai Daudzums. "Pieejamais daudzums"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor ) Atgriež virknes maksimālo garumu datu avota IceCream kolonnai Garša. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) Vai datu avota IceCream kolonna Garša ir obligāta? patiess
DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity ) Vai datu avota IceCream kolonna Daudzums ir obligāta? aplams
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity ) Atgriež maksimālo skaitlisko vērtību datu avota IceCream kolonnai Daudzums. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity ) Atgriež minimālo skaitlisko vērtību datu avota IceCream kolonnai Daudzums. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Vai pašreizējais lietotājs lasa ierakstus datu avotā IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Vai pašreizējais lietotājs rediģē ierakstus datu avotā IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Vai pašreizējais lietotājs var izveidot ierakstus datu avotā IceCream? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Vai pašreizējais lietotājs var dzēst ierakstus datu avotā IceCream? false