Поділитися через

Функція DataSourceInfo

  • Стаття

Застосовується до: програм Canvas Програм на основі моделі

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

Зведення

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

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

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

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

Нотатка

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

Опис

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

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

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

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

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

Функцією DataSourceInfo також можна скористатися для отримання відомостей про певне джерело даних у цілому.

Аргумент для отримання відомостей Тип результату Опис
DataSourceInfo.AllowedValues Логічне значення Указує на типи дозволів, які можуть бути надані користувачам щодо джерела даних. Якщо не задано джерелом даних, повертає пусте значення.
DataSourceInfo.CreatePermission Логічне значення Указує, чи має поточний користувач дозвіл на створення записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.
DataSourceInfo.DeletePermission Логічне значення Указує, чи має поточний користувач дозвіл на видалення записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.
DataSourceInfo.EditPermission Логічне значення Указує, чи має поточний користувач дозвіл на редагування записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.
DataSourceInfo.ReadPermission Логічне значення Указує, чи має поточний користувач дозвіл на читання записів у джерелі даних. Якщо не задано джерелом даних, повертає значення true.

Нотатка

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

Синтаксис

DataSourceInfo( Джерело даних, Інформація [, 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( Морозиво, DataSourceInfo.DisplayName, кількість ) Повертає коротке ім’я для стовпця Quantity джерела даних IceCream. "Quantity on Hand"
DataSourceInfo( Морозиво, DataSourceInfo.MaxLength, Смак ) Повертає значення максимальної довжини рядка для стовпця Flavor джерела даних IceCream. 30
DataSourceInfo( Морозиво, DataSourceInfo.Required, Смак ) Указує, чи є обов’язковим стовпець Flavor джерела даних IceCream. Справжній
DataSourceInfo( Морозиво, DataSourceInfo.Required, кількість ) Указує, чи є обов’язковим стовпець Quantity джерела даних IceCream. Брехня
DataSourceInfo( Морозиво, DataSourceInfo.MaxValue, кількість ) Повертає максимальне числове значення для стовпця Quantity джерела даних IceCream. 100
DataSourceInfo( Морозиво, DataSourceInfo.MinValue, кількість ) Повертає мінімальне числове значення для стовпця Quantity джерела даних IceCream. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Указує, чи може поточний користувач читати записи у джерелі даних IceCream. Справжній
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Указує, чи може поточний користувач редагувати записи у джерелі даних IceCream. Справжній
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Указує, чи може поточний користувач створювати записи у джерелі даних IceCream. Брехня
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Указує, чи може поточний користувач видаляти записи у джерелі даних IceCream. Брехня