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
Адрес электронной почты
Email 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