InLoox (versão prévia)
O InLoox Connector ajuda as equipes a simplificar os fluxos de trabalho do projeto automatizando tarefas comuns, como criar e atualizar projetos, tarefas e contatos em seu workspace InLoox. Use esse conector para integrar o InLoox a serviços da Microsoft, como Outlook, SharePoint ou Teams, habilitando a automação de processo contínuo para planejamento de projetos, colaboração e acompanhamento de recursos.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | InLoox |
| URL | https://www.inloox.com |
| support@inloox.com |
| Metadados do conector | |
|---|---|
| Publicador | InLoox |
| Site | https://www.inloox.com |
| Política de privacidade | https://www.inloox.com/privacy-policy/ |
| Categorias | Colaboração; Produtividade |
Conector do InLoox Power Automate
Visão geral
O InLoox Power Automate Connector permite que você interaja com a API REST do InLoox para automatizar tarefas de gerenciamento de projetos, como criar projetos, gerenciar tarefas e lidar com contatos. Ele dá suporte a cenários de integração no Power Automate e no Power Apps, permitindo que os usuários criem fluxos de trabalho que conectam o InLoox a outros serviços.
Pré-requisitos
Você precisará do seguinte para continuar:
- Um plano do Microsoft Power Apps ou do Power Automate com o recurso de conector personalizado
- Uma conta do InLoox com acesso à API apropriado
- Uma chave de API inLoox (usada por meio de
X-API-KEYcabeçalho) - A CLI do Power Platform (
paconn)
Compilando o conector
O conector usa a autenticação de chave de API. Verifique se você tem uma chave de API InLoox com permissões suficientes.
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
Substitua <api_key> pela chave real. A chave de API deve ser passada no X-API-KEY cabeçalho, conforme especificado na definição do Swagger.
Configuração do host da API
-
Host:
https://app.inloox.com -
BasePath:
/api/v1/odata/ -
Autenticação: Chave de API (
X-API-KEYcabeçalho)
Operações com suporte
O conector expõe as seguintes operações agrupadas por entidade:
📁 Gerência de projetos
- GET/Project: listar projetos com filtro e paginação opcionais do OData
- POST /Project: Criar um novo projeto
- GET /Project/{projectId}: obter um projeto por ID
- PATCH /Project/{projectId}: atualizar um projeto por ID
- DELETE /Project/{projectId}: excluir um projeto
- POST /Project/{projectId}/AddMember: Adicionar um membro a um projeto
✅ Gerenciamento de Tarefas
- GET /Task: listar tarefas com filtro e paginação opcionais do OData
- POST /Task: Criar uma nova tarefa
- GET /Task/{taskId}: Obter uma tarefa por ID
- PATCH /Task/{taskId}: atualizar uma tarefa por ID
- DELETE /Task/{taskId}: excluir uma tarefa
👤 Gerenciamento de Contatos
- GET /Contact: Listar contatos com filtro e paginação opcionais do OData
Definições de entidade
ApiProjectInput
Inclui campos como Name, , StartDate, EndDate, ClientId, Priority, IsArchivede outros.
ApiTaskInput
Os campos incluem , , , , e DescriptionHTMLProjectId. EndDateTimeStartDateTimeWorkAmountName
AddProjectMemberInput
-
contactId(uuid): ID do contato a ser adicionado -
role(int): ID da função (por exemplo, 2 = Gerenciador de Projetos, 4 = Membro da Equipe)
Anotações
- Todos os pontos de extremidade seguem a sintaxe de consulta OData para filtragem e paginação
- Verifique se correto
Content-Type(application/json) está definido nas solicitações do corpo - Para solicitações PATCH e POST, os esquemas necessários devem corresponder
ApiProjectInputeApiTaskInput - A segurança da chave de API é imposta por meio do
X-API-KEYcabeçalho
Mais Informações
Para obter detalhes sobre modelos de entidade e exemplos de uso, visite https://github.com/inloox-dev ou entre em contato support@inloox.com.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| apiKey | secureString | "apiKey" para a API do InLoox | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adiciona um membro a um projeto |
Adiciona um membro ao projeto especificado. |
| Atualiza um projeto por ID |
Atualiza o projeto especificado com novas informações. |
| Atualiza uma tarefa por ID |
Atualiza a tarefa especificada com novos detalhes. |
| Cria um novo projeto |
Cria um novo projeto com as informações fornecidas. |
| Cria uma nova tarefa |
Cria uma nova tarefa com as informações fornecidas. |
| Exclui um projeto por ID |
Exclui o projeto especificado por seu identificador exclusivo. |
| Exclui uma tarefa por ID |
Exclui a tarefa especificada por seu identificador exclusivo. |
| Recupera um projeto por ID |
Recupera um projeto específico por seu identificador exclusivo. |
| Recupera uma lista de contatos |
Retorna todos os contatos com base nos parâmetros de paginação e filtro OData especificados. |
| Recupera uma lista de projetos |
Retorna todos os projetos com base nos parâmetros de paginação e filtro OData especificados. |
| Recupera uma lista de tarefas |
Retorna todas as tarefas com base nos parâmetros de paginação e filtro OData especificados. |
| Recupera uma tarefa por ID |
Recupera uma tarefa específica por seu identificador exclusivo. |
Adiciona um membro a um projeto
Adiciona um membro ao projeto especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
identificador do projeto
|
projectId | True | uuid |
O identificador exclusivo do projeto ao qual o membro será adicionado. |
|
contactId
|
contactId | True | uuid |
A ID do contato a ser adicionado ao projeto |
|
função
|
role | True | integer |
O identificador de função numérica para o membro. Valores possíveis: 2=Gerenciador de Projetos, 4=Membro da Equipe, 8=Parceiro, 16=Cliente, 32=Outros, 128=AdditionalRole1, 256=AdditionalRole2, 512=AdditionalRole3, 1024=AdditionalRole4, 2048=AdditionalRole5 |
Atualiza um projeto por ID
Atualiza o projeto especificado com novas informações.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador do projeto
|
projectId | True | uuid |
O identificador exclusivo do projeto a ser atualizado. |
|
ClientId
|
ClientId | uuid | ||
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
DivisionId
|
DivisionId | uuid | ||
|
Data de Término
|
EndDate | date-time | ||
|
IsArchived
|
IsArchived | boolean | ||
|
IsRecycled
|
IsRecycled | boolean | ||
|
LockMode
|
LockMode | integer | ||
|
Nome
|
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 | ||
|
Data de Início
|
StartDate | date-time | ||
|
ValueScore
|
ValueScore | integer |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of ApiProject |
Atualiza uma tarefa por ID
Atualiza a tarefa especificada com novos detalhes.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador da tarefa
|
taskId | True | uuid |
O identificador exclusivo da tarefa a ser atualizada. |
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
EndDateTime
|
EndDateTime | date-time | ||
|
GroupId
|
GroupId | uuid | ||
|
Nome
|
Name | string | ||
|
ProjectId
|
ProjectId | uuid | ||
|
StartDateTime
|
StartDateTime | date-time | ||
|
WorkAmount
|
WorkAmount | number |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of ApiTask |
Cria um novo projeto
Cria um novo projeto com as informações fornecidas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ClientId
|
ClientId | uuid | ||
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
DivisionId
|
DivisionId | uuid | ||
|
Data de Término
|
EndDate | date-time | ||
|
IsArchived
|
IsArchived | boolean | ||
|
IsRecycled
|
IsRecycled | boolean | ||
|
LockMode
|
LockMode | integer | ||
|
Nome
|
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 | ||
|
Data de Início
|
StartDate | date-time | ||
|
ValueScore
|
ValueScore | integer |
Retornos
- Corpo
- ApiProject
Cria uma nova tarefa
Cria uma nova tarefa com as informações fornecidas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
DescriptionHTML
|
DescriptionHTML | string | ||
|
EndDateTime
|
EndDateTime | date-time | ||
|
GroupId
|
GroupId | uuid | ||
|
Nome
|
Name | string | ||
|
ProjectId
|
ProjectId | uuid | ||
|
StartDateTime
|
StartDateTime | date-time | ||
|
WorkAmount
|
WorkAmount | number |
Retornos
- Corpo
- ApiTask
Exclui um projeto por ID
Exclui o projeto especificado por seu identificador exclusivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador do projeto
|
projectId | True | uuid |
O identificador exclusivo do projeto a ser excluído. |
Exclui uma tarefa por ID
Exclui a tarefa especificada por seu identificador exclusivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador da tarefa
|
taskId | True | uuid |
O identificador exclusivo da tarefa a ser excluída. |
Recupera um projeto por ID
Recupera um projeto específico por seu identificador exclusivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador do projeto
|
projectId | True | uuid |
O identificador exclusivo do projeto a ser recuperado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of ApiProject |
Recupera uma lista de contatos
Retorna todos os contatos com base nos parâmetros de paginação e filtro OData especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Cadeia de caracteres de filtro OData
|
$filter | string |
Uma cadeia de caracteres de filtro OData para filtrar os contatos retornados. |
|
|
Número máximo de contatos
|
$top | number |
O número máximo de contatos a serem retornados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of ApiContact |
Recupera uma lista de projetos
Retorna todos os projetos com base nos parâmetros de paginação e filtro OData especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Cadeia de caracteres de filtro OData
|
$filter | string |
Uma cadeia de caracteres de filtro OData para filtrar os projetos retornados. |
|
|
Número máximo de projetos
|
$top | number |
O número máximo de projetos a serem retornados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of ApiProject |
Recupera uma lista de tarefas
Retorna todas as tarefas com base nos parâmetros de paginação e filtro OData especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Cadeia de caracteres de filtro OData
|
$filter | string |
Uma cadeia de caracteres de filtro OData para filtrar as tarefas retornadas. |
|
|
Número máximo de tarefas
|
$top | number |
O número máximo de tarefas a serem retornadas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of ApiTask |
Recupera uma tarefa por ID
Recupera uma tarefa específica por seu identificador exclusivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador da tarefa
|
taskId | True | uuid |
O identificador exclusivo da tarefa a ser recuperada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of ApiTask |
Definições
ApiContact
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome da Empresa
|
CompanyName | string | |
|
Identificação do contato
|
ContactId | uuid | |
|
DescriptionHTML
|
DescriptionHTML | string | |
|
DisplayName
|
DisplayName | string | |
|
Email
|
string | ||
|
Primeiro Nome
|
FirstName | string | |
|
IsIdentity
|
IsIdentity | boolean | |
|
LastName
|
LastName | string | |
|
Title
|
Title | string |
ApiProject
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ProjectId
|
ProjectId | uuid |
ApiTask
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
DescriptionHTML
|
DescriptionHTML | string | |
|
EndDateTime
|
EndDateTime | date-time | |
|
Nome
|
Name | string | |
|
ProjectId
|
ProjectId | uuid | |
|
StartDateTime
|
StartDateTime | date-time | |
|
TaskId
|
TaskId | uuid |