DataSourceInfo функция

Отнася се за: Приложения за платно, базирани на модел приложения

Предоставя информация за източник на данни.

Преглед

Източниците на данни могат да предоставят богата информация за оптимизиране на потребителското изживяване.

Можете да използвате колона информация за ниво, за да валидира потребителския вход и да предостави незабавна обратна връзка на потребителя, преди да използва Patch функция. Функцията Validate използва същата информация.

Можете да използвате информация на ниво източник на данни, например, за да деактивирате или скриете редактиране и нов бутони за потребители, които нямат разрешения за редактиране и създаване записи.

Източниците на данни се различават по това колко информация предоставят, включително не предоставят такава изобщо. Колекциите не предоставят информация. Ако част от информацията не е предоставена, се използва по подразбиране или празно се връща.

Бележка

В момента функцията DataSourceInfo не се поддържа в списъци на Microsoft.

Описание

Информация за колоната

Можете да използвате DataSourceInfo , за да получите информация за определена колона на източник на данни:

Аргумент за информация	Тип резултат	Описание
DataSourceInfo. DisplayName	Низ	Показвано име за колоната. Ако не е определено име на дисплея, връща името на колоната.
DataSourceInfo. MaxLength	Номер	Максимален брой знаци, които колоната може да съдържа. Отнася се само за колони, които съдържат низове. Ако максимумът не е зададен, се връща празно.
DataSourceInfo. Максимална стойност	Номер	Максимална числова стойност, която може да съдържа колона. Отнася се само за колони, които съдържат числа. Ако максимумът не е зададен, се връща празно.
DataSourceInfo. MinValue	Номер	Минимална числова стойност, която може да съдържа колона. Отнася се само за колони, които съдържат числа. Ако минимумът не е зададен, се връща празно.
DataSourceInfo. Изисква	булев	Задължителна ли е стойност за тази колона? Ако не е зададено от източник на данни, се връща невярно.

Третият аргумент е името на колона като низ. Например колона телефон в колекция хора ще бъде приета като "Phone" включително двойните кавички.

Информация за източник на данни

Можете също да използвате DataSourceInfo , за да получите информация за даден източник на данни като цяло:

Аргумент за информация	Тип резултат	Описание
DataSourceInfo. Разрешени стойности	булев	Какви видове разрешения могат да бъдат предоставени на потребителите за този източник на данни? Ако не е зададено от източник на данни, се връща празно.
DataSourceInfo. Създаване на команда	булев	Настоящият потребител има ли разрешение да създава записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно.
DataSourceInfo. Изтриване на команда	булев	Настоящият потребител има ли разрешение да изтрива записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно.
DataSourceInfo. Редактиране на съобщение	булев	Настоящият потребител има ли разрешение да редактира записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно.
DataSourceInfo. Обратно приемане	булев	Настоящият потребител има ли разрешение да чете записи в този източник на данни? Ако не е зададено от източник на данни, се връща вярно.

Бележка

DataSourceInfo връща "истина" , ако не може да определи дали текущият потребител има исканото разрешение. Разрешенията ще бъдат проверени отново от сървъра, когато се извърши действителната операция и се покаже грешка, ако не е била разрешена. В момента проверката DataSourceInfo на разрешенията е възможна само когато се използва Microsoft Dataverse.

Синтаксис

DataSourceInfo( DataSource, Information [, ColumnName] )

• Източник на данни – Задължително. Източникът на данни за използване.
• Информация – Задължително. Типът информация, която искате да извлечете.
• ColumnName – По избор. Името на колоната, за която да се извлече информация на ниво колона. За информация на ниво източник на данни, аргументът ColumnName не може да се използва.

Бележка

Преди Power Apps версия 3.24042 имената на колоните се задават с текстов низ с помощта на двойни кавички и ако са свързани с източник на данни те също трябва да бъдат логически имена. Например логическото име "cr43e_name" с двойни кавички е използвано вместо показваното име Име без кавички. За SharePoint и източници на данни на Excel, които съдържат имена на колони с интервали, всяко пространство е посочено с "_x0020_", например "Име на колона" като "Column_x0020_Name". След тази версия всички приложения бяха автоматично актуализирани до новия синтаксис, описан в тази статия.

Примери

Примерите в този раздел използват този източник на данни, с име IceCream:

източник на данни също предостави тази информация:

• Екранното име за Quantity е "Количество на ръка".
• Максималната дължина на Flavor е 30 знака.
• Колоната Flavor трябва да съдържа стойност. Колоната количество не е задължителна.
• Минимумът количество е 0.
• Максимумът количество е 100.
• Настоящият потребител може да чете и редактира записите на IceCream източник на данни, но не може да създава или изтрива записи.

Формула	Описание	Резултат
DataSourceInfoНе, не DataSourceInfo DisplayName, количество )	Връща името на дисплея за количество колоната на Сладолед източник на данни.	„Количество на склад”
DataSourceInfoНе, не DataSourceInfo MaxLength, Вкус )	Връща максималната дължина на низа за Flavor колоната на Сладолед източник на данни.	30
DataSourceInfoНе, не DataSourceInfo Задължително, вкус )	Колоната вкус на Сладолед източник на данни изисква ли се?	верен
DataSourceInfoНе, не DataSourceInfo Задължително, количество )	Колоната Quantity на Сладолед източник на данни изисква ли се?	невярно
DataSourceInfoНе, не DataSourceInfo MaxValue, Количество )	Връща максималната числова стойност за количество колоната на Сладолед източник на данни.	100
DataSourceInfoНе, не DataSourceInfo MinValue, Количество )	Връща минималната числова стойност за количество колоната на Сладолед източник на данни.	0
DataSourceInfoНе, не DataSourceInfo обратно приемане)	Може ли текущият потребител да чете записи в Сладолед източник на данни?	верен
DataSourceInfoНе, не DataSourceInfo EditPermission)	Може ли текущият потребител да редактира записи в Сладолед източник на данни?	верен
DataSourceInfoНе, не DataSourceInfo CreatePermission)	Може ли текущият потребител да създава записи в Сладолед източник на данни?	невярно
DataSourceInfoНе, не DataSourceInfo DeletePermission)	Може ли текущият потребител да изтрива записи в Сладолед източник на данни?	невярно