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


Набор данных

Предоставляет свойства и методы для работы с данными в сетках и представлениях.

Доступно для

Приложения на основе модели и холста.

Свойства

columns

Набор столбцов, доступных в этом наборе данных. Поддерживается как в приложениях на основе модели, так и на основе холста.

Тип: столбец[]

ошибка

Произошла ли ошибка при извлечении данных. Поддерживается как в приложениях на основе модели, так и на основе холста.

Тип: boolean

Код ошибки

Код ошибки, связанный с последней обнаруженной ошибкой, если применимо.

errorMessage

Сообщение об ошибке, связанное с последней обнаруженной ошибкой, если применимо.

Тип: number | string

фильтрация

Фильтрация столбцов для текущего запроса. Поддерживается как в приложениях на основе модели, так и на основе холста. Фильтрация может быть настроена для набора данных с помощью параметра context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>). После установки фильтра вызов context.parameters.[dataset_property_name].refresh() извлекает отфильтрованные данные из источника данных.

Ценность Условный оператор Приложения на основе моделей Приложения холста
-1 None Да Да
0 Equal Да Да
1 NotEqual Да Да
2 GreaterThan Да Да
3 LessThan Да Да
4 GreaterEqual Да Да
5 LessEqual Да Да
6 Нравиться Да Да
7 NotLike нет Да
8 In Да Да
12 Null Да Да
13 NotNull нет Да
14 Вчера Да нет
15 Сегодня Да нет
16 Завтра Да нет
17 Last7Days Да нет
18 Next7Days Да нет
19 LastWeek Да нет
20 ThisWeek Да нет
двадцать два LastMonth Да нет
23 ThisMonth Да нет
двадцать пять Включено Да нет
26 OnOrBefore Да нет
двадцать семь OnOrAfter Да нет
28 LastYear Да нет
29 ThisYear Да нет
33 LastXDays Да нет
34 NextXDays Да нет
37 LastXMonths Да нет
38 NextXMonths Да нет
49 Содержит Да Да
54 BeginWith нет Да
55 DoesNotBeginWidth нет Да
56 EndsWidth нет Да
57 DesNotEndWith нет Да
70 InFiscalPeriodAndYear Да нет
75 Выше Да Да
76 Меньше Да Да
77 Не под Да Да
78 AboveOrEqual Да Да
79 UnderOrEqual Да Да
87 ContainValues Да Да
88 DoesNotContainValues нет Да

Замечание

Функция фильтрации доступна только источнику данных Dataverse.

Тип: фильтрация

связывание

Определяет сведения о связанной таблице. Поддерживается только в приложениях на основе модели.

Тип: связывание

loading

Указывает, загружается ли набор данных. Поддерживается как в приложениях на основе модели, так и на основе холста.

Тип: boolean

замещение страниц

Состояние и действия разбиения на страницы. Поддерживается как в приложениях на основе модели, так и на основе холста. Доступ к данным по страницам можно получить и настроить для набора данных с помощью context.parameters.[dataset_property_name].paging .

Замечание

Источник данных dataverse не возвращает totalRecordCount объект в разбиении по страницам для приложений холста. Вместо этого используется hasNextPage и hasPreviousPage проверяется наличие дополнительных записей для получения.

Компоненты набора данных могут использовать context.parameters.[dataset_property_name].paging.setPageSize(pageSize) для изменения количества записей, полученных на страницу.

Тип: разбиение по страницам

Записи

Сопоставление идентификаторов с полным объектом записи. Поддерживается как в приложениях на основе модели, так и на основе холста.

Тип: EntityRecord

sortedRecordIds

Идентификаторы записей в наборе данных, порядок по результату ответа запроса. Поддерживается как в приложениях на основе модели, так и на основе холста.

Тип: string[]

сортировка

Состояние сортировки текущего запроса. Поддерживается как в приложениях на основе модели, так и на основе холста. Сортировка может быть настроена для набора данных с помощью параметра context.parameters.[dataset_property_name].sorting = [SortStatus]. После настройки сортировки вызов context.parameters.[dataset_property_name].refresh() извлекает отсортированные данные из источника данных.

Замечание

Функция сортировки доступна только источнику данных Dataverse. Кроме того, если сортировка настроена повторно, она сбросит фильтр. context.parameters.[dataset_property_name].filtering

Тип: SortStatus[]

Методы

Метод Description Доступно для
addColumn Добавляет столбец в набор столбцов. Приложения на основе моделей
clearSelectedRecordIds Очищает выбранный список идентификаторов записей. Приложения на основе модели и холста
delete Удалите записи из источника данных. Приложения холста
getCommands Команды для набора данных. Приложения холста
getDataSetCapabilities Возможности набора данных. Приложения холста
getSelectedRecordIds Извлекает все выбранные идентификаторы записей. Приложения на основе модели и холста
getTargetEntityType Возвращает имя типа целевой таблицы. Приложения на основе модели и холста
getTitle Извлекает отображаемое имя представления, используемое свойством набора данных. Приложения на основе модели и холста
getViewId Возвращает идентификатор представления, используемый параметром набора данных. Приложения на основе модели и холста
newRecord Инициализировать локальный объект записи для элемента управления, чтобы задать значение. Элемент управления должен вызвать save() метод в созданной записи, чтобы сохранить изменение. Приложения холста
openDatasetItem Откройте элемент набора данных для заданного Объекта EntityReference. Он проверяет, есть ли команда с идентификатором Mscrm.OpenRecordItemкнопки. Если она существует, она выполняет команду, в противном случае она просто переходит к связанной форме EntityReference. Приложения на основе модели и холста
освежать Обновляет набор данных на основе фильтров, сортировки, связывания, нового столбца. Кроме того, обновление сбрасывает страницы на страницу 1. Приложения на основе модели и холста
retrieveRecordCommand Получение связанных команд записи. Если в манифесте есть несколько наборов данных, извлекитеRecordCommand команды для первого набора данных. Управляемые моделью
setSelectedRecordIds Задайте идентификаторы выбранных записей. Приложения на основе модели и холста

Столбцы подстановки

Теперь столбцы подстановки таблицы dataverse можно получить. Для приложений на основе холста, если столбец подстановки включен в набор данных, извлекаются все столбцы в указанной записи. GetFormattedValue возвращает строку JSON для этого столбца. GetValue метод возвращает объект JSON напрямую.

Example

Дополнительные сведения о реализации методов набора данных см. в разделе "Компонент Сетки DataSet"

Справочник по API платформы компонентов Power Apps
Обзор платформы компонентов Power Apps