DataSourceInfo funkcija programmā Power Apps

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.

Piezīme

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

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.

Piezīme

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 līmeņa informācijai kolonnas nosaukums ir virkne. Kolonna Tālrunis tika padota kā "Tālrunis", ieskaitot pēdiņas. Informācijai datu avota līmenī argumentu ColumnName nevar izmantot.

    Piezīme

    SharePoint un Excel datu avotos, kuros ir kolonnu nosaukumi ar atstarpēm, norādiet katru atstarpi kā "_x0020_". Piemēram, norādiet Kolonnas nosaukumu"Column_x0020_Name".

Piemēri

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

Piemērs ar saldējumu.

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, "Daudzums" ) Atgriež parādāmo nosaukumu datu avota IceCream kolonnai Daudzums. "Pieejamais daudzums"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Garša" ) Atgriež virknes maksimālo garumu datu avota IceCream kolonnai Garša. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, "Garša" ) Vai datu avota IceCream kolonna Garša ir obligāta? true
DataSourceInfo( IceCream, DataSourceInfo.Required, "Daudzums" ) Vai datu avota IceCream kolonna Daudzums ir obligāta? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Daudzums" ) Atgriež maksimālo skaitlisko vērtību datu avota IceCream kolonnai Daudzums. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Daudzums" ) 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

Piezīme

Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)

Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).