Intégration Clarity-Rally

ccppmop1592
Les organisations peuvent utiliser l'intégration
Clarity
-Rally nouvelle et améliorée pour garantir l'acheminement transparent des données entre les deux applications.
L'intégration
Clarity
-Rally nouvelle et améliorée est :
  • extensible et configurable en toute simplicité : vous pouvez mapper des objets et des attributs entre
    Clarity
    et Rally pour vous assurer que l'intégration répond à vos exigences spécifiques ;
  • simple à gérer : l'intégration peut être définie et gérée par les administrateurs
    Clarity
    disposant de connaissances de base de PPM classique ;
  • validée et prise en charge par Broadcom : vous n'avez pas besoin d'effectuer de tests de régression après chaque version.
Passons en revue certaines des étapes clés à effectuer pour pouvoir tirer parti de cette intégration.
Linked
  1. Remplir les conditions préalables requises pertinentes pour configurer l'intégration
  2. Créer un objet d'intégration pour intégrer
    Clarity
    à une instance Rally spécifique
  3. Créer un mappage d'intégration
  4. Exécuter le job Importer des mappages d'intégrations pour récupérer tous les objets de type d'élément de portefeuille Rally et les attributs associés
  5. Définir des mappages d'objets valides
  6. Définir des mappages de champs valides
  7. Spécifier un investissement
    Clarity
    mappant vers un objet dans Rally
  8. Exécuter le job Synchroniser les informations mappées pour synchroniser les données entre
    Clarity
    et Rally
  9. Examiner la table de stockage intermédiaire de
    Clarity
    pour comprendre les modifications à apporter depuis Rally vers
    Clarity
Examinez chacune de ces étapes en détail.
2
Conditions préalables à l'intégration
Vous devez effectuer les étapes suivantes avant de configurer la nouvelle intégration
Clarity
-Rally.
  1. Affectation du droit d'accès Mappage d'intégration - Naviguer aux administrateurs qui configurent l'intégration
    Clarity
    -Rally. Les utilisateurs disposant du droit Mappage d'intégration - Naviguer peuvent afficher la mosaïque Intégrations (version bêta) sur la page Administration et y accéder. Pour en savoir plus sur ce droit d'accès, consultez la documentation associée.
  2. Assurez-vous que la dernière version du module d'extension de contenu de l'accélérateur PMO est installée. Elle permet à
    Clarity
    d'inclure les attributs "ID d'objet Rally" et "Mappage d'intégration" pour configuration dans les projets, dans les idées et dans les investissements personnalisés.
Création d'un objet d'intégration dans PPM classique
Vous pouvez configurer la nouvelle intégration
Clarity
-Rally en créant un objet d'intégration. Vous créez un objet d'intégration à partir de la page Intégrations dans PPM classique, qui constitue l'emplacement unique dans lequel vous pouvez définir et gérer toutes les informations d'intégration.
Linked
Les informations clés ci-dessous sont nécessaires pour créer un objet d'intégration :
  • URL de l'intégration
  • Instance d'intégration
  • Clé de l'API d'intégration
  • Proxy port
Procédez comme suit :
  1. Connectez-vous à PPM classique.
  2. Cliquez sur
    Administration
    ,
    Paramètres généraux
    ,
    Intégrations
    .
  3. Cliquez sur
    Créer
    .
  4. Remplissez les champs suivants et cliquez sur
    Enregistrer
    .
Nom du champ
Description
Domaines
Domaine de l'application logicielle ou domaine d'activité du fournisseur (par exemple, Agile).
Fournisseur
Nom de la société qui fait l'objet de l'intégration au produit
Clarity
(par exemple, Rally).
Sous-traitant
Nom de la société qui implémente l'intégration (par exemple, Broadcom).
URL de l'intégration
URL de l'instance d'intégration (par exemple, l'URL de l'instance Rally).
Clé de l'API d'intégration
Clé utilisée pour accéder aux données et les récupérer à partir de Rally.
Instance d'intégration
ID de l'espace de travail Rally.
Création d'un mappage d'intégration dans
Clarity
Après avoir créé un objet d'intégration, vous devez créer un mappage d'intégration.
Linked
Procédez comme suit :
  1. Connectez-vous à
    Clarity
    .
  2. Cliquez sur
    Administration
    et sélectionnez l'onglet
    Intégrations (version bêta)
    pour ouvrir la page Intégrations.
  3. Cliquez sur Ajouter une ligne et entrez le nom du mappage d'intégration.
    Dans cette version, vous ne pouvez pas utiliser de caractères spéciaux lorsque vous spécifiez le nom du mappage d'intégration. Si vous utilisez un caractère spécial tel que l'esperluette &, le job Synchroniser les informations mappées se termine avec une erreur et le job Importer des tables de stockage intermédiaire échoue.
  4. Dans la colonne Intégration, sélectionnez l'objet d'intégration approprié.
  5. Le mappage d'intégration est maintenant disponible.
