Dynamics 365 Customer Insights
Соединитель Dynamics 365 Customer Insights предоставляет набор API для взаимодействия с экземплярами Dynamics 365 Customer Insights.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL | https://support.microsoft.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://dynamics.microsoft.com/en-us/ai/customer-insights/ |
| Политика конфиденциальности | https://privacy.microsoft.com/ |
| Categories | Данные |
Чтобы зарегистрироваться в Dynamics 365 Customer Insights, щелкните здесь.
Чтобы использовать этот соединитель в Power Apps, ознакомьтесь с дополнительными сведениями здесь.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Обновление элемента (предварительная версия) |
Эта операция обновляет элемент в сущности |
| Отправляет отчет о состоянии |
Отправляет отчет о состоянии. |
| Отправляет отчет о состоянии версии 2 |
Отправляет отчет о состоянии версии 2. |
| Получение данных из секции (предварительная версия) |
Получение данных из секции. |
| Получение секций для сущности (предварительная версия) |
Получение секций для сущности. |
| Получение секций для сущности версии 2 (предварительная версия) |
Получение секций для сущности версии 2. |
| Получение сущностей |
Эта операция получает сущности из экземпляра |
| Получение элемента |
Эта операция получает элемент из сущности |
| Получение элементов из сущности |
Эта операция получает элементы из сущности. В зависимости от сущности поля можно определить как фильтры:
|
| Создание элемента (предварительная версия) |
Эта операция создает элемент в сущности |
Обновление элемента (предварительная версия)
Эта операция обновляет элемент в сущности
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Идентификатор экземпляра |
|
entityName
|
table | True | string |
Имя сущности |
|
itemIdentifier
|
id | True | string |
Идентификатор элемента |
|
recordItem
|
item | True | dynamic |
Запись для обновления |
Возвращаемое значение
Отправляет отчет о состоянии
Отправляет отчет о состоянии.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор экземпляра
|
dataset | True | string |
Выберите экземпляр. |
|
Тип отчета
|
reportType | True | string |
Выберите тип отчета. |
Отправляет отчет о состоянии версии 2
Отправляет отчет о состоянии версии 2.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор экземпляра
|
dataset | True | string |
Выберите экземпляр. |
|
Тип отчета
|
reportType | True | string |
Выберите тип отчета. |
Получение данных из секции (предварительная версия)
Получение данных из секции.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Набор данных Customer Insights
|
dataset | True | string |
Набор данных Customer Insights. |
|
Сущность
|
table | True | string |
Сущность. |
|
Ссылка (URI или имя) раздела
|
partitionUri | True | string |
Ссылка (URI или имя) раздела. |
|
Разделенная запятыми строка столбцов
|
select | string |
Разделенная запятыми строка столбцов. |
|
|
Положение от места начала чтения в байтах
|
offsetStart | integer |
Положение от места начала чтения в байтах. |
|
|
Максимальное число байтов для чтения
|
maxSize | integer |
Максимальное число байтов для чтения. |
|
|
Максимальное количество возвращаемых записей
|
maxResults | integer |
Максимальное количество возвращаемых записей. |
Возвращаемое значение
Данные из секции.
Получение секций для сущности (предварительная версия)
Получение секций для сущности.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Набор данных Customer Insights
|
dataset | True | string |
Набор данных Customer Insights. |
|
Сущность
|
table | True | string |
Сущность. |
Возвращаемое значение
- response
- array of Table
Получение секций для сущности версии 2 (предварительная версия)
Получение секций для сущности версии 2.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Набор данных Customer Insights
|
dataset | True | string |
Набор данных Customer Insights. |
|
Сущность
|
table | True | string |
Сущность. |
|
Значение partitionDisplayName для фильтрации
|
partitionDisplayName | string |
Значение partitionDisplayName для фильтрации. |
Возвращаемое значение
Список секций
Получение сущностей
Эта операция получает сущности из экземпляра
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Идентификатор экземпляра |
Возвращаемое значение
Представляет список таблиц.
- Тело
- TablesList
Получение элемента
Эта операция получает элемент из сущности
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Идентификатор экземпляра |
|
entityName
|
table | True | string |
Имя сущности |
|
itemIdentifier
|
id | True | string |
Идентификатор элемента |
Возвращаемое значение
Получение элементов из сущности
Эта операция получает элементы из сущности. В зависимости от сущности поля можно определить как фильтры:
- Сущность UnifiedActivity: ActivityId и CustomerId
- Сущность клиента: поле CustomerId и любые другие поля, индексированные в экземпляре Customer Insights
- Любые другие сущности: поле CustomerId.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Идентификатор экземпляра |
|
entityName
|
table | True | string |
Имя сущности |
|
Запрос фильтра
|
$filter | string |
Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Первое число
|
$top | integer |
Общее количество записей для получения (по умолчанию = все). |
|
|
Выбор запроса
|
$select | string |
Определенные поля для извлечения из записей (по умолчанию = все). |
Возвращаемое значение
Создание элемента (предварительная версия)
Эта операция создает элемент в сущности
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Идентификатор экземпляра |
|
entityName
|
table | True | string |
Имя сущности |
|
recordItem
|
item | True | dynamic |
Запись для создания |
Триггеры
| Активирует поток из источника данных при завершении обновления |
Эта операция активирует поток из источника данных при завершении обновления в Dynamics 365 Customer Insights. |
| Активирует поток из источника данных при сбое обновления |
Эта операция активирует поток из источника данных при сбое обновления в Dynamics 365 Customer Insights. |
| Активирует поток при завершении полного обновления Customer Insights |
Эта операция активирует поток при завершении полного обновления Customer Insights (источников данных, сегментов, мер,...). |
| Активирует поток при завершении процесса в Customer Insights |
Поток активируется для запланированных обновлений выбранного процесса. Кроме того, можно активировать поток для обновлений вручную. |
| Активирует поток при пересечении порогового значения бизнес-меры |
Эта операция активирует поток, когда пороговое значение бизнес-меры пересекается в Dynamics 365 Customer Insights. |
| Активирует поток при пересечении порогового значения сегмента |
Эта операция активирует поток, когда пороговое значение сегмента пересекается в Dynamics 365 Customer Insights. |
Активирует поток из источника данных при завершении обновления
Эта операция активирует поток из источника данных при завершении обновления в Dynamics 365 Customer Insights.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
имя набора данных. |
Возвращаемое значение
DataSourcesList
- Тело
- DataSourcesList
Активирует поток из источника данных при сбое обновления
Эта операция активирует поток из источника данных при сбое обновления в Dynamics 365 Customer Insights.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
имя набора данных. |
Возвращаемое значение
DataSourcesList
- Тело
- DataSourcesList
Активирует поток при завершении полного обновления Customer Insights
Эта операция активирует поток при завершении полного обновления Customer Insights (источников данных, сегментов, мер,...).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя экземпляра
|
dataset | True | string |
Выберите экземпляр. |
Возвращаемое значение
Сведения о выполнении полного обновления
Активирует поток при завершении процесса в Customer Insights
Поток активируется для запланированных обновлений выбранного процесса. Кроме того, можно активировать поток для обновлений вручную.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя экземпляра
|
dataset | True | string |
Выберите экземпляр. |
|
Процедура
|
process | string |
Выберите процесс. |
|
|
Включение процесса, активированного вручную
|
includingManualRefreshes | boolean |
Выберите "Да", если следует включить процесс, активироваемый вручную. |
Возвращаемое значение
Сведения о выполняемом процессе
- Тело
- ProcessData
Активирует поток при пересечении порогового значения бизнес-меры
Эта операция активирует поток, когда пороговое значение бизнес-меры пересекается в Dynamics 365 Customer Insights.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя экземпляра
|
dataset | True | string |
Выберите экземпляр. |
|
Имя бизнес-меры
|
measure | True | string |
Выберите меру. |
|
Порог
|
threshold | True | double |
Задайте любое число как пороговое значение. |
Возвращаемое значение
Данные бизнес-мер
- Тело
- MeasureData
Активирует поток при пересечении порогового значения сегмента
Эта операция активирует поток, когда пороговое значение сегмента пересекается в Dynamics 365 Customer Insights.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя экземпляра
|
dataset | True | string |
Выберите экземпляр. |
|
Имя сегмента
|
segment | True | string |
Выберите сегмент. |
|
Порог
|
threshold | True | integer |
Задайте любое число как пороговое значение. |
Возвращаемое значение
Сегментирование данных
- Тело
- SegmentData
Определения
DataSourcesList
DataSourcesList
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of DataSource |
Список источников данных |
Источник данных
Класс DataSource
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
RefreshType
|
RefreshType | string |
Тип обновления данных |
|
RefreshObjectId
|
RefreshObjectId | string |
Идентификатор объекта обновления |
|
RefreshObjectVersion
|
RefreshObjectVersion | integer |
Версия объекта обновления |
|
Операция
|
Operation | string |
Имя операции |
|
JobType
|
JobType | string |
Тип задания |
|
ErrorCode
|
ErrorCode | string |
Код ошибки во время обновления данных. |
|
Сообщение об ошибке
|
ErrorMessage | string |
Сообщение об ошибке во время обновления |
|
ErrorSeverity
|
ErrorSeverity | string |
Серверность ошибок во время обновления |
|
StartTimeUtc
|
StartTimeUtc | string |
Время начала обновления данных |
|
EndTimeUtc
|
EndTimeUtc | string |
Время окончания обновления данных |
SegmentData
Сегментирование данных
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя
|
Name | string |
Имя сегмента |
|
Отображаемое имя
|
DisplayName | string |
Отображаемое имя сегмента |
|
ОценкаDate
|
EvaluationDate | date-time |
Дата оценки сегмента |
|
EntityCount
|
EntityCount | integer |
Фактическое количество элементов сегмента |
|
Порог
|
Threshold | integer |
Пороговое значение сегмента |
MeasureData
Данные бизнес-мер
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя
|
Name | string |
Имя меры |
|
Отображаемое имя
|
DisplayName | string |
Отображаемое имя меры |
|
ОценкаDate
|
EvaluationDate | date-time |
Дата оценки меры |
|
Ценность
|
Value | double |
Значение меры |
|
ValueDisplayName
|
ValueDisplayName | string |
Отображаемое имя значения |
|
Порог
|
Threshold | double |
Пороговое значение меры |
FullRefreshProcessData
Сведения о выполнении полного обновления
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
NumberOfFailedTasks
|
NumberOfFailedTasks | integer |
Количество неудачных задач |
|
StartTime
|
StartTime | date-time |
Время начала шага рабочего процесса |
|
EndTime
|
EndTime | date-time |
Время окончания шага рабочего процесса |
|
Продолжительность
|
Duration | integer |
Длительность процесса в минутах |
|
Состояние
|
Status | string |
Состояние шага рабочего процесса |
|
СтатусПейдж
|
StatusPage | string |
Ссылка на страницу состояния |
ProcessData
Сведения о выполняемом процессе
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
StartTime
|
StartTime | date-time |
Время начала шага рабочего процесса |
|
EndTime
|
EndTime | date-time |
Время окончания шага рабочего процесса |
|
Продолжительность
|
Duration | integer |
Длительность процесса в минутах |
|
Состояние
|
Status | string |
Состояние шага рабочего процесса |
|
СтатусПейдж
|
StatusPage | string |
Ссылка на страницу состояния |
Таблица
Представляет таблицу.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя
|
Name | string |
Название таблицы. Имя используется во время выполнения. |
|
Отображаемое имя
|
DisplayName | string |
Отображаемое имя таблицы. |
|
DynamicProperties
|
DynamicProperties | object |
Дополнительные свойства таблицы, предоставляемые соединителем клиентам. |
PartitionListResponse
Список секций
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Header
|
Header | string |
Заголовок, содержащий атрибуты сущности |
|
Перегородки
|
Partitions | array of Table |
Список секций |
PartitionDataResponse
Данные из секции.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
OffsetStart
|
OffsetStart | integer |
Начальная смещение. |
|
OffsetEnd
|
OffsetEnd | integer |
Смещение конца. |
|
Size
|
Size | integer |
Количество возвращаемых данных. |
|
Товары
|
Items | array of object |
Словарь, содержащий данные максимального размера элементов из секции, от смещения "OffsetStart" до "OffsetEnd". |
|
items
|
Items | object |
TablesList
Представляет список таблиц.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of Table |
Список таблиц |