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-KEYel 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-KEYencabezado)
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) correctoContent-Typeen las solicitudes del cuerpo - En el caso de las solicitudes PATCH y POST, los esquemas necesarios deben coincidir
ApiProjectInputyApiTaskInput - La seguridad de la clave de API se aplica a través del
X-API-KEYencabezado
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
|
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 |