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

Набір даних

Надає властивості та методи роботи з даними в сітках і поданнях.

Доступно для

Програми на основі моделі та полотна.

Властивості

Стовпці

Набір стовпців, доступних у цьому наборі даних. Підтримується як у програмах на основі моделі, так і в полотні.

Тип: Стовпець[]

помилка

Чи сталася помилка під час отримання даних. Підтримується як у програмах на основі моделі, так і в полотні.

Тип: boolean

код помилки

Код помилки, пов'язаний із останньою виявленою помилкою (якщо це можливо).

errorMessage

Повідомлення про помилку, пов'язане з останньою виявленою помилкою (якщо можливо).

Тип: number | string

Фільтрації

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

Цінність Умовний оператор Модельні програми Компоновані програми
-1 Ніхто Так Так
0 Рівний Так Так
1 Нотація Так Так
2 Більше, ніж Так Так
3 3-зірковий готель Так Так
4 Більше значення Так Так
5 Менший обсяг Так Так
6 Подібно Так Так
7 NotLike No Так
8 В Так Так
12 Null-значення Так Так
13 NotNull No Так
14 Учора Так No
15 Сьогодні Так No
16 Завтра Так No
17 Останні 7 днів Так No
18 Наступні 7 днів Так No
19 Останній тиждень Так No
20 Цей тиждень Так No
22 Дата останнього місяця Так No
23 Ця мить Так No
25 Увімкн. Так No
26 OnOrBefore Так No
27 OnOrAfter Так No
28 LastYear Так No
29 Цей річний Так No
33 LastXDays (Останні дні) Так No
34 NextXDays (Наступні дні) Так No
37 LastXMonths Так No
38 NextXMonths Так No
49 Містить Так Так
54 BeginWith No Так
55 Невізуативна діаграма No Так
56 Кінцева смуга пропускання No Так
57 Скасувати додавання приміток No Так
70 InFiscalPeriodAndYear Так No
75 Вище Так Так
76 Менше Так Так
77 NotUnder Так Так
78 AboveOrEqual Так Так
79 UnderOrEqual Так Так
87 Містять значення Так Так
88 DoesNotContainValues No Так

Нотатка

Функція фільтрування доступна лише для джерела даних Dataverse.

Тип: фільтрування

Посилання

Визначає відомості про зв'язану таблицю. Підтримується лише в програмах на основі моделі.

Тип: зв'язування

Завантаження

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

Тип: boolean

довантаження

Стан і дії з поділом. Підтримується як у програмах на основі моделі, так і в полотні. Доступ до відомостей про довантаження можна отримати та налаштувати для набору даних за допомогою .context.parameters.[dataset_property_name].paging

Нотатка

Dataverse data source does not return the totalRecordCount in paging object for canvas apps. Натомість вона використовує hasNextPage та hasPreviousPage перевіряє, чи є інші записи, які потрібно отримати.

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

Тип: довантаження

Записи

Зіставлення ідентифікаторів із повним об'єктом запису. Підтримується як у програмах на основі моделі, так і в полотні.

Тип: Запис сутності

sortedRecordIds

Ідентифікатори записів у наборі даних, порядок за результатами відповіді запиту. Підтримується як у програмах на основі моделі, так і в полотні.

Тип: string[]

Сортування

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

Нотатка

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

Тип: SortStatus[]

Методи

Спосіб зв’язку Опис Доступно для
addColumn Додає стовпець до набору стовпців. Модельні програми
clearSelectedRecordIds Очищення списку вибраних ідентифікаторів записів. Програми з керуванням моделлю та Canvas
Видалити Видаліть записи з джерела даних. Компоновані програми
отриматикоманди Команди для набору даних. Компоновані програми
getDataSetCapabilities Можливості для набору даних. Компоновані програми
getSelectedRecordIds Отримує всі вибрані ідентифікатори записів. Програми з керуванням моделлю та Canvas
getTargetEntityType Повертає ім'я цільового типу таблиці. Програми з керуванням моделлю та Canvas
getTitle Отримує коротке ім'я подання, яке використовується властивістю набору даних. Програми з керуванням моделлю та Canvas
getViewId Повертає ідентифікатор подання, що використовується параметром набору даних. Програми з керуванням моделлю та Canvas
newRecord Ініціалізуйте локальний об'єкт запису для елемента керування, щоб установити значення. Елемент керування має викликати save() метод для щойно створеного запису, щоб зберегти зміни. Компоновані програми
openDatasetItem Відкрити елемент набору даних для певного елемента entityReference. Перевіряє, чи є команда з ідентифікатором Mscrm.OpenRecordItemкнопки . Якщо вона існує, вона виконує команду, інакше вона просто переходить до пов'язаної форми EntityReference. Програми з керуванням моделлю та Canvas
Оновити Оновлює набір даних на основі фільтрів, сортування, зв'язування, нового стовпця. Крім того, оновлення призведе до скидання довантаження до сторінки 1. Програми з керуванням моделлю та Canvas
отриматизапискоманди Отримати пов'язані з записом команди. Якщо маніфест містить кілька наборів даних, функція retrieveRecordCommand повертає команди для першого набору даних. На основі моделі
setSelectedRecordIds Установлення ідентифікаторів вибраних записів. Програми з керуванням моделлю та Canvas

Стовпці підстановки

Тепер можна отримати стовпці підстановки таблиці Dataverse. Якщо стовпець підстановки включено до набору даних у програмах canvas, усі стовпці в згаданому записі буде отримано. GetFormattedValue повертає рядок JSON для цього стовпця. GetValue метод повертає безпосередньо об'єкт JSON.

Приклад

Докладні відомості про те, як реалізувати методи набору даних, див. в статті Компонент сітки набору даних

Довідник із API компонента Power Apps
Огляд структури компонентів Power Apps

  • Last updated on