Intégrations personnalisées

Les intégrations personnalisées sont les intégrations que vous créez au moyen des API Autodesk publiques pour augmenter les fonctionnalités de votre plateforme. Inscrivez-vous sur Autodesk Platform Services. Vous pouvez également trouver la documentation de l’API ici.

Les autorisations des intégrations personnalisées peuvent être contrôlées par des comptes de service sécurisés (SSA). Pour en savoir plus sur les SSA, consultez la rubrique Comptes de service sécurisés.

Ajouter des intégrations personnalisées

Pour ajouter une intégration personnalisée, vous devez d’abord créer une intégration personnalisée dans le portail Autodesk Platform Services (APS). Une fois l'intégration personnalisée créée, vous pouvez l'ajouter à la plateforme Autodesk Construction Cloud (ACC).

1. Cliquez sur Ajouter une intégration personnalisée dans l’outil Intégrations personnalisées.
2. Saisissez votre identifiant client APS. L’identifiant client est l’identificateur unique de votre intégration personnalisée. Vous pouvez accéder à l’identifiant client dans le portail APS.
3. Fournissez le nom de votre intégration.
4. Fournissez une description de l'intégration.
5. Cliquez sur Suivant.

6. Le système récupère automatiquement les comptes de service sécurisés (SSA) précédemment configurés pour votre identifiant client.
   • Si aucun SSA n'est trouvé, il n'y aura aucun moyen de contrôler les autorisations pour cette intégration et elle agira comme un administrateur de compte avec un accès immédiat à toutes les données de votre compte. Cliquez sur Continuer quand même pour terminer l'intégration.
   • Si un seul SSA est détecté, l'intégration est automatiquement associée à ce SSA. Aucun accès aux données n'est accordé à l'intégration tant que le compte SSA n'a pas été invité à un projet. Cliquez sur J'ai compris pour terminer l'intégration.
   • Si plusieurs SSA sont détectés, fournissez l'adresse courriel du SSA que vous souhaitez associer à cette intégration. Cliquez sur Ajouter pour terminer l'intégration.

État de l'intégration

L'état de l'intégration indique si l'intégration est active ou inactive. Vous pouvez modifier l'état l'intégration à tout moment. Pour résoudre les problèmes liés à votre intégration, il est recommandé de définir l'état de l'intégration à Inactif.

• Actif : l'intégration peut lire et écrire des données sur la plateforme Autodesk Construction Cloud (ACC) à l'aide des API Autodesk.
• Inactif : l'intégration ne lit pas ou n'écrit pas de données sur la plateforme ACC à l'aide des API Autodesk.

Pour modifier l'état d'une intégration :

1. Sélectionnez l'intégration dans la liste des intégrations de l'outil Intégrations personnalisées.
2. Sélectionnez la liste déroulante d’état et choisissez l’état souhaité.

Accès à l'intégration

La sélection d'une intégration personnalisée dans la liste de l'outil Intégrations personnalisées affiche les détails de l’intégration, y compris son niveau d'accès. Le niveau d'accès le plus élevé que l'intégration possède sur tous les projets est affiché ici. Par exemple, si l'intégration a un accès complet à un projet mais un accès restreint à un autre projet, l'accès de l'intégration sera toujours « Accès complet au projet ».

Pour afficher les détails du niveau d’accès d'une intégration par projet :

1. Sélectionnez l'intégration dans la liste des intégrations de l'outil Intégrations personnalisées.
2. Sous « Accès à l'intégration », cliquez sur le lien du nombre de projets.

Il existe trois niveaux d'accès possibles, chacun signifiant :

• Accès complet au compte :
  • Aucun SSA associé, donc l'intégration a accès aux données au niveau du compte (et pas seulement au niveau du projet). Les données de compte disponibles sont celles accessibles via les API publiques. Cela s'applique aux intégrations créées avant la prise en charge SSA. Si l'intégration a été créée dans l'interface BIM 360 et que l'accès était limité à Admin ou Gestion de document, le paramètre continue d'être respecté. L'intégration n'a pas accès au service qui était restreint. Dans ce cas, l'intégration peut utiliser l'authentification à deux facteurs. Le champ Adresse courriel d'intégration est vide.
  • Un SSA associé a reçu l'accès « Administrateur de compte » dans votre compte. Le champ Adresse courriel d'intégration est rempli. L'intégration utilisant le SSA agit comme un utilisateur automatisé et dispose de l'autorisation dans le contexte utilisateur uniquement, ce qui peut être utilisé dans le cadre de l'authentification à trois facteurs.
• Accès complet au projet : le SSA associé à l'intégration est administrateur de projet d'au moins un projet.
• Accès au projet : le SSA associé à l'intégration est membre de projet pour tous les projets auxquels il a été invité.

Pour modifier l'accès d'un SSA existant, accédez à l'outil Membres de Project Admin pour chaque projet.

Supprimer une intégration

Vous pouvez supprimer une intégration qui n'est plus utile. L'état Inactif doit être utilisé pour empêcher temporairement l'intégration de transférer des données vers et à partir d'ACC. La suppression de l'intégration entraîne sa suppression de la liste et elle ne peut y être ajoutée à nouveau. Pour supprimer une intégration :

1. Sélectionnez l'intégration dans la liste des intégrations de l'outil Intégrations personnalisées.
2. Cliquez sur le menu Plus dans le tiroir.
3. Sélectionnez Supprimer l'intégration.
4. Cliquez sur Supprimer dans la boîte de dialogue de confirmation.