Функция DataSourceInfo

Применимо к: Приложениям Canvas Приложениям, управляемым моделями

Содержит сведения об источнике данных.

Обзор

Источники данных могут предоставлять разнообразные сведения для оптимизации взаимодействия с пользователем.

Перед применением функции Patch можно использовать сведения на уровне столбца, чтобы проверить данные, вводимые пользователем, и немедленно предоставить пользователю обратную связь. Функция Validate использует эти же сведения.

Сведения на уровне источника данных можно использовать, например, для отключения или скрытия от пользователей кнопок Изменить и Создать, если у этих пользователей нет разрешений на изменение и создание записей.

Источники данных различаются по объему предоставляемых сведений, включая возможность не предоставлять их совсем. Коллекции не предоставляют никакой информации. Если не предоставляется часть сведений, то используется значение по умолчанию или возвращается пустое значение.

Заметка

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

Description

Сведения о столбце

Функцию DataSourceInfo можно использовать для получения сведений о конкретном столбце источника данных:

Аргумент сведений	Тип результата	Описание
DataSourceInfo.Отображаемое имя	String	Отображаемое имя столбца. Если отображаемое имя не определяется, то возвращается имя столбца.
DataSourceInfo.MaxLength	Номер	Максимальное количество знаков, которое может содержать столбец. Применимо только к столбцам, содержащим строки. Если максимальное значение не задано, то возвращается пустое значение.
DataSourceInfo.MaxValue	Номер	Максимальное числовое значение, которое может содержать столбец. Применимо только к столбцам, содержащим числа. Если максимальное значение не задано, то возвращается пустое значение.
DataSourceInfo.Минимальное значение	Номер	Минимальное числовое значение, которое может содержать столбец. Применимо только к столбцам, содержащим числа. Если минимальное значение не задано, то возвращается пустое значение.
DataSourceInfo.Обязательно	Boolean	Требуется ли значение для этого столбца? Если значение не задано источником данных, то возвращается ответ false.

Третий аргумент — это имя столбца в виде строки. Например, столбец Phone в коллекции People будет передаваться как "Phone" (включая двойные кавычки).

Сведения об источнике данных

Функцию DataSourceInfo можно также использовать для получения сведений об источнике данных в целом:

Аргумент сведений	Тип результата	Описание
DataSourceInfo.Разрешенные значения	Boolean	Какие разрешения для этого источника данных могут предоставляться пользователям? Если значение не задано источником данных, то возвращается пустое значение.
DataSourceInfo.CreatePermission	Boolean	Имеет ли текущий пользователь разрешение на создание записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.
DataSourceInfo.DeletePermission	Boolean	Имеет ли текущий пользователь разрешение на удаление записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.
DataSourceInfo.EditPermission	Boolean	Имеет ли текущий пользователь разрешение на изменение записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.
DataSourceInfo.ReadPermission	Boolean	Имеет ли текущий пользователь разрешение на чтение записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.

Заметка

DataSourceInfo возвращает true если не может определить, имеет ли текущий пользователь запрошенное разрешение. Разрешения будут снова проверяться сервером при выполнении фактической операции, и отображается ошибка, если она не была разрешена. В настоящее время проверка разрешений с помощью DataSourceInfo возможна только при использовании Microsoft Dataverse.

Синтаксис

DataSourceInfo( Источник данных, Информация [, Имя столбца] )

• Источник данных – обязателен. Источник данных, который необходимо использовать.
• Информация – Обязательно. Тип сведений, которые требуется получить.
• ColumnName – Необязательно. Имя столбца, для которого нужно получить информацию на уровне столбца. Для сведений на уровне источника данных аргумент ColumnName не может использоваться.

Заметка

В Power Apps до версии 3.24042 имена столбцов задавались текстовой строкой с использованием двойных кавычек, а при подключении к источнику данных они также должны были быть логическими именами. Например, вместо отображаемого имени Имя без кавычек использовалось логическое имя "cr43e_name" в двойных кавычках. Для источников данных SharePoint и Excel, содержащих имена столбцов с пробелами, каждый пробел был указан с помощью "_x0020_", например "Имя столбца" как "Имя_x0020_столбца". После этой версии все приложения были автоматически обновлены до нового синтаксиса, описанного в этой статье.

Примеры

Примеры в этом разделе используют следующий источник данных с именем 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)	Возвращает максимальную длину строки для столбца Flavor источника данных IceCream.	30
DataSourceInfo(Мороженое, DataSourceInfo.Обязательно, Вкус)	Является ли столбец Flavor источника данных IceCream обязательным?	истинный
DataSourceInfo(Мороженое, DataSourceInfo.Требуется, Количество)	Является ли столбец 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?	ЛОЖЬ