Exécution du job Importer des mappages d'intégration dans PPM classique
Le job Importer des mappages d'intégration dans PPM classique permet à
Clarity
de récupérer les objets de type d'élément de portefeuille ainsi que les attributs pris en charge à partir de l'espace de travail Rally configuré. Après avoir été importés, les objets et les champs sont disponibles dans l'onglet Objets Rally de
Clarity
.
Procédez comme suit :
  1. Connectez-vous à
    Clarity
    .
  2. Cliquez sur
    Accueil
    ,
    Rapports et jobs
    , puis
    Jobs
    pour ouvrir l'onglet Jobs.
  3. Assurez-vous que vous avez sélectionné
    Jobs disponibles
    dans la liste déroulante et ouvrez le job
    Importer des mappages d'intégration
    .
  4. Sélectionnez le mappage d'intégration approprié et cliquez sur
    Soumettre
    pour exécuter l'intégration immédiatement. Vous pouvez également planifier ce job pour qu'il s'exécute à une date ultérieure.
Une fois le job terminé, effectuez les opérations suivantes pour afficher les différents objets de type d'élément de portefeuille à partir de Rally.
Linked
  1. Connectez-vous à
    Clarity
    .
  2. Cliquez sur Administration et sélectionnez l'onglet
    Intégrations (version bêta)
    pour ouvrir la page Intégrations.
  3. Ouvrez le mappage d'intégration approprié et sélectionnez Objets Rally pour afficher les différents objets importés à partir de Rally.
Définition de mappages d'objets dans
Clarity
Linked
Vous pouvez mapper les investissements
Clarity
sélectionnés (projets, idées et investissements personnalisés) vers les éléments de portefeuille Rally sélectionnés.
Par exemple, une organisation a finalisé sa stratégie et utilisé des investissements personnalisés dans
Clarity
pour créer des thèmes, des epics commerciales et des résultats commerciaux. Ces investissements peuvent être mappés vers des thèmes, des epics et des fonctionnalités dans Rally. Si l'organisation a créé des projets individuels dans
Clarity
, ceux-ci peuvent également être mappés vers un type d'élément de portefeuille approprié, par exemple un projet dans Rally.
Procédez comme suit :
  1. Connectez-vous à
    Clarity
    .
  2. Cliquez sur
    Administration
    et sélectionnez l'onglet
    Intégrations (version bêta)
    pour ouvrir la page Intégrations.
  3. Ouvrez le mappage d'intégration approprié et accédez à l'onglet
    Mappages d'objets
    .
  4. Cliquez sur l'icône Ajouter une ligne et entrez les détails ci-dessous.
    1. Nom : fournissez le nom du mappage d'objets.
    2. Objet Rally : sélectionnez l'objet Rally à mapper vers l'investissement
      Clarity
      .
    3. Direction : sélectionnez de
      Clarity
      vers Rally. Dans cette version, l'intégration permet de créer et de mettre à jour une instance d'un type d'élément de portefeuille dans Rally, associé à un investissement dans
      Clarity
      . Il est ainsi possible de créer une fonctionnalité dans Rally associée à un investissement dans
      Clarity
      . Toutefois, si vous créez une fonctionnalité ou une autre instance de type d'élément de portefeuille dans Rally, l'intégration ne permet pas de créer un investissement dans
      Clarity
      .
