Propager les annotations Cintoo vers Newforma Konekt

Cet article décrit comment propager des annotations Cintoo vers Newforma Konekt :

• Les annotations et les questions créées dans Cintoo peuvent être propagées vers Newforma Konekt.
• Les annotations privées créées dans Cintoo ne seront pas propagées vers Newforma Konekt. Elles sont destinées uniquement à la collaboration privée au sein de Cintoo.

Autorisations : les utilisateurs ayant le rôle Cintoo Administrateur et ayant accès aux outils d'administration du compte Newforma Konekt peuvent créer l'intégration avec Newforma Konekt.

Les utilisateurs dont les rôles incluent les autorisations Afficher les annotations et Gérer les annotations peuvent consulter la page Rapport et propager des annotations vers Newforma Konekt.

1. Générer un token d'accès API

Remarque : seuls les propriétaires du hub peuvent générer un token d'accès API. Si l'option n'est pas disponible, demandez au propriétaire du hub de le créer pour vous.

• Connectez-vous à Newforma Konekt
• Sélectionnez le hub dans lequel le token d'accès doit être créé
• Dans le menu principal à gauche, sélectionnez Hub Settings
• Sur la page Hub Settings, cliquez sur l'icône en forme d'engrenage en haut à droite, puis sur API Access token
• Dans la fenêtre qui s'affiche, acceptez l'API agreement, puis cliquez sur Generate.
• Le token d'API s'affiche. Copiez-le pour un usage ultérieur et, si nécessaire, transmettez-le de manière sécurisée à la personne qui l'a demandé. Une fois copié, cliquez sur Close.
  
  Avertissement : le token ne peut plus être récupéré une fois la fenêtre fermée.
  
  
• Un seul token peut être créé par hub. Pour en générer un nouveau, révoquez le token existant. Toute connexion utilisant le token précédemment généré sera interrompue.

2. Connecter le compte Cintoo au hub Newforma Konekt

• Obtenez le token Newforma Konekt du hub Newforma Konekt sélectionné depuis Newforma Konekt Account Manager
• Ajoutez ce token au compte Cintoo en accédant à Administration dans le menu burger en haut à droite > Intégrations, puis en cliquant sur Ajouter un token Newforma Konekt
  

• Il est possible d'autoriser l'accès à plusieurs hubs Newforma Konekt (chacun disposant de son propre token)

3. Connecter le projet Cintoo au projet Newforma Konekt

• Veuillez noter que les paramètres du projet Newforma Konekt ne peuvent contenir que Priority, Status et Type dans les Issue mandatory attributes, sous General Settings du projet. Tout attribut obligatoire supplémentaire peut empêcher Cintoo de se synchroniser avec le projet Newforma Konekt.
  • Si des attributs obligatoires supplémentaires sont requis, il est impératif de définir une valeur par défaut dans Newforma Konekt afin que la question puisse être propagée/synchronisée.
    Par exemple, si Domain est un attribut obligatoire pour le projet Newforma Konekt, sachez que cet attribut n'est pas renseigné par Cintoo à ce stade et provoquera l'échec de la synchronisation/propagation. La solution de contournement consiste donc à définir cet attribut Domain (à titre d'exemple) comme non obligatoire dans le projet Newforma Konekt, ou à définir une valeur par défaut pour Domain dans le projet Newforma Konekt avant de propager/synchroniser la question depuis Cintoo.

• Dans l'onglet Rapport, sélectionnez Intégrations.
  
  

• Dans Intégrations sous Newforma Konekt, sélectionnez Lier le projet
  
  
  
• Un clic sur Lier le projet ouvre la boîte de dialogue suivante, qui demande de sélectionner le hub Newforma Konekt et le projet Newforma Konekt.
  
• Inviter des utilisateurs :
  • Permet de créer les utilisateurs Cintoo existants en tant que nouveaux utilisateurs dans Newforma Konekt s'ils ne sont pas encore utilisateurs Newforma Konekt.
  • S'applique à :
    • Les utilisateurs qui créent les annotations ou les questions
    • Les utilisateurs auxquels une question a été attribuée dans Cintoo
      

• Propager/Synchroniser :
  • En mode Propager, les annotations et les questions de Cintoo sont propagées une première fois vers Newforma Konekt, mais toutes les mises à jour ultérieures proviennent de Newforma Konekt. Dans ce mode, Newforma Konekt fait office de référence principale pour les annotations et les questions.
  • En mode Synchroniser, les mises à jour peuvent provenir à la fois de Newforma Konekt et de Cintoo.
  • Ce paramètre Propager/Synchroniser peut être défini pour l'ensemble du compte Cintoo, ou pour chaque projet Cintoo indépendamment.

• Une fois qu'un hub et un projet Newforma Konekt ont été sélectionnés, le nom du projet Newforma Konekt apparaît en haut à gauche de l'onglet Rapport, et un logo Newforma Konekt gris s'affiche à côté de chaque annotation ou question Cintoo listée.

• Les annotations et les questions peuvent être propagées vers Newforma Konekt une par une ou toutes en une seule fois.
  • La propagation une par une s'effectue en cliquant sur l'icône Newforma Konekt grisée associée à chaque annotation ou question. L'icône se met alors à clignoter jusqu'à ce qu'elle devienne stable et colorée :
    • Avant
      

    • Après

  • Pour propager toutes les annotations et toutes les questions en une seule fois, cliquez sur Intégrations, puis sur Lier les annotations à Nom du projet sous Newforma Konekt.

5. Accéder aux annotations et aux questions Cintoo dans Newforma Konekt

• Un clic sur le logo Newforma Konekt situé à côté du nom du projet Newforma Konekt, en haut à gauche de l'onglet Rapport dans Cintoo, ouvre le projet Newforma Konekt associé.
  
• Un clic sur le logo Newforma Konekt coloré situé à côté d'une annotation ou d'une question listée dans l'onglet Rapport de Cintoo ouvre la question Newforma Konekt associée.

6. Modifier ou supprimer les liens de projet

• Dans l'onglet Rapport, sous Intégrations, une option permet de modifier ou de supprimer les liens de projet.
  
• La modification d'un lien change le hub Newforma Konekt et le projet Newforma Konekt de destination vers lesquels les nouvelles annotations ou questions seront propagées. Les annotations et questions déjà propagées restent liées à l'ancien hub et à l'ancien projet dans Newforma Konekt.
• La suppression d'un lien supprime les liens vers toutes les annotations et questions déjà propagées. Elles reçoivent alors une icône Newforma Konekt grisée et devront être propagées à nouveau vers un nouveau projet dans Newforma Konekt.