HUE Datagate (предварительная версия)

Datagate — это платформа управления данными "Программное обеспечение как услуга" из приложений Works, которая предоставляет пользователям упрощенный метод хранения, управления и создания аналитических сведений из бизнес-данных. Этот соединитель позволяет использовать бизнес-данные в Datagate из Power Platform.

Этот соединитель доступен в следующих продуктах и регионах:

Datagate — это платформа управления данными "Программное обеспечение как услуга" из приложений Works, которая предоставляет пользователям упрощенный метод хранения, управления и создания аналитических сведений из бизнес-данных. Она может служить централизованной платформой для хранения данных и управления ими

Этот соединитель предоставляет API для доступа к бизнес-данным в Datagate из Power Platform.

Предпосылки

Чтобы использовать этот соединитель, вам потребуется следующее:

• Ключ API Datagate с доступом к API OData.
• Учетные данные роли Datagate (идентификатор роли, секрет роли) с доступом к требуемой таблице.
• Учетная запись пользователя Datagate для доступа к построителю запросов в Datagate.

Получение учетных данных

Существует два уровня проверки подлинности и авторизации для доступа к таблице в Datagate, а именно ключ API Datagate и роль Datagate. Ниже приведены упрощенные шаги по получению ключа API Datagate и учетных данных роли Datagate. Дополнительные сведения см. в руководстве datagate или @SUPPORTобратитесь к нашим консультантам.

Чтобы получить ключ API Datagate, выполните следующие действия.

1. Войдите на экран Datagate.
2. Перейдите на страницу управления ключами API. Кнопка "Ключ API" будет доступна на левой панели навигации страницы. Щелкните значок ключа и выберите "Управление ключами API", чтобы перейти на страницу управления ключами API.
3. Нажмите кнопку "Создать ключ API" в правой верхней части страницы.
4. Страница "Изменить API" будет отображаться с пустыми полями.
5. В разделе сведений о ключе API введите требуемое описание.
6. Выберите необходимые разрешения для предоставления ключа API.
7. Нажмите кнопку "Сохранить ключ API" в правом верхнем углу страницы, чтобы создать нужный ключ API.

Чтобы получить учетные данные роли Datagate, выполните приведенные далее действия.

1. Войдите на экран Datagate.
2. Перейдите на страницу управления ролями. Ссылка "Управление ролями" будет доступна на левой панели навигации страницы. Щелкните значок таблицы и выберите "Управление ролями", чтобы перейти на страницу управления ролями.
3. Нажмите кнопку "Создать роль" в правой верхней части страницы.
4. Откроется страница "Создать роль".
5. В разделе сведений о роли введите нужное имя роли и выберите тип разрешения.
6. Выберите необходимые разрешения для предоставления роли из списка схем или таблиц.
7. Нажмите кнопку "Сохранить роль" в правом верхнем углу страницы, чтобы создать новую роль и получить необходимые учетные данные роли.

Начало работы с соединителем

В настоящее время существует один API, доступный для использования, API OData, который позволит читать данные таблицы в Datagate. С помощью запроса OData Datagate можно задать выбранные столбцы, порядок сортировки, необходимые параметры — строка запроса и учетные данные роли роли, которая имеет доступ к таблице. См. предыдущий раздел "Как получить учетные данные" для получения необходимых учетных данных API и учетных данных роли. Чтобы получить строку запроса, выполните следующие действия.

1. На экране Datagate найдите нужную таблицу на странице списка таблиц.
2. Откройте нужную страницу просмотра данных таблицы.
3. Задайте нужные параметры и скопируйте полученную строку запроса.

Отправка ежедневного отчета по электронной почте

С помощью соединителя Datagate создайте поток Питания, который автоматически отправляет отчет о продажах ежедневно

1. Подготовьте ключ API для использования. (См. предыдущий раздел "Как получить учетные данные")
2. Подготовка роли (идентификатора роли и секрета роли). (См. предыдущий раздел "Как получить учетные данные")
3. Получите запрос для выходной таблицы.
4. Создайте запланированный облачный поток.
5. Задайте требуемое расписание.
6. Убедитесь, что набор расписаний правильно.
7. Добавьте шаг для получения текущего времени даты и преобразования из часового пояса UTC в нужный часовой пояс.
8. Добавьте шаг API OData. Можно создавать динамические строки запросов, вставляя переменные в строку запроса.
9. Добавьте шаг преобразования JSON. Создайте схему с помощью примера полезных данных JSON.
10. Добавьте шаг для создания HTML-таблицы.
11. Добавьте шаг для отправки электронной почты и введите нужный текст электронной почты, а затем сохраните соединитель. Вы можете протестировать поток, выполнив его вручную.
12. Сообщение электронной почты будет отправлено в следующем формате по определенному расписанию.

Известные проблемы и ограничения

Максимальный размер возвращаемых данных составляет 6 МБ на вызов API.

Если запрошенный размер набора данных превышает 6 МБ, вызов API возвращает ошибку "413 Полезные данные слишком большой".

Распространенные ошибки и средства устранения неполадок

В настоящее время в соединителе существует только один API, API OData. Ниже приведены некоторые из возможных ошибок, с которыми можно столкнуться при использовании API.

200 OK (Запрос выполнен успешно)

"отношение "public_view.table_name" не существует"

Таблица больше не существует. Проверьте, доступна ли таблица с помощью средства просмотра данных Datagate.

"Не удалось проанализировать фильтр (XXX)" (строка X, столбец X)"

Существует некоторая проблема с предоставленным запросом. Убедитесь, что запрос скопирован на экране Datagate правильно.

Слишком большая полезные данные 413

Существует ограничение в 6 МБ для размера полезных данных из API OData. Задайте нижнее ограничение счетчика строк, задав параметр "limit" в запросе OData.

500 Internal Server Error (внутренняя ошибка сервера).

Не удалось установить подключение к серверу. Обратитесь к нашим консультантам, если проблема сохраняется.

Часто задаваемые вопросы

Ниже приведены распространенные вопросы для пользователей Datagate. Для вопросов, не описанных здесь или для получения дополнительных сведений, обратитесь к руководству Datagate, доступному на платформе Works Applications @SUPPORT , а также обратитесь к нашим консультантам.

Как получить данные внешней таблицы из соединителя?

Перейдите на страницу просмотра данных требуемой внешней таблицы и получите соответствующую строку запроса из построителя запросов.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Действия

OData API