Une fois que vous avez défini le mappage d'objets, vous pouvez mapper des champs
Clarity
et des champs Rally. Le mappage de champs permet de gérer le mode d'échange des données entre
Clarity
et Rally.
Définition de mappages de champs dans
Clarity
Linked
Les mappages de champs définis indiquent le mode d'échange des données entre les investissements/champs
Clarity
et les éléments de portefeuille/champs Rally. Les mappages de champs sont toujours associés à un mappage d'objets. Envisagez les techniques de mappage d'objets et de champs suivantes :
  • Examinez le tableau de compatibilité des types de données pour vous assurer que les types de champs que vous mappez sont pris en charge.
    • Le tableau est disponible dans l'onglet Compatibilité du type de données et est accessible à partir de la page Intégrations.
      Linked
  • Spécifiez la direction du flux de données lorsque vous définissez le mappage. Vous pouvez définir un mappage dans lequel les données sont acheminées d'un champ dans
    Clarity
    à un champ dans Rally.
    • Vous pouvez également définir un mappage dans lequel les données sont acheminées d'un champ dans Rally à un champ dans
      Clarity
      .
    • Toutefois, dans cette version, l'intégration bidirectionnelle n'est pas prise en charge.
    • En d'autres termes, si vous avez créé un mappage pour mettre à jour la date de début prévue dans Rally avec le champ Début dans
      Clarity
      , vous ne pouvez pas configurer un autre mappage pour mettre à jour le champ Début dans
      Clarity
      si la date de début prévue dans Rally est mise à jour.
    • En outre, vous ne pouvez pas inclure le même champ dans plusieurs mappages.
  • Sélectionnez l'option de synchronisation pertinente.
Procédez comme suit :
  1. Connectez-vous à
    Clarity
    .
  2. Cliquez sur
    Administration
    et sélectionnez l'onglet
    Intégrations (version bêta)
    pour ouvrir la page Intégrations.
  3. Ouvrez le mappage d'intégration approprié et accédez à l'onglet Mappages d'objets.
  4. Sélectionnez le mappage d'objets approprié, cliquez sur
    Détails
    et sélectionnez l'onglet
    Mappages de champs
    .
  5. Cliquez sur Développer pour ouvrir la fenêtre
    Mappages de champs
    .
  6. Entrez les détails suivants :
    1. Direction : sélectionnez de
      Clarity
      vers Rally ou de Rally vers
      Clarity
      pour en fonction de vos besoins.
    2. Champ
      Clarity
      : sélectionnez le champ
      Clarity
      approprié. Ce champ est associé à l'investissement que vous avez identifié lors du mappage des objets.
    3. Champ Rally : sélectionnez le champ Rally à mapper vers le champ
      Clarity
      . Veillez à respecter les directives de compatibilité des types de données lors du mappage des champs.
    4. Option de synchronisation : sélectionnez Créer, Mettre à jour ou Créer et mettre à jour. Pour en savoir plus sur ces options, consultez la section Exécution du job Synchroniser les informations mappées.
  7. Lorsque
    Clarity
    valide le mappage de champs, une valeur est saisie dans les colonnes Type de données, puis enregistrée.
  8. Un message d'erreur s'affiche dans les circonstances suivantes :
    1. Les champs en cours de mappage ne sont pas compatibles.
    2. Un mappage a déjà été créé pour l'un des champs.
Sélection des investissements
Clarity
à synchroniser avec Rally
Maintenant que vous avez configuré l'intégration et défini les mappages appropriés, vous pouvez sélectionner les investissements
Clarity
spécifiques qui doivent être synchronisés avec Rally. Dans cette version, vous pouvez sélectionner des projets, investissements personnalisés et idées
Clarity
spécifiques à synchroniser avec Rally.
Procédez comme suit :
  1. Connectez-vous à
    Clarity
    .
  2. Accédez à la page d'investissement pertinente et sélectionnez la disposition de grille.
  3. Utilisez le sélectionneur de colonnes pour ajouter les attributs "Objet Rally" et "Mappage d'intégrations" à la grille.
  4. Sélectionnez le mappage d'intégration à associer à l'investissement.
Une fois que vous avez exécuté le job Synchroniser les informations mappées pour synchroniser les données entre
Clarity
et Rally, le champ Objet Rally est rempli automatiquement.
Exécution du job Synchroniser les informations mappées
Le job Synchroniser les informations mappées dans PPM classique permet aux administrateurs de synchroniser les informations mappées entre
Clarity
et Rally. Selon la direction configurée et l'option de synchronisation activée, le job peut effectuer les opérations suivantes :
Direction
Option de synchronisation
Comportement attendu
De
Clarity
vers Rally
Create
Si l'objet mappé n'existe pas dans Rally, ce job :
  1. crée et remplit les champs et objets Rally mappés ;
  2. remplit les tables de stockage intermédiaire
    Clarity
    ;
  3. met à jour les tables Objets (et Champs) Rally dans
    Clarity
    .
