Funkcija DataSourceInfo

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

Pašlaik funkcija DataSourceInfo sarakstos netiek atbalstīta Microsoft .

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 true , ja tā 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āts. Lietojamais datu avots.
• Informācija – Obligāts. 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:

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?	nepatiess
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?	patiess
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)	Vai pašreizējais lietotājs rediģē ierakstus datu avotā IceCream?	patiess
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)	Vai pašreizējais lietotājs var izveidot ierakstus datu avotā IceCream?	nepatiess
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)	Vai pašreizējais lietotājs var dzēst ierakstus datu avotā IceCream?	nepatiess