InLoox (предварительная версия)
Соединитель InLoox помогает командам оптимизировать рабочие процессы проекта, автоматизируя распространенные задачи, такие как создание и обновление проектов, задач и контактов в рабочей области InLoox. Используйте этот соединитель для интеграции InLoox со службами Майкрософт, такими как Outlook, SharePoint или Teams, обеспечивая простое автоматизацию процессов для планирования проектов, совместной работы и отслеживания ресурсов.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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) |
| Контакт | |
|---|---|
| Имя | InLoox |
| URL | https://www.inloox.com |
| Адрес электронной почты | support@inloox.com |
| Метаданные соединителя | |
|---|---|
| Publisher | InLoox |
| Веб-сайт | https://www.inloox.com |
| Политика конфиденциальности | https://www.inloox.com/privacy-policy/ |
| Категории | Сотрудничество; Продуктивность |
Соединитель InLoox Power Automate
Обзор
Соединитель Power Automate InLoox позволяет взаимодействовать с REST API InLoox для автоматизации задач управления проектами, таких как создание проектов, управление задачами и обработка контактов. Он поддерживает сценарии интеграции в Power Automate и Power Apps, что позволяет пользователям создавать рабочие процессы, которые подключаются к InLoox с другими службами.
Предпосылки
Для продолжения вам потребуется следующее:
- План Microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
- Учетная запись InLoox с соответствующим доступом к API
- Ключ API InLoox (используется с помощью
X-API-KEYзаголовка) - Интерфейс командной строки Power Platform (
paconn)
Создание соединителя
Соединитель использует проверку подлинности ключа API. Убедитесь, что у вас есть ключ API InLoox с достаточными разрешениями.
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
Замените <api_key> фактическим ключом. Ключ API должен быть передан в заголовке X-API-KEY , как указано в определении Swagger.
Конфигурация узла API
-
Узел:
https://app.inloox.com -
BasePath:
/api/v1/odata/ -
Проверка подлинности: ключ API (
X-API-KEYзаголовок)
Поддерживаемые операции
Соединитель предоставляет следующие операции, сгруппированные по сущности:
📁 Управление проектами
- GET /Project: вывод списка проектов с необязательным фильтром OData и разбивкой на страницы
- POST /Project: создание нового проекта
- GET /Project/{projectId}: получение проекта по идентификатору
- PATCH /Project/{projectId}: обновление проекта по идентификатору
- DELETE /Project/{projectId}: удаление проекта
- POST /Project/{projectId}/AddMember: добавление члена в проект
✅ Управление задачами
- GET /Task: вывод списка задач с необязательным фильтром OData и разбивкой на страницы
- POST /Task: создание новой задачи
- GET /Task/{taskId}: получение задачи по идентификатору
- PATCH /Task/{taskId}: обновление задачи по идентификатору
- DELETE /Task/{taskId}: удаление задачи
👤 Управление контактами
- GET /Contact: вывод списка контактов с необязательным фильтром OData и разбивкой на страницы
Определения сущностей
ApiProjectInput
Включает такие поля, как Name, StartDate, ClientIdEndDate, Priority, IsArchivedи другие.
ApiTaskInput
Поля включают Name, WorkAmountProjectIdStartDateTimeEndDateTimeи .DescriptionHTML
AddProjectMemberInput
-
contactId(uuid): идентификатор контакта для добавления -
role(int): идентификатор роли (например, 2 = Project Manager, 4 = член группы)
Примечания.
- Все конечные точки соответствуют синтаксису запросов OData для фильтрации и разбиения на страницы
- Убедитесь, что правильный
Content-Type(application/json) задан в запросах текста - Для запросов PATCH и POST необходимые схемы должны соответствовать
ApiProjectInputиApiTaskInput - Безопасность ключа API применяется через
X-API-KEYзаголовок
Дополнительные сведения
Дополнительные сведения о моделях сущностей и примерах использования, посетите или обратитесь https://github.com/inloox-dev к ним support@inloox.com.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| apiKey | securestring | ApiKey для API InLoox | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Добавление члена в проект |
Добавляет член в указанный проект. |
| Извлекает задачу по идентификатору |
Извлекает определенную задачу по уникальному идентификатору. |
| Извлекает проект по идентификатору |
Извлекает конкретный проект по уникальному идентификатору. |
| Извлекает список задач |
Возвращает все задачи на основе указанных параметров фильтра OData и параметров разбиения на страницы. |
| Извлекает список контактов |
Возвращает все контакты на основе указанных параметров фильтра OData и параметров разбиения на страницы. |
| Извлекает список проектов |
Возвращает все проекты на основе указанных параметров фильтра OData и параметров разбиения на страницы. |
| Обновление проекта по идентификатору |
Обновляет указанный проект с новыми сведениями. |
| Обновляет задачу по идентификатору |
Обновляет указанную задачу с новыми сведениями. |
| Создает новую задачу |
Создает новую задачу с предоставленными сведениями. |
| Создает новый проект |
Создает проект с предоставленными сведениями. |
| Удаляет задачу по идентификатору |
Удаляет указанную задачу по уникальному идентификатору. |
| Удаляет проект по идентификатору |
Удаляет указанный проект по уникальному идентификатору. |
Добавление члена в проект
Добавляет член в указанный проект.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
идентификатор проекта
|
projectId | True | uuid |
Уникальный идентификатор проекта, в который будет добавлен элемент. |
|
contactId
|
contactId | True | uuid |
Идентификатор контакта, добавляемого в проект |
|
роль
|
role | True | integer |
Идентификатор числовых ролей для элемента. Возможные значения: 2=Project Manager, 4=Член группы, 8=Partner, 16=Customer, 32=Other, 128=AdditionalRole1, 256=AdditionalRole2, 512=AdditionalRole3, 1024=AdditionalRole4, 2048=AdditionalRole5=AdditionalRole5 |
Извлекает задачу по идентификатору
Извлекает определенную задачу по уникальному идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
taskId | True | uuid |
Уникальный идентификатор задачи для получения. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of ApiTask |
Извлекает проект по идентификатору
Извлекает конкретный проект по уникальному идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
projectId | True | uuid |
Уникальный идентификатор извлекаемого проекта. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of ApiProject |
Извлекает список задач
Возвращает все задачи на основе указанных параметров фильтра OData и параметров разбиения на страницы.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Строка фильтра OData
|
$filter | string |
Строка фильтра OData для фильтрации возвращаемых задач. |
|
|
Максимальное количество задач
|
$top | number |
Максимальное количество возвращаемых задач. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of ApiTask |
Извлекает список контактов
Возвращает все контакты на основе указанных параметров фильтра OData и параметров разбиения на страницы.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Строка фильтра OData
|
$filter | string |
Строка фильтра OData для фильтрации возвращенных контактов. |
|
|
Максимальное количество контактов
|
$top | number |
Максимальное количество возвращаемых контактов. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of ApiContact |
Извлекает список проектов
Возвращает все проекты на основе указанных параметров фильтра OData и параметров разбиения на страницы.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Строка фильтра OData
|
$filter | string |
Строка фильтра OData для фильтрации возвращаемых проектов. |
|
|
Максимальное количество проектов
|
$top | number |
Максимальное количество возвращаемых проектов. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of ApiProject |
Обновление проекта по идентификатору
Обновляет указанный проект с новыми сведениями.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
projectId | True | uuid |
Уникальный идентификатор проекта для обновления. |
|
ClientId
|
ClientId | uuid | ||
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
DivisionId
|
DivisionId | uuid | ||
|
Дата окончания
|
EndDate | date-time | ||
|
IsArchived
|
IsArchived | boolean | ||
|
IsRecycled
|
IsRecycled | boolean | ||
|
LockMode
|
LockMode | integer | ||
|
Имя
|
Name | string | ||
|
NumberIncremential
|
NumberIncremential | integer | ||
|
NumberPrefix
|
NumberPrefix | string | ||
|
NumberSuffix
|
NumberSuffix | string | ||
|
PortfolioId
|
PortfolioId | uuid | ||
|
Priority
|
Priority | integer | ||
|
ProjectStatusId
|
ProjectStatusId | uuid | ||
|
RiskScore
|
RiskScore | integer | ||
|
SizeScore
|
SizeScore | integer | ||
|
Дата начала
|
StartDate | date-time | ||
|
ValueScore
|
ValueScore | integer |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of ApiProject |
Обновляет задачу по идентификатору
Обновляет указанную задачу с новыми сведениями.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
taskId | True | uuid |
Уникальный идентификатор задачи для обновления. |
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
EndDateTime
|
EndDateTime | date-time | ||
|
GroupId
|
GroupId | uuid | ||
|
Имя
|
Name | string | ||
|
ProjectId
|
ProjectId | uuid | ||
|
StartDateTime
|
StartDateTime | date-time | ||
|
WorkAmount
|
WorkAmount | number |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of ApiTask |
Создает новую задачу
Создает новую задачу с предоставленными сведениями.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
EndDateTime
|
EndDateTime | date-time | ||
|
GroupId
|
GroupId | uuid | ||
|
Имя
|
Name | string | ||
|
ProjectId
|
ProjectId | uuid | ||
|
StartDateTime
|
StartDateTime | date-time | ||
|
WorkAmount
|
WorkAmount | number |
Возвращаемое значение
- Тело
- ApiTask
Создает новый проект
Создает проект с предоставленными сведениями.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
ClientId
|
ClientId | uuid | ||
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
DivisionId
|
DivisionId | uuid | ||
|
Дата окончания
|
EndDate | date-time | ||
|
IsArchived
|
IsArchived | boolean | ||
|
IsRecycled
|
IsRecycled | boolean | ||
|
LockMode
|
LockMode | integer | ||
|
Имя
|
Name | string | ||
|
NumberIncremential
|
NumberIncremential | integer | ||
|
NumberPrefix
|
NumberPrefix | string | ||
|
NumberSuffix
|
NumberSuffix | string | ||
|
PortfolioId
|
PortfolioId | uuid | ||
|
Priority
|
Priority | integer | ||
|
ProjectStatusId
|
ProjectStatusId | uuid | ||
|
RiskScore
|
RiskScore | integer | ||
|
SizeScore
|
SizeScore | integer | ||
|
Дата начала
|
StartDate | date-time | ||
|
ValueScore
|
ValueScore | integer |
Возвращаемое значение
- Тело
- ApiProject
Удаляет задачу по идентификатору
Удаляет указанную задачу по уникальному идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
taskId | True | uuid |
Уникальный идентификатор задачи для удаления. |
Удаляет проект по идентификатору
Удаляет указанный проект по уникальному идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
projectId | True | uuid |
Уникальный идентификатор проекта для удаления. |
Определения
ApiContact
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя Компании
|
CompanyName | string | |
|
ContactId
|
ContactId | uuid | |
|
DescriptionHTML
|
DescriptionHTML | string | |
|
Отображаемое имя
|
DisplayName | string | |
|
Адрес электронной почты
|
string | ||
|
Имя
|
FirstName | string | |
|
IsIdentity
|
IsIdentity | boolean | |
|
Фамилия
|
LastName | string | |
|
Название
|
Title | string |
ApiProject
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
ProjectId
|
ProjectId | uuid |
ApiTask
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
DescriptionHTML
|
DescriptionHTML | string | |
|
EndDateTime
|
EndDateTime | date-time | |
|
Имя
|
Name | string | |
|
ProjectId
|
ProjectId | uuid | |
|
StartDateTime
|
StartDateTime | date-time | |
|
TaskId
|
TaskId | uuid |