De
Clarity
vers Rally
Création et mise à jour
Si l'objet mappé n'existe pas dans Rally, ce job :
  1. crée et remplit les champs et objets Rally mappés ;
  2. remplit les tables de stockage intermédiaire
    Clarity
    ;
  3. met à jour les tables Objets (et Champs) Rally dans
    Clarity
    .
Lors des exécutions suivantes, ce job :
  1. met à jour les champs et objets Rally mappés ;
  2. remplit les tables de stockage intermédiaire
    Clarity
    ;
  3. met à jour les tables Objets (et Champs) Rally dans
    Clarity
    .
De
Clarity
vers Rally
Update
Si l'objet mappé existe dans Rally, ce job :
  1. met à jour les champs et objets Rally mappés ;
  2. remplit les tables de stockage intermédiaire
    Clarity
    ;
  3. met à jour les tables Objets (et Champs) Rally dans
    Clarity
    .
De Rally vers
Clarity
Create
Non pris en charge
De Rally vers
Clarity
Création et mise à jour
Non pris en charge
De Rally vers
Clarity
Update
Si l'objet mappé existe dans
Clarity
, ce job :
  1. met à jour les champs et objets
    Clarity
    mappés ;
  2. remplit les tables de stockage intermédiaire
    Clarity
    ;
  3. met à jour les tables Objets (et Champs) Rally dans
    Clarity
    .
Procédez comme suit :
  1. Connectez-vous à
    Clarity
    .
  2. Cliquez sur
    Accueil
    ,
    Rapports et jobs
    , puis
    Jobs
    pour ouvrir l'onglet Jobs.
  3. Assurez-vous que vous avez sélectionné Jobs disponibles dans la liste déroulante et ouvrez le job
    Synchroniser les informations mappées
    .
  4. Sélectionnez le mappage d'intégration approprié et cliquez sur Soumettre pour exécuter l'intégration immédiatement.
Une fois ce job exécuté,
Clarity
exécute automatiquement le job Importer des tables de stockage intermédiaire pour déplacer les données de la table de stockage intermédiaire vers
Clarity
.
Vous pouvez planifier l'opération Synchroniser les informations mappées pour qu'elle s'exécute à des intervalles réguliers. Cependant, si vous déclenchez manuellement le job Synchroniser les informations mappées, les jobs programmés ne s'exécutent pas simultanément.
Révision de la table de stockage intermédiaire dans
Clarity
Linked
Chaque mappage d'intégration est associé à une table de stockage intermédiaire dans
Clarity
. La table de stockage intermédiaire est accessible uniquement aux membres du groupe Administrateur système PMO. Pour octroyer manuellement l'accès à la table de stockage intermédiaire, vous pouvez affecter les droits d'accès suivants à un utilisateur ou à un groupe :
  • <Nom du mappage d'intégration> - Créer
  • <Nom du mappage d'intégration> - Tout supprimer
  • <Nom du mappage d'intégration> - Tout modifier
  • <Nom du mappage d'intégration> - Tout afficher
  • <Nom du mappage d'intégration> - Accès Xog
Dans cette version, vous pouvez utiliser la table de stockage intermédiaire pour :
  • examiner toutes les données copiées de Rally vers
    Clarity
    après l'exécution du job Synchroniser les informations de mappage ;
  • examiner les messages d'erreur en cas d'échec de la synchronisation des données.
Procédez comme suit :
  1. Connectez-vous à
    Clarity
    .
  2. Cliquez sur Administration et sélectionnez l'onglet Intégrations (version bêta) pour ouvrir la page Intégrations.
  3. Ouvrez le mappage d'intégration approprié et accédez à l'onglet Table de stockage intermédiaire. Les enregistrements s'affichent dans cette table uniquement si vous disposez des droits d'accès appropriés.
  4. Ajoutez les colonnes pertinentes à la disposition de grille pour examiner le statut des enregistrements qui ont été traités. Vous pouvez ajouter les principales colonnes suivantes :
    1. ID d'exécution du job
    2. Statut
    3. Clarity
      Objet
    4. Clarity
      Nom de l'objet
    5. Objet Rally
    6. Objet Rally
    7. Nom
    8. Message d'erreur
Points clés à retenir
:
  • La table de stockage intermédiaire n'affiche pas les données sortantes de
    Clarity
    vers Rally.
  • Les données de la table de stockage intermédiaire sont supprimées de
    Clarity
    chaque fois que le job Synchroniser les informations mappées est exécuté.
  • A l'issue du job Synchroniser les informations mappées, l'utilisateur se voit automatiquement accorder l'accès aux tables de stockage intermédiaire.
  • Les droits d'accès global Mappage d'intégration (Afficher, Modifier et Supprimer) sont automatiquement ajoutés au groupe Administrateur système PMO. Ce processus d'arrière-plan permet d'accéder aux tables de stockage intermédiaire.
Flux de synchronisation des données pour l'intégration de Rally
Si vous l'exécutez après avoir configuré l'intégration de Rally, le job Synchroniser les informations mappées consulte les investissements
Clarity
associés afin de vérifier que le champ Objet Rally est mis à jour.
  • Le champ Objet Rally est vide tant que
    Clarity
    n'a pas créé d'élément de portefeuille Rally. Lorsque le job de synchronisation est exécuté, le champ Objet Rally est mis à jour pour l'investissement approprié dans
    Clarity
    . La prochaine fois que vous exécutez le job,
    Clarity
    met à jour les champs appropriés dans Rally (mappage
    Clarity
    -Rally). Le job met également à jour la table de stockage intermédiaire et les champs
    Clarity
    (mappage Rally-
    Clarity
    ).
  • Si le champ Objet Rally n'est pas vide,
    Clarity
    met directement à jour les champs appropriés dans Rally (mappage
    Clarity
    -Rally). Le job met également à jour la table de stockage intermédiaire et les champs
    Clarity
    (mappage Rally-
    Clarity
    ).
Points clés à prendre en compte lors de l'utilisation de l'intégration
  • Lorsqu'un champ
    Clarity
    est mis à jour avec la valeur d'un champ Rally mappé, l'utilisateur qui exécute le job Synchroniser les informations mappées est répertorié dans le journal d'audit.
  • Les clients peuvent continuer à utiliser la nouvelle intégration Rally ainsi que la hiérarchie des éléments de portefeuille et investissements Rally ou les intégrations de feuille de temps (
    Clarity
    ), si nécessaire.
    • L'intégration Agile, si elle a été configurée par un client, n'a aucun impact sur cette intégration existante après la mise à niveau.
    • Les nouveaux jobs (par exemple, Importer des mappages d'intégration, Synchroniser les informations mappées et Importer des tables de stockage intermédiaire) sont incompatibles avec les anciens jobs (par exemple, Synchroniser CA Agile Central et Créer des investissements CA Agile Central) afin de les empêcher de s'exécuter de manière simultanée.
  • Si le job Importer des mappages d'intégration n'est pas exécuté après la création d'une instance Mappages d'intégrations, les objets
    Clarity
    et Rally ne sont pas disponibles dans leurs listes déroulantes respectives.
    • Si vous créez des attributs personnalisés (dans
      Clarity
      ou dans Rally), le job Importer des mappages d'intégration doit être exécuté pour s'assurer qu'ils sont disponibles dans la grille de mappage de champs.
  • Champs Rally non mis à jour
    • Non-prise en charge de l'utilisation du système en tant que cible si l'un de ses champs est régi par une logique métier
      Linked
  • Le job Synchroniser les informations mappées renvoie uniquement les modifications.
    • La première fois que le job Synchroniser les informations mappées est exécuté,
      Clarity
      et Rally sont synchronisés.
    • A l'issue de l'exécution du job, un utilisateur
      Clarity
      met à jour le champ % d'achèvement (qui est dérivé de Rally).
    • Du point de vue des performances, lors de l'exécution suivante du job Synchroniser les informations mappées, le système ne met pas à jour le champ % d'achèvement de
      Clarity
      et
      Clarity
      et Rally ne sont plus synchronisés, étant donné que des modifications ont été apportées dans Rally.
    • Le champ % d'achèvement de
      Clarity
      sera synchronisé uniquement lorsque l'élément de portefeuille mappé sera mis à jour dans Rally.
    • Les champs mappés ne seront synchronisés qu'à ce moment-là.
  • Vous pouvez utiliser le journal des jobs pour résoudre les problèmes dans
    Clarity
    et ceux liés à l'échange de données Rally.
    Linked