Функцията DataSourceInfo
Отнася се за:
Приложения за платно Приложения, задвижвани от модели
Предоставя информация за източник на данни.
Преглед
Източниците на данни могат да предоставят богата информация за оптимизиране на потребителското изживяване.
Можете да използвате колона информация за ниво, за да валидира потребителския вход и да предостави незабавна обратна връзка на потребителя, преди да използва Patch функция. Функцията Validate използва същата информация.
Можете да използвате информация на ниво източник на данни, например, за да деактивирате или скриете редактиране и нов бутони за потребители, които нямат разрешения за редактиране и създаване записи.
Източниците на данни се различават по това колко информация предоставят, включително не предоставят такава изобщо. Колекции не предоставя информация. Ако част от информацията не е предоставена, се използва по подразбиране или празно се връща.
Бележка
Понастоящем функцията DataSourceInfo не се поддържа в Microsoft Lists.
Описание
Информация за колоната
Можете да използвате DataSourceInfo, за да получите информация за определена колона на източник на данни:
| Аргумент за информация | Тип резултат | Описание |
|---|---|---|
| DataSourceInfo.DisplayName | Низ | Показвано име за колоната. Ако не е определено име на дисплея, връща името на колоната. |
| DataSourceInfo.MaxLength | Номер | Максимален брой знаци, които колоната може да съдържа. Отнася се само за колони, които съдържат низове. Ако максимумът не е зададен, се връща празно. |
| DataSourceInfo.MaxValue | Номер | Максимална числова стойност, която може да съдържа колона. Отнася се само за колони, които съдържат числа. Ако максимумът не е зададен, се връща празно. |
| DataSourceInfo.MinValue | Номер | Минимална числова стойност, която може да съдържа колона. Отнася се само за колони, които съдържат числа. Ако минимумът не е зададен, се връща празно. |
| DataSourceInfo.Required | Булев | Задължителна ли е стойност за тази колона? Ако не е зададено от източник на данни, се връща невярно. |
Третият аргумент е името на колона като низ. Например колона телефон в колекция хора ще бъде приета като "Phone" включително двойните кавички.
Информация за източник на данни
Можете също да използвате DataSourceInfo, за да получите информация за източник на данни като цяло:
| Аргумент за информация | Тип резултат | Описание |
|---|---|---|
| DataSourceInfo.AllowedValues | Булев | Какви видове разрешения могат да бъдат предоставени на потребителите за този източник на данни? Ако не е зададено от източник на данни, се връща празно. |
| DataSourceInfo.CreatePermission | Булев | Настоящият потребител има ли разрешение да създава записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно. |
| DataSourceInfo.DeletePermission | Булев | Настоящият потребител има ли разрешение да изтрива записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно. |
| DataSourceInfo.EditPermission | Булев | Настоящият потребител има ли разрешение да редактира записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно. |
| DataSourceInfo.ReadPermission | Булев | Настоящият потребител има ли разрешение да чете записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно. |
Бележка
DataSourceInfo връща вярно, ако не може да определи дали настоящият потребител има исканото разрешение. Разрешенията ще бъдат проверени отново от сървъра, когато се извърши действителната операция и се покаже грешка, ако не е била разрешена. Понастоящем разрешенията се проверяват с DataSourceInfo е възможно само при използване на Microsoft Dataverse.
Синтаксис
DataSourceInfo(DataSource,Information [, ColumnName ] )
- DataSource – Задължително. Източникът на данни за използване.
- Information – Задължително. Типът информация, която искате да извлечете.
- ColumnName - По желание. Името на колоната, за която да се извлече информация на ниво колона. За информация на ниво източник на данни, аргументът ColumnName не може да се използва.
Бележка
Преди Power Apps версия 3.24042 имената на колоните се задаваха с текстов низ с двойни кавички, а ако са свързани с източник на данни, те също трябваше да бъдат логически имена. Например, логическото име "cr43e_name" с двойни кавички е използвано вместо показваното име Име без кавички. За SharePoint и Excel източници на данни, които съдържат имена на колони с интервали, всеки интервал е указан с "_x0020_", например "Име на колона" като "Column_x0020_Name". След тази версия всички приложения бяха автоматично актуализирани до новия синтаксис, описан в тази статия.
Примери
Примерите в този раздел използват този източник на данни, с име IceCream:
източник на данни също предостави тази информация:
- Екранното име за Quantity е "Количество на ръка".
- Максималната дължина на Flavor е 30 знака.
- Колоната Flavor трябва да съдържа стойност. Колоната количество не е задължителна.
- Минимумът количество е 0.
- Максимумът количество е 100.
- Настоящият потребител може да чете и редактира записите на IceCream източник на данни, но не може да създава или изтрива записи.
| Формула | Описание | Резултат |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo.DisplayName, количество ) | Връща името на дисплея за количество колоната на Сладолед източник на данни. | „Количество на склад” |
| DataSourceInfo( Сладолед, DataSourceInfo.MaxLength, аромат) | Връща максималната дължина на низа за Flavor колоната на Сладолед източник на данни. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, аромат) | Колоната вкус на Сладолед източник на данни изисква ли се? | вярно |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Количество) | Колоната Quantity на Сладолед източник на данни изисква ли се? | false |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, количество ) | Връща максималната числова стойност за количество колоната на Сладолед източник на данни. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, количество ) | Връща минималната числова стойност за количество колоната на Сладолед източник на данни. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Може ли текущият потребител да чете записи в Сладолед източник на данни? | вярно |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Може ли текущият потребител да редактира записи в Сладолед източник на данни? | вярно |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Може ли текущият потребител да създава записи в Сладолед източник на данни? | невярно |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Може ли текущият потребител да изтрива записи в Сладолед източник на данни? | невярно |