AlisQI (предварительная версия)
Интеграция QMS с erp, MES, PLM, инструментами, датчиками или веб-сайтом с помощью средств подключения AlisQI.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Поддержка AlisQI |
| URL | https://help.alisqi.com/ |
| Адрес электронной почты | support@alisqi.com |
| Метаданные соединителя | |
|---|---|
| Publisher | АлисЦИ BV |
| Веб-сайт | https://www.alisqi.com |
| Политика конфиденциальности | https://www.alisqi.com/en/privacy-statement |
| Категории | Управление бизнесом |
АлисЦИ
Интеграция QMS с erp, MES, PLM, инструментами, датчиками или веб-сайтом с помощью средств подключения AlisQI.
Издатель: АлисЦИ B.V.
Предпосылки
Чтобы использовать этот соединитель, вам потребуется следующее:
- Счет с АлисЦИ.
- После регистрации и получения приложения получите ключ API на веб-портале; этот ключ будет использоваться для проверки подлинности запросов из нашего соединителя AlisQI.
Поддерживаемые операции
Соединитель поддерживает следующие операции:
Получение результатов или основных данных
/getResults: получение (качество) результатов из наборов анализа или основных данных из списков выбора.Получение всех наборов анализа или списков
/getAllSetsвыбора: получение списка (все) наборы анализа или списки выбора.Создание или обновление результатов или основных данных
/storeResults: создание или обновление результатов анализа наборов или основных данных в списках выбора.Получение описательной статистики для полей
/getStatisticsнабора анализа: получение описательной статистики для полей набора числовых наборов.Получение статистики возможностей для полей
/getSpecificationEvaluationнабора анализа: получение подробной статистики оценки спецификации и возможностей обработки для числовых полей набора анализа.Получение версий спецификации
/getSpecificationVersion: получение версий спецификации (a) для набора анализа.Создайте новую версию
/storeSpecificationVersionспецификации: создайте (a) новые версии спецификации для наборов анализа.Получение структуры наборов анализа или списка
/getSetDefinitionвыбора: получение структурного определения наборов или списков выбора.
Получение учетных данных
Все вызовы API подлежат проверке подлинности. Чтобы вызвать конечные точки API AlisQI, разработчикам необходимо создать маркер проверки подлинности.
API поддерживает спецификацию проверки подлинности носителя.
Каждый маркер подключен к одному пользователю. Разрешение на чтение, вставку и обновление, которое пользователь имеет для наборов анализа (через свою группу пользователей), также применяется к вызовам API. Дополнительные сведения об управлении пользователями и разрешениями в AlisQI.
Маркеры проверки подлинности API можно создать в центре интеграции с приложением. Рекомендуется использовать выделенные маркеры для каждого сценария интеграции.
Кроме того, если метод проверки подлинности носителя недоступен, запросы можно пройти проверку подлинности с помощью параметра
&accessToken=abc...123URL-адреса accessToken.
Известные проблемы и ограничения
Фильтры. Операции с параметром фильтра ожидают строку JSON, представляющую фильтр. Используйте центр интеграции с приложением для создания фильтра и копирования строки JSON.
Даты: все даты и время находятся в формате UTC (отформатированы
yyyy-mm-dd hh:mm:ssкак), а все строки кодируются с помощью UTF-8.Кэширование: операция getResults поддерживает проверку кэша с помощью ETag и заголовков Last-Modified. Мы рекомендуем включить кэширование на клиентах и выполнять условные запросы для уменьшения задержки, нагрузки сервера и энергопотребления.
Ограничения использования. Ранее мы видели снижение производительности из-за перегрузки API. Чтобы обеспечить стабильность ограничений использования платформы, применяются к API. Эти ограничения предназначены для предотвращения нежелательных нагрузок в наших системах от неправильно настроенных интеграции API или злоупотреблений. Ограничение скорости по умолчанию составляет 30 вызовов в минуту. Это относится как к операциям чтения, так и записи. Запросы, которые достигли предела скорости, будут иметь код
429 Too many requestsсостояния.
Все ответы включают следующие заголовки с явными номерами ограничений и оставшимися вызовами:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Retry-After
Чтобы отладить проблемы в сценариях интеграции, которые являются или могут быть вызваны ограничениями скорости, ознакомьтесь с этим контрольным списком:
- Обратитесь к специалисту по интеграции, чтобы проверить вызовы API и возвращать заголовки.
- Откройте центр интеграции AlisQI, чтобы узнать о конкретном ограничении скорости, примененном к установке.
- Проверьте журнал API в центре интеграции AlisQI, чтобы определить количество запросов в минуту.
- Проверьте заголовки запроса API, чтобы узнать, содержат
429 Too many requestsли они код состояния. - Проверьте отдельные заголовки запроса API для оценки
X-RateLimit-* headers. - Оцените, можно ли улучшить интеграцию, уменьшая повторяющиеся запросы или сочетая несколько результатов в одном вызове storeResults. Вы можете обратиться к поддержке AlisQI, чтобы обсудить возможности нашего API относительно кэширования и обработки нескольких результатов.
- Если сценарий интеграции оптимизирован, но законно требует больше звонков в минуту, обратитесь в службу поддержки AlisQI, чтобы обсудить возможности повышения предела.
Инструкции по развертыванию
Используйте эти инструкции для развертывания этого соединителя в качестве пользовательского соединителя в Microsoft Flow и PowerApps.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API для этого API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Получение версий спецификации |
Получение (a) версий спецификации для набора анализа. |
| Получение всех наборов анализа или списков выбора |
Получение списка (всех) наборов анализа или списков выбора. |
| Получение описательной статистики для полей набора анализа |
Получите описательную статистику для выбранных полей набора числовых данных. |
| Получение результатов или основных данных |
Получение (качество) результатов из наборов анализа или основных данных из списков выбора. |
| Получение статистики возможностей для полей набора анализа |
Получение подробной статистики оценки спецификации и возможностей процесса для числовых полей набора анализа. |
| Получение структуры наборов анализа или списка выбора |
Получение структурного определения наборов анализа или списков выбора. |
| Создание или обновление результатов или основных данных |
Создание или обновление результатов качества в наборах анализа или основных данных в списках выбора. |
| Создание новой версии спецификации |
Создайте (a) новые версии спецификации для наборов анализа. |
Получение версий спецификации
Получение (a) версий спецификации для набора анализа.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Задать идентификатор
|
setId | True | integer |
Введите уникальный идентификатор интересующего вас набора анализа (исторически известный как маскида в URL-адресах). |
|
Значение индекса
|
indexValue | string |
Получите текущую версию спецификации для этого значения индекса. |
Получение всех наборов анализа или списков выбора
Получение списка (всех) наборов анализа или списков выбора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Groups
|
groups | string |
Введите идентификаторы групп или имена, чтобы найти определенные группы, используйте "Списки выбора", чтобы получить все. |
|
|
Names
|
names | string |
Введите имена наборов анализа или списков выбора, которые требуется получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
id |
|
имя
|
name | string |
имя |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
topLevelMenu
|
topLevelMenu | string |
topLevelMenu |
Получение описательной статистики для полей набора анализа
Получите описательную статистику для выбранных полей набора числовых данных.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Задать идентификатор
|
setId | True | integer |
Введите уникальный идентификатор интересующего вас набора анализа (исторически известный как маскида в URL-адресах). |
|
Fields
|
fields | True | string |
Разделенный запятыми список с определенными точками данных, которые необходимо вернуть. |
|
Лимит
|
limit | integer |
Максимальное количество результатов, которые следует учитывать. |
|
|
Filter
|
filter | string |
Используйте строку в формате JSON, чтобы сузить запрашиваемые данные на основе определенных условий. |
Получение результатов или основных данных
Получение (качество) результатов из наборов анализа или основных данных из списков выбора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Задать идентификатор
|
setId | True | integer |
Введите уникальный идентификатор интересующего вас набора анализа (исторически известный как маскида в URL-адресах). |
|
Лимит
|
limit | integer |
Укажите максимальное количество записей, которые вы хотите получить, до 10 000. |
|
|
Смещение
|
offset | integer |
Выберите начальную позицию для результатов, полезную для разбиения по страницам с помощью данных (по умолчанию — 0). |
|
|
Сортировать
|
sort | string |
Определите порядок данных по полю и направлению, например date:desc для последней первой. |
|
|
Filter
|
filter | string |
Используйте строку в формате JSON, чтобы сузить запрашиваемые данные на основе определенных условий. |
|
|
Fields
|
fields | string |
Разделенный запятыми список с определенными точками данных, которые необходимо вернуть. |
|
|
Включение вложений
|
includeAttachments | boolean |
Пометьте значение true, если вы хотите включить любые вложения файлов с данными, в противном случае оставьте значение false. |
|
|
Идентификатор включения
|
includeId | boolean |
Задайте значение true, если вы хотите получить уникальные номера записей системы для данных, что упрощает управление данными или ссылку. |
|
|
Включить дату последнего изменения
|
includeLastModificationDate | boolean |
Включите, чтобы получить дату последнего изменения для каждого фрагмента данных, который отлично подходит для отслеживания последних обновлений. |
Получение статистики возможностей для полей набора анализа
Получение подробной статистики оценки спецификации и возможностей процесса для числовых полей набора анализа.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Задать идентификатор
|
setId | True | integer |
Введите уникальный идентификатор интересующего вас набора анализа (исторически известный как маскида в URL-адресах). |
|
Fields
|
fields | True | string |
Разделенный запятыми список с определенными точками данных, которые необходимо вернуть. |
|
Лимит
|
limit | integer |
Максимальное количество результатов, которые следует учитывать. |
|
|
Filter
|
filter | string |
Используйте строку в формате JSON, чтобы сузить запрашиваемые данные на основе определенных условий. |
Получение структуры наборов анализа или списка выбора
Получение структурного определения наборов анализа или списков выбора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Задать идентификатор
|
setId | True | integer |
Введите уникальный идентификатор интересующего вас набора анализа (исторически известный как маскида в URL-адресах). |
|
Только активные поля
|
onlyActiveFields | boolean |
Указывает, следует ли отображать только активные поля в данный момент. |
|
|
Принять
|
Accept | True | string |
Принять |
Создание или обновление результатов или основных данных
Создание или обновление результатов качества в наборах анализа или основных данных в списках выбора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Задать идентификатор
|
setId | True | string |
Введите уникальный идентификатор интересующего вас набора анализа (исторически известный как маскида в URL-адресах). |
|
Results
|
results | True | string |
Объект JSON в виде строки. |
|
Ключевое поле
|
keyField | string |
Найдите и измените существующие результаты на основе значения этого поля. |
|
|
Только изменение
|
editOnly | string |
Используйте (только) в сочетании с keyField. |
|
|
Добавление параметров списка
|
addListOptions | string |
Пометка, чтобы добавить новые параметры в списки. |
Создание новой версии спецификации
Создайте (a) новые версии спецификации для наборов анализа.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Поддомен, используемый для запроса. |
|
Задать идентификатор
|
setId | True | string |
Введите уникальный идентификатор интересующего вас набора анализа (исторически известный как маскида в URL-адресах). |
|
Очки
|
specs | True | string |
Объект JSON в виде строки. |
|
Значение индекса
|
indexValue | string |
Значение поля индекса. |
|
|
Время начала даты
|
startDateTime | string |
Форматируется как гггг-mm-dd чч:мм:сс или симп unix. |
|
|
Причина
|
reason | string |
Причина изменения спецификации. |
Возвращаемое значение
- response
- boolean
Определения
булевый
Это базовый тип данных boolean.