Integrazioni personalizzate

Le integrazioni personalizzate sono integrazioni sviluppate utilizzando le API Autodesk disponibili pubblicamente per espandere le funzionalità della piattaforma. Iscriversi ad Autodesk Platform Services. La documentazione API è disponibile anche qui.

Le autorizzazioni delle integrazioni personalizzate possono essere controllate dagli account di servizio sicuri (SSA). Ulteriori informazioni sugli account di servizio sicuri sono disponibili in Account di servizio sicuri.

Aggiunta di integrazioni personalizzate

Per aggiungere un'integrazione personalizzata, è necessario innanzitutto creare un'integrazione personalizzata nel portale Autodesk Platform Services (APS). Dopo aver creato l'integrazione personalizzata, è possibile aggiungerla alla piattaforma Autodesk Construction Cloud (ACC).

1. Fare clic su Aggiungi integrazione personalizzata nello strumento Integrazioni personalizzate.
2. Fornire l'ID client APS. L'ID cliente è l'identificatore univoco per l'integrazione personalizzata. L'ID cliente si trova nel portale APS.
3. Fornire il nome dell'integrazione.
4. Fornire una descrizione dell'integrazione.
5. Fare clic su Avanti.

6. Il sistema recupera automaticamente gli account di servizio sicuri (SSA) configurati in precedenza per l'ID client.
   • Se non vengono trovati SSA, il sistema non sarà in grado di controllare le autorizzazioni per questa integrazione e agirà come amministratore dell'account con accesso immediato a tutti i dati all'interno dell'account. Fare clic su Procedi comunque per completare l'integrazione.
   • Se viene rilevato un singolo SSA, l'integrazione viene automaticamente collegata a questo SSA. Non viene concesso alcun accesso ai dati all'integrazione finché l'account SSA non viene invitato ad un progetto. Fare clic su OK per completare l'integrazione.
   • Se vengono rilevati più SSA, fornire l'indirizzo e-mail dell'SSA che si desidera collegare a questa integrazione. Fare clic su Aggiungi per completare l'integrazione.

Stato dell'integrazione

Lo stato dell'integrazione indica se l'integrazione è attiva o inattiva. È possibile modificare lo stato dell'integrazione in qualsiasi momento. Per risolvere eventuali problemi relativi all'integrazione, si consiglia di impostare lo stato di integrazione su Inattivo.

• Attivo: l'integrazione è in grado di leggere e scrivere dati sulla piattaforma Autodesk Construction Cloud (ACC) utilizzando le API di Autodesk.
• Inattivo: l'integrazione non ha la possibilità di leggere o scrivere dati sulla piattaforma ACC utilizzando le API Autodesk.

Come modificare lo stato di un'integrazione:

1. Selezionare l'integrazione dall'elenco delle integrazioni nello strumento Integrazioni personalizzate.
2. Selezionare l'elenco a discesa dello stato e scegliere lo stato desiderato.

Accesso dell'integrazione

Se si seleziona un'integrazione personalizzata dall'elenco nello strumento Integrazioni personalizzate, verranno visualizzati i dettagli sull'integrazione, incluso il relativo livello di accesso. Qui è mostrato il livello di accesso più alto dell'integrazione in tutti i progetti. Ad esempio, se l'integrazione dispone dell'accesso completo ad uno dei progetti, ma ha accesso limitato ad un altro progetto, l'accesso dell'integrazione sarà comunque "Accesso completo al progetto".

Come visualizzare i dettagli del livello di accesso di un'integrazione in base al progetto:

1. Selezionare l'integrazione dall'elenco delle integrazioni nello strumento Integrazioni personalizzate.
2. Nella sezione "Accesso integrazione", fare clic sul collegamento al numero di progetti.

Sono disponibili tre livelli di accesso, il cui significato è illustrato di seguito:

• Accesso completo all'account:
  • Nessun SSA associato, pertanto l'integrazione ha accesso ai dati a livello di account (anziché solo a livello di progetto). I dati dell'account disponibili sono quelli accessibili tramite API pubbliche. Questo vale per le integrazioni create prima del supporto SSA. Se l'integrazione è stata creata nell'interfaccia utente di BIM 360 e l'accesso era limitato ad Admin o Document Management, l'impostazione continua a essere rispettata. L'integrazione non ha accesso al servizio per il quale sono state applicate delle limitazioni. In questo caso, l'integrazione può utilizzare l'autenticazione a due vie. Il campo E-mail integrazione è vuoto.
  • Ad un SSA associato è stato concesso l'accesso "Amministratore account" nell'account. Il campo E-mail integrazione viene compilato. L'integrazione tramite SSA funge da utente di automazione e dispone dell'autorizzazione solo nel contesto dell'utente, che può essere utilizzata come parte dell'autenticazione a tre vie.
• Accesso completo al progetto: l'SSA associato all'integrazione è un amministratore di progetto per almeno un progetto.
• Accesso al progetto: l'SSA associato all'integrazione è un membro del progetto per tutti i progetti a cui è stato invitato.

Per modificare l'accesso di un SSA esistente, accedere allo strumento Membri di Project Admin all'interno di ogni progetto.

Eliminazione di integrazioni

È possibile eliminare un'integrazione che non è più utile. Lo stato Inattivo deve essere utilizzato per interrompere temporaneamente il trasferimento di dati da e verso l'ACC da parte di un'integrazione. L'eliminazione dell'integrazione ne comporta la rimozione dall'elenco, ma può essere nuovamente aggiunta. Come eliminare un'integrazione:

1. Selezionare l'integrazione dall'elenco delle integrazioni nello strumento Integrazioni personalizzate.
2. Fare clic sul menu Altro nel cassetto.
3. Selezionare Elimina integrazione.
4. Fare clic su Rimuovi nella finestra di dialogo di conferma.