Compartilhar via


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
Email 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-KEY cabeç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-KEY cabeç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 ApiProjectInput e ApiTaskInput
  • A segurança da chave de API é imposta por meio 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 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
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