DataSourceInfo функція

Застосовується до: Програми canvas Model-driven

Забезпечення відомостей про джерела даних.

Зведення

Джерела даних можуть забезпечувати величезний об’єм інформації для оптимізації роботи користувача.

Можна використовувати відомості на рівні стовпця для перевірки введених даних та негайного сповіщення користувача перед застосуванням функції Patch. Для функції Validate використовуються ті самі відомості.

Можна використовувати відомості на рівні джерела даних, щоб, наприклад, вимкнути кнопки Редагувати та Створити або приховати їх від користувачів без дозволів на редагування та створення записів.

Джерела даних відрізняються одне від одного за об’ємом інформації, яку вони надають (включно з випадками відсутності будь-якої інформації). У колекціях немає жодної інформації. Якщо фрагмент даних не надається, використовується значення за замовчуванням або повертається пусте значення.

Нотатка

DataSourceInfo Наразі функція не підтримується у списках Microsoft.

Опис

Відомості про стовпець

Використовується DataSourceInfo для отримання відомостей про певний стовпець джерела даних:

Аргумент для отримання відомостей	Тип результату	Опис
DataSourceInfo. Коротке ім'я	Рядок	Коротке ім’я стовпця. Якщо коротке ім’я не визначено, повертає ім’я стовпця.
DataSourceInfo. MaxLength (Максимальна довжина)	Номер	Максимальна кількість символів, яку може містити стовпець. Застосовується лише до стовпців, що містять рядки. Якщо максимальне значення не встановлено, повертає пусте значення.
DataSourceInfo. Максимальне значення	Номер	Максимальне числове значення, яке може містити стовпець. Застосовується лише до стовпців, що містять числа. Якщо максимальне значення не встановлено, повертає пусте значення.
DataSourceInfo. Мінімальне значення	Номер	Мінімальне числове значення, яке може містити стовпець. Застосовується лише до стовпців, що містять числа. Якщо мінімальне значення не встановлено, повертає пусте значення.
DataSourceInfo. Необхідний	логічний	Указує, чи потрібне значення для стовпця. Якщо не задано джерелом даних, повертає значення false.

Третій аргумент – це ім’я стовпця як рядка. Наприклад, стовпець Phone (Телефон) у колекції People (Люди) передаватиметься як "Phone", включно з подвійними лапками.

Відомості про джерело даних

Ви також можете отримати DataSourceInfo відомості про джерело даних в цілому:

Аргумент для отримання відомостей	Тип результату	Опис
DataSourceInfo. Дозволені значення	логічний	Указує на типи дозволів, які можуть бути надані користувачам щодо джерела даних. Якщо не задано джерелом даних, повертає пусте значення.
DataSourceInfo. Створити ремісію	логічний	Указує, чи має поточний користувач дозвіл на створення записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.
DataSourceInfo. Видалити з експлуатації	логічний	Указує, чи має поточний користувач дозвіл на видалення записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.
DataSourceInfo. Редагувати ремісію	логічний	Указує, чи має поточний користувач дозвіл на редагування записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.
DataSourceInfo. ReadPermission (Читання)	логічний	Указує, чи має поточний користувач дозвіл на читання записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.

Нотатка

DataSourceInfo повертає значення true , якщо не може визначити, чи має поточний користувач потрібний дозвіл. Після виконання фактичної операції та відображення повідомлення про помилку сервер знову перевірить дозволи, якщо дозволу не було. Наразі перевірка DataSourceInfo дозволів доступна лише в разі використання Microsoft Dataverse.

Синтаксис

DataSourceInfo( DataSource, Information [, ColumnName] )

• Джерело даних– Обов’язковий. Джерело даних для використання.
• Інформація – обов’язкова. Тип відомостей, які потрібно отримати.
• ColumnName – необов’язковий. Ім’я стовпця, для якого потрібно отримати інформацію на рівні стовпця. Аргумент ColumnName не використовується для відомостей на рівні джерела даних.

Нотатка

У Power Apps версії 3.24042 назви колонок вказувалися за допомогою текстового рядка з використанням подвійних лапок, а якщо підключити до джерело даних, то вони також повинні були бути логічними іменами. Наприклад, замість відображуваного імені Ім’я без лапок було використано логічне ім’я "cr43e_name " з подвійними лапками . Для SharePoint джерел даних і джерел даних Excel, які містять імена стовпців із пробілами, кожен пробіл було вказано за допомогою "_x0020_", наприклад "Ім’я стовпця" як "Column_x0020_Name". Після цієї версії всі програми були автоматично оновлені до нового синтаксису, описаного в цій статті.

Приклади

У прикладах із цього розділу використовується нижченаведене джерело даних з ім’ям IceCream (Морозиво).

Джерело даних також забезпечило такі відомості.

• Коротким іменем стовпця Quantity (Кількість) є «Quantity on Hand» (Фактична наявність).
• Максимальна довжина значення у стовпці Flavor (Смак) складає 30 символів.
• Стовпець Flavor має містити значення. Стовпець Quantity не є обов’язковим.
• Мінімальне значення для стовпця Quantity: 0.
• Максимальне значення для стовпця Quantity: 100.
• Поточний користувач може читати та редагувати записи джерела даних IceCream, але не може створювати або видаляти їх.

Формула	Опис	Результат
DataSourceInfo( IceCream, DataSourceInfo. DisplayName, Quantity )	Повертає коротке ім’я для стовпця Quantity джерела даних IceCream.	"Кількість під рукою"
DataSourceInfo( IceCream, DataSourceInfo. MaxLength, Flavor )	Повертає значення максимальної довжини рядка для стовпця Flavor джерела даних IceCream.	30
DataSourceInfo( IceCream, DataSourceInfo. Обов'язковий, Аромат )	Указує, чи є обов’язковим стовпець Flavor джерела даних IceCream.	Справжній
DataSourceInfo( IceCream, DataSourceInfo. Обов'язковий, кількість )	Указує, чи є обов’язковим стовпець Quantity джерела даних IceCream.	Брехня
DataSourceInfo( IceCream, DataSourceInfo. MaxValue, Quantity )	Повертає максимальне числове значення для стовпця Quantity джерела даних IceCream.	100
DataSourceInfo( IceCream, DataSourceInfo. MinValue, Quantity )	Повертає мінімальне числове значення для стовпця Quantity джерела даних IceCream.	0
DataSourceInfo( IceCream, DataSourceInfo. ReadPermission)	Указує, чи може поточний користувач читати записи у джерелі даних IceCream.	Справжній
DataSourceInfo( IceCream, DataSourceInfo. Редагуватипермісію)	Указує, чи може поточний користувач редагувати записи у джерелі даних IceCream.	Справжній
DataSourceInfo( IceCream, DataSourceInfo. Створитипермісію)	Указує, чи може поточний користувач створювати записи у джерелі даних IceCream.	Брехня
DataSourceInfo( IceCream, DataSourceInfo. Видалитипермісію)	Указує, чи може поточний користувач видаляти записи у джерелі даних IceCream.	Брехня