Compartir a través de


InLoox (versión preliminar)

El conector InLoox ayuda a los equipos a simplificar los flujos de trabajo del proyecto mediante la automatización de tareas comunes, como la creación y actualización de proyectos, tareas y contactos dentro de su área de trabajo de InLoox. Use este conector para integrar InLoox con servicios de Microsoft como Outlook, SharePoint o Teams, lo que permite la automatización de procesos sin problemas para el planeamiento, la colaboración y el seguimiento de recursos del proyecto.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre InLoox
URL https://www.inloox.com
Correo Electrónico support@inloox.com
Metadatos del conector
Publicador InLoox
Sitio web https://www.inloox.com
Directiva de privacidad https://www.inloox.com/privacy-policy/
Categorías Colaboración; Productividad

Conector de InLoox Power Automate

Información general

El conector de InLoox Power Automate le permite interactuar con la API rest de InLoox para automatizar tareas de administración de proyectos, como crear proyectos, administrar tareas y controlar contactos. Admite escenarios de integración en Power Automate y Power Apps, lo que permite a los usuarios crear flujos de trabajo que conectan InLoox con otros servicios.

Prerrequisitos

Necesitará lo siguiente para continuar:

  • Un plan de Microsoft Power Apps o Power Automate con una característica de conector personalizada
  • Una cuenta de InLoox con acceso de API adecuado
  • Una clave de API InLoox (que se usa mediante X-API-KEY el encabezado)
  • La CLI de Power Platform (paconn)

Compilación del conector

El conector usa la autenticación de clave de API. Asegúrese de que tiene una clave de API inLoox con permisos suficientes.

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>

Reemplace por <api_key> la clave real. La clave de API debe pasarse en el X-API-KEY encabezado tal como se especifica en la definición de Swagger.

Configuración del host de API

  • Host: https://app.inloox.com
  • BasePath: /api/v1/odata/
  • Autenticación: clave de API (X-API-KEY encabezado)

Operaciones admitidas

El conector expone las siguientes operaciones agrupadas por entidad:

📁 Gestión de proyectos

  • GET /Project: enumerar proyectos con filtro OData opcional y paginación
  • POST /Project: Crear un nuevo proyecto
  • GET /Project/{projectId}: Obtener un proyecto por identificador
  • PATCH /Project/{projectId}: actualización de un proyecto por identificador
  • DELETE /Project/{projectId}: Eliminar un proyecto
  • POST /Project/{projectId}/AddMember: Agregar un miembro a un proyecto

✅ Administración de tareas

  • GET /Task: enumera las tareas con el filtro OData y la paginación opcionales
  • POST /Task: Crear una nueva tarea
  • GET /Task/{taskId}: Obtener una tarea por identificador
  • PATCH /Task/{taskId}: actualizar una tarea por identificador
  • DELETE /Task/{taskId}: Eliminar una tarea

👤 Administración de contactos

  • GET /Contact: enumera los contactos con el filtro OData y la paginación opcionales

Definiciones de entidad

ApiProjectInput

Incluye campos como Name, , StartDate, EndDateClientId, Priority, , IsArchivedy otros.

ApiTaskInput

Los campos incluyen Name, WorkAmount, EndDateTimeStartDateTime, , ProjectIdy DescriptionHTML.

AddProjectMemberInput

  • contactId (uuid): identificador del contacto que se va a agregar
  • role (int): Id. de rol (por ejemplo, 2 = Administrador de proyectos, 4 = Miembro del equipo)

Notas

  • Todos los puntos de conexión siguen la sintaxis de consulta de OData para filtrar y paginar
  • Asegúrese de que está establecido (application/json) correcto Content-Type en las solicitudes del cuerpo
  • En el caso de las solicitudes PATCH y POST, los esquemas necesarios deben coincidir ApiProjectInput y ApiTaskInput
  • La seguridad de la clave de API se aplica a través del X-API-KEY encabezado

Más información

Para obtener más información sobre los modelos de entidad y los ejemplos de uso, visite https://github.com/inloox-dev o póngase en contacto con support@inloox.com.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
apiKey securestring "apiKey" para la API InLoox Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualiza un proyecto por identificador

Actualiza el proyecto especificado con nueva información.

Actualiza una tarea por identificador

Actualiza la tarea especificada con nuevos detalles.

Agrega un miembro a un proyecto

Agrega un miembro al proyecto especificado.

Crea un nuevo proyecto

Crea un nuevo proyecto con la información proporcionada.

Crea una nueva tarea

Crea una nueva tarea con la información proporcionada.

Elimina un proyecto por identificador

Elimina el proyecto especificado por su identificador único.

Elimina una tarea por identificador

Elimina la tarea especificada por su identificador único.

Recupera un proyecto por identificador

Recupera un proyecto específico por su identificador único.

Recupera una lista de contactos

Devuelve todos los contactos basados en los parámetros de paginación y filtro de OData especificados.

Recupera una lista de proyectos

Devuelve todos los proyectos basados en los parámetros de paginación y filtro de OData especificados.

Recupera una lista de tareas

Devuelve todas las tareas basadas en los parámetros de paginación y filtro de OData especificados.

Recupera una tarea por identificador

Recupera una tarea específica por su identificador único.

Actualiza un proyecto por identificador

Actualiza el proyecto especificado con nueva información.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del proyecto
projectId True uuid

Identificador único del proyecto que se va a actualizar.

ClientId
ClientId uuid
DescriptionHTML
DescriptionHTML string
DivisionId
DivisionId uuid
Fecha de finalización
EndDate date-time
IsArchived
IsArchived boolean
IsRecycled
IsRecycled boolean
LockMode
LockMode integer
Nombre
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
Fecha de inicio
StartDate date-time
ValueScore
ValueScore integer

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ApiProject

Actualiza una tarea por identificador

Actualiza la tarea especificada con nuevos detalles.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de la tarea
taskId True uuid

Identificador único de la tarea que se va a actualizar.

DescriptionHTML
DescriptionHTML string
EndDateTime
EndDateTime date-time
GroupId
GroupId uuid
Nombre
Name string
ProjectId
ProjectId uuid
StartDateTime
StartDateTime date-time
WorkAmount
WorkAmount number

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ApiTask

Agrega un miembro a un proyecto

Agrega un miembro al proyecto especificado.

Parámetros

Nombre Clave Requerido Tipo Description
identificador del proyecto
projectId True uuid

Identificador único del proyecto al que se agregará el miembro.

contactId
contactId True uuid

Identificador del contacto que se va a agregar al proyecto

role
role True integer

Identificador de rol numérico para el miembro. Valores posibles: 2=Project Manager, 4=Team Member, 8=Partner, 16=Customer, 32=Other, 128=AdditionalRole1, 256=AdditionalRole2, 512=AdditionalRole3, 1024=AdditionalRole4, 2048=AdditionalRole5

Crea un nuevo proyecto

Crea un nuevo proyecto con la información proporcionada.

Parámetros

Nombre Clave Requerido Tipo Description
ClientId
ClientId uuid
DescriptionHTML
DescriptionHTML string
DivisionId
DivisionId uuid
Fecha de finalización
EndDate date-time
IsArchived
IsArchived boolean
IsRecycled
IsRecycled boolean
LockMode
LockMode integer
Nombre
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
Fecha de inicio
StartDate date-time
ValueScore
ValueScore integer

Devoluciones

Body
ApiProject

Crea una nueva tarea

Crea una nueva tarea con la información proporcionada.

Parámetros

Nombre Clave Requerido Tipo Description
DescriptionHTML
DescriptionHTML string
EndDateTime
EndDateTime date-time
GroupId
GroupId uuid
Nombre
Name string
ProjectId
ProjectId uuid
StartDateTime
StartDateTime date-time
WorkAmount
WorkAmount number

Devoluciones

Body
ApiTask

Elimina un proyecto por identificador

Elimina el proyecto especificado por su identificador único.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del proyecto
projectId True uuid

Identificador único del proyecto que se va a eliminar.

Elimina una tarea por identificador

Elimina la tarea especificada por su identificador único.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de la tarea
taskId True uuid

Identificador único de la tarea que se va a eliminar.

Recupera un proyecto por identificador

Recupera un proyecto específico por su identificador único.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del proyecto
projectId True uuid

Identificador único del proyecto que se va a recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ApiProject

Recupera una lista de contactos

Devuelve todos los contactos basados en los parámetros de paginación y filtro de OData especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Cadena de filtro de OData
$filter string

Cadena de filtro de OData para filtrar los contactos devueltos.

Número máximo de contactos
$top number

Número máximo de contactos que se van a devolver.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ApiContact

Recupera una lista de proyectos

Devuelve todos los proyectos basados en los parámetros de paginación y filtro de OData especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Cadena de filtro de OData
$filter string

Cadena de filtro de OData para filtrar los proyectos devueltos.

Número máximo de proyectos
$top number

Número máximo de proyectos que se van a devolver.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ApiProject

Recupera una lista de tareas

Devuelve todas las tareas basadas en los parámetros de paginación y filtro de OData especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Cadena de filtro de OData
$filter string

Cadena de filtro de OData para filtrar las tareas devueltas.

Número máximo de tareas
$top number

Número máximo de tareas que se van a devolver.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ApiTask

Recupera una tarea por identificador

Recupera una tarea específica por su identificador único.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de la tarea
taskId True uuid

Identificador único de la tarea que se va a recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ApiTask

Definiciones

ApiContact

Nombre Ruta de acceso Tipo Description
Nombre de la Empresa
CompanyName string
Identificación de contacto
ContactId uuid
DescriptionHTML
DescriptionHTML string
DisplayName (Nombre para mostrar)
DisplayName string
Correo Electrónico
Email string
Primer Nombre
FirstName string
IsIdentity
IsIdentity boolean
Apellido
LastName string
Title
Title string

ApiProject

Nombre Ruta de acceso Tipo Description
ProjectId
ProjectId uuid

ApiTask

Nombre Ruta de acceso Tipo Description
DescriptionHTML
DescriptionHTML string
EndDateTime
EndDateTime date-time
Nombre
Name string
ProjectId
ProjectId uuid
StartDateTime
StartDateTime date-time
TaskId
TaskId uuid