Condividi tramite

InLoox (anteprima)

Il connettore InLoox consente ai team di semplificare i flussi di lavoro dei progetti automatizzando attività comuni, ad esempio la creazione e l'aggiornamento di progetti, attività e contatti all'interno dell'area di lavoro InLoox. Usare questo connettore per integrare InLoox con i servizi Microsoft come Outlook, SharePoint o Teams, consentendo l'automazione dei processi senza problemi per la pianificazione, la collaborazione e il rilevamento delle risorse dei progetti.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome InLoox
URL https://www.inloox.com
Email support@inloox.com
Metadati del connettore
Editore InLoox
Sito web https://www.inloox.com
Informativa sulla privacy https://www.inloox.com/privacy-policy/
Categorie Collaborazione; Produttività

Connettore Power Automate inLoox

Informazioni generali

InLoox Power Automate Connector consente di interagire con l'API REST InLoox per automatizzare le attività di gestione dei progetti, ad esempio la creazione di progetti, la gestione delle attività e la gestione dei contatti. Supporta scenari di integrazione all'interno di Power Automate e Power Apps, consentendo agli utenti di creare flussi di lavoro che connettono InLoox ad altri servizi.

Prerequisiti

Per procedere, è necessario quanto segue:

  • Un piano di Microsoft Power Apps o Power Automate con funzionalità di connettore personalizzato
  • Un account InLoox con accesso API appropriato
  • Una chiave API InLoox (usata tramite X-API-KEY l'intestazione)
  • Interfaccia della riga di comando di Power Platform (paconn)

Compilazione del connettore

Il connettore usa l'autenticazione della chiave API. Assicurarsi di disporre di una chiave API InLoox con autorizzazioni sufficienti.

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

Sostituire <api_key> con la chiave effettiva. La chiave API deve essere passata nell'intestazione X-API-KEY come specificato nella definizione di Swagger.

Configurazione host API

  • Host: https://app.inloox.com
  • BasePath: /api/v1/odata/
  • Autenticazione: Chiave API (X-API-KEY intestazione)

Operazioni supportate

Il connettore espone le operazioni seguenti raggruppate per entità:

📁 Gestione di progetto

  • GET /Project: Elencare i progetti con filtro OData e paginazione facoltativi
  • POST /Project: Creare un nuovo progetto
  • GET /Project/{projectId}: Ottenere un progetto in base all'ID
  • PATCH /Project/{projectId}: Aggiornare un progetto in base all'ID
  • DELETE /Project/{projectId}: Eliminare un progetto
  • POST /Project/{projectId}/AddMember: Aggiungere un membro a un progetto

✅ Gestione attività

  • GET /Task: Elencare le attività con filtro OData e paginazione facoltativi
  • POST /Task: Creare una nuova attività
  • GET /Task/{taskId}: Ottenere un'attività in base all'ID
  • PATCH /Task/{taskId}: Aggiornare un'attività in base all'ID
  • DELETE /Task/{taskId}: Elimina un'attività

👤 Gestione contatti

  • GET /Contact: Elencare i contatti con filtro OData e paginazione facoltativi

Definizioni di entità

ApiProjectInput

Include campi come Name, StartDateEndDate, ClientId, Priority, , IsArchivede altri.

ApiTaskInput

I campi includono Name, WorkAmount, StartDateTimeEndDateTime, ProjectId, e DescriptionHTML.

AddProjectMemberInput

  • contactId (uuid): ID del contatto da aggiungere
  • role (int): ID ruolo (ad esempio, 2 = Project Manager, 4 = Membro del team)

Note

  • Tutti gli endpoint seguono la sintassi di query OData per filtrare e impaginare
  • Assicurarsi che le richieste del corpo siano impostate correttamente Content-Type (application/json)
  • Per le richieste PATCH e POST, gli schemi obbligatori devono corrispondere ApiProjectInput a e ApiTaskInput
  • La sicurezza della chiave API viene applicata tramite l'intestazione X-API-KEY

Ulteriori informazioni

Per informazioni dettagliate sui modelli di entità e sugli esempi di utilizzo, visitare https://github.com/inloox-dev o contattare support@inloox.com.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:
Predefinita Parametri per la creazione della connessione. Tutte le aree geografiche Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome TIPO Description Obbligatorio
apiKey securestring "apiKey" per l'API InLoox Vero

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi

Azioni

Aggiorna un'attività in base all'ID

Aggiorna l'attività specificata con nuovi dettagli.
Aggiorna un progetto in base all'ID

Aggiorna il progetto specificato con nuove informazioni.
Aggiunge un membro a un progetto

Aggiunge un membro al progetto specificato.
Crea un nuovo progetto

Crea un nuovo progetto con le informazioni fornite.
Crea una nuova attività

Crea una nuova attività con le informazioni fornite.
Elimina un'attività in base all'ID

Elimina l'attività specificata in base al relativo identificatore univoco.
Elimina un progetto in base all'ID

Elimina il progetto specificato in base al relativo identificatore univoco.
Recupera un'attività in base all'ID

Recupera un'attività specifica in base al relativo identificatore univoco.
Recupera un elenco di attività

Restituisce tutte le attività in base ai parametri di paginazione e filtro OData specificati.
Recupera un elenco di contatti

Restituisce tutti i contatti in base ai parametri di paginazione e filtro OData specificati.
Recupera un elenco di progetti

Restituisce tutti i progetti in base ai parametri di paginazione e filtro OData specificati.
Recupera un progetto in base all'ID

Recupera un progetto specifico in base al relativo identificatore univoco.

Aggiorna un'attività in base all'ID

ID operazione:
updateTask

Aggiorna l'attività specificata con nuovi dettagli.

Parametri

Nome Chiave Necessario Tipo Descrizione
Identificatore dell'attività
 taskId True uuid

Identificatore univoco dell'attività da aggiornare.
DescriptionHTML
 DescriptionHTML string
EndDateTime
 EndDateTime date-time
GroupId
 GroupId uuid
Nome
 Name string
ProjectId
 ProjectId uuid
StartDateTime
 StartDateTime date-time
WorkAmount
 WorkAmount number

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of ApiTask

Aggiorna un progetto in base all'ID

ID operazione:
updateProject

Aggiorna il progetto specificato con nuove informazioni.

Parametri

Nome Chiave Necessario Tipo Descrizione
Identificatore del progetto
 projectId True uuid

Identificatore univoco del progetto da aggiornare.
ClientId
 ClientId uuid
DescriptionHTML
 DescriptionHTML string
DivisionId
 DivisionId uuid
Data di fine
 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
DataInizio
 StartDate date-time
ValueScore
 ValueScore integer

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of ApiProject

Aggiunge un membro a un progetto

ID operazione:
addProjectMember

Aggiunge un membro al progetto specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
identificatore del progetto
 projectId True uuid

Identificatore univoco del progetto a cui verrà aggiunto il membro.
contactId
 contactId True uuid

ID del contatto da aggiungere al progetto
ruolo
 role True integer

Identificatore numerico del ruolo per il membro. Valori possibili: 2=Project Manager, 4=Membro del team, 8=Partner, 16=Customer, 32=Other, 128=AdditionalRole1, 256=AdditionalRole2, 512=AdditionalRole3, 1024=AdditionalRole4, 2048=AdditionalRole5

Crea un nuovo progetto

ID operazione:
postProjects

Crea un nuovo progetto con le informazioni fornite.

Parametri

Nome Chiave Necessario Tipo Descrizione
ClientId
 ClientId uuid
DescriptionHTML
 DescriptionHTML string
DivisionId
 DivisionId uuid
Data di fine
 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
DataInizio
 StartDate date-time
ValueScore
 ValueScore integer

Restituisce

Corpo
ApiProject

Crea una nuova attività

ID operazione:
postTask

Crea una nuova attività con le informazioni fornite.

Parametri

Nome Chiave Necessario Tipo Descrizione
DescriptionHTML
 DescriptionHTML string
EndDateTime
 EndDateTime date-time
GroupId
 GroupId uuid
Nome
 Name string
ProjectId
 ProjectId uuid
StartDateTime
 StartDateTime date-time
WorkAmount
 WorkAmount number

Restituisce

Corpo
ApiTask

Elimina un'attività in base all'ID

ID operazione:
deleteTask

Elimina l'attività specificata in base al relativo identificatore univoco.

Parametri

Nome Chiave Necessario Tipo Descrizione
Identificatore dell'attività
 taskId True uuid

Identificatore univoco dell'attività da eliminare.

Elimina un progetto in base all'ID

ID operazione:
deleteProject

Elimina il progetto specificato in base al relativo identificatore univoco.

Parametri

Nome Chiave Necessario Tipo Descrizione
Identificatore del progetto
 projectId True uuid

Identificatore univoco del progetto da eliminare.

Recupera un'attività in base all'ID

ID operazione:
getTaskById

Recupera un'attività specifica in base al relativo identificatore univoco.

Parametri

Nome Chiave Necessario Tipo Descrizione
Identificatore dell'attività
 taskId True uuid

Identificatore univoco dell'attività da recuperare.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of ApiTask

Recupera un elenco di attività

ID operazione:
getTasks

Restituisce tutte le attività in base ai parametri di paginazione e filtro OData specificati.

Parametri

Nome Chiave Necessario Tipo Descrizione
Stringa di filtro OData
 $filter string

Stringa di filtro OData per filtrare le attività restituite.
Numero massimo di attività
 $top number

Numero massimo di attività da restituire.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of ApiTask

Recupera un elenco di contatti

ID operazione:
getContacts

Restituisce tutti i contatti in base ai parametri di paginazione e filtro OData specificati.

Parametri

Nome Chiave Necessario Tipo Descrizione
Stringa di filtro OData
 $filter string

Stringa di filtro OData per filtrare i contatti restituiti.
Numero massimo di contatti
 $top number

Numero massimo di contatti da restituire.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of ApiContact

Recupera un elenco di progetti

ID operazione:
getProjects

Restituisce tutti i progetti in base ai parametri di paginazione e filtro OData specificati.

Parametri

Nome Chiave Necessario Tipo Descrizione
Stringa di filtro OData
 $filter string

Stringa di filtro OData per filtrare i progetti restituiti.
Numero massimo di progetti
 $top number

Numero massimo di progetti da restituire.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of ApiProject

Recupera un progetto in base all'ID

ID operazione:
getProjectById

Recupera un progetto specifico in base al relativo identificatore univoco.

Parametri

Nome Chiave Necessario Tipo Descrizione
Identificatore del progetto
 projectId True uuid

Identificatore univoco del progetto da recuperare.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of ApiProject

Definizioni

ApiContact

Nome Percorso Tipo Descrizione
NomeAzienda
 CompanyName string
ContactId
 ContactId uuid
DescriptionHTML
 DescriptionHTML string
Nome visualizzato
 DisplayName string
Email
 Email string
Nome
 FirstName string
IsIdentity
 IsIdentity boolean
Cognome
 LastName string
Titolo
 Title string

ApiProject

Nome Percorso Tipo Descrizione
ProjectId
 ProjectId uuid

ApiTask

Nome Percorso Tipo Descrizione
DescriptionHTML
 DescriptionHTML string
EndDateTime
 EndDateTime date-time
Nome
 Name string
ProjectId
 ProjectId uuid
StartDateTime
 StartDateTime date-time
TaskId
 TaskId uuid