Partilhar via


InLoox (Pré-visualização)

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 espaço de trabalho InLoox. Use esse conector para integrar o InLoox com serviços da Microsoft como Outlook, SharePoint ou Teams, permitindo a automação perfeita de processos para planejamento de projetos, colaboração e rastreamento de recursos.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome InLoox
URL https://www.inloox.com
Email support@inloox.com
Metadados do conector
Editora InLoox
Sítio Web https://www.inloox.com
Política de privacidade https://www.inloox.com/privacy-policy/
Categorias Colaboração; Produtividade

Conector 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 suporta cenários de integração no Power Automate e 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 prosseguir:

  • Um plano Microsoft Power Apps ou Power Automate com recurso de conector personalizado
  • Uma conta InLoox com acesso apropriado à API
  • Uma chave de API InLoox (usada via X-API-KEY cabeçalho)
  • A CLI da Power Platform (paconn)

Construindo o conector

O conector usa autenticação de chave de API. Certifique-se de ter 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 sua chave real. A chave da API deve ser passada no X-API-KEY cabeçalho conforme especificado na definição do Swagger.

Configuração do host da API

  • Anfitrião: https://app.inloox.com
  • BasePath: /api/v1/odata/
  • Autenticação: Chave de API (X-API-KEY cabeçalho)

Operações suportadas

O conector expõe as seguintes operações agrupadas por entidade:

📁 Gestão de Projetos

  • GET /Project: Listar projetos com filtro OData opcional e paginação
  • 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

✅ Gestão de Tarefas

  • GET /Task: Listar tarefas com filtro OData opcional e paginação
  • 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

👤 Gestão de Contactos

  • GET /Contact: Listar contatos com filtro OData opcional e paginação

Definições de entidade

ApiProjectInput

Inclui campos como Name, StartDate, , EndDate, ClientId, PriorityIsArchived, e outros.

ApiTaskInput

Os campos incluem Name, WorkAmount, StartDateTime, EndDateTime, ProjectIde DescriptionHTML.

AddProjectMemberInput

  • contactId (uuid): ID do contacto a adicionar
  • role (int): ID da função (por exemplo, 2 = Gerente de Projeto, 4 = Membro da Equipe)

Observações

  • Todos os pontos de extremidade seguem a sintaxe de consulta OData para filtragem e paginação
  • Verifique se o correto Content-Type (application/json) está definido nas solicitações do corpo
  • Para solicitações PATCH e POST, os esquemas necessários devem corresponder ApiProjectInput e ApiTaskInput
  • A segurança da chave de API é imposta através do X-API-KEY cabeç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 com support@inloox.com.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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 InLoox Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de 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 no filtro OData especificado e nos parâmetros de paginação.

Recupera uma lista de projetos

Retorna todos os projetos com base no filtro OData especificado e nos parâmetros de paginação.

Recupera uma lista de tarefas

Retorna todas as tarefas com base no filtro OData especificado e nos parâmetros de paginação.

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

Name Chave Necessá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=Project Manager, 4=Team Member, 8=Partner, 16=Customer, 32=Other, 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

Name Chave Necessário Tipo Description
Identificador do projeto
projectId True uuid

O identificador exclusivo do projeto a ser atualizado.

ID do Cliente
ClientId uuid
DescriçãoHTML
DescriptionHTML string
DivisionId
DivisionId uuid
EndDate
EndDate date-time
IsArchived
IsArchived boolean
IsRecycled
IsRecycled boolean
Modo de bloqueio
LockMode integer
Nome
Name string
NúmeroIncremental
NumberIncremential integer
NumberPrefix
NumberPrefix string
Sufixo numérico
NumberSuffix string
PortfolioId
PortfolioId uuid
Priority
Priority integer
ProjectStatusId
ProjectStatusId uuid
Pontuação de Risco
RiskScore integer
SizeScore
SizeScore integer
StartDate
StartDate date-time
ValorScore
ValueScore integer

Devoluções

Name Caminho Tipo Description
valor
value array of ApiProject

Atualiza uma tarefa por ID

Atualiza a tarefa especificada com novos detalhes.

Parâmetros

Name Chave Necessário Tipo Description
Identificador da tarefa
taskId True uuid

O identificador exclusivo da tarefa a ser atualizada.

DescriçãoHTML
DescriptionHTML string
EndDateTime
EndDateTime date-time
Id do Grupo
GroupId uuid
Nome
Name string
ProjectId
ProjectId uuid
StartDateTime
StartDateTime date-time
Quantidade de trabalho
WorkAmount number

Devoluções

Name Caminho Tipo Description
valor
value array of ApiTask

Cria um novo projeto

Cria um novo projeto com as informações fornecidas.

Parâmetros

Name Chave Necessário Tipo Description
ID do Cliente
ClientId uuid
DescriçãoHTML
DescriptionHTML string
DivisionId
DivisionId uuid
EndDate
EndDate date-time
IsArchived
IsArchived boolean
IsRecycled
IsRecycled boolean
Modo de bloqueio
LockMode integer
Nome
Name string
NúmeroIncremental
NumberIncremential integer
NumberPrefix
NumberPrefix string
Sufixo numérico
NumberSuffix string
PortfolioId
PortfolioId uuid
Priority
Priority integer
ProjectStatusId
ProjectStatusId uuid
Pontuação de Risco
RiskScore integer
SizeScore
SizeScore integer
StartDate
StartDate date-time
ValorScore
ValueScore integer

Devoluções

Body
ApiProject

Cria uma nova tarefa

Cria uma nova tarefa com as informações fornecidas.

Parâmetros

Name Chave Necessário Tipo Description
DescriçãoHTML
DescriptionHTML string
EndDateTime
EndDateTime date-time
Id do Grupo
GroupId uuid
Nome
Name string
ProjectId
ProjectId uuid
StartDateTime
StartDateTime date-time
Quantidade de trabalho
WorkAmount number

Devoluções

Body
ApiTask

Exclui um projeto por ID

Exclui o projeto especificado por seu identificador exclusivo.

Parâmetros

Name Chave Necessá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

Name Chave Necessá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

Name Chave Necessário Tipo Description
Identificador do projeto
projectId True uuid

O identificador exclusivo do projeto a ser recuperado.

Devoluções

Name Caminho Tipo Description
valor
value array of ApiProject

Recupera uma lista de contatos

Retorna todos os contatos com base no filtro OData especificado e nos parâmetros de paginação.

Parâmetros

Name Chave Necessário Tipo Description
Cadeia de caracteres do filtro OData
$filter string

Uma cadeia de caracteres de filtro OData para filtrar os contatos retornados.

Número máximo de contactos
$top number

O número máximo de contatos a serem retornados.

Devoluções

Name Caminho Tipo Description
valor
value array of ApiContact

Recupera uma lista de projetos

Retorna todos os projetos com base no filtro OData especificado e nos parâmetros de paginação.

Parâmetros

Name Chave Necessário Tipo Description
Cadeia de caracteres do 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 devolver.

Devoluções

Name Caminho Tipo Description
valor
value array of ApiProject

Recupera uma lista de tarefas

Retorna todas as tarefas com base no filtro OData especificado e nos parâmetros de paginação.

Parâmetros

Name Chave Necessário Tipo Description
Cadeia de caracteres do 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.

Devoluções

Name Caminho Tipo Description
valor
value array of ApiTask

Recupera uma tarefa por ID

Recupera uma tarefa específica por seu identificador exclusivo.

Parâmetros

Name Chave Necessário Tipo Description
Identificador da tarefa
taskId True uuid

O identificador exclusivo da tarefa a ser recuperada.

Devoluções

Name Caminho Tipo Description
valor
value array of ApiTask

Definições

ApiContact

Name Caminho Tipo Description
Nome da Empresa
CompanyName string
ContactId
ContactId uuid
DescriçãoHTML
DescriptionHTML string
Nome de Exibição
DisplayName string
Email
Email string
Primeiro Nome
FirstName string
IsIdentity
IsIdentity boolean
Apelido
LastName string
Title
Title string

ApiProject

Name Caminho Tipo Description
ProjectId
ProjectId uuid

ApiTask

Name Caminho Tipo Description
DescriçãoHTML
DescriptionHTML string
EndDateTime
EndDateTime date-time
Nome
Name string
ProjectId
ProjectId uuid
StartDateTime
StartDateTime date-time
TaskId
TaskId